From 39b0354a7dfee5bf43cd7c4feab4ec9bbdd9e223 Mon Sep 17 00:00:00 2001 From: Tommi Virtanen Date: Fri, 2 Sep 2011 12:31:37 -0700 Subject: [PATCH] doc: Write about deb installation. Signed-off-by: Tommi Virtanen --- doc/dev/index.rst | 11 ++++ doc/ops/autobuilt.rst | 64 +++++++++++++++++++ doc/ops/filesystem.rst | 17 +++++ doc/ops/index.rst | 2 + doc/ops/install.rst | 122 ++++++++++++++++++++++++++++++----- doc/ops/misc.rst | 14 +++++ keys/autobuild.asc | 41 ++++++++++++ keys/release.asc | 140 +++++++++++++++++++++++++++++++++++++++++ 8 files changed, 394 insertions(+), 17 deletions(-) create mode 100644 doc/ops/autobuilt.rst create mode 100644 doc/ops/misc.rst create mode 100644 keys/autobuild.asc create mode 100644 keys/release.asc diff --git a/doc/dev/index.rst b/doc/dev/index.rst index 833545049a24e..69fda91850c26 100644 --- a/doc/dev/index.rst +++ b/doc/dev/index.rst @@ -5,6 +5,17 @@ .. note:: If you're looking for how to use Ceph as a library from your own software, please see :doc:`/api/index`. +You can start a development mode Ceph cluster, after compiling the source, with:: + + cd src + install -d -m0755 out dev/osd0 + ./vstart.sh -n -x -l + # check that it's there + ./ceph health + +.. todo:: vstart is woefully undocumented and full of sharp sticks to poke yourself with. + + .. toctree:: :glob: diff --git a/doc/ops/autobuilt.rst b/doc/ops/autobuilt.rst new file mode 100644 index 0000000000000..add9b292a92b5 --- /dev/null +++ b/doc/ops/autobuilt.rst @@ -0,0 +1,64 @@ +============================= + Autobuilt unstable packages +============================= + +We automatically build Debian and Ubuntu packages for any branches or +tags that appear in the |ceph.git|_. We build packages for the `amd64` +and `i386` architectures (`arch list`_), for the following +distributions (`distro list`_): + +- ``natty`` (Ubuntu 11.04) +- ``squeeze`` (Debian 6.0) + +.. |ceph.git| replace:: + ``ceph.git`` repository +.. _`ceph.git`: https://github.com/NewDreamNetwork/ceph + +.. _`arch list`: http://ceph.newdream.net/debian-snapshot-amd64/master/dists/natty/main/ +.. _`distro list`: http://ceph.newdream.net/debian-snapshot-amd64/master/dists/ + +The current status of autobuilt packages can be found at +http://ceph.newdream.net/gitbuilder-deb-amd64/ . + +If you wish to use these packages, you need to modify the +:ref:`earlier instructions ` as follows: + +.. warning:: The following commands make your computer trust any code + that makes it into ``ceph.git``, including work in progress + branches and versions of code with possible security issues (that + were fixed afterwards). Use at your own risk! + +Whenever we say *DISTRO* below, replace it with the codename of your +operating system. + +Whenever we say *BRANCH* below, replace it with the version of the +code you want to run, e.g. ``master``, ``stable`` or ``v0.34`` (`branch list`_ [#broken-links]_). + +.. _`branch list`: http://ceph.newdream.net/debian-snapshot-amd64/ + +Run these commands on all nodes:: + + wget -q -O- https://raw.github.com/NewDreamNetwork/ceph/master/keys/autobuild.asc \ + | sudo apt-key add - + + sudo tee /etc/apt/sources.list.d/ceph.list <