We need you!

Icon

The IzPack documentation needs work, and you are invited to edit it!

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Installations using saved records of user inputs

When you conclude your installation with a FinishPanel, the user can save the data for an automatic installation. With this data, he will be able to run the same installation on another similar machine. In an environment where many computers need to be supported this can save a lot of time.

Run the installation once on a machine and save your automatic installation data in auto-install.xml (that's just a sample). Then put this file in the same directory as the installer on another machine. Run it with:

Code Block
java -jar installer.jar auto-install.xml

It reproduces the same installation again, applying all previous user inputs automatically. No interaction is required any longer.

Installations using properties

IzPack installers can be executed replacing possible user inputs from properties, which can be given either in property files or directly specified on the command line.

  • -options-template <propsfile>
    Generates an empty properties file template whose name is specified as <propsfile>. Does not install anything, but inserts all possible properties to be filled with particular values for an unattended installation, later.
  • -options <propsfile>
    Runs an unattended installation while reading the properties from the properties file specified in <propsfile>.
  • -options-system
    Runs an unattended installation using system properties given on the command line.
  • -options-auto <propsfile>
    Runs an unattended installation while reading the properties from the properties file specified in <propsfile> and overwriting them with particular system properties given on the command line.

Examples:

Code Block
java -jar myinstaller.jar -options-template myinstaller.properties

Generates a properties file myinstaller.properties with all user-changeable variables provided by my myinstaller. The property INSTALL_PATH is always exported. There will be only the property keys, the names are left empty and must be added manually.

Code Block
java -jar myinstaller.jar -options myinstaller.properties

Executes an unattended installation replacing possible user inputs by the property values defined in the file myinstaller.properties. An empty template of the property file can be created for each compiled installer using -options-template.

Code Block
java -DINSTALL_PATH=/opt/myplace -jar myinstaller.jar -options-system

Executes myinstaller in unattended mode in a UNIX console and forces the main installation path to be set to /opt/myplace.