]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: Added package and repo links for Apache and FastCGI. Added SSL enable too.
authorJohn Wilkins <john.wilkins@inktank.com>
Thu, 20 Dec 2012 20:59:58 +0000 (12:59 -0800)
committerJohn Wilkins <john.wilkins@inktank.com>
Thu, 20 Dec 2012 20:59:58 +0000 (12:59 -0800)
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
doc/radosgw/manual-install.rst

index f0dcdebca6ff8478e1b669cd85792d3c7c0a45d6..ed423d23a429f6e2aac09b99058bbe85e02b83de 100644 (file)
@@ -8,13 +8,27 @@ To install RADOS Gateway, you must install Apache and FastCGI first. ::
 
        sudo apt-get update && sudo apt-get install apache2 libapache2-mod-fastcgi
        
-.. note:: The Ceph community provides a slightly optimized version of the 
-   ``apache2`` and ``fastcgi`` packages. The material difference is that 
-   the Ceph packages are optimized for the ``100-continue`` HTTP response, 
-   where the server determines if it will accept the request by first 
-   evaluating the request header. See `RFC 2616, Section 8`_ for details 
-   on ``100-continue``.
+The Ceph community provides a slightly optimized version of the  ``apache2``
+and ``fastcgi`` packages. The material difference is that  the Ceph packages are
+optimized for the ``100-continue`` HTTP response,  where the server determines
+if it will accept the request by first  evaluating the request header. See `RFC
+2616, Section 8`_ for details  on ``100-continue``. You can find the Apache and
+FastCGI packages modified for Ceph here:
 
+- `Apache Oneiric`_
+- `Apache Precise`_
+- `FastCGI Oneric`_
+- `FastCGI Precise`_
+
+You may also clone Ceph's Apache and FastCGI git repositories:: 
+
+   git clone --recursive https://github.com/ceph/mod_fastcgi.git
+   git clone --recursive https://github.com/ceph/apache2.git
+
+.. _Apache Oneiric: http://gitbuilder.ceph.com/apache2-deb-oneiric-x86_64-basic/ 
+.. _Apache Precise: http://gitbuilder.ceph.com/apache2-deb-precise-x86_64-basic/
+.. _FastCGI Oneric: http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-oneiric-x86_64-basic/ 
+.. _FastCGI Precise: http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-precise-x86_64-basic/
 .. _RFC 2616, Section 8: http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html 
        
 Enable the URL rewrite modules for Apache and FastCGI. For example:: 
@@ -35,3 +49,21 @@ Restart Apache so that the foregoing changes take effect. ::
 Then, install RADOS Gateway. For example:: 
 
        sudo apt-get install radosgw
+
+
+Enable SSL
+==========
+
+Some REST clients use HTTPS by default. So you should consider enabling SSL
+for Apache on the server machine. ::
+
+       sudo a2enmod ssl
+
+Once you enable SSL, you should generate an SSL certificate. :: 
+
+       sudo mkdir /etc/apache2/ssl
+       sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt
+
+Then, restart Apache. ::
+
+       service apache2 restart