Oracle® Fusion Middleware Oracle WebLogic Server Tuxedo Connector管理ガイド 11g リリース1 (10.3.5) B55553-03 |
|
前 |
次 |
以下の節では、WebLogic ServerアプリケーションとTuxedo環境の間の接続とサービスの管理方法について説明します。Oracle WebLogic Tuxedo Connectorでは、Tuxedoアクセス・ポイント間の通信に必要な相互運用属性に類似した属性を使用します。
管理コンソールまたはWLSTスクリプト言語を使用して、個々の接続を動的に表示、開始、および停止できます。提供されているツールを使用してWTCサーバー接続を開始および停止する方法については、以下の節を参照してください。
管理コンソールを使用して、Oracle WebLogic Tuxedo Connector接続を開始および停止できます。WTCサーバー接続を開始および停止する方法については、管理コンソール・オンライン・ヘルプを参照してください。
listConnectionsConfigured()
属性を使用して構成された接続を表示したり、startConnection()
属性を使用して個々の接続を開始したり、stopConnection()
属性を使用して個々の接続を停止したりできます。個々の接続を動的に管理する方法については、『Oracle Fusion Middleware Oracle WebLogic Scripting Toolガイド』を参照してください。
WebLogic Scripting Tool (WLST)でlistConnectionsConfigured()
属性を使用して、ドメインの接続を動的に表示できます。cmo.listConnectionsConfigured()
を実行すると、DSessConnInfo
構造の配列への参照が返されます。これは、次のようにローカルのWLST変数に格納するのが便利です。
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured()
各DSessConnInfo
インスタンスには、ローカル・アクセス・ポイントID、リモート・アクセス・ポイントID、およびステータス(ブール型、true = 接続、false = 非接続)があります。例:
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getLocalAccessPointId() WLSDOM wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getRemoteAccessPointId() TUXDOM wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected() 0
WebLogic Scripting Tool (WLST)でstartConnection()
属性を使用して、アクセス・ポイントの個々の接続を動的に開始できます。
1つのローカル・アクセス・ポイントと1つのリモート・アクセス・ポイントの間の接続を開始するには、引数に両方のアクセス・ポイントIDを指定します。例:
cmo.startConnection('WLSDOM','TUXDOM')
1つのローカル・アクセス・ポイントとすべての関連するリモート・アクセス・ポイントの間の接続を開始するには、引数にローカル・アクセス・ポイントIDを指定します。例:
cmo.startConnection('WLSDOM')
WebLogic Scripting Tool (WLST)でstopConnection()
属性を使用して、アクセス・ポイントの個々の接続を動的に停止できます。
1つのローカル・アクセス・ポイントと1つのリモート・アクセス・ポイントの間の接続を停止するには、引数に両方のアクセス・ポイントIDを指定します。例:
cmo.stopConnection('WLSDOM','TUXDOM')
所定のローカル・アクセス・ポイントに関連するすべての接続を停止するには、引数にローカル・アクセス・ポイントIDを指定します。例:
cmo.stopConnection('WLSDOM')
次のコード・リストは、WLSTを使用して接続を動的に表示、開始、および停止する例です。
例4-1 接続の動的な表示、開始、および停止
java weblogic.WLST wls:/offline> connect('weblogic','weblogic') wls:/mydomain/serverConifg> cd('WTCServers') wls:/mydomain/serverConfig/WTCServers> cd('myWTC') wls:/mydomain/serverConfig/WTCServers/myWTC> cd('LocalTuxDoms') wls:/mydomain/serverConfig/WTCServers/myWTC/LocalTuxDoms> ls() dr-- TDOM2 wls:/mydomain/serverConfig/WTCServers/myWTC/LocalTuxDoms> cd('../../..') wls:/mydomain/serverConfig> serverRuntime() wls:/mydomain/serverRuntime> cd('WTCRuntime') wls:/mydomain/serverRuntime/WTCRuntime> cd('WTCService') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getLocalAccessPointId() TDOM2 wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getRemoteAccessPointId() TDOM1 wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected() 0 wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.startConnection('TDOM2','TDOM1') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected() 1 wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.stopConnection('TDOM2','TDOM1') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected() 0 wls:/mydomain/serverRuntime/WTCRuntime/WTCService> disconnect() wls:/offline> exit()
WebLogic Scripting Tool (WLST)を使用して、構成属性を動的に変更できます。
次のコード・リストは、setInteroperate()
属性を変更する例です。
例4-2 構成属性の変更
java weblogic.WLST wls:/offline> connect('weblogic','weblogic') wls:/mydomain/serverConifg> edit() wls:/mydomain/edit> startEdit() wls:/mydomain/edit> cd("WTCServers/myWTC") wls:/mydomain/edit/WTCServers/myWTC> cd("LocalTuxDoms") wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms> cd("TDOM2") wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> cmo.setInteroperate("Yes") wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> validate() wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> showChanges() Changes that are in memory and saved to disc but not yet activated are: MBean Changed : mydomain:Name=TDOM2,Type=WTCLocalTuxDom,WTCServer=myWTC Operation Invoked : modify Attribute Modified : Interoperate Attributes Old Value : No Attributes New Value : Yes Server Restart Required : false wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> save() wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> activate(block="true") wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> disconnect() wls:/offline> exit()
WebLogic Server管理コンソールまたはWLSTを使用して、特定のWTCサーバー上のサービスを中断および再開できます。WTCサーバー上でインポートされたサービスが中断されると、WTCサーバーに送信された、そのサービスに対するすべてのJATMIクライアント・リクエストは、TPException.TPENOENTを送出して即座に返されます。明示的に再開されるまで、そのサービスは使用可能になりません。
中断されているエクスポートされたサービスに割り当てられた、TuxedoクライアントからWTCへのサービス・リクエストの場合、そのサービス・リクエストは実際のサービスを呼び出すことなくTPENOENTを出して返されます。すでに受信されたサービス・リクエストや処理中のサービス・リクエストは引続き処理され、中断操作の影響を受けません。
WTCサービスを動的に中断および再開する方法については、「WTCサービスの動的な中断と再開」を参照してください。
提供されているツールを使用してWTCサービスを中断および再開する方法については、以下の節を参照してください。
管理コンソールを使用して、Oracle WebLogic Tuxedo Connectorサービスを中断および再開できます。WTCサービスを中断および再開する方法については、管理コンソール・オンライン・ヘルプを参照してください。
WLSTでWTCRuntimeMBeanを介して、Oracle WebLogic Tuxedo Connectorサービスを中断および再開できます。サービスのステータスをチェックすることもできます。
サービスのステータスを判別するには、引数にSvcName
、LDOM
、またはRDomList
を指定します。例:
int WTCService.getServiceStatus(String SvcName)
この場合、対象となるWTCサーバーのSvcName
という名前を持つすべてのインポートされたサービスおよびエクスポートされたサービスのステータスが返されます。'SvcName'
という同じリソース名を持つインポートされたサービスまたはエクスポートされたサービスが複数ある場合、そのうち少なくとも1つのサービスが使用可能であれば、ステータスはAVAILABLE
が返されます。'SvcName'
という同じリソース名を持つインポートされたサービスまたはエクスポートされたサービスが複数あり、中断されているサービスと使用不能なサービスが混在している場合、ステータスはSUSPENDED
が返されます。すべてのサービスが使用不能の場合、ステータスはUNAVAILABLE
が返されます。一致するサービスが見つからない場合は、TPException.TPENOENT
が送出されます。
返されるステータスの有効な値を表4-1に示します。
WTCサーバーによって公開されているインポートされたサービスまたはエクスポートされたサービスを中断できます。管理者によって中断されているサービスは、WTCサーバーが再デプロイされるか、WLSサーバーが再起動されるか、またはサービスが管理者によって再開されるときにのみ使用可能になります。
使用可能なサービスを中断するには、引数にSvcName
、LDOM
、またはRDomList
を指定します。例:
Void WTCRuntimeMBean.suspendService(String SvcName, boolean isImported)
この場合、指定された名前を持つすべてのインポートされたサービスまたはエクスポートされたサービスが中断されます。isImported
がtrueの場合はインポートされたサービスのみが中断され、falseの場合はエクスポートされたサービスのみが中断されます。一致するサービスが見つからない場合は、TPException.TPENOENT
が送出されます。
WTCサーバーによって公開されている、ステータスがSUSPENDEDのインポートされたサービスまたはエクスポートされたサービスを再開できます。管理者によって中断されているサービスは、WTCサーバーが再デプロイされるか、WLSサーバーが再起動されるか、またはサービスが管理者によって再開されるときにのみ使用可能になります。
中断されているサービスを再開するには、引数にSvcName
、LDOM
、またはRDomList
を指定します。例:
void WTCRuntimeMBean.resumeService(String SvcName)
この場合、対象となるWTCサーバーのSvcName
という名前を持つすべてのインポートされたサービスおよびエクスポートされたサービスが再開されます。一致するサービスが見つからない場合は、TPException.TPENOENT
が送出されます。
WebLogic Server管理コンソールまたはWLSTを使用して、特定のWTCサーバー上のサービスを中断および再開できます。WTCサーバー上でインポートされたサービスが中断されると、WTCサーバーに送信された、そのサービスに対するすべてのJATMIクライアント・リクエストは、TPException.TPENOENTを送出して即座に返されます。明示的に再開されるまで、そのサービスは使用可能になりません。
動的なステータスはインポートされたサービスのみに適用されます。使用可能な、またはその可能性のあるTDomainセッションが少なくとも1つあれば、インポートされたサービスはAVAILABLEになります。使用可能なTDomainセッションがない場合にのみ、SUSPENDEDになります。WTCRemoteTuxDom
の接続ポリシー解決がON_DEMAND
の場合、TDomainセッションは存在しなくても常に使用可能です。WTCRemoteTuxDom
の接続ポリシー解決がINCOMING_ONLY
またはON_STARTUP
の場合、TDomainセッションは、接続が確立され、そのTDomainセッションが存在するときのみ使用可能になります。
次のコード・リストは、WLSTを使用して接続を動的に表示、開始、および停止する例です。
例4-3 サービスの動的な中断および再開
java weblogic.WLST wls:/offline> connect('weblogic','weblogic','t3://localhost:7001') wls:/mydomain/serverConfig> serverRuntime() wls:/mydomain/serverRuntime> cd('WTCRuntime/WTCService') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> ls() -r-- Name WTCService -r-- ServiceStatus weblogic.wtc.gwt.DServiceInfo[weblogic.wtc.gwt.DServiceInfo@1947a96] -r-- Type WTCRuntime -r-x getServiceStatus Integer : String(java.lang.String),String(java.lang.String),String(java.lang.String) -r-x getServiceStatus Integer : String(localAccessPoint),String(svcName) -r-x getServiceStatus Integer : String(localAccessPoint),String(svcName),Boolean(isImport) -r-x getServiceStatus Integer : String(svcName) -r-x getServiceStatus Integer : String(svcName),Boolean(isImport) -r-x listConnectionsConfigured weblogic.wtc.gwt.DSessConnInfo[] : -r-x resumeService Void : String(localAccessPoint),String(remoteAccessPointList),String(svcName) -r-x resumeService Void : String(localAccessPoint),String(svcName) -r-x resumeService Void : String(localAccessPoint),String(svcName),Boolean(isImport) -r-x resumeService Void : String(svcName) -r-x resumeService Void : String(svcName),Boolean(isImport) -r-x startConnection Void : String(LDomAccessPointId) -r-x startConnection Void : String(LDomAccessPointId),String(RDomAccessPointId) -r-x stopConnection Void : String(LDomAccessPointId) -r-x stopConnection Void : String(LDomAccessPointId),String(RDomAccessPointId) -r-x suspendService Void : String(localAccessPoint),String(remoteAccessPointList),String(svcName) -r-x suspendService Void : String(localAccessPoint),String(svcName) -r-x suspendService Void : String(localAccessPoint),String(svcName),Boolean(isImport) -r-x suspendService Void : String(svcName) -r-x suspendService Void : String(svcName),Boolean(isImport) wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName() TOUPPER wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.svcTypeToString(status[0].getServiceType()) IMPORT wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus()) AVAILABLE wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.suspendService('TOUPPER') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus()) SUSPENDED wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.resumeService('TOUPPER') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus()) AVAILABLE wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName() TOUPPER wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.suspendService('TDOM1','TOUPPER') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName() TOUPPER wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus()) SUSPENDED wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.resumeService('TDOM1','TOUPPER') wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus() wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName() TOUPPER wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus()) AVAILABLE wls:/mydomain/serverRuntime/WTCRuntime/WTCService> wls:/mydomain/serverRuntime/WTCRuntime/WTCService> disconnect() wls:/offline> exit()