Commit Graph

784 Commits

Author SHA1 Message Date
Venky Shankar
2de993b969
Merge pull request #44971 from joscollin/wip-doc-fix-name-id
doc: mention MDS name and ID format in ceph-mds.rst

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-02-14 12:19:43 +05:30
Anthony D'Atri
e5b9173836
Merge pull request #44898 from taggelos/patch-1
doc/man/8: Fix spelling in user rename example
2022-02-12 02:52:16 -08:00
Jos Collin
3404d4c8ed
doc: mention MDS name and ID format in ceph-mds.rst
Signed-off-by: Jos Collin <jcollin@redhat.com>
2022-02-11 10:20:47 +05:30
Aggelos Toumasis
11909d0d84 doc/man/8: Fix spelling in user rename example
Signed-off-by: Aggelos Toumasis toumasis.aggelos@gmail.com
2022-02-08 12:35:27 +01:00
Ilya Dryomov
8d2a456d70 rbd: recognize rxbounce map option
Fixes: https://tracker.ceph.com/issues/54063
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2022-02-04 19:04:37 +01:00
Zac Dover
9f65f42d9e doc/man: radosgw-admin.rst: missing apostrophe
This commit adds two missing apostrophes to two
different strings.

Hat tip to IcePic.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2022-01-22 02:57:28 +10:00
Venky Shankar
206d444d37
Merge pull request #44279 from jtlayton/wip-50235
cephfs-shell: add the ability to mount a named filesystem

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2022-01-05 17:46:01 +05:30
Mara Sophie Grosch
5d872f3a28 doc: add docs for rbd_default_order
Adds documentation how to change default rbd object size. With the
previous option `--order` it was easy to guess the config name for the
default value, with the current option name `--object-size` thats hard
to guess.

Also extends the documentation for rbd_default_order to include
* how object-size is derived from the configured value
* allowed range of the value

In the first version of this commit I also added min and max for this
parameter (12/25, matching the object size range in `man 8
rbd`/Striping/object-size), but this made some tests fail, since some
seem to set values outside this range (and probably are fine since
included for some time already). To have this a doc-change only, I
removed the range.

Signed-off-by: Mara Sophie Grosch <littlefox@lf-net.org>
2021-12-27 19:58:56 +01:00
Jeff Layton
417cf43805 cephfs-shell: add a --fs argument to allow mounting named filesystems
Add a new --fs argument to cephfs-shell, so we can use it to mount named
filesystems. Add a blurb to the manpage for it, and alphebetize the
command-line flags.

Fixes: https://tracker.ceph.com/issues/50235
Signed-off-by: Jeff Layton <jlayton@redhat.com>
2021-12-16 06:11:11 -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
Matt Benjamin
8a966d5d6d
Merge pull request #44139 from linuxbox2/wip-rgw-lcselect
rgwlc: permit lifecycle processing for a single bucket
2021-12-03 12:22:20 -05:00
Matt Benjamin
af11694ad1 rgwlc: optimize single-bucket lifecycle processing
Looks up the shard index of the corresponding bucket, and only
buckets in the corresponding shard are considered for processing.
This has a side effect of matching buckets by id, and also adds
support for --tenant.

Signed-off-by: Matt Benjamin <mbenjamin@redhat.com>
2021-12-01 14:25:20 -05:00
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
Matt Benjamin
9ddc223e63 rgwlc: permit lifecycle processing for a single bucket
Permit a --bucket option to be passed to radosgw-admin lc process,
and propagate the bucket name to lifecycle processing, and process
only the named bucket if one is provided.

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

Signed-off-by: Matt Benjamin <mbenjamin@redhat.com>
2021-11-29 22:00:07 -05:00
Patrick Donnelly
d96ef3d353
Merge PR #40514 into master
* refs/pull/40514/head:
	cephfs-top: add read/write average io sizes support
	cephfs-top: add read/write io speed support
	mds: add read/write io size metric support

Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-11-01 12:36:21 -04:00
Prasanna Kumar Kalever
16404dede8 rbd-nbd: allow user to specify cookie at map
Allow user to specify cookie of choice at the time of map

$ rbd device attach rbd-pool/image --device /dev/nbd0 \
	--cookie 6f85d970-10b2-456b-8baf-676aa4d782e4 --options try-netlink

Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
2021-10-26 19:24:13 +05:30
Prasanna Kumar Kalever
6df06c7a62 rbd: add --show-cookie/--cookie option for map/attach commands
Example:
$ rbd device map rbd-pool/image --show-cookie --try-netlink --device-type nbd

$ rbd device attach rbd-pool/image --device /dev/nbd0 \
      --cookie 6f85d970-10b2-456b-8baf-676aa4d782e4 --device-type nbd

older Kernel versions can use --force to skip the cookie validation

Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
2021-10-26 19:24:13 +05:30
Xiubo Li
c1ee088aca cephfs-top: add read/write average io sizes support
Fixes: https://tracker.ceph.com/issues/49811
Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-10-19 09:15:45 +08:00
Xiubo Li
ec22208364 cephfs-top: add read/write io speed support
Calculate the speeds in cephfs-top.

Fixes: https://tracker.ceph.com/issues/49811
Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-10-19 09:14:24 +08:00
Xiubo Li
17f0cbb688 mds: add read/write io size metric support
It will support total_ops/total_size metrics for read and write. and
the cephfs-top tool will show total io sizes for read/write.

Fixes: https://tracker.ceph.com/issues/49811
Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-10-19 09:13:37 +08:00
Dimitri Savineau
96d84acf5a ceph-volume: support no_systemd with lvm migrate
The `ceph-volume lvm migrate/new-db/new-wal` commands don't support
running on non systemd systems or within containers.
Like other ceph-volume commands (lvm activate/batch/zap or raw activate)
we also need to be able to use the --no-systemd flag.

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

Signed-off-by: Dimitri Savineau <dsavinea@redhat.com>
2021-09-03 12:53:03 -04:00
Daniel Gryniewicz
9c213a0d08
Merge pull request #42948 from llamerada-jp/fix-radosgw-admin-document
rgw: fix document

Reviewed-by: Daniel Gryniewicz <dang@redhat.com>
2021-09-01 08:40:04 -04:00
Ushitora Anqou
0800567d83 rgw: fix document
add the description of --show-config option in radosgw-admin

Signed-off-by: Ushitora Anqou <ushitora@anqou.net>
2021-08-27 07:44:43 +00:00
Mykola Golub
8ecae46345 doc: add crushdiff(8) man page
Signed-off-by: Mykola Golub <mykola.golub@clyso.com>
2021-08-24 11:09:08 +03:00
Stephan Müller
0c8cb21d5e
Merge pull request #41380 from Devp00l/wip-rgw-multisite-doc
doc: Improve RGW multisite documentation

Reviewed-by: Volker Theile <vtheile@suse.com>
Reviewed-by: Alex Settle <asettle@suse.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2021-08-23 15:52:57 +02:00
J. Eric Ivancich
8e975ba9fd doc: clarify use of rados rm command
The man page did not make it clear that multiple objects could be
specified, nor did it describe use of "--force-full".

Info displayed about "rm" with `rados --help` was poorly formatted and
the wording was adjusted.

Signed-off-by: J. Eric Ivancich <ivancich@redhat.com>
2021-08-16 18:28:07 -04:00
Gabriel BenHanokh
272160ab5e [BlueStore]: [Remove Allocations from RocksDB]
Currently BlueStore keeps its allocation info inside RocksDB.
BlueStore is committing all allocation information (alloc/release) into RocksDB (column-family B) before the client Write is performed causing a delay in write path and adding significant load to the CPU/Memory/Disk.
Committing all state into RocksDB allows Ceph to survive failures without losing the allocation state.

The new code skips the RocksDB updates on allocation time and instead perform a full desatge of the allocator object with all the OSD allocation state in a single step during umount().
This results with an 25% increase in IOPS and reduced latency in small random-write workloads, but exposes the system to losing allocation info in failure cases where we don't call umount.
We added code to perform a full allocation-map rebuild from information stored inside the ONode which is used in failure cases.
When we perform a graceful shutdown there is no need for recovery and we simply read the allocation-map from a flat file where the allocation-map was stored during umount() (in fact this mode is faster and shaves few seconds from boot time since reading a flat file is faster than iterating over RocksDB)

Open Issues:

There is a bug in the src/stop.sh script killing ceph without invoking umount() which means anyone using it will always invoke the recovery path.
Adam Kupczyk is fixing this issue in a separate PR.
A simple workaround is to add a call to 'killall -15 ceph-osd' before calling src/stop.sh

Fast-Shutdown and Ceph Suicide (done when the system underperforms) stop the system without a proper drain and a call to umount.
This will trigger a full recovery which can be long( 3 minutes in my testing, but your your mileage may vary).
We plan on adding a follow up PR doing the following in Fast-Shutdown and Ceph Suicide:

Block the OSD queues from accepting any new request
Delete all items in queue which we didn't start yet
Drain all in-flight tasks
call umount (and destage the allocation-map)
If drain didn't complete within a predefined time-limit (say 3 minutes) -> kill the OSD
Signed-off-by: Gabriel Benhanokh <gbenhano@redhat.com>

create allocator from on-disk onodes and BlueFS inodes
change allocator + add stat counters + report illegal physical-extents
compare allocator after rebuild from ONodes
prevent collection from being open twice
removed FSCK repo check for null-fm
Bug-Fix: don't add BlueFS allocation to shared allocator
add configuration option to commit to No-Column-B
Only invalidate allocation file after opening rocksdb in read-write mode
fix tests not to expect failure in cases unapplicable to null-allocator
accept non-existing allocation file and don't fail the invaladtion as it could happen legally
don't commit to null-fm when db is opened in repair-mode
add a reverse mechanism from null_fm to real_fm (using RocksDB)
Using Ceph encode/decode, adding more info to header/trailer, add crc protection
Code cleanup

some changes requested by Adam (cleanup and style changes)

Signed-off-by: Gabriel Benhanokh <gbenhano@redhat.com>
2021-08-11 16:53:09 +03:00
Stephan Müller
b9c61ecaee doc: Improve RGW multisite documentation
Signed-off-by: Stephan Müller <smueller@suse.com>
2021-08-10 14:59:00 +02:00
Kefu Chai
42aa5b56e0
Merge pull request #42672 from aclamk/wip-bluestore-tool-conf
tools/ceph-bluestore-tool: Enable configuration options from monitor/ceph.conf

Reviewed-by: Igor Fedotov <ifedotov@suse.com>
Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2021-08-10 12:16:19 +08:00
Guillaume Abrioux
32b2c57bf6 doc/cephadm: update documentation
This commit fixes a couple of typos in the cephadm documentation.

Signed-off-by: Guillaume Abrioux <gabrioux@redhat.com>
2021-08-05 12:06:05 +02:00
Adam Kupczyk
46603dab36 tools/ceph-bluestore-tool: Enable configuration options from monitor/ceph.conf
Added option -i that allows to operate as specific osd.
It reads configuration options from monitor or ceph.conf.
In addition providing configuration option not accepted by OSD or ceph-bluestore-tool is now an error.

Signed-off-by: Adam Kupczyk <akupczyk@redhat.com>
2021-08-05 11:51:37 +02:00
Kefu Chai
70f05e42a3 doc/man/8/cephfs-shell: s/virtualenv/python3 -m venv/
so user does not have to use virtualenv python package for creating a
virtualenv, the "venv" module in Python3 would suffice.

see also https://docs.python.org/3/library/venv.html

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-31 21:16:56 +08:00
wangyingbin
51c27cdb16 doc/man: add missing right parenthesis in manpage.
Signed-off-by: wangyingbin <ybwang0211@163.com>
2021-07-28 10:29:38 +08:00
Kefu Chai
f54574d1ac doc/man/8/ceph-volume: specify "program" for subcommands
as per
https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html

> Like py:currentmodule, this directive produces no output. Instead, it
> serves to notify Sphinx that all following option directives document
> options for the program called name.
> ...
> The program name may contain spaces (in case you want to document
> subcommands like svn add and svn commit separately).

and to avoid the warnings like:

doc/man/8/ceph-volume.rst:424: WARNING: Duplicate explicit target name:
"cmdoption-ceph-volume-h".

we should specify different "program" for different set of options.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-22 01:13:54 +08:00
Dimitri Savineau
99166e1044 doc/man/8/radosgw-admin: fix typo on max entries
This fixes a typo for the --max-entries option.

Signed-off-by: Dimitri Savineau <dsavinea@redhat.com>
2021-07-20 10:49:41 -04:00
Sage Weil
9a49a5819e doc/man/8/cephadm: add --log-to-file (and --single-host-defaults)
Signed-off-by: Sage Weil <sage@newdream.net>
2021-07-12 13:45:35 -04:00
Ilya Dryomov
a408347e14
Merge pull request #41954 from pkalever/notrim
rbd-nbd: support notrim option with map command

Reviewed-by: Mykola Golub <mgolub@suse.com>
Reviewed-by: Ilya Dryomov <idryomov@gmail.com>
2021-06-30 14:02:10 +02:00
Prasanna Kumar Kalever
688f0c5fb0 rbd-nbd: support notrim option with map command
currently --notrim option works for rbd kernel mounter, but fails with rbd-nbd

$ rbd device --options notrim map rbd-pool/image0
/dev/rbd0
$ rbd device list
id  pool      namespace  image   snap  device
0   rbd-pool             image0  -     /dev/rbd0

$ rbd device --device-type nbd --options try-netlink,notrim map rbd-pool/image0
rbd-nbd: unknown args: --notrim
rbd: rbd-nbd failed with error: /data/ceph/build/bin/rbd-nbd: exit status: 1

With this changes:
$ rbd device --device-type nbd --options try-netlink,notrim map rbd-pool/image0
/dev/nbd0
$ rbd-nbd list-mapped
id    pool      namespace  image   snap  device
6945  rbd-pool             image0  -     /dev/nbd0
$ ps -eo "cmd" |grep [r]bd-nbd
/data/ceph/build/bin/rbd-nbd map rbd-pool/image0 --try-netlink --notrim

Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
2021-06-28 13:46:43 +05:30
Kefu Chai
c4fbf39d2e cmake,deb,rpm: drop ceph-deploy manpage
ceph-deploy is not actively maintained anymore, and it was replaced by
ceph-volume and other high-level tools.

so there is no point to package its manpage anymore.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-06-24 12:13:17 +08:00
Jan "Yenya" Kasprzak
bf5863baf5 doc/rbd: document cp versus deep cp
I found that the difference between "rbd cp" and "rbd deep cp",
i.e. what "deep" means in this context, is documented only in
the mailing list archive and in the Mimic reelase notes.

Let's make the difference explicit in the manpage and in rbd --help.

Signed-off-by: Jan "Yenya" Kasprzak <kas@fi.muni.cz>
2021-05-27 13:47:16 +02:00
Prasanna Kumar Kalever
35e5352f71 rbd: promote rbd-nbd attach and detach at rbd integrated cli
Example:
$ rbd device attach rbd-pool/image --device /dev/nbd0 --device-type nbd --force
$ rbd device detach rpool/image --device-type nbd

for now returning EOPNOTSUPP with krbd, ggate and wnbd

Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
2021-05-26 10:17:12 +05:30
Rishabh Dave
72478a585c
Merge pull request #39580 from ifed01/wip-ifed-migrate
ceph-volume: implement bluefs volume migration.
2021-05-18 18:20:43 +05:30
Kefu Chai
1c04ce6f3a doc/man: build and install cephfs-shell manpage
otherwise the manpage of cephfs-shell is not built and installed.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-05-05 14:41:50 +08:00
Patrick Donnelly
52faaf848e
Revert "Merge PR #41134 into master"
This reverts commit 93bca2d0e9, reversing
changes made to 7e70b15c43.

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2021-05-04 14:46:47 -07:00
Kefu Chai
5191008aa4 doc/man: build and install cephfs-shell manpage
otherwise the manpage of cephfs-shell is not built and installed.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-05-04 15:11:22 +08:00
Igor Fedotov
58efeb9151 ceph-volume: implement bluefs volume migration.
This is a wrapper over ceph-bluestore-tool's bluefs-bdev-migrate command.
Primarily intended to introduce LVM tags manipulation which
ceph-bluestore-tool is lacking.

Signed-off-by: Igor Fedotov <ifedotov@suse.com>
2021-04-29 02:09:51 +03:00
Kefu Chai
2041207674 doc/man/8/ceph-authtool: fix the indent of option
Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-04-19 22:09:52 +08:00
Xiubo Li
0b4807aefb cephfs-top: improve the output
When adding more metrics the top line will be too long and maybe
wrapped with serval lines, which will make it hard to read.

Signed-off-by: Xiubo Li <xiubli@redhat.com>
2021-04-15 16:27:34 +08:00
Kefu Chai
792c2f878f doc/man/8/ceph-volume: fix formatting
Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-25 01:03:34 +08:00
Kefu Chai
5757c69b06 doc/man: replace http://ceph.com/docs with https://docs.ceph.com
the former brings us to a 404 page

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-22 01:41:53 +08:00