The Enterprise Server support for JMS messaging, in general, and for message-driven beans, in particular, requires messaging middleware that implements the JMS specification: a JMS provider. The Enterprise Server uses the Sun GlassFish Message Queue software as its native JMS provider. The Message Queue software is tightly integrated into theEnterprise Server, providing transparent JMS messaging support. This support is known within Enterprise Server as the JMS Service. The JMS Service requires only minimal administration.
The relationship of the Message Queue software to the Enterprise Server can be one of these types: EMBEDDED, LOCAL, or REMOTE. The effects of these choices on the Message Queue broker life cycle are as follows:
If the type is EMBEDDED, the Enterprise Server and Message Queue software run in the same JVM, and the networking stack is bypassed. The Message Queue broker is started and stopped automatically by the Enterprise Server. This is the default for the Domain Administration Server (DAS).
Lazy initialization starts the default embedded broker on the first access of JMS services rather than at Enterprise Server startup. EMBEDDED mode is not a supported configuration for a cluster.
If the type is LOCAL, the Message Queue broker starts when the Enterprise Server starts. This is the default for all Enterprise Server instances except the DAS.
The LOCAL setting implicitly sets up a 1:1 relationship between an Enterprise Server instance and a Message Queue broker. When you create an Enterprise Server cluster, a Message Queue cluster is automatically created as well. During cluster creation, each instance in the Enterprise Server cluster is automatically configured with a broker in the Message Queue cluster, and a unique broker port is determined.
The first Enterprise Server instance's Message Queue broker is set as the master broker. If you delete the first Enterprise Server instance, you must use Message Queue administration tools to migrate the master broker. For details, see Managing a Conventional Cluster’s Configuration Change Record in Sun Java System Message Queue 4.3 Administration Guide. However, if HADB is installed, there is no master broker. For more information about HADB, see JMS Service High Availability.
If the type is REMOTE, the Message Queue broker must be started separately. For information about starting the broker, see the Sun Java System Message Queue 4.3 Administration Guide.
For more information about setting the type and the default JMS host, see Configuring the JMS Service.
For more information about the Message Queue software, refer to the documentation at http://docs.sun.com/coll/1343.8.
For general information about the JMS API, see the JMS web page at http://java.sun.com/products/jms/index.html.
Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server 2.1 Administration Guide.