Add how configure backend to cinder HNAS iSCSI driver guide
Change-Id: I11f93fd1aa7926b568fba355da3cb5fec3badbd8
This commit is contained in:
Francisco Edigleison Barbosa
parent
b388f7f9ba
commit
46b9952441
195
doc/cinder-guide-hnas.rst
Normal file
195
doc/cinder-guide-hnas.rst
Normal file
@ -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 <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:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ 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:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ neutron router-interface-add <ROUTER_ID> <SUBNET_ID>
|
||||
|
||||
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_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
|
||||
<http://docs.openstack.org/user-guide/index.html>`__.
|
||||
|
||||
For more information about how HNAS driver works, see
|
||||
`Hitachi NAS Platform iSCSI and NFS drives for OpenStack
|
||||
<http://docs.openstack.org/newton/config-reference/block-storage/drivers/hds-hnas-driver.html>`__.
|
||||
@ -65,6 +65,7 @@ Kolla Services
|
||||
ceph-guide
|
||||
external-ceph-guide
|
||||
cinder-guide
|
||||
cinder-guide-hnas
|
||||
ironic-guide
|
||||
manila-guide
|
||||
manila-hnas-guide
|
||||
|
||||
Loading…
Reference in New Issue
Block a user