4 4 3 Beefalo:IBM Domino Server Configuration

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English

Copyright © SEP AG 1999-2020. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo/Beefalo V2. For previous documentation version(s), check IBM Domino server archive.


Overview

The Lotus Domino (previously Lotus Notes) corporate brand has been acquired by IBM. The Lotus Domino product name is now IBM Domino server; however, SEP sesam documentation update (such as screenshots) to reflect these changes is being done in a phased manner, therefore IBM Domino may still appear under the name Lotus Notes or Lotus Domino.

SEP sesam Client SBCLN is a program library for backing up IBM Domino (previously Lotus Domino) databases. All required components for IBM Domino server backup are already included in the regular SEP sesam Client for Windows and Linux package. Once the extension is present and all the requirements are met, you have to configure your client for the use with SEP sesam environment. For details, see section Configuring IBM Domino server as a SEP sesam client.

Additionally, to perform IBM Domino database-level backups, you have to enable and set up transaction logging in Archived mode on the IBM Domino server. Note that Domino databases can also be backed up with transaction logging disabled, however, this is not recommended as it only allows for FULL or COPY backups of databases and requires much more frequent full database backups. For details, see section Enabling transaction logging in Archive mode.

Quick Start 3.png
Quick setup
  1. Install SEP sesam Client on IBM Domino server.
  2. Add the IBM Domino server as client to the SEP sesam environment.
  3. Set the required variables on Linux or on Windows, including the Path environment variable.
  4. Enable transaction logging in Archive mode on the IBM Domino server.

Requirements

To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:

  • Check the support matrix for the list of supported IBM Domino (previously Lotus Domino) server versions. Note that Windows 2012 is supported with regular file system functions. No support is provided for the Domino (Notes) data that were held on a NTFS deduplication partition!
  • SEP sesam Server v. 4.4.3 or higher. Check Hardware requirements for SEP sesam Server. Currently it is not possible to upgrade IBM Domino (Lotus Notes) on Linux to version 4.4.3.70 Beefalo. Last version with IBM Domino support is 4.4.3.64 SLES11.
  • Install the SEP sesam Client package on the IBM Domino server. You can download it from SEP Download Center. For details on installing, see SEP sesam Quick Install Guide.
  • A user account with sufficient privileges to perform backup and restore operations.
  • SEP sesam IBM Domino backup module requires a license. For details, see List of Licenses.

Configuring IBM Domino server as a SEP sesam client

Before proceeding, make sure that the above requirements are met. The configuration procedure is slightly different depending on the operating system type (Linux or Windows).

On Linux

Once you have installed your SEP sesam Linux Client on IBM Domino server, proceed as follows:

  1. Configure your IBM Domino client by adding it to the SEP sesam environment: Main selection -> Components -> Topology -> New client -> add your IBM Domino client. For details, see Configuring Clients.
  2. Check if the library libsbcln.so is already present in the <SESAM_ROOT>/bin/sesam/ directory on your Linux client. If not, download the SEP sesam extension for IBM Domino from SEP Download Center and copy it into the <SESAM_ROOT>/bin/sesam/ directory.
  3. To work with Domino and load the library, add the following variables in the [ENVIRONMENT] section in <SESAM ROOT>/var/ini/sm.ini at the client: LOTUS, NOTES_DATA_DIR, Notes_ExecDirectory and PATH. The LD_LIBRARY_PATH must refer to directories containing the libraries libsbcln.so (located in <SESAM_BIN>/bin/sesam) and libnotes.so (in the Notes binary files installation directory).
  4. The values listed below depend on the IBM Domino (previously Lotus Domino) installation. Use the values that apply to your Domino environment.

    LOTUS=<IBM_Domino_path> 
    NOTES_DATA_DIR=<IBM_Domino_data_path>
    Notes_ExecDirectory=<IBM_Domino_exe_path>
    PATH=$PATH:<IBM_Domino_exe_path>:<IBM_Domino_data_path>
    LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<IBM_Domino_exe_path> 
    

    For example:

     [ENVIRONMENT]
     ...
     LOTUS=/opt/ibm/lotus
     NOTES_DATA_DIR=/srv/notesdata
     Notes_ExecDirectory=$LOTUS/notes/latest/linux
     Notes_Resources=$Notes_ExecDirectory/res
     SESAM_LIB_PATH=/opt/sesam/bin/sesam
     NOTES_LIB_PATH=$NOTES_DATA_DIR:$Notes_ExecDirectory:$Notes_Resources
     PATH=$PATH:$NOTES_DATA_DIR:$Notes_ExecDirectory:$Notes_Resources
     LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SESAM_LIB_PATH:$NOTES_LIB_PATH
     ...
    

    If the [ENVIRONMENT] section in the sm.ini file does not exist, you have to create it.

  5. Afterwards, restart the SEP sesam daemon:
  6.  /etc/init.d/sesam restart
    

    For details, see How to Start and Stop SEP sesam.

    Information sign.png Note
    Before proceeding, you should validate that you can backup to SEP sesam. Run a test Path backup manually to ensure that the backups work. For details on typical backup configuration, see Standard Backup Procedure.

On Windows

Once you have installed your SEP sesam Windows Client on the IBM Domino server, proceed as follows:

  1. Configure your IBM Domino client by adding it to the SEP sesam environment: Main selection -> Components -> Topology -> New client -> add your IBM Domino client. For details, see Configuring Clients.
  2. Add the folder path of the nnotes.dll to the Path environment variable: right-click This PC -> Properties -> Advanced system settings -> Environment Variables -> under System variables area select Path and click Edit. Click New and add the path from your IBM Domino Server installation where the nnotes.dll is located, for example:
  3.  C:\Program Files\IBM\Domino
    

    Then click OK to save your changes.

  4. Restart the SEP sesam service. For details, see How to Start and Stop SEP sesam.
  5. Information sign.png Note
    Before proceeding, you should validate that you can backup to SEP sesam. Run a test Path backup manually to ensure that the backups work. For details on typical backup configuration, see Standard Backup Procedure.

Enabling transaction logging in Archive mode

You have to set up transaction logging in Archive mode on the IBM Domino server to enable point-in-time recovery. The main advantage of transaction logging is fast server restart in case of a recovery; since transaction logging keeps a sequential record of every operation that occurs to data, you can roll back the database to a point before it was corrupted and replay the changes from the transaction log.

By default, transaction logging is disabled. You can enable it from Domino Administrator -> Configuration tab -> Use Directory on field -> select Domino directory -> click Server Configuration -> Current Server Document -> Transactional Logging tab -> enable the Transactional Logging and select Archive as Logging style.

Information sign.png Note
SEP sesam does not support Circular logging for IBM Domino server. Domino databases can be backed up with transaction logging disabled, but this only allows for FULL backups of databases and requires much more frequent full database backups.

Once you enable transaction logging, IBM Domino assigns a Database Instance Identifier (DBIID) to each Domino database. When Domino records a transaction in the log, it includes the DBIID. During restore, the DBIID is used to identify the database to which the changes should be applied. If a new DBIID is assigned to a Domino database as a result of some Domino database maintenance activities, such as using fixup (e.g., automatic fixup of corrupt databases) or compact, the console message Assigning New DBIID for DB xxxx appears. In this case, you have to run a full database backup to be able to successfully restore the database.

For additional information on transaction logging and DBIID, see IBM FAQ about Transaction Logging, Transaction Logging on Domino Servers and Notes/Domino Best Practices: Transaction Logging.