From 46b9952441925db12d04e7ff70c8f2eb5c5143a5 Mon Sep 17 00:00:00 2001 From: Francisco Edigleison Barbosa Date: Mon, 30 Jan 2017 11:03:49 -0300 Subject: [PATCH] Add how configure backend to cinder HNAS iSCSI driver guide Change-Id: I11f93fd1aa7926b568fba355da3cb5fec3badbd8 --- doc/cinder-guide-hnas.rst | 195 ++++++++++++++++++++++++++++++++++++++ doc/index.rst | 1 + 2 files changed, 196 insertions(+) create mode 100644 doc/cinder-guide-hnas.rst diff --git a/doc/cinder-guide-hnas.rst b/doc/cinder-guide-hnas.rst new file mode 100644 index 0000000000..2f4a1e10d5 --- /dev/null +++ b/doc/cinder-guide-hnas.rst @@ -0,0 +1,195 @@ +.. _cinder-guide-hnas: + +======================================================== +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`` + +.. code-block:: console + + enable_cinder: "yes" + enable_cinder_backend_hnas_iscsi: "yes" + +Configuration on HNAS +--------------------- + +Create the data HNAS network in Kolla OpenStack: + +List the available tenants: + +.. code-block:: console + + $ 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: + +.. code-block:: console + + $ neutron net-create --tenant-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: + +.. code-block:: console + + $ neutron subnet-create --tenant-id --gateway \ + --name hnas_subnet + +Add the subnet interface to a router, providing the router ID and subnet +ID created before: + +.. code-block:: console + + $ neutron router-interface-add + +Create volume +============================ + +Create a non-bootable volume. + +.. code-block:: console + + $ openstack volume create --size 1 my-volume + +Verify Operation. + +.. code-block:: console + + $ 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: + +.. code-block:: console + + [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_chap_enabled = True + + hnas_svc0_volume_type = iscsi_gold + hnas_svc0_hdp = FS-Baremetal1 + hnas_svc0_iscsi_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 +`__. diff --git a/doc/index.rst b/doc/index.rst index eee8c7f86b..abc56a9f62 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -65,6 +65,7 @@ Kolla Services ceph-guide external-ceph-guide cinder-guide + cinder-guide-hnas ironic-guide manila-guide manila-hnas-guide