![]() |
JMS Sample Application |
Chapter 1 Installing IBM TM WebSphere MQ
This document describes how to install IBM TM WebSphere MQ (formerly MQSeries) V 5.3 on Solaris and Windows 2000.This document contains the following sections:
Downloading WebSphere MQ
Installing WebSphere MQ on Solaris
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.
To run the JMS Topic Simple sample application, you will need to download an addtional SupportPac MA0C from IMB web site to use the WebSphere MQ JMS implementaion of JMS publish/Subcribe.
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".
Login as root
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.
You must update some of the default system settings in order for WebSphere MQ to function correctly.
Reboot the machine for the changes to take effect.
- 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
Unzip and untar the WebSphere MQ installation package.
Go to the directory where you untarred the package.
To accept the license, run the following script:
To start the installation process, enter the following command:
- ./mqlicense.sh
By default, WebSphere MQ will be installed in the /opt/mqm and /var/mqm directories.
- % pkgadd -d .
When asked which packages should be installed, select all.
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.
When asked which options should be installed, select WebSphere MQ Server, Man pages, WebSphere MQ Client libraries.
It is not necessary to install the DCE option. When asked if you want to install DCE, you may answer no.
When asked to install files as setuid/setgid files, select yes.
Installing the SupportPac MAOC
To install the SupportPac MA0C, do the following steps:
Login as root
Change to the directory where the tar file was downloaded.
uncompress -fv ma0c_sol.tar.Z
tar -xvf /tmp/ma0c_sol.tar
Necessary files will be created in the appropriate directories.
After you have completed Installing WebSphere MQ on Solaris, you may proceed to Verifying the WebSphere MQ Installation or Configuring IBM TM WebSphere 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.
Log on your system as a user who belongs to the Administrator group.
After downloading the executable file to a staging directory, double click on the file to start the installation process.
Follow the instructions in the WebSphere MQ Setup windows which are displayed.
When the Setup Type Panel is displayed, select Custom Installation.
When the Features panel is displayed, make sure you also select Java Messaging and Window Client features.
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.
Installing the SupportPac MAOC
To install the SupportPac MA0C, do the following steps:
Change to the directory where the executable file was downloaded.
On a command line window, type the name of the downloaded file.
Follow the instructions in the displayed dialog boxes.
After you have completed Installing WebSphere MQ on Windows 2000, you may proceed to Verifying the WebSphere MQ Installation or Configuring IBM TM WebSphere 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:
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.Create a default queue manager named mqseries.queue.manager by typing the following at a command window:
Start the queue manager.
- crtmqm -q mqseries.queue.manager
Start MQSC command session.
- strmqm
- runmqsc
Note The MQSC command session does not have an input prompt.
Once you are in MQSC command session, define a local queue named TESTQUEUE
If everything is working correctly, the message that you just put on the queue in Step 9 will be displayed.
Stop and exit MQSC command session by typing end.
- define qlocal (TESTQUEUE)
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.
Put a text message on the TESTQUEUE, which you created in Step 5, by typing the following command:
Type any message text, then press Enter twice to complete the message.
- amqsput TESTQUEUE
Retrive the message from the TESTQUEUE by typing the following command:
- amqsget TESTQUEUE
After you have completed Installing IBM TM WebSphere MQ, you may proceed to Configuring IBM TM WebSphere MQ for JMS.
Previous Next
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated July 10, 2002