IBM Support

Scenario of silently installing ClearCase or ClearQuest with Installation Manager from network shared drive

White paper


Abstract

An outline of silently installing IBM Rational ClearCase or ClearQuest from a network shared drive. This scenario installs IBM Installation Manager with the product.

Content


Table of Contents


Notes:

  • Recording a response file requires that Installation Manager be installed but only on one machine.

  • "Rational product" refers to Rational ClearCase or Rational ClearQuest unless otherwise specified.

  • "Local machine" refers to the machine where you install the Rational product.

  • "Admin machine" refers to a machine that you use to create the repository through the Package Utility.

  • "Network shared drive" refers to a location on the network that is accessible by the local machine.

  • Some of the steps have an Additional Information section. The Additional Information section provides additional details about the installation step. Click on the Additional Information link in order to expand this information.



I. Download the installation files


1. Download the Rational product from IBM Passport Advantage or the IBM Software Group OEM Portal. 

2. Download the IBM Rational Enterprise Deployment v7.1 platform installation files from IBM Passport Advantage.  The Rational Enterprise Deployment files are a part of the same eAssembly as the Rational product.



The Rational Enterprise Deployment v7.1 platform files contain Packaging Utility and Installation Manager.  A version of Installation Manager is also included with the Rational product. In some cases, the version of Installation Manager from the Rational Enterprise Deployment files is different than the version of Installation Manager included with the Rational product.  

Note: Installation Manager is backwards compatible.  Later versions of Installation Manager can install Rational products that are shipped with earlier versions of Installation Manager.

When Installation Manager is installed on a machine, it automatically checks for newer versions of Installation Manager. When the product you are installing requires a newer version of Installation Manager, you must update Installation Manager.  When the version of the installed Installation Manager is newer than the Installation Manager version included with the Rational product, Installation Manager remains at the current version.

Starting with Installation Manager version 1.3, you can set the preference com.ibm.cic.common.core.preferences.searchForUpdates to true or false. This preference can be set when recording the response file in Installation Manager or by editing the response file. When the preference is set to true, a search for updates is performed first when running a silent install. When the preference is set to false and the Rational product requires a newer version of Installation Manager, a message displays when you run the silent install. The message indicates that a later version of Installation Manager is required. The silent install does not continue.

You can also set the preference offering.service.repositories.areUsed to true or false. This preference can be set when recording the response file in Installation Manager or by editing the response file. When set to true, Installation Manager searches the service repositories for updates to installed products. When the preference is set to false, Installation Manager does not search the service repositories.

Service repositories are repositories located at IBM.com. These repositories contain product updates and fixes. Each Rational product includes links to service repositories that are specific to the product. You cannot see or modify the service repository links. When offering.service.repositories.areUsed is set to true, Installation Manager accesses IBM.com.

Important: If a machine does not have access to IBM.com or you do not want the machine to access IBM.com, set offering.service.repositories.areUsed to false. When this preference is set to true, Installation Manager tries to access the service repositories when you install, update or modify an installed package. When a connection is not made, Installation Manager times out and then retries to connect before starting the installation or update.

How does com.ibm.cic.common.core.preferences.searchForUpdates work with offering.service.repositories.areUsed?

offering.service.repositories.areUsed checks the service repositories for updates and fixes for installed products. com.ibm.cic.common.core.preferences.searchForUpdates checks for available Installation Manager updates. An update is available if it can be found by Installation Manager. Installation Manager finds updates either in the service repositories or in response file.


Examples:
    Note: These examples assume that Installation Manager v1.3.0 is installed and update 1.3.1 for Installation Manager is available.

    A. offering.service.repositories.areUsed=true, com.ibm.cic.common.core.preferences.searchForUpdates=true

    Installation Manager searches both the service repositories and the repositories listed in the response file for updates. Installation Manager looks for available updates to itself.

    B. offering.service.repositories.areUsed=true, com.ibm.cic.common.core.preferences.searchForUpdates=false

    Installation Manager searches both the service repositories and the repositories listed in the response file for updates. Installation Manager does not look for available updates to itself.

    C. offering.service.repositories.areUsed=false,
    com.ibm.cic.common.core.preferences.searchForUpdates=true

    Installation Manager does not access IBM.com to look at the service repositories for updates. Installation Manager does search the repositories listed in response file for updates. Installation Manager does look for available updates to itself.

    D. offering.service.repositories.areUsed=false,
    com.ibm.cic.common.core.preferences.searchForUpdates=false

    Installation Manager does not access IBM.com to look at the service repositories for updates. Installation Manager does search the repositories listed in response file for updates. Installation Manager does not look for available updates to itself.

Example:

Rational ClearCase 7.1 is included with Installation Manager 1.2.1. The Rational Enterprise Deployment files available from Passport Advantage contain Installation Manager 1.3.

The Rational Enterprise Deployment files are not updated with the release of fix packs.  Rational ClearCase 7.1.0.2 and Rational ClearQuest 7.1.0.2 require Installation Manager 1.3.1.



3.  Extract the installation files for both the Rational product and Installation Manager to a network shared drive.

Example directories on the network shared drive that contain the extracted files:
    Windows:
    C:\installation_files\Rational_product
    C:\installation_files\EnterpriseCD- platform\InstallationManager
    Linux or UNIX systems:
    /installation_files//Rational_product
    /installation_files/EnterpriseCD- platform/InstallationManager

4. Locate the file agent.installer. platform-version.zip under the InstallationManager directory.  Unzip this file to the InstallationManager directory. 



For information on unzipping files on different platforms, see the ClearCase Information Center topic Verifying and extracting electronic images or ClearQuest Information Center topic Verifying and extracting electronic images for your specific release.


Determining the version of Installation Manager

After unzipping the file, you can determine the version of Installation Manager files by checking the config.ini file. You do not need to install Installation Manager to check the version. The config.ini file reports the version of Installation Manager included with the Rational Enterprise Deployment files and Rational products. 

Note: The config.ini file might not be available with other downloads of Installation Manager.

For Installation Manager from the Rational Enterprise Deployment installation files:
    a. Go to:
      Windowsinstall_files\InstallationManager\configuration

      Linux or UNIX systems/install_files/InstallationManager/configuration

    b. Open the config.ini file

    c. Look for im.version= 1.3.0 and im.internal.version= 1.3.0.20090211_1046

In this example, the Installation Manager version is 1.3.0.

For Installation Manager from the Rational product installation files:
    a. Go to:
      Windowsinstall_files\disk1\InstallerImage_win32\configuration

      Linux or UNIX systems/install_files/disk1/InstallerImage_ platform/configuration

    b. Open the config.ini file

    c. Look for im.version= 1.2.1 and im.internal.version= 1.2.1000.20081110_1001

In this example, the Installation Manager version is 1.2.1







II. Record 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.

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 Windows 2003.  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. 

Example directories of extracted files on the network shared drive:
    Windows:
    C:\installation_files\Rational_product
    C:\installation_files\EnterpriseCD- platform\InstallationManager

    Linux or UNIX systems:
    /installation_files//Rational_product
    /installation_files/EnterpriseCD- platform/InstallationManager

Note: 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.  For other installation scenarios, see technote 1390817.

The Installation Manager installation files are located on the network shared drive because the installation of the Rational product requires access to these files. In this scenario, you do not install Installation Manager on the network shared drive.


Note:  Some versions of Rational ClearCase and Rational ClearQuest do not ship with a default response file.  To obtain sample response files, see:

Technote Title
Weblink
Sample response files for IBM Rational ClearCase 1351501
Sample response files for IBM Rational ClearCase Remote Client 1351504
Sample response files for IBM Rational ClearQuest 1348204


1. Check user requirements for installing a Rational product. Rational Team products require administrator access. See these topics for your product:
If the Rational product requires administrator access to run the installation, install Installation Manager using the administrator commands: 
    Windows: install.exe

    Linux or UNIX systems: install

Important: On Windows, it is not supported to use install.exe for silent installs. Use installc.exe for silent installs. Use install.exe for installations that are not silent.

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. For information on how to install Installation Manager using a UNC path, refer to technote 1453995.

Example of a shared drive on the admin machine:  g:\installation_files
where g:\ points to the shared drive from the network shared drive.


In a later step you specify the repositories located on the shared drive. 

Example, the response file saves the location as "g:\installation_files\EnterpriseCD-Windows\InstallationManager".  If 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.

For platforms that do not have a GUI, you can either download a sample response file or manually create the response file. For more information, see:

Run the following command to install as an administrator:
    Windows: shared_drive:\ install_files\install.exe

    Linux or UNIX systems:   /install_files/install

Important:  On Windows, it is not supported to use install.exe for silent installs. Use installc.exe for silent installs. Use install.exe for installations that are not silent.

Example:
    Windows:  g:\installation_files\EnterpriseCD- platform \InstallationManager\install.exe

    Linux or UNIX systems: /installation_files/EnterpriseCD- platform/InstallationManager/install



After the Installation Manager installation completes, you are prompted to restart Installation Manager.

Location of installation log files:
    Windows:  C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs

    Linux or UNIX systems: /var/ibm/InstallationManager/logs

Note: On Windows, logs files are stored in a different location for non-administrative installs.


4. After the Installation Manager installation completes, you are prompted to restart Installation Manager. Close Installation Manager after it restarts.

5.  On the local machine, open a command prompt to the Eclipse directory located under the installed Installation Manager directory:
    Windowsinstall_dir\Installation Manager\eclipse

    Linux or UNIX Systems/install_dir/InstallationManager/eclipse

Examples using default directory locations: 
    Windows: C:\Program Files\IBM\Installation Manager\eclipse

    Linux or UNIX Systems/opt/IBM/InstallationManager/eclipse

6. 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 <response file and path name> -skipInstall agentDataLocation

    Linux or UNIX systems: ./IBMIM –record <response file and path name> -skipInstall agentDataLocation
    ...where agentDataLocation is the directory location for storing the -skipInstall files and folders.

Important:  On Windows, it is not supported to use the command IBMIM.exe for silent installs. Use IBMIMc.exe for silent installs. Use IBMIM.exe for installations that are not silent and when recording a response file.

Example commands:
    Windows: IBMIM -record c:\response_file\install_clearcase71.xml -skipInstall c:\skipInstall_directory\install_clearcase71
    Linux or UNIX Systems: ./IBMIM –record /response_file/install_clearcase71.xml -skipInstall skipInstall_dir/install_clearcase71

    where install_clearcase71.xml is the response file being recorded and skipInstall_directory\install_clearcase71 is the location where the skipInstall folders and files are created.



7.  While recording the response file, add the Rational product and Installation Manager repository locations.
    a.  Go to File > Preferences > Repositories

    b.  Add the repository locations for the Rational product installation files and for the Installation Manager installation files. The repository locations in this scenario are located on the network shared drive.  The repository locations were created when you extracted the installation files for both the Rational product and Installation Manager.  For information on installing Installation Manager using a UNC path, refer to technote 1453995.

    Windows:
    Rational Product: g:\installation_files\Rational_product\disk1\diskTag.inf
    Installation Manager: g:\installation_files\EnterpriseCD- platform\InstallationManager\repository.config

    where g: points to the shared drive from the network shared drive.

    Linux or UNIX Systems:
    Rational Product: /installation_files/Rational_product/disk1/diskTag.inf
    Installation Manager: /installation_files/EnterpriseCD- platform/InstallationManager/repository.config



    c.  Set preferences

    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.

    For information on silent install preferences, refer to the Installation Manager Information Center topic Silent installation preference keys.
    .
    d.  Click OK

8.  Step through the install, populating the fields as appropriate for your environment.

9.  Once the install is finished, close Installation Manager to finish the recording of the response file.



10. To silently install Installation Manager, modify the response file.

Notes:
  • You cannot record a silent response file for Installation Manager with Installation Manager installed.
  • While it is possible to record a response file for Installation Manager using the Installation Manager installer, it is not supported to create a response file this way. The Installation Manager installer is located in the Installation Manager repository. For information on how to install Installation Manager using a UNC path, refer to technote 1453995.
    Note: If you have more than one set of installation files for Installation Manager, use the latest version to install Installation Manager.
    Example:
      The internal version of the installation files for Installation Manager that is included with Rational ClearCase 7.1 is im.internal.version=1.2.1000.20081110_1001.
      The internal version of the installation files for Installation Manager from Rational Enterprise Deployment is im.internal.version=1.3.0.20090211_1046.
    Install Installation Manager using the Rational Enterprise Deployment installation files as this installs as the latest version will be installed.

    b. Open the response file

    c. Add an offering key to the install command.
    Offering key: <offering features='agent_core,agent_jre' id='com.ibm.cic.agent' version=' 1.3.0.20090401_1111 '/>
    ...where version is the internal version value, im.internal.version, for Installation Manager.

    Note: Use a comma between agent_core and agent_jre
    Example:
    Before adding the offering key:

    <install>
         <offering id='com.ibm.rational.clearcase. platform ' version='7.1.0.00-7-1-D081110'/>
    </install>
    After adding the offering key:

    <install>
         <offering features='agent_core,agent_jre' id='com.ibm.cic.agent' version='1.3.0.20090211_1046'/>
         <offering id='com.ibm.rational.clearcase. platform ' version='7.1.0.00-7-1-D081110'/>
    </install>




11. If you recorded 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.

Example: 
    Windows: C:\installation_files\response_files

    Linux or UNIX Systems: /installation_files/response_files






III. Run the silent install
 

1. Go to the local machine where you want to install the Rational product. 

2.  Mount a directory or map a shared drive from the network shared drive to the local machine. 

Reminder:  Use the same drive letter for the shared drive that was used during the creation of the response file.  Or manually edit the response file to change the drive letter as appropriate for the shared drive on the local machine.

Example of repository location in a response file:
    Windows:
    <server>
         <repository location='g:\installation_files\Rational_Product' />
    </server>
    Linux or UNIX Systems:
    <server>
         <repository location='/installation_files/Rational_Product' />
    </server>

3. Check user requirements for installing a Rational product. Rational Team products require administrator access. See these topics for your product:
4. On the local machine, navigate to the Installation Manager directory located on the network shared drive. The Installation Manager directory contains the extracted installation files:
    Windows:  \ install_files\InstallationManager

    Linux or UNIX systems: /install_files/InstallationManager
      
Example: 
    Windows: g:\installation_files\EnterpriseCD- platform\InstallationManager
          
    ...where g:\   points to the shared drive from the network shared drive.

    Linux or UNIX systems: /installation_files /InstallationManager


5.  Run the silent install command for administrators to install the Rational product.  Use the response file you recorded as the value for the -input option.
    Windows: installc.exe --launcher.ini silent-install.ini -input <response file path and name>

    Linux or UNIX systems: ./install --launcher.ini silent-install.ini -input <response file path and name>

Important: On Windows, it is not supported to use install.exe for silent installs. Use installc.exe for silent installs. Use install.exe for installations that are not silent.

Note: For an example script that will install Installation Manager and a product using a UNC path, refer to technote 1453995.

Example:
    Windows:g:\installation_files\EnterpriseCD- platform\InstallationManager\installc.exe --launcher.ini silent-install.ini -input g:\installation_files\response_files\install_clearcase71.xml

    Linux or UNIX systems: ./installation_files/EnterpriseCD- platform/InstallationManager/install --launcher.ini silent-install.ini -input root/installation_files/response_files/install_clearcase71.xml    









IV. Install the Rational product and Installation Manager on additional machines


1. Mount a directory or map a shared drive from the network shared drive to the local machine.

2. Check user requirements for installing. Rational Team products require administrator access. See these topics for your product:
3. On the local machine, navigate to the Installation Manager directory located on the network shared drive. The Installation Manager directory contains the extracted installation files:
    Windowsinstall_files\InstallationManager

    Linux or UNIX systems: /install_files/InstallationManager

4. Run the silent install command for administrators to install the Rational product.
    Windows: installc.exe --launcher.ini silent-install.ini -input <response file path and name>

    Linux or UNIX systems: ./install --launcher.ini silent-install.ini -input <response file path and name>

Important:  On Windows, it is not supported to use install.exe for silent installs. Use installc.exe for silent installs. Use install.exe for installations that are not silent.






V. Installing a Rational product fix pack



For machines that have access to IBM.com and have the preferences offering.service.repositories.areUsed and com.ibm.cic.common.core.preferences.searchForUpdates set to true, you can run the silent install command with -updateAll. -updateAll searches available repositories for updates. You do not need to download the fix packs for the Rational product and Installation Manager.

Example:

Machine A has Rational ClearCase 7.1 installed. Machine A also has access to IBM.com. The preference offering.service.repositories.areUsed is set to true during the original installation. Fix packs for both Rational ClearCase and Installation Manager are released. You run the silent install command:
    Windows: install_dir\Installation Manager\eclipse\IBMIMc.exe --launcher.ini silent-install.ini -updateAll

    Linux or UNIX Systems: ./ install_dir/InstallationManager/eclipse/IBMIM --launcher.ini silent-install.ini -updateAll

Important:  On Windows, it is not supported to use the command IBMIM.exe with the silent install command. Use IBMIMc.exe with the silent install command. Use IBMIM.exe for installations that are not silent and when recording a response file.

Installation Manager searches for, finds and then installs the fix packs for Rational ClearCase and Installation Manager.

For machines that do not have access to IBM.com or has the preference offering.service.repositories.areUsed set to false, you must download the fix packs from IBM.com, update the response file and run the silent install command with the -input option.

Example:

Machine B has Rational ClearCase 7.1 installed. Machine B does not have access to IBM.com. The preference offering.service.repositories.areUsed is set to false during the original installation. Fix packs for both Rational ClearCase and Installation Manager are released. You must download and extract the fix packs to a directory on the network shared drive. You edit the response file to include the fix pack directories. You run the silent install command:
    Windows: IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name>

    Linux or UNIX Systems: ./IBMIM --launcher.ini silent-install.ini -input <response file path and name>

Important:  On Windows, it is not supported to use the command IBMIM.exe with the silent install command. Use IBMIMc.exe with the silent install command. Use IBMIM.exe for installations that are not silent and when recording a response file.

Installation Manager searches for, finds and then installs the fix pack for Rational ClearCase and Installation Manager.



Note: The following steps assume that the local machine does not have access to IBM.com.


1.  Download the fix packs for the Rational product and Installation Manager from IBM.com. Download com.ibm.cic.agent.offering.zip for the Installation Manager fix pack.




2.  Extract the fix pack installation files to a directory on the network shared drive.  The directory contains the fix pack repository.

Example directory on the network shared drive:
    Windows
    C:\installation_files\fixpackCC7101
    C:\installation_files\com.ibm.cic.agent.offering
    Linux or UNIX systems:
    /installation_files/fixpackCC7101
    /installation_files/com.ibm.cic.agent.offering

3.  Edit the response file: 
    a. Add the fix pack repository location to the server command.

    Example:
      Windows:
      Before adding repository location for the fix pack:
      <server>
           <repository location='g:\installation_files\Rational_Product' />
      </server>

      After adding repository location for the fix pack:
      <server>
           <repository location='g:\installation_files\Rational_Product' />
           <repository location='g:\installation_files\fixpackCC7101' />
           <repository location='g:\installation_files\com.ibm.cic.agent.offering' />
      </server>

      where g:\ points to the mounted directory from the network shared drive

      Linux or UNIX systems:
      Before adding repository location for the fix pack:
      <server>
           <repository location='/installation_files/Rational_Product' />
      </server>

      After adding repository location for the fix pack:
      <server>
           <repository location='/installation_files/Rational_Product' />
           <repository location='/installation_files/fixpackCC7101' />
           <repository location='/installation_files/com.ibm.cic.agent.offering' />
      </server>

    b. Remove the version attribute from the offering key located in the install command.
    Example:
      Before deleting version attribute:
      <install>
           <offering profile='IBM Rational SDLC' id='com.ibm.rational.clearcase. platform ' version='7.1.0.00-7-1-D081110' features='com.ibm.rational.clearcase...... />
      </install>
      ...where version='7.1.0.00-7-1-D081110' is the value to be deleted.

      After deleting version attribute:
      <install>
           <offering profile='IBM Rational SDLC' id='com.ibm.rational.clearcase. platform ' features='com.ibm.rational.clearcase......./>
      </install>
    c. Save and close the response file


4. Mount a directory or map a shared drive from the network shared drive to a local machine

Reminder:  Use the same drive letter for the shared drive that was used during the creation of the response file. OR, manually edit the response file to change the drive letter as appropriate for the shared drive on the local machine. For information on how to install Installation Manager using a UNC path, refer to technote 1453995.

5. On the local machine, open a command prompt to:
    Windowsinstall_dir\Installation Manager\eclipse

    Linux or UNIX systemsinstall_dir/InstallationManager/eclipse

6.  Run the command to install updates
    Windows: IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name>

    Linux or UNIX Systems: ./IBMIM --launcher.ini silent-install.ini -input <response file path and name>

Important:  On Windows, it is not supported to use the command IBMIM.exe with the silent install command. Use IBMIMc.exe with the silent install command. Use IBMIM.exe for installations that are not silent and when recording a response file.

Note: -updateAll checks available repositories for updates. The preferences com.ibm.cic.common.core.preferences.searchForUpdates and offering.service.repositories.areUsed affect the repositories that are available. You can add the -updateAll command in the response file.

The Installation Manager Information Center contains the latest information on response file commands.  For more information, see the Response file commands topic for your specific release.

Starting with version 7.1.0.2 of Rational ClearCase and Rational ClearQuest, you might be prompted to shut down running services or processes. See technote 1385993 for more information. Stop processes and services for Rational products before updating.


Related information

Installation Scenarios for ClearCase and ClearQuest
Sample response files for IBM Rational ClearCase
Sample response files for IBM Rational ClearCase Remote
Sample response files for IBM Rational ClearQuest

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest Installation

Document information

More support for: Rational ClearCase
Installation

Software version: 7.1, 7.1.1, 7.1.2

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 7017739

Modified date: 28 January 2011


Translate this page: