diff --git a/doc/config-reference/block-storage/drivers/solidfire-volume-driver.xml b/doc/config-reference/block-storage/drivers/solidfire-volume-driver.xml index e366e053f8..92fd726116 100644 --- a/doc/config-reference/block-storage/drivers/solidfire-volume-driver.xml +++ b/doc/config-reference/block-storage/drivers/solidfire-volume-driver.xml @@ -18,32 +18,20 @@ san_ip = 172.17.1.182 # the address of your MVIP san_login = sfadmin # your cluster admin login san_password = sfpassword # your cluster admin password -sf_account_prefix = '' # prefix for tenant account creation on solidfire cluster (see warning below) +sf_account_prefix = '' # prefix for tenant account creation on solidfire cluster - The SolidFire driver creates a unique account prefixed - with + Older versions of the SolidFire driver (prior to Icehouse) + created a unique account prefixed with $cinder-volume-service-hostname-$tenant-id - on the SolidFire cluster for each tenant that accesses the - cluster through the Volume API. Unfortunately, this - account formation results in issues for High Availability + on the SolidFire cluster for each tenant. Unfortunately, this + account formation resulted in issues for High Availability (HA) installations and installations where the cinder-volume service can - move to a new node. HA installations can return an - Account Not Found error because - the call to the SolidFire cluster is not always going to - be sent from the same node. In installations where the - cinder-volume - service moves to a new node, the same issue can occur when - you perform operations on existing volumes, such as clone, - extend, delete, and so on. + move to a new node. The current default implementation does + not experience this issue as no prefix is used. For installations + created on a prior release, the OLD default behavior can be + configured by using the keyword "hostname" in sf_account_prefix. + - - Set the option to an empty string ('') in the - cinder.conf file. This setting results in unique accounts being - created on the SolidFire cluster, but the accounts are prefixed with the - tenant-id or any unique identifier that you choose and are - independent of the host where the cinder-volume - service resides. -