DranSCADA documentation / Installation / Upgrade DranSCADA

Upgrade DranSCADA

We recommend that you upgrade DranSCADA often to stay up to date with the latest fixes and enhancements. In order to make this a reality, DranSCADA upgrades are backward compatible and the upgrade process is simple and quick.

Upgrading is generally safe (between many minor and one major version) and dashboards and graphs will look the same.

Backup

We recommend that you backup a few things in case you have to rollback the upgrade.

  • Installed plugins - Back them up before you upgrade them in case you want to rollback the DranSCADA version and want to get the exact same versions you were running before the upgrade.
  • Configuration files do not need to be backed up. However, you might want to in case you add new config options after upgrade and then rollback.

Database backup

Before upgrading it can be a good idea to backup your DranSCADA database. This will ensure that you can always rollback to your previous version. During startup, DranSCADA will automatically migrate the database schema (if there are changes or new tables). Sometimes this can cause issues if you later want to downgrade.

sqlite

If you use sqlite you only need to make a backup of your dranscada.db file. This is usually located at /var/lib/dranscada/dranscada.db on Unix systems. If you are unsure what database you use and where it is stored check you dranscada configuration file. If you installed dranscada to custom location using a binary tar/zip it is usually in <dranscada_install_dir>/data.

mysql

backup:
> mysqldump -u root -p[root_password] [dranscada] > dranscada_backup.sql

restore:
> mysql -u root -p dranscada < dranscada_backup.sql

postgres

backup:
> pg_dump dranscada > dranscada_backup

restore:
> psql dranscada < dranscada_backup

Ubuntu or Debian

You can upgrade DranSCADA by following the same procedure as when you installed it.

Upgrade Debian package

If you installed DranSCADA by downloading a Debian package (.deb), then you can execute the same dpkg -i command but with the new package. It will upgrade your DranSCADA installation.

wget <debian package url>
sudo apt-get install -y adduser libfontconfig1
sudo dpkg -i dranscada_<version>_amd64.deb

Centos / RHEL

If you installed DranSCADA by downloading an RPM package you can just follow the same installation guide and execute the same yum install or rpm -i command but with the new package. It will upgrade your DranSCADA installation.

Windows

If you downloaded the Windows binary package you can just download a newer package and extract to the same location (and overwrite the existing files). This might overwrite your config changes. We recommend that you save your config changes in a file named <dranscada_install_dir>/conf/custom.ini as this will make upgrades easier without risking losing your config changes.