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 the installation is set up correctly.


Before starting

Before you start this task, complete the following checks:

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

Before you install IBM MQ, check that the 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.


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

Note: If we 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 we 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, we 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 we want the installation logs to be written to. Note: The folder where we want the install.log to be created must exist before you run the command.
  • /q this parameter must be used to perform the silent installation.
  • 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

  1. 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 the IBM MQ installation media. Note: The folder where we want the install.log to be created must exist before you run the command. 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. We have installed IBM MQ, and you have started the IBM MQ service.

  2. Set up environment variables for the installation by using the setmqenv command.
    1. Enter the following command in the command line: Note: If we 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
      

    We have successfully installed IBM MQ using a silent installation.


Results

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


What to do next

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. We can also check the parameters that you passed with the command, masking sure we are including all the required parameters.

Parent topic: Installing and configuring using the command line interface


Related information