weblogic与tuxedo配置详解.doc

一、WTC配置步骤：
1. Tuxedo的配置
2.1.1. 设置环境变量:
rem (c) 2003 BEA Systems, Inc. All Rights Reserved.
rem Copyright (c) 2000 BEA Systems, Inc.
rem All Rights Reserved

rem THIS IS UNPUBLISHED PROPRIETARY SOURCE CODE OF
rem BEA Systems, Inc.
rem The copyright notice above does not evidence any
rem actual or intended publication of such source code.

rem Copyright (c) 2000 BEA Systems, Inc.
rem All rights reserved
rem ident "@(#) apps/simpapp/setenv.cmd $Revision: 1.5 $"

set TUXDIR=c:\bea\tuxedo8.1
set WSNADDR=\\192.168.57.41:8888
set APPDIR=c:\tuxedo_test\simpapp
set PATH=%TUXDIR%\bin;%APPDIR%;%PATH%
set TUXCONFIG=%APPDIR%\tuxconfig
set BDMCONFIG=%APPDIR%\bdmconfig

2.1.3. 配置ubbconfig
# (c) 2003 BEA Systems, Inc. All Rights Reserved.
#ident "@(#) samples/atmi/simpapp/ubbsimple $Revision: 1.5 $"

#Skeleton UBBCONFIG file for the TUXEDO Simple Application.
#Replace the <bracketed> items with the appropriate values.

*RESOURCES
IPCKEY 123456

#Example:
#IPCKEY 123456

DOMAINID simpapp
MASTER simple
MAXACCESSERS 50
MAXSERVERS 50
MAXSERVICES 50
MODEL SHM
LDBAL N

*MACHINES
DEFAULT:
APPDIR="c:\tuxedo_test\simpapp"
TUXCONFIG="c:\tuxedo_test\simpapp\tuxconfig"
TUXDIR="c:\bea\tuxedo8.1"
#Example:
# APPDIR="/home/me/simpapp"
# TUXCONFIG="/home/me/simpapp/tuxconfig"
# TUXDIR="/usr/tuxedo"

VM44 LMID=simple
MAXWSCLIENTS=5 #指定的最大客户端连接数

#Example:
#beatux LMID=simple

*GROUPS
GROUP1 LMID=simple GRPNO=1 OPENINFO=NONE
JSLGRP LMID=simple GRPNO = 2
JREPGRP LMID=simple GRPNO = 3
GROUP4 LMID=simple GRPNO=4 OPENINFO=NONE

*SERVERS
DEFAULT:
CLOPT="-A"

simpserv SRVGRP=GROUP1 SRVID=1
WSL SRVGRP=GROUP1 SRVID=5 CLOPT="-A -t -- -n //192.168.57.41:8888 -m 2 -M 5 -x 10" #WSL发布地址
JREPSVR SRVGRP=JREPGRP SRVID=10 CLOPT="-A -- -W -P C:\bea\tuxedo8.1\udataobj\jolt\repository\jrepository"
JSL SRVGRP=JSLGRP SRVID=15 CLOPT="-A -- -n //192.168.57.41:7777 -M 5 -x 10 -m 2"
DMADM SRVGRP=GROUP4 SRVID=20
GWADM SRVGRP=GROUP4 SRVID=30
GWTDOMAIN SRVGRP=GROUP4 SRVID=40

*SERVICES
TOUPPER
红色为jolt服务需要的配置，jolt需要单独的license。
蓝色为wtc服务需要的配置。

2.1.4. 编译ubbconfig文件
tmloadcf -y ubbconfig

2.1.5. 配置domconfig
*DM_RESOURCES
VERSION=U22
*DM_LOCAL_DOMAINS

TDOM1 GWGRP=GROUP4
TYPE=TDOMAIN
DOMAINID="TDOM1"
BLOCKTIME=20
MAXDATALEN=56
MAXRDOM=89
DMTLOGDEV="c:/tuxedo_test/simpapp/TLOG"
AUDITLOG="c:/tuxedo_test/simpapp/AUDITLOG"
DMTLOGNAME="DMTLOG_TUXDOM"

*DM_REMOTE_DOMAINS
TDOM2 TYPE=TDOMAIN
DOMAINID="TDOM2"

*DM_TDOMAIN
TDOM1 NWADDR="//192.168.57.41:9998"
TDOM2 NWADDR="//192.168.57.41:9999"

*DM_REMOTE_SERVICES
TOLOWER RDOM="TDOM2"

*DM_LOCAL_SERVICES
TOUPPER RNAME="TOUPPER"
红色为tuxedo为接入的weblogic的IP地址。（因此对于新接入的weblogic，tuxedo需要增加配置）。

2.1.6. 编译domconfig
dmloadcf -y domconfig

2. Weblogic配置(9.2为例)
2.1.7. 配置config.xml
<wtc-server>
<name>MyWTCServer</name>
<target>examplesServer</target>
<wtc-local-tux-dom>
<name>LocalAP-n0</name>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<nw-addr>//192.168.57.41:9999</nw-addr>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<name>RemoteAP-n0</name>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<local-access-point>TDOM2</local-access-point>
<nw-addr>//192.168.57.41:9998</nw-addr>
<federation-url></federation-url>
<federation-name></federation-name>
</wtc-remote-tux-dom>
<wtc-import>
<name>WTCImportedService-0</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>TDOM2</local-access-point>
<remote-access-point-list>TDOM1</remote-access-point-list>
<remote-name>TOUPPER</remote-name>
</wtc-import>
<wtc-tbridge-global xsi:nil="true"></wtc-tbridge-global>
</wtc-server>

或通过控制台进行配置：
新增一个WTC Server

配置WTC Server（红框中的是需要配置的）

配置Local AP（IP和端口为weblogic的IP和端口，Name和ID最好设置成一样的）

配置Remote AP（IP和端口为Tuxedo的IP和端口，并制定一个Local AP）

配置Import（resources和remote name最好一致，并等于tuxedo中配置的）

配置好了之后可以看到WTC Server的control中已经有connection和service了。

并且在context的jndi tree中可以看到tuxedo.services.TuxedoConnection。

3. Weblogic做客户端，访问Tuxedo服务（一个jsp）

<%@ page import="weblogic.wtc.jatmi.*,weblogic.wtc.gwt.*, javax.naming.*,java.sql.*" %>
hello
<%
String inStr = "hello,hello";
String outStr = "";

try
{
//调用接口服务
Context ctx = new InitialContext();
TuxedoConnectionFactory cdmaTuxedoFactory = (TuxedoConnectionFactory) ctx.lookup("tuxedo.services.TuxedoConnection");
TuxedoConnection cdmaTuxedo = cdmaTuxedoFactory.getTuxedoConnection();
TypedString cdmaData = new TypedString(inStr);
Reply cdmaRtn = cdmaTuxedo.tpcall("TOUPPER", cdmaData, 0);
cdmaData = (TypedString) cdmaRtn.getReplyBuffer();
outStr = cdmaData.toString();
cdmaTuxedo.tpterm();
out.println("out = "+outStr);
}
catch(Exception e)
{
outStr = e.getMessage();
e.printStackTrace();

//out.println("<!--");
StringWriter sw = new StringWriter();
PrintWriter pw = new PrintWriter(sw);
e.printStackTrace(pw);
out.print(sw);
sw.close();
pw.close();
//out.println("-->");

}
%>
上面jsp执行结果为：

以上为在weblogic 9.2上的配置过程，在weblogic 8.1上也可以配置wtc。
Weblogic 8.1中的config.xml相关部分如下：
<WTCServer Name="MyWTC Service" Targets="examplesServer">
<WTCRemoteTuxDom AccessPoint="TDOM1" AccessPointId="TDOM1"
LocalAccessPoint="TDOM2" NWAddr="//192.168.57.41:9998" Name="WTCRemoteTuxDom-1256118443265"/>
<WTCImport LocalAccessPoint="TDOM2"
Name="WTCImport-1256118583093" RemoteAccessPointList="TDOM1"
RemoteName="TOUPPER" ResourceName="TOUPPER"/>
<WTCLocalTuxDom AccessPoint="TDOM2" AccessPointId="TDOM2"
NWAddr="//192.168.57.41:9999" Name="WTCLocalTuxDom-1256180229577"/>
</WTCServer>

如果出现错误，可以同时检查weblogic日志和tuxedo日志，看错误原因。

二、 添加一个jolt服务（需要jolt liccense）
1. Tuxedo的配置
下载支持jolt的licence。

下载后解压，将文件名改为lic.txt，然后拷贝到TUXEDO_HOME\udataobj目录下面就可以了。我的TUXEDO_HOME是C:\bea\tuxedo8.1。
拷贝完成后license马上生效。

其他配置方法，在下面WTC配置步骤的红色部分已经标出。
2. 测试Tuxedo配置是否正确。
利用tuxedo自带工具检查jolt服务是否工作正常。
C:\bea\tuxedo8.1\udataobj\jolt>appletviewer RE.html

2. WebLogic端配置（weblogic9.2没有配通，用weblogic 8.1.6完成配置）
编辑：C:\bea\weblogic81\samples\domains\examples\startExamplesServer.cmd

CLASSPATH=C:\bea\weblogic81\server\lib\webservices.jar;%POINTBASE_CLASSPATH%;%CLIENT_CLASSES%;%SERVER_CLASSES%;%COMMON_CLASSES%;%CLIENT_CLASSES%\utils_common.jar;c:\joltwls.jar;c:\joltjse.jar;c:\jolt.jar
红色jar为C:\bea\tuxedo8.1\udataobj\jolt下的三个jar包。

配置jolt连接池

下面三个红框类的参数设置一下。名称随便取一个，地址为jsl的地址，target选择当前的web应用。

3.设置启动类和停止类。

将启动的和停止类分别设置为：
bea.jolt.pool.servlet.weblogic.PoolManagerStartUp
bea.jolt.pool.servlet.weblogic.PoolManagerShutDown

重启，完成weblogic配置。

3. 增加jsp调用

<%@ page import="weblogic.wtc.jatmi.*,weblogic.wtc.gwt.*, javax.naming.*,java.sql.*" %>
<%@page import="bea.jolt.pool.SessionPoolManager"%>
<%@page import="bea.jolt.pool.servlet.ServletResult"%>
<%@page import="bea.jolt.pool.servlet.ServletSessionPool"%>
<%@page import="weblogic.utils.http.QueryParams"%>
<%@page import="weblogic.servlet.internal.ServletRequestImpl"%>
<%@page import="bea.jolt.pool.servlet.ServletResult"%>

hello
<%
String inStr = "hello,hello";
String outStr = "";

try
{

//调用jolt接口服务
SessionPoolManager b_mgr = SessionPoolManager.poolmgr;

out.println("<BR/>b_mgr = " + b_mgr);

ServletSessionPool servletSessionPool = (ServletSessionPool) b_mgr.
getSessionPool("joltconnpool");

out.println("<BR/>servletSessionPool = " + servletSessionPool);

ServletResult servletResult = servletSessionPool.call("TOUPPER",
request, null);
String result = (String) servletResult.getValue("STRING", 0, "");
out.println("<BR/>result = " + result);
}
catch(Exception e)
{
outStr = e.getMessage();
e.printStackTrace();

out.println("<!--");
StringWriter sw = new StringWriter();
PrintWriter pw = new PrintWriter(sw);
e.printStackTrace(pw);
out.print(sw);
sw.close();
pw.close();
out.println("-->");

}
%>

效果截图：

由于，weblogic 9.2中没有weblogic.server.Server导致jolt的启动类加载不成功，所以改用weblogic 8.1.6完成配置。

附录：
Tuxedo安装license例子和远程客户端配置（转）
摘要：本文总结了Tuxedo的安装、license、例子运行和远程客户端配置四个主要问题，给出了一篇真正可用的Tuxedo入门教程。
Tuxedo是一个很好的交易中间件，包含消息中间件等功能，历史悠久，功能强大，是由BEA开发的，不过现在属于Oracle了。网上的Tuxedo入门教程千千万万，几乎没有一个可用的。尤其是在licsence和远程客户端配置这两个问题上，都没有交代清楚。很符合中国的IT教程特色：“懂得人看得懂，但是并没有更懂；不懂的人更加不懂了！”。
本文集中讨论了四个问题：
l         Tuxedo的安装；
l         SDK和RTC的License；
l         Simpapp例子
l         远程客户端配置
好了，开始吧，我的开发环境如下，如果开发环境不同，也许本教程不适合你：
l         Tuxedo8.1
l         VC6
l         服务器：windows XP
l         客户端：Windows XP（VMWARE上）
本文的源代码在这里，你也许要根据下面的教程修改后才能成功运行：

1.      Tuxedo8.1安装
Tuxedo8.1下载地址如下：
Microsoft Windows (32 bit) 
下载完成后直接双击就可以安装了，可以选择安装服务器或者客户端。安装的时候需要选择bea的home目录和Tuxedo的目录，都可以采用默认配置。服务端还需要指定tlisten密码。其他都暂时不需要配置，包括license都可以留到后面配置。
2.      License
Tuxedo的license分为SDK和RTC两种，SDK即开发版，RTC即发布版。我刚开始就是得到了一个RTC，兴高采烈的run例子的时候编译不过，告诉我“你没有一个合法的SDK license”。其实bea已经公布了所有的license，直接去官方网站下载就可以了，不要到处找所谓的无限制xx license，Tuxedo8.1的SDK license地址如下：

下载后解压，将文件名改为lic.txt，然后拷贝到TUXEDO_HOME\udataobj目录下面就可以了。我的TUXEDO_HOME是C:\bea\tuxedo8.1。
拷贝完成后license马上生效。
3.      Simpapp例子
Simpapp是Tuxedo自带的一个简单例子，只有服务器版本带有例子程序。我的例子在C:\bea\tuxedo8.1\samples\atmi\simpapp。将该例子拷贝到另外一个目录，例如：C:\tuxedo_test\simpapp。
例子中有如下几个文件：
l         README和README.NT，是说明文件，但是我认为说得不详细，起码license和远程客户端配置就没说清楚；
l         setenv.cmd，设置环境变量的批处理文件；
l         ubbsimple，Tuxedo的应用程序配置文件，它会被编译为二进制的配置文件，所有服务端程序都需要该配置文件；
l         simpapp.nt，makefile文件，用来编译服务器和客户端程序；
l         simpcl.c，客户端源程序；
l         simpserv.c，服务端源程序；
要编译运行Simpapp例子，需要六个步骤：1）设置环境变量；2）修改编译配置文件；3）编译源程序；4）启动服务；5）运行客户端；6）关闭服务。
注意：这是本地客户端的步骤，若是远程客户端，还有一些变动。
设置环境变量
首先，把本文的系统相关变量列举如下，大家要根据自己的情况在下面的各种配置文件中更改：
Tuxedo目录：C:\bea\tuxedo8.1
Tuxedo应用程序目录：C:\tuxedo_test\simpapp
服务器IP：192.168.222.1
客户端IP：192.168.222.2
修改setenv.bat文件：其解释已经在源代码中
rem 设置TUXEDO目录
set TUXDIR=C:\bea\tuxedo8.1
rem 设置TUXEDO应用程序目录
set APPDIR=C:\tuxedo_test\simpapp
rem 设置系统path
set PATH=%TUXDIR%\bin;%APPDIR%;%PATH%
rem 设置TUXEDO应用程序配置文件
set TUXCONFIG=%APPDIR%\tuxconfig
然后打开一个windows控制台，将目录变更为tuxedo应用程序所在目录，即C:\tuxedo_test\simpapp，运行setenv.bat。
C:\tuxedo_test\simpapp>setenv
修改编译配置文件
在修改配置文件前，先得到自己的计算机名称，运行：
C:\tuxedo_test\simpapp>echo %computername%
就可以得到自己的计算机名称，一般都是大写的。
Ubbsimple是本程序（即simpapp）的配置文件，将其修改为：
*RESOURCES
IPCKEY     123496  #这个数字可以自己定

DOMAINID   simpapp
MASTER     simple
MAXACCESSERS  10
MAXSERVERS 5
MAXSERVICES   10
MODEL   SHM
LDBAL   N

*MACHINES
DEFAULT:
     APPDIR="C:\tuxedo_test\simpapp"
     TUXCONFIG="C:\tuxedo_test\simpapp\tuxconfig"
     TUXDIR="C:\bea\tuxedo8.1"

"WXB" LMID=simple    #注意，把”WXB”改成自己的计算机名称

*GROUPS
GROUP1
  LMID=simple GRPNO=1 OPENINFO=NONE

*SERVERS
DEFAULT:
     CLOPT="-A"

simpserv   SRVGRP=GROUP1 SRVID=1

*SERVICES
TOUPPER
配置文件是Tuxedo中最繁琐的部分，稍有不对服务就无法发布和执行，所以一定要仔细检查。目前不需要太多了解，按我写的做就可以了。注意，配置文件和源程序的编译链接无关，只和服务发布相关，客户端也不需要配置文件。
修改完配置文件后，就需要将其编译为二进制的配置文件，其名称和目录由系统变量TUXCONFIG决定，该变量已经在setenv.bat中设置了，此处是C:\tuxedo_test\simpapp\\tuxconfig，这个tuxconfig就是服务用来发布时的二进制配置文件。
编译配置文件：
C:\tuxedo_test\simpapp>tmloadcf -y ubbsimple
若成功完成，则会生成tuxconfig。
编译源程序
使用makefile的方式编译源程序，这里我使用的是vc6自带的nmake命令，要确保你的vc相关目录已经正确在windows的path变量中设置。Makefile文件已经写好，不需要更改，即simpapp.nt。执行命令如下：
C:\tuxedo_test\simpapp>nmake -f simpapp.nt
当然，如果你不熟悉makefile，那么可以使用如下两个命令别分编译客户端和服务端，其实这两条命令是我从simpapp.nt中抄出来的：
buildclient       -o simpcl -f simpcl.c
buildserver -s TOUPPER -o simpserv -f simpserv.c
若成功，则可发现在目录下出现了simpcl.exe和simpserv.exe文件。
启动服务
启动服务非常easy，如果你前面都做对了的话：
C:\tuxedo_test\simpapp>tmboot -y
启动成功后会告诉你，两个进程已经成功启动。
运行客户端
如下命令：
C:\tuxedo_test\simpapp>simpcl "hello,wenwen"
Returned string is: HELLO,WENWEN
客户端会将一个字符串传送给服务器，服务器返回该字符串的大写形式。为什么是“hello,wenwen”而不是“hello,tuxedo”呢？嗯，因为写到这儿的时候刚好雯雯到我身边来了。
关闭服务
关闭服务很容易，而且不会失败：
C:\tuxedo_test\simpapp>tmshutdown –y
4.      远程客户端配置
好了，重点终于来了。毕竟对于大部分人来说，用中间件就是为了使用远程客户端，本地客户端只是玩玩而已嘛。远程客户端需要服务器端修改一些配置，远程客户端也要进行一些配置。
服务器端
要编译运行Simpapp例子，使其能够为本地客户端提供服务，需要六个步骤：1）设置环境变量；2）修改编译配置文件；3）编译源程序；4）启动服务；5）运行客户端；6）关闭服务。
要编译运行Simpapp例子，使其能够为远程客户端提供服务，需要六个步骤：1）设置环境变量；2）修改编译配置文件；3）编译远程客户端源程序；4）启动服务；5）运行远程客户端；6）关闭服务。
为了不让读者出错，我还是用最详细的方式把这些步骤都完成写一遍，当然，与上面不同的部分会用红色标注出来。
（1）设置环境变量
再次修改seten.bat文件：
rem 设置TUXEDO目录
set TUXDIR=C:\bea\tuxedo8.1
rem 设置WSN地址和端口
set WSNADDR=\\192.168.222.1:8888
rem 设置TUXEDO应用程序目录
set APPDIR=C:\tuxedo_test\simpapp
rem 设置系统path
set PATH=%TUXDIR%\bin;%APPDIR%;%PATH%
rem 设置TUXEDO应用程序配置文件
set TUXCONFIG=%APPDIR%\tuxconfig
注意，其中加入了WSN地址和端口的配置，地址就是本服务器IP地址，端口可以随意指定，只要不冲突就好。
运行setenv
C:\tuxedo_test\simpapp>setenv
（2）修改编译配置文件
再次修改ubbsimple
*RESOURCES
IPCKEY     123496        #这个数字可以自己定

DOMAINID   simpapp
MASTER     simple
MAXACCESSERS  10
MAXSERVERS 5
MAXSERVICES   10
MODEL   SHM
LDBAL   N

*MACHINES
DEFAULT:
     APPDIR="C:\tuxedo_test\simpapp"
     TUXCONFIG="C:\tuxedo_test\simpapp\tuxconfig"
     TUXDIR="C:\bea\tuxedo8.1"

"WXB" LMID=simple         #注意，把"WXB"改成自己的计算机名称
MAXWSCLIENTS=5    #指定的最大客户端连接数

*GROUPS
GROUP1
  LMID=simple GRPNO=1 OPENINFO=NONE

*SERVERS
DEFAULT:
     CLOPT="-A"

simpserv   SRVGRP=GROUP1 SRVID=1
WSL SRVGRP=GROUP1 SRVID=5 CLOPT="-A -t -- -n //192.168.222.1:8888  -m 2 -M 5 -x 10"   #WSL发布地址

*SERVICES
TOUPPER
仅仅增加了两行代码，即最大客户端连接数和WSL的发布地址。其具体意义可以看书，这个倒是很多书都说清楚了。
编译配置文件：
C:\tuxedo_test\simpapp>tmloadcf -y ubbsimple
（3）编译远程客户端源程序
上面已经编译了服务端和本地客户端程序，远程客户端程序的编译下节再说。
（4）启动服务
同上。不过这次会启动三个进程，其中一个是WSL。Look：
C:\tuxedo_test\simpapp>tmboot -y
Booting all admin and server processes in C:\tuxedo_test\simpapp\tuxconfig
INFO: BEA Tuxedo, Version 8.1
INFO: Serial #: 454493271161-2671077484631, Expiration NONE, Maxusers 1000000
INFO: Licensed to: Customer
Booting admin processes ...
exec BBL -A :
        process id=2556 ... Started.
Booting server processes ...
exec simpserv -A :
        process id=3564 ... Started.
exec WSL -A -t -- -n //192.168.222.1:8888 -m 2 -M 5 -x 10 :
        process id=760 ... Started.
3 processes started.
（6）运行远程客户端
下面详细交代。
（7）关闭服务
同上。
远程客户端
运行远程客户端需要三个步骤：1）设置环境；2）修改编译远程客户端程序；3）运行。
首先，将如下文件拷贝到远程客户端计算机：
l         Setenv.bat
l         Simplecl.c
l         Simpapp.nt
（1）设置环境
根据远程客户端的系统相关配置修改setenv.bat，注意WSNADDR要和服务器的一致：
rem 设置TUXEDO目录
set TUXDIR=C:\bea\tuxedo8.1
rem 设置WSN地址和端口
set WSNADDR=\\192.168.222.1:8888
rem 设置TUXEDO应用程序目录
set