Installing IBM MQ server on AIX

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


Before starting

  • Before starting the installation procedure, complete the necessary steps 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 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. We 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 we install a copy of IBM MQ server for AIX by using Electronic Software Download, obtained from Passport Advantage, we need to:

    • Decompress the tar file:

        decompress WS_MQ_V9.0_TRIAL_FOR_AIX_ML.tar.Z
    • Extract the installation files from the tar file:

        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 we 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 we want to install. The components and file sets are listed in IBM MQ components for AIX systems.

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

See Installing the IBM MQ server silently on AIX to install IBM MQ in any one of the following situations:

  • As the first installation on the system by using installp
  • As the first installation on the system, and we are installing the product to a location that is not the default location
  • Alongside an existing installation

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.

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

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

To carry out a single stage migration, refer to Migrating on UNIX and Linux : single-stage.


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 the system, ensure that we 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, we 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, we must unset it before we can set another installation as the primary installation. For more information, see Change the primary installation.

  • We 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.

  • To confirm that the installation was successful, we can verify your installation. For more information, see Verify an IBM MQ installation on AIX.

  • Installing the IBM MQ server silently on AIX
    We can carry out a non-interactive installation of the IBM MQ server from the command line using the AIX installp command. A non-interactive installation is also known as a silent, or unattended installation.

Parent topic: Install and uninstall IBM MQ on AIX


Related concepts


Related tasks


Related information