Chapter 3. Installing AMQ Broker AMQ Broker is distributed as a platform-independent archive file. To install AMQ Broker on your system, you must download the archive and extract the contents. You should also understand the directories included in the archive. Prerequisites The host on which you are installing AMQ Broker must meet the AMQ Broker supported configurations. For more information, see Red Hat AMQ 7 Supported Configurations . 3.1. Downloading the AMQ Broker archive AMQ Broker is distributed as a platform-independent archive file. You can download it from the Red Hat Customer Portal. Prerequisites You must have a Red Hat subscription. For more information, see Using your Subscription . Procedure In a web browser, navigate to https://access.redhat.com/downloads/ and log in. The Product Downloads page is displayed. In the JBoss Integration and Automation section, click the Red Hat AMQ Broker link. The Software Downloads page is displayed. Select the desired AMQ Broker version from the Version drop-down menu. On the Releases tab, click the Download link for the specific AMQ Broker file you want to download. 3.2. Extracting the AMQ Broker archive on Linux If you are installing AMQ Broker on Red Hat Enterprise Linux, create a new user account for AMQ Broker, and then extract the contents from the installation archive. Procedure Create a new user named amq-broker and provide it a password. USD sudo useradd amq-broker USD sudo passwd amq-broker Create the directory /opt/redhat/amq-broker and make the new amq-broker user and group the owners of it. USD sudo mkdir /opt/redhat USD sudo mkdir /opt/redhat/amq-broker USD sudo chown -R amq-broker:amq-broker /opt/redhat/amq-broker Change the owner of the archive to the new user. USD sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip Move the installation archive to the directory you just created. USD sudo mv amq-broker-7.x.x-bin.zip /opt/redhat/amq-broker As the new amq-broker user, extract the contents by using the unzip command. USD su - amq-broker USD cd /opt/redhat/amq-broker USD unzip <archive_name> .zip USD exit A directory named something similar to apache-artemis-2.33.0.redhat-00016 is created. In the documentation, this location is referred to as <install_dir> . 3.3. Extracting the AMQ Broker archive on Windows systems If you are installing AMQ Broker on a Windows system, create a new directory folder for AMQ Broker, and then extract the contents there. Procedure Use Windows Explorer to create the directory folder \redhat\amq-broker on the desired drive letter. For example: C:\redhat\amq-broker Use Windows Explorer to move the installation archive to the directory you just created. In the \redhat\amq-broker directory, right-click the installation archive zip file and select Extract All . A directory named something similar to apache-artemis-2.33.0.redhat-00016 is created. In the documentation, this location is referred to as <install_dir> . 3.4. Understanding the AMQ Broker installation 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 the following contents: Table 3.1. Contents of AMQ Broker installation directory This directory... Contains... <install_dir> /web/api API documentation. <install_dir> /bin Binaries and scripts needed to run AMQ Broker. <install_dir> /etc Configuration files. <install_dir> /lib JARs and libraries needed to run AMQ Broker. <install_dir> /schema XML schemas used to validate AMQ Broker configuration. <install_dir> /web The web context loaded when AMQ Broker runs.

Commands:
sudo useradd amq-broker sudo passwd amq-broker
sudo mkdir /opt/redhat sudo mkdir /opt/redhat/amq-broker sudo chown -R amq-broker:amq-broker /opt/redhat/amq-broker
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat/amq-broker
su - amq-broker cd /opt/redhat/amq-broker unzip <archive_name> .zip exit