Defined Type: cinder::backend::ibm_svf

Defined in:
manifests/backend/ibm_svf.pp

Overview

Define: cinder::backend::ibm_svf

Setup Cinder to use the IBM Spectrum Virtualize Family(Svf) Driver Compatible for multiple backends

Parameters

san_ip

(required) IP address of IBM Svf SAN controller.

san_login

(required) Username for IBM Svf SAN controller.

san_password

(required) Password for IBM Svf SAN controller.

storwize_svc_volpool_name

(required) Comma separated list of storage pools for volumes.

storwize_svc_allow_tenant_qos

(optional) Allow tenants to specify QoS on create. Defaults to $facts.

storwize_svc_connection_protocol

(optional) The Storage protocol, iSCSI or FC. This determines the Volume Driver to be configured; StorwizeSVCISCSIDriver or StorwizeSVCFCDriver. Defaults to ‘iSCSI’

storwize_svc_iscsi_chap_enabled

(optional) Configure CHAP authentication for iSCSI connections. Defaults to $facts.

storwize_svc_retain_aux_volume

(optional) Defines an optional parameter to retain an auxiliary volume in a mirror relationship upon deletion of the primary volume or moving it to a non-mirror relationship. Defaults to $facts.

storwize_portset

(optional) Specifies the name of the portset in which host is to be created. Defaults to $facts.

volume_backend_name

(optional) The storage backend name. Defaults to the name of the backend

backend_availability_zone

(Optional) Availability zone for this volume backend. If not set, the storage_availability_zone option value is used as the default for all backends. Defaults to $facts.

image_volume_cache_enabled

(Optional) Enable Cinder’s image cache function for this backend. Defaults to $facts,

image_volume_cache_max_size_gb

(Optional) Max size of the image volume cache for this backend in GB. Defaults to $facts,

image_volume_cache_max_count

(Optional) Max number of entries allowed in the image volume cache. Defaults to $facts,

reserved_percentage

(Optional) The percentage of backend capacity is reserved. Defaults to $facts.

max_over_subscription_ratio

(Optional) Representation of the over subscription ratio when thin provisionig is involved. Defaults to $facts.

manage_volume_type

(Optional) Whether or not manage Cinder Volume type. If set to true, a Cinder Volume type will be created with volume_backend_name=$volume_backend_name key/value. Defaults to false.

extra_options

(optional) Hash of extra options to pass to the backend stanza Defaults to: {} Example :

{ 'ibm_svf_backend/param1' => { 'value' => value1 } }#

Parameters:

  • san_ip (Any)
  • san_login (Any)
  • san_password (Any)
  • storwize_svc_volpool_name (Any)
  • storwize_svc_allow_tenant_qos (Any) (defaults to: $facts['os_service_default'])
  • storwize_svc_connection_protocol (Enum['iSCSI', 'FC']) (defaults to: 'iSCSI')
  • storwize_svc_iscsi_chap_enabled (Any) (defaults to: $facts['os_service_default'])
  • storwize_svc_retain_aux_volume (Any) (defaults to: $facts['os_service_default'])
  • storwize_portset (Any) (defaults to: $facts['os_service_default'])
  • volume_backend_name (Any) (defaults to: $name)
  • backend_availability_zone (Any) (defaults to: $facts['os_service_default'])
  • image_volume_cache_enabled (Any) (defaults to: $facts['os_service_default'])
  • image_volume_cache_max_size_gb (Any) (defaults to: $facts['os_service_default'])
  • image_volume_cache_max_count (Any) (defaults to: $facts['os_service_default'])
  • reserved_percentage (Any) (defaults to: $facts['os_service_default'])
  • max_over_subscription_ratio (Any) (defaults to: $facts['os_service_default'])
  • extra_options (Hash) (defaults to: {})
  • manage_volume_type (Boolean) (defaults to: false) 


89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
 
# File 'manifests/backend/ibm_svf.pp', line 89

define cinder::backend::ibm_svf (
  $san_ip,
  $san_login,
  $san_password,
  $storwize_svc_volpool_name,
  $storwize_svc_allow_tenant_qos                        = $facts['os_service_default'],
  Enum['iSCSI', 'FC'] $storwize_svc_connection_protocol = 'iSCSI',
  $storwize_svc_iscsi_chap_enabled                      = $facts['os_service_default'],
  $storwize_svc_retain_aux_volume                       = $facts['os_service_default'],
  $storwize_portset                                     = $facts['os_service_default'],
  $volume_backend_name                                  = $name,
  $backend_availability_zone                            = $facts['os_service_default'],
  $image_volume_cache_enabled                           = $facts['os_service_default'],
  $image_volume_cache_max_size_gb                       = $facts['os_service_default'],
  $image_volume_cache_max_count                         = $facts['os_service_default'],
  $reserved_percentage                                  = $facts['os_service_default'],
  $max_over_subscription_ratio                          = $facts['os_service_default'],
  Hash $extra_options                                   = {},
  Boolean $manage_volume_type                           = false,
) {

  include cinder::deps

  # NOTE: Svf was earlier called as storwize/svc driver, so the cinder
  # configuration parameters were named accordingly.
  $volume_driver = $storwize_svc_connection_protocol ? {
    'FC'    => 'cinder.volume.drivers.ibm.storwize_svc.storwize_svc_fc.StorwizeSVCFCDriver',
    default => 'cinder.volume.drivers.ibm.storwize_svc.storwize_svc_iscsi.StorwizeSVCISCSIDriver',
  }

  cinder_config {
    "${name}/volume_backend_name":             value => $volume_backend_name;
    "${name}/backend_availability_zone":       value => $backend_availability_zone;
    "${name}/image_volume_cache_enabled":      value => $image_volume_cache_enabled;
    "${name}/image_volume_cache_max_size_gb":  value => $image_volume_cache_max_size_gb;
    "${name}/image_volume_cache_max_count":    value => $image_volume_cache_max_count;
    "${name}/reserved_percentage":             value => $reserved_percentage;
    "${name}/max_over_subscription_ratio":     value => $max_over_subscription_ratio;
    "${name}/volume_driver":                   value => $volume_driver;
    "${name}/san_ip":                          value => $san_ip;
    "${name}/san_login":                       value => $san_login;
    "${name}/san_password":                    value => $san_password, secret => true;
    "${name}/storwize_svc_volpool_name":       value => join(any2array($storwize_svc_volpool_name), ',');
    "${name}/storwize_svc_allow_tenant_qos":   value => $storwize_svc_allow_tenant_qos;
    "${name}/storwize_svc_iscsi_chap_enabled": value => $storwize_svc_iscsi_chap_enabled;
    "${name}/storwize_svc_retain_aux_volume":  value => $storwize_svc_retain_aux_volume;
    "${name}/storwize_portset":                value => $storwize_portset;
  }

  if $manage_volume_type {
    cinder_type { $volume_backend_name:
      ensure     => present,
      properties => {'volume_backend_name' => $volume_backend_name},
    }
  }

  create_resources('cinder_config', $extra_options)

}