Initialize BRMS

BRMS objects that are automatically generated for Lotus Servers

BRMS will automatically generate the control groups and media policies you need to perform Lotus Server online backups whenever the STRMNTBRM or INZBRM OPTION(*DATA) commands are run. The following table lists the control groups and media policy that are automatically generated:

NameObject TypeDescription
QLTSSVRControl groupBacks up all Lotus Servers on the system including both Domino and QuickPlace servers
QLTSDOMnnControl groupBacks up all databases for Lotus Domino Server nn, where nn is 01-99
QLTSQPLnnControl groupBacks up all databases for Lotus QuickPlace Server nn, where nn is 01-99
QLTSSVRMedia policyMedia policy specifying the media class and expiration to be used for Lotus Server backups


NOTES: 

  1. The Lotus Server control groups are intended for use with the STRBKUBRM command only.
  2. Do not run the SAVDOMBRM command outside of BRMS control groups.Do NOT add the name of the user-modifiable lists to the Lotus Server control groups since they will automatically be appended to the dynamic list specified as a control group entry as specified below. If the name of the user-modifiable list is added to the control group, an error will be sent stating that nothing was saved.
  3. *EXITs will automatically be added to these control groups for each Domino or QuickPlace server BRMS finds configured on the system whenever the STRMNTBRM or INZBRM OPTION(*DATA) commands are run.
  4. 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)


Dynamic backup link lists to help you manage your backup window

BRMS dynamic backup link lists for Lotus Servers can be used to exclude everything that has already been saved during Lotus Server online backups. The dynamic link lists can be used by adding the following entry names to control groups:

Entry NameUser-Modifiable ListDescription
*LNKOMTONLQLNKOMTONLBackup all links in all directories except the Lotus Server databases that are saved during an online Lotus Server backup. This Entry also excludes various Lotus Server files that do not need to be backed up - see Usage Note 3 below for a list of all of the files that will be excluded.
*LNKOMTLTSQLNKOMTLTSBack up all links in all directories except Lotus Server links.
*LTSOMTONLQLTSOMTONLBack up all Lotus Server links except the Lotus Server databases that are save during an online Lotus Server backup.

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.

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, see Usage 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.

NOTE: For *LINK control group entries, links can excluded from backup by adding them to the QLNKOMT link list.

Usage Notes

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

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.

Note 3: 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 sub-directories. 

  • *.box
  • *.dtf
  • *.ft
  • *.lck
  • *.log
  • *.mtc
  • *.NLO
  • *.NOTESHST
  • *.ns?
  • *.nt?
  • *.tmp
  • S*.TXN
  • brmschgs
  • brms/copiedlog/*
  • brms/incrsave/*
  • fault_recovery.hst
  • IBM_TECHNICAL_SUPPORT/*
  • nlogctrl.lfh
  • pid.nbf
  • workspace
  • /tmp/QACX*
  • <DAOS directory>
  • <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 Omit additional Lotus Server objects during backups page.

Note 3.1: 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
  • 6.1 SI40006
  • V5R4M0 SI40001

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

 Note 4: If you run *LNKOMTONL or *LTSOMTONL 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, *LTSOMTONL or *LNKOMTLTS - 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.

Note 8:  When using BRMS to do online backups of Lotus Domino, additional IFS directories and files may be created . More details about these can be found in the in IFS directories used when backing up Domino for i5/OS using BRMS. All directories are relative to the Domino data directory.

  • /BRMSCHGS
  • /BRMSINFO
  • /BRMS
  • /BRMS/INCRSAVE
  • /BRMS/COPIEDLOG
  • /BRMS/LASTPARTIALLOG