Install IBM MQ server on AIX

We can install an IBM MQ server on AIX either interactively or silently.


Before you begin

  • Before you start the installation procedure, make sure that you complete the necessary steps that are outlined in Preparing the system on AIX.
  • IBM MQ can be installed into System Workload Partitions (WPARs) with both shared and private file systems. For installation into private file systems, IBM MQ can be installed directly into the System WPAR by using the procedure that is outlined in this topic. 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.
    • We 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 MQ is not supported for installations in a non-default location, and IBM MQ trace must be used for problem determination.
  • If you install a copy of IBM MQ server for AIX by using Electronic Software Download, obtained from Passport Advantage, you need to:

    • Decompress the tar file, by using the following command: 
        decompress   WS_MQ_V9.0_TRIAL_FOR_AIX_ML.tar.Z
    • Extract the installation files from the tar file, by using the following command: 
        tar -xvf   WS_MQ_V9.0_TRIAL_FOR_AIX_ML.tar
    • Use the installation tools installp or smit to install the IBM MQ server for AIX.
Tip: If you find that the Function keys do not work in SMIT, try pressing Esc and the Function key number to emulate the required Function key.


About this task

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

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

If you want to install IBM MQ in any one of the following situations:

  • As the first installation on your system by using installp
  • As the first installation on your system, and you are installing the product to a location that is not the default location
  • Alongside an existing installation
Use the procedure that is described in Install the IBM MQ server silently on AIX.

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

You must install the second version of the product in a location that is not the default. To create the non-default installation location you must use the mkusil command, which is available only from the command line.

We can then use installp (see Install the IBM MQ server silently on AIX), or SMIT if you select the Relocatable Software Installation menu item.

If you want to carry out a single stage migration, refer to Single-stage migration from Version 7.0.1 or later to the latest version on UNIX, Linux , and Windows.


Procedure

  1. Log in as root, or switch to the superuser by 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. Select the required smit window by using the following sequence: 
    Software Installation and Maintenance
Install and Update Software
Install and Update from ALL Available Software
  4. Specify the input directory in the INPUT device / directory for software field.
    1. Enter a period character .
    2. Press the Enter key
  5. List the software in the SOFTWARE to install field:
    1. Enter .
    2. Press F4
  6. Select the filesets to install from the list. If you require messages in a language different from the language that is specified by the locale that is selected on your system, ensure that you include the appropriate message catalog. Enter ALL to install all applicable filesets.
  7. View the license agreement:
    1. Change Preview new LICENSE agreements? to yes
    2. Press Enter
  8. Accept the license agreements and install IBM 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 chose 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 MQ is installed.

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

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