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 2009/01/02 16:15:06 UTC
svn commit: r730751 - in
/roller/branches/roller_4.0/apps/weblogger/docs/installguide: ./ generated/
generated/html/
Author: snoopdave
Date: Fri Jan 2 07:15:06 2009
New Revision: 730751
URL: http://svn.apache.org/viewvc?rev=730751&view=rev
Log:
Fixing a typo and changing a reference to 4.0 to 4.0.1
Added:
roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_148117bd.png (with props)
roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m11d68315.png (with props)
roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m8d76424.png (with props)
Modified:
roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide.html
roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/roller-install-guide.pdf
roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.odt
roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.txt
Modified: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide.html
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide.html?rev=730751&r1=730750&r2=730751&view=diff
==============================================================================
--- roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide.html (original)
+++ roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide.html Fri Jan 2 07:15:06 2009
@@ -3,10 +3,9 @@
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.0 (Solaris x86)">
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.0 (Unix)">
<META NAME="CREATED" CONTENT="20070706;11182000">
- <META NAME="CHANGEDBY" CONTENT="Dave Johnson">
- <META NAME="CHANGED" CONTENT="20081223;15534300">
+ <META NAME="CHANGED" CONTENT="20090102;10092100">
<META NAME="KEYWORDS" CONTENT="OpenDS Directory Server Administration Framework">
<META NAME="Info 1" CONTENT="">
<META NAME="Info 2" CONTENT="">
@@ -52,7 +51,7 @@
<BR>
</P>
<P CLASS="western" ALIGN=RIGHT STYLE="margin-bottom: 0in; background: transparent">
-<IMG SRC="roller-install-guide_html_490f4977.png" NAME="graphics1" WIDTH=210 HEIGHT=85 BORDER=0></P>
+<IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_490f4977.png" NAME="graphics1" WIDTH=252 HEIGHT=102 BORDER=0></P>
<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
<BR>
</P>
@@ -137,7 +136,8 @@
<FONT FACE="Helvetica, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Version
4.0.1</B></FONT></FONT></P>
<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<SDFIELD TYPE=DOCINFO SUBTYPE=CHANGE FORMAT=DATE SDNUM="1033;1033;MMMM YYYY">December 2008</SDFIELD></P>
+<SDFIELD TYPE=DOCINFO SUBTYPE=CHANGE FORMAT=DATE SDNUM="1033;1033;MMMM YYYY">January 2009</SDFIELD>
+</P>
<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
</P>
@@ -614,13 +614,13 @@
<P CLASS="western">You can also deploy to Glassfish as either a
directory or a WAR file. The screenshot below shows directory-based
deployment options.</P>
-<P CLASS="western"><IMG SRC="roller-install-guide_html_54a5dedd.png" NAME="graphics5" ALIGN=LEFT WIDTH=594 HEIGHT=548 BORDER=0><BR CLEAR=LEFT><BR><BR>
+<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_148117bd.png" NAME="graphics5" ALIGN=LEFT WIDTH=712 HEIGHT=656 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P CLASS="western"><SPAN STYLE="background: transparent">Once Roller
is deployed, you'll see that it's listed among the other
applications. There's a <B>Launch</B> link to Roller itself and there
are buttons to enable, display and redeploy.</SPAN></P>
-<P CLASS="western"><IMG SRC="roller-install-guide_html_me1768f1.png" NAME="graphics6" ALIGN=LEFT WIDTH=591 HEIGHT=106 BORDER=0><BR CLEAR=LEFT><SPAN STYLE="background: transparent">If
+<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m11d68315.png" NAME="graphics6" ALIGN=LEFT WIDTH=708 HEIGHT=127 BORDER=0><BR CLEAR=LEFT><SPAN STYLE="background: transparent">If
Roller doesn't start-up, look for the problem in the logs. You can
find them in your Glassfish domain's <FONT FACE="Courier New, monospace">logs</FONT>
directory. The Glassfish log file is <FONT FACE="Courier New, monospace">server.log</FONT>
@@ -647,10 +647,10 @@
JDBC driver class name, connection URL, username or password. Or
perhaps your database is not running. Use the information provided to
determine what is wrong, fix it and then redeploy Roller.</P>
-<P CLASS="western"><IMG SRC="roller-install-guide_html_79ee0277.png" NAME="graphics7" ALIGN=LEFT WIDTH=485 HEIGHT=276 BORDER=0><BR CLEAR=LEFT><BR><BR>
+<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_79ee0277.png" NAME="graphics7" ALIGN=LEFT WIDTH=581 HEIGHT=331 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<H4 CLASS="western">Automatic tables creation</H4>
-<P CLASS="western"><IMG SRC="roller-install-guide_html_2bf00c9b.png" NAME="graphics8" ALIGN=LEFT WIDTH=466 HEIGHT=106 BORDER=0><BR CLEAR=LEFT>If
+<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_2bf00c9b.png" NAME="graphics8" ALIGN=LEFT WIDTH=558 HEIGHT=127 BORDER=0><BR CLEAR=LEFT>If
your database configuration is good but Roller cannot find its
database tables, then Roller will offer to create those pages
automatically for you. If you give the go-ahead, Roller will run the
@@ -662,7 +662,7 @@
front-page weblog then it will display the Completing Your
Installation below that explains how to register your first user,
create your first weblog and setup your site's front page.</P>
-<P CLASS="western"><IMG SRC="roller-install-guide_html_m61aa845.png" NAME="graphics9" ALIGN=LEFT WIDTH=440 HEIGHT=326 BORDER=0><BR CLEAR=LEFT><BR><BR>
+<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m8d76424.png" NAME="graphics9" ALIGN=LEFT WIDTH=527 HEIGHT=390 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P CLASS="western">You have to decide what you want as the front-page
of your Roller site. If you are using Roller to run your personal
@@ -937,7 +937,7 @@
couple of key exceptions. But first, there is some required reading
for those upgrading from ancient versions of Roller.</P>
<H2 CLASS="western">10.1For those upgrading from Roller 2.x to Roller
-4.0</H2>
+4.0.1</H2>
<P CLASS="western"><SPAN STYLE="background: transparent">Roller 3.0
and Roller 4.0 were <I>major</I> releases and made some big changes
to the way that Roller works. If you're upgrading from the 2.x series
@@ -1061,7 +1061,7 @@
<P CLASS="western">Follow the normal installation instructions for
the new version of Roller, but...</P>
<UL>
- <LI><P CLASS="western">When creating your <FONT FACE="Courier New, monospace">roller-custom.properites</FONT>,
+ <LI><P CLASS="western">When creating your <FONT FACE="Courier New, monospace">roller-custom.properties</FONT>,
copy of your old one. Carefully review each property and compare it
to the property settings in the Roller 4.0 property file in <B>Section
11</B>.
Added: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_148117bd.png
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_148117bd.png?rev=730751&view=auto
==============================================================================
Binary file - no diff available.
Propchange: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_148117bd.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m11d68315.png
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m11d68315.png?rev=730751&view=auto
==============================================================================
Binary file - no diff available.
Propchange: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m11d68315.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m8d76424.png
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m8d76424.png?rev=730751&view=auto
==============================================================================
Binary file - no diff available.
Propchange: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/html/roller-install-guide_html_m8d76424.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/roller-install-guide.pdf
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/generated/roller-install-guide.pdf?rev=730751&r1=730750&r2=730751&view=diff
==============================================================================
Binary files - no diff available.
Modified: roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.odt
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.odt?rev=730751&r1=730750&r2=730751&view=diff
==============================================================================
Binary files - no diff available.
Modified: roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.txt
URL: http://svn.apache.org/viewvc/roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.txt?rev=730751&r1=730750&r2=730751&view=diff
==============================================================================
--- roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.txt (original)
+++ roller/branches/roller_4.0/apps/weblogger/docs/installguide/roller-install-guide.txt Fri Jan 2 07:15:06 2009
@@ -29,7 +29,7 @@
Apache Roller Weblogger
Version 4.0.1
-December 2008
+January 2009
Table of Contents
1 Overview 3
@@ -348,7 +348,7 @@
And if you are upgrading Roller, you'll have to run the migration scripts. You'll find those under the dbscripts directory too.
10Upgrading Roller
This section describes how to upgrade an existing Roller installation to the latest release of Roller by shutting down, backing up and then following the installation instructions with a couple of key exceptions. But first, there is some required reading for those upgrading from ancient versions of Roller.
-10.1For those upgrading from Roller 2.x to Roller 4.0
+10.1For those upgrading from Roller 2.x to Roller 4.0.1
Roller 3.0 and Roller 4.0 were major releases 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 them and especially the new URL structure and the new template system.
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 forwarded 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:
@@ -386,7 +386,7 @@
If you're upgrading from an older version of Roller you may have been storing uploaded files inside the Roller web application, in a /resources subdirectory. In Roller 4.0 the default is to store those files your home directory under roller_data/uploads, so you'll have to copy your uploads there. If you want to change the location of the uploads directory, overload the property upoads.dir.
10.3Install and startup the new Roller
Follow the normal installation instructions for the new version of Roller, but...
-When creating your roller-custom.properites, copy of your old one. Carefully review each property and compare it to the property settings in the Roller 4.0 property file in Section 11.
+When creating your roller-custom.properties, copy of your old one. Carefully review each property and compare it to the property settings in the Roller 4.0 property file in Section 11.
Don't create a new database for Roller. Instead point Roller to your existing Roller database. This is completely safe because you created a backup of your database (right?).
When you deploy and startup, Roller will detect that your database needs to be upgraded and it will offer to run each of the migrations scripts necessary to upgrade you from your old version to the new version of Roller.
NOTE: if you would rather run the database migration scripts yourself, you can. See Section 9.4.