Sun GlassFish Message Queue 4.4 Update 1 Installation Guide

Chapter 1 Introduction

This chapter provides an overall introduction to installing the Sun GlassFish^TM Message Queue 4.4 Update 1 product. It covers the following topics:

IPS Packaging

Message Queue 4.4 Update 1 is distributed as a set of IPS packages, which can be updated using the Update Tool. The installer installs IPS packages on Solaris, Linux, AIX, and Windows. For those platforms where Update Tool is not supported (AIX, other UNIX), the installer installs an IPS user image but updates are not be available through the Update Tool.

Note –

Native SVR4 packages for Solaris and Linux RPMs are deprecated with the Message Queue 4.4 Update 1 release.

Product Editions

Before the release of Version 3.7 UR1, the Sun GlassFish Message Queue product was available in two editions, Platform and Enterprise, each containing different features and corresponding to a different licensed capacity. Versions beginning with 3.7 UR1 combine the functionality of both editions. If you have an earlier version installed under a Platform Edition license, upgrading to Version 4.4 Update 1 will give you access to the full range of Message Queue functionality, including the following features formerly available only under the Enterprise Edition license.

For the complete list of new features available to all users of Version 4.4 Update 1, see the New Features in Message Queue 4.4 Update 1 and Recent Releases in Sun GlassFish Message Queue 4.4 Update 1 Release Notes.

Supported Platforms and Components

Message Queue 4.4 Update 1 is supported on Solaris, Linux, AIX, and Windows operating system platforms. Table 1–1 shows the supported versions of each of these platforms. The chapters that follow describe the hardware requirements for each of these platforms and provide platform-specific installation instructions.

Table 1–1 Supported Platform Versions


Platform	Supported Versions
Solaris	Solaris 9 (SunOS 5.9), all updates (SPARC, `x`86) Solaris 10 (SunOS 5.10), all updates (SPARC, `x`86, `x`64)
OpenSolaris	OpenSolaris 2008.11 (`x`86, `x`64) OpenSolaris 2009.06 (`x`86, `x`64)
Linux	Red Hat Enterprise Linux Advanced Server 4.0, 5.0, all updates, 32– and 64–bit versions (`x`86, `x`64) Red Hat Enterprise Linux Enterprise Server 4.0, 5.0, all updates, 32– and 64–bit versions (`x`86, `x`64)
AIX	AIX 6.1
Windows	Windows Vista Windows XP Professional, SP2 (`x`86) [No Home, Tablet PC, or Media Center Edition support] Windows Server 2003 Standard and Enterprise Editions, SP2, 32– and 64–bit versions (`x`86, `x`64) [No Web or Small Business Server Edition support] Windows Server 2008 Standard and Enterprise Editions, SP2, 32– and 64–bit versions (`x`86, `x`64)

In addition to platform-specific requirements, Message Queue 4.4 Update 1 also depends on a number of required and optional software components. These components, which include the Java Runtime Environment (JRE) and Java Software Development Kit (JDK), are specified in Component Dependencies in Sun GlassFish Message Queue 4.4 Update 1 Release Notes. Please check these software dependencies before installing Message Queue 4.4 Update 1.

Note –

The Message Queue 4.4 Update 1 Installer automatically installs the required JDK version as of the time of release.

Message Queue Software Modules

Table 1–2 shows the full set of software modules included with the Message Queue 4.4 Update 1 product.

Table 1–2 Software Modules


Module	Contents
Broker	Server-side software for routing and delivering messages. Requires the Java runtime module
Administration tools	Command-line utilities and GUI tools for administering a Message Queue messaging system. Requires the client runtime and Java runtime modules
Java client runtime	`.jar` files needed to write and compile Java clients using the Message Queue Java application programming interface (API)
C client runtime	Libraries and header files needed to write and compile C clients using the Message Queue C application programming interface (API)
Documentation	API documentation needed by Java client application developers, in JavaDoc format
Example applications	Sample client applications

Where to Go Next

Before proceeding to install Message Queue 4.4 Update 1, be sure to consult the section Installation Issues in Sun GlassFish Message Queue 4.4 Update 1 Release Notes for the latest information on issues and limitations affecting Message Queue 4.4 Update 1 installation. The Release Notes are also an important general resource for up-to-date code and documentation changes, open bugs, and important technical notes relating to the current Message Queue release.

In addition, the following sources provide further useful information on Sun GlassFish Message Queue:

For information on where to find documentation, news, and updates and how to send feedback, see the README file included in your Message Queue installation.
For an introduction to Message Queue concepts, see the Message Queue Technical Overview.
For details on configuring brokers and managing a Message Queue messaging system, see the Message Queue Administration Guide.
For an introduction to writing and compiling Message Queue client applications, see the Message Queue Developer’s Guide for Java Clients or the Message Queue Developer’s Guide for C Clients.
For information on the Message Queue Java^TM Management Extensions (JMX) API, see the Message Queue Developer’s Guide for JMX Clients.
For class and member information useful when writing a client application, browse the API documentation in JavaDoc format included in your Message Queue installation; see Table P–7 for locations, depending on your platform.