You can upgrade from an earlier version of OpenDJ either directly from within the Java WebStart installer, or on the command-line using the upgrade command. Upgrade from OpenDS 2.2 or OpenDJ 2.4 has been tested most thoroughly on Solaris, Mac OS X, and Linux. On Windows systems, export directory data to LDIF, start with a fresh installation of the OpenDJ software, and then import your data from LDIF.

You must perform the upgrade procedure as the user who own the OpenDJ server. Make sure you have the credentials to run commands as the user who owns the server. Do a full backup of your current OpenDJ installation. When running a server version earlier than OpenDJ 2.4.1 fix the upgrade schema by following the appropriate steps depending on your platform. (UNIX) Download and apply opendj_patch4upgrade.sh to your current server, by running the shell script from the directory where the server is installed. $ cd /path/to/OpenDJ $ sh /downloads/opendj_patch4upgrade.sh /path/to/OpenDJ has been patched, you can proceed with the upgrade program now The opendj_patch4upgrade.sh script fixes a schema issuethat prevents smooth upgrades from earlier server versions. You can apply the script while the server is running. (Windows) Follow these steps. With the edit command line tool, open and then save OpenDJ-old-version\config\upgrade\schema.ldif.#### where #### represents four digits, such as 6677 for 2.4.0. This step changes the line endings from UNIX to Windows format. Open the same file in Notepad. Add the following ldapSyntaxes definition verbatim, before the last blank line at the end of the file, leaving a blank line at the end of the file, and taking care not to add additional spaces at the end of the lines you add. If the result is not valid LDIF, your fix will fail. ldapSyntaxes: ( 1.3.6.1.4.1.26027.1.3.6 DESC ' Collective Conflict Behavior' X-ENUM ( 'real-overrides-virtual' ' virtual-overrides-real' 'merge-real-and-virtual' ) X-SCHEMA-FILE ' 00-core.ldif' ) This fixes a schema issue that prevents upgrades from earlier server versions. You can make the change while the server is running.

You can upgrade from the graphical installer, or from the command line. Login to a session where you can use a GUI as the user who owns the current OpenDJ server. Download OpenDJ, and unzip the downloaded file. Start the installer. (WebStart) http://www.forgerock.org/downloads/opendj//install/QuickSetup.jnlp (UNIX) Run OpenDJ-/setup. (Windows) Double-click OpenDJ-\setup.bat In the OpenDJ QuickSetup Welcome screen, select Upgrade Existing Server Instance, and make sure Server to Upgrade points to the current OpenDJ server before clicking Next. Follow the instructions in the QuickSetup wizard to complete the upgrade. If you upgraded from OpenDS 2.2, open the OpenDJ control panel, select Indexes > Rebuild Indexes..., and use the Rebuild Indexes dialog box to rebuild the dn2id index. Login as the user who owns the current OpenDJ server. Download the OpenDJ .zip file. $ cd /tmp $ wget http://www.forgerock.org/downloads/opendj//OpenDJ-.zip Change to the directory at the root of the server instance. $ cd /path/to/OpenDJ Pass the .zip file name to the upgrade command. $ ./upgrade -f /tmp/OpenDJ-.zip See /var/....log for a detailed log of this operation. Initializing Upgrade ..... Done. Calculating Schema Customizations ..... Done. Calculating Configuration Customizations ..... Done. Backing Up Files ..... Done. Upgrading Components ..... Done. Preparing Customizations ..... Done. Applying Schema Customizations ..... Done. Applying Configuration Customizations ..... Done. Verifying Upgrade ..... Done. Stopping Directory Server ..... Done. Cleaning Up ..... Done. Recording Upgrade History ..... Done. See /path/to/OpenDJ/history/log for a detailed installation history. QuickUpgrade Completed Successfully. The OpenDJ installation at /path/to/OpenDJ has now been upgraded to version OpenDJ (Build ID: buildId). See /var/....log for a detailed log of this operation. If you upgraded from OpenDS 2.2, use the rebuild-index command to rebuild the dn2id index for your suffixes. $ ./bin/rebuild-index -i dn2id -b "dc=example,dc=com" ...Rebuild complete. Processed 160 entries in 0 seconds (average rate 401.0/sec) Upgrade each server sequentially, as described above. Replace the gateweay web application with the newer version, as for a fresh installation.