Skip to main content

How to upgrade Appvance IQ Controller & TestNodes

Describes how to use Lab Management to upgrade an Appvance IQ Controller and its TestNodes.

If upgrading from 4.0.x to 4.1+, do not use Lab Management as described below. Instead please see Manual Upgrade Steps.Steps.

IMPORTANT: Mac OS X Servers / Linux Controllers

DO NOT use the Lab Management upgrade method to upgrade a Linux AIQ Controller which uses the /etc/systemd/system service. Lab Management only supports Linux upgrades where /etc/rc.local startup script is used. See Manual Upgrade Steps.

1. Create a Grid Configuration File

  1. Browse to Appvance IQ and login using an admin-level account
  2. Click Global Options and select Cloud Config
  3. Select the Grid Configuration tab

Controller

  1. Enter http://localhost:8080/TMServer/ws/Testnode in the Grid Machines box and press Enter
  2. Click Save, and save the Controller Grid Configuration file

TestNode

  1. Click Refresh to clear the form, select Grid Configuration again
  2. Enter http://<test-node-dns>:8080/TMServer/ws/Testnode in Grid Machines
  3. Press Enter. To add more machines, click Add Machine
  4. Click Save, and save the TestNode Grid Configuration file

2. Configure Lab Management

  1. Click Global Options, Admin Options (Lab Management tab)
  2. Click Add Cloud
  3. Enter a name in Cloud config name, select Grid in Type
  4. For each config file: click Browse, select the grid config file, click Save
  5. Select a Cloud to see all systems in the Machines list

3. Upgrade using Lab Management

  1. Click Global Options, Admin Options (Lab Management tab)
  2. Select a cloud location to upgrade in List of Clouds
  3. Tip: Upgrade Controller before TestNodes
  4. Confirm Machine Status displays Available
  5. If Machine Status displays Invalid Login, click the refresh icon
  6. Click Upgrade to begin
  7. Type UPGRADE (case-sensitive) in the confirmation box
  8. When complete, the version will reflect the new build
Back to top