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:

Storage model

Storage control software (firmware)

Disk type

M110, M310, M510, M710

0979 or later

SSD/HDD hybrid

M310F, M710F

0979 or later

all flash

M120, M320

1028 or later

SSD/HDD hybrid

M320F

1028 or later

all flash

Requirements:

  • NEC Storage M series requires firmware revision 1028 or later to create more than 1024 volumes in a pool.

  • 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.

  • Copy a volume to an image.

  • Clone a volume.

  • Extend a volume.

  • Migrate a volume.

  • Get volume statistics.

  • Efficient non-disruptive volume backup.

  • Manage and unmanage a volume.

  • Manage and unmanage a snapshot.

  • Attach a volume to multiple instances at once (multi-attach).

  • Revert a volume to a snapshot.

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 LD Sets for each node. (iSMcfg addldset)

    3. Register initiator names of each node to the corresponding LD Set. (iSMcfg addldsetinitiator)

  • Fibre Channel only

    1. Start access control. (iSMcfg startacc)

    2. Create LD Sets for each node. (iSMcfg addldset)

    3. Register WWPNs of each node to the corresponding LD Set. (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.

Description of NEC Storage M Series configuration options

Configuration option = Default value

Description

nec_actual_free_capacity = False

(Boolean) Return actual free capacity.

nec_auto_accesscontrol = True

(Boolean) Configure access control automatically.

nec_backend_max_ld_count = 1024

(Integer) Maximum number of managing sessions.

nec_backup_ldname_format = LX:%s

(String) M-Series Storage LD name format for snapshots.

nec_backup_pools = []

(List of String) M-Series Storage backup pool number to be used.

nec_cv_ldname_format = LX:__ControlVolume_%xh

(String) M-Series Storage Control Volume name format.

nec_diskarray_name = <>

(String) Diskarray name of M-Series Storage.

nec_ismcli_fip = None

(IPAddress) FIP address of M-Series Storage iSMCLI.

nec_ismcli_password = <>

(String) Password for M-Series Storage iSMCLI.

nec_ismcli_privkey = <>

(String) Filename of RSA private key for M-Series Storage iSMCLI.

nec_ismcli_user = <>

(String) User name for M-Series Storage iSMCLI.

nec_ismview_alloptimize = False

(Boolean) Use legacy iSMCLI command with optimization.

nec_ismview_dir = /tmp/nec/cinder

(String) Output path of iSMview file.

nec_ldname_format = LX:%s

(String) M-Series Storage LD name format for volumes.

nec_ldset = <>

(String) M-Series Storage LD Set name for Compute Node.

nec_pools = []

(List of String) M-Series Storage pool numbers list to be used.

nec_queryconfig_view = False

(Boolean) Use legacy iSMCLI command.

nec_ssh_pool_port_number = 22

(Integer) Port number of ssh pool.

nec_unpairthread_timeout = 3600

(Integer) Timeout value of Unpairthread.

nec_iscsi_portals_per_cont = 0

(Integer) Max number of iSCSI portals per controller. 0 => unlimited. This option is deprecated and may be removed in the next release. DEPRECATED

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 one pool number where snapshots are created. Multiple pools are not supported.

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