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.

Services window, under RabbitMQ with Stop highlighted  and RabbitMQ selected

3. Uninstall RabbitMQ and Erlang
Uninstall the following programs:

  • RabbitMQ Server 3.12.10
  • Erlang OTP 26.1.2 (14.1.1)

Programs and Features file window Control Panel > Programs > Programs and Features, Erlang OTP file selected

Programs and Features file window with RabbitMQ Server 3.12.10 file selected

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.

File explorer window: This PC > Local Disk (CL) > Program Files (x86) > RabbitMQ Server folder selected

File explorer window: This PC > Local Disk (C:) > Program Files > erl14.1.1 folder selected

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

Select Administrator: Command Prompt | Microsoft Windows [Version 10.0.19045.4651] (c) Microsoft Corporation. All rights reserved. C:\Windows\system32>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.

 

Published on May 13, 2025 in Technical Bulletin

 

Find Another Article