p3vlink Utility Examples
To show the CMTS device general configuration, CMTS device list, and CMTS device information:
Version : 4.1.0 Build 123
Monitor Every : 5 minutes
Next query operation : Tue Dec 17 14:17:24 IST 2013
Next ip removal operation : Tue Dec 31 14:12:24 IST 2013
Enable Device Learning : true
Enable Dynamic Giaddrs Learning : true
Upstream Global Controllers : None
Downstream Global Controllers : None
Ignore Duplicate IP : false
periodic SMNP BG query interval : 3 Minutes
Global SNMP BG query mode : all
SNMP BG subscriber mode : all
Import subscriber in to DB from device : false
Subscribers list for SNMP BG query : all
1) Name: ArrisNOVACMTS, Host Name: ArrisNOVACMTS, Type: Static, Query state: Failure, Last successful query:
Command terminated successfully
To show the general configuration of a specified CMTS device:
p3vlink --show-device -d CMTS1 --detail
Ignore Periodic Device Query: false
Last success Query: Tue Dec 17 14:53:34 IST 2013
Last Query Attempt: Tue Dec 17 14:53:34 IST 2013
Last Query Status: Completed
Sync state with SCE: Not-done
Giaddr List: 10.78.242.201;
Upstream Global Controllers: None
Downstream Global Controllers: None
Num of up interfaces: 100
Num of down interfaces: 17
1) Name: cmts1_Cable5/1/0-upstream0, Vlink Id: 244, Direction: UP, PIR: 5120 kbps
2) Name: cmts1_Cable5/1/0-upstream1, Vlink Id: 239, Direction: UP, PIR: 2560 kbps
3) Name: cmts1_Cable5/1/0-upstream2, Vlink Id: 233, Direction: UP, PIR: 5120 kbps
4) Name: cmts1_Cable5/1/0-upstream3, Vlink Id: 278, Direction: UP, PIR: 2560 kbps
5) Name: cmts1_Cable5/1/1-upstream0, Vlink Id: 226, Direction: UP, PIR: 2560 kbps
6) Name: cmts1_Cable5/1/1-upstream1, Vlink Id: 222, Direction: UP, PIR: 2560 kbps
7) Name: cmts1_Cable5/1/1-upstream2, Vlink Id: 247, Direction: UP, PIR: 2560 kbps
8) Name: cmts1_Cable5/1/1-upstream3, Vlink Id: 229, Direction: UP, PIR: 2560 kbps
9) Name: cmts1_Cable5/1/2-upstream0, Vlink Id: 273, Direction: UP, PIR: 2560 kbps
10) Name: cmts1_Cable5/1/2-upstream1, Vlink Id: 228, Direction: UP, PIR: 2560 kbps
11) Name: cmts1_Cable5/1/2-upstream2, Vlink Id: 211, Direction: UP, PIR: 2560 kbps
12) Name: cmts1_Cable5/1/2-upstream3, Vlink Id: 221, Direction: UP, PIR: 2560 kbps
13) Name: cmts1_Cable5/1/3-upstream0, Vlink Id: 195, Direction: UP, PIR: 2560 kbps
14) Name: cmts1_Cable5/1/3-upstream1, Vlink Id: 277, Direction: UP, PIR: 2560 kbps
15) Name: cmts1_Cable5/1/3-upstream2, Vlink Id: 192, Direction: UP, PIR: 2560 kbps
16) Name: cmts1_Cable5/1/3-upstream3, Vlink Id: 202, Direction: UP, PIR: 2560 kbps
17) Name: cmts1_Cable5/1/4-upstream0, Vlink Id: 193, Direction: UP, PIR: 2560 kbps
18) Name: cmts1_Cable5/1/4-upstream1, Vlink Id: 259, Direction: UP, PIR: 2560 kbps
19) Name: cmts1_Cable5/1/4-upstream2, Vlink Id: 256, Direction: UP, PIR: 2560 kbps
20) Name: cmts1_Cable5/1/4-upstream3, Vlink Id: 210, Direction: UP, PIR: 2560 kbps
21) Name: cmts1_Cable6/0/0-downstream, Vlink Id: 355, Direction: DOWN, PIR: 42885 kbps
22) Name: cmts1_Cable6/0/0-downstream:WB-340, Vlink Id: 340, Direction: DOWN, PIR: 200000 kbps
Channel Name: cmts1_Modular-Cable1/0/0:0-L24, index: 340, PIR: 50000 kbps, CIR: 40000 kbps
Channel Name: cmts1_Modular-Cable1/0/0:1-L25, index: 341, PIR: 50000 kbps, CIR: 40000 kbps
Channel Name: cmts1_Modular-Cable1/0/0:2-L26, index: 342, PIR: 50000 kbps, CIR: 40000 kbps
Channel Name: cmts1_Modular-Cable1/0/0:3-L27, index: 343, PIR: 50000 kbps, CIR: 40000 kbps
Channel Name: cmts1_Wideband-Cable1/0/0:0-OLBG-W1, index: 344, PIR: 200000 kbps, CIR: 20000 kbps
23) Name: cmts1_Cable6/0/0-upstream0, Vlink Id: 249, Direction: UP, PIR: 5120 kbps
24) Name: cmts1_Cable6/0/0-upstream1, Vlink Id: 260, Direction: UP, PIR: 2560 kbps
25) Name: cmts1_Cable6/0/0-upstream2, Vlink Id: 263, Direction: UP, PIR: 2560 kbps
26) Name: cmts1_Cable6/0/0-upstream3, Vlink Id: 214, Direction: UP, PIR: 2560 kbps
27) Name: cmts1_Cable6/0/1-downstream, Vlink Id: 338, Direction: DOWN, PIR: 30342 kbps
28) Name: cmts1_Cable6/0/1-upstream0, Vlink Id: 181, Direction: UP, PIR: 2560 kbps
29) Name: cmts1_Cable6/0/1-upstream1, Vlink Id: 236, Direction: UP, PIR: 2560 kbps
30) Name: cmts1_Cable6/0/1-upstream2, Vlink Id: 200, Direction: UP, PIR: 2560 kbps
31) Name: cmts1_Cable6/0/1-upstream3, Vlink Id: 184, Direction: UP, PIR: 2560 kbps
32) Name: cmts1_Cable6/0/2-downstream, Vlink Id: 356, Direction: DOWN, PIR: 30342 kbps
33) Name: cmts1_Cable6/0/2-upstream0, Vlink Id: 187, Direction: UP, PIR: 2560 kbps
34) Name: cmts1_Cable6/0/2-upstream1, Vlink Id: 185, Direction: UP, PIR: 2560 kbps
35) Name: cmts1_Cable6/0/2-upstream2, Vlink Id: 209, Direction: UP, PIR: 2560 kbps
36) Name: cmts1_Cable6/0/2-upstream3, Vlink Id: 191, Direction: UP, PIR: 2560 kbps
37) Name: cmts1_Cable6/0/3-downstream, Vlink Id: 348, Direction: DOWN, PIR: 30342 kbps
38) Name: cmts1_Cable6/0/3-upstream0, Vlink Id: 217, Direction: UP, PIR: 2560 kbps
39) Name: cmts1_Cable6/0/3-upstream1, Vlink Id: 189, Direction: UP, PIR: 2560 kbps
40) Name: cmts1_Cable6/0/3-upstream2, Vlink Id: 250, Direction: UP, PIR: 2560 kbps
Command terminated successfully
The output of this command includes these four information elements:
- Num of up interfaces—Summarizes the total number of upstream virtual links related to this CMTS device. Unknown indicates that the VLM was not able to communicate with the CMTS device.
- Num of down interfaces—Summarizes the total number of downstream virtual links related to this CMTS device. Unknown indicates that the VLM was not able to communicate with the CMTS device.
- Sync state with Cisco SCE:
– Done—The Cisco SCE is fully synchronized with CMTS device information.
– Not-done—The Cisco SCE is not synchronized with all CMTS device data. Use the p3vlink --resync -n < sce which manages the device > command to perform the synchronization operation.
– Sync-in-process—When VLM detects configuration changes, the change needs to be sent to the Cisco SCE. During the update process, the VLM changes the sync state to Sync-in-process.
For successful updates, the Cisco SCE sync state is set to Done, else the value is set to Not-Done.
- Sync state with Collection Manager:
– Done—The Collection Manager is fully synchronized with CMTS device information.
– Not-done—The CM is not synchronized with all CMTS device data. Use the p3vlink --resync -n < sce which manages the device > command to perform the synchronization operation.
– N/A—The Cisco SCE to which the CMTS device belongs, is not connected to any Collection Manager.
– Sync-in-process – When VLM detects configuration changes, the change needs to be sent to the Collection Manager. During the update process, the VLM changes the sync state to Sync-in-process.
For successful updates, Cisco SCE sync state is set to Done, else the value is set to Not-Done.
– Not started—Query operation for the device was not started since the last Cisco Subscriber Manager boot.
– Completed—Last query was completed successfully.
– Failure—Last query failed to complete.
– Waiting for query—Query operation is in queue waiting for resources.
– In-query—Device is in the process of a query operation.
– Waiting for deletion—During the last query, if no giaddr was found, the system queues up the device for deletion. This is applicable only to dynamic devices.
To show all the virtual links for a specific network element (Cisco SCE):
p3vlink --show-vlinks -n sc0
device0_0_Cmts0/1-downstream1, vlink id=15, direction=DOWN
device0_0_Cmts0/1-upstream1, vlink id=8, direction=UP
device0_0_Cmts0/1-upstream2, vlink id=16, direction=DOWN
device0_1_Cmts1/1-downstream1, vlink id=11, direction=DOWN
device0_1_Cmts1/1-upstream1, vlink id=6, direction=UP
device0_1_Cmts1/1-upstream2, vlink id=12, direction=DOWN
device0_2_Cmts2/1-downstream1, vlink id=25, direction=DOWN
device0_2_Cmts2/1-upstream1, vlink id=13, direction=UP
device0_2_Cmts2/1-upstream2, vlink id=26, direction=DOWN
device0_3_Cmts3/1-downstream1, vlink id=13, direction=DOWN
device0_3_Cmts3/1-upstream1, vlink id=7, direction=UP
device0_3_Cmts3/1-upstream2, vlink id=14, direction=DOWN
device0_4_Cmts4/1-downstream1, vlink id=21, direction=DOWN
device0_4_Cmts4/1-upstream1, vlink id=11, direction=UP
device0_4_Cmts4/1-upstream2, vlink id=22, direction=DOWN
device0_5_Cmts5/1-downstream1, vlink id=1, direction=DOWN
device0_5_Cmts5/1-upstream1, vlink id=1, direction=UP
device0_5_Cmts5/1-upstream2, vlink id=2, direction=DOWN
device0_6_Cmts6/1-downstream1, vlink id=9, direction=DOWN
device0_6_Cmts6/1-upstream1, vlink id=5, direction=UP
device0_6_Cmts6/1-upstream2, vlink id=10, direction=DOWN
device1_0_Cmts7/1-downstream1, vlink id=3, direction=DOWN
device1_0_Cmts7/1-upstream1, vlink id=2, direction=UP
device1_0_Cmts7/1-upstream2, vlink id=4, direction=DOWN
device1_1_Cmts8/1-downstream1, vlink id=7, direction=DOWN
device1_1_Cmts8/1-upstream1, vlink id=4, direction=UP
device1_1_Cmts8/1-upstream2, vlink id=8, direction=DOWN
device1_2_Cmts9/1-downstream1, vlink id=27, direction=DOWN
device1_2_Cmts9/1-upstream1, vlink id=14, direction=UP
device1_2_Cmts9/1-upstream2, vlink id=28, direction=DOWN
device1_3_Cmts10/1-downstream1, vlink id=23, direction=DOWN
device1_3_Cmts10/1-upstream1, vlink id=12, direction=UP
device1_3_Cmts10/1-upstream2, vlink id=24, direction=DOWN
device1_4_Cmts11/1-downstream1, vlink id=19, direction=DOWN
device1_4_Cmts11/1-upstream1, vlink id=10, direction=UP
device1_4_Cmts11/1-upstream2, vlink id=20, direction=DOWN
device1_5_Cmts12/1-downstream1, vlink id=5, direction=DOWN
device1_5_Cmts12/1-upstream1, vlink id=3, direction=UP
device1_5_Cmts12/1-upstream2, vlink id=6, direction=DOWN
device1_6_Cmts13/1-downstream1, vlink id=17, direction=DOWN
device1_6_Cmts13/1-upstream1, vlink id=9, direction=UP
device1_6_Cmts13/1-upstream2, vlink id=18, direction=DOWN
Command terminated successfully
To show the vlink data of a specific link:
p3vlink --show-vlink-data --vlink-name=device_Cmts0/0-downstream1
VLink Name: device_Cmts0/0-downstream1
Channels related to VLink
<name>-L, index <index>, PIR <value>, CIR <value>
<name>-W, index <index>, PIR <value>, CIR <value>
Related upstream virtual links —Lists all upstream interface related to the same MAC layer as the selected downstream interface.
Note If more than one vlink has the same name, this command displays the information for all the vlinks.
To Show the maximum number of upstream and downstream vlinks, the number of existing, and free vlinks in a Cisco SCE device:
p3vlink --show-vlink-details -n sce1
Maximum number of upstream Channels supported : 1023
Maximum number of downstream Channels supported : 1023
Free upstream Channels available : 596
Free downstream Channels available : 754
Number of upstream channels created : 427
Number of downstream channels created : 269
Command terminated successfully
To show the upstream and downstream vlink mappings that the virtual link manager learnt from all configured CMTSs:
p3vlink --show-vlink-mappings
IPDR Vlink Mapping Tables:
===========================
{10.52.206.2_1054_1=191, 10.52.206.2_1109_2=88,
10.52.206.2_1077_4=196, 10.52.206.2_1031_1=99,
10.52.206.2_1019_4=43, 10.52.206.2_1047_1=9,
10.52.206.2_1093_4=97, 10.52.206.2_1018_2=158,
10.52.206.2_1080_2=73, 10.52.206.2_1042_4=126}
{10.52.206.2_1110_185=9, 10.52.206.2_1106_169=3,
10.52.206.2_1093_153=7, 10.52.206.2_1095_161=5,
10.52.206.2_1092_149=1, 10.52.206.2_1108_177=6,
10.52.206.2_1107_173=2, 10.52.206.2_1094_157=8,
Command terminated successfully
To show the subscribers using virtual links:
- Use the p3subsdb command to list all the subscribers:
Command terminated successfully
- Use the p3subs command to show the virtual links of a particular subscriber:
p3subs --show -s 0005ca679c20
downVlinkId=11 Name=cmts1_Cable7/1/4-downstream
upVlinkId=10 Name=cmts1_Cable7/0/3-upstream3
Command terminated successfully
- Use the p3vlink command to show the subscribers that are associated with a particular CMTS device:
p3vlink --show-subs -d device1_1
Subscribers related to device: device1_1 vlink-id: 4, giaddr: 1.1.1.1, direction UP
Subscribers related to device: device1_1 vlink-id: 7, giaddr: 1.1.1.1, direction DOWN
Command terminated successfully
- Use the p3vlink command to show the subscribers that are associated with a specific CMTS device:
p3vlink --show-subs -d Test0 --direction=Down --vlink-id=23
Subscribers related to device: Test0 vlink-id: 23, giaddr: 24.191.128.17, direction DOWN010101010106010101010107
Command terminated successfully
- Use the p3vlink command to show the subscribers that are associated with a specific vlink:
p3vlink --show-subs --vlink-name test1_Cmts0/0-upstream2
Subscribers related to device: test1 vlink-id: 5, giaddr: 10.78.233.149, direction UP
Command terminated successfully
- Use the p3vlink command to show the subscribers that are associated to a channel name:
downVlinkId=11 Name=local_Modular-Cable1/0/0:1-L194
upVlinkId=11 Name=local_Cable7/0/2-upstream2
Command terminated successfully
p3vlink --show-subs --channel-name=local_Cable7/0/2-upstream2
Subscribers related to device: local vlink-id: 11, giaddr: 10.78.233.233, direction UP
Command terminated successfully
p3vlink --show-subs --channel-name=local_Modular-Cable1/0/0:1-L194
Subscribers related to device: local vlink-id: 11, giaddr: 10.78.233.233, direction DOWN
Command terminated successfully
To view the subscribers with partial, no, and 0 vlink mappings for a given device:
p3vlink --show-subs-partial-vlink -d cisco
Subscribers with partial and default vlinks in Device cisco :
=============================================================
000101010d10,000101010e10
To imort the subscribers from a given file to the SNMP BG primary queue:
p3vlink --import-queue --file-name=file.csv
The following imported subscribers are added into primary queue:
================================================================
00252ed45a06,00252ed459fe,00252ed459d8,001b2f8dfaad,
00252ed45934,00252ed4589e,00252ed4585a,00252ed455dc,
00252ed455d8,00252ed454ee,00252ed453ca,00252e11d22e,
0024b2106af4,001dcf1e48f4,001dcf1e48cc,00252ed459d6
Command terminated successfully