Upgrading Nutanix AOS When 1-Click Download Isn’t Available

This lesson will show you how to upgrade Nutanix AOS when the 1-click download option isn’t available. This might be due to not having internet access to the Nutanix cluster (e.g. dark site), or there is a new AOS version available but Nutanix hasn’t published the latest release to the 1-click download option yet (which is typically 3-4 weeks after general availability (GA) on the portal).

1-Click Upgrade

To access the 1-click upgrade option with Prism, select the "gear icon" (1) then choose "Upgrade Software" (2).

Uploading the AOS Base Software Manually

If you do not see any downloads available on this screen, you can still use the blue link that says "Upload the AOS base software binary" to upload the software to the cluster.

Once prompted, click on the "Choose File" links to browse your computer for the Metadata file (json format), and for the binary file (tar.gz format).

You can download these files from the Nutanix Customer portal, located at https://portal.nutanix.com

Then choose the "Upload Now" option. This will upload the files you have downloaded to the cluster.

Performing the Upgrade

Once the files have been uploaded to the cluster, choose the "Upgrade" option (1), then choose "Upgrade Now" (2). The "Upgrade Now" option will also perform the Pre-Upgrade steps, which verifies that the cluster satisfies the requirements for the upgrade.

In some releases, you will get the "Upgrade Notifications" screen which has some helpful guidelines for upgrading to the release you chose. Please review these notifications and make any changes that are necessary.

Once completed, choose "Continue" to proceed.

PreUpgrade Steps

The upgrade will then go through various pre-upgrade steps, which does several checks, including verification that the cluster meets the minimum requirements for the new software version.

AOS Software Upgrade

After the Pre-Upgrade Steps are completed, the AOS upgrade will continue. You will see that the software upgrade for all of the Controller Virtual Machines (CVM’s) in the cluster will progress in parallel, up to the point of needing a reboot. Then each CVM will reboot one at a time so that cluster health is maintained. Also of note, is that all of the user virtual machines on the host that has the CVM rebooting do not need to vMotion or live migrate to another host. The user virtual machines can stay on that host and data I/O will just be redirected to other CVM’s in the cluster.

For more information on that, please see the Nutanix Bible at the following links:
For AHV: http://nutanixbible.com/#anchor-storage-i/o-path-112
For ESX: http://nutanixbible.com/#anchor-cvm-autopathing-aka-ha.py-131

You might also lose access to Prism during this step, normally when the CVM that you are connected to via the cluster virtual IP (VIP) gets rebooted. Just refresh/reload your browser and the VIP will redirect to a different CVM that is currently up.

Upgrade Successful

Once each of the CVM’s are upgraded and rebooted, the upgrade is complete! Congrats! 😉

Scroll to Top