Prerequisites
This guide assumes you have a running RHEL server with access to the Red Hat repositories (repos). VisibleThread Docs .rpm has some dependencies (including httpd, openssl, java) that are available in the Red Hat repos. These dependencies will be installed by our .rpm file; as such we require that the Red Hat Software Collections (RHSCL) repository be enabled.

Note: VT Docs will create a user called 'visiblethread' upon installation; do not create a 'visiblethread' user before installing!

Minimum Server Spec

4GB RAM
2 CPU Cores
80GB disk

Note: VisibleThread Docs requires port 443 and port 22.
VisibleThread Docs requires 'sudo su' permission to install correctly.

Note: Deployments have been tested on RHEL versions 7.2 - 7.9
Deployments have been tested on VMware ESX Vsphere/vcenter, Hyper-V, Azure, AWS

Step 1: Enable the RHSCL Repository

Repositories

The Red Hat repos are typically made available via two methods:
⦁ an active Red Hat subscription – typically used when RHEL runs on-prem, OR
⦁ Red Hat Update Infrastructure (RHUI) – available with cloud providers (e.g. Azure and AWS) to mirror Red Hat-hosted repos and automatically make them available to official RHEL cloud VMs.

The RHSCL repository is named differently depending on how you access repos. Below are the common commands to enable the RHSCL repo in different environments run:

sudo subscription-manager repos --enable rhel-server-rhscl-7-rpms

(may need to run the following command to update the Amazon Red Hat Update Infrastructure Client:
sudo yum update rh-amazon-rhui-client)

sudo yum-config-manager --enable rhel-server-rhui-rhscl-7-rpms

sudo yum-config-manager --enable rhui-rhel-server-rhui-rhscl-7-rpms

To verify that the above command worked:

1. run sudo yum repolist

2. look for an entry like “Red Hat … RHSCL” or “Red Hat Software Collections…”

Step 2: PostgreSQL Install

PostgreSQL Database is mandatory. Although the rpm doesn’t depend on it, PostgreSQL is required. We support PostgreSQL versions 10 - 13 and recommend using a version minimum of 12. Here is an example install of PostgreSQL 12 using the above RHSCL repo:

Install PostgreSQL 12
sudo yum install -y rh-postgresql12 rh-postgresql12-syspaths

Enter Postgresql bash shell and initialize the DB:
sudo su - postgres
/usr/bin/postgresql-setup initdb

Exit the Postgresql bash shell:
exit

Enable and start Postgresql service:
sudo systemctl enable --now postgresql

Verify service is active:
systemctl status postgresql

Step 3: VT Docs Download/Install

Now that you verified that PostgreSQL is running you can download and install the VT Docs rpm file.

The VT Docs .rpm is available to download here:

https://visiblethread.s3.amazonaws.com/public/download/visiblethread-docs-5.0.2-1.x86_64.rpm 

 
To verify that the download was completed successfully you can check the md5 hash :
(MD5 Hash: 6777086f75fd2d1fac7a4ba83f0765e1)

To install the RPM just run the following command;

sudo yum install -y visiblethread-docs-5.0.2-1.x86_64.rpm

Step 4: Check if fapolicyd is installed

If fapolicy is installed it will block Apache Tomcat from being installed correctly, because of this you should whitelist the required directory in your fapolicy, see below.

• Check if fapolicyd is installed

  sudo systemctl status fapolicy

• If fapolicyd is NOT installed please ignore this section. If faploicy is installed please run the below command to whitelist the install directory for Apache Tomcat.
  

  # as root user
  echo "allow perm=any uid=visiblethread : dir=/opt/visiblethread/tomcat/" >> /etc/fapolicyd/rules.d/01-visiblethread.rules
  
  fapolicyd-cli --update
  
  systemctl restart fapolicyd
  
  sudo systemctl restart visiblethread-docs.service

To upload your license and setup users please follow the link and start from Section 2:
https://support.visiblethread.com/hc/en-us/articles/214225446-Deploying-VisibleThread-On-Premise-behind-your-corporate-firewall