![]() |
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
Installing E2A Application Server Platform 5.1
Running the Orbix Simple Example
Configuring Sun Java (tm) System Application Server to Use E2A orb
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:
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.
Select Java Development Kit to support development of Java-based CORBA applications.
- 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
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:
Ensure that JAVA_HOME specifies the location of a Java 2 1. installation.
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.Create the domains using itConfigure.
Copy licence file under <orbix_install_path>/asp/5.1/etc/ and provide it when asked in itConfigure.
Setup the enivironment by sourcing the <domainname_env> file.
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/
Start the Server Component. For example:
- PATH=<orbix_install_path>/asp/5.1/bin::$PATH
- export JAVA_HOME PATH
- itant all
- itant runServer
Run the Client Application by doing the following:
- You should see the following messages:
- Initializing the ORB
- Creating objects
- Activating the POA Manager
- Giving control to the ORB to process request
Start a new DOS or UNIX terminal window, set the environment variables and run the client application. For example:
- Change directory to <orbix_install_path>/asp/5.1/demos/corba/orb/simple/
As the client runs, you should see the following messages on the server side DOS/terminal window:
- PATH=<orbix_install_path>/asp/5.1/bin::$PATH
- export JAVA_HOME PATH
- itant runClient
In the client window, you should see the following:
- Calling SimpleInheritanceImpl::call_me()
- Calling SimpleDelegate::call_me()
- 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
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:
The following additions must be made to the CLASSPATH:
The application server is now configured for Orbix. Proceed to Deploying and Running the Sample Applications.
Orbix classes (orbix2000.jar)
Modify the server.xml to set the classpath:OMG classes (j2ee13-product.jar)
Directory containing Orbix license file
Go to Application Server Instances -> server1 (or any other instance)
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>
After modifying Class Path Suffix, do the following:
- This classpath should be available in the window where you source <domain_name>_env.
Previous Contents Next
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated August 09, 2002