Commit Graph

654 Commits

Author SHA1 Message Date
Venky Shankar
df19b8dbc7
Merge pull request #44900 from nmshelke/fix-54111
mon: verify data pool is already not in use by any file system

Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by:  Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Jos Collin <jcollin@redhat.com>
Reviewed-by: Neeraj Pratap Singh <neesingh@redhat.com>
Reviewed-by: Milind Changire <mchangir@redhat.com>
Reviewed-by: Xiubo Li <xiubli@redhat.com>
2022-06-20 10:02:41 +05:30
Venky Shankar
c88a5c832e
Merge pull request #46635 from nmshelke/fix-55822
mgr/volumes: remove incorrect 'size' from output of 'snapshot info'

Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Ramana Raja <rraja@redhat.com>
Reviewed-by: Kotresh HR <khiremat@redhat.com>
Reviewed-by:  Anthony D'Atri <anthony.datri@gmail.com>
2022-06-20 09:50:20 +05:30
Nikhilkumar Shelke
86f4cd3dca docs: remove incorrect 'size' from output of 'snapshot info'
The 'size' shown in the output of snapshot info command relies on
rstats which is incorrect snapshot size. It tracks size of the
subvolume from the snapshot has been taken instead of the snapshot
itself. Hence having the 'size' field in the output of 'snapshot info'
doesn't make sense until the rstats is fixed.

Fixes: https://tracker.ceph.com/issues/55822
Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
2022-06-12 17:16:49 +05:30
Nikhilkumar Shelke
2b0ffbb36d docs: add details about all options used in 'ceph fs new' command
Fixes: https://tracker.ceph.com/issues/54111
Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
2022-06-12 16:25:40 +05:30
Kotresh HR
cd92ea0cb4 doc: Update quota kclient limitation
Fixes: https://tracker.ceph.com/issues/53509
Signed-off-by: Kotresh HR <khiremat@redhat.com>
2022-06-06 12:41:47 +05:30
Kotresh HR
168b912b02 doc: Document subvolumegroup quota commands
Add documentation for subvolume group quota along
with 'subvolumegroup resize' and 'subvolumegroup info'
commands

Fixes: https://tracker.ceph.com/issues/53509
Signed-off-by: Kotresh HR <khiremat@redhat.com>
2022-06-06 12:40:46 +05:30
Nikhilkumar Shelke
59a0cbc14b docs: set, get, list and remove custom metadata for snapshot
Set custom metadata on the snapshot as a key-value pair using
    $ ceph fs subvolume snapshot metadata set <vol_name> <subvol_name> <snap_name> <key_name> <value> [--group_name <subvol_group_name>]
    note: If the key_name already exists then the old value will get replaced by the new value.
    note: The key_name and value should be a string of ASCII characters (as specified in python's string.printable). The key_name is case-insensitive and always stored in lower case.
    note: Custom metadata on a snapshots is not preserved when snapshotting the subvolume, and hence, is also not preserved when cloning the subvolume snapshot.

Get custom metadata set on the snapshot using the metadata key::
    $ ceph fs subvolume snapshot metadata get <vol_name> <subvol_name> <snap_name> <key_name> [--group_name <subvol_group_name>]

List custom metadata (key-value pairs) set on the snapshot using::
    $ ceph fs subvolume snapshot metadata ls <vol_name> <subvol_name> <snap_name> [--group_name <subvol_group_name>]

Remove custom metadata set on the snapshot using the metadata key::
    $ ceph fs subvolume snapshot metadata rm <vol_name> <subvol_name> <snap_name> <key_name> [--group_name <subvol_group_name>] [--force]
    Using the '--force' flag allows the command to succeed that would otherwise fail if the metadata key did not exist.

Fixes: https://tracker.ceph.com/issues/55401
Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
2022-05-25 14:59:53 +05:30
Milind Changire
c15b854c0c doc/cephfs: remove subvol support from snap-schedule
Signed-off-by: Milind Changire <mchangir@redhat.com>
2022-05-16 12:24:42 +05:30
Xiubo Li
54126629a6 doc: cephfs: update with atime not supporting explaination
Signed-off-by: Xiubo Li <xiubli@redhat.com>
2022-04-21 14:10:24 +08:00
Venky Shankar
3f13df8388
Merge pull request #45603 from nmshelke/feature-54472
mgr/volumes: set, get, list and remove metadata of subvolume

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-04-19 16:52:13 +05:30
Kotresh HR
555d361063 doc: Document the clone failure status
Fixes: https://tracker.ceph.com/issues/55190
Signed-off-by: Kotresh HR <khiremat@redhat.com>
2022-04-13 14:26:28 +05:30
Nikhilkumar Shelke
88adfe9050 docs: set, get, list and remove custom metadata for subvolume
Set custom metadata on the subvolume as a key-value pair using
    $ ceph fs subvolume metadata set <vol_name> <subvol_name> <key_name> <value> [--group_name <subvol_group_name>]
    note: If the key_name already exists then the old value will get replaced by the new value.
    note: key_name and value should be a string of ASCII characters (as specified in python's string.printable). key_name is case-insensitive and always stored in lower case.
    note: Custom metadata on a subvolume is not preserved when snapshotting the subvolume, and hence, is also not preserved when cloning the subvolume snapshot.

Get custom metadata set on the subvolume using the metadata key
    $ ceph fs subvolume metadata get <vol_name> <subvol_name> <key_name> [--group_name <subvol_group_name>]

List custom metadata (key-value pairs) set on the subvolume using
    $ ceph fs subvolume metadata ls <vol_name> <subvol_name> [--group_name <subvol_group_name>]

Remove custom metadata set on the subvolume using the metadata key
    $ ceph fs subvolume metadata rm <vol_name> <subvol_name> <key_name> [--group_name <subvol_group_name>] [--force]
    Using the '--force' flag allows the command to succeed that would otherwise fail if the metadata key did not exist.

Fixes: https://tracker.ceph.com/issues/54472
Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
2022-04-06 23:46:44 +05:30
dparmar18
9e8e1a250e doc/cephfs/add-remove-mds: added cephadm note, refined "Adding an MDS"
Description: 1) Add a note about using cephadm for setting up the
                cluster and mds(s), also mention the use of ceph
                orchestrator if one needs to setup mds(s) manually.
	     2) Changed the term `data point` to `directory` in
                point 1 under "Adding an MDS" section for better
                clarity.

Fixes: https://tracker.ceph.com/issues/54551

Signed-off-by: dparmar18 <dparmar@redhat.com>
2022-04-04 14:57:34 +05:30
wangxinyu
fb4a0f3dfd docs/cephfs: fix typos
fix typos

Signed-off-by: wangxinyu <wangxinyu@inspur.com>
2022-03-16 17:39:21 +08:00
Venky Shankar
84835e6b71
Merge pull request #41397 from vshankar/wip-48619
cephfs-top: display average read/write/metadata latency

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-03-07 10:34:15 +05:30
Venky Shankar
e0e2049e5b
Merge pull request #42001 from mchangir/mds-implement-new-getvxattr-rpc
mds,client: add new getvxattr op

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-03-07 10:32:57 +05:30
Neeraj Pratap Singh
d952916190 doc/cephfs: Typographical error.
Signed-off-by: Neeraj Pratap Singh <neesingh@redhat.com>
2022-02-28 15:28:24 +05:30
Milind Changire
ece89098e9 doc: describe json, pool_id and pool_name layout fields
Signed-off-by: Milind Changire <mchangir@redhat.com>
2022-02-11 16:05:54 +05:30
Venky Shankar
aa04f3faed doc: include read, write, metadata average latencies in doc/man.
Also, the sample cephfs-top image in the doc is outdated. Update that!

Fixes: http://tracker.ceph.com/issues/48619
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2022-02-09 02:51:25 -05:00
Venky Shankar
b7af2a94a4
Merge pull request #42549 from ajarr/wip-add-volume-rename
mgr/volumes: Add `fs volume rename` command

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-02-09 11:34:32 +05:30
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
Ramana Raja
70697629bf mgr/volumes: Add fs volume rename command
The `fs volume rename` command renames the volume, i.e.,
orchestrator MDS service, file system, and the data and
metadata pool of the file system.

Fixes: https://tracker.ceph.com/issues/51162
Signed-off-by: Ramana Raja <rraja@redhat.com>
2022-01-13 10:36:46 -05: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