Chat now with support
Chat with Support

NetVault Plug-in for Domino 4.4 - User Guide

Troubleshooting

Common errors

This topic describes some common errors and their solutions. In cases where an error occurs and is not described in this table, obtain the Domino error number from the NetVault Backup Logs, and then see the relevant Domino documentation for the resolution.

Table 1. Troubleshooting
Description
Symptom
Solution

NetVault Backup 10.x service (netvault-pgsql) does not start on Windows.

Check the Windows Event Viewer for the following message: PDT FATAL: lock file “postmaster.pid” already exists.

NetVault Backup 10.x uses a PostgreSQL database. If the PostgreSQL database does not start, NetVault Backup cannot start. To correct this issue, delete the “postmaster.pid” file from the location referenced in the log and restart the NetVault Backup Server. For more information, see https://support.questcom/netvault-backup/kb/122475.

Backup failed.

Server is not currently logged in. Resulting backup might not be recoverable.

Set up Transactional Logging on the Domino Server. For details, see Setting up Transactional logging on the Domino Server

Cold backup fails on Linux or UNIX when DAOS is configured.

A message from the client states: “Plug-in terminated unexpectedly” or “Plug-in is down.”

To change the DAOS_LOAD and DAOS_Enable settings from 1 to 0, edit the Domino Server’s “notes.ini” file, and try the backup again. After the backup has completed successfully, edit the “notes.ini” file again to change the DAOS_LOAD and DAOS_Enable settings back to 1 before you restart the Domino Server.

Hard Recovery Restore (Offline Restore) of Domino Databases, including Users Mailbox Databases, fails.

The databases being restored exist, while the Transaction Logs are missing and must be re-created. The job waits while the logs are being re-created. If the OS response is slow during this process, the thread times out and the restore job fails.

Resubmit the restore job.

Cold restore fails on Linux or UNIX when DAOS is configured.

A message from the client states: “Plug-in terminated unexpectedly” or “Plug-in is down.”

Try the following:

•
Restore the files to a different directory where they did not previously exist; for more information about relocating files during a restore, see Renaming and relocating data during restore.
•
To change the DAOS_LOAD and DAOS_Enable settings from 1 to 0 (DAOS_LOAD=0 and DAOS_Enable=0), edit the Domino Server’s “notes.ini” file, and try the restore again. If you try this method and if the “notes.ini” file must be restored, restore it after the other items are successfully restored. This process ensures that the modified settings are retained in the active file.
If you try the latter method and the “notes.ini” file does not have to be restored, edit the “notes.ini” file again to change the DAOS_LOAD and DAOS_Enable settings back to 1 before you restart the Domino Server.

Cold restore of server-database files fails.

A message similar to one of the following occurs:

•
Error 2014/04/10 13:23:52 43 Data Plugin <serverName> Failed to take database /local/notesdata/<fileName>.nsf offline.
•
Job Message 2014/04/10 13:23:52 43 Data Plugin <serverName> Bring database '/local/notesdata/<fileName>.nsf' online.
•
Error 2014/04/10 13:23:52 43 Data Plugin <serverName> Failed to Restore database '/local/notesdata/<fileName>.nsf'

The version and Fix Pack (FP) level of your Domino Server affects the recovery process. You can work around this issue by restoring the files to a different directory. For more information, see Renaming and relocating data during restore.

Common errors

This topic describes some common errors and their solutions. In cases where an error occurs and is not described in this table, obtain the Domino error number from the NetVault Backup Logs, and then see the relevant Domino documentation for the resolution.

Table 1. Troubleshooting
Description
Symptom
Solution

NetVault Backup 10.x service (netvault-pgsql) does not start on Windows.

Check the Windows Event Viewer for the following message: PDT FATAL: lock file “postmaster.pid” already exists.

NetVault Backup 10.x uses a PostgreSQL database. If the PostgreSQL database does not start, NetVault Backup cannot start. To correct this issue, delete the “postmaster.pid” file from the location referenced in the log and restart the NetVault Backup Server. For more information, see https://support.questcom/netvault-backup/kb/122475.

Backup failed.

Server is not currently logged in. Resulting backup might not be recoverable.

Set up Transactional Logging on the Domino Server. For details, see Setting up Transactional logging on the Domino Server

Cold backup fails on Linux or UNIX when DAOS is configured.

A message from the client states: “Plug-in terminated unexpectedly” or “Plug-in is down.”

To change the DAOS_LOAD and DAOS_Enable settings from 1 to 0, edit the Domino Server’s “notes.ini” file, and try the backup again. After the backup has completed successfully, edit the “notes.ini” file again to change the DAOS_LOAD and DAOS_Enable settings back to 1 before you restart the Domino Server.

Hard Recovery Restore (Offline Restore) of Domino Databases, including Users Mailbox Databases, fails.

The databases being restored exist, while the Transaction Logs are missing and must be re-created. The job waits while the logs are being re-created. If the OS response is slow during this process, the thread times out and the restore job fails.

Resubmit the restore job.

Cold restore fails on Linux or UNIX when DAOS is configured.

A message from the client states: “Plug-in terminated unexpectedly” or “Plug-in is down.”

Try the following:

•
Restore the files to a different directory where they did not previously exist; for more information about relocating files during a restore, see Renaming and relocating data during restore.
•
To change the DAOS_LOAD and DAOS_Enable settings from 1 to 0 (DAOS_LOAD=0 and DAOS_Enable=0), edit the Domino Server’s “notes.ini” file, and try the restore again. If you try this method and if the “notes.ini” file must be restored, restore it after the other items are successfully restored. This process ensures that the modified settings are retained in the active file.
If you try the latter method and the “notes.ini” file does not have to be restored, edit the “notes.ini” file again to change the DAOS_LOAD and DAOS_Enable settings back to 1 before you restart the Domino Server.

Cold restore of server-database files fails.

A message similar to one of the following occurs:

•
Error 2014/04/10 13:23:52 43 Data Plugin <serverName> Failed to take database /local/notesdata/<fileName>.nsf offline.
•
Job Message 2014/04/10 13:23:52 43 Data Plugin <serverName> Bring database '/local/notesdata/<fileName>.nsf' online.
•
Error 2014/04/10 13:23:52 43 Data Plugin <serverName> Failed to Restore database '/local/notesdata/<fileName>.nsf'

The version and Fix Pack (FP) level of your Domino Server affects the recovery process. You can work around this issue by restoring the files to a different directory. For more information, see Renaming and relocating data during restore.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating