Sun Java System Message Queue 3.7 UR1 Installation Guide

Chapter 4 Windows Installation

This chapter explains the following topics as they apply to a Windows installation of Sun Java System Message Queue 3.7 UR1:

Hardware and Software Requirements

At a minimum, your Windows system should satisfy the requirements indicated in the following table.

Table 4–1 Hardware and Software Requirements (Windows)



Operating system 

Windows XP Professional SP2 

Windows 2000 all editions, SP4 or higher 

Wondows Server 2003, Enterprise Edition 


Intel Pentium 3 


256 MB 

Disk space 

The installation file containing the product is approximately 7 MB.  

The installed product requires approximately 13 MB. 125 MB are needed if a new Java runtime must be installed. Message Queue, however, may need more space if the broker stores persistent messages locally.  

Java 2 Platform, Standard Edition (J2SE) 

See Supported Platforms and Components for the supported versions of the Java Runtime Environment (JRE) and Java Software Development Kit (JDK) that are supported on Linux.

The Message Queue software distribution includes the required JRE version at the time of release. 

Message Queue also depends upon other technologies, as shown in Supported Platforms and Components.

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)




README text file


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


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.


Broker's default configuration files 


Files needed for JDBC-based persistence


Message Queue help files 


Admin GUI image files 


Message Queue working storage 


Configuration properties, file-based persistent data stores, log files, flat-file user repositories, and access control properties files for individual broker instances 


Message Queue and JMS API documentation in JavaDoc format


Example Java client applications 


Example C client applications 


Header files to support C client applications 


License files and instance template files 

Installing Message Queue

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

ProcedureTo Install Message Queue on Windows

  1. Unzip the bundle mq_37–

  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.



Troubleshooting Installation Problems

If the Message Queue installation program does not complete successfully on your Windows platform, use the following procedure to correct the problem.

ProcedureTo Troubleshoot Installation Problems on Windows

  1. Clear any temporary directories (for example, temp or tmp).

  2. Clear any temporary directories (for example, temp or tmp).

  3. In the Services control panel, temporarily stop any non-Windows network-related services (for example, a Solstice NFS Server service).

  4. Delete the MessageQueue directory and all its contents.

  5. In your Systems control panel, remove all references to MessageQueue from your environment settings.

    Example: IMQHOME and PATH environment variables.

  6. Restart your Windows operating system.

  7. Reinstall Message Queue in the same directory location as the initial failed installation.

  8. Reset any services in the Services (Control Panel) that you stopped in Troubleshooting Installation Problems.

Uninstalling Message Queue on Windows

The following instructions explain how to uninstall Message Queue on Windows.

ProcedureTo Remove Message Queue on Windows

  1. Stop any running client applications.

  2. Stop any running brokers. (You will be prompted for the admin user name and password.)

    imqcmd shutdown bkr [-b hostName:port]

    If you had installed the broker as a Windows service, you can stop it as follows:

    1. From the Windows Start menu, choose Settings, then Control Panel.

    2. Double-click the Administrative Tools icon, then the Services icon.

    3. In the Services panel, select the Message Queue Broker entry, then click Stop.

    4. Close the Services panel.

  3. Unless you want to retain dynamic data, the Message Queue flat file user repository, and the Message Queue access control properties file associated with each broker instance, remove this data using the following command.

    imqbrokerd -name instanceName -remove instance
  4. Delete the folder containing the Message Queue 3.7 UR1 files.

    This is the same folder into which you decompressed the file when installing Message Queue 3.7 UR1.

Where To Go Next

Read the README and Message Queue Release Notes files.

For an overview of Sun Java System Message Queue concepts, see the Message Queue Technical Overview.

For a brief introduction to writing and compiling a client application, see the Message Queue Developer's Guide for Java Clients or the Message Queue Developer's Guide for C Clients.

For details on configuring brokers and managing a Message Queue messaging system, see the Message Queue Administration Guide.

For class and member information used when writing a client application, browse the API documentation in the IMQ_HOME\javadoc directory.

To uninstall the product, see the following section.