Installing IBM WebSphere MQ

Follow these instructions to obtain and install IBM® WebSphere® MQ and configure IBM WebSphere MQ Telemetry on Windows or Linux®.

Before you begin

For the operating systems that are supported by the MQTT service running on IBM WebSphere MQ, see IBM WebSphere MQ Telemetry system requirements.

Get a copy of the IBM WebSphere MQ installation materials and a license in one of the following ways:
  1. Ask your IBM WebSphere MQ administrator for the installation materials, and to confirm you can accept the license agreement.
  2. Get a 90-day evaluation copy of IBM WebSphere MQ. See Evaluate: IBM WebSphere MQ.
  3. Buy IBM WebSphere MQ. See IBM WebSphere MQ product page.

About this task

Install IBM WebSphere MQ as root on Linux, and as an administrator on Windows. At install time, select the additional options Telemetry Service and Telemetry Clients to install the IBM WebSphere MQ Telemetry component. Create a user ID to administer IBM WebSphere MQ, and check that the guest user ID is defined. The guest user ID is used in the sample MQTT service configuration to authorize MQTT access to IBM WebSphere MQ.

After installing IBM WebSphere MQ, start the MQTT service by doing the steps in Configuring the MQTT service from the command line or Configuring the MQTT service with IBM WebSphere MQ Explorer.

Procedure

  1. Log on as root on Linux, or as an administrator on Windows.
  2. Install IBM WebSphere MQ.

    Follow the instructions in Installing WebSphere MQ server on Linux or Installing WebSphere MQ server on Windows. Select Telemetry Service and Telemetry Clients to install the IBM WebSphere MQ Telemetry component.

    On Linux, take note of the instruction in the What to do next section to make your installation primary. Even if this installation is the only IBM WebSphere MQ installation on your workstation, make it primary. See Single installation of WebSphere MQ Version 7.1, or later, configured as the primary installation.

    To follow the sample configuration instructions exactly, you must make the installation primary.

    Multiple installations: If you want to work with a non-primary installation, run the setmqenv command. It sets up the IBM WebSphere MQ environment in a command window on your workstation. See Multiple installations.
    Assuming you accepted the default installation location offered by the installation program, IBM WebSphere MQ is installed in the following directories:
    Linux 64-bit
    /opt/mqm
    Windows 32-bit
    C:\Program Files\IBM\WebSphere MQ
    Windows 64-bit
    C:\Program Files (x86)\IBM\WebSphere MQ
    The installation directory is shown as MQ_INSTALLATION_PATH
  3. Optional: Add the user you are going to administer IBM WebSphere MQ with to the mqm group on this workstation.

    This step is optional on Windows because you can administer IBM WebSphere MQ as a Windows administrator. See Authority to administer WebSphere MQ on UNIX and Windows systems.

    If your Windows workstation is a member of a domain, see Windows 2000 domain with non-default, or Windows 2003 and Windows Server 2008 domain with default, security permissions.

    On Linux, the installation program creates a user mqm, as a member of the group mqm. Give this user a password, or create another user with mqm as its primary group.

  4. Optional: Sign on with the user that you made a member of the mqm group.

    This step is optional on Windows because you can administer IBM WebSphere MQ as a Windows administrator.

  5. Check that the guest user ID is defined on your workstation.

    The guest user ID is guest on Windows and nobody on Linux. The guest user ID does not require any operating system permissions or rights.

Results

You installed IBM WebSphere MQ on your workstation as the primary IBM WebSphere MQ installation and created the group mqm. The installation gives permission to administer IBM WebSphere MQ to members of the mqm group. Members of the administrators group on Windows also have authority to administer IBM WebSphere MQ.

What to do next

  1. Configure the MQTT service from the command line or IBM WebSphere MQ Explorer; see Configuring the MQTT service with IBM WebSphere MQ Explorer or Configuring the MQTT service from the command line.
  2. Test your Android, iOS, WebSockets, Java, and C MQTT clients.
  3. When you finish testing, remove the queue manager and MQTT service by running the command MQ_INSTALLATION_PATH\mqxr\samples\CleanupMQM.bat on Windows and MQ_INSTALLATION_PATH/mqxr/samples/CleanupMQM.sh on Linux.