Directory Server

This page shows how to upgrade a directory server in place.

If you are adding a new server to an existing deployment, see When Adding New Servers instead.


Failure to follow the upgrade instructions can result in the loss of all user data.

Before upgrading, make sure you stop the server. Once you have unpacked the new server files, do not modify the server configuration until after you have completed the upgrade process.

  1. Prepare for upgrade as described in Before You Upgrade.

  2. Stop the server.

  3. Proceed to upgrade the server:

    • When upgrading a server installed from the cross-platform .zip:

      1. Unpack the new files over the old files as described in Unpack Files.

      2. Run the upgrade command to bring the server configuration and, if possible, directory data up to date with the new software delivery.

        By default, the upgrade command runs interactively, requesting confirmation before making important configuration changes. For some potentially long-duration tasks, such as rebuilding indexes, the default choice is to defer the tasks until after upgrade.

        You can use the --no-prompt option to run the command non-interactively. In this case, the --acceptLicense option lets you accept the license terms non-interactively.

        When using the --no-prompt option, if the upgrade command cannot complete because it requires confirmation for a potentially long or critical task, then it exits with an error and a message about how to finish making the changes. You can add the --force option to force a non-interactive upgrade to continue in this case, also performing long running and critical tasks.

    • When upgrading a server installed from native packages, use the system package management tools.

  4. (Optional) When the mutable data mounted at runtime differs from that of the instance where you first run the upgrade command, upgrade only mutable data by running the command again with the --dataOnly option at runtime.

    The --dataOnly option can be useful when running the server in a Docker container, for example.

    This improvement is available when upgrading from DS 6.0.0 or later releases.

  5. Start the upgraded server.

    At this point the upgrade process is complete. See the resulting upgrade.log file for a full list of operations performed.

    Replication updates the upgraded server with changes that occurred during the upgrade process.

    When you upgrade from version 3.0 or earlier, the upgrade process leaves the HTTP connection handler disabled.

    The newer configuration is not compatible with the previous configuration. You must rewrite your configuration according to REST to LDAP Reference, and then configure the server to use the new configuration. For details, see HTTP Access.

  6. (Optional) If you disabled the Windows service to upgrade, enable it again:

    C:\path\to\opendj\bat> windows-service.bat --enableService
Read a different version of :