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 and Downgrading Incredibuild

Both upgrading and downgrading are performed using the same command. If Incredibuild detects that the version of the installer you are using is earlier than your current version, a downgrade will be performed. If the installer is using a later version than your current version, an upgrade will be performed.

Note that this procedure is not correct when downgrading from 4.x to 3.x. In that case, see the procedure below.

  1. Verify that there are no running builds. If there are running builds during the upgrade, they will be aborted.

  2. Copy the installation file for the target version to your Coordinator machine.

  3. Run the installation file. This must be done with a user who has root user permissions.

    You can use the --accept-eula flag to pre-approve the end user license agreement, and opt-out of data collection during this process by adding the --disable-telemetry flag to the installation or upgrade command. For more details, see telemetry.htm

    sudo incredibuild-<version>.run --action upgrade --accept-eula true

  4. Go to the Coordinator Manager's help menu and verify that the version was changed.

Downgrading from Version 4.x to 3.x

  1. Verify that there are no running builds. If there are running builds during the upgrade, they will be aborted.

  2. Copy the installation file for the target version to your Coordinator machine.

  3. Uninstall Incredibuild Manager using the following command

    sudo /opt/incredibuild_management/ib_manager/uninstall

  4. Run the 3.x installation file. This must be done with a user who has root user permissions.

    You can use the -P flag to pre-approve the end user license agreement, and opt-out of data collection during this process by adding the -T flag to the installation or upgrade command.

    sudo ./incredibuild_<version>.ubin upgrade -P

  5. Go to the Coordinator Manager's help menu and verify that the version was changed.