installation, installation from client CD, language, national language, compact, compact installation, custom, custom installation, using the Client CD, modifying, modifying the installation, using Add/Remove Programs, Windows, basic method, installing, extended transactional client, installing the extended transactional client, installing an extended transactional client" /> Install the WebSphere MQ client
Home

 

Installing the WebSphere MQ client

To install a WebSphere MQ client, be logged on to Windows as an administrator.

WebSphere MQ checks for any existing WebSphere MQ configuration files (MQS.INI). If it finds any, it automatically migrates configuration information to the Windows Registry. Otherwise, WebSphere MQ automatically puts its configuration information directly into the Windows Registry.

 

Typical client installation

The following instructions assume that you are installing the WebSphere MQ client using WebSphere MQ Client CD 5, which is supplied with WebSphere MQ. If you plan to install a WebSphere MQ client and server on the same machine, see the WebSphere MQ for Windows, V6.0 Quick Beginnings book.

  1. Insert WebSphere MQ Client CD 5 into the CD drive.

    If autorun is enabled, the installation process starts. If it is not, double-click the Setup icon in the root folder on the CD to start the process.

    The Select Setup Language window is displayed.

  2. On the Select Setup Language window, select the national language of your choice from the list, then click OK.

    The WebSphere MQ Client Setup window is displayed.

  3. Click Next to continue.

    If the current version of WebSphere MQ client is already installed, the Program Maintenance panel is displayed with two options: Modify or Remove.

    1. If you select Modify, see Modifying the client installation.

    2. If you select Remove, see Uninstalling WebSphere MQ client using the installation process.

    If the current version of WebSphere MQ client is not installed, the License Agreement panel is displayed.

  4. Read the information and license terms on the panel.

    To change the language that the license agreement is displayed in, click Change Language then select the language you require from the list provided.

    Select the option to accept the license terms, then click Next.

  5. If there was no previous version of this product installed on the machine, the Setup Type panel is displayed.

    Select the type of installation you want, then click Next. Table 4 shows the installation types and the features that are installed with each option.

    1. If you select Custom, go to the procedure Custom client installation.

    2. If you select Typical or Compact, go to step 7.

  6. If there was a previous version of WebSphere MQ installed on the machine, the Type of Installation Process panel is displayed. Select one of the following options, then click Next:

    • Update. Installs the same features as the previous version. Go to the next step.

    • Custom. We can select which features to install.

      If you select this option, a Destination Folders panel for data files is displayed, then the Features panel is displayed. Follow the procedure Custom client installation from step 3 or 4 as appropriate.

  7. The WebSphere MQ Client Setup window displays a summary of the installation you selected.

    To continue, click Install.

  8. Wait until the progress bar is complete.

    When the WebSphere MQ client is successfully installed, the WebSphere MQ Client Setup window displays the following message:

    Installation Wizard Completed Successfully

    Click Finish to close the window.

  9. At this point run the Prepare WebSphere MQ Wizard. This will assist you in migrating any SSL certificates that you may have.

  10. The installation of the WebSphere MQ client is now complete. Note that WebSphere MQ clients are sets of services and do not have to be explicitly run.

  11. You now need to verify that the client was installed successfully (see Verifying the installation).

 

Compact client installation

Follow the steps for a typical client installation, as described in Typical client installation. The only difference is that, at step 5, you select Compact on the Setup Type window. This installs only the Client feature of WebSphere MQ for Windows.

 

Custom client installation

During custom installation, we can choose the destination folders for program files and data files. However, after installation, we cannot change these (except by removing the product, then reinstalling). Therefore, plan and select your destination folders carefully.

  1. Follow steps 1 to 5 of the Typical client installation.

  2. At step 5, select Custom on the Setup Type window.

  3. The Destination Folder panel is displayed.

    To accept the default folder for the program files, select Next.

    To change the folder for the program files, select Change, select the required folder in the resulting dialog box, select OK, then select Next.

  4. The Destination Folders panel is displayed.

    To accept the default folder for the data files, select Next.

    To change the folder for the data files, select Change, select the required folder in the resulting dialog box, select OK, then select Next.

    If you want to install the Client , you require a data files folder. Otherwise, we can ignore this panel (that is, accept the default).

  5. The Features panel is displayed.

  6. To change the installation of a feature:

    1. Click the symbol to the left of the feature name to display a drop-down menu.

    2. Select the required option from:

      • Install this feature

      • Install this feature and all its subfeatures (if any)

      • Do not install this feature (remove if already installed)

      The symbol to the left of the feature name changes to show the current installation option. For more information, click Help to display the Custom Setup Tips page, which explains the icons used in the feature list.

  7. Optionally, to check that there is enough disk space, press the Space bar.

    The Disk Space Requirements panel is displayed. This shows the disk space available and the amount of disk space that your current selections will take. It highlights any volumes that do not have enough disk space.

    To close the panel and return to the Features panel, click OK.

  8. When your selections are complete, click Next.

  9. Follow from step 7 to the final step of the procedure.

 

Modifying the client installation

You modify the installation when WebSphere MQ for Windows client is installed and you want to remove or install some WebSphere MQ client features.

  1. Insert WebSphere MQ Client CD 5 into the CD drive.

  2. If autorun is installed, the installation process starts.

    Otherwise, double-click on the Setup icon in the root folder of the CD to start the installation process.

    The Program Maintenance panel is displayed.

  3. Select Modify, then click Next.

    The Features panel is displayed.

  4. To change the installation of a feature:

    1. Click on the symbol to the left of the feature name to display a drop-down menu.

    2. Select the required option from:

      • Install this feature

      • Install this feature and all its subfeatures (if any)

      • Do not install this feature (remove if already installed).

      The symbol to the left of the feature name changes to show the current installation option.

  5. When your selections are complete, click Next.

  6. The WebSphere MQ Client Setup window displays a summary of the installation you selected.

    To continue, click Modify.

  7. Wait until the progress bar is complete.

    When the WebSphere MQ client is successfully installed, the WebSphere MQ Client Setup window displays the following message:

    Installation Wizard Completed Successfully

    Click Finish to close the window.

 

Modifying the client installation using Add/Remove Programs

  1. From the Windows task bar, select Start-> Settings-> Control Panel.

  2. Select Add/Remove Programs.

  3. Select IBM WebSphere MQ.

  4. Select Change.

    The WebSphere MQ Setup window with the Program Maintenance panel is displayed. Follow the procedure for modifying the installation using the process from step 3 to the end.

 

Installing the extended transactional function

To install the extended transactional function, follow this procedure:

  1. Insert the WebSphere MQ Extended Transactional Clients CD-ROM into the CD-ROM drive.

    If autorun is enabled, the installation process starts. If it is not enabled, double-click the Setup icon in the Windows folder on the CD-ROM to start the installation process.

    The Select Setup Language window opens.

  2. In the list of national languages, click the language that you want to use, and then click OK. Eventually, the Welcome window opens.

  3. Click Next to continue. The License Agreement window opens.

  4. Read the license agreement.

    To change the language in which the license agreement is displayed, click Change Language, select your preferred language from the list provided, and then click OK.

    Select the option to accept the terms of the license agreement, and click Next. The Ready to Install window opens.

  5. Click Install. A window opens asking whether you have purchased sufficient license units to install the extended transactional client. If you have purchased sufficient license units, click Yes. The Installing window opens.

  6. Wait for the progress bar to complete.

    When the installation completes successfully, the WebSphere MQ Extended Transactional Client Setup window displays the following message:

    Installation Wizard Completed Successfully

  7. Click Finish to close the window.



 

Home