Getting Started with Websphere MQ

The Websphere MQ Plugin

  • Overview

    The Websphere MQ (WMQ) plugin provides extended functionality for the management of WMQ on distributed platforms and the Mainframe (zOS). In general it enables users to install and uninstall WMQ, WMQ Fixpacks, WMQ APARS. It further allows the creation of WMQ queue managers in highly available configurations (including Multi-instance queue managers) and the creation, update and removal of MQ Objects that exist within a queue manager. The WMQ Plugin is a set of pre-written orchestration tasks that perform the aforementioned actions within the existing RapidDeploy framework that already delivers secure, role-based access and audited interactions with remote targets.

  • Supported versions and platforms
    Operating Systems Linux (All flavours) 
    If Client or ClnChlTab mode is being used, then it is also possible to deploy configuration only to various other target platforms via client connectivity. This includes: 
    WMQ Version WMQ 6.x 
    WMQ 7  
    WMQ 7.1 
    WMQ 7.5 
    WMQ 8.0 
    JDK JDK 1.6 is required for deployments. The Java JDK can be managed from the RapidDeploy framework if desired
    Browsers IE 8+, Firefox 5+, Google Chrome. Minimum advised screen resolution is 1024 x 768
    Other Root access (or sudo to root) to target unix servers (as MQ requires installations to be performed as root) 
    A file-system or directory with access to a minimum of 512Mb free disk space. is required on each target 
    This space requirement may increase substantially when deploying many release versions or to many WMQ instances.
  • Installing Websphere MQ

    MQ can be installed by creating a project for this purpose (refer to general documentation for the creation of midvision projects).

    • As you progress through the Create Project wizard, note the Package Search String which will be important when you create the Binary Package used to install Websphere MQ.
    • Your project will require the WmqBinaryInstallTask task (see below for alternative tasks)in the Orchestration tab. If you have no MQ installed on your target you need to ensure you uncheck the Delete Existing Orchestration

    Once you have created the project perform the following tasks.

    • Define the target server (see create server documentation for creating this object).
    • Create the deployment package

      Deployment Packages Detailed instructions on how to package the IBM Binaries

    • Deploy the binary file

      Once the project has been created and a deployment package exists for the platform being deployed to a deployment job can be requested.

      • Navigate to Jobs > New Job Plan
      • Select the box marked 'Empty' and choose the WMQ_BINARY project
      • Select the target
      • Select the version (package) to deploy
      • Click the Run button

Installing IBM MQ on Windows server step by step tutorial

  1. Download binaries from Software Access Catalog Downloads to the machine where your RapidDeploy instance is running.
  2. Create new project in RapidDeploy for example WMQ_BINARY_INSTALL
  3. When project is created go to Orchestration tab and add MqBinaryInstallTask to your orchestrationOrchestration tab
  4. Prepare the deployment package.
    • Go to the place when you have RapidDeploy project (see Project root directory in SCM Repository tab)
    • create new windows folder inside project directory and then create folder where you will have extracted IBM MQ binaries (for example wmq75)Project root directory
    • create new listfile.txt file under windows directory Windows directory
    • under wmq75 you have IBM MQ binaries MQ binaries
    • For Windows the listfile contains the Installer command along with any required parameters (e.g. response files), this is how it looks like in this example:
                      wmq75\MSI\IBM WebSphere MQ.msi responseFile=wmq75\Response.ini 
    • add Agreement to license and the path where you want to install IBM MQ to your Response.ini file
    • when it is ready - go to your project in RapidDeploy and create new Deployment Package from Packages tab (use Create Package Button)
  5. Create new Environment installation for the project you created and remote server when you want to install IBM MQ

    Note that you need to specify the path to listfile you created in previous step by adding new property to Environment Installation

  6. Now the project and environment is created so everything is ready to perform the installation. In order to do that go to the Job, select the project and environment and start the job.