J2EE Model Browser Application Release Notes
--------------------------------------------

Initial Release : 26.01.04
Updated		: 03.03.05


Quick Start
-----------

If you're reading this then you've probably unzipped the the bundle into a directory.
If you have Java3D installed then you can test the installation by invoking the script 
./bin/j2ee-model-browser and selecting a test to run from the displayed Test Suite.

Feedback
--------

All feedback greatfully received at jpitten@btinternet.com

Installation Notes
------------------

The installation assumes Java 2 Runtime 1.4.2 or later and 
Java3D version 1.3.1 are installed. 

Application Invocation
----------------------

The following methods of invocation are supported :

1. Default : Test Suite

Invocation :

	j2ee-model-browser

By default the application displays a Test Suite from which a Test Model can be selected and run. Best to play with these test models and see if you like the idea of the technology before trying to visualise your own builds/deployments. 

Individual tests can also by invoked on the command line :

	j2ee-model-browser -test <test name>

See example script .bin/test-AMs3Ms2MeeMeAMs


2. Deployment Archive Visualisation

To build a model of your own J2EE Archive.
 
Invocation :

	j2ee-model-browser -jar <archive file pathname.>jar|ear|war 
  or
	j2ee-model-browser -jar

An archive file pathname can either be specified on the command line or the
application will prompt the user to select an archive file using a FileChooser if no
archive is specified.  

3. J2EE Management Client 

Visualise the deployment on you own J2EE Application Server.

Invocation :

	j2ee-model-browser -client

Invoking the application as a management client will instantiate an initialContext and 
attempt to lookup the server resident Management EJB, as follows:

      InitialContext ctx = new InitialContext();
      Object o = ctx.lookup("ejb/mgmt/MEJB");
      ManagementHome home = (ManagementHome)PortableRemoteObject.narrow(o, ManagementHome.class);
      Management mejb = home.create();
      new J2EEModelBrowser(mejb);

Alternatively, J2EEModelBrowser can be instantiated by your own application using 
the constructor method:

      public J2EEModelBrowser(javax.management.Management mejb);

You will need to ensure all the necessary rmi/j2ee client/rmi jars are made available to the application if you are going to try to get it to talk a J2EE management Server.


Exporting Generated Models
--------------------------
Models can be exported in VRML97 or X3D formats.
 
Whereas VRML97 encoded models can be viewed using any commerically available browser, the X3D encoding is still under development and can only be viewed using the technology's own x3d parsers. So any exported model can be viewed using the J3DBrowser application :

	vmodel.j3d.eai.J3DBrowser

 - which can be invoked using the ./bin/j3d-browser script. J3DBrowser will prompt you to select a x3d/vrml file for viewing.

Alternatively J2EEManagementApplet can be run as a standalone application to view exported 
models:
	vmodel.j2ee.applet.J2EEManagementApplet

which can be invoked using the ./bin/j2ee-management-applet script, again you will be prompted to select a file for viewing.