Domino 8 for System i Help - Configuring BRMS integration components

CHAPTER 18 MANAGING BACKUP AND RECOVERY

Configuring BRMS integration components
To enable the BRMS integration feature for a server, the following components need to be created to enable backup using BRMS:

A control group for performing an online backup of the databases for a Domino server.
A BRMS link list to exclude Domino databases when backing up i5/OS directories.
A control group for performing an online backup of the databases for all Domino servers. This control group is optional and is not needed if you have only one Domino server on your system.

The following are example procedures for each situation.

Control group for online backup of databases for a Domino server
This control group will be defined to perform an online backup of all databases for a specific Domino server. You can use any name for the control group. However, we recommend that you use the name of the i5/OS subsystem in which the Domino server runs. You can determine the subsystem name by entering the following CL command:

wrkdomsvr

In the following procedure, we represent the control group name by dominox. Substitute the actual server subsystem name for dominox.

1. Enter the following CL command:

go brms

2. Type a 2 at the command prompt and press Enter to select Backup.

3. On the Backup display, type a 1 and press Enter.

4. On the Backup Planning display, type a 2 and press Enter.

5. On the Work with Backup Control Groups display, type a 1 in the Opt column to create a control group.

6. Type dominox in the Control Group column and press Enter.

7. On the resulting display, enter the following sets of Seq values:

Type 10 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter.
Type 20 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter.
Type 30 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter.

8. Position the cursor to the Seq 20 entry and press F10.

9. In the Command field, type savdombrm and press F4.

10. In the Server name field, type the name of your Domino server; for example, domserv1.

11. In the Control Group field, type the name that you specified in step 6; for example, dominox.

12. If desired, position the cursor to the Files to omit field and specify the location of objects that you want to omit (databases you do not want saved). You must specify the location of the objects as the directory path relative to the server data directory. For example, if you want to omit the file named mydb.nsf that is located in the server data directory /notes/data, type mydb.nsf in the Files to omit field, not /notes/data/mydb.nsf. You can use the wildcard character (*) in the object name.

13. Press Enter twice.

14. Press F3.

15. Select option 1 and press Enter to save and exit the session.

16. Press F3 four times.

BRMS link list to exclude Domino databases
Because Domino databases are backed up using other control groups created by the BRMS integration feature, they should be excluded from backups of the rest of the i5/OS integrated file system. This will allow your Domino server to remain active while the rest of the file system is backed up. You can define the QDOMEXCL link list to allow exclusion of Domino databases from backups of the rest of the file system. To create the QDOMEXCL link list, follow these steps:

1. Type the following CL command and press Enter:

go brms

2. Type a 2 at the command prompt and press Enter to select Backup.

3. On the Backup display, type a 1 and press Enter.

4. On the Backup Planning display, type a 5 and press Enter.

5. On the Work with Backup Lists display, type a 1 in the Opt column to add a Backup list, QDOMEXCL in the List Name column, *BKU in the Use column, and *LNK in the Type column.

6. Press Enter.

7. Type a text description, such as "All integrated file system objects except Domino server databases" and press Enter.

8. Type a 2 next to the QDOMEXCL list name and press Enter.

9. Use sets of the Name field and Include or omit field to define the system objects in the list. For example:

Include all of the integrated file system. Type '/*' in one of the Name fields and type *INCLUDE in the associated Include or omit field.
Omit the QSYS.LIB file system. Type '/QSYS.LIB' in a Name field and type *OMIT in the associated Include or omit field.
Omit the QDLS file system. Type '/QDLS' in a Name field and type *OMIT in the associated Include or omit field.
Omit all of the file extensions for Domino databases (*.nt* and *.ns*). Use fully qualified path names to specify the location of these databases. For example, if you want to omit the *.ns* databases that are located in the server data directory at /notes/data, type '/notes/data/*.ns*' in the Name field.

You can now use this list in a control group instead of the *LINK special value. In BRMS, *LINK means all objects in the integrated file system. If you are doing an online backup of Domino databases, you do not need to include them in a backup of the entire integrated file system. However, you should do a full system backup each week. This means using the *LINK value to include the entire integrated file system.

Control group for online backup of databases for all Domino servers (optional)
This control group will be defined to perform an online backup of all databases for all Domino servers. For the control group name, we use qdomino. You can use a different name.

1. Enter the following CL command:

go brms

2. Type a 2 at the command prompt and press Enter to select Backup.

3. On the Backup display, type a 1 and press Enter.

4. On the Backup Planning display, type a 2 and press Enter.

5. On the Work with Control Groups display, type a 1 in the Opt column and type qdomino in the Control Group column.

6. Press Enter.

7. On the resulting display, enter the following sets of Seq values:

Type 10 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter.
Type 20 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter. This Seq entry will represent the first Domino server that you want to back up.
Type 30 in the Seq column, *exit in the Backup Items column, and *dftact in the Weekly Activity SMTWTFS column. Press Enter. This Seq entry will represent the second Domino server that you want to back up.
Add additional Seq entries until you have one entry for each Domino server that you want to back up. Type xx in the Seq column, where xx is a number such as 40 or 50. Like the previous Seq entries, type *exit in the Backup Items column and *dftact in the Weekly Activity SMTWTFS column. Press Enter after typing in the values for each Seq entry.

8. Position the cursor to the Seq 20 entry and press F10.

9. In the Command field, type savdombrm and press F4.

10. In the Server name field, type the name of your Domino server; for example, domserv1.

11. In the Control Group field, type the control group name you specified in step 5; for example, qdomino.

12. If desired, position the cursor on the Files to omit field and specify the location of objects that you want to omit (databases you do not want saved). You must specify the location of the objects as the directory path relative to the server data directory. For example, if you want to omit the file named mydb.nsf that is located in the server data directory at /server1/data, type mydb.nsf in the Files to omit field, not /server1/data/mydb.nsf. You can use the wildcard character (*) in the object name.

13. Press Enter twice.

14. Repeat steps 8 through 11 for each Seq entry that represents a Domino server that you want to back up. Specify the appropriate Domino server name and the control group name from step 5. Also specify any objects to omit.

15. Add a final Seq entry that has *exit in the Backup Items column and *dftact in the Weekly Activity SMTWTFS column, but does not invoke the SAVDOMBRM command. That is, for this final Seq entry, skip steps 8 though 11.

16. Press F3.

17. Select option 1 and press Enter to save and exit the session.

18. Press F3 four times.