cc/td/doc/product/rtrmgmt/cdm/cdm30
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

CDM Software Overview

CDM Software Overview

This chapter provides a general overview of the concepts used in the network and service management software for the Cisco Digital Subscriber Line Access Multiplexers (DSLAMs). The software consists of two applications:


Note This guide deals mainly with the CDM portion of the software. Refer to the Cisco Element Management Framework User Guide for detailed information about Cisco EMF software.

Cisco Element Manager Framework Software

Cisco EMF is required to run CDM. Cisco EMF provides the commands, icons, and menus that access the services available in CDM software. Using CDM software, you can configure the Cisco equipment that you want to manage on your network. Combined, Cisco EMF and CDM software provide you with a visual representation of the Cisco equipment on your network.

To run CDM, you must first start a Cisco EMF session. When you launch Cisco EMF, the system automatically launches CDM. You access all CDM information through Cisco EMF.


Note All users have access to the tools available in Cisco EMF. Not all users have access to the CDM software. The system administrator can restrict user access to the CDM software. When you log into Cisco EMF software, your access to the system is determined by your user name and password.

Cisco Digital Subscriber Line Manager Software

CDM is an element manager (plug-in module) for Cisco EMF. You can have a variety of element managers plugged into a single Cisco EMF application. For example, from one Cisco EMF application, you can monitor and manage the objects of a Cisco 6160, Cisco 6130, and Cisco 6260 DSLAM.

The CDM element manager is designed for network managers who are responsible for performing the following tasks:

Creating and Managing Database Files

From CDM, you can add elements (Cisco 6160 chassis) and objects (NI-2 cards and line cards) to the database, modify and delete configuration information, and update system software without disrupting traffic on the network. When you modify, delete, or add configuration information in CDM, the system sends the changes to the managed DSLAM.

In CDM software, you can use three methods to configure DSLAM objects:

The Cisco EMF and CDM applications exchange configuration data between the client workstations and the server:

Maintaining System Performance

A system log (Syslog) and event log (EventLog) are stored on the DSLAM and can be viewed from CDM. These files log all CLI (command line interface) commands received by the DSLAM and all events affecting the device.

Additionally, CDM keeps an audit log for transactions performed by users. This log reports affected attribute, time, date, and value changes. These changes are stored in the /opt/cemf/logs directory as .audit files and are stored by CDM.

Each CDM process has a log file that stores process-generated messages. The log files are stored in the /opt/cemf/logs directory as .log and .old files.

Viewing the System Log File

You can view or print system log information from 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 are alarms or loss of traffic.

You can select a severity range for the events you want to view. The Debug severity level is the least severe type of message generated by the system, and Emergency 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 you want to view, or you can select a range of severity levels.

Refer to the "Viewing the System Log File" section for more information regarding the system log file.

Viewing the Command History File

Each time you make 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 event occurred, name of the logged-in user, the internet address of the requested system or requester, and more.

Refer to the "Viewing the Command History File" section for more information regarding the command history file.

Configuring or Querying Network Components

Using CDM software, you can query or configure the components on the network. These components can be managed at different levels, and assume a hierarchy: a DSLAM chassis contains cards, and cards contain interfaces (ports). You can configure all three components.

For network management, the state (the availability of service) of the components also assume a hierarchy: The lower level objects inherit the state of the chassis or card with which they are associated. For example, if you or the system decommission:

Figure 2-1 shows the hierarchy of the components, as well as how the state of each component affects the availability of its associated component. In this figure, it is assumed that the chassis and lower level objects are deployed.


Figure 2-1: Management Availability for Network Objects


State Types

The operational state of a selected component appears in the status bar, at the bottom left corner of each window. The state of each component directly affects the operations you can perform on that component. By default, the window refreshes every 10 seconds and displays updated states.

The following sections provide a general overview of the states available in CDM software.

Normal State

In the Normal state, CDM polls the network to detect the presence of objects. When an object enters the Normal state, CDM polls the object every 60 seconds to determine if that object is present. An object is placed in the Normal state when you click the Commission button on that object. (When you commission an object, you are requesting that the system place that object in the Normal state.)

When an object is in the Normal state, it can be actively managed on the network.

Performance Logging State

When you start performance logging on an object, the state of that object changes from Normal to Performanceloggingon. The Performanceloggingon state indicates that the selected card or interface has performance logging enabled. When you enable performance logging, the system collects performance data on the object. You can view the data in the Performance windows or right-click an object from the list box, and then select Tools > Performance Manager.

When an object is in the Performanceloggingon state, it can be actively managed on the network.

Errored State

If the state is Errored, none of the displayed values can be queried. For example, if the system cannot contact a chassis, the software changes the state of the chassis to Errored.

Decommissioned State

When you want to replace an existing card, or perform any kind of maintenance work on an object, you should first decommission that object.

When you decommission an object, the following events occur:

Decommission buttons are located in certain windows, depending on the type of object you selected. When you decommission an object, the system changes the state of all associated objects to Decommissioned. However, you cannot decommission interfaces (for example, OC-3 or DS3 type ports on the cards).

Preprovisioned State

Preprovisioning is the process of reserving and configuring a space in the system for objects which have not yet been physically installed in the network. When you preprovision a chassis, the information is stored in the Cisco EMF/CDM software in a Decommissioned state. When you preprovision subscribers or line cards, the information is stored on the NI-2 card of the DSLAM and is reflected in the software as being in a Preprovisioned state. Line cards in a DSLAM chassis can exist in a Preprovisioned state, but CDM does not monitor its status.

When the cards are physically inserted in a card slot in the chassis, subscribers and line card configuration are immediately loaded into that line card. The software automatically detects the existence of the cards and moves the cards into the Normal state. However, you can manually move a line card from the Preprovisioned state to the Normal state by clicking the Commission button.

Auto Discovering Objects

Auto Discovery detects any Cisco DSLAMs, with either IP or SNMP identifiers. When you activate the Auto Discovery function, the system detects a chassis and it creates a chassis object. When the system detects a chassis, an object representing a chassis is created and placed under the path selected in the Auto Discovery window (under Use Physical Path). A map of the chassis is also created.

Auto Discovery can discover objects on more than one subnetwork by using multi-hop discovery. You can schedule multi-hop discovery to run at preset times (the Cisco Element Management Framework User Guide details how to set the schedules). You can also specify the physical location under which you want the discovered objects created.

The Auto Discovery application discovers devices through one of three different mechanisms:

Refer to the Cisco Element Management Framework User Guide or Cisco Digital Subscriber Line Manager User Guide for detailed information on using Auto Discovery.

Navigating in CDM Software

CDM software uses familiar functionality and menus found in most UNIX-based graphical user interface products. This section describes the functions available in CDM software.

Keyboard Commands

Certain keyboard commands are available in CDM. These commands serve as an alternative to mouse functionality. Table 2-1 shows the available keyboard commands and their descriptions.


Table 2-1: CDM Keyboard Commands
Keyboard Command Description

Tab

Move among the fields in a window.

Arrow keys

Scroll through the text in a data entry field or through the values of a list box.

Alt key

Access a menu by typing the appropriate keyboard command. For example, to access the File menu using a keyboard command, simultaneously press the Alt and F keys.

Right Mouse Button

Cisco EMF and CDM software provide right-click mouse functionality. Position the cursor over a map object, an event listed in the Event Browser, or any object, and then click the right mouse button to view the menu options available for that object. You can then use the left or right mouse button to select the option you want to view, modify, or configure.

Menu Options

The menu is located at the top of each window (Figure 2-2). To access a menu option, click the preferred menu item and then select an option. You can also access a menu by typing the appropriate keyboard command. For example, to access the File menu with a keyboard command, simultaneously press the Alt and F keys.


Note The menu options in CDM software vary depending on the window in which you are viewing or configuring information. In addition, if a menu option is dimmed, the option does not apply to the active window (the window you are currently viewing or configuring).


Figure 2-2: CDM Window Elements Example


The menus available in CDM software are described in the following sections.

File Menu

The File menu contains common operations such as Print, Save, and Close.

Edit Menu

The Edit menu contains operations such as Copy Configuration, Copy Page Configuration, and Paste and Save Configuration. You can copy the configuration from one window and paste it into a different window to minimize duplicate data entry.

View Menu

The View menu (Figure 2-3) is accessible in the map viewer view. This menu lets you open map views from within a map view, view text descriptions of the object you are viewing, and sort the contents of the object list box by class or name.


Figure 2-3: View Menu Options


Options Menu

The Options menu (Figure 2-4) lets you update configuration changes manually or set the system to automatically update all configuration changes. You can also view or hide the toolbar, and enable or disable tooltips.


Figure 2-4: Options Menu Options


The default color for text in a window is black. However, if a change occurs to the window you are viewing, the text changes to blue.
For example, in the Module Fault Management window, the system automatically adjusts the time in the Up Time field to correspond to the amount of time the system has been monitoring the card. When the time changes, the data is displayed in blue. If you select the Acknowledge Change option, the text returns to the color black.

Window Menu

The Window menu lists all windows that are open in CDM, with the exception of the active window. You can make a non active window active by selecting it from the list.

Navigation Menu

Not supported in this release.

Actions Menu

The options in the Actions menu mirror the command buttons that appear in an active window. For example, if the active window displays a Commission and Decommission command button, then the Actions menu options are Commission and Decommission.

Help Menu

The Help and Icon Information options provide an online guide to CDM.


Note The first time you select the About option, a Netscape license agreement window appears. Click the Accept button and the About Cisco EMF window appears (Figure 2-5).

By default, Netscape software is automatically downloaded when you install Cisco EMF software. The Cisco EMF/CDM Help system uses Netscape tools such as the search engine.


Figure 2-5:
About Cisco EMF Window


Tabs

Subwindows within a window are separated by tabs (see Figure 2-2). Tabs separate similar information when more information is required than can fit in a single window.

Toolbar

A toolbar (see Figure 2-2) contains icons (tools), and provides quick access to commands used throughout CDM software. The toolbar is located directly below the menu. The toolbar allows you to perform common functions such as close, print, save, update, and so forth. Additional tools allow you to access detailed information regarding a selection in the active window; the window you are currently viewing or configuring.

Tools to which you have access depend on the active window. If a tool is dimmed, it is not accessible from the active window. You can disable the toolbar so that it does not appear in the window.

To enable and disable the toolbar, select Options > Show Toolbar.

To choose a tool from the toolbar, click once on the tool.

For a description of a tool, pause the pointer over the tool on the toolbar. A tooltip appears that describes the use of the tool.

Text Field Data Entry

To enter data in text fields, type directly in the field. Some text fields also provide a list box from which you can select valid options.

List Box Entry

Most fields provide a list box (see Figure 2-2) from which you can select information. To select an option from a list box, click the drop-down arrow to display valid options. Click the desired option, and it appears in the field.

Command Buttons

Command buttons are provided in windows from which you can configure or update information. The command buttons available depend on the window you are viewing or configuring.

For example, if you want to commission a chassis, select the chassis and navigate to the Configuration window. Select the objects you want to commission from the list boxes, and then click the Commission command button.

Status Bar

CDM software displays a status bar (Figure 2-6) from which you can view system or network information in real time. The system automatically updates the information in the status bar as you navigate through the software or modify configuration parameters.


Figure 2-6: Status Bar Sample


Displaying Objects in CDM

The Cisco EMF/CDM graphical user interface allows you to navigate the software by means of visual images. To view or configure objects on your network, you should use the cdmManager option (Figure 2-7) in the left hierarchical pane.

When you select an object (chassis, card, or interface) from the cdmManager list, a visual image of the object is displayed in the right side of the window.

Figure 2-7 shows an example of a Cisco 6160 chassis image after you select the chassis from the hierarchical list on the left side of the window.


Figure 2-7: Cisco 6160 Chassis View


To view or configure objects in CDM, follow these steps.


Step 1 Click the Viewer icon in the Cisco Element Manager Framework Launchpad window.

The Map Viewer window appears.

Step 2 Expand the hierarchy on the left side of the window and select a chassis.

A visual image of the chassis appears in the right side of the window (see Figure 2-7).

Step 3 You can continue to expand the hierarchy and right-click an object, or right-click an object (NI-2 card or line card) in the chassis image, to display the menu options available for the selected object.

Figure 2-8 shows a sample object menu.


Figure 2-8: CDM Object Menu


Step 4 Select an option from the menu to view or configure the object on the network.



hometocprevnextglossaryfeedbacksearchhelp
Posted: Sat Jul 29 06:51:16 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.