Installing an IBM MQ client on HP-UX systems

Before you begin

Before you start the installation procedure, make sure that you have completed the necessary steps outlined in Preparing the system.

About this task

This topic describes the installation of a client, using the swinstall program to select which components you want to install. The components and are listed in Choosing what to install ; you must install at least the Runtime and Client components.

Procedure

  1. Log in as root, or switch to the superuser using the su command.
  2. Make your current directory 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, you can continue the installation.

  4. Type the following command to start the interactive installation procedure: 
    
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 the extension .v11.

    If the files on your DVD are in uppercase with a ";1" suffix, use this name for the depot.

  5. In the resulting menu screen, select MQSERIES.
    1. If you 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.
  6. Optional: To install IBM MQ to a non-default location, select Actions > Change Product Location.

    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.

  7. Select Actions > Install. The log file tells you if there are any problems that need fixing.
  8. Fix any problems, and click OK to install. You are informed when the installation has finished.
  9. If this installation is not the first installation on the system, you must enter the following command: 
    
swconfig -x allow_multiple_versions=true MQSERIES,l= MQ_INSTALLATION_PATH
    where MQ_INSTALLATION_PATH is the path where you have just installed IBM MQ. If you 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 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 Verifying a client installation.