Difference: UpgradeGuide (1 vs. 2)

Revision 2
14 Oct 2014 - Main.MatthiasGeorgi
Line: 1 to 1
Deleted:
<
<
 
META TOPICPARENT name="AdminDocumentationCategory"

Foswiki Upgrade Guide

Line: 16 to 15
 

Upgrade requirements

Changed:
<
<
>
>
 
  • To upgrade from an old TWiki Release to the latest Foswiki production release, follow the instructions below.
  • Before upgrading, you may wish to make a backup of your topics.
  • 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.
Line: 24 to 23
 

Upgrading from TWiki to Foswiki

Changed:
<
<		 You are strongly advised to read the Foswiki:System.ReleaseNotes01x00 (also available in an HTML file in the root of your installation), which contains a list of changes from TWiki 4.2.3 to Foswiki 1.0. A number of system topics and macros (formerly known as TWiki variables) have been renamed, to better describe their purpose and, where appropriate, to rebrand to the Foswiki name.
>
>		 You are strongly advised to read the Foswiki:Projekte/Projekte/System.ReleaseNotes01x00 (also available in an HTML file in the root of your installation), which contains a list of changes from TWiki 4.2.3 to Foswiki 1.0. A number of system topics and macros (formerly known as TWiki variables) have been renamed, to better describe their purpose and, where appropriate, to rebrand to the Foswiki name.
 

Upgrading to a new patch release

Line: 60 to 59
 

Prepare for all upgrade steps

Changed:
<
<		 Read the Foswiki:System.ReleaseNotes01x00 and learn about the differences between your old installation and the new release to which you are upgrading. Take note of any areas that affect your site and what special steps you may need to take.
>
>		 Read the Foswiki:Projekte/Projekte/System.ReleaseNotes01x00 and learn about the differences between your old installation and the new release to which you are upgrading. Take note of any areas that affect your site and what special steps you may need to take.
 

Check that all the extensions (plugins, contribs, skins) used by your old installation are available with the new release. Familiarize yourself with any new behaviour that you will have to adapt to or any configuration changes you will have to perform.
Line: 82 to 81
 
    • Verify all of the configuration settings on the configure page, including any new settings added in the new version. Save the configuration after you have completed your changes.
    • To wipe out all your settings and start configuring from a fresh installation, just delete the <newwiki>/lib/LocalSite.cfg file and run configure.
  • Additional resources
Changed:
<
<
>
>
 
Line: 144 to 143
 
    • RegistrationAgent - special user used during the new user registration process
    • UnknownUser - used where the author of a previously stored piece of data can't be determined
    • WikiGuest - guest user; used as a fallback if the user can't be identified
Changed:
<
<
  • If any of the default users are missing, then add them in manually to Main.WikiUsers, using the corresponding entries in Foswiki:System.UsersTemplate as an example.
>
>
 
  • If you use data/.htpasswd for authentication, copy this file from the old installation to the new one.
  • If you have customized <old_system_web>.UserRegistration, then either copy over <oldwiki>/data/<old_system_web>/UserRegistration.txt and <oldwiki>/data/<old_system_web>/UserRegistration.txt,v to the <newwiki>/data/System/ directory, or modify System.UserRegistration in the new installation to contain your customizations.
Line: 155 to 154
 
    • RegistrationAgent - special user used during the new user registration process
    • UnknownUser - used where the author of a previously stored piece of data can't be determined
    • WikiGuest - guest user; used as a fallback if the user can't be identified
Changed:
<
<
  • If any of the default users are missing, then add them in manually to Main.WikiUsers, using the corresponding entries in Foswiki:System.UsersTemplate as an example.
>
>
 
  • If you use data/.htpasswd for authentication, copy this file from the old installation to the new one.
  • If you are upgrading from Cairo and are using the Htpasswd login manager, run the tools/upgrade_emails.pl script to move the user emails out of the user topics and into the password file.
  • If you have customized <old_system_web>.TWikiRegistration, then modify System.UserRegistration in the new installation to contain your customizations.
Line: 264 to 263
 

NEWTOPICLINKSYMBOL removed

Changed:
<
<		 The NEWTOPICLINKSYMBOL preference that was deprecated in TWiki 4.1 is no longer supported. To control the appearance of new links, set the NEWLINKFORMAT preference in SitePreferences (see DefaultPreferences for more information on NEWLINKFORMAT).
>
>		 The NEWTOPICLINKSYMBOL preference that was deprecated in TWiki 4.1 is no longer supported. To control the appearance of new links, set the NEWLINKFORMAT preference in SitePreferences (see DefaultPreferences? for more information on NEWLINKFORMAT).
 

UserForm and NewUserTemplate customization

View topic | History: r2 < r1 | More topic actions...
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback