Foswiki archived release

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.

Download

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

File	GPG	MD5	Description
Foswiki-2.1.2.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-2.1.2.zip	GPG	MD5	zip version of Foswiki
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

Upgrade packages must not be used to upgrade older releases.

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

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:

• The IRC channel
• foswiki-discuss mailing list
• Support forum
• Paid support

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

• File a new task for bug reports
• Create, review or comment on feature proposals to help influence the future of Foswiki
• Chat with other users, developers, translators, and testers on our friendly IRC channel
• If E-mail is more your thing, try our foswiki-discuss mailing list

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 9 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 8 years	ExtensionInstaller fails to replace files under some conditions. distro:5eec0de413e1	Configure	Closed
Item13929 8 years	FileUtil doesn't work correctly with BSD tar. distro:5c5d515630e2 distro:f5259881391f	Configure	Closed
Item13986 8 years	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 7 years	Bootstrap fails to correctly detect path when mod_rewrite engine is disabled.	ConfigureBootstrap	Closed
Item14066 7 years	Performance issue sorting list based on NFKD. distro:67c475371bf6 distro:2855ba789133 distro:140e1c06bc3f	Performance, I18N	Closed
Item14068 7 years	Excessive calls of getPreferences(LINKTOOLTIP) causes performance issues. distro:14838b862dae distro:85585c76df57	Performance	Closed
Item14077 7 years	INCLUDE{"topic,list"} fails if first topic is access denied. distro:276c5d2cf59b	INCLUDE	Closed
Item14150 7 years	Reload of a page in the cache fails to recompute strikeone keys. distro:377070f12059 distro:c47158abfb49 distro:85621e2b8859 distro:2905c8483650	PageCache	Closed
Item14195 7 years	Loop in Foswiki::UI::View::revisionsAround under some conditions. distro:28fd71f27e32	FoswikiUIView	Closed
Item14199 7 years	Registration confirmation process corrupts utf-8 wiki names. distro:e245b22952d6 distro:1625ca487f6d	FoswikiUIRegister, I18N	Closed
Item14202 7 years	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 7 years	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 7 years	MailerContrib mailnotify fails with wide character print when run from Web when unicode webnames are in use. distro:9884d569b364	MailerContrib	Closed
Item14218 7 years	EditRowPlugin: edit button does not work when using Internet Explorer. distro:de9f41895910 distro:a9cbe5b970c6	EditRowPlugin	Closed
Item14221 7 years	Regression: writing to STDERR is broken under FastCGI distro:f6350568d343 distro:979a36337181 distro:bed56ea09954	FastCGIEngineContrib	Closed
Item14238 7 years	Documentation for the reverted META:CREATEINFO is still in the release. distro:7ef3217d9882	Documentation, QUERY	Closed
Item14256 7 years	Data loss of certain formfield names when moving content from 1.x to 2.x. distro:47238cf68eef distro:026a713017d6	DataForms	Closed
Item14266 7 years	Error enabling internationalization and languages distro:aed1dc434a85 distro:dc9eb0e10ae3	Configure, I18N	Closed
Item14279 7 years	CLI tools/configure fails to encode Password when run in prompting mode distro:69f877a70c63 distro:4009a9a894e8	Configure	Closed
Item14308 7 years	Configure extensions review crashes if plugin module uses "$RELEASE = $VERSION". distro:913c0b3250d0	Configure	Closed
Item14309 7 years	Old SVN based extensions don't compare as older than new Decimal versioned extensions distro:d3079655bd5d	Configure	Closed
Item14312 7 years	don't destroy dialogs on close distro:6c8cda079abb	JQueryPlugin	Closed
Item14315 7 years	ASSERT in Meta.pm when viewing prior revisions of topics with attachments. distro:54c394fad3a6 distro:e85d6378e992	PatternSkin, QUERY	Closed
Item14317 7 years	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

• 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

• After upgrade, restart the web server, clear the foswiki page cache, clear your browser cache.
• If things are not fully working, verify file system permissions and ownership. See System.InstallationGuide#Step_2:_Confirm_file_and_directory_ownership_and_permissions

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

• Build date 2016-05-02
• Publish date 2016-05-02
• Built from github commit cf13c7ddb7