Commit Graph

633 Commits

Author SHA1 Message Date
Franciszek Stachura
f841def599 doc: Fix links to CRUSH, RADOS and DSP research papers.
Signed-off-by: Franciszek Stachura <fbstachura@gmail.com>
2022-01-30 17:23:33 +01:00
Anthony D'Atri
778973176e doc/cephfs: Clean up mirroring
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2022-01-26 12:10:05 -08:00
Anthony D'Atri
822cc71b56 doc/cephfs: Clarify CephFS pool guidance
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2022-01-21 12:28:05 -08:00
Venky Shankar
a612b3cb85
Merge pull request #43618 from kotreshhr/recover-symlink
mds: Store symlink target in first data object

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-01-04 14:39:22 +05:30
Patrick Donnelly
61de84a522
Merge PR #44315 into master
* refs/pull/44315/head:
	doc/cephfs: mds default cache memory limit is now 4GB

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Xiubo Li <xiubli@redhat.com>
2021-12-20 14:41:43 -05:00
Dimitri Papadopoulos
7677651618
doc,man: typos found by codespell
Signed-off-by: Dimitri Papadopoulos <3234522+DimitriPapadopoulos@users.noreply.github.com>
2021-12-15 12:04:36 +01:00
wangxinyu
8dcbb2e500 doc/cephfs: mds default cache memory limit is now 4GB
MDS default cache memory limit is now 4GB.

Signed-off-by: wangxinyu <wangxinyu@inspur.com>
2021-12-15 14:18:41 +08:00
Kotresh HR
9b1a7dc84f mds: Store symlink target on the first data object
Problem:
The MDS only stores the symlink inode's backtrace
information in the data pool. During disaster
recovery of the metadata pool by scanning data
pool, the symlinks are recreated as regular files.

Solution:
This patch stores the symlink target on the first
data object as an xattr for recovery.

MDS option:
The mds option 'mds_symlink_recovery' is introduced
which is enabled by default. Enabling the option
stores the symlink target.

Signed-off-by: Kotresh HR <khiremat@redhat.com>
Fixes: https://tracker.ceph.com/issues/46166
2021-12-07 15:39:52 +05:30
Venky Shankar
675e4219a5
Merge pull request #44116 from lxbsz/caps_doc1
doc: fix the style of the cephfs capability doc

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2021-12-01 14:31:18 +05:30
Venky Shankar
52ad9fbcfe doc, man: document new device syntax for kclient mount
Fxies: http://tracker.ceph.com/issues/47277
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2021-11-30 01:13:34 -05:00
Xiubo Li
cfe8f05035 doc: fix the style of the cephfs capability doc
Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-11-29 08:33:38 +08:00
Venky Shankar
c152264b31
Merge pull request #43722 from lxbsz/caps_doc
doc: update the capabilities doc for cephfs

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2021-11-23 18:17:22 +05:30
Venky Shankar
93054a3fa9
Merge pull request #43886 from nmshelke/doc-fix-53054
doc: prerequisites fix for cephFS mount

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2021-11-19 10:10:59 +05:30
Xiubo Li
e966aaf6fb doc: update the capabilities doc for cephfs
Add more detail about the caps and explain more for the caps in
filelock.

Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-11-17 21:13:00 +08:00
Nikhilkumar Shelke
e369dc1128 doc: prerequisites fix for cephFS mount
Fixes: https://tracker.ceph.com/issues/53054

Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
2021-11-17 00:32:55 +05:30
Venky Shankar
785edd08a0
Merge pull request #42110 from joscollin/wip-doc-cephfs-top-misc-fixes
cephfs-top: fix Refresh interval

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2021-11-15 11:50:22 +05:30
Patrick Donnelly
6e569bfd14
doc: document subvolume (group) pins
Fixes: https://tracker.ceph.com/issues/53236
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2021-11-11 12:30:02 -05:00
Jos Collin
f7e86a92f2
cephfs-top, doc: fix Refresh interval
Signed-off-by: Jos Collin <jcollin@redhat.com>
2021-11-11 14:20:47 +05:30
Venky Shankar
3d97d6d98f doc / cephfs: health message codes should be permalinks
... so that such links can be included in alert warnings.

Additionally, document some other health warnings. Credit to @pcuzner
to point out that not all health warnings have been documented.

Signed-off-by: Venky Shankar <vshankar@redhat.com>
2021-10-14 10:21:07 +05:30
Jos Collin
d1d4cdcc39
doc: fixed typo in terminology
Signed-off-by: Jos Collin <jcollin@redhat.com>
2021-10-01 16:04:44 +05:30
Patrick Donnelly
790b49a006 Merge PR #43219 into master
* refs/pull/43219/head:
	doc: clarify MDS failed state

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2021-09-21 14:03:08 -04:00
Patrick Donnelly
c8a900c6c6 Merge PR #42763 into master
* refs/pull/42763/head:
	mon/FSCommands: add 'recover' flag in `fs new` command

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-09-20 20:46:25 -04:00
胡玮文
ce2b158f0c doc: clarify MDS failed state
Since 58eaa237b0, an MDS is only promoted if it is compatible with the
file system compat. The users may see persistent failed state even they
have enough standby daemons.

Signed-off-by: 胡玮文 <huww98@outlook.com>
2021-09-19 21:22:14 +08:00
Patrick Donnelly
e81a0c72a4 Merge PR #43144 into master
* refs/pull/43144/head:
	doc/cephfs: fix typos

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-09-17 13:47:25 -04:00
Patrick Donnelly
9051ad9323 Merge PR #43022 into master
* refs/pull/43022/head:
	doc/cephfs: add mds_dir_max_entries option into mds-config-ref.rst
	mds: add mds_dir_max_entries config option

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-09-15 22:37:26 -04:00
Patrick Donnelly
33331cf4aa Merge PR #42584 into master
* refs/pull/42584/head:
	doc: fix `daemon status` interface (exclude file system name)
	test: adjust mirroring tests for `daemon status` change
	mgr/mirroring: `daemon status` command does not require file system name

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-09-15 22:33:18 -04:00
Ramana Raja
67bb13859a mon/FSCommands: add 'recover' flag in fs new command
Currently, to recover a file system after recovering monitor store, you
need to stop all the MDSs; create FSMap with defaults using `fs new`
command; execute `fs reset` command to get the file system's rank 0 into
existing but failed state; and then restart MDSs.

Add 'recover' flag to the `fs new` command that sets the file system's
rank 0 to existing but failed state, and sets the file system's
'joinable' setting to False. Using the `fs new` command with 'recover'
flag gets rid of the steps to stop all the MDSs and execute `fs reset`
command when recovering the file system after recoving monitor store.

Fixes: https://tracker.ceph.com/issues/51716
Signed-off-by: Ramana Raja <rraja@redhat.com>
2021-09-13 00:15:39 -04:00
wangxinyu
f0d1635f26 doc/cephfs: fix typos
Signed-off-by: wangxinyu <wangxinyu@inspur.com>
2021-09-13 09:40:17 +08:00
Sebastian Wagner
d9ec8eb7a8
doc/cephadm: Add lots of links to other chapters
Signed-off-by: Sebastian Wagner <sewagner@redhat.com>
2021-09-11 20:04:14 +02:00
Yongseok Oh
fed9aba38c doc/cephfs: add mds_dir_max_entries option into mds-config-ref.rst
Signed-off-by: Yongseok Oh <yongseok.oh@linecorp.com>
2021-09-09 13:06:27 +00:00
wangxinyu
a59059b87f doc: fix typos
Signed-off-by: wangxinyu <wangxinyu@inspur.com>
2021-09-05 10:19:47 +08:00
Jeff Layton
6327a8d740 doc: document that NEARFULL conditions can result in slow writes
The change to doing sync I/Os when we're in NEARFULL conditions
apparently caught some folks by surprise. Add something to clarify that
to the kclient debugging docs.

Also, remove the incomplete sentence that follows it, which contains no
useful information.

Fixes: https://tracker.ceph.com/issues/49406
Signed-off-by: Jeff Layton <jlayton@redhat.com>
2021-08-11 09:29:16 -04:00
Venky Shankar
ed253597c9 doc: fix daemon status interface (exclude file system name)
Fixes: http://tracker.ceph.com/issues/51989
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2021-08-02 06:39:16 -04:00
Patrick Donnelly
54b649af9b doc: remove deprecated compat commands
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2021-07-30 16:28:54 -07:00
Patrick Donnelly
efb70f2b33 doc: update MDS upgrade procedure
Now that CompatSet changes to the FSMap no longer cause old MDS to
suicide.

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2021-07-30 16:28:54 -07:00
Patrick Donnelly
0e71ea4a13
Merge PR #42106 into master
* refs/pull/42106/head:
	mds: create file system with specific ID

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-07-23 11:15:33 -07:00
Kefu Chai
bb129fc0ed doc/cephfs/journaler: document options using confval directive
better maintainablity this way. and drop unsupported options of

- journaler batch interval
- journaler batch max

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-22 11:16:56 +08:00
Patrick Donnelly
4b1e101571
Merge PR #42295 into master
* refs/pull/42295/head:
	doc/cephfs: recover file system after recovering

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-07-21 13:13:43 -07:00
Ramana Raja
ffe5cfb687 doc/cephfs: recover file system after recovering
... monitor stores using OSDs. The steps are valid only to recover
single active MDS file systems.

Partially-fixes: https://tracker.ceph.com/issues/51341
Signed-off-by: Ramana Raja <rraja@redhat.com>
2021-07-16 17:20:35 -04:00
Varsha Rao
65489e8d3e doc/cephfs/nfs: update about nfs module
Signed-off-by: Varsha Rao <varao@redhat.com>
2021-07-13 15:04:42 +05:30
Varsha Rao
ce7fef695b doc/mgr/nfs: update nfs links
Signed-off-by: Varsha Rao <varao@redhat.com>
2021-07-13 14:37:39 +05:30
Varsha Rao
c79b797465 doc/cephfs: move nfs doc under mgr docs
Fixes: https://tracker.ceph.com/issues/51428
Signed-off-by: Varsha Rao <varao@redhat.com>
2021-07-13 14:37:39 +05:30
Ramana Raja
a0a8ba5087 mds: create file system with specific ID
File system will need to be recreated when monitor databases are lost
and rebuilt. Some applications (e.g., CSI) expect that the recovered
file system have the same ID as before. Allow creating a file system
with a specific ID to help in such scenarios. This can now be done by
the `fs new` command using the argument 'fscid' and 'force' flag.
Newer file systems will no longer have increasing IDs as a corollary.

Fixes: https://tracker.ceph.com/issues/51340
Signed-off-by: Ramana Raja <rraja@redhat.com>
2021-07-09 21:14:01 -04:00
Sage Weil
4537b14b34 Merge PR #41574 into master
* refs/pull/41574/head:
	qa/tasks/vstart_runner: add LocalCluster.run
	qa/tasks/cephfs/test_nfs: fiddle with sudo
	mgr/nfs/export: some cleanup, minor refactoring
	mgr/nfs/cluster: remove unused @cluster_setter
	nfs/mgr: fix help message case
	doc/cephfs/fs-nfs-export: add note about export update behavior
	mgr/nfs: move user create/delete into helper
	mgr/nfs: refactor _delete_user helper
	mgr/nfs: refactor create_export_from_dict() helper
	mgr/nfs: keep 'nfs export get' around for backward-compat
	mgr/nfs: rename method
	qa/tasks/cephfs/test_nfs: test new export via apply
	doc/cephfs/fs-nfs-export: be consistent with cluster_id and _ vs -
	mgr/nfs: addr -> client_addr for 'nfs export create ...'
	mgr/nfs: fix tests
	mgr/nfs: 'nfs export get' -> 'nfs export info'
	mgr/nfs: binding -> pseudo_path
	mgr/nfs: more revisions based on review
	mgr/nfs: adjust NFSExceptoin errno arg
	doc/cephfs: update 'nfs export {get,apply}' docs
	mgr/nfs: merge FSExport back into ExportMgr
	doc/radosgw/nfs: document mgr/nfs way to add/remove rgw exports
	mgr/nfs: merge 'nfs export {update,import}' -> 'nfs export apply'
	mgr/nfs: test export creation and list
	mgr/nfs: test export_update (+ fixes)
	mgr/nfs: test Export.validate(); several fixes
	mgr/nfs: test that export <-> block+dict conversions go both ways
	mgr/nfs: clean up test a bit
	mgr/nfs/export: fix export validation
	mgr/nfs/export: fix tests
	mgr/nfs: handle option addr/client block in create_export()
	mgr/nfs: allow multiple addrs for new exports
	mgr/nfs: fix/finish rgw export
	mgr/nfs/module: clusterid -> cluster_id
	mgr/nfs/export: fix export_update_1 to type check
	mgr/nfs/cluster: fix type error
	mgr/nfs/export: wrap long lines
	mgr/nfs: ExportMgr._delete_export only works for cephfs for now
	mgr/nfs: Remove pool_ns from NFSCluster
	mgr/nfs: Remove ExportMgr.rados_namespace
	mgr/nfs: flake8
	mgr/nfs: Add type checking
	mgr/nfs: Add __eq__ method to Export
	mgr/nfs: Add some compatibility to mgr/dashboard
	mgr/nfs: Fix whitespace handling
	mgr/nfs: Copy unit tests from mgr/dashboard
	mgr/nfs: partially implement rgw export support
	mgr/nfs: abstract FSAL; add RGWFSAL
	mgr/nfs: refactor to merge 'update' and 'import' code
	mgr/nfs: add 'nfs export import' command
	mgr/nfs: refactor 'nfs export update' and export validation
	mgr/nfs: fix _fetch_export to distinguish between clusters
	mgr/nfs: move export ganesha conf translation into caller
	mgr/nfs: name nfs cephfs client key 'nfs.{cluster_id}.{export_id}'
	mgr/nfs: add --addr to 'nfs export create'
	mgr/nfs: add --squash to 'nfs export create'
	mgr/nfs/export_utils: include false but non-None items in config
	vstart.sh: enable nfs module
	mgr/cephadm: nfs: drop attr_expiration_time from top-level config
	mgr/cephadm: remove Dir_Chunk = 0

Reviewed-by: Michael Fritch <mfritch@suse.com>
2021-06-26 10:41:27 -04:00
Sage Weil
fc304f2d56 doc/cephfs/fs-nfs-export: add note about export update behavior
Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-25 19:13:09 -04:00
Patrick Donnelly
54e5339bf9
Merge PR #41964 into master
* refs/pull/41964/head:
	doc/cephfs/nfs: update recommendation for versions

Reviewed-by: Varsha Rao <varao@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-06-22 19:45:58 -07:00
Ramana Raja
e031a59691 doc/cephfs/nfs: update recommendation for versions
... of Ceph and NFS-Ganesha packages.

Signed-off-by: Ramana Raja <rraja@redhat.com>
2021-06-21 22:59:58 -04:00
Sage Weil
87c98df2cd doc/cephfs/fs-nfs-export: be consistent with cluster_id and _ vs -
Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-21 14:13:15 -04:00
Sage Weil
2400937ce2 mgr/nfs: 'nfs export get' -> 'nfs export info'
This is a breaking change, but aligns the CLI verbs with the rest of ceph.

Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-21 14:13:15 -04:00
Sage Weil
5a2382a5a8 mgr/nfs: binding -> pseudo_path
Signed-off-by: Sage Weil <sage@newdream.net>
2021-06-21 14:13:15 -04:00