Install IBM MQ server on HP-UX

We can install an IBM MQ server on HP-UX either interactively or silently.


Before you begin

  • Before you start the installation procedure, make sure that we have completed the necessary steps outlined in Preparing the system on HP-UX.
  • If you install a copy of IBM MQ server for HP-UX 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_HP-UX_ML.tar
    Important: You must use GNU tar (also known as gtar) to unpack any tar images.


About this task

This task describes the installation of a server, using the swinstall program to select which components you want to install. The components are listed in IBM MQ components for HP-UX. Note: If you are using a screen reader, use the non-interactive installation option Install the IBM MQ server silently on HP-UX, so that we can accept the license without viewing it.

If you are installing IBM MQ from a depot that contains service update packages, read Apply maintenance level updates on IBM MQ on HP-UX before installing the service update packages.


Procedure

  1. Log in as root, or switch to the superuser 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. Accept the license by running the mqlicense script: 
    ./mqlicense.sh

    The license is displayed. If you accept the license, we can continue the installation.

  4. Start the interactive installation procedure by typing the following command, 
    swinstall -s /installation_file
    /installation_file is the absolute path to the installation file. The path must begin with a / and end with the name of the installation file. The installation file has a file name extension of .v11. In the resulting menu screen, select MQSERIES.
    1. If we do not want to install all IBM MQ components, open MQSERIES
      1. Mark the components you want to install. The installer resolves dependencies automatically.
      2. Review the information displayed by the installer.
  5. Optional: To install IBM MQ to a non-default location, select MQSERIES from the lower part of the user interface, then select Actions > Change Product Location. The default installation location is /opt/mqm.

    For each installation, all of the IBM MQ components that you require must be installed in the same location.

    The installation path specified must either be an empty directory, the root of an unused file system, or a path that does not exist. The length of the path is limited to 256 bytes and must not contain spaces.

    Note: Ensure that we do not select Actions > Change Target by accident, they are not the same.
  6. If this installation is not the first installation on the system, select Options > Allow creation of multiple versions
  7. Select Actions > Install. The log file tells you if there are any problems that need fixing.
  8. Fix any problems, then click OK to install.

    The system tells you when the installation has finished.

  9. If this installation is not the first installation on the system, you must enter the following command to configure IBM MQ. Note: MQ_INSTALLATION_PATH is the path where we have just installed IBM MQ and the character defining the path is a lower case L. 
    swconfig -x allow_multiple_versions=true MQSERIES,l=MQ_INSTALLATION_PATH

    If we do not enter this command, the swlist command reports the installation as installed instead of configured. You must not use IBM MQ unless the installation is configured.


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. 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, 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. See Verifying an IBM MQ installation on HP-UX, for more information.