GettingStarted.txt

These examples assume that you have installed a minimum of Java SE 11 and Apache ant.
There are existing .bat files for Windows platforms. The scripts are typically only one or two lines, so for other platforms just invoke the commands directly.

Java SE is available for download at https://www.oracle.com/java/technologies/downloads/.
Apache ant 1.10.11 is available for download at http://ant.apache.org.
Jakarta EE 10 - GlassFish 7 is available for download at https://glassfish.org/download

1. Download and and unzip the example zip file to a directory. We refer to that directory as <EXAMPLES_HOME>.

2. Edit <EXAMPLES_HOME>/config/setenv.bat to point to your Java SE 11 and ant 1.10.11 installation
   directories if JAVA_HOME and ANT_HOME have not been set in your environment.

3. Download and install Glassfish V7 from https://glassfish.org/download.
   We recommend installing the Glassfish Web Profile.

4. Edit <EXAMPLES_HOME>/config/common.properties and set the following properties:

       EXAMPLES_HOME - the folder in which the examples were unzipped 
       SERVER_HOME - the folder in which Glassfish was installed
  
   NOTE: Make sure you use a forward slash separator ('/') not a backward slash ('\')

5. Start Glassfish and the Derby database by invoking the startservers.bat script
   in <EXAMPLES_HOME>/bin.

6. Open <EXAMPLES_HOME>/examples/examplesHome.html to get started.

   For each server-based example:

        1. Run deploy.bat before running the example
        2. Run undeploy.bat when finished with the example

   The client-based examples have a run.bat script. They assume the database is 
   already runnning, as in step 5.