Bug 1387723 - [Docs][Director] Glance NFS backend instructions update
Summary: [Docs][Director] Glance NFS backend instructions update
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 10.0 (Newton)
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ga
: 10.0 (Newton)
Assignee: Dan Macpherson
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-10-21 16:22 UTC by Jiri Stransky
Modified: 2019-10-02 20:31 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-17 05:37:29 UTC
Target Upstream Version:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1385368 0 unspecified CLOSED Glance NFS share not mounted (pacemaker resource not created) 2021-02-22 00:41:40 UTC

Internal Links: 1385368

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


Note You need to log in before you can comment on or make changes to this bug.