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

Bug 1718991

Summary:	Document how to configure Manila with CephFS via external NFS (Ganesha)
Product:	Red Hat OpenStack	Reporter:	Giulio Fidente <gfidente>
Component:	documentation	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	CLOSED DEFERRED	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	13.0 (Queens)	CC:	asimonel, gouthamr, tbarron
Target Milestone:	---	Keywords:	Documentation, ZStream
Target Release:	---
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:	2019-06-10 17:24:50 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:
Bug Depends On:	1696476
Bug Blocks:

Description Giulio Fidente 2019-06-10 17:13:35 UTC

Starting with 13z7 (as per BZ #1696476) it is possible to configure the Manila CephFS backend to use an external NFS Ganesha server, as an alternative to deploy both CephFS and Ganesha via Director

The existing documentation for CephFS via NFS [1] should be updated to mention that is is possible to use an external Ganesha service.

The existing documentation for the integration of an Overcloud with an existing Ceph cluster [2] should be updated to mention how to configure the Manila CephFS backend.

More specifically:

- in section 2.1 , at step 1 , operators should create two more pools:
  manila_data
  manila_metadata

- in section 2.1 , at step 2 , operators should create an additional ceph keyring:
  create a client.manila user configured with the following capabilities:
  mon 'allow r, allow command "auth del", allow command "auth caps", allow command "auth get", allow command "auth get-or-create"' osd 'allow rw' mds 'allow *' mgr 'allow *'

- A new account must be created on the target node hosting the Ganesha service for the Manila service to be able to log in (via SSH) on the remote node and configure Ganesha with new shares when necessary

Finally, at deployment time, an additional environment file must be passed for the CephFS configuration, as per comment [3] in BZ #1696476

1. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/cephfs_via_nfs_back_end_guide_for_the_shared_file_system_service/index

2. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/integrating_an_overcloud_with_an_existing_red_hat_ceph_cluster/index

3. https://bugzilla.redhat.com/show_bug.cgi?id=1696476#c12