Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Application Server Enterprise Edition 8 2004Q4 Beta Administration Guide 

Chapter 18
Configuring the Object Request Broker

This chapter describes how to configure the Object Request Broker (ORB) and IIOP listeners. It has the following sections:

About the Object Request Broker

CORBA

The Application Server supports a standard set of protocols and formats that ensure interoperability. Among these protocols are those defined by CORBA.

The CORBA (Common Object Request Broker Architecture) model is based on clients requesting services from distributed objects or servers through a well-defined interface by issuing requests to the objects in the form of remote method requests. A remote method request carries information about the operation that needs to be performed including the object name (called an object reference) of the service provider and parameters, if any, for the invoked method. CORBA automatically handles network programming tasks such as object registration, object location, object activation, request de-multiplexing, error-handling, marshalling, and operation dispatching.

What is the ORB?

The Object Request Broker (ORB) is the central component of CORBA. The ORB provides the required infrastructure to identify and locate objects, handle connection management, deliver data, and request communication.

A CORBA object never talks directly with another. Instead, the object makes requests through a remote stub to the ORB running on the local machine. The local ORB then passes the request to an ORB on the other machine using the Internet Inter-Orb Protocol (IIOP for short). The remote ORB then locates the appropriate object, processes the request, and returns the results.

IIOP can be used as a Remote Method Invocation (RMI) protocol by applications or objects using RMI-IIOP. Remote clients of enterprise beans (EJB modules) communicate with the Application Server via RMI-IIOP.

IIOP Listeners

An IIOP listener is a listen socket that accepts incoming connections from the remote clients of EJB components and from other CORBA-based clients. Multiple IIOP listeners can be configured for the Application Server. For each listener, specify a port number, a network address, and optionally, security attributes. For more information, see "Creating an IIOP Listener".

Admin Console Tasks for the ORB

Configuring the ORB

  1. In the tree component, expand the Configurations node.
  2. Select the instance to configure:
    1. To configure a particular instance, select the instance's config node. For example, for the default instance, server, select the server-config node.
    2. To configure the default settings for future instances that use a copy of default-config, select the default-config node.
  3. Select the ORB node.
  4. Choose the thread pool the ORB uses from the Thread Pool ID drop-down list.

    5. The ORB uses thread pools to respond to requests from remote clients of EJB modules and other clients that communicate via RMI-IIOP. For more information, see "Thread Pools in the Application Server" and "Creating Thread Pools".

  5. In the Max Message Fragment Size field, set the maximum fragment size for IIOP messages.

    6. Messages larger than this size are fragmented.

  6. In the Total Connections field, set the maximum number of incoming connections for all IIOP listeners.
  7. Select the Required checkbox if IIOP client authentication is required.
  8. Click Save to save the changes, or Load Defaults to load the default values.
  9. Restart the server.

Admin Console Tasks for IIOP Listeners

Creating an IIOP Listener

  1. In the tree component, expand the Configurations node.
  2. Select the instance to configure:
    1. To configure a particular instance, select the instance's config node. For example, for the default instance, server, select the server-config node.
    2. To configure the default settings for future instances that use a copy of default-config, select the default-config node.
  3. Expand the ORB node.
  4. Select IIOP Listeners.
  5. Click New.
  6. Enter a name to identify the listener in the Name field.
  7. Enter the network address of the listener in the Network Address field.

    8. This can be an IP address or a DNS resolvable host name.

  8. In the Listener Port field, enter the port number upon which the listener is to listen.
  9. Check the Enabled box in the Listener field to enable the listener.
  10. In the Additional Properties area, provide values for properties required by your application.
  11. To create a listener that is not secure, click OK.

In the Security section of this page, it is possible to configure the listener to use SSL, TLS, or both SSL and TLS security.

To set up a secure listener, do the following:

  1. Check the Enabled box in the Security field.
  2. To force clients to authenticate themselves to the server when using this listener, check the Enabled box in the Client Authentication field.
  3. Enter the name of an existing server keypair and certificate in the Certificate NickName field.
  4. In the SSL3/TLS section:
    1. Check the security protocol(s) to enable on the listener. Check either SSL3 or TLS, or enable both protocols.
    2. Check the cipher suite used by the protocol(s). To enable all cipher suites, check All Supported Cipher Suites. You can also enable individual cipher suites.
  5. Click OK.

The listener is now listed in the Current Listeners table on the IIOP Listeners page.

Equivalent asadmin command: create-iiop-listener

Editing an IIOP Listener

  1. In the tree component, expand the Configurations node.
  2. Select the instance to configure:
    1. To configure a particular instance, select the instance's config node. For example, for the default instance, server, select the server-config node.
    2. To configure the default settings for future instances that use a copy of default-config, select the default-config node.
  3. Expand the ORB node.
  4. Select the IIOP Listeners node.
  5. Select the listener to be modified in the Current Listeners table.
  6. Modify the listener's settings. See "Creating an IIOP Listener" for descriptions of the fields that are modifiable.

Deleting an IIOP Listener

  1. In the tree component, expand the Configurations node.
  2. Select the instance to configure:
    1. To configure a particular instance, select the instance's config node. For example, for the default instance, server, select the server-config node.
    2. To configure the default settings for future instances that use a copy of default-config, select the default-config node.
  3. Expand the ORB node.
  4. Select the IIOP Listeners node.
  5. Check the listener(s) to be deleted in the Current Listeners table.
  6. Click Delete.

Equivalent asadmin command: delete-iiop-listener



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.