Server Status/Management - Debian 8

Instructions for checking the status of IPLM Server in Debian installations.

Determining Installed Versions of IPLM Server

root@localhost# dpkg -l | grep -i mdx
ii mdx-piserver 3.0.0-20.12.22.14.07.12 all Installs the Perforce IPLM Server package on the appliance.

PiServer Status

Server status, stop and restart can be performed by running the standard 'systemctl' commands

root@localhost# systemctl status neo4j -l
● neo4j.service - MDX Pi server graph DB
   Loaded: loaded (/etc/systemd/system/neo4j.service; static)
   Active: active (running) since Mon 2020-12-28 23:59:51 PST; 2min 5s ago
  Process: 20097 ExecStart=/bin/bash -c [ -e $${JMX_AGENT} -a -e $${JMX_CFG} ] && export JAVA_MEMORY_OPTS='-javaagent:${JMX_AGENT}=2001:${JMX_CFG}'; JAVA_CMD=${javaexe} /usr/share/mdx/neo4j/current/bin/neo4j start (code=exited, status=0/SUCCESS)
  Process: 20095 ExecStartPre=/bin/sh -c /sbin/blkid > /dev/null (code=exited, status=0/SUCCESS)
  Process: 20092 ExecStartPre=/bin/systemd-tmpfiles --create neo4j.conf (code=exited, status=0/SUCCESS)
 Main PID: 20145 (java)
 CGroup: /system.slice/neo4j.service
         └─20145 /usr/bin/java -cp /usr/share/mdx/neo4j/current/plugins:/usr/share/mdx/neo4j/current/conf:/usr/share/mdx/neo4j/current/lib/*:/usr/share/mdx/neo4j/current/plugins/* -server -XX:+UseG1GC -XX:-OmitStackTraceInFastThrow -XX:+AlwaysPreTouch -XX:+UnlockExperimentalVMOptions -XX:+TrustFinalNonStaticFields -XX:+DisableExplicitGC -Djdk.tls.ephemeralDHKeySize=2048 -Djdk.tls.rejectClientInitiatedRenegotiation=true -Dunsupported.dbms.udc.source=tarball -Dfile.encoding=UTF-8 org.neo4j.server.CommunityEntryPoint --home-dir=/usr/share/mdx/neo4j/current --config-dir=/usr/share/mdx/neo4j/current/conf

Dec 28 23:59:51 pkg-test-debian8 bash[20097]: plugins: /usr/share/mdx/neo4j/current/plugins
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: import: /usr/share/mdx/neo4j/current/import
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: data: /var/lib/neo4j/data
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: certificates: /usr/share/mdx/neo4j/current/certificates
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: run: /var/run/neo4j
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: Starting Neo4j.
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: Started neo4j (pid 20145). It is available at http://localhost:7474/
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: There may be a short delay until the server is ready.
Dec 28 23:59:51 pkg-test-debian8 bash[20097]: See /var/log/neo4j/neo4j.log for current status.
Dec 28 23:59:51 pkg-test-debian8 systemd[1]: Started MDX Pi server graph DB.
root@localhost# systemctl status piserver -l
● piserver.service - Perforce IPLM Server
   Loaded: loaded (/etc/systemd/system/piserver.service; disabled)
   Active: active (running) since Mon 2020-12-28 23:59:56 PST; 2min 2s ago
  Process: 20183 ExecStartPre=/bin/systemd-tmpfiles --create piserver.conf (code=exited, status=0/SUCCESS)
 Main PID: 20184 (java)
 CGroup: /system.slice/piserver.service
         └─20184 java -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -Xverify:none -Djava.security.egd=file:/dev/urandom -jar /usr/share/mdx/products/piserver/target/piserver.jar server /etc/mdx/piserver.yml

Dec 28 23:59:56 pkg-test-debian8 systemd[1]: Started Perforce IPLM Server.
root@localhost#

Monitoring URL (basic)

Monitoring with curl
http://<host>:8080/v1/system/info
 
eg:
root@localhost# curl -s -o /dev/null -w '%{http_code}' http://localhost:8080/v1/system/info
200

Determine What mdx Packages are Available on the Server

root@localhost# apt-cache search mdx

Determine Where pi Configuration Files Live

root@localhost# dpkg -L mdx-piserver
/.
/usr
/usr/lib
/usr/lib/tmpfiles.d
/usr/lib/tmpfiles.d/piserver.conf
/usr/lib/tmpfiles.d/neo4j.conf
/usr/share
/usr/share/mdx
/usr/share/mdx/products
/usr/share/mdx/products/piserver
/usr/share/mdx/products/piserver/target
/usr/share/mdx/products/piserver/target/piserver.jar
/usr/share/mdx/products/piserver/bin
/usr/share/mdx/products/piserver/bin/piserverd
/usr/share/mdx/products/piserver/scripts
/usr/share/mdx/products/piserver/scripts/neo4j.service
/usr/share/mdx/products/piserver/scripts/mdx_gather.sh
/usr/share/mdx/products/piserver/scripts/piserver-config-migrate.sh
/usr/share/mdx/products/piserver/scripts/hook_script.py
/usr/share/mdx/products/piserver/scripts/install-neo4j.sh
/usr/share/mdx/products/piserver/scripts/config-neo4j.sh
/usr/share/mdx/java
/usr/share/mdx/java/jar
/usr/share/mdx/java/jar/mdx_plugins.jar
/etc
/etc/mdx
/etc/mdx/piserver.conf
/etc/mdx/auth
/etc/mdx/piserver.yml
/etc/systemd
/etc/systemd/system
/etc/systemd/system/piserver.service