Troubleshooting

Checking Broker Status

You can use rabbitmqctl status to verify whether a broker is running.
Normal output from a running broker without plugins follows this pattern:

  Status of node 'rabbit@xxx' ...
  [{pid,...},
   {running_applications,[{rabbit,"RabbitMQ","2.8.1"},
                          {os_mon,"..."},
                          {sasl,"..."},
                          {mnesia,"..."},
                          {stdlib,"..."},
                          {kernel,"..."},
  {os,"..."},
  {erlang_version,"..."},
  {memory,"..."}}]

This example indicates that no broker is running:

  Status of node 'rabbit@xxx' ...
  Error: unable to connect to node 'rabbit@xxx': nodedown
  diagnostics:
  - nodes and their ports on xxx: [{rabbitmqctl,...}]
  - current node: 'rabbitmqctlxxx@xxx'
  - current node home dir: [...]
  - current node cookie hash: [...]
If the diagnostic line looks like this:
  - nodes and their ports on xxx: [{rabbit,...},{rabbitmqctl,...}]
and the broker logfile contains entries similar to
  Connection attempt from disallowed node...
then you should make sure the erlang cookies are the same.

Server Fails to Start

When the server fails to start, usually a crash dump file erl_crash.dump is created in the directory where the server was started. This can provide very detailed information on the causes of a start up failure, but its analysis requires Erlang expertise.

If you attempt to start another server while a broker is already running, then you will receive an error report. You can confirm whether the broker is already running by checking the status.

If the server fails to start, examine the console output and the log files in the RABBITMQ_LOG_BASE directory. Configuration and permission errors are frequently the cause, e.g. the Mnesia directory cannot be created.

Windows Service fails to Install
If the service fails to install, check the service account has full access permission for RABBITMQ_BASE, RABBITMQ_MNESIA_BASE and RABBITMQ_LOG_BASE directories [XP, Vista].
Windows Service fails to Start

If the service fails to start, make sure the service has been installed.

On starting the service, if the service output reads "The process terminated unexpectedly" instead, then the service did not start correctly. Check that the environment variables are set correctly. The logfiles in RABBITMQ_BASE may also contain useful diagnostic information.

Plugin fails to activate

If a plugin fails to activate, check the output of rabbitmq-plugins list. Windows service users need to take additional steps when changing plugins.

If the server is not behaving as expected during operation, examine the log files and use the rabbitmqctl commands from the admin guide to obtain further information on the server status.

For problems encountered in the handling of AMQP traffic, the AMQP capture and analysis tool may help in the analysis.

Failing that, it's possible that we've solved the problem for someone else. Try using the search box at the top of our web pages to find site, mailing list and blog information. You might also check our mailing list archives.

If you still can't find a solution to your problem then please post a new message to rabbitmq-discuss@lists.rabbitmq.com (you may have to join the mailing list first). Let us know what you were trying to do, the error you received and relevant entries from the logfile and one of our engineers will help you get it fixed.