Perform Commands

perform

Syntax

perform

Context

tools

Description

This command enables the context to specify tools to perform specific tasks.

Default

n/a

aps

Syntax

aps

Context

tools>perform

Description

This command enables the context to perform APS operations.

Default

n/a

clear

Syntax

clear aps-id {protect | working}

Context

tools>perform>aps

Description

This command removes all APS operational commands.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

exercise

Syntax

exercise aps-id {protect | working}

Context

tools>perform>aps

Description

This command performs an exercise request on the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

force

Syntax

force aps-id {protect | working}

Context

tools>perform>aps

Description

This command forces a switch to either the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

lockout

Syntax

lockout aps-id

Context

tools>perform>aps

Description

This command locks out the protection circuit in the specified APS group.

Default

n/a

Parameters

aps-id

the specified APS group

request

Syntax

request aps-id {protect | working}

Context

tools>perform>aps

Description

This command requests a manual switch to either the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

cron

Syntax

cron

Context

tools>perform

Description

This command enables the context to perform CRON (scheduling) control operations.

Default

n/a

action

Syntax

action

Context

tools>perform>cron

Description

This command enables the context to stop the execution of a script started by CRON action. See the stop command.

Default

n/a

stop

Syntax

stop [action-name] [owner action-owner][all]

Context

tools>perform>cron>action

Description

This command stops execution of a script started by CRON action.

Default

n/a

Parameters

action-name

specifies the action name

Values

maximum 32 characters

action-owner

specifies the owner name

Default

TiMOS CLI

all

specifies to stop all CRON scripts

cflowd

Syntax

cflowd

Context

tools>perform

Description

This command enables the context to perform Cflowd control operations.

Default

n/a

manual-export

Syntax

manual-export

Context

tools>perform>cflowd

Description

This command manually exports Cflowd flow data.

eth-ring

Syntax

eth-ring

Context

tools>perform

Description

This command enables the context to perform Ethernet ring operations.

Default

n/a

clear

Syntax

clear ring-index

Context

tools>perform>eth-ring

Description

This command is used for the following operations on an Ethernet ring node:

  • clearing an active local administrative command (for example, forced switch or manual switch)

  • triggering reversion before the WTR or WTB timer expires in case of revertive operation

  • triggering reversion in case of non-revertive operation

Default

n/a

Parameters

ring-index

specifies the Ethernet ring index

Values

1 to 128

force

Syntax

clear ring-index path {a | b}

Context

tools>perform>eth-ring

Description

This command forces a block on the ring port where the command is issued.

Default

n/a

Parameters

ring-index

specifies the Ethernet ring index

Values

1 to 128

path {a | b}

displays information for the specified path

manual

Syntax

clear ring-index path {a | b}

Context

tools>perform>eth-ring

Description

In the absence of a failure or FS, this command forces a block on the Ethernet ring port where the command is issued.

Default

n/a

Parameters

ring-index

specifies the Ethernet ring index

Values

1 to 128

path {a | b}

displays information for the specified path

ima

Syntax

ima

Context

tools>perform

Description

This command enables the context to perform IMA operations.

Default

n/a

reset

Syntax

reset bundle-id

Context

tools>perform>ima

Description

This command resets an IMA bundle in the startup state.

Default

n/a

Parameters

bundle-id

specifies the IMA bundle ID

Syntax:          bundle-ima-slot/mda.bundle-num

                        bundle-ima          keyword

                        bundle-num        1 to 32

lag

Syntax

lag

Context

tools>perform

Description

This command configures tools to control LAG.

Default

n/a

clear-force

Syntax

clear-force all-mc

clear-force lag-id lag-id [sub-group sub-group-id]

clear-force peer-mc ip-address

Context

tools>perform>lag

Description

This command clears a forced status.

Default

n/a

Parameters

all-mc

clears all multi-chassis LAG information

lag-id

specifies an existing LAG ID

Values

1 to 32

sub-group-id

specifies a LAG subgroup

Values

1 or 2 (for access ports), 1 to 4 (for network ports)

ip-address

specifies the IP address of a multi-chassis peer

force

Syntax

force all-mc {active | standby}

force lag-id lag-id [sub-group sub-group-id] {active | standby}

force peer-mc peer-ip-address {active | standby}

Context

tools>perform>lag

Description

This command forces an active or standby status.

Default

n/a

Parameters

all-mc

forces an active or standby status for all multi-chassis LAGs

peer-ip-address

specifies a multi-chassis peer by its IP address

lag-id

specifies an existing LAG ID

Values

1 to 32

sub-group-id

specifies a LAG subgroup

Values

1 or 2 (for access ports), 1 to 4 (for network ports)

active

forces the specified LAG, LAG subgroup, multi-chassis LAG peer, or all multi-chassis LAGs to active status

standby

forces the specified LAG, LAG subgroup, multi-chassis LAG peer, or all multi-chassis LAGs to standby status

lcr

Syntax

lcr

Context

tools>perform

Description

This command enables the context to perform T1/E1 Line Card Redundancy (LCR) operations.

Default

n/a

clear

Syntax

clear lcr-id {protect | working}

Context

tools>perform>lcr

Description

This command removes all LCR operational commands from either the protection adapter card or the working adapter card in the specified LCR group.

Default

n/a

Parameters

lcr-id

the specified LCR group, from 1 to 6

protect

clears operational commands from the adapter card acting as a protection card for the LCR group

working

clears operational commands from the adapter card acting as a working card for the LCR group

force

Syntax

force lcr-id {protect | working}

Context

tools>perform>lcr

Description

This command forces activity away from either the protection adapter card or the working adapter card in the specified LCR group.

Default

n/a

Parameters

lcr-id

the specified LCR group, from 1 to 6

protect

forces activity away from the adapter card acting as a protection card for the LCR group

working

forces activity away from the adapter card acting as a working card for the LCR group

lockout

Syntax

lockout lcr-id

Context

tools>perform>lcr

Description

This command locks out the protection adapter card. Locking out the protection card means that activity cannot be switched to the protection card even if the working adapter card has failed.

Default

n/a

Parameters

lcr-id

the specified LCR group, from 1 to 6

log

Syntax

log

Context

tools>perform

Description

This command enables event logging tools.

Default

n/a

test-event

Syntax

test-event

Context

tools>perform>log

Description

This command generates a test event.

Default

n/a

mda-table-refresh

Syntax

mda-table-refresh

Context

tools>perform

Description

This command causes a complete FIB refresh. The command can be used to restore a FIB that is in a failed state. For information on FIB failures, see the 7705 SAR Router Configuration Guide, ‟Troubleshooting the FIB”.

Default

n/a

mw

Syntax

mw

Context

tools>perform

Description

This command enables the context to perform microwave operations.

Default

n/a

clear

Syntax

clear mw-link-id {main | spare} {eps | tps | rps}

Context

tools>perform>mw

Description

This command removes all microwave link operational commands.

Default

n/a

Parameters

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

main

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is main

spare

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is spare

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

force

Syntax

force mw-link-id {eps | tps | rps}

Context

tools>perform>mw

Description

This command forces the spare MPR-e radio to become the main MPR-e radio in a 1+1 HSB configuration, even though it might not be in a fit state to assume the role. Once a forced switch operation is issued, it overrides any manual switch or automatic switch operation that is already in place.

Default

n/a

Parameters

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

lockout

Syntax

lockout mw-link-id {eps | tps | rps}

Context

tools>perform>mw

Description

This command prevent the spare MPR-e radio in a 1+1 HSB configuration from ever becoming the main radio, even when the main MPR-e radio fails.

Default

n/a

Parameters

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

manual

Syntax

manual mw-link-id {main | spare} {eps | tps | rps}

Context

tools>perform>mw

Description

This command attempts to switch the main/spare status of an MPR-e radio in a 1+1 HSB configuration; however, should certain operational conditions pertaining to the radio channel or radio hardware not allow the switchover (such as port failures, equipment failures, and reception failures), an automatic switch operation overriding the manual switch attempt is triggered.

Default

n/a

Parameters

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

main

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is main

spare

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is spare

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

software-download

Syntax

software-download [force]

Context

tools>perform>mw

Description

This command performs a software download to all MPR-e radios in the system that are not currently running the correct software. The software is downloaded to the inactive software bank of the MPR-e radios, in preparation of a software upgrade (the command does not activate a system upgrade).

This command allows operators to minimize outage times during a 7705 SAR system software upgrade (with Microwave Awareness). Before the software upgrade is performed, the operator runs this command to download the software to the radios while they are in service. Next, the operator performs the software upgrade. During the 7705 SAR system reboot, the new radio software is activated at the same time as the new system software, thus allowing both the system software and the MPR-e radio software to boot into the new load simultaneously.

Default

n/a

Parameters

force

forces a software download to all MPR-e radios regardless of the software version that they are currently running

ptp

Syntax

ptp reset-clk-rec clock-id clock-id

Context

tools>perform

Description

This command resets a PTP clock that is transmitting and receiving PTP messages using IPv4 or IPv6 encapsulation or using Ethernet encapsulation.

Default

n/a

Parameters

clock-id

specifies the PTP clock ID

Values

1 to 16 for PTP clocks that use IPv4 or IPv6 encapsulation

csm for a PTP clock that uses Ethernet encapsulation

security

Syntax

security

Context

tools>perform

Description

This command provides tools for testing security.

Default

n/a

authentication-server-check

Syntax

authentication-server-check server-address ip-address [port port] {{user-name user-name password password} | attr-from-file file-url}} secret key [source-address ip-address] [timeout seconds] [router router-instance | service-name service-name]

Context

tools>perform>security

Description

This command checks connection to the RADIUS server.

Default

n/a

Parameters

ip-address

specifies the source IP address of the DHCP relay messages

Values

ipv4-address

     a.b.c.d

ipv6-address

     x:x:x:x:x:x:x:x (eight 16-bit pieces)

                          x:x:x:x:x:x:d.d.d.d

                          x: [0 to FFFF]H

                          d: [0 to 255]D

port

specifies the port ID

Values

1 to 65535

user-name

specifies the DHCP client

Values

253 characters maximum

password

specifies the CLI access password

Values

64 characters maximum

key

specifies the authentication key

Values

20 characters maximum

seconds

specifies the timeout in seconds

Values

1 to 90

router-instance

specifies the router name or service ID

Values

router-name:      Base, management

service-id:          1 to 2147483647

Default

Base

service-name

specifies the service name

file-url

the URL of the file

Values

file-url:

local-url | remote-url

   local-url:

[cflash-id/][file-path

       200 chars max, including cflash-id

       directory length 99 chars max each

   remote-url:

[{ftp:// | tftp://}login:pswd@remote- locn][file-path]

        255 chars max

        directory length 99 chars max each

   remote-locn:  

[hostname | ipv4-address | ipv6-address]

   ipv4-address:

a.b.c.d

   ipv6-address:  

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x: [0 to FFFF]H

d: [0 to 255]D

interface: 32 chars max, for link local addresses

   cflash-id:

(7705 SAR-18)  cf1: | cf1-A: | cf1-B: | cf2: | cf2-A: | cf2-B: | cf3: | cf3-A: | cf3-B:

(7705 SAR-8 Shelf V2)  cf3: | cf3-A: | cf3-B:

(7705 SAR fixed platforms)  cf3: | cf3-A:

service

Syntax

service

Context

tools>perform

Description

This command enables the context to configure tools for services.

id

Syntax

id service-id

Context

tools>perform>service

Description

This command enables the context to configure tools for a specific service.

Parameters

service-id

specifies an existing service ID

Values

1 to 2147483647or a name string up to 64 characters long

endpoint

Syntax

endpoint endpoint-name

Context

tools>perform>service>id

Description

This command enables the context to configure tools for a specific service endpoint.

Parameters

endpoint-name

specifies an existing service endpoint name

force-switchover

Syntax

force-switchover sdp-id:vc-id

no force-switchover

Context

tools>perform>service>id

Description

This command forces a switch of the active spoke SDP for the specified service.

Parameters

sdp-id:vc-id

specifies an existing spoke SDP for the service

Values

sdp-id:          1 to 17407

vc-id:            1 to 4294967295

ip-transport

Syntax

ip-transport ipt-id

Context

tools>perform>service>id

Description

This command enables the context to configure tools for a specific IES or VPRN IP transport subservice.

Parameters

ipt-id

specifies the IP transport subservice physical port identifier

Values

value in the format slot/mda/port.channel

remote-host

Syntax

remote-host host-id check-tcp

Context

tools>perform>service>id>ip-transport

Description

This command establishes a TCP connection to the remote host. The connection is torn down upon being successfully established. This command does not abide by the max-retries or retry-interval configured for the IP transport subservice; only one connection attempt, with a timeout of 5 seconds, is made when this command is executed.

If a TCP connection is already established to the remote host, this command does not impact that connection. It returns a successful status indication, with an explanation that a TCP connection was already established.

Default

n/a

Parameters

host-id

the remote host identifier

Values

1 to 2147483647or a name string up to 64 characters long

check-tcp

establishes a TCP connection to the remote host

sap

Syntax

sap sap-id cem asym-delay-adjust

Context

tools>perform>service>id

Description

This command performs a one-time ADC analysis on a TDM PW without having to shut down the service. This analysis is done with live traffic (that is, not with all-ones or the idle-payload-fill value). If the difference between the calculated average latency and the expected latency is greater than the threshold-repeat value configured with the asym-delay-control command, octets are added or dropped as necessary.

The service must already be enabled for ADC. If ADC repeat is also enabled on the service when this command is run, the timer for the next repeat period starts when the on-demand analysis ends.

Default

n/a

Parameters

sap-id

the Cpipe SAP ID

Values

cem

port-id|bridge-id

port-id

slot/mda/port

bridge-id

slot/mda/bridge.branch

cem asym-delay-adjust

performs an ADC analysis on the service

system

Syntax

system

Context

tools>perform

Description

This command enables the context to use tools that control the system.

management-interface

Syntax

management-interface

Context

tools>perform>system

Description

This command enables access to the management interface tools.

snmp

Syntax

snmp

Context

tools>perform>system>management-interface

Description

This command enables access to the SNMPv3 tools.

change-key

Syntax

change-key authentication authentication-protocol old-authentication-key new-authentication-key

change-key authentication authentication-protocol privacy privacy-protocol old-privacy-key new-privacy-key

Context

tools>perform>system>management-interface>snmp

Description

This command generates KeyChange strings to change SNMPv3 authentication or privacy keys. The SNMP engine ID is not needed because localized keys are required as input. The KeyChange algorithm uses a random string so the output is different each time the command is run.

Parameters

authentication-protocol

specifies the SNMPv3 authentication protocol

Values

hmac-md5-96 — specifies use of the HMAC-MD5-96 authentication protocol

hmac-sha1-96 — specifies use of the HMAC-SHA1-96 authentication protocol

hmac-sha2-224 — specifies use of the HMAC-SHA2-224 authentication protocol

hmac-sha2-256 — specifies use of the HMAC-SHA2-256 authentication protocol

hmac-sha2-384 — specifies use of the HMAC-SHA2-384 authentication protocol

hmac-sha2-512 — specifies use of the HMAC-SHA2-512 authentication protocol

old-authentication-key

specifies the old localized authentication key

new-authentication-key

specifies the new localized authentication key

privacy-protocol

specifies the SNMPv3 privacy protocol

Values

cbc-des — specifies use of the CBC-DES privacy protocol; this parameter is not available in FIPS-140-2 mode

cfb128-aes-128 — specifies use of the CFB128-AES-128 privacy protocol

cfb128-aes-192 — specifies use of the CFB128-AES-192 privacy protocol

cfb128-aes-256 — specifies use of the CFB128-AES-256 privacy protocol

old-privacy-key

specifies the old localized privacy key

new-privacy-key

specifies the new localized privacy key

generate-key

Syntax

generate-key authentication authentication-protocol authentication-password [privacy privacy-protocol privacy-password] [engine-id identifier]

Context

tools>perform>system>management-interface>snmp

Description

This command generates localized SNMPv3 authentication and privacy keys, which are a hash of the SNMP engine ID and a password. The SNMP engine ID can be displayed with the show system information | match "SNMP Engine ID" command and does not need to be entered. If keys are being generated for a different system, its SNMP engine ID must be specified.

Parameters

authentication-protocol

specifies the SNMPv3 authentication protocol

Values

hmac-md5-96 — specifies use of the HMAC-MD5-96 authentication protocol

hmac-sha1-96 — specifies use of the HMAC-SHA1-96 authentication protocol

hmac-sha2-224 — specifies use of the HMAC-SHA2-224 authentication protocol

hmac-sha2-256 — specifies use of the HMAC-SHA2-256 authentication protocol

hmac-sha2-384 — specifies use of the HMAC-SHA2-384 authentication protocol

hmac-sha2-512 — specifies use of the HMAC-SHA2-512 authentication protocol

authentication-password

specifies the password used to generate the authentication key, from 8 to 255 characters

privacy-protocol

specifies the SNMPv3 privacy protocol

Values

cbc-des — specifies use of the CBC-DES privacy protocol; this parameter is not available in FIPS-140-2 mode

cfb128-aes-128 — specifies use of the CFB128-AES-128 privacy protocol

cfb128-aes-192 — specifies use of the CFB128-AES-192 privacy protocol

cfb128-aes-256 — specifies use of the CFB128-AES-256 privacy protocol

privacy-password

specifies the privacy password, from 8 to 255 characters

identifier

specifies an SNMP engine ID; must be a hexadecimal string from 10 to 64 digits

script-control

Syntax

script-control

Context

tools>perform>system

Description

This command enables the script-control context to access script policy commands.

script-policy

Syntax

script-policy

Context

tools>perform>system>script-control

Description

This command enables the script-policy context to access script policy tools.

stop

Syntax

stop [policy-name] [owner policy-owner] [all]

Context

tools>perform>system>script-control>script-policy

Description

This command stops the execution of scripts.

Parameters

policy-name

specifies to only stop scripts with the specified script policy name

policy-owner

specifies to only stop scripts for script policies with the specified owner

all

specifies to stop all running scripts