Installation

This guide describes a step-by-step procedure to download and install b-frame.

Prerequisites

We assume that you have installed the Java Development Kit (JDK) available from SUN. The java and javac command need to found, i.e., the path to the JDK has to be added to your PATH environment variable. It is also necessary to set the environment variable JAVA_HOME to the installation directory of the JDK (C:\j2sdk1.4.1_02, e.g.). If JAVA_HOME is the path to where the JDK is installed then you should add an entry %JAVA_HOME%\bin to the PATH system variable. 
The best way is to set the values permanently, so you don't have to set them every time again you want to use <b-frame/>. You can edit or add environment variables under Windows by right-clicking on your work-place icon and follow the path "Properties->Advanced->Environment variables".

You can verify the JDK installation by executing "java -version" in a terminal window.

Downloading <b-frame/>

Currently you have two options

• Download the complete distribution including JBoss, Ant, and all the other tools listed below (RECOMMENDED) and unzip it to a directory of your choice, say C:\b-frame.
  
• Or download and unpack just the b-frame ZIP file, download all needed tools yourself and edit the configuration files. You'll need to download
  
  • Ant (Build tool)
    
  • Xalan-J (XSLT processor)
    
  • BSF (Bean Scripting Framework)
    
  • Rhino (Javascript engine)
  • JBoss (J2EE application server)
    
  Install Ant and JBoss first and then unzip the Xalan, BSF and Rhino distributions. Copy xalan.jar, bsf.jar and js.jar to the ANT_HOME/lib directory.
  

Installation

Go to the directory where the <b-frame/> examples are installed (C:\b-frame\b-frame-examples, e.g.) and copy the files build_example.properties to build.properties
and setpath_example.bat to setpath.bat. If you've chosen the complete distribution, you're done so far and may proceed with the next section.
Otherwise you have to edit build.properties and setpath.bat and set the paths to the JBoss and Tomcat installation directories. You can also change the used database here, this is explained in detail in the tutorial.

Compilation

Compile and deploy the application (In C:\b-frame\b-frame-examples) with the command

    build deploy

Then create and fill the database tables with the commands

    build cre-schema
    build test-data


Starting JBoss

Use the Explorer to go the directory where JBoss is installed and start the run.bat in the bin directory (Remember that JAVA_HOME must be set properly). You will see a lot of messages, that's ok. You can halt JBoss by typing Control-C or by closing the terminal window.

    cd C:\b-frame\JBoss\bin
    run

Testing it

Now can use the application by choosing one of the following URLs in your browser

The institute's view: http://localhost:8080/university/institute
The student's view: http://localhost:8080/university/student