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 '<dir>' to '/path/where/your/foswiki/is/installed/<dir>' - Rename /path/where your/foswiki/is/installed/<dir>: 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