Perforce IPLM High Availability with HAProxy and Neo4j cluster: Installation

Install Neo4j package signing key.

rpm --import https://debian.neo4j.com/neotechnology.gpg.key

Configure yum repo. Create file /etc/yum.repos.d/neo4j.repo with following content

[neo4j]
name=Neo4j Yum Repo
baseurl=http://yum.neo4j.com/stable
enabled=1
gpgcheck=1

Install Neo4j Enterprise 3.5.3

yum install neo4j-enterprise-3.5.3

Install IPLM Server plugin. See Verify correct IPLM Server plugin version for additional information.

wget https://mdx.jfrog.io/mdx/mdx-generic/mdx-yum-repo-4.0.0-1.noarch.rpm
rpm -ivh mdx-yum-repo-4.0.0-1.noarch.rpm
yum install mdx-piserver-neo4j-plugin

RHEL6/CentOS6 doesn’t provide all the dependencies that neo4j-enterprise package needs. Since Perforce IPLM server doesn’t require the component that breaks neo4j-enterprise package installation, the neo4j-enterprise rpm package can be installed with --nodeps option.

yum install dialog
wget https://yum.neo4j.com/stable/neo4j-enterprise-3.5.3-1.noarch.rpm
rpm -ivh --nodeps neo4j-enterprise-3.5.3-1.noarch.rpm

Install IPLM Server plugin. See Verify correct IPLM Server plugin version for additional information.

wget https://mdx.jfrog.io/mdx/mdx-generic/mdx-yum-repo-4.0.0-1.noarch.rpm
rpm -ivh mdx-yum-repo-4.0.0-1.noarch.rpm
yum install mdx-piserver-neo4j-plugin

Install Neo4j Enterprise 3.5.3

wget -O - https://debian.neo4j.com/neotechnology.gpg.key | apt-key add -
echo 'deb https://debian.neo4j.com stable 3.5' > /etc/apt/sources.list.d/neo4j.list
apt-get update
apt-get install neo4j-enterprise=1:3.5.3

Install IPLM Server plugin. See Verify correct IPLM Server plugin version for additional information.

wget -O - https://mdx.jfrog.io/mdx/mdx-generic/mdx@methodics.com.gpg.key | apt-key add -
echo "deb https://mdx.jfrog.io/mdx/debian/ jessie production" > /etc/apt/sources.list.d/mdx.list
apt-get update
apt-get install mdx-piserver-neo4j-plugin

1. Download neo4j-enterprise-3.5.3-unix.tar.gz from https://neo4j.com/download-center/

2. Follow steps on IPLM Server +Self-Extracting+Archive and use the option “--neo4j <neo4j-enterprise-3.5.3-unix.tar.gz location>” when installing the run file

3. Copy neo4j-enterprise-3.5.3 folder to target location

4. Update dbms.directories.logs and dbms.directories.run in neo4j-enterprise-3.5.3/conf/neo4j.conf and make sure they point to the correct path in target location

Package mdx-piserver-neo4j-plugin is not available for 2.34.x Pi releases. After installing neo4j-enterprise software on each Neo4j nodes, follow the manual steps below to install additional files.

1. Manually copy usr/share/mdx/java/jar/mdx_plugins.jar from the existing installation of IPLM Server to each node in the Neo4j cluster. The destination folder in Neo4j cluster node is /var/lib/neo4j/plugins.

Note:   Make sure that only one mdx_plugins.jar file exists in the plugins directory.

2. On each Neo4j cluster node, update /etc/neo4j/neo4j.conf and add line below at the end of the file.
    dbms.unmanaged_extension_classes=com.methodics.pi.application.rest.neo4j=/pi
3. Manually copy over /etc/mdx/auth from existing install of IPLM Server to each node in the Neo4j cluster. The destination folder in Neo4j cluster node is /var/lib/neo4j/data/dbms/.
4. On each Neo4j cluster node, update /etc/neo4j/neo4j.conf and add line below at the end of the file.
    dbms.security.auth_enabled=true
   

The Neo4j service file also needs to be updated.

• On RHEL6, add the line "/sbin/blkid" in file /etc/default/neo4j.
  
•  On RHEL7/Debian8, please open a root shell and copy-paste the below script snippet onto the terminal,
  neo4j_service=/lib/systemd/system/neo4j.service
  sed -e '/^ExecStart=/ i\ExecStartPre=/bin/bash -c "blkid > /dev/null"' -i "$neo4j_service"
  sed -e '/^ExecStartPre=/ i\PermissionsStartOnly=true' -i "$neo4j_service"
  systemctl daemon-reload