Managing System Performance

Viewing the System Log File

Using the Command Log Window

Backing Up and Restoring Configuration Information

Downloading a Cisco IOS Software Image

Managing System Performance

This chapter describes how to maintain your Cisco EMF/CDM system at its peak level of performance.

This chapter includes the following sections:

The system log file records all system-generated messages for each DSLAM chassis that is configured on the network. The DSLAM logs system messages and sends these messages to the Cisco EMF or CDM console. The DSLAM node software saves system log messages in an internal buffer that can store up to 1024 messages.

Note The system stores the system log file in the same directory in which you installed the software (.../opt/cemf/logs). System log files are stored in Cisco IOS, rather than in CDM.

The system message logging facility allows you to do the following tasks:

Monitor and troubleshoot your system
Select the severity levels of the captured information

You can view or print system log information in the SysLog Messages window. The SysLog Messages window contains a list of network components from which you select to view error and status messages. Examples of messages that may appear in the SysLog Messages window for a component include alarm messages or loss of traffic messages.

Note User-initiated events are logged in the Command History window (refer to the "Using the Command Log Window" section for more information.)

From the SysLog Messages window, you can select a severity range for the events that you want to view. Table 6-1 describes the severity levels.

Table 6-1: SysLog Messages Window Security Level Definitions

Level Definition

Emergency

The system is unusable

Alert

Immediate action is required

Critical

Prompt action is required

Error

Necessary action is required

Warning

A minor condition has occurred

Notice

A normal but significant condition has occurred

Info

Informational messages are captured

Debug

Debugging messages are captured

Level	Definition
Emergency	The system is unusable
Alert	Immediate action is required
Critical	Prompt action is required
Error	Necessary action is required
Warning	A minor condition has occurred
Notice	A normal but significant condition has occurred
Info	Informational messages are captured
Debug	Debugging messages are captured

The Debug severity level is the least severe type of message that the system generates, and the Emergency level is the most severe type of message. From the SysLog Messages window, you can select a single severity level for the error and status messages that you want to view, or you can select a range of severity levels.

For example, if you select a maximum severity level of

Emergency—The window displays only the error and status messages with an Emergency severity level.
Warning—The window displays all messages from the Warning severity level up to the Emergency severity level (within the date range that you selected), and ignores all messages below the Warning severity level.
Debug—The window displays all messages for all severity levels (within the date range that you selected).

Note After you configure or change the parameters, the system does not dynamically update the list of events in the SysLog Messages area. Only the syslog messages that the system generates since you configured the parameters display in the SysLog Messages area.

To view the SysLog Messages window, follow these steps:

Step 1 In the Map Viewer window, within the CDM Manager view, right-click a chassis to access the object menu.

Step 2 Choose Cisco DSL Manager > Physical > Chassis > View > SysLog Messages.

The SysLog Messages window opens, which is shown in Figure 6-1.

Figure 6-1: SysLog Messages Window

Step 3 From the list box on the left side of the window, select the chassis for which you want to view a system log.

Step 4 Configure the parameters in the SysLog Messages window, as follows:

a. In the Maximum Table Entries field, enter the number of events you want to view at one time.

b. In the Max. SysLog Severity field, use the down arrow to select the severity level of events you want to view.

: Debug is the lowest severity and is used primarily by engineers to view errors in the code. The highest severity is Emergency.

c. In the Notifications Enabled field, use the down arrow to select your preference for alarm notification.

Select true if you want to be notified of alarms (alarms appear in the list of events in the SysLog Messages area).
Select false if you do not want to be notified of alarms.

The list of events appear in the SysLog Messages area.

Using the Command Log Window

The Command Log window reflects the data that is in the Command History file, which is a system-generated file. Each time a user makes a configuration change to a component on the network, the system creates an entry in the Command History file.

From the Command Log window, you can view the details of each configuration entry including information such as event, time the event occurred, name of the logged-in user, the change that was performed on an object, the internet address of the requested system or requester, and more.

To open the Command Log window, follow these steps:

Step 1 From the Map Viewer window, within the CDM Manager view, right-click a chassis object to access the object menu.

Step 2 Choose Cisco DSL Manager > Physical > Chassis > View > Command Log.

The Command Log window opens, which is shown in Figure 6-2.

Figure 6-2: Command Log Window

Step 3 From the list box on the left side of the window, select the chassis for which you want to view the command history events.

Step 4 In the Maximum Table Entries field, enter the number of events you want to view at one time.

Step 5 Click Save or choose File > Save from the menu bar.

The list of events displays in the Command Log Details area.

After you configure or change the parameters, the system does not dynamically update the list of events in the Command Log Details area. Only the messages that the system generates since you configured the parameters display in the Command Log Details area.

Backing Up and Restoring Configuration Information

You can upload the currently running Cisco DSLAM configuration from a selected Cisco DSLAM and save it as a file to any Trivial File Transfer Protocol (TFTP) server. You can download this file later from the TFTP server to a specified Cisco DSLAM.

Perform backups on a regular basis to recover configuration information in the unlikely event of a hardware failure. For example, if an NI-2 card fails, you can install a new NI-2 card in the chassis, click the Restore button in the Configuration Backup/Restore window, and the system restores the configuration data.

It is important that you back up configuration data on a regular basis because all configuration changes made between the last backup and the time of the failure will be lost.

Note The backup/restore feature is not intended for use as a configurable tool. The system uses the same file each time you back up the configuration data.

Backup/Restore is configured on a per chassis basis. When you click the Backup button, all CDM configurations are copied onto the TFTP server. When you click the Restore button, the system initiates the action of restoring the running configuration to a Cisco DSLAM.

To open the Configuration/Backup Restore window and perform a backup and restore of your configuration data, follow these steps:

Step 1 From the Map Viewer window, right-click the shelf or chassis for which you want the system to back up configuration data to access the object menu.

Step 2 Choose Cisco DSL Manager > Physical > Chassis > Configuration Backup/Restore.

The Configuration Backup/Restore window opens, which is shown in Figure 6-3.

Figure 6-3: Configuration Backup/Restore Window

Step 3 From the list on the left side of the window, select the chassis, or multiple cards, for which you want to back up or restore configuration data.

Step 4 Configure the parameters in the Configuration area as follows:

a. In the Back Up Server field, enter the TFTP IP address of the backup server.

b. In the Back Up After Every Action field, use the down arrow to select either enable or disable.

: If you select enable, the system automatically performs a backup after every configuration change. If you select disable, the system does not perform a backup. You must back up configuration data manually.
: The Time Stamp of Last Backup field is Display only. This field displays the time that the system last backed up the configuration data.
: The Back Up File Name is Display only. This field displays the name of the last backed up file. The file name does not change. The file name is based on the chassis IOS Host name and IP address, and is used for each backup session.

Note At this time, you must choose File > Save from the menu bar to save the information that you entered before you click Backup, Restore or Schedule Backup in the following steps. If you do not save the information that you entered, the software will use the information that was previously entered and saved in this file instead of the information that you just entered.

Step 5 Click Backup to immediately initiate the action of backing up the currently running configuration of a Cisco DSLAM.

Step 6 Click Restore to immediately initiate the action of restoring the currently running configuration to a Cisco DSLAM.

Step 7 Click Schedule Backup to schedule a later date and time for the backup to take place.

If you click Schedule Backup, the Schedule Dialog dialog box opens, which is shown in Figure 6-4.

Figure 6-4: Schedule Dialog Box

Step 8 Enter the date (mm/dd/yyyy) and time (24-hour format, for example, 4:00 p.m. is 16:00) that you want the system to perform the backup.

Step 9 Click OK to save the new date and time.

Downloading a Cisco IOS Software Image

When Cisco releases a new version of Cisco IOS, you can download the new version of the software onto a DSLAM chassis. From the IOS Image Download window, you define the parameters to maintain the most current Cisco IOS software on the DSLAM chassis in your network.

Note Before you download a new Cisco IOS software image you must configure the SNMP information. To verify whether the SNMP information is configured, open the SNMP Management window (see the "Enabling SNMP Trap Generation" section).

To download a new Cisco IOS software image, follow these steps:

Step 1 From the Map Viewer window, within the CDM Manager view, right-click a chassis to access the object menu.

Step 2 Choose Cisco DSL Manager > Physical > Chassis > IOS Image Download.

The IOS Image Download window opens, which is shown in Figure 6-5.

Figure 6-5: IOS Image Download Window

Step 3 From the list box on the left side of the window, select the chassis for which you want to perform a Cisco IOS download.

Step 4 Configure the Cisco IOS image download values as follows:

a. In the TFTP Server IP Address field, enter the IP address of the TFTP server that contains the Cisco IOS image software you want to download.

b. In the Destination File System field, enter the destination file system name; valid values are Bootflash or Flash.

c. In the Source File Name field, enter the name of the source file; you can specify the Cisco IOS image download source file name.

d. In the Destination File Name field, enter the name of the destination file.

: You can specify the name for the file as it is stored in the file system of CDM.

e. In the Format the destination device before copying? field, click the diamond if you want to erase the software on the chassis before the new software is downloaded.

f. In the Reset device using new image? field, click the diamond if you want to reset the chassis to start using the new software.

: The Last download operation field is Display only. This fields displays the date and time of the last download.

Note At this time, you must choose File > Save from the menu bar to save the information that you have entered before you click Download or Schedule Download. If you do not save the information that you have entered, the software returns an error message when you attempt to download or schedule a download.

Step 5 Click Schedule Download to schedule the download to be performed at a later time.

Step 6 Click Download to perform the download immediately.

When you click Schedule Download, the Schedule Dialog dialog box opens, which is shown in Figure 6-6.

Figure 6-6: Cisco IOS Download—Schedule Dialog

Step 7 Enter the date (mm/dd/yyyy) and time (24-hour format, for example, 4:00 p.m. is 16:00) you want the system to perform the download, then click OK.

Table of Contents