perform commands

The perform commands are YANG-modeled versions of the tools perform commands and are available in MD-CLI and NETCONF interfaces. The perform commands execute actions in the router, such as:
  • force a LAG subgroup to become active
  • set an IS-IS overload condition
  • terminate a Python script
perform 
   —  application-assurance 
      —  aarp reference 
         —  force-evaluate 
            —  [force-evaluate] 
      —  group reference 
         —  load-balance 
            —  service-id number
         —  partition reference 
            —  aa-sub 
               —  esm 
                  —  clear-quarantine 
                  —  quarantine 
                  —  [sub-ident-string] named-item
               —  esm-mac 
                  —  clear-quarantine 
                  —  [esm-mac-name] named-item
                  —  quarantine 
               —  sap 
                  —  clear-quarantine 
                  —  quarantine 
                  —  [sap-id] sap
               —  spoke-sdp 
                  —  clear-quarantine 
                  —  quarantine 
                  —  [sdp-bind-id] sdp-bind-id
               —  transit 
                  —  clear-quarantine 
                  —  quarantine 
                  —  [transit-aasub-name] named-item
            —  tethering 
               —  [clear-counters] 
   —  filter 
      —  ip-filter reference 
         —  entry reference 
            —  activate-primary-action 
      —  ipv6-filter reference 
         —  entry reference 
            —  activate-primary-action 
      —  mac-filter reference 
         —  entry reference 
            —  activate-primary-action 
      —  redirect-policy reference 
         —  activate-best-dest 
   —  lag 
      —  clear-force 
         —  lag 
            —  [lag-name] reference
            —  sub-group number
         —  multi-chassis 
            —  all 
            —  peer 
               —  [ip-address] reference
      —  force-active 
         —  lag 
            —  [lag-name] reference
            —  sub-group number
         —  multi-chassis 
            —  all 
            —  peer 
               —  [ip-address] reference
      —  force-standby 
         —  lag 
            —  [lag-name] reference
            —  sub-group number
         —  multi-chassis 
            —  all 
            —  peer 
               —  [ip-address] reference
      —  load-balance 
         —  class number
         —  [lag-name] reference
   —  python 
      —  python-policy 
         —  cache 
            —  policy 
               —  hex-key hex-string
               —  [name] reference
               —  set-lifetime number
               —  string-key string
      —  python-script 
         —  protect 
            —  hmac-sha256-key string
            —  input-file string
            —  output-file string
         —  reload 
            —  script 
               —  [name] reference
   —  router string 
      —  isis reference 
         —  ldp-sync-exit 
         —  overload 
            —  max-metric boolean
            —  [seconds] number
         —  run-manual-spf 
      —  mcast-umh-red 
         —  show 
            —  pair 
               —  card number
               —  pair-id number
               —  summary 
      —  pim 
         —  mc-ecmp-rebalance 
            —  threshold number
         —  show 
            —  iom-failures 
               —  detail boolean
   —  system 
      —  script-control 
         —  script-policy 
            —  stop 
               —  all 
               —  owner reference
               —  policy-name reference
      —  security 
         —  secure-boot 
            —  show 
               —  uefi-variables 
                  —  card reference
      —  ssh 
         —  generate-keypair 
            —  ecdsa-curve keyword
            —  ed25519 
            —  rsa-key-size number
            —  [save-path] cflash-url

perform command descriptions

perform

Synopsis Perform troubleshooting and debugging
Contextperform
Treeperform
Introduced23.7.R1

Platforms

All

application-assurance

Synopsis Enter the application-assurance context
Contextperform application-assurance
Treeapplication-assurance

Description

Commands in this context perform Application Assurance (AA) operations.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

aarp [aarp-id] reference
Synopsis Enter the aarp list instance
Context perform application-assurance aarp reference
Treeaarp

Description

Commands in this context perform Application Assurance Redundancy Protocol (AARP) instance operations.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

[aarp-id] reference
Synopsis AARP ID
Contextperform application-assurance aarp reference
Treeaarp

Reference

state application-assurance aarp aarp-id

Notes

This element is part of a list key.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

group [aa-group-id] reference
Synopsis Enter the group list instance
Context perform application-assurance group reference
Treegroup

Description

Commands in this context perform AA group operations.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

[aa-group-id] reference
Synopsis AA group ID
Contextperform application-assurance group reference
Treegroup

Reference

state application-assurance group aa-group-id

Notes

This element is part of a list key.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

partition [aa-partition-id] reference
Synopsis Enter the partition list instance
Context perform application-assurance group reference partition reference
Treepartition
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

[aa-partition-id] reference
Synopsis AA partition ID
Context perform application-assurance group reference partition reference
Treepartition

Reference

state application-assurance group partition aa-partition-id

Notes

This element is part of a list key.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

aa-sub
Synopsis Enter the aa-sub context
Context perform application-assurance group reference partition reference aa-sub
Treeaa-sub

Description

Commands in this context perform group AA subscriber operations.

Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

esm
Synopsis Perform AA operations on an ESM subscriber
Contextperform application-assurance group reference partition reference aa-sub esm
Treeesm
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

esm-mac
Synopsis Perform AA actions on an ESM-MAC subscriber
Contextperform application-assurance group reference partition reference aa-sub esm-mac
Treeesm-mac
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

sap
Synopsis Perform AA actions on a SAP
Context perform application-assurance group reference partition reference aa-sub sap
Treesap
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

spoke-sdp
Synopsis Perform AA actions on a spoke SDP
Context perform application-assurance group reference partition reference aa-sub spoke-sdp
Treespoke-sdp
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

transit
Synopsis Perform AA actions on a transit subscriber
Contextperform application-assurance group reference partition reference aa-sub transit
Treetransit
Introduced24.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

filter

Synopsis Enter the filter context
Context perform filter
Treefilter
Introduced23.7.R1

Platforms

All

ip-filter [filter-name] reference
Synopsis Enter the ip-filter list instance
Contextperform filter ip-filter reference
Treeip-filter
Introduced23.7.R1

Platforms

All

[filter-name] reference
Synopsis Name to associate with the IP filter
Context perform filter ip-filter reference
Treeip-filter

Reference

state filter ip-filter filter-name

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

entry [entry-id] reference
Synopsis Enter the entry list instance
Context perform filter ip-filter reference entry reference
Treeentry
Introduced23.7.R1

Platforms

All

[entry-id] reference
Synopsis ID for the IP filter entry
Context perform filter ip-filter reference entry reference
Treeentry

Reference

state filter ip-filter entry entry-id

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

activate-primary-action
Synopsis Switch from the secondary to the primary action
Contextperform filter ip-filter reference entry reference activate-primary-action
Treeactivate-primary-action

Description

This command activates the primary action for the specified filter policy entry. If the primary action is already active, the command has no effect. If a secondary action is active, the primary action is activated unless the primary target is down. If the configure filter redirect sticky-dest command is configured, the timer expires.

Introduced23.7.R1

Platforms

All

ipv6-filter [filter-name] reference
Synopsis Enter the ipv6-filter list instance
Contextperform filter ipv6-filter reference
Treeipv6-filter
Introduced23.7.R1

Platforms

All

[filter-name] reference
Synopsis Name to associate with the IPv6 filter
Contextperform filter ipv6-filter reference
Treeipv6-filter

Reference

state filter ipv6-filter filter-name

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

entry [entry-id] reference
Synopsis Enter the entry list instance
Context perform filter ipv6-filter reference entry reference
Treeentry
Introduced23.7.R1

Platforms

All

[entry-id] reference
Synopsis ID for the IPv6 filter entry
Context perform filter ipv6-filter reference entry reference
Treeentry

Reference

state filter ipv6-filter entry entry-id

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

activate-primary-action
Synopsis Switch from the secondary to the primary action
Contextperform filter ipv6-filter reference entry reference activate-primary-action
Treeactivate-primary-action

Description

This command activates the primary action for the specified filter policy entry. If the primary action is already active, the command has no effect. If a secondary action is active, the primary action is activated unless the primary target is down. If the configure filter redirect sticky-dest command is configured, the timer expires.

Introduced23.7.R1

Platforms

All

mac-filter [filter-name] reference
Synopsis Enter the mac-filter list instance
Contextperform filter mac-filter reference
Treemac-filter
Introduced23.7.R1

Platforms

All

[filter-name] reference
Synopsis Name to associate with the MAC filter
Contextperform filter mac-filter reference
Treemac-filter

Reference

state filter mac-filter filter-name

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

entry [entry-id] reference
Synopsis Enter the entry list instance
Context perform filter mac-filter reference entry reference
Treeentry
Introduced23.7.R1

Platforms

All

[entry-id] reference
Synopsis ID for the MAC filter entry
Context perform filter mac-filter reference entry reference
Treeentry

Reference

state filter mac-filter entry entry-id

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

activate-primary-action
Synopsis Switch from the secondary to the primary action
Contextperform filter mac-filter reference entry reference activate-primary-action
Treeactivate-primary-action

Description

This command activates the primary action for the specified filter policy entry. If the primary action is already active, the command has no effect. If a secondary action is active, the primary action is activated unless the primary target is down. If the configure filter redirect sticky-dest command is configured, the timer expires.

Introduced23.7.R1

Platforms

All

redirect-policy [redirect-policy-name] reference
Synopsis Enter the redirect-policy list instance
Contextperform filter redirect-policy reference
Treeredirect-policy
Introduced23.7.R1

Platforms

All

[redirect-policy-name] reference
Synopsis Name of the redirect policy
Context perform filter redirect-policy reference
Treeredirect-policy

Reference

state filter redirect-policy redirect-policy-name

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

activate-best-dest
Synopsis Activate the current best destination
Contextperform filter redirect-policy reference activate-best-dest
Treeactivate-best-dest

Description

This command forces a PBR switch to the best destination selected by the redirect policy when that destination is not currently active as result of sticky destination functionality being enabled for the specified redirect policy. If the configure filter redirect sticky-dest command is configured, the timer expires.

Introduced23.7.R1

Platforms

All

lag

Synopsis Perform LAG operations
Context perform lag
Treelag
Introduced23.7.R1

Platforms

All

clear-force
Synopsis Perform LAG clear-force operation
Context perform lag clear-force
Treeclear-force
Introduced23.7.R1

Platforms

All

multi-chassis
Synopsis Enter the multi-chassis context
Contextperform lag clear-force multi-chassis
Treemulti-chassis
Introduced23.7.R1

Platforms

All

force-active
Synopsis Perform LAG force-active operation
Context perform lag force-active
Treeforce-active
Introduced23.7.R1

Platforms

All

multi-chassis
Synopsis Enter the multi-chassis context
Contextperform lag force-active multi-chassis
Treemulti-chassis
Introduced23.7.R1

Platforms

All

force-standby
Synopsis Perform LAG force-standby operation
Context perform lag force-standby
Treeforce-standby
Introduced23.7.R1

Platforms

All

lag
Synopsis Perform LAG operation on the specified LAG
Contextperform lag force-standby lag
Treelag
Introduced23.7.R1

Platforms

All

multi-chassis
Synopsis Enter the multi-chassis context
Contextperform lag force-standby multi-chassis
Treemulti-chassis
Introduced23.7.R1

Platforms

All

python

Synopsis Enter the python context
Context perform python
Treepython
Introduced23.10.R1

Platforms

All

python-policy
Synopsis Enter the python-policy context
Context perform python python-policy
Treepython-policy
Introduced23.10.R1

Platforms

All

cache
Synopsis Enter the cache context
Context perform python python-policy cache
Treecache

Description

Commands in this context operate on python cache entries.

Introduced23.10.R1

Platforms

All

policy
Synopsis Set the lifetime of a specified python cache entry
Contextperform python python-policy cache policy
Treepolicy
Introduced23.10.R1

Platforms

All

hex-key hex-string
Synopsis Policy key in hexadecimal format
Context perform python python-policy cache policy hex-key hex-string
Treehex-key
String length3 to 1026

Notes

The following elements are part of a mandatory choice: hex-key or string-key.

Introduced23.10.R1

Platforms

All

python-script
Synopsis Enter the python-script context
Contextperform python python-script
Treepython-script
Introduced23.10.R1

Platforms

All

protect
Synopsis Convert a Python file into a protected SRPY format
Contextperform python python-script protect
Treeprotect

Description

When invoked, the system converts a normal (unprotected) Python script file into a protected SRPY format using a specified key.

For more information about the SRPY format and protected scripts, see "Python script protection" in the 7450 ESS, 7750 SR, and VSR Triple Play Service Delivery Architecture Guide.

Introduced23.10.R1

Platforms

All

reload
Synopsis Enter the reload context
Context perform python python-script reload
Treereload

Description

Commands in this context reload and recompile the primary, secondary, and tertiary scripts in the specified Python scripts, in that order. The system uses the first script that comes up.

Executing these commands may update the last modified time for the system configuration.

Introduced23.10.R1

Platforms

All

router [router-instance] string

Synopsis Enter the router list instance
Contextperform router string
Treerouter
Introduced23.10.R1

Platforms

All

[router-instance] string
Synopsis Router name or VPRN service name
Context perform router string
Treerouter
MD-CLI defaultBase

Notes

This element is part of a list key.

Introduced23.10.R1

Platforms

All

isis [isis-instance] reference
Synopsis Enter the isis list instance
Context perform router string isis reference
Treeisis
Introduced23.10.R1

Platforms

All

[isis-instance] reference
Synopsis IS-IS instance
Contextperform router string isis reference
Treeisis
MD-CLI default0

Reference

state router isis isis-instance

Notes

This element is part of a list key.

Introduced23.10.R1

Platforms

All

overload
Synopsis Perform IS-IS overload
Context perform router string isis reference overload
Treeoverload
Introduced23.10.R1

Platforms

All

mcast-umh-red
Synopsis Display Upstream Multi-Homing info
Context perform router string mcast-umh-red
Treemcast-umh-red
Introduced24.7.R1

Platforms

All

show
Synopsis Enter the show context
Context perform router string mcast-umh-red show
Treeshow
Introduced24.7.R1

Platforms

All

pair
Synopsis Enter the pair context
Context perform router string mcast-umh-red show pair
Treepair
Introduced24.7.R1

Platforms

All

card number
Synopsis slot number
Contextperform router string mcast-umh-red show pair card number
Treecard
Max. range0 to 4294967295

Notes

The following elements are part of a choice: card, pair-id, or summary.

Introduced24.7.R1

Platforms

All

pim
Synopsis Enter the pim context
Context perform router string pim
Treepim

Description

Commands in this context enable tools to perform PIM tasks.

Introduced24.7.R1

Platforms

All

mc-ecmp-rebalance
Synopsis Perform multicast ECMP rebalance
Context perform router string pim mc-ecmp-rebalance
Treemc-ecmp-rebalance
Introduced24.7.R1

Platforms

All

threshold number
Synopsis ECMP preference level threshold
Context perform router string pim mc-ecmp-rebalance threshold number
Treethreshold

Description

This command configures a threshold level to force a rebalance of all multicast streams with a priority of less than or equal to the specified value. Selecting the highest value forces the rebalance of all multicast streams.

Range1 to 7
Introduced24.7.R1

Platforms

All

system

Synopsis Enter the system context
Context perform system
Treesystem
Introduced23.7.R1

Platforms

All

script-control
Synopsis Enter the script-control context
Contextperform system script-control
Treescript-control
Introduced23.10.R1

Platforms

All

script-policy
Synopsis Enter the script-policy context
Contextperform system script-control script-policy
Treescript-policy
Introduced23.10.R1

Platforms

All

stop
Synopsis Stop the execution of scripts
Context perform system script-control script-policy stop
Treestop
Introduced23.10.R1

Platforms

All

all
Synopsis Stop script execution for all script policies
Contextperform system script-control script-policy stop all
Treeall

Notes

The following elements are part of a mandatory choice: all or (owner and policy-name).

Introduced23.10.R1

Platforms

All

owner reference
Synopsis Stop script execution for a specific owner
Contextperform system script-control script-policy stop owner reference
Treeowner
DefaultTiMOS CLI

Reference

state system script-control script-policy owner

Notes

The following elements are part of a mandatory choice: all or (owner and policy-name).

Introduced23.10.R1

Platforms

All

policy-name reference
Synopsis Stop script execution for a specific policy
Contextperform system script-control script-policy stop policy-name reference
Treepolicy-name

Reference

state system script-control script-policy policy-name

Notes

The following elements are part of a mandatory choice: all or (owner and policy-name).

Introduced23.10.R1

Platforms

All

security
Synopsis Enter the security context
Context perform system security
Treesecurity
Introduced23.7.R1

Platforms

7750 SR-1 (FP5), 7750 SR-s, 7950 XRS-20e

secure-boot
Synopsis Enter the secure-boot context
Context perform system security secure-boot
Treesecure-boot
Introduced23.7.R1

Platforms

7750 SR-1 (FP5), 7750 SR-s, 7950 XRS-20e

show
Synopsis Enter the show context
Context perform system security secure-boot show
Treeshow
Introduced23.7.R1

Platforms

7750 SR-1 (FP5), 7750 SR-s, 7950 XRS-20e

ssh
Synopsis Perform SSH operations
Context perform system ssh
Treessh
Introduced24.3.R3

Platforms

All

generate-keypair
Synopsis Generate SSH authentication key pair
Context perform system ssh generate-keypair
Treegenerate-keypair
Introduced24.3.R3

Platforms

All

ecdsa-curve keyword
Synopsis The elliptic curve of the ECDSA key to be generated
Contextperform system ssh generate-keypair ecdsa-curve keyword
Treeecdsa-curve
Optionssecp256r1, secp384r1, secp521r1
Defaultsecp256r1

Notes

The following elements are part of a mandatory choice: ecdsa-curve, ed25519, or rsa-key-size.

Introduced24.3.R3

Platforms

All

ed25519
Synopsis Specify the generation of an ed25519 key
Contextperform system ssh generate-keypair ed25519
Treeed25519

Notes

The following elements are part of a mandatory choice: ecdsa-curve, ed25519, or rsa-key-size.

Introduced24.3.R3

Platforms

All

rsa-key-size number
Synopsis The length in bits of the RSA key to be generated
Contextperform system ssh generate-keypair rsa-key-size number
Treersa-key-size
Range2048 to 4096
Default3072

Notes

The following elements are part of a mandatory choice: ecdsa-curve, ed25519, or rsa-key-size.

Introduced24.3.R3

Platforms

All