Foswiki archived release

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

See Release Dates for the complete list of available releases.

Highlights of this maintenance release

  • Contains 58 fixes relative to 2.1.0 (13 marked urgent, and 21 enhancements)
  • New release of JQuery
  • Fixes an urgent cache refresh issue introduced in Foswiki 2.1.1

See ReleaseNotes02x01 for complete release notes.

For administrators:

  • CGI Sessions for guest users are no longer required for User Registration and Password reset to be functional. Disabling guest sessions can reduce the server workload.
  • The cache refresh link has been removed for guest views. Crawlers following the refresh link were invalidating the cache.
  • The Virtual machine image is updated to Ubuntu 16.04 LTS, and compressed with 7zip for faster downloads.

Translation status

As of this release,
  • French, German, Italian, Traditional Chinese and Ukrainian are 100% complete.
  • Czech, Danish are >95% complete.

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.

ALERT! Security alerts or advisories apply to this release: This release is vulnerable to the above alerts. Instructions on how to mitigate these issues are described in the alert details.

Download Foswiki 2.1.2 from sourceforge

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.1.2.tgz GPG MD5 tar gz version of Foswiki
download Foswiki-2.1.2.zip GPG MD5 zip version of Foswiki
download Foswiki-2.1.2-vmware.7z GPG MD5 VM Image (instructions)

Upgrade packages

These packages can be used to upgrade Foswiki Release 2.0.0 or newer. See #Upgrade_Instructions for further information

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

File GPG MD5 Description
download Foswiki-upgrade-2.1.2.tgz GPG MD5 upgrade tar gz version of Foswiki
download Foswiki-upgrade-2.1.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-%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 |%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"}%

Other downloads/installers

This release can also be downloaded from https://github.com/foswiki/distro/releases/tag/FoswikiRelease02x01x02

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

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

Major issues of Foswiki, to be fixed in: 2.1.3

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

Id Summary Component Current State
Item13206
2 years
Upgrade to latest jquery-ui.
distro:a4869c27548d distro:b62305dcc608 distro:73eed2384828 distro:1768d244e512 distro:0c8259c39173 distro:3d01c2c524e9 distro:36a9ba4b29e1 distro:5001db04d277 distro:f3870c623d8d distro:a8c240509d4b distro:d704482cfc1c distro:d7a035b4d1c5 distro:d1ee12222258 distro:e2aa0480f765
JQueryPlugin Closed
Item13785
1 year
ExtensionInstaller fails to replace files under some conditions.
distro:5eec0de413e1
Configure Closed
Item13929
1 year
FileUtil doesn't work correctly with BSD tar.
distro:5c5d515630e2 distro:f5259881391f
Configure Closed
Item13986
1 year
Any changes to a topic text made after pushing the topic to the context stack are ignored even changes are related to topic-level preferences.
distro:9e6a2679b440 distro:e42889fb1a87
FoswikiPrefs Closed
Item14063
1 year
Bootstrap fails to correctly detect path when mod_rewrite engine is disabled.
ConfigureBootstrap Closed
Item14066
1 year
Performance issue sorting list based on NFKD.
distro:67c475371bf6 distro:2855ba789133 distro:140e1c06bc3f
Performance, I18N Closed
Item14068
1 year
Excessive calls of getPreferences(LINKTOOLTIP) causes performance issues.
distro:14838b862dae distro:85585c76df57
Performance Closed
Item14077
1 year
INCLUDE{"topic,list"} fails if first topic is access denied.
distro:276c5d2cf59b
INCLUDE Closed
Item14150
10 month
Reload of a page in the cache fails to recompute strikeone keys.
distro:377070f12059 distro:c47158abfb49 distro:85621e2b8859 distro:2905c8483650
PageCache Closed
Item14195
10 month
Loop in Foswiki::UI::View::revisionsAround under some conditions.
distro:28fd71f27e32
FoswikiUIView Closed
Item14199
9 month
Registration confirmation process corrupts utf-8 wiki names.
distro:e245b22952d6 distro:1625ca487f6d
FoswikiUIRegister, I18N Closed
Item14202
9 month
PageCache tweaks to control dependency growth.
distro:1f7cce363719 distro:fcae5c9a1c81 distro:a9c89610e0f3 distro:d95f1094bb64 distro:ba74813eca53 distro:d39fa8e270e4 distro:64a9660e8e5f distro:7c45a419dc7f distro:13d6306c25fc
PageCache, Performance Closed
Item14205
8 month
Autoconfig Email failing with recent versions of IO::Socket::SSL.
distro:a5aef45c6d8e distro:a7b968afa065 distro:74d590a945a0 distro:ed6218fd5e0d distro:d079f79e1dff distro:8e8072443df4 distro:27821cd0f1c6 distro:8ff14e444ad7 distro:b8a202c056e4 distro:f174302b06d1 distro:9311e8673b5b
Configure, FoswikiNet Closed
Item14216
8 month
MailerContrib mailnotify fails with wide character print when run from Web when unicode webnames are in use.
distro:9884d569b364
MailerContrib Closed
Item14218
8 month
EditRowPlugin: edit button does not work when using Internet Explorer.
distro:de9f41895910 distro:a9cbe5b970c6
EditRowPlugin Closed
Item14221
8 month
Regression: writing to STDERR is broken under FastCGI
distro:f6350568d343 distro:979a36337181 distro:bed56ea09954
FastCGIEngineContrib Closed
Item14238
7 month
Documentation for the reverted META:CREATEINFO is still in the release.
distro:7ef3217d9882
Documentation, QUERY Closed
Item14256
7 month
Data loss of certain formfield names when moving content from 1.x to 2.x.
distro:47238cf68eef distro:026a713017d6
DataForms Closed
Item14266
6 month
Error enabling internationalization and languages
distro:aed1dc434a85 distro:dc9eb0e10ae3
Configure, I18N Closed
Item14279
6 month
CLI tools/configure fails to encode Password when run in prompting mode
distro:69f877a70c63 distro:4009a9a894e8
Configure Closed
Item14308
5 month
Configure extensions review crashes if plugin module uses "$RELEASE = $VERSION".
distro:913c0b3250d0
Configure Closed
Item14309
5 month
Old SVN based extensions don't compare as older than new Decimal versioned extensions
distro:d3079655bd5d
Configure Closed
Item14312
5 month
don't destroy dialogs on close
distro:6c8cda079abb
JQueryPlugin Closed
Item14315
5 month
ASSERT in Meta.pm when viewing prior revisions of topics with attachments.
distro:54c394fad3a6 distro:e85d6378e992
PatternSkin, QUERY Closed
Item14317
5 month
Under some conditions, Support.JEditableContrib attempts to load an .uncompressed.js source, which is not in the distribution.
distro:64f00248e312
JEditableContrib Closed

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 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.0.x.tgz

If upgrading from Foswiki 2.0.0, all working/tmp/cgisess_* files must be deleted. All users will have to log in after the upgrade. (This change was introduced in Foswiki 2.0.1.)

After upgrading from Foswiki 2.0.x, you should visit configure, enable "Expert" options, and visit the Security and Authentication > Environment tab, and "Reset" the "Name Filter" and "Upload Filter" to their default settings, in order to apply updated defaults.

The following files may be removed after upgrading from Foswiki 2.0.x to Foswiki 2.1.0:
  • pub/System/UserRegistration/js.js
  • pub/System/DefaultUserRegistration/validate.js
  • ReleaseNotes02x00.html

Upgrading from Foswiki 1.x.

Caution:There are a number of significant changes that require action before migrating data from release 1.0 and 1.1. Carefully review the release notes for ReleaseNotes02x00
  • 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 now 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, cpanm, or CpanContrib
  • Perl 5.8.8 is the minimum perl release. Perl 5.20 or higher is recommended for best performance.
  • 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.

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 - 04 May 2016, GeorgeClark - This page was cached on 24 Jul 2017 - 01:47.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License