此内容没有您所选择的语言版本。

Chapter 2. Installation


2.1. Prerequisites

AMQ Broker requires the following components.

  • JRE 8 (for running AMQ Broker)
  • JDK 8 (for running the examples)
  • Maven 3.2 (for running the examples)

Note that the broker runtime requires only a JRE. However, running the included examples requires a full JDK as well as Maven.

If you are installing AMQ Broker on a supported version of Red Hat Enterprise Linux, you can use the yum command to install any needed pre-requisites. For example, the command below installs OpenJDK 8 and Maven.

$ sudo yum install java-1.8.0-openjdk maven
Copy to Clipboard Toggle word wrap

You can also download supported versions of a JDK and Maven from their respective websites, OpenJDK and Apache Maven for example. Consult Supported Configurations to ensure you are using a supported version of Java.

2.2. Downloading an AMQ Broker Archive

A platform-independent, archived distribution of AMQ Broker is available for download from the Red Hat Customer Portal. See Using Your Subscription for more information on how to access the customer portal using your Red Hat subscription. You can download a copy of the distribution by following the steps below.

Note

Red Hat also releases archives to the customer portal that are not part of the planned release cycle. These releases address security issues or provide other fixes and enhancements and are not displayed under the default list on the Software Downloads page. Instead, they are displayed when you click the page’s Security Advisory and Patches tabs.

Procedure

  1. Open a browser and log in to the Red Hat Customer Portal at https://access.redhat.com.
  2. Click Downloads. The Product Downloads page opens.
  3. Find the category titled JBoss Integration and Automation containing a link to Red Hat JBoss AMQ Broker.
  4. Click the hyperlink Red Hat JBoss AMQ Broker. The Software Downloads page opens.
  5. Select the desired AMQ Broker version from the Version drop-down menu.
  6. On the Releases tab, click the Download link for the specific AMQ Broker file you want to download.

2.3. Installing on Linux

Prerequisites

You must first download the installation archive from the Red Hat Customer Portal.

Procedure

  1. Create a new user named amq-broker and provide it a password.

    sudo useradd amq-broker
    sudo passwd amq-broker
    Copy to Clipboard Toggle word wrap
  2. Create the directory /opt/redhat/amq-broker and make the new amq-broker user and group the owners of it.

    sudo mkdir /opt/redhat
    sudo mkdir /opt/redhat/amq-broker
    sudo chown -R amq-broker:amq-broker /opt/redhat/amq-broker
    Copy to Clipboard Toggle word wrap
  3. Change the owner of the archive to the new user.

    sudo chown amq-broker:amq-broker jboss-amq7.x.x.zip
    Copy to Clipboard Toggle word wrap
  4. Move the installation archive to the directory you just created.

    sudo mv jboss-amq7.x.x.zip /opt/redhat/amq-broker
    Copy to Clipboard Toggle word wrap
  5. As the new user amq-broker, extract the contents with a single unzip command.

    su - amq-broker
    cd /opt/redhat/amq-broker
    unzip jboss-amq7.x.x.zip
    Copy to Clipboard Toggle word wrap

A directory named something similar to AMQ7-7.0-redhat-1 will be created. In the documentation this location is referred to as INSTALL_DIR.

2.4. Installing on Windows

Prerequisites

You must first download the zip version of the archive from the Red Hat Customer Portal.

Procedure

  1. Use Windows Explorer to create the directory folder \redhat\amq-broker on the desired letter drive, C: for example.
  2. Use Windows Explorer to move the installation archive to the new directory and extract it.
  3. Extract the file contents into a directory by right-clicking on the zip file and choosing Extract All.

A directory named something similar to AMQ7-x.x-redhat-1 will be created. In the documentation this location is referred to as INSTALL_DIR.

2.5. Archive Contents

The directory created by extracting the archive is the top-level directory for the AMQ Broker installation. This directory is referred to as INSTALL_DIR and includes a number of important directories noted in the table below.

Expand
Table 2.1. Contents of INSTALL_DIR
If you want to find…​Look here…​

API documentation

INSTALL_DIR/web/api

Binaries and scripts needed to run AMQ Broker

INSTALL_DIR/bin

Configuration files

INSTALL_DIR/etc

JMS and Java EE examples

INSTALL_DIR/examples

Jars and libraries needed to run AMQ Broker

INSTALL_DIR/lib

XML Schemas used to validate AMQ Broker configuration files

INSTALL_DIR/schema

Web context loaded when AMQ Broker runs.

INSTALL_DIR/web

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat