Foswiki archived release

alert This release is superseded by Foswiki 2.1.8. Visit the download page.

See Release Dates for the complete list of available releases.

Highlights of this release

  • 65 fixes and 5 enhancements
  • Major performance bug fixed in Query search. Some sites have seen 350% improvement.
  • Several "Severity 3" security issues fixed. Documented in tasks per the Foswiki security process.
  • Configuration wizard added to incorporate manually installed extensions and check for configuration errors from the command line.

See ReleaseNotes02x00 for complete release notes. See FoswikiRelease02x00x00 for highlights of the 2.0 release.

For users:

  • Several significant compatibility fixes to the EditRowPlugin make it much more viable as a replacement for the EditTablePlugin

For administrators:

Translation status

As of this release,
  • Traditional Chinese, Danish, French, German and Italian are >99% complete.
  • Czech is >96% complete.
  • Dutch, Norwegian, and Portuguese (Brazil) are 70-88% complete.
  • Other languages are 60% complete or lower.

For more details on translation status, see Foswiki:Community.TranslationTeam and Foswiki's Weblate translation server. Foswiki is now using continuous translation, so contributions at any time are very helpful. Foswiki thanks the Translators for their Herculean efforts. If you are interesting in helping with the translation, please contact foswiki-translations@lists.sourceforge.net.

Download

GPG Signatures and MD5 checksums are provided for verifying the integrity of the files for the primary download packages.

File GPG MD5 Description
download Foswiki-2.0.2.tgz GPG MD5 tar gz version of Foswiki
download Foswiki-2.0.2.zip GPG MD5 zip version of Foswiki

Upgrade packages

If you already have an earlier version of Foswiki 2.0.X installed, you can extract an upgrade package on top of the installation. The major.minor part of the release should not be changed by an upgrade package.

ALERT! Upgrade packages must not be used to upgrade older releases.

File GPG MD5 Description
download Foswiki-upgrade-2.0.2.tgz GPG MD5 upgrade tar gz version of Foswiki
download Foswiki-upgrade-2.0.2.zip GPG MD5 upgrade zip version of Foswiki

%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.GitBasedInstall.</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"}%
%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"}%
%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"
}%
%ENDSECTION{"download-sourceforge-upgrade"}%

%STARTSECTION{"download-github"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="https://github.com/foswiki/distro/releases/download/%FORMFIELD{"ReleaseTag" topic="%BASETOPIC%"}%"
  upgraded=""
  upgrade=""
}%
%ENDSECTION{"download-github"}%

%STARTSECTION{"download-github-upgrade"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="https://github.com/foswiki/distro/releases/download/%FORMFIELD{"ReleaseTag" topic="%BASETOPIC%"}%"
  upgraded="upgrade-"
  upgrade="upgrade"
}%
%ENDSECTION{"download-github-upgrade"}%

%STARTSECTION{"download"}%
%TABLE{sort="off"}%
| *File* | *GPG* | *MD5* | *Description* |
| [[%url%/Foswiki-%upgraded%%release%.tgz][%ICON{download}% Foswiki-%upgraded%%release%.tgz]] | [[%url%/Foswiki-%upgraded%%release%.tgz.asc][GPG]] | [[%url%/Foswiki-%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-%release%.md5][MD5]] | %upgrade% zip version of Foswiki |%IF{"'%upgraded%'='' and '%FORMFIELD{"VMImage" topic="%BASETOPIC%"}%'='1'" then="
| [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%][%ICON{download}% Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%]] | [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%.asc][GPG]] | [[%url%/Foswiki-%release%-vmware.md5][MD5]] | [[Support.VirtualMachineImages][VM Image (instructions)]] |"}%%ENDSECTION{"download"}%

%STARTSECTION{"upgrade-header"}%
---++ Upgrade packages

%IF{"'%BASETOPIC%'/UpgradeFrom=''" 
   else="These packages can be used to upgrade __Foswiki Release %FORMFIELD{"UpgradeFrom" topic="%BASETOPIC%"}% or newer__. See [[#Upgrade_Instructions]] for further information"
   then="If you already have an earlier version of Foswiki %FORMFIELD{"ReleaseMajor" topic="%BASETOPIC%"}%.%FORMFIELD{"ReleaseMinor" topic="%BASETOPIC%"}%.X installed, you can extract an upgrade package on top of the installation. The =major.minor= part of the release should not be changed by an upgrade package."}%

%X% Upgrade packages must not be used to upgrade older releases.

%ENDSECTION{"upgrade-header"}%

Getting help & providing feedback

Don't forget to use the upgrade or installation guides. If you need help, there are several options:

We want to hear from you! Especially if you have noticed a bug, have some ideas we could use, or just want to contribute:

Known issues

There are still limitations with the store conversion script bulk_copy.pl in Foswiki 2.0.1. Carefully review the limitations documented in the UpgradeGuide before converting your store.

The following issues have been reported against FoswikiRelease02x00x02. Tasks in "Closed" or "Waiting for Release" state will be fixed in the next release.

Major issues of Foswiki, to be fixed in: 2.0.3

The following "urgent" issues have been marked for resolution in Foswiki 2.0.3

Id Summary Component Current State
Item13519
8 years
Foswiki should clearly report missing dependencies. Don't crash with 500 Internal Server Error.
distro:b3ebab2baa48 distro:3b31eb52e2bc distro:4b424853d4c2 distro:1fc7340f4a00 distro:0987542d7058
Configure Closed
Item13816
8 years
Configure doesn't work on IE9, IE does not support console.log or console.debug.
ConfigurePlugin Closed
Item13817
8 years
EditRowPlugin performance issues with tables > 100 rows.
distro:b8d4648f340a distro:71ec7495ddf1 distro:07dfb9bd5441
EditRowPlugin Closed
Item13830
8 years
Attachments with special characters (umlauts) in Foswiki 2.0.2 with mod_perl, reported as missing or empty file.
distro:072e35817178 distro:c9bf5a4f67a1 distro:8b8a83b0d915
ModPerlEngineContrib Closed
Item13834
8 years
EditRowPlugin cannot edit cells that contain Umlauts and other non-ASCII characters.
distro:5c91079656f2
EditRowPlugin Closed
Item13837
8 years
Foswiki::Func::getScriptUrl() generates broken URL if any parameters contain embedded # characters.
distro:4bc7094810ad
FoswikiFunc Closed
Item13839
8 years
UserMapping: validateRegistrationField is too strict on usernames - unable to add users containing underscore.
distro:f853dd1b0a1f
UserMapping Closed
Item13845
8 years
bulk_copy.pl fails to copy Support.WebPreferences topic if RcsWrap is in use.
distro:876a2396b8e9 distro:494cf991e023
FoswikiTools Closed
Item13850
8 years
Uninitialized variable trying to remove a undefined user from a group.
distro:c8cb7ef1e48d
GROUPINFO Closed
Item13852
8 years
CommentPlugin should warn about COMMENT permissions.
distro:5a38853fd6a5 distro:275ba8a0b1d9
CommentPlugin Closed

Upgrade Instructions

Upgrade packages are provided Foswiki 2.0.0-1. In-place upgrade from any release prior to Foswiki 2.0.0 is not recommended. Foswiki 1.x installation should install Foswiki 2.0.2 as a new release, configure, and then migrate data to the new installation.

ALERT! Caution:There are a number of significant changes that require action before migrating data from an old release. Carefully review the release notes.
  • 2.0.1 requires that all working/tmp/cgisess_* files be removed during the upgrade. All users will have to log in again after the upgrade.
  • JavaScript is now required for many operations.
  • New default PlainFileStore cannot coexist with existing RCS revision files. If new store is selected, a conversion script must be run.
  • Foswiki now defaults to utf-8, Before importing data, you must either match previous encoding, or convert the data from the old store to the new character encoding.
  • Empty DENY rules must be changed to ALLOW * wildcards. Or the old feature must be enabled in the configuration.
  • Sessions use IP Matching by default. If your site supports roaming / mobile users or is behind a proxy, this must be disabled.
  • Installation process has changed. Do not visit bin/configure as your first URL. Go directly to your default view url and then follow the link to configure.
  • Foswiki no longer ships with CPAN perl modules. Install CPAN prerequisites using your local system package manager, or cpanm
  • Perl 5.8.8 is the minimum perl release. Perl 5.18 or higher is recommended.
  • Foswiki now predominantly uses 'single quotes' in generated HTML, and "double quotes" in macros. The change to singe quotes in generated HTML may require some rework of Foswiki macros.
  • Some versions of CGI should be avoided (especially 4.10-4.13) to prevent corruption of international characters in topics when utf-8 is enabled.

Installation

Please refer to the INSTALL.html which can be found the downloaded tgz/zip. It can be also found on Foswiki.org in the System.InstallationGuide

Upgrade Instructions

In-place upgrade from any release prior to Foswiki 2.0.0 is not recommended. Older Foswiki installations should install Foswiki as a new release, configure, and then migrate data to the new installation.
  • See System.UpgradeGuide for details on upgrading from older versions of Foswiki
  • See System.SystemRequirements for the latest System Requirements.
  • Be sure to take a backup!
  • The upgrade packages excludes files "commonly" modified, for example, WebHome, WebPreferences, AdminGroup, etc. If your installation has modified other topics, or template files, those updates will be lost!
  • If you use tar, then you can extract the upgrade package on top of your installation by using: (Be sure to run this as your web server user to avoid changing file ownership.)
cd /var/www/foswiki
tar --strip-components=1 -zxf /path/to/Foswiki-upgrade-2.x.x.tgz
cd tools
./configure --save
  • Similarly, if you are using the zip upgrade package, then
cd /var/www/foswiki
unzip -o /path/to/Foswiki-upgrade-2.x.x.zip
cd tools
./configure --save

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.
  • See the GNU General Public License for more details, published at http://www.gnu.org/copyleft/gpl.html

Release Details

Topic revision: r2 - 01 Oct 2015, GeorgeClark
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy