From 482270a8d7b854fd2884c86503258f17bf001e24 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Sun, 15 Sep 2024 20:56:31 +1000 Subject: [PATCH] doc/install: add prompts to install-storage-cluster Add prompts to doc/install/install-storage-cluster.rst. Signed-off-by: Zac Dover --- doc/install/install-storage-cluster.rst | 90 ++++++++++++++----------- 1 file changed, 50 insertions(+), 40 deletions(-) diff --git a/doc/install/install-storage-cluster.rst b/doc/install/install-storage-cluster.rst index c86790239bb68..b35ba72263891 100644 --- a/doc/install/install-storage-cluster.rst +++ b/doc/install/install-storage-cluster.rst @@ -11,9 +11,11 @@ Installing with APT =================== Once you have added either release or development packages to APT, you should -update APT's database and install Ceph:: +update APT's database and install Ceph: - sudo apt-get update && sudo apt-get install ceph ceph-mds +.. prompt:: bash $ + + sudo apt-get update && sudo apt-get install ceph ceph-mds Installing with RPM @@ -22,63 +24,71 @@ Installing with RPM To install Ceph with RPMs, execute the following steps: -#. Install ``yum-plugin-priorities``. :: +#. Install ``yum-plugin-priorities``: + + .. prompt:: bash # - sudo yum install yum-plugin-priorities + sudo yum install yum-plugin-priorities #. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists. -#. Ensure ``priorities.conf`` enables the plugin. :: +#. Ensure ``priorities.conf`` enables the plugin:: - [main] - enabled = 1 + [main] + enabled = 1 #. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See `Get Packages`_ for details:: - [ceph] - name=Ceph packages for $basearch - baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch - enabled=1 - priority=2 - gpgcheck=1 - gpgkey=https://download.ceph.com/keys/release.asc - - [ceph-noarch] - name=Ceph noarch packages - baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch - enabled=1 - priority=2 - gpgcheck=1 - gpgkey=https://download.ceph.com/keys/release.asc - - [ceph-source] - name=Ceph source packages - baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS - enabled=0 - priority=2 - gpgcheck=1 - gpgkey=https://download.ceph.com/keys/release.asc - - -#. Install pre-requisite packages:: - - sudo yum install snappy gdisk python-argparse gperftools-libs + [ceph] + name=Ceph packages for $basearch + baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch + enabled=1 + priority=2 + gpgcheck=1 + gpgkey=https://download.ceph.com/keys/release.asc + + [ceph-noarch] + name=Ceph noarch packages + baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch + enabled=1 + priority=2 + gpgcheck=1 + gpgkey=https://download.ceph.com/keys/release.asc + + [ceph-source] + name=Ceph source packages + baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS + enabled=0 + priority=2 + gpgcheck=1 + gpgkey=https://download.ceph.com/keys/release.asc + + +#. Install pre-requisite packages: + + .. prompt:: bash $ + + sudo yum install snappy gdisk python-argparse gperftools-libs Once you have added either release or development packages, or added a -``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages. :: +``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages: - sudo yum install ceph +.. prompt:: bash $ + + sudo yum install ceph Installing a Build ================== -If you build Ceph from source code, you may install Ceph in user space -by executing the following:: +If you build Ceph from source code, you may install Ceph in user space by +executing the following: + +.. prompt:: bash $ - sudo ninja install + sudo ninja install If you install Ceph locally, ``ninja`` will place the executables in ``usr/local/bin``. You may add the Ceph configuration file to the