|Travis CI Build|
|Apache Jenkins CI Build|
Website | Wiki | Documentation | Developer Mailing List | User Mailing List | Open Issues
The Apache Qpid Broker-J is a powerful open-source message broker.
Below are some quick pointers you might find useful.
The project requires Maven 3. Some example commands follow.
Clean previous builds output and install all modules to local repository without running the tests:
mvn clean install -DskipTests
Install all modules to the local repository after running all the tests:
mvn clean install
Maven profiles are used to run tests for the supported protocols and storage options. Profile names follow the form java-store.n-n, where store signifies the storage module and n-n the AMQP protocol version number.
For store, the options include:
If no profile is explicitly selected, java-mms-1.0 is activated by default.
To activate a BDB with AMQP 1.0 protocol use:
mvn verify -P java-bdb.1-0
To see all the available profiles.
When activating AMQP 0-8..0-10 profiles, it is also necessary to pass the system property -DenableAmqp0-x
mvn verify -P java-dby.0-9-1 -DenableAmqp0-x
Perform a subset of tests on the packaged release artifacts without installing:
mvn verify -Dtest=TestNamePattern* -DfailIfNoTests=false
Integration tests except for protocol tests are disabled by default. In order to run all integration tests, they need to be enabled with a flag -DskipITs=false, for example
mvn verify -DskipITs=false
Execute the tests and produce code coverage report:
mvn clean test jacoco:report
To produce broker assemblies, use:
mvn clean package -DskipTests
The broker distribution assemblies will then be found beneath:
For full details, see the Getting Started documentation in the docbook documentation mentioned below. For convenience brief instructions are repeated here.
Expand the assembly produced by the Maven package lifecycle stage, and the execute the qpid-server script or batch file.
tar xvfz apache-qpid-broker-j/target/apache-qpid-broker-j-x.x.x-SNAPSHOT-bin.tar.gz ./java-broker/x.x.x/qpid-server
Expand zip apache-qpid-broker-j/target/apache-qpid-broker-j-x.x.x-SNAPSHOT-bin.zip .\java-broker\x.x.x\qpid-server.bat
These instructions assume Intellij.
By default, the Broker listens on port 5672 for AMQP and 8080 for http management. The default username ‘guest’ and password ‘guest’.
To get to the management console, point a browser to http://localhost:8080
Documentation (in docbook format) is found beneath the doc module.