Configuration mode commands

See “Editing configuration” in the 7450 ESS, 7750 SR, 7950 XRS, and VSR MD-CLI User Guide for more information.

   —  annotate comment-text-type
      —  [cli-path] cli-path-type
   —  commit 
      —  comment string
      —  confirmed 
         —  accept 
         —  cancel 
         —  comment string
         —  persist-id string
         —  [timeout] number
   —  compare string [to] string
      —  [cli-path] cli-path-type
      —  flat 
      —  full-context 
      —  lines number
      —  netconf-rpc 
      —  summary 
   —  copy 
      —  [cli-path] cli-path-type
      —  to cli-path-type
   —  discard 
      —  [cli-path] cli-path-type
   —  insert instance-id
      —  after 
         —  [cli-path] instance-id
      —  before 
         —  [cli-path] instance-id
      —  beginning 
      —  end 
   —  load keyword
      —  encryption-key string
      —  interactive 
      —  [url] string
   —  rename 
      —  [cli-path] cli-path-type
      —  to cli-path-type
   —  replace string with string
      —  [cli-path] cli-path-type
      —  continue-on-error 
      —  depth number
      —  ignore-case 
   —  rollback 
      —  commit-id number
      —  [rollback-id] (keyword | number)
   —  update 
      —  /configure 
      —  /bof 
      —  check 
      —  /debug 
      —  /li 
   —  validate

Configuration mode command descriptions

annotate [comment-text] comment-text-type

Synopsis Annotate a configuration element with a comment
Contextannotate comment-text-type
Treeannotate
Introduced21.5.R1

Platforms

All

[comment-text] comment-text-type

Synopsis Comment for the configuration element
Contextannotate comment-text-type
Treeannotate
String length0 to 2048

Notes

This element is part of a list key.

Introduced21.5.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Absolute path or relative path from pwc, or 'pwc'
Contextannotate comment-text-type [cli-path] cli-path-type
Tree[cli-path]

Notes

This element is mandatory.

Introduced21.5.R1

Platforms

All

commit

Synopsis Commit the candidate configuration
Context commit
Tree commit
Introduced16.0.R1

Platforms

All

comment string

Synopsis Comment associated with the commit
Context commit comment string
Treecomment
String length1 to 2048
Introduced21.10.R1

Platforms

All

confirmed

Synopsis Enter the confirmed context
Context commit confirmed
Treeconfirmed
Introduced16.0.R1

Platforms

All

accept
Synopsis Accept commit confirmed and cancel automatic rollback
Contextcommit confirmed accept
Treeaccept

Notes

The following elements are part of a choice: accept, cancel, or (comment and timeout).

Introduced16.0.R1

Platforms

All

cancel
Synopsis Cancel commit confirmed and roll back changes
Contextcommit confirmed cancel
Treecancel

Description

When specified, the router rolls back the configuration and returns the changes to the candidate.

Notes

The following elements are part of a choice: accept, cancel, or (comment and timeout).

Introduced16.0.R1

Platforms

All

comment string
Synopsis Comment associated with the commit
Context commit confirmed comment string
Treecomment
String length1 to 2048

Notes

The following elements are part of a choice: accept, cancel, or (comment and timeout).

Introduced21.10.R1

Platforms

All

[timeout] number
Synopsis Confirmed commit expiration timeout interval
Contextcommit confirmed [timeout] number
Tree[timeout]
Range1 to 65535
Unitsminutes
Default 10

Notes

The following elements are part of a choice: accept, cancel, or (comment and timeout).

Introduced16.0.R1

Platforms

All

compare [from] string to string

Synopsis Compare changes between datastores
Context compare string [to] string
Treecompare
Introduced16.0.R1

Platforms

All

[from] string

Synopsis Source configuration from which to compare
Contextcompare string [to] string
Treecompare
MD-CLI defaultbaseline

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

[to] string

Synopsis Configuration to compare against source configuration
Contextcompare string [to] string
Treecompare
MD-CLI defaultcandidate

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Absolute path or relative path from pwc
Contextcompare string [to] string [cli-path] cli-path-type
Tree[cli-path]
Introduced20.10.R1

Platforms

All

flat

Synopsis Show the context from the pwc on each line
Contextcompare string [to] string flat
Treeflat

Description

This option shows the hierarchy on each line starting from the present working context.

Notes

The following elements are part of a choice: flat or netconf-rpc.

Introduced16.0.R1

Platforms

All

lines number

Synopsis Number of lines of context to display before and after
Contextcompare string [to] string lines number
Treelines

Description

This command specifies the number of lines of context to display before and after changed elements. The context is evaluated separately at each container. If the parameter value is larger than the available context, the maximum available context up to the container boundary is displayed.

Max. range0 to 4294967295
Default0
Introduced 16.0.R1

Platforms

All

netconf-rpc

Synopsis Display changes in NETCONF <edit-config> RPC format
Contextcompare string [to] string netconf-rpc
Treenetconf-rpc

Description

This option specifies the display of changes in NETCONF <edit-config> RPC format.

This option is only supported with the summary option.

Notes

The following elements are part of a choice: flat or netconf-rpc.

Introduced21.5.R1

Platforms

All

summary

Synopsis Suppress specific differences and display a summary
Contextcompare string [to] string summary
Treesummary

Description

This command allows the suppression of specific differences and displays a summarized comparison. The summarized differences in elements under the highest level container that was deleted is displayed with { ... }. A tilde (~) character is displayed to indicate the new value of an element that has changed.

Introduced16.0.R1

Platforms

All

copy

Synopsis Copy a configuration element to another
Contextcopy
Treecopy
Introduced20.10.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Absolute path or relative path from pwc, or 'pwc'
Contextcopy [cli-path] cli-path-type
Tree[cli-path]
Introduced20.10.R1

Platforms

All

to cli-path-type

Synopsis Destination path, or 'pwc'
Context copy to cli-path-type
Treeto
Introduced20.10.R1

Platforms

All

discard

Synopsis Discard changes in the candidate configuration
Contextdiscard
Treediscard
Introduced16.0.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Absolute path or relative path from pwc
Contextdiscard [cli-path] cli-path-type
Tree[cli-path]
Introduced20.10.R1

Platforms

All

insert [new-entry] instance-id

Synopsis Insert an element into a user-ordered list
Contextinsert instance-id
Treeinsert
Introduced19.10.R1

Platforms

All

[new-entry] instance-id

Synopsis Identification of the new entry
Context insert instance-id
Treeinsert

Notes

This element is part of a list key.

Introduced19.10.R1

Platforms

All

after

Synopsis Insert an entry after the specified entry
Contextinsert instance-id after
Treeafter

Notes

The following elements are part of a choice: after, before, beginning, or end.

Introduced19.10.R1

Platforms

All

[cli-path] instance-id
Synopsis Absolute path or relative path from pwc
Contextinsert instance-id after [cli-path] instance-id
Tree[cli-path]
Introduced19.10.R1

Platforms

All

before

Synopsis Insert an entry before the specified entry
Contextinsert instance-id before
Treebefore

Notes

The following elements are part of a choice: after, before, beginning, or end.

Introduced19.10.R1

Platforms

All

[cli-path] instance-id
Synopsis Absolute path or relative path from pwc
Contextinsert instance-id before [cli-path] instance-id
Tree[cli-path]
Introduced19.10.R1

Platforms

All

beginning

Synopsis Insert the new entry at the beginning of the list
Contextinsert instance-id beginning
Treebeginning

Notes

The following elements are part of a choice: after, before, beginning, or end.

Introduced19.10.R1

Platforms

All

end

Synopsis Insert the new entry at the end of the list
Contextinsert instance-id end
Treeend

Notes

The following elements are part of a choice: after, before, beginning, or end.

Introduced19.10.R1

Platforms

All

load [mode] keyword

Synopsis Load configuration into the candidate configuration
Contextload keyword
Treeload
Introduced16.0.R1

Platforms

All

[mode] keyword

Synopsis Load mode
Contextload keyword
Treeload
Options

merge – Merge with the candidate configuration

full-replace – Replace the candidate configuration

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

encryption-key string

Synopsis Encryption key of the file to be loaded
Contextload keyword encryption-key string
Treeencryption-key
String length8 to 32

Notes

The following elements are part of a mandatory choice: interactive or (encryption-key and url).

Introduced21.7.R1

Platforms

All

interactive

Synopsis Load the configuration interactively
Context load keyword interactive
Treeinteractive

Description

This command allows the user to enter configuration commands directly in an interactive session.

This command is available with the merge option of the load command.

See "Loading configuration interactively" in the 7450 ESS, 7750 SR, 7950 XRS, and VSR MD-CLI User Guide for more information.

Notes

The following elements are part of a mandatory choice: interactive or (encryption-key and url).

Introduced22.10.R1

Platforms

All

[url] string

Synopsis Location of the file to be loaded
Context load keyword [url] string
Tree[url]
String length1 to 255

Notes

The following elements are part of a mandatory choice: interactive or (encryption-key and url).

Introduced16.0.R1

Platforms

All

rename

Synopsis Rename a list element
Context rename
Tree rename
Introduced20.10.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Source element path to the list, or 'pwc'
Contextrename [cli-path] cli-path-type
Tree[cli-path]
Introduced20.10.R1

Platforms

All

to cli-path-type

Synopsis Destination key name
Context rename to cli-path-type
Treeto
Introduced20.10.R1

Platforms

All

replace [pattern] string with string

Synopsis Match and replace values in the candidate configuration
Contextreplace string with string
Treereplace
Introduced23.7.R1

Platforms

All

[pattern] string

Synopsis String (") or regular expression (') pattern to match
Contextreplace string with string
Treereplace

Description

This command configures a text string or regular expression that defines the values to match.

String length1 to 255

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

with string

Synopsis String (") or regular expression (') pattern to replace
Contextreplace string with string
Treereplace
String length0 to 255

Notes

This element is part of a list key.

Introduced23.7.R1

Platforms

All

[cli-path] cli-path-type

Synopsis Absolute path or relative path from pwc
Contextreplace string with string [cli-path] cli-path-type
Tree[cli-path]
Introduced23.7.R1

Platforms

All

depth number

Synopsis Replace operation depth from the pwc
Context replace string with string depth number
Treedepth
Range1 to 4294967040
Introduced23.7.R1

Platforms

All

rollback

Synopsis Roll back to a previous configuration
Contextrollback
Treerollback
Introduced16.0.R1

Platforms

All

commit-id number

Synopsis Commit ID to roll back to
Context rollback commit-id number
Treecommit-id
Range1 to 4294967295

Notes

The following elements are part of a choice: commit-id or rollback-id.

Introduced23.3.R1

Platforms

All

[rollback-id] (keyword | number)

Synopsis Previous configuration to roll back to
Contextrollback [rollback-id] (keyword | number)
Tree[rollback-id]
Range0 to 200
Options

startup – Configuration loaded when the system boots

Notes

The following elements are part of a choice: commit-id or rollback-id.

Introduced23.3.R1

Platforms

All

update

Synopsis Update the candidate baseline
Context update
Tree update
Introduced16.0.R4

Platforms

All

/bof

Synopsis Update the entire BOF candidate
Context update /bof
Tree/bof
Introduced20.10.R1

Platforms

All

check

Synopsis Perform dry-run update report without an actual update
Contextupdate check
Treecheck
Introduced16.0.R4

Platforms

All

/debug

Synopsis Update the entire debug candidate
Context update /debug
Tree/debug
Introduced21.5.R1

Platforms

All

/li

Synopsis Update the entire LI candidate
Context update /li
Tree/li
Introduced19.10.R1

Platforms

All

validate

Synopsis Validate changes in the candidate configuration
Contextvalidate
Treevalidate
Introduced16.0.R1

Platforms

All