roller-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From snoopd...@apache.org
Subject svn commit: r438950 [2/3] - in /incubator/roller/branches/roller_3.0/docs/installguide: generated/roller-install-guide.html generated/roller-install-guide.pdf generated/roller-install-guide.txt roller-install-guide.odt
Date Thu, 31 Aug 2006 15:04:45 GMT

Modified: incubator/roller/branches/roller_3.0/docs/installguide/generated/roller-install-guide.html
URL: http://svn.apache.org/viewvc/incubator/roller/branches/roller_3.0/docs/installguide/generated/roller-install-guide.html?rev=438950&r1=438949&r2=438950&view=diff
==============================================================================
--- incubator/roller/branches/roller_3.0/docs/installguide/generated/roller-install-guide.html (original)
+++ incubator/roller/branches/roller_3.0/docs/installguide/generated/roller-install-guide.html Thu Aug 31 08:04:45 2006
@@ -7,71 +7,98 @@
 	<META NAME="AUTHOR" CONTENT="Dave Johnson">
 	<META NAME="CREATED" CONTENT="20060123;11164600">
 	<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
-	<META NAME="CHANGED" CONTENT="20060508;14292600">
+	<META NAME="CHANGED" CONTENT="20060831;11013700">
 	<STYLE>
 	<!--
-		@page { size: 8.5in 11in; margin: 0.79in }
+		@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" }
+		H3.western { font-family: "Times New Roman" }
+		H4.western { font-family: "Times New Roman"; font-size: 13pt }
 	-->
 	</STYLE>
 </HEAD>
 <BODY LANG="en-US" DIR="LTR">
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 40pt"><B>Installation
+<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: 40pt"><B>Installation
 Guide</B></FONT></P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#ff0000"><FONT SIZE=7 STYLE="font-size: 40pt"><B>DRAFT
+#20060831</B></FONT></FONT></P>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
 Roller</B></FONT></P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><A NAME="DDE_LINK1"></A><FONT SIZE=5 STYLE="font-size: 20pt"><B>Version
-2.3-incubating</B></FONT></P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<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>
+<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"><BR>
+</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"><BR>
+</P>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
 </P>
-<P ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Licensed
+<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Licensed
 to the Apache Software Foundation (ASF) under one or more contributor
 license agreements.  The ASF licenses this file to You under the
 Apache License, Version 2.0 (the &quot;License&quot;); you may not
 use this file except in compliance with the License. You may obtain a
 copy of the License at</I></FONT></FONT></P>
-<P ALIGN=LEFT>      <FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>http://www.apache.org/licenses/LICENSE-2.0</I></FONT></FONT></P>
-<P ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Unless
+<P CLASS="western" ALIGN=LEFT>     
+<FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>http://www.apache.org/licenses/LICENSE-2.0</I></FONT></FONT></P>
+<P CLASS="western" ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Unless
 required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an &quot;AS IS&quot;
 BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
@@ -79,7 +106,7 @@
 permissions and limitations under the License.  For additional
 information regarding copyright in this work, please see the NOTICE
 file in the top level directory of this distribution.</I></FONT></FONT></P>
-<P ALIGN=LEFT STYLE="page-break-before: always"><BR><BR>
+<P CLASS="western" ALIGN=LEFT STYLE="page-break-before: always"><BR><BR>
 </P>
 <DIV ID="Table of Contents1" DIR="LTR">
 	<DIV ID="Table of Contents1_Head" DIR="LTR">
@@ -147,35 +174,35 @@
 	<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>
 </DIV>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-Introduction"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-Introduction"></A>
 Introduction</H2>
-<P><B>This document describes how to install Roller in the following
-environment: </B>
+<P CLASS="western"><B>This document describes how to install Roller
+in the following environment: </B>
 </P>
 <UL>
-	<LI><P STYLE="margin-bottom: 0in; font-weight: medium">Operating
-	System: 		UNIX or Windows based operating system 
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
+	Operating System: 		UNIX or Windows based operating system 
 	</P>
-	<LI><P STYLE="margin-bottom: 0in; font-weight: medium">Java
-	development kit: 	Java 2 SE 1.4 SDK (or later)</P>
-	<LI><P STYLE="margin-bottom: 0in; font-weight: medium">Application
-	server: 		Tomcat 5.X (or later)</P>
-	<LI><P STYLE="font-weight: medium">Relational Database:		MySQL 4.X
-	(or later)</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
+	Java development kit: 		Java 2 SE 1.4 SDK (or later)</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
+	Application server: 		Tomcat 5.X (or later)</P>
+	<LI><P CLASS="western" STYLE="font-weight: medium">Relational
+	Database:		MySQL 4.X (or later)</P>
 </UL>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P><B>NOTE: If you're upgrading from an earlier release of Roller,
-read Appendix A first</B></P>
-<P><BR><BR>
+<P CLASS="western"><B>NOTE: If you're upgrading from an earlier
+release of Roller, read Appendix A first</B></P>
+<P CLASS="western"><BR><BR>
 </P>
-<P><B>What do you need to know to install Roller? </B>You need to
-know how to use the UNIX or Windows command-line, how to set
+<P CLASS="western"><B>What do you need to know to install Roller? </B>You
+need to know how to use the UNIX or Windows command-line, how to set
 environment variables, how to create a database in MySQL and how to
 start and stop Tomcat.</P>
-<P><B>What about other servlet containers?</B> <SPAN STYLE="font-style: normal">These
+<P CLASS="western"><B>What about other servlet containers?</B> <SPAN STYLE="font-style: normal">These
 instructions target Tomcat, but you should be able to make Roller
 work with just about any standard Servlet 2.3 compatible application
 server. For full support of Roller's internationalization features,
@@ -183,578 +210,584 @@
 server, please contribute your install notes to help others who might
 want to do the same.</SPAN> 
 </P>
-<P><B>What about other databases?</B> These instructions target
-MySQL, but Roller also includes database setup scripts for PostgreSQL
-7.X later, Apache Derby, IBM DB2, Oracle and HSQL-DB.</P>
-<P><B>What platform combinations are known to work?</B> For
-information on which platforms we can vouch for, see the the
+<P CLASS="western"><B>What about other databases?</B> These
+instructions target MySQL, but Roller also includes database setup
+scripts for PostgreSQL 7.X later, Apache Derby, IBM DB2, Oracle and
+HSQL-DB.</P>
+<P CLASS="western"><B>What platform combinations are known to work?</B>
+For information on which platforms we can vouch for, see the the
 <SPAN STYLE="font-weight: medium"><I>Platforms</I></SPAN> page on the
 Roller wiki.</P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP1Prerequisites1"></A><A NAME="ref-InstallationGuide_2.x-1"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP1Prerequisites1"></A><A NAME="ref-InstallationGuide_2.x-1"></A>
 STEP 1: Before you install Roller</H2>
-<P STYLE="font-weight: medium">Before you install Roller software you
-should install and configure the Java development kit, your
-application server and your database.</P>
-<P>As part of the Tomcat install you should have set the environment
-variable CATALINA_HOME to point to your Tomcat installation
-directory. If not, you might want to set it now because we will refer
-to it in this installation guide. Below are some examples that show
-how to set this variable. Make sure you substitute the right path to
-your Tomcat installation.</P>
-<P>For UNIX with bash shell:</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	%
+<P CLASS="western" STYLE="font-weight: medium">Before you install
+Roller software you should install and configure the Java development
+kit, your application server and your database.</P>
+<P CLASS="western">As part of the Tomcat install you should have set
+the environment variable CATALINA_HOME to point to your Tomcat
+installation directory. If not, you might want to set it now because
+we will refer to it in this installation guide. Below are some
+examples that show how to set this variable. Make sure you substitute
+the right path to your Tomcat installation.</P>
+<P CLASS="western">For UNIX with bash shell:</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	%
 export CATALINA_HOME=/opt/jakarta-tomcat-5.5.9</FONT></FONT></P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P>For UNIX with c-shell:</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	%
+<P CLASS="western">For UNIX with c-shell:</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	%
 setenv CATALINA_HOME /opt/jakarta-tomcat-5.5.9</FONT></FONT></P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P>For Windows with DOS shell</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	C&gt;
+<P CLASS="western">For Windows with DOS shell</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	C&gt;
 set CATALINA_HOME d:\jakarta-tomcat-5.5.9</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P><B>NOTES</B></P>
+<P CLASS="western"><B>NOTES</B></P>
 <UL>
-	<LI><P>For MySQL, make sure you enable UTF-8 support. See the page
-	Setting Up UTF-8 on MySQL page on the Roller wiki for details.</P>
-	<LI><P>For MySQL, make sure that TCP/IP networking is enabled. In
-	some versions of MySQL, this option is off by default. See the page
-	Debian MySQL for details. The Connector/J JDBC driver can only
-	access MySQL via TCP/IP. 
+	<LI><P CLASS="western">For MySQL, make sure you enable UTF-8
+	support. See the page Setting Up UTF-8 on MySQL page on the Roller
+	wiki for details.</P>
+	<LI><P CLASS="western">For MySQL, make sure that TCP/IP networking
+	is enabled. In some versions of MySQL, this option is off by
+	default. See the page Debian MySQL for details. The Connector/J JDBC
+	driver can only access MySQL via TCP/IP. 
 	</P>
 </UL>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP2UnpackTheDownloadedZIPOrTARFile2"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP2UnpackTheDownloadedZIPOrTARFile2"></A>
 STEP 2: Unpack the Roller distribution</H2>
-<P>Pick a directory on your computer and unpack the Roller
-distribution using either GNU tar on UNIX or WinZip on Windows.
-Hereinafter, we'll refer to that directory as your Roller
-installation directory, <FONT FACE="Courier New">$ROLLER</FONT> in
-the UNIX examples or <FONT FACE="Courier New">%ROLLER%</FONT> in the
-Windows examples.</P>
-<P><BR><BR>
-</P>
-<P>Here are some examples to show you how you might unpack Roller on
-your computer.</P>
-<P><B>UNIX example</B></P>
-<P>Assuming you download the distribution into your home directory
-and you'd like to install Roller into <FONT FACE="Courier New">/usr/local</FONT>
-you might do something like this:</P>
-<PRE><FONT FACE="Courier New"><FONT SIZE=2>	% cd /usr/local</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	% tar xzvf ~/roller-2.3.tar.gz</FONT></FONT>
-</PRE><P>
+<P CLASS="western">Pick a directory on your computer and unpack the
+Roller distribution using either GNU tar on UNIX or WinZip on
+Windows. Here are some examples to show you how you might unpack
+Roller on your computer.</P>
+<H4 CLASS="western">UNIX example</H4>
+<P CLASS="western">Assuming you download the distribution into your
+home directory and you'd like to install Roller into <FONT FACE="Courier New">/usr/local</FONT>
+you might do something like this in the bash shell:</P>
+<PRE><FONT FACE="Courier New"><FONT SIZE=3>	% cd /usr/local</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=3>	% tar xzvf ~/apache-roller-3.0-incubating.tar.gz</FONT></FONT>
+</PRE><P CLASS="western">
 That would create the Roller installation directory
-<FONT FACE="Courier New">/usr/local/roller</FONT>. 
+<FONT FACE="Courier New">/usr/local/apache-roller-3.0-incubating</FONT>.
+</P>
+<H4 CLASS="western">Windows example</H4>
+<P CLASS="western">You can Use WinZip to extract the Roller
+distribution file into the directory of your choice. 
+</P>
+<H4 CLASS="western">Roller distribution layout</H4>
+<P CLASS="western">Once you've extracted the files you'll see that
+the Roller release contains two directories and a couple of text
+files:</P>
+<P CLASS="western">	docs			Directory containing Roller documentation</P>
+<P CLASS="western">	webapp/roller		Directory containing rhe Roller
+web application in WAR directory layout</P>
+<P CLASS="western">	README.txt		Explains what Roller is</P>
+<P CLASS="western">	CHANGES.txt	Lists changes made in each release</P>
+<P CLASS="western">	NOTICE.txt		Copyright notices and credits</P>
+<P CLASS="western">	LICENSE.txt		The Apache Software License</P>
+<H4 CLASS="western">The ROLLER environment variable</H4>
+<P CLASS="western">In this guide, we'll refer to the Roller web
+application directory using the ROLLER environment variable. In UNIX
+this will be $ROLLER. In Windows, it will be %ROLLER%. You don't <I>have</I>
+to set the ROLLER environment variable, we just use it to simplify
+the installation guide, but here's how you'd do it.</P>
+<P CLASS="western">UNIX example (assuming you installed into
+<FONT FACE="Courier New">/usr/local</FONT>):</P>
+<P CLASS="western"><FONT FACE="Courier New">	% set $ROLLER =
+/usr/local/apache-roller-3.0-incubating/webapp/roller</FONT></P>
+<P CLASS="western">Windows example (assuming you installed into <FONT FACE="Courier New">c:\</FONT>)</P>
+<P CLASS="western"><FONT FACE="Courier New">	% set %ROLLER% =
+c:\apache-roller-3.0-incubating/webapp/roller</FONT></P>
+<P CLASS="western"><A NAME="DDE_LINK3"></A><BR><BR>
 </P>
-<P><B>Windows example</B></P>
-<P>Use WinZip to extract the Roller distribution file into the
-directory of your choice for example, no example necessary.</P>
-<H3><A NAME="DDE_LINK3"></A></H3>
-<H2></H2>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP4DownloadAndInstallRequiredJars4"></A>
+<H2 CLASS="western"></H2>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP4DownloadAndInstallRequiredJars4"></A>
 STEP 3: Install required third party jars</H2>
-<P>You also need to download and install some third-party jars, jars
-that we can't include in Roller due to licensing restrictions. These
-are the JDBC driver, JavaMail and Activation jars.</P>
-<H3><A NAME="DDE_LINK4"></A>STEP 3.1: Download and install Hibernate</H3>
-<P>Roller <I>requires</I> the Hibernate persistence library, which
-you must download separately from Roller. 
-</P>
-<P>	Download Hibernate 3.1.2 from SourceForge</P>
-<P>	<A HREF="http://prdownloads.sourceforge.net/hibernate/hibernate-3.1.2.tar.gz">http://prdownloads.sourceforge.net/hibernate/hibernate-3.1.2.tar.gz</A></P>
-<P>Copy the following files from Hibernate into the Roller
-WEB-INF/lib directory:</P>
+<P CLASS="western">You also need to download and install some
+third-party jars, jars that we can't include in Roller due to
+licensing restrictions. These are the JDBC driver, JavaMail and
+Activation jars.</P>
+<H3 CLASS="western"><A NAME="DDE_LINK4"></A>STEP 3.1: Download and
+install Hibernate</H3>
+<P CLASS="western">Roller <I>requires</I> the Hibernate persistence
+library, which you must download separately from Roller. 
+</P>
+<P CLASS="western">	Download Hibernate 3.1.2 from SourceForge</P>
+<P CLASS="western">	<A HREF="http://prdownloads.sourceforge.net/hibernate/hibernate-3.1.2.tar.gz">http://prdownloads.sourceforge.net/hibernate/hibernate-3.1.2.tar.gz</A></P>
+<P CLASS="western">Copy the following files from Hibernate into the
+Roller WEB-INF/lib directory:</P>
 <UL>
-	<LI><P>hibernate3.jar</P>
-	<LI><P>asm-attrs.jar</P>
+	<LI><P CLASS="western">hibernate3.jar</P>
+	<LI><P CLASS="western">asm-attrs.jar</P>
 </UL>
 <UL>
-	<LI><P>asm.jar</P>
-	<LI><P>cglib-2.1.3.jar</P>
-	<LI><P>dom4j.1.6.1.jar</P>
-	<LI><P>ehcache-1.1.jar</P>
-	<LI><P>jdbc2_0-stdext.jar</P>
-	<LI><P>jta.jar</P>
+	<LI><P CLASS="western">asm.jar</P>
+	<LI><P CLASS="western">cglib-2.1.3.jar</P>
+	<LI><P CLASS="western">dom4j.1.6.1.jar</P>
+	<LI><P CLASS="western">ehcache-1.1.jar</P>
+	<LI><P CLASS="western">jdbc2_0-stdext.jar</P>
+	<LI><P CLASS="western">jta.jar</P>
 </UL>
-<P>The Roller Support project at Java.Net offers some bundles that
-might make this part  of the installation easier. Visit
+<P CLASS="western">The Roller Support project at Java.Net offers some
+bundles that might make this part of the installation easier. Visit
 <A HREF="http://roller.dev.java.net/">http://roller.dev.java.net</A>
 for more information.</P>
-<H3>STEP 3.2: Install JDBC driver jar(s)</H3>
-<P>Download the JDBC driver jar for your database and put it in the
-classpath of your application server. For example, assuming Tomcat
-and MySQL, you'd download the J/Connector JDBC driver from mysql.com
-and you'd place it in the Tomcat <FONT FACE="Courier New">common/lib</FONT>
-directory.</P>
-<P><B>UNIX example</B></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	%
+<H3 CLASS="western">STEP 3.2: Install JDBC driver jar(s)</H3>
+<P CLASS="western"><FONT FACE="Times New Roman">Download the JDBC
+driver jar for your database and put it in the classpath of your
+application server. For example, assuming Tomcat and MySQL, you'd
+download the J/Connector JDBC driver from mysql.com and you'd place
+it in the Tomcat common/lib directory.</FONT></P>
+<H4 CLASS="western">UNIX example</H4>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT SIZE=3><FONT FACE="Courier New">	%
 cp mysql-connector.jar $CATALINA_HOME/common/lib</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P><B>Windows example</B></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	C&gt;
+<H4 CLASS="western">Windows example</H4>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT SIZE=3><FONT FACE="Courier New">	C&gt;
 copy mysql-connector.jar %CATALINA_HOME%\common\lib</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P><B>NOTES</B></P>
+<H4 CLASS="western">NOTES</H4>
 <UL>
-	<LI><P STYLE="margin-bottom: 0in">For MySQL 4.1.X users, we
-	recommend that you use the J/Connector 3.0.X JDBC drivers instead of
-	the newer 3.1.X series. If you <I>must</I> use J/Connector/J 3.1.X
-	then please read <I>Installation FAQ</I> page item #13 on the Roller
-	wiki.</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">For MySQL 4.1.X
+	users, we recommend that you use the J/Connector 3.0.X JDBC drivers
+	instead of the newer 3.1.X series. If you <I>must</I> use
+	J/Connector/J 3.1.X then please read <I>Installation FAQ</I> page
+	item #13 on the Roller wiki.</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">For MySQL 5.X
+	users, we recommend that you use the J/Connector 3.1.X JDBC drivers
+	instead of the newer 3.1.X series, you'll also need to change the
+	Hibernate configuration file to use the MySQL5 dialect (see Section
+	8.3 for details on that).</P>
 </UL>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<H3>STEP 3.3: Install JavaMail and Activation jars</H3>
-<P>If you like to use Roller's e-mail notification features, you'll
-need to add the JavaMail and Activation jars to your application
-server's classpath. Currently, we ship these jars with Roller, but
-you will need to  <B>move</B> them from the Roller <FONT FACE="Courier New">WEB-INF/lib</FONT>
-directory and into the Tomcat <FONT FACE="Courier New">common/lib</FONT>
-directory, or your server's equivalent location.</P>
-<P><B>UNIX example</B></P>
-<P><FONT FACE="Courier New"><FONT SIZE=2>	% mv
+<H3 CLASS="western" STYLE="page-break-before: always">STEP 3.3:
+Install JavaMail and Activation jars</H3>
+<P CLASS="western">If you like to use Roller's e-mail notification
+features, you'll need to add the JavaMail and Activation jars to your
+application server's classpath. Currently, we ship these jars with
+Roller, but you will need to  <B>move</B> them from the Roller
+<FONT FACE="Courier New">WEB-INF/lib</FONT> directory and into the
+Tomcat <FONT FACE="Courier New">common/lib</FONT> directory, or your
+server's equivalent location.</P>
+<H4 CLASS="western">UNIX example</H4>
+<P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>	% mv
 $ROLLER/WEB-INF/lib/mail.jar $CATALINA_HOME/common/lib</FONT></FONT></P>
-<P><FONT SIZE=2><FONT FACE="Courier New">	% mv
-$ROLLER/WEB-INF/lib/activation.jar $CATALINA_HOME/common/lib</FONT>	</FONT></P>
-<P><B>Windows example</B></P>
-<P><FONT FACE="Courier New"><FONT SIZE=2>	c&gt; move
+<P CLASS="western"><FONT SIZE=2><FONT SIZE=3><FONT FACE="Courier New">	%
+mv $ROLLER/WEB-INF/lib/activation.jar $CATALINA_HOME/common/lib</FONT></FONT>	</FONT></P>
+<H4 CLASS="western">Windows example</H4>
+<P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>	c&gt; move
 %ROLLER%\WEB-INF\lib\mail.jar %CATALINA_HOME%\common\lib</FONT></FONT></P>
-<P><FONT FACE="Courier New"><FONT SIZE=2>	C&gt; move
+<P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>	C&gt; move
 %ROLLER%\WEB-INF\lib\activation.jar %CATALINA_HOME%\common\lib</FONT></FONT></P>
-<P><B>NOTES</B></P>
+<H4 CLASS="western">NOTES</H4>
 <UL>
-	<LI><P>To enable the Roller's e-mail notification features, you'll
-	also need to setup a mail session resource in your application
-	server configuration file (see the next section) and you'll need to
-	configure e-mail notification in the Roller UI.</P>
+	<LI><P CLASS="western">To enable the Roller's e-mail notification
+	features, you'll also need to setup a mail session resource in your
+	application server configuration file (see the next section) and
+	you'll need to configure e-mail notification in the Roller UI.</P>
 </UL>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP3CreateRollerTablesInYourDatabase3"></A><A NAME="ref-InstallationGuide_2.x-3"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP3CreateRollerTablesInYourDatabase3"></A><A NAME="ref-InstallationGuide_2.x-3"></A>
 STEP 4: Create Roller tables in your database</H2>
-<P>Create a new database within your MySQL installation, create a
-user with all privileges within that database and run the Roller
-database creation script to create tables within that new database.</P>
-<P>Roller includes database creation scripts for a variety of
-database, but MySQL is the most widely used and best supported
-option. You can find the database creation scripts in the Roller
-installation directory under <FONT FACE="Courier New">WEB-INF/dbscripts/<I>&lt;dbname&gt;</I></FONT>.
+<P CLASS="western">Create a new database within your MySQL
+installation, create a user with all privileges within that database
+and run the Roller database creation script to create tables within
+that new database. Roller includes database creation scripts for a
+variety of database, but MySQL is the most widely used and best
+supported option. You can find the database creation scripts in the
+Roller webapp directory <FONT FACE="Courier New">$ROLLER/WEB-INF/dbscripts/<I>&lt;dbname&gt;</I></FONT>.
 Here's the list of scripts currently in Roller:</P>
 <UL>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/mysql/creatdb.sql	</FONT></FONT></P>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/postgresql/creatdb.sql	</FONT></FONT></P>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/hsqldb/creatdb.sql</FONT></FONT></P>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/derby/creatdb.sql</FONT></FONT></P>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/db2/creatdb.sql</FONT></FONT></P>
-	<LI><P><FONT FACE="Courier New"><FONT SIZE=2>WEB-INF/dbscripts/oracle/creatdb.sql</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/mysql/creatdb.sql	</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/postgresql/creatdb.sql	</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/hsqldb/creatdb.sql</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/derby/creatdb.sql</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/db2/creatdb.sql</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/oracle/creatdb.sql</FONT></FONT></P>
+	<LI><P CLASS="western"><FONT FACE="Courier New"><FONT SIZE=3>WEB-INF/dbscripts/oracle/creatdb.sql</FONT></FONT></P>
 </UL>
-<P><BR><BR>
-</P>
-<P>Here are some examples to show you how you might create the Roller
-tables in MySQL:</P>
-<P><B>UNIX example:</B></P>
-<PRE><FONT FACE="Courier New"><FONT SIZE=2>	% cd $ROLLER/WEB-INF/dbscripts/mysql</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	% mysql -u root -p</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	password: *****</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; create database roller;</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; grant all on roller.* to scott@'%' identified by 'tiger';</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; grant all on roller.* to scott@localhost identified by 'tiger';</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; use roller;</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; source createdb.sql</FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=2>	mysql&gt; quit</FONT></FONT></PRE><P>
-<B>Windows example:</B></P>
-<PRE>	<FONT FACE="Courier New">C&gt; cd %ROLLER%\WEB-INF\dbscripts\mysql</FONT>
-<FONT FACE="Courier New">	C&gt; mysql -u root -p</FONT>
-<FONT FACE="Courier New">	password: *****</FONT>
-<FONT FACE="Courier New">	mysql&gt; create database roller;</FONT>
-<FONT FACE="Courier New">	mysql&gt; grant all on roller.* to scott@'%' identified by 'tiger';</FONT>
-<FONT FACE="Courier New">	mysql&gt; grant all on roller.* to scott@'localhost' identified by 'tiger';</FONT>
-<FONT FACE="Courier New">	mysql&gt; use roller;</FONT>
-<FONT FACE="Courier New">	mysql&gt; source createdb.sql</FONT>
-<FONT FACE="Courier New">	mysql&gt; quit</FONT></PRE><P>
+<P CLASS="western">Here are some examples to show you how you might
+create the Roller tables in MySQL:</P>
+<H4 CLASS="western">UNIX example</H4>
+<PRE><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	% cd $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&gt; create database roller;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; grant all on roller.* to scott@'%' identified by 'tiger';</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; grant all on roller.* to scott@localhost identified by 'tiger';</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; use roller;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; source createdb.sql</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; quit</FONT></FONT></PRE><H4 CLASS="western">
+Windows example</H4>
+<PRE><FONT SIZE=2 STYLE="font-size: 11pt">	<FONT FACE="Courier New">C&gt; cd %ROLLER%\WEB-INF\dbscripts\mysql</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	C&gt; 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&gt; create database roller;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; grant all on roller.* to scott@'%' identified by 'tiger';</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; grant all on roller.* to scott@'localhost' identified by 'tiger';</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; use roller;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; source createdb.sql</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">	mysql&gt; quit</FONT></FONT></PRE><P CLASS="western">
 <B>NOTES</B></P>
 <UL>
-	<LI><P>For MySQL, don't forget to call <I>flush privileges </I><SPAN STYLE="font-style: normal">to
-	commit your changes to MySQL.</SPAN></P>
-	<LI><P>To check whether your MySQL is setup properly, use the
-	command line mysql program to connect using the user name and
-	password you created. For example (we use 127.0.0.1 here instead of
-	localhost to ensure that TCP/IP networking is enabled):</P>
+	<LI><P CLASS="western">For MySQL, don't forget to call <I>flush
+	privileges </I><SPAN STYLE="font-style: normal">to commit your
+	changes to MySQL.</SPAN></P>
+	<LI><P CLASS="western">To check whether your MySQL is setup
+	properly, use the command line mysql program to connect using the
+	user name and password you created. For example (we use 127.0.0.1
+	here instead of localhost to ensure that TCP/IP networking is
+	enabled):</P>
 </UL>
-<P STYLE="margin-bottom: 0in">		<FONT FACE="Courier New">mysql roller
--h 127.0.0.1 -u scott -ptiger</FONT></P>
-<P><BR><BR>
-</P>
-<P>	</P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP5DeployRollerToYourApplicationServer5"></A><A NAME="ref-InstallationGuide_2.x-5"></A>
+<P CLASS="western" STYLE="margin-bottom: 0in">		<FONT FACE="Courier New">mysql
+roller -h 127.0.0.1 -u scott -ptiger</FONT></P>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP5DeployRollerToYourApplicationServer5"></A><A NAME="ref-InstallationGuide_2.x-5"></A>
 STEP 5: Deploy Roller to your application server</H2>
-<P>To deploy Roller to your application server you need to inform
-your application server:</P>
+<P CLASS="western">To deploy Roller to your application server you
+need to inform your application server:</P>
 <UL>
-	<LI><P STYLE="margin-bottom: 0in">Where to find the Roller
-	installation directory  
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">Where to find the
+	Roller installation directory  
 	</P>
-	<LI><P>How to configure the Roller datasource under the JNDI name
-	<FONT FACE="Courier New">jdbc/rollerdb </FONT>
+	<LI><P CLASS="western">How to configure the Roller datasource under
+	the JNDI name <FONT FACE="Courier New">jdbc/rollerdb </FONT>
 	</P>
 </UL>
-<P STYLE="margin-bottom: 0in">For Tomcat you can do this by creating
-what's known as a context configuration file named <FONT FACE="Courier New">roller.xml</FONT>
-and placing that file in the Tomcat <FONT FACE="Courier New">conf/Catalina/localhost</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">For Tomcat you can do
+this by creating what's known as a context configuration file named
+<FONT FACE="Courier New">roller.xml</FONT> and placing that file in
+the Tomcat <FONT FACE="Courier New">conf/Catalina/localhost</FONT>
 directory. 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><B>Example context configuration file
-for Tomcat 5.0.X users</B></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in; font-weight: medium">The portions shown
-in bold are the ones that you'll probably have to change. Make sure
-you set the docBase to point to your Roller installation directory.
-Make sure you set the JDBC connection string to point to your
-database and the database username and password too.</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<PRE><FONT FACE="Courier New">&lt;Context path=&quot;/roller&quot; docBase=&quot;<B>/usr/local/roller</B>&quot; debug=&quot;0&quot;&gt;</FONT>
-  <FONT FACE="Courier New">&lt;Resource name=&quot;jdbc/rollerdb&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot; /&gt;</FONT>
-  <FONT FACE="Courier New">&lt;ResourceParams name=&quot;jdbc/rollerdb&quot;&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;</FONT>
-       <FONT FACE="Courier New">&lt;name&gt;factory&lt;/name&gt;</FONT>
-       <FONT FACE="Courier New">&lt;value&gt;org.apache.commons.dbcp.BasicDataSourceFactory&lt;/value&gt;</FONT>
-    <FONT FACE="Courier New">&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;</FONT>
-       <FONT FACE="Courier New">&lt;name&gt;driverClassName&lt;/name&gt;</FONT>
-       <FONT FACE="Courier New">&lt;value&gt;com.mysql.jdbc.Driver&lt;/value&gt;</FONT>
-    <FONT FACE="Courier New">&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;        </FONT>
-       <FONT FACE="Courier New">&lt;name&gt;url&lt;/name&gt;</FONT>
-       <FONT FACE="Courier New">&lt;value&gt;</FONT>
-       <FONT FACE="Courier New"><B>jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=utf-8&amp;amp;mysqlEncoding=utf8</B></FONT>
-       <FONT FACE="Courier New">&lt;/value&gt;</FONT>
-    <FONT FACE="Courier New">&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;username&lt;/name&gt;&lt;value&gt;<B>scott</B>&lt;/value&gt;&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;password&lt;/name&gt;&lt;value&gt;<B>tiger</B>&lt;/value&gt;&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;maxActive&lt;/name&gt;&lt;value&gt;20&lt;/value&gt;&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;maxIdle&lt;/name&gt;&lt;value&gt;3&lt;/value&gt;&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;removeAbandoned&lt;/name&gt;&lt;value&gt;true&lt;/value&gt;&lt;/parameter&gt;</FONT>
-    <FONT FACE="Courier New">&lt;parameter&gt;&lt;name&gt;maxWait&lt;/name&gt;&lt;value&gt;3000&lt;/value&gt;&lt;/parameter&gt;</FONT>
-  <FONT FACE="Courier New">&lt;/ResourceParams&gt;</FONT>
-  <FONT FACE="Courier New">&lt;!-- If you want e-mail features, un-comment the section below --&gt;</FONT>
-  <FONT FACE="Courier New">&lt;!--</FONT>
-  <FONT FACE="Courier New">&lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot; type=&quot;javax.mail.Session&quot;/&gt;</FONT>
-    <FONT FACE="Courier New">&lt;ResourceParams name=&quot;mail/Session&quot;&gt;</FONT>
-      <FONT FACE="Courier New">&lt;parameter&gt;</FONT>
-        <FONT FACE="Courier New">&lt;name&gt;mail.smtp.host&lt;/name&gt;</FONT>
-        <FONT FACE="Courier New">&lt;value&gt;mailhost.example.com&lt;/value&gt;</FONT>
-      <FONT FACE="Courier New">&lt;/parameter&gt;</FONT>
-  <FONT FACE="Courier New">&lt;/ResourceParams&gt;</FONT>
-  <FONT FACE="Courier New">--&gt;</FONT>
-<FONT FACE="Courier New">&lt;/Context&gt;</FONT></PRE><P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><B>Example context
+configuration file for Tomcat 5.0.X users</B></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">The
+portions shown in bold are the ones that you'll probably have to
+change. Make sure you set the docBase to point to your Roller
+installation directory. Make sure you set the JDBC connection string
+to point to your database and the database username and password too.</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<PRE><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;Context path=&quot;/roller&quot; docBase=&quot;<B>/usr/local/apache-roller-3.0-incubating/webapp/roller</B>&quot; debug=&quot;0&quot;&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;Resource name=&quot;jdbc/rollerdb&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot; /&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;ResourceParams name=&quot;jdbc/rollerdb&quot;&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;name&gt;factory&lt;/name&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;value&gt;org.apache.commons.dbcp.BasicDataSourceFactory&lt;/value&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;name&gt;driverClassName&lt;/name&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;value&gt;com.mysql.jdbc.Driver&lt;/value&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;        </FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;name&gt;url&lt;/name&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;value&gt;</FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt"><B>jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=utf-8&amp;amp;mysqlEncoding=utf8</B></FONT></FONT>
+       <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/value&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;username&lt;/name&gt;&lt;value&gt;<B>scott</B>&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;password&lt;/name&gt;&lt;value&gt;<B>tiger</B>&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;maxActive&lt;/name&gt;&lt;value&gt;20&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;maxIdle&lt;/name&gt;&lt;value&gt;3&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;removeAbandoned&lt;/name&gt;&lt;value&gt;true&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;&lt;name&gt;maxWait&lt;/name&gt;&lt;value&gt;3000&lt;/value&gt;&lt;/parameter&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/ResourceParams&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;!-- If you want e-mail features, un-comment the section below --&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;!--</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot; type=&quot;javax.mail.Session&quot;/&gt;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;ResourceParams name=&quot;mail/Session&quot;&gt;</FONT></FONT>
+      <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;parameter&gt;</FONT></FONT>
+        <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;name&gt;mail.smtp.host&lt;/name&gt;</FONT></FONT>
+        <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;value&gt;mailhost.example.com&lt;/value&gt;</FONT></FONT>
+      <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/parameter&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/ResourceParams&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">--&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/Context&gt;</FONT></FONT></PRE><P CLASS="western">
 <BR><BR>
 </P>
-<P STYLE="margin-bottom: 0in; page-break-before: always"><B>Example
-context configuration file for Tomcat 5.5.X users</B></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in; font-weight: medium">The portions shown
-in bold are the ones that you'll probably have to change. Make sure
-you set the docBase to point to your Roller installation directory.
-Make sure you set the JDBC connection string to point to your
-database and the database username and password too.</P>
-<P STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
-<PRE><FONT FACE="Courier New">&lt;Context path=&quot;/roller&quot; docBase=&quot;<B>/usr/local/roller</B>&quot; debug=&quot;0&quot;&gt;</FONT>
-  <FONT FACE="Courier New">&lt;Resource name=&quot;jdbc/rollerdb&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot;</FONT>
-    <FONT FACE="Courier New">driverClassName=&quot;com.mysql.jdbc.Driver&quot;</FONT>
-    <FONT FACE="Courier New">url=&quot;<B>jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=utf-8&amp;amp;mysqlEncoding=utf8</B>&quot;</FONT>
-    <FONT FACE="Courier New">username=&quot;<B>scott</B>&quot;</FONT>
-    <FONT FACE="Courier New">password=&quot;<B>tiger</B>&quot;</FONT>
-    <FONT FACE="Courier New">maxActive=&quot;20&quot;</FONT>
-    <FONT FACE="Courier New">maxIdle=&quot;3&quot;</FONT>
-    <FONT FACE="Courier New">removeAbandoned=&quot;true&quot;</FONT>
-    <FONT FACE="Courier New">maxWait=&quot;3000&quot; /&gt;</FONT>
-  <FONT FACE="Courier New">&lt;!-- If you want e-mail features, un-comment the section below --&gt;</FONT>
-  <FONT FACE="Courier New">&lt;!--</FONT>
-  <FONT FACE="Courier New">&lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot; type=&quot;javax.mail.Session&quot;</FONT>
-     <FONT FACE="Courier New">mail.smtp.host=&quot;mailhost.example.com&quot; /&gt;</FONT>
-  <FONT FACE="Courier New">--&gt;</FONT>
-<FONT FACE="Courier New">&lt;/Context&gt;</FONT></PRE><P>
+<P CLASS="western" STYLE="margin-bottom: 0in; page-break-before: always">
+<B>Example context configuration file for Tomcat 5.5.X users</B></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">The
+portions shown in bold are the ones that you'll probably have to
+change. Make sure you set the docBase to point to your Roller
+installation directory. Make sure you set the JDBC connection string
+to point to your database and the database username and password too.</P>
+<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+</P>
+<PRE><FONT FACE="Courier New"><FONT SIZE=3>&lt;Context path=&quot;/roller&quot; docBase=&quot;<B><FONT SIZE=2 STYLE="font-size: 11pt">/usr/local/apache-roller-3.0-incubating/webapp/roller</FONT></B>&quot; debug=&quot;0&quot;&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>&lt;Resource name=&quot;jdbc/rollerdb&quot; auth=&quot;Container&quot; </FONT></FONT>
+      <FONT FACE="Courier New"><FONT SIZE=3>type=&quot;javax.sql.DataSource&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>driverClassName=&quot;com.mysql.jdbc.Driver&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>url=&quot;<B>jdbc:mysql://localhost:3306/roller?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=utf-8&amp;amp;mysqlEncoding=utf8</B>&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>username=&quot;<B>scott</B>&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>password=&quot;<B>tiger</B>&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>maxActive=&quot;20&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>maxIdle=&quot;3&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>removeAbandoned=&quot;true&quot;</FONT></FONT>
+    <FONT FACE="Courier New"><FONT SIZE=3>maxWait=&quot;3000&quot; /&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>&lt;!-- If you want e-mail features, un-comment the section below --&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>&lt;!--</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>&lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot; </FONT></FONT>
+     <FONT FACE="Courier New"><FONT SIZE=3>type=&quot;javax.mail.Session&quot;</FONT></FONT>
+     <FONT FACE="Courier New"><FONT SIZE=3>mail.smtp.host=&quot;mailhost.example.com&quot; /&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>--&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=3>&lt;/Context&gt;</FONT></FONT></PRE><P CLASS="western">
 <B>NOTES</B></P>
 <UL>
-	<LI><P>If Roller starts up fine but later fails and you find an
-	error like the one below in your roller.log file then try dropping
-	your <FONT FACE="Courier New">maxActive</FONT>, <FONT FACE="Courier New">maxIdle</FONT>,
-	and <FONT FACE="Courier New">removeAbandoned</FONT> values.
-	Depending on your database configuration you may have to go pretty
-	low, such as setting <FONT FACE="Courier New">maxActive</FONT> to 6,
-	<FONT FACE="Courier New">maxIdle</FONT> to 3 and
+	<LI><P CLASS="western">If Roller starts up fine but later fails and
+	you find an error like the one below in your roller.log file then
+	try dropping your <FONT FACE="Courier New">maxActive</FONT>,
+	<FONT FACE="Courier New">maxIdle</FONT>, and <FONT FACE="Courier New">removeAbandoned</FONT>
+	values. Depending on your database configuration you may have to go
+	pretty low, such as setting <FONT FACE="Courier New">maxActive</FONT>
+	to 6, <FONT FACE="Courier New">maxIdle</FONT> to 3 and
 	<FONT FACE="Courier New">removeAbandonedTimeout</FONT> to 60. 
 	</P>
 </UL>
-<P STYLE="font-style: normal"><FONT FACE="Courier New"><FONT SIZE=2>	User
+<P CLASS="western" STYLE="font-style: normal"><FONT FACE="Courier New"><FONT SIZE=2>	User
 scott@localhost has more than 'max_user_connections' active
 connections</FONT></FONT></P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP6ConfigureYourApplicationServerForUTF86"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP6ConfigureYourApplicationServerForUTF86"></A>
 STEP 6: Check your internationalization settings</H2>
-<P STYLE="margin-bottom: 0in">Roller's approach to
+<P CLASS="western" STYLE="margin-bottom: 0in">Roller's approach to
 internationalization (I18N) is to do everything in UTF-8. So, if you
 want I18N to work properly, you'll need to configure your application
 server and your web server to use UTF-8 encoding. 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><B>Check your application server's URI
-encoding setting!</B></P>
-<P STYLE="margin-bottom: 0in"><BR>Make sure that your web application
-server uses UTF-8 to encode URI's. This allows you to use diacritical
-characters like '&ccedil;' in your URLs. This is important for Roller
-because weblog entry titles are used in URLs. 
-</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in">For example, in Tomcat the URI encoding
-is specified in the connectors that are configured in the Tomcat
-configuration file <FONT FACE="Courier New">conf/server.xml</FONT>.
+<H4 CLASS="western">Check your application server's URI encoding
+setting!</H4>
+<P CLASS="western" STYLE="margin-bottom: 0in">Make sure that your web
+application server uses UTF-8 to encode URI's. This allows you to use
+diacritical characters like '&ccedil;' in your URLs. This is
+important for Roller because weblog entry titles are used in URLs. 
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in">For example, in Tomcat
+the URI encoding is specified in the connectors that are configured
+in the Tomcat configuration file <FONT FACE="Courier New">conf/server.xml</FONT>.
 Here's a connector with the URI encoding attribute set properly:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">    <FONT FACE="Courier New">&lt;Connector
+<P CLASS="western" STYLE="margin-bottom: 0in">    <FONT FACE="Courier New">&lt;Connector
 port=&quot;8080&quot;</FONT></P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">maxThreads=&quot;150&quot;
-</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">maxThreads=&quot;150&quot; </FONT>
 </P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">minSpareThreads=&quot;25&quot;
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">minSpareThreads=&quot;25&quot;
 maxSpareThreads=&quot;75&quot;</FONT></P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">enableLookups=&quot;false&quot;
-</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">enableLookups=&quot;false&quot; </FONT>
 </P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">redirectPort=&quot;8443&quot;
-</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">redirectPort=&quot;8443&quot; </FONT>
 </P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">acceptCount=&quot;100&quot;</FONT></P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">debug=&quot;0&quot;
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">acceptCount=&quot;100&quot;</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">debug=&quot;0&quot;
 </FONT>
 </P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">connectionTimeout=&quot;20000&quot;</FONT></P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New">disableUploadTimeout=&quot;true&quot;
-</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">connectionTimeout=&quot;20000&quot;</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New">disableUploadTimeout=&quot;true&quot; </FONT>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in">       
+<FONT FACE="Courier New"><B>URIEncoding=&quot;UTF-8&quot; </B> /&gt;</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">        <FONT FACE="Courier New"><B>URIEncoding=&quot;UTF-8&quot;
-</B> /&gt;</FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><SPAN STYLE="font-weight: medium">And
+<P CLASS="western" STYLE="margin-bottom: 0in"><SPAN STYLE="font-weight: medium">And
 make sure you do this for <I>every</I> connector through which you
 use Roller. For example, if you use the AJP connector or HTTPS
 connector you need to add the </SPAN><TT><SPAN STYLE="font-weight: medium">URIEncoding=&quot;UTF-8&quot;</SPAN></TT><SPAN STYLE="font-weight: medium">
 attribute to those connectors as well.</SPAN></P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P><BR><BR>
+<P CLASS="western"><BR><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP7SetupRollerDataDirectories7"></A><A NAME="ref-InstallationGuide_2.x-7"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP7SetupRollerDataDirectories7"></A><A NAME="ref-InstallationGuide_2.x-7"></A>
 STEP 7: Setup Roller data directories 
 </H2>
-<P>Roller stores file uploads, search index files, cache files and
-log files on disk. So before you start, check to make sure the
-directories that Roller expects exist and are writable by the Tomcat
-process. 
-</P>
-<H3>STEP 7.1: Create <TT>uploads</TT> directory</H3>
-<P STYLE="margin-bottom: 0in">By default, Roller saves uploaded files
-under the directory:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western">Roller stores file uploads, search index files,
+cache files and log files on disk. So before you start, check to make
+sure the directories that Roller expects exist and are writable by
+the Tomcat process. 
+</P>
+<H3 CLASS="western">STEP 7.1: Create <TT>uploads</TT> directory</H3>
+<P CLASS="western" STYLE="margin-bottom: 0in">By default, Roller
+saves uploaded files under the directory:</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><TT><FONT FACE="Courier New">	${user.home}/roller_data/uploads</FONT></TT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><TT><FONT FACE="Courier New">	${user.home}/roller_data/uploads</FONT></TT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">Here <TT><FONT FACE="Courier New">${user.home}</FONT>
-</TT>is the Java system property that normally evaluates to the home
+<P CLASS="western" STYLE="margin-bottom: 0in">Where <TT><FONT FACE="Courier New">${user.home}</FONT></TT>is
+the Java system property that normally evaluates to the home
 directory of the user identity executing the server's JVM process. 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">In most cases, this default will
-probably work fine for you. However, for security reasons some
-application servers are set up to run as a server user identity whose
-home directory does not exist or is not writable by the server user
-itself. If this is the case for your server, override the property
-<TT><FONT FACE="Courier New">uploads.dir</FONT></TT> in the
-<FONT FACE="Courier New">roller.properties</FONT> file. See step 8
-for more information on the <FONT FACE="Courier New">roller.properties</FONT>
+<P CLASS="western" STYLE="margin-bottom: 0in">In most cases, this
+default will probably work fine for you. However, for security
+reasons some application servers are set up to run as a server user
+identity whose home directory does not exist or is not writable by
+the server user itself. If this is the case for your server, override
+the property <TT><FONT FACE="Courier New">uploads.dir</FONT></TT> in
+the <FONT FACE="Courier New">roller.properties</FONT> file. See step
+8 for more information on the <FONT FACE="Courier New">roller.properties</FONT>
 file.</P>
-<H3>STEP 7.2: Create <TT>search-index</TT> directory</H3>
-<P>By default, Roller creates and maintains its text search index
-data in files under the directory</P>
-<P><TT><FONT FACE="Courier New">	${user.home}/roller_data/roller-index</FONT></TT>
+<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>
-<P>Again, <TT><FONT FACE="Courier New">${user.home}</FONT> </TT>is
-the Java system property that normally evaluates to the home
+<P CLASS="western">Again, <TT><FONT FACE="Courier New">${user.home}</FONT>
+</TT>is the Java system property that normally evaluates to the home
 directory of the user identity executing the server's JVM process.
 You can specify a different directory by overriding the property
 <TT><FONT FACE="Courier New">search.index.dir</FONT> </TT>in
-<FONT FACE="Courier New">roller.properties</FONT><FONT FACE="Thorndale">.
-See step 8 for more information on the </FONT><FONT FACE="Courier New">roller.properties</FONT><FONT FACE="Thorndale">
-file.</FONT></P>
-<H3>STEP 7.3: Create <TT>planet-cache</TT> directory (optional)</H3>
-<P>You only need to do this if you are planning on using Roller's
-integrated planet aggregator: create a directory for the planet cache
-(e.g. /var/roller/planet-cache). 
-</P>
-<P>The planet aggregator is off by default. To enable it, you'll have
-to override the <TT>planet.aggregator.enabled</TT> property (see the
-<A HREF="http://www.rollerweblogger.org/wiki/Wiki.jsp?page=ConfigurationGuide">ConfigurationGuide</A>).
-Once you've got Roller up and running, login (as an adminstrator), go
-to the Planet:Configuration page and set full-path to the directory
-you choose for the planet-cache. 
-</P>
-<P>Currently, you must specify the location of the planet-cache
-directory through the Roller web UI (but we planning to move it to
-roller.properties because it is really a startup property). 
-</P>
-<H3></H3>
-<H3 STYLE="page-break-before: always">STEP 7.4: Make sure that the
-<TT>logs</TT> subdirectory exists</H3>
-<P STYLE="margin-bottom: 0in">The <TT><FONT FACE="Courier New">roller.log</FONT>
+<FONT FACE="Courier New">roller.properties</FONT><FONT FACE="Thorndale">.</FONT>
+See step 8 for more information on the Roller configuration override
+file.</P>
+<H3 CLASS="western">STEP 7.3: Create <TT>planet-cache</TT> directory
+(optional)</H3>
+<P CLASS="western">You only need to do this if you are planning on
+using Roller's integrated planet aggregator: create a directory for
+the planet cache (e.g. <FONT FACE="Courier New">/var/roller/planet-cache</FONT>).
+<SPAN STYLE="font-weight: medium"><FONT SIZE=2><FONT FACE="Courier New">
+</FONT></FONT></SPAN>See the Roller User Guide for more information
+on configuring Roller's built-in aggregator.</P>
+<H3 CLASS="western">STEP 7.4: Make sure that the <TT>logs</TT>
+subdirectory exists</H3>
+<P CLASS="western" STYLE="margin-bottom: 0in">The <TT><FONT FACE="Courier New">roller.log</FONT>
 </TT>file is written to the location:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><TT><FONT FACE="Courier New">	${catalina.base}/logs/roller.log</FONT></TT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><TT><FONT FACE="Courier New">	${catalina.base}/logs/roller.log</FONT></TT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">Make sure that that this directory
-exists. Tomcat 5.0.X users will normally have this directory by
-default. Tomcat 5.5.x users may need to create this subdirectory
-under their base directory. 
+<P CLASS="western" STYLE="margin-bottom: 0in">Make sure that that
+this directory exists. Tomcat 5.0.X users will normally have this
+directory by default. Tomcat 5.5.x users may need to create this
+subdirectory under their base directory. 
 </P>
-<P><BR><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP8ReviewRollerConfiguration8"></A>
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP8ReviewRollerConfiguration8"></A>
 STEP 8: Review Roller configuration</H2>
-<P>Before you start Roller for the first time, review your
-configuration.</P>
-<H3>STEP 8.1: Review the <FONT FACE="Courier New">WEB-INF/classes/roller.properties</FONT>
+<P CLASS="western">Before you start Roller for the first time, review
+your configuration.</P>
+<H3 CLASS="western">STEP 8.1: Review the
+<FONT FACE="Courier New">WEB-INF/classes/roller.properties</FONT>
 file</H3>
-<P>Roller tries to pick a good set of configuration defaults which
-should let anyone start up the application without much work, but
-here are a few properties which are custom to each install and should
-be set before you start up Roller. We'll first talk about what ways
-there are for defining your custom Roller configuration, then show
-which properties we think you should set.  <B>NOTE</B>: the default
-<FONT FACE="Courier New">roller.properties</FONT> file is shown in
-Appendix B.</P>
-<H4><A NAME="section-ConfigurationGuide_2.x-WhereToDefineCustomProperties"></A>
+<P CLASS="western">Roller tries to pick a good set of configuration
+defaults which should let anyone start up the application without
+much work, but here are a few properties which are custom to each
+install and should be set before you start up Roller. We'll first
+talk about what ways there are for defining your custom Roller
+configuration, then show which properties we think you should set. 
+<B>NOTE</B>: the default <FONT FACE="Courier New">roller.properties</FONT>
+file is shown in Appendix B.</P>
+<H4 CLASS="western"><A NAME="section-ConfigurationGuide_2.x-WhereToDefineCustomProperties"></A>
 Where to define custom properties</H4>
-<P STYLE="margin-bottom: 0in">There are three ways you can alter the
-default configuration for Roller. 
+<P CLASS="western" STYLE="margin-bottom: 0in">There are three ways
+you can alter the default configuration for Roller. 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><B>1)</B> Define a
+<P CLASS="western" STYLE="margin-bottom: 0in"><B>1)</B> Define a
 <FONT FACE="Courier New">roller-custom.properties</FONT> file and
 place it somewhere at the root of one of your classpath locations.
 This is the recommended way to override Roller configuration
 properties. For example:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	$TOMCAT_HOME/common/classes/roller-custom.properties</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in">Or...</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	$TOMCAT_HOME/webapps/$ROLLER_WEBAPP/WEB-INF/classes/roller-custom.properties</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><B>2) </B>Specify a custom properties
-file via JVM option. This is another good option but is more
-dependant on what servlet container you use. For example:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	$TOMCAT_HOME/common/classes/roller-custom.properties</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	#
+<P CLASS="western" STYLE="margin-bottom: 0in"><B>2) </B>Specify a
+custom properties file via JVM option. This is another good option
+but is more dependant on what servlet container you use. For example:</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	#
 this is how you might do it for tomcat</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	JAVA_OPTS=&quot;-Droller.custom.config=/path/to/properties/file&quot;</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	export
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	JAVA_OPTS=&quot;-Droller.custom.config=/path/to/properties/file&quot;</FONT></FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=3>	export
 $JAVA_OPTS</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	$TOMCAT_HOME/bin/startup.sh</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><B>3) </B>If you like, you can open up
-the default roller config file and change the values there. This
-option should not be necessary and is <B>NOT</B> recommended. For
-example:</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	$TOMCAT_HOME/webapps/$ROLLER_WEBAPP/WEB-INF/classes/roller.properties</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><A NAME="section-ConfigurationGuide_2.x-WhatPropertiesYouShouldSet"></A>
-<B>What properties you should set</B></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in">We are going to assume you have defined
-a <FONT FACE="Courier New">roller-custom.properties</FONT> file and
-placed it in your classpath somewhere. To override any of the default
-Roller properties you simply add a line with the proper key and the
-new value you wish to use. 
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT SIZE=3><FONT FACE="Courier New">	$TOMCAT_HOME/bin/startup.sh</FONT></FONT></P>
+<H4 CLASS="western"><A NAME="section-ConfigurationGuide_2.x-WhatPropertiesYouShouldSet"></A>
+<B>What properties you should set</B></H4>
+<P CLASS="western" STYLE="margin-bottom: 0in">We are going to assume
+you have defined a <FONT FACE="Courier New">roller-custom.properties</FONT>
+file and placed it in your classpath somewhere. To override any of
+the default Roller properties you simply add a line with the proper
+key and the new value you wish to use. 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">Here is a sample
+<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>
-<P STYLE="margin-bottom: 0in"> 
+<P CLASS="western" STYLE="margin-bottom: 0in"> 
 </P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	uploads.dir=/app/roller/roller_data/uploads</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	search.index.dir=/app/roller/roller_data/search-index</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New"><FONT SIZE=2>	#
+<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"><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 STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<H3 STYLE="page-break-before: always">STEP 8.2: Change keys in the
-<FONT FACE="Courier New">WEB-INF/security.xml</FONT> file</H3>
-<P>Starting with version 2.1, Roller uses the Acegi security
-infrastructure. Several of the security features rely on keys that
-are intended to be site-specific. These keys are used to compute HMAC
-(hash-based message authentication code) values for <I>Remember Me</I>
-cookies. Knowledge of these keys could allow an attacker to forge
-invalid cookies, and thereby gain unauthorized access to your Roller
-installation (at the application level). 
-</P>
-<P>Roller ships with default values, and these should assumed to be
-widely known. You should change your keys to be secret values
-specific to your own site. 
+<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>
+<P CLASS="western">Starting with version 2.1, Roller uses the Acegi
+security infrastructure. Several of the security features rely on
+keys that are intended to be site-specific. These keys are used to
+compute HMAC (hash-based message authentication code) values for
+<I>Remember Me</I> cookies. Knowledge of these keys could allow an
+attacker to forge invalid cookies, and thereby gain unauthorized
+access to your Roller installation (at the application level). 
+</P>
+<P CLASS="western">Roller ships with default values, and these should
+assumed to be widely known. You should change your keys to be secret
+values specific to your own site. 
 </P>
-<P>Here is how to change the keys. 
+<P CLASS="western">Here is how to change the keys. 
 </P>
 <OL>
-	<LI><P STYLE="margin-bottom: 0in">Find your <TT><FONT FACE="Courier New">WEB-INF/security.xml</FONT></TT>
-	file and open it in a text editor.</P>
-	<LI><P STYLE="margin-bottom: 0in">For the beans with ids
-	&quot;anonymousAuthenticationProvider&quot; and
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">Find your
+	<TT><FONT FACE="Courier New">WEB-INF/security.xml</FONT></TT> file
+	and open it in a text editor.</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">For the beans with
+	ids &quot;anonymousAuthenticationProvider&quot; and
 	&quot;anonymousProcessingFilter&quot; change the <TT>value</TT>
 	field of the property with <TT>name=&quot;key&quot;</TT> to be
 	different from the default value of &quot;anonymous&quot;. You can
 	use any string value of your choosing. It should be a secret
 	specific to your site. Use the same key value in these two beans;
 	they must match.</P>
-	<LI><P>For the beans with ids &quot;rememberMeServices&quot; and
-	&quot;rememberMeAuthenticationProvider&quot; change the <TT>value</TT>
+	<LI><P CLASS="western">For the beans with ids &quot;rememberMeServices&quot;
+	and &quot;rememberMeAuthenticationProvider&quot; change the <TT>value</TT>
 	field of the property with <TT>name=&quot;key&quot;</TT> to be
 	different from the default value of &quot;rollerlovesacegi&quot;.
 	You can use any string value of your choosing. It should be a secret
@@ -762,989 +795,1172 @@
 	they must match 
 	</P>
 </OL>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><B>NOTES</B> 
+<P CLASS="western" STYLE="margin-bottom: 0in"><B>NOTES</B> 
 </P>
 <UL>
 	<UL>
-		<LI><P STYLE="margin-bottom: 0in">The reason one should change the
-		anonymous provider key is that a granted authorities list is
-		embedded within the anonymous authentication token.</P>
+		<LI><P CLASS="western" STYLE="margin-bottom: 0in">The reason one
+		should change the anonymous provider key is that a granted
+		authorities list is embedded within the anonymous authentication
+		token.</P>
 	</UL>
 </UL>
-<H2 STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP9StartTomcatAndRoller9"></A>
-STEP 9: Start Tomcat and start using Roller</H2>
-<P STYLE="margin-bottom: 0in">Start your Servlet Container, open your
-web browser, browse to the Roller start page and start using Roller.
-If you are installing Roller on Tomcat then your Roller start page
-URL is probably <FONT FACE="Courier New">http://localhost:8080/roller</FONT>.</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><B>UNIX example</B></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	% cd
-$CATALINA_HOME/bin</FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	%
-./startup.sh</FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<H3 CLASS="western"><SPAN STYLE="background: transparent">STEP 8.3:
+Verify the database dialet setting in the Hibernate configuration
+file</SPAN></H3>
+<P CLASS="western"><SPAN STYLE="background: transparent">If you're
+using MySQL 4.X for Roller, then you can skip this step.</SPAN></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">If you're
+using some other database with Roller, then you must check the
+Hibernate dialect setting in the file
+<FONT FACE="Courier New">WEB-INF/classes/hibernate.cfg.xml</FONT>. 
+In that file, you'll see the section of code shown below. The line
+shown in bold is the current dialect setting. If you want to switch
+to another database, move the MySQLDialect line inside the<FONT FACE="Courier New">
+&lt;!-- --&gt;</FONT> comments and replace it with the line for your
+database of choice. </SPAN>
+</P>
+<P CLASS="western"><BR><BR>
+</P>
+<PRE><FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;!-- select SQL dialect, MySQL 3.X or 4.X by default --&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt"><B>&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.MySQLDialect&lt;/property&gt;</B></FONT></FONT>
+
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;!--</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">If you want to use HSQLDB, PostgreSQL, DB2 or Derby, Oracle, SQLServer then use the right dialect   </FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.HQLDBDialect&lt;/property&gt; </FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.PostgreSQLDialect&lt;/property&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.DB2Dialect&lt;/property&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.DerbyDialect&lt;/property&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.Oracle9Dialect&lt;/property&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.SQLServerDialect&lt;/property&gt;</FONT></FONT>
+
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">For MySQL 5.X, use the MySQL5 dialect and J/Connector 3.1.X</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;property name=&quot;dialect&quot;&gt;org.hibernate.dialect.MySQL5Dialect&lt;/property&gt;</FONT></FONT>
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">--&gt;</FONT></FONT></PRE><P CLASS="western" STYLE="margin-bottom: 0in">
+<BR>
 </P>
-<P STYLE="margin-bottom: 0in"><B>Windows example</B></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	C&gt; cd
-%CATALINA_HOME%\bin</FONT></P>
-<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	C&gt; startup</FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><B>NOTE</B>:<SPAN STYLE="font-weight: medium">
-the first user you create will have administrator privileges, so make
-sure you create the first user yourself. An admin user can grant and
-revoke admin rights from other users. </SPAN>
-</P>
-<P STYLE="margin-bottom: 0in; font-weight: medium"><BR>
-</P>
-<P STYLE="margin-bottom: 0in; font-weight: medium"><B>NOTE</B>: if
-you'd like to use Roller's JSPWiki plugin, which allows you to enter
-blog entries using JSPWiki syntax, then you'll have to download and
-install separately the JSPWiki jars. See Appendix C for more
-information.</P>
-<P><BR><BR>
-</P>
-<P><B>You're done! </B>
-</P>
-<P>Roller should be working perfectly now. If not, then please
-consult the Installation FAQ page on the Roller wiki and then check
-with the experts on the Roller mailing lists. Somebody has probably
-encountered the very same problems that you are encountering. 
-</P>
-<P><BR><BR>
-</P>
-<H2 STYLE="page-break-before: always">Appendix A: Upgrading an
-existing Roller installation</H2>
-<P>This document describes how to upgrade an existing installation to
-the latest release of Roller by upgrading the Roller database and
-replacing the old Roller files (which are typically found in
-<FONT FACE="Courier New">tomcat/webapps/roller</FONT>) with the new
-release. 
+<H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-InstallationGuide_2.x-STEP9StartTomcatAndRoller9"></A>
+STEP 9: Start Tomcat and start using Roller</H2>
+<P CLASS="western" STYLE="margin-bottom: 0in">Start your Servlet
+Container, open your web browser, browse to the Roller start page and
+start using Roller. 
+</P>
+<H4 CLASS="western"><B>UNIX example</B></H4>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	%
+cd $CATALINA_HOME/bin</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	%
+./startup.sh</FONT></P>
+<H4 CLASS="western"><B>Windows example</B></H4>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	C&gt;
+cd %CATALINA_HOME%\bin</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	C&gt;
+startup</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in">If you installed 
+Roller on Tomcat then your Roller start page URL is probably:</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><FONT FACE="Courier New">	http://localhost:8080/roller</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
+</P>
+<P CLASS="western" STYLE="margin-bottom: 0in">When Roller starts up,
+it will display a startup page that gives you instructions on how to
+complete the installation by creating a Roller user account, creating
+a weblog and designating the front-page weblog for the site. Follow
+those instructions and . . . 
+</P>
+<H4 CLASS="western">You're done! 
+</H4>
+<P CLASS="western">Roller should be working perfectly now. If not,
+then please consult the Installation FAQ page on the Roller wiki and
+then check with the experts on the Roller mailing lists. Somebody has
+probably encountered the very same problems that you are
+encountering. 
+</P>
+<P CLASS="western"><BR><BR>
+</P>
+<H2 CLASS="western" STYLE="page-break-before: always">Appendix A:
+Upgrading an existing Roller installation</H2>
+<P CLASS="western">This document describes how to upgrade an existing
+installation to the latest release of Roller by upgrading the Roller
+database and replacing the old Roller files (which are typically
+found in <FONT FACE="Courier New">tomcat/webapps/roller</FONT>) with
+the new release. 
 </P>
-<P>The steps are:</P>
+<P CLASS="western">The steps are:</P>
 <UL>
-	<LI><P STYLE="margin-bottom: 0in">STEP 1: Shutdown and backup your
-	old Roller</P>
-	<LI><P STYLE="margin-bottom: 0in">STEP 2: Install the new Roller</P>
-	<LI><P STYLE="margin-bottom: 0in">STEP 3: Copy old configuration</P>
-	<LI><P STYLE="margin-bottom: 0in">STEP 4: Upgrade the database</P>
-	<LI><P STYLE="margin-bottom: 0in">STEP 5: Startup Tomcat 
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">STEP 1: Shutdown
+	and backup your old Roller</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">STEP 2: Install
+	the new Roller</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">STEP 3: Copy old
+	configuration</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">STEP 4: Upgrade
+	the database</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in">STEP 5: Startup
+	Tomcat 
 	</P>
 </UL>
-<H3><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller1"></A><A NAME="ref-UpgradeGuide_2.1-1"></A>
-STEP 1: Shutdown and backup your old Roller 
+<H3 CLASS="western"><SPAN STYLE="background: transparent">An
+important note about Roller 3.0</SPAN></H3>
+<P CLASS="western"><SPAN STYLE="background: transparent">Roller 3.0
+is a major release and makes some big changes to the way that Roller
+works. If you're upgrading you need to be aware of the new URL
+structure and the new template system.</SPAN></P>
+<P CLASS="western"><I><B><SPAN STYLE="background: transparent">The
+new URL structure</SPAN></B></I></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">The most
+significant change is the new URL structure &ndash; we've completely
+change all of the Roller weblog URLs. We continue to support old
+Roller URLs, but they are redirected (using HTTP 301) redirects to
+the new system. That ensures that nobody will get a 404 when
+accessing your weblog using an old URL, but you'll still want to
+encourage people to change links that point to your weblog's old URL,
+which was of the format:</SPAN></P>
+<P CLASS="western"><FONT FACE="Courier New"><SPAN STYLE="background: transparent">	http://&lt;hostname&gt;/roller/page/&lt;weblog-handle&gt;</SPAN></FONT></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">To use the
+new format, which is:</SPAN></P>
+<P CLASS="western"><FONT FACE="Courier New"><SPAN STYLE="background: transparent">	http://&lt;hostname&gt;/roller/&lt;weblog-handle&gt;</SPAN></FONT></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">Unfortunately,
+some custom templates that use relative URLs will have problem with
+this new URL structure. So, before you go live you should set-up a
+test server and allow your users to take a look at their weblogs.</SPAN></P>
+<P CLASS="western"><I><B><SPAN STYLE="background: transparent">The
+new template system</SPAN></B></I></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">We've
+developed a completely new and greatly improved template system for
+Roller, which includes new models and new macros. We want to
+encourage people to start using this new system for all new template
+and theme development, so we have made it the default. And, by
+default, we've turned off the old system. </SPAN>
+</P>
+<P CLASS="western"><SPAN STYLE="background: transparent">So, if you
+are upgrading and you want your weblogs to work, you MUST override
+this Roller property to enable the old &ldquo;legacy&rdquo; template
+system to work:</SPAN></P>
+<P CLASS="western"><FONT FACE="Courier New"><SPAN STYLE="background: transparent">	rendering.legacyModels.enabled=true</SPAN></FONT></P>
+<P CLASS="western"><SPAN STYLE="background: transparent">See section
+8 for information on overriding Roller startup properties.</SPAN></P>
+<H3 CLASS="western"><A NAME="DDE_LINK2"></A><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller1"></A><A NAME="ref-UpgradeGuide_2.1-1"></A>
+UPGRADE STEP 1: Shutdown and backup your old Roller 
 </H3>
-<P>Before you get started with your upgrade, you should shutdown your
-existing Roller install, make a backup of your data, and move the old
-Roller files out of the way. Here is an example of how you'd do this
-with a Tomcat/MySQL setup: 
+<P CLASS="western">Before you get started with your upgrade, you
+should shutdown your existing Roller install, make a backup of your
+data, and move the old Roller files out of the way. Here is an
+example of how you'd do this with a Tomcat/MySQL setup: 
 </P>
-<P STYLE="margin-bottom: 0in">Run shutdown.sh to stop Tomcat, for
-example: 
+<P CLASS="western" STYLE="margin-bottom: 0in">Run shutdown.sh to stop
+Tomcat, for example: 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">   <FONT FACE="Courier New"><FONT SIZE=3>%
+<P CLASS="western" STYLE="margin-bottom: 0in">   <FONT FACE="Courier New"><FONT SIZE=3>%
 cd $CATALINA_HOME/bin</FONT></FONT></P>
-<PRE STYLE="margin-bottom: 0.2in">   <FONT FACE="Courier New"><FONT SIZE=3>% ./shutdown.sh</FONT></FONT></PRE><P STYLE="margin-bottom: 0in">
+<PRE STYLE="margin-bottom: 0.2in">   <FONT FACE="Courier New"><FONT SIZE=3>% ./shutdown.sh</FONT></FONT></PRE><P CLASS="western" STYLE="margin-bottom: 0in">
 Backup your database to somewhere safe on your system or to a remote
 file-system, for example if you use MySQL you might do something like
 this:</P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">   <FONT FACE="Courier New">% mysqldump
--u scott -p rollerdb &gt; \</FONT></P>
-<P STYLE="margin-bottom: 0in">  
+<P CLASS="western" STYLE="margin-bottom: 0in">   <FONT FACE="Courier New">%
+mysqldump -u scott -p rollerdb &gt; \</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in">  
 <FONT FACE="Courier New">/somewhere/safe/roller-backup-20050420.dmp</FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">Here's an example for PostgreSQL users:
+<P CLASS="western" STYLE="margin-bottom: 0in">Here's an example for
+PostgreSQL users: 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">   <FONT FACE="Courier New">pg_dump -h
-127.0.0.1 -W -U scott rollerdb &gt; roller.db</FONT></P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in">   <FONT FACE="Courier New">pg_dump
+-h 127.0.0.1 -W -U scott rollerdb &gt; roller.db</FONT></P>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
-<P STYLE="margin-bottom: 0in">Move your Roller files to somewhere
-safe, for example: 
+<P CLASS="western" STYLE="margin-bottom: 0in">Move your Roller files
+to somewhere safe, for example: 
 </P>
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
 <PRE>   <FONT FACE="Courier New"><FONT SIZE=3>% cd $CATALINA_HOME/webapps</FONT></FONT>
    <FONT FACE="Courier New"><FONT SIZE=3>% mkdir /somewhere/safe/roller-old</FONT></FONT>

[... 1457 lines stripped ...]


Mime
View raw message