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

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

  vm.max_map_count=262144

• 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 Mountpoint:

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:

Docker:
https://community.replicated.com/t/installing-docker-in-airgapped-environments/81

If Using Docker Enterprise:
Follow the installation instructions in the Mirantis Container Runtime (MCR) Deployment Guide: https://docs.mirantis.com/mcr/20.10/install.html

Replicated:

https://s3.amazonaws.com/replicated-airgap-work/stable/replicated-2.53.2%2B2.53.2%2B2.53.2.tar.gz

Docker (no enterprise):

docker-ce 20.10.7 is the version needed 

Centos and Red Hat 

containerd.io

docker-ce-cli

docker-ce

selinux

Ubuntu systems

containerd.io

docker-ce

docker-ce-cli

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 install.sh | 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. 

• Resource sizing for application server (traditional)

Additional Information/Metadata:

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