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.
After logging in, click on “Browse” to access the repository content.
In the directory “omlox-extra”, navigate to the “bundle” folder and download the Docker compose “rtls-bundle-small_latest.zip”.
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.
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.
To run the Docker Compose, log in to Nexus Repository through Terminal.
sudo docker login repo.deepmap.de:8443
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”.
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.
To change the directory, execute following command.
cd (Please paste copied directory path of “rtls-bundle-small”)
To start the docker compose, execute following command in Terminal.
sudo docker-compose up -d
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.
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.
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.
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.
Paste the files into the “hub-data” folder in the directory where the RTLS Hub bundle was extracted during the RTLS Hub installation.
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.
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.
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.