Package examples.iiop.rmi.server.wls

This example illustrates connectivity between a variety of clients, Tuxedo and WebLogic Server using a simple Ping program.

See:
Description

Interface Summary

Pinger

The Ping interface.

Class Summary

PingImpl

Implements the Ping interface.

Package examples.iiop.rmi.server.wls Description

This example illustrates connectivity between a variety of clients, Tuxedo and WebLogic Server using a simple Ping program. To run all these examples you will need Inprise Visibroker 4.1 for C++. It is also necessary that you have Tuxedo 8.0 or later. Run the portion of the example contained on this page first in order to then run the clients and then the Tuxedo Server. The source code for all the RMI-IIOP examples is in your WL_HOME\samples\server\src\examples\iiop directory. To get the most out of this example, first read through the source code files to see what is happening. Start with the XML build files to find the general structure of the example, i.e. which classes are used for the different objects and interfaces, then examine the other files to see how the applications work. Pay close attention to setting up your Tuxedo environment as there are many pitfalls when attempting to run Tuxedo and WebLogic in conjunction. There are three different clients that can be executed; examine the XML build file carefully for each one. Take special note to see how the idl files are created for the C++ and Tuxedo clients as well as the Tuxedo server. This example also presumes familiarity with BEA Tuxedo. For further information on Tuxedo and especially how to administer and configure a Tuxedo Server, it is highly recommended that you view their online documentation

The source code for all the RMI-IIOP examples is in your WL_HOME\samples\server\src\examples\iiop directory.

If you run into problems, make sure to check your environment; check especially your PATH and CLASSPATH as well as the BDMCONFIG, TOBJADDR , and TUXCONFIG variables that are used by Tuxedo. It is recommended to get these examples first working with WebLogic Server before attempting to introduce the Tuxedo Server.

Also check out the java code: Pinger and PingImpl

The following section describes how to build and run the example:

1. Build the example
2. Configure the server
3. Run the example

Build the example

1. Set up your development shell as described in Setting up your environment.

2. Execute the build script provided for this example in the samples\examples\iiop\rmi\server\wls directory of your WebLogic Server installation. The build script will do the following:
   1. Create the appropriate directory structure

   2. Run rmic to create the rmi class.

3. Compile the application to create the Ping class file

Configure WebLogic Server

Edit you config.xml or use the console to include PingImpl as a startup class:

    <StartupClass
      Arguments="tuxedo.corba.remote"
      ClassName="examples.iiop.rmi.server.wls.PingImpl"
      FailureIsFatal="false"
      Name="Pinger"
      Targets="examplesServer"
    />

Run the example

There are different client applications included in this example. Each requires different steps to build and execute. The following links contain information pertinent to each respective client. To demonstrate connectivity to a Tuxedo Server or to simply go through Tuxedo, build the Tuxedo Server portion of this example.

RMI Client

C++ Client (requires visibroker 4.1)

Tuxedo Server (requires Tuxedo 8.0)

There's more...

Read more about WebLogic RMI over IIOP in the Developer Guide, Using WebLogic RMI over IIOP.

Read more about WebLogic EJB in the Developer Guide, BEA WebLogic Server Enterprise JavaBeans.

Read more about WebLogic RMI in the Developer Guide, Using WebLogic RMI.

For more information on how to provide interoperability between WebLogic Server applications and Tuxedo services, see WebLogic Tuxedo Connector.