Webs Book Compare GPCE06 Gmt Gpce Gpce04 Gpce05 IFIPWG211 IPA06 Main Octave PEPM07 PEPM08 PHP Sandbox Sdf Stratego Sts TWiki Tiger Tools Transform Variability default porn free porn
Upgrade from the previous TWiki 01-Dec-2001 production release to TWiki 01-Feb-2003
This guide describes how to upgrade from TWiki 01-Dec-2001 to TWiki 01-Feb-2003. The new version involves several new features and numerous enhancements to the previous version.
readTopicText
, saveTopicText
, setTopicEditLock
, checkTopicEditLock
registrationHandler
, beforeEditHandler
, afterEditHandler
, beforeSaveHandler
, writeHeaderHandler
, redirectCgiQueryHandler
, getSessionValueHandler
, setSessionValueHandler
%SEARCH{}%
variable, FormattedSearch and WebSearch
The following steps describe the upgrade assuming that $TWIKIROOT
is the root of your current 01-Dec-2001 release. As written this will require some downtime. A process for switching over without downtime is described at the end of this section.
$TWIKIROOT/bin
, $TWIKIROOT/pub
, $TWIKIROOT/data
, $TWIKIROOT/templates
, $TWIKIROOT/lib
.
*.html
and *.txt
files in $TWIKIROOT
with the new ones.
$TWIKIROOT/templates
with the new ones.
%WIKIHOMEURL%
with %WIKILOGOURL%
src=%PUBURLPATH%/wikiHome.gif
with src=%WIKILOGOIMG%
alt="TWiki Home"
with alt="%WIKILOGOALT%"
charset=iso-8859-1"
with charset=%CHARSET%"
%TOPIC%
to form action of GoBox
.../view%SCRIPTSUFFIX%/%WEB%/%TOPIC%"
with .../view%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%
$TWIKIROOT/bin
with the new ones.
.cgi
$TWIKIROOT/bin/setlib.cfg
and point $twikiLibPath
to the absolute file path of $TWIKIROOT/lib
$TWIKIROOT/bin/.htaccess
to include a directive for the new manage
script:<Files "manage">
require valid-user
</Files>
chmod 775 $TWIKIROOT/bin/*
TWiki.cfg
configuration file in $TWIKIROOT/lib
with the new one.
TWiki.pm
library in $TWIKIROOT/lib
with the new one.
$TWIKIROOT/lib
with the new ones. Make sure to preserve any extra Plugins you might have in $TWIKIROOT/lib/TWiki/Plugins
chmod -R 664 $TWIKIROOT/lib/*
bin/testenv
script from the browser (e.g. http://localhost/bin/testenv
) to verify if the cgi-scripts are running as user nobody
.
*,v
RCS repository files delivered with the installation package are locked by user nobody
and need to be changed to the user of your cgi-scripts, e.g. www-data
:
twiki/data/*
directories where you unzipped the installation package: A simple way to switch the locker of the RCS files is to use sed in the :
for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done
twiki/data/TWiki
directory where you unzipped the installation package:
InterWikis.*
, TWikiRegistration.*
, TWikiRegistrationPub.*
, WebNotify.*
, WebPreferences.*
, WebStatistics.*
and all WebTopic*
files.
$TWIKIROOT/data/TWiki/TWikiPreferences.*
to TWikiPreferencesSave.*
.
*.txt
and *.txt,v
files from the temporary data/TWiki
directory to your $TWIKIROOT/data/TWiki
directory, overwriting the existing ones.
TWikiPreferencesSave.txt
settings into $TWIKIROOT/data/TWiki/TWikiPreferences.txt
.
data/_default
directory from the temporary location to your $TWIKIROOT/data
directory.
data/Sandbox
directory from the temporary location to your $TWIKIROOT/data
directory $TWIKIROOT/data
are writable by your cgi-script user.
TWiki
and _default
):
WebHome.txt
and WebPreferences.txt
of your other webs to make sure, you have the improvements applied also in your other webs.
pub/TWiki
from your temporary directory into your $TWIKIROOT/pub/TWiki
directory.
$TWIKIROOT/pub/TWiki
are writable by your cgi-script user.
pub/icn
directory from the temporary location to your $TWIKIROOT/pub/icn
directory.
ALLOWWEBMANAGE
to the FINALPREFERENCES
list so that nobody can overwrite the setting:
$TWIKIROOT/bin/testenv
script from your browser (e.g. http://localhost/bin/testenv
) to see if it reports any issues; fix any potential problems.
Note: These steps assume a downtime during the time of upgrade. You could install the new version in parallel to the existing one and switch over in an instant without affecting the users. As a guideline, install the new version into $TWIKIROOT/bin1
, $TWIKIROOT/lib1
, $TWIKIROOT/templates1
, $TWIKIROOT/data/TWiki1
(from data/TWiki
), $TWIKIROOT/pub/TWiki1
(from pub/TWiki
), and configure TWiki.cfg
to point to the same data and pub directory like the existing installation. Once tested and ready to go, reconfigure $TWIKIROOT/bin1/setlib.cfg
and $TWIKIROOT/lib1/TWiki.cfg
, then rename $TWIKIROOT/bin
to $TWIKIROOT/bin2
, $TWIKIROOT/bin1
to $TWIKIROOT/bin
. Do the same with the lib
, templates
and data/TWiki
directories.
-- PeterThoeny - 01 Feb 2002
-- MartinRaabe? - 15 Jan 2003