diff options
| -rw-r--r-- | TWiki/TWikiUpgradeGuide.mdwn | 26 |
1 files changed, 14 insertions, 12 deletions
diff --git a/TWiki/TWikiUpgradeGuide.mdwn b/TWiki/TWikiUpgradeGuide.mdwn index 76344ae8..3f9285b0 100644 --- a/TWiki/TWikiUpgradeGuide.mdwn +++ b/TWiki/TWikiUpgradeGuide.mdwn @@ -2,20 +2,29 @@ ## <a name="TWiki_Upgrade_Guide"> TWiki Upgrade Guide </a> -### <a name="Upgrading_to_TWiki_01_Sep_2001"> Upgrading to TWiki 01-Sep-2001 </a> +Upgrade application and content from last official release 01-Dec-2000 to current 01-Sep-2001 + +### <a name="Overview"> Overview </a> + +Major changes, numerous enhancements, basic structure similar.... Beta on their own...easy. Upgrade involves a changing and merging of files and configs... + +### <a name="Upgrade_Requirements_for_TWiki_0"> Upgrade Requirements for TWiki 01-Sep-2001 </a> Upgrade from your 01-Dec-2000 edition to the new, next generation **01-Sep-2001** TWiki Production Release in a few straightforward steps. -### <a name="Major_Changes_from_01_Dec_2000"> Major Changes from 01-Dec-2000 </a> +* To upgrade from a pre-01-Dec-2000 TWiki, make this your first stop: %TWIKIWEB%.TWikiUpgradeTo01Dec2000. + +### <a name="Major_Changes_from_TWiki_01_Dec_"> Major Changes from TWiki 01-Dec-2000 </a> The 01 Sep 2001 release includes several new areas of functionality, and existing features have been significantly revised and enhanced. These changes affect the upgrade of the 01 Dec 2000 version: * **TWikiPlugins** major enhancement, allows easy installation and removal of program enhancements using external plug-in modules, standardized creation of Plugins with the Plugins API + * **InterWikisPlugin** - preinstalled * **AttachmentsUnderRevisionControl** In the previous version, changes to topics were tracked under revision control (RCS); now, topic Attachments are also tracked. * **ManagingTopics/Move/Delete Topic** In the previous version, managing topics required access to the TWiki file system (Telnet or FTP); now, moving, renaming, deleting can be done through the browser. Deleted topics are act move and stored in a common Trash web. * **TOC (Table of Contents)** Automatically generates a hierarchical Table of Contents from topic headings: <HI>...<H6>. Set depth... * **ArbitraryTextForWikiWordLinks** -* **ChangingTWikiPasswords** done by Web form +* **ChangingPasswords** done by Web form * **TWikiFormTemplate** * **TWikiTemplateSystem** all new template set-up * **TWikiSkins** @@ -26,14 +35,7 @@ The 01 Sep 2001 release includes several new areas of functionality, and existin The TWiki directory structure remains the same, with one exception, the new <code>**lib/TWiki/Plugins**</code> directory tree to for the main configuration file, library, internal modules and the new Plugin modules. Pre-existing files were formerly in <code>**bin**</code>. -### <a name="Picking_the_Right_Upgrade_Path"> Picking the Right Upgrade Path </a> - -Check these to make sure you're on the right page: - -* If you've updated, replaced, or even added files from any of this year's Beta test releases of the new TWiki, head here: %TWIKIWEB%.TWikiBetaUpgradeNotes. -* To upgrade from a pre-01-Dec-2000 TWiki, make this your first stop: %TWIKIWEB%.TWikiUpgradeTo01Dec2000. - -### <a name="Standard_Six_Step_Upgrade"> Standard Six-Step Upgrade </a> +### <a name="Six_Step_Standard_Upgrade"> Six-Step Standard Upgrade </a> Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep 2001 release, and transfer all of your original data: [ We assume `export TWIKIROOT=/some/dir/` ] @@ -77,7 +79,7 @@ Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep > * * Move the new `twiki/data/TWiki` directory to your installation: ( `twiki/data` ) <br />`mv ~/tmp/data/TWiki $TWIKIROOT/data/`<br /> Pay attention to the file permissions of the `TWiki` directory and its files. The files must be writable by the cgi-scripts (usually user "nobody") > * Optionally move the new `twiki/data/Test` directory to your installation, i.e. <br />`mv ~/tmp/data/Test $TWIKIROOT/data/`<br /> (Pay attention to the file permissions) > * Move these new TWiki.Main web topics to your TWiki.Main web: `TWikiGroups`, `TWikiAdminGroup`, and if needed also `OfficeLocations` , i.e. <br />`mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main`<br /> (Pay attention to the file permissions) -> * The following topics in the TWiki.Main web are obsolete and can be deleted: `BillClinton`, `GoodStyle`, `RegularExpression`, `TextFormattingFAQ`, `TextFormattingRules`, `ManagingWebs`, `TWikiCategoryTable`, `TWikiEnhancementRequests`, `TWikiImplementationNotes`, `TWikiInstallationGuide`, `WebNotification`, `TWikiPlannedFeatures`, `TWikiUpgradeTo01May2000`, `TWikiUsernameVsLoginUsername`, `TWikiSite`, `WelcomeGuest`, `WelcomeVisitor`, `WikiName`, `WikiNotation`, `WikiTopic`, `WikiWikiClones`. Sample delete command: <br />`rm -f $TWIKIROOT/data/Main/BillClinton.*` +> * **_The following topics in the TWiki.Main web are obsolete and can be deleted: `BillClinton`, `GoodStyle`, `RegularExpression`, `TextFormattingFAQ`, `TextFormattingRules`, `ManagingWebs`, `TWikiCategoryTable`, `TWikiEnhancementRequests`, `TWikiImplementationNotes`, `TWikiInstallationGuide`, `WebNotification`, `TWikiPlannedFeatures`, `TWikiUpgradeTo01May2000`, `TWikiUsernameVsLoginUsername`, `TWikiSite`, `WelcomeGuest`, `WelcomeVisitor`, `WikiName`, `WikiNotation`, `WikiTopic`, `WikiWikiClones`. Sample delete command:+_**<br />`rm -f $TWIKIROOT/data/Main/BillClinton.*` > * The following topics are new and most be copied to all of your TWiki webs: `WebChanges`, `WebIndex`. <br />`cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main`<br />`cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main`<br /> Repeat this for all your webs. Pay attention to the file permissions. > * `TWikiRegistration` moved from TWiki.Main to TWiki.TWiki. In case you customized `TWikiRegistration` , merge your changes back into `TWiki.TWikiRegistration` , then delete `$TWIKIROOT/data/Main/TWikiRegistration*`. > * `TWikiPreferences` moved from TWiki.Main to TWiki.TWiki. Merge your changes to `TWikiPreferences` into `TWiki.TWikiPreferences`. |