Nutanix basics – create Nutanix cluster

How to create Nutanix cluster

At the beginning few words about what is Nutanix cluster itself. The base brick of each of the Nutanix cluster is Nutanix node. Each node in the cluster contains memory, CPU, RAM and storage  (both SSD and HDD). SSD is performance tire and HDD capacity tier. Each node in the cluster runs standard hypervisor such as:

  • VMware vSphere
  • Microsoft Hyper-V
  • KVM

On each cluster node runs controller VM (called CVM or SVM) enabling the pulling of local storage from all nodes in the Nutanix cluster. Nutanix CVM is a custom build CentOS runs Nutanix OS which is the “brain” of the whole solution.  Together a group of Nutanix nodes (hardware + CVM + NOS) forms Nutanix Distributed File System (NDFS).



Create Nutanix cluster – WEB UI

After deployment of the cluster, how to do it you can find out by reading below two articles:

Web UI Open web browser and type http://CVM_IP_ADDRESS:2100/cluster_init.html On the bottom of the age you should see all nodes which are not a part of any cluster. Mark them all. Provide all required information and click on Create.

Cluster configuration

Cluster configuration

Follow up log and look for entry cluster successfully initialized 

To make  sure that cluster is in a good state, lg in to one of the CVMs and run command: cluster status . As an output you should see status of Nutanix applications on all CVM in the NOS cluster. All of them must be in UP status. If you see it differently, wait few more minutes and type cluster status command again. If it didn’t help, stop cluster – cluster stop – command, wait few minutes, check cluster status – cluster status – all services on all CVM should be in DOWN status and type cluster start command again. This should fix a problem.

Create Nutanix cluster – manually

If you prefer to use command line – you can create Nutanix cluster as well.

Log in to one of the CVM controllers over ssh and type:

Replace cvm_ip_addrs by comma separated IP from all CVM


Create Nutanix cluster – manually – set cluster parameters 

As you probably noticed already some differences between Web UI  and command line. Now we have to supply missing parameters through command line.

Nutanix cluster name

 Add DNS servers

DNS server comma separated

Configure NTP servers

NTP server IP addresses comma separated

Create cluster external IP address

[box type=”info”] This parameter is mandatory for Hyper-V deployment and optional for vSphere and KVM.[/box]

If you run Hyper-V as hypervisor make sure that external IP address has its entry in DNS servers.


UPDATE 16/03/2016

After almost two years, there is a time for small update on how to create Nutanix cluster. Since Acropolis Base Software (former name NOS) in version 4.5.X there is a new way of creating Nutanix cluster – using Nutanix foundation.

Requirements are:

  •  Acropolis Base Software (former name NOS) on version 4.5 or newer
  • workstation you are working from must be within the same subnet domain as your Nutanix blocks are
  • IPv6 enabled on workstation

First what you have to do is download from installation bundle from the Foundation download page. Run applet and you should see new blocks discovered, like on the printscreen below.

Foundation java applet

Nutanix Foundation – java applet

Step 1 – you have to choose nodes\blocks for imaging – remember – 3 nodes is a minimum number of node to create Nutanix cluster.


Nutanix Foundation – choose nodes to image

In Step 2 – define cluster – provide necessary information for cluster configuration


Nutanix Foundation – cluster configuration

Step 3 – assign host names, IP addresses for hypervisor , CVMs – to proceed click validate network button


Nutanix Foundation – IP addresses

Step 4 – SKIP this step (bottom right corner) – we do not want to re-image nodes


On next screen you will see information from Nutanix foundation about cluster creation. After few minutes you should be able to log in to Prism Element.

Create Nutanix cluster

Create Nutanix cluster

Artur Krzywdzinski

Artur is Consulting Architect at Nutanix. He has been using, designing and deploying VMware based solutions since 2005 and Microsoft since 2012. He specialize in designing and implementing private and hybrid cloud solution based on VMware and Microsoft software stacks, datacenter migrations and transformation, disaster avoidance. Artur holds VMware Certified Design Expert certification (VCDX #077).