Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

Chapter 3. Define a Single Back End

Important

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 named cinder-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 to cinder-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 settingDescription

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

CinderDellPsSanPassword

san_password

The corresponding password of CinderDellPsSanLogin. The default password is password.

CinderDellPsSanThinProvision

san_thin_provision

Sets whether thin provisioning for SAN volumes is enabled (true), as is required for this setup.

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 group-0.

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

CinderDellPsChapLogin

eqlx_chap_login

The CHAP login account for each volume in a pool. The default account name is chapadmin.

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 (false by default) or enabled (true).