/
Installation from a Distribution version 4.4+ (on Unix)

Installation from a Distribution version 4.4+ (on Unix)

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.4 of OpenEMPI or newer requires Java JDK 21. Make sure that the JAVA_HOME environment variable points to an installation of JDK 21. 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 root of directory 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. The following steps should be executed as the user “openempi”.

mkdir /sysnet/openempi cd /sysnet/openempi tar xf /tmp/openempi-entity-4.4.0-l-release.tar.gz

  1. 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-4.4.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 4.4.0).

cd /sysnet/openempi/openempi-4.4.0 ./post-install.sh /sysnet/openempi/openempi-4.4.0 4.4.0

  1. Copy the license.txt file to the configuration directory.

cp license.txt /sysnet/openempi/openempi-4.4.0/openempi-entity-4.4.0/conf

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

cd /sysnet/openempi/openempi-4.4.0 bin/startup.sh

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

cd /sysnet/openempi/openempi-4.4.0 bin/shutdown.sh

It is recommended that you configure your instance to run as a service. A default service configuration file is available in the distribution at /sysnet/openempi/openempi-4.4.0/openempi-entity-4.4.0/conf/openempi.service but you may have to customize the service file based on where your instance of OpenEMPI has been installed and where the Java JDK is installed.

sudo cp openempi.service /etc/systemd/system sudo systemctl daemon-reload # Enable the OpenEMPI service sudo systemctl enable openempi.service # Start the OpenEMPI service sudo systemctl start openempi.service # Stop the OpenEMPI service sudo systemctl stop openempi.service

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).