ShowTable of Contents
The following guide shows the minimum number of steps needed to get the Domino Attachment and Object Service (DAOS) configured and running. For more detail on all these and other optional steps, see the
DAOS Best Practices Guide.
Enabling DAOS
- Upgrade your Domino server to 8.5.
- Verify that transaction logging is enabled on your server. This is a prerequisite for DAOS. Using “show server” on the server console, you should see a line stating “Transactional Logging: Enabled”. Transaction logging can be enabled on the Transaction Logging tab of your server document.
- Completely disable Shared Mail. Set the “Shared Mail” field to “None” on the Shared Mail tab of your server document and run the object UNLINK command to unlink any existing mail files from the shared ones.
- Fill in the four fields on the DAOS tab of your Server document:
- “Store file attachments in DAOS”: Set to Enabled.
- “Minimum size of object before Domino will store in DAOS” (bytes): The default is 4096. 64,000 is recommended.
- “DAOS base path”: Specify a file path for DAOS storage. This file path can be a valid absolute path (for example, C:\DAOS on Windows), or a relative path to be created as a subdirectory of the Domino data directory. The default is “DAOS”.
- “Defer object deletion for” (days): The default is 30. This is recommended.
- Add “Create_R85_Databases=1” to the server's notes.ini file.
- Restart the server.
Verify that DAOS is now enabled on the server by typing “show server” from the server console. You should see a line stating “DAOS: Enabled”.
Enabling a Notes Database
With the server enabled for DAOS, a user with Administrator rights can enable a Notes database to participate in DAOS using one of three methods:
- Navigate to the Advanced tab of the Application Properties box and select the “Use Domino Attachment and Object Service” option.
- Using the Domino Administrator, select a Notes database from the Files tab and choose Tools - Database - Advanced Properties; then select the “Use Domino Attachment and Object Service” option.
- From the server console, issue a “load compact -daos on dbname” where dbname is the name of a Notes database. \
After you use one of these methods, any new attachments created in that Notes database that meet the minimum DAOS size requirement will be managed by DAOS.
To enable multiple Notes databases at one time, use option 2 and select multiple files or use option 3 and designate a path or standard Domino indirect (.IND) file rather than a single database (
dbname).
To enable DAOS on an existing Notes database
and move its current attachments into DAOS, you must use option 3 and add an additional flag to the command. Adding the “-c” flag (copy-style compact) moves existing attachments out of the NSF and into the DAOS repository. The full command is as follows: “load compact -c -daos on
dbname”. You can also run this from the command line with or without the server running. Again,
dbname can be replaced by a relative path or standard Domino indirect (.IND) file to act on multiple files.
Note: This compaction will automatically upgrade the database to ODS 51.
Note: “load compact -c -daos off” will disable DAOS on a Notes database and move the attachments back into the NSF.
DAOS setup is now complete. To monitor and verify that DAOS is functioning properly, use “tell daosmgr status” from the server console to give a status or “tell daosmgr status databases” for a status of all DAOS enabled databases. You can also verify a database's participation in DAOS with the Domino Administrator or the server console command “show directory -daos”.
Monitor DDM messages to verify continued correct operation of DAOS. If you believe that DAOS is not functioning properly at this time, see
DAOS FAQ for more information.
LotusScript to enable DAOS
For situations where using a server command is not an option, DAOS can be activated/deactivated by using LotusScript.
Domino Developers can write a scheduled agent using the following LotusScript property in order to enable DAOS for a given database:
Call NotesDatabase.SetOption(81,true)
To read the DAOS status of a file, use
NotesDatabase.GetOption(81)