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
Ubuntu systems
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.
- Execute the install script in /data/install
- Unpack the tarball in /data/install
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
Comments
0 comments
Article is closed for comments.