Hi Everyone,
Here's an install procedure we've put together. It basically goes through
each step in getting Jetspeed up and running on Tomcat running on a Linux
system right out of the box. It's yet to be tested by someone other than
myself so comments or feedbacks will be appreciated.
thanks,
Ernest
[EMAIL PROTECTED]
Notes on Installing Jetspeed with Tomcat on Linux
***************
*
*
* This document was created and tested using Jetspeed downloaded from
*
* cvs.working-dogs.com:/products/cvs/jetspeed
* on November 22, 2000
*
* using Redhat Version 6.2 running on Dell Precision 220.
*
* Installation of different versions of Jetspeed will vary.
*
* GlueCode Inc
* 1452 2nd Street
* Santa Monica, CA 90401
*
***************
I. Build Jetspeed.jar
A. From the CVS download, run build.sh script with the 'dist'
argument.
#cd jetspeed/build
#./build.sh dist
*Once the build is successful, it will create a Jetspeed.jar file in the
bin directory.
II. Jetspeed-Turbine Install
A. Create several directories.
#cd TOMCAT_HOME/webapps
#mkdir jetspeed
#cd TOMCAT_HOME/webapps/jetspeed
#mkdir WEB-INF
#mkdir cache
#mkdir jetspeed-cache
#mkdir repository
#chmod 777 cache jetspeed-cache repository
#mkdir lib
#mkdir database
#cd TOMCAT_HOME/webapps/jetspeed/WEB-INF
#mkdir conf
B. Make a web.xml file
#cd TOMCAT_HOME/webapps/jetspeed/WEB-INF
#vi web.xml
<?xml version="1.0" encoding="ISO-8859-1" ?>
<web-app>
<servlet>
<servlet-name>
Jetspeed
</servlet-name>
<servlet-class>
org.apache.jetspeed.JetspeedServlet
</servlet-class>
<init-param>
<param-name>
properties
</param-name>
<param-value>
WEB-INF/conf/TurbineResources.properties
</param-value>
</init-param>
</servlet>
</web-app>
*Where TOMCAT_HOME is the path to your tomcat installation. Usually
/usr/local/tomcat.
III. Copy files into the appropriate locations.
A. Copy configuration files
These configuration files are located in jetspeed/src/config of the
CVS download.
#cp TurbineResources.properties, JetspeedResources.properties,
cocoon.properties, jetspeed-config.jcfg into:
TOMCAT_HOME/webapps/jetspeed/WEB-INF/conf
B. Copy JAR files
#cp
activation.jar
castor.jar
cocoon-ext-servlet2.2.jar
cocoon.jar
ecs.jar
freemarker-jdk1.2.jar
hsql.jar
jaxp.jar
mail.jar
servlet_2_2.jar
turbine-2.1-dev-unreleased.jar
velocity-0.7.jar
village-1.5.jar
webmacro-jdk1.2.jar
xalan.jar
xerces.jar
into:
TOMCAT_HOME/webapps/jetspeed/lib
*IMPORTANT: Copy the compiled (step 1) Jetspeed.jar into the lib
folder as well.
C. Copy database files
From the CVS download copy the contents of
jetspeed/src/tomcat-build/jetspeed-system/database
into TOMCAT_HOME/webapps/jetspeed/database
IV. Prepare startup scripts
A. Make a classpath.sh file
#cd TOMCAT_HOME/bin
Make a file named classpath.sh
#vi classpath.sh
JAVA_HOME=/usr/local/jdk1.2.2
JETSPEED_HOME=/usr/local/tomcat/webapps/jetspeed
TOOLS=/usr/local/jdk1.2.2/lib/tools.jar
CLASSPATH=$JETSPEED_HOME/lib/activation.jar:
CLASSPATH=$JETSPEED_HOME/lib/castor.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/cocoon-ext-servlet2.2.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/cocoon.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/ecs.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/freemarker-jdk1.2.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/hsql.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/jaxp.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/mail.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/servlet_2_2.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/turbine-2.1-dev-unreleased.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/velocity-0.7.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/village-1.5.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/webmacro-jdk1.2.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/xalan.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/xerces.jar:$CLASSPATH
CLASSPATH=$JETSPEED_HOME/lib/Jetspeed.jar:$CLASSPATH
export CLASSPATH
*Make sure to point JAVA_HOME and TOOLS to the proper location.
B. Edit Tomcat's startup.sh located in TOMCAT_HOME/conf
add the following line at the beginning of the file.
source classpath.sh
V. Edit configuration files
A. Edit TurbineResources.properties
#cd TOMCAT_HOME/webapps/jetspeed/WEB-INF/conf
#vi TurbineResources.properties
Add this package to the module.packages entry
org.apache.jetspeed.modules
Edit the following lines:
database.default.url=jdbc:HypersonicSQL:/usr/local/tomcat/webapps/jetspeed/d
atabase/jetspeed
Edit the following line, add the absolute path:
include=/usr/local/tomcat/webapps/jetspeed/WEB-INF/conf/JetspeedResources.pr
operties
Edit the following line, add the absolute path
logfile= /usr/local/jetspeed/webapps/jetspeed/turbine.log
Edit the locale.default.bundle entry
locale.default.bundle=org.apache.jetspeed.modules.localization.JetspeedLocal
ization
B. Edit JetspeedResources.properties
Edit the jetspeed.config entry
jetspeed.config=/WEB-INF/conf/jetspeed-config.jcfg
Edit the following section Remote Object Storage System, add the
absolute path
cache.directory=/usr/local/tomcat/webapps/jetspeed/cache
Edit the following section - Cocoon config, add the absolute path
cocoon.properties.file
/usr/local/jetspeed/webapps/jetspeed/WEB-INF/conf/cocoon.properties
C. Edit cocoon.properties
Edit the following line
processor.xsp.repository =
/usr/local/tomcat/webapps/jetspeed/repository
D. Copy content directory to document root.
E. Edit Tomcat's tomcat.conf located in TOMCAT_HOME/conf
Add the Document Root information above the tomcat alias line:
Alias /examples /usr/local/tomcat/webapps/examples
DocumentRoot /usr/local/tomcat/webapps/jetspeed
ApJServMount /servlet /jetspeed
<Location "/usr/local/tomcat/webapps/jetspeed/WEB-INF">
AllowOverride None
deny from all
</Location>
Options Indexes FollowSymLinks
F. Edit server.xml
Comment out the following lines:
<!-- <Context path="" docBase="webapps/ROOT" debug="0"
reloadable="true">
</Context>
-->
Add the following lines:
<Context path="" docBase="webapps/jetspeed" debug="0"
reloadable="true">
</Context>
G. Restart Tomcat
#TOMCAT_HOME/bin/shutdown.sh
This command stops Tomcat.
#TOMCAT_HOME/bin/startup.sh
This command starts Tomcat.
VI. Test Portal
Access http://servername:8080/servlet/Jetspeed
--
--------------------------------------------------------------
Please read the FAQ! <http://java.apache.org/faq/>
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Archives and Other: <http://marc.theaimsgroup.com/?l=jetspeed>
Problems?: [EMAIL PROTECTED]
