Install the Test Environment using the installer or unzip the archive to your Visual Age directory (<vaj.home>).

Go to File/Quick Start(or press F2), select Add Feature and pick the jBoss Test Environment to add the jBoss 2.0 feature. This will install a jBoss 2.0 project in addition to a few other projects with related files that have jBoss 2.0 appended to their name.

If an Add Failed dialog box appears, delete the package mentioned in the dialog and re-add the Test Environment to VAJ.

Check the org.jboss.Main properties (right click on the class and choose properties) and adjust the command line arguments and properties to point to the right directories of your VAJ install. You should also check the classpath directories.

Run the org.jboss.Main class. You should then see the test beans deployed.

Create META-INF subdirectory in the deploy directory of <jboss.home>.

a. Add ejb-jar.xml and both jboss.xml and jaws.xml (if needed) to the directory.

Run org.jboss.Main using VAJ run command to start jBoss.

Make sure any projects that contain EJBs that you are developing are in the classpath of org.jboss.Main.

If running EJBs from servlets/JSPs, make sure that jBoss's project is in Tomcat's classpath (the com.ibm.ivj.tomcat.TomcatRunner class). If you are calling EJBs from a client class with a main() method, make sure the jBoss project is in its classpath in addition to all jars from the <jboss.home>/client directory.

Make sure configuration-name tag in jboss.xml points to the JDK 1.2 (NOT JDK 1.3) info in standardjboss.xml as this example shows:

<configuration-name>jdk1.2.2 CMP EntityBean</configuration-name>

To debug, set breakpoints inside of EJB bean class.

To allow changes to EJBs to take effect in VAJ, either restart jBoss or touch one of the XML files in the <jboss.home>/deploy/META-INF directory.

Unzip jBoss-2.0-FINAL.zip into a temporary directory.

Create a jboss project in VAJ.

Import source, jar and class files into VAJ from temp dir:

Directories to be added to VAJ's <vaj.home>/ide/program_resources/jboss directory from jBoss zip archive:

        bin
        client
        conf/default
        db -- for InstantDB and Hypersonic
        deploy -- EJB autodeploy directory
        lib (with ext subdir) -- all the jars
        log
        tmp

org.jboss.Main -- this is the jBoss runner class, whose main() is executed to start jBoss.

a. Commented out shutdown hook code in Main() since this only works for JDK 1.3 and prevents it from being compiled in VAJ which uses JDK 1.2.2.

Here's the commented out code:

                  // Add shutdown hook
                  /* 
                  Removed by Craig since VAJ will
                  not compile this because addShutdownHook()
                  only works with JDK 1.3.
                  
                  try
                  {
                         Runtime.getRuntime().addShutdownHook(new Thread()
                         {
                                public void run()
                                {
                                        manager.stopMBeans(server);

                                   err.println("Shutdown");
                                   Set mBeans = server.queryNames(null, null);
                                   Iterator names = mBeans.iterator();
                                   err.println("Shutting down "+mBeans.size() +" MBeans");
                                   while (names.hasNext())
                                   {
                                          ObjectName name = (ObjectName)names.next();
                                          try
                                          {
                                                 server.invoke(name, "destroy", new Object[0], new String[0]);
                                          } catch (Throwable e)
                                          {
                                                //err.println(e);
                                          }
                                   }
                                   err.println("Shutting done");

                                }
                         });
                         System.out.println ("Shutdown hook added");
                  } catch (Throwable e)

                  {
                         System.out.println("Could not add shutdown hook");
                         // JDK 1.2.. ignore!
                  }
                  */
        

b. Modified the following in org.jboss.Main.Main():

         //URL confDirectory = new File("../conf/"+confName).getCanonicalFile().toURL();
        //CHANGED TO:
         URL confDirectory = new URL(confName);
        

c. Properties to change in org.jboss.Main (right click on class and bring up Properties dialog) (NOTE -- please adjust the path to point to your Visual Age install directory):

For org.jboss.jmx.server.RMIConnectorImpl, org.jboss.jmx.JMXAdaptorImpl, and org.jboss.ejb.plugins.jrmp.server.JRMPContainerInvoker.

a. Manually generate RMI stub/skeleton using VAJ's built-in RMI tool or import stub classes from the jBoss binary distribution (use for JRMPContainerInvoker).

In org.jboss.deployment.J2eeDeployer.InstallEJB(), commented out the following:

          // download libraries we depend on
          /*Commented out by Craig to prevent exceptions from being
          thrown when deployed from VAJ without a jar or zip file
          Manifest mf = new JarFile (localUrl.getFile ()).getManifest ();
          if (mf != null)
                  addCommonLibs (_d, mf, _source);
          else
                  log.debug(m.name+" doesn't contain MANIFEST.MF");
        */
          

a. This routine gets classpath info from the jar's Manifest file and throws an exception since there is no jar file when you are running jBoss inside of VAJ.

In jboss.conf (in <jboss.home>/conf/default directory):

In jboss.jcml (in <jboss.home>/conf/default directory):

a. Change single reference to ../conf/default/instantdb.properties to ./conf/default/instantdb.properties

In instantdb.properties (in <jboss.home>/conf/default directory):

a. Change line: traceFile=../log/trace.log to traceFile=./log/trace.log

Adjust the following jboss.conf records to point to your jBoss install path:

<MLET CODE = "org.jboss.ejb.AutoDeployer" ARCHIVE="jboss.jar">
<ARG TYPE="java.lang.String" VALUE="E:/Program Files/IBM/VisualAge for
Java/ide/project_resources/jBoss/deploy/">
</MLET>

<MLET CODE = "org.jboss.deployment.J2eeDeployer"
ARCHIVE="jboss.jar,../xml.jar" CODEBASE="./lib/ext/">
<ARG TYPE="java.lang.String" VALUE="E:/Program Files/IBM/VisualAge for
Java/ide/project_resources/jBoss/tmp/deploy">
<ARG TYPE="java.lang.String" VALUE="EJB:service=ContainerFactory">
<ARG TYPE="java.lang.String" VALUE=":service=EmbeddedTomcat">
</MLET>