Commit Graph

796 Commits

Author SHA1 Message Date
Salar Nosrati-Ershad
7840573a92 doc/man/8: Remove slash behind bucket name in radosgw-admin.rst
Signed-off-by: Salar Nosrati-Ershad <snosratiershad@gmail.com>
2022-08-22 20:22:12 +04:30
Ilya Dryomov
0d4786e0af
Merge pull request #44436 from nh2/patch-2
doc/man/rbd: Mention changed `bluestore_min_alloc_size`

Reviewed-by: Ilya Dryomov <idryomov@gmail.com>
2022-08-12 17:57:59 +02:00
Niklas Hambüchen
254025343b doc/man/rbd: Mention changed bluestore_min_alloc_size
This change was done in: https://github.com/ceph/ceph/pull/34588

Signed-off-by: Niklas Hambüchen <mail@nh2.me>
2022-08-12 17:00:23 +02:00
wangxinyu
58474bd82e doc/man/cephfs-top.rst: add missing options: --delay, --conffile
add missing options: --delay, --conffile

Signed-off-by: wangxinyu <wangxinyu@inspur.com>
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2022-07-19 08:55:08 +05:30
Rishabh Dave
9f95f96dc0
Merge pull request #45998 from dparmar18/implement_ln_cephfs_shell
cephfs-shell: ln command implementation

Reviewed-by: Nikhilkumar Shelke <nshelke@redhat.com>
Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Rishabh Dave <ridave@redhat.com>
2022-07-08 19:26:34 +05:30
dparmar18
da779e1e93 doc/man/cephfs-shell.rst: documentation of ln command
Signed-off-by: Dhairya Parmar <dparmar@redhat.com>
2022-07-06 16:31:28 +05:30
Josh Soref
8abce157f1 doc: Fix many spelling errors
* administrators
* allocated
* allowed
* approximate
* authenticate
* availability
* average
* behavior
* binaries
* bootstrap
* bootstrapping
* capacity
* cephadm
* clients
* combining
* command
* committed
* comparison
* compiled
* consequences
* continues
* convenience
* cookie
* crypto
* dashboard
* deduplication
* defaults
* delivered
* deployment
* describe
* directory
* documentation
* dynamic
* elimination
* entries
* expectancy
* explicit
* explicitly
* exporter
* github
* hard
* healthcheck
* heartbeat
* heavily
* http
* indices
* infrastructure
* inherit
* layout
* lexically
* likelihood
* logarithmic
* manually
* metadata
* minimization
* minimize
* object
* of
* operation
* opportunities
* overwrite
* prioritized
* recipe
* records
* requirements
* restructured
* running
* scalability
* second
* select
* significant
* specify
* subscription
* supported
* synonym
* throttle
* unpinning
* upgraded
* value
* version
* which
* with

Plus some line wrapping and additional edits...

Signed-off-by: Josh Soref <jsoref@users.noreply.github.com>
2022-07-02 23:38:18 -04:00
Redouane Kachach
443f93e95d
doc/cephadm: document the new per-fsid cephadm conf location
Fixes: https://tracker.ceph.com/issues/55357

Signed-off-by: Redouane Kachach <rkachach@redhat.com>
2022-06-22 08:25:23 +02:00
Anthony D'Atri
3e24921adc doc/man/8: Tweak formatting and wording in ceph.rst
Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
2022-06-11 14:21:50 -07:00
Anthony D'Atri
784f5bb9bf
Merge pull request #46200 from elacunza/doc-man-ceph-add-enable_stretch_mode
doc/man/8: Add enable_stretch_mode docs
2022-06-11 14:02:32 -07:00
Yuri Weinstein
bc02a55d3a
Merge pull request #45409 from NUABO/tancz
mon: add proxy to cache tier options

Reviewed-by: Neha Ojha <nojha@redhat.com>
2022-05-24 07:59:36 -07:00
dparmar18
db8ff8b809 doc/man/cephfs-shell.rst: get cmd must accept both path mandatorily
Signed-off-by: Dhairya Parmar <dparmar@redhat.com>
2022-05-11 17:16:28 +05:30
dparmar18
70e21a92df doc/man/cephfs-shell.rst: put cmd must accept both path mandatorily
Signed-off-by: Dhairya Parmar <dparmar@redhat.com>
2022-05-11 17:10:36 +05:30
Eneko Lacunza
b15af334da doc/man/8: Additional enable_stretch_mode explanation and rework layout
Add additional explanation about stretch mode as suggested by Anthony,
rework a bit the layout of argument details.

Signed-off-by: Eneko Lacunza <elacunza@binovo.es>
2022-05-09 18:56:39 +02:00
Eneko Lacunza
da0051f9a2 doc/man/8: Add enable_stretch_mode docs
Explanation taken from ceph mon -h, plus additional sentence for explaining
new_crush_rule arg.

Signed-off-by: Eneko Lacunza <elacunza@binovo.es>
2022-05-09 10:22:23 +02:00
tancz1
77ad5a810c mon: add proxy to cache tier options
When we set the proxy mode to remove a writeback cache according to
the ceph official documentation an error occurred:

[root@controller-1 root]# ceph osd tier cache-mode cachepool proxy
Invalid command: proxy not in writeback|readproxy|readonly|none
osd tier cache-mode writeback|readproxy|readonly|none [--yes-i-really-mean-it]:
specify the caching mode for cache tier

According to the description of the official website document: since
a writeback cache may have modified data, you must take steps to ensure
that you do not lose any recent changes to objects in the cache before
you disable and remove it. Change the cache mode to proxy so that new and
modified objects will flush to the backing storage pool.

Fixes: https://tracker.ceph.com/issues/54576
Signed-off-by: tan changzhi <544463199@qq.com>
2022-04-29 10:40:40 +08:00
dparmar18
eefa3f6742 doc/man/cephfs-shell.rst: add use of exclamation mark with cmds
Description: `!` -  Exclamation mark can be used to interact with local
             file system apart from Ceph File System too. This PR intends
             to document it.

Signed-off-by: Dhairya Parmar <dparmar@redhat.com>
2022-04-27 00:39:23 +05:30
Laura Flores
e23b53833f doc/man/8: update the description of --format
The `ceph --format` option includes yaml, which
is only valid for orch commands.

Signed-off-by: Laura Flores <lflores@redhat.com>
2022-04-06 11:57:07 -05: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
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
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
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