Frequently Asked Questions

Frequently Asked Questions FAQ

Question	Answer
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

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

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

Question	Answer
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.

Question

Answer

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.

Question	Answer
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.

Question	Answer
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

Question

Answer

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

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

Question	Answer
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

Question	Answer
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.

Question Answer

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...

Question	Answer
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>`

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>

Question	Answer
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)

Question	Answer
How do I set the title at runtime?	Setting Portlet Titles at Runtime