Upgrading This chapter covers upgrade from OpenDJ 2.4.5 and later versions. For upgrades from earlier versions, upgrade first to OpenDJ , and then follow the procedures in this chapter. See Upgrading OpenDJ Directory Server in the OpenDJ Wiki for details on upgrading to OpenDJ from earlier versions. Prepare to perform the upgrade procedure as the user who owns the OpenDJ server files. Make sure you have the credentials to run commands as the user who owns the server. In order to revert should the upgrade fail, make sure you perform a full backup of your current OpenDJ installation. It might be most expedient to back up the file system directory where the current OpenDJ server is installed as part of the upgrade process. Alternatively, see Backing Up & Restoring Data for instructions. Login as the user who owns the current OpenDJ server. Stop the current OpenDJ server. If you have not already backed up the current OpenDJ server, make a back up copy of the directory where OpenDJ is installed. If OpenDJ is currently installed in a directory such as OpenDJ-2.4.6, you can change the directory name to opendj to make it easier to unpack subsequent .zip deliveries for future upgrades. Unpack the new files from the .zip delivery over the current server files. If your directory is not named opendj, then you can first unpack the files, then copy everything in the opendj over the current server files. Run the upgrade command to bring OpenDJ configuration and application data up to date with the new binary and script files that you copied over the current server files. By default, the upgrade command requests confirmation before making important configuration changes. You can use the --no-prompt option to run the command non-interactively. When using the --no-prompt option, if the upgrade command cannot complete because it requires confirmation for a potentially very 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. Start the upgraded OpenDJ server. At this point the upgrade process is complete. See the resulting upgrade.log file for a full list of operations performed. The following example upgrades an OpenDJ 2.4.6 directory server installed in /path/to/OpenDJ-2.4.6, backing up the current server directory in case the upgrade process fails, and changing the directory name to /path/to/opendj to simplify future upgrades. $ cd /path/to $ ls OpenDJ-2.4.6 $ ./OpenDJ-2.4.6/bin/stop-ds --quiet ... msg=The backend userRoot is now taken offline ... msg=The Directory Server is now stopped $ zip -rq OpenDJ-backup.zip OpenDJ-2.4.6 $ unzip -q ~/Downloads/OpenDJ-.zip $ cp -r opendj/* OpenDJ-2.4.6/ $ rm -rf opendj $ mv OpenDJ-2.4.6 opendj $ ./opendj/upgrade --no-prompt >>>> OpenDJ Upgrade Utility * OpenDJ will be upgraded from version 2.4.6.8102 to .revision * See '/path/to/opendj/upgrade.log' for a detailed log of this operation >>>> Preparing to upgrade OpenDJ modified the default configuration of the 'isMemberOf' virtual attribute so that it is included with group entries. This was done in order to make it easier for users to determine which groups a 'nested' group belongs to. Do you want to make this configuration change? (yes/no) yes The upgrade is ready to proceed. Do you wish to continue? (yes/no) yes >>>> Performing upgrade Fixing de-DE collation matching rule OID............................ 100% Updating password policy configurations............................. 100% Updating audit log publisher configuration.......................... 100% Adding 'etag' virtual attribute schema.............................. 100% Configuring 'etag' virtual attribute................................ 100% Configuring 'ds-pwp-password-expiration-time' virtual attribute..... 100% Updating certificate syntax configuration........................... 100% Updating JPEG syntax configuration.................................. 100% Updating country string syntax configuration........................ 100% Modifying filter in 'isMemberOf' virtual attribute configuration.... 100% Updating dictionary password validator configuration................ 100% Updating attribute value password validator configuration........... 100% Adding PBKDF2 password storage scheme configuration................. 100% Replacing schema file '02-config.ldif'.............................. 100% Archiving concatenated schema....................................... 100% >>>> OpenDJ was successfully upgraded from version 2.4.6.8102 to .revision * See '/path/to/opendj/upgrade.log' for a detailed log of this operation $ ./opendj/bin/start-ds --quiet $ Upgrade each server sequentially, as described above. Replace the gateway web application with the newer version, as for a fresh installation.