Table Of Contents

Overview

Cisco CallManager

Serviceability

Alarms

Trace

Control Center

Admin Serviceability Tool

Remote Serviceability

Cisco Secure Telnet

Show Command Line Interface

Performance Monitoring

Message Translator

CiscoWorks2000

Path Analysis Interface

System Log Management

SNMP Instrumentation

Cisco Discovery Protocol

Appendix

Definitions

Overview

---

This chapter provides an overview of Cisco CallManager Serviceability and remote serviceability and contains the following topics:

•Cisco CallManager

•Serviceability

•Alarms

•Trace

•Control Center

•Admin Serviceability Tool

•Remote Serviceability

•Cisco Secure Telnet

•Show Command Line Interface

•Performance Monitoring

•Message Translator

•CiscoWorks2000

•Path Analysis Interface

•System Log Management

•SNMP Instrumentation

•Cisco Discovery Protocol

•Appendix

•Definitions

Cisco CallManager

Cisco CallManager provides the software-based, call-processing component of the Cisco IP Telephony Solutions for the Enterprise, part of Cisco AVVID (Architecture for Voice, Video and Integrated Data).

The Cisco CallManager system extends enterprise telephony features and functions to packet telephony network devices such as IP phones, media processing devices, Voice-over-IP (VoIP) gateways, and multimedia applications. Additional data, voice, and video services such as unified messaging, multimedia conferencing, collaborative contact centers, and interactive multimedia response systems interact through Cisco CallManager open telephony application program interface (API).

The Cisco CallManager system includes a suite of integrated voice applications for performing voice conferencing and manual attendant console functions. Because of this suite of voice applications, no need exists for special-purpose, voice-processing hardware.

Supplementary and enhanced services such as hold, transfer, forward, conference, multiple-line appearances, automatic route selection, speed dial, last-number redial, and other features extend to IP phones and gateways. Because Cisco CallManager is a software application, enhancing its capabilities in production environments requires only upgrading software on the server platform.

Distribution of Cisco CallManager and all Cisco IP phones, gateways, and applications across an IP network provides a distributed, virtual telephony network. This architecture improves system availability and scalability. Call admission control ensures that voice quality of service (QoS) is maintained across a constricted WAN link and automatically diverts calls to alternate public switched telephone network (PSTN) routes when WAN bandwidth is not available.

Cisco CallManager Administration, a web-based interface to the database, provides remote device and system configuration and serviceability. This interface also provides access to HTML-based online help for users and administrators.

Serviceability

Administrators can use the Cisco CallManager Administration service tool to troubleshoot system problems. This web-based tool, Serviceability, provides the following services:

•Alarms—Saves Cisco CallManager services alarms and events for troubleshooting and provides alarm message definitions.

•Trace—Saves Cisco CallManager services trace information to various log files for troubleshooting. Administrators can configure, collect, and analyze trace information.

•Admin Serviceability Tool—Monitors real-time behavior of the components in a Cisco CallManager cluster.

•Control Center—Views status of Cisco CallManager services. Administrators use Control Center to start and stop services.

Access Serviceability from the Cisco CallManager Administration window by choosing Applications from the menu bar. Installing the Cisco CallManager software automatically installs Serviceability and makes it available.

Alarms

Administrators use Alarms to obtain the runtime status and state of the Cisco CallManager system and to take corrective action to fix detected problems. Administrators can forward alarms to a trace file for further analysis.

Administrators can send alarm information to the Win2000 event view program, the system diagnostic interface (SDI) trace library, the signal distribution layer (SDL) trace library, or the CiscoWorks2000 Syslog file.

Administrators decide what level of event information is sent to the destination file. Alarm event levels include emergency, alert, critical, error, warning, notice, informational, and debug.

See Chapter 2, "Alarms," for detailed Alarms information.

Trace

Administrators use Trace to obtain specific, detailed Cisco CallManager services information for troubleshooting system problems. Trace provides three main functions:

•Configure trace parameters

•Collect trace files

•Analyze trace data for troubleshooting problems

Use Trace Configuration to configure the trace parameters for Cisco CallManager services on any Cisco CallManager server in the cluster.

Use Trace Collection to collect trace information for any Cisco CallManager service, the time and date of the trace for that service, and the trace type for that service. Trace Collection takes the information you selected and writes it into a single file. You can display the collected results or download them to a file.

Use Trace Analysis to provide greater trace detail on an SDI or SDL trace, a device name, or an IP address for a Cisco CallManager service.

See Chapter 3, "Trace," for detailed Trace information.

Control Center

Administrators use Control Center to view the status of any service on any Cisco CallManager server in a cluster. Administrators start and stop services using Control Center.

See Chapter 4, "Control Center," for detailed Control Center information.

Admin Serviceability Tool

Administrators use the Admin Serviceability Tool to view real-time status of the components in a Cisco CallManager cluster. The Admin Serviceability Tool monitors and displays performance and device status information.

Admin Serviceability Tool provides an alert notification mechanism to ease the system administrator troubleshooting tasks. Admin Serviceability Tool monitors various aspects of the Cisco CallManager performance by periodically polling Win2000 performance counter values.

Admin Serviceability Tool discovers devices regardless of their registration status in the cluster. Admin Serviceability Tool searches on device name, IP address, or DN and monitors the status of discovered devices. Device status monitoring provides an alert notification mechanism for gateway ports and channels.

See Chapter 5, "Admin Serviceability Tool," for detailed Admin Serviceability Tool information.

Remote Serviceability

Cisco Service Engineers (CSE) use the remote serviceability tools to supplement the management and administration of your Cisco CallManager system. Using these tools, CSEs gather system and debug information when remote troubleshooting or diagnostic help is needed.

With customer permission, technical support engineers log on to a Cisco CallManager server and get a desktop or shell that allows them to perform any function that could be done from a local logon session.

Remote serviceability supports numerous applications in the multihost and multiplatform Cisco IP Telephony Solutions environment. The tools can process and report on a vast collection of local or remote Cisco CallManager configuration data and system information.

Cisco CallManager supports the following capabilities for remote serviceability:

•Cisco Secure Telnet—Allows CSEs to log on to customer remote site to troubleshoot Cisco CallManager system.

•Show Command Line Interface—Allows CSEs to display Cisco CallManager system statistics on customer network.

•Microsoft Windows 2000 Performance Monitoring—Allows administrators to monitor performance of Cisco CallManager on local or remote installations.

•Message Translator for ISDN Trace—Allows CSEs to use Q931 Message Translator to debug ISDN Layer 3 protocol messages.

•CiscoWorks2000 Network Management System—Provides remote network management for a Cisco CallManager cluster.

•Path Analysis Interface—Traces connectivity between two specified points on a network and analyzes both physical and logical paths (Layer 2 and Layer 3) taken by packets flowing between those points.

•System Log Management—Provides a centralized system logging service for Cisco IP Telephony Solutions.

•SNMP Instrumentation—Enables administrators to remotely manage network performance, find and solve network problems, and plan for network growth.

•Cisco Discovery Protocol Support—Enables discovery of Cisco CallManager servers and management of those servers by CiscoWorks2000.

Cisco Secure Telnet

Cisco Secure Telnet offers Cisco Service Engineers transparent firewall access to Cisco CallManager servers on your site.

Cisco Secure Telnet works by enabling a Telnet client inside the Cisco Systems firewall to connect to a Telnet daemon behind your firewall. This secure connection allows remote monitoring and maintenance of your Cisco CallManager servers without requiring firewall modifications.

See Chapter 6, "Cisco Secure Telnet" for detailed information.

Show Command Line Interface

Show, a command line tool, displays the contents of the Cisco CallManager configuration database, configuration file, memory statistics, and/or the Windows diagnostic information.

You must install the Cisco CallManager to use the show tool. You run the show command from a DOS shell. You can display the output data on the console or save it into a text file.

See Chapter 7, "The Show Command Line Interface" for detailed information.

Performance Monitoring

Cisco CallManager operates in a Windows 2000 environment. Using the Windows 2000 Performance application, administrators can monitor the performance of Cisco CallManager on local or remote systems.

Performance displays both general and specific information in real time. The Cisco CallManager system gathers and feeds statistical information into the Performance tool by means of objects and counters.

---

Note Cisco CallManager provides a real-time performance monitoring with the Admin Serviceability Tool. Performance monitoring and Admin Serviceability Tool both provide object and counter information. The Admin Serviceability Tool also provides Cisco CallManager device status information. See Chapter 5, "Admin Serviceability Tool," for more information.

---

See Chapter 8, "Monitor Performance Counters" for detailed information.

Message Translator

CSEs use Q931 Message Translator application to debug ISDN Layer 3 protocol messages produced by the Cisco CallManager system.

Translation of the ISDN trace from the Cisco CallManager system enables CSEs to quickly and efficiently handle any information reported by your system. Administrators on or off site can control and access multiple levels of trace, enabling smooth operation of the Cisco CallManager servers in your cluster.

See Chapter 9, "Message Translator" for detailed information.

CiscoWorks2000

CiscoWorks2000 serves as the network management system (NMS) of choice for all Cisco devices as well as the Cisco CallManager system. Because it is not bundled with Cisco CallManager, you must purchase it separately. Use the following tools with CiscoWorks2000 for remote serviceability:

•System Log

•Path Analysis

•Cisco Discovery Protocol

•Simple Network Management Protocol

See Chapter 10, "Manage With CiscoWorks2000" for detailed information.

Path Analysis Interface

Path Analysis traces connectivity between two specified points on a network. It analyzes both physical and logical paths (Layer 2 and Layer 3) taken by packets flowing between those points.

After a call completes, PathTool traces the route of audio packets by specifying the directory number of the calling and called parties. This applies to calls between any of the following endpoints: Cisco IP phones, analog devices connected to a station gateway, or trunk gateways (analog or digital).

For more information, consult CiscoWorks2000 online help.

You can display the paths that are traced in the form of maps, trace logs, or tables in CiscoWorks2000 Campus Manager.

See Chapter 11, "The Path Analysis Interface" for detailed information.

System Log Management

Cisco Syslog Analysis, which is packaged with CiscoWorks2000 Resource Manager Essentials, provides management of Cisco Syslog messages.

Cisco Syslog Analyzer serves as the component of Cisco Syslog Analysis that provides common storage and analysis of the system log for multiple applications. The other major component, Cisco Syslog Collector, gathers log messages from Cisco CallManager servers.

These two Cisco applications work together to provide a centralized system logging service for Cisco IP Telephony Solutions.

See Chapter 12, "System Log Management" for detailed information.

SNMP Instrumentation

Network management systems (NMS) use SNMP, an industry-standard interface, to exchange management information between network devices. A part of the TCP/IP protocol suite, SNMP enables administrators to remotely manage network performance, find and solve network problems, and plan for network growth.

A MIB designates a collection of information that is organized hierarchically. Access MIBs using a network management protocol such as SNMP. MIBs comprise managed objects, which are identified by object identifiers.

Cisco CallManager supports the following MIBs:

•CISCO-CCM-MIB

•CISCO-CDP-MIB

•SYSAPPL-MIB

An SNMP agent can send traps that identify important system events to the network manager. Some examples of Cisco CallManager SNMP trap messages that are sent to an NMS specified as a trap receiver include Cisco CallManager failed, Phone failed, and Route list exhausted.

See Chapter 13, "SNMP Instrumentation" for detailed information.

Cisco Discovery Protocol

With CDP Advertisement Support, Cisco CallManager periodically sends out CDP messages on the active interface to a designated multicast address. These messages contain information such as device identification, interface name, system capabilities, SNMP agent address, and time-to-live.

Any Cisco device with CDP support can locate a Cisco CallManager by using these periodic messages. For example, a device can locate Cisco CallManager agent IP addresses using the CDP cache from their direct neighboring devices.

See Chapter 14, "Cisco Discovery Protocol Support" for detailed information.

Appendix

The Microsoft Performance counters for phones and gateways have related or overlapping information that is also used by AST device monitoring and CCM_SNMP_MIB. The appendix contains tables that describe the related counter information for Microsoft Performance, Admin Serviceability Tool, and CCM_SNMP_MIB.

See Appendix A, "Cisco CallManager Perfmon Counters, AST, and CCM_SNMP_MIB" for detailed information.

Definitions

Table 1-1 provides the definitions for the terms used throughout this document.

Table 1-1 Serviceability Terms and Definitions 

Term	Definition
Admin Serviceability Tool	A program in Serviceability that provides real-time information about Cisco CallManager performance counters and devices.
Alarm	Administrators use alarms to obtain runtime status and state of the Cisco CallManager system. Alarms contain information about system problems such as explanation and recommended action.
Alarm Catalog	This term refers to a file containing all the Alarm definitions. Serviceability supports multiple alarm catalogs, specific to the alarm type.
Alarm Definition	Administrators search the alarm definitions database for alarm information. The alarm definition contains a description of the alarm and a recommended action.
Alarm Event Levels	Administrators determine the level of information an alarm will contain. Levels range from general information about the system to information for debugging purposes only.
Alarm Filters	Administrators determine the level of information an alarm contains and where the alarm information gets saved.
Alarm Monitors	Cisco CallManager Serviceability allows alarms to be sent to four destinations called monitors: Win2000 Event viewer, SDI trace, SDL trace, and SysLog.
Alert Notify	Administrators configure alert notifications for performance counters and gateway ports/channels using the Admin Serviceability Tool. The Admin Serviceability Tool sends alerts by e-mail or in a popup window to the administrator.
Category Tabs	Administrators configure specific monitoring windows in the Admin Serviceability Tool for troubleshooting purposes. The administrator creates these specific windows using Category Tabs.
Chart View	The Performance Monitoring Window displays performance counters in chart view by default. Chart view graphically shows the performance of the counter.
Cisco CallManager service	This term refers to software that performs a specific function, such as TFTP, CTI, or music on hold. Cisco CallManager supports many services.
Control Center	Control Center program in Serviceability allows administrators to view the status of and to start and stop Cisco CallManager services.
Debug Trace Levels	Administrators determine the level of information a trace will contain. Levels range from general errors to detailed errors for debugging purposes only.
Device Monitoring	The Admin Serviceability Tool displays real-time information about Cisco CallManager devices such as phones and gateways.
Device Monitoring Window	The right side of the Admin Serviceability Tool window displays device performance information when the tool is monitoring device performance.
Device Name Based Trace Monitoring	Administrators obtain trace information about devices by configuring trace parameters for Cisco CallManager and Cisco CTIManager services.
Monitoring Objects Window	The left side of the Admin Serviceability Tool window displays object counter hierarchy information or device information for a cluster. The information displayed depends on which tab is active in the window.
Object counter	Windows 2000 provides performance data that contains information about various object counters. Counters measure various aspects of system performance. Object counters include registered phones, calls attempted, and calls in progress. The Admin Serviceability Tool monitors the real-time performance of these counters.
Performance Monitoring	The Admin Serviceability Tool displays real-time information about a performance counter. Performance counters can be system specific or Cisco CallManager specific.
Performance Monitoring Window	The right side of the Admin Serviceability Tool window displays counter performance information when the tool is monitoring counter performance.
SDI Trace log file	Every Cisco CallManager service includes a default SDI trace log file. The system traces system diagnostic interface information from the services and logs runtime events and traces to a log file.
SDL Trace log file	This file contains call-processing information from services such as Cisco CallManager and Cisco CTIManager. The system traces the signal distribution layer of the call and logs state transitions into a log file.
Service status icons	Control Center displays three icons representing the status of a service on a server: - Square represents a service has stopped. - Arrow represents a service is running. - Question mark represents a service is in an unknown state.
Trace	Administrators and Cisco engineers use trace to obtain specific information about Cisco CallManager service problems.
Trace Analysis	This program in Trace allows administrators to debug specific system problems.
Trace log file	Cisco CallManager Serviceability sends configured trace information to this file. Two types of trace log files exist: SDI and SDL.
Window Status Bar	The bottom, right corner of the Admin Serviceability Tool window displays the window status bar. The status bar displays five icons: Preferences, Cluster Information, Resource Usage, About, and Help.