Luminato CLI manualforum.nova-minsk.com/file/Luminato/Luminato_CLI_manual... · 2011. 4. 13. · LUMINATO CLI MANUAL 13-Apr-11 7(63) CLI syntax conventions This document uses certain

LUMINATO CLI MANUAL

13-Apr-11 1(63)

Luminato CLI manual

Luminato SW release 3.8.x

LUMINATO CLI MANUAL

13-Apr-11 2(63)

Table of Contents 1. CLI Overview 3

Issues worth noticing 3 Command modes and groups 3 Command groups 4 Command completion and parameter prompting 4 CLI command-line editor 5 NO commands 6 CLI syntax conventions 7

2. CLI commands 8 Navigation commands 8 System maintenance 8 Host configuration 9 Terminal 11 User accounts 12 Device services 12 Device configuration 15 Environment 23 Interfaces 25 Input interfaces 30 Processing 44 Device monitoring 54

3. CLI HOWTO 60 Work with the “running configuration” 60 Speed up routine tasks with CLI scriptis 60 Configure external syslog 61 Configure stream redundancy 62

LUMINATO CLI MANUAL

13-Apr-11 3(63)

LUMINATO CLI MANUAL

1. CLI Overview

Luminato CLI is a secondary management interface available for device users. It enables users to configure, manage and monitor routings, services, CA (conditional access), networks, interfaces, users and other system entities. The CLI console can be accessed via USB (universal serial bus), telnet or SSH (secure shell).

Luminato CLI syntax is a straightforward command interface that follows the familiar syntax of many other communications products. It also provides a single line com-mand editor with keyboard control sequences, command help, command completion and a buffer for recently entered commands.

Luminato CLI console can be accessed either via direct serial (USB) or via fast ethernet (MGMT1,MGMT2) interfaces. The connectors are located on the back pan-el (in LPS-module). For more detailed instructions of setting up the CLI-connection please refer to Luminato configuration guide.

Issues worth noticing

This document is based on Luminato software revision 3.8.x. Please take also into account the known issues in that software release:

#12535 using copy/paste –method in order to setup large configuration may be unreliable. For transferring the whole configuration from another device the tftp-method is recommended.

If more than one user is simultaneously configuring the device, there is a po-tential risk to have unexpected results. It is recommended to run show status-

command to display the current users.

Command modes and groups

Luminato CLI supports hundreds of commands. They are grouped into different functional groups and modes. Modes are used to separate available actions for user groups per functional groups. When any user logs in he/she is starting in user-mode (non-configure-mode).

The first set of commands is available to all users. Most of these commands are used to show system status.

The other modes (configure-modes) are available only to users with privileged access. These commands are more powerful and can be used to reconfigure the system or to adjust system performance.

User group Role

Monitor Read-only access for status monitoring only Operator Access for daily service operations Installer Access for system setup and installation Admin Full control (excluding factory-specific settings) Devel Unlimited

Monitor-level users cannot enter to configure-modes at all and therefore cannot change configuration. Only show commands are available.

Admin –level user has access to all commands listed in this manual.

LUMINATO CLI MANUAL

13-Apr-11 4(63)

Command groups

Luminato CLI commands are organized in several functional groups:

Generic

Terminal - terminal settings for existing connection

Device monitoring - device operations, current status, alarms

Environment - temperature, power, fans and etc

Modules management

Input interfaces

Output interfaces

Processing

Descrambling

Scrambling

Network

Device maintenance

Device services

Users accounts

Licenses

Redundancy

Each group have in common commands show, configure and some other action-commands (for example reboot, if applicable). Show-commands are always available if not stated other-wise (for example show user -command is available only to admin -users).

Command completion and parameter prompting

Press the Tab key to complete a partially-typed command. If the tab key is unable to uniquely identify

a command, (for example, co could be completed as configure or copy) the console does a

partial-completion of the command (completing only the characters which are common to the multiple

commands).

Example 5.1: # con<tab>

# configure

The ? (question mark) key has three functions:

To list commands the user can enter.

When added to the end of a partially-typed set of characters, the CLI console lists

commands that start with the current fragment. When separated from the command by one or more spaces, the console lists valid

additional commands, parameters or values that must follow the currently typed

command, on the same line. Example 5.2:

#?

show

configure Enter configuration mode

dir Show files in user folder

end Return to root mode

erase Remove file from user dir

LUMINATO CLI MANUAL

13-Apr-11 5(63)

help Display help for the CLI

list Print a list of available commands

passwd Change current user password

ping Ping destination address

reboot Reboot the whole device immediately

traceroute Trace the route of a remote host

exit Exit current mode

logout Logout from CLI

Example 5.3:

# configure

(configure) # c?

cas Enter CAS mode

configure Enter configuration mode

clock Time related commands

copy Copy specified files in or out from the device

(configure) # clock ?

set Set time if clock source is local

source Set clock source

timezone Set timezone

<cr> Time related commands

CLI command-line editor

In the CLI, you can use keyboard sequences to navigate and edit a

command line. You can also use keyboard sequences to scroll through a

list of recently executed commands. The following table lists the line-editing

keys that are available in the CLI.

Table 6-1: CLI command-line keystrokes

Keystroke Result

Backspace Deletes one character left of cursor Delete Deletes the current character Enter Executes command Tab Completes command entry Right arrow Move the cursor forward one character Left arrow Move the cursor back one character Up arrow Scrolls backward through all commands in the history buffer starting from the

most recent one. Repeat keystroke to recall successively more recent commands. Down arrow Scrolls forward through all commands in the history buffer after recalling the

commands using up arrow-key. Repeat keystroke to recall successively more recent commands.

<ESC> + B Move the cursor back one word <ESC> + C Converts the rest of the word to uppercase <ESC> + D Deletes the remainder of the word <ESC> + F Moves forward one word <ESC> + L Converts the rest of the word to lowercase <CTRL> + A Moves the cursor to the beginning of the command line <CTRL> + B Move the cursor back one space

LUMINATO CLI MANUAL

13-Apr-11 6(63)

<CTRL> + C Aborts current line (aborts a command if running) <CTRL> + D Deletes the character at the cursor <CTRL> + E Move the cursor to the end of the command line <CTRL> + F Move the cursor forward one character <CTRL> + K Deletes all characters from cursor position to the end of command line <CTRL> + N Scrolls forward through the list of recently executed commands.

Note: you have to first scroll backwards using <CTRL> + P or up arrow before using this command

<CTRL> + P Scrolls backward through all commands in the history buffer starting from the most recent one.

<CTRL> + T Transpose the character to the left of the cursor with the character located at the cursor <CTRL> + U Deletes all characters on line to left of the cursor position <CTRL> + W Deletes the word directly before cursor <CTRL> + Z Enters command and then returns to root prompt

NO commands

The [no] form of a command is used to negate a specific function. Elements with one pa-rameter supports the [no] form automatically. If the element has two or more parameters,

you must specify for which parameter the [no] is designated to.

It is important to specify this as it can have varying effects depending on the command,

such as:

disabling the feature

disabling a particular option of the feature

restoring default settings

removing a single entry which was previously configured

LUMINATO CLI MANUAL

13-Apr-11 7(63)

CLI syntax conventions

This document uses certain conventions to show the syntax of commands. Please note that the notations are not part of the command itself, but indicates the choices for entering the command.

Table 8.1: CLI syntax conventions

Syntax Description

<..> Angle brackets indicate a value or parameter which is position dependent and does not have keywords

[…] Brackets enclose optional entries which can be included or excluded {…} Braces enclose two or more entry choises. One and only one choice

can be entered. [word < a | b>] Brackets and vertical line within brackets indicate a required choice

within an optional entry ipaddress and host names

Wherever an IP address is required, you can also enter a host name. Note: hostname must be a fully qualified domain name (FQDN)

Script files You can create a script file to simplify repetitive tasks

LUMINATO CLI MANUAL

13-Apr-11 8(63)

2. CLI commands

This chapter provides detailed description of each Luminato CLI commands.

Commands are arranged by functional groups.

Navigation commands

logout

Exit CLI.

The terminal session will be closed immediately.

help

Display help for the CLI.

list

show all-commands

Display a list of all available commands.

end

Return to root mode.

exit

Exit mode/CLI.

configure

Enter configuration mode.

show

Shows current system status.

System maintenance

show date

Display current day and time.

show uptime

Display uptime for all modules.

LUMINATO CLI MANUAL

13-Apr-11 9(63)

show version

Display the current SW image information

show module

Shows all available modules.

show module <main|psu|0-7>

Shows module information.

reboot module <1-6>

Immediately reboots defined module. Allowed value from 1 to 6.

reboot

Immediately reboots the whole device

Host configuration

show hostname

Shows the Luminato host name.

configure hostname <string>

Sets the Luminato host name. The host name is shown as part of the command line prompt and included with the system log information.

show ip address

Show IP settings for management ports.

configure ip address {mgmt1 | mgmt2} dhcp

configure ip address {mgmt1 | mgmt2} <N.N.N.N>/<0-32> <G.G.G.G>

configure ip address {mgmt1 | mgmt2} <N.N.N.N> <M.M.M.M> <G.G.G.G>

Parameter Definition

<N.N.N.N> IP address <0-32> Netmask <M.M.M.M> Netmask <G.G.G.G> Gateway

LUMINATO CLI MANUAL

13-Apr-11 10(63)

Set IP address of management interface. Choose dhcp or give static values for ip address, netmask, and gateway.

configure ip gateway {mgmt1 | mgmt2} <G.G.G.G>

Set or change the gateway address of management interface.

configure ip default {mgmt1 | mgmt2}

Set management interface as default gateway.

show ip route

Display the IP routing table

configure ip route <N.N.N.N> <N.N.N.N> <N.N.N.N> {mgmt1 | mgmt2}

Parameter Definition

<N.N.N.N> Destination IP address <N.N.N.N> Destination IP mask <N.N.N.N> IP address of forwarding router {…} Physical interface

Creates a static route on device. Example:

#configure ip route 192.168.150.0 255.255.255.0 0.0.0.0 mgmt1

configure no ip route <destination> [<netmask > [<gate-way>]]

Remove a specific static route

ping <ipaddress>

Ping defined IP address.

Sends a series of five ICMP echo requests to the specified IP address and reports whether the Luminato successfully received an echo response for each request.

traceroute <ipaddress>

Trace route to defined IP address.

Records the source of each ICMP “time exceeded” message to provide a trace of the path the packet took to reach the destination as well as where routing breaks down.

LUMINATO CLI MANUAL

13-Apr-11 11(63)

configure load sw <url>

Update device software using URL. Ask for confirmation, showing current version number.

Terminal

Terminal specific commands are available to all users. Commands are used to cus-tomize terminal parameters.

show terminal

Shows summary of terminal settings.

show terminal length

Shows current terminal length. By default is 40.

configure terminal length %d

Set terminal length. Allowed values from 0 to 255.

Value 0 disables pagination automatically.

show terminal pagination

Shows current pagination settings.

configure terminal pagination

Enable terminal output pagination.

configure terminal no pagination

Disable terminal output pagination.

show terminal timeout

Shows current terminal timeout value.

configure terminal timeout %d

configure terminal no timeout

Set timeout to automatic logout if user is inactive. Units are seconds

Allowed value from 60 till 43200 (12 hours). Default value is 900 seconds (15 mi-nutes).

LUMINATO CLI MANUAL

13-Apr-11 12(63)

show terminal vt100-colours

Show colors usage in terminal outputs.

configure terminal vt100-colour

configure terminal no vt100-colour

Enable\Disable colors usage in terminal outputs.

By default VT100 -colors are enabled.

User accounts

passwd

Change current user password

show user

Show list of users

configure no user %s

Remove user

configure user %s group <admin|oper>

Create/assign user to specific group

configure user %s group <admin/oper> password %s

Create/assign user to specific group only and define password

configure user %s password %s

Define password for user

Device services

show ntp

Shows NTP/Current time source configuration and status.

LUMINATO CLI MANUAL

13-Apr-11 13(63)

clock source ntp

clock source local

clock source dvb input <connector>

Set source for clock update.

clock timezone %tz

Set timezone.

clock set hh:mm:ss [dd mm yyyy]

Set time if clock source is local.

ntp server <1-3> <%ipaddress>

no ntp server <1-3>

Set/clear ntp server ip address.

Example:

#clock source ntp

#clock timezone Europe/Helsinki{+0200}

#ntp server 1 194.100.206.70

logging server <1-4> <%ipaddress>

no logging server <1-4>

Set/clear syslog server ip address.

[no] logging level <level> [<target> [<target> […]]]

Enable/disable logging by severity and by target, where target= <volatile|non-volatile|trap|external>. Level=syslog levels <emergen-cy|alert|critical|error|warning|notice|information>.

Note: In most cases it is recommended to use volatile (RAM-memory) as target ra-ther than non-volatile (FLASH). Write-operations to non-volatile flash memory re-duces the lifetime of the component itself.

Example 1: configuring internal syslog server

LUMINATO CLI MANUAL

13-Apr-11 14(63)

#configure

#logging level emergency non-volatile

#logging level alert non-volatile

#logging level critical volatile

#logging level error volatile

#logging level warning volatile

#logging level notice volatile

#logging level information volatile

#exit

Example 2: configuring external syslog server

#configure

#logging server 1 192.168.1.2

#logging level emergency external volatile trap

#logging level alert external volatile trap

#logging level critical external volatile trap

#logging level error external volatile trap

#logging level warning external volatile

#logging level notice external volatile

#logging level information external volatile

#exit

show logging volatile

show logging non-volatile

Show internal log files.

[no] snmp-server

Enable/disable snmp server.

snmp-server location <string>

snmp-server contact <string>

Set snmp server strings.

[no] snmp-server community <string> <ro|rw>

Add/remove snmp community string permissions.

[no] snmp-server enable traps

Enables/disables traps.

LUMINATO CLI MANUAL

13-Apr-11 15(63)

[no] snmp-server host <ip>

Add/remove snmp trap target.

Example: snmp-system setup

#snmp-server

#snmp-server location “Dark room”

#snmp-server contact [email protected]

#snmp-server enable traps

#snmp-server host 192.168.1.2

#snmp-server community public ro

#snmp-server community private rw

Device configuration

Configuration management

configure eraseconf COMMIT

Remove configuration from device and reboot it.

Note: IP settings will remain the same.

configure factorydefaults COMMIT

Restore factory defaults settings.

show running-config

Shows running configuration as series of CLI-commands.

File commands

With file commands it is possible to access Luminato internal file-system and trans-fer some files to/from the unit.

commands are available at configure level.

LUMINATO CLI MANUAL

13-Apr-11 16(63)

copy <command-name> <target>

Execute command and send output to target.Supports TFTP.

Example: Copy running-config to receiving tftp-server.

# configure

# copy running-config tftp://192.168.1.2/device-conf.txt

Note: this command uses tftp-server port 69 as default.

Available command-names are:

running-config

volatile-log

non-volatile-log

Local volatile and non-volatile syslog file

tech-support-file level <1-4>

Generates tech-support file.

configuration-snapshot

Generates a complete configuration snapshot in binary format.

copy <source> <command-name>

Restore running configuration to device from source. Supports TFTP and HTTP. Example:

# configure

# copy tftp://192.168.1.2/device-conf1.txt running-config

# copy http:// 192.168.1.2/device-conf2.txt running-config

# exit

Note: configurations are appended to the existing device configuration. You may need to erase configuration beforehand by eraseconf –command.

Available target and source types are:

tftp://host/path

http://host/path (source only)

<filename>

File IO commands for PSI table operations:

copy <filename> <target>

Copy file to url.

LUMINATO CLI MANUAL

13-Apr-11 17(63)

copy <source> <filename>

Copy from url to file.

dir

show files

Show PSI folder file listing. Name/Size/date/.

erase file <filename>

Delete file in psi/si folder. Asks for confirmation.

Global settings

configure management-port-mode common

configure management-port-mode separate

Mode selection for management ports mgmt1 and mgmt2.

Common: both ports acts as switching hub ports. Note: in common mode mgmt2 uses mgmt1 configuration.

Separate: both ports acts as separate ethernet network interfaces.

configure payload-port-mode common

configure payload-port-mode separate

Payload SFP port mode selection, switching or separate interfaces.

Common: both ports acts as gigabit switching hub ports. Note: in common mode GE2 uses GE1 configuration.

Separate: both ports acts as separate gigabit ethernet network interfaces.

configure license chassis %key

Configure license key to selected device.

configure license interface <1-6> %key

Configure license key to selected device.

LUMINATO CLI MANUAL

13-Apr-11 18(63)

configure redundant-stream autorecovery timeout <0-3600>

Set stream redundancy stream autorecovery timeout in seconds

Conditional access system config level

Configure SCS.

configure cas

Enter CAS level. Note: Scrambler license required.

package %name ac %ac

no package %name

Add/remove package-to-ac mapping entry.

configure cas [no] <extended-cp>

Change extended crypto-period setting

Note: In most cases the default value should not be changed. This function is for some special setups only.

ECM generator sublevel

Enter ECMG level.

configure cas ecmg %idx

Enter/create ECMG level entry. User can select idx to use.

configure cas no ecmg %idx

Remove ECMG entry

no shutdown

shutdown

Enable\Disable ecmg.

description %s

Set human-readable description.

ip address %addr[:%port]

Set ip address/port to connect to.

LUMINATO CLI MANUAL

13-Apr-11 19(63)

port %port

Set ip port to connect to.

super-cas-id %d

Set value in protocol header.

spare ip address %addr[:%port]

Set secondary ip address/port to connect to.

spare port %port

Set secondary ip port to connect to.

version %ver

Set protocol version.

cp %period

Set crypto-period time.

channel-id %

Set channel id value.

privatebytes <data>

Set ecmg default private bytes (in hex format).

Example:

# configure cas ecmg 1 privatebytes 0xaabbccdd

ECM stream subsublevel

Enter ECM stream level.

configure cas ecmg %idx stream %idx

Enter/create ECM stream level entry. User can select idx to use.

configure cas ecmg %idx no stream %idx

Remove ECM stream entry

LUMINATO CLI MANUAL

13-Apr-11 20(63)

no shutdown

shutdown

Enable\Disable ecm stream request.

description %s


package %name

Request ecm for access criterion named name.

ecm-id %id

Set protocol field ecm-id.

cwg-id %id

Set protocol field cwg-id.

privatebytes <data>

Set ecmg stream private bytes (in hex format).

Example:

# configure cas ecmg 1 stream 5 privatebytes 0x11223344

EMM sublevel

Enter EMM level.

configure cas emm %idx

Enter/create EMM level entry. User can select idx to use.

configure cas no emm %idx

Remove EMM entry

LUMINATO CLI MANUAL

13-Apr-11 21(63)

no shutdown

shutdown

Enable\Disable emm.

description %s


client-id %d

Set clientid field value. Included in outputs according to this value.

port %d

Set TCP/UDP port that the associated ecmgw listens to.

data-id %d

Set dataid field value.

bandwidth %d

Set bw field value.

datatype <emm|private|other|any>

Set datatype field value.

privatebytes <data>

Set emm stream private bytes (in hex format).

Example:

# configure cas emm 1 privatebytes 0xFF0011DD

LUMINATO CLI MANUAL

13-Apr-11 22(63)

Redundancy settings

Configuration commands for 1+1 backup

redundancy role standalone

redundancy role master

redundancy role backup

redundancy role disabled

Set redundancy role for this device.

redundancy monitor cable

redundancy monitor network

redundancy monitor all

Set how backup device monitors the main device’s state.

The state can be monitored via cable, ip network or both.

redundancy trigger hw-fail

redundancy trigger signal-fail

redundancy trigger all

Set trigger events for fail-over switching.

redundancy peer-ip address %a

Set peer device ip address for peer-to-peer communication.

redundancy vpn key %s

Set vpn key for peer-to-peer communication. Print out MD5 sum of the key.

redundancy vpn generate-key

Generate a vpn key for peer-to-peer communication. Print out both the key and MD5 sum of the key.

redundancy common-ip address %a [netmask %m]

Set common management address.

redundancy test-mode

no redundancy test-mode

Turn on/off test mode (outputs active).

LUMINATO CLI MANUAL

13-Apr-11 23(63)

Action commands

These commands does not change any settings of the device.

redundancy do config-copy

Initiate 1+1 configuration copy from the peer.

redundancy do handover

Initiate 1+1 handover

redundancy do recovery

Initiate 1+1 recovery from handover state

Ext mode settings

ext-io <ext1|ext2> mode <off|user-input|user-output|backup-power-alarm|intrusion-alert>

Set EXT1/2 connector functional mode

ext-io <ext1|ext2> user-output <high-z|pullup>

Set user output driving mode

ext-io <ext1|ext2> user-input severity <emergen-cy|alert|critical|error|warning|notice|informational|debug>

Set syslog severity level for sent syslog messages

ext-io <ext1|ext2> user-input trigger <down|up|both>

Set when to report user input pin status

Environment

Common

show environment [<temperature|voltage|current|fan>]

Shows a state summary of the selected or all environments.

Temperature

show environment temperature [<device|psu|1-6>]

Shows current temperature on selected device: device (main board), psu (main power supply),1-6 (module).

LUMINATO CLI MANUAL

13-Apr-11 24(63)

show environment temperature [<device|psu|<1-6>>] threshold

Shows temperature threshold settings on selected device.

configure environment temperature <[all]/device/psu/module <1-6>> threshold <lolo> <lo> <hi> <hihi>

Configure temperature threshold settings on selected device.

Example:

# configure environment

(environment) # temperature module 1 threshold 5 10 85 90

(environment) # exit

(configure) # exit

#

Voltage

show environment voltage [<device|backup|diode>]

Shows actual voltage on selected device: device (main power supply), backup (backup power supply) or diode (serial diode voltage for backup detection)

show environment voltage <device|backup|diode> threshold

Shows voltage threshold settings on selected device

configure environment voltage <device/backup/diode> threshold <lolo> <lo> <hi> <hihi>

Configure voltage threshold settings on selected device. These values are used for warning and alarm indications.

Current

show environment current

Shows real-time current consumption value measured in power supply.

show environment current threshold

Shows current threshold settings on selected device

configure environment current threshold <lolo> <lo> <hi> <hihi>

Configure current threshold settings on selected device

LUMINATO CLI MANUAL

13-Apr-11 25(63)

Fan

show environment fan <1-4>

Shows all metric values for selected fan

show environment fan rpm <1-4>

Shows rpm value for selected fan

show environment fan dutycounters <1-4>

Shows duty counter value for selected fan

configure environment no fan dutycounters <1-4>

Reset fan duty counter value

configure environment fan max

Set maximum speed for all fans.

Configure environment fan auto

Fan speed is adjusted automatically according to internal temperature measure-ment.

Interfaces

Interfaces common commands

configure interface <type> <input/output> %a/%b

Enter into interface configuration mode for specified connector.

configure interface <type> <input/output> %a/%b.%c

Enter into interface configuration mode for specified transport stream.

If interface does not exists it will be created.

exit

Exit interface configuration mode.

All changes are also applied.

LUMINATO CLI MANUAL

13-Apr-11 26(63)

Common commands in interface configuration mode

no shutdown

shutdown

Enable\Disable interface.

When user enables output interface it starts to stream out. It will also enable processing for that interface.

User can enable output interface by enabling processing.

Note: Output interfaces are disabled by default.

Example session:

# configure

# interface ip output 1/1.1

# udp 10.9.96.1

# port 5000

# no shutdown

# end

description <alias>

no description

Defines\Remove alias name to/from the interface.

Management interfaces

configure interface {mgmt1 | mgmt2}

Enter module configuration mode.

ip address <ipaddress> [<netmask>]

ip address dhcp

Set host IP address to static or dhcp.

mtu <value>

Set MTU value.

LUMINATO CLI MANUAL

13-Apr-11 27(63)

no shutdown

shutdown

Enable/disable the interface.

upgrade-management-mac-address COMMIT

Update MGMT2 mac address. Special command for downwards compatibility rea-

sons. Do not use unless specfically adviced by Teleste service personnel.

Gigabit SFP interfaces

Commands related to the payload ports.

configure interface {ge1|ge2}


no shutdown

shutdown

Enable\Disable port.

mode fiber

mode electrical

Define electrical only/fiber compatible mode.

Module interfaces

configure interface <1-6>


configure interface <module> [no] <cplatency>

Change crypto-period latency setting

Note: In most cases the default value should not be changed. This function is for some special setups only.

Payload IP settings

ip address <IP address> <netmask> {ge1|ge2}

Set IP settings for module (default 0/1) payload port.

LUMINATO CLI MANUAL

13-Apr-11 28(63)

ip default gateway <IP address> {ge1|ge2}

Set IP settings for module. (default 0/1)

[no] payload-source-port <0-65536>

Set source UDP port for transmitted streams

virtual-ip-address <N.N.N.N>

no virtual-ip-address

Set virtual source IP address for transmitted streams.

PID and SID system settings

timeout pid <nn>

Define time out for PID in module [1..99] seconds.

Warning is rised after PID bitrate has been zero for nnn seconds.

timeout warning <nnn>

Define warning time out for service/input in module [1..99] seconds.

Warning is rised after service or input bitrate has been zero for nnn seconds.

sid range <aaa> <bbb>

Define SID range for module.

sid upper-range <aaa> <bbb>

Define upper SID range for module.

sid step <nnn>

Define SID step for module.

pid range <aaa> <bbb>

Define PID range for module.

Commands for CAM access

These commands are supported only by the modules that have CI-slots (dual DVB-T, DVB-S etc).

LUMINATO CLI MANUAL

13-Apr-11 29(63)

cam [a|b] routing input %b.%c

cam [a|b] routing none

no cam [a|b] routing

Route input streams thru CA modules.

cam [a|b] routing none have the same affect.

cam [a|b] failure-action timeout %t

Set timeout (seconds) for CA module failure detection. CA module is given this time to start descrambling after CA module boot up or reconfiguration, before failure de-tection is started.

cam [a|b] failure-action pmt-refresh [off|%n]

cam [a|b] failure-action cam-reset [off|%n]

cam [a|b] failure-action [no] module-reset

Set the desired action(s) for CA module failure correction.

Example: cam a setup on receiver module

#cam a failure-action timeout 15

#cam a failure-action pmt-refresh off

Scrambling commands

ca-descriptor mode {default|es|program|program_es}

Set CA descriptor mode. That is, the position of ca_descriptor inserted on scram-bling into PMT tables.

Special commands

DVB-T mode.

cofdm-transmission-mode <8k|2k>

Sets COFDM transmission mode. Tell user to reboot the module.

configure redundant-stream autorecovery timeout <de-fault|0-36000>

Set stream redundancy stream autorecovery timeout in seconds

LUMINATO CLI MANUAL

13-Apr-11 30(63)

Input interfaces

Input interfaces common commands

shutdown

no shutdown

Turn on/off reception from the input.

description <string>

Gives an alias name for the input stream.

critical

no critical

Enable\Disable critical flag for inputs.

psi-capture pid <pid> table-id <id> [table-id-extension <id>] [<current|next>]

Stream redundancy commands

These commands are available for all inputs.

redundant-stream <0-5> input %b.%c

Add redundant stream reference to the selected input.

redundant-stream <[0-5]> monitoring <periodical | conti-nuous>

Choose periodical or continuous monitoring for the selected redundant stream.

In continuous mode the input is monitored continuously and in periodical mode each input is monitored in five minutes interval. The advantage of the continuous mode is rapid input status update for automatic recovery.

Note: The drawback of the continuous mode is that if inputs are multicast IP-streams they keep joined even if they are not active.

If input monitoring mode is set to periodical the deactivated input is disabled and IGMP-leave is sent.

LUMINATO CLI MANUAL

13-Apr-11 31(63)

[no] redundant-stream <[0-5]> trigger <sig-nal|service|pid|auto-recover> [<signal|service|pid|auto-recover>] [<signal|service|pid|auto-recover>] [<sig-nal|service|pid|auto-recover>]

Choose automatic fail-over triggers for selected redundant stream(s).

Available triggers:

Trigger Description

signal Signal lost. Input bitrate drops zero (by default) or below user defined bitrate. This trigger is recommended for all setups.

service Service missing. All input pids are missing for configured services or service information is not present.

pid Manually added output PID is missing from the input auto-recover When fail-over switching to redundant input is done, the input is switched

to highest priority input having OK status instead of next in priority order.

no redundant-stream <0-5>

Disable redundant stream.

redundant-stream <0-5> activate

Manually activate certain input among redundancy group.

redundant-stream critical

no redundant-stream critical

Mark/unmark the redundancy as critical.

configure signal-lost-threshold <0-400000>

Signal lost warning threshold in kbit/s.

configure redundant-stream autorecovery timeout <de-fault|0-36000>

User can set the time to wait (in seconds) before automatic recovery is tried. The timeout is calculated starting from the moment when input status has been moni-tored ok.

LUMINATO CLI MANUAL

13-Apr-11 32(63)

configure timeout pid <nn>

Define PID missing timeout in [1..99] seconds. PID timeout is used to define the time before redundant input is activated due to this trigger. This setting affects also to PID missing –warning indication.

configure timeout warning <nnn>

Define warning timeout for service/input-missing in [1..99] seconds. Warning timeout is used to define the time before redundant input is activated due to related trigger.

Configuration example:

# configure interface ip input 1/1.1

# redundant-stream autorecovery timeout 10

# redundant-stream input 1.1

# redundant-stream monitoring continuous

# redundant-stream trigger auto-recover pid service signal

# redundant-stream 1 input 1.2

# redundant-stream 1 monitoring continuous

# redundant-stream 1 trigger auto-recover pid service signal

# udp 239.2.1.1

# port 1234

# payload-port ge1

# description "BBC-news"

# no shutdown

# exit

ASI Inputs

configure interface asi input %a/%b

Disable selected ASI input interface or enter to configuration mode for ASI input.

DVB-S Inputs

configure interface dvbs\dvbs2 input %a/%b

Enter to configuration mode for dvbs\dvbs2 input.

DVB-S Inputs configuration mode commands

DVB-S settings.

sat frequency %i

Defines SAT frequency in Hz

LUMINATO CLI MANUAL

13-Apr-11 33(63)

lnb frequency %i

Defines LNB frequency in Hz

symbolrate auto

symbolrate <%i>

Defines symbolrate in sym/sec

modulation auto

modulation QPSK

modulation 8-PSK

modulation 16-APSK

modulation 32-APSK

Defines modulation. Lowercase is also accepted.

no spectral inversion

spectral inversion

spectral inversion auto

Defines spectral inversion

frequency offset limit %i

Defines frequency offset limit in Hz

no lnb voltage

lnb voltage 13v

lnb voltage 18v

Defines LNB voltage

no lnb 22khz

lnb 22khz

Defines LNB 22kHz settings

no lnb long line compensation

lnb long line compensation

Defines long line compensation settings

LUMINATO CLI MANUAL

13-Apr-11 34(63)

lnb low current %i

Defines LNB low current settings

lnb high current %i

Defines LNB high current settings


# configure

(configure) # interface dvbs2 input 1/1

(iface-dvbt-input-1/1)# sat frequency 10000000000

(iface-dvbt-input-1/1)# modulation auto

(iface-dvbt-input-1/1)# spectral inversion auto

(iface-dvbt-input-1/1)# shutdown

(iface-dvbt-input-1/1)# lnb frequency 9750000000

(iface-dvbt-input-1/1)# symbolrate 1000000

(iface-dvbt-input-1/1)# no lnb voltage

(iface-dvbt-input-1/1)# no lnb 22khz

(iface-dvbt-input-1/1)# no lnb long line compensation

(iface-dvbt-input-1/1)# lnb low current 0

(iface-dvbt-input-1/1)# lnb high current 750

(iface-dvbt-input-1/1)# critical

(iface-dvbt-input-1/1)# exit

(configure)# exit

DVB-T Inputs

configure interface <dvbt> input %a/%b

Enter configuration mode for DVB-T/DVB-T2 input interface.

DVB-T Inputs configuration mode commands

DVB-T settings.

rf frequency %i

Defines RF frequency in Hz

LUMINATO CLI MANUAL

13-Apr-11 35(63)

modulation auto

modulation QPSK

modulation 16-QAM

modulation 64-QAM

Defines modulation. Lowercase is also accepted.

bandwidth 6MHz

bandwidth 7MHz

bandwidth 8MHz

Defines bandwidth

transmission mode auto

transmission mode 2k

transmission mode 8k

Defines transmission mode

guard-interval auto

guard-interval 1/4

guard-interval 1/8

guard-interval 1/16

guard-interval 1/32

Defines guard interval settings

no hierarchy

hierarchy auto

Defines hierarchy settings

no spectral inversion

spectral inversion

spectral inversion auto

Defines spectral inversion

LUMINATO CLI MANUAL

13-Apr-11 36(63)

fec rate low auto

fec rate low 1/2

fec rate low 2/3

fec rate low 3/4

fec rate low 5/6

fec rate low 7/8

Defines fec mode low settings

fec rate high auto

fec rate high 1/2

fec rate high 2/3

fec rate high 3/4

fec rate high 5/6

fec rate high 7/8

Defines fec mode high settings

frequency offset limit %i

Defines frequency offset limit in Hz


# configure interface dvbt input 1/1

(iface-dvbt-input-1/1)# rf frequency 738000000

(iface-dvbt-input-1/1)# modulation auto

(iface-dvbt-input-1/1)# spectral inversion auto

(iface-dvbt-input-1/1)# description "MTV MUX"

(iface-dvbt-input-1/1)# no shutdown

(iface-dvbt-input-1/1)# bandwidth 8MHz

(iface-dvbt-input-1/1)# transmission mode auto

(iface-dvbt-input-1/1)# guard-interval auto

(iface-dvbt-input-1/1)# hierarchy auto

(iface-dvbt-input-1/1)# fec rate low auto

(iface-dvbt-input-1/1)# fec rate high auto

(iface-dvbt-input-1/1)# critical

(iface-dvbt-input-1/1)# exit

LUMINATO CLI MANUAL

13-Apr-11 37(63)

IP Inputs

configure interface ip input %a/%b.c%

Create/edit configuration mode to selected IP input interface. Physical connector %b must be always 1

configure no interface ip input %a/%b.c%

Delete selected IP input interface. Physical connector %b must be always 1. %c is from 1 to 128.

Print an informational message when entering the interface level, telling whether the user creates a new entry or enters an existing entry.

IP Inputs configuration mode commands

IP settings

udp <ip_address:port>

Define interface destination IP (multicast group) and port

udp <ip_address>

Define interface destination IP (multicast group)

port <port>

Define interface destination port

src-ip <ip_address>

[no] src-ip

Define interface source IP-address

payload-port internal

payload-port ge1

payload-port ge2

payload-port all

Define payload port. Note: fuctionality depends of the payload port mode

Output interfaces

Output interfaces common commands

Service/pid config is common, see the dedicated chapters.

LUMINATO CLI MANUAL

13-Apr-11 38(63)

shutdown

no shutdown

Turn on/off IP/QAM/DVBT/ASI streaming.

description <string>

Gives an alias name for the input stream.

IP Outputs

configure no interface ip output %a/%b.%c

Delete IP output.

configure interface ip output %a/%b.%c

Enter or create configuration mode for selected IP output interfaces at slot %a. Physical connector %b must be 1.

Slot value range is from 1 to 6.

Print an informational message when entering the interface level, telling whether the user creates a new entry or enters an existing entry.

IP Output configuration mode commands

IP settings. These are available both for IP outputs and QAM/etc outputs with mux ip streamer.

udp <ip_address:port>

Define interface destination ip and port

udp <ip_address>

Define interface destination IP

no udp

Disable MUX IP streamer output on non-ip outputs.

port <port>

Define interface destination port

LUMINATO CLI MANUAL

13-Apr-11 39(63)

ts-packets <1-7>

Defines count of TS packets in one IP packets

ttl <ttl>

Define interface TTL

payload-port internal

payload-port ge1

payload-port ge2

payload-port all

Define payload port. Note: functionality depends on the payload port mode.

[no] null-pid-filter

Enable/disable null PID filter on non-ip outputs.

QAM Outputs

configure interface qam output %a/%b

Enter to module wide QAM configuration mode for physical output %b. Must be 1.

configure interface qam output %a/%b.%c

Enter to specific QAM output configuration mode. Physical connector %b must be 1

QAM Outputs physical connector level configuration mode

This mode defines global settings for QAM outputs for module.

shutdown

no shutdown

Turn on/off DVB-C transmission.

frequency %i

Defines frequency in Hz

offset %i

Frequency offset for QAM outputs in Hz

LUMINATO CLI MANUAL

13-Apr-11 40(63)

symbolrate %i

Defines symbolrate in sym/sec.

modulation 4-QAM

modulation 8-QAM

modulation 16-QAM

modulation 32-QAM

modulation 64-QAM

modulation 128-QAM

modulation 256-QAM

Defines modulation.

power level %i

Defines power level in dBuV.

rolloff 12

rolloff 15

rolloff 18

Defines rolloff in %.

power mode normal

power mode prbs

power mode power

Defines power mode.

output spectrum normal

output spectrum inverted

Defines output spectrum.

LUMINATO CLI MANUAL

13-Apr-11 41(63)

QAM Outputs configuration mode

This mode defines settings for selected QAM outputs

shutdown

no shutdown

Turn on/off DVB-C transmission.

modulation default

modulation 4-QAM

modulation 8-QAM

modulation 16-QAM

modulation 32-QAM

modulation 64-QAM

modulation 128-QAM

modulation 256-QAM

Defines modulation for specific QAM output

power mode default

power mode normal

power mode prbs

power mode power

Defines power mode for specific QAM output

DVB-T Outputs

configure interface cofdm output %a/%b

Enter to module wide DVB-T configuration mode for physical output %b. Must me 1.

configure interface cofdm output %a/%b.%c

Enter to specific QAM output configuration mode. Physical connector %b must be 1

DVB-T Outputs module wide configuration mode

This mode defines global settings for DVB-T outputs for module.

shutdown

no shutdown

Turn on/off DVB-T transmission.

LUMINATO CLI MANUAL

13-Apr-11 42(63)

frequency %i

Defines frequency in Hz

offset %i

Frequency offset for DVB-T outputs in Hz

modulation QPSK

modulation 16-QAM

modulation 64-QAM

Defines modulation.

power level %i

Defines power level in dBuV.

power mode normal

power mode prbs

power mode power

Defines power mode.

output spectrum normal

output spectrum inverted

Defines output spectrum.

bandwidth 6MHz

bandwidth 7MHz

bandwidth 8MHz

Defines output channelwidth.

fec rate 1/2

fec rate 2/3

fec rate 3/4

fec rate 5/6

fec rate 7/8

Defines output fec.

LUMINATO CLI MANUAL

13-Apr-11 43(63)

guard-interval 1/4

guard-interval 1/8

guard-interval 1/16

guard-interval 1/32

Defines output guard interval.

DVB-T Outputs configuration mode

This mode defines settings for selected DVB-T outputs

shutdown

no shutdown

Turn on/off DVB-T transmission.

modulation default

modulation QPSK

modulation 16-QAM

modulation 64-QAM

Defines modulation.

power mode default

power mode normal

power mode prbs

power mode power

Defines power mode for specific QAM output

fec rate default

fec rate 1/2

fec rate 2/3

fec rate 3/4

fec rate 5/6

fec rate 7/8

Defines output fec puncture rate.

LUMINATO CLI MANUAL

13-Apr-11 44(63)

guard-interval default

guard-interval 1/4

guard-interval 1/8

guard-interval 1/16

guard-interval 1/32

Defines output guard interval.

ASI Outputs

configure interface asi output %a/%b

Disable\Enter edit configuration mode for selected ASI output interfaces at slot %a, connector %b.

Slot value range is from 1 to 6.

ASI Outputs configuration mode

shutdown

no shutdown

Turn on/off ASI transmission.

bitrate %i

Configure ASI output bitrate in bps

Processing

Processing is configured always via referring to output connector.

configure interface <connector>

Enters to configure mode for processing. Referenced connector must be output transport streams.

Example:

LUMINATO CLI MANUAL

13-Apr-11 45(63)

configure

interface qam output 1/1.4

Note: Verify also licenses before trying to configure the device.

Common commands in service configuration mode

mode service

mode pid

Define processing mode.

PID Filtering

PID filtering commands can be used used in pid -mode and service -mode. In ser-vice -mode these pids are included to the output in addition to automatic services and without any automatic references in the tables.

passthrough pids %b.%c mode include

passthrough pids %b.%c mode exclude

Add PID filter for the input in include or exclude mode.

no passthrough pids %b.%c

Remove PID filter for specific input streams

passthrough pids %b.%c pid <aaa>

passthrough pids %b.%c pid <aaa>=<bbb>

no passthrough pids %b.%c pid <aaa>

Add\Remove PID into filter for specific input or add PID with remapping into filter for specific input (only in include -mode).

Example:

passthrough pids 1.1 mode include

passthrough pids 1.1 pid 100

passthrough pids 1.1 pid 101=200

passthrough pids 1.2 mode exclude

passthrough pids 1.2 pid 8191

Service mode commands

ts-id <transport_stream_id >

Defines transport stream id. (0-65535)

LUMINATO CLI MANUAL

13-Apr-11 46(63)

network-id <network_id>

Defines network id (0-35535)

original-network-id <network_id>

Defines original network id (0-35535)

pid-allocation-mode follow

pid-allocation-mode component

pid-allocation-mode sid

Defines the pid –allocation mode. Available modes are: “SID mode”, “Component type mode” and “Input Follow Mode”.

network-name <string>

Defines the network name

Service passthrough

passthrough services <%b.%c>

no passthrough services <%b.%c>

Enable\Disable passthrough from specific input connector. Connector can be lo-cated in the same module only.

passthrough services <%b.%c> sid-filter %sid [%sid […]]

no passthrough services <%b.%c> sid-filter %sid [%sid […]]

Add specific service opt-out filter for specific input connector passthrough entry. Connector can be located in the same module only.

Note: All services are passed through from the defined input by default.

EMM pid

emm-pid <ca-id> auto

emm-pid <ca-id> auto

Automatic EMM PID selection (default) or using specific PID.

ca-id is CA Client id in hexadecimal format (for example 0x01).

LUMINATO CLI MANUAL

13-Apr-11 47(63)

Services configuration

service <user-selected-id>

Enter to service configuration mode and optionally create/select a service id.

no service <user-selected-id>

Remove service configuration with user selected id

service <user-selected-id> input %a.%b sid %sid

Shortcut to add a service.

Print an informational message when entering the service level, telling whether the user creates a new entry or enters an existing entry.

Service configuration mode

no shutdown

shutdown

Enable/disable service

input <%b.%c> sid <sid>

Define the source of the service

output-sid <sid>

Define service id for configured service

no manual-name

manual-name <service-name>

Define service name

descramble cam <a|b>

no descramble

Descramble the service using specified cam if input service is scrambled.

descramble components <1-65536> <[1-8192]>

Choose components for descrambling

LUMINATO CLI MANUAL

13-Apr-11 48(63)

descramble components <all>

Descramble all components

scramble

no scramble

Scramble (or don’t) the output service using DVB scrambling.

ecmg <idx> stream <idx>

no ecmg <idx> stream <idx>

Add/remove ecm association for the service.

base-pid %pid

Set the base pid in component mode pid allocation.

always-in-tables

no always-in-tables

Set always in tables.

critical

no critical

Unmark service as critical /Mark service as critical (default)

ca-mode <automatic|not-scrambled|may-be-scrambled>

Set scrambling status.

no manual-provider-name

manual-provider-name <provider-name>

Define service provider name

type auto

type <nnn>

Specify service type automatically, base on input service (default) or define specific service type. Number can be decimal or hex

LUMINATO CLI MANUAL

13-Apr-11 49(63)

generate pmt

no generate pmt

(Do not) generate PMT table for service

psi-capture pmt file <filename>

Capture generated pmt table.

pmt-pid auto

pmt-pid <pid>

Automatic PMT PID selection (default) or using specific PID.

pcr-pid auto

pcr-pid <pid>

Automatic PCR PID selection (default) or using specific PID.

ecm-pid <ca-id> auto

ecm-pid <ca-id> <pid>

Automatic ECM PID selection (default) or using specific PID.

ca-id is CA Client id in hexadecimal format (for example 0x01).

sdt-eit-mode <automatic|off|present-following|schedule>

Set the mode for EIT flags in SDT

component-filter default {exclude|include}

Defines default state of component filter.

If default state is exclude then filter starts with empty list.

If default state is include then filter starts fully filled by components from incoming service

LUMINATO CLI MANUAL

13-Apr-11 50(63)

[no] component-filter <include\exclude> es-type video <all/max <n> [<languages>]>

[no] component-filter <include\exclude> es-type audio <all/max <n> [<languages>]>

[no] component-filter <include\exclude> es-type ac3 <all/max <n> [<languages>]>

[no] component-filter <include\exclude> es-type subtitle <all/max <n> [<languages>]>

[no] component-filter <include\exclude> es-type teletext <all/max <n> [<languages>]>

[no] component-filter <include\exclude> es-type <nnnn> <all/max <n> [<languages>]>

[no] component-filter <include\exclude> pid <nnnn> [out-put-pid <nnnn>]

[no] component-filter <include\exclude> tag <nnnn> [out-put-tag <nnnn>]

[no] component-filter <include\exclude> ecm-ca-id <nnnn> [output-ecm-ca-id <nnnn>]

Add\Remove include\exclude filter rule to include\exclude component(s) with type video, audio, AC-3 audio, subtitle, teletext or specific type (decimal or hex). If speci-fied all then all such components will be included\excluded. Other way user might specify maximum amount of components to include and languages (defined via comma as three letter codes or * for any). If no language is specified then “any” is assumed (equal to “*”).

pid-, tag- and ecm-ca-id -filters are supporting remapping but only for include rules.

no component-filter

Remove all component filter settings

LUMINATO CLI MANUAL

13-Apr-11 51(63)

An example of a component filter definition where the user explicitly defines which components to have in the service:

Component-filter default exclude

component-filter include es-type video all

component-filter include es-type audio max 2 “eng,fin”

component-filter include es-type ac3 max 1

component-filter include es-type ac3 teletext all

component-filter include es-type ac3 subtitle max 3 “eng,fin,*”

component-filter include es-type 27 max 1

component-filter include pid 1000

component-filter include pid 1001 output-pid 4004

An example of component filter definition where the user explicitly defines which components not to have in the service:

component-filter default include

component-filter exclude es-type ac3 all

component-filter exclude tag 3000

component-filter include es-type audio all

component-filter include es-type audio max 1 “swe”

SI Tables generation

generate pat

generate sdt

generate nit

generate cat

Enable table generation with default interval

generate pat interval <msec>

generate sdt interval <msec>

generate nit interval <msec>

generate cat interval <msec>

Enable table generation with specified insertion interval

LUMINATO CLI MANUAL

13-Apr-11 52(63)

no generate pat

no generate sdt

no generate nit

no generate cat

Disable table generation

TDT\TOT Table generation

no generate tdt-tot

Disable TDT\TOT table generation

generate tdt-tot mode tdt

Enable “TDT only” - table generation from the device local time with the default in-sertion interval.

generate tdt-tot mode tdt interval <msec>

Enable “TDT only” - table generation from the device local time with specified inser-tion interval.

generate tdt-tot mode tdt-tot

Enable TDT- and TOT -table generation from the device local time with default in-sertion interval.

generate tdt-tot mode tdt-tot interval <msec>

Enable TDT- and TOT- table generation from the device local time with specified in-sertion interval.

generate tdt-tot mode input <%b.%c>

Enable TDT and TOT table passthrough from the specified input: <mod-ule.connector>.

The next commands are inserting LTO (local-time-offset) descriptors into TOT table.

Manual LTO can be used to add time offset information for those additional coun-tries which are not supported in Luminato by default.

LTO and manually defined LTO are configured separately. So if you have LTO and manual LTO, and would like to remove it, you have to disable both by two com-mands

LUMINATO CLI MANUAL

13-Apr-11 53(63)

generate tdt-tot lto <country_code> <region_id>

Generate LTO -descriptor in TOT -table for specified county and its region id. The country code shall be three letters.

Example:

generate tdt-lto lto USA 0

no generate tdt-tot lto <country_code> <region_id>

Disable generation of LTO -descriptor for specific country code and region ID

generate tdt-tot lto manual <country_code> <region_id> <time_of_change> <local_time_offset> <next_time_offset> <polarity>

Adding manually defined LTO -descriptor for selected country and region.

Examples:

generate tdt-lto lto manual IND 1 2009-04-10 03:00:00 03:00 02:00 negative

generate tdt-lto lto manual IND 2 2009-04-10 03:00:00 04:00 03:00 negative

generate tdt-lto lto manual USA 5 2009-04-10 03:00:00 04:00 03:00 positive

no generate tdt-tot lto manual <country_code> <re-gion_id>

Remove manually defined LTO -descriptor.

Example:

no generate tdt-lto lto manual USA 5

Other PSI/SI commands

[no] psi-insert pid <pid> interval <msec> file <file-name>

Add/remove table insertion. Available also in pid -mode.

psi-capture <pat|cat|sdt|tdt|tot>

Capture generated tables.

LUMINATO CLI MANUAL

13-Apr-11 54(63)

CBR commands

bitrate vbr

bitrate cbr <bitrate>

Set VBR mode (default), or set CBR and specify the bit rate in kbps (100 - 400 000)

[no] low-packet-jitter-mode

Enable/disable low packet jitter mode.

configure [no] cbr-streaming-strict-mode

Enable/disable CBR streaming strict mode. Strict mode means packets are dropped if CBR output stream is over allocated. In non-strict mode packets are not dropped, which may result bit rate higher than the specified CBR.

Please note that the command is given in configuration level, not on TS level like the other CBR commands above.

Device monitoring

show version

Shows general status for modules.

show modules

Shows general status for modules.

show status

Shows general status for modules and alarm listing.

show licenses

Show summary of licenses. List interface/chassis keys and serial numbers

show licenses chassis

show licenses interface <1-6>

Show SN, key and features for the module.

show redundancy

Shows status of redundancy vpn and this and peer device flags.

LUMINATO CLI MANUAL

13-Apr-11 55(63)

Running configuration

To see configuration, use show running config

show running-config

Shows all running configuration.

show running-config interface <1-6>

show running-config interface <connector>

Shows all running for interface.

show running-config cas

Shows cas config.

CAS system

show cas

Shows summary of ecmg and emms.

show cas ecmg <[%idx]>

Shows ecmg status and ecm summary.

show cas ecmg %idx stream %idx

Shows ecm stream status.

show cas ecmg %idx stream %idx privatebytes

Shows ecmg stream private bytes.

show cas ecmg %idx privatebytes

Shows ecmg default private bytes.

show cas emm

Shows emm summary.

show cas emm %idx privatebytes

Shows emm stream private bytes.

LUMINATO CLI MANUAL

13-Apr-11 56(63)

Ethernet Interfaces

Ethernet interface:

show interfaces {mgmt1 | mgmt2}

Shows management interface status and counters.

show interfaces {ge1 | ge2}

Shows payload interface status and counters.

TS Interfaces

show interfaces {input|output} <1-6>

Shows module status and info. Includes receiver/modulator overview and status.

show interfaces <1-6> cam

Shows CAM module status (“ca module a/b”, “status”).

show interfaces <1-6> ca-descriptor-mode

Shows CA descriptor mode.

show interfaces <connector>

For module level (“ip input a”): show configured inputs/outputs and their status (“in-put/output page”)

IP |Description |SSM |Destination IP |Port |Red|Bitrate|Status

input | | | | |und|(kbps) |

3/1.100| |ON | 224.255.255.255|12345| *3| 4521|OK

IP |Description |Destination IP |Port |Bitrate|Status

output | | | |(kbps) |

3/1.100| | 224.255.255.255|12345| 4521|OK

Dvbs2|Description |Freq |Symbolrate|SNR |FEC|Ber |Bitrate|Status

input| |(MHz) |(ksym/s) | | | |(kbps) |

1/2.1| | 12597| 24500|10.2|2/3|1.3e-8| 36103|OK

Dvb-t|Description |Freq |Mod |SNR |FEC|Ber |Bitrate|Status

input| |(MHz) | | | | |(kbps) |

1/2.1| |714.00|QPSK|24.2|2/3|2.3e-8| 36103|OK

ASI |Description |Bitrate|Status

input| |kbps |

1/2.1| | 36103|OK

COFDM |Description |Freq |QAM/|FEC|Bitrate|Bitrate max|Status

output| |(MHz) |QPSK| |(kbps) |(kbps) |

1/2.1 | |714.00|QPSK|2/3| 21563| 25000|OK

QAM |Description |Freq |Sym.rate|QAM|Bitrate|Bitrate max|Status

output| |(MHz) |ksym/s | |(kbps) |(kbps) |

1/3.1 | 714.00| 6900|256| 45712| 50100|OK

ASI |Description |Bitrate|Bitrate max|Status

LUMINATO CLI MANUAL

13-Apr-11 57(63)

output| |kbps |kbps |

1/2.1 | | 36103| 70000|OK

show interfaces <connector>

For stream (a/b.c): stream summary: output/input page row info + pid/service mode setting(out only) + service names (service mode only).

0 1 2 3 4 5 6 7

123456789123456789123456789123456789123456789123456789123456789123456789

IP input: 3/1.4 Description: blabla

(type specific info here)

Status: Signal lost from input 2

Bitrate: 3860 kbps (onko tämä erikseen dvbs-inputille?)

Redundant streams: (or "No redundancy configured")

Input |Active | Status

3/1.4 | | Signal lost from input 2

3/1.5 | * | OK

3/1.6 | | OK

Mode: Service mode (only output)

Pid allocation mode: SID mode

Services: 53

Passthrough services: 1

Pids: 124

PSI/SI insertions: 5

PID filters: 2

EMM streams:

PID | CA system ID

500 | 3329

501 | 1540

502 | 6147

503 | 3331

------------------------------------------------------------------------

IP type

------------------------------------------------------------------------

IP source address: Any/192.168.0.100

IP destination address: 224.0.3.1

IP destination port: 1234

TTL: 5

TS packets per frame: 7

------------------------------------------------------------------------

DVB-S type

------------------------------------------------------------------------

Lock status: LOCK

Signal strength: 20 %

SNR estimate: 5.9 dB

Post-Viterbi BER: 3.9e-4

Final BER: 0.0e-0

Standard: DVB-S

Frequency: 12597 MHz

Frequency offset: -41365 Hz

FEC rate: 3/4

Modulation: QPSK

Symbol rate: 27499 ksym/s

(TS bitrate: 38012 kbps)

LNB current: 0 %

------------------------------------------------------------------------

DVB-T type

------------------------------------------------------------------------

Lock status: LOCK

Signal strength: 20 %

SNR estimate: 5.9 dB

Post-Viterbi BER: 3.9e-4

Final BER: 0.0e-0

LUMINATO CLI MANUAL

13-Apr-11 58(63)

Transmission mode: 8k

Bandwidth: 8 MHz

Frequency: 12597 MHz

Frequency offset: -41365 Hz

FEC rate (high): 1/2

FEC rate (low): 3/4

Guard interval: 1/32

Hierarchy: Off

Modulation: 64-QAM

(TS bitrate: 38012 kbps)

Interface monitoring

These commands apply for input or output interfaces.

show interfaces <input|output> <connector> services

Shows all services for specified connector. Input services shown for Inputs and Out-puts services shown for Outputs. For each services, status, service name, SID, type (TV/radio), bitrate and CA-status: free/scrambled are shown.

Example:

show interface input 1/1.1 services

SERVICES

Input | SID |Service name |Type|Bitrate|CA mode|Status

1/1.1 |113 |YLE Teema | TV| | Free|OK

1/1.1 |17 |YLE TV1 | TV| | Free|OK

1/1.1 |33 |YLE TV2 | TV| | Free|OK

1/1.1 |3347 |Ohjelmistopäivitykset | 0xc| | Free|OK

1/1.1 |353 |SVT World | TV| |Encrypt|OK

1/1.1 |4369 |YLE Puhe | R| | Free|OK

1/1.1 |4401 |YLEN KLASSINEN | R| | Free|OK

1/1.1 |4433 |YLEMONDO | R| | Free|OK

1/1.1 |81 |YLE FST5 | TV| | Free|OK

show interfaces <input|output> <connector> services %sid

Displays detailed info about the service.

Example 1:

show interfaces input 1/1.1 services 17

SERVICES

Input | SID |Service name |Type|Bitrate|CA mode|Status

1/1.1 |17 |YLE TV1 | TV| | Free|OK

COMPONENTS

PID |Type |PCR|ID |Bitrate | Language

1027|Subtitle (6)| |999| 0|fin

2321|Teletext (6)| |10 | 225|fin

512 | Video (2)| * |1 | 3652|

650 | Audio (4)| |11 | 237|spa

651 | Audio (4)| |15 | 173|dut

Service provider: YLE

PMT PID: 256

PCR PID: 512

Example 2:

Show interfaces output 1/1.2 services 60

LUMINATO CLI MANUAL

13-Apr-11 59(63)

SERVICES

Output | SID |Service name |Type|Bitrate|CAM|Scramble|Status

1/1.2 |60 |YLE TV2 | TV| | | ECMs: |OK

COMPONENTS

PID |Type |PCR|ID |Bitrate | Language

61 | Video (2)| * |2 | 2657|

62 |Teletext (6)| |10 | 227|fin

64 |Subtitle (6)| |999| 0|fin

66 | Audio (4)| |21 | 237|eng

67 | Audio (4)| |25 | 174|dut

Service provider: YLE

PMT PID: 60

PCR PID: 61

Component filters: default include (0 include filter(s), 0 exclude filter(s))

idx |ECM generator |idx|ECM stream

show interfaces <input|output> <connector> emm-pid [ca-id]

Displays emm-pid configuration.

show interfaces <input|output> <connector> services <sid> ecm-pid [ca-id]

Displays ecm-pid configuration.

show interfaces <connector> pids

Shows all PIDs for specified connector. Not available for output interfaces or ip input interfaces.

Example:

show interface input 1/1.1 pids

PIDS

Connector |PID |CC Errors |Bitrate(kbps)|Bitrate peak (kbps)

in 1/1.1 |0 |32 | 16| 27

in 1/1.1 |1 |46 | 16| 27

in 1/1.1 |16 |5 | 0| 13

in 1/1.1 |17 |26 | 25| 41

in 1/1.1 |18 |347 | 476| 560

in 1/1.1 |20 |2 | 0| 13

in 1/1.1 |192 |81 | 101| 123

in 1/1.1 |256 |29 | 16| 27

in 1/1.1 |512 |839 | 4151| 8285

in 1/1.1 |513 |840 | 2653| 8176

in 1/1.1 |514 |785 | 3322| 9078

in 1/1.1 |515 |896 | 2266| 2980

in 1/1.1 |516 |671 | 2750| 8217

in 1/1.1 |581 |141 | 223| 287

in 1/1.1 |8191 |0 | 2929| 8545

configure interface <connector> monitor-pid %pid

configure interface <connector> no monitor-pid %pid

Add/remove manual PIDs for monitoring. Not available for output interfaces or ip in-put interfaces.

LUMINATO CLI MANUAL

13-Apr-11 60(63)

configure interface <connector> clear pid-counters <all|%pid>

Clear pid counters for all pids or optionally for one pid.

3. CLI HOWTO

Work with the “running configuration”

When working with Luminato it is highly encouraged to first setup the working envi-ronment for TFTP -configuration transfer.

Luminato CLI provides file I/O-commands to access the internal file system and to transfer files to/from the unit.

Install and setup TFTP server in your computer (listen to UDP port 69)

Copy running configuration from Luminato to your computer:

# configure

# copy running-config tftp://192.168.1.2/device-conf.txt

# exit

Edit the file device-conf.txt using standard 8-bit ascii-text editor (vi, notepad+ or similar). Note: more advanced text editors may add characters which are not recognized by the CLI and the file becomes unusable.

Replace the original running configuration with the new one:

# configure

# copy tftp://192.168.1.2/device-conf1.txt running-config

# exit

Note also that configurations are appended over the existing device configu-ration. It is a good practice to erase the old configuration beforehand by eraseconf –command prior to updating the whole running configuration.

It is also possible to take just a small part of the configuration and transfer it to the device. If there is only small number of lines to upload it may be feasible to use Copy/Paste-method instead (if your terminal software supports it).

Speed up routine tasks with CLI scriptis

It is many times convenient to create short script files to speed up some routine tasks. You can use your editor editing/search/replace features when working with the files and then upload the file to Luminato. For example

When copying partial or the whole configuration from one module to the other or from one chassis to another. You can for example extract the con-figuration of one module from the running-configuration text file. Or alterna-tively use show-command to display the desired configuration on screen and use copy-paste to extract it on your editor:

show running-config interface 1

Note: don’t forget to change ip-addresses from the file.

LUMINATO CLI MANUAL

13-Apr-11 61(63)

Change outgoing service names. For example ip_output_manual_service_name_main.txt:

interface ip output 2/1.1

service 1

manual-name "MTV3 Pri Main"


service 1

manual-name "Nelonen Pri Main"


service 1

manual-name "Sub Pri Main"


service 1

manual-name "Jim Pri Main"


service 1

manual-name "YLE TV1 Pri Main"


exit

Deleting ip inputs from the module. For example del_ip_inputs_mod3.txt:

no interface ip input 3/1.1





Configure external syslog

Syslog is an industry standard protocol used for capturing log information for de-vices on a network (via UDP port 514). Syslog support is included in Unix and Linux based systems by native, but not in Windows and MacOS. However there are lots of third party applications available to add this capability to your operating system.

Luminato supports detailed logging via Syslog. However the size of the internal log is limited by the available ram memory. Therefore the internal log keeps rotated so that only the latest information remains, when the log becomes full.

This annoying limitation can be overcome by using an external syslog server. In Luminato there can be up to 4 external syslog server.

Example configuration:

LUMINATO CLI MANUAL

13-Apr-11 62(63)

logging server 1 192.168.1.2

logging server 2 192.168.1.3

logging level emergency external volatile

logging level alert external volatile

logging level critical external volatile

logging level error external volatile

logging level warning external volatile

logging level notice external volatile

logging level information external volatile

A syslog message has priority ranging from emergency up to debug, a header which includes timestamp, IP address and message text in ASCII format. For example:

Sep 10 12:30:01 slot1 Module 1: {warning} [Activated] Signal missing (input 2)

Syslog priorities vs. Luminato’s user-interface indicators:

Syslog Luminato Description

0-Emergency Alarm, red The device is unusable 1-Alert Alarm, red Immediate actions required 2-Critical Error, red Critical conditions 3-Error Error, yellow Error conditions 4-Warning Warning, yellow Warning conditions 5-Notification Warning, green Normal, but significant events 6-Informational Notification, green Informational message 7-Debug Notification, green Debug-level messages

Configure stream redundancy

Add primary and redundant inputs. If periodical monitoring mode is going to be used the redundant inputs can be disabled. The primary input should always be enabled.

Example:

! Module 6. Type LQM-A (DVB-C transmitter)

! Interface ip input 6/1.1 configuration

interface ip input 6/1.1

no critical

!

! Redundant streams

!

redundant-stream autorecovery timeout 10

redundant-stream input 1.1

redundant-stream monitoring continuous

redundant-stream trigger auto-recover pid service signal

redundant-stream 1 input 1.2

LUMINATO CLI MANUAL

13-Apr-11 63(63)

redundant-stream 1 monitoring continuous

redundant-stream 1 trigger auto-recover pid service signal

udp 239.12.1.1

port 1234

payload-port ge1

description "Yle1 Pri"

no shutdown

exit

!

! Interface ip input 6/1.2 configuration

!

interface ip input 6/1.2

no critical

udp 239.22.1.1

port 1234

payload-port ge1

description "Yle1 Sec"

no shutdown

exit

This example is setting up one redundant input for QAM.module in slot 6.

In this case “Yle1 Pri”-service is immediately replaced by “Yle1 Sec” when the trig-ger conditions are met (pid or service or signal are missing from “Yle 1 Pri”-input).

“Yle 1 Pri” is automatically restored when the service appears back again and is de-tected to be OK for 10 seconds.

Documents

Luminato CLI manualforum.nova-minsk.com/file/Luminato/Luminato_CLI_manual... · 2011. 4. 13. · LUMINATO CLI MANUAL 13-Apr-11 7(63) CLI syntax conventions This document uses certain