Install STP.Common Service

The RabbitMQ service and the interfaces in the connected programs and Windows services together form the Service Bus (SB). The SB enables communication between services and applications.

The setup installs the necessary server components for the Service Bus (SB) on the server or another server.

Note
For the installation of Erlang OTP, the Windows environment variable must be Homedrive C:.

Type set homedrive in the command prompt and press the [Enter] key to determine the environment variable. Cancel the installation if a different value is configured.

Start a new command prompt as an administrator, type Set HOMEDRIVE=C: to change the environment variable for the current session.

Use the cd command to navigate to the installation directory and start the installation file STP.Common.Services.Setup.exe from this command prompt.

Run the executable file STP.Common.Services.Setup.exe.

The setup first installs the runtime components Erlang OTP and then the RabbitMQ service.

Whenever possible, use the values suggested by the installation program for configuration.

Note
Do not interrupt the setup and especially do not close any command prompts opened by the installation program.

If a command prompt requires an action from the user, an error has occurred. In this case, contact the service of STP Informationstechnologie GmbH.

RabbitMQ User Configuration for STP Common Service

1. Create Administrator User (stpadmin)

  1. Log in to the RabbitMQ web interface (e.g., http://localhost:15672) with a user that has administrator rights (e.g., guest).

  2. Navigate to Admin → Users and click on Add user.

  3. Fill in the fields as follows:

    • Username: stpadmin
    • Password: choose a secure password
    • Tags: administrator

  4. Click on Add user.

  5. Go to the Permissions section for the virtual host (usually /) and assign the following rights:

    • Configure: .*
    • Write: .*
    • Read: .*

  6. Click on Set permission.

Note
The user guest is active by default after installation with the password guest. It can only access RabbitMQ via localhost (i.e., directly on the server).

Once you have successfully set up the user stpadmin, you should log in with this user and completely delete the guest user to eliminate a potential security risk.

2. Change User Rights for Existing User stpuser

  1. Navigate to Admin → Users.

  2. Select the user stpuser.

  3. Click on Update this user.

  4. Remove the administrator entry in the Tags field. Leave the field empty.

  5. Confirm the change with the current password (stp.). Note: If you assign a new password here, you must update the password in all clients and servers in their respective configs.

  6. Click on Update user to save the changes.

  7. Scroll down to the Permissions section.

  8. Select the virtual host (usually /).

  9. Enter the following rights:

    • Configure: .*
    • Write: .*
    • Read: .*

  10. Click on Set permission.

Note
The user stpuser should only be used for message exchange in STP products. It should not have access to the RabbitMQ management interface.

Firewall

On the computer where the RabbitMQ service is running, open port 15672 in the firewall.

Related to