Jay S. Bryant 986a6a015f [DOC BLD FIX] Name files for inclusion properly

The Sphinx build was issuing hundreds of warning for
duplicate labels.  The reason for this was because
all of the tables we had were named as .rst files.
This would cause Sphinx to process them twice and it would
think there were duplicated sections.

There were two ways this could be handled:  1) Exclude the tables
directory from the docs build. 2) Name the files as they should
have always been so they weren't build twice.  Given that
option 1 just masked the problem, I am implementing this
patch using option 2.

So, all the tables we are including in our documentation
have been named from .rst to .inc and the .. include::
directives that use them have also been updated to use
the new file name.

Change-Id: If395eb652f7e3b789bcbd5e6d6d05954c23d8d8a

2017-08-04 15:33:52 -05:00

7.1 KiB

Raw Blame History

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)
1. Initial setup
  - Set IP addresses for management and BMC with the network configuration tool.
  - Enter license keys. (iSMcfg licenserelease)
2. Create pools
  - Create pools for volumes. (iSMcfg poolbind)
  - Create pools for snapshots. (iSMcfg poolbind)
3. 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)
4. (Optional) Register SSH public key
iSCSI only
1. Set IP addresses of each iSCSI port. (iSMcfg setiscsiport)
2. Create a LD Set with setting multi-target mode on. (iSMcfg addldset)
3. Register initiator names of each node. (iSMcfg addldsetinitiator)
Fibre Channel only
1. Start access control. (iSMcfg startacc)
2. Create a LD Set. (iSMcfg addldset)
3. 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:

[Storage1]
volume_driver = cinder.volume.drivers.nec.volume.MStorageFCDriver

If you use iSCSI:

[Storage1]
volume_driver = cinder.volume.drivers.nec.volume.MStorageISCSIDriver

Also, set volume_backend_name.

[DEFAULT]
volume_backend_name = Storage1

This table shows configuration options for NEC Storage M series driver.

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.
```
[DEFAULT]
block_device_allocate_retries = 120
block_device_allocate_retries_interval = 10
```
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.
```
timeout server = 600 #Specify a value greater than rpc_response_timeout.
```
Run the 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):

[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

When using nec_ismcli_privkey to authenticate iSMCLI (Public key authentication):

[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

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

[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

7.1 KiB Raw Blame History