Skip to main content

Quick Start

In this section we will guide you through the process of setting up your Dronetag On-Premise instance using the self-install kit. You will need a distribution package provided by us, and a virtualization platform to run the virtual machine.

info

We plan to switch away from distributing VM images in the future, and instead provide Docker Compose manifests directly that can be run on your own hardware with your own software/OS set-up. This will easier for us to maintain, and more flexible for our customers, to stay OS-agnostic. Current VM users will have the option to continue using the VM images, it will be further compatible.

1. Prepare the files​

Check the distribution package of the kit you have received from us. It should contain the following files:

  • dronetag-onpremise*.ovf - the OVF (Open Virtualization Format) file containing the virtual machine image
  • dronetag-onpremise*-disk*.vmdk - the VMDK (Virtual Machine Disk) file containing the virtual machine disk
    • There are two disks, one contains the operating system and application data, the other contains the database data. This is done to allow for easier upgrades, and to backup and restore of the database data.
  • core_key and core_key.pub - the SSH key pair used to access the virtual machine over SSH (user core)

2. Import the OVF file​

Import the OVF file into your virtualization platform of choice. The OVF file contains the virtual machine configuration, and the VMDK files contain the virtual machine disk images.

We have an example for Oracle VirtualBox, see the Example: Install on VirtualBox page.

3. Set-up the networking​

Configure bridged network interface, or stay behind NAT and forward the necessary ports from the VM machine to the rest of your network, or your host machine. The following ports are used by the instance:

  • 22 - SSH port, to access the virtual machine over SSH, read more info
  • 80 - HTTP port for the web interface
note

HTTPS is not supported yet, if you need secure access, you can set up a reverse proxy in front of the Dronetag On-Premise instance, or use a VPN to access the instance securely.

4. Start the web services​

The virtual machine is configured to start the web services automatically on boot. If you need to start or stop the services manually, follow these steps:

  1. SSH into the virtual machine using the SSH key pair provided in the distribution package.
    • Use the command: ssh -i core_key core@<IP_ADDRESS> where <IP_ADDRESS> is the IP address of the virtual machine.
  2. Once logged in, ensure you're in the /etc/onprem directory.
  3. Use scripts start.sh and stop.sh to start or stop the web services:
    • To start the services, run: sudo ./start

5. Open the local Dronetag App​

Open your web browser and open the URL http://<IP_ADDRESS>, where <IP_ADDRESS> is the IP address of the virtual machine. This will open the local Dronetag App, which allows you to visualize the data captured by your Dronetag Scout devices.

Next steps​

Continue with the other guides on how to configure your Dronetag equipment to start sending data to your on-premise instance, and how to use the apps to access the visualization and data.