This article walks you through the installation of the SSH Gateway on Linux, either using the RPM or DEB packages provided by SSHTOOLS Limited. Once you have downloaded the appropriate file for your Linux distribution, please upload this to your server and access the server via SSH to install.
These instructions assume you are not root but can sudo to perform privileged actions. If you are logging in as root you can remove the sudo command from the examples below.
Step 1. Pre-requisites
First we should ensure we have all the pre-requisites installed. The SSH Gateway requires a Java 7 or greater runtime installed. This is not included as part of the product download so must first be installed. Java runtime can normally be installed using your operating systems package manager. Here we provide an example for Ubuntu/Debian or CentOs
To install Java 7 on Ubuntu/Debian execute the following command:
sudo apt-get install openjdk-7-jre
To install Java 7 on CentOS execute the following command:
sudo yum install java-1.7.0-openjdk
The server provides an administrative interface that is accessible using your browser so you should ensure that no other HTTP server is already running on the machine. If you need to install this on a server that already has ports 80/443 in use then you should follow the optional instructions here. Similarly an SSH server is also installed as part of this product and will attempt to listen on port 22. If you need this to co-exist with another SSH server already running on that port you can install the product as normal and change the SSH port once you have access to the administrative user interface.
Step 2. Install
To install the RPM package execute the following command
sudo rpm -i ssh-gateway-linux-<version>-rpm
To install the DEB package execute the following command:
sudo dpkg -i ssh-gateway-linux-<version>.deb
Step 3. Starting the service
You can now start the gateway service using the command below:
sudo service ssh-gateway start
You have now installed the SSH Gateway server on your Linux distribution. The server provides an administrative interface that runs on port 443 of the server. You can now connect to the user interface using the url https://<hostname>/ where <hostname> is the ip, hostname or FQDN of the server you have installed using this articles instructions.
You should be presented with a login screen after connecting to the URL. You should login using the default administrative credentials:
You will be prompted to change the admin password after logging in for the first time.