Sei sulla pagina 1di 170

IPTV_Complex_eng.

book Page 1 Friday, November 2, 2012 1:05 PM

NetUP.tv
Administrator’s Guide

DVB to IP Gateway / Streamer, CAS,


VoD / nVoD, TVoD / Time-Shifted TV / nPVR,
Middleware, IPTV Billing, Customer Interface
IPTV_Complex_eng.book Page 2 Friday, November 2, 2012 1:05 PM
IPTV_Complex_eng.book Page 1 Friday, November 2, 2012 1:05 PM

Contents
1. Introduction - - - - - - - - - - - - - - - - - - - - - - - - 5
Intended audience - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5
Notation conventions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5
IPTV technology - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5
NBS architecture - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -6
NetUP.tv Overview- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -6
2. System Components- - - - - - - - - - - - - - - - - - - - 9
Bundling options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -9
Streamer - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 10
Conditional Access System - - - - - - - - - - - - - - - - - - - - - - - - - - - 10
Video on Demand- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 11
Middleware - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 12
Billing - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 12
STB Client - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 13
3. Basic objects and processes - - - - - - - - - - - - - - 15
Media content - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15
Services - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15
Tariff plans - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 17
Customers - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 17
4. United control center - - - - - - - - - - - - - - - - - - 19
Common elements - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19
Middleware - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21
Billing - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 30
nVoD - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 43
TVoD - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 46
DRM - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 48
IPTV Core- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 49
Payment systems - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 50

1
IPTV_Complex_eng.book Page 2 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


5. Usage examples - - - - - - - - - - - - - - - - - - - - - 53
Installing the UCC - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 53
Creating TV or TVoD content - - - - - - - - - - - - - - - - - - - - - - - - - 55
Setting up telecasts program schedule - - - - - - - - - - - - - - - - - - - - 56
Creating a media stream - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 57
Setting up stream encryption - - - - - - - - - - - - - - - - - - - - - - - - - - 57
Setting up stream recording - - - - - - - - - - - - - - - - - - - - - - - - - - - 58
Creating VoD or nVoD content - - - - - - - - - - - - - - - - - - - - - - - - 59
Setting up nVoD program schedule- - - - - - - - - - - - - - - - - - - - - - 60
Creating a media group - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 61
Creating a user- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 62
Creating a personal account - - - - - - - - - - - - - - - - - - - - - - - - - - - 65
Creating a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 66
Editing a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 67
Creating an additional service - - - - - - - - - - - - - - - - - - - - - - - - - 68
Adding content to a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - 69
Adding content groups to a tariff plan - - - - - - - - - - - - - - - - - - - - 69
Adding services to a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - 70
Adding bonuses to a tariff plan- - - - - - - - - - - - - - - - - - - - - - - - - 71
Attaching a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 71
Changing a tariff plan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 72
Adding new currency - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 73
Generating activation code - - - - - - - - - - - - - - - - - - - - - - - - - - - 73
Resetting activation requests counter- - - - - - - - - - - - - - - - - - - - - 74
Making payment - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 75
Adding new network interface - - - - - - - - - - - - - - - - - - - - - - - - - 76
6. LCD panel - - - - - - - - - - - - - - - - - - - - - - - - 77
Statistics screen - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 77
Network interfaces setup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 77
7. Web interface - - - - - - - - - - - - - - - - - - - - - - 79
Introduction - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 79
Starting web interface - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 80
Contents - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 80
Virtual cinema - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 83
2
IPTV_Complex_eng.book Page 3 Friday, November 2, 2012 1:05 PM

IPTV distribution - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 84
DVB adapters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 85
IPTV - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 87
Set Top Boxes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 89
System administration - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 92
System configuration - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 93
System status - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 98
8. STB setup - - - - - - - - - - - - - - - - - - - - - - - - 101
Updating STB firmware- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 101
Updating user theme - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 102
Amino AmiNET- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 104
D-Link - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 107
Teletec Mag-200 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 108
9. STB Client Interface - - - - - - - - - - - - - - - - - - - 111
Startup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 111
Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 113
Viewing TV channels - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 115
Viewing VoD- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 117
Listening to radio - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 119
Personal account- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 119
Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 120
Additional - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 122
10.STB Client Hotel Edition - - - - - - - - - - - - - - - - - 125
Preparations- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 125
Startup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 126
Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 127
Multimedia - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 129
Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 130
Services - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 132
11.NetUP.tv Android client - - - - - - - - - - - - - - - - - 135
Startup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 135
Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 135

3
IPTV_Complex_eng.book Page 4 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


TV channels - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 136
Program guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 137
Movies - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 138
Personal account - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 139
12.PC Client - - - - - - - - - - - - - - - - - - - - - - - - -141
Common features - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 141
TV- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 142
VoD- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 142
Radio - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 143
Market - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 143
Playlists - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 143
Settings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 143
Mini mode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 144
Playback window - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 144
13.System maintenance - - - - - - - - - - - - - - - - - -147
Backup copies - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 147
STB diagnostics- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 147
Network troubleshooting - - - - - - - - - - - - - - - - - - - - - - - - - - - - 147
NetUP server troubleshooting - - - - - - - - - - - - - - - - - - - - - - - - 147
NetUP Dual DVB-S2-CI - - - - - - - - - - - - - - - - - - - - - - - - - - - - 148
Debugging board for SMiT CAM modules- - - - - - - - - - - - - - - - 151
Amino STB troubleshooting - - - - - - - - - - - - - - - - - - - - - - - - - 153
Setting up Amino remote control - - - - - - - - - - - - - - - - - - - - - - 158
14.Glossary - - - - - - - - - - - - - - - - - - - - - - - - -161
15.Alphabetical Index - - - - - - - - - - - - - - - - - - - -165

4
IPTV_Complex_eng.book Page 5 Friday, November 2, 2012 1:05 PM

INTRODUCTION 1
Intended audience
This manual is intended for IPTV service providers using the NetUP.tv solution. An overall
knowledge of TV broadcasting systems and IP networking is assumed. The document covers ba-
sic functionality of NetUP.tv, as well as the typical necessary actions during its startup, deploy-
ment, and operation.

Notation conventions
The following elements are emphasized in the text:
Terms (on first occurrence);
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;
• Content storage and delivery;
• Content encryption;
• Billing;
• System setting and management;
• Receiving and reproduction of the content at the client side.
The main advantages of IPTV include its interactivity and a number of additional services,
such as: video on demand, time-shifted TV, network personal video recorder, electronic program
guide, virtual cinema. IP protocol abilities allow to provide a number of interactive services be-
sides just transmitting the video content.

5
IPTV_Complex_eng.book Page 6 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


NBS architecture
NBS (NetUP Business server) is a scalable platform for development of client-server applica-
tions used to build the NetUP.tv.
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.

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

NetUP.tv 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 NetUP.tv elements are connected in a cluster architecture. All
software is developed on basis of NetUP Business Server (NBS), a robust development platform
designed to support client-server applications of any complexity.

6
IPTV_Complex_eng.book Page 7 Friday, November 2, 2012 1:05 PM

Introduction
Interactions of the system’s main components are shown on the figure below.
Server part
open content
multicast

IPTV
core
CAS Streamers

Billing

open content
multicast
Load balancer Middleware
encrypted content + keys

VoD servers TVoD servers


multicast

unicast

unicast

End users
STB
RTSP Hotel STB PC client PC client
MPEG-TS STB
NXT
NBT

Figure 1. IPTV components and processes overview.

Different protocols are denoted by links of different color. System servers mostly interact
with each other via NXT protocol, and with client devices via NBT. Multimedia content is dis-
tributed using MPEG-TS protocol.

All system servers must interact with the outside world solely through their eth0 net-
work interfaces.

7
IPTV_Complex_eng.book Page 8 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

8
IPTV_Complex_eng.book Page 9 Friday, November 2, 2012 1:05 PM

SYSTEM COMPONENTS 2
Bundling options
NetUP.tv 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.<version num-
ber>.<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 figure below).

Figure 2. NetUP's IPTV Combine 4x.

The conditional access modules must be put into the slots upside-down, i.e. having the
manufacturer logo on the bottom side.
Note also that a pair of CAM slots is located in a single orifice.

• MW+Billing+VoD (firmware file firmware-complex.<version>.<build>) is a 1U


server containing Middleware, Billing, and VoD.
• MW+Billing (firmware file firmware-mw+billing.<version>.<build>) 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:
9
IPTV_Complex_eng.book Page 10 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Streamer
NetUP's Streamer receives live satellite, terrestrial channels, or cable TV (DVB-S/DVB-S2,
DVB-T, DVB-C, RF, ASI). Analog TV or radio channels are handled by real-time MPEG 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 79 and (whether appli-
cable) LCD panel on page 77.

Conditional Access System


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

The Amino AmiNET 125 STB does not support content decryption.

10
IPTV_Complex_eng.book Page 11 Friday, November 2, 2012 1:05 PM

System Components
The server encrypts and controls IP streams, creates encryption keys and manages subscrip-
tions.

Figure 3. NetUP's CAS scheme.

Video on Demand
NetUP's Video-on-Demand server is built on an industry-standard platform and supports over
100 concurrent non-encrypted streams (1000 subscribers at normal VoD peak take-up rate) at typ-
ical MPEG-2 compression rate of 4 Mb/s per stream. Both unicast and multicast modes are sup-
ported.

Figure 4. NetUP's VOD servers.

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.
11
IPTV_Complex_eng.book Page 12 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

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 normal operation of the Middleware and billing server, it must be working on the
round-the-clock basis. Turning it off at night would impede some low-priority service
tasks which are scheduled for that time.

For more info on Middleware system interface, see Middleware on page 21.

Billing
Billing system performs the following functions:
• subscriber database maintenance;
• rating of available services;
• creation and management of tariff plans;

12
IPTV_Complex_eng.book Page 13 Friday, November 2, 2012 1:05 PM

System Components
• creation of accounting documents;
• access cards management;
• financial reporting.
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 on page 30.

STB Client
Graphical user STB interface of NetUP.tv is designed with the use of native API, which pro-
vides an advantage in performance as compared to the browser-based interfaces.
NetUP.tv is compatible with set-top boxes of the following vendors:
• Amino Technologies (www.aminocom.com) – recommended option;
• Teletec (http://www.teletec.com.ua);
• 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 111.

13
IPTV_Complex_eng.book Page 14 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

14
IPTV_Complex_eng.book Page 15 Friday, November 2, 2012 1:05 PM

BASIC OBJECTS AND PROCESSES 3


This chapter describes the basic system objects and interactions thereof.

Media content
A media content is a system object containing record on some multimedia data source, which
may be a file or a stream. Media content may get united into media groups, and also may be 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: Media content on
page 22. Creation of media content of different types is described in Creating TV or TVoD con-
tent on page 55 and Creating VoD or nVoD content on page 59.

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 16). 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 15) and charging logic (see Charge-off details on page 16). Bonuses may be only
one-time.
Interface for working with services is described in Billing: Tariff plans on page 33 (for those
included in tariff plans), and in Additional services on page 34 (for the separate ones).

Attachment of se rvices
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 is the case if the Mandatory flag in the service properties is on), or may be
bought and paid for by the customers voluntarily.

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

15
IPTV_Complex_eng.book Page 16 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Content access
TV, TVoD, VoD, NVoD, and Radio services provide access to some media content. The access
is granted once the customer is charged for the service, and is valid during the time span for which
the customer has been charged.
Access may be discontinued prematurely in case if the customer’s account gets blocked, see
Personal accounts on page 18.

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

Char ge-off details


One-time services get the customer charged upon attachment. Similarly, bonuses are deposit-
ed to the client’s account upon attachment. As for the TV, TVoD, VoD, NVoD, Radio, and content-
free periodic services, the charging details are determined by their properties (see Tariffication
type). In case of TV services the tariffication type is defined explicitly upon creation. For TVoD
and Radio with automatic attachment, charging is made in a Periodic prepaid manner.
In fact, in the cases described above the actual bonus payment or service charge-off
is not made at the precise moment of service attachment or at the end of period, but
on the next general tariffication event after that. The said event repeats every hour.

VoD and NVoD services not attached by default are sold for a fixed time span (see STB Client
Interface: Viewing VoD on page 117) 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 18.

16
IPTV_Complex_eng.book Page 17 Friday, November 2, 2012 1:05 PM

Basic objects and processes


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

Tariff plans
A tariff plan is a set of services of various types that may be attached to a customer for some
time span (maybe forever).

Tariff plan having “forever” instead of the ending date can not contain services with
tariffication type “Full prepaid”.

At the end of the accounting period the customers may switch the attached tariff plans on
their own (see STB Client Interface: Personal account on page 119), given that the old and new
plans are compatible by the roles.
Interface for working with tariff plans is described in Billing: Tariff plans on page 33. Cre-
ation and editing of a tariff plan is described in Creating a tariff plan on page 66 and Editing a
tariff plan on page 67.

Customers
A customer is a system object containing record on an end user of the services provided and
charged for by the NetUP.tv.
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: Customers on page 31. Cre-
ation of a new customer record and subsequent operations with it are described in Creating a
user on page 62, Attaching a tariff plan on page 71, Changing a tariff plan on page 72, and Mak-
ing payment on page 75.

17
IPTV_Complex_eng.book Page 18 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Settlement accounts
Settlement accounts are created automatically for various operations. Depending in the type
of operation, a settlement account may have one of the following Types:
• Payment opens when a payment is made;
• Debt opens after balancing on closing the accounting period, if negative balance is revealed;
• Credit opens when a credit limit is changed;
• 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.

18
IPTV_Complex_eng.book Page 19 Friday, November 2, 2012 1:05 PM

UNITED CONTROL CENTER 4


United control center allows to configure the Middleware, VoD, Billing, and other systems.
This chapter covers the interface of UCC.
The UCC contains several systems (the specific composition may be version-dependent).
The system to work with is chosen immediately upon starting the UCC. To switch to another sys-
tem, you have to start another instance of UCC (see Common elements: Open connection be-
low).
General (i.e. not system-specific) features of UCC are described in Common elements. The
interfaces of particular systems are listed in the following sections:
• Middleware (page 21);
• Billing (page 30);
• nVoD (page 43);
• TVoD (page 46);
• DRM (page 48);
• IPTV Core (page 49);
• Payment systems (page 50).
Installation and working with the UCC are described in Usage examples on page 53.

Common elements
Connection window
The connection window shows up on starting the united control center. It allows the selection
of the system to connect to. The set of systems accessible via control center depends on its ver-
sion. In particular, the restricted version of control center that is distributed with streamers con-
tains only IPTV Core and Streamer.
In the bottom part of the connection window there are login and password fields for connec-
tion. Normally these parameters do not have to be entered manually, since the control center, once
installed properly, already contains them.
When several instances of the united control center are running simultaneously (even
if they refer to different systems, and even if some of them are mere connection win-
dows not yet connected to anything), only the settings and parameters of the last
closed instance are saved.

The top menu, the left pane with quick links, and the bottom status string displaying current
server time, server address, and connection status, are visible and accessible from any interface
page.

19
IPTV_Complex_eng.book Page 20 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Top me nu
Below is the description of top-level menu of the UCC.

System
• 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.
These internal properties may have a crucial influence upon the NetUP.tv, hence any
operation with them require thorough understanding of their nature and of possible
consequences. Improper actions may render the whole system inoperative.
• Show plug-in info shows info about the loaded plugins.

Options
• Time zone selects the current time zone.

Help
• Help contents gives a brief description of the given interface.
• About shows version info.

Left pane
Left pane of any interface provide quick links to main pages of this interface grouped by the
sort of entities they deal with. Besides that, the interface may include some auxiliary pages which
are not accessible via the left pane, but rather would open in a response to some actions on the ba-
sic pages.
Some pages are included redundantly in several interfaces for convenience (e.g. Media con-
tent may be found in Middleware and in Billing as well).

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

20
IPTV_Complex_eng.book Page 21 Friday, November 2, 2012 1:05 PM

United control center


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, some 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.

Middleware
The Middleware system has only one group of pages called Media which contains interfaces
to media groups, media content, media streams, and playlists.

Media
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 Media groups page displays the list of existing groups together with their parameters.

Figure 5. Media groups page.

The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.

21
IPTV_Complex_eng.book Page 22 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


The list of parameters include:
• ID (hidden by default);
• Mask (hidden by default);
• Name;
• Type.

The Add and Remove buttons for operations with media groups are available. Ed-
iting of groups is performed directly on the same page.
The attribution of content to either group can be performed via the Billing interface (see Bill-
ing: Media content on page 35). Creation of an example media group and dealing with it are de-
scribed in Creating a media group on page 61.

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 Media content page displays the list of existing
content units together with their parameters.

Figure 6. Media contents page.

The list of parameters include:


• Owner;
• State;
• Type;
• Media content code;
• Name;
22
IPTV_Complex_eng.book Page 23 Friday, November 2, 2012 1:05 PM

United control center


• Annotation;
• Description;
• Genres;
• Logo URL;
• Image URL;
• Duration;
• Language;
• Sound.

The Filter collapsible pane provides a way of filtering by name. There is also a drop-
down 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 button opens a page called New media content (page 26). Edit opens Edit

media content (page 26). Remove deletes the selected content without opening a special
page. The Program schedule button opens a page of the same name, see Program schedule
(page 27).
Creation of media content of different types is described in Creating TV or TVoD content on
page 55 and Creating VoD or nVoD content on page 59.

Media streams
Media stream is a record about a certain IP address or a pool of addresses from which a
streamer is broadcasting content into an IP network. Normally it has to be associated with some
media content.

23
IPTV_Complex_eng.book Page 24 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


The Media streams page displays the list of existing media streams together with their pa-
rameters.

Figure 7. Media streams page.

The list of parameters include:


• ID (hidden by default);
• Owner;
• IP;
• Port;
• Media content;
• Type;
• State.

The Filter collapsible pane provides a way of filtering by string search in all fields. The

TV , Radio , and NVOD buttons filter the list by type.

The Add , Edit , and Remove buttons for operations with media streams are

available. New media streams are created directly on the same page. Edit opens the page Me-
dia stream program (page 28).
The creation of media stream is described in Creating a media stream on page 57.

24
IPTV_Complex_eng.book Page 25 Friday, November 2, 2012 1:05 PM

United control center


Playlists
This page provides the means for management of running-line announcements shown on the
client TVs over the current program.

Figure 8. Playlists page.

Each announcement is characterized by:


• Name;
• State (active / stopped);
• Active since (void if not active);
• Next active since (date and time when it appears again);
• Current message (if active).

Pressing Add or Edit opens Playlist editing (page 28).

Remove removes the selected announcement.

25
IPTV_Complex_eng.book Page 26 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Auxiliary pages
New media content
The New media content page contains interface for entering the parameters of a new media
content item.

Figure 9. New media content page.

Edit media content


The Edit media content page contains interface for editing the parameters related to the se-
lected media content item.

26
IPTV_Complex_eng.book Page 27 Friday, November 2, 2012 1:05 PM

United control center


Program schedule
The Program schedule page contains interface for entering the telecasts schedule for the se-
lected item of TV content.

Figure 10. Program schedule page.

For each program line the following info is presented:


• ID (hidden by default);
• Media program code;
• Since (starting time);
• Duration;
• Title;
• Description.
Usage of program schedule is described in Creating TV or TVoD content, step 6 on page 56.

27
IPTV_Complex_eng.book Page 28 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Media stream program
The Media stream program page contains interface for viewing the properties of a media
stream and selecting the media content associated with it.

Figure 11. Media stream program page.

Playlist editing
On this page you may create a new running-line announcement or edit an existing one.

Figure 12. Playlist editing page.

Each announcement has a name, one or more scheduled appearances, and one or more con-
tent lines. Once the appearance time approaches, all lines are shown consecutively one after an-
other. Every line lasts on the screen for as long as specified by its duration.
If two announcements partially overlap, the latter one starts in its due time and the
former one is cut short. If the two are scheduled to start at the same time, the resulting
behavior is unpredictable.

28
IPTV_Complex_eng.book Page 29 Friday, November 2, 2012 1:05 PM

United control center


Appearances are listed at the top part of page. They
may be added with the Add button and removed with De-
lete . Addition is made via a dedicated window, where
you may specify the parameters of an appearance:
• Time; Figure 13. Appearance time editor.
• Day in one of the two forms:
° Date (for a single appearance);
° Day(s) of week (for repeated appearances).

Content lines may be added with Add , edited with Edit or by double-clicking, and

deleted with Remove . To move lines around, use Up and Down arrows.

29
IPTV_Complex_eng.book Page 30 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Billing
The Billing system interface pages are gathered into the following groups in its left menu:
• Customers (page 30) contains pages for working with customers and personal accounts.
• Tariffication (page 33) contains pages for working with tariff plans and additional services.
• Dictionaries (page 35) contains pages related to some general-purpose objects (in particular,
banks).
• Media (page 35) contains pages related to media content and media groups.
• Finance (page 35) works with the currency rates.
• Security (page 35) works with access cards.
• Reports (page 36) contans various reports.
• System (page 37) works with roles.

Properties for plug-ins


The Properties for plug-ins window (called from the top menu, see Top menu: Plug-ins on
page 20) of the Billing system contains among others the following parameters:
• available_currency_rates is the list of currency pairs for which the exchange rates are main-
tained (see Finance: Currency rates on page 35).
• currencies is the list of registered currencies (see the usage example Adding new currency
on page 73).
• personal_account_id_editable allows one to set the personal account ID manually upon cre-
ation (new accounts are created on the Personal account management page), if checked.
Otherwise the ID is assigned automatically.

Plugin properties not covered by this document are normally not to be changed.

Customers
Customers are records containing information about particular users together with their per-
sonal data and provided services.

30
IPTV_Complex_eng.book Page 31 Friday, November 2, 2012 1:05 PM

United control center


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

Figure 14. Customers page.

The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.

The list of parameters include:


• ID;
• Login;
• Name;
• Comments.
The following functional buttons are available:

• Add opens the customer creation wizard (see below).

• Edit opens Customer info (page 37).

• Remove deletes a customer.


• Personal accounts opens the Personal account management page, which is also accessi-
ble via the context menu or by double-clicking on a user in the list.
• Financial statement opens the page of the same name, which is also accessible via the
context menu..
• Make payment opens New payment (page 37), which is also accessible via the context menu.
31
IPTV_Complex_eng.book Page 32 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Customer creation wizard contains interface for entering the parameters of a new customer,
namely:
• Type (see Basic objects and processes: Customers on page 17);
• Login, password, group membership and arbitrary comments;
• Adress;
• Bank details;
• Other optional information.
The exact composition of interface fields depend on the customer’s type . Personal data, legal
entity details, addresses, and contacts are all entered within the wizard; bank data are entered on
the Banks page.
To remove customers, all their accounts must be closed in the first place. This can be done on
the Personal account management page.
Creation of a new customer record and subsequent operations with it are described in Creat-
ing a user on page 62, Attaching a tariff plan on page 71, Changing a tariff plan on page 72, and
Making payment on page 75.

Personal acounts
This page contains the list of personal accounts. For each account the following parameters
are presented:
• Account number;
• Access card number (hidden by default);
• Customer login;
• Tariff plan name;
• Current balance;
• Payments;
• Charges.
Double-clicking on a line in the list opens the Personal account information page for the
customer owning the selected account.

32
IPTV_Complex_eng.book Page 33 Friday, November 2, 2012 1:05 PM

United control center


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

Figure 15. Tariff plans page.

• ID (hidden by default);
• Name;
• State.

The Add , Edit , and Remove buttons for operations with tariff plans are avail-

able. Add opens the New tariff plan page. Edit opens Edit tariff plan (page 42).

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


Creation and editing of a tariff plan is described in Creating a tariff plan on page 66 and Ed-
iting a tariff plan on page 67.

33
IPTV_Complex_eng.book Page 34 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Additional services
Additional services displays the lists of existing additional services paid for in installments
or at once.

Figure 16. Instalments page.

The list of parameters for installments include:


• ID (hidden by default);
• Name;
• Price;
• Duration;
• Cost;
• State.
The list of parameters for paid-at-once services include:
• ID (hidden by default);
• Name;
• Price;
• State.

The Add and Remove buttons for operations with additional services are available.
Editing of services is performed directly on the same page.

34
IPTV_Complex_eng.book Page 35 Friday, November 2, 2012 1:05 PM

United control center


Dictionaries
Banks
This page contains the list of registered banks together with the interface to add, edit, and re-
move them. Banks are used for quick filling in bank details within customers properties.

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

Media content
The Media content page lists the existing media content units, like Middleware: Media con-
tent on page 22, though read-only. The context menu has an extra item named Edit groups which
open the Media content groups page.

Finance
Currency rates
The Currency rates page provides an interface to enter the exchange rates for predefined cur-
rency pairs to be used in internal calculations.

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.

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

The show/hide settings for particular parameters may be tuned via the Columns item
in the context menu.

The list of parameters include:


• Number;
• Term of validity;
• Organization;
• City;
• E-mail;
• PIN;

35
IPTV_Complex_eng.book Page 36 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


• Name;
• Role mask;
• State.

The Filter collapsible pane provides the options of filtering by name, by term of validity,
or by state.
Active access cards are emphasized in the list with green background color.

Activation codes
This page contains the list of activation codes, with the ability of generating new ones (see
Generating activation code on page 73). 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 ac-
tive codes simultaneously.

Activation requests
This page contains the activation requests counter grouped by IP address. After multiple at-
tempts to activate a card with wrong code, further attempts from the same IP may be blocked (see
Resetting activation requests counter on page 74).

Reports
Reports
On this page you may compose various reports. Report type is selected from a dropdown list
containing the following values:
• Report on charge-offs;
• Report on connections;
• Report on payments.
Time span covered by the report is also selected from a dropdown list and may be on of the
following:
• Current day;
• Yesterday;
• Manually.
If the latter option is chosen, the starting and ending dates of the report have to be entered
manually.

Accounting periods
This page contains the list of accounting periods. For each period, the numbers of settlement
accounts acting during that period, as well as those opened and closed during it, are presented.

36
IPTV_Complex_eng.book Page 37 Friday, November 2, 2012 1:05 PM

United control center


S ys t em
Roles
On this page you may create and edit roles presented in a form of a tree index. Roles are in-
tended for tariff plans and serve to define their compatibility.

Auxiliary pages
Customer info
This page contains interface for viewing and editing personal information of the selected cus-
tomer.

Figure 17. Customer info page.

New payment
This page contains interface for making a payment to the selected client’s account.

Figure 18. New payment page.

The interface consists of the following entry fields:


• Account number is a dropdown list for personal account selection, in case if the client has
multiple accounts.
• Amount is the payment amount in a currency selected from a dropdown list.
• Payment document is the optional number of the document which is the reason for the pay-
ment.
• Payment details is an arbitrary comment.

37
IPTV_Complex_eng.book Page 38 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Personal account management
This page contains interface for creating and closing personal accounts, as well as for assign-
ing tariff plans and additional services to the selected customer.

Figure 19. Personal account management page.

Personal accounts are created by the New button below the list of existing accounts. To
close an account, select the corresponding item (Close personal account) in the context menu.

Once closed, an account can never be reopened.

Tariff plans are attached and detached by the buttons New and Remove below the
list of activated tariff plans. When a plan gets detached, it stays in the list, but its end date changes
to the current date. If a new plan is attached to an account already having a plan, the old plan gets
detached automatically.

In order to be able to attach a tariff plan the account must be active.

The following functional buttons are available:


• Info opens the Personal account information page for the selected customer.

• Reverse entry opens the Reversing entry page for the selected account.

38
IPTV_Complex_eng.book Page 39 Friday, November 2, 2012 1:05 PM

United control center

• Show blocks opens Personal account blocks control.


• Tariff plans opens Tariff plans (page 33).
Details of charging for the services are explained in Basic objects and processes: Services
on page 15.

Personal account information


This page displays Personal accounts and Settlement accounts (see Settlement accounts
on page 18) of the selected customer.
The value in the Credit column of the personal accounts table defines the credit limit for the
given account. It may be changed manually.

Figure 20. Personal account information page.

Management button opens the Personal account management page for the selected cus-
tomer.

Personal account blocks control


On this page you may check the blocking state of the selected account, block the account, or
lift the manual blocking imposed earlier (see Personal accounts on page 18).

Reversing entry
This page displays charge-offs from the selected personal account for the given accounting pe-
riod. Any particular entry may be reversed, or edited post factum.

Financial statement
This page contains a financial statement for the selected customer. In the top of the page there
are dropdown lists for selection of the client and the accounting period, and also the Receive but-
ton that composes the report .
The report is split in several parts, each on a separate collapsible pane:
• Personal account balance shows opening and closing balance of the account, as well as the
difference between the two.
• Settlement accounts contains the listing of settlement accounts which were active during the
selected period.
• Tariff charges contains the information on provided services, including:
° Since (starting time);
° Till;
° Name;

39
IPTV_Complex_eng.book Page 40 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


° Quantity;
° Cost;
° Returned quantity (if any);
° Returned cost (if any).
• Blocks contains the info on account blockings.
• Financial operations contains the summary report on all operations, including:
° Date;
° Type (charge, transfer, or payment; also highlighted by background color);
° Proceed (incoming amount; relevant for payments and transfers);
° Charged (amount; relevant for charges);
° Description (in case of a charge for a service, contains the name of the latter);
° Volume of tarified service (quantity; relevant for charges);
° Unit of measure (relevant for charges).

Customer equipment
This page contains interface for introducing particular pieces of hardware associated with the
selected customer, as well as editing their parameters. Once the customer in question is assigned
with a periodic service with its Hardware management option switched on, the hardware man-
agement script(s) will be run on particular events, such as addition or blocking of the service.

Figure 21. Customer equipment page.

40
IPTV_Complex_eng.book Page 41 Friday, November 2, 2012 1:05 PM

United control center


New tariff plan
This page contains interface for entering the parameters of a new tariff plan, including the list
of services and their respective prices.

Figure 22. New tariff plan page.

Roles of the tariff plan may be set only by editing (see Edit tariff plan below), but not
upon creation.

Each service included in the tariff plan has a number of parameters, some of them common
for all types of services, others type-specific:
• ID;
• Service name (for content-free services);
• Media content name (for content-related services);
• Price of the service (see Services: Service price on page 15);
• Tariffication type that defines when the client is charged (see Tariffication type on page 16);
• Mandatory flag that enables automatic attachment of the service (see Attachment of servic-
es on page 15);
• Blockable flag that enables the service to get blocked when so is the client’s account (see
Customers: Personal accounts on page 18);
• State of the service (Active or Setting up).

41
IPTV_Complex_eng.book Page 42 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Edit tariff plan
This page contains interface for editing the parameters related to the selected tariff plan, in-
cluding the roles, list of services, and their respective prices. Before any changes are made, the
state of the plan should be switched to Setting up.

Media content groups


This page allows to attribute any content to some group.

Figure 23. Media content groups page.

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

42
IPTV_Complex_eng.book Page 43 Friday, November 2, 2012 1:05 PM

United control center


nVoD
Left menu of the nVoD system consists of a single group named Media which contains inter-
faces to nVoD content and its broadcasting schedule.

Media
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: Media groups on page 21),
while the attribution of media content to groups is made via Billing (see Billing: Media content
on page 35).

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

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

Virtual cinema
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.
Setting up broadcast schedule is described in the example Setting up nVoD program sched-
ule on page 60.

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

NetUP.tv Administrator’s Guide

Figure 24. Virtual cinema page.

Auxiliary pages
Schedules
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);
• First show time when the first show starts;
• Shows timeshift is the time delay between the two show starts;
• Shows total is the total number of shows per day;
• Last show is the starting time of the last show (calculated automatically);
• State is the state of the show.

44
IPTV_Complex_eng.book Page 45 Friday, November 2, 2012 1:05 PM

United control center

The Add record button adds new records to the list.

Figure 25. Schedules page.

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

45
IPTV_Complex_eng.book Page 46 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


TVoD
The TVoD system contain interface to the TV media content and associated streams for set-
ting up the recording of a stream.

Media
Media groups
The list of media groups similar to that in the Middleware interface (see Middleware: Media
groups on page 21) is included in the TVoD interface to have the quick access to the information
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: Media
content on page 22) is included in the TVoD interface to have the quick access to the information
on existing media content.

Media streams
The Media streams page displays the list of existing media streams similar to that in the Mid-
dleware interface (see Middleware: Media streams on page 23).

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.

Pressing Edit , Receiving, Dumping, or double-clicking on the list item opens the Media
stream dumping page (see below).

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:
° Media content;
° Media stream address;
° Size of record file(s);
° Record starting time;
° Record finishing time.
• Setting, Info, Control, Statistics contains interface to the selected stream similar to that on
the Media stream dumping page.

46
IPTV_Complex_eng.book Page 47 Friday, November 2, 2012 1:05 PM

United control center


Auxiliary pages
Media stream dumping
The Media stream dumping page contains interface for setting up the media stream record-
ing. The interface elements are grouped in the following blocks:

Figure 26. Media streams dumping page.

• Settings sets the auto refresh period;


• Info displays media content name, record files size and location, and graphical representation
of the time span(s) covered by the record;
• Control contains buttons for receiving and recording. Pressing Receiving starts or stops re-
ceiving of the stream, depending on the current state (while stopped, the Dumping button is
inactive). Pressing Dumping starts or stops recording of the stream.
• Statistics contains plot of stream bitrate vs. time.
Setting up the recording of a media stream is described in Setting up stream recording on
page 58.

47
IPTV_Complex_eng.book Page 48 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Media
Media streams
The Media streams page displays the list of existing media streams together with their pa-
rameters. The list of parameters include:
• ID;
• Owner;
• IP;
• Port;
• Media Content;
• Type;
• Protocol;
• State;
• Since;
• Till.

The Filter collapsible pane provides an option of filtering by string search. There are
also dropdown lists for filtering by stream type or by the state of the associated content.

The Add , Edit , Remove , Receiving, Broadcasting, and Encryption buttons


for operations with media streams are available. The last two may be active or disabled, depend-
ing on the current state of the stream.

Pressing Add opens the New media stream page. Pressing Edit , Receiving, Broad-
casting, or Encryption opens the Media stream encryption page.
Setting up the encryption of a media stream is included in Setting up stream encryption on
page 57.

Auxiliary pages
New media stream
The New media stream page contains interface for entering the parameters of a new media
stream.

Media stream encryption


The Media stream encryption page contains interface for setting up the media stream en-
cryption, as well as graphical representation of the bitrate.

48
IPTV_Complex_eng.book Page 49 Friday, November 2, 2012 1:05 PM

United control center

Figure 27. Media stream encryption page.

IPTV Core
Left menu of the IPTV Core system consists of a single group named Cluster which contains
the list of NetUP.tv components together with their status.

Cluster
Cluster systems
The Cluster systems page contains the list of NetUP.tv systems. For each system the follow-
ing parameters are presented:
• License number;
• System name;
• Server address;
• Server port;
• Type (function of the particular component in the cluster);
• Connection state (connected / not connected).
The License parameters collapsible pane at the bottom of the page displays limitations spe-
cific to the particular system, which are listed below.
• Billing: Maximum number of personal accounts.
• Middleware: Maximum amounts of simultaneous connections of PC clients and STB clients.
• VoD and TVoD: Maximum amount of simultaneous sessions.
• DRM: Maximum amount of simultaneously encrypted streams.
• Streamer: Maximum number of RF and DVB-S adapters.

49
IPTV_Complex_eng.book Page 50 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Payment systems
The system interface of Payment systems has a left menu consisting of two groups, namely
Settings and Reports.

Settings
External payment systems
This page contains the list of external payment systems.

Figure 28. Payment systems’ settings page.

For each system the following parameters are listed:


• URL by which the payment system is identified.
• Commission fee imposed by the payment system.
• Description of the payment system.
• Login, Password, Private key, Private password, Trusted public key are the parameters
used for authentication and encryption by some payment systems.
• Type of check of the payment parameters. Possible values are:
° Not specified implies the default value (Advanced);
° Standard implies checking of the necessary parameters only;
° Advanced implies checking of all parameters;
° External implies checking by an external utility.

50
IPTV_Complex_eng.book Page 51 Friday, November 2, 2012 1:05 PM

United control center


Reports
Payments report
This page contains the interface for composing reports on payments.

Figure 29. Payment systems’ reports page.

The Receive data pane contains controls for selecting payments by the following criteria:
• System type (ID of the system which has processed the request).
• Query type (payment precheck, new payment, revoked payment, unknown, or all).
• State:
° All states;
° Processed;
° Error.
• Time of payment.
• Filtering by text search. Filter mode may be set via the context menu as one of the following:
° All words;
° Exact phrase;
° Any word.
After pressing Select, a list of matching payments will appear. Each payment is described
with the following parameters (note that some columns may be hidden by default):
• ID of the payment in the database.
• Processed event ID in the database.
• Payment ID (external ID of the payment, if applicable).
• Payment number (external number of the payment, if applicable).
• Identifier of the personal account to which the payment is made.
51
IPTV_Complex_eng.book Page 52 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


• Payment instant which is the time when the payment has been registered by the system.
• Processed on which is the time when the payment’s processing has been finalized.
• Error description (if an error has occurred).
• Amount of the payment.
• Currency of the payment.
• Query type of the payment event.
• System type which is the ID of the payment system that has processed the request.
• State of the payment after processing.
If a payment is processed normally, its state is set to Processed, otherwise it is set to Error.
The Incoming event pane displays the comlplete set of parameters of the payment event re-
ceived from the payment system.

52
IPTV_Complex_eng.book Page 53 Friday, November 2, 2012 1:05 PM

USAGE EXAMPLES 5
This chapter contains typical scenarios of NetUP.tv usage (in addition to the general descrip-
tion of the UCC interface pages which is given in United control center on page 19). All actions
are performed via the interfaces of United Control Center (UCC) which itself is installed as de-
scribed in the first example Installing the UCC on page 53.
Initial setup of the NetUP.tv solution generally includes the following operations:
• Creation of content (see Creating TV or TVoD content on page 55, Creating VoD or nVoD
content on page 59, and Setting up nVoD program schedule on page 60);
• Creation of users (see Creating a user on page 62);
• Creation of tariff plans (see Creating a tariff plan on page 66 and Editing a tariff plan on
page 67);
• Activation of tariff plans (see Attaching a tariff plan on page 71 and Changing a tariff plan
on page 72);
• Making payments (see Making payment on page 75).

Installing the UCC

Before downloading the united control center, you have to upload (see License on
page 95) the security.tgz file obtained via the personal cabinet.

To install the united control center:


1. Upload the UCC installer iptv-ucc-install.jar to the administrator’s workstation
(i.e. the computer which will be used to control NetUP.tv). Installer is available for download
on the Files page of the web interface (see Web interface: Files on page 92).
To install and use the UCC, Java Runtime Environment (JRE) version 6.0 (Java 1.6.x)
or above is needed.
JRE distributive is available for free at http://java.com.

2. Start the installation by running the iptv-ucc-install.jar in one of the two ways:
° double-click on the file,
or
° in the folder containing the file, execute
java -jar iptv-ucc-install.jar

Language of the UCC installer, as well as that of the UCC itself, is set according to the
current system locale.

53
IPTV_Complex_eng.book Page 54 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


3. Select the directory to install the
UCC to. When installing over the
previous version (that is, into the
same directory), you may also want
to check the Copy settings option.

On Windows systems the installation


path must be selected so as not to
contain any non-ASCII characters.

4. Press Install to install the UCC to


the selected location.
Figure 30. UCC installation window.

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.

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.
6. On the first launch enter the address of the configuration file. The address will be saved, so
on the subsequent launches this step will be skipped.
7. On the first launch select the system to connect to. The selection will be saved, so on the sub-
sequent launches this step will be skipped.
8. If you want to change the configura-
tion file, press the link in the Sys-
tems configuration block and enter
the new address.
If you want to select another system,
press the link in the System <Name>
block and select the new system
from the list.
9. Press Log in. The control interface
window will open.

The computer must have valid system


date and time set, otherwise the sys-
tem may work incorrectly. Figure 31. UCC starting window.

54
IPTV_Complex_eng.book Page 55 Friday, November 2, 2012 1:05 PM

Usage examples
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 security.tgz file from the client’s
personal cabinet on www.netup.tv, upload it to the system’s web interface (see License on
page 95), and then download and install the united control center anew (see step 1).

Creating TV or TVoD content


To control the user’s access to TV channels broadcast by the streamer, a corresponding TV
content must be created in NetUP.tv. Below is a model pattern of creating a TV content, which
may be customized to meet particular circumstances.
1. Start the Middleware system interface from the UCC (see Middleware: Media content on
page 22 for interface description).
2. On the left pane open the Media group and select Media contents. The Media contents tab
with a list of existing contents will appear.

Context menu of any table contains the Columns item via which the user may hide or
reveal any column individually.

3. Press Add . The New media content tab will


appear.

4. Specify the following parameters of the media con- Figure 32. 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).
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 115)
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)

5. Press Apply . New TV content will show up in the list.

55
IPTV_Complex_eng.book Page 56 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


In any of the systems, if you are missing some items (media content, media groups,
etc.) created recently in another system, press Refresh in the context menu, or restart
the control interface.

6. Create the schedule of telecasts or make sure it is properly created automatically, as de-
scribed in Setting up telecasts program schedule on page 56.
7. Create a media stream of TV type in the Middleware system as described in Creating a me-
dia stream on page 57.
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.

Figure 33. Editing media stream.

8.2. In the Media content column select the newly created TV content.
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 57).
10. If the content is intended for TVoD service, set up its recording, as described in Setting up
stream recording on page 58.
Further likely appropriate actions are described in the examples Creating a media group on
page 61 and Creating a tariff plan on page 66.

Setting up telecasts program schedule


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

4. Press Apply to save the program schedule.


The schedule is intended to be displayed in the STB client interface (see Viewing TV
channels on page 115) along with the other channel-related information (descrip-
tion, etc.) during channel selection.
56
IPTV_Complex_eng.book Page 57 Friday, November 2, 2012 1:05 PM

Usage examples
As a rule, this action is a step of TV content creation (see Creating TV or TVoD content, step
6 on page 56), though may be performed independently later as well.

Creating a media stream


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

3. In the filter pane above the list press TV or NVOD , depending on the type of
streams you intend to create.
4. If creating a stream for TV:

4.1. Press Add to add new stream to the list.


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

Figure 34. TV media stream creation.

5. If creating a stream for VoD:

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 35. 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 56 and Creating VoD or nVoD content, step 8.2 on page 60).

Setting up stream encryption


1. Start the DRM system interface from the UCC (see DRM on page 48 for interface description).
2. On the left pane open the Media group and select Media streams. The Media streams tab
with a list of existing streams will appear.
57
IPTV_Complex_eng.book Page 58 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

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 76) and press Receiving. As the channel
starts receiving, the Broadcasting button turns ac-
tive. Figure 36. Media stream encryption.

Incoming and outgoing interfaces can not coincide.

5. Press Broadcasting. As the channel starts broadcasting, the Encryption button turns active
and the chart below starts to display the media stream bitrate.
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 56).

Setting up stream recording


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

Figure 37. Media streams dumping.

58
IPTV_Complex_eng.book Page 59 Friday, November 2, 2012 1:05 PM

Usage examples
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 76) and press Receiving. The
Record button will turn active, and the bitrate plot will start to appear under Statistics.

Only open (i.e. not encrypted) content may be recorded.

5. Press Dumping. The TVoD content will start recording, while the recorded portion will be
made available to the clients in the TVoD section of the STB interface. The size of record
files, as well as the graphical representation of time span(s) covered by the record, will be
displayed under Information.
As a rule, this action is a step of TVoD content creation (see Creating TV or TVoD content,
step 10 on page 56).

Creating VoD or nVoD content


To control the user’s access to the content stored on the VoD or nVoD server, a corresponding
VoD content must be created in NetUP.tv. Below is a model pattern of creating a VoD content,
which may be customized to meet particular circumstances.
1. Start the Middleware system interface from the UCC (see Middleware: Media content on
page 22 for interface description).
2. On the left pane open the Media group and select Media contents. The Media contents tab
with a list of existing content will appear.

3. Press Add . The New media content tab will ap-


pear.

Figure 38. VoD media content creation.

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


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

59
IPTV_Complex_eng.book Page 60 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

5. Press Apply . New VoD content will show up in the list.


6. Upload the media file to the VoD server via FTP (login is vod, password is similar to the
server administrator password, see Web interface: Security on page 97).
7. Bind the file to the content as follows:
7.1. On the Video processing page of the web interface (see Web interface: IPTV distribu-
tion on page 84) find the recently uploaded file in the list and press Distribute.
7.2. In the popup window select Use media content already registered in the IPTV complex
and press Next.
7.3. Select the newly created media content
from the dropdown list and press Dis-
tribute.
Alternatively, you may as well select the
first option (Create new...) and create a
new media content directly from the web in-
terface. Figure 39. Media content selection.

8. If the content is intended for nVoD service, do the following:


8.1. Set up the program schedule for it, as described in Setting up nVoD program schedule.
8.2. Create a media stream of NVOD type in the nVoD system (see Creating a media stream
on page 57). Unlike TV, these streams do not need to be associated with any content,
since the system enables them automatically as required.

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 61 and Creating a tariff plan on page 66.

Setting up nVoD program schedule


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

3. If necessary, scroll to other date by pressing and .

60
IPTV_Complex_eng.book Page 61 Friday, November 2, 2012 1:05 PM

Usage examples

4. Select the line corresponding to the day you need to set the shedule for, and press Edit .
The Schedules tab will appear.

5. Press Add to add a new line to the schedule.


6. Select the media content from the drop-
down list.
7. In the corresponding columns enter the
first show time, timeshift between shows,
and the total number of shows per day. Figure 40. Setting broadcast schedule.

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

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

Creating a media group


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

Figure 41. Media groups creation.

61
IPTV_Complex_eng.book Page 62 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

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

5. Press Apply . The new media group will be created.


6. To add content to the group, start the Billing system interface from the UCC.
7. On the left pane open the Media group and select Media contents. The Media contents tab
with a list of existing contents will appear.
The Filter input field provides the ability of filtering by name in one of the fol-
lowing regimes: All words, Entire phrase, or At least one word. The regime to apply
is selected via the context menu.

8. In the media content list, right-click on the con-


tent to be added to the new group. In the appear-
ing context menu select Edit groups.

Figure 42. Context menu


of the media content tab.

9. A Media content groups tab will show up with a list of


groups to which the content may be assigned. Items of
non-matching type are disabled.

10. Select the media group(s) to assign the content to and

press Apply . The content will be assigned to this


group. Figure 43. Media groups selection.

Following likely appropriate actions with the newly created media group are described in the
example Creating a tariff plan on page 66.

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: Customers on page 31 for in-
terface 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.

62
IPTV_Complex_eng.book Page 63 Friday, November 2, 2012 1:05 PM

Usage examples

3. Press Add to add new customer. The user creation


wizard will appear.

4. Select customer’s Type (either a Person or a Legal entity).


Figure 44. User creation wizard.

5. If the new user is a person:


5.1. Fill up the personal info. Press Next.
Contact info may consist of an arbitrary number of fields, each containing a phone or
ICQ number, or an e-mail address. New fields are added by clicking the link Add con-
tact link.

5.2. Enter Login, Password, and an arbitrary comment for the new user. Set the group mem-
bership. Press Next.
5.3. Enter the client’s passport data (optional) and press Next.
5.4. Enter the client’s registration address and press Next.
The Arbitrary address option on this and other steps implies entering the address in
a free form. If Address book is selected instead, the address is entered in a structured
form with existence checking.

Figure 45. Entering customer’s address.

5.5. Enter the client’s actual address or select the option Use registration address. Press
Next.
5.6. Enter the client’s mailing address or select another option to use one of the already entered
addresses. Press Next.
5.7. Enter the client’s bank details. Press Apply.

Below is the list of legal abbreviations you may encounter among the parameters:

TIN Tax payer identification number Relevant for persons

63
IPTV_Complex_eng.book Page 64 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

LLC Limited liability company


OJSC Open joint stock company
CJSC Closed joint stock company Relevant for legal entities
NAICS North American Industry Classification System
IEC Industrial Enterprise Code
SIC Standard Industrial Classification

6. If the new user is a legal entity:


6.1. Enter the organisation’s full name and short name. Press Next.
6.2. Enter Login, Password, and an arbitrary comment for the new user. Set the group mem-
bership. Press Next.
6.3. Enter the client’s legal address and press Next.
6.4. Enter the client’s bank details and press Next.
6.5. Enter the client’s optional parameters and contact info. Press Next.
6.6. Enter the client’s mailing address or select the option Use legal address. Press Next.
6.7. Enter the client’s actual address or select another option to use one of the already entered
addresses. Press Next.
6.8. Enter the data of the client’s employee in charge. Press Apply.
7. If the installed configuration of NetUP.tv allows to associate a user with some automatically
managed hardware:
7.1. Right-click the user in question in the list of users and select Customer equipment from
the context menu. The Customer equipment page will show up.

Figure 46. Customer equipment addition.

7.2. Enter Name, select Type, and set Equipment Parameters.

7.3. Press Apply to save the changes.


7.4. Later on, this customer must be assigned with a tariff that contains an additional periodic
service with its Hardware management option switched on (see Adding services to a
tariff plan, step 6 on page 70).
7.5. Also, the hardware management scripts are to be modified to include the treatment of the
newly added equipment.

64
IPTV_Complex_eng.book Page 65 Friday, November 2, 2012 1:05 PM

Usage examples
The scripts are located at /netup/iptv_billing/python/plugins/ and
called on the following events:
* block_hardware.py – service blocking (i.e. when the user is blocked, if the ser-
vice is set as Blockable);
* unblock_hardware.py – service unblocking;
* install_hardware.py – service activation;
* uninstall_hardware.py – service deactivation.
Log file of the scripts is located at /netup/log/python.log.
The most likely following action with the newly created user is described in the example At-
taching a tariff plan on page 71.
If you want to alter the customer’s personal data, select the customer’s name in the list and

press Edit .

Note that double-clicking on the customers list (unlike most other lists) does not open
the corresponding Edit page. Instead, it opens the Personal account management
page (see Billing: Customers on page 31).

The most likely following action with the newly created user is described in the example Cre-
ating a personal account on page 65.

Creating a personal account


Below is a model pattern of creating a new personal account.
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.

6. Press Apply to save the changes.

65
IPTV_Complex_eng.book Page 66 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


7. Unfold the collapsible pane Access Card Information and copy the activation code to hand
it over to the customer.

Figure 47. Access card information pane.

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

Creating a tariff plan


Below is a model pattern of creating a new tariff plan, which may be customized to meet par-
ticular circumstances.
1. Start the Billing system interface from the UCC (see Billing on page 30 for interface descrip-
tion).
2. On the left pane open Tariffication and select Tariff plans. The Tariff plans tab will show up.

3. Add new tariff plan. The New tariff plan tab will ap-
pear.
4. Enter the tariff plan name.
Figure 48. Creating tariff plan.
5. In the Roles field select one or several roles from the drop-
down list.
6. Add to the plan content items (see Adding content to a tariff plan on page 69), content
groups (see Adding content groups to a tariff plan on page 69), additional services (see
Adding services to a tariff plan on page 70) and/or bonuses (see Adding bonuses to a tar-
iff plan on page 71), according to your choice. It is recommended to add TV, VoD and nVoD
content via groups.

7. Press Apply to finalize the addition of services.


8. In the State dropdown list change the tariff plan state from Setting up to Active.

9. Press Apply to save the new tariff plan.


10. Close the New tariff plan page.
The most likely following action with the newly created tariff plan is described in the exam-
ple Attaching a tariff plan on page 71.

66
IPTV_Complex_eng.book Page 67 Friday, November 2, 2012 1:05 PM

Usage examples
Editing a tariff plan
Below is a model pattern of editing a tariff plan.
1. Start the Billing system interface from the UCC.
2. On the left pane open Tariffication and select Tariff plans. The Tariff plans tab will show up.

3. Select the plan you intend to alter and press Edit . The Edit tariff plan tab will appear.
4. In the State dropdown list change the tariff plan state to Setting up.

5. Press Apply to save the changes.

While in the Active state, the tariff plan is not editable (all interface elements on the
page are disabled).

6. Assign the roles to the tariff plan.


Roles assigned to the tariff plan are used to determine the compatibility between plans
which is required for user-induced plan switching (see STB Client Interface: Person-
al account on page 119). 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 69), content groups (see Adding content groups to a tariff plan on page 69), addition-
al services (see Adding services to a tariff plan on page 70) and/or bonuses (see Adding
bonuses to a tariff plan on page 71).

Figure 49. Editing tariff plan.

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.
67
IPTV_Complex_eng.book Page 68 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

While in the Active state, a service can not be removed.

9.2. Press Apply to save the changes.

9.3. Press Remove to remove the service.

9.4. Press Apply to save the changes.

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.

Creating an additional service


In addition to services that provide an access to some TV or VoD content for certain period of
time, you may want to create additional services which has to be paid for either at once or in in-
stalments. Below is a model pattern of creating a new additional service, which may be custom-
ized to meet particular circumstances.
1. Start the Billing system interface from the UCC.
2. On the left pane open Tariffication and select Instalments. The Instalments tab will show
up.
3. To create an additional service paid for by instalments:

3.1. Press Add below the Instalments list.


3.2. Enter the service Name and Duration.
3.3. Enter either Price per month or the total Cost of the service (once any of these two fig-
ures is entered, the other is calculated automatically).
3.4. Set the service State to Active.
4. Alternatively, to create an additional service paid for at once:

4.1. Press Add below the One-time services list.


4.2. Enter the service Name and Price.
4.3. Set the service State to Active.
5. If necessary, repeat the procedure to create more services.

6. Press Apply to finalize the addition of services.


7. Close the Instalments page.
The service(s) just created may be added to the customer’s tariff plan as described in the ex-
ample Attaching a tariff plan on page 71.
68
IPTV_Complex_eng.book Page 69 Friday, November 2, 2012 1:05 PM

Usage examples
Adding content to a tariff plan
To add content items one-by-one (i.e. if the media content is not gathered into groups):

Figure 50. Adding services.

1. In the Billing system interface, open the New tariff plan or Edit tariff plan window.
2. If you are editing an existing plan, set its State to Setting up and save changes.
3. Unfold the group corresponding to the media type of your choice (VoD services, TV servic-
es, etc.)

4. Press Add in this group to add new content item.


5. Fill the columns:
Column Description
Media content Media content to be included in the plan (select from the list).
Price Price of the service
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 115 for details.

As a rule, this action is a step of Creating a tariff plan on page 66 or Editing a tariff plan on
page 67.

Adding content groups to a tariff plan


If the content is gathered into groups (see Creating a media group on page 61) you may add
groups to the tariff plan as follows:
1. In the Billing system interface, open the New tariff plan or Edit tariff plan window.
2. If you are editing an existing plan, set its State to Setting up and save changes.
3. Unfold the group corresponding to the media type of your choice (VoD services, TV servic-
es, etc.)
69
IPTV_Complex_eng.book Page 70 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


4. Unfold VoD Tariff templates or an analog with other content type.

5. Press Add to add a line into the table.


6. Fill up the columns:
Column Description
Media group Media content to be included in the plan.
Price Price of the service

Note that each table containing a column for price or price-per-period is also
equipped with a context menu item named Units that displays a list of currencies. If the
currency you intend to use is absent, expand the list as described at Adding new cur-
rency on page 73.

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 66 or Editing a tariff plan on
page 67.

Adding services to a tariff plan


To include additional services to a tariff plan:
1. In the Billing system interface, open the New tariff plan or Edit tariff plan window.
2. If you are editing an existing plan, set its State to Setting up and save changes.
3. Unfold the group One-time services or Periodic services.

4. Press Add in this group.


5. Fill the columns, including Service (name of the service), Price, and State (Active). The
meanings of check boxes Mandatory and Blockable are similar to those for the content
items, see step Adding content to a tariff plan, step 5 on page 69.
6. For periodic services, consider also the Hardware Management check box. If checked, it in-
vokes execution of the corresponding hardware management script on certain events. To em-
ploy this functionality, one must set the parameters of customer’s equipment beforehand (see
Creating a user, step 7 on page 64).

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

As a rule, this action is a step of Creating a tariff plan on page 66 or Editing a tariff plan on
page 67.

70
IPTV_Complex_eng.book Page 71 Friday, November 2, 2012 1:05 PM

Usage examples
Adding bonuses to a tariff plan
To include bonuses to a tariff plan:
1. In the Billing system interface, open the New tariff plan or Edit tariff plan window.
2. If you are editing an existing plan, set its State to Setting up and save changes.
3. Unfold the Accruals group.

4. Press Add to add new bonus.


5. Fill the columns, including Service (name of the bonus), Price (which in this case actually
contains the bonus sum, i.e. the sum that is added to the client’s account), and State (Active).
The meanings of check boxes Mandatory and Blockable are similar to those for the content
items, see step Adding content to a tariff plan, step 5 on page 69.
As a rule, this action is a step of Creating a tariff plan (page 66) or Editing a tariff plan
(page 67).

Attaching a tariff plan


Below is a model pattern of attaching a tariff plan to a user, which may be customized to meet
particular circumstances.
1. Start the Billing system interface from the UCC.
2. On the left pane open the Customers group and select Customers. The Customers tab will
show up (see Creating a user on page 62 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 66.)

Figure 51. Tariff plan selection.

4.3. Set the Start date and End date values for the tariff plan, or leave the default values
(“now” and “forever”, correspondingly).

71
IPTV_Complex_eng.book Page 72 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Start date of the tariff plan can not be set to the moment in the past.
Note also that the users are capable of switching tariff plans at their own will (see STB
Client Interface: Personal account on page 119), so that the new tariff plan may no
longer be a subject to the end date limitation.

5. If you want to add some additional services not included in the tariff plan:

5.1. Press Add in the Additional services collapsible pane.


5.2. Select the service from the dropdown list. (The service should be created beforehand as
described in Creating an additional service on page 68.)
5.3. Enter the Start date value. (If the service belongs to Installment, the End date value will
be assigned automatically based on the payment duration).
5.4. If necessary, repeat 5.1–5.3 to add more one-time services.

6. Press Apply to save the changes.


7. If necessary, repeat the procedure to define alternative tariff for other period.
Further operations are described in the examples Changing a tariff plan on page 72 and Mak-
ing payment on page 75.

Changing a tariff plan


Below is a model pattern of changing a tariff plan attached to a user, which may be custom-
ized to meet particular circumstances.
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 assign the tariff plan and press Personal account
management button (or a similar context menu item). The Personal account management
tab will appear.
4. Select the active account.
5. In the Activated tariff plans
list select the currently en-
abled plan and press Disable

. Figure 52. Disabling a tariff plan.

6. Press Apply to save the changes.

While the tariff plan is enabled, it is impossible to set up another plan covering the
same or overlapping time span.

72
IPTV_Complex_eng.book Page 73 Friday, November 2, 2012 1:05 PM

Usage examples

7. Press Add in the Activated tariff plans collapsible pane.


8. Set the start and end dates for the new plan.
9. Select the new plan from the dropdown list.

10. Press Apply to save the changes.

Adding new currency


UCC may perform accounting operations in any existing currency, but only a few are visible
by default. To alter the list of currencies:
1. Start the Billing system interface from the UCC.
2. From the top menu select Plug-ins, then Edit properties for plug-ins. The Properties for
plug-ins window will appear.

Figure 53. Plugins’ properties window of Billing interface.

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.

Generating activation code


When using the access card for the first time, the user must enter the activation code obtained
from the IPTV provider. Normally the activation code for an account may be read on the Person-
al accounts management page after the creation of the said account (see Creating a personal
account on page 65). In case if an additional code is required, it may be created as follows.

73
IPTV_Complex_eng.book Page 74 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


1. Start the Billing system interface from the UCC.
2. On the left pane open the Security group and select Activation codes. The Activation
codes tab will show up.

3. Press Add in order to add a new line to the list of activation codes.
4. In the newly created line under the Access card number enter the number of access card
which needs to be activated.

Figure 54. Activation code generation.

5. Press Apply to generate and save the activation code.


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

Resetting activation requests counter


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

74
IPTV_Complex_eng.book Page 75 Friday, November 2, 2012 1:05 PM

Usage examples
4. Set the Counter value to 0.

Figure 55. Activation requests page.

5. Press Apply to save the refreshed counter value.

Making payment
To view the IPTV content, a user must have above-zero balance. Below is a model pattern of
making a payment.
1. Start the Billing system interface from the UCC.
2. On the left pane open the Customers group and select Customers. The Customers tab will
show up.
3. Select the customer to whom you intend to
make a payment and press Make payment
button (or a similar context menu item). The
New payment page will show up.
4. If the selected customer has several accounts
associated, selected the necessary one via the
dropdown menu.
Figure 56. Making payment.
5. Enter the amount of payment.
6. Select the payment currency, if applicable.

7. Press Apply to make the payment.

Now the services included in the 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 67 and
Changing a tariff plan on page 72.

75
IPTV_Complex_eng.book Page 76 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 57. Plugins’ properties window.

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.

76
IPTV_Complex_eng.book Page 77 Friday, November 2, 2012 1:05 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 58. 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 59. CPU usage monitor.
data from the peripherals (w). Pressing Down switch-
es back to the traffic statistics screen.

Network interfaces setup


The LCD panel contains interface for setting up
network parameters, i.e. IP address and subnet mask.
To do that, press Fn, then Enter on any statistics
screen. The network configuration screen will appear. Figure 60. Network configuration.
By pressing Up and Down select the network inter-
face to be set up.
After selecting the interface you want to set up, press Enter. Then you will be prompted to
change current IP address for the selected interface.
Pressing Fn, then Up or Down selects the byte to
change (at that, ">" points to the currently selected
byte). Pressing Up and Down, correspondingly, in-
creases and decreases the selected byte value by 1. Figure 61. IP address setup.

77
IPTV_Complex_eng.book Page 78 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


When you are done with the IP address, press En-
ter. Then you will be prompted to enter the subnet
mask. It is entered by pressing Up or Down, which in-
creases or decreases the number of bits in the mask
Figure 62. Subnet mask setup.
determining the subnet address.
After entering the subnet mask, press Enter. Then
you will be prompted to keep the changes just made or
cancel them. Buttons Up and Down switch between
Yes and No, with currently selected option empha-
Figure 63. Save changes screen.
sized with brackets. Select Yes to save the settings just
made, or press Enter to proceed back to the network interface selection screen.
When the settings are done, set up your DNS server (via its config file) to associate the
IP address just entered with mw.netup domain name.

78
IPTV_Complex_eng.book Page 79 Friday, November 2, 2012 1:05 PM

WEB INTERFACE 7
Introduction
Web interface is intended for setting up various server parameters of NetUP.tv servers and
STB clients.
Left pane of the web interface remains 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 and on the access privileges
of the administrator currently logged in.
1. Contents group (present only on Middleware servers):
° Television (page 80) for the TV content descriptions management;
° Video (page 81) for the VoD content descriptions management;
° Languages (page 81) for the management of languages used for content descriptions;
° Advertising messages (page 82) for the management of advertising messages;
° EPG (page 82) for importing EPG;
2. Virtual cinema group (present only on nVoD servers):
° Schedule (page 83) for setting up nVoD content shows;
° Broadcasting streams (page 83) where the media streams usage data are listed;
3. IPTV distribution group (present only on IPTV Core servers):
° Video processing (page 84) for controlling IPTV content distribution;
° Master storage (page 84) where the media content items are listed;
4. DVB adapters group (present only on streamers):
° DVB adapter (page 85) to control the streamer itself
(by the number of adapters);
5. IPTV group (present only on streamers):
° Billing (page 87) for integration with third-party billing;
° Multicast to unicast (page 87) to control the retranslation of selected multicast streams
via unicast;
° SNMP (page 88) for setting up SNMP;
6. Set Top Boxes group (present only on Middleware servers):
° STB management (page 89) for setting up firmware upgrades for STVs and for manual
adjustment thereof;
° Styles (page 91) to control IP STB client user style;
° Translations (page 91) to control IP STB interface language;

79
IPTV_Complex_eng.book Page 80 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


7. System administration group:
° Files (page 92) for downloading the united control center, documentation, and miscella-
neous STB-related files;
° Backup (page 92) containing system backup interface;
° Power Management (page 92) for reboot and shutdown;
° Update (page 93) for NetUP.tv firmware upgrade;
8. System configuration group:
° Date and time (page 93) containing date and time settings;
° Fidelio (page 94) for setting up Fidelio parameters (present only in Fidelio-integrated con-
figurations, see STB Client Hotel Edition on page 125);
° License (page 95) for uploading the keystore file;
° Network (page 95) for network interfaces settings;
° Routing (page 97) with routing table;
° Security (page 97) for password management;
° Services (page 97) for manual start and stop of services;
° Tunneling & IGMP (page 98) for manual start and stop of tunneling and multicast routing;
9. System status group:
° About (page 98) showing version information;
° Connected clients (page 98) showing the clients’ connections to the system;
° Connections (page 98) showing connections between system components;
° Storage (page 99) displaying disk space usage.

Starting web interface


To enter the web interface, type http://<server IP address or domain name> in your brows-
er’s address field. An entrance page will appear. Logging in requires the password which is pro-
vided in the equipment certificate.

It is strongly recommended to change the password immediately after logging in for


the first time. This can be done via the Security page (see Security on page 97).

Contents
Television
This page contains the list of TV content. For each content item the following actions are pos-
sible:

80
IPTV_Complex_eng.book Page 81 Friday, November 2, 2012 1:05 PM

Web interface

Figure 64. Television page.

• By clicking the Rename button you may enter the channel name in all languages available;
• By clicking Settings you may enter the multicast broadcast address or the URL for unicast
transmission, and also upload the channel logo (from a local file or a remote URL; scaled to
standard size upon loading).

V id e o
This page contains interface elements for entering the multi-language descriptions and logos
for VoD content, in a manner similar to that on Television page.

Figure 65. Video page.

Languages
On this page you may alter the list of system languages used when entering content descrip-
tions on the Television and Video pages.

81
IPTV_Complex_eng.book Page 82 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Adve rtising messages
This page provides interface for management of advertising messages. At top of the page
there is the schedule of shows for the oncoming week. Clicking the link Add show creates a new
show. Below is the list of messages with addition (see the Add message link) and editing en-
abled.

Figure 66. Advertising messages page.

On each show all messages are scrolled on the screen one by one, in the same order as they
are presented on this page. Each message stays on the screen for the certain period of time which
is specified during its creation and also displayed in the list. The messages in the list are capable
of drag-and-dropping by the handle for reordering.

EP G
On this page an EPG in XMLTV format may be uploaded from a local file or from an FTP or
HTTP URL.

Figure 67. EPG page.

In the latter case, from that point on the EPG will be updated from the same address according
to the customizable schedule (by default, weekly).

Uploading the EPG by FTP is done in active mode, which has to be supported by the
router, in case if the NetUP.tv server is connected to internet via NAT.

82
IPTV_Complex_eng.book Page 83 Friday, November 2, 2012 1:05 PM

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

Figure 68. EPG file parsing.

Virtual cinema
Schedule
This page contains interface for managing nVoD shows. All shows within a three days frame
are listed in the table. The frame itself may be moved by the means (and within the bounds) of
calendar, which covers the forthcoming week. For every nVoD content item there is a list of

scheduled shows for each day, or the symbol, if there are no shows yet. Pressing or a link
of an existing show lets you to enter or edit the schedule of shows for the day, which is given in
a form of the following three parameters: starting time of the first show, total number of shows
and interval between them. For each day within the frame, the table also contains statistics of
shows, including their total number and the maximum number of simultaneous shows.

Figure 69. Schedule page.

Broadcasting streams
This page contains the list of subnets used to issue IP addresses for multicast transmissions,
and also the statistics of free and used streams.

83
IPTV_Complex_eng.book Page 84 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


IPTV distribution
Video processing
The Video processing page displays the list of media files together with their status. Once
uploaded by FTP, a file receives status New movie. While on the different steps of processing, it
switches through Encoding, Indexing, and Distributing. Files ready for broadcasting have their
status set to Distributed.
The Distribute button starts the distribution process which comprises the following steps:
1. If the file has not yet been connected to any
content, a popup window will appear prompt-
ing either to link this file to an existing content,
or to create a new one.
Figure 70. Linking a file to media content.

° If the Create new media content op-


tion has been chosen, the popup win-
dow will display entry fields for its
code, name, and genre.

° Otherwise a window will display the list


of existing media content to select one
item and link it to the file. Figure 71. Media content creation.

2. When the file is already linked to the


content, pressing Distribute would open
a popup window of recoding options. On
the first step select the audio streams to
be used. Then select the video conver-
sion profile.

3. After selecting a profile, the file gets re-


coded, indexed, and uploaded to all VoD
servers in the system. Figure 72. Video profile selection.

Master storage
This page contains the list of VoD servers. The View button next to the server name opens the
Video Storage Content page for the corresponding server, which displays the list of uploaded
media content files.

84
IPTV_Complex_eng.book Page 85 Friday, November 2, 2012 1:05 PM

Web interface
DVB adapters
This group contains pages for controlling DVB adapters, one for each adapter.

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

Figure 73. Adapters and CAM slots arrangement on the rear panel of NetUP streamer.

DVB adapter
Each adapter-controlling page contains several groups of interface elements.

Figure 74. Adapter control page.

DVB-S adapter
At the top line of the page there are signal level monitor and the five adapter state indicators:
• SIGNAL denotes presence of the signal (red means no signal);
• CARRIER denotes presence of the carrier frequency (red means no carrier);
• FEC denotes error correction;
• SYNC denotes synchronization with the signal;
• LOCK means that the adapter has locked on the signal and is decoding it successfully.

85
IPTV_Complex_eng.book Page 86 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


If the system works correctly, all indicators show green lights. Red lights on some indicators
mean that the signal is missing or corrupted.
Below follows the adapter parameters. These parameters may be changed only when the
adapter is stopped.
• State (shown in the group header, repeated by the icon on the left pane) may be either Ac-
tive or Stopped.
• Standards is the adapter type;
• Frequency is the incoming signal frequency in MHz;
• Symbol Rate is the rate of symbol transfer;
• Polarization is the polarization type;
• LNB type selects LNB type from the predefined list. Once it is selected, the corresponding
values of LNB parameters (LNB low frequency, LNB high frequency, and LNB switch fre-
quency) appear in their fields.
• LNB low frequency is the LO frequency for the low-frequency range of satellite signal. (See
http://www.netup.tv/en-EN/articles/streamer-configuration-guide.php for the particular
values.)
• LNB high frequency is the LO frequency for the high-frequency range of satellite signal.
• LNB switch frequency is the border between satellite signal frequency ranges.
• Tone enables controlling the LNB by feeding a special 22 kHz tone to it;
• Manage multiswitch enables the selection of:
° Ports group (a DiSEqC protocol parameter).
• Profile shows which of the saved profiles is currently applied.
• Load (active when the adapter is stopped) loads another settings profile.
• Start (active when the adapter is stopped) starts the adapter.
• Stop (active when the adapter is running) stops the adapter.

Note that stopping a service would stop transmitting video stream to network from this
adapter.

CAM
• CAM state (shown in the group header) is the state of the CAM (Active / Stopped).
• Mode switches the encryption mode between Usual and DRE crypt.
• Supported CAS is the list of supported conditional access systems.
Menu button opens the popup window with CAM settings.
If there is no CAM on this adapter, the group header switches to “No CAM” and the group it-
self is empty.

Channels
This group contains the list of received programs. For each program it contains:
• ID of the program;

86
IPTV_Complex_eng.book Page 87 Friday, November 2, 2012 1:05 PM

Web interface
• Program name (by clicking the link program parameters are shown, including the ONID and
channel name);
• Media content related to this program (or <no content> link if there is none; by clicking the
link, a new media content may be created);
• PIDs of audio, video, and auxiliary streams.
By clicking the link a popup window shows
up where individual streams may be switched
on and off (this may be relevant for channels
with multiple audio tracks);

Figure 75. Streams control window.

• Transmission state of the program (broadcast / no broadcast, scrambled / open content);


• Broadcasting IP of the program (or <no ad-
dress> if there is none). By clicking the link
the IP addresses may be added, removed or
modified.

Figure 76. IPs control window.

IPTV
Billing
In case you are using a third-party billing rather than the original component from NetUP, this
page contains an input field for its IP address.

Multicast to unicast
On this page any multicast channel may be retranslated as unicast.

Figure 77. Multicast to unicast page.

Once configured, the retranslated channel gets accessible by the URL http://<server
address>:8180/stream?ip=<channel IP>&amp;port=1234. Meanwhile, the com-
plete list of retranslated channels and their addresses is available at http://<server
address>:8180/channels as an XML file of the following format:
<?xml version="1.0" encoding="UTF-8"?>
<channelLists>

87
IPTV_Complex_eng.book Page 88 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


<timestamp>1327324533</timestamp>
<channelList>
<name>All channels</name>
<channel>
<name>Channel 1 (228.110.1.1)</name>
<address>http://10.1.0.121:8180/stream?ip=228.110.1.1&amp;
port=1234</address>
<id>7c1342b67c4ed50f361aa045acf0e4f9</id><type>tv</type>
<quality>SD</quality>
<encrypted>no</encrypted>
</channel>
</channelList>
</channelLists>

SNMP
This page contains the list of communities entitled to make SNMP requests. For each com-
munity the corresponding view and IP address are provided. Communities may also be added or
removed. A MIB file describing the available information can be downloaded on this page.
The NetUP’s MIB file contains a template for the variables which are listed below, with ex-
planation.
For each CPU in the system:
• netupCpuIndex is the CPU number;
• netupCpuLoad is the CPU load level;
• netupCpuTemp is the CPU temperature.
For each data storage in the system:
• netupStorageIndex is the storage number;
• netupStorageDevice is th path to the storage (for example, "/dev/sda1");
• netupStorageMountPoint is the mounting point of the storage (for example, "/mnt/hdd");
• netupStorageFilesystem is the file system of the storage;
• netupStorageBlockSize is the block size on the storage;
• netupStorageFragmentSize is the fragment size on the storage;
• netupStorageSize is the storage size;
• netupStorageFree is the free space on the storage.
For the system as a whole:
• netupMemPhisTotal is the total memory size;
• netupMemPhisFree is the free memory size;
• netupMemPhisBuffers is the buffer size;
• netupMemPhisCached is the cache memory size;
• netupMemSwapTotal is the maximum size of the swap file;
• netupMemSwapFree is the free space within the swap file;

88
IPTV_Complex_eng.book Page 89 Friday, November 2, 2012 1:05 PM

Web interface
• netupStbClients is the number of connected STB clients;
• netupPcClients is the number of connected PC clients;
• netupTotalClients is the total number of connected clients.
To request all available parameters, download the MIB file, pass it to the SNMP daemon, and
run the following command:
snmpwalk -v2c -c netuptest 10.1.0.77 NETUP-MIB::netup

Set Top Boxes


STB management
This page provides controls for managing STBs. In particular, this includes upgrading the
STB firmware and setting up the automatic upgrade service. The page contains the list of available
STB models with the following information and interface elements for each of them:
• STB type;
• Manage provides a list of commands to be sent to some STBs:
° Reboot STB;
° Upgrade STB firmware which implies upgrade of the file system only;
° Restore STB firmware which upgrades the bootloader (if applicable) and erases all stored
parameters, so the STB requires reactivation afterwards.
° Change STB resolution which is available only for Amino AmiNET 130 and Amino Ami-
NET 129/140 and, once selected, produces a popup window for setting the desired reso-
lution with options SD, HD720 (for both models), and HD1080 (for 129/140);
Once a command is selected, it may be sent either to multicast or to unicast IP. If the Send to
all flag is set, the command is sent to multicast address specified in Configure; otherwise,
the unicast address entered in the same popup window is used.
• Configure button opens a popup window with
the firmware distribution settings and the in-
terface for changing thereof. The parameters
are listed below. Note that the exact set of pa-
rameters depend on the specific STB type.
Pressing OK saves the changed parameters.

The firmware update system is intended solely


for the distribution of new firmware provided
by NetUP.
Figure 78. Configuration window.

• Interface is the network interface for sending firmware updates;

89
IPTV_Complex_eng.book Page 90 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

Figure 79. STB Management page.


• Multicast IP is the IP address and port for sending firmware updates;
• Management IP is the multicast IP address for sending commands to all STBs;
• TTL is the time-to-live of a multicast packet in hops;
• Current version is the serial number of new firmware to be distributed.
These serial numbers serve for the sole purpose of maintaining 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.
• Distribution is the firmware distribution status indicator (ON/OFF) which is also a switch but-
ton to toggle it on and off.
Exact sets of parameters for particular STB types are specified below:
• Amino AmiNET 110, 125, 130 are as described above, except for the fact that the firmware
upgrade is sent by two different IP addresses and port numbers in two parts, namely the boot-
loader bootstrap.signed and the filesystem image mc2.mcfs, and the following ad-
ditional parameter:
° Min required version which is the minimal compatible version number, so if the current
version number is lower than that, the STB is bound to upgrade.
• Amino AmiNET 129/140 are as described above.
• D-Link DIB-120 are as described above, only the firmware upgrade consists of three parts
havnig separate version numbers and separate flags to control uploading.
• Telergy T502 has only the version number to set.
• TeleTec (also known by the brand name Intercross) MAG-200 and MAG-250 are as de-
scribed above, only the firmware upgrade consists of two parts (bootstrap and upgrade)
having separate IP addresses and ports and not having version numbers at all.

90
IPTV_Complex_eng.book Page 91 Friday, November 2, 2012 1:05 PM

Web interface
S ty l es
Styles page contains the list of user styles for IP STBs.

Figure 80. Styles page.

Following control buttons are available:


• Add opens the window for uploading new
style in RCC format (see Updating user
theme on page 102 for info on creating user
styles).
• Compile opens the window for uploading
new style in a zip archive with simultaneous
compilation into RCC.
• Get source downloads the source files of cur-
rent style as a zip archive.
• Remove (in the list of styles) removes the
Figure 81. Create style window.
corresponding style.

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

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

91
IPTV_Complex_eng.book Page 92 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


System administration
Files
This page contains the download links for various
auxiliary files, including:
• Documentation in a single PDF file;
• Administration interface AKA the united control
center. Guidelines for starting the control center and
further operations with it are listed in Usage exam-
ples (page 53).
Before downloading the united control center, you
have to upload the security.tgz file obtained via
the personal cabinet (see License on page 95). Figure 82. Documentation page.
• Firmware sources from NetUP for various STBs and
some tools for working with them. The development tools for modifying firmware should be
requested from the manufacturer, as well as the means of downloading it to the STBs. The
downloading mechanism (see STB management on page 89) is intended solely to distribute
the new builds of NetUP STB firmware and not their custom modifications.
This page is present only on IPTV Core servers.

Backup
This page provides control interface for system backups. Create button creates an archive in
*.tar.bz2 format containing system settings; also, an automatic backup is made every day.
Existing backup files together with their creation dates are listed in the table. Delete button next
to a file removes it.

Figure 83. Backup page.

This page is present only on IPTV Core servers.


More details on creation and usage of backups may be found at Backup copies on page 147.

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.

92
IPTV_Complex_eng.book Page 93 Friday, November 2, 2012 1:05 PM

Web interface
Update
This page lists the uploaded firmware files together with their uploading dates, build num-
bers, and possible actions.

Figure 84. Update page.

This page allows to update the NetUP.tv firmware. To do that, upload the new firmware file
to the server via FTP (login: update; password is similar to the server administrator password, see
Security on page 97), refresh the page to reveal it in the list, and press Install.
Firmware files of incompatible versions may be falsely interpreted as corrupted. In
particular, this is the case for the firmware files of version 1.6 once the system has been
upgraded to version 1.7.

System configuration
Date and time
Date and time page contains the interface for setting the time zone.

Figure 85. Date and time page.

In the NTP servers section one may add or remove the NTP servers to synchronize with.
New items get added to the end of the list.
The Status column lists the current status of the servers:
• Failed if the last sync attempt has failed;
• Sync if the sync has been performed successfully;
• Reserved if this time server has not been used yet.

93
IPTV_Complex_eng.book Page 94 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Synchronization occurs once per hour. The servers are tried in presented order till the first
success.
This page is present only on IPTV Core servers.

F i d el i o
This page contains interface for entering Fidelio parameters, including:

Figure 86. Fidelio page.

• Fidelio IP address;

Port number for connection to Fidelio is hardcoded as 5010 and must be set up ac-
cordingly in Fidelio itself.

• Housekeeping password (to be entered by hotel personnel on the Hotel info screen, see STB
Client Hotel Edition: Services on page 132);
• Welcome page;
• Info page.
• Extra files containing auxiliary files for these pages (images and CSS).
The welcome and info pages are displayed on the client’ STBs, correspondingly, as Welcome
and Hotel info screens. Welcome page is a HTML file that may contain templates
@FIRST_NAME@, @MIDDLE_NAME@, and @LAST_NAME@, which get replaced by the
parts of the client’s full name before display. Info page is just a HTML file. Both may exist in
multiple language versions, which may be uploaded or deleted on this page.
The images and style files included in the pages should be referenced via a handler script
rather than directly. For example, once you have uploaded tip.png into Extra files, its local
URL for using in HTML is:
extra.php?file=tip.png

94
IPTV_Complex_eng.book Page 95 Friday, November 2, 2012 1:05 PM

Web interface
Lice nse
This page contains interface for uploading the security.tgz file (so-called license ar-
chive), which is required for working with STBs and the admin interface. This 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 upon each update of the
system’s components.

The license archive must be uploaded prior to the downloading of the united control
center (see Files on page 92).

Once the license archive is uploaded, this page displays detailed license information, includ-
ing the date of validity, list of optional components, and the limitations thereof.

Networ k
Network page gives the full list of installed network adapters together with their state.

Figure 87. Network page.

Network connectors on the front panel of 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

eth5 eth4 eth3 eth2 eth1 eth0

Figure 88. Network adapters arrangement on the front panel of NetUP streamer.

The Add VLAN button opens a popup window of virtual adapters’ settings (see VLAN win-
dow on page 96).

95
IPTV_Complex_eng.book Page 96 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


The IPTV Core button (which is present only on the servers other than IPTV Core) opens the
input field for the IP address of the DNS server. Normally this is one of the duties of the IPTV
Core server.
For each adapter the following information is presented:
• Adapter name;
• Inet address (IP address) of the adapter;
• MAC address of the adapter;
• Adapter state (UP or DOWN);
• Aliases (alternative IP addresses) of the adapter;
• DHCP server IP range and state (UP or DOWN);
Following actions can be done with an adapter:
• Add alias button adds an alias IP address;
• Statistics button displays load statistics for the given adapter in graphic form;
• Inet address link provides the way of changing the IP address, or removing it altogether (un-
less it is unique);
• DHCP server link changes the IP address range
served by this DHCP.
• DHCP server status indicator (UP / DOWN) is
also a switch that toggles this DHCP on and off.
Figure 89. DHCP settings.

The address assigned for the eth0 interface is used for the component’s interaction
(see Connections on page 98) and thus is absolutely crucial for the system’s opera-
tion. It can never be deleted.

VLAN window
To create new virtual LAN interface based on the
selected physical interface, enter VLAN ID and press
Add. A new VLAN with a name composed of the
physical LAN’s name and the ID will be created.
To remove a VLAN, press Delete VLAN in the
corresponding row.
Using the newly created VLAN may require
some tuning on the UCC side, see Usage examples:
Adding new network interface on page 76. Figure 90. VLAN window.

96
IPTV_Complex_eng.book Page 97 Friday, November 2, 2012 1:05 PM

Web interface
Routing
This page features the system routing table.

Figure 91. Routing table.

Securi ty
This page contains interface for changing the ac-
cess passwords, namely the server admin password
and the cluster admin password. To do so, type the
new password twice in the New Password and Re-
peat Password fields of the corresponding form and
press Update.

Figure 92. Security page.

Server admin password is used for SSH and FTP access (see Update on page 93 and
Creating VoD or nVoD content on page 59). Cluster admin password is used by the
web interface and by the control center (see Installing the UCC on page 53).

S er vi ce s
This page lists existing system components (Middleware, Billing, etc).

Figure 93. Services page.

• Status column displays the current status of components (Running / Stopped).


• Actions lists the possible operations with the given component (Start / Stop).

97
IPTV_Complex_eng.book Page 98 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 94. Tunneling & IGMP page.

• Status column displays current status of services (Running / Stopped).


• Actions lists the possible operations with the given service (Enable / Disable).
A virtual tunnel is a technology that may be used by the NetUP technical support team to re-
motely control your server. To provide a virtual tunnel, your server must have a static IP address.
Besides, you have to send the etc/vtund.conf file to NetUP.

System status
About
This page displays the version number of NetUP.tv and build numbers of individual systems.

Connected clients
This page contains the list of all connected clients, including STBs and PCs. Address and
state of each client are shown in the list.

Connections
This page displays the addresses and status information for all systems of NetUP.tv (includ-
ing individual STBs). For each one, it also lists the other systems with which this one interacts.

Figure 95. Connections page.

For this host’s system, the addresses of other connected systems are links to the interface by
which they may be changed, either manually or by automatic address discovery.

98
IPTV_Complex_eng.book Page 99 Friday, November 2, 2012 1:05 PM

Web interface
S to r age
This page summarizes the disk space usage info.

Figure 96. Storage page.

99
IPTV_Complex_eng.book Page 100 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

100
IPTV_Complex_eng.book Page 101 Friday, November 2, 2012 1:05 PM

STB SETUP 8
STB firmware update is done automatically, once the NetUP firmware is installed and the up-
date distribution system is set up (see Updating STB firmware). The firmware update parameters
and interface for controlling the STBs directly are accessible via the corresponding pages of the
web interface (see STB management on page 89).
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). Use the web interface (see Styles and
Translations on page 91) to upload the modified user style and language files to the server. Up-
loaded files may be selected and installed to a particular STB via the STB interface itself (see
STB Client Interface: Settings on page 120).
The firmware development tools, as well as the means of downloading firmware to the STBs,
should be requested from the manufacturer.

Updating STB firmware


Setting up the automatic firmware update includes the following steps:
1. Set up the DHCP server (unless already set; see below) to issue proper IP addresses for down-
loading updates;
The Telergy T502 STB would only accept the update by a hardcoded address which
may be revealed via its own boot menu. To enter the boot menu, start up the STB con-
nected to a TV and hold the Power button pressed while loading.

2. Set up the Middleware server to send the updates by the corresponding multicast addresses.
This is done via the web interface, see STB management on page 89;
3. Start up the STB while connected to network with a DHCP server;
4. If the STB would not upgrade automatically (which may be the case with the third-party
firmware), send the explicit command to do so. This is also done via the web interface, see
STB management on page 89.
The DHCP server, among other duties, informs the STBs about the IP addresses that the firm-
ware updates come from. 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 differ-
ent IP addresses. The example dhcpd.conf distributed by NetUP contains a number of sec-
tions 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.

101
IPTV_Complex_eng.book Page 102 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Forced update, as well as some other vendor-specific operations, may be performed manually
with the use of specialized software, as described in Amino AmiNET on page 104, D-Link on
page 107, and Teletec Mag-200 on page 108. For more hints on low-level STB debugging see
STB diagnostics on page 147 and Amino STB troubleshooting on page 153.

Updating user theme


The user theme consists of style part and language part. The former includes images, colors,
font definitions, and other parameters of user interface screens. Existing theme may be down-
loaded from the live system (see Web interface: Styles on page 91 and Translations below) in
the form of *.zip archives. Modified theme components can be uploaded on the same pages.
For uploading components as *.zip archives, use the Compile button.

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 folders structure would be rejected by the system.
The folders inside the style archive include color, font, image-set, and menu, which
all must be located at the archive root. New style refers to one particular resolution, which is
specified during uploading. Some files may be missing; those would be substituted with their ver-
sions from the default theme for the given resolution. Extra files, if any, would be ignored.
The downloaded style archive by itself does not conform to the folder structure re-
quirement (it contains an extra upper-level folder). Hence it is unfit for uploading as
a new style, until edited manually.

Language archive must contain a single file named language.ts.


Style archive contains the default.menu.ini file which describes the menu structure.
Complete removal of a portion of this file related to some particular interface screen renders that
screen inaccessible to the users.
Updated theme files are sent over the network as a UDP multicast stream to the given 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.

Changing image
To change one of the interface images:
1. Download and unzip style-source.zip.
2. Find the image file you intend to change by browsing through the images in the subfolder of
image-set intended for the desired resolution.
3. Replace the file in question with your custom image, which must have similar size in pixels
and similar name.
4. (Optional) Remove all unmodified style files.
102
IPTV_Complex_eng.book Page 103 Friday, November 2, 2012 1:05 PM

STB setup
5. Create a .zip archive with the contents of the style folder and download it to the server (see
Styles: Compile on page 91).

Changing color
To change the interface colors:
1. Download and unzip style-source.zip.
2. Find the color descriptions in the style file for the desired resolution (see color/*.ini):
editable_background="white"
highlight_background="#3366cc"
title_background="#4d697c"

3. Change the colors:


editable_background="#f0f0ff"
highlight_background="#6633cc"
title_background="#586060"

4. Save the style file.


5. (Optional) Remove all unmodified style files.
6. Create a .zip archive with the contents of the style folder and download it to the server (see
Styles: Compile on page 91).

Changing text label


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

3. Edit the label:


<translation>Direccion MAC</translation>

4. Save the language file as language.ts.


5. Create a .zip archive containing the language file and download it to the server (see Trans-
lations on page 91, use the Compile button).

103
IPTV_Complex_eng.book Page 104 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Amino AmiNET
External DHCP settings
Below is a fragment of dhcpd.conf config file related to the Amino AmiNET110 STBs. If
a third-party DHCP server is used, these sections must be inserted into its config file. If for some
reason setting up a DHCP server is unsuitable, these parameters may be set up manually (see
Manual setup on page 105) on each STB.
class "AmiNET110 mboot"
{

If the STB if on the first stage of update,


match if (option vendor-class-identifier
="aminoAMINET11xmboot")
or ((substring(option vendor-encapsulated-options, 2, 9)
="AMINET11x")
and (substring(option vendor-encapsulated-options, 13, 5
="mboot"));

it is provided with the IP address and port number to download bootstrap.signed:


vendor-option-space AMINO;
option AMINO.address 225.50.50.50;
option AMINO.port 11111;
}
class "AmiNET110 upgrd"
{

On the next stage,


match if (option vendor-class-identifier
="Aminoaminet110upgrd")
or ((substring( option vendor-encapsulated-options,2,9)
="aminet110")
and (substring( option vendor-encapsulated-options,13,5)
="upgrd"));

it is directed to another address to download mc2.mcfs:


vendor-option-space AMINO;
option AMINO.address 225.50.50.51;
option AMINO.port 11111;
}
class "AmiNET110 fisys"
{

104
IPTV_Complex_eng.book Page 105 Friday, November 2, 2012 1:05 PM

STB setup
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 104) may be also entered manually for an individual STB, together with some other param-
eters. To do that, connect to the STB via telnet and set the following parameters using the
libconfig-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
libconfig-set NETCONF.DOMAIN iptv

Telnet access to STBs is protected by a password which may be reset remotely, see
Password on page 107.

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

105
IPTV_Complex_eng.book Page 106 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Output signal parameters


Output resolution for HDMI may be set as follows:
libconfig-set NORFLASH.OUTPUT_RESOLUTION HD720P50
libconfig-set SETTINGS.GFX_RESOLUTION HD720

Possible values for NORFLASH.OUTPUT_RESOLUTION include:


• HD480P59
• HD576P50
• HD720P50
• HD720P59
• HD1080I50
• HD1080I59
The ability to work in each of these regimes depends on the versions of STB hardware and
firmware, as well as on the parameters of the output device itself.
Rollback to default setting (determine maximum resolution automatically) is done as follows:
libconfig-set NORFLASH.OUTPUT_RESOLUTION SDAUTO
libconfig-set SETTINGS.GFX_RESOLUTION ""

Output signal type is set as follows:


libconfig-set NORFLASH.OUTFMT <Type>

where <Type> may be selected among:


• CVBS-RGBOFF (for the signal of Composite type)
• LC-RGBOFF (for S-Video)
• CVBS-RGBON (for Composite + RGB)
• CVBS-LC (for Composite + S-Video)
Output screen aspect ratio is set as follows:
libconfig-set SETTINGS.DISPLAY_MODE <Format>

where <Format> may be selected among:


• "panscan" (4:3 aspect ratio, pan and scan presentation mode);
106
IPTV_Complex_eng.book Page 107 Friday, November 2, 2012 1:05 PM

STB setup
• "letterbox" (4:3 aspect ratio, letterbox presentation mode);
• "widescreen" (16:9 aspect ratio);
• "ignore" (stretch image to the screen).

Subtitles
To turn on subtitles wherever they are available, use the following command:
libconfig-set NORFLASH.SUBTITLES "Y"

(or "N" to switch subs off).


If several alternative subtitle tracks are available, one of them with the user’s preferred lan-
guage is selected. In case if there is no track in this language, the second one is tried instead. The
user’s preferred languages are set by the commands:
libconfig-set SETTINGS.SUBTITLES_PREF_LANG "en"
libconfig-set SETTINGS.SUBTITLES_SECOND_LANG "fr"

The command argument must contain a two-letter language code according to ISO639.

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;
2. Copy the /proc/mtd and /proc/meminfo files to any location outside of /proc;
3. Unmount /proc;
4. Make /proc writable;

107
IPTV_Complex_eng.book Page 108 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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"

6. Copy /proc/mtd and /proc/meminfo files over their previous location.


If the telnet connection to STB is impossible, request the further instructions from the vendor.

Output signal parameters


STB output resolution is set by default to HD720. To set another output resolution, include
the following lines into the /etc/sysmgmt/settings file:
OUTPUT_RESOLUTION=HD1080I

for HD1080 (50Hz), or


OUTPUT_RESOLUTION=AUTO

to autodetect resolution.
Output signal type is set by the OUTPUT_CHANNEL variable, which may take one of the fol-
lowing values:
• SD_CH_COMPOSITE
• SD_CH_COMPONENT
• SD_CH_SVIDEO

Teletec Mag-200
Manual setup
If the network parameters can not be set via DHCP, it is possible to set them manually via an
ssh connection. To do that, start the STB while connected to a network with some DHCP server.
The manufacturer’s firmware uses login root and password 930920. The NetUP version uses lo-
gin root and password root2root.

108
IPTV_Complex_eng.book Page 109 Friday, November 2, 2012 1:05 PM

STB setup
Set the parameters using the following command:
fw_setenv <parameter> <value>

Below are the essential parameters and their meanings:


• ipaddr_conf is an IP address of the STB;
• netmask is the network mask;
• gatewayip is the default gateway IP address;
• dnsip is the DNS server IP address.
The optional parameters are:
• ntpurl is an URL of an NTP server;
• mcip_mng_conf is the multicast address for remote management (must coincide with that set
in the web interface, see STB management on page 89);
• mcport_mng_conf is the port number used for remote management, must be set to 9002;
• timezone_conf is the time zone, as in “Europe/Moscow”;
• igmp_conf must be set to “V3”, if IGMP version 3 is used in the network.
New values are applied after STB reboot.

109
IPTV_Complex_eng.book Page 110 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

110
IPTV_Complex_eng.book Page 111 Friday, November 2, 2012 1:05 PM

STB CLIENT INTERFACE 9


STB Client's interface is reproduced on the TV screen by means of the set-top box. This in-
terface enables the customer to:
• Select and view TV channels;
• Select, order and view movies from VoD servers;
• Select show time and view movies from the Virtual Cinema servers;
• Set language and interface settings, select the tariff plan to switch to, view financial statement;
• Control the process of viewing movies and TV programs.
Setting up the additional functionality (volume control) of the Amino AmiNET remote con-
trol is described in Setting up Amino remote control on page 158.
For the special edition of STB client integrated with hotel property management systems, see
STB Client Hotel Edition on page 125. For the version of STB client running on Android-based
IP set-top boxes, see NetUP.tv Android client on page 135.
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.

Startup
At first launch the user is prompted to enter the activation number. On subsequent launches
the authorization is performed automatically.

Figure 97. Activation screen.

111
IPTV_Complex_eng.book Page 112 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


If the activation number has been entered incorrectly for 10 times, further attempts
will be blocked and the requests counter should be reset as described in Resetting ac-
tivation requests counter on page 74.

Then the style selection screen will show up.

Figure 98. Primary style selection screen.

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.

On the next step the user is prompted to select interface language.

Figure 99. Primary language selection screen.

112
IPTV_Complex_eng.book Page 113 Friday, November 2, 2012 1:05 PM

STB Client Interface


Style and language may be changed afterwards as well (see Settings on page 120).

On Amino AmiNET 130 STBs working via HDMI the output resolution may be set up
manually, see Manual setup on page 105.

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 120 for setting and
unsetting the password), the lock screen will appear first, prompting the user to enter this pass-
word for unlocking.

Figure 100. Lock screen.

In case if the STB is physically disconnected from the network, it boots into the offline mode.
This can be verified by the Not connected line in the Middleware address field on the Network
Information screen (see Settings). To switch to the normal mode, restore the network connection
and reboot the STB.

Common features
The menu with partially transparent background is superimposed over the playing content
and can be enabled or disabled by pressing Menu button of the remote control panel.
Interface screens are split into several sections. The tree menu placed at the left is shared by
all screens. As a rule, the remote control buttons Up and Down serve to switch between menu
items of the same level, while Right and Left are used to switch between menu levels and open
the selected menu item. Other remote control buttons may possess specific meanings which are
described on each screen separately.
When the screen contains a list of content items of some kind, one of which is currently 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).

113
IPTV_Complex_eng.book Page 114 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

Figure 101. Virtual keyboard.

The replay is controlled by video buttons of the remote control panel. VoD content may be
fast-forwarded with the speed up to 128x, or rewind with the same maximum speed. TV content
may also be paused or scrolled fast (a feature known as Time-Shifted TV) if the given channel is
recorded (see TVoD on page 46).
When a video content with multiple audio tracks is playing, pressing the yellow function but-
ton switches between the tracks in cyclic order.
Regardless of the menu state, whenever a video content starts or stops playing or rewinding,
a status bar appears on the screen. It also may be summoned by the blue function button while the
menu is hidden.

Figure 102. Status bar (play stopped).

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

Figure 103. Status bar (fast forward).

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

Figure 104. Status bar with TV program.

In playing mode the status bar disappears automatically after some delay. In other regimes it
stays on the screen until hidden by the red function button.

114
IPTV_Complex_eng.book Page 115 Friday, November 2, 2012 1:05 PM

STB Client Interface


Viewing TV channels
Available screen lists all channels available according to the user’s tariff plan (see Creating
a tariff plan on page 66) and provides an Add to favorites option. The program guide for the
highlighted channel is shown in the bottom part of the screen.

Figure 105. Available channels screen.

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

Figure 106. Favorite channels screen.

115
IPTV_Complex_eng.book Page 116 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 107. TV program screen.

Detailed program guide for the highlighted channel is shown in the bottom part of the screen.
Current and future programs are marked with . Finished programs are marked with . By
pressing OK the focus switches to the bottom part of the screen. In this regime one may schedule
a switch to any program (also by pressing OK; if the program has already started, the switch 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 122).
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. When a TV group is enabled, it remains so until disabled explicitly. Immediately upon
enabling the group the user’s account is charged for the rest of the current month, and then in due
time it is charged for each subsequent month.

116
IPTV_Complex_eng.book Page 117 Friday, November 2, 2012 1:05 PM

STB Client Interface


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

Figure 108. Available movies screen.

To order a movie, one may use the Order by group, Order by genre and Order by name
screens, each listing content items included in the user’s tariff plan (see Creating a tariff plan on
page 66).
The description of the highlighted movie is shown in the bottom part of the screen.
To order the highlighted movie, press OK. The user’s account is charged for the service upon
presssing OK, the movie becomes available for viewing immediately thereafter, and remains so
for the subsequent 24 hours.

Figure 109. Order movies by name screen.

117
IPTV_Complex_eng.book Page 118 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Ordering a movie will require a financial password, if it is set (see Settings on page 120).
The two remaining screens in this section constitute the virtual cinema interface. On the Or-
der seances screen there is a list of nVoD content included in the user’s tariff plan (see Creating
a tariff plan on page 66).

Figure 110. NVoD ordering screen.

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

Figure 111. Available seances screen.

When a movie is selected, its program schedule appears (see Setting up nVoD program
schedule on page 60), 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.

118
IPTV_Complex_eng.book Page 119 Friday, November 2, 2012 1:05 PM

STB Client Interface


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.

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

Figure 112. Information screen.

Replace tariff plan provides the interface for switching to another tariff plan by selecting it
from the list. The list is composed of tariff plans that overlap by roles (i.e. have some roles in
common, see Editing a tariff plan, step 6 on page 67) with the current one.

Figure 113. Replace tariff plan screen.

119
IPTV_Complex_eng.book Page 120 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

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

Figure 114. Financial report screen.

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

Figure 115. Security screen.

• Unlock password. Once set, this password is required to start the STB interface after each
hardware reboot.
• Financial password. Once set, it is requested before every finance-related operation, like
buying content, changing the tariff plan, etc.
• Parental password. Once set, it is requested for gaining access to an adult content (this prop-
erty of the content is derived from its genre attribution).
To unset any password, change it to empty string.

120
IPTV_Complex_eng.book Page 121 Friday, November 2, 2012 1:05 PM

STB Client Interface


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

Figure 116. Network information screen.

Styles screen contains the list of available custom user styles for STB interface. See Web in-
terface: Styles on page 91 for uploading user styles).

Figure 117. Style selection screen.

121
IPTV_Complex_eng.book Page 122 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 118. Language selection screen.

Additional
Scheduler screen displays the list of scheduled events, including switches, notifications, and
alarm clocks. An alarm clock event may be set up on this very screen. At scheduled time it
switches TV on at top volume.

Figure 119. Scheduler screen.

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

122
IPTV_Complex_eng.book Page 123 Friday, November 2, 2012 1:05 PM

STB Client Interface


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

Figure 120. Internet screen.

123
IPTV_Complex_eng.book Page 124 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

124
IPTV_Complex_eng.book Page 125 Friday, November 2, 2012 1:05 PM

STB CLIENT HOTEL EDITION 10


Hotel edition is a special edition of NetUP.tv, and particularly its STB client, tailored for in-
tegration with the hotel property management systems (PMS). Usage of this version imposes
some extra requirements concerning the properties of users and tariff plans (see Preparations be-
low). Administrator’s web interface of this version also has some specific features (see Web in-
terface: Fidelio on page 94). Currently, the hotel edition is compatible with MICROS-Fidelio
systems supporting the FIAS protocol.
STB Client's multi-language interface is reproduced on the TV screen by means of the set-top
box and provides the following services:
• Welcome message on guest check-in;
• Hotel information page;
• Selection and viewing of TV channels and movies;
• Auto posting TV services from the IPTV system to the PMS system;
• Hotel bill preview;
• Messages from reception;
• Express checkout;
• Setting room status (dirty/clean) via TV for the housekeeping service.
For correct operation of the system the Middleware server must be used as its DNS
server. If a different DNS server is used, it must be set up to resolve the .iptv zone to
the Middleware address, and also to include it in the list of default suffixes for substi-
tution.

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 intended to be unblocked automatically on
the client’s check-in and blocked again on check-out);
• Account has no credit (i.e. its credit is set to 0);
• Account has been attached to a tariff plan (see the requirements below) at some moment in the
past, but is detached now.

125
IPTV_Complex_eng.book Page 126 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


The tariff plan attached to the client’s sole account must meet the following requirements:
• State is set to Active;
• State of every service is also set to Active;
• Free TV services have their Mandatory option set on, Blockable option set off, and tariffica-
tion type set to Periodic prepaid;
• Paid TV services have their Mandatory option off, Blockable on, and tariffication type set to
Full prepaid;
• All TV services are linked to media groups rather than to individual content items;
• VоD services have their Mandatory option off and Blockable on.
• Radio services have their Mandatory option on, Blockable off, tariffication type set to Peri-
odic prepaid, and price set to 0;
• nVоD services have their Mandatory option off and Blockable on;
• One-time, periodic, and TVoD services, as well as bonuses, are not allowed.
Setting up the connection with the PMS, as well as other possible preparations, are performed
by NetUP upon installation of the system.

Startup
At first launch the user is prompted to enter the activation number. This is normally done by
the service personnel upon installation of the system. From then on, the authorization is per-
formed automatically.

Figure 121. Activation screen.

If the activation number has been entered incorrectly for 10 times, further attempts
will be blocked and the requests counter should be reset as described in Resetting ac-
tivation requests counter on page 74.

126
IPTV_Complex_eng.book Page 127 Friday, November 2, 2012 1:05 PM

STB Client Hotel Edition


On the client’s first launch after check-in, the welcome screen will show up.

Figure 122. Welcome screen.

Welcome screen is actually a web page located on the Middleware server. It is man-
aged via the web interface (see Web interface: Fidelio on page 94) and may exist in
multiple language versions.

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 130).
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 130 for setting and unsetting the pass-
word), the lock screen will appear first, prompting the user to enter this password for unlocking.

Figure 123. Lock screen.

In case if the STB is physically disconnected from the network, it boots into the offline mode.
This can be verified by the Not connected line in the Middleware address field on the Network
Information screen (see Settings). To switch to the normal mode, restore the network connection
and reboot the STB.

Common features
The menu with partially transparent background is superimposed over the playing content
and can be enabled or disabled by pressing Menu button of the remote control panel.
127
IPTV_Complex_eng.book Page 128 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 124. Virtual keyboard.

The replay is controlled by video buttons of the remote control panel. VoD content may be
fast-forwarded with the speed up to 128x, or rewind with the same maximum speed. TV content
may also be paused or scrolled fast (a feature known as Time-Shifted TV) if the given channel is
recorded (see TVoD on page 46).
When a video content with multiple audio tracks is playing, pressing the yellow function but-
ton switches between the tracks in cyclic order.
Regardless of the menu state, whenever a video content starts or stops playing or rewinding,
a status bar appears on the screen. It also may be summoned by the blue function button while the
menu is hidden.

Figure 125. Status bar (play stopped).

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

Figure 126. Status bar (fast forward).

128
IPTV_Complex_eng.book Page 129 Friday, November 2, 2012 1:05 PM

STB Client Hotel Edition


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

Figure 127. Status bar with TV program.

In playing mode the status bar disappears automatically after some delay. In other regimes it
stays on the screen until hidden by the red function button.

Multimedia
TV channels screen lists all channels available according to the user’s tariff plan (see Creat-
ing a tariff plan on page 66). The program guide for the highlighted channel is shown in the bot-
tom part of the screen. The reproduction starts after selecting an entry and pressing OK.

Figure 128. TV channels screen.

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. When a TV group is enabled, it remains so until disabled explicitly. Immediately upon
enabling the group the user’s account is charged for the rest of the current month, and then in due
time it is charged for each subsequent month.

129
IPTV_Complex_eng.book Page 130 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 129. Movies screen.

When a movie is purchased, it becomes available for viewing immediately after pressing OK,
and remains so for the subsequent 24 hours. The user’s account is charged for the service at the
very moment of pressing OK. Ordering a movie will require a financial password, if it is set (see
Settings on page 130).

Settings
The interface of this group consists of four screens.
Information displays the current tariff plan, card validity period, and balance.

Figure 130. Information screen.

130
IPTV_Complex_eng.book Page 131 Friday, November 2, 2012 1:05 PM

STB Client Hotel Edition


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

Figure 131. System information screen.

Security screen contains the interface for setting, changing, and unsetting various passwords:

Figure 132. Security screen.

• Unlock password. Once set, this password is required to start the STB interface after each
hardware reboot;
• Financial password. Once set, it is requested before every finance-related operation, like
buying content, changing the tariff plan, etc.;
• Parental password. Once set, it is requested for gaining access to an adult content (this prop-
erty of the content is derived from its genre attribution).
To unset any password, change it to empty string.

131
IPTV_Complex_eng.book Page 132 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 133. Languages screen.

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.

Figure 134. Billing screen.

132
IPTV_Complex_eng.book Page 133 Friday, November 2, 2012 1:05 PM

STB Client Hotel Edition


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

Figure 135. Messages screen.

Scheduler screen displays the list of scheduled events, including switches, notifications, and
alarm clocks. An alarm clock event may be set up on this very screen. At scheduled time it
switches TV on at top volume.

Figure 136. Scheduler screen.

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

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

133
IPTV_Complex_eng.book Page 134 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Hotel info displays the general information page.

Figure 137. Hotel info screen.

Hotel info is actually a web page located on the Middleware server. It is managed via
the web interface (see Web interface: Fidelio on page 94) and may exist in multiple
language versions.

Upon pressing Rec on this screen, STB client requests the housekeeper’s password and then
opens a service screen where a housekeeper may specify the status of the room.

Figure 138. Room status screen.

134
IPTV_Complex_eng.book Page 135 Friday, November 2, 2012 1:05 PM

NETUP.TV ANDROID CLIENT 11


The NetUP.tv client for Android-based IP set-top boxes enables the customer to:
• Select and view TV channels;
• Select, order and view VoD movies;
• Select the tariff plan to switch to, view financial statement;
• Control the process of viewing movies and TV programs.
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.

Startup
To start the application, select and press its icon on the Android home screen.

At first launch the user is prompted to enter the activation number. On subsequent launches
the authorization is performed automatically.
If the activation number has been entered incorrectly for 10 times, further attempts
will be blocked and the requests counter should be reset as described in Resetting ac-
tivation requests counter on page 74.

After authorization (this step is skipped on subsequent launches) the user interface main
screen will show up.

Common features
The menu with partially transparent background is superimposed over the playing content. It
may be summoned by pressing Back button of the remote control panel, and vanishes automati-
cally once a new film or a TV channel is selected and starts playing.
The contents of the menu is placed at the left. As a rule, the remote control buttons Up and
Down switch between menu items, while Right and Left are used to switch between alternative
screens (wherever applicable). To open the selected menu item, press OK. To return to the upper
level, press Back.
Textual information, whenever required, may be entered by means of the Android virtual
keyboard.

135
IPTV_Complex_eng.book Page 136 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

Figure 139. Main menu screen.

TV channels
TV channels screen lists all channels available according to the user’s tariff plan (see Creat-
ing a tariff plan on page 66). The program guide for the highlighted channel is shown in the right
part of the screen.

Figure 140. Available channels screen.

136
IPTV_Complex_eng.book Page 137 Friday, November 2, 2012 1:05 PM

NetUP.tv Android client


The alternative screens list particular groups of channels.

Figure 141. Favorite channels screen.

Program guide
The Program Guide screen displays the program of telecasts when available (it may originate
from the streamer or may be entered manually by the administrator, see Setting up telecasts pro-
gram schedule on page 56).

Figure 142. TV program screen.

Program names that would not fit into the corresponding table cells are scrolled automatically
for convenient viewing.

137
IPTV_Complex_eng.book Page 138 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Movies
The Movies screen lists all available movies. The description of the selected movie is shown

on the right. Purchased movies are marked in the list with the sign. Upon selecting a pur-
chased movie and pressing OK it starts playing. If the selected movie is not purchased yet, press-
ing OK opens a special screen with trailer playing in a small window, prompting the user to buy
the movie.

Figure 143. Purchasing a movie.

On the alternative screens there are lists of movies that belong to a particular group or genre,
each with the same functionality of purchasing and viewing.

Figure 144. Available movies screen.

138
IPTV_Complex_eng.book Page 139 Friday, November 2, 2012 1:05 PM

NetUP.tv Android client


Personal account
The Personal account group of screens contains financial information and some user set-
tings.
Balance displays the accounts’s balance and credit.

Figure 145. Account balance screen.

Payments displays the list of payments.

Figure 146. Payments screen.

139
IPTV_Complex_eng.book Page 140 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Provided services displays the list of charges for the provided services.

Figure 147. Charges screen.

Tariff plan change 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 67) with the current one.

Figure 148. Tariff plan change screen.

140
IPTV_Complex_eng.book Page 141 Friday, November 2, 2012 1:05 PM

PC CLIENT 12
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.

The installer of the PC client should be downloaded from the client’s personal cabinet at
www.netup.tv (go to Files, then look for “IPTV PC Client win32”).
On first launch the program requests
the activation code.

Figure 149. Activation window.

Common features
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, namely:
• TV;
• VoD;
• Radio;
• Market;
• Playlists;
• Settings.
The main menu containing the list of tabs always stays on the left and is accessible from any
tab.

141
IPTV_Complex_eng.book Page 142 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Figure 150. List of channels.

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 55, Creating a tariff plan on page 66).

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

142
IPTV_Complex_eng.book Page 143 Friday, November 2, 2012 1:05 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 144).

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 Figure 151. Order
content and its price. confirmation window.

Playlists
This tab contains the register of playlists composed by the user. There is an interface for de-
leting playlists ( ) or creating new ones ( ), as well as removing content from playlists
( ). Pressing Play or double-clicking on a list item starts playback of the selected content
(see Playback window on page 144).

Settings
The settings tab contains four second-level tabs which are explained below.

Interfac e
Interface tab contains the following interface settings flags:
• Playback TV on one click;
• Playback last content on startup.

Finances
Finances tab 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;

143
IPTV_Complex_eng.book Page 144 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


° Charges during the current period;
° Current balance;
° Credit.
• Related to the user’s access card:
° State;
° Period of validity.
• Related to the tariff plan:
° Current plan;
° Next plan (may be changed).

Security
On this tab you may set the following security parameters:
• 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.
To unset any password, change it to empty string.

Languages
Here you may select a language from the list of installed languages. Upon selection, the new
language is applied to the whole program interface immediately.

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.

Figure 152. Playback window.

The control panel located in the bottom part of the window provides the following functions:
144
IPTV_Complex_eng.book Page 145 Friday, November 2, 2012 1:05 PM

PC Client
• 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.
• 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.

145
IPTV_Complex_eng.book Page 146 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

146
IPTV_Complex_eng.book Page 147 Friday, November 2, 2012 1:05 PM

SYSTEM MAINTENANCE 13
Backup copies
Automatic backup copies are created daily. Besides, a backup may be created at any time via
web interface (see Backup on page 92).
To roll forward an older backup copy, first create a current backup, and then stop all NetUP.tv
systems. Backup tables should be rolled forward manually one by one via the SQL client.
Changed config files should be copied over the current ones. Extreme caution must be taken,
since wrong action sequence may lead to loss of data.
To set up daily automatic download of the backup files, set up the download program (for 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_current.tar.bz2

STB diagnostics
The STB client has an event log which is kept in the RAM and flushed on reboot. To view the
full log, connect to the STB by telnet and type logread.
To view just the new events as they are coming, execute logread -f.

The logread -f command is not available on Amino AmiNET 110 STBs.

Network troubleshooting
If an STB does not play streaming video, this may be due to network errors. To rule out pos-
sible communication problems, plug the STB and the streamer into the same switch. If the
streamig video still would not show up, attach a PC instead of the STB and check that the media
is actually streamed to the specified multicast address, and that no extraneous signal is streamed
together with it. The VLC media player (http://www.videolan.org/vlc/) may be used to view the
video stream on PC (select Media – Open Network Stream in the menu).

NetUP server troubleshooting


When a network connection to the NetUP server is impossible, use the debugging cable sup-
plied with the server. Connect the port on the server’s front panel to the COM port on any PC and
open a terminal program.

147
IPTV_Complex_eng.book Page 148 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Use the following connection parameters:
Speed (bit/s) 19200
Data bits 8
Parity None
Stop bits 1
Flow control None

A Linux console will show up in the terminal window.

NetUP Dual DVB-S2-CI


Over view
The NetUP Dual DVB-S2-CI is a professional DVB-S/DVB-S2 PCI-e card designed for
high-density appliances such as DVB-IP gateways, home theaters, satellite Internet systems, etc.
In contrast to standard DVB-S cards NetUP's Dual DVB-S2-CI provides fourfold density - two
DVB-S/S2 receivers and two Common Interface (CI) slots occupy only one PCI-e slot. The high
density allows saving space on installation and using the card for satellite signal reception in con-
fined environments. For example, a standard 1U rack-mount server with two PCI-e slots can re-
ceive and fully decode 4 satellite transponders, such as NetUP's IPTV Combine 4x or DVB-IP
gateway 4x.

Figure 153. NetUP Dual DVB-S2-CI card.

Features
• two DVB-S/DVB-S2 inputs for simultaneous reception of two DVB-S/DVB-S2 transpon-
ders;

148
IPTV_Complex_eng.book Page 149 Friday, November 2, 2012 1:05 PM

System maintenance
• two CI slots for independent descrambling of two transponders;
• support of any professional CA modules (e.g., PowerCAM Pro, Aston Pro Solutions, etc.);
• PCE-e x1;
• DiSEqC 2.x;
• drivers for Linux OS.

Supported Operating Systems


• Linux;
• Windows XP (x86 и amd64);
• Windows Vista (x86 и amd64);
• Windows 7 (x86 и amd64).

Driver installation
The newest driver for Linux can be installed by the following commands:
hg clone http://linuxtv.org/hg/v4l-dvb/
cd v4l-dvb
make && make install

The Windows driver is currently available as a beta version.


Download the build folder with the driver from the following URL:
https://github.com/netup/netup-dvb-s2-ci-dual/tree/master/build
The system will automatically detect the appropriate driver version during the installation.
Choose the Install from specified folder option and then confirm the installation of an un-
signed driver.

Startup notes
To make the Dual DVB-S2-CI card work properly, the following option need to be enabled
while configuring Linux kernel:
Symbol: VIDEO_CX23885 [=m]
Location:
-> Device Drivers
-> Multimedia support (MEDIA_SUPPORT [=y])
-> Video capture adapters (VIDEO_CAPTURE_DRIVERS [=y])

Technica l data
Supported Modulation Types
• Legacy DVB-S QPSK;
• DVB-S2 QPSK and 8PSK;
• Optional: 16APSK and 32APSK.

149
IPTV_Complex_eng.book Page 150 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Symbol rates
• QPSK DVB-S – 1 to 47 Msymb/s;
• 8PSK DVB-S2 – 1 to 31.5 Msymb/s (in single mode up to 63 Msymb/s).
When using CAM, bit rate is limited to 72 Mbit/s.

FEC
• QPSK DVB-S – 1/2, 3/5, 2/3, 3/4, 4/5, 5/6, 8/9, 9/10;
• 8PSK DVB-S2 – 3/5, 2/3, 3/4, 5/6, 8/9, 9/10.

Output signals
Output voltage: 13/18V.
Output current: not to exceed for an extended period a total of current of 1 A from both port
(IOUT_A + IOUT_B < 1 A) in order to avoid triggering the overheating protection.

Mechanical data
Operating temperature -10..+70° C.
Weight: 150 g.
Dimensions: 180x130x20 mm.

CNR
DVB-S(QPSK), BER < 1e-10
30Msps, CNR dB
1/2 2.8
2/3 4.6
3/4 5.5
5/6 6.7
7/8 7.2

DVB-S2(8PSK), BER < 1e-10


30Msps, CNR dB
3/5 6.5
2/3 7.6
3/4 8.9
5/6 10.5
8/9 11.1
9/10 11.4

150
IPTV_Complex_eng.book Page 151 Friday, November 2, 2012 1:05 PM

System maintenance
16APSK, PER =10e-7
30Msps, CNR dB
2/3 9.8
3/4 11
4/5 11.8
5/6 12.4

Debugging board for SMiT CAM modules


SMiT provides a debugging board for its CAMs.

Figure 154. SMiT debugging board connection.

Connect the CAM to the debugging board as shown on the photo. Insert the operator’s smart
card in a usual way. The debugging board works transparently, so the CAM is unaffected by it.
Connect the board to a PC using two cables, namely COM and USB. Open a terminal pro-
gram. Use the following connection parameters:
Speed (bit/s) 115200
Data bits 8
Parity None
Stop bits 1
Flow control None

151
IPTV_Complex_eng.book Page 152 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


As the CAM starts, the following loading messages come up in the terminal window:
Platform: CAM (ARM7TDMI)
eCos v2.0-20060212[ROM], Build 13:21:48, Nov 9 2007
GCC: 3.0.3

Loader Version: SMIT-Loader v4.0.0


Bstrap SW v4.0.0 build on Nov 16 2007, 13:26:59
sm_trace_set_level() - set_trace, mod=16, level=8
[FLASH]INFO:Thumb copy
[FLASH] Set to IRQ mode
[FLASH]INFO:Flash LIb version 0x10303 build at Nov 9 2007 ,
13:36:21

To refresh the CAM firmware, use the temu.exe utility supplied by the manufacturer. Start
the utility, select the new firmware file, then unplug the USB cable from the board and plug it
again.

Figure 155. Updating CAM firmware.

152
IPTV_Complex_eng.book Page 153 Friday, November 2, 2012 1:05 PM

System maintenance
Amino STB troubleshooting
Debugging cable connection
If both the regular mass update and individual update fail (that is, if due to some firmware
fault or other reason the STB does not download newer firmware build, and also neither accepts
STBremoteconf commands nor allows remote connection by telnet), the last-ditch effort to re-
vive the STB may be made with the debugging cable. The cable is supplied by the STB manufac-
turer or vendor.

Figure 156. Debugging cable connection.

Remove the STB’s outer case and attach the connection cable to the slot named below so as
to face the square-framed hole with its missing pin.
Amino 110 J7
Amino 125 J4
Amino 130 J7

When wired to a PC via direct cable connection, the STB may be controlled with a terminal
program.
Use the following connection parameters:
Speed (bit/s) 115200
Data bits 8
Parity None
Stop bits 1

153
IPTV_Complex_eng.book Page 154 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

The system must have virtual COM port driver installed.

Reboot the STB with the cable connected. After some booting messages, the following
prompt will appear:
Hit ENTER to stop normal operation ...
I>

To display the list of available commands, type help:


I>help
Amino Communications IntActOS-32 v1.44 on AMINET11x with 32Mb
RAM
Processor: 51510950 running at 252.000 MHz
bootos,cache,configure,go,help,time,rem,reset,show,sprog
testled
change,copy,delete,details,device,dir,format,
fs,load,makefs,rename,run,save,type,verify
mputgif,setavc
mboot

To display the list of parameters, type show all:


I>show all
Locked : 00
BoxID : 701608F017310
BoardRev : 2
VideoMode : 1
OutFormat : 0
RFChan : 166
RFMode : 2
RFFreqTbl : 0
CAID : F0F0F0F0
NDSSoftwareVersion : 00000000
NDSDriverVersion : 00
ManufacturerID : 1D
STBModelType : 01
HardwareVersion : 01
MACaddress : 00:02:02:1C:DB:7B
Ethernet : 0
UseDHCP : Y
IPaddress : 0.0.0.0
Gateway : 0.0.0.0
Netmask : 0.0.0.0

154
IPTV_Complex_eng.book Page 155 Friday, November 2, 2012 1:05 PM

System maintenance
TimeServer : 0.0.0.0
DNS : 0.0.0.0
McastAdr : 0.0.0.0
McastPort : 0

The typical command sequence for restoration of STB is described below.


1. Set up the IP address and port from which the modern firmware is to be downloaded:
I>configure McastAdr 225.50.50.50
I>configure McastPort 11111
I>

2. Erase all existing files:


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

99%
Erasing...
99%

Bytes used = 0000A000


Bytes spare = 01FF6000
Bytes total = 02000000

3. Reboot the STB:


I>reset

During startup the STB will communicate to the address just set in order to download the
modern version of firmware.
In case if the 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.

155
IPTV_Complex_eng.book Page 156 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


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

Below is the detailed list of errors.


Major # Minor # Error STB behavior
1 1 No network connection Tries 3 times and proceeds booting

1 2 DHCP lookup failure Tries 3 times and proceeds booting

1 3 I2C communication failed Tries 3 times and proceeds booting

2 1 TFTP download failure Reboots, !poweron file is not saved

2 2 BOOTP server not found Reboots, !poweron file is not saved

2 3 Multicast group not found Tries 3 times, reboots if unsuccessful

2 4 Multicast download timeout Tries 3 times, reboots if unsuccessful

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 does not 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

156
IPTV_Complex_eng.book Page 157 Friday, November 2, 2012 1:05 PM

System maintenance

Major # Minor # Error STB behavior


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
4 3 listfile.sig is missing or corrupted Erases the flash and reboots

4 4 Image DI is less than STB DI Deletes the image if saved in the


flash. Tries 3 times, reboots if
unsuccessful
4 5 Set DI failed Deletes the code contents of the flash
and reboots
4 6 STBremoteconf key not found Ignores command

4 7 STBremoteconf key failed to verify Ignores command

4 8 MD5 sum failure Rejects image

4 9 Number of entries in the listfile does not Rejects image


match with what was downloaded
4 10 No DI file found Reboots

5 1 NAND flash corruption Reformats the NAND flash

5 2 PID mismatch when upgrading the ROM Reboots

5 3 Failed to remove files on upgrade Reboots

5 4 Failed to set execute / start address in Clears the NAND flash


NAND flash
5 5 Kernel panic / no root FS Clears the NAND flash and if
unsuccessful, STB reboots
5 6 Invalid type of GIF file saved on the Deletes the file splash.gif
NAND flash
5 7 Failed to write files onto the NAND Clears the NAND flash
flash
5 8 Failed to gunzip the boot ROM image Rejects image and reboots

157
IPTV_Complex_eng.book Page 158 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

Major # Minor # Error STB behavior


8 1 No master key found Keeps flashing code in endless loop

8 2 No customer key found Keeps flashing code in endless loop

8 3 Signature check of customer key failed Keeps flashing code in endless loop

8 4 (reserved) Keeps flashing code in endless loop

8 5 (reserved) Keeps flashing code in endless loop

8 6 Verify of IntactOS code failed Keeps flashing code in endless loop

9 1 Page write to ROM failed Keeps flashing code in endless loop

9 2 NAND flash hardware / format failure Keeps flashing code in endless loop

9 3 SDRAM access failure Keeps flashing code in endless loop

9 4 Communication to the Ethernet chip Keeps flashing code in endless loop


failed

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

Steps 2 to 6 must be performed without delay, i.e. before that TV


and STB buttons fade out automatically.

2. Press STB.
3. Press the button in question (one of Vol+, Vol-, and Mute).
4. Press STB again.
5. Press again the button in question (same as in step 3).
6. Press TV and STB buttons simultaneously and hold until they
both fade out (approx. 2 seconds).

Figure 157. Amino


remote control type 1.

158
IPTV_Complex_eng.book Page 159 Friday, November 2, 2012 1:05 PM

System maintenance
In case of the remote control type 2 (black), the procedure is dif-
ferent and generally easier, if somewhat esoteric. Perform the follow-
ing sequence once:
1. Press STB button and hold (approx. 2 seconds) until it flashes
twice.
2. Press the following number keys in order: 9, 9, 3.
3. Press again STB button and hold until it flashes twice.

Figure 158. Amino


To configure similar functionality on the remote controls of other remote control type 2.
varieties, contact the manufacturer.

159
IPTV_Complex_eng.book Page 160 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

160
IPTV_Complex_eng.book Page 161 Friday, November 2, 2012 1:05 PM

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

Networ king
• DNS (Domain Name Service) is a distributed hierarchical system that stores IP addresses, do-
main names and various information associated with them.
• TCP/IP (Transmission Control Protocol / Internet Protocol) is a stack of communication pro-
tocols used in computer networks.
• FTP (File Transfer Protocol) is an application level network protocol for file transfer.
• HTTP (Hypertext Transport Protocol) is an application level network protocol for data trans-
fer.
• RTSP (Real-time Streaming Protocol) is an application level network protocol that serves for
signalling during the multimedia data transfer.
• RTP (Real-time Protocol) is a transport level network protocol for delivering real-time traffic
over IP networks.
• UDP (User Datagram Protocol) is a simple transport level network protocol for data transfer.
• TCP (Transmission Control Protocol) is a transport level network protocol for data transfer
with guaranteed delivery.
• DHCP (Dynamic Host Configuration Protocol) is a network protocol for obtaining IP address-
es and other auxiliary information in TCP/IP networks.
• IGMP (Internet Group Management Protocol) is a network protocol that manages group rout-
ing.
• NTP (Network Time Protocol) is a network protocol for synchronizing the internal clocks of
computer systems.
• MAC (Media Access Control) is 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 the Local area network.
• VLAN is the Virtual Local area network, standard 802.1q.
• NFS (Network File System) is a file system distributed among multiple machines.
• SSL (Secure Socket Layer) is 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.

161
IPTV_Complex_eng.book Page 162 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide


Television
• Polarization is a characteristic of the satellite signal (may be vertical, horizontal, circular left,
or circular right).
• Symbol rate is the number of transmitted symbols per second.
• Transponder is an automatic device that may receive and retransmit a signal.
• LNB converter (Low-Noise Block converter) is 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 (Digital Satellite Equipment Control) is a special communication protocol for use
between a satellite receiver and other devices.
• Multiswitch is a device for connecting several receivers to the same satellite dish.
• FTA (Free-to-air) refers to a non-encoded stream.
• CSA (Common Scrambling Algorithm) is an encryption algorithm 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 (MPEG transport stream) is a container format used for transmission of multimedia
data over networks.
• MPEG PS (MPEG program stream) is 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 (Standard Definition) is the resolution of 720x480 or 720x576.
• HD (High Definition) is the resolution of 1280x720 or 1920x1080.
• HDTV (High Definition Television) is a standard for high-resolution digital TV broadcasting.
• DVB (Digital Video Broadcast) is 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.

162
IPTV_Complex_eng.book Page 163 Friday, November 2, 2012 1:05 PM

Glossary
IPTV
• Streamer is a device that receives an on-air or other signal and transmits it over an IP net-
work. Particular varieties include DVB-to-IP gateway and MPEG encoder.
• Middleware is a set of software that controls the interaction between the components of an
IPTV solution (streamer, VoD servers, CAS, and user STBs).
• CAM (Conditional Access Module) is a module that provides restricted access to the broad-
cast media data.
• MMI (Machine-Machine Interface) is an interface used for interaction between CI and CAM.
• EMM (Entitlement Management Message) is an encrypted message stating the user's right of
access to multimedia data.
• CI (Common Interface) is an interface of interaction with CAM (standard EN 50221).
• CAID is the Conditional Access system ID.
• VoD is the Video on demand.
• TVoD is the Television on demand.
• nVoD is the Near Video on demand (also known as "virtual cinema").
• nPVR is the Network Personal Video Recorder.
• EPG is the Electronic Program Guide.
• PPV (Pay-per-view) is a system in which TV viewers can purchase events to be seen on TV.
• CAS (Conditional Access System) is a system that protects the content from unauthorized ac-
cess.
• SMS is the Subscriber Management System.
• Time-Shifted TV is a sort of TV with pause and rewind options.
• STB is the TV set-top box.

Other ter ms
• XML (eXtensible Markup Language) is a markup language for storing structured data.
• RAID (Redundant Array of Independent Disks) is 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 (Digital Rights Management) is the aggregate of access control technologies used to
prevent unauthorized 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 the International Organization for Standardization.
• ANSI is the American National Standards Institute.

163
IPTV_Complex_eng.book Page 164 Friday, November 2, 2012 1:05 PM

NetUP.tv Administrator’s Guide

164
IPTV_Complex_eng.book Page 165 Friday, November 2, 2012 1:05 PM

Alphabetical Index

ALPHABETICAL INDEX 1
A N
Access cards nVoD
Usage examples ............73–74 Control center .....................43

B P
Billing Payment systems . . . . . . . . . . . 50
Control center .....................30 Payments
Usage example ....................75
PC Client . . . . . . . . . . . . . . . . 141
C
Personal accounts. . . . . . . . . . . 18
Currencies
Interface ........................ 32, 38
Usage example ....................73
Usage examples .................. 65
Customers . . . . . . . . . . . . . . . . .17
Interface ..............................30
R
Recording. . . . . . . . . . . . . . . . . 58
D
Reports . . . . . . . . . . . . . . . . . . . 36
DRM
Control center .....................48
S
Services . . . . . . . . . . . . . . . . . . 15
E
Settlement accounts . . . . . . . . . 18
EPG
STB
Usage examples ............56, 60
Interface ............................ 111
Android version .......... 135
M Hotel version...............125
Media contents . . . . . . . . . . . . .15
Usage examples ............55, 59
T
Media groups
Tariff plans. . . . . . . . . . . . . . . . 17
Usage examples ..................61
Usage examples 66–67, 69–72
Media streams
TVoD
Usage examples ............57–58
Control center .....................46
Middleware
Control center .....................21
165
IPTV_Complex_eng.book Page 166 Friday, November 2, 2012 1:05 PM

Руководство администратора NetUP.tv

U W
Users Web interface . . . . . . . . . . . . . . 79
Usage examples ............62, 71

166
IPTV_Complex_eng.book Page 167 Friday, November 2, 2012 1:05 PM
IPTV_Complex_eng.book Page 168 Friday, November 2, 2012 1:05 PM

Phone: +7 495 510 1025


Fax: +7 499 783 0080
Address: Russia, Moscow, Ulofa Palme str. 1, sect. 7
Post: 119311, Russia, Moscow, P.O. Box #87
E-mail: info@netup.tv
Web: http://netup.tv

Current version of this document is distributed together with the NetUP.tv solution and is ac-
cessible via its web interface, see Files on page 92.
© NetUP Inc. All rights reserved. November 2, 2012

Potrebbero piacerti anche