Install IBM MQ server on Solaris

We 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 on Solaris.
• If you install a copy of IBM MQ server for Solaris by using Electronic Software Download, obtained from Passport Advantage, you need to decompress 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, we have a choice between installing IBM MQ into the global zone, or installing IBM MQ into a non-global zone. For more information 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 Version 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.
  • We 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.

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

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

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 server DVD, a network location, or a local file system directory.
3. 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 we do not accept the license, we cannot continue the installation process.
4. If this installation is not the first installation on the system, 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 that 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.
5. 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 that is chosen in the previous step.
6. When prompted, 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.
7. When the list of components is displayed, enter the numbers of the components that you require, separated by spaces or commas. If 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, we 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.
8. If the path chosen in step 6 does not exist, and you are asked if you want to create it, enter y to proceed.
9. 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.
10. When a message informing you that the installation is complete appears, enter q to exit the pkgadd program.

What to do next

• If we have chosen this installation to be the primary installation on the system, you must now set it as the primary installation by entering the following command at the command line:

   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 Solaris.