NOTE: This is a HistoricalDocument topic. It used to be distributed in an earlier TWiki release, but is no longer part of the official TWiki distribution. Post questions, error notes, and suggestions concerning the documentation of this topic in the comments section below! Use the Support web for problems you are having using TWiki.

NOTE: This is a SupplementalDocument topic which is not included with the official TWiki distribution. Please help maintain high quality documentation by fixing any errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below! Use the Support web for problems you are having using TWiki.

To upgrade an earlier TWiki version like 01 Sep 1999 to version 01 May 2000 you should do the following things:

• Back up your system.
• Update the templates in the /templates directory (and its subdirs):
  • Take the templates of the latest distribution as the base and merge your changes back into it.
• Update the Perl scripts in the /bin directory:
  • Take the scripts of the latest distribution as the base and merge your changes back into it. Do so also for wikicfg.pm because it has important changes as well.
• Update topics:
  • Copy the new Main. TWikiPreferences topic (and *,v file) into your TWiki.Main web. Customize the topic to your needs.
  • Copy the new Main. WebPreferences, WebStatistics topics (and *,v files) into all your webs. Customize all WebPreferences topics to your needs (e.g. web color).
  • Copy WebSearch into all your webs, or modify the existing ones. Reason: Some switches for search changed.
  • Copy the TWiki documentation into your Main web: Topics TWikiDocumentation, TWikiUsernameVsLoginUsername, TWikiVariables, MonitoringSiteActivity, TWikiCategoryTable, TWikiImplementationNotes, TWikiInstallationGuide, TWikiUpgradeTo01May2000, TextFormattingRules, TWikiHistory .
  • Copy the registration topic into your Main web:
    • In case you are on an Intranet: Copy topic TWikiRegistration to Main.TWikiRegistration. Customize if needed.
    • In case you are on a public server: Copy topic TWikiRegistrationPub to Main.TWikiRegistration. Customize if needed.
  • Copy the Main. TWikiWebsTable topic (and *,v file) into your Main web and customize it. Reason: The new release does not use the *.inc include files anymore.
  • Optionally: Search for %INCLUDE%'s in all your webs and change them to the new %INCLUDE{"file.ext"}% syntax. Note: Your old %INCLUDE:"file.ext"% syntax still works (the legacy rule is defined in wikicfg.pm .)
• Add the PoweredByTWikiLogo if TWiki is installed on a public web server.

-- PeterThoeny - 28 Apr 2000

Comments & Questions about this Supplemental Document Topic