|
|
In addition to the ESP Configuration Interface, described in Chapter 8, the ESP also supports a command line interface (CLI) that can be used for provisioning SPVC and configuring the SPVC auto-grooming feature. These commands are useful for customers who are going to develop their own script to provision SPVCs.
This appendix describes the syntax of these SPVC commands in the following sections:
Auto-grooming is turned off (disabled) until it is activated by command.
The auto-grooming schedule can be either "anytime" or "scheduled". If scheduled time is selected, auto-grooming will start at the specified time and stopped at the stop time. Scheduled times are repeated daily.
Grooming criteria is specified as the percentage improvement of the accumulative administrative weight of the connection path.
Either all or a subset of SPVCs are groomed. If "groom all SPVC connections" is selected, all active connections (SPVCs in the OK state) are evaluated and re-routed if a better path is found.
If a subset of SPVC connections are to be groomed, it is specified in the SPVC grooming list. The grooming list allows a maximum of 100 rows of grooming ranges. Each row specifies the port (slot.port) and the range of VPI.VCIs to be groomed. If you try to enter overlapping ranges in the list, it will be rejected.
Each row of entries in the grooming list is assigned an index number by the ESP interface. You specify the index number to remove a row from the list.
You can query the grooming list via the command line interface. You can also query the status of the auto-grooming process via the command line interface.
The auto-groom feature uses the following commands:
Step 1 Log in to the ESP as an UNIX-level user.
Step 2 Change to the bin directory:
#>cd /opt/aps/bin
Step 3 Start the SPVC client
./cli_client
When SPVC command line interface is running, the prompt will change to spvcmcli>>
By entering a help or a question mark (?) at the spvcmcli>> prompt, you will see the list of the PNNI show commands as shown in Figure J-1. Type quit to exit spvcmcli.
spvcmcli>> ?
Commands related to configuration:
For SPVCM Module:
atm soft-vc grmList add
soft-vc grmList delete
soft-vc grmList enable
soft-vc grmList disable
Commands related to display/show:
For SPVCM Module:
show spvcm soft-vc
stats
prefix
route
grmList entry
grmList all
grmList status
grmList report
spvcmcli>>
The conventions used in these descriptions of SPVC CLI commands are:
As shown in the SPVC CLI Help Menu (see Figure J-1), the SPVC CLI commands related to configuration are:
The atm soft-vc grmList add (add to groom list) command has the following syntax:
atm grmList add L_slot < > L_port < > s_vpi < > s_vci < > e_vpi < > e_vci < >
Groom list entries are deleted by their index number. The atm soft-vc grmList delete (delete from groom list) command has the following syntax:
atm soft-vc grmList delete <indexno> Where indexno is the index number assigned to that groom list entry.
The (atm soft-vc grmList enable (enable auto-grooming) command has the following syntax:
atm grmList enable <%improvement> all | grmList anyTime | { s_time <hour.minute> e_time <hour.minute> }
The following example illustrates the enabling the auto-grooming for the grmList at anytime when there is a 20% improvement.
spvcmcli>> atm soft-vc grmList enable 20 grmList anyTime tmp:0 Reason_Code:3001 Response OK
The atm soft-vc grmList disable (disable auto-grooming) command has the following syntax:
atm soft-vc grmList disable
The following example illustrates the use of the disable auto-grooming command:
spvcmcli>> atm soft-vc grmList disable Reason_Code:3001 Response OK
As listed in the SPVC CLI Help Menu (see Figure J-1), the SPVC CLI commands related to displaying or showing information about SPVCs and auto-grooming are:
The show spvcm soft-vc (show SPVC) command has the following syntax:
show spvcm soft-vc atm-addrs <20 byte source atm-addrs> vpi <vpi_s> vci <vci_s>
The show spvcm stats (show statistics) command has the following syntax:
show spvcm stats
The following is an example of this command:
spvcmcli>> show spvcm stats No. of Spvcs in PendRt state = 2 No. of OK spvcs = 0 No. of Spvcs in setup state = 0 No. of Spvcs in release state = 0 No. of Spvcs in down state = 0 No. of Spvcs in oos state = 0 No. of Spvcs in groom state = 0 spvcmcli>>
This show spvcm prefix command shows the spvcm prefix as shown in the following example:
spvcmcli>> show spvcm prefix Prefix: 47.0.0.0.0.0.0.0.0.0.0.0.3 spvcmcli>>
The show spvcm route (show route) command has the following syntax:
show spvcm soft-vc atm-addrs <> vpi<> vci <>
Individual entries in the groom list can also be displayed with the show spvcm grmList entry command. It has the following syntax:
show spvcm grmList entry <indexno>
Where indexno is the index number of the desired entry in the groom list. The following is an example of the show spvcm grmList entry command:
spvcmcli>> show spvcm grmList entry 1 tmp:0 My_msg_qid:42 Slot:13 Port:1 S_Vpi:3 S_Vci:100 E_Vpi:3 E_Vci:200 Reason_Code:3001 Response OK spvcmcli>>
The show spvcm grmList all (show entire groom list) command displays all the SPVCs added to the groom list. It has the following syntax:
show spvc grmList all
The following is an example of a displayed groom list with 2 entries:
spvcmcli>> show spvc grmList all Index: 1 Slot:13 Port:1 S_vpi: 3 S_Vci: 100 E_vpi: 3 E_vci: 200 Index: 2 Slot:13 Port:1 S_vpi: 1 S_Vci: 1001 E_vpi: 2 E_vci: 1001 spvcmcli
You can also display the status of auto-grooming with the show spvcm grmList status command. It has the following syntax:
show spvcm grmList status
The following example display the typical result of this command:
spvcmcli>> show spvcm grmList status Improvement For Grooming: 33 Grooming For All Spvcs Grooming For All the time Grooming : OFF Total Spvcs Evaluated: 4 Total Groomed Spvcs: 4 Index: 1 Slot:13 Port:1 S_vpi: 3 S_Vci: 100 E_vpi: 3 E_vci: 200 Index: 2 Slot:13 Port:1 S_vpi: 1 S_Vci: 1001 E_vpi: 2 E_vci: 1001 spvcmcli>>
The show spvcm grmList report command provides the groom list report.
The following is a sample of this command:
spvcmcli>> show spvcm grmList report LSlot.LPort.LVpi.LVci Slave NSAP Address.SVpi.SVci OldCost NewCost ctime = Tue Apr 7 01:12:23 1998 spvcmcli>>
|
|