Upgrading

How to upgrade the Anka Virtualization package

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

Upgrading Anka Virtualization software while VMs are running is safe

Upgrading macOS VM inside Anka VM: Avoid using the System Preference installer to update macOS inside Anka VM. Use the softwareupdate -Ri command line tool to upgrade macOS inside Anka VM. Stop the VM and then restart it

Upgrade Procedure (without Anka Build Cloud Controller & Registry)

  1. Download and install the latest version

If your existing version is noted in the Pre-Upgrade Considerations:

  1. Upgrade the guest addons inside existing VM templates with anka start -u
  2. Push the newly upgraded VM templates to registry with anka registry push {vmNameOrUUID} --tag <tag>

Upgrade Procedure (with Anka Build Cloud Controller & Registry)

Pre-Upgrade Considerations

Existing VersionTarget VersionRecommendation
1.4.32.x.xRequires upgrade of all existing VM templates with anka start --update and push to the registry
2.x2.1.2Only requires upgrade of existing Catalina VM templates with anka start --update and push to the registry

Last modified November 20, 2020 : better upgrade documents (b2af666) by Nathan Pierce