portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From morci...@apache.org
Subject cvs commit: jakarta-jetspeed/xdocs faq.xml
Date Fri, 24 Oct 2003 21:59:41 GMT
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=&lt;proxyHost&gt; -DproxyPort=&lt;proxyPort&gt;
   &lt;servlet engine&gt; 
   </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=&lt;proxyHost&gt;
   -DproxyPort=&lt;proxyPort&gt;
   <br />
  -</li>
  -<li>Unix:<br />
  +							</li>
  +							<li>Unix:<br />
   export TOMCAT_OPTS="-DproxySet=true -DproxyHost=&lt;proxyHost&gt;
   -DproxyPort=&lt;proxyPort&gt;"
   <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>
     &lt;tomcat_home&gt;/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>
  +

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

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

&lt;form name="form" action="&lt;js:portletlink template=""  /&gt;" method="get"&gt;
&lt;input type="hidden" name="js_peid" value="&lt;%=jspeid%&gt;"/&gt;
 &lt;input
type="submit" name="eventSubmit_doSearch" value="Search"&gt;
 &lt;input type="reset"
value="Clear Fields"&gt;
 &lt;input type="text" name="thingieid" size="20"&gt;
&lt;/form&gt;
  +</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 &#169; 1999-2003, Apache Software Foundation
  +                    Copyright &#169; 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=&lt;proxyHost&gt; -DproxyPort=&lt;proxyPort&gt;
   &lt;servlet engine&gt; 
   </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=&lt;proxyHost&gt;
   -DproxyPort=&lt;proxyPort&gt;
   <br/>
  -</li>
  -<li>Unix:<br/>
  +							</li>
  +							<li>Unix:<br/>
   export TOMCAT_OPTS="-DproxySet=true -DproxyHost=&lt;proxyHost&gt;
   -DproxyPort=&lt;proxyPort&gt;"
   <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>
     &lt;tomcat_home&gt;/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>
   &lt;tomcat_home&gt;/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>
  +&#013;&#013;&lt;form name=&quot;form&quot; action=&quot;<A HREF="http://myhost/ThingWeb/portal">http://myhost/ThingWeb/portal</A>&quot;
method=&quot;get&quot;&gt;&#013; &lt;input type=&quot;hidden&quot;
name=&quot;js_peid&quot; value=&quot;&lt;%=jspeid%&gt;&quot;/&gt;&#013;
&lt;input type=&quot;hidden&quot; name=&quot;action&quot; value=&quot;ThingieSearchAction&quot;/&gt;&#013;
&lt;input type=&quot;submit&quot; name=&quot;eventSubmit_doSearch&quot;
value=&quot;Search&quot;&gt;&#013; &lt;input type=&quot;reset&quot;
value=&quot;Clear Fields&quot;&gt;&#013; &lt;input type=&quot;text&quot;
name=&quot;thingieid&quot; size=&quot;20&quot;&gt;&#013;&lt;/form&gt;&#013;&#013;</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>
  +&#013;&#013;&lt;form name=&quot;form&quot; action=&quot;&lt;js:portletlink
template=&quot;&quot;  /&gt;&quot; method=&quot;get&quot;&gt;&#013;
&lt;input type=&quot;hidden&quot; name=&quot;js_peid&quot; value=&quot;&lt;%=jspeid%&gt;&quot;/&gt;&#013;
&lt;input type=&quot;submit&quot; name=&quot;eventSubmit_doSearch&quot;
value=&quot;Search&quot;&gt;&#013; &lt;input type=&quot;reset&quot;
value=&quot;Clear Fields&quot;&gt;&#013; &lt;input type=&quot;text&quot;
name=&quot;thingieid&quot; size=&quot;20&quot;&gt;&#013;&lt;/form&gt;&#013;&#013;
  +</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


Mime
View raw message