Installing IBM WebSphere MQ server on Linux Ubuntu
You can install a IBM® WebSphere® MQ server on a Linux® Ubuntu system.
Before you begin
- Before you start the installation procedure, make sure that you have completed the necessary steps outlined in Preparing the system.
- Ensure that RPM is installed on your system, as the installation
procedure uses the same RPM packages used by the other RPM based distributions.
Technologies that convert these RPM packages into other forms, such
as alien to convert RPMs to Debian packages, are not compatible with
the IBM WebSphere MQ RPM
packages and must not be used.
IBM WebSphere MQ for Linux is installed by using RPM, which is not installed by default on Ubuntu. To determine if RPM is installed on you system, use the dpkg command. For example:
dpkg -l rpmIf the response from this command is of the form:
Then RPM is already installed on your system and no further action is required.
ii rpm 220.127.116.11-1ubuntu0.1 package manager for RPMIf the dpkg command returns output of the form:
$ dpkg -l rpm No packages found matching rpmThen you must install the RPM package before you install IBM WebSphere MQ. For example:
If this command does not complete successfully, consult your Ubuntu administrator for instructions specific to your system to install the RPM package.
sudo apt-get install rpm
About this task
- 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.
- Run the
mqlicense.shscript.If you want to view a text-only version of the license, which can be read by a screen reader, type the following message:
The license is displayed.
You must accept the license agreement before you can proceed with the installation.
- 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.
- Enter the following command:
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.
./crtmqpkg suffixNote: 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:
- 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 1means 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
- Enter the following command:
- 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-*.rpmYou 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:
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.
rpm -ivh --nodeps --force-debian MQSeriesServer-*.rpm MQSeriesJRE-*.rpm MQSeriesJava-*.rpm
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 MQSeriesExplorerWebSphere MQ ExplorerNote: There is no IBM support for this component on Ubuntu MQSeriesRuntime MQSeriesJRE MQSeriesGSKitIBM Global Security KitNote: 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
Language specific message catalog files MQSeriesRuntime MQSeriesXRService
(64-bit Linux only)
Telemetry queue manager component
(64-bit Linux only)
Telemetry client APIs
MQSeriesRuntime MQSeriesFTBase MQ Managed File Transfer component
MQSeriesFTLogger MQ Managed File Transfer component
MQ Managed File Transfer components
MQSeriesFTService MQ Managed File Transfer component
MQSeriesAMSAdvanced Message Security componentNote: There is no IBM support for this component on Ubuntu
- --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.
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_PATHrepresents the directory where IBM WebSphere MQ is installed.
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 WebSphere MQ. For more information, see setmqenv and crtmqenv.
- If you want to confirm that the installation was successful, you can verify your installation. See Verifying an IBM WebSphere MQ server installation, for more information.