1 ==============================
2 Install Ceph Storage Cluster
3 ==============================
5 This guide describes installing Ceph packages manually. This procedure
6 is only for users who are not installing with a deployment tool such as
7 ``ceph-deploy``, ``chef``, ``juju``, etc.
9 .. tip:: You can also use ``ceph-deploy`` to install Ceph packages, which may
10 be more convenient since you can install ``ceph`` on multiple hosts with
17 Once you have added either release or development packages to APT, you should
18 update APT's database and install Ceph::
20 sudo apt-get update && sudo apt-get install ceph ceph-mds
26 To install Ceph with RPMs, execute the following steps:
29 #. Install ``yum-plugin-priorities``. ::
31 sudo yum install yum-plugin-priorities
33 #. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists.
35 #. Ensure ``priorities.conf`` enables the plugin. ::
40 #. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See
41 `Get Packages`_ for details::
44 name=Ceph packages for $basearch
45 baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
49 gpgkey=https://download.ceph.com/keys/release.asc
52 name=Ceph noarch packages
53 baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
57 gpgkey=https://download.ceph.com/keys/release.asc
60 name=Ceph source packages
61 baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
65 gpgkey=https://download.ceph.com/keys/release.asc
68 #. Install pre-requisite packages::
70 sudo yum install snappy leveldb gdisk python-argparse gperftools-libs
73 Once you have added either release or development packages, or added a
74 ``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages. ::
82 If you build Ceph from source code, you may install Ceph in user space
83 by executing the following::
87 If you install Ceph locally, ``make`` will place the executables in
88 ``usr/local/bin``. You may add the Ceph configuration file to the
89 ``usr/local/bin`` directory to run Ceph from a single directory.
91 .. _Get Packages: ../get-packages