Installing using a silent installation

Install IBM® MQ on Windows by using the command line to perform a silent installation and confirm that the environment for your installation is set up correctly.

Before you begin

Before you start this task, complete the following checks:

You must have local administrator authority when you are installing. Define this authority through the Windows facilities.
Ensure that the machine name does not contain any spaces.
Ensure that you have sufficient disk space. You need up to 1005 MB to fully install IBM MQ 9.0 for Windows.
Determine whether you need to define Windows domain user IDs for any IBM MQ users.

Before you install IBM MQ, check that your system meets the hardware and software requirements. For the latest details of hardware and software requirements on all supported platforms, see System Requirements for IBM MQ.

About this task

This scenario assumes that you are installing IBM MQ for the first time on your machine, and that you are using the default locations. By default the location of the IBM MQ 9.0 program files are C:\Program Files\IBM\MQ, and the data and log file location is C:\ProgramData\IBM\MQ.

Note: If you have any previous installations of IBM MQ on your machine the default locations of the program and data files might change. For further information, see Program and data directory locations. If you have already previously completed this scenario, and want to repeat it with a single, fresh installation using the default locations, remove your previous installation before starting the scenario again. To uninstall an existing instance of IBM MQ from your machine, see Uninstalling IBM MQ.

IBM MQ on Windows uses the MSI technology to install software. For more information on installing using the MSI technology, see Advanced installation using msiexec.

To install IBM MQ using the command line, you must specify the following parameters:

/i "MQ_INSTALLATION_MEDIA\MSI\IBM MQ.msi" where MQ_INSTALLATION_MEDIA is the location of the IBM MQ.msi file. This argument specifies the location of the .msi file.
/l*v USER_LOGFILE_LOCATION\install.log where USER_LOGFILE_LOCATION is where you want the installation logs to be written to.
Note: The folder where you want the install.log to be created must exist before you run the command.
/q[n|b|r|f] /q must be paired with one of n, b, r, or f. Running the msiexec command at a command prompt opens the help file, which shows the correct usage.
USEINI="RESPONSE_FILE" where RESPONSE_FILE is the name and location of the response file to be used by the silent installation. This scenario uses the sample Response.ini file, which is included in the IBM MQ installation media.
TRANSFORMS="TRANSFORM_FILE" where TRANSFORM_FILE is the name of the transform file to be applied to the installation. This scenario uses the American English transform, 1033.mst.
AGREETOLICENSE="YES" this parameter must be included, or the installation can not complete.
ADDLOCAL="Server" this parameter lists which components to install.

Procedure

Use the command line to conduct a silent installation.
1. To invoke the silent installation from an elevated command prompt, click the Start button on your Windows taskbar and type cmd in search programs and files field. Right click the cmd.exe program and select Run as administrator.
2. In the Windows command prompt, enter the following command:
  Note: The command is presented on multiple lines here, but it must be typed out on one line.
```
msiexec /i "MQ_INSTALLATION_MEDIA\MSI\IBM MQ.msi"
/l*v c:\wmqinslogs\install.log
/q USEINI="MQ_INSTALLATION_MEDIA\Response.ini"
TRANSFORMS="1033.mst"
AGREETOLICENSE="yes"
ADDLOCAL="Server"
```
  Where MQ_INSTALLATION_MEDIA is the path to your IBM MQ installation media.
  Note: The folder where you want the install.log to be created must exist before you run the command.
  
  Note:
  After you input the command, the command line will return the prompt.
3. To view the installations progress, open the log file that you specified. If the installation completed successfully, you see the message Product: IBM MQ (Installation1) -- Installation operation completed successfully. two paragraphs up from the bottom of the log file.
4. When the installation is complete, the service starts and the IBM MQ icon appears in the system tray.
  You have installed IBM MQ, and you have started the IBM MQ service.
Set up environment variables for your installation by using the setmqenv command.
1. Enter the following command in the command line:
  Note: If you used the default location, the path to your installation will be C:\Program Files\IBM\MQ.
```
"MQ_INSTALLATION_PATH/bin/setmqenv" -s
```
  where MQ_INSTALLATION_PATH refers to the location where IBM MQ is installed. Ensure you enclose the path to setmqenv in the bin folder, in quotation marks, to prevent the prompt returning an error.
2. Check that the environment is set up correctly by entering the following command:
```
dspmqver
```
  If the command completes successfully, and the expected version number and installation name are returned, the environment is correctly set up. For this scenario the message should include the line:
```
Version: 9.0.0.0
```
  and if you did not specify a non-default installation name, the line:
```
InstName: Installation1
```
You have successfully installed IBM MQ using a silent installation.

Results

You have conducted an IBM MQ silent installation and confirmed that your environment is set up correctly.

What to do next

You can run the Prepare IBM MQ Wizard.
Follow the instructions in Creating a queue manager called QM1.

If you encounter any issues during the installation, check the installation log, at the location that you specified in the msiexec command, in this scenario the location of the log file is: c:\wmqinslogs\install.log. Take any action that is specified in the log and rerun the installation again. You can also check the parameters that you passed with the command, masking sure you are including all the required parameters.