|
|
This chapter provides a general overview for using the Cisco Digital Subscriber Line Manager (CDM) software to manage Cisco Digital Subscriber Line Access Multiplexers (DSLAMs).
The software consists of two applications:
 |
Note For more detailed information about using Cisco EMF, refer to the Cisco Element Management Framework User Guide. |
This chapter includes the following sections:
You must install Cisco EMF before you can run CDM. The Cisco EMF interface provides the commands, icons, and menus through which you access the CDM application services. Using CDM, you can configure the Cisco equipment that you want to manage on your network. Cisco EMF and CDM combined provide you with a graphical representation of the Cisco equipment on your network.
To run CDM, you must first start a Cisco EMF session. When you launch Cisco EMF, CDM automatically launches as well. You access all CDM information through the Cisco EMF interface.
|
Note All users have access to the tools that are 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, 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 Cisco EMF application, you can monitor and manage the objects of a Cisco 6015, Cisco 6100/6130, Cisco 6160, and Cisco 6260 chassis.
The CDM element manager is designed for network managers who are responsible for performing the following tasks:
From CDM, you can add elements, such as the Cisco 6015 chassis, and objects, such as NI-2 cards and line cards, to the database. You can 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 as follows:
The software stores a system log file (Syslog) and an event log file (EventLog) on the DSLAM that you can view from CDM. These files log all command line interface (CLI) commands that the DSLAM receives and all events that affect the device.
Additionally, CDM keeps an audit log for transactions that users make. 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 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 about the system log file.
Each time you change a component configuration 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 occurs, the name of the logged-in user, the internet address of the requested system or requester, and other information.
Refer to the "Using the Command Log Window" section for more information regarding the command history file.
For network management, the state of the components also assume a hierarchy—The lower level objects inherit the state, the availability of service, and the chassis or card with which they are associated.
For example, if you or the system decommission a chassis, all cards and interfaces associated with that chassis become unavailable. If you or the system decommission a card, all interfaces associated with that card become unavailable.
Figure 2-1 shows the hierarchy of the network components, as well as how the state of each component affects the availability of its associated component. In this diagram, assume that the chassis and lower level objects are deployed.
The operational state of a selected component displays 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 describe the states that are 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 whether the 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.
An object that is in the Normal state can be actively managed on the network.
When you start performance logging on an object, the state of that object changes from Normal to Performance logging on. The Performance logging on 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.
See "Viewing Current and Historical Performance Data," and "Viewing Historical Performance Data," for more information about viewing performance data in the Performance windows.
If an object state is Errored, you are unable to query any of the displayed values. 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 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 select. 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 types of ports on the cards).
Preprovisioning is the process of reserving and configuring a space in the system for objects that are not yet physically installed in the network. When you preprovision a chassis, the information is stored in Cisco EMF and 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 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 their status.
When you physically insert cards 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.
The autodiscovery process detects any Cisco DSLAMs with either IP or SNMP identifiers. When you activate the autodiscovery function, the system detects a chassis and creates a chassis object. When the software detects a chassis, it creates an object that represents a chassis and places it below the path that you specify in the Use Physical Path field on the Autodiscovery window. The software also creates a map of the chassis.
Autodiscovery can detect objects on more than one subnetwork by using multihop discovery. You can specify the physical location under which you want the software to create the discovered objects. You can also schedule multihop discovery to run at preset times. (Refer to the Cisco Element Management Framework User Guide for instructions on setting the schedules.)
Autodiscovery detects the presence of devices through the following processes:
Refer to the Cisco Element Management Framework User Guide or Cisco Digital Subscriber Line Manager User Guide for detailed information on using autodiscovery.
The Cisco EMF Launchpad window, which is shown in Figure 2-2, is the first window that opens after you successfully log in to Cisco EMF. Throughout this guide, the Cisco EMF Launchpad window is referred to as the Launchpad.
The icons that display in the Launchpad represent access to applications that are available with the standard Cisco EMF installation. Additional icons display if you install additional applications. Two ways to launch the application include:
|
Note The first time you access the Launchpad, you might be unable to launch an application by clicking an icon if your console is not set up to display sufficient colors. If so, a dialog box may be located behind the Launchpad window. Move the Launchpad window until you see a dialog box with the following warning message, "There are insufficient colors available for CEMF client. Some applications may not display information correctly." In the warning dialog box, click OK. You can now launch an application. |
Figure 2-2 shows the standard Cisco EMF application icons, which are described in the following sections.
The Viewer icon, shown in Figure 2-3, opens the Cisco EMF Viewer window, through which you can view, build, and monitor your network by using graphical representations of network elements.
Click the Viewer icon to launch the Map Viewer window, from which you run CDM; in other words, the Viewer icon is the primary entry point into CDM. When you open the Map Viewer window, you can monitor the status of all network elements or abstractions of elements that the network contains; you can launch any additional applications from the Launchpad.
Click the Groups icon, shown in Figure 2-4, to launch the Cisco EMF Object Group Manager window. You can also select Groups from an object menu when using other Cisco EMF applications.
You can use the Cisco EMF Object Group Manager, called Groups, to organize network elements into object groups.
Click the Access icon, shown in Figure 2-5, to open the Cisco EMF User Access Control manager window.
The Cisco EMF User Access Control feature allows system administrators to control user access to specific features of their system. Access control is important for security as well as efficient and effective network management.
The Events icon, shown in Figure 2-6, opens a Query Editor window, from which you can specify alarm and event severity for monitoring alarms and events that occur within the system. These events display in the Event Browser window. See "Viewing Alarms and Events," for more information about using the Event Browser window.
In Cisco EMF, when a condition or fault occurs on a managed object in the network, the system receives immediate notification. Being able to identify system events and quickly resolve them is one of the most important aspects of network service management. For example, a power supply fault in a chassis might require a field service call. This fault is critical and would need prompt attention.
The Discovery icon, shown in Figure 2-7, opens the Cisco EMF Auto Discovery window. You can click this icon or you can select Discovery from an object menu to begin the autodiscovery process.
The Cisco EMF autodiscovery feature allows you to survey the network for IP and SNMP devices and create a managed object for each new device that it discovers. You can access Auto Discovery from the Cisco EMF Launchpad window or from an object menu.
CDM uses familiar functionality and menus that are found in most UNIX-based GUI products. This section describes the functions that are 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, simultaneously press the Alt and F keys. |
Cisco EMF and CDM provide right-click mouse functionality. Position the cursor over an object or an event listed in the Event Browser, and then right-click to view the menu options available for that object. This menu is referred to as the object menu throughout this guide. Once you access the object menu, you can use either mouse button to select the option you want.
The menu bar is located at the top of each window, as shown in Figure 2-8. To access the menu choices, click the preferred menu from the menu bar to display the menu choices for that menu. You can also access a menu by entering 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 choices in CDM vary depending on the window from 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 CDM menus are described in the following sections.
The File menu contains choices for common operations such as Print, Save, and Close.
The View menu, which is shown in Figure 2-9, is accessible in the Map Viewer window. You can use the View menu to 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 View menu choices are described in Table 2-2.
| Menu Choice | Description |
|---|---|
Open Parent Map | Open a parent map if you are viewing a window for an associated object. For example, if you are viewing a chassis (from the Map Viewer cdmManager location), you can select Open Parent Map to view the site map to which the chassis is associated. Or if you are viewing a line card, you can select the Open Parent Map option to view the chassis to which the line card is associated. |
View Map Description | View the contents of the window in text format. For example, if you are viewing a chassis (from the Map Viewer cdmManager location), you can select View Map Description and a Map Description Text window displays the chassis configuration in text format. |
Sort By Class | Sort the contents of the object list box, object hierarchy, by class. This means that the hierarchy is nonobject oriented—Shelf, cards, and then chassis. |
Sort By Name | Sort the contents of the object list box, object hierarchy, by name. This means that the hierarchy is object-association oriented—Shelf, chassis, and then cards. |
You can use the Options menu, which is shown in Figure 2-10, to manually update configuration changes or set the system to automatically update all configuration changes. You can also view or hide the toolbar, and enable or disable tooltips from the Options menu.
The Options menu choices are described in Table 2-3.
| Menu Choice | Description | ||
|---|---|---|---|
Dynamic Update On | Set the system to automatically update the contents of the window each time you, or another user, make a change to the configuration. If a checkbox appears to the left of the option, the option is enabled. | ||
Refresh Screen | Set the system to update the contents of the window only when you select this option. If you want the system to automatically update the contents of the window each time you, or another user, make a change to the configuration, enable the Dynamic Update On option. | ||
Acknowledge Change | Click to acknowledge changes that occur in the window you are viewing or configuring. 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 displays in blue. If you select the Acknowledge Change option, the text returns to the color black. | ||
Show Toolbar | View or hide the toolbar. If a checkbox appears to the left of the option, the toolbar is visible. If a checkbox does not appear to the left of the option, the toolbar is not visible. | ||
Enable Tooltip |
The tooltips feature is enabled by default. When enabled, the tooltips feature displays a brief description of each icon when you place your cursor over the icon for a few seconds.
|
The Navigation menu choices are limited in this release and are dependent on which window you are in. For example, if you have the Subtend Configuration window open, the Navigation menu choices are Delete Subtend PVC and Add Subtend PVC.
The menu choices 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 button, the Actions menu options are Commission and Decommission.
The Help and Icon Information choices 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 opens, which is shown in Figure 2-11. By default, Netscape software automatically downloads when you install Cisco EMF software. Cisco EMF and CDM Help systems 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-12.
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-13.
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-13 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-13 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-14, 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-15.
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-16.
The Prompt dialog box, which is shown in Figure 2-17, issues prompts from CDM.
You can navigate through the Cisco EMF and CDM GUI by means of graphical images. To view or configure objects on your network, you should use the cdmManager option, which is shown in Figure 2-18, that is located in the left hierarchical pane of the Map Viewer window.
When you select an object such as a chassis, card, or interface from the cdmManager list, a graphical image of the object displays on the right side of the window. Figure 2-18 shows an example of a Cisco 6015 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 opens.
Step 2 Expand the hierarchy on the left side of the window and select a chassis.
|
Note To expand the hierarchy, click the "+" next to the managed element name. |
A graphical image of the chassis appears on the right side of the window, as shown in Figure 2-18. You can continue to expand the hierarchy by clicking the "+" next to the object name. You can also right-click an object, such as an NI-2 card or line card, in the chassis image on the right side of the Map Viewer window to display the menu options that are available for the selected object.
Figure 2-19 shows an example of an object menu.
Step 3 Choose an option from the menu to view or configure the object on the network.
Posted: Tue Sep 5 09:14:30 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.
