Rabbit MQ

RabbitMQ is used as the message broker by X360. A running RabbitMQ service is mandatory for installations and updates. RabbitMQ has a dependency to Erlang, therefore as a prerequisite, Erlang must be installed first.

• Erlang 26.2.5

• RabbitMQ 3.13.7

Installation Details and Troubleshooting

Erlang Cookie

RabbitMQ uses an Erlang cookie for authentication between nodes. The Erlang cookie file is located at C:\Windows\System32\config\systemprofile\.erlang.cookie. RabbitMQ uses a copy of this file located at C:\Users\<User>\.erlang.cookie. The contents of both files must be identical for RabbitMQ to function correctly.

Uninstall (cleanup) RabbitMQ and Erlang

To uninstall RabbitMQ and Erlang, follow the steps below:

1. Uninstall first via choco (choco unintall erlang, and then choco uninstall rabbitmq)

2. Make sure it doesn’t show up any more under “Add & Remove Programs”, if they are still listed, uninstall from there as well.

3. Kill any running epmd.exe process from Task Manager.

4. Delete the following files and folders if they still exist: * C:\Program Files\RabbitMQ Server * C:\Program Files\Erlang OTP * C:\ProgramData\RabbitMQ * C:\Users\<User>\AppData\Roaming\RabbitMQ * C:\Users\<User>\.erlang.cookie

rabbitmqctl status command

To check the status of the RabbitMQ service, you can use the following command in the command prompt (under the RabbitMQ sbin directory): .. code-block:: bash

rabbitmqctl status

The output will provide information about the RabbitMQ server status, including whether it is running and other relevant details.

Repair RabbitMQ action item

In case RabbitMQ is not functioning correctly, you can use the Repair RabbitMQ action item located in the RabbitMQ box in the Dependencies page of the X360 Developer Tool. This action will attempt to fix common issues with RabbitMQ by ensuring that all configurations are correct.

If the repair action does not resolve the issue, consider uninstalling and reinstalling RabbitMQ and Erlang as described in the uninstall section above.

Prior X360 instances to RabbitMQ installations

If you have existing X360 instances that were set up before RabbitMQ was installed, these instances might not work any more and you may need to migrate your configurations to work with RabbitMQ. In such cases, please refer to the X360 documentation or contact support for assistance with migrating your existing instances to be compatible with RabbitMQ.

IIS Configuration

Application Settings