##### General Information

- Overview
- Features
- Specification
- Getting Started
- Howto Build Turbine
- Changes

##### Documentation

- Services
- Howtos
- Wiki
- JavaDocs

##### Development

- Proposals
- How To Help
- Todo

##### Project Documentation

- Project Information
- Project Reports

##### Apache

- Apache Website
- License
- How the ASF works
- Sponsorship
- Thanks
- Security

VAJava and WebSphere Test Environment

## Forewords and Requirements

This tutorial explains how to run Turbine within VisualAge for Java WebSphere Test Environment.

This tutorial works with VAJava 3.5.2 and 3.5.3. Please tell us if you find that it works with other versions.

## Step 1 : Import the correct packages in VAJava

Let's assume the following conventions : `{Turbine dir}` is the directory where you have unzipped the Turbine distribution or sources and `{VAJava dir}` is the directory where VAJava is installed. Let's also define `{WTE dir}` to be the WebSphere Test Environment directories, i.e. `{VAJava dir}/ide/project_resources/IBM WebSphere Test Environment`.

You need to create a project : Turbine

Import into Turbine project all JARS/SRC associated with the specific Turbine release

## Step 2 : Modify WebSphere Test Environment

## Edit default.servlet_engine

Edit `{WTE dir}/properties/default.servlet_engine` and add the following under the `default_app` webgroup :

        <websphere-webgroup name="turbine">
           <description>Turbine Application Framework</description>
           <document-root>$approot$/web</document-root>
           <classpath>$approot$/servlets</classpath>
           <root-uri>/turbine</root-uri>
           <auto-reload enabled="true" polling-interval="3000"/>
           <shared-context>false</shared-context>
        </websphere-webgroup>

## Create a turbine directory

Create a directory called `turbine` under `{WTE dir}/hosts/default_host`. Under `turbine` create another 2 subdirectories : `servlets` and `web`.

Create the following directories (which is similiar to the TDK distribution) under the web directory.

- images
- logs
- resources
- stylesheets
- templates
- WEB-INF/conf

Copy the TurbineResource.properties file to the "WEB-INF/conf" directory. The templates, logs etc. directories are quite self explanetory I think.

## Create a turbine.webapp file

Create a `turbine.webapp` file in `{WTE dir}/host/default_app/servlets` and put the following content :

    <webapp>
       <name>turbine</name>
       <description>Turbine Application Framework</description>
       <error-page>/ErrorReporter</error-page>

       <servlet>
          <name>turbine</name>
          <description>Turbine Application Framework</description>
          <code>org.apache.turbine.Turbine</code>
          <servlet-path>/ServletRedirector</servlet-path>
          <autostart>true</autostart>
       </servlet>
     </webapp>

## Step 3 : Edit VAJava workspace classpath

In the WebSphere Test Environment under Servlet Engine, add Turbine to the classpath.