Running IBM Storage Protect client tasks

Set up a IBM Storage Protect schedule for Domino with the backup archive-client setup wizard.

This example assumes that the IBM Storage Protect backup-archive client is installed on the Domino server in the default installation directory (AIX: /usr/tivoli/tsm/client/ba/bin64, and Linux: /opt/tivoli/tsm/client/ba/bin) directory. It also assumes that the Data Protection for HCL Domino for the Domino server is stored in the default installation directory (AIX: /usr/tivoli/tsm/client/domino/bin64. Linux: /opt/tivoli/tsm/client/domino/bin) directory. The system options files in each of the installation directories must be updated so that the communication parameters point to the IBM Storage Protect server.
  1. Log in to an account that has root privileges.
  2. For AIX: Add the following entry to the /etc/inittab file:
    tdpdom::once:/usr/bin/dsmc sched -optfile=/usr/tivoli/tsm/client
    /domino/bin/dsm.opt /dev/null 2>&1 
    #Data Protection for Domino scheduler
  3. The system options file that is defined by Data Protection for HCL Domino is used by the scheduler when it is validating the node and password. The system options file is also used when it contacts the IBM Storage Protect server for schedule information. The example assumes that the dsm.sys or dsm.opt file is updated so that the communication parameters point to the IBM Storage Protect server to which the Domino databases are to be backed up.
    If the following message is shown:
    A communications error occurred connecting to the 
    IBM Storage Protect server
    Ensure that the system options file contains entries that point to the correct IBM Storage Protect server. Also, ensure that the IBM Storage Protect server is running.
  4. Create a script file or symbolic link to a script file that is called /bin/domarc. You can begin with the domarc.smp file that was placed into the Data Protection for HCL Domino installation directory. Notice in this example script:
    1. The default options file dsm.opt is overridden on the command line.
    2. The script ensures that the command is run as the Domino server ID. Use the ID you set up.
    3. The domdsmc command is run in the background so control is returned to /usr/bin/dsmc without needing to wait for the command to finish.

    See IBM Storage Protect for UNIX and Linux Backup-Archive Clients Installation and User's Guide for more information about the IBM Storage Protect backup archive client environment variables, DSM_DIR, DSM_CONFIG, and DSM_LOG.

    When you are using the IBM Storage Protect scheduler to run commands in a command file, you must use the complete path names for all file names and non-system commands. The scheduler runs from the AIX, Linux, or UNIX, or system directory. This system directory is where the scheduler looks for input and produces its output by default.

  5. The scheduler is installed and configured, but is not started.

    To start the service, issue the following command in the AIX, Linux, or UNIX console window:

    AIX
      nohup /usr/bin/dsmc sched 2> /dev/null &
    Linux and UNIX
      nohup /opt/bin/dsmc sched 2> /dev/null &
    The following output is displayed:
    The IBM Storage Protect Data Protection for Domino Archive 
    Schedule service is starting. 
    
    The IBM Storage Protect Data Protection for Domino Archive 
    Schedule service was started successfully.

    Note, because the /etc/inittab entry (AIX) and the /etc/rc entry (UNIX) is used, the IBM Storage Protect scheduler service is automatically started each time that the system is restarted.

    Your system is now ready to run automatic hourly archival of the transactions logs.