Difference between revisions of "BuildingAndDeployingH1H3"

Latest revision as of 09:45, 9 July 2007

This page describes the process of downloading and building Higgins components, as well as deploying the RPPS and ICM components of Higgins on a Tomcat server. These two components are prerequisites for the H3 deployment scenario (see Deployments).

Checking out and building sources

The Higgins CVS repository is located at :pserver:anonymous@dev.eclipse.org:/cvsroot/technology. The HEAD contains a directory named "org.eclipse.higgins", which has applications, plugins, documentation and other resources related to Higgins.

Using the Eclipse IDE, Higgins components can be checked out from that repository using the CVS Import Wizard or "CVS Repository Exploring" IDE perspective.

After checking out components, it may be necessary to download additional dependencies (as listed on Components) and add them to the build path. After that, the components should build in the Eclipse IDE.

How to set up the H3 deployment

This section documents the process of installing the Higgins RPPS and ICM components on a Tomcat server (i.e. the prerequisites for the Higgins H3 deployment scenario).

Preparation

The following steps are required in preparation for both the RPPS and ICM component:

1. Make sure Eclipse 3.2.1 or later is installed
2. Download and install Tomcat 6.0.10 (5.5 does not work; and other versions of 6.0 have not been tried).
3. Make sure there are no spaces in the path of JDK and Tomcat!
4. Use JDK 1.5, not 1.6 (which has problems with serialization??)
5. Download and install Java Web Services Developer Pack from http://java.sun.com/webservices/downloads/previous/index.jsp
6. Install JWSDP .jar libraries into the Tomcat lib/ directory according to the JWSDP documentation: jaxrpc/lib/*, saaj/lib/*, fastinfoset/lib/*, sjsxp/lib/*

Installing the ICM component

The ICM (ICard Manager) is built using the Maven software project management tool.

For installing ICM locally, the following steps are necessary: (also see ICard_Manager_CVS)

1. Install m2eclipse plugin for Eclipse IDE.
2. Checkout project org.eclipse.higgins.icm2 from CVS repository at :pserver:anonymous@dev.eclipse.org:/cvsroot/technology
3. Import project into Eclipse workspace (File->Import->General->Existing Projects into workspase).
4. Adjust the location of the RPPS service in jaxrpc-rpps-client-config.xml.
5. Add Maven build configuration (Project->Properties->Builders->New->m2 build)
   1. Type build configuration name
   2. Choose base directory
   3. Add goals "clean install"
   4. Add "settings.localRepository" variable (Variables...->Edit variable->New)
   5. Set value of "settings.localRepository" variable to maven repositary (user.home/.m2/repository)
   6. Add parameter name "settings.localRepository" and value "${settings.localRepository}"
6. Run build.
7. Deploy $basedir/icm-web/target/icm.war.
8. Install necessary libraries to the Tomcat lib/ directory:activation.jar, mail.jar
9. Test ICM by accessing http://<your_machine>:<tomcat_port>/icm/

Installing the RPPS component

For installing RPPS locally, the following steps are necessary: (also see RPPS_Web_CVS)

1. Make sure Web Standard Tools 1.5.4 for Eclipse is installed
2. Checkout project org.eclipse.higgins.rpps.web from CVS
3. Create .jar files from required other Higgins projects, put them into {project.home}/web/WEB-INF/lib and add them to the build path. A list of required projects is here: RPPS_Web_CVS
4. Adjust wsbuild.properties and set jwsdp.home appropriately to point to the JWSDP installation
5. Export project to rpps.war file in {project.home}/dist/
6. Run ANT build wsbuild.xml with default target to create WS WAR file
7. Deploy WAR file from the {project.home}/dist/tomcat dir to Tomcat AS.
8. Install Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files according to online instructions; install it for the JDK/JRE used to run Tomcat
9. Create directory {user.home}/.higgins/.icard/testXmlCardStore
10. Test web service endpoint by accessing http://<your_machine>:<tomcat_port>/rpps/RPPSService?WSDL

Adjusting HBX to use the local RPPS

Once RPPS and ICM are running locally on Tomcat, the HBX can be configured to use them, in order to complete the H3 deployment.

1. Select Tools -> Higgins -> Higgins Options in Firefox
2. Change the default value http://graceland.parityinc.net to http://<your_machine>:<tomcat_port>