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系列产品，对于多种开源的项目有深入的研究。 | |
| | |
8096
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
