Installing IBM MQ server on AIX

You 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.
- 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 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 a downloadable installation image, obtained from Passport Advantage, you need to:
1. Decompress the tar file, by using the following command:
```
  uncompress IBM_MQ_9.3.0_AIX.tar.Z
```
2. Extract the installation files from the tar file, by using the following command:
```
  tar -xvf IBM_MQ_9.3.0_AIX.tar
```
3. 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 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 IBM MQ components for AIX systems.

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

Use the procedure that is described in Installing the IBM MQ server silently on AIX 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

If you want to carry out a side-by-side installation, alongside an existing installation of IBM MQ in the default location, 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.

You can then use installp (see Installing 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 Migrating on AIX and Linux: single-stage.

Procedure

Log in as root, or with sufficient authority to run the following commands.

You can do this by adding sudo before the commands, or by changing to the root user in the shell with the su command. For more information, see Exploring the differences between sudo and su commands in Linux®. This information also applies to UNIX systems in general.
Set your current directory to the location of the installation packages.

The location might be a network location, or a local file system directory. See Where to find downloadable installation images.

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

Specify the input directory in the INPUT device / directory for software field.
1. Enter a period character .
2. Press the Enter key
List the software in the SOFTWARE to install field:
1. Enter .
2. Press F4
Select the file sets 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.
View the license agreement:
1. Change Preview new LICENSE agreements? to yes
2. Press Enter
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.

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 MQ. For more information, see setmqenv and crtmqenv.
If you want to confirm that the installation was successful, you can verify your installation. For more information, see Verifying an IBM MQ installation on AIX.