Professional Documents
Culture Documents
Net Up
Net Up
Net Up
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
1
IPTV_Complex_eng.book Page 2 Friday, December 17, 2010 2:43 PM
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
3
IPTV_Complex_eng.book Page 4 Friday, December 17, 2010 2:43 PM
4
IPTV_Complex_eng.book Page 5 Friday, December 17, 2010 2:43 PM
INTRODUCTION 1
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 NetUP’s 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 per-
sonal 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 servic-
es besides just transmitting the video content.
5
IPTV_Complex_eng.book Page 6 Friday, December 17, 2010 2:43 PM
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 address-
es and other auxiliary information in TCP/IP networks.
• IGMP is Internet Group Management Protocol, a network protocol that manages group rout-
ing.
• 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 chan-
nel 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 net-
works.
• 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).
6
IPTV_Complex_eng.book Page 7 Friday, December 17, 2010 2:43 PM
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 fol-
lowing 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.
7
IPTV_Complex_eng.book Page 8 Friday, December 17, 2010 2:43 PM
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 applica-
tions used to build the NetUP’s IPTV Complex.
8
IPTV_Complex_eng.book Page 9 Friday, December 17, 2010 2:43 PM
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 per-
formed 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 con-
tain 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 trans-
action.
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.
9
IPTV_Complex_eng.book Page 10 Friday, December 17, 2010 2:43 PM
open content
Streamers
multicast
Server part
open content
CAS
EP
multicast
Billing
unicast
unicast
End users
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 plat-
form designed to support client-server applications of any complexity.
10
IPTV_Complex_eng.book Page 11 Friday, December 17, 2010 2:43 PM
SYSTEM COMPONENTS 2
Bundling options
NetUP’s IPTV Complex may be supplied in the following configurations:
• IPTV Combine is a 1U server containing Middleware, Billing, VoD, and streamer, and
equipped with an LCD panel.
The corresponding firmware file is named firmware-combine.1.4.xxx, where xxx
stands for the build number.
IPTV Combine hardware configuration may include:
° two transponders, FTA channels only (deprecated option);
° one transponder with decoding support, i.e. having a CAM slot (deprecated option);
° two transponders, decoding supported (deprecated option);
° four transponders, decoding supported (IPTV Combine 4x, see Fig. 2).
The conditional access modules must be put into the slots upside-down, i.e. having the
manufacturer logo on the bottom side.
Note also that a pair of CAM slots is located in a single orifice.
• MW+Billing+VoD (firmware file firmware-complex.1.4.xxx) is a 1U server contain-
ing Middleware, Billing, and VoD.
• MW+Billing (firmware file firmware-mw+billing.1.4.xxx) is a 1U server containing
just Middleware and Billing.
Each of these options may be complemented with an arbitrary number of separate dedicated
streamers, VoD servers, TVoD servers, and DRM servers.
Dedicated streamers may be supplied in the following configurations:
11
IPTV_Complex_eng.book Page 12 Friday, December 17, 2010 2:43 PM
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 encod-
ers built into the server. Received streams are multiplexed into MPEG Transport Stream and dis-
tributed 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 appli-
cable) LCD panel on page 71.
The Amino AmiNET 125 STB does not support content decryption.
12
IPTV_Complex_eng.book Page 13 Friday, December 17, 2010 2:43 PM
System Components
The server encrypts and controls IP streams, creates encryption keys and manages subscrip-
tions.
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 typ-
ical MPEG-2 compression rate of 4 Mb/s per stream. Both unicast and multicast modes are sup-
ported.
Server storage comprises four hot-swap SATA-II hard disks. The total HDD space in the stan-
dard configuration is 3 Tbytes or more than 700 movies in DVD quality. External data storage can
be connected where required.
13
IPTV_Complex_eng.book Page 14 Friday, December 17, 2010 2:43 PM
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
IPTV_Complex_eng.book Page 15 Friday, December 17, 2010 2:43 PM
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 NetUP’s IPTV Complex is designed with the use of native
API, which provides an advantage in performance as compared to the browser-based interfaces.
NetUP’s 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
IPTV_Complex_eng.book Page 16 Friday, December 17, 2010 2:43 PM
16
IPTV_Complex_eng.book Page 17 Friday, December 17, 2010 2:43 PM
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 in-
cluded (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 sys-
tem 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 user’s 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 ser-
vices 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
IPTV_Complex_eng.book Page 18 Friday, December 17, 2010 2:43 PM
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).
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 be-
ginning. 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 client’s account, see Personal accounts on
page 20.
18
IPTV_Complex_eng.book Page 19 Friday, December 17, 2010 2:43 PM
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 customer’s 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 Mak-
ing payment on page 69.
19
IPTV_Complex_eng.book Page 20 Friday, December 17, 2010 2:43 PM
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
IPTV_Complex_eng.book Page 21 Friday, December 17, 2010 2:43 PM
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
IPTV_Complex_eng.book Page 22 Friday, December 17, 2010 2:43 PM
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 ad-
justed 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 im-
ply that all possible columns are displayed.
Records in the list may be ordered by any column via clicking on the column header. Repeat-
ed clicking on the same column header reverses the search order.
The Synchronize button refreshes the list to reflect possible changes (for example, those in-
troduced 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 ele-
ments 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 sta-
tus string displaying current server time, server address, and connection status, are visible and ac-
cessible from any interface page.
22
IPTV_Complex_eng.book Page 23 Friday, December 17, 2010 2:43 PM
Media groups
Media group is intended to collect together items of media content in order to effectively im-
prove group operations with them (such as to add to the tariff plan or to set a price for). Maximum
number of media groups in the system is limited to 64.
The interface consists of the following pages:
• Media groups displays the list of existing groups together with their parameters.
The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.
The Add and Remove buttons for operations with media groups are available. Ed-
iting of groups is performed directly on the same page.
23
IPTV_Complex_eng.book Page 24 Friday, December 17, 2010 2:43 PM
Media content
Media content is a record about a single unit of content (TV or VoD) which may be referred
to in respect to the customers’ tariff plans. The interface consists of the following pages:
• Media content displays the list of existing content units together with their parameters.
The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.
24
IPTV_Complex_eng.book Page 25 Friday, December 17, 2010 2:43 PM
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 , Edit , and Remove buttons for operations with media content are
available.
• New media content (opens on pressing Add button on the Media contents page) con-
tains interface for entering the parameters of a new content unit.
• 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
IPTV_Complex_eng.book Page 26 Friday, December 17, 2010 2:43 PM
Usage of program schedule is described in Creating TV or TVoD content, step 6 on page 48.
Creation of media content of different types is described in Creating TV or TVoD content on
page 47 and Creating VoD or nVoD content on page 52.
26
IPTV_Complex_eng.book Page 27 Friday, December 17, 2010 2:43 PM
The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.
The Filter input field provides a way of filtering by string search in all fields. The
The Add , Edit , and Remove buttons for operations with media streams are
available. New media streams are created directly on the same page.
27
IPTV_Complex_eng.book Page 28 Friday, December 17, 2010 2:43 PM
• 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 as-
sociated with it.
The creation of media stream is described in Creating a media stream on page 49.
Billing system
The Billing system contains interfaces to the following entities:
• Customers (with add/modify/remove access);
• Tariff plans (with add/modify/remove access);
• Media groups (read-only).
• Media content (with the possibility to edit group membership).
• Currency rates;
• Access cards;
• Banks;
• Reports.
Customers
The customers list contain records about particular customers together with their personal
data and provided services. The interface consists of the following pages:
28
IPTV_Complex_eng.book Page 29 Friday, December 17, 2010 2:43 PM
The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.
The operations with customers are performed by means of the buttons Add , Edit ,
Remove , Make payment, Personal account management, and Personal account in-
formation.
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
IPTV_Complex_eng.book Page 30 Friday, December 17, 2010 2:43 PM
• Add user (opens on pressing Add button on the Customers page) contains interface for
entering the parameters of a new customer, namely:
° Login;
° Password;
° Type;
° Roles;
° Comments;
° Other information. The exact composition of interface fields depend on the customer’s
type (see Basic objects and processes: Customers on page 19). Personal data, legal en-
tity 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
IPTV_Complex_eng.book Page 31 Friday, December 17, 2010 2:43 PM
31
IPTV_Complex_eng.book Page 32 Friday, December 17, 2010 2:43 PM
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: Servic-
es 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 im-
posed earlier (see Personal accounts on page 20).
• Personal account information (opens on pressing the button of the same name or via the con-
text 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 in-
terface 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
IPTV_Complex_eng.book Page 33 Friday, December 17, 2010 2:43 PM
Creation of a new customer record and subsequent operations with it are described in Creat-
ing 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
IPTV_Complex_eng.book Page 34 Friday, December 17, 2010 2:43 PM
° ID;
° Name;
° State.
The Add , Edit , and Remove buttons for operations with tariff plans are avail-
able.
A tariff plan may be removed only if it is not used by anyone.
34
IPTV_Complex_eng.book Page 35 Friday, December 17, 2010 2:43 PM
• 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 re-
spective prices.
• 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 Ed-
iting a tariff plan on page 60.
35
IPTV_Complex_eng.book Page 36 Friday, December 17, 2010 2:43 PM
The Add and Remove buttons for operations with additional services are avail-
able. Editing of services is performed directly on the same page.
36
IPTV_Complex_eng.book Page 37 Friday, December 17, 2010 2:43 PM
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 con-
tent on page 24, though read-only.
• Media content groups (opens on pressing Edit groups in the context menu on the previous
page) allows to attribute any content to some group.
Including the media content into the group is described in Creating a media group on
page 55.
Securi ty
Security group of pages deals with the access cards. Access card is an SSL certificate intend-
ed 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
IPTV_Complex_eng.book Page 38 Friday, December 17, 2010 2:43 PM
The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.
The Filter fold-in group provides the options of filtering by name, by term of validity,
or by state.
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. Af-
ter 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 sys-
tem: Media content on page 37).
38
IPTV_Complex_eng.book Page 39 Friday, December 17, 2010 2:43 PM
V ir t ua l c i n ema
Virtual cinema lists the days during the two-week sliding window (by default, covering the
present week and the one after it), displaying the number of movies and shows for each day, as
well as the number of shows currently running.
The and buttons scroll the viewing window one week forward or backward, corre-
spondingly; opens the calendar to jump to arbitrary date, and restores the window to the
default position.
Pressing the Edit button or double-clicking on the record in the list opens the Schedules
page for the given day.
Schedules page contains the list of movies to be shown during the particular day. For each of
the movies the following information is listed:
• Film name of the movie (selected from a dropdown list);
39
IPTV_Complex_eng.book Page 40 Friday, December 17, 2010 2:43 PM
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 sched-
ule on page 54.
40
IPTV_Complex_eng.book Page 41 Friday, December 17, 2010 2:43 PM
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.
The Filter input field provides a way of filtering by string search. There are also drop-
down lists for filtering by stream type or by the state of the associated content.
• New media stream (opens on pressing Add ) contains interface for entering the parame-
ters of a new media stream.
41
IPTV_Complex_eng.book Page 42 Friday, December 17, 2010 2:43 PM
TVoD system
The TVoD system contain interface to the TV media content and associated streams for set-
ting 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 sys-
tem: Media content on page 24) is included in the TVoD interface to have the quick access to the
information on existing media content.
42
IPTV_Complex_eng.book Page 43 Friday, December 17, 2010 2:43 PM
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.
Dumping control
The page contains summary interface for recording of media streams grouped in the follow-
ing blocks:
• Records contains the list of all streams being recorded. For each one the following informa-
tion is presented:
43
IPTV_Complex_eng.book Page 44 Friday, December 17, 2010 2:43 PM
44
IPTV_Complex_eng.book Page 45 Friday, December 17, 2010 2:43 PM
USAGE EXAMPLES 5
This chapter contains typical scenarios of NetUP’s 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 it-
self 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).
Before downloading the united control center, you have to upload (see Keystore on
page 85) the security.tgz file obtained via the personal cabinet.
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
IPTV_Complex_eng.book Page 46 Friday, December 17, 2010 2:43 PM
Language of the UCC installer, as well as that of the UCC itself, is set according to the
current system locale.
5. Start the united control center by running the control.center.se.jar file in the in-
stallation directory. A Connect to server window will appear.
The Middleware server must be used as DNS server, since it resolves the default sys-
tems’ 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.
46
IPTV_Complex_eng.book Page 47 Friday, December 17, 2010 2:43 PM
Usage examples
By setting the Name field you may change the system’s 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 “Can’t load keystore. Please check key-
store file and password” appears instead, download the netup.keystore file from the client’s
personal cabinet on www.netup.tv and upload it to the system’s web interface (see Keystore on
page 85).
Context menu of any table contains the Columns item via which the user may hide or
reveal any column individually.
47
IPTV_Complex_eng.book Page 48 Friday, December 17, 2010 2:43 PM
4. Specify the following parameters of the media con- Figure 26. TV media content creation.
tent being created:
Field name Value
Staff name Leave default: iptv-middleware
State Active
Type TV
Code 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 Name of the new content
Description Annotation for displaying in the client STB interface (see STB Client
(Optional) Interface: Viewing TV channels on page 103)
Genre (Optional) Genres of the media content (a list with an option of multiple choice)
Image (Optional) Image related to the channel content (scaled to 100 by 140 px)
6. Create the schedule of telecasts or make sure it is properly created automatically, as de-
scribed 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 me-
dia 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 . The Edit media
stream page will show up.
8.2. In the Media content column select the newly created TV content.
48
IPTV_Complex_eng.book Page 49 Friday, December 17, 2010 2:43 PM
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 user’s rights to view the con-
tent 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.
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.
3. In the filter pane above the list press TV or NVOD , depending on the type of
streams you intend to create.
49
IPTV_Complex_eng.book Page 50 Friday, December 17, 2010 2:43 PM
5.1. Press Add . The stream pool creation window will show up.
5.2. Enter the IP address and port for the pool being created.
5.3. Press Add.
Figure 29. Stream
pool creation.
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).
3. Select the stream just created and press Edit or Receiving, or just double-click on it.
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 ac-
tive. Figure 30. Media stream encryption.
5. Press Broadcasting. As the channel starts broadcasting, the Encryption button turns active
and the chart below starts to display the media stream bitrate.
50
IPTV_Complex_eng.book Page 51 Friday, December 17, 2010 2:43 PM
Usage examples
6. If you want to encode the stream, press Encryption.
As a rule, this action is a step of TV content creation (see Creating TV or TVoD content, step
9 on page 49).
4. Select the incoming interface from the dropdown list (if the required interface is missing,
add it as described in Adding new network interface on page 70) and press Receiving. The
Record button will turn active, and the bitrate plot will start to appear under Statistics.
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
IPTV_Complex_eng.book Page 52 Friday, December 17, 2010 2:43 PM
52
IPTV_Complex_eng.book Page 53 Friday, December 17, 2010 2:43 PM
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.
53
IPTV_Complex_eng.book Page 54 Friday, December 17, 2010 2:43 PM
4. Select the line corresponding to the day you need to set the shedule for, and press Edit .
The Schedules tab will appear.
54
IPTV_Complex_eng.book Page 55 Friday, December 17, 2010 2:43 PM
Usage examples
While setting up program schedule, you may receive a warning concerning insuffi-
cient number of media streams. In this case create more streams of type nVoD, as de-
scribed 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 record’s state will change to Prepared.
As a rule, this action is a step of nVoD content creation (see Creating VoD or nVoD content,
step 8.1 on page 52).
Content with type VOD may be put into groups of both VOD and NVOD types.
55
IPTV_Complex_eng.book Page 56 Friday, December 17, 2010 2:43 PM
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.
4. Enter the Login and Password for the Figure 40. Add user tab.
new user.
Person’s full name is to be entered as follows: Last name into the leftmost subfield,
then goes First name, then Middle name or initial.
56
IPTV_Complex_eng.book Page 57 Friday, December 17, 2010 2:43 PM
Usage examples
7. Fill up the needed fields with the info about the new person or legal entity.
Below is a list of legal abbreviations you may encounter among the optional parameters:
LLC Limited liability company
OJSC Open joint stock company
CJSC Closed joint stock company
NAICS North American Industry Classification System
IEC Industrial Enterprise Code
SIC Standard Industrial Classification
TIN 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 ad-
dress input field opens the address
input window intended for struc-
tured input with existence check. To
enter an address in free form, mark
the corresponding Arbitrary ad-
dress check box.
Figure 42. Address input window.
8. Press Apply to save the
changes.
9. Close the Add user tab.
57
IPTV_Complex_eng.book Page 58 Friday, December 17, 2010 2:43 PM
press Edit .
Note that double-clicking on the customers list (unlike most other lists) opens the Per-
sonal 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 Cre-
ating a personal account on page 59.
58
IPTV_Complex_eng.book Page 59 Friday, December 17, 2010 2:43 PM
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 Per-
sonal 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 ac-
count.
The most likely following action with the newly personal account is described in the example
Attaching a tariff plan on page 64.
3. Add new tariff plan. The New tariff plan tab will ap-
pear.
4. Enter the tariff plan name.
Figure 45. Creating tariff plan.
5. In the Roles field select one or several roles from the drop-
down list.
59
IPTV_Complex_eng.book Page 60 Friday, December 17, 2010 2:43 PM
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.
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: Person-
al 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
IPTV_Complex_eng.book Page 61 Friday, December 17, 2010 2:43 PM
Usage examples
al services (see Adding services to a tariff plan on page 64) and/or bonuses (see Adding
bonuses to a tariff plan on page 64).
If some media content belongs to two or more different groups which attempt to set dif-
ferent 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 as-
sumed).
8. If needed, alter some items in the tariff plan and press Apply to save the changes.
9. If needed, remove some services as follows:
9.1. Change the State of the item in question to Setting up.
10. Change the tariff plan State to Active and press Apply to save the changes.
Removal of tariff plan also requires preliminary changing its state to Setting up, and is pos-
sible 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.
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 servic-
es, etc.)
62
IPTV_Complex_eng.book Page 63 Friday, December 17, 2010 2:43 PM
Usage examples
Column Description
Mandatory 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.
Blockable If checked, the service will be blocked automatically in case if the client is blocked.
State Active
Tariffication Periodicity at which the charge-offs for this service from the client’s account are
type performed: daily (Daily prepaid), monthly (Periodic prepaid), or for the entire
duration at once (Full prepaid).
Note that the content with unchecked Mandatory option may be bought (and hence ac-
tivated) by the user later. See STB Client Interface: Viewing TV channels on
page 103 for details.
As a rule, this action is a step of Creating a tariff plan on page 59 or Editing a tariff plan on
page 60.
Note that each table containing a column for price or price-per-period is also
equipped with a context menu item named Units that displays a list of currencies. If the
currency you intend to use is absent, expand the list as described at Adding new cur-
rency 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
IPTV_Complex_eng.book Page 64 Friday, December 17, 2010 2:43 PM
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.
64
IPTV_Complex_eng.book Page 65 Friday, December 17, 2010 2:43 PM
Usage examples
2. On the left pane open the Customers group and select Customers. The Customers tab will
show up (see Creating a user on page 56 for creating customers).
3. Select the customer to whom you intend to assign the tariff plan and press Personal account
management button. The Personal account management tab will appear.
4. Select an account and attach a tariff plan to it as follows:
4.1. Press Add under the Tariff plans list to add a new line to the list (initially empty).
4.2. Select the tariff plan from the dropdown list. (The plan should be created beforehand as
described in Creating a tariff plan on page 59.)
4.3. Set the Start date and End date values for the tariff plan, or leave the default values
(“now” and “forever”, correspondingly).
Start date of the tariff plan can not be set to the moment in the past.
Note also that the user is capable of switching tariff plans at his own will (see STB Cli-
ent 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:
While the tariff plan is enabled, it is impossible to set up another plan covering the
same or overlapping time span.
66
IPTV_Complex_eng.book Page 67 Friday, December 17, 2010 2:43 PM
Usage examples
2. From the top menu select Plug-ins, then Edit properties for plug-ins. The Properties for
plug-ins window will appear.
3. Select the word currencies row and press Edit . The Editing Property window will ap-
pear.
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.
3. Press Add in order to add a new line to the list of activation codes.
67
IPTV_Complex_eng.book Page 68 Friday, December 17, 2010 2:43 PM
68
IPTV_Complex_eng.book Page 69 Friday, December 17, 2010 2:43 PM
Usage examples
4. Set the Counter value to 0.
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.
Figure 53. Making payment.
5. Enter the amount of payment.
6. Select the payment currency, if applicable.
Now the services included in the customer’s 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
IPTV_Complex_eng.book Page 70 Friday, December 17, 2010 2:43 PM
2. Select the string available_interfaces row and press Edit . The Editing Property win-
dow will appear.
3. Enter the name of the new interface to the last string (initially empty).
4. Press OK to save the changes.
5. Press Close to close the Properties for plug-ins window.
70
IPTV_Complex_eng.book Page 71 Friday, December 17, 2010 2:43 PM
LCD PANEL 6
To set up the NetUP’s 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
Figure 55. LAN monitor.
traffic separated by “/”.
Pressing Up switches to the CPU load screen. First
number is the total CPU load. Three subsequent num-
bers give, correspondingly, the portions of CPU load
related to user tasks (u), system tasks (s), and awaiting
Figure 56. CPU usage monitor.
data from the peripherals (w). Pressing Down switch-
es back to the traffic statistics screen.
71
IPTV_Complex_eng.book Page 72 Friday, December 17, 2010 2:43 PM
72
IPTV_Complex_eng.book Page 73 Friday, December 17, 2010 2:43 PM
WEB INTERFACE 7
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 cer-
tificate.
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.
Management
This page displays the
system components (servers)
together with their Status
(Active / Not active) and ac-
tion buttons to activate or de-
activate particular servers.
74
IPTV_Complex_eng.book Page 75 Friday, December 17, 2010 2:43 PM
Web interface
Control center
This page contains the united control center. Guidelines for starting the control center and fur-
ther 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 sys-
tem documentation in a single PDF
file.
STB Files
On this page the service program MCUP for handling the D-Link STBs is available for down-
load. Besides that, it contains the NetUP STB firmware for various supported STBs. The devel-
opment 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 cus-
tom modifications.
DVB
DVB page displays the list of DVB
adapters installed in the system togeth-
er with their current state.
Below is the parameters explana-
tion by column.
Figure 64. DVB page.
75
IPTV_Complex_eng.book Page 76 Friday, December 17, 2010 2:43 PM
Adapters and CAM slots on the backplate of the actual NetUP streamer are numbered
bottom-to-top, as shown below.
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.
Note that stopping service stops transmitting video stream to network from this
adapter.
76
IPTV_Complex_eng.book Page 77 Friday, December 17, 2010 2:43 PM
Web interface
Adapter configuration window
This window is intended for setting up basic parameters of DVB adapter.
Note that changing frequency may lead to the loss of channel settings for the given
adapter. See Channels window on page 79 for details.
77
IPTV_Complex_eng.book Page 78 Friday, December 17, 2010 2:43 PM
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 de-
tails.
° 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
IPTV_Complex_eng.book Page 79 Friday, December 17, 2010 2:43 PM
Web interface
Channels window
This window lists all channels found by the DVB adapter.
Note that this page will show up correctly only if the adapter software is set up cor-
rectly 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;
The list begins with the channels that are already streaming, if any. For them, multicast IP ad-
dresses, 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
IPTV_Complex_eng.book Page 80 Friday, December 17, 2010 2:43 PM
EPG
On this page an EPG in XMLTV format may be uploaded from file or from given URL.
Once EPG is imported, the list of channels is revealed so that their internal IDs may be set.
In case of using the Upload from URL option, from that point on the EPG will be updated dai-
ly from the same address.
80
IPTV_Complex_eng.book Page 81 Friday, December 17, 2010 2:43 PM
Web interface
VoD
This page is intended for binding the media content codes from Middleware with the loaded
media files.
When a VoD-type media content is created and the corresponding file is loaded (see Usage
examples: Creating VoD or nVoD content on page 52), select the file in the list, press Activate
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.
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
IPTV_Complex_eng.book Page 82 Friday, December 17, 2010 2:43 PM
There is no need to enter this IP address into the routing table (see Routing table win-
dow 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.
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
IPTV_Complex_eng.book Page 83 Friday, December 17, 2010 2:43 PM
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.
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
IPTV_Complex_eng.book Page 84 Friday, December 17, 2010 2:43 PM
Backup
This page provides control interface
for system backups. Create button cre-
ates an archive in *.tar.bz2 format
containing system settings; also, an au-
tomatic backup is made every day. Ex-
isting backup files together with their Figure 77. Backup page.
creation dates are listed in the table. De-
lete button next to a file removes it.
More details on creation and usage of backups may be found at Backup copies on page 129.
Power Management
This page contains Reboot and Shutdown buttons. Whenever the server needs to be reloaded
or shut down, this should be done exclusively by means of these controls; abnormal termination
may lead to system failure.
Update
This page lists the uploaded firmware files together with their uploading dates, build num-
bers, and possible actions.
This page allows to update the IPTV Complex firmware. To do that, upload the new firmware
file to the server via FTP (login: update; password is similar to that of the web interface, so that
both are changed simultaneously, see Security on page 87), refresh the page to reveal it in the list,
and press Install.
84
IPTV_Complex_eng.book Page 85 Friday, December 17, 2010 2:43 PM
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 client’s
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 system’s components.
The security.tgz file must be uploaded prior to the downloading of the united
control center (see Control center on page 75).
Network
Network page gives the full list of installed network adapters together with their state.
Network connectors on the front panel of the NetUP streamer are marked as follows:
On the panel 1 2 3 4 5 6
In the web interface eth0 eth1 eth2 eth3 eth4 eth5
The Setup routing button opens routing table (see Routing table window on page 86). The
VLAN button opens the interface to virtual network adapters (see VLAN window on page 86).
• Interface column lists the system names of the adapters;
• Status lists the adapter state (ON / OFF);
• MAC lists MAC addresses of network adapters;
• IP lists the adapters’ IP addresses;
• DHCP shows the DHCP state (Running / Stopped);
• Actions column lists the possible operations with the given adapter:
° Configure – configure adapter (see Configure window on page 86);
° DHCP – set up DHCP for this adapter (see DHCP configuration window on page 87);
° Statistics – show graphical load statistics for this adapter.
85
IPTV_Complex_eng.book Page 86 Friday, December 17, 2010 2:43 PM
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 LAN’s name and the ID will
be created.
Configure window
This window contains configuration options of network adapter.
86
IPTV_Complex_eng.book Page 87 Friday, December 17, 2010 2:43 PM
Web interface
For convenience parameters are grouped in three blocks:
• Adapter Information
This block shows the adapter’s 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.
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 administra-
tor'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 Up-
date.
Passwords to FTP access for uploading content and firm-
ware are bound to be identical to the administrator’s pass- Figure 84. Security page.
word, so they are updated automatically along with it.
87
IPTV_Complex_eng.book Page 88 Friday, December 17, 2010 2:43 PM
About
This page displays the version number of IPTV Complex and build numbers of individual
systems.
88
IPTV_Complex_eng.book Page 89 Friday, December 17, 2010 2:43 PM
Web interface
Connections
This page displays the connections between the systems of IPTV Complex (including indi-
vidual STBs). For each system it lists the IP address, port, and protocol in which it interacts with
other systems.
Storage
This page summarizes the disk space usage info.
89
IPTV_Complex_eng.book Page 90 Friday, December 17, 2010 2:43 PM
90
IPTV_Complex_eng.book Page 91 Friday, December 17, 2010 2:43 PM
STB SETUP 8
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 lan-
guage 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). Up-
loaded 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 per-
formed 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.
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 upload-
ing) 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 re-
moval of a portion of this file related to some particular interface screen renders that screen inac-
cessible to the users.
Updated theme files are sent over the network as a UDP multicast stream to the given multi-
cast 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
IPTV_Complex_eng.book Page 92 Friday, December 17, 2010 2:43 PM
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"
92
IPTV_Complex_eng.book Page 93 Friday, December 17, 2010 2:43 PM
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 firm-
ware updates come from. If for some reason setting up a DHCP server is unsuitable, these param-
eters 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"
{
93
IPTV_Complex_eng.book Page 94 Friday, December 17, 2010 2:43 PM
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 provid-
ed 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 parame-
ters. To do that, connect to the STB via telnet and set the following parameters using the lib-
config-set command:
libconfig-set NORFLASH.DHCP N
libconfig-set NORFLASH.IPADDR 10.1.2.3
libconfig-set NORFLASH.NETMASK 255.255.255.0
libconfig-set NORFLASH.GATEWAY 10.1.2.1
libconfig-set NORFLASH.DNS 10.1.2.1
libconfig-set NORFLASH.TIME_SERVER 10.1.2.1
94
IPTV_Complex_eng.book Page 95 Friday, December 17, 2010 2:43 PM
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 Mid-
dleware 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 ex-
ample for Amino AmiNET110:
libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_GROUP 225.50.50.50
libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_PORT 11111
libconfig-set NORFLASH.MULTICAST_UPGRADE_GROUP 225.50.50.51
libconfig-set NORFLASH.MULTICAST_UPGRADE_PORT 11111
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).
95
IPTV_Complex_eng.book Page 96 Friday, December 17, 2010 2:43 PM
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 per-
form 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
IPTV_Complex_eng.book Page 97 Friday, December 17, 2010 2:43 PM
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: size erasesize name
mtd0: 01200000 00020000 "a0_rootfs"
mtd1: 00200000 00020000 "html"
mtd2: 00200000 00020000 "kernel"
mtd3: 001c0000 00020000 "a0_kernel"
mtd4: 00440000 00020000 "b0_rootfs"
mtd5: 000c0000 00020000 "cfe"
mtd6: 00080000 00020000 "splash"
mtd7: 00280000 00020000 "a0_config"
mtd8: 00020000 00020000 "variable"
mtd9: 00020000 00020000 "misc"
to autodetect resolution.
Output signal type is set by the OUTPUT_CHANNEL variable, which may take one of the fol-
lowing values:
• SD_CH_COMPOSITE
• SD_CH_COMPONENT
• SD_CH_SVIDEO
97
IPTV_Complex_eng.book Page 98 Friday, December 17, 2010 2:43 PM
98
IPTV_Complex_eng.book Page 99 Friday, December 17, 2010 2:43 PM
Startup
At first launch the user is prompted to enter the activation number. On subsequent launches
the authorization is performed automatically.
99
IPTV_Complex_eng.book Page 100 Friday, December 17, 2010 2:43 PM
If the selected style does not match the TV’s physical resolution, then the style selection
screen will also appear on the next launches, until a proper style is set.
100
IPTV_Complex_eng.book Page 101 Friday, December 17, 2010 2:43 PM
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 pass-
word for unlocking.
In case if the STB is physically disconnected from the network, it boots into the offline mode.
This can be verified by the Not connected line in the Middleware address field on the Network
Information screen (see Settings). To switch to the normal mode, restore the network connection
and reboot the STB.
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 play-
ing, this content is marked in the list with the sign (or maybe, or , if the reproduction is
paused or stopped).
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 ar-
rows 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
IPTV_Complex_eng.book Page 102 Friday, December 17, 2010 2:43 PM
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 but-
ton 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.
When a VoD content is playing or rewinding, the status bar also displays its present moment
and total length.
When a TV content is playing, the status bar also contains TV program for the given channel.
In playing mode the status bar disappears automatically after some delay. In other regimes it
stays on the screen until hidden by the red function button.
102
IPTV_Complex_eng.book Page 103 Friday, December 17, 2010 2:43 PM
Favorite screen lists selected channels with the options of viewing and removing from the fa-
vorites.
103
IPTV_Complex_eng.book Page 104 Friday, December 17, 2010 2:43 PM
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 oc-
curs 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 , corre-
spondingly. 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 pro-
gram 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 , non-recorded programs are
denoted .
TV groups screen lists available groups of TV channels, if the user’s tariff plan contains any,
and provides the functionality of enabling and disabling those of them which are not enabled by
default.
104
IPTV_Complex_eng.book Page 105 Friday, December 17, 2010 2:43 PM
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 user’s tariff plan with Mandatory option off
(see Creating a tariff plan on page 59).
The description of the highlighted movie is shown in the bottom part of the screen.
To order the highlighted movie, press OK.
Ordering a movie will require a financial password, if it is set (see Settings on page 108).
105
IPTV_Complex_eng.book Page 106 Friday, December 17, 2010 2:43 PM
Once ordered, the movies become available in the Available seances screen.
When a movie is selected, its program schedule appears (see Setting up nVoD program
schedule on page 54), including the already started shows. Once a show is selected, the sched-
uled switch to it is set up. If the selected show is already running, the reproduction will start im-
mediately.
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
IPTV_Complex_eng.book Page 107 Friday, December 17, 2010 2:43 PM
Replace tariff plan provides the interface for switching to another tariff plan by selecting it
from the list. The list is composed of tariff plans that overlap by roles (i.e. have some roles in
common, see Editing a tariff plan, step 6 on page 60) with the current one.
107
IPTV_Complex_eng.book Page 108 Friday, December 17, 2010 2:43 PM
Settings
The Settings interface consists of the following screens.
Security screen contains the interface for setting, changing, and unsetting various passwords:
• Unlock password. Once set, this password is required to start the STB interface after each
hardware reboot;
• Financial password. Once set, it is requested before every finance-related operation, like
buying content, changing the tariff plan, etc.;
• Parental password. Once set, it is requested for gaining access to an adult content (this prop-
erty of the content is derived from its genre attribution).
To unset any password, change it to empty string.
108
IPTV_Complex_eng.book Page 109 Friday, December 17, 2010 2:43 PM
Styles screen contains the list of available custom user styles for STB interface. See Web in-
terface: Styles on page 83 for uploading user styles).
109
IPTV_Complex_eng.book Page 110 Friday, December 17, 2010 2:43 PM
Additional
Scheduler screen displays the list of scheduled events, including switches, notifications, and
alarm clocks. An alarm clock event may be set up on this very screen. At scheduled time it
switches TV on at top volume.
110
IPTV_Complex_eng.book Page 111 Friday, December 17, 2010 2:43 PM
111
IPTV_Complex_eng.book Page 112 Friday, December 17, 2010 2:43 PM
112
IPTV_Complex_eng.book Page 113 Friday, December 17, 2010 2:43 PM
Preparations
To use the STB client integrated with a hotel property management system, an associated cus-
tomer for each room in the hotel should be created in IPTV Middleware. The said customer must
have the following properties:
• Customer’s type is set to Individual;
• Customer has no associated persons (instead, a person is created automatically on the client’s
check-in and removed on check-out);
• Customer has one and only one personal account, whose ID is equal to the room number;
• Customer’s account is permanently blocked (it is going to be unblocked automatically on the
client’s check-in and blocked again on check-out);
• Account’s 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
IPTV_Complex_eng.book Page 114 Friday, December 17, 2010 2:43 PM
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 per-
formed automatically.
If the activation number has been entered incorrectly for 10 times, further attempts
will be blocked and the requests counter should be reset as described in Resetting ac-
tivation requests counter on page 68.
114
IPTV_Complex_eng.book Page 115 Friday, December 17, 2010 2:43 PM
Welcome screen is actually a dynamic web page located on the Middleware server at
/netup/sysconfig/hotel/welcome.php. Client’s 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.
Client’s 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 pass-
word), the lock screen will appear first, prompting the user to enter this password for unlocking.
In case if the STB is physically disconnected from the network, it boots into the offline mode.
This can be verified by the Not connected line in the Middleware address field on the Network
Information screen (see Settings). To switch to the normal mode, restore the network connection
and reboot the STB.
115
IPTV_Complex_eng.book Page 116 Friday, December 17, 2010 2:43 PM
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 but-
ton 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.
116
IPTV_Complex_eng.book Page 117 Friday, December 17, 2010 2:43 PM
When a TV content is playing, the status bar also contains TV program for the given channel.
In playing mode the status bar disappears automatically after some delay. In other regimes it
stays on the screen until hidden by the red function button.
Multimedia
TV channels screen lists all channels available according to the user’s tariff plan (see Creat-
ing 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.
TV groups screen lists available groups of TV channels, if the user’s tariff plan contains any,
and provides the functionality of enabling and disabling those of them which are not enabled by
default.
117
IPTV_Complex_eng.book Page 118 Friday, December 17, 2010 2:43 PM
Ordering a movie will require a financial password, if it is set (see Settings on page 118).
Settings
The interface of this group consists of four screens.
Information displays the current tariff plan, card validity period, and balance.
118
IPTV_Complex_eng.book Page 119 Friday, December 17, 2010 2:43 PM
Security screen contains the interface for setting, changing, and unsetting various passwords:
• Unlock password. Once set, this password is required to start the STB interface after each
hardware reboot;
• Financial password. Once set, it is requested before every finance-related operation, like
buying content, changing the tariff plan, etc.;
• Parental password. Once set, it is requested for gaining access to an adult content (this prop-
erty of the content is derived from its genre attribution).
To unset any password, change it to empty string.
119
IPTV_Complex_eng.book Page 120 Friday, December 17, 2010 2:43 PM
Services
Bill displays the financial report, i.e. the history of payments and charges for the hotel servic-
es, not limited to the IPTV-related ones. Moreover, it provides an option of self-checkout.
120
IPTV_Complex_eng.book Page 121 Friday, December 17, 2010 2:43 PM
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.
Internet screen (present only on Amino AmiNET 130) implements basic functionality of a
web browser.
121
IPTV_Complex_eng.book Page 122 Friday, December 17, 2010 2:43 PM
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 housekeeper’s password and then
opens a special screen where a housekeeper may specify the status of the room.
122
IPTV_Complex_eng.book Page 123 Friday, December 17, 2010 2:43 PM
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 substi-
tution.
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 corre-
sponding controls and is capable of switching to full-screen mode.
The interface elements are grouped into several tabs. The main menu stays on the left and is
accessible from any tab.
On first launch the program requests
the activation code.
123
IPTV_Complex_eng.book Page 124 Friday, December 17, 2010 2:43 PM
On the right there is a list of all channels available according to the user’s tariff plan (see Cre-
ating 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:
• List mode shows just the list without any extra info;
• Show TV program also shows the TV program for the selected channel;
• Show channel description also shows the description of the selected channel.
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
Switch to and Notify states; double-clicking on a telecast in the past starts playing TVoD, if
the said telecast has been recorded.
VoD
This tab contains the interface for selecting and viewing VoD content.
124
IPTV_Complex_eng.book Page 125 Friday, December 17, 2010 2:43 PM
PC Client
On the right there is a list of available content. Movies may be added to palylist. Once a con-
tent 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.
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 user’s 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
IPTV_Complex_eng.book Page 126 Friday, December 17, 2010 2:43 PM
Mini mode
Minimize button switches the program’s main window to mini mode and back. In this
mode the window is sized down to contain the left menu alone. Lists of content items are shown
directly inside the menu, and playback is started by single click. Menu items that can not be
shown in this mode (Market), when selected, cause switch back to normal mode.
Playback window
Playback window is intended for video content playback.
The control panel located in the bottom part of the window provides the following functions:
• Back (to the left of the position bar), depending on the current state, may slow down the
forward wind, switch to rewind, or speed up the rewind. The current state, including speed
and direction of playback/rewind, is also shown on the panel.
• Forward (to the right of the position bar), depending on the current state, may slow
down the rewind, switch to the forward wind, or speed up the forward wind.
• Show menu brings up the main window of the program.
• Hide panel hides the control panel. Also, the panel hides by itself after 3 seconds of us-
er’s inactivity. To open the panel, either click once anywhere in the playback window, or hov-
er mouse through the window’s bottom area.
• Fullscreen toggles the fullscreen mode. Double-clicking anywhere in the playback win-
dow has the same effect.
• Stop stops the playback.
• Play starts or resumes the playback.
• Pause pauses the playback.
126
IPTV_Complex_eng.book Page 127 Friday, December 17, 2010 2:43 PM
PC Client
• Prev. 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 con-
text menu with a variety of predefined standard window sizes.
127
IPTV_Complex_eng.book Page 128 Friday, December 17, 2010 2:43 PM
128
IPTV_Complex_eng.book Page 129 Friday, December 17, 2010 2:43 PM
SYSTEM MAINTENANCE 12
Backup copies
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 cli-
ent. 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 ex-
ample, 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.
129
IPTV_Complex_eng.book Page 130 Friday, December 17, 2010 2:43 PM
When wired to a PC via direct cable connection, the STB may be controlled with a terminal
program.
Reboot the STB with the cable connected. After some booting messages, the following
prompt will appear:
Hit ENTER to stop normal operation ...
I>
130
IPTV_Complex_eng.book Page 131 Friday, December 17, 2010 2:43 PM
System maintenance
change,copy,delete,details,device,dir,format,
fs,load,makefs,rename,run,save,type,verify
mputgif,setavc
mboot
131
IPTV_Complex_eng.book Page 132 Friday, December 17, 2010 2:43 PM
99%
Erasing...
99%
During startup the STB will communicate to the address just set in order to download the
modern version of firmware.
In case if the STB’s 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 im-
possible, ask the vendor for further instructions.
132
IPTV_Complex_eng.book Page 133 Friday, December 17, 2010 2:43 PM
System maintenance
2 5 Product file missing from running Uses REFLASH and then reboots
software
2 6 bin/products file missing from Reboots
downloaded software upgrade
2 7 bin/products file doesn't match STB Reboots
product (upgrade not suitable for this
STB product/platform type)
3 1 Verification of the download image Deletes the image if saved in the
failed flash. Tries 3 times, reboots if
unsuccessful
3 2 Signature check of the listfile.sig failed Deletes the image if saved in the
flash. Tries 3 times, reboots if
unsuccessful
3 3 listfile.sig is missing Erases the flash and reboots
3 4 Missing file in the NAND flash Erases the flash and reboots
according to listfile.sig
3 5 File check failed against listfile.sig Erases the flash and reboots
3 6 File found on the NAND flash not in Erases the flash and reboots
listfile.sig
3 7 Unable to decode the customer public Reboots
key on the box
4 1 Verification of the download image Deletes the image if saved in the
failed flash. Tries 3 times, reboots if
unsuccessful
4 2 Signature check of the listfile.sig failed Deletes the image if saved in the
Flash. Tries 3 times, reboots if
unsuccessful
133
IPTV_Complex_eng.book Page 134 Friday, December 17, 2010 2:43 PM
8 3 Signature check of customer key failed Keeps flashing code in endless loop
9 2 NAND flash hardware / format failure Keeps flashing code in endless loop
134
IPTV_Complex_eng.book Page 135 Friday, December 17, 2010 2:43 PM
System maintenance
Setting up Amino remote control
On Amino’s 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 se-
quence 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).
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).
135
IPTV_Complex_eng.book Page 136 Friday, December 17, 2010 2:43 PM
136
IPTV_Complex_eng.book Page 137 Friday, December 17, 2010 2:43 PM
IPTV_Complex_eng.book Page 138 Friday, December 17, 2010 2:43 PM
Current version of this document is distributed together with the NetUP’s IPTV Complex and
is accessible via its web interface, see Documentation on page 75.