Configuration mode commands

See “Editing configuration” in the 7705 SAR Gen 2 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
	Context	annotate comment-text-type
	Tree	annotate
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[comment-text] comment-text-type


	Synopsis	Comment for the configuration element
	Context	annotate comment-text-type
	Tree	annotate
	String length	0 to 2048
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Absolute path or relative path from pwc, or 'pwc'
	Context	annotate comment-text-type [cli-path] cli-path-type
	Tree	[cli-path]
	Notes	This element is mandatory.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

commit


	Synopsis	Commit the candidate configuration
	Context	commit
	Tree	commit
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

comment string


	Synopsis	Comment associated with the commit
	Context	commit comment string
	Tree	comment
	String length	1 to 2048
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

confirmed


	Synopsis	Enter the confirmed context
	Context	commit confirmed
	Tree	confirmed
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

accept


	Synopsis	Accept commit confirmed and cancel automatic rollback
	Context	commit confirmed accept
	Tree	accept
	Notes	The following elements are part of a choice: accept, cancel, or (comment and timeout).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

cancel


	Synopsis	Cancel commit confirmed and roll back changes
	Context	commit confirmed cancel
	Tree	cancel
	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).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

comment string


	Synopsis	Comment associated with the commit
	Context	commit confirmed comment string
	Tree	comment
	String length	1 to 2048
	Notes	The following elements are part of a choice: accept, cancel, or (comment and timeout).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

persist-id string


	Synopsis	Persistent confirmed commit ID
	Context	commit confirmed persist-id string
	Tree	persist-id
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[timeout] number


	Synopsis	Confirmed commit expiration timeout interval
	Context	commit confirmed [timeout] number
	Tree	[timeout]
	Range	1 to 65535
	Units	minutes
	Default	10
	Notes	The following elements are part of a choice: accept, cancel, or (comment and timeout).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

compare [from] string to string


	Synopsis	Compare changes between datastores
	Context	compare string [to] string
	Tree	compare
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[from] string


	Synopsis	Source configuration from which to compare
	Context	compare string [to] string
	Tree	compare
	MD-CLI default	baseline
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[to] string


	Synopsis	Configuration to compare against source configuration
	Context	compare string [to] string
	Tree	compare
	MD-CLI default	candidate
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Absolute path or relative path from pwc
	Context	compare string [to] string [cli-path] cli-path-type
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

flat


	Synopsis	Show the context from the pwc on each line
	Context	compare string [to] string flat
	Tree	flat
	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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

full-context


	Synopsis	Show the full context on each line
	Context	compare string [to] string full-context
	Tree	full-context
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

lines number


	Synopsis	Number of lines of context to display before and after
	Context	compare string [to] string lines number
	Tree	lines
	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. range	0 to 4294967295
	Default	0
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

netconf-rpc


	Synopsis	Display changes in NETCONF <edit-config> RPC format
	Context	compare string [to] string netconf-rpc
	Tree	netconf-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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

summary


	Synopsis	Suppress specific differences and display a summary
	Context	compare string [to] string summary
	Tree	summary
	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.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

copy


	Synopsis	Copy a configuration element to another
	Context	copy
	Tree	copy
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Absolute path or relative path from pwc, or 'pwc'
	Context	copy [cli-path] cli-path-type
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

to cli-path-type


	Synopsis	Destination path, or 'pwc'
	Context	copy to cli-path-type
	Tree	to
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

discard


	Synopsis	Discard changes in the candidate configuration
	Context	discard
	Tree	discard
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Absolute path or relative path from pwc
	Context	discard [cli-path] cli-path-type
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

insert [new-entry] instance-id


	Synopsis	Insert an element into a user-ordered list
	Context	insert instance-id
	Tree	insert
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[new-entry] instance-id


	Synopsis	Identification of the new entry
	Context	insert instance-id
	Tree	insert
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

after


	Synopsis	Insert an entry after the specified entry
	Context	insert instance-id after
	Tree	after
	Notes	The following elements are part of a choice: after, before, beginning, or end.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] instance-id


	Synopsis	Absolute path or relative path from pwc
	Context	insert instance-id after [cli-path] instance-id
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

before


	Synopsis	Insert an entry before the specified entry
	Context	insert instance-id before
	Tree	before
	Notes	The following elements are part of a choice: after, before, beginning, or end.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] instance-id


	Synopsis	Absolute path or relative path from pwc
	Context	insert instance-id before [cli-path] instance-id
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

beginning


	Synopsis	Insert the new entry at the beginning of the list
	Context	insert instance-id beginning
	Tree	beginning
	Notes	The following elements are part of a choice: after, before, beginning, or end.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

end


	Synopsis	Insert the new entry at the end of the list
	Context	insert instance-id end
	Tree	end
	Notes	The following elements are part of a choice: after, before, beginning, or end.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

load [mode] keyword


	Synopsis	Load configuration into the candidate configuration
	Context	load keyword
	Tree	load
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[mode] keyword


	Synopsis	Load mode
	Context	load keyword
	Tree	load
	Options	merge – Merge with the candidate configuration full-replace – Replace the candidate configuration
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

encryption-key string


	Synopsis	Encryption key of the file to be loaded
	Context	load keyword encryption-key string
	Tree	encryption-key
	String length	8 to 32
	Notes	The following elements are part of a mandatory choice: interactive or (encryption-key and url).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

interactive


	Synopsis	Load the configuration interactively
	Context	load keyword interactive
	Tree	interactive
	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 7705 SAR Gen 2 MD-CLI User Guide for more information.
	Notes	The following elements are part of a mandatory choice: interactive or (encryption-key and url).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[url] string


	Synopsis	Location of the file to be loaded
	Context	load keyword [url] string
	Tree	[url]
	String length	1 to 255
	Notes	The following elements are part of a mandatory choice: interactive or (encryption-key and url).
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

rename


	Synopsis	Rename a list element
	Context	rename
	Tree	rename
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Source element path to the list, or 'pwc'
	Context	rename [cli-path] cli-path-type
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

to cli-path-type


	Synopsis	Destination key name
	Context	rename to cli-path-type
	Tree	to
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

replace [pattern] string with string


	Synopsis	Match and replace values in the candidate configuration
	Context	replace string with string
	Tree	replace
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[pattern] string


	Synopsis	String (") or regular expression (') pattern to match
	Context	replace string with string
	Tree	replace
	Description	This command configures a text string or regular expression that defines the values to match.
	String length	1 to 255
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

with string


	Synopsis	String (") or regular expression (') pattern to replace
	Context	replace string with string
	Tree	replace
	String length	0 to 255
	Notes	This element is part of a list key.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[cli-path] cli-path-type


	Synopsis	Absolute path or relative path from pwc
	Context	replace string with string [cli-path] cli-path-type
	Tree	[cli-path]
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

continue-on-error


	Synopsis	Continue the replace operation upon errors
	Context	replace string with string continue-on-error
	Tree	continue-on-error
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

depth number


	Synopsis	Replace operation depth from the pwc
	Context	replace string with string depth number
	Tree	depth
	Range	1 to 4294967040
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

ignore-case


	Synopsis	Ignore case in pattern match
	Context	replace string with string ignore-case
	Tree	ignore-case
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

rollback


	Synopsis	Roll back to a previous configuration
	Context	rollback
	Tree	rollback
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

commit-id number


	Synopsis	Commit ID to roll back to
	Context	rollback commit-id number
	Tree	commit-id
	Range	1 to 4294967295
	Notes	The following elements are part of a choice: commit-id or rollback-id.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

[rollback-id] (keyword | number)


	Synopsis	Previous configuration to roll back to
	Context	rollback [rollback-id] (keyword \| number)
	Tree	[rollback-id]
	Range	0 to 200
	Options	startup – Configuration loaded when the system boots
	Notes	The following elements are part of a choice: commit-id or rollback-id.
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

update


	Synopsis	Update the candidate baseline
	Context	update
	Tree	update
	Platforms	7705 SAR Gen 2

/configure


	Synopsis	Update the entire candidate
	Context	update /configure
	Tree	/configure
	Platforms	7705 SAR Gen 2

/bof


	Synopsis	Update the entire BOF candidate
	Context	update /bof
	Tree	/bof
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

check


	Synopsis	Perform dry-run update report without an actual update
	Context	update check
	Tree	check
	Platforms	7705 SAR Gen 2

/debug


	Synopsis	Update the entire debug candidate
	Context	update /debug
	Tree	/debug
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2

/li


	Synopsis	Update the entire LI candidate
	Context	update /li
	Tree	/li
	Platforms	7705 SAR Gen 2

validate


	Synopsis	Validate changes in the candidate configuration
	Context	validate
	Tree	validate
	Introduced	25.3.R2
	Platforms	7705 SAR Gen 2