Installing an IBM MQ server on Linux Ubuntu using Debian packages

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

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 you 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-get tool.

You can use various installers. This topic describes the use of the apt-get and dpkg installers.

apt-get

You can use apt-get to install packages, and you do not need to install any dependent packages. apt-get installs dependency packages for the package that you require.

You must make your files accessible to apt-get, 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 you do not make your files accessible to apt-get, you receive the following errors:

• N: Download is performed unsandboxed as root as file '/sw/9101deb/./InRelease' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
• E: Failed to fetch file:/sw/9101deb/./Packages File not found - /sw/9101deb/./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/9101deb is the directory from which you are installing IBM MQ.

dpkg

You can use dpkg to install individual packages, but you must ensure you install any dependencies as dpkg does not install any dependent packages for the package you require. Refer to the Table 1 table for information about the dependencies of each package.

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

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-gskit
ibmmq-client	C IBM MQ client libraries	ibmmq-runtime ibmmq-gskit
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-cs 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-gskit	IBM Global Security Kit	ibmmq-runtime
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-amqp	Advanced Message Queuing Protocol component	ibmmq-runtime
ibmmq-xrservice	Telemetry Service component Note: The telemetry service is only available on Linux for x86-64 (64 bit) and Linux for IBM Z.	ibmmq-runtime
ibmmq-ams	Advanced Message Security component	ibmmq-runtime ibmmq-server
ibmmq-sfbridge 1	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 x86-64 (64 bit).	ibmmq-runtime ibmmq-java ibmmq-jre
ibmmq-bcbridge 2 3	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 x86-64 (64 bit).	ibmmq-runtime ibmmq-java ibmmq-jre

Notes:

1. The IBM MQ Bridge to Salesforce is deprecated across all releases from November 22 2022 (see US Announcement letter 222-341).
2. The IBM MQ Bridge to blockchain is deprecated across all releases from November 22 2022 (see US Announcement letter 222-341). Blockchain connectivity can be achieved with IBM App Connect or through App Connect capabilities available with IBM Cloud Pak® for Integration.
3. For Continuous Delivery, the IBM MQ Bridge to blockchain is removed from the product at IBM MQ 9.3.2.
4. From IBM MQ 9.3.0, IBM MQ Explorer has been removed from the IBM MQ install package. It remains available as a separate download. For more information, see Installing and uninstalling IBM MQ Explorer as a stand-alone application on Linux and Windows.

1. Open a shell terminal. Log in as root, or with sufficient authority to run the following commands.

   You can do this by adding sudo before the commands, or by changing to the root user in the shell with the su command. For more information, see Exploring the differences between sudo and su commands in Linux.

2. Set your current directory to the location of the installation packages.

   The location might be a network location, or a local file system directory. See Where to find downloadable installation images.

3. From IBM MQ 9.2.0, you have the option of accepting the license before or after installing the product. To accept the license before installing, run the mqlicense.sh script:

   ./mqlicense.sh

   The license agreement is displayed in a language appropriate to your environment and you are prompted to accept or decline the terms of the license.

   If possible, mqlicense.sh opens an X-window to display the license.

   If you need the license to be presented as text in the current shell, which can be read by a screen reader, type the following command:

   ./mqlicense.sh -text_only 

   See Accepting the license on IBM MQ for Linux for more information about license acceptance.
4. Choose how to install the IBM MQ packages:
   Either use the apt management tool to install the IBM MQ packages that you want, or use the dpkg command to install the IBM MQ packages that you want along with their dependency packages.
   • To use the apt-get management tool to install the IBM MQ packages that you want along with their dependency 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 ./
        

        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-get update to add this directory, and the list of packages the directory contains, to the apt cache.

        Refer to the Attention note in apt-get for possible errors you might receive.

        You can now use apt to install IBM MQ. For example, you can install the complete product by issuing the following command:

        apt-get install "ibmmq-*" 

        You can install the server package and all its dependencies by issuing the following command:

         apt-get install ibmmq-server 

        Attention: Do not run the apt-get 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 use the dpkg command to install the IBM MQ packages that you want, issue the dpkg command for each IBM MQ package that you want to install. For example, issue the following command to install the run time package:

     dpkg -i ibmmq-runtime_9.2.0.0_amd64.deb

     Important: Although dpkg permits multiple package files in the same command, this will not work as expected because of IBM MQ inter-package dependencies. You must install the packages individually in the order shown below. You may find that using apt-get is a better option.

     • ibmmq-runtime
     • ibmmq-jre
     • ibmmq-java
     • ibmmq-gskit
     • ibmmq-server
     • ibmmq-web
     • ibmmq-ftbase
     • ibmmq-ftagent
     • ibmmq-ftservice
     • ibmmq-ftlogger
     • ibmmq-fttools
     • ibmmq-amqp
     • ibmmq-ams
     • ibmmq-xrservice
     • ibmmq-client
     • ibmmq-man
     • ibmmq-msg_language
     • ibmmq-samples
     • ibmmq-sdk
     • ibmmq-sfbridge ¹
     • ibmmq-bcbridge ^{2 3}