10.12 Adding a Volume Entry to the VLDB

DFS automatically adds volume entries to the VLDB when the DFS management context is initially created, when you create a new NSS volume, and during a VLDB repair process. Entries are not automatically added when you add a server with existing volumes to a container in a DFS management context or when you create an NCP volume. To add them, you must run the vldb repair command, which walks the tree and discovers the new volumes.

For OES replica sites, you can optionally add an entry for a volume by using the vldb add command instead. This might be faster than running the vldb repair command, particularly when you have a large tree but only a few entries that need to be modified. If the volume’s eDirectory Volume object already contains a DFS GUID attribute, this GUID is added to the VLDB. Otherwise, this command generates a DFS GUID for the volume and stores it in the Volume object and in the VLDB.

To issue the Add command:

  • The VLDB service must be running on the replica site.

  • You must be logged in as the root user or equivalent in the terminal console on the Linux replica site.

  • The specified volume must already have a Volume object in the eDirectory tree, and be in the management context.

The action results and errors are displayed on the console from which the operation is done, and are written to the /var/log/messages file.

  1. On the OES replica site, open a terminal console, then log in as the root user.

  2. At the terminal console prompt, view the current list of VLDB volume entries by entering

    vldb list

    For each volume entry, the server name, volume name, and DFS GUID are displayed.

  3. Visually verify that the volume does not already have an entry in the VLDB.

  4. Add an entry for the volume to the in-memory VLDB by entering

    For OES 2 SP2 or later, enter

    vldb add VolumeFDN

    For example, enter

    vldb add .server2_VOL1.mycompany.TREENAME.

    This command adds an entry for VOL1 on server2.mycompany.TREENAME to the VLDB database.

    For OES 2 SP1, enter

    vldb add svrname volname

    Replace svrname with the fully distinguished server name. Replace volname with the name of the volume.

    After successful authentication, the operation is performed on the in-memory VLDB, then is synchronized to the VLDB on the disk.

    If you have a second VLDB replica site, the changes you make to the VLDB database on the disk are automatically synchronized to the second site. The second replica can be on a Linux or NetWare server.