Problem determination

Edit online

When an error occurs during a Data Protection for HCL Domino event, there is information that you can view to determine what the problem might be. Information about how to locate information to resolve problems is provided.

Data Protection for HCL Domino logs information, by default, to the domdsm.log file in the directory where Data Protection for HCL Domino is installed. This file indicates the date and time of a backup, data backed up, and any error messages or completion codes. This file is important and should be monitored daily.

The IBM Storage Protect API logs API error information, by default, to the dsierror.log file in the directory where Data Protection for HCL Domino is installed. This file does not contain backup statistics.

The Domino server logs information to the AIX, Linux, or UNIX, Domino Event Log. Domino server error information can be obtained by viewing the AIX, Linux, or UNIX, Domino Event Log.

The IBM Storage Protect scheduler logs information to both the dsmsched.log and the dsmerror.log files. By default, these files are located in the directory where the IBM Storage Protect backup-archive client is installed.
Note: When a scheduled command is processed, the schedule log might contain the following entry: Scheduled event eventname completed successfully. This indicates that IBM Storage Protect successfully issued the scheduled command that is associated with the eventname. No attempt is made to determine the success or failure of the command. Assess the success or failure of the command by evaluating the return code from the scheduled command in the schedule log. The schedule log entry for the command return code is prefaced with the following text: Finished command. Return code is:

The statistics option provides performance information at the individual database backup or restore level. Statistics are logged to the Data Protection for HCL Domino log file domdsm.log by default. Make sure that this option is specified in the Data Protection for HCL Domino preferences file domdsm.cfg by default, during backup and restore processing.

If the sources of information that are listed, do not provide an answer to your problem, contact your IBM service representative. The IBM service representative can provide more ways to gather diagnostic information.

You might be asked to provide these files as part of the troubleshooting process:
  • dsm.opt
  • dsmerror.log
  • dsmsched.log
  • domdsm.log
  • domdsm.cfg
  • dsierror.log
  • tdpdommustgather.out
You might be asked to run these commands:
echo "------domdsmc query adsm------" >> tdpdommustgather.out
domdsmc query adsm >> tdpdommustgather.out
echo "------domdsmc query domino------" >> tdpdommustgather.out
domdsmc query domino >> tdpdommustgather.out
echo "------domdsmc query preferences------" >> tdpdommustgather.out
domdsmc query preferences >> tdpdommustgather.out
echo "------set------" >> tdpdommustgather.out
set >> tdpdommustgather.out
reg query HKLM\software\ibm\adsm\currentversion /s >> tdpdommustgather.out

Information about how to configure IBM Storage Protect compression, encryption, and deduplication is available in the Using the Application Programming Interface guide in the IBM Storage Protect Information Center.