Domino Attachment and Object Services - DAOS

Share identical data between databases

For specific information about DAOS visit the sections on this page:

Configure Domino for DAOS

IBM Lotus Domino attachment and object services (DAOS) can be configured to save significant space at the file level by sharing data identified as identical between databases (applications) on the same server. Document attachments are the first components to use the DAOS feature in Lotus Domino.  For more information see, IBM Lotus Domino going green: The new Lotus Domino attachment and object services.

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.

Save DAOS objects for Domino

Starting with Domino release 8.5.2, BRMS will save DAOS files (.nlo) with backups of Domino server database files (.nsf).  The information on this page assumes BRMS is being used with Domino release 8.5.2.

NOTES:

1. For Domino release 8.5.1 considerations see - Save DAOS objects for Domino 8.5.1
2. For Domino release 8.5.0 considerations see - Save DAOS objects for Domino 8.5.0

Generate distinct BRMS saved items for Domino database objects and DAOS objects

By default, when BRMS saves Domino databases files (.nsf) and Domino attachment and object services (DAOS) files (.nlo), one saved item gets created.  To add flexibility to recovery processes, it may be desirable to create two saved items, one for Domino database objects and one for DAOS objects.  To change the default behavior to have separate saved items generated,  run the following command:

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

If the backup generates separate saved items, subsequent recovery reports (QP1ARCY) created by the Start Recovery using BRMS (STRRCYBRM) and Work with Media Information (WRKMEDIBRM) commands will display the separate saved items as follows:

• For full saves
        *LTSONL - full save of Domino database objects
        *DAOSF - full save of the DAOS objects
• For incremental saves
        *LTSINC - incremental save of Domino database objects
        *DAOSI - incremental save of the DAOS objects

NOTES:

1. In releases IBM i 7.1 and earlier, the following PTFs or their superseding PTFs are required:
   • 7.1 SI40005 
   • 6.1 SI40006 
   • V5R4M0 SI40001

Mix full and incremental backups for Domino database objects and DAOS objects

By default, Domino database objects and DAOS objects are saved together as full or incremental save types.  This will generate a single saved item.

To add flexibility to recovery processes, it may be desirable to mix the save types for Domino database objects and DAOS objects.  BRMS backups of Domino database objects and DAOS objects can be mixed as incremental and full save types.  For example, full saves of Domino database objects can be combined with incremental saves of DAOS objects.  Weekly activity supports two additional backup activities for DAOS to allow the mixed backups. The following weekly activity values can be specified for Domino backups:

• F - full save of the domino databases and full save of the DAOS objects
• I - incremental save of the domino databases and incremental save of the DAOS objects
• N - full save of the domino databases and incremental save of the DAOS objects
• D - incremental save of the domino databases and full save of the DAOS objects

    
NOTES:

1. If activity ‘N’ and/or ‘D’ is specified for the weekly activity, separate saved items will automatically be generated, i.e. data area QUSRBRM/Q1ADAOSSEP does not need to be created as described above.
2. The weekly activity characters for DAOS can be overridden, see Override weekly activity presentation characters for DAOS objects.

Configure DAOS saves for improved recovery performance

By default, when saved separately, DAOS objects are backed up in large groups.  As the number of DAOS objects grows it can significantly increase potential recovery times for individual DAOS objects.  Domino can be configured to force multiple smaller saves to backup the DAOS objects by changing the SAVDOMBRM_DAOS_PERF value in the notes.ini file to 1.

NOTES:

1. Domino release 9.0.1, with FP1 and hot fixes, is required.
2. In releases IBM i 7.1 and earlier, the following PTFs or superseding PTFs are required:
   • 7.2 SI53306 
   • 7.1 SI53305 
   • 6.1 SI53304

Restore missing Domino DAOS objects

A list of missing Domino Attachment and Object Service (DAOS) objects can be generated by running the following command from the Domino console:

'daosmgr listnlo missing'

In IBM i release 6.1 and later, the Restore Object using BRM (RSTBRM) command can be used to restore missing DAOS objects using the file created by the daosmgr command.  On the RSTBRM command, specify *LIST for the Object (OBJ) object parameter and *DAOS and the DAOS stream file name for the List (LIST) parameter.

Since this enhancement was provided via PTF, RSTBRM command will not contain help text for OBJ(*LIST) or LIST() parameters. The help text is provided below:

Restore Object using BRM (RSTBRM) - Objects (OBJ) - Help      

*LIST                                                       

The List (LIST) parameter will be used to indicate which objects to restore.                                                          

Restore Object using BRM (RSTBRM) - List (LIST) - Help

Specifies a list that will be used to determine which objects will be restored.

Element 1: Type

The first element specifies the type of list that will be used to determine which objects to restore.

*DAOS

Specifies that the list of objects to restore should be taken from a stream file generated by a Domino Server for Domino Attached and Object Service (DAOS) objects.  The second element specifies a path name to a stream file that was created by a Domino Server.

Element 2: Path name

'list-name'                                                      

Specify the name that should be used to process the type specified in element 1. See the description of the values for element 1 to determine how to specify element 2.       

NOTES:

1. In IBM i releases 6.1 and 7.1, the following PTFs are required to use OBJ(*LIST) and LIST(): 
   • 7.1 SI50292 
   • 6.1 SI50291

Restore DAOS objects to a different Domino server

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.