Check version numbers before and after

• System
• FoswikiServerInformation

2.1.6 ► 2.1.7 ► 2.1.8 ► 2.1.9

• create a modified .tgz file according to the instructions below (solution)
• copy it to the root of your wiki site
• unpack it: tar -xzvf Foswiki-2.1.7.mod.tgz or using the DirectAdmin File Manager
• now your wiki site will be unavailable (403)
• execute fix_file_permissions.sh (FwFixFilePermissions)
  • execute this shell script from the root of your wiki site
• 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
  • bin
  • pub
  • pub/System
  • (sEmbedder)
• 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!
• then remove the !UpdatesPlugin which is installed by default
• 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

¹ 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

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