doc: Created an install page for Calxeda development packages.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

diff --git a/doc/install/calxeda.rst b/doc/install/calxeda.rst
new file mode 100644 (file)
index 0000000..d8350e1
--- /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 \r
+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 3c8a484beeec7c7e44db12790fc60dd87fb82d51..347b6ae9ac205398f1de05c55c83bfda9f6338e6 100644 (file)
--- 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