JetSpeed Installation Directions

Requirements:

• A Java Servlet Engine/Container. Must be compatible with the Servlet 2.1 API Note that JetSpeed was only tested on JDK 1.2 with Sun's Java Servlet Development Kit 2.1
• JDK 1.2 or compatible Java Virtual Machine (JRE 1.2 as well)
• Netscape Navigator 4.x or Internet Explorer 4.x
• The following Java packages are required and cannot ship with JetSpeed due to licensing problems:
1. JavaMail (SUN Community License). Provides IMAP and SMTP support.
2. Java Activation Framework (SUN Community License)
• The following Java packages are optional and cannot ship with JetSpeed due to licensing problems:
1. DOG NNTP JavaMail provider (MPL). Required if you want NNTP (newsgroups) support.
2. DOG POP3 JavaMail provider (MPL). Required if you want POP3 support.
3. SUN Servlet API (javax.servlet) (SUN Community License). If you want to compile your own classes. Should normally be provided by your servlet engine once compiled.

Installation:

Since JetSpeed is 100% Java there is no need to compile. All bytecode should run on any platform that supports JDK 1.2.

Move the "content" directory to "/content" under your web server. If you already have a "content" directory simply add the files there.

Add ./bin/JetSpeed.jar to your classpath. This contains all classes from JetSpeed. The full URL should be: "http://localhost/servlet/org.jetspeed.Home".

Add all jar files in the "classes" directory to your classpath so that they will be accessible with your servlet.

If you only want IMAP/SMTP access then you can skip this step. Configure JavaMail to point to your providers. By default JavaMail comes with SMTP and IMAP providers so lets not focus on these. You will want to add the NNTP and POP3 providers. The file ./src/config/javamail.providers needs to be copied to {java.home}/lib. In order to determine your java.home variable run "java org.jetspeed.Test" (or ./runtest if you don't have a CLASSPATH setup).

Copy the file ./src/config/JetSpeed.properties to your {java.home}/lib directory. You should edit this file to reflect your site configuration.

Possibly restart your servlet engine.

Bring up a 4.0 browser and point it to http://localhost:<SERVLET_PORT>/<SERVLET_ROOT>/org.jetspeed.Home.

Release Notes

There may be a known problem with your specific version of JetSpeed. Please see the release notes.