Lightbits LightOS Cinder Driver
The Lightbits(TM) LightOS(R) OpenStack driver enables OpenStack clusters to use LightOS clustered storage servers. This documentation explains how to configure Cinder for use with the Lightbits LightOS storage backend system.
- Create volume
- Delete volume
- Attach volume
- Detach volume
- Create image from volume
- Live migration
- Volume replication
- Thin provisioning
- Supported vendor driver
- Extend volume
- Create snapshot
- Delete snapshot
- Create volume from snapshot
- Create volume from volume (clone)
LightOS OpenStack Driver Components
The LightOS OpenStack driver has three components: - Cinder driver - Nova libvirt volume driver - os_brick initiator connector
In addition, it requires the LightOS
discovery-client, provided with LightOS. The os_brick connector uses the LightOS
discovery-client to communicate with LightOS NVMe/TCP discovery services.
The Cinder Driver
The Cinder driver integrates with Cinder and performs REST operations against the LightOS cluster. To enable the driver, add the following to Cinder's configuration file
enabled_backends = lightos,<any other storage backend you use>
[lightos] volume_driver = cinder.volume.drivers.lightos.LightOSVolumeDriver volume_backend_name = lightos lightos_api_address = <TARGET_ACCESS_IPS> lightos_api_port = 443 lightos_jwt=<LIGHTOS_JWT> lightos_default_num_replicas = 3 lightos_default_compression_enabled = False lightos_api_service_timeout=30
TARGET_ACCESS_IPSare the LightOS cluster nodes access IPs. Multiple nodes should be separated by commas. For example:
lightos_api_address = 192.168.67.78,192.168.34.56,192.168.12.17. These IPs are where the driver looks for the LightOS clusters REST API servers.
LIGHTOS_JWTis the JWT (JSON Web Token) that is located at the LightOS installation controller. You can find the jwt at
- The default number of replicas for volumes is 3, and valid values for
lightos_default_num_replicasare 1, 2, or 3.
- The default compression setting is False (i.e., data is uncompressed). The default compression setting can also be True. This can also be changed on a per-volume basis.
- The default time to wait for API service response is 30 seconds per API endpoint.
Creating volumes with non-default compression and number of replicas settings can be done through the volume types mechanism. To create a new volume type with compression enabled:
$ openstack volume type create --property compression='<is> True' volume-with-compression
To create a new volume type with one replica:
$ openstack volume type create --property lightos:num_replicas=1 volume-with-one-replica
To create a new type for a compressed volume with three replicas:
$ openstack volume type create --property compression='<is> True' --property lightos:num_replicas=3 volume-with-three-replicas-and-compression
Then create a new volume with one of these volume types:
$ openstack volume create --size <size> --type <type name> <vol name>
NVNe/TCP and Asymmetric Namespace Access (ANA)
The LightOS clusters expose their volumes using NVMe/TCP Asynchronous Namespace Access (ANA). ANA is a relatively new feature in the NVMe/TCP stack in Linux but it is fully supported in Ubuntu 20.04. Each compute host in the OpenStack cluster needs to be ANA-capable to provide OpenStack VMs with LightOS volumes over NVMe/TCP. For more information on how to set up the compute nodes to use ANA, see the CentOS Linux Cluster Client Software Installation section of the Lightbits(TM) LightOS(R) Cluster Installation and Initial Configuration Guide.
In the current version, if any of the cluster nodes changes its access IPs, the Cinder driver's configuration file should be updated with the cluster nodes access IPs and restarted. As long as the Cinder driver can access at least one cluster access IP it will work, but will be susceptible to cluster node failures.
The following table contains the configuration options supported by the Lightbits LightOS Cinder driver.