doc: draft rpm installation

diff --git a/doc/install/rpm.rst b/doc/install/rpm.rst
index 06fd30f295bce5fd94a3b317cdf2b4f893df4ec6..9bfd669b205a504fb48a823b0acfebfd60d11db9 100644 (file)
--- a/doc/install/rpm.rst
+++ b/doc/install/rpm.rst
@@ -1,14 +1,48 @@
-=========================
+========================
  Installing RPM Packages
-=========================
+========================
 
-We do not yet build RPM packages for Ceph releases.  You can build them yourself from
-the source tree by running::
+You may install stable release packages (for stable deployments),
+development release packages (for the latest features), or development
+testing packages (for development and QA only).  Do not add multiple
+package sources at the same time.
 
-        rpmbuild
+Add Stable Release Packages
+---------------------------
 
-See `Ceph Source Code <../../source>`_ for details. Once you have an RPM, you can 
-install it with::
+RPM packages have not been built for the current stable releases, but
+are planned for the future.
 
-       rpm -i ceph-*.rpm
+Add Development Release Packages
+--------------------------------
 
+Our development process generates a new release of Ceph every 3-4 weeks.
+These packages are faster-moving than the stable releases, as they get
+new features integrated quickly, while still undergoing several weeks of QA
+prior to release.
+
+Packages are cryptographically signed with the ``release.asc`` key.
+Add our release key to your system's list of trusted keys to avoid a
+security warning::
+
+    sudo rpm --import https://raw.github.com/ceph/ceph/master/keys/release.asc
+
+Packages are currently built for the Centos6 and Fedora 17 platforms.
+
+The repository package installs the repo details on your local system for yum or up2date to use.::
+
+For Centos6:
+
+    su -c 'rpm -Uvh http://ceph.come/el6/x86_64/ceph-release-1-0.noarch.rpm'
+
+For Fedora17: 
+
+    su -c 'rpm -Uvh http://ceph.come/fc17/x86_64/ceph-release-1-0.noarch.rpm'
+
+Installing Packages
+-------------------
+
+Once you have added either release or development packages to yum, 
+you should update APT's database and install Ceph::
+
+       sudo yum install ceph