Install using the launchpad

Install IBM MQ on Windows using the installation launchpad, and verify your installation by using the Postcard application.

Before you begin

Before completing 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 we have sufficient disk space, up to 1005 MB, to fully install IBM MQ for Windows.
• Determine whether you need to define Windows domain user ID's for any IBM MQ users.

Before installing 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

The launchpad and subsequent wizards take you through the installation process and help you review the software requirements and IBM MQ settings. You are also taken through initial tasks for creating a default queue manager, a local queue and can verify the installation by using the Postcard application.

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

Note: If you are installing IBM MQ Version 9.0, and we have any previous installations of IBM MQ on your machine, the location of the program and data files will be different from the default. 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.

The installation programs contain links to further information if you require it during the installation process.

Procedure

1. Start the Launchpad, review, and if necessary, modify the software requirements and network configuration.
   1. Navigate to the IBM MQ software directory, and double-click the file Setup.exe to start the Launchpad.
   2. Select the Software Requirements tab to display the Software Requirements settings.
   3. Check that the software requirements have been met and that the entry for the requirement displays a green tick with the words OK. Make any indicated corrections. Note:

      For details of any requirement, click the check box to expand an information tab.

   4. Select the Network Configuration tab to display the Network Configuration settings.
   5. Select No. Note: This scenario assumes that we do not need to configure a domain user ID for IBM MQ. For more information regarding configuring IBM MQ for Windows domain users, click More information.
   6. 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.
   You have completed setting up IBM MQ by meeting or specifying your installation requirements, and have started the IBM MQ installation wizard.
2. Use the IBM MQ installation wizard to install the software, and start the Prepare IBM MQ wizard.
   1. In the Prepare IBM MQ wizard, read the License Agreement and click the I accept the terms in the license agreement check box, and then click the next button.
   2. Click Typical, and then click Next.
   3. In the Ready to Install IBM MQ page, review the installation information and click the Install button. Note: Note the following details:
      • Installation Name
      • Top-level folder for Program Files
      • Top level folder for Data Files
      The following features are installed:
      • IBM MQ Server
      • IBM MQ: a graphical interface for administering and monitoring IBM MQ resources
      • Java and .NET Messaging and Web Services
      • IBM MQ Development Toolkit
      The installation process begins. 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 .

   4. Click Finish.
   You have successfully installed IBM MQ. The Prepare IBM MQ wizard starts automatically, displaying the Welcome to the Prepare IBM MQ Wizard page.
3. Use the Prepare MQ wizard to start the IBM MQ service and start the Default Configuration wizard. Note:

   We cannot create the default configuration if we have already created other queue managers; you must first delete the other queue managers then run the Default Configuration wizard. To delete a queue manager, see Steps for deleting a queue manager

   1. On the Welcome to the Prepare IBM MQ Wizard, select Next. The Prepare IBM MQ Wizard displays the message Status: Checking IBM MQ Configuration and a progress bar. When the process is complete the IBM MQ Network Configuration page is displayed.
   2. On the IBM MQ Network Configuration page of the Prepare IBM MQ Wizard, select No.
   3. Click Next. The Prepare IBM MQ Wizard displays a message Status: starting the IBM MQ Service , and a progress bar. When the process is complete the wizard displays the Completing the Prepare IBM MQ Wizard page.
   4. Select Launch IBM MQ Explorer and choose whether to view the release notes, and then click the Finish button. IBM MQ Explorer starts.
   You have installed IBM MQ. You have also started the IBM MQ Explorer.
4. Optional: If you want to use the IBM MQ Postcard application to verify your installation, create the default configuration.
   1. If the Content page is not already displayed, click Window > Show View > IBM MQ Explorer - Content to display it.
   2. Click Create the Default Configuration. The IBM MQ Default Configuration page is opened.
   3. Click Set up Default Configuration. The Default Configuration Wizard is opened.
   4. Click Next and Next again to move through the information pages.
   5. On the Default Configuration page, clear both Allow remote administration of the queue manager and Join the queue manager to the default cluster options, and then click Next. Take a note of the queue manager name, as you will need this later, when using the Postcard application.
   6. On the summary page, click Finish. The Default Configuration Wizard is closed, and a dialog box displaying the message Set up the default default configuration. appears. When this is complete, focus is returned to the IBM MQ Default Configuration window, and the following message is displayed: Default configuration is partially complete . Note: The IBM MQ Default Configuration window might also display the message: Join the default cluster by clicking "Join default cluster" to complete the default configuration on this computer. This is only necessary if you want to join a cluster, which is not required for this scenario.
   7. Click Close.
   The Default Configuration is now set up, and you are ready to verify your installation.
5. Optional: If you created a default configuration, verify your installation by using the Postcard application that is supplied with IBM MQ. You can start two instances of the Postcard application and exchange messages between them. If you did not create a default configuration, we can still follow these steps to verify your installation, but you must first configure a queue manager as described in the previous task of this scenario. Note: Running the Postcard application on a non-default configuration automatically creates a queue called postcard on your queue manager. We can delete this queue after using the postcard application.
   1. If the Content page is not already displayed, click Window > Show View > IBM MQ Explorer - Content to display it.
   2. Click Launch Postcard to open the Postcard - Sign On window.
   3. Enter a nickname for the first user, for example: Jim and click OK.
   4. On the IBM MQ Postcard Network window select Continue on this computer only and click OK. The Postcard application for 'jim' opens.
   5. Move Jim's Postcards to one side of your screen, then start a second Postcard.
   6. Click Launch Postcard to open the Postcard - Sign On window.
   7. Enter a nickname for the second user, for example: Sue and click OK.
   8. On the IBM MQ Postcard Network window select Continue on this computer only and click OK. The Postcard application for 'sue' opens.
   9. In the Postcard - 'jim' window enter sue in the To: textbox.
   10. In the Postcard - 'jim' window enter the name of the queue manager you defined in step 4e, or taken from the entry On: beneath the Message: textbox.
   11. In the Postcard - 'jim' window enter a message, for example Hi Sue! in the Message: textbox
   12. Click Send button to send the message to user Sue.
   13. Observe the message received by user Sue, in the Postcard - 'sue' application window. To view the received message double-click on the entry in the Postcards sent and received grid. Note: Click Help in this and other Postcard application windows to view further instructions about running the Postcard application.
   You have verified your IBM MQ installation by using the Postcard application.

Results

IBM MQ is installed and verified, and you are ready to configure objects such as queue managers and queues.

What to do next

Follow the instructions in Creating a queue manager called QM1.