42.2 Recovering Domain or Post Office Databases

The database recover process corrects physical problems in the database structure, but does not update incorrect information contained in the database.

If you receive an administrative message informing you that an internal database error has occurred, or if you detect database damage and don’t want to take users out of GroupWise, you can recover the database. If no errors are reported after the recover process, you do not need to take further action.

The recover process is run against a copy of the domain database (wpdomain.db) or post office database (wphost.db). Therefore, while the recover process is running, you can continue to access the database through the GroupWise Admin console and you do not need to stop the MTA or the POA.

As the copy of the database is created, the recover process skips invalid records. If the number of records in the original wpdomain.db file or wphost.db file is different from the number in the new, valid copy, GroupWise sends a notification message informing you that data has been lost. When the recover process is completed, the backup database is deleted.

Database Recovery Process

For convenience, the agents are configured by default to automatically recover domain and post office databases whenever a physical problem is encountered. This setting can be changed on the Admin Task Status page in the POA console and the MTA console.

To recover a specific database in the GroupWise Admin console:

  1. Ensure that you have sufficient disk space for the copy of the database that is created during recovery.

  2. In the GroupWise Admin console, connect to the domain where the database is located.

  3. Browse to and click name of the domain or post office where you want to recover the database.

  4. From a domain, click Maintenance.


    From a post office, click Maintenance > Post Office Database.

  5. Select Recover Database, then click Run.

    You are notified if there are any physical problems, so you can then rebuild the database. If the task takes a while to complete, see Monitoring Background Administrative Tasks.

  6. Click Close to return to the main Admin console window.

If recovery is successful, the backup database is deleted, and the new domain database is renamed to wpdomain.db, or the new post office database is renamed to wphost.db.

If recovery fails for any reason, the backup database is copied back to wpdomain.db or wphost.db. If any data was lost, you are notified by an administrative message.

You have several options for retrieving lost data from other sources: