Mailing List

QuestionAnswer
How do I join the Jetspeed mailing list?The instructions for joining the Jetspeed mailing list can be found at the Java Apache Mail Lists Site
Where do I go to search the Jetspeed mailing list? Jetspeed User

Jetspeed Developer

Mailing List Archives Prior to March 1, 2001

WAP Support

QuestionAnswer
What kind of WAP devices are supported by Jetspeed?See the WAP Component page

Database Support

QuestionAnswer
What databases does Jetspeed support? See the Database Configuration documentation.

Firewall Problems

QuestionAnswer
How do you configure Jetspeed to run behind a firewall/proxy?

-or-

What can cause the

"java.net.UknownHostException"

for www.mozilla.org, www.apacheweek.com or other external web sites?

If you have a proxy, set the servlet engine JVM system properties for using a proxy to:

java -DproxySet=true -DproxyHost=<proxyHost> -DproxyPort=<proxyPort> <servlet engine>

For Tomcat you can set TOMCAT_OPTS (CATALINA_OPTS in Tomcat 4):

  • Windows:

    set TOMCAT_OPTS=-DproxySet=true -DproxyHost=<proxyHost> -DproxyPort=<proxyPort>

  • Unix:

    export TOMCAT_OPTS="-DproxySet=true -DproxyHost=<proxyHost> -DproxyPort=<proxyPort>"

  • Excludes

    To exclude servers from being proxied, list them under the http.nonProxyHosts parameter separated by "|" delimiter:



    -Dhttp.nonProxyHosts="localhost|*.mycompany.com"
OK, I think I configured Jetspeed to run behind a firewall/proxy but the URLs still are not being loaded. Look in the file WEB-INF\conf\datasource.properties. If there is an entry for the URL in this file, remove it and try again.

Jetspeed Versions

QuestionAnswer
Which version of Jetspeed should I use ? We do not recommend that you use the 1.1 or 1.2b1 releases as these are not supported anymore. You should use the latest 1.4 release available which provides many improvements over the previous 1.3, 1.2 or 1.1 releases.

New User Confirmation

QuestionAnswer
After adding a new user, I come to a screen asking me to enter a secret key. But I never receive an email with the confirmation key, and I entered a valid email address. What can I do next? 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://jakarta.apache.org/james/

The mail host settings will need to be modified:

<tomcat_home>/webapps/jetspeed/WEB-INF/conf/JetspeedResources.properties

Here are the settings necessary to work with a Apache James Mail Server running on the localhost:

mail.server=localhost confirm.email.from=Postmaster@localhost confirm.email.name=Jetspeed Postmaster confirm.email.subject=Jetspeed registration

This Confirmation E-mail is an optional feature. To disable it, use the JetspeedResources.properties setting:

confirm.email.enable=false

Error Log

QuestionAnswer
Where can I find the Jetspeed error log? <tomcat_home>/webapps/jetspeed/WEB-INF/log/jetspeed.log

SSL and Jetspeed

QuestionAnswer
I need to ensure that Logging in uses SSL. Does jetspeed login use SSL currently? If not how do I go about changing it so that it does? You have to configure your webapp server to allow SSL only. Add a dispatcher (uncomment and edit) in conf/server.xml and generate the key, as shown at those links.

Tomcat 4 : Catalina 4.0 SSL Docs

Tomcat 3 : Tomcat 3.3 SSL Docs

Running Jetspeed under Tomcat installed in Windows Program Files folder

QuestionAnswer
I copied jetspeed.war file to $Tomcat/webapps, and when I goto the url http://localhost:8080/jetspeed/index.jsp, I had an error like:

org.apache.jasper.JasperException: Unable to compile class for JSP

An error occurred at line: -1 in the jsp file: null



What is this? Can I solve this problem?
There are known problems with having Tomcat installed in a directory structure that contains spaces, e.g. C:\Program Files\Apache Group\Tomcat 4.1. Please try to rename the tomcat installed directory or copy them to a directory which has no space in the name and run.

Changing portlet template

QuestionAnswer
In my action class extending JspPortletAction, I try to use the setTemplate method, but it doesn't work. I throws a NullPointerException in PortletAction when trying to retrieve a "VelocityPortletContext" (how surprising when working with a JSPPortlet) Besides, I had to catch this exception myself, otherwise it wasn't appearing anywhere in the logs, not even a single error message...

Most common mistake with portlets is to use the hidden action variable and set it to the portlet's action class:

<form name="form" action="http://myhost/ThingWeb/portal" method="get"> <input type="hidden" name="js_peid" value="<%=jspeid%>"/> <input type="hidden" name="action" value="ThingieSearchAction"/> <input type="submit" name="eventSubmit_doSearch" value="Search"> <input type="reset" value="Clear Fields"> <input type="text" name="thingieid" size="20"> </form>

In the above example, Turbine executes the action before the portlet and therefore the context is null. The above should be rewrittern as follows:

<form name="form" action="<js:portletlink template="" />" method="get"> <input type="hidden" name="js_peid" value="<%=jspeid%>"/> <input type="submit" name="eventSubmit_doSearch" value="Search"> <input type="reset" value="Clear Fields"> <input type="text" name="thingieid" size="20"> </form>

XML transformation errors for RSS portlets under JDK 1.4

QuestionAnswer
Jetspeed RSS feeds are giving this message in the portlet: "problem in SAX transform: org.apache.xml.utils.WrappedRuntimeException: The output format must have a '{http://xml.apache.org/xalan}content-handler' property!" Copy the xalan.jar from Jetspeed distribution to $CATALINA_HOME/common/endorsed directory (or JDK endorsed directory)