Recording a response file with Installation Manager

You can create a response file by recording your actions in Installation Manager. When you record a response file, the selections that you make in Installation Manager are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the data in the XML response file to install packages.

Before you begin

Review the information in Before you record a response file. To record a response file, you must install Installation Manager. For more information about the silent installation commands, see Installation Manager command-line arguments for silent mode.

For operating systems that do not use the graphical user interface, create response files in console mode. In console mode, you follow the steps to install, modify, roll back, update, or uninstall a package. On the Summary screen, you can create a response file, see Installing packages by using console mode.

Note: When you record a response file for the IBM product installation:
  • For Windows, use IBMIM.exe. The launcher.exe is deprecated.
  • For Linux®, UNIX, and the OS X operating system, use the ./IBMIM command. The ./launcher command is deprecated.

About this task

You cannot record a response file to install or update Installation Manager. To install or update both Installation Manager and an IBM product, you must modify a response file to add the commands to install Installation Manager. For more information, see Modifying a response file to install a package and Installation Manager.

Some packages require entitlement for versions or fixes. If you are not entitled for a version or fix, the version or fix is not installed. If you roll back or uninstall to an entitled version or fix that you do not have access to, the rollback or the uninstall does not finish. You receive a message that indicates the version or fix cannot be found. Entitlement is based on your IBM ID credentials. For more information, see IBM ID credentials Help and FAQ. For more information about entitlement, see IBM Entitlement Help.

Procedure

The following steps describe how to record a response file:

  1. On a command line, change to the eclipse subdirectory. See Installing as an administrator, nonadministrator, or group for default installation directory locations.
  2. Run the command to record a response file for the IBM product installation. This command uses the -skipInstall agentDataLocation argument. This argument records the installation commands without installing the IBM product. Substitute your own file name and location for the response file.
    Verify that the file paths that you enter exist. Installation Manager does not create directories for the response file.

    • Windows: IBMIM.exe -record responseFile -skipInstall agentDataLocation
    • Linux, UNIX, and the OS X operating system: ./IBMIM -record responseFile -skipInstall agentDataLocation
    Important:
    • Use the same agentDataLocation in the next recording session to record updates or modifications to the IBM product. These changes are recorded in the agentDataLocation directory.
    • Do not specify an existing agentDataLocation directory for the location for a new installation process. For more information about the agent data location, see Agent data location.

    The -skipInstall argument requires that the agentDataLocation is a directory that you can write to. To record a response file and install the IBM product at the same time, remove the argument -skipInstall agentDataLocation. For more information about the -skipInstall argument, see Installation Manager command-line arguments for silent mode

    Using the -log option is not supported when you record a response file.

    Enclose file paths that include spaces with double quotation marks.

    Examples:
    Table 1. -record commands by operating system
    Operating System Command
    Windows IBMIM.exe -record c:\response_files\install_product.xml -skipInstall c:\skipInstall\IBM_product
    Linux, UNIX, and the OS X operating system ./IBMIM -record /response_files/install_product.xml -skipInstall skipInstall/IBM_product
  3. Follow the on-screen instructions in the appropriate wizard. If you copied the repository to a new location, you can set the location of the repository in the repository table. To access the repository table, click File > Preferences > Repositories. On the OS X operating system, the Preferences option is under the IBM Installation Manager menu.
    The text (Recording...) shows in the Installation Manager title when you record a response file.
  4. Click Finish, then close Installation Manager to finish the recording of the response file.
  5. Installation Manager sets file permissions on the response file. The file permissions are changed to allow read and write permissions only for the user ID or group ID that recorded the response file.
    Note: If Installation Manager cannot change the file permissions for the response file, you can restrict the access by using the chmod command. After you use the chmod command, move the response file to a secure directory, or delete the response file after you use the file.
    Examples:
    Table 2. chmod commands by mode
    Operating System Mode Command
    Linux, UNIX, and the OS X operating system Administrator chmod 600
    Nonadministrator
    Group chmod 660
  6. If you run Installation Manager as a nonadministrator to install on another user's computer, you must change the filepaths in your response file from absolute paths to relative paths.

Results

An XML response file is created and saved in the location that you specified in the command.

What to do next

Create a storage file to store the credentials that are needed during installation to authenticate the repositories, proxies, and response files on protected servers. Storage files are only necessary when your installation accesses servers that require authentication. If the servers do not require authentication, then you do not need to create a storage file.