]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: Deleted old manual install doc.
authorJohn Wilkins <john.wilkins@inktank.com>
Mon, 4 Nov 2013 23:11:05 +0000 (15:11 -0800)
committerJohn Wilkins <john.wilkins@inktank.com>
Mon, 4 Nov 2013 23:11:05 +0000 (15:11 -0800)
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
doc/radosgw/manual-install.rst [deleted file]

diff --git a/doc/radosgw/manual-install.rst b/doc/radosgw/manual-install.rst
deleted file mode 100644 (file)
index 6b9b7e5..0000000
+++ /dev/null
@@ -1,132 +0,0 @@
-=====================================
- Install Apache, FastCGI and Gateway
-=====================================
-
-Install Packages
-================
-
-To install Ceph Object Gateway, you must install Apache and FastCGI first. :: 
-
-       sudo apt-get update && sudo apt-get install apache2 libapache2-mod-fastcgi
-
-
-100-Continue Support
---------------------
-       
-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`_
-- `Apache Quantal for ARM (Calxeda)`_
-- `FastCGI Oneric`_
-- `FastCGI Precise`_
-- `FastCGI Quantal for ARM (Calxeda)`_
-
-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/
-.. _Apache Quantal for ARM (Calxeda): http://gitbuilder.ceph.com/apache2-deb-quantal-arm7l-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/
-.. _FastCGI Quantal for ARM (Calxeda): http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-quantal-arm7l-basic/
-.. _RFC 2616, Section 8: http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html 
-
-.. important:: If you do NOT use a modified fastcgi as described above,
-   you should disable 100-Continue support by adding the following to
-   your ``ceph.conf``::
-
-       rgw print continue = false
-
-
-Apache Configuration
-====================
-
-Enable the URL rewrite modules for Apache and FastCGI. For example:: 
-
-       sudo a2enmod rewrite
-       sudo a2enmod fastcgi
-       
-By default, the ``/etc/apache2/httpd.conf`` or ``/etc/apache2/apache2.conf``
-file is blank. Add a line for the ``ServerName`` and provide the fully
-qualified domain name of the host where  you will install the Ceph Object
-Gateway. For example:: 
-       
-       ServerName {fqdn}
-       
-Restart Apache so that the foregoing changes take effect. ::
-
-       sudo service apache2 restart
-       
-Then, install Ceph Object Gateway and its sync agent. For example:: 
-
-       sudo apt-get install radosgw radosgw-agent
-
-
-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
-
-
-.. note:: The foregoing example uses self-certified certificates. Some client
-   APIs check for a trusted certificate authority. So you may need to obtain
-   a SSL certificate from a trusted authority to use those client APIs.
-
-Then, restart Apache. ::
-
-       service apache2 restart
-
-
-Add Wildcard to DNS
-===================
-
-To use Ceph with S3-style subdomains (e.g., ``bucket-name.domain-name.com``),
-you need to add a wildcard to the DNS record of the DNS server you use with the
-``radosgw`` daemon.
-
-.. tip:: The address of the DNS must also be specified in the Ceph 
-   configuration file with the ``rgw dns name = {hostname}`` setting.
-
-For ``dnsmasq``, consider addding the following ``address`` setting with a dot
-(.) prepended to the host name:: 
-
-       address=/.{hostname-or-fqdn}/{host-ip-address}
-       address=/.ceph-node/192.168.0.1
-
-For ``bind``, consider adding the a wildcard to the DNS record::
-
-       $TTL    604800
-       @       IN      SOA     ceph-node. root.ceph-node. (
-                                     2         ; Serial
-                                604800         ; Refresh
-                                 86400         ; Retry
-                               2419200         ; Expire
-                                604800 )       ; Negative Cache TTL
-       ;
-       @       IN      NS      ceph-node.
-       @       IN      A       192.168.122.113
-       *       IN      CNAME   @
-
-Restart your DNS server and ping your server with a subdomain to 
-ensure that your Ceph Object Store ``radosgw`` daemon can process
-the subdomain requests. :: 
-
-       ping mybucket.{fqdn}
-       ping mybucket.ceph-node