Installing IBM MQ server on Solaris

You can install an IBM® MQ server on Solaris 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.
If you install a copy of IBM MQ server for Solaris using Electronic Software Download, obtained from Passport Advantage®, you need to uncompress the tar.gz file, and extract the installation files from the tar file, by using the following command:
```
  tar -xvf   WS_MQ_V8.0_TRIAL_FOR_SOLARIS_ML.tar
```
Important: You must use GNU tar (also known as gtar) to unpack the tar images.
If you are using Solaris zones, you have a choice between installing IBM MQ into the global zone, or installing IBM MQ into a non-global zone.
For details on how to install IBM MQ into Solaris zones, see the following technote: WebSphere® MQ support position regarding Solaris zones. The technote is applicable to IBM WebSphere MQ 7.1 or later with the following changes:
- You do not need the -G option on the pkgadd command as GSKit is now installed as part of the IBM MQ installation.
- If you install IBM MQ into the global zone for use in sparse zones, you must copy the /var/mqm file system into the sparse zone. You must also copy the /etc/opt/mqm/mqinst.ini installation entry into the sparse zone.
- 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 Solaris zone and the global zone, run setmqinst with the -i or -x parameter, on the individual zones.
- You cannot change the primary installation within a non-global zone. You must change the primary installation through the global zone, which has the appropriate write access to /usr/bin.

About this task

This task describes the installation of the IBM MQ for Solaris server, using the pkgadd program. You can choose which components you want to install. The components are listed in Choosing what to install.

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.
Set your current directory to the location of the installation file. The location might be the mount point of the server 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 uniquely identifies 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.
  The crtmqpkg script can use two environment variables which are useful when you are installing from a non-disk media location:
  - CDROOT, the root of the installation media or downloaded installation files.
  - TMPDIR, the output location of the modified installation files.
  No environment variables are required if you are running the image as ./crtmqpkg.
2. Set your current directory to the location specified when the crtmqpkg command completes.
  This directory is a subdirectory of /var/spool, in which the unique set of packages is created. The packages have the suffix value contained within the file name.
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 prompted to choose a location for installation.
- To install to the default location, /opt/mqm, enter y.
- To install to a non-default directory, enter n. Then, enter the required installation path, and confirm your choice.
When the list of components is displayed, enter the numbers of the components that you require, separated by spaces or commas.
When you are installing (adding) an IBM MQ component to an existing installation, choose option yes when you are asked whether to overwrite.
Note: During the IBM MQ base version installation, you can choose to install all components or a subset of the components. When you install a fix pack, only the currently installed components are upgraded. If, at a later stage, you want to add further IBM MQ components that are not already installed, these components can be installed (added) to the IBM MQ base version only. If your current version of IBM MQ is not the base version, you must first uninstall all the fix packs before you add the required components to the existing installation, and then install the required fix packs. Also, when you are adding IBM MQ components to an existing installation, you must choose option yes when you are asked whether to overwrite by the installation process.
If the path chosen in step 6 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.
If you are prompted to choose whether to install certain IBM MQ files as setuid/setgid files, you must enter y.
A message is issued when the 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
```
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. See Verifying a server installation, for more information.