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 TWiki 01-Dec-2000 or TWiki 01-Sep-2001 to TWiki 01-Dec-2001 (previous to new full release)
This guide describes how to upgrade either from TWiki 01-Dec-2000 or TWiki 01-Sep-2001 to TWiki 01-Dec-2001.
The latest 01-Dec-2001 release includes the following new features and enhancements compared to the 01-Sep-2001 release:
format=""
parameter in %SEARCH{}%
variable for database like reporting.
The 01-Sep-2001 release includes the following new features and enhancements compared to the 01-Dec-2000 release:
SiteAlias:Page
; rules are defined in InterWikis. (Get more Plugins from the TWiki:Plugins web.)
%TOC%
variable generates a hierarchical table of contents from topic headings: <h1>...<h6>.
The TWiki directory structure remains the same, with one exception, the TWiki configuration file and Perl modules have been moved from the twiki/bin
directory into it's own twiki/lib
directory tree. The following files have been renamed and moved:
From TWiki 01-Dec-2000: | To TWiki 01-Dec-2001: |
---|---|
twiki/bin/wiki.pm | twiki/lib/TWiki.pm |
twiki/bin/wikiaccess.pm | twiki/lib/TWiki/Access.pm |
twiki/bin/wikicfg.pm | twiki/lib/TWiki.cfg |
twiki/bin/wikiprefs.pm | twiki/lib/TWiki/Prefs.pm |
twiki/bin/wikisearch.pm | twiki/lib/TWiki/Search.pm |
twiki/bin/wikistore.pm | twiki/lib/TWiki/Store.pm |
A new twiki/lib/TWiki/Plugins
directory contains the new Plugin modules.
This incremental update can be performed easily.
The following steps describe the upgrade assuming that $TWIKIROOT
is the root of your current 01-Sep-2001 release.
$TWIKIROOT/bin
, $TWIKIROOT/pub
, $TWIKIROOT/data
, $TWIKIROOT/templates
.
*.html
and *.txt
files in $TWIKIROOT
with the new ones.
$TWIKIROOT/templates
with the new ones.
$TWIKIROOT/bin
with the new ones.
TWiki.pm
library in $TWIKIROOT/lib
with the new one.
*.pm
library files in $TWIKIROOT/lib/TWiki
and $TWIKIROOT/lib/TWiki/Plugins
with the new ones.
twiki/data/TWiki
directory where you unzipped the installation package:
TWikiPreferences.*
, WebNotify.*
, WebPreferences.*
, WebStatistics.*
and all WebTopic*
files.
nobody
: The *,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
. A simple way to switch the locker of the RCS files is to use sed:
for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done
*.txt
and *.txt,v
files from the temporary data/TWiki
directory to your $TWIKIROOT/data/TWiki
directory.
pub/TWiki/TWikiDocGraphics
directory into your $TWIKIROOT/pub/TWiki
directory.
The idea is to have the new and old installation work in parallel so that you can test the new installation before switching over. That way you can make the switch on your live TWiki installation within one minute without affecting the users.
Before Switch: | After Switch: | ||
---|---|---|---|
Current 01-Dec-2000: | New 01-Dec-2001: | Obsolete 01-Dec-2000: | New 01-Dec-2001: |
twiki/templates/ | twiki/templates2/ | twiki/templates1/ | twiki/templates/ |
twiki/bin/ | twiki/bin/2/ | (overwritten) | twiki/bin/ |
(N/A) | twiki/bin/lib/ | (N/A) | twiki/lib/ |
twiki/data/TWiki | twiki/data/TWiki2 | twiki/data/TWiki1 | twiki/data/TWiki |
(other directories do not change) |
Alternatively you could move the existing installation away, install the 01-Dec-2001 release into it's place and move your webs and pub files back.
Follow this step-by-step guide to upgrade from the 01-Dec-2000 TWiki to the 01-Dec-2001 release, importing your original page data and related files:
Two major areas of TWiki functionality - TWikiTemplates and TWikiForms (input forms associated with a topic)- are entirely different in the new TWiki. If you've customized your templates or use Category Tables, read those sections before starting your upgrade.
The following steps describe the upgrade on Unix. Windows setup is very similar. It's assumed that $TWIKIROOT
is the root of your current 01-Dec-2000 release, ex: export TWIKIROOT=/some/dir/
twiki/bin
, twiki/pub
, twiki/data
, twiki/templates
.
mkdir -p ~/tmp/
cp -p ~/downloads/TWiki20011201.zip ~/tmp/
cd ~/tmp/
unzip ~/tmp/TWiki20011201.zip
twiki
):
mv ~/tmp/TWiki*.html $TWIKIROOT
mv ~/tmp/index.html $TWIKIROOT
mv ~/tmp/readme.txt $TWIKIROOT
mv ~/tmp/license.txt $TWIKIROOT
twiki/templates2
directory, ex:
mv ~/tmp/templates $TWIKIROOT/templates2
chmod 644 *.cgi
twiki/data/TWiki2
directory. Do the same to files attached to this web, ex:
mv ~/tmp/data/TWiki $TWIKIROOT/data/TWiki2
mv ~/tmp/pub/TWiki $TWIKIROOT/pub/TWiki2
twiki/data/Know2
directory, ex:
mv ~/tmp/data/Know $TWIKIROOT/data/Know2
mv ~/tmp/pub/Know $TWIKIROOT/pub/Know2
mv ~/tmp/data/_default $TWIKIROOT/data
mv ~/tmp/data/Trash $TWIKIROOT/data
mv ~/tmp/data/mime.types $TWIKIROOT/data
mv ~/tmp/pub/*.gif $TWIKIROOT/pub
TWiki2
and Know2
directories and its files. The files must be writable by the cgi-scripts (usually user nobody
).
nobody
: The *,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
. A simple way to switch the locker of the RCS files is to use sed:
for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done
twiki/bin/2
directory, ex:
mv ~/tmp/bin $TWIKIROOT/bin/2
.cgi
cp -p $TWIKIROOT/bin/somescript $TWIKIROOT/bin/2
.htaccess.txt
to .htaccess
and customize it, ex:
cd $TWIKIROOT/bin/2
mv .htaccess.txt .htaccess
diff ../.htaccess .
chmod 755 *.cgi
twiki/bin/lib
directory, ex:
mv ~/tmp/lib $TWIKIROOT/bin
chmod 644 *.pm
twiki/bin/wikicfg.pm
into the new twiki/lib/TWiki.cfg
configuration file. Use the diff
command to find out the differences, ex:
cd $TWIKIROOT/bin/lib
diff ../wikicfg.pm TWiki.cfg
$scriptUrlPath = "/twiki/bin/2";
$templateDir = "/home/httpd/twiki/templates2";
extendHandleCommonTags
, extendGetRenderedVersionOutsidePRE
, extendGetRenderedVersionInsidePRE
from the old twiki/bin/wikicfg.pm
. This is now handled by the Default plugin twiki/lib/TWiki/Plugins/Default.pm
http://localhost/cgi-bin/view
http://localhost/cgi-bin/2/view
You can do the following changes using your old TWiki 01-Dec-2000 or new TWiki 01-Dec-2001 installation. Pointing your browser to the old installation for edit-copy-edit-paste operations is recommended, so that users don't get surprised by meta data content showing up in topics.
TWiki
web.
TWiki2
web, which gets renamed to TWiki
when you switch over the installation.
TWiki.TWikiRegistration
, merge your changes back into TWiki2.TWikiRegistration
.
TWiki2
any topics that you created in the TWiki
web.
TWiki2.TWikiPreferences
, merge the old TWiki.TWikiPreferences
settings and customize it.
WebPreferences
of all webs, add or change the following web preferences: (see TWiki.WebPreferences
)
web="all"
search:
* Set NOSEARCHALL = on
%WEB% . {}
decoration from the list (it is now in the templates), ex:
* Set WEBTOPICLIST = <a href="WebHome">Home</a>
| <a href="WebChanges">Changes</a>
| <a href="WebIndex">Index</a>
| <a href="WebSearch">Search</a>
| Go <input type="text" name="topic" size="16" />
* Set DENYWEBVIEW =
* Set ALLOWWEBVIEW =
* Set DENYWEBRENAME =
* Set ALLOWWEBRENAME =
* Set FINALPREFERENCES = WEBTOPICLIST, DENYWEBVIEW, ALLOWWEBVIEW, DENYWEBCHANGE, ALLOWWEBCHANGE, DENYWEBRENAME, ALLOWWEBRENAME
WebSearch
of all webs, replace content with this one line:
%INCLUDE{"%TWIKIWEB%.WebSearch"}%
WebChanges
of all webs, replace content with this one line:
%INCLUDE{"%TWIKIWEB%.WebChanges"}%
NOTE: Skip this step if you did not customize your template files.
twiki/templates
.
twiki/templates2
, which gets renamed to twiki/templates
when you switch over the installation.
=<p />
tag added.
WebForm
topic based on twikicatitems.tmpl
in each web that uses a Category Table. See details in TWikiForms and compare with the settings in the Know2.WebPreferences
topic.
twikicatitems.tmpl
file, it is still used for topics that are of the old format.
[T]
and [P]
is done so that search does not find the topic where this search string is located in!)
notedited.tmpl
template, create an equivalent WebTopicEditTemplate to conform with the new TemplateTopics. The new format replaces the notedited.tmpl
, notext.tmpl
and notwiki.tmpl
templates.
In this step, you move the working 01-Dec-2001 installation to the old 01-Dec-2000 installation, so that users don't have to change the URL.
twiki/bin/2/view
to make sure everything works as expected.
$TWIKIROOT/bin/lib/TWiki.cfg
and remove the /2
from $scriptUrlPath
and $templateDir
, ex:
$scriptUrlPath = "/twiki/bin";
$templateDir = "/home/httpd/twiki/templates";
TWiki2
web to TWiki
, including attachments, ex:
cd $TWIKIROOT/data
mv TWiki TWiki1
mv TWiki2 TWiki
cd $TWIKIROOT/pub
mv TWiki TWiki1
mv TWiki2 TWiki
templates2
directory to templates
, ex:
cd $TWIKIROOT
mv templates templates1
mv templates2 templates
lib
directory one level up from $TWIKIROOT/bin/lib
to $TWIKIROOT/lib
, ex:
cd $TWIKIROOT
mv bin/lib .
bin/2
to bin
, ex:
cd $TWIKIROOT/bin
cp -p bin/2/* .
cp -p bin/2/.htaccess .
$TWIKIROOT/bin/2
$TWIKIROOT/templates1
$TWIKIROOT/data/TWiki1
$TWIKIROOT/pub/TWiki1
~/tmp
EmptyPlugin
, DefaultPlugin
, and InterwikiPlugin
should be preinstalled. To check the InterwikiPlugin, go to its page.
extendHandleCommonTags
, extendGetRenderedVersionOutsidePRE
and extendGetRenderedVersionInsidePRE
in twiki/bin/wikicfg.pm
:
twiki/lib/TWiki/Plugins/Default.pm
%GMTIME{"..."}%
and %SERVERTIME{"..."}%
variables is now "$hour:$min"
instead of "hour:min"
. More in TWikiVariables.
| *bold* |
cells, | center aligned |
and | right aligned |
cells, span multiple columns using | empty cells |||
. More in TextFormattingRules.
Net::SMTP
module instead of sendmail
if installed.
<verbatim> ... </verbatim>
tags instead of <pre> ... </pre>
tags where appropriate. More in TextFormattingRules.
%STARTINCLUDE%
and %STOPINCLUDE%
variables to control what gets included of a topic. More in TWikiVariables.
$attachAsciiPath
in TWiki.cfg
defines which file types are stored in ASCII, otherwise, binary format is used. This means that the RCS version used should support binary files.
edit.new.tmpl
has been removed and replaced by template topics in the new TWikiTemplates.
warning.txt
file can appear in the data
directory. It may contain diagnostic info identifying problems that need fixing. This file could get fairly large if you have a lot of problems your site - you can delete it at any time.
-- JohnTalintyre? - 18 Jul 2001
-- PeterThoeny - 03 Dec 2001
-- MikeMannix - 05 May 2002