- Introduction
- Upgrade Cisco Prime Collaboration Deployment
- Install Cisco Prime Collaboration Deployment
- Cisco Prime Collaboration Deployment Features
- Cisco Prime Collaboration Deployment Administrative Interface Elements
- Cisco Prime Collaboration Deployment Configuration and Administration
- CLI Commands and Disaster Recovery System
- CTL Update
- Best Practices
- Cisco Prime Collaboration Deployment Troubleshooting
Cisco Prime Collaboration Deployment Administration Guide, Release 10.5(2)
- Updated:
- February 25, 2016
Chapter: CLI Commands and Disaster Recovery System
CLI Commands and Disaster Recovery System
CLI Commands on Cisco Prime Collaboration Deployment
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.
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.
- Create a DRS Backup of the Server
- Important Notes on Backup and Restore
- Restore a Backup to Cisco Prime Collaboration Deployment
Create a DRS Backup of the Server
If you are using a location on your network to back up your Cisco Prime Collaboration Deployment, ensure the following points:
- You must have access to an SFTP server to configure a network storage location. The Disaster Recovery system supports only SFTP servers that are configured with an IPv4 address or hostname/FQDN.
- The account that you use to access the SFTP server must have write permission for the selected path.
You can also back up your Cisco Prime Collaboration Deployment to a local disk; however, this method is not recommended, because of the amount of space that is required on the Cisco Prime Collaboration Deployment disk to store the backup files.
Important Notes on Backup and Restore
 Note | When you restore your Cisco Prime Collaboration Deployment data, ensure that the Cisco Prime Collaboration Deployment software version that is installed on your server matches the version of the backup file that you want to restore. |
Note | When you perform a DRS restore operation to migrate data to a new server, you must assign the new server the identical IP address and hostname that the old server used. Additionally, if DNS was configured when the backup was taken, then the same DNS configuration must be present before you perform a restore operation. |
Note | We recommend that you perform a fresh installation of Cisco Prime Collaboration Deployment on your virtual machine before you restore the data. |
Restore a Backup to Cisco Prime Collaboration Deployment
Note | This procedure is optional. |
What to Do Next
After you restore your data, perform a system restart on the Cisco Prime Collaboration Deployment server to initialize the database.
The Cisco Prime Collaboration Deployment server will lose contact with ESXi hosts during the reinstallation. You may have to add ESXi hosts back into Cisco Prime Collaboration Deployment after a restore operation.
Feedback