Chapter 2. Installation
This chapter guides you through the steps to install AMQ JMS Pool in your environment.
2.1. Prerequisites
- You must have a subscription to access AMQ release files and repositories.
- To build programs with AMQ JMS Pool, you must install Apache Maven.
- To use AMQ JMS Pool, you must install Java.
2.2. Using the Red Hat Maven repository
Configure your Maven environment to download the client library from the Red Hat Maven repository.
Procedure
Add the Red Hat repository to your Maven settings or POM file. For example configuration files, see Section B.1, “Using the online repository”.
<repository> <id>red-hat-ga</id> <url>https://maven.repository.redhat.com/ga</url> </repository>
Add the library dependency to your POM file.
<dependency> <groupId>org.messaginghub</groupId> <artifactId>pooled-jms</artifactId> <version>1.1.1.redhat-00003</version> </dependency>
The client is now available in your Maven project.
2.3. Installing a local Maven repository
As an alternative to the online repository, AMQ JMS Pool can be installed to your local filesystem as a file-based Maven repository.
Procedure
- Use your subscription to download the AMQ Clients 2.8.0 JMS Pool Maven repository .zip file.
Extract the file contents into a directory of your choosing.
On Linux or UNIX, use the
unzip
command to extract the file contents.$ unzip amq-clients-2.8.0-jms-pool-maven-repository.zip
On Windows, right-click the .zip file and select Extract All.
-
Configure Maven to use the repository in the
maven-repository
directory inside the extracted install directory. For more information, see Section B.2, “Using a local repository”.
2.4. Installing the examples
Procedure
Use the
git clone
command to clone the source repository to a local directory namedpooled-jms
:$ git clone https://github.com/messaginghub/pooled-jms.git pooled-jms
Change to the
pooled-jms
directory and use thegit checkout
command to switch to the1.1.1
branch:$ cd pooled-jms $ git checkout 1.1.1
The resulting local directory is referred to as <source-dir>
throughout this document.