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.
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.