summaryrefslogtreecommitdiffstats
path: root/doc/install
diff options
context:
space:
mode:
authorJohn Wilkins <john.wilkins@inktank.com>2013-06-28 01:31:44 +0200
committerJohn Wilkins <john.wilkins@inktank.com>2013-06-28 01:31:44 +0200
commit13f9c184c4cf1e666643ded3570f7e2d655a4852 (patch)
treed8b1d56f26452b7031b9cad55280bd831b0ab2e8 /doc/install
parentMerge branch 'next' (diff)
downloadceph-13f9c184c4cf1e666643ded3570f7e2d655a4852.tar.xz
ceph-13f9c184c4cf1e666643ded3570f7e2d655a4852.zip
doc: Created an install page for Calxeda development packages.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
Diffstat (limited to 'doc/install')
-rw-r--r--doc/install/calxeda.rst74
-rw-r--r--doc/install/index.rst1
2 files changed, 75 insertions, 0 deletions
diff --git a/doc/install/calxeda.rst b/doc/install/calxeda.rst
new file mode 100644
index 00000000000..d8350e12b17
--- /dev/null
+++ b/doc/install/calxeda.rst
@@ -0,0 +1,74 @@
+=======================
+ Installing on Calxeda
+=======================
+
+The Calxeda partnership with Inktank brings the Ceph Distributed Storage System
+to Calxeda hardware. This document describes how to install Ceph development
+packages on Calxeda hardware.
+
+Ceph on Calxeda uses Debian/Ubuntu Linux. At this time, gitbuilder builds
+development packages for Calxeda on the Quantal Quetzal (i.e., 12.10) version of
+Ubuntu. The installation process for Ceph on Calxeda is almost identical to the
+process for installing Ceph packages on `Debian/Ubuntu`_.
+
+
+Install Key
+===========
+
+Packages are cryptographically signed with the ``autobuild.asc`` key. Add the
+Ceph autobuild key to your system's list of trusted keys to avoid a security
+warning::
+
+ wget -q -O- 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc' | sudo apt-key add -
+
+
+Add Package
+===========
+
+Add the Ceph package repository to your system's list of APT sources, but
+replace ``{BRANCH}`` with the branch you'd like to use (e.g., ``master``,
+``stable``, ``next``, ``wip-hack``). ::
+
+ echo deb http://gitbuilder.ceph.com/ceph-deb-$(lsb_release -sc)-armv7l-basic/ref/ {BRANCH} $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list
+ sudo apt-get update
+
+
+Prerequisites
+=============
+
+Ceph on Calxeda requires Google's memory profiling tools (``google-perftools``).
+The Ceph repository should have a copy at
+http://ceph.com/packages/google-perftools/debian. ::
+
+ echo deb http://ceph.com/packages/google-perftools/debian $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/google-perftools.list
+ sudo apt-get update
+ sudo apt-get install google-perftools
+
+
+Install Ceph
+============
+
+Once you have added development packages to APT and installed Google
+memory profiling tools, you should update APT's database and install Ceph::
+
+ sudo apt-get update
+ sudo apt-get install ceph
+
+You may also use ceph-deploy to install Ceph, but you must add the key and
+packages and install ``google-perftools`` first.
+
+
+Ceph Object Storage Packages
+============================
+
+If you intend to run Ceph Object Storage on Calxeda hardware, you should add the
+``apache2`` and ``fastcgi`` packages **before** installing Ceph Object Storage
+components. ::
+
+ echo deb http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-quantal-arm7l-basic | sudo tee /etc/apt/sources.list.d/fastcgi.list
+ echo deb http://gitbuilder.ceph.com/apache2-deb-$(lsb_release -sc)-arm7l-basic/ref/ master $(lsb_release -sc) | sudo tee /etc/apt/sources.list.d/apache2.list
+
+Once you have added these packages, you may install Ceph Object Storage on Calxeda
+hardware.
+
+.. _Debian/Ubuntu: ../debian \ No newline at end of file
diff --git a/doc/install/index.rst b/doc/install/index.rst
index 3c8a484beee..347b6ae9ac2 100644
--- a/doc/install/index.rst
+++ b/doc/install/index.rst
@@ -39,6 +39,7 @@ may install development release and testing packages.
Installing Debian/Ubuntu Packages <debian>
Installing RPM Packages <rpm>
+ Installing on Calxeda <calxeda>
Upgrading Ceph <upgrading-ceph>
.. raw:: html