{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b93077f9-b4a2-4945-8ef8-ddd75ae44323"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"commit - commit the current set of changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"commit [ comment ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to apply and save uncommitted changes to the configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"When you add configuration to, modify the existing configuration, or delete configuration from the system, the changes you make must be committed before they take effect. To commit changes, use the ","type":"text"},{"text":"commit","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you try to exit or quit configuration mode while uncommitted configuration changes still exist, the system gives you a warning. You cannot exit configuration mode until you either commit the changes by entering the ","type":"text"},{"text":"commit","type":"text","marks":[{"type":"code"}]},{"text":" command or discard the changes by using the ","type":"text"},{"text":"discard","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Until a configuration change is committed, the system marks the change when displaying the information.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If your login username is not a member of the \"secrets\" login user group and you either save a configuration through the REST API or use the save command, the encrypted passwords in the configuration file are replaced with the ******** placeholder. If you load this configuration, the replaced password fields trigger validation errors because the placeholder does not match the format for an encrypted password. Do not commit this configuration. If you ignore the error message and perform a commit with this invalid configuration, the passwords are deleted.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"commit comment ","type":"text","marks":[{"type":"code"}]},{"text":" to add a comment that describes the reason for the commit and seen in the output from ","type":"text"},{"text":"show system commit","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"commit-confirm - commit the current set of changes; rollback if not confirmed","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"commit-confirm [ comment ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to set the system to require confirmation of a configuration commit.","type":"text"}]},{"type":"paragraph","content":[{"text":"This operation is useful when making configuration changes over a remote connection that could cause you to be unable to reconnect to the system, for example, accidentally changing the IP address of the management port.","type":"text"}]},{"type":"paragraph","content":[{"text":"A reboot during the commit-confirm timeout window results in the restoration of the previous configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"After making a configuration change, enter the ","type":"text"},{"text":"commit-confirm","type":"text","marks":[{"type":"code"}]},{"text":" command, specifying the confirmation interval. Commit the change. If the commit is completed, without incident, confirm the commit by entering the command ","type":"text"},{"text":"confirm","type":"text","marks":[{"type":"code"}]},{"text":". If you do not confirm, the changes are rolled back.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the new commit-confirmed configuration causes a crash before the confirmation window expires, the system reboots and rolls back to avoid an endless cycle of rebooting.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you attempt to use the GRUB configuration recovery option when rebooting during the commit-confirm timeout window is active, a message to wait for the rollback to be completed is displayed.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you enter commit, ","type":"text"},{"text":"commit-confirm","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"rollback","type":"text","marks":[{"type":"code"}]},{"text":" commands during the commit-confirm timeout, the current commit that is pending confirmation is implicitly confirmed. For example, ","type":"text"},{"text":"rollback 1","type":"text","marks":[{"type":"code"}]},{"text":" takes you back to the immediately preceding commit (before the original commit-confirm), and ","type":"text"},{"text":"rollback 0","type":"text","marks":[{"type":"code"}]},{"text":" recommits the current configuration.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"compare - compare configuration revisions","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"compare [ rev-num1 [ rev-num2 ] ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"When used with no option, the working and active (running) configuration are compared. When only one revision number is specified, the system compares the working configuration to the specified revision. When two revisions are specified, the system compares the two specified revisions.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can see the list of configuration file revisions by using ","type":"text"},{"text":"show system commit","type":"text","marks":[{"type":"code"}]},{"text":" in operational mode (use ","type":"text"},{"text":"run show system commit","type":"text","marks":[{"type":"code"}]},{"text":" in configuration mode).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"confirm - confirm configuration changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"confirm","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to confirm a successful change in configuration after requiring commit confirmation.","type":"text"}]},{"type":"paragraph","content":[{"text":"For configuration changes that carry some risk of causing loss of access to a system, you can direct the system to require commit confirmation by using the command ","type":"text"},{"text":"commit-confirm ","type":"text","marks":[{"type":"code"}]},{"text":". This command sets the system to wait for confirmation that a configuration has succeeded.","type":"text"}]},{"type":"paragraph","content":[{"text":"Entering the confirm command within the specified commit-confirm interval causes the configuration change to be accepted. If confirmation is not provided by entering this command, the system reboots to the previous configuration.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"delete - delete a configuration element","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"delete ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to delete a part of configuration. To do this, you delete the appropriate subnode of a configuration node.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you show configuration before it is committed, you see the deleted statement flagged with a minus sign (-); the statement disappears after the configuration change is committed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some configuration nodes and statements are mandatory; these nodes or statements cannot be deleted. Some configuration statements are mandatory but have default values; if you delete one of these statements, the default value is restored.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"discard - discard uncommitted changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"discard","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to discard all uncommitted changes to the configuration.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"edit - edit a sub-element","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax; ","type":"text"},{"text":"edit ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to navigate to a specific configuration subnode for editing. The [edit] prompt changes dynamically to mark your place in the configuration tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"Once at that location, any actions you take such as showing, creating, or deleting configuration are relative to your location in the tree.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"exit - exit from configuration level","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"exit [ discard ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command from a subnode in the configuration tree to navigate to the top of the configuration tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this command from the top of the configuration tree to exit from configuration mode to operational mode.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you try to exit from configuration mode while there are still uncommitted configuration changes, the system gives you a warning. You cannot exit from configuration mode until you either commit the changes by entering the ","type":"text"},{"text":"commit","type":"text","marks":[{"type":"code"}]},{"text":" command or discard the changes by using the ","type":"text"},{"text":"discard","type":"text","marks":[{"type":"code"}]},{"text":" option. This option applies only to this usage.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"load - load configuration from a file and replace candidate configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"load ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to load from a file a configuration that was previously saved.","type":"text"}]},{"type":"paragraph","content":[{"text":"The loaded configuration becomes the working configuration and must be committed before it becomes the active configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Configuration can be loaded from a hard disk (including a Flash disk or USB device), a TFTP server, an FTP server, an SCP server, or an HTTP server. Note that you cannot load an empty configuration file; the configuration file must contain at least one configuration node. In addition, an error is reported if an invalid configuration file is loaded.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default configuration directory is /config.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"merge - merge configuration from a file into the candidate configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"merge ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to load from a file a configuration that was previously saved and merge it with the active (running) configuration. The merger adds new configuration entries and applies any modifications to existing active entries to produce a new working configuration. This configuration must be committed before it becomes the active configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Configuration can be loaded from a hard disk (including a Flash disk or USB device), a TFTP server, an FTP server, an SCP server, or an HTTP server. Note that you cannot load an empty configuration file; the configuration file must contain at least one configuration node.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default configuration directory is /config.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"rollback - rollback to a previous configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"rollback [ comment ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to roll back to the configuration revision specified.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can see the list of configuration file revisions using the ","type":"text"},{"text":"show system commit","type":"text","marks":[{"type":"code"}]},{"text":" operational mode command (use ","type":"text"},{"text":"run show system commit","type":"text","marks":[{"type":"code"}]},{"text":" from configuration mode).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"run - run an operational-mode command","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"run","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Run one of the operational-mode commands while still in the configuration-mode.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"save - save the configuration to a file","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"save ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to save the running configuration to a file.","type":"text"}]},{"type":"paragraph","content":[{"text":"The resulting file can later be loaded into the running system to replace the previous running configuration by using the ","type":"text"},{"text":"load","type":"text","marks":[{"type":"code"}]},{"text":" command. A nonabsolute path is interpreted relative to the default configuration directory, which is /config.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If your login username is not a member of the \"secrets\" login user group and you either save a configuration through the REST API or use the save command, the encrypted passwords in the configuration file are replaced with the ******** placeholder. If you load this configuration, the replaced password fields trigger validation errors because the placeholder does not match the format for an encrypted password. Do not commit this configuration. If you ignore the error message and perform a commit with this invalid configuration, the passwords are deleted.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"set - set the value of a parameter or create a new element","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"set config-name attribute [ value ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to add a configuration element to the current configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also use this command to modify the value of an existing configuration item. When setting configuration values, note that the change does not take effect until the change is committed by using the ","type":"text"},{"text":"commit","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"},{"type":"hardBreak"},{"text":"After a configuration node has been added, you can modify it later by using ","type":"text"},{"text":"set","type":"text","marks":[{"type":"code"}]},{"text":" or delete it by using ","type":"text"},{"text":"delete","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"show - show the configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"show [ -all ] [ config-name ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command in configuration mode to display the configured state of the system.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command displays the specified configuration node and all subnodes. The node specification is interpreted relative to your current location in the configuration tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unless the ","type":"text"},{"text":"-all","type":"text","marks":[{"type":"code"}]},{"text":" keyword is used, default information is not included in the displayed information.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to this command, a number of ","type":"text"},{"text":"show","type":"text","marks":[{"type":"code"}]},{"text":" commands are available in operational mode.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, see the difference between ","type":"text"},{"text":"show interfaces","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"show -all interfaces","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"vyatta@R1# show interfaces\n interfaces {\n dataplane dp0p1s1 {\n address 10.10.1.1/24\n }\n dataplane dp0s2 {\n address dhcp\n }\n loopback lo\n }\nvyatta@R1# show -all interfaces\n interfaces {\n dataplane dp0p1s1 {\n address 10.10.1.1/24\n duplex auto\n ip {\n gratuitous-arp-count 1\n rpf-check disable\n }\n ipv6 {\n dup-addr-detect-transmits 1\n }\n mtu 1500\n speed auto\n vlan-protocol 0x8100\n vrrp {\n start-delay 0\n }\n }\n dataplane dp0s2 {\n address dhcp\n duplex auto\n ip {\n gratuitous-arp-count 1\n rpf-check disable\n }\n ipv6 {\n dup-addr-detect-transmits 1\n }\n mtu 1500\n speed auto\n vlan-protocol 0x8100\n vrrp {\n start-delay 0\n }\n }\n loopback lo\n }\nvyatta@R1#","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"top - set the edit level to the root","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"top","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use this command to navigate quickly to the top level of the configuration hierarchy.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"up - set the edit level one level up","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"up","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command navigates up one level in the configuration hierarchy. For example:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"vyatta@R1# edit protocols ospfv3 timers spf\n[edit protocols ospfv3 timers spf]\nvyatta@R1# up\n[edit protocols ospfv3 timers]\nvyatta@R1# up\n[edit protocols ospfv3]\nvyatta@R1# up\n[edit protocols]\nvyatta@R1# up\n[edit]\nvyatta@R1#","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"validate - validate the current set of changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"},{"text":"validate","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Perform pre-commit checks to make sure the configuration changes are valid.","type":"text"}]}],"version":1}

Browser not supported