Commit Graph

405 Commits

Author SHA1 Message Date
Varsha Rao
90f79ed87f doc: Update about extended attributes
Signed-off-by: Varsha Rao <varao@redhat.com>
2020-01-30 01:16:27 +05:30
Patrick Donnelly
c74a261e5b
Merge PR #32522 into master
* refs/pull/32522/head:
	doc/cephfs: improve wording in mount-prerequisites.rst
	doc: migrate best practices recommendations to relevant docs
	doc/cephfs: rename doc/cephfs/kernel.rst & doc/cephfs/fuse.rst

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2020-01-21 15:15:12 -08:00
Ilya Dryomov
267c00012a doc/cephfs/client-auth: description and example are inconsistent
According to the path restriction example, the filesystem name
should be cephfs_a, not cephfs.  Converge on cephfs_a to avoid it
being confused with with the pool tag, which is always cephfs.

This was introduced in 160c4bfeb8 ("mon/AuthMonitor: Use new osd
auth caps for ceph fs authorize").

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2020-01-21 19:57:09 +01:00
Rishabh Dave
07cd0e7d31 doc/cephfs: improve wording in mount-prerequisites.rst
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2020-01-21 14:44:02 +05:30
Rishabh Dave
7067776658 doc: migrate best practices recommendations to relevant docs
Also, move the common part from "Mount using FUSE" doc and "Mount using
kernel" doc to "Mount CephFS" page to avoid repetitions.

Fixes: https://tracker.ceph.com/issues/43154
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2020-01-21 14:42:18 +05:30
Rishabh Dave
f6ea1ca36f doc/cephfs: rename doc/cephfs/kernel.rst & doc/cephfs/fuse.rst
Rename to mount-using-kernel.rst and mount-using-fuse.rst respectively
so that it's easier to find them in doc/cephfs directory.

Signed-off-by: Rishabh Dave <ridave@redhat.com>
2020-01-20 10:32:06 +05:30
Patrick Donnelly
47d8515975
Merge PR #32498 into master
* refs/pull/32498/head:
	doc: mounting CephFS subdirectory and Persistent Mounts cleanup

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2020-01-06 12:42:05 -08:00
Patrick Donnelly
7fde99ac06
Merge PR #32015 into master
* refs/pull/32015/head:
	doc/cephfs/standby: document mds_join_fs
	mgr/cephadm: map mds daemons to a particular fs
	mon/MDSMonitor: respect mfs fscid preference
	mon/MDSMonitor: assign standbys to their preferred fscid
	mds/FSMap: track preferred fscid for standby daemons
	mds: add mds_join_fs option; pass via MMDSBeacon

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2020-01-06 12:29:50 -08:00
Jos Collin
1033d5b373
doc: mounting CephFS subdirectory and Persistent Mounts cleanup
Fixes: https://tracker.ceph.com/issues/37746
Signed-off-by: Jos Collin <jcollin@redhat.com>
2020-01-06 18:33:26 +05:30
Jos Collin
9f4a20e653
doc: fix Getting Started with CephFS
Signed-off-by: Jos Collin <jcollin@redhat.com>
2020-01-02 12:04:50 +05:30
Patrick Donnelly
1949ddf0e2
Merge PR #32117 into master
* refs/pull/32117/head:
	doc: add config help/get/set section for runtime client configuration

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-19 11:59:24 -08:00
Jos Collin
f35d03a037
doc: update '--force' flag to be precise
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-12-19 12:09:34 +05:30
Sage Weil
9aa25d7df8 doc/cephfs/standby: document mds_join_fs
Signed-off-by: Sage Weil <sage@redhat.com>
2019-12-18 14:00:42 -06:00
Jos Collin
cb7614adea
doc: update 'adding an MDS'
Fixes: https://tracker.ceph.com/issues/43162
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-12-17 16:11:27 +05:30
Venky Shankar
6373f8c763 doc: add config help/get/set section for runtime client configuration
Fixes: http://tracker.ceph.com/issues/41688
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2019-12-17 04:52:16 -05:00
Patrick Donnelly
0efa73f029
mds: update default MDS cache size memory limit
1GB is too low as a default and usually results in cache size warnings
at that size; the MDS will struggle to maintain such a small cache size
for most workloads.

Fixes: https://tracker.ceph.com/issues/43182
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-11 15:28:57 -08:00
Patrick Donnelly
2216c63ed5
Merge PR #31729 into master
* refs/pull/31729/head:
	qa: reduce cache size further
	mds: obsoleting 'mds_cache_size'

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-11 09:44:27 -08:00
Patrick Donnelly
4635f943cd
Merge PR #32124 into master
* refs/pull/32124/head:
	doc/cephfs/disaster-recovery-experts: Add link for scrub and note for scrub_path

Reviewed-by: Rishabh Dave <ridave@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-09 19:52:41 -08:00
Patrick Donnelly
b8635afe10
Merge PR #32038 into master
* refs/pull/32038/head:
	doc: reorganize CephFS landing page and ToC

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Reviewed-by: Sage Weil <sage@redhat.com>
Reviewed-by: Rishabh Dave <ridave@redhat.com>
2019-12-09 16:36:59 -08:00
Varsha Rao
f6241d1c07 doc/cephfs/disaster-recovery-experts: Add link for scrub and note for scrub_path
Fixes: https://tracker.ceph.com/issues/22204
Signed-off-by: Varsha Rao <varao@redhat.com>
2019-12-09 18:17:41 +05:30
Patrick Donnelly
7141cf6db9
doc: reorganize CephFS landing page and ToC
Fixes: https://tracker.ceph.com/issues/42016
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-06 12:15:52 -08:00
Patrick Donnelly
45907ee258
Merge PR #31897 into master
* refs/pull/31897/head:
	doc: obsolete entries for allow_standby_replay
	wip-doc: entries obsoleted by allow_standby_replay

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-12-05 16:05:59 -08:00
Rodrigo Severo
2ee56b6a68 doc: obsolete entries for allow_standby_replay
Nautilus release presented the allow_standby_replay fs setting that obsdoleted
several MDS config entries:  mds_standby_for_*, mon_force_standby_active, and
mds_standby_replay.

Removing entries instead of just marking them as "Obsolete' as per batrick
suggestion.

Signed-off-by: Rodrigo Severo <rodrigo@fabricadeideias.com>
2019-12-05 13:41:33 -03:00
Ramana Raja
aeaef1b4c5 mds: obsoleting 'mds_cache_size'
Remove last bits of support for 'mds_cache_size'.
'mds_cache_memory_limit' is preferred.

Fixes: https://tracker.ceph.com/issues/41951
Signed-off-by: Ramana Raja <rraja@redhat.com>
2019-12-02 14:51:25 +05:30
Yan, Zheng
eb57c3b6f2 doc: add description for fuse_disable_pagecache
Signed-off-by: "Yan, Zheng" <zyan@redhat.com>
Fixes: https://tracker.ceph.com/issues/16300
2019-11-27 14:44:44 +08:00
Rodrigo Severo
9be267fff4 wip-doc: entries obsoleted by allow_standby_replay
Nautilus release presented the allow_standby_replay fs setting that obsdoleted
several MDS config entries:  mds_standby_for_*, mon_force_standby_active, and
mds_standby_replay.

Signed-off-by: Rodrigo Severo <rodrigo@fabricadeideias.com>
2019-11-26 16:32:56 -03:00
Patrick Donnelly
f1e3fec83d
Merge PR #27467 into master
* refs/pull/27467/head:
	cephfs-shell: add snapshot management

Reviewed-by: Rishabh Dave <ridave@redhat.com>
Reviewed-by: Varsha Rao <varao@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-26 09:47:40 -08:00
Ramana Raja
caba9474a3
Merge pull request #30336 from joscollin/wip-F40959-subvolume-uid-gid
mgr/volumes: uid, gid for subvolume create and subvolumegroup create commands
2019-11-19 14:16:46 +05:30
Patrick Donnelly
1715c644c3
Merge PR #30754 into master
* refs/pull/30754/head:
	doc/cephfs: merge fstab doc with respective mount docs
	doc: add systemd unit part for FUSE mounts in fstab doc
	doc: update and improve "mount using kernel driver" doc
	doc: update and improve "mount using FUSE" doc

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-14 06:14:44 -08:00
Jos Collin
596c1fef6b
doc: uid, gid for subvolume create and subvolumegroup create commands
Fixes: https://tracker.ceph.com/issues/40959
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-11-14 14:37:49 +05:30
Rishabh Dave
ab9185187d doc/cephfs: merge fstab doc with respective mount docs
Fixes: https://tracker.ceph.com/issues/42601
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-14 10:02:01 +05:30
Rishabh Dave
6e3a070d45 doc: add systemd unit part for FUSE mounts in fstab doc
To make FUSE-mounted CephFS persist across reboots, user also needs to
start and enable the systemd units. Add that part to the document for
fstab, instead of mentioning it in "Mount CephFS using FUSE" doc. Also,
wrap few lines and rename mountpoint to /mnt/mycephfs in examples to
keep them same across docs.

Fixes: https://tracker.ceph.com/issues/42298
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-13 11:10:47 +05:30
Rishabh Dave
03d8fdbb49 doc: update and improve "mount using kernel driver" doc
Move the examples of mount command for Ceph cluster with CephX enabled
to the top of page, since it is enabled by default, improve explanation
around Ceph with multiple FSs, get rid of hash symbols before every
command (without them it's clear that the text is command and with them
the reader cannot use the commands directly), link fstab page, add how
mount in general looks, add prerequisites required for kernel mounts and
expand explanation wherever possible.

Fixes: https://tracker.ceph.com/issues/42220
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-13 11:10:47 +05:30
Rishabh Dave
cd34b96e4d doc: update and improve "mount using FUSE" doc
Recommend keyring permission to be 600 instead of 644, show examples
for `-k`, `-r`, `-m` and `--client_mds_namespace` options, move
references to the bottom of the page,  show how to unmount FUSE-mounted
CephFS, copy the tip about unmounting from "mount using kernel" page to
"mount using FUSE" page, correct commands for automating FUSE mounts,
add sub-headings to the document and add how ceph-fuse command looks in
general.

Fixes: https://tracker.ceph.com/issues/42205
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-13 11:10:41 +05:30
Patrick Donnelly
a6b7ca3800
Merge PR #31157 into master
* refs/pull/31157/head:
	doc: update inf/infinite option for subvolume resize
	qa/tasks: fs subvolume resize inf command
	mgr/volumes: fs subvolume resize inf/infinite command

Reviewed-by: Ramana Raja <rraja@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-12 09:25:26 -08:00
Jos Collin
e5bad7d4a6
doc: update inf/infinite option for subvolume resize
Fixes: https://tracker.ceph.com/issues/42479
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-11-07 18:08:53 +05:30
root
aca5c81959 ceph: Add doc for deploying cephfs-nfs cluster using rook
Fixes: https://tracker.ceph.com/issues/42195
Signed-off-by: Varsha Rao <varao@redhat.com>
2019-11-06 18:20:26 +05:30
Milind Changire
73597e94f1 cephfs-shell: add snapshot management
Snapshots can be managed by:
$ snap {create|delete} snap_name dir_name

Fixes: http://tracker.ceph.com/issues/38681
Signed-off-by: Milind Changire <mchangir@redhat.com>
2019-11-04 16:17:32 +05:30
Patrick Donnelly
5b8b8d5111
Merge PR #30751 into master
* refs/pull/30751/head:
	doc: Document Export Process during Subtree Migrations

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-03 01:38:27 -07:00
Patrick Donnelly
7b331f05af
Merge PR #30749 into master
* refs/pull/30749/head:
	doc: document mds journal event types

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Douglas Fuller <dfuller@redhat.com>
2019-11-03 01:03:22 -07:00
Patrick Donnelly
f64688880d
Merge PR #30054 into master
* refs/pull/30054/head:
	doc: fs subvolume resize command
	qa/tasks: tests for resize subvolume
	mgr/volumes: fs subvolume resize command

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-01 15:57:56 -07:00
Patrick Donnelly
b4f772d4f0
Merge PR #30369 into master
* refs/pull/30369/head:
	doc/cephfs: add doc for cephfs io path

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-10-29 15:32:18 -07:00
Patrick Donnelly
292e0064ca
doc: document rank option for journal reset
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2019-10-28 11:13:34 -07:00
Jos Collin
04b6b73715
doc: fs subvolume resize command
Fixes: https://tracker.ceph.com/issues/41182
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-10-24 16:07:18 +05:30
Yan, Zheng
2328698995 doc/cephfs: add doc for cephfs io path
Fixes: https://tracker.ceph.com/issues/41738
Signed-off-by: "Yan, Zheng" <zyan@redhat.com>
2019-10-23 16:01:07 +08:00
Patrick Donnelly
ed9c5f7f7e
Merge PR #30585 into master
* refs/pull/30585/head:
	docs/cephfs-shell: update doc about pyscript
	cephfs-shell: make compatible with cmd2 versions after 0.9.13

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Varsha Rao <varao@redhat.com>
2019-10-14 11:26:46 -07:00
Sidharth Anupkrishnan
80d2161197 doc: Document Export Process during Subtree Migrations
Signed-off-by: Sidharth Anupkrishnan <sanupkri@redhat.com>
2019-10-09 15:02:26 +05:30
Patrick Donnelly
559032d7b3
Merge PR #30476 into master
* refs/pull/30476/head:
	doc: list FS subvolumes, subvolume groups and their snapshots
	qa/tasks: tests for ls
	mgr/volumes: list FS subvolumes, subvolume groups and their snapshots

Reviewed-by: Ramana Raja <rraja@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-10-08 11:43:24 -07:00
Jos Collin
b5769367d5
doc: list FS subvolumes, subvolume groups and their snapshots
Fixes: https://tracker.ceph.com/issues/41842
Signed-off-by: Jos Collin <jcollin@redhat.com>
2019-10-08 11:54:00 +05:30
Venky Shankar
ba5e7042fc doc: document mds journal event types
Fixes: http://tracker.ceph.com/issues/42190
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2019-10-07 16:39:31 +05:30