Prep work:

Read this page from IBM it is a good starter for 10.

As you can see above I have opened the IBM WebSphere Message Broker Information Center. We do this because it is best practice to ensure that you complete the prerequisites

We will be dealing with installing several components:

  • IBM WebSphere Message Broker
  • IBM WebSphere Message Broker Tookit
  • IBM WebSphere MQ 7.5
  • IBM WebShere MQ Explorer
  • WebSphere Message Broker Explorer Plugin

Normally I get some fix packs from IBM FixCentral, but it was down as I was writing this article

I will validate this later

Windows Prerequisites

Essential for windows all need is local admin rights as per your domain or local security policies. This can be tricky in some organisation where workstations are locked down. Being a developer you may have special privileges?

The only other thing we need to do is prepare security users/groups for MQ and Broker

User ID restrictions: some operating systems and other products impose restrictions on user IDs:

  • On Windows systems, user IDs can be up to 12 characters long, but on Linux, UNIX, and z/OS® systems, they are restricted to eight characters. Database products, for example DB2®, might also restrict user IDs to eight characters. If you have a mixed environment, ensure that the user IDs that you use within the broker environment are limited to a maximum of eight characters. This is rally important if you are going to deploy to a Linux Broker. I have several MessageBroker/WMQ Explorer/Security articles on my blog: and on my Courseware site:
  • Ensure that the case (upper, lower, or mixed) of user IDs in your broker environment is consistent. In some environments, uppercase and lowercase user IDs are considered the same, but in other environments, user IDs of different case are considered unique. For example, on Windows the user IDs ‘tester’ and ‘TESTER’ are identical, but on Linux and UNIX systems they are recognized as different user IDs.
  • Check the validity of spaces and special characters in user IDs to ensure that, if used, these characters are accepted by all relevant systems and products in your broker environment.

Set up the required security on Windows

Before you install the Broker component, the WebSphere Message Broker Toolkit, or the WebSphere Message Broker Explorer, log on with a user ID that has Administrator authority.

If you are installing the Broker component, the installation wizard calls the mqsisetsecurity command which completes the following tasks:

  • Creates a new security group called mqbrkrs.
  • Adds your current (logged on) user ID to the group mqbrkrs.
  • Adds your current user ID to the group mqm, if that group exists.

The mqm group exists if you have already installed WebSphere MQ on this system. If you have not, call the mqsisetsecurity command when you have completed WebSphere MQ installation. If you use the Windows Launchpad (described in Installing by using the Windows Launchpad), it completes WebSphere MQ installation first.

Note: If you prefer to create principals before you install WebSphere Message Broker, use the security facilities provided by the Windows Control Panel.

If you are running Terminal Services on this computer, change user mode to ensure that actions taken during installation are completed correctly; for example, the creation of .ini files and other related files in the default system directory C:\Windows. If you do not change user mode, files might be written to other locations and, although the installation might complete successfully, the product might not work as expected.

Before you install any product components, enter the following command to change user mode:

change user /install

When installation is complete, enter the following command to restore the original user mode:

change user /execute

To complete verification, your user ID must have Administrator authority. If you log in with a different user ID from the ID with which you perform installation, you must add that user ID to the groups mqbrkrs and mqm. Use either the Windows security facilities or the mqsisetsecurity command (run this command after you have logged on with that different ID) to complete these additions.

The Windows Launchpad.

This program installs prerequisite products if they are not already installed, and identifies prerequisite products that are not at the supported level.

We are going to start with running this tool form the installation media and see what it reports to us

As you can see below I am running the Launch pad that is inside the WebSphereMessage Broker (WMB) media folder.

As you can see, when this installation wizard was created WMQ was the latest. I am going to try and use WMQ 7.5 instead.

Installing IBM WebSphere MQ

Before install any WMB tools/Broker etc, I am going to install WMQ 7.5

Run setup for WMQ

Click launch IBM WebSphere MQ Installer.

Read and Accept License

Choose a custom installation to learn about how it will install

WMQ 7.5 allows for many instances. If you want to know more about install practices then I cover this in my course

I have opted to not install WMQ in the default Windows suggested folder, this saved me typing complex paths in CMD prompts. It also stops issues with Windows Virtual folder security.

Click Next

This is a local install, so data folder is not important. In production this would be a separate file-system drive ie D-Drive or similar. Depends on your VMWare or other VM setups.

Click Next and set your log folder. Think about storage limits!

Click Next

Chose you extended features as required…

click Next, Review and Install

Click Finish

The Prepare WebSphere MQ wizard will launch

A Windows Service will be added so you can decide to change the auto start ability of WMQ by modifying the service in the Windows control panel.

I am local so no domain servers.

Click Next and the WMQ Service will start, Click Next and finish.

Here is a look at the 2 services created:

What is the purpose of the AMQSVC.EXE process on Windows platforms ie the Service called IBM MQSeries?

Well, the amqsvc.exe is the MQ Service process, which launches amqmsrvn.exe by way of dcom. It normally runs under SYSTEM account.

MQ needs a dcom object, because it does not run as a traditional Windows service. amqsvc.exe is the operating system service that acts as a stub, which creates the dcom object, and MQ is launched from that dcom object. It is done this way to enable MQ to run under a user specified account, which is required for some of the MQ operations.

To stop the amqsvc.exe process (other than by using the ‘net stop IBM MQSeries’ command), run the command “amqsvc -stop”.

The MQSeries (Windows) service (amqsvc) has a few command line options to help should problems arise:


-INSTALL : Reinstalls the registry keys to make the MQ Service defined

-UNINSTALL : Removes the MQSeries service

-SILENT : Hides error messages when install/uninstall performed

-START : Starts the service (Use Net Start “MQSeries Service” instead?)

-STOP : Stops the service (Use Net Stop “MQSeries Service” instead?)

OK let’s look at the user/groups that were created:

I think these are self explanatory and we can have another peek after we have installed WMB.

I think we should launch MQ Explorer one to prove it is OK.

I am creating a Queue Manager called TEST.MQ to see if I can put on a Queue called TEST.Q

I used 2414 as the port in case I forget to remove it and so it doesn’t conflict with Broker Default configuration.

Create the QLocal called TEST.Q

Let us put a test message

Let’s get the message

We now have a queue depth of 1.

OK I am happy; we have proven WMQ is OK. We should install a Fixpack, bit you can see that in my course.

Completing WebSphere Message Broker now that we have WMQ installed

Installing WMB and MBTK and MBE

We can now see that the next time we run the Launchpad that WMQ is detected. Lists wrong version, but we don’t care!

Click Launch Installation for WebSphere Message Broker

Click OK

Click Next

Click Next

I chose to not use IBM default location.

Click Next

Click Done.

Next you will be asked to find our media for IBM Installation Manager. It all depends on how your local installation media was unpacked.

Browse for disk 1 etc and continue

Note we will be prompted for the other disks during installation

I changed the install location

Click Next

Note: I skipped a few screen captures; I am sure by now you get the idea.

Click Install

Click finish

Now it will install the Message Broker Explorer. A bit weird as we already have WMQ Explorer, so it will just update them both to be the same i.e. WebSphere MQ Explorer is updated with the MB Explorer plug-in.

Click Next, review summary then Click install

Click Done.

Let us now go an see what has been installed

Loads of WMB goodies.

I will now look at Users/Groups to see what we have. Essentially we have the new mqbrkrs group. Make sure you have access!

When we launch MQ Explorer or Mb Explorer we get

We can see the new WMB plug-in that allows WMA admins to see the Brokers.

I am now going to run Message Broker toolkit (MBTK)

It will prompt for a default workspace

Choose a suitable location, click OK

You can consult my WMB blog articles for how to sort out configuring a default broker.

Well that’s it we have WMQ, WMB, MBExplorer, MQExplorer, MBTKit and a running system on windows.

Enjoy your new Broker Test/Dev environment.

3 Responses to Installing WebSphere Message Broker 8 for Windows
  1. Hello There,

    I have windows7, home premium edition. And it seems it does not have user groups options in the system.

    Also I tried to install MQ and after it’s install, I do not see MQ explorer option in the start menu folder.

    Finally i tried installing silent script, and it did says at command prompt that it install everything but

    unfortunately it didn’t.

    I think it#s more of my machine configuration which is hindering rather than the instructions. Any

    advice ?

    Thanks in advance.


    • I guessyou are logged in a a non local administrator. Check your local users and you will see if you are logged in as a user or admin.
      I use Windows 7 Professional and never dealt with Home Premium for this reason. Home premium is not something that people use in companies/corporates.

      Search around Google for help on administrative rights enabling for Windows HP edition.

  2. Thanks for the prompt reply. I was trying to install on personal laptop

    and not on any Corporate one. The version of windows is something I

    got when I purchased that laptop.

    I understand that now I need to update the version of the window to

    actually install WMB8.

    Thanks for this wonderful tutorial anyway. It is brilliant.


Leave a Reply