Merge "Add the configuration reference document for NEC cinder volume drivers."
This commit is contained in:
Jenkins
Gerrit Code Review
commit
2cd580067f
@ -0,0 +1,293 @@
|
|||||||
|
===========================
|
||||||
|
NEC Storage M series driver
|
||||||
|
===========================
|
||||||
|
|
||||||
|
NEC Storage M series are dual-controller disk arrays which support
|
||||||
|
online maintenance.
|
||||||
|
This driver supports both iSCSI and Fibre Channel.
|
||||||
|
|
||||||
|
System requirements
|
||||||
|
~~~~~~~~~~~~~~~~~~~
|
||||||
|
Supported models:
|
||||||
|
|
||||||
|
- NEC Storage M110, M310, M510 and M710 (SSD/HDD hybrid)
|
||||||
|
- NEC Storage M310F and M710F (all flash)
|
||||||
|
|
||||||
|
Requirements:
|
||||||
|
|
||||||
|
- Storage control software (firmware) revision 0950 or later
|
||||||
|
- NEC Storage DynamicDataReplication license
|
||||||
|
- (Optional) NEC Storage IO Load Manager license for QoS
|
||||||
|
|
||||||
|
|
||||||
|
Supported 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.
|
||||||
|
- Clone a volume.
|
||||||
|
- Extend a volume.
|
||||||
|
- Get volume statistics.
|
||||||
|
|
||||||
|
|
||||||
|
Preparation
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Below is minimum preparation to a disk array.
|
||||||
|
For details of each command, see the NEC Storage Manager Command Reference
|
||||||
|
(IS052).
|
||||||
|
|
||||||
|
- Common (iSCSI and Fibre Channel)
|
||||||
|
|
||||||
|
#. Initial setup
|
||||||
|
|
||||||
|
* Set IP addresses for management and BMC with the network configuration
|
||||||
|
tool.
|
||||||
|
* Enter license keys. (iSMcfg licenserelease)
|
||||||
|
#. Create pools
|
||||||
|
|
||||||
|
* Create pools for volumes. (iSMcfg poolbind)
|
||||||
|
* Create pools for snapshots. (iSMcfg poolbind)
|
||||||
|
#. Create system volumes
|
||||||
|
|
||||||
|
* Create a Replication Reserved Volume (RSV) in one of pools.
|
||||||
|
(iSMcfg ldbind)
|
||||||
|
* Create Snapshot Reserve Areas (SRAs) in each snapshot pool.
|
||||||
|
(iSMcfg srabind)
|
||||||
|
#. (Optional) Register SSH public key
|
||||||
|
|
||||||
|
|
||||||
|
- iSCSI only
|
||||||
|
|
||||||
|
#. Set IP addresses of each iSCSI port. (iSMcfg setiscsiport)
|
||||||
|
#. Create a LD Set with setting multi-target mode on. (iSMcfg addldset)
|
||||||
|
#. Register initiator names of each node. (iSMcfg addldsetinitiator)
|
||||||
|
|
||||||
|
|
||||||
|
- Fibre Channel only
|
||||||
|
|
||||||
|
#. Start access control. (iSMcfg startacc)
|
||||||
|
#. Create a LD Set. (iSMcfg addldset)
|
||||||
|
#. Register WWPNs of each node. (iSMcfg addldsetpath)
|
||||||
|
|
||||||
|
|
||||||
|
Configuration
|
||||||
|
~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
|
||||||
|
Set the following in your ``cinder.conf``, and use the following options
|
||||||
|
to configure it.
|
||||||
|
|
||||||
|
If you use Fibre Channel:
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[Storage1]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageFCDriver
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
|
||||||
|
If you use iSCSI:
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[Storage1]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
Also, set ``volume_backend_name``.
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
volume_backend_name = Storage1
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
|
||||||
|
This table shows configuration options for NEC Storage M series driver.
|
||||||
|
|
||||||
|
.. include:: ../../tables/cinder-nec_m.rst
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Required options
|
||||||
|
----------------
|
||||||
|
|
||||||
|
|
||||||
|
- ``nec_ismcli_fip``
|
||||||
|
FIP address of M-Series Storage.
|
||||||
|
|
||||||
|
- ``nec_ismcli_user``
|
||||||
|
User name for M-Series Storage iSMCLI.
|
||||||
|
|
||||||
|
- ``nec_ismcli_password``
|
||||||
|
Password for M-Series Storage iSMCLI.
|
||||||
|
|
||||||
|
- ``nec_ismcli_privkey``
|
||||||
|
RSA secret key file name for iSMCLI (for public key authentication only).
|
||||||
|
Encrypted RSA secret key file cannot be specified.
|
||||||
|
|
||||||
|
- ``nec_diskarray_name``
|
||||||
|
Diskarray name of M-Series Storage.
|
||||||
|
This parameter must be specified to configure multiple groups
|
||||||
|
(multi back end) by using the same storage device (storage
|
||||||
|
device that has the same ``nec_ismcli_fip``). Specify the disk
|
||||||
|
array name targeted by the relevant config-group for this
|
||||||
|
parameter.
|
||||||
|
|
||||||
|
- ``nec_backup_pools``
|
||||||
|
Specify a pool number where snapshots are created.
|
||||||
|
|
||||||
|
|
||||||
|
Timeout configuration
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
|
||||||
|
- ``rpc_response_timeout``
|
||||||
|
Set the timeout value in seconds. If three or more volumes can be created
|
||||||
|
at the same time, the reference value is 30 seconds multiplied by the
|
||||||
|
number of volumes created at the same time.
|
||||||
|
Also, Specify nova parameters below in ``nova.conf`` file.
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
block_device_allocate_retries = 120
|
||||||
|
block_device_allocate_retries_interval = 10
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
|
||||||
|
- ``timeout server (HAProxy configuration)``
|
||||||
|
In addition, you need to edit the following value in the HAProxy
|
||||||
|
configuration file (``/etc/haproxy/haproxy.cfg``) in an environment where
|
||||||
|
HAProxy is used.
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
timeout server = 600 #Specify a value greater than rpc_response_timeout.
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
Run the :command:`service haproxy reload` command after editing the
|
||||||
|
value to reload the HAProxy settings.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
The OpenStack environment set up using Red Hat OpenStack Platform
|
||||||
|
Director may be set to use HAProxy.
|
||||||
|
|
||||||
|
|
||||||
|
Configuration example for /etc/cinder/cinder.conf
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
When using one config-group
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
- When using ``nec_ismcli_password`` to authenticate iSMCLI
|
||||||
|
(Password authentication):
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = Storage1
|
||||||
|
|
||||||
|
[Storage1]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Storage1
|
||||||
|
nec_ismcli_fip = 192.168.1.10
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_password = sys123
|
||||||
|
nec_pools = 0
|
||||||
|
nec_backup_pools = 1
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
|
||||||
|
- When using ``nec_ismcli_privkey`` to authenticate iSMCLI
|
||||||
|
(Public key authentication):
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = Storage1
|
||||||
|
|
||||||
|
[Storage1]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Storage1
|
||||||
|
nec_ismcli_fip = 192.168.1.10
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_privkey = /etc/cinder/id_rsa
|
||||||
|
nec_pools = 0
|
||||||
|
nec_backup_pools = 1
|
||||||
|
|
||||||
|
.. end
|
||||||
|
|
||||||
|
|
||||||
|
When using multi config-group (multi-backend)
|
||||||
|
---------------------------------------------
|
||||||
|
|
||||||
|
- Four config-groups (backends)
|
||||||
|
|
||||||
|
Storage1, Storage2, Storage3, Storage4
|
||||||
|
|
||||||
|
- Two disk arrays
|
||||||
|
|
||||||
|
200000255C3A21CC(192.168.1.10)
|
||||||
|
Example for using config-group, Storage1 and Storage2
|
||||||
|
|
||||||
|
2000000991000316(192.168.1.20)
|
||||||
|
Example for using config-group, Storage3 and Storage4
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = Storage1,Storage2,Storage3,Storage4
|
||||||
|
|
||||||
|
[Storage1]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Gold
|
||||||
|
nec_ismcli_fip = 192.168.1.10
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_password = sys123
|
||||||
|
nec_pools = 0
|
||||||
|
nec_backup_pools = 2
|
||||||
|
nec_diskarray_name = 200000255C3A21CC
|
||||||
|
|
||||||
|
[Storage2]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Silver
|
||||||
|
nec_ismcli_fip = 192.168.1.10
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_password = sys123
|
||||||
|
nec_pools = 1
|
||||||
|
nec_backup_pools = 3
|
||||||
|
nec_diskarray_name = 200000255C3A21CC
|
||||||
|
|
||||||
|
[Storage3]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Gold
|
||||||
|
nec_ismcli_fip = 192.168.1.20
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_password = sys123
|
||||||
|
nec_pools = 0
|
||||||
|
nec_backup_pools = 2
|
||||||
|
nec_diskarray_name = 2000000991000316
|
||||||
|
|
||||||
|
[Storage4]
|
||||||
|
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver
|
||||||
|
volume_backend_name = Silver
|
||||||
|
nec_ismcli_fip = 192.168.1.20
|
||||||
|
nec_ismcli_user = sysadmin
|
||||||
|
nec_ismcli_password = sys123
|
||||||
|
nec_pools = 1
|
||||||
|
nec_backup_pools = 3
|
||||||
|
nec_diskarray_name = 2000000991000316
|
||||||
|
|
||||||
|
.. end
|
||||||
@ -41,6 +41,7 @@ Volume drivers
|
|||||||
drivers/itri-disco-driver.rst
|
drivers/itri-disco-driver.rst
|
||||||
drivers/kaminario-driver.rst
|
drivers/kaminario-driver.rst
|
||||||
drivers/lenovo-driver.rst
|
drivers/lenovo-driver.rst
|
||||||
|
drivers/nec-storage-m-series-driver.rst
|
||||||
drivers/netapp-volume-driver.rst
|
drivers/netapp-volume-driver.rst
|
||||||
drivers/nimble-volume-driver.rst
|
drivers/nimble-volume-driver.rst
|
||||||
drivers/nexentastor4-driver.rst
|
drivers/nexentastor4-driver.rst
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user