Installing an IIP silently

Installing an integrated installation package (IIP) silently refers to installing the IIP from the command line without the use of the IIP installation wizard. Included installation contributions might not install silently based on contribution settings.

Before you begin

You must use the Installation Factory to create an IIP before you can install the IIP. See Developing and installing integrated installation packages for more information about creating an IIP.

The IIP installation wizard can be suppressed altogether so that it does not display when the IIP is run. The contribution invocations will be invoked using the built-in options that were specified by the installation factory user when the IIP was created, or using options specified on the IIP command line which will override the built-in ones (assuming the IIP creator did not disallow them to be overridden). It is important to note that although the IIP wizard will not display, each contribution in the IIP may or may not display independently based on the options you selected during IIP creation. In this case a true silent installation of an IIP means that there is neither an IIP installation wizard nor any contribution installation wizards.

About this task

Use this procedure to perform a silent installation of the product.

Procedure

  1. Log on to the operating system.
  2. If you want an end-to-end silent installation, make sure that you have configured all of your contributions to run silently.

    See Creating a build definition and generating the IIP for details on how to configure the various installation options of a contribution. You may also generate an IIP so that it installs in a mixed mode, with some contributions installing through their wizards and some installing silently. For example, you can include a contribution to install WebSphere Application Server to be installed through the wizard, and then install a feature pack contribution silently for a seamless installation.

  3. You can install the IIP silently using the install command located at:

    Note that a contribution can be invoked with a combination of options specified directly on its command line as well as options specified in a response file. See IIP installation response file for more information. However, any contribution options passed to the command line will cause the IIP installer to ignore all options specified in a specific contribution's response file. For example, during IIP creation you can specify the install location for a contribution and the user installing the IIP can also specify it in a response file. The install location specified directly on the command line will override the one set during IIP creation when the contribution is invoked and processes its options. In addition, any other options specified for that contribution during IIP creation will be subsequently ignored.

    The following options are available during installation. All options values containing spaces must be surrounded by single quotes. The options that can only be used on the command line have been noted.

    Table 1. IIP installation options
    Option Value Description Example

    -help

      Displays all available parameters for the IIP install command. This option can only be used on the command line. -help
    -iipResponseFile <path to IIP response file>

    Specifies location of the response file. Any option that can be specified on the command line when invoking the IIP can also be specified in an IIP response file (except the –iipResponseFile option itself). This includes the top-level IIP options described in this section as well as contribution-specific options. The order of the options in the response file is significant. Top-level options supported directly by the IIP UI must be first, and the options for the “primary” contribution (if any) must be second. Options for other contributions (if any) must follow, separated by –iipOptionSet options. Any line in the response file that begins with a ‘#’ is considered a comment and will be ignored.

    See IIP installation response file for more information on the sample response file and its use. This option can only be used on the command line.

    -iipResponseFile=D:\myIIPResponsefile.
    -iipLogfile <path to log file> Specifies the directory path and name of the IIP log file -iipLogfile=C:\mylog.txt
    -iipLoglevel
    • all
    • config
    • info
    • error
    • warning
    • severe
    • off
    Specifies the verbosity of the log file. The default value is info. –iipLogLevel=info
    -iipTracefile <path to trace file> Specifies the directory path and name of the trace file -iipTracefile=C:\mytrace.xml
    -iipTracelevel
    • all
    • fine
    • finer
    • finest
    • off
    Specifies the verbosity of the trace file. The default value is off. –iipTracelevel=fine
    -iipNoGUI   Run the IIP without showing the IIP GUI. When the IIP is created, the IF user can specify that the IIP GUI should be displayed by default. This option can be specified by the IIP user to override that default. However, the IF user can also specify that this cannot be overridden, in which case using this option will result in an error. This option is intentionally not named “-silent” since it does not control whether or not the contributions in the IIP run in silent mode – that depends on the options specified for those contribution invocations. Using the name “-iipNoGUI” helps reinforce this. -iipNoGUI
    -iipShowGUI   Show the IIP GUI when the IIP is invoked. When the IIP is created, the IF user can specify that the IIP GUI should not be displayed by default. This option can be specified by the IIP user to override that default. However, the IF user can also specify that this cannot be overridden, in which case using this option will result in an error.
    Note: Using this option will result in an error on an operating system where the GUI installer is not supported.
    -iipShowGUI
    -iipUserType <root or nonroot> Specifies whether user is root or nonroot This is an important setting since the IIP creator can different option values to pass to the contribution based on the IIP installer user type. The default value is root. -iipUserType=nonroot
    -iipOptionSet <Invocation_ID>

    Refers to a specific contribution invocation. All subsequent options are assumed to be intended for the specified contribution, until another -iipOptionSet option is specified.

    Any options specified at IIP installation which are not preceded by the -iipOptionSetoption are assumed to belong to the primary contribution invocation. The invocation of the IIP will be virtually identical to the primary contribution invocation in terms of the option names and syntax.

    Note: All contribution options will be ignored if the IIP is installed in GUI mode.
    –iipOptionSet=6.1.0-WS-WASBase_1-1 –OPT installLocation=C:\myLocation
    -iipDisable <Invocation_ID1, Invocation_ID2,...> Do not install the specified contributions during IIP installation. When the IIP is created, the user can specify which contributions should be suppressed by default when the IIP is installed, and whether this can be overridden. Using this option during install will result in an error if the IIP creator specified that suppression cannot be overridden. The IDs are comma-delimited. –iipDisable=6.1.0-WS-WASBase_1-1, 6.1.0-WS-WASBase_1-2
  4. After the installation, you can review the log and/or trace files for the IIP and also for each individual contribution. Please see that product's documentation for more logging information.
    The IIP log and trace files will default to the below location unless you specified another path using the -iipLogfile or -iipTrace parameters.

Results

You have silently installed an integrated installation package.

Example

The following is an example of a silent installation of a WebSphere Application Server Network Deployment Version 6.1 package. The IIP installer will launch silently using the specified response file, and install the Network Deployment contribution silently into the specified directory. The sample response file might have been edited to include different log and trace locations as well as other parameters. Note that since the installation location was specified for the contribution, all other options previously specified for the contribution will be ignored.
install -iipNoGUI -iipOptionSet=6.1.0-WS-WASND_1-1 -OPT installLocation='C:\Program Files\IBM\WebSphere\AppServer'
 -options D:\WAS\responseFile.txt -silent

What to do next

Note: If an included contribution fails to install, you might need to edit that contribution's response file, which is different from the overall IIP response file. By default, contribution response files are located in IIP_home/ResponseFiles.
Note: During IIP installation, workspace files that might contain crucial logging information from Eclipse are created in the following directory:
You might want to manually delete these files periodically to free up disk space.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=tins_if_iip_installSilent
File name: tins_if_iip_installSilent.html