ceph/doc/start/quick-start.rst

======================
 5-minute Quick Start
======================

Thank you for trying Ceph! Petabyte-scale data clusters are quite an 
undertaking. Before delving deeper into Ceph, we recommend setting up a
cluster on a single host to explore some of the functionality. 

Ceph **5-Minute Quick Start** is intended for use on one machine with a 
recent Debian/Ubuntu operating system. The intent is to help you exercise 
Ceph functionality without the deployment overhead associated with a 
production-ready storage cluster.

.. important:: Once you have your cluster running, mount block devices and filesystems using a separate host.

Install Debian/Ubuntu
=====================

Install a recent release of Debian or Ubuntu (e.g., 12.04 precise). 

Add Ceph Packages
=================

To get the latest Ceph packages, add a release key to APT, add a source
location to your ``/etc/apt/sources.list``, update your system and 
install Ceph. :: 

	wget -q -O- https://raw.github.com/ceph/ceph/master/keys/release.asc | sudo apt-key add -	
	echo deb http://ceph.com/debian/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list
	sudo apt-get update && sudo apt-get install ceph
	
Add a Configuration File
========================

Execute ``hostname -s`` on the command line to retrieve the name of your 
host. Then, replace ``{hostname}`` in the sample configuration file
with your host name. Execute ``ifconfig`` on the command line to
retrieve the IP address of your host. Then, replace ``{ip-address}``
with the IP address of your host. Finally, copy the contents of the 
modified configuration file and save it to ``/etc/ceph/ceph.conf``. 
This file will configure Ceph to operate a monitor,  two OSD daemons 
and one metadata server on your local machine. 

.. literalinclude:: ceph.conf
   :language: ini
   
Deploy the Configuration
========================

To deploy the configuration, create a directory for each daemon as follows::

	sudo mkdir /var/lib/ceph/osd/ceph-0
	sudo mkdir /var/lib/ceph/osd/ceph-1
	sudo mkdir /var/lib/ceph/mon/ceph-a
	sudo mkdir /var/lib/ceph/mds/ceph-a

	cd /etc/ceph
	sudo mkcephfs -a -c /etc/ceph/ceph.conf -k ceph.keyring

Start the Ceph Cluster
======================

Once you have deployed the configuration, start the Ceph cluster. :: 

	sudo service ceph start
	
Check the health of your Ceph cluster to ensure it is ready. :: 

	ceph health
	
If your cluster echoes back ``HEALTH_OK``, you may begin using your cluster.