I needed an application portal on a server. First I tried Zope, but the content mgmt add-on Plone which I also required asked for so many additional updates that I dropped it. Now, after a lot of tweaking I finally got the Apache Jetspeed application portal up and running on SuSE 9.0. It was sort of tricky, so I thought I'd post my notes, just in case someone else tries to do the same thing. A kind of nano-howto... This is a long mail. If you're not into Jetspeed, move this to the trash bin now :-) ========================================================================= DISCLAIMER I do not guarantee that these steps will work for you. They worked for me on two completely different hardware platforms, both running SuSE 9.0 Pro, so there is a *fair* chance... Neither do I explain any purposes or features of said application(s), just how to make them run on SuSE 9.0. The rest is up to you! ========================================================================= INSTALLING THE APACHE JETSPEED APPLICATION PORTAL ON SuSE 9.0 PRO. ----------------------------------------------------------------------------- First of all, Jetspeed requires a Java Servlet Engine & Container. Also being part of the Apache project Tomcat is the natural choice. On the SuSE CDs there's Tomcat ver 4.1.27, but the first testsl showed that tweaking is required, so I decided to go directly to Tomcat 5. Some other things are required as well, but they can be found on the CDs, so let's start there. Here's a list over what we need to do: Install from the CD:s - Java2 SDK 1.4.2 - Java2 JRE 1.4.2 - Apache-ant 1.5.3 Install Tomcat from source --------------------------- From www.apache.org, download jakarta-tomcat-5.0.19-src.tar.gz Unpack: master:~> tar -zxvf jakarta-tomcat5-5.0.19.src.tar.gz Tar unpacks all the source files, but actually we're only interested in one 'build.xml'-file. First we need to decide where to build Tomcat. I wanted to install it under /opt. As root: master:~> md /opt/jakarta master:~> cp jakarta-tomcat-5.0.19-src/build.xml /opt/jakarta/build.xml master:~> cd /opt/jakarta master:~> ant Ant will open the build.xml, download all required sources from the web, compile and install Tomcat. It will take a few minutes, so go get a cup of good Java coffee. When the installation is complete (hopefully without errors) there will be a whole bunch of new directories under /opt/jakarta. Tomcat is installed in /opt/jakarta/jakarta-tomcat-5/build, and from now on we'll refer to this directory as $CATALINA_HOME. (Catalina is the name used in the Apache Tomcat project). Then we'll need to give a user rights to manage Tomcat. In a text editor, open the file $CATALINA_HOME/conf/tomcat-users.xml Edit one of the existing users or add a new user, with password, and assign her/him the roles as "tomcat,manager". Save and exit. Testing Tomcat. ---------------- Start Tomcat. master:~> cd $CATALINA_HOME/bin/startup.sh Now, in a browser window go to http://localhost:8080 If everything went right you should see the Tomcat main page. Stop Tomcat again. master:~> cd $CATALINA_HOME/bin/shutdown.sh Now it's time to install Jetspeed. -------------------------------- From www.apache.org download jetspeed-1.4-src.zip and unpack. Lets call the top expanded directory $JETSPEED. Change to master:~> cd $JETSPEED/build In a text editor, open the script 'build.sh'. Under SuSE 9.0 & Sun Java 1.4.2 the following line should look like this: JAR_DEPENDENCIES='ls /usr/share/java/jaxen-1.0-FCS/lib/jdom*.jar 2>/dev/null' Save and exit. Compile and build the war-archive: master:~> ./build.sh war Now we're almost there. Only need to copy some jars: master:~> cp $CATALINA_HOME/build/bin/commons-logging-api.jar /usr/lib/java/lib/commons-logging-api.jar master:~> cp $CATALINA_HOME/build/bin/commons-logging-api.jar /usr/lib/java/jre/lib/ext/commons-logging-api.jar master:~> cp $JETSPEED/lib/xalan-2.3.1.jar $CATALINA_HOME/common/endorsed/xalan-2.3.1.jar and finally Jetspeed itself: master:~> cp $JETSPEED/bin/jetspeed.war $CATALINA_HOME/build/webapps/jetspeed.war DONE! Start Tomcat: master:~> cd $CATALINA_HOME/bin/startup.sh Tomcat will automatically deploy Jetspeed. Now browse to Tomcat at http://localhost:8080 (it might be a little slower while the war is being deployed). In the administration section click on Tomcat Manager and login. In the Applications list we'll find the entry /jetspeed. If the column 'Running' says 'true' it means Jetspeed has been successfully deployed. Click on /jetspeed to proceed. Good luck. ################## OK, that's all. Hope that this is useful for someone :-) rgds, Marty