Chapter 5. Running the AMQ Broker examples

Procedure

1. Go to the Apache Maven Download page and download the latest distribution for your operating system.

2. Install Maven for your operating system.

   For more information, see Installing Apache Maven.

1. In a web browser, navigate to https://access.redhat.com/downloads/ and log in.

   The Product Downloads page is displayed.

2. In the JBoss Integration and Automation section, click the Red Hat AMQ Broker link.

   The Software Downloads page is displayed.

3. Select the desired AMQ Broker version from the Version drop-down menu.

4. On the Releases tab, click the Download link for the AMQ Broker Maven Repository.

   The AMQ Maven repository file is downloaded as a zip file.

5. On your machine, unzip the AMQ repository file into a directory of your choosing.

   A new directory is created on your machine, which contains the Maven repository in a subdirectory named maven-repository/.

Procedure

1. Open the Maven settings.xml file.

   The settings.xml file is typically located in the ${user.home}/.m2/ directory.

   • For Linux, this is ~/.m2/
   • For Windows, this is \Documents and Settings\.m2\ or \Users\.m2\

   If you do not find a settings.xml file in ${user.home}/.m2/, there is a default version located in the conf/ directory of your Maven installation. Copy the default settings.xml file into the ${user.home}/.m2/ directory.

2. In the <profiles> element, add a profile for the AMQ Maven repository.

   <!-- Configure the JBoss AMQ Maven repository -->
   <profile>
     <id>jboss-amq-maven-repository</id>
     <repositories>
       <repository>
         <id>jboss-amq-maven-repository</id>
         <url>file://<JBoss-AMQ-repository-path></url>  1
         <releases>
           <enabled>true</enabled>
         </releases>
         <snapshots>
           <enabled>false</enabled>
         </snapshots>
       </repository>
     </repositories>
     <pluginRepositories>
       <pluginRepository>
         <id>jboss-amq-maven-repository</id>
         <url>file://<JBoss-AMQ-repository-path></url>  2
         <releases>
           <enabled>true</enabled>
         </releases>
         <snapshots>
           <enabled>false</enabled>
         </snapshots>
       </pluginRepository>
     </pluginRepositories>
   </profile>

   1 2

   Replace <JBoss-AMQ-repository-path> with the location of the Maven repository that you installed. Typically, this location ends with /maven-repository. For example:

   <url>file:///path/to/repo/amq-broker-7.2.0-maven-repository/maven-repository</url>

3. In the <activeProfiles> element, set the AMQ Maven repository to be active:

   <activeProfiles>
     <activeProfile>jboss-amq-maven-repository</activeProfile>
   ...
   </activeProfiles>

4. If you copied the default settings.xml from your Maven installation, uncomment the <active-profiles> section if it was commented out by default.
5. Save and close settings.xml.

6. Remove the cached ${user.home}/.m2/repository/ directory.

   If your Maven repository contains outdated artifacts, you may encounter one of the following Maven error messages when you build or deploy your project:

   • Missing artifact <artifact-name>
   • [ERROR] Failed to execute goal on project <project-name>; Could not resolve dependencies for <project-name>