diff --git a/artemis-distribution/pom.xml b/artemis-distribution/pom.xml index 19aef752d0..eb5551b509 100644 --- a/artemis-distribution/pom.xml +++ b/artemis-distribution/pom.xml @@ -37,6 +37,11 @@ + + org.apache.activemq + artemis-jms-client-all + ${project.version} + org.apache.activemq artemis-boot diff --git a/artemis-distribution/src/main/assembly/dep.xml b/artemis-distribution/src/main/assembly/dep.xml index 057d8c80ac..229017fcc1 100644 --- a/artemis-distribution/src/main/assembly/dep.xml +++ b/artemis-distribution/src/main/assembly/dep.xml @@ -105,6 +105,15 @@ lib false + + 755 + 644 + + org.apache.activemq:artemis-jms-client-all + + lib/client + false + diff --git a/docs/user-manual/en/client-classpath.md b/docs/user-manual/en/client-classpath.md index 931ad4acba..ea61c3a014 100644 --- a/docs/user-manual/en/client-classpath.md +++ b/docs/user-manual/en/client-classpath.md @@ -1,29 +1,15 @@ # The Client Classpath -Apache ActiveMQ Artemis requires several jars on the *Client Classpath* depending on -whether the client uses Apache ActiveMQ Artemis Core API, JMS, and JNDI. +Apache ActiveMQ Artemis requires just a single jar on the *client classpath*. > **Warning** > -> All the jars mentioned here can be found in the `lib` directory of the -> Apache ActiveMQ Artemis distribution. Be sure you only use the jars from the correct +> The client jar mentioned here can be found in the `lib/client` directory of the +> Apache ActiveMQ Artemis distribution. Be sure you only use the jar from the correct > version of the release, you *must not* mix and match versions of jars > from different Apache ActiveMQ Artemis versions. Mixing and matching different jar > versions may cause subtle errors and failures to occur. -## Apache ActiveMQ Artemis Core Client - -If you are using just a pure Apache ActiveMQ Artemis Core client (i.e. no JMS) then you -need `activemq-core-client.jar`, `activemq-commons.jar`, and `netty.jar` -on your client classpath. - -## JMS Client - -If you are using JMS on the client side, then you will also need to -include `activemq-jms-client.jar` and `geronimo-jms_2.0_spec.jar`. - -> **Note** -> -> `geronimo-jms_2.0_spec.jar` just contains Java EE API interface classes needed -> for the `javax.jms.*` classes. If you already have a jar with these -> interface classes on your classpath, you will not need it. +Whether you are using JMS or just the Core API simply add the `artemis-jms-client-all.jar` +from the `lib/client` directory to your client classpath. This is a "shaded" jar that +contains all the Artemis code plus dependencies (e.g. JMS spec, Netty, etc.). \ No newline at end of file diff --git a/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/README.md b/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/README.md index f788881070..775138004c 100644 --- a/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/README.md +++ b/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/README.md @@ -66,8 +66,7 @@ This approach might be preferred if for example you only have access to the 5.x ## Preparing -1) Fetch the `artemis-jms-client-all` jar from [Maven Central](https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.apache.activemq%22%20AND%20a%3A%22artemis-jms-client-all%22) - which corresponds to the version of ActiveMQ Artemis installed. Copy that jar to the `$5X_HOME/lib` directory. +1) Copy `lib/client/artemis-jms-client-all.jar` to the `$5X_HOME/lib` directory. 2) Add the bridge configuration to `activemq.xml`: diff --git a/pom.xml b/pom.xml index 70daf3c865..068fa46f47 100644 --- a/pom.xml +++ b/pom.xml @@ -871,6 +871,7 @@ artemis-core-client artemis-server artemis-jms-client + artemis-jms-client-all artemis-jms-server artemis-native artemis-journal