Search

Chapter 2. Installation

download PDF

This chapter describes the prerequisites for installing the AMQ Broker plug-in and the process for obtaining and installing it.

2.1. Prerequisites

Before you can install the AMQ Broker plug-in, the following components must be installed, configured, and running:

  • JBoss ON Server
  • AMQ Broker
  • JON Agent

Related information

2.2. Downloading and Installing the AMQ Broker Plug-in

JON uses plug-ins to handle specific JBoss resources, such as AMQ or EAP, and other applications. JON resource plug-ins are distributed in “plug-in packs” that are distributed separately from the JON Server and JON Agents. Plug-in packs may also require a separate subscription to download them.

When you install a plug-in pack on the JON server, its contents are available for download by JON agents. As a result, JBoss resources can be discovered and imported into the inventory to be managed.

To download and install the plug-in pack, complete the following steps:

  1. Log in to the Red Hat Customer Portal and navigate to the Software Download page.
  2. Select JBoss ON for AMQ from the Product drop-down menu. The Software Downloads page reloads and displays available releases.
  3. Select Download. A dialog prompts you to open or save the zip archive file.
  4. Save the zip archive and extract the files to a temporary directory, for example:

    [smith@server rhq-agent]$ unzip jon-plugin-pack-3.3.zip -d /tmp

    This creates a subdirectory with the name jon-plugin-pack-3.3.

  5. Copy the extracted plug-in JAR files from the jon-plugin-pack-plugin_3.3/ directory to the JBoss ON server plug-in directory. For example:

    [root@server rhq-agent]# cp /tmp/jon-plugin-pack-plugin_3.3/*.jar /opt/jon/jon-server-3.3.GA/plugins

2.3. Updating the Plug-ins on the JON Server

On stand-alone platforms, prompt the JBoss ON server to update its plug-ins by either restarting the server or by using the JON web interface, as follows:

  1. Click Administration > Configuration > Agent Plugins.
  2. Click Scan For Updates in the bottom left corner.
  3. Locate Red Hat JBoss AMQ 7 in the list of agent plug-ins and verify that the Last Updated timestamp is current.

On managed platforms, you can prompt agents to manually reload their plug-ins by using the plugins command:

[jsmith@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh > plugins update

Alternatively, if the agents are imported into the JON inventory, this can be done in the JON GUI by scheduling an update plugins operation for an agent or a group of agents. To do so, select the agent resource entry in the inventory, open the Operations tab, and schedule the update plug-ins operation.

Related information

JON 3.3 Installation Guide

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.