Table of Contents

Getting Started

Cisco Cable Manager Release 2.0 (CCM) runs as part of the Cisco Element Management Framework (Cisco EMF). This chapter contains the following sections:

Getting Started with CCM

Once you have installed Cisco EMF and CCM, you can:

Starting Cisco EMF and CCM

To start the CCM server, use the Cisco EMF start command. From the CEMF_INSTALL_DIR/bin directory, enter the following command:

./cemf start

Stopping CCM

If you want to stop CCM and its associated processes, use the command:

./cemf stop

Accessing CCM

Note   If you are using a display session, be sure to set the display environment variable correctly. If not configured correctly, the X session software may truncate icons or cause other display anomalies. To solve this problem, either use the XDMCP option to log in to the Solaris desktop or to change the X session settings. Also, you may need to reset color and keyboard map settings.

./cemf session

Step 2   Enter a valid user name and password:

The Cisco Element Manager Framework launch pad appears.

Note   You can use the Cisco EMF User tool to change the default passwords.

See the Cisco EMF documentation for details about changing default passwords and adding new user accounts.

Resetting the Database

You can reset the database to clear out all currently mapped objects from the GUI, for example when you move from a laboratory to a production environment and you want to delete all routers and cable modems. When you reset the Cisco EMF database for CCM, all the existing data in the database is deleted.

Follow these steps:

./cemf stop

Step 2   Enter:

./cemf reset

Step 3   Enter:

./cemf start

Note   Refer to the Cisco EMF documentation for more information on resetting the database.

Creating Containment Objects

The first step in managing a device is to create Cisco EMF management containment objects; then, you can add device objects and their constituents to the containment object.

These are CCM containment objects:

CCM device objects:

Creating a Containment Object

Step 2   In the object tree, select the Physical containment level.

Step 3   From the right-click menu, choose Deployment > Deploy Generic Objects.

The Deployment Wizard - Templates dialog box appears.

Step 4   Select a site; then, click Forward.

Step 5   Enter the number of sites and name each site; then, click Forward.

Step 6   Select the position of the object in the Physical containment view; then, select the position of the object in the genericObjects containment view and click Forward.

The Deployment Wizard - Summary dialog box appears.

Step 7   Click Finish. The containment object appears in the Object Tree.

Configuring LDAP

The LDAP server typically contains subscriber-specific information that is used when provisioning cable modems. Cisco Cable Manager links its collected device information with the subscriber information using the LDAP interface. See "LDAP Schema" for the LDAP schema used by CCM2.0.

Note   If you stop and restart Cisco EMF, you must launch LDAP again.

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a site where you plan to configure LDAP. You can also select this option at the uBR level.

Step 4   Right click and choose:

Manual Discovery > LDAP and Spec File Configuration.

The LDAP and Spec File Configuration dialog box appears.

Step 5   In the LDAP and Spec File Configuration dialog box, enter:

Step 6   Click Connect to LDAP Server.

LDAP is now configured.

Discovering Objects and Devices

In Cisco EMF, you can deploy actual or soon-to-be installed hardware devices. After you add containment objects and device objects to the network, they must be discovered and managed by the system. You can use the following methods to discover objects:

The following components will be displayed when you run manual discovery or autodiscovery:

A uBR or cable modem will not be discovered under the following conditions:

Task 1: Modifying the AutoDiscoveryConfig.spec File

You must set the IP addresses for all cable modems for a specific uBR when using the autodiscovery function to discover objects. Modify the AutoDiscoveryConfig.spec file before you add a uBR. The community strings are preset to defaults. If you are installing cable modems using the default community string values, just edit the IP address.

Note   This file is used for initial deployment only.

The entry for each uBR has the following format:

where 0.0.0.0 is the IP address of the specified uBR and private and public are the default community string values for that uBR.

Note   The CM_READ_COMMUNITY and CM_WRITE_COMMUNITY values apply to all the cable modems registered on the specified uBR. The UBR_WRITE_COMMUNITY value applies to the primary uBR, and the SECONDARY_IP_ADRESS value applies to the redundant uBR, if any. If there is no redundant uBR, you must enter 0.0.0.0 for that value.

If you maintain unique community strings for a specific uBR, for security reasons, you must also edit the community string values.

Note   A secondary IP address is required for the rehoming/redundancy function to work.

Step 2   Save the file.

Step 3   Select a Site object. From the right-click menu, choose

Manual Discovery > LDAP and Spec File Configuration

The LDAP and Spec File Configuration dialog box appears.

Step 4   Click Re-Parse Discovery Spec Files.

Using Autodiscovery to Discover Objects and Devices

Autodiscovery locates devices already physically installed on the network by using the IP address range of the Cisco uBR7200 series universal broadband router and automatically deploying the devices as Cisco EMF objects in the Cisco EMF Object Tree. Object devices are discovered to the cable modem level.

To discover objects and devices, you can run the Discovery process described in the Cisco EMF documentation.

Note   Before running the autodiscovery process, ensure that sufficient system resources are available. For large networks, the autodiscovery process can take several hours—depending on the size of the network.

Step 2   From the Cisco EMF launch pad, click Viewer.

The Map Viewer dialog box appears.

Step 3   Double-click the Physical containment level and expand the object tree.

Step 4   Select a site. From the right-click menu, choose:

Deployment > Autodiscovery

The Discover Network Devices dialog box appears.

Step 5   Enter the following information:

Step 6   Change the interface attributes to specify the range for autodiscovery.

Note   If the SNMP read community strings do not match, CCM cannot discover the Cisco uBR7200 series universal broadband routers. You can set the individual community strings by using the Cisco EMF Object Configuration menu command.

Caution   Currently only SNMP is supported for autodiscovery.

Manually Adding a uBR to the Network

You can manually discover devices in CCM before the device is actually present on the network. You can add individual Cisco uBR7200 series universal broadband routers, cable modems, and associated device objects—without running the autodiscovery process.

To manually add a uBR to the network, follow these tasks:

Task 1: Manually Add a uBR to the Network

Task 2: Manually Discover or Rediscover uBRs and Constituents

Note   You must set the associated or secondary uBR IP addresses during deployment. If the associated uBR IP addresses are not set during deployment, delete the uBR object, and redeploy it with the correct associated uBR IP address; otherwise, rehoming is not possible.

Task 1: Manually Adding a uBR to the Network

Step 2   Right-click and choose Deployment > Deploy Cable Router.

The Deployment Wizard - Object Parameters screen appears.

Step 3   Enter the number of objects to be added and click Forward.

Step 4   Enter the:

Step 5   Click Forward.

The Deployment Summary screen appears.

Step 6   Click Finish.

Your objects appear in the Object Tree of the Map Viewer dialog box.

Task 2: Manually Discovering a uBR

Use the manual uBR discovery dialog box to discover or re-discover the constituents of a uBR.

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a uBR

or

select from the site:

Step 4   From the right-click menu, choose:

Manual uBR/Modem Discovery

The Discovery dialog box appears.

Step 5   To discover the uBR CMTS constituents, click Discover uBR.

When the Action Report dialog box appears, discovery has started. An informational alarm is raised against the uBR when discovery is complete.

Note   The Manual uBR Discovery process discovers the uBR and all its constituents. A status of "ready to discover" means discovery has not yet occurred. A status of "idle" indicates the Cisco uBR7200 series universal broadband router and its constituents has finished discovering.

Step 6   (Optional) You can verify the status of the autodiscovery process by accessing the ubrController.log file in: ${CEMF_INSTALL_DIR_LOGS} {CEMF_INSTALL_DIR/logs}.

Manually Discovering a Cable Modem

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a uBR.

Step 4   From the right-click menu, choose:

Manual uBR/Modem Discovery

The Discovery dialog box appears.

Step 5   In the cable modem discovery area, enter:

Step 6   To start the discovery process, click Discover Modems.

Updating SNMP Community Strings for uBR and Cable Modems

Updating uBR SNMP Community Strings

Use only when the device string has changed, to synchronize CCM with the device.

Configuration menu > Update uBR SNMP Community strings

Step 2   Enter the uBR read and write community strings.

Note   Enter only new community strings. If any of the strings are unchanged, leave that string unchanged.

Step 3   From the list box, click on Single select (if updating community strings on one uBR) or Multi select (if updating strings which apply to multiple uBRs).

Step 4   Click Apply.

Updating Cable Modem SNMP Community Strings

Updating SNMP Community Strings for All Cable Modems Under a uBR Object

Use only when the device string has changed, to synchronize CCM with the device.

Configuration menu > Update Modems SNMP Community strings.

Step 2   Enter the cable modem read and write community strings.

Note   Enter only new community strings. If any of the strings are unchanged, leave that string unchanged.

Step 3   Click Apply.

Updating SNMP Community Strings for All Cable Modems Under a Cell Object

Use only when the device string has changed, to synchronize CCM with the device.

Configuration menu > Update Modem SNMP Community strings.

Step 2   Enter the cable modem read and write community strings.

Note   Enter only new community strings. If any of the strings are unchanged, leave that string unchanged.

Step 3   From the list box, click on Single select (if updating community strings on one cable modem) or Multi select (if updating strings which apply to multiple cable modems)

Step 4   Click Apply.

Configuring SNMP Traps

Cisco Cable Manager 2.0 provides the trap-based discovery feature, which facilitates deploying cable modems automatically in the Modem OnLine/OffLIne Trap menu. The traps generated by the devices are shown in the form of alarms in Map Viewer.

For further details, please see "Enabling and Configuring SNMP Traps" section.

Trap-based Discovery

Cisco Cable Manager 2.0 can create or update cable modem attributes upon receipt of online/offline traps, which are generated by the uBR for each cable modem status change from offline to online or online to offline. To use this feature, you need to configure SNMP traps.

For further details, please see "Enabling and Configuring SNMP Traps" section.

Rediscovery and Periodic Discovery of Cable Modems

Cisco Cable Manager (CCM) can automatically create or update cable modem attributes by polling each uBR periodically. Polling of uBRs occurs every 15 minutes, while cable modem polling occurs every 24 hours. CCM generates an informational alarm to notify completion of periodic discovery.

Note   Discovery takes place only when entLastChangeTime changes. If nothing changes on a device, no periodic discovery will occur.

Commissioning and Decommissioning Devices

After a device object is added and discovered, the device object usually appears in a normal state. With CCM, you can add device objects to be managed (commissioned) and remove device objects from being managed (decommissioned). When a device is decommissioned, polling and trap functionality stops.

Note   Decommission object devices before inserting or removing cards. Decommissioning a uBR prevents it from raising any unwanted traps.

You can commission or decommission a single Cisco uBR7200 series universal broadband router and all the associated cable modems

You can commission (but not decommission) cable modems and their connections to the router. Single RF line cards and single port adapters can be neither commissioned nor decommissioned.

Note   You can commission all the objects except cable modems under a Cisco uBR7200 series universal broadband router by decommissioning the router and then recommissioning it.

Caution   If you plan to remove a card, decommission the chassis to keep from overloading the system with raised traps. Once you add the card, recommission the device.

Commissioning and Decommissioning a Device

Step 2   From the right-click menu, choose:

Manual Discovery >uBR Commission/Decommission.

The Open Commission/Decommission dialog box appears.

Step 3   Choose one of the following commands:

Using Performance Polling

Use performance polling to collect required data for performance reports. The data that is polled is organized in polling groups. Each polling group has a set of related attributes.

The following polling groups are polled from the uBRs:

The following polling groups are polled directly from the cable modems:

By default, performance polling is disabled for the newly added or discovered objects.

Each uBR polling group can be associated with one of four pollers available. You can change the polling frequency. You can choose the polling groups to be polled as well as the poll interval.

You can start/stop polling at the site level to do start/stop polling for all uBRs and/or cable modems under the site. You can also start/stop uBR polling for cable modems, multiple uBRs, and multiple cable modems.

Table 3-1 shows the recommended polling configuration for up to 25 uBRs with 2000 modems per uBR.

Configuring Performance Polling

Note   When you specify configurations, they are global and serve as the polling parameters for all polled objects. Any change that you make affects all sites, uBRs, and cable modems.

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a site.

Step 4   Right-click and choose:

Performance Polling > Polling Group and Rate Configuration.

The Polling Configuration Dialog box appears.

Step 5   To change the frequency of a uBR poller group, click the Table to Poller Assignment tab and find the uBR poller group name.

Step 6   In the row containing the poller group name, click the Poller Name pull-down menu and select a poller:

Step 7   To change the polling configuration default settings:

Step 8   To save your changes, choose File >Save.

Starting or Stopping Performance Polling on a uBR

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a uBR.

Step 4   From the right-click menu, choose:

Performance Polling > Start/Stop uBR/CM Polling.

The Start/Stop uBR/CM Polling dialog box appears.

Step 5   To start or stop uBR polling:

Tip When polling is started, the Current State appears as perfPolling. When polling is stopped, the Current State appears as Normal.

Starting or Stopping Cable Modem Performance Polling at the Cable Modem Level

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a cable modem or multiple cable modems.

Step 4   From the right-click menu, choose:

Performance Polling > Start/Stop CM Polling

The Start/Stop CM Polling dialog box appears.

Step 5   To start polling on a cable modem, from the Cable Modem Polling area, click Start Polling.

or

To stop polling on a cable modem, from the Cable Modem Polling area, click Stop Polling.

Tip When polling is started, the Current State appears as perfPolling. When polling is stopped, the Current State appears as Normal.

Starting or Stopping Cable Modem Performance Polling for All Modems under Selected uBRs

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a Site or a uBR

Step 4   From the right-click menu, select:

Performance Polling > Start/Stop uBR/CM Performance Polling

The Start/Stop uBR/CM Performance Polling dialog box appears.

Step 5   To start or stop polling on all cable modem under selected uBRs, select one of the following buttons:

Tip When polling is started, the Current State appears as AllCMsperfPolling. When polling is stopped, the Current State appears as AllCMsNotPolling.

Starting Applications Bundled with CCM

Cisco Cable Manager Release 2.0 (CCM) is packaged with the following applications:

Starting CiscoView

Use CiscoView to monitor the performance and connections of your network.

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a device.

Step 4   From the right-click menu, choose Tools > CiscoView.

The CiscoView application window appears.

Note   If you are using non-default passwords (anything other than public or private), Cable Manager will not automatically update CiscoView passwords. You must manually change the password in CiscoView>Options>Properties.

Starting Cisco Cable Troubleshooter

Before installing Cisco Cable Troubleshooter (CCT), read the Readme file for additional information. CCT patch 1.3 is bundled with CCM 2.0 and includes wireless support.

Step 2   From the Cisco EMF launch pad, click Viewer.

The Map Viewer dialog box appears.

Step 3   Double-click the Physical containment level and expand the object tree.

Step 4   Select a CMTS object at the site or uBR level.

Step 5   From the right-click menu, choose Tools > Cisco Cable Troubleshooter.

The Cisco Cable Troubleshooter application window appears.

Starting the DOCSIS Configuration Editor

Use the Configuration Editor to edit the Data-over-Cable Service Interface Specifications (DOCSIS) configuration file and generate the appropriate message integrity check.

The Map Viewer dialog box appears.

Step 2   Double-click the Physical containment level and expand the object tree.

Step 3   Select a site.

Step 4   From the right-click menu, choose:

Tools > DOCSIS Config Editor.

Step 5   Edit the DOCSIS configuration file.