Installing Message Queue on Windows

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.

Upgrading from Previous Versions

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.

Installed Directory Structure

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.

---

Note –

File locations for Message Queue bundled with Sun Java System Application Server may differ from those shown in the table.

---

Table 4–2 Installed Directory Structure (Windows)

Windows	Contents
IMQ_HOME\README.txt	README text file
IMQ_HOME\bin	Executable files for the following administration tools:   Administration Console (imqadmin) Broker utility (imqbrokerd) Command utility (imqcmd) Object Manager utility (imqobjmgr) Database Manager utility (imqdbmgr) User Manager utility (imqusermgr) Service Administrator utility (imqsvcadmin) Key Tool utility (imqkeytool) 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.  .jar files for building and running Java Message Service (JMS) client applications .rar files for JMS Resource Adapter .war files for HTTP servlet deployment 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

Installing Message Queue

Follow these steps to install Message Queue 3.7 UR1 on Windows.

To Install Message Queue on Windows

1. Unzip the bundle mq_37–ent-win.zip.

2. 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

3. Change directories to $TOP/mq/bin.

4. Start the broker using the following command.

   ./imqbrokerd -tty

Running Sample Applications

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