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.