「SALTデプロイメント・ファイルのリファレンス」
次の項では、SALTデプロイメント・ファイルのリファレンス情報について説明します。
SALTデプロイメント・ファイル(
SALTDEPLOY)は、XMLベースのファイルであり、SALT
GWWSサーバー・デプロイメント情報をTuxedoマシンごとに定義するために使用されます。
SALTDEPLOYは、次の処理を行います。
•
|
必要なすべてのWebサービス定義ファイル( WSDF)をリストします。
|
•
|
Tuxedoマシン上にデプロイされた GWWSサーバーの数を指定します。
|
•
|
GWWSサーバーごとに着信と発信Webサービス・アクセス・エンドポイントを関連付けます。
|
SALTDEPLOYには、グローバル・リソース(たとえば、証明書およびプラグイン・ロード・ライブラリなど)を設定するシステム・セクションがあります。
図B-1では、SALT
SALTDEPLOYファイル書式のグラフィカルな表現を示します。
XMLスキーマはSALT
SALTDEPLOYファイルに関連付けられています。SALT
SALTDEPLOYファイルの書式を記述するXMLスキーマ・ファイルは、
$TUXDIR/udataobj/salt/saltdep.xsdディレクトリにあります。
リストB-1に、SALT
SALTDEPLOYファイルの例を示します。
リストB-1
SALT SALTDEPLOYファイルの例
<Deployment xmlns="http://www.bea.com/Tuxedo/SALTDEPLOY/2007">
<Import location="/home/myapp/bankapp.wsdf" />
<Import location="/home/myapp/amazon.wsdf" />
<Binding ref="bankapp:bankapp_binding">
<Endpoint use="https1" />
<Binding ref="amazon:default_binding"/>
value="proxy.server.com,10.123.10.10:1080"/>
<PrivateKey>/home/user/cert.pem</PrivateKey>
<Interface library="/home/user/mydatahandler.so" />
次のセクションに、SALTDEPLOYF書式要素およびこれらの属性を一覧表示し説明します。
<Deployment>要素内で次の3つのセクションを定義する必要があります。
SALTDEPLOYファイルには
<Deployment>要素を1つのみ定義できます。
すべてのインポートしたWSDFファイルをカプセル化する先頭の要素です。
SALTDEPLOYファイルにインポートする
WSDFを指定します。複数の
WSDFを同時にインポートできます。各WSDFファイルは一回だけインポートできます。同じ
WSDF名のある複数の
WSDFは同じ
SALTDEPLOYファイルにインポートできません。
すべての
GWWSインスタンス定義をカプセル化する先頭の要素です。
|
|
|
|
GWWS識別子を指定します。この属性の値としては、最大で12文字列を入力できます(NULLで終わる文字列を除く)。識別子の値は、 SALTDEPLOYファイル内でユニークである必要があります。
|
|
GWWSサーバーに対する着信WSBindingオブジェクトを指定します。
<Binding>サブ要素を使用して各着信WSBindingオブジェクトを指定します。
RESTモードでアクセス可能なサービスのリストを指定します。この要素で指定するすべてのOracle Tuxedoサービス名は、HTTPまたはRESTメカニズムを使用して呼び出されます。このリストにないサービスを指定したURLの呼出し結果は404エラーになります。このリストにあるサービスを指定したURL(Oracle Tuxedoサービスの通知対象でない)の呼出し結果は451エラーになります。
この要素には、httpまたはhttps (SSL用)、
HTTP/RESTのリスニング・エンドポイントを指定する2つの属性が含まれています。GWWSインスタンスごとに許可される
<Network>要素は1つのみです。httpおよびhttps要素はオプションですが、少なくとも1つ指定する必要があります。httpおよびhttps属性の構造を次に示します。
<host>:
HTTP/RESTリスニング・エンドポイントの名前IPアドレスです。
<port>:
HTTP/RESTリスニング・エンドポイントのポート値です。
すべての
HTTP/RESTリクエストは、同じ
<host>:<port>の組合せで実行されます(プロトコル(httpおよびhttps)ごと、ゲートウェイごとにそのような組合せを複数使用できないため)。
|
|
|
|
RESTリクエスト用のHTTPホストとポート・リスニング・エンドポイント形式は、次に対応する <host>:<port>のペアを含む文字列です。
<host> = HTTP/RESTリスニング・エンドポイントの名前またはIPアドレス。
<port> = HTTP/RESTリスニング・エンドポイントのポート値。
|
|
|
SSL HTTPホストおよびポート・リスニング・エンドポイントを指定します。
|
|
* 必須ではありませんが、
<Network>要素には
httpまたは
https属性のいずれかが含まれている必要があります。
HTTP/RESTメカニズムを使用して呼出し可能な単一のサービスを指定します。実際に呼び出されたOracle Tuxedoサービスは、さらに
<Method>要素を使用して指定される
HTTPメソッドによって修飾されます。
|
|
|
|
注意:
|
これは、 <Method>要素を使用して構成される実際のOracle Tuxedoサービスではありません。
|
|
|
|
JSONはContent-Type: application/jsonを表し、XMLはContent-Type: application/xmlを表します。
リクエストHTTPヘッダーにcontent-typeフィールドが含まれていない場合、SALTではここで設定したcontent-type属性を使用します。
|
|
|
発信RESTネットワーク・メッセージの文字エンコーディングを指定します。
|
|
Oracle TuxedoサービスへのHTTPメソッド・マッピングを指定します。これは、CRUDメソッド(作成、読取り、更新、削除)をモデル化するために設計されています。
|
|
|
|
メソッド識別子の GET、 PUT、 POST、 DELETE。これ以外の値では構成エラーになります。
|
|
|
マッピングされているOracle Tuxedoサービスの名前。
|
|
|
Oracle Tuxedoバッファ・タイプ/オプションで入力の変換に使用されるサブタイプ。値は既存のすべてのOracle Tuxedoバッファ・タイプと同じです。VIEW/VIEW32バッファ・タイプの場合は、注釈{VIEW|VIEW32}/ <Subtype>を使用してサブタイプの概念が伝達されます。例: VIEW32/ customer。
|
|
|
メタデータ・リポジトリ・エントリへの参照です。これは、インタフェース・データと HTTP/RESTサービスおよびメソッドと関連付けるために使用されます。構成ツールでサービス・メタデータ(インタフェース)に基づいた自動テスト・コードを生成する際にも使用されます。
|
|
GWWSサーバーに対する発信WSBindingオブジェクトを指定します。
<Binding>サブ要素を使用して各発信WSBindingオブジェクトを指定します。
親要素に応じて、着信バインディングまたは発信バインディングとして具体的なWSBindingオブジェクトを指定します。
|
|
|
|
以下の修飾名の形式を使用して具体的なWSBindingオブジェクトを指定します。
「<WSDF_name>:<WSBinding_id>」
|
|
注意:
|
GWWSサーバーごとに参照できる最大のWSBindingオブジェクトを以下に示します。
|
•
|
GWWSサーバーごとに最大で64着信WSBindingオブジェクトを参照できます。
|
•
|
GWWSサーバーごとに最大で128発信WSBindingオブジェクトを参照できます。
|
TCP/IPアドレスの場合、
表B-7に示すように、次のいずれかの形式が使用されます。
|
|
|
|
|
|
|
Hex format is not supported
|
詳細は、Tuxedo 10g R3リファレンス・ガイドのセクション5 - 「ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス」にある
TUXENV(5)環境変数リスト内の
TMUSEIPV6を参照してください。
単一のWSBindingオブジェクトのエンドポイント・リファレンスを指定します。
参照したエンドポイントを着信エンドポイントとして指定すると、GWWSサーバーは対応するHTTPまたはHTTPSリスニング・エンドポイントを作成します。1つの着信WSBindingオブジェクトに対して少なくとも1つの着信エンドポイントを指定する必要があります。
参照したエンドポイントを発信エンドポイントとして指定すると、GWWSサーバーは発信WSBindingオブジェクトのSOAPリクエストごとにHTTPまたはHTTPSの接続を作成します。
発信WSBindingオブジェクトに対して発信エンドポイントを指定しない場合、最初の10エンドポイント(最大)が自動的に選択されます。
参照したエンドポイントはWSDFであらかじめ定義されている必要があります。
|
|
|
|
参照したエンドポイントIDは、WSDFで定義されます。
|
|
注意:
|
GWWSサーバーごとに作成できる最大のエンドポイントを以下に示します。
|
•
|
SOAPリクエストを受け付けるためにすべての着信WSBindingオブジェクトでGWWSサーバーごとに最大で128着信エンドポイントを作成できます。
|
•
|
すべての発信WSBindingオブジェクトでGWWSサーバーごとに最大で256発信エンドポイントとの接続を作成できます。
|
発信WSBindingオブジェクトに対してWS-Addressingを有効にするかどうかを指定します。
この要素が存在する場合、デフォルトでは、すべてのSOAPメッセージがWS-Addressingメッセージ・ヘッダーに送信されます。
|
|
|
|
WS-Addressingのネットワーク上のバージョンについて、"submission"バージョンの場合は200408、バージョン1の場合は200508の使用を選択します。
指定しない場合、バージョンは200408にデフォルト設定されます
|
|
この要素が存在する場合、リスニング・エンドポイント・アドレスに対して
<WSAddressing>のサブ要素
<Endpoint>を指定する必要があります。
参照した発信WSBindingオブジェクトに対するWS-Addressingリスニング・エンドポイントのアドレスを指定します。
|
|
|
|
WS-Addressingリスニング・エンドポイントのアドレスを指定します。
" http(s)://<host>:<port>/<context_path>"
GWWSサーバーは、リスニング・エンドポイントを作成し、WS-Addressing SOAPレスポンス・メッセージを受信します。
|
|
RESTモードでアクセス可能な発信サービスのリストを指定します。
HTTP/RESTメカニズムを使用して呼出し可能な発信サービスを指定します。
|
|
|
|
|
|
|
JSONはContent-Type: application/jsonを表し、XMLはContent-Type: application/xmlを表します。
リクエストHTTPヘッダーにcontent-typeフィールドが含まれていない場合、SALTではここで設定したcontent-type属性を使用します。
|
|
|
発信RESTネットワーク・メッセージの文字エンコーディングを指定します。
|
|
属性"location"は、トランザクション・ファイルの場所を示します。WS-TXトランザクション・サポートを必要とする場合は、これが必要です。
属性"
id"は、トランザクション・ファイル内のトランザクション・ログの名前を示します。WS-TXトランザクション・サポートを必要とする場合は、これが必要です。
属性"
address"は、WS-ATプロトコル・エンドポイントを示します。
属性"
value"は、同時に実行できるWS-TXトランザクションの最大数を示します。これは、Oracle Tuxedo
MAXGTTによってバインドされます。
<Property>サブ要素を使用してすべての
GWWSサーバーのプロパティ設定をカプセル化する先頭の要素です。
|
|
|
|
必要に応じて、エンドポイントをGWInstanceでグループ化して、プロキシ使用のエンドポイントとプロキシ不使用のエンドポイント間を区切ることができます。
値: プロキシ・サーバーのURLのリストが含まれる文字列タイプ。
例: proxy.server1.com,10.123.1.1:1080
|
|
|
|
|
|
プロパティ名を指定します。 表B-14に、すべてのGWWSサーバーのプロパティを示します。
|
|
|
|
|
|
|
|
|
HTTPリクエストのコンテンツ長がプロパティ設定より長い場合に GWWSサーバーでリクエストの受け付けを拒否できます。指定しない場合、 GWWSサーバーでコンテンツ長はチェックされません。値は以下3つの形式のいずれかに基づく文字列で指定します。
1.
|
整数はバイトで表します。接尾辞なしの数値の場合、単位としてバイトを使用します。
|
2.
|
浮動小数点数はキロバイトで表します。接尾辞として必ず 「K」を付けます。たとえば、 10.4K、 40Kなど。
|
3.
|
浮動小数点数はメガバイトで表します。接尾辞として必ず 「M」を付けます。たとえば、 100M、 20.6Mなど。
|
|
指定値は、 [1バイト、1Gバイト]の範囲にあるバイト・サイズ値に相当する必要があります。
|
|
GWWSサーバーに対する最大のスレッド・プール・サイズを指定します。
注意:
|
この値には GWWSサーバーで発生できる最大のスレッドを指定します。 GWWSサーバーの実行中、実際に発生するスレッドは指定した値より小さい場合があります。
|
|
|
|
ネットワークのタイムアウト値を秒の単位で指定します。
|
|
|
バックログ・リスニング・ソケットの値を指定します。このプロパティは、オペレーティング・システムによる保留中の接続を保持するキューの最大長を制御するために使用します。
注意:
|
通常に、この値をチューニングする必要はありません。
|
|
|
|
GWWSサーバーの複数のエンコーディング・メッセージ・サポートをオン/オフに切り替えます。複数のエンコーディング・サポートのプロパティをオフにすると、GWWSサーバーはUTF-8 HTTP / SOAPメッセージのみを受け入れます。
|
|
|
着信SOAPリクエスト・メッセージの対応するTuxedo入力バッファがカスタマイズしたXMLスキーマに関連付けられている場合、XMLスキーマ検証をオン/オフに切り替えます。
|
|
|
enableMultiEncodingとは相互に排他的です。
ISO-8859シリーズなどの1バイトのエンコーディングを、MBSTRING以外の型にマップできるようにします。
keepSame以外の値に設定された場合、SALTでは、Tuxedo側で指定されたエンコーディング(internalEncoding属性の値に基づいて変換されたエンコーディング)とネットワーク側で指定されたエンコーディング(SOAPまたはREST)との間で、ペイロード内のテキストを変換します。
このプロパティは、マルチバイト・エンコーディングでおよび MBSTRINGバッファまたはフィールドとともには使用しないでください。使用した場合、実行時エラーがスローされます。
|
有効な値は、ISO-8859などの1バイトのエンコーディング名であるkeepSameです。
|
証明書情報およびプラグイン・インタフェースなどグローバルな設定を指定します。
注意:
|
SEC_PRINCIPAL_PASSWORDが設定されている場合、GWWSは証明書をウォレットに変換します。HTTPのもとでX509証明書のみが使用されている場合、変換は行われません。
|
Oracleウォレットを使用している場合、Oracleウォレットがあるディレクトリの場所を指定します。
注意:
|
SALTには、Oracle Tuxedoのようなセキュリティ・プリンシパル名の概念がないので、ウォレットは、指定されたディレクトリに(サブディレクトリでなく)置かれます。
|
サーバーID証明書(SALTデプロイ構成ファイルの
<PrivateKey>要素)を構成するには、SSL構成ファイルにルート認証局が存在している必要があります。適切な構成は、
レガシー・セキュリティ資格証明形式を使用する場合は、
PEM形式の秘密鍵ファイルを指定します。キー・ファイルのパスは、この要素に対するテキスト値として指定します。サーバー証明書もこの秘密鍵ファイル内に格納されます。この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。
セキュリティ資格証明の形式がどちらであっても、OracleウォレットまたはGWWS秘密鍵ファイルのパスワードは、
TUXCONFIGファイル内で、
SEC_PRINCIPAL_PASSVAR="environment_variable_name"パラメータを使用して指定されます。
TUXCONFIGファイルでは、
SEC_PRINCIPAL_PASSVARが構成ファイルで正しく処理されるように、
SEC_PRINCIPAL_NAME="any_non-null_string(not_used)"パラメータも設定する必要があります。
Webサービスのクライアントから証明書を送信する際にHTTP over SSL接続の使用を必須とするかどうかを指定します。要素の有効な値は
「true」または
「false」です。
この要素は省略可能です。指定しない場合、デフォルト値として
「false」が使用されます。
信頼されたPEM形式の証明書ファイルのファイル名を指定します。この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。
信頼された証明書が格納されているローカル・ディレクトリを指定します。この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。
注意:
|
<VerifyClient>が trueに設定されている場合、またはWS-AddressingをSSLで使用する場合には、この要素で設定したディレクトリに信頼された証明書を格納する必要があります。
|
グローバル・プラグイン・ロード・ライブラリの情報を指定します。
<Interface>サブ要素ごとに、ロードする1つのプラグイン・ライブラリを指定します。
ライブラリ内のすべてのプラグイン・インタフェースに対して特定のプラグイン・インタフェースまたはプラグイン・ライブラリを指定します。
|
|
|
|
必須。ローカル共有ライブラリ・ファイルのパスを指定します。 この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。
|
|
|
省略可。起動時に GWWSサーバーにより初期化された場合、ライブラリに渡された特定の文字列値を指定します。 この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。
|
|