The upgrade packages exclude the files that are typically changed when you customize your installation. The upgrade package can be copied on top of an existing running 1.1.X installation for a quick upgrade to 1.1.8. See Installation section for details.

Upgrading to 1.1.8 from a 1.0.X release using the upgrade package is known to have issues. Copying a 1.1.8 upgrade package on top of a 1.0 will leave a lot obsolete files behind which could cause trouble. Using a LocalSite.cfg file from a 1.0 system will appear to work, but will cause significant issues with QuerySearch. Migration from Foswiki 1.0 to any release of 1.1 should be done using a reinstall.

%STARTSECTION{"download-none"}%
<blockquote class="foswikiAlert"> *This release has not been built yet!* This is a draft of the release announcement. If you want an early start to testing, see Development.SubversionBasedInstall.</blockquote>
%ENDSECTION{"download-none"}%
%STARTSECTION{"download-topic"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
url="%PUBURLPATH%/%BASEWEB%/%BASETOPIC%"
upgraded=""
upgrade=""
}%
%ENDSECTION{"download-topic"}%
%STARTSECTION{"download-topic-upgrade"}%
---+++!! Upgrade versions
If you already have Foswiki version an earlier version 1.1.X installed
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
url="%PUBURLPATH%/%BASEWEB%/%BASETOPIC%"
upgraded="upgrade-"
upgrade="upgrade"
}%
%ENDSECTION{"download-topic-upgrade"}%
%STARTSECTION{"download-sourceforge"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
url="http://sourceforge.net/projects/foswiki/files/foswiki/%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
upgraded=""
upgrade=""
}%
%ENDSECTION{"download-sourceforge"}%
%STARTSECTION{"download-sourceforge-upgrade"}%
---+++!! Upgrade versions
If you already have Foswiki version an earlier version 1.1.X installed
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
url="http://sourceforge.net/projects/foswiki/files/foswiki/%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
upgraded="upgrade-"
upgrade="upgrade"
}%
%X% The upgrade packages exclude the files that are typically changed when you customize your installation. The upgrade package can be copied on top of an existing running %FORMFIELD{"ReleaseMajor" topic="%BASETOPIC%"}%.%FORMFIELD{"ReleaseMinor" topic="%BASETOPIC%"}%.X installation for a quick upgrade to %FORMFIELD{"Release" topic="%BASETOPIC%"}%. See [[#Installation][Installation section for details]].
Upgrading to %FORMFIELD{"Release" topic="%BASETOPIC%"}% from a 1.0.X release using the upgrade package is known to have issues. Copying a %FORMFIELD{"Release" topic="%BASETOPIC%"}% upgrade package on top of a 1.0 will leave a lot obsolete files behind which could cause trouble. Using a =LocalSite.cfg= file from a 1.0 system will appear to work, but will cause significant issues with System.QuerySearch. Migration from Foswiki 1.0 to any release of %FORMFIELD{"ReleaseMajor" topic="%BASETOPIC%"}%.%FORMFIELD{"ReleaseMinor" topic="%BASETOPIC%"}% should be done using a reinstall.
%ENDSECTION{"download-sourceforge-upgrade"}%
%STARTSECTION{"download"}%
| *File* | *GPG* | *MD5* | *Description* |
| [[%url%/Foswiki-%upgraded%%release%.tgz][%ICON{download}% Foswiki-%upgraded%%release%.tgz]] | [[%url%/Foswiki-%upgraded%%release%.tgz.asc][GPG]] | [[%url%/Foswiki-%upgraded%%release%.md5][MD5]] | %upgrade% tar gz version of Foswiki |
| [[%url%/Foswiki-%upgraded%%release%.zip][%ICON{download}% Foswiki-%upgraded%%release%.zip]] | [[%url%/Foswiki-%upgraded%%release%.zip.asc][GPG]] | [[%url%/Foswiki-%upgraded%%release%.md5][MD5]] | %upgrade% zip version of Foswiki |%ENDSECTION{"download"}%

Upgrade Instructions

Upgrade package includes the Sandbox.WebHome topic

The topic creator script has been improved, and the Sandbox topic was included in the upgrade package. Normally WebHome topics are never shipped in an upgrade package.

Module version strings and new module dependency since 1.1.6

The Foswiki and default extension version strings have been changed from a developer oriented string Foswiki-1.1.5, Tue, 10 Apr 2012, build 14595, to a simple perl version string - "v1.1.6".
The "RELEASE" string will continue to be more descriptive and can be displayed with a new macro %WIKIRELEASE%.

This adds a new dependency on version 0.77 - the Perl module version class.

Sites using Perl 5.10.1 or newer have the correct version of version.

Sites on older versions of perl should install the latest version using CPAN or their system's package manager.

Before upgrading to Foswiki 1.1.8, verify that the installed version of CPAN:version is at least version 0.77. If not, upgrade CPAN:version before attempting to upgrade Foswiki! For example:

If PatternSkin is installed on an older Foswiki, or the Foswiki-upgrade package is used to upgrade an existing Foswiki system, there is a new required setting that must be added to Main.SitePreferences.

* Set PATTERNSKIN_JQUERY_THEME = PatternSkinTheme

The new System.DefaultPreferences topic shipped with the upgrade package does have this setting, but if you have customized you DefaultPreferences, then this needs to be added.

Also, you'll need to go through one save cycle of configure to register the new JQuery pattern theme in the configuration. (If configure reports no changes, make a minor change and save again, and configure will merge in the changed settings). Or edit the LocalSite.cfg file by hand and add

Other important things to know.

Most extensions released since Foswiki 1.1.6 have converted to formal perl version strings. version->declare('v1.1.6'). The PatchFoswikiContribmust be installed on older versions of Foswiki before installing any of these extensions on older Foswiki versions. Note that they have not been tested on Foswiki 1.0

Installation

Please refer to the INSTALL.html which can be found the downloaded tgz/zip.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.