Difference: TWikiUpgradeTo01Dec2000 (1 vs. 15)

Revision 1501 Sep 2001 - Main.MikeMannix

 

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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %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.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (Pay attention to the file permissions)
Changed:
<
<
    • 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:
>
>
    • 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:
 
rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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.

-- PeterThoeny - 08 Nov 2000

Revision 1401 Sep 2001 - Main.MikeMannix

 

TWiki Upgrade Notes for Version 01 May 2000

Changed:
<
<		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?.
>
>		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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %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.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (Pay attention to the file permissions)
Changed:
<
<
    • 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:
>
>
    • 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:
 
rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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.

-- PeterThoeny - 08 Nov 2000

Revision 1330 Aug 2001 - Main.MikeMannix

 

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 TWikiUpgradeNotes?.

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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %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.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (Pay attention to the file permissions)
Changed:
<
<
    • 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:
>
>
    • 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:
 
rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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.

-- PeterThoeny - 08 Nov 2000

Deleted:
<
<
META TOPICMOVED by="PeterThoeny" date="998728738" from="TWiki.TWikiUpgradeTo01Dec2001" to="TWiki.TWikiUpgradeTo01Dec2000"
 

Revision 1225 Aug 2001 - Main.PeterThoeny

Added:
>
>

TWiki Upgrade Notes for Version 01 May 2000

 
Changed:
<
<		(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. For the latest version read TWikiUpgradeNotes?.
 
Deleted:
<
<		If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
 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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %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.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (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, TWikiAdministration, TWikiCategoryTable, TWikiEnhancementRequests, TWikiImplementationNotes, TWikiInstallationNotes, TWikiNotificationOfChanges, TWikiPlannedFeatures, TWikiUpgradeTo01May2000, TWikiUsernameVsLoginUsername, TWikiWeb, WelcomeGuest, WelcomeVisitor, WikiName, WikiNotation, WikiTopic, WikiWikiClones. Sample delete command:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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.

-- PeterThoeny - 08 Nov 2000

Added:
>
>
META TOPICMOVED by="PeterThoeny" date="998728738" from="TWiki.TWikiUpgradeTo01Dec2001" to="TWiki.TWikiUpgradeTo01Dec2000"
 

Revision 1116 Mar 2001 - Main.PeterThoeny

Added:
>
>

TWiki Upgrade Notes

(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.

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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %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.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (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, TWikiAdministration, TWikiCategoryTable, TWikiEnhancementRequests, TWikiImplementationNotes, TWikiInstallationNotes, TWikiNotificationOfChanges, TWikiPlannedFeatures, TWikiUpgradeTo01May2000, TWikiUsernameVsLoginUsername, TWikiWeb, WelcomeGuest, WelcomeVisitor, WikiName, WikiNotation, WikiTopic, WikiWikiClones. Sample delete command:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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.

-- PeterThoeny - 08 Nov 2000

Revision 1010 Dec 2000 - Main.PeterThoeny

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

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:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001201.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
Changed:
<
<
    • 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.
>
>
    • 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.
 
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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration
    • Pay attention to the file and directory permissions (security issue)
Changed:
<
<
    • Test your TWiki installation if you can view topics. (Ignore the %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.
>
>
    • Test your TWiki installation if you can view topics. (Ignore the %HTTP_EQUIV_ON_VIEW% you see on top of the topic; this will disappear after upgrading the template files.
 
Changed:
<
<
  • Upgrade templates files ( twiki/templates )
>
>
  • Upgrade template files ( twiki/templates )
 
    • Rename your original twiki/templates directory, i.e.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
      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.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (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, TWikiAdministration, TWikiCategoryTable, TWikiEnhancementRequests, TWikiImplementationNotes, TWikiInstallationNotes, TWikiNotificationOfChanges, TWikiPlannedFeatures, TWikiUpgradeTo01May2000, TWikiUsernameVsLoginUsername, TWikiWeb, WelcomeGuest, WelcomeVisitor, WikiName, WikiNotation, WikiTopic, WikiWikiClones. Sample delete command:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"%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.
Changed:
<
<
    • 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.
      It is recommended to edit these topics in TWiki.Main and replace the content with this line:
>
>
    • 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.
      It is recommended that you edit these topics in TWiki.Main and replace the content with this line:
 
This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%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
Changed:
<
<
    • Read TWikiAccessControl in case you want to use the new authorization feature based on groups.
>
>
    • Read TWikiAccessControl, in case you want to use the new authorization feature based on groups.
 

-- PeterThoeny - 08 Nov 2000

Revision 916 Nov 2000 - Main.PeterThoeny

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

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/ ]

Changed:
<
<
  • Unpack the beta zip file into some working directory:
>
>
  • Backup all existing TWiki directories ( bin, pub, data, templates )
Added:
>
>
  • Unpack the zip file into some working directory:
 
mkdir -p ~/tmp/
cd ~/tmp
Changed:
<
<
unzip ~/TWiki20001105.zip
>
>
unzip ~/TWiki20001201.zip
 
  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
    • 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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.

  • Upgrade templates files ( twiki/templates )
    • Rename your original twiki/templates directory, i.e.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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")
Added:
>
>
    • Move the new twiki/pub/twikilogo* image files to your installation, i.e.
      mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/
 
  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
Changed:
<
<
    • 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")
>
>
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")
Added:
>
>
    • Optionally move the new twiki/data/Test directory to your installation, i.e.
      mv ~/tmp/data/Test $TWIKIROOT/data/
      (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.
      mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main
      (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, TWikiAdministration, TWikiCategoryTable, TWikiEnhancementRequests, TWikiImplementationNotes, TWikiInstallationNotes, TWikiNotificationOfChanges, TWikiPlannedFeatures, TWikiUpgradeTo01May2000, TWikiUsernameVsLoginUsername, TWikiWeb, WelcomeGuest, WelcomeVisitor, WikiName, WikiNotation, WikiTopic, WikiWikiClones. Sample delete command:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
 
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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*.
Changed:
<
<
    • TWikiPreferences moved from TWiki.Main to TWiki.TWiki. Merge your changes to TWikiPreferences into TWiki.TWikiPreferences, then delete $TWIKIROOT/data/Main/TWikiPreferences*.
>
>
    • 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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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.
Changed:
<
<
      1. Change the include of the web table to %INCLUDE{"TWiki.TWikiWebsTable"}%
>
>
      1. Change the include of the web table to %INCLUDE{"%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.
Changed:
<
<
    • 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.
>
>
    • 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.
 
It is recommended to edit these topics in TWiki.Main and replace the content with this line:
This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.
Deleted:
<
<
    • 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:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
 
    • 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.

-- PeterThoeny - 08 Nov 2000

Revision 808 Nov 2000 - Main.PeterThoeny

 If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
Changed:
<
<		The current release has these changes that affect the upgrade of the 01 May 2000 version:
>
>		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.
Changed:
<
<		These are the steps you need to perform to upgrade the 01 May 2000 version to this release: [ We assume export TWIKIROOT=/some/dir/ ]
>
>		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.
 
Added:
>
>		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/ ]
 
  • Unpack the beta zip file into some working directory:
    mkdir -p ~/tmp/
    cd ~/tmp
    unzip ~/TWiki20001105.zip

  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
    • 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.
      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.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.

  • Upgrade templates files ( twiki/templates )
    • Rename your original twiki/templates directory, i.e.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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")

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
    • 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")
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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, then delete $TWIKIROOT/data/Main/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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        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 %INCLUDE{"TWiki.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 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.
      It is recommended to edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.
    • 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:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • 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
Changed:
<
<
>
>
 
Changed:
<
<		-- PeterThoeny - 03 Nov 2000
>
>		-- PeterThoeny - 08 Nov 2000
 

Revision 704 Nov 2000 - Main.PeterThoeny

 If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
Changed:
<
<		The current Beta version has these changes affecting the upgrade of the 01 May 2000 version:
>
>		The current 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.
Changed:
<
<		These are the steps you need to perform to upgrade the 01 May 2000 version to Beta: [ We assume export TWIKIROOT=/some/dir/ ]
>
>		These are the steps you need to perform to upgrade the 01 May 2000 version to this release: [ We assume export TWIKIROOT=/some/dir/ ]
 
  • Unpack the beta zip file into some working directory:
    mkdir -p ~/tmp/
    cd ~/tmp
Changed:
<
<
unzip ~/TWiki20001101beta.zip
>
>
unzip ~/TWiki20001105.zip
 
  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
    • 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.
      diff -c $TWIKIROOT/bin.old/wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less
Deleted:
<
<
    • In wikicfg.pm, change $wikiToolName from "TWikibeta" to "TWiki".
 
    • Restore any additional scripts you might have from the old directory, i.e.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.

  • Upgrade templates files ( twiki/templates )
    • Rename your original twiki/templates directory, i.e.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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")

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
    • 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")
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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, then delete $TWIKIROOT/data/Main/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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        Set NOSEARCHALL = on
Changed:
<
<
    • 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.
>
>
    • 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 %INCLUDE{"TWiki.TWikiWebsTable"}%
Changed:
<
<
    • Move your TWikiWebsTable topic from TWiki.Main to TWiki.TWiki., i.e.
>
>
    • 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.
Deleted:
<
<
mv $TWIKIROOT/data/Main/TWikiWebsTable* $TWIKIROOT/data/TWiki
 
    • 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.
      It is recommended to edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.
    • 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:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • 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
Changed:
<
<		-- PeterThoeny - 02 Nov 2000
>
>
  • TWiki Access Control
Added:
>
>
    • Read TWikiAccessControl in case you want to use the new authorization feature based on groups.

-- PeterThoeny - 03 Nov 2000

 

Revision 602 Nov 2000 - Main.PeterThoeny

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

The current Beta version has these changes affecting 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.

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

  • Unpack the beta zip file into some working directory:
    mkdir -p ~/tmp/
    cd ~/tmp
Changed:
<
<
unzip ~/TWiki20000909beta.zip
>
>
unzip ~/TWiki20001101beta.zip
 
  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT

  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
    • 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.
      diff -c $TWIKIROOT/bin.old/wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less
    • In wikicfg.pm, change $wikiToolName from "TWikibeta" to "TWiki".
    • Restore any additional scripts you might have from the old directory, i.e.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.

  • Upgrade templates files ( twiki/templates )
    • Rename your original twiki/templates directory, i.e.
      mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
      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")

  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
    • 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")
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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, then delete $TWIKIROOT/data/Main/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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        Set NOSEARCHALL = on
    • 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.
    • 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 %INCLUDE{"TWiki.TWikiWebsTable"}%
    • Move your TWikiWebsTable topic from TWiki.Main to TWiki.TWiki., i.e.
      mv $TWIKIROOT/data/Main/TWikiWebsTable* $TWIKIROOT/data/TWiki
    • 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.
      It is recommended to edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.
    • 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:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • 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
Changed:
<
<		-- PeterThoeny - 09 Sep 2000
>
>		-- PeterThoeny - 02 Nov 2000
 

Revision 509 Sep 2000 - Main.PeterThoeny

 If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
Changed:
<
<
UNDER CONSTRUCTION
>
>		The current Beta version has these changes affecting the upgrade of the 01 May 2000 version:
 
Changed:
<
<		These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version: [ We assume 
export TWIKIROOT=/some/dir/
>
>
  • Improved search, i.e. search multiple webs.
Added:
>
>
  • 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.
 
Added:
>
>		These are the steps you need to perform to upgrade the 01 May 2000 version to Beta: [ We assume export TWIKIROOT=/some/dir/ ]
 
  • Unpack the beta zip file into some working directory:
Changed:
<
<
  mkdir -p ~/tmp/
  cd ~/tmp
>
>
mkdir -p ~/tmp/
cd ~/tmp
unzip ~/TWiki20000909beta.zip
Deleted:
<
<		 unzip ~/TWiki20000818beta.zip
 
Changed:
<
<
  • 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: 
	diff -c wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less
>
>
  • Upgrade the TWiki document files ( twiki )
    • Move the document files to your TWiki root, i.e.
      mv ~/tmp/TWiki*.html $TWIKIROOT
      mv ~/tmp/readme.txt $TWIKIROOT
 
Changed:
<
<
  • Create and populate the TWiki directory below the data directory. 
  cd $TWIKIROOT/data/
  mkdir TWiki
  cp ~/tmp/data/TWiki/* TWiki/
>
>
  • Upgrade cgi-bin scripts ( twiki/bin )
    • Rename your original twiki/bin directory, i.e.
      mv $TWIKIROOT/bin $TWIKIROOT/bin.old
    • Move the new scripts to your original twiki/bin location, i.e.
      mv ~/tmp/bin $TWIKIROOT/bin
    • 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.
Added:
>
>
diff -c $TWIKIROOT/bin.old/wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less
    • In wikicfg.pm, change $wikiToolName from "TWikibeta" to "TWiki".
    • Restore any additional scripts you might have from the old directory, i.e.
      mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/
      (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.
        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 %HTTP_EQUIV_ON_VIEW% you see on top of the topic, this will disappear after upgrading the template files.
 
Changed:
<
<
  • 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
>
>
  • Upgrade templates files ( twiki/templates )
    • Rename your original twiki/templates directory, i.e.
Added:
>
>
mv $TWIKIROOT/templates $TWIKIROOT/templates.old
    • Move the new templates to your original twiki/templates location, i.e.
      mv ~/tmp/templates $TWIKIROOT/templates
    • Merge the changes in your current template files into the new template files. To compare two files use
      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.
 
Changed:
<
<
  cd $TWIKIROOT/data/Main
  rm -f BillClinton* GoodStyle* RegularExpression* TextFormattingFAQ* \
		TextFormattingRules* TWikiAdministration=* TWikiCategoryTable*  \
>
>
  • Upgrade public files ( twiki/pub )
    • Move the new twiki/pub/TWiki directory to your installation, i.e.
      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")
Deleted:
<
<		 TWikiDocumentation* TWikiEnhancementRequests* TWikiHistory* TWikiImplementationNotes? TWikiInstallationNotes?* TWikiNotificationOfChanges?* TWikiPlannedFeatures* TWikiPreferences* TWikiUpgradeTo01May2000* TWikiUsernameVsLoginUsername* TWikiVariables* TWikiWeb?* WelcomeGuest* WikiName* WikiNotation* WikiTopic* WikiWikiClones*
 
Added:
>
>
  • Upgrade data files ( twiki/data )
    • Move the new twiki/data/TWiki directory to your installation, i.e.
      mv ~/tmp/data/TWiki $TWIKIROOT/data/
    • 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")
    • The following topics are new and most be copied to all of your TWiki webs: WebChanges, WebIndex.
      cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main
      cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main
      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, then delete $TWIKIROOT/data/Main/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.
        | <a href="WebChanges">Changes</a>
        | <a href="WebIndex">Index</a>
      • In case you want to exclude a web from a web="all" search: Set this new preference
        Set NOSEARCHALL = on
    • 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.
    • 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 %INCLUDE{"TWiki.TWikiWebsTable"}%
    • Move your TWikiWebsTable topic from TWiki.Main to TWiki.TWiki., i.e.
      mv $TWIKIROOT/data/Main/TWikiWebsTable* $TWIKIROOT/data/TWiki
    • 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.
      It is recommended to edit these topics in TWiki.Main and replace the content with this line:
      This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.
    • 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:
      rm -f $TWIKIROOT/data/Main/BillClinton.*
    • 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
 
Changed:
<
<
>
>		-- PeterThoeny - 09 Sep 2000
Deleted:
<
<
  • 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.
    ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration

-- PeterThoeny - 20 Aug 2000

 

Revision 428 Aug 2000 - Main.NicholasLee

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

UNDER CONSTRUCTION
Changed:
<
<		These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version:
>
>		These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version: [ We assume 
export TWIKIROOT=/some/dir/
 
Changed:
<
<
  • Create a TWiki directory below the data directory.
>
>
  • Unpack the beta zip file into some working directory:
 
Added:
>
>		 mkdir -p ~/tmp/ cd ~/tmp unzip ~/TWiki20000818beta.zip
 
Added:
>
>
  • 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: 
	diff -c wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less

  • Create and populate the TWiki directory below the data directory. 
  cd $TWIKIROOT/data/
  mkdir TWiki
  cp ~/tmp/data/TWiki/* TWiki/
 
  • 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
Added:
>
>
  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*

 
  • 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.
    ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration

-- PeterThoeny - 20 Aug 2000

Revision 328 Aug 2000 - Main.NicholasLee

Added:
>
>		If you are coming from a version earlier than the 01 May 2000 production release, please see TWikiUpgradeTo01May2000 first.
 
UNDER CONSTRUCTION

These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version:

  • Create a TWiki directory below the data directory.
Added:
>
>
  
    

  •  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

     

    •  
  •  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. 
     ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration

 
 Deleted: 
<
<		See also:  
 -- PeterThoeny - 20 Aug 2000 
Revision 221 Aug 2000 - Main.PeterThoeny


 Added: 
>
>		

 UNDER CONSTRUCTION 


 These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version:

 
    

  •  Create a TWiki directory below the data directory.

    •  
  •  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

     

    •  
  •  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. 
     ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration

 


See also: 
 


-- PeterThoeny - 20 Aug 2000 
Revision 120 Aug 2000 - Main.PeterThoeny


 These are the steps you need to perform to upgrade the 01 May 2000 version to the current Beta version:

 
    

  •  Create a TWiki directory below the data directory.

    •  
  •  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

     

    •  
  •  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. 
     ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration

 


See also: 
 


-- PeterThoeny - 20 Aug 2000 

 
 View topic
  |  History:  r15 < r14 < r13 < r12
  |  More topic actions...








 


 Copyright   © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
 Ideas, requests, problems regarding this intranet,  Send feedback 
 Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiUpgradeTo01Dec2000