Create VMware Site

Objective

This document provides instructions on how to install Volterra single-node site or multi-node site on VMware ESXi. To know more about Volterra Edge Services, see About Volterra.

Using the instructions provided in this document, you can install a Volterra node by deploying a virtual machine from an Open Virtual Appliance (OVA) file containing the node as the appliance.


Prerequisites


Deploy Site

Perform the steps provided in the following chapters to deploy Volterra site on VMware ESXi.

Create Site Token

Step 1: Navigate to the system namespace.

Select the system namespace to obtain a token. You can use an existing token or create a new one. A site can be configured as single-node or multi-node site. In case of multi-node site, use the same token for all installations.

NameSpaceNavig
Figure: Navigate to Namespace

Step 2: Generate token.

Select Manage -> Site Management from the configuration menu and select Site Token from the options pane. Click Add site token to create a new token. This loads the Add site token form. Enter the site name and description in the Name and Description fields respectively. Click Add site token button at the bottom of the form.

CreateSiteToken
Figure: Create a site token

Step 3: Notedown the token.

Find the token you created or choose an existing token from the list of tokens displayed. Click the > to expand the token details in JSON format and note the value of the uid field.

SiteTokenUID
Figure: Find Site Token UID


Configure VMware ESXi Hypervisor

Step 1: Login to VMware-ESXi portal using the ESXi host IP address.

ESxiLogin
Figure: Login to VMware ESXi

Step 2: Configure the host.

HostCnf
Figure: Host Configuration

Step 3: Configure the Portgroup - Management Network with a single interface.

PortGrpMGNWCnf
Figure: Portgroup Management Network Configuration

Step 4: Configure the Portgroup - VM Network with a single interface.

PortGrpVMNWCnf
Figure: Portgroup VM Network Configuration

Step 5: Configure the virtual switch as per the following sample topology.

VirtL2Topo
Figure: Virtual L2 Topology


Install Volterra Node on VMware

Step 1: Select 'Create / Register VM' from 'Virtual Machines' section.

CreateVM
Figure: Create a Virtual Machine

Step 2: Select 'Deploy a virtual machine from an OVF or OVA file' from the options listed.

NewVM
Figure: Create a new virtual machine

Step 3: Enter 'Virtual Machine Name' and click to select or drag and drop the OVA file.
  • Name: Virtual machine name to be represented in VMware environment.
  • OVA or OVF file: Click to select or drag and drop the OVA file provided or downloaded in the step above into the box.

NameandGOSProps
Figure: Name and OVA image

Step 4: Select storage as required based on the storage available on the hypervisor host.

StorageSel
Figure: Storage Selection

Additional datastores can be created as necessary using the wizard as shown below:

Step 5: Configure the deployment options.

Configure as per the following guidelines:

  • Network Mappings: Select the port-group where the VM is going to be connected.
  • Disk provisioning: Select thin or thick provisioning - Default is thin provisioning
  • Power On automatically: If enabled it will power on the Virtual Machine as soon as the setup is complete and image uploaded - Default is enabled.

image13
Figure: Deployment options

Step 6: Enter additional settings.

These set of parameters enable the machine to boot up and request registration directly in your tenant. These settings also allow you to configure the static IP address. However, DHCP is used by default.

Note: The following are the only settings supported with the Volterra node Custom vApp properites.

  • Hostname: Specify the hostname for this device - example: master-0.

    Note: Ensure that host names are distinct and unique incase you are installing nodes for multi-node site.

  • Token: Volterra site token required for site generation.

    Note: The token should be created prior to using it in site creation. See Create Site Token for more information.

  • Cluster Name: Set the cluster name.
  • Name for outside network interface: eth0
  • DHCP support for outside network interface: yes. By default, this is set to yes. If you want to configure static IP addresses, then set this to no.
  • Role for outside network interface: public. By default, this is set to public as the interface will have internet access.
  • IP address/bitmask for network interface: empty by default. If DHCP was set to no then you can configure your static ip address here. Example: 10.1.1.1/24

    Note: Changing IP address for a registered node is not supported.

  • Default gateway for outside network interface: empty by default. If DHCP was set to no then you can configure the default gateway for your network here. Example: 10.1.1.254
  • Route destination(destination network) for outside network interface: empty by default. If DHCP was set to no then you can configure the destination here. Because this is the default gateway we can use 0.0.0.0/0. For specific setups, you can change the default destination
  • Primary DNS: empty by default. If DHCP was set to no then you can configure your DNS Server here. Example: 8.8.8.8
  • Secondary DNS: empty by default. If DHCP was set to no then you can configure your secondary DNS server here: Example: 8.8.4.4
  • Certified Hardware: The supported options are vmware-voltmesh, vmware-voltstack-combo, vmware-multi-nic-voltmesh, vmware-multi-nic-voltstack-combo.
  • Latitude: Enter latitude. This can also be specified during registration in VoltConsole.
  • Longitude: Enter longitude. This can also be specified during registration in VoltConsole.

additionals
Figure: Configure additional settings

Step 7: Complete the wizard.

image9
Figure: Complete the wizard

Step 8: The OVA gets uploaded, the virtual machine is built, and booted.
Step 9: Log on to the terminal of VM and perform initial configuration.
  • Enter admin as username and Volterra123 as the initial password. Update the password after first login as per the instructions displayed.
  • Perform inside network configuration as per the options displayed.
Step 10: Accept new registration.

Go to the Volterra portal and navigate to Manage -> Registrations in the system namespace. Click the accept icon.

image2
Figure: Accept new registration

Your new Volterra node is now provisioned and ready to be operated.

Note: In case you wish to change any of the settings for your node, see Update Node Settings.


Update Node Settings

You can change the node settings for an installed node or install a new node using a template.

Perform the following steps:

Step 1: Update the settings for an installed node.
  • Power off the VM.
  • Change the vApp properties in the vSphere/ESXi UI (see below).

vapp upd
Figure: Update Settings Using vApp Properties

  • Update the settings such as cluster, certified hardware, token, etc.
  • Perform factory reset and reboot the VM.
  • Perform the post install and registration steps as instructed in the previous chapter.
Step 2: Create OVF file to install a node through template.
  • Select your virtual machine and click File > Export to OVF.
  • Enter a name for the OVF file and specify a directory in which to save it.
  • Specify to export the virtual machine as an OVF.
  • Click Export to start the OVF export process.

You can customise the node settings using the OVF files saved and boot a VM using the OVF. Perform the post install and registration steps as instructed in the previous chapter.

Note: In case of changing the node from single-nic to multi-nic, it is required that you first create a template, add a new NIC, and update the Certified Hardware before performing factory reset and registration.


Volterra Concepts