Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following instructions explain how to upgrade an instance of OpenEMPI from a 4.2.x release to the 4.3.y release.

...

3. Install the 4.3.y instance in its new OPENEMPI_HOME directory. Follow the installation instructions for installing a new instance of OpenEMPI from a distribution that can be found here. The recommended approach is to install new releases under the same parent directory so that openempi-4.3.x and openempi-4.3.y are in the same directory. On our installations, we follow the convention of installing new releases in the /sysnet/openempi directory so that the 4.2.x release would be installed in the /sysnet/openempi/openempi-4.2.x directory and the 4.3.y release would be installed in the /sysnet/openempi/openempi-4.3.y directory.

...

Code Block
openempi-entity-4.2.y/conf/file-loader-map-*.xml

NOTES: Please read and understand the information in these notes.

  • We use the convention of naming file loader mapping files file-loader-map-{VARIABLE].xml where VARIABLE is a unique name that identifies the specific mapping file. You only need to copy mapping files that are unique to your installation.

  • Starting with the 4.3.0 release of OpenEMPI the Postgres relational database is no longer used so as part of this upgrade the next few steps will migrate the data from the relational database into the embedded graph database and specifically in the configuration database instance (openempiConfig-db).

  • Make sure you delete old or unneeded audit log and identifier update notifications before performing the migration otherwise the migration process may take too long or fail to complete. Some sites don’t delete old entries and they may have accumulated millions of records. You can do that using the appropriate scheduled task or you can open a ticket in the customer support forum and we can help you with that.

  • The installation of 4.3.x creates an initial configuration database instance openempiConfig-db but if you are migrating from a 4.2.x version, you should replace the openempiConfig-db created by the installation with a copy of the openempiConfig-db from the data directory of your 4.2.x instance. If you are using the shared data directory as suggested in step 3, you can ignore this step since the new configuration database instance is created in the data sub-directory of the 4.3.x installation directory but make sure you have modified the data directory in the setenv.sh file before beginning the migration process as described in step 6.

...