|
|
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).
This chapter includes the following sections:
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 EMF is required to run CDM. Cisco EMF provides the commands, icons, and menus that access the services available in CDM. Using CDM, you can configure the Cisco equipment that you want to manage on your network. Combined, Cisco EMF and CDM 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 CDM. The system administrator can restrict user access to CDM. When you log into Cisco EMF software, your access to the system is determined by your user name and password. |
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 EMF application, you can monitor and manage the objects of a Cisco 6130, Cisco 6160, and Cisco 6260 DSLAM.
The CDM element manager is designed for network managers who are responsible for performing the following tasks:
From CDM, you can add elements (Cisco 6130 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, 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:
A system log (Syslog) and event log (EventLog) are stored on the DSLAM and can be viewed from CDM. These files log all command line interface (CLI) 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.
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 can 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.
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 History window, you can view the details of each configuration entry, including information such as the event, the time the event occurred, the 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.
Using CDM, you can query or configure the components on the network. These components can be managed at different levels, and assume a hierarchyA DSLAM chassis contains cards, and cards contain interfaces (ports). You can configure all three components.
For network management, the state of the components also assume a hierarchyThe lower level objects inherit the state (the availability of service) of the chassis or card with which they are associated. For example, if you or the system decommission a
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, assume that the chassis and lower level objects are deployed.

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.
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.
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 Normal state, it can be actively managed on the network.
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.
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).
Preprovisioning is the process of reserving and configuring a space in the system for objects that have not yet been physically installed in the network. When you preprovision a chassis, the information is stored in Cisco EMF/CDM 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 CDM 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 the line card configuration are immediately loaded into that line card. CDM 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 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, it creates an object representing a chassis and the object is placed under the path selected in the Auto Discovery window (under Use Physical Path). The system also creates a map of the chassis.
Auto Discovery can discover objects on more than one subnetwork by using multihop discovery. You can schedule multihop 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.
Auto Discovery 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.
CDM uses familiar functionality and menus found in most UNIX-based GUI products. This section describes the functions available in CDM.
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.
| 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, press the Alt + F keys. |
Cisco EMF and CDM 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.
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, press the Alt + F keys.
![]() |
Note The menu options in CDM 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). |

The menus available in CDM are described in the following sections.
The File menu contains common operations such as Print, Save, and Close.
The View menu (Figure 2-3) is accessible from the map viewer. 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.

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.

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.
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. |

This section describes other navigational tools that you can use to perform tasks in CDM.
When you place your cursor over a CDM object within the Map Viewer window and right-click, a single menu or a set of cascading menus open to the right. An example object menu is shown in Figure 2-6.

The choices on these menus reflect the type of object from which you access the menu. Many of the tasks that you perform while using CDM are accessible through these cascading object menus.
Choosing from an object menu opens a new window of that name. For example, if you right-click over a chassis object from the left side of the Map Viewer window, you can choose Deployment > Deploy Cisco DSLAM to open the Deployment Wizard window.
In this user guide, these menus are referred to as the object menu, even though often you must navigate through several menus to find the choice you need.
Some windows have several sections that are separated by tabs. An example of tab structure is shown in Figure 2-7.

Tabs separate related information when more information is required than can fit in a single window. Some windows have only one tab, which allows for development of new features in future releases of the software.
The CDM toolbar, which is shown in Figure 2-7 and is located directly below the menu bar, contains tool icons and provides quick access to CDM commands. You can use the tools on the toobar to perform common functions such as close, print, save, update, and so forth. Additional tools allow you to access detailed information about a selection in the active window.
The tools that display in the toolbar depend on the active window. If a tool is dimmed, it is not accessible from the active window. You can also disable the toolbar so that it does not display in the window.
To enable and disable the toolbar, choose Options > Show Toolbar.
To choose a tool from the toolbar, click once on the tool.
For a description of a tool, pause your cursor over the tool on the toolbar. A tooltip appears that describes the use of the tool.
![]() |
Note In many of the CDM GUI windows, you can click the Save icon that is located on the toolbar to save any changes that you make in the window. Throughout this guide, instructions to click Save refer to clicking this Save icon on the toolbar. |
To enter data in text fields, place your cursor in the field and enter the information by using your keyboard. Some text fields also provide a down arrow from which you can select valid options.
Most windows include a list box, which is shown in Figure 2-7 in the left side of the window. From this list, you can select objects for which you want to set values on the right side of the window.
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.
CDM displays a status bar, which is shown in Figure 2-8, at the bottom of a window. You can view system or network information in real time by reading the information in this status bar. CDM automatically updates the information in the status bar as you modify configuration parameters or send data changes to the node.

Most of the interfaces in the CDM GUI are referred to as windows. However, CDM also contains several dialog boxes that provide information about the success or failure of an action, or ask you to confirm that you want to proceed with an action. These dialog boxes include the Action Report dialog box, Warning dialog box, Error dialog box, Prompt dialog box, and so forth.
The Action Report dialog box generally informs you whether CDM successfully completed an action or process. An example Action Report dialog box is shown in Figure 2-9.

The Warning dialog box issues a warning about the procedure you are about to perform; you must respond, usually by clicking OK, before CDM continues with the action. An example Warning dialog box is shown in Figure 2-10.

The Prompt dialog box, which is shown in Figure 2-11, issues prompts from CDM.

The Cisco EMF/CDM GUI 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-12) 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-12 shows an example of a Cisco 6130 chassis image after you select the chassis from the hierarchical list on the left side of the window.

To view or configure objects in CDM, follow these steps:
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-12).
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-13 shows a sample object menu.

Step 4 Select an option from the menu to view or configure the object on the network.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Tue Sep 5 09:26:04 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.