diff options
Diffstat (limited to 'TWiki/TWikiUpgradeGuide.mdwn')
-rw-r--r-- | TWiki/TWikiUpgradeGuide.mdwn | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/TWiki/TWikiUpgradeGuide.mdwn b/TWiki/TWikiUpgradeGuide.mdwn index cfd50bc7..8b334fe6 100644 --- a/TWiki/TWikiUpgradeGuide.mdwn +++ b/TWiki/TWikiUpgradeGuide.mdwn @@ -1,14 +1,14 @@ %TOC% %STARTINCLUDE% -## <a name="TWiki_Upgrade_Guide"> TWiki Upgrade Guide </a> +# <a name="TWiki_Upgrade_Guide"> TWiki Upgrade Guide </a> _Upgrading from the 01-Dec-2000 release to the new TWiki 01-Sep-2001_ -### <a name="Overview"> Overview </a> +## <a name="Overview"> Overview </a> The latest version of TWiki (01-Sep-2001) involves several major new features and numerous enhancements of the last full version (01-Dec-2001). The file system set-up is almost identical, but much of the underlying data structure and processes are new. With all the changes, the upgrade procedure is straightforward, and your existing page data is imported directly. -### <a name="Upgrade_Requirements"> Upgrade Requirements </a> +## <a name="Upgrade_Requirements"> Upgrade Requirements </a> * To upgrade from a 01-Dec-2000 standard installation to the new, next generation 01-Sep-2001 TWiki Production Release, follow the instructions below. @@ -16,7 +16,7 @@ The latest version of TWiki (01-Sep-2001) involves several major new features an * To upgrade from a Beta of the new release, or if you've made custom modifications, read through the documentation and use the procedure below as a guideline. -### <a name="Major_Changes_from_TWiki_01_Dec_"> Major Changes from TWiki 01-Dec-2000 </a> +## <a name="Major_Changes_from_TWiki_01_Dec_"> Major Changes from TWiki 01-Dec-2000 </a> The 01 Sep 2001 release includes the following new features and enhancements: @@ -36,21 +36,21 @@ The 01 Sep 2001 release includes the following new features and enhancements: The TWiki directory structure remains the same, with one exception, the new `lib/TWiki/Plugins` directory tree to for the main configuration file, library, internal modules and the new Plugin modules. Pre-existing files were formerly in `bin`. -### <a name="Standard_Upgrade_Procedure"> Standard Upgrade Procedure </a> +## <a name="Standard_Upgrade_Procedure"> Standard Upgrade Procedure </a> Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep 2001 release, and import your original page data: -#### <a name="Step_1_Backup_amp_Unpack"> Step 1: Backup & Unpack </a> +### <a name="Step_1_Backup_amp_Unpack"> Step 1: Backup & Unpack </a> 1. 1. Backup all existing TWiki directories ( `bin`, `pub`, `data`, `templates` ) 1. 1. Unpack the zip file into some working directory: <br />`mkdir -p ~/tmp/`<br />`cd ~/tmp`<br />`unzip ~/TWiki20001201.zip` -#### <a name="Step_2_Upgrade_TWiki_document_fi"> Step 2: Upgrade TWiki document files </a> +### <a name="Step_2_Upgrade_TWiki_document_fi"> Step 2: Upgrade TWiki document files </a> 1. 1. Move the document files to your TWiki root ( `twiki` ): <br />`mv ~/tmp/TWiki*.html $TWIKIROOT`<br />`mv ~/tmp/index.html $TWIKIROOT`<br />`mv ~/tmp/readme.txt $TWIKIROOT`<br />`mv ~/tmp/license.txt $TWIKIROOT` -#### <a name="Step_3_Upgrade_CGI_scripts"> </a> Step 3: Upgrade CGI scripts +### <a name="Step_3_Upgrade_CGI_scripts"> </a> Step 3: Upgrade CGI scripts 1. 1. Rename your original `twiki/bin` directory: ( `twiki/bin` ) <br />`mv $TWIKIROOT/bin $TWIKIROOT/bin.old` 2. Move the new scripts to your original `twiki/bin` location, i.e. <br />`mv ~/tmp/bin $TWIKIROOT/bin` @@ -60,7 +60,7 @@ Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep * * Pay attention to the file and directory permissions (security issue) -#### <a name="Step_4_Upgrade_template_files"> Step 4: Upgrade template files </a> +### <a name="Step_4_Upgrade_template_files"> Step 4: Upgrade template files </a> 1. 1. Rename your original `twiki/templates` directory: ( `twiki/templates` ) <br />`mv $TWIKIROOT/templates $TWIKIROOT/templates.old` 2. Move the new templates to your original `twiki/templates` location: <br />`mv ~/tmp/templates $TWIKIROOT/templates` @@ -68,14 +68,14 @@ Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep 4. Restore any additional template subdirectories of your TWiki webs you might have and merge the changes. 5. Test your TWiki installation to see if you can view topics. -#### <a name="Step_5_Upgrade_public_files"> Step 5: Upgrade public files </a> +### <a name="Step_5_Upgrade_public_files"> Step 5: Upgrade public files </a> 1. 1. Move the new `twiki/pub/TWiki` directory to your installation: ( `twiki/pub` ) <br />`mv ~/tmp/pub/TWiki $TWIKIROOT/pub/` 2. Move the new `twiki/pub/twikilogo*` image files to your installation: <br />`mv ~/tmp/pub/twikilogo* $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"). -#### <a name="Step_6_Upgrade_data_files"> Step 6: Upgrade data files </a> +### <a name="Step_6_Upgrade_data_files"> Step 6: Upgrade data files </a> 1. 1. 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") 2. Optionally move the new `twiki/data/Test` directory to your installation, <br />`mv ~/tmp/data/Test $TWIKIROOT/data/`<br /> (Pay attention to the file permissions) @@ -88,6 +88,6 @@ Follow this step-by-step guide to upgrade the 01 Dec 2000 version to the 01 Sep 7. 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. 8. **_Change the `WebHome` topics in all your webs to reflect these changes:_** -### <a name="Known_Upgrade_Issues"> Known Upgrade Issues </a> +## <a name="Known_Upgrade_Issues"> Known Upgrade Issues </a> * * Check <http://TWiki.org/cgi-bin/view/Codev/KnownIssuesOfTWiki01Sep2001> for known issues of TWiki 01 Sep 2001 (production release) |