Installing IBM WebSphere MQ server on Linux Ubuntu

You can install a IBM® WebSphere® MQ server on a Linux® Ubuntu system.

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. You 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 you can proceed with the installation.

3. If this installation is not the first installation of IBM WebSphere MQ version 7.5 on the system, you must run the crtmqpkg command to create a unique set of packages to install on the system. To run the crtmqpkg command to run on Linux, you must install the pax command and rpmbuild, which is located in the rpm-build package.
   Note: If you want to install IBM WebSphere MQ in a non-default installation location, apply the code fix provided in the technote, Installing WebSphere MQ on the Linux Ubuntu Distribution. Without this update, the crtmqpkg command will abort without creating the rebuilt RPM packages.
   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, you 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:

      From: MQSeriesRuntime-7.5.0-0.i386.rpm
      To: MQSeriesRuntime_1-7.5.0-0.i386.rpm

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

   Two additional flags are required over the RPM based distribution installations:

   • --nodeps: You must use this option as the RPM database on Ubuntu is empty or sparsely populated, and the operating system package dependencies requested by the IBM WebSphere MQ packages are not listed within the RPM package database.
     Important: This option disables the safety checks contained within the IBM WebSphere MQ RPM packages to ensure that all WebSphere MQ packages contain their necessary prerequisite packages. If you are not installing all the components, you must ensure that appropriate sets are installed, as listed in Table 1.
   • --force-debian: You must use this option to prevent warning messages from Ubuntu's version of RPM, which indicate that the RPM packages are not intended to be directly installed using RPM on Ubuntu.

     As dependency checking is disabled during the Ubuntu IBM WebSphere MQ installation, install the MQSeriesRuntime package before any other package as all other packages depend on the MQSeriesRuntime package.

     For example:

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

     You can now choose other components to install, such as MQSeriesServer, MQSeriesJava, and MQSeriesJRE. These components provide your system with queue manager functionality, the IBM WebSphere MQ classes for Java and JMS APIs for using with Java applications, and a JRE to run the applications with. Use the following command:

     rpm -ivh --nodeps --force-debian MQSeriesServer-*.rpm MQSeriesJRE-*.rpm MQSeriesJava-*.rpm

     describes the package component 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	Package Dependencies
     MQSeriesRuntime	Common function for all other components	None
     MQSeriesServer	Queue Manager	MQSeriesRuntime
     MQSeriesClient	C WebSphere MQ client libraries	MQSeriesRuntime
     MQSeriesJava	Java and JMS WebSphere MQ APIs	MQSeriesRuntime
     MQSeriesJRE	Java Runtime Environment	MQSeriesRuntime
     MQSeriesExplorer	WebSphere MQ Explorer Note: There is no IBM support for this component on Ubuntu	MQSeriesRuntime MQSeriesJRE
     MQSeriesGSKit	IBM Global Security Kit Note: There is no IBM support for this component on Ubuntu	MQSeriesRuntime MQSeriesJRE
     MQSeriesSDK	Header files and libraries for non-Java APIs	MQSeriesRuntime
     MQSeriesMan	UNIX man pages for WebSphere MQ	MQSeriesRuntime
     MQSeriesSamples	WebSphere MQ application samples	MQSeriesRuntime
     MQSeriesMsg_cs 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	Language specific message catalog files	MQSeriesRuntime
     MQSeriesXRService	(64-bit Linux only) Telemetry queue manager component	MQSeriesRuntime MQSeriesJRE MQSeriesServer MQSeriesRuntime
     MQSeriesXRClient	(64-bit Linux only) Telemetry client APIs	MQSeriesRuntime
     MQSeriesFTBase	MQ Managed File Transfer component	MQSeriesRuntime MQSeriesJava MQSeriesJRE
     MQSeriesFTLogger	MQ Managed File Transfer component	MQSeriesRuntime MQSeriesServer MQSeriesFTBase MQSeriesJava MQSeriesJRE
     MQSeriesFTTools MQSeriesFTAgent	MQ Managed File Transfer components	MQSeriesRuntime MQSeriesFTBase MQSeriesJava MQSeriesJRE
     MQSeriesFTService	MQ 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	MQSeriesRuntime MQSeriesServer