Lotus Notes/Domino Interface Setup

The following setup steps must be executed to enable backup and recovery of Lotus Notes databases:

  1. Set the environment variables as follows:

    • Windows:

    Set the PATH to include the path to nnotes.dll.

    • UNIX:

      1. Populate two files in the misc subdirectory of the main directory as described below:

        Populate the file SSUSERLIB with the path to libnotes.so (libnotes_r.a for AIX). For example:

        /opt/ibm/lotus/notes/latest/linux

        Populate the file SSUSERPATH with:

        path_to_libnotes.so:path_to_data_dir

        For example:

        /opt/ibm/lotus/notes/latest/linux:/local/notesdata

      2. Add the following to end of the file bexenv in $SSPRODIR/bin:

        Note. Replace BEXLOTUS_USER with the user account that created the Lotus Notes database.

        BEXLOTUS_USER=notes

        LD_LIBRARY_PATH=/usr/lib:$LD_LIBRARY_PATH

        export BEXLOTUS_USER LD_LIBRARY_PATH

      Warning! Files bexenv and bexads may be overwritten during upgrades. Users can add custom environment variable settings to the bexenv.conf and bexads.conf files using a text editor. The bexenv and bexenv.conf files are contained in the /opt/DPX/bin/ directory and the bexads and bexads.conf files are stored in the /opt/DPX/misc directory. These files will retain user added settings even after an upgrade.

      1. Modify the ssdmbs and ssdmrr files as follows:

        In the ssdmbs file found in the bin directory of the main directory, add -noenh to the end of the exec command line.

        For example:

        exec ./dmbs -noenh

        In the ssdmrr file found in the bin directory of the main directory, add -noenh to the end of the exec command line.

        For example:

        exec ./dmrr -noenh

  2. Start the cmagent on the Lotus Domino server. The cmagent must be started after setting the environment variables (Step 1). This ensures that all binaries will inherit the cmagent’s environment. See Managing the CMAgent Service in the User’s Guide.

  3. Enabling Transaction Logging on the Lotus Domino server is recommended. The type should be set to archive logging (not circular logging), and the transaction log path should be set to a location outside the notes data directory. This ensures that DPX will see the LOGSDIR volume, and that transaction logs – necessary for database recovery – are backed up properly by DPX. If transaction logging is not enabled, LOGSDIR will not be visible from the management console or available for backup or restore.

  4. Confirm the setup.

    1. Open DPX.

    2. Select the Backup tab in the Function Tab bar, and click File to display the File Backup window.

    3. In the Source Nodes window pane, click through the source nodes tree. Check that the DATADIR directory icon and the LOGSDIR directory icon appear under the LOTUS_DOMINO disk icon on the tree. This confirms the setup.

    4. Exit DPX.

Last updated