Cisco Unified Serviceability service management includes working with feature and
network services and servlets, which are associated with the Tomcat Java
Webserver. Feature services allow you to use application features, such as
Serviceability Reports Archive, while network services are required for your
system to function.
If something is wrong with a service or servlet, an alarm gets
written to an alarm monitor. After viewing the alarm information, you can run a
trace on the service. Be aware that services and servlets display different
trace levels in the Trace Configuration window.
This chapter, which provides a description of
services/servlets, Service Activation, and Control Center, contains information
on the following topics:
In
Cisco Unified Serviceability, you can activate, start, and stop feature services.
Activation turns on and starts the service. After you activate a service in the
Service Activation window, you do not need to start it in the Control
Center—Feature Services window. If the service does not start for any reason,
you must start it in the Control Center—Features Services window.
After the system is installed, it does not automatically
activate feature services, which are related services that are required if you
want to use your configuration features; for example, the Serviceability
Reports Archive feature.
After you activate feature services, you can modify
associated settings in
Cisco Unified CCX
Serviceability.
If you are upgrading
Cisco Unified CCX, those services that you activated on the system prior to the
upgrade automatically activate and start after the upgrade.
In the Service Activation window,
Cisco Unified Serviceability categorizes feature services into the following
groups:
In the Control Center—Feature Services window,
Cisco Unified Serviceability categorizes services into the same groups that display
in the Service Activation window.
The following Database and Admin Services are not applicable for Unified CCX.
Cisco AXL Web Service
Cisco UXL Web Service
Cisco Serviceability Reporter
The Cisco Serviceability Reporter service generates the daily
reports that are described in
Serviceability Reporter archive.
In a
Cisco Unified CCX
cluster, this service gets installed on both the nodes in the cluster. Reporter
generates reports once a day based on logged information. You can access the
reports that Reporter generates in
Cisco Unified Serviceability from the Tools menu. Each summary report comprises
different charts that display the statistics for that particular report. After
you activate the service, report generation may take up to 24 hours.
Cisco DirSynch directory services
The Cisco DirSynch directory services is not applicable for Unified CCX.
Network services
Installed automatically, network services include services
that the system requires to function; for example, database and platform
services. Because these services are required for basic functionality, you
cannot activate them in the Service Activation window. If necessary, for
example, for troubleshooting purposes, you may need to stop and start (or
restart) a network service in the Call Control—Network Services window.
After the installation of your application, network services
start automatically, as noted in the Call Control—Network Services window. In
the Control Center—Network Services window,
Cisco Unified Serviceability categorizes services into the following groups:
This section describes the Performance and Monitoring Services.
Cisco Unified Serviceability RTMT
The Cisco Unified Serviceability RTMT servlet supports the Cisco Unified Real-Time Monitoring Tool (RTMT), which allows you to collect and view traces, view performance monitoring objects, work with alerts, and monitor devices, system performance, CTI applications, and so on.
Cisco RTMT Reporter Servlet
The Cisco RTMT Reporter servlet allows you to publish reports for RTMT.
Cisco Log Partition Monitoring Tool
The Cisco Log Partition Monitoring Tool service supports the Log Partition Monitoring feature, which monitors the disk usage of the log partition on a server (or all servers in the cluster) by using configured thresholds and a polling interval.
Cisco Tomcat Stats Servlet
The Cisco Tomcat Stats Servlet allows you to monitor the Tomcat perfmon counters by using RTMT or the Command Line Interface. Do not stop this service unless you suspect that this service is using too many resources, such as CPU time.
Cisco RIS Data Collector
The Real-time Information Server (RIS) maintains real-time information such as device registration status, performance counter statistics, critical alarms generated, and so on. The Cisco RIS Data Collector service provides an interface for applications, such as the Cisco Unified Real-Time Monitoring Tool (RTMT), SOAP applications, and so on, to retrieve the information that is stored in the RIS server (or in all RIS servers in the cluster).
Cisco AMC Service
Used for the Cisco Unified Real-Time Monitoring Tool (RTMT), this service, Alert Manager and Collector service, allows RTMT to retrieve real-time information that exists on the server (or on all servers in the cluster).
Cisco Audit Event Service
The Cisco Audit Event Service monitors and logs any configuration change to the Cisco Unified CCX system by a user or as a result of the user action.
Cisco RisBean Library
Cisco RisBean Library comprises a library that some webapps use to communicate with other internal services.
You should leave trace settings at default level unless you are instructed by TAC to change them to debug an issue.
Backup and restore services
This section describes the Backup and Restore Services.
Cisco DRF Master
The CiscoDRF Master Agent service supports the DRF Master Agent, which works with the Disaster Recovery System graphical user interface (GUI) or command line interface (CLI) to schedule backups, perform restorations, view dependencies, check status of jobs, and cancel jobs, if necessary. The Cisco DRF Master Agent also provides the storage medium for the backup and restoration process.
Cisco DRF Local
The Cisco DRF Local service supports the Cisco DRF Local Agent, which acts as the workhorse for the DRF Master Agent. Components register with the Cisco DRF Local Agent to use the disaster recovery framework. The Cisco DRF Local Agent executes commands that it receives from the Cisco DRF Master Agent. Cisco DRF Local Agent sends the status, logs, and command results to the Cisco DRF Master Agent.
System services
This section describes the System Services.
Cisco Unified Serviceability
The Cisco CallManager Serviceability service supports Cisco Unified Serviceability, the web application/interface that you use to troubleshoot issues and manage services. This service, which is installed automatically, allows you access to the Cisco Unified Serviceability graphical user interface (GUI). If you stop this service, you cannot access the Cisco Unified Serviceability GUI when you browse into that server.
Cisco CDP
Cisco CDP advertises the voice application to other network management applications, so the network management application, for example, SNMP or CiscoWorks Lan Management Solution, can perform network management tasks for the voice application.
Cisco Trace Collection Servlet
The Cisco Trace Collection Servlet, along with the Cisco Trace Collection Service, supports trace collection and allows users to view traces by using RTMT. If you stop this service on a server, you cannot collect or view traces on that server.
For SysLog Viewer and Trace and Log Central to work in RTMT, the Cisco Trace Collection Servlet and the Cisco Trace Collection Service must run on the server.
Cisco Trace Collection Service
The Cisco Trace Collection Service, along with the Cisco Trace Collection Servlet, supports trace collection and allows users to view traces by using the RTMT client. If you stop this service on a server, you cannot collect or view traces on that server.
For SysLog Viewer and Trace and Log Central to work in RTMT, the Cisco Trace Collection Servlet and the Cisco Trace Collection Service must run on the server.
Tip
If necessary, Cisco recommends that, to reduce the initialization time, you restart the Cisco Trace Collection Service before restarting Cisco Trace Collection Servlet.
Platform services
This section describes the Platform Services.
A Cisco DB
A Cisco DB service supports the Progres database engine.
A Cisco DB Replicator
The A Cisco DB Replicator service ensures database configuration and data synchronization between the primary and secondary Unified CCX servers in the cluster.
Cisco Tomcat
The Cisco Tomcat service supports the web server.
SNMP Master Agent
This service, which acts as the agent protocol engine, provides authentication, authorization, access control, and privacy functions that relate to SNMP requests.
Tip
After you complete SNMP configuration in Cisco Unified Serviceability, you must restart the SNMP Master Agent service in the Control Center—Network Features window.
MIB2 Agent
This service provides SNMP access to variables, which are defined in RFC 1213, that read and write variables; for example, system, interfaces, IP, and so on.
Host Resources Agent
This service provides SNMP access to host information, such as storage resources, process tables, device information, and installed software base. This service implements the HOST-RESOURCES-MIB.
Native Agent Adaptor
This service, which supports vendor MIBs, allows you to forward SNMP requests to another SNMP agent that runs on the system.
System Application Agent
This service provides SNMP access to the applications that are installed and executing on the system. This implements the SYSAPPL-MIB.
Cisco CDP Agent
This service uses the Cisco Discovery Protocol to provide SNMP access to network connectivity information on the Cisco Unified CCX server. This service implements the CISCO-CDP-MIB.
Cisco Syslog Agent
This service supports gathering of syslog messages that various components generate. This service implements the CISCO-SYSLOG-MIB.
Caution
Stopping any SNMP service may result in loss of data because the network management system no longer monitors the network. Do not stop the services unless the your technical support team tells you to do so.
Cisco Certificate Expiry Monitor
This service periodically checks the expiration status of certificates that the system generates and sends notification when a certificate gets close to its expiration date. You manage the certificates that use this service in Cisco Unified Operating System Administration.
Security services
This section describes the Security Services.
Cisco Trust Verification Service
Cisco Trust Verification Service is a service running on a Cisco Unified CCX server or a dedicated server, that authenticates certificates on behalf of phones and other endpoints. It associates a list of roles for the owner of the certificate. A certificate or the owner can be associated with one or many roles.
The protocol between phones and Trust Verification Service allows phones to request for verification. Trust Verification Service validates the certificate and returns a list of roles associated with it. The protocol allows Trust Verification Service to authenticate a request and conversely, a phone to authenticate the response from Trust Verification Service. The protocol protects the integrity of the request and the response. Confidentiality of the request and the response is not required.
Multiples instances of Cisco Trust Verification Service run on different servers in the cluster to provide scalability. These servers may or may not be the same as the ones hosting the Cisco Unified CallManager. Phones obtain a list of Trust Verification Services in the network and connect to one of them using a selection algorithm (example: Round Robin). If the contacted Trust Verification Service does not respond, the phone switches to the next Trust Verification Service in the list.
Note
This service is not applicable for Unified CCX 9.0(1).
DB services
This section describes the DB Services.
Cisco Database Layer Monitor
The Cisco Database Layer Monitor service monitors aspects of the database layer. This service takes responsibility for change notification and monitoring.
SOAP services
This section describes the SOAP Services.
Cisco SOAP-Real-Time Service APIs
The Cisco SOAP-Real-Time Service APIs allow you to collect real-time information for devices and CTI applications. This service also provides APIs for activating, starting, and stopping services.
Cisco SOAP-Performance Monitoring APIs
The Cisco SOAP-Performance Monitoring APIs service allows you to use performance monitoring counters for various applications through SOAP APIs; for example, you can monitor memory information per service, CPU usage, performance monitoring counters, and so on.
Cisco SOAP-Log Collection APIs
The Cisco SOAP-Log Collection APIs service allows you to collect log files and to schedule collection of log files on a remote SFTP server. Examples of log files that you can collect include syslog, core dump files, Cisco application trace files, and so on.
Service activation
You can activate or deactivate multiple feature services or choose default services to activate from the Service Activation window in Cisco Unified Serviceability.
Cisco Unified Serviceability activates feature services in automatic mode and checks for service dependencies. When you choose to activate a feature service, Cisco Unified Serviceability prompts you to select all the other services, if any, that depend on that service to run. When you click Set to Default, Cisco Unified Serviceability chooses those services that are required to run on the server.
In a Cisco Unified CCX cluster, you need to do this process for each server. Activating a service automatically starts the service. You start/stop services from Control Center.
Control Center
From Control Center in Cisco Unified Serviceability, you can view status and start and stop one service at a time. In a cluster, you can perform these functions for one server in the cluster. To perform these tasks, Cisco Unified Serviceability provides two Control Center windows. To start, stop, and restart network services, access the Control Center—Network Services window. To start, stop, and restart feature services, access the Control Center—Feature Services window.
Tip
Use the Related Links drop-down list box and the Go button to navigate to Control Center and Service Activation windows.
Services configuration checklist
Steps for working with services.
Procedure
Step 1
Activate the feature services that you want to run.
Step 2
Configure the appropriate service parameters.
Note
You configure service parameters in
Cisco Unified CCX Serviceability.
Step 3
If necessary, troubleshoot problems by using the
Cisco Unified Serviceability trace tools.