Orion server installation

Pre-requisites

• Ensure your hardware meets all of the System requirements.
• Ensure that the server's OS is prepared correctly. If necessary, please refer to our guide for installing Ubuntu 24.04 LTS Minimized.
• Please note that this server will contain sensitive biometric information. As such, it must be kept in a physically secure location and installed on encrypted storage within the server.

Required information

• The following information on-hand:
  • Ubuntu Server IP - This is the network location of the machine being configured as an Orion Server.
  • Space Server IP - This can be found in the Space Configurator.
  • Space Server Port - This can be found in the Space Configurator.
  • SHIP API Key - This can be found in Salto Space's General Options.
  • Space Server Name - This can be found in "view your PC's name" section of Windows.
• Access to the shell on your prepared Ubuntu server, with sudo privileges. This can be via SSH access or natively. If you are controlling the server via SSH, the install script automatically keeps the SSH port open for server management.
• Access to Powershell (not cmd) on your Space server, running as administrator.

Step-by-step

The admin operator will have received a welcome email when the Salto partner provided them access to their site within the Orion Console. The email will contain a link to the correct console for their region.

1. Log in to the Orion Console for the appropriate region.
2. Select the site from the drop-down in the left-hand pane.

3. Click the + Add Server tile to be taken to the installation wizard. Through this wizard, you can provide some information for the Console to generate an all-in-one installation script for your prepared Ubuntu server.

4. Double-check the site configuration.

5. In the respective fields of the ACS configuration, select Space from the System drop-down, enter the Space Server IP, Space Server Port, SHIP API Key and, if Space is not already using HTTPS, enter the hostname of the machine running Space in Space Server Name.

6. In the Orion Server Information screen, enter an appropriate Server Name and the Ubuntu Server IP. Check both boxes and Continue.

7. Copy the command provided into the console of your server, and follow the instructions which appear in the console. After some system checks from the script, type "yes" to confirm and then "yes" or "no" to leaving an SSH port open for management. Upon completion the server reboots; when it restarts, it is then operational.
   • Installation can take 10 minutes or longer depending on your internet connection speed.
   • This screen automatically moves on when The Orion Console first receives contact from your Ubuntu Server.

8. Copy the Space server command onto Powershell on your Space server. This will install the Salto root CA public certificate and create an entry in the server hosts file for orion-server. This will be required so that the SPACE server is able to verify the TLS certificate provided by the Orion Server. It will take less than a minute.

9. Within the Space General Options, navigate to the Face recognition tab and input the Orion API Key provided in the screen below.