Recording a response file

Silent installs require a response file. You can download a sample response file, manually create a response file, or record a response file with Installation Manager. Recording a response file requires Installation Manager to be installed.

Before you begin

Silent installs require a response file. You can download a sample response file, manually create a response file, or record a response file with Installation Manager. Recording a response file requires Installation Manager to be installed.

You must record a response file on the same platform that you will be installing on. For example, to install on a Windows machine, you must record the response file on a Windows machine. You can record a response file on Windows XP and use the response file on another supported version of Windows. To install on a Linux machine, you must record the response file on a Linux machine.

If you plan to install on multiple platforms, you must have a response file for each platform. You can download a sample response file for the different platforms and manually edit the response file. If you edit a sample response file, you do not need to install Installation Manager. You can also record a response file for the different platforms. To record the response files, you must install Installation Manager on each platform. For example, you install Installation Manager on a Windows platform and on an AIX® platform to create response files for Windows machines and AIX machines.

The extracted files contain the product repository. You do not need to create a repository. The Rational® product installation files and the Installation Manager installation files from Rational Enterprise Deployment should be in separate repositories.

If you want to use only one repository for all installation files or you are installing from an HTTP server, you must use Packaging Utility to create a repository that contains all the installation files.

The Installation Manager installation files are located on the network shared drive because the installation of the Rational product requires access to the Installation Manager installer. In this scenario, you do not install Installation Manager on the network shared drive. : Some versions of Rational ClearCase® and Rational ClearQuest® do not ship with a default response file.

Procedure

  1. Check user requirements before installing. Rational Team products require administrator access.
  2. Mount a directory or map a shared drive from the network shared drive to the admin machine. Select a drive that is common to the machines that you are installing on. The response file stores the drive and directory location for the repositories.

    In a later step you specify the repositories located on the remote server. Note that if the response file saves the location as g:\installation_files\EnterpriseCD-Windows\InstallationManager, for example and you record a silent install on a machine that uses the m:\ drive instead of the g:\ drive for the shared drive, the installation will not find g:\installation_files\EnterpriseCD-Windows\InstallationManager. You can also edit the response file to change the drive.

  3. Install Installation Manager on the admin machine. You use the Installation Manager GUI to record the response file.
    Note: For platforms that do not have a GUI, see Technote # 1373364 Installing ClearCase on a platform that does not use the GUI http://www.ibm.com/support/docview.wss?uid=swg21373364 or Technote # 1373401 Installing ClearQuest on a platform that does not use the GUI http://www.ibm.com/support/docview.wss?uid=swg21373401
  4. If the Rational product requires administrator access to run the installation, install Installation Manager using the administrator commands:
    Windows:
    shared_drive:\install_files\install.exe
    Linux or UNIX systems:
    /install_files/install
    Note: On Windows, use install.exe for installations that use the GUI. Use installc.exe for silent installs. Using install.exe for silent installs is not supported.
    Note: Log files are in these locations:
    • Windows: C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs
    • Linux or UNIX systems: /var/ibm/InstallationManager/logs
    On Windows, logs files are stored in a different location when not installing as an administrator.
  5. After the Installation Manager installation completes, you are prompted to restart Installation Manager. Close Installation Manager after it restarts.
  6. On the local machine, open a command prompt to the Eclipse directory located under the installed Installation Manager directory:
    • Windows: install_dir\Installation Manager\eclipse
    • Linux or UNIX systems: /install_dir/InstallationManager/eclipse
    The default location for Windows is C:\Program Files\IBM\Installation Manager\eclipse. The default location for Linux or UNIX systems is /opt/IBM/InstallationManager/eclipse/.
  7. Run the command to record a response file for the Rational product installation. Remember the name and location of the response file as you will need this information in a later step.
    • Windows: IBMIM -record c:\response_file\install_clearcase80.xml -skipInstall c:\skipInstall_directory\install_clearcase80
    • Linux or UNIX Systems: ./IBMIM –record /response_file/install_clearcase80.xml -skipInstall skipInstall_dir/install_clearcase80
    where install_clearcase80.xml is the response file being recorded and skipInstall_directory\install_clearcase80 is the location where the skipInstall folders and files are created.
    Note: The -skipInstall option records a response file without installing the Rational product The directory location agentDataLocation must be a writable directory.

    When you create a response file using -skipInstall, you must keep the directory, folders and files created for agentDataLocation. This allows you to modify the response file using the option -record at a later time. You can also manually edit the response file.

    You can specify a directory on the admin machine or on the network shared drive for either the response file location or agentDataLocation. To modify the response file at a later time using Installation Manager, you must use the same directory locations.

    Verify the file paths you enter exist. Installation Manager does not create directories for the response file. You do not need to create the response file.

    The text (Recording...) displays in the Installation Manager title when you are recording a response file.

    The Installation Manager Information Center contains the latest information on creating a response file. For more information on the commands to create a response file and available command options, see http://publib.boulder.ibm.com/infocenter/install/v1r5/index.jsp?topic=/com.ibm.silentinstall12.doc/topics/c_silent_response_files.html

  8. After recording the response file, add the Rational product and Installation Manager repository locations.
    1. Go to File > Preferences > Repositories.
    2. Add the repository location for the Rational product installation files by selecting diskTag.inf. The repository location in this scenario is located on the network shared drive. The repository location was created when you extracted the installation files for the Rational product.
      • Windows: g:\installation_files\Rational_product\disk1\diskTag.inf, where g:\ points to the shared drive from the network shared drive.
      • Linux or UNIX Systems: /installation_files/Rational_product/disk1/diskTag.inf
      Note: Notes® these differences between repository.config and diskTag.inf. The file repository.config is a file that can be created using the Packaging Utility or obtained from the installation files. For fix packs, this file is usually in the install_files\RationalProduct directory. The file diskTag.inf indicates to Installation Manager that the files are from a disk image. diskTag.inf can be across multiple disks. You cannot create a diskTag.inf file with Packaging Utility, but you can select a diskTag.inf in Packaging Utility. diskTag.inf cannot be used from an HTTP server. Fix packs do not contain a diskTag.inf file.
      Note: This scenario does not use Launchpad. Launchpad is shipped only with disk images and uses only diskTag.inf. Launchpad does not use repository.config.
    3. Set preferences.
      Note: There are some silent install preferences that cannot be edited using Installation Manager interface. You must manually edit the response file. For related information on silent install preferences, go to the Installation Manager Information Center http://publib.boulder.ibm.com/infocenter/install/v1r5/topic/com.ibm.silentinstall12.doc/topics/r_silent_prefs.html.
      • In the Preferences window, select Repositories. Enable or disable Search service repositories during installation and updates as appropriate for your environment. This option is stored as offering.service.repositories.areUsed in the response file.
      • In the Preferences window, select Updates. Enable or disable Search for Installation Manager updates as appropriate for your environment. This option is stored as com.ibm.cic.common.core.preferences.searchForUpdates in the response file.
    4. Click OK.
  9. Step through the install, populating the fields as appropriate for your environment.
  10. After the installation is finished, close Installation Manager to finish the recording of the response file.
  11. To silently install Installation Manager, modify the response file.
    Note: You cannot record a silent response file for Installation Manager with Installation Manager installed.
    1. Determine the internal version value for Installation Manager. If you have more than one set of installation files, use the latest version.
    2. Open the response file
    3. Add an offering key to the install command using this form: <offering features='agent_core,agent_jre' id='com.ibm.cic.agent' version='1.4.4000.20110525_1254'/>. Version is the internal version value, im.internal.version, for Installation Manager. Use a comma between agent_core and agent_jre. For example:
      <install>
      	<offering features='agent_core,agent_jre' id='com.ibm.cic.agent' version='1.4.4000.20110525_1254'>
      	<offering id='com.ibm.rational.clearcase.platform' version='8.0.0.00-8-0-D081110'/>
      </install>
    Note: It is possible to silently install Installation Manager with a Rational product without modifying the response file. To do so, create a batch file or a shell script with the commands to first run a silent install for Installation Manager and to then run a silent install for a Rational product. On Windows, use installc.exe, not install.exe, for silent installs.

    Example commands:

    Windows
    install_files_IM\installc --launcher.ini silent-install.ini
    install_files_Rationalproduct\install --launcher.ini silent-install.ini -input <response_file>
    Linux or UNIX Systems
    install_files_IM/installc --launcher.ini silent-install.ini 
    install_files_Rationalproduct/install --launcher.ini silent-install.ini -input <response_file>
  12. If you created the response file on the admin machine and not on the network shared drive, you must copy the response file to the network shared drive. You do not need to copy the agentDataLocation directory to the remote server.
    Note: You might want to create a directory specific for response files on the network shared drive. For example, for Windows, c:\installation_files\response_files and for Linux or UNIX Systems, /installation_files/response_files.

Feedback