Administrator's Guide


Customizing Tivoli Disaster Recovery Manager

DRM provides default settings for the preparation of the disaster recovery plan file and for the management of offsite recovery media. However, DRM also lets you override these default settings. If you want to accept the defaults or return to this subject later, you can go now to Querying the Tivoli Disaster Recovery Manager System Parameters.

Customizing the Contents of Disaster Recovery Plan Files


Task Required Privilege Class
Customize DRM System

This section describes how to customize the disaster recovery plan by using SET commands. You can change the following:

Primary Storage Pools

The disaster recovery plan file default is that all primary storage pools defined to TSM are eligible for procesing unless specified otherwise. You can use the SET DRMPRIMSTGPOOL command or the PRIMSTGPOOL parameter of the PREPARE command to specify that only certain storage pools be processed.

To specify that only the primary storage pools named PRIM1 and PRIM2 are to be processed, enter:

set drmprimstgpool prim1,prim2

Copy Storage Pools

The disaster recovery plan file default is that all copy storage pools defined to TSM are eligible to be processed unless specified otherwise. You can use the SET DRMCOPYSTGPOOL command or the COPYSTGPOOL parameter with the PREPARE command to specify that only certain storage pools be processed.

Assume that the names of the onsite copy storage pools used for recovery from media failures begin with "ONSITE" and that the names of the offsite copy storage pools begin with "OFFSITE." You want only the offsite copy storage pools to be processed. Enter the following:

set drmcopystgpool offsite*
Note:If you specified a list of primary storage pools and plan to specify a list of copy storage pools, the copy storage pool list should name those copy storage pools that are used to back up the specified primary storage pools.

Character Identification for Replacement Volume Names

If you need to restore an entire volume, the replacement volume must have a different name. To restore a primary storage pool volume, you must mark the original volume destroyed and create a replacement volume having a unique name. By default, DRM attaches the @ to the end of the replacement volume name in the disaster recovery plan. For details about the restore process, see How Restore Processing Works.

To use a character other than @ in replacement volume names, issue the SET DRMPLANVPOSTFIX command. For example, to use the character r, enter:

set drmplanvpostfix r

The attached character can help when you are searching the disaster recovery plan for replacement volume names.

Prefix for Recovery Instructions

To specify the prefix portion of the path name for the recovery instructions source files, use the SET DRMINSTRPREFIX command. For example, to specify the prefix as /u/recovery/plans/rpp, enter:

set drminstrprefix /u/recovery/plans/rpp

The disaster recovery plan file will include the information from the following files:

   /u/recovery/plans/rpp.RECOVERY.INSTRUCTIONS.GENERAL
   /u/recovery/plans/rpp.RECOVERY.INSTRUCTIONS.OFFSITE
   /u/recovery/plans/rpp.RECOVERY.INSTRUCTIONS.INSTALL
   /u/recovery/plans/rpp.RECOVERY.INSTRUCTIONS.DATABASE
   /u/recovery/plans/rpp.RECOVERY.INSTRUCTIONS.STGPOOL

You can override the SET DRMINSTRPREFIX command by using the INSTRPREFIX parameter with the PREPARE command.

Note:The recovery instructions files must be created on a file system that supports long file names.

Prefix for the Recovery Plan File

To specify the prefix portion of the path name for the recovery plan file, issue the SET DRMPLANPREFIX command. TSM uses this prefix to identify the location of the recovery plan file. The plan prefix is also used to generate the macros and script file names included in the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE and RECOVERY.SCRIPT.NORMAL.MODE.

The following example specifies the prefix as /u/server/recoveryplans/:

set drmplanprefix /u/server/recoveryplans/

The disaster recovery plan file name created by PREPARE processing will be in the following format:

/u/server/recoveryplans/19990603.013030

You can override this SET command using the PLANPREFIX parameter with the PREPARE command.

Note:The recovery plan file must be created on a file system that supports long file names.

Customizing the Management of Offsite Recovery Media

This section describes how to configure DRM for offsite recovery media management.

Copy Storage Pools

The MOVE DRMEDIA and QUERY DRMEDIA commands can process copy storage pool volumes in the MOUNTABLE state. You can specify that only volumes from certain copy storage pools are eligible for processing. You can specify the copy storage pools in the COPYSTGPOOL parameter of the MOVE DRMEDIA or QUERY DRMEDIA command and in the SET DRMCOPYSTGPOOL command. Any names specified in the COPYSTGPOOL parameter of the MOVE DRMEDIA or QUERY DRMEDIA command override those in the SET DRMCOPYSTGPOOL command.

Not Mountable Location Name

The default name of the location for storing media that are to be shipped offsite is NOTMOUNTABLE. The MOVE DRMEDIA command uses the location name for volumes that are updated to the NOTMOUNTABLE state. To change the name, issue the SET DRMNOTMOUNTABLENAME command.

For example, to specify a location named LOCAL, enter:

set drmnotmountablename local

Courier Name

The MOVE DRMEDIA command uses the courier name to set the location of volumes that are changing from the NOTMOUNTABLE state to the COURIER state or from the VAULTRETRIEVE state to the COURIERRETRIEVE state. At installation, the courier name is set to COURIER. You can change the name with the SET DRMCOURIERNAME command.

For example, to specify a courier named Joe's Courier Service, enter:

set drmcouriername "Joe's Courier Service"

Sequential Media Labels for Checked Out Volumes

At installation, TSM is set to read sequential media labels of volumes checked out with the MOVE DRMEDIA command. To change this setting, use the SET DRMCHECKLABEL command. To specify that DRM should not read the volume labels, enter:

set drmchecklabel no
Note:This command does not apply to 349X library types.

Expiration of a Database Backup Series

A database backup series, both full and incremental and snapshot, is eligible for expiration if all of the following conditions are true:

To set the expiration value to 30 days, enter:

set drmdbbackupexpiredays 30

Processing Backup Volumes of the FILE Device Type

At installation, the MOVE DRMEDIA and QUERY DRMEDIA commands will not process backup volumes that are associated with a device type of FILE. To change the setting, issue the SET DRMFILEPROCESS command. You can use this command to test the DRM environment. To allow processing, enter:

set drmfileprocess yes

Vault Name

The MOVE DRMEDIA command uses the vault name to set the location of volumes that are moving from the COURIER state to the VAULT state. At installation, the vault name is set to VAULT. To change the vault name, use the SET DRMVAULTNAME command.

For example, to specify the vault name as IRONVAULT, the contact name as J. SMITH, and the telephone number as 1-555-000-0000, enter:

set drmvaultname "Ironvault, J. Smith, 1-555-000-0000"

Name of Executable Commands File

You can use the MOVE DRMEDIA or QUERY DRMEDIA command to generate executable commands and store them in a file. If you do not specify the name of that file in the MOVE DRMEDIA or QUERY DRMEDIA command, the file name set with the SET DRMCMDFILENAME command is used. There is no default file name.

To set the file name as /drm/orm/exec.cmds, enter:

set drmcmdfilename /drm/orm/exec.cmds

Querying the Tivoli Disaster Recovery Manager System Parameters

To query the DRM settings, issue the QUERY DRMSTATUS command:

query drmstatus

TSM displays information similar to the following:

+--------------------------------------------------------------------------------+
|            Recovery Plan Prefix: /u/recovery/plans/rpp                         |
|        Plan Instructions Prefix: /u/recovery/plans/source/                     |
|      Replacement Volume Postfix: @                                             |
|           Primary Storage Pools: PRIM1 PRIM2                                   |
|              Copy Storage Pools: COPY*                                         |
|     Not Mountable Location Name: Local                                         |
|                    Courier Name: Joe's Courier Service                         |
|                 Vault Site Name: Ironvault, D. Lastname, 1-000-000-0000        |
|DB Backup Series Expiration Days: 30 Day(s)                                     |
|                    Check Label?: Yes                                           |
|       Process FILE Device Type?: No                                            |
|               Command File Name: /drm/orm/exec.cmds                            |
+--------------------------------------------------------------------------------+

Customizing the Site-Specific Recovery Instructions

The PREPARE command includes in the disaster recovery plan instructions that you create to guide you in the recovery process of your own site. Include your instructions in flat files having the following names:

Note:The files created for the recovery instructions must be physical sequential files.

The PREPARE command includes the information in these files in the disaster recovery plan.

instructionsprefixRECOVERY.INSTRUCTIONS.GENERAL
Include information such as administrator names, telephone numbers, and location of passwords. For example:
+--------------------------------------------------------------------------------+
| Recovery Instructions for TSM Server ACMESRV on system ZEUS.                   |
| Joe Smith  (wk 002-000-1111 hm 002-003-0000)is the primary system programmer.  |
| Salley Doe (wk 002-000-1112 hm 002-005-0000) is primary recovery administrator.|
| Jane Smith (wk 002-000-1113 hm 002-004-0000) is the responsible manager.       |
| Security Considerations:                                                       |
|  Joe Smith has the password for the Admin ID ACMEADM.  If Joe is unavailable,  |
|  you will need to either issue SET AUTHENTICATION OFF or define a new          |
|  administrative user ID at the replacement TSM server console.                 |
+--------------------------------------------------------------------------------+

instructionsprefixRECOVERY.INSTRUCTIONS.OFFSITE
Include information such as the offsite vault location, courier's name, and telephone numbers. For example:
+--------------------------------------------------------------------------------+
| Our offsite vault location is Ironvault, Safetown, Az.                         |
| The phone number is 1-800-000-0008. You need to contact them directly          |
| to authorize release of the tapes to the courier.                              |
| Our courier's name is Fred Harvey.  You can contact him at 1-800-444-0000.     |
| Since our vault is so far away, be sure to give the courier a list             |
| of both the database backup and copy storage pool volumes required. Fred       |
| is committed to returning these volumes to us in less than 12 hours.           |
+--------------------------------------------------------------------------------+

instructionsprefixRECOVERY.INSTRUCTIONS.INSTALL
Include information about how to install the server and where the installation volumes are located.

The disaster recovery plan file issues commands using the administrative client. Ensure that the path to the administrative client is established before running the scripts RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE and RECOVERY.SCRIPT.NORMAL.MODE. For example, set the shell variable PATH or update the scripts with the path specification for the administrative client. The following is sample text for this file:

+--------------------------------------------------------------------------------+
|You will need to reinstall the TSM server and administrative                    |
|client after installing the HP-UX operating system.                             |
|The install volume for the TSM server is INS001. If that is lost, you           |
|will need to contact Copy4You Software, at 1-800-000-0000, and obtain           |
|a new copy. Another possibility is the local IBM Branch office at               |
|555-7777.                                                                       |
+--------------------------------------------------------------------------------+

instructionsprefixRECOVERY.INSTRUCTIONS.DATABASE
Include information about how to recover the database along with how much hardware space is needed.

The following is example text for this file:

+--------------------------------------------------------------------------------+
| You will need to find replacement disk space for the server database.  We have |
| an agreement with Joe Replace that in the event of a disaster, he will         |
| provide us with disk space.                                                    |
+--------------------------------------------------------------------------------+

instructionsprefixRECOVERY.INSTRUCTIONS.STGPOOL
Include information on primary storage pool recovery instructions.

The following is example text for this file:

+--------------------------------------------------------------------------------+
| Do not worry about the archive storage pools during this disaster recovery.    |
| Focus on migration and backup storage pools.                                   |
| The most important storage pool is XYZZZZ.                                     |
+--------------------------------------------------------------------------------+


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]