The following will allow you to setup and develop WDK applications (Webtop, administrator & DAM) using the Eclipse IDE. This setup is assuming that you are developing under Windows, though it should also be applicable to UNIX/Linux environments.

A) Software requirement
------------------------------
1. Java SDK (check the WDK based application's Release Notes for the certified version)
NOTE: This MUST be a 1.4.X Version or else Eclipse will not work!
2. Latest version of the Eclipse IDE (as of this writing it is 3.0) This should be the FULL SDK version which can be downloaded from http://www.eclipse.org/downloads/index.php, choose the "Latest Release" (3.0.1 at the time of this writing), and on the next page download Eclipse SDK for your platform.
3. Jakarta Tomcat (see WDK application's Release Notes for certified version) This can be downloaded from http://jakarta.apache.org
4. The Sysdeo Tomcat/Eclipse plugin http://www.sysdeo.com
5. Documentum WDK application (Webtop etc...) and optionally the WDK Development Kit


B.) Installation and Configuration
-----------------------------------------
1. Install the Java SDK. After the installer finishes set the following environment variables:
a. JAVA_HOME (such as C:\j2sdk1.4.2_05)
b. Add %JAVA_HOME%\bin to the PATH variable
It is critical that both of these are set or else Eclipse will not be able to properly compile the JSP pages.
2. Install Apache Tomcat.
3. Set the CATALINA_HOME environment variable to be the top level tomcat directory. Example C:\Program Files\Apache Group\Tomcat 4.1
4. Unzip the Eclipse distribution onto your local drive. This will create the "eclipse" folder.
5. Unzip the Sysdeo Tomcat plugin into the eclipse/plugins directory. (C:\eclipse\plugins)
6. Start Eclipse and go to Window -> Preferences.
You should see at the bottom of the list, in the left hand pane an entry for Tomcat. Select it and:
• Select the version of Tomcat you are using
• Select Tomcat Home (C:\Program Files\Apache Group\Tomcat 4.1)
• Expand the Tomcat tree in the left hand pane, select "Tomcat Manager Application" and set the username & password you had chosen when installing Tomcat
7. From the left hand pane select "Java" and expand the tree.
a. Go to Java + Compiler and choose the "Build Path" tab
b. Uncheck the "Scrub output folders..." option.
NOTE: IF YOU DON'T DO THIS THEN ALL OF THE WDK CLASS FILES WILL BE DELETED!!
8. Install WDK application (e.g. Webtop) and optionally the WDK Development Kit to customize the application.
9. Within Eclipse, finish configuring Tomcat. Go to the menu: Windows -> Preferences, and select Tomcat + JVM Options
a. Open the Catalina.bat file from %CATALINA_HOME%\bin.
b. for each of the CATALINA_OPTS (minus the leading %CATALINA_OPTS% entry) add it to the JVM parameters
c. For each of the classpath entries (minus the %CLASSPATH% entry), add it to the Classpath entry in Eclipse. Select jar/zip for each jar file and select Directory to add C:\Documentum\Config


III. Creating a New Project

1. Within Eclipse, go to File -> New -> Project menu
2. Select from Java -> Tomcat project
3. Give the project a name (note this name will be used as the root context under Tomcat. You will browse to : http://localhost:8080/)
4. DO NOT SELECT DEFAULT LOCATION!!
Browse to the top level of the web app you wish to configure/work with
i.e. C:\Program Files\Apache Group\Tomcat 4.1\webapps\webtop
5. Click next, and accept the default values (Eclipse can update the server.xml file)
6. click finish
7. Eclipse will prompt you to switch to the Java perspective, I would suggest that for the moment you select "No".
8. Under the resource perspective go to File -> New -> Folder
a. Select the project folder (do not drill down)
b. give the folder a name such as "build"
c. click "Advanced"
d. select "Link to File System"
e. browse to the WEB-INF\classes folder in the webapp project
9. Under Project -> Properties select "Java Build Path"
a. set the default output folder to be the folder you created in the previous step.
b. click "OK", and then go back into the same properties page
c. Select the "Libraries" tab and add a class folder, select WEB-INF/classes
d. Select "Add external Jars", and navigate to C:\Program Files\Documentum\Shared. Select ALL the jar files listed there
e. click OK

NOTE: You must do the previous 2 steps in order for the Eclipse validation and auto complete to work with the DFC & WDK classes.

10. Any sources you work with should put under WEB-INF/classes
11. To start Tomcat you simply use the "Start Tomcat" button on the toolbar bar at the top of the Eclipse GUI.

This setup will now allow you to run and debug you java code automatically.