Topics | How To | Full System Restore | Related Topics
Lotus Domino Server iDataAgents
Notes Database iDataAgent
Notes Document iDataAgent
Normally, if databases are lost or removed, they are recovered from the archives using the normal restore procedures described in Restore Backup Data. However, when there is a severe software and/or hardware problem there are two means of recovering: a full Lotus Domino Server restore and a full system restore. The difference between the two is the severity of the problem.
When all of the Notes data in a partition or the active extent of the transaction log in a Domino Server partition is corrupted, the partition must be restored. For information on restoring a Lotus Domino Server partition, refer to Lotus Domino Server Recovery.
When the client system (software, hardware, hard drives, etc.) is damaged or destroyed a full system restore may be required. A full system restore is the process of fully restoring a client computer’s file system, registry (where applicable), applications, and data, either to the original computer or to a different one. Full system restores can be helpful, for example, when you want to create a computer that duplicates another computer’s configuration and data, or necessary, for example, when you need to re-establish a computer’s configuration and data after a catastrophic system failure.
A full system restore of a Domino server starts with a file system restore using the File System iDataAgent software. This restores the entire server including operating system, registry information, and the Lotus Domino Server program files which include the Domino Server software that was installed on the computer and the notes.ini and server.id files. Once this is done you can use the Notes Database iDataAgent to restore Notes databases. See Perform a Full System Restore for step-by-step instructions.
A full Lotus Domino Server restore is the process by which all of the Notes data in a Domino Server partition is restored. Although you can restore all of the documents in a Lotus Notes database using the Notes Document iDataAgent, if you restore a database this way, some database properties are lost. We recommend that you back up Notes databases with the Notes Database iDataAgent (even if you are also using the Notes Document iDataAgent) so that you can restore the databases with all of their properties.
To enable you to fully recover Notes databases, the Notes Database iDataAgent provides a Disaster Recovery feature which makes it possible to restore and replay transactions when the active extent of the transaction log is lost. Disaster Recovery uses the TRANSLOG_RECREATE_LOGCTRL parameter in the notes.ini file. Because this parameter is not recognized by versions of Domino Server prior to 5.0.3, the Disaster Recovery option cannot be used with older versions of Domino Server. Note that for normal restores (i.e., when the active extent exists in the transaction log directory), there is no difference between older and newer versions of Domino Server.
The procedures in this section are for restoring Notes databases only. If your Domino Server software is lost or damaged, you must reinstall it or restore it from a File System backup. |
The transaction log of a Domino Server partition consists of a number of files known as extents. A numerically named series of log extents, each occupying 64 MB, is created when archive logging is first enabled on the Domino Server. The number of extent files created is determined by the value of the user-configured Maximum Log Space parameter in the server document. For example, if you set Maximum Log Space to 500 MB, Domino creates 500 MB worth of extents to ensure that the required amount of space is available to the transaction log. Initially, these files are inactive and do not contain any transaction records. Transactions for all databases within the partition are written to one extent file, the transaction log's active extent. When this file is full, it becomes inactive, and transactions are written to the next extent in the series.
Normally, when a database is restored, Domino brings it up to date by replaying transactions that occurred after the last database backup job. If these transactions are not available in the transaction log directory, the Notes API asks the system to retrieve the necessary log extents from backup. However, if the active extent of the transaction log is lost, Domino Server or the Notes API may not work, and old logs can't be played back. In this case, you must follow the Disaster Recovery procedure. Using this procedure, you can restore the most recently archived log extent, making it possible to recreate the log control file, retrieve the necessary transaction logs from backup, and replay the transactions. See Restore a Lotus Domino Server with the Disaster Recovery Option for step-by-step instructions.
Warning Use the Disaster Recovery option only when the current log file is irretrievably lost. Do not modify or delete the contents of the transaction log directory unless you are sure that disaster recovery is necessary. |
You can also recover a Lotus Notes database from a log sequence prior to the current log sequence by creating the nUSEBROWSETIMEFORDR registry key. Use this registry key only when you have recreated the log sequence (i.e., restarted the Domino Server with an empty log directory), have backed up log extents from the new log sequence, and require the restore and full recovery of all Lotus Notes databases to a point-in-time prior to the backup of the new log sequence.
Use this procedure for all logging styles or when using archive logging mode with versions of Domino Server before 5.03. See Restore a Lotus Domino Server without the Disaster Recovery Option for step-by-step instructions.
This procedure restores databases (.nsf files) only. It does not restore or replay transaction logs. |
The Notes Document iDataAgent is not intended for full Lotus Domino Server restore and does not include a specific Disaster Recovery feature. If your file system and Domino Server executables are intact, you can restore Notes Document data using the normal browse and restore procedures. If your entire system is corrupted, you must perform a full system restore. See Perform a Full System Restore for step-by-step instructions.
A full system restore of a Domino server starts with a file system restore using the File System iDataAgent software. See Disaster Recovery for information on the appropriate file system full system restore procedure.
After restoring the rest of the server, continue the full system restore procedure on your Notes databases by using whichever Notes iDataAgent you previously used to back up your data. If you have backed up your databases using both iDataAgents, we recommend using the Notes Database iDataAgent for large restore jobs. See Perform a Lotus Domino Server Recovery for Notes Document for step-by-step instructions.
To perform a full system restore:
Do not start Domino Server. If Domino is configured as an automatic service, stop the server.
Before You Begin
Review the following to avoid common problems:
To perform Lotus Domino Server Recovery with the Disaster Recovery option:
The steps that follow must be performed separately for each Domino Server partition that you want to restore./td> |
TRANSLOG_RECREATE_LOGCTRL=1
The Lotus Notes client software has its own notes.ini file, as does each Domino Server partition. There may be multiple notes.ini files on the computer to which you are restoring. Make sure that you are modifying the notes.ini file of the partition that you want to restore. |
If you add this line at the end of the notes.ini file, be sure to add a new line (i.e., press Enter) after this line. Note that the value of this parameter is reset to 0 automatically after the disaster recovery process completes. It is not necessary to delete this from the .ini file.
We strongly recommend that you select
all
databases and choose the Unconditional overwrite option.
Databases that are not restored during disaster recovery can be restored
later on, but you will be unable to replay transactions from the
archived transaction log that affect these databases. In other words,
any changes made to these databases between the last database backup
prior to failure and disaster recovery will be lost.
If you do not want to restore all databases at this time, be sure to restore the Notes system databases (e.g., Names.nsf) first. |
You must do both a database backup and a transaction log backup to avoid future data loss. Databases must be successfully backed up before you back up transaction logs. |
Before You Begin
Review the following to avoid common problems:
Use this procedure for all logging styles or when using archive logging mode with versions of Domino Server before 5.03
To perform Lotus Domino Server Recovery without the Disaster Recovery option:
The steps that follow must be performed separately for each Domino Server partition that you want to restore. |
If logging is enabled, when the restore finishes the job status is Failed, and you may see error messages similar to the following:
"Recovery Manager: Database is not latest copy. - 5109"
You can safely ignore the error messages. Additionally, unless the job failed for reasons unrelated to disaster recovery, the status is incorrect (i.e., the partition's databases were actually restored successfully). The error messages and Failed status appear for the following reason: Because older versions of Domino Server don't recognize the TRANSLOG_RECREATE_LOGCTRL parameter, the original transaction log is not restored. Instead, Domino creates a new transaction log with a new logID. After the Notes databases are restored, the Lotus Notes iDataAgent tries to replay transactions. Since the log has been replaced, transactions cannot be replayed, and the restore job will fail.
Confirm that your databases were successfully restored.
You must run both a database backup job and a transaction log backup job to avoid future data loss. Databases must be successfully backed up before you back up transaction logs. |
To perform Lotus Domino Server Recovery:
After a File System restore job, the computer reboots. If you are restoring with the Notes Database iDataAgent, DO NOT start the Domino Server. If Domino is configured as an automatic service, stop the server. |
TRANSLOG_Status = 0
In some circumstances of transaction log corruption it may be necessary to delete and re-create the transaction logs. You must determine whether the existing transaction logs can be used. Your Lotus Notes administrator must determine whether the existing transaction logs can be used. |