Create VoltStack Site

Objective

This document provides instructions on how to install Volterra single-node or multi-node VoltStack sites on clusters of private Data Center (DC) devices. VoltStack site is a Volterra CE site engineered specifically for the purpose of managing DC clusters. To know more about Volterra sites, see Volterra Site. Volterra also supports creating physical K8s (also called as managed K8s) clusters for managing your applications on the created VoltStack sites. See Create and Deploy Managed K8s for instruction on creating the managed K8s clusters.

Clusters of private DCs that are setup on geographically separated locations require to establish direct communication with each member of the cluster. VoltStack site helps achieving that while ensuring safety and reliability. User can define a DC cluster group in VoltStack site to which member nodes can be added dynamically. Such added members become part of the cluster group and automatically get full mesh connectivity with all other members of the group.

Using the instructions provided in this document, you can deploy a single-node or multi-node VoltStack site on your private DC, define a cluster group, and add members to the cluster group. You can also enable the local API access for the managed K8s running on the sites so that it can be used like regular K8s.


VoltStack Site vs Other CE Sites

The VoltStack site differs from the regular Volterra CE site that can be deployed with VoltStack. VoltStack site simplifies the task of managing distributed apps across DC clusters while offering option to establish full mesh connectivity among themselves. In case of regular sites with VoltStack functionality, you will need to explicitly create and manage site mesh groups for that purpose. With VoltStack site, you just need to add the site to the DC cluster group and automatically connectivity is established.

Also, VoltStack site provides support to manage local K8s while controlling communication between services of different namespaces. While regular Volterra sites provide virtual K8s (vK8s), the vK8s is per namespace per site and managed local K8s is deployed across all namespaces of a VoltStack site with a single kubeconfig. Therefore, in case you require to manage distributed apps with across your private DC clusters with full mesh connectivity, VoltStack site with managed K8s is useful. In case of other requirements, you can use regular CE sites.


Reference Architecture

This reference architecture shows the recommended practice for setting up geographically distributed DC clusters using the Volterra VoltStack sites, privately connecting them using DC cluster group, and enabling managed K8s for deploying apps in those clusters.

The following image shows a sample reference architecture of the VoltStack DC cluster site.

voltstack site ref
Figure: VoltStack DC Cluster Site Reference Architecture

The DC clusters represent VoltStack sites. These consist interfaces towards storage network, interfaces in LACP towards DC switches, and dedicated or non-dedicated management interfaces. VoltStack site supports storage classes with dynamic PVCs. Bonded interfaces are also supported with bond interfaces for regular use in case of dedicated management interface. In case of non-dedicated management interfaces, the fallback interface for internet connectivity in a bonded interface must be assigned with a static IP address. The example image also shows TOR switches that can be connected with a single bond interface using MC-LAG or with 2 bond interfaces at L3 level. VoltStack site also supports establishing BGP peering with the TORs.

Bonding of interfaces is supported in LACP active/active or active/backup modes.

The following image shows sample reference deployment of VoltStack DC cluster sites that are deployed at different geographies.

dc cluster sites
Figure: VoltStack DC Cluster Site Reference Deployment

The apps deployed in the managed K8s clusters in these sites can directly communicate with each other in CI/CD use cases or users can obtain access to managed K8s API using the Kubeconfig.

The following image shows service interaction for service deployed in different DC cluster sites:

srv inter dc
Figure: Service Communication Between Clusters of Different DCs

The following image shows service interaction for service deployed in the same DC cluster site:

srv intra dc
Figure: Service Communication Between Clusters of Same DC

The following image shows service deployment in active/active and active/standby mode for remote clients:

srv act std comb
Figure: Service Deployment in Active-Active and Active-Standby Modes

Note: For instruction on accessing managed K8s clusters and deploying apps, see Create and Deploy Managed K8s guide.


Prerequisites

Note: VoltStack site is supported only for the Volterra IGW, ISV, and Dell Edger 640 Series devices.


Deploy Site

Perform the steps provided in the following chapters to deploy VoltStack site.

Create VoltStack Site Object

Log into VoltConsole and perform the following steps:

Step 1: Start creating VoltStack site object.
  • Navigate to Manage -> Site Management and select VoltStack Sites in the DC or Edge Sites page group. Click Add VoltStack Site to open the VoltStack site configuration form.

nav voltstacksite
Figure: Navigate to VoltStack Site Configuration

  • Enter a name in the metadata section for your VoltStack site object.
Step 2: Set the fields for the basic configuration section.
  • Select an option from the list of options for the Generic Server Certified Hardware field. The Volterra ISV 8000 is selected by default.
  • Enter the names of master nodes in the Master Nodes field. Click Add item to add more than one entry.

    Note: Either a single node or 3 master nodes are supported.

  • Optionally, enter the names of worker nodes in the Worker Nodes field. Click Add item to add more than one entry.
  • Optionally, enter the following fields:

    • Software Version - Volterra site software version
    • Operating System Version - Site operating system version
    • Geographical Address - This derives geographical coordinates
    • Coordinates - Latitude and longitude

HostCnf
Figure: VoltStack Site Basic Configuration Section

Step 3: Configure bond interfaces.

Go to Bond Configuration section and do the following:

  • Select Configure Bond Interfaces for the Select Bond Configuration field.

bond main 1
Figure: Bond Configuration Section

  • Click Configure under the Configure Bond Interfaces option to open bond interface configuration page.

bond devices
Figure: Bond Devices Section

  • Click Configure under the Bond Devices List field in the Bond Devices section.
  • Click on the Bond Device Name field on the Bond Devices List page and select a name from the list of options. You can also type a custom name and click Add item to set the device name while also adding it to the existing options.
  • Click on the Member Ethernet Devices field and select the ethernet devices that are part of this bond. Use Add item option to add more devices.
  • Click on the Select Bond Mode field to update the bonding mode. LACP is selected by default for the bonding mode with the default LACP packet interval as 30 seconds. You can set the bond mode to Active/Backup to set the bond members function in active and backup combination.

bond dev list
Figure: Bond Devices List

  • Click Apply.

Note: Use the Add item option to add more than one bond device.

  • Click Apply in the Bond Devices page to apply bond configuration to the VoltStack site configuration.
Step 4: Perform network configuration.

Go to Network Configuration section. Select Custom Network Configuration for the Select to Configure Networking field. Click Configure under the Custom Network Configuration option to open network configuration page.

netconf main
Figure: Network Configuration Section

Perform the following:

Step 4.1: Perform site local network configuration.

Site local network is applied with default configuration. Perform the following set of steps to apply custom configuration:

  • Select Configure Site Local Network for the Select Configuration For Site Local Network field. Click Configure under the Configure Site Local Network field.
  • Optionally, set labels for the Network Labels field in the network metadata section.
  • Optionally, click Show Advanced Fields in the Static Routes section and select Manage Static Routes for the Manage Static Routes field. Click Configure under Static Routes field and do the following:

    • Enter IP prefixes for the IP Prefixes field. These all prefixes will be mapped to the same next-hop and attributes.
    • Select IP Address or Interface or Default Gateway for the Select Type of Next Hop field and specify IP address or interface accordingly. In case of interface, you can select an existing interface or create a new interface using the options for the interface field.
    • Optionally, select one or more options for the Attributes field to set attributes for the static route.
    • Click Apply.
  • Optionally, enable Show Advanced Fields option in the Dc Cluster Group section and do the following:

    • Select Member of DC Cluster Group for the Select DC Cluster Group option.
    • Click on the Member of DC Cluster Group field and select a DC cluster group. You can also select Create new dc cluster group to create a new cluster group. Performing this adds this site to a DC cluster group, enabling full connectivity between the members of the group.

Note: The Not a Member option is default.

site local net
Figure: Site Local Network Configuration

  • Click Apply.
Step 4.2: Perform interface configuration.

Bootstrap interface configuration is applied by default and it is based on the certified hardware. Perform the following set of steps to apply custom interface configuration:

  • Select List of Interface for the Select Interface Configuration field. Click Configure under the List of Interface field. This opens another interface list configuration page.
  • Click Configure under the List of Interface field.
  • Select an option for the Interface Config Type field and set one of the interface types as per the following instructions:
Ethernet Interface:
  • Select Ethernet Interface and click Configure under the Ethernet Interface field. This opens ethernet interface configuration page.
  • Select an option from the list of options of Ethernet Device field. You can also type a custom name and click Add item to set the device name while also adding it to the existing options.
  • Select Cluster, All Nodes of the Site or Specific Node for the Select Configuration for Cluster or Specific Node field. In case of specific node, select the specific node from the displayed options of the Specific Node field. You can also type a custom name and click Add item to set the device name while also adding it to the existing options.
  • Select Untagged or VLAN Id for the Select Untagged or VLAN tagged field. In case of VLAN Id, enter the VLAN Id in the VLAN Id field.
  • Select an option for the Select Interface Address Method field in the IP Configuration section. The DHCP client is selected by default. In case you select a DHCP server, click Configure under the DHCP Server option and set the DHCP server configuration as per the options displayed on the DHCP server configuration page and click Apply. This example shows the interface as DHCP client for brevity.
  • Select site local outside or site local inside network for the Select Virtual Network field of the Virtual Network section. Site local outside network is selected by default.
  • Select if the interface is primary in the Select Primary Interface field. Default is not a primary interface. Ensure that you set only one interface as primary.
  • Click Apply.
Dedicated Interface:
  • Select Dedicated Interface for the Interface config Type field.
  • Select a device name from the displayed list for the Interface Device field. You can also type a custom name and click Add item to set the device name while also adding it to the existing options.
  • Select Cluster, All Nodes of the Site or Specific Node for the Select Configuration for Cluster or Specific Node field. In case of specific node, select the specific node from the displayed options of the Specific Node field. You can also type a custom name and click Add item to set the device name while also adding it to the existing options.
  • Select if the interface is primary in the Select Primary Interface field. Default is not a primary interface. Ensure that you set only one interface as primary.

Note: You can add more than one interface using the Add item option.

Step 4.3: Perform security configuration.

In case of security configuration, network policy and forward policies are disabled. Go to Security Configuration section and do the following to apply network and forward policies

  • Select Active Network Policies for the Manage Network Policy field. Click on the Network Policy field and select a network policy from the displayed list of options. You can also create and apply a new network policy using the Create a new network policy option. You can apply more than one forward proxy policy using the Add item option.
  • Select one of the following options for the Manage Forward Proxy field:

    • Select Enable Forward Proxy With Allow All Policy to allow all requests.
    • Select Enable Forward Proxy and Manage Policies to apply specific forward proxy policies. Select a network policy from the displayed list of options for the Forward Proxy Policies field. You can also create and apply a new network policy using the Create a new forward proxy policy option. You can apply more than one forward proxy policy using the Add item option.

Optionally, you can configure global networks in the Global Connections section and BGP settings in the Advanced Configuration section. This example does not include the configuration for these two for the purpose of brevity.

Step 5: Perform storage configuration.

Optionally, specify storage configuration for your site. Select Custom Storage Configuration for the Select to Configure Storage field in the storage configuration section. Click Configure under the Custom Storage Configuration option and perform configuration as per the instructions included in the Fleet Storage guide.

Note: Storage configuration in VoltStack site is similar to that of fleet.

Step 6: Perform advanced configuration.
  • Go to Advanced Configuration section and enable Show Advanced Fields option.
  • Optionally, select GPU Disabled for the Enable/Disable GPU field. This enables GPU capability for the site hardware.
  • Optionally, configure managed K8s for your site as per the following guidelines:

    • Select Enable Site Local K8s API access for the Site Local K8s API access field.
    • Click on the Enable Site Local K8s API access field and select a K8s cluster object from the list of the fields. You can also select Create new k8s cluster option to create and apply the K8s cluster object.

voltstack advanced
Figure: Advanced Configuration

Note: The advanced configuration also includes managed K8s configuration. This is an important step in case you want to enable managed K8s access. This is possible only at the time of creating the VoltStack site and cannot be enabled later by updating VoltStack site.

Step 7: Complete creating the VolStack site.

Click Save and Exit to complete creating the VoltStack site.


Perform Site Registration

After creating the VoltStack site object in VoltConsole, the VoltStack site shows up in VoltConsole with Waiting for Registration status. Install the nodes and ensure that the cluster name and host name for your nodes match with the VoltStack site name and node name as per the Basic Configuration section of VoltStack site you configured. Perform registration as per the following instructions:

  • Navigate to Manage -> Site Management -> Registrations in the system namespace.
  • Choose your site from the list of sites displayed under Pending Registrations tab. Click approve sign and start approval.
  • Ensure that the cluster name and hostname is matching with those of VoltStack site.
  • Click Accept to complete registration and the site turns online.

Volterra Concepts