Contents
Cisco Prime Collaboration Deployment configuration and administration
Services
After the installation of the Cisco Prime Collaboration Deployment platform, most services start automatically. You can configure services by setting service parameters for each service. If necessary, for example, for troubleshooting purposes, you may need to stop and start (or restart) a service. You can perform these task by using the command line interface (CLI) on the Cisco Prime Collaboration Deployment platform.
Cisco Prime Collaboration Deployment Platform Manager Service
The Cisco Platform Manager Service supports the Cisco Prime Collaboration Deployment application interface. This service must be active for the Cisco Prime Collaboration Deployment application to work correctly. It is active by default.
Performance and Monitoring Services
This section describes the Performance and Monitoring Services.
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 the Cisco Prime Collaboration Deployment platform by using configured thresholds and a polling interval.
Cisco RIS Data Collector
The Real-Time Information Server (RIS) maintains real-time information, such as critical alarms generated.
Cisco AMC Service
This service, Alert Manager and Collector service, allows you to retrieve real-time information that exists on the server.
Cisco Audit Event Service
The Cisco Audit Event Service monitors and logs any configuration change to the Cisco Prime Collaboration Deployment platform by a user or as a result of the user action.
SOAP -Log Collection APIs Service
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.
SOAP -Performance Monitoring APIs Service
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, and so on.
Backup and Restore Services
This section describes the Backup and Restore Services.
Cisco DRF Master
The Cisco DRF Master Agent service supports the DRF Master Agent, which works with the 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 CDP
Cisco CDP advertises the voice application to other network management applications, so the network management application 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. If you stop this service, you cannot collect or view traces on the Cisco Prime Collaboration Deployment platform.
For SysLog Viewer and trace and log collection, 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. If you stop this service, you cannot collect or view traces on the Cisco Prime Collaboration Deployment platform.
For SysLog Viewer and trace and log collection, 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.
Cisco Tomcat
The Cisco Tomcat service supports the web server.
Cisco Tomcat Stats Servlet
The Cisco Tomcat Stats servlet collects the Tomcat statistics.
Platform Administrative Web Service
Important:This service should not be activated on the Cisco Prime Collaboration Deployment server
The Platform Administrative Web service is a SOAP API that can be activated on CUCM, CUP and UC systems, to allow the Cisco Prime Collaboration Deployment server to upgrade the system.
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 the CLI, you must restart the SNMP Master Agent service.MIB2 Agent
This service provides SNMP access to variables, which are defined in RFC 1213, that read and write variables; for example, system and interfaces.
Host Resources Agent
This service provides SNMP access to host information, such as storage resources, process tables, and installed software base. This service implements the HOST-RESOURCES-MIB.
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 Prime Collaboration Deployment platform. 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.
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.
Working with Services
To start, stop, activate, or restart services or to configure service parameters for services on the Cisco Prime Collaboration Deployment platform, you must use the command line interface (CLI). You can start, stop, activate, or refresh only one service at a time. Be aware that when a service is stopping, you cannot start it until after the service is stopped. Likewise, when a service is starting, you cannot stop it until after the service is started.
The following services are activated by default after you install the Cisco Prime Collaboration Deployment platform.
- Cisco AMC Service
- Cisco Audit Event Service
- Cisco CDP
- Cisco CDP Agent
- Cisco Certificate Expiry Monitor
- Cisco DRF Local
- Cisco DRF Master
- Cisco Log Partition Monitoring Tool
- Cisco Platform Manager Service
- Cisco RIS Data Collector
- Cisco Syslog Agent
- Cisco Tomcat
- Cisco Tomcat Stats Servlet
- Cisco Trace Collection Servlet
- Host Resources Agent
- MIB2 Agent
- SNMP Master Agent
- System Application Agent
The following services are stopped by default after you install the Cisco Prime Collaboration Deployment platform.
Caution
Some changes to service parameters may cause system failure. Cisco recommends that you do not make any changes to service parameters unless you fully understand the feature that you are changing or unless the Cisco Technical Assistance Center (TAC) specifies the changes.The following table shows the commands that you need to work with services on the Cisco Prime Collaboration Deployment platform.
Table 1 Service CLI Commands Task Command Display a list of services and service status
utils service list
Activate a service
utils service activate servicename
Stop a service
utils service stop servicename
Start a service
utils service start servicename
Restart a service
utils service restart servicename
Limitations and restrictions
The following list describes the current limitations for Cisco Prime Collaboration Deployment:
- Cisco Prime Collaboration Deployment is not a diagnostic tool. An error message does appear on the task list page if a task fails; however, you should use your usual set of tools and procedures to diagnose and correct the problem.
- The SOAP services do not replace the existing OS Administration and CLI upgrade processes. You can still upgrade your servers using the application GUIs, or CLI commands. Cisco Prime Collaboration Deployment is just another way to upgrade, restart, or switch versions on the application servers.
Best practices
The following are recommendations for configuring your systems as suggested by Cisco development and testing teams.
- Use the Cluster Inventory page to populate the Cisco Prime Collaboration Deployment database. See theDiscover a cluster section for more information.
- Use your standard pre- and post- upgrading procedures when performing this action. Cisco Prime Collaboration Deployment simplifies this process for you.
