Cisco Emergency Responder Administration Guide 8.0
Chapter 9: Configuring the Cisco Emergency Responder 8.0 Disaster Recovery System
Downloads: This chapterpdf (PDF - 467.0KB) The complete bookPDF (PDF - 13.77MB) | Feedback

Configuring the Cisco Emergency Responder 8.0 Disaster Recovery System

Table Of Contents

Configuring the Cisco Emergency Responder 8.0 Disaster Recovery System

What is the Disaster Recovery System?

Quick-Reference Tables for Backup and Restore Procedures

Backup Quick Reference

Restore Quick Reference

Supported Features and Components

System Requirements

How to Access the Disaster Recovery System

Master Agent Duties and Activation

Local Agents

Adding Backup Devices

Creating and Editing Backup Schedules

Enabling, Disabling, and Deleting Schedules

Starting a Manual Backup

Checking Backup Status

Restoring a Backup File

Restoring a Server Group

Restoring the Publisher Server

Restoring the Subscriber Server

Viewing the Restore Status

Viewing the Backup and Restore History

Backup History

Restore History

Trace Files

Command Line Interface


Configuring the Cisco Emergency Responder 8.0 Disaster Recovery System


These topics describe how to configure the Cisco Emergency Responder (Cisco ER) 8.0 Disaster Recovery System:

What is the Disaster Recovery System?

Quick-Reference Tables for Backup and Restore Procedures

Supported Features and Components

System Requirements

How to Access the Disaster Recovery System

Master Agent Duties and Activation

Local Agents

Adding Backup Devices

Creating and Editing Backup Schedules

Enabling, Disabling, and Deleting Schedules

Starting a Manual Backup

Checking Backup Status

Restoring a Backup File

Restoring a Server Group

Viewing the Backup and Restore History

Trace Files

Command Line Interface

What is the Disaster Recovery System?

The Disaster Recovery System (DRS), which can be invoked from the main Cisco ER 8.0 web interface, provides full data backup and restore capabilities for all servers in a Cisco ER server group. The Disaster Recovery System allows you to perform a regularly scheduled automatic or user-invoked data backup. DRS supports multiple backup schedules.

The Cisco Disaster Recovery System performs a server group-level backup, which means that it collects backups for all servers in a Cisco ER server group to a central location and archives the backup data to physical storage device.

DRS restores its own settings (backup device settings and schedule settings) as part of the platform backup/restore. DRS backs up and restores drfDevice.xml and drfSchedule.xml files. When the server is restored with these files, you do not need to re-configure DRS backup device and schedule.

When performing a system data restoration, you can choose which servers in the server group that you want to restore.

The Disaster Recovery System includes the following capabilities:

A user interface for performing backup and restore tasks

A distributed system architecture for performing backup and restore functions

Scheduled backups

Archive backups to a physical tape drive or remote sftp server


Note The tape device must be attached to the Publisher.


The Disaster Recovery System contains two key functions, Master Agent (MA) and Local Agent (LA). The Master Agent coordinates backup and restore activity with all the Local Agents.

The system automatically activates both the Master Agent and the Local Agent on all servers in the server group.


Note The Disaster Recovery System does not migrate data from Windows to Linux or from Linux to Linux. You must run a restore on the same product version as the backup. For information on data migration from a Windows-based platform to a Linux-based platform, refer to the Data Migration Assistant User Guide.



Caution Schedule backups during off-peak hours to avoid call-processing interruptions and impact to service.

Quick-Reference Tables for Backup and Restore Procedures

The following tables provide a quick reference for the backup and restore procedures.

Backup Quick Reference

Restore Quick Reference

Backup Quick Reference

Table 9-1 provides a quick, high-level reference to the major steps, in chronological order, that you must perform to do a backup procedure using the Disaster Recovery System.


Note The Disaster Recovery System does not migrate data from Windows to Linux or from Linux to Linux. A restore must run on the same product version as the backup. For information on data migration from a Windows-based platform to a Linux-based platform, refer to the Data Migration Assistant User Guide before following the steps in Table 9-1.


Table 9-1 High-Level Tasks for Performing a Backup Procedure 

Task
Reference

Create backup devices on which to back up data.

"Adding Backup Devices" section

Create and edit backup schedules to back up data on a schedule.

Note Either a manual or a scheduled backup backs up the server group.

"Creating and Editing Backup Schedules" section

Enable and disable backup schedules to back up data.

"Enabling, Disabling, and Deleting Schedules" section

Optionally, run a manual backup.

"Starting a Manual Backup" section

Check the Status of the Backup—While a backup is running, you can check the status of the current backup job.

"Checking Backup Status" section


Restore Quick Reference

Table 9-2 provides a quick, high-level reference to the major steps, in chronological order, that you must follow to perform a restore procedure using the Disaster Recovery System.

Table 9-2 High-Level Tasks for Performing a Restore Procedure 

Task
Reference

Choose Storage Location—You must first choose the storage location from which you want to restore a backup file.

"Restoring a Backup File" section

Choose the Backup File—From a list of available files, choose the backup file that you want to restore.

"Restoring a Backup File" section

Choose Features—From the list of available features, choose the features that you want to restore.

"Restoring a Backup File" section

Choose Server—If the feature was backed up from multiple servers, you must choose the servers that you want to restore.

"Restoring a Backup File" section

Check the Status of the Restore—While the restore process is running, you can check the status of the current restore job.

"Viewing the Restore Status" section


Supported Features and Components

For the Cisco ER 8.0 release, you can back up and restore Cisco ER.

When you choose a feature for backup, the system backs up all of its subcomponents automatically.

System Requirements

Make sure that Cisco ER 8.0 is running on all servers in the server group.

To back up data to a remote device on the network, you must have an SFTP server configured. Cisco tests and recommends the following SFTP servers, but you may use any SFTP server:


Note Cisco does not support third-party software. Contact the SFTP vendor for support issues.


Open SSH (for Unix systems)

Cygwin (refer to http://sshwindows.sourceforge.net/)

freeFTPD (refer to http://www.freeftpd.com/?ctt=download)

Titan (http://www.titanftp.com/) `


Note While a backup or restore is running you cannot perform any OS Administration tasks because Disaster Recovery System blocks all OS Administration requests by locking the platform API. However, this does not block most CLI commands as only the CLI based upgrade commands use the Platform API locking package.


How to Access the Disaster Recovery System

To access the Disaster Recovery System, select Disaster Recover System from the pulldown Navigation menu on the main Cisco ER 8.0 web interface. Log in to the Disaster Recovery System by using the same Administrator username and password that you use for the Cisco Unified OS Administration web interface.


Note You set the Administrator username and password during Cisco ER installation, and you can change the Administrator password or set up a new Administrator account by using the Command Line Interface (CLI). See the "set password" section on page F-21.


Master Agent Duties and Activation

The system automatically activates the Master Agent on all servers in the server group, but only the Master Agent running on the publisher server is fully active.

The Master Agent (MA) performs the following duties:

The MA stores systemwide component registration information.

The MA maintains a complete set of scheduled tasks in the Cisco ER database. When it receives updates from the user interface, the MA sends executable tasks to the applicable Local Agents, as scheduled. (Local Agents execute immediate-backup tasks without delay.)

You access the MA through the Disaster Recovery System user interface to perform activities such as scheduling backups, adding a new backup task for a specific server or a defined server group, updating or reviewing an existing entry, displaying status of executed tasks, and performing system restoration.

The MA stores backup sets on a locally attached tape drive or a remote network location.

Local Agents

Each server in a Cisco ER server group, including the server that contains the Master Agent, must have its own Local Agent to perform backup and restore functions for its server.


Note By default, a Local Agent automatically gets activated on each server in the server group.


The Local Agent runs backup and restore scripts on each server in the server group.

Adding Backup Devices

Before using the Disaster Recover System, you must configure the locations where you want the backup files to be stored. You can configure up to 10 backup devices.

To configure backup devices, follows these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > Backup Device.

The Backup Device List page appears.

Step 2 To configure a new backup device, click Add New. To edit a backup device, select it in the Backup Device list, then click Edit Selected.

The Backup Device window appears.

Step 3 Enter the backup device name in the Backup device name field.


Note The backup device name may contain only alpha numeric characters, spaces ( ), dashes (-) and underscores (_). No other characters are allowed.


Step 4 Choose one of the following backup devices and enter the appropriate field values in the Select Destination area:

Tape Device—Stores the backup file on a locally attached tape drive. Choose the appropriate tape device from the list.


Note You cannot span tapes or store more than one backup per tape.


Network Directory—Stores the backup file on a networked drive that is accessed through an SFTP connection. Enter the following required information:

Server name: Name or IP address of the network server

Path name: Path name for the directory where you want to store the backup file

User name: Valid username for an account on the remote system

Password: Valid password for the account on the remote system

Number of backups to store on Network Directory: The number of backups to store on this network directory.


Note You must have access to an SFTP server to configure a network storage location. The SFTP path must exist prior to the backup. The account that is used to access the SFTP server must have write permission for the selected path.


Step 5 To update these settings, click Save.


Note For network directory backups, after you click the Save button, the DRS Master Agent will validate the selected SFTP server. If the user name, password, server name, or directory path is invalid, the save will fail.


Step 6 To delete a backup device, select it in the Backup Device list, then click Delete Selected.


Note You cannot delete a backup device that is configured as the backup device in a backup schedule.



Creating and Editing Backup Schedules

You can create up to 10 backup schedules. Each backup schedule has its own set of properties, including a schedule for automatic backups, the set of features to back up, and a storage location.

To manage backup schedules, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > Scheduler.

The Schedule List window appears.

Step 2 Do one of the following steps to add a new schedule or edit an existing schedule:

a. To create a new schedule, click Add New.

b. To configure an existing schedule, click its name in the Schedule List column.

The scheduler window appears.

Step 3 Enter a schedule name in the Schedule Name field.


Note You cannot change the name of the default schedule.


Step 4 Select the backup device in the Select Backup Device area.

Step 5 Select the features to back up in the Select Features area. You must choose at least one feature.

Step 6 Choose the date and time when you want the backup to begin in the Start Backup at area.

Step 7 Choose the frequency at which you want the backup to occur in the Frequency area: Once, Daily, Weekly, or Monthly. If you choose Weekly, you can also choose the days of the week when the backup will occur.


Tip To set the backup frequency to Weekly, occurring Tuesday through Saturday, click Set Default.


Step 8 To update these settings, click Save.

Step 9 To enable the schedule, click Enable Schedule.

The next backup occurs automatically at the time that you set.


Note Ensure that all servers in the server group are running the same version of Cisco ER and are reachable through the network. Servers that are not running at the time of the scheduled backup will not be backed up.


Step 10 To disable the schedule, click Disable Schedule.


Enabling, Disabling, and Deleting Schedules

To enable, disable, or delete schedules, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > Scheduler.

The Schedule List window appears.

Step 2 Select the check boxes next to the schedules that you want to modify:

To select all schedules, click Select All.

To clear all check boxes, click Clear All.

Step 3 To enable the selected schedules, click Enable Selected Schedules.

Step 4 To disable the selected schedules, click Disable Selected Schedules.

Step 5 To delete the selected schedules, click Delete Selected.


Starting a Manual Backup

To start a manual backup, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > Manual Backup.

The Manual Backup page appears.

Step 2 Select a backup device in the Select Backup Device area.

Step 3 Select the features to back up in the Select Features area.

Step 4 To start the manual backup, click Start Backup.


Checking Backup Status

You can check the status of the current backup job and cancel the current backup job. To view the backup history, see the "Viewing the Backup and Restore History" section.

To check the status of the current backup job, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > Current Status.

The Backup Status page appears.

Step 2 To view the backup log file, click the log filename link.

Step 3 To cancel the current backup, click Cancel Backup.


Note The backup is canceled after the current component has completed its backup operation.



Restoring a Backup File

Disaster Recovery System adheres to strict version checking and allows restore only for matching versions of Cisco ER.

The Restore Wizard leads you through the steps that are required to restore a backup.


Tip To restore all servers in a server group, see the "Restoring a Server Group" section.



Caution Before you restore Cisco ER, ensure that the Cisco ER version that is installed on the server matches the version of the backup file that you want to restore. The Disaster Recovery System supports only matching versions of Cisco ER for restore. For example, the Disaster Recovery System does not allow a restore from version 8.0.(1).10000-1 to version 8.0(2).10000-1, or from version 8.0.(2).10000-1 to version 8.0(2).10000-2.

In essence, the product version needs to match, end-to-end, for the Disaster Recovery System to run a successful Cisco ER database restore.

To perform a restore, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Restore > Restore Wizard.

The first page of the Restore Wizard (Step1 Restore—Choose Backup Device) appears.

Step 2 Choose the backup device from which to restore in the Select Backup Device area.

Step 3 Click Next.

The Step 2 Restore—Choose the Backup Tar File page appears.

Step 4 Choose the backup file that you want to restore.


Note The backup filename indicates the date and time that the system created the backup file.


Step 5 Click Next.

The Step 3 Restore—Select the Type of Restore page appears.

Step 6 Choose the features that you want to restore.


Note Only the features that were backed up to the chosen file display.


Step 7 Click Next. The Step 4 Restore—Final Warning for Restore page appears.

Step 8 To start restoring the data, click Restore.

You are prompted to choose the server to restore.

Step 9 Choose the appropriate server.


Caution After you choose the server to which you want the data restored, any existing data on that server gets overwritten.

Step 10 Your data is restored on the server that you chose. To view the status of the restore, see the "Viewing the Restore Status" section.

Step 11 Restart the server.


Note Depending on the size of your database and the components that you choose to restore, the system can require one hour or more to restore.



Restoring a Server Group

If a major failure or a hardware upgrade occurs, you may need to restore all the servers in the server group. Follow these steps to restore an entire server group:


Note Before you restore a server group, make sure that the subscriber server in the server group is up and communicating with the publisher server. You must carry out a fresh install for the subscriber server that is down or not communicating with publisher server at the time of the restore.



Step 1 Restore both CER Publisher and Subscriber at the same time by selecting both the servers using Restore wizard.

Step 2 Restart Publisher.

Step 3 Restart the Subscriber after the publisher is back online.



Note You must restore both the servers in the server group at the same time.


The following sections provide the procedures for restoring servers in a server group:

Restoring the Publisher Server

To restore the Publisher server, follow these steps:


Caution Before you restore Cisco ER, ensure that the Cisco ER version that is installed on the server matches the version of the backup file that you want to restore. The Disaster Recovery System supports only matching versions of Cisco ER for restore. For example, the Disaster Recovery System does not allow a restore from version 8.0.(1).1000-1 to version 8.0(2).1000-1, or from version 8.0.(2).1000-1 to version 8.0(2).1000-2.

Procedure


Step 1 Perform a fresh installation of Cisco ER 8.0 on the Publisher server. See the "Installing the Cisco Emergency Responder Publisher" section on page 2-3 for more information.

Step 2 From the main Disaster Recovery System web page, select Restore > Restore Wizard.

The first page of the Restore Wizard (Step 1 Restore—Choose Backup Device) appears.

Step 3 Choose the backup device from which to restore in the Select Backup Device area.

Step 4 Click Next.

The Step 2 Restore—Choose the Backup Tar File page appears.

Step 5 Choose the backup file that you want to restore.


Note The backup filename indicates the date and time that the system created the backup file.


Step 6 Click Next.

The Step 3 Restore—Select the Type of Restore page appears.

Step 7 Choose the features that you want to restore.


Note Only the features that were backed up to the chosen file display.


Step 8 Click Next.

The Step 4 Restore—Final Warning for Restore page appears.

Step 9 To start restoring the data, click Restore.

Step 10 When you are prompted to choose the server to restore, choose only the Publisher.

Step 11 Your data is restored on the publisher server. To view the status of the restore, see the "Viewing the Restore Status" section.


Note During the restore process, do not perform any tasks with Cisco ER Administration or User Pages.


Step 12 Restart the server.


Note Depending on the size of your database and the components that you choose to restore, the system can require one hour or more to restore.


Step 13 After the publisher server restarts, continue with the "Restoring the Subscriber Server" section.


Restoring the Subscriber Server

To restore the subscriber server in the server group, follow these steps:


Caution When restoring a server group, you must restore the publisher server before you restore the subscriber server


Caution Before you restore Cisco ER, ensure that the Cisco ER version that is installed on the server matches the version of the backup file that you want to restore. The Disaster Recovery System supports only matching versions of Cisco ER for restore. For example, the Disaster Recovery System does not allow a restore from version 8.0.(1).1000-1 to version 8.0(2).1000-1, or from version 8.0.(2).1000-1 to version 8.0(2).1000-2.

Procedure


Step 1 Perform a fresh installation of Cisco ER 8.0 on the Subscriber server. See the "Installing the Cisco Emergency Responder Subscriber" section on page 2-8 for more information.

Step 2 From the main Disaster Recovery System web page, select Restore > Restore Wizard.

The first page of the Restore Wizard (Step 1 Restore—Choose Backup Device) appears.

Step 3 Choose the backup device from which to restore in the Select Backup Device area:

Step 4 Click Next.

The Step 2 Restore—Choose the Backup Tar File page appears.

Step 5 Choose the backup file that you want to restore.


Caution To restore the subscriber server in the server group, you must choose the same backup file that you used to restore the Publisher.

Step 6 Click Next.

The Step 3 Restore—Select the Type of Restore page appears.

Step 7 Choose the features that you want to restore.


Note Only the features that were backed up to the chosen file display.


Step 8 Click Next.

The Step 4 Restore—Final Warning for Restore page appears.

Step 9 To start restoring the data, click Restore.

Step 10 When you are prompted to choose the servers to restore, choose only the Subscriber.

Step 11 Your data is restored on the subscriber server. To view the status of the restore, see the "Viewing the Restore Status" section.

Step 12 Restart the server.


Note Depending on the size of your database and the components that you choose to restore, the system can require one hour or more to restore.


Step 13 When the subscriber has rebooted and is running the restored version of Cisco ER, reboot the publisher.

Step 14 Check the Replication Status value on all nodes by using the utils dbreplication status CLI command as described in the "utils dbreplication status" section on page F-45. The value on each node should equal two.


Tip If replication does not set up properly, use the utils dbreplication reset CLI command as described in the "utils dbreplication reset" section on page F-45.



Viewing the Restore Status

To check the status of the current restore job, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Restore > Status.

The Restore Status page appears.

The Status column in the Restore Status window shows the status of the restoration in progress, including the percentage of completion of the restore procedure.

Step 2 To view the restore log file, click the log filename link.


Viewing the Backup and Restore History

These topics describe how you can see the last 20 backup and restore jobs:

Backup History

Restore History

Backup History

To view the backup history, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Backup > History.

The Backup History page appears.

Step 2 From the Backup History page, you can view the backups that you have performed, including filename, backup device, completion date, result, and features that are backed up.


Note The Backup History page displays only the last 20 backup jobs.



Restore History

To view the restore history, follow these steps:

Procedure


Step 1 From the main Disaster Recovery System web page, select Restore > History.

The Restore History page appears.

Step 2 From the Restore History page, you can view the restores that you have performed, including filename, backup device, completion date, result, and the features that were restored.


Note The Restore History page displays only the last 20 restore jobs.



Trace Files

Trace files for the Master Agent, the GUI, and each Local Agent are written to the following locations:

For the Master Agent, the trace file is platform/drf/trace/drfMA0*

For each Local Agent, the trace file is platform/drf/trace/drfLA0*

For the GUI, the trace file is platform/drf/trace/drfConfLib0*

You can view trace files by using the command line interface. For more information, see Appendix F, "Command Line Interface."

Command Line Interface

The Disaster Recovery System also provides command-line access to a subset of backup and restore functions, as shown in Table 9-3. For detailed information on these commands and for information on using the command line interface, see the Appendix F, "Command Line Interface."

Table 9-3 Disaster Recovery System Command Line Interface 

Command
Description

utils disaster_recovery backup

Starts a manual backup by using the features that are configured in the Disaster Recovery System interface

utils disaster_recovery restore

Starts a restore and requires parameters for backup location, filename, features, and servers to restore

utils disaster_recovery status

Displays the status of ongoing backup or restore job

utils disaster_recovery show_backupfiles

Displays existing backup files

utils disaster_recovery cancel_backup

Cancels an ongoing backup job

utils disaster_recovery show_registration

Displays the currently configured registration

utils disaster_recovery show_tapeid

Displays the tape identification information