This chapter includes the following sections:
For this release of Oracle WebLogic Tuxedo Connector (WTC), samples are available on the Oracle Technology Network web site. Create a wtc
directory within the samples directory of your WebLogic Server installation. Extract the contents of the wtc_90.tar
to this directory. To run the samples referenced in this document, you must download the simpapp and simpserv samples.
Note:
This section summarizes how to configure the Oracle WebLogic Tuxedo Connector on a Windows platform. UNIX users can adapt the instructions by making appropriate substitutions such as replacing the "\" with "/" and ".cmd" with ".sh".
This example extends the Oracle Tuxedo simpapp
application to run over Oracle Tuxedo Domains (TDomains). This allows clients of the TOUPPER
service to run on either the Oracle Tuxedo server or the Oracle WebLogic Server examplesServer
. The example provides the following services:
TOUPPER
: An Oracle Tuxedo service that converts a string to upper case. A Oracle WebLogic Server client invokes the TOUPPER EJB
and connects to the Oracle Tuxedo TOUPPER
service.
Tolower
: A service implemented by an EJB in Oracle WebLogic Server. The client for the Tolower
service runs on Oracle Tuxedo.
The following sections describe how to configure Oracle WebLogic Tuxedo Connector using the WebLogic Server Administration Console:
Note:
You may want to enable tracing to monitor Oracle WebLogic Tuxedo Connector. See Monitoring the WebLogic Tuxedo Connector.
Use the following steps to build the simpapp
example:
ORACLE_HOME
\user_projects\domains\wl_server\setExamplesEnv.cmd
file.ORACLE_HOME
\wlserver\samples\server\examples\src\examples\wtc\atmi\simpapp
directory. See Sample Applications and Code Examplesin Understanding Oracle WebLogic Server.wtc_toupper.jar
file using ant. This will deploy the EJB on Oracle WebLogic Server. Enter the following command: ant
ORACLE_HOME
\\wlserver\samples\server\examples\src\examples\wtc\atmi\simpserv
directory.wtc_tolower.jar
file. This will deploy the EJB on Oracle WebLogic Server. Enter the following command: ant
http://your_machine:7001/console
. Replace your_machine
with the IP address for your machine or your machine name.wtc_tolower.jar
and wtc_toupper.jar
are deployed.Use the following steps to create and configure a WTC server using the Oracle WebLogic Server Administration Console:
mySimpapp
Note:
When configuring the Network Address for a local access point, the port number used should be different from any port numbers assigned to other processes. Example: Setting the Network Address to //mymachine:7001
is not valid if the Oracle WebLogic Server listening port is assigned to //mymachine:7001
.
Use the following steps to configure a local Oracle Tuxedo access point:
In the WebLogic Server Administration Console, expand Interoperability and select WTC Servers.
On the WTC Servers page, select the name of a WTC server, such as mySimpapp, to access the settings page.
Select Configuration > Local APs.
Enter the following values for the fields on the WTC Local Access Points page:
Access Point: myLocalAp
AccessPoint ID: TDOM2
Network Address: the network address and port of your local access point
Example: //123.123.123.123:5678
Click OK.
If you are connecting to a Tuxedo 6.5 domain, do the following:
Select Connections.
Set the Interoperate field to Yes.
Click Save.
Use the following steps to configure a remote Oracle Tuxedo access point:
Use the following steps to register TDOM1 as an Oracle WebLogic Server user:
Click Security Realms in the navigation tree.
Click myRealm.
Select Users and Groups.
Click Users.
Click Lock & Edit.
Click New.
In the Create a New User page, do the following:
Add TDOM1 in the Name field.
Enter and confirm a password.
Click OK.
Click Release Configuration.
Run each client to demonstrate interoperability between Oracle Tuxedo and Oracle WebLogic Server.
Start an Oracle WebLogic Server client from the directory location to which you downloaded the samples. For example, ORACLE_HOME
\wlserver\samples\server\examples\src\examples\wtc\atmi\simpapp
directory to invoke the TOUPPER EJB
and connect to the Oracle Tuxedo TOUPPER
service. See Sample Applications and Code Examples in Understanding Oracle WebLogic Server. Use the following command:
ant simpapp
The Oracle Tuxedo service replies to your Oracle WebLogic Server application with:
Buildfile: build.xml simpapp: run_client: [java] Beginning statefulSession.Client... [java] Creating Toupper [java] converting HelloWorld [java] converted to: HELLOWORLD [java] End statefulSession.Client... BUILD SUCCESSFUL
Run the tolower
client from the Oracle Tuxedo simpapp
directory to invoke the Tolower EJB and return the results to the client. Use the following command:
tolower ALLSMALL
The Oracle WebLogic Server service replies to your Oracle Tuxedo client with:
Returned string is: allsmall