Backup Recovery and Media Services

BRMS will automatically generate the control groups and media policies you need to perform Lotus Server online backups. In addition, BRMS also dynamically creates backup link lists so that those same Lotus Server databases can be excluded from your other backups. These BRMS objects will automatically be updated to include any new Lotus Servers when you run the STRMNTBRM or INZBRM *DATA commands.

The following table lists the BRMS media policy and control groups that are automatically generated for you by BRMS. These control groups are intended for use with the STRBKUBRM command.

Automatically generated BRMS objects

Name	Object type	Description
QLTSSVR	Control group	Backs up all Lotus Servers on the system including both Domino and QuickPlace servers
QLTSDOMnn	Control group	Backs up all databases for Lotus Domino Server nn, where nn is 01-99
QLTSQPLnn	Control group	Backs up all databases for Lotus QuickPlace 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

BRMS dynamically generates backup link lists that exclude everything that has already been saved during your online backups. In addition, BRMS provides user-modifiable lists that allow you to add additional excludes to those dynamically generated lists. You use these lists by adding the entry name listed below to your control group.

NOTE: Do NOT add the name of the user-modifiable lists to the control group since they will automatically be appended to the dynamic list that you specified as the control group entry. If you add the name of the user-modifiable list to the control group, you will get an error on that entry stating that nothing was saved.

Dynamic backup link lists to help you manage your backup window

Entry name	User-modifiable list	Description
*LNKOMTONL	QLNKOMTONL	This link list excludes all Lotus Server databases from the backup since they have already been saved by the online Lotus Server backup. It will save all of the non-database files in the Lotus Server IFS directories as well as the non-Lotus Server IFS directories. This link list also excludes various Lotus files that do not need to be backed up - see NOTE 3 below for a list of all of the files that will be excluded.
*LNKOMTLTS	QLNKOMTLTS	This link list excludes all Lotus Server data directories from the backup.
*LTSOMTONL	QLTSOMTONL	This link list includes all Lotus Server data directories and excludes the online backup Lotus Server databases. See NOTE 3 below.
*LINK	QLNKOMT	In V5R3 with SI13463 applied, you can specify any directories or links to be excluded from a *LINK backup by adding them to the QLNKOMT user-modifiable list.

Entry name: If you enter either the special value or link list name in an entry of your control group, BRMS will dynamically generate a list of objects to include or exclude from your save as described in the table above. Prior to V5R3, use the link list name. For V5R3 and later releases, use the special value.

User-modifiable list: The backup lists shown in the table above are all dynamically created by BRMS at the time the control group is processed. BRMS provides the user-modifiable lists in the table above so that you can add any additional omits to your save by appending that list to the one that is dynamically generated by BRMS. These lists are intended only for additional omits. If you add includes to these lists, you may not get the behavior that you expect.

If you are running these lists while the domino servers are active, please see NOTE 4 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.

Usage notes

NOTE 1: The Lotus Server databases are IFS files that have extensions of *.ns?, *.nt? and *.box.

NOTE 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 in the BRMS manual). 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.

NOTE3: The following files will be excluded when you run either the *LNKOMTONL (QLTSEXCL) or *LTSOMTONL (QLTSXCLONL) backup link lists from a control group. Names without a leading '/' will be excluded from the Lotus Server data directory and any of its subdirectories. In addition to excluding these files, there may be other considerations, see Technote: Save of Domino data locks required objects and causes second LOGASIO job to spawn.

      *.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
      workspace
      /tmp/QACX*
      <transaction log directory>

      Other objects may conflict with Domino operations, these
      objects can be omitted by creating data area
      QUSRBRM/Q1ANLSTOMT as described on the BRMS data areas page.

      Note: The <transaction log directory> is identified in file
      '<domino directory path>/brmschgs/LocationTRANSLOG.txt',
      Domino 8.5.2 (or Domino 8.5.1 FP5) and the following BRMS
      PTFs or their superseding PTFs are required:
      - 7.1 SI40005
      - V6R1M0 SI40006
      - V5R4M0 SI40001

      Note: The workspace directory is omitted in the following BRMS PTFs or their superseding
      PTFs:
      - 7.1 SI42066
      - V6R1M0 SI42065
      - V5R4M0 SI42064

NOTE4: If you run *LNKOMTONL (QLTSEXCL) or *LNKOMTLTS (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), i.e./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 of the backup link lists *LNKOMTONL (QLTSEXCL), *LTSOMTONL (QIFSXCLLTS) or *LNKOMTLTS (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 have 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 may want to omit the /tmp directory by adding it to one of the user defined additional omit lists, QLNKOMTONL, QLTSOMTONL or QLNKOMTLTS.

NOTE 5: In order to issue a save of these dynamic lists, you must have the authority to read and traverse the domino directories.

NOTE 6: After a FULL save of the IFS directories, i.e. 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 *LNKOMTONL (QLTSEXCL) or an equivalent list that will exclude your online domino data in the control group that you use to save your IFS directories.

NOTE 7: When LNT0970 RC 11 because of timeouts followed by LNT0978 are posted, users may see that all objects looked to be saved when looking at the number of objects saved via WRKMEDiBRM when comparing the number of objects saved in the CPC370C message in the joblog. When performing the online backups of Domino data, there are two saves occurring under the covers with one being the actual full online save of the objects and the second being the save of the changes occurring to those objects during the saving of the group. This means that normally where the timer isn't exceeded that you'll see two object count saves in the joblog with one being the save of the actual object and what is reported through WRKMEDIBRM and the other being the save of the changes. Thus two entries for each group of objects.

The following link lists are also created when BRMS is installed

QIBMLNK – Used to save all IBM IFS directories and files in the IFS:
('/QIBM/ProdData') ('/QOpenSys/QIBM/ProdData')

QALLUSRLNK - Used to save all user directories and files in the IFS:
('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)
('/QIBM/ProdData' *OMIT ('/QOpenSys/QIBM/ProdData' *OMIT)