3.10. Tools Command Reference

3.10.1. Command Hierarchies

3.10.1.1. Tools Commands

dump
id service-id
interface ip-int-name
id service-id
interface ip-int-name
ignore-sap-port-state {start | stop}

3.10.2. Command Descriptions

3.10.2.1. Tools Commands

tools

Syntax 
tools
Context 
root
Description 

This command enables the context to configure or display tools.

dump

Syntax 
dump
Context 
tools
Description 

This command enables the context to display tools information.

perform

Syntax 
perform
Context 
tools
Description 

This command enables the context to configure tools that perform specific tasks.

service

Syntax 
service
Context 
tools>perform
tools>dump
Description 

This command enables the context to configure and view tools for service debugging purposes.

id

Syntax 
id service-id
Context 
tools>dump>service
tools>perform>service
Description 

This command specifies a service for which to enable and view tools for service debugging purposes.

Parameters 
service-id—
Specifies the service ID.

interface

Syntax 
interface ip-int-name
Context 
tools>dump>service>id
tools>perform>service>id
Description 

This command specifies an IP interface for which to enable and view tools for service debugging purposes.

Parameters 
ip-int-name—
The name of the IP interface. 32 characters maximum.

ignore-sap-port-state

Syntax 
ignore-sap-port-state
Context 
tools>dump>service>id>interface
Description 

This command displays all service interfaces that have accepted an ignore-sap-port-state start command.

This command can be executed without a service-id for a complete list of interfaces that have accepted an ignore-sap-port-state start command. The command can be executed within a specific service-id context for a list of all interfaces for the specified service that have accepted the ignore-sap-port-state start command. The ip-int-name parameter may be optionally configured to display results only for the specified interface. If the command is executed against a specific interface that has not accepted an ignore-sap-port-state start command, the display command will display a message indicating that no action has been started for the interface.

Output 

The following output is an example of ignore-sap-port-state information.

Sample Output
tools dump service ignore-sap-port-state
===============================================================================
Interface Marked Ignore SAP Operational State
===============================================================================
SvcId      Interface-Name               Adm/Opr(v4/v6)  Type    Port/SapId
           IP-Address                                           PfxState
-------------------------------------------------------------------------------
1001       ies-1001                     Up/(Up/Down)    IES     1/1/1:1001.
                                                                1001
           192.168.3.30/24                                      n/a
-------------------------------------------------------------------------------
Number of entries: 1
=============================================================================== 

ignore-sap-port-state

Syntax 
ignore-sap-port-state {start | stop}
Context 
tools>perform>service>id>interface
Description 

This command enables bypassing of the Ethernet operational state check, which would otherwise be part of the Ethernet SAP operational state checking function. All other checks are performed as normal.

This command may be executed against IES and VPRN service IP interfaces directly configured over an Ethernet SAP. When the command is executed against an operational Ethernet SAP, the command enters a pending state, waiting for a non-operational change. Network interfaces have no SAP association and do not support this feature. When using subscriber-interface and group-interface, the command is only applicable to the group-interface associated with the SAP. R-VPLS does not have Ethernet SAPs directly configured under the interface, and is not supported.

This function is meant to allow service validation and reachability testing when a physical Ethernet port has not been connected. The command may be executed for a non-operational SAP that is cabled. However, if the SAP transitions to an operational state, ingress and egress packet processing may still occur.

This command configuration does not survive a system restart.

Parameters 
start—
Enables port state bypass mode for the interface. If the Ethernet port SAP is already operational, there is no immediate effect of the command, and the Ignore Port state under the show service id all command will show “pending”. However, if the interface Ethernet port transitions to a non-operational state, the command then bypasses this port state and executes the remainder of the operational checks, and the flag for the Ignore Port state transitions to “active”. When this command is in effect, the SAP represents the state of the SAP ignoring the port state.
stop—
Disables port state bypass mode for the interface attached to the SAP.