Installing with a response file

Use the silent installation feature of IBM® Installation Manager to complete new installations of Rational® Adapter for Git unattended. Edit a provided response file such that it contains the commands and inputs that you want for your software installation. Alternatively, create a response file by recording your actions in IBM Installation Manager.

Before you begin

Complete these tasks before you install the adapter software:

Important: If Installation Manager is already installed and repository connections require authentication, a keyring file is required to store the credentials for those URLs. For more information about creating a keyring file, see Store credentials.

About this task

The response file is an XML document that is used when you run a silent installation. You can edit the provided response file to match your installation preferences. Alternatively, you can create a response file by recording your actions in IBM Installation Manager. For more information about recording a response file, see Record a response file with Installation Manager.

Procedure

  1. Determine the target package group ID used to install the Jazz Team Server.
    1. Start Installation Manager.
    2. Click File > View Installed Packages.
    3. Find the installed package named IBM Collaborative Lifecycle Management.
    4. Note the name of the package.
    5. Close Installation Manager.
  2. Stop the Jazz Team Server if it is running on an Apache Tomcat application server.
  3. This sample response file is intended for installing the adapter: silent-install.xml.
    1. For Windows Edit the response file ExtractedDir\GIT\disk1\silent-install.xml
    2. For Linux Edit the response file ExtractedDir/GIT/disk1/silent-install.xml
    3. Change the value of the <offering id='com.ibm.rational.oslc.adapter.git" profile="IBM Collaborative Lifecycle Management" features="main.feature"/> profile property to the package name for IBM Collaborative Lifecycle Management.

      For example, <offering id='com.ibm.rational.oslc.adapter.git" profile="IBM Collaborative Lifecycle Management_2" features="main.feature"/>

    4. Save the response file.

      For more information about response files, see Response files.

  4. Use the response file that you edited. Change to the tools directory that contains the imcl command.
    • If Installation Manager is already installed, then install the adapter by using the imcl command from the Installation Manager tools directory. For more information about installing packages from the Installation Manager tools directory, see Install packages by using imcl.
    • If Installation Manager is not installed, then install the adapter by using the imcl command from the adapter tools directory. Change to one of the following subdirectories that contains the Installation Manager command for your platform:
      • For Windows ExtractedDir\GIT\disk1\InstallerImage_win32.win32.x86\tools
      • For Linux ExtractedDir/GIT/disk1/InstallerImage_linux.gtk.x86/tools
  5. Install the Rational Adapter for Git by using a command line.
    Important: The response file contains an example command-line invocation that uses the -acceptLicense argument. Before you attempt a command-line installation, review the license agreement that is included in the /license directory at the top level of the media package. Use the -acceptLicense argument on the command line to indicate acceptance of this license agreement.
    • For Windows Install with the following command:
       imcl.exe -input ExtractedDir\GIT\disk1\silent-install.xml -acceptLicense -showVerboseProgress
    • For Linux Install with the following command:
       ./imcl -input ExtractedDir/GIT/disk1/silent-install.xml -acceptLicense -showVerboseProgress
  6. Start the JTS server if its running on an Apache Tomcat application server.

Results

The adapter is installed into an existing Jazz Team Server.

What to do next

Complete the post installation tasks, see Postinstallation tasks.

Feedback