Configure Storage in Fleet

Objective
Prerequisites
Configuration
Concepts
API References

Objective

This guide provides instructions on how to set storage for your applications using the Volterra fleet of sites. Storage configuration set using fleet gets applied to all the sites that are part of the fleet and will be accessible to the workloads on those sites. For more information on Volterra fleet concept, see Fleet.

Using the instructions provided in the document, you can define the following storage configuration using fleet:

Storage devices - configuration for a specific hardware appliance.
Storage classes - class to which the appliance belongs to and this is dependent on the appliance provider. For example, a class can be a fast pool or slow pool of devices.
Storage interfaces - interfaces for storage devices.

Note: This guide provides instructions on setting storage for an existing fleet by editing the fleet object configuration. However, you can also define the storage configuration in similar manner while creating a fleet. For information on how to create a fleet, see Create Fleet guide.

Prerequisites

A valid Volterra Account is required.

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

Volterra site.
Storage devices (cloud or on-premise data centers).

Configuration

Step 1: Log into the VoltConsole and start editing the fleet configuration.

Select Manage from the configuration menu in the system namespace. Select Site Management -> Fleet from the options. A list of created fleet objects gets displayed.
Select ... -> Edit for the fleet object for which you want to define storage configuration.

Step 2: Navigate to storage configuration section and set interfaces for storage.

Navigate to Storage Configuration section and select List of Storage Interface for the Select Storage Interface Configuration field.
Select an interface from the displayed list or click Create new interface for the List of Interface field. You can add multiple interfaces using the Add item option.

storage intf — Figure: Interfaces for Storage Devices

Note: See Interfaces for instructions on creating network interfaces. See Multi Node Site Network Setup Using Fleet for instructions on how to configure networking using fleet for multi node sites.

Step 3: Configure storage devices.

Select List of Storage Devices for the Select Storage Device Configuration field. Click Configure under the List of Storage Devices field. This opens storage devices configuration.

storage dev option — Figure: Storage Devices Option

Click Add item in the List of Storage Devices page and enter a name for the Storage Device field. Ensure that this name corresponds to the class in which the storage device falls. The classes are used by vK8s for storage related actions.
Select an option for the Select Storage Device to Configure field
Enter a name in the Storage Device field. Ensure that this name corresponds to the class that will be configured in later steps.
Perform the following as per the option you chose:

OpenEBS Enterprise

Click Configure under the List of Mayastor Pools to open Mayastor pool configuration page.
Click Add item in the List of Mayastor Pools page.
Enter a name for the Mayastor Pool Name page.
Enter a name for the Node Name field.
Enter list of devices in the List of Disk Devices field. An example disk types is /dev/sba.

mayastor pools — Figure: OpenEBS Mayastor Pools

Click Apply.

NetApp Trident

Select an option for the Select NetApp Trident Backend field. The ONTAP NAS is selected by default.
Select an option for the Backend Management LIF field. The Backend Management LIF IP Address is selected by default. Enter an IP address for the backend management logical interface in the Backend Management LIF IP Address field. In case you select the name option, enter the backend management interface name.
Select an option for the Backend Data LIF field. The Backend Data LIF IP Address is selected by default. Enter an IP address for the backend data interface in the Backend Data LIF IP Address field. In case you select the name option, enter the backend data interface name.

netapp dev 1 — Figure: NetApp Device Backend LIFs

Enter a username in the Username field. Click Configure for the Password field. Enter your password in the Secret page and click Blindfold. Wait for the Blindfold to complete encrypting your password and click Apply.
Enter CIDR for your K8s nodes in the Auto Export CIDRs field in case auto export policy is enabled for your storage device.

netapp dev 2 — Figure: NetApp Device AutoExport CIDRs

Click Apply.

Pure Storage Service Orchestrator

Enter a cluster identifier in the Cluster ID field. This is used to identify the volumes used by the datastore. Alphanumeric characters and underscores are allowed.

pure device — Figure: Pure Storage Orchestrator Device

Note: Unique cluster ID is required for multiple K8s cluster using the same storage device.

Click Configure under the Flash Arrays field and do the following:
- Enter an IP address in the Management Endpoint IP Address field.
- Click Configure under the API Token field. Enter the token in the secret field and click Blindfold. Click Apply after the Blindfold encryption is completed.
- Click Apply.

flash array — Figure: Pure Storage Flash Arrays

Click Configure under the Flash Blade field and do the following:
- Enter the IP address in the Management Endpoint IP Address field.
- Click Configure under the API Token field. Enter the token in the secret field and click Blindfold. Click Apply after the Blindfold encryption is completed.
- Enter the IP address in the NFS IP Address field.
- Click Apply.

flash blade — Figure: Pure Storage Flash Blade

Note: You can change the management or NFS endpoints to specify management endpoint name or NFS DNS name.

Click Apply.

Note: You can add multiple devices using the Add item option.

Step 4: Configure storage classes.

You can use default storage classes supported in K8s or you can customize the classes. In case you are using default classes, ensure that the storage device names correspond to the K8s classes. This step shows how to configure custom classes.

Select Select Configuration for Storage Classes for the Select Configuration for Storage Classes field. Click Configure under the List of Storage Classes field. This opens storage class configuration page.
Click Add item in the List of Storage Classes page and enter a name for the Storage Class Name field.

Note: Ensure that the storage device name set in Step 2 is as per this name. The classes are used by vK8s for storage related actions.

Enter a name in the Storage Device field.
Select an option for the Select Storage Class Configuration field and perform the following as per the option you chose:

OpenEBS Enterprise

Select a protocol for the Protocol field. The iscsi option is selected by default.
Optionally enter a replication value for the Replication field.