DranSCADA documentation / Installation / Install on Debian/Ubuntu

Install on Debian or Ubuntu

This page explains how to install DranSCADA dependencies, download and install DranSCADA, get the service up and running on your Debian or Ubuntu system, and also describes the installation package details.

Note on upgrading: While the process for upgrading DranSCADA is very similar to installing DranSCADA, there are some key backup steps you should perform. Read Upgrading DranSCADA for tips and guidance on updating an existing installation.

1. Download and install

You can install DranSCADA by downloading a .deb package, or by downloading a binary .tar.gz file.

Install .deb package

If you install the .deb package, then you will need to manually update DranSCADA for each new version.

Copy and paste the code from the installation page into your command line and run. It follows the pattern shown below.

sudo apt-get install -y adduser libfontconfig1
wget <.deb package url>
sudo dpkg -i dranscada<edition>_<version>_amd64.deb

Install from binary .tar.gz file

Download the latest .tar.gz file and extract it. The files extract into a folder named after the DranSCADA version downloaded. This folder contains all files required to run DranSCADA. There are no init scripts or install scripts in this package.

wget <tar.gz package url>
sudo tar -zxvf <tar.gz package>

2. Start the server

This starts the dranscada-server process as the dranscada user, which was created during the package installation.

If you installed with the .deb package, then you can start the server using systemd or init.d. If you installed a binary .tar.gz file, then you need to execute the binary.

Start the server with systemd

To start the service and verify that the service has started:

sudo systemctl daemon-reload
sudo systemctl start dranscada-server
sudo systemctl status dranscada-server

Configure the DranSCADA server to start at boot:

sudo systemctl enable dranscada-server.service

Start the server with init.d

To start the service and verify that the service has started:

sudo service dranscada-server start
sudo service dranscada-server status

Configure the DranSCADA server to start at boot:

sudo update-rc.d dranscada-server defaults

Execute the binary

The dranscada-server binary .tar.gz needs the working directory to be the root install directory where the binary and the public folder are located.

Start DranSCADA by running:

./bin/dranscada-server web

Package details

  • Installs binary to /usr/sbin/dranscada-server
  • Installs Init.d script to /etc/init.d/dranscada-server
  • Creates default file (environment vars) to /etc/default/dranscada-server
  • Installs configuration file to /etc/dranscada/dranscada.ini
  • Installs systemd service (if systemd is available) name dranscada-server.service
  • The default configuration sets the log file at /var/log/dranscada/dranscada.log
  • The default configuration specifies a SQLite3 db at /var/lib/dranscada/dranscada.db
  • Installs HTML/JS/CSS and other DranSCADA files at /usr/share/dranscada

Next steps

Refer to the Getting Started guide for information about logging in, setting up data sources, and so on.

Configure DranSCADA

Refer to the Configuration page for details on options for customizing your environment, logging, database, and so on.