Create a Site

Objective

This guide provides instructions on how to create a Volterra Site in your cloud or edge location. A Volterra site consists of one or more Volterra nodes. To know more about sites and nodes, see Volterra Site.

Using the instructions provided in this guide, you can create a single-node site or multi-node site.


Prerequisites

A valid VES account is required.

Note: In case you do not have an account, see Create a VES Account.


Configuration

The following figure shows the sequence of steps in creating a Volterra Site:

SiteCreatFlow
Figure: Setting up a Volterra Customer Site

Configuration Sequence

A site can be configured as a single-node or multi-node site and includes performing the following sequence of actions:

Phase Description
Create Site Token Token is used to initiate site provisioning and it can be reused per tenant across namespaces. However, it is recommended to use the same token for installation of additional sites.
Install Volterra Nodes Site consists of one or more Volterra Nodes. Therefore, installing at least one Volterra Node is required.
Accept Site Registration Installing a node triggers site registration and requires you to approve the site from the Volterra SaaS portal.

Create Site Token

Step 1: 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: Select Manage 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: 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

Install Volterra Nodes

Step 1: Prepare site configuration data. This data is used during the node installation. The following example shows a sample site configuration.

  • Site Name: volterra-demo-site
  • Latitude and longitude (co-ordinates): 41.881832, -87.623177
  • Token: e305f21e-b14a-44f0-8c93-776489321819

Step 2: Install the node. For instructions, see Install section and choose an appropriate installation guide depending on your cloud provider or edge hardware.


Accept Site Registration

Single-node Site

Step 1: Log in to the Volterra Console with your tenant and select Manage from the configuration menu. Select Registrations from the options pane and choose your site in the displayed list of sites. Click ✅ to load the Registration Acceptance form.

AcceptReg
Figure: Accept Pending Registration

Step 2: Enter the site configuration parameters and click Accept.

SiteParam
Figure: Configure Site Parameters

Step 3: Select Sites -> Site List and click on your site from the displayed site list to see the dashboard for your site.

HealthCheck
Figure: Site Health Check

Note: After you accept the registration, it takes few minutes for the health and connectivity status to get updated in the portal.

Multi-node Cluster Site

Step 1: Accept registration requests from the master-0, master-1, and master-2 nodes. Enter the same values for the following parameters for all the registration requests.

  1. ‘Cluster name’ = ‘volterra-demo-site-mce’
  2. ‘Cluster size’ = ‘3’

    RegReqM-0
    Figure: Registration request from ‘master-0’ node

    RegReqM-1
    Figure: Registration request from ‘master-1’ node

    RegReqM-1
    Figure: Registration request from ‘master-2’ node

Step 2: Select Sites -> Site List and click on your site from the displayed site list to see the dashboard for your site.

SiteDashBrd
Figure: Volterra Site Dashboard

Note: After you accept the registration, it takes few minutes for the health and connectivity status to get updated in the portal.


Edit Site

You can edit the site configuration by performing the following:

Step 1: Log in to the Volterra Console with your tenant and Select Sites -> Site List. Find the site you want to edit and click ... -> Edit. The site edit form gets loaded.

EdSite
Figure: Edit Site

Step 2: Set the site configuration parameters according to your requirement and click Save Changes.

SiteCnfEd
Figure: Edit Site Configuration Parameters

In case of configuring the VIP addresses, you must choose from the reserved addresses. The system reserves addresses as per the following mechanism of DHCP subnet Prefix Length (PL):

Prefix Length (PL) Reserved Addresses
PL <= 25 The last 8 addresses of the subnet range are reserved and the last address is set as broadcast address. Therefore, you can select from the rest of the 7 addresses.
PL <= 27 The last 4 addresses of the subnet range are reserved and the last address is set as broadcast. Therefore, you can select from the rest of the 3 addresses.
PL <= 29 The last 2 addresses of the subnet range are reserved and the last address is set as broadcast. Therefore, you can only select the other address.

Table 1: Reserved VIP Addresses

Auto-Scaling

You can also configure scaling for your sites after registering. Perform the following to setup auto-scaling.

Step 1: Select Sites from the configuration menu and Site List from the options pane. Locate your site, click ..., and click Edit. Enter a value in the Desired Pool Count field to set the scale. Click Save changes.

AutoScale
Figure: Desired Pool Count Setting

Step 2: Select Manage from the configuration menu and Registrations from the Site Management in the options pane. Click the Pending Registrations tab and approve the pool nodes.

Note: Individual nodes are not visible from the site list for multi-node site. However, you can check the nodes in the Other Registrations tab.


Remove Site

To remove site, perform the following in the System namespace.

Step 1: Select Manage from the configuration menu and Registrations from the Site Management in the options pane. Select your site from the Other Registrations tab. Click ... and Decomission for your site. Click Decomission in the confirmation window.

Decomission
Figure: Decomission the Site

Note: In case of multi-node sites, perform this step for each of the node.

Step 2: Select Sites from the configuration menu and Site List in the options pane. Select your site from the list of sites and click ... -> Edit for your site. In the edit form, click Delete Site. Click Decomission in the confirmation window.

DeleteSite
Figure: Delete the Site

Note: Removing the site does not delete the node in your cloud or physical locations. To remove your node from your cloud or physical device, follow the instructions provided in the Install guides.


Concepts


API References