Sun Java System logo      Previous      Contents      Next     
CORBA Interoperability Sample Application



E2A Application Server Platform 5.1 Configuration


This document describes how to configure the CORBA Interoperability in conjunction with Sun Java (tm) System Application Server 7.

This document contains the following sections:



Overview

The following instructions describe how to install and configure IONA's Orbix 1.2.1 ORB as well as how to configure Sun Java (tm) System Application Server to use this ORB to access backend CORBA objects from the application server.



Installing E2A Application Server Platform 5.1



You can purchase E2A Application Server Platform 5.1 from IONA. If you already have Orbix installed, then proceed to the next section, Running the Orbix Simple Example. Read through the Orbix Installation Guide before attempting to install Orbix. The basic installation steps are as follows:

  1. Run the installation executable. For example:

    • On Windows, you will need to update some dlls. Refer to the Orbix Installation Guide for more details

    • On UNIX, you must also ensure that your JAVA_HOME environment variable specifies the location of a Java 2 1 installation.

    Assuming that you have Sun Java (tm) System Application Server installed, you can set JAVA_HOME in the following manner:

    JAVA_HOME=<jdk-installation-dir>;PATH=$JAVA_HOME/bin:$PATH

    export JAVA_HOME PATH

    Now install Orbix by executing the following:

    ./asp.bin -i gui

  2. Select Java Development Kit to support development of Java-based CORBA applications.

  3. If you are installing on Windows, restart your computer.



Running the Orbix Simple Example

To ensure that the CORBA environment is configured correctly, run the Simple example provided in the Orbix distribution. After you've successfully run this application, the next step will be to deploy and run either a servlet or EJB-based client against the same server side CORBA object. The Orbix Installation Guide provides detailed instructions of how to configure and run the Simple example. The following are the main steps:

  1. Ensure that JAVA_HOME specifies the location of a Java 2 1. installation.

  2. Create the domains using itConfigure.

  3. Copy licence file  under  <orbix_install_path>/asp/5.1/etc/ and  provide it when  asked in itConfigure.

  4. Setup the enivironment by sourcing the <domainname_env> file.

  5. Start the domain services.

  6. Compile the Samples using the itant utility provided by Orbix. For example:

    Change directory to   <orbix_install_path>/asp/5.1/demos/corba/orb/simple/

    PATH=<orbix_install_path>/asp/5.1/bin::$PATH

    export JAVA_HOME PATH

    itant all

  7. Start the Server Component. For example:

    itant runServer

    You should see the following messages:

    Initializing the ORB

    Creating objects

    Activating the POA Manager

    Giving control to the ORB to process request

  8. Run the Client Application by doing the following:

    • Start a new DOS or UNIX terminal window, set the environment variables and run the client application. For example:

  9. Change directory to   <orbix_install_path>/asp/5.1/demos/corba/orb/simple/

    PATH=<orbix_install_path>/asp/5.1/bin::$PATH

    export JAVA_HOME PATH

    itant runClient

  10. As the client runs, you should see the following messages on the server side DOS/terminal window:

    Calling SimpleInheritanceImpl::call_me()

    Calling SimpleDelegate::call_me()

  11. In the client window, you should see the following:

    Initializing ORB

    Invoking method on first object

    Reading object reference from ../simple1.ior

    Invoking method on second object

    Reading object reference from ../simple2.ior

    Done

The client has successfully accessed the server side CORBA component. Now that you've verified that the sample works properly, the next step is to configure the application server to use the Orbix ORB classes.



Configuring Sun Java (tm) System Application Server to Use E2A orb



Before using servlet and EJB clients to access backend CORBA objects, the Sun Java (tm) System Application Server runtime environment must be configured to enable the application server to load the Orbix ORB classes. The procedure is as follows:

  1. The following additions must be made to the CLASSPATH:

    • Orbix classes (orbix2000.jar)

    • OMG classes (j2ee13-product.jar)

    • Directory containing Orbix license file

    • Directory of your domains.

  2. Modify the server.xml to set the classpath:

    • Go to Application Server Instances -> server1 (or any other instance)

    • Click on Jvm Settings

    • Click on Path Settings

    • Append the following classpath to Class Path Suffix text field:

      /<orbix_installpath>/asp/5.1/lib/orbix2000.jar:/<orbix_installpath>/asp/5.1/lib/j2ee13-product.jar:/<orbix_installpath>/asp/5.1/etc:<domain_path>

    This classpath should be available in the window where you source <domain_name>_env.

  3. After modifying Class Path Suffix, do the following:

    • Click Save

    • Click on server1 (server instance)

    • Click on Apply Changes tab

    • Restart the application server instance to pickup the changes.

The application server is now configured for Orbix. Proceed to Deploying and Running the Sample Applications.


Previous      Contents      Next     
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated August 09, 2002