Build Ceph

You can get Ceph software by retrieving Ceph source code and building it yourself. To build Ceph, you need to set up a development environment, compile Ceph, and then either install in user space or build packages and install the packages.

Build Prerequisites

Tip

Check this section to see if there are specific prerequisites for your Linux/Unix distribution.

Before you can build Ceph source code, you need to install several libraries and tools. Ceph provides autoconf and automake scripts to get you started quickly. Ceph build scripts depend on the following:

• autotools-dev
• autoconf
• automake
• cdbs
• gcc
• g++
• git
• libboost-dev
• libedit-dev
• libssl-dev
• libtool
• libfcgi
• libfcgi-dev
• libfuse-dev
• linux-kernel-headers
• libcrypto++-dev
• libcrypto++
• libexpat1-dev
• pkg-config
• libcurl4-gnutls-dev

On Ubuntu, execute sudo apt-get install for each dependency that isn’t installed on your host.

sudo apt-get install autotools-dev autoconf automake cdbs gcc g++ git libboost-dev libedit-dev libssl-dev libtool libfcgi libfcgi-dev libfuse-dev linux-kernel-headers libcrypto++-dev libcrypto++ libexpat1-dev pkg-config

On Debian/Squeeze, execute aptitude install for each dependency that isn’t installed on your host.

aptitude install autotools-dev autoconf automake cdbs gcc g++ git libboost-dev libedit-dev libssl-dev libtool libfcgi libfcgi-dev libfuse-dev linux-kernel-headers libcrypto++-dev libcrypto++ libexpat1-dev pkg-config libcurl4-gnutls-dev

On Debian/Wheezy, you may also need:

libkeyutils-dev libaio-dev libboost-thread-dev

Note

Some distributions that support Google’s memory profiler tool may use a different package name (e.g., libgoogle-perftools4).

Ubuntu

• uuid-dev
• libkeyutils-dev
• libgoogle-perftools-dev
• libatomic-ops-dev
• libaio-dev
• libgdata-common
• libgdata13
• libsnappy-dev
• libleveldb-dev

Execute sudo apt-get install for each dependency that isn’t installed on your host.

sudo apt-get install uuid-dev libkeyutils-dev libgoogle-perftools-dev libatomic-ops-dev libaio-dev libgdata-common libgdata13 libsnappy-dev libleveldb-dev

Debian

Alternatively, you may also install:

aptitude install fakeroot dpkg-dev
aptitude install debhelper cdbs libexpat1-dev libatomic-ops-dev

openSUSE 11.2 (and later)

• boost-devel
• gcc-c++
• libedit-devel
• libopenssl-devel
• fuse-devel (optional)

Execute zypper install for each dependency that isn’t installed on your host.

zypper install boost-devel gcc-c++ libedit-devel libopenssl-devel fuse-devel

Build Ceph

Ceph provides automake and configure scripts to streamline the build process. To build Ceph, navigate to your cloned Ceph repository and execute the following:

cd ceph
./autogen.sh
./configure
make

Hyperthreading

You can use make -j to execute multiple jobs depending upon your system. For example, make -j4 for a dual core processor may build faster.

See Installing a Build to install a build in user space.

Build Ceph Packages

To build packages, you must clone the Ceph repository. You can create installation packages from the latest code using dpkg-buildpackage for Debian/Ubuntu or rpmbuild for the RPM Package Manager.

Tip

When building on a multi-core CPU, use the -j and the number of cores * 2. For example, use -j4 for a dual-core processor to accelerate the build.

Advanced Package Tool (APT)

To create .deb packages for Debian/Ubuntu, ensure that you have cloned the Ceph repository, installed the Build Prerequisites and installed debhelper:

sudo apt-get install debhelper

Once you have installed debhelper, you can build the packages:

sudo dpkg-buildpackage

For multi-processor CPUs use the -j option to accelerate the build.

RPM Package Manager

To create .rpm packages, ensure that you have cloned the Ceph repository, installed the Build Prerequisites and installed rpm-build and rpmdevtools:

yum install rpm-build rpmdevtools

Once you have installed the tools, setup an RPM compilation environment:

rpmdev-setuptree

Fetch the source tarball for the RPM compilation environment:

wget -P ~/rpmbuild/SOURCES/ http://ceph.com/download/ceph-<version>.tar.gz

Or from the EU mirror:

wget -P ~/rpmbuild/SOURCES/ http://eu.ceph.com/download/ceph-<version>.tar.gz

Build the RPM packages:

rpmbuild -tb ~/rpmbuild/SOURCES/ceph-<version>.tar.gz

For multi-processor CPUs use the -j option to accelerate the build.