Foswiki archived release

See Release Dates for the complete list of available releases. Foswiki 1.1.1 was built 25 Oct 2010. It is a release that fixes some important bugs that were introduced in 1.1.0. It is highly recommended that all running 1.1.0 upgrade to 1.1.1.

Foswiki 1.1 introduces jQuery Javascript user interface framework, improved topic history display, new QUERY and FORMAT macros, better user interface for group management, much improved WYSIWYG editor, facelift of the default skin, much improved configure tool, and many more enhancements.

Foswiki 1.1 has many improvements that end-users as well as administrators will appreciate. In addition Foswiki 1.1 comes with a lot of "under the hood" improvements to the core code, with the goal of making it easier to plug in work from other projects, such as jQuery, KinoSearch, Solr and others. Work has been made to improve the definition of internal APIs to allow other not-yet-written modules, such as store implementations. Most of these modifications should be invisible to the end user and admin, but are important to position Foswiki for the next generation of plugins.

• Changes from 1.0.10
• List of tasks completed for 1.1.1

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

Upgrade packages

If you already have an earlier version of Foswiki 1.1.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.

Upgrade packages must not be used to upgrade older releases.

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

Platform	Version	File	Description	Support
Windows	1.0.10	Foswiki-1.0.10-0-strawberry.exe	Foswiki v1.0.10.0 Windows installer (auto-setup) including Strawberry Perl 5.12.1.0, Apache 2.2
Windows	1.0.9	Foswiki on a USB Stick	strawberry perl, no installation required (64MB v0.5)
Mac OS X 10.5 Mac OS X 10.6	1.1.0	Foswiki-1.1.0-1.dmg (GPG)	Foswiki v1.1.0 Mac OS X 10.5/10.6 installer package	FoswikiOnMacOSXLeopard
Linux (debian)	1.0.9 (plugins follow the Extensions web uploads)	Unofficial Debian packages repository for Foswiki and extensions	Foswiki v.1.0.9 and 233 Extensions with dependencies. Works for Debian and Ubuntu.	Repository instructions
Linux (shared host with ssh login)	1.0.10-3	Foswiki-1.0.10-SharedHosting-3.tgz (MD5)	tailored to shared hosting with shell access, this is Foswiki v.1.0.10 (including all patches for KnownIssuesOfFoswiki01x00, currently LocalSite.cfg is continuously appended) and FastCGI support using mod_fcgid	FoswikiOnLinuxSharedHostCommandShell

Other release packages

Platform	Version	File	Description	Support
VM	1.0.9	Virtual Machine Image	An easy-to-setup software appliance for VMware or VirtualBox. Not recommended for professional installations.	VirtualMachineImages
-	latest SVN or any release	Subversion-based install	Installs based on subversion: check out the latest version from the development trunk, or a specific release version	SubversionBasedInstall

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

Installation

System requirements and general installation instructions - relevant for all platforms

Platform-specific installation instructions

Foswiki: Introduction

Foswiki is an enterprise collaboration and information sharing tool targeted for professional use in many types of companies—from small businesses to large organizations.

Foswiki is a wiki: a website with easily editable web pages. It looks like a normal web site but it encourages contributions, edits, updates, questions, and answers from its users. It's a powerful way of enabling a community to communicate asynchronously using intranet or public internet websites. Foswiki is simple to learn and use. It aims to provide a transparent way for you to publish and exchange your ideas with others over the web and eliminates the one-webmaster syndrome of outdated intranet content.

Foswiki supports storing structured data—name-value pairs—and provides advanced query tools that enable users without programming skills to build powerful yet simple applications to process information and support workflows. Developers can extend the functionality of Foswiki with plugins.

Foswiki is a fork from the TWiki project. Restrictions on the use of the TWiki brand resulted in many of its developers starting the Foswiki project. Foswiki is backwards compatible with all content from older TWiki installations.

Foswiki 1.1 ships with TWikiCompatibilityPlugin installed by default, thus if activated enables most extensions made for TWiki to work under Foswiki.

Foswiki is released under the GNU General Public License.

What's new - highlights:

• Adoption of the jQuery Javascript user interface framework
• New macros enabled by jQuery
• Powerful new QUERY macro
• SEARCH now has a zeroresults format string and search results pagination
• New FORMAT macro
• WikiGroups have add & remove user interface
• TinyMCEPlugin updates include much better user interface, rowspan support, and autosave feature
• Testing configuration variables in %IF
• "Copy topic" now copies attachments
• Tailoring of user registration made easier
• Easy tailoring of reset/change password and change email forms
• TMPL:DEFs may now access previous (overridden) TMPL:DEF using the new %TMPL:PREV% template token
• Logging of access failures
• configure user interface revamped
• Configure file system checks added
• Newer modern Icon set for Document Graphics
• Table Plugin has been improved
• SlideShowPlugin can now use CSS based templates
• HistoryPlugin and CompareRevisionsAddOn are now included with the default plugin set giving much nicer history/changes features
• AutoViewTemplatePlugin is now included with the default plugin set
• ZonePlugin feature set has been merged to the core Foswiki code
• New page cache feature
• Several API Enhancements for extension writers

Security Updates

Foswiki has been continously been hardened against malicious attacks:

• In Foswiki 1.0 the powerful, but highly vulnerable, URLPARAM macro is secured by default against cross site scripting (XSS) attacks. URLPARAM now encodes a short list of unsafe characters '"<>% which eliminates most XSS vectors.. This means that not only the distributed topics, but also your own topics are better protected against XSS.
• Functions QUERYPARAMS, ORIGURL (skin macro) are secured against XSS attacks. QUERYPARAMS, like URLPARAM, is now encoded with the new, safe encoding.
• Print preview link is no longer vulnerable to XSS attacks.
• You can no longer save any data with http GET method. All saving of data must now happen using the POST method which means that you cannot save data using <a... tags, <img... etc. Data must be posted using a real HTML form with method "post".
• Foswiki 1.0.6 introduces a major security enhancement, protecting against Cross-Site Request Forgery. The extra safe "double submit" algorithm, as recommended by the Open Web Application Security Project (OWASP) project has been used. This is the same algorithm used by several major banks and other security-conscious institutions, and requires that users have Javascript enabled. With 1.0.7 an enhancement has been made so attachments are also protected by this method.
• Foswiki 1.0.7 extends the strikeone protection to also include attachment of files
• Foswiki 1.0.9 extends the strikeone protection to also include user registration. Default minimum password length is now 7 characters (does not apply when upgrading)
• Foswiki 1.1.0 has been further hardened against tainted input data. Strikeone protection has been added also to reset password and change email

Upgrading from an earlier version of Foswiki 1.1.X

To upgrade from an earlier 1.1.X version:

• Download the Foswiki upgrade package.
• Unpack it in a temporary directory.
• Remove any files you know you do not want overwritten. The Foswiki upgrade package does not include any files with preference settings or other configuration information.
• Take a backup of your running Foswiki 1.1.X (just in case).
• Copy all the files from the upgrade directory on top of your existing Foswiki 1.1.X installation.
• Run a chown -R apache:apache (replace apache with the username your web server runs as) to make sure all files are owned by the web server user (or by whatever user is appropriate for your installation).
• Windows Installations! If you run Foswiki on a Windows server (or on a Unix system where your Perl executable is in a non-standard location) you should note that the upgrade package also renews all files in the bin directory. You will need to reapply the change in the first line (the shebang line) that points to the location of the perl binary.
• You should now run Foswiki 1.1.1.
• Note: You'll need to restart the web server if you're using mod_perl or FastCGI)

Upgrading from an earlier version of Foswiki 1.0.X

The best way to upgrade to a new minor or major release release is to make a fresh parallel installation and get this to work.

After this you install the latest versions of all the extensions you had in the previous installation. Note that 1.1 has additional extensions included and that ZonePlugin is now integrated in the core code and should not be installed.

If you have tailored PatternSkin you should apply the same customisations to the 1.1 installation. You may need to make minor adjustments as the 1.1 Pattern Skin has had a facelift.

Some important notes around the topics you will normally have tailored.

• WebLeftBar can be copied from the old to the new installation
• WebTopBar has been slightly changed. You can use your old topic and copy over the code for the jump and search fields.
• The topic UserRegistration has been enhanced so it now determines whether a custom user registration page exists in Main, and includes it if it does; otherwise it includes System.DefaultUserRegistration. So if you had a tailored System.UserRegistration in 1.0.X - copy it to the Main in the new installation.
• The topics System.ResetPassword and System.ChangePassword now only show the change forms when Foswiki is managing the passwords (the configure setting {PasswordManager} set to a manager that handles setting of passwords). If the {PasswordManager} does not support password changing, the ChangePassword and ResetPassword topics will show a simple message. This message is defined iby the preference CHANGEPASSWORDDISABLEDMESSAGE in System.DefaultPreferences. You can redefine this setting by copying it to Main.SitePreferences and change it to include a link to the password management website of your organisation.
• ChangeEmailAddress will now guide the user to define the email address in the user topic when the PasswordManager does not handle hidden email addresses, so you should not need to tailor this topic any longer.

When you have a working installation you can simply copy all your webs from the 1.0.X to the 1.1 installation. Simply copy the directories in the Foswiki data and pub directories except the webs that are distributed with Foswiki. For the Main web you will probably want to copy all the files from the 1.0.X to 1.1 without overwriting the files distributed with 1.1. You may need to manually merge

Upgrading from TWiki

Foswiki is compatible with content of TWiki releases up to and including 4.3.1, as part of its design.

As part of the creation of the Foswiki project, the Foswiki community is evaluating all of the hundreds of extensions that are available for TWiki. All those that work are being ported over to the Foswiki name space. As part of this process many of them are being enhanced through the removal of bugs and security vulnerabilities, resulting in better, more functional, quality assured extensions for Foswiki. The most popular extensions are already ported, and more are added every day.

If you are upgrading, please first read the version 1.1 release notes and follow the instructions in the UpgradeGuide. These two documents can also be found as HTML documents in the root of the distribution.

Resources

• Release notes for 1.0
• Release notes for 1.1
• UpgradeGuide
• Known issues for 1.1
• Bug reports
• Support Requests
• SystemRequirements
• Foswiki consultants

GPG Signature

GPG signatures are provided to allow verifying the integrity of the downloaded files.

The Foswiki release packages are built by release manager KennethLavrsen who has signed the files using GPG signature. You can find the public key at http://www.lavrsen.dk/publickey.htm. ERROR: syntax error, at EOF To verify GPG signature:

• Download the relevant GPG public key to your keyring
• gpg --verify <.asc> <.tgz|.zip>

In addition plain MD5 signatures are provided.

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

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 2010-10-25
• Publish date 2010-10-25
• Built from http://svn.foswiki.org/branches/Release01x01 svn revision 9743