karaf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jbono...@apache.org
Subject git commit: [KARAF-3066] Upgrade OpenEJB documentation
Date Sat, 13 Sep 2014 19:08:15 GMT
Repository: karaf
Updated Branches:
  refs/heads/karaf-3.0.x 4de411e3e -> 47e41123b


[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/47e41123
Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/47e41123
Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/47e41123

Branch: refs/heads/karaf-3.0.x
Commit: 47e41123beeddb786ea57d6bd6985d767c6bd717
Parents: 4de411e
Author: Jean-Baptiste Onofré <jbonofre@apache.org>
Authored: Sat Sep 13 21:04:57 2014 +0200
Committer: Jean-Baptiste Onofré <jbonofre@apache.org>
Committed: Sat Sep 13 21:08:03 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/47e41123/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.


Mime
View raw message