Commit Graph

7775 Commits

Author SHA1 Message Date
Rachanaben Patel
f000ecb64e doc/RBD:fixes for ceph-immutable-object-cache daemon enable command
Document for rbd-persistent-read-only-cache show how to manage
ceph-immutable-object-cache daemon using systemd.
command example needs fixing.It should be

systemctl enable ceph-immutable-object-cache@ceph-immutable-object-cache.{unique id}

Fixes: https://tracker.ceph.com/issues/49849
Signed-off-by: Rachanaben Patel <racpatel@redhat.com>
2021-03-16 15:37:46 -07:00
Patrick Donnelly
8e9738033a
Merge PR #40114 into master
* refs/pull/40114/head:
	doc: reorganize Windows docs

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Jason Dillaman <dillaman@redhat.com>
2021-03-16 12:27:43 -07:00
Sage Weil
0d3df9b959 Merge PR #39931 into master
* refs/pull/39931/head:
	mgr/cephadm: fall back to service spec port if none on DaemonDescription
	mgr/cephadm: fix redeploy when daemons have ip:port
	mgr/cephadm/schedule: add test case
	qa/suites/rados/cephadm/smoke-roleless: add rgw test on many ports
	doc/cephadm/rgw: update docs to show count-per-host
	mgr/cephadm: add support for rgw_frontend_type (beast or civetweb)
	mgr/cephadm: remove ssl_frontend_ssl_key from RGWSpec
	mgr/cephadm: fix beast private key config option
	mgr/cephadm: fix rgw ssl cert/key config-key path
	mgr/cephadm/schedule: dynamically assign ports for rgw
	mgr/cephadm/schedule: only 1 port in DaemonPlacement
	mgr/cephadm: move rgw frontend logic into RgwService
	mgr/cephadm/schedule: return DaemonPlacement instead of HostPlacementSpec
	mgr/cephadm/schedule: remove unused methods
	mgr/cephadm: propagate ip:port from CephadmDaemoNDeploySpec to deployment
	cephadm: populate ports if known and not included in unit.meta
	mgr/cephadm: gather and report ports in 'orch ps' output

Reviewed-by: Sebastian Wagner <swagner@suse.com>
2021-03-16 13:04:55 -04:00
Zac Dover
25d9429d66 doc/cephadm: break mon section into sections
This PR breaks the "Deploy Additional Monitors" section
of the cephadm documentation into several subsections
whose titles spotlight the matter under discussion in
those respective subsections.

inb4: Another PR is on deck that rewrites the sentences
in this chapter of the cephadm documentation. I'd like
to get this chapter broken up into these subsections before
I rewrite those sentences. So I'm hoping for no grammatical
mission creep on this one. The grammar and clarity updates
are coming.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-17 02:15:48 +10:00
zdover23
fcf8fbcb6e
Merge pull request #40141 from zdover23/wip-doc-cephadm-mon-deploying-add-rewrite-2021-Mar-16
doc/cephadm: rewrite "deploying add. mons"

Reviewed-by: Juan Miguel Olmo <jolmomar@redhat.com>
2021-03-17 01:10:01 +10:00
Zac Dover
c605750db2 doc/cephadm: rewrite "deploying add. mons"
This rewrites the section "Deploying Additional
Monitors (Beyond the Default Three)" for elegance
and clarity.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-16 09:02:19 +10:00
Sage Weil
09618354e9 doc/cephadm/rgw: update docs to show count-per-host
Signed-off-by: Sage Weil <sage@newdream.net>
2021-03-15 18:55:16 -04: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
f29cae053b
Merge pull request #39916 from zdover23/wip-doc-cephadm-adoption-preparation-2021-Mar-08
doc/cephadm: rewrite "preparation" in adoption.rst

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-15 15:25:39 +01:00
Josh Durgin
fe838fcb2c
Merge pull request #40036 from tchaikov/wip-doc-mgr
doc/mgr: fix formatting

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2021-03-12 15:48:10 -08:00
David Galloway
ec5044394c doc: 14.2.17 Release Notes
Signed-off-by: David Galloway <dgallowa@redhat.com>
2021-03-11 17:07:54 -05:00
Zac Dover
2a47caff72 doc/cephadm: rewrite "preparation" in adoption.rst
This rewrites the "Adoption" section of
preparation.rst in the Cephadm manual.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-12 05:42:32 +10:00
Patrick Donnelly
87d3e17987
Merge PR #39845 into master
* refs/pull/39845/head:
	doc: clarify mirror daemon user capability requirements
	doc: doc changes for additional mirroring interfaces
	pybind/mirroring: add interface to list file system mirror peers
	pybind/mirroring: set libcephfs handle root uid/gid as 0:0
	test: add tests for mirroring bootstrap interfaces
	pybind/mirroring: introduce peer_bootstrap {create|import} commands
	cephfs-mirror: use peer cluster monitor address (and key) if available
	mon: peer_add should accept Ceph file system UUID
	mon: introduce "profile cephfs-mirror" cap constrained to "config-get cephfs/mirror/peer"
	test: add test for failed filesystem mirror instances
	cephfs-mirror: restart failed mirror filesystem instances

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-03-11 09:34:53 -08:00
Patrick Donnelly
b7f8c681d2
Merge PR #39671 into master
* refs/pull/39671/head:
	doc: snap-schedule documentation

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Venky Shankar <vshankar@redhat.com>
2021-03-11 09:23:20 -08:00
Kefu Chai
cdbc1a9f22 doc/mgr: fix formatting
a code block should start with "::".

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-12 00:32:45 +08:00
Sebastian Wagner
f744878d82
Merge pull request #39875 from zdover23/wip-doc-cephadm-adoption-overview-and-limitations-rewrite-2021-Mar-06
doc/cephadm: rewrite part of adoption.rst

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-11 12:19:37 +01:00
Sebastian Wagner
543fc00951
Merge pull request #40008 from mgfritch/cephadm-nfsv3-deprecate
doc/cephadm: add note about deprecation of NFSv3

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-11 12:06:20 +01:00
Sebastian Wagner
5f7a2ab76f
Merge pull request #39932 from mgfritch/custom-monitoring-j2
doc/cephadm: update section on applying custom config (j2) 

Reviewed-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-11 11:44:17 +01:00
Venky Shankar
943ea38678 doc: clarify mirror daemon user capability requirements
Fixes: http://tracker.ceph.com/issues/49619
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2021-03-11 03:41:52 -05:00
Venky Shankar
f766e8297c doc: doc changes for additional mirroring interfaces
Signed-off-by: Venky Shankar <vshankar@redhat.com>
2021-03-11 03:41:52 -05:00
Michael Fritch
a52bd99a60
doc/cephadm: add note about deprecation of NFSv3
Signed-off-by: Michael Fritch <mfritch@suse.com>
2021-03-10 13:17:23 -07:00
Sebastian Wagner
1d2009c3e9
Merge pull request #39640 from sebastian-philipp/cephadm-cephfs-mirror
cephadm: cephfs-mirror

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Sage Weil <sage@redhat.com>
2021-03-10 18:34:03 +01:00
Jan Fajerski
96556f1fbc doc: snap-schedule documentation
Fixes: https://tracker.ceph.com/issues/48017

Signed-off-by: Jan Fajerski <jfajerski@suse.com>
2021-03-10 18:24:03 +01:00
Patrick Donnelly
4b506bbe4e
Merge PR #38913 into master
* refs/pull/38913/head:
	qa/tasks/cephfs/nfs: Add tests for updating fs exports
	mgr/volumes/nfs: Handle rook restart error
	doc/cephfs/nfs: Add about update export interface
	mgr/volumes/nfs: Add command to update cephfs exports
	pybind/volumes/nfs: set mds caps according to user specified access type
	mgr/volumes/module: Remove unused json module

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-03-10 07:01:27 -08:00
Sebastian Wagner
175ee83909 mgr/orch: replace def add_{type}(...) with generic add_daemon()
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-10 15:02:41 +01:00
Sebastian Wagner
b6a2dfc777
Merge pull request #39877 from liewegas/cephadm-rgw-simplification
mgr/cephadm: simplify handling for rgw

Reviewed-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
Reviewed-by: Or Friedmann <ofriedma@redhat.com>
2021-03-10 13:58:37 +01:00
Sebastian Wagner
744edab3ff
Merge pull request #39541 from pcuzner/config-checker
mgr/cephadm: Provide an integrated configuration validation feature

Reviewed-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
2021-03-10 13:37:10 +01:00
Sebastian Wagner
d93d1ed43f
Merge pull request #39599 from pcuzner/cephadm-with-lsm
mgr/cephadm:Enable cephadm device scan to use libstoragemgmt

Reviewed-by: Dan Mick <dmick@redhat.com>
2021-03-10 12:14:37 +01:00
Kefu Chai
7e4eb6d801 doc/man/8/mount.ceph: fix the formatting
* fix the indent of item
* add an empty line before code block

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-10 12:28:28 +08:00
Kefu Chai
27bcb291ee doc/start: fix the link pointing to ceph doc
use https instead of http, the latter cannot be redirected to the valid
docs. also, we don't have "next" branch, so remove the document
mentioning it.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-10 12:28:28 +08:00
Kefu Chai
a042c5b659 doc/_themes: fine tune styling
* fix the "dl" (definition list) display in manpage. before this
  change, if an item in dl is composed of strings with different fonts,
  it is cluttered into a single string. after this change, they are
  separated with proper spacing as before. see the "WORKLOAD" section in
  https://docs.ceph.com/en/latest/man/8/ceph-syn/ and
  https://docs.ceph.com/en/octopus/man/8/ceph-syn/
* reduce the spacing in "ul" (unordered list) in table. before
  this change, we have large spacing at end of a list in table. after
  this change, the spacing is reduced. see
  https://docs.ceph.com/en/latest/start/hardware-recommendations/#ram
  https://docs.ceph.com/en/octopus/start/hardware-recommendations/#ram
* increase the spacing between two "ul"s in table. see
  https://docs.ceph.com/en/latest/start/hardware-recommendations/#Processor
  https://docs.ceph.com/en/octopus/start/hardware-recommendations/#ram

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-10 12:28:28 +08:00
Michael Fritch
9441d66318
doc/cephadm: remove step to restart the mgr
a restart of the mgr does not appear to be necessary
after a `ceph config-key set ...`

Signed-off-by: Michael Fritch <mfritch@suse.com>
2021-03-09 21:06:27 -07:00
Michael Fritch
b4b6f359df
doc/cephadm: use reconfig instead of redeploy
`reconfig` can be used to apply a change to either
the tls/ssl cert or a custom configuration file (j2)

Signed-off-by: Michael Fritch <mfritch@suse.com>
2021-03-09 21:06:20 -07:00
Michael Fritch
b58b0de777
doc/cephadm: update custom j2 config-key name
introduced by:
cd79c9912a

Signed-off-by: Michael Fritch <mfritch@suse.com>
2021-03-09 21:06:12 -07:00
zdover23
557a3c4d27
Merge pull request #39946 from TheJJ/fix-ceph-crash-caps
doc/mgr/crash: explain needed crash upload permissions

Reviewed-by: Zac Dover <zac.dover@gmail.com>
2021-03-10 09:38:37 +10:00
Sage Weil
50bc491373 doc: update docs
Signed-off-by: Sage Weil <sage@newdream.net>
2021-03-09 14:29:39 -05:00
Zac Dover
c011121893 doc/cephadm: rewrite "adoption process"
This rewrites the "Adoption Process" section
of the "Converting and Existing Cluster to
cephadm" chapter of the Cephadm guide.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-10 00:29:55 +10:00
Jonas Jelten
4f98499bfa doc/mgr/crash: explain needed crash upload permissions
Signed-off-by: Jonas Jelten <jj@sft.lol>
2021-03-09 14:12:32 +01:00
Casey Bodley
ef1c10127f
Merge pull request #38605 from mdw-at-linuxbox/wip-master-transit
rgw: new vault transit logic for SSE-C

Reviewed-by: Casey Bodley <cbodley@redhat.com>
2021-03-08 11:00:01 -05:00
Zac Dover
a445653511 doc/cephadm: rewrite part of adoption.rst
This PR adds a bit of explanatory text to the
section of the cephadm docs that explains how
to convert Ceph deployments that were not deployed
with cephadm to deployments that can be managed by
the cephadm command line tool.
2021-03-08 11:20:24 +10:00
Josh
ffc08b930b doc/cephadm: use 'apt' to install cephadm on Ubuntu
Adjusted so Ubuntu command uses 'apt' and added Fedora since that uses 'dnf'.
2021-03-07 19:16:21 +08:00
Marcus Watts
a9edb632a5 rgw/kms/vault - document configuration for new transit logic
Using the new transit logic requires slightly different configuration.
additionally there is some backwards compatibility support, which
also needed documentation.

The existing description of how to configure hashicorp vault
to work with ceph was also incomplete.  I've fleshed that out a bit,
including considerably more information on how to use configure
and use the vault secret agent with ceph.

Fixes: http://tracker.ceph.com/issues/48746
Signed-off-by: Marcus Watts <mwatts@redhat.com>
2021-03-05 23:05:13 -05:00
Neha Ojha
c4408499e4
Merge pull request #39719 from zdover23/wip-doc-dev-t8y-interactive-on-error-rewrite-2021-Feb-26
doc/dev: t8y interactive-on-error rewrite

Reviewed-by: Neha Ojha <nojha@redhat.com>
2021-03-05 17:32:42 -08:00
Patrick Donnelly
dc43925fc7
Merge PR #38819 into master
* refs/pull/38819/head:
	win32*.sh: use ninja instead of make
	doc: add ceph-dokan documentation
	cephfs: Add ceph-dokan, providing Windows support
	cephfs: add ceph_may_delete function
	cephfs: disable inode emulation on Windows

Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
2021-03-05 14:28:25 -08:00
Matt Benjamin
d2c30d7130
Merge pull request #33996 from mdw-at-linuxbox/wip-master-kmip
rgw / kmip kms
2021-03-05 16:20:18 -05:00
Josh Durgin
6bc166b77b
Merge pull request #39861 from tchaikov/wip-doc-theme
doc/_theme: remove the spacing at top of "dl dt"

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2021-03-05 11:42:30 -08:00
zdover23
f22432c923
Merge pull request #39838 from sebastian-philipp/doc-rm-cephadm-install
doc/install/index_manual: remove cephadm from toctree

Reviewed-by: Zac Dover <zac.dover@gmail.com>
2021-03-06 03:38:37 +10:00
Kefu Chai
94d114c8d7 doc/_theme: remove the spacing at top of "dl dt"
otherwise there is a margin-top on top of dt.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2021-03-06 00:13:16 +08:00
Lucian Petrut
eaa415f169 doc: add ceph-dokan documentation
This change documents ceph-dokan, describing the prerequisites,
usage and limitations.

Some of this was mentioned in README.windows.rst but is now being
moved to the Ceph doc pages.

Signed-off-by: Lucian Petrut <lpetrut@cloudbasesolutions.com>
2021-03-05 13:15:45 +00:00
Sebastian Wagner
d5fee3e64a
Merge pull request #39809 from sebastian-philipp/cephadm-compatibilty
doc/cephadm: remove warning about cephadm in production 

Reviewed-by: Sage Weil <sage@redhat.com>
2021-03-05 12:20:33 +01:00