Migrating IDA Application

If you have previously installed IDA in your environment and now you want to update IDA to the new version, please read the following content.

Below are example steps to migrate IDA application from v21.0.0 to v24.0.3+. For migrating applications from and to early versions of IDA, see references below:

Migrate database schema on IDA startup

Starting from version 24.0.3, IDA automatically checks for database schema migration requirements and redirects IDA admin user to the Migrate Database Schema page. If the Database user shown on the page has been granted schema change privileges, IDA admin user can then execute the migration scripts automatically by clicking Execute Migration Scripts. Otherwise, IDA admin user can download the migration scripts by clicking Download Migration Scripts and ask DBA to execute them manually. After the migration scripts are executed successfully, IDA admin user can restart IDA to complete database schema migration.

Preparing your migration

Compared to the previous version, the new version of IDA will have some changes in the database structure, so sometimes IDA updates require database migration. To prepare your migration, take the following steps:

  1. Download the lastest IDA installation file. The migration scripts come from the installation file. The file name is ida-web-xxx.zip.(xxx is the IDA version)
  2. Stop Libery server.
  3. Stop database server.
  4. Backup the database.

Step 1: Update IDA.war

You need to update IDA.war by following these steps:

  1. Configure Liberty server.xml.
  2. Remove all the files from \usr\servers\default\apps folder.
  3. Copy the ida-web.war into the \usr\servers\default\apps folder.
  4. Start Liberty Server.

Step 2: Update DB

Choose one of the following options to migrate database schema when necessary.

Option 1

  1. Click Execute Migration Scripts to execute migration scripts automatically.

  2. Restart IDA to complete database schema migration.

Option 2

  1. Click Download Migration Scripts to download the migration scripts and send the migration scripts SQL file to DBA to execute them manually.

  2. After migration scripts are exectued manually, restart IDA to complete database schema migration.

Step 3: Update IDA BAW Toolkit

To update the IDA BAW Toolkit, take the following steps:

BAW Version IDA Toolkit Version
19.0.0.3 IDA_Toolkit-8.6.1.19003.twx
20.0.0.1 IDA_Toolkit-8.6.2.20001.twx
Due to product limitations, this version does not support executeSQL.
20.0.0.2+ IDA_Toolkit-8.6.2.20002.twx

  1. Import the corresponding IDA_Toolkit-8.6.x.x.twx from IDA Resources page into your Process Center.

  2. Open your process app by the web process designer from the Process Center.

  3. Upgrade the toolkit.

  4. Delete the old IDA Utility.

  5. Click Services below IDA Toolkit. Right-click the IDA Utility service flow and copy the item to your process app.