Installation of a Distribution

Installation of a Distribution

The installation of a distribution of OpenEMPI using the new release format that has been available since version 3.4.0 is fairly straightforward. Before you perform the installation of the distribution you must first install the OpenJDK 8 release for your platform and install the Postgres database, following the detailed instructions found here. Make sure that the JAVA_HOME environment variable points to an installation of JDK 8. 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 into the directory that will become the parent of the installation directory. In the following example we install the distribution under the /sysnet/openempi directory and assume that the distribution file resides in the /tmp directory.

2. Configure the distribution based on the directory in which it was installed. You 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 (/sysnet/openempi/openempi-3.5.0 for the example shown here) and the second one is the version of the distribution that you are customizing (in this case it is 3.5.0).

3. The next step is to configure the database instance for the release. The release assumes that you are using the standard Postgres database and it is pre-configured for that database. If you are using an alternate database please follow the appropriate instructions.

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-admin (default account uses username: admin and password: admin).