配置WebLogic Tuxedo Connector.doc

文檔說明：摘自iteye taiyuan的博客 /blog/37296 配置WebLogic Tuxedo Connector (轉(zhuǎn)) 博客分類： tuxedoWeblogic配置管理應(yīng)用服務(wù)器編程全文檢索 WebLogic Tuxedo Connector (WTC) 是一個兼容 JCA （ J2EE 連接器架構(gòu)）的軟件組件，它提供 Tuxedo 服務(wù)和 WebLogic Server 部署的企業(yè)應(yīng)用程序之間的互操作性。 WebLogic Server 組件能夠使用 WTC 與 Tuxedo 服務(wù)進行通信， Tuxedo 服務(wù)也能夠調(diào)交互用基于 WebLogic Server 的 EJB 。手動配置 WebLogic Tuxedo Connector 是非常沉悶乏味且易于出錯的操作，從這種觀點出發(fā)，本文提出了兩種編程式可選解決方案。第一種基于 JMX ，第二種基于對命令行方式的 weblogic.Admin 工具的使用。本文提供了 Java 類庫，既能生成所需的 JMX 對象又能生成基于 weblogic.Admin 的 shell 文件。Tuxedo 服務(wù)已經(jīng)存在多年了，而且很多 EIS （企業(yè)信息系統(tǒng)）就是以這種服務(wù)功能為基礎(chǔ)，比如事務(wù)支持、域和 ACL （訪問控制列表）安全、域級別故障轉(zhuǎn)移和反饋、以及高級消息服務(wù)。另一方面， J2EE 應(yīng)用程序不能保持與現(xiàn)有的信息系統(tǒng)隔離；它們必須能夠支持 Tuxedo 事務(wù)，在 CORBA Java 和 CORBA C+ 之間進行互操作，同時也要能夠在 Java RMI/IIOP 和 Tuxedo CORBA 之間互操作。WTC 實現(xiàn)了所有這些方案和一些其他可能類似 JATMI （ Java 應(yīng)用程序到事務(wù)監(jiān)控器接口）的實現(xiàn)方案，其中 JATMI 是一種與 Tuxedo ATMI 類似的協(xié)議。WTC 實現(xiàn)了所有這些方案和一些其他可能類似 JATMI （ Java 應(yīng)用程序到事務(wù)監(jiān)控器接口）的實現(xiàn)方案，其中 JATMI 是一種與 Tuxedo ATMI 類似的協(xié)議。說明了 Tuxedo 服務(wù)對于 EIS 的重要性，并說明了 WTC 在 EIS 和基于新技術(shù)的 J2EE 組件之間所起的關(guān)聯(lián)作用之后，本文的目標(biāo)是給出在 WebLogic Server 環(huán)境中幾個 WTC 配置的例子。事實上，為了雙向連接到 Tuxedo 域而對 WebLogic Server 進行配置以便使用 WTC 就是一件費力且易于出錯的事情，本文給出了兩種編程式配置解決方案。它們?yōu)榛?WebLogic Server 控制臺的方案提供了一種選擇，這也許是已知的最佳方法。兩種方案其中之一是以使用 weblogic.Admin 工具為基礎(chǔ)，并且必將令系統(tǒng)管理員受益。另一個方案是以 JMX （ Java Management Extension ）為基礎(chǔ)，并極有可能吸引開發(fā)人員的注意力。不論采用哪種方案， WTC 配置過程都基于下列一般步驟： 創(chuàng)建一個 WTC 服務(wù)。 創(chuàng)建一個本地 Tuxedo 訪問點。 創(chuàng)建一個遠(yuǎn)程 Tuxedo 訪問點。 導(dǎo)出服務(wù)。 導(dǎo)入服務(wù)。 為服務(wù)器分配新創(chuàng)建的 WTC 服務(wù)。在全文中，我們都將遵循這些步驟，并且我們將對在三個配置方案中分別執(zhí)行的方法進行強調(diào)。通過 WebLogic Server 控制臺配置 WTC這是為您的應(yīng)用程序配置 WTC 的標(biāo)準(zhǔn)方法。它包括了對 WebLogic Server 控制臺 GUI 的使用。雖然有很多優(yōu)點（其中最重要的是其簡單性），但這種方案也具有費力、重復(fù)、易錯等缺點。啟動 WebLogic Server 和它的管理控制臺之后，您可按照下列步驟來配置 WTC 服務(wù)。 創(chuàng)建WTC 服務(wù)。 在 Administration Console 屏中 ， 部署 Services 節(jié)點并單擊 WTC 。將顯示 WTC Services 屏。單擊 Configure a New WTC Service 超鏈接。新顯示的屏包括兩個文本域： WTC 服務(wù)的名字和它的部署優(yōu)先權(quán)順序。單擊 Create 按鈕來新建一個 WTC 服務(wù)。 創(chuàng)建本地 Tuxedo 訪問點。 確保已選中新建服務(wù)。單擊該服務(wù)頁的“ Content ”選項卡，并在新顯示的頁面中單擊“ Local Aps ”選項卡。要創(chuàng)建新的 Tuxedo 本地訪問點，單擊“ Configure a New Local Tuxedo Access Point ”超鏈接。在 Tuxedo 本地訪問點的“ General ”選項卡中，填寫域“ Access Point ”、“ Access Point ID ”和“ Network Address ”。其中第一個域是用戶選擇名，第二個和第三個域必須與 bdmconfig Tuxedo 配置文件的 DM_TDOMAIN 段相關(guān)聯(lián)。在同一屏的“ Connections ”選項卡中的默認(rèn)域值對于大多數(shù)情況都是適用的，除非當(dāng)前 Tuxedo 的版本是 6.5 版，則其中的“ Interoperate ”域必須為“ Yes ”。為了簡單起見，我們都假設(shè)本頁“ Security ”選項卡中的“ Security ”域為“ None ”，這意味著不需要任何基于用戶口令的驗證。 創(chuàng)建遠(yuǎn)程 Tuxedo 訪問點。 確保已選中新創(chuàng)建的服務(wù)。單擊該服務(wù)頁的“ Contents ”選項卡，并在新顯示的頁面中單擊“ Remote Aps ”選項卡。要創(chuàng)建新的 Tuxedo 遠(yuǎn)程訪問點，單擊“ Configure a New Remote Tuxedo Access Point ”超鏈接。在 Tuxedo 遠(yuǎn)程訪問點的“ General ”選項卡中，填寫域“ Access Point ”、“ Access Point ID ”、“ Local Access Point ”和“ Network Address ”。其中第一個域是用戶選擇名，第二個和第四個域必須與 bdmconfig Tuxedo 配置文件的 DM_TDOMAIN 段相關(guān)聯(lián)。第三個域必須是我們在先前步驟中所選擇的本地 Tuxedo 訪問點名。在同一屏的“ Connections ”選項卡中的默認(rèn)域值對于大多數(shù)情況都是適用的。為了簡單起見，我們將接受該頁的“ Security ”選項卡中的所有域的默認(rèn)值。 導(dǎo)出服務(wù)。 導(dǎo)出的 WTC 服務(wù)基本是部署在容器中的無狀態(tài)的會話 EJB ，也許將由 Tuxedo 服務(wù)調(diào)用。要導(dǎo)出服務(wù)，確保已選中新創(chuàng)建的服務(wù)。單擊該服務(wù)頁的“ Contents ”選項卡，并在新顯示的頁面中單擊“ Exported ”選項卡。要導(dǎo)出 WTC 服務(wù)，單擊“ Configure a New Exported Service ”超鏈接。在“ General ”選項卡中，“ Resource name ”域必須與 bdmconfig Tuxedo 配置文件的 DM_REMOTE_SERVICES 段相關(guān)聯(lián)。第二個域，“ Local Access Point ”，必須是我們在先前步驟中所選擇的本地 Tuxedo 訪問點名。下一個域，“ EJB Name ”，必須與相應(yīng)已部署的無狀態(tài)會話 bean 中的 weblogic-ejb-jar.xm 部署描述文件的 jndi-name 段有相同值。最后 ，“ Remote name ”域可不填，除非 bdmconfig Tuxedo 配置文件在 DM_REMOTE_SERVICES 段中提及 RNAME 參數(shù)；在這種情況下，這兩個值必須相關(guān)。 導(dǎo)入服務(wù)。 導(dǎo)入的 WTC 服務(wù)基本上是可由 WebLogic Server 部署組件調(diào)用的 Tuxedo 服務(wù)。要導(dǎo)入服務(wù)，確保已選中新創(chuàng)建的服務(wù)。單擊該服務(wù)頁的“ Contents ”選項卡，并在新顯示的頁面中單擊“ Imported ”選項卡。要導(dǎo)入 WTC 服務(wù)，單擊“ Configure a New Imported Service ”超鏈接。在“ General ”選項卡中，“ Resource name ”域必須與 bdmconfig Tuxedo 配置文件的 DM_LOCAL_SERVICES 段相關(guān)聯(lián)。第二個和第三個域分別是先前定義的本地和遠(yuǎn)程 Tuxedo 訪問點。最后 ，“ Remote name ”域可不填，除非 bdmconfig Tuxedo 配置文件在 DM_LOCAL_SERVICES 段中提及 RNAME 參數(shù)；在這種情況下，這兩個值必須相關(guān)。 為服務(wù)器分配新創(chuàng)建的服務(wù)。 確保已選中新創(chuàng)建的服務(wù)。單擊該服務(wù)頁的“ Target and Deploy ”選項卡，并在“ Targets ”域中，檢查與當(dāng)前服務(wù)器相關(guān)聯(lián)的框是否已選中。單擊“ Apply ”按鈕來將改動付諸實現(xiàn)。正如您所見，通過WebLogic Server管理控制臺來配置WTC的確是非常費力的，因為我們必須自己進行很多操作。另外，如果我們需要創(chuàng)建幾個這樣的WTC域，我們將不得不重復(fù)這些操作。這增加了在配置過程中犯錯的機會。在這種情況下，關(guān)于能創(chuàng)建基于WTC參數(shù)的新配置工具的想法顯得十分具有吸引力。通過 JMX 配置 WTC作為一個可對其進行完全管理的分布式資源，能夠通過 JMX （ Java Management Extension ）使 WebLogic Server 儀表化。這將通過 Mbean 服務(wù)器實現(xiàn)，它作為獨立 WebLogic 實例上的 Mbeans 的主機，允許客戶創(chuàng)建、訪問、檢索并修改 WebLogic 域分布對象（比如 JDBC 連接池、 JMS 服務(wù)器、目的地和工廠）。從 WTC 的角度出發(fā)，你能夠通過創(chuàng)建新的特定 WTCMbeans 來創(chuàng)建新 WTC 域。在以編程的方式創(chuàng)建并處理 WebLogic 分布對象的過程中，我們既可以使用 JMX 標(biāo)準(zhǔn)類的接口（由向 Mbean 傳遞操作名和一系列參數(shù)來調(diào)用 Mbean 的操作組成），也可以使用 WebLogic 的類型安全實現(xiàn)（它為每個 Mbean 類型提供了獨立接口）。因為 WebLogic 域可能分布在多個計算機上，這些計算機具有不同部署，而且資源的目標(biāo)各不相同，所以每個 WebLogic 實例的 Mbean 服務(wù)器將擁有三個不同的 Mbeans 集： 對公開資源配置的屬性和操作的 Mbeans 進行配置 運行時的 Mbeans 提供關(guān)于資源運行狀態(tài)的信息 Security Mbeans 提供對 WebLogic 的安全框架的直接訪問提到WTC域時，我們將集中在配置Mbeans上。這種類型的Mbeans擁有對所有托管資源（如web服務(wù)器、集群、JDBC連接池和更多的包括WTC域在內(nèi)的資源）的配置。WebLogic 實例上的 Mbean 服務(wù)器能夠通過 weblogic.management.MbeanHome 接口到達(dá)?？梢垣@得以下 home 接口的兩種實現(xiàn)： Local Home 接口提供對本地 Mbeans 的訪問， Mbeans 位于 Mbean 服務(wù)器上，且屬于當(dāng)前的 WebLogic Server 實例。 Administration Home 接口，僅向管理服務(wù)器開放，提供對特定的管理服務(wù)器 Mbeans 和其他所有由托管服務(wù)器宿主的 Mbeans 的訪問。 Home接口既能通過查找服務(wù)器的JNDI樹檢索，又能通過WebLogic特定的幫助類檢索。例如，以下代碼對本地home接口進行檢索： import weblogic.management.*;MBeanHome localHome = (MBeanHome)Helper.getMBeanHome(username,password, url, serverName);以上代碼調(diào)用 Helper 類的 getMBeanHome() 方法，向它傳遞用戶名、密碼、 WebLogic Server URL 和服務(wù)器名。類似地，要檢索管理 home 接口，則調(diào)用相同 Helper 類的 getAdminMBeanHome 方法，但只需向其傳送用戶名、密碼和管理服務(wù)器 URL ，如下例所示：清單 2 檢索管理 home 接口 import weblogic.management.*;MBeanHome localHome = (MBeanHome)Helper.getAdminMBeanHome(username, password, url);使用 JNDI （ Java 命令目錄接口）也同樣容易。本地和管理返回地址存儲在 MBeanHome.LOCAL_JNDI_NAME 常量和 MBeanHome.ADMIN_JNDI_NAME 常量中。以下代碼示例顯示了如何進行：清單 3 使用 JNDI 檢索本地 home 接口。 Hashtable ht = new Hashtable();ht.put (Context.INITIAL_CONTEXT_FACTORY,weblogic.jndi.WLInitialContextFactory);ht.put(Context.PROVIDER_URL, t3:/adminserver:8001);InitialContext ic = new InitialContext (ht);MBeanHome localHome = (MBeanHome)ic.lookup (MBeanHome.LOCAL_JNDI_NAME);我們已經(jīng)能夠檢索本地 / 管理接口，接下來將查看怎樣在 JMX 中實現(xiàn)配置 WTC 域所需的 6 步。 創(chuàng)建 WTC 服務(wù)。這可通過使用 home 接口的 createAdminMBean() 方法，并向其傳遞新的 WTC 域名、要創(chuàng)建的 Mbean 的類型和當(dāng)前 WebLogic Server 域名來實現(xiàn)。 清單 4 創(chuàng)建 WTC 服務(wù)。 WTCServerMBean wtcServerMBean = homeMBean.createAdminMBean (myWTCDomain, WTCServer, myWebLogicServerDomain); 創(chuàng)建本地 Tuxedo 訪問點。要實現(xiàn)那個目標(biāo)我們需要創(chuàng)建另一個 WTCLocalTuxDom 類型的管理 Mbean ，并設(shè)置其訪問點、訪問點 ID 、網(wǎng)絡(luò)地址、連接策略和安全屬性，同時還要將其作為先前創(chuàng)建的 WTCServer Mbean 的組件添加。 清單 5 創(chuàng)建本地 Tuxedo 訪問點。 WTCLocalTuxDomMBean wtcLocalTuxDomMBean = (WTCLocalTuxDomMBean) homeMBean.createAdminMBean(myLocalTuxDom,WTCLocalTuxDom, getWebLogicDomainName(); wtcLocalTuxDomMBean.setAccessPoint(getLocalAccessPointName(); wtcLocalTuxDomMBean.setAccessPointId(getLocalAccessPointId(); wtcLocalTuxDomMBean.setNWAddr(getLocalNetworkAddress(); wtcLocalTuxDomMBean.setConnectionPolicy(ON_DEMAND); wtcLocalTuxDomMBean.setSecurity(NONE); wtcServerMBean.addLocalTuxDom(wtcLocalTuxDomMBean); 創(chuàng)建遠(yuǎn)程 Tuxedo 訪問點。要實現(xiàn)那個目標(biāo)我們需要創(chuàng)建另一個 WTCRemoteTuxDom 類型的管理 Mbean ，并設(shè)置其訪問點、訪問點 ID 、網(wǎng)絡(luò)地址和本地訪問點屬性，同時還要將其作為先前創(chuàng)建的 WTCServer Mbean 的組件添加。 清單 6 創(chuàng)建遠(yuǎn)程 Tuxedo 訪問點。 WTCRemoteTuxDomMBean wtcRemoteTuxDomMBean = (WTCRemoteTuxDomMBean) homeMBean.createAdminMBean(myRemoteTuxDom, WTCRemoteTuxDom, myWebLogicServerDomain); wtcRemoteTuxDomMBean.setAccessPoint (myRemoteAccessPoint); wtcRemoteTuxDomMBean.setAccessPointId(myRemoteAccessPointId); wtcRemoteTuxDomMBean.setNWAddr(myRemoteNetworkAddress); wtcRemoteTuxDomMBean.setLocalAccessPoint(myLocalTuxDom); wtcServerMBean.addRemoteTuxDom(wtcRemoteTuxDomMBean); 導(dǎo)出服務(wù)。要實現(xiàn)那個目標(biāo)我們需要創(chuàng)建另一個 WTCExport 類型的管理 Mbean ，并設(shè)置其資源名、本地訪問點和 JNDI 名屬性，同時還要將其作為先前創(chuàng)建的 WTCServer Mbean 的組件添加。 清單 7 導(dǎo)出服務(wù)。 WTCExportMBean wtcExportMBean = (WTCExportMBean) homeMBean.createAdminMBean (myRemoteTuxDom, WTCExport, myWebLogicServerDomain); wtcExportMBean.setResourceName (myExportedResource); wtcExportMBean.setLocalAccessPoint (myLocalTuxDom); wtcExportMBean.setEJBName (myResourceJndiName); wtcServerMBean.addExport(wtcExportMBean); 導(dǎo)入服務(wù)。要實現(xiàn)那個目標(biāo)我們需要創(chuàng)建另一個 WTCImport 類型的管理 Mbean ，并設(shè)置其資源名、本地訪問點和遠(yuǎn)程訪問點列表屬性，同時還要將其作為先前創(chuàng)建的 WTCServer Mbean 的組件添加。 清單 8 導(dǎo)入服務(wù)。 WTCImportMBean wtcImportMBean = (WTCImportMBean) homeMBean.createAdminMBean (myRemoteTuxDom,WTCImport, myWebLogicServerDomain); wtcImportMBean.setResourceName (myImportedResource); wtcImportMBean.setLocalAccessPoint (myLocalAccessPoint); wtcImportMBean.setRemoteAccessPointList (myRemoteAccessPoint); wtcServerMBean.addImport(wtcImportMBean); 為服務(wù)器分配新創(chuàng)建的服務(wù)?，F(xiàn)在所有的管理對象已經(jīng)創(chuàng)建好，我們只需定位我們的 Mbean 服務(wù)器。 WTCServerMBean 類的 addTarget() 方法代表這一過程的完成。注意我們通過調(diào)用 home 接口的 getMBeanServer() 方法來檢索 MBean 服務(wù)器實例的這一方法。 清單 9 為服務(wù)器分配 WTC 服務(wù)。 wtcServerMBean.addTarget (TargetMBean)homeMBean.getMBeanServer();使用 weblogic.Admin 工具配置 WTCweblogic.Admin 是一個能用于編寫 WebLogic Server 腳本的 Java 工具。因為 weblogic.Admin 能夠操縱 JMX 數(shù)據(jù)，所以將它用來配置 WTC 域也許會比較簡便。在我們能夠使用 weblogic.Admin 工具配置 WTC 域前，我們必須理解 WebLogic 是怎樣對其 Mbeans 進行命名的。每個由 Mbean 服務(wù)器宿主的 Mbean 都擁有獨一無二的名稱，并且每個名稱都使用 JMX ObjectName 類的實例構(gòu)建，它們擴展了 ObjectName 來攜帶附加信息。 Mbean 的名字遵循以下格式：:Name=,Type=,Location=* where: is the name of the WebLogic domain to which the MBean server belongs is the name of the resource associated with the MBean is the name of the MBean is the name of the server hosting the MBean server and are name-value pairs for MBean attributes現(xiàn)在讓我們看一下怎樣通過該工具配置 WTC 域。 創(chuàng)建 WTC 服務(wù)。 java weblogic.Admin -url t3:/localhost:8001 -username weblogic -password weblogic CREATE -mbean myDomain:Name=myWtcService,Type=WTCServer 創(chuàng)建本地 Tuxedo 訪問點。 java weblogic.Admin . CREATE -mbean myDomain:Name=myLoclTuxDom, Type=WTCLocalTuxDom,WTCServer=myWtcService java weblogic.Admin . SET -mbean myDomain:Name=myLoclTuxDom,Type=WTCLocalTuxDom,WTCServer=myWtcService -property AccessPoint MyLclAccessPt -property AccessPointId MyLclAccessPtId -property NWAddr /footse:9010 -property ConnectionPolicy ON_DEMAND -property Security NONE java weblogic.Admin . SET -mbean myDomain:Name=myWtcService,Type=WTCServer -property LocalTuxDoms myDomain:Name=myLoclTuxDom,Type=WTCLocalTuxDom, WTCServer=myWtcService 創(chuàng)建遠(yuǎn)程 Tuxedo 訪問點。 java weblogic.Admin . CREATE -mbean myDomain:Name=myRemoteTuxDom, Type=WTCRemoteTuxDom,WTCServer=myWtcService java weblogic.Admin . SET -mbean myDomain:Name=myRemoteTuxDom,Type=WTCRemoteTuxDom,WTCServer=myWtcService -property AccessPoint MyRemoteAccessPt -property AccessPointId MyRemoteAccessPtId -property NWAddr /footse:9020 -property LocalAccessPoint MyLclAccessPt java weblogic.Admin . SET -mbean myDomain:Name=myWtcService,Type=WTCServer -property RemoteTuxDoms myDomain:Name=myRemoteTuxDom,Type=WTCRemoteTuxDom, WTCServer=myWtcService 導(dǎo)出服務(wù)。 java weblogic.Admin . CREATE -mbean myDomain:Name=myExportedResources, Type=WTCExport,WTCServer=myWtcService java weblogic.Admin . SET -mbean myDomain:Name=myExportedResources,Type=WTCExport, WTCServer=myWtcService -property ResourceName myExportedService -property EJBName myServiceJNDIName -property