man: move man page fixes to rst

83cf1b62fde525d068bc292c4a1ccc42199657ae and
e5f49104ab62ba7bc42cf6ecf41c9257b46585f7 updated the nroff output
but not the rst source.

Signed-off-by: Josh Durgin <josh.durgin@dreamhost.com>

diff --git a/doc/man/8/ceph-authtool.rst b/doc/man/8/ceph-authtool.rst
index 9a47f20f1263a9a67bd4545077c5cdd349a35d70..23346cffabb2a0baea62c8e705f9d23abd628a7e 100644 (file)
--- a/doc/man/8/ceph-authtool.rst
+++ b/doc/man/8/ceph-authtool.rst
@@ -110,7 +110,7 @@ Example
 
 To create a new keyring containing a key for client.foo::
 
-        ceph-authtool -c -n client.foo --gen-key keyring
+        ceph-authtool -C -n client.foo --gen-key keyring
 
 To associate some capabilities with the key (namely, the ability to
 mount a Ceph filesystem)::

diff --git a/doc/man/8/radosgw.rst b/doc/man/8/radosgw.rst
index e3f37ac5968ecc603cbc68acaafa0b82fbe1d5a2..520e5263701e537bcc5519b9cdddd70f8f1465c0 100644 (file)
--- a/doc/man/8/radosgw.rst
+++ b/doc/man/8/radosgw.rst
@@ -37,30 +37,27 @@ Options
    Specify a unix domain socket path.
 
 
-Examples
-========
+Configuration
+=============
+
+Currently it's the easiest to use the RADOS Gateway with Apache and mod_fastcgi::
 
-An apache example configuration for using the RADOS gateway::
+        FastCgiExternalServer /var/www/s3gw.fcgi -socket /tmp/radosgw.sock
 
         <VirtualHost *:80>
           ServerName rgw.example1.com
           ServerAlias rgw
           ServerAdmin webmaster@example1.com
-          DocumentRoot /var/www/web1/web/
+          DocumentRoot /var/www
 
-          #turn engine on
           RewriteEngine On
-
-          #following is important for RGW/rados
           RewriteRule ^/([a-zA-Z0-9-_.]*)([/]?.*) /s3gw.fcgi?page=$1&params=$2&%{QUERY_STRING} [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
 
-          <IfModule mod_fcgid.c>
-            SuexecUserGroup web1 web1
-            <Directory /var/www/web1/web/>
+          <IfModule mod_fastcgi.c>
+            <Directory /var/www>
               Options +ExecCGI
               AllowOverride All
-              SetHandler fcgid-script
-              FCGIWrapper /var/www/fcgi-scripts/web1/radosgw .fcgi
+              SetHandler fastcgi-script
               Order allow,deny
               Allow from all
               AuthBasicAuthoritative Off
@@ -68,28 +65,37 @@ An apache example configuration for using the RADOS gateway::
           </IfModule>
 
           AllowEncodedSlashes On
-
-          # ErrorLog /var/log/apache2/error.log
-          # CustomLog /var/log/apache2/access.log combined
           ServerSignature Off
-
         </VirtualHost>
 
-And the corresponding radosgw script::
+And the corresponding radosgw script (/var/www/s3gw.fcgi)::
 
         #!/bin/sh
-       exec /usr/bin/radosgw -c /etc/ceph.conf
+        exec /usr/bin/radosgw -c /etc/ceph/ceph.conf -n client.radosgw.gateway
+
+The radosgw daemon is a standalone process which needs a configuration
+section in the ceph.conf The section name should start with
+'client.radosgw.' as specified in /etc/init.d/radosgw::
+
+        [client.radosgw.gateway]
+            host = gateway
+            keyring = /etc/ceph/keyring.radosgw.gateway
+            rgw socket path = /tmp/radosgw.sock
+
+You will also have to generate a key for the radosgw to use for
+authentication with the cluster::
+
+        ceph-authtool -C -n client.radosgw.gateway --gen-key /etc/ceph/keyring.radosgw.gateway
+        ceph-authtool -n client.radosgw.gateway --cap mon 'allow r' --cap osd 'allow rwx' --cap mds 'allow' /etc/ceph/keyring.radosgw.gateway
 
-By default radosgw will run as single threaded and its execution will
-be controlled by the fastcgi process manager. An alternative way to
-run it would be by specifying (along the lines of) the following in
-the apache config::
+And add the key to the auth entries::
 
-        FastCgiExternalServer /var/www/web1/web/s3gw.fcgi -socket /tmp/.radosgw.sock
+        ceph auth add client.radosgw.gateway --in-file=keyring.radosgw.gateway
 
-and specify a unix domain socket path (either by passing a command
-line option, or through ceph.conf).
+Now you can start Apache and the radosgw daemon::
 
+        /etc/init.d/apache2 start
+        /etc/init.d/radosgw start
 
 Availability
 ============