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
- 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.
- 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_64
Linux x86: ExtractedDir/im/linux.gtx.x86_64
Linux on Power: ExtractedDir/im/linux.gtx.ppc64le
Linux for System z: ExtractedDir/im/linux.gtx.s390x
-
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 beginning 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 deploying Engineering Lifecycle Management on an
embedded WebSphere® Liberty server. To modify the response files for an external WebSphere Liberty
deployment, complete the following steps:
- Search for
user.com.ibm.team.install.jfs.appserver.liberty.embedded.disable
and change its value totrue
. - Complete the set up after the installation. See, Configuring Engineering Lifecycle Management on a stand-alone WebSphere Liberty server.
- Search for
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 following lines and remove or comment out the line with the<!-- TODO: Remove the following line to prevent installation of [Name of application or feature] -->
<offering .../>
XML element:<!-- TODO: Remove the following line to prevent installation of the Change and Configuration Management app. --> <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.
- Installing the Build System Toolkit by using the
silent-install-buildsystem.xml response file