Skip to main content

Advanced Use & Quirks

This section covers some advanced topics and quirks that you may encounter when using the Dronetag On-Premise with virtual machines.

User accounts​

The system is configured with two main UNIX user accounts:

  • core - the main user account for accessing the virtual machine over SSH and making changes, is sudoer.
    • Can be used only over SSH.
    • Does not have any password set, login is done using the SSH key.
  • viewer - a read-only user account for accessing the web interface and viewing the data.
    • Cannot be used over SSH.
    • The default password is onpremviewer. We recommend changing it after the first login.

Connecting to the VM over SSH​

ssh -i core_key core@<IP_ADDRESS>

where <IP_ADDRESS> is the IP address of the virtual machine. If you used port forwarding and forwarded SSH to a different port, use the -p option to specify the port.

Replacing the offline maps​

The Dronetag On-Premise uses offline maps for the map visualization in the app. You may wish to replace the default maps with your own.

The maps are stored in the /etc/onprem/data/maps directory.

The supported formats are .mbtiles or .pmfiles. You can use tools like MapTiler to create your own maps in these formats.

To replace the maps, follow these steps:

  1. Prepare your map files in .mbtiles or .pmfiles format.
  2. Copy the files to the /etc/onprem/data/maps directory on your Dronetag On-Premise node.
  3. Edit the /etc/onprem/data/maps/config.json file path to reference the newly uploaded maps file.

Automatic updates​

For the self-install kit distributions, we have disabled the automatic updates of the system, provided by the Fedora Core OS, to avoid unwanted automatic reboots of the machine. If you wish to enable automatic updates, you can do so by running the following command:

sudo systemctl unmask zincati.service
sudo systemctl unmask fwupd-refresh.service

Read more about Fedora's automatic updates.

Quirk: Using video output in VM environment​

The current distribution is not configured to use the video output in a virtual machine environment — different virtual machine software has different requirements for video output, needs to use different drivers, and so on.

If you want to use the video output in a virtual machine, you will need to configure it manually. This may involve installing additional drivers or configuring the virtual machine settings.

To start X session after the VM boots up, you will need to create a special file. Read more in the Accessing the Local Dronetag App page.

Quirk: Serial TTY console​

We expect the VM to run without a serial TTY console, so we disabled the TTY service on S0 to prevent failing service errors. If you encounter issues with the serial console, our you need/want to use it, you can enable the service back by running the following command:

sudo systemctl unmask serial-getty@ttyS0.service