EJB 3 Plugin

The EJB 3 Plugin is a distributable component which can install itself into a distribution of the JBoss Application Server. It provides the application server with EJB 3 functionality as defined in JSR 220 (/ JSR 318).

The steps below outline instructions for build and testing.

Prerequisites

• Install Apache Ant 1.6.5

• Must be 1.6.5 (This dependency will either be removed or bundled transparently in the near future)

• Set Environment Variable $ANT_HOME

• ANT_HOME=/location/to/ant; export ANT_HOME

• Install Subversion

• Ensure "svn" is on the system's PATH (or symlinked)

• Install Apache Maven

• Version 2.0.9+ (2.0.8 has non-deterministic dependency resolution)

• Ensure "mvn" is on the system's PATH (or symlinked)

• Set up ~/.m2/settings.xml to include JBoss Maven2 Repos

• Instructions: http://wiki.jboss.org/wiki/Wiki.jsp?page=Maven

• Settings: http://wiki.jboss.org/wiki/Wiki.jsp?page=MavenSettings

• Install

• Known Working JDKs

• Sun JDK 1.5.x x86

• Sun JDK 1.5.x x86 64 bits

• Known Incompatible JDKs

• Sun JDK 1.6.x x86

• Please update this Wiki with other functional/improper JDKs

• Ensure "java" is on the system's PATH (or symlinked)

Install the AS

• Compile from Source

• Checkout from SVN

• svn co http://anonsvn.jboss.org/repos/jbossas/trunk or svn co https://svn.jboss.org/repos/jbossas/trunk

• Build

• cd trunk/build; ./build.sh clean most

• Set Environment Variable $JBOSS_HOME

• cd output/jboss-5.0.0.RC1; JBOSS_HOME=`pwd`; export JBOSS_HOME

Obtain EJB3 Plugin Sources

• Checkout from SVN

• svn co http://anonsvn.jboss.org/repos/jbossas/projects/ejb3/trunk or svn co https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk

• Set Environment Variable $EJB3_HOME

• cd trunk; EJB3_HOME=`pwd`; export EJB3_HOME

Build Plugin

• Build via Maven

• cd trunk/; mvn clean install

Patch AS

• Run the Plugin installer on your AS installation

• java -jar plugin/target/jboss-ejb3-plugin-0.1.0-SNAPSHOT-installer.jar $JBOSS_HOME

• On cygwin

• $JBOSS_HOME must use "/" as root of current drive

• eg. /cygdrive/c/jboss becomes /jboss

Tests

• See DevEJB3RunningUnitTests

Reports

• Generate reports when tests complete

• cd $EJB3_HOME/testsuite; $ANT_HOME/bin/ant -f build-test.xml tests-report-html

• Reports in $EJB3_HOME/testsuite/target/reports/html

• In ubuntu you also must copy ant-trax.jar and ant-junit.jar to /usr/share/ant/lib/ from generating reports.

  (get ant-trax.jar and ant-junit.jar from: http://www.apache.org/dist/ant/binaries/apache-ant-1.7.0-bin.zip )

Centralized Testing

• Hudson

• Locations

• ALR

• http://jboss.hudson.alrubinger.com/view/EJB3/

• Request permissions from ALR to trigger builds

• JBoss Internal (VPN Required)

• EJB3 Plugin Against AS5 trunk http://hudson.qa.jboss.com/hudson/view/EJB3/job/EJB3_Plugin_AS_TRUNK/

• JBoss Public

• EJB3 Plugin Against AS5 trunk http://hudson.jboss.org/hudson/job/EJB3_Plugin_AS_TRUNK/

Some Gotchas

• Maven unresolved dependencies

• Clear out your existing Maven repo of EJB3 dependencies to ensure you don't have improper snapshots hanging around

• mvn dependency:purge-local-repository -DreResolve=true clean install

• Clear out your entire Maven repo

• rm -Rf ~/.m2/repository/

• Compile errors due to new Snapshots, not updating locally

• Force update

• mvn -U clean install

Problems?

• This is a new build for the EJB3 Team.

• Some adaptation is anticipated, should stabilize quickly

• Report inconsistencies / errors to ALR mailto:andrew.rubinger@jboss.org or correct this Wiki.

Referenced by: