Commit Graph

403 Commits

Author SHA1 Message Date
Laura Flores
f2b75166a2
Merge pull request #43388 from e337/wip-doc-50499 2022-02-18 18:24:02 -06:00
Kefu Chai
9b5a77eb1a
Merge pull request #44707 from liumiaomiaoIntel/qatdoc
doc/radosgw: update QAT acceleration to specify the configuration

Reviewed-by: Kefu Chai <tchaikov@gmail.com>
2022-01-29 14:13:41 +08:00
Miaomiao Liu
6a7f1f6c37 doc/radosgw: update QAT acceleration to specify the configuration
add and change the configuration steps to enable latest version of QAT
driver on QAT based encryption and compression

Signed-off-by: Miaomiao Liu <miaomiao.liu@intel.com>
2022-01-29 12:41:37 +08:00
Guillaume Abrioux
203406b87e
Merge pull request #44192 from liuqinfei/docfix
doc: typo fixes in ceph-volume and install
2022-01-25 16:05:40 +01:00
Sebastian Wagner
62558af5a3
Merge pull request #42115 from sandrobonazzola/patch-2
doc/install: ensure to open ceph-mon firewall ports

Reviewed-by: Sebastian Wagner <sewagner@redhat.com>
2022-01-10 15:41:32 +01:00
Anthony D'Atri
ff96092cf0 doc/install: Update quay.io URL for ceph-ci builds
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2021-12-23 15:04:52 -08: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
liuqinfei
a859a9f1ba doc: typo fixes
Signed-off-by: liuqinfei <18138800392@163.com>
2021-12-02 23:19:34 +08:00
Sandro Bonazzola
2bd9383934 doc/install: ensure to open ceph-mon firewall ports
doc/install: ensure to open ceph-mon firewall ports

Signed-off-by: Sandro Bonazzola <sbonazzo@redhat.com>
2021-10-19 11:37:58 +02:00
Eunice Lee
8a16d95ae8 doc: fix reference to non-existent stable branch
Fixes: #50499

Signed-off-by: Eunice Lee (eunice337@gmail.com)
2021-10-01 13:00:03 -07:00
Sage Weil
d1c744ee53 doc/install/containers: quay.io!
Signed-off-by: Sage Weil <sage@newdream.net>
2021-08-04 09:38:49 -05:00
Ilya Dryomov
c22e44895d
Merge pull request #40965 from rokj/patch-3
doc: mention copying keyrings and adjust node names in manual deployment example

Reviewed-by: Ilya Dryomov <idryomov@gmail.com>
2021-07-29 23:54:44 +02:00
Rok Jaklič
bcad5d9822 doc: adding missing command. changed node naming.
Signed-off-by: Rok Jaklič <rokj@rasca.net>
2021-07-29 09:49:13 +02:00
Kefu Chai
3a41134592 doc/install/get-packages: do not mention additional 3rd party packages
since we are able to build and run on ubuntu focal without extra
dependencies of 3rd party packages, there is no need to mention them.
actually all of the removed packages are available in ubuntu focal.
some of them have different package names though.

the same applies to el8.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-01 16:38:56 +08:00
Kefu Chai
71e6adac35 doc/install/get-packages: s/el7/el8/
since we don't build for el7 anymore. replace all occurrences of el7 with
el8.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-07-01 16:38:56 +08:00
Sandro Bonazzola
136dbdef66 doc/install/get-packages: point to current stable release
Point to pacific for downloading the cephadm script

Co-authored-by: Kefu Chai <tchaikov@gmail.com>
Signed-off-by: Sandro Bonazzola <sbonazzo@redhat.com>
2021-06-22 20:48:06 +08:00
Abutalib Aghayev
413d344723 doc: Add a missing instruction to manual deployment guide.
Following the instructions as is results in the following error at step 15:

$ sudo -u ceph ceph-mon --mkfs -i node1 --monmap /tmp/monmap --keyring /tmp/ceph.mon.keyring
global_init: error reading config file.

Signed-off-by: Abutalib Aghayev <agayev@cs.cmu.edu>
2021-06-18 14:32:54 +08:00
Varsha Rao
dfc6a0e0e7 doc/install: replace do_cmake note with link to ceph README
Ceph README.md doc already has the do_cmake note and other build related info.

Signed-off-by: Varsha Rao <varao@redhat.com>
2021-03-26 12:20:00 +05:30
Varsha Rao
36e001b04e doc/install: Update about ninja
'ninja' replaced 'make' in this PR[1]. This patch updates the doc about it.

[1] https://github.com/ceph/ceph/pull/39826

Signed-off-by: Varsha Rao <varao@redhat.com>
2021-03-26 12:20:00 +05:30
Kefu Chai
bd0a87fb5c doc/install/windows-troubleshooting: fix typo
and tweak the format a little bit

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-25 01:03:34 +08:00
Lucian Petrut
8e4fe67100 doc: update Windows MSI link
Instead of having a direct download link, we'll point to the
download page, which will eventually contain other MSI versions as
well (e.g. Quincy).

While at it, we're simplifying the document a bit, dropping
information that's also included in the manual install guide.

Signed-off-by: Lucian Petrut <lpetrut@cloudbasesolutions.com>
2021-03-17 10:49:11 +00:00
Lucian Petrut
76a38a6b10 doc: reorganize Windows docs
Most of the Windows documentation is currently included in the
README.windows.rst file.

To make it more accessible, we're moving most of it to the
"doc/" folder, adding the following pages:

* Installing Ceph on Windows
* RBD on Windows
* Windows troubleshooting

We'll keep the build and manual install instructions in
README.windows.rst. Note that ceph-dokan already has a separate
doc page.

Signed-off-by: Lucian Petrut <lpetrut@cloudbasesolutions.com>
2021-03-15 15:15:32 +00:00
Sebastian Wagner
97338d7343 doc/install/index_manual: remove cephadm from toctree
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-04 18:18:33 +01:00
Sebastian Wagner
16417c18c3 doc/install: Remove Upstart from Freebsd deployment
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-19 11:17:00 +01:00
Sebastian Wagner
8069dea427 doc/install: cephadm is the successor of DeepSea
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-09 12:05:02 +01:00
Ivan Jager
5f017bed4a doc: Fix mds capabilities for manual deployment
Now matches auth-config-ref.rst, and actually works.

Signed-off-by: Ivan Jager <aij+git@mrph.org>
2020-12-20 05:50:08 -06:00
zdover23
acf80f111c
Merge pull request #34506 from ktdreyer/doc-rm-sysv-init
doc: remove SysV init reference in manual deployment walkthrough

Reviewed-by: Zac Dover <zac.dover@gmail.com>
2020-11-23 16:10:30 +10:00
Kefu Chai
fe785597e3
doc: add a link to ceph-deploy document 2020-10-07 00:20:58 +08:00
Ponnuvel Palaniyappan
d99d520493 doc: Fixed a number of typos in documentation
Signed-off-by: Ponnuvel Palaniyappan <pponnuvel@gmail.com>
2020-09-18 18:17:15 +01:00
Robert Sander
1b42759e19 doc: remove references to ceph-deploy
The documentation still has many traces of ceph-deploy. This tool has
been deprecated with the Octopus release. This commit tries to remove
most of ceph-deploy occurences.

Signed-off-by: Robert Sander <r.sander@heinlein-support.de>
2020-09-02 21:14:36 +02:00
Kefu Chai
ca1cca0abc doc: fix broken hyper link
Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08:00
Kefu Chai
45f43be813 doc: define label before section title
so we can see the title of section when following the link

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08:00
Kefu Chai
fe07df9f19 doc: always refernce terms in case sensitive mode
to silence warning from sphinx like:

ceph/doc/install/ceph-deploy/quick-start-preflight.rst:5: WARNING: term node not found in case sensitive match.made a reference to Node instead.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:18 +08:00
Kefu Chai
7ca85e77d0 doc: replace luminous with |stable-release|
"luminous" is a magic number in these contexts, and we should use a
constant for representing it.

the "sphinx_substitution_extensions" sphinx extension is introduced for
performing the global subsitution.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-09-01 09:53:17 +08:00
Zac Dover
8aebd0fd57 doc/cephadm: index.rst: s/suites/suits/ typo fixed.
This commit changes the sentence "Choose the method that best suites
your needs." to "Choose the method that best suits your needs."

Fixes: https://tracker.ceph.com/issues/46359
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-07-05 19:18:31 +10:00
Zac Dover
15138ca4c8 doc/install: add sudo to command
This commit adds "sudo" to a ceph-authtool command
that is missing the "sudo".

Fixes: https://tracker.ceph.com/issues/46065
Signed-off-by: Zac Dover <zac.dover@gmail.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-06-22 15:13:16 +10:00
Zac Dover
f0fe087077 Add note warning against the :latest tag.
Signed-off-by: Zac Dover <zac.dover@gmail.com>

Incorporating mgfritch's improvements.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

s/docker/podman/ -- as per mgfritch's suggestion

Signed-off-by: Zac Dover <zac.dover@gmail.com>

s/: latest/:latest/

Signed-off-by: Zac Dover <zac.dover@gmail.com>

s/image ids/image IDs/ -- as per Alex Settle's suggestion.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

Add note warning against the :latest tag.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

s/image ids/image IDs/ -- as per Alex Settle's suggestion.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

Linked to container page from cephadm install page.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

Clarified the note directing readers to the container documentation.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-05-29 14:54:21 +10:00
Shengming Zhang
0376fe8e63 doc:replacing https://ceph.com/ by http://download.ceph.com/
Signed-off-by: Shengming Zhang <zhangsm01@inspur.com>
2020-05-23 13:40:41 +08:00
Kefu Chai
73f68ecb95
Merge pull request #33975 from jbwyatt4/jbwyatt4-need-disk-space-info
doc: added space requirement to "Build Prerequisites"

Reviewed-by: Deepika Upadhyay <dupadhya@redhat.com>
2020-04-15 07:51:05 +08:00
Tim
d7c7ccb439 Update index.rst
clean up "only only"

Signed-off-by: Tim <elatllat@gmail.com>
2020-04-11 08:30:08 -04:00
Kefu Chai
0cb56e0f13 doc: use plantweb as fallback of sphinx-ditaa
RTD does not support installing system packages, the only ways to install
dependencies are setuptools and pip. while ditaa is a tool written in
Java. so we need to find a native python tool allowing us to render ditaa
images. plantweb is able to the web service for rendering the ditaa
diagram. so let's use it as a fallback if "ditaa" is not around.

also start a new line after the directive, otherwise planweb server will
return 500 at seeing the diagram.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-04-10 08:38:06 +08:00
Ken Dreyer
52d0c37aa5 doc: remove SysV init reference in manual deployment walkthrough
Every other instruction in this document uses systemd. Drop the last
SysV init reference.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
2020-04-09 16:42:12 -06:00
John Wyatt
b383280057 Doc: added space requirement to "Build Prerequisites"
Build prerequisites section does not include how much space Ceph
takes. A Ceph debug build can take 40 gigabytes by itself - double
the default size of many VMs by default, including CentOS 8 for
virt-manager. New contributors may be turned off or may not
understand why Ceph does not build. Also a warning on LVM taking
up too much disk space.

Signed-off-by: John B. Wyatt IV <jbwyatt4@gmail.com>
2020-03-26 17:04:08 -07:00
Kefu Chai
20efbfb507
Merge pull request #31453 from oneoneonepig/patch-2
doc: add sudo in ceph status command

Reviewed-by: Neha Ojha <nojha@redhat.com>
Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-03-26 17:19:28 +08:00
Kefu Chai
596565d6e7
Merge pull request #34101 from s1eke/master
doc: Fix some link errors about ceph-deploy

Reviewed-by: Kefu Chai <kchai@redhat.com>
2020-03-24 14:00:29 +08:00
Sage Weil
895b856aee Merge remote-tracking branch 'gh/octopus' 2020-03-23 20:09:41 -05:00
Sage Weil
41bc82f284 doc/install/get-packages: update package install instructions
- include cephadm method
- update to include new version URLs

Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-23 12:40:19 -05:00
Sean Fang
bb5802407c doc: Fix some link errors about ceph-deploy
Previously moved "ceph-deploy" did not change the link jump in it correctly

Signed-off-by: Sean Fang <silence.boy@live.cn>
2020-03-21 13:20:54 +08:00
Sage Weil
6cb39e4aa8 Merge PR #34060 into master
* refs/pull/34060/head:
	Merge PR #34027 into octopus
	Merge PR #34045 into octopus
	Merge pull request #34035 from dillaman/wip-rbd-permissions
	mgr/progress: fix duration strings
	Merge PR #34014 into octopus
	Merge PR #34001 into octopus
	Merge PR #34011 into octopus
	qa/workunits/rbd: use context managers to control Rados lifespan
	Merge pull request #34032 from dillaman/wip-rbd-octopus-docs
	doc/releases/octopus: add additional RBD improvements
	qa/workunits/cephadm/test_cephadm: mark services unmanaged for test
	mgr/cephadm: do not reconfig unmanaged services
	Merge PR #33981 into octopus
	Merge pull request #34018 from ajarr/octopus-subvolume-clone-cancel
	qa/workunits/cephadm/test_cephadm: output file for pub key
	Merge PR #33866 into octopus
	Merge PR #34005 into octopus
	Merge PR #34013 into octopus
	mgr/cephadm: pytest: Enable SpecStore
	mgr/orchestrator: add test for default implementation for apply()
	python-common: validate ServiceSpec.service_type
	fixup mgr/cephadm: Fix ceph orch apply -i
	mgr/dashbaord: orchestrator service: Revert wait_api_result to a single completion
	mgr/orchestrator: `orch daemon add` accepts a yaml
	mgr/cephadm: apply_drivegroups() returns a single Completion
	mgr/cephadm: remove `trivial_result()`
	mgr/cephadm: Fix `ceph orch apply -i`
	Merge pull request #33994 from dillaman/wip-librbd-poll-event-race
	doc: document `clone cancel` command
	test: add `clone cancel` tests
	mgr/volumes: introduce "clone cancel" volume command
	mgr/volumes: allow canceling a single asynchronous job for a volume
	mgr/volumes: helper for looking up a clone entry index
	mgr/volumes: periodically check if clone operations should be canceled
	mgr/volumes: periodically check if copy operations should be canceled
	mgr/volumes: introduce 'canceled' state in clone op state machine
	qa/suites/rados/verify/validater/valgrind: tolerate SLOW_OPS
	qa/suites/rados/verify/validater/valgrind: less bluestore logging
	qa/suites/rados/verify/validater: increase heartbeat grace
	Revert "qa/suites/rados/verify: debug_ms = 1, osd_heartbeat_grace = 60"
	Revert "qa/suites/rados/verify/validator/valgrind: debug refs = 5"
	ceph_test_watch_notify: try notify 10x if ALLOW_TIMEOUTS is set
	ceph_test_rados_api_misc: ShutdownRace timeout if ALLOW_TIMEOUTS is set
	qa/suites/rados/verify: set ALLOW_TIMEOUTS for workunits
	doc/install: edits
	doc/cephadm: more edits
	doc/cephadm/install: edits
	doc/cephadm/adoption: improvements
	doc/cephadm/install: a few edits
	doc/cephadm/install: do not install ceph-common on host (by default)
	doc/cephadm: drop os recs link
	doc/cephadm/upgrade: improvements
	doc/cephadm/upgrade: document upgrade
	doc/cephadm/install: revamp install docs
	doc: reorganize cephadm docs
	doc/cephadm/administration: update docs on customizing SSH config
	doc/cephadm/administration: add a note about the 'removed' dir
	mgr/balancer: tolerate pgs outside of target weight map
	qa/workunits/cephadm/test_cephadm: --skip-monitoring-stack
	Merge PR #33974 into octopus
	Merge PR #33442 into octopus
	Merge PR #33997 into octopus
	Merge PR #34000 into octopus
	use quay octopus tip until 15.2 tag is available
	python-common: reduce output of ServiceSpec.to_json()
	python-common,mgr/cephadm: move assert_valid_host to service_spec
	mgr/cephadm: add HostAssignment.validate()
	mgr/dashboard: adapt create_osds interface change
	mon/MgrMonitor: make 'mgr fail' work with no arguments
	cephadm: add allow_ptrace option to enable SYS_PTRACE
	update default container images
	mgr/cephadm: limit number of times check host is performed in the serve loop
	Merge PR #33961 into octopus
	Merge PR #33952 into octopus
	Merge PR #33990 into octopus
	Merge PR #33955 into octopus
	Merge PR #33936 into octopus
	mgr/orch: add --all-available-devices to 'orch apply osd'
	qa/workunits/cephadm: --skip-mon-network when using 127.0.0.1
	cephadm: add tests
	qa/tasks/cephadm: pass -v to bootstrap
	mgr/cephadm: only try to place mons on hosts matching public_network
	mgr/cephadm: keep track of host networks, ips
	cephadm: automatically infer mon public_network, if we can
	cephadm: add list-networks command
	cephadm: bootstrap: deploy monitoring stack by default
	librbd: defer event socket completion until after callback issued
	cephadm: add-repo: add --version
	mgr/cephadm: respect 'unmanaged' flag in spec
	mgr/orch: orch ls: show <no spec> or <unmanaged> as appropriate
	mgr/orch: orch ls: rename SPEC -> PLACEMENT
	mgr/orch: add 'unmanaged' property to ServiceSpec
	cephadm: rename distro args in repo methods
	mgr/orch: combine 'orch daemon add <type> ...' into one command
	mgr/orch: combine 'orch apply <type> [<placement>]' into one command

Reviewed-by: Laura Paduano <lpaduano@suse.com>
2020-03-19 11:07:16 -05:00
Sage Weil
2fafbffdc9 doc/install: edits
Based on review by Alexandra Settle <asettle@suse.com>

Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00