Leostream provides a Leostream Gateway package that can be installed on any virtual or physical machine running the latest 64-bit CentOS 7.x or Red Hat Enterprise Linux 7.x operating system. The following sections describe how to install and update the Leostream Gateway. You must apply security or upgrade patches to the underlying operating system, separately.

The Leostream Gateway does not install on CentOS 8 or Red Hat Enterprise Linux version 8.

You do not need to apply a license to the Leostream Gateway, itself. Your Leostream Connection Broker license key must include Leostream Gateway support in order to register your Leostream Gateway with your Connection Broker.

Sizing the Leostream Gateway

The number of connections that can be handled by one Leostream Gateway is determined by the CPU available in the machine and the bandwidth of the network.

When using the Leostream HTML5 viewer, the Leostream Gateway utilizes CPU to translate the RDP, VNC, or SSH screens to HTML5. Therefore, if using the built-in Leostream HTML5 viewer, provision the machine that will host your Leostream Gateway with as much CPU as you can. Machines with higher CPU support more simultaneous connections.

For port-forwarded desktop connections, including third-party HTML5 viewers, the Leostream Gateway performs Linux kernel-based port forwarding, which places very little CPU load on the machine running the gateway. In this case, the limiting factor for the number of simultaneous connections that can be handled by a single Leostream Gateway is the bandwidth of the network. To maximize the number of simultaneous connections that can be handled by your Leostream Gateway, ensure that your network has sufficient bandwidth.

At a minimum, Leostream recommends the following for each Leostream Gateway:

  • 2 or more CPUs or vCPUs at 2.5 GHz or higher

  • 4 GB of RAM, more if using the built-in Leostream HTML5 viewer

  • 4 GB of swap space

  • 20 GB of free disk

Regardless of the size of the machine, Leostream recommends a maximum of 100 simultaneous connections. To handle larger environments, install multiple Leostream Gateways and use a load balancer to distribute user connections between the gateways.

You can view the CPU being used by the Leostream Gateway while connections are being established by monitoring the output of the following command on the gateway.

top -d -1

Installing from the Leostream Repository

After building and updating your base operating system, run the following command to install your Leostream Gateway.

curl http://downloads.leostream.com/gateway.sh | bash

The installation script downloads and installs any dependencies required by the gateway.


Performing a Local Installation

If your Leostream Gateway does not have internet access or you prefer to perform a manual installation, you can download the Leostream Gateway RPM from the Leostream Website.

https://www.leostream.com/downloads/leostream-gateway

After downloading the RPM, copy it to your Leostream Gateway machine and run the following three commands.

sudo yum -y install epel-release firewalld
sudo yum -y localinstall RPM_FILE_NAME
sudo /sbin/reboot

Where RPM_FILE_NAME is the name of the downloaded file you copied to the Leostream Gateway machine.

To upgrade an existing Leostream Gateway, run the following command.

sudo yum -y localinstall RPM_FILE_NAME