Installation instructions

The procedure for installing Hotfix 20160419 differs slightly based on which version of Plone or Zope you are running, and whether you installed Plone or Zope using Buildout.

Backup First!

It is prudent to backup all of your data and installation files before installing any Plone add-on, including this hotfix. If you already have a solid Plone backup routine in place, then you can skip this step and proceed.

If you don't already have a backup of your Plone site, the simplest way to back up your Plone instance is to simply copy your entire Zope instance folder or buildout folder to a secure location.

Recommended Install Procedure

If you're less experienced with Plone, the easiest way to install Hotfix 20160419 on Plone 4.0 - Plone 5.x is as follows:

1) Download the hotfix archive using the link above. If you have an md5 tool available (Linux or Mac) check the signature matches

2) Place the downloaded zip file into the "products" directory in your Zope instance. On pre-buildout installations, this will be "Products".

3) Unpack the zip file.

On Linux or Mac, the command is:

 $ unzip PloneHotfix20160419-1.0.zip

On Windows, use your favorite archiving product. (7Zip is a good choice.)

4) Restart your Zope instance in foreground mode to ensure that the hotfix is installed.

On Mac or Linux, the command is typically:

 $ bin/instance fg

On Windows, the command is typically:

> bin\instance.exe fg

Zope will start in the foreground, and you should see the message "INFO PloneHotfix20160419 Hotfix installed. " during startup.

5) Stop the foreground instance of Zope by hitting CTRL-C

6) Restart your Zope instance.

On Mac or Linux, the command is typically:

$ bin/instance start

On Windows, the command is typically:

> bin\instance.exe start

Installing with Buildout

If you are an experienced Plone administrator, and you are using a Buildout-based installation of Plone, you may choose to install Hotfix 20160419 with Buildout. However, if you choose to do this, you must be certain that you will not accidentally overwrite Plone components with newer versions. This is particularly likely if you try to use Buildout with older versions of Plone.

If you are not sure what you're doing, please use the "Recommended Installation Instructions" above.

1) Find your buildout.cfg file, typically located in the "zinstance" subdirectory of your Plone installation directory.
2) Open your buildout.cfg file in your favorite text editor.
3) Scroll down to the "eggs" section of the buildout and add Products.PloneHotfix20160419, e.g.

[buildout]
...
eggs = 
    Products.PloneHotfix20160419

4) Rerun buildout.

On Mac or Linux, the command is:

$ ./bin/buildout -Nv

On windows, the command is:

> bin\buildout.exe -Nv

5) Restart your Zope instance.

On Mac or Linux, the command is:

$ ./bin/instance start

On Windows, the command is:

> bin\instance.exe start

Alternatively, on Windows, you may restart the Zope service via the Windows Services control panel.

20160419

Issues fixed