Before You Upgrade
Fulfill these requirements before upgrading Directory Services software, especially before upgrading the software in a production environment. Also refer to the requirements listed in Requirements.
Supported Java
DS software supports the following Java environments:
| Vendor | Versions |
|---|---|
| OpenJDK, including OpenJDK-based distributions:
ForgeRock tests most extensively with AdoptOpenJDK/Eclipse Adoptium. ForgeRock recommends using the HotSpot JVM. | 11 |
| Oracle Java | 11 |
DS requires Java 11.0.6 or later. Earlier Java 11 updates lack required cryptography fixes.
If the server uses an older version that is no longer supported, install a newer Java version before upgrading. To enable the server to use the newer Java version, edit the default.java-home setting in the opendj/config/java.properties file.
Required Credentials
Perform the upgrade procedure as the user who owns the server files.
Make sure you have the credentials to run commands as this user.
Back Up First
Before upgrading, perform a full file system backup of the current server so that you can revert on failure.
The backup format is not compatible between versions. Make sure you stop the directory server and back up the file system directory where the current server is installed.
Disable Windows Service
If you are upgrading a server registered as a Windows service, disable the Windows service before upgrade:
C:\path\to\opendj\bat> windows-service.bat --disableServiceAfter upgrade, enable the server as a Windows service again.