Configuration Install Actions - ConfigurationInstallerListener

...

• option and property files
• INI files
• XML files
• Windows registry entries.

ConfigurationListener is useful for software updates and merges option (properties), INI and XML files from a previous installation to those files with the same path coming with a new version of your software. It does a three-way merge - patching an original file against a new file resulting in a target file. For using in-place patches you must ensure the previously installed files are automatically renamed when installing the new files coming with an update installer, before ConfigurationListener starts. This can be achieved by using the overrideRenameTo attribute for installed files or file sets, see Packs.

Configuration actions are defined in an IzPack resource ConfigurationActionsSpec.xml, which has to be necessarily defined when the ConfigurationInstallerListener is used. 

Configuration actions can be only used during installation, not for reverting configurations when uninstalling.

...

• There might be a couple of additional libraries bound to the installer depending on the needs:
  
  • In order to use XML merge/patch actions in common you need to add org.jdom:jdom2 artifact to the installer.
    JDom 2.0.5 is the current minimum requirement IzPack has been tested against. 
  • In order to use XPath queries you need also to add the jaxen:jaxen artifact to the installer.
    JDom 2.0.5 currently optionally depends on Jaxen 1.1.4.
  • In order to use the "dtd" XML merge action you need to add com.wutka:dtdparser artifact to the installer.
    DTD Parser 1.21 is the current minimum requirement IzPack has been tested against. 

...