summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn Wilkins <john.wilkins@inktank.com>2012-12-20 12:59:58 -0800
committerJohn Wilkins <john.wilkins@inktank.com>2012-12-20 12:59:58 -0800
commit719679ea11a67917154fcc479a6e9b819a4b8d83 (patch)
tree51349e696e6862580f05c41a3d55943c995fa5dc
parent04eb1e73adabed25fa85d851760e4f0726c62acc (diff)
downloadceph-719679ea11a67917154fcc479a6e9b819a4b8d83.tar.gz
doc: Added package and repo links for Apache and FastCGI. Added SSL enable too.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
-rw-r--r--doc/radosgw/manual-install.rst44
1 files changed, 38 insertions, 6 deletions
diff --git a/doc/radosgw/manual-install.rst b/doc/radosgw/manual-install.rst
index f0dcdebca6f..ed423d23a42 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