RHEL installation prerequisites

Set up hosts for the ThoughtSpot cluster

Set up hosts for the ThoughtSpot cluster on your chosen platform. Please refer to the relevant deployment sections in our documentation for the exact specification for the hosts: CPU, memory, and disks.

Partition the hosts

Ensure that all ThoughtSpot hosts have the following partitions on the root drive.

Note that the size of the root drive on appliances is limited to 200GB; the partition requirements are therefore somewhat different when compared to the other environments.

Platform Partition Drive type Description Minimum size

Hosts in AWS, GCP, Azure, and VMWare

OS partition

SSD (root drive)

Root partition for OS, /tmp

100GB Allocate at least 50GB to /tmp

Export partition

SSD (root drive)

Stores ThoughtSpot objects, hdfs logs, service logs, and so on

200GB

Hosts on ThoughtSpot-certified hardware appliances

OS partition

SSD (root drive)

Root partition for OS, /tmp

80GB Allocate at least 50GB to /tmp

Export partition

SSD (root drive)

Stores ThoughtSpot objects, hdfs logs, service logs, and so on

service logs, and so on 100GB

Install RHEL on hosts

ThoughtSpot is certified with RHEL versions 7.7 and 7.8; we do not support other versions of RHEL, including 8 and 8.1. Install RHEL version 7.7 or 7.8, and ensure that your linux kernel version is 3.10.0-1127.19.1.

Linux kernel version

Your Linux kernel must be on version 3.10.0-1127.19.1. RHEL 7.7 and 7.8 used to come with a Linux kernel of version 3.10.x, which has a bug that causes nodes to reboot unexpectedly. The default Linux kernel version for RHEL 7.7 and 7.8 is now 3.10.0-1127.19.1. However, you may have an older RHEL 7.7 or 7.8, with a Linux kernel of version 3.10.x. You must upgrade to 3.10.0-1127.19.1. If you have trouble upgrading your Linux kernel to version 3.10.0-1127.19.1, contact ThoughtSpot Support. This is a requirement for all platforms: appliance, cloud, and VMware.

If Linux kernel version is not 3.10.0-1127.19.1, you may run into unexpected node reboots and possible loss of data.

Enable the hosts to download RHEL packages

Repositories

  • Yum repositories: you must enable the following Yum repositories in your cluster: epel, nux-desktop, pgdg95, rhel, rhel-optional, rhel-extras.

  • Python repository: for Python, ensure the machine is able to reach the PyPI repository located at https://pypi.python.org/.

Make sure that you can download RHEL packages to all hosts, either from the official package repositories, or from a mirror repository owned and managed by your organization.

If you cannot access the RHEL repositories, there is no mirror repository in your organization, or you are unable to access Yum, Python, or R repositories, please contact ThoughtSpot Support.

Official package repositories

If the hosts of your ThoughtSpot cluster can access external repositories, either directly or through a proxy, your cluster is online. You can then proceed to download Yum, Python, and R package repositories.

Internal mirror repository

If the hosts of your ThoughtSpot cluster have access to an internal repository that mirrors the public repositories, copy the Yum, Python, and R package repositories to your hosts.

Enable an Ansible Control Server

Configure an Ansible Control Server, on a separate host, to run the Ansible playbook that ThoughtSpot supplies. You must install both rsync and Ansible on the Ansible Control Server host.

Disable SELinux or run it in permissive mode

ThoughtSpot does not support policies that enforce SELinux. We recommend that you disable SELinux, or run it in permissive mode.

Ensure tmp has permission 777

The /tmp directory must have the 777 permission. If you mount the /tmp directory as a separate partition, it must NOT have the noexec flag set.

Ensure /proc mount point flags are compatible

You cannot mount the /proc mount point with the hidepid flag. You must mount it without that flag.

Remove Defaults requiretty from /etc/sudoers

The /etc/sudoers file must not have the Defaults requiretty line. This line can cause cluster creation to fail.