vSphere type host creation guide


  • Make sure time is in sync on all esxi hosts in the cluster will be used by Cello otherwise deployment may fail due to certificate expiry check.
  • Cello vSphere agent is tested on vSphere deployments with vCenter, single node vSphere without vCenter is not supported.
  • Deployment requires DHCP server in the VM network.(If you create VM that use VM network and it can get IP automatically which mean it has a DHCP server)
  • vCenter user with following minimal set of privileges is required.
  • Datastore > Allocate space
  • Datastore > Low level file Operations
  • Folder > Create Folder
  • Folder > Delete Folder
  • Network > Assign network
  • Resource > Assign virtual machine to resource pool
  • Virtual machine > Configuration > Add new disk
  • Virtual Machine > Configuration > Add existing disk
  • Virtual Machine > Configuration > Add or remove device
  • Virtual Machine > Configuration > Change CPU count
  • Virtual Machine > Configuration > Change resource
  • Virtual Machine > Configuration > Memory
  • Virtual Machine > Configuration > Modify device settings
  • Virtual Machine > Configuration > Remove disk
  • Virtual Machine > Configuration > Rename
  • Virtual Machine > Configuration > Settings
  • Virtual machine > Configuration > Advanced
  • Virtual Machine > Interaction > Power off
  • Virtual Machine > Interaction > Power on
  • Virtual Machine > Inventory > Create from existing
  • Virtual Machine > Inventory > Create new
  • Virtual Machine > Inventory > Remove
  • Virtual Machine > Provisioning > Clone virtual machine
  • Virtual Machine > Provisioning > Customize
  • Virtual Machine > Provisioning > Read customization specifications
  • vApp > ImportProfile-driven
  • storage -> Profile-driven storage view


Note :

The vSphere agent is tested on vCenter 6.0 and vCenter 6.5

Upload VM image to be used to vSphere:

Upload the template OS OVA to vCenter before create vSphere type host in Cello. The work nodes that run the fabric workloads will be cloned from this VM template.

Upload using vSphere Client.

  1. Login to vSphere Client.
  2. Right-Click on ESX host on which you want to deploy template.
  3. Select Deploy OVF template.
  4. Copy and paste URL for OVA for Cello
  5. Please deploy the ova on the same cluster which will be planned to be used by cello later
  6. Check the name of the VM created , this will be used to create vSphere type host in Cello later. (Should default to PhotonOSTemplate.ova)

This OVA is based on Photon OS(v2.0)


If you do power it on, future clones of this VM will end up getting the same IP as the imported VM. To work around this run the following command before powering the VM off.

echo -n > /etc/machine-id

Add vSphere type host

Login to Cello and navigate to the Hosts->Add Host

In the "Add a host" page select "Host Type" as VSPHERE

select vsphere

Give a name of the vSphere host like "cello-vsphere", you can specify a capacity number, this number can be configured later. Click "Next"

basic setting

In the VC address field input your VC IP address, if your VC use some port other than 443, you should add the port eg.

In the VC user field input a username with the privileges as described in Prerequisites.

In the VC network field enter the network name.

In the Datacenter field enter the datacenter name.

In the Cluster field enter the cluster name that will be used for Cello, this cluster need to belong to the datacenter entered in the Datacenter field.

In the datastore field, enter a datastore that all the esxi hosts in the cluster can be reachable.

vc setting

In the VM IP field enter a static IP address that belong to the VM network.

In the VM Gateway filed enter the VM network gateway.

In the VM Netmask field enter the network mask for the VM network.

In the VM DNS filed enter the DNS for the VM network.

In the VM template field enter the template name (If you don't change the name it will be PhotonOSTemplate.ova by default)

vm setting

Click Create. You will see the follow page.

. vc pending

This means that the vSphere agent is trying to create a new work node. This will take several minutes which is depend on your esxi host's resource and network speed. After the node created it will automatically download the farbic 1.0 images to the work node. When everything is ready the new host will be in active state.

vc active