Professional Documents
Culture Documents
Net Up
Net Up
Administrators Guide
DVB to IP Gateway / Streamer, CAS, VoD / nVoD, TVoD / Time-Shifted TV / nPVR, Middleware, IPTV Billing, Customer Interface
Contents
1 Introduction - - - - - - - - - - - - - - - - - - - - - - - - 5 Intended audience - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5 Notation conventions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5 IPTV technology - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5 List of terms - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -6 NBS architecture - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -8 IPTV Complex Overview - - - - - - - - - - - - - - - - - - - - - - - - - - - - -9 2 System Components- - - - - - - - - - - - - - - - - - - 11 Bundling options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 11 Streamer - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 12 Conditional Access System - - - - - - - - - - - - - - - - - - - - - - - - - - - 12 Video on Demand- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 13 Middleware - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 14 Billing - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 14 STB Client - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15 3 Basic objects and processes - - - - - - - - - - - - - - 17 Media content - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 17 Services - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 17 Tariff plans - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19 Customers - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19 4 United control center - - - - - - - - - - - - - - - - - - 21 Top menu - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21 Left pane - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 22 Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 22 Middleware system - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 23 Billing system - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 28 nVoD system - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 38 DRM system - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 41 TVoD system- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 42
Control center - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 75 Documentation- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 75 STB Files - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 75 DVB- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 75 EPG - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 80 VoD - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 81 Firmware update- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 81 STB management - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 82 Styles - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 83 Translations - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 84 Backup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 84 Power Management - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 84 Update - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 84 Keystore - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 85 Network - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 85 Security - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 87 Services - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 88 Tunneling & IGMP- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 88 About - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 88 Connections- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 89 Storage - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 89 8 STB setup - - - - - - - - - - - - - - - - - - - - - - - - 91 Updating user theme - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 91 Amino AmiNET- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 93 D-Link - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 96 9 STB Client Interface - - - - - - - - - - - - - - - - - - - 99 Startup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 99 Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 101 Viewing TV channels - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 103 Viewing VoD- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 105 Listening to radio - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 106 Personal account- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 107 Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 108 Additional - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 110
INTRODUCTION
Intended audience
This manual is intended for IPTV service providers using the NetUP IPTV Complex. An overall knowledge of TV broadcasting systems and IP networking is assumed. The document covers basic functionality of NetUPs IPTV Complex, as well as the typical necessary actions during its startup, deployment, and operation.
Notation conventions
The following elements are emphasized in the text: Terms (on first occurence);
Interface strings; Hyperlinks;
Notes; Warnings.
IPTV technology
As a rule, an IPTV solution includes components to execute the following tasks: Content receiving and processing (see "IPTV: Streamer"); Content storage and delivery (see "IPTV: VoD"); Content encryption (see "IPTV: CAS"); Billing (see "Other terms: Billing"); System setting and management (see "IPTV: Middleware"); Receiving and reproduction of the content at the client side (see "IPTV: STB"). The main advantages of IPTV include its interactivity and a number of additional services, such as: video on demand (see "IPTV: VoD"), time-shifted TV (see "IPTV: TVoD"), network personal video recorder (see "IPTV: nPVR"), electronic program guide (see "IPTV: EPG"), virtual cinema (see "IPTV: nVoD"). IP protocol abilities allow to provide a number of interactive services besides just transmitting the video content.
Networ ki ng
DNS is Domain Name Service, a distributed hierarchical system that stores IP addresses, do-
tocols used in computer networks. FTP is File Transfer Protocol, an application level network protocol for file transfer. HTTP is Hypertext Transport Protocol, an application level network protocol for data transfer. RTSP is Real-time Streaming Protocol, an application level network protocol that serves for signalling during the multimedia data transfer. RTP is Real-time Protocol, a transport level network protocol for delivering real-time traffic over IP networks. UDP is User Datagram Protocol, a simple transport level network protocol for data transfer. TCP is Transmission Control Protocol, a transport level network protocol for data transfer with guaranteed delivery. DHCP is Dynamic Host Configuration Protocol, a network protocol for obtaining IP addresses and other auxiliary information in TCP/IP networks. IGMP is Internet Group Management Protocol, a network protocol that manages group routing. NTP is Network Time Protocol, a network protocol for synchronizing the internal clocks of computer systems. MAC is Media Access Control, a sub-layer of OSI model that provides addressing and channel access control mechanisms. MAC address is a unique identifier assigned to a device in a network. LAN is Local area network. VLAN is Virtual Local area network, standard 802.1q. NFS is Network File System, a file system distributed among multiple machines. SSL is Secure Socket Layer, a cryptographic protocol for communications over TCP/IP networks. Commutator (switch) is a device joining several nodes within a network. Unicast is a transmission of information packets to a single destination. Broadcast is a transmission of information packets to all devices in a network. Multicast is a transmission of information packets to a certain group of destinations. Multicast group is a group of destinations in a multicast transmission. Multicast router is a router capable of routing multicast streams.
Television
Polarization is a characteristic of the satellite signal (may be vertical, horizontal, circular left,
or circular right).
Introduction
Symbol rate is the number of transmitted symbols per second. Transponder is an automatic device that may receive and retransmit a signal. LNB converter is Low-Noise Block converter, a device that converts a satellite signal for
tween a satellite receiver and other devices. Multiswitch is a device for connecting several receivers to the same satellite dish. FTA is Free-to-air, refers to a non-encoded stream. CSA is Common Scrambling Algorithm, an encryption algorythm used in DVB. Codec is a device or computer program capable of encoding and/or decoding a digital data stream. MPEG is a suite of data compression standards used for digital multimedia. MPEG TS is MPEG transport stream, a container format used for transmission of multimedia data over networks. MPEG PS is MPEG program stream, a container format used for storage of multimedia data. Audio PID in a MPEG-encoded file or stream is an identifier of audio data. Video PID in a MPEG-encoded file or stream is an identifier of video data. H.264 is a standard for video compression (subset of MPEG-4). SD is Standard Definition (resolution of 720x480 or 720x576). HD is High Definition (resolution of 1280x720 or 1920x1080). HDTV is High Definition Television, a standard for high-resolution digital TV broadcasting. DVB is Digital Video Broadcast, a suite of standards for digital television. Includes the following subsets:
DVB-S for satellite broadcasting; DVB-S2 for high definition satellite broadcasting; DVB-C for cable broadcasting; DVB-T for terrestrial on-air broadcasting.
RF is a format of analog video signal for on-air transmission. RCA (AV) is a format of analog audio and video signal for short-range cable transmission. S-Video is a format of analog video signal for short-range cable transmission that carries the
countries.
NTSC is a color-encoding system for analog TV accepted in USA.
IPTV solution (streamer, VoD servers, CAS, and user STBs). CAM is Conditional Access Module, a module that provides restricted access to the broadcasted media data. MMI is Machine-Machine Interface, an interface used for interaction between CI and CAM. EMM is Entitlement Management Message, an encrypted message stating the user's right of access to multimedia data. CI is Common Interface, an interface of interaction with CAM (standard EN 50221). CAID is Conditional Access system ID. VoD is Video on demand. TVoD is Television on demand. nVoD is Near Video on demand (also known as "virtual cinema"). nPVR is Network Personal Video Recorder. EPG is Electronic Program Guide. PPV is Pay-per-view, a system in which TV viewers can purchase events to be seen on TV. CAS is Conditional Access System, a system that protects the content from unauthorized access. SMS is Subscriber Management System. Time-Shifted TV is a kind of TV with pause and rewind options. STB is the TV set-top box.
Other ter ms
XML is Extensible Markup Language, a markup language for structured texts. RAID is Redundant array of independent disks, a fault-tolerant array of hard disks. Database is a structured collection of data records stored in a computer system. Cluster is a group of linked computers used as a single hardware resourse. DRM is Digital Rights Management, access control technologies used to limit usage of digital
media or devices. Billing is a system that collects information about services that are going to be billed to the subscriber. Firmware is a fixed program that internally controls some electronic device. ISO is International Organization for Standardization. ANSI is American National Standards Institute.
NBS architecture
NBS (NetUP Business server) is a scalable platform for development of client-server applications used to build the NetUPs IPTV Complex.
Introduction
The components of the NBS platform interact via transactions using the application-level NXT (NetUP XML Transaction) protocol. Data encryption and personal authentication are performed via the SSL protocol methods. When dealing with the TV set-top boxes, due to their limited resources, a binary version of the same protocol is used, called NBT (NetUP Binary Transaction). NBT also employs SSL for data encryption and personal authentication. Each transaction may be addressed to one or several components of the system and may contain some events intended for the receiving component to proceed. An event consists of an event type identifier and the accompanying data. NBS guarantees the atomic processing of each transaction. NBS means of clustering and group routing provide a way of easy and transparent scaling (say, an addition of a new VoD server) without stopping the production software.
Streamers
EP G
CAS Billing
Load balancer
Middleware
VoD servers
TVoD servers
unicast
unicast
IPTV Complex includes all necessary systems components to provide TV, radio or video over IP networks, all tightly integrated: Subscriber Management System; Billing System; Conditional Access System (CAS/DRM), protection against unauthorized access at different levels; Interactive graphic interface for IP set-top boxes (STB client + Middleware server); Content source and management (DVB to IP gateways, MPEG encoders, VoD/nVoD servers). Scalability is assured as all IPTV Complex elements are connected in a cluster architecture. All software is developed on basis of NetUP Business Server (NBS), a robust development platform designed to support client-server applications of any complexity.
10
SYSTEM COMPONENTS
Bundling options
NetUPs IPTV Complex may be supplied in the following configurations:
IPTV Combine is a 1U server containing Middleware, Billing, VoD, and streamer, and
equipped with an LCD panel. The corresponding firmware file is named firmware-combine.1.4.xxx, where xxx stands for the build number. IPTV Combine hardware configuration may include:
two transponders, FTA channels only (deprecated option); one transponder with decoding support, i.e. having a CAM slot (deprecated option); two transponders, decoding supported (deprecated option); four transponders, decoding supported (IPTV Combine 4x, see Fig. 2).
The conditional access modules must be put into the slots upside-down, i.e. having the manufacturer logo on the bottom side. Note also that a pair of CAM slots is located in a single orifice.
MW+Billing+VoD (firmware file firmware-complex.1.4.xxx) is a 1U server contain-
ing Middleware, Billing, and VoD. MW+Billing (firmware file firmware-mw+billing.1.4.xxx) is a 1U server containing just Middleware and Billing. Each of these options may be complemented with an arbitrary number of separate dedicated streamers, VoD servers, TVoD servers, and DRM servers. Dedicated streamers may be supplied in the following configurations:
11
Streamer
NetUP's Streamer receives live satellite, terrestrial channels, or cable TV (DVB-S/DVB-S2, DVB-T, DVB-C, RF, ASI). Analog TV or radio channels are handled by real-time MPEG encoders built into the server. Received streams are multiplexed into MPEG Transport Stream and distributed via IP multicast. NetUP's Streamer combines the functions of receivers, decoders, multiplexer, IP streamer, and multicast router, all with single management interface. Depending on particular hardware configuration, it may be fitted into either 1U or 4U rack-mount server. The 1U variety is equipped with an LCD panel. For more info on configuring a streamer, see Web interface on page 73 and (whether applicable) LCD panel on page 71.
12
System Components
The server encrypts and controls IP streams, creates encryption keys and manages subscriptions.
Video on Demand
NetUP's Video-on-Demand server is built on an industry-standard platform and supports over 100 concurrent non-encrypted streams (1000 subscribers at normal VoD peak take-up rate) at typical MPEG-2 compression rate of 4 Mb/s per stream. Both unicast and multicast modes are supported.
Server storage comprises four hot-swap SATA-II hard disks. The total HDD space in the standard configuration is 3 Tbytes or more than 700 movies in DVD quality. External data storage can be connected where required.
13
Middleware
User interface of the Middleware system supports the following services: TV channels; Radio; Video on Demand (VoD) with the functions of searching by name, filtering by genre, and viewing annotations; Virtual Cinema (nVoD); Television on Demand (TVoD); Time-Shifted TV; Network Personal Video Recorder (NPVR); Electronic Program Guide. NetUP's Middleware supports world leading IP set-top boxes: Amino, D-Link, Telergy, etc. For more info on Middleware system interface, see Middleware system on page 23.
Billing
Billing system performs the following functions: subscriber database maintenance; rating of available services; creation and management of tariff plans; creation of accounting documents; access cards management; financial reporting.
14
System Components
Billing system can be integrated with any third-party system controlling services of other types, like Internet access, VoIP, etc. For more info on billing system interface, see Billing system on page 28.
STB Client
Graphical user STB interface of NetUPs IPTV Complex is designed with the use of native API, which provides an advantage in performance as compared to the browser-based interfaces. NetUPs IPTV Complex is compatible with set-top boxes of the following vendors: Amino Technologies (www.aminocom.com) recommended option; D-Link (www.dlink.com); Telergy (www.telergy.eu); Support of set-top boxes of other vendors can be implemented on demand. Setup and following usage of STB Client are described in more detail in STB Client Interface on page 99.
15
16
Media content
A media content is a system object containing record on some multimedia data source, which may be a file or a stream. Media content may get united into media groups, and also may be included (as a part of a group or separately) into various services of the corresponding type. Interface for working with media content is described in Middleware system: Media content on page 24. Creation of media content of different types is described in Creating TV or TVoD content on page 47 and Creating VoD or nVoD content on page 52.
Services
A service is a system object containing a price definition and regulations for charging. TV,
TVoD, VoD, NVoD, and Radio special services also include access to groups or to separate items
of media content of corresponding types (see Content access on page 18). Besides that, the system may use general services not linked to any content, and one-time bonuses (which are, in fact, services with negative price, so they replenish the users account when attached to it). Services may be either one-time or periodic, which affects their price definition (see Service
price on page 17) and charging logic (see Charge-off details on page 18). Bonuses may be only
one-time. Content-related services, as well as bonuses, may be attached to customers only as a part of tariff plans. Services not linked to any media content may be attached either within tariff plans or separately. Tariff plan services may get attached to customers automatically upon attachment of their parent tariff plans (this occurs if the Mandatory flag in the service properties is on), or may be bought and paid for by the customers voluntarily. Interface for working with services is described in Billing system: Tariff plans on page 33 (for those included in tariff plans), and in Additional services on page 36 (for the separate ones).
S er vi ce p ri ce
The currency of the service price is selected upon creation of a service. Price of one-time services is defined in currency units. Price of periodic services is defined in currency units either per day or per month (which is also selected upon creation, together with the currency). The details of price calculation are given in Service cost on page 19.
17
Access may be discontinued prematurely in case if the customers account gets blocked, see
Personal accounts on page 20.
Tariffication type
Periodic services are characterized by the Tariffication type parameter, which is selected among the following options:
Daily prepaid implies that after service attachment the customer is charged till the end of day,
and then is charged daily for every next day; Periodic prepaid implies that after service attachment the customer is charged till the end of month, and then is charged monthly for every next month; Full prepaid implies charging for the entire duration at once. Incompatible with the tariff plans which are attached forever (see Tariff plans on page 19).
charge-off occurs at the moment of service attachment. When a price of a service is changed, given that the said service has already been attached to some users, by the end of the accounting period the total charge-off is recalculated so as to apply the new price retroactively to the entire lifetime of the service. At that, either the extra charge-off is performed, or the sum of the next regular charge-off is reduced, depending on the sign of the change in price. Basically, this is to be done if the price has been set erroneously from the very beginning. Otherwise, i.e. if one has to adjust price at a certain moment, the service itself should be detached from all relevant users and replaced with the new one, providing the same content for a different price. Charging may be affected by the blocking of the clients account, see Personal accounts on page 20.
18
Tariff plans
A tariff plan is a set of services of various types that may be attached to a customer for some time span (maybe forever). Tariff plan having forever instead of the ending date can not contain services with tariffication type Full prepaid. At the end of the accounting period the customers may switch the attached tariff plans on their own (see STB Client Interface: Personal account on page 107), given that the old and new plans are compatible by the roles. Interface for working with tariff plans is described in Billing system: Tariff plans on page 33. Creation and editing of a tariff plan is described in Creating a tariff plan on page 59 and Editing a tariff plan on page 60.
Customers
A customer is a system object containing record on an end user of the services provided and charged for by the IPTV Complex. The set of customers properties depend on its type, which may be Individual, Legal, or Sole
proprietorship. A client of the type Individual or Sole proprietorship may have one or several
persons; customer of Legal type may be linked to one or more legal entities, which are in turn linked to one or more persons each. Every legal entity and every person may be linked to a bank, may have up to three addresses and an arbitrary amount of contacts. Interface for working with customers is described in Billing system: Customers on page 28. Creation of a new customer record and subsequent operations with it are described in Creating a user on page 56, Attaching a tariff plan on page 64, Changing a tariff plan on page 65, and Making payment on page 69.
19
Settlement accounts
Settlement accounts are created automatically for various operations. Depending in the type of operation, a settlement account may have one of the following Types:
Payment opens when a payment is made; Debt opens after balancing on closing the accounting period, if negative balance is revealed; Default opens for all other kinds of operations, including charge-offs.
Summary balance of all settlement accounts (considering the currency exchange rates for corresponding dates, in case if the accounts are in different currencies) is equal to the balance of the personal account. The settlement account closes after the payment is depleted or the debt is covered.
20
United control center allows to configure the Middleware, VoD, Billing, and other systems. This chapter covers the interface of UCC. General features of various systems are described in the sections: Top menu; Left pane (page 22); Common features (page 22). The interfaces of particular systems are listed in the following sections: Middleware system (page 23); Billing system (page 28); nVoD system (page 38); DRM system (page 41); TVoD system (page 42). Installation and working with the UCC are described in Usage examples on page 45.
Top menu
Below is the description of top-level menu of the UCC.
S ys t em
Open connection opens the Connect to server window. Exit closes the UCC window.
Plug-ins
Open opens any of the windows in the current interface. Set default module sets any of the windows in the current interface as default. Set hot keys sets key combinations for quick access to any window of the current interface. Edit properties for plug-ins sets some internal properties for the current system. Show plug-in info chows info about the loaded plugins.
Options
Time zone selects the current time zone.
H el p
Help contents gives a brief description of the given interface. About shows version info.
21
Common features
The basic interface pages contain lists of entities (content items, users, tariff plans, etc.) with a number of features for each entity. Columns of the tables can be reordered by drag-and-dropping. Their width may also be adjusted by dragging the column borders. The representation of particular columns may be switched on or off via the context menu item named Columns. As a rule, the default settings imply that all possible columns are displayed. Records in the list may be ordered by any column via clicking on the column header. Repeated clicking on the same column header reverses the search order. The Synchronize button refreshes the list to reflect possible changes (for example, those introduced by the administrator of another system in the meantime). The Export to csv item of the context menu exports the list in CSV format, considering the current column display settings. Depending on the purpose of the page and the user's rights, the page may contain an interface for addition, editing or removal of its elements. As a rule, the addition or editing of an element is performed in a separate window. Instead, the relatively simple objects (for example, media groups) may be added directly on the page containing the list.
Remove button merely marks an object for deletion. The actual removal occurs on pressing Apply, or is discarded on pressing Cancel. For those elements which may be edited or added di-
rectly in the list, the above applies to these actions as well, i.e. the newly created or edited elements are not saved until Apply is pressed. The top menu (see Top menu on page 21), the left pane with quick links, and the bottom status string displaying current server time, server address, and connection status, are visible and accessible from any interface page.
22
Media groups
Media group is intended to collect together items of media content in order to effectively improve group operations with them (such as to add to the tariff plan or to set a price for). Maximum number of media groups in the system is limited to 64. The interface consists of the following pages: Media groups displays the list of existing groups together with their parameters.
The show/hide settings for particular parameters may be tuned via the Columns item in the context menu. The list of parameters include:
ID; Mask; Name; Type.
The Add
and Remove
23
Media content
Media content is a record about a single unit of content (TV or VoD) which may be referred to in respect to the customers tariff plans. The interface consists of the following pages: Media content displays the list of existing content units together with their parameters.
The show/hide settings for particular parameters may be tuned via the Columns item in the context menu. The list of parameters include:
Owner; State; Type; Media content code; Name; Annotation; Description; Genres; Logo URL;
24
The Filter input field provides a way of filtering by name. There is also a dropdown list for selection by group. The media content state is emphasized by color, with green for Active, blue for Setting up and yellow for Obsolete. The Add available. New media content (opens on pressing Add button on the Media contents page) con, Edit , and Remove buttons for operations with media content are
interface for editing the parameters related to the selected item of content.
25
Usage of program schedule is described in Creating TV or TVoD content, step 6 on page 48. Creation of media content of different types is described in Creating TV or TVoD content on page 47 and Creating VoD or nVoD content on page 52.
26
The show/hide settings for particular parameters may be tuned via the Columns item in the context menu. The list of parameters include:
ID; Owner; IP; Port; Media content; Type; State.
The Filter
TV
input field provides a way of filtering by string search in all fields. The , and NVOD buttons filter the list by type. buttons for operations with media streams are
, Radio , Edit
The Add
, and Remove
available. New media streams are created directly on the same page.
27
tains interface for viewing the properties of a media stream and selecting the media content associated with it.
The creation of media stream is described in Creating a media stream on page 49.
Billing system
The Billing system contains interfaces to the following entities: Customers (with add/modify/remove access); Tariff plans (with add/modify/remove access); Media groups (read-only). Media content (with the possibility to edit group membership). Currency rates; Access cards; Banks; Reports.
Customers
The customers list contain records about particular customers together with their personal data and provided services. The interface consists of the following pages:
28
The show/hide settings for particular parameters may be tuned via the Columns item in the context menu. The list of parameters include:
ID; Login; Name; Comments.
The operations with customers are performed by means of the buttons Add
Remove formation.
, Edit
To remove a customer, one has to close all his accounts in the first place. This can be done on the Personal account management page.
29
Figure 12. Customers personal information. Login; Password; Type; Roles; Comments; Other information. The exact composition of interface fields depend on the customers
type (see Basic objects and processes: Customers on page 19). Personal data, legal entity details, addresses, and contacts are all entered on this very page; bank data are entered on the Dictionaries page. Edit customer (opens on pressing Edit button on the Customers page) contains interface
30
31
To close an account, select the corresponding item (Close personal account) in the context menu. Details of charging for the services are explained in Basic objects and processes: Services on page 17.
The
button opens the Personal account blocks control page, where one may check the
blocking state of the selected account, block the account, or lift the manual blocking imposed earlier (see Personal accounts on page 20). Personal account information (opens on pressing the button of the same name or via the context menu or on double-click on an entry in the Customers list) displays Personal accounts and Settlement accounts (see Settlement accounts on page 20) of the selected customer. Customer equipment (opens via the context menu on the Customers page) contains the interface for introducing particular pieces of hardware associated with the selected customer, as well as editing their parameters. Once the customer in question is assigned with a periodic ser-
32
Creation of a new customer record and subsequent operations with it are described in Creating a user on page 56, Attaching a tariff plan on page 64, Changing a tariff plan on page 65, and Making payment on page 69.
Tariff plans
The interface consists of the following pages:
33
, Edit
, and Remove
34
face for entering the parameters of a new tariff plan, including the list of services and their respective prices.
for editing the parameters related to the selected tariff plan, including the list of services and their respective prices. Before any changes are made, the state of the plan should be switched to Setting up. Creation and editing of a tariff plan is described in Creating a tariff plan on page 59 and Editing a tariff plan on page 60.
35
or at once.
The Add
and Remove
36
Media content
The Billing interface contains the following pages for working with media content: Media content lists the existing media content units, like at Middleware system: Media content on page 24, though read-only. Media content groups (opens on pressing Edit groups in the context menu on the previous page) allows to attribute any content to some group.
Including the media content into the group is described in Creating a media group on page 55.
Securi ty
Security group of pages deals with the access cards. Access card is an SSL certificate intended to establish an encrypted connection with Middleware server, as well as for the authorization and identification of the user. Access cards are generated automatically upon creation of personal accounts.
37
Active access cards are emphasized in the list with green color.
Access codes page contains the list of activation codes, with the ability of gerenating new
ones (see Generating activation code on page 67). Once generated, the new code is given status Active. After having been used by some STB, status changes to Used. A card may not have multiple active codes simultaneously. Activation requests page contains the activation requests counter grouped by IP address. After multiple attempts to activate a card with wrong code, further attempts from the same IP may be blocked (see Resetting activation requests counter on page 68).
nVoD system
The nVoD system contain interfaces to the following entities: Media groups (read-only); Media content (read-only); Media streams (with add/modify/remove access); Broadcast periods (with add/modify/remove access); Broadcast schedule (with add/modify/remove access).
Media groups
The read-only list of media groups is added to the nVoD interface to have the quick access to the information on existing groups and the types of content included in them. Complete interface to media groups belongs to the Middleware system (see Middleware system: Media groups on page 23), while the attribution of media content to groups is made via Billing (see Billing system: Media content on page 37).
38
V ir t ua l c i n ema
Virtual cinema lists the days during the two-week sliding window (by default, covering the present week and the one after it), displaying the number of movies and shows for each day, as well as the number of shows currently running.
The spondingly;
and
buttons scroll the viewing window one week forward or backward, correopens the calendar to jump to arbitrary date, and restores the window to the
default position. Pressing the Edit page for the given day.
Schedules page contains the list of movies to be shown during the particular day. For each of the movies the following information is listed: Film name of the movie (selected from a dropdown list);
39
The context menu of this list contains the following specific items:
Display shows opens the Cinema shows page (see below); Copy schedule from copies the schedule from the selected day; Prepare broadcast for selected record appoints IP addresses for multicasting the selected
record and changes its status from New to Prepared; Prepare broadcast for selected record does the same to all records. The chart in the bottom part of the window displays the number of simultaneous shows per hour. As a record is being edited, the chart reflects the changes on the fly.
Cinema shows page lists the prepared shows for the given day. For each show it contains:
Film; Show number (for the given movie); Since; Till; Broadcast address (appointed automatically). Setting up broadcast schedule is described in the example Setting up nVoD program schedule on page 54.
40
DRM system
The DRM system (also known as CAS) contain interface to media streams, with the ability to create or remove streams, as well as switch the stream encoding on and off.
input field provides a way of filtering by string search. There are also dropThe Filter down lists for filtering by stream type or by the state of the associated content. The Add , Edit , Remove , Receiving, Broadcasting, and Encryption buttons
for operations with media streams are available. The last two may be active or disabled, depending on the current state of the stream. New media stream (opens on pressing Add ters of a new media stream. ) contains interface for entering the parame-
41
cryption) contains interface for setting up the media stream encryption, as well as graphical representation of the bitrate.
Setting up the encryption of a media stream is included in Setting up stream encryption on page 50.
TVoD system
The TVoD system contain interface to the TV media content and associated streams for setting up the recording of a stream.
Media groups
The list of media groups similar to that in the Middleware interface (see Middleware system:
Media groups on page 23) is included in the TVoD interface to have the quick access to the infor-
Media content
The list of media content similar to that in the Middleware interface (see Middleware system: Media content on page 24) is included in the TVoD interface to have the quick access to the
42
with media streams are available. The last one may be active or disabled, depending on the current state of the stream. Media stream dumping (opens on pressing Edit , Receiving, Dumping, or on double-
clicking on the list item) contains interface for setting up the media stream recording. The interface elements are grouped in the following blocks:
Settings sets the auto refresh period; Info displays media content name, record files size and location, and graphical representation of the time span(s) covered by the record; Control contains buttons for receiving and recording. Pressing Receiving starts or stops receiving of the stream, depending on the current state (while stopped, the Dumping button is inactive). Pressing Dumping starts or stops recording of the stream. Statistics contains plot of stream bitrate vs. time. Setting up the recording of a media stream is described in Setting up stream recording on page 51.
Dumping control
The page contains summary interface for recording of media streams grouped in the following blocks:
Records contains the list of all streams being recorded. For each one the following informa-
tion is presented:
43
44
USAGE EXAMPLES
This chapter contains typical scenarios of NetUPs IPTV Complex usage (in addition to the general description of the UCC interface pages which is given in United control center on page 21). All actions are performed via the interfaces of United Control Center (UCC) which itself is installed as described in the first example Installing the UCC on page 45. Initial setup of the IPTV Complex generally includes the following operations: Creation of content (see Creating TV or TVoD content on page 47, Creating VoD or nVoD content on page 52, and Setting up nVoD program schedule on page 54); Creation of users (see Creating a user on page 56); Creation of tariff plans (see Creating a tariff plan on page 59 and Editing a tariff plan on page 60); Activation of tariff plans (see Attaching a tariff plan on page 64 and Changing a tariff plan on page 65); Making payments (see Making payment on page 69).
or
in the folder containing the file, execute
45
5. Start the united control center by running the control.center.se.jar file in the installation directory. A Connect to server window will appear. The Middleware server must be used as DNS server, since it resolves the default systems symbol names to correct IP addresses. If a different DNS server is used, it must be set up to resolve the .iptv zone to the Middleware address, and also to include it in the list of default suffixes for substitution. 6. If a DNS server other than Middleware is used, before starting any particular system interface press Options button next to the starting button of that interface. In the Address field enter the colon-separated IP address and port number used by the server part.The default port numbers are:
System Middleware Billing nVoD TVoD DRM TCP port 50110 50100 50130 50140 50150 Figure 25. United control center starting window.
46
Usage examples
By setting the Name field you may change the systems name displayed in the Connect to server window and in the titles of interface windows of the system itself.
7. After all parameters are entered, press the button to start one of the control interfaces:
Middleware Billing nVoD DRM TVoD
The control interface window will open. The computer must have valid system date and time set, otherwise the system may work incorrectly. If the interface would not load and the error message Cant load keystore. Please check keystore file and password appears instead, download the netup.keystore file from the clients personal cabinet on www.netup.tv and upload it to the systems web interface (see Keystore on page 85).
47
Leave default (assigned automatically). If the TV program is used, this code should be substituted for the channel ID (see Web interface: Channels window on page 79). Name of the new content Annotation for displaying in the client STB interface (see STB Client Interface: Viewing TV channels on page 103) Genres of the media content (a list with an option of multiple choice) Image related to the channel content (scaled to 100 by 140 px)
5. Press Apply
In any of the systems, if you are missing some items (media content, media groups, etc.) created recently in another system, press Refresh in the context menu, or restart the control interface. 6. Create the schedule of telecasts or make sure it is properly created automatically, as described in Setting up telecasts program schedule on page 49. 7. Create a media stream of TV type in the Middleware system as described in Creating a media stream on page 49. 8. To bind the newly created content with the certain channel transmitted by the streamer: 8.1. Select from the list the media stream just created and press Edit
stream page will show up.
8.2. In the Media content column select the newly created TV content.
48
Usage examples
It is recommended to leave the Till date at its default value (forever) in order to ensure that it is not coming while the content is still in use. The users rights to view the content are normally constrained by means of other interfaces. 8.3. Press Apply . Now the new TV content is bound with the media stream you need.
9. Set up the encryption of the stream (see Setting up stream encryption on page 50). 10. If the content is intended for TVoD service, set up its recording, as described in Setting up stream recording on page 51. Further likely appropriate actions are described in the examples Creating a media group on page 55 and Creating a tariff plan on page 59.
The schedule is intended to be displayed in the STB client interface (see Viewing TV
channels on page 103) along with the other channel-related information (descrip-
tion, etc.) during channel selection. As a rule, this action is a step of TV content creation (see Creating TV or TVoD content, step
6 on page 48), though may be performed independently later as well.
49
4.2. In the Media content column use the dropdown list for selection of the content to be broadcast in this stream.
5. If creating a stream for VoD: 5.1. Press Add 5.3. Press Add.
Figure 29. Stream pool creation.
5.2. Enter the IP address and port for the pool being created.
6. Press Apply
As a rule, this action is a step of content creation (see Creating TV or TVoD content, step 7 on page 48 and Creating VoD or nVoD content, step 8.2 on page 52).
50
Usage examples
6. If you want to encode the stream, press Encryption. As a rule, this action is a step of TV content creation (see Creating TV or TVoD content, step
9 on page 49).
4. Select the incoming interface from the dropdown list (if the required interface is missing, add it as described in Adding new network interface on page 70) and press Receiving. The Record button will turn active, and the bitrate plot will start to appear under Statistics. Only open (i.e. not encrypted) content may be recorded. 5. Press Dumping. The TVoD content will start recording, while the recorded portion will be made available to the clients in the TVoD section of the STB interface. The size of record files, as well as the graphical representation of time span(s) covered by the record, will be displayed under Information. As a rule, this action is a step of TVoD content creation (see Creating TV or TVoD content, step 10 on page 49).
51
5. Press Apply
6. Upload the media file to the VoD server via FTP (login is vod, password is similar to that of the web interface, see Web interface: Security on page 87). The file must be in MPEG-2 transport stream format (*.ts). 7. Bind the media content just created to the newly loaded file as described in Web interface: VoD on page 81. 8. If the content is intended for nVoD service, do the following: 8.1. Set up the program schedule for it, as described in Setting up nVoD program schedule. 8.2. Create a media stream of NVOD type in the nVoD system (see Creating a media stream on page 49). Unlike TV, these streams do not need to be associated with any content, since the system enables them automatically as required.
52
Usage examples
The number of streams should be at least equal to the number of shows per day plus 1. Following likely appropriate actions are described in the examples Creating a media group on page 55 and Creating a tariff plan on page 59.
2. In the main menu press Media Convert / Save. The Open Media window will show up. 3. If the original content is in a file, select it by pressing Add. If the original content is to be taken from a DVD, switch to the Disc tab, select the disc in question, and check No DVD menus.
4. Press Convert/Save. The Convert window will appear. 5. In the Destination group of parameters enter the output file name. 6. In Settings select the profile Video MPEG-2 + MPGA (TS) and press . The profile settings window will appear.
Figure 35. Profile selection in VLC.
7. On Encapsulation tab make sure that the type is set to MPEG-TS. 8. On Video codec tab:
53
9. On Video codec tab check Keep original audio track. 10. Press Save to keep settings. 11. Press Start to start conversion. Alternatively, VLC may be started without graphical interface by passing all parameters via the command line. The command required for that is given below. When converting from file: vlc -I dummy filename.avi --sout="#standard{access=file, mux=ts, dst=filename.ts}" vlc://quit When converting from DVD: vlc -I dummy dvdsimple://F: --sout="#standard{access=file, mux=ts, dst=filename.ts}" vlc://quit
4. Select the line corresponding to the day you need to set the shedule for, and press Edit The Schedules tab will appear. 5. Press Add to add a new line to the schedule.
6. Select the media content from the dropdown list. 7. In the corresponding columns enter the first show time, timeshift between shows, and the total number of shows per day.
54
Usage examples
While setting up program schedule, you may receive a warning concerning insufficient number of media streams. In this case create more streams of type nVoD, as described in Creating a media stream on page 49. 8. Press Apply to save the record just entered. The record will be given the status New.
9. Right-click on the record just created and select the context menu item named Prepare broadcat for selected record. The records state will change to Prepared. As a rule, this action is a step of nVoD content creation (see Creating VoD or nVoD content, step 8.1 on page 52).
Content with type VOD may be put into groups of both VOD and NVOD types.
5. Press Apply
6. To add content to the group, start the Billing system interface from the UCC. 7. On the left pane open the Media group and select Media contents. The Media contents tab with a list of existing contents will appear. The Filter input field provides the ability of filtering by name in one of the following regimes: All words, Entire phrase, or At least one word. The regime to apply is selected via the context menu.
55
9. A Media content groups tab will show up with a list of groups to which the content may be assigned. Items of non-matching type are disabled. 10. Select the media group(s) to assign the content to and press Apply group. . The content will be assigned to this
Figure 39. Media groups selection.
Following likely appropriate actions with the newly created media group are described in the example Creating a tariff plan on page 59.
Creating a user
Below is a model pattern of creating a new user (AKA customer), which may be customized to meet particular circumstances. 1. Start the Billing system interface from the UCC (see Billing system: Customers on page 28 for interface description). 2. On the left pane open the Customers group and select Customers. The Customers tab with the list of existing customers will show up. 3. Press Add to add new customer.
The Add user tab will appear. 4. Enter the Login and Password for the new user.
Figure 40. Add user tab.
5. Select customers Type (either a Person or a Legal entity). 6. Press Add to add new person or a legal entity.
Persons full name is to be entered as follows: Last name into the leftmost subfield, then goes First name, then Middle name or initial.
56
Usage examples
7. Fill up the needed fields with the info about the new person or legal entity.
Below is a list of legal abbreviations you may encounter among the optional parameters:
LLC OJSC CJSC NAICS IEC SIC TIN Limited liability company Open joint stock company Closed joint stock company North American Industry Classification System Industrial Enterprise Code Standard Industrial Classification Tax payer identification number
If the physical or registration address is similar to the postal address, mark the corresponding
Same as postal address check box to avoid redundant input.
The button in front of any address input field opens the address input window intended for structured input with existence check. To enter an address in free form, mark the corresponding Arbitrary address check box.
Figure 42. Address input window.
to save the
57
10.2.Enter Name, select Type, and set Equipment Parameters. 10.3. Press Apply to save the changes.
10.4. Later on, this customer must be assigned with a tariff that contains an additional periodic service with its Hardware management option switched on (see Adding services to a tariff plan, step 6 on page 64). 10.5. Also, the hardware management scripts are to be modified to include the treatment of the newly added equipment. The scripts are located at /netup/iptv_billing/python/plugins/ and called on the following events: * block_hardware.py service blocking (i.e. when the user is blocked, if the service is set as Blockable); * unblock_hardware.py service unblocking; * install_hardware.py service activation; * uninstall_hardware.py service deactivation. Log file of the scripts is located at /netup/log/python.log. The most likely following action with the newly created user is described in the example Attaching a tariff plan on page 64. If you want to alter the customers personal data, select the customers name in the list and press Edit .
Note that double-clicking on the customers list (unlike most other lists) opens the Personal account information page rather than the Edit customer page (see Billing system: Customers on page 28). The most likely following action with the newly created user is described in the example Creating a personal account on page 59.
58
Usage examples
Creating a personal account
Below is a model pattern of creating a new personal acccount. 1. Start the Billing system interface from the UCC. 2. On the left pane open the Customers group and select Customers. The Customers tab will show up. 3. Select the customer for whom you intend to create a new personal account, and press Personal account management button. The Personal account management tab will appear. 4. Press Add under the list of customer accounts in order to add new account to the list
(initially empty). 5. Use the dropdown list in the Currency column to select currency for the newly created account. 6. Press Apply to save the changes.
7. Unfold the collapsible pane Access Card Information and copy the activation code to hand it over to the customer.
The most likely following action with the newly personal account is described in the example
Attaching a tariff plan on page 64.
new tariff plan. The New tariff plan tab will ap-
59
8. In the State dropdown list change the tariff plan state from Setting up to Active. 9. Press Apply to save the new tariff plan.
10. Close the New tariff plan page. The most likely following action with the newly created tariff plan is described in the example Attaching a tariff plan on page 64.
4. In the State dropdown list change the tariff plan state to Setting up. 5. Press Apply to save the changes.
While in the Active state, the tariff plan is not editable (all interface elements on the page are disabled). 6. Assign the roles to the tariff plan. Roles assigned to the tariff plan are used to determine the compatibility between plans which is required for user-induced plan switching (see STB Client Interface: Personal account on page 107). To create new roles, go to the System: Roles page of the Billing interface. 7. If needed, add to the plan some content items (see Adding content to a tariff plan on page 62), content groups (see Adding content groups to a tariff plan on page 63), addition-
60
Usage examples
al services (see Adding services to a tariff plan on page 64) and/or bonuses (see Adding
bonuses to a tariff plan on page 64).
If some media content belongs to two or more different groups which attempt to set different price for it, you will notice question mark in the newly created list next to the price of this item. By right-clicking on the question mark, you may specify which of the tariffs is to be applied for this particular item (by default, the lower-price one is assumed). 8. If needed, alter some items in the tariff plan and press Apply 9. If needed, remove some services as follows: 9.1. Change the State of the item in question to Setting up. While in the Active state, a service can not be removed. 9.2. Press Apply 9.3. Press Remove 9.4. Press Apply to save the changes. to remove the service. to save the changes. to save the changes. to save the changes.
10. Change the tariff plan State to Active and press Apply
Removal of tariff plan also requires preliminary changing its state to Setting up, and is possible only for a plan that has never been activated. If the tariff plan is or was used (i.e. associated with some user), it can not be removed by conventional means.
61
3.2. Enter the service Name and Duration. 3.3. Enter either Price per month or the total Cost of the service (once any of these two figures is entered, the other is calculated automatically). 3.4. Set the service State to Active. 4. Alternatively, to create an additional service paid for at once: 4.1. Press Add below the One-time services list.
4.2. Enter the service Name and Price. 4.3. Set the service State to Active. 5. If necessary, repeat the procedure to create more services. 6. Press Apply to finalize the addition of services.
7. Close the Instalments page. The service(s) just created may be added to the customers tariff plan as described in the example Attaching a tariff plan on page 64.
1. In the Billing system interface, open the New tariff plan or Edit tariff plan window. 2. If you are editing an existing plan, set its State to Setting up and save changes. 3. Unfold the group corresponding to the media type of your choice (VoD services, TV services, etc.) 4. Press Add in this group to add new content item.
Media content Media content to be included in the plan (select from the list). Price Price of the service
62
Usage examples
Column Mandatory Description If checked, the service will be activated immediately on activation of the tariff plan. Recommended to check for TV content not included in groups, as well as for all TVoD and radio content, and uncheck for VoD. If checked, the service will be blocked automatically in case if the client is blocked. Active Periodicity at which the charge-offs for this service from the clients account are performed: daily (Daily prepaid), monthly (Periodic prepaid), or for the entire duration at once (Full prepaid).
Note that the content with unchecked Mandatory option may be bought (and hence activated) by the user later. See STB Client Interface: Viewing TV channels on page 103 for details. As a rule, this action is a step of Creating a tariff plan on page 59 or Editing a tariff plan on page 60.
Note that each table containing a column for price or price-per-period is also equipped with a context menu item named Units that displays a list of currencies. If the currency you intend to use is absent, expand the list as described at Adding new currency on page 66. 7. Press Generate services. Every content item in the group will be assigned the given price and added to the tariff plan. As a rule, this action is a step of Creating a tariff plan on page 59 or Editing a tariff plan on page 60.
63
5. Fill the columns, including Service (name of the service), Price, and State (Active). The meanings of check boxes Mandatory and Blockable are similar to those for the content items, see step Adding content to a tariff plan, step 5 on page 62. 6. For periodic services, consider also the Hardware Management check box. If checked, it invokes execution of the corresponding hardware management script on certain events. To employ this functionality, one must set the parameters of customers equipment beforehand (see Creating a user, step 10 on page 58). It is possible as well to assign to the user some additional services not included in any tariff. See Attaching a tariff plan, step 5 on page 65. As a rule, this action is a step of Creating a tariff plan on page 59 or Editing a tariff plan on page 60.
5. Fill the columns, including Service (name of the bonus), Price (which in this case actually contains the bonus sum, i.e. the sum that is added to the clients account), and State (Active). The meanings of check boxes Mandatory and Blockable are similar to those for the content items, see step Adding content to a tariff plan, step 5 on page 62. As a rule, this action is a step of Creating a tariff plan (page 59) or Editing a tariff plan (page 60).
64
Usage examples
2. On the left pane open the Customers group and select Customers. The Customers tab will show up (see Creating a user on page 56 for creating customers). 3. Select the customer to whom you intend to assign the tariff plan and press Personal account management button. The Personal account management tab will appear. 4. Select an account and attach a tariff plan to it as follows: 4.1. Press Add under the Tariff plans list to add a new line to the list (initially empty).
4.2. Select the tariff plan from the dropdown list. (The plan should be created beforehand as described in Creating a tariff plan on page 59.)
4.3. Set the Start date and End date values for the tariff plan, or leave the default values (now and forever, correspondingly). Start date of the tariff plan can not be set to the moment in the past. Note also that the user is capable of switching tariff plans at his own will (see STB Client Interface: Personal account on page 107), so that the new tariff plan is no longer a subject to the end date limitation. 5. If you want to add some additional services not included in the tariff plan: 5.1. Press Add in the Additional services collapsible pane.
5.2. Select the service from the dropdown list. (The service should be created beforehand as described in Creating an additional service on page 61.) 5.3. Enter the Start date value. (If the service belongs to Installment, the End date value will be assigned automatically based on the payment duration). 5.4. If necessary, repeat 5.15.3 to add more one-time services. 6. Press Apply to save the changes.
7. If necessary, repeat the procedure to define alternative tariff for other period. Further operations are described in the examples Changing a tariff plan on page 65 and Making payment on page 69.
65
6. Press Apply
While the tariff plan is enabled, it is impossible to set up another plan covering the same or overlapping time span. 7. Press Add in the Activated tariff plans collapsible pane.
8. Set the start and end dates for the new plan. 9. Select the new plan from the dropdown list. 10. Press Apply to save the changes.
66
Usage examples
2. From the top menu select Plug-ins, then Edit properties for plug-ins. The Properties for plug-ins window will appear.
4. Add the three-letter ISO 4217 codes of one or more currencies to the list by selecting them from dropdown list in the last line. 5. Press OK to save the changes. 6. Press Close to close the Properties for plug-ins window.
67
5. Press Apply
68
Usage examples
4. Set the Counter value to 0.
5. Press Apply
Making payment
To view the IPTV content, a user must have above-zero balance. Below is a model pattern of making a payment. 1. Start the Billing system interface from the UCC. 2. On the left pane open the Customers group and select Customers. The Customers tab will show up. 3. Select the customer to whom you intend to make a payment and press Make payment button (or a similar context menu item). The New payment page will show up. 4. If the selected customer has several accounts associated, selected the necessary one via the dropdown menu. 5. Enter the amount of payment. 6. Select the payment currency, if applicable. 7. Press Apply to make the payment.
Now the services included in the customers tariff plan are available for use. Operations that might be required in the future are listed in the examples Editing a tariff plan on page 60 and Changing a tariff plan on page 65.
69
2. Select the string available_interfaces row and press Edit dow will appear.
3. Enter the name of the new interface to the last string (initially empty). 4. Press OK to save the changes. 5. Press Close to close the Properties for plug-ins window.
70
LCD PANEL
To set up the NetUPs server equipped with LCD panel, do the following: 1. Plug the network and power cables into the device. 2. Switch power on. You shall see Starting... on the LCD panel. 3. Use the LCD manager for the initial setup of the system. LCD manager provides a convenient way to monitor the CPU and LAN interface load on the device front panel, as well as to assign IP addresses to network adapters.
Statistics screen
The software contains two statistics screens. The first and principal is the screen that lists the amount of traffic through the network adapters. Lower line of the screen presents the total rate of incoming and outgoing traffic separated by /. Pressing Up switches to the CPU load screen. First number is the total CPU load. Three subsequent numbers give, correspondingly, the portions of CPU load related to user tasks (u), system tasks (s), and awaiting data from the peripherals (w). Pressing Down switches back to the traffic statistics screen.
After selecting the interface you want to set up, press Enter. Then you will be prompted to change current IP address for the selected interface. Pressing Fn, then Up or Down selects the byte to change (at that, ">" points to the currently selected byte). Pressing Up and Down, correspondingly, increases and decreases the selected byte value by 1.
71
mask. It is entered by pressing Up or Down, which increases or decreases the number of bits in the mask determining the subnet address.
After entering the subnet mask, press Enter. Then you will be prompted to keep the changes just made or cancel them. Buttons Up and Down switch between Yes and No, with currently selected option emphaFigure 60. Save changes screen. sized with brackets. Select Yes to save the settings just made, or press Enter to proceed back to the network interface selection screen. When the settings are done, set up your DNS server (via its config file) to associate the IP address just entered with mw.netup domain name.
72
WEB INTERFACE
Starting web interface
Web interface is intended for setting up various server parameters. To enter the web interface, start your browser and type http://<server IP address or domain name> in the address field. You will be prompted to enter login and password. The default values are stated in the equipment certificate. It is strongly recommended to change the password immediately after logging in for the first time. This can be done via the Security page (see Security on page 87). Left pane of the web interface stays visible on every page and contains the following groups of links: The composition and the very presence of particular interface pages and entire groups may depend on the hardware configuration of the server. 1. Cluster configuration group (present only on Middleware servers)
Date and time (page 74) containing date and time settings; Management (page 74) for system components management;
2. Files group
Control center (page 75) for downloading the united control center; Documentation (page 75) for downloading the documentation; STB Files (page 75) for downloading miscellaneous STB-related files;
73
has failed;
Sync if the sync hsa been performed successfully; Reserved if this time server has not been used yet.
Syncronization occurs once per hour. The servers are tried in presented order till the first success.
Management
This page displays the system components (servers) together with their Status (Active / Not active) and action buttons to activate or deactivate particular servers.
Figure 62. Management page.
74
Web interface
Control center
This page contains the united control center. Guidelines for starting the control center and further operations with it are listed in Usage examples (page 45). Before downloading the united control center, you have to upload (see Keystore on page 85) the security.tgz file obtained via the personal cabinet.
Documentation
This page contains the latest system documentation in a single PDF file.
Figure 63. Documentation page.
STB Files
On this page the service program MCUP for handling the D-Link STBs is available for download. Besides that, it contains the NetUP STB firmware for various supported STBs. The development tools for modifying firmware should be requested from the manufacturer, as well as the means of downloading it to the STBs. The downloading mechanism (see Firmware update on page 81) is intended solely to distribute the new builds of NetUP STB firmware and not their custom modifications.
DVB
DVB page displays the list of DVB adapters installed in the system together with their current state. Below is the parameters explanation by column.
Figure 64. DVB page.
75
Hardware is the adapter state (OK / Failed). Service is the software state (Running / Stopped). Note that column headers are clickable. Clicking on a column header sorts the records by this column. Second click on the same header reverses sort order. Actions lists possible operations with the adapter, including:
Configure switch to Configure screen (see Adapter configuration window on page 77)
Note that stopping service stops transmitting video stream to network from this adapter.
76
Web interface
Adapter configuration window
This window is intended for setting up basic parameters of DVB adapter.
For convenience parameters are grouped in the following blocks: Adapter status. This block (refreshed automatically each 2 seconds) displays current state of the adapter, including the following parameters:
Service status shows current state of the service (Running or Stopped); Adapter status shows adapter state, including:
* SIGNAL presence of the signal (red means no signal); * CARRIER presence of the carrier frequency (red means no carrier); * FEC presence of the error correction; * SYNC synchronization with the signal; * LOCK adapter has locked on the signal and decodes it successfully. When the system works correctly, all indicators are green. Red means that the incoming signal is either missing or corrupted.
CAM status lists available CAIDs.
Adapter settings. This block contains controls for frequency, polarization and other signal parameters, including:
Frequency is the incoming signal frequency, in MHz;
Note that changing frequency may lead to the loss of channel settings for the given adapter. See Channels window on page 79 for details.
Symbol Rate is the rate of symbol transfer; Input standard is the signal type, which is selected among:
* DVB-S;
77
mation;
Multicast TTL is the time-to-live for multicast packet, in hops; Tone enables controlling the LNB by feeding a special 22 kHz tone to it; Send EPG to the middleware enables sending EPG to the middleware so as to make it
accessible from the client STBs (see Viewing TV channels on page 103). On some streamers, a Not configured line may appear instead of the Send EPG
to the middleware check box. In this case, consult NetUP for further maintenance. LNB Parameters (present if Input standard is DVB-S or DVB-S2) contains the converter
Figure 67. LNB Parameters block. Low frequency is the LO frequency for the low-frequency range of satellite signal. High frequency is the LO frequency for the high-frequency range of satellite signal. Switch frequency is the border between satellite signal frequency ranges.
When Input standard in Adapter settings is set to DVB-T, the LNB parameters block is substituted with DVB-T parameters. DVB-T Parameters (present if Input standard is DVB-T) are the settings of conversion of a terrestrial signal for transmission via a coaxial cable:
Modulation; Transmission mode which selects the number of carriers (2K/8K); Guard interval. DVB- Parameters (present if Input standard is DVB-S or DVB-S2) are the settings of con-
78
Web interface
Channels window
This window lists all channels found by the DVB adapter.
Note that this page will show up correctly only if the adapter software is set up correctly and running normally (check that all the color indicators in the Adapter Status block are green). For each entry, its Channel name, ID, Audio PID, Video PID, and CAID are shown. Channel
Type is indicated by the sign in the left, which may be one of the following:
free-to-air TV stream; encrypted TV stream; free-to-air radio stream; encrypted radio stream.
The list begins with the channels that are already streaming, if any. For them, multicast IP addresses, Port numbers, and network Interfaces are also shown. Below follow channels that are not configured yet (having their IP address field empty). To set up the channel, enter the required parameters. New input lines may be added by pressing the + button next to the IP field, in case the channel is intended for streaming to multiple addresses. If the EPG is set up to be sent to the middleware (see Adapter configuration window: Send
EPG to the middleware on page 78), enter the content codes (see Creating TV or TVoD content,
step 4 on page 48) in the text input fields under IDs of the corresponding channels. The + and buttons in the Audio PID column allows the selection of multiple sound tracks for a channel (when available), so as to leave the final choice between them to the end user. Press Save to save the parameters when done.
79
EPG
On this page an EPG in XMLTV format may be uploaded from file or from given URL.
Once EPG is imported, the list of channels is revealed so that their internal IDs may be set.
In case of using the Upload from URL option, from that point on the EPG will be updated daily from the same address.
80
Web interface
VoD
This page is intended for binding the media content codes from Middleware with the loaded media files.
When a VoD-type media content is created and the corresponding file is loaded (see Usage
examples: Creating VoD or nVoD content on page 52), select the file in the list, press Activate
Firmware update
Firmware update page provides controls for upgrading the firmware of STBs and setting up the automatic upgrade service. Alternatively, this may be done by hand, see STB setup on page 91.
Page contains the list of available STB models with the following parameters for each: STB type; Current Firmware version (build numbers); Multicast IP address for sending firmware updates; Network interface for sending firmware updates; Status of the automatic upgrade service (Enabled / Disabled); Possible Actions, uncluding:
81
* Network interface for sending firmware updates; * Multicast TTL (time-to-live of multicast packet) in hops; * Multicast address (bootstrap) to send the bootstrap.signed file; * Corresponding Multicast port (bootstrap); There is no need to enter this IP address into the routing table (see Routing table window on page 86), since it is added automatically. * Multicast address (filesystem) and Multicast port (filesystem) address and port to send the second portion of the upgrade (mc2.mcfs file); * Serial number (bootstrap) serial number of the bootstrap.signed file; * Serial number (filesystem) serial number of the mc2.mcfs file; These serial numbers serve for the sole purpose of maintaining the correct versions order, so they may be assigned more or less arbitrarily; the only requirement is to set them higher than those of the currently installed build. * Save button to save the foregoing parameters.
Enable starts the automatic firmware upgrade service; Disable stops the automatic firmware upgrade service.
STB management
STB management page provides detailed manual controls for STBs. Alternatively, same operations may be done by hand, see STB setup on page 91. Page contains the list of available STB models with the Manage and Configure controls for each.
82
Web interface
Manage provides a list of commands to be sent to some STBs:
Set resolution (once selected, produces a dropdown list for setting the desired resolution,
The firmware update system is intended solely for the distribution of new firmware provided by NetUP. Each command may be sent either to multicast or to unicast IP. In the former case it uses the address set by Configure; otherwise, the unicast address entered in the same window. Configure provides controls which set the network interface and multicast IP address for sending commands selected in Manage (unless an unicast IP is specified).
Styles
Styles page contains the list of user styles for IP STBs.
Following control buttons are available: page 91 for info on creating user styles).
Compile opens the window for up-
Add opens the window for uploading new style in RCC format (see Updating user theme on
loading new style in a zip archive with simultaneous compilation into RCC. Get source downloads the source files of current style as a zip archive. Remove (in the list of styles) removes the corresponding style.
Figure 76. Create style window.
Once uploaded, the new style becomes available for selection via the Styles screen of the STB client interface as described in STB Client Interface: Settings on page 108.
83
Backup
This page provides control interface for system backups. Create button creates an archive in *.tar.bz2 format containing system settings; also, an automatic backup is made every day. Existing backup files together with their creation dates are listed in the table. Delete button next to a file removes it.
More details on creation and usage of backups may be found at Backup copies on page 129.
Power Management
This page contains Reboot and Shutdown buttons. Whenever the server needs to be reloaded or shut down, this should be done exclusively by means of these controls; abnormal termination may lead to system failure.
Update
This page lists the uploaded firmware files together with their uploading dates, build numbers, and possible actions.
This page allows to update the IPTV Complex firmware. To do that, upload the new firmware file to the server via FTP (login: update; password is similar to that of the web interface, so that both are changed simultaneously, see Security on page 87), refresh the page to reveal it in the list, and press Install.
84
Web interface
Keystore
This page contains the interface for uploading the security.tgz file, which is required for working with STBs and the admin interface. The file has to be downloaded from the clients personal cabinet on www.netup.tv after installation of the system (unless preinstalled as factory default) and afterwards downloaded anew after each update of the systems components. The security.tgz file must be uploaded prior to the downloading of the united control center (see Control center on page 75).
Network
Network page gives the full list of installed network adapters together with their state.
Network connectors on the front panel of the NetUP streamer are marked as follows:
On the panel 1 2 eth1 3 eth2 4 eth3 5 eth4 6 eth5
The Setup routing button opens routing table (see Routing table window on page 86). The
VLAN button opens the interface to virtual network adapters (see VLAN window on page 86).
Interface column lists the system names of the adapters; Status lists the adapter state (ON / OFF); MAC lists MAC addresses of network adapters; IP lists the adapters IP addresses; DHCP shows the DHCP state (Running / Stopped); Actions column lists the possible operations with the given adapter:
Configure configure adapter (see Configure window on page 86); DHCP set up DHCP for this adapter (see DHCP configuration window on page 87); Statistics show graphical load statistics for this adapter.
85
To set the default gateway, enter 0.0.0.0 for Destination and also 0.0.0.0 for Mask.
VLAN window
To create new virtual LAN interface based on the selected physical interface, enter VLAN ID and press Add. A new VLAN with name composed of the physical LANs name and the ID will be created.
To remove a VLAN, press Remove in the corresponding row. Using the newly created VLAN may require some tuning on the UCC side, see Usage examples: Adding new network interface on page 70.
Configure window
This window contains configuration options of network adapter.
86
Web interface
For convenience parameters are grouped in three blocks:
Adapter Information
This block shows the adapters system name (Adapter) and MAC address;
IP Addresses
Contains IP addresses assigned to this adapter. To remove any address (unless there is only one left), press Remove button next to it. To change an address, type it in the input field and press Save. To assign an additional IP address for the adapter, type IP and Mask values into the corresponding input fields and press Add.
Figure 83. DHCP configuration window. First IP address and Last IP address input fields are intended to enter the boundary values of the IP addresses pool. Start and Stop buttons serve to start and stop the service.
Security
This page contains interface for changing the administrator's password (for default value see Starting web interface on page 73). To do so, type the new password twice in the New Password and Repeat Password fields and press Update. Passwords to FTP access for uploading content and firmware are bound to be identical to the administrators password, so they are updated automatically along with it.
Figure 84. Security page.
87
Status column displays the current status of components (Running / Stopped). Actions lists the possible operations with the given component (Start / Stop).
Status column displays current status of services (Running / Stopped). Actions lists the possible operations with the given service (Enable / Disable). A virtual tunnel is a technology that may be used by the NetUP technical support team to remotely control your server. To provide a virtual tunnel, your server must have a static IP address. Besides, you have to send the etc/vtund.conf file to NetUP.
About
This page displays the version number of IPTV Complex and build numbers of individual systems.
88
Web interface
Connections
This page displays the connections between the systems of IPTV Complex (including individual STBs). For each system it lists the IP address, port, and protocol in which it interacts with other systems.
Storage
This page summarizes the disk space usage info.
89
90
STB SETUP
STB client theme (style and language settings, including images, interface text, etc.) may be updated and uploaded to user STBs. The guidelines for altering and uploading of style and language files are given below (see Updating user theme). To upload the modified user style and language files to the server, use the web interface (see Styles and Translations on page 84). Uploaded files may be selected and installed to a particular STB via the STB interface itself (see STB Client Interface: Settings on page 108). The complete firmware update, as well as some other vendor-specific operations are also performed via the corresponding pages of the web interface (see Firmware update on page 81 and STB management on page 82). Same operations may be performed manually with the use of specialized software, as described in Amino AmiNET on page 93 and D-Link on page 96. For more hints on low-level STBs debugging see STB diagnostics on page 129 and Amino STB troubleshooting on page 129. The firmware development tools, as well as the means of downloading firmware to the STBs, should be requested from the manufacturer.
91
Changing color
To change the interface colors: 1. Download and unzip style-source.zip. 2. Find the color descriptions in the style file for the desired resolution (see color/*.ini): editable_background="white" highlight_background="#3366cc" title_background="#4d697c" 3. Change the colors: editable_background="#f0f0ff" highlight_background="#6633cc" title_background="#586060" 4. Save the style file. 5. (Optional) Remove all unmodified style files. 6. Create a zip archive containing the style folder and download it to the server.
92
STB setup
4. Save the language file as language.ts. 5. Create a zip archive containing the language file and download it to the server.
Amino AmiNET
External DHCP settings
The DHCP server, among other duties, informs the STBs about the IP addresses that the firmware updates come from. If for some reason setting up a DHCP server is unsuitable, these parameters may be set up manually (see Manual setup on page 94) on each STB. STBs of various models (or at different steps of upgrade) may require different updates and, consequently, must be recognized by their ID strings and directed to different IP addresses. The example dhcpd.conf distributed by NetUP contains a number of sections related to different STBs. Normally the Middleware server is configured to provide the DHCP service. When using a third-party DHCP server, one should copy all the needed sections to its config file. Below is a fragment of dhcpd.conf config file related to the Amino AmiNET110 STBs: class "AmiNET110 mboot" { If the STB if on the first stage of update, match if (option vendor-class-identifier ="aminoAMINET11xmboot") or ((substring(option vendor-encapsulated-options, 2, 9) ="AMINET11x") and (substring(option vendor-encapsulated-options, 13, 5 ="mboot")); it is provided with the IP address and port number to download bootstrap.signed: vendor-option-space AMINO; option AMINO.address 225.50.50.50; option AMINO.port 11111; } class "AmiNET110 upgrd" {
93
Manual setup
Network parameters The network parameters which are normally set by DHCP (see External DHCP settings on page 93) may be also entered manually for an individual STB, together with some other parameters. To do that, connect to the STB via telnet and set the following parameters using the libconfig-set command: libconfig-set libconfig-set libconfig-set libconfig-set libconfig-set libconfig-set NORFLASH.DHCP N NORFLASH.IPADDR 10.1.2.3 NORFLASH.NETMASK 255.255.255.0 NORFLASH.GATEWAY 10.1.2.1 NORFLASH.DNS 10.1.2.1 NORFLASH.TIME_SERVER 10.1.2.1
94
STB setup
libconfig-set NETCONF.DOMAIN iptv Telnet access to STBs is protected by a password which may be reset remotely, see Password on page 96. Here the NORFLASH.IPADDR and NORFLASH.NETMASK parameters refer to the STB itself and may be set arbitrarily, NORFLASH.GATEWAY must correspond to the gateway IP address, while NORFLASH.DNS and NORFLASH.TIME_SERVER must be set to the IP address of Middleware server. The following four parameters contain the IP addresses and ports of multicast delivery of the two parts of firmware. Exact names of parameters may vary for different STBs. Below is an example for Amino AmiNET110: libconfig-set libconfig-set libconfig-set libconfig-set Time zone Time zone may be also assigned by running the libconfig-set command via telnet. The NORFLASH.TIME_ZONE parameter should be set to time zone in any of the following formats: Posix time zone name (Europe/London); Common abbreviation (GB-Eire); Full Posix specification (GMT0BST-1,M3.5.0/01:00,M10.5.0/02:00). Output signal parameters Output resolution for HDMI may be set as follows: libconfig-set NORFLASH.OUTPUT_RESOLUTION HD720P50 libconfig-set SETTINGS.GFX_RESOLUTION HD720 Possible values for NORFLASH.OUTPUT_RESOLUTION include: HD480P59 HD576P50 HD720P50 HD720P59 HD1080I50 HD1080I59 The ability to work in each of these regimes depends on the versions of STB hardware and firmware, as well as on the parameters of the output device itself. Rollback to default setting (determine maximum resolution automatically) is done as follows: libconfig-set NORFLASH.OUTPUT_RESOLUTION SDAUTO NORFLASH.MULTICAST_BOOTSTRAP_GROUP 225.50.50.50 NORFLASH.MULTICAST_BOOTSTRAP_PORT 11111 NORFLASH.MULTICAST_UPGRADE_GROUP 225.50.50.51 NORFLASH.MULTICAST_UPGRADE_PORT 11111
95
D-Link
Forced update
If the automatic multicast upgrade fails for any reason, connect to the STB by telnet and start the mcup program (having previously copied it to the STB, if necessary). This program will perform firmware update by downloading the new version from the multicast address 226.1.2.5:1000.
Manual setup
Update In case if the STB does not accept the update, either request the instructions from the vendor, or use the following (though not verified by vendor) method: 1. Start a telnet connection to the STB;
96
STB setup
2. Copy the /proc/mtd and /proc/meminfo files to any location outside of /proc; 3. Unmount /proc; 4. Make /proc writable; 5. Edit the mtd file to make it look as follows: dev: mtd0: mtd1: mtd2: mtd3: mtd4: mtd5: mtd6: mtd7: mtd8: mtd9: size 01200000 00200000 00200000 001c0000 00440000 000c0000 00080000 00280000 00020000 00020000 erasesize name 00020000 "a0_rootfs" 00020000 "html" 00020000 "kernel" 00020000 "a0_kernel" 00020000 "b0_rootfs" 00020000 "cfe" 00020000 "splash" 00020000 "a0_config" 00020000 "variable" 00020000 "misc"
6. Copy /proc/mtd and /proc/meminfo files over their previous location. If the telnet connection to STB is impossible, request the further instructions from the vendor. Output signal parameters STB output resolution is set by default to HD720. To set another output resolution, include the following lines into the /etc/sysmgmt/settings file: OUTPUT_RESOLUTION=HD1080I for HD1080 (50Hz), or OUTPUT_RESOLUTION=AUTO to autodetect resolution. Output signal type is set by the OUTPUT_CHANNEL variable, which may take one of the following values:
SD_CH_COMPOSITE SD_CH_COMPONENT SD_CH_SVIDEO
97
98
STB Client's interface is reproduced on the TV screen by means of the set-top box. This interface enables the customer to:
Set language and interface settings, select the tariff plan to switch to, view financial statement; Control the process of viewing movies and TV programs. Setting up the additional functionality (volume control) of the Amino AmiNET remote control is described in Setting up Amino remote control on page 135. For the special edition of STB client integrated with hotel property management systems, see
STB Client Hotel Edition on page 113.
For correct operation of the system the Middleware server must be used as its DNS server. If a different DNS server is used, it must be set up to resolve the .iptv zone to the Middleware address, and also to include it in the list of default suffixes for substitution.
Startup
At first launch the user is prompted to enter the activation number. On subsequent launches the authorization is performed automatically.
99
If the selected style does not match the TVs physical resolution, then the style selection screen will also appear on the next launches, until a proper style is set. On the next step the user is prompted to select interface language.
100
In case if the STB is physically disconnected from the network, it boots into the offline mode. This can be verified by the Not connected line in the Middleware address field on the Network Information screen (see Settings). To switch to the normal mode, restore the network connection and reboot the STB.
Common features
The menu with partially transparent background is superimposed over the playing content and can be enabled or disabled by pressing Menu button of the remote control panel. Interface screens are split into several sections. The tree menu placed at the left is shared by all screens. As a rule, the remote control buttons Up and Down serve to switch between menu items of the same level, while Right and Left are used to switch between menu levels and open the selected menu item. Other remote control buttons may possess specific meanings which are described on each screen separately. When the screen contains a list of content items of some kind, one of which is currently playing, this content is marked in the list with the paused or stopped). sign (or maybe, or , if the reproduction is
Textual information, whenever required, may be entered by means of the virtual keyboard, which is revealed or hidden by pressing the Rec button of the remote control panel. Use the arrows and digit keys to navigate the keyboard. Repeated strokes of the same digit key selects the letters from the column below it in a cyclic order, akin to typing on a cell phone. Case shift is made by the ABC/abc buttons of the virtual keyboard. Cyrillic layout option is also provided (ru/en).
101
The replay is controlled by video buttons of the remote control panel. VoD content may be fast-forwarded with the speed up to 128x, or rewind with the same maximum speed. TV content may also be paused or scrolled fast (a feature known as Time-Shifted TV) if the given channel is recorded (see TVoD system on page 42). When a video content with multiple audio tracks is playing, pressing the yellow function button switches between the tracks in a cyclic order. Regardless of the menu state, whenever a video content starts or stops playing or rewinding, a status bar appears on the screen. It also may be summoned by the blue function button while the menu is hidden.
Figure 94. Status bar (play stopped).
When a VoD content is playing or rewinding, the status bar also displays its present moment and total length.
When a TV content is playing, the status bar also contains TV program for the given channel.
In playing mode the status bar disappears automatically after some delay. In other regimes it stays on the screen until hidden by the red function button.
102
Figure 97. Available channels screen. Favorite screen lists selected channels with the options of viewing and removing from the fa-
vorites.
103
Detailed program guide for the highlighted channel is shown in the bottom part of the screen. Current and future programs are marked with . Finished programs are marked with . By pressing OK the focus switches to the bottom part of the screen. In this regime one may schedule a switch to any program (also by pressing OK; if the program has already started, the switch occurs immediately) or a notification (by pressing the green function button). Programs associated with scheduled switches or notifications are marked in the list with symbols or , correspondingly. The complete list of all scheduled events is available on the Scheduler screen (see Additional on page 110). Initially the screen displays the program for the current hour. By pressing Right/Left the program for other moments in the future may be retrieved. There is also an option of switching to records. In this regime Right and Left buttons provide the way of navigation between different time instants in the past. Available TVoD records are marked with denoted . , non-recorded programs are
TV groups screen lists available groups of TV channels, if the users tariff plan contains any, and provides the functionality of enabling and disabling those of them which are not enabled by default.
104
To order a movie, one may use the Order by group, Order by genre and Order by name screens, each listing content items included in the users tariff plan with Mandatory option off (see Creating a tariff plan on page 59). The description of the highlighted movie is shown in the bottom part of the screen. To order the highlighted movie, press OK.
Ordering a movie will require a financial password, if it is set (see Settings on page 108).
105
Once ordered, the movies become available in the Available seances screen.
When a movie is selected, its program schedule appears (see Setting up nVoD program
schedule on page 54), including the already started shows. Once a show is selected, the sched-
uled switch to it is set up. If the selected show is already running, the reproduction will start immediately.
Listening to radio
The radio listening interface contains two screens, namely, Available and Favorite. Their functionality is analogous to that of the similarly named screens of TV channels interface. That is, Available contains a pool of radio programs that may be selected and added to favorites, while on Favorite screen you may start playing the selected program.
106
Figure 104. Information screen. Replace tariff plan provides the interface for switching to another tariff plan by selecting it from the list. The list is composed of tariff plans that overlap by roles (i.e. have some roles in common, see Editing a tariff plan, step 6 on page 60) with the current one.
107
Settings
The Settings interface consists of the following screens.
Security screen contains the interface for setting, changing, and unsetting various passwords:
Unlock password. Once set, this password is required to start the STB interface after each hardware reboot; Financial password. Once set, it is requested before every finance-related operation, like buying content, changing the tariff plan, etc.; Parental password. Once set, it is requested for gaining access to an adult content (this property of the content is derived from its genre attribution). To unset any password, change it to empty string.
108
Figure 108. Network information screen. Styles screen contains the list of available custom user styles for STB interface. See Web interface: Styles on page 83 for uploading user styles).
109
Additional
Scheduler screen displays the list of scheduled events, including switches, notifications, and alarm clocks. An alarm clock event may be set up on this very screen. At scheduled time it switches TV on at top volume.
110
111
112
10
Hotel edition is a special edition of STB client tailored for integration with the hotel property management systems (PMS). Usage of this version imposes some extra requirements concerning the properties of users and tariff plans (see Preparations on page 113). Currently, the hotel edition is compatible with MICROS-Fidelio systems supporting the FIAS protocol. STB Client's multi-language interface is reproduced on the TV screen by means of the set-top box and provides the following services: Welcome message on guest check-in; Hotel information page; Selection and viewing of TV channels and movies; Auto posting TV services from the IPTV system to the PMS system; Hotel bill preview; Messages from reception; Express checkout; Setting room status (dirty/clean) via TV for the housekeeping service. For correct operation of the system the Middleware server must be used as its DNS server. If a different DNS server is used, it must be set up to resolve the .iptv zone to the Middleware address, and also to include it in the list of default suffixes for substitution.
Preparations
To use the STB client integrated with a hotel property management system, an associated customer for each room in the hotel should be created in IPTV Middleware. The said customer must have the following properties: Customers type is set to Individual; Customer has no associated persons (instead, a person is created automatically on the clients check-in and removed on check-out); Customer has one and only one personal account, whose ID is equal to the room number; Customers account is permanently blocked (it is going to be unblocked automatically on the clients check-in and blocked again on check-out); Accounts credit is not set (i.e. set to 0); Account is linked to a tariff plan, see the requirements below. The tariff plan must have the following properties: State is set to Active; State of every service is also set to Active;
113
Startup
At first launch the user is prompted to enter the activation number. This is normally done by the service personnel upon installation of the system. From then on, the authorization is performed automatically.
If the activation number has been entered incorrectly for 10 times, further attempts will be blocked and the requests counter should be reset as described in Resetting activation requests counter on page 68.
114
Welcome screen is actually a dynamic web page located on the Middleware server at /netup/sysconfig/hotel/welcome.php. Clients name is passed to the page via the query string parameters first_name, middle_name, and last_name; two-letter ISO language code is passed as lang. Clients name and language are communicated to the STB client by the hotel PMS. Language may be changed by the client afterwards (see Settings on page 118). On subsequent launches, one of the user interface screens will show up. If screen locking password is set up in the system (see Settings on page 118 for setting and unsetting the password), the lock screen will appear first, prompting the user to enter this password for unlocking.
In case if the STB is physically disconnected from the network, it boots into the offline mode. This can be verified by the Not connected line in the Middleware address field on the Network Information screen (see Settings). To switch to the normal mode, restore the network connection and reboot the STB.
115
Textual information, whenever required, may be entered by means of the virtual keyboard, which is revealed or hidden by pressing the Rec button of the remote control panel. Use the arrows and digit keys to navigate the keyboard. Repeated strokes of the same digit key selects the letters from the column below it in a cyclic order, akin to typing on a cell phone. Case shift is made by the ABC/abc buttons of the virtual keyboard. Cyrillic layout option is also provided (ru/en).
The replay is controlled by video buttons of the remote control panel. VoD content may be fast-forwarded with the speed up to 128x, or rewind with the same maximum speed. TV content may also be paused or scrolled fast (a feature known as Time-Shifted TV) if the given channel is recorded (see TVoD system on page 42). When a video content with multiple audio tracks is playing, pressing the yellow function button switches between the tracks in a cyclic order. Regardless of the menu state, whenever a video content starts or stops playing or rewinding, a status bar appears on the screen. It also may be summoned by the blue function button while the menu is hidden.
Figure 117. Status bar (play stopped).
116
When a TV content is playing, the status bar also contains TV program for the given channel.
In playing mode the status bar disappears automatically after some delay. In other regimes it stays on the screen until hidden by the red function button.
Multimedia
TV channels screen lists all channels available according to the users tariff plan (see Creating a tariff plan on page 59). The program guide for the highlighted channel is shown in the bot-
tom part of the screen. The reproduction starts after selecting an entry and pressing OK.
Figure 120. TV channels screen. TV groups screen lists available groups of TV channels, if the users tariff plan contains any, and provides the functionality of enabling and disabling those of them which are not enabled by default.
117
Ordering a movie will require a financial password, if it is set (see Settings on page 118).
Settings
The interface of this group consists of four screens.
Information displays the current tariff plan, card validity period, and balance.
118
Figure 123. System information screen. Security screen contains the interface for setting, changing, and unsetting various passwords:
Unlock password. Once set, this password is required to start the STB interface after each hardware reboot; Financial password. Once set, it is requested before every finance-related operation, like buying content, changing the tariff plan, etc.; Parental password. Once set, it is requested for gaining access to an adult content (this property of the content is derived from its genre attribution). To unset any password, change it to empty string.
119
Services
Bill displays the financial report, i.e. the history of payments and charges for the hotel services, not limited to the IPTV-related ones. Moreover, it provides an option of self-checkout.
120
Figure 127. Messages screen. Scheduler screen displays the list of scheduled events, including switches, notifications, and alarm clocks. An alarm clock event may be set up on this very screen. At scheduled time it switches TV on at top volume.
121
Hotel info is actually a static web page located on the Middleware server at /netup/sysconfig/hotel/info.html . Upon pressing Rec on this screen, STB client requests the housekeepers password and then opens a special screen where a housekeeper may specify the status of the room.
122
PC CLIENT
11
PC client is an application for PC that covers the functionality of an STB client running on an STB attached to TV. For correct operation of the system the Middleware server must be used as its DNS server. If a different DNS server is used, it must be set up to resolve the .iptv zone to the Middleware address, and also to include it in the list of default suffixes for substitution. All settings and content selection are performed in the main window of the program. Video content, on the other hand, is reproduced in a separate window, which also contains the corresponding controls and is capable of switching to full-screen mode. The interface elements are grouped into several tabs. The main menu stays on the left and is accessible from any tab. On first launch the program requests the activation code.
123
On the right there is a list of all channels available according to the users tariff plan (see Creating TV or TVoD content on page 47, Creating a tariff plan on page 59). Refresh
nel (or channels, as the list supports multiple selection) to an existing or new playlist. The following viewing regimes are available for the list: mode shows just the list without any extra info; also shows the TV program for the selected channel; Show channel description also shows the description of the selected channel.
List Show TV program
Pressing Play or double-clicking on a list item starts playback of the selected TV content (see Playback window on page 126). Double-clicking on a TV program item starting in the future causes cyclic change between and Notify states; double-clicking on a telecast in the past starts playing TVoD, if the said telecast has been recorded.
Switch to
VoD
This tab contains the interface for selecting and viewing VoD content.
124
PC Client
On the right there is a list of available content. Movies may be added to palylist. Once a content item is selected, its description appears below. Pressing Order opens the Market tab where more movies can be ordered. Pressing Play or double-clicking on a list item starts playback of the selected video content (see Playback window on page 126).
Radio
This tab contains the interface for selecting and listening radio content, essentially similar to that for the TV content.
Market
This tab contains the lists of movies, NVoD shows, and TV channels available for sale, all on separate second-level tabs. The lists may be filtered by genre or by name. Pressing Buy or double-clicking on a list item opens the order confirmation window that shows once more the name of content, its price, and period of validity.
Playlists
This tab contains the register of playlists composed by the user. There is an interface for deleting playlists ( ) or creating new ones ( ), as well as removing content from playlists ( ). Pressing Play or double-clicking on a list item starts playback of the selected content (see Playback window on page 126).
Settings
Interface page contains the following interface settings flags:
Related to the users personal account: State (active or blocked); Balance at the start of current period; Payments during the current period; Charge-offs during the current period; Current balance.
125
Mini mode
Minimize
button switches the programs main window to mini mode and back. In this
mode the window is sized down to contain the left menu alone. Lists of content items are shown directly inside the menu, and playback is started by single click. Menu items that can not be shown in this mode (Market), when selected, cause switch back to normal mode.
Playback window
Playback window is intended for video content playback.
The control panel located in the bottom part of the window provides the following functions:
Back
(to the left of the position bar), depending on the current state, may slow down the forward wind, switch to rewind, or speed up the rewind. The current state, including speed and direction of playback/rewind, is also shown on the panel. Forward (to the right of the position bar), depending on the current state, may slow down the rewind, switch to the forward wind, or speed up the forward wind. Show menu brings up the main window of the program. Hide panel hides the control panel. Also, the panel hides by itself after 3 seconds of users inactivity. To open the panel, either click once anywhere in the playback window, or hover mouse through the windows bottom area. Fullscreen toggles the fullscreen mode. Double-clicking anywhere in the playback window has the same effect. Stop stops the playback. Play starts or resumes the playback. Pause pauses the playback.
126
PC Client
switches to the previous content item in the playlist or in the content list, depending on the window from which the content has been selected. Next switches to the next content item in the playlist or in the content list. Sound toggles the mute mode. Size may be dragged to resize the window arbitrarily. It also has the context menu with a variety of predefined standard window sizes.
Prev.
127
128
SYSTEM MAINTENANCE
Backup copies
12
Automatic backup copies are created daily. Besides, a backup may be created at any time via web interface (see Backup on page 84). To roll forward an older backup copy, first create a current backup, and then stop all IPTV Complex systems. Backup tables should be rolled forward manually one by one via the SQL client. Changed config files should be copied over the current ones. Extreme caution must be taken, since wrong action sequence may lead to loss of data. To set up daily automatic download of the backup files, set up the download program (for example, wget) to get the data from the URL containing the authentication data: http://login:password@10.1.0.251/admin/?module=backup& file=backup_auto.tar.bz2
STB diagnostics
The STB client has an event log which is kept in the RAM and flushed on reboot. To view the full log, connect to the STB by telnet and type logread. To view just the new events as they are coming, execute logread -f. The logread -f command is not available on Amino AmiNET 110 STBs.
129
When wired to a PC via direct cable connection, the STB may be controlled with a terminal program. The system must have virtual COM port driver installed. The connection parameters are:
Speed (bit/s) Data bits Parity Stop bits 115200 8 None 1
Reboot the STB with the cable connected. After some booting messages, the following prompt will appear: Hit ENTER to stop normal operation ... I> To display the list of available commands, type help: I>help Amino Communications IntActOS-32 v1.44 on AMINET11x with 32Mb RAM Processor: 51510950 running at 252.000 MHz bootos,cache,configure,go,help,time,rem,reset,show,sprog testled
130
System maintenance
change,copy,delete,details,device,dir,format, fs,load,makefs,rename,run,save,type,verify mputgif,setavc mboot To display the list of parameters, type show all: I>show all Locked : 00 BoxID : 701608F017310 BoardRev : 2 VideoMode : 1 OutFormat : 0 RFChan : 166 RFMode : 2 RFFreqTbl : 0 CAID : F0F0F0F0 NDSSoftwareVersion : 00000000 NDSDriverVersion : 00 ManufacturerID : 1D STBModelType : 01 HardwareVersion : 01 MACaddress : 00:02:02:1C:DB:7B Ethernet : 0 UseDHCP : Y IPaddress : 0.0.0.0 Gateway : 0.0.0.0 Netmask : 0.0.0.0 TimeServer : 0.0.0.0 DNS : 0.0.0.0 McastAdr : 0.0.0.0 McastPort : 0 The typical command sequence for restoration of STB is described below. 1. Set up the IP address and port from which the modern firmware is to be downloaded: I>configure McastAdr 225.50.50.50 I>configure McastPort 11111 I>
131
Bytes used = 0000A000 Bytes spare = 01FF6000 Bytes total = 02000000 3. Reboot the STB: I>reset During startup the STB will communicate to the address just set in order to download the modern version of firmware. In case if the STBs public key for update files verification is modified by the vendor, request the corresponding private key from the vendor and the non-signed firmware build from NetUP, sign the firmware and upload it to the STB via one of the aforementioned ways. In case if the STB itself is modified by the vendor so that the direct cable connection is impossible, ask the vendor for further instructions.
2 3 4 5 6
132
System maintenance
Major number Error type 7 8 9 Reserved for future use. Crypto failure. STB keeps flashing code in endless loop. Hardware failure. STB keeps flashing code in endless loop.
1 1 1 2 2 2 2 2 2 2 3 3 3 3 3 3 3 4 4
1 2 3 1 2 3 4 5 6 7 1 2 3 4 5 6 7 1 2
No network connection DHCP lookup failure I2C communication failed TFTP download failure BOOTP server not found Multicast group not found Multicast download timeout Product file missing from running software bin/products file missing from downloaded software upgrade bin/products file doesn't match STB product (upgrade not suitable for this STB product/platform type) Verification of the download image failed Signature check of the listfile.sig failed
Deletes the image if saved in the flash. Tries 3 times, reboots if unsuccessful Deletes the image if saved in the flash. Tries 3 times, reboots if unsuccessful Erases the flash and reboots Erases the flash and reboots Erases the flash and reboots Erases the flash and reboots Reboots Deletes the image if saved in the flash. Tries 3 times, reboots if unsuccessful Deletes the image if saved in the Flash. Tries 3 times, reboots if unsuccessful
listfile.sig is missing Missing file in the NAND flash according to listfile.sig File check failed against listfile.sig File found on the NAND flash not in listfile.sig Unable to decode the customer public key on the box Verification of the download image failed Signature check of the listfile.sig failed
133
4 4 4 4 4 4 4 4 5 5 5 5 5 5 5 5 8 8 8 8 8 8 9 9 9 9
3 4 5 6 7 8 9 10 1 2 3 4 5 6 7 8 1 2 3 4 5 6 1 2 3 4
Set DI failed STBremoteconf key not found STBremoteconf key failed to verify MD5 sum failure
Number of entries in the listfile does not Rejects image match with what was downloaded No DI file found NAND flash corruption Reboots Reformats the NAND flash
PID mismatch when upgrading the ROM Reboots Failed to remove files on upgrade Failed to set execute / start address in NAND flash Kernel panic / no root FS Invalid type of GIF file saved on the NAND flash Failed to write files onto the NAND flash Failed to gunzip the boot ROM image No master key found No customer key found Signature check of customer key failed (reserved) (reserved) Verify of IntactOS code failed Page write to ROM failed NAND flash hardware / format failure SDRAM access failure Communication to the Ethernet chip failed Reboots Clears the NAND flash Clears the NAND flash and if unsuccessful, STB reboots Deletes the file splash.gif Clears the NAND flash Rejects image and reboots Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop Keeps flashing code in endless loop
134
System maintenance
Setting up Amino remote control
On Aminos AmiNET remote controls with factory default settings, the Vol+, Vol-, and Mute buttons would not work at all in the STB regime. However, some tuning described below may be applied to render them operational. With the remote control type 1 (white) perform the following sequence for each of the buttons Vol+, Vol-, and Mute: 1. Press TV and STB buttons simultaneously and hold until they both flash steadily (approx. 2 seconds). Steps 2 to 6 must be performed without delay, i.e. before that TV and STB buttons fade out automatically. 2. Press STB. 3. Press the button in question (one of Vol+, Vol-, and Mute). 4. Press STB again. 5. Press again the button in question (same as in step 3). 6. Press TV and STB buttons simultaneously and hold until they both fade out (approx. 2 seconds).
Figure 136. Amino remote control type 1.
In case of the remote control type 2 (black), the procedure is different and generally easier, if somewhat esoteric. Perform the following sequence once: 1. Press STB button and hold (approx. 2 seconds) until it flashes twice. 2. Press the following number keys in order: 9, 9, 3. 3. Press again STB button and hold until it flashes twice.
To configure similar functionality on the remote controls of other varieties, contact the manufacturer.
135
136
Phone: Fax:
Address: Russia, Moscow, Ulofa Palme str. 1, sect. 7 Post: E-mail: Web: 119311, Russia, Moscow, P.O. Box #87 info@netup.tv http://netup.tv
Current version of this document is distributed together with the NetUPs IPTV Complex and is accessible via its web interface, see Documentation on page 75. NetUP Inc. All rights reserved.
December 17, 2010