Note: | For more detailed information on how to configure the Oracle WebLogic Tuxedo Connector for this Oracle WebLogic Server release, see the Oracle WebLogic Tuxedo Connector Administration Guide. |
The following sections describe how to use the Oracle WebLogic Server console to configure Oracle WebLogic Tuxedo Connector to allow Oracle WebLogic Server to interoperate with Tuxedo Releases 6.5 and higher:
For this release of Oracle WebLogic Tuxedo Connector (WTC), samples are available on the Oracle Technology Network website. Create a wtc
directory within the samples directory of your WebLogic Server installation. Download the WTC samples 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 Administration Console:
Note: | You may want to enable tracing to monitor Oracle WebLogic Tuxedo Connector. See Monitoring the Oracle WebLogic Tuxedo Connector. |
Use the following steps to build the simpapp
example:
SAMPLES_HOME\domains\examples\setExamplesEnv.cmd
file. SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpapp
directory. wtc_toupper.jar
file using ant. This will deploy the EJB on Oracle WebLogic Server. Enter the following command: ant
SAMPLES_HOME\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
wtc_tolower.jar
and wtc_toupper.jar
are deployed. Use the following steps to create and configure a WTC service using the Oracle WebLogic Server Console:
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:
Network Address: the network address and port of your local access point
Example: //123.123.123.123:5678
Use the following steps to configure a remote Oracle Tuxedo access point:
Network Address: the network address and port of your remote access point
Example: //123.123.123.123:1234
Use the following steps to configure an exported service:
EJB Name: tuxedo.services.TOLOWERHome
Use the following steps to configure an imported service:
Remote Access Point List: myRemoteAP
Use the following steps to register TDOM1 as an Oracle WebLogic Server user:
Use the following steps to configure your Oracle Tuxedo domain:
simpapp
example from your Oracle Tuxedo installation and create a working Oracle Tuxedo simpapp
directory.simpapp
directory. setEnv.cmd
located at TUXDIR. Update the following parameters:
TUXDIR - base directory of the TUXEDO Software
APPDIR - base directory of the sample program
buildclient -o simpcl -f simpcl.c
buildserver -o simpserv -f simpserv.c -s TOUPPER
ubbdomain
and dom1config
files from the SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpapp
directory to your Oracle Tuxedo simpapp
directory.tolower.c
file from the SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpserv
directory to your Oracle Tuxedo simpapp
directory. ubbdomain
for your Oracle Tuxedo environment. This includes setting the pathnames for APPDIR
, TUXCONFIG
, and TUXDIR
and setting the machine name. Replace all <braced>
items with information for your environment. APPDIR="\home\me\simpapp"
TUXCONFIG="\home\me\simpapp\tuxconfig""
TUXDIR="\usr\tuxedo"
ubbdomain
file: tmloadcf -y ubbdomain
dom1config
for your Oracle Tuxedo environment. This includes creating log devices and updating the network addresses. DMTLOGDEV="d:\my_apps\tlog"
AUDITLOG="d:\my_apps\aud"
TDOM1 NWADDR="//TuxedoMachine:1234"
TDOM2 NWADDR="//WTCMachine:5678"
dom1config
file. set BDMCONFIG=d:\mydomain\simpapp\bdmconfig
dmloadcf -y dom1config
tolower
client buildclient -f tolower.c -o tolower
tmboot -y
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, SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpapp
directory to invoke the TOUPPER EJB
and connect to the Oracle Tuxedo TOUPPER
service. 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