Install IBM MQ server on Linux Ubuntu or Linux on POWER Systems - Little Endian

We can install an IBM MQ server on a Linux Ubuntu system, or Linux on POWER® Systems - Little Endian system, in accordance with the system requirements web page.

Before you begin

We can install IBM MQ on a Linux Ubuntu system by using the RPM installer or by using the Debian installer. For more information about using the Debian installer, see Install IBM MQ on Linux Ubuntu using Debian.

See System Requirements for IBM MQ for details of the supported software levels.

• Before you start the installation procedure, make sure that we have completed the necessary steps outlined in Preparing the system on Linux.
• If you install a copy of IBM MQ server for Linux Ubuntu 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_V9.0_TRIAL_FOR_LINUXUbuntu_ML.tar
  

  Important: You must use GNU tar (also known as gtar) to unpack any tar images.
• Ensure that RPM is installed on your system, as RPM is not installed by default on this platform.

  To determine if the correct RPM package is installed on you system, see Checking the availability of rpm on your Linux Ubuntu machine.

• Once RPM is installed on your system, carry out the following procedure, as root:
  1. Create directory /etc/rpm
  2. Add file etc/rpm/macros, containing the following lines:

     %_dbpath /var/lib/rpm
     %_build_id_links none
     

  Attention: You should only set up a /macros file if you are not already using RPM, as the previous instruction changes the default system-wide RPM database.

Install the server by using the RPM Package Manager installer to select the components to install. The components and package names are listed in IBM MQ components and features.

Procedure

1. Open a shell terminal and set your current directory to the location of the installation packages. The location might be the mount point of the server DVD, a network location, or a local file system directory. You must have root authority to run the following commands. We can do so by adding sudo before the following commands, or by changing to the root user in the shell with the su command.
2. Run the mqlicense.sh script. If you want to view a text-only version of the license, which can be read by a screen reader, type the following message:

   ./mqlicense.sh -text_only
   

   The license is displayed.

   You must accept the license agreement before we can proceed with the installation.

3. If this installation is not the first installation of IBM MQ on the system, you must run the crtmqpkg command to create a unique set of packages to install on the system. For the crtmqpkg command to run on Linux, you must install the pax command and rpmbuild, which is located in the rpm package.
   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. Note: This command creates a full copy of the installation packages in a temporary directory. By default, the temporary directory is located at /var/tmp. You must ensure that the system has enough free space before you run this command. To use a different location, we can set the TMPDIR environment variable before you run the crtmqpkg command. For example:

      TMPDIR=/test ./crtmqpkg
      

   2. Set your current directory to the location specified when the crtmqpkg command completes. This directory is a subdirectory of the /var/tmp/mq_rpms directory, in which the unique set of packages is created. The packages have the suffix value contained within the file name. In the following example, the suffix of "1" ./crtmqpkg 1 means that there is a subdirectory named /var/tmp/mq_rpms/1/i386. The packages are renamed according to the subdirectory, for example, on Linux for System x (64-bit):

      From: MQSeriesRuntime-8.0.0-0.x86_64.rpm
      To: MQSeriesRuntime_1-8.0.0-0.x86_64.rpm
      

4. Install IBM MQ. At a minimum, you must install the MQSeriesRuntime and the MQSeriesServer components.

   If you are installing a subset of components, you must ensure that any dependencies are first installed, as listed in Table 1.

   An additional flag is required when installing on Ubuntu 14.04 on Linux on POWER Systems - Little Endian:
   • --ignorearch: You must include this option to prevent problems with some levels of rpm not recognizing the Linux on POWER Systems - Little Endian architecture
   An additional flag is required when installing on Linux Ubuntu:
   • --force-debian: You must include this option to prevent warning messages from the version of RPM for your platform, which indicates that the RPM packages are not intended to be directly installed using RPM.
   To install the IBM MQ Explorer on Linux Ubuntu (x86-64 only):
   1. Install all the components that you want, except for the IBM MQ Explorer component.
   2. Install the IBM MQ Explorer component with the --nodeps flag. If we do not include the --nodeps flag, the installation fails with a dependency error. The dependency error occurs because the GTK2 packages are not installed by RPM and therefore cannot be found as package dependencies.
   Notes:
   • To install to the default location, /opt/mqm, use the rpm -ivh command to install each component that you require. To install the runtime and server components to the default location on Ubuntu Linux for System x (64-bit), use the following command:

     rpm -ivh --force-debian MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
     

     To install the runtime and server components to the default location on Linux on POWER Systems - Little Endian, use the following command:

     rpm -ivh --ignorearch MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
     

     To install all components to the default location on Linux on POWER Systems - Little Endian use the following command:

     rpm -ivh --ignorearch MQSeries*.rpm
     

   • To install to a nondefault location, use the rpm --prefix option. For each installation, all of the IBM MQ components that you require must be installed in the same location. The installation path specified must be, either an empty directory, the root of an unused file system, or a path that does not exist. Attention: The length of the path is limited to 256 bytes and must not contain spaces. For example, enter the following installation path to install the runtime and server components to the /opt/customLocation directory on Linux on POWER Systems - Little Endian:

     rpm --prefix /opt/customLocation -ivh --ignorearch
     MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
     

   Table 1 lists all available packages on Ubuntu, together with all the associated dependencies.

   To install and use the package listed in the Package Name column, you must also install the components listed in the Package Dependencies column.

   Table 1. Package component dependencies

   Package Name	Component Function	Dependencies
   MQSeriesRuntime	Common function for all other components	None
   MQSeriesServer	Queue Manager	MQSeriesRuntime
   MQSeriesClient	C IBM MQ client libraries	MQSeriesRuntime
   MQSeriesJava	Java and JMS IBM MQ APIs	MQSeriesRuntime
   MQSeriesJRE	Java Runtime Environment	MQSeriesRuntime
   MQSeriesExplorer	IBM MQ Explorer IBM MQ Explorer is only available on Linux for System x (64-bit). There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0, Fix Pack 2 (or later).	MQSeriesRuntime MQSeriesJRE GTK2 version 2.2.4-0 or later, including the GTK2 engines that contain the GTK2 themes Bitstream-vera-fonts
   MQSeriesGSKit	IBM Global Security Kit Note: There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0, Fix Pack 2 (or later).	MQSeriesRuntime MQSeriesJRE
   MQSeriesWeb	REST API and IBM MQ Console.	MQSeriesRuntime MQSeriesServer MQSeriesJava MQSeriesJRE
   MQSeriesSDK	Header files and libraries for non-Java APIs	MQSeriesRuntime
   MQSeriesMan	UNIX man pages for IBM MQ	MQSeriesRuntime
   MQSeriesSamples	IBM MQ application samples	MQSeriesRuntime
   MQSeriesMsg_cz MQSeriesMsg_de MQSeriesMsg_es MQSeriesMsg_fr MQSeriesMsg_hu MQSeriesMsg_it MQSeriesMsg_ja MQSeriesMsg_ko MQSeriesMsg_pl MQSeriesMsg_pt MQSeriesMsg_ru MQSeriesMsg_Zh_CN MQSeriesMsg_Zh_TW	Additional language message catalog files. English message catalog files are installed by default. For more information about these message catalogs, see Displaying messages in your national language on Linux	MQSeriesRuntime
   MQSeriesFTBase	Managed File Transfer component	MQSeriesRuntime MQSeriesJava MQSeriesJRE
   MQSeriesFTLogger	Managed File Transfer component	MQSeriesRuntime MQSeriesServer MQSeriesFTBase MQSeriesJava MQSeriesJRE
   MQSeriesFTTools MQSeriesFTAgent	Managed File Transfer components	MQSeriesRuntime MQSeriesFTBase MQSeriesJava MQSeriesJRE
   MQSeriesFTService	Managed File Transfer component	MQSeriesRuntime MQSeriesServer MQSeriesFTAgent MQSeriesFTBase MQSeriesJava MQSeriesJRE
   MQSeriesAMS	Advanced Message Security component Note: There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0, Fix Pack 2 (or later).	MQSeriesRuntime MQSeriesServer
   MQSeriesSFBridge	Install the IBM MQ Bridge to Salesforce to subscribe to Salesforce push topics and platform events. From IBM MQ Version 9.0.4 we can also use the bridge to create event messages for Salesforce platform events. Note: The IBM MQ Bridge to Salesforce is available only on Linux for System x (64 bit).	ibmmq-runtime ibmmq-java ibmmq-jre
   MQSeriesBCBridge	Install the IBM MQ Bridge to blockchain to send queries and updates to, and receive responses from your blockchain network. Note: The IBM MQ Bridge to blockchain is available only on Linux for System x (64 bit).	ibmmq-runtime ibmmq-java ibmmq-jre

Results

You have installed the packages you require.

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 Linux, for more information.