You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@roller.apache.org by sn...@apache.org on 2006/12/07 18:02:42 UTC
svn commit: r483550 - in /incubator/roller/trunk/docs/installguide:
generated/roller-install-guide.html generated/roller-install-guide.pdf
roller-install-guide.odt
Author: snoopdave
Date: Thu Dec 7 09:02:41 2006
New Revision: 483550
URL: http://svn.apache.org/viewvc?view=rev&rev=483550
Log:
Updating roller.properties, adding note about encrypted passwords
Modified:
incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html
incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf
incubator/roller/trunk/docs/installguide/roller-install-guide.odt
Modified: incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html?view=diff&rev=483550&r1=483549&r2=483550
==============================================================================
--- incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html (original)
+++ incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html Thu Dec 7 09:02:41 2006
@@ -3,19 +3,27 @@
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
<TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="StarOffice 8 (Solaris x86)">
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Solaris x86)">
<META NAME="AUTHOR" CONTENT="Dave Johnson">
<META NAME="CREATED" CONTENT="20060123;11164600">
<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
- <META NAME="CHANGED" CONTENT="20060912;13352900">
+ <META NAME="CHANGED" CONTENT="20061207;11580200">
<STYLE>
<!--
@page { size: 8.5in 11in; margin: 0.5in }
P { margin-bottom: 0.08in }
P.western { font-family: "Times New Roman" }
H2.western { font-family: "Times New Roman" }
+ H2.cjk { font-family: "Andale Sans UI" }
+ H2.ctl { font-family: "Lucidasans" }
H3.western { font-family: "Times New Roman" }
+ H3.cjk { font-family: "Andale Sans UI" }
+ H3.ctl { font-family: "Lucidasans" }
H4.western { font-family: "Times New Roman"; font-size: 13pt }
+ H4.cjk { font-family: "Andale Sans UI" }
+ H4.ctl { font-family: "Lucidasans" }
+ PRE { font-family: "Cumberland", monospace }
+ TT { font-family: "Cumberland", monospace }
-->
</STYLE>
</HEAD>
@@ -30,15 +38,17 @@
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 40pt"><B>Installation
Guide</B></FONT></P>
-<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#ff0000"><FONT SIZE=7 STYLE="font-size: 40pt"><B>DRAFT
-#20060912</B></FONT></FONT></P>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
-Roller </B></FONT>
+Roller</B></FONT></P>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in">
+<FONT SIZE=5 STYLE="font-size: 20pt"><B>(incubating) </B></FONT>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><A NAME="DDE_LINK1"></A>
-<FONT SIZE=5 STYLE="font-size: 20pt"><B>Version 3.0 (incubating)</B></FONT></P>
+<FONT SIZE=7 STYLE="font-size: 32pt"><B>Version 3.2</B></FONT></P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
@@ -115,65 +125,94 @@
<FONT FACE="Albany, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Table
of Contents</B></FONT></FONT></P>
</DIV>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Introduction 3</B></FONT></P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Introduction 4</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 1: Before you install Roller 4</B></FONT></P>
+ 1: Before you install Roller 5</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 2: Unpack the Roller distribution 5</B></FONT></P>
+ 2: Unpack the Roller distribution 6</B></FONT></P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">UNIX example 6</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Windows example 6</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Roller
+ distribution layout 6</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">The ROLLER
+ environment variable 6</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 3: Install required third party jars 6</B></FONT></P>
+ 3: Install required third party jars 7</B></FONT></P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 3.1:
- Download and install Hibernate 6</P>
+ Download and install Hibernate 7</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 3.2: Install
- JDBC driver jar(s) 6</P>
+ JDBC driver jar(s) 7</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">UNIX example 7</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Windows example 7</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">NOTES 7</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 3.3: Install
- JavaMail and Activation jars 7</P>
+ JavaMail and Activation jars 9</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">UNIX example 9</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Windows example 9</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">NOTES 9</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 4: Create Roller tables in your database 8</B></FONT></P>
+ 4: Create Roller tables in your database 10</B></FONT></P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">UNIX example 10</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Windows
+ example 10</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 5: Deploy Roller to your application server 9</B></FONT></P>
+ 5: Deploy Roller to your application server 12</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 6: Check your internationalization settings 11</B></FONT></P>
+ 6: Check your internationalization settings 14</B></FONT></P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Check your
+ application server's URI encoding setting! 14</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 7: Setup Roller data directories 12</B></FONT></P>
+ 7: Setup Roller data directories 15</B></FONT></P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 7.1: Create
- uploads directory 12</P>
+ uploads directory 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 7.2: Create
- search-index directory 12</P>
+ search-index directory 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 7.3: Create
- planet-cache directory (optional) 12</P>
+ planet-cache directory (optional) 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 7.4: Make
- sure that the logs subdirectory exists 13</P>
+ sure that the logs subdirectory exists 15</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 8: Review Roller configuration 14</B></FONT></P>
+ 8: Review Roller configuration 16</B></FONT></P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 8.1: Review
- the WEB-INF/classes/roller.properties file 14</P>
+ the WEB-INF/classes/roller.properties file 16</P>
<P STYLE="margin-left: 0.59in; margin-bottom: 0in">Where to define
- custom properties 14</P>
+ custom properties 16</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">What properties
+ you should set 16</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 8.2: Change
- keys in the WEB-INF/security.xml file 15</P>
+ keys in the WEB-INF/security.xml file 17</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 8.3: Verify
+ the database dialet setting in the Hibernate configuration file 17</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>STEP
- 9: Start Tomcat and start using Roller 16</B></FONT></P>
+ 9: Start Tomcat and start using Roller 18</B></FONT></P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">UNIX example 18</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">Windows
+ example 18</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">You're done! 18</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Appendix
- A: Upgrading an existing Roller installation 17</B></FONT></P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 1: Shutdown
- and backup your old Roller 17</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 2: Install
- the new Roller 17</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 3: Copy
- resources and update configs 18</P>
+ A: Upgrading an existing Roller installation 19</B></FONT></P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">Important notes
+ about Roller 3.0 19</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">UPGRADE STEP 1:
+ Shutdown and backup your old Roller 20</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">UPGRADE STEP 2:
+ Install the new Roller 20</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">UPGRADE STEP 3:
+ Copy resources and update configs 20</P>
<P STYLE="margin-left: 0.59in; margin-bottom: 0in">3.1 Copy your old
- resources and other files you've added 18</P>
+ resources and other files you've added 20</P>
<P STYLE="margin-left: 0.59in; margin-bottom: 0in">3.2 Remove
- JavaMail jars if duplicated 18</P>
+ JavaMail jars if duplicated 20</P>
<P STYLE="margin-left: 0.59in; margin-bottom: 0in">3.3 Review
- configuration properties 18</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 4: Upgrade
- the database 18</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in">STEP 5: Startup
- your app server 19</P>
+ configuration properties 21</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">UPGRADE STEP 4:
+ Upgrade the database 21</P>
+ <P STYLE="margin-left: 0.39in; margin-bottom: 0in">UPGRADE STEP 5:
+ Startup your app server 21</P>
+ <P STYLE="margin-left: 0.59in; margin-bottom: 0in">And you're done!
+ 21</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Appendix
- B: The WEB-INF/roller.properties file 20</B></FONT></P>
+ B: The WEB-INF/roller.properties file 23</B></FONT></P>
</DIV>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
@@ -660,7 +699,7 @@
<H3 CLASS="western">STEP 7.2: Create <TT>search-index</TT> directory</H3>
<P CLASS="western">By default, Roller creates and maintains its text
search index data in files under the directory</P>
-<P CLASS="western"><TT><FONT FACE="Courier New"> ${user.home}/roller_data/roller-index</FONT></TT>
+<P CLASS="western"><TT><FONT FACE="Courier New"> ${user.home}/roller_data/search-index</FONT></TT>
</P>
<P CLASS="western">Again, <TT><FONT FACE="Courier New">${user.home}</FONT>
</TT>is the Java system property that normally evaluates to the home
@@ -747,17 +786,24 @@
</P>
<P CLASS="western" STYLE="margin-bottom: 0in">Here is a sample
<FONT FACE="Courier New">roller-custom.properties</FONT> with the few
-properties that should be overridden</P>
+properties that should be overridden.</P>
<P CLASS="western" STYLE="margin-bottom: 0in">
</P>
<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3> uploads.dir=/app/roller/roller_data/uploads</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3> search.index.dir=/app/roller/roller_data/search-index</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in">
+<FONT FACE="Courier New"><FONT SIZE=3>passwds.encryption.enabled=true</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3> #
etc, etc, etc ... any other properties you want to override</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Times New Roman, serif"><FONT SIZE=3><B>NOTE:
+Setting password encryption to true is a very good idea for new
+Roller sites,</B> but if you are upgrading an existing Roller site
+you'll need to come up with a strategy for converting your old
+unencrypted passwords before you turn encryption on.</FONT></FONT></P>
<H3 CLASS="western" STYLE="page-break-before: always">STEP 8.2:
Change keys in the <FONT FACE="Courier New">WEB-INF/security.xml</FONT>
file</H3>
@@ -1045,13 +1091,7 @@
NOTE: If you have any new themes under roller/themes, make sure to
copy those as well.
</P>
-<H4 CLASS="western"><A NAME="section-UpgradeGuide_2.1-3.2RemoveJavaMailJarsIfDuplicated"></A>
-3.2 Remove JavaMail jars if duplicated</H4>
-<P CLASS="western">In an upgrade installation, you may already have
-the JavaMail jars <TT>mail.jar</TT> and <TT>activation.jar</TT> in
-your Tomcat <TT>common/lib</TT>. If so, you should remove them from
-the <TT>WEB-INF/lib</TT> directory within the web app. (Keep them
-only in the <TT>common/lib</TT> directory.)
+<P CLASS="western"><BR><BR>
</P>
<H4 CLASS="western"><A NAME="section-UpgradeGuide_2.1-3.3ReviewConfigurationProperties"></A>
3.3 Review configuration properties</H4>
@@ -1067,8 +1107,8 @@
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<UL>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><B>WARNING: The
- files required for Roller's JSPWiki plugin, Ekit editor and
+ <LI VALUE=1><P CLASS="western" STYLE="margin-bottom: 0in"><B>WARNING:
+ The files required for Roller's JSPWiki plugin, Ekit editor and
Javascript enhanced editor have been removed from the Roller
distribution. If you'd like to continue to use these plugins, please
visit the Roller Support project on Java.Net
@@ -1087,33 +1127,35 @@
<P CLASS="western">The database script directories
</P>
<UL>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">WEB-INF/dbscripts/mysql
- </FONT>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">WEB-INF/dbscripts/mysql
+ </FONT></FONT>
</P>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">WEB-INF/dbscripts/postgresql
- </FONT>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">WEB-INF/dbscripts/postgresql
+ </FONT></FONT>
</P>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">WEB-INF/dbscripts/hsql
- </FONT>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">WEB-INF/dbscripts/hsql
+ </FONT></FONT>
</P>
<LI><P CLASS="western">and more...
</P>
</UL>
<P CLASS="western">There is an upgrade script for each release of
Roller. If you're upgrading from Roller 2.3, which was the last
-release before 3.0 you'll only need to run two scripts:
-<TT><FONT FACE="Courier New">210-to-230-migration.sql</FONT></TT> and
+release before 3.0 you'll need to run three scripts:
+<TT><FONT FACE="Courier New">230-to-240-migration.sql</FONT></TT>,
<FONT FACE="Courier New">240-to-300-migration.sql</FONT> (Roller 2.4
-was never officially released). For example, here's how you'd do that
-for a MySQL database running on UNIX:
-</P>
-<PRE> <FONT FACE="Courier New"><FONT SIZE=3>% cd $CATALINA_HOME/webapps/roller/WEB-INF/dbscripts/mysql</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>% mysql -u root -p</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>password: *****</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>mysql> use roller;</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>mysql> source 230-to-240-migration.sql</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>mysql> source 240-to-300-migration.sql</FONT></FONT>
- <FONT FACE="Courier New"><FONT SIZE=3>mysql> quit</FONT></FONT></PRE><P CLASS="western">
+was never officially released) and finally <TT><FONT FACE="Courier New">300-to-310-migration.sql</FONT></TT>.
+For example, here's how you'd do that for a MySQL database running on
+UNIX:
+</P>
+<PRE> <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">% cd $CATALINA_HOME/webapps/roller/WEB-INF/dbscripts/mysql</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">% mysql -u root -p</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">password: *****</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">mysql> use roller;</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">mysql> source 230-to-240-migration.sql</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">mysql> source 240-to-300-migration.sql</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">mysql> source 300-to-310-migration.sql</FONT></FONT>
+ <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">mysql> quit</FONT></FONT></PRE><P CLASS="western">
<BR><BR>
</P>
<P CLASS="western">If you're upgrading from an earlier release you'll
@@ -1138,9 +1180,6 @@
Roller user mailing list for help. If there are any interesting
messages in the log files, send those along too.
</P>
-<P CLASS="western"><BR><BR>
-</P>
-<H2 CLASS="western"></H2>
<H2 CLASS="western" STYLE="page-break-before: always">Appendix B: The
<FONT FACE="Courier New">WEB-INF/roller.properties</FONT> file</H2>
<P CLASS="western">This file defines the default start-up properties
@@ -1231,6 +1270,17 @@
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#---------------------------------</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Database configuration settings</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Hibernate dialect: You must override this to use a database other
+than MySQL4</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>hibernate.dialect=org.hibernate.dialect.MySQLDialect</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#---------------------------------</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
User management settings</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
@@ -1274,6 +1324,16 @@
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Themes settings</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+The directory in which Roller will look for themes</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>themes.dir=${webapp.context}</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
Search index settings</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
@@ -1338,7 +1398,7 @@
each represents a url at the application root, i.e. /<elem>/*</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>rendering.weblogMapper.rollerProtectedUrls=\</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>roller-ui,images,theme,themes,CommentAuthenticatorServlet,\</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>index.jsp,favicon.ico,robots.txt,taglibs.jsp,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>index.jsp,favicon.ico,robots.txt,\</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>page,flavor,rss,atom,language,search,comments,rsd,resource,xmlrpc,planetrss</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
@@ -1383,6 +1443,21 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Set of models to be made available for weblog page *preview*
+rendering</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+NOTE: this *does* have some differences between the pageModels</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>rendering.previewModels=\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.PreviewPageModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.ConfigModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.UtilitiesModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.PreviewURLModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.MessageModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.CalendarModel,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.MenuModel</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
Set of page models specifically for site-wide rendering</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>rendering.siteModels=\</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.rendering.model.SiteModel</FONT></FONT></P>
@@ -1535,38 +1610,86 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#,org.apache.roller.ui.rendering.plugins.BookmarkPlugin</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+The list of configured WeblogEntryEditors available to users</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>plugins.weblogEntryEditors=\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.core.plugins.TextEditor,\</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>org.apache.roller.ui.core.plugins.XinhaEditor</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+The "id" of the default editor to use. NOT the class name</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>plugins.defaultEditor=editor-text.jsp</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-scheduled tasks, each is comma separated list of classes</FONT></FONT></P>
+Scheduled Background Tasks ... all times are in minutes.</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Task properties should follow the given format ...</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+ tasks.<taskname>.<prop>=<value></FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+The *enabled* tasks are defined by
+tasks.enabled=<taskname>[,<taskname>]</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#-----------------------------------</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Tasks which are enabled. Only tasks listed here will be run.</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.enabled=ResetHitCountsTask,TurnoverReferersTask,PingQueueTask</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-Comma separated list of task classnames to be executed once per day</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.daily=org.apache.roller.ui.core.tasks.TurnoverReferersTask\</FONT></FONT></P>
+Reset hit counts</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.ResetHitCountsTask.class=org.apache.roller.business.runnable.ResetHitCountsTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.ResetHitCountsTask.startTime=startOfDay</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.ResetHitCountsTask.interval=1440</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.ResetHitCountsTask.leaseTime=30</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-Needed to enable nightly fetching of blacklist</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#,org.apache.roller.ui.core.tasks.BlacklistUpdateTask\</FONT></FONT></P>
+Reset referer counts</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TurnoverReferersTask.class=org.apache.roller.business.runnable.TurnoverReferersTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TurnoverReferersTask.startTime=startOfDay</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TurnoverReferersTask.interval=1440</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TurnoverReferersTask.leaseTime=30</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-Daily Planet task: syncs weblog list with Roller, refreshes
-Technorati stats</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#,org.apache.roller.ui.core.tasks.SyncWebsitesTask</FONT></FONT></P>
+Ping processor, does sending of pings</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.PingQueueTask.class=org.apache.roller.business.pings.PingQueueTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.PingQueueTask.startTime=immediate</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.PingQueueTask.interval=5</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.PingQueueTask.leaseTime=30</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-Comma separated list of task classnames to be executed hourly</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.hourly=\</FONT></FONT></P>
+Sync Roller weblogs with planet</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.SyncWebsitesTask.class=org.apache.roller.planet.tasks.SyncWebsitesTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.SyncWebsitesTask.startTime=startOfDay</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.SyncWebsitesTask.interval=1440</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.SyncWebsitesTask.leaseTime=30</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-Hourly Planet task: refresh latest entry list from all weblogs in
-list</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#org.apache.roller.ui.core.tasks.RefreshEntriesTask</FONT></FONT></P>
+Refresh entries for planet feeds</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.RefreshEntriesTask.class=org.apache.roller.planet.tasks.RefreshEntriesTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.RefreshEntriesTask.startTime=startOfHour</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.RefreshEntriesTask.interval=60</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.RefreshEntriesTask.leaseTime=30</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Technorati rankings for planet feeds</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TechnoratiRankingsTask.class=org.apache.roller.planet.tasks.TechnoratiRankingsTask</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TechnoratiRankingsTask.startTime=startOfDay</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TechnoratiRankingsTask.interval=1440</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tasks.TechnoratiRankingsTask.leaseTime=30</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
@@ -1583,11 +1706,6 @@
comment, referrer and trackback settings</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-comment authenticator settings (experimental)</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>authenticator.classname=org.apache.roller.ui.core.DefaultAuthenticator</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>comment.authenticator.classname=org.apache.roller.ui.rendering.util.MathCommentAuthenticator</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>comment.notification.separateOwnerMessage=false</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>comment.notification.hideCommenterAddresses=false</FONT></FONT></P>
@@ -1829,12 +1947,6 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
Set to true to enable the Planet aggregator. This will cause:</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-- The main page of Roller will become an aggregated view of all blogs
-in the </FONT></FONT>
-</P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
- Roller database, plus those defined in the Planet group 'external'.</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
- A new menu tab will appear for Roller admin users. This allows
admins to </FONT></FONT>
</P>
@@ -1848,6 +1960,18 @@
- http://localhost:8080/roller/planetrss</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
- http://localhost:8080/roller/planetrss?group=external</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+- You'll be able to add the $planet model to the list of page models
+available</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+ to blogs (rendering.pageModels) or to only site-wide blogs
+(rendering.siteModels) </FONT></FONT>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+ (classname org.apache.roller.ui.rendering.model.SiteModel)</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+ </FONT></FONT>
+</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>planet.aggregator.enabled=false</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
@@ -1945,21 +2069,6 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>users.sso.autoProvision.className=org.apache.roller.ui.core.security.BasicUserAutoProvision</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-misc settings</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>rememberme.enabled=true</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>debug.memory.enabled=false</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>compression.gzipResponse.enabled=true</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
-editor theme to be used (corresponds to directory name under /theme)</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>editor.theme=tan</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#---------------------------------</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
settings for various plugins</FONT></FONT></P>
@@ -1988,6 +2097,66 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>plugins.topictag.ignoreBookmarks=true</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#----------------------------------</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+misc settings</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Some folks consider remember-me type functionality to be a security</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>rememberme.enabled=true</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+You might want to disable GZIP if your app server already supports it</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>compression.gzipResponse.enabled=true</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+specifies the max number of tags allowed in URL (
+/feed?tags=foo+bar+baz )</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>tags.queries.maxIntersectionSize=3</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Characters to be allowed in user names (change at your own risk)</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>username.allowedChars=A-Za-z0-9</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+editor theme to be used (corresponds to directory name under /theme)</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>editor.theme=tan</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Hibernate config resource (a classpath-based path)</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+NO NEED TO OVERRIDE this unless you are customizing Roller</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>hibernate.configResource=/hibernate.cfg.xml</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+JDBC configuration parameters for standalone tasks</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Don't override these in the roller-custom.properties file you use
+with the </FONT></FONT>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+Roller webapp, but for the standalone tasks that you run outside of
+Roller </FONT></FONT>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+(e.g. refresh entries) you'll need to override these properties. Do
+it in a </FONT></FONT>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
+separate roller-custom.properties file.</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>jdbc.driverClass=</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>jdbc.connectionURL=</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>jdbc.username=</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>jdbc.password=</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#---------------------------------</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>#
Experimental settings</FONT></FONT></P>
@@ -2027,7 +2196,5 @@
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>aggregator.enabled=false</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>aggregator.cache.enabled=</FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><FONT FACE="Courier New"><FONT SIZE=2>aggregator.cache.timeout=14400</FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
</BODY>
</HTML>
Modified: incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf?view=diff&rev=483550&r1=483549&r2=483550
==============================================================================
Binary files - no diff available.
Modified: incubator/roller/trunk/docs/installguide/roller-install-guide.odt
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/roller-install-guide.odt?view=diff&rev=483550&r1=483549&r2=483550
==============================================================================
Binary files - no diff available.