Commit Graph

51 Commits

Author SHA1 Message Date
Daniel Pivonka
b28fd9838e doc/cephadm: explicitly show host requirments in adding host section
Signed-off-by: Daniel Pivonka <dpivonka@redhat.com>
2021-03-23 14:56:33 -04:00
Jeff Layton
bf69cdc689 doc: fixes for cephadm documentation
Be sure to note that python 3 is a prerequisite. Minimal centos 8
installs don't have it, for instance.

Also, we probably don't want to hardcode an octopus URL into the
suggested curl command. Change it to fill that in with
"|stable-release|", which should always point to the latest released
version name.

Fixes: https://tracker.ceph.com/issues/49806
Signed-off-by: Jeff Layton <jlayton@redhat.com>
2021-03-17 20:58:56 +08: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
Sebastian Wagner
8287a34aea
Merge pull request #39744 from zdover23/wip-doc-cephadm-install-install-cephadm-rewrite-2021-Feb-28
doc/cephadm: rewrite "install cephadm"

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-03-02 12:05:30 +01:00
Zac Dover
1b626b9895 doc/cephadm: rewrite "install cephadm"
This PR breaks the "Deploying a New Ceph Cluster"
section into several sub-sections, so that each sub-section
pertains to only one subject. I've also added some explanatory
text that puts the instructions into context more than they were
before.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-02 05:06:00 +10:00
Zac Dover
2ec313caba doc/cephadm: rewrite "b.strap a new cluster"
This PR rewrites the section "Bootstrap A New
Cluster" in the Cephadm Guide, in the Install
Chapter. I've broken this section up into what
seem to me to be the topics that the content
naturally divides into.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2021-03-02 04:20:35 +10:00
Sebastian Wagner
1033c46ad7 doc/cephadm: group MDS sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
46a203a5c6 doc/cephadm: Add iscsi
Fixes https://tracker.ceph.com/issues/49488

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
8d07e35b2f doc/cephadm: group NFS sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
b3846f6f6a doc/cephadm: group MON sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
0fb2ccb49b doc/cephadm: make custom containers its own chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
818ed4f202 doc/cephadm: group RGW mgmt sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
74bcd7c5f6 doc/cephadm: group OSD mgmt sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
88e8e91f72 doc/cephadm: group host mgmt sections into one chapter
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-26 11:51:29 +01:00
Sebastian Wagner
a4179acbce doc/cephadm: troubleshooting: manually deploy MGR
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-02-18 13:05:27 +01:00
Paul Cuzner
af00a33322 cephadm: updated doc text
The phrase "recommended"  has been removed.

Signed-off-by: Paul Cuzner <pcuzner@redhat.com>
2021-02-02 14:22:43 +13:00
Paul Cuzner
509f171a08 cephadm: install doc updated to include cluster-network parameter
Install guide updated to include a description of the --cluster-network
parameter. The text also links to the complete definition for cluster-network
on the rados/configuration/network-config-ref page.

Signed-off-by: Paul Cuzner <pcuzner@redhat.com>
2021-02-02 14:22:43 +13:00
Sebastian Wagner
eed40cf636 doc/cephadm: /etc/ceph is created automaticlly now
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-01-07 12:52:19 +01:00
Sebastian Wagner
28cc065271 doc/cephadm: CephFS: Encourage users to call ceph fs volume create
Manually deploying MDS daemons is an advanced topic.

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2021-01-07 12:52:19 +01:00
Zac Dover
6d4033d441 doc/cephadm: improve install guide
- Repair broken lists.
- Add bash prompt directives.
- Add code-block directives.
- Add command markup.
- Improve English grammar.
- Fix prompt indentation.

Fixes: https://tracker.ceph.com/issues/48023
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-11-03 19:35:50 +10:00
Kiefer Chang
a5aaaa69cc doc/dashboard: add information for Orchestrator NFS-Ganesha clusters
Fixes: https://tracker.ceph.com/issues/46492
Signed-off-by: Kiefer Chang <kiefer.chang@suse.com>
2020-10-19 19:11:17 +08:00
Sebastian Wagner
cb529acaf4
Merge pull request #36496 from Daniel-Pivonka/cephadm-44926
mgr/cephadm: rgw update period after realm, zone creation

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-08-21 11:40:17 +02:00
Daniel-Pivonka
70b11a1a83 mgr/cephadm: rgw update period after realm, zone creation
Signed-off-by: Daniel-Pivonka <dpivonka@redhat.com>
2020-08-18 15:54:31 -04:00
Sebastian Wagner
c625a51635
Merge pull request #36538 from zdover23/wip-docs-45678-fix
doc/cephadm: Remove shell alias

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-08-11 01:15:54 +02:00
Sebastian Wagner
75baae3528 doc/cephadm: Remove shell alias
Turns out, the alias doesn't work for files.

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

Fixes:

```
$ ceph orch apply -i myfile.yaml
ERROR: no such file or directory: myfile.yaml
```

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-08-10 17:50:54 +10:00
Daniel-Pivonka
131001c453 mgr/cephadm: streamline rgw deployment
cephadm will create realm, zonegroup, and zone if needed before creating rgw service

fixes: https://tracker.ceph.com/issues/43681
Signed-off-by: Daniel-Pivonka <dpivonka@redhat.com>
2020-07-29 14:23:07 -04:00
Adam King
a63b030ded mgr/cephadm: allow use of authenticated registry
Add option to use custom authenticated registry during
bootstrap as well as a registry-login command in order
to let user change authenticated registry login info

Fixes: https://tracker.ceph.com/issues/44886
Signed-off-by: Adam King <adking@redhat.com>
2020-07-23 16:08:56 -04:00
Sebastian Wagner
2ed21ac396
Merge pull request #35709 from zdover23/wip-doc-preferring-yaml-to-cli-in-cephadm
doc/cephadm: add yaml info for orch apply mon

Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-07-15 10:10:38 +02:00
Zac Dover
b02c98bfa5 doc/cephadm: add yaml infor for orch apply mon
This commit breaks one of the long sentences into
three shorter sentences, and adds a parenthetical
comment walking the reader through a series of commands,
explaining what each command does and why only the last
of the commands ends up having a lasting effect on the Ceph
environment.

Fixes: https://tracker.ceph.com/issues/46133
Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-07-15 00:05:31 +10:00
Daniel-Pivonka
1052b9db7b cephadm: add sudo ssh user option
add the ability to use a non-root users for connecting to hosts, this user requires pass wordless sudo access

useful for clusters that have root ssh access disabled

Fixes: https://tracker.ceph.com/issues/44866
Signed-off-by: Daniel-Pivonka <dpivonka@redhat.com>
2020-06-30 08:57:24 -04:00
Kiefer Chang
71140f47e5
doc/cephadm: document pool requirement for NFS-Ganesha service
Signed-off-by: Kiefer Chang <kiefer.chang@suse.com>
2020-06-16 18:23:04 +08: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
Ricardo Marques
71c58f18b5 cephadm: Add '--mount' option to mount host file or directory
Fixes: https://tracker.ceph.com/issues/45284

Signed-off-by: Ricardo Marques <rimarques@suse.com>
2020-05-04 15:35:43 +01:00
Sebastian Wagner
d6872343ad
Merge pull request #34728 from ricardoasmarques/infer-config
cephadm: Infer config on "cephadm shell"
2020-05-04 11:11:01 +02:00
Ricardo Marques
eb732dcbc5 cephadm: Infer config on "cephadm shell"
Fixes: https://tracker.ceph.com/issues/44792

Signed-off-by: Ricardo Marques <rimarques@suse.com>
2020-04-29 16:31:29 +01:00
Zac Dover
4571ee26a0 doc/cephadm/install.rst: Add troubleshooting for 'CIDR' error
add troubleshooting for 'failed to infer CIDR network...' error

See also
https://tracker.ceph.com/issues/44828

Signed-off-by: Zac Dover <zac.dover@gmail.com>
2020-04-27 00:35:37 +08:00
Sebastian Wagner
950943d67d doc/cephadm: install.rst: fix placement spec.
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-04-22 12:38:13 +02:00
Sebastian Wagner
c656e598ba
Merge pull request #34319 from clyso/patch-2
doc/mgr/orchestrator: update cephadm shell proposed alias entry

Reviewed-by: Sage Weil <sage@redhat.com>
Reviewed-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-04-03 12:48:11 +02:00
clyso
4a850e1dca doc/mgr/orchestrator: update cephadm shell proposed alias entry
prior change i get following error when using alias as "ceph -v":
INFO:cephadm:Inferring fsid ecfdb924-7341-11ea-943c-020100010027
INFO:cephadm:Using recent ceph image ceph/ceph:v15
/usr/bin/docker: Error response from daemon: OCI runtime create failed: container_linux.go:349: starting container process caused "exec: "/usr/bin/ceph -v": stat /usr/bin/ceph -v: no such file or directory": unknown.
after:
INFO:cephadm:Inferring fsid ecfdb924-7341-11ea-943c-020100010027
INFO:cephadm:Using recent ceph image ceph/ceph:v15
ceph version 15.2.0 (dc6a0b5) octopus (rc)

Signed-off-by: Tobias Fischer <tobias.fischer@clyso.com>
2020-04-03 09:52:47 +02:00
clyso
87440ab4d2 doc/mgr/orchestrator: add path to ssh-copy-id instructions
by default ssh key will be placed under /etc/ceph - so it should be included in examples

Signed-off-by: Tobias Fischer <tobias.fischer@clyso.com>
2020-04-03 09:51:08 +02:00
Michael Fritch
77440d91c1
mgr/cephadm: add deployment example to NFS docs
Signed-off-by: Michael Fritch <mfritch@suse.com>
2020-03-25 16:26:14 -06:00
Michael Fritch
530c62d76d
mgr/cephadm: update docs
Signed-off-by: Michael Fritch <mfritch@suse.com>
2020-03-25 16:26:13 -06:00
Sage Weil
de20c7bc61 Merge PR #34105 into master
* refs/pull/34105/head:
	Merge PR #34042 into octopus
	Merge PR #33959 into octopus
	Merge PR #34067 into octopus
	mgr/DaemonServer: add explicit check that acting matches for merge
	Merge pull request #34040 from dillaman/wip-44396-partial-fix
	Merge PR #34098 into octopus
	mgr/rook: list rgw services
	mgr/rook: tolerate timestamps that are None
	mgr/orch: add 'subcluster' property to RGWSpec
	mgr/rook: do not create radosgw pools
	mgr/rook: refactor apply/add for rgw
	Merge PR #34082 into octopus
	Merge PR #34068 into octopus
	cephadm: relabel /etc/ganesha mount
	Merge PR #34046 into octopus
	Merge PR #34092 into octopus
	Merge pull request #33719 from ukernel/wip-44416
	rbd-mirror: leader watcher should not cancel get locker if locker is invalid
	rbd-mirror: snapshot sync request needs to check for interruption
	librbd: request exclusive lock when moving to trash
	rbd-mirror: basic integration with sync throttling
	rbd-mirror: don't prematurely finish snapshot replay loop
	rbd-mirror: pass InstanceWatcher to snapshot Replayer
	doc/releases/octopus.rst: add note about ec recovery below min_size
	mgr/cephadm: configure rgw_frontends for rgw service
	cephadm: switch grafana image to the ceph repo
	Merge PR #34034 into octopus
	qa/suites/rados/cephadm/upgrade: update starting version
	Merge PR #33540 into octopus
	Merge PR #34023 into octopus
	Merge PR #34044 into octopus
	Merge PR #34030 into octopus
	doc/orchestrator: update rgw creation
	mgr/cephadm: clean up client.crash.* container_image settings after upgrade
	cephadm: make add-repo --release and --version independent
	cephadm: env over last used
	mgr/orch: accept port and ssl flags to 'apply rgw'
	mgr/orch: 'ceph upgrade ...' -> 'ceph orch upgrade ...'
	cephadm: fall back to default for infer_image
	cephadm: remove outdated check
	cephadm: consolidate default image logic
	remove ceph_test_rados_watch_notify
	python-common/ceph/deployment/service_spec: add ssl to RGWSpec
	cephadm: only infer image for shell, run, inspect-image, pull, ceph-volume
	mgr/test_orchestrator: fix service filtering when using dummy data
	mgr/dashboard: fix adding/removing host errors
	mgr/rook: fix 'orch ps' for osds
	qa: fix all the fsx.sh-invoking yaml files to install dependencies
	mds: pass proper MutationImpl::LockOp to Locker::wrlock_start()

Reviewed-by: Kiefer Chang <kiefer.chang@suse.com>
Reviewed-by: Laura Paduano <lpaduano@suse.com>
2020-03-23 08:24:06 -05:00
Sebastian Wagner
cb12a3177c doc/cephadm: replace osd create with apply osd
Fixes: https://tracker.ceph.com/issues/44692

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
2020-03-20 12:33:35 +01:00
Yehuda Sadeh
1833797488 doc/orchestrator: update rgw creation
Signed-off-by: Yehuda Sadeh <yehuda@redhat.com>
2020-03-19 08:11:50 -07:00
Sage Weil
63401694dd doc/cephadm/install: edits
Based on review from Alexandra Settle <asettle@suse.com>

Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00
Sage Weil
ae944d6b5a doc/cephadm/adoption: improvements
Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00
Sage Weil
cfe8eb7f5c doc/cephadm/install: a few edits
Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00
Sage Weil
123eeaae07 doc/cephadm/install: do not install ceph-common on host (by default)
Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00
Sage Weil
26f3624498 doc/cephadm/install: revamp install docs
Signed-off-by: Sage Weil <sage@redhat.com>
2020-03-17 17:53:07 -05:00