Chapter 3. Define a Single Back End

Important

This section describes the deployment of a single back end. Deploying multiple instances of a Dell Storage Center back end requires a custom back end configuration. See the Custom Block Storage Back End Deployment Guide for instructions.

With a Director deployment, the easiest way to define a single Dell Storage Center back end is through the integrated environment file. This file is located in the following path of the Undercloud node:

/usr/share/openstack-tripleo-heat-templates/environments/cinder-dellsc-config.yaml

Copy this file to a local path where you can edit and invoke it later. For example, to copy it to ~/templates/:

$ cp /usr/share/openstack-tripleo-heat-templates/environments/cinder-dellsc-config.yaml ~/templates/

Afterwards, open the copy (~/templates/cinder-dellsc-config.yaml) and edit it as you see fit. The following snippet displays the default contents of this file:

# A Heat environment file which can be used to enable a
# a Cinder  Dell Storage Center ISCSI backend, configured via puppet
resource_registry:
  OS::TripleO::Services::CinderBackendDellSc: ../puppet/services/cinder-backend-dellsc.yaml # 1

parameter_defaults: # 2
  CinderEnableDellScBackend: true # 3
  CinderDellScBackendName: 'tripleo_dellsc'
  CinderDellScSanIp: ''
  CinderDellScSanLogin: 'Admin'
  CinderDellScSanPassword: ''
  CinderDellScSsn: '64702'
  CinderDellScIscsiIpAddress: ''
  CinderDellScIscsiPort: '3260'
  CinderDellScApiPort: '3033'
  CinderDellScServerFolder: 'dellsc_server'
  CinderDellScVolumeFolder: 'dellsc_volume'
1
The OS::TripleO::Services::CinderBackendDellSc parameter in the resource_registry section refers to a composable service template named cinder-backend-dellsc.yaml. The director uses this template to load the necessary resources for configuring the back end. By default, the parameter specifies the path to cinder-backend-dellsc.yaml relatively. As such, update this parameter with the absolute path to the file:
resource_registry:
  OS::TripleO::Services::CinderBackendDellSc: /usr/share/openstack-tripleo-heat-templates/puppet/services/cinder-backend-dellsc.yaml
2
The parameter_defaults section contains your back end definition. Specifically, it contains the parameters that the Director should pass to the resources defined in cinder-dellsc.yaml.
3
The CinderEnableDellScBackend: true line instructs the Director to use the puppet manifests necessary for the default configuration of a Dell Storage Center back end. This includes defining the volume driver that the Block Storage service should use (specifically, cinder.volume.drivers.dell_emc.sc.dell_storagecenter_iscsi.SCISCSIDriver).

To define your Dell Storage Center back end, edit the settings in the parameter_defaults section as you see fit. The following table explains each parameter, and also lists its corresponding /etc/cinder/cinder.conf setting.

Table 3.1. Dell Storage Center settings

Parameter/etc/cinder/cinder.conf settingDescription

CinderDellScBackendName

volume_backend_name

(Required) An arbitrary name to identify the volume back end.

CinderDellScSanIp

san_ip

(Optional) The IP address used to reach the Dell Enterprise Manager.

CinderDellScSanLogin

san_login

(Required) The user name to login to the Dell Enterprise Manager at the CinderDellScSanIp. The default user name is Admin.

CinderDellScSanPassword

san_password

(Optional) The corresponding password of CinderDellScSanLogin.

CinderDellScSsn

dell_sc_ssn

(Required) The Dell Storage Center serial number to use.

CinderDellScIscsiIpAddress

iscsi_ip_address

(Optional) The Dell Storage Center ISCSI IP address to be used for creating volumes and snapshots.

CinderDellScIscsiPort

iscsi_port

(Optional) The ISCSI port of the Dell Storage Center array.

CinderDellScApiPort

dell_sc_api_port

(Optional) The Dell Enterprise Manager API port.

CinderDellScServerFolder

dell_sc_server_folder

(Required) The Server folder in Dell Storage Center where the new server definitions are placed.

CinderDellScVolumeFolder

dell_sc_volume_folder

(Required) The Server folder in Dell Storage Center where the new volumes are created.