How to Uninstall and Reinstall RabbitMQ in Retail Pro Prism 2.3 and 2.4

Scenario:

In certain cases, users may be unable to start the RabbitMQ service. When this occurs, the only workaround is to uninstall and reinstall RabbitMQ by reinstalling the Prism server.

Note: This process should only be followed if instructed by the Retail Pro technical support team.

Uninstall RabbitMQ

1. Back Up Files
   • Back up the following directories from the ProgramData\RetailPro folder:
     • \confs
     • \WebClient
     • \Modules
   • Back up the Apache\Conf directory from the Apache folder.
2. Stop RabbitMQ Service
   Stop the RabbitMQ service through the Services console.

3. Uninstall RabbitMQ and Erlang
Uninstall the following programs:

• RabbitMQ Server 3.12.10
• Erlang OTP 26.1.2 (14.1.1)

4. Delete/Rename Folders

• Delete or rename the RabbitMQ Server folder (if present) in C:\Program Files (x86).
• Delete or rename the erl14.1.1 folder (if present) in C:\Program Files.

5. Remove Registry Entries

Open Registry Editor (always export keys before deleting them as a precaution) and delete the following entries:

• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson
• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Ericsson
• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Retail Pro\Prism\Erlang
• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Retail Pro\Prism\RabbitMQ
• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\RabbitMQ
• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Erlang OTP

 

6. Confirm RabbitMQ Removal
Verify that the RabbitMQ service has been removed from Services. If it is still present, manually delete it by running the following command in Command Prompt as Administrator:

SC DELETE RABBITMQ

7. Reboot the System
Reboot the system to ensure that any DLLs marked for deletion are properly removed before reinstalling RabbitMQ.

________________________________________________________________________________

Reinstall RabbitMQ

1. Reinstall Prism Server
   Install the Prism server using the same version of the Prism installer that was previously installed.
2. Restore Backups
   • Restore the previously backed-up folders (\confs, \WebClient, and \Modules) to the ProgramData\RetailPro folder.
   • Restore the Apache\Conf folder in the Apache directory.
3. Reboot the System
   Reboot the system following the proper sequence.

________________________________________________________________________________

Confirmation

1. Confirm RabbitMQ Service
   Ensure that RabbitMQ has started successfully.
2. Confirm Workstation Connectivity
   Verify that all workstations are connected to the server.
3. Check RabbitMQ Console
   Confirm that the RabbitMQ console is receiving changes as expected.
4. Verify Data Flow
   Ensure that changes are properly flowing through RabbitMQ.