Installing an IBM MQ client on Solaris

You can interactively install the IBM® MQ client for Solaris using pkgadd.

Before you begin

Before you start the installation procedure, make sure that you have completed the necessary steps outlined in Preparing the system on Solaris.
This procedure is for the installation of a standard IBM MQ client using the pkgadd program. If you are installing an IBM MQ client on a system that is already running an IBM MQ server, are therefore using a server DVD to install the client, follow the steps in Installing IBM MQ server on Solaris, and select the appropriate client components in step 7.

About this task

This task describes the installation of the IBM MQ for Solaris client, using the pkgadd program. You can choose which components you want to install. The components (or file sets) are listed in IBM MQ components for Solaris systems; you must install at least the Client component.

Note: If you are installing on the Solaris 11 operating system, ensure that the IPS package (package/svr4) that supports pkgadd and equivalent utilities is installed.

Procedure

Log in as root, or switch to the superuser using the su command.
Make your current directory the location of the installation file. The location might be the mount point of a DVD, a network location, or a local file system directory.
Run the mqlicense.sh script to accept the license:
```
./mqlicense.sh
```
If you want to view a text-only version of the license, which can be read by a screen-reader, type:
```
./mqlicense.sh -text_only
```
The license is displayed. Follow the instructions to accept the license. If you accept the license, the installation continues. If you do not accept the license, you cannot continue the installation process.
If this installation is not the first installation on the system, you must run crtmqpkg to create a unique set of packages to install on the system:
1. Enter the following command:
```
./crtmqpkg suffix
```
  where suffix is a name of your choosing, that will uniquely identify the installation packages on the system. suffix is not the same as an installation name, although the names can be identical. suffix is limited to 16 characters in the ranges A-Z, a-z, and 0-9.
2. Set your current directory to the location specified when the crtmqpkg command completes.
  This directory is a sub-directory of /var/spool, in which the unique set of packages is created. The packages have the suffix value contained within the filename.
Start the installation process:
- If the installation is the first installation on the system, enter the following command to start the installation process:
```
pkgadd -d.
```
  where " . " means use the current directory.
- If the installation is not the first installation on the system, enter the following command to start the installation process:
```
pkgadd mqm-suffix
```
  where suffix is the suffix chosen in the previous step.
You are presented with a list of the packages that are available. Enter the number of the mqm package.
You are prompted to choose a location for installation.
- To install to the default location, enter y.
- To install to a non-default directory, enter n. Then enter the required installation path, and confirm your choice.
You receive a number of messages, after which a list of components is displayed. Enter the numbers of the components that you require separated by spaces or commas.
If the path chosen in step 7 does not exist, you are asked if you want to create it. You must enter y to proceed.
Answer any questions appropriately for your system.
A message tells you when installation is complete. Enter q to exit the pkgadd program.

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
```
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.
For instructions on how to verify your installation, see Testing communication between a client and a server on Solaris.