mirror of
https://github.com/ceph/ceph
synced 2024-12-11 22:18:18 +00:00
92fa2ff8fc
Keeping the generated files in version control lets us support builds from scratch without requiring the full documentation toolchain to be installed. The files were just copied over from build-doc/output/man, after a ./admin/build-doc call. When redoing this, also take care to remove any roff output if a file was removed from doc/man, and update Makefile.am. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
138 lines
3.2 KiB
Groff
138 lines
3.2 KiB
Groff
.TH "RADOSGW" "8" "September 09, 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.
|
|
.\"
|
|
.
|