Scenario of installing ClearCase or ClearQuest with Installation Manager from an HTTP server

White paper


Abstract

An outline of installing an IBM Rational product with IBM Installation Manager from an HTTP server. This scenario requires the use of the IBM Packaging Utility.

Content


Table of Contents


Notes:

  • "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.

  • 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. Installing the Rational product



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


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




      3. Extract the installation files for the Rational product, Installation Manager and the Packaging Utility to a local machine. The extracted installation files contain the product repository. 

      Example directories on the local machine that contain the extracted installation files:
        Windows:
        C:\installation_files\Rational_product
        C:\installation_files\EnterpriseCD- platform\InstallationManager
        C:\installation_files\EnterpriseCD- platform\PackagingUtility
        Linux or UNIX systems:
        /installation_files/Rational_product
        /installation_files/EnterpriseCD- platform/InstallationManager
        /installation_files/EnterpriseCD- platform/PackagingUtility


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




      5. Locate the file pu.disk_ platform-version.zip under the PackagingUtility directory.  Unzip this file to the PackagingUtility directory. 

      6. Install Installation Manager and IBM Packaging Utility. Installation Manager is installed when you install Packaging Utility.  

        Windows
        install_files\InstallationManager\install.exe
        install_files\PackagingUtility\disk_ platform\InstallerImage_ platform\install.exe

        Linux or UNIX systems
        /install_files/InstallationManager/install.exe
        /install_files/PackagingUtility/disk_ platform/InstallerImage_ platform/install

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

      Examples:

        Windows
        c:\installation_files\EnterpiseCD- platform\InstallationManager\install.exe
        c:\installation_files\EnterpriseCD- platform \PackagingUtility\disk_ platform\InstallerImage_ platform\install.exe

        Linux or UNIX systems:
        /installation_files/EnterpiseCD- platform/InstallationManager/install.exe /installation_files/EnterpriseCD- platform/PackagingUtility/disk_ platform/InstallerImage_ platform/install




      II. Create the repository in Packaging Utility

      1. Check access to the HTTP server from the machine with Packaging Utility installed. Access includes FTP access or mapping a writable, shared drive to document directory on the HTTP server.

      2. Start the Packaging Utility.

      3. Click Copy Packages > Next.

      4. Click Open Repository.

      5. Click Browse and navigate to the directory containing the Rational product installation files.

        Windows: C:\installation_files\Rational_product\disk1\diskTag.inf

        Linux or UNIX systems: /installation_files/Rational_product/disk1/diskTag.inf

      Note: If you have a repository that contains a diskTag.inf and a repository.config, you must select the diskTag.inf directory. When the repository.config directory is selected, the copy process fails.


      Optional: To enter a different repository name, uncheck the option Use the location as the name of the target repository. The default value for the repository name is the location of the selected repository.

      Example of default value for Repository Name:

          Windows: C:\installation_files\Rational_product\disk1\diskTag.inf

          Linux or UNIX systems: /installation_files/Rational_product/disk1/diskTag.inf

      6. Click OK.

      7. On the Source screen, verify that the Rational product repository is selected.

        Note: Expand the repository name to see what files are located in the repository


      8. Click Next > Accept License Agreement.

      9. Click Browse to select a directory on the HTTP server to create a new repository. You must select an existing directory.

      Example:
        Windows: \\HTTPServer\Rational_product

        Linux or UNIX systems: /HTTPServer/Rational_product


      10. Click Next.

      11. Click Copy. This step copies the selected repositories into a repository located on the HTTP server.

      Example:
        Windows:
        Files in the Rational product repository, C:\installation_files\Rational_product\disk1\diskTag.inf, are copied to the repository on the HTTP server, \\HTTPServer\Rational_product.
        Linux or UNIX systems:
        Files in the Rational product repository, installation_files/Rational_product/disk1/diskTag.inf, are copied to the repository on the HTTP server, /HTTPServer/Rational_product.

      12. Close Packaging Utility.

      13. Copy the Installation Manager files to the HTTP server.

      Example:
        Windows: \\HTTPServer\InstallationManager

        Linux or UNIX systems: /HTTPServer/InstallationManager

      Reminder: You cannot add Installation Manager installation files to the repository created by the Packaging Utility. Installation Manager must be installed on the machine before accessing the repository created by Packaging Utility. You can add an Installation Manager fix pack, com.ibm.cic.agent.offering.zip, to the repository created by packaging Utility.







      III. Installing a Rational product


      1. Check user requirements for installing. Rational Team products require administrator access. See these topics for your product:
      2. Install Installation Manager if it is not already installed

        Windows: \\HTTP_server\InstallationManager\install.exe

        Linux or UNIX systems/install_files/InstallationManager/install.exe

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

      Examples:

        Windows:  c:\installation_files\EnterpiseCD- platform\InstallationManager\install.exe

        Linux or UNIX systems: /installation_files/EnterpiseCD- platform/InstallationManager/install.exe

      3. Start Installation Manager.
      4. Add the repository in Installation Manager.

        a. Go to the menu option File > Preferences.

        b.
        Click Add Repository...

        c.
        Click Browse... Input the URL for the repository.config on the HTTP server or navigate to the directory containing repository.config on the HTTP server.

        Example: http://server/Rational_product/repository.config


        d.
        Click Open > OK, > Apply > OK.



      5. Install the Rational product

      Note: If the Rational product requires a later version of Installation Manager, you are prompted to update based on the preferences below and if you have the latest Installation Manager fix pack accessible. Updates to Installation Manager are affected by the preferences Search for Installation Manager updates and Search service repositories during installation and updates. When Installation Manager is installed on a machine, it checks for newer versions of Installation Manager based on the preferences settings. 

      This message appears if you have access to a newer version of Installation Manager.

        A new version of IBM Installation Manager is available.  You must update Installation Manager before you can continue.  To update Installation Manager, click Yes.  To return to the Start page, click No.  Do you want to update the Installation Manager?


      When you click No, you cannot continue with the update. To display the message again after clicking No, click Recheck Status located in the lower right hand corner.

      After the update to Installation Manager finishes, you are prompted to restart Installation Manager.

      6. If Installation Manager is updated, click Install after Installation Manager restarts

      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.







      IV. Install the Rational product on additional machines

      1. Mount a directory or map a shared drive from the HTTP server onto the local machine.

      2. Check user requirements for installing. Rational Team products require administrator access. See these topics for your product:

      3. Install Installation Manager if is not already installed:


        Windows: \\HTTP_server\InstallationManager\install.exe


        Linux or UNIX systems/install_files/InstallationManager/install.exe

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

        Examples:


        Windows:  c:\installation_files\EnterpiseCD-platform\InstallationManager\install.exe

        Linux or UNIX systems: /installation_files/EnterpiseCD-platform/InstallationManager/install.exe

      4. Start Installation Manager if does not restart after installation completes.

      5. Add the repository in Installation Manager.

        a. Go to the menu option File > Preferences.

        b.
        Click Add Repository...

        c.
        Click Browse... Input the URL for the repository.config on the HTTP server or navigate to the directory containing repository.config on the HTTP server.

        Example: http://server/Rational_product/repository.config


        d.
        Click Open > OK, > Apply > OK.


      6. Install the Rational product.


      Click Install to start the installation wizard. Enter configuration information during the installation.







      V. Add a Rational product fix pack to the repository


      Note: For Rational ClearCase and Rational ClearQuest, you do not need to install each fix pack. Instead, you can install only the latest fix pack. You do need a connection to the Rational ClearCase v7.1 or Rational ClearQuest v7.1 repository when installing a fix pack.

      Example: Fix packs 7.1.0.1 and 7.1.0.2 are available for Rational ClearCase on Windows. You can install 7.1.0.2. You do not need to install 7.1.0.1.

      1.  Download the fix pack from IBM.com 

      2.  Extract the fix pack installation files to a directory on the machine that has Packaging Utility installed.  The directory contains the fix pack repository.

        Example directory on the network shared drive:

        Windows:  C:\installation_files\fixpackCC7101

        Linux or UNIX systems: /installation_files/fixpackCC7101

      3. Start the Packaging Utility.

      4. Click Copy Packages > Next.

      5. Click Open Repository.

      6. Click Browse and navigate to the directory containing the fix pack files.

        Windows: C:\installation_files\fixpackCC7101\7.1.0.1-RATL-RRC_WIN-FP01/repository.config

        Linux or UNIX systems: /installation_files/fixpackCC7101/7.1.0.2-RATL-RRC_WIN-FP02/repository.config

      Optional: To enter a different repository name, uncheck the option Use the location as the name of the target repository. The default value for the repository name is the location of the selected repository.


      7. Click Next > Accept License Agreement.

      8. Click Browse to select the repository on the HTTP server. This is the same repository that contains the Rational Product installation files that you created earlier.

      Example:

        Windows: \\HTTPServer\Rational_product

        Linux or UNIX systems: /HTTPServer/Rational_product


      9. Click Next > Copy.

      10. Close Packaging Utility.

      11. Start Installation Manager.

      Note: You do not need to add the repository location in Installation Manager unless the repository location has been deleted from the repository table or the repository location has changed.

      12. Click Update to install the fix pack.



      Related information

      Installation Scenarios for ClearCase and ClearQuest

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

      Rate this page:

      (0 users)Average rating

      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 #:

      7017740

      Modified date:

      2011-01-28

      Translate my page

      Machine Translation

      Content navigation