The main functions
of Cisco Prime Collaboration Deployment (such as creating migration, upgrade,
and other tasks) are supported through the Cisco Prime Collaboration Deployment
GUI interface. You can use the GUI interface to create a specific task and
schedule the time to perform the task. The GUI interface also reports the
status of tasks.
For other operations, such
as upgrading the software on the Cisco Prime Collaboration Deployment server and performing a DRS backup, use the Cisco Prime Collaboration Deployment CLI, which is similar to the CLI on
Cisco Unified Communications
Manager Release 10.x.
Use the CLI on Cisco Prime Collaboration Deployment to perform the following
tasks:
- View or get log files
- Administer a DRS backup
device, and perform a data backup or restore
- Upgrade the Cisco Prime
Collaboration Deployment software
- Change the hostname, IP
address, or password on the Cisco Prime Collaboration Deployment
- Perform diagnostic commands
on the Cisco Prime Collaboration Deployment system
The most common CLI
operations and commands are for viewing logs and performing DRS backups.
Getting Cisco
Prime Collaboration Deployment Logs
When
you troubleshoot problems on the Cisco Prime Collaboration Deployment server, it
is often necessary to view the main application log.
CLI command:
file get
activelog tomcat/logs/ucmap/log4j/*
The Cisco Prime
Collaboration Deployment main application log contains the following information:
- Representational state transfer (REST) requests from the
browser
- Simple Object Access Protocol (SOAP) requests to UC
servers
- Database requests
- Scheduler events
(scheduled, started, failed, and so on)
- Specific job events
(tasks, task actions, and nodes)
- Exceptions and errors
DRS on Cisco
Prime Collaboration Deployment
The Disaster
Recovery System (DRS) can be administered and invoked from the Cisco Prime
Collaboration Deployment CLI. DRS allows you to perform
user-invoked data backups of the data on your Cisco Prime Collaboration
Deployment (the server clusters you have discovered, and scheduled and
completed tasks). You can also choose to set up regularly scheduled automatic
backups. The DRS feature has the following functions:
- CLI commands for
performing backup and restore tasks
- The ability to schedule
backups ahead of time, or run backups manually immediately
- The ability to archive
backups to a remote SFTP server
DRS restores its
own settings (backup device settings and schedule settings) as part of the
platform backup and restore.
Important:
While you restore your data, the hostname, server IP address, and Cisco Prime
Collaboration Deployment software version on the machine to which you are restoring the
data must be the same as they were on the server on which you performed the
backup.
DRS CLI
Commands
Below is a list of
the CLI commands that you can use to configure and perform backup and restore operations through DRS.
- utils disaster_recovery
status <operation> (An example of operation is Backup or Restore).
- utils disaster_recovery
device list
- utils disaster_recovery
device add
- utils disaster_recovery
device delete
- utils disaster_recovery
schedule add
- utils disaster_recovery
schedule delete
- utils disaster_recovery
schedule enable
- utils disaster_recovery
schedule disable
- utils disaster_recovery
schedule list
- utils disaster_recovery
backup —Starts a manual backup by using the features that are configured in the
DRS interface.
- utils disaster_recovery
restore —Starts a restore, and requires parameters for backup location, filename,
and features to restore.
- utils disaster_recovery
show_backupfiles—Shows existing backup files.
- utils disaster_recovery
cancel_backup
- utils disaster_recovery
show_registration
- utils disaster_recovery
show_registration SERVER—Shows the features that you need to back up. For example, if you want to back up Cisco Prime Collaboration Deployment, choose PCD from the feature list.
For more
information, see the DRS documentation for Cisco Unified Communications
Manager, at
http://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html.