Sun ONE logo      Previous      Next     
JMS Queue Simple Sample Application



Chapter 1   Installing IBM TM WebSphere Messaging Queue (MQ)


This document describes how to install IBM TM WebSphere Messaging Queue (MQ) (formerly MQSeries) V 5.3 on Solaris and Windows 2000.

This document contains the following sections:



Downloading WebSphere MQ

For the purpose of testing the JMS sample applications with WebSphere MQ, you need to have WebSphere MQ product installed for your platform. If you don't already have a copy of the product, you can download a Beta/Trial copy of WebSphere MQ from IBM web site. It is suggested that you download the WebSphere MQ v5.3, since this version has JMS support integrated into the product.

It is also suggested that you download the document "WebSphere MQ for Solaris Quick Beginnings" if you work on Solaris or "WebSphere MQ for Windows Quick Beginnings" if you work on Windows 2000. This document contains intructions of how to install WebSphere MQ and verify the installation.



Installing WebSphere MQ on Solaris



The following instructions are basic steps to install WebSphere MQ on Solaris. For detailed instructions, please refer to the document "WebSphere MQ for Solaris V5.3 Quick Beginnings".

  1. Login as root.

  2. Create a new unix group named mqm and create a new unix user named mqm who is part of this group. In addition, make the unix user who install the Sun ONE application server a member of the mqm group.

  3. You must update some of the default system settings in order for WebSphere MQ to function correctly.

    To do this, make a backup copy of the /etc/system file, then edit the /etc/system file to add/modify the following lines:

    set shmsys:shminfo_shmmax=536870912

    set shmsys:shminfo_shmmin=11

    set shmsys:shminfo_shmmni=1024

    set shmsys:shminfo_shmseg=1024

    set semsys:seminfo_semaem=16384

    set semsys:seminfo_semmni=1024

    set semsys:seminfo_semmap=1026

    set semsys:seminfo_semmsl=100

    set semsys:seminfo_semmns=16384

    set semsys:seminfo_semopm=100

    set semsys:seminfo_semvmx=32767

    set semsys:seminfo_semmnu=2048

    set semsys:seminfo_semume=256

    set msgsys:msginfo_msgmap=1026

    set msgsys:msginfo_msgmax=4096

    set msgsys:msginfo_msgmnb =65535

    set rlim_fd_cur=1024

  4. Reboot the machine for the changes to take effect.

  5. Unzip and untar the WebSphere MQ installation package.

  6. Go to the directory where you untarred the package.

  7. To accept the license, run the following script:

    ./mqlicense.sh

  8. To start the installation process, enter the following command:

    % pkgadd -d .

  9. By default, WebSphere MQ will be installed in the /opt/mqm and /var/mqm directories.

  10. When asked which packages should be installed, select all.

  11. If you haven't mounted a filesystem at /var/mqm, the installer will complain and ask if you want to continue. As long as you have sufficient disk space, you may safely continue with the installation.

  12. When asked which options should be installed, select WebSphere MQ Server, Man pages, WebSphere MQ Client libraries.

  13. It is not necessary to install the DCE option. When asked if you want to install DCE, you may answer no.

  14. When asked to install files as setuid/setgid files, select yes.


After you have completed Installing WebSphere MQ on Solaris, you may proceed to Verifying the Installation or Configuring IBM TM WebSphere Messaging Queue (MQ) for JMS.



Installing WebSphere MQ on Windows 2000



Please refer to the "WebSphere MQ for Windows Quick Beginnings" document for detailed intructions of how to install WebSphere MQ on Windows 2000. The following instructions provide only the basic installation steps.

  1. Log on your system as a user who belongs to the Administrator group.

  2. After downloading the executable file to a staging directory, double click on the file to start the installation process.

  3. Follow the instructions in the WebSphere MQ Setup windows which are displayed.

  4. When the Setup Type Panel is displayed, select Custom Installation.

  5. When the Features panel is displayed, make sure you also select Java Messaging and Window Client features.

  6. When asked if you have purchased sufficient capacity units for the number of processors you have on your computer, click No if you are installing the trial copy of the product. Then click yes to proceed with the installation.


After you have completed Installing WebSphere MQ on Windows 2000, you may proceed to Verifying the Installation or Configuring IBM TM WebSphere Messaging Queue (MQ) for JMS.



Verifying the Installation



To verify that WebSphere MQ has been installed correctly and is functioning normally, it is suggested that you run a provided sample program to enter and retrieve a message from a queue. In order for the sample program to operate properly, you have to create a queue manager and a local queue. The procedure is as follows:

  1. Log on your system as the mqm user or as a user who is a member of the mqm group.
    On Windows 2000, you can also log on as a user who is a member of the the administrator group.

  2. Create a default queue manager named mqseries.queue.manager by typing the following at a command window:

    crtmqm -q mqseries.queue.manager

  3. Start the queue manager.

    strmqm

  4. Start MQSC command session.

    runmqsc



Note The MQSC command session does not have an input prompt.



  1. Once you are in MQSC command session, define a local queue named TESTQUEUE

    define qlocal (TESTQUEUE)

  2. Stop and exit MQSC command session by typing end.

  3. Change to the directory which contains the sample programs amqsput and amqsget.

    On solaris: cd /opt/mqm/samp/bin

    On Windows 2000: cd <MQ_HOME>\bin

    Where <MQ_HOME> is the WebSphere MQ installation home.

  4. Put a text message on the TESTQUEUE, which you created in Step 5, by typing the following command:

    amqsput TESTQUEUE

  5. Type any message text, then press Enter twice to complete the message.

  6. Retrive the message from the TESTQUEUE by typing the following command:

    amqsget TESTQUEUE

If everything is working correctly, the message that you just put on the queue in Step 9 will be displayed.


After you have completed Installing IBM TM WebSphere Messaging Queue (MQ), you may proceed to Configuring IBM TM WebSphere Messaging Queue (MQ) for JMS.


Previous      Next     
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated July 10, 2002