CORBAサンプル・アプリケーションのビルドと実行

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

•	Securityサンプル・アプリケーションのビルドと実行

•	Secure Simpappサンプル・アプリケーションのビルドと実行

注意:	Oracle Tuxedo CORBA JavaクライアントとOracle Tuxedo CORBA JavaクライアントORBはTuxedo 8.1で非推奨になり、サポートされなくなりました。すべてのOracle Tuxedo CORBA JavaクライアントおよびOracle Tuxedo CORBA JavaクライアントORBのテキスト・リファレンスとコード・サンプルは、サード・パーティ製のJava ORBライブラリを実装または実行する際の参考や、プログラマの参照用としてのみ使用してください。

サード・パーティのCORBA Java ORBのテクニカル・サポートは、各ベンダーによって提供されます。Oracle Tuxedoでは、サード・パーティのCORBA Java ORBに関する技術的なサポートまたはドキュメントは提供していません。

Securityサンプル・アプリケーションのビルドと実行

Securityサンプル・アプリケーションでは、パスワード認証を使用します。Securityサンプル・アプリケーションのビルドと実行の手順については、『CORBA Universityサンプル・アプリケーション・ガイド』を参照してください。

Secure Simpappサンプル・アプリケーションのビルドと実行

Secure Simpappサンプル・アプリケーションでは、クライアント・アプリケーションとOracle Tuxedoドメインの間の通信を保護するためにSSLプロトコルと証明書認証を使用します。

Secure Simpappサンプル・アプリケーションをビルドおよび実行するには、次の手順に従います。

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

2.	Secure Simpappサンプル・アプリケーションのファイルに対する保護属性を変更します。

3.	環境変数を確認します。

4.	runmeコマンドを実行します。

Secure Simpappサンプル・アプリケーションを使用する前に、IIOPリスナー/ハンドラの証明書と秘密鍵(IIOPListener.pem)をユーザーの企業の認証局から取得し、Lightweight Directory Access Protocol (LDAP)を有効にしたディレクトリ・サービスで証明書をロードします。runmeコマンドで、IIOPリスナー/ハンドラの秘密鍵に対するパス・フレーズが表示されます。

ステップ1 : Secure Simpappサンプル・アプリケーションのファイルを作業ディレクトリにコピーする

Secure Simpappサンプル・アプリケーションのファイルを、ローカル・マシンの作業ディレクトリにコピーする必要があります。

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

Windows 2003

drive:¥TUXdir¥samples¥corba¥simpappSSL

UNIX

/usr/local/TUXdir/samples/corba/simpappSSL

表9-1にリストされているファイルを使用して、Secure Simpappサンプル・アプリケーションをビルドおよび実行します。

 

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

ファイル	説明
Simple.idl	SimpleインタフェースとSimpleFactoryインタフェースを宣言するOMG IDLコード。
Simples.cpp	デフォルトのServer::initializeメソッドとServer::releaseメソッドをオーバーライドするC++ソース・コード。
Simplec.cpp	Secure Simpappサンプル・アプリケーションのCORBA C++クライアント・アプリケーションのソース・コード。
simple_i.cpp	SimpleメソッドとSimpleFactoryメソッドを実装するC++ソース・コード。
Simple_i.h	SimpleメソッドとSimpleFactoryメソッドの実装を定義するC++ヘッダー・ファイル。
Readme.html	このファイルは、Secure Simpappサンプル・アプリケーションのビルドと実行に関する最新の情報を提供します。
runme.cmd	Secure Simpappサンプル・アプリケーションをビルドおよび実行するWindows 2003バッチ・ファイル。
runme.ksh	Secure Simpappサンプル・アプリケーションをビルドおよび実行するUNIX Kornシェル・スクリプト。
makefile.mk	UNIXオペレーティング・システムのSecure Simpappサンプル・アプリケーションのmakefile。このファイルは、Secure Simpappサンプル・アプリケーションを手動でビルドするのに使用します。Secure Simpappサンプル・アプリケーションを手動でビルドする場合は、Readme.htmlファイルを参照してください。UNIXのmakeコマンドは、ユーザーのマシンのパス内に存在している必要があります。
makefiles.nt	Windows 2003オペレーティング・システムのSecure Simpappサンプル・アプリケーションのmakefile。このmakefileは、Visual C++のnmakeコマンドで直接使用できます。このファイルは、Secure Simpappサンプル・アプリケーションを手動でビルドするのに使用します。Secure Simpappサンプル・アプリケーションを手動でビルドする場合は、Readme.htmlファイルを参照してください。Windows 2003のnmakeコマンドは、ユーザーのマシンのパス内に存在している必要があります。

ステップ2 : Secure Simpappサンプル・アプリケーションのファイルに対する保護属性を変更する

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

Windows 2003

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

UNIX

prompt>/bin/ksh

ksh prompt>chmod u+w /workdirectory/*.*

また、UNIXオペレーティング・システム・プラットフォームでは、ファイルに実行権限を与えるためにrunme.kshの権限を次のように変更する必要もあります。

ksh prompt>chmod +x runme.ksh

ステップ3 :環境変数の設定を確認する

Secure Simpappサンプル・アプリケーションをビルドおよび実行する前に、ユーザーのシステムに対して一部の環境変数を設定する必要があります。ほとんどの場合、環境変数はインストール手順の一部として設定されます。ただし、環境変数をチェックして、正しい情報を反映していることを確認する必要があります。

表9-2に、Secure Simpappサンプル・アプリケーションの実行に必要な環境変数を示します。

 

表9-2 Secure Simpappサンプル・アプリケーションで必須の環境変数

環境変数	説明
APPDIR	サンプル・アプリケーション・ファイルをコピーしたディレクトリ・パス。例: Windows 2003 APPDIR=c:¥work¥simpappSSL UNIX APPDIR=/usr/work/simpappSSL
TUXCONFIG	構成ファイルのディレクトリ・パスと名前。例: Windows 2003 TUXCONFIG=c:¥work¥simpappSSL¥tuxconfig UNIX TUXCONFIG=/usr/work/simpappSSL/tuxconfig
TOBJADDR	IIOPリスナー/ハンドラのホスト名とポート番号。ポート番号は、SSL接続のポートとして定義する必要があります。例: Windows 2003 TOBJADDR=trixie::1111 UNIX TOBJADDR=trixie::1111
RESULTSDIR	runmeコマンドの実行により作成されたファイルが格納されているAPPDIRのサブディレクトリ。例: Windows 2003 RESULTSDIR=c:¥workdirectory¥ UNIX RESULTSDIR=/usr/local/workdirectory/

インストール中に定義された環境変数の情報が正しいことを確認するには、次の手順に従います。

Windows 2003

1.	「スタート」メニューの、「設定」をポイントします。

2.	「設定」メニューから、「コントロール・パネル」をクリックします。

「コントロール・パネル」が表示されます。

3.	「システム」アイコンをクリックします。

「システムのプロパティ」ウィンドウが表示されます。

4.	「詳細」タブの「環境変数」をクリックします。

「環境変数」ページが表示されます。

5.	環境変数の設定をチェックします。

UNIX

ksh prompt>printenv TUXDIR

設定を変更するには、次の手順に従います。

Windows 2003

1.	[システムのプロパティ]ウィンドウの[環境]ページで、変更する環境変数をクリックするか、[変数]フィールドに環境変数の名前を入力します。

2.	[値]フィールドに、環境変数の正しい情報を入力します。

3.	「OK」をクリックして変更を保存します。

UNIX

ksh prompt>export TUXDIR=directorypath

ステップ4 : runmeコマンドを実行する

runmeコマンドは、次の手順を自動化します。

1.	システム環境変数の設定

2.	UBBCONFIGファイルのロード

3.	クライアント・アプリケーションのコードのコンパイル

4.	クライアント・アプリケーションのコードのコンパイル

5.	tmbootコマンドによるサーバー・アプリケーションの起動

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

7.	tmshutdownコマンドによるサーバー・アプリケーションの終了

注意:	Secure Simpappサンプル・アプリケーションを手動で実行することもできます。Secure Simpappサンプル・アプリケーションを手動で実行する手順については、Readme.htmlファイルで説明しています。

Secure Simpappサンプル・アプリケーションをビルドおよび実行するには、次のようにrunmeコマンドを入力します。

Windows 2003

prompt>cd workdirectory

prompt>runme

UNIX

ksh prompt>cd workdirectory

ksh prompt> ./runme.ksh

Secure Simpappサンプル・アプリケーションが起動し、次のメッセージが表示されます。

Testing simpapp
    cleaned up
    prepared
    built
    loaded ubb
    booted
    ran
    shutdown
    saved results
  PASSED

runmeコマンドの実行時に、パスワードの入力を要求されます。IIOPリスナー/ハンドラの秘密鍵のパス・フレーズを入力します。

表9-3に、runmeコマンドで作業ディレクトリ内に生成されたC++ファイルを示します。

 

表9-3 runmeコマンドで生成されるC++ファイル

ファイル	説明
Simple_c.cpp	idlコマンドによって生成されます。このファイルは、SimpleFactoryインタフェースとSimpleインタフェースのクライアント・スタブを格納します。
Simple_c.h	idlコマンドによって生成されます。このファイルは、SimpleFactoryインタフェースとSimpleインタフェースのクライアント定義を格納します。
Simple_s.cpp	idlコマンドによって生成されます。このファイルは、SimpleFactoryインタフェースとSimpleインタフェースのサーバー・スケルトンを格納します。
Simple_s.h	idlコマンドによって生成されます。このファイルは、SimpleFactoryインタフェースとSimpleインタフェースのサーバー定義を格納します。

表9-4に、runmeコマンドでRESULTSディレクトリ内に生成されるファイルを示します。

 

表9-4 runmeコマンドでRESULTSディレクトリに生成されるファイル

ファイル	説明
input	runmeコマンドがCORBAクライアント・アプリケーションに提供する入力を格納します。
output	runmeコマンドがCORBAクライアント・アプリケーションを実行するときに生成される出力を格納します。
expected_output	runmeコマンドがCORBAクライアント・アプリケーションを実行するときに予測される出力を格納します。テストに成功したか失敗したかを判別するために、outputファイルのデータはexpected_outputファイルのデータと比較されます。
log	runmeコマンドで生成される出力を格納します。runmeコマンドが失敗すると、このファイルのエラーをチェックします。
setenv.cmd	Windows 2003オペレーティング・システム・プラットフォームのSecure Simpappサンプル・アプリケーションのビルドと実行に必要な環境変数を設定するためのコマンドを格納します。
stderr	tmbootコマンドによって生成されます。このコマンドは、runmeコマンドによって実行されます。
stdout	tmbootコマンドによって生成されます。このコマンドは、runmeコマンドによって実行されます。
tmsysevt.dat	TMSYSEVT(システム・イベント・レポート)プロセスで使用するフィルタ規則および通知規則を格納します。このファイルは、runmeコマンドのtmbootコマンドによって生成されます。
tuxconfig	バイナリ形式のUBBCONFIGファイル。
ULOG.<日>	tmbootコマンドによって生成されるメッセージを含んだログ・ファイル。

Secure Simpappサンプル・アプリケーションの使用

Secure Simpappサンプル・アプリケーションのサーバー・アプリケーションを次のように実行します。

Windows 2003

prompt>tmboot -y

UNIX

ksh prompt>tmboot -y

Secure Simpappサンプル・アプリケーションのCORBA C++クライアント・アプリケーションを次のように実行します。

Windows 2003

prompt> set TOBJADDR=corbalocs://host:port
prompt> simple_client -ORBid BEA_IIOP -ORBpeerValidate none
String?
Hello World
HELLO WORLD
hello world

UNIX

ksh prompt>export TOBJADDR=corbalocs://host:port
ksh prompt>simple_client -ORBid BEA_IIOP -ORBpeerValidate none
String?
Hello World
HELLO WORLD
hello world

Windows 2003

prompt>tmshutdown -y

prompt>nmake -f makefile.nt clean

UNIX

ksh prompt>tmshutdown -y

ksh prompt>make -f makefile.mk clean