Upgrading and Downgrading

The upgrade and downgrade processes are only performed on the Primary Coordinator. After the version of your Primary Coordinator is changed, all associated Agents and the Secondary Coordinator are automatically changed to the same version within a few minutes.

Note: For 3.17 and later, if you installed Incredibuild as an initiator only, you cannot downgrade to earlier versions that do not support initiator only machines.

Upgrading Incredibuild

Verify that there are no running builds. If there are running builds during the upgrade, they will be aborted.
Copy the installation file for the target version to your Coordinator machine:
```
incredibuild_<version>.ubin
```
Run the file with the upgrade flag. This must be done with a user who has root user permissions.

For example:
```
./incredibuild_<version>.ubin upgrade
```
Go to the Coordinator Monitor and verify that the Version column has been updated with the latest version. The Agents will detect that the Coordinator was upgraded and they will be automatically upgraded shortly.

Downgrading Incredibuild

Verify that there are no running builds. If there are running builds during the upgrade, they will be aborted.
Copy the installation file for the target version to your Coordinator machine.
```
incredibuild_<version>.ubin
```
Run the file with the upgrade flag (this flag is used for both upgrade and downgrade). This must be done with a user who has root user permissions.

For example:
```
./incredibuild_<version>.ubin upgrade
```
Go to the Coordinator Monitor and verify that the Version column has been updated with the appropriate version. The Agents will detect that the Coordinator was downgraded and they will be automatically downgraded shortly.