Installing the Leostream Gateway

Modified on Fri, 3 Mar, 2023 at 3:59 PM

RHEL/Rocky/Alma 8:


Installing the Leostream Gateway

Leostream Gateway 2022 can be installed on any virtual or physical machine running the latest Red Hat Enterprise Linux 8.x operating system or one of its derivatives such as Rocky Linux and AlmaLinux OS. 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.

 

warning_48 The Leostream Gateway does not install on CentOS 8 or any other Linux distribution.

 

You do not 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 80 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.


Upgrading from the Leostream Repository

 If you are running a version of the Leostream Gateway earlier than version 2022.1.0.6, use the following command to upgrade that Leostream Gateway to version 2022.1.0.6.

sudo dnf update leostream_gateway --allowerasing

Subsequent upgrades can be applied to an existing Leostream Gateway by running the following command.


Performing a Local Installation

If you prefer to perform a manual installation, you can download the Leostream Gateway RPM from the Leostream downloads page.

 

https://license.leostream.com/download.html

 

When visiting the downloads page, the following login dialog appears.

 

 

To view your permissible downloads:

  1. Enter your Leostream Serial number.

  2. Enter the Contact email address associated with your serial number. If you do not know your Contact email address, please contact sales@leostream.com


After building your base operating system and applying all updates, copy the downloaded Leostream Gateway RPM into your user’s home directory. You can then use the following commands to install your Leostream Gateway.  

 

 warning_48 This installation method requires access to local Red Hat repositories to pull all necessary Leostream Gateway dependencies.

sudo dnf -y install epel-release
sudo dnf -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. 



RHEL/CentOS 7:

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/resource/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

© Copyright 2023 Leostream Corporation