Siemens RUGGEDCOM MX5000RE, Reference Manual

Page: 53 / 148

RUGGEDCOM NETCONF
Reference Guide
Chapter 5
Changing Configuration Data
Changing Data in the Running Configuration 41
Changing Configuration Data
This section describes how to change configuration data and perform actions on your device through NETCONF.
You can edit configuration data in two ways:
• You can edit the running configuration directly. In this approach, any changes you make to the running
configuration take effect immediately. You do not need to use the <commit> command to apply the changes.
You cannot use the <validate> command to check the syntax of the changes before they take effect.
However, you can use the <validate> command after making the changes to confirm that they are correct.
Obviously, making changes to the running configuration is potentially risky. It is recommended that you use this
approach only after gaining experience with NETCONF and confirming that your scripts and procedures work
reliably.
• You can edit the candidate configuration and then commit the changes to the running configuration. In this
approach, you make changes to a safe workspace called the candidate configuration. After making changes,
you can use the
<validate>
command to confirm the syntax of the candidate configuration. If necessary,
you can discard the changes with the
<discard-changes>
command, allowing you to cancel the editing
process and clear any errors. After reviewing and validating the changes, you apply the changes to the running
configuration with the
<commit>
command. Editing the candidate configuration and then committing the
changes is the recommended approach for editing configuration data.
CONTENTS
• Section 5.1, “Changing Data in the Running Configuration”
• Section 5.2, “Changing Data in the Candidate Configuration”
Section 5.1
Changing Data in the Running Configuration
To edit data in the running configuration, simply specify the running configuration as the target in the edit-config
command. You do not need to commit the change with the commit command. You cannot validate the syntax of
the change with the validate command before the change takes effect. If you want to validate the change, use the
validate commands on the running configuration after making the change.
CAUTION!
Making changes directly to the running configuration is potentially risky: you may interrupt service
on the device, or your changes may conflict with those of other users working on other management
interfaces. Making changes to the running configuration should only be done by those with sufficient
system expertise and experience to make sure that such changes are performed properly.
To edit the running configuration, do the following:
1. Connect to and log in to the device.
2. Issue the
<edit-config> command: