Merge pull request ceph#60805 from zdover23/wip-doc-2024-11-23-cephadm-install-curl-based-installation

doc/cephadm: Improve "Curl-based Installation"

:Reviewd-by: Anthony D'Atri <[email protected]>

Author: zdover23

doc/cephadm/install.rst

@@ -95,67 +95,80 @@ that case, you can install cephadm directly. For example:
 
 .. _cephadm_install_curl:
 
-curl-based installation
------------------------
+Using curl to install cephadm 
+-----------------------------
 
-* First, determine what version of Ceph you wish to install. You can use the releases
-  page to find the `latest active releases <https://docs.ceph.com/en/latest/releases/#active-releases>`_.
-  For example, we might find that ``18.2.1`` is the latest
-  active release.
+#. Determine which version of Ceph you will install. Use the releases page to
+   find the `latest active releases
+   <https://docs.ceph.com/en/latest/releases/#active-releases>`_.  For example,
+   you might find that ``18.2.1`` is the latest active release.
 
-* Use ``curl`` to fetch a build of cephadm for that release.
+#. Use ``curl`` to fetch a build of cephadm for that release.
 
-  .. prompt:: bash #
-     :substitutions:
+   .. prompt:: bash #
+      :substitutions:
 
-     CEPH_RELEASE=18.2.0 # replace this with the active release
-     curl --silent --remote-name --location https://download.ceph.com/rpm-${CEPH_RELEASE}/el9/noarch/cephadm
+      CEPH_RELEASE=18.2.0 # replace this with the active release
+      curl --silent --remote-name --location https://download.ceph.com/rpm-${CEPH_RELEASE}/el9/noarch/cephadm
 
-  Ensure the ``cephadm`` file is executable:
+#.  Use ``chmod`` to make the ``cephadm`` file executable:
 
-  .. prompt:: bash #
+   .. prompt:: bash #
 
-   chmod +x cephadm
+    chmod +x cephadm
 
-  This file can be run directly from the current directory:
+   After ``chmod`` has been run on cephadm, it can be run from the current
+   directory:
 
-  .. prompt:: bash #
+   .. prompt:: bash #
+
+    ./cephadm <arguments...>
 
-   ./cephadm <arguments...>
+cephadm Requires Python 3.6 or Later
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-* If you encounter any issues with running cephadm due to errors including
-  the message ``bad interpreter``, then you may not have Python or
-  the correct version of Python installed. The cephadm tool requires Python 3.6
-  or later. You can manually run cephadm with a particular version of Python by
-  prefixing the command with your installed Python version. For example:
+* ``cephadm`` requires Python 3.6 or later. If you encounter difficulties
+  running ``cephadm``, then you may not have Python or the correct version of
+  Python installed. This includes any errors that include the message ``bad
+  interpreter``. 
+  
+  You can manually run cephadm with a particular version of Python by prefixing
+  the command with your installed Python version. For example:
 
   .. prompt:: bash #
-     :substitutions:
 
      python3.8 ./cephadm <arguments...>
 
-* Although the standalone cephadm is sufficient to bootstrap a cluster, it is
-  best to have the ``cephadm`` command installed on the host.  To install
-  the packages that provide the ``cephadm`` command, run the following
-  commands:
+Installing cephadm on the Host
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-  .. prompt:: bash #
-     :substitutions:
+Although the standalone ``cephadm`` is sufficient to bootstrap a cluster, it is
+best to have the ``cephadm`` command installed on the host. To install the
+packages that provide the ``cephadm`` command, run the following commands:
 
-     ./cephadm add-repo --release |stable-release|
-     ./cephadm install
+#. Add the repository:
 
-  Confirm that ``cephadm`` is now in your PATH by running ``which``:
+   .. prompt:: bash #
 
-  .. prompt:: bash #
+      ./cephadm add-repo --release |stable-release|
+
+#. Run ``cephadm install``:
+
+   .. prompt:: bash #
+
+      ./cephadm install
+
+#. Confirm that ``cephadm`` is now in your PATH by running ``which``:
+
+   .. prompt:: bash #
 
-    which cephadm
+      which cephadm
 
-  A successful ``which cephadm`` command will return this:
+   A successful ``which cephadm`` command will return this:
 
-  .. code-block:: bash
+   .. code-block:: bash
 
-    /usr/sbin/cephadm
+     /usr/sbin/cephadm
 
 Bootstrap a new cluster
 =======================