Copyright (C) BULL S.A. 1998-2002.


There are 4 kind of examples:

 - examples with enterprise java beans accessed from a simple client which
   is a java program, (these examples are all on examples/src);

 - examples with enterprise java beans accessed from a servlet
	or JSP and packaged in .ear file:
	examples/earsample, examples/cmp2, examples/alarm.

 - 2 examples of AXIS use in JOnAS : examples/embedded_axis and separate_axis

 - 1 example of JOnAS application generation via xdoclet.

There is also an other example on examples/jps, which is the well-known Java Pet Store
application. As the examples/jps directory doesn't contain the Pet Store sources,
the building of this example is not done via the build.xml of this current 'examples'
directory. (See examples/jps/README for more details).


Before compiling and running these examples, the installation and configuration
of JOnAS have to be done:

 - initialization of the JONAS_ROOT environment variable,
 - optionally, initialization of the JONAS_BASE environment variable,
 - update of your PATH,
 - update of the JOnAS config_env script,
 - configuration of JNDI environment via the jndi.properties file
 - configuration of the database access:
	- update of the JOnAS config_env script,
	- configuration of JOnAS environment via the jonas.properties file,
	- update of the <datasource_name>.properties file.
 - configuration of Tomcat for JOnAS.

Refer to install documentation for more information.



Compiling these examples:
------------------------
 Use the Ant 1.5 build tool in one of the directories where there is a build.xml file.

 You may have to modify before $JONAS_ROOT/examples/build.properties

 The default "install" target allows to build the examples and copy the built ejb-jar 
 file in your JOnAS_BASE/ejbjars directory.

 Example:
	export JONAS_ROOT=<your install path>
	cd $JONAS_ROOT/examples; ant install


Running these examples:
----------------------
Follow instructions in the README files provided under :
src		    = simple examples
websample	= sample for web application
earsample	= sample for ear application
alarm		= the "alarm" demo
jps		    = the "petstore" 1.1.2 application (this directory will be removed)
cmp2		= example of EJB2.0 persistence
embedded_axis = example of ear application exposing web services with AXIS
separate_axis = example of ejb-jar exposing web services with an external AXIS webapp
petstore1.3 = the "petstore" 1.3 application
For some of them, run.sh or run.bat scripts are provided.
