Installing the server using the Launchpad

You can install IBM® MQ server on Windows systems by using the Launchpad. This procedure can be used for installing a first or a subsequent installation.

About this task

You can use the Launchpad to make a compact, typical, or custom installation of IBM MQ. You can reuse the launchpad multiple times to install further installations. It automatically selects the next available installation name, instance, and location to use. To view all the installation types and the features that are installed with each option, see Installation methods for Windows.

Note that if you have previously uninstalled IBM MQ from your system (see Uninstalling IBM MQ on Windows ), some configuration information might remain, and some default values might be changed.

[MQ 9.3.0 Jun 2022] From IBM MQ 9.3.0, a new Confirm License Entitlement panel in the Windows interactive installer is presented after feature selection if you have chosen to install any IBM MQ Advanced features (MQ Telemetry Service, Advanced Message Security, or Managed File Transfer Service), or if you are upgrading from an installation that already has these features.

This panel simply warns you that these features are considered IBM MQ Advanced functionality and should only be installed if you have entitlement to IBM MQ Advanced. This warning reduces the risk of users installing IBM MQ Advanced features on a machine in error.

Note: The Confirm License Entitlement panel applies to production server builds and not to clients, beta builds, trial builds or developer (non-warranty) builds.

Procedure

Access the IBM MQ installation image.

The location might be a network location, or a local file system directory. See Where to find downloadable installation images.
Locate Setup.exe in the base directory of the IBM MQ installation image.
- From a network location, this location might be m:\instmqs\Setup.exe
- From a local file system directory, this location might be C:\instmqs\Setup.exe
Start the installation process.

Either run Setup.exe from a command prompt, or double-click Setup.exe from Windows Explorer.

Note: If you are installing on a Windows system with UAC enabled, accept the Windows prompt to allow the launchpad to run as elevated. During installation, you might also see Open File - Security Warning dialog boxes that list International Business Machines Limited as the publisher. Click Run to allow the installation to continue.

The IBM MQ Installation window is displayed.
Follow the instructions on screen. Review, and if necessary, modify the software requirements and network configuration.
On the IBM MQ Installation tab of the Launchpad, select the installation language, and then click Launch IBM MQ Installer to start the IBM MQ installation wizard.
Use the IBM MQ installation wizard to install the software.
If you select any IBM MQ Advanced features and the Confirm License Entitlement panel then appears:
- If you do have an IBM MQ Advanced license, simply select Yes (I have an MQ Advanced license) and Next to continue with the installation.
- If you do not have an IBM MQ Advanced license and do not intend to purchase one, click Back and change your feature selections.
Depending on your system the installation process can take several minutes. At the end of the installation process, the IBM MQ Setup window displays the message Installation Wizard Completed Successfully.

When this message appears, click Finish.

Results

You have successfully installed IBM MQ. The Prepare IBM MQ wizard starts automatically, displaying the Welcome to the Prepare IBM MQ Wizard page.

What to do next

Use the Prepare IBM MQ Wizard to configure IBM MQ with a user account for your network. You must run the wizard to configure the IBM MQ Service before you can start any queue managers. For more information, see Configuring IBM MQ with the Prepare IBM MQ Wizard.

If you have chosen this installation to be the primary installation on the system, you must now set it as the primary installation. Enter the following command at the command prompt:
```
MQ_INSTALLATION_PATH\bin\setmqinst -i -p MQ_INSTALLATION_PATH
```
You can have only one primary installation on a system. If there is already a primary installation on the system, you must unset it before you can set another installation as the primary installation. For more information, see Changing the primary installation.
You might want to set up the environment to work with this installation. You can use the setmqenv or crtmqenv command to set various environment variables for a particular installation of IBM MQ. For more information, see setmqenv and crtmqenv.
For instructions on how to verify your installation, see Verifying an IBM MQ installation on Windows.