| Sun ONE Message Queue 3.0.1 SP2 Installation Guide |
Chapter 4
Windows InstallationThis chapter explains the following topics as they apply to a Windows installation:
Hardware and Software RequirementsAt a minimum, your Windows development system should satisfy the requirements indicated in the following table.
Table 4-1 Hardware and Software Requirements for Windows
Component
Requirements
Operating system
Windows 2000 (Professional, Server, Advanced Server) SP2
or Windows XPCPU
Intel Pentium 166 MHz (or compatible) workstation that is TCP/IP networked
RAM
128 Mbytes
Hard drive space
The self-extracting installation file is approximately 25 Mbytes.
The temporary directory used for extracting the installation files requires an additional 45 Mbytes.
The installed product requires approximately 45 Mbytes. MQ, however, may need more space if the broker stores persistent messages locally.
Java 2 Standard Edition (J2SE)
See Table 1-1 for the supported versions of the Java Runtime Environment (JRE) and Java Software Development Kit (JDK) that are supported on Windows.
The MQ installation program will (optionally) install the required JRE version in IMQ_HOME\jre.
Installing MQ on WindowsThe 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.
To install MQ on Windows
- Quit any other programs you are running.
- Download the distribution into a temporary working directory.
If you are installing from CD-ROM, insert the CD into the CD-ROM drive.
- In the Windows Explorer, double-click the imq3_0_1-edition-win.exe file
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.
- Read the license agreement. Installation and use of the product is subject to acceptance of the license agreement.
- Follow the setup program’s instruction to select installation options.
- Select the type of installation.
- Compact Includes only the files necessary to run the broker, administration, and client applications. No documentation or example client applications are installed.
- 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 a location for the installation.
- 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.
- Verify installation by choosing Start > Programs > Sun ONE Message Queue 3.0 >Message Broker to run the broker.
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 DefaultsThe following table indicates the installation defaults for Windows.
Troubleshooting Installation ProblemsIf 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
If your Windows installation of the MQ product is still not successful, try this more comprehensive procedure:
- 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 EditionsMQ 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.
imqcmd shutdown bkr -u name -p password [-b hostName:port]
- Follow the installation procedure explained in Installing MQ on Windows. Choose the Feature License option when it appears on your screen.
This setup does not overwrite the MQ modules installed, and does not modify the configuration of your MQ messaging system.
Where To Go NextRead the README and MQ Release Notes files.
For an overview of Message Queue concepts, a brief introduction to writing and compiling a client application, see the MQ Developer’s Guide.
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 WindowsThe following instructions explain how to uninstall MQ on Windows.
To remove MQ on Windows
- Stop any running client applications.
- Stop any running brokers.
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:
- Unless you want to retain dynamic broker data, remove all data files associated with each broker instance.
imqbrokerd -name brokerName -remove instance
- Remove the Message Queue product.
- From the Windows Start menu, choose Programs.
- From the Message Queue 3.0 program group, choose Uninstall.
- After Uninstall completes, remove any leftover files.
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.
- Manually remove MQ references from your environment.
