Message Broker (Early IAP Versions)

RabbitMQ

This page summarizes the requirements to install the RabbitMQ message broker as a dependency for Itential's earlier release versions:

• IAP/2022.1
• IAP/2023.1

Installation

A supported version of Erlang/OTP must be installed before installing RabbitMQ. Although Erlang is part of standard Red Hat repositories, it is most likely out of date. Please check the RabbitMQ Erlang Version Requirements Guide for currently supported versions at this link: Which Erlang Version?

Please refer to the official RabbitMQ installation guide for details on RabbitMQ installation.

Verify the installed RabbitMQ version matches the version specified in the Itential Dependencies page or the relevant IAP version.

Post Installation

Check that the RabbitMQ service is running.

$ systemctl status rabbitmq-server

    rabbitmq-server.service - RabbitMQ broker
    Loaded: loaded (/usr/lib/systemd/system/rabbitmq-server.service; enabled; vendor preset: disabled)
    Active: active (running) since Thu 2020-01-02 17:38:38 UTC; 5s ago

Event Deduplication

To use the event deduplication feature, additional install steps must be completed (see below).

Operational Requirements

The event deduplication feature requires that all IAP instances in an HA cluster share the same event deduplication settings in their active profile and all have the same plugins enabled. Mismatched settings will result in undefined behavior and are not supported.

Required Third-Party Plugins

• elixir-VERSION.ez
• rabbitmq_message_deduplication-VERSION.ez

Plugin Installation Steps

1. Consult the README.md for the third-party plugins: rabbitmq-message-deduplication.
2. Download the correct version of the two plugins listed above according to your version of RabbitMQ.
3. Install the plugins by copying their .ez files to the plugin directory of your RabbitMQ instance.
4. Enable the following plugins using rabbitmq-plugins enable:
   • rabbitmq_management
   • rabbitmq_shovel
   • rabbitmq_shovel_management
   • rabbitmq_message_deduplication
5. Verify the admin port (default 15672) is exposed to IAP. This is required for automatic settings configuration by IAP.
6. Make sure the same plugins are installed and activated on all RabbitMQ instances when a cluster is being used.