Ceph is a distributed object, block, and file storage platform
Go to file
Abhishek Lekshmanan c2e4106bbf doc: rgw multisite documentation
Adding basic documentation for new multisite features, with an example
showing 3 zones in a zonegroup.

Fixes: http://tracker.ceph.com/issues/15247
Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>
2016-04-15 22:25:55 +02:00
admin pybind: move cephfs to Cython 2016-02-29 10:58:52 +01:00
bin make_dist.sh: rename from bin/make_dist_tarball.sh 2015-05-31 17:58:49 -04:00
ceph-erasure-code-corpus@c332279082 submodules: revert an accidental change 2016-03-04 06:54:49 -08:00
ceph-object-corpus@47fbf8c6ae Drop deprecated removal pg type. 2015-12-18 14:47:25 +01:00
cmake/modules cmake: ceph_objectstore_tool.py test passing 2016-04-14 20:48:21 -04:00
debian 10.1.2 2016-04-12 17:42:56 +00:00
doc doc: rgw multisite documentation 2016-04-15 22:25:55 +02:00
etc set 128MB tcmalloc cache size by bytes 2016-04-04 13:41:52 +08:00
examples Fix Makefile in example/librados file. 2015-10-19 23:53:27 -07:00
fusetrace
keys new release key 2015-09-17 12:28:25 -04:00
m4 crc32c: add aarch64 optimized crc32c implementation 2015-03-17 13:56:52 -05:00
man cmake: conditionally install man pages 2016-03-26 00:03:19 +08:00
mirroring mirrors: Change contact e-mail address for se.ceph.com 2016-03-09 22:42:15 +01:00
qa cmake: cephtool-test-rados/mds/osd passing in cmake 2016-04-14 20:48:21 -04:00
rpm Move fedora patch file (used by ceph.spec.in) to rpm/ subdir 2014-08-27 12:56:43 -07:00
selinux selinux: Allow to manage locks 2016-03-08 10:59:38 +01:00
share CodingStyle: Fix coding-style on PG related Monitor files 2015-12-10 00:11:47 +01:00
src Merge pull request #7912 from ceph/wip-cmake-make-check 2016-04-15 12:21:29 -04:00
systemd systemd: Use the same restart limits as upstart 2016-04-13 21:26:31 +02:00
udev ceph-disk: implement lockbox key management 2016-03-04 09:13:35 +07:00
.gitignore gitignore: ignore backup files from editors etc. 2016-01-27 23:23:18 +01:00
.gitmodule_mirrors remove libs3 submodule 2015-07-30 13:24:00 -04:00
.gitmodules .gitmodules: use github.com/ceph/xxHash clone 2016-03-08 16:04:31 -05:00
.mailmap mailmap: Abhishek Lekshmanan affiliation 2016-04-15 17:09:55 +02:00
.organizationmap mailmap: Wei Qiaomiao affiliation 2016-04-15 17:45:22 +05:30
.peoplemap mailmap: Abhishek Lekshmanan affiliation 2016-02-08 22:00:10 +01:00
AUTHORS AUTHORS: update email 2016-03-01 13:07:46 -08:00
autogen.sh rocksdb: build rocksdb with its own Makefile 2015-10-17 15:56:18 -04:00
ceph.spec.in Merge pull request #7857 from tchaikov/wip-14844 2016-03-30 14:47:34 +08:00
ChangeLog
CMakeLists.txt cmake: test-ceph-helpers working 2016-04-14 20:48:19 -04:00
CodingStyle CodingStyle: fix broken URLs 2015-11-30 21:12:37 +08:00
configure.ac 10.1.2 2016-04-12 17:42:56 +00:00
CONTRIBUTING.rst doc: rename SubmittingPatches to SubmittingPatches.rst 2016-01-20 13:28:38 +08:00
COPYING SIGPIPE suppression for platforms without SO_NOSIGPIPE or MSG_NOSIGNAL 2015-11-13 08:18:35 -08:00
COPYING-GPL2 Add GPLv2 text file 2015-02-27 10:43:26 -07:00
COPYING-LGPL2.1
do_autogen.sh tools: fix do_autogen.sh -R 2015-09-02 16:03:15 +02:00
doc_deps.deb.txt doc: fix dependencies 2016-04-13 19:31:16 +00:00
Doxyfile doc: do not doxygen src/tracing 2015-02-23 16:26:27 +01:00
INSTALL doc: INSTALL redirect to online documentation 2015-12-01 14:44:02 +01:00
install-deps.sh build/ops: enable CR in CentOS 7 2015-12-08 08:25:24 +01:00
make_dist.sh make_dist.sh: bz2 only 2015-06-01 11:20:03 -07:00
make-debs.sh remove rest-bench 2015-07-30 13:21:36 -04:00
Makefile.am freebsd: use sysctl instead of nproc 2016-03-09 07:50:43 +00:00
NEWS
PendingReleaseNotes doc/release-notes: v10.1.0 draft jewel notes 2016-03-18 14:22:04 -04:00
pom.xml update license for libcephfs 2014-08-26 15:52:37 -04:00
README
README.aix aix shared library build 2015-11-25 18:30:31 -05:00
README.cmake Combined CMake Build for Hammer 2015-01-14 16:40:05 -05:00
README.md doc: rename SubmittingPatches to SubmittingPatches.rst 2016-01-20 13:28:38 +08:00
README.solaris aix gcc librados port 2015-11-23 00:03:16 -05:00
README.xio xio: Update README.xio with dependencies 2015-03-17 05:13:57 -07:00
run-cmake-check.sh cmake: no need to run configure from run-cmake-check.sh 2015-12-17 14:03:15 +01:00
run-make-check.sh tests: configure with rocksdb by default 2016-01-04 17:51:12 +01:00
SubmittingPatches.rst doc: amend Fixes instructions in SubmittingPatches 2016-03-25 17:39:39 +01:00

============================================ Ceph - a scalable distributed storage system

Please see http://ceph.com/ for current info.

Contributing Code

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 SubmittingPatches.rst for details on what that means and on how to generate and submit patches.

We do not require assignment of copyright to contribute code; code is contributed under the terms of the applicable license.

Build Prerequisites

The list of Debian or RPM packages dependencies can be installed with:

./install-deps.sh

Note: libsnappy-dev and libleveldb-dev are not available upstream for Debian Squeeze. Backports for Ceph can be found at ceph.com/debian-leveldb.

Building Ceph

Autotools

Developers, please refer to the Developer Guide for more information, otherwise, you can build the server daemons, and FUSE client, by executing the following:

./autogen.sh
./configure
make

(Note that the FUSE client will only be built if libfuse is present.)

CMake

Prerequisite: CMake 2.8.11

Build instructions:

mkdir build
cd build
cmake [options] /path/to/ceph/src/dir
make

(Note that /path/to/ceph/src/dir can be in the tree and out of the tree)

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,

./configure --with-nss         # use libnss instead of libcrypto++
./configure --without-radosgw  # do not build radosgw
./configure --without-tcmalloc # avoid google-perftools dependency

Building packages

You can build packages for Debian or Debian-derived (e.g., Ubuntu) systems with

sudo apt-get install dpkg-dev
dpkg-checkbuilddeps        # make sure we have all dependencies
dpkg-buildpackage

For RPM-based systems (Red Hat, SUSE, etc.),

rpmbuild

Building the Documentation

Prerequisites

The list of package dependencies for building the documentation can be found in doc_deps.deb.txt:

sudo apt-get install `cat doc_deps.deb.txt`

Building the Documentation

To build the documentation, ensure that you are in the top-level `/ceph directory, and execute the build script. For example:

admin/build-doc