JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server Message Queue 4.5 Administration Guide
search filter icon
search icon

Document Information

Preface

Part I Introduction to Message Queue Administration

1.  Administrative Tasks and Tools

2.  Quick-Start Tutorial

Part II Administrative Tasks

3.  Starting Brokers and Clients

4.  Configuring a Broker

5.  Managing a Broker

6.  Configuring and Managing Connection Services

7.  Managing Message Delivery

8.  Configuring Persistence Services

9.  Configuring and Managing Security Services

10.  Configuring and Managing Broker Clusters

11.  Managing Administered Objects

Object Stores

LDAP Server Object Stores

File-System Object Stores

Administered Object Attributes

Connection Factory Attributes

Connection Handling

Client Identification

Reliability And Flow Control

Queue Browser and Server Sessions

Standard Message Properties

Message Header Overrides

Destination Attributes

Using the Object Manager Utility

Connecting to a Secured LDAP Server (ldaps)

Adding Administered Objects

Adding a Connection Factory

Adding a Destination

Deleting Administered Objects

Listing Administered Objects

Viewing Administered Object Information

Modifying Administered Object Attributes

Using Command Files

12.  Configuring and Managing Bridge Services

13.  Monitoring Broker Operations

14.  Analyzing and Tuning a Message Service

15.  Troubleshooting

Part III Reference

16.  Command Line Reference

17.  Broker Properties Reference

18.  Physical Destination Property Reference

19.  Administered Object Attribute Reference

20.  JMS Resource Adapter Property Reference

21.  Metrics Information Reference

22.  JES Monitoring Framework Reference

Part IV Appendixes

A.  Distribution-Specific Locations of Message Queue Data

B.  Stability of Message Queue Interfaces

C.  HTTP/HTTPS Support

D.  JMX Support

E.  Frequently Used Command Utility Commands

Index

Object Stores

Administered objects are placed in a readily available object store where they can be accessed by client applications by means of the Java Naming and Directory Interface (JNDI). There are two types of object store you can use: a standard Lightweight Directory Access Protocol (LDAP) directory server or a directory in the local file system.

LDAP Server Object Stores

An LDAP server is the recommended object store for production messaging systems. LDAP servers are designed for use in distributed systems and provide security features that are useful in production environments.

LDAP implementations are available from a number of vendors. To manage an object store on an LDAP server with Message Queue administration tools, you may first need to configure the server to store Java objects and perform JNDI lookups; see the documentation provided with your LDAP implementation for details.

To use an LDAP server as your object store, you must specify the attributes shown in Table 11-1. These attributes fall into the following categories:

Table 11-1 LDAP Object Store Attributes

Attribute
Description
java.naming.factory.initial
Initial context for JNDI lookup

Example:

  • com.sun.jndi.ldap.LdapCtxFactory

java.naming.provider.url
Server URL and directory path

Example:

  • ldap://myD.com:389/ou=mq1,o=App

where administered objects are stored in the directory /App/mq1.

java.naming.security.principal
Identity of the principal for authenticating callers

The format of this attribute depends on the authentication scheme: for example,

  • uid=homerSimpson,ou=People,o=mq

If this attribute is unspecified, the behavior is determined by the LDAP service provider.

java.naming.security.credentials
Credentials of the authentication principal

The value of this attribute depends on the authentication scheme: for example, it might be a hashed password, a clear-text password, a key, or a certificate.

If this property is unspecified, the behavior is determined by the LDAP service provider.

java.naming.security.authentication
Security level for authentication:
  • none: No security

  • simple: Simple security

  • strong: Strong security

For example, if you specify simple, you will be prompted for any missing principal or credential values. This will allow you a more secure way of providing identifying information.

If this property is unspecified, the behavior is determined by the LDAP service provider.

File-System Object Stores

Message Queue also supports the use of a directory in the local file system as an object store for administered objects. While this approach is not recommended for production systems, it has the advantage of being very easy to use in development environments. Note, however, that for a directory to be used as a centralized object store for clients deployed across multiple computer nodes, all of those clients must have access to the directory. In addition, any user with access to the directory can use Message Queue administration tools to create and manage administered objects.

To use a file-system directory as your object store, you must specify the attributes shown in Table 11-2. These attributes have the same general meanings described above for LDAP object stores; in particular, the java.naming.provider.url attribute specifies the directory path of the directory holding the object store. This directory must exist and have the proper access permissions for the user of Message Queue administration tools as well as the users of the client applications that will access the store.

Table 11-2 File-system Object Store Attributes

Attribute
Description
java.naming.factory.initial
Initial context for JNDI lookup

Example:

  • com.sun.jndi.fscontext.RefFSContextFactory

java.naming.provider.url
Directory path

Example:

  • file:///C:/myapp/mqobjs