RTLS Studio - Install Guide

This documentation is for RTLS Studio 2.0 or newer. Please read following manual for RTLS Studio 1.6.2 and older.


This document will guide you through the RTLS Studio installation process for RTLS Studio 2.0.0 on Ubuntu Server 18.04 LTS (64-bit).

RTLS Studio is installed as server based on premise. It is distributed as installation bundle or pre-installed within VirtualBox virtual image for fast evaluation and demonstration purposes.

Here are requirements:

  • RTLS Studio install .zip package (downloadable from partner portal)
  • x64 computer or VirtualBox with Ubuntu 18.04 OS server edition pre-installed
  • WinSCP file transfer manager utility
  • Internet connection (for installation only).

The RTLS Studio software can run only on host server x64 or VirtualBox virtual machine. It is tested and prepared for Ubuntu 18.04LTS, which can be downloaded here: http://releases.ubuntu.com/18.04/. Please use the Ubuntu 18.04 server edition (non GUI).

Alternatively RTLS Studio 2.0.0 can be also deployed on Ubuntu 14.04 server edition, not recommended for new deployments.

Installation

  1. Login to Ubuntu

  2. First, you will need to set the server to a static IP. The default is 192.168.225.2. Detect your Ethernet interface by typing the following command:

    Ifconfig

    The output should look as follows:

    The main Ethernet interface here is enp0s3 (but it can be different). Its address should be 192.168.225.2. If this is not the case use netplan to configure network interface. Configuration file of netplan, is under /etc/netplan/ with a .yaml extension (e.g. /etc/netplan/config.yaml). In our case:

    sudo nano /etc/netplan/50-cloud-init.yaml

    The file should have the following content (replace enp0s3 with your interface’s name):

    network:
        ethernets:
            enp0s3:

                addresses:
                - 192.168.225.2/24
                dhcp4: false
                nameservers:
                    addresses:
                    - 192.168.225.1
                    search: []
        version: 2 


    Save and close the file and apply config:

    sudo netplan apply

    Then your interface’s address should be set up correctly. You can verify this by typing the ifconfig command again.

    If you are using VirtualBox, you also have to make sure that you have the Network settings for your virtual machine set to Bridged Adapter and that you have your Ethernet interface selected. If this is not the case, change it accordingly and restart your image.




  3. After that connect to the server with WinSCP (https://winscp.net/eng/download.php). Use the server’s static IP 192.168.225.2.

  4. Extract and Copy the contents of the install zip file to /home/sewiortls

  5. Then you will need to share internet connection to your server. If you have internet on different network with DHCP server, then open the network configuration file of netplan, which is under /etc/netplan/ with a .yaml extension.

    sudo nano /etc/netplan/50-cloud-init.yaml

    Change the file accordingly (replace enp0s3 with your interface’s name):

    network:
        ethernets:
            enp0s3:
                dhcps4: true
        version: 2

    Save and close the file and apply config:

    sudo netplan apply

    Then your interface’s address should be set up correctly. You can verify this by typing the ifconfig command again.

  6. On the server again, navigate to the install folder by typing:

    cd /home/sewiortls/install

  7. Run the install script:

    sudo sh install.sh

    The installation should take 10-20 minutes to finish (depending on the server and internet connection).  You will be also asked for the hostname. This hostname is being used by our web services (RTLS Studio, RTLS Manager, Sensmap, Sensmap3D, etc.).

  8. After that the installation is finished. You need to change the server’s Ethernet interface IP address back to static 192.168.225.2, as described in step 1). Then reboot the Ubuntu.

    sudo reboot

  9. Now installation is complete, you can reach RTLS Studio at address 192.168.225.2.