Installation (v2.x)

Updated 2 years ago by admin

Please ensure you have read the requirements section.
Internet access is required during installation. You will be prompted for valid network settings during the installation process.


Installing on a physical server

  1. Download the latest USS Gateway software image.
  2. Use Windows Explorer or similar tool to burn the software image to CD.
  3. Insert the CD into the physical server. Ensure the BIOS is set to boot from the CD first.
  4. Power on the server and follow the installation steps below.

Installing on a virtual server

  1. Download the latest USS Gateway software image.
  2. Create a new virtual machine matching the requirements.
  3. Attach the .iso file to the virtual CD on the new virtual machine. Ensure the virtual CD drive will connect at power on.
  4. Power on the virtual machine and follow the installation steps below.

Installation Steps

The installation wizard is keyboard based. Use the cursor keys for menu navigation, Tab to switch options and Enter to select.

Once the server has booted from the installation CD you will be prompted to select the language to use. Select the appropriate option from the list and press Enter.

The USS Gateway splash screen will be displayed. Press Enter again to start the installation.

Please wait a few minutes for the installation wizard to start. You may see a lot of console output however this is safe to ignore

The console-based installer will appear.

To select options use the CURSOR KEYS, to move between options press the TAB key and press ENTER to confirm your selection.

Select the desired operating system language and press Enter.

Next you will be prompted to confirm the keyboard layout. If the keyboard has been detected correctly, you can press Enter to continue.

If you need to change the layout, use the tab key several times to highlight the Layout drop down and then press Enter. From the list, use the cursor keys to select the desired keyboard layout and press Enter to select. Repeat the process for the Variant option if required.

Next, you will be prompted to enter network details so that the installer can access the Internet.

All of the entered network settings must be valid so that the installer can download files via the Internet.

Use the tab key to highlight the Subnet field and enter in the subnet CIDR for the IP address you intend to give the new USS Gateway server e.g. if the IP of the server will be and the subnet mask is then the CIDR to enter is

Use the tab key again to move to the Address field and enter in the IP address for the virtual machine to use on the network.

Use the tab key again to move to the Gateway field and enter the default gateway IP address for the network.

Use the tab key again to move to the Name Servers field and enter in at least one valid DNS server. Comma separate additional name servers.

Use the tab key again to move to the Search Domains field and enter the local network domain, if available. If not, you can enter a placeholder domain and change this later.

Use the tab key again to highlight the Save button in green and press Enter.

The network settings will be applied and confirmed. Ensure the Done button is highlighted and press Enter to continue.

If your network requires a HTTP proxy for Internet access enter the address in the format given.

Ensure the Done button is highlighted and press Enter to continue.

The installer will now prompt to create partitions on the virtual machine disk.

This step will erase all of the data on the virtual or physical disk and install the USS Gateway operating system.
Unless you have any advanced requirements the default partitions are recommended and the Use Entire Disk option should be selected

Ensure the Use an entire disk option is selected, use tab multiple times until you can highlight Done and press Enter to proceed.

The summary of disk changes will be presented

Press Enter to continue. You will be prompted one final time to confirm that the disk will be erased and all data will be lost.

To continue, use the tab key to highlight Continue and press Enter.

Next, you will be prompted to set up the profile of the operating system, including system user and hostname.

Use the tab key to highlight Your name and enter the name of the administrator that will manage the server, or enter a generic name such as System Administrator

Use the tab key to highlight Your server's name. This is the hostname for the USS Gateway server. This will form part of the Fully Qualified Domain Name of the server if you join it to a Windows domain later on. The hostnames can be changed later if required.

If you are deploying multiple USS Gateways then these hostnames should be unique.

Use the tab key to highlight Pick a username and enter in the desired username for console access via a terminal such as Putty.

Use the tab key to highlight Choose a password and re-enter the password to ensure you know it.

Store the username and password somewhere safe - this credential is used for maintenance, technical support and upgrades.
This is not the username and password that will be used to administer the USS Gateway web interface. Refer to the Configuration Guide for information on how to associate this USS Gateway with a USS account.

Next, use the tab key to highlight Done and press Enter.

The installer will now begin downloading and installing files.

Installation may take 20-30 minutes depending on the speed of the Internet connection and resource of the server.
If the process fails after this step for any reason please refer to the troubleshooting section at the end of this guide.

Use the tab key to highlight OK and press Enter

Use the tab key to highlight Reboot Now and press Enter

After the reboot, the console will show the command line log in prompt.

Remember to keep your USS Gateway system up to date by performing regular maintenance.

Perform System Upgrades

Log in to the command line using the username and password set during installation.


sudo su
<enter password again>
apt-get update && apt-get dist-upgrade

After the system update process has completed, you must reboot the gateway.

Type reboot

Installing on Hyper-V

Please review the post-installation Hyper-V notes before continuing. If you encounter problems with the network during installation please attach the Legacy Network Driver to the virtual machine and retry.


The Installation has Failed error message

  • The most common cause is the installer is not able to download the required files - usually due to DNS or gateway problems. Ensure the network details are correct and the virtual machine has access to the Internet. You should exit the installer and start again to change the network settings.
  • If you have to use a proxy server ensure it has been entered correctly, starting with http:// and containing the port number and a username/password if required in the right format.
  • Ensure no other security appliance on the network is blocking the installer.

How did we do?