Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Building the Higgins I-Card Manager Service"

(I-Card Manager Projects)
m (recategorized)
 
(45 intermediate revisions by 8 users not shown)
Line 1: Line 1:
== General CVS Information ==
+
{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
{| class="wikitable" style="text-align:left; border="1" cellpadding="5" cellspacing="0" 
+
This page contains instructions on how to check out and build web application from the source code of the involved Higgins components. See [[Firefox-Embedded Selector Solution]] for more information on the involved Higgins components and how they interact with each other, and see [[Deploying the Higgins I-Card Manager Service]] for information on how to deploy and configure this web application.
| rowspan="2" | Connection Type
+
| Committers
+
| :ext:
+
|-
+
| Anonymous access
+
| :pserver:
+
|-
+
| colspan="2" | Host
+
| dev.eclipse.org
+
|-
+
| colspan="2" | Repository Path
+
| /cvsroot/technology
+
|-
+
|} 
+
  
 +
==Prerequisites==
  
== I-Card Manager Projects ==
+
This guide assumes you have the following software:
Main I-Card Manager project is
+
* Eclipse IDE 3.3 or later (see http://www.eclipse.org/)
 +
* Subclipse svn plug- in v 1.2.4 or later (see http://subclipse.tigris.org/)
 +
* Web standard tools 2.0.1 or later (see http://www.eclipse.org/webtools/)
 +
* Apache Tomcat 5.5 or later (or other servlet container)
 +
* JDK 1.4 or later
  
{| class="wikitable" style="text-align:left; border="1" cellpadding="5" cellspacing="0" 
+
==Set up your Eclipse workspace==
|-style="background:#d6dee9; color:black" 
+
! border="1" align="left" valign="top" | Project
+
! border="1" align="left" valign="top" | Module Location
+
! border="1" align="left" valign="top" | Eclipse PSF
+
! border="1" align="left" valign="top" | ViewCVS
+
|-
+
|rowspan="2" |I-Card Manager
+
|rowspan="2" |org.eclipse.higgins/app/org.eclipse.higgins.icm
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/app/org.eclipse.higgins.icm/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/app/org.eclipse.higgins.icm/?root=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/app/org.eclipse.higgins.icm/committer.psf?root=Technology_Project&view=co committer]
+
|-
+
|}
+
  
 +
===Open a blank workspace===
  
The RPPS Core project depends on several other Higgins projects
+
After you start Eclipse, it should display a blank workspace. If you have already been working in Eclipse and your workspace is not empty, you can create a new empty one by selecting File -> Switch Workspace -> Other. Select a folder to use for your new, blank workspace. Your workspace should look like this:
 +
 
 +
[[Image:saml2idp-setup1.png|thumb|none|Blank Eclipse workspace]]
 +
 
 +
Make sure your blank workspace is configured to build all projects automatically:
 +
 
 +
[[Image:Blank-Build-Automatically.PNG|thumb|none|Build Automatically]]
 +
 
 +
===Configure JDK===
 +
 
 +
You should configure your Eclipse IDE to use JDK instead of JRE in order to be able to use Java compiler from ant scripts to build the Higgins components. Click Window -> Preferences and select Java -> Installed JREs. The default JRE is the one that was used to launch Eclipse, however you need to add a different one and set it as the workspace-default one for building. Higgins components are usually built with a Java 1.4 compiler.
 +
 
 +
[[Image:saml2idp-setup11.png|thumb|none|Configure JRE]]
 +
 
 +
''Note: You should also check Java -> Compiler -> Compiler compliance level, and make sure this matches the JRE you use to build the projects.''
 +
 
 +
===Configure server runtime===
 +
 
 +
In order to work with web applications, Eclipse needs to know about the servlet container (e.g. Tomcat) you want to use. Click Window -> Preferences and select Server -> Installed Runtimes. Click "Add...". Select the server you want to use (e.g. Tomcat 5.5), click "Next", specify the installation directory and click "Finish".
 +
 
 +
[[Image:saml2idp-setup10.png|thumb|none|Configure server runtime]]
 +
 
 +
''Note: It is recommended to install Tomcat at a path that does not contain any spaces.''
 +
 
 +
==Populate the Eclipse workspace==
 +
 
 +
The next step is to populate your Eclipse workspace with the required projects. This could be done in two simple steps:
 +
 
 +
* Check out main project.
 +
* Check out required projects.
 +
 
 +
===Check out main project===
 +
 
 +
First of all import '''org.eclipse.higgins.icm''' project into workspace, click '''File -> Import'''. In the import source list, select '''Other -> Checkout Projects from SVN'''. The URL for connecting to the Eclipse SVN is as follows:
  
 
{| class="wikitable" style="text-align:left; border="1" cellpadding="5" cellspacing="0"   
 
{| class="wikitable" style="text-align:left; border="1" cellpadding="5" cellspacing="0"   
|-style="background:#d6dee9; color:black" 
 
! border="1" align="left" valign="top" | Project
 
! border="1" align="left" valign="top" | Module Location
 
! border="1" align="left" valign="top" | Eclipse PSF
 
! border="1" align="left" valign="top" | ViewCVS
 
 
|-
 
|-
|rowspan="2" |IdAS
+
| https://dev.eclipse.org/svnroot/technology
|rowspan="2" |org.eclipse.higgins/plugins/org.eclipse.higgins.idas
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.idas/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.idas/?cvsroot=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.idas/committer.psf?root=Technology_Project&view=co committer]
+
|-
+
|rowspan="2" |I-Card Interfaces
+
|rowspan="2" |org.eclipse.higgins/plugins/org.eclipse.higgins.icard
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard/?cvsroot=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard/committer.psf?root=Technology_Project&view=co committer]
+
|-
+
|rowspan="2" |I-Card Registry
+
|rowspan="2" |org.eclipse.higgins/plugins/org.eclipse.higgins.icard.registry
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard.registry/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard.registry/?cvsroot=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.icard.registry/committer.psf?root=Technology_Project&view=co committer]
+
|-
+
|rowspan="2" |Higgins Registry
+
|rowspan="2" |org.eclipse.higgins/plugins/org.eclipse.higgins.registry
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.registry/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.registry/?cvsroot=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.registry/committer.psf?root=Technology_Project&view=co committer]
+
|-
+
|rowspan="2" |RSS-SSE Parser Library
+
|rowspan="2" |org.eclipse.higgins/plugins/org.eclipse.higgins.rsse
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.rsse/anonymous.psf?root=Technology_Project&view=co anonymous]
+
|rowspan="2" | [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.rsse/?cvsroot=Technology_Project viewcvs]
+
|-
+
| [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.higgins/plugins/org.eclipse.higgins.rsse/committer.psf?root=Technology_Project&view=co committer]
+
 
|-
 
|-
 
|}
 
|}
  
== Build Instructions ==
+
Checkout '''org.eclipse.higgins.icm''' project from '''https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/app/org.eclipse.higgins.icm'''
* '''Building within Eclipse IDE:'''
+
** The normal project build method will compile the source
+
** How to produce an Eclipse plugin:
+
*** '''Run->External Tools->Build RPPS Core plugin'''. This will run Ant build script to produce Eclipse plugin. Resulting plugin's jar along with the build's log file will be placed in "build/plugins" folder. See also: <sup>1</sup>.  
+
** How to produce a standalone jar:
+
*** '''Run->External Tools->Build RPPS Core jar'''. This will run Ant build script to produce standalone jar. Resulting jar file will be placed in "build/lib" folder. See also: <sup>1</sup>.
+
** How to produce javadoc:
+
*** '''Run->External Tools->Build RPPS Core javadoc'''. This will run Ant build script to produce javadoc. Javadocs will be generated in "build/doc" folder. See also: <sup>1</sup>.
+
  
 +
''Note: This may take several minutes, depending on your internet connection and current Eclipse server load.''
  
* '''Command-line builds:'''
+
===Check out required projects===
** How to produce an Eclipse plugin:
+
*** From the project directory, run '''"ant plugin -Declipse.home=<path to eclipse installation>"''' Resulting plugin's jar along with the build's log file will be placed in "build/plugins" folder.
+
** How to produce a standalone jar:
+
*** From the project directory, run '''"ant"'''. Resulting jar file will be placed in "build/lib" folder. See also: <sup>2</sup>.
+
** How to produce javadoc:
+
*** From the project directory, run '''"ant javadoc"'''. Javadoc will be generated in "build/doc" folder. See also: <sup>2</sup>.
+
  
 +
# Right click on org.eclipse.higgins.icm/'''projectWithDeps.psf -> Import Project Set ...'''
 +
# Answer '''No''' on the request whether to override '''org.eclipse.higgins.icm''' project
  
* '''Builds notes:'''  
+
''Note: This may take several minutes, depending on your internet connection and current Eclipse server load.''
** <sup>1</sup> Provided Eclipse launch configuration runs ant using the same JRE as the workspace. If you need to change JRE for some reason you will need to provide "-Declipse.home=<path to eclipse installation>" VM argument.
+
 
** <sup>2</sup> In order to process plugin specific files you will need to add "-Declipse.home=<path to eclipse installation>" option to the command line.
+
After checking out the projects, your workspace should be without build errors.
 +
 
 +
==Build Web Application==
 +
 
 +
Unfold ''org.eclipse.higgins.icm''-project contents in Package Explorer, choose '''build.xml''' and push the right mouse button (if this file already opened, push the right mouse button on the edit area). In popup menu choose item '''Run AS->Ant Build'''.
 +
 
 +
[[Image:ICM BUILD.JPG|thumb|none|Choose popup menu item]]
 +
 
 +
For correct complete build procedure you must have installed Java JDK, not JRE. (Also be sure, what enviroment variable JAVA_HOME contain path to JDK)
 +
 
 +
In the opened window ''"Edit configuration and launch"'', in tab '''Targets''' choose targets name ''''war''''.  
 +
 
 +
[[Image:ICM TARGETS.JPG|thumb|none|Choose targets name]]
 +
 
 +
Pass to tab ''JRE''. In the field "Separate JRE" you must choose from dropdown list needed JDK. If JDK is missed in list, you must install it.
 +
 
 +
[[Image:Jre-jdk.JPG|thumb|none|Edit configuration and launch]]
 +
 
 +
If you want to build org.eclipse.higgins.icm without Eclipse you can do that from console. Start console in a project folder. Then execute ''"ant war"''. For executing this command you must have preinstalled Ant on you system.
 +
 
 +
When build is proceed, all related projects also will be builded.
 +
 
 +
As result, the folder '''*\org.eclipse.higgins.icm\build\war''' will contain '''icm.war'''.
  
 
== See Also ==
 
== See Also ==
* [http://www.eclipse.org/higgins Higgins Home]
+
 
* [[Components]]
+
To configure and deploy this web application see: [[Deploying the Higgins I-Card Manager Service]]
 +
 
 +
[[Category:Higgins 1.x - Building]]

Latest revision as of 16:49, 25 April 2011

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}} This page contains instructions on how to check out and build web application from the source code of the involved Higgins components. See Firefox-Embedded Selector Solution for more information on the involved Higgins components and how they interact with each other, and see Deploying the Higgins I-Card Manager Service for information on how to deploy and configure this web application.

Prerequisites

This guide assumes you have the following software:

Set up your Eclipse workspace

Open a blank workspace

After you start Eclipse, it should display a blank workspace. If you have already been working in Eclipse and your workspace is not empty, you can create a new empty one by selecting File -> Switch Workspace -> Other. Select a folder to use for your new, blank workspace. Your workspace should look like this:

Blank Eclipse workspace

Make sure your blank workspace is configured to build all projects automatically:

Build Automatically

Configure JDK

You should configure your Eclipse IDE to use JDK instead of JRE in order to be able to use Java compiler from ant scripts to build the Higgins components. Click Window -> Preferences and select Java -> Installed JREs. The default JRE is the one that was used to launch Eclipse, however you need to add a different one and set it as the workspace-default one for building. Higgins components are usually built with a Java 1.4 compiler.

Configure JRE

Note: You should also check Java -> Compiler -> Compiler compliance level, and make sure this matches the JRE you use to build the projects.

Configure server runtime

In order to work with web applications, Eclipse needs to know about the servlet container (e.g. Tomcat) you want to use. Click Window -> Preferences and select Server -> Installed Runtimes. Click "Add...". Select the server you want to use (e.g. Tomcat 5.5), click "Next", specify the installation directory and click "Finish".

Configure server runtime

Note: It is recommended to install Tomcat at a path that does not contain any spaces.

Populate the Eclipse workspace

The next step is to populate your Eclipse workspace with the required projects. This could be done in two simple steps:

  • Check out main project.
  • Check out required projects.

Check out main project

First of all import org.eclipse.higgins.icm project into workspace, click File -> Import. In the import source list, select Other -> Checkout Projects from SVN. The URL for connecting to the Eclipse SVN is as follows:

https://dev.eclipse.org/svnroot/technology

Checkout org.eclipse.higgins.icm project from https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/app/org.eclipse.higgins.icm

Note: This may take several minutes, depending on your internet connection and current Eclipse server load.

Check out required projects

  1. Right click on org.eclipse.higgins.icm/projectWithDeps.psf -> Import Project Set ...
  2. Answer No on the request whether to override org.eclipse.higgins.icm project

Note: This may take several minutes, depending on your internet connection and current Eclipse server load.

After checking out the projects, your workspace should be without build errors.

Build Web Application

Unfold org.eclipse.higgins.icm-project contents in Package Explorer, choose build.xml and push the right mouse button (if this file already opened, push the right mouse button on the edit area). In popup menu choose item Run AS->Ant Build.

Choose popup menu item

For correct complete build procedure you must have installed Java JDK, not JRE. (Also be sure, what enviroment variable JAVA_HOME contain path to JDK)

In the opened window "Edit configuration and launch", in tab Targets choose targets name 'war'.

Choose targets name

Pass to tab JRE. In the field "Separate JRE" you must choose from dropdown list needed JDK. If JDK is missed in list, you must install it.

Edit configuration and launch

If you want to build org.eclipse.higgins.icm without Eclipse you can do that from console. Start console in a project folder. Then execute "ant war". For executing this command you must have preinstalled Ant on you system.

When build is proceed, all related projects also will be builded.

As result, the folder *\org.eclipse.higgins.icm\build\war will contain icm.war.

See Also

To configure and deploy this web application see: Deploying the Higgins I-Card Manager Service

Back to the top