You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@roller.apache.org by sn...@apache.org on 2005/10/21 23:46:28 UTC
svn commit: r327589 [4/72] - in /incubator/roller/branches/roller_1.x: ./
contrib/ contrib/lib/ contrib/plugins/ contrib/plugins/src/
contrib/plugins/src/org/ contrib/plugins/src/org/roller/
contrib/plugins/src/org/roller/presentation/ contrib/plugins/...
Added: incubator/roller/branches/roller_1.x/docs/images/velocity-logo.gif
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/images/velocity-logo.gif?rev=327589&view=auto
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/branches/roller_1.x/docs/images/velocity-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/branches/roller_1.x/docs/installguide/installguide.wiki
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/installguide/installguide.wiki?rev=327589&view=auto
==============================================================================
--- incubator/roller/branches/roller_1.x/docs/installguide/installguide.wiki (added)
+++ incubator/roller/branches/roller_1.x/docs/installguide/installguide.wiki Fri Oct 21 14:27:36 2005
@@ -0,0 +1,350 @@
+!!!The Roller Weblogger Installation Guide v0.9.7
+See also: UserGuide
+
+Orignal text is ''Copyright © 2002 David M Johnson''
+
+* Introduction
+** STEP 1: Prerequisites[1]
+** STEP 2: Unpack the downloaded ZIP or TAR file[2]
+** STEP 3: Create Roller tables in your database[3]
+** STEP 4: Download and install JDBC driver[4]
+** STEP 5: Configure Roller's Servlet Context[5]
+** STEP 6: Configure Roller before start-up[6]
+** STEP 7: Start Tomcat and Roller[7]
+* Appendix A: Building and deploying Roller from Source[8]
+* Appendix B: Changes for deploying Roller on Resin[9]
+
+
+
+\\
+\\
+!!!Introduction
+
+This document describes how to install the [Roller Weblogger|http://www.rollerweblogger.org] on the Tomcat Servlet Engine and assumes the following configuration.
+
+* Java 1.4.X SDK
+* Tomcat 4.X.Y Servlet Container
+* A MySQL 3.2.X, Postgres, or HSQL database
+* Windows XP or Redhat 7.X Linux
+
+If you have more recent versions of the above software, don't worry, Roller will probably work fine. If you have older versions of the above software, you may have problems. Roller will not work on Tomcat 3.X or versions of Java prior to 1.4.0. Older versions of Windows/Linux and MySQL may work fine for Roller.
+
+You should be able to make Roller work on any Servlet API 2.3 compatible Servlet Container (e.g. Resin, OrionServer, WebSphere, WebLogic, ...) and any JDBC-accessible database (e.g. Oracle, Informix, ...), but this document does not tell you how specifically to do that.
+
+
+
+\\
+\\
+!!!Overview
+
+Here is an overview of the steps involved in a Roller installation:
+
+#[1]__Prerequisites__. Before you get to Roller, make sure your Java SDK, Tomcat, and MySQL are correcly installed on your system.
+#[2]__Unpack the downloaded ZIP or TAR file__. In this step, you unpack the ZIP or TAR file that downloaded into your Servlet Container's web application deployment directory.
+#[3]__Create Roller tables in your database__. In this step you use an SQL script to create within your database the tables required to run Roller.
+#[4]__Configure Roller's Servlet Context__. Edit the Tomcat configuration file to add a Servlet Context to do Servlet Authentication against the Roller database, and configure a connection pooling datasouce for access via JNDI.
+#[5]__Make JDBC driver available to Tomcat__. To support Servlet Authentication that you configured in step 4, you must place your JDBC driver jar(s) in Tomcat's common/lib directory.
+#[6]__Configure Roller before start-up__. Review the Roller configuration settings in Roller's web.xml before you start Roller.
+#[7]__Start your Servlet Container and your database__. Start your Servlet Container, open your web browser, browse to the Roller start page and start using Roller.
+
+
+
+\\
+\\
+!!!STEP 1: Prerequisites [#1]
+
+Before you install the Roller software you need to make sure you have installed your Java SDK, your Tomcat Servlet Engine, and your MySQL database installed and configured on your system.
+
+As part of the Tomcat install, you should have set an environment variable called CATALINA_HOME as show in the example below. I'm telling you this now because later, in other examples in this guide we will refer to the CATALINA_HOME variable.
+
+ UNIX (csh) example
+
+ {{{
+ % setenv CATALINA_HOME /opt/jakarta-tomcat-4.1.24
+ }}}
+
+ Windows example, from an MS-DOS or Command Prompt window:
+
+ {{{
+ C> set CATALINA_HOME d:\jakarta-tomcat-4.1.24
+ }}}
+
+
+
+
+\\
+\\
+!!!STEP 2: Unpack the downloaded ZIP or TAR file [#2]
+
+In this step, you unpack the ZIP or TAR file that downloaded into your Servlet Container's web application deployment directory. Tomcat's deployment directory is located in the webapps directory of the Tomcat install directory.
+
+ UNIX example
+
+ {{{
+ % cp roller.tgz $CATALINA_HOME/webapps
+ % cd $CATALINA_HOME/webapps
+ % tar xzvf roller.tgz
+ }}}
+
+ On Windows: Use WinZIP to extract roller.zip into %CATALINA_HOME%\webapps
+
+__NOTE:__ Currenty, Roller cannot be installed as a WAR file because Roller needs to write to a file in the Roller web application directory (WEB-INF/roller-config.xml). At some point in the future this will be fixed.
+
+
+
+
+\\
+\\
+!!!STEP 3: Create Roller tables in your database [#3]
+
+Now you need to create a new database, create a user with appropriate privileges, and use an SQL script to create the database tables required to run Roller. To do this, login to your database and run one of the Roller database creation scripts located in Roller's WEB-INF directory:
+
+ createdb-mysql.sql - creates tables for MySQL
+ createdb-hsql.sql - creates tables for HSQL-DB
+ createdb-postgres.sql - creates tables for Postgres
+
+The examples below show you how you might do this using MySQL, assuming your Roller user will have username roller and password tiger. For more information on MySQL, refer to the MySQL Reference Manual.
+
+ UNIX example
+
+ {{{
+ % cd $CATALINA_HOME/webapps/roller/WEB-INF
+ % mysql -u root -p
+ password: *****
+ mysql> create database roller;
+ mysql> grant all on roller.* to roller identified by 'tiger';
+ mysql> use roller;
+ mysql> source createdb-mysql.sql
+ mysql> quit
+ }}}
+
+ Windows example, from an MS-DOS or Command Prompt window:
+
+ {{{
+ C> cd %CATALINA_HOME%\webapps\roller\WEB-INF
+ C> mysql -u root -p
+ password: *****
+ mysql> create database roller;
+ mysql> grant all on roller.* to roller identified by 'tiger';
+ mysql> use roller;
+ mysql> source createdb-mysql.sql
+ mysql> quit
+ }}}
+
+__NOTES:__
+
+If you are upgrading from Roller 0.9.6 you can upgrade your database using one of the 096-to-097-micrgration.sql scripts. This is a risky operation so you should backup your database before you run the migration script.
+
+
+
+
+\\
+\\
+!!!STEP 4: Download and install JDBC driver [#4]
+
+To support Servlet Authentication that you configured in step 4, you must place your JDBC driver jar(s) in Tomcat's common/lib directory. You can find the MySQL JDBC driver, known as __Connector/J__, on the [Connector/J page of the MySQL web site|http://www.mysql.com/products/connector-j/index.html]. Download the connector, unzip the files, and copy the JDBC driver jar to the Tomcat common/lib directory.
+
+UNIX example: unzip and untar the MySQL Connector/J download into a directory, cd to that directory and then copy to Tomcat common/lib
+
+ {{{
+ % cp mysql-connector-java-3.0.7-stable-bin.jar $CATALINA_HOME/common/lib
+ }}}
+
+Windows example, from an MS-DOS or Command Prompt window: unzip the MySQL Connector/J download into a directory, cd to that directory and then copy to Tomcat common/lib
+
+ {{{
+ C> copy mysql-connector-java-3.0.7-stable-bin.jar %CATALINA_HOME%\common\lib
+ }}}
+
+NOTE: Due to a [known bug|http://www.rollerweblogger.org/page/roller/20030525#heads_up_mysql_connector_j] in Connector/J v3.0.7, you should probably use one of the [v3.0 nightly builds|http://mmmysql.sourceforge.net/snapshots/stable/] instead of v3.0.7 - soon Connector/J v3.0.8 will appear and it will fix this problem.
+
+
+
+
+\\
+\\
+!!!STEP 5: Configure Roller's Servlet Context [#5]
+
+Edit the Tomcat Servlet engine's conf/server.xml configuration file to add a the Roller Servlet Context. This is where you configure the Servlet Authentication to use the Roller database tables and where you configure the Roller datasource. Look for the section of the server.xml file where Contexts are defined and assuming that you are using MySQL you should add the following. Make sure you replace roller/tiger with your MySQL username and password.
+
+{{{
+<Context path="/roller" docBase="roller" debug="0">
+
+<Realm className="org.apache.catalina.realm.JDBCRealm"
+ driverName="com.mysql.jdbc.Driver"
+ connectionURL=
+ "jdbc:mysql://mysql.kattare.com/roller?user=roller&password=tiger&autoReconnect=true"
+ userTable="rolleruser"
+ userNameCol="username"
+ userCredCol="password"
+ userRoleTable="role"
+ roleNameCol="role" debug="0" />
+
+<Resource name="jdbc/rollerdb" auth="Container" type="javax.sql.DataSource" />
+
+<ResourceParams name="jdbc/rollerdb">
+ <parameter>
+ <name>factory</name>
+ <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
+ </parameter>
+ <parameter>
+ <name>driverClassName</name>
+ <value>com.mysql.jdbc.Driver</value>
+ </parameter>
+ <parameter>
+ <name>url</name>
+ <value>jdbc:mysql://mysql.kattare.com/roller?user=roller&password=tiger&autoReconnect=true</value>
+ </parameter>
+ <parameter><name>maxActive</name> <value>100</value></parameter>
+ <parameter><name>maxIdle</name> <value>1000</value></parameter>
+ <parameter><name>maxWait</name> <value>100</value></parameter>
+ <parameter><name>logAbandoned</name> <value>true</value></parameter>
+</ResourceParams>
+
+</Context>
+}}}
+
+__NOTES:__
+
+* The first part of the __<Context>__ configuration above sets up an Authentication __<Realm>__ for Tomcat. This allows Tomcat to check a user's login credentials (username and password) against a table in the Roller database. Here, we configure Tomcat to use the __rolleruser__ and __role__ tables in the Roller database. For more information on configuring this see the Tomcat docs for [JDBC Realm|http://jakarta.apache.org/tomcat/tomcat-4.1-doc/realm-howto.html#JDBCRealm].
+
+* The second part of the __<Context>__ configuration sets up the Roller DataSource as a __<Resource>__. Here you'll have to repeat some of the connection parameters that you entered in the __<Realm>__ setup.
+
+* The '&' character is used to identify entity references in XML, so you'll have to change the '&user=roller&password=password' to '&amp;user=roller&amp;password=password' in the connectionURL to avoid parsing exceptions while starting Tomcat.
+
+* If you are not using MySQL or if you are using the newer MySQL Connector/J JDBC driver, then you will have to substitute the appropriate JDBC connection parameters (driver class name and connection URL) for your database.
+
+* For more information on Tomcat's server.xml configuration file, refer to the [Tomcat Configuration Reference|http://jakarta.apache.org/tomcat/tomcat-4.1-doc/config/index.html].
+
+
+
+
+\\
+\\
+!!!STEP 6: Configure Roller before start-up [#6]
+
+!!Specify the Administrative user
+
+Before you start Roller, you need to specify the username of the user (or users) who will be the adminstrator of the Roller site. This adminstrator will be the only one who can access the Admin and Config pages in the Roller Editor UI.
+
+Do this by editing the file roller/WEB-INF/roller-config.xml, an XML file. Look for the lines shown below and when you have found then, carefully change the string adminUser to the name of the username that you will use as your Roller administrator, or to a comma-sepatared list of users who will be your Roller administrators.
+
+ {{{
+ <adminUsers>
+ <adminUsers>adminUser</adminUsers>
+ </adminUsers>
+ }}}
+
+When you first start Roller, before doing anything else, create a new user with the name that you specified as the admin user.
+
+!!Tune the Page Cache settings
+
+Roller uses a technique called page caching to improve performance, reduce CPU usage, and reduce calls to the database. Page caching is implemented using an open source Java produce called OsCache. You can configure OsCache by editing the file roller/WEB-INF/classes/oscache.properties. For information on the settings in this file, please refer to the [OsCache website|http://www.opensymphony.com/oscache/]. The properties file that is included in Roller configures OsCache for memory caching with a maximum of 100 entries. If you have a high volume site, you may need to tune these settings, otherwise the defaults should be fine.
+
+If you'd like to use the Gzip filter and you are running Tomcat, you will need to use the alternate cache, CommonsPageCache. You can make this change by uncommenting the "handler" init-parameters for PageCache in the web.xml file (change the /metadata/xdoclet/web-settings.xml if you are compiling for yourself). Then you can uncomment the Gzip filters in web.xml (or in /metadata/xdoclet/filter-mappings.xml). If you are using Resin, see [Appendix B|9].
+
+!!Set up the Logging Options
+
+Roller uses the open source Java Log4J logging package for logging. By default, Roller will place it's log file (roller.log) in the directory from which you started Roller, this file will not grow larger than 1MB in size, and when it does Log4J will start a new log file. Log4J will save the most recent two log files and delete older ones. You can configure all of these things by editing the Log4J configuration file at roller/WEB-INF/classes/log4j.properties.
+
+For example, if you want to place the Roller log file in the /var/logs directory, you would edit the log4j.properties file and set the following property:
+
+ {{{
+ log4j.appender.R.File=/var/logs/roller.log
+ }}}
+
+
+
+
+\\
+\\
+!!!STEP 7: Start Tomcat and Roller [#7]
+
+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 [http://localhost:8080/roller].
+
+ UNIX example:
+
+ {{{
+ % cd $CATALINA_HOME/bin
+ % ./startup.sh}}}
+
+ Windows example, from an MS-DOS or Command Prompt window:
+
+ {{{
+ C> cd %CATALINA_HOME%\bin
+ C> startup
+ }}}
+
+You are done! Roller should be working perfectly now. If not, then please join consult with the experts on the [roller-user mailing list|http://sourceforge.net/mail/?group_id=47722]. Somebody has probably encountered the very same problems that you are encountering.
+
+
+
+
+\\
+\\
+!!!Appendix A: Building and deploying Roller from source [#8]
+
+Build and deploying Roller from source involves three simple steps: get the source, run the build script, follow the installation instructions above to deploy the results.
+
+!! Get the Roller source code
+
+If you want to build a stable released version of Roller then download the source files from SourceForge, both the source file and the tools file. The source file contains the source code for Roller. The tools file contains all of the 3rd party jars that are needed to build Roller.
+
+On the other hand, if you want to build the latest, greatest, bleeding-edge, and possibly unstable version of Roller then get the sources from the SourceForge CVS repository. Refer to Roller's [SourceForge CVS page|http://sourceforge.net/cvs/?group_id=47722] for further instructions.
+
+!! Do a build
+
+Once you have extracted the Roller source code into a directory on your system, then open up a command prompt and __cd__ to that directory. Build Roller by using either the UNIX or Windows version of the build script. This script sets up the right classpath and calls Roller's Ant build script __build.xml__.
+
+ On UNIX:
+
+ {{{
+ % build.sh all
+ }}}
+
+ On Windows:
+ {{{
+ C> build all
+ }}}
+
+This will build Roller and will stage the Roller web application into the __build/roller__ subdirectory.
+
+!! Deploy
+
+You can simply copy the build/roller to your tomcat/webapps directory and follow the installation instructions above (steps 3 through 7) to complete your deployment.
+
+If you have problems making a build then please join consult with the experts on the [roller-dev mailing list|http://sourceforge.net/mail/?group_id=47722]. Somebody has probably encountered the very same problems that you are encountering.
+
+
+
+
+\\
+\\
+!!! Appendix B: Deploying Roller on Resin [#9]
+
+!! resin.conf and roller.conf
+If you are already familiar with Resin's configuration files, you will know that you can split the configuration among more than one file. Copy the example config file found at /personal/roller.conf into your ${resin.base}/conf directory, and add the following line in resin.conf's <host> declaration:
+
+ <resin:include href='roller.conf'/>
+
+__Note:__ Unless you're really a wiz with resin's configuration file, you'll definintely want to check the source out of CVS and include the aforementioned /person/roller.conf.
+
+Modify the roller.conf file, setting the correct <app-dir> and <resource-ref> values.
+
+!! Resin and Roller and Gzip Compression
+An issue was found with Tomcat and the CompressionFilter used in Roller, so the Filter was commented out as the default. If you are using Resin, you can uncomment the filter-mappings for the CompressionFilter. If you are recompiling Roller, look in /metadata/xdoclet/filter-mappings.xml. If you want to modify the precompiled Roller, edit the /WEB-INF/web.xml directly.
+
+!! What version of Resin are you using?
+
+!Versions of Resin before 2.1.9
+Versions of Resin before 2.1.9 have a problem with ServletFilters and the HttpServletResponseWrapper. To get around this issue, you will need to recompile Roller after making a couple changes to the build.xml file.
+* Uncomment the "resinServer" property.
+* Uncomment the line that declares the "resin.path" property.
+* Inside the path declaration for base.path, uncomment the fileset for Resin, and correct the "dir" property as necessary (use relative pathing such as you see in the default setting).
+This will automatically perform all changes necessary to support Resin 2.1.8 and earlier.
+
+! Using Resin 2.1.9 (and later?)
+Because Resin 2.1.9 (and later) doesn't require the drastic changes above, the installation will miss one key strategic point: You will need to copy all XML related jars from Resin's /tools/lib directory, namely xercesImpl-2.3.0.jar and xmlParser-2.3.0.jar. Or just uncomment the "resinServer" property and run the stage-web Ant task.
+
+! One last thing
+The latest version of Resin (2.1.9 as of this writing) has a conflict with the usage of the Jakarta Standard JSTL library. Dave and Lance are currently in the process of straightening this out... For now you will need to remove or comment the line <%@ taglib uri="core-stl" prefix="c"%> from /theme/header.jsp. __Update:__ Build 2.1.snap, as of May 5 2003, corrects this problem so you won't need to worry if you are using a version of Resin built after May 5 2003.
Added: incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.5.html
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.5.html?rev=327589&view=auto
==============================================================================
--- incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.5.html (added)
+++ incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.5.html Fri Oct 21 14:27:36 2005
@@ -0,0 +1,493 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+
+ <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+ <title>Roller Installation Guide</title>
+
+
+ <meta name="GENERATOR" content="OpenOffice.org 641 (Win32)">
+
+ <meta name="AUTHOR" content="David Johnson">
+
+ <meta name="CREATED" content="20020227;22544700">
+
+ <meta name="CHANGEDBY" content="David Johnson">
+
+ <meta name="CHANGED" content="20020402;22274900">
+
+ <style>
+ <!--
+ @page { margin-left: 1.25in; margin-right: 1.25in; margin-top: 1in; margin-bottom: 1in }
+ P { margin-bottom: 0.08in }
+ P.western { font-family: "Thorndale", serif }
+ H1 { margin-bottom: 0.08in }
+ H1.western { font-family: "Albany", sans-serif; font-size: 16pt }
+ H1.cjk { font-family: "HG Mincho Light J"; font-size: 16pt; font-weight: bold }
+ H1.ctl { font-family: "Arial Unicode MS"; font-size: 16pt; font-weight: bold }
+ -->
+ </style>
+</head>
+<body lang="en-US">
+
+<h1 class="western">The Roller Weblogger</h1>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4">Version 0.9.5 Installation Guide</font></font></p>
+
+<p class="western"><i><font size="2">Copyright <font
+ face="Times New Roman, serif">©</font> 2002 David M Johnson</font></i><br>
+ Updated: August 31, 2002<br>
+ </p>
+
+<p class="western"><font size="2"><i><sdfield type="DATETIME"
+ sdval="37348.000005787" sdnum="1033;1033;MMMM D, YYYY"></sdfield></i></font></p>
+
+<h1 class="western">Introduction</h1>
+
+<p style="margin-bottom: 0in;">This document describes how to install the
+ Roller weblogger on the Tomcat Servlet Engine and assumes the following
+ configuration.</p>
+
+<ul>
+ <li>
+
+ <p style="margin-bottom: 0in;">Java 1.4 SDK</p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">Tomcat 4.0.4 Servlet Container</p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">A MySQL 3.2.3, Postgres, or HSQL database </p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">Windows XP or Redhat 7.2 Linux</p>
+ </li>
+
+</ul>
+
+<p style="margin-bottom: 0in;">If you have more recent versions of the above
+ software, don't worry Roller will probably work fine. If you have
+older versions of the above software, you may have problems. Roller
+will not work on Tomcat 3.X, but older versions of Java and MySQL may
+work fine for Roller. </p>
+
+<p style="margin-bottom: 0in;">You should be able to make Roller work on
+any Servlet API 2.3 compatible Servlet Container (e.g. Resin, Orion, WebSphere,
+ WebLogic, ...) and any JDBC-accessible database (e.g. Oracle, Informix,
+ ...), but this document does not tell you how to do that.<br>
+ <br>
+ </p>
+
+<h1 class="western">Overview</h1>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><b>1. Prerequisites. </b><span
+ style="">Before you get to Roller, make sure your Java SDK, Tomcat Servlet
+ Container, and MySQL database are correcly installed on your system.</span></p>
+
+ <ol>
+
+ </ol>
+
+ <p style="margin-bottom: 0in;"><b>2. Unpack the downloaded ZIP or TAR file.
+ </b><span style=""> In this step, you unpack the ZIP or TAR file that
+ downloaded into your Servlet Container's web application deployment directory.</span></p>
+
+ <p style="margin-bottom: 0in;"><b>3. Create Roller tables in your database.</b><span
+ style=""> In this step you use an SQL script to create within your database
+ the tables required to run Roller.</span></p>
+
+ <p style="margin-bottom: 0in;"><b>4. Configure Roller's Servlet Context.
+ </b><span style="">Edit the Tomcat configuration file to add a Servlet
+Context to do Servlet Authentication against the Roller database, and configure
+a connection pooling datasouce for access via JNDI.<br>
+ </span></p>
+
+ <p style="margin-bottom: 0in;"><span style=""></span><b>5. Make JDBC driver
+available to Tomcat. </b> To support Servlet Authentication that you configured
+in step 4, you must place your JDBC driver jar(s) in Tomcat's common/lib
+directory.</p>
+
+ <p style="margin-bottom: 0in;"><b>6. Configure Roller before start-up.</b>
+ Review the Roller configuration settings in Roller's web.xml before you
+start Roller.</p>
+
+ <p style="margin-bottom: 0in;"><b>7. Start your Servlet Container and
+your database. </b><span style="">Start your Servlet Container, open your
+web browser, browse to the Roller start page and start using Roller.<br>
+ <br>
+ </span></p>
+ </blockquote>
+
+<h1 class="western">Six steps to installing Roller</h1>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"> <b><font
+ face="Albany, sans-serif"><font size="4">STEP 1: Prerequisites</font></font></b></p>
+
+<p class="western" style="">You need to JDK 1.4, Tomcat 4.0.4, either a MySQL,
+Postgres or HSQL database; and either Windows NT/2000/XP or UNIX</p>
+
+<p class="western" style="">Make sure all these prerequisites are installed,
+ configured and ready to go before you begin the install</p>
+
+<p class="western" style="">As part of the Tomcat 4.0 install, you should
+ have set an environment variable called CATALINA_HOME</p>
+
+<blockquote>
+ <p class="western" style=""><font color="#0000ff">UNIX (csh) example</font></p>
+
+ <p class="western" style=""><font color="#0000ff"> <b><font size="2"><font
+ face="Courier New, monospace">setenv CATALINA_HOME /opt/jakarta-tomcat-4.0.4</font></font></b></font></p>
+
+ <p class="western" style=""><font color="#0000ff">Windows NT/2000/XP example</font></p>
+
+ <p class="western"><font color="#0000ff"><span style=""> </span><b><font
+ size="2"><font face="Courier New, monospace">set CATALINA_HOME d:\jakarta-tomcat-4.0.4
+ </font></font></b></font> </p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 2: Unpack the downloaded ZIP or TAR file</b></font></font></p>
+
+<p style="margin-bottom: 0in;">In this step, you unpack the ZIP or TAR file
+ that downloaded into your Servlet Container's web application deployment
+ directory. Tomcat's deployment directory is located in the <b><font
+ face="Courier, monospace">webapps</font></b> directory of the Tomcat install
+ directory. </p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"> <b><font size="2"><font
+ face="Courier New, monospace">% cp roller.tgz $CATALINA_HOME/webapps</font></font></b></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % cd $CATALINA_HOME/webapps</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % tar xzvf roller.tgz</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b>Use WinZIP to
+extract roller.zip into %CATALINA_HOME%\webapps</b></font></p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 3: Create Roller tables in your database</b></font></font></p>
+
+<p style="margin-bottom: 0in;">Now you need to create a new database, create
+a user with appropriate privileges, and use an SQL script to create the database
+tables required to run Roller. <br>
+</p>
+<p style="margin-bottom: 0in;">To do this, login to your database and run
+one of the Roller database creation scripts located in Roller's WEB-INF directory:<br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><b>createdb-mysql.sql</b> - creates tables
+for MySQL<br>
+ <b>createdb-hsql.sql</b> - creates tables for HSQL-DB<br>
+ <b>createdb-postgres.sql</b> - creates tables for Postgres<br>
+ </p>
+</blockquote>
+<p style="margin-bottom: 0in;">The examples below show you how you might
+do this using MySQL, assuming your Roller user will have username <i>roller
+ </i>and password <i>tiger. </i>For more information on MySQL, refer to
+the<a href="http://www.mysql.org/documentation/mysql/bychapter/"> MySQL Reference
+Manual</a>. <br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/webapps/roller/WEB-INF</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % mysql -u roller -p</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ password: *****</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> create database roller;<br>
+ mysql> grant all on roller.* to roller indentified by 'tiger';<br>
+ mysql> use roller;</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> source createdb-mysql.sql</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> quit</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">C> cd %CATALINA_HOME%\webapps\roller\WEB-INF</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ C> mysql -u roller -p</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ password: *****</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> create database roller;</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ </b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b>mysql> grant all on roller.*
+ to roller indentified by 'tiger';<br>
+ </b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b> mysql> use roller;</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> source createdb-mysql.sql</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> quit</b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-bottom: 0in;"><b>NOTES: </b><br>
+</p>
+<blockquote><i>If you are upgrading from Roller 0.9.4 you can upgrade your
+database using one of the 094-to-095-micrgration.sql scripts. This is a
+risky operation so you might want to backup your database before you run
+the migration script. The migration script will save the old Roller tables
+with names that start with "temp_" and you should not drop these backup tables
+until you are satisfied that your data base made it through the migration.</i><br>
+</blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><b> STEP 4: Configure Roller's
+Servlet Context</b> <span style=""> </span></font></font> </p>
+
+<p style="margin-bottom: 0in;"><span style="">Edit the Tomcat Servlet engine's
+ <b>conf/server.xml</b> configuration file to add a the Roller Servlet Context.
+ This is where you configure the Servlet Authentication to use the Roller
+ database tables and where you configure the Roller datasource. </span>
+Look for the section of the server.xml file where Contexts are defined and
+assuming that you are using MySQL you should add the following:<br>
+ </p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+<Context path="/roller" docBase="roller" debug="0"><br>
+ </font></b></font></small></p>
+
+<blockquote>
+ <p class="western"><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b> <!-- Config Servlet
+ Authentication to use Roller's USER and ROLE tables --><br>
+ <Realm className="org.apache.catalina.realm.JDBCRealm"
+ <br>
+ debug="0" driverName="<font color="#ff0000">org.gjt.mm.mysql.Driver</font>"<br>
+ connectionURL=<br>
+ "<font color="#ff0000">jdbc:mysql://localhost/roller?autoReconnect=true&amp;user=</font><font
+ color="#ff0000">roller&amp;password=</font><font color="#ff0000">tiger</font>"<br>
+ userTable="rolleruser" userNameCol="username" userCredCol="password"<br>
+ userRoleTable="role" roleNameCol="role" /></b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+ <!-- Config datasource to be bound to java:comp/env/jdbc/rollerdb</font></b></font></small>
+ --><br>
+ <small><font face="Courier New, Courier, monospace"><b><font
+ color="#3333ff"> <Resource name="jdbc/rollerdb" auth="Container"<br>
+ type="javax.sql.DataSource"/></font></b></font></small></p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+ <ResourceParams name="jdbc/rollerdb"><br>
+ <parameter><br>
+ <name>factory</name><br>
+ <value>org.apache.commons.dbcp.BasicDataSourceFactory</value><br>
+ </parameter><br>
+ <parameter><name>maxActive</name><value>20</value></parameter><br>
+ <parameter><name>maxIdle</name><value>30000</value></parameter><br>
+ <parameter><name>maxWait</name><value>100</value></parameter><br>
+ <parameter><name>username</name><value><font
+ color="#ff0000">roller</font></value></parameter><br>
+ <parameter><name>password</name><value><font
+ color="#ff0000">tiger</font></value></parameter><br>
+ <parameter><br>
+ <name>driverClassName</name><value><font
+ color="#ff0000">org.gjt.mm.mysql.Driver</font></value><br>
+ </parameter><br>
+ <parameter><br>
+ <name>url</name><value><font
+ color="#ff0000">jdbc:mysql://localhost/roller?autoReconnect=true</font></value><br>
+ </parameter><br>
+ </ResourceParams></font></b></font></small></p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+</Context></font></b></font></small><br>
+ </p>
+
+<p style="margin-bottom: 0in;">NOTES:<br>
+</p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><i>If you are not using MySQL, then you
+will have to substitute the appropriate JDBC connection parameters (driver
+class name and connection URL) for your database. <br>
+ </i> </p>
+
+ <p style="margin-bottom: 0in;"><i>For more information on Tomcat's server.xml
+configuration file, refer to the <a
+ href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/config/index.html">Tomcat
+Configuration Reference</a>.</i></p>
+</blockquote>
+
+<p style="margin-bottom: 0in;"></p>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+</font></font><font face="Albany, sans-serif"><font size="4"><b> STEP 5:
+Make JDBC driver available to Tomcat</b></font></font></p>
+<p style="margin-top: 0.17in; page-break-after: avoid;">To support Servlet
+Authentication that you configured in step 4, you must place your JDBC driver
+jar(s) in Tomcat's common/lib directory. The MySQL driver jar is include
+in the Roller distribution so for MySQL you might do this as follows:<br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/webapps/roller/WEB-INF/lib</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % cp mm.mysql-2.0.12.bin.jar $CATALINA_HOME/common/lib</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"><b> </b></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"> </p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">> cd %CATALINA_HOME%\webapps\roller\WEB-INF\lib</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ > copy mm.mysql-2.0.12.bin.jar %CATALINA_HOME%\common\lib</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"></p>
+ </blockquote>
+<h3><font face="Albany, sans-serif"><font size="4"><br>
+ STEP 6: Configure Roller before start-up</font></font></h3>
+<p style="margin-top: 0.17in; page-break-after: avoid;">The Roller web.xml
+file includes the following configuration parameters. If in doubt, don't
+change these values - the defaults are pretty reasonable.<br>
+</p>
+<blockquote>
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.rss.usePor</b><b>t</b>
+- true if the item URLs created in by the RSS feature should include the Servlet
+engine's port number. The default is <b>false</b>, but you might want to
+turn this on if you are running Tomcat behind an Apache web server.<br>
+ <br>
+ <b>org.roller.new.user.allow</b> - allow new users to be added to Roller.
+ Defaults to <b>true</b>.<br>
+ <br>
+ <b>org.roller.upload.enabled</b> - true to enable file upload. Defaults
+to true.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.maxFileMB</b>
+- maximum size in megabytes of file that users are allowed to upload. Defaults
+to <b>1</b>.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.maxDirMB</b>
+- maximum size in megabytes of each user's upload directory. Defaults to
+ <b>4</b>.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.allow</b>
+- comma separated list of file extensions allowed in upload directory. Defaults
+to <b>jpg,jpeg,gif,png</b>. Forbid and Allow are mutually exclusive so set
+only one of the two.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.forbid</b>
+- comma separated list of file extensions forbidden in the upload directory.
+ Defaults to nothing.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.dir</b>
+- directory where files are to be uploaded, may end with a slash. Defaults
+to empty string which indicates that files will be uploaded to the /resources
+directory in the Roller Servlet Context.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.path</b>
+- URL path to upload directory, should not end with a slash. Defaults to
+/resources which works well when the upload directory default.</p>
+</blockquote>
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 7: Start Tomcat and start using Roller</b></font></font></p>
+
+<p style="margin-bottom: 0in;">Start your Servlet Container, open your web
+ browser, browse to the Roller start page and start using Roller.</p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example, starting
+ Tomcat</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/bin</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % ./startup.sh</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"><b> </b></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example, starting
+ Tomcat</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">C> cd %CATALINA_HOME%\bin</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ C> startup</b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+ References</font></font></p>
+
+<ul>
+ <li><b>Velocity - <a href="http://jakarta.apache.org/velocity">http://jakarta.apache.org/velocity</a></b></li>
+ <li><b>Castor <a href="http://castor.exolab.org/">http://castor.exolab.org</a></b></li>
+ <li><b>Mysql <a href="http://mysql.com/">http://mysql.com</a></b></li>
+ <li><b>JDK 1.4 <a href="http://javasoft.com/">http://javasoft.com</a></b></li>
+ <li><b>Tomcat 4.0 <a href="http://jakarta.apache.org/tomcat">http://jakarta.apache.org/tomcat</a></b></li>
+ <li><b>Redhat Linux 7.2 <a href="http://redhat.com/">http://redhat.com</a></b></li>
+ <li><b>Windows XP <a href="http://microsoft.com/">http://microsoft.com</a></b></li>
+
+</ul>
+
+<p style="margin-bottom: 0in;"><br>
+ </p>
+
+<p style="margin-bottom: 0in;"><br>
+ </p>
+ <br>
+ <br>
+ <br>
+ <br>
+ <br>
+ <br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+</body>
+</html>
Added: incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.6.html
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.6.html?rev=327589&view=auto
==============================================================================
--- incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.6.html (added)
+++ incubator/roller/branches/roller_1.x/docs/installguide/old/roller-ig-0.9.6.html Fri Oct 21 14:27:36 2005
@@ -0,0 +1,686 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+
+ <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+ <title>Roller Installation Guide</title>
+
+
+ <meta name="GENERATOR" content="OpenOffice.org 641 (Win32)">
+
+ <meta name="AUTHOR" content="David Johnson">
+
+ <meta name="CREATED" content="20020227;22544700">
+
+ <meta name="CHANGEDBY" content="David Johnson">
+
+ <meta name="CHANGED" content="20020402;22274900">
+
+ <style>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <!--
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ @page { margin-left: 1.25in; margin-right: 1.25in; margin-top: 1in; margin-bottom: 1in }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ P { margin-bottom: 0.08in }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ P.western { font-family: "Thorndale", serif }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ H1 { margin-bottom: 0.08in }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ H1.western { font-family: "Albany", sans-serif; font-size: 16pt }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ H1.cjk { font-family: "HG Mincho Light J"; font-size: 16pt; font-weight: bold }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ H1.ctl { font-family: "Arial Unicode MS"; font-size: 16pt; font-weight: bold }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </style>
+</head>
+<body lang="en-US">
+
+<h1 class="western">The Roller Weblogger</h1>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4">Version 0.9.6 Installation Guide</font></font></p>
+
+<p class="western"><i><font size="2">Copyright <font
+ face="Times New Roman, serif">©</font> 2002 David M Johnson</font></i><br>
+ Updated: October 7, 2002<br>
+ </p>
+
+<p class="western"><font size="2"><i><sdfield type="DATETIME"
+ sdval="37348.000005787" sdnum="1033;1033;MMMM D, YYYY"></sdfield></i></font></p>
+
+<h1 class="western">Introduction</h1>
+
+<p style="margin-bottom: 0in;">This document describes how to install the
+ Roller weblogger on the Tomcat Servlet Engine and assumes the following
+ configuration.</p>
+
+<ul>
+ <li>
+
+ <p style="margin-bottom: 0in;">Java 1.4 SDK</p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">Tomcat 4.0.5 Servlet Container</p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">A MySQL 3.2.3, Postgres, or HSQL database
+ </p>
+ </li>
+ <li>
+
+ <p style="margin-bottom: 0in;">Windows XP or Redhat 7.2 Linux</p>
+ </li>
+
+</ul>
+
+<p style="margin-bottom: 0in;">If you have more recent versions of the above
+ software, don't worry Roller will probably work fine. If you have older
+ versions of the above software, you may have problems. Roller will not
+ work on Tomcat 3.X, but older versions of Java and MySQL may work fine
+for Roller. </p>
+
+<p style="margin-bottom: 0in;">You should be able to make Roller work on any
+Servlet API 2.3 compatible Servlet Container (e.g. Resin, Orion, WebSphere,
+ WebLogic, ...) and any JDBC-accessible database (e.g. Oracle, Informix,
+ ...), but this document does not tell you how to do that.<br>
+ <br>
+ </p>
+
+<h1 class="western">Overview</h1>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><b>1. Prerequisites. </b><span
+ style="">Before you get to Roller, make sure your Java SDK, Tomcat Servlet
+ Container, and MySQL database are correcly installed on your system.</span></p>
+
+ <ol>
+
+ </ol>
+
+ <p style="margin-bottom: 0in;"><b>2. Unpack the downloaded ZIP or TAR file.
+ </b><span style=""> In this step, you unpack the ZIP or TAR file that
+ downloaded into your Servlet Container's web application deployment directory.</span></p>
+
+ <p style="margin-bottom: 0in;"><b>3. Create Roller tables in your database.</b><span
+ style=""> In this step you use an SQL script to create within your database
+ the tables required to run Roller.</span></p>
+
+ <p style="margin-bottom: 0in;"><b>4. Configure Roller's Servlet Context.
+ </b><span style="">Edit the Tomcat configuration file to add a Servlet
+Context to do Servlet Authentication against the Roller database, and configure
+a connection pooling datasouce for access via JNDI.<br>
+ </span></p>
+
+ <p style="margin-bottom: 0in;"><span style=""></span><b>5. Make JDBC driver
+available to Tomcat. </b> To support Servlet Authentication that you configured
+in step 4, you must place your JDBC driver jar(s) in Tomcat's common/lib directory.</p>
+
+ <p style="margin-bottom: 0in;"><b>6. Configure Roller before start-up.</b>
+ Review the Roller configuration settings in Roller's web.xml before you start
+Roller.</p>
+
+ <p style="margin-bottom: 0in;"><b>7. Start your Servlet Container and
+your database. </b><span style="">Start your Servlet Container, open your
+web browser, browse to the Roller start page and start using Roller.<br>
+ <br>
+ </span></p>
+ </blockquote>
+
+<h1 class="western">Six steps to installing Roller</h1>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"> <b><font
+ face="Albany, sans-serif"><font size="4">STEP 1: Prerequisites</font></font></b></p>
+
+<p>You need to JDK 1.4, Tomcat 4.0.5, either a MySQL, Postgres or HSQL database;
+and either Windows NT/2000/XP or UNIX</p>
+
+<p>Make sure all these prerequisites are installed, configured and ready
+to go before you begin the install</p>
+
+<p>As part of the Tomcat 4.0 install, you should have set an environment
+variable called CATALINA_HOME</p>
+
+<blockquote>
+ <p class="western" style=""><font color="#0000ff">UNIX (csh) example</font></p>
+
+ <p class="western" style=""><font color="#0000ff"> <b><font size="2"><font
+ face="Courier New, monospace">setenv CATALINA_HOME /opt/jakarta-tomcat-4.0.5</font></font></b></font></p>
+
+ <p class="western" style=""><font color="#0000ff">Windows NT/2000/XP example</font></p>
+
+ <p class="western"><font color="#0000ff"><span style=""> </span><b><font
+ size="2"><font face="Courier New, monospace">set CATALINA_HOME d:\jakarta-tomcat-4.0.5
+ </font></font></b></font> </p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 2: Unpack the downloaded ZIP or TAR file</b></font></font></p>
+
+<p style="margin-bottom: 0in;">In this step, you unpack the ZIP or TAR file
+ that downloaded into your Servlet Container's web application deployment
+ directory. Tomcat's deployment directory is located in the <b><font
+ face="Courier, monospace">webapps</font></b> directory of the Tomcat install
+ directory. </p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"> <b><font size="2"><font
+ face="Courier New, monospace">% cp roller.tgz $CATALINA_HOME/webapps</font></font></b></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % cd $CATALINA_HOME/webapps</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % tar xzvf roller.tgz</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b>Use WinZIP to extract
+roller.zip into %CATALINA_HOME%\webapps</b></font></p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 3: Create Roller tables in your database</b></font></font></p>
+
+<p style="margin-bottom: 0in;">Now you need to create a new database, create
+a user with appropriate privileges, and use an SQL script to create the
+database tables required to run Roller. <br>
+</p>
+<p style="margin-bottom: 0in;">To do this, login to your database and run
+one of the Roller database creation scripts located in Roller's WEB-INF directory:<br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><b>createdb-mysql.sql</b> - creates tables
+for MySQL<br>
+ <b>createdb-hsql.sql</b> - creates tables for HSQL-DB<br>
+ <b>createdb-postgres.sql</b> - creates tables for Postgres<br>
+ </p>
+</blockquote>
+<p style="margin-bottom: 0in;">The examples below show you how you might
+do this using MySQL, assuming your Roller user will have username <i>roller
+ </i>and password <i>tiger. </i>For more information on MySQL, refer to the<a
+ href="http://www.mysql.org/documentation/mysql/bychapter/"> MySQL Reference
+Manual</a>. <br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/webapps/roller/WEB-INF</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % mysql -u roller -p</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ password: *****</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> create database roller;<br>
+ mysql> grant all on roller.* to roller identified by 'tiger';<br>
+ mysql> use roller;</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> source createdb-mysql.sql</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> quit</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">C> cd %CATALINA_HOME%\webapps\roller\WEB-INF</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ C> mysql -u roller -p</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ password: *****</b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b><br>
+ mysql> create database roller;</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ </b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b>mysql> grant all on roller.*
+ to roller identified by 'tiger';<br>
+ </b></font></font></font><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b> mysql> use roller;</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> source createdb-mysql.sql</b></font></font></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ mysql> quit</b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-bottom: 0in;"><b>NOTES: </b><br>
+</p>
+<blockquote><i>If you are upgrading from Roller 0.9.5 you can upgrade your
+database using one of the 095-to-096-micrgration.sql scripts. This is a risky
+operation so you should backup your database before you run the migration
+script. The migration script will save the old Roller tables with names
+that start with "temp_" and you should not drop these backup tables until
+you are satisfied that your data base made it through the migration.</i><br>
+ <br>
+ <i>If you are upgrading from Roller 0.9.4, then run the 094-to-095 migration
+script and then the 095-to-096 migration script.</i><br>
+</blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><b> STEP 4: Configure Roller's
+Servlet Context</b> <span style=""> </span></font></font> </p>
+
+<p style="margin-bottom: 0in;"><span style="">Edit the Tomcat Servlet engine's
+ <b>conf/server.xml</b> configuration file to add a the Roller Servlet Context.
+ This is where you configure the Servlet Authentication to use the Roller
+ database tables and where you configure the Roller datasource. </span>Look
+for the section of the server.xml file where Contexts are defined and assuming
+that you are using MySQL you should add the following:<br>
+ </p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff"> <Context
+path="/roller" docBase="roller" debug="0"><br>
+ </font></b></font></small></p>
+
+<blockquote>
+ <p class="western"><font color="#0000ff"><font
+ face="Courier New, monospace"><font size="2"><b> <!-- Config Servlet
+ Authentication to use Roller's USER and ROLE tables --><br>
+ <Realm className="org.apache.catalina.realm.JDBCRealm"
+ <br>
+ debug="0" driverName="<font color="#ff0000">org.gjt.mm.mysql.Driver</font>"<br>
+ connectionURL=<br>
+ "<font color="#ff0000">jdbc:mysql://localhost/roller?autoReconnect=true&amp;user=</font><font
+ color="#ff0000">roller&amp;password=</font><font color="#ff0000">tiger</font>"<br>
+ userTable="rolleruser" userNameCol="username" userCredCol="password"<br>
+ userRoleTable="role" roleNameCol="role" /></b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+ <!-- Config datasource to be bound to java:comp/env/jdbc/rollerdb</font></b></font></small>
+ --><br>
+ <small><font face="Courier New, Courier, monospace"><b><font
+ color="#3333ff"> <Resource name="jdbc/rollerdb" auth="Container"<br>
+ type="javax.sql.DataSource"/></font></b></font></small></p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff">
+ <ResourceParams name="jdbc/rollerdb"><br>
+ <parameter><br>
+ <name>factory</name><br>
+ <value>org.apache.commons.dbcp.BasicDataSourceFactory</value><br>
+ </parameter><br>
+ <parameter><name>maxActive</name><value>30</value></parameter><br>
+ <parameter><name>maxIdle</name><value>30000</value></parameter><br>
+ <parameter><name>maxWait</name><value>100</value></parameter><br>
+ <parameter><name>username</name><value><font
+ color="#ff0000">roller</font></value></parameter><br>
+ <parameter><name>password</name><value><font
+ color="#ff0000">tiger</font></value></parameter><br>
+ <parameter><br>
+ <name>driverClassName</name><value><font
+ color="#ff0000">org.gjt.mm.mysql.Driver</font></value><br>
+ </parameter><br>
+ <parameter><br>
+ <name>url</name><value><font
+ color="#ff0000">jdbc:mysql://localhost/roller?autoReconnect=true</font></value><br>
+ </parameter><br>
+ </ResourceParams></font></b></font></small></p>
+
+<p style="margin-bottom: 0in;"><small><font
+ face="Courier New, Courier, monospace"><b><font color="#3333ff"> </Context></font></b></font></small><br>
+ </p>
+
+<p style="margin-bottom: 0in;">NOTES:<br>
+</p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><i>If you are not using MySQL, then you will
+have to substitute the appropriate JDBC connection parameters (driver class
+name and connection URL) for your database. <br>
+ </i> </p>
+
+ <p style="margin-bottom: 0in;"><i>For more information on Tomcat's server.xml
+configuration file, refer to the <a
+ href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/config/index.html">Tomcat
+Configuration Reference</a>.</i></p>
+</blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+</font></font><font face="Albany, sans-serif"><font size="4"><b> STEP 5:
+Make JDBC driver available to Tomcat</b></font></font></p>
+<p style="margin-top: 0.17in; page-break-after: avoid;">To support Servlet
+Authentication that you configured in step 4, you must place your JDBC driver
+jar(s) in Tomcat's common/lib directory. The MySQL driver jar is include
+in the Roller distribution so for MySQL you might do this as follows:<br>
+</p>
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/webapps/roller/WEB-INF/lib</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % cp mm.mysql-2.0.12.bin.jar $CATALINA_HOME/common/lib</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"><b> </b></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"> </p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">> cd %CATALINA_HOME%\webapps\roller\WEB-INF\lib</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ > copy mm.mysql-2.0.12.bin.jar %CATALINA_HOME%\common\lib</b></font></font></font></p>
+ </blockquote>
+<h3><font face="Albany, sans-serif"><font size="4"><br>
+ STEP 6: Configure Roller before start-up</font></font></h3>
+<p style="margin-top: 0.17in; page-break-after: avoid;">The Roller web.xml
+file includes the following configuration parameters. If in doubt, don't
+change these values - the defaults are pretty reasonable.<br>
+</p>
+<blockquote>
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.rss.usePor</b><b>t</b>
+- true if the item URLs created in by the RSS feature should include the
+Servlet engine's port number. The default is false, but you might want to
+turn this on if you are running Tomcat behind an Apache web server.</p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.new.user.allow</b>
+- allow new users to be added to Roller. Defaults to true.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.admin.users</b>
+- comma separated list of user names that will have administrative rights
+on the system.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.authenticationClass</b>
+- class name of a class that implements org.roller.presentation.Authenticator
+and that should be used to authenticate users. This allows you to plug in
+your own authentication system if you do not want to use Servlet Authentication.
+ See org.roller.presentation.DefaultAuthenticator for an example of how to
+write a plug-in authenticator for Roller.</p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.editorPages</b>
+- comma separated list of JSP files in the /weblog directory that contain
+weblog editing interfaces. See the editor-ekit.jsp and editor-text.jsp files
+for examples of how to write a plug-in editor for Roller.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.enableAggregator</b>
+- true to enable the Roller aggregation features: the $macros.showNewfeed()
+macros, the Newsfeeds:Subscriptions page, and the Newsfeeds:ViewAll page.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.enabled</b>
+- true to enable file upload. Defaults to true. </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.maxFileMB</b>
+- maximum size in megabytes of file that users are allowed to upload. Defaults
+to <b>1</b>.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.maxDirMB</b>
+- maximum size in megabytes of each user's upload directory. Defaults to
+ <b>4</b>.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.allow</b>
+- comma separated list of file extensions allowed in upload directory. Defaults
+to <b>jpg,jpeg,gif,png</b>. Forbid and Allow are mutually exclusive so set
+only one of the two.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.forbid</b>
+- comma separated list of file extensions forbidden in the upload directory.
+ Defaults to nothing.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.dir</b>
+- directory where files are to be uploaded, may end with a slash. Defaults
+to empty string which indicates that files will be uploaded to the /resources
+directory in the Roller Servlet Context.<br>
+ </p>
+
+ <p style="margin-top: 0.17in; page-break-after: avoid;"><b>org.roller.upload.path</b>
+- URL path to upload directory, should not end with a slash. Defaults to
+/resources which works well when the upload directory default.</p>
+</blockquote>
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+<b> STEP 7: Start Tomcat and start using Roller</b></font></font></p>
+
+<p style="margin-bottom: 0in;">Start your Servlet Container, open your web
+ browser, browse to the Roller start page and start using Roller.</p>
+
+<blockquote>
+ <p style="margin-bottom: 0in;"><font color="#0000ff">UNIX example, starting
+ Tomcat</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">% cd $CATALINA_HOME/bin</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ % ./startup.sh</b></font></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"><font
+ face="Courier, monospace"><b> </b></font></font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff">Windows example, starting
+ Tomcat</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> From an MS-DOS or
+ Command Prompt window:</font></p>
+
+ <p style="margin-bottom: 0in;"><font color="#0000ff"> <b><font
+ size="2"><font face="Courier New, monospace">C> cd %CATALINA_HOME%\bin</font></font></b></font><font
+ color="#0000ff"><font face="Courier New, monospace"><font size="2"><b><br>
+ C> startup</b></font></font></font></p>
+ </blockquote>
+
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><br>
+ References</font></font></p>
+
+<ul>
+ <li><b>Velocity - <a href="http://jakarta.apache.org/velocity">http://jakarta.apache.org/velocity</a></b></li>
+ <li><b>Castor <a href="http://castor.exolab.org/">http://castor.exolab.org</a></b></li>
+ <li><b>Mysql <a href="http://mysql.com/">http://mysql.com</a></b></li>
+ <li><b>JDK 1.4 <a href="http://javasoft.com/">http://javasoft.com</a></b></li>
+ <li><b>Tomcat 4.0 <a href="http://jakarta.apache.org/tomcat">http://jakarta.apache.org/tomcat</a></b></li>
+ <li><b>Redhat Linux 7.2 <a href="http://redhat.com/">http://redhat.com</a></b></li>
+ <li><b>Windows XP <a href="http://microsoft.com/">http://microsoft.com</a></b></li>
+
+</ul>
+
+<p style="margin-bottom: 0in;"><br>
+ </p>
+
+<p style="margin-bottom: 0in;"><br>
+ </p>
+ <br>
+ <br>
+ <br>
+ <br>
+ <br>
+ <br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+</body>
+</html>