Migrating IDA from v2.7.x to v21.0.0
Important: If you run IDA with WAS, please refer to Installing IDA Application to check your WAS version. IDA may encounter some problems if the WAS version is below 9.0.5.4!
1. Migrating IDA with a datasource connection
Important: Please back up your database before migration!
1.1 Edit [IDA_HOME]/conf/ida.properties under the conf folder.
This properties file contains three main sections. Please set the spring.datasource.driver-class-name, spring.datasource.url, spring.datasource.username, spring.datasource.password fields. If you want to encode your database password, please refer to Repacking IDA Application.
Important: Please comment out spring.datasource.jndi-name if you do not use a JNDI datasource.
JNDI Configuration
- spring.datasource.jndi-name: JNDI NAME
Datasource Configuration
- spring.datasource.driver-class-name: Driver Class Name
- spring.datasource.url: Datasource URL
- spring.datasource.username: User Name
- spring.datasource.password: Password
Jasypt Configuration
- jasypt.encryptor.password: Jasypt secret key for encrypting datasource passwords
1.2 Repackaging ida-web.war with configuration
The purpose of repackaging is to update your application-product.yaml in the war to ensure it loads the recent configuration. Once all the properties in the [IDA_HOME]/conf/ida.properties file have been updated, you can then re-package the [IDA_HOME]/build/ida-web.war file.
Before running the [IDA_HOME]/package.bat or [IDA_HOME]/package.sh, you will need to set the JAVA_HOME environment variable and ensure that [JAVA_HOME]/bin is included in the PATH variable. Once the environment variable is set, you can then execute the package shell command to repackage the ida-web.war.
1.3 Stop your running IDA Application
For example:
./server stop SERVER_NAME
1.4 Execute migrate-<DATABASE_TYPE>-v2.7.x-v21.0.0.sql
Note: Please execute call sysproc.admin_cmd('reorg table <TABLE_NAME>');
after altering a table in a DB2 database.
1.5 Add <httpSession cookieSameSite="None"/>
to server.xml
1.6 Replace ida-web.war and restart your server.
Note: Please refer to the documentation references-migrating-and-updating-your-application.
1.7 Migrate the values from your old conf/ida.properties to the ‘Settings’ page. The table below lists all the fields that need to be migrated:
-
General Settings:
Settings -> General conf/ida.properties General -> Trace Level loggerLevel General -> Enable LDAP Authentication ldap.enable General -> URL ldap.url General -> User Name ldap.username General -> Password ldap.password General -> Base DN ldap.basedn General -> User Filter ldap.user.filter General -> Default Role ldap.default.role General -> User Name Case Insensitive ldap.username.case-insensitive -
Testing Settings:
Settings -> Test conf/ida.properties Test -> Connection Timeout (seconds) engine-config.connection-timeout Test -> Wait Timeout (seconds) engine-config.wait-timeout Test -> Default Retry Times engine-config.default-retry-times Test -> Default Retry Interval (seconds) engine-config.default-retry-interval Test -> Data Path engine-config.data-dir Test -> Enable Test Case History enable_case_history Test -> Max Number of Test Case History max_case_history Test -> Threshold of New Test Case default_total_case -
Checkstyle Settings:
Settings -> Checkstyle conf/ida.properties Checkstyle -> Engine checkstyle.engine Checkstyle -> Decision Server Username resUser Checkstyle -> Decision Server Password resPassword Checkstyle -> Decision Server URL resUrl Checkstyle -> Decision Server Port resPort Checkstyle -> Rest URL restUrl -
Pipeline Settings:
Settings -> Pipeline conf/ida.properties Pipeline -> Installation Package Remote Dir engine-config.installation-package-remote-dir Pipeline -> Host smtp.host Pipeline -> Port smtp.port Pipeline -> Sender Email email.from Pipeline -> Deployment Timeout (seconds) deployment.timeout Pipeline -> Deployment Check Interval (seconds) deployment.interval Pipeline -> Interval for Trigger by New Snapshot (seconds) pipeline.snapshot.trigger.interval
1.8 Restart the IDA server
Restart the IDA server to make your changes effective.
2. Migrating IDA with a JNDI datasource connection
Important: Please back up your database before migration!
2.1 Please refer to section 1.1 to edit the [IDA_HOME]/conf/ida.properties file under the conf folder.
Note: Please comment out the spring.datasource.driver-class-name, spring.datasource.url, spring.datasource.username, spring.datasource.password, and jasypt.encryptor.password fields.
2.2 Please refer to 1.2 to repack the ida-web.war
Note: Please refer to the documentation references-migrating-and-updating-your-application.
2.3 Please refer to 1.3 to stop your running IDA Application
2.4 Please refer to the documentation Installing IDA Application to configure the server.xml file.
2.5 Please copy your database driver to the folder according to the library field configuration in server.xml.
2.6 Execute migrate-<DATABASE_TYPE>-v2.7.x-v21.0.0.sql
Note: Please execute call sysproc.admin_cmd('reorg table <TABLE_NAME>');
after altering a table in a DB2 database.
2.7 Replace ida-web.war and restart your Liberty server.
2.8 Add <httpSession cookieSameSite="None"/>
to server.xml
2.9 Please refer to 1.7 to migrate the old values from conf/ida.properties to the ‘Settings’ page
2.10 Restart the IDA server to make your changes effective.