Project

General

Profile

Actions

Documentation #37746

closed

Documentation #43031: CephFS Documentation Sprint 3

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

Added by Марк Коренберг over 5 years ago. Updated over 4 years 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.

Actions #1

Updated by Марк Коренберг over 5 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
Actions #2

Updated by Greg Farnum over 5 years ago

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

Updated by Patrick Donnelly over 5 years ago

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

Updated by Patrick Donnelly about 5 years ago

  • Target version changed from v14.0.0 to v15.0.0
Actions #5

Updated by Patrick Donnelly about 5 years ago

  • Target version deleted (v15.0.0)
Actions #6

Updated by Patrick Donnelly almost 5 years 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
Actions #7

Updated by Patrick Donnelly over 4 years 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.

Actions #8

Updated by Марк Коренберг over 4 years ago

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

Actions #9

Updated by Patrick Donnelly over 4 years 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.

Actions #10

Updated by Patrick Donnelly over 4 years ago

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

Updated by Patrick Donnelly over 4 years ago

  • Parent task set to #43031
Actions #12

Updated by Patrick Donnelly over 4 years ago

  • Status changed from New to In Progress
Actions #13

Updated by Jos Collin over 4 years 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?

Actions #14

Updated by Марк Коренберг over 4 years 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.

Actions #15

Updated by Jos Collin over 4 years 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.

Actions #16

Updated by Jos Collin over 4 years ago

  • Pull request ID set to 32498
Actions #17

Updated by Patrick Donnelly over 4 years ago

  • Status changed from In Progress to Resolved
Actions

Also available in: Atom PDF