![]() |
MDB Simple Sample Application |
Chapter 1 Installing IBM WebSphere Messaging Queue (MQ)
This document describes how to install IBM WebSphere Messaging Queue (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 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".
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 installs the Sun ONE Applicatoin 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 when 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.
After you have completed Installing WebSphere MQ on Solaris, you may proceed to Verifying the Installation or Configuring IBM 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 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 to you.
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 the installation.
After you have completed Installing WebSphere MQ on Windows 2000, you may proceed to Verifying the Installation or Configuring IBM 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:
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 command 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
Retrieve the message from the TESTQUEUE by typing the following command:
- amqsget TESTQUEUE
After you have completed Installing IBM WebSphere Messaging Queue (MQ), you may proceed to Configuring IBM WebSphere Messaging Queue (MQ) for JMS.
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated July 10, 2002