[Contents] [Prev] [Next] [Index] [Report an Error]

Setting the Edit Configuration Mode

When sending operation data to the NETCONF server, you have the option to specify how a router should handle these configuration changes. This is known as the edit configuration mode. You can set the edit configuration mode globally for the entire session. You can also set the edit mode only for specific elements within the session.

To set the mode globally for the session, place a configuration mode value within <default-operation> tags:



<rpc>
  <edit-config>
    <default-operation>ConfigModeValue</default-operation>
  <edit-config>
</rpc>

You can also set the mode for a specific configuration statement by adding an operational attribute with a value of replace to the configuration element:



<rpc>
  <edit-config>
    <config>
      <configuration>
        <protocols>
          <rip>
            <message-size operation=”replace”>255</message-size>
          </rip>
        </protocols>
      </configuration>
    </config>
  </edit-config>
</rpc>

You can set a global edit configuration mode for an entire set of configuration changes and specify a different mode for individual elements that you want handled in a different manner. For example:



<rpc>
  <edit-config>
    <default-operation>merge</default-mode>
    <config>
      <configuration>
        <protocols>
          <rip>
            <message-size operation=”replace”>255</message-size>
          </rip>
        </protocols>
      </configuration>
    </config>
  </edit-config>
</rpc>

The router has the following edit configuration modes:

merge—The router merges new configuration data into the current candidate configuration. This is the default.
replace—The router replaces existing configuration data with the new configuration data.
no-change—The router does not change the existing configuration unless the new configuration element includes an operation attribute.

[Contents] [Prev] [Next] [Index] [Report an Error]