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.

  1. Stop your IDSTower service

$ sudo systemctl stop idstower.service

  1. Take a full backup of your current IDSTower database

$ sudo mysqldump -B [DatabseName] -u [DatabaseUsername] -p > IDSTower_backup_`date +%F_%H_%M_%S`.sql

  1. 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`

  1. 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

  1. Start the IDSTower service.

$ sudo systemctl daemon-reload
$ sudo systemctl start idstower.service

  1. Verify IDSTower service has started correctly and database schema has been migrated

$ sudo systemctl status idstower.service

  1. 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