Upgrade add-on products
Upgrade add-on products#
This chapter describes the steps to migrate your third party products.
Shut down your Plone server instance.
If you pinned versions of third-party products in your
buildout.cfg
or other configuration files, such asProducts.PloneFormGen = 1.7.17
, update these references to point to the new versions.Note
Without pinning, such as specifying
Products.PloneFormGen
without a version number, your build tool, buildout or make, will pick the newest version of the products by default.Run your build tool. Wait until all new software is downloaded and installed.
Start Plone again. Your site may look weird, or even be inaccessible, until you perform the next step.
Navigate to the Add-on screen by adding
/prefs_install_products_form
to your site's URL. Upgrade products if you can. Upgradeable products would be those that support both your current and new versions of Plone.Perform product-specific upgrade procedures, if any. You will find these in the documentation of each product.
If /prefs_install_products_form
is unreachable, and you are using Plone 5.0.x or earlier, you should try doing the add-on upgrades from the Management Interface.
Navigate to the portal_quickinstaller
in the Management Interface at /portal_quickinstaller/manage_installProductsForm
, and reinstall or upgrade products that are shown to be outdated.
Deprecated since version 5.1: portal_quickinstaller
was deprecated in Plone 5.1, and was removed in Plone 6.0.
See PLIP 1775 and Do Not Use portal_quickinstaller for Plone 5.1 and later.
Warning
Be careful when updating add-ons through the Management Interface. It may show outdated themes as well, with a hint to update. If you do that, the updated theme will activate itself, overriding your current theme. If this happens, re-enable your theme in the theming panel.