diff options
author | Jamal Natour <jamal@lshift.net> | 2009-01-06 10:12:19 +0000 |
---|---|---|
committer | Jamal Natour <jamal@lshift.net> | 2009-01-06 10:12:19 +0000 |
commit | 843e9d504956e82a1442c763d89e086bf6bb97bc (patch) | |
tree | 6cf1555e8834237a24ec098485cc00c221ec43ea | |
parent | 2c6490ead76d0b42f9ab9dc8379bbe5088a24a1f (diff) | |
download | rabbitmq-server-bug19213.tar.gz |
Initial import. Ebuild modified from an overlay ebuild written by Holger Hoffst?tte in response to gentoo bug #192278 and lshift bug #19213bug19213
added files/1.5.0/init.d:
rabbitmq-cluster.example.confd - added sample clustering configuration
rabbitmq-server.confd - added default configuration for rabbitmq-server
rabbitmq-server.initd - added gentoo runscript for rabbitmq-server
added files/1.5.0/logrotate.d:
rabbitmq-server - added logrotate script
added files/1.5.0/man:
rabbitmq-multi.1 - added man page for rabbitmq-multi script
rabbitmq-server.1 - added man page for rabbitmq-server script
rabbitmq.5 - added man page for rabbitmq script
rabbitmqctl.1 - added man page for rabbitmqctl script
added files/1.5.0/misc:
rabbitmq-invoke - wrapper script for rabbitmq-multi
Added to allow cloning of output to logs and maintaining the
correct log permissions (i.e. with permissions of the rabbit user, not root)
added files/1.5.0/patches:
0001-change-conf-dir.patch - patch to make scripts read from conf.d
-rw-r--r-- | packaging/gentoo/ChangeLog | 33 | ||||
-rw-r--r-- | packaging/gentoo/Manifest | 16 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/init.d/rabbitmq-cluster.example.confd | 5 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.confd | 38 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.initd | 132 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/logrotate.d/rabbitmq-server | 12 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/man/rabbitmq-multi.1 | 176 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/man/rabbitmq-server.1 | 199 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/man/rabbitmq.5 | 186 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/man/rabbitmqctl.1 | 421 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/misc/rabbitmq-invoke | 70 | ||||
-rw-r--r-- | packaging/gentoo/files/1.5.0/patches/0001-change-conf-dir.patch | 24 | ||||
-rw-r--r-- | packaging/gentoo/metadata.xml | 20 | ||||
-rw-r--r-- | packaging/gentoo/rabbitmq-server-1.5.0-r1.ebuild | 175 | ||||
-rw-r--r-- | packaging/gentoo/rabbitmq-server-1.5.0.ebuild | 39 |
15 files changed, 1546 insertions, 0 deletions
diff --git a/packaging/gentoo/ChangeLog b/packaging/gentoo/ChangeLog new file mode 100644 index 00000000..363a3285 --- /dev/null +++ b/packaging/gentoo/ChangeLog @@ -0,0 +1,33 @@ + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +added files/1.5.0/init.d: + rabbitmq-cluster.example.confd - added sample clustering configuration + rabbitmq-server.confd - added default configuration for rabbitmq-server + rabbitmq-server.initd - added gentoo runscript for rabbitmq-server + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +added files/1.5.0/logrotate.d: + rabbitmq-server - added logrotate script + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +added files/1.5.0/man: + rabbitmq-multi.1 - added man page for rabbitmq-multi script + rabbitmq-server.1 - added man page for rabbitmq-server script + rabbitmq.5 - added man page for rabbitmq script + rabbitmqctl.1 - added man page for rabbitmqctl script + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +added files/1.5.0/misc: + rabbitmq-invoke - wrapper script for rabbitmq-multi + Added to allow cloning of output to logs and maintaining the + correct log permissions (i.e. with permissions of the rabbit user, not root) + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +added files/1.5.0/patches: + 0001-change-conf-dir.patch - patch to make scripts read from conf.d + +24 Dec 2008; Jamal Natour <jamal@lshift.net> +Initial import. Ebuild modified from an overlay ebuild written by Holger Hoffstätte + In response to #192278 + +*rabbitmq-server-1.5.0-r1 (24 Dec 2008) diff --git a/packaging/gentoo/Manifest b/packaging/gentoo/Manifest new file mode 100644 index 00000000..9b48649a --- /dev/null +++ b/packaging/gentoo/Manifest @@ -0,0 +1,16 @@ +AUX 1.5.0/init.d/rabbitmq-cluster.example.confd 241 RMD160 0867205a81966fd182bd97555e9b1edafd51370a SHA1 6c282cc416dfd2958d58235f9fa53b8c7652d3fd SHA256 3a6c8dcbdbea954eb978627821a73da7183a660954b45b57eb32b5f5ae60964a +AUX 1.5.0/init.d/rabbitmq-server.confd 1216 RMD160 e94a441eba30ef64eed8bb79f5ac13ef89eeefa2 SHA1 0ebf38b1c3a3581f3bee8779fdb7c76fe9045b15 SHA256 b605f23c38b5c5e20c58b9e0f7f2b5ab7cb50b30f0e3ed92f146fad9c2f20570 +AUX 1.5.0/init.d/rabbitmq-server.initd 2645 RMD160 84ec40238b37fc349b2c75ac119ad39b4a402500 SHA1 aff1391fc986785180e0e9a49f2ad4330ce587e0 SHA256 6e7828d14f86a2f0ee3994249cd4d21e304058385fb450aff66bf764dad0ecee +AUX 1.5.0/logrotate.d/rabbitmq-server 243 RMD160 478f65d93f3a73032339c2a288f98321804c6353 SHA1 8d33a7f683468c431eb9ca0d823b8a24b462cdc2 SHA256 27d9d657362dbfcc40c13dd1b8c69fea6585050e4af2a6d24f7cecb521805365 +AUX 1.5.0/man/rabbitmq-multi.1 5106 RMD160 f2b6d01eb2784adedffcf8d5fe68e284482c0c25 SHA1 ab9263f1f4040fdfdc5230507d9c3c54bde2f92c SHA256 b32e10e58a4b21ac17f6cf9659d16ac4528399b2661c2007df2cd8664474c732 +AUX 1.5.0/man/rabbitmq-server.1 6225 RMD160 da65f3094d736ba3bab5bce66e71f8219e0bab43 SHA1 0b102e3adacd4f4c73c61904b7bf4b92d382e926 SHA256 f272e0f23c30c9aad286ef4de268c38d0aabba72367f396fe78323d743593aad +AUX 1.5.0/man/rabbitmq.5 5995 RMD160 98d29652f8b47c5c2a5ee22e8e221f772e6708c4 SHA1 731b1902fb2309923d8c1311cac890b125e30973 SHA256 76dc3fa47f544c717702e9b870a20a716fb53a0c5c1ef62505705a74282241f1 +AUX 1.5.0/man/rabbitmqctl.1 12541 RMD160 5ead956acdcc8f93e633c8907d8d0cabb375664b SHA1 160f31f8eb11a45fe2087f9b6e9d34a1c0491d0e SHA256 4aa393988628eace7230d0dde785561e8afde76ecc80c491b3e4c53742ccc33a +AUX 1.5.0/misc/rabbitmq-invoke 2501 RMD160 f51369d32bcf72116e580e8311558ce8fdff4ab9 SHA1 a450c014a8af4b9bb85d77e51ae67b47b152ecfa SHA256 528c3b4fbf744186b3a0507cbcd5a40016a918436c56a22e5bb9f257331eee3b +AUX 1.5.0/patches/0001-change-conf-dir.patch 1040 RMD160 715680427661520a0cdaec4adf4a512ac7554b48 SHA1 21a7d55b2fdd8388cecde4f36f85e26fcd465b53 SHA256 fecc2e54887e5dc40bdc9c10c4b287098f2f99d1918b0dfbdc60199f55c4a502 +DIST rabbitmq-server-1.5.0.tar.gz 111389 RMD160 f9dded4c9fe338c07b7e9606ac2c51cdbc0bc67b SHA1 a27f2bcaf2cd2557fd5ed1defdfed9a519199bc4 SHA256 0531d8a62dbeb018a69672fc638ff324b8a92e4c9674520c046b4dae117fa72a +DIST rabbitmq-server-generic-unix-1.5.0.tar.gz 354152 RMD160 864345792c8ff4d7dbcd1c31f9694df62a68f2e5 SHA1 477081f64270ea066c5c6f115105741212afdef6 SHA256 5c1a9ab3f317e99ff951336c19a8f3528016c73d70ff83e6c084f50aad6e2838 +EBUILD rabbitmq-server-1.5.0-r1.ebuild 5030 RMD160 8ddfee7d92995f0c6943affb3b479c6b401b87aa SHA1 d1d32b7b8d327b2f3cf1b1bf00a135fcde7c05bd SHA256 bf19f37e825c4f9356a6dcda0687350a06d29fddd3c9bf4d0b3188269f0e421b +EBUILD rabbitmq-server-1.5.0.ebuild 1051 RMD160 35f9549863af11a127f096783a57dbc0ff3421eb SHA1 166b02e0a531303ce68d7c7b761374c27b831d8f SHA256 794bca4f2c1926e3913e69326e914a783d914816cd21f531b9c870b7ccfdd89f +MISC ChangeLog 1325 RMD160 e137ba50c491c8d81f6a7d690e259e63f12fa4bf SHA1 9e86ce4016507cb6ade014768e25bcc66cd5f429 SHA256 bd7cd66e913497ef5a52020009ba64142e7b0999df424de6269ea1c32c4061d5 +MISC metadata.xml 559 RMD160 5efae60ed39f36816a4717004d771658ea0c0405 SHA1 cf40daad082d73f2a6a91932431818565b26c4f9 SHA256 89a2dc095e90eaaa579b7b7169968cfe79f7d1636276e2b2a43f02c644a0f97c diff --git a/packaging/gentoo/files/1.5.0/init.d/rabbitmq-cluster.example.confd b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-cluster.example.confd new file mode 100644 index 00000000..5888af91 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-cluster.example.confd @@ -0,0 +1,5 @@ +# Copy this to /etc/conf.d after making the appropriate changes and removing the comments +# more information on rabbit clusters can be found at http://www.rabbitmq.com/clustering.html + +# replace HOSTNAME with your hostname +[rabbit@HOSTNAME] diff --git a/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.confd b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.confd new file mode 100644 index 00000000..d2271168 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.confd @@ -0,0 +1,38 @@ +# Set this to the directory where Mnesia database files should be placed. +MNESIA_BASE=/var/lib/rabbitmq/mnesia + +# Log files generated by the server will be placed in this directory. +LOG_BASE=/var/log/rabbitmq + +# This can be useful if you want to run more than one node per machine +# NOTE NODENAME should be unique per erlang-node-and-machine combination. +#Refer to "clustering on a single machine" in the documentation for more. +NODENAME=rabbit + +# This can be changed if you only want to bind to one network interface. +NODE_IP_ADDRESS=0.0.0.0. + +# start port for the rabbit node, +# when starting multiple rabbit nodes, the port numbers will increment +# by one for each additional rabbitmq node +NODE_PORT=5672 + +# number of inital rabbit nodes started +NODE_COUNT=1 + +# this is the file that holds the pids of the rabbit nodes +PIDS_FILE=/var/lib/rabbitmq/pids + +# If this file is present it is used by the server to +# auto-configure a RabbitMQ cluster. See the clustering +# guide for details. +CLUSTER_CONFIG_FILE=/etc/conf.d/rabbitmq-cluster + +# the name used in the init script system messages +DESC=rabbitmq-server + +# name of the user whom rabbit runs as +USER=rabbitmq + +# suffix of rabbit logs +ROTATED_LOG_SUFFIX=-old diff --git a/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.initd b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.initd new file mode 100644 index 00000000..b7ee8fcd --- /dev/null +++ b/packaging/gentoo/files/1.5.0/init.d/rabbitmq-server.initd @@ -0,0 +1,132 @@ +#!/sbin/runscript +# Copyright 1999-2007 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 + +# Description: RabbitMQ broker +# Short-Description: Enable AMQP service provided by RabbitMQ broker +opts="${opts} status rotate" +depend() +{ + need net logger localmount + after bootmisc + use dns +} + +CONFIG_FILE="/etc/conf.d/rabbitmq-server" + +# wrapper to allows us to have gentoo style logging +WRAPPER=/usr/sbin/rabbitmq-invoke +DAEMON=/usr/sbin/rabbitmq-multi + +# pinched from debian initscript and modified for gentoo +start_rabbitmq() +{ + info_log="${LOG_BASE}/startup_log" + error_log="${LOG_BASE}/startup_err" + set +e + RETVAL=1 + su -s /bin/sh -c "$WRAPPER $info_log $error_log start_all ${NODE_COUNT} &" ${USER} + case "$?" in + 0) + einfo "SUCCESS" + RETVAL=0 + ;; + 1) ERR="TIMEOUT" + eerror "${ERR} - check ${info_log}" + eerror "${ERR} - check ${error_log}" + ;; + *) ERR="FAILED" + eerror "${ERR} - check ${info_log}" + eerror "${ERR} - check ${error_log}" + ;; + esac + set -e +} + +stop_rabbitmq() +{ + info_log="${LOG_BASE}/shutdown_log" + error_log="${LOG_BASE}/shutdown_err" + set +e + status_rabbitmq quiet + if [ "$RETVAL" == "0" ] ; then + su -s /bin/sh -c "$WRAPPER $info_log $error_log stop_all" ${USER} + RETVAL=$? + if [ ${RETVAL} != 0 ] ; then + ERR="FAILED" + eerror "${ERR} - check ${info_log}" + eerror "${ERR} - check ${error_log}" + fi + else + eerror "No nodes running" + RETVAL=0 + fi + set -e +} + +status_rabbitmq() +{ + RETVAL=0 + set +e + if [ "$1" != "quiet" ] ; then + su -s /bin/sh -c "${DAEMON} status" ${USER} 2>&1 + else + su -s /bin/sh -c "${DAEMON} status" ${USER} > /dev/null 2>&1 + fi + if [ $? != 0 ] ; then + RETVAL=1 + fi + set -e +} + +rotate_logs_rabbitmq() +{ + set +e + su -s /bin/sh -c "${DAEMON} rotate_logs ${ROTATED_LOG_SUFFIX}" ${USER} 2>&1 + set -e +} + +# gentoo funcs +start() +{ + checkconfig || return 1 + ebegin "Starting ${DESC}: " + start_rabbitmq + eend $? +} + +stop() +{ + ebegin "Stopping ${DESC}: " + stop_rabbitmq + eend $? +} + +restart() +{ + svc_stop + svc_start +} + +status() +{ + ebegin "Querying status of ${DESC}: " + status_rabbitmq + eend $? +} + +rotate() +{ + ebegin "Rotating log files for ${DESC}: " + rotate_logs_rabbitmq + eend $? +} + +checkconfig() +{ + if [ ! -r ${CONFIG_FILE} ] || [ ! -x ${DAEMON} ] || [ ! -x ${WRAPPER} ] ; + then + eerror "You need a ${CONFIG_FILE} file to run rabbitmq" + return 1 + fi +} diff --git a/packaging/gentoo/files/1.5.0/logrotate.d/rabbitmq-server b/packaging/gentoo/files/1.5.0/logrotate.d/rabbitmq-server new file mode 100644 index 00000000..d3cb4ca0 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/logrotate.d/rabbitmq-server @@ -0,0 +1,12 @@ +/var/log/rabbitmq/*.log { + weekly + missingok + rotate 20 + compress + delaycompress + notifempty + sharedscripts + postrotate + /etc/init.d/rabbitmq-server rotate + endscript +} diff --git a/packaging/gentoo/files/1.5.0/man/rabbitmq-multi.1 b/packaging/gentoo/files/1.5.0/man/rabbitmq-multi.1 new file mode 100644 index 00000000..f4132f9e --- /dev/null +++ b/packaging/gentoo/files/1.5.0/man/rabbitmq-multi.1 @@ -0,0 +1,176 @@ +.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "rabbitmq-multi 1" +.TH rabbitmq-multi 1 "2008-12-17" "" "RabbitMQ AMQP Server" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +rabbitmq\-multi \- start/stop local cluster RabbitMQ nodes +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +rabbitmq-multi \fIcommand\fR [command option] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +RabbitMQ is an implementation of \s-1AMQP\s0, the emerging standard for high +performance enterprise messaging. The RabbitMQ server is a robust and +scalable implementation of an \s-1AMQP\s0 broker. +.PP +rabbitmq-multi scripts allows for easy set-up of a cluster on a single +machine. +.PP +See also \fIrabbitmq\-server\fR\|(1) for configuration information. +.SH "COMMANDS" +.IX Header "COMMANDS" +start_all \fIcount\fR + start count nodes with unique names, listening on all \s-1IP\s0 addresses + and on sequential ports starting from 5672. +.PP +status + print the status of all running RabbitMQ nodes +.PP +stop_all + stop all local RabbitMQ nodes +.PP +rotate_logs + rotate log files for all local and running RabbitMQ nodes +.SH "EXAMPLES" +.IX Header "EXAMPLES" +Start 3 local RabbitMQ nodes with unique, sequential port numbers: +.PP +.Vb 1 +\& rabbitmq\-multi start_all 3 +.Ve +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIrabbitmq\-server\fR\|(1), \fIrabbitmqctl\fR\|(1) +.SH "AUTHOR" +.IX Header "AUTHOR" +The RabbitMQ Team <info@rabbitmq.com> +.SH "REFERENCES" +.IX Header "REFERENCES" +RabbitMQ Web Site: http://www.rabbitmq.com diff --git a/packaging/gentoo/files/1.5.0/man/rabbitmq-server.1 b/packaging/gentoo/files/1.5.0/man/rabbitmq-server.1 new file mode 100644 index 00000000..fb94907d --- /dev/null +++ b/packaging/gentoo/files/1.5.0/man/rabbitmq-server.1 @@ -0,0 +1,199 @@ +.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "rabbitmq-server 1" +.TH rabbitmq-server 1 "2008-12-17" "" "RabbitMQ AMQP Server" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +rabbitmq\-server \- start RabbitMQ AMQP server +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +rabbitmq-server [\-detached] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +RabbitMQ is an implementation of \s-1AMQP\s0, the emerging standard for high +performance enterprise messaging. The RabbitMQ server is a robust and +scalable implementation of an \s-1AMQP\s0 broker. +.PP +Running rabbitmq-server in the foreground displays a banner message, +and reports on progress in the startup sequence, concluding with the +message \*(L"broker running\*(R", indicating that the RabbitMQ broker has been +started successfully. To shut down the server, just terminate the +process or use \fIrabbitmqctl\fR\|(1). +.SH "ENVIRONMENT" +.IX Header "ENVIRONMENT" +\&\fB\s-1Following variables are read from /etc/conf.d/rabbitmq-server\s0\fR +.PP +\&\fB\s-1RABBITMQ_MNESIA_BASE\s0\fR + Defaults to /var/lib/rabbitmq/mnesia. Set this to the directory + where Mnesia database files should be placed. +.PP +\&\fB\s-1RABBITMQ_LOG_BASE\s0\fR + Defaults to /var/log/rabbitmq. Log files generated by the server + will be placed in this directory. +.PP +\&\fB\s-1RABBITMQ_NODENAME\s0\fR + Defaults to rabbit. This can be useful if you want to run more + than one node per machine \- \fB\s-1RABBITMQ_NODENAME\s0\fR should be unique + per erlang-node-and-machine combination. See clustering on a + single machine guide at + http://www.rabbitmq.com/clustering.html#single\-machine for + details. +.PP +\&\fB\s-1RABBITMQ_NODE_IP_ADDRESS\s0\fR + Defaults to 0.0.0.0. This can be changed if you only want to bind + to one network interface. +.PP +\&\fB\s-1RABBITMQ_NODE_PORT\s0\fR + Defaults to 5672. +.PP +\&\fB\s-1RABBITMQ_CLUSTER_CONFIG_FILE\s0\fR + Defaults to /etc/default/rabbitmq_cluster.config. If this file is + present it is used by the server to auto-configure a RabbitMQ + cluster. + See the clustering guide at http://www.rabbitmq.com/clustering.html + for details. +.SH "OPTIONS" +.IX Header "OPTIONS" +\&\fB\-detached\fR start the server process in the background +.SH "EXAMPLES" +.IX Header "EXAMPLES" +Run RabbitMQ \s-1AMQP\s0 server in the background: +.PP +.Vb 1 +\& rabbitmq\-server \-detached +.Ve +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIrabbitmq\-multi\fR\|(1), \fIrabbitmqctl\fR\|(1) +.SH "AUTHOR" +.IX Header "AUTHOR" +The RabbitMQ Team <info@rabbitmq.com> +.SH "REFERENCES" +.IX Header "REFERENCES" +RabbitMQ Web Site: http://www.rabbitmq.com diff --git a/packaging/gentoo/files/1.5.0/man/rabbitmq.5 b/packaging/gentoo/files/1.5.0/man/rabbitmq.5 new file mode 100644 index 00000000..37abbb08 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/man/rabbitmq.5 @@ -0,0 +1,186 @@ +.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "rabbitmq 5" +.TH rabbitmq 5 "2008-12-17" "" "RabbitMQ AMQP Server" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +/etc/conf.d/rabbitmq \- default settings for RabbitMQ AMQP server +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +/etc/conf.d/rabbitmq contains variable settings that override the +defaults built in to the RabbitMQ startup scripts. +.PP +The file is interpreted by the system shell, and so should consist of +a sequence of shell environment variable definitions. Normal shell +syntax is permitted (since the file is sourced using the shell \*(L".\*(R" +operator), including line comments starting with \*(L"#\*(R". +.PP +In order of preference, the startup scripts get their values from the +environment, from /etc/conf.d/rabbitmq, and finally from the built-in +default values. For example, for the \fB\s-1RABBITMQ_NODENAME\s0\fR setting, +.PP +\&\fB\s-1RABBITMQ_NODENAME\s0\fR + from the environment is checked first. If it is absent or equal + to the empty string, then +.PP +\&\fB\s-1NODENAME\s0\fR + from /etc/conf.d/rabbitmq is checked next. If it is also absent + or set equal to the empty string, then the default value from the + startup script is used. +.PP +The variable names in /etc/conf.d/rabbitmq are always equal to the +environment variable names, with the \fB\s-1RABBITMQ_\s0\fR prefix removed: +\&\fB\s-1RABBITMQ_NODE_PORT\s0\fR from the environment becomes \fB\s-1NODE_PORT\s0\fR in the +/etc/conf.d/rabbitmq file, etc. +.SH "EXAMPLES" +.IX Header "EXAMPLES" +The following is an example of a complete /etc/conf.d/rabbitmq file +that overrides the default Erlang node name from \*(L"rabbit\*(R" to \*(L"hare\*(R": +.PP +.Vb 4 +\& # I am a complete /etc/conf.d/rabbitmq file. +\& # Comment lines start with a hash character. +\& # This is a /bin/sh script file \- use ordinary envt var syntax +\& NODENAME=hare +.Ve +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIrabbitmq\-server\fR\|(1), \fIrabbitmq\-multi\fR\|(1), \fIrabbitmqctl\fR\|(1) +.SH "AUTHOR" +.IX Header "AUTHOR" +Originally written by The RabbitMQ Team <info@lshift.net> +.SH "COPYRIGHT" +.IX Header "COPYRIGHT" +This package, the RabbitMQ server is licensed under the \s-1MPL\s0. +.PP +If you have any questions regarding licensing, please contact us at +info@rabbitmq.com. +.SH "REFERENCES" +.IX Header "REFERENCES" +RabbitMQ Web Site: http://www.rabbitmq.com diff --git a/packaging/gentoo/files/1.5.0/man/rabbitmqctl.1 b/packaging/gentoo/files/1.5.0/man/rabbitmqctl.1 new file mode 100644 index 00000000..7032c799 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/man/rabbitmqctl.1 @@ -0,0 +1,421 @@ +.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "rabbitmqctl 1" +.TH rabbitmqctl 1 "2008-12-17" "" "RabbitMQ AMQP Server" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +rabbitmqctl \- command line tool for managing a RabbitMQ broker +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +rabbitmqctl [\-n \fInode\fR] \fI<command\fR> [command options] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +RabbitMQ is an implementation of \s-1AMQP\s0, the emerging standard for high +performance enterprise messaging. The RabbitMQ server is a robust and +scalable implementation of an \s-1AMQP\s0 broker. +.PP +rabbitmqctl is a command line tool for managing a RabbitMQ broker. +It performs all actions by connecting to one of the broker's nodes. +.SH "OPTIONS" +.IX Header "OPTIONS" +\&\fB\-n\fR \fInode\fR + default node is \f(CW\*(C`rabbit@server\*(C'\fR, where server is the local host. + On a host named \f(CW\*(C`server.example.com\*(C'\fR, the node name of the + RabbitMQ Erlang node will usually be rabbit@server (unless + \s-1RABBITMQ_NODENAME\s0 has been set to some non-default value at broker + startup time). The output of hostname \-s is usually the correct + suffix to use after the \*(L"@\*(R" sign. See \fIrabbitmq\-server\fR\|(1) for + details of configuring the RabbitMQ broker. +.PP +\&\fB\-q\fR + quiet output mode is selected with the \fB\-q\fR flag. Informational + messages are suppressed when quiet mode is in effect. +.SH "COMMANDS" +.IX Header "COMMANDS" +.SS "\s-1APPLICATION\s0 \s-1AND\s0 \s-1CLUSTER\s0 \s-1MANAGEMENT\s0" +.IX Subsection "APPLICATION AND CLUSTER MANAGEMENT" +stop + stop the Erlang node on which RabbitMQ broker is running. +.PP +stop_app + stop the RabbitMQ application, leaving the Erlang node running. + This command is typically run prior to performing other management + actions that require the RabbitMQ application to be stopped, + e.g. \fIreset\fR. +.PP +start_app + start the RabbitMQ application. + This command is typically run prior to performing other management + actions that require the RabbitMQ application to be stopped, + e.g. \fIreset\fR. +.PP +status + display various information about the RabbitMQ broker, such as + whether the RabbitMQ application on the current node, its version + number, what nodes are part of the broker, which of these are + running. +.PP +force + return a RabbitMQ node to its virgin state. + Removes the node from any cluster it belongs to, removes all data + from the management database, such as configured users, vhosts and + deletes all persistent messages. +.PP +force_reset + the same as \fIforce\fR command, but resets the node unconditionally, + regardless of the current management database state and cluster + configuration. + It should only be used as a last resort if the database or cluster + configuration has been corrupted. +.PP +rotate_logs [suffix] + instruct the RabbitMQ node to rotate the log files. The RabbitMQ + broker will attempt to append the current contents of the log file + to the file with the name composed of the original name and the + suffix. It will create a new file if such a file does not already + exist. When no \fIsuffix\fR is specified, the empty log file is + simply created at the original location; no rotation takes place. + When an error occurs while appending the contents of the old log + file, the operation behaves in the same way as if no \fIsuffix\fR was + specified. + This command might be helpful when you are e.g. writing your own + logrotate script and you do not want to restart the RabbitMQ node. +.PP +cluster \fIclusternode\fR ... + instruct the node to become member of a cluster with the specified + nodes determined by \fIclusternode\fR option(s). + See http://www.rabbitmq.com/clustering.html for more information + about clustering. +.SS "\s-1USER\s0 \s-1MANAGEMENT\s0" +.IX Subsection "USER MANAGEMENT" +add_user \fIusername\fR \fIpassword\fR + create a user named \fIusername\fR with (initial) password \fIpassword\fR. +.PP +change_password \fIusername\fR \fInewpassword\fR + change the password for the user named \fIusername\fR to \fInewpassword\fR. +.PP +list_users + list all users. +.SS "\s-1ACCESS\s0 \s-1CONTROL\s0" +.IX Subsection "ACCESS CONTROL" +add_vhost \fIvhostpath\fR + create a new virtual host called \fIvhostpath\fR. +.PP +delete_vhost \fIvhostpath\fR + delete a virtual host \fIvhostpath\fR. + That command deletes also all its exchanges, queues and user mappings. +.PP +list_vhosts + list all virtual hosts. +.PP +map_user_vhost \fIusername\fR \fIvhostpath\fR + grant the user named \fIusername\fR access to the virtual host called + \fIvhostpath\fR. +.PP +unmap_user_vhost \fIusername\fR \fIvhostpath\fR + deny the user named \fIusername\fR access to the virtual host called + \fIvhostpath\fR. +.PP +list_user_vhost \fIusername\fR + list all the virtual hosts to which the user named \fIusername\fR has + been granted access. +.SS "\s-1SERVER\s0 \s-1STATUS\s0" +.IX Subsection "SERVER STATUS" +list_queues [\-p \fIvhostpath\fR] [\fIqueueinfoitem\fR ...] + list queue information by virtual host. If no \fIqueueinfoitem\fRs + are specified then then name and number of messages is displayed + for each queue. +.PP +\fIQueue information items\fR +.IX Subsection "Queue information items" +.Sp +.RS 4 +name + URL-encoded name of the queue +.Sp +durable + whether the queue survives server restarts +.Sp +auto_delete + whether the queue will be deleted when no longer used +.Sp +arguments + queue arguments +.Sp +pid + Erlang process identifier associated with the queue +.Sp +messages_ready + number of ready messages +.Sp +messages_unacknowledged + number of unacknowledged messages +.Sp +messages_uncommitted + number of uncommitted messages +.Sp +messages + sum of ready, unacknowledged and uncommitted messages +.Sp +acks_uncommitted + number of uncommitted acknowledgements +.Sp +consumers + number of consumers +.Sp +transactions + number of transactions +.Sp +memory + bytes of memory consumed by the Erlang process for the queue, + including stack, heap and internal structures +.RE +.PP +list_exchanges [\-p \fIvhostpath\fR] [\fIexchangeinfoitem\fR ...] + list exchange information by virtual host. If no + \fIexchangeinfoitem\fRs are specified then name and type is displayed + for each exchange. +.PP +\fIExchange information items\fR +.IX Subsection "Exchange information items" +.Sp +.RS 4 +name + URL-encoded name of the exchange +.Sp +type + exchange type (\fBdirect\fR, \fBtopic\fR or \fBfanout\fR) +.Sp +durable + whether the exchange survives server restarts +.Sp +auto_delete + whether the exchange is deleted when no longer used +.Sp +arguments + exchange arguments +.RE +.PP +list_bindings [\-p \fIvhostpath\fR] + list bindings by virtual host. Each line contains exchange name, + routing key and queue name (all \s-1URL\s0 encoded) and arguments. +.PP +list_connections [\fIconnectioninfoitem\fR ...] + list connection information. If no \fIconnectioninfoitem\fRs are + specified then the user, peer address and peer port are displayed. +.PP +\fIConnection information items\fR +.IX Subsection "Connection information items" +.Sp +.RS 4 +pid + Erlang process id associated with the connection +.Sp +address + server \s-1IP\s0 number +.Sp +port + server port +.Sp +peer_address + peer address +.Sp +peer_port + peer port +.Sp +state + connection state (\fBpre-init\fR, \fBstarting\fR, \fBtuning\fR, \fBopening\fR, + \fBrunning\fR, \fBclosing\fR, \fBclosed\fR) +.Sp +channels + number of channels using the connection +.Sp +user + username associated with the connection +.Sp +vhost + URL-encoded virtual host +.Sp +timeout + connection timeout +.Sp +frame_max + maximum frame size (bytes) +.Sp +recv_oct + octets received +.Sp +recv_cnt + packets received +.Sp +send_oct + octets sent +.Sp +send_cnt + packets sent +.Sp +send_pend + send queue size +.RE +.PP +The list_queues, list_exchanges and list_bindings commands accept an +optional virtual host parameter for which to display results, defaulting +to \fI\*(L"/\*(R"\fR. The default can be overridden with the \fB\-p\fR flag. Result +columns for these commands and list_connections are tab-separated. +.SH "EXAMPLES" +.IX Header "EXAMPLES" +Create a user named foo with (initial) password bar at the Erlang node +rabbit@test: +.PP +.Vb 1 +\& rabbitmqctl \-n rabbit@test add_user foo bar +.Ve +.PP +Grant user named foo access to the virtual host called test at the +default Erlang node: +.PP +.Vb 1 +\& rabbitmqctl map_user_vhost foo test +.Ve +.PP +Append the current logs' content to the files with \*(L".1\*(R" suffix and reopen +them: +.PP +.Vb 1 +\& rabbitmqctl rotate_logs .1 +.Ve +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIrabbitmq\-multi\fR\|(1), \fIrabbitmq\-server\fR\|(1) +.SH "AUTHOR" +.IX Header "AUTHOR" +The RabbitMQ Team <info@rabbitmq.com> +.SH "REFERENCES" +.IX Header "REFERENCES" +RabbitMQ Web Site: http://www.rabbitmq.com diff --git a/packaging/gentoo/files/1.5.0/misc/rabbitmq-invoke b/packaging/gentoo/files/1.5.0/misc/rabbitmq-invoke new file mode 100644 index 00000000..53c954f5 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/misc/rabbitmq-invoke @@ -0,0 +1,70 @@ +#!/bin/sh +## The contents of this file are subject to the Mozilla Public License +## Version 1.1 (the "License"); you may not use this file except in +## compliance with the License. You may obtain a copy of the License at +## http://www.mozilla.org/MPL/ +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the +## License for the specific language governing rights and limitations +## under the License. +## +## The Original Code is RabbitMQ. +## +## The Initial Developers of the Original Code are LShift Ltd, +## Cohesive Financial Technologies LLC, and Rabbit Technologies Ltd. +## +## Portions created before 22-Nov-2008 00:00:00 GMT by LShift Ltd, +## Cohesive Financial Technologies LLC, or Rabbit Technologies Ltd +## are Copyright (C) 2007-2008 LShift Ltd, Cohesive Financial +## Technologies LLC, and Rabbit Technologies Ltd. +## +## Portions created by LShift Ltd are Copyright (C) 2007-2009 LShift +## Ltd. Portions created by Cohesive Financial Technologies LLC are +## Copyright (C) 2007-2009 Cohesive Financial Technologies +## LLC. Portions created by Rabbit Technologies Ltd are Copyright +## (C) 2007-2009 Rabbit Technologies Ltd. +## +## All Rights Reserved. +## +## Contributor(s): ______________________________________. +## + +# +# Gentoo specific wrapper script for rabbitmq-multi to allow creation of logs with correct ownership + +# rabbitmq-1.5.0-r1 installs to this location +DAEMON=/usr/sbin/rabbitmq-multi + + # we need this script installed correctly for us to work + if [ ! -x "${DAEMON}" ] ; + then + echo "Error can't locate `basename $DAEMON` under `dirname $DAEMON`" + exit `false` + fi + + # output directed to stdout gets logged to this file + info_log=$1 + shift 1 + if [ -z "${info_log}" ] ; + then + echo "Usage `basename $0` [--background] output-log error-log" + exit `false` + fi + + # output directed to stderr gets logged to this file + error_log=$1 + shift 1 + if [ -z "${error_log}" ] ; + then + echo "Usage `basename $0` [--background] output-log error-log" + exit `false` + fi + + # duplicate stdin/stderr to logs and screen + ( ( ( \ + ${DAEMON} $* \ + 3>&1 1>&2 2>&1 \ + ) | tee ${info_log} \ + ) 3>&2 2>&1 1>&3 | tee ${error_log} \ + ) diff --git a/packaging/gentoo/files/1.5.0/patches/0001-change-conf-dir.patch b/packaging/gentoo/files/1.5.0/patches/0001-change-conf-dir.patch new file mode 100644 index 00000000..9b3f5501 --- /dev/null +++ b/packaging/gentoo/files/1.5.0/patches/0001-change-conf-dir.patch @@ -0,0 +1,24 @@ +diff -rNup scripts/rabbitmq-multi scripts-new/rabbitmq-multi +--- scripts/rabbitmq-multi 2008-12-17 18:38:14.000000000 +0000 ++++ scripts-new/rabbitmq-multi 2008-12-24 18:13:15.000000000 +0000 +@@ -30,7 +30,7 @@ + ## Contributor(s): ______________________________________. + ## + +-[ -f /etc/default/rabbitmq ] && . /etc/default/rabbitmq ++[ -f /etc/conf.d/rabbitmq ] && . /etc/conf.d/rabbitmq + + [ "x" = "x$RABBITMQ_NODENAME" ] && RABBITMQ_NODENAME=${NODENAME} + [ "x" = "x$RABBITMQ_NODENAME" ] && RABBITMQ_NODENAME=rabbit +diff -rNup scripts/rabbitmq-server scripts-new/rabbitmq-server +--- scripts/rabbitmq-server 2008-12-17 18:38:14.000000000 +0000 ++++ scripts-new/rabbitmq-server 2008-12-24 18:13:15.000000000 +0000 +@@ -30,7 +30,7 @@ + ## Contributor(s): ______________________________________. + ## + +-[ -f /etc/default/rabbitmq ] && . /etc/default/rabbitmq ++[ -f /etc/conf.d/rabbitmq ] && . /etc/conf.d/rabbitmq + + [ "x" = "x$RABBITMQ_NODENAME" ] && RABBITMQ_NODENAME=${NODENAME} + [ "x" = "x$RABBITMQ_NODENAME" ] && RABBITMQ_NODENAME=rabbit diff --git a/packaging/gentoo/metadata.xml b/packaging/gentoo/metadata.xml new file mode 100644 index 00000000..fe4b71e1 --- /dev/null +++ b/packaging/gentoo/metadata.xml @@ -0,0 +1,20 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> +<pkgmetadata> + <herd>no-herd</herd> + + <use> + <flag name='doc'>Install rabbitmq docs</flag> + </use> + + <maintainer> + <email>jamal@lshift.net</email> + <name>Jamal Natour</name> + </maintainer> + + <longdescription lang="en"> + This package provides RabbitMQ, an server implementation of AMQP. + AMQP is the emerging standard for high performance enterprise messaging. + http://www.rabbitmq.com/faq.html#what-is-amqp + </longdescription> +</pkgmetadata> diff --git a/packaging/gentoo/rabbitmq-server-1.5.0-r1.ebuild b/packaging/gentoo/rabbitmq-server-1.5.0-r1.ebuild new file mode 100644 index 00000000..b8d01004 --- /dev/null +++ b/packaging/gentoo/rabbitmq-server-1.5.0-r1.ebuild @@ -0,0 +1,175 @@ +# copyright 1999-2008 gentoo foundation +# distributed under the terms of the gnu general public license v2 +# $header: $ + +inherit eutils +DESCRIPTION="RabbitMQ is a high-performance AMQP-compliant message broker written in Erlang." +HOMEPAGE="http://www.rabbitmq.com/" +SRC_URI="http://www.rabbitmq.com/releases/${PN}/v${PV}/${P}.tar.gz" +LICENSE="MPL" +SLOT="0" +KEYWORDS="~alpha amd64 ~ppc ~ppc64 ~sparc x86" +IUSE="+docs" + +# runtime time deps +RDEPEND="dev-lang/erlang + app-admin/logrotate" + +# build time deps +DEPEND="dev-lang/erlang + dev-python/simplejson" + +src_install() +{ +# Erlang module + einfo "Installing rabbit erlang module" + local targetdir="/usr/$(get_libdir)/erlang/lib/${P}" + dodir "${targetdir}" \ + || die "failed to create ${targetdir} for ${P}" + + cp -dpr ${S}/ebin ${S}/include "${D}/${targetdir}" \ + || die "failed to install erlang module for ${P}" + + fperms 700 ${targetdir} \ + || die "failed to chmod erlang module for ${P}" + + fowners rabbitmq:rabbitmq ${targetdir} \ + || die "failed to chown erlang module for ${P}" + +# Server scripts + einfo "Installing rabbit scripts" + cd ${S}/scripts + dosbin ${PN/server/multi} \ + || die "failed to install rabbitmq-multi for ${P}" + dosbin ${PN} \ + || die "failed to install rabbitmq-server for ${P}" + dosbin ${PN/-server/ctl} \ + || die "failed to install rabbitmqctl for ${P}" + dosbin ${FILESDIR}/${PV}/misc/${PN/server/invoke} \ + || die "failed to install rabbitmq-invoke for ${P}" + +# Docs + if use docs; then + einfo "Installing rabbit docs" + cd ${S} + dodoc INSTALL LICENSE LICENSE-MPL-RabbitMQ \ + || die "Failed when installing rabbit docs" + fi + +# Man pages + einfo "installing rabbit man pages" + doman ${FILESDIR}/${PV}/man/${PN/server/multi.1} \ + || die "Install of rabbitmq-multi manpage failed" + + doman ${FILESDIR}/${PV}/man/${PN/server/server.1} \ + || die "Install of rabbitmq-server manpage failed" + + doman ${FILESDIR}/${PV}/man/${PN/-server/.5} \ + || die "Install of rabbitmq manpage failed" + + doman ${FILESDIR}/${PV}/man/${PN/-server/ctl.1} \ + || die "Install of rabbitmqctl manpage failed" + +# Server configuration + einfo "Installing rabbit configuration" + local fname=${PN/server/cluster.example} + newconfd ${FILESDIR}/${PV}/init.d/${PN}.confd ${PN} \ + || die "failed to install conf.d file for ${P}" + +# Example clustering configuration + einfo "Installing example rabbit cluster configuration" + newconfd ${FILESDIR}/${PV}/init.d/${fname}.confd ${fname} \ + || die "failed to install ${fname} for ${P}" + +# Server init.d runscript + einfo "Installing rabbit init.d script" + newinitd ${FILESDIR}/${PV}/init.d/${PN}.initd ${PN} || die "failed to install init.d script for ${P}" + +# Log rotation script + einfo "Installing rabbit logrotate configuration" + insinto /etc/logrotate.d/ + doins ${FILESDIR}/${PV}/logrotate.d/${PN} || die "failed to install logrotate.d file for ${P}" + +# Log directory + dodir "/var/log/rabbitmq" \ + || die "failed to create log directory for ${P}" + + dodir /var/lib/rabbitmq \ + || die "couldn't create mnesia home" + +# mnesia + einfo "fixing user permissions for rabbitmq" + fperms 700 /var/lib/rabbitmq \ + || die "couldn't chmod mnesia home" + + fowners rabbitmq:rabbitmq /var/lib/rabbitmq \ + || die "couldn't chown mnesia home" + +# rabbit logs + einfo "fixing user permissions for rabbitmq logs" + fperms 700 /var/log/rabbitmq \ + || die "couldn't chmod rabbitmq log base" + + fowners rabbitmq:rabbitmq /var/log/rabbitmq \ + || die "couldn't chown rabbitmq log base" + +# rabbit home + einfo "fixing user permissions for rabbitmq home" + dodir /var/tmp/rabbitmq \ + || die "couldn't create rabbitmq home" + fperms 700 /var/tmp/rabbitmq \ + || die "couldn't chmod rabbitmq home" + + fowners rabbitmq:rabbitmq /var/tmp/rabbitmq \ + || die "couldn't chown rabbitmq home" +} + +unpack() +{ + unpack ${A} \ + || die "failed to unpack ${A}" + +} + +src_compile() +{ + einfo "Compiling rabbitmq-server" + cd "${S}" + # fix: change script includes to use files in /etc/conf.d + epatch ${FILESDIR}/${PV}/patches/0001-change-conf-dir.patch \ + || die "failed to patch ${S}" + emake clean || die "failed to clean ${P}" + emake || die "failed to make ${P}" +} + +pkg_setup() +{ + # add rabbitmq user and group so we can run as a nologin user + einfo "adding rabbitmq group" + enewgroup rabbitmq \ + || die "couldn't create rabbitmq group" + + # rabbit requires a writeable home directory + einfo "adding rabbitmq user" + enewuser rabbitmq -1 -1 /var/tmp/rabbitmq rabbitmq \ + || die "couldn't create rabbitmq user" +} + +pkg_postinst() +{ + # tell user this is not an offical ebuild + ewarn "IMPORTANT:" + ewarn "This is an unofficial ebuild for RabbitMQ (server) " + ewarn "If you encounter any problems, do NOT file bugs to gentoo" + ewarn "bugzilla. Instead, post into this ebuild's topic on the" + ewarn "Gentoo Bugzilla list" + ewarn + ewarn "link:" + ewarn "http://bugs.gentoo.org/show_bug.cgi?id=192278" + + # explain how to run as daemon + elog "You can configure RabbitMQ to run as a daemon by running:" + elog + elog "rc-update add rabbitmq-server default" + elog +} diff --git a/packaging/gentoo/rabbitmq-server-1.5.0.ebuild b/packaging/gentoo/rabbitmq-server-1.5.0.ebuild new file mode 100644 index 00000000..9aa7ae4b --- /dev/null +++ b/packaging/gentoo/rabbitmq-server-1.5.0.ebuild @@ -0,0 +1,39 @@ +# Copyright 1999-2008 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 +# $Header: $ + +inherit eutils + +DESCRIPTION="RabbitMQ is a high-performance AMQP-compliant message broker written in Erlang." +HOMEPAGE="http://www.rabbitmq.com/" +SRC_URI="http://www.rabbitmq.com/releases/rabbitmq-server/v${PV}/rabbitmq-server-generic-unix-${PV}.tar.gz" +LICENSE="MPL" +SLOT="0" +KEYWORDS="~alpha ~amd64 ~ppc ~ppc64 ~sparc ~x86" +IUSE="" + +# Q: is RDEPEND-only sufficient for a binary package, since we don't compile? +DEPEND="dev-lang/erlang" +RDEPEND="${DEPEND}" + +# grr: the packaged directory contains an underscore +MODNAME="rabbitmq_server-${PV}" +S="${WORKDIR}/${MODNAME}" + +src_install() { + # erlang module + local targetdir="/usr/$(get_libdir)/erlang/lib/${MODNAME}" + dodir "${targetdir}" + cp -dpR ebin include "${D}/${targetdir}" + + # scripts + dosbin sbin/* + + # docs + dodoc INSTALL LICENSE LICENSE-MPL-RabbitMQ + + # TODO: + # config to set env vars as per INSTALL? + # set LOGDIR to /var/log/rabbitmq.log + # run as different user? +} |