Oracle Tuxedoサービス・コンソールの使用

11 Oracle Tuxedoサービス・コンソールの使用

このトピックには、次の項があります。

11.1 概要

Oracle Tuxedoサービス・コンソールのユーザー・インタフェースには、次の機能があります。

Tuxedoメタデータ・リポジトリ・エディタ: JOLT、SALTまたはその他のOracle Tuxedoコンポーネントで使用されるOracle Tuxedoサービス定義を追加、編集または削除できます。
Webサービス(SOAPおよびREST)構成: Oracle TuxedoサービスにSOAPまたはRESTサービスとしてアクセスしたり、Oracle Tuxedoアプリケーションから外部のSOAP/REST Webサービスにアクセスすることができます。

このコンソールを使用するには、新しいTuxedoシステム・サーバーTMADMSVRをUBBCONFIGで構成します。詳細は、「Oracle Tuxedoサービス・コンソールのデプロイ」を参照してください

前提条件

Oracle Tuxedoサービス・コンソールを使用するには、次の最小要件を満たす必要があります:

Oracle Tuxedoバージョン: Oracle Tuxedoサービス・コンソールは、Oracle Tuxedo (22.1.0.0.0)リリースで使用できます。
RPレベル: Tuxedo 22.1.0.0.0 RP027以上。

SALT 22.1.0.0.0 RP10以上。
サポートされているプラットフォーム: x86-64のOracle Linux 7および8 (64ビットOS)
サポートされているブラウザ: Firefoxバージョン133.0およびChromeバージョン131.0.6778.86

親トピック: Oracle Tuxedoサービス・コンソールの使用

11.2 Oracle Tuxedoサービス・コンソールのデプロイ

ノート:

TuxedoドメインがMPモードの場合、GWWSとTMADMSVRの両方を同じノードにデプロイし、そのノードにSALT 22.1.0.0.0 RP10 (またはそれ以降)とTuxedo 22.1.0.0.0 RP027 (またはそれ以降)を適用する必要があります。

Oracle Tuxedoサービス・コンソールをデプロイするには、次のステップに従います:

Oracle Tuxedoサービス・コンソールの構成ファイルを生成します。

Oracle Tuxedoサービス・コンソールの構成ファイルの例を次に示します。

例

$cat tmadmsvrcfg.dep
    <?xml version="1.0" encoding="utf-8"?>
    <Deployment xmlns="http://www.bea.com/Tuxedo/SALTDEPLOY/2007">
        <WSDF>
            <Import location="tmadmsvrcfg.wsdf"></Import>
        </WSDF>
        <WSGateway>
            <GWInstance id="SYSTEM">
                <Properties></Properties>
            </GWInstance>
        </WSGateway>
        <System>
          <Certificate>
            <!-- PrivateKey>/scratch/tmadmsvr/wallet.mywallet</PrivateKey>     # Uncomment the line and configure the path of the wallet if you want to enable HTTPS for the Service Console
          </Certificate>
        </System>
    </Deployment>

$cat tmadmsvrcfg.wsdf
    <?xml version="1.0" encoding="utf-8"?>
    <Definition xmlns="http://www.bea.com/Tuxedo/WSDF/2007" name="tmadmsvr">
    </Definition>

# Oracle Tuxedoサービス・コンソールのファイルtmadmsvrcfgをコンパイルするには、次のようにSALTCONFIGを設定します。

SALTCONFIG=$APPDIR/tmadmsvrcfgのエクスポート

ノート:
ファイル名はtmadmsvrcfgである必要があります
wsloadcf -y tmadmsvrcfg.dep
# SALTCONFIGを正しいSALT構成にリセットします
SALTCONFIG=$APPDIR/saltconfigのエクスポート
# SALTのSALTCONFIGをコンパイルします。SALT構成に変更がない場合、このステップをスキップできます。
wsloadcf -y <your SALT deployment file>

UBBconfigの更新

TMADMSVRをUBBconfigに追加

httpプロトコルを使用するには、次の構成を使用します

TMADMSVR SRVGRP=TMADMGRP SRVID=1

        CLOPT="-A -- -a  http:<hostname>:<port number> "

httpsの場合、次の構成を使用します:

TMADMSVR SRVGRP=TMADMGRP SRVID=10
        SEC_PRINCIPAL_NAME="<your wallet name>"
        SEC_PRINCIPAL_LOCATION="<root dir of your wallet directory>" 
        SEC_PRINCIPAL_PASSVAR="PASSVAR"       # Environment variable to store your wallet password. Here its name is PASSVAR. It should be set before tmboot
        CLOPT="-A -- -a  https://<hostname>:<port number> "

TUXCONFIGをロードしてTuxedoドメインを起動
TUXCONFIG=$APPDIR/tuxconfigのエクスポート

tmloadcf -y UBBconfig

# Tuxedoドメインを起動します

tmboot -y

TMADMSVRのHTTPSを構成すると、http://<hostname>:<port number>/admin/index.htmlまたはhttps://<hostname>:<port number>/admin/index.htmlでOracle Tuxedoサービス・コンソールにアクセスできます。

ノート:

TLS対応WSDLをインポートする場合は、最初にWSDLをダウンロードしてから、ローカルWSDLファイルとしてインポートすることをお薦めします。
RESTサービスのインポートまたはエクスポート時には、Content-Type (JSONまたはXML)を指定する必要があります。

親トピック: Oracle Tuxedoサービス・コンソールの使用

11.3 Oracle Tuxedoサービス・コンソール

Oracle Tuxedoサービス・コンソールには、Webブラウザ(http://hostname:port/admin/index.html)を使用してアクセスできます。

また、TMADMSVR -aオプションを使用して、http://hostname:portを指定できます。

詳細は、「TMADMSVR」を参照してください

Oracle Tuxedoサービス・コンソールのメイン・ページには、次のタイトルがあります:

親トピック: Oracle Tuxedoサービス・コンソールの使用

11.3.1 メイン・ページ

次に、Oracle Tuxedoサービス・コンソールのユーザー・インタフェースのメイン・ページを示します。

図11-1 Oracle Tuxedoサービス・コンソールのメイン・ページ

親トピック: Oracle Tuxedoサービス・コンソール

11.3.2 メタデータ・リポジトリ

「メタデータ・リポジトリ」ページは、Oracle Tuxedoサービス・コンソール内でTuxedoサービス定義を管理するための中心となるハブです。このページには、インポートおよびエクスポートされたすべてのTuxedoサービスのリストが、対応する詳細とともに表示されます。

主な機能は次のとおりです:

新しいTuxedoサービス定義の追加
サービス定義の変更
サービス定義の削除

また、このページには、トグル・ボタンを使用してサービス検出を有効にするオプションがあります。トグル・ボタンが有効な場合、コンソールはサービスを自動的に検出してリストし、Tuxedoサービスの完全で最新のビューを確保します。したがって、サービス検出を有効にすると、Tuxedoサービスが動的に配置されて呼び出されます。

図11-2 メタデータ・リポジトリ

親トピック: Oracle Tuxedoサービス・コンソール

11.3.3 SALTゲートウェイ・プロパティ

SALTのプロパティ・ページでは、管理者はエクスポートおよびインポートされたすべてのWebサービスに対して様々なゲートウェイ設定を構成できます。エクスポートおよびインポートされたすべてのWebサービスの動作を設定するには、SALTゲートウェイ・プロパティを構成する必要があります。これにより、Tuxedoサービスが安全に公開され、Webクライアントやその他の外部システムとシームレスにやり取りできるようになります。設定したSALTゲートウェイ・プロパティは、Webサービスとして公開された新規Tuxedoサービス、またはTuxedoによって呼び出された既存のWebサービスに適用されます。

図11-3 SALTのプロパティ

親トピック: Oracle Tuxedoサービス・コンソール

11.3.4 Webサービス(SOAP)のエクスポート

「Webサービス(SOAP)のエクスポート」ページでは、既存のTuxedoサービスをSOAPベースのWebサービスとして公開できます。これにより、他のアプリケーションおよびシステムとのシームレスな統合が可能になります。WSDLの生成、セキュリティおよびデプロイメントを構成するためのグラフィカル・インタフェースを提供することで、Tuxedoサービスをより広範なエンタープライズ・エコシステムに公開するプロセスを合理化します。また、TuxedoベースのサービスとWebベースまたはサービス指向アーキテクチャ(SOA)間の通信も可能です。

次のステップに従って、Oracle TuxedoサービスをSOAPベースのWebサービスとしてエクスポートします。

サービスを公開するには、サービスのサービス定義名を指定する必要があります。

図11-4 サービスの作成
次に、新しいサービスにバインディングを追加します。

ノート:
バインディングは、クライアントとサーバーの両方が、ネットワークを介した通信方法、使用するプロトコル、およびメッセージのエンコードとデコード方法について相互に理解していることを確認するのに役立ちます。

図11-5 バインディングの追加

図11-6 バインディングの変更
操作(Tuxedoサービス)リストから、公開するサービスを選択します。

ノート:
メタデータ・リポジトリで作成された構成に従って、すべてのOracle Tuxedoサービスがリストされます。

図11-7 操作(Tuxedoサービス)
公開するサービスのポリシー・ファイルおよびメッセージ・ハンドラを構成します。詳細は、SALT Webサービス定義ファイルのリファレンスを参照してください

図11-8 ポリシーおよびメッセージ・ハンドラの構成
次に、サービスをパブリッシュします。

図11-9 サービスのパブリッシュ

親トピック: Oracle Tuxedoサービス・コンソール

11.3.5 Webサービス(SOAP)のインポート

Oracle Tuxedoサービス・コンソールのユーザー・インタフェースの「Webサービス(SOAP)のインポート」ページでは、外部のSOAPベースのWebサービスをTuxedoサービスと統合できます。Tuxedoは、SOAPサービスをインポートおよび構成することで、その機能を拡張して外部アプリケーションまたはシステムとやり取りできます。したがって、異なるプラットフォーム間の相互運用性を実現します。

「Webサービス(SOAP)のインポート」ページでは、Tuxedo環境内でSOAPサービスをインポートするプロセスが簡略化されます。このページでは、次のいずれかの方法でWebサービス定義をインポートできます:

ファイル・システムからのローカルWSDLファイルのアップロード
リモートでホストされるWSDLファイルへのURLの指定

インポートされると、Tuxedoアプリケーションは外部Webサービスを呼び出すことができます。

図11-10 Webサービス(SOAP)のインポート

親トピック: Oracle Tuxedoサービス・コンソール

11.3.6 REST Webサービス

Oracle Tuxedoサービス・コンソールのユーザー・インタフェースの「REST Webサービス」ページでは、既存のTuxedoサービスをRESTベースのWebサービスとして公開し、外部のRESTベースのWebサービスをインポートできます。これにより、他のアプリケーションとのシームレスな統合が可能になります。Oracle Tuxedoの既存のWebサービスを公開し、外部のRESTサービスをインポートすることで、Oracle Tuxedoはその機能を拡張して外部アプリケーションまたはシステムとやり取りできます。これにより、異なるプラットフォーム間の相互運用を実現します。

「Rest Webサービス」ページでは、RESTベースのWebサービスのエクスポートおよびインポートのプロセスが簡略化され、管理者および開発者がTuxedoサービスを最新のWebベース・アプリケーションに簡単に統合できるようになります。

図11-11 Rest Webサービス

親トピック: Oracle Tuxedoサービス・コンソール