Report a Documentation Bug

Installation (Manual)

Get Software

There are several methods for getting Ceph software. The easiest and most common method is to get packages by adding repositories for use with package management tools such as the Advanced Package Tool (APT) or Yellowdog Updater, Modified (YUM). You may also retrieve pre-compiled packages from the Ceph repository. Finally, you can retrieve tarballs or clone the Ceph source code repository and build Ceph yourself.

• Get Packages
• Get Tarballs
• Clone Source
• Build Ceph
• Ceph Mirrors
• Ceph Containers

Install Software

Once you have the Ceph software (or added repositories), installing the software is easy. To install packages on each Ceph Node in your cluster. You may use cephadm to install Ceph for your storage cluster, or use package management tools. You should install Yum Priorities for RHEL/CentOS and other distributions that use Yum if you intend to install the Ceph Object Gateway or QEMU.

• Install cephadm
• Install Ceph Storage Cluster
• Install Virtualization for Block

Deploy a Cluster Manually

Once you have Ceph installed on your nodes, you can deploy a cluster manually. The manual procedure is primarily for exemplary purposes for those developing deployment scripts with Chef, Juju, Puppet, etc.

• Manual Deployment
  • Monitor Bootstrapping
  • Manager daemon configuration
  • Adding OSDs
    • Short Form
      • bluestore
      • filestore
    • Long Form
  • Adding MDS
  • Summary
• Manual Deployment on FreeBSD
  • Disklayout on FreeBSD
    • Configuration
  • Monitor Bootstrapping
  • Adding OSDs
    • Long Form
  • Adding MDS
  • Summary

Upgrade Software

As new versions of Ceph become available, you may upgrade your cluster to take advantage of new functionality. Read the upgrade documentation before you upgrade your cluster. Sometimes upgrading Ceph requires you to follow an upgrade sequence.