Installing by using command-line commands

Edit online

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

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.
- On IBM AIX® platforms, do not use the jar command to extract the package. Use the unzip command.
Open a command shell, and change to one of the following subdirectories that contains the Installation Manager and response files for your platform:
- Windows: ExtractedDir\im\win32.win32.x86
- Linux® x86: ExtractedDir/im/linux.gtx.x86
- Linux on Power: ExtractedDir/im/linux.gtx.ppc
- Linux for System z®: ExtractedDir/im/linux.gtx.s390
- AIX: ExtractedDir/im/aix.motif.ppc
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:
    <data key='user.JazzFoundationServer.NoAppServer.WebApps.InstallLocation' value='C:\tmp\silent-install\JazzTeamServer\server\webapps'/>
    <data key='user.JazzFoundationServer.NoAppServer.WebApps.InstallLocation' value='/tmp/silent-install/JazzTeamServer/server/webapps'/>
The 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
```
To 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.
On 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
```
On 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
```
To remove an application from being installed, search for lines with TODO comments like the following:
```

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

<offering profile="TMP" id='com.ibm.team.install.jfs.app.rtc'/>
```
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'/>
```
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
  On 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
```
  On 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.
  On 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
```
  On 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
```
  On 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.