Upgrade Guide from v2.3.x to v2.4.0¶
This guide explains how to upgrade from IDSTower v2.3.x to v2.4.0, to upgrade please follow the below steps.
Stop your IDSTower service
$ sudo systemctl stop idstower.service
Take a full backup of your current IDSTower database
$ sudo mysqldump -B [DatabseName] -u [DatabaseUsername] -p > IDSTower_backup_`date +%F_%H_%M_%S`.sql
Take a backup of your IDSTower directory (including settings)
$ sudo cp -Rp /opt/idstower /opt/idstower_2.3.x_backup_`date +%F_%H_%M_%S`
Upgrade IDSTower to Version 2.4.0.
on CentOS/RHEL:
$ sudo yum update idstower-2.4.0-1
on Ubuntu:
$ sudo apt install idstower=2.4.0-1
Start the IDSTower service.
$ sudo systemctl daemon-reload
$ sudo systemctl start idstower.service
Verify IDSTower service has started correctly and database schema has been migrated
$ sudo systemctl status idstower.service
done.
Note
Starting from version 2.4.0, IDSTower supports database schema auto-migration, this means that you will not need to apply the schema update manually (as in older versions), if you want to upgrade from an older version (eg: 2.x or 1.x), please follow the upgrade guides sequentially to version 2.3.0 and then update to version 2.4.0.
Incase you faced issues with the database schema auto-migration, you can apply the database migration script as follows:
$ sudo curl https://download.idstower.com/packages/2.4.0/sql_scripts/IDSTower_upgrade_database_schema_from_2.3.x_to_2.4.0.idempotent.sql --output idstower_schema_upgrade.sql
$ sudo mysql -u [DatabaseUsername] -p [DatabseName] < idstower_schema_upgrade.sql