Version 49

    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.




    • 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

      • 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



    Obtain EJB3 Plugin Sources



    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







    • 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: )


    Centralized Testing



    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




    • This is a new build for the EJB3 Team.

    • Some adaptation is anticipated, should stabilize quickly

    • Report inconsistencies / errors to ALR or correct this Wiki.


    Referenced by: