Contents

Managing target configuration· 1

About target configuration· 1

Hardware compatibility with target configuration management 1

Enabling target configuration management 1

Committing the target configuration command lines· 2

Display and maintenance commands for target configuration· 3

Managing target configuration

About target configuration

Target configuration enables you to configure and verify intended settings before merging them into the running configuration.

You can configure target configuration command lines in the following views:

·     Private-mode system view and its lower-level views.

·     Exclusive-mode system view and its lower-level views.

Commands available for real-time configuration are all available for target configuration.

Support for command lines in private-mode system view and in exclusive-mode system view depends on the device model. In private-mode system view and in exclusive-mode system, you do not need to commit hardware-related command lines and action command lines, because they take effect immediately.

Private-mode views and exclusive-mode views have an extra tilde sign (~) in their prompts as compared to their counterpart real-time-mode views. After you execute a command that does not take effect in real time, the prompt will have a leading asterisk sign (*) to indicate that the command has not taken effect in the current mode. After the commit command is executed to commit the configuration, the prompt will have a leading tilde sign (~).

For more information about views, see "Using the CLI."

Hardware compatibility with target configuration management

Only the S5130S-HI-G and S5130S-EI-G-V2 switch series support target configuration management.

Enabling target configuration management

About this task

To save memory, you can disable target configuration management by executing the undo commit enable command. This can reduce unnecessary resource consumption and improve system efficiency.

Restrictions and guidelines

After you enable target configuration management, you cannot enter private-mode or exclusive-mode system view by executing the system-view command.

If a user already enters private-mode system view, executing the undo commit enable command will force that user to quit private-mode system view.

Procedure

1.     Enter real-time-mode system view.

system-view

2.     Enable target configuration management.

commit enable

By default, target configuration management is enabled.

Committing the target configuration command lines

About this task

A commit operation commits all target configuration command lines. After a successful commit operation, the system creates a configuration rollback point.

Restrictions and guidelines

As a best practice, do not execute the commit command frequently. The system creates a configuration rollback point after each successful commit operation. Executing the command frequently increases device load and might cause commit failures.

To save the running configuration while committing the target configuration command lines, you can use one of the following methods:

·     Specify the save-running filename option when you use the commit command to commit the target configuration command lines. The system saves the running configuration to the specified file while committing the target configuration command lines.

·     Use the configuration commit auto-save path command to enable automatic saving for the target configuration command lines. This command enables the device to automatically save the running configuration to a configuration file in the specified directory each time the commit command is executed. The directory is specified by using the directory argument. The prefix for the configuration file is specified by using the filename-prefix filename-prefix option.

The automatic saving feature takes effect if you do not specify the save-running filename option when executing the commit command. If you specify this option when executing the commit command, the automatic saving feature cannot take effect. The target configuration command lines are saved to the file specified by using this option.

Procedure

1.     (Optional.) Specify the maximum number of rollback points:

a.     Enter real-time-mode system view.

system-view

b.     Set the maximum number of rollback points.

configuration commit max-number max-number

By default, the maximum number of rollback points is 100.

To create a new rollback point when the number of rollback points reaches the maximum, the system deletes the oldest rollback point.

c.     Return to user view.

Quit

2.     (Optional.) Enable automatic saving for the target configuration command lines and configure the related parameters:

a.     Enter real-time-mode system view.

system-view

b.     Enable automatic saving for the target configuration command lines and configure the related parameters.

configuration commit auto-save path directory filename-prefix filename-prefix [ user user-name [ password { cipher | simple } string ] | vpn-instance vpn-instance-name ] *

By default, automatic saving is disabled for the target configuration command lines.

c.     Return to user view.

abort

3.     Enter private-mode system view or exclusive-mode system view.

system-view { exclusive | private }

4.     Configure features as required.

For more information about configuring features, see the configuration guides.

5.     (Optional.) Display target configuration command lines.

display target-configuration

Incorrect target configuration command lines will affect the operation of the network. Use this command to verify that all target configuration command lines are correct.

6.     (Optional.) Refresh uncommitted target configuration.

refresh target-configuration

7.     Commit the target configuration command lines.

commit [ best-effort ] [ force ] [ label labelname ] [ save-running filename ] [ confirmed [ seconds | minutes minutes ] ] [ show-error ] [ clear-error ] [ description text ]

8.     (Optional.) Roll back the running configuration.

configuration replace { file filename | last number | commit-id commit-id | label labelname }

To reclaim target configuration command lines that have been committed, use this command to roll back the running configuration as required. For more information about this command, see configuration file management commands in Fundamentals Command Reference.

Display and maintenance commands for target configuration

Execute the following commands in private-mode system view, exclusive-mode system view, or their lower-level views:

·     display target-configuration

·     reset target-configuration

Execute the following commands in any view:

·     display configuration commit diff

·     display configuration commit list

·     display configuration sessions

Execute the reset configuration commit command in user view.