环境更改和注意事项的概要
本部分提供在可以开始使用 WebLogictuxedo Connector 之前必须对 Tuxedo 和 WebLogic Server 环境进行的更改的概述。
Tuxedo 更改
注意：有关 Tuxedo 域的详细信息，请参阅tuxedo文档

Tuxedo 用户需要进行以下环境更改：
如果现有 Tuxedo 应用程序已在使用 Tuxedo /T DOMAINS，则必须针对每个与 WebLogic Tuxedo Connector 实例的连接将新域添加到域配置文件中。
如果现有 Tuxedo 应用程序不使用域，则必须将域服务器添加到该应用程序的 TUXCONFIG 中。必须使用与 WebLogic Tuxedo Connector 实例相对应的 Tuxedo /T Domain 条目新建 DMCONFIG。
WebLogic Tuxedo Connector 要求 Tuxedo 域始终使编码处于打开状态。MTYPE 应是未设置的，或设置为 NULL，或设置为与 DMCONFIG 文件中 DM_LOCAL_DOMAINS 部分中的 MTYPE 不同的值。
WebLogic Server 更改
以下部分描述使用 WebLogic Tuxedo Connector 时所需进行的 WebLogic Server 更改：
管理和编程
WebLogic Server 用户需要进行以下环境更改：
创建 Java 客户端或服务器。
使用 WebLogic Server 控制台、命令行界面或 WLST 来配置 WebLogic Tuxedo Connector。
如果 WebLogic Tuxedo Connector ACL 策略设置为 Local，那么，是否可访问本地服务将不取决于 CredentialPolicy。Tuxedo 远程域 DOMAINID 必须作为本地 WebLogic Server 用户进行身份验证。
WebLogic Server 线程
从网关调度服务时，可用的客户端线程数可能会限制运行的并发服务数。对于此版本的 WebLogic Tuxedo Connector，没有���何 WebLogic Tuxedo Connector 特性可以增加可用线程数。调用服务 EJB 时，请使用合理的线程模型。您可能需要将可用 WebLogic Server 线程数增加到较大的值。
注意：WTC 服务器将三个线程外加一个线程用于每个已定义的本地访问点。

为应用程序配置 WebLogic Tuxedo Connector
注意：确定何时定位 WTC 服务是很重要的。由于存在对运行时 MBean 的支持，因此，可在部署之后修改配置。tBridge 中有一个例外。对 tBridge Global 和 tBridge Redirect 的更改在取消部署 WTC 并重新部署 WTC 之前将不会生效。

本部分提供有关如何配置 WebLogic Tuxedo Connector 以使 WebLogic Server 应用程序和 Tuxedo 应用程序可以进行互操作的信息。
WebLogic Tuxedo Connector MBean 类
使用管理控制台配置 WebLogic Tuxedo Connector
使用命令行界面配置 WebLogic Tuxedo Connector
设置 WebLogic Server 环境
如何设置 WebLogic Tuxedo Connector 属性
WebLogic Tuxedo Connector 配置准则
WebLogic Tuxedo Connector MBean 类

WebLogic Tuxedo Connector 使用 MBean 描述 WebLogic Server 和 Tuxedo 之间的连接性的信息，并使用安全协议处理 WebLogic Server 和 Tuxedo 之间的服务请求。这些配置参数类似于在 Tuxedo 域之间进行通信时所需的互操作性特性。配置参数存储在 WebLogic Server config.xml file 中。下表列出了用于配置 WebLogic Tuxedo Connector 的 MBean 类型：
MBean 类型描述
WTCServer包含在 WebLogic Server 和 Tuxedo 之间进行连接时所需的互操作性特性的父 Mbean。请在使用管理控制台进行配置时定义您的 WTC 服务。
WTCLocalTuxDom提供配置信息以便将可用的远程 Tuxedo 域连接到 WTC 服务。您必须至少配置一个 Tuxedo 访问点。请在使用管理控制台进行配置时定义您的本地 Tuxedo 访问点。
注意：由于配置是动态的，因此可创建和部署空的 WTC 服务。

WTCRemoteTuxDom提供配置信息以便将 WTC 服务连接到可用的远程 Tuxedo 域。您可以配置多个远程域。请在使用管理控制台进行配置时定义您的远程 Tuxedo 访问点。
WTCExport提供由本地 Tuxedo 访问点导出的服务的相关信息。请在使用管理控制台进行配置时定义您的导出服务。
WTCImport提供有关在远程域上导入并可用的服务的相关信息。请在使用管理控制台进行配置时定义您的导入服务。
WTCResources指定域的全局字段表类、视图表类及应用程序密码。请在使用管理控制台进行配置时定义您的资源。
对 MBSTRING 的支持是使用 RemoteMBEncoding 和 MBEncodingMapFile 特性提供的
WTCPassword指定用于域间身份验证的配置信息。请在使用管理控制台进行配置时定义您的密码。
WTCtBridgeGlobal为 WebLogic Server 和 Tuxedo 之间的消息传输指定全局配置信息。请在使用管理控制台进行配置时定义您的 Tuxedo 队列桥。
WTCtBridgeRedirect指定 WebLogic Server 与 Tuxedo 之间的消息的来源、目标、方向和传输。请在使用管理控制台进行配置时定义您的 Tuxedo 队列桥重定向。

使用管理控制台配置 WebLogic Tuxedo Connector
通过管理控制台，可以配置、管理和监视 WebLogic Tuxedo Connector 连接性。要显示用于执行这些任务的选项卡，请完成以下步骤：
启动管理控制台。
在左侧窗格中找到“互操作性”节点，然后展开“WTC 服务”。
创建或修改要配置的 WTC 服务器。
按“联机帮助”中的说明进行操作。
下表显示了一些连接性任务，这些任务是以您执行它们的典型顺序列出的。您可以更改该顺序；只是要记住，在关联或分配对象之前，必须先对其进行配置。
使用命令行界面配置 WebLogic Tuxedo Connector
命令行界面提供了创建和管理 WebLogic Tuxedo Connector 连接的方法。
设置 WebLogic Server 环境
需要通过运行位于 WL_HOME\samples\domains\examples的 setExamplesEnv 脚本来设置 WebLogic Server 应用程序的环境。
- Windows 用户：运行 setExamplesEnv.cmd
- UNIX 用户：运行 setExamplesEnv.sh
如果是首次设置环境，则需要查看脚本中的设置。必要时使用以下步骤针对您的应用程序环境修改这些设置：
从命令行将目录更改为 WebLogic Server 应用程序的位置。将位于 WL_HOME\samples\domains\examples 的 setExamplesEnv 脚本复制到您的应用程序目录。
使用文本编辑器（如 vi）编辑 setExamplesEnv 脚本。
- Windows 用户：编辑 setExamplesEnv.cmd
- UNIX 用户：编辑 setExamplesEnv.sh
保存文件。
如何设置 WebLogic Tuxedo Connector 属性
PasswordKey 和 encoding 都是 WebLogic Server 属性。如果需要设置这些属性，请在服务器启动脚本中更新 JAVA_OPTIONS 变量。示例：
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey设置 PasswordKey

使用 PasswordKey 可指定 weblogic.wtc.gwt.genpasswd 实用工具用来对密码进行加密的密钥：
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey其中，mykey 是密钥值。
设置 encoding
要在 WebLogic Server 和 Tuxedo 应用程序之间传输非 ascii（多字节）字符串，必须配置 WebLogic Tuxedo Connector 以提供字符集转换。WebLogic Tuxedo Connector 使用 WebLogic Server 属性来匹配由 WebLogic Tuxedo Connector 服务中指定的所有 Tuxedo 远程域使用的编码。如果需要同时运行多个编码集，那么您需要在不同的 WebLogic Server 实例中运行 WebLogic Tuxedo Connector 服务。
要启用字符集转换，请在您的服务器启动脚本中更新 JAVA_OPTIONS。示例：
JAVA_OPTIONS=-Dweblogic.wtc.encoding=codesetname其中，codesetname 是由远程 Tuxedo 域使用的受支持代码集的名称。
您可能无法选择确切的编码名来匹配远程域��用的编码。在此情况下，应选择与远程域等同的编码名。
示例：
支持的编码列表包括 EUC_JP
远程域受使用 eucJP 的 Solaris 操作系统支持
虽然名称没有完全匹配，但是，EUC_JP 和 eucJP 是等同的编码集，它们可在 WebLogic Server 和您的远程域之间提供正确的字符串转换。应将 encoding 属性设置为 EUC_JP：
JAVA_OPTIONS=-Dweblogic.wtc.encoding=EUC_JP设置用户数据的转储
要启用用户数据的转储，请将以下行添加到 java.weblogic.Server 命令中。
JAVA_OPTIONS=-Dweblogic.debug.DebugWTCUData=true启用它会使用户数据在连接了连接之后进行转储。如果未启用其他调试属性，则这将是除常规 WTC 错误/信息性消息之外转储的唯一 WTC 信息。转储可从 WLS 服务器日志文件中获得。
转储具有以下格式。
对于出站消息
Outbound UDATA: buffer type (<type>, <subtype>)+++++ User Data(size) +++++......对于入站消息
Inbound UDATA: buffer type (<type>, <subtype>)+++++ User Data(size) +++++......例如，WLS 客户端将数据“strings”发送到类型为 STRING 的缓冲区，然后，Tuxedo TOUPPER 服务会将其转换为“STRINGS”。WLS 服务器日志会显示以下转储。
Outbound UDATA: buffer type (STRING, null)+++++ User Data(16) +++++00 00 00 07 73 74 72 69 6E 67 73 00 00 00 00 00 ....strings.....+++++ END +++++Outbound UDATA: buffer type (String, null)+++++ User Data(12) +++++00 00 00 07 53 54 52 49 4E 47 53 00 ....STRINGS.+++++ END +++++系统级调试设置
由于不赞成使用 TraceLevel，因此，请使用系统调试。默认情况下，所有调试跟踪都处于关闭状态。使用以下设置可打开调试跟踪。
对于跟踪 WTC-CORBA 运行时
-Dweblogic.debug.DebugWTCCorbaEx=true对于跟踪 WTC-GWT 运行时
-Dweblogic.debug.DebugWTCGwtEx=true对于跟踪 WTC-JATMI 运行时
-Dweblogic.debug.DebugWTCJatmiEx=true对于跟踪 WTC-tBridge 运行时
-Dweblogic.debug.DebugWTCtBridgeEx=true对于跟踪 WTC 配置运行时
-Dweblogic.debug.DebugWTCConfig=trueWebLogic Tuxedo Connector 配置准则
配置 WebLogic Tuxedo Connector 时，请使用以下准则：
在配置中可以有多个 WTC 服务。
不能将 2 个或多个 WTC 服务定位到同一服务器。一个服务器只能是一个 WTC 服务的目标。
选定目标服务器后在 WTC 服务中实现的某些配置将不会在目标服务器实例中更新。必须从该服务器删除该 WTC 服务，然后将更新的 WTC 服务添加到目标服务器。例如，对 tBridge 进行的更改要求您取消部署 WTC 服务器，然后对其进行部署以使配置更改生效。但是，某些配置更改（如 KeepAlive、KeepAliveWait 和 RetryInterval）会在您激活更改时生效。