Difference between revisions of "Aperi/sso"
(→Download STS Server)
(→Download Client Code)
|Line 77:||Line 77:|
== Client Code ==
To run the code:
To run the code:
Latest revision as of 18:00, 26 August 2008
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.
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 ‘Browse’ and select C:\Dev\Tools\apache-tomcat-5.5.26
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 STS Server
Go to http://download.eclipse.org/technology/higgins/downloads/sts.binding.axis1x.service/builds/S-S20080801-200808011007/index.html.
Click on 'war.zip' and download org.eclipse.higgins.sts.binding.axis1x.service-incubation-S20080801-war.zip to a temporary directory like (c:\temp). Unzip the archive so you can access the war file.
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'.
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)
From within the eclipse IDE, go to File --> Import --> Team --> Team Project Set
Choose C:\Dev\Code\STSServer\SetupFiles\stsclient.psf and click 'Finish'
This will download the client code into your Eclipse workspace.
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:\temp\org.eclipse.higgins.sts.binding.axis1x.service-incubation-S20080801.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).
Go to your ldap directory (C:\Program Files\OpenLDAP). Run 'slapd.exe'. This starts the LDAP server.
Setup Server Properties & Run It
Go to Run --> Run Configurations. On the left pane, right click Apache Tomcat and select 'New'. Change the name of the process to STS Server. Click the Arguments tab, and add the following to the VM Arguments section:
Click on the Classpath tab. Click on 'User Entries' and then 'Add External Jars' - select C:\Dev\Tools\apache-tomcat-5.5.26\bin\bootstrap.jar. Click 'Add External Jars' again. Select <YOUR_JDK_DIR>/lib/tools.jar.
Click Apply. Click Run.
Run Client Code
To run the code: