Create VMware Site
On This Page:
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.
Note: If you do not have an account, see Create a Volterra Account.
- VMware vSphere Hypervisor (ESXi) 4.0 or later. The examples in this document are based on the version 6.7u2.
- At Least one interface with internet reachability
Volterra VMware OVA image
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.
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.
Step 2: Generate token.
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
Description fields respectively. Click
Add site token button at the bottom of the form.
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
Configure VMware ESXi Hypervisor
Step 1: Login to VMware-ESXi portal using the ESXi host IP address.
Step 2: Configure the host.
Step 3: Configure the Portgroup - Management Network with a single interface.
Step 4: Configure the Portgroup - VM Network with a single interface.
Step 5: Configure the virtual switch as per the following sample topology.
Install Volterra Node on VMware
Step 1: Select 'Create / Register VM' from 'Virtual Machines' section.
Step 2: Select 'Deploy a virtual machine from an OVF or OVA file' from the options listed.
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.
Step 4: Select storage as required based on the storage available on the hypervisor host.
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.
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: 220.127.116.11
- Secondary DNS: empty by default. If DHCP was set to no then you can configure your secondary DNS server here: Example: 18.104.22.168
- Certified Hardware: The supported options are
- Latitude: Enter latitude. This can also be specified during registration in VoltConsole.
- Longitude: Enter longitude. This can also be specified during registration in VoltConsole.
Step 7: 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.
adminas username and
Volterra123as 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.
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).
- 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
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 Hardwarebefore performing factory reset and registration.