Use the installation launchpad and wizards to install the later version of IBM® MQ on the same Windows computer as the one on which the earlier version was
installed.
Before you begin
Before starting this task, download the compressed file that contains the installation image, then uncompress it into a temporary directory.
This task assumes that you have previously uninstalled the earlier version of IBM MQ from which you are migrating as described in Uninstalling the earlier version. If you install the later version without first uninstalling the earlier
version, some of the options and messages that you see during the installation process will be
different from those described in this task.
Before starting 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. For more information, see Disk space requriements on
Multiplatforms.
For this scenario, it is not necessary to determine whether you need to define
Windows domain user ID's for any
IBM MQ users, as this requirement is outside the scope of this
scenario. See
Creating an Active
Directory and DNS domain for IBM MQ
for more information.
Before you install IBM MQ, check that your system
meets the hardware and software requirements. For the latest details of hardware and software
requirements, see System
Requirements for IBM MQ.
About this task
This task describes the basic steps for installing IBM MQ on a Windows operating system when migrating from an earlier version.
Note: The default program and data directory locations are the same for
IBM MQ 9.0 and later versions. Therefore you do not need to change
the specification of the program and data directories when migrating from
IBM MQ 9.0 to a later version. However, when migrating from
versions before
IBM MQ 9.0, there are differences in the
default locations that you need to consider. For more information, see
Program and data directory locations on
Windows.
The installation programs contain links to further information if you require it during the
installation process. The installation process has the following parts:
- Use the Launchpad to check and install software requirements, specify network information, and
start the IBM MQ installation wizard.
- Use the IBM MQ installation wizard to install the
software, and to start the Prepare IBM MQ Wizard.
- Use the Prepare IBM MQ Wizard to start the IBM MQ service.
Procedure
-
Start the installation process.
In Windows Explorer, navigate to the temporary
folder into which you downloaded the installation image, then double-click setup.exe.
The installation launchpad is started.
-
Start the Launchpad, review, and if necessary, modify the software requirements and network
configuration.
-
Navigate to the IBM MQ software directory, and
double-click the file Setup.exe to start the Launchpad.
-
Click the Software Requirements button to display the
Software Requirements tab.
-
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.
-
Click the Network Configuration button to display the Network
Configuration tab.
-
Click the No radio button.
Note: This scenario assumes that you do not need to configure a domain user ID for IBM MQ. For more information regarding configuring IBM MQ for Windows domain users, click the More
information button.
-
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.
-
Use the IBM MQ installation wizard to install the
software, and to start the Prepare IBM MQ Wizard.
-
In the IBM MQ installation wizard, read the License
Agreement and click the I accept the terms in the license agreement check
box, and then click Next.
-
Click Typical, and then click Next.
-
On the Ready to Install IBM MQ page, review the installation information,
then click Install.
The installation information includes 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 .
-
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.
-
Use the Prepare IBM MQ Wizard to start the IBM MQ service.
-
On the Welcome to the Prepare IBM MQ Wizard page, 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.
-
On the IBM MQ Network Configuration page of the
Prepare IBM MQ Wizard, select No.
-
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.
-
Select Launch IBM MQ Explorer and
choose whether to start Notepad to view the release notes, then click the
Finish button.
IBM MQ Explorer starts.
Results
You have installed IBM MQ, and you have started
IBM MQ Explorer.
What to do next
Now that you have installed the later version of IBM MQ, you are ready to check that the sample queue managers have been successfully migrated and that
you are able to put messages to and get messages from the migrated queues as described in Verifying your IBM MQ 9.3 installation.