Chapter 3. Define a Single Back End
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. For more information, see the Custom Block Storage Back End Deployment Guide.
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 namedcinder-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 tocinder-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.
Parameter | /etc/cinder/cinder.conf setting | Description |
---|---|---|
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 |
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 |
CinderDellScVolumeFolder | dell_sc_volume_folder |
(Required) The |