Troubleshooting Domino plug-in-specific errors
Suggest changes
PDFs
Common Snap Creator errors fall into two categories: generic Snap Creator errors and Domino plug-in-specific errors. Domino plug-in-specific errors typically involve preinstallation issues, bad databases, or problems with a custom restore action.
|
For information about generic Snap Creator errors, see the Snap Creator Framework 4.1.2 Administration Guide. |
Domino plug-in is not supported on this platform
You typically receive this error when the prerequisites for the Domino plug-in have not been met. Generally, the error message is similar to the following:
Failed to load plug-in domino. Reason: ERROR: [ltd-00009] Domino plug-in couldn't be loaded. Reasons could be 1) Domino plug-in is not supported on this platform.
The following error message has also been known to appear:
ERROR: [tampico:9090(4.1.x)] SCF-00038: Application quiesce for plug-in [domino] failed with exit code [99], continuing with backup.
As well as this one:
ERROR: [scf-00094] Application environment set for plug-in domino failed [ERROR: [scf-00060] unknown application object [app] / application domino at snapcreator.pl line 6410.
These errors messages appear if one of the following conditions is not met:
-
Preinstallation steps were not performed or were performed incorrectly:
-
On UNIX hosts, you must create symbolic links to IBM Domino shared object files.
-
On Windows hosts, you must add the IBM Domino installation path to the PATH environment variable. For more information, see the Snap Creator Framework 4.1.2 Installation Guide.
-
-
The bit level of Domino is different from the bit level of Snap Creator. For example, if you are using 32-bit Domino, you should use 32-bit Snap Creator.
Snap Creator backup fails because of a bad database
By default, a backup operation will fail if one or more databases are in an inconsistent or corrupted state. You can force the plug-in to proceed with backup operations despite errors, as described in step task using the gui to create a configuration file.
Domino restore using custom action fails
Restore errors typically occur when restore paths are not set correctly. Check the paths for extra characters and backslashes. Also, verify that the Data Restore Directory is set correctly.
Errors are similar to the following:
########## Custom plug-in action ########## [Thu Apr 19 16:05:55 2012] DEBUG: Restoring to current time. [Thu Apr 19 16:05:55 2012] DEBUG: Calling dominocore::postRestoreToTime with arguments(C:\Lotus\Domino\notes.ini,F:\Domino\data\,H:\changeinfo\fuji15-daily_20120419130836,-1,F:\Domino\data\restore\mail\dadams.nsf,UP-TO-THE-MINUTE,H:\changeinfo\logs\) [Thu Apr 19 16:05:55 2012] TRACE: Notes API initialized Applying Change info for:F:\Domino\data\restore\mail\dadams.nsf Error: unable to open file 'H:\changeinfo\fuji15-daily_20120419130836/restore_mail_dadams.nsf.info', for path 'F:\Domino\data\restore\mail\dadams.nsf'. Error:5114 NSFRecoverDatabases failed for database:F:\Domino\data\restore\mail\dadams.nsf Recovery Manager: Recovery only supported for Backup Files.ERROR_CODE:5114 [Thu Apr 19 16:05:55 2012] ERROR: [ltd-00008] Restoring databases finished with errors [Thu Apr 19 16:05:55 2012] ERROR: [scf-00154] Action custom for plugin domino failed with exit code 1, Exiting! [Thu Apr 19 16:05:55 2012] DEBUG: Exiting with error code - 2
All Domino plug-in-specific errors
The following table lists the IBM Domino plug-in-specific error messages in reference format:
| Error code | Error message | Description/resolution |
|---|---|---|
ltd-00001 |
Domino plug-in cannot work with SNAP_TIMESTAMP_ONLY = N. SNAP_TIMESTAMP_ONLY should be set to Y. |
For more information, see step task_using_the_gui_to_create_a_configuration_file.md#STEP_81795CF9D6294AC891BC3D0CE4827CA3. |
ltd-00002 |
Quiescing databases finished with errors |
Domino plug-in was unable to put all databases in backup mode. Check the logs to find the exact reason for the error or run Snap Creator in debug mode to find the error. |
ltd-00003 |
Unquiescing databases finished with errors |
Domino plug-in was unable to take all databases out of backup mode. Check the logs to find the exact reason for the error or run Snap Creator in debug mode to find the error. |
ltd-00004 |
Discovering databases failed |
An application error caused application discovery to fail. Check the configuration and application settings. You can disable automatic discovery by setting APP_AUTO_DISCOVERY=N and commenting out VALIDATE_VOLUMES. |
ltd-00005 |
Collection of operating system information failed - $@ |
An error collecting operating system information caused the scdump action to fail. Check the logs and try running the command manually. |
ltd-00006 |
Collection of SnapDrive information failed - $@ |
An error collecting SnapDrive information caused the scdump action to fail. Check the logs and try running the command manually. |
ltd-00008 |
Restoring databases finished with errors |
Domino plug-in was unable to restore all the databases successfully. Check the logs to find the exact reason for the error or run Snap Creator in debug mode to find the error. |
ltd-00009 |
Domino plug-in cannot be run as root |
Reasons could be:
For more information, see Domino plug-in is not supported on this platform. |
ltd-00010 |
Errors encountered while opening databases |
Check the logs to find the exact reason for the error or run Snap Creator in debug mode to find the error. |