Ignore:
Timestamp:
11/25/08 02:03:19 (4 years ago)
Author:
KennethLavrsen
Message:

Item295: Eliminating TWiki in the upgrade guide where possible.
But this doc needs much more rewriting so I will return to it again
Just checking in the changes done as part of the basic renaming

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/core/data/System/UpgradeGuide.txt

    r886 r933  
    11%META:TOPICINFO{author="ProjectContributor" date="1200013119" format="1.1" version="$Rev: 14667 $"}% 
    22%STARTINCLUDE% 
    3 ---+ TWiki Upgrade Guide 
    4  
    5 _This guide covers upgrading from a previous version of TWiki (such as Cairo or TWiki4.0) to TWiki 4.2_ 
     3---+ Foswiki Upgrade Guide 
     4 
     5_This guide covers upgrading from a previous version of Foswiki or TWiki (such as Cairo or TWiki4.0) to Foswiki 1.0_ 
    66 
    77%TOC% 
    … …  
    1111TWiki-4.0.0 was a major new release. TWiki-4.1.0 was a minor release without dramatic changes since 4.0.0. TWiki-4.2.0 is also a minor release containing a few new features that can be seen by the end user, a large number of bug fixes, and a face lift for the skin. It also contains some important updates under the hood to the way users are handled which enables new types of authentication and integration with other systems. The most important new feature is the QuerySearch feature. 
    1212 
     13Foswiki 1.0.0 is a fork of TWiki fully compatible with content from TWiki. It is mainly a rebranded TWiki 4.2.4. 
     14 
    1315---++ Upgrade Requirements 
    1416 
    15    * Please review the AdminSkillsAssumptions before you upgrade TWiki 
    16    * To upgrade from a standard TWiki Release 01-Sep-2004 to the latest TWiki-4.X Production Release, follow the instructions below 
     17   * Please review the AdminSkillsAssumptions before you upgrade Foswiki 
     18   * To upgrade from a standard TWiki Release 01-Sep-2004 to the latest Foswiki Production Release, follow the instructions below 
    1719   * Once the upgrade has been applied, an existing earlier installation will still be able to read all the topics, but should not be used to write. Make sure you take a backup! 
    1820   * Not all Plugins written for TWiki Release 01-Sep-2004 are fully supported with 4.X. Make sure the Plugins you use can be upgraded as well! 
     21   * Not all Plugins from TWiki are compatible with Foswiki. But most publicly available Foswiki:Extensions have been republished in a version converted to the Foswiki namespace. 
    1922 
    2023---++ Major Changes Compared to TWiki Release 01-Sep-2004 and TWiki Release 4.0.0 
    … …  
    2629---++ Upgrade Procedure 
    2730 
    28 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. 
     31The 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 or Foswiki release. 
    2932 
    3033The main steps are: 
    3134 
    32    1 Install the new TWiki version, configure it, and get it to work similar to the old version 
     35   1 Install the new Foswiki version, configure it, and get it to work similar to the old version 
    3336   1 Install additional extensions (Plugins). Make sure to use the latest versions 
    3437   1 Copy all the non-default webs from the old installation to the new 
    … …  
    4043 
    4144   * Follow the installation instructions in INSTALL.html which you find in the root of the new installation. Install the new release in a new directory. Do not install on top of the old release. 
    42    * Use the [[%SCRIPTURL{configure}%][configure]] script to configure TWiki. 
     45   * Use the [[%SCRIPTURL{configure}%][configure]] script to configure Foswiki. 
    4346      * If you are upgrading from a 4.x.x release, you can carry over the configure settings from the old release. 
    4447      * You need to run configure and save the configuration once when you upgrade as this will update the altered and added settings. 
    … …  
    4750   * Additional resources 
    4851      * Foswiki:Support.UpgradingFromOlderTWikiReleases - upgrading TWiki from older TWiki releases 
    49       * Foswiki:Support.UpgradingFromTWiki4x2Releases - upgrading from TWiki4.2.X to Nextwiki 
     52      * Foswiki:Support.UpgradingFromTWiki4x2Releases - upgrading from TWiki4.2.X to Foswiki 
    5053      * Foswiki:Support.UpgradingPatchReleases - upgrading releases where only last digit in the version changed  
    5154      * Foswiki:Support.InstallingOnSpecificPlatforms 
    5255      * Foswiki:Support.ApacheConfigGenerator 
    5356      * Foswiki:Support.SettingFileAccessRightsLinuxUnix 
    54       * If you upgrade from an older TWiki your =lib/TWiki.cfg= from the old TWiki installation is a good resource for some of the settings you will need but you cannot reuse the old TWiki.cfg. 
    55    * Make sure you have a working basic TWiki before you continue 
     57      * If you upgrade from an a very old TWiki like Cairo your =lib/TWiki.cfg= from the old TWiki installation is a good resource for some of the settings you will need but you cannot reuse the old TWiki.cfg. 
     58   * Make sure you have a working basic Foswiki before you continue 
    5659 
    5760---+++ Install Extensions 
    5861 
    59    * Note that not all extensions that worked in Cairo have been updated to work with TWiki4.X. Many Cairo plugins work fine. Some do not. Many plugins have been upgraded to work with TWiki4.0 and later. 
     62   * Note that not all extensions that worked in Cairo had been updated to work with TWiki4.X. Many Cairo plugins work fine. Some do not. Many plugins have been upgraded to work with TWiki4.0 and later. 
    6063   * From TWiki-4.1.0 the [[%SCRIPTURLPATH{"configure"}%][configure]] script which you ran during installation supports installation of additional plugins. 
    61    * Manual installation is possible. Follow the instruction on the Plugin page at twiki.org. 
    62    * Check the plugin topics from your old TWiki installation. There may be plugin settings that you want to transfer to the new TWiki installation. 
     64   * Installing TWiki Extensions such as Plugins requires that the perl name space is changed from TWiki to Foswiki. A TWikiCompatibilityPlugin is provided which makes most unmodified TWiki Plugins work on Foswiki. If a plugin exists in the Foswiki:Extensions repository it is highly recommended to install it from there so get an extension which has been converted to the Foswiki namespace. 
     65   * Manual installation is possible. Follow the instruction on the Plugin page at foswiki.org. 
     66   * Check the plugin topics from your old TWiki/Foswiki installation. There may be plugin settings that you want to transfer to the new Foswiki installation. 
    6367     %BR% __%H% Hint:__ For an easier upgrade later on, set the plugin preferences settings in the [[%LOCALSITEPREFS%]] topic, not in the plugin topic. To identify the plugin, prefix the name of the setting with the capitalized name of the plugin. For example, to change the =DEFAULT_TYPE= setting of the CommentPlugin, create a =COMMENTPLUGIN_DEFAULT_TYPE= setting in <nop>%LOCALSITEPREFS%. 
    6468   * Typical plugin settings you may have altered. 
    … …  
    7175      * TablePlugin - Set TABLEATTRIBUTES    
    7276   * Remember that a plugin must be activated in [[%SCRIPTURLPATH{"configure"}%][configure]]. 
    73    * To avoid having to re-apply plugin settings each time you upgrade a plugin or TWiki itself, define the altered plugin settings in =%USERSWEB%.SitePreferences= instead 
    74  
    75 ---+++ Copy your old webs to new TWiki 
     77   * To avoid having to re-apply plugin settings each time you upgrade a plugin or Foswiki itself, define the altered plugin settings in =%USERSWEB%.SitePreferences= instead 
     78 
     79---+++ Copy your old webs to new Foswiki 
    7680 
    7781   * When upgrading from Cairo or earlier it may be necessary to unlock the rcs files in data and pub directories from the old installation using the following shell commands: 
    7882      * =find data -name '*,v' -exec rcs -u -M '{}' \;= 
    7983      * =find pub -name '*,v' -exec rcs -u -M '{}' \;= 
    80    * Copy your local webs over to the data and pub directories of the new install. Do not copy the default webs: TWiki, Main, Trash, Sandbox, _default, and _empty. 
     84   * Copy your local webs over to the data and pub directories of the new install. Do not copy the default webs: System (or TWiki), Main, Trash, Sandbox, _default, and _empty. 
    8185   * Make sure all data and pub files and directories are owned by the webserver user. 
    82    * __Note:__ TWiki's WebChanges topics depend on the file timestamp. If you touch the .txt files make sure to preserve the timestamp, or to change them in the sequence of old file timestamps. 
     86   * __Note:__ Foswiki's WebChanges topics depend on the file timestamp. If you touch the .txt files make sure to preserve the timestamp, or to change them in the sequence of old file timestamps. 
    8387 
    8488---+++ Copy Users And Their Topics From Main Web 
    8589 
    86    * Copy all the topics from the Main web and corresponding pub/Main directories from the old TWiki to the new TWiki but do not overwrite any of the new topics already inside the new Main directory! 
    87    * Manually merge all the users from the old =Main.WikiUsers= topic to the new TWiki. If you upgrade from Cairo you can simply use the old file and add the missing new system users to the list of users. If you upgrade from TWiki-4.0.X simply use the old topic. Starting from 4.2.0 TWiki no longer ships with a =Main.WikiUsers= topic. When you register the first user TWiki now checks for an existing =Main.WikiUsers= and if it does not exist it gets created. 
    88    * If you use =data/.htpasswd= for authentication copy this file from the old TWiki to the new. 
     90   * Copy all the topics from the Main web and corresponding pub/Main directories from the old TWiki/Foswiki to the new Foswiki but do not overwrite any of the new topics already inside the new Main directory! 
     91   * Manually merge all the users from the old =Main.WikiUsers= topic to the new Foswiki. Foswiki does not ship with a =Main.WikiUsers= topic. When you register the first user Foswiki now checks for an existing =Main.WikiUsers= and if it does not exist it gets created. 
     92   * For upgrades from TWiki to Foswiki the =TWikiUsers= topic must additionally be renamed to =WikiUsers=. If you upgrade from Cairo you can simply use the old file renamed to =WikiUsers= and add the missing new system users to the list of users. If you upgrade from TWiki-4.0.X simply use the old topic renamed to =WikiUsers=. 
     93   * If you use =data/.htpasswd= for authentication copy this file from the old TWiki/Foswiki to the new Foswiki. 
    8994      * If you upgrade from Cairo and you are using the Htpasswd login manager, then note that email addresses for users have moved out of user topics and into the password file. There is a script that performs this extra upgrade step for you - see =tools/upgrade_emails.pl=. 
    90    * The old sandbox web may have a lot of useful topic and users may use it actively for drafts. Manually select the topics (remember the corresponding pub directories) from the old Sandbox web and copy them to the new TWiki. Decide if you want to overwrite the sandbox homepage and left menu bar or keep the new. 
     95   * The old sandbox web may have a lot of useful topic and users may use it actively for drafts. Manually select the topics (remember the corresponding pub directories) from the old Sandbox web and copy them to the new Foswiki. Decide if you want to overwrite the sandbox homepage and left menu bar or keep the new. 
    9196   * If you added or removed fields from the user topic form you may also have tailored =%SYSTEMWEB%.UserRegistration=. Make sure you either reuse the registration topic from the old installation or apply the same field changes to the new =%SYSTEMWEB%.UserRegistration= topic. 
    92    * Starting from 4.2.0 TWiki ships with =NewUserTemplate= and =UserForm= in the TWiki web. If you choose to tailor anything you are strongly adviced to copy =NewUserTemplate= and =UserForm= to the Main web and tailor the Main web copies. TWiki will look for the =NewUserTemplate= in the Main web first and if it does not exist it uses the default from the TWiki web. By creating a =Main.NewUserTemplate= and its =Main.UserForm= you will not loose your tailorings next time you upgrade TWiki. 
     97   * Foswiki ships with =NewUserTemplate= and =UserForm= in the System web. If you choose to tailor anything you are strongly adviced to copy =NewUserTemplate= and =UserForm= to the Main web and tailor the Main web copies. Foswiki will look for the =NewUserTemplate= in the Main web first and if it does not exist it uses the default from the System web. By creating a =Main.NewUserTemplate= and its =Main.UserForm= you will not loose your tailorings next time you upgrade Foswiki. 
    9398   * Make sure all data and pub files and directories are owned by the webserver user. 
    9499 
    95100---+++ Apply Customizations To The Skin 
    96101 
    97    * Not many of the old Cairo skins work well with TWiki4.X. 
     102   * Not many of the old TWiki Cairo skins work well with Foswiki 
    98103   * Add Logos, update top bar and left bar as required. 
    99104   * Apply any desired changes to style sheets and templates. The default PatternSkin has been totally rewritten since Cairo and once more in 4.0.2. Since then changes to PatternSkin have been minor and you may be able to carry over most simpler tailorings directly from 4.0.2-4.0.5. 
    … …  
    105110 
    106111   * Transfer any customized and local settings from [[%SYSTEMWEB%.DefaultPreferences]] to the topic pointed at by {LocalSitePreferences} ([[%LOCALSITEPREFS%]]). Per default this is =%USERSWEB%.SitePreferences=. This avoids having to write over files in the distribution on a later upgrade. 
    107    * If you changed any of the topics in the original TWiki distribution, you will have to transfer your changes to the new install manually. There is no simple way to do this, though a suggestion is to use 'diff' to find changed files in the =data/TWiki= of the old and new TWiki installation, and transfer the changes into the new TWiki install. If you can run a GUI on your server, you may find that using a visual diff tool like !WinMerge, meld, kdiff3, xxdiff, etc. is helpful. 
    108    * Compare the =WebPreferences= topics in the old TWiki Installation with the default from the new TWiki installation and add any new Preferences that may be relevant. 
    109    * Compare the =WebLeftBar= topics in the old TWiki Installation with the default from the new TWiki installation and add any new feature that you desire. 
     112   * If you changed any of the topics in the original TWiki/Foswiki distribution, you will have to transfer your changes to the new install manually.  
     113   * Compare the =WebPreferences= topics in the old TWiki/Foswiki Installation with the default from the new Foswiki installation and add any new Preferences that may be relevant. 
     114   * Compare the =WebLeftBar= topics in the old TWiki/Foswiki Installation with the default from the new Foswiki installation and add any new feature that you desire. 
    110115 
    111116---++ Customization of Special Pages 
    112117 
    113 Some pages in the TWiki web are meant to be customized after choice of authentication. If you do not use the internal TWiki password manager the topics that contains the features for changing and resetting passwords and changing the email address should be changed to a note describing how to perform these tasks in your organization. If you have made such customizations remember to replace these topics in the TWiki web with the tailored versions from your old installation. The topics are: 
    114  
    115    * =TWiki.ChangePassword= 
    116    * =TWiki.ResetPassword= 
    117    * =TWiki.ChangeEmailAddress= 
    118  
    119 ---++ Upgrading from Cairo to TWiki4 (additional advice) 
     118Some pages in the Foswiki web are meant to be customized after choice of authentication. If you do not use the internal Foswiki password manager the topics that contains the features for changing and resetting passwords and changing the email address should be changed to a note describing how to perform these tasks in your organization. If you have made such customizations remember to replace these topics in the System web with the tailored versions from your old installation. If you upgrade from TWiki remember that the old TWiki web is called System web in Foswiki. The topics are: 
     119 
     120   * =System.ChangePassword= 
     121   * =System.ResetPassword= 
     122   * =System.ChangeEmailAddress= 
     123 
     124---++ Upgrading from TWiki Cairo to Foswiki (additional advice) 
    120125 
    121126---+++ Favicon 
    122127 
    123 TWiki4'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. 
    124  
    125 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. 
     128Foswiki'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. 
     129 
     130In Foswiki it is assumed that each web has a favicon.ico file attached to the !WebPreferences topic. When you upgrade from TWiki Cairo to Foswiki 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. 
    126131 
    127132   * Attach a favicon.ico file to !WebPreferences in each web. 
    128    * Preferred: Change the setting of the location of favicon.ico in !%SYSTEMWEB%.DefaultPreferences or !%USERSWEB%.SitePreferences so all webs use the favicon.ico from the TWiki web. This is the fastest and easiest solution. 
    129  
    130 To change the location of favicon.ico to the TWiki web add this line to %USERSWEB%.SitePreferences 
     133   * Preferred: Change the setting of the location of favicon.ico in !%SYSTEMWEB%.DefaultPreferences or !%USERSWEB%.SitePreferences so all webs use the favicon.ico from the System web. This is the fastest and easiest solution. 
     134 
     135To change the location of favicon.ico to the System web add this line to %USERSWEB%.SitePreferences 
    131136 
    132137<verbatim> 
    … …  
    136141---+++ !WikiUsers topic in Main web 
    137142 
    138 Your Cairo [[Main.WikiUsers][Main.WikiUsers]] topic will work in TWiki4 but you will need to ensure that these 4 users from the default TWiki4 version of !WikiUsers are copied to the existing !WikiUsers topic. !WikiGuest is probably already there but the others are new 
    139    * *ProjectContributor* - placeholder for a TWiki developer, and is used in TWiki documentation 
     143As part of the rebranding from TWiki to Foswiki, the !TWikiUsers topic was renamed to !WikiUsers but the format is the exact same. 
     144 
     145Your Cairo !TWikiUsers topic will work in Foswiki but you will need to ensure that these 4 users from the default Foswiki version of !WikiUsers are copied to the existing !WikiUsers topic. !WikiGuest is probably already there but the others are new 
     146   * *ProjectContributor* - placeholder for a Foswiki developer, and is used in Foswiki documentation 
    140147   * *WikiGuest* - guest user, used as a fallback if the user can't be identified 
    141148   * *RegistrationAgent* - special user used during the new user registration process 
    … …  
    143150 
    144151 
    145 ---++ Important Changes since 4.0.5 
     152---++ Important Changes since TWiki 4.0.5 
    146153 
    147154---+++ Supported Perl version 
    148155 
    149 TWiki 4.0.5 worked on Perl version 5.6.X. Reports from users has shown that unfortunately TWiki 4.1.0 does not support Perl versions older then 5.8.0. It is the goal that TWiki should work on at least Perl version 5.6.X but none of the developers have had access to Perl installations older than 5.8.0. 
    150  
    151 Since TWiki 4.1.0 has some urgent bugs the development team decided to release TWiki 4.1.1 without resolving the issue with Perl 5.6.X. We will however address this and try and resolve it for a planned 4.1.2 release. The TWiki community is very interested in contributions from users that have fixes for the code which will enable TWiki to run on older versions of Perl. 
    152  
    153 See the [[http://twiki.org/cgi-bin/view/Codev/WhatVersionsOfPerlAreSupported][WhatVersionsOfPerlAreSupported]] topic to keep up to date with the discussion how to get back support for earlier Perl versions. 
     156TWiki 4.0.5 worked on Perl version 5.6.X. Reports from users has shown that unfortunately Foswiki does not support Perl versions older then 5.8.0. It is especially the Wysiwyg editor and support for international character sets that requires new features in Perl 5.8.X. 
    154157 
    155158---+++ Template spec changed 
    … …  
    159162This caused a lot of problems for skin developers when you wanted a newline before or after the block text. 
    160163 
    161 From TWiki 4.1.0 this has changed so that white space is no longer stripped. Skins like !PatternSkin and !NatSkin have been updated so that they work with the new behavior. But if you use an older skin or have written your own you will most likely need to make some adjustments. 
     164From TWiki 4.1.0 and continuing in Foswiki this has changed so that white space is no longer stripped. Skins like !PatternSkin and !NatSkin have been updated so that they work with the new behavior. But if you use an older skin or have written your own you will most likely need to make some adjustments. 
    162165 
    163166It is not difficult. The general rule is - if you get mysterious blank lines in your skin, the newline after the %<nop>TMPL:DEF{"block"}% needs to be removed. Ie. the content of the block must follow on the same line as the TMPL:DEF. 
    … …  
    186189The advantage of the spec change is that now you can add leading and trailing white space including new lines. This was not possible before. 
    187190 
    188 ---++ Important Changes since 4.1.0 
     191---++ Important Changes since TWiki 4.1.0 
    189192 
    190193---+++ New location for session and other temporary files 
    191194 
    192 *An upgrader upgrading to 4.1.1 should note the following important change* 
    193  
    194 The directory for passthrough files and session files have been replaced by a common directory for temporary files used by TWiki. Previously the two configure settings ={PassthroughDir}= and ={Sessions}{Dir}= were by default set to =/tmp=. These config settings have been replaced by ={TempfileDir}= with the default setting value =/tmp/twiki=. If the =twiki= directory does not exist twiki will create it first time it needs it. 
    195  
    196 It is highly recommended no longer to use the tmp directory common to other web applications and the new default will work fine for most. You may want to delete all the old session files in /tmp after the upgrade to 4.1.1. They all start with cgisess_. It is additionally highly recommended to limit write access to the ={TempfileDir}= for security reasons if you have non-admin users with login access to the webserver just like you would do with the other webserver directories. 
    197  
    198 ---++ Important Changes since 4.1.2 
     195The directory for passthrough files and session files have been replaced by a common directory for temporary files used by Foswiki. Previously the two configure settings ={PassthroughDir}= and ={Sessions}{Dir}= were by default set to =/tmp=. These config settings have been eliminated. Foswiki creates the tmp directory and other temporary directors under the directory defined by the configure setting ={WorkingDir}= 
     196 
     197---++ Important Changes since TWiki 4.1.2 
    199198 
    200199---+++ New WYSIWYG Editor 
    201200 
    202 TWiki now ships with a new WYSIWYG editor based on !TinyMCE replaces the Kupu based editor.%BR% !TinyMCE is not a perfect Wysiwyg editor but it is magnitudes better than the Kupu editor 
    203  
    204 The !WysiwygPlugin that drives the engine behind both !TinyMCE has additionally been heavily improved so that less TWiki Applications are negatively affected by editing WYSIWYG 
     201Foswiki now ships with a new WYSIWYG editor based on !TinyMCE replaces the Kupu based editor.%BR% !TinyMCE is not a perfect Wysiwyg editor but it is magnitudes better than the Kupu editor 
     202 
     203The !WysiwygPlugin that drives the engine behind both !TinyMCE has additionally been heavily improved so that less Foswiki Applications are negatively affected by editing WYSIWYG 
    205204 
    206205When !TinyMCEPlugin is enabled the Edit button per default becomes WYSIWYG editing mode. A new Raw Edit link has been added to enable application developers to edit the good old way 
    … …  
    210209---+++ NEWTOPICLINKSYMBOL removed 
    211210 
    212 The NEWTOPICLINKSYMBOL preference which was deprecated in 4.1 has now been removed from the code. If you want to control the appearance of new links, you can use NEWLINKFORMAT. 
     211The NEWTOPICLINKSYMBOL preference which was deprecated in TWiki 4.1 has now been removed from the code. If you want to control the appearance of new links, you can use NEWLINKFORMAT. 
    213212 
    214213---+++ !UserForm and !NewUserTemplate Customization 
    215214 
    216 When a new user registers on TWiki his user topic is created based on the =NewUserTemplate= and =UserForm=. 
    217  
    218 The =NewUserTemplate= was located in the TWiki web and the =UserForm= in the Main web. When upgrading TWiki these were some of the topics you had to take care not to overwrite. 
    219  
    220 From 4.2.0 the =UserForm= and =NewUserTemplate= are distributed in the TWiki web. If you create the two in the Main web the Main web version will be used instead. So if you tailor the user topic format or the form then you should always copy the two files to the Main web and modify the ones in the Main web. When you later upgrade TWiki your tailored template and form will not be overwritten. 
     215When a new user registers on Foswiki his user topic is created based on the =NewUserTemplate= and =UserForm=. 
     216 
     217The =NewUserTemplate= was located in the TWiki web and the =UserForm= in the Main web. When you earlier upgraded TWiki these were some of the topics you had to take care not to overwrite. 
     218 
     219In Foswiki the =UserForm= and =NewUserTemplate= are distributed in the System web. If you create the two in the Main web the Main web version will be used instead. So if you tailor the user topic format or the form then you should always copy the two files to the Main web and modify the ones in the Main web. When you later upgrade Foswiki your tailored template and form will not be overwritten. 
    221220 
    222221---+++ !WikiUsers no longer distributed 
    223222 
    224 The =Main.WikiUsers= topic contains all the registered users. It is a topic you do not want to overwrite when you upgrade TWiki. 
    225  
    226 From 4.2.0 this file is no longer included in the TWiki distribution. When you register the first time TWiki creates the =Main.WikiUsers= topic in the Main web if it does not exist already. This means that you can now upgrade TWiki without risk of overwriting the important =WikiUsers= topic. 
     223The =Main.WikiUsers= topic contains all the registered users. It is a topic you do not want to overwrite when you upgrade Foswiki. 
     224 
     225This file is not included in the Foswiki distribution. When you register the first time Foswiki creates the =Main.WikiUsers= topic in the Main web if it does not exist already. This means that you can now upgrade Foswiki without risk of overwriting the important =WikiUsers= topic. 
    227226 
    228227   * For new installers this makes no difference at all 
    … …  
    245244---+++ New Internal Admin Login 
    246245 
    247 TWiki 4.2 introduces a new _Internal Admin Login_ feature which uses "admin" (configurable) as username and the password used for configure to become temporary administrator. When you do a new installation you need to use this feature as !Main.AdminGroup is now access restricted by default to avoid security attacks during the hours an installation may take. From configure there is a link to the !AdminGroup topic and on !AdminGroup the step by step instructions are written in a yellow box. Our advice is not to remove this help text in case you need it later. 
     246Foswiki has a new _Internal Admin Login_ feature which uses "admin" (configurable) as username and the password used for configure to become temporary administrator. When you do a new installation you need to use this feature as !Main.AdminGroup is now access restricted by default to avoid security attacks during the hours an installation may take. From configure there is a link to the !AdminGroup topic and on !AdminGroup the step by step instructions are written in a yellow box. Our advice is not to remove this help text in case you need it later. 
    248247 
    249248%STOPINCLUDE% 
Note: See TracChangeset for help on using the changeset viewer.