Lab Management Upgrade Issues

Users lost when upgrading AIQ despite copying Appvance.properties file to the new AIQ install

If you Appvance IQ to a new version, and also had users created in a previous version of AIQ, and want to retain those settings, If you just copied the Appvance.properties file from the root directory from the previous install and replaced the file in the new install of AIQ, you will be unable to login with an existing user. Additional steps are required.

Resolution

In addition to replacing the Appvance.properties file, you should also replace the realm.properties file which is located in the path \aiq\TestNode\etc\.

Copy the file realm.properties file from the previous install and replace the one in the new installation of AIQ install to resolve this issue.

About the realm.properties file

File Location: \aiq_distribution\ TestNode \etc\realm.properties

This file holds encrypted details of Appvance users and their respective passwords created from the User Management tab ( Global Options > Admin Options > User Management > Export Users).

About the Appvance.properties file

File Location: \aiq_distribution\Appvance.properties

This file holds encrypted details of

• Appvance usage
• Configured Repository details
• APM Configurations
• Jira Integration configuration
• Any cloud configurations
• Internal Monitoring
• Sending Notification email configuration
• History of scenario executed
• AIQ Database configuration
• Report Template configuration

Downgrade Considerations and Issues

If you have a situation where you need use a previous version of AIQ for some reason, it is required that you create a new instance of the legacy version of AIQ.

Do not downgrade an existing AIQ version to a previous version. Features and settings in the newer AIQ configuration files may not be supported in previous versions of AIQ.

Prerequisite Preparations

1. In your current AIQ server, go to Global Options > Admin Options > User Management > Export Users to create a .csv file containing a list of AIQ users that can be imported into the legacy AIQ version that you will be installing.

2. Download the license.lic file from the installation folder in your current AIQ server. This same license file can be used with the legacy AIQ server that you will be installing.

Moving from 5.x to 4.10.x

Setting up a legacy 4.10.x AIQ server requires the creation of a new database compatible with 4.10.x. This is because the 4.10.x and 5.x database versions are not compatible.