2009-10-28 19:08:54 +00:00
|
|
|
.TH RADOSGW 8
|
2009-10-28 17:54:01 +00:00
|
|
|
.SH NAME
|
2009-10-28 18:16:17 +00:00
|
|
|
radosgw \- rados REST gateway
|
2009-10-28 17:54:01 +00:00
|
|
|
.SH SYNOPSIS
|
2009-10-28 18:16:17 +00:00
|
|
|
.B radosgw
|
2009-10-28 17:54:01 +00:00
|
|
|
.SH DESCRIPTION
|
2009-10-28 18:16:17 +00:00
|
|
|
.B radosgw
|
2009-10-28 17:54:01 +00:00
|
|
|
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
|
2009-10-28 18:16:17 +00:00
|
|
|
libfcgi, and can be used in conjunction with any FastCGI capable web server.
|
2009-10-28 17:54:01 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
|
|
\fB\-c\fI ceph.conf\fR, \fB\-\-conf=\fIceph.conf\fR
|
|
|
|
Use \fIceph.conf\fP configuration file instead of the default \fI/etc/ceph/ceph.conf\fP
|
|
|
|
to determine monitor addresses during startup.
|
|
|
|
.TP
|
|
|
|
\fB\-m\fI monaddress[:port]\fR
|
|
|
|
Connect to specified monitor (instead of looking through \fIceph.conf\fR).
|
|
|
|
.SH EXAMPLES
|
2009-10-28 18:16:17 +00:00
|
|
|
An apache example configuration for using the RADOS gateway:
|
2009-10-28 17:54:01 +00:00
|
|
|
.IP
|
2009-10-28 18:16:17 +00:00
|
|
|
<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¶ms=$2&%{QUERY_STRING} [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
|
|
|
|
|
|
|
|
<IfModule mod_fcgid.c>
|
|
|
|
SuexecUserGroup web1 web1
|
|
|
|
<Directory /var/www/web1/web/>
|
|
|
|
Options +ExecCGI
|
|
|
|
AllowOverride All
|
|
|
|
SetHandler fcgid-script
|
2009-10-28 19:08:54 +00:00
|
|
|
FCGIWrapper /var/www/fcgi-scripts/web1/radosgw .fcgi
|
2009-10-28 18:16:17 +00:00
|
|
|
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
|
2011-03-31 20:28:29 +00:00
|
|
|
|
2009-10-28 18:16:17 +00:00
|
|
|
</VirtualHost>
|
2009-10-28 17:54:01 +00:00
|
|
|
.PP
|
2009-10-28 19:08:54 +00:00
|
|
|
And the corresponding radosgw script:
|
2009-10-28 17:54:01 +00:00
|
|
|
.IP
|
2009-10-28 18:16:17 +00:00
|
|
|
#!/bin/sh
|
|
|
|
/usr/bin/radosgw -c /etc/ceph.conf
|
2009-10-28 17:54:01 +00:00
|
|
|
.SH AVAILABILITY
|
2009-10-28 18:16:17 +00:00
|
|
|
.B radosgw
|
2009-10-28 17:54:01 +00:00
|
|
|
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
|
|
|
|
.BR ceph (8)
|