DevEJB3NewPlugin

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.

     

    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

      • 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

     

    Tests

     

     

    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

     

     

    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: