From 719679ea11a67917154fcc479a6e9b819a4b8d83 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Thu, 20 Dec 2012 12:59:58 -0800 Subject: [PATCH] doc: Added package and repo links for Apache and FastCGI. Added SSL enable too. Signed-off-by: John Wilkins --- doc/radosgw/manual-install.rst | 44 +++++++++++++++++++++++++++++----- 1 file changed, 38 insertions(+), 6 deletions(-) diff --git a/doc/radosgw/manual-install.rst b/doc/radosgw/manual-install.rst index f0dcdebca6ff8..ed423d23a429f 100644 --- a/doc/radosgw/manual-install.rst +++ b/doc/radosgw/manual-install.rst @@ -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 -- 2.39.5