Installing IBM WebSphere MQ server on AIX

You can install IBM® WebSphere® MQ server on an AIX® system.

Before you begin

  • Before you start the installation procedure, make sure that you have completed the necessary steps outlined in Preparing the system.
  • IBM WebSphere MQ can be installed into System Workload Partitions (WPARs) with both shared and private file systems. For installation into private file systems, IBM WebSphere MQ can be installed directly into the System WPAR using the procedure outlined in this topic. For installation into shared file systems, see Installing IBM WebSphere MQ in AIX Workload Partitions. There are some limitations for shared /usr file systems:
    • The dspmqinst and dspmqver commands might report the primary installation incorrectly when compared with the symbolic links in /usr/bin. To synchronize the reporting of the primary installation in a System WPAR and the global environment, run setmqinst with the -i or -x parameter, on the individual zones.
    • You cannot change the primary installation within a WPAR. You must change the primary installation through the global environment which has appropriate write access to /usr/bin.
    Note: During installation to a non-default location, ATTENTION messages that relate to errupdate or trcupdate are produced. These messages are not errors. However, AIX system trace for IBM WebSphere MQ is not supported for installations in a non-default location, and IBM WebSphere MQ trace must be used for problem determination.
  • If you install a copy of IBM WebSphere MQ server for AIX obtained from Passport Advantage®, you need to:
    • Uncompress the tar file, by using the following command:
       uncompress  WS_MQ_V7.5_TRIAL_FOR_AIX_ML.tar.z
    • Extract the installation files from the tar file, by using the following command:
       tar -xvf  WS_MQ_V7.5_TRIAL_FOR_AIX_ML.tar
    • Use the installation tools, installp or smit, to install the IBM WebSphere MQ server for AIX.

About this task

IBM WebSphere MQ is supplied as a set of filesets that are installed using the standard AIX installation tools. The procedure uses the system management interface tool (SMIT), but you can choose to use installp, geninstall or the web-based System Manager. You can select which components you want to install. The components and file sets are listed in Choosing what to install.

This procedure installs IBM WebSphere MQ into the default location of /usr/mqm.

If you want to install IBM WebSphere MQ in any one of the following situations:
  • As the first installation on your system using installp
  • As the first installation on your system, and you are installing the product to a location that is not the default
  • Alongside an existing installation
use the procedure described in Installing IBM WebSphere MQ server silently on AIX.

If you want to carry out a side-by-side installation, alongside an existing installation of IBM WebSphere MQ in the default location, the existing installation must be IBM WebSphere MQ Version 7.0.1.6, or later.

You must install the second version of the product in a location that is not the default, using installp (see Installing IBM WebSphere MQ server silently on AIX).

If you want to carry out a single stage migration, see UNIX, Linux®, and Windows: Single-stage migration to a later version.

Procedure

  1. Log in as root, or switch to the superuser using the su command.
  2. Set your current directory to the location of the installation file. The location might be the mount point of the DVD, a network location, or a local file system directory.
  3. List the software in the SOFTWARE to install field:
    1. Enter .
    2. Press F4
  4. Select the required smit window using the following sequence: 
    Software Installation and Maintenance
	Install and Update Software
		Install and Update from ALL Available Software
  5. Select the filesets to install from the list. Ensure that you include the appropriate message catalog if you require messages in a language different from the language specified by the locale selected on your system. Enter ALL to install all applicable filesets.
  6. View the license agreement:
    1. Change Preview new LICENSE agreements? to yes
    2. Press Enter
  7. Accept the license agreements and install IBM WebSphere MQ:
    1. Change ACCEPT new license agreements? to yes
    2. Change Preview new LICENSE agreements? to no
    3. Press Enter

What to do next

  • If you have chosen this installation to be the primary installation on the system, you must now set it as the primary installation. Enter the following command at the command prompt:
    MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH

    where MQ_INSTALLATION_PATH represents the directory where IBM WebSphere MQ is installed.

    You can have only one primary installation on a system. If there is already a primary installation on the system, you must unset it before you can set another installation as the primary installation. For more information, see Changing the primary installation .

  • You might want to set up the environment to work with this installation. You can use the setmqenv or crtmqenv command to set various environment variables for a particular installation of IBM WebSphere MQ. For more information, see setmqenv and crtmqenv.
  • If you want to confirm that the installation was successful, you can verify your installation. See Verifying an IBM WebSphere MQ server installation, for more information.