NetBackup for Lotus Notes: Performing a command line point-in-time restore of "logged" Domino databases

Article:TECH24932  |  Created: 2003-01-17  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH24932
Article Type
Technical Solution


Issue



How to perform a NetBackup for Lotus Notes point-in-time restore of "logged" Domino databases using the 'bprestore' command.

 


Solution



The bprestore command (bprestore.exe for Windows) can be executed on the target client as an alternative to running a restore from the NetBackup Java console or the NetBackup Backup, Archive and Restore program. This entire process can be used on Unix and Windows hosts for any reason where the GUI may not be available on a NetBackup client.

Except for the Lotus agent specific items listed below, the bprestore command is thoroughly documented in the NetBackup Commands guides, which can be downloaded from "Related Articles" section below.
 

Example bprestore command:

bprestore -R /tmp/<rename_file> -t 25 /notesdata/mail/johndoe.nsf

A 'rename' file is used to pass key parameters to direct the restore process. The 'rename' file is normally created automatically by the GUI. When using the bprestore command, 'rename' file must be created manually, and its path is supplied as one of the bprestore command arguments. All parameters have defaults, so only list a parameter if it requires a change.

Example rename file:

change /notesdata/mail/johndoe.nsf to /notesdata/RESTORE/johndoe.nsf
LOTUS_NOTES NoRecovery NO
LOTUS_NOTES ZapId YES
LOTUS_NOTES ZapReplicaID YES
LOTUS_NOTES PointInTime 1230789600
LOTUS_NOTES WaitTime 0
LOTUS_NOTES RecoveryWait NO
LOTUS_NOTES NotesIniPath /local/notesdata/notes.ini

Parameter Definitions:
"-t 25" - The policy type code for the Lotus Notes agent specify which policy type should be used for the restore.

"change" and "to" - Used in the rename file to specify an alternate path for the destination restore file. Use proper Unix or Windows file paths.

"NoRecovery" - Indicates whether a transaction log recovery will be initiated upon the restore of a logged database. Default is YES.

"ZapId" - Indicates whether the restored database should be assigned a new Database Instance ID (this is required for point-in-time restores).  

"ZapReplicaID" - Indicates whether the restored database will be given a new Replica ID.  Default is NO.

"PointInTime" - Used to specify in ctime the desired point in time for the recovery. (Follow "Ctime Converter" process below.)

"WaitTime" - The amount of time the restore will wait for a busy database to become available. Default is 0.

"RecoveryWait" - Specifies the amount of time to wait between the restore (database file) process completion and the recovery (log  file(s)) process start. Default is YES.

"NotesIniPath" - Used to specify the correct location of the notes.ini file for a specific Domino partition.

NOTE: It is necessary to logon to the destination Unix restore client using the same Unix account that was used to backup the database (if a local account must be created on an alternate client, the UID must also match the backup account). This will be the user that owns the source Domino partition's notes.ini file, which should also be the same user running the Domino 'server' process on the source client.

Ctime Converter
Use this tool to convert real-time to ctime
1) Open this web page:  http://www.travel-images.com/calendar-conversion.html ctime Converter (http://www.travel-images.com/calendar-conversion.html)
2) Fill in the Gregorian Calendar with the desired date and time for recovery and click [Calculate].
3) Scroll down the web page to find the "Unix time() value". The 10 digit time value located in the "Unix time() value" box correlates to the time entered in step 2.
4) Copy this time value and paste it after the "PointInTime" keyword in the Rename File.

 



Legacy ID



257166


Article URL http://www.symantec.com/docs/TECH24932


Terms of use for this information are found in Legal Notices