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

Dana Medhaug
Dana Medhaug
  • Updated

Author: Dana Medhaug

Updated: January 2025

Updated: September 2024

Audience: Everyone

Environmental details: Jama Connect® Self-Hosted, Replicated - Native, Airgap Version 8.79 

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

Docker

If Using Docker Enterprise, follow the installation instructions in the Mirantis Container Runtime (MCR)

Replicated

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)

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

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

Comments

0 comments

Article is closed for comments.