Installation & Launch - Single Machine

info

If you have an ATS kit (LPU with SENSR-I pre-installed), you may skip the installation part of this procedure.

caution

Make sure you have an active internet connection during the installation process.

SENSR's single machine version is designed for simplicity, allowing SENSR to run in straightforward, one-machine setups. This version of SENSR offers less flexibility than the general one but requires less effort from the user.

Please note that the Single Machine Installation does not support a distributed system architecture. For a distributed system, please use SENSR's Generic version based on Kubernetes. If you have any doubts about which version to use, please contact support@seoulrobotics.org.

Prerequisites

• A host for running SENSR with Ubuntu 20.04 LTS installed.
• 30GB of available storage space on the host.
• Before installing SENSR, run sudo apt update to ensure all repository links are up to date.
• Have the installation package ready on the host: sensr-singlemachine-installer_[VERSION].deb. Please contact support@seoulrobotics.org if it is missing.

Installation

1. Place the package in the home folder.
2. In a Terminal, run sudo apt install ./sensr-singlemachine-installer_[VERSION].deb.
3. Once the installation completes, two icons will be created in the icon tray:
   • Start SENSR: Starts SENSR in GUI mode.
   • Stop SENSR: Stops SENSR.
4. Click Start SENSR.
   • At first launch, SENSR will download its dependencies. This operation can take a few minutes and may reboot the machine if the graphics driver is installed.
5. Deploy your SENSR license following the guide here.
6. Run SENSR by clicking Start SENSR again.

Run and Stop SENSR

• To run SENSR in GUI mode, click Start SENSR.
• To stop SENSR, click Stop SENSR.

Note: SENSR's Web visualizer, Web Frontend is automatically launched. The Web Frontend provides a web GUI through the browser, either on the host directly or on a machine located on the same network as the host. The Web Frontend is compatible with Chrome Browser. To access the Web Frontend, in Chrome's address bar type http://<IP address of the host>:5000.

Autostart

Once launched, SENSR will always start in non-GUI mode if the host is restarted or loses power. To re-enter GUI mode, click Stop SENSR, then Start SENSR again.

Operation through SSH

If direct access to the host is not possible, an SSH connection can be used. To connect through SSH, ensure your network administrator allows SSH connections. From a computer on the same network as the host, open a terminal and enter ssh <username>@<ip_address_of_the_host>.

To run or stop SENSR, go to /opt/sensr-singlemachine-installer/ in the terminal and run docker compose up -d or docker compose down.