Upgrade Nutanix CE to the latest version

In this quick article we’ll review the simple steps on how to upgrade Nutanix to the latest version. In particular I will be using a Nutanix CE version nested into VMware. The steps pretty much apply also to the other Nutanix flavours sitting on the Hardware versions as well. To upgrade Nutanix platform is a very easy and simple process.

This is the beauty of the Software-Defined approach intrinsic to the HyperConverged platforms where Nutanix is offering good options by making the “infrastructure invisible”.

The entire process can be run through the command line and the GUI. Definitely the latter is a lot easier to use. When deploying upgrades though the Prism GUI such updates are called 1-click upgrades.

In this article we’ll see the steps to upgrade the Acropolis OS (AOS) and Acropolis Hypervisor (AHV).


Upgrade Nutanix Acropolis to latest version

Generally speaking each node in the cluster runs AOS. It is essential to have all nodes to the same version. When upgrading one Node all the other ones are still running the VMs and other operations. In addition Nutanix platform provides a live upgrade mechanism which runs in the background and allows to carry on with the rest of the operations hence running the cluster continuously. In our example this installation is a single node cluster installation.

One nice feature with regards to the AOS upgrade is that the new installer will check the RAM Memory on the Node Host. When this one has more than 64 GB the installer will automatically increase the RAM Memory to the Controller VM (CVM) running on that Host by 4 GB increments to a maximum of 32 GB. Less than 64 GB of Memory RAM on the Node Host will not change memory settings on the Host.

Another thing to take into consideration is that the AOS upgrade will restart the Cluster. So when working with a single Node cluster the Prism environment might become unresponsive.

As a last prerequisite before proceeding let’s make sure to Nutanix Cluster has access to the internet and in particular to the following addresses:

  • *.compute-*.amazonaws.com:80
  • release-api.nutanix.com:80

Such addresses will allow the download of the updates. In our case we’ll provide such updates manually. At this point we are ready to start.

From the Home > Settings > Upgrade Software we can start the wizard to upgrade Nutanix platform components. The first one in this case to upgrade is the Acropolis OS (AOS). We can have the automatic download of the software for the AOS. New downloads will appear here.

domalab.com Upgrade Nutanix AOS

Alternatively we can provide manually the Binary and the pertinent Metadata file. We can download them from Nutanix Next Portal.

domalab.com Upgrade Nutanix AOS slect files

At this point let’s provide the pointers to the Metadata file and the Binary as shown in the screenshot below.

domalab.com Upgrade Nutanix choose AOS file

If a valid file the wizard will start uploading and showing the relative version.

domalab.com Upgrade Nutanix latest version upload

After the file upload we can run the procedure to upgrade Nutanix. As per picture below can choose between a Pre-upgrade and Upgrade Now options.

domalab.com Upgrade Nutanix pre-upgrade

Let’s go for a Pre-upgrade check and confirm the selection.

domalab.com Upgrade Nutanix run pre-upgrade

The wizard will now emulate the upgrade steps and show details. Depending on hardware this procedure can take quite a while. For the inpatients there’s a nice surprise under the Nothing to do link!

domalab.com Upgrade Nutanix pre-upgrade status

At this point assuming we had no errors we can repeat the same steps and proceed with the real upgrade.

domalab.com Upgrade Nutanix now

In a similar fashion the screenshot below shows the Nutanix upgrade status.

domalab.com Upgrade Nutanix status

And this screenshot below concludes this first part to upgrade Nutanix AOS. Next step is the AHV component.

domalab.com Upgrade Nutanix upgrade summary


Upgrade Nutanix Acropolis Hypervisor AHV

To upgrade Nutanix Acropolis Hypervisor (AHV) to the latest version we can re-run pretty much the same steps we have seen for the Nutanix AOS.

domalab.com Upgrade Nutanix AHV

Let’s point to the the correct AHV update Binary and Metadata files as per screenshot below.

domalab.com Upgrade Nutanix AHV select files

And upload such files to the Nutanix file system. By default these files are located in /home/nutanix/software_downloads/ on the current CVM.

domalab.com Upgrade Nutanix AHV upload

As per the AOS also in the case of the AHV Hypervisor we have the option to run a pre-upgrade action.

domalab.com Upgrade Nutanix AHV pre-upgrade

Let’s confirm and continue.

domalab.com Upgrade Nutanix AHV pre-upgrade confirm

The wizard is now running the pre-upgrade checks and flag any issue that might be encountered. To make the process to upgrade Nutanix components even smoother I would recommend to upgrade the Nutanix Cluster Check component (NCC) currently at and run this one from the command line before any upgrade. We’ll dedicate an article to this topic.

domalab.com Upgrade Nutanix AHV pre-upgrade status

At this point we are ready for the actual upgrade of the Nutanix AHV component.

domalab.com Upgrade Nutanix AHV upgrade now

Let’s confirm and proceed.

domalab.com Upgrade Nutanix AHV upgrade confirm

The wizard runs a pre-ugrade and then an upgrade action showing the steps as per screenshot below.

domalab.com Upgrade Nutanix upgrade summary


Restarting Cluster after upgrade Nutanix procedure

After upgrading the Nutanix AHV we need to restart the the Nutanix Cluster before accessing to Prism GUI. As the screenshot is showing all cluster services are down. It couldn’t be any easier. All we have to do is to open an SSH session to the Controller VM (CVM) and issue the command:

“cluster start”

domalab.com Upgrade Nutanix cluster status

After a few seconds all the Nutanix cluster services are up and running. We can now access the Prism GUI.

domalab.com Upgrade Nutanix cluster start

Upgrade Nutanix final notes

The process to upgrade Nutanix is very straight forward. At the time of writing the latest version for the Nutanix Community Edition is 2018.01.31.

If you are running Nutanix CE nested into VMware the upgrade option might not work as expected and produce errors. This is due to a configuration in the new version. The good news is that the Community managed to identify the issue from the error logs and propose a solution. That solution is working and will be addressed as an update in the next release of the Nutanix Community Edition.

The next screenshots show the issue. Essentially the Controller VM fails to start. The same issue can be reproduced with a clean install.

domalab.com Upgrade Nutanix cvm not running

All we have to do to solve this issue is to edit the Default.xml file located in:


We can use the nano utility.

domalab.com Upgrade Nutanix cluster configuration file

First thing is to change the value on the 8th line:

  • from: pc
  • to: pc-i440fx-rhel7.2.0

domalab.com Upgrade Nutanix cluster config pc

New value for “pc”.

Next is to add <pmu state=’off’/> under the <pae/> option as per screenshot below.

At this point we can save the file and exit.

domalab.com Upgrade Nutanix cluster disable pmu

On the login let’s enter “install” and repeat the procedure. The end result now looks more promising!

domalab.com Upgrade Nutanix cluster re-install

In fact we can now list the CVM instance running with command:

“virsh list –all”

domalab.com Upgrade Nutanix cluster list cvm

A big thank you to all the users in the Nutanix Community (requires free registration to access the link https://next.nutanix.com/discussion-forum-14/impossible-to-deploy-ce-5-5-nested-on-vmware-vsphere-6-5-27459) who spotted and managed to solve this issue. So we can get the latest goodies from Nutanix CE platform in our home lab!

Michele Domanico

Passionate about Virtualization, Storage, Data Availability and Software Defined Data Center technologies. The aim of Domalab.com is sharing with the Community the knowledge and experience gained with customers, industry leaders and like minded peers. Always open to constructive feedback and new challenges.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: