Requirements

It is expected that the user is familiar with both the Apache Maven project management tool and the Apache Ant scripting utility.

  • Ant 1.5 or higher
  • Maven 1.0.2
  • Java 1.4.2_02 or higher
  • Servlet 2.3 Engine:
    • Tomcat 5.0.x
    • Tomcat 5.5.x
    • Jetty
    • Websphere 5.1, 6.0
    • Geronimo
    • JBoss
    • Weblogic

1. Get Maven Ready

If you have not already done so, download and install Maven .

2. What Database do you want

Jetspeed's security model requires a database to authorize users and to retain the user information. Jetspeed security should work with any JDBC 2.0 compliant driver. The following databases are tested:

  • Derby
  • HSQLDB - Hypersonic SQL
  • MySQL
  • Oracle
  • POstgres
  • DB2
  • Sybase
  • SQL Server
Jetspeed is distributed with the Derby database configured as the default.

The database configuration will be setup during the installation process. If you are not going to use the default Derby database, you need to select another database during installation.

3 Servlet Engines

In theory, Jetspeed 2 portals can be run under any servlet container supporting the 2.3 specification or greater. Successful Jetspeed 2 portal applications have been deployed using:

  • Tomcat 5.5.8 or higher
  • Jetty
  • Websphere
  • Geronimo
  • JBoss

Tomcat Configuration

Jetspeed 2 can use the Tomcat Manager application for managing portlet applications with the Portlet Application Lifecycle Manager Portlet (PALM). To be able to do so it needs a configured Tomcat user with the predefined 'manager' role in the ${org.apache.jetspeed.server.home}/conf/tomcat-users.xml.

A minimal example tomcat-users.xml can look like:

						
<tomcat-users>
  <role rolename="manager"/>
    <user username="j2deployer" password="xxxxx" roles="manager"/>
</tomcat-users>
					
The attribute values for username and password must correspond to the specified values for ${org.apache.jetspeed.services.autodeployment.user} and ${org.apache.jetspeed.services.autodeployment.user} as described above.

Tomcat 5.5.9 on Windows

To have redeployment and undeployment working properly when using Tomcat 5.5.9 on Windows you have to set the global Context attribute "antiJARLocking" to true.

In ${org.apache.jetspeed.server.home}\conf\context.xml use:

						
    <Context antiJARLocking="true">
    ...
    </Context>
					

Jetty - A Quick Test Environment or a Production Servlet Container

Jetty can be used for a production deployment but it is most commonly used to quickly test customizations without interfering with the production servlet container. It does not require any special configuration.

4. Installing Jetspeed from Source or Binary Distributions

Depending on what you want to do, you have the choice of installing Jetspeed from a binary release or from the sources. If you want to modify the core functionality of Jetspeed or contribute to the development of Jetspeed, you need to work with the sources. If you are only interested in building your own custom enterprise portal, you can start with a binary release of Jetspeed. Most people should start with the binary distribution.

5. Jetspeed build

Your installation instructions will depend on whether you are building from source or building from a binary distribution or installing with Jetspeed-2 installer .