[KARAF-3066] Improve OpenEJB documentation in manual

• Type: Documentation
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.1
• Fix Version/s: 3.0.2, 4.0.0.M2, 4.0.0.M3
• Assignee: Jean-Baptiste Onofré
• Reporter: Jochen Kraushaar
• Created: 24/Jun/14 09:24
• Updated: 22/Jan/15 20:55
• Resolved: 13/Sep/14 19:14

Description

The documentation of the OpenEJB feature in the Karaf manual is rather short. Here it says

Full support of Apache OpenEJB may required some tuning on the etc/jre.properties file.

Actually some more configuration has to be done:

• Add "openejb.deployments.classpath.exclude = bundle:.*" and "openejb.deployments.classpath.filter.descriptors = true" to etc/system.properties (see http://karaf.922171.n3.nabble.com/Unsupported-URL-scheme-using-bundle-watch-td4033596.html)
• Adopt version of javax.xml.namespace in etc/jre.properties (see http://mail-archives.apache.org/mod_mbox/karaf-user/201401.mbox/[e-mail]%3E)
• Remove the version number at javax.annotation from etc/jre.properties because this will only export the Java SE javax.annotation package and overwrites the Java EE javax.annotation package exported by the Geronimo Annotation API (which is required for EJB support)