Chapter 2. Installation
This chapter guides you through the steps to install AMQ JMS in your environment.
2.1. Using the Red Hat Maven repository
The client uses Apache Maven as its build tool. You can 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 client dependency to your POM file.
<dependency> <groupId>org.apache.qpid</groupId> <artifactId>qpid-jms-client</artifactId> <version>0.42.0.redhat-00002</version> </dependency>
The client library is now available in your Maven project.
2.2. Installing a local Maven repository
As an alternative to the online repository, AMQ JMS can be installed to your local filesystem as a file-based Maven repository.
Procedure
- Use your subscription to download the AMQ JMS 2.4.0 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-jms-2.4.0.GA-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.3. Installing the .zip file
The AMQ JMS .zip file contains the examples and a distribution of the client libraries for those not using Maven. If you are using Maven and do not require the examples, you do not need to install the .zip file.
Procedure
- Use your subscription to download the AMQ JMS 2.4.0 .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 apache-qpid-jms-0.42.0.redhat-00002-bin.zip
On Windows, right-click the .zip file and select Extract All.
When you extract the contents of the .zip file, a directory named
apache-qpid-jms-0.42.0.redhat-00002
is created. This is the top-level directory of the installation and is referred to as<install-dir>
throughout this document.-
(Optional) If you are not using Maven, add the .jar files in the
<install-dir>/lib
directory to your Java classpath.