Upgrading

How to upgrade the Anka Virtualization package

We do not follow strict 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 Anka supports softwareupdate and also the System Preferences method of upgrading.

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

Upgrading macOS inside of a running VM

This scenario is possible, however, it's recommended that you upgrade Anka addons before upgrading macOS.


Last modified January 11, 2021 : 2.3.2 (1234a63) by Nathan Pierce