Linux

Installation

Note

It is mandatory to have a Nexus Repository user account in order to install the RTLS Hub on your machine. If you’re working with Ubuntu, you can download and install the Docker engine here: Docker Engine . Once the Docker engine is installed, you can then install the Docker compose from here: Docker Compose .

Getting the latest docker compose

Please login to Nexus Repository to download the docker compose.

../_images/nexus_step_1.png

After logging in, click on “Browse” to access the repository content.

../_images/nexus_step_4.png

In the directory “omlox-extra”, navigate to the “bundle” folder and download the Docker compose “rtls-bundle-small_latest.zip”.

../_images/nexus_step_6a.png

Create a new folder named “rtls-bundle-small” on the desktop and extract all the content from the zip file to this folder. Please copy the path of the “rtls-bundle-small” directory.

../_images/ubu_directory.png

Running the docker compose

It is important to run the Docker Compose from the directory copied above through Terminal. Please open Terminal from your applications.

../_images/ubu_terminal.png

To run the Docker Compose, log in to Nexus Repository through Terminal.

sudo docker login repo.deepmap.de:8443

../_images/ubu_docker_login.png

Press “Enter”. The system will prompt for the username and password of the Nexus repository. Input your user credentials to log in and press “Enter”.

Note

once a user is logged in to Nexus repository through docker registry, it is not needed to give user account credentials every time until the user logs out. A user can log out by executing command docker logout repo.deepmap.de:8443.

../_images/ubu_docker_loggedin.png

To change the directory, execute following command.

cd (Please paste copied directory path of “rtls-bundle-small”)

../_images/ubu_directory_chng.png

To start the docker compose, execute following command in Terminal.

sudo docker-compose up -d

../_images/ubu_docker_compose.png

It will take a few minutes to download the Docker image and set up the RTLS Hub. Open a web browser and enter http://localhost:8081 . This will allow you to access the web frontend of the RTLS Hub.

../_images/hub_frontend.png

Run the Simulation

In order to test features and functionalities of the RTLS Hub, a simulation package will be provided. This package consists of simulated data for zones, fences, and moving trackables, and was produced at our testing site in Teningen, Germany. Please download the Simulation Package with your Nexus Repository login credentials. After testing the RTLS Hub using the simulation package, you may also test using your own network(s) and data. Please consult Heidelberg Mobil International GmbH for support if needed.

Note

If you have the RTLS Hub already installed on your machine, it is mandatory to stop the running RTLS Hub in order to run the simulation. Running this simulation will import the simulation data in the current RTLS Hub instance.

Stop the running RTLS Hub

Please make sure you are in the same directory you installed the RTLS Hub. In this case, “rtls-bundle-small”.

To stop the running RTLS Hub, execute the following command in Terminal and press “Enter”.

sudo docker-compose down

This will stop the running RTLS Hub. Terminal will display the status of the operation.

../_images/ubu_docker_stop.png

This ensures the running RTLS Hub is stopped and allows the user to modify the configuration data.

Import the simulation

Open the simulation package downloaded from the Nexus repository. Copy the files from the package.

../_images/ubu_sim_copy.png

Paste the files into the “hub-data” folder in the directory where the RTLS Hub bundle was extracted during the RTLS Hub installation.

../_images/ubu_sim_paste.png

This ensures that the RTLS Hub will have simulation data to display in the frontend.

Run the Docker compose again to start the RTLS Hub with the simulation data.

../_images/ubu_docker_compose.png

Open a browser and enter the web address http://localhost:8081 . This will provide access to the RTLS Hub frontend. The zones and fences from our test site in Teningen, Germany will be visible on the map.

../_images/win_sim_hub.png

This map will also display the simulated trackables moving along a fixed path. As trackables move through fences, the left side pane will list triggered events.