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
- 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.
- Back up the following directories from the ProgramData\RetailPro folder:
- 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
- Reinstall Prism Server
Install the Prism server using the same version of the Prism installer that was previously installed. - 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.
- Reboot the System
Reboot the system following the proper sequence.
________________________________________________________________________________
Confirmation
- Confirm RabbitMQ Service
Ensure that RabbitMQ has started successfully. - Confirm Workstation Connectivity
Verify that all workstations are connected to the server. - Check RabbitMQ Console
Confirm that the RabbitMQ console is receiving changes as expected. - Verify Data Flow
Ensure that changes are properly flowing through RabbitMQ.