Installing the stand-alone IBM MQ Explorer on Linux

On Linux®, you can install the stand-alone IBM® MQ Explorer by using the graphical user interface. Alternatively, you can install with either a silent or a console installation.

Before you begin

Before you install the stand-alone IBM MQ Explorer, review the requirements information in IBM MQ Explorer installation requirements.

If you already have a previous version of IBM MQ Explorer installed, uninstall that version with the supplied uninstaller before installing the new version. For more information, see Uninstalling the stand-alone IBM MQ Explorer on Linux.

If you try to reinstall IBM MQ Explorer and you previously uninstalled it by deleting the files rather than by using the supplied uninstaller, the message IBM MQ Explorer is already installed appears. If this situation occurs, you need to complete some additional steps to return to a clean system before you can reinstall the stand-alone IBM MQ Explorer as described in Uninstalling the stand-alone IBM MQ Explorer on Linux.

Note: In addition to the space used by the installed program, the installer uses space in the /tmp file system. Allow at least 600 MB, which will be freed after the installation is complete.

To use somewhere other than /tmp, export the IATEMPDIR environment variable as shown in the following example:

export IATEMPDIR=/var/tmp

You must export the environment variable before you run the ./Setup.bin command .

In addition, allow 400 MB on a file system of your choosing for the tar.gz installation image and the contents of the image after the file is decompressed.

About this task

After you download the stand-alone IBM MQ Explorer from Fix Central and decompress the files, you can install IBM MQ Explorer in any of the following ways:

By using the installation wizard.
By installing silently, with a response file.
By installing with a console (text-based) installation.

If you require an accessible version of the installer, then use the silent installation mode to install IBM MQ Explorer. A response file is used to configure a silent installation. An example response file, silent_install.resp is provided in the same directory as the IBM MQ Explorer setup program. You can modify this example file as required by using a text editor.

Procedure

Download the Linux version of stand-alone IBM MQ Explorer.

Follow this link to Fix Central, then select the Linux version of the download package.
Create an installation directory on the target system.
Decompress the tar.gz file that you downloaded, for example, 9.3.0.0-IBM-MQ-Explorer-LinuxX64.tar.gz, to this directory.
Install IBM MQ Explorer in one of the following ways:
- To install by using the installation wizard:
  1. Log in as root and navigate to the directory where you decompressed the files.
  2. Run the command ./Setup.bin (as root) and follow the onscreen instructions.
  3. Start IBM MQ Explorer either by using the system menu entry, or by using the MQExplorer executable file in the installation directory.
- To install silently, by using a response file:
  1. Use a text editor to modify the example response file, silent_install.resp, as required. Make your changes in line with the comments in the file.
    Note: Before running a silent install, the LICENSE_ACCEPTED property in the response file must be set to TRUE to indicate that you agree to the terms of the product license. (The license can be found in the license folder of the product .zip file).
  2. Start the silent installation by using the following command:
```
./Setup.bin -f silent_install.resp
```
  The installation then proceeds without any feedback.
- To install by using a console (text-based) installation, launch the installer by using the following command:
```
./Setup.bin -i console
```
Note: If you see the following error message, this might be because you have the DISPLAY environment variable set but do not have a valid X configuration:
```
Unable to load and to prepare the installer in console or silent mode.
```
If you do see this message, unset your DISPLAY environment variable and retry the operation in console mode.

What to do next

[MQ 9.3.0 Jun 2022] After IBM MQ Explorer has been installed, you can run it from the system menu or by using the MQExplorer command. For more information, see Launching IBM MQ Explorer.