Upgrading

How to upgrade the Anka Build Cloud

We follow semantic versioning; minor and major version increases can have significant changes.

Upgrade Procedure

When upgrading the entire Anka Build Cloud Software, execute these steps in the following sequence:

  1. Run sudo ankacluster disjoin on your nodes

  2. Install the latest Anka Build Virtualization CLI

  3. (only needed if noted in the CLI notes matrix) Upgrade the guest addons inside existing VM templates with anka start -u, then push the newly upgraded VM templates to registry with anka registry push {template} --tag <tag>

  4. Go to your Controller & Registry and upgrade to the latest version: [ Linux Guide OR MacOS Guide ]

  5. Run curl -O http://anka.controller:8090/pkg/AnkaAgent.pkg && sudo installer -pkg AnkaAgent.pkg -tgt / on your nodes to pull the latest Anka Agent binary and ensure proper communication between the CLI and the Controller API.

Anka Build Cloud upgrade note matrix

Existing VersionTarget VersionRecommendation
1.2.11.5.2Upgrade Anka CLI package on all the hosts to atleast 2.1.X
1.2.11.5.2Recommended to upgrade Anka Registry to version 1.5.2, if you want to use cache builder
1.2.11.5.2Recommended to upgrade Anka Jenkins Plugin to version 1.22.2
1.2.11.5.2Recommended to upgrade Anka TeamCity Plugin to version 1.7.0
Existing VersionTarget VersionRecommendation
1.3.01.5.2Upgrade Anka CLI package on all the hosts to atleast 2.1.X
1.3.01.5.2Recommended to upgrade Anka Registry to version 1.5.2, if you want to use cache builder
1.3.01.5.2Recommended to upgrade Anka Jenkins Plugin to version 1.22.2
1.3.01.5.2Recommended to upgrade Anka TeamCity Plugin to version 1.7.0
Existing VersionTarget VersionRecommendation
1.4.01.5.2No need to upgrade Anka CLI package on hosts
1.4.01.5.2Recommended to upgrade Anka Registry to version 1.5.2, if you want to use cache builder
1.4.01.5.2Recommended to upgrade Anka Jenkins Plugin to version 1.22.2 but not necessary
1.4.01.5.2Recommended to upgrade Anka TeamCity Plugin to version 1.7.0 1.22.2 but not necessary
Existing VersionTarget VersionRecommendation
1.5.01.5.2No need to upgrade Anka CLI package on hosts
1.5.01.5.2Recommended to upgrade Anka Registry to version 1.5.2, if you want to use cache builder
1.5.01.5.2Recommended to upgrade Anka Jenkins Plugin to version 1.22.2, but not necessary
1.5.01.5.2Recommended to upgrade Anka TeamCity Plugin to version 1.7.0, but not necessary

Last modified August 24, 2020 : curl command to get the latest Anka Agent (6f55558) by Nathan Pierce