summaryrefslogtreecommitdiff
path: root/man/radosgw.8
diff options
context:
space:
mode:
authorYehuda Sadeh <yehuda@hq.newdream.net>2009-10-28 11:16:17 -0700
committerYehuda Sadeh <yehuda@hq.newdream.net>2009-10-28 11:16:17 -0700
commit236c7ea051ced256afbb4a1575f260dfe0502f84 (patch)
tree8bfe102e4c1bfdf24fe66a7e128bd4d088d43bd2 /man/radosgw.8
parentf8fb331226ccfb19d6f4ead5c53e913b6566d95e (diff)
downloadceph-236c7ea051ced256afbb4a1575f260dfe0502f84.tar.gz
rgw: radosgw man page continued
Diffstat (limited to 'man/radosgw.8')
-rw-r--r--man/radosgw.850
1 files changed, 41 insertions, 9 deletions
diff --git a/man/radosgw.8 b/man/radosgw.8
index ce0411eead6..cce15a8c5b3 100644
--- a/man/radosgw.8
+++ b/man/radosgw.8
@@ -1,13 +1,13 @@
.TH RGW 8
.SH NAME
-rgw \- rados REST gateway
+radosgw \- rados REST gateway
.SH SYNOPSIS
-.B rgw
+.B radosgw
.SH DESCRIPTION
-.B rgw
+.B radosgw
is an HTTP REST gateway for the RADOS object store, a part of the Ceph
distributed storage system. It is implemented as a FastCGI module using
-libfcgi, and can be used in conjunction any FastCGI capable web server.
+libfcgi, and can be used in conjunction with any FastCGI capable web server.
.SH OPTIONS
.TP
\fB\-c\fI ceph.conf\fR, \fB\-\-conf=\fIceph.conf\fR
@@ -17,15 +17,47 @@ to determine monitor addresses during startup.
\fB\-m\fI monaddress[:port]\fR
Connect to specified monitor (instead of looking through \fIceph.conf\fR).
.SH EXAMPLES
-To grab a copy of the current OSD map:
+An apache example configuration for using the RADOS gateway:
.IP
-ceph -m 1.2.3.4:6789 osd getmap -o osdmap
+<VirtualHost *:80>
+ ServerName rgw.example1.com
+ ServerAlias rgw
+ ServerAdmin webmaster@example1.com
+ DocumentRoot /var/www/web1/web/
+
+ #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
+ PHP_Fix_Pathinfo_Enable 1
+ <Directory /var/www/web1/web/>
+ Options +ExecCGI
+ AllowOverride All
+ SetHandler fcgid-script
+ FCGIWrapper /var/www/fcgi-scripts/web1/rgw .fcgi
+ Order allow,deny
+ Allow from all
+ AuthBasicAuthoritative Off
+ </Directory>
+ </IfModule>
+
+ AllowEncodedSlashes On
+
+ # ErrorLog /var/log/apache2/error.log
+ # CustomLog /var/log/apache2/access.log combined
+ ServerSignature Off
+</VirtualHost>
.PP
-To get a dump of placement group (PG) state:
+And the corresponding rgw script:
.IP
-ceph pg dump -o pg.txt
+#!/bin/sh
+/usr/bin/radosgw -c /etc/ceph.conf
.SH AVAILABILITY
-.B rgw
+.B radosgw
is part of the Ceph distributed file system. Please refer to the Ceph wiki at
http://ceph.newdream.net/wiki for more information.
.SH SEE ALSO