リファレンス・ガイド

Oracle SALTデプロイメント・ファイルのリファレンス

次の項では、SALTデプロイメント・ファイルのリファレンス情報について説明します。

概要

Oracle SALTデプロイメント・ファイル(SALTDEPLOY)は、XMLベースのファイルであり、Oracle SALT GWWSサーバー・デプロイメント情報をTuxedoマシンごとに定義するために使用されます。 SALTDEPLOYは、以下の処理を行います。

SALTDEPLOYには、グローバル・リソース(たとえば、証明書およびプラグイン・ロード・ライブラリなど)を設定するシステム・セクションがあります。

Oracle SALT SALTDEPLOYの書式

図B-1では、Oracle SALT SALTDEPLOY書式のグラフィカルな表現を示します。

XMLスキーマ

XMLスキーマはOracle SALTデプロイメント・ファイルに関連付けられています。 Oracle SALTデプロイメント・ファイルの書式を定義するXMLスキーマ・ファイルは、$TUXDIR/udataobj/salt/saltdep.xsdディレクトリにあります。

Oracle SALT SALTDEPLOYのサンプル

リスト B-1に、SALTデプロイメント・ファイルの例を示します。

<Deployment xmlns="http://www.bea.com/Tuxedo/SALTDEPLOY/2007">

  <WSDF>

    <Import location="/home/myapp/bankapp.wsdf" />

    <Import location="/home/myapp/amazon.wsdf" />

  </WSDF>

  <WSGateway>

    <GWInstance id="GW1">

      <Inbound>

        <Binding ref="bankapp:bankapp_binding">

          <Endpoint use="http1"/>

          <Endpoint use="https1" />

        </Binding>

      </Inbound>

      <Outbound>

        <Binding ref="amazon:default_binding"/>

      </Outbound>

      <Properties>

        <Property

         name="socksAddrList"

         value="proxy.server.com,10.123.10.10:1080"/>

      </Properties>

    </GWInstance>

  </WSGateway>

  <System>

    <Certificate>

      <PrivateKey>/home/user/cert.pem</PrivateKey>

    </Certificate>

    <Plugin>

      <Interface library="/home/user/mydatahandler.so" />

    </Plugin>

  </System>

</Deployment>

Oracle SALT SALTDEPLOY要素の説明

次のセクションに、SALTDEPLOYF書式要素およびこれらの属性を一覧表示し説明します。

<Deployment>

SALTDEPLOYファイルのルート要素です。

この要素に対する属性はありません。

<Deployment>要素内で次の3つのセクションを定義する必要があります。

SALTDEPLOYファイルには<Deployment>要素を1つのみ定義できます。

<WSDF>

すべてのインポートしたWSDFファイルをカプセル化する先頭の要素です。

この要素に対する属性はありません。

<Import>

SALTDEPLOYファイルにインポートするWSDFを指定します。 複数のWSDFを同時にインポートできます。 各WSDFファイルは一回だけインポートできます。 同じWSDF名のある複数のWSDFは同じSALTDEPLOYファイルにインポートできません。

<WSGateway>

すべてのGWWSインスタンス定義をカプセル化する先頭の要素です。

この要素に対する属性はありません。

<GWInstance>

単一のGWWSインスタンスを指定します。

<Inbound>

GWWSサーバーに対する着信WSBindingオブジェクトを指定します。<Binding>サブ要素を使用して各着信WSBindingオブジェクトを指定します。

この要素に対する属性はありません。

<Outbound>

GWWSサーバーに対する発信WSBindingオブジェクトを指定します。<Binding>サブ要素を使用して各発信WSBindingオブジェクトを指定します。

この要素に対する属性はありません。

<Binding>

親要素に応じて、着信バインディングまたは発信バインディングとして具体的なWSBindingオブジェクトを指定します。

TCP/IPアドレスの場合、表B-4に示すように、次のいずれかの形式が使用されます。

詳細は、Tuxedo 10g R3リファレンス・ガイドのセクション5 - 「ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス」にあるTUXENV(5)環境変数リスト内のTMUSEIPV6を参照してください。

<Endpoint>

単一のWSBindingオブジェクトのエンドポイント・リファレンスを指定します。

参照したエンドポイントを着信エンドポイントとして指定すると、GWWSサーバーは対応するHTTPまたはHTTPSリスニング・エンドポイントを作成します。1つの着信WSBindingオブジェクトに対して少なくとも1つの着信エンドポイントを指定する必要があります。

参照したエンドポイントを発信エンドポイントとして指定すると、GWWSサーバーは発信WSBindingオブジェクトのSOAPリクエストごとにHTTPまたはHTTPSの接続を作成します。

発信WSBindingオブジェクトに対して発信エンドポイントを指定しない場合、最初の10エンドポイント(最大)が自動的に選択されます。

参照したエンドポイントはWSDFであらかじめ定義されている必要があります。

<WSAddressing>

発信WSBindingオブジェクトに対してWS-Addressingを有効にするかどうかを指定します。

この要素が存在する場合、デフォルトでは、すべてのSOAPメッセージがWS-Addressingメッセージ・ヘッダーに送信されます。この要素が存在する場合、リスニング・エンドポイント・アドレスに対して<Endpoint>サブ要素を指定する必要があります。

この要素に対する属性はありません。

<Endpoint>

参照した発信WSBindingオブジェクトに対するWS-Addressingリスニング・エンドポイントのアドレスを指定します。

<TLogDevice>

属性"location"は、トランザクション・ファイルの場所を示します。WS-TXトランザクション・サポートを必要とする場合は、これが必要です。

<TLogName>

属性"id"は、トランザクション・ファイル内のトランザクション・ログの名前を示します。WS-TXトランザクション・サポートを必要とする場合は、これが必要です。

<WSATEndpoint>

属性"address"は、WS-ATプロトコル・エンドポイントを示します。

<MaxTran>

属性"value"は、同時に実行できるWS-TXトランザクションの最大数を示します。これは、Oracle Tuxedo MAXGTTによってバインドされます。

<Properties>

<Property>サブ要素を使用してすべてのGWWSサーバーのプロパティ設定をカプセル化する先頭の要素です。

<Property>

1つのGWWSプロパティを指定します。

<System>

証明書情報およびプラグイン・インタフェースなどグローバルな設定を指定します。

<Certificate>

<PrivateKey>、<VerifyClient>、<TrustedCert>および<CertPath>サブ要素を使用して、グローバルな証明書情報を指定します。

この要素に対する属性はありません。

<PrivateKey>

PEM形式の秘密鍵ファイルを指定します。キー・ファイルのパスは、この要素に対するテキスト値として指定します。サーバー証明書もこの秘密鍵ファイル内に格納されます。この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。

<Certificate>親要素を構成する場合、この要素は必須です。

<VerifyClient>

Webサービスのクライアントから証明書を送信する際にHTTP over SSL接続の使用を必須とするかどうかを指定します。 要素の有効な値は「true」または「false」です。

この要素は省略可能です。 指定しない場合、デフォルト値として「false」が使用されます。

<TrustedCert>

信頼されたPEM形式の証明書ファイルのファイル名を指定します。 この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。

この要素は省略可能です。

<CertPath>

信頼された証明書が格納されているローカル・ディレクトリを指定します。 この属性の値としては、最大で256文字列を入力できます(NULLで終わる文字列を除く)。

この要素は省略可能です。

<Plugin>

グローバル・プラグイン・ロード・ライブラリの情報を指定します。<Interface>サブ要素ごとに、ロードする1つのプラグイン・ライブラリを指定します。

この要素に対する属性はありません。

<Interface>

ライブラリ内のすべてのプラグイン・インタフェースに対して特定のプラグイン・インタフェースまたはプラグイン・ライブラリを指定します。