2012-03-14 18:58:27 +00:00
|
|
|
============================================
|
2011-09-07 17:23:39 +00:00
|
|
|
Ceph - a scalable distributed storage system
|
2012-04-11 19:33:57 +00:00
|
|
|
============================================
|
2007-03-15 23:23:52 +00:00
|
|
|
|
2012-06-16 21:50:29 +00:00
|
|
|
Please see http://ceph.com/ for current info.
|
2008-02-01 17:59:44 +00:00
|
|
|
|
2012-04-11 19:33:57 +00:00
|
|
|
Contributing Code
|
2012-03-14 18:58:27 +00:00
|
|
|
=================
|
2012-04-11 19:33:57 +00:00
|
|
|
|
|
|
|
Most of Ceph is licensed under the LGPL version 2.1. Some
|
|
|
|
miscellaneous code is under BSD-style license or is public domain.
|
|
|
|
The documentation is licensed under Creative Commons
|
|
|
|
Attribution-ShareAlike (CC BY-SA). There are a handful of headers
|
|
|
|
included here that are licensed under the GPL. Please see the file
|
|
|
|
COPYING for a full inventory of licenses by file.
|
|
|
|
|
|
|
|
Code contributions must include a valid "Signed-off-by" acknowledging
|
|
|
|
the license for the modified or contributed file. Please see the file
|
2016-01-20 05:28:36 +00:00
|
|
|
SubmittingPatches.rst for details on what that means and on how to
|
2012-04-11 19:33:57 +00:00
|
|
|
generate and submit patches.
|
|
|
|
|
|
|
|
We do not require assignment of copyright to contribute code; code is
|
|
|
|
contributed under the terms of the applicable license.
|
|
|
|
|
|
|
|
|
2016-06-16 17:44:35 +00:00
|
|
|
Checking out the source
|
|
|
|
=======================
|
|
|
|
|
|
|
|
You can clone from github with
|
|
|
|
|
|
|
|
git clone git@github.com:ceph/ceph
|
|
|
|
|
|
|
|
or, if you are not a github user,
|
|
|
|
|
|
|
|
git clone git://github.com/ceph/ceph
|
|
|
|
|
|
|
|
Ceph contains many git submodules that need to be checked out with
|
|
|
|
|
|
|
|
git submodule update --init --recursive
|
|
|
|
|
|
|
|
|
2014-08-05 18:48:38 +00:00
|
|
|
Build Prerequisites
|
|
|
|
===================
|
|
|
|
|
2015-06-03 21:25:23 +00:00
|
|
|
The list of Debian or RPM packages dependencies can be installed with:
|
2014-08-05 18:48:38 +00:00
|
|
|
|
2014-11-25 16:25:26 +00:00
|
|
|
./install-deps.sh
|
2014-08-05 18:48:38 +00:00
|
|
|
|
|
|
|
|
2012-04-11 19:33:57 +00:00
|
|
|
Building Ceph
|
2012-03-14 18:58:27 +00:00
|
|
|
=============
|
2012-04-05 18:43:11 +00:00
|
|
|
|
2015-08-04 16:45:52 +00:00
|
|
|
Autotools
|
|
|
|
---------
|
|
|
|
|
2014-08-06 15:16:21 +00:00
|
|
|
Developers, please refer to the [Developer
|
|
|
|
Guide](doc/dev/quick_guide.rst) for more information, otherwise, you
|
|
|
|
can build the server daemons, and FUSE client, by executing the
|
|
|
|
following:
|
2008-05-07 21:32:55 +00:00
|
|
|
|
2014-05-21 04:55:18 +00:00
|
|
|
./autogen.sh
|
|
|
|
./configure
|
|
|
|
make
|
2008-05-07 21:32:55 +00:00
|
|
|
|
|
|
|
(Note that the FUSE client will only be built if libfuse is present.)
|
|
|
|
|
2015-08-04 16:45:52 +00:00
|
|
|
CMake
|
|
|
|
-----
|
|
|
|
|
|
|
|
Prerequisite:
|
|
|
|
CMake 2.8.11
|
|
|
|
|
|
|
|
Build instructions:
|
|
|
|
|
|
|
|
mkdir build
|
|
|
|
cd build
|
2016-06-16 17:47:12 +00:00
|
|
|
cmake [options] ..
|
2015-08-04 16:45:52 +00:00
|
|
|
make
|
|
|
|
|
2016-06-16 17:47:12 +00:00
|
|
|
This assumes you make your build dir a subdirectory of the ceph.git
|
|
|
|
checkout. If you put it elsewhere, just replace .. above with a
|
|
|
|
correct path to the checkout.
|
|
|
|
|
2015-08-04 16:45:52 +00:00
|
|
|
|
2012-04-11 19:33:57 +00:00
|
|
|
Dependencies
|
|
|
|
------------
|
|
|
|
|
|
|
|
The configure script will complain about any missing dependencies as
|
|
|
|
it goes. You can also refer to debian/control or ceph.spec.in for the
|
|
|
|
package build dependencies on those platforms. In many cases,
|
|
|
|
dependencies can be avoided with --with-foo or --without-bar switches.
|
|
|
|
For example,
|
|
|
|
|
2014-05-21 04:55:18 +00:00
|
|
|
./configure --with-nss # use libnss instead of libcrypto++
|
|
|
|
./configure --without-radosgw # do not build radosgw
|
|
|
|
./configure --without-tcmalloc # avoid google-perftools dependency
|
2012-04-11 19:33:57 +00:00
|
|
|
|
|
|
|
|
|
|
|
Building packages
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
You can build packages for Debian or Debian-derived (e.g., Ubuntu)
|
|
|
|
systems with
|
2008-03-18 16:31:04 +00:00
|
|
|
|
2014-05-21 04:55:18 +00:00
|
|
|
sudo apt-get install dpkg-dev
|
|
|
|
dpkg-checkbuilddeps # make sure we have all dependencies
|
|
|
|
dpkg-buildpackage
|
2008-03-18 16:31:04 +00:00
|
|
|
|
2014-05-21 04:55:18 +00:00
|
|
|
For RPM-based systems (Red Hat, SUSE, etc.),
|
2008-05-13 15:45:13 +00:00
|
|
|
|
2014-05-21 04:55:18 +00:00
|
|
|
rpmbuild
|
2012-03-14 18:58:27 +00:00
|
|
|
|
2016-06-16 17:55:11 +00:00
|
|
|
|
|
|
|
Running a test cluster
|
|
|
|
======================
|
|
|
|
|
|
|
|
Autotools
|
|
|
|
---------
|
|
|
|
|
|
|
|
To run a functional test cluster,
|
|
|
|
|
|
|
|
cd src
|
|
|
|
./vstart.sh -d -n -x -l
|
|
|
|
./ceph -s
|
|
|
|
|
|
|
|
Almost all of the usual commands are available in the src/ directory.
|
|
|
|
For example,
|
|
|
|
|
|
|
|
./rados -p rbd bench 30 write
|
|
|
|
./rbd create foo --size 1000
|
|
|
|
|
|
|
|
To shut down the test cluster,
|
|
|
|
|
|
|
|
./stop.sh
|
|
|
|
|
|
|
|
To start or stop individual daemons, the sysvinit script should work:
|
|
|
|
|
|
|
|
./init-ceph restart osd.0
|
|
|
|
./init-ceph stop
|
|
|
|
|
|
|
|
CMake
|
|
|
|
-----
|
|
|
|
|
|
|
|
???
|
|
|
|
|
|
|
|
|
2016-06-15 20:54:53 +00:00
|
|
|
Running unit tests
|
|
|
|
==================
|
|
|
|
|
|
|
|
Autotools
|
|
|
|
---------
|
|
|
|
|
|
|
|
To run all tests, a simple
|
|
|
|
|
|
|
|
cd src
|
|
|
|
make check
|
|
|
|
|
2016-06-16 18:18:12 +00:00
|
|
|
will suffice. Each test generates a log file that is the name of the
|
|
|
|
test with .log appended. For example, unittest_addrs generates a
|
|
|
|
unittest_addrs.log and test/osd/osd-config.sh puts its output in
|
|
|
|
test/osd/osd-config.sh.log.
|
2016-06-15 20:54:53 +00:00
|
|
|
|
|
|
|
To run an individual test manually, you may want to clean up with
|
|
|
|
|
|
|
|
rm -rf testdir /tmp/*virtualenv
|
|
|
|
./stop.sh
|
|
|
|
|
|
|
|
and then run a given test like so:
|
|
|
|
|
|
|
|
./unittest_addrs
|
|
|
|
|
|
|
|
Many tests are bash scripts that spin up small test clusters, and must be run
|
|
|
|
like so:
|
|
|
|
|
|
|
|
CEPH_DIR=. test/osd/osd-bench.sh # or whatever the test is
|
|
|
|
|
|
|
|
CMake
|
|
|
|
-----
|
|
|
|
|
|
|
|
???
|
|
|
|
|
2016-06-16 17:55:11 +00:00
|
|
|
|
2012-03-14 18:58:27 +00:00
|
|
|
Building the Documentation
|
|
|
|
==========================
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
-------------
|
|
|
|
|
2014-08-06 15:16:21 +00:00
|
|
|
The list of package dependencies for building the documentation can be
|
|
|
|
found in doc_deps.deb.txt:
|
2012-03-14 18:58:27 +00:00
|
|
|
|
2014-05-21 04:56:05 +00:00
|
|
|
sudo apt-get install `cat doc_deps.deb.txt`
|
2012-03-14 18:58:27 +00:00
|
|
|
|
|
|
|
Building the Documentation
|
|
|
|
--------------------------
|
|
|
|
|
2014-08-06 15:16:21 +00:00
|
|
|
To build the documentation, ensure that you are in the top-level
|
|
|
|
`/ceph directory, and execute the build script. For example:
|
2012-03-14 18:58:27 +00:00
|
|
|
|
2014-05-21 04:56:05 +00:00
|
|
|
admin/build-doc
|
2013-11-26 15:14:22 +00:00
|
|
|
|