Installing and Configuring Jetspeed1.4 Tutorial on Tomcat5

[Paul McCulloch <pa...@earthlink.net>]

Had to do it for work, so here it is:

Installing and Configuring Jetspeed1.4 Tutorial on Tomcat5

This is a variation on the install directions in the Jetspeed tutorial:
http://www.bluesunrise.com/jetspeed-docs/JetspeedTutorial.htm

It is probably a good idea to skim thru the tutorial's instructions so 
you get the idea.
It may be better to get the head or a dated revision from the CVS tree 
and build it, because it stands more of a
chance of being in synch with Tomcat's 2.4 Servlet spec. Tomcat 4x - 
Servlet 2.3 - is the recommended container.
People are talking about jetspeed1.5 and 2 on the user list.

Hopefully this could be useful to whoever maintains the build.xml file. 
Items of interest marked **

_____________________________________________________________________________________

Part 1.  First install Tomcat and deploy the jetspeed war file for a 
sanity check
_____________________________________________________________________________________


* Define the environment variables, and install Java1.4.x, Ant1.6, 
Tomcat5 per the tutorial.

* Stop Tomcat.

* Get the jetspeed.war.zip file from apache and unzip,
creating a new jetspeed home dir and extracting the war file.
http://jakarta.apache.org/site/binindex.cgi

* If you don't want to deal with the confirmation email:
winRAR the war file, or unzip to a temp directory, not the root tho.
edit the WEB-INF/db/jetspeed.properties file and add the line

     confirm.email.enable=false

* Dont forget - readd it to the war file with path intact.

* Copy the jetspeed war file to the .../tomcat5/webapps dir.

* Start up Tomcat.

* Go to http://127.0.0.1:8080/jetspeed

* Login as turbine, pass turbine, and it will take you to
http://127.0.0.1:8080/jetspeed/portal

** There is a known problem with some jdk1.4 versions, incl. mine, 
bundled with NetBeans. (1.4.2_01-b06)
If you see that there is a BBC portlet (RSS feed) problem, copy 
jetspeed's WEB-INF/lib/xalan.jar to
.../tomcat5/common/endorsed/ to make RSS feeds work.
The error looks like:

     "org.apache.xml.utils.WrappedRuntimeException: The output format 
must have a '{http://xml.apache.org/xalan}content-handler' property!

Note: If you log in as admin, pass jetspeed, you can click on the "Java 
Runtime" link to see your java info.

_____________________________________________________________________________________

Part 2.  Now get the tutorials and get the build environment working so 
you can play
with it. The tutorial has you alter the default portal by configuration 
files, etc.
_____________________________________________________________________________________


* Shutdown Tomcat

* Download the tutorials: 
http://www.bluesunrise.com/jetspeed-docs/jportal.jar

* Unzip jportal.jar to the jetspeed home directory.

* Create a new folder called 'war' in the jetspeed home and unzip the 
war file there.

** Without modifying the build.xml file, a quick way of getting things 
to work is to
copy the war/WEB-INF/lib directory up into war/lib

** Edit the jetspeed_home/build.properties file to point to your locations.
You can keep the unix-style path separator and leave an empty line at 
the end. Mine looks like:

# typical settings without source
#
jetspeed_home=/apache/jetspeed14/war
catalina_home=/apache/tomcat5
portlet_app_name=jportal
company=com.bluesunrise.jportal
jetspeed_jar=/WEB-INF/lib/jetspeed-1.4.jar
jetspeed_war=/jetspeed.war
jetspeed_lib=/WEB-INF/lib
jetspeed_conf=/WEB-INF/conf/

! Note the discrepancy between the "real" jetspeed home dir and the one 
specified for the build,
jetspeed14/war!

** Copy apache\tomcat5\common\lib\servlet-api.jar to 
jetspeed-1.4\war\WEB-INF\lib\
Otherwise no class def.

* Build the tutorial. Open a command prompt in the jetspeed home directory.
There should be a build.xml there. Run the command:
ant tutorial-all
If you notice that some of the properties files are not found the first 
time, you can rerun it.
Looks like they only get copied over after the first time.

* Copy the jetspeed.war to your jetspeed14/war dir.

** Depending on your version of Ant, edit the build.xml file to 
comment-out and uncomment
the correct jar updater. I got a zip file exception, duplicate entry, if 
I used the old one.
Somehow they got 2 hsqldb.jars in the war with the same path.
With Ant 1.6 I uncomment this and fix it by adding what was missing:

     <jar destfile="${dist.home}/${portal.app.name}.war" 
basedir="${build.home}" update="yes"/>

* At the command prompt in the jetspeed home directory, run the commands
ant tutorial-all
ant deploy
If it complains ( e.g. about not being able to delete stuff ) make sure 
Tomcat is not running
and clean, do over.

* Start Tomcat and open

http://localhost:8080/jportal/portal

  "You will see the Home Page for JPortal.
   To see JPortal customized for a user, logon to the system as:
   username = turbine, password  = turbine"
  
Any errors in tomcat window or logs, shutdown Tomcat, delete war files 
from tomcat5/webapps,
ant clean, ant tutorial-all, ant deploy, and use the Tomcat Manager app 
to reload if needed?
I think I had a cached empty war file due to the ant jar target above 
being incomplete.

* Resume tutorial at Planning for Your Portal Site
http://www.bluesunrise.com/jetspeed-docs/JetspeedTutorial.htm#_Toc26987004



---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jetspeed-user-help@jakarta.apache.org