From: John Wilkins Date: Mon, 4 Nov 2013 23:11:05 +0000 (-0800) Subject: doc: Deleted old manual install doc. X-Git-Tag: v0.73~26^2~1 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=917dd716ae57f8a74d0054640acb90e81f0b2059;p=ceph.git doc: Deleted old manual install doc. Signed-off-by: John Wilkins --- diff --git a/doc/radosgw/manual-install.rst b/doc/radosgw/manual-install.rst deleted file mode 100644 index 6b9b7e59d1f3..000000000000 --- a/doc/radosgw/manual-install.rst +++ /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