Troubleshoot Lab Management Upgrade Issues

Users

Troubleshoot lostLab Management Upgrade Issues

Use this article when upgradingLab Management resources behave unexpectedly after an AIQ despiteupgrade. copyingStart Appvance.propertiesby fileconfirming towhether the newissue AIQis installdata migration,

Ifpermissions, younode/device Appvanceavailability, IQ toor a newstale version,browser/session state.

Common checks

• Confirm the upgrade completed successfully and alsoreview hadmigration userslogs createdfor inwarnings.
• Verify that labs, devices, nodes, and resource groups still appear with the expected names and assignments.
• Check user roles and permissions for teams that can no longer access lab resources.
• Confirm nodes and devices are online and registered after the upgrade.
• Clear stale browser sessions only after confirming the backend data is correct.

Resolution workflow

1. Capture the affected lab name, user, node/device, and exact symptom.
2. Compare the resource record with a previousknown-good versionenvironment ofor AIQ,backup andwhen wantavailable.
3. Run toa retainsmall thoseexecution settings, If you just copiedagainst the Appvance.propertiesaffected filelab fromresource.
4. Document theany rootmanual directorycorrection fromor thesupport previous install and replaced the fileescalation in the newchange install of AIQ, you will be unable to login with an existing user. Additional steps are required.

   Resolution

   notes.

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

 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.

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.