kolla-ansible/doc/cinder-guide-hnas.rst

Hitachi NAS Platform iSCSI and NFS drives for OpenStack

Overview

The Block Storage service provides persistent block storage resources that Compute instances can consume. This includes secondary attached storage similar to the Amazon Elastic Block Storage (EBS) offering. In addition, you can write images to a Block Storage device for Compute to use as a bootable persistent instance.

Requirements

• Hitachi NAS Platform Models 3080, 3090, 4040, 4060, 4080, and 4100.
• HNAS/SMU software version is 12.2 or higher.
• HNAS configuration and management utilities to create a storage pool (span) and an EVS.
  • GUI (SMU).
  • SSC CLI.
• You must set an iSCSI domain to EVS

Supported shared file systems and operations -------------------------------------------The NFS and iSCSI drivers support these operations:

• Create, delete, attach, and detach volumes.
• Create, list, and delete volume snapshots.
• Create a volume from a snapshot.
• Copy an image to a volume.
• Copy a volume to an image.
• Clone a volume.
• Extend a volume.
• Get volume statistics.
• Manage and unmanage a volume.
• Manage and unmanage snapshots (HNAS NFS only).

Configuration on Kolla deployment

Enable Shared File Systems service and HNAS driver in /etc/kolla/globals.yml

enable_cinder: "yes"
enable_cinder_backend_hnas_iscsi: "yes"

Configuration on HNAS

Create the data HNAS network in Kolla OpenStack:

List the available tenants:

$ openstack project list

Create a network to the given tenant (service), providing the tenant ID, a name for the network, the name of the physical network over which the virtual network is implemented, and the type of the physical mechanism by which the virtual network is implemented:

$ neutron net-create --tenant-id <SERVICE_ID> hnas_network \
--provider:physical_network=physnet2 --provider:network_type=flat

Create a subnet to the same tenant (service), the gateway IP of this subnet, a name for the subnet, the network ID created before, and the CIDR of subnet:

$ neutron subnet-create --tenant-id <SERVICE_ID> --gateway <GATEWAY> \
--name hnas_subnet <NETWORK_ID> <SUBNET_CIDR>

Add the subnet interface to a router, providing the router ID and subnet ID created before:

$ neutron router-interface-add <ROUTER_ID> <SUBNET_ID>

Create volume

Create a non-bootable volume.

$ openstack volume create --size 1 my-volume

Verify Operation.

$ cinder show my-volume

+--------------------------------+--------------------------------------+
| Property                       | Value                                |
+--------------------------------+--------------------------------------+
| attachments                    | []                                   |
| availability_zone              | nova                                 |
| bootable                       | false                                |
| consistencygroup_id            | None                                 |
| created_at                     | 2017-01-17T19:02:45.000000           |
| description                    | None                                 |
| encrypted                      | False                                |
| id                             | 4f5b8ae8-9781-411e-8ced-de616ae64cfd |
| metadata                       | {}                                   |
| migration_status               | None                                 |
| multiattach                    | False                                |
| name                           | my-volume                            |
| os-vol-host-attr:host          | compute@hnas-iscsi#iscsi_gold        |
| os-vol-mig-status-attr:migstat | None                                 |
| os-vol-mig-status-attr:name_id | None                                 |
| os-vol-tenant-attr:tenant_id   | 16def9176bc64bd283d419ac2651e299     |
| replication_status             | disabled                             |
| size                           | 1                                    |
| snapshot_id                    | None                                 |
| source_volid                   | None                                 |
| status                         | available                            |
| updated_at                     | 2017-01-17T19:02:46.000000           |
| user_id                        | fb318b96929c41c6949360c4ccdbf8c0     |
| volume_type                    | None                                 |
+--------------------------------+--------------------------------------+

$ nova volume-attach INSTANCE_ID VOLUME_ID auto

+----------+--------------------------------------+
| Property | Value                                |
+----------+--------------------------------------+
| device   | /dev/vdc                             |
| id       | 4f5b8ae8-9781-411e-8ced-de616ae64cfd |
| serverId | 3bf5e176-be05-4634-8cbd-e5fe491f5f9c |
| volumeId | 4f5b8ae8-9781-411e-8ced-de616ae64cfd |
+----------+--------------------------------------+

$ openstack volume list

+--------------------------------------+---------------+----------------+------+-------------------------------------------+
| ID                                   | Display Name  | Status         | Size | Attached to                               |
+--------------------------------------+---------------+----------------+------+-------------------------------------------+
| 4f5b8ae8-9781-411e-8ced-de616ae64cfd | my-volume     | in-use         |    1 | Attached to private-instance on /dev/vdb  |
+--------------------------------------+---------------+----------------+------+-------------------------------------------+

Configure hnas-iscsi backend

Below are configuration examples for both iSCSI backend. For HNAS iSCSI driver, create this section in your cinder.conf file:

Modify the file /etc/kolla/config/cinder.conf and add the contents:

[DEFAULT]
enabled_backends = hnas-iscsi

[hnas-iscsi]
volume_driver = cinder.volume.drivers.hitachi.hnas_iscsi.HNASISCSIDriver
volume_backend_name = hnas_iscsi_backend
hnas_username = supervisor
hnas_password = supervisor
hnas_mgmt_ip0 = <hnas_ip>
hnas_chap_enabled = True

hnas_svc0_volume_type = iscsi_gold
hnas_svc0_hdp = FS-Baremetal1
hnas_svc0_iscsi_ip = <svc0_ip>

For more information about how to manage volumes, see the OpenStack User Guide.

For more information about how HNAS driver works, see Hitachi NAS Platform iSCSI and NFS drives for OpenStack.