Installing by using command-line commands

You can install the IBM® Engineering Lifecycle Management products by using a command shell. This method is also referred to as silent installation.

Before you begin

  • You must have a supported version of IBM Installation Manager for your platform. The Web Installer downloads contain IBM Installation Manager. The easiest way to proceed is to get the Web Installer download for your platform.
  • You must have an IBM Installation Manager response file that is tailored for the products to install. The Web Installer downloads contain sample response files for installing each of the available products.
  • You must have the IBM Installation Manager repositories for each of the products to install. These repositories are available in the All Downloads section of the product downloads page.

Procedure

  1. Download the Web Installer file for your platform, and extract the contents to a location on your hard disk.
    Notes:
    • Extract any other IBM Installation Manager repository files that you download into the same directory as the Web Installer.
    • For AIX operating systemOn IBM AIX® platforms, do not use the jar command to extract the package. Use the unzip command.
  2. Open a command shell, and change to one of the following subdirectories that contains the Installation Manager and response files for your platform:
    • For Windows operating systemWindows: ExtractedDir\im\win32.win32.x86
    • For Linux operating systemLinux x86: ExtractedDir/im/linux.gtx.x86
    • For Linux operating systemLinux on Power: ExtractedDir/im/linux.gtx.ppc
    • For Linux operating systemLinux for System z®: ExtractedDir/im/linux.gtx.s390
    • For AIX operating systemAIX: ExtractedDir/im/aix.motif.ppc
  3. Two sample response files are intended for installing the Jazz™ Team Server and Jazz-based applications: silent-install-server.xml and silent-install-server2.xml.
    Notes:
    • If you do not have IBM Installation Manager installed on the machine where you are running the script, silent-install-server2.xml installs IBM Installation Manager. If you are installing by using the silent-install-server.xml script, make sure IBM Installation Manager is already installed.
    • The response files contain an example command-line invocation that uses the -acceptLicense argument. Before attempting a command-line installation, review the license agreement that is included in the /license directory at the top-level of the product download. Use the -acceptLicense argument on the command-line to indicate acceptance of this license agreement.
    • Each response file contains a line that refers to the IBM Installation Manager repository to be used during installation. Edit the repository location attribute to point to the repository.config file in the directory that you extracted the IBM Installation Manager repository files to.
      <repository location='../repository.config' />
    • By default, the response files are configured for a WebSphere Liberty server deployment. To modify the response files for a WebSphere® Application Server deployment, complete the following steps:
      1. Search for user.com.ibm.team.install.jfs.appserver.noappserver.disable and change its value to false.
      2. Search for user.com.ibm.team.install.jfs.appserver.liberty.disable and change its value to true.
      3. Remove the comment from the following section and specify a location to install the web application WAR files:For Windows operating system
        <data key='user.JazzFoundationServer.NoAppServer.WebApps.InstallLocation'
        	value='C:\tmp\silent-install\JazzTeamServer\server\webapps'/>
        	
        For Unix operating systems
        <data key='user.JazzFoundationServer.NoAppServer.WebApps.InstallLocation'
        	value='/tmp/silent-install/JazzTeamServer/server/webapps'/>
        	
    For Windows operating systemThe silent-install-server.xml response file produces an installation of the Engineering Lifecycle Management products that can be compressed and relocated elsewhere on the file system, or to other computers with the same operating system and architecture. To use this installation method on Windows, run the following command and look for the server installation in the C:\tmp\silent-install\JazzTeamServer directory:
     .\userinstc -acceptLicense -dataLocation C:\tmp\silent-install\data -silent -showVerboseProgress -nosplash -input silent-install-server.xml
    For Unix operating systemsTo use this installation method on UNIX systems, run the following command and look for the server installation in the /tmp/silent-install/JazzTeamServer directory:
     ./userinstc -acceptLicense -dataLocation /tmp/silent-install/data -silent -showVerboseProgress -nosplash -input silent-install-server.xml

    The silent-install-server2.xml response file installs Jazz Team Server by using the default IBM Installation Manager installation location for the platform.

    For Windows operating systemOn Windows, to install as an administrator into a shared area, use the installc variant in the following command:
     .\installc -acceptLicense -showVerboseProgress -input silent-install-server2.xml --launcher.ini silent-install.ini
    To install into a user-specific location use the userinstc variant in the following command:
     .\userinstc -acceptLicense -showVerboseProgress -input silent-install-server2.xml --launcher.ini user-silent-install.ini
    For Unix operating systemsOn UNIX systems, to install as an administrator into a shared area, use the installc variant in the following command:
     ./installc -acceptLicense -showVerboseProgress -input silent-install-server2.xml --launcher.ini silent-install.ini
    To install into a user-specific location use the userinstc variant in the following command:
     ./userinstc -acceptLicense -showVerboseProgress -input silent-install-server2.xml --launcher.ini user-silent-install.ini
  4. To remove an application from being installed, search for lines with TODO comments like the following:
    <!-- TODO: Remove line below to prevent installation of [Name of application or feature] -->
    For example, if you do not want to install Change and Configuration Management application, locate the lines shown below and remove or comment out the line with the <offering .../> XML element:
    <!-- TODO: Remove line below to prevent installation of the Change and Configuration Management app. -->
    <offering profile="TMP" id='com.ibm.team.install.jfs.app.rtc'/>
  5. By default, the jrs offering installs all reporting features. If you want to install a subset of features, add a features parameter and list the features that you want to install separated by commas, for example:
    <offering id='com.ibm.team.install.jfs.app.jrs' features='lqe,dcc'/>
  6. The response files for other application installations are similar in structure and function to the silent-install-server2.xml file. The examples that follow show how to install the Build System Toolkit by using the silent-install-buildsystem.xml response file, and how to install the Jazz Authorization Server for Jazz Security Architecture single sign-on (SSO) authentication.
    • Installing the Build System Toolkit by using the silent-install-buildsystem.xml response file
      For Windows operating systemOn Windows, to install as an administrator into a shared area, use the installc variant in the following command:
       .\installc -acceptLicense -showVerboseProgress -input silent-install-buildsystem.xml --launcher.ini silent-install.ini
      To install into a user-specific location, use the userinstc variant in the following command:
       .\userinstc -acceptLicense -showVerboseProgress -input silent-install-buildsystem.xml --launcher.ini user-silent-install.ini
      For Unix operating systemsOn UNIX systems, to install as an administrator into a shared area, use the installc variant in the following command:
       ./installc -acceptLicense -showVerboseProgress -input silent-install-buildsystem.xml --launcher.ini silent-install.ini
      To install into a user-specific location, use the userinstc variant in the following command:
       ./userinstc -acceptLicense -showVerboseProgress -input silent-install-buildsystem.xml --launcher.ini user-silent-install.ini
    • Installing Jazz Authorization Server by using the silent-install-jas.xml and silent-install-jas2.xml response files

      The silent-install-jas.xml response file produces an installation of Jazz Authorization Server that can be compressed and relocated elsewhere on the file system, or to other computers with the same operating system and architecture.

      For Windows operating systemOn Windows, run the following command and look for the server installation in the C:\tmp\silent-install\JazzAuthServer directory:
      .\userinstc -dataLocation C:\tmp\silent-install\data -silent -showVerboseProgress -nosplash -input silent-install-jas.xml -acceptLicense
      For Unix operating systemsOn UNIX systems, run the following command and look for Jazz Authorization Server installation in the /tmp/silent-install/JazzAuthServer directory:
      ./userinstc -dataLocation /tmp/silent-install/data -silent -showVerboseProgress -nosplash -input silent-install-jas.xml -acceptLicense

      The silent-install-jas2.xml response file installs Jazz Authorization Server into an instance of IBM Installation Manager on the local machine.

      On Windows, to install as an administrator into a shared area, use the installc variant in the following command:
      .\installc -showVerboseProgress -input silent-install-jas2.xml --launcher.ini silent-install.ini -acceptLicense
      To install into a user-specific location, use the userinstc variant in the following command:
      .\userinstc -showVerboseProgress -input silent-install-jas2.xml --launcher.ini user-silent-install.ini -acceptLicense
      For Unix operating systemsOn UNIX systems, to install as an administrator into a shared area, use the installc variant in the following command:
      ./installc -showVerboseProgress -input silent-install-jas2.xml --launcher.ini silent-install.ini -acceptLicense
      To install into a user-specific location, use the userinstc variant in the following command:
      ./userinstc -showVerboseProgress -input silent-install-jas2.xml --launcher.ini user-silent-install.ini -acceptLicense

    To install other products, replace the name of the response file. For example, to install the IBM Engineering Workflow Management client for Eclipse IDE, in the examples for installing the Build System Toolkit, replace silent-install-buildsystem.xml with silent-install-client.xml.


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki