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 maintenance release

  • Contains 122 fixes relative to 2.1.0 (42 of which are enhancements)
  • Contains 31 fixes since 2.1.3
  • Fixes several security issues.

See ReleaseNotes02x01 for complete release notes.

Note: This release was re-uploaded on June 1st due to a build error resulting in an incorrect VERSION string. Purely cosmetic issue.

For users

  • Several rendering issues in EditRowPlugin have been addressed.
  • Improved operation when Foswiki is installed behind a reverse proxy.

For administrators:

  • Configure warning icons get "stuck" requiring a reload of configure.
  • UpdatesPlugin doesn't reveal which extensions require updated.
  • Fixed an issue on Lighttpd where users cannot log in.
  • Improved compatibility with Perl 5.25 / 5.26

Translation status

As of this release,
  • Chinese (Taiwan), French, Italian and Ukrainian are 100% complete.
  • Danish and German 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

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.4.tgz GPG MD5 tar gz version of Foswiki
download Foswiki-2.1.4.zip GPG MD5 zip version of Foswiki
download Foswiki-2.1.4-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.4.tgz GPG MD5 upgrade tar gz version of Foswiki
download Foswiki-upgrade-2.1.4.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"}%

Other downloads/installers

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 FoswikiRelease02x01x04. 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.5

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

Id Summary Component Current State
Item14445
6 years
Excel fails to open a password protected link to Foswiki.
distro:4bd6441340da distro:d9c5e1e57fa8 distro:3f487ae34e83
  Closed
Item14515
6 years
Foswiki 2.1.3 cannot run on Windows "Aux" is a reserved filename on windows.
distro:1c5967e56068
PlatformWindows Closed
Item14544
6 years
SCRIPTURL breaks when X-FORWARDED-HOST has multiple values.
distro:3745b3212142 distro:2f4a4774c108 distro:b8511bbae77b distro:977c548178ba distro:b248f35bea3c
ConfigureBootstrap, FoswikiEngine, FoswikiRequest Closed
Item14574
6 years
HTML cellspacing attribute has no effect.
distro:2de3def6ca48 distro:376bfd55ea67 distro:d2921c5c0cc3 distro:e945968c29eb distro:49ad329a8dc3 distro:d0500bd4c7cd
TablePlugin Closed
Item14584
6 years
jquery.wikiword changed interpretation of source parameter in a incompatible way
distro:704791e9669b distro:7be6c1050398
JQueryPlugin Closed
Item14591
6 years
Store fails to read old revisions with RcsWrap store, if .txt file is modified.
distro:f10e35343ead distro:821a3105f247 distro:23cb44c22f23 distro:ddb7e43dfc96
RCSStoreContrib Closed
Item14605
6 years
Unescaped brace in Regular Expression, Perl 5.27.8
distro:1de30cd826b2 distro:a3d11f56e5f8 distro:9ae136a50d4e distro:25c64351f28e
PlatformPerl 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.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

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.)

If upgrading from Foswiki 2.1.2 or earlier, all files in working/registration_approvals should be removed. Pending registrations will be lost.

Before upgrade, the pub/System/JQueryPlugin directory can be backed up and removed. A large number of the js and css files have been relocated. This optional step will clean up a number stale files.

If your site has configured the Expert {Sessions}{CookieRealm} setting, this release will now apply the realm to all of the cookies generated by Foswiki. This might require some users to clear their cookies for proper operation.

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
  • If you have any DataForms using Unicode (non A-Za-z0-9) formfield names, you should enable the expert configuration setting: $Foswiki::cfg{LegacyFormfieldNames}
  • 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: r4 - 02 Dec 2017, GeorgeClark - This page was cached on 03 Mar 2024 - 15:12.

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