Commit Graph

626 Commits

Author SHA1 Message Date
Sage Weil
b4e06c5b31 doc/rados/operations: adjust docs a bit
Signed-off-by: Sage Weil <sage@redhat.com>
2020-02-06 07:09:29 -06:00
Jason Dillaman
27c9b1ecb8
Merge pull request #32735 from trociny/wip-doc-mirror-snapshot
doc: document "mode" param for "rbd mirror image enable" command

Reviewed-by: Jason Dillaman <dillaman@redhat.com>
2020-01-24 14:30:22 -05:00
Mykola Golub
6171c26a94 doc: document "mode" param for "rbd mirror image enable" command
Signed-off-by: Mykola Golub <mgolub@suse.com>
2020-01-23 18:10:19 +00:00
Rishabh Dave
34c6f2f11a doc: minor fix in mount.ceph
Also, fix the indentation since we are already here.

Fixes: https://tracker.ceph.com/issues/43743
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2020-01-21 19:43:25 +05:30
Kefu Chai
c3a914a8c6 doc/man: improve bluefs-bdev-expand option
Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-01-10 20:16:01 +08:00
Patrick Donnelly
29b318a111
doc: remove reference to obsolete scrub command
Fixes: e9a5ce0897
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2020-01-07 15:35:01 -08:00
David Zafman
b0a1b758d0 mgr: Change default upmap_max_deviation to 5
Fixes: https://tracker.ceph.com/issues/43312

Signed-off-by: David Zafman <dzafman@redhat.com>
2020-01-06 21:35:19 -08:00
David Zafman
621acf8ce7 osdmaptool: Add --upmap-active to simulate active upmap balancing
Signed-off-by: David Zafman <dzafman@redhat.com>
2020-01-06 21:35:19 -08:00
David Zafman
184e9d1ae3 doc: Add upmap options to osdmaptool man page and give example
Signed-off-by: David Zafman <dzafman@redhat.com>
2020-01-06 21:35:19 -08:00
David Zafman
e42a6ccb18 tools: osdmaptool document non-upmap options that were missing
Signed-off-by: David Zafman <dzafman@redhat.com>
2020-01-06 21:35:19 -08:00
taeuk_kim
73bd6408db doc: fix a typo in a command
Co-authored-by: donggyu_park <donggyu_park@tmax.co.kr>
Signed-off-by: taeuk_kim <taeuk_kim@tmax.co.kr>
2019-12-13 11:43:08 +09:00
Ilya Dryomov
abd20b5ca9 doc: clarify support for rbd fancy striping
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2019-12-11 12:41:09 +01:00
Kefu Chai
1cb5e6a02f
Merge pull request #30498 from jecluis/wip-mon-no-config
mon: allow running without a config file

Reviewed-by: Sage Weil <sage@redhat.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2019-12-05 22:59:56 +08:00
Sage Weil
884c84d844 Merge PR #31348 into master
* refs/pull/31348/head:
	tools/rados: update advisory lock break usage with --lock-cookie required

Reviewed-by: Kefu Chai <kchai@redhat.com>
2019-12-02 12:55:49 -06:00
Joao Eduardo Luis
065d12b826 common: allow running without config
If `--no-config-file` is specified, allow the caller to ignore the
requirements to find a config file. This presumes that the caller either
doesn't need to be configured, or that whatever it may need is provided
via the cli.

Signed-off-by: Joao Eduardo Luis <joao@suse.com>
2019-12-02 23:28:31 +08:00
Nathan Cutler
4353b5548e doc: mention --namespace option in rados manpage
Fixes: https://tracker.ceph.com/issues/43021
Signed-off-by: Nathan Cutler <ncutler@suse.com>
2019-11-26 15:39:42 +01:00
Zhi Zhang
fd3602e4b8 tools/rados: update advisory lock break usage with --lock-cookie required
Advisory lock break rados command actually needs --lock-cookie arg,
otherwise it can't find correct locker and return ENOENT. So update
its usgae and add some logs for debug.

Signed-off-by: Zhi Zhang <zhangz.david@outlook.com>
2019-11-26 12:49:21 +08:00
Kefu Chai
8e93d26c0e doc/man/ceph: "heap" is now an asok command
after the big asok/tell cleanup, "heap" is now an asok command, so
update the manpage accordingly

Signed-off-by: Kefu Chai <kchai@redhat.com>
2019-11-18 13:51:19 +08:00
Brad Hubbard
d2b806070d tools/rados: Unmask '-o' to restore original behaviour
0b369e1aff masked the original behaviour of '-o' which was to indicate
'outfile' as documented in the man page. Changing object-size to capital
o will restore the original behaviour.

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

Signed-off-by: Brad Hubbard <bhubbard@redhat.com>
2019-11-12 09:20:03 +10:00
Patrick Donnelly
8971dd7cdc
Merge PR #31024 into master
* refs/pull/31024/head:
	doc: improve in mount.ceph man page
	doc: describe mds_namespace option in mount.ceph man page

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-11-11 12:21:34 -08:00
Patrick Donnelly
452a5136c7
Merge PR #30911 into master
* refs/pull/30911/head:
	doc/ceph-fuse: describe -n option

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Douglas Fuller <dfuller@redhat.com>
Reviewed-by: Jeff Layton <jlayton@redhat.com>
2019-11-11 12:03:21 -08:00
Sage Weil
3e9a2d8065 Merge PR #31177 into master
* refs/pull/31177/head:
	doc: update with zone bucket and straw2 addition

Reviewed-by: Sage Weil <sage@redhat.com>
2019-11-08 07:22:05 -06:00
Rishabh Dave
7f620fdc15 doc/ceph-fuse: describe -n option
Fixes: https://tracker.ceph.com/issues/42300
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-04 18:09:39 +05:30
Rishabh Dave
a4c95e6776 doc: improve in mount.ceph man page
Add new examples to show how to mount with and without authentication,
mon sockets and secret keys for CephX users in mount command, don't show
monitor's IP address in every example, use real IP addresses instead of
just writing "monhost", use non-standard port number in non-standard
socket number example and keep the mount point same across all examples.

Add `mount -t ceph` example to synopsis, replace "monaddr1" by
"mon1_socket", since it doesn't necessarily have to be only IP
addresses.

Rearrange options alphabetically so that it's easy to find them but
keep similar like dirstat and nodirstat together, increase indentation
for "Options" section from 2 to 4 spaces, wrap lines that are too long
and elaborate explanation wherever necessary.

Capitalize "ceph", wherever appropriate.

Fixes: https://tracker.ceph.com/issues/42406
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-11-02 12:47:27 +05:30
Jason Dillaman
b50e6f5894
Merge pull request #30994 from JackSlateur/rbd_merged_du
rbd: add --merge to disk-usage

Reviewed-by: Kefu Chai <kchai@redhat.com>
Reviewed-by: Jason Dillaman <dillaman@redhat.com>
2019-10-30 12:06:08 -04:00
Alexandre Bruyelles
79d545c006
rbd: add --merge-snapshots to disk-usage
Signed-off-by: Alexandre Bruyelles <jack@jack.fr.eu.org>
2019-10-28 16:29:26 +01:00
Changcheng Liu
f241095e3a doc: update with zone bucket and straw2 addition
1. zone bucket non-leaf type is added.
2. crush bucket straw2 algorithm is added.

Signed-off-by: Changcheng Liu <changcheng.liu@aliyun.com>
2019-10-27 12:08:12 +08:00
Sage Weil
29c97547a9 Merge PR #30859 into master
* refs/pull/30859/head:
	auth: EACCES, not EPERM
	mon: shunt old tell commands from cli interface to asok
	mon: allow mgr to tell mon.foo smart
	mon: include quorum features in quorum_status
	qa/workunits/mon/caps.sh: fix test
	ceph_test_rados_api_cmd: fix MonDescribe test
	Merge branch 'vstart-fs-auth' of git://github.com/batrick/ceph into wip-cleanup-mon-asok
	test/pybind/test_ceph_argparse: fix tests
	vstart: add volume client keys to keyring
	vstart: use fs authorize to create master client key
	vstart: redirect some output to stderr
	vstart: output command strings to stderr
	qa/workunits/cephtool/test.sh: fix 'quorum enter' caller
	qa: change mon_status calls to quorum_status or tell commands
	mon: fix 'heap ...' command
	mon: consolidate 'sync force' commands
	mon: allow asok commands to return an error code
	mon: move 'quorum enter|exit' and 'mon_status' to asok
	mon: fix 'smart' asok command
	mon: remove old 'config set' and 'injectargs'

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2019-10-23 21:05:42 -05:00
Rishabh Dave
61f4142bec doc: describe mds_namespace option in mount.ceph man page
And add an example for it.

Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-10-21 20:07:57 +05:30
Drunkard Zhang
b55fdadb65 doc: add missed word 'than' in doc/man/8/rbd.rst
Signed-off-by: Drunkard Zhang <gongfan193@gmail.com>
2019-10-21 22:21:40 +08:00
Sage Weil
fab205d45a qa/workunits/cephtool/test.sh: fix 'quorum enter' caller
Signed-off-by: Sage Weil <sage@redhat.com>
2019-10-12 12:05:36 -05:00
Sage Weil
e3260a81d5 mon: consolidate 'sync force' commands
Replace the 'ceph [mon] sync force' commands and just use the asok
sync_force command instead.  This is a low-level command that nobody should
reasonsbly using except in an emergency, so do not bother with trying to
maintain compatibility; it's a bit rediculous that we had 3 variations of
this to being with!

Signed-off-by: Sage Weil <sage@redhat.com>
2019-10-12 12:05:36 -05:00
Casey Bodley
8cd683aa60
Merge pull request #30742 from croit/rgw-fix-max-concurrent-ios-docs
radosgw-admin: update help for max-concurrent-ios

Reviewed-by: Casey Bodley <cbodley@redhat.com>
2019-10-10 12:35:14 -04:00
Kefu Chai
2ce2a3d62a
Merge pull request #30645 from tchaikov/wip-doc/man/ceph/config
doc/man/ceph: document 'ceph config'

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2019-10-09 15:20:25 +08:00
Paul Emmerich
9a71b8ad5f radosgw-admin: update help for max-concurrent-ios
--max-concurrent-ios works for all bucket operations and is quite
important when working with huge buckets

Signed-off-by: Paul Emmerich <paul.emmerich@croit.io>
2019-10-07 00:15:08 +02:00
Kefu Chai
c2adfb62c6
Merge pull request #30583 from mika/mika/typos
doc: fix typos

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2019-10-04 16:06:20 +08:00
Kefu Chai
86b9036c6c
Merge pull request #30614 from tchaikov/wip-no-more-osdmap-full
librados,osd,mon: remove traces of CEPH_OSDMAP_FULL

Reviewed-by: Sage Weil <sage@redhat.com>
Reviewed-by: xie xingguo <xie.xingguo@zte.com.cn>
2019-10-04 10:27:21 +08:00
Patrick Donnelly
cf4fef5cfb
Merge PR #30473 into master
* refs/pull/30473/head:
	doc: Fix FUSE expansion

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-10-03 05:00:20 -07:00
Jeff Layton
aa72b35cdb doc: document recover_session= option in mount.ceph manpage
Fixes: https://tracker.ceph.com/issues/40957
Signed-off-by: Jeff Layton <jlayton@redhat.com>
2019-10-01 15:26:59 -04:00
Kefu Chai
c07ecf9fef doc/man/ceph: document 'config' command
it'd be ideal if we offer the access to the help in manpage in addition
to its online counterpart.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2019-10-01 01:17:24 +08:00
Sidharth Anupkrishnan
660ba24de9 doc: Fix FUSE expansion
Signed-off-by: Sidharth Anupkrishnan <sanupkri@redhat.com>
2019-09-30 18:05:40 +05:30
Kefu Chai
c0dfec475d doc/man/ceph: more details on config-key command
Signed-off-by: Kefu Chai <kchai@redhat.com>
2019-09-30 15:06:39 +08:00
Kefu Chai
5d9f0e080e doc/man: update ceph(8) to drop "full" flag
`ceph {set,unset} full` does not take effect since mimic, and monitor
does not support this command since Octopus. so let's document this
change.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2019-09-30 13:26:07 +08:00
Michael Prokop
d98b3e36a9 doc: fix typos
s/amount of times/number of times/
s/assosciated/associated/
s/availabe/available/
s/Commiting/Committing/
s/Containter/Container/
s/dependant/dependent/
s/developement/development/
s/filesytem/filesystem/
s/guarenteed/guaranteed/
s/hiearchy/hierarchy/
s/intance/instance/
s/Interger/Integer/
s/mutiple/multiple/
s/nubmer/number/
s/occured/occurred/
s/overriden/overridden/
s/reseted/reset/
s/sytem/system/
s/unkown/unknown/

Signed-off-by: Michael Prokop <mika@grml.org>
2019-09-26 09:17:07 +02:00
Rishabh Dave
a96a32bd2e doc/ceph-fuse: mention -k option in ceph-fuse man page
Fixes: https://tracker.ceph.com/issues/42044
Signed-off-by: Rishabh Dave <ridave@redhat.com>
2019-09-25 12:21:20 +05:30
Sage Weil
7b988e9fe1 doc: remove all pg_num arguments to 'osd pool create'
Also, update the dicussion about pg_num and pool creation, with a reference
to the autoscaler.

Signed-off-by: Sage Weil <sage@redhat.com>
2019-09-22 16:58:33 -05:00
Vikhyat Umrao
ae9a24eaba tools/rados: add --pgid in help
This commit 825c7b9729 brought
the support for --pgid in rados ls but was not in help.
Fixes: https://tracker.ceph.com/issues/41876

Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
2019-09-17 14:07:12 -07:00
Patrick Donnelly
10cb50f994
Merge PR #29817 into master
* refs/pull/29817/head:
	doc: document that the kcephfs mount helper will search keyring files for secrets
	mount.ceph: fork a child to get info from local configuration
	mount.ceph: track mon string and path inside ceph_mount_info
	mount.ceph: add name and secret to ceph_mount_info
	mount.ceph: add ceph_mount_info structure
	mount.ceph: clean up debugging output and error messages
	mount.ceph: clean up return codes
	mount.ceph: add comment explaining why we need to modprobe
	mount.ceph: use bools for flags
	common: have read_secret_from_file return negative error codes

Reviewed-by: Kefu Chai <kchai@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2019-09-16 16:49:39 -07:00
Andreas Krebs
76d3671d03 doc: Add missing ceph-volume lvm batch argument to ceph-volume.rst
The optional argument '--osds-per-device' is missing. Since this is quite helpful when creating NVMe based OSDs, it should be documented.

Signed-off-by: Andreas Krebs <wintamute@gmail.com>
2019-09-13 08:27:53 -04:00
Jeff Layton
eae0127513 mount.ceph: fork a child to get info from local configuration
When a secret and/or the mon addrs are not specified by the admin,
then mmap a MAP_SHARED buffer and spawn a child process to get that
info. For safety reasons, the child drops all capabilities other than
CAP_DAC_READ_SEARCH (to ensure that it'll be able to read the keyring,
should one be found). To achieve this, we add a new dependency on
libcap-ng.

Add a new C++ file with a single routine that will create a CephContext,
get a list of monitor addresses and scrape the keyring for a secret for
the specified cephx user.

If that info is found, then it is copied to fixed-length buffers in the
MAP_SHARED area and the child exits successfully.

The parent will then vet the returned info and copy it into the
appropriate fields if they are currently blank.

Fixes: https://tracker.ceph.com/issues/16656
Signed-off-by: Jeff Layton <jlayton@redhat.com>
2019-09-13 08:14:48 -04:00