Sometimes the RabbitMQ component doesn't get installed properly during the Cloud On-Premise installation process (e.g. the installation was performed while logged in as a Domain Admin or other domain account), and we need to uninstall, then reinstall properly.
Steps 1-5 should be run as the Domain account that originally performed the installation. If you get a red error message saying the file cannot be loaded, (in Step 3), follow the Powershell permission article to change the permission level to Unrestricted, do Steps 3 & 4, then change the permission level back to its original setting.
1. Determine the installation source path. When you see <installsource> in an instruction, use the correct path instead. Example:
Installation source path: C:\Users\someguy\Desktop\OP installer 11.13.2019
Instruction: cd "<installsource>\ISSetupPrerequisites\Erlangx64_RabbitMQ"
You would enter this: cd "C:\Users\someguy\Desktop\OP installer 11.13.2019\ISSetupPrerequisites\Erlangx64_RabbitMQ"
2. Run Powershell as Administrator.
3. Enter the following commands. If you get a Security Warning, type R <enter> to run the script.
Import-Module .\WaspUtils.ps1 –Force
Import-Module ".\WaspInstaller-MessageQueue.ps1" –Force
4. Except for your current Powershell window, make sure all other command shells (CMD or Powershell), Windows Explorer, or interactive shells are closed, then enter the following command.
5. Close the Powershell window.
The RabbitMQ component is now removed.
If you are working on an installation, you can run the OP installer again, which will reinstall RabbitMQ. If you need to only reinstall RabbitMQ, continue with Steps 6 & 7.
To reinstall, log off the Domain Admin, log on as a local admin, then do Steps 6 & 7 (only). This installation needs to be run while logged in as a local administrator, not a domain admin.
6. Run a Command Prompt as Administrator. Do not use PowerShell for this.
7. Enter commands:
This will perform an automatic installation, with a number of blue boxes. If you get security warnings in the command prompt, press R to run each one. If you get security prompt dialog boxes, click Yes to allow/continue. When the command prompt reappears and no other actions occur, the installation is complete. To confirm, run services.msc and look for RabbitMQ to be present and running.
The following steps are the manual process & verification that the automated installer does. In most cases, these should not need to be manually performed.
8. In a web browser, open the following URL. Include the "http://" part. You should get a RabbitMQ window.
9. Login with credentials
10. Click onto the 4th tab Queues and confirm the following names exist (it's ok if there are others):
11. Click onto the 5th tab Admin and confirm the following names exist (it's ok if there are others):
12. If the Queues or Admin values do not match, consult Development for assistance.
13. Run the Wasp Configuration Tool as Administrator and log in with Windows Authentication. Path to WCT:
C:\Program Files\Wasp Barcode Technologies\Wasp On-Premises Software\License\configure\Wasp.Installer.Configure.exe
14. On the 2nd tab RabbitMQ Queue, check the first two fields:
RabbitMQ Server DNS Name
RabbitMQ Admin Password
If those are blank or the password is ***, populate the fields with these values:
DNS Name is the computer name
15. Click the Validate RabbitMQ button. You should receive the message "OK" in the message box. If there is an error, consult Development for assistance.
16. Click the Save button at the lower right.
This procedure is complete. Continue with other procedures or verify that the system is now running properly, as appropriate.