# 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](https://docs.appvance.net/Content/AIQ/Getting_Started/Manual_Upgrade_Steps.htm).

<div id="bkmrk-important%3A-mac-os-x-" style="background:#fff3cd;border:1px solid #ffc107;padding:10px;border-radius:4px">**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](https://docs.appvance.net/Content/AIQ/Getting_Started/Manual_Upgrade_Steps.htm).

</div>## 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