git commit: [KARAF-3066] Upgrade OpenEJB documentation

[jb...@apache.org]

Repository: karaf
Updated Branches:
  refs/heads/master 703b6a7a9 -> 1b6f6be6c


[KARAF-3066] Upgrade OpenEJB documentation


Project: http://git-wip-us.apache.org/repos/asf/karaf/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/1b6f6be6
Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/1b6f6be6
Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/1b6f6be6

Branch: refs/heads/master
Commit: 1b6f6be6c469af7e00d1a39b4562e8fa6f31b6eb
Parents: 703b6a7
Author: Jean-Baptiste Onofré <jb...@apache.org>
Authored: Sat Sep 13 21:04:57 2014 +0200
Committer: Jean-Baptiste Onofré <jb...@apache.org>
Committed: Sat Sep 13 21:04:57 2014 +0200

----------------------------------------------------------------------
 manual/src/main/webapp/users-guide/ejb.conf | 34 ++++++++++++++++++++----
 1 file changed, 29 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/karaf/blob/1b6f6be6/manual/src/main/webapp/users-guide/ejb.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/users-guide/ejb.conf b/manual/src/main/webapp/users-guide/ejb.conf
index c54c586..2b8f24a 100644
--- a/manual/src/main/webapp/users-guide/ejb.conf
+++ b/manual/src/main/webapp/users-guide/ejb.conf
@@ -9,7 +9,35 @@ Apache Karaf doesn't provide "native" support of EJB (Enterprise Java Beans).
 
 Apache OpenEJB provides EJB support for Apache Karaf by providing a set of features.
 
-To install and enable EJB support, you can do:
+You have to update some Karaf configuration to have full OpenEJB support.
+
+First, in the {{etc/system.properties}}, you have to append the following properties:
+
+{code}
+...
+#
+# OpenEJB scanner
+#
+openejb.deployments.classpath.exclude=bundle:*
+openejb.deployments.classpath.filter.descriptors=true
+{code}
+
+Due to some OpenEJB version constraint, you also have to update the {{etc/jre.properties}} by changing the version of
+the {{javax.xml.namespace}} package, and remove the version of the {{javax.annotation}} package (provided by Geronimo
+Annotation API spec bundle, used by OpenEJB):
+
+{code}
+...
+javax.annotation, \
+javax.annotation.processing, \
+...
+javax.xml.namespace;version="1.0.0", \
+...
+{code}
+
+It enables the OpenEJB bundles scanning, looking for EJBs.
+
+After starting/restart Karaf to take these changes, we can install the OpenEJB feature:
 
 {code}
 karaf@root()> feature:repo-add openejb
@@ -41,10 +69,6 @@ You can add EJB support installing the {{openejb-core}} feature:
 karaf@root()> feature:install openejb-core
 {code}
 
-{warning}
-Full support of Apache OpenEJB may required some tuning on the {{etc/jre.properties}} file.
-{warning}
-
 h2. Apache KarafEE
 
 A custom distribution of Apache Karaf embedding OpenEJB is available in the Apache TomEE project.