Products.CMFQuickInstallerTool 3.0b1

CMFQuickInstallerTool is a facility for comfortable activation/deactivation of CMF compliant products.

Products.CMFQuickInstallerTool

Features

CMFQuickInstallerTool is a facility for comfortable activation/deactivation of CMF compliant products inside a CMF site.

Therefore it has to be installed as a tool inside a CMF portal, where it stores the information about the installed products.

The requirements for a product to be installable with QuickInstallerTool are quite simple (almost all existing CMF products fulfill them):

External Product:  The product has to implement an external
                   method 'install' in a python module 'Install.py'
                   in its Extensions directory.

                   OR

                   The product ships with a GenericSetup extension profile
                   and has no install method. It can still use an uninstall
                   method for custom uninstallation tasks though.

Products can be uninstalled and QuickInstallerTool removes the following items a product creates during install:

• portal actions,

• portal skins,

• portal types,

• portal objects (objects created in the root of the portal),

• workflows,

• left and right slots (also checks them only for the portal),

• resource registry entries

Attention:

QuickInstallerTool just tracks which objects are ADDED, but not what is changed or deleted.

Usage

In the ZMI click on portal_quickinstaller. The management screen allows you to select products for installation and uninstallation. You can browse into the installed products and see what was created and the logs of the install process.

Customized uninstall

In order to use a customize uninstall, the following requirements must be met:

External Product:  The product has to implement an external
                   method 'uninstall in a python module 'Install.py'
                   in its Extensions directory.

Please note that the customized uninstall method is invoked before (and in addition to) the standard removal of objects.

Install:

install(portal) or install(portal, reinstall)

Uninstall:

uninstall(portal) or uninstall(portal, reinstall)

Reinstall

Reinstalling a product invokes uninstall() and install(). If you have special code which should work differently on reinstall than uninstall/install you can add a second argument to the install or uninstall method named ‘reinstall’ which is true only for a reinstallation. In most cases you shouldn’t react differently when reinstalling!

Changelog

3.0b1 - 2009-12-27

• Removed no longer needed check for CMF < 2.1. [hannosch]

• Added missing test dependency on Products.CMFCalendar. [hannosch]

3.0a1 - 2009-11-13

• Further optimized the handleBeforeProfileImportEvent logic. We ignore any non-installable profiles. [hannosch]

• Changed tests to use addProfile instead of addProduct to install this package, as we don’t have an Extensions.Install module ourselves anymore. [hannosch]

• Updated package metadata and cleaned up old code. [hannosch]

• Declare package dependencies and fixed deprecation warnings for use of Globals. [hannosch]

2.1.7 (2009-4-4)

• Do not use the GenericSetup profile version: the profile version has no relation to the package version. [wichert]

• Do not use the GenericSetup profile version: the profile version has no relation to the package version. [wichert]

• Fixed actions installation tests. [hannosch]

• Cache listInstallableProducts in event handler to improve portal creation time. [stefan]

• Use aq_parent(aq_inner()) to get at the portal root, otherwise we can end up getting the quickinstaller tool by accident if it’s acquired through itself. [sidnei]

2.1.6 (2008-07-07)

• Applied a tiny fix that caused good installations to fail during log generation. [gogobd]

• Use aq_base on all attribute retrieval during InstalledProduct’s cascade deletion so we don’t inadvertently try to delete something retrieved via acquisition. [rafrombrc]

2.1.5 (2008-06-02)

• Improved getInstallMethod to log ImportError instead of silently skipping it. It was unclear why product does not appear in QI even if there is no error raised on instance startup. [naro]

• Prefer sorting the list of installable and installed products by title instead of id. [hannosch]

• Correct handling of products with pre-CMF2.1 style actions [wichert]

2.1.4 (2008-04-27)

• The same error should be displayed only once even if it occurs with the old style install method and with the GenericSetup profile [encolpe]

• The getInstallMethod should ignore ImportError when looking for install methods for a product. This makes it possible to install products which have a working GenericSetup profile but a broken Install external method. [wichert]

2.1.3 (2008-04-21)

• Fixed getInstallProfile method for packages from the ‘Products’ namespace. This allows Quickinstaller to show the profile title instead of the product name. [encolpe]

2.1.2 (2008-04-20)

• Fix when a product comes from the ‘Products’ namespace and has both installation profile and an entry in the control panel. [encolpe]

• Added getattr code to make sure uninstall for products which have not been installed properly doesn’t fail that easily. [hannosch, wichert]

• Added initialize code for all values in DEFAULT_CASCADE. Otherwise you could get errors during uninstall of products which where installed via notifyInstalled. [hannosch, wichert]

• Display of add on products README file could generate UnicodeDecodeError when the README file included non-ascii characters. This closes http://dev.plone.org/plone/ticket/7524. [hannosch]

• Removed all error swallowing options from QuickInstaller. We always raise an error now, if one is encountered during product install. This closes http://dev.plone.org/plone/ticket/7536. [hannosch]

2.1.1 (2008-03-26)

• Added getProductDescription method to expose the description from an extension profile. [hannosch]

• Added new listInstallableProfiles method, to include products without a Zope2 control panel entry in the listings. [hannosch]

• Tighten some security settings. [hannosch]

• Fixed actions re/uninstall for products installed prior to CMF 2.1. This closes http://dev.plone.org/plone/ticket/6974. [hannosch]

• Restored code which got accidentally removed in c38815. [hannosch]

2.1 (2008-03-09)

• Added metadata.xml to GenericSetup profile. [hannosch]

• Avoid breakage for InstalledProduct instances without the left or rightslots properties. Thx to Roberto Fontanarosa from the OpenCpi division of Cpi Progetti Spa. [hannosch]

• Fixed logging code in utils. This closes http://dev.plone.org/plone/ticket/7093. [bliles, hannosch]

• Reverted getUtility usage. Closes http://dev.plone.org/plone/ticket/7314. [hannosch]

• Fixed class variables in InstalledProduct. All products would share the same left slots and right slots properties. Thx to Saverio Mucci for noting this. [hannosch]

• Hook into the import-events generated by the development version of GenericSetup. This allows us to automatically mark a product as installed if its profile is imported successfully. [wichert]

• Avoid an unneeded transaction savepoint. [hannosch]

2.0.3 (2007-07-09)

• Use new GenericSetup features, so we don’t have to change the current setup tool context anymore. [hannosch]

2.0.2b3 (2007-05-01)

• Back to getToolByName. [wichert]

• Added uninstall support for utilities. All additional utilities installed by a product are now recorded and uninstalled properly. [hannosch]

2.0.2b2 (2007-03-23)

• Added new profile argument to the installProduct method to explicitly set the profile which should be used for installation. [hannosch]

• Marked the Products.CMFQI package as uninstallable as well. [hannosch]

• Replaced all getToolByName calls by get/queryUtility. [hannosch]

2.0.2b1 (2007-03-05)

• Don’t show removed products in the standard listings. [hannosch]

• Adjusted listInstallable and listInstalled methods to return the title of the GenericSetup profile instead of the package name, for extension profile based installation. These look a lot nicer ;) This fixes http://dev.plone.org/plone/ticket/6129. [hannosch]

2.0.1 (2007-02-10)

• Adjusted installProduct method to be compatible with CMF 2.1 (including the conversion of tools as utilities). [hannosch]

• Refactored ResourceRegistries support not to require the product itself to be installed in QI. [hannosch]

• Added the INonInstallable interface that is used to look up utilities which provide a list of non-installable products. This allows applications to exclude certain products from the list of installable products. [hannosch]

• Added an option to omit snapshot creation which defaults to True to speed up test runs and migrations. [hannosch]

• We automatically create a GenericSetup snapshot before and after installation now, so you can at least compare the changes a product did during installation. We have no better uninstall yet, though. [hannosch]

2.0.0 (2006-10-25)

• Slightly optimize for GenericSetup profile based installations. [hannosch]

• Adjusted actions installation tracking to work with CMF 2.1+. [hannosch]

• Made profile based installation work with CMF 2.1+. The profile id may use the full package name now, instead of only the product name (for example: Products.CMFCalendar instead of CMFCalendar). [hannosch]

• Changed GS profile registration to be zcml based. Fixed some problems with the logging calls. Removed some stale code from the tests. [hannosch]

• Removed lots of unused and bbb code. This version requires at least CMF 1.6. [hannosch]

• Added support for GenericSetup extension profile-based installation. [hannosch]

1.6.1 (2007-04-28)

• Disabled postonly protection for product reinstall. This broke the reinstall functionality on the Plone control panel. The postonly protection can be enabled once the control panel is changed. [hannosch]

1.6.0 (2007-04-22)

• Applied postonly protection to product uninstall and reinstall. [alecm]

1.5.9 (2006-06-01)

• Fixed two missing imports in utils.py. This closes http://dev.plone.org/plone/ticket/5529. [hannosch]

1.5.8 (2006-05-15)

• Some general spring cleaning. [hannosch]

• Avoid DeprecationWarning for product_name. [hannosch]

• Added methods to display Products directory and debug mode (if enabled) [joelburton]

1.5.7 (2005-12-23)

• Cook resources when new types were added and ResourceRegistries is installed. [fschulze]

• If we are reinstalling do not say the product is already installed if we see an exception but show the real error message [wichert]

1.5.6 (2005-12-18)

• Fix missing import in utils.py. This closes http://dev.plone.org/plone/ticket/4817. [hannosch]

1.5.5

• Keeping track of ResourceRegistries entries. [zwork]

1.5.4

• listInstalledProducts and listInstallableProducts now return alphabetized lists. [geoffd]

• Catch errors where the product is there but install cannot by compiled, this picks up syntax errors and adds the them to an errors dict. When listInstallableProducts is called, the errors dict is repoulated. Also added in a few except ConflictErrors. [andym]

• Fixing plone bug #3113, where the “uninstall” button would raise an exception if no items were selected; this makes the uninstallProducts() method symmetric with the installProducts() method [optilude]

1.5.3

• Added an Extensions.Install module and an initial test suite. [stefan]

• Added optional reinstall argument to install() and uninstall() method [tiran]

• Enabled uninstall of deleted products by making the parser.py handle missing product directories slightly more gracefully. [tesdal]

• Fixed multiple register bug

  QI doesn’t assign an object to a product when it is already registered for another product. This fixes bugs like the removal of the archetype tool when a product was removed which itself had had installed Archetypes. [tiran]

• Added afterInstall / beforeUninstall hooks:

  out = afterInstall(portal, reinstall=reinstall, qi_product) out, cascade = beforeUninstall(portal, reinstall, qi_product, cascade) [tiran]

1.4

• reinstall button

  does the same as uninstall/install except that it does _not_ delete objects that have been created on portal_level (portal_objects)

• product version info

  added getProductVersion to the API shows the version of the products for installed products it also shows the version of the prod at install time

• By Andy McKay

  Remove the except: pass from trying to make a External method, if there is an error in the import log the error to ZLOG. Unfortunately there is a string error we have to try and catch as well. That string error occurs when the module cant be found, so we should ignore that.

• content type registry support

  QuickInstaller now also tracks entries in the content_type_registry.

• if products have been removed from disc, mark them in the installed list as ‘removed’

• added a ChangeLog :)