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
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
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
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
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.
#. Install an SSH server (if necessary) on each Ceph Node::
- sudo apt-get install openssh-server
+ sudo apt install openssh-server
or::