Project

General

Profile

Documentation #37746

Documentation #43031: CephFS Documentation Sprint 3

doc: how to mount a subdir with ceph-fuse/kclient

Added by Марк Коренберг almost 2 years ago. Updated 11 months ago.

Status:
Resolved
Priority:
High
Assignee:
Category:
Administration/Usability
Target version:
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Labels (FS):
task(easy)
Pull request ID:

Description

I looked in these links:
http://docs.ceph.com/docs/master/cephfs/fuse/
http://docs.ceph.com/docs/master/cephfs/fstab/

But finally found that:
https://forum.proxmox.com/threads/mount-cephfs-using-ceph-fuse-on-boot.23608/

Original documentation prescribes to write "none" as the source of mounting, But actually it is parsed!

Some parameters may be specified in the part of fstab entry signifying source of mounting (i.e. in place of "none")
And other (or same set ?) can be set up as "options" part.

So, the Documentation should describe at least these things:
1. Options that could be passed instead of none
2. Say exactly the preferred way of mounting subdir of CephFS using FUSE way.

History

#1 Updated by Марк Коренберг almost 2 years ago

In order not to loose linked info from https://forum.proxmox.com/threads/mount-cephfs-using-ceph-fuse-on-boot.23608/, I will write it here:

working example of FSTAB entry:

client_mountpoint=/,id=admin,mon_host=10.0.0.126,mon_host=10.0.0.127,mon_host=10.0.0.128,key=AUTH_KEY    /ceph    fuse.ceph    defaults,noatime    0    0

#2 Updated by Greg Farnum almost 2 years ago

  • Project changed from Ceph to CephFS
  • Category deleted (documentation)

#3 Updated by Patrick Donnelly almost 2 years ago

  • Start date deleted (12/24/2018)
  • Affected Versions deleted (v14.0.0)
  • Labels (FS) task(easy) added

#4 Updated by Patrick Donnelly over 1 year ago

  • Target version changed from v14.0.0 to v15.0.0

#5 Updated by Patrick Donnelly over 1 year ago

  • Target version deleted (v15.0.0)

#6 Updated by Patrick Donnelly over 1 year ago

  • Subject changed from It's not said how to mount subdir using CephFS + FUSE to doc: how to mount a subdir with ceph-fuse/kclient
  • Category set to Administration/Usability
  • Assignee set to Patrick Donnelly
  • Priority changed from Normal to High
  • Target version set to v15.0.0
  • Backport set to nautilus,mimic

#7 Updated by Patrick Donnelly about 1 year ago

  • Status changed from New to Rejected
  • Assignee deleted (Patrick Donnelly)

I believe the current documentation already shows how to mount a subdir. Please reopen if you can cite the specific problem.

#8 Updated by Марк Коренберг about 1 year ago

No, please reopen. Nothing has been changed in that direction.

#9 Updated by Patrick Donnelly about 1 year ago

  • Status changed from Rejected to New

Okay I see. This is not addressed in

https://github.com/ceph/ceph/pull/30754

either. We'll work on this.

#10 Updated by Patrick Donnelly about 1 year ago

  • Assignee set to Jos Collin
  • Backport deleted (nautilus,mimic)

#11 Updated by Patrick Donnelly about 1 year ago

  • Parent task set to #43031

#12 Updated by Patrick Donnelly about 1 year ago

  • Status changed from New to In Progress

#13 Updated by Jos Collin 12 months ago

Марк Коренберг wrote:

In order not to loose linked info from https://forum.proxmox.com/threads/mount-cephfs-using-ceph-fuse-on-boot.23608/, I will write it here:

working example of FSTAB entry:

[...]

Looks like you are talking about old format fstab. I don't find anything wrong with [1] is having 'none' at this point. However, we have a section [2], which talks about the old format fstab support.

[1] https://docs.ceph.com/docs/master/cephfs/fuse/#persistent-mounts
[2] https://docs.ceph.com/docs/master/man/8/mount.fuse.ceph/#additional-info

We don't understand why you think it's necessary to put options in the device part of the fstab. Those options were not being parsed in the usual options field of the fstab?

#14 Updated by Марк Коренберг 12 months ago

Well,
1. I don't consider using options in the device part. I just found a working example and wondered that there are two approaches for specifying options.
2. I still don't see documented option to specify subdir in fstab.

#15 Updated by Jos Collin 12 months ago

Марк Коренберг wrote:

Well,
1. I don't consider using options in the device part. I just found a working example and wondered that there are two approaches for specifying options.

While creating this doc, we have verified that this example [1] works as expected. The older format support is specified here [2].
[1] https://docs.ceph.com/docs/master/cephfs/fuse/#persistent-mounts
[2] https://docs.ceph.com/docs/master/man/8/mount.fuse.ceph/#additional-info

2. I still don't see documented option to specify subdir in fstab.

Let me check that.

#16 Updated by Jos Collin 11 months ago

  • Pull request ID set to 32498

#17 Updated by Patrick Donnelly 11 months ago

  • Status changed from In Progress to Resolved

Also available in: Atom PDF