summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTim Watson <tim@rabbitmq.com>2013-08-20 11:38:39 +0100
committerTim Watson <tim@rabbitmq.com>2013-08-20 11:38:39 +0100
commitb04a84abceb6a95f5fee5d99c9501a23f4e174b1 (patch)
tree40356ff8c580b2dfbf37ddad28cd2e6e78b097ba
parentab9845cd60f2912e3a13702590470f81ed213101 (diff)
downloadrabbitmq-server-b04a84abceb6a95f5fee5d99c9501a23f4e174b1.tar.gz
additional comments in the sample config file
-rw-r--r--docs/rabbitmq.sample.config37
1 files changed, 31 insertions, 6 deletions
diff --git a/docs/rabbitmq.sample.config b/docs/rabbitmq.sample.config
index 69fdb0a1..3cbfdc7a 100644
--- a/docs/rabbitmq.sample.config
+++ b/docs/rabbitmq.sample.config
@@ -7,10 +7,10 @@
%% Network Connectivity
%%
- %% AMQP listen on ports
+ %% Configure AMQP to listen on ports
{tcp_listeners, [5672, 5673]},
- %% SSL (AMQP) listen on ports
+ %% Configure SSL (AMQP) to listen on ports
{ssl_listeners, [5674, 5675]},
%% SSL options
@@ -166,9 +166,10 @@
%% ----------------------------------------------------------------------------
{rabbitmq_shovel,
- [{shovels, [{my_first_shovel,
+ [{shovels, [%% a named shovel worker
+ {my_first_shovel,
[{sources,
- %% Setting SSL Options via the connection string
+ %% Setting SSL Options via connection string
[{brokers, ["amqps://username:password@host:port/vhost?"
"cacertfile=/path/to/cacert.pem"
"&certfile=/path/to/certfile.pem"
@@ -176,10 +177,13 @@
"&verify=verify_peer"
"&fail_if_no_peer_cert=true",
- %% Tuning connection via the connection string
+ %% Tuning connections via connection string
"amqp://john:secret@host2.domain/my_vhost"
"?heartbeat=5&frame_max=8192"
]},
+
+ %% AMQP objects that we want to ensure are present
+ %% on the source broker(s)
{declarations,
[ {'exchange.declare',
[{exchange, <<"my_fanout">>},
@@ -191,18 +195,39 @@
[{exchange, <<"my_direct">>}, {queue,<<>>}]}
]}
]},
+
{destinations,
- [{broker, "amqp://"},
+ [%% a singular version of the 'brokers' configuration element
+ {broker, "amqp://"},
+
+ %% declarations we want to ensure are present on
+ %% the destination broker(s)
{declarations, [{'exchange.declare',
[{exchange, <<"my_direct">>},
{type, <<"direct">>}, durable]}]}
]},
+
+ %% name of the queue to shovel messages from
{queue, <<>>},
+
+ %% optional prefetch count
{prefetch_count, 10},
+
+ %% when to acknowledge messages:
+ %% - no_ack: never (auto)
+ %% - on_publish: after each message is republished
+ %% - on_confirm: when the destination broker confirms receipt
{ack_mode, on_confirm},
+
+ %% static list of basic.properties to set on re-publication
{publish_properties, [{delivery_mode, 2}]},
+
+ %% overwrite fields of the outbound basic.publish
{publish_fields, [{exchange, <<"my_direct">>},
{routing_key, <<"from_shovel">>}]},
+
+ %% the number of seconds to wait before attempting to
+ %% reconnect in the event of a connection failure
{reconnect_delay, 2.5}
]}
]}]},