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