Preparing the Jama Application Server, Jama Connect® Self-Hosted Airgap Version 8.79

Dana Medhaug
Dana Medhaug
  • Updated

Author: Dana Medhaug

Date: September 5, 2023

Audience: Everyone

Environmental details:

Jama Connect® Self-Hosted

Airgap Version 8.79 

Replicated Native

Summary: This article is for customers preparing/replacing the Jama Application Server


Note: Installation will fail if the sysctl.conf file is not updated.

  • Edit the /etc/sysctl.conf file and add the variable below, save the file
  • Stop the docker service
    sudo systemctl stop docker
  • Reload the sysctl.conf file
    sysctl -p
  • To confirm, type this command 
    sudo sysctl -a | grep max_map_count
  • Start the docker service 
    sudo systemctl start docker

Preparing the Server:

1. Start with a new 200 GB disk (minimum)


2. Create a mount point:

mkdir /data /logs /var/lib/docker /var/lib/replicated


3. Create Physical Volume:

pvcreate /dev/sdb (sdb is an example here; this would be the name of your disk)


4. Create Volume Group:

vgcreate vg_jama /dev/sdb


5. Create Logical Volumes:

lvcreate -L 40G -n lv_docker vg_jama

lvcreate -L 30G -n lv_replicated vg_jama

lvcreate -L 20G -n lv_logs vg_jama

lvcreate -l 100%FREE -n lv_data vg_jama


6. Write File systems:

mkfs.xfs -L docker -n ftype=1 /dev/vg_jama/lv_docker

mkfs.ext4 -L replicated /dev/vg_jama/lv_replicated

mkfs.ext4 -L data /dev/vg_jama/lv_data

mkfs.ext4 -L logs /dev/vg_jama/lv_logs


7. Edit /etc/fstab:

LABEL=docker                /var/lib/docker          xfs          defaults        0 0

LABEL=replicated         /var/lib/replicated     ext4       defaults        0 0

LABEL=data                  /data                              ext4       defaults        0 0

LABEL=logs                  /logs                                ext4       defaults        0 0


8. Mount all volumes:

mount -a


Preparing for airgap Installation:

9. Download Docker and Replicated and move the files to the app server under /data/install:


If Using Docker Enterprise:
Follow the installation instructions in the Mirantis Container Runtime (MCR) Deployment Guide:


Docker (no enterprise):

docker-ce 20.10.7 is the version needed 

Centos and Red Hat




Ubuntu systems




Installation instructions:

Place replicated, docker, .rli license file and the Jama .airgap files in the install directory (/data/install)

  1. Install Replicated
    • Unpack the tarball in /data/install
      • tar xzvf replicated.tar.gz
    • Install docker using dpkg -i file.deb for ubuntu or rpm -ivh file.rmp for RHEL
    • Run Install script
      • Execute the install script in /data/install
        • cat | sudo bash -s airgap
      • Answer the questions presented during the command-line installation
      • Navigate to the replicated admin console at port 8800 and begin the admin console setup.

Once you have entered all the settings in the replicated admin console and you are ready to save and restart, you can tail the contour log with the command below:

tail -F /logs/tomcat/contour/contour.log


Related Articles, Work orders, Zendesk tickets, Defects, etc. 

Additional Information/Metadata:

  • Jama Connect® Self-Hosted
  • Airgap Version 8.79
  • Replicated Native

Related to

Was this article helpful?

0 out of 1 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.