Initializing BRMS For Lotus Server Backups

BRMS will automatically configure the backup control groups and media policies you need to perform online backup of the Lotus® Server databases. The Lotus Notes® server databases backed up by these control groups are files that have extensions of *.ns?, *.nt? and*.box.

BRMS provides the following three new special values that can be used as backup items in a backup control group which you can use to backup additional integrated file system objects:

  1. *LNKOMTONL (replaces list QLTSEXCL)
    Note:
    The *LNKOMTONL in conjunction with your online backups can replace the *LINK backup item entry from the control group you use for the full system save.
  2. *LNKOMTLTS (replaces list QIFSXCLLTS)
  3. *LTSOMTONL (replaces list QLTSXCLONL)

The files backed up by the above special values are dynamic in nature. When you use these special values, BRMS will figure out the correct files to save prior to running the back up.

BRMS provides the following three lists which you can modify and use to define omits for the above special values:

  1. QLNKOMTONL (omit list for *LNKOMTONL)
  2. QLNKOMTLTS (omit list for *LNKOMTLTS)
  3. QLTSOMTONL (omit list for *LTSOMTONL)

The above lists are managed by you to define integrated file system directories and files to be omitted omit from the backup item. For example, you might add directory /tmp/* *OMIT to the QLNKOMTONL or QLNKOMTLTS to exclude the files in the /tmp directory from the backup. You do not need to add these lists to the backup control group. The items in the list will be appended to the object list of the associated backup item.

Note:
The following restrictions apply to the Include or omit value in the lists:

The following table lists the BRMS objects which are automatically created by BRMS. These objects along with the BRMS System Policy and Backup Policy determine whether your backup will be directed to a device, a save file, or a TSM server. These BRMS objects will automatically be updated to include new Lotus Servers when you run the Start Maintenance using BRM (STRMNTBRM) command, or the Initialize BRMS (INZBRM) command with *DATA specified for the OPTION parameter.

Name Object type Description
QLTSSVR Backup control group Backs up all Lotus Servers on the system. The entries in this control group are dynamic; however, BRMS will attempt to preserve modifications you might make to the entries. New Lotus servers will be appended after the existing entries and before the post exit.
QLTSDOMnn Backup control group Backs up all databases for Lotus Server nn, where nn is 01-99.
QLTSSVR Media policy Media policy specifying the media class and expiration to be used for Lotus Server backups.

The following backup link lists are provided to help you manage your backup windows. If you want to include "extra" user defined omits that will not be impacted by the dynamic nature of these lists, see NOTE 4 below.

Also if you are running these lists while the domino servers are active, see NOTE 5 below. If you encounter locks on objects while running the following lists, consider using save-while-active, ending any subsystems or applications that are holding locks against the objects, or saving in a restricted state by ending all subsystems to include these objects in the backup.
*LNKOMTONL Backup item for backup control groups Control group backup item which includes all integrated file system objects except the online data listed in Table 3.
*LTSOMTONL Backup item for backup control groups Control group backup item which includes all Lotus Server directories objects except the online data listed in Table 3.
*LNKOMTLTS Backup item for backup control groups Control group backup item which includes all integrated file system objects except all Lotus Server directories and objects.
QLNKOMTONL Backup Link List User-defined omits to be added automatically to *LNKOMTONL.
QLTSOMTONL Backup Link List User-defined omits to be added automatically to *LTSOMTONL.
QLNKOMTLTS Backup Link List User-defined omits to be added automatically to *LNKOMTLTS.
Notes:
  1. The Lotus Server databases are integrated file system files that have extensions of *.ns?, *.nt? and *.box.
  2. Be sure to backup your entire system immediately after you install BRMS and before you start an online Lotus Server backup. (See Chapter 3, Backing Up Your Entire System). For current BRMS users, these steps do not necessarily apply, but you should be able to apply the information to your own environment as appropriate.
  3. The following files are approved by Lotus Domino® for i5/OS for exclusion from the backup.
    Table 3. Lotus Server Online Data 
    *.nt? 
*.ns? 
*.box 
*.dtf 
*.ft 
*.lck 
*.log 
*.mtc 
*.tmp 
*.NOTESHST 
S*.TXN 
nlogctrl.lfh
pid.nbf
brmschgs
brms/incrsave/* 
brms/copiedlog/* 
IBM_TECHNICAL_SUPPORT/*
fault_recovery.hst 
/tmp/QACX*

  4. Users can now add omits to the dynamic lists QLTSEXCL, QLTSXCLONL, and QIFSXCLLTS.

    With SI07015(V5R1) and/or SI07016(V5R2) applied, users will be allowed to add their own omits to a new list that is combined with the old dynamic list. For example: 

    The new user list QLNKOMTONL will be added to the QLTSEXCL dynamic list. 
The new user list QLTSOMTONL will be added to the QLTSXCLONL dynamic list. 
The new user list QLNKOMTLTS will be added to the QIFSXCLLTS dynamic list.

    These new lists are not dynamic and their content is controlled by the user.

    Do NOT add these new user lists to your control groups as they will automatically be appended to the appropriate dynamic list (QLTSEXCL, QLTSXCLONL, or QIFSXCLLTS) when that list is processed.

  5. If you run QLTSEXCL or QLTSXCLONL while the servers are active, you will want to specify the path to the notes.ini file for each server in order to omit them. If you are running Lotus Enterprise Integrator® (LEI) version 5 and earlier, you will also want to omit /QIBM/USERDATA/LOTUS/LEI/LCCSMP. Starting at Version 6.01 of LEI, this file has moved to /tmp and the naming convention has changed (LEI server name + LCCSMP), that is, /tmp/LEIMED02LCCSMP. You will need to backup these files when the servers are down. If the transaction logs are in a directory that isn't under the Domino data directory, then you should also add the path to the transaction log directory to this omit list.

    If you use WRKDOMSVR or other domino commands during a save operation of the backup link lists QLTSEXCL, QIFSXCLLTS, or QLTSXCLONL - the /tmp directory might be locked and interfere with the operation of the command. One symptom of this interference might be a blank screen on the WRKDOMSVR command. In this case, you will need to wait for the lock on the /tmp directory to be released before the command will work correctly. In order to avoid this situation, you might want to omit the /tmp directory by adding it to one of the user-defined additional omit lists, QLNKOMTONL, QLTSOMTONL or QLNKOMTLTS (see NOTE 4 above).

  6. In order to issue a save of these dynamic lists, you must have the authority to read and traverse the domino directories.
  7. After a FULL save of the integrated file system directories, for example, after a save using a control group with a *LINK backup item, any incremental save of an online domino server will be changed to a FULL. If you want to ensure that an incremental save is done, replace the *LINK with QLTSEXCL or an equivalent list that will exclude your online domino data in the control group that you use to save your integrated file system directories.


[ Top of Page | Previous Page | Next Page | Contents | Index ]