Gateway Hub ["Geneos"]
["Geneos > Gateway Hub"]["User Guide"]

Software requirements

Overview

This page outlines the software requirements of a Gateway Hub node.

Operating Systems

The following Linux operating systems are supported with Gateway Hub:

Operating System Versions Supported
Red Hat (64-bit) 7.6, 7.7, 7.8, 7.9
CentOS (64-bit) 7.6, 7.7, 7.8, 7.9

Software requirements

Each node must have the following software and utilities installed prior to installing Gateway Hub:

Requirement Version
Java Runtime Environment 8 (java-1.8.0-openjdk, java-1.8.0-openjdk-headless)  
openssl  
Netcat (nc)  
Network Time Protocol (ntp)  
Python (libselinux-python) 3.6 or newer
redhat-lsb-core  
rpcbind  
syslinux  
PyYAML 5.3.1 or newer.

How to install the prerequisite software for Gateway Hub installation

If your server has internet access, you can use the following command to install the prerequisite software for Gateway Hub:

$ sudo yum install libselinux-python3 java-1.8.0-openjdk java-1.8.0-openjdk-headless rpcbind redhat-lsb-core syslinux nc openssl PyYAML ntp

System configuration

sysctl settings

You must add the following to the /etc/sysctl.conf file on each node:

vm.swappiness = 1
net.ipv4.tcp_retries2 = 5
vm.overcommit_memory = 0

Operating system settings

The following settings must be applied:

  • A unique hostname must be set.
  • The reported time must be accurate. Follow the operating system documentation to configure NTP or other time synchronization software as needed.
  • The Gateway Hub runtime user must exist.
  • The /opt/hub folder must exist and must be owned by the Gateway Hub runtime user.
  • The Gateway Hub ports must be open. For more information, see Connectivity requirements.
  • By default CentOS is configured with a user processes limit of 4096. You must not lower this limit, otherwise this may cause an error when installing Gateway Hub. You can check the current limit by using the ulimit -a or ulimit -u commands and set the limit using the ulimit -u command with a specified value.

Users

Typically a Gateway Hub installation is performed as the Gateway Hub runtime user, which must exist on all nodes.

You can alternatively use separate installation user by specifying installation > connection > user in your configuration file. If you are using a separate installation user, this must be on the sudoers list.