|
|
Oracle Service Architecture Leveraging Tuxedo (SALT)コマンド・リファレンスには、SALTソフトウェアで提供されるシステム処理とコマンドについて記載されています。
表1に、Oracle Service Architecture Leveraging Tuxedoのコマンドと関数を示します。
GWWS SRVGRP="identifier" SRVID=number [other_parms]
CLOPT="-A -- – i InstanceID [-a <scheme>://<host>:<port>]"
GWWSサーバーは、TuxedoアプリケーションのWebサービス・ゲートウェイで、SALTのコア・コンポーネントです。GWWSゲートウェイ・サーバーは、SOAP 1.1/1.2プロトコルを通じてWebサービス・プログラムとの通信を提供します。GWWSサーバーでは、双方向(着信または発信)の機能があります。Webサービス・アプリケーションからSOAPリクエストを受け付けて、Tuxedoネイティブ・コールをTuxedoサービス(着信)に渡します。また、Tuxedo ATMIリクエストを受け付けて、SOAPコールをWebサービス・アプリケーション(発信)に渡します。GWWSサーバーは、Tuxedoシステム・プロセスとして使用され、UBBCONFIGファイルの*SERVERSセクションに記述されています。
CLOPTオプションは、コマンドライン・オプションの文字列で、起動時にGWWSサーバーに渡されます。GWWSサーバーは次のCLOPTオプションを受け付けます。
-i InstanceID
GWWSインスタンスの一意のIDを指定します。同じTuxedoドメインの複数のGWWSインスタンスを識別するために使用されます。この値は、UBBCONFIGファイル内の複数のGWWS項目の間で一意である必要があります。 | 注意: | InstanceIDの値は、SALTデプロイメント・ファイルの<WSGateway>セクションであらかじめ定義する必要があります。 |
-a <scheme>://<host>:<port>
UBBCONFIGファイルで-aオプションを使用して構成する必要があります。-a <scheme>://<host>:<port> | 注意: | 次のURLを使用して、Web管理コンソールにアクセスします。<scheme>://<host>:<port>/admin |
環境変数SALTCONFIGは、GWWSサーバーを起動する前に設定する必要があります。 Accesslog(5)は、環境変数TMENABLEALOG=yを設定することで有効にできます。
| 注意: | %TUXDIR%\bin\ssllibsをPATHに追加します。 |
次のSALT 1.1 GWWSパラメータは現在のリリースでは非推奨になっています。
-c Config_file
| 注意: | SALT 2.0リリース以降では、GWWSサーバーはXMLベース構成ファイルではなくバイナリSALTCONFIGファイルからSALT構成をロードします。構成ファイルはGWWS入力パラメータではなくなりました。GWWSサーバーを起動する前に、 wsloadcfを使用してSALTCONFIGファイルを生成する必要があります。 |
発信呼出しについては、SOAPメッセージの処理中に発生したエラーはログに記録されます。エラーは、適切なSOAPエラー・コードまたはHTTPエラー・ステータス・コードに変換されてWebサービス・クライアントに返されます。
発信呼出しについては、処理中に発生したエラーはログに記録されます。エラーは、適切なTuxedoシステム・エラー・コード(tperrno)に変換されてTuxedoクライアントに返されます。
GWWS SRVGRP=GROUP1 SRVID=10
CLOPT="-A -- – i GW1"
GWWS SRVGRP=GROUP1 SRVID=11
CLOPT="-A -- – i GW2"
GWWS SRVGRP=GROUP2 SRVID=20
CLOPT="-A -- – i GW3"
「Oracle SALT Webサービス定義ファイルのリファレンス」
tmscd(1) – サービス規約検索を有効または無効にします。
tmscd start|stop|status [-e] [-f <file>][id1 [ id2 [ ...]]]
tmscdコマンドライン・ユーティリティを使用すると、サービス規約検索を有効または無効にできます。
tmscdでは、次のパラメータとオプションがサポートされます。
start|stop|status
startまたはstopを要求しても無視されます。リクエストの処理中には、有用なサービス情報が表示されます。 | 注意: | -eまたは-fオプションを指定する場合は、その後にstart|stop|statusを指定する必要があります。 |
[-e]
[-f <file>]
<file>内に定義されます。このファイルには、関連する定義をまとめたセクションが含まれている場合もあります。セクションのすべてのエントリは、1行ずつ記述する必要があります。
id1 id2 ...
サンプル1 - TOUPPER、TOLOWERの検索を開始します。
tmscd start TOUPPER TOLOWER
サンプル2 - TOおよびBRで始まるサービスの検索を開始します。
tmscd -e start TO.* BR.*
サンプル3 - サンプル1と同じリクエストをファイルを使って行います。
tmscd -f svcfile start id1 id2
| 注意: | セクションが指定されていない場合は、最初に見つかった定義が使用されます。 |
サンプル4 - サンプル2と同じリクエストをファイルを使って行います。
tmscd -e -f svcfile start case4.svcs
コード・リスト 2に、「svcfile」という名前のファイルの内容を示します。
# file: svcfile
*case3
id1 = TOUPPER
id2 = TOLOWER
*case4
svcs = TO.*|BR.*
TMMETADATAが起動していないか、-r (読取り専用)オプションを指定し-oオプションを指定しない状態で起動されていない場合は、tmscdでエラーが発生します。
Oracle Service Architecture Leveraging Tuxedo構成ガイドのサービス・コントラクトの検出の構成
「Oracle SALT Webサービス定義ファイルのリファレンス」
tmwsdlgen - WSDLドキュメント・ジェネレータです。
tmwsdlgen – c wsdf_file [-y] [-o wsdl_file] [-m {pack|raw|mtom}] [-t
{wls|axis}] tmwsdlgenは、TuxedoネイティブWebサービス定義ファイル(WSDF)からWSDLドキュメント・ファイルを生成します。生成されたWSDLドキュメントは、WSDL 1.1の仕様に準拠し、サービス契約とポリシーの両方を表現します。tmwsdlgenはTuxedoサービス・メタデータ・リポジトリ管理の処理(TMMETADATA)中にTuxedoサービス情報を集めます。tmwsdlgenはTuxedoネイティブ・クライアントとして動作し、次の設定を行う必要があります。
| 警告: | 指定したWSDFはTuxedoネイティブWSDFである必要があります。wsdlcvtで変換された非ネイティブのWSDFファイルを入力に使用しないでください。 |
-c wsdf_file
tmwsdlgen には次の省略可能なパラメータを指定できます。
-o wsdl_file
tuxedo.wsdlのデフォルトのファイルがカレント・ディレクトリに作成されます。指定したWSDL文書ファイルがすでに存在する場合は、既存のファイルを上書きするかどうかを確認するメッセージが表示されます。
-y
-m
rawモードを指定した場合は、CARRAYがMIME添付ファイルで表現されます。packモードを指定した場合は、CARRAYの表現にxsd:base64Binaryが使用されます。デフォルト値はpackモードです。 | 注意: | rawモードは.Netクライアントに使用できません。.Net FrameworkはMIME添付ファイルをサポートしていないからです。 |
次のSALT 1.1 GWWSパラメータは現在のリリースでは非推奨になっています。
-c Config_file
-s
-v
| 注意: | 現在のSALTリリースには、SOAPのバージョンおよびメッセージ・スタイルの属性がSALT WSDF内で指定されています。 |
指定したWSDF内で構文エラーが検出した場合、標準エラーの問題であることを示す「ERROR」または「FATAL」メッセージを表示したり、WSDLファイルを生成したりせずに、終了コード「1」でtmwsdlgenを終了します。
実行に成功した時、tmwsdlgenは終了コード「0」で終了します。
次のコマンドを実行すると、指定したSALT WSDFのtux.wsdfからWSDLドキュメント・ファイルのSalt.wsdlが生成されます。
tmwsdlgen – c tux.wsdf – o Salt.wsdl
次のコマンドを実行すると、指定したSALT WSDFのapp_wsdf.xmlからのSOAP w/添付の機能でデフォルトのWSDLドキュメント・ファイルが生成されます。
tmwsdlgen – c app_wsdf.xml – m raw
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsadmin: SALT管理コマンド・インタープリタです。
wsadmin [-v]
wsadminは、特定のコマンドを使用して、指定したTuxedoドメイン内のアクティブなGWWSプロセスのモニターと管理を行います。TUXCONFIG環境変数は、Tuxedo構成ファイルがロードされた場所を決定します。wsadminはtmadmin(1)またはdmadmin(1)と同じように使用されます。
-v
コマンドは、完全な名前または省略形(かっこ内に示す形式)で入力できます。その後に適切な引数を指定します。角かっこ[ ]で囲まれた引数は省略可能です。中かっこ{}で囲まれた引数は、その中から1つだけオプションを選択できることを示します。
| 注意: | 角かっこで囲まれていないコマンドライン・オプションは、そのデフォルト値がdefaultコマンドで設定されている場合は指定する必要がありません。 |
configstats(cstat) -i gwws_instance_id
default(d) [-i gwws_instance_id]
*を指定すると、デフォルト値を変更できます。引数を指定しないでdefaultコマンドを入力した場合は、現在のデフォルト値が出力されます。
tran_idまたはcoord_contextコーディネーション・コンテキストを指定すると、そのトランザクションのヒューリスティックなログ・レコードのみが削除されます。コーディネーション・コンテキスト(coord_context)は、printtransコマンドまたはULOGファイルから取得できます。
help (h) [command]
gwstats(gws) -i gwws_instance_id [-s serviceName]
serviceNameを指定すると、サービスレベル情報が表示されます。
paginate(page) [{off | on}]
pgです。シェル環境変数のPAGERを使用すると、デフォルトのページ単位表示出力に使用するコマンドをオーバーライドできます。
quit (q)
saml create [-p password]
saml add {-g -s shared_secret |-i -n issuer_name [ -l issuer_local_id]{[-c] [-s shared_secret]}} [-p password]
saml modify {-g -s shared_secret |-i {[-n issuer_name ][ -l issuer_local_id]}{[-c][-s shared_secret]} [-p password]
verbose (v) [{off | on}]
! shellcommand
! !
# [text]
<CR>
wsadmin> gws -i GW2GWWS Instance : GW2
Inboud Statistics :
---------------------------------
Request Response Succ : 3359
Request Response Fail : 0
Oneway Succ : 0
Oneway Fail : 0
Total Succ : 3359
Total Fail : 0
Avg. Processing Time : 192.746 (ms)
---------------------------------
Outboud Statistics :
---------------------------------
Request Response Succ : 4129
Request Response Fail : 0
Oneway Succ : 0
Oneway Fail : 0
Total Succ : 4129
Total Fail : 0
Avg. Processing Time : 546.497 (ms)
-----------------------------------
Total request Pending : 36
Outbound request Pending : 0
Active Thread Number : 141
ToUpperWSサービスの実行時の統計が調べられ、出力が冗長モードで表示されます。wsadmin
> > verbose
Verbose now on.
> gws -i GW1 -s ToUpperWS
GWWS Instance : GW1
Service : ToUpperWS
Outboud Statistics :
----------------------------------
Oneway Succ : 0
Oneway Fail : 0
---------------------------------
Avg. Processing Time : 0.000 (ms)
wsdlcvt -i WSDL_URL -o output_basename [-m] [-v] [-y] [-w][-sh] [-sp]
wsdlcvtは既存のWSDL 1.1ドキュメントをメタデータ入力ファイル、FML32マッピング・ファイルおよびSALT Webサービス定義ファイル(WSDF)に変換します。Xalanのwsdl2mif.xsl、wsdl2fml32*.xslおよびwsdl2wsdf.xslのラッパー・スクリプトです。SALT製品には、Apache Xalan 2.7ライブラリがバンドルされています。
wsdlcvtを実行するには、JRE 1.5以上が必要です。
-i
-o
wsdlcvtには、次のパラメータを指定できます。
-y
-m
-v
-w
wsdl:importが含まれる場合、wsdlcvtが正しく処理できるようにこのパラメータを指定します。
-sh
-sp
TUXDIRおよびLANG環境変数を正しく設定する必要があります。
「java」を実行するには、PATH環境変数を正しく設定する必要があります。
次のコマンドを実行すると、ローカルのWSDLファイルのsample.wsdlファイルが変換されます。
wsdlcvt -i sample.wsdl -o sample
次のコマンドを実行すると、HTTP URLリンクからWSDLドキュメントが変換されます。「xsd:string」データ型はTuxedo FLD_MBSTRINGフィールド型に対応します。
wsdlcvt -i http://api.google.com/GoogleSearch.wsdl -o GSearch -m
Oracle Tuxedoサービス・メタデータ・リポジトリの作成
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsloadcf – SALTデプロイメント・ファイルなどの参照アーティファクトを読み込みます。バイナリSALTCONFIGファイルをロードします。
Usage 1: wsloadcf [-n][-y][-D loglevel] saltdeploy_file
Usage 2: wsloadcf [-n][-y][-D loglevel] -1 [-s rpc|doc]
[-v 1.1|1.2] salt_1.1_config
wsloadcfはSALTデプロイメント・ファイル、他の参照したファイル(WSDFファイル、WS-Policyファイル)を読んだり、構文をチェックしたり、必要に応じてバイナリ・ファイルのSALTCONFIGをロードしたりします。SALTCONFIG環境変数は、情報を格納する必要があるSALTCONFIGファイルを指します。生成したSALTCONFIGファイルは、GWWSサーバーを起動する時に必要となります。
wsloadcfには次の省略可能なパラメータを指定できます。
-n
-y
tmloadcfは、(a) SALTCONFIGが参照したファイルは存在しているか、(b) Oracle Tuxedoシステムの有効なファイル・システムであるか、(c) SALTCONFIG表を含まれているかなどを確認します。上記の条件がtrueでない場合、wsloadcfは、SALTCONFIGを作成し初期化するコマンドを実行する必要があるかを示すメッセージを表示します。 コマンドラインで「-y」を指定すると、Initialize SALTCONFIG file: path [y, q]?のメッセージが表示されません。
-D
SALT 1.1の後方互換性については、wsloadcfはSALT 1.1の構成ファイルを読むことができます。SALTCONFIGバイナリ・ファイルの生成に加えて、wsloadcfは、指定したSALT 1.1構成ファイルに従ってSALT Webサービス定義ファイル(WSDF)を1つとSALTデプロイメント・ファイルを1つ生成します。
-1
wsloadcfを実行する前にSALTCONFIG環境変数を設定する必要があります。
指定した構成ファイル内で構文エラーが検出した場合、コンソールの問題であることを示す「ERROR」または「FATAL」メッセージを表示したりSALTCONFIGファイルを更新したりせずに、終了コード「1」でwsloadcfを終了します。
(1)構成ファイルが実行時の潜在的なリスクとなる場合、および(2)構成ファイル内で値を指定しなかったためデフォルトの値が使用された場合は、コンソールに「警告」メッセージが表示されます。「警告」メッセージが表示されても、wsloadcfの実行は中断されません。
実行に成功した時、wsloadcfは終了コード「0」で終了します。SALTCONFIGファイルを更新した場合、ユーザーのログ・メッセージが生成されます。
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsunloadcf: SALTCONFIGバイナリ・ファイルを読み込み、SALTデプロイメント・ファイルやその他の参照ファイル(WSDFファイル、WS-Policyファイル)を作成します。
Usage: wsunloadcf
wsloadcfは、SALTCONFIGファイルやその他の参照ファイル(WSDFファイル、WS-Policyファイル)を読み込みます。SALTCONFIG環境変数は、情報を格納する必要があるSALTCONFIGファイルを指します。
wsunloadcfを実行する前にSALTCONFIG環境変数を設定する必要があります。
「Oracle SALT Webサービス定義ファイルのリファレンス」
  
|