~ubuntu-branches/ubuntu/trusty/drizzle/trusty

The RabbitMQ applier plugin, named ``rabbitmq``, applies replication events to a `RabbitMQ <http://www.rabbitmq.com>`_ server. This can be used to create advanced replication solutions, to visualize data, or to build triggers.

-------

To load this plugin, start :program:`drizzled` with::

--plugin-add=rabbitmq

Loading the plugin may not enable or configure it. See the plugin's

:ref:`rabbitmq_configuration` and :ref:`rabbitmq_variables`.

.. seealso:: :ref:`drizzled_plugin_options` for more information about adding and removing plugins.

.. _rabbitmq_configuration:

Configuration

-------------

These command line options configure the plugin when :program:`drizzled`

is started. See :ref:`command_line_options` for more information about

specifying command line options.

.. program:: drizzled

.. option:: --rabbitmq.exchange ARG

:Default: ReplicationExchange

:Variable: :ref:`rabbitmq_exchange <rabbitmq_exchange>`

Name of RabbitMQ exchange to publish to

.. option:: --rabbitmq.host ARG

:Default: localhost

:Variable: :ref:`rabbitmq_host <rabbitmq_host>`

Host name to connect to

.. option:: --rabbitmq.password ARG

:Default: guest

:Variable: :ref:`rabbitmq_password <rabbitmq_password>`

RabbitMQ password

.. option:: --rabbitmq.port ARG

:Default: 5672

:Variable: :ref:`rabbitmq_port <rabbitmq_port>`

Port to connect to

.. option:: --rabbitmq.routingkey ARG

:Default: ReplicationRoutingKey

:Variable: :ref:`rabbitmq_routingkey <rabbitmq_routingkey>`

Name of RabbitMQ routing key to use

.. option:: --rabbitmq.use-replicator ARG

:Default: default_replicator

:Variable:

Name of the replicator plugin to use (default='default_replicator')

.. option:: --rabbitmq.username ARG

:Default: guest

:Variable: :ref:`rabbitmq_username <rabbitmq_username>`

RabbitMQ username

.. option:: --rabbitmq.virtualhost ARG

:Default: /

:Variable: :ref:`rabbitmq_virtualhost <rabbitmq_virtualhost>`

RabbitMQ virtualhost

.. _rabbitmq_variables:

Variables

---------

These variables show the running configuration of the plugin.

See `variables` for more information about querying and setting variables.

.. _rabbitmq_exchange:

* ``rabbitmq_exchange``

:Scope: Global

100

:Dynamic: No

101

:Option: :option:`--rabbitmq.exchange`

102

103

Name of RabbitMQ exchange to publish to

104

105

.. _rabbitmq_host:

106

107

* ``rabbitmq_host``

108

109

:Scope: Global

110

:Dynamic: No

111

:Option: :option:`--rabbitmq.host`

112

113

Host name to connect to

114

115

.. _rabbitmq_password:

116

117

* ``rabbitmq_password``

118

119

:Scope: Global

120

:Dynamic: No

121

:Option: :option:`--rabbitmq.password`

122

123

RabbitMQ password

124

125

.. _rabbitmq_port:

126

127

* ``rabbitmq_port``

128

129

:Scope: Global

130

:Dynamic: No

131

:Option: :option:`--rabbitmq.port`

132

133

Port to connect to

134

135

.. _rabbitmq_routingkey:

136

137

* ``rabbitmq_routingkey``

138

139

:Scope: Global

140

:Dynamic: No

141

:Option: :option:`--rabbitmq.routingkey`

142

143

Name of RabbitMQ routing key to use

144

145

.. _rabbitmq_username:

146

147

* ``rabbitmq_username``

148

149

:Scope: Global

150

:Dynamic: No

151

:Option: :option:`--rabbitmq.username`

152

153

RabbitMQ username

154

155

.. _rabbitmq_virtualhost:

156

157

* ``rabbitmq_virtualhost``

158

159

:Scope: Global

160

:Dynamic: No

161

:Option: :option:`--rabbitmq.virtualhost`

162

163

RabbitMQ virtualhost

164

165

166

Implementation Details

167

----------------------

168

169

* :program:`drizzled` will not sart if the rabbitmq server is not available.

170

* If the rabbitmq server goes away, the plugin will try to reconnect and resend the message 3 times, after that, the transaction is rolled back.

171

172

.. _rabbitmq_version:

173

174

Version

175

-------

176

177

This documentation applies to :ref:`rabbitmq_0.1_drizzle_7.0`.

178

179

To see which version of the ``rabbitmq`` plugin a Drizzle server is running,

180

execute:

181

182

.. code-block:: mysql

183

184

SELECT MODULE_VERSION FROM DATA_DICTIONARY.MODULES WHERE MODULE_NAME='rabbitmq'

185

186

Changelog

187

---------

188

189

.. toctree::

190

:maxdepth: 2

191

192

rabbitmq/changelog

193

194

.. _rabbitmq_authors:

195

196

Authors

197

-------

198

199

Marcus Eriksson

Older »