Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
TWiki Upgrade Guide | ||||||||
Line: 20 to 20 | ||||||||
Major Changes Compared to TWiki Release 01-Sep-2004 | ||||||||
Changed: | ||||||||
< < | See TWikiReleaseNotes04x00x00?. | |||||||
> > | See TWikiReleaseNotes04x00. | |||||||
Automated Upgrade Procedure | ||||||||
Line: 101 to 101 | ||||||||
| ||||||||
Added: | ||||||||
> > | Upgrading from Cairo to TWiki4 (additional advice)FaviconTWiki4's PatternSkin introduces the use of the favicon feature which most browsers use to show a small icon in front of the URL and for bookmarks. In TWiki4 it is assumed that each web has a favicon.ico file attached to the WebPreferences topic. When you upgrade from Cairo to TWiki4 you do not have this file and you will get flooded with errors the error log of your web server. There are two solutions to this.
* Set FAVICON = %PUBURLPATH%/%TWIKIWEB%/%WEBPREFSTOPIC%/favicon.ico | |||||||
Related Topics: AdminDocumentationCategory, TWiki:TWiki.UpgradingTWiki |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
TWiki Upgrade Guide | ||||||||
Line: 51 to 51 | ||||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Assuming all goes well, UpgradeTwiki will give you the final instructions. | ||||||||
Line: 64 to 64 | ||||||||
| ||||||||
Added: | ||||||||
> > |
| |||||||
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 | ||||||||
| ||||||||
Added: | ||||||||
> > |
| |||||||
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:
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
|
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
TWiki Upgrade Guide | ||||||||
Changed: | ||||||||
< < | Upgrade from the previous TWiki 01-Feb-2003 production release to TWiki 01-Sep-2004 | |||||||
> > | Upgrade from the previous TWiki 01-Sep-2004 Prodcution Release to TWiki-4.0.0 | |||||||
Overview | ||||||||
Changed: | ||||||||
< < | This guide describes how to upgrade from TWiki 01-Feb-2003 to TWiki 01-Sep-2004. This is a major new release. You can chose between an automated upgrade using a script or a manual update. | |||||||
> > | TWiki-4.0.0 is a major new release. You can chose between an automated upgrade using a script or a manual update. | |||||||
Upgrade Requirements
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Changed: | ||||||||
< < | Major Changes Compared to TWiki 01-Feb-2003 | |||||||
> > | Major Changes Compared to TWiki Release 01-Sep-2004 | |||||||
Changed: | ||||||||
< < |
| |||||||
> > | See TWikiReleaseNotes04x00x00?. | |||||||
Added: | ||||||||
> > | Automated Upgrade Procedure | |||||||
Changed: | ||||||||
< < | Automated Upgrade Procedure from 01-Feb-2003 to 01-Sep-2004 Release | |||||||
> > | If you would prefer to do things manually, or if you made custom modifications to distributed files (except topics), then skip to the manual upgrade procedure below. | |||||||
Changed: | ||||||||
< < | With the 01-Sep-2004 Release, for the first time, comes a helper script for upgrading from a previous version. This feature is currently at beta stage, it has only been sanity tested under Unix. It should be worth giving it a try, it won't mess up your existing TWiki installation because it leaves that untouched. | |||||||
> > | The upgrade script is called "UpgradeTwiki" , and is found in the root of the distribution. It can be run by any user, though you will need to make sure you correct the permissions so that the webserver user can write all files in the new installation when you have finished. The upgrade script does not write to your existing installation. | |||||||
Changed: | ||||||||
< < | If you would prefer to do things manually than trust a beta script, skip to the manual upgrade procedure below. | |||||||
> > | The upgrade script will upgrade the TWiki core only. Plugins will need to be upgraded separately. | |||||||
Changed: | ||||||||
< < | The upgrade script is called "UpgradeTwiki" , and is found in the root of the distribution. | |||||||
> > | Note: To upgrade from a Beta, do not use UpgradeTWiki. Instead follow the steps outlined in Upgrading a Beta, below. | |||||||
It will:
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Line: 52 to 44 | ||||||||
To perform the upgrade, you need to: | ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < | ./UpgradeTwiki <full path to new_twiki> | |||||||
> > | ./UpgradeTwiki <full path to existing_twiki's setlib.cfg> <full path to new_twiki>
| |||||||
Assuming all goes well, UpgradeTwiki will give you the final instructions. | ||||||||
Added: | ||||||||
> > | Visit TWiki:Codev.KnownIssuesOfTWiki04x00x00 and fix known issues that apply to you. | |||||||
There are a few points worth noting:
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Changed: | ||||||||
< < | 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. | |||||||
> > | 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. | |||||||
Changed: | ||||||||
< < | Manual Upgrade Procedure from 01-Feb-2003 to 01-Sep-2004 ReleaseThe following steps describe the upgrade assuming that$TWIKIROOT is the root of your current 01-Feb-2003 release. As written this will require some downtime. A process for switching over without downtime is described at the end of this section.
| |||||||
> > | Manual Upgrade Procedure | |||||||
Changed: | ||||||||
< < | Note: These steps assume a downtime during the time of upgrade. You could install the new version in parallel to the existing one and switch over in an instant without affecting the users. As a guideline, install the new version into $TWIKIROOT/bin1 , $TWIKIROOT/lib1 , $TWIKIROOT/templates1 , $TWIKIROOT/data/TWiki1 (from data/TWiki ), $TWIKIROOT/pub/TWiki1 (from pub/TWiki ), and configure TWiki.cfg to point to the same data and pub directory like the existing installation. Once tested and ready to go, reconfigure $TWIKIROOT/bin1/setlib.cfg and $TWIKIROOT/lib1/TWiki.cfg , then rename $TWIKIROOT/bin to $TWIKIROOT/bin2 , $TWIKIROOT/bin1 to $TWIKIROOT/bin . Do the same with the lib , templates and data/TWiki directories. | |||||||
> > | The following steps are a rough guide to upgrading only. It is impossible to give detailed instructions, as what you have to do may depend on whether you can configure the webserver or not, and how much you have changed distributed files in your current TWiki release. | |||||||
Changed: | ||||||||
< < | Known Issues
| |||||||
> > |
Upgrading a BetaIf you followed the recommendations and avoided modifying any distributed files, then this is quite straightforward:
| |||||||
Added: | ||||||||
> > | Related Topics: AdminDocumentationCategory, TWiki:TWiki.UpgradingTWiki |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
Added: | ||||||||
> > | TWiki Upgrade GuideUpgrade from the previous TWiki 01-Feb-2003 production release to TWiki 01-Sep-2004OverviewThis guide describes how to upgrade from TWiki 01-Feb-2003 to TWiki 01-Sep-2004. This is a major new release. You can chose between an automated upgrade using a script or a manual update.Upgrade Requirements
Major Changes Compared to TWiki 01-Feb-2003
Automated Upgrade Procedure from 01-Feb-2003 to 01-Sep-2004 ReleaseWith the 01-Sep-2004 Release, for the first time, comes a helper script for upgrading from a previous version. This feature is currently at beta stage, it has only been sanity tested under Unix. It should be worth giving it a try, it won't mess up your existing TWiki installation because it leaves that untouched. If you would prefer to do things manually than trust a beta script, skip to the manual upgrade procedure below. The upgrade script is called"UpgradeTwiki" , and is found in the root of the distribution.
It will:
UpgradeTwiki will give you the final instructions.
There are a few points worth noting:
UpgradeTwiki more robust.
Manual Upgrade Procedure from 01-Feb-2003 to 01-Sep-2004 ReleaseThe following steps describe the upgrade assuming that$TWIKIROOT is the root of your current 01-Feb-2003 release. As written this will require some downtime. A process for switching over without downtime is described at the end of this section.
$TWIKIROOT/bin1 , $TWIKIROOT/lib1 , $TWIKIROOT/templates1 , $TWIKIROOT/data/TWiki1 (from data/TWiki ), $TWIKIROOT/pub/TWiki1 (from pub/TWiki ), and configure TWiki.cfg to point to the same data and pub directory like the existing installation. Once tested and ready to go, reconfigure $TWIKIROOT/bin1/setlib.cfg and $TWIKIROOT/lib1/TWiki.cfg , then rename $TWIKIROOT/bin to $TWIKIROOT/bin2 , $TWIKIROOT/bin1 to $TWIKIROOT/bin . Do the same with the lib , templates and data/TWiki directories.
Known Issues
|