Foswiki upgrade

Check version numbers before and after

• System
• FoswikiServerInformation
  • here you can see e.g. that Image::Magick has no version number... (FwExtensionRequirements#ImagePlugin)

First the core (backup before and after), then the extensions:

1. Backup: Always back up your current installation.
2. Install Core: Unpack the new Foswiki core release over the old installation or into a new directory.
3. Run configure: Run the bin/configure script to fix up configuration settings and verify the new installation.
4. Install Extensions: Install the latest versions of your plugins/extensions to match the new core version.
5. Migrate Data: Move over topics, users, and site customizations from the old version.

2.1.6 ► 2.1.7 ► 2.1.8 ► 2.1.9 ► 2.1.11

Of kan het ook eenvoudiger?

Foswiki 2.1.11 is released

'Mijn' procedure:

• go to /configure, enable Expert mode and note down the disabled extensions
• create a modified .tgz file according to the instructions below (solution)
• copy it...
  • hsq webhosting: to the root of your wiki site
  • strato vps: to the folder above your wiki site (htdocs)
  • aws vps: to the folder above your wiki site (srv)
• unpack it:
  • hsq webhosting: !DirectAdmin File Manager
  • strato vps & aws ec2: sudo tar -xzvf Foswiki-Version.mod.tgz
• now your wiki site will be unavailable (hsq, 403)
• execute fix_file_permissions.sh (FwFixFilePermissions)
  • execute this shell script from the root of your wiki site
• strato vps & aws ec2: change owner and group of your wiki: chown -R www-data:www-data !yourWikiFolder
• hsq webhosting: correct the permissions of all wiki subdirectories (bin ► working): rwxr-xr-x (NOT recursively)
• correct the permissions of the .htaccess files (FwFixFilePermissions)¹: +r others
  • root (hsq)
  • bin (hsq)
  • pub (hsq)
  • pub/System (hsq)
  • (sEmbedder) (hsq & strato)
• execute the rewriteshebang.pl script
  • execute this script from within the tools directory
  • if everything is alright, the correct path will be suggested (Enter path to interpreter [hit enter to choose '...'])
  • so just hit enter if the indicated path is correct
  • most .pl scripts and some other files (e.g. configure) will get a modified first line (the line that points to the perl interpreter)
• now your wiki site will be available
• now first make a backup
  • indicatief: 2.1.9 tar was 526 MB groot, de tar.gz 179 MB
    na opkuis een tar van 458 MB , en een tar.gz van 139 MB
  • doorgaans is er een tar.gz aanwezig, dus voorzie daarnaast zeker 550MB aan ruimte!
• remove the .tar.gz file
• remove the !UpdatesPlugin which is installed by default
• check the wiki/working/logs/error.log
• also empty the subfolders from wiki/working/configure: i.e. backup, download and pkgdata - this way you save a lot of precious space
• empty the wiki/working/logs/configure directory as well
• update all extensions and keep track of the progress
  • FwExtensionsUpdateBoossy
  • FwExtensionsUpdateBousard
  • FwExtensionsUpdateExplio
• check the wiki/working/logs/error.log once more
• then make a final backup of the environment updated with the core and the extensions!

¹ anders zie je foutmeldingen in de log à la: [Timestamp] [core:crit] [pid …:tid ...] (…)Permission denied: [client ...] AH00529: /.../wiki/.htaccess pcfg_openfile: unable to check htaccess file, ensure it is readable and that '/.../wiki/' is executable

jQuery

In v2.1.11, on all three environments, I still use jquery 2.2.4.

In /bin/configure, under Extensions > !JQueryPlugin > General settings, scroll down, remark next to jQuery Version:

• in v2.1.9: "Note that jquery-3 is not tested on Foswiki."
• in v2.1.11: "Note that jquery-3 and jquery-4 are still considered experimental on Foswiki."

The Deprecated Modules tab shows:

• Boossy v2.1.11: Metadata checkbox is not checked
• Bousard v2.1.11: Metadata checkbox is not checked
• eXplio v2.1.9 & v2.1.11: Metadata checkbox is checked - WARNING: "Meta has been deprecated. Please use HTML5 data attribures instead." -- See https://foswiki.org/Support/Foswiki219_NatSkin_jQuery, remains required, even in v2.1.11, or not...

Natskin

See: FwNatSkin

fcgid

• hsq: nvt (shared hosting)
• strato & aws: fcgid => /bin/configure, Security and Authentication section, Passwords tab: enable Cache Passwords (Enable password caching for better performance when using Mod_Perl or FastCGI /FCGID) => also enable Detect Modification of Password File

Tests achteraf

• create & save a new topic
• copy a new topic: https://foswiki.org/Support/NatskinCopyTopicResultsIn500Error
• insert an image in a topic

Upgrade instructions for shared hosting environments

Problem

If you unpack the .tgz file on your shared hosting environment, it is unpacked in a Foswiki-upgrade-2.1.x folder by default.

If you then try to move the files and folders to the location where your foswiki is installed on your shared hosting environment, this is impossible: files are copied, but directory's aren't. You get an error:

• e.g. in DirectAdmin file management: "cannot copy directory … into an existing directory"
• e.g. in WinSCP: Error moving file '' to '/path/where/your/foswiki/is/installed/' - Rename /path/where your/foswiki/is/installed/: Directory not empty

Solution

• download the Foswiki-upgrade-2.1.x.tgz file
• open the .tgz archive
• open the .tar archive
• rename the Foswiki-upgrade-2.1.x folder to the folder name of your wiki installation on your shared hosting environment (e.g. wiki if your foswiki is installed in /domains/mydomain.ext/public_html/wiki/)
• close the archive and confirm the prompt to save the modified archive
• copy the modified .tgz file to your shared hosting environment in the folder above your wiki folder (for example, in /domains/mydomain.ext/public_html/ if your wiki is installed in /domains/mydomain.ext/public_html/wiki/)
• unpack the .tgz file: all files are correctly overwritten
• finally, refresh any cached files by surfing to your.www.iki/?refresh=all

Remaining issues after the installation of version 2.1.6

Dependency Report for MetaCommentPlugin ...
INSTALLED

Foswiki::Contrib::JsonRpcContrib version 08 Apr 2017 installed
Foswiki::Plugins::RenderPlugin version 16 Jan 2017 installed
Foswiki::Plugins::ImagePlugin version 09 Sep 2017 installed
Foswiki::Plugins::DBCachePlugin version 12 Dec 2017 installed
Foswiki::Plugins::LikePlugin version 02 Sep 2016 installed

MISSING

Foswiki::Plugins::SolrPlugin version >=4.0 required -- perl module is not installed - Optional. - Optional dependency, will not be automatically installed

Cache::Cache
JSON::XS
Moo

*************************************************************************

Installing MediaElementPlugin
Loading package installer

fetching MediaElementPlugin installer from https://foswiki.org/pub/Extensions/...
Dependency Report for MediaElementPlugin ...
INSTALLED

Foswiki::Plugins::JQueryPlugin version 23 Feb 2018 installed
Foswiki::Plugins::ImagePlugin version 09 Sep 2017 installed

MISSING

Foswiki::Contrib::XSendFileContrib version >=3.00 required -- perl module is not installed - Optional - Optional dependency, will not be automatically installed

*******************************************************************************

Installing ImagePlugin
Loading package installer

fetching ImagePlugin installer from https://foswiki.org/pub/Extensions/...
Dependency Report for ImagePlugin ...
INSTALLED

Image::Magick version 6.3.9 installed
LWP::UserAgent version 6.04 installed
Foswiki::Plugins::JQueryPlugin version 23 Feb 2018 installed

MISSING

Foswiki::Contrib::XSendFileContrib version >=1.00 required -- perl module is not installed - Optional - Optional dependency, will not be automatically installed