TUXEDO SALT实战教程
时间:2006-10-27 作者:李冬 浏览次数: <script src="http://203.81.25.103/cgi-bin/beadevcount.cgi?d_id=893" type="text/JavaScript" language="JavaScript"></script> 168 本文关键字:SOA, Web Services , SALT, GWWS, Web服务 |
SALT的架构
如图我们可以看到SALT相当于 TUXEDO 服务的一个代理,调用过程可以分解为如下几步:
- 接收所有的Web Service客户端的调用请求
- 把对应的SOAP请求转换成TUXEDO内部调用请求
- 分发给相应的TUXEDO SERVICE并接受处理结果
- 把结果转换成SOAP协议格式返回给客户端
因为SALT是一个本地的TUXEDO 服务,相比以前利用Web service访问TUXEDO Service的方法(比如利用WTC),它减少了转换的过程,提供了开发的效率,也提高了运行时处理的速度。
从上图我们还可以判断,SALT中的GATEWAY进程和以前/WS中的WSL和DOMAIN中的GWTDOMAIN进程功能类似,有着独立的监听端口。
但是在实际的使用过程中,发现SALT1.1的监听进程和实际业务处理过程并没有象/WS和DOMAIN那样设计,把监听进程和实际处理业务进 程分开,在/WS中是有WSL和WSH,在DOMAIN中是GWTDOMAI,GWADM,感觉以往TUXEDO的设计风格有些差别。SALT这种设计模 式在负载大的情况下可能存在弊端。不过SALT提供了启动多个GWWS提高性能的方法,算是另外一种弥补方式吧。
SALT的特性
- 配置驱动的部署模式(Configuration-Driven Deployment,这是BEA公司的官方说法):
SALT对于TUXEDO来说可以看程一个对Web Service的支持是外挂系统,即以前开发的服务程序不需要任何的改动。这个外挂系统只需要简单的配置就可以完成,不需要任何附加的编程工作,配置文件 是一个XML文件。SOAP XML文档与Tuxedo Typed Buffer之间实现的是自动转换。
- GWWS GATEWAY
上一节已经讲了GWWS的一些特性,这里在补充一些,GWWS在启动时加载自己的配置文件。这个过程包括读取XML配置文件,效验 (validating)配置文件,从Tuxedo Service 元数据注册文件(Metadata Repository)中加载对应的TUXEDO服务信息以及可靠WS传输(WS-ReliableMessaging)的规则定义文件。因此我们可以知 道GWWS可以在系统运行时期动态加载。
你还可以通过GWWS server下载WSDL文件。
- 异步调用和可靠消息传输
SALT提供了与WS-Adressing(WS-Addressing1.0)兼容的异步通信方式。还支持客户端和服务器端的可靠消息传输(WS-ReliableMessaging).
- 安全性
SALT使用TUXEDO的安全框架。在传输层可以使用HTTPS协议提高安全性。
最后要注意:SALT是单独的一个产品,需要单独购买,license也不包含在标准的license里面,需要单独下载。现在支持TUXEDO8.1以上的版本。
SALT支持的各种标准
数据传输:SOAP1.1; SOAP1.2, 带附件的SOAP协议。
Web Service注册: UDDI2.0
Web Service描述协议:WSDL1.1; WS-Policy
Web Service的架构:WS-Addressing,WS-ReliableMessaging
互操作性
通过SALT产生的WSDL文件,客户可用通过各种不同平台下的Web Service开发工具开发。下面是BEA官方在线文档提供的一个互操作性的一个表格,大家可以通过它简单了解一下SALT产品的互操作性。
WebLogic Server | Axis for Java 1.3 | WebLogic Workshop 8.1 | .Net 2.0 with WSE 3.0 | .Net 1.1 | |||
---|---|---|---|---|---|---|---|
9.1 | 8.1 | 9.2 | |||||
SOAP 1.1/DOC | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
SOAP 1.1/RPC | Yes | Yes | Yes | Yes | Yes | N/A | N/A |
SOAP 1.2/DOC | N/A | N/A | N/A | Yes | N/A | Yes | N/A |
SOAP 1.2/RPC | N/A | N/A | N/A | Yes | N/A | N/A | N/A |
WS-ReliableMessaging | Yes | N/A | N/A | N/A | N/A | N/A | N/A |
WS-Addressing | Yes | N/A | N/A | N/A | N/A | N/A | N/A |
说了太多的理论,下面详细介绍了SALT的具体安装配置调试的过程
安装过程
首先安装TUXEDO9.1, SALT也支持TUXEDO8.1。这里以TUXEDO 9.1为例介绍SALT的安装配置过程。
安装平台 Microsoft WINDOWS
在BEA网站下载BEA SALT1.1 for Tuxedo9.1,注意下载产品后,还要下载SALT的license,和JOLT类似,SALT是单独的产品,需要单独的license。
安装SALT需要注意的问题:
第一,要打上Tuxedo9.1 RP3以后的补丁,否则系统会提示无法安装SALT。补丁可以找BEA客户支持部免费提供(当然是有服务的客户)。 注意:TUXEDO8.1安装时也是需要补丁包的,补丁在WINDOWS系统要rolling patch 268以上,UNIX系统要rolling patch 265以上。
可以参考:http://edocs.bea.com/salt/docs11/relnotes/relnote.html#wp35631
第二,安装TUXEDO补丁时,在WINDOWS系统要手工停止BEA ProcMGR V9.1这个服务,否则补丁无法正常安装。安装补丁后,注意必须要重新启动这个服务。这个服务是BEA提供在WINDOWS平台下模拟UNIX IPC调用的关键进程。
方法:我的电脑 -> 管理 -> 服务 -> BEA ProcMGR V9.1。
运行salt11_tux91_32_win2k3_x86.exe,完成安装。
在安装完成后,会在TUXEDO安装目录下看到SALT的卸载文件。
配置实例:
利用TUXEDO自带的simpapp来配置。
步骤:
- 把%TUXDIR%/samples/salt/simpapp路径下的GWWS_conf.xml文件和mdrsimple.in文件拷贝到%TUXDIR%/samples/atmi/simpapp 路径下。
- 在ubbsimple的SERVERS段中加入
TMMETADATA SRVGRP=GROUP1 SRVID=2
CLOPT="-A -- -f mdrsimple.repos"
GWWS SRVGRP=GROUP1 SRVID=3
CLOPT="-A -- -c GWWS_conf.xml -iGWWS1"说明:SALT是TUXEDO的本地服务,所以在UBB中需要加入TMMETADATA和GWWS这两个服务进程。
- 在ubbsimple的MACHINES段中加入
MAXWSCLIENTS=3
- 编译TUXCONFIG
tmloadcf -y ubbsimple
- 通过如下命令来生成元数据注册文件(metadata repository)
tmloadrepos -i mdrsimple.in mdrsimple.repos
服务配置文件mdrsimple.in中定义了TUXEDO中的全部或者部分服务。这些服务通过mdrsimple.in这个注册文件声明为Web Service。
这个文件是运行环境中重要的一个配置文件。
这个例子中该文件内容如下:
service=ToUpperWS
export=y
servicetype=service
inbuf=STRING
outbuf=STRING
tuxservice=TOUPPER
param=name
type=string
access=inout
size=1000
我们可以看到这个文件定义了Web Service和TUXEDO服务的对应关系,参数类型和属性。
有关TUXEDO服务元数据注册文件的说明文档参看:http://edocs.bea.com/salt/docs11/metarepo.html
- 用你自己系统的网络环境把GWWS_conf.xml这个配置文件中#HOSTNAME# 和#GWWS-PORT# 替换掉。
GWWS_confi.xml是GWWS启动时读取的配置文件,GWWS的各个属性都在这个文件中定义,是一个很重要的配置文件。详细的说明可以参考:http://edocs.bea.com/salt/docs11/admin/config.html#wp1051710
<?xml version="1.0" encoding="UTF-8"?>
<Configuration xmlns="http://www.bea.com/Tuxedo/Salt/200606">
<Servicelist id="simpapp">
<Service name="ToUpperWS"/>
</Servicelist>
<Policy/>
<System/>
<WSGateway>
<GWInstance id="GWWS1">
<HTTP address="//dli01:8899"/>
</GWInstance>
</WSGateway>
</Configuration>- 编译simpapp服务进程
buildserver -o simpserv -f simpserv.c -s TOUPPER
- 启动simpapp
tmboot –y
试验环境执行结果如下:
D:/bea/tuxedo9.1/samples/atmi/simpapp>tmboot -y
Booting all admin and server processes in D:/bea/tuxedo9.1/samples/atmi/simpapp/
tuxconfig
INFO: BEA Tuxedo, Version 9.1, 32-bit, Patch Level 009
INFO: Serial #: 454493248242-2109518968823, Expiration 2007-01-15, Maxusers 100
INFO: Licensed to: BEA Evaluation Customer
Booting admin processes ...
exec BBL -A :
process id=5044 ... Started.
Booting server processes ...
exec simpserv -A :
process id=6084 ... Started.
exec TMMETADATA -A -- -f mdrsimple.repos :
process id=3336 ... Started.
exec GWWS -A -- -c GWWS_conf.xml -iGWWS1 :
process id=4372 ... Started.
4 processes started.我们可以看到TMMETADATA 和 GWWS这两个进程正常启动。
- 生成WSDL文件,
D:/bea/tuxedo9.1/samples/atmi/simpapp>tmwsdlgen -c GWWS_conf.xml -y -o simpapp.w
sdl -s rpc
INFO: BEA SALT, Version 1.1, 32-bit, Patch Level (none)
INFO: Serial #: 454493271161-2125730657968, Expiration 2006-11-25
INFO: Licensed to : BEA Evaluation Customer
Parse Configuration "GWWS_conf.xml" (10-10-2006 00:04:59:500)
Parse succeed (10-10-2006 00:04:59:531)
WSCFG_CAT:4: INFO: Configuration file parsing succeeded
WSCMD_CAT:9: INFO: WSDL file 'simpapp.wsdl' is generated.
在simpapp路径下回生成simpapp.wsdl文件,有了这个文件,就可以给各种Web Service客户端提供访问TUXEDO Web Service的接口定义文件了。
利用axis web service客户端来访问SALT
步骤
- 设置ant环境和axis环境
比较简单的办法是在安装weblogic的机器上随便找个域,运行senDomainenv.cmd,ant的环境就会自动设置ant所需的环境变量。
也可以利用ant的安装环境中的setEnv设置。
- 利用%TUXDIR%/samples/salt/simpapp/axisclient提供的文件。修改axis.properties文件。我的axis安装在“D:/apache/axis-1_3”。
我的axis.properties如下所示,注意要使用“//”双斜线。
AXIS_HOME=D://apache//axis-1_3
- 编译程序
/bin/ant compile
试验环境执行结果如下:
D:/bea/tuxedo9.1/samples/salt/simpapp/axisclient>ant compile Buildfile: build.xml init: compile: [wsdl2java] WSDL2Java D:/bea/tuxedo9.1/samples/salt/simpapp/simpapp.wsdl [copy] Copying 1 file to D:/bea/tuxedo9.1/samples/salt/simpapp/axisclient/b uild/work/com/bea/salt/examples/simpapp/axisclient [javac] Compiling 5 source files to D:/bea/tuxedo9.1/samples/salt/simpapp/ax isclient/build/classes [javac] 注意: D:/bea/tuxedo9.1/samples/salt/simpapp/axisclient/build/work/c om/bea/salt/examples/simpapp/axisclient/TuxedoWebServiceLocator.java 使用了未经 检查或不安全的操作。 [javac] 注意: 要了解详细信息,请使用 -Xlint:unchecked 重新编译。 [jar] Building jar: D:/bea/tuxedo9.1/samples/salt/simpapp/axisclient/build /simpapp.jar BUILD SUCCESSFUL Total time: 12 seconds- 执行客户端程序
/bin/ant run
试验环境执行结果如下:
D:/bea/tuxedo9.1/samples/salt/simpapp/axisclient>ant run
Buildfile: build.xml
run:
[java] Sent 'Hello World!'
[java] Got 'HELLO WORLD!'
BUILD SUCCESSFUL
Total time: 2 seconds
通过tmadmin的psr命令可以看到服务器端的调用情况
D:/bea/tuxedo9.1/samples/atmi/simpapp>tmadmin
tmadmin - Copyright (c) 1996-1999 BEA Systems, Inc.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
Tuxedo is a registered trademark.
> psr
Prog Name Queue Name Grp Name ID RqDone Load Done Current Service
--------- ---------- -------- -- ------ --------- ---------------
BBL.exe 123456 simple 0 0 0 ( IDLE )
simpserv.exe 00001.00001 GROUP1 1 1 50 ( IDLE )
TMMETADATA.exe 00001.00002 GROUP1 2 2 100 ( IDLE )
GWWS.exe 00001.00003 GROUP1 3 0 0 ( IDLE )
SALT的监控
在监控命令wsadmin模式下,查看当前配置命令:configstats(cstat)? -i InstanceID
该命令显示各项的含义如下
Config context id,GWWS进程使用的配置实例个数
Config Elapsed time,配置文件装载的时间
Current client number,当前使用这个配置文件的客户端(SOAP客户端)个数
max attaching time,配置实例绑定GWWS的最长时间
查看运行状态命令:gwstats(gws) -i InstanceID
该命令显示各项的含义如下
Request Response Done, 成功处理的客户端请求个数,即由GWWS服务进程成功处理后返回给web service客户端的完整处理过程。
Request Response Fail,处理失败的请求个数,失败的原因可能是非法的SOAP请求,TUXEDO内部错误,SOAP请求被拒绝。
Oneway Done,成功的把请求分发给TUXEDO服务的次数,
Oneway Fail,分发给TUXEDO服务失败的次数。
运行实际情况:
D:/bea/tuxedo9.1/samples/atmi/simpapp>wsadmin
wsadmin - Copyright (c) 2005-2006 BEA Systems, Inc.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
SALT is a registered trademark.
> cstat -i GWWS1
GWWS Instance : GWWS1
ctx id duration time clt num max attaching time
------ -------------------------- ------- --------------------------
0 0000(dd)01(hh)34(mm)05(ss) 0 0000(dd)00(hh)00(mm)00(ss)
> v
Verbose now on.
> cstat -i GWWS1
GWWS Instance : GWWS1
Config context id : 0
Config Elapsed time : 0000(dd)01(hh)36(mm)37(ss)
Current client number : 0
max attaching time : 0000(dd)00(hh)00(mm)00(ss)
> gwstats -i GWWS1
GWWS Instance : GWWS1
Request Response Done : 1
Request Response Fail : 0
Oneway Done : 0
Oneway Fail : 0
SALT的调优
GWWS的参数设置
- 线程池的大小:参数“thread_pool_size”,默认线程池大小是16,但是在某些业务负载比较大的应用中这个数目的线程显然无法满足 需要。 因此建议通过流量分析来设置适用的线程池大小。比如,一个并发客户数在500左右的应用中,建议你部署4个GWWS进程,每个进程的线程池设为64。
- 网络超时控制:“timeout”,这是一个网络超时调优参数,默认的超时为300秒。调整这个参数可以减少超时引发的错误。
- 最大的Content length控制:“max_content_length”,BEA SALT管理员可以限制客户端发送请求缓冲区的大小,对于基于HTTP的SOAP协议来说,也就是限制HTTP的content length的大小。默认情况下没有大小限制。
- Backlog控制:“max_backlog”,默认值为20。这个参数的含义我们可以通过实例来解释一下,在windows系统中,对于某个 端口的连接请求如果达到20,可能系统就认为超过了流量的限制(UNIX有系统参数控制,windows通过注册表项设置)。如果超过这个数目,新的客户 端连接请求在TCP握手阶段就会被系统拒绝掉。
这种情况下如果系统的峰值连接请求是80,那么为了保证没有请求会被系统拒绝,你就需要把backlog设置为60。
一般情况下,默认的20就能满足大多数系统的需要。只有在系统流量非常大的系统才需要调整该参数。同时调大该参数也增加了同步攻击(Syn-flood attack)的风险。
TUXEDO的BLOCKTIME
GWWS网络超时参数标识了一个请求在网络层消耗的最大时间,而BLOCKTIME则限定了一个请求在TUXEDO内部等待的最大时间。如果客户端请求进 入TUXEDO系统后,在BLOCKTIME的时间内请求没有处理完成,GWWS服务进程会给客户端返回一个SOAP的失败信息,同时关闭与客户端的网络 连接。BLOCKTIME在UBB配置的RESOURCE段。
使用多个GWWS进程提高性能
TUXEDO中最常用的一种提高吞吐量,服务器端处理能力的一种方法。如果GWWS成为了你系统的瓶颈,在物理资源允许(CPU,内存)的条件下,增加 GWWS进程的个数。使用多个GWWS需要注意的是,由于每个GWWS使用的是不同的访问端口,因此对于客户端来说每个GWWS都是不同的访问点。客户端 的配置就稍显繁琐。
小结
BEA公司提供的SALT是一种比JOLT, WTC更Service Orient的软件组件。SALT的出现使得TUXEDO产品可以更方便,更快捷的方式接入各种SOA平台,提高TUXEDO应用的整合能力。熟悉和了解 这个产品对广大TUXEDO开发人员管理员以及系统架构设计人员有着积极的意义。
参考文档
安装SALT: BEA SALT Installation Guide
SALT支持的平台:BEA SALT 1.1 Supported Platforms
配置SALT:BEA SALT Administration Guide and BEA SALT Reference Guide
通过SALT调用Web Service:BEA SALT Programming Web Services
SALT支持的业界规范: http://edocs.bea.com/salt/docs11/overview/over.html#wp1106298
作者简介 | |
李冬 dev2devid :woohoo ,技术顾问,系统架构师。曾就职于BEA公司,熟悉BEA公司TUXEDO,WEBLOGIC系列产品,对于多种开源的项目有深入的研究。 |