Differences between revisions 8 and 9
Revision 8 as of 2007-02-21 13:06:28
Size: 6016
Editor: AteDouma
Comment:
Revision 9 as of 2009-09-20 23:46:46
Size: 6040
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 15: Line 15:
 * [http://java.sun.com/ Java JDK 1.4]
 * [http://ant.apache.org/ Ant 1.5]
 * [http://maven.apache.org/ Maven 1.0]
 * [[http://java.sun.com/|Java JDK 1.4]]
 * [[http://ant.apache.org/|Ant 1.5]]
 * [[http://maven.apache.org/|Maven 1.0]]
Line 21: Line 21:
 1. Dowload Eclipse from [http://www.eclipse.org eclipse.org]. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.  1. Dowload Eclipse from [[http://www.eclipse.org|eclipse.org]]. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.
Line 29: Line 29:
Name: [http://mevenide.codehaus.org/mevenide-ui-eclipse/features.html Mevenide] [[BR]] Name: [[http://mevenide.codehaus.org/mevenide-ui-eclipse/features.html|Mevenide]] <<BR>>
Line 32: Line 32:
If you see a java.lang.No''''''Such''''''Method''''''Error error with Mevenide during launch, use the following URL for the Update Manager[[BR]] If you see a java.lang.No''''''Such''''''Method''''''Error error with Mevenide during launch, use the following URL for the Update Manager<<BR>>
Line 36: Line 36:
Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the [http://eclipse-cs.sourceforge.net/ Checkstyle plugin site]. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running. Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the [[http://eclipse-cs.sourceforge.net/|Checkstyle plugin site]]. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running.
Line 38: Line 38:
You may also want to try [http://propsorter.sourceforge.net/veloeclipse Veloeclipse], a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values. You may also want to try [[http://propsorter.sourceforge.net/veloeclipse|Veloeclipse]], a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values.
Line 40: Line 40:
Name: Veloeclipse [[BR]]
Update Manager URL: `http://propsorter.sourceforge.net/veloeclipse` [[BR]]
Name: Veloeclipse <<BR>>
Update Manager URL: `http://propsorter.sourceforge.net/veloeclipse` <<BR>>
Line 43: Line 43:
Some developers also use [http://xmlbuddy.com/ XMLBuddy]. Some developers also use [[http://xmlbuddy.com/|XMLBuddy]].
Line 45: Line 45:
The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse [http://www.sysdeo.com/eclipse/tomcatPlugin.html]. This is a manual install. The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse [[http://www.sysdeo.com/eclipse/tomcatPlugin.html]]. This is a manual install.
Line 47: Line 47:
There are more Eclipse plugins available at [http://www.eclipse-plugins.info/]. There are more Eclipse plugins available at [[http://www.eclipse-plugins.info/]].
Line 53: Line 53:
Download and install Tomcat from [http://jakarta.apache.org/tomcat/]. Download and install Tomcat from [[http://jakarta.apache.org/tomcat/]].
Line 55: Line 55:
Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to [http://issues.apache.org/jira/browse/JS2-55] for more information. Otherwise, Tomcat 4 or 5 are equally good choices. Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to [[http://issues.apache.org/jira/browse/JS2-55]] for more information. Otherwise, Tomcat 4 or 5 are equally good choices.
Line 64: Line 64:
Enter the following information in the Add CVS Repository dialog: [[BR]]
Host: `cvs.apache.org` [[BR]]
Repository path: `/home/cvspublic` [[BR]]
User: `anoncvs` [[BR]]
Leave Password empty. [[BR]]
Enter the following information in the Add CVS Repository dialog: <<BR>>
Host: `cvs.apache.org` <<BR>>
Repository path: `/home/cvspublic` <<BR>>
User: `anoncvs` <<BR>>
Leave Password empty. <<BR>>
Line 85: Line 85:
Maven Home will probably be something like: [[BR]] Maven Home will probably be something like: <<BR>>
Line 88: Line 88:
Maven Local Home: [[BR]] Maven Local Home: <<BR>>
Line 91: Line 91:
Maven Local Repository: [[BR]] Maven Local Repository: <<BR>>
Line 96: Line 96:
Name: `MAVEN_REPO` [[BR]] Name: `MAVEN_REPO` <<BR>>

Getting Started Developing Jetspeed

Introduction

This section is for developers who want to work on Jetspeed 2 itself, not necessarily for portlet developers.

Setting up a development environment

There are many different ways to set up a development environment that will enable you to effectively develop Jetspeed 2. This example uses Eclipse, Tomcat 5, and MySQL.

Prerequisites

Download and install these packages:

Setting up Eclipse

  1. Dowload Eclipse from eclipse.org. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.

  2. Install Eclipse plugins:

At a minumum you will need to install the Mevenide and Checkstyle plugins. Mevenide is used for working with Mavenized projects. Checkstyle is a Java programming style enforcer.

The easiest way to install plugins is through the Eclipse Update Manager. Choose Help > Software Updates > Find and Install. In the next dialog, choose "Seach for new features to install" and then "Add Update Site".

Name: Mevenide
Update Manager URL: http://mevenide.codehaus.org/release/eclipse/update/site.xml

If you see a java.lang.NoSuchMethodError error with Mevenide during launch, use the following URL for the Update Manager
http://mevenide.codehaus.org/update/3.0/site.xml

Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the Checkstyle plugin site. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running.

You may also want to try Veloeclipse, a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values.

Name: Veloeclipse
Update Manager URL: http://propsorter.sourceforge.net/veloeclipse

Some developers also use XMLBuddy.

The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse http://www.sysdeo.com/eclipse/tomcatPlugin.html. This is a manual install.

There are more Eclipse plugins available at http://www.eclipse-plugins.info/.

Note on the Eclipse workspace: If you are using Windows, set your Eclipse workspace (in the annoying window that opens up every time you launch Eclipse until you finally notice the checkbox) such that the directory path does not contain any spaces. You will have trouble building if the path to your workspace contains spaces.

Setting up Tomcat

Download and install Tomcat from http://jakarta.apache.org/tomcat/.

Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to http://issues.apache.org/jira/browse/JS2-55 for more information. Otherwise, Tomcat 4 or 5 are equally good choices.

Checking out Jetspeed

The first thing you need to do is add a CVS respository: Window > Open Perspective > CVS Repository Exploring

Make sure the "CVS Repositories" tab is selected and right-click (Control-click on the Mac) that pane. Choose New > Repository Location... in the context menu. Alternatively, you can click the "Add CVS Repository" button to the right of the tabs.

Enter the following information in the Add CVS Repository dialog:
Host: cvs.apache.org
Repository path: /home/cvspublic
User: anoncvs
Leave Password empty.

The connection type is pserver, using the default port.

You can then drill down to the jakarta-jetspeed-2 module from HEAD.

Right-click (control-click on the Mac) on the jakarta-jetspeed-2 module and choose Check Out As... from the context menu.

Select "Check out as a project in the workspace" and click the Finish button.

Now switch from the CVS perspective to the Java perspective (Window > Open Perspective; you may need to choose Other... and select Java from the resulting dialog).

Presto! You have a checkout of jakarta-jetspeed-2. You'll probably get a ton of errors. Luckily they're all variations on the same theme: Unbound classpath variable: MAVEN_REPO/blah/blah/blah.

Before we go any further, make sure that the Maven settings are correct in Eclipse. Open the Eclipse Preferences dialog and select the Maven > Locations. In the author's experience on Mac OS X, it was neccessary to enter the Java Home path as a URL: file:/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home

Maven Home will probably be something like:
/usr/local/maven-1.0

Maven Local Home:
/your/home/.maven

Maven Local Repository:
/your/home/.maven/repository

OK -- now we're ready to fix those MAVEN_REPO errors. In the Preferences window, click Java > Build Path > Classpath Variables. Click the "New..." button and enter the following:

Name: MAVEN_REPO
Path: the path to your Maven Local Repositry, i.e. /your/home/.maven/repository

Click OK until you've saved your preferences and the Prefences window is closed.

The build errors should disappear. Right-click (control-click) the project name "jakarta-jetspeed-2" and choose Maven > Run Maven... . In the text field to the left of the "Choose..." button, enter allClean allBuild and click "Run".

That's it, you're building Jetspeed! Any build problems from here on are left as an exercise to the reader. :)

Jetspeed2/DevelopingJetspeed2 (last edited 2009-09-20 23:46:46 by localhost)