src/ceph/doc/install/install-storage-cluster.rst

   1 ==============================
   2  Install Ceph Storage Cluster
   3 ==============================
   4
   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.
   8
   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
  11    a single command.
  12
  13
  14 Installing with APT
  15 ===================
  16
  17 Once you have added either release or development packages to APT, you should
  18 update APT's database and install Ceph::
  19
  20         sudo apt-get update && sudo apt-get install ceph ceph-mds
  21
  22
  23 Installing with RPM
  24 ===================
  25
  26 To install Ceph with RPMs, execute the following steps:
  27
  28
  29 #. Install ``yum-plugin-priorities``. ::
  30
  31         sudo yum install yum-plugin-priorities
  32
  33 #. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists.
  34
  35 #. Ensure ``priorities.conf`` enables the plugin. ::
  36
  37         [main]
  38         enabled = 1
  39
  40 #. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See
  41    `Get Packages`_ for details::
  42
  43         [ceph]
  44         name=Ceph packages for $basearch
  45         baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
  46         enabled=1
  47         priority=2
  48         gpgcheck=1
  49         gpgkey=https://download.ceph.com/keys/release.asc
  50
  51         [ceph-noarch]
  52         name=Ceph noarch packages
  53         baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
  54         enabled=1
  55         priority=2
  56         gpgcheck=1
  57         gpgkey=https://download.ceph.com/keys/release.asc
  58
  59         [ceph-source]
  60         name=Ceph source packages
  61         baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
  62         enabled=0
  63         priority=2
  64         gpgcheck=1
  65         gpgkey=https://download.ceph.com/keys/release.asc
  66
  67
  68 #. Install pre-requisite packages::
  69
  70         sudo yum install snappy leveldb gdisk python-argparse gperftools-libs
  71
  72
  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. ::
  75
  76         sudo yum install ceph
  77
  78
  79 Installing a Build
  80 ==================
  81
  82 If you build Ceph from source code, you may install Ceph in user space
  83 by executing the following::
  84
  85         sudo make install
  86
  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.
  90
  91 .. _Get Packages: ../get-packages