From Eclipsepedia

Jump to: navigation, search


You need the following prerequisites:

1. Eclipse J2EE IDE
2. Open LDAP
3. Tomcat 5.5
4. Java 1.5 (make sure you already have this installed)


From http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/R/eclipse-jee-ganymede-win32.zip download eclipse-jee-ganymede-win32.zip. Unzip the file into C:\Dev so that the following tree is created - C:\Dev\Tools\eclipse-jee-ganymede-win32\eclipse\eclipse.exe. Eclipse is now installed.


From http://tomcat.apache.org/download-55.cgi, download apache-tomcat-5.5.26.zip. Unzip the file such that you have the following directory tree - C:\Dev\Tools\apache-tomcat-5.5.26\bin. Apache is now installed.


From https://camelot.parityinc.net/STSDocs/openldap-2.2.29-db-4.3.29-openssl-0.9.8a-win32_Setup.exe download the .exe file. Install the program by double clicking on it. Install into the default location (C:\Program Files\OpenLDAP\). OpenLdap is now installed. We will configure later.

Configure Eclipse

Open Eclipse by clicking on C:\Dev\Tools\eclipse-jee-ganymede-win32\eclipse\eclipse.exe. Choose c:\Dev\Code\STSServer as your workspace.

Configure Tomcat in Eclipse:
Go to Window --> Preferences
Click on ‘Server’ Tree, then click on ‘Runtime Environments’
Click ‘Add’, then select Apache Tomcat v5.5
Click ‘Create a new local server’
Click ‘Next’
Click ‘Browse’ and select C:\Dev\Tools\apache-tomcat-5.5.26
Click ‘Finish’

Make sure the java runtime is pointed towards your Java 1.5 installation. Go to Window --> Preferences. Click on 'Java' --> 'Installed JREs'. Make sure the java runtime (on the right hand side) corresponds with your Java 1.5 installation. If not, add and select it.

Download some setup files, but first setup connection with CVS server. Go to Window --> 'Open Perspective' --> 'Other' --> 'CVS Repository Exploring'. Right click --> 'New' --> 'Repository Location'.
Host: dev.eclipse.org
Repository path: /cvsroot/technology
User: anonymous (or your user name)
Connection type: pserver
From the cvs server tree, drill down thru org.eclipse.aperi, thru STSServer, right click 'SetupFiles' --> 'Check Out'
Go back to J2EE or Java perspective to get to your workspace. (Window --> Perspective)

Configuring LDAP

Copy the contents of SetupFiles/ldap_windows_config.zip into the C:\Program Files\OpenLDAP directory. Overwrite any files. Copy the contents of SetupFiles/ldapData.zip into the C:\Program Files\OpenLDAP\data directory.

Installing Server WAR

File --> Import --> Web --> WAR File. Click 'Browse' and select C:\Dev\Code\STSServer\SetupFiles\org.eclipse.higgins.sts.binding.axis1x.service.war. Click 'Next'. Click 'Finish'. Give Eclipse a moment to validate. On the bottom set up tabs, click on the Servers tab. If it is not there, Window --> Show Views --> Servers. Right click the Tomcat Server instance shown in the Servers tab. Select 'Add or Remove Objects'. From the available projects, select org.eclipse.higgins.sts.bindings.axis1x.service and press the 'Add' button. Click Finish. From the Project Explorer view, copy the SetupFiles/server.xml file into the "Servers/Tomcat v5.5 Server at localhost" tree.

Setup JVM Security

Copy the files from SetupFiles/jrelibsecurity (cacerts, local_policy.jar, US_export_policy.jar) to <YOUR JDK DIR>/jre/bin directory. It is recommended that you make backup copies of the files that are already in that location before copying over them. Once the files have been copied, from that directory run the following command:
keytool -import -file root.cer -trustcacerts -storepass changeit -keystore cacerts
This will set your java runtime for the STS server. (NOTE: this has been tested on the Sun JVM).

Setup Process Properties

-Dcatalina.base="C:\Dev\Code\.metadata\.plugins\org.eclipse.wst.server.core\tmp0" -Dcatalina.home="C:\Dev\Tools\apache-tomcat-5.5.26" -Dwtp.deploy="C:\Dev\Code\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps" -Djava.endorsed.dirs="C:\Dev\Tools\apache-tomcat-5.5.26\common\endorsed" -Dorg.eclipse.higgins.sts.conf="C:/Dev/Code/org.eclipse.higgins.sts.binding.axis1x.service/WebContent/ConfigurationFiles" -Dorg.eclipse.higgins.sts.conf.file="ManagedConfiguration.xml"