mirror of https://github.com/ceph/ceph
138 lines
3.2 KiB
Groff
138 lines
3.2 KiB
Groff
.TH "RADOSGW" "8" "September 22, 2011" "dev" "Ceph"
|
|
.SH NAME
|
|
radosgw \- rados REST gateway
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.\" Man page generated from reStructeredText.
|
|
.
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fBradosgw\fP
|
|
.fi
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBradosgw\fP 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 with any FastCGI
|
|
capable web server.
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-c ceph.conf, \-\-conf=ceph.conf
|
|
Use \fIceph.conf\fP configuration file instead of the default
|
|
\fB/etc/ceph/ceph.conf\fP to determine monitor addresses during startup.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-m monaddress[:port]
|
|
Connect to specified monitor (instead of looking through
|
|
\fBceph.conf\fP).
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-rgw\-socket\-path=path
|
|
Specify a unix domain socket path.
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.sp
|
|
An apache example configuration for using the RADOS gateway:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
<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
|
|
FCGIWrapper /var/www/fcgi\-scripts/web1/radosgw .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>
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
And the corresponding radosgw script:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
#!/bin/sh
|
|
exec /usr/bin/radosgw \-c /etc/ceph.conf
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
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:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
FastCgiExternalServer /var/www/web1/web/s3gw.fcgi \-socket /tmp/.radosgw.sock
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
and specify a unix domain socket path (either by passing a command
|
|
line option, or through ceph.conf).
|
|
.SH AVAILABILITY
|
|
.sp
|
|
\fBradosgw\fP is part of the Ceph distributed file system. Please refer
|
|
to the Ceph wiki at \fI\%http://ceph.newdream.net/wiki\fP for more
|
|
information.
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fBceph\fP(8)
|
|
.SH COPYRIGHT
|
|
2011, New Dream Network
|
|
.\" Generated by docutils manpage writer.
|
|
.\"
|
|
.
|