Previous Contents |
Sun ONE Message Queue Installation Guide |
Chapter 4 Windows Installation
This chapter explains the following topics as they apply to a Windows installation:
Hardware and Software Requirements
Hardware and Software Requirements
At a minimum, your Windows development system should satisfy the requirements indicated in the following table.
Installing MQ on Windows
The Sun ONE Message Queue product can be downloaded from the Sun ONE website or installed from the product CD-ROM.The following instructions explain how to install the MQ product either by downloading from the Sun ONE website or using the CD-ROM.
Note If you are installing MQ after a previous uninstall, remove any references to the previous MQ installation from the system's PATH environment variable.
Quit any other programs you are running.
Download the distribution into a temporary working directory.
In the Windows Explorer, double-click the imq3_0-edition-win.exe file
- If you are installing from CD-ROM, insert the CD into the CD-ROM drive.
Read the license agreement. Installation and use of the product is subject to acceptance of the license agreement.
- where edition takes one of the following values: plt or ent, depending on whether you are installing the Platform Edition or Enterprise Edition, respectively.
- The installation file is extracted and setup is launched. If you are installing from CD-ROM, the setup program is started automatically.
Follow the setup program's instruction to select installation options.
Select the type of installation.
Verify installation by choosing Start > Programs > Sun ONE Message Queue 3.0 >Message Broker to run the broker.
Compact Includes only the files necessary to run the broker, administration, and client applications. No documentation or example client applications are installed.
Select a location for the installation.Custom Lets you specify which MQ modules you want to install. Your options include the broker, client runtime, administration tools, documentation, example client applications, and Java runtime.
Typical Installs all files, including broker, client runtime, administration tools, documentation, example client applications, and Java runtime.
Feature License Installs only the files necessary to enable the licensed capacity of an MQ messaging system. This option does not overwrite the MQ files already installed, and does not modify the configuration of your messaging system.
Select or create a folder for the Windows Start > Programs menu.
Choose whether or not to install the broker as a Windows service. If you choose to install the broker as a Windows service, the broker will be started automatically at system startup and run in the background. This option requires Windows Administrator Group privileges.
- If you choose not to install the broker as a Windows service now but later change your mind, you can use the imqsvcadmin utility to do so. See the MQ Administrator's Guide for information on using the imqsvcadmin utility.
- You can also compile and run example applications located in the
c:\Program Files\Sun Microsystems\Message Queue 3.0\demo directory. See the MQ Developer's Guide.
Installation Defaults
The following table indicates the installation defaults for Windows.
Troubleshooting Installation Problems
If the MQ installation program does not complete successfully on your Windows platform, try the following remedies. These apply regardless of whether you installed the product from CD-ROM or downloaded it from the Web.
To troubleshoot installation problems on Windows
Use the Windows Task Manager to end the MQ installation program.
If your Windows installation of the MQ product is still not successful, try this more comprehensive procedure:Clear any temporary directories (for example, temp or tmp).
Start the MQ installation again, being certain to install to the same directory as the initial installation attempt.
Use the Windows Task Manager to end the MQ installation program.
Clear any temporary directories (for example, temp or tmp).
In the Services control panel, temporarily stop any non-Windows network-related services (for example, a Solstice NFS Server service).
Delete the Message Queue 3.0 directory and all its contents.
In your Systems control panel, remove all references to MQ 3.0 from your environment settings.
Restart your Windows operating system.
Reinstall MQ in the same directory location as the initial failed installation.
Reset any services in the Services (Control Panel) that you stopped in Step 3.
Upgrading Editions
MQ comes in two editions, as explained in "Product Editions".You can upgrade from the Platform Edition to the Enterprise Edition by installing the Enterprise Edition. The Enterprise Edition is available from the Sun ONE website.
To upgrade to Enterprise Edition on Windows
Stop any running brokers.
Follow the installation procedure explained in "Installing MQ on Windows." Choose the Feature License option when it appears on your screen.
- imqcmd shutdown bkr -u name -p password [-b hostName:port]
- This setup does not overwrite the MQ modules installed, and does not modify the configuration of your MQ messaging system.
Where To Go Next
Read the README and MQ Release Notes (relnotes.html) files.
The README includes information on where to find documentation, news and updates, and how to send feedback.
For an overview of Sun ONE Message Queue concepts, a brief introduction to writing and compiling a client application, see the MQ Developer's Guide.The MQ Release Notes contain information on code and documentation changes, open bugs, and important technical notes. This document is available on the Sun ONE website.
For details on configuring brokers and managing an MQ messaging system, see the MQ Administrator's 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.
Uninstalling MQ on Windows
The following instructions explain how to uninstall MQ on Windows.
Stop any running client applications.
- imqcmd shutdown bkr -u name -p password [-b hostName:port]
- If you had installed the broker as a Windows service, you can stop it as follows:
From the Windows Start menu, choose Settings, then Control Panel.
Unless you want to retain dynamic broker data, remove all data files associated with each broker instance.Double-click the Administrative Tools icon, then the Services icon.
In the Services panel, select the iMQ Broker entry, then click Stop.
Remove the Sun ONE Message Queue product.
- imqbrokerd -name brokerName -remove instance
From the Windows Start menu, choose Programs.
From the Sun ONE Message Queue 3.0 program group, choose Uninstall.
After Uninstall completes, remove any leftover files.
Manually remove MQ references from your environment.
- The Windows Uninstall utility does not remove any files or directories installed into the product directory that were later modified. It also does not remove any files or directories created by the user as a result of product operations.
Previous Contents
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated June 20, 2002