Production サンプル・アプリケーション

ここでは、以下の内容について説明します。

• Production サンプル・アプリケーションのしくみ

• Production サンプル・アプリケーションの開発プロセス

• Production サンプル・アプリケーションのビルド

• Production サンプル・アプリケーションのコンパイル

• Production サンプル・アプリケーションの実行

• Production サンプル・アプリケーションをさらにスケーリングする方法

注記 Production サンプル・アプリケーションのクライアント・アプリケーションは、Wrapper サンプル・アプリケーションのクライアント・アプリケーションと同じ方法で動作します。

トラブルシューティング情報については、¥production ディレクトリにある Readme.txt を参照してください。また、Production サンプル・アプリケーションの使用方法に関する最新の情報も参照してください。

 

---

Production サンプル・アプリケーションのしくみ

Production サンプル・アプリケーションには、Wrapper サンプル・アプリケーションと同じエンド・ユーザ向けの機能が用意されています。Production サンプル・アプリケーションでは、BEA Tuxedo ソフトウェアの CORBA 機能を利用して、CORBA アプリケーションをスケーリングする方法を示します。Production サンプル・アプリケーションでは、以下の処理を行います。

• UBBCONFIG ファイルに定義されている ORA_GRP および APP_GRP サーバ・グループ内で、University サーバ・アプリケーション、Billing サーバ・アプリケーション、および ATMI Teller アプリケーションを複製します。

• 追加のサーバ・マシン (Production マシン 2) 上で、ORA_GRP1 および APP_GRP1 サーバ・グループを ORA_GRP2 および APP_GRP2 として複製し、データベースを分割します。

• サーバ・アプリケーションが同時に管理できるクライアント・アプリケーションからの要求数を増やすために、状態を持たないオブジェクト・モデルをインプリメントします。

• 次のオブジェクトに一意なオブジェクト ID (OID) を割り当てて、対応するサーバ・グループでそれらのオブジェクトを同時に複数回インスタンス化できるようにします。これにより、次のオブジェクトをプロセス単位ではなく、クライアント・アプリケーション単位で利用できるようになります。

  • Registrar

  • RegistrarFactory

  • Teller

  • TellerFactory

• 一部の学生から 1 台のマシンへの要求、およびほかの学生から別のサーバ・マシンへの要求の代わりに、クライアント・アプリケーションからの直接の要求にファクトリ・ベース・ルーティングをインプリメントします。

注記 Production サンプル・アプリケーションの使用を簡単にするために、BEA Tuxedo ソフトウェア・キットでは、1 台のマシン上で 1 つのデータベースを使用して実行できるようにコンフィギュレーションされています。ただし、Production サンプル・アプリケーションでは、複数のマシンで複数のデータベースを使用して実行できるようにコンフィギュレーションされています。複数のマシンおよびデータベースへのコンフィギュレーションを変更する場合、UBBCONFIG ファイルを変更し、データベースを分割するだけで変更できます。

以下の節では、Production サンプル・アプリケーションで、複製されたサーバ・アプリケーション、複製されたサーバ・グループ、オブジェクト状態管理およびファクトリ・ベース・ルーティングを使用して、Production サンプル・アプリケーションをスケーリングする方法について説明します。

サーバ・アプリケーションの複製

サーバ・アプリケーションを複製すると、以下の処理が可能になります。

• クライアント・アプリケーションからそのサーバ・アプリケーションに着信する要求の負荷のバランシングを行う方法が得られます。要求がサーバ・グループの Tuxedo ドメインで受信されると、BEA Tuxedo システムは、グループ内で負荷が最も低いサーバ・アプリケーションに要求をルーティングします。

• サーバ・マシン上で実行する任意のサーバ・アプリケーション・プロセスのコピー数を指定できます。コピー数によって、クライアント・アプリケーションからの要求を Tuxedo ドメインが並列処理できるレベルが決まります。

• サーバ・アプリケーションの 1 つが処理を停止した場合でも、有効なフェイルオーバー保護機能が用意されます。

Production サンプル・アプリケーションでは、サーバ・アプリケーションは次の方法で複製されます。

• University サーバ・アプリケーション、ATMI Teller アプリケーション、および University データベースのサーバ・アプリケーションは、ORA_GRP グループ内で複製されます。

• Billing サーバ・アプリケーションは、APP_GRP グループ内で複製されます。

図7-1 では、複製された ORA_GRP および APP_GRP サーバ・グループを示しています。

図 7-1 Production サンプル・アプリケーションの複製されたサーバ・グループ

 

図7-1 では、次の点に注意してください。

• RegistrarFactory、Registrar、TellerFactory、または Teller オブジェクトのインスタンスは、1 つのサーバ・アプリケーション・プロセス内に1 つしか存在できません。

• CourseSynopsisEnumerator オブジェクトは、1 つのサーバ・アプリケーション・プロセス内に任意の数だけ存在できます。

サーバ・グループの複製

サーバ・グループは、既存の CORBA アプリケーションにサーバ・マシンを追加できる、BEA Tuxedo ソフトウェアの機能です。サーバ・グループを複製すると、次の処理が可能になります。

• CORBA アプリケーションの処理にかかる負荷を複数のサーバ・マシンに分散できます。

• ファクトリ・ベース・ルーティングを使用して、クライアント・アプリケーションからの要求を特定のサーバ・マシンに送信できます。

サーバ・グループのコンフィギュレーションおよび複製方法は、UBBCONFIG ファイルで指定します。

図7-2 では、2 番目のサーバ・マシンで複製された Production サンプル・アプリケーションのサーバ・グループを示しています。Production サンプル・アプリケーションの UBBCONFIG ファイルでは、複製されたサーバ・グループは、ORA_GRP2 および APP_GRP2 として定義されています。

図 7-2 サーバ・マシン間でのサーバ・グループの複製

 

図7-2 では、Production マシン 1 および 2 のサーバ・グループの内容で異なるのはデータベースのみです。University データベースは、2 つのデータベースに分割されています。Production マシン 1 のデータベースには、ID が 100001 〜 100005 の学生の学生情報および口座情報が格納されています。Production マシン 2 のデータベースには、ID が 100006 〜 100010 の学生の学生情報および口座情報が格納されています。

状態を持たないオブジェクト・モデルの使用方法

スケーラビリティを向上させるには、Production サンプル・アプリケーションで、Registrar および Teller オブジェクトが method 活性化方針を持つようにコンフィギュレーションします。method 活性化方針によって、オブジェクトの振る舞いは次のように変化します。

• オブジェクトが呼び出されると、常に適切なサーバ・グループで Tuxedo ドメインによってインスタンス化されます。

• 呼び出しが完了すると、オブジェクトは Tuxedo ドメインによって非活性化されます。

Basic から Production までのサンプル・アプリケーションの Registrar オブジェクトには、process という活性化方針があります。Registrar オブジェクトのクライアント・アプリケーションの要求は、すべてサーバ・マシンのメモリにある同じオブジェクトのインスタンスに送られます。この設計は小規模なデプロイメントに適しています。ただし、クライアント・アプリケーションからの要求が増加すると、Registrar オブジェクトの要求はキューに登録されるようになり、応答時間が遅くなります。

これに対し、Registrar および Teller オブジェクトに method 活性化方針があり、これらのオブジェクトを管理するサーバ・アプリケーションを複製することにより、Registrar および Teller オブジェクトはクライアント・アプリケーションからの複数の要求を並列処理できるようになります。唯一の制限は、Registrar および Teller オブジェクトのインスタンス化に利用可能なサーバ・アプリケーション・プロセスの数です。

CORBA アプリケーションでは、複製済みの各サーバ・アプリケーション・プロセスで Registrar および Teller オブジェクトのコピーをインスタンス化するために、Registrar および Teller オブジェクトには、一意なオブジェクト ID (OID) が割り当てられています。一意な OID は、これらのオブジェクトを作成するファクトリで割り当てられます。一意なオブジェクト ID の生成についての詳細は、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

ファクトリ・ベース・ルーティングの使用方法

ファクトリ・ベース・ルーティングは、クライアント・アプリケーションからの要求を特定のサーバ・グループに送信可能にする CORBA の機能です。ファクトリ・ベース・ルーティングを使用すると、CORBA アプリケーションの処理にかかる負荷を複数のサーバ・マシンに分散できます。Production サンプル・アプリケーションでは、ファクトリ・ベース・ルーティングを次のように使用します。

• クライアント・アプリケーションから Registrar オブジェクトへの要求は、学生 ID に基づいてルーティングされます。ID が 100001 〜 100005 の学生からの要求は、Production マシン 1 にルーティングされます。ID が 100006 〜 100010 の学生からの要求は、Production マシン 2 にルーティングされます。

• Registrar オブジェクトから Teller オブジェクトへの要求は、口座番号に基づいてルーティングされます。200010 から 200014 までの口座番号への支払い要求は、Production マシン 1 にルーティングされます。200015 から 200019 までの口座番号への支払い要求は、Production マシン 2 にルーティングされます。

ファクトリ・ベース・ルーティングの設定についての詳細は、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

 

---

Production サンプル・アプリケーションの開発プロセス

ここでは、CORBA アプリケーションのスケーリングに必要な開発プロセスについて説明します。以下の手順は、Basic サンプル・アプリケーションで概説した開発手順の追加手順です。

注記 この節に記載されている手順はすでに完了しており、Production サンプル・アプリケーションに組み込まれています。

OMG IDL

開発プロセスでは、ファクトリ・ベース・ルーティングをサポートするために、Object Management Group (OMG) インターフェイス定義言語 (IDL) の次のオペレーションの定義を変更します。

• 学生 ID を要求する、RegistrarFactory オブジェクトの find_registrar() オペレーション

• 口座番号を要求する、TellerFactory オブジェクトの find_teller() オペレーション

ファクトリ・ベース・ルーティングのインプリメントについての詳細は、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

クライアント・アプリケーション

開発プロセスでは、Registrar オブジェクトの作成時に STU_ID 値を指定します。STU_ID 値には、クライアント・アプリケーションからの要求のルーティング先となるサーバ・グループを定義します。

Production サンプル・アプリケーションでは、クライアント・アプリケーションの場合と同じ方法で、University サーバ・アプリケーションで Teller オブジェクトが作成されます。そのため、Teller オブジェクトの作成時に ACT_NUM 値を指定する必要があります。

サーバ・アプリケーション

開発プロセスでは、RegistrarFactory と TellerFactory オブジェクトの TP::create_object_reference() オペレーションの呼び出しを変更して、ルーティング基準を指定する NVlist を組み込む必要があります。TP::create_object_reference() オペレーションの criteria パラメータには、ファクトリ・ベース・ルーティングで使用する名前付き値のリストを次のように指定します。

• Production サンプル・アプリケーションの RegistrarFactory オブジェクトは、criteria の値を STD_ID として指定します。

• Production サンプル・アプリケーションの TellerFactory オブジェクトは、criteria の値を ACT_NUM として指定します。

criteria パラメータの値は、UBBCONFIG ファイルの ROUTING セクションで指定したルーティング基準名、フィールド、およびフィールド型と正確に一致しなければなりません。

ファクトリでのファクトリ・ベース・ルーティングのインプリメントについての詳細は、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

UBBCONFIG ファイル

CORBA アプリケーションにおけるスケーラビリティの向上には、UBBCONFIG ファイルが重要な役割を果たします。ここでは、Production サンプル・アプリケーションの UBBCONFIG ファイルを変更して次の処理を行う方法について説明します。

• サーバ・アプリケーション・プロセスおよびサーバ・グループの複製

• ファクトリ・ベース・ルーティングのインプリメント

サーバ・アプリケーション・プロセスおよびサーバ・グループの複製

開発プロセスでは、以下の方法で UBBCONFIG ファイルを変更して、サーバ・アプリケーション・プロセスおよびサーバ・グループの複製をコンフィギュレーションします。

1. UBBCONFIG ファイルの GROUPS セクションに、コンフィギュレーションするグループの名前を指定します。Production サンプル・アプリケーションには、APP_GRP1、APP_GRP2、ORA_GRP1、および ORA_GRP2 の 4 つのサーバ・グループがあります。

2. UBBCONFIG ファイルの SERVERS セクションに、複製するサーバ・アプリケーション・プロセスに関する次の情報を入力します。

   • サーバ・アプリケーションの名前。

   • GROUP パラメータ。サーバ・アプリケーション・プロセスが属するサーバ・グループの名前を指定します。複数のグループに関係するサーバ・プロセスを複製する場合は、各グループに 1 つずつサーバ・プロセスを指定します。

   • SRVID パラメータ。サーバ・マシンの一意な管理 ID を指定します。

   • MIN パラメータ。CORBA アプリケーションの起動時に開始する、サーバ・アプリケーション・プロセスのインスタンス数を指定します。開始するサーバ・アプリケーション・プロセスは最低 2 つ必要です。

   • MAX パラメータ。同時に実行できるサーバ・アプリケーション・プロセスの最大数を指定します。指定可能なサーバ・アプリケーション・プロセスの数は最大 5 つです。

MIN および MAX パラメータによって、任意のオブジェクトで任意のサーバ・アプリケーションが要求をどの程度まで並列処理できるかを指定します。実行時には、必要に応じて、システム管理者がリソースのボトルネックを調べて、新しいサーバ・プロセスを起動することができます。このように、アプリケーションのスケーリングは、システム管理者が行います。

次に、Production サンプル・アプリケーションの UBBCONFIG ファイルの GROUPS および SERVERS セクションから引用した行を例示します。

*GROUPS
    APP_GRP1
        LMID      = SITE1
        GRPNO     = 2
        TMSNAME   = TMS
    APP_GRP2
        LMID      = SITE1
        GRPNO     = 3
        TMSNAME   = TMS
    ORA_GRP1
        LMID      = SITE1
        GRPNO     = 4
        OPENINFO  = "ORACLE_XA:Oracle_XA+Acc=P/scott/tiger+SesTm=100+LogDir
                     =.+MaxCur=5"
        CLOSEINFO = ""
        TMSNAME   = "TMS_ORA"
    ORA_GRP2
        LMID      = SITE1
        GRPNO     = 5
        OPENINFO  = "ORACLE_XA:Oracle_XA+Acc=P/scott/tiger+SesTm=100+LogDir
                    =.+MaxCur=5"
        CLOSEINFO = ""
        TMSNAME   = "TMS_ORA"
		

*SERVERS
    # デフォルトでは、各サーバのインスタンスを 2 つ活性化
    # して、管理者が各サーバのインスタンスを 5つ
    # まで活性化できるようにしている
    DEFAULT:
        MIN     = 2
        MAX     = 5
    tellp_server
        SRVGRP  = ORA_GRP1
        SRVID   = 10
        RESTART = N
    tellp_server
        SRVGRP  = ORA_GRP2
        SRVID   = 10
        RESTART = N
    billp_server
        SRVGRP  = APP_GRP1
        SRVID   = 10
        RESTART = N
    billp_server
        SRVGRP  = APP_GRP2
        SRVID   = 10
        RESTART = N
    univp_server
        SRVGRP  = ORA_GRP1
        SRVID   = 20
        RESTART = N
    univp_server
        SRVGRP  = ORA_GRP2
        SRVID   = 20
        RESTART = N

ファクトリ・ベース・ルーティングのインプリメント

ファクトリ・ベース・ルーティングを使用できるようにするには、各インターフェイスについて、UBBCONFIG ファイルに次の情報を定義する必要があります。

• ルーティング基準のデータの詳細

• 各基準ごとの、特定のサーバ・グループへルーティングするための値

開発プロセスでは、UBBCONFIG ファイルを以下のように変更します。

1. INTERFACES セクションには、ファクトリ・ベース・ルーティングを有効にするインターフェイスの名前の一覧が示されます。このセクションで、各インターフェイスのルーティング値を指定します。ルーティング値は、FACTORYROUTING 識別子で指定します。

   次に、Production サンプル・アプリケーションの Registrar および Teller オブジェクトの FACTORYROUTING 識別子の例を示します。

   INTERFACES
       "IDL:beasys.com/UniversityP/Registrar:1.0"
           FACTORYROUTING = STU_ID
       "IDL:beasys.com/BillingP/Teller:1.0"
           FACTORYROUTING = ACT_NUM

2. ROUTING セクションでは、ルーティング値ごとに以下のデータを指定します。

   • TYPE パラメータ。ルーティングの種類を指定します。Production サンプル・アプリケーションでは、ルーティングの種類はファクトリ・ベース・ルーティングです。したがって、このパラメータは、FACTORY と定義します。

   • FIELD パラメータ。ファクトリがルーティング値に挿入する名前を指定します。Production サンプル・アプリケーションでは、フィールドのパラメータは student_id および account_number です。

   • FIELDTYPE パラメータ。ルーティング値のデータ型を指定します。Production サンプル・アプリケーションでは、STU_ID および ACT_NUM のフィールド・タイプは long です。

   • RANGES パラメータ。各グループにルーティングされる値を指定します。

   次に、Production サンプル・アプリケーションで使用する UBBCONFIG ファイルの ROUTING セクションの例を示します。

*ROUTING
    STU_ID
        FIELD     = "student_id"
        TYPE      = FACTORY
        FIELDTYPE = LONG
        RANGES    = "100001-100005:ORA_GRP1,100006-100010:ORA_GRP2"
    ACT_NUM
        FIELD     = "account_number"
        TYPE      = FACTORY
        FIELDTYPE = LONG
        RANGES    = "200010-200014:APP_GRP1,200015-200019:APP_GRP2"

上記の例では、ID が 100001 〜 100005 の学生の Registrar オブジェクトは ORA_GRP1 でインスタンス化され、ID が 100006 〜 100010 の学生のオブジェクトは ORA_GRP2 でインスタンス化されることを示しています。同様に、200010 〜 200014 の口座番号の Teller オブジェクトは APP_GRP1 でインスタンス化され、200015 〜 200019 の口座番号のオブジェクトは APP_GRP2 でインスタンス化されることを示しています。

UBBCONFIG ファイルの ROUTING セクションにある RANGES 識別子で指定されたグループを識別およびコンフィギュレーションする必要があります。たとえば、Production サンプル・アプリケーションでは、ORA_GRP1、ORA_GRP2、APP_GRP1、およびAPP_GRP2 の 4 つのグループが指定されています。これらのグループをコンフィギュレーションし、グループが実行されるマシンを識別する必要があります。

注記 GROUPS セクションのサーバ・グループの名前と ROUTING セクションで指定したグループの名前は、正しく一致している必要があります。

ICF ファイル

開発プロセスでは、Registrar、RegistrarFactory、Teller、および TellerFactory オブジェクトの活性化方針を process から method に変更する必要があります。CORBA オブジェクトの活性化方針およびトランザクション方針の定義についての詳細は、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

 

---

Production サンプル・アプリケーションのビルド

Production サンプル・アプリケーションをビルドするには、次の手順に従います。

1. Production サンプル・アプリケーションのファイルを作業ディレクトリにコピーします。

2. Production サンプル・アプリケーションのファイルの保護を変更します。

3. 環境変数を設定します。

4. University データベースを初期化します。

5. UBBCONFIG ファイルをロードします。

6. トランザクション・ログを作成します。

7. クライアントおよびサーバ・サンプル・アプリケーションをビルドします。

以降の節では、上記の各手順について説明します。

注記 Production サンプル・アプリケーションをビルドまたは実行する前に、環境設定の手順を実行しておく必要があります。

Production サンプル・アプリケーションのファイルを作業ディレクトリにコピーする

Production サンプル・アプリケーションの各ファイルは、次のディレクトリにあります。

Windows 2000

drive:¥TUXDIR¥samples¥corba¥university¥production

UNIX

/usr/TUXDIR/samples/corba/university/production

また、utils ディレクトリも作業ディレクトリにコピーする必要があります。utils ディレクトリには、ログ、トレース、および University データベースへのアクセスを設定するファイルが格納されています。

Production サンプル・アプリケーションを作成するには、表 7-1 のファイルを使用します。

表 7-1 Production サンプル・アプリケーションに含まれるファイル

ファイル	説明
billp.idl	Teller および TellerFactory インターフェイスを宣言する OMG IDL。
univp.idl	CourseSynopsisEnumerator、Registrar、および RegistrarFactory インターフェイスを宣言する OMG IDL。
billps.cpp	Production サンプル・アプリケーションの Billing サーバ・アプリケーション用 C++ ソース・コード。
univps.cpp	Production サンプル・アプリケーションの University サーバ・アプリケーション用 C++ ソース・コード。
billp__i.h billp_i.cpp	Teller および TellerFactory インターフェイスのメソッド・インプリメンテーション用 C++ ソース・コード。
univp_i.h univp_i.cpp	CourseSynopsisEnumerator、Registrar、および RegistrarFactory インターフェイスのメソッド・インプリメンテーション用 C++ ソース・コード。
univpc.cpp	Production サンプル・アプリケーションの CORBA C++ クライアント・アプリケーション用 C++ ソース・コード。
frmBrowser.frm	Production サンプル・アプリケーションの ActiveX クライアント・アプリケーション用 Visual Basic ソース・コード。
university.vbp	Production サンプル・アプリケーションの ActiveX クライアント・アプリケーション用 Visual Basic プロジェクト・ファイル。
University.vbw	Production サンプル・アプリケーションの ActiveX クライアント・アプリケーション用 Visual Basic ワークスペース・ファイル。
modPublicDeclarations.bas	サンプル・アプリケーションで使用される変数の宣言が記述された Visual Basic ファイル。
frmTracing.frm frmTracing.frx	ActiveX クライアント・アプリケーションにトレース機能を提供するファイル。
frmLogon.frm	ActiveX クライアント・アプリケーションに対してセキュリティ・ログオンを実行する Visual Basic ファイル。
univPApplet.java	Production サンプル・アプリケーションの CORBA Java クライアント・アプリケーション用 Java ソース・コード。
univp_utils.h univp_utils.cpp	CORBA C++ クライアント・アプリケーションのデータベース・アクセス関数を定義するファイル。
univp.icf	Production サンプル・アプリケーションの University サーバ・アプリケーション用インプリメンテーション・コンフィギュレーション・ファイル (ICF)。
billp.icf	Production サンプル・アプリケーションの Billing サーバ・アプリケーション用 ICF ファイル。
tellw_flds、tellw_u.c、tellw_c.h、tellws.ec	ATMI アプリケーション Teller のファイル。
setenvp.sh	Production サンプル・アプリケーションのビルドおよび実行に必要な環境変数を設定する UNIX スクリプト。
setenvp.cmd	Production サンプル・アプリケーションのビルドおよび実行に必要な環境変数を設定する MS-DOS コマンド。
ubb_p.mk	UNIX オペレーティング・システム用の UBBCONFIG ファイル。
ubb_p.nt	Windows 2000 オペレーティング・システム用の UBBCONFIG ファイル。
makefilep.mk	UNIX オペレーティング・システムでの Production サンプル・アプリケーション用の makefile。
makefilep.nt	Windows 2000 オペレーティング・システムでの Production サンプル・アプリケーション用の makefile。
log.cpp、log.h、log_client.cpp、log_server.cpp	サンプル・アプリケーションにログ機能とトレース機能を提供するクライアント・アプリケーションとサーバ・アプリケーションのファイル。これらのファイルは、¥utils ディレクトリにあります。
oradbconn.cpp、oranoconn.cpp	Oracle SQL データベース・インスタンスへのアクセスを提供するファイル。これらのファイルは、¥utils ディレクトリにあります。
samplesdb.cpp、samplesdb.h	サンプル・アプリケーションでのデータベース例外に出力関数を提供するファイル。これらのファイルは、¥utils ディレクトリにあります。
unique_id.cpp、unique_id.h	サンプル・アプリケーションの C++ Unique ID クラスのルーチン。これらのファイルは、¥utils ディレクトリにあります。
samplesdbsql.h、samplesdbsql.pc	SQL データベースへのアクセスをインプリメントする C++ クラスのメソッド。これらのファイルは、¥utils ディレクトリにあります。
university.sql	University データベース用の SQL。このファイルは、¥utils ディレクトリにあります。

 

Production サンプル・アプリケーションのファイル保護の属性を変更する

BEA Tuxedo ソフトウェアのインストール時には、サンプル・アプリケーションは読み取り専用に設定されています。Production サンプル・アプリケーションのファイルを編集または作成するには、次のように作業ディレクトリにコピーしたファイル保護の属性を変更する必要があります。

Windows 2000

prompt>attrib -r drive:¥workdirectory¥*.*

UNIX

prompt>chmod u+rw /workdirectory/*.*

環境変数を設定する

次のコマンドを使用して、Production サンプル・アプリケーションのクライアント・アプリケーションとサーバ・アプリケーションのビルドに使用する環境変数を設定します。

Windows 2000

prompt>setenvp

UNIX

prompt>/bin/ksh

prompt>. ./setenvp.sh

University データベースを初期化する

次のコマンドを使用して、Production サンプル・アプリケーションで使用する University データベースを初期化します。

Windows 2000

prompt>nmake -f makefilep.nt initdb

UNIX

prompt>make -f makefilep.mk initdb

UBBCONFIG ファイルをロードする

次のコマンドを使用して、UBBCONFIG ファイルをロードします。

Windows 2000

prompt>tmloadcf -y ubb_p.nt

UNIX

prompt>tmloadcf -y ubb_p.mk

UBBCONFIG ファイルの作成プロセスでは、アプリケーション・パスワードの入力が求められます。このパスワードは、クライアント・アプリケーションへのログオンに使用されます。パスワードを入力して Enter キーを押します。その際、パスワードを再入力してパスワードの確認を求めるメッセージが表示されます。

トランザクション・ログを作成する

トランザクション・ログには、CORBA アプリケーションでのトランザクション処理が記録されます。開発プロセスでは、UBBCONFIG ファイルの TLOGDEVICE パラメータでトランザクション・ログの場所を定義する必要があります。Production サンプル・アプリケーションの場合、トランザクション・ログは作業ディレクトリに格納されています。

Production サンプル・アプリケーションのトランザクション・ログを開くには、次の手順に従います。

1. 次のコマンドを入力して、会話型の管理インターフェイスを起動します。

   tmadmin

2. 次のコマンドを入力して、トランザクション・ログを作成します。

   crdl -b blocks -z directorypath
   crlog -m SITE1

   この例では、

   blocks にトランザクション・ログに割り当てるブロック数を指定し、directorypath にトランザクション・ログの場所を指定します。directorypath オプションは、UBBCONFIG ファイルの TLOGDEVICE パラメータで指定した場所と一致しなければなりません。Windows 2000 でのコマンドの例を次に示します。

   crdl -b 500 -z c:¥mysamples¥university¥production¥TLOG

3. 「q」を入力して、会話型の管理インターフェイスを終了します。

 

---

Production サンプル・アプリケーションのコンパイル

開発プロセスでは、buildobjclient および buildobjserver コマンドを使用して、クライアント・アプリケーションとサーバ・アプリケーションをビルドします。ただし、Production サンプル・アプリケーションの場合は、この手順は不要です。Production サンプル・アプリケーションのディレクトリには、makefile が格納されています。この makefile により、クライアントとサーバ・サンプル・アプリケーションがビルドされます。

Production サンプル・アプリケーションの CORBA C++ クライアント・アプリケーションとサーバ・アプリケーションをビルドするには、次のコマンドを使用します。

Windows 2000

prompt>nmake -f makefilep.nt

UNIX

prompt>make -f makefilep.mk

CORBA Java クライアント・アプリケーションをビルドするには、次のコマンドを使用します。

Windows 2000

prompt>nmake -f makefilep.nt javaclient

UNIX

prompt>make -f makefilep.mk javaclient

ActiveX クライアント・アプリケーションの起動については、ActiveX クライアント・アプリケーションの起動を参照してください。

buildobjclient および buildobjserver コマンドの詳細については、『BEA Tuxedo コマンド・リファレンス』を参照してください。

 

---

Production サンプル・アプリケーションの実行

Production サンプル・アプリケーションを実行するには、次の手順に従います。

1. サーバ・アプリケーションを起動します。

2. 1 つまたは複数のクライアント・アプリケーションを起動します。

以降の節では、上記の各手順の詳細について説明します。

サーバ・アプリケーションの起動

Production サンプル・アプリケーションでシステムおよびサンプル・アプリケーションのサーバ・アプリケーションを起動するには、次のコマンドを入力します。

prompt>tmboot -y

このコマンドを入力すると、次のサーバ・プロセスが開始されます。

• TMSYSEVT

  BEA Tuxedo システムの EventBroker。

• TMFFNAME

  NameManager サービスや FactoryFinder サービスなどのトランザクション管理サービス。

• TMIFSRVR

  インターフェイス・リポジトリ・サーバ・プロセス。これは、ActiveX クライアント・アプリケーションでのみ使用されます。

• univp_server

  University サーバ・アプリケーションの 4 つのプロセス。

• tellp_server

  ATMI アプリケーション Teller の 4 つのプロセス。

• billp_server

  Billing サーバ・アプリケーションの 4 つのプロセス。

• ISL

  IIOP リスナ/ハンドラ・プロセス。

ほかのサンプル・アプリケーションを使用するには、次のコマンドを入力して、システムおよびサンプル・アプリケーションのサーバ・プロセスを停止します。

prompt>tmshutdown

CORBA C++ クライアント・アプリケーションの起動

Production サンプル・アプリケーションの CORBA C++ クライアント・アプリケーションを起動するには、次の手順に従います。

1. MS-DOS プロンプトで次のコマンドを入力します。

   prompt>univp_client

2. 画面に「Enter student id:」と表示されたら、100001 〜 100010 の任意の数値を入力します。

3. Enter キーを押します。

4. 画面に「Enter domain password:」と表示されたら、UBBCONFIG ファイルをロードしたときに定義したパスワードを入力します。

5. Enter キーを押します。

注記 Production サンプル・アプリケーションでは、Production サンプル・アプリケーションと Wrapper サンプル・アプリケーションの各 CORBA C++ クライアント・アプリケーションは同じ方法で動作します。

CORBA Java クライアント・アプリケーションの起動

Production サンプル・アプリケーションの CORBA Java クライアント・アプリケーションを実行するには、以下の手順に従います。

1. UnivPApplet.html ファイル内の次の行を変更します。

   code="UnivPApplet.class"
   codebase=.
   上記の行を次のように変更します。

   code="UnivPApplet"
   archive="UnivPApplet.jar,m3envobj.jar"

2. 変更した UnivPApplet.html ファイルを Web サーバのソース・ディレクトリにコピーします。ディレクトリは、Web サーバ製品によって異なります。

3. makefile を実行して Production サンプル・アプリケーションをビルドした後、次のように UnivPApplet.jar ファイルを作成します。

   1. サンプル・アプリケーションをビルドしたディレクトリの下に tmp ディレクトリを作成します。UniversityP サブディレクトリとその中に格納されているクラス・ファイルを tmp ディレクトリにコピーします。

      makefile によって生成された、Production サンプル・アプリケーション・ディレクトリにあるクラス・ファイルを tmp ディレクトリにコピーします。ディレクトリを tmp ディレクトリに設定 (cd) し、次のどちらかのコマンドを入力して、すべての Production サンプル・アプリケーション・クラスを含んだ .JAR ファイルを作成します。
      
      jar -cf ..¥UnivPApplet.jar *.* (Microsoft Windows 2000 システム)
      jar -cf ../UnivPApplet.jar * (UNIX システム)

4. 前の手順で作成した UnivPApplet.jar ファイルを Web サーバのソース・ディレクトリにコピーします。ディレクトリ名は、Web サーバ製品によって異なります。

5. 適切なサブディレクトリ (Microsoft Windows 2000 システムの場合は %TUXDIR%¥udataobj¥java 、UNIX システムの場合は ${TUXDIR}/udataobj/java) から、m3envobj.jar ファイルを Web サーバのソース・ディレクトリにコピーします。

6. Security サーバ・アプリケーションが動作していることを確認してから、Web ブラウザを起動し、Web サーバが動作しているノードを参照します。

注記 Microsoft Windows 2000 システムの場合、ノード名はすべて大文字にする必要があります。たとえば、UBBCONFIG ファイルおよび UnivPApplet.html ファイルでノードを SERVER に指定した場合、ブラウザは http://SERVER/UnivPApplet.html に設定します。

7. student ID フィールドに 100001 〜 100010 の数値を入力します。

8. Domain Password フィールドに、UBBCONFIG ファイルをロードしたときに定義したパスワードを入力します。

9. [Logon] ボタンをダブルクリックします。

注記 Production サンプル・アプリケーションでは、Production サンプル・アプリケーションと Wrapper サンプル・アプリケーションの各 CORBA Java クライアント・アプリケーションは同じ方法で動作します。

ActiveX クライアント・アプリケーションの起動

注記 University サンプル・アプリケーションでは、インターフェイス・リポジトリに CORBA インターフェイスの OMG IDL をロードする作業は makefile によって自動化されています。

ActiveX クライアント・アプリケーションを起動するには、Application Builder を使用して CORBA インターフェイスの ActiveX バインディングを作成する必要があります。

CORBA インターフェイスの ActiveX バインディングを作成するには、次の手順に従います。

1. BEA Tuxedo プログラム・グループで [BEA Application Builder] アイコンをクリックします。

   [IIOP Listener] ウィンドウが表示されます。

2. [IIOP Listener] ウィンドウに、UBBCONFIG ファイルの ISL パラメータで指定したホスト名とポート番号を入力します。ホスト名とポート番号は、UBBCONFIG ファイルで大文字で指定した内容と正確に一致するように入力します。

   [Logon] ウィンドウが表示されます。

3. UBBCONFIG ファイルをロードしたときに定義したユーザ名とパスワードについて、100001 〜 100010 の学生 ID を [Logon] ウィンドウに入力します。

   [Application Builder] ウィンドウが表示されます。インターフェイス・リポジトリにロードされた CORBA インターフェイスがすべて、Application Builder の [Services] ウィンドウに表示されます。

4. [Services] ウィンドウで UniversityP フォルダを強調表示して [Workstation Views] ウィンドウにドラッグします。または、[Services] ウィンドウから UniversityP folder フォルダをコピーして [Workstation Views] ウィンドウに貼り付けます。

   確認のウィンドウが表示されます。

5. [Create] をクリックすると、Production サンプル・アプリケーションで CORBA インターフェイスの ActiveX バインディングが作成されます。

   Application Builder では、以下のものが作成されます。

   • CORBA インターフェイスに対するバインディング。バインディングの名前の形式は、DImodulename_interfacename です。たとえば、Registrar インターフェイスに対するバインディングの名前は、DIUniversityP_Registrar となります。

   • 型ライブラリ。デフォルトでは、型ライブラリは ¥TUXDIR¥TypeLibraries に格納されています。

     型ライブラリのファイル名の形式は、DImodulename_interfacename.tlb です。

   • CORBA インターフェイスの Windows システム・レジストリ・エントリ。このエントリには、オブジェクト型ごとに一意のプログラム ID が入っています。

ActiveX クライアント・アプリケーションを実行するには、以下の手順に従います。

1. Visual Basic で University.vbw ファイルを開きます。

2. [Run] メニューの [Start] をクリックします。

   [IIOP Listener] ウィンドウが表示されます。

3. [IIOP Listener] ウィンドウに、UBBCONFIG ファイルの ISL パラメータで指定したホスト名とポート番号を入力します。ホスト名とポート番号は、UBBCONFIGファイルで大文字で指定した内容と正確に一致するように入力します。

   [Logon] ウィンドウが表示されます。

4. UBBCONFIG ファイルをロードしたときに定義したユーザ名とパスワードについて、100001 〜 100010 の学生 ID を [Logon] ウィンドウに入力します。

注記 Production サンプル・アプリケーションでは、Production サンプル・アプリケーションと Wrapper サンプル・アプリケーションの各 ActiveX クライアント・アプリケーションは同じ方法で動作します。

 

---

Production サンプル・アプリケーションをさらにスケーリングする方法

Production サンプル・アプリケーションをさらにスケーリングするには、次の方法に従います。

• Production サンプル・アプリケーションのサーバ・グループを複数のマシンに複製します。

  新しいサーバ・グループ、そのサーバ・グループで実行するサーバ・アプリケーション・プロセス、およびサーバ・グループを実行するサーバ・マシンを指定するには、UBBCONFIG ファイルを変更する必要があります。

• ファクトリ・ベース・ルーティングのテーブルを修正します。

  たとえば、Production サンプル・アプリケーションの既存の 2 つのサーバ・グループにルーティングする代わりに、UBBCONFIG ファイルのルーティング規則を修正すると、アプリケーションを追加されたサーバ・グループの間でさらに分割できます。ルーティング・テーブルを修正する場合は、UBBCONFIG ファイルの情報と一致させる必要があります。

注記 データベースを使用する既存の CORBA アプリケーションに機能を追加する場合は、データベースがどのように設定されているかを考慮する必要があります。ファクトリ・ベース・ルーティングを使用している場合は、特に注意が必要です。たとえば、Production サンプル・アプリケーションが 6 台のマシン間に分散している場合は、UBBCONFIG ファイルのルーティング・テーブルに基づいて、適切に各マシンのデータベースを設定する必要があります。