This is documentation for EA software. It may contain information that is out of date and subject to change. Last updated: 3 October 2018.

Gateway Hub Pre-Install Guide

Overview

This guide details the prerequisites required to install Gateway Hub.

For instructions on how to install the Gateway Hub, see Gateway Hub Installation Guide.

Prerequisites

Gateway Hub server prerequisites

Hardware Requirements

The following hardware specification is the recommended setup for a standard compute / storage node:

Component Recommended Setup
Server 2U Rack Server/Chassis
System board Dual CPU socket system board
CPU 2 x 8-core 64-bit CPU, 32 cores with hyper-threading enabled
Memory 8 x 8GB DIMMs, 64GB RAM (DIMM count must be multiple of CPU memory channels)
Disks 12 x 2TB SATA drives, unformatted with no partitions
Network 10GbE network interface

Caution: The minimum memory requirement is 32GB.

As a minimum, three disks or disk partitions are required on installation for the following components:

  • Operating System.
  • MapR. This disk/partition must be unformatted.
  • Kafka. This disk/partition must be formatted and available at installation. 128GB minimum size.

Operating Systems

The following operating systems are supported with Gateway Hub:

Operating System Versions Supported
Red Hat (64-bit) 7.2, 7.3, 7.4
CentOS (64-bit) 7.2, 7.3, 7.4

Users

Before installing Gateway Hub, two user accounts must be created on the target servers:

  • A Gateway Hub install user — this user must have administrator level privileges. This user must be on the sudoers list. You can use root, but it is not recommended. This user is specified by the --hub-install-user flag on install.
  • A Gateway Hub runtime user — this user does not require administration privileges. This user is specified by the --global-user flag on install.

Caution: These users must be the same on all nodes, and therefore must have the same UID and GID on all boxes. Care must be taken if creating users on each node manually.

Certificates

You are responsible for the generation of SSL security certificates and their addition to the target servers.

Additional software requirements

Each server must have the following additional software and utilities installed:

Requirement Purpose
createrepo  
Extra Packages for Enterprise Linux (epel-release)  
hdparm MapR prerequisite
Java Development Kit 8 (java-1.8.0-openjdk, java-1.8.0-openjdk-devel, java-1.8.0-openjdk-headless) MapR prerequisite
Netcat (nc)  
Network Time Protocol (ntp)  
Python (libselinux-python) Ansible prerequisite
redhat-lsb-core  
rpcbind  
sdparm MapR prerequisite
syslinux  
sysctl  

See How to install prerequisite software for Gateway Hub installation for command line instructions.

Ports

Each server must have the following ports externally accessible:

Port Service Purpose
22 SSH Secure Shell, for Ansible install and troubleshooting.
8080 Gateway Hub REST API Gateway Hub REST API.
8443 MapR Monitoring Console MapR monitoring web UI.
9092 Gateway Hub message bus Receives Gateway data.

Additionally, each Gateway Hub node must have unrestricted access to all other Gateway Hub nodes in the cluster.

Installation machine prerequisites

Before installing Gateway Hub on a server, you must have a separate machine set up to perform the installation.

This machine must have access to the following URLs to contact the MapR licence server:

  • https://mapr-ext.okta.com/api/v1/authn
  • https://mapr-ext.okta.com/login/sessionCookieRedirect
  • https://mapr-ext.okta.com/api/v1/sessions/me
  • https://mapr.com/account/ls/clusters/

Operating Systems

The installation machine must be one of the following operating systems:

  • Linux
  • MacOS X
  • Windows Subsystem for Linux

Additional software requirements

The installation machine must have the following additional software installed:

  • Ansible 2.6.0
  • jq 1.5
  • Netcat (nc)

Ensure these are available in your PATH.

Security files

A credentials file (.vault_pass.txt) is required to get a MapR license during installation.

Obtain this by requesting them from your ITRS account manager or technical representative.

Do the following with the file:

  1. Place .vault_pass.txt in the user home directory (~).
  2. Modify the read and write permissions the file using chmod 600:
    $ chmod 600 ~/.vault_pass.txt

Pre-install procedures

How to install prerequisite software for Gateway Hub installation

If your target machine has internet access, you can use the following commands to install the prerequisite software for Gateway Hub for your operating system:

  • For CentOS, use the following command:
    $ sudo yum install epel-release createrepo libselinux-python java-1.8.0-openjdk java-1.8.0-openjdk-devel java-1.8.0-openjdk-headless rpcbind ntp sysctl sdparm redhat-lsb-core syslinux hdparm nc
  • For Red Hat Enterprise Linux (RHEL), use the following commands:
    $ sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    $ sudo yum install createrepo libselinux-python java-1.8.0-openjdk java-1.8.0-openjdk-devel java-1.8.0-openjdk-headless rpcbind ntp sysctl sdparm redhat-lsb-core syslinux hdparm nc

How to verify your server specifications

You can verify your hardware specifications using the scripts provided by MapR at https://github.com/MapRPS/cluster-validation.

Please follow the instructions provided to validate your setup.

Next steps

After fulfilling the prerequisites and validating your sever specifications, see Gateway Hub Installation Guide for how to install the Gateway Hub.