Return-Path: X-Original-To: apmail-karaf-commits-archive@minotaur.apache.org Delivered-To: apmail-karaf-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 10172110C2 for ; Sat, 13 Sep 2014 19:08:16 +0000 (UTC) Received: (qmail 14267 invoked by uid 500); 13 Sep 2014 19:08:15 -0000 Delivered-To: apmail-karaf-commits-archive@karaf.apache.org Received: (qmail 14231 invoked by uid 500); 13 Sep 2014 19:08:15 -0000 Mailing-List: contact commits-help@karaf.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@karaf.apache.org Delivered-To: mailing list commits@karaf.apache.org Received: (qmail 14221 invoked by uid 99); 13 Sep 2014 19:08:15 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 13 Sep 2014 19:08:15 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 0DFDC9C1737; Sat, 13 Sep 2014 19:08:15 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: jbonofre@apache.org To: commits@karaf.apache.org Message-Id: X-Mailer: ASF-Git Admin Mailer Subject: git commit: [KARAF-3066] Upgrade OpenEJB documentation Date: Sat, 13 Sep 2014 19:08:15 +0000 (UTC) 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é Authored: Sat Sep 13 21:04:57 2014 +0200 Committer: Jean-Baptiste Onofré 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.