]> git.apps.os.sepia.ceph.com Git - ceph.git/commit
doc: update the cephadm download instructions 51846/head
authorJohn Mulligan <jmulligan@redhat.com>
Mon, 19 Sep 2022 17:46:48 +0000 (13:46 -0400)
committerZac Dover <zac.dover@proton.me>
Wed, 31 May 2023 12:54:03 +0000 (20:54 +0800)
commit047dc04f0fd501f0a39d5ea87eee645a4ec890bb
treec742ae72175521c6b94dbbdebfdd2d44bb7eda6c
parent5a28d0490e98920454052c17dafbdd94d6b75e0a
doc: update the cephadm download instructions

Starting with reef, cephadm is a compiled (zipapp) python application.
The cephadm script has been renamed and thus the old curl-based
download instructions will no longer work. While cephadm still has
no dependencies outside the Python stdlib, this will be changed in
future versions so it is no longer appropriate to just download the
source file of cephadm and run it either.

This change updates the `Install cephadm` section of the doc to explain
how to acquire a "compiled" version of cephadm as well as:
* moving and tweaking the note that the two installation methods are
  distinct
* adding a new note linking to instructions on building cephadm
* moving the distribution-specific installations before the curl-based
  installation to subtly hint that we prefer you to get it using
  packages if you can
* Noting cephadm's minimal required python verision and how to run it
  with a particular python version.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
(cherry picked from commit d11cf0e82aab8d4cef9d423e5d463a373eaf383a)

doc: make instructions to get an updated cephadm common

As discussed in person and over the ceph orch weekly, we want all users
to use a recent supported version of cephadm. Previously, the
instructions only had those downloading cephadm with curl using the
"add-repo" and "install" commands to get a up-to-date cephadm build.
According to ADK we've seen cases of users get "old" distro packages
in the past. Change the instructions so that the "update cephadm" steps
are common after acquiring a "bootstrap copy" of cephadm.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
(cherry picked from commit d7921e88d69b4bc355da9c0327cc33e59e7d7abb)
(cherry picked from commit 8a835f1a91cfc07e39f68cf3b1b56251e6e85941)
doc/cephadm/install.rst