head	1.15;
access;
symbols;
locks
	nobody:1.15; strict;
comment	@# @;


1.15
date	2001.09.01.07.20.29;	author MikeMannix;	state Exp;
branches;
next	1.14;

1.14
date	2001.09.01.04.47.30;	author MikeMannix;	state Exp;
branches;
next	1.13;

1.13
date	2001.08.30.10.21.53;	author MikeMannix;	state Exp;
branches;
next	1.12;

1.12
date	2001.08.25.08.32.53;	author PeterThoeny;	state Exp;
branches;
next	1.11;

1.11
date	2001.03.16.09.13.45;	author PeterThoeny;	state Exp;
branches;
next	1.10;

1.10
date	2000.12.10.22.40.24;	author PeterThoeny;	state Exp;
branches;
next	1.9;

1.9
date	2000.11.16.07.14.06;	author PeterThoeny;	state Exp;
branches;
next	1.8;

1.8
date	2000.11.09.02.49.08;	author PeterThoeny;	state Exp;
branches;
next	1.7;

1.7
date	2000.11.04.08.32.39;	author PeterThoeny;	state Exp;
branches;
next	1.6;

1.6
date	2000.11.02.08.24.15;	author PeterThoeny;	state Exp;
branches;
next	1.5;

1.5
date	2000.09.09.21.44.09;	author PeterThoeny;	state Exp;
branches;
next	1.4;

1.4
date	2000.08.28.12.11.50;	author NicholasLee;	state Exp;
branches;
next	1.3;

1.3
date	2000.08.28.08.37.51;	author NicholasLee;	state Exp;
branches;
next	1.2;

1.2
date	2000.08.21.08.23.56;	author PeterThoeny;	state Exp;
branches;
next	1.1;

1.1
date	2000.08.21.00.16.35;	author PeterThoeny;	state Exp;
branches;
next	;


desc
@none
@


1.15
log
@none
@
text
@%META:TOPICINFO{author="MikeMannix" date="999329582" format="1.0" version="1.15"}%
---## TWiki Upgrade Notes for Version 01 May 2000

If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first. For the latest version read TWikiUpgradeGuide.

The 01 Dec 2000 release has these changes that affect the upgrade of the 01 May 2000 version:

	* Improved search, i.e. search multiple webs.
	* The =changes= script has been retired (related to new search).
	* Reorganization of topics: The TWiki.Main web was split up into TWiki.Main and TWiki.TWiki web.

This upgrade is somewhat more labor intensive, mainly caused by splitting up the TWiki.Main web. Please note that subsequent updates will be much easier because user related topics (in TWiki.Main web) and TWiki related documents (in TWiki.TWiki web) have been separated.

These are the steps you need to perform to upgrade the 01 May 2000 version to the 01 Dec 2000 release: [ We assume =export TWIKIROOT=/some/dir/= ]

	* __Backup__ all existing TWiki directories ( =bin=, =pub=, =data=, =templates= )

	* __Unpack the zip file__ into some working directory:
	  <br> =mkdir -p ~/tmp/=
	  <br> =cd ~/tmp=
	  <br> =unzip ~/TWiki20001201.zip=

	* __Upgrade the TWiki document files__ ( =twiki= )
		* Move the document files to your TWiki root, i.e.
		  <br> =mv ~/tmp/TWiki*.html $TWIKIROOT=
		  <br> =mv ~/tmp/readme.txt $TWIKIROOT=

	* __Upgrade cgi-bin scripts__ ( =twiki/bin= )
		* Rename your original =twiki/bin= directory, i.e.
		  <br> =mv $TWIKIROOT/bin $TWIKIROOT/bin.old=
		* Move the new scripts to your original =twiki/bin= location, i.e.
		  <br> =mv ~/tmp/bin $TWIKIROOT/bin=
		* Merge the changes in your current =wikicfg.pm= into the new =wikicfg.pm=. We suggest using =diff -c= to compare the two files if you have made heavy changes to the file, i.e.
		  <br> =diff -c $TWIKIROOT/bin.old/wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less=
		* Restore any additional scripts you might have from the old directory, i.e.
		  <br> =mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/=
		  <br> (Note that the =changes= script is obsolete.)
		* In case you have basic authentication:
			* The =TWikiRegistration= topic moved from the TWiki.Main web to the TWiki.TWiki web. Change =.htaccess= to reflect the new location, i.e.
			 <br> =ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration=
		* Pay attention to the file and directory permissions (security issue)
		* Test your TWiki installation if you can view topics. (Ignore the =%<nop>HTTP_EQUIV_ON_VIEW%= you see on top of the topic; this will disappear after upgrading the template files.

	* __Upgrade template files__ ( =twiki/templates= )
		* Rename your original =twiki/templates= directory, i.e.
		  <br> =mv $TWIKIROOT/templates $TWIKIROOT/templates.old=
		* Move the new templates to your original =twiki/templates= location, i.e.
		  <br> =mv ~/tmp/templates $TWIKIROOT/templates=
		* Merge the changes in your current template files into the new template files. To compare two files use
		  <br> =diff -c $TWIKIROOT/templates.old/view.tmpl $TWIKIROOT/templates/view.tmpl | less=
		* Restore any additional template subdirectories of your TWiki webs you might have and merge the changes.
		* Test your TWiki installation if you can view topics.

	* __Upgrade public files__ ( =twiki/pub= )
		* Move the new =twiki/pub/TWiki= directory to your installation, i.e.
		  <br> =mv ~/tmp/pub/TWiki $TWIKIROOT/pub/=
		* Pay attention to the file permissions of the =TWiki= directory and its subdirectory and files. The files must be writable by the cgi-scripts (usually user "nobody")
		* Move the new =twiki/pub/twikilogo*= image files to your installation, i.e.
		  <br> =mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/=

	* __Upgrade data files__ ( =twiki/data= )
		* Move the new =twiki/data/TWiki= directory to your installation, i.e.
		  <br> =mv ~/tmp/data/TWiki $TWIKIROOT/data/=
		  <br> Pay attention to the file permissions of the =TWiki= directory and its files. The files must be writable by the cgi-scripts (usually user "nobody")
		* Optionally move the new =twiki/data/Test= directory to your installation, i.e.
		  <br> =mv ~/tmp/data/Test $TWIKIROOT/data/=
		  <br> (Pay attention to the file permissions)
		* Move these new TWiki.Main web topics to your TWiki.Main web: =TWikiGroups=, =TWikiAdminGroup=, and if needed also =OfficeLocations= , i.e.
		  <br> =mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main=
		  <br> (Pay attention to the file permissions)
		* The following topics in the TWiki.Main web are obsolete and can be deleted: =BillClinton=, =GoodStyle=, =RegularExpression=, =TextFormattingFAQ=, =TextFormattingRules=, =ManagingWebs=, =TWikiCategoryTable=, =TWikiEnhancementRequests=, =TWikiImplementationNotes=, =TWikiInstallationGuide=, =WebNotification=, =TWikiPlannedFeatures=, =TWikiUpgradeTo01May2000=, =TWikiUsernameVsLoginUsername=, =TWikiSite=, =WelcomeGuest=, =WelcomeVisitor=, =WikiName=, =WikiNotation=, =WikiTopic=, =WikiWikiClones=. Sample delete command:
		  <br> =rm -f $TWIKIROOT/data/Main/BillClinton.*=
		* The following topics are new and most be copied to all of your TWiki webs: =WebChanges=, =WebIndex=.
		  <br> =cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main=
		  <br> =cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main=
		  <br> Repeat this for all your webs. Pay attention to the file permissions.
		* =TWikiRegistration= moved from TWiki.Main to TWiki.TWiki. In case you customized =TWikiRegistration= , merge your changes back into =TWiki.TWikiRegistration= , then delete =$TWIKIROOT/data/Main/TWikiRegistration*=.
		* =TWikiPreferences= moved from TWiki.Main to TWiki.TWiki. Merge your changes to =TWikiPreferences= into =TWiki.TWikiPreferences=.
		* Modify the =WebPreferences= topics in all your webs to reflect the following:
			* =WEBTOPICLIST= should use =WebChanges= for ="Changes"=, and =WebIndex= for ="Index"=, i.e.
			  <br> =| &lt;a href="WebChanges"&gt;Changes&lt;/a&gt;=
			  <br> =| &lt;a href="WebIndex"&gt;Index&lt;/a&gt;=
			* In case you want to exclude a web from a =web="all"= search: Set this new preference
			  <br> =Set NOSEARCHALL = on=
		* The =WebSearch= topic has considerable changes. Copy the one from =TWiki.TWiki= into all webs, or merge them if you made changes. To copy, do an edit-copy-edit-paste operation.
		* Change the =WebHome= topics in all your webs to reflect these changes:
			1. The "Changes" link should point to =WebChanges=.
			2. The "Topic index" link should point to =WebIndex=.
			3. Change the include of the web table to =%<nop>INCLUDE{"%<nop>TWIKIWEB%.TWikiWebsTable"}%=
		* Merge your =TWikiWebsTable= topic in TWiki.Main with the =TWikiWebsTable= topic in TWiki.TWiki. Note the new variable to query the color of a web. Delete the old =TWikiWebsTable= topic in TWiki.Main after merge is complete.
		* The following topics in the TWiki.Main web are deprecated (because they moved to TWiki.TWiki), but still need to be present in TWiki.Main because of existing links to them: =FileAttachment=, =TWikiDocumentation=, =TWikiHistory=, =TWikiPreferences=, =TWikiVariables=.
		  <br> It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
		  <br> =This topic moved to %<nop>TWIKIWEB%.%<nop>TOPIC% in the %<nop>WIKITOOLNAME%.%<nop>TWIKIWEB% web.=
		* In all your webs, change references to topics that moved to the TWiki.TWiki web:
			* Change topics: =TWikiUsers= , =WebNotify= , =WebHome=
			* With links to: =TWikiPreferences= , =TWikiVariables= , =TWikiUsers= , =TWikiWebsTable= and =WelcomeGuest=

	* __TWiki Access Control__
		* Read TWikiAccessControl, in case you want to use the new authorization feature based on groups.

	* __Known Issues__
		* Check http://TWiki.org/cgi-bin/view/Codev/KnownIssuesOfTWiki01Dec2000 for known issues of TWiki 01 Dec 2000 (production release) 

-- Main.PeterThoeny - 08 Nov 2000 <br>
@


1.14
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999319954" format="1.0" version="1.14"}%
d71 1
a71 1
		* The following topics in the TWiki.Main web are obsolete and can be deleted: =BillClinton=, =GoodStyle=, =RegularExpression=, =TextFormattingFAQ=, =TextFormattingRules=, =TWikiAdministration=, =TWikiCategoryTable=, =TWikiEnhancementRequests=, =TWikiImplementationNotes=, =TWikiInstallationGuide=, =TWikiNotificationOfChanges=, =TWikiPlannedFeatures=, =TWikiUpgradeTo01May2000=, =TWikiUsernameVsLoginUsername=, =TWikiSite=, =WelcomeGuest=, =WelcomeVisitor=, =WikiName=, =WikiNotation=, =WikiTopic=, =WikiWikiClones=. Sample delete command:
@


1.13
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MikeMannix" date="999166913" format="1.0" version="1.13"}%
d4 1
a4 1
If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first. For the latest version read TWikiUpgradeNotes.
d71 1
a71 1
		* The following topics in the TWiki.Main web are obsolete and can be deleted: =BillClinton=, =GoodStyle=, =RegularExpression=, =TextFormattingFAQ=, =TextFormattingRules=, =TWikiAdministration=, =TWikiCategoryTable=, =TWikiEnhancementRequests=, =TWikiImplementationNotes=, =TWikiInstallationNotes=, =TWikiNotificationOfChanges=, =TWikiPlannedFeatures=, =TWikiUpgradeTo01May2000=, =TWikiUsernameVsLoginUsername=, =TWikiSite=, =WelcomeGuest=, =WelcomeVisitor=, =WikiName=, =WikiNotation=, =WikiTopic=, =WikiWikiClones=. Sample delete command:
@


1.12
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="998728738" format="1.0" version="1.12"}%
d71 1
a71 1
		* The following topics in the TWiki.Main web are obsolete and can be deleted: =BillClinton=, =GoodStyle=, =RegularExpression=, =TextFormattingFAQ=, =TextFormattingRules=, =TWikiAdministration=, =TWikiCategoryTable=, =TWikiEnhancementRequests=, =TWikiImplementationNotes=, =TWikiInstallationNotes=, =TWikiNotificationOfChanges=, =TWikiPlannedFeatures=, =TWikiUpgradeTo01May2000=, =TWikiUsernameVsLoginUsername=, =TWikiWeb=, =WelcomeGuest=, =WelcomeVisitor=, =WikiName=, =WikiNotation=, =WikiTopic=, =WikiWikiClones=. Sample delete command:
a104 1
%META:TOPICMOVED{by="PeterThoeny" date="998728738" from="TWiki.TWikiUpgradeTo01Dec2001" to="TWiki.TWikiUpgradeTo01Dec2000"}%
@


1.11
log
@none
@
text
@d1 2
a2 1
---## TWiki Upgrade Notes
d4 1
a4 3
(The following upgrade notes apply to the 01 Dec 2000 release. The upgrade notes of this Beta release is pending.)

If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
d105 1
@


1.10
log
@none
@
text
@d1 4
@


1.9
log
@none
@
text
@d30 1
a30 1
		* Merge the changes in your current =wikicfg.pm= into the new =wikicfg.pm=. We suggest using =diff -c= to compared the two files if you have made heavy changes to the file, i.e.
d39 1
a39 1
		* Test your TWiki installation if you can view topics. (Ignore the =%<nop>HTTP_EQUIV_ON_VIEW%= you see on top of the topic, this will disappear after upgrading the template files.
d41 1
a41 1
	* __Upgrade templates files__ ( =twiki/templates= )
d88 2
a89 2
		* The following topics in the TWiki.Main web are depreciated (because they moved to TWiki.TWiki), but still need to be present in TWiki.Main because of existing links to them: =FileAttachment=, =TWikiDocumentation=, =TWikiHistory=, =TWikiPreferences=, =TWikiVariables=.
		  <br> It is recommended to edit these topics in TWiki.Main and replace the content with this line:
d96 1
a96 1
		* Read TWikiAccessControl in case you want to use the new authorization feature based on groups.
@


1.8
log
@none
@
text
@d13 3
a15 1
	* Unpack the beta zip file into some working directory:
d18 1
a18 1
	  <br> =unzip ~/TWiki20001105.zip=
d55 2
d61 9
a69 1
		* Pay attention to the file permissions of the =TWiki= directory and its files. The files must be writable by the cgi-scripts (usually user "nobody")
d75 1
a75 1
		* =TWikiPreferences= moved from TWiki.Main to TWiki.TWiki. Merge your changes to =TWikiPreferences= into =TWiki.TWikiPreferences=, then delete =$TWIKIROOT/data/Main/TWikiPreferences*=.
d86 1
a86 1
			3. Change the include of the web table to =%<nop>INCLUDE{"TWiki.TWikiWebsTable"}%=
d88 1
a88 1
		* The following topics in the TWiki.Main web are depreciated (because they moved to TWiki.TWiki), but still need to be present in TWiki.Main because of existing links to these topics: =FileAttachment=, =TWikiDocumentation=, =TWikiHistory=, =TWikiPreferences=, =TWikiVariables=.
a90 2
		* The following topics in the TWiki.Main web are obsolete and can be deleted: =BillClinton=, =GoodStyle=, =RegularExpression=, =TextFormattingFAQ=, =TextFormattingRules=, =TWikiAdministration=, =TWikiCategoryTable=, =TWikiEnhancementRequests=, =TWikiImplementationNotes=, =TWikiInstallationNotes=, =TWikiNotificationOfChanges=, =TWikiPlannedFeatures=, =TWikiUpgradeTo01May2000=, =TWikiUsernameVsLoginUsername=, =TWikiWeb=, =WelcomeGuest=, =WelcomeVisitor=, =WikiName=, =WikiNotation=, =WikiTopic=, =WikiWikiClones=. Sample delete command:
		  <br> =rm -f $TWIKIROOT/data/Main/BillClinton.*=
@


1.7
log
@none
@
text
@d3 1
a3 1
The current release has these changes that affect the upgrade of the 01 May 2000 version:
d9 3
a11 1
These are the steps you need to perform to upgrade the 01 May 2000 version to this release: [ We assume =export TWIKIROOT=/some/dir/= ]
d89 1
a89 1
		* Check http://TWiki.SourceForge.net/cgi-bin/view/Codev/KnownIssuesOfTWiki05Nov2000 for known issues of TWiki 05 Nov 2000 (production release) 
d91 1
a91 1
-- Main.PeterThoeny - 03 Nov 2000 <br>
@


1.6
log
@none
@
text
@d3 1
a3 1
The current Beta version has these changes affecting the upgrade of the 01 May 2000 version:
d9 1
a9 1
These are the steps you need to perform to upgrade the 01 May 2000 version to Beta: [ We assume =export TWIKIROOT=/some/dir/= ]
d14 1
a14 1
	  <br> =unzip ~/TWiki20001101beta.zip=
a27 1
		* In =wikicfg.pm=, change =$wikiToolName= from ="TWikibeta"= to ="TWiki"=.
d68 1
a68 1
		* The =WebSearch= topics has considerable changes. Copy the one from =TWiki.TWiki= into all webs, or merge them if you made changes. To copy, do an edit-copy-edit-paste operation.
d73 1
a73 2
		* Move your =TWikiWebsTable= topic from TWiki.Main to TWiki.TWiki., i.e.
		  <br> =mv $TWIKIROOT/data/Main/TWikiWebsTable* $TWIKIROOT/data/TWiki=
d83 7
a89 1
-- Main.PeterThoeny - 02 Nov 2000 <br>
@


1.5
log
@none
@
text
@d14 1
a14 1
	  <br> =unzip ~/TWiki20000909beta.zip=
d85 1
a85 1
-- Main.PeterThoeny - 09 Sep 2000 <br>
@


1.4
log
@none
@
text
@d3 1
a3 1
| UNDER CONSTRUCTION |
d5 5
a9 1
These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version: [ We assume <pre>export TWIKIROOT=/some/dir/</pre>
d12 72
a83 42
<pre>
  mkdir -p ~/tmp/
  cd ~/tmp
  unzip ~/TWiki20000818beta.zip
</pre>

	* Merge and changes in your current wikicfg.pm into the new =wikicfg.pm=.  We suggest using =diff -c= to compared the two files if you have made heavy changes to the file:
<pre>
	diff -c wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less
</pre>

	* Create and populate the TWiki directory below the data directory.
<pre>
  cd $TWIKIROOT/data/
  mkdir TWiki
  cp ~/tmp/data/TWiki/* TWiki/
</pre>

	* Delete the following files in your TWiki.Main installation:
		* =BillClinton= , =GoodStyle= , =RegularExpression= , =TextFormattingFAQ= , =TextFormattingRules= , =TWikiAdministration= , =TWikiCategoryTable= , =TWikiDocumentation= , =TWikiEnhancementRequests= , =TWikiHistory= , =TWikiImplementationNotes= , =TWikiInstallationNotes= , =TWikiNotificationOfChanges= , =TWikiPlannedFeatures= , =TWikiPreferences= , =TWikiUpgradeTo01May2000= , =TWikiUsernameVsLoginUsername= , =TWikiVariables= , =TWikiWeb= , =WelcomeGuest= , =WikiName= , =WikiNotation= , =WikiTopic= , =WikiWikiClones=

<pre>
  cd $TWIKIROOT/data/Main
  rm -f BillClinton* GoodStyle* RegularExpression* TextFormattingFAQ* \
		TextFormattingRules* TWikiAdministration=* TWikiCategoryTable*  \
		TWikiDocumentation* TWikiEnhancementRequests* TWikiHistory* \
		TWikiImplementationNotes TWikiInstallationNotes* TWikiNotificationOfChanges* \
		TWikiPlannedFeatures* TWikiPreferences* TWikiUpgradeTo01May2000*  \
		TWikiUsernameVsLoginUsername* TWikiVariables* TWikiWeb* WelcomeGuest* \
		WikiName* WikiNotation* WikiTopic* WikiWikiClones*
</pre>



	* In all your webs, change references to topics that moved to the TWiki.TWiki web:
		* Change topics: =TWikiUsers= , =WebNotify= , =WebHome=
		* With links to: =TWikiPreferences= , =TWikiVariables= , =TWikiUsers= , =TWikiWebsTable= , =WelcomeGuest=
	* Move your =TWikiWebsTable= topic to TWiki.TWiki.
	* Merge your changes to =TWikiPreferences= into =TWiki.TWikiPreferences= , then delete =Main.TWikiPreferences=
	* In case you customized =TWikiRegistration= , merge your changes back into =TWiki.TWikiRegistration= , then delete =Main.TWikiRegistration= .
	* In case you have authentication: Change =.htaccess= to reflect the new location of the =TWikiRegistration= , i.e. <br> =ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration=

d85 1
a85 1
-- Main.PeterThoeny - 20 Aug 2000 <br>
@


1.3
log
@none
@
text
@d5 1
a5 1
These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version:
d7 1
a7 1
	* Create a TWiki directory below the data directory.
d9 15
d28 14
@


1.2
log
@none
@
text
@d1 2
d8 3
a20 2
See also:
	* TWikiUpgradeTo01May2000
@


1.1
log
@none
@
text
@d1 2
@
