Installing Runtime under Debian 10/Ubuntu 20

Installation steps (required)

  1. Login as root

    su -l

  2. Install the package UbiquityRuntimeSetup:

    Distribution

    Setup command

    Debian 10

    apt install ./UbiquityRuntimeSetup_Debian10_<version>.deb

    Ubuntu 20

    apt install ./UbiquityRuntimeSetup_Ubuntu20_<version>.deb

The binaries of UBIQUITY Runtime will be installed in the folder /opt/ASEM/Ubiquity/Runtime/bin.

Installation steps (optional)

If you want to enable serial use remotely, you need to add the symbolic link to the interface in the path /dev/serial<interface number>. For example, if your system has the serial interface /dev/ttyS0, then you need to run the following command:

ln -s /dev/ttyS0 /dev/serial0

Execution of UBIQUITY Runtime Service

Execution as service (systemd)

Create a unit configuration file whose name ends in “.service”. It encodes information about a process controlled and supervised by systemd.

Open your favorite text editor then copy and paste the following configuration

[Unit]
Description=UBIQUITY Runtime service

[Service]
ExecStart=mono /opt/ASEM/Ubiquity/Runtime/bin/UbiquityRuntimeService.exe
Environment="DISPLAY=:0"
Environment="RDP_USERNAME=<username>"
Restart=on-failure

[Install]
WantedBy=multi-user.target

Replace the <username> field in RDP_USERNAME with the user authorized to access the X11 server. An authorized user can run the xhost command and get their username in the output.

Save the configuration file in /etc/systemd/system/ with a name ending with “.service” (e.g. UbiquityRuntimeService.service).

Enable the automatic startup of the process at boot with:

systemctl enable UbiquityRuntimeService

The service can also be started with:

systemctl start UbiquityRuntimeService

The service can also be stopped with:

systemctl stop UbiquityRuntimeService

Execution on demand

Login in the default session (i.e., not ssh) with root or a user of the sudoers group and execute the following commands:

cd /opt/ASEM/Ubiquity/Runtime/bin
sudo mono UbiquityRuntimeService.exe