[KARAF-2511] Update ejb page of the user guide
Project: http://git-wip-us.apache.org/repos/asf/karaf/repo Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/0e68cf85 Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/0e68cf85 Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/0e68cf85 Branch: refs/heads/master Commit: 0e68cf856b0d2138b49145e9aa69111e5fdfc638 Parents: 435aae3 Author: Jean-Baptiste Onofré <[email protected]> Authored: Fri Dec 20 13:31:35 2013 +0100 Committer: Jean-Baptiste Onofré <[email protected]> Committed: Fri Dec 20 13:31:35 2013 +0100 ---------------------------------------------------------------------- manual/src/main/webapp/users-guide/ejb.conf | 54 ++++++++++++++++++++++-- 1 file changed, 50 insertions(+), 4 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/karaf/blob/0e68cf85/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 710485b..2ea6eae 100644 --- a/manual/src/main/webapp/users-guide/ejb.conf +++ b/manual/src/main/webapp/users-guide/ejb.conf @@ -1,10 +1,56 @@ h1. EJB +This section describes how to add support of EJB in Apache Karaf. It doesn't describe how to develop EJB applications in +Apache Karaf. See the developer guide for details about that. + +h2. Apache OpenEJB + Apache Karaf doesn't provide "native" support of EJB (Enterprise Java Beans). -However, a project powered by Apache Karaf started at Apache OpenEJB: Apache KarafEE. +Apache OpenEJB provides EJB support for Apache Karaf by providing a set of features. + +To install and enable EJB support, you can do: + +{code} +karaf@root()> feature:repo-add openejb +{code} + +By default, the {{feature:repo-add openejb}} command will install the latest OpenEJB version available. + +You can specify a target version using the {{version}} argument: + +{code} +karaf@root()> feature:repo-add openejb 4.5.2 +{code} + +Now, you have a set of new OpenEJB features available in your Apache Karaf container: + +{code} +karaf@root()> la +... +openejb-core | 4.5.2 | | openejb-features | +openejb-server | 4.5.2 | | openejb-features | +openejb-cxf | 4.5.2 | | openejb-features | +openejb-rest | 4.5.2 | | openejb-features | +openejb-soap | 4.5.2 | | openejb-features | +{code} + +You can add EJB support installing the {{openejb-core}} feature: + +{code} +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. + +The name of this custom distribution is KarafEE: -It's the support of Apache OpenEJB in a custom distribution of Apache Karaf. +[https://svn.apache.org/repos/asf/tomee/karafee/] -The Apache KarafEE project is now "deprecated". It will be replaced by a ejb feature directly in the next -Apache Karaf release. \ No newline at end of file +However, this project is now "deprecated", and all resources from KarafEE will move directly in Apache Karaf soon. \ No newline at end of file
