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
1. 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.
2. Manually delete the following application file directories:
3. - C:\Program Files\RabbitMQ Server
  - C:\Program Files\Erlang OTP
4. Manually delete the Windows AppData files for RabbitMQ:
5. - 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
6. Manually delete the Windows Registry keys by navigating to Run > regedit.exe:
7. - 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
8. Reboot Windows

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

Install RabbitMQ

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

Run OnGuard Setup Assistant

Launch application to confirm successful login

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

RabbitMQ and NGINX uninstall and installation