IPLM Cache self-extracting archive

The IPLM Cache self extracting archive can be used in situations where .deb or rpm installations are not possible in the customer environment. Self extracting archives can be used across all OS distributions.

IPLM Cache Server Deployment with IPLM Cache Self-Extracting Package

1. IPLM Cache Self-Extracting archive install
1.1 Download self-extractable package from mdx package repo 
    wget https://mdx.jfrog.io/mdx/mdx-generic/Pi/server/production/mdx-picache-2024.1.0-24.06.06.08.22.14.run
1.2 add exec permission to the downloaded package
    chmod +x mdx-picache-2024.1.0-24.06.06.08.22.14.run.
1.3 Install package
1.3.1 As any user(user home dir should exist), run
    ./mdx-picache-2024.1.0-24.06.06.08.22.14.run.run --lib https://mdx.jfrog.io/mdx/mdx-generic/Pi/server/production/mdx-pichache-lib-1.2.0-20.01.10.15.54.49.tar.gz
1.3.2 press Enter to install at current location
1.4 The IPLM Cache software is installed under "mdx-picache-2024.1.0-24.06.06.08.22.14.run"2. Start IPLM Cache
2.1 change working directory to "mdx-picache-2024.1.0-24.06.06.08.22.14.run"    cd mdx-picache-2024.1.0-24.06.06.08.22.14.run
2.2 Start backend redis server
    ./bin/picache-backend-redis.sh start
2.3 Start backend MongoDB server
    ./bin/picache-backend-mongodb.sh start
2.4 Review/Update IPLM Cache settings in ./conf/picache.conf
2.3.1 "root" configuration option defines the location IPLM Cache will use to populate IPVs on disk, and needs to be defined. 
      The "root" directory path needs to be created before starting the IPLM Cache server.
2.3.2 Make sure current user has write permission to the "root" path.
2.3.3 "dm-program" needs to point to valid p4 executable
2.4 Start IPLM Cache daemons
    ./bin/picache.sh start
 
3. Check IPLM Cache status
   ./bin/picache.sh status

4. Stop IPLM Cache
4.1 Stop IPLM Cache daemons first
    ./bin/picache.sh stop
4.2 Stop backend MongoDB daemon
    ./bin/picache-backend-mongodb.sh stop
4.3 Stop backend Redis daemon
    ./bin/picache-backend-redis.sh stop

Offline Installation of IPLM Cache Packages

1. Download IPLM Cache server packages
 wget https://mdx.jfrog.io/mdx/mdx-generic/Pi/server/production/mdx-picache-2024.1.0-24.06.06.08.22.14.run
 wget https://mdx.jfrog.io/mdx/mdx-generic/Pi/server/production/mdx-pichache-lib-1.2.0-20.01.10.15.54.49.tar.gz
 wget https://mdx.jfrog.io/mdx/mdx-generic/redis/mdx-redis-bin-5.0.7.tgz
 wget https://mdx.jfrog.io/mdx/mdx-generic/mongodb/mongodb-linux-x86_64-3.2.20.tgz
 wget https://mdx.jfrog.io/mdx/mdx-generic/grafana/mdx-grafana-bin-6.3.5.tgz
 wget https://mdx.jfrog.io/mdx/mdx-generic/prometheus/mdx-prometheus-bin-2.9.2.tgz
 wget https://mdx.jfrog.io/mdx/mdx-generic/prometheus/mdx-node-exporter-bin-0.17.0.tgz
 wget https://mdx.jfrog.io/mdx/mdx-generic/prometheus/mdx-statsd-exporter-bin-0.11.2.tgz

2. add exec permission to the run package
 chmod +x mdx-picache-2024.1.0-24.06.06.08.22.14.run

3. Install packages
3.1 As any user(user home dir should exist), run
 ./mdx-picache-2024.1.0-24.06.06.08.22.14.run --lib mdx-pichache-lib-1.2.0-20.01.10.15.54.49.tar.gz -- \
                                           --mongodb mongodb-linux-x86_64-3.2.20.tgz \
                                           --redis mdx-redis-bin-5.0.7.tgz \
                                           --grafana mdx-grafana-bin-6.3.5.tgz \
                                           --prometheus mdx-prometheus-bin-2.9.2.tgz \
                                           --node-exporter mdx-node-exporter-bin-0.17.0.tgz \
                                           --statsd-exporter mdx-statsd-exporter-bin-0.11.2.tgz
3.2 press Enter to install at current location
3.3 The IPLM Cache software is installed under "mdx-picache-2024.1.0-24.06.06.08.22.14.run" 
4. Start IPLM Cache
4.1 change working directory to "mdx-picache-2024.1.0-24.06.06.08.22.14.run"    cd mdx-picache-2024.1.0-24.06.06.08.22.14.run
4.2 Start backend redis server
    ./bin/picache-backend-redis.sh start
4.3 Start backend MongoDB server
    ./bin/picache-backend-mongodb.sh start
4.4 Review/Update IPLM Cache settings in ./conf/picache.conf
4.4.1 "root" configuration option defines the location IPLM Cache will use to populate IPVs on disk, and needs to be defined. 
      The "root" directory path needs to be created before starting the IPLM Cache server.
4.4.2 Make sure current user has write permission to the "root" path.
4.4.3 "dm-program" needs to point to valid p4 executable
4.5 Start IPLM Cache daemons
    ./bin/picache.sh start
 
5. Check IPLM Cache status
   ./bin/picache.sh status
 
6. Stop IPLM Cache
6.1 Stop IPLM Cache daemons first
    ./bin/picache.sh stop
6.2 Stop backend MongoDB daemon
    ./bin/picache-backend-mongodb.sh stop
6.3 Stop backend Redis daemon
    ./bin/picache-backend-redis.sh stop
 

IPLM Cache Metrics

Refer to the Perforce IPLM Metrics page for use of IPLM Cache metrics for the self extracting archive.