Cisco IP Telephony Backup and Restore System (BARS) Administration Guide, Version 4.0(12)
Backup and Restore Utility Overview
Downloads: This chapterpdf (PDF - 307.0KB) The complete bookPDF (PDF - 1.74MB) | Feedback

Backup and Restore Utility Overview

Table Of Contents

Backup and Restore Utility Overview

System Requirements

Obtaining BARS

Cisco Unified Communications Applications That Use BARS

Versions of Applications That BARS Supports

Obtaining Release Notes for BARS

How the Backup Portion of the BARS Utility Works

About the Backup Server

About Backup Targets and Data Source Servers

About Backup Data and the Backup File

About the Scheduler

About the Backup Storage Destination

About the Created Backup Log File

What Data Does the BARS Utility Back Up?

Cisco Unified CallManager Version 3.3(x) and 4.0(x)

CDR Analysis and Reporting (CAR)

Cisco Customer Response Solutions

Cisco Emergency Responder

Understanding How the Restore Utility Works

Location of Trace Files

Setting the Trace Directory Path to Default C: Drive


Backup and Restore Utility Overview


The Backup and Restore Utility(called BARS) provides a reliable and convenient way to perform regularly scheduled automatic or user-invoked backups of data for a variety of Cisco Unified Communications products. BARS performs the following tasks:

Saves all settings that are configured with the Cisco Unified Communications Applications Backup and Restore Utility configuration. Figure 1-1 shows the main window of the Backup and Restore System configuration.

Verifies authentication information that you provide during the configuration of the backup.

Backs up the data that you choose.

Creates separate logs for the backup and the restore utilities.

Creates a trace for each task.

Restores the data that was backed up.


Note Use the supported Cisco Backup and Restore System utility if you are running Cisco CallManager 3.3 or later.

If you are using an earlier version of Cisco CallManager, use the Cisco Unified Communications Applications Backup Utility (3.5).

BARS only restores files that were backed up with BARS.


Figure 1-1 Backup and Restore System Main Window

This section contains the following topics:

System Requirements

Obtaining BARS

Cisco Unified Communications Applications That Use BARS

Versions of Applications That BARS Supports

Obtaining Release Notes for BARS

How the Backup Portion of the BARS Utility Works

What Data Does the BARS Utility Back Up?

Understanding How the Restore Utility Works

Location of Trace Files

Setting the Trace Directory Path to Default C: Drive

System Requirements

Be sure the following BARS requirements are met:

For a standalone installation, you must use Microsoft Windows 2000 or 2003 (server) and Internet Information Server (IIS) 5.0.

Ensure that Cisco CallManager 3.3x or above (or one of its associated Cisco IP telephony applications) is installed.

You must use SQL 2000 or above and MSDE 2000 for a standalone Customer Response Solutions (CRS) server to act as a backup target or for a standalone Cisco Emergency Responder (CER) server to act as a backup server for a Cisco CallManager 3.3, 4.0, or 4.1 cluster.

For high availability, CRS supports only MS SQL 2000.

Obtaining BARS

You can obtain BARS from the web or from the CD-ROM that may ship with the supported application. To obtain the latest version of BARS, always download it from the web. The version that is available on the CD-ROM may not provide the latest utility. For the location of the latest web version of BARS, see the "Installation Procedure" section.

Cisco Unified Communications Applications That Use BARS

BARS supports the following applications:

Cisco Unified CallManager

Cisco Customer Response Solutions (CRS)

Cisco CDR Analysis and Reporting (CAR)

Cisco Emergency Responder (CER)

Versions of Applications That BARS Supports

BARS, version 4.0(12), supports the following Cisco Unified Communications applications, which serve as minimum requirements:

Cisco CallManager 3.3 or later

All Cisco CRS and Cisco CAR releases that are compatible with Cisco Unified CallManager

Be sure to check the Cisco Unified CallManager Compatibility matrix at the following URL for information about which components have been tested with various BARS releases:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_device_support_tables_list.html


Note If you receive a warning while using BARS that indicates an incompatibility issue, double-check the matrix. If the matrix indicates that BARS has been tested with the component that the warning specifies, you can ignore the warning.


Cisco Emergency Responder (CER) 1.2(1) or later

Obtaining Release Notes for BARS

The release notes document contains resolved/open caveats and workarounds that apply to this version of the utility. To obtain the document, click the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/bars/index.htm

If you have an account with Cisco.com, you can use the Bug Toolkit to find caveats for this utility.

How the Backup Portion of the BARS Utility Works

This section describes important information about different components of the backup portion of BARS. This section includes the following topics:

About the Backup Server

About Backup Targets and Data Source Servers

About Backup Data and the Backup File

About the Scheduler

About the Backup Storage Destination

About the Created Backup Log File

About the Backup Server

Although any server in the Cisco Unified CallManager cluster can act as the backup server, Cisco recommends that you designate the publisher database server as the backup server, which is the server that performs the backup. You need one backup server within a Cisco Unified CallManager cluster. You designate a server as a backup server during BARS installation.


Note The Cisco Unified CallManager publisher database contains all the information that you configure with Cisco Unified CallManager Administration, and the database updates each time that you make a change. Cisco strongly recommends that you make a backup of the Cisco Unified CallManager database, configuration, and directory information by using BARS every time that you make changes in Cisco Unified CallManager Administration. Each Cisco Unified CallManager cluster contains only one publisher database.


Other Related Definitions

In addition to backup server, two other related terms appear throughout this manual:

Backup target—A server (not the backup server) that contains data that is to get backed up when a BARS backup is invoked. During BARS installation, you designate a server as either a backup server or backup target.

Data source server—A server that you configure in the BARS user interface that contains data that is to get backed up. This includes all backup targets and can also include the backup server itself. Chapter 3 "Backing Up the Data," uses this term in more detail.

Additional Information

For subscriber databases that are configured for backup, BARS backs up only TFTP files and CDR/CMR files.

However, you can configure BARS to back up more than one Cisco Unified Communications Applications Server, such as publishing database servers of other Cisco Unified CallManager clusters, Cisco CER servers, or Cisco Customer Response Solutions (CRS) servers.

To successfully back up the Cisco Unified CallManager database, the backup server and backup targets must exist in the same cluster and have the same version of BARS installed.

For backups to succeed for supported applications, the same version of Cisco Unified CallManager must exist on the backup server and all backup targets.

For more information about the backup server, see Chapter 3 "Backing Up the Data."


Note BARS will back up all nodes in a CRS 4.0 cluster, though you need to specify only one node in the cluster as data source server. That node will back up all the data in the CRS cluster and put the data on the BARS backup server.


About Backup Targets and Data Source Servers

A backup target contains the data to be backed up for Cisco Unified CallManager, CAR, CRS, or CER. You designate a server as a backup target during BARS installation if this server contains data to be backed up and is not the backup server. Ensure that backup targets are configured as data source servers during BARS configuration.

A Cisco Unified CallManager cluster can contain one or more data source servers.

When you add a data source server by using the BARS configuration window, you can enter the computer name, the IP address, or the fully qualified DNS name.

If a data source server is a remote server, you must provide a user name and password that has administrative privileges to the remote server.


Caution Verify that the backup targets and backup server have the same version of BARS installed. Verify that the backup targets and backup server exist in the same cluster.


Caution If the backup server and backup targets are not running and functional, the backup fails. Verify that all corresponding services, such as DC Directory, are running before you perform the backup. If the services are not running, the backup fails.

About Backup Data and the Backup File

During the backup, BARS sends the data to a staging directory, and, by default, one file that is called Backupmm-dd-yy#hh-mm.tar (where mm specifies the month, dd specifies the day, yy specifies the year, hh specifies the hour, and mm specifies the minute) archives all data that is backed up from the data source servers that are listed in the BARS configuration windows.

For more information about the backup file, see Chapter 3 "Backing Up the Data."

About the Scheduler

Using the Scheduler tab (click Backup > Scheduler on the BARS main window), you configure the day and time that you want the backup to run.

Cisco sets a default schedule for when the backup is to run. You can change the schedule at any time, restore the default schedule, and enable/disable the configured schedule.

The utility backs up all data at the same time. You cannot configure a separate schedule for each application.

You must enable the schedule, even if you choose to use the default schedule that Cisco automatically configures. See the "Enabling the Scheduler" section.

After you configure the backup settings, you can initiate a backup at any time. See the "Performing a Backup Now" section.

About the Backup Storage Destination

Each instance of BARS stores all data from all applications in the same backup location.

For the backup destination, Cisco strongly recommends that you specify a tape drive or a network directory, not a local directory. In addition, configure each instance of BARS that is running on the network (whether it is in the same cluster or not) with a unique storage location.

For more information about backup storage location, see the "Configuring the Backup Storage Location" section.

About the Created Backup Log File

The backup process creates a backup log file with the following format:

Backupmm-dd-yy.txt

where mm specifies the month, dd specifies the day, and yy specifies the year

BARS puts this file in the following location on the backup server:

C:\Program Files\Common Files\Cisco\Logs\BARS\Backup

On the Configure Scheduler window, you can specify the number of days for which you want to retain log files. Log files exist for each day that you perform a backup.

For more information, see "Accessing the Backup Log File After the Backup Completes" section.

What Data Does the BARS Utility Back Up?

If you configure the backup settings as instructed in this document, Cisco BARS automatically backs up the information that the following sections list for each supported application:

Cisco Unified CallManager Version 3.3(x) and 4.0(x)

CDR Analysis and Reporting (CAR)

Cisco Customer Response Solutions

Cisco Emergency Responder


Caution The Cisco Unified Communications BARS utility does not back up any operating system files except Hosts and LMhosts files, if these files exist on the server.

Cisco Unified CallManager Version 3.3(x) and 4.0(x)

Cisco Unified CallManager Publisher Database

The following list shows the data that is backed up and restored for the Cisco Unified CallManager publisher database:

Hosts and LMhosts files

Latest Cisco Unified CallManager publisher database

DC Directory LDAP directory

For Cisco CallManager 3.3.x—DirectoryConfiguration.ini from C:\dcdsrvr.

For Cisco Unified CallManager 4.0(x) or later—UMDirectoryConfiguration.ini.

Directory schema files—avvid_schemaV*.txt

Publisher and subscriber configuration information to replication.ini file

Cisco Unified CallManager version to version.ini file

If the option to back up CDR is chosen, CDR database and CDR/CMR flat files from Local CDR Path

TFTP files from C:\Program Files\Cisco\TFTPPath (the default path)

TFTP files from alternate file locations

Cisco Bulk Administration Tool (BAT) files and templates from C:\CiscoWebs\BAT, CSV files from C:\BAT and the BATversion.asp file

HKLM\Software\Cisco Systems, Inc. (registry keys)

Cisco Unified CallManager DSN

Security files (certificates) from under C:\Program Files\Cisco\Certificates. This applies only to Cisco Unified CallManager 4.x or later.

LDAPConfig.ini for Cisco Unified CallManager Assistant configuration

Backup/Restore of Cisco Unified CallManger Related Locale files (*.csv files) from C:\ProgramFiles\CiscoCallManager\DBInstallCSV\Products

Cisco Unified CallManager Subscriber Database

The following list shows the data that is backed up and restored for the Cisco Unified CallManager subscriber database:

LmHosts/Hosts files

Publisher and subscriber configuration information to replication.ini file

Cisco Unified CallManager version to version.ini file

If the option to back up CDR is chosen, CDR database and CDR/CMR flat files from Local CDR Path

TFTP files

Cisco Unified CallManager DSN


Note The BARS utility does not back up the Microsoft Active Directory or Netscape Directory Server database. This utility does not back up Cisco Multilevel Administration (MLA). Refer to the Cisco MLA documentation for information on how to back up that data.


CDR Analysis and Reporting (CAR)

The following list shows the data that is backed up and restored for CDR Analysis and Reporting (CAR):

CAR (ART) database

C:\Ciscowebs\ART\reports\Pregenerated

HKLM\Software\Cisco Systems Inc.\ART (registry key)

Cisco Customer Response Solutions

The following list shows the data that is backed up and restored for Cisco Customer Response Solutions (CRS):

All Versions of Cisco CRS (with CRS server)

LMHosts file and Hosts file

$winsysdir$\Ccn\Ccndir.ini (backed up for CRS 3.5 and earlier)

If present, C:\Program Files\Cisco\bin\SaEnvProperties.ini (backed up for CRS 3.5 and earlier)

Files from C:\Program Files\Wfavvid, including Workflows (.aef), Java files(.java), Jar (.jar), Properties (.properties), and Audio (.wav) (backed up for CRS 3.5 and earlier)

Cisco CRS Release 3.0 and Later (with CRS server)

LMHosts file and Hosts file

$winsysdir$\Ccn\Ccndir.ini

If present, C:\Program Files\Cisco\bin\SaEnvProperties.ini

Files from C:\Program Files\Wfavvid, including Workflows (.aef), Java files(.java), Jar (.jar), Properties (.properties), and Audio (.wav)

Files from C:\Program Files\Wfavvid, including XML (.xml), Class (.class), GSL (.gsl), and Digit (.digit), JobRunner.ini, Sch.ini

War (.war) files from C:\Program Files\Wfavvid\tomcat_appadmin and below

Cfg files (.CFG) from C:\Program Files\Cisco\Common

Cfg files (.CFG) from C:\Program Files\Cisco\Desktop

AlarmService.ini from C:\program Files\Cisco\AlarmService

GSL and .Digit from user and system grammar paths

Databases DB_CRA, DB_CRA_CCDR, SCHEDULERDB

If Spanlink and ICD are installed:

Database FCRASSVR (if ICD is installed)

All files/folders under C:\Program Files\Cisco\Desktop_config\Config

All files/folders under C:\Program Files\Cisco\Desktop_config\Icons

All files/folders under C:\Program Files\Cisco\Desktop_config\Audio Files

Audio files(.wav) from user and system prompt paths

Cisco CRS Release 3.1 and Later (with CRS server)

LMHosts file and Hosts file

$winsysdir$\Ccn\Ccndir.ini

If present, C:\Program Files\Cisco\bin\SaEnvProperties.ini

Files from C:\Program Files\Wfavvid, including Workflows (.aef), Java files(.java), Jar (.jar), Properties (.properties), and Audio (.wav)

Files from C:\Program Files\Wfavvid, including XML (.xml), Class (.class), GSL (.gsl), and Digit (.digit), JobRunner.ini, Sch.ini

War (.war) files from C:\Program Files\Wfavvid\tomcat_appadmin and below

Cfg files (.CFG) from C:\Program Files\Cisco\Common

Cfg files (.CFG) from C:\Program Files\Cisco\Desktop

AlarmService.ini from C:\program Files\Cisco\AlarmService

GSL and .Digit from user and system grammar paths

Databases DB_CRA, DB_CRA_CCDR, SCHEDULERDB

If Spanlink and ICD are installed:

Database FCRASSVR (if ICD is installed)

All files/folders under C:\Program Files\Cisco\Desktop_config\Config

All files/folders under C:\Program Files\Cisco\Desktop_config\Icons

All files/folders under C:\Program Files\Cisco\Desktop_config\Audio Files

Audio files(.wav) from user and system prompt paths

System DSN dsn_cra_hrdb

If ICD is installed, back up the following directory (including all files/folders), if it exists: C:\Program Files\Cisco\Desktop_AudioFiles

Cisco CRS Release 3.1 and Later (RDB server)

LMHosts file and Hosts file

Databases - db_cra, db_cra_ccdr

SQL jobs belonging to category `CRS-RemoteDB Synchronization'

If ICD is installed, back up the following directory (including all files/folders), if it exists: C:\Program Files\Cisco\Desktop_AudioFiles

Cisco CRS Release 3.1 and Later (VOIP and Record server)

C:\Program Files\Cisco\Desktop_Audio Files

CFG files (*.CFG) from C:\program Files\Cisco\Desktop

Cisco CRS Release 4.0 and Later (with CRS server)

Clusters, configurations, and applications profile in LDAP

Workflow scripts that are already uploaded in LDAP

Db_cra, db_cra_repository, FCRasSvr database in the cluster

ICD configuration data (such as open LDAP and flat files)

ICD recording files

Windows hosts and lmhosts

Cisco Unified CallManager JTAPI configuration (jtapi.ini)

User prompts, grammars, and documents under c:\Program Files\wfavvid\Prompts\user and
c:\Program Files\wfavvid\Grammars\user and
c:\Program Files\wfavvid\Documents\user.

Cisco Emergency Responder

Cisco Emergency Responder Versions 1.2.1 and Above

The following list shows the data that is backed up and restored for Cisco Emergency Responder (CER):

LmHosts and Hosts files from C:\Winnt\System32\Drivers\Etc

Latest database CER12XX

Registry key HKEY_LOCAL_MACHINE, "Software\Cisco Systems, Inc.\AVVID E911

Replication information to Replication.ini

Build Number and Minor Version to version.ini

Folders—CallHistory, CERSysFiles, and so on, export, import, nena_msag_records

Files—JTapi.jar from %CERRoot%\lib and SAenvProperties.ini from %Program Files%\Cisco\bin

CER NT Users

Understanding How the Restore Utility Works

The BARS restore process allows you to recover all data that was compressed into the Backupmm-dd-yy.tar file.

BARS puts log files that were created during the restore process into the following folder:

C:\Program Files\Common Files\Cisco\Logs\BARS\Restore

For information on how the restore process works, what log files are created during the restore process, when to run a restore, and the procedures for running a restore, see Chapter 4 "Restoring the Data."


Note For a CRS 4.0 restore, Chapter 4 "Restoring the Data," describes a separate restore process. For CRS versions prior to 4.0, the restore process remains the same as for other applications.


Location of Trace Files

BARS puts trace files that were created during the backup and restore processes into the following folder:

C:\Program Files\Cisco\Trace\BARS

These files will contain detailed information for each BARS operation. Refer to these files in case of a failed backup or restore process.

Setting the Trace Directory Path to Default C: Drive

If you are replacing a server with four drives, set the trace directory path on the server to the default C: drive before you back up your server. After you install Cisco Unified CallManager on the new server, you can configure the trace drive to collect trace files.

Use the following procedure to set the trace directory path to the default:

Procedure


Step 1 In Cisco Unified CallManager Administration, choose Application > Cisco Unified CallManager Serviceability.

The Cisco Unified CallManager Serviceability window displays.

Step 2 Choose Trace > Configuration.

Step 3 From the Server pane on the left side of the Trace Configuration window, click the server name or IP address of the four-disk drive server.

Step 4 Click the Cisco CallManager service.

The Trace Configuration window for the service and server displays.

Step 5 In the upper, right corner of the window, click the SDL Configuration link.

Step 6 In the Trace Directory Path field under Trace Output Settings, change the drive letter to C:.

Step 7 Click Update.