Security Compliance

Modifying RabbitMQ user accounts in SolarWinds ARM

This article describes how to create a new user account to access the RabbitMQ console.

First published date

12/20/2023 5:02 PM

Last published date

12/1/2025 6:11 PM

Overview

RabbitMQ is a message queuing application used in the SolarWinds Access Rights Manager (ARM) to clear queues and messages.

Follow the procedure in this article to reset the password for existing RabbitMQ users, create a unique RabbitMQ user with administrator privileges and delete the old administrator account.
 

Product section

Access Rights Manager

Resolution

  1. Reset password for existing RabbitMQ users
  2. Create a new RabbitMQ user with administrator privileges.
  3. Verify the changes were set using the new account.
  4. Update the ARM Server username and password.

Note:

For ARM 2025.2 and above, the file locations have changed: 

  • Before 2025.2:  “C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat”
  • 2025.2 and later: "C:\Program Files\SolarWinds\SolarWinds.Arm.RabbitMQ\RabbitMQ\sbin\rabbitmqctl.bat”
  • For ARM 2025.4 and later, the passwords can no longer be changed in the ARM Configuration Wizard, so do not proceed with the steps given below.

Please change the script examples below to include this change. If you receive permission errors, update permissions to the location/file indicated to allow Administrators full control of the file/folder indicated in the error.

Reset the password for an existing RabbitMQ User

  1. Log in to the ARM server as an administrator.
  2. Open a Command window as administrator.
  3. Run the following command to add a new user, replacing the username and password with your preferred credential: 
    “C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat” change_password arm_client <newpassword>
  4. Replace arm_client with the actual RabbitMQ user. (arm_client and arm_management are the default RabbitMQ user accounts)
  5. Replace <newpassword> with the actual new password.
  6. For example:

The example above is for ARM 2025.2 and above. See the NOTE above at the beginning of the article regarding file path changes.

Create a new RabbitMQ user with administrator privileges

  1. Log in to the ARM server as an administrator.
  2. Open a Command window as administrator.
  3. Run the following command to add a new user, replacing the username and password with your preferred credential: 
    “C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat” add_user username password
    For example:
    step_3_code.png
  4. Run the following commands to set the administrator rights for the new user, replacing username with the username you created in step 3: 
    “C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat” set_permissions -p arm username “.*” “.*” “.*”
    “C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat” set_permissions -p / username “.*” “.*” “.*”

    For example:
    step_4_code.png

  5. Run the following command to provide administrator rights and access to the management plug-in:  
    "C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat" set_user_tags username administrator
    For example:
    step_5_code.png

Verify the changes were set using the new account

Log in to the RabbitMQ console on the local host of the SolarWinds ARM Server.

For ARM 2020.2 and earlier, use:

http://localhost:15672

For ARM 2021.4 and later, use:

https://localhost:15671

  Update the ARM Server username and password

  1. Log in to the ARM server as an administrator.
  2. Click the Start menu, navigate to the SolarWinds folder, and select ARM - Configuration Wizard. 
    arm_config_wizard2.png
  3. Log in using your ARM software credentials.
    arm_sign-in.png
  4. Select Basic Config in the left menu. 
    basic-config.png
  5. Click Next four times until you reach the RabbitMQ configuration page.
  6. Scroll down to Management Plugin.
  7. Add the new account you created in the RabbitMQ Administration Console, and then click Next. 
    management-plug-in.png
  8. Click Save Config. The password change is completed.
  9. Open a Command window. 
  10. Run the following command to delete the old administrator account:  
    "C:\Program Files (x86)\SolarWinds.RabbitMQ.Install\RabbitMQ\sbin\rabbitmqctl.bat" delete_user arm_management

    The following message displays: 

    Deleting user "arm_management" ...