Installing RabbitMQ with RabbitMQ Helper

This documentation provides information about the different types of RabbitMQ and Helper installations, the use of a Site Connector, and the validation for the RabbitMQ product.

Installation Prerequisites

  • The installation of RabbitMQ with RabbitMQ Helper requires an administrator account on the machine where the installation is taking place. The account must have a local home directory.

  • For installations that use an SSL certificate, verify that the TLS requirements are met. See RabbitMQ TLS Certificate Requirements.

Software Downloads and Requirements

The following table lists the download links and versions for each software element required to use the RabbitMQ Helper correctly.

Delinea is aware that certain anti-virus scanners have flagged the OpenSSL download as malware. For more information, click here. Before installing RabbitMQ Helper, you must set up inbound firewall rules on the computer that is hosting the connector.

To view the compatible versions of the RabbitMQ-related applications, see the Compatibility Matrix

Starting from v11.0.0.0, RabbitMQ Helper introduced a new installation method via a guided user interface. The installation supports all types of Online and Offline installations for TLS and non-TLS configurations.

RabbitMQ Helper Software Downloads
Software and Download Links Additional Notes

RabbitMQ Helper

(current version)

You can install the current version of RabbitMQ Helper and later by double-clicking the installer file.

To install RabbitMQ Helper from a command line:

  1. Run the cmd as an administrator.

  2. Run on cmd: cd <helper-installer-directory>.

  3. Run on cmd:
    msiexec /i <helper-installer-directory>\Delinea.RabbitMq.Helper.xx.x.x.x.msi /l*v install.log

    Example:

    msiexec /i C:\Users\user\Desktop\Delinea.RabbitMq.Helper.12.0.0.msi /l*v install.log

RabbitMQ Helper is not affected by the CVE-2025-32433 vulnerability.
Microsoft.NET Desktop Runtime (v8.0 or above) Installation of the RabbitMQ Helper requires Microsoft.NET Desktop Runtime (v8.0 or above) to run the User Interface.
Microsoft.NET - Windows Server Hosting (v8.0 or above) We recommend installing .NET before you install RabbitMQ Helper.
PowerShell Core (v7.4.6 or above)

Install PowerShell 7 before performing the RabbitMQ Helper installation. To install the PowerShell Core:

  1. Run the installer.

  2. Accept the terms in the license agreement.

  3. Select Install and Finish.
Windows Server (2016-2022)  
Erlang (current version)  Download and install Erlang v27.3.3.
RabbitMQ Server (current version) Download and install RabbitMQ Server v4.1.0.

Installing RabbitMQ and Setting Up a Site Connector

A Site Connector is a combination of Erlang and RabbitMQ. To view the installation requirements for setting up a site connector, see Installing RabbitMQ in the Secret Server documentation.

The installation of RabbitMQ with RabbitMQ Helper requires an administrator account on the machine where the installation is taking place. The account must have a local home directory.

Downloading Installers Using RabbitMQ Helper

To download the Erlang and RabbitMQ Installers using the RabbitMQ Helper, run the following RabbitMQ Helper Advanced (Powershell) commands:

Copy 
Get-ErlangInstaller -Verbose 
Get-RabbitMqInstaller -Verbose 

Alternatively, you can download the installers using official CND mirrors:

Copy 
Get-ErlangInstaller -UseNonMirror -Verbose 
Get-RabbitMqInstaller –UseNonMirror -Verbose

We recommend that you download the Erlang and RabbitMQ installers by using the download links in the RabbitMQ Helper UI during an offline installation. For more information, see Installing UI RabbitMQ Offline without TLS and Installing UI RabbitMQ Offline with TLS.

Installing RabbitMQ Helper

To install RabbitMQ Helper for v12.1.0 and later:

  • Run the RabbitMQ Helper Installer.

You can download the RabbitMQ Helper installer by selecting the RabbitMQ Helper link in the RabbitMQ Helper Software Downloads table in the "Software Downloads and Requirements" section of Installing RabbitMQ with RabbitMQ Helper.

To install RabbitMQ Helper via the command line:

  1. Run the cmd prompt as an administrator.

  2. Switch to the directory where the .msi file exists using the cd <helper-msi-directory-path> command.

  3. Run the msiexec / i Delinea.RabbitMq.Helper.xx.xx.xx.xx /l*v install.log command.

    Change the name of the .msi file according to the version of RabbitMQ Helper you're installing.

Installing RabbitMQ via the Command Line

The installation of RabbitMQ with RabbitMQ Helper requires an administrator account on the machine where the installation is taking place. The account must have a local home directory.

Depending on your installation scenario, you need to run certain PowerShell cmdlets. For details, follow the links below to select what type of installation you need and its relevant cmdlets.

Validating the RabbitMQ Installation

After successfully installing RabbitMQ, the next step is to validate the RabbitMQ Helper installation.

Use the following commands in the RabbitMQ Helper PowerShell window:

  1. Assert-RabbitMqConnectivity—Validates the connectivity to RabbitMQ.

  2. Assert-RabbitMqIsRunning—Validates that RabbitMQ is running on the current host.

If the command executes successfully without producing any output, this indicates a successful operation.

About the Install-Connector Cmdlet

The table below lists the commands to process in the Install-Connector cmdlet. Use the Install-Connector cmdlet to install RabbitMQ and not the individual commands available.

Install-Connector Cmdlet commands
Command Description
Get-ErlangInstaller Downloads the currently supported Erlang installer.
Get-RabbitMqInstaller Downloads the currently supported RabbitMQ installer.
Uninstall-RabbitMq

Uninstalls the previous RabbitMQ installation.
Uninstall-Erlang Uninstalls the previous Erlang installation.
Set-ErlangHomeEnvironmentalVariable Sets the Erlang and RabbitMQ environmental variables.
Install-Erlang Installs Erlang.
New-RabbitMqConfigDirectory Creates a custom RabbitMQ configuration directory.
Set-RabbitMqBaseEnvironmentalVariable
  • Sets the RabbitMQ BASE environment variable to the created configuration directory.
    		•
    With TLS
    Convert-CaCerToPem Converts a CA certificate to the PEM file format.
    Convert-PfxToPem Converts a Host PFX to the PEM file format.
    Convert-CngOrEccToPem Converts a CNG or ECC key type certificate to the PEM file format.
    New-RabbitMqTlsConfigFiles Creates a RabbitMQ TLS configuration file.
    Install-RabbitMq Installs RabbitMQ.
    Copy-ErlangCookieFile Copies the Erlang system cookie to the current user profile.
    Assert-RabbitMqIsRunning Verifies that RabbitMQ is running.
    Enable-RabbitMqManagement Enables the RabbitMQ management UI.
    New-RabbitMqUser Creates a basic user.
    Grant-RabbitMqUserPermission Grants permissions to the created user.
    Assert-RabbitMqConnectivity Verifies that the newly created user can connect to RabbitMQ with TLS.
    Delete-RabbitMqUser
  • Deletes a default Admin(guest) in RabbitMQ.
    		•
    Create RabbitMQ Management Admin Creates an Admin User for RabbitMQ Management UI access and for running commands that need Admin access.
    Enable-RabbitMqFeatureFlags

    Enables all the stable feature flags in RabbitMQ. 

    All feature flags will eventually become mandatory. For example, RabbitMQ 3.12 requires enabling feature flags introduced in the 3.11 series before the upgrade, RabbitMQ 3.11 graduates all 3.8 flags, and so on. 
    Without TLS
    New-RabbitMqNonTlsConfigFiles Creates a RabbitMQ non-TLS configuration file.
    Install-RabbitMq Installs RabbitMQ.
    Copy-ErlangCookieFile Copies the Erlang system cookie to the current user profile.
    Assert-RabbitMqIsRunning Verifies that RabbitMQ is running.
    Enable-RabbitMqManagement Enables the RabbitMQ management UI.
    New-RabbitMqUser Creates a basic user.
    Grant-RabbitMqUserPermission Grants permissions to the created user.
    Assert-RabbitMqConnectivity

    Asserts that the newly created user can connect to RabbitMQ without TLS.
    Delete-RabbitMqUser Deletes a default Admin(guest) in RabbitMQ.
    Create RabbitMQ Management Admin Creates an Admin User for RabbitMQ Management UI access and for running commands that need Admin access.
    Enable-RabbitMqFeatureFlags

    Enables all the stable feature flags in RabbitMQ.

    All feature flags will eventually become mandatory. For example, RabbitMQ 3.12 requires enabling feature flags introduced in the 3.11 series before the upgrade, RabbitMQ 3.11 graduates all 3.8 flags, and so on. 

    After a successful installation, you must create an Admin User to access RabbitMQ Management. Therefore, the Install-Connector command process now includes a provision to add an Admin User.