Preliminary package installation

Overview

Perform the preliminary steps on each of the servers that IPLM products are being installed on.

Considerations

Java is not needed on a machine that is only running IPLM Web, IPLM Cache or the IPLM Client.

Step 1: Update the system

Update the host to the latest version of system packages using the following command:

Copy

1
sudo yum update

A number of operations use the curl command to test that a server is up and running. If this is not installed by default, install it using the following command:

Copy

1
sudo yum install curl

Step 2: Disable SELinux

IPLM software does not currently support SELinux. Disable SELinux while running IPLM software. If this is not done, then an error will be thrown when some packages are installed.

Copy

1
2
3
4
# Make sure SELINUX=disabled is configured
vi /etc/sysconfig/selinux 
# Reboot only if /etc/sysconfig/selinux is modified in the step above
reboot

Step 3: Set up IPLM repository

The RPM repository can be configured using the mdx-yum-repo package. This will configure the full repository to make it easier to install the other packages.

Copy

1
2
wget https://mdx.jfrog.io/mdx/mdx-generic/mdx-yum-repo-4.0.0-1.noarch.rpm
sudo rpm -ivh mdx-yum-repo-4.0.0-1.noarch.rpm

This installs keys and creates a /etc/yum.repos.d/mdx.repo file containing:

Copy

1
2
3
4
5
6
[mdx-production]
name=Methodics Yum Repo for production
baseurl=https://mdx.jfrog.io/mdx/yum/production/Pi/rhel/x86_64/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mdx

Step 4: Install Java

For IPLM Server, Neo4j, IPLM PiExtras, and PiAnon you will also need Java 11 installed. You can either use the JRE or JDK, though the JDK makes troubleshooting easier. IPLM has been tested against OpenJDK, though it should work with other variations of Java.

Copy

1
2
sudo rpm -q java-11-openjdk-headless || yum install java-11-openjdk-headless
java -version

Verify the java -version command returns version 11.

If java is not found, or shows the wrong version, you may need to ensure that the system is configured to use the correct version of java. Run the following command to use the correct version of Java:

Copy

1
update-alternatives --config java

Next steps

Once you have completed the preliminary steps, you can perform one of the following based on your deployment strategy:

Install and configure Neo4j directly (IPLM won't install Neo4j)
This path is recommended for installations of Neo4j that reside on a different server than IPLM Server.
Have IPLM install Neo4j
This path may be suitable for installations where Neo4j and IPLM Server reside on the same server.