Skip to main content

 
IBM Power Systems software  >  IBM i  > Support and services  > 

How to initialize BRMS

  
Overview Lotus Server Backups GUI TSM Support
Initialize BRMS   |   Online backup    |    Saved item catalog    |    Disaster recovery planning    |    Single database recovery    |    Recommendations    |    How it works    |    Performance tuning    |    Copying control groups    |    Control group EXITs    |    Incremental backups    |    Recover an incremental backup    |    High availability strategy    |

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
or
QLTSEXCL		 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
or
QIFSXCLLTS		 QLNKOMTLTS This link list excludes all Lotus Server data directories from the backup.
*LTSOMTONL
or
QLTSXCLONL		 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.

 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.

*.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*

 NOTE 4: 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.