The disaster recovery plan file contains the information required to recover a TSM server to the point in time represented by the last database backup operation that is completed before the plan is created. The plan is organized into stanzas, which you can break out into multiple files.
You can use a Microsoft VBScript command procedure or an editor to break out the stanzas in the disaster recovery plan file into individual files. A sample procedure, planexpl.vbs, is shipped with DRM. You can modify the procedure for your installation. Store a copy of the procedure offsite for recovery.
Figure 90. Example of a VBScript command Procedure to Break Out the Disaster Recovery Plan File
+--------------------------------------------------------------------------------+
|'**************************************************************************** |
|' IBM TSM Disaster Recovery Manager for Windows NT/2000 Sample Script |
|' |
|' Explode a recovery plan file into separate files (batch programs, |
|' TSM macros, TSM server options file etc.) |
|' |
|' Invoke with: |
|' cscript planexpl.vbs recoveryplanfilename |
|' where: |
|' recoveryplanfilename is the name of the recovery plan file created |
|' by the DRM PREPARE command |
|' |
|' Example usage: |
|' cscript planexpl.vbs c:\adsmsrv\recplans\20001115.051421 |
|'***************************************************************************** |
| |
|Dim args |
|Dim PLANFILE, OUTDIR, OUTFILE |
|Dim STANZAS |
|Dim VOLNAMES(100),NbrV,LOGDBVOLS |
|Dim fso, fi, fo |
|Dim WORDS |
|Dim CRLF |
|Dim RESULTS, RESULTS2 |
|CRLF = Chr(13) & Chr(10) |
|LOGDBVOLS = False : NbrV = 0 |
|OUTDIR = "" : OUTFILE = "" |
|RESULTS = "" : RESULTS2 = "" |
| |
|'***************************************************************************** |
|'* Get input arguments: PLANFILE=recoveryplanfilename |
|'***************************************************************************** |
| |
|set args = Wscript.Arguments |
| |
|If args.Count < 1 Then |
| Wscript.Echo _ |
| "usage: cscript planexpl.vbs recoveryplanfilename" & CRLF & _ |
| "example: cscript planexpl.vbs c:\adsmsrv\recplans\20001115.051421" |
| Wscript.Quit(1) |
|Else |
| PLANFILE = args.Item(0) |
|End If |
| |
|RESULTS = RESULTS & "Planfile: " & PLANFILE & CRLF |
|'**************************************************************************** |
|' For each recovery plan file stanza name determine the extension (if any) |
|' to be added to the file name created by using the stanza name and extension |
|'**************************************************************************** |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|Set STANZAS = CreateObject("Scripting.Dictionary") |
|STANZAS.Add "RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE", ".CMD" |
|STANZAS.Add "RECOVERY.SCRIPT.NORMAL.MODE" , ".CMD" |
|STANZAS.Add "RECOVERY.VOLUMES.REQUIRED" , "none" |
|STANZAS.Add "RECOVERY.DEVICES.REQUIRED" , "none" |
|STANZAS.Add "SERVER.REQUIREMENTS" , "none" |
|STANZAS.Add "LOG.VOLUMES" , "none" |
|STANZAS.Add "DB.VOLUMES" , "none" |
|STANZAS.Add "LOGANDDB.VOLUMES.INSTALL" , ".CMD" |
|STANZAS.Add "LICENSE.REGISTRATION" , ".MAC" |
|STANZAS.Add "COPYSTGPOOL.VOLUMES.AVAILABLE" , ".MAC" |
|STANZAS.Add "COPYSTGPOOL.VOLUMES.DESTROYED" , ".MAC" |
|STANZAS.Add "PRIMARY.VOLUMES.DESTROYED" , ".MAC" |
|STANZAS.Add "PRIMARY.VOLUMES.REPLACEMENT.CREATE" , ".CMD" |
|STANZAS.Add "PRIMARY.VOLUMES.REPLACEMENT" , ".MAC" |
|STANZAS.Add "STGPOOLS.RESTORE" , ".MAC" |
|STANZAS.Add "RECOVERY.INSTRUCTIONS.GENERAL" , "none" |
|STANZAS.Add "RECOVERY.INSTRUCTIONS.OFFSITE" , "none" |
|STANZAS.Add "RECOVERY.INSTRUCTIONS.INSTALL" , "none" |
|STANZAS.Add "RECOVERY.INSTRUCTIONS.DATABASE" , "none" |
|STANZAS.Add "RECOVERY.INSTRUCTIONS.STGPOOL" , "none" |
|STANZAS.Add "MACHINE.GENERAL.INFORMATION" , "none" |
|STANZAS.Add "MACHINE.RECOVERY.INSTRUCTIONS" , "none" |
|STANZAS.Add "MACHINE.CHARACTERISTICS" , "none" |
|STANZAS.Add "MACHINE.RECOVERY.MEDIA.REQUIRED" , "none" |
|STANZAS.Add "VOLUME.HISTORY.FILE" , "none" |
|STANZAS.Add "DEVICE.CONFIGURATION.FILE" , "none" |
|STANZAS.Add "DSMSERV.OPT.FILE" , "none" |
|STANZAS.Add "LICENSE.INFORMATION" , "none" |
| |
|Set fso = CreateObject("Scripting.FileSystemObject") |
| |
|Set fi = fso.OpenTextFile(PLANFILE, 1, False) |
| |
|Do While fi.AtEndOfStream <> True |
| |
|'**************************************************************************** |
|' Read a line from the input recovery plan file |
|'**************************************************************************** |
| |
| ALINE = fi.ReadLine |
| |
|'**************************************************************************** |
|' Get the first 2 words. We're looking for 'begin'/'end' and a stanza name |
|'**************************************************************************** |
| |
| WORD1 = "" : WORD2 = "" : THEREST = "" |
| If Not ALINE = "" then |
| WORDS = Split(ALINE, " ", -1, 1) |
| WORD1 = WORDS(0) |
| If Ubound(WORDS) > 0 Then WORD2 = WORDS(1) |
| if Ubound(WORDS) > 1 Then THEREST = WORDS(2) |
| End If |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|'**************************************************************************** |
|' If the first word is 'begin' and this is a stanza that we'll create a file |
|' for then build the output file name using the output directory. Add an |
|' extension if needed. Erase the previous version of the file and then |
|' indicate that the new file is being created. If the stanza contains the |
|' names of database volumes or the names of log volumes then indicate that |
|' these volume names need to be remembered so later checking can be done to |
|' determine if volumes by these names currently exist (since the volumes |
|' will be erased). |
|'**************************************************************************** |
| |
| If WORD1 = "begin" And STANZAS.Exists(WORD2) Then |
| |
| OUTFILE = OUTDIR & WORD2 |
| |
| If Not STANZAS.Item(WORD2) = "none" Then |
| OUTFILE = OUTFILE & STANZAS.Item(WORD2) |
| End If |
| |
| Set fo = fso.OpenTextFile(OUTFILE, 2, True) |
| |
| RESULTS = RESULTS & "Creating file " & OUTFILE & CRLF |
| |
| |
| If WORD2 = "LOG.VOLUMES" Or WORD2 = "DB.VOLUMES" Then |
| LOGDBVOLS = True |
| Else LOGDBVOLS = False |
| End If |
| |
|'**************************************************************************** |
|' If the first word is 'end' and this was a stanza that we created a file |
|' for then close the output file. |
|'**************************************************************************** |
| |
| Elseif WORD1 = "end" And STANZAS.Exists(WORD2) Then |
| fo.close |
| OUTFILE = "" |
| |
|'**************************************************************************** |
|' For input recovery plan file lines that are between the beginning and end |
|' of a stanza that we created an output file for (i.e. we have previously |
|' constructed an output file name) write the line to the output file. If |
|' processing the log volume stanza or the database volume stanza then save |
|' the name of the log or database volume for later checking to determine if |
|' a volume by the same name exists. |
|'**************************************************************************** |
| |
| Elseif Not OUTFILE = "" Then |
| fo.writeline(ALINE) |
| If LOGDBVOLS = True Then |
| NbrV = NbrV + 1 |
| VOLNAMES(NbrV) = WORD1 |
| End If |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|'**************************************************************************** |
|' This is the line within the plan file that identifies the plan file prefix. |
|'**************************************************************************** |
| |
| Elseif OUTDIR = "" And WORD1 = "DRM" And WORD2 = "PLANPREFIX" Then |
| OUTDIR = THEREST |
| If Not Right(OUTDIR,1) = "\" Then |
| OUTDIR = OUTDIR & "." |
| End If |
| RESULTS = RESULTS & "set planprefix to " & OUTDIR & CRLF |
| |
| End If '/* select on first word of input line from the recovery plan file */ |
| |
|Loop '/* do while more lines in input recovery plan file */ |
| |
|fi.close |
| |
|'**************************************************************************** |
|' For each log volume and database volume, determine if a volume by the same |
|' name currently exists. If so, then indicate that the volume is going to be |
|' erased. |
|'**************************************************************************** |
| |
|Set fo = fso.OpenTextFile(OUTDIR & "FILES.TO.BE.ERASED", 2, True) |
| |
|I = 0 |
|FOUND = False |
|Do While I < NbrV |
| I = I + 1 |
| if fso.FileExists(VOLNAMES(I)) then |
| if FOUND = False then |
| WARNING = _ |
| "If executed, the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE batch" & CRLF &|
| "program will delete the following log and db volumes if they exist" & CRLF|
| "and then reallocate them. During a normal disaster recovery scenario" & CR|
| "this is not a problem since you are going to restore data to them" & CRLF |
| "from the db backup." & CRLF & CRLF |
| fo.writeline(WARNING) |
| RESULTS2 = RESULTS2 & CRLF & WARNING |
| FOUND = True |
| End If |
| |
| fo.writeline(VOLNAMES(I)) |
| RESULTS2 = RESULTS2 & VOLNAMES(I) & CRLF |
| End If '/* the file exists */ |
|Loop '/* do while more log and database volume names */ |
| |
|fo.close |
| |
|Wscript.Echo RESULTS |
|If FOUND = True then Wscript.Echo RESULTS2 |
+--------------------------------------------------------------------------------+
The disaster recovery plan is divided into the following types of stanzas:
Note: | The RECOVERY.SCRIPT.NORMAL.MODE and RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE stanzas contain the commands that invoke the scripts and macros contained in the other stanzas. |
Table 29 lists the recovery plan file stanzas, and indicates what type of administrative processing is required during set up, routine operations, and disaster recovery. The table also indicates whether the stanza contains a macro, a script, or a configuration file.
Note: | For tasks identified as During setup or periodic updates, DRM automatically collects this information for the plan. |
Table 29. Administrative Tasks Associated with the Disaster Recovery Plan File
Stanza Name | Tasks |
---|---|
PLANFILE.DESCRIPTION | -- |
PLANFILE.TABLE.OF.CONTENTS | -- |
SERVER.REQUIREMENTS | -- |
RECOVERY.INSTRUCTIONS.GENERAL | During setup or periodic updates: Edit the source file associated with the stanza (optional) |
RECOVERY.INSTRUCTIONS.OFFSITE | During setup or periodic updates: Edit the source file associated with the stanza (optional) |
RECOVERY.INSTRUCTIONS.INSTALL | During setup or periodic updates: Edit the source file associated with the stanza (optional) |
RECOVERY.INSTRUCTIONS.DATABASE | During setup or periodic updates: Edit the source file associated with the stanza (optional) |
RECOVERY.INSTRUCTIONS.STGPOOL | During setup or periodic updates: Edit the source file associated with the stanza (optional) |
RECOVERY.VOLUMES.REQUIRED | During routine processing: MOVE DRMEDIA |
RECOVERY.DEVICES.REQUIRED | -- |
RECOVERY.SCRIPT. DISASTER.RECOVERY.MODE script | During disaster recovery: Edit and run (optional) |
RECOVERY.SCRIPT. NORMAL.MODE script | During disaster recovery: Edit and run (optional) |
LOG.VOLUMES | During disaster recovery: Optionally edit/copy |
DB.VOLUMES | During disaster recovery: Optionally edit/copy |
LOGANDDB.VOLUMES.INSTALL script | During disaster recovery: Edit and run (optional) |
LICENSE.REGISTRATION macro | During disaster recovery: Edit and run (optional) |
COPYSTGPOOL.VOLUMES.AVAILABLE macro | During routine processing: MOVE DRMEDIA
During disaster recovery: Edit and run (optional) |
COPYSTGPOOL.VOLUMES.DESTROYED macro | During routine processing: MOVE DRMEDIA
During disaster recovery: Edit and run (optional) |
PRIMARY.VOLUMES.DESTROYED macro | During disaster recovery: Edit and run (optional) |
PRIMARY.VOLUMES.REPLACEMENT.CREATE script | During disaster recovery: Edit and run (optional) |
PRIMARY.VOLUMES.REPLACEMENT macro | During disaster recovery: Edit and run (optional) |
STGPOOLS.RESTORE macro | During disaster recovery: Edit and run (optional) |
VOLUME.HISTORY.FILE configuration file | During disaster recovery: Copy (optional) |
DEVICE.CONFIGURATION.FILE configuration file | During disaster recovery: Edit and copy (optional) |
DSMSERV.OPT.FILE configuration file | During disaster recovery: Edit and copy (optional) |
LICENSE.INFORMATION | -- |
MACHINE.GENERAL.INFORMATION | During setup or periodic updates: Issue DEFINE MACHINE ADSMSERVER=YES (optional) |
MACHINE.RECOVERY.INSTRUCTIONS | During setup or periodic updates: Issue INSERT MACHINE RECOVERYINSTRUCTIONS (optional) |
MACHINE.RECOVERY.CHARACTERISTICS | During setup or periodic updates: Issue INSERT MACHINE CHARACTERISTICS (optional) |
MACHINE.RECOVERY.MEDIA | During setup or periodic updates: Issue DEFINE RECOVERYMEDIA and DEFINE RECMEDMACHASSOCIATION (optional) |
This section contains an example of a disaster recovery plan file and information about each stanza. The disaster recovery plan file has been divided into separate figures that correlate to the descriptions of specific stanzas within each figure.
PLANFILE.DESCRIPTION
Identifies the server for this recovery plan, and the date and time the plan is created.
Figure 91. Description Stanza
+--------------------------------------------------------------------------------+
|begin PLANFILE.DESCRIPTION |
| |
|Recovery Plan for Server DESIGN_DEPARTMENT |
|Created by DRM PREPARE on 02/11/2000 10:20:34 |
|DRM PLANPREFIX c:\Program Files\Tivoli\TSM\server2\prepare\ |
|Server for Windows NT - Version 4, Release 1, Level x.x/x.x |
| |
|end PLANFILE.DESCRIPTION |
| |
+--------------------------------------------------------------------------------+
PLANFILE.TABLE.OF.CONTENTS
Lists the stanzas documented in this plan.
Figure 92. Table of Contents Stanza
+--------------------------------------------------------------------------------+
| begin PLANFILE.TABLE.OF.CONTENTS |
| |
|PLANFILE.DESCRIPTION |
|PLANFILE.TABLE.OF.CONTENTS |
| |
|Server Recovery Stanzas: |
| SERVER.REQUIREMENTS |
| RECOVERY.INSTRUCTIONS.GENERAL |
| RECOVERY.INSTRUCTIONS.OFFSITE |
| RECOVERY.INSTRUCTIONS.INSTALL |
| RECOVERY.VOLUMES.REQUIRED |
| RECOVERY.DEVICES.REQUIRED |
| RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script |
| RECOVERY.SCRIPT.NORMAL.MODE script |
| |
| LOG.VOLUMES |
| DB.VOLUMES |
| LOGANDDB.VOLUMES.INSTALL script |
| LICENSE.REGISTRATION macro |
| COPYSTGPOOL.VOLUMES.AVAILABLE macro |
| COPYSTGPOOL.VOLUMES.DESTROYED macro |
| PRIMARY.VOLUMES.DESTROYED macro |
| PRIMARY.VOLUMES.REPLACEMENT.CREATE script |
| PRIMARY.VOLUMES.REPLACEMENT macro |
| STGPOOLS.RESTORE macro |
| VOLUME.HISTORY.FILE |
| DEVICE.CONFIGURATION.FILE |
| DSMSERV.OPT.FILE |
| |
|Machine Description Stanzas: |
| MACHINE.GENERAL.INFORMATION |
| MACHINE.RECOVERY.INSTRUCTIONS |
| MACHINE.CHARACTERISTICS |
| MACHINE.RECOVERY.MEDIA.REQUIRED |
| |
|end PLANFILE.TABLE.OF.CONTENTS |
| |
+--------------------------------------------------------------------------------+
SERVER.REQUIREMENTS
Identifies the database and recovery log storage requirements for the server. The replacement server must have enough disk space to install the database and recovery log volumes. This stanza also identifies the TSM installation directory. When TSM is re-installed on the replacement server, specify this directory on the Setup Type screen during installation. If you specify a different directory, edit the plan file to account for this change.
Figure 93. Server Requirements Stanza
+--------------------------------------------------------------------------------+
| begin SERVER.REQUIREMENTS |
| |
|Database Requirements Summary: |
| |
| Available Space (MB): 20 |
| Assigned Capacity (MB): 20 |
| Pct. Utilization: 2.2 |
|Maximum Pct. Utilization: 2.2 |
| Physical Volumes: 2 |
| |
|Recovery Log Requirements Summary: |
| |
| Available Space (MB): 20 |
| Assigned Capacity (MB): 20 |
| Pct. Utilization: 4.4 |
|Maximum Pct. Utilization: 4.8 |
| Physical Volumes: 2 |
|Installation Directory: c:\Program Files\Tivoli\TSM\ |
|end SERVER.REQUIREMENTS |
+--------------------------------------------------------------------------------+
The administrator enters recovery instructions into source files that the PREPARE command includes in the plan files. See Specifying Recovery Instructions for Your Site for details.
Note: | In the following descriptions, prefix represents the prefix portion of the file name. See Specifying Defaults for the Disaster Recovery Plan File for details. |
RECOVERY.INSTRUCTIONS.GENERAL
Identifies site-specific instructions that the administrator has entered in the file identified by prefix RECOVERY.INSTRUCTIONS.GENERAL. The instructions should include the recovery strategy, key contact names, an overview of key applications backed up by this server, and other relevant recovery instructions.
Figure 94. Recovery Instructions General Stanza
+--------------------------------------------------------------------------------+
|begin RECOVERY.INSTRUCTIONS.GENERAL |
| |
| This server contains the backup and archive data for FileRight Company |
| accounts receivable system. It also is used by various end users in the |
| finance and materials distribution organizations. |
| The storage administrator in charge of this server is Jane Doe 004-001-0006. |
| If a disaster is declared, here is the outline of steps that must be completed.|
| 1. Determine the recovery site. Our alternate recovery site vendor is IBM |
| BRS in Tampa, Fl, USA 213-000-0007. |
| 2. Get the list of required recovery volumes from this recovery plan file |
| and contact our offsite vault so that they can start pulling the |
| volumes for transfer to the recovery site. |
| 3. etc... |
| |
|end RECOVERY.INSTRUCTIONS.GENERAL |
| |
+--------------------------------------------------------------------------------+
RECOVERY.INSTRUCTIONS.OFFSITE
Contains instructions that the administrator has entered in the file identified by prefix RECOVERY.INSTRUCTIONS.OFFSITE. The instructions should include the name and location of the offsite vault, and how to contact the vault (for example, a name and phone number).
Figure 95. Recovery Instructions Offsite Stanza
+--------------------------------------------------------------------------------+
|begin RECOVERY.INSTRUCTIONS.OFFSITE |
| |
| Our offsite vaulting vendor is OffsiteVault Inc. |
| Their telephone number is 514-555-2341. Our account rep is Joe Smith. |
| Our account number is 1239992. Their address is ... |
| Here is a map to their warehouse ... |
| Our courier is ... |
| |
|end RECOVERY.INSTRUCTIONS.OFFSITE |
+--------------------------------------------------------------------------------+
RECOVERY.INSTRUCTIONS.INSTALL
Contains instructions that the administrator has entered in the file identified by prefix RECOVERY.INSTRUCTIONS.INSTALL. The instructions should include how to rebuild the base server machine and the location of the system image backup copies.
Figure 96. Recovery Instructions Install Stanza
+--------------------------------------------------------------------------------+
|begin RECOVERY.INSTRUCTIONS.INSTALL |
| |
| The base server system is Windows NT 4.0 running on an IBM |
| PC-350. The Windows NT 4.0 operating system and product |
| installation media is stored at the vault. There is also a copy |
| in bldg 24 room 4 cabinet a. The system administrator responsible |
| for the Windows NT 4.0 and server installation is Fred Myers. |
| Following are the instructions for installation of Windows NT |
| 4.0 |
| and the server: |
| |
|end RECOVERY.INSTRUCTIONS.INSTALL |
+--------------------------------------------------------------------------------+
RECOVERY.INSTRUCTIONS.DATABASE
Contains instructions that the administrator has entered in the file identified by prefix RECOVERY.INSTRUCTIONS.DATABASE. The instructions should include how to prepare for the database recovery. For example, you may enter instructions on how to initialize or load the backup volumes for an automated library. No sample of this stanza is provided.
RECOVERY.INSTRUCTIONS.STGPOOL
Contains instructions that the administrator has entered in the file identified by prefix RECOVERY.INSTRUCTIONS.STGPOOL. The instructions should include the names of your software applications and the copy storage pool names containing the backup of these applications. No sample of this stanza is provided.
RECOVERY.VOLUMES.REQUIRED
Provides a list of the database backup and copy storage pool volumes required to recover the server. This list can include both virtual volumes and nonvirtual volumes. A database backup volume is included if it is part of the most recent database backup series. A copy storage pool volume is included if it is not empty and not marked destroyed.
If you are using a nonvirtual volume environment and issuing the MOVE DRMEDIA command, a blank location field means that the volumes are onsite and available to the server. This volume list can be used in periodic audits of the volume inventory of the courier and vault. You can use the list to collect the required volumes before recovering the server.
For virtual volumes, the location field contains the target server name.
Figure 97. Volume Requirements Stanza
+--------------------------------------------------------------------------------+
| begin RECOVERY.VOLUMES.REQUIRED |
| |
|Volumes required for data base restore |
| Location = OffsiteVault Inc. |
| Device Class = LIB8MM |
| Volume Name = |
| TPBK08 |
| Location = OffsiteVault Inc. |
| Device Class = LIB8MM |
| Volume Name = |
| TPBK06 |
| |
|Volumes required for storage pool restore |
| Location = OffsiteVault Inc. |
| Copy Storage Pool = CSTORAGEPF |
| Device Class = LIB8MM |
| Volume Name = |
| TPBK05 |
| TPBK07 |
| |
|end RECOVERY.VOLUMES.REQUIRED |
+--------------------------------------------------------------------------------+
RECOVERY.DEVICES.REQUIRED
Provides details about the devices needed to read the backup volumes.
Figure 98. Volume and Device Requirements Stanzas
+--------------------------------------------------------------------------------+
|begin RECOVERY.DEVICES.REQUIRED |
| |
| Purpose: Description of the devices required to read the |
| volumes listed in the recovery volumes required stanza. |
| |
| Device Class Name: LIB8MM |
| Device Access Strategy: Sequential |
| Storage Pool Count: 2 |
| Device Type: 8MM |
| Format: DRIVE |
| Est/Max Capacity (MB): 4.0 |
| Mount Limit: 2 |
| Mount Wait (min): 60 |
| Mount Retention (min): 10 |
| Label Prefix: TIVSM |
| Library: RLLIB |
| Directory: |
|Last Update by (administrator): Bill |
| Last Update Date/Time: 12/11/2000 10:18:34 |
| |
|end RECOVERY.DEVICES.REQUIRED |
+--------------------------------------------------------------------------------+
RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE
Contains a script with the commands needed to recover the server. You can use the script as a guide and run the commands from a command line. Or you can copy it to a file, modify it and the files it refers to, and run the script. You may need to modify the script because of differences between the original and the replacement systems. At the completion of these steps, client requests for file restores are satisfied directly from copy storage pool volumes.
The disaster recovery plan issues commands using the administrative client.
The commands in the script do the following:
Attention: When this script runs, any log volumes or database volumes with the same names as those named in the plan are erased (see LOGANDDB.VOLUMES.INSTALL). In most disaster recoveries, the TSM server is installed on a new machine. When this script is run, it is assumed that there is no TSM data in the log or database volumes. TSM installation includes the creation of database and recovery log volumes. If you have created a log volume or a database volume (for example, for testing), and you want to preserve the contents, you must take some action such as renaming the volume or copying the contents before executing this script.
To help understand the operations being performed in this script, see Backup and Recovery Scenarios.
Note: | Because this script invokes the administrative command-line client, ensure that the communications options in the administrative client options file are set to communicate with the recovered server before running this script. To review the communications options used in the recovered server, see the server options file in the DSMSERV.OPT.FILE stanza. |
To invoke this script, specify the following positional parameters:
For example, to invoke this script using an administrator ID of don and a password of mox, enter the following command:
planprefixRECOVERY.SCRIPT.DISASTER.RECOVERY.MODE don mox
For more information, see the entry for the recovery plan prefix in Table 27.
The following stanza contains text strings that are too long to display in the hardcopy or softcopy publications. The long text strings utilize a plus symbol (+) to indicate string continuation on the next line.
Figure 99. Disaster Recovery Mode Script
+--------------------------------------------------------------------------------+
|begin RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script |
| |
|@echo off |
| |
| rem Purpose: This script contains the steps required to recover the server |
| rem to the point where client restore requests can be satisfied |
| rem directly from available copy storage pool volumes. |
| rem Note: This script assumes that all volumes necessary for the restore have |
| rem been retrieved from the vault and are available. This script assumes |
| rem the recovery environment is compatible (essentially the same) as the |
| rem original. Any deviations require modification to this script and the |
| rem macros and scripts it runs. Alternatively, you can use this |
| rem script as a guide, and manually execute each step. |
| |
|if not %1.==. if not %2.==. goto start |
| echo Specify the following positional parameters: |
| echo administrative client ID and password. |
| echo Script stopped. |
| goto end |
|:start |
| rem Set the server working directory. |
|pushd c:\Program Files\Tivoli\TSM\server2\ |
| rem Restore server options, volume history, device configuration files. |
|copy c:\Program Files\Tivoli\TSM\server2\prepare\DSMSERV.OPT.FILE c:\Program Files\T|
|copy c:\Program Files\Tivoli\TSM\server2\prepare\VOLUME.HISTORY.FILE c:\Program File|
|copy c:\Program Files\Tivoli\TSM\server2\prepare\DEVICE.CONFIGURATION.FILE c:\Progra|
| |
| rem create the log and database files. |
|call c:\Program Files\Tivoli\TSM\server2\prepare\LOGANDDB.VOLUMES.INSTALL.CMD 1>|
| c:\Program Files\Tivoli\TSM\server2\prepare\LOGANDDB.VOLUMES.INSTALL.LOG 2>&1 |
|type c:\Program Files\Tivoli\TSM\server2\prepare\LOGANDDB.VOLUMES.INSTALL.LOG |
| |
| rem Restore the server database to latest version backed up per the |
| rem volume history file. |
|c:\Program Files\Tivoli\TSM\server\dsmserv -k "Server2" restore db todate=08/11/2000 tot|
| |
| rem Start the server. |
|start c:\Program Files\Tivoli\TSM\server\dsmserv -k "Server2" |
|echo Wait for the server to start. Ensure that the Administrative command |
|echo line client option file is set up to communicate with this server, then |
|echo press enter to continue recovery script execution. |
|pause |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| rem Set the administrative command line client directory. |
|pushd c:\Program Files\Tivoli\TSM\saclient\ |
| |
| rem Register Server Licenses. |
|dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare|
| macro c:\Program Files\Tivoli\TSM\server2\prepare\LICENSE.REGISTRATION.MAC |
| |
| rem Tell Server these copy storage pool volumes are available for use. |
| rem Recovery Administrator: Remove from macro any volumes not obtained from vault|
|dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare\COP|
| macro c:\Program Files\Tivoli\TSM\server2\prepare\COPYSTGPOOL.VOLUMES.AVAILABLE.|
| |
| rem Volumes in this macro were not marked as 'offsite' at the time |
| rem PREPARE ran. They were likely destroyed in the disaster. |
| rem Recovery Administrator: Remove from macro any volumes not destroyed. |
|dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare\COP|
|macro c:\Program Files\Tivoli\TSM\server2\prepare\COPYSTGPOOL.VOLUMES.DESTROYED.|
| |
| rem Mark primary storage pool volumes as ACCESS=DESTROYED. |
| rem Recovery administrator: Remove from macro any volumes not destroyed. |
|dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare\PRI|
|macro c:\Program Files\Tivoli\TSM\server2\prepare\PRIMARY.VOLUMES.DESTROYED.MAC |
| |
| rem Restore the previous working directory. |
|popd |
| |
| rem Restore the previous working directory. |
|popd |
| |
|:end |
|end RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script |
+--------------------------------------------------------------------------------+
RECOVERY.SCRIPT.NORMAL.MODE
Contains a script with the commands needed to restore the server primary storage pools. You can use the script as a guide and run the commands from a command line. Or you can copy it to a file, modify it and the files it refers to, and run the script. You may need to modify the script because of differences between the original and the replacement systems.
The disaster recovery plan issues commands using the administrative client.
At the completion of these steps, client requests for file restores are satisfied from primary storage pool volumes. Clients should also be able to resume file backup, archive, and migration functions.
This script invokes the script contained in the PRIMARY.VOLUMES.REPLACEMENT.CREATE stanza: It also invokes the macros contained in the following stanzas:
To help understand the operations being performed in this script, see Backup and Recovery Scenarios.
Note: | Because this script invokes the administrative client, you should ensure that the communications options in the client options file are set to communicate with the recovered server before running this script. To review the communications options used in the recovered server, see the server options file in the DSMSERV.OPT.FILE stanza. |
To invoke this script, specify the following positional parameters:
For example, to invoke this script using an administrator ID of don and a password of mox, enter the following command:
planprefixRECOVERY.SCRIPT.NORMAL.MODE don mox
For more information, see the entry for the recovery plan prefix in Table 27.
The following stanza contains text strings that are too long to display in the hardcopy or softcopy publications. The long text strings utilize a plus symbol (+) to indicate string continuation on the next line.
Figure 100. Normal Mode Script
+--------------------------------------------------------------------------------+ |begin RECOVERY.SCRIPT.NORMAL.MODE script | | | |@echo off | | rem Purpose: This script contains the steps required to recover the server | | rem primary storage pools. This mode allows you to return the | | rem copy storage pool volumes to the vault and to run the | | rem server as normal. | | rem Note: This script assumes that all volumes necessary for the restore | | rem have been retrieved from the vault and are available. This script | | rem assumes the recovery environment is compatible (essentially the | | rem same) as the original. Any deviations require modification to this | | rem script and the macros and scripts it runs. Alternatively, | | rem you can use this script as a guide, and manually execute each step. | | | |if not %1.==. if not %2.==. goto start | | echo Specify the following positional parameters: | | echo administrative client ID and password. | | echo Script stopped. | | goto end | |:start | | | | rem Create replacement volumes for primary storage pools that use device | | rem class DISK. | | rem Recovery administrator: Edit script for your replacement volumes. | |call c:\Program Files\Tivoli\TSM\server2\prepare\PRIMARY.VOLUMES.REPLACEMENT.CREATE&| | c:\Program Files\Tivoli\TSM\server2\prepare\PRIMARY.VOLUMES.REPLACEMENT.CREATE.LOG | |type c:\Program Files\Tivoli\TSM\server2\prepare\PRIMARY.VOLUMES.REPLACEMENT.CREATE&| | | | rem Set the administrative command line client directory. | |pushd c:\Program Files\Tivoli\TSM\saclient\ | | | |rem Define replacement volumes in the primary storage pools. Must | | rem have different name than original. | | rem Recovery administrator: Edit macro for your replacement volumes. | |dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare\PRI| |macro c:\Program Files\Tivoli\TSM\server2\prepare\PRIMARY.VOLUMES.REPLACEMENT.MA| | | | rem Restore the primary storage pools from the copy storage pools. | |dsmadmc -id=%1 -pass=%2 -ITEMCOMMIT -OUTFILE=c:\Program Files\Tivoli\TSM\server2\prepare| |macro c:\Program Files\Tivoli\TSM\server2\prepare\STGPOOLS.RESTORE.MAC | | | | rem Restore the previous working directory. | |popd | | | |:end | | | |end RECOVERY.SCRIPT.NORMAL.MODE script | +--------------------------------------------------------------------------------+ |
The following stanzas contain text strings that are too long to display in the hardcopy or softcopy publications. A plus symbol (+) indicates that a string continues on the next line.
LOG.VOLUMES
Contains the names and sizes of the log volumes to be installed. You can copy it to a file and modify it if you are changing the log volumes to be initialized. The contents of this stanza must be placed into a separate file to be used by the LOGANDDB.VOLUMES.INSTALL script.
Figure 101. Recovery Log Volumes Stanza
+--------------------------------------------------------------------------------+
|begin LOG.VOLUMES |
|c:\Program Files\Tivoli\TSM\server2\logs\lg01x 12 |
|c:\Program Files\Tivoli\TSM\server2\logs\lg02x 8 |
|end LOG.VOLUMES |
+--------------------------------------------------------------------------------+
DB.VOLUMES
Contains the names and sizes of the database volumes to be initialized. You can copy it to a file and modify it if you are changing the database volumes to be initialized. The contents of this stanza must be placed into a separate file to be used by the LOGANDDB.VOLUMES.INSTALL script.
Figure 102. Database Volume Stanza
+--------------------------------------------------------------------------------+
|begin DB.VOLUMES |
|c:\Program Files\Tivoli\TSM\server2\dbs\db01x 12 |
|c:\Program Files\Tivoli\TSM\server2\dbs\db02x 8 |
|end DB.VOLUMES |
| |
+--------------------------------------------------------------------------------+
LOGANDDB.VOLUMES.INSTALL
Contains a script with the commands required to initialize the database and log volumes. This script is invoked by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
Figure 103. Install Database and Recovery Log Volumes Stanza
+--------------------------------------------------------------------------------+
|begin LOGANDDB.VOLUMES.INSTALL script |
| |
|@echo off |
| |
| rem Purpose: Create the log and database volumes. |
| rem Recovery Administrator: Run this to initialize a server. |
| |
| rem Set the server working directory. |
|pushd c:\Program Files\Tivoli\TSM\server2\ |
| |
| rem Attempt to erase any existing log and database volumes. |
|erase c:\Program Files\Tivoli\TSM\server2\logs\lg01x |
|erase c:\Program Files\Tivoli\TSM\server2\logs\lg02x |
|erase c:\Program Files\Tivoli\TSM\server2\dbs\db01x |
|erase c:\Program Files\Tivoli\TSM\server2\dbs\db02x |
| |
| rem Create the log and database volumes. |
|c:\Program Files\Tivoli\TSM\server\dsmserv -k 'Server2' install 2 FILE:c:\Progra|
|\prepare\LOG.VOLUMES 2 FILE:c:\Program Files\Tivoli\TSM\server2\prepare\DB.VOLUM|
| |
| rem Restore the previous working directory. |
|popd |
| |
|end LOGANDDB.VOLUMES.INSTALL script |
+--------------------------------------------------------------------------------+
LICENSE.REGISTRATION
Contains a macro to register your server licenses. This macro is invoked by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
Figure 104. License Registration Macro Stanza
+--------------------------------------------------------------------------------+
|begin LICENSE.REGISTRATION macro |
| |
| /* Purpose: Register the Server licenses by specifying the names */ |
| /* of the enrollment certificate files necessary to recreate the */ |
| /* licenses that existed in the server. */ |
| /* Recovery Administrator: Review licenses and add or delete licenses */ |
| /* as necessary. */ |
| |
|register license file(50client.lic) |
|register license file(network.lic) |
|register license file(drm.lic) |
| |
|end LICENSE.REGISTRATION macro |
+--------------------------------------------------------------------------------+
COPYSTGPOOL.VOLUMES.AVAILABLE
Contains a macro to mark copy storage pool volumes that were moved offsite and then moved back onsite. This stanza does not include copy storage pool virtual volumes. You can use the information as a guide and issue the administrative commands, or you can copy it to a file, modify it, and run it. This macro is invoked by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
After a disaster, compare the copy storage pool volumes listed in this stanza with the volumes that were moved back onsite. You should remove entries from this stanza for any missing volumes.
Figure 105. Copy Storage Pool Volumes Available Stanza
+--------------------------------------------------------------------------------+
|begin COPYSTGPOOL.VOLUMES.AVAILABLE macro |
| |
| /* Purpose: Mark copy storage pool volumes as available for use in recovery. */|
| /* Recovery Administrator: Remove any volumes that have not been obtained */|
| /* from the vault or are not available for any reason. */|
| /* Note: It is possible to use the mass update capability of the */|
| /* UPDATE command instead of issuing an update for each volume. However, */|
| /* the 'update by volume' technique used here allows you to select */|
| /* a subset of volumes to be processed. */|
| |
| upd vol TPBK05 acc=READW wherestg=CSTORAGEPF |
| upd vol TPBK07 acc=READW wherestg=CSTORAGEPF |
| |
|end COPYSTGPOOL.VOLUMES.AVAILABLE macro |
+--------------------------------------------------------------------------------+
COPYSTGPOOL.VOLUMES.DESTROYED
Contains a macro to mark copy storage pool volumes as unavailable if the volumes were onsite at the time of the disaster. This stanza does not include copy storage pool virtual volumes. These volumes are considered offsite and have not been destroyed in a disaster. You can use the information as a guide and issue the administrative commands from a command line, or you can copy it to a file, modify it, and run it. This macro is invoked by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
After a disaster, compare the copy storage pool volumes listed in this stanza with the volumes that were left onsite. If you have any of the volumes and they are usable, you should remove their entries from this stanza.
Figure 106. Copy Storage Pool Volumes Destroyed Stanza
+--------------------------------------------------------------------------------+
|begin COPYSTGPOOL.VOLUMES.DESTROYED macro |
| |
| /* Purpose: Mark destroyed copy storage pool volumes as unavailable. */ |
| /* Volumes in this macro were not marked as 'offsite' at the time the */ |
| /* PREPARE ran. They were likely destroyed in the disaster. */ |
| /* Recovery Administrator: Remove any volumes that were not destroyed. */ |
| |
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk02 acc=DESTROYED wherestg=BAC|
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk01x acc=DESTROYED wherestg=BA|
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk03 acc=DESTROYED wherestg= BA|
| upd vol BACK4X acc=DESTROYED wherestg=BACKUPPOOLT |
| |
|end COPYSTGPOOL.VOLUMES.DESTROYED macro |
+--------------------------------------------------------------------------------+
PRIMARY.VOLUMES.DESTROYED
Contains a macro to mark primary storage pool volumes as destroyed if the volumes were onsite at the time of disaster. You can use the information as a guide and run the administrative commands from a command line, or you can copy it to a file, modify it, and run it. This macro is invoked by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
During recovery, compare the primary storage pool volumes listed in this stanza with the volumes that were onsite. If you have any of the volumes and they are usable, remove their entries from the stanza.
This stanza does not include primary storage pool virtual volumes. These volumes are considered offsite and have not been destroyed in a disaster.
Figure 107. Primary Storage Volumes Destroyed Stanza
+--------------------------------------------------------------------------------+
|begin PRIMARY.VOLUMES.DESTROYED macro |
| |
| /* Purpose: Mark primary storage pool volumes as ACCESS=DESTROYED. */ |
| /* Recovery administrator: Delete any volumes listed here */ |
| /* that you do not want to recover. */ |
| /* Note: It is possible to use the mass update capability of the */ |
| /* UPDATE command instead of issuing an update for each volume. However*/ |
| /* the 'update by volume' technique used here allows you to select */ |
| /* a subset of volumes to be marked as destroyed. */ |
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk02 acc=DESTROYED wherestg=BAC|
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk01x acc=DESTROYED wherestg=BA|
| upd vol c:\Program Files\Tivoli\TSM\server2\stg\bk03 acc=DESTROYED wherestg= BA|
| upd vol BACK4X acc=DESTROYED wherestg=BACKUPPOOLT |
| |
|end PRIMARY.VOLUMES.DESTROYED macro |
+--------------------------------------------------------------------------------+
PRIMARY.VOLUMES.REPLACEMENT.CREATE
Contains a script with the commands needed to recreate the primary disk storage pool volumes. You can use the script as a guide and run the commands from a command line, or you can copy thew script to a file, modify it, and run it. This script is invoked by the RECOVERY.SCRIPT.NORMAL.MODE script.
The SET DRMPLANVPOSTFIX command adds a character to the end of the names of the original volumes listed in this stanza. This character does the following:
Notes:
This stanza does not include primary storage pool virtual volumes, because these volumes are considered offsite and have not been destroyed in a disaster.
Figure 108. Primary Storage Volumes Replacement Stanza
+--------------------------------------------------------------------------------+
|begin PRIMARY.VOLUMES.REPLACEMENT.CREATE script |
| |
|@echo off |
| |
| rem Purpose: Create replacement volumes for primary storage pools that |
| rem use device class DISK. |
| rem Recovery administrator: Edit this section for your replacement |
| rem volume names. New name must be unique, i.e. different from any |
| rem original or other new name. |
| |
| rem Set the utility directory. |
|pushd c:\Program Files\Tivoli\TSM\utils\ |
| |
|echo Replace c:\Program Files\Tivoli\TSM\server2\stg\bk02 DISK 16M in BACKUPPOOL|
|dsmfmt -data c:\Program Files\Tivoli\TSM\server2\stg\bk02x@ 16 |
| |
|echo Replace c:\Program Files\Tivoli\TSM\server2\stg\bk01x DISK 5M in BACKUPPOOL|
|dsmfmt -data c:\Program Files\Tivoli\TSM\server2\stg\bk01x@ 5 |
| |
| rem Restore the previous working directory. |
|popd |
| |
|end PRIMARY.VOLUMES.REPLACEMENT.CREATE script |
+--------------------------------------------------------------------------------+
PRIMARY.VOLUMES.REPLACEMENT
Contains a macro to define primary storage pool volumes to the server. You can use the macro as a guide and run the administrative commands from a command line, or you can copy it to a file, modify it, and execute it. This macro is invoked by the RECOVERY.SCRIPT.NORMAL.MODE script.
Primary storage pool volumes with entries in this stanza have at least one of the following three characteristics:
The SET DRMPLANVPOSTFIX command adds a character to the end of the names of the original volumes listed in this stanza. This character does the following:
Notes:
This stanza does not include primary storage pool virtual volumes. These volumes are considered offsite and have not been destroyed in a disaster.
Figure 109. Primary Storage Volumes Replacement Stanza
+--------------------------------------------------------------------------------+
|begin PRIMARY.VOLUMES.REPLACEMENT macro |
| /* Purpose: Define replacement primary storage pool volumes for either: */ |
| /* 1. Original volume in a storage pool whose device class was DISK. */ |
| /* 2. Original volume in a storage pool with MAXSCRATCH=0. */ |
| /* 3. Original volume in a storage pool and volume scratch=no. */ |
| /* Recovery administrator: Edit this section for your replacement */ |
| /* volume names. New name must be unique, i.e. different from any */ |
| /* original or other new name. */ |
| /* Replace c:\Program Files\Tivoli\TSM\server2\stg\bk02 DISK 16M in BACKUPPOOL |
| def vol BACKUPPOOL c:\Program Files\Tivoli\TSM\server2\stg\bk02@ acc=READW |
| |
| /* Replace c:\Program Files\Tivoli\TSM\server2\stg\bk01x DISK 5M in BACKUPPOO|
| def vol BACKUPPOOL c:\Program Files\Tivoli\TSM\server2\stg\bk01x@ acc=READW |
| |
| /* Replace c:\Program Files\Tivoli\TSM\server2\stg\bk03 FILES 4M in BACKUPPOO|
| def vol BACKUPPOOLF c:\Program Files\Tivoli\TSM\server2\stg\bk03@ acc=READW |
| |
| /* Replace BACK4X COOL8MM 0M in BACKUPPOOLT */ |
| def vol BACKUPPOOLT BACK4X@ acc=READW |
| |
|end PRIMARY.VOLUMES.REPLACEMENT macro |
+--------------------------------------------------------------------------------+
STGPOOLS.RESTORE
Contains a macro to restore the primary storage pools. You can use it as a guide and execute the administrative commands from a command line. You can also can copy it to a file, modify it, and execute it. This macro is invoked by the RECOVERY.SCRIPT.NORMAL.MODE script.
This stanza does not include primary storage pool virtual volumes. These volumes are considered offsite and have not been destroyed in a disaster.
Figure 110. Storage Pools Restore Stanza
+--------------------------------------------------------------------------------+
|begin STGPOOLS.RESTORE macro |
| |
|/* Purpose: Restore the primary storage pools from copy storage pool(s). */ |
|/* Recovery Administrator: Delete entries for any primary storage pools */ |
|/* that you do not want to restore. */ |
| |
| restore stgp ARCHIVEPOOL |
| restore stgp BACKUPPOOL |
| restore stgp BACKUPPOOLF |
| restore stgp BACKUPPOOLT |
| restore stgp SPACEMGPOOL |
| |
|end STGPOOLS.RESTORE macro |
+--------------------------------------------------------------------------------+
VOLUME.HISTORY.FILE
Contains a copy of the volume history information when the recovery plan was created. The DSMSERV RESTORE DB command uses the volume history file to determine what volumes are needed to restore the database. It is used by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
The following rules determine where to place the volume history file at restore time:
Note: | The volhprefix is set to the directory representing this instance of the server, which is typically the directory that the server was originally installed from. |
If a fully qualified file name was not specified in the server options file for the VOLUMEHISTORY option, the server adds it to the DSMSERV.OPT.FILE stanza.
Figure 111. Volume History File Stanza
+--------------------------------------------------------------------------------+
|begin VOLUME.HISTORY.FILE |
|********************************************************************************|
|* Tivoli Storage Manager Sequential Volume Usage History |
|* Updated 08/11/2000 10:20:34 |
|* |
|* Operation Volume Backup Backup Volume Device Volume |
|* Date/Time Type Series Oper. Seq Class Name Name |
|********************************************************************************|
| 2000/08/11 10:18:43 STGNEW 0 0 0 COOL8MM BACK4X |
| 2000/08/11 10:18:43 STGNEW 0 0 0 FILES c:\Program|
|* Location for volume TPBK05 is: 'Ironvault Inc.' |
| 2000/08/11 10:18:46 STGNEW 0 0 0 LIB8MM TPBK05 |
|* Location for volume TPBK06 is: 'Ironvault Inc.' |
| 2000/08/11 10:19:23 BACKUPFULL 1 0 1 LIB8MM TPBK06 |
|* Location for volume TPBK07 is: 'Ironvault Inc.' |
| 2000/08/11 10:20:03 STGNEW 0 0 0 LIB8MM TPBK07 |
|* Location for volume TPBK08 is: 'Ironvault Inc.' |
| 2000/08/11 10:20:22 BACKUPINCR 1 1 1 LIB8MM TPBK08 |
| |
|end VOLUME.HISTORY.FILE |
+--------------------------------------------------------------------------------+
DEVICE.CONFIGURATION.FILE
Contains a copy of the server device configuration information when the recovery plan was created. The DSMSERV RESTORE DB command uses the device configuration file to read the database backup volumes. It is used by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
At recovery time, you may need to modify this stanza. You must update the device configuration information if the hardware configuration at the recovery site has changed. Examples of changes requiring updates to the configuration information are:
For details, see Updating the Device Configuration File.
The following rules determine where the device configuration file is placed at restore time:
Note: | The devcprefix is set to the directory representing this instance of the server which is typically the directory from which the server was originally installed. |
If a fully qualified file name was not specified for the DEVCONFIG option in the server options file, the server adds it to the stanza DSMSERV.OPT.FILE.
Figure 112. Device Configuration File Stanza
+--------------------------------------------------------------------------------+
|begin DEVICE.CONFIGURATION.FILE |
| |
|/* Tivoli Storage Manager Device Configuration */ |
|DEFINE DEVCLASS COOL8MM DEVTYPE=8MM FORMAT=DRIVE MOUNTLIMIT=1 MOUNTWAIT=60 |
|MOUNTRETENTION=60 PREFIX=TIVSM LIBRARY=ITSML |
|DEFINE DEVCLASS FILES DEVTYPE=FILE MAXCAPACITY=4096K MOUNTLIMIT=2 DIRECTORY=c:\P|
|DEFINE DEVCLASS FILESSM DEVTYPE=FILE MAXCAPACITY=100K MOUNTLIMIT=2 DIRECTORY=c:\|
|DEFINE DEVCLASS LIB8MM DEVTYPE=8MM FORMAT=DRIVE MOUNTLIMIT=1 MOUNTWAIT=60 MOUNTR|
|DEFINE LIBRARY ITSML LIBTYPE=MANUAL |
|DEFINE LIBRARY RLLIB LIBTYPE=MANUAL |
| |
|end DEVICE.CONFIGURATION.FILE |
+--------------------------------------------------------------------------------+
DSMSERV.OPT.FILE
Contains a copy of the server options file. This stanza is used by the RECOVERY.SCRIPT.DISASTER.RECOVERY.MODE script.
Note: | The following figure contains text strings that are too long to display in hardcopy or softcopy publications. The long text strings have a plus symbol (+) at the end of the string to indicate that they continue on the next line. |
The disaster recovery plan file adds the DISABLESCHEDS option to the server options file and sets it to YES. This option disables administrative and client schedules while the server is being recovered. After the server is recovered, you can enable scheduling by deleting the option or setting it to NO and then restarting the server.
Figure 113. Server Options File Stanza
+--------------------------------------------------------------------------------+
|begin DSMSERV.OPT.FILE |
| |
|* Server options file located in c:\Program Files\Tivoli\TSM\server2\dsmserv.opt|
|TCPPort 1509 |
|VOLUMEHISTORY c:\Program Files\Tivoli\TSM\server2\volhist.txt |
|DEVCONFIG c:\Program Files\Tivoli\TSM\server2\devconf.txt |
| * The following option was added by PREPARE. |
|DISABLESCHEDS YES |
| |
|end DSMSERV.OPT.FILE |
+--------------------------------------------------------------------------------+
Figure 114. License Information Stanza
+--------------------------------------------------------------------------------+
|begin LICENSE.INFORMATION |
| Last License Audit: 12/30/2000 10:25:34 |
| Registered Client Nodes: 1 |
| Licensed Client Nodes: 51 |
| Are network connections in use ?: Yes |
| Are network connections licensed ?: Yes |
|Are Open Systems Environment clients registered ?: No |
| Are Open Systems Environment clients licensed ?: No |
| Is space management in use ?: No |
| Is space management licensed ?: No |
| Is disaster recovery manager in use ?: Yes |
| Is disaster recovery manager licensed ?: Yes |
| Are Server-to-Server Virtual Volumes in use ?: No |
| Are Server-to-Server Virtual Volumes licensed ?: Yes |
| Is Advanced Device Support required ?: No |
| Is Advanced Device Support licensed ?: No |
| Server License Compliance: Valid |
| |
|end LICENSE.INFORMATION |
+--------------------------------------------------------------------------------+
MACHINE.GENERAL.INFORMATION
Provides information for the server machine (for example, machine location). This stanza is included in the plan file if the machine information is saved in the database using the DEFINE MACHINE with ADSMSERVER=YES.
Figure 115. Machine General Information Stanza
+--------------------------------------------------------------------------------+
|begin MACHINE.GENERAL.INFORMATION |
|Purpose: General information for machine DSMSRV1. |
| This is the machine that contains DSM server DSM. |
| Machine Name: DSMSRV1 |
| Machine Priority: 1 |
| Building: 21 |
| Floor: 2 |
| Room: 2749 |
| Description: DSM Server for Branch 51 |
| Recovery Media Name: DSMSRVIMAGE |
| |
|end MACHINE.GENERAL.INFORMATION |
| |
+--------------------------------------------------------------------------------+
MACHINE.RECOVERY.INSTRUCTIONS
Provides the recovery instructions for the server machine. This stanza is included in the plan file if the machine recovery instructions are saved in the database.
Figure 116. Machine Recovery Instructions Stanza
+--------------------------------------------------------------------------------+
|begin MACHINE.RECOVERY.INSTRUCTIONS |
| Purpose: Recovery instructions for machine DSMSRV1. |
| |
|Primary Contact: |
| Jane Smith (wk 520-000-0000 hm 520-001-0001) |
|Secondary Contact: |
| John Adams (wk 520-000-0001 hm 520-002-0002) |
| |
|end MACHINE.RECOVERY.INSTRUCTIONS |
+--------------------------------------------------------------------------------+
MACHINE.RECOVERY.CHARACTERISTICS
Provides the hardware and software characteristics for the server machine.This stanza is included in the plan file if the machine characteristics are saved in the database.
Figure 117. Machine Recovery Characteristics Stanza
+--------------------------------------------------------------------------------+
|begin MACHINE.CHARACTERISTICS |
|Purpose: Hardware and software characteristics of machine DSMSRV1. |
| Processor : x86 Family 5 Model 2 Stepping 11 |
| Bus Type : AT 16-Bit bus |
| Keyboard Type : 101/102 Key Enhanced Keyboard |
| Pointer Type : PS/2 Mouse Buttons: 2 |
| Equipment : 1 Parallel Port(s) |
| 1 Serial Port(s) |
| 1 Diskette Drive(s) |
| 2 Fixed Disk(s) |
| Pointing Device |
| Math CoProcessor |
| Fixed Disk 1 : 609 MB |
| Total Physical Memory : 32,832 KB (33,619,968) |
| |
|end MACHINE.CHARACTERISTICS |
+--------------------------------------------------------------------------------+
MACHINE.RECOVERY.MEDIA
Provides information about the media (for example, boot media) needed for rebuilding the machine that contains the server.This stanza is included in the plan file if recovery media information is saved in the database and it has been associated with the machine that contains the server.
Figure 118. Machine Recovery Media Stanza
+--------------------------------------------------------------------------------+
|begin MACHINE.RECOVERY.MEDIA.REQUIRED |
| Purpose: Recovery media for machine DSMSRV1. |
| Recovery Media Name: DSMSRV |
| Type: Other |
| Volume Names: |
| Location: IRONMNT |
| Description: Server Installation CD |
| Product: |
| Product Information: |
| |
|end MACHINE.RECOVERY.MEDIA.REQUIRED |
+--------------------------------------------------------------------------------+