http://xml.apache.org/http://www.apache.org/http://www.w3.org/


Overview
Installation
Features
Resources
FAQ

Content Syndication
Customizer
iCalendar
WAP

Development
PSML
Disk Cache
How to Write Portlet
Developers Guide
Coding Standards

To Do List
Contributors
CVS Branches

Code Repository
Javadoc
Download
License


Requirements
  • A Java Servlet Engine/Container. Must be compatible with the Servlet 2.2 API. Note that Jetspeed is developed under Tomcat (http://jakarta.apache.org) so this is the most desirable platform.
  • JDK 1.2 or higher Java Virtual Machine. Jetspeed has been tested on most SUN and IBM Virtual Machines.

Installation

This installation procedure covers installing Jetspeed as a J2EE Web Application. Installing a Web application is simple. With Web apps, the entire application can be contained in a single archive file and deployed by placing the file into a specific directory.

Here are the complete steps for downloading Jetspeed, building it, and then installing the default Web Application.

  • 1. Checkout the complete Jetspeed source from our CVS server. You will need to logon to the CVS server as anonymous and then execute these CVS commands:
    • set CVSROOT=:pserver:anon@cvs.working-dogs.com:/products/cvs/jetspeed
    • cvs login .......... (password is "anon")
    • cvs checkout jetspeed
  • 2. Build Jetspeed
    • cd <jetspeedRoot>/build
    • [Win32/DOS] .\build webapp
    • [Win32/cygnus] bash build.sh webapp
    • [unix] ./build.sh webapp
  • 3. Get a Servlet 2.2 runner (container). We use Tomcat in this installation.
  • 4. Unzip the Tomcat distribution

  • 5. Copy the Jetspeed WAR file to the Tomcat webapps directory
    • [Win32] copy <jetspeedRoot>\bin\jetspeed.war <tomcat_home>\webapps\
    • [Unix] cp <jetspeedRoot>/bin/jetspeed.war <tomcat_home>/webapps/
  • 6. Start Tomcat
    • [Win32] <tomcat_home>\bin\startup.bat
    • [Unix] <tomcat_home>/bin/startup.sh
  • 7. Connect to Jetspeed
  • 7a. When signing up a new user in Jetspeed, the registration process includes a step where an email is sent to the new user. In order for this process to work on Windows NT or 2000, you will need to have a local SMTP server running. The Apaches James Mail Enterprise Server is available from:
    • http://java.apache.org/james/
    • The mail host settings will need to be modified:
    • <tomcat_home>/webapps/jetspeed/WEB-INF/conf/TurbineResources.properties


Database Configuration

Jetspeed uses Turbine's security model to authorize users and persist minimal user information. Turbine security should work with any JDBC 2.0 compliant driver. The following databases are tested:

  • DB2
  • Hypersonic SQL
  • MySQL
  • Oracle
  • Postgres
  • Sybase

Jetspeed is distributed with a populated Hypersonic-SQL database. This database is selected as the default database in the TurbineResources.properties file. To configure Jetspeed with a different database, modify the TurbineResources.properties file. Here is an example for Oracle:

  • database.default.driver=oracle.jdbc.driver.OracleDriver
  • database.default.url=jdbc:oracle:thin:@<host>:1521:<sid>
  • database.default.username= <your-oracle-user>
  • database.default.password= <your-password>

You will need to replace:

<host>  the host of the Oracle instance, such as localhost 
<sid>  the name of Oracle database sid at the host 
<username>  the oracle user(schema) name 

The TurbineResources.properties file can be found in /webapp/WEB-INF/conf.

The database scripts for setting up the database are included with the source code distribution, under the src/sql/external folder. Run the appropriate script, such as turbine-db2.sql for DB2, to create the database tables. This step is not necessary with Hypersonic SQL.

To populate the database, a script is provided: /src/sql/external/default_roles_persmissions.sql. Only run the statements for your specific database as commented.

The script will create two database users:

  • Login: turbine Password: turbine
  • Login: admin Password: jetspeed


Copyright © 2000 The Apache Software Foundation. All Rights Reserved.