Upgrade an instance of a previous version

Edit online

To convert an existing instance of an earlier supported version of IBM® Security Directory Server to a functional instance of the latest version and to continue with the existing configuration files, you must upgrade an instance.

The upgrade process preserves changes to the schema definitions, changes to configuration files, and the data of a directory server instance.

Upgrading an instance from a previous version requires you to complete the following process:

  1. Complete the installation of IBM Security Directory Server.
  2. Upgrade an existing instance from a previous version.

IBM Security Directory Server, version 6.4 server and client can coexist with servers and clients of versions 6.0, 6.1, 6.2, 6.3, and 6.3.1.

You can directly upgrade directory server instances of IBM Security Directory Server, Versions 6.3 and 6.3.1 to Version 6.4.

Important: Direct upgrade of IBM Security Directory Server, Version 6.1 and 6.2 instances to IBM Security Directory Server, version 6.4 is not supported. You must upgrade Version 6.1 or 6.2 instances to Versions 6.3 or 6.3.1, and then to Version 6.4.

You can upgrade an instance of a previous version in the following ways:

  • Upgrade an existing instance on a local computer with IBM Security Directory Server Instance Administration Tool (idsxinst) or the idsimigr command. You must not remove the directory server instance that you want to upgrade. For a full directory server instance, do not unconfigure the database. Upgrade is not supported if the directory server instance is removed or its database is unconfigured.
  • Upgrade an instance on a remote computer with the migbkup and idsimigr commands. For more information, see Upgrading a remote instance of a previous version with the idsimigr command.
Attention: You must back up the schema, configuration files, and database of an instance to recover from any upgrade failures.

DB2 database upgrade

When you upgrade an instance, its associated DB2® database is also upgraded if the DB2 version is lower than the version supported by IBM Security Directory Server, version 6.4. The idsdbmigr command is run internally to upgrade the DB2 database.
Important: Direct upgrade of a directory server instance that is configured with DB2, Version 9.1 or 9.5 to an instance with DB2, Version 11.5.7.0 is not supported. You must upgrade an instance that is configured with DB2, Version 9.1 or 9.5 to an instance with DB2, Version 9.7, and then to an instance with DB2, Version 11.5.7.0.

Client installation upgrade

If you installed client-only features with IBM Security Directory Server client installer, you do not require to upgrade. Clients from version 6.0, 6.1, 6.2, 6.3, and 6.3.1 can coexist with the 6.4 server and client.