You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by mo...@apache.org on 2003/10/24 23:59:41 UTC
cvs commit: jakarta-jetspeed/xdocs faq.xml
morciuch 2003/10/24 14:59:41
Modified: docs/site faq.html
xdocs faq.xml
Log:
Updated the FAQ with information documented in Bugzilla issue# 23025.
Revision Changes Path
1.38 +141 -78 jakarta-jetspeed/docs/site/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/faq.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- faq.html 25 Aug 2003 06:18:39 -0000 1.37
+++ faq.html 24 Oct 2003 21:59:41 -0000 1.38
@@ -5,7 +5,6 @@
<!-- start the processing -->
<!-- ====================================================================== -->
- <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
@@ -15,7 +14,6 @@
-
<title>Jetspeed - Frequently Asked Questions</title>
</head>
@@ -135,16 +133,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -155,7 +153,7 @@
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The instructions for joining the Jetspeed mailing list can be found at the <a href="http://jakarta.apache.org/site/mail.html">Java Apache Mail Lists Site</a>
-
+
</font>
</td>
</tr>
@@ -167,11 +165,14 @@
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-
-<a href="http://www.mail-archive.com/jetspeed-user%40jakarta.apache.org/">Jetspeed User</a><br />
-<a href="http://www.mail-archive.com/jetspeed-dev%40jakarta.apache.org/">Jetspeed Developer</a><br />
- <a href="http://www.mail-archive.com/jetspeed@list.working-dogs.com/">Mailing List Archives Prior to March 1, 2001</a><br />
-
+
+ <a href="http://www.mail-archive.com/jetspeed-user%40jakarta.apache.org/">Jetspeed User</a>
+ <br />
+ <a href="http://www.mail-archive.com/jetspeed-dev%40jakarta.apache.org/">Jetspeed Developer</a>
+ <br />
+ <a href="http://www.mail-archive.com/jetspeed@list.working-dogs.com/">Mailing List Archives Prior to March 1, 2001</a>
+ <br />
+
</font>
</td>
</tr>
@@ -191,16 +192,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -211,6 +212,7 @@
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
See the <a href="wap.html">WAP Component page</a>
+
</font>
</td>
</tr>
@@ -230,16 +232,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -252,13 +254,13 @@
Jetspeed should work with any JDBC 2.0 complaint driver. The following databases have been tested:
<ul>
- <li>DB2</li>
- <li>Hypersonic SQL</li>
- <li>MySQL</li>
- <li>Oracle</li>
- <li>Postgres</li>
- <li>Sybase</li>
-</ul>
+ <li>DB2</li>
+ <li>Hypersonic SQL</li>
+ <li>MySQL</li>
+ <li>Oracle</li>
+ <li>Postgres</li>
+ <li>Sybase</li>
+ </ul>
Scripts for setting up the database are included with the source code distribution, under the src/sql/external folder.
To change the database connection, you will also need to update the database connection settings in Torque.properties. The war file installation automatically configures Hypersonic SQL as the default database.
@@ -281,24 +283,28 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
How do you configure Jetspeed to run behind a firewall/proxy?
-<p>-or-</p><p>
-What can cause the <p><b>"java.net.UknownHostException"</b></p> for www.mozilla.org,
+<p>-or-</p>
+ <p>
+What can cause the <p>
+ <b>"java.net.UknownHostException"</b>
+ </p> for www.mozilla.org,
www.apacheweek.com or other external web sites?</p>
+
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -310,29 +316,30 @@
java -DproxySet=true -DproxyHost=<proxyHost> -DproxyPort=<proxyPort>
<servlet engine>
</p>
-<p>
+ <p>
For Tomcat you can set TOMCAT_OPTS (CATALINA_OPTS in Tomcat 4):
</p>
-<ul>
-<li>
+ <ul>
+ <li>
Windows:<br />
set TOMCAT_OPTS=-DproxySet=true -DproxyHost=<proxyHost>
-DproxyPort=<proxyPort>
<br />
-</li>
-<li>Unix:<br />
+ </li>
+ <li>Unix:<br />
export TOMCAT_OPTS="-DproxySet=true -DproxyHost=<proxyHost>
-DproxyPort=<proxyPort>"
<br />
-</li>
-<li>
+ </li>
+ <li>
Excludes<br />
To exclude servers from being proxied, list them under the <b>http.nonProxyHosts</b> parameter separated by "|" delimiter:
-<br /><br />
+<br />
+ <br />
-Dhttp.nonProxyHosts="localhost|*.mycompany.com"
</li>
-</ul>
-
+ </ul>
+
</font>
</td>
</tr>
@@ -368,16 +375,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -410,16 +417,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -439,31 +446,31 @@
<p>
The Apaches James Mail Enterprise Server is available from:
</p>
-<p>
- <a href="http://jakarta.apache.org/james/">http://jakarta.apache.org/james/</a>
-</p>
-<p>
+ <p>
+ <a href="http://jakarta.apache.org/james/">http://jakarta.apache.org/james/</a>
+ </p>
+ <p>
The mail host settings will need to be modified:
</p>
-<p>
+ <p>
<tomcat_home>/webapps/jetspeed/WEB-INF/conf/JetspeedResources.properties
</p>
-<p>
+ <p>
Here are the settings necessary to work with a Apache James Mail Server running on the localhost:
</p>
-<p>
+ <p>
mail.server=localhost
confirm.email.from=Postmaster@localhost
confirm.email.name=Jetspeed Postmaster
confirm.email.subject=Jetspeed registration
</p>
-<p>
+ <p>
This Confirmation E-mail is an optional feature. To disable it, use the JetspeedResources.properties setting:
</p>
-<p>
+ <p>
confirm.email.enable=false
</p>
-
+
</font>
</td>
</tr>
@@ -483,16 +490,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -526,16 +533,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -553,10 +560,10 @@
<br />
Tomcat 4 :
<a href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/ssl-howto.html">Catalina 4.0 SSL Docs</a>
-<br />
+ <br />
Tomcat 3 :
<a href="http://jakarta.apache.org/tomcat/tomcat-3.3-doc/tomcat-ssl-howto.html">Tomcat 3.3 SSL Docs</a>
-
+
</font>
</td>
</tr>
@@ -576,16 +583,16 @@
<blockquote>
<table>
<tr>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Question
</font>
-</th>
- <th bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Answer
</font>
-</th>
+</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
@@ -593,8 +600,11 @@
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:<br />
-<code>org.apache.jasper.JasperException: Unable to compile class for JSP</code><br />
-<code>An error occurred at line: -1 in the jsp file: null</code><br /><br />
+ <code>org.apache.jasper.JasperException: Unable to compile class for JSP</code>
+ <br />
+ <code>An error occurred at line: -1 in the jsp file: null</code>
+ <br />
+ <br />
What is this? Can I solve this problem?
</font>
@@ -614,6 +624,59 @@
</td></tr>
<tr><td><br/></td></tr>
</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Changing portlet template"><strong>Changing portlet template</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Question
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Answer
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ 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...
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+<p>Most common mistake with portlets is to use the hidden action variable and set it to the portlet's action class:</p>
+<code>
+
<form name="form" action="<A HREF="http://myhost/ThingWeb/portal">http://myhost/ThingWeb/portal</A>" 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>
</code>
+<p>In the above example, Turbine executes the action before the portlet and therefore the context is null. The above should be rewrittern as follows:</p>
+<code>
+
<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>
+</code>
+
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
</td>
</tr>
@@ -623,7 +686,7 @@
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 1999-2003, Apache Software Foundation
+ Copyright © 1999-2002, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
1.18 +204 -189 jakarta-jetspeed/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/xdocs/faq.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- faq.xml 10 Jun 2003 16:09:28 -0000 1.17
+++ faq.xml 24 Oct 2003 21:59:41 -0000 1.18
@@ -1,199 +1,193 @@
<?xml version="1.0"?>
-
<document>
-
- <properties>
- <title>Frequently Asked Questions</title>
- <subtitle>FAQ</subtitle>
- <authors>
- <person name="David S. Taylor" email="david@bluesunrise.com"/>
- </authors>
- </properties>
-
-<body>
-
-<section name="Mailing List">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>How do I join the Jetspeed mailing list?</td>
-<td>The instructions for joining the Jetspeed mailing list can be found at the <a href="http://jakarta.apache.org/site/mail.html">Java Apache Mail Lists Site</a>
-</td>
-</tr>
-
-<tr>
-<td>Where do I go to search the Jetspeed mailing list?</td>
-<td>
-<a href="http://www.mail-archive.com/jetspeed-user%40jakarta.apache.org/">Jetspeed User</a><br/>
-<a href="http://www.mail-archive.com/jetspeed-dev%40jakarta.apache.org/">Jetspeed Developer</a><br/>
- <a href="http://www.mail-archive.com/jetspeed@list.working-dogs.com/">Mailing List Archives Prior to March 1, 2001</a><br/>
-</td>
-</tr>
-</table>
-</section>
-
-
-<section name="WAP Support">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>What kind of WAP devices are supported by Jetspeed?</td>
-<td>See the <a href="wap.html">WAP Component page</a></td>
-</tr>
-</table>
-</section>
-
-<section name="Database Support">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>What databases does Jetspeed support?</td>
-<td>
+ <properties>
+ <title>Frequently Asked Questions</title>
+ <subtitle>FAQ</subtitle>
+ <authors>
+ <person name="David S. Taylor" email="david@bluesunrise.com"/>
+ </authors>
+ </properties>
+ <body>
+ <section name="Mailing List">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>How do I join the Jetspeed mailing list?</td>
+ <td>The instructions for joining the Jetspeed mailing list can be found at the <a href="http://jakarta.apache.org/site/mail.html">Java Apache Mail Lists Site</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Where do I go to search the Jetspeed mailing list?</td>
+ <td>
+ <a href="http://www.mail-archive.com/jetspeed-user%40jakarta.apache.org/">Jetspeed User</a>
+ <br/>
+ <a href="http://www.mail-archive.com/jetspeed-dev%40jakarta.apache.org/">Jetspeed Developer</a>
+ <br/>
+ <a href="http://www.mail-archive.com/jetspeed@list.working-dogs.com/">Mailing List Archives Prior to March 1, 2001</a>
+ <br/>
+ </td>
+ </tr>
+ </table>
+ </section>
+ <section name="WAP Support">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>What kind of WAP devices are supported by Jetspeed?</td>
+ <td>See the <a href="wap.html">WAP Component page</a>
+ </td>
+ </tr>
+ </table>
+ </section>
+ <section name="Database Support">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>What databases does Jetspeed support?</td>
+ <td>
Jetspeed should work with any JDBC 2.0 complaint driver. The following databases have been tested:
<ul>
- <li>DB2</li>
- <li>Hypersonic SQL</li>
- <li>MySQL</li>
- <li>Oracle</li>
- <li>Postgres</li>
- <li>Sybase</li>
-</ul>
+ <li>DB2</li>
+ <li>Hypersonic SQL</li>
+ <li>MySQL</li>
+ <li>Oracle</li>
+ <li>Postgres</li>
+ <li>Sybase</li>
+ </ul>
Scripts for setting up the database are included with the source code distribution, under the src/sql/external folder.
To change the database connection, you will also need to update the database connection settings in Torque.properties. The war file installation automatically configures Hypersonic SQL as the default database.
</td>
-</tr>
-</table>
-</section>
-
-<section name="Firewall Problems">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>How do you configure Jetspeed to run behind a firewall/proxy?
-<p>-or-</p><p>
-What can cause the <p><b>"java.net.UknownHostException"</b></p> for www.mozilla.org,
-www.apacheweek.com or other external web sites?</p></td>
-<td>
+ </tr>
+ </table>
+ </section>
+ <section name="Firewall Problems">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>How do you configure Jetspeed to run behind a firewall/proxy?
+<p>-or-</p>
+ <p>
+What can cause the <p>
+ <b>"java.net.UknownHostException"</b>
+ </p> for www.mozilla.org,
+www.apacheweek.com or other external web sites?</p>
+ </td>
+ <td>
If you have a proxy, set the servlet engine JVM system properties for
using a proxy to:
<p>
java -DproxySet=true -DproxyHost=<proxyHost> -DproxyPort=<proxyPort>
<servlet engine>
</p>
-<p>
+ <p>
For Tomcat you can set TOMCAT_OPTS (CATALINA_OPTS in Tomcat 4):
</p>
-<ul>
-<li>
-Windows:<br></br>
+ <ul>
+ <li>
+Windows:<br/>
set TOMCAT_OPTS=-DproxySet=true -DproxyHost=<proxyHost>
-DproxyPort=<proxyPort>
<br/>
-</li>
-<li>Unix:<br/>
+ </li>
+ <li>Unix:<br/>
export TOMCAT_OPTS="-DproxySet=true -DproxyHost=<proxyHost>
-DproxyPort=<proxyPort>"
<br/>
-</li>
-<li>
+ </li>
+ <li>
Excludes<br/>
To exclude servers from being proxied, list them under the <b>http.nonProxyHosts</b> parameter separated by "|" delimiter:
-<br/><br/>
+<br/>
+ <br/>
-Dhttp.nonProxyHosts="localhost|*.mycompany.com"
</li>
-</ul>
-</td>
-</tr>
-
-<tr>
-<td>OK, I think I configured Jetspeed to run behind a firewall/proxy but the
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>OK, I think I configured Jetspeed to run behind a firewall/proxy but the
URLs still are not being loaded.</td>
-<td>
+ <td>
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.
</td>
-</tr>
-
-</table>
-</section>
-
-
-<section name="Jetspeed Versions">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>Which version of Jetspeed should I use ?</td>
-<td>
+ </tr>
+ </table>
+ </section>
+ <section name="Jetspeed Versions">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>Which version of Jetspeed should I use ?</td>
+ <td>
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 beta release available which provides many improvements over the previous 1.3, 1.2 or 1.1 releases.
</td>
-</tr>
-
-</table>
-</section>
-
-<section name="New User Confirmation">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>
+ </tr>
+ </table>
+ </section>
+ <section name="New User Confirmation">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>
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?
</td>
-<td>
+ <td>
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.
<p>
The Apaches James Mail Enterprise Server is available from:
</p>
-<p>
- <a href="http://jakarta.apache.org/james/">http://jakarta.apache.org/james/</a>
-</p>
-<p>
+ <p>
+ <a href="http://jakarta.apache.org/james/">http://jakarta.apache.org/james/</a>
+ </p>
+ <p>
The mail host settings will need to be modified:
</p>
-<p>
+ <p>
<tomcat_home>/webapps/jetspeed/WEB-INF/conf/JetspeedResources.properties
</p>
-<p>
+ <p>
Here are the settings necessary to work with a Apache James Mail Server running on the localhost:
</p>
-<p>
+ <p>
mail.server=localhost
confirm.email.from=Postmaster@localhost
confirm.email.name=Jetspeed Postmaster
confirm.email.subject=Jetspeed registration
</p>
-<p>
+ <p>
This Confirmation E-mail is an optional feature. To disable it, use the JetspeedResources.properties setting:
</p>
-<p>
+ <p>
confirm.email.enable=false
</p>
-</td>
-</tr>
-</table>
-</section>
-<!--
+ </td>
+ </tr>
+ </table>
+ </section>
+ <!--
<section name="Turbine Source Code">
<table>
<tr>
@@ -216,73 +210,94 @@
</table>
</section>
-->
-
-<section name="Error Log">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>
+ <section name="Error Log">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>
Where can I find the Jetspeed error log?
</td>
-<td>
+ <td>
<tomcat_home>/webapps/jetspeed/WEB-INF/log/jetspeed.log
</td>
-</tr>
-</table>
-</section>
-
-<section name="SSL and Jetspeed">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>I need to ensure that Logging in uses SSL. Does jetspeed login use SSL currently?
+ </tr>
+ </table>
+ </section>
+ <section name="SSL and Jetspeed">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>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?
</td>
-<td>
+ <td>
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.
<br/>
Tomcat 4 :
<a href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/ssl-howto.html">Catalina 4.0 SSL Docs</a>
-<br/>
+ <br/>
Tomcat 3 :
<a href="http://jakarta.apache.org/tomcat/tomcat-3.3-doc/tomcat-ssl-howto.html">Tomcat 3.3 SSL Docs</a>
-</td>
-</tr>
-
-</table>
-</section>
-
-<section name="Running Jetspeed under Tomcat installed in Windows Program Files folder">
-<table>
-<tr>
-<th>Question</th>
-<th>Answer</th>
-</tr>
-<tr>
-<td>
+ </td>
+ </tr>
+ </table>
+ </section>
+ <section name="Running Jetspeed under Tomcat installed in Windows Program Files folder">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>
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:<br/>
-<code>org.apache.jasper.JasperException: Unable to compile class for JSP</code><br/>
-<code>An error occurred at line: -1 in the jsp file: null</code><br/><br/>
+ <code>org.apache.jasper.JasperException: Unable to compile class for JSP</code>
+ <br/>
+ <code>An error occurred at line: -1 in the jsp file: null</code>
+ <br/>
+ <br/>
What is this? Can I solve this problem?
</td>
-<td>
+ <td>
There are known problems with having Tomcat installed in a directory structure
that contains spaces, e.g. <code>C:\Program Files\Apache Group\Tomcat 4.1</code>. Please try to rename the tomcat installed directory or copy them to a directory which has no space in the name and run.
</td>
-</tr>
-
-</table>
-</section>
-
-</body>
+ </tr>
+ </table>
+ </section>
+ <section name="Changing portlet template">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>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...
+</td>
+ <td>
+<p>Most common mistake with portlets is to use the hidden action variable and set it to the portlet's action class:</p>
+<code>
+

<form name="form" action="<A HREF="http://myhost/ThingWeb/portal">http://myhost/ThingWeb/portal</A>" 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>

</code>
+<p>In the above example, Turbine executes the action before the portlet and therefore the context is null. The above should be rewrittern as follows:</p>
+<code>
+

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

+</code>
+</td>
+ </tr>
+ </table>
+ </section>
+ </body>
</document>
-
-
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jetspeed-dev-help@jakarta.apache.org