Configuration Management with Cisco Prime LAN Management Solution 4.1
Chapter 7: Editing and Deploying Configurations Using Config Editor
Downloads: This chapterpdf (PDF - 405.0KB) The complete bookPDF (PDF - 7.53MB) | Feedback

Editing and Deploying Configurations Using Config Editor

Table Of Contents

Editing and Deploying Configurations Using Config Editor

Config Editor Tasks

Benefits of Configuration Editor

Setting Up Preferences

Overview: Editing a Configuration File

Working With the Configuration Editor

Processed Mode

Raw Mode

Editing Configuration Files by Handling Interactive Commands in Config Editor Jobs

Modifying Credentials

Removing a Configuration File

Saving a Configuration File

Undoing All

Replacing All

Printing a Configuration File

Exporting Changes of a Configuration File

Deploying a Configuration File

Closing a Configuration File

Selecting Configuration Tools

Comparing Versions of Configuration Files

Displaying Your Changes

Overview: Syntax Checker

Interface to External Syntax Checker

Registering an External Syntax Checker Application With CMIC

Viewing the List of Modified Configs

Overview: Opening a Configuration File

Opening a Configuration File - By Device and Version

Opening a Configuration File - By Pattern Search

Opening a Configuration File - By Baseline

Baseline Configuration Editor

Opening an External Configuration File

Configuration Deployment in Overwrite and Merge Modes

Overview: Downloading a Configuration File

Starting a New Download Job

Selecting Configs

Scheduling a Job

Reviewing the Work Order

Viewing the Status of all Deployed Jobs


Editing and Deploying Configurations Using Config Editor


The Config Editor provides easy access to configuration files. Config Editor allows a network administrator with the appropriate security privileges to edit a configuration file that exists in the configuration archive.

The Configuration Management application stores the current, and a user-specified number of previous versions, of the configuration files for all supported Cisco devices maintained in the Inventory. It automatically tracks changes to configuration files and updates the database if a change is made.

You can open the configuration file, change it, and download it to the device.

To start Config Editor from the LMS desktop, select Configuration > Tools > Config Editor.

The Config Editor window appears.

To set user preferences in Config Editor, select Configuration > Tools > Config Editor > Edit Mode Preference.

The User Preferences window appears.

This section contains:

Config Editor Tasks

Benefits of Configuration Editor

Setting Up Preferences

Overview: Editing a Configuration File

Working With the Configuration Editor

Removing a Configuration File

Saving a Configuration File

Undoing All

Replacing All

Printing a Configuration File

Exporting Changes of a Configuration File

Deploying a Configuration File

Closing a Configuration File

Selecting Configuration Tools

Comparing Versions of Configuration Files

Displaying Your Changes

Overview: Syntax Checker

Viewing the List of Modified Configs

Overview: Opening a Configuration File

Opening a Configuration File - By Device and Version

Opening a Configuration File - By Pattern Search

Opening a Configuration File - By Baseline

Baseline Configuration Editor

Opening an External Configuration File

Configuration Deployment in Overwrite and Merge Modes

Overview: Downloading a Configuration File

Starting a New Download Job

Selecting Configs

Scheduling a Job

Reviewing the Work Order

Viewing the Status of all Deployed Jobs

Config Editor Tasks

Config Editor users can:

Open a configuration file version of a device for editing.

Open configuration file version based on search criteria.

Open an external configuration file.

Save modified configuration file in private work area on the server and open the saved file when required.

Save a configuration file in a public location.

Send configuration file to syntax checker utility.

Deploy configuration files to the device.

Send configuration download jobs for approval.

View all download jobs and perform job management operations.

List out all the modified files, allow the user to select and download or close the configuration.

Compare configurations that they are editing with the original configuration file version and other configuration versions of the selected device.

Open a baseline configuration stored in config archive.

Benefits of Configuration Editor

Config Editor allows you to edit and download configuration files to devices using a GUI instead of the command line interface (CLI). Use Config Editor to edit individual device configurations within LMS and then download them again to the device.

A copy of the updated configuration will automatically be stored in the Configuration Archive. See Figure 7-1.

Figure 7-1 Config Editor Functional Flow

Table 7-1 shows the tasks you can accomplish with the Config Editor option.

Table 7-1 Config Editor Tasks 

Task
Description
Action

Open a configuration file.

Open a configuration file for editing. You can open a configuration file in four ways:

Device and Version

Pattern Search

Baseline

External Location

Select Configuration > Tools > Config Editor > Config Editor.

Edit configuration files from the archives.

Edit a configuration file from the archive.

Select Configuration > Tools > Config Editor > Config Editor > Device and Version > Edit.

Edit a configuration file by pattern

Edit a configuration file by searching for a pattern. A pattern can be any text string.

Select Configuration > Tools > Config Editor > Config Editor > Pattern Search > Finish.

Edit a configuration file by baseline template

Create a baseline configuration from the baseline template maintained in configuration archive.

Select Configuration > Tools > Config Editor > Config Editor > Baseline > Finish.

Edit a configuration file by external location

Associate a device with the selected configuration file from an external location in the server.

Select Configuration > Tools > Config Editor > Config Editor > External Location> Edit.

Print configuration files.

Print a configuration file.

1. Select Configuration > Tools > Config Editor > Config Editor.

2. Select the configuration file and click Edit.

3. Select the Print icon at the top right corner.

Remove configuration file from the private area

Remove a configuration file from the private work area on the server.

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Delete.

Remove a configuration from the public work area

Remove a configuration file from the public work area on the server.

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Delete.

Save a configuration file in the public work area.

Save an edited configuration file in the public work area on the server and retrieve the saved file when required.

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Save.

Save a configuration file in the private work area.

Save an edited configuration file in the private work area on the server and retrieve the saved file when required.

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Save.

Undo editing or typing changes

Undo editing or typing changes when editing a file. You can undo editing changes of files in private or public work areas.

To undo editing changes of a file in the private work area:

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Undo All.

To undo editing changes of a file in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Undo All.

Find and replace text

Find and replace all occurrences of the text when editing a configuration file in the Raw mode or find the text in a particular configlet in the Processed mode

To find and replace text of a file in the private work area:

1. Select Configuration > Tools > Config Editor > Private Configs

2. Select the configuration file and click Edit.

3. Click Replace All.

To find and replace text of a file in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Replace All.

Export Configuration File Changes

Exporting Changes of a Configuration File to a PDF file.

1. Select Configuration > Tools > Config Editor > Config Editor.

2. Select the configuration file and click Edit.

3. Select the Export icon at the top right corner.

Close Configuration File

Close a configuration file.

To close a configuration file in the private work area:

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Close.

To close a configuration file in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Close.

Configure Job Policies.

Configure a default policy for job properties that applies to all future jobs.

You can also specify whether the property can be modified when the job is created.

Select Admin > Network > Configuration Job Settings > Config Job Policies.

Set up the default editing mode.

Set up or change your default editing preferences.

Config Editor remembers your preferred mode even across different invocations of the application.

You can also change the mode when you open a configuration file using the Device and Version option.

However, Config Editor does not remember this change across different invocations of the application. Only the changes made using the Admin function are remembered.

Select Configuration > Tools > Config Editor > Edit Mode Preference.

View changes

View the changes made to the opened configuration file. LMS compares the edited file with the original version.

To view changes made to a configuration file in the private work area:

1. Select Configuration > Configuration > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Tools.

4. Select View Changes.

To view changes made to a configuration file in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Tools.

4. Select View Changes.

Compare versions of the configuration files.

Compare the edited files with any version in the Configuration Archive.

To compare versions of configuration files in the private work area:

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Tools.

4. Select Compare Config.

To compare versions of configuration files in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Tools.

4. Select Compare Config.

View list of modified files.

View a list of files edited by all users in private or public work areas.

To view a list of modified configuration files in private work area, select Configuration > Tools > Config Editor > Private Configs.

To view a list of modified configuration files in public work area, select Configuration > Tools > Config Editor > Public Configs.

Browse and edit Config Editor jobs.

Browse the Config Editor jobs that are registered on the system and edit them as necessary.

Select Configuration > Job Browsers > Config Editor > Edit.

View job details.

View detailed information about a registered Config Editor job and perform job management operations.

You can also edit a job from its detailed view.

Select Configuration > Job Browsers > Config Editor.

Deploy a config

Define a deploy job. Defines jobs to deploy configuration files to the device.

Select Configuration > Job Browsers > Config Editor > Create.

Copy a job

Copy a job

Select Configuration > Job Browsers > Config Editor > Copy.

Delete a job

Delete a job

Select Configuration > Job Browsers > Config Editor > Delete.

Stop a job

Stop a job

Select Configuration > Job Browsers > Config Editor > Stop.

Check the configuration file syntax.

Check the syntax of the configuration file with an external syntax checker that is registered in CMIC Link registration.

To check the configuration syntax of a file in the private work area:

1. Select Configuration > Tools > Config Editor > Private Configs.

2. Select the configuration file and click Edit.

3. Click Tools

4. Click External Syntax Checker.

To check the configuration syntax of a file in the public work area:

1. Select Configuration > Tools > Config Editor > Public Configs.

2. Select the configuration file and click Edit.

3. Click Tools

4. Click External Syntax Checker.

Update DCR after deploy

Updates DCR after successfully deploying credential commands. This is applicable only for Telnet/SSH based download.

User configurable. An option is provided in the job creation flow.


Setting Up Preferences

You can use this feature to set up your editing preferences. Config Editor remembers your preferred mode, even across different invocations of the application.

You can change the mode using the Device and Version, Pattern Search, Baseline or External Configuration option but the changes do not affect the default settings.

To set up preferences:


Step 1 Select Configuration > Tools > Config Editor > Edit Mode Preference.

The User Preferences dialog box appears.

Step 2 Set the default edit mode:

Select Processed to display the file in the Processed mode.

The configuration file appears at the configlet level (a set of related configuration commands). The default edit mode is Processed.

Select Raw to display the file in the Raw mode.

The entire file appears as shown in the device.

Step 3 Click Apply to apply the specified preferences.


Overview: Editing a Configuration File

The Editor is a core component in Config Editor. It acts as the interface to open a configuration file, make a local copy, save the changed configuration and commit the changes back to the original location.

You can edit a file by:

Selecting the device and the version of the configuration file

Searching for a pattern

Selecting a baseline configuration file

Selecting a configuration file stored in an external location

You can edit a previously opened file, that is, a file from your private area or public work area.

You can edit the files in either the Raw or Processed mode.

Raw mode—The entire file is displayed. After you open a file in a specific mode, you can view it only in that mode.

Processed mode—Only the file commands are displayed at the configlet (set of related configuration commands) level.

Working With the Configuration Editor

You can use the editor to:

Edit and save changes to the configuration file in public or private work area.

Undo editing or typing changes

Replace a string in opened configuration files

Compare configuration files with the same device configuration

View changes made in the configuration file

Run Syntax Checker

This section contains:

Processed Mode

Raw Mode

Editing Configuration Files by Handling Interactive Commands in Config Editor Jobs

Modifying Credentials

The Editor window opens in Raw or Processed mode, based on your preference.

To launch the Editor:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Open a configuration file using any of the following methods:

Using the selection criteria. See Overview: Opening a Configuration File

Using Private Configs

Using Public Configs

Using Private Configs

a. Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

LMS converts the character ":" in the IPv6 address to "%03A". The Archive Name field in the List of Private Configs window might not display the actual IPv6 address.

b. Select the configuration and click Edit.

Using Public Configs

a. Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in public work area.

The User Archived Configs window appears.

LMS converts the character ":" in the IPv6 address to "%03A". The Name field in the User Archived Configs window might not display the actual IPv6 address.

b. Select the configuration and click Edit.

Step 3 Edit the credential commands in the Raw or Processed mode. See Processed Mode and Raw Mode.

Step 4 Select any of the following:

Save to save changes to the configuration file. See Saving a Configuration File.

Save As to save changes to the configuration file in a specified location.

Undo All to undo editing or typing changes. See Undoing All.

Replace All to replace a string in the opened configuration files. See Replacing All.

Deploy to deploy a configuration file to a device.

Tools... to launch the Config Editor tools. See Selecting Configuration Tools.

Close to close the Config Editor window. See Closing a Configuration File.


Processed Mode

The configuration file appears at the configlet level (a set of related configuration commands). The default is Processed.

In the Processed mode, Editor window is divided into two panes.

The left pane displays the configuration tree according to the grouping of configlets.

The right pane displays the commands of configlets in two sections:

The lower section, called the credential area contains all the credential commands with the credentials masked. Click on the encrypted link to modify credentials.

The upper section, called the non-credential area contains only non-credential commands. The non-credential commands are editable.

Raw Mode

The entire file appears as shown in the device. After you open a file in a specific mode, you can view it only in that mode.

In Raw mode there are two sections for the entire configuration.

The upper section, called the non-credential area contains only non-credential commands. The non-credential commands are editable.

The lower section contains all the credential commands with the credentials masked. The credential commands can be edited.


Note Do not delete or edit the placeholder that describes the credential position. If you do so, the file generates errors.


Editing Configuration Files by Handling Interactive Commands in Config Editor Jobs

An interactive command is the input you will have to enter, after a command runs.

For example, in the case of Catalyst 5000 series devices, a command would be:

set vtp v2 enable

This command enables version 2 of VTP on the device. This command is an interactive command and requires user intervention after running the command.

You can download this command through ConfigEditor using:

#INTERACTIVE

set vtp v2 enable<R>y

#ENDS_INTERACTIVE

Such commands can be included in config jobs run using a Config Editor. You can handle interactive commands by editing configuration files.

To edit configuration files using interactive commands:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Click Edit.

The Editor window appears.

Step 3 Enter an interactive command in the configuration file, in the upper section that contains only non-credential commands using the following syntax:

#INTERACTIVE

command1<R>response1<R>response2

command2<R>response1<R>response2<R>response3

command3<R>response1

command4<R>response1<R>response2

#ENDS_INTERACTIVE

<R> tag is case-sensitive and this must be entered in uppercase only.

Step 4 Enter modification comments in the Change Description field.


Modifying Credentials

You can use this feature to modify or delete the credentials of a configuration file.To do this:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing by Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Click Edit.

The Editor window appears.

Step 3 Click the masked credential link in the With Credentials pane. (The masked credential appears as multiple *s.)

The Modify Credentials dialog box appears.

Step 4 Enter the information required to modify credentials.

Field
Description

Modify

Modifies credentials of the selected configlets.

Delete

Deletes the existing credentials of the selected configlets.

Modify Mode

Old Credential

Old credential appears in clear text in a non-editable text box.

New Credential

Enter the new password of the selected configlets. This field is editable when you select the Modify option.

Confirm Credential

Enter the new password of the selected configlets again to confirm the new value. This field is editable when you select the Modify option.


Step 5 Click Submit to record changes.

The changes are reflected in the Editor window.

Step 6 Enter modification comments in the Change Description field.


Removing a Configuration File

You can use this feature to remove configuration files from a private work area or a public work area using Config Editor.

To remove a configuration file stored in the private work area:


Step 1 Select Configuration > Tools > Config Editor > Private Configs.

The List of Private Configs window appears.

Step 2 Select the configuration files that need to be removed.

Step 3 Click Delete.


To remove a configuration file stored in the public work area or the user archive:


Step 1 Select Configuration > Tools > Config Editor > Public Configs.

The Public Configs window appears.

Step 2 Select the configuration files that need to be removed.

Step 3 Click Delete.


You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Saving a Configuration File

You can use this feature to save your changes to the configuration file. The changes can be saved in either a private area or a public area. You can open the file later to modify it or to deploy it to the device.

To save a configuration file:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Save.

The Save Config dialog box appears, only if you are saving the configuration file for the first time. The subsequent saving of a file is done directly to its previously saved location.

Step 4 Enter the information required to save a configuration file.

Field
Description
Usage Notes

Public

Saves the files in the public area.

None.

Private

Saves the files in the private area.

When a configuration from a list of private configs is opened and saved in the public area (user archive) with the same name as the private configuration, the private configuration with that name gets deleted.

However, the reverse is not true. That is when a config is opened from the public area (user archive) and saved in the private area, the public configuration is not deleted.

Branch Name

Name of branch.

Private area to where configuration files are stored locally.


Step 5 Click either:

Submit to save the configuration file.

Or

Cancel to return to the previous setting.


After the configuration file opened from the Device Archive is saved to the private or public archive, all the subsequent operations (compare, show changes) behave as if the configuration is opened from a private or public location.

Undoing All

You can use this feature to undo editing or typing changes. To do this:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Edit the configuration file.

Step 4 Click Undo All.

A message window appears with the message:

Do you want to discard all the changes?

Step 5 Click either:

OK to return to the last saved configuration file.

Or

Cancel to avoid making any changes.


Replacing All

You can use this feature to search for and replace text in the file. To do this:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Replace All.

The Replace All dialog box appears.

Step 4 Enter the text to search for in the Find field.

Step 5 Enter the replacement text in the Replace With field.

Step 6 Click either:

Replace All to replace all instances of the text in the text area.

Or

Cancel to avoid making any changes.


Printing a Configuration File

You can use this feature to print the configuration file. To do this:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Select the Print icon at the top right corner.

A new browser window appears. The details are in PDF format. You can print the information, using the Print option provided by the browser.


Exporting Changes of a Configuration File

You can use this feature to export the modified configuration file to either cfg or XML formats based on the edit operation. To do this:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Select the Export icon at the top right corner.

A new browser window appears to select the directory to which the modified Configfile is exported either in cfg or XML formats.

If you are using the Raw mode then the exported file format is cfg. The file name convention is DeviceName-VersionNumber-raw.cfg.

If you are using the Processed mode then the exported file format is XML. The file name convention is DeviceName-VersionNumber-proc.xml.

Where DeviceName is the device Display Name as entered in Device and Credential Repository and VersionNumber is the device configuration version.

The default directory where the modified Configuration file is exported is:

On Solaris and Soft Appliance server,

/var/adm/CSCOpx/files/rme/cfgedit/configexport

On Windows server,

NMSROOT\files\rme\cfgedit\configexport


Deploying a Configuration File

You can use this feature to deploy a configuration file to a device.

To deploy a configuration file:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location. For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Deploy.

The Job Option Details dialog box appears.

Step 3 Enter the following information:

Field
Description
Job Information

E-mail

Enter e-mail addresses to which the job sends messages at the beginning and at the end of the job.

You can enter multiple e-mail addresses separated by commas.

Configure the SMTP server to send e-mails in the View / Edit System Preferences dialog box (Admin > System > System Preferences).

We recommend that you configure the LMS E-mail ID in the View / Edit System Preferences dialog box (Admin > System > System Preferences). When the job starts or completes, an e-mail is sent with the LMS E-mail ID as the sender's address.

Job Options

Job Password

If you have enabled the Enable Job Password option and disabled the User Configurable option in the Job Policy dialog box (Admin > Network > Configuration Job Settings > Config Job Policies) enter the device login user name and password and device Enable password.

If you have enabled the Enable Job Password option and enabled the User Configurable option in the Job Policy dialog box (Admin > Network > Configuration Job Settings > Config Job Policies) either:

Enter the device login user name and password and device Enable password

or

Disable the Job Password option in the Job Schedule and Options dialog box.

Deploy Mode

Overwrite

Select the Overwrite option, if you want to replace the existing running configuration on the device, with the selected configuration.

This is the default option for the configuration deployment.

The configuration that you have selected is compared with the latest running configuration in the Configuration Archive. (LMS assumes that the latest running configuration in the archive is the same as the configuration currently running on the device.)

The Overwrite mode ensures that the running configuration on the device is overwritten with the selected configuration. This means, after the configuration is successfully deployed, the selected configuration and the running configuration on the device are the same.

Overwrite mode supports Write2Run of the configuration only.

Merge

Select the Merge option, if you want to add incremental configuration to the device.

The configuration that you have selected is deployed on to the device as is. This means, the existing running configuration of the device is updated incrementally with the commands in the selected configuration.

The selected running configuration is not compared with the running configuration in the Configuration Archive.

We recommend that you use this option on newly deployed devices. This is because, the Merge option effectively deploys the entire configuration from the archive, on to the device.

Merge mode supports both Write2Run and Write2Start of the configuration.


Step 4 Click Submit.

An immediate Deploy of Configuration on Device job will be scheduled.

A message appears, Job ID is created successfully.

Where ID is a unique Job number.

Step 5 Click OK.

You can check the status of your scheduled Config Editor Deploy job by selecting Configuration > Job Browsers > Config Editor.


Configurations edited from Raw mode (.RAW) can be downloaded to both Startup or Running configuration of the device.

Configurations edited from Processed mode (.PROC) can only be downloaded to the Running configuration of the device.

Closing a Configuration File

You can use this feature to close the configuration file without exiting the application. If the file contains unsaved changes, you are prompted to save before closing.

To close the configuration file:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Close.

If the file contains any unsaved changes, a message window appears with the message:

You have done some changes since last save. Do you want to the save the changes?

Step 4 Click either:

OK to save the configuration file in a private area.

Your changes are saved.

Or

Cancel to ignore your changes.


Selecting Configuration Tools

You can use this feature to choose a configuration tool from the list of configuration tools. The list of configuration tools available are as follows:

Comparing Versions of Configuration Files

Displaying Your Changes

Overview: Syntax Checker

To select a configuration tool:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Tools.

The Select Tool dialog box appears with the following tools:

Option
Description
Compare Config

Compares the current file with any earlier version in the configuration archive.

View Changes

Displays the changes made in the opened file.

External Syntax Checker

1. Select this option to check the configuration file using an external syntax checker that is registered with Cisco Management Integration Center (CMIC).

2. Click Submit.

Config Editor launches the URL, displaying the configuration commands and sysobject ID of the device as input to the external syntax checker.

3. View the output displayed by the external syntax checker.

4. Modify the commands in Config Editor.


Step 4 Select a tool.

Step 5 Click either:

Submit to launch the tool.

Or

Cancel to close the window.


Comparing Versions of Configuration Files

You can use this feature to compare the current file with any earlier version in the configuration archive.

The Compare option is enabled only if a file is open.

To compare versions of configuration files:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Tools.

The Select Tool dialog box appears.

Step 4 Select Compare Config.

Step 5 Click either:

Submit to view the Version Selector dialog box and proceed to the next step.

Or

Cancel to close the window without making any changes.

Step 6 Select a version with which you want to compare the current open file, from the list of other versions.

The Configuration Compare Report appears.

Step 7 Select the View mode.

Step 8 Click Processed to display files in Processed mode. This is the default option.

Files appear at the configlet level (a set of related configuration commands).

Step 9 Click Raw to display the files in Raw mode.

The entire file appears.

If you want to print the report, click Print.

You can select Diff only option to view the differences, or All to view the entire configurations and compare the differences.


Displaying Your Changes

You can use this feature to display the changes made in the opened file. The text file in archive is compared with the opened version.

The View Changes option is enabled only if a file is open

To display the changes in the open file:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing based on Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Select the configuration file and click Edit.

The Editor window appears.

Step 3 Click Tools.

The Select Tool dialog box appears.

Step 4 Select View Changes option.

Step 5 Click either:

Submit to view the differences in a new window.

Or

Cancel to close the window without making any changes.


Overview: Syntax Checker

Config Editor provides ways to check the syntax of config commands using syntax checker. Config Editor checks syntax using the Interface to External Syntax Checker.

Interface to External Syntax Checker

The external syntax checker has to be registered with Cisco Management Integration Center (CMIC) using Link Registration.

For details see, Registering an External Syntax Checker Application With CMIC. Config Editor queries CMIC to check if the application is registered with the name "Config Syntax Checker".

If the application is registered, Config Editor knows the External Syntax Checker URL to be launched and parameters to be passed to the syntax checker.

Config Editor launches the URL with two parameters, deviceSysObjID and cfgCmds:

deviceSysObjID—sysObjectID of the device. External Syntax Checker uses deviceSysObjID to identify the device type.

cfgCmds—List of commands for which the syntax has been checked.

ConfigEditor launches the External Syntax Checker URL in POST method. When the URL is launched you can view the configuration commands for which the syntax has been checked.

To validate the results and correct the commands in Config Editor:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select Device and Version in the Selection Area page.

Step 3 Click Go.

The Device and Version dialog box appears.

Step 4 Select the required device using Device Selector.

Step 5 Select the information required to open a configuration file.

Field
Description
Version

Latest

Select the latest version of the configuration file.

Earlier

Select an earlier version of the configuration file.

Version Number

Version number of the configuration file. This option is enabled when you select Earlier in the version field.

This field is not editable.

To enter the version number:

1. Click Select to open the Version Tree dialog box.

2. Select the desired version.

3. Either:

Click OK to select the version

Or

Click Cancel to close the window.


Step 6 Click Edit to edit a configuration file

The Configuration Editor dialog box appears.

Step 7 Click Tools.

The Select Tool dialog box appears with the tools.

Step 8 Select External Syntax Checker.

Step 9 Click Submit to launch the tool.

Config Editor launches the External Syntax Checker URL.


Registering an External Syntax Checker Application With CMIC

To register an external syntax checker application with CMIC (Cisco Management Integration Center):


Step 1 Select Link Registration.

The Registered Links window appears.

Step 2 Click Registration in the Links Registrations Status page.

The Enter Link Attributes window appears.

Step 3 Enter the inputs for the following fields:

Field
User Notes

Name

Enter Config Syntax Checker.

URL

Enter the External Syntax Checker URL.

Display Location

Select Third Party.


The Registered Links window appears with the list of registered links.


Viewing the List of Modified Configs

You can use this feature to display a list of configuration files modified by any user in a private work area (select Private Configs) or a public work area (select Public Configs).

To list out all the modified files:


Step 1 Select Configuration > Tools > Config Editor > Private Configs to open a configuration file stored in a private work area.

The List of Private Configs window appears.

Or

Select Configuration > Tools > Config Editor > Public Configs to open a configuration file stored in a public work area.

The Public Configs window appears.

You can also perform any of the editor operations by opening a configuration file for editing by Device and Version, Pattern Search, Baseline and External Location.

For more details see, Overview: Opening a Configuration File.

Step 2 Do any of the following:

Select the file and click Edit to edit an opened configuration file.

The Configuration Editor dialog box appears.

Select the file and click Deploy to deploy a job.

The Select Configs dialog box appears.

Select the file and click Delete to remove an opened configuration file.

The screen is refreshed and the file is removed.


You can open a raw config in processed format. However, you cannot open a processed config in raw format.

Overview: Opening a Configuration File

You can use this feature to open a configuration file for editing.

You can open a configuration file by:

Device and Version—Opens a configuration file from the archive.

Pattern Search—Opens a configuration file by searching for a pattern.

Baseline—Opens a configuration file using a baseline template stored in the device configuration management repository.

External Location—Opens a configuration file stored in an external location

If another user has opened the configuration file, config editor opens another copy of the file.

To open a configuration file:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select an option in the Selection Area page.

Step 3 Click Go.

The Option dialog box opens in a new window.


Opening a Configuration File - By Device and Version

You can use this feature to open a configuration file from the archive. The file opens in read-write mode depending on your edit permissions.

The file appears in either the Raw or Processed mode, based on your preferences.

To open a configuration file from the archive:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select Device and Version in the Selection Area page.

Step 3 Click Go.

The Device and Version dialog box appears.

Step 4 Select the required device using the Device Selector.

Step 5 Select the information required to open a configuration file.

Field
Description
Version

Latest

Select the latest version of the configuration file.

Other

Select an earlier version of the configuration file.

Version Number

Version number of the configuration file. This option is enabled when you select Other in the version field.

This field is not editable.

To enter the version number:

1. Click Select to open the Version Tree dialog box.

2. Select the version you need.

3. Either:

Click OK to select the version

Or

Click Cancel to close the window.

Format

Raw

Displays the entire configuration file. After you open a file in a specific mode, you can view it only in that mode.

Processed

Displays only the commands.


Step 6 Click either:

Edit to edit a configuration file

The configuration editor dialog box appears.

Or

Reset to clear all fields and get to the default setting.


Opening a Configuration File - By Pattern Search

You can use this feature to open a configuration file by

Selecting a label set in Config Archive

Selecting a custom query of default patterns

Searching for a pattern.

A pattern can be any text string. The file is displayed in either the Raw or Processed mode, based on your preferences.

To open a configuration file:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select Pattern Search in the Selection Area page.

Step 3 Click Go.

The Pattern Search dialog box appears.

Step 4 Do any of the following:

Open a configuration file by selecting a label set in Config Archive. See Configuring Labels for more information.

Open a configuration file by selecting a custom query of default pattern

Open a configuration file by searching for a pattern

Open a configuration file by selecting a label set in Config Archive. See Configuring Labels for more information.

a. Select Label to enable the Select a Config Label drop-down list box

b. Select the required label from the Select a Config Label drop-down list box

If you select a label and some devices from the Device Selector, and click Search, the search results will only be for the devices that are part of the selected label.

Open a configuration file by selecting a custom query of default pattern

Select the required Custom Query from the Select Custom Query drop-down list box. To create a custom query, select Configuration > Configuration Archive > Views > Custom Queries.

Open a configuration file by searching for a pattern

a. Enter a pattern in the editable Pattern Column. For example, http server.

To search for more than one pattern, enter the second and third patterns in the Pattern 2 and Pattern 3 fields and so on. You cannot search for special characters. For example, control-C.

b. Click the corresponding Contains/Does not contain row to view the selection drop-down list box.

c. Select Include if you wish to search for configurations that match the patterns you entered and select Exclude if you wish to search for configurations that do not match the patterns you entered. Select the required devices using the Device Selector.

Step 5 Select the required options:

Field
Description
Setting

Match Any

Searches for configurations that have at least one of the patterns you entered.

Match All

Searches for configurations that include all patterns you entered.

Match Case

Searches for configurations that are identical to the pattern entered.

Search Versions

Latest

Searches in the latest version of the configuration file

All

Searches in all the versions of the configuration file


Step 6 Click Search.

The Search Archive Result window appears in the Pattern Search Results page with the search results. The columns in this window are:

Column
Description

Device Name

Name of the device

Version

Version of the configuration file

Created On

Date on which the configuration file was created

Change Description

Modification comments


Step 7 Select any of the following:

Edit to open the selected configuration file in a pop up window for editing. The search result page will be retained. You can select another configuration from the search result page and open that file too for editing.

Back to return to the Pattern Search page.

Finish to complete the search.

Cancel to return to the Selection Criteria page.


Opening a Configuration File - By Baseline

You can use this feature to open a baseline configuration template maintained in the configuration archive. You can create a baseline configuration from the baseline template by replacing all the variables that appear in the configuration.

Config Editor does not check whether you have changed the template variables.


Note The baseline template will be opened only in Raw format.


To open a baseline configuration template:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select Baseline in the Selection Area page.

Step 3 Click Go.

The Baseline Config dialog box appears.

Step 4 Select the required devices using the Device Selector.

Step 5 Click Next

The Baseline Template window appears with the following details:

Column
Description

Baseline Name

Name of the Baseline template.

Description

Brief description about the template.

Created On

Date on which the template was created.


Step 6 Select a Baseline template based on the device type.

Step 7 Select any of the following:

Back to return to the Baseline Config page.

Finish to associate the selected template to a device.

Cancel to return to the Selection Criteria page.


While editing a baseline template, you are required to replace variables that appear in the template with actual values.

For example, in the following line [msg] is the variable.
banner motd [msg]

You should replace [msg] with actual value.

Baseline Configuration Editor

You can use this feature to edit the Baseline template of the configuration file. To do this:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select Baseline in the Selection Area page.

Step 3 Click Go.

The Baseline Config dialog box appears.

Step 4 Select the required devices using the Device Selector.

Step 5 Click Next.

The Baseline Template window appears with the following details:

Column
Description

Baseline Name

Name of the Baseline template.

Description

Brief description about the template.

Created On

Date on which the template was created.


Step 6 Select a Baseline template based on the device type.

Step 7 Click Finish.

The Baseline Configuration Editor dialog box appears.

Step 8 Edit the text area. (The upper section contains only non-credential commands and is called the text area.)

Step 9 Enter comments for changes in baseline in the Change Description field.

Step 10 Select any of the following:

Save to save changes to the configuration file.

Undo All to undo editing or typing changes.

Replace All to replace a string in the opened configuration files.

Tools... to launch the Config Editor tools.

Close to close the Config Editor window.


Opening an External Configuration File

You can use this feature to associate a device with the selected configuration file from an external location (other than archive) in the server. The file appears in either a Raw or Processed mode, based on your preferences.

For example, if you associate the selected configuration to an IOS device in the Processed mode, then the given configuration is processed based on the IOS rules defined in LMS.

The file in the archive can be opened with a specified format from the temp directory on the local server, from another file system mapped drive or any mount. The file opened is validated for format with DCMA.

To open a configuration file from an external location:


Step 1 Select Configuration > Tools > Config Editor > Config Editor.

Step 2 Select External Location in the Selection Area page.

Step 3 Click Go.

The External File Selection dialog box appears.

Step 4 Click Browse to select the external file location.

The External Config Selector dialog box appears with the following fields:

Field
Description
Usage Notes

File

Location of the file

Enter the file location. For example, D:/CSCOpx

Directory content

Name of the directory

Select the directory. For example, bin/

Drive

Name of the drive

Select the drive. For example, D:\


Step 5 Click either:

OK to enter the external location.

Or

Cancel to return to the External File Selection page.

Step 6 Select the required devices using the Device Selector.

Step 7 Either:

Click Edit to edit a configuration file

The configuration editor dialog box appears.

Or

Click Reset to clear all fields and get to the default setting.


You can control the access to directories/folders present on the server. There is a property file for this purpose located at:

NMSROOT/MDC/tomcat/webapps/rme/WEB-INF/classes/com/cisco/nm/rmeng/config/cfgedit
/ConfigEditor.properties (On Solaris and Soft Appliance)

NMSROOT\MDC\tomcat\webapps\rme\WEB-INF\classes\com\cisco\nm\rmeng\config\cfgedit
\ConfigEditor.properties (On Windows)

NMSROOT is the LMS install directory.

This file has two variables:

DIR_LIST—You can mention all the directories or files separated by pipe symbol (|).

ALLOW—You can set as true or false. If you set the value as true, you can access only those directories or files given as values for the variable DIR_LIST. If you set the value as false, you cannot access those directories or files given as values for the variable DIR_LIST.

The default values for the variables are:

DIR_LISTetc/passwd

ALLOWfalse

Configuration Deployment in Overwrite and Merge Modes

Overwrite Mode

Config Editor assumes that the latest archived version is the same as the running configuration on the device.

Before Config Editor downloads the archived configuration on the device, it compares the archived version (which you have modified) with the latest version. The application then overwrites the running configuration on the device with the archived version. This means, after the configuration is successfully deployed, the selected configuration and the running configuration on the device are the same.

For example, assume that the archived version contains commands a, b, c, and d; and that the latest running version, contains commands a, b, e, f, and g. After the archived configuration has been restored, the running configuration on the device, will contain commands a, b, c, and d.

Ensure that all the required commands are in the archived version. You can review the work order and make necessary changes by editing the archived version, if required.

This is the default mode for the configuration deployment.

Merge Mode

The configuration that you have selected is deployed on to the device as is. This means, the existing running configuration of the device is updated incrementally with the commands in the selected configuration.

The selected running configuration is not compared with the running configuration in the Configuration Archive.

We recommend that you use this mode on newly deployed devices. This is because, the Merge option effectively deploys the entire configuration from the archive, on to the device.

Overview: Downloading a Configuration File

To download a configuration file to the device and to the archive, you must:

Create a download job.

Select the configuration file on which the job will run.

Configure the job properties.

Set the job approvers.

Review the job work order.

When a job starts to download, the users on the job approver list are notified by e-mail. At least one approver must approve the job before it can run. Make sure that an approver list with the approvers you want exists.

If there is no approver list but you have the correct access privileges, you must modify or create approver lists, using the Job Approval option. Otherwise, contact your system administrator. See Administration of Cisco Prime LAN Management Solution 4.1 for more information.

Starting a New Download Job

You can use the Create Config Download Job wizard to define and schedule a download job.


Step 1 Select Configuration > Job Browsers > Config Editor.

The Config Deploy Job Browser window appears.

Step 2 Click Create.

The Create Config Download Job wizard appears.

All dialog boxes of the wizard contain the following buttons:

Button
Description

Back

Returns to the previous page.

Next

Returns to the next page.

Finish

Completes creation of jobs.

Cancel

Cancels creation of job.



Selecting Configs

You can use the Select Configs dialog box to select configuration files of devices on which the download job will run.

You must start a new download job before you start selecting configuration files. To do this:


Step 1 Select a configuration file on which to run the job using device selector on the left pane.

The select configuration file dialog has two panes.

Left Pane—The Device Selector appears.

Right Pane—The list of selected configuration files appear.

Step 2 Click either:

Add Latest to move the latest version of the selected configuration file to the Selected Configuration Files pane

Or

Add Other Version to move any version of the selected configuration file to the Selected Configuration Files pane

Step 3 Do any of the following:

Click Next to proceed to the Job Schedule and Options dialog box.

Click Cancel to stop creating a download job.

Select a configuration file from the Selected Configuration Files pane and click Delete to remove a configuration file.


Scheduling a Job

This feature allows you to assign a job name, schedule the job and set job options.

Before scheduling a job you must:

1. Start a new download job.

2. Select Configs.

To schedule a job:


Step 1 Enter the following information in the Job Schedule and Options dialog box.

Field
Description/Action
Usage Notes
Scheduling

Run Type

Schedules the job to run immediately or in the future.

Select either Once or Immediately.

You can specify when you want to run the job.
To define this, select an option from the drop down menu:

Once—Job will run once in the future. You can specify the Starting Date and Time for the job to be run

Immediately—Job will run immediately. This option is not available if Job Approval is enabled.

Date

Date on which you want to run the job.

Select date for the job to run.

If Run Type is Immediate, the system date is automatically selected.

At

Time when you want to run the job in the future.

Select time for the job to run.

If Run Type is Immediate, the system time is automatically selected.

Job Info

Job Description

Enter job description.

Make each description unique so you can easily identify jobs.

E-mail

Allows you to enter the e-mail addresses to which the job will send status notices.

Separate multiple addresses with commas.

E-mail notification is sent when job is created, started, deleted, canceled, and completed.

Comments

Allows you to enter comments.

 

Approval Comment

Allows you to enter approval comments.

This field is not active if approval comments were not set using administration approval.

Select Configuration > Config Jobs > Job Approval to set approval comments.

For more information, see Administration of Cisco Prime LAN Management Solution 4.1.

Maker E-mail

Mail ID of the person who created the job.

This field is not active if approvers were not set using administration approval.

Select Configuration > Config Jobs > Job Approval to set approval comments.

For more information, see Administration of Cisco Prime LAN Management Solution 4.1.

Job Options

Fail on mismatch of Configuration Version

Select this option, if you want to cause the job to be considered Failed, if there is a version mismatch.

A job is considered Failed when the most recent configuration version in the configuration archive is not identical to the configuration that was running when you created the job.

Sync archive before running a job

Select this option if you want to archive the running configuration before making configuration changes.

Synchronize archive before running a job policy gets selected when Fail on mismatch of Configuration Version policy is selected.

Delete Config after Download

Select this option if you want to delete the configuration file after download.

Applicable only to private configuration files.

Copy running to Startup

Select this option if you want to copy the running configuration to the startup configuration on each device after configuration changes are made successfully.

This does not apply to Catalyst OS devices.

Enable Job Password

Select this option to enable username and password.

 

Login User Name

Enter the username configured on the device.

This field is editable only when you select the Enable Job Password option.

LMS ignores the username in the database and uses the newly entered username instead.

Login Password

Enter the password for the device.

This field is editable only when you select the Enable Job Password option.

LMS ignores the password in the database and uses the newly entered password instead.

Enable Password

Enter the enable password configured on the device.

This field is editable only when you select the Enable Job Password option.

LMS ignores the password in the database and uses the newly entered password instead.

Failure Policy

Specify what the job should do if it fails to run on the device.

Select Ignore Failure and Continue from the drop-down list box to continue the job and make configuration changes to the remaining devices, configured by the job

Or

Select Stop on Failure to stop making changes to the remaining devices.

Execution

Mode in which the job is executed. There are two options, Parallel and Sequential.

1. Select Parallel to run the job on multiple devices at same time

Or

Select Sequential to run the job one device at a time.

2. Click Device Order.

The Set Device Order dialog box appears.

3. Use the Up and Down arrows to move a device up or down.

4. Click Done.

Deploy Mode

Mode in which the configuration file is downloaded. The two modes are Overwrite and Merge.

Do either of the following:

Select the Overwrite option, if you want to replace the existing running configuration on the device, with the selected configuration.

This is the default option for the configuration deployment.

The configuration that you have selected is compared with the latest running configuration in the Configuration Archive. (LMS assumes that the latest running configuration in the archive is the same as the configuration currently running on the device.)

The Overwrite mode ensures that the running configuration on the device is overwritten with the selected configuration. This means, after the configuration is successfully deployed, the selected configuration and the running configuration on the device are the same.

Overwrite mode supports only Write2Run of the configuration.

Or

Select the Merge option, if you want to add incremental configuration to the device.

The configuration that you have selected is deployed on to the device as is. This means, the existing running configuration of the device is updated incrementally with the commands in the selected configuration.

The selected running configuration is not compared with the running configuration in the Configuration Archive.

We recommend that you use this option on newly deployed devices. This is because, the Merge option effectively deploys the entire configuration from the archive, on to the device.

Merge mode supports both Write2Run and Write2Start of the configuration.

Write To

The method in which the Configuration is pushed. The two methods are Running and Startup

Do either of the following:

Select the Running option, if you want to replace the existing running configuration on the device, with the selected configuration file. This is also referred to as Write2Run.

Or

Select the Startup option, if you want to erase the contents of the device's startup configuration and write the contents of the given file as the device's new startup configuration. This is also referred to as Write2Start.

Configurations edited from Raw mode (.RAW) can be downloaded to both Startup or Running configuration of the device.

Configurations edited from Processed mode (.PROC) can only be downloaded to the Running configuration of the device.

Update credentials after deploy

Update the credentials in DCR after deployment, if the deployed commands include any credentials commands.

Choose this option if you want to update the DCR with the deployed credentials commands such as SNMP community strings, Telnet username/password etc.

Write2Start does not support changing the credentials after deployment.


Step 2 Select any of the following:

Back to return to the Select Configs dialog box.

Next to proceed to the Job Summary dialog box.

Cancel to stop creating a Download job.


Reviewing the Work Order

The work order summarizes the job you created. If you find any changes missing when you review the work order you can go back and change the options.

Complete the following prerequisite steps of the job definition process:

1. Start a new download job

2. Select configs

3. Configure job properties

4. Set job approvers, if Job Approval is enabled

To review the work order:


Step 1 Review the information in the Work Order dialog box. The fields in this dialog box are:

Field
Description

General Info

Detailed information about the job, such as owner, description and schedule.

Job Approval Info

Status of approval.

Job Policies

Policies configured for the job. Edit in Job Properties dialog box.

Devices

Devices on which the job will run. Edit in Device Selector dialog box.

Device Commands

Commands that the job will run.

Username

Username of the job owner.


To modify the job, return to any previous dialog box and change the information.

To return to a previous dialog box, click Back until the dialog box appears.

Step 2 Click Finish in the Work Order dialog box to register the job.


Viewing the Status of all Deployed Jobs

You can use this feature to view the status of all pending, running, and completed jobs. You can create a new job or edit, copy, stop and delete a job that you have opened.

You can only Edit one job at a time while you can Stop or Delete multiple jobs at a time.

To view all the downloaded jobs:


Step 1 Select Configuration > Job Browsers > Config Editor.

The List of Deploy Jobs window appears with the list of all the jobs.

Column
Description

Job ID

Unique number assigned to job at creation. Never reused.

Run Status

Job states:

Canceled

Suspended

Missed start

Rejected

Succeeded

Succeeded with info

Failed, Crashed

Failed at start

Running.

Description

Description of the job, as entered during job definition.

Owner

Name of the user who owns the configuration file.

Scheduled On

Date and time the job is scheduled to run.

Completed At

Date and time at which the job is completed.

Schedule Type

Job schedule types:

Suspended

Scheduled

Waiting for approval

Rejected

Canceled.

Status

Status of running or completed jobs: Job Started, Progress, Job Cancelled, Job Failed, Job Successful.

Pending jobs have no status.


Step 2 Click one of the following buttons:

Button
Description
Usage Notes

Create

Creates a new job.

1. Click Create.

The Create Config Deploy Job wizard appears.

2. Use the wizard to define and schedule a download job.

Edit

Edits pending job.

The Job definition opens with the current information, including Job ID.

You can edit the job in the same way as you can define and schedule a new job.

Click Edit to edit only jobs you own.

If the job start time occurs during editing, it will run without the edits.

In such a case, you can complete your edits, reschedule the job, and re-edit it.

To prevent job from running unedited:

1. Complete edits before job start time.

2. Cancel job and create new one.

Copy

Copies job.

You can edit the job in the same way as you can define and schedule a new job.

Click Copy.

The Job definition opens with the current information and the new ID except job schedule details filled in.

Stop

Stops a running job.

1. Click Stop.

You are prompted to confirm stopping a job.

2. Click OK.

You can stop only the jobs that you own. Admin level users can stop all jobs.

Delete

Removes the job from the Job Scheduler.

1. Click Delete.

You are prompted to confirm stopping a job.

2. Click OK or Cancel.

You can remove only the jobs that you own. Admin level users can remove all jobs.