Difference: TWikiUpgradeGuide (2 vs. 3)

Revision 32005-09-22 - TWikiContributor

Line: 1 to 1
 

TWiki Upgrade Guide

Line: 51 to 51
 
  • Choose a directory for the new installation. I will call this new_twiki. This directory must not already exist.
  • Change directory to distro/ and run:
    ./UpgradeTwiki <full path to existing_twiki's setlib.cfg> <full path to new_twiki>
Changed:
<
<
  • confirm your system settings by pointing your browser to cgi-bin/configure
>
>
  • confirm your system settings by pointing your browser to the configure script
  Assuming all goes well, UpgradeTwiki will give you the final instructions.
Line: 64 to 64
 
    • Clearly you need to point it to a location where there is enough space
    • If you have symlinks under your data/ directory in your existing installation, these are reproduced as actual directories in the new structure. It is up to you to pull these sub-directories out again and re-symlink as needed
  • UpgradeTwiki doesn't deal with custom templates or Plugins, you will have to reinstall these in the new installation.
Added:
>
>
  • If you are using the Htpasswd login manager, then note that email addresses for users have moved out of user topics and into the password database. There is a script that performs this extra upgrade step for you - see tools/upgrade_emails.pl.
 
Deleted:
<
<
If you use it, and would be kind enough to add your experiences to TWiki:Codev.UpgradeTWiki, it would be much appreciated. The report of your experience will help to make UpgradeTwiki more robust.
 

Manual Upgrade Procedure

Line: 87 to 87
 
    1. Install updated plugins into your new area.
  1. Point your webserver at the new install.
  2. Visit TWiki:Codev.KnownIssuesOfTWiki04x00x00 and fix known issues that apply to you.
Added:
>
>
  1. If you are using the Htpasswd login manager, then note that email addresses for users have moved out of user topics and into the password database. There is a script that performs this extra upgrade step for you - see tools/upgrade_emails.pl.
  You are highly recommended not to change any distributed files if you can avoid it, to simplify future upgrades!
Line: 94 to 95
 If you followed the recommendations and avoided modifying any distributed files, then this is quite straightforward:
  1. Follow the installation instructions, and install the new release in a new directory.
  2. Copy your local webs over to the data and pub directories of the new install
Changed:
<
<
  1. Copy over your bin/setlib.cfg and lib/LocalLib.cfg files
>
>
    • Be careful to copy over the user topics and TWikiUsers.txt in the Main web
  1. Copy over your bin/LocalLib.cfg and lib/LocalSite.cfg files
  2. Copy over any local files you created (such as .htpasswd and .htaccess files)
 
  1. Point your webserver at the new install.
If you changed any of the distributed files, you will have to continue from Step 5 above.
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiUpgradeGuide.