Install an IBM MQ server on Linux Ubuntu using Debian packages

We can install an IBM MQ server on a Linux Ubuntu system, using a Debian installer, in accordance with the system requirements web page.

Before you begin

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

Before you start the installation procedure, make sure that you first complete the necessary steps that are outlined in Preparing the system on Linux.

If we have installed IBM MQ Version 9.0.2, or earlier, on Ubuntu using rpm, you must uninstall all rpm versions of the product before installing the Debian version of the product.

About this task

Install the server by using a Debian installer to select the components that you want to install. The components and package names are listed in IBM MQ Debian components for Linux Ubuntu systems. Attention: Ensure that we download the Ubuntu version of the tar.gz package, before you install the product, as this version contains the deb files you need for the apt tool. We can use various installers. This topic describes the use of the dpkg and apt installers.

dpkg

Install the packages that you need by following instructions in step 3. We can install multiple packages with the same command but take care to place the packages in the correct order as dpkg does not sort them according to dependency.

apt

Install the packages that you need by following instructions in step 4. The apt tool installs dependency packages for the package that you require. The apt management tool orders the dpkg commands.

You must make your files accessible to the apt tool, in order to use it.

To do this, issue the command, chmod -R a+rx DIRNAME, where DIRNAME is the directory into which you unpacked the tar.gz package.

Attention: If we do not make your files accessible to the apt tool, you receive the following errors:

• N: Download is performed unsandboxed as root as file '/sw/9001deb/./InRelease' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
• E: Failed to fetch file:/sw/9001deb/./Packages File not found - /sw/9001deb/./Packages (2: No such file or directory)
• E: Some index files failed to download. They have been ignored, or old ones used instead.

where /sw/9001deb is the directory from which you are installing IBM MQ.

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. Complete this step if you want to use the dpkg command and install packages individually. Issue the dpkg command for each IBM MQ package. For example, issue the following command:

   dpkg -i ibmmq-runtime_9.0.2.0_amd64.deb

   To support the running of a queue manager, you must install at least the ibmmq-runtime and the ibmmq-server components.

   Important: We can specify multiple package files in the same command but unlike rpm, dpkg does not sort the package files into dependency order.You must place the package file names in the following order when you issue your command:
   • ibmmq-runtime
   • ibmmq-jre
   • ibmmq-java
   • ibmmq-server
   • ibmmq-web
   • ibmmq-ftbase
   • ibmmq-ftagent
   • ibmmq-ftservice
   • ibmmq-ftlogger
   • ibmmq-fttools
   • ibmmq-amqp
   • ibmmq-ams
   • ibmmq-xrservice
   • ibmmq-explorer
   • ibmmq-gskit
   • ibmmq-client
   • ibmmq-man
   • ibmmq-msg_language
   • ibmmq-samples
   • ibmmq-sdk
   • ibmmq-sfbridge
   • ibmmq-bcbridge

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

4. Complete this step if you want to use the apt management tool to install the IBM MQ packages that you want along with their dependency packages. apt is a higher-level package management tool that is a front end to dpkg. Important: apt operations, unlike dpkg, are dependency aware, and automatically select and install the required packages. Therefore, the apt management tool orders the dpkg commands appropriately.

   apt is configured with a list of repositories that can include local directories. To add a local, or nfs-mounted, directory that contains the IBM MQ packages:

   1. Create a file with the suffix .list, for example, IBM_MQ.list, in the /etc/apt/sources.list.d directory. This file should contain a deb entry for the location of the directory that contains the IBM MQ packages.For example:

      # Local directory containing IBM MQ packages 
      deb [trusted=yes] file:/var/tmp/mq ./
      

      Note: The inclusion of the [trusted=yes] statement (including the brackets) is optional and suppresses warnings and prompts during subsequent operations.
   2. Run the command apt update to add this directory, and the list of packages the directory contains, to the apt cache. We can now carry out various operations. For example, issuing the command:

      apt install "ibmmq-*" 

      installs the complete product, and issuing the command:

       apt install ibmmq-server 

      selects and installs the server package and all its dependencies.Attention: Do not run the apt install ibmmq-* command in the directory which holds the .deb files, unless you are using quotation characters in the shell.
   If you are using tools such as aptitude or synaptic, the install packages can be found in the misc\non-free category.

   To support the running of a queue manager, you must install at least the ibmmq-runtime and the ibmmq-server components.

   If you are installing a subset of components, you must ensure that any dependencies are first installed, as listed in Table 1. To install and use a package listed in the Package Name column, you must also install the corresponding components that are listed in the Package Dependencies column.

   Table 1. Package component dependencies

   Package Name	Component Function	Package Dependencies
   ibmmq-runtime	Common function for all other components	None
   ibmmq-server	Queue Manager	ibmmq-runtime
   ibmmq-client	C IBM MQ client libraries	ibmmq-runtime
   ibmmq-java	Java and JMS IBM MQ APIs	ibmmq-runtime
   ibmmq-jre	Java Runtime Environment	ibmmq-runtime
   ibmmq-sdk	Header files and libraries for non-Java APIs	ibmmq-runtime
   ibmmq-man	UNIX man pages for IBM MQ	ibmmq-runtime
   ibmmq-samples	IBM MQ application samples	ibmmq-runtime
   ibmmq-msg-cz ibmmq-msg-de ibmmq-msg-es ibmmq-msg-fr ibmmq-msg-hu ibmmq-msg-it ibmmq-msg-ja ibmmq-msg-ko ibmmq-msg-pl ibmmq-msg-pt ibmmq-msg-ru ibmmq-msg-zh-cn ibmmq-msg-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	ibmmq-runtime
   ibmmq-mqexplorer	IBM MQ Explorer. Only on Linux x86-64 systems.	ibmmq-runtime ibmmq-jre
   ibmmq-gskit	IBM Global Security Kit	ibmmq-runtime ibmmq-jre
   ibmmq-web	REST API and IBM MQ Console.	ibmmq-runtime ibmmq-server ibmmq-java ibmmq-jre
   ibmmq-ftbase	Managed File Transfer component	ibmmq-runtime ibmmq-java ibmmq-jre
   ibmmq-ftlogger	Managed File Transfer component	ibmmq-runtime ibmmq-server ibmmq-ftbase ibmmq-java ibmmq-jre
   ibmmq-fttools ibmmq-ftagent	Managed File Transfer components	ibmmq-runtime ibmmq-ftbase ibmmq-java ibmmq-jre
   ibmmq-ftservice	Managed File Transfer component	ibmmq-runtime ibmmq-server ibmmq-ftagent ibmmq-ftbase ibmmq-java ibmmq-jre
   ibmmq-ams	Advanced Message Security component	ibmmq-runtime ibmmq-server
   ibmmq-sfb	Install the IBM MQ Bridge to Salesforce to configure the connections to Salesforce and IBM MQ, then run the command runmqsfb to subscribe to events from Salesforce and publish them to an IBM MQ network. Note: The IBM MQ Bridge to Salesforce is available only on Linux for System x (64 bit).	ibmmq-runtime ibmmq-java ibmmq-jre
   ibmmq-bcb	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 required, we can now set this installation to be 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.

• 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.