RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-02-20 09:27:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc/start: simplify quick start install process

Browse Source 
Signed-off-by: Sage Weil <sage@redhat.com>
This commit is contained in:
Sage Weil 2017-07-07 16:31:52 -04:00
parent 7cfc79c862
commit 7678c4a314
1 changed files with 33 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
doc/start/quick-start-preflight.rst
View File

@ -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::