Online documentation - Websydian v6.5

Setting Up a Developers Test Environment for Windows DWA Applications

This document describes the use of our tool for setting up a test environment for you Windows DWA applications. The idea is to supply developers whit an easy approach for setting up all the required component for the Websydian DWA environment in order to execute your application.

Step 1 - Download and install the the SUN Java JDK

Make sure that you have the Java SDK installed on your system. We recommend that you use the latest version, follow the link below to download.

You can download the latest version of Java JDK here

Step 2 - Download and install the Apache Tomcat

Make sure that you have the Apache Tomcat installed on your system. We recommend that you use the latest version, follow the link below to download.

During installation just keep default settings. The Tomcat is installed as a service make sure that the service is started by opening the windows Control Panel -> Administrative Tools -> Services.

You can download the latest version of Tomcat from our site here

You can test the tomcat by opening your browser and entering http://localhost:8080. You should see the Tomcat Welcome screen.

Step 3 - Download and extract the test environment files to your Plex release directory

Download the test environment using the link below and unpack the directory 'TestBench' and all subdirectories to your CA Plex Release directory

It is very important that the 'TestBench' directory is located in the 'Release' directory if in doubt take a look at the picture below!

Download the test environment package here

Step 4 - Setup the test environment

Some information is required by the test environment so please do the following:

Open the file named 'DeploySettings.cmd' located in the 'TestBench' directory with notepad.
Change the value of the 'LISTENER_IMPL' name to the implementation name of your implemented ApplicationServiceListener found in your CA Plex model.
Verify that the value of the 'TOMCAT_PATH' points to your Apache Tomcat installation directory.
If generated HTML files are not generated to the 'GEN' directory please change the value of the 'HTML_PATH'

Make sure all objects have been generated and build. Also make sure that an exe file have been generated for your ApplicationServiceListener as well as correct settings have been added to the ini file.

Step 5 - Test environment in action

The test bench is now ready for action. In the daily use of the test bench use these commands.

Use the command deploy.cmd located in the test bench to copy all required objects to the test bench structure and deploy the Websydian Web Server Component to your Apache Tomcat instance.
Use the command start.cmd to start your Websydian DWA application (Websydian Server and Application Services)
Use the command stop.cmd to stop your Websydian DWA application (Websydian Server and Application Services)
In order to access your application open your browser and enter the following URL http://localhost:8080/[listener_impl_name]. Replacing the [listener_impl_name] with the implementation name of your ApplicationServiceListener.

Background Information

Available settings

The following are the available settings for the 'Deploy' command. These settings can be found in the 'DeploySettings.cmd' file.

Setting	Description
LISTNER_IMPL	This is the implementation name of the ApplicationServiceListener as implemented in your local model
TOMCAT_PATH	The directory where the Apache Tomcat have been installed
URL_CONTEXT	The name to be used as the first part of the URL when accessing your application from the browser. This is also used as the name of the directory used when deploying the application into Apache Tomcat. For servlet engines this is also known as the context root. E.g. http://localhost:8080/contextroot/servletname, in this case the contextroot is the first part of the URL
HTML_PATH	The directory where html files are generated by the Websydian document template generators
RELEASE_PATH	The directory used as your release directory.
DEPAPP_PATH	Indicates where the deployment process is to copy objects for the Application Services to run.