Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1387723

Summary: [Docs][Director] Glance NFS backend instructions update
Product: Red Hat OpenStack Reporter: Jiri Stransky <jstransk>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 10.0 (Newton)CC: dcadzow, dmacpher, egafford, ekuvaja, mandreou, mburns, pgrist, sasha, srevivo
Target Milestone: ga   
Target Release: 10.0 (Newton)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-01-17 05:37:29 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Jiri Stransky 2016-10-21 16:22:59 UTC 
Previosly when we wanted Glance backed by NFS, we used glance with 'file' backend and the storage directory was a NFS mount managed by pacemaker. With moving to new HA model and composable services, we no longer necessarily have pacemaker on the nodes hosting glance-api.

There will be changes in related configuration parameters, as the new semantics don't fully match the old way. (Even though we only ever tested and documented NFS, pacemaker was in theory capable of mounting other things, and the old param names went with the pacemaker semantics on that.)

See bug 1385368 for the actual code changes and discussion.


The new way of deploying Glance on NFS is like this:

parameter_defaults:
  GlanceBackend: file
  GlanceNfsEnabled: true
  GlanceNfsShare: 172.16.10.251:/export/glance
  # optionally also fill in GlanceNfsOptions to set the mount options
  # in case the default isn't sufficient in some environments

So in terms of migrating from the old parameters, these changes have to be performed by users in their custom storage-environment.yaml in case they use NFS:

GlanceBackend stays 'file'
GlanceFilePcmkManage: true -> GlanceNfsEnabled: true
GlanceFilePcmkDevice: ...  -> GlanceNfsShare: ...
GlanceFilePcmkOptions: ... -> GlanceNfsOptions: ...

(GlanceFilePcmkFstype went away as pcmk went away for this use case, but AFAIK we were never got to use it for something other than NFS, which was the default)

The patches that implement the new functionality aren't merged yet but i suspect we'll go with this interface.

This is the one where docs-affecting changes are visible:
https://review.openstack.org/389285

This one is more on the backend, just for reference perhaps:
https://review.openstack.org/389285
Comment 1 Jiri Stransky 2016-10-21 16:26:48 UTC 
(The part above about migrating from the old parameters should probably be in the upgrade docs for 9->10.)
Comment 2 Dan Macpherson 2017-01-17 05:37:29 UTC 
These were included as a part of 3.4.1. Pre-Upgrade Notes for the Overcloud

https://access.redhat.com/documentation/en/red-hat-openstack-platform/10/single/upgrading-red-hat-openstack-platform/#sect-Pre-Upgrade_Notes_for_Overcloud

The new options are also in the Advanced Overcloud Guide:

https://access.redhat.com/documentation/en/red-hat-openstack-platform/10/paged/advanced-overcloud-customization/chapter-10-storage-configuration

Closing this BZ.