Ceph/Installation

All necessary Ceph software is available through the package. It contains all services as well as basic administration utilities for managing a Ceph cluster.

Design
Before embarking on a Ceph deployment scenario, take the time to make a basic Ceph cluster design.

What is the purpose of the Ceph cluster? Is it to play around and experiment with Ceph? Is it to host all critical data in form of rbd devices? Is it to create a highly available file server?

What features are needed on the Ceph cluster? How many monitors are likely to be needed? How much storage will be used, and how will this storage be represented (as in, how many OSDs will be available and where will they run)? Will the cluster provide S3- or Swift-like APIs to the outside world?

What are the IP addresses that will be used by the cluster? Ceph requires a static IP environment, so making a well designed network infrastructure is important for Ceph to function properly.

How will the servers be distributed across the environment? Ceph has a number of buckets that it can use to differentiate servers and make well-thought-through distribution and replication decisions. The default is an OSD on a host in a rack in a row in a room inside a data center.

There are a number of best practices to account for through:


 * Most clusters require 3 monitor servers, perhaps 5. Clusters generally do not need more than 5 monitor servers to function in even the harshest environments.
 * Distribute the monitor servers across the environment. If the cluster is over a couple of racks, make sure that the monitor servers are distributed across the racks as well.
 * There is usually no need for RAID on the file system that an OSD uses. Instead, rely on the Ceph availability and distribution.
 * OSD services do not need a lot of CPU or RAM. A metadata server however does benefit from high-speed CPU and lots of memory.

System configuration
The first configuration to decide on is which Ceph version to deploy. At the time of writing, Ceph version 0.87 ("Giant") is available in the tree in ~arch while version 0.80 ("Firefly") is available as stable release. To use the ~arch version, add to :

Next, validate that the Linux kernel is configured to support Ceph.

Installation
With the system configuration done, install the Ceph software.

The following USE flags are available for fine-tuning the installation.

With the USE flags defined, install the software:

Cluster creation
Use uuidgen to generate a cluster id.

Create the basic skeleton for the file, and use the generated id for the   parameter.

In this example, a cluster is used with a replication factor of 2 (which means it is replicated once - there are two instances of each block) and a minimum of 1 (i.e. as long as one copy of the data is available, continue).

Next create the administrative key. The default administrative key is called client.admin:

Monitors
To create the monitors, first add in the information to the file:

{{FileBox|filename=/etc/ceph/ceph.conf|title=Snippet for monitors}lang=ini|1= [mon] # Global settings for monitors mon host = host1, host2, host3 mon addr = 192.168.100.10:6789, 192.168.100.11:6789, 192.168.100.12:6789 mon initial members = 0, 1, 2

[mon.0] host = host1 mon addr = 192.168.100.10:6789

[mon.1] host = host2 mon addr = 192.168.100.11:6789

[mon.2] host = host3 mon addr = 192.168.100.12:6789 }}

Next create the keyring for the monitor (so that the Ceph monitors can integrate and interact with the Ceph cluster) and add the administrative keyring to it:

Now create the initial monitor map (which is a binary file that the Ceph monitors use to find the default, initial monitor list).

Create the file system that the monitors will use to keep their information in.

Repeat this step on each system for the right id ( becomes   etc.)

Finally, create the init script to launch the monitor at boot:

Also repeat this on each system for the right id.