README
This folder contains source code for an example "Hello World" style
plugin. It features a plugin which has a configurable message (the
default being "Hello World") which is displayed as a notice message
when OpenDJ directory server is started.
In order to build and use this example plugin, perform the following
steps while the server is stopped:
1. Then unzip the example-plugin.zip (in place):
unzip example-plugin.zip
2. Go into the example-plugin source folder:
cd example-plugin
3. And build the plugin (this requires Ant version 7 and Xalan-Java):
ant install
If this step fails for you as is, you can find Ant 7 and Xalan-Java
in the OpenDJ ext/ directory after checking the source out with
Subversion. Substitute your full path to OpenDJ sources for /src
in the following command:
/src/ext/ant/bin/ant -Dxalan.directory=/src/ext/xalan-j/ install
4. This will copy the following files into the parent OpenDJ
installation:
lib/extensions/example-plugin.jar
config/example-plugin.ldif
config/schema/99-example-plugin.ldif
5. Add the plugin's config to the server configuration.
cd ../bin
./start-ds
./dsconfig -h `hostname` -p 4444 -D "cn=Directory Manager" -w password
create-plugin --plugin-name "Example Plugin" --type example
--set enabled:true --set plugin-type:startup
--set java-class:com.example.opends.ExamplePlugin -X -n
6. Restart the server and look for the "hello world" notice in the start
up log:
./stop-ds --restart