Upgrade SmartCollect SC²

We recommend that you upgrade SmartCollect SC² often to stay up to date with the latest fixes and enhancements. In order to make this a reality, SmartCollect SC² 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.

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 SmartCollect SC² 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.

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

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

backup:
> mysqldump -u root -p[root_password] [smartcollect] > smartcollect_backup.sql

restore:
> mysql -u root -p smartcollect < smartcollect_backup.sql

backup:
> pg_dump smartcollect > smartcollect_backup

restore:
> psql smartcollect < smartcollect_backup

You can upgrade SmartCollect SC² by following the same procedure as when you installed it.

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

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

If you installed SmartCollect SC² 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 SmartCollect SC² installation.

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 <smartcollect_install_dir>/conf/custom.ini as this will make upgrades easier without risking losing your config changes.