roller-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From snoopd...@apache.org
Subject svn commit: r513798 - in /incubator/roller/trunk/docs/installguide: generated/roller-install-guide.html generated/roller-install-guide.pdf generated/roller-install-guide.txt roller-install-guide.odt
Date Fri, 02 Mar 2007 15:02:37 GMT
Author: snoopdave
Date: Fri Mar  2 07:02:36 2007
New Revision: 513798

URL: http://svn.apache.org/viewvc?view=rev&rev=513798
Log:
Same doc changes that were applied to 3.1: dialect setup fix, upgrade correcitons, removed
incubator wording

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/generated/roller-install-guide.txt
    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=513798&r1=513797&r2=513798
==============================================================================
--- incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html (original)
+++ incubator/roller/trunk/docs/installguide/generated/roller-install-guide.html Fri Mar 
2 07:02:36 2007
@@ -7,7 +7,7 @@
 	<META NAME="AUTHOR" CONTENT="Dave Johnson">
 	<META NAME="CREATED" CONTENT="20060123;11164600">
 	<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
-	<META NAME="CHANGED" CONTENT="20070226;10243900">
+	<META NAME="CHANGED" CONTENT="20070302;9530400">
 	<STYLE>
 	<!--
 		@page { size: 8.5in 11in; margin: 0.5in }
@@ -44,9 +44,6 @@
 </P>
 <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size:
32pt"><B>Apache
 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=7 STYLE="font-size: 32pt"><B>Version 3.2</B></FONT></P>
 <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
@@ -312,10 +309,10 @@
 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>
+<FONT FACE="Courier New"><FONT SIZE=3>	% tar xzvf ~/apache-roller-3.2.tar.gz</FONT></FONT>
 </PRE><P CLASS="western">
 That would create the Roller installation directory
-<FONT FACE="Courier New">/usr/local/apache-roller-3.0-incubating</FONT>.
+<FONT FACE="Courier New">/usr/local/apache-roller-3.2</FONT>. 
 </P>
 <H4 CLASS="western">Windows example</H4>
 <P CLASS="western">You can Use WinZip to extract the Roller
@@ -341,10 +338,10 @@
 <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>
+/usr/local/apache-roller-3.2/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>
+c:\apache-roller-3.2/webapp/roller</FONT></P>
 <P CLASS="western"><A NAME="DDE_LINK3"></A><BR><BR>
 </P>
 <H2 CLASS="western"></H2>
@@ -524,7 +521,7 @@
 <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; </FONT></FONT>
-  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">docBase=&quot;<B>/usr/local/apache-roller-incubating-3.1/webapp/roller</B>&quot;
debug=&quot;0&quot;&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">docBase=&quot;<B>/usr/local/apache-roller-3.2/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>
@@ -558,7 +555,7 @@
       <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 SIZE=2 STYLE="font-size: 11pt"><FONT FACE="Courier New">&lt;/Context&gt;</FONT></FONT></PRE><P
CLASS="western" STYLE="margin-bottom: 0in; page-break-before: always">
+<FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">&lt;/Context&gt;</FONT></FONT></PRE><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>
@@ -570,7 +567,7 @@
 <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;
</FONT></FONT>
-  <FONT FACE="Courier New"><FONT SIZE=3>docBase=&quot;<B><FONT SIZE=2
STYLE="font-size: 11pt">/usr/local/apache-roller-<FONT SIZE=2 STYLE="font-size: 11pt">incubating-</FONT>3.1/webapp/roller</FONT></B>&quot;
debug=&quot;0&quot;&gt;</FONT></FONT>
+  <FONT FACE="Courier New"><FONT SIZE=3>docBase=&quot;<B><FONT SIZE=2
STYLE="font-size: 11pt">/usr/local/apache-roller-3.2/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>
@@ -765,10 +762,9 @@
 <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>
-Don't edit roller.properties directly! Create an override file
-instead</H4>
-<P CLASS="western" STYLE="margin-bottom: 0in">There are two ways you
-can alter the default configuration for Roller. 
+Where to define custom properties</H4>
+<P CLASS="western" STYLE="margin-bottom: 0in">There are three ways
+you can alter the default configuration for Roller. 
 </P>
 <P CLASS="western" STYLE="margin-bottom: 0in"><BR>
 </P>
@@ -874,29 +870,37 @@
 	</UL>
 </UL>
 <H3 CLASS="western"><SPAN STYLE="background: transparent">STEP 8.3:
-Verify the database dialect setting in the Hibernate configuration
+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 override the
-Hibernate dialect. In your roller-custom.properties override file,
-override the <SPAN STYLE="font-weight: medium"><FONT SIZE=2><FONT FACE="Courier
New">hibernate.dialect</FONT></FONT><FONT SIZE=3><FONT FACE="Times
New Roman, serif">
-property. For example, to set the dialect for MySQL 5, you would add
-this to your override file:</FONT></FONT></SPAN></SPAN></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><SPAN STYLE="background:
transparent">
-  <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">hibernate.dialect=org.hibernate.dialect.MySQL5Dialect</SPAN></FONT></FONT></P>
-<P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
+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>
-<P CLASS="western" STYLE="font-weight: medium"><FONT FACE="Courier New"><FONT
SIZE=2><SPAN STYLE="background: transparent"><FONT SIZE=3><FONT FACE="Times
New Roman, serif">Here
-are all of the available dialect settings:</FONT></FONT></SPAN></FONT></FONT></P>
-<PRE>   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.HQLDBDialect</FONT></FONT>
-   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.PostgreSQLDialect</FONT></FONT>
-   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.DB2Dialect</FONT></FONT>
-   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.DerbyDialect</FONT></FONT>
-   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.Oracle9Dialect</FONT></FONT>
-   <FONT FACE="Courier New"><FONT SIZE=2 STYLE="font-size: 11pt">org.hibernate.dialect.SQLServerDialect</FONT></FONT>
-</PRE><P CLASS="western" STYLE="margin-bottom: 0in">
+<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 CLASS="western" STYLE="margin-bottom: 0in"><BR>
@@ -963,7 +967,7 @@
 	</P>
 </UL>
 <H3 CLASS="western"><SPAN STYLE="background: transparent">Important
-notes for those upgrading from Roller 2.x to Roller 3.1</SPAN></H3>
+notes for those upgrading from Roller 2.x to Roller 3.2</SPAN></H3>
 <P CLASS="western"><SPAN STYLE="background: transparent"><B>WARNING!</B>
 Roller 3.0 was a major release and made some big changes to the way
 that Roller works. If you're upgrading from the 2.x series you need
@@ -1069,7 +1073,7 @@
 <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>
    <FONT FACE="Courier New"><FONT SIZE=3>% mv roller /somewhere/safe/roller-old</FONT></FONT></PRE><H3
CLASS="western">
-<A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller11"></A><A
NAME="section-UpgradeGuide_2.1-STEP2InstallTheNewRoller2"></A><A NAME="ref-UpgradeGuide_2.1-2"></A>
+<A NAME="section-UpgradeGuide_2.1-STEP2InstallTheNewRoller2"></A><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller11"></A><A
NAME="ref-UpgradeGuide_2.1-2"></A>
 UPGRADE STEP 2: Install the new Roller 
 </H3>
 <P CLASS="western">Follow the normal installation instructions to
@@ -1084,7 +1088,7 @@
 	the installation, we'll do that later 
 	</P>
 </UL>
-<H3 CLASS="western"><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller12"></A><A
NAME="section-UpgradeGuide_2.1-STEP3CopyResourcesAndUpdateConfigs3"></A><A NAME="ref-UpgradeGuide_2.1-3"></A>
+<H3 CLASS="western"><A NAME="section-UpgradeGuide_2.1-STEP3CopyResourcesAndUpdateConfigs3"></A><A
NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller12"></A><A NAME="ref-UpgradeGuide_2.1-3"></A>
 UPGRADE STEP 3: Copy resources and update configs 
 </H3>
 <H4 CLASS="western"><A NAME="section-UpgradeGuide_2.1-3.1CopyYourOldResourcesAndOtherFilesYouveAdded"></A>
@@ -1106,19 +1110,21 @@
 </P>
 <H4 CLASS="western"><A NAME="section-UpgradeGuide_2.1-3.3ReviewConfigurationProperties"></A>
 3.3 Review configuration properties</H4>
-<P CLASS="western"><A NAME="DDE_LINK5"></A>Review properties as
-described in Section 8.0 of the installation guide. 
-</P>
+<P CLASS="western">Review properties as described in STEP #8 of the
+installation guide.</P>
 <UL>
-	<LI><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
-	NOTE: Make sure you set the right Hibernate dialect for your
-	database in your roller-custom.properties file as discussed in
-	Section 8.3.</P>
+	<LI><P CLASS="western" STYLE="margin-bottom: 0in"><SPAN STYLE="font-weight:
medium">NOTE:
+	In Roller 3.1 we changed the scheduled task properties, so if you
+	were overriding  the<FONT FACE="Courier New, monospace"> tasks.daily</FONT>
+	or <FONT FACE="Courier New, monospace">tasks.hourly</FONT>
+	properties you need to change your roller-custom.properties file.
+	Refer to the notes in roller.properties in the section &ldquo;Scheduled
+	Background Tasks&rdquo; for details.</SPAN></P>
 </UL>
 <P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium"><BR>
 </P>
 <UL>
-	<LI><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
+	<LI VALUE=1><P CLASS="western" STYLE="margin-bottom: 0in; font-weight: medium">
 	NOTE: In Roller 2.3 we changed the Roller package names from
 	org.roller to org.apache.roller. Because of this you MUST review
 	your roller-custom.properties file, search for the string
@@ -1135,7 +1141,7 @@
 	visit the Roller Support project on Java.Net
 	(http://roller.dev.java.net).</P>
 </UL>
-<H3 CLASS="western"><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller13"></A><A
NAME="section-UpgradeGuide_2.1-STEP4UpgradeTheDatabase4"></A><A NAME="ref-UpgradeGuide_2.1-4"></A>
+<H3 CLASS="western"><A NAME="section-UpgradeGuide_2.1-STEP4UpgradeTheDatabase4"></A><A
NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller13"></A><A NAME="ref-UpgradeGuide_2.1-4"></A>
 UPGRADE STEP 4: Upgrade the database 
 </H3>
 <P CLASS="western">Use the appropriate database upgrade script to
@@ -1182,7 +1188,8 @@
 <P CLASS="western">If you're upgrading from an earlier release you'll
 have to run each of the older scripts in order to upgrade your
 database.</P>
-<H3 CLASS="western"><A NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller14"></A><A
NAME="section-UpgradeGuide_2.1-STEP5StartupTomcat5"></A><A NAME="ref-UpgradeGuide_2.1-5"></A>
+<H3 CLASS="western"></H3>
+<H3 CLASS="western" STYLE="page-break-before: always"><A NAME="section-UpgradeGuide_2.1-STEP5StartupTomcat5"></A><A
NAME="section-UpgradeGuide_2.1-STEP1ShutdownAndBackupYourOldRoller14"></A><A NAME="ref-UpgradeGuide_2.1-5"></A>
 UPGRADE STEP 5: Startup your app server 
 </H3>
 <P CLASS="western">Use the standard Tomcat <FONT FACE="Courier New">startup.sh</FONT>
@@ -1191,6 +1198,9 @@
 to upgrade your database, this may take few seconds longer than your
 average Roller startup. 
 </P>
+<P CLASS="western"><B>NOTE</B>: before you startup Tomcat, you should
+remove contents of the Tomcat work directory, a temporary, it may
+contain old classes from your previous Roller installation directory.</P>
 <H4 CLASS="western">And you're done! 
 </H4>
 <P CLASS="western">If Roller doesn't come up, check the logs for

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=513798&r1=513797&r2=513798
==============================================================================
Binary files - no diff available.

Modified: incubator/roller/trunk/docs/installguide/generated/roller-install-guide.txt
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/generated/roller-install-guide.txt?view=diff&rev=513798&r1=513797&r2=513798
==============================================================================
--- incubator/roller/trunk/docs/installguide/generated/roller-install-guide.txt (original)
+++ incubator/roller/trunk/docs/installguide/generated/roller-install-guide.txt Fri Mar  2
07:02:36 2007
@@ -6,7 +6,6 @@
 
 
 Apache Roller
- (incubating) 
 Version 3.2
 
 
@@ -126,9 +125,9 @@
 UNIX example
 Assuming you download the distribution into your home directory and you'd like to install
Roller into /usr/local you might do something like this in the bash shell:
 	% cd /usr/local
-	% tar xzvf ~/apache-roller-3.0-incubating.tar.gz
+	% tar xzvf ~/apache-roller-3.2.tar.gz
 
-That would create the Roller installation directory /usr/local/apache-roller-3.0-incubating.

+That would create the Roller installation directory /usr/local/apache-roller-3.2. 
 Windows example
 You can Use WinZip to extract the Roller distribution file into the directory of your choice.

 Roller distribution layout
@@ -142,15 +141,15 @@
 The ROLLER environment variable
 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 have to
set the ROLLER environment variable, we just use it to simplify the installation guide, but
here's how you'd do it.
 UNIX example (assuming you installed into /usr/local):
-	% set $ROLLER = /usr/local/apache-roller-3.0-incubating/webapp/roller
+	% set $ROLLER = /usr/local/apache-roller-3.2/webapp/roller
 Windows example (assuming you installed into c:\)
-	% set %ROLLER% = c:\apache-roller-3.0-incubating/webapp/roller
+	% set %ROLLER% = c:\apache-roller-3.2/webapp/roller
 
 
 STEP 3: Install required third party jars
 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.
 STEP 3.1: Download and install Hibernate
-Roller requires the Hibernate persistence library, which you must download separately from
Roller. 
+Roller requires Hibernate Version 3.1.2, which you must download separately from Roller.

 	Download Hibernate 3.1.2 from SourceForge
 	http://prdownloads.sourceforge.net/hibernate/hibernate-3.1.2.tar.gz
 Copy the following files from Hibernate into the Roller WEB-INF/lib directory:
@@ -194,7 +193,6 @@
 WEB-INF/dbscripts/derby/creatdb.sql
 WEB-INF/dbscripts/db2/creatdb.sql
 WEB-INF/dbscripts/oracle/creatdb.sql
-WEB-INF/dbscripts/oracle/creatdb.sql
 Here are some examples to show you how you might create the Roller tables in MySQL:
 UNIX example
 	% cd $ROLLER/WEB-INF/dbscripts/mysql
@@ -221,16 +219,18 @@
 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):
 		mysql roller -h 127.0.0.1 -u scott -ptiger
 STEP 5: Deploy Roller to your application server
-To deploy Roller to your application server you need to inform your application server:
-Where to find the Roller installation directory  
-How to configure the Roller datasource under the JNDI name jdbc/rollerdb 
+To deploy Roller you will need to inform your application server:
+Where to find the Roller installation directory
+How to configure the Roller database data-source under the JNDI name jdbc/rollerdb 
+How to configure the Roller email session under the JNDI name mail/Session
 For Tomcat you can do this by creating what's known as a context configuration file named
roller.xml and placing that file in the Tomcat conf/Catalina/localhost directory. 
 
 Example context configuration file for Tomcat 5.0.X users
 
 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.
 
-<Context path="/roller" docBase="/usr/local/apache-roller-3.0-incubating/webapp/roller"
debug="0">
+<Context path="/roller" 
+  docBase="/usr/local/apache-roller-3.2/webapp/roller" debug="0">
   <Resource name="jdbc/rollerdb" auth="Container" type="javax.sql.DataSource" />
   <ResourceParams name="jdbc/rollerdb">
     <parameter>
@@ -265,12 +265,12 @@
   </ResourceParams>
   -->
 </Context>
-
 Example context configuration file for Tomcat 5.5.X users
 
 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.
 
-<Context path="/roller" docBase="/usr/local/apache-roller-3.0-incubating/webapp/roller"
debug="0">
+<Context path="/roller" 
+  docBase="/usr/local/apache-roller-3.2/webapp/roller" debug="0">
   <Resource name="jdbc/rollerdb" auth="Container" 
       type="javax.sql.DataSource"
     driverClassName="com.mysql.jdbc.Driver"
@@ -288,8 +288,10 @@
      mail.smtp.host="mailhost.example.com" />
   -->
 </Context>
+
 NOTES
-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 maxActive, maxIdle, and removeAbandoned values. Depending
on your database configuration you may have to go pretty low, such as setting maxActive to
6, maxIdle to 3 and removeAbandonedTimeout to 60. 
+Email configuration. If you want to use email notification of comments, group blogging invitations
and other events, you'll have  to enable that in your application server. For Tomcat, you
can do that by uncommenting the indicated sections of the context configuration file above.
No matter what application server you use, you'll also have to uncomment the mail/Session
resource reference <resource-ref> near the end of the roller/WEB-INF/web.xml file.
+The max_user_connections error. 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 maxActive, maxIdle,
and removeAbandoned values. Depending on your database configuration you may have to go pretty
low, such as setting maxActive to 6, maxIdle to 3 and removeAbandonedTimeout to 60. 
 	User scott@localhost has more than 'max_user_connections' active connections
 
 
@@ -422,8 +424,8 @@
 STEP 3: Copy old configuration
 STEP 4: Upgrade the database
 STEP 5: Startup Tomcat 
-Important notes about Roller 3.0
-WARNING! 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.
+Important notes for those upgrading from Roller 2.x to Roller 3.2
+WARNING! Roller 3.0 was a major release and made some big changes to the way that Roller
works. If you're upgrading from the 2.x series you need to be aware of the new URL structure
and the new template system.
 The new URL structure
 The most significant change is the new URL structure - 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:
 	http://<hostname>/roller/page/<weblog-handle>
@@ -474,9 +476,11 @@
 
 3.3 Review configuration properties
 Review properties as described in STEP #8 of the installation guide.
-WARNING: In Roller 2.3 we changed the Roller package names from org.roller to org.apache.roller.
Because of this you MUST review your roller-custom.properties file, search for the string
"org.roller"and replace all occurances of it with "org.apache.roller".
+NOTE: In Roller 3.1 we changed the scheduled task properties, so if you were overriding 
the tasks.daily or tasks.hourly properties you need to change your roller-custom.properties
file. Refer to the notes in roller.properties in the section "Scheduled Background Tasks"
for details.
 
-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 (http://roller.dev.java.net).
+NOTE: In Roller 2.3 we changed the Roller package names from org.roller to org.apache.roller.
Because of this you MUST review your roller-custom.properties file, search for the string
"org.roller"and replace all occurances of it with "org.apache.roller".
+
+NOTE: 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 (http://roller.dev.java.net).
 UPGRADE STEP 4: Upgrade the database 
 Use the appropriate database upgrade script to upgrade your database. To do this, login to
your database and run one (or more) of the Roller upgrade scripts located in Roller's WEB-INF/dbscripts
directory that corresponds to your database. There's a directory for MySQL, PostgreSQL, HSQLDB
and more. 
 The database script directories 
@@ -495,8 +499,10 @@
     mysql> quit
 
 If you're upgrading from an earlier release you'll have to run each of the older scripts
in order to upgrade your database.
+
 UPGRADE STEP 5: Startup your app server 
 Use the standard Tomcat startup.sh (or startup.bat on Windows) script to start Tomcat. As
Roller starts up, it will perform some final steps to upgrade your database, this may take
few seconds longer than your average Roller startup. 
+NOTE: before you startup Tomcat, you should remove contents of the Tomcat work directory,
a temporary, it may contain old classes from your previous Roller installation directory.
 And you're done! 
 If Roller doesn't come up, check the logs for exceptions and error messages. You should see
these messages in the tomcat/logs/catalina.out file and in tomcat/logs/roller.log. If you
still can't diagnose and fix your startup program, then subscribe to the Roller user mailing
list for help. If there are any interesting messages in the log files, send those along too.

 Appendix B: The WEB-INF/roller.properties file

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=513798&r1=513797&r2=513798
==============================================================================
Binary files - no diff available.



Mime
View raw message