Sun Java Solaris Communities My SDN Account Join SDN
 
Java Adventure Builder Demo 1.0 Early Access 3.1

Installing the Demo

 


Guidelines, Patterns, and code for end-to-end Java applications.

Java Adventure Builder Demo 1.0 Early Access > Installing the Demo

Installing the Demo

This section describes how to install the Java  Adventure Builder Demo, version 1.0 Early Access 3.1 

System Requirements

Before installing the demo, you need to download and install the following software:           

    1. Java 2 SDK, Standard Edition (J2SETM SDK), v1.4.1_02 : download here                        

    2. Java 2 SDK, Enterprise Edition (J2EETM SDK), v 1.4 Beta2 Release: download  here

Note 1 : When downloading J2EE v1.4Beta2, you have the choice to download and install a bundle that comes with J2SE v1.4.1_02. If you choose this approach, you need not install J2SE 1.4.1_02 seprately.

Note 2 : You also have the choice to download and install J2EE v1.4Beta2 without any J2SE version bundled with it. If you choose this approach, ensure that the J2SE version you use is J2SE v1.4.1_02. There are known problems when J2EE v1.4Beta2 is used with J2SE v1.4.2 which are currently getting fixed.

Required Environment Variables

You must set the environment variables JAVA_HOME and J2EE_HOME ,  which you do as follows: 
    JAVA_HOME must point to the root directory of your J2SE SDK  installation.  For example, if you installed the J2SE SDK in c:\jdk1.4.1 ,  then set the value of JAVA_HOME to that path.

    J2EE_HOME must point to the root directory of your J2EE SDK   installation. For example, if you installed the J2EE SDK in /usr/local/java/j2sdkee1.4 , then set the value of J2EE_HOME to that path.

Your PATH must include the following directories as the first two elements.

        For Unix:
        $JAVA_HOME/bin
        $J2EE_HOME/bin
 
        For Windows:
     %JAVA_HOME%\bin 
     %J2EE_HOME%\bin

Also your CLASSPATH must include the following .

        For Unix:
        $J2EE_HOME/lib/j2ee.jar
 
        For Windows:
     %J2EE_HOME%\lib\j2ee.jar

Installing the Demo

NOTE : If you are using this application on an  already installed instance of the J2EE 1.4 Beta2 server and you had already  deployed the version of adventure builder application that is present as part of the samples bundle of the J2EE 1.4 Beta2 server, you have to undeploy all the adventure builder application components completely before performing the instruction listed below. For instruction on uninstalling the adventure builder application components, see the next section of this document.

To install the demo, follow these steps:
    1. Unzip the distribution bundle (adventure-1_0-ea3.1.zip) into any   directory.                               

    Unzipping the distribution bundle creates a directory called adventure1.0ea3.1 . The rest  of this documentation refers to this directory as <adventure.home> .

2. Start Pointbase database and wait till it is up and running.               

If you are using Unix, open a shell prompt and enter these commands:

cd $J2EE_HOME/pointbase/tools/serveroption
sh startserver.sh

If you are using Windows, open a command prompt and enter these commands:

cd %J2EE_HOME%\pointbase\tools\serveroption
startserver.bat

3. Start the J2EE server and wait till it is up and running.

If you are using Unix, open a shell prompt and enter these commands:     

cd $J2EE_HOME/bin
asadmin start-domain
If you are using Windows, open a command prompt and enter these commands:     
cd %J2EE_HOME%\bin
asadmin start-domain

4. Configure your environment by changing the settings in <adventure.home>/setup.properties   file



Property Name Description Examples
j2ee.server.name Host name of the server where the J2EE SDK is installed localhost
j2ee.server.username The name of admin user you entered while installing the J2EE 1.4 Beta2 server admin
j2ee.server.password The password you entered for the admin user while installing the J2EE 1.4 Beta2 server
<your password>
j2ee.adminserver.port
The port number for admin server you chose at the time is installation of the J2EE 1.4 Beta2 server
4848
 

5. Run the setup script to install and configure database resources.

    If you are using Unix, open a shell prompt and enter these commands:
    cd <adventure.home>
    sh setup.sh
    If you are using Windows, open a command prompt and enter these commands:
    cd <adventure.home>
    setup.bat
    6. Run the setup script to deploy the applications.       

    If you are using Unix, open a shell prompt and enter these commands:

    cd <adventure.home>
    sh setup.sh deploy-apps
    If you are using Windows, open a command prompt and enter these commands:
    cd <adventure.home>
    setup.bat deploy-apps

After installing the demo, you can start using it .

Uninstalling the Demo

First check if you have already deployed versions of adventure builder application  in your server by entering the following command and ensure that no application  with name adventure or opc is present :

asadmin list-components
If either or both applications adventure, opc are present in the server, undeploy them using the following command :
asadmin undeploy <application name>