Install Ceph Storage Cluster

This guide describes installing Ceph packages manually. This procedureis only for users who are not installing with a deployment tool such asceph-deploy, chef, juju, etc.

Tip

You can also use ceph-deploy to install Ceph packages, which maybe more convenient since you can install ceph on multiple hosts witha single command.

Installing with APT

Once you have added either release or development packages to APT, you shouldupdate APT’s database and install Ceph:

  1. sudo apt-get update && sudo apt-get install ceph ceph-mds

Installing with RPM

To install Ceph with RPMs, execute the following steps:

  • Install yum-plugin-priorities.
  1. sudo yum install yum-plugin-priorities

  • Ensure /etc/yum/pluginconf.d/priorities.conf exists.

  • Ensure priorities.conf enables the plugin.

  1. [main]
  2. enabled = 1
  • Ensure your YUM ceph.repo entry includes priority=2. SeeGet Packages for details:
  1. [ceph]
  2. name=Ceph packages for $basearch
  3. baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
  4. enabled=1
  5. priority=2
  6. gpgcheck=1
  7. gpgkey=https://download.ceph.com/keys/release.asc
  8.  
  9. [ceph-noarch]
  10. name=Ceph noarch packages
  11. baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
  12. enabled=1
  13. priority=2
  14. gpgcheck=1
  15. gpgkey=https://download.ceph.com/keys/release.asc
  16.  
  17. [ceph-source]
  18. name=Ceph source packages
  19. baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
  20. enabled=0
  21. priority=2
  22. gpgcheck=1
  23. gpgkey=https://download.ceph.com/keys/release.asc
  • Install pre-requisite packages:
  1. sudo yum install snappy leveldb gdisk python-argparse gperftools-libs

Once you have added either release or development packages, or added aceph.repo file to /etc/yum.repos.d, you can install Ceph packages.

  1. sudo yum install ceph

Installing a Build

If you build Ceph from source code, you may install Ceph in user spaceby executing the following:

  1. sudo make install

If you install Ceph locally, make will place the executables inusr/local/bin. You may add the Ceph configuration file to theusr/local/bin directory to run Ceph from a single directory.