Backup Recovery and Media Services

Configuring Domino for DAOS

When DAOS is enabled, the amount of disk storage being used for attachments will be reduced. It is important to note that this may also cause a significant increase in the number of integrated file system objects associated with the Domino server. An increase in the number of integrated file system objects may result in much longer save/restore times. Careful consideration should be given to the minimum attachment size for DAOS to balance the disk storage reduction and the save/restore time increases. See chapter 15 of the "IBM i Performance Capabilities Reference" for additional save/restore performance information. Use the Domino Attachment and Object Service Estimator Tool to determine how the DAOS configuration can be tuned to reduce disk storage utilization.

Saving DAOS objects for Domino 8.5.2

In the BRMS September 2010 PTF (see below for numbers) and with the Domino 8.5.2 release, you can now separate out the domino databases (nsf files) from the directory attach object services(DAOS) objects (nlo files). This allows you to do full and incremental backup in a mixed fashion. Maybe you want a full save of the databases every day, but incremental saves on the weekdays of the DAOS objects, this is now possible.

We have enhanced the weekly activity to support two new backup activities to go with the 2 current ways to back them up. Currently, when you select an ‘F’ for a full, you get both a full save of the domino databases and a full save of the DAOS objects. If you select an ‘I” for incremental save you will get an incremental save of both.

The two new backup activities are:

1. N’ for a full save of the domino databases but an incremental save of the DAOS objects
2. ‘D’ for an incremental save of the domino databases but a full save of the DAOS objects.

Note: ‘N’ and ‘D’ are the defaults, but can be customized.

To enable this function, you will need to create a data area:

 CRTDTAARA DTAARA(QUSRBRM/Q1ADAOSSEP) TYPE(*DEC) LEN(1)

It may be possible, in a future ptf, to eliminate the need for this data area.

In a futurePTF, BRMS will look to not requiring the data area, but will always run separate.

The recovery report(QP1ARCY) generated by the Start Recovery using BRMS (STRRCYBRM) and Work with Media Information(WRKMEDIBRM) will be enhanced to display 2 new save types:
*DAOSF - A full save of the DAOS objects for that Domino server
*DAOSI - An incremental save of the DAOS objects for that Domino server.

Note: If you use ‘N’ and/or ‘D’, we will run in separated mode , regardless of data area.

Overriding the presentation characters for Domino Databases and DAOS weekly backup activity

Use the following command to override the default presentation characters that are used to represent domino databases and DAOS object saves in weekly activity fields. The default, 'N' is used to represent 'Domino Database full backups and incremental DAOS object backups' and 'D' is used to represent ‘Domino Database incremental backups and full DAOS object backups'.

 CALL PGM(QBRM/Q1AOLD) PARM('DAOSCHARS ' '*SET ' ' ' 'N' ‘D')

To show the override values for presentation characters that are used to represent Domino and DAOS, use the following command:

 CALL PGM(QBRM/Q1AOLD) PARM('DAOSCHARS ' '*DISPLAY' ' ')

Note: The presentation character overrides for Domino and DAOS will only be available in releases IBM i 7.1 and earlier. In releases following IBM i 7.1, interfaces will be provided on BRMS commands.

Note: The BRMS client will not allow changing of control groups until the releases following IBM i 7.1.

The following PTFs or their superseding PTFs are required:

• V7R1M0 SI40005
• V6R1M0 SI40006
• V5R4M0 SI40001

Saving DAOS objects for Domino 8.5.1

The following steps must be taken to enable successful backups of DAOS objects for Domino 8.5.1:

1. Use WRKCTLGBRM TYPE(*BKU) option 2 to change the control group *EXIT entries that specify command QNOTES/SAVDOMBRM by adding this omit:
   *EXIT ---> QNOTES/SAVDOMBRM ....... OMIT(('daoscat.nsf'))
2. If V5R4M0 PTF SI36193 or V6R1M0 PTF SI36197 is not applied on the system, then the following omit must be added to the QLTSOMTONL list using WRKLBRM TYPE(*BKU) option 2:
   'daos.cfg'

When DAOS is enabled for Domino, Domino includes the following values in the notes.ini file. The values in the notes.ini file should not be changed directly by the user, they should only be changed by updating the properties on the Domino server and restarting the server.

DAOSEnabled
If the notes.ini file contains DAOSEnabled=0, or DAOSEnabled is not in the notes.ini file, then no DAOS objects will be saved. If DAOS is enabled with DAOSEnabled=1, then DAOS objects will be saved from the directory path name identified by DAOSBasePath in the notes.ini file.

DAOSBasePath
The directory path name for DAOS .nlo objects. The DAOS .nlo objects will be in subdirectories identified by DAOSBasePath. If the DAOSBasePath name doesn't start with a '/', then the .nlo objects will be found in a directory relative to the Domino data directory. If the name starts with a '/', then it is an absolute path name to the .nlo objects and is not relative to the Domino directory.

Saving DAOS objects for Domino 8.5.0

** WARNING - Until BRMS has enhanced the online function to support the new domino 8.5 DAOS function, users need to do the following when saving R8.5 Domino Servers with SAVDOMBRM:

The following steps must be taken to enable successful backups of DAOS objects for Domino 8.5.0:

1. Omit the DAOS directory from the QLNKOMTONL (additional omit list for *LNKOMTONL) or QLTSOMTONL (additional omit list for *LTSOMTONL) Example:
   OBJ(('/notes/server/DAOS' *OMIT))
2. Will need to do a backup with a link list of all the DAOS directories with *.NLOs on them to insure they are backed up. Example:
   OBJ(('/notes/server/DAOS/vol1/*.NLO))
3. On the restore make sure create parent directories has been set to yes in the recovery policy.
4. Use WRKCTLGBRM TYPE(*BKU) option 2 to change the control group *EXIT entries that specify command QNOTES/SAVDOMBRM by adding this omit:
   *EXIT ---> QNOTES/SAVDOMBRM ....... OMIT(('daoscat.nsf'))
5. If V5R4M0 PTF SI36193 or V6R1M0 PTF SI36197 or superseding PTF is not applied on the system, then the following omit must be added to the QLTSOMTONL list using WRKLBRM TYPE(*BKU) option 2:
   'daos.cfg'

Recovering DAOS objects
By default, DAOS objects are encrypted to be used on a specific Domino server. In order to access encrypted DAOS objects, they must be associated with the server from which they were saved. If the DAOS objects are restored to a different server, they must be moved back to the original server before they will be useable.