Source:HCL Domino Server Configuration

From SEPsesam
Revision as of 10:32, 30 April 2019 by Dho (talk | contribs)
Draft.png WORK IN PROGRESS
This article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.
Copyright © SEP AG 1999-2024. 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. For previous documentation version(s), check IBM Domino server archive.


Overview

Template:Domino rebrand en

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.
  • 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 https://www.sep.de/downloadportal/extensions/groupware/notes/ and copy it into the <SESAM_ROOT>/bin/sesam/ directory.
  3. To work with Domino and load the library, add/set 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.