The Sun Java System Message Queue product can be downloaded from the Sun Java System Web site. Message Queue also depends upon components that you must install to be able to develop and run Message Queue clients. See Table 1–1 and Table 1–2 for more information.
The following instructions explain how to install the Message Queue product.
To upgrade from prior Message Queue versions, it is recommended that you first uninstall Message Queue software as described in the Message Queue Installation Guide of the appropriate version, before installing Sun Java System Message Queue 3.7 UR1.
If you want to preserve data from a previous version of Message Queue when you migrate from an older version, refer to Migration Issues prior to uninstalling Message Queue.
If you are installing Message Queue after a previous uninstall, check that any references to the previous Message Queue installation have been removed from the system’s PATH environment variable.
Table 4–2 shows the installed directory structure for Message Queue 3.7 UR1 on the Windows platform. Paths shown are relative to the Message Queue base directory (root installation directory), represented by the IMQ_HOME directory variable.
File locations for Message Queue bundled with Sun Java System Application Server may differ from those shown in the table.
Windows |
Contents |
---|---|
IMQ_HOME\README.txt |
README text file |
IMQ_HOME\bin |
Executable files for the following administration tools:
All executable files have the filename extension .exe. This directory also includes other executables (imqbrokersvc). |
IMQ_HOME\lib |
Support files for Message Queue Java client runtime.
Support files for Message Queue tools and processes Libraries to support C client applications Note – See Supported Platforms and Components for the versions of Netscape Portable Runtime (NSPR) and Network Security Service (NSS) needed to support the C API. |
IMQ_HOME\lib\props |
Broker's default configuration files |
IMQ_HOME\lib\ext |
Files needed for JDBC-based persistence |
IMQ_HOME\lib\help |
Message Queue help files |
IMQ_HOME\lib\images |
Admin GUI image files |
IMQ_HOME\var |
Message Queue working storage |
IMQ_HOME\var\instances |
Configuration properties, file-based persistent data stores, log files, flat-file user repositories, and access control properties files for individual broker instances |
IMQ_HOME\javadoc |
Message Queue and JMS API documentation in JavaDoc format |
IMQ_HOME\demo |
Example Java client applications |
IMQ_HOME\demo\C |
Example C client applications |
IMQ_HOME\include |
Header files to support C client applications |
IMQ_HOME\etc |
License files and instance template files |
Follow these steps to install Message Queue 3.7 UR1 on Windows.
Unzip the bundle mq_37–ent-win.zip.
Edit the file $TOP/mq/etc/imqenv.conf to set the IMQ_DEFAULT_JAVAHOME variable to specify a JDK 1.5.0 runtime. For example:
set IMQ_DEFAULT_JAVAHOME=c:\Program Files\Java\jre1.5.0_09 |
Change directories to $TOP/mq/bin.
Start the broker using the following command.
./imqbrokerd -tty
After installing Message Queue, you can compile and run example applications located in the c:\Sun\MessageQueue\demo directory. See the Message Queue Developer's Guide for Java Clients or the Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients for additional instructions.
To run JMS client applications, include the following jar files in your classpath.
$TOP/mq/lib/jms.jar |
$TOP/mq/lib/imq.jar |