From c53f6168c93d0c95fc0922af837197a86b117bf7 Mon Sep 17 00:00:00 2001 From: Clebert Suconic Date: Mon, 8 May 2017 12:22:50 -0400 Subject: [PATCH] ARTEMIS-898 Documenting where to add the plugin jar --- .../apache/activemq/artemis/cli/commands/Create.java | 1 + docs/user-manual/en/broker-plugins.md | 10 +++++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/artemis-cli/src/main/java/org/apache/activemq/artemis/cli/commands/Create.java b/artemis-cli/src/main/java/org/apache/activemq/artemis/cli/commands/Create.java index 9cc5bf31ba..ae45257f8e 100644 --- a/artemis-cli/src/main/java/org/apache/activemq/artemis/cli/commands/Create.java +++ b/artemis-cli/src/main/java/org/apache/activemq/artemis/cli/commands/Create.java @@ -597,6 +597,7 @@ public class Create extends InputAbstract { new File(directory, "etc").mkdirs(); new File(directory, "log").mkdirs(); new File(directory, "tmp").mkdirs(); + new File(directory, "lib").mkdirs(); File dataFolder = new File(directory, "data"); dataFolder.mkdirs(); diff --git a/docs/user-manual/en/broker-plugins.md b/docs/user-manual/en/broker-plugins.md index 7166acad26..25250ed3b1 100644 --- a/docs/user-manual/en/broker-plugins.md +++ b/docs/user-manual/en/broker-plugins.md @@ -8,11 +8,15 @@ is always executed first). Creating a plugin is very simple. It requires implementing the [`ActiveMQServerPlugin`](../../../artemis-server/src/main/java/org/apache/activemq/artemis/core/server/plugin/ActiveMQServerPlugin.java) interface, making sure the plugin is on the classpath, and registering it with the broker. Only the methods that you want to add behavior for need to be implemented as all of the interface methods are default methods. +## Adding the plugin to the classpath + +The proper place to add your jar would be under $ARTEMIS_INSTANCE/lib. + +If you are using an embed system than you will need the jar under the regular classpath of your embedded application. + ## Registering a Plugin -To register a plugin with by XML you need to add the `broker-plugins` element. - -`broker.xml` in your classpath: +To register a plugin with by XML you need to add the `broker-plugins` element at the `broker.xml`. ```xml