User Guide for Resource Manager Essentials 3.5 (With LMS 2.2/RWAN 1.3)
Performing Maintenance on Your Essentials Server

Table Of Contents

Performing Maintenance on Your Essentials Server

What You Need—Prerequisites

How To Do It—Procedures

Remove Records From the Change Audit Log

Remove Images From the Software Library

Remove Old Data From the Job Control Report

Add Unmanaged Devices to Inventory

Remove Configuration Files from the Archive

Quick Download a Configuration Onto a Device

Remove Old ConfigArchive Jobs Created Using Quick Download

Where You Should End Up—Verification

Verify Removal of Change Audit Log Records

Verify Removal of Software Images from the Library

Verify Removal of Old Data from the Job Control Report

Verify Addition of Unmanaged Devices to Inventory

Verify Removal of Configuration Files from the Archive

Verify Quick Download of Configuration File from the Archive

Verify Removal of ConfigArchive Jobs


Performing Maintenance on Your Essentials Server


As a network administrator you need to perform maintenance to keep your information updated and to get rid of unnecessary or outdated reports and data on the system.

What You Need—Prerequisites

In this scenario, you will use these applications:

Change Audit

Software Management

Syslog Analysis

Inventory

Configuration Management

Before you can perform maintenance tasks:

Create a historical report of network changes (select Resource Manager Essentials > Change Audit > All Changes) before you delete Change Audit records.

Run the unexpected devices report (select Resource Manager Essentials > Syslog Analysis > Unexpected Device Report) to verify which devices you need to add to inventory.

For a complete description of the required tasks, see the online help.

How To Do It—Procedures

Remove Records From the Change Audit Log

Remove Images From the Software Library

Remove Old Data From the Job Control Report

Add Unmanaged Devices to Inventory

Remove Configuration Files from the Archive

Quick Download a Configuration Onto a Device

Remove Old ConfigArchive Jobs Created Using Quick Download

The purpose of this scenario is to show you how you can use specific applications to perform these tasks. This will help you understand how to use the applications to perform similar tasks in your network.

Remove Records From the Change Audit Log

Delete change records according to your auditing guidelines and disk space.


Step 1 If you have not already done so, select Resource Manager Essentials > Change Audit > All Changes and save the report. This is your historical backup.

Step 2 Select Resource Manager Essentials > Administration > Change Audit > Delete Change History.

The Change Audit—Filter Options dialog box appears.

Step 3 Select the views you need.

Devices for that particular view appears.

Step 4 Select the devices, then click Next to apply additional filters.

The Change Audit—Delete Change History dialog box appears.

Step 5 Select the criteria for deleting your Change Audit data.

Delete Change History dialog box contains these options:

Option
Usage
Application

You can select the application name. Current application that log change records are Inventory Manager, Configuration Manager, and Software Management.

An application name does not appear in the options list if there are no records for that application. The default is All Applications.

Category

You can select the category. Current categories are config, inventory, and swim.

A category name does not appear in the options list if there are no records for that application category. The default is All Categories.

User

You can select the user from the drop-down list.

A username does not appear in the options list if there are no records for that user. The default is All Users.

Mode

You can select the connection mode from the drop-down list.

The connection mode options do not appear in the options list if there are no records for that option. The default is All Modes.

Select Date Range

Select the required date range.


Step 6 Click Next to schedule the deletion.

The Change Audit—Schedule Jobs dialog box appears.

Step 7 Select the Schedule Type from the drop-down list to specify a schedule for the deletion.

The Schedule Type drop-down list contains these options:

Option
Usage
Immediate

Runs the job immediately.

Once

Runs the job once using the selected time and date.

Daily

Runs the job daily as you have specified in the Run Job field.

Weekly

Runs the job weekly as you have specified in the Run Job field.

Monthly

Runs the job monthly as you have specified in the Run Job field.


Step 8 Click Finish to confirm deleting the selection.

The Change Audit—Delete Change Records dialog box displays the results.


Note Change Audit records accumulate in the system unless they are explicitly deleted by an administrator. This will result in retention of large number of .dfr and .dfc files in the archive directory. It is recommended that you create a periodic job to purge Change Audit records. If you want to retain the change history, you can save them in CSV format and then purge them.



Remove Images From the Software Library


Step 1 Select Resource Manager Essentials > Software Management > Library > Browse Images.

The Image Library Summary opens.


Caution If you delete software images from the Essentials server, you cannot restore them. You must download them from CCO or the server where your images are stored.

Step 2 Select the corresponding check boxes of the images that you need to delete, and then click Delete.

A dialog box appears.

To cancel the image deletion, click Cancel.

To delete the images, click OK.


Remove Old Data From the Job Control Report


Step 1 To display the Job Control Report select Resource Manager Essentials > Software Management > Job Management > Browse Jobs.

Step 2 Click the ID of the job you want to delete.

Step 3 Click Remove.


Add Unmanaged Devices to Inventory


Step 1 If you have not already done so, run an unexpected device report (select Resource Manager Essentials > Syslog Analysis > Unexpected Device Report).

Step 2 Review the report to determine which devices have been added to the network, but not to inventory.

Step 3 Select Resource Manager Essentials > Administration > Inventory > Add Devices.

The Add a Single Device dialog box appears.

Step 4 Enter the access information in the Add a Single Device dialog box, then click Next.

The Enter Login Authentication Information dialog box appears.

Step 5 Enter and verify the information in the Enter Login Authentication dialog box.

If the device is running Terminal Access Controller Access Control System (TACACS), enter the TACACS username and TACACS password. If you are using Software Management or Device Configuration or managing Cisco 2500 single Flash bank (SFB) devices, you must enter the read-write community string. (You should also enter the Telnet passwords.) Otherwise, upgrades will not succeed.

Step 6 Click Next.

The Enter Enable Authentication Information dialog box appears.

If the device is running TACACS, enter the Enable TACACS username and Enable TACACS password.

Step 7 Enter and verify the information in the Enter Login Authentication Information dialog box.

Step 8 Click Finish.

The Single Device Add dialog box appears.

Step 9 To add another device, click Add Another and repeat steps Step 4 through Step 7.


Remove Configuration Files from the Archive


Step 1 Select Resource Manager Essentials > Administration > Configuration Management > General Setup.

The Configuration Manager Admin dialog box appears.

Step 2 Select the Archive Setup tab.

To specify when the program should purge configuration files from the archive, select one of the following:

Click Older than, then enter a number and select days, weeks, or months.

Click Maximum versions to keep, then enter the number of configurations to retain.

Click Don't Purge Labelled Files to retain the labeled configuration files.

It is not recommended that you purge according to the maximum number of versions, if you change many configurations each day. For example, if you have a known good configuration and then make 10 changes to it, you will have 11 versions stored in the archive. If you specify keeping only 10 versions in the archive, the known good configuration is purged because it is the oldest version.

Step 3 Click Apply.

A message that the changes to the archive were made, appears.


Quick Download a Configuration Onto a Device

The Quick Configuration Download feature enables you to create a job that quickly downloads the version of the running configuration that you need, from the Configuration Archive, to the selected device.

As a part of your Essentials maintenance activities you may need to quickly do these tasks:

Download a known "good" version of running configuration, from the Configuration Archive, to a device.

or

Restore a version of the running configuration from the Configuration Archive, on to a device that has crashed and restarted.

Quick Configuration Download,

Can be used only for the running configuration of all categories of devices.

Is for Immediate jobs (jobs executed immediately). Therefore, do not enable Job approval when you use this feature.

Uses merge mode when you restore running configuration on a device.

Supports multi-line banner commands and downloads them. The feature also supports interactive commands in configuration.

Uses TFTP, Telnet and SSH transport protocols.

This table details the transport protocols used for Quick Configuration Download, for the various categories of devices:

Device Category
Telnet
TFTP
SSH

Routers

Yes

Yes

Yes

Switches

Yes

Yes

Yes

FastSwitches

Yes

Yes

No

CSS

Yes

No

Yes

CE

Yes

No

Yes


Quick Configuration Download jobs use the same protocol order that you have specified the Transport Setup (Resource Manager Essentials > Administration > Configuration Management > General Setup).


Note You cannot perform Quick Configuration Download for VLAN configurations. VLAN configurations can be downloaded using the command line.
Also, you cannot roll back Quick Configuration Download jobs.


You can perform a Quick Configuration Download with Network Administrator privileges.

To perform a quick download of a selected version of configuration:


Step 1 Select either:

Resource Manager Essentials > Configuration Management > Search Archive By Device.

or

Resource Manager Essentials > Configuration Management > Search Archive By Pattern.

Step 2 Either:

Select the devices whose configurations you want to search.

or

Enter the text pattern.

Step 3 Select either:

Latest to view the most recent configuration only

or

All to view all the configuration versions.

Step 4 Select any one of the Report Type options.

Step 5 Click Finish.

The configuration report appears.

Step 6 Click one of the following options based on the report that you have generated:

Report Type
Action

Configuration Summary Report

Click any one of the these: For example:

Most Recent Archive

2nd Most Recent

3rd Most Recent

The Device Configuration Viewer window appears.

Configuration Version Report

Click View. Device Configuration Viewer window appears.

Configuration Quick View Report

Device Configuration Viewer window appears. Click the device and select the required version.


Step 7 Click Download this Config to Device.

A confirmation message appears.

Step 8 Click Yes.

A message appears with the Job ID.

Step 9 Click OK.

The Job Browser window appears. This window displays the status of your Quick Config Download job.

To verify whether your quick download has been successful, see the section, "Verify Quick Download of Configuration File from the Archive".


Remove Old ConfigArchive Jobs Created Using Quick Download

You can remove the old ConfigArchive jobs created using the Quick Download feature by following either of these procedures:

Procedure 1

Procedure 2

Procedure 1


Step 1 Select Server Configuration > Administration > Job Management from the CiscoWorks desktop.

The Job Manager dialog box appears.

Step 2 Select a ConfigArchive job.

Step 3 Click on the Remove Job button.

The Confirm Job Removal dialog box appears.

Step 4 Click Yes to remove the selected ConfigArchive job or No to retain the job


Procedure 2

If you are in ConfigArchive Job Browser window, go to Step 5. Otherwise go to Step 1.


Step 1 Select Server Configuration > Administration > Job Management from the CiscoWorks desktop.

The Job Manager dialog box appears.

Step 2 Select a ConfigArchive job.

Step 3 Click on the Job details button.

The ConfigArchive Job Details window appears.

Step 4 Select Jobs > Job Browser

The ConfigArchive job browser window appears.

Step 5 Select the ConfigArchive job

Step 6 Click on the Remove Job button

The Confirmation dialog box appears.

Step 7 Click Yes to remove the selected ConfigArchive job or No to retain the job.


Where You Should End Up—Verification

After you perform maintenance tasks, verify that they were done:

Verify Removal of Change Audit Log Records

Verify Removal of Software Images from the Library

Verify Removal of Old Data from the Job Control Report

Verify Addition of Unmanaged Devices to Inventory

Verify Quick Download of Configuration File from the Archive

Verify Removal of Configuration Files from the Archive

Verify Removal of Change Audit Log Records


Step 1 Select Resource Manager Essentials > Change Audit > Search Change Audit.

The Change Audit - Filter Options dialog box appears.

Step 2 Select All Views and All Devices, then click Next.

A second Change Audit - Filter Options dialog box appears.

Step 3 Select All from the Application field, Category field, User field, and Mode field, then select the dates for which you removed records, and then click Finish.

The Change Audit - Search report appears. No records for your dates should appear.


Verify Removal of Software Images from the Library


Step 1 Select Resource Manager Essentials > Software Management > Library > Browse Images.

The Image Summary Report opens.

Step 2 Scan the report to make sure that the software images you deleted are gone.


Verify Removal of Old Data from the Job Control Report


Step 1 Display the Job Control Report by selecting Resource Manager Essentials > Software Management > Job Management > Browse Jobs.

Step 2 Verify that the job you deleted is no longer on the report.


Verify Addition of Unmanaged Devices to Inventory


Step 1 Select Resource Manager Essentials > Administration > Inventory > List Devices.

The List Devices dialog box appears.

Step 2 Verify that the devices you added appear on the list.


Verify Removal of Configuration Files from the Archive

Since the configuration files are removed from the archive on a schedule, it is not necessary to verify if they are removed each time the job runs.

To verify if configuration files are removed from the archive on a schedule, view the directory:

On Windows systems, go to $NMSROOT\files\archive\config

On Unix systems, enter /var/adm/CSCOpx/files/archive/config

Verify Quick Download of Configuration File from the Archive


Step 1 Select Server Configuration > Administration > Job Management from the CiscoWorks desktop.

The Job Management dialog box appears.

Step 2 Verify the status of your ConfigArchive Job.

After a successful Quick Config Download job, a Change Audit record will be logged, and the Configuration Archive synchronized through a configuration fetch operation.


Verify Removal of ConfigArchive Jobs


Step 1 Select Server Configuration > Administration > Job Management from the CiscoWorks desktop.

The Job Manager dialog box appears.

Step 2 Verify that the ConfigArchive jobs that you have deleted, no longer appear in the Job Manager dialog box.