Commit Graph

10697 Commits

Author SHA1 Message Date
Piotr Parczewski
a8b27af849
doc/start: fix wording & syntax
Signed-off-by: Piotr Parczewski <piotr@stackhpc.com>
2024-02-14 12:51:37 +01:00
zdover23
137ea0f873
Merge pull request #55546 from zdover23/wip-doc-2024-02-13-glossary-crush
doc/glossary: Add link to CRUSH paper

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-02-13 10:00:52 +10:00
Ali Maredia
54cae2cebd
Merge pull request #55156 from alimaredia/wip-rgw-add-cap-user-without-keys
rgw: add new cap user-info-without-keys

Reviewed-by: Casey Bodley <cbodley@redhat.com>
2024-02-12 13:35:09 -05:00
Zac Dover
aa1e6352d0 doc/glossary: Add link to CRUSH paper
Add a link in the CRUSH definition to the original CRUSH paper.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-13 01:06:05 +10:00
Zac Dover
284e99ebc6 doc/radosgw: undo 55524
Roll back the docs changes made in
https://github.com/ceph/ceph/pull/55524, in accordance with Casey
Bodley's instructions to me here:
https://github.com/ceph/ceph/pull/55524#issuecomment-1937020543.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-11 00:36:29 +10:00
Zac Dover
8bfe2d1ae6 doc/radosgw: remove invalid LUA context options
Remove "background", "getdata", and "putdata" from the list of LUA
context options. Passing these options throws the following error:
"ERROR: invalid script context: background. must be one of: preRequest,
postRequest".

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

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-10 13:14:59 +10:00
Casey Bodley
2d61900c60
Merge pull request #55499 from cbodley/wip-squid-deprecate-blkin
doc: deprecate blkin tracing

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Samuel Just <sjust@redhat.com>
Reviewed-by: Radoslaw Zarzynski <rzarzyns@redhat.com>
2024-02-08 22:14:54 +00:00
Radoslaw Zarzynski
72be1f4a8a
Merge pull request #55332 from athanatos/sjust/wip-crush-multi-choose
crush: add multistep retry rules

Reviewed-by: Radoslaw Zarzynski <rzarzyns@redhat.com>
Reviewed-by: Greg Farnum <gfarnum@redhat.com>
2024-02-08 22:56:55 +01:00
Eduardo Roldan
b80c12d080 doc:start.rst fix typo in hw-recs
s/power less/power loss/

Signed-off-by: Eduardo Roldan <trazor@gmail.com>
2024-02-09 03:06:32 +10:00
Casey Bodley
de57824519 doc: deprecate blkin tracing
Signed-off-by: Casey Bodley <cbodley@redhat.com>
2024-02-08 10:56:03 -05:00
Venky Shankar
f9d771f002
Merge pull request #55465 from neesingh-rh/wip-63991
doc: add description of metric fields for cephfs-top

Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Jos Collin <jcollin@redhat.com>
2024-02-08 11:01:04 +05:30
zdover23
608a5b2b92
Merge pull request #55475 from zdover23/wip-doc-2024-02-07-radosgw-admin-confval
doc/radosgw: add confval directives

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-02-08 05:04:35 +10:00
Ali Maredia
6576c811d1
Merge pull request #54623 from alimaredia/wip-rgw-op-metrics-section-rename
rgw: change section name of rgw_op counters

Reviewed-by: Casey Bodley <cbodley@redhat.com>
2024-02-07 10:58:08 -05:00
Zac Dover
6504732e1b doc/radosgw: add confval directives
Add confval directives to the documentation of "quota cache" options.
This addresses a request made by Antony D'Atri in https://github.com/ceph/ceph/pull/55075/files#r1444006246.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-08 01:10:18 +10:00
Zac Dover
f5b8afe981 doc/cephadm - edit t11ing.
Edit "Running Repeated Debugging Sessions" in
doc/cephadm/troubleshooting.rst. Improve grammar. Fix a misspelling.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-07 23:33:18 +10:00
neeraj pratap singh
956f644f86 doc: add description of metric fields for cephfs-top
Fixes: https://tracker.ceph.com/issues/63991
Signed-off-by: Neeraj Pratap Singh <neesingh@redhat.com>
2024-02-07 17:04:31 +05:30
Ali Maredia
f0987e5151 rgw: add new cap user-info-without-keys
This new cap allows users to run the admin api op
`get user info` without the S3 keys and Swift keys
in the response.

Signed-off-by: Ali Maredia <amaredia@redhat.com>
2024-02-05 19:08:02 +00:00
Zac Dover
5ad241442d doc/rados: update PG guidance
Update the "Creating a Pool" section of doc/rados/operations/pools.rst
so that the documentation no longer insists that the user change the
values of "osd_pool_default_pg_num" and "osd_pool_default_pgp_num".

See also: https://github.com/ceph/ceph/pull/55419

Tracker: https://tracker.ceph.com/issues/64259

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-05 18:41:21 +10:00
Samuel Just
aa88dfac4e doc/rados/operations: add CRUSH MSR documentation
Signed-off-by: Samuel Just <sjust@redhat.com>
2024-02-03 21:00:11 -08:00
Samuel Just
8eb6835396 doc/dev/crush-msr.rst: add developer summary of crush msr
Signed-off-by: Samuel Just <sjust@redhat.com>
2024-02-03 21:00:11 -08:00
Zac Dover
4dc12092be doc/rados: update config for autoscaler
Update doc/rados/configuration/pool-pg-config-ref.rst to account for the
behavior of autoscaler.

Previously, this file was last meaningfully altered in 2013, prior to
the invention of autoscaler. A recent confusion was brought to my
attention on the Ceph Slack whereby a user attempted to alter the
default values of a Quincy cluster, as suggested in this documentation.
That alteration caused Ceph to throw the error "Error ERANGE: 'pgp_num'
must be greater than 0 and lower or equal than 'pg_num', which in this
case is one" and a related "rgw_init_ioctx ERROR" reading in part
"Numerical result out of range". The user removed the
"osd_pool_default_pgp_num" configuration line from ceph.conf and the
cluster worked as expected. I presume that this is because the removal
of this configuration line allowed autoscaler to work as intended.

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

Co-authored-by: David Orman <ormandj@corenode.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-02-03 12:35:19 +10:00
Casey Bodley
862b2eeb5b
Merge pull request #54867 from BBoozmen/oozmen_lc_subsystem
rgw/common: add rgw lifecycle specific debug log subsystem

Reviewed-by: Matt Benjamin <mbenjamin@redhat.com>
Reviewed-by: Jiffin Tony Thottan <jthottan@redhat.com>
2024-02-02 15:42:00 +00:00
Ali Maredia
eaa4ccd729 rgw: change section name of rgw_op counters
The rgw_op section of `counter dump/schema` becomes:
- rgw_op_global for the global op counters
- rgw_op_per_user for the user labeled counters
- rgw_op_per_bucket for the bucket labeled counters

Signed-off-by: Ali Maredia <amaredia@redhat.com>
2024-01-31 17:18:03 -05:00
Anthony D'Atri
6760aa18bf
Merge pull request #55403 from cbodley/wip-doc-rgw-topic-attrs
doc/rgw: fix Attributes index in CreateTopic example
2024-01-31 15:08:26 -05:00
Adam King
a4452f6cc4
Merge pull request #54742 from guits/node-proxy
orch: implement hardware monitoring

Reviewed-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
2024-01-31 13:28:50 -05:00
Casey Bodley
ecbd837667 doc/rgw: fix Attributes index in CreateTopic example
Signed-off-by: Casey Bodley <cbodley@redhat.com>
2024-01-31 12:31:02 -05:00
Guillaume Abrioux
b7c0a6a5b0 doc: add node-proxy documentation
This commit adds some documentation about the
'hardware inventory / monitoring' feature (node-proxy agent).

Signed-off-by: Guillaume Abrioux <gabrioux@ibm.com>
2024-01-31 15:23:44 +01:00
Zac Dover
2f0542d669 doc/architecture: improve some paragraphs
Improve paragraphs under the heading "The Ceph Storage Cluster". Remove
a sentence that was pleonastic in its context in the paragraph.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-31 20:58:45 +10:00
zdover23
c746748162
Merge pull request #55372 from zdover23/wip-doc-2024-01-30-architecture-typo
doc/architecture.rst - fix typo

Reviewed-by: Cole Mitchell <cole.mitchell.ceph@gmail.com>
2024-01-31 10:48:35 +10:00
Adam Kupczyk
1ef493c768
Merge pull request #53610 from Patty8122/documentation-update-fsck-flagdeep
doc/man/8: Add valid options in ceph-bluestore-tool.rst
2024-01-30 15:43:49 +01:00
Zac Dover
6c0417fbcb doc/architecture.rst - fix typo
s/requies/requires

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-30 22:24:11 +10:00
Laura Flores
f45a39bdcd
Merge pull request #53988 from ljflores/wip-read-balancer-mgr-module 2024-01-28 23:40:01 -06:00
Zac Dover
763f6b7a22 doc/architecture.rst: improve rados definition
Improve the definition of RADOS, and link to information about RADOS.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-29 05:33:58 +10:00
Laura Flores
e2ce8ed1ff mgr: add read balancer support inside the balancer module
Read balancing may now be managed automatically via the balancer
manager module. Users may choose between two new modes: ``upmap-read``, which
offers upmap and read optimization simultaneously, or ``read``, which may be used
to only optimize reads. Existing balancer commands have also been added to
contain more information about read balancing.

Run the following commands to test the new automatic behavior:
`ceph balancer on` (on by default)
`ceph balancer mode <read|upmap-read>`
`ceph balancer status`

Run the following commands to test the new supervised behavior:
`ceph balancer off`
`ceph balancer mode <read|upmap-read>`
`ceph balancer eval` | `ceph balancer eval <pool-name>`
`ceph balancer eval-verbose` | `ceph balancer eval-verbose <pool-name>`
`ceph balancer optimize <plan-name>`
`ceph balancer show <plan-name>`
`ceph balancer eval <plan-name>`
`ceph balancer execute <plan-name>`

In the balancer module, there is also a new "self_test" function which tests
the module's basic functionality. This test can be triggered with the following
commands:
`ceph mgr module enable selftest`
`ceph mgr self-test module balancer`

Related Trello: https://trello.com/c/sWoKctzL/859-add-read-balancer-support-inside-the-balancer-module
Signed-off-by: Laura Flores <lflores@ibm.com>
2024-01-28 13:15:38 -06:00
Zac Dover
9f271093f4 doc/radosgw: fix verb disagreement - index.html
Fix a tricky verb disagreement and rewrite a few sentences for what I
hope is greater clarity.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-28 18:04:57 +10:00
Samuel Just
a5ce9c3863 Revert "crush: add multistep retry rules"
This PR was merged by accident before it was ready.
Let's revert for now and open a new PR.

Signed-off-by: Samuel Just <sjust@redhat.com>
2024-01-26 20:32:05 +00:00
Yuri Weinstein
37d5d931b0
Merge pull request #55096 from athanatos/sjust/for-review/wip-crush-msr
crush: add multistep retry rules

Reviewed-by: Laura Flores <lflores@redhat.com>
2024-01-26 11:57:53 -08:00
Zac Dover
d8df6f61e8 doc/radosgw: edit "Usage" admin.rst
Edit "Usage" in doc/radosgw/admin.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-26 09:12:59 +10:00
Laura Flores
24dcb42d41
Merge pull request #55067 from yaarith/telemetry-pool-flags
mgr/telemetry: add pool flags
2024-01-23 12:22:32 -06:00
Himura Kazuto
886af37744
doc: specify correct fs type for mkfs
The default value is ext2, which is not supported (anymore?).

Signed-off-by: Vladislav Glagolev <vladislav.glagolev@devexpress.com>
2024-01-23 13:21:01 +00:00
Zac Dover
c67a5e5d4b doc/radosgw: edit "read/write global rate limit" admin.rst
Edit "Reading/Writing Global Rate Limit Configuration" in
doc/radosgw/admin.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-23 12:13:10 +10:00
zdover23
f265c99628
Merge pull request #55190 from zdover23/wip-doc-2024-01-16-radosgw-admin-enable-disable-bucket-rate-limit
doc/radosgw: edit "Enable/Disable Bucket Rate Limit"

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-01-21 19:47:10 +10:00
Zac Dover
7c4fdd3762 doc/radosgw: edit admin.rst "Get Bucket Rate Limit"
Edit "Get Bucket Rate Limit" in doc/radosgw/admin.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-20 16:55:56 +10:00
Venky Shankar
51487f8cd2 Merge PR #54915 into main
* refs/pull/54915/head:
	doc/cephfs/client-auth.rst: correct `This so because` to  `This is because`
	doc/cephfs/client-auth.rst: correct ``fs authorize cephfs1 /dir1 client.x rw``

Reviewed-by: Venky Shankar <vshankar@redhat.com>
2024-01-19 13:16:19 +05:30
zdover23
6f0afdb7bd
Merge pull request #55170 from zdover23/wip-doc-2024-01-14-radosgw-admin-set-bucket-rate-limit
doc/radosgw: edit admin.rst "set bucket rate limit"

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-01-19 15:54:08 +10:00
zdover23
19aa8fc73d
Merge pull request #55161 from tobydarling/patch-2
doc/rados/operations: Fix off-by-one erors in control.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-01-18 20:41:38 +10:00
Anthony D'Atri
ed2cf56d85
Merge pull request #55168 from anthonyeleven/ec-table
doc/rados/operations: add EC overhead table to erasure-code.rst
2024-01-17 15:04:43 -05:00
Anthony D'Atri
9e1999c13d doc/rados/operations: add EC overhead table to erasure-code.rst
Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
2024-01-17 11:55:39 -05:00
Zac Dover
a1fca50dfd doc/radosgw: edit "Enable/Disable Bucket Rate Limit"
Edit "Enable/Disable Bucket Rate Limit" in doc/radosgw/admin.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-16 20:37:17 +10:00
Zac Dover
e9b3ef4cb1 doc/radosgw: edit admin.rst "set bucket rate limit"
Edit "Set Bucket Rate Limit" in doc/radosgw/admin.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-01-14 20:23:25 +10:00