IBM Support

How can I move the location of the DAOS subdirectory

Technote (troubleshooting)


Problem

You originally implemented DAOS using the default recommendation of creating the DAOS subdirectory within the server's data directory. You now need to move it out of the data directory. How can this be done?

Cause

The Domino server frequently scans the data directory to be aware of all existing files. Moving the DAOS subdirectory outside of the Domino server will prevent these scans and improve performance.

Resolving the problem

Perform the following steps to move the DAOS subdirectory to a new location (IBM i):

1. Determine the location where you will be storing the DAOS directory. The following directory structure is one possible way of storing the data.


    Existing data directory: /Domino_Server/Data

    Existing DAOS directory: /Domino_Server/Data/DAOS

    New DAOS directory: /Domino_Server/DAOS


It is not recommended to have multiple DAOS directories under the same top level directory. For example, the following DAOS directory layout is NOT recommended:

    Server 1 data directory: /Domino/Server1

    Server 1 DAOS directory: DAOS/Server1

    Server 2 data directory: /Domino/Server2

    Server 2 DAOS directory: DAOS/Server2


Warning: This process requires the server to be ended.

2. Modify the server document on the DAOS enabled server (or replicate as required) and enter the new location for the DAOS subdirectory. Save the modified server document and then end the Domino server.


3. Wait for the Domino server to end.

4. Create the directory to hold the new DAOS directory if you have not done so already.


    On IBM i, use the CRTDIR command, for example:

    CRTDIR '/Domino_Server/DAOS'


5. Change the ownership of the new directory to QNOTES.

    On IBM i, use the CHGOWN command, for example:

    CHGOWN '/Domino_Server/DAOS' QNOTES


6. Delete the existing daos.cfg file in the data directory for your server.

7. Move the DAOS directory to its new location.


    On IBM i, use the MOV command, for example:

    MOV OBJ('/Domino_Server/data/DAOS') TODIR('/Domino_Server/DAOS')

8. Restart the Domino server.


Perform the following steps to move the DAOS subdirectory to a new location (Windows):



1. Modify the server document, DAOS base path to f:\DAOS
2. Shut down Domino
3. Create folder f:\DAOS
4. Delete existing daos.cfg file
5. Move DAOS NLO folder directory(s) from C: to F: (for example 0001,0002,0003,etc...)
6. Edit the Server Notes.ini, and add DAOSBASEPATH=f:\DAOS
7. Open a Windows Command Prompt, CD to the Domino Program Directory, and run 'ndaosmgr resync'. Wait for this to complete.
8. Restart Domino

NOTE: Steps 6 and 7 are optional and only required if you want to resynch the DAOS catalog before the server is restarted

Perform the following steps to move the DAOS subdirectory to a new location (Unix):


The best practice is not to have the DAOS directory under the Data directory. For performance reasons you want the NLOs on a separate drive/controller, if possible. 

Unix is case sensitive -when you enter the new path in the server document check your spelling.
The directories "\DAOS" and "\daos" are not the same - they would be treated as two different directories in Unix.

Use Unix command "ls -la" to list permissions on the \DAOS directory before and after it has been moved.

To move a directory with all subdirectories and files use the Linux / Unix move command.
mv -r dir1 dir2
mv -r /local/notesdata/daos /local/daos 
In the above example the mv command would move all files, directories, and subdirectories in the /home/hope/files directory to the /home/hope/backup directory.

example new DAOS directory = "/local/daos"

1. Modify the server document, DAOS base path to "/local/daos"
2. Shut down Domino
3. Mount the new directory "/local/daos"
4. Delete the existing daos.cfg file
5. Move the DAOS NLO directory and all it's subdirectories to the new directory
mv -r /local/notesdata/daos /local/daos
6. Edit the Server Notes.ini, and add DAOSBASEPATH=/local/daos
7. Open a Unix terminal window, change directory to the Domino Program Directory, and run 'ndaosmgr resync'. Wait for this to complete.
8. Restart Domino

Document information

More support for: IBM Domino
DAOS

Software version: 8.5, 8.5.0.1, 8.5.1, 8.5.2

Operating system(s): AIX, IBM i, Linux, Windows, z/OS

Software edition: Edition Independent

Reference #: 1415153

Modified date: 18 February 2011