Skip to main content

Create a Broker

You can create additional brokers to run your integrations. By default, Moogsoft Onprem installs one broker per UI instance. You may need to install additional brokers if:

  • If you have installed a large volume of integrations.

  • If you want to use a custom broker profile.

Before You Begin

Before you install your new broker, ensure you have met the following requirements:

  • You have Java 11.0.5 or higher installed and in your $PATH environment.

  • Crontab exists and cron is running for the installing user:

    • For an RPM installation, you satisfy the first two requirements as part of the Moogsoft Onprem - Online RPM pre-installation. You can also install Java v11.0.6 and Crontab by running the following script:

      yum install -y cronie java-11-openjdk-devel*11.0.6* && echo "" | crontab - && crond start

    • For a Tarball installation, you can install Java 11.0.5 from AdoptOpenJDK.

  • You have configured a broker profile. See Create a Broker Profile for more information.

  • If you are not installing the broker to $MOOGSOFT_HOME, you have the necessary permissions to install it to your working directory.

  • Ensure the host you install the broker on has low latency with the RabbitMQ host.

Create the Broker

To create a new broker:

  1. Navigate to the Deployment Status page.

  2. Click Get Broker Install Script to display the Broker Install Script page.

  3. Using the drop-down menu, select the profile you want the broker to use.

  4. Copy and run the installation command on your machine. The broker installs to $MOOGSOFT_HOME or if unset, your current working directory, for example /opt/local/moogsoft. On the Deployment Status page, the Status field indicates the install status of the new broker.

When the installation completes, the script notifies you of the broker's installation and Moogsoft Onprem will begin using it alongside your other brokers to run integrations.

You can access the broker logs in $MOOGSOFT_HOME/log.

In this section: