Oracle SALT管理の概要

以下の項では、Oracle SALTの管理に関する各種トピックの概要を説明します。

Oracle SALTの管理

この項では、Oracle SALTの管理に必要な次の基本コンセプトを説明します。

Oracle Tuxedoサービス・メタデータ・リポジトリ

Oracle Tuxedoサービス・メタデータを保存したり取得したりするために、Oracle Tuxedoサービス・メタデータ・リポジトリが開発されました。Oracle Tuxedoサービス・メタデータは、Oracle Tuxedoサービスのリクエスト/レスポンスの詳細情報を記述するために役立つOracle Tuxedoサービス属性の集合のことです。Oracle SALTゲートウェイ・サーバー(GWWS)は、Oracle Tuxedoリクエスト/レスポンス形式(バッファ・タイプ)と標準SOAPメッセージ形式との変換のため、Oracle Tuxedoサービス・メタデータ・リポジトリを使用します。

Oracle SALTを使用してOracle TuxedoサービスをWebサービスとして公開するとき、Oracle Tuxedoサービス・メタデータをOracle Tuxedoサービス・メタデータ・リポジトリで定義およびロードする必要があります。Oracle SALTはOracle Tuxedoサービス・メタデータから対応するSOAPメッセージ形式を定義できます。

Oracle SALTでは、Oracle Tuxedoアプリケーションから外部Webサービスを呼び出すとき、WSDLファイル・コンバータwsdlcvtが提供されます。このコマンド・ユーティリティを使用して、あらゆるWebサービス操作からOracle Tuxedoサービス・メタデータを定義できます。変換されたサービスはSALTプロキシ・サービスと呼ばれ、通常のOracle Tuxedoサービスとして呼び出すことができます。Oracle SALTプロキシ・サービスも、Oracle Tuxedoサービス・メタデータ・リポジトリにロードする必要があります。

Oracle Tuxedoサービス・メタデータ情報を取得するには、Oracle Tuxedoアプリケーションで起動されるように、Oracle Tuxedoサービス・メタデータ・リポジトリ・システム・サーバー(TMMETADATA)を構成する必要があります。

Oracle SALT Webサービスのデプロイメント・モデル

Oracle SALTをデプロイするためには、以下の2種類の構成ファイルが必要です。

SALT Webサービス定義ファイル(WSDF)
SALTデプロイメント・ファイル(SALTDEPLOY)

SALT Webサービス定義ファイル

SALT Webサービス定義ファイル(WSDF)は、XMLベースのファイルであり、SALT Webサービス・コンポーネント(Webサービス・バインディング、Webサービス操作、Webサービス・ポリシー等)を定義するのに使います。WSDFは、Webサービス定義言語データ・モデルのOracle SALT特有の表現です。WSDFには、ネイティブと非ネイティブの2つの種類があります。

ネイティブWSDF

ネイティブWSDFは手動で作成します。一連のOracle TuxedoサービスおよびそれらをWebサービスとして公開する方法について、WSDFで定義する必要があります。これは、SALT 1.1構成ファイルと同様です。ネイティブWSDFはSALT WSDLジェネレータ( tmwsdlgen)の入力ファイルです。詳細は、 Oracle SALT構成ガイドを参照してください。

非ネイティブのWSDF

非ネイティブなWSDFは、SALT WSDLコンバータ( wsdlcvt)を使用して変換された外部WSDLファイルから作成します。基本的に、作成したWSDFを(高度な機能の構成以外の場合)変更する必要はありません。詳細は、次を参照してください。

Webサービスの構成

Oracle SALTデプロイメント・ファイル

Oracle SALTデプロイメント・ファイル(SALTDEPLOY)は、XMLベースのファイルであり、Oracle SALT GWWSサーバー・デプロイメント情報をOracle Tuxedoマシンごとに定義するために使用されます。SALTDEPLOYファイルでは、すべての必要なWSDFファイルの一覧を表示します。また、Oracle Tuxedoマシン上にデプロイされているGWWSサーバー数を指定し、それぞれのGWWSサーバーに対する着信および発信Webサービス・インドポイントを関連付けます。SALTDEPLOYファイルには、グローバル・リソース(証明書およびプラグイン・ロード・ライブラリを含む)が設定されているシステム・セクションが含まれています。詳細は、 Oracle SALT構成ガイドのOracle SALTデプロイメント・ファイルの作成に関する項を参照してください。

Oracle SALT Webサービスの管理タスクおよびツール

Oracle SALTでは、Oracle Tuxedoシステム上に構築されているOracle SALTアプリケーションの様々な部分を管理するために一連のコマンド・ユーティリティが提供されます。これらのユーティリティは、以下のタスクに使用できます。

コマンドライン・ユーティリティを使用したOracle SALTアプリケーションの構成

コマンドライン・ユーティリティを使用してOracle SALTアプリケーションを構成できます。具体的には、XMLエディタを使用してアプリケーションに対して構成ファイル(WSDFファイルとSALTDEPLOYファイル)を作成および編集した後、wsloadcfというコマンドライン・ユーティリティを使用して、XMLファイル(SALTDEPLOYファイルと参照WSDFファイル)をバイナリ・ファイル(SALTCONFIG)に変換することができます。これで、Oracle SALTゲートウェイ(GWWS)サーバーを起動する準備が整いました。

以下に、アプリケーションを構成するために使用できるOracle SALTコマンドライン・ユーティリティを示します。

wsloadcf(1)

各Oracle Tuxedoマシン上で開始されるコマンドです。これを使用すると、アプリケーションのSALTDEPLOYファイルおよび参照WSDFファイルをバイナリSALTCONFIGファイルにコンパイルできます。wsloadcfコマンドは、SALTCONFIG環境変数によって定義された場所にバイナリ・ファイルをロードします。

wsdlcvt(1)

外部WSDL(Web Services Description Language)ファイルをOracle Tuxedo定義ファイル(WSDFファイル、Oracle Tuxedoサービス・メタデータ定義ファイル、FML32フィールド表ファイルおよびXMLスキーマ・ファイル)に変換するコマンドです。生成されたWSDFファイルは、特にOracle SALT発信呼出しのために使用される非ネイティブWSDFファイルです。

Oracle SALTはOracle Tuxedoフレームワーク上に構築されているため、Oracle Tuxedoで提供されている次のコマンドライン・ユーティリティを使用してOracle SALT固有の項目をOracle Tuxedoアプリケーションに構成する必要があります。

tmloadcf(1)

マスターOracle Tuxedoマシン上で実行するコマンドです。これは、Oracle TuxedoアプリケーションUBBCONFIGファイルをバイナリTUXCONFIGファイルにコンパイルするのに使用されます。Oracle SALTゲートウェイ・サーバーを起動するには、GWWSサーバーをUBBCONFIGファイルで定義する必要があります。

tmloadrepos(1)

Oracle Tuxedoサービス・メタデータ・リポジトリ・システム・サーバー(TMMETADATA)が起動されているマシン上で実行するコマンドです。これは、Oracle Tuxedoサービス・メタデータ定義テキスト・ファイルをバイナリOracle Tuxedoサービス・メタデータ・リポジトリ・ファイルにロードします。Webサービス操作として公開するすべてのOracle Tuxedoの従来のサービスをOracle Tuxedoサービス・メタデータ・リポジトリにロードする必要があります。また、すべてのwsdlcvtで生成されたOracle SALTプロキシ・サービスをOracle Tuxedoサービス・メタデータ・リポジトリにロードする必要があります。

コマンドライン・ユーティリティを使用したOracle SALTアプリケーションの管理

コマンドライン・ユーティリティwsadmin(1)を使用して、Oracle Tuxedoアプリケーション内でOracle SALTゲートウェイ・サーバーの管理機能を実行できます。tmadmin、dmadminおよびqmadminコマンドと同じように、wsadminは、サブコマンドを実行できる対話型のメタコマンドです。

Oracle Tuxedoアプリケーションでは、マシン上でwsadmin(1)を実行して、Oracle Tuxedoアプリケーションに定義されたOracle SALTゲートウェイ・サーバーをモニターおよび管理できます。

Oracle SALT SCAのデプロイメント・モデル

SCAコンポジットは、関連付けられた構成ファイル内に記述し、ファイル名の末尾を「.composite」にするのが一般的です。このファイルでは、サービス・コンポーネント定義言語(SCDL)というXMLベースのフォーマットを使用して、コンポジットに含めるコンポーネントを記述したり、コンポーネント間の関係を指定したりします。Oracle SALT SCAをデプロイするためには、少なくとも1つのルート・コンポジット・ファイルを$APPDIRに配置する必要があります。

SCAコンポジットの構成ファイル (.composite)
SCAコンポーネントの構成ファイル (.componentType)

ルートのコンポジット・ファイルには、1つまたは複数のコンポーネントを構成できます。各コンポーネントのサブディレクトリには、そのコンポーネント独自の.compositeファイルと.componentTypeファイルが格納されます。

SCAコンポジットの構成ファイル

コンポジット内には、ゼロ個以上のコンポーネント要素を含めることができます。ルートのコンポジット・ファイルは、サーバー環境の$APPDIR内に格納する必要があります。

リスト 1-1に、2つのコンポーネントからなるルート・コンポジットのサンプルを示します。

<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0" name="ECHO.app">
       <component name="ECHO">
              <implementation.composite name="ECHO" />
       </component>
       <component name="TOUPPER">
              <implementation.composite name="TOUPPER" />
       </component>
</composite>

リスト1-1の構成に基づいて、リスト1-2では、暗黙的なディレクトリ階層を示します。

この例は典型的なサーバー構成です。Oracle Tuxedo SCAクライアントのアプリケーション・トポロジもこれとよく似ており、クライアント・アプリケーションをルートのコンポジット・ファイルのサブディレクトリに配置します。リスト1-3では、ECHOによって提供されるECHO1サービスを使用するEchoClientというクライアントのディレクトリ構造を示します。

SCAコンポーネントの構成ファイル

コンポーネントとは、SCAアセンブリ内のビジネス機能の基本要素です。これらのコンポーネントをSCAコンポジットによって結合することでビジネス・ソリューションが完成します。コンポーネントは、実装の構成済みインスタンスです。サービスを提供し、サービスを消費します。複数のコンポーネントで同じ実装を使用し、それぞれ違う実装として構成することも可能です。

コンポーネントは、xxx.compositeファイル内でコンポジットのサブ要素として宣言します。1つのコンポーネントは、コンポジット要素の子である1つのコンポーネント要素で表現します。リスト 1-1のコンポジットを使用して、2つのコンポーネント(ECHOおよびTOUPPER)に情報を含めます。ECHOサービス($APPDIR/ECHO/ECHO.composite)のECHO.compositeの情報をリスト 1-4に示します。

<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
       name="ECHO">
       <service name="ECHO">
              <interface.cpp header="ECHO.h" />
              <binding.atmi requires="legacy">
                     <map target="EchoString1">ECHO1</map>
                     <map target="EchoString2">ECHO2</map>
              </binding.atmi>
              <reference>EchoServiceComponent</reference>
       </service>
       <component name="EchoServiceComponent">
              <implementation.cpp library="ECHO" header="ECHOImpl.h" />
       </component>
</composite>

ECHOサービスは、2つのOracle Tuxedoサービス(ECHO1およびECHO2)を提供します。ECHO1は、CPP関数「EchoString1」を実行します。ECHO2は、CPP関数「EchoString2」を実行します。ここでは、$APPDIR/ECHO/ECHOImpl.componentTypeおよび$APPDIR/ECHO/ECHO.soの存在が暗示されています。リスト1-5では、ECHOImpl.componentTypeに含める情報の例を示します。

ECHO.so(WindowsではECHO.dll)は、EchoString1とEchoString2の実装が格納された共有ライブラリで、サービスの初期化時にメモリーにロードされます。ECHO1およびECHO2は、サーバーの初期化時に動的に公開されます。たとえば、これら2つのサービスを提供するOracle TuxedoサーバーがEchoServerである場合は、Oracle Tuxedo UBBCONFIGファイルにリスト1-6に示すような情報を含める必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<componentType xmlns="http://www.osoa.org/xmlns/sca/1.0"
       xmlns:xs="http://www.w3.org/2001/XMLSchema">
       <service name="ECHO">
              <interface.cpp header="ECHO.h"/>
       </service>
</componentType>

TOUPPERサービスの場合は、ECHO.app.compositeファイルによって$APPDIR/TOUPPER/TOUPPER.compositeの存在も暗示されます。リスト 1-7に、TOUPPER.compositeファイルに含める情報の例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
       name="TOUPPER">
       <service name="TOUPPER">
              <interface.cpp header="TOUPPER.h" />
                     <binding.atmi requires="legacy">
                            <map target="UpperString1">TOUPPER1</map>
                            <map target="UpperString2">TOUPPER2</map>
                     </binding.atmi>
              <reference>ToupperServiceComponent</reference>
       </service>

       <component name="ToupperServiceComponent">
              <implementation.cpp library="TOUPPER" header="TOUPPERImpl.h" />
       </component>

このコンポジット・ファイルでも、$APPDIR/TOUPPER/TOUPPERImpl.componentTypeおよび$APPDIR/TOUPPER/TOUPPER.soの存在が暗示されています。

Oracle SALT Webアプリケーション・サーバーの管理タスクおよびツール

Oracle SALTは次のようなWebアプリケーション・サーバー管理ツールを提供します。

Webモジュールのmod_tuxedo (ApacheまたはOHS用)、tux_nsapi (iPlanet用)。構成要素はそれぞれの構成ファイル(httpd.confまたはmagnus.conf)内にあります。
mod_tuxedoまたはtux_nsapiからプロキシされたHTTPリクエストを提供するWEBHNDLRシステム・サーバー。このシステム・サーバーはUBBConfigファイルで構成され、一般的なOracle Tuxedoコマンドを使用して管理されます。

詳細は、『Oracle SALTインストレーション・ガイド』と、「Oracle SALTの実行時の管理」および「Oracle SALTアプリケーションの構成」を参照してください。

Oracle SALT SCAの管理タスクおよびツール

Oracle SALT SCAでは、Oracle Tuxedoシステム上に構築されているOracle SALT SCAアプリケーションを管理するために一連のコマンドライン・ユーティリティが提供されます。これらのユーティリティのほとんどはアプリケーション開発用ですが、管理用のユーティリティも2つ含まれています。詳細は、Oracle SALTリファレンス・ガイドを参照してください。

SCAクライアントのパスワードの構成

scapasswordtoolコマンドライン・ユーティリティを使用すると、Oracle SALT SCAセキュリティを構成できます。ここれにより、SCAクライアント内でOracle Tuxedo認証のパスワードを管理し、パスワードのストア・ファイル(password.store)に値を設定できます。

Oracle TuxedoセキュリティがAPP_PW以上に設定されている場合、SCAコンポーネントがOracle Tuxedoベースのサービスを参照すると、SCAコンポーネントではpassword.storeファイルを検索し、構成コンポジット・ファイル内のパスワードおよびユーザーIDに一致するエントリがあるかどうかがチェックされます。ユーザーIDはプレーン・テキストですが、パスワードは暗号化されています。

パスワードを作成する

ユーザーIDおよびパスワードを追加または作成するには、次の手順に従います。

プロンプトにscapasswordtool -i userID -aと入力します。
プロンプトにパスワード(passwordなど)を入力します。
プロンプトに確認用のパスワード(passwordなど)を入力します。

ユーザーIDおよびパスワードを削除するには、scapasswordtool -i userID -dと入力します。

ユーザーIDとそれに関連付けられているパスワードが削除されます。

Oracle Tuxedo SCAアプリケーションの管理

サービスをATMIバインディングで宣言するOracle Tuxedo SCAコンポーネントは、通常のOracle Tuxedoサービスとして管理します。管理者は、既存のOracle Tuxedoコマンド(tmadmin、tmboot、tmshutdownなど)を使用して、このようなサーバーの新規インスタンスを起動、モニターまたは停止できます。

管理者が特定のメソッドのアクティビティや可用性をモニターするには、tmadminを使用して、SCDLファイルに定義されたATMIバインディング内に宣言されているサービスを選択します。

buildscaserverコマンドで構築した各SCAサーバーも、scaadminコマンドライン・ユーティリティを使用して呼び出すことのできる管理機能を備えています。

Oracle SALT WS-TXの管理タスクおよびツール

Oracle SALTでは、WS-TXトランザクションを管理およびサポートするための一連のコマンド・ユーティリティが提供されます。これらのユーティリティの名前および使用方法は、 Oracle SALTリファレンス・ガイドと同じです。

詳細は、『Oracle Tuxedo相互運用性ガイド』のWX-TXサポートに関する項と、『Oracle SALT構成ガイド』のOracle SALTのWX-TXサポートの構成に関する項を参照してください。

管理ガイド