RabbitMQ and NGINX uninstall and installation
Symptom
This document serves as a guide for customers who seek to upgrade these third-party components at their own discretion.
NOTE: Specific versions of each component are not specified below. The Third-party Application Compatibility chart located at https://connect.lenels2.com/s/downloads
includes the specific version that the solution supports. The version listed ensures that testing was done, and that the component version is compatible with OnGuard®.
NOTE: LenelS2 strongly recommends that customers or VARs call Tech Support before implementing these steps. It is important to discuss the reasons for wanting to apply patches or fixes to these 3rd party software plug-ins, and to receive guidance and expertise from the LenelS2 Technical Support Group in the event that there is an issue encountered during this process.
Process
Prerequisites:
- Erlang OTP package
- RabbitMQ Server package
- NGINX package
*Located in the Onguard ISO
- ~:\CommonAppData\Lnl\Temp\RabbitMQ
- ~:\program files\OnGuard
Uninstall Process for RabbitMQ and Erlang
*The uninstall process should be followed completely prior to a re-installation or upgrade to a later version
- Stop relevant services by navigating to Run > Services.msc
- LS Message Broker
- LS Web Service
- Uninstall current version of RabbitMQ under Programs and Features
- Uninstall current version of Erlang OTP under Programs and Features
- Remove remaining traces of RabbitMQ from the server
- Open a command prompt as an administrator:
- In the command prompt window type the following command and press Enter. tasklist |findstr "epmd"
- The output of the command will list the details for the process named epmd that needs to be stopped. Make a note of the process ID value that is listed just before the word 'Services', which in the example below is 4032.
- To stop the epmd process run the following command using the process ID that was obtained from the previous step. In the example below, the process ID value of 4032 was used. taskkill /f /pid 4032
- The output of the command should show that it was completed successfully and that the epmd process was terminated.
- Manually delete the following application file directories:
- C:\Program Files\RabbitMQ Server
- C:\Program Files\Erlang OTP
- Manually delete the Windows AppData files for RabbitMQ:
- C:\Users\Windows user account that installed RabbitMQ\AppData\Roaming\RabbitMQ
- C:\Users\Windows user account that installed RabbitMQ\.erlang.cookie
- C:\Windows\System32\config\systemprofile\.erlang.cookie
- Manually delete the Windows Registry keys by navigating to Run > regedit.exe:
- Delete the Folder: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Ericsson
- Delete the Folder: HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson
- Delete the Folder: Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\RabbitMQ
- Reboot Windows
- Open a command prompt as an administrator:
Installation Process for RabbitMQ and Erlang
- Install Erlang
- RabbitMQ requires a 64-bit supported version of Erlang for Windows to be installed
- Installer can be located in the Onguard ISO or downloaded from https://www.erlang.org/downloads
- OTP xx.x Windows 64-bit Binary File version will need to be downloaded
- Complete the installation by running the executable
- Compatible version will be found in the OnGuard ISO or downloaded from https://www.rabbitmq.com/install-windows.html
- Complete the installation by running the executable
Additional steps needed for RabbitMQ (Not necessary for all systems)
Run the following in the RabbitMQ command line prompt one at a time:
rabbitmq-service remove
rabbitmq-service install
rabbitmq-service start
rabbitmqctl start_app
rabbitmqctl status
*confirm node started
Run OnGuard Setup Assistant
Update the LenelRabbit User for Message Broker
Can be run as One command line
rabbitmqctl.bat add_user LenelRabbit LenelS2Secur1ty# & rabbitmqctl.bat set_user_tags LenelRabbit administrator & rabbitmqctl.bat set_permissions -p / LenelRabbit ".*" ".*" ".*" & rabbitmqctl.bat add_vhost LenelHost & rabbitmqctl.bat clear_permissions -p LenelHost guest & rabbitmqctl.bat set_permissions -p LenelHost LenelRabbit ".*" ".*" ".*" & rabbitmqctl.bat set_user_tags guest none & rabbitmqctl.bat clear_permissions -p / guest & rabbitmqctl.bat change_password guest gDGcutUASH7WV & rabbitmq-plugins enable rabbitmq_management
Update the LenelRabbitLD User for the Login Driver
*Additional command line for versions 8.1 and higher to update the Login Driver. Can be run as One command line
rabbitmqctl.bat add_user LenelRabbitLD LenelS2Secur1ty# & rabbitmqctl.bat set_user_tags LenelRabbitLD administrator & rabbitmqctl.bat set_permissions -p / LenelRabbitLD ".*" ".*" ".*" & rabbitmqctl.bat add_vhost LenelHostLD & rabbitmqctl.bat clear_permissions -p LenelHostLD guest & rabbitmqctl.bat set_permissions -p
Applies To
OnGuard 7.5 and later
Additional Information
Upgrading NGINX if needed
Navigate to C:\Program Files (x86)\OnGuard\nginx and rename existing executable file (nginx.exe to nginx.exe.old)
Navigate to nginx.org and download the necessary mainline version
Copy the new nginx executable from the zip file to same file path C:\Program Files (x86)\OnGuard\nginx
Launch command prompt and verify the executable displays the correct version using the following command.
C:\Program Files (x86)\OnGuard\nginx Nginx -v
Restart all OnGuard® services or reboot the server
Copyright © 2024 Carrier. All rights reserved.