First Time Setup

Follow the setup process below for the standard ACT development environment.


  • Windows
  • Java SE Development Kit (JDK)
  • Tomcat & decorators webapp
  • Eclipse
  • ITAG webappCreator

If you are not familiar with the above technologies or want to see how the UXT stack compares with the JLink UI, visit our fundamentals page.


Most ACT developer workstations run Windows 7 Professional (64-bit). These instructions may work on MacOS 10.6 (Snow Leopard) -- skip the "JDK" section below and change installation paths accordingly.


If you already have a working JDK, you may skip this section as long as the PATH environment variable includes your JAVA_HOME\bin. Otherwise, please follow the instructions below.

  1. Download latest Java SE Development Kit 1.6 (and 1.7 and 1.8) from (
  2. Follow the instructions on Sun’s website (


If you already have a working servlet container setup with the JLink environment on your desktop, you may skip this section as long as you have the /decorators webapp. Otherwise, you may follow the instructions below.

The current ACT production environment uses Apache Tomcat 6, which supports Servlet API 2.5 and JSP 2.1.

Most developers put Apache Tomcat on their desktop development environment.

  1. Follow the installation instructions in Y:\SPT\Tomcat\tomcat_v6.

In this guide, we’ve installed Tomcat 6 to C:\apache-tomcat-6.0.20.


Install Eclipse

  1. Download and install "Eclipse IDE for Java EE Developers" (Eclipse Helios 3.6 is the latest version tested with these instructions.)
  2. Follow the instructions on Eclipse's website for installation.
  3. Download and save the Java Formatter & JavaScript Formatter xml files to your eclipse directory
    1. UCSD Java Formatter xml file (i.e save as UCSD-Java.xml)
    2. in Eclipse goto Window -> Preferences -> Java -> Code Style -> Formatter -> Import
    3. in Eclipse goto Window -> Preferences -> Java -> Editor -> Save Actions
      1. Check “Perform the selected actions on save”
      2. Enable “Format source code, Format all lines” and “Organize imports”
    4. To turn off formatting in special cases for Java use:
      1. // @formatter:off
      3. // @formatter:on
    5. UCSD JavaScript Formatter.xml (i.e save as UCSD-JavaScript.xml)
    6. in Eclipse goto Window -> Preferences -> JavaScript -> Code Style -> Formatter -> Import
    7. in Eclipse goto Window -> Preferences -> JavaScript -> Editor -> Save Actions
      1. Check “Perform the selected actions on save”
      2. Enable “Format source code”
    8. Right click on the Java Source folder and select Source -> Format
    9. Right click on the folder(s) containing your JavaScript and select Source -> Format (DON'T FORMAT 3rd PARTY LIBRARIES OR MINIFIED FILES)

Install Subversive

UXT makes extensive use of the Subversion revision control system, as does the rest of ACT. We recommend the use of the very useful Subversive plugin. To install, go to the Subversive, follow the instruction on polarion'swebsite.


  1. Under Window > Preferences > General > Workspace, set default character set to UTF-8 and set default line ending to Unix (Believe me, you don't want to keep cp-1252 as your default.)
  2. Under Window > Preferences > Web, navigate to the CSS, HTML, and JSP menus and set default character set to "ISO 10646/Unicode (UTF-8)"
  3. Under Window > Preferences > Java > Installed JREs, add the Java Development Kit you just installed (default path should be possibly C:\Program Files\Java\jdk1.6.xx) and check the box on the left to set it as the workbench default. Note you must have a Java Development Kit as the workbench default -- a Java Runtime Environment is not sufficient no matter how recent.
  4. Under Window > Preferences > Server > Runtime Environments, add Apache Tomcat 6.0 and setTomcat Installation Directory to the path of the Tomcat 6.0 instance you installed in Step #3.

Configure Common Build

You'll only need to do the folowing steps if you are following the standard setup instructions.  If you are following the Eclipse setup instructions, you may skip this step.

Create a file under ~/build/. In Windows, this will be C:\Documents and Settings\[YOUR_USER_NAME]\build\

Add the following to


In this guide, this value is:


The default webapps directory for Tomcat 6 is [TOMCAT_HOME]\\webapps and the default lib directory is[TOMCAT_HOME]\\lib. If you are using Tomcat 4 or any other servlet container that has a different directory setup, please update the following variables:


Eclipse Setup for Decorators Web Application

  1. Get the currently supported version of the decorators webapp from TeamForge. (See "Download" page for current version.)
  2. Find the build.xml file at the project root level and right-click
  3. Select Run As > Ant Build...
  4. Check deploy and click on Run button

Eclipse Setup for Template Web Application

Install webappCreator

  1. Get the currently supported version of webappCreator from TeamForge. (See "Download" page for current version.)
  2. Look for build.xml in the project root folder and one folder webapp" -- if so the import was successful.

Creating a New Webapp

  1. Find the build.xml file at the project root level and right-click
  2. Select Run As > Ant Build
  3. Check the Eclipse console to monitor execution
  4. You will be prompted for the name of the new webapp. Enter the desired name (e.g. "hello")
  5. Once the Ant build completes, import the new project folder into your workspace:
    1. Choose File > Import then General > Existing Project into Workspace
    2. In the next screen, go to Root Directory and navigate to your workspace folder
    3. Select your new project folder
    4. Make sure Copy projects into workspace is unchecked (it's already there)
    5. Click Finish and check to make sure the new project is visible in Project Explorer
  6. Right-click on the new project and select Properties
  7. Go to Java Build Path > Libraries and click on the Add Library button
  8. Select Server Runtime then choose Apache Tomcat 6.0
  9. All webapp dependencies should now be resolved. Happy coding!

Want to know more?

If you want to find out more about webappCreator and what it generated for you. Visit the webappCreator section.

Launching your webapp

To launch the new webapp from Eclipse:

  1. Switch to the Servers tab
  2. Right-click and select New > Other
  3. In the "Select a Wizard" dialog box, select Server > Server
  4. In the Define New Server window, select Apache Tomcat 6.0 as server type, and change Server Nameto JLink Tomcat or other name of your choice
  5. Double-click on the new server in the Servers tab, which should open an Overview window
  6. Under Server Location select Use Tomcat installation
  7. Close and save to apply changes
  8. Right-click on your new project in Project Explorer and select Run As > Run on Server
  9. In the Run on Server dialog, select Choose an existing server and JLink Tomcat
  10. Check the Always use this server when running this project box and click Finish to launch Tomcat