|
|
以下の節では、SALT デプロイメント ファイルのリファレンスについて説明します。
Oracle SALT デプロイメント ファイル (SALTDEPLOY) は、XML ベースのファイルであり、Oracle SALT GWWS サーバ デプロイメント情報を Tuxedo マシンごとに定義するために使用されます。SALTDEPLOY は、以下の処理を行います。
SALTDEPLOY には、グローバル リソース (たとえば、証明書およびプラグイン ロード ライブラリなど) を設定するシステム セクションがあります。
図 B-1 に、Oracle SALT SALTDEPLOY の書式のグラフィカル表現を示します。
XML スキーマは Oracle SALT デプロイメント ファイルに関連付けられています。Oracle SALT デプロイメント ファイルの書式を定義する XML スキーマ ファイルは、$TUXDIR/udataobj/salt/saltdep.xsd ディレクトリにあります。
コード リスト 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>
</GWInstance>
</WSGateway>
<System>
<Certificate>
<PrivateKey>/home/user/cert.pem</PrivateKey>
</Certificate>
<Plugin>
<Interface library=”/home/user/mydatahandler.so” />
</Plugin>
</System>
</Deployment>
次のセクションに、SALTDEPLOYF 書式要素およびこれらの属性を一覧表示し説明します。
<Deployment> 要素内で次の 3 つのセクションを定義する必要があります。
<WSDF> 要素<WSGateway> 要素 <System> 要素
SALTDEPLOY ファイルには <Deployment> 要素を 1 つしか定義できません。
すべてのインポートした WSDF ファイルをカプセル化する先頭の要素です。
SALTDEPLOY ファイルにインポートする WSDF を指定します。複数の WSDF を同時にインポートできます。各 WSDF ファイルは一回だけインポートできます。同じ WSDF 名のある複数の WSDF は同じ SALTDEPLOY ファイルにインポートできません。
すべての GWWS インスタンス定義をカプセル化する先頭の要素です。
GWWS サーバに対する着信 WSBinding オブジェクトを指定します。<Binding> サブ要素を使用して各着信 WSBinding オブジェクトを指定します。
GWWS サーバに対する発信 WSBinding オブジェクトを指定します。<Binding> サブ要素を使用して各発信 WSBinding オブジェクトを指定します。
親要素に応じて、着信バインディングまたは発信バインディングとして具体的な WSBinding オブジェクトを指定します。
| 注意 : | GWWS サーバごとに参照できる最大の WSBinding オブジェクトを以下に示します。 |
TCP/IP アドレスの場合は、表 B-4 に示すいずれかの形式を使用します。
詳細については、Tuxedo 10g R3 の「ファイル形式、データ記述方法、MIB、およびシステム プロセスのリファレンス」にある「TUXENV(5)」の環境変数「TMUSEIPV6」を参照してください。
単一の WSBinding オブジェクトのエンドポイント リファレンスを指定します。
参照したエンドポイントを着信エンドポイントとして指定すると、GWWS サーバは対応する HTTP または HTTPS リスン エンドポイントを作成します。1 つの着信 WSBinding オブジェクトに対して少なくとも 1 つの着信エンドポイントを指定する必要があります。
参照したエンドポイントを発信エンドポイントとして指定すると、GWWS サーバは発信 WSBinding オブジェクトの SOAP リクエストごとに HTTP または HTTPS の接続を作成します。
発信 WSBinding オブジェクトに対して発信エンドポイントを指定しない場合、最初の 10 エンドポイント (最大) が自動的に選択されます。
参照したエンドポイントは WSDF であらかじめ定義されている必要があります。
| 注意 : | GWWS サーバごとに作成できる最大のエンドポイントを以下に示します。 |
発信 WSBinding オブジェクトに対して WS-Addressing を有効にするかどうかを指定します。
この要素が存在する場合、デフォルトでは、すべての SOAP メッセージが WS-Addressing メッセージ ヘッダに送信されます。この要素が存在する場合、リスン エンドポイント アドレスに対して <Endpoint> サブ要素を指定する必要があります。
参照した発信 WSBinding オブジェクトに対する WS-Addressing リスン エンドポイントのアドレスを指定します。
<Property> サブ要素を使用してすべての GWWS サーバのプロパティ設定をカプセル化する先頭の要素です。
|
||||
|
||||
証明書情報およびプラグイン インタフェースなどグローバルな設定を指定します。
<PrivateKey>、<VerifyClient>、<TrustedCert>、および <CertPath> サブ要素を使用してグローバルな証明書情報を指定します。
PEM 形式のプライベート キー ファイルを指定します。キー ファイルのパスは、この要素に対するテキスト値として指定します。サーバ証明書もこのプライベート キー ファイル内に格納されます。この属性の値としては、最大で 256 文字列を入力できます (NULL で終わる文字列を除く)。
<Certificate> 親要素をコンフィグレーションする場合、この要素は必須です。
Web サービスのクライアントから証明書を送信する際に HTTP over SSL 接続の使用を必須とするかどうかを指定します。要素の有効な値は「true」または「false」です。
この要素は省略可能です。指定しない場合、デフォルト値として「false」が使用されます。
信頼された PEM 形式の証明書ファイルのファイル名を指定します。この属性の値としては、最大で 256 文字列を入力できます (NULL で終わる文字列を除く)。
信頼された証明書が格納されているローカル ディレクトリを指定します。この属性の値としては、最大で 256 文字列を入力できます (NULL で終わる文字列を除く)。
| 注意 : | <VerifyClient> が「true」の場合、または WS-Addressing を SSL で使用する場合には、この要素で設定したディレクトリに信頼された証明書を格納する必要があります。 |
グローバル プラグイン ロード ライブラリの情報を指定します。<Interface> サブ要素ごとにロードする 1 つのプラグイン ライブラリを指定します。
ライブラリ内のすべてのプラグイン インタフェースに対して特定のプラグイン インタフェースまたはプラグイン ライブラリを指定します。
| 注意 : | SALT プラグイン インタフェースを開発する方法の詳細については、『プログラミング ガイド』の「Oracle SALT プラグインの使用」を参照してください。 |
  
|