Preparing the Migration

These steps are necessary to prepare the migration. Depending on the features you used, you need to perform the steps described in the next chapters.

Preserving Files

If you changed default parameters in files, back up these files. Examples of these changes are:

  • idmsvc.ini - you increased, for example, memory requirements (IdS-J server)

  • dxi.cfg - you made customizations according to the user documentation

  • runserver.bat or runserver.sh - you increased, for example, memory requirements

  • dxmmsssvr.ini - you used different port parameters, passwords or a certdb file path

  • domain.xml - you set a different search timeout limit than the default

  • bindcredentials.xml - you set your own timeout limits

  • password.properties - you provided PIN values for encryption or signature (IdS-J server) or SSL keystore password.The file is written anew by the Configuration Wizard, which asks you to set your PIN values.

  • gen*Keystores.bat/sh - scripts to generate keys; check for changed parameters

  • set_Environment.bat/sh - scripts to generate certificates and keys; check for changed parameters

  • web.xml - you changed parameters like SSL or debug

  • cacerts - you set up certificates for SSL in this file in the Java JRE folder dxi_java_home/lib/security. When creating the cacerts backup, ensure that your backup is outside dxi_java_home.

Custom Libraries

If you used custom libraries (JAR files) in your previous installation, back up these files. Since 9.0.0, you can use the Custom Libraries feature to preserve these files.

The installation and configuration process removes old JAR files from previous installations, and even though it tries to do that only to the non-custom files, it is safer to back up your custom JAR files.