Neo4j 3.3.1 Upgrade

Neo4j 3.1.0 was used by IPLM Server prior to the 2.17 release. For IPLM Server 2.17 and later the recommended Neo4j version is 3.3.1.

Upgrading Neo4j on CentOS, RHEL6/7, SLES

1. Before upgrading to Neo4j 3.3.1, stop IPLM Server and Neo4j server
service piserver stop
 
Note: it's critical to properly shut down Neo4j and IPLM Server before DB upgrade.
Make sure there are no error/warning messages from "service piserver status" 
2. Backup existing Neo4j DB
cp -a /var/lib/mdx-neo4j/data /var/lib/mdx-neo4j/data.backup
 
3. Update mdx-piserver-tools package (if not updated already)
yum update mdx-piserver-tools
 
4. Update Neo4j to 3.3.1
/usr/share/mdx/products/piserver/bin/install-rpm-deps.sh
 
5. Re-configure Neo4j for PiServer and enable Neo4j upgrade
/usr/share/mdx/products/piserver/bin/config-neo4j.sh upgrade
 
6. Start IPLM Server
service piserver start
 
7. After verifying the new DB is working properly, stop Neo4j and PiServer
service piserver stop
 
Note: it's critical to properly shut down Neo4j and PiServer after DB upgrade.
Make sure there are no error/warning messages from "service piserver status" 
8. Disable Neo4j upgrade option
/usr/share/mdx/products/piserver/bin/config-neo4j.sh un-upgrade
 
9. Restart IPLM Server and make sure they can restart properly
service piserver start
 
Note: If Neo4j/PiServer fails to restart, please contact Perforce support

Upgrading Neo4j on Debian

1. Before upgrading to Neo4j 3.3.1, stop IPLM Server and Neo4j server
service piserver stop
service neo4j stop
 
Note: it's critical to properly shut down Neo4j and IPLM Server before DB upgrade. 
Make sure there are no error/warning messages from "service neo4j status" and "service piserver status"2. Backup exiting Neo4j DB 
cp -a /var/lib/neo4j/data /var/lib/neo4j/data.backup
 
3. Update mdx-piserver-tools package (if not updated already)
apt-get install mdx-piserver-tools
  
4. Update Neo4j to 3.3.1
/usr/share/mdx/products/piserver/bin/install-deps.sh
  
5. Re-configure Neo4j for IPLM Server
/usr/share/mdx/products/piserver/bin/config-neo4j.sh install
  
6. Enable Neo4j DB upgrade
echo "dbms.allow_upgrade=true" >> /usr/share/mdx/neo4j/current/conf/neo4j.conf
 
7. Start Neo4j server and IPLM Server
service neo4j start && service piserver start
  
8. After verifying the new DB is working properly, stop Neo4j and IPLM Server
service neo4j stop
service piserver stop
  
Note: it's critical to properly shut down Neo4j and IPLM Server after DB upgrade. 
Make sure there are no error/warning messages from "service neo4j status" and "service piserver status" 
9. Disable Neo4j upgrade option
sed -i -e 's/^dbms.allow_upgrade=true.*/dbms.allow_upgrade=false/g' \
/usr/share/mdx/neo4j/current/conf/neo4j.conf
 
10. Restart Neo4j and IPLM Server and make sure they can restart properly
service neo4j start
service piserver start
 
Note: If Neo4j/IPLM Server  fails to restart, please contact Perforce support