From 7678c4a3144b8a01291777bbfdedc75fbcd942e1 Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Fri, 7 Jul 2017 16:31:52 -0400 Subject: [PATCH] doc/start: simplify quick start install process Signed-off-by: Sage Weil --- doc/start/quick-start-preflight.rst | 76 +++++++++++++---------------- 1 file changed, 33 insertions(+), 43 deletions(-) diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst index aea60bf12e7..f4b246e7ab2 100644 --- a/doc/start/quick-start-preflight.rst +++ b/doc/start/quick-start-preflight.rst @@ -2,23 +2,16 @@ Preflight Checklist ===================== -.. versionadded:: 0.60 - -Thank you for trying Ceph! We recommend setting up a ``ceph-deploy`` admin -:term:`node` and a 3-node :term:`Ceph Storage Cluster` to explore the basics of -Ceph. This **Preflight Checklist** will help you prepare a ``ceph-deploy`` -admin node and three Ceph Nodes (or virtual machines) that will host your Ceph -Storage Cluster. Before proceeding any further, see `OS Recommendations`_ to -verify that you have a supported distribution and version of Linux. When -you use a single Linux distribution and version across the cluster, it will -make it easier for you to troubleshoot issues that arise in production. +The ``ceph-deploy`` tool operates out of a directory on an admin +:term:`node`. Any host with network connectivity and a modern python +environment and ssh (such as Linux) should work. In the descriptions below, :term:`Node` refers to a single machine. .. include:: quick-common.rst -Ceph Deploy Setup +Ceph-deploy Setup ================= Add Ceph repositories to the ``ceph-deploy`` admin node. Then, install @@ -33,18 +26,23 @@ For Debian and Ubuntu distributions, perform the following steps: wget -q -O- 'https://download.ceph.com/keys/release.asc' | sudo apt-key add - -#. Add the Ceph packages to your repository. Replace ``{ceph-stable-release}`` - with a stable Ceph release (e.g., ``hammer``, ``jewel``, etc.) - For example:: +#. Add the Ceph packages to your repository:: + + echo deb https://download.ceph.com/debian/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + + The above URL contains the latest stable release of Ceph. If you + would like to select a specific release, use the command below and + replace ``{ceph-stable-release}`` with a stable Ceph release (e.g., + ``luminous``.) For example:: echo deb https://download.ceph.com/debian-{ceph-stable-release}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list #. Update your repository and install ``ceph-deploy``:: - sudo apt-get update && sudo apt-get install ceph-deploy + sudo apt update + sudo apt install ceph-deploy -.. note:: You can also use the EU mirror eu.ceph.com for downloading your packages. - Simply replace ``http://ceph.com/`` by ``http://eu.ceph.com/`` +.. note:: You can also use the EU mirror eu.ceph.com for downloading your packages by replacing ``https://ceph.com/`` by ``http://eu.ceph.com/`` RHEL/CentOS @@ -52,7 +50,9 @@ RHEL/CentOS For CentOS 7, perform the following steps: -#. On Red Hat Enterprise Linux 7, register the target machine with ``subscription-manager``, verify your subscriptions, and enable the "Extras" repository for package dependencies. For example:: +#. On Red Hat Enterprise Linux 7, register the target machine with + ``subscription-manager``, verify your subscriptions, and enable the + "Extras" repository for package dependencies. For example:: sudo subscription-manager repos --enable=rhel-7-server-extras-rpms @@ -63,35 +63,25 @@ For CentOS 7, perform the following steps: Please see the `EPEL wiki`_ page for more information. +#. Add the Ceph repository to your yum configuration file at ``/etc/yum.repos.d/ceph.repo`` with the following command:: -#. Add the package to your repository. Open a text editor and create a - Yellowdog Updater, Modified (YUM) entry. Use the file path - ``/etc/yum.repos.d/ceph.repo``. For example:: - - sudo vim /etc/yum.repos.d/ceph.repo - - Paste the following example code. Replace ``{ceph-release}`` with - the recent major release of Ceph (e.g., ``jewel``). Replace ``{distro}`` - with your Linux distribution (e.g., ``el7`` for CentOS 7). Finally, save the - contents to the - ``/etc/yum.repos.d/ceph.repo`` file. :: - - [ceph-noarch] - name=Ceph noarch packages - baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch - enabled=1 - gpgcheck=1 - type=rpm-md - gpgkey=https://download.ceph.com/keys/release.asc + cat >/etc/yum.repos.d/ceph.repro + [ceph-noarch] + name=Ceph noarch packages + baseurl=https://download.ceph.com/rpm/el7/noarch + enabled=1 + gpgcheck=1 + type=rpm-md + gpgkey=https://download.ceph.com/keys/release.asc + and then this *Control-D*. This will use the latest stable Ceph release. If you would like to install a different release, replace ``https://download.ceph.com/rpm/el7/noarch`` with ``https://download.ceph.com/rpm-{ceph-release}/el7/noarch`` where ``{ceph-release}`` is a release name like ``luminous``. #. Update your repository and install ``ceph-deploy``:: - sudo yum update && sudo yum install ceph-deploy - + sudo yum update + sudo yum install ceph-deploy -.. note:: You can also use the EU mirror eu.ceph.com for downloading your packages. - Simply replace ``http://ceph.com/`` by ``http://eu.ceph.com/`` +.. note:: You can also use the EU mirror eu.ceph.com for downloading your packages by replacing ``https://ceph.com/`` by ``http://eu.ceph.com/`` openSUSE @@ -137,7 +127,7 @@ On CentOS / RHEL, execute:: On Debian / Ubuntu, execute:: - sudo apt-get install ntp + sudo apt install ntp Ensure that you enable the NTP service. Ensure that each Ceph Node uses the same NTP time server. See `NTP`_ for details. @@ -150,7 +140,7 @@ For **ALL** Ceph Nodes perform the following steps: #. Install an SSH server (if necessary) on each Ceph Node:: - sudo apt-get install openssh-server + sudo apt install openssh-server or:: -- 2.39.5