Bug 1523703

Summary:	The cephfs user guide should explain how to obtain a secretfile
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Daniel Messer <dmesser>
Component:	Documentation	Assignee:	John Brier <jbrier>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vasishta <vashastr>
Severity:	medium	Docs Contact:	Bara Ancincova <bancinco>
Priority:	unspecified
Version:	3.0	CC:	agunn, asriram, bancinco, ceph-qe-bugs, jbrier, kdreyer, tchandra
Target Milestone:	z1
Target Release:	3.2
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-03-28 14:17:05 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:
Bug Blocks:	1668330

Description Daniel Messer 2017-12-08 16:10:50 UTC

Description of problem:

Right now, when setting up a client for use with CephFS the docs talk about creating a user with cephx. It then asks the reader to mount the CephFS with a username and secretfile. However nowhere it's explained how to actually get / create this secret file. One has to google/go to docs.ceph.com for this to learn that it's actually just the keyring in cleartext.

Version-Release number of selected component (if applicable):

RHCS 3.0

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html/ceph_file_system_guide/deploying-ceph-file-systems#manually-mounting-the-ceph-file-system-as-a-kernel-client

Comment 5 John Brier 2018-11-08 00:42:41 UTC

I ran into this too. I tried passing in the keyring file:

[root@jb-rhel-client ceph]$ mount -t ceph 192.168.122.213:/ /mnt/cephfs/ -o name=1,secretfile=/etc/ceph/ceph.client.1.keyring
secret is not valid base64: Invalid argument.
adding ceph secret key to kernel failed: Invalid argument.
failed to parse ceph_options


Googled 'secret is not valid base64: Invalid argument.' and found the answer here:

http://lists.ceph.com/pipermail/ceph-users-ceph.com/2017-July/019385.html

It worked right away.

Comment 9 John Brier 2019-03-28 14:17:05 UTC

These changes are published on the portal: 

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html-single/ceph_file_system_guide/#creating-ceph-file-system-client-users

closing