Upgrading (CLI)
How to upgrade the Anka Virtualization package
Pre-upgrade Considerations
Existing Version | Target Version | Recommendation |
---|---|---|
3.x | 3.3.9 | Please kill -9 the ankanetd process after upgrading to 3.3.9. Older 3.x versions had a bug that kept ankanetd running indefinitely and will cause 3.3.9 to have networking issues trying to use the older ankanetd . |
< 3.3 | 3.3 | Optional (ARM ONLY): Delete and re-pull VM templates to host machines to take advantage of new performance and smaller disk usage changes. |
< 3.x | 3.x |
|
< 3.x | 3.x (intel) |
|
Existing VM macOS Version | Target Version | Recommendation |
---|---|---|
<= Big Sur | Monterey | You will need to change your VM template: anka modify {vmName} set hard-drive -c sata , anka modify {vmName} set network-card -c virtio-net |
<= Big Sur | Ventura | You will need to change your VM template: anka modify {vmName} set hard-drive -c sata , anka modify {vmName} set network-card -c virtio-net , and anka modify {vmName} set custom-variable hw.x2apic 1 |
Monterey | Ventura | You will need to change your VM template: anka modify {vmName} set custom-variable hw.x2apic 1 |
<= Ventura | Ventura | (Intel only + 3.3.x) You will need to resuspend your Templates and push them to the registry. |
Upgrade Procedure
1. Download and install the latest version
Upgrading the Build Cloud too? Check out our upgrade procedure for the Anka Build Cloud Controller & Registry
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 NOT safe.
If you have the node joined to your Anka Build Cloud, the agent will restart itself in order to ensure it loads necessary components to support the new Anka version. You will see a message like Version change detected! Stopping runner
in the logs. Do not interrupt this processes as it is expected. Nodes may go offline temporarily.
2. Upgrade VM addons
If your existing version is noted in the Pre-Upgrade Considerations as requiring an addons upgrade, or, if you’re going between major/minor versions of Anka:
- Upgrade the guest addons inside existing VM Templates
anka start -u
. - Push the newly upgraded VM templates to registry with
anka registry push {vmNameOrUUID} --tag <newTag>