Feedback
Table Of Contents
Cisco VQE-C Software Commands
This chapter contains an alphabetical listing of all the commands in Cisco CDA Visual Quality Experience Client System Command Reference Guide (VQE-C) software. The VQE-C software CLI is organized into the following command modes:
•
EXEC mode—Allows commands that are not potentially destructive
•
•
The commands used to access these modes are marked with a footnote in Table 2-1.
See Chapter 1 "Command-Line Interface Command Summary," for a complete discussion of using CLI command modes.
Table 2-1 summarizes the VQE-C commands and indicates the command mode for each command. The same command may have different effects when entered in a different command mode, and for this reason, they are listed and documented separately. In Table 2-1, when the first occurrence is entered in EXEC mode, the second occurrence is entered in Global configuration mode. When the first occurrence is entered in Global configuration mode, the second occurrence is entered in interface configuration mode.
Note
app-delay
To set the playout timing of replicated app packets, use the app-delay command in configuration mode.
app-delay delay
Syntax Description
Command Default
delay: 0
Command Modes
Configuration
Usage Guidelines
When VQE-C is replicating APP packets (i.e. more than one packet containing app data is being sent on output at the beginning of a new channel), this command can be used to send out the replicated app packets at a specific rate.
Examples
The following example enables the VQE-C to delay each packet containing APP data by 40 milliseconds. So, in other words, assuming that VQE-C is replicating APP packets to send a total of 3 of them at the beginning of a new channel's output stream, the first 3 packets on the stream would be sent at times (in ms) T, T+40, T+80, followed by the rest of the MPEG data packets:
vqec(config)# app-delay 40channel tr-135
To change the TR-135 writable parameters of an active channel, use channel tr-135 command in configuration mode.
channel tr-135 <channel-url> gmin <gmin> slmd <slmd>
Syntax Description
channel-url
URL of the active channel whose TR-135 parameters is to be changed.
gmin
Integer specifying value of gmin.
slmd
Integer specifying value of Severe Loss Minimum Distance.
Command Default
TR-135 statistics, that are related to gmin and slmd are disabled.
Command Modes
Configuration
Usage Guidelines
After a channel becomes active (when a tuner binds to that channel), the above command can be used to modify the channel's TR-135 writeable parameters: gmin and slmd. The address and protocol of the channel is specified in the form of channel-url, which has the form: output-type://address:port
•
•
•
Examples
The following example sets gmin to 1 and slmd to 2 for an active channel identified by the URL rtp://224.1.1.1:50000
vqec(config)# ch tr-135 rtp://224.1.1.1:50000 gmin 1 slmd 2clear counters
To clear all counters, use the clear counters command in priviledged EXEC mode.
clear counters
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC
Usage Guidelines
This command clears all counters and statistics.
Examples
The following example clears all counters:
vqec# clear countersconfigure terminal
To enter the configuration mode, use the configure terminal command in priviledged EXEC mode.
configure terminal
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC
Examples
The following example enters the configuration mode from privileged EXEC mode:
vqec# configure terminalvqec(config)#debug
To enable or disable specific debug flags, use the debug command in priviledged EXEC mode.
debug { debug-type {enable | disable} }
Syntax Description
debug-type
The debug flag to operate on.
enable
Enable this debug flag.
disable
Disable this debug flag.
Command Default
All debug flags are disabled.
Command Modes
Privileged EXEC
Usage Guidelines
The debug-type must be one of the following:
The following example enables debug flags for fcc and igmp, and then disables the rcc flag:
vqec# debug fcc enablevqec# debug igmp enablevqec# debug rcc disablevqec# show debugchannel: disabledchan_cfg: disabledcpchan: disablederror-repair: disabledevent: disabledrcc: disabledigmp: enabledinput: disabledoutput: disabledpcm: disabledrecv-socket: disabledrtcp: disablednat : disabledtimer: disabledtuner: disabledupcall: disabledupdater: disableddp-tlm: disableddp-inputshim: disableddp-outputshim: disableddp-nll: disableddp-nll-adjust: disableddp-pcm: disableddp-pcm-pak: disableddp-error-repair: disableddp-rcc: disableddp-fec: disableddp-failover: disabledThe following example enables debug flags for channel, event, igmp, and pcm, and then disables all debug flags:
vqec# debug channel enablevqec# debug event enablevqec# debug igmp enablevqec# debug pcm enablevqec# debug dp-pcm enablevqec# show debugchannel: enabledchan_cfg: disabledcpchan: disablederror-repair: disabledevent: enabledrcc: disabledigmp: enabledinput: disabledoutput: disabledpcm: enabledrecv-socket: disabledrtcp: disablednat : disabledtimer: disabledtuner: disabledupcall: disabledupdater: disableddp-tlm: disableddp-inputshim: disableddp-outputshim: disableddp-nll: disableddp-nll-adjust: disableddp-pcm: enableddp-pcm-pak: disableddp-error-repair: disableddp-rcc: disableddp-fec: disableddp-failover: disabledThe following example shows how to disable all the debug flags:
vqec# debug all disablevqec# show debugchannel: disabledchan_cfg: disabledcpchan: disablederror-repair: disabledevent: disabledrcc: disabledigmp: disabledinput: disabledoutput: disabledpcm: disabledrecv-socket: disabledrtcp: disablednat : disabledtimer: disabledtuner: disabledupcall: disabledupdater: disableddp-nll: disableddp-nll-adjust: disableddp-pcm: disableddp-pcm-pak: disableddp-error-repair: disableddp-rcc: disableddp-fec: disableddp-failover: disabledRelated Commands
disable
To exit privileged EXEC mode and return to user EXEC mode, use the disable command in priviledged EXEC mode.
disable
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC
Examples
The following example returns to user EXEC mode from privileged EXEC mode:
vqec# disablevqec>drop
To configure VQE-C packet drop simulation, use the drop command in configuration mode.
drop [ session { primary | repair } ] { enable | disable | interval <int1><int2> | percentage percentage }
Syntax Descriptiondrop [ session { primary | repair } ] { enable | disable |
Syntax Descriptioninterval continuous-drop interval | percentage percentage }
Command Default
interval: 0
percentage: 0
Command Modes
Configuration
Usage Guidelines
Drop simulation makes VQE-C intentionally drop some packets and behave as if it never received packets that it intentionally drops. This is useful, for example, when attempting to verify error-repair operation of VQE-C despite the primary stream being received without losses from the network.
Drop characteristics of each session type may be configured independently via use of the session keyword. If the session keyword is omitted, then the command is interpreted as configuring drop characteristics of primary streams.
Use of the enable keyword enables drop the simulator for a particular stream type (primary or repair), while use of the disable keyword disables the drop simulator for the given stream type. When drops for a particular session type are enabled, configuration of the interval and percentage keywords controls the drop function.
When interval is configured, VQE-C intentionally drops the first continuous-drop sequential packets for every interval packets it receives on the specified session of a channel. The order of arrival of packets on that session (rather than the order of sender's transmission or sequence number) determines which continuous-drop packets are dropped .
When percentage is configured (and both arguments of interval are set to 0) then VQE-C intentionally drops the configured percentage of the packets it receives, as if it had never received them.
Examples
The following example enables the VQE-C drop simulation and sets VQE-C to drop 3 sequential packets for every 50 packets it receives on the primary session. In other words, if VQE-C starts receiving packets with sequence number 0 and receives them all sequentially, it will drop any whose sequence numbers fall in the pattern {0, 1, 2, 50, 51, 52, 100, 101, 102, ...}:
vqec(config)# drop session primary enablevqec(config)# drop session primary interval 3 50The following example enables VQE-C drop simulation for repair streams and sets VQE-C to drop a random 10% of the packets it receives:
vqec(config)# drop session repair enablevqec(config)# drop session repair percentage 10The following example disables VQE-C drop simulation for both primary and repair streams :
vqec(config)# drop session primary disablevqec(config)# drop session repair disableenable
To enter privileged EXEC mode, use the enable command in EXEC mode.
enable
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example enters privileged EXEC mode from user EXEC mode:
vqec> enablevqec#error-repair
To perform retransmission repair when a channel is described as having error-repair configured, use the error-repair command in configuration mode.
error-repair {enable | disable | policer | smart-request | repeat-request}
Note
Syntax Description
Command Default
Error-repair is enabled.
Command Modes
Configuration
Usage Guidelines
Use this command to disable retransmission based error repair to see how the video for a retransmission based error repair enabled channel will appear without retransmission based error repair.
This command allows a quick way to toggle between viewing a retransmission based error repair corrected stream and a stream with no retransmission based correction.
Note
Examples
The following example disables the VQE-C error repair feature on the next bind after all tuners have been unbound from the channel.
Once this feature is disabled, any packets that are lost in the network will not be recovered by VQE:
vqec(config)# error-repair disableerror-repair policer
To configure the error repair policer in VQE-C, use the error-repair policer sub-command in configuration mode.
error-repair policer {enable | disable | rate | burst}
Syntax Description
Command Default
The VQE-C error repair policer is disabled by default. Default values and supported ranges for the token bucket parameters are as follows:
rate: 5%
burst: 10000ms
Command Modes
Configuration
Usage Guidelines
When the VQE-C experiences a high drop rate for a stream, a large number of error repair requests may be sent to the VQE-S. If it is desirable to limit the error repair requests sent into the network by the VQE-C (e.g. to avoid flooding the network due to a lossy stream), this feature may be enabled.
The VQE-C uses the relative policer values configured above, along with the primary stream's rate and an assumed packet size of 1356 bytes, to compute the token bucket parameters used for error repair policing. The default packet size is derived as follows:
Default packet size = 7 (MPEG TS pkts) * 188 (bytes/MPEG TS pkt) + 12 (bytes/RTP header) + 12 (bytes/UDP header) + 20 (bytes/IP header) = 1356
The token bucket's absolute rate (rate', expressed in repair packets/s) and burst (burst', expressed in packets) parameters used for policing repair requests are then computed from configured values as follows:
rate' (packets/s) = <rate>/100 * <stream-rate (bps)> / (8 bits/byte * 1356 bytes/packet)
burst' (packets) = <rate' (packets/s)> * <burst (ms)> / (1000 ms per second)
Changes to the configured values take effect with the next channel change (streams currently being received are not affected).
Examples
The following example enables error repair policing at a rate of 5%, and with a burst value of 10000ms:
vqec(config)# error-repair policer enablevqec(config)# error-repair policer rate 5vqec(config)# error-repair policer burst 10000Assuming a primary stream rate of 6Mbps, the rate' and burst' values used by the policer (as described in the "Usage Guidelines" section above) are 28 packets/s and 277 packets, respectively. These values are displayed in the show tuner output.
error-repair repeat-request
To configure the error repair repeat-request in VQE-C, use the error-repair repeat-request sub-command in configuration mode.
error-repair repeat-request {enable | disable}
Syntax Description
enable
Enable the error repair repeat-request feature in VQE-C.
disable
Disable the error repair repeat-request feature in VQE-C.
Command Default
error-repair repeat-request is disabled by default.
Command Modes
Configuration
Usage Guidelines
Repeat request feature will make the VQE-C send a second RET request for the repair packets which doesn't arrive in expected time. The expected time of arrival of repair packets is calculated when VQE-C parameters max_receive_bandwidth_hd, max_receive_bandwidth_sd and min_hd_stream_bitrate are configured.
Changes to the configured values take effect with the next channel change (streams currently being received are not affected).
Examples
The following example enables error repair repeat-request:
vqec(config)# error-repair repeat-request enableerror-repair smart-request
To configure the error repair smart-request in VQE-C, use the error-repair smart-request sub-command in configuration mode.
error-repair smart-request {enable | disable}
Syntax Description
enable
Enable the error repair repeat-request feature in VQE-C.
disable
Disable the error repair repeat-request feature in VQE-C.
Command Default
error-repair smart-request is disabled by default.
Command Modes
Configuration
Usage Guidelines
Smart request is a feature which will optimize RET bandwidth utilization by qualifying outgoing RET requests from client to server, preventing excessive RET requests for packets that cannot be successful due to buffer capacity issues. The expected time of arrival of repair packets is calculated when VQE-C parameters max_receive_bandwidth_hd, max_receive_bandwidth_sd and min_hd_stream_bitrate are configured.
Changes to the configured values take effect with the next channel change (streams currently being received are not affected).
Examples
The following example enables error repair smart-request:
vqec(config)# error-repair smart-request enableexit
To exit from the current command level (except when trying to get back to non-privileged EXEC mode), use the exit command.
exit
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC, Priviledged EXEC, and Configuration
Examples
The following example exits global configuration mode and returns to privileged EXEC mode, then exits the telnet session after the command is issued a second time:
vqec(config)# exitvqec# exitConnection closed by foreign host.fec
To perform Forward Error Correction(FEC) based repair when a channel is described as having FEC configured, use the fec command in configuration mode.
fec {enable | disable}
Syntax Description
Command Default
FEC is enabled.
Command Modes
Configuration
Usage Guidelines
Use this command to disable FEC to see how the video for a FEC enabled channel will appear without FEC. This command allows a quick way to toggle between viewing a FEC corrected stream and a stream with no FEC correction.
Note
Examples
The following example disables the VQE-C fec decoding feature. Once this feature is disabled, no received FEC packets are decoded:
vqec(config)# fec disablehelp
To show a list of available commands in the current mode, use the help command.
help
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC, Priviledged EXEC, and Configuration
Examples
The following example lists all commands that are available in user EXEC mode:
vqec# helphelp Show available commandsquit Disconnectlogout Disconnectexit Exit from current modeenable Turn on privileged commandsdisable Turn off privileged commandsconfigure Enter configuration modeclear clear cmdssend-debugs-to-cli Set whether or not debug messages are to be printedon the CLI outputdebug Set debugging flagsmonitor Performance monitoring toolsshow Commands to display VQE-C state informationhistory
To show a list of previously entered commands, use the history command.
history
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC, Priviledged EXEC, and Configure
Examples
The following example lists all commands that were previously issued:
vqec# historyCommand history:0. enable1. show debuglogout
To disconnect the telnet session from the CLI, use the logout command.
logout
Note
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC, Priviledged EXEC, and Configure
Examples
The following example disconnects the telnet session:
vqec> logoutConnection closed by foreign host.monitor
To use the system monitoring tools, use the monitor command in priviledged EXEC mode.
monitor { output-sched [ show | off | on | reset ] | benchmark [ show | off | on ] }
Syntax Description
Command Default
output-sched: off
Command Modes
Priviledged EXEC
Usage Guidelines
The monitor output-sched measurement logging may be turned on to troubleshoot reasons for drops on a tuner's output queue.
The monitor command may be used to collect and observe the intervals (measured in milliseconds) between instances of output scheduling. The implementation uses a timer for the purposes of awaking and updating the packets available for reading from its tuners every VQEC_PCM_OUTPUT_SCHED_INTERVAL (20) milliseconds. The histogram keeps track of the actual intervals (in milliseconds) at which the implementation was awoken to update the tuners' output queues
Examples
The following example shows an output scheduling histogram containing measurements from 2034 intervals, all within the range of 20-29 milliseconds.
vqec# monitor output-sched showHistogram of Output Scheduling Intervals (in ms):20 - 29 [ 2034 ]parse sdp
To parse a file containing a single SDP channel description into a list of channel parameters, use the parse sdp command in configuration mode.
parse sdp { vod | linear } input-file [ output output-file ] [ params-list ]
Syntax Description
Command Default
None
Command Modes
Configuration
Usage Guidelines
The parse sdp command exposes the VQE-specific SDP parser and validator and allows external SDP files to be parsed into parameter lists. The validation type is determined by the first argument: "vod" for a video on demand SDP or "linear" for a multicast channel SDP. The input and output file paths should not include special shell symbols (such as "~" or ".."); they will not be expanded. The command output will be written to the output file, if specified, or to the CLI otherwise.
Since certain SDP files will not contain all the necessary parameters for binding to a channel (such as transport addresses for a VoD session), additional override parameters may be provided. The format of these input parameters is consistent with the parse command's output. See the examples section for more information.
Examples
The following example parses a file "mychannel.cfg" containing a multicast SDP channel description and outputs the results to the CLI. These resulting parameters may be copied as inputs to the tuner bind command. If an output file were specified, the same list would be written to the output file (which could then be provided to the tuner bind command as well).
vqec(config)# parse sdp linear mychannel.cfgprimary-dest-addr 229.1.1.8 primary-dest-port 53198 primary-dest-rtcp-port 53199 primary-src-addr 9.3.13.2 primary-src-port 0 primary-src-rtcp-port 53199 primary-payload-type 96 primary-bit-rate 14910000 primary-rtcp-sndr-bw 53 primary-rtcp-rcvr-bw 530000 primary-rtcp-per-rcvr-bw 53 primary_rtcp_xr_loss_rle_enable primary_rtcp_xr_per_loss_rle_enable primary-rtcp-xr-stat-flags loss,dup,jitt fbt-addr 5.3.19.100 er_enable rcc_enable rtx-src-addr 5.3.19.100 rtx-src-port 50000 rtx-src-rtcp-port 50001 rtx-dest-addr 0.0.0.0 rtx-dest-port 0 rtx-dest-rtcp-port 0 rtx-payload-type 99 rtx-rtcp-sndr-bw 53 rtx-rtcp-rcvr-bw 53proxy-igmp-join
To enable the VQE-C proxy mode, use the proxy-igmp-join command in configuration mode.
proxy-igmp-join tuner-name stb-if-name stb-ip-addr
Syntax Description
tuner-name
Name of an active tuner.
stb-if
Name of the ethernet interface the STB is connected to.
stb-addr
IP address of the STB.
Command Default
Proxy mode is disabled.
Command Modes
Configuration
Usage Guidelines
When the VQE-C proxy mode is enabled for a tuner, that tuner will listen on stb-if-name interface for IGMP join requests coming from a set-top box with address stb-ip-addr. When the tuner receives an IGMP leave and join report from the set-top box, the tuner will then tune to the new channel being joined to by the STB. It will then begin to send a repaired output multicast stream on the stb-if interface for the set-top box to display the stream.
To disable the VQE-C proxy mode for a tuner, use the same command, but provide "0.0.0.0" as stb-ip-addr.
Needs superuser privileges to successfully execute this command. Works only for IEEE 802.3 encapsulation, and will show unexpected behavior for Ethernet II, and 802.1Q (VLAN) encapsulations. Works only for a single STB behind the VQE-C device, and supports UDP-only stream output. Also has only host device support, and does not support operation on a router or bridge. A user cannot configure more than one IGMP proxy for the same STB (IP Address).
Examples
The following example enables the VQE-C proxy mode for a tuner named "0" and listens for IGMP messages on eth1, where eth1 is the interface on the VQE-C-machine, to which the STB is connected. Here, the address of the STB is 192.168.1.150. When VQE-C receives IGMP join report for some active channel, say, channel 224.1.1.t, from the STB, VQE-C's tuner will tune to this address and stream output to the 224.1.1.t address on the eth1 interface, as a result of which, the STB would then receive multicast data for 224.1.1.t.
vqec(config)# proxy-igmp-join 0 eth1 192.168.1.150rcc
To perform rapid channel change only when a channel is described as having rapid channel change configured, use rcc command in configuration mode.
rcc {enable | disable}
Syntax Description
enable
Enable the rapid channel change feature in VQE-C.
disable
Disable the rapid channel change feature in VQE-C.
Command Default
Rapid channel change is enabled.
Command Modes
Configuration
Usage Guidelines
Use this command to disable rcc to see how the channel change for a RCC enabled channel will appear without rapid channel change. This command allows a quick way to toggle between viewing a channel change with and without rapid channel change feature.
Note
Examples
The following example disables the VQE-C rapid channel change feature. Once this feature is disabled, no rapid channel change is performed:
vqec(config)# rcc disablesend-debugs-to-cli
To Toggle whether the VQE-C debug messages are sent to only syslog, or syslog and the CLI, use the send-debugs-to-cli command in priviledged EXEC mode.
send-debugs-to-cli {enable | disable}
Syntax Description
Command Default
send-debugs-to-cli:enabled
Command Modes
Privileged EXEC
Examples
The following example disables debug messages from going to the CLI:
vqec# send-debugs-to-cli disableshow channel
To show a list of configured channels, or to show details for one a configured channel, use the show channel command in EXEC mode.
show channel [ {counters {all | url <channel_url>} [cumulative]} | {config {all | url<channel-url>}} ]
Syntax Description
Command Default
None
Command Modes
EXEC
Usage Guidelines
When no arguments are provided, this command will simply display a list of the configured channels by their URLs and names.
The show channel counters url <channel_url> [cumulative] command displays the counters for a single channel (since last reset/initialization to 'now'), and show channel counters all [cumulative] displays the counters for each channel one after the other. If the optional keyword 'cumulative' is supplied, the command will display the counters for each channel since its initialization to 'now', and if absent, the command will display counters since last reset/channel initialization (whichever occurred latest) to 'now'. See the show counters command for descriptions of fields common to both these commands. The following are counters that are unique to "show channel counters".
The show channel config url <channel_url> command displays the configuration for a single channel, and show channel config all displays the configuration for each channel one after the other. See the show tuner command for descriptions of each output field.
Examples
The following example lists all the configured channels, and then displays more details on the second channel listed:
vqec> show channelVQE-C channel cfg update: not in progressLast update received: Jan 21 13:03:22Channel cfg file version: 136a4169327228e2f980f1b03c95e022Total number of channels: 10rtp://230.151.1.1:10000 (Channel 230.151.1.1)rtp://230.151.1.2:10004 (Channel 230.151.1.2)rtp://230.151.1.3:10008 (Channel 230.151.1.3)rtp://230.151.1.4:10012 (Channel 230.151.1.4)rtp://230.151.1.5:10016 (Channel 230.151.1.5)rtp://230.151.1.6:10020 (Channel 230.151.1.6)rtp://230.151.1.7:10024 (Channel 230.151.1.7)rtp://230.151.1.8:10028 (Channel 230.151.1.8)rtp://230.151.1.9:10032 (Channel 230.151.1.9)rtp://230.151.1.10:10036 (Channel 230.151.1.10)vqec> show channel config url rtp://230.151.1.1:10000Channel name: Channel 230.151.1.1Channel sdp_handle: o=- 1209133068 1209133067 IN IP4 venus-iptvChannel handle: 0x89000001Channel session identifier: INIP4#-#1209133068#venus-iptvChannel version: 1209133067Configuration data: completeChannel mode: lookasideOriginal source multicast address: 230.151.1.1Source address for original source stream: 5.8.37.2Original source port: 10000Original source RTCP port: 10001Original source RTP payload type: 33Original source RTCP sender bandwidth: 46875Original source RTCP receiver bandwidth: 140625Original source RTCP per receiver bandwidth: 37Original source RTCP XR Loss RLE Report: OffOriginal source RTCP XR Stat Summary Report: 0x0000RTCP XR Post Repair Loss RLE Report: OffMaximum bit rate: 3750000Retransmission/FBT address: 8.36.1.1Retransmission RTP port: 10002Retransmission RTCP port: 10003Retransmission associated payload type: 33Repair stream RTCP sender bandwidth: 37Repair stream RTCP receiver bandwidth: 37Error repair: enabledRapid channel change: enabledvqec# show channel counters url rtp://229.1.1.15:53226primary rtp expected: 8869primary rtp lost: 400-- TR-135 Packet Counters --buffersize (usec): 200000underruns (events): 0overruns (events): 362gmin: 0severe loss minimum distance: 0Before-EC After-ECpackets expected: - 0packets received: - 0packets lost: 0 0loss events: 0 0severe loss index count: - 0minimum loss distance: - -maximum loss period: - 0-- Stream Packet Counters --Inputs Outputs Drops (Late)primary udp mpeg: 0 0 0primary rtp: 8869 - 400 (0)primary rtcp: 0 7 -repair/rcc rtp: 444 - 362 (362)repair/rcc rtcp: 3 - -fec: 0 - 0 (0)repair rtp stun: 0 0 -repair rtcp stun: 0 0 -post-repair: - 8552 -tuner Q drops: - - 8552underruns: 0 - --- Repair Packet Counters --Pre-Repair Post-Repairstream loss: 400 318rcc loss: - 0Smart req RepeatreqRequested Policed Policed Senterror repair: 400 0 0 0Recoveredfec: 0-- Channel Change Counters --requests: 0rcc requests: 0rccs limited: 0rcc with loss: 0rcc aborts: 0server stun response response burst burstrejects timeout timeout invalid start activity other0 0 0 0 0 0 0vqec# show channel counters url rtp://229.1.1.15:53226 cumulativeprimary rtp expected: 1209548primary rtp lost: 60035-- TR-135 Packet Counters --buffersize (usec): 200000underruns (events): 1overruns (events): 42690gmin: 0severe loss minimum distance: 0Before-EC After-ECpackets expected: - 0packets received: - 0packets lost: 0 0loss events: 0 0severe loss index count: - 0minimum loss distance: - 0maximum loss period: - 0-- Stream Packet Counters --Inputs Outputs Drops (Late)primary udp mpeg: 0 0 0primary rtp: 1209548 - 60035 (0)primary rtcp: 0 5157 -repair/rcc rtp: 60987 - 42690 (42690)repair/rcc rtcp: 348 - -fec: 0 - 0 (0)repair rtp stun: 1 1 -repair rtcp stun: 1 1 -post-repair: - 1167609 -tuner Q drops: - - 1167409underruns: 0 - --- Repair Packet Counters --Pre-Repair Post-Repairstream loss: 60035 42753rcc loss: - 0Smart req RepeatreqRequested Policed Policed Senterror repair: 60038 0 0 0Recoveredfec: 0-- Channel Change Counters --requests: 1rcc requests: 1rccs limited: 0rcc with loss: 0rcc aborts: 0server stun response response burst burstrejects timeout timeout invalid start activity other0 0 0 0 0 0 0show counters
To show counters, use the show counters command in EXEC mode.
show counters [ {name <tuner-name>} | {cumulative} ]
Syntax Description
Command Default
None
Command Modes
EXEC mode.
Usage Guidelines
To show historical/rolled-up counters for events which have occurred across all tuners/channels, including events which occurred on tuners/channels which may no longer exist (or whose binding has changed), use the show counters command. When the show counters command is invoked with the cumulative keyword, cumulative statistics for each channel (since it became active to now) are rolled up and then displayed.. In the absence of the cumulative keyword, show counters displays historical/rolled up statistics for each channel since the channel was last reset/initialized.
The fields shown in the output of this command are described in the following table:
To show counters for a single tuner which accumulated since its channel last became active (was last bound to any tuner), use the show counters <tuner> form of the command.
The fields shown in the output of this command are described in the following table:
To clear counters for either form of the show counters command, use the clear counters command.
Examples
The following example shows the cumulative counters across all tuners/channels:
vqec# show counters-- Stream Packet Counters --Inputs Outputs Drops (Late)primary udp mpeg: 0 0 0primary rtp: 48805 - 2400 (0)primary rtcp: 0 40 -repair/rcc rtp: 2444 - 1960 (1960)repair/rcc rtcp: 15 - -fec: 0 - 0 (0)repair rtp stun: 0 0 -repair rtcp stun: 0 0 -post-repair: - 46889 -tuner Q drops: - - 46889underruns: 0 - --- Repair Packet Counters --Pre-Repair Post-Repairstream loss: 2400 1916rcc loss: - 0Smart req Repeat reqRequested Policed Policed Senterror repair: 2400 0 0 0Recoveredfec: 0-- Channel Change Counters --requests: 0rcc requests: 0rccs limited: 0rcc with loss: 0rcc aborts: 0server stun response response burst burstrejects timeout timeout invalid start activity other0 0 0 0 0 0 0-- System Event Counters -clock jumpbacks: 0vqec# show counters cumulative-- Stream Packet Counters --Inputs Outputs Drops (Late)primary udp mpeg: 0 0 0primary rtp: 1235442 - 61335 (0)primary rtcp: 0 5179 -repair/rcc rtp: 62287 - 43728 (43728)repair/rcc rtcp: 356 - -fec: 0 - 0 (0)repair rtp stun: 1 1 -repair rtcp stun: 1 1 -post-repair: - 1192466 -tuner Q drops: - - 1192266underruns: 0 - --- Repair Packet Counters --Pre-Repair Post-Repairstream loss: 61335 43791rcc loss: - 0Smart req Repeat reqRequested Policed Policed Senterror repair: 61338 0 0 0Recoveredfec: 0-- Channel Change Counters --requests: 1rcc requests: 1rccs limited: 0rcc with loss: 0rcc aborts: 0server stun response response burst burstrejects timeout timeout invalid start activity other0 0 0 0 0 0 0The following example shows the counters for a tuner named "tuner1":vqec> show counters tuner1tuner-name: tuner1inputs: 1466955drops: 30primary: 1463475repair: 3231rtcp: 248rtp: 1466706app timeouts: 0null app: 0outputs: 1466076output Q drops: 0fec repairs: 0Related Commands
show debug
To show the current debug flag settings, use the show debug command in EXEC mode.
show debug
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Usage Guidelines
Each debug flag is responsible for a certain set of possible debug messages. When one of these flags is enabled, debug messages related to that component will begin to appear. Each flag can have a value of enabled or disabled.
Examples
The following example lists all the current debug flags:
vqec> show debugchannel: disabledchan_cfg: disabledcpchan: disablederror-repair: disabledevent: disabledrcc: disabledigmp: disabledinput: disabledoutput: disabledpcm: disabledrecv-socket: disabledrtcp: disablednat : disabledtimer: disabledtuner: disabledupcall: disabledupdater: disableddp-tlm: disableddp-inputshim: disableddp-outputshim: disableddp-nll: disableddp-nll-adjust: disableddp-pcm: disableddp-pcm-pak: disableddp-error-repair: disableddp-rcc: disableddp-fec: disableddp-failover: disabledshow dp
To show current VQE-C dataplane information, use the show dp command in EXEC mode.
show dp [counters]
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Usage Guidelines
Currently counters is the only option which will display any information.
Examples
The following example shows some example output:
vqec# show dp counters---Dataplane IPC---IRQ sent 173IRQ dropped 0Ejected packets sent 1Ejected packets dropped 0---Dataplane Channel---Creates 0Destroys 0Creation failures 0---Dataplane RTP---Source creates 2Source destroys 0Source table full 0Source limit exceeded 0Source aged out 0RTP IS creates 2RTP IS deletes 0RTP IS limit exceeded 0RTP IS ejected paks 1XR stats malloc failures 0SSRC filter drops 0Repair stream filter drops 0show drop
To show the current drop simulation settings, use the show drop command in EXEC mode.
show drop
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Usage Guidelines
The fields shown in the output of this command are described in the following table:
_
Examples
The following example displays VQE-C's drop simulation configuration:
vqec> show dropprimary stream dropping: enabled (using percentage)dropping: 0interval: 0percentage: 5%repair stream dropping: enabled (using percentage)dropping: 0interval: 0percentage 3%show error-repair
To show the current error repair feature status, use the show error-repair command in EXEC mode.
show error-repair
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example shows the current status of error repair:
vqec# show error-repairerror-repair: enabledsmart-request: disabledsmart request policed: 0repeat-request enabledrepeat request sent: 687repair policer: enabled (set by CLI)rate: 5%burst: 10000mspacket requests policed: 4878repeat requests policed: 4650The default or configured values of error-repair smart-request are shown along with smart-request policed counters which displays the total number of error repairs policed by smart-request.
The default or configured value of error-repair repeat-request are shown along with repeat-request sent counters which displays the total number of error repair requests repeated.
The default or configured values for the error-repair smart-request, repeat-request and policer are shown, along with smart-request policed counters which displays the total number of error repair packets policed by smart-request, repeat-request sent counters which displays the total number of error repair packets re-requested and policed counter which displays the total number of error repairs policed for all streams tuned by the VQE-C. This counter is reset via the "clear counters" command and during initialization of VQE-C.
show fec
To show the current FEC feature status, use the show fec command in EXEC mode.
show fec
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example shows the current status of FEC:
vqec> show fecfec: enabledshow ipc
To show current VQE-C control/data plane IPC information, use the show ipc command in EXEC mode.
show ipc
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example shows some example output:
vqec# show ipc---Dataplane IPC---IRQ sent 174IRQ dropped 0Ejected packets sent 1Ejected packets dropped 0--- IRQ events ---Sock name: /tmp/.vqec_irqsk9847Total Events: 174Lost Events: 0Error Events: 0Ack Errors: 0--- NAT events ---Sock name: /tmp/.vqec_paksk9847Total Events: 1Lost Events: 0Error Events: 0Ack Errors: 0show nat
To show the current NAT feature status, use the show nat command in EXEC mode.
show nat
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example shows the current NAT status:
vqec# show natNAT protocol: STUNNAT bindings open: 2NAT id: 4043309057NAT status: Not Behind NATInternal address: 5.8.48.2:32797Public address: 5.8.48.2:32797Last request time: 1214316087525Last response time: 1214316087527NAT id: 2902458370NAT status: Not Behind NATInternal address: 5.8.48.2:32795Public address: 5.8.48.2:32795Last request time: 1214316087525Last response time: 0show pak-pool
To show the current status of the packet memory pool used by VQE-C, use the show pak-pool command in EXEC mode.
show pak-pool
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Usage Guidelines
If you specify an optional tuner name, you will see information for that tuner.
If you specify no optional arguments, you will see information for all active tuners.
The fields shown in the output of this command are described in the following table:
Examples
The following example shows the current status of the packet memory pool:
vqec> show pak-poolglobal input pak pool stats:max entries: 1000used entries: 274high water entries: 322fail pak alloc drops: 0show proxy-igmp
To show the current status of proxy-igmp, use the show proxy-igmp command in EXEC mode.
show proxy-igmp [tuner-name]
Syntax Description
Command Default
None
Command Modes
EXEC
Usage Guidelines
If you specify an optional tuner name, you will see information for that tuner.
If you specify no optional arguments, you will see information for all active tuners.
The fields shown in the output of this command are described in the following table:
Examples
The following example shows the stream-output status of a tuner with name "0":
vqec> show proxy-igmpTuner name: tuner1IGMP Proxy State: EnabledVQEC Interface: eth2STB IP Address: 192.168.1.130destination URL: rtp://224.1.1.1:50000packets sent: 2720packets dropped: 0show rcc
To show the current RCC feature status, use the show rcc command in EXEC mode.
show rcc
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Examples
The following example shows the current status of RCC:
vqec# show rccrcc: disabledshow stream-output
To show the current status of output streaming, use the show stream-output command in EXEC mode.
show stream-output [tuner-name]
Syntax Description
Command Default
None
Command Modes
EXEC
Usage Guidelines
If you specify an optional tuner name, you will see information for that tuner.
If you specify no optional arguments, you will see information for all active tuners.
The fields shown in the output of this command are described in the following table:
Examples
The following example shows the stream-output status of a tuner with name "0":
vqec# show stream-output 0Tuner name: 0packets sent: 25600packets dropped: 0show system-config
To show the current build information and VQE-C configuration settings, use the show system-config command in EXEC mode.
show system-config [start-up | network | override | defaults]
Syntax Description
Command Default
None
Command Modes
EXEC
Usage Guidelines
The fields that are displayed by this command are explained in detail in the VQE-C System Configuration Reference document.
Examples
The following example shows the current VQE-C build information and running configuration:
vqec# show system-configVQE-C 3.7.0 build 22 (development-build)Built by: rootWorkspace: /root/vqec-3.7.0/vqec_3.7.0-22/evaTimestamp: Jun 25 2013 01:41:50Dataplane operating mode: USERmax_tuners = 32;channel_lineup = "zombie_vqe_channels.cfg";network_cfg_pathname = "";override_cfg_pathname = "";index_cfg_pathname = "";jitter_buff_size = 500;repair_trigger_point_abs = 20;pakpool_size = 20000;so_rcvbuf = 128000;strip_rtp = true;input_ifname = "eth1";sig_mode = "nat";nat_binding_refresh_interval = 30;max_paksize = 1508;cdi_enable = false;domain_name_override = "";libcli_telnet_port = 9909;output_pakq_limit = 200;update_window = 60;update_interval_max = 3600;app_paks_per_rcc = 1;error_repair_enable = true;error_repair_policer.enable = falseerror_repair_policer.rate = 5;error_repair_policer.burst = 10000;fec_enable = true;rcc_enable = false;rcc_start_timeout = 120;num_byes = 2;bye_delay = 40;reorder_delay_abs = 20;vcds_server_ip = "0.0.0.0";vcds_server_port = 8554;cli_ifname = "lo";rtcp_dscp_value = 24;deliver_paks_to_user = true;fastfill_enable = true;max_receive_bandwidth_sd = 2400000;max_receive_bandwidth_sd_rcc = 0;max_receive_bandwidth_hd = 2400000;max_receive_bandwidth_hd_rcc = 0;min_hd_stream_bitrate = 0;max_fastfill = 0;app_delay = 0;src_ip_filter_enable = false;qoe_enable = true;rcc_extra_igmp_ip = "0.0.0.0";rcc_max_concurrent = 32;integrated_rtp_fallback = true;udp_passthru_support = false;vod_cmd_timeout = 2000;vod_max_sessions = 1;vod_mode = "iptv";log_level = 4;stun_optimization = true;error_repair_smart_request_enable = false;error_repair_repeat_request_enable = true;repair_min_round_trip_time_abs = 0;show tech-support
To show an aggregate display of several CLI show commands that are useful for diagnostics, use the show tech-support command in EXEC mode.
show tech-support
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC
Usage Guidelines
The show tech-support command executes the following CLI commands one after the other, and displays the output of each to the CLI console.
show system-config
show tuner all detail
show channel
show counters
show dp counters
show update
show drop
show error-repair
show fec
show rcc
show fast-fill
show nat
show pak-pool
show stream-output
show ipc
show proxy-igmp
The command could be used by an integrator to get an aggregate view of the VQE-C state that could in turn be useful to verify or diagnose VQE-C integrations.
Examples
The following example shows an edited output of the show tech-support command. The command output displays each sub-command in a header, followed by the output of that command.
vqec> show tech-support# Command "show system-config" :VQE-C 3.5.0 build 101 (development-build)Built by: kanjoshiWorkspace: /auto/wskanjoshi/libcli/vam/evaTimestamp: Feb 4 2010 10:44:18Dataplane operating mode: USERmax_tuners = 3;....# Command "show proxy-igmp" :Tuner name: tuner1IGMP Proxy State: Disabledshow tuner
To show statistics and current configuration for a tuner, use the show tuner command in EXEC mode.
show tuner {join-delay | {{all | name tuner-name} [brief] [pcm] [fec] [nat] [counters] [channel] [log] [ipc] [rcc] [detail]}
Syntax Description
Command Default
None
Command Modes
EXEC
Usage Guidelines
Displays information associated with tuners.
If all or name <tuner-name> are specified, then information for all or the specified tuner(s) will be displayed. The displayed output may be qualified by one or more keyword options which restrict the output to a brief display (the default), a detailed display, or a display containing a subset of the output based (e.g. fec, log, etc.)..
The fields shown in the output of detail option of the show tuner command are described in the following table:
Tuner name
String
Name of the current tuner.
Tuner ID
int
Control-plane ID of the tuner.
DP Tuner ID
int
Data-plane ID of the tuner.
Bound to Channel ID
int
ID of the channel the tuner is currently bound to.
Channel Information
Original source multicast
address
Muticast address of the current channel
Original source port
port
Port of the current multicast channel.
Dataplane channel ID
int
ID of the channel in the data-plane.
Dataplane graph ID
int
ID of the dataplane graph structure representing the current channel.
Repair RTP ephemeral port
port
Port number of the repair receive port, chosen by the operating system at bind-time.
Primary RTP ID
int
Hex ID for the primary RTP stream.
Repair RTP ID
int
Hex ID for the repair RTP stream.
FEC0 RTP ID
int
Hex ID for the first FEC RTP stream.
FEC1 RTP ID
int
Hex ID for the second FEC RTP stream.
Current Channel Information
name
string
Name of the current channel.
sdp_handle
string
SDP handle for the current channel.
handle
int
Internal handle for the current channel.
session identifier
string
version
int
Version of the current channel's information.
configuration data
string
mode
string
Lookaside/Source - the current operating mode of VQE for this channel.
original source multicast address
address
Address for the primary multicast stream.
Source address for original source stream
address
Address of the sender for the primary multicast stream.
Original source port
port
Port number from the primary multicast sender.
Original source RTCP port
port
Port number from the primary multicast RTCP stream.
Original source RTP payload type
RTP payload type of the primary stream.
Original source RTCP sender bandwidth
Original source RTCP receiver bandwidth
Original source RTCP per receiver bandwidth
Original source RTCP XR Loss RLE Report
boolean
Indicates whether RTCP Extended Reporting is enabled or disabled.
Original source RTCP XR Stat Summary Report
int
Indicates the options for RTCP Extended Report summaries.
RTCP XR Post Repair Loss RLE Report
boolean
Indicates whether or not RTCP Extended Reporting is enabled for post-repair data or not.
Maximum bit rate
int
Highest bitrate of the current stream.
Retransmission/FBT address
address
Address of the VQE-S servicing this channel.
Retransmission RTP port
port
Port on the VQE-S to receive repair packets from.
Retransmission RTCP port
port
Port on the VQE-S to send feedback information to.
Retransmission associated payload type
RTP payload type of the retransmission stream.
Repair stream RTCP sender bandwidth
Repair stream RTCP receiver bandwidth
Error repair
boolean
Indicates whether or not error repair services are enabled.
Rapid channel change
boolean
Indicates whether or not fast channel change (RCC) services are enabled.
Active channel cfg updates
Int
Number of times an active channel's configuration was updated since the channel was tuned (e.g. the channel was configured with a new source due to failover)
Active channel's last cfg update
Int
Absolute time (in milliseconds) at which the active channel's configuration was last updated. If the active channel's configuration has not changed (since it became active), this value will be zero.
Smart Request
boolean
Indicate whether or not the error repair smart request is enabled
Repeat Request
boolean
Indicate whether or not the error repair repeat-request is enabled
software rtt min
Round trip time calculated in VQE-C
rtt used
Round trip time used in smart request and repeat request calculations
Error repair policer
boolean
Indicated whether or not the error repair policer is enabled.
Primary data received
boolean
Indicates if primary data has been received on this channel.
RTP Primary Session
ssrc
int
RTP SSRC.
cname
string
RTP CNAME.
nmembers
int
Number of session members.
nsenders
int
Number of session senders.
RTCP compound packet stats
sent
int
RTCP packets sent for the session.
send_errors
int
RTCP sends that failed.
rcvd
int
RTCP packets received for the session.
rcvd_errors
int
RTCP packets that failed receive processing.
badver
int
Number of primary RTCP packets dropped due to a bad RTP version number.
runts
int
Number of primary RTCP packets dropped due to the message at the end of a compound packet being either shorter than the minimum length of a message (4 bytes), or shorter than the length indicated in the header.
badlen
int
Number of primary RTCP packets dropped due to a length that is invalid for the given message type.
unexp
int
Unexpected RTCP message type: RTCP message types that are valid but are not expected by the application.
avg_pkt_size
int
RTCP received average packet size.
avg_pkt_size_sent
int
RTCP transmitted average packet size.
Sender info for sender1
ssrc
int
RTP SSRC
cname
string
RTP CNAME
received
int
RTP packets received
cum_loss
int
RTP cumulative number of packets lost
ehsr
int
RTP extended highest sequence number
jitter
int
RTP interarrival jitter
Sender stats for sender
max_seq
uint16
Highest sequence number seen
cycles
int
Shifted count of sequence number cycles
bad_seq
int
Last `bad' sequence number + 1
base_seq
int
Base sequence number
transit
int
Relative transit time for previous packet
received
int
RTP packets received
last_arr_ts_media
int
Last packet arrival timestamp in RTP timestamp units
seqjumps
int
Packets received with large sequence number jumps in comparison to max_seq.
initseq_count
int
The number of times a base sequence number has been established or `re-established' for the seding source.
out_of_order
int
Packets recevied with sequence numbers that were in the immediate past of the max_seq.
Primary RTCP RRs sent
int
Number of RTCP receiver reports that have been sent for this primary session.
DP sources
int
Number of sources in the dataplane for this RTP session.
Source info for source
ssrc, src ip, port
string
Identifies a DP source (see above).
source status
string
Indicates the status of a DP source. active/inactive indicates whether packets are currently being received from the source or not.
pktflow indicates that the source's packets are being accepted into the PCM.
source seq num offset
int
Indicates the signed 16-bit offset by which this DP source's sequence numbers may be recovered from PCM sequence numbers (vqec_seq_num_t). E.g., a value of 0 implies that the source's RTP sequence number may be recovered by subtracting 0 from the PCM sequence number and taking the lower 16-bits the result.
Repair data received
boolean
Indicates whether or not repair packets have been received from the repair stream.
RTP Repair Session
(same field and definitions as above, but for the repair RTP session instead of the primary RTP session)
Dataplane channel stats
total recvd paks
int
Total packets received by the RTP module.
total recvd primary paks
int
Total primary packets received by the RTP module.
total recvd repair paks
int
Total repair packets received by the RTP module.
total recvd rtp paks
int
Total RTP packets received by the RTP module.
total rtp drops
int
Total RTP packets that were dropped by the RTP module.
total sim drops
int
Total packets that were intentionally thrown away by the RTP module drop simulation.
total early drops
int
Total packets that were dropped due to early arrival.
failover source
string
Identifies an alternate source whose most recent packets are being queued for use should the primary (packetflow) source disappear. Only applicable only for unicast channels which are receiving traffic from an alternate source.
num paks queued
int
Number of packets queued from an alternate source (see failover source above).
queue head RTP seq num
int
RTP sequence number of packet at the head of the failover queue (see failover source above).
queue tail RTP seq num
int
RTP sequence number of packet at the tail of the failover queue (see failover source above).
prev src last rcv time
Int
Absolute time (in milliseconds) at which the last packet from the channel's previous source was received. (Only displayed if the channel has experienced a source change.) See next field.
curr src first rcv time
Int
Absolute time (in milliseconds) at which the first packet from the channel's current source was received. (Only displayed if the channel has experienced a source change.)
When compared to the prev src last rcv time field above, the difference can indicate the amount of overlap or gap between previous and current sources during the last source failover event.
runts
int
Number of primary RTCP packets dropped due to the message at the end of a compound packet being either shorter than the minimum length of a message (4 bytes), or shorter than the length indicated in the header.
badver
int
Number of primary RTCP packets dropped due to a bad RTP version number.
badlen
int
Number of primary RTCP packets dropped due to a length that is invalid for the given message type.
badcreate
int
Number of primary packets dropped because lookup or create RTP member failed.
seqjumps
int
Packets received with large sequence number jumps in comparison to max_seq.
initseq_count
int
The number of times a base sequence number has been established or `re-established' for the seding source.
runts
int
Number of primary RTCP packets dropped due to the message at the end of a compound packet being either shorter than the minimum length of a message (4 bytes), or shorter than the length indicated in the header.
badver
int
Number of primary RTCP packets dropped due to a bad RTP version number.
badlen
int
Number of primary RTCP packets dropped due to a length that is invalid for the given message type.
badcreate
int
Number of primary packets dropped because lookup or create RTP member failed.
seqjumps
int
Packets received with large sequence number jumps in comparison to max_seq.
initseq_count
int
The number of times a base sequence number has been established or `re-established' for the seding source.
total recvd rtcp paks
int
Total RTCP packets receieved by the RTP module.
generic nack counter
int
Number of generic NACK packets sent.
total repairs requested
int
Number of packets requested as repairs (total contents of generic NACKs)
total repairs policed
int
Number of packets not requested as repairs due to error-repair policing.
total smart req. policed
int
Number of packets not requested as repairs due to smart-request.
total repeat req sent
int
Number of packets sent as error repair repeat request.
total repeat req policed
int
Number of repeat request packets policed due to error-repair policing.
total repairs unrequested
int
Number of packets not requested as repairs because either:
•
•
failed to send rtcp pak
int
failed to report gap
int
PCM status
Head
int
Sequence number of the packet at the front of the PCM.
Tail
int
Sequence number of the packet at the end of the PCM.
highest_er_seq_num
int
Sequence number of the newest packet that is eligible for retransmission error repair.
last_reqstd_er_seq_num
int
Sequence number most recently requested for retransmission error repair.
last_rx_seq_num
int
Last received sequence number.
num_paks_in_pak_seq
int
The current number of packets contained in the PCM.
Primary_received
boolean
Indicates whether or not primary stream packets have been received.
Repair_received
boolean
Indicates whether or not repair stream packets have been received.
Repair_trigger_time
int
The time interval (in ms) that specifies how often the gap reporter should be triggered to report loss in the PCM.
Reorder_delay
int
The time (in ms) that loss created by out-of-order arriving packets should be held before they are eligible for retransmission-based error-repair.
fec_delay
int
Time (in ms) that lost packets should be held in order for FEC to have an adequate opportunity to repair them.
Original jitter buff size
int
Duration (in ms) of the jitter buffer, as specified by the configuration.
Total delay including fec
int
Duration (in ms) of the total delay within the PCM, including jitter buffer, reorder_delay, and delays from FEC.
gap_hold_time
int
Total duration (in ms) that lost packets will be held in the PCM before allowing retransmission to try to repair them.
PCM Counters
late packets
int
Number of packets that arrived late.
head ge last seq reqstd
int
Number of times that the sequence number of the PCM's head became greater than or equal to the sequence number that was most recently requested for retransmission error repair.
Primary packets
int
Number of primary packets received.
Repair packets
int
Number of repair packets received.
Input loss packets
int
Number of missing packets detected on the input (received) stream.
Input loss holes
int
Number of missing packet holes (one or more contiguous missing packets) on the input stream.
Output loss packets
int
Number of missing packets on the ouput stream.
Output loss holes
int
Number of missing packet holes on the output stream.
Pcm_insert drops
int
Number of packets that were dropped due to a PCM insertion failure.
Duplicate packets
int
Number of duplicate packets received in input stream.
Pak_seq_insert fail paks
int
Number of packets that were dropped due to a packet sequence module insertion failure.
Bad seq range
int
Number of packets that tried to be inserted into PCM, but whose seq_num was far outside of the range of the PCM head and tail.
Under runs
int
Number of times the PCM has run out of packets to send.
Output early packets
int
Packets that were scheduled to be played out earlier than they should have been.
Bad receive timestamp
int
Number of packets with invalid timestamps.
duplicate repair packets
int
Number of repair packets that were received as duplicates.
Last tx seq num
int
Sequence number of last packet transmitted from PCM to sink.
Last tx time
int
Time of last packet transmitted from PCM to sink.
Total tx packets
int
Total packets transmitted from PCM to sink.
Total tx bursts
int
Total bursts transmitted from PCM to sink. PCM determines one burst as a series of more than 10 packets that are transmitted in <1 ms.
NLL state
mode
int
Mode of the NLL, non-tracking (0) or tracking (1).
pred base
uint64
Predicted absolute time for the last packet scheduled.
last act time
uint64
Actual receive time for the last packet scheduled.
primary offset
uint64
Time offset between the repair & primary streams for RCC.
pcr32 base
int
The RTP timestamp for the last packet scheduled.
exp disc
int
Explicit timestamp discontinuities input to the NLL.
imp disc
int
Implicit timestamp discontinuities declared by the NLL.
observations
int
Number of packets processed.
resets
int
Number of times the NLL has been reset.
past predicts
int
Number of times the NLL has predicted send times for a packet in the past.
reset_base w/o time
int
NLL resets using the current time as the receive time for the observation.
FEC status
fec enabled in channel
boolean
Show if FEC is enabled.
True if enable, false, otherwise
fec streams
int
Number of FEC streams available at current session.
Show as %d_D
fec_column_stream_avail
boolean
True if column FEC stream is received from network; false, otherwise
fec_row_stream_avail
boolean
True if row FEC stream is received from network; false, otherwise
L value
uint8
Number of columns in one FEC encoding block
D value
uint8
Number of rows in one FEC encoding block
column head
vqec_seq_num_t
The smallest sequence number in column FEC buffer
column tail
vqec_seq_num_t
The largest sequence number in column FEC buffer
row head
vqec_seq_num_t
The smallest sequence number in row FEC buffer
row tail
vqec_seq_num_t
The largest sequence number in row FEC buffer
FEC counters
late fec packets
uint64
The late FEC packet counter. A FEC packet is late if it protected primary video packet are sent to display
fec recovered packets
uint64
Number of packets recovered by FEC
no need to decode paks
uint64
Number of FEC packets that do not need to be decoded. If there is no loss of the primary packets protected by this FEC packet, then, this FEC packet is not decoded.
total fec packets
uint64
Total FEC packets received
duplicate fec packets
Number of duplicate FEC packets received. A packet is considered duplicate if it is received more than once.
rtp hdr invalid paks
uint64
Number of FEC packets with invalid RTP header.
fec hdr invalid paks
uint64
Number of FEC packets with invalid FEC header
fec paks, unrecoverable
uint64
Number of valid FEC packets that can not be used to recover lost packets.
If there are more than one packet losses of the primary packets that are protected by one FEC packet, this FEC packet is called unrecoverable.
fec paks, other
uint64
Number of FEC packets being dropped due to internal errors, such as memory alloc failure, etc
fec gaps detected
uint64
Number of lost FEC packets according to RTP sequence number gap.
RCC status
rcc enabled
boolean
true if enabled, otherwise false
rcc result
string
Rapid channel change results as defined below:
success: rapid channel change succeeds, all the processes are finished in designed order.
on-going: rapid channel change is in process.
failure: rapid channel change is aborted.
cp failure reason
string
The reason the rapid channel change was aborted at control plane.
NONE: no error, rapid channel change state machine completed in control plane.
NAT_TIMEOUT: NAT server does not have any response within the rcc_start_timeout. (This only happens when sig_mod is in NAT mode.
APP_TIMEOUT: APP packet was not received within the rcc_start_timeout.
dp failure reason
string
NULL_APP: null APP from VQE-S. The server could not process this rapid channel change. Check the server statistics for information regarding this NULL APP.
INVALID_APP: the received APP packet is not valid, i.e one or more fields in the APP packet are not properly set from the VQE-S.
RCC_DISABLED: rapid channel change is not enabled, either in VQE-C system configuration setup or in channel lineup.
UNKNOWN: none of the above reason was detected, but the rapid channel change was aborted.
Buffer fill (ms)
minimum buffer fill
rel_time_t
Minimum buffer fill requirement in ms, calculated based on FEC and ER requirement. This is sent from client to server.
maximum buffer fill
rel_time_t
Maximum buffer fill limit in ms, calculated based on the pak-pool size and max_rcc_backfill_scaler. This is sent from client to server.
buffer fill from APP
rel_time_t
Expected buffer fill from server. This is the value from APP packet.
APP expected relative times (ms)
Join
rel_time_t
Earliest multicast join time
ER
rel_time_t
Expected ER turn on time
End-Of-Burst
rel_time_t
Expected burst end time
Actual relative times (ms)
CC
rel_time_t
The time the channel change was issued, measured at the time the tuner bind channel. This is the starting point for the calculation of all these relative times below
Pli
rel_time_t
The time the PLI packet was sent to VQE-S
APP
rel_time_t
The time the APP packet was received.
Rep
rel_time_t
The time the first repair packet was received.
Join
rel_time_t
The time the multicast join was issued.
Prim
rel_time_t
The time the primary packet was received.
ER
rel_time_t
The time the error-repair was turned on.
Join-lat
rel_time_t
The IGMP join latency. This relative time is the time difference between the multicast join time and the first primary packet received time.
Pcm snapshots
JOIN
List the PCM snapshot at multicast join, including
Head: head of the PCM (smallest sequence number at PCM).
Tail: tail of the PCM (largest sequence number at PCM).
Paks: number of packets cached in PCM.
PRIM
List the PCM snapshots at the time when the first primary packet was received, including
Head: head of the PCM (smallest sequence number at PCM)
Tail: tail of the PCM (largest sequence number at PCM)
Paks: number of packets cached in PCM.
EREN
List the PCM snapshots at the time when error-repair was enabled, including
Head: head of the PCM (smallest sequence number at PCM)
Tail: tail of the PCM (largest sequence number at PCM)
Paks: number of packets cached in PCM.
Output statistics
first primary sequence
vqec_seq_num_t
Sequence number of the first primary packet received.
rcc output loss packets
uint32_t
Total number of lost packets seen at output scheduler during rapid channel change period.
rcc output loss holes
uint32_t
Total number of holes seen at output scheduler during rapid channel change period.
rcc duplicate packets
uint32_t
Total number of duplicated packets received during rapid channel change period
repairs in 1st nack
uint32_t
Total number of repair packets requested in the first NACK after rapid channel change.
first packet output time
rel_time_t
The relative time the first packet of the RCC repair burst was scheduled out to output queue.
last packet output time
rel_time_t
The relative time the last RCC packet was scheduled out to output queue.
first packet decode time
rel_time_t
The relative time the first packet was decoded at STB when changing to a new channel.
NAT Status
string
Indicates whether or not the VQE-C is behind a NAT device (repair RTP port).
Internal address
IP:port
Internal address used for the RTP repairs
Public address
IP:port
External/Public address used for the RTP repairs
Last request time
int
Time of last NAT update request (RTP).
Last response time
int
Time of last NAT update response (RTP).
NAT Status
string
Indicates whether or not the VQE-C is behind a NAT device (repair RTCP port).
Internal address
IP:port
Internal address used for the RTCP repairs
Public address
IP:port
External/Public address used for the RTCP repairs
Last request time
int
Time of last NAT update request (RTCP).
Last response time
int
Time of last NAT update response (RTCP).
Logs
last 10 repair seq
vqec_seq_num_t
List of the last 10 repair sequence numbers
first 10 primary seq
vqec_seq_num_t
List of first 10 primary packet sequence numbers
last 10 fec repair seq
vqec_seq_num_t
List last 10 FEC corrected primary packets
Input Loss (holes)
vqec_seq_num_t
List of the last 10 input loss (holes) sequence number intervals
Output loss (holes)
vqec_seq_num_t
List of the last 10 output loss (holes) sequence number intervals
primary stream dropping
repair stream dropping
string
Indicates whether or not the VQE-C drop simulation is enabled.
dropping
int
Number of contiguous packets that are dropped at the start of each interval.
interval
int
Length of the drop interval, when dropping contiguous packets.
percentage
int (%)
When in random drop mode, approximate randomized percentage of packets that are being dropped.
Information about output streams (from DP input shim; one for each output stream)
Output Stream (with hexadecimal ID specified)
Encaps type
string
Encapsulations supported by this output stream.
Capabilities
string
Capabilities supported by this output stream.
Filter (scheduling class x)
title/int
x represents the scheduling class to which the current filter is associated.
protocol
string
Protocol that the filter is bound to.
source IP
address
IP address to accept incoming packets from.
source port
int
Port number to accept incoming packets from.
dest IP
address
IP address that the filter is bound to.
dest port
int
Port number that the filter is bound to.
Connected Input Stream ID
int
ID of the input stream to which this output stream is connected.
Stats
packets transmitted
int
Total number of packets that have been transmitted over the stream.
bytes transmitted
int
Total number of bytes that have been transmitted over the stream.
packets dropped
int
Total number of packets that failed to be transmitted.
Output shim status
state
string
Current state of the output shim module.
is_creates
int
Number of input streams created.
is_destroys
int
Number of output streams created.
num_tuners
int
Number of DP tuners created.
Tuner status (one for each tuner)
Cp_tid
int
CP ID of this tuner.
qid
int
ID of the output queue.
isid
int
ID of the associated input stream.
qinputs
int
Number of packets input into the output queue.
qdrops
int
Number of packets dropped in the output queue.
qdepth
int
Number of packets currently in the output queue.
qoutputs
int
Number of packets output from the output queue.
Output shim input streams (one for each input stream)
stream id
int
ID of this stream.
capabilities
string
Stream transmission capabilities.
encapsulation
string
Encapsulation of this stream.
mapped TunIDs
multiple ints
IDs of all tuners mapped to this input stream.
connected os
int
ID of the connected output stream.
packets
int
Number of packets on the input stream.
bytes
int
Number of bytes on the input stream.
drops
int
Number of packet drops on the input stream.
1 From RFC 3550
If join-delay is specified, then a histogram will be displayed whose data points are the intervals (in milliseconds) between:
•
•
A single join-delay histogram is maintained across all defined tuners. Data points in the histogram are cleared only via the clear counters command.
Examples
The following example shows the basic statistics and information of a tuner with name tuner1:
vqec# show tuner name tuner1Tuner name: tuner1Channel information for channel 0x56000001Original source multicast: 230.151.1.1Original source port: 10000Dataplane channel ID: a5000001Dataplane graph ID: ba000001Repair RTP ephemeral port: 32795Primary RTP ID: a0000000Repair RTP ID: a0000001FEC0 RTP ID: 0FEC1 RTP ID: 0Channel name: Channel 230.151.1.1Source multicast address: 230.151.1.1Source port: 10000Retransmission/FBT address: 8.36.1.1Maximum bit rate: 3750000PCM counters:input primary packets: 4677652input loss packets: 0input loss holes: 0repair received: 3206output loss packets: 0output loss holes: 0under runs: 0late packets: 1FEC status:fec enabled in channel: falseFEC counters:input fec packets: 0fec recovered packets: 0fec paks, unrecoverable: 0late fec packets: 0fec paks, other: 0--- RCC status ---rcc enabled: truercc result: successcp failure reason: NONEdp failure reason: NONEThe following example shows all statistics and configuration settings of a tuner with name tuner1:
vqec# show tuner all detailTuner name: 1Tuner ID: 0DP Tuner ID: 1Bound to Channel ID: 0xf7000Channel information for channel 0xf7000001Original source multicast: 229.1.1.17Original source port: 53234Dataplane channel ID: 87000001Dataplane graph ID: 86000001Repair RTP ephemeral port: 43167Primary RTP ID: a0000000Repair RTP ID: a0000001FEC0 RTP ID: 0FEC1 RTP ID: 0Current channel information:Channel name: Channel 229.1.1.17Channel sdp_handle: o=- 1207081763 1333130440974 IN IP4 storm-iptvOriginal source multicast address: 229.1.1.17Source address for original source stream: 9.3.13.2Original source port: 53234Original source RTCP port: 53235Original source RTP payload type: 33Original source RTCP sender bandwidth: 53Original source RTCP receiver bandwidth: 530000Original source RTCP per receiver bandwidth: 53Original source RTCP XR Loss RLE Report: OnOriginal source RTCP XR Stat Summary Report: OnRTCP XR Post Repair Loss RLE Report: OnMaximum bit rate: 15000000Retransmission/FBT address: 11.120.1.17Retransmission RTP port: 10066Retransmission RTCP port: 10067Retransmission associated payload type: 99Repair stream RTCP sender bandwidth: 53Repair stream RTCP receiver bandwidth: 53Repair stream RTCP XR Loss RLE Report: OnRepair stream RTCP XR Stat Summary Report: OnError repair: enabledRapid channel change: enabledActive channel cfg updates: 0Active channel's last cfg update time: 0Smart Request: disabledRepeat Request: enabledsoftware rtt min (ms): 0rtt used (ms): 0Error repair policer: enabledrate (repair pkts/s): 414burst (repair pkts): 4148current tokens: 18Primary data received: TRUERTP Primary sessionssrc: 3a8f4257cname: 00-1a-64-6d-18-13nmembers: 2nsenders: 1RTCP compound packet statssent: 9426send_errors: 0rcvd: 0rcvd_errors: 0badver: 0runts: 0badlen: 0unexp: 0avg_pkt_size: 144.010705avg_pkt_size_sent 144.010705Sender info for sender 1ssrc: 1be89f9dcname:received: 656687cum_loss: 281430ehsr: 996051jitter (us): 0Sender stats for sender 1max_seq: 13011cycles: 983040bad_seq: 65537base_seq: 57935transit: 4086607330received: 656687last_arr_ts_media: 58912208seqjumps: 0initseq_count: 1out_of_order: 0Primary RTCP RRs sent: 9426DP sources: 1ssrc=1be89f9d, src ip:9.3.13.2 port:49152source status: (active, pktflow)source PCM seq num offset: 0Repair data received: FALSERTP Repair sessionssrc: 3a8f4257cname: 00-1a-64-6d-18-13nmembers: 2nsenders: 0RTCP compound packet statssent: 28send_errors: 0rcvd: 23rcvd_errors: 0badver: 0runts: 0badlen: 0unexp: 0avg_pkt_size: 77.243000avg_pkt_size_sent 90.057133Repair RTCP RRs sent: 28DP sources: 0--- Dataplane channel stats ---total recvd paks: 938208total recvd primary paks: 938207total recvd repair paks: 0total recvd rtp paks: 938207total rtp drops: 0total sim drops: 281467total early drops: 0runts: 0badver: 0badlen: 0badcreate: 0seqjumps: 0initseq_count: 1runts: 0badver: 0badlen: 0badcreate: 0seqjumps: 0initseq_count: 0total recvd rtcp paks: 23generic nack counter: 9381total repairs requested: 276760total smart req. policed: 0total repeat req sent: 0total repeat req policed: 0total repairs policed: 4670total repairs unrequested: 0failed to send rtcp pak: 0failed to report gap: 0PCM status:head: 995971tail: 996104highest_er_seq_num: 996077last_reqstd_er_seq_num: 996053last_rx_seq_num: 996104num_paks_in_pak_seq: 104primary_received: truerepair_received: falserepair_trigger_time: 19reorder_delay: 20fec_delay: 0original jitter buff size: 100total delay including fec: 100gap_hold_time: 20PCM counters:late packets: 0head ge last seq reqstd: 3input loss packets: 281430input loss holes: 9381output loss packets: 281400output loss holes: 9380pcm_insert drops: 0duplicate packets: 0pak_seq_insert fail paks: 0bad seq range: 0under runs: 0bad receive timestamp: 0last tx seq num: 995970last tx time: 1374487732945236total tx packets: 656635NLL state:mode: 1pred base: 1374487732945last act time: 1374487732945primary offset: 0pcr32 base: 267267057exp disc: 1imp disc: 0resets: 1past predicts: 0reset_base w/o time: 0FEC status:fec enabled in channel: falsefec streams: 0_Dfec_column_stream_avail: falsefec_row_stream_avail: falseL value: 0D value: 0column head: 0column tail: 0row head: 0row tail: 0FEC counters:late fec packets: 0fec recovered packets: 0total fec packets: 0duplicate fec packets: 0rtp hdr invalid paks: 0fec hdr invalid paks: 0fec paks, other: 0fec gaps detected: 0--- RCC status ---rcc enabled: truercc result: failurecp failure reason: NULL_APPdp failure reason: CP_ABORT--- Buffer Fill (ms) ---minimum buffer fill: 100maximum buffer fill: 361buffer fill from APP: 0fast fill from APP (PCR): 0PCR from APP: 0PTS from APP: 0--- APP expected relative times (ms) ---Join ER End-Of-Burst0 0 0---Actual relative times (ms)---First line is VQE-C time, second line is pkt recv timeCC Pli APP Rep Join Prim ER BEND Join-lat0 0 1 0 3 54 3 0 470 0 1 0 3 50 3 0 47--- Pcm snapshots ---Head Tail PaksJOIN 0 0 0PRIM 0 0 0EREN 0 0 0--- Output statistics ---first primary sequence: 57935first repair sequence: 0first repair rtp ts: 0rcc output loss packets: 0rcc output loss holes: 0rcc duplicate packets: 0repairs in 1st nack: 30first packet output time 150last packet output time 159rtcp xr num gap packets: 0concurrent rccs limited: 0RCC output loss (holes):0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0, 0 - 0 time 0,--- NAT status ---NAT id: 3556769794Binding name: :NAT protocol: STUNNAT status: Not Behind NATInternal address: 11.8.10.7:43167Public address: 11.8.10.7:43167Last request time: 1374487074517Last response time: 0NAT id: 285212673Binding name: :NAT protocol: STUNNAT status: Not Behind NATInternal address: 11.8.10.7:43169Public address: 11.8.10.7:43169Last request time: 1374487074517Last response time: 1374487074517primary stream dropping: enabled (using interval)dropping: 30interval: 100percentage: 0%repair stream dropping: disableddropping: 15interval: 100percentage: 0%Input Shim information for channel ID f700000108:Primary Output Stream [ID '0x89000001']Encaps type: RTPCapabilities: PUSH PUSH_VECTORED PUSH_POLLFilter (scheduling class 0):protocol: UDPsource IP: <any>source port: <any>dest IP: 229.1.1.17dest port: 53234Connected Input Stream ID: 2684354560Stats:packets dropped: 0Repair Output Stream [ID '0x80000002']Encaps type: RTPCapabilities: PUSH PUSH_VECTORED PUSH_POLLFilter (scheduling class 0):protocol: UDPsource IP: <any>source port: <any>dest IP: 11.8.10.7dest port: 43167Connected Input Stream ID: 2684354561Stats:packets dropped: 0Tuner status (tunerid = 1):cp_tid: 0qid: 0isid: 1qinputs: 656635qdrops: 656435qdepth: 200qoutputs: 0Output Shim information for channel ID f700000108:Post-repair stream id: 1capabilities: PUSH PUSH_VECTOREDencapsulation: UDPmapped TunIDs: 1connected os: 1packets: 0bytes: 0drops: 0The following example shows the join-delay intervals experienced across all tuners. It indicates that there have been a total 6 channel changes since initialization or last issue of the "clear counters" command, each of which fall within the join-delay bucket ranges listed on the left:
vqec# show tuner join-delayHistogram of Join to First Primary Pkt Delay (in ms):0 - 9 [ 1 ]10 - 19 [ 1 ]20 - 29 [ 2 ]show update
To show information about network and channel configuration updates that have been attempted in the past and scheduled for the future, use the show update command in EXEC mode.
show update
Syntax Description
This command has no arguments or keywords.
Command Modes
None
Command Modes
EXEC
Usage Guidelines
The fields shown in the output of this command are described in the following table:
Note
Examples
The following example shows that the VQE-C performed a successful update with VCDS whose IP address is 138.5.3.1 on January 21 at 16:02. Only the channel configuration was retrieved, as the network configuration file cached by VQE-C was current.
vqec# show updateUpdater state: runningidentity: 00-14-5e-80-6a-4aupdate window: 30polling: enabledpoll interval (s): 3600Next update request: Jan 21 17:03:10Last update request: Jan 21 16:02:11Servers attempted/eligible: 1/1VCDS selected for request: 138.5.3.1:8554VCDS version: vcds 3.2.1Index file retrieval: successNetwork Config update result: update not necessaryChannel Config update result: successLast successful update transfer times:Network Config update response time (s): n/aChannel Config update response time (s): 0.151819Updater counters:Index retrieval attempts (failures): 1 (0)Network Config update attempts (failures): 0 (0)Channel Config update attempts (failures): 1 (0)stream-output
To enable VQE-C output streaming, use the stream-output command in Configuration mode.
stream-output tuner-name if-name output-url
Syntax Description
tuner-name
Name of an active tuner.
if-name
Name of an Ethernet interface.
output-url
Destination URL of the output stream.
Command Default
Output Streaming mode is disabled.
Command Modes
Configuration
Usage Guidelines
When the VQE-C output streaming mode is enabled for a tuner, that tuner will begin sending a repaired output stream on the tuner-if interface. The address and protocol of the repaired output multicast stream is determined from the output-url, which has the form:
output-type://address:port
•
•
•
Examples
The following example enables the VQE-C output streaming mode for a tuner named 0 and begins to send a repaired UDP multicast stream from the interface eth1 to the address 192.168.1.128 on port 50000:
vqec(config)# stream-output 0 eth1 udp://192.168.1.128:50000tuner bind
To bind an active tuner to a either valid channel configured in the channel lineup or a temporary channel described by a channel parameters list, use the tuner bind command in configuration mode.
tuner bind <tuner-name> {<url> | chan-params {file <filename> | list <param_list>}} [no_rcc] [fastfill] [max-fastfill <max_fastfill>] [rcc-bw <max_recv_bw_rcc>] [er-bw <max_recv_bw_er>] [tr-135 gmin <gmin> slmd <slmd>]
Syntax Description
Command Default
None
Command Modes
Configuration
Usage Guidelines
The channel-url must be of the form:
protocol://address:port
protocol: protocol of the channel. Usually igmp.
address: valid IPv4 multicast address of the channel
port: integer in the range [1, 65535] and should match the primary rtp port of the channel as configured in the channel lineup
The params-list or the contents of the params-file should take the following format:
primary-dest-addr addr primary-dest-port port [primary-dest-rtcp-port port] [primary-src-addr addr] [primary-src-port port] [primary-src-rtcp-port port] [primary-payload-type payload-type] primary-bit-rate bit-rate [primary-rtcp-sndr-bw rtcp-bw] [primary-rtcp-rcvr-bw rtcp-bw] [primary-rtcp-per-rcvr-bw rtcp-bw] [primary_rtcp_xr_loss_rle_enable] [primary_rtcp_xr_per_loss_rle_enable] [primary-rtcp-xr-stat-flags loss[,dup][,jitt]] [fbt-addr addr] [er_enable] [rcc_enable] [rtx-src-addr addr ] [rtx-src-port port] [rtx-src-rtcp-port port] [rtx-dest-addr addr] [rtx-dest-port port] [rtx-dest-rtcp-port port] [rtx-payload-type payload-type] [rtx-rtcp-sndr-bw rtcp-bw] [rtx-rtcp-rcvr-bw rtcp-bw] [rtx_rtcp_xr_loss_rle_enable] [rtx-rtcp-xr-stat-flags loss[,dup][,jitt]] [fec_enable] [fec-mode {1D | 2D}] [fec1-mcast-addr addr] [fec1-mcast-port port][fec1-mcast-rtcp-port port] [fec1-src-addr addr] [fec1-payload-type payload-type] [fec1-rtcp-sndr-bw rtcp-bw] [fec1-rtcp-rcvr-bw rtcp-bw] [fec2-mcast-addr addr] [fec2-mcast-port port] [fec2-mcast-rtcp-port port] [fec2-src-addr addr] [fec2-payload-type payload-type] [fec2-rtcp-rcvr-bw rtcp-bw] [fec2-rtcp-sndr-bw rtcp-bw]
addr: dotted decimal IP address
port:valid UDP port number
payload-type: RTP payload type in the dynamic range 96 - 128
bit-rate: rate of the primary stream in bps
rtcp-bw: maximum bandwidth used for RTCP in bps
The tuner bind command may use the parameters list or parameters file created as the output from the parse sdp command. Using the chan-params option in a bind call allows the user to create and listen to channels beyond those described in the channel lineup.
Note
Examples
The following example binds a tuner named "tuner1" to channel 230.151.1.1 at port 10000 using the RTP protocol with RCC enabled if available:
vqec(config)# tuner bind tuner1 rtp://230.151.1.1:10000tuner create
To create a tuner, use the tuner create command in configuration mode.
tuner create tuner-name
Syntax Description
Command Default
None
Command Modes
Configuration
Examples
The following example creates a tuner named newtuner:
vqec(config)# tuner create newtunertuner destroy
To destroy a tuner, use the tuner destroy command in configuration mode.
tuner destroy tuner-name
Syntax Description
Command Default
None
Command Modes
Configuration
Examples
The following example first creates a tuner named newtuner, and then destroys it:
vqec(config)# tuner create newtunervqec(config)# tuner destroy newtunerRelated Commands
tuner unbind
To unbind an active tuner from its currently bound channel, use the tuner unbind command in configuration mode.
tuner unbind tuner-name
Syntax Description
Command Default
None
Command Modes
Configuration
Usage Guidelines
When a tuner is unbound from a channel, that tuner will no longer receive any packets from any channels until it is bound to another channel via the tuner bind command.
Examples
The following example binds a tuner named 0 to channel 224.1.1.1 at port 50000 using the IGMP protocol, and then unbinds that same tuner so it will stop receiving packets from that channel:
vqec(config)# tuner bind 0 igmp://224.1.1.1:50000vqec(config)# tuner unbind 0update
To update the system and/or and channel configurations in VQE-C, use the update command in configuration mode.
update { file <filename> type {network | override-tags | channel } }
Note
Syntax Description
Command Default
VQE-C will update necessary components via CDI when needed and as specified by the VQE-C system configuration.
Command Modes
Configuration
Usage Guidelines
Use update <cr> to trigger a configuration update ahead of the next polled update scheduled by the updater, or if update polling is not configured.
Use the update file <filename> type <type> form of this command to force an update to VQE-C configuration using the contents of a local file. This command should not typically be needed and is provided for special situations only (e.g. as a means to test VQE-C behavior with different configuration files or to supply a configuration file when a VCDS is not available).
Note
Examples
The following example will update the VQE-C configuration from the latest configuration provided by the VCDS referenced by the DNS server:
vqec(config)# update
