Installation from a Distribution version 4.3+ (on Windows)

Installation of the Distribution

The installation of a distribution of OpenEMPI on Unix using the new release format is fairly straightforward. Note: Version of 4.3 of OpenEMPI or newer requires Java JDK 11. Make sure that the JAVA_HOME environment variable points to an installation of JDK 11. Keep in mind that with the new distribution format there is no need to install an instance of the Tomcat application server. An instance of the Tomcat server is included in the distribution and is configured nominally to operate properly with OpenEMPI.

1. Extract the contents of the distribution (.zip file) into the root of directory into the directory that will become the parent of the installation directory. We follow the convention that all distributions are stored under the d:\sysnet\openempi directory so, that version 4.3.0 would be in the d:\sysnet\openempi\openempi-4.3.0 directory and version 4.3.1 would be in the d:\sysnet\openempi\openempi-4.3.1 directory.

2. Configure the distribution based on the directory in which it was installed. You should use PowerShell and first change into the directory in which the distribution was extracted and run the post-install script. The post-install.sh script takes two parameters: the first is the directory in which the distribution was extracted (for example: d:\sysnet\openempi\openempi-4.3.0) and the second one is the version of the distribution that you are customizing (in this case it is 4.3.0).

3. Copy the license.txt file with the license key into the configuration directory of the instance which using the running example would be in directory: d:\sysnet\openempi\openempi-4.3.0\openempi-entity-4.3.0\conf.

4. You can now start the instance using the startup command.

You can stop the server using the shutdown command in a similar manner.

You are done with the installation and should now be able to access the administrative application by pointing your browser to: http://localhost:8080/openempi-manager (default account uses username: admin and password: admin).