Red Hat Training
A Red Hat training course is available for Red Hat OpenStack Platform
Chapter 3. Define a Single Back End
This section describes the deployment of a single back end. Deploying multiple instances of a Dell EqualLogic 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 EMC PS Series 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-dellps-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-dellps-config.yaml ~/templates/
Afterwards, open the copy (~/templates/cinder-dellps-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 EMC PS Series backend, configured via puppet resource_registry: OS::TripleO::Services::CinderBackendDellPs: ../puppet/services/cinder-backend-dellps.yaml # 1 parameter_defaults: # 2 CinderEnableDellPsBackend: true # 3 CinderDellPsBackendName: 'tripleo_dellps' CinderDellPsSanIp: '' CinderDellPsSanLogin: '' CinderDellPsSanPassword: '' CinderDellPsSanThinProvision: true CinderDellPsGroupname: 'group-0' CinderDellPsPool: 'default' CinderDellPsChapLogin: '' CinderDellPsChapPassword: '' CinderDellPsUseChap: false
- 1
- The OS::TripleO::Services::CinderBackendDellPs parameter in the
resource_registry
section refers to a composable service template namedcinder-backend-dellps.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-dellps.yaml
relatively. As such, update this parameter with the absolute path to the file:resource_registry: OS::TripleO::ControllerExtraConfigPre: /usr/share/openstack-tripleo-heat-templates/puppet/services/cinder-backend-dellps.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-backend-dellps.yaml
. - 3
- The CinderEnableDellPsBackend: true line instructs the Director to use the puppet manifests necessary for the default configuration of a Dell EMC PS Series back end. This includes defining the volume driver that the Block Storage service should use (specifically,
cinder.volume.drivers.dell_emc.ps.PSSeriesISCSIDriver
).
To define your Dell EMC PS Series 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 EMC PS Series settings
Parameter | /etc/cinder/cinder.conf setting | Description |
---|---|---|
CinderDellPsBackendName | volume_backend_name | An arbitrary name to identify the volume back end. |
CinderDellPsSanIp | san_ip | The IP address used to reach the Dell EMC PS Series Group through SSH. |
CinderDellPsSanLogin | san_login |
The user name to login to the Group manager via SSH at the CinderDellPsSanIp. The default user name is |
CinderDellPsSanPassword | san_password |
The corresponding password of CinderDellPsSanLogin. The default password is |
CinderDellPsSanThinProvision | san_thin_provision |
Sets whether thin provisioning for SAN volumes is enabled ( |
CinderDellPsGroupname | eqlx_group_name |
The group to be used for a pool where the Block Storage service will create volumes and snapshots. The default group is |
CinderDellPsPool | eqlx_pool |
The pool where the Block Storage service will create volumes and snapshots. This option cannot be used for multiple pools utilized by the Block Storage service on a single Dell EMC PS Series Group. The default pool is |
CinderDellPsChapLogin | eqlx_chap_login |
The CHAP login account for each volume in a pool. The default account name is |
CinderDellPsChapPassword | eqlx_chap_password | The corresponding password of CinderDellPsChapLogin. The default password is randomly generated in hexadecimal, so you must set this password manually. |
CinderDellPsUseChap | eqlx_use_chap |
Sets whether CHAP authentication is disabled ( |