You are on page 1of 140

NetUP IPTV Complex

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

NetUP IPTV IPTV Complex. Administrators Guide


5 Usage examples - - - - - - - - - - - - - - - - - - - - - 45 Installing the UCC - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 45 Creating TV or TVoD content - - - - - - - - - - - - - - - - - - - - - - - - - 47 Setting up telecasts program schedule - - - - - - - - - - - - - - - - - - - - 49 Creating a media stream - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 49 Setting up stream encryption - - - - - - - - - - - - - - - - - - - - - - - - - - 50 Setting up stream recording - - - - - - - - - - - - - - - - - - - - - - - - - - - 51 Creating VoD or nVoD content - - - - - - - - - - - - - - - - - - - - - - - - 52 Converting content to MPEG-TS - - - - - - - - - - - - - - - - - - - - - - - 53 Setting up nVoD program schedule- - - - - - - - - - - - - - - - - - - - - - 54 Creating a media group - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 55 Creating a user- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 56 Creating a personal account - - - - - - - - - - - - - - - - - - - - - - - - - - - 59 Creating a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 59 Editing a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 60 Creating an additional service - - - - - - - - - - - - - - - - - - - - - - - - - 61 Adding content to a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - 62 Adding content groups to a tariff plan - - - - - - - - - - - - - - - - - - - - 63 Adding services to a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - 64 Adding bonuses to a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - 64 Attaching a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 64 Changing a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 65 Adding new currency - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 66 Generating activation code - - - - - - - - - - - - - - - - - - - - - - - - - - - 67 Resetting activation requests counter- - - - - - - - - - - - - - - - - - - - - 68 Making payment - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 69 Adding new network interface - - - - - - - - - - - - - - - - - - - - - - - - - 70 6 LCD panel - - - - - - - - - - - - - - - - - - - - - - - - 71 Statistics screen - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 71 Network interfaces setup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 71 7 Web interface - - - - - - - - - - - - - - - - - - - - - - 73 Starting web interface - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 73 Date and time - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 74 Management - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 74

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

NetUP IPTV IPTV Complex. Administrators Guide


10 STB Client Hotel Edition - - - - - - - - - - - - - - - - -113 Preparations - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 113 Startup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 114 Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 116 Multimedia - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 117 Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 118 Services - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 120 11 PC Client - - - - - - - - - - - - - - - - - - - - - - - - -123 TV- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 124 VoD- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 124 Radio - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 125 Market - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 125 Playlists - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 125 Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 125 Mini mode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 126 Playback window - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 126 12 System maintenance - - - - - - - - - - - - - - - - - - -129 Backup copies - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 129 STB diagnostics- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 129 Amino STB troubleshooting - - - - - - - - - - - - - - - - - - - - - - - - - 129 Setting up Amino remote control - - - - - - - - - - - - - - - - - - - - - - 135

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;

Inline code pieces and commands; Code blocks;

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.

NetUP IPTV IPTV Complex. Administrators Guide


List of terms
Below is a list of terms used in the description of IPTV system.

Networ ki ng
DNS is Domain Name Service, a distributed hierarchical system that stores IP addresses, do-

main names and various information associated with them.


TCP/IP is Transmission Control Protocol / Internet Protocol, a stack of communication pro

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

transmission over a coaxial cable.


Receiver is a device that receives a converted satellite signal and transforms it into a form us-

able for the consumer.


DiSEqC is Digital Satellite Equipment Control, a special communication protocol for use be

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

luminance and color signals separately.


PAL is a color-encoding system for analog TV accepted in Europe. SECAM is a color-encoding system for analog TV accepted in France, Russia and some other

countries.
NTSC is a color-encoding system for analog TV accepted in USA.

NetUP IPTV IPTV Complex. Administrators Guide


IPTV
Streamer is a device that receives an on-air or other signal and transmits it over an IP net-

work. Particular varieties include DVB-to-IP gateway and MPEG encoder.


Middleware is a set of software that controls the interaction between the components of an

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.

IPTV Complex Overview


NetUPs IPTV Complex is a complete headend solution incorporating the following services: Satellite, terrestrial and cable TV channels (streaming); Video on Demand (VoD); Virtual Cinema (nVoD, near Video on Demand); Network Personal Video Recorder (nPVR); Time Shifted TV; Middleware & interactive user interface for IP set-top boxes.

NetUP IPTV IPTV Complex. Administrators Guide

open content multicast Server part

Streamers

EP G

CAS Billing

Load balancer

Middleware

encrypted content + keys multicast

VoD servers

TVoD servers

unicast

unicast

End users STB STB STB

RTSP MPEG-TS NXT NBT

Figure 1. IPTV components and processes overview.

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

open content multicast

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).

Figure 2. NetUP's IPTV Combine 4x.

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

NetUP IPTV IPTV Complex. Administrators Guide


1U server, 4 transponders, decoding supported; 4U server, 6 transponders, decoding supported (deprecated option); 4U server, 12 transponders, FTA channels only (deprecated option). Dedicated VoD or TVoD server includes four hard drives of 750 GB each (see Video on Demand on page 13 for more detail).

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.

Conditional Access System


NetUP's Conditional Access System (CAS) encrypts multimedia streams for transmission over unprotected channels. Only authorized users subscribed to the service can play these streams. CAS allows an IPTV service provider to strictly control access to the content and build financial relations with subscribers and content providers alike. NetUP's Conditional Access System consists of two parts: the server and the client module. The client module is loaded into IP set-top boxes and deciphers the streams using the dedicated onboard hardware decoder. Encryption keys are periodically updated from the server. The Amino AmiNET 125 STB does not support content decryption.

12

System Components
The server encrypts and controls IP streams, creates encryption keys and manages subscriptions.

Figure 3. NetUP's CAS scheme.

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.

Figure 4. NetUP's VOD servers.

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

NetUP IPTV IPTV Complex. Administrators Guide


Movies are stored in MPEG-2 or MPEG-4 AVC transport stream. Both SD and HD are supported. Video content can be loaded via ftp. Movie descriptions displayed in the Middleware user interface can be synchronized with a central database on the Internet (Media Knowledge Base, www.media-kb.com). The database contains the full and structured information on multimedia content, is multilingual and freely accessible. The server is implemented in a 1U rack-mount case. It is possible to connect VoD servers into a cluster. This allows our customers to achieve almost any performance and provide VoD in distributed networks. The VoD server is capable of encrypting the streaming content on the fly in a manner similar to that of CAS. Time Shifted TV, Network Personal Video Recorder, and TV on Demand are implemented as a separate server based on the same framework. For more info on VoD system interface, see nVoD system on page 38.

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

NetUP IPTV IPTV Complex. Administrators Guide

16

BASIC OBJECTS AND PROCESSES


This chapter describes the basic system objects and interactions thereof.

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

NetUP IPTV IPTV Complex. Administrators Guide


Content access
TV, TVoD, VoD, NVoD, and Radio services provide access to some media content. The access is granted once the customer is charged for the service, and is valid during the time span for which the customer has been charged.

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).

Char ge-off details


One-time services get the customer charged upon attachment. Similarly, bonuses are deposited to the clients account upon attachment. As for the TV, TVoD, VoD, NVoD, Radio, and contentfree periodic services, the charging details are determined by their properties (see Tariffication type). In case of TV services the tariffication type is defined explicitly upon creation. For TVoD and Radio with automatic attachment, charging is made in a Periodic prepaid manner. In fact, in the cases described above the actual bonus payment or service charge-off is not made at the precise moment of service attachment or at the end of period, but on the next general tariffication event after that. The said event repeats every hour.
VoD and NVoD services not attached by default are sold for a fixed time span (see STB Client Interface: Viewing VoD on page 105) and charged for in a Full prepaid manner. The actual

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

Basic objects and processes


S er vi ce cos t
Periodic service cost is calculated as a product of its price and the duration of the time span for which the service has been provided. If the service price (see Service price on page 17) is defined per day, then the charges for the time spans expressed in months (for example, the monthly charge of Periodic prepaid type), are calculated considering the actual number of days in the given month. Consequently, the invoices for such a service may vary slightly from month to month. If the service price is defined per month, it is recalculated in a similar way considering the number of days in the month in case of charges for the periods expressed in days, which are: daily charge of Daily prepaid type; payment till the end of current month upon attachment of a service of Periodic prepaid type; payment till the end of current month and from the start of the last incomplete month till the end of term for a service of Full prepaid type.

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

NetUP IPTV IPTV Complex. Administrators Guide


Personal accounts
Each client may have one or more personal accounts. An account may be linked to a tariff plan and probably to some separate additional services. An account may be blocked. Blocking type may be either Manual or Overdraft, depending on whether the blocking has been made manually by the administrator, or automatically by the system due to overdraft. Manual blocking may be lifted manually as well. Automatic blocking persists until terminated by the system, which happens once the account balance becomes positive again. When an account is blocked, so are the attached services with Blockable option set. Technically, the charges for these services are still applied, but then rebated. The rebate for the past portion of the accounting period is initiated by every manual deblocking, payment, or the end of the period.

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

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

NetUP IPTV IPTV Complex. Administrators Guide


Left pane
Left pane of any interface provide quick links to main pages of this interface grouped by the sort of entities they deal with. Some pages are redundantly included in several interfaces (for example, Media content is included in Middleware and in Billing interface as well).

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

United control center


Middleware system
The Middleware system contain interfaces to the following entities: Media groups (with add/remove access); Media content (with add/modify/remove access); Media streams (with add/modify/remove access);

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.

Figure 5. Media groups tab.

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

buttons for operations with media groups are available. Ed-

iting of groups is performed directly on the same page.

23

NetUP IPTV IPTV Complex. Administrators Guide


The attribution of content to either group can be performed via the Billing interface (see Billing system: Media content on page 37). Creation of an example media group and dealing with

it are described in Creating a media group on page 55.

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.

Figure 6. Media contents tab.

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

United control center


Image URL; Duration; Language; Sound.

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

tains interface for entering the parameters of a new content unit.

Figure 7. New media content tab.

Edit media content (opens on pressing Edit

button on the Media contents page) contains

interface for editing the parameters related to the selected item of content.

25

NetUP IPTV IPTV Complex. Administrators Guide


Program schedule (opens on pressing Telecasts schedule button on the Media contents page) contains interface for entering the telecasts schedule for the selected item of TV content.

Figure 8. Program schedule tab.

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.

Medi a s tre ams


Media stream is a record about a certain IP address or a pool of addresses from which a streamer is broadcasting content into an IP network. Normally it has to be associated with some media content. The interface consists of the following pages:

26

United control center


Media streams displays the list of existing media streams together with their parameters.

Figure 9. Media streams tab.

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

NetUP IPTV IPTV Complex. Administrators Guide


Media stream program (opens on pressing Edit button on the Media streams page) con-

tains interface for viewing the properties of a media stream and selecting the media content associated with it.

Figure 10. Media stream program tab.

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

United control center


Customers page displays the list of existing clients together with their parameters.

Figure 11. Customers tab.

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

, Make payment, Personal account management, and Personal account in-

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

NetUP IPTV IPTV Complex. Administrators Guide


Add user (opens on pressing Add button on the Customers page) contains interface for

entering the parameters of a new customer, namely:

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

for editing personal information of the selected customer.

30

United control center


New payment (opens on pressing Make payment button on the Customers page) contains interface for making a payment to the selected clients account.

Figure 13. New payment page.

31

NetUP IPTV IPTV Complex. Administrators Guide


Personal account management (opens on pressing the button of the same name or via the context menu on the Customers page) contains interface for creating and closing personal accounts, as well as for assigning tariff plans and additional services to the selected customer.

Figure 14. Personal account management tab.

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

United control center


vice with its Hardware management option switched on, the hardware management script(s) will be run on particular events, such as addition or blocking of the service.

Figure 15. Customer equipment page.

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

NetUP IPTV IPTV Complex. Administrators Guide


Tariff plans page displays the list of existing tariff plans together with their parameters, including:

Figure 16. Tariff plans tab. ID; Name; State.

The Add able.

, Edit

, and Remove

buttons for operations with tariff plans are avail-

A tariff plan may be removed only if it is not used by anyone.

34

United control center


New tariff plan (opens on pressing Add button on the Tariff plans page) contains inter-

face for entering the parameters of a new tariff plan, including the list of services and their respective prices.

Figure 17. New tariff plan tab.

Edit tariff plan (opens on pressing Edit

button on the Tariff plans page) contains interface

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

NetUP IPTV IPTV Complex. Administrators Guide


Additional se rvices
Additional services displays the lists of existing additional services paid for in installments

or at once.

Figure 18. Instalments tab.

The list of parameters for installments include:


ID; Name; Price; Duration; Cost; State.

The list of parameters for paid-at-once services include:


ID; Name; Price; State.

The Add

and Remove

buttons for operations with additional services are avail-

able. Editing of services is performed directly on the same page.

36

United control center


Media groups
The read-only list of media groups is added to the Billing interface to provide quick access to the information on existing groups and the types of content included in them. Creation of media groups is performed via the Middleware system (see Middleware system: Media groups on page 23), while the attribution of media content to groups is made via Billing (see Media content on page 37).

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.

Figure 19. Media content groups tab.

Including the media content into the group is described in Creating a media group on page 55.

Curr ency rates


The Currency rates page allows to enter the exchange rates for predefined currency pairs to be used in internal calculations.

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.

The interface consists of the following pages:


Access cards page displays the list of existing access cards together with their parameters.

37

NetUP IPTV IPTV Complex. Administrators Guide


The show/hide settings for particular parameters may be tuned via the Columns item in the context menu. The list of parameters include:
Number; Term of validity; Organization; City; E-mail; PIN; Name; Role mask; State.

The Filter or by state.

fold-in group provides the options of filtering by name, by term of validity,

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

United control center


Media content
The read-only list of media content is added to the nVoD interface to have the quick access to the information on existing content. Complete interface to media content belongs to the Middleware system (see Middleware system: Media content on page 24).

Medi a s tre ams


Media stream in VoD context is a record about a certain IP address or a pool of addresses from which nVoD content is transmitted into an IP network. The interface for handling media streams in the nVoD system is similar to that in the Middleware system, see Middleware system: Media streams on page 26.

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.

Figure 20. Virtual cinema tab.

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);

button or double-clicking on the record in the list opens the Schedules

39

NetUP IPTV IPTV Complex. Administrators Guide


First show time when the first show starts; Shows timeshift is the time delay between the two show starts; Shows total is the total number of shows per day; Last show is the starting time of the last show (calculated automatically); State is the state of the show.

The Add record

button adds new records to the list.

Figure 21. Schedules tab.

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

United control center


Play control
The Play control page contains the list of IP addresses appointed for broadcasting. For each address the following information is given: name of the content to be broadcast, its type (VOD or NVOD) and current state (Running or Stopped). The context menu contains a specific item Stop by which the broadcast on the given address may be forcibly interrupted.

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.

Medi a s tre ams


The interface consists of the following pages: Media streams displays the list of existing media streams together with their parameters. The list of parameters include:
ID; Owner; IP; Port; Media Content; Type; Protocol; State; Since; Till.

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

NetUP IPTV IPTV Complex. Administrators Guide


Media stream encryption (opens on pressing Edit , Receiving, Broadcasting, or En-

cryption) contains interface for setting up the media stream encryption, as well as graphical representation of the bitrate.

Figure 22. Media stream encryption tab.

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-

mation on existing groups and the types of content included in them.

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

information on existing media content.

Medi a s tre ams


The interface consists of the following pages: Media streams displays the list of existing media streams similar to that in the Middleware interface (see Middleware system: Media streams on page 26).

42

United control center


The Add , Edit , Remove , Receiving, and Dumping buttons for operations

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:

Figure 23. Media streams dumping tab.

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

NetUP IPTV IPTV Complex. Administrators Guide


Media content; Media stream address; Size of record file(s); Record starting time; Record finishing time. Setting, Info, Control, Statistics contains interface to the selected stream similar to that on

the Media stream dumping page.

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).

Installing the UCC


Before downloading the united control center, you have to upload (see Keystore on page 85) the security.tgz file obtained via the personal cabinet. To install the united control center: 1. Upload the UCC installer iptv-ucc-install.jar to the administrators workstation (i.e. the computer which will be used to control NetUPs IPTV Complex). Installer is available for download under the Files group of items in the web interface (see Web interface: Control center on page 75). To install and use the UCC, Java Runtime Environment (JRE) version 6.0 (Java 1.6.x) or above is needed. JRE distributive is available for free at http://java.com. 2. Start the installation by running the iptv-ucc-install.jar in one of the two ways:
double-click on the file,

or
in the folder containing the file, execute

java -jar iptv-ucc-install.jar

45

NetUP IPTV IPTV Complex. Administrators Guide


Language of the UCC installer, as well as that of the UCC itself, is set according to the current system locale. 3. Select the directory to install the UCC to. When installing over the previous version (that is, into the same directory), you may also want to check the Copy settings option. On Windows systems the installation path must be selected so as not to contain any non-ASCII characters. 4. Press Install to install the UCC to the selected location.

Figure 24. UCC installation window.

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).

Creating TV or TVoD content


To control the users access to TV channels broadcast by the streamer, a corresponding TV content must be created in the NetUPs IPTV Complex. Below is a model pattern of creating a TV content, which may be customized to meet particular circumstances. 1. Start the Middleware system interface from the UCC (see Middleware system: Media content on page 24 for interface description). 2. On the left pane open the Media group and select Media contents. The Media contents tab with a list of existing contents will appear. Context menu of any table contains the Columns item via which the user may hide or reveal any column individually.

47

NetUP IPTV IPTV Complex. Administrators Guide


3. Press Add appear. . The New media content tab will

4. Specify the following parameters of the media content being created:


Field name Staff name State Type Code Value Leave default: iptv-middleware Active TV

Figure 26. TV media content creation.

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)

Name Description (Optional) Genre (Optional) Image (Optional)

5. Press Apply

. New TV content will show up in the list.

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.

. The Edit media

Figure 27. Editing media stream.

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.

Setting up telecasts program schedule


There is an optional possibility to create the schedule of telecasts (or to edit one, should it be distributed by a properly configured streamer see Adapter configuration window: Send EPG to the middleware on page 78). To do this: 1. Open the Media content tab of Middleware system interface. 2. Press the Telecasts schedule button. The Program schedule tab will show up. 3. Enter the schedule line by line, with Since, Duration, and Title for each item. 4. Press Apply to save the program schedule.

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.

Creating a media stream


Media stream is an audio and/or video stream, either open or encrypted, going to the IP network. On the transport level, it is a MPEG-2 Transport Stream. To create a media stream: 1. From the UCC start the system interface Middleware (if you intend to create streams for TV) or nVoD (to create streams for nVoD). 2. On the left pane open Media and select Media streams. The Media streams tab with a list of existing media streams will appear. 3. In the filter pane above the list press TV streams you intend to create. or NVOD , depending on the type of

49

NetUP IPTV IPTV Complex. Administrators Guide


4. If creating a stream for TV: 4.1. Press Add to add new stream to the list.

4.2. In the Media content column use the dropdown list for selection of the content to be broadcast in this stream.

Figure 28. TV media stream creation.

5. If creating a stream for VoD: 5.1. Press Add 5.3. Press Add.
Figure 29. Stream pool creation.

. The stream pool creation window will show up.

5.2. Enter the IP address and port for the pool being created.

6. Press Apply

. New media stream or a pool will be created.

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).

Setting up stream encryption


1. Start the DRM system interface from the UCC (see DRM system on page 41 for interface description). 2. On the left pane open the Media group and select Media streams. The Media streams tab with a list of existing streams will appear. 3. Select the stream just created and press Edit The Media stream encryption tab will show up. 4. Select the proper input and output interfaces from the dropdown lists (if some interfaces are missing, add them as described in Adding new network interface on page 70) and press Receiving. As the channel starts receiving, the Broadcasting button turns active. Incoming and outgoing interfaces can not coincide. 5. Press Broadcasting. As the channel starts broadcasting, the Encryption button turns active and the chart below starts to display the media stream bitrate. or Receiving, or just double-click on it.

Figure 30. Media stream encryption.

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).

Setting up stream recording


To control the users access to the recorded TV content for past dates, the TV content in question must be recorded. Below is a model pattern of setting up the recording. 1. Start the TVoD system interface from the UCC (see TVoD system on page 42 for interface description). 2. On the left pane open the Media group and select Media streams. The Media streams tab will appear with a list of existing media streams connected to some media content of TV type. 3. Select the channel which you intend to record and press Receiving. The Media stream dumping tab will show up.

Figure 31. Media streams dumping.

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

NetUP IPTV IPTV Complex. Administrators Guide


Creating VoD or nVoD content
To control the users access to the content stored on the VoD or nVoD server, a corresponding VoD content must be created in the NetUPs IPTV Complex. Below is a model pattern of creating a VoD content, which may be customized to meet particular circumstances. 1. Start the Middleware system interface from the UCC (see Middleware system: Media content on page 24 for interface description). 2. On the left pane open the Media group and select Media contents. The Media contents tab with a list of existing content will appear. 3. Press Add appear. . The New media content tab will

Figure 32. VoD media content creation.

4. Specify the following parameters of the media content being created:


Field name Staff name State Type Code Name Description (Optional) Genre (Optional) Image (Optional) Value Leave default: iptv-middleware Active VOD Leave default (assigned automatically) Name of the new content Annotation for displaying in the client STB interface (see STB Client Interface: Viewing VoD on page 105) Genres of the media content (a list with an option of multiple choice) Image related to the new VoD content

5. Press Apply

. New VoD content will show up in the list.

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.

Converting content to MPEG-TS


1. Install the VLC media player (available for free at http://www.videolan.org/vlc/) and start it.

Figure 33. VLC player.

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.

Figure 34. Content selection in VLC.

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

NetUP IPTV IPTV Complex. Administrators Guide


Uncheck Keep original video track. Select MPEG-2 codec. Set desired Bitrate. Set actual Frame Rate (commonly 25).

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

Setting up nVoD program schedule


The nVoD service implies that a content is transmitted at regular time intervals according to the schedule. Below is a model pattern of setting up the nVoD program schedule, which may be customized to meet particular cricumstances. 1. Start the nVoD system interface from the UCC (see nVoD system on page 38 for interface description). 2. On the left pane open the Media group and select Virtual cinema to open the tab of the same name. 3. If necessary, scroll to other date by pressing and . .

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.

Figure 36. Setting broadcast schedule.

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).

Creating a media group


Media group is intended to group together items of media content in order to effectively improve group operations with them. For example, in the Billing system you may set similar price for all media content items in one group. Below is a model pattern of creating a group, which may be customized to meet particular circumstances. 1. Start the Middleware system interface from the UCC. 2. On the left pane open Media and select Media groups. The Media groups tab with a list of existing groups will appear. 3. On the free lower line of the list, under Name type the new groups name. 4. Under Type, select the type of the new group (TV, VOD, etc.) from the dropdown list:

Figure 37. Media groups creation.

Content with type VOD may be put into groups of both VOD and NVOD types.

5. Press Apply

. The new media group will be created.

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

NetUP IPTV IPTV Complex. Administrators Guide


8. In the media content list, right-click on the content to be added to the new group. In the appearing context menu select Edit groups.

Figure 38. Context menu of the media content tab.

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.

Figure 41. Customers personal information.

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.

8. Press Apply changes.

to save the

9. Close the Add user tab.

57

NetUP IPTV IPTV Complex. Administrators Guide


10. If the user must be associated with some automatically managed hardware: 10.1.Right-click the user in question in the list of users and select Customer equipment from the context menu. The Customer equipment page will show up.

Figure 43. Customer equipment addition.

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.

Figure 44. Access card information pane.

The most likely following action with the newly personal account is described in the example
Attaching a tariff plan on page 64.

Creating a tariff plan


Below is a model pattern of creating a new tariff plan, which may be customized to meet particular circumstances. 1. Start the Billing system interface from the UCC (see Billing system on page 28 for interface description). 2. On the left pane open Tariffication and select Tariff plans. The Tariff plans tab will show up. 3. Add pear. 4. Enter the tariff plan name. 5. In the Roles field select one or several roles from the dropdown list.
Figure 45. Creating tariff plan.

new tariff plan. The New tariff plan tab will ap-

59

NetUP IPTV IPTV Complex. Administrators Guide


6. Add to the plan 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), additional services (see Adding services to a tariff plan on page 64) and/or bonuses (see Adding bonuses to a tariff plan on page 64), according to your choice. It is recommended to add TV, VoD and nVoD content via groups. 7. Press Apply to finalize the addition of services.

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.

Editing a tariff plan


Below is a model pattern of editing a tariff plan. 1. Start the Billing system interface from the UCC. 2. On the left pane open Tariffication and select Tariff plans. The Tariff plans tab will show up. 3. Select the plan you intend to alter and press Edit . The Edit tariff plan tab will appear.

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).

Figure 46. Editing tariff plan.

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.

Creating an additional service


In addition to services that provide an access to some TV or VoD content for certain period of time, you may want to create additional services which has to be paid for either at once or in instalments. Below is a model pattern of creating a new additional service, which may be customized to meet particular circumstances. 1. Start the Billing system interface from the UCC.

61

NetUP IPTV IPTV Complex. Administrators Guide


2. On the left pane open Tariffication and select Instalments. The Instalments tab will show up. 3. To create an additional service paid for by instalments: 3.1. Press Add below the Instalments list.

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.

Adding content to a tariff plan


To add content items one-by-one (i.e. if the media content is not gathered into groups):

Figure 47. Adding services.

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.

5. Fill the columns:


Column Description

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).

Blockable State Tariffication type

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.

Adding content groups to a tariff plan


If the content is gathered into groups (see Creating a media group on page 55) you may add groups to the tariff plan as follows: 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. Unfold VoD Tariff templates or an analog with other content type. 5. Press Add to add a line into the table.

6. Fill up the columns:


Column Media group Price Description Media content to be included in the plan. Price of the service

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

NetUP IPTV IPTV Complex. Administrators Guide


Adding services to a tariff plan
To include additional services to a tariff plan: 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 One-time services or Periodic services. 4. Press Add in this group.

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.

Adding bonuses to a tariff plan


To include bonuses to a tariff plan: 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 Accruals group. 4. Press Add to add new bonus.

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).

Attaching a tariff plan


Below is a model pattern of attaching a tariff plan to a user, which may be customized to meet particular circumstances. 1. Start the Billing system interface from the UCC.

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.)

Figure 48. Tariff plan selection.

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.

Changing a tariff plan


Below is a model pattern of changing a tariff plan attached to a user, which may be customized to meet particular circumstances. 1. Start the Billing system interface from the UCC.

65

NetUP IPTV IPTV Complex. Administrators Guide


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 assign the tariff plan and press Personal account management button (or a similar context menu item). The Personal account management tab will appear. 4. Select the active account. 5. In the Activated tariff plans list select the currently enabled plan and press Disable .
Figure 49. Disabling a tariff plan.

6. Press Apply

to save the changes.

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.

Adding new currency


UCC may perform accounting operations in any existing currency, but only a few are visible by default. To alter the list of currencies: 1. Start the Billing system interface from the UCC.

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.

Figure 50. Plugins properties window of Billing interface.

3. Select the word currencies row and press Edit pear.

. The Editing Property window will ap-

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.

Generating activation code


When using the access card for the first time, the user must enter the activation code obtained from the IPTV provider. Normally the activation code for an account may be read on the Personal accounts management page after the creation of the said account (see Creating a personal account on page 59). In case if an additional code is required, it may be created as follows. 1. Start the Billing system interface from the UCC. 2. On the left pane open the Security group and select Activation codes. The Activation codes tab will show up. 3. Press Add in order to add a new line to the list of activation codes.

67

NetUP IPTV IPTV Complex. Administrators Guide


4. In the newly created line under the Access card number enter the number of access card which needs to be activated.

Figure 51. Activation code generation.

5. Press Apply

to generate and save the activation code.

6. Copy the code to hand it over to the customer.

Resetting activation requests counter


If an STB activation request has been sent from one single IP for as many as 10 times (this may be caused, for example, by repeated erroneous input), the following activation request from the same IP may be rejected. In this case reset the counter as described below. 1. Start the Billing system interface from the UCC. 2. On the left pane open the Security group and select Activation requests. The Activation requests tab will show up. 3. Find the entry in question either by IP address or by the fact that its Counter has reached Limit.

68

Usage examples
4. Set the Counter value to 0.

Figure 52. Activation requests page.

5. Press Apply

to save the refreshed counter value.

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.

Figure 53. Making 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

NetUP IPTV IPTV Complex. Administrators Guide


Adding new network interface
To use a network interface not recognized by the system by default (probably, a virtual one created via the web interface, see Network: VLAN window on page 86): 1. From the top menu of the system interface you are using (probably, DRM or TVoD), select Plug-ins, then Edit properties for plug-ins. The Properties for plug-ins window will appear.

Figure 54. Plugins properties window.

2. Select the string available_interfaces row and press Edit dow will appear.

. The Editing Property win-

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.

Figure 55. LAN monitor.

Figure 56. CPU usage monitor.

Network interfaces setup


The LCD panel contains interface for setting up network parameters, i.e. IP address and subnet mask. To do that, press Fn, then Enter on any statistics screen. The network configuration screen will appear. By pressing Up and Down select the network interface to be set up.

Figure 57. Network configuration.

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.

Figure 58. IP address setup.

71

NetUP IPTV IPTV Complex. Administrators Guide


When you are done with the IP address, press Enter. Then you will be prompted to enter the subnet

mask. It is entered by pressing Up or Down, which increases or decreases the number of bits in the mask determining the subnet address.

Figure 59. Subnet mask setup.

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;

3. IPTV group (present only on streamers)


DVB (page 75) containing the DVB adapter settings; EPG (page 80) for importing EPG; VoD (page 81) containing VoD content management;

4. Set Top Boxes group (present only on Middleware servers)


Firmware update (page 81) containing upgrades of IP STB devices firmware; STB management (page 82) for manual adjustment of STBs; Styles (page 83) to control IP STB client user style; Translations (page 84) to control IP STB interface language;

5. System administration group


Backup (page 84) containing system backup interface; Power Management (page 84) for reboot and shutdown; Update (page 84) for IPTV Complex firmware upgrade;

6. System configuration group

73

NetUP IPTV IPTV Complex. Administrators Guide


Keystore (page 85) for uploading the keystore file; Network (page 85) for network interfaces settings; Security (page 87) for password management; Services (page 88) for manual start and stop of services; Tunneling & IGMP (page 88) for manual start and stop of tunneling and multicast routing;

7. System status group


About (page 88) showing version information; Connections (page 89) showing connections between system components; Storage (page 89) displaying disk space usage.

Date and time


Date and time page contains the interface for setting the time zone. In the External time servers section one may add or remove the NTP servers to synchronize with. New items get added to the end of the list. The Status column lists the current status of the servers:
Failed if the last sync attempt Figure 61. Date and time page.

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.

Adapter is the number of the adapter in the system, starting from 0.

75

NetUP IPTV IPTV Complex. Administrators Guide


Adapters and CAM slots on the backplate of the actual NetUP streamer are numbered bottom-to-top, as shown below.

Figure 65. Adapter and CAM slot numbers.

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)

to set up basic adapter parameters;


Channels tune channels (see Channels window on page 79); Start service if it is not running; Stop service if it is running.

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.

Figure 66. Basic adapter parameters settings.

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

NetUP IPTV IPTV Complex. Administrators Guide


* DVB-S2; * DVB-T; * DVB-C;
Polarisation is the polarization type; EPG character set is the character encoding for channel names and other auxiliary infor-

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

frequency controls. See http://www.netup.tv/en-EN/articles/streamer-configuration-guide.php for more details.

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-

version of a cable signal for transmission via a coaxial cable:


Modulation.

78

Web interface
Channels window
This window lists all channels found by the DVB adapter.

Figure 68. Channels settings.

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

NetUP IPTV IPTV Complex. Administrators Guide


On switching to another adapter (see Adapter configuration window: Frequency on page 77) the channel settings are kept and applied, whenever possible, to the channels found on the new adapter. Settings of the channels having no match on the new adapter are not represented in the list, and are subsequently deleted on next Save. As long as no changes has been made, a rollback to previous adapter without loss of settings is possible. In rare cases the adapter switching may by chance attach the settings of some channel (as set on the former adapter) to an auxiliary channel on the new adapter, which is represented in the list as a channel having neither name nor Audio PID. This, in turn, makes an error message appear on pressing Save, even if no actual change has been made. In such a case it is necessary to erase the channels settings manually by removing its IP address.

EPG
On this page an EPG in XMLTV format may be uploaded from file or from given URL.

Figure 69. EPG page.

Once EPG is imported, the list of channels is revealed so that their internal IDs may be set.

Figure 70. EPG file parsing.

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.

Figure 71. VoD page.

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

and enter the content code in the popup window.

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.

Figure 72. Firmware update page.

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

NetUP IPTV IPTV Complex. Administrators Guide


Configure configures the automatic upgrade service parameters. In case of the Amino

AmiNET STBs, these include:

Figure 73. Firmware update configuration window.

* 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.

Figure 74. STB management page.

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,

with options: SD, HD720, and HD1080);


Reboot STB; Upgrade (file system only); Reflash (erases all stored parameters, STB reactivation needed).

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-

Figure 75. Styles page.

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

NetUP IPTV IPTV Complex. Administrators Guide


Translations
Translations page lists interface localizations (language packs) for IP STB interface in a manner similar to that of styles on the Styles page, with Add / Compile / Remove options. New language packs may be created as described in Updating user theme on page 91. Once uploaded, the new language pack becomes available for selection via the Languages screen of the STB client interface as described in STB Client Interface: Settings on page 108.

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.

Figure 77. Backup page.

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.

Figure 78. Update page.

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.

Figure 79. Network page.

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

In the web interface eth0

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

NetUP IPTV IPTV Complex. Administrators Guide


Routing table window
Routing table may be edited with Add and Remove buttons.

Figure 80. Routing table.

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.

Figure 81. VLAN window.

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.

Figure 82. Adapter configuration.

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.

DHCP configuration window


This window provides comtrols for setting up DHCP.

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

NetUP IPTV IPTV Complex. Administrators Guide


Services
This page lists existing system components (Middleware, Billing, etc).

Figure 85. Services page.

Status column displays the current status of components (Running / Stopped). Actions lists the possible operations with the given component (Start / Stop).

Tunneling & IGMP


This page provides an interface to the following services: 1. Multicast Router acting as an IGMP querier; 2. Virtual Tunnel a tunneling connection to the server.

Figure 86. Tunneling & IGMP page.

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.

Figure 87. Connections page.

This page is absent on streamers.

Storage
This page summarizes the disk space usage info.

Figure 88. Storage page.

89

NetUP IPTV IPTV Complex. Administrators Guide

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.

Updating user theme


The user theme consists of style part and language part. The former includes images, colors, font definitions, and other parameters of user interface screens. Existing theme may be downloaded from the live system (see Web interface: Styles on page 83 and Translations below) in the form of *.zip archives. Modified themes can be uploaded on the same pages. Note that each user-altered theme is bound to the firmware of particular build, and needs to be updated together with it. The archives for upload must contain only the fixed list of files with predefined case-sensitive names. Themes with altered directory structure would be rejected by the system. Style archive must contains the version for one particular resolution (it is specified on uploading) and may miss some files. Missing files would be substituted with those from the default theme for this resolution. Extra files, if any, would be ignored. Language archive must contain a single file named language.ts. Style archive contains the menu.ini file which describes the menu structure. Complete removal of a portion of this file related to some particular interface screen renders that screen inaccessible to the users. Updated theme files are sent over the network as a UDP multicast stream to the given multicast address. The use of multicast allows to transmit a file to an arbitrary number of clients using just one stream. Client STBs would download the new files automatically after the next reboot.

91

NetUP IPTV IPTV Complex. Administrators Guide


Changing image
To change one of the interface images: 1. Download and unzip style-source.zip. 2. Find the image file you intend to change by browsing through the images in the subfolder of image-set intended for the desired resolution. 3. Replace the file in question with your custom image, which must have similar size in pixels and similar name. 4. (Optional) Remove all unmodified style files. 5. Create a zip archive containing the style folder and download it to the server.

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.

Changing text label


To change one of the text labels: 1. Download and unzip language-source.zip. 2. Find the text label in question in the language file: <message> <location filename="menu_screens/screen_system_ information.ui" line="140"/> <source>MAC address</source> <translation type="unfinished"></translation> </message> 3. Edit the label: <translation>Direccion MAC</translation>

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

NetUP IPTV IPTV Complex. Administrators Guide


On the next stage, match if (option vendor-class-identifier ="Aminoaminet110upgrd") or ((substring( option vendor-encapsulated-options,2,9) ="aminet110") and (substring( option vendor-encapsulated-options,13,5) ="upgrd")); it is directed to another address to download mc2.mcfs: vendor-option-space AMINO; option AMINO.address 225.50.50.51; option AMINO.port 11111; } class "AmiNET110 fisys" { Finally, when the upgrade is over (or if it was not needed from the very beginning), match if (option vendor-class-identifier ="Aminoaminet110fisys") or ((substring( option vendor-encapsulated-options, 2, 9) ="aminet110") and (substring(option vendor-encapsulated-options, 13,5) ="fisys")); the AMINO.address and AMINO.port parameters are not set; instead, the STB is provided with the time zone setting for further work: vendor-option-space AMINO; option AMINO.timezone="MSK-3MSD-4,M3.5.0/2,M10.5.0/2"; }

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

NetUP IPTV IPTV Complex. Administrators Guide


libconfig-set SETTINGS.GFX_RESOLUTION "" Output signal type is set as follows: libconfig-set NORFLASH.OUTFMT <Type> where <Type> may be selected among: CVBS-RGBOFF (for the signal of Composite type) LC-RGBOFF (for S-Video) CVBS-RGBON (for Composite + RGB) CVBS-LC (for Composite + S-Video) Output screen aspect ratio is set as follows: libconfig-get SETTINGS.DISPLAY_MODE <Format> where <Format> may be selected among: "panscan" (4:3 aspect ratio, pan and scan presentation mode); "letterbox" (4:3 aspect ratio, letterbox presentation mode); "widescreen" (16:9 aspect ratio); "ignore" (stretch image to the screen). Password Password required for the telnet access to an STB may be changed with the use of the STBremoteconf utility installed on the Middleware server. The command is to be called as follows: STBremoteconf <IP address of STB> CHANGE-PWORD <username> When executed, this command will prompt you to enter the new password.

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

NetUP IPTV IPTV Complex. Administrators Guide

98

STB CLIENT INTERFACE


Select and view TV channels; Select, order and view movies from VoD servers; Select show time and view movies from the Virtual Cinema servers;

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.

Figure 89. Activation screen.

99

NetUP IPTV IPTV Complex. Administrators Guide


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. Then the style selection screen will show up.

Figure 90. Primary style selection screen.

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.

Figure 91. Primary language selection screen.

100

STB Client Interface


Style and language may be changed afterwards as well (see Settings on page 108). On Amino AmiNET 130 STBs working via HDMI the output resolution may be set up manually, see Manual setup on page 94. After authorization and primary selection of style and language (these steps are skipped 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 108 for setting and unsetting the password), the lock screen will appear first, prompting the user to enter this password for unlocking.

Figure 92. Lock screen.

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

NetUP IPTV IPTV Complex. Administrators Guide

Figure 93. Virtual keyboard.

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.

Figure 95. Status bar (fast forward).

When a TV content is playing, the status bar also contains TV program for the given channel.

Figure 96. Status bar with TV program.

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

STB Client Interface


Viewing TV channels
Available screen lists all channels available according to the users tariff plan (see Creating a tariff plan on page 59) and provides an Add to favorites option. The program guide for the

highlighted channel is shown in the bottom part of the screen.

Figure 97. Available channels screen. Favorite screen lists selected channels with the options of viewing and removing from the fa-

vorites.

Figure 98. Favorite channels screen.

103

NetUP IPTV IPTV Complex. Administrators Guide


Channel starts running after pressing OK. Channel may be selected either with Up and Down buttons of the remote control panel, or by dialing its number in the list with digit keys. Numbers are initially assigned to channels in order of addition, and may later be changed arbitrarily. The EPG screen displays the program of telecasts when available (it may originate from the streamer, see Adapter configuration window: Send EPG to the middleware on page 78, or may be entered manually by the administrator, see Setting up telecasts program schedule on page 49).

Figure 99. TV program screen.

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

STB Client Interface


Viewing VoD
The Available movies screen lists the already ordered movies. To view a movie, select it among the list and press OK. The movie will start reproducing.

Figure 100. Available movies screen.

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.

Figure 101. Order movies by name screen.

Ordering a movie will require a financial password, if it is set (see Settings on page 108).

105

NetUP IPTV IPTV Complex. Administrators Guide


The two remaining screens in this section constitute the virtual cinema interface. On the Order seances screen there is a list of nVoD content included in the users tariff plan (see Creating a tariff plan on page 59).

Figure 102. NVoD ordering screen.

Once ordered, the movies become available in the Available seances screen.

Figure 103. 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

STB Client Interface


Personal account
The interface of account options consists of three screens, namely Information, Replace tariff plan, and Financial report. Information displays the current tariff plan, card validity period, balance, and credit.

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.

Figure 105. Replace tariff plan screen.

107

NetUP IPTV IPTV Complex. Administrators Guide


Financial report displays the financial report, i.e. the history of payments and expences.

Figure 106. Financial report screen.

Settings
The Settings interface consists of the following screens.
Security screen contains the interface for setting, changing, and unsetting various passwords:

Figure 107. Security screen.

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

STB Client Interface


System information screen lists the IP address, subnet mask, MAC address of the STB, IP address of the Middleware server, and the firmware revision number.

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).

Figure 109. Style selection screen.

109

NetUP IPTV IPTV Complex. Administrators Guide


Languages screen contains the list of available language packs for STB interface. See Web interface: Translations on page 84 for uploading user language packs).

Figure 110. Language selection screen.

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.

Figure 111. Scheduler screen.

Alarm clock works even when the STB is in standby mode.

110

STB Client Interface


Internet screen (present only on Amino AmiNET 130) implements basic functionality of a web browser.

Figure 112. Internet screen.

111

NetUP IPTV IPTV Complex. Administrators Guide

112

STB CLIENT HOTEL EDITION

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

NetUP IPTV IPTV Complex. Administrators Guide


Free TV services have their Mandatory option set on, Blockable option set off, and tariffication type set to Periodic prepaid; Paid TV services have their Mandatory option off, Blockable on, and tariffication type set to Full prepaid; All TV services are linked to media groups rather than to individual content items; VD services have their Mandatory option off and Blockable on. Radio services have their Mandatory option on, Blockable off, tariffication type set to Periodic prepaid, and price set to 0; nVD services have their Mandatory option off and Blockable on; One-time, periodic, and TVoD services, as well as bonuses, are not allowed. Setting up the connection with the PMS, as well as other possible preparations, are performed by NetUP upon installation of the system.

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.

Figure 113. Activation screen.

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

STB Client Hotel Edition


On the clients first launch after check-in, the welcome screen will show up.

Figure 114. Welcome screen.

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.

Figure 115. Lock screen.

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

NetUP IPTV IPTV Complex. Administrators Guide


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).

Figure 116. Virtual keyboard.

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

STB Client Hotel Edition


When a VoD content is playing or rewinding, the status bar also displays its present moment and total length.

Figure 118. Status bar (fast forward).

When a TV content is playing, the status bar also contains TV program for the given channel.

Figure 119. Status bar with TV program.

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

NetUP IPTV IPTV Complex. Administrators Guide


Movies screen lists the VoD movies. To view a movie, select it from the list and press OK. Then a movie is either purchased (if not yet), or otherwise starts playing. The description of the highlighted movie is shown in the bottom part of the screen.

Figure 121. Movies screen.

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.

Figure 122. Information screen.

118

STB Client Hotel Edition


System information screen lists the IP address, subnet mask, MAC address of the STB, IP address of the Middleware server, and the firmware revision number.

Figure 123. System information screen. Security screen contains the interface for setting, changing, and unsetting various passwords:

Figure 124. Security screen.

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

NetUP IPTV IPTV Complex. Administrators Guide


Languages screen contains the list of available language packs for STB interface. See Web interface: Translations on page 84 for uploading user language packs).

Figure 125. Languages screen.

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.

Figure 126. Billing screen.

120

STB Client Hotel Edition


Messages screen displays the messages arriving via the hotel internal messaging system.

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.

Figure 128. Scheduler screen.

Alarm clock works even when the STB is in standby mode.


Internet screen (present only on Amino AmiNET 130) implements basic functionality of a web browser.

121

NetUP IPTV IPTV Complex. Administrators Guide


Hotel info displays the general information page.

Figure 129. Hotel info screen.

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.

Figure 130. Room status screen.

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.

Figure 131. Activation window.

123

NetUP IPTV IPTV Complex. Administrators Guide


TV
This tab contains the interface for selecting and viewing TV channels.

Figure 132. List of channels.

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

button refreshes the list of channels. Add to playlist

add the selected chan-

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.

Figure 133. Order confirmation window.

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:

Playback TV on one click; Playback last content on startup.


Finances page contains the summary of financial information, as listed below.

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

NetUP IPTV IPTV Complex. Administrators Guide


Related to the users access card: State; Period of validity. Related to the tariff plan: Current plan; Next plan (may be changed).

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.

Figure 134. Playback window.

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

NetUP IPTV IPTV Complex. Administrators Guide

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.

Amino STB troubleshooting


Debugging cable connection
If both the regular mass update and individual update fail (that is, if due to some firmware fault or other reason the STB does not download newer firmware build, and also neither accepts STBremoteconf commands nor allows remote connection by telnet), the last-ditch effort to revive the STB may be made with the debugging cable. The cable is supplied by the STB manufacturer or vendor. Remove the STBs outer case and attach the connection cable to the slot named below so as to face the square-framed hole with its missing pin.
Amino 110 Amino 125 Amino 130 J7 J4 J7

129

NetUP IPTV IPTV Complex. Administrators Guide

Figure 135. Debugging cable connection.

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

NetUP IPTV IPTV Complex. Administrators Guide


2. Erase all existing files: I>format This will erase all files in device 0 Do you want to continue? (Y/N) Checking Blocks... total size = 02000000 99% Erasing... 99%

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.

STB er ror codes


When a firmware error is detected, the STB would indicate the error code by LED flashing. Each error code consists of two numbers and is represented by two groups of flashes separated by a larger pause. First (i.e. major) number denotes the general type of error, with the possible values summarized in the list below.
Major number Error type 1 Network issue (a connection error, a DHPC failure, etc). After 3 attempts STB will start anyway, but with limited functionality. Requires manual restart once the issue is resolved. Code upgrade failure. STB reboots and tries again. Security / crypto issue (bootloader). STB reboots. Security / crypto issue (filesystem). Depending on the nature of the missing or corrupted file, STB either reboots, or ignores the error and proceeds. Miscellaneous errors. STB reboots. Reserved for future use.

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.

Below is the detailed list of errors.


Major # Minor # Error STB behavior Tries 3 times and proceeds booting Tries 3 times and proceeds booting Tries 3 times and proceeds booting Reboots, !poweron file is not saved Reboots, !poweron file is not saved Tries 3 times, reboots if unsuccessful Tries 3 times, reboots if unsuccessful Uses REFLASH and then reboots Reboots Reboots

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

NetUP IPTV IPTV Complex. Administrators Guide


Major # Minor # Error STB behavior Erases the flash and reboots Deletes the image if saved in the flash. Tries 3 times, reboots if unsuccessful Deletes the code contents of the flash and reboots Ignores command Ignores command Rejects image

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

listfile.sig is missing or corrupted Image DI is less than STB DI

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.

Figure 137. Amino remote control type 2.

135

NetUP IPTV IPTV Complex. Administrators Guide

136

Phone: Fax:

+7 495 510 1025 +7 499 143 5521

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

You might also like