Installing the server using msiexec

IBM® MQ on Windows uses the MSI technology to install software. MSI provides both an interactive installation and a non interactive installation.

Before you begin

If you are running IBM MQ on Windows systems with User Account Control (UAC) enabled, you must invoke the installation with elevated privileges. If you are using the Command prompt or IBM MQ Explorer, you elevate privileges by using a right-click to start the program and selecting Run as administrator. If you try to run msiexec without using elevated privileges, the installation fails with an error of AMQ4353 in the installation log.

About this task

IBM MQ on Windows uses the MSI technology to install software. MSI provides both an interactive installation and a non interactive installation. An interactive installation displays panels and ask questions.

The msiexec command uses parameters to give MSI some or all of the information that can also be specified through panels during an interactive installation. This means that a user can create a reusable automated or semi-automated installation configuration. Parameters can be given through the command line, a transform file, a response file, or a combination of the three.

Some parameters can only be provided on the command line and not in a response file. For more information about these parameters, see Table 1 in Specifying command line parameters for server installation with msiexec.

There are also a number of parameters can be used either on the command line or in a response file. For more information about these parameters, see Table 1 in Creating and using a response file for server installation. If a parameter is specified both on the command line and in a response file, the setting on the command line takes precedence.

Procedure

For multiple silent installations, for each version that is to be installed, find an MSI instance ID that is available to use for that installation.
For more information, see Choosing MSI Instance IDs for multiple client installations.
To install using msiexec, at the command line, enter the msiexec command in the following format:
```
msiexec parameters [USEINI="response-file"] [TRANSFORMS="transform_file"]
```
where:

parameters

are either command-line parameters preceded by a / character, or property=value pairs. If you are using both forms of parameter, always put the command-line parameters first. For more information, see Specifying command line parameters for server installation with msiexec, which contains a link to the web site that lists all the command line parameters that are available.
For an unattended installation, you must include the /q or /qn parameter in the command line. Without this parameter, the installation is interactive.

Note: You must include the /i parameter and the file location of the IBM MQ installer package.

response-file

is the full path and file name of the file that contains the [Response] stanza and the required property=value pairs, for example C:\MyResponseFile.ini. An example response file, Response.ini, is supplied with IBM MQ. This file contains default installation parameters. For more information, see Creating and using a response file for server installation.

transform_file

is the full path and file name of a transform file. For more information, see Using transforms with msiexec for server installation and Choosing MSI Instance IDs for multiple server installations.

Note: For a silent installation to succeed, the AGREETOLICENSE="yes" property must be defined either on the command line or in the response file.

Results

After the command has been entered, the command prompt immediately reappears. IBM MQ is installing as a background process. If you have entered parameters to produce a log, check this file to see how the installation is progressing. If the installation completes successfully, you see the message Installation operation completed successfully in the log file.