環境設定

ここでは、University サンプルアプリケーションを実行できるように CORBA アプリケーションをコンフィグレーションする方法について説明します。

University サンプルアプリケーションでは、University データベースというデータベースを使用して、コース名やコース概要といった、サンプルアプリケーションで使用されるデータをすべて格納します。University サンプルアプリケーションをビルドおよび実行するには、このデータベースを事前にインストールおよび設定しておく必要があります。

データベースの設定の詳細については、使用しているデータベースの製品マニュアルを参照してください。

システムの前提条件

製品でサポートされているオペレーティングシステムのプラットフォームについては、『Oracle Tuxedo システムのインストール』を参照してください。

University サンプルアプリケーションでクライアントアプリケーションを実行するには、以下の開発ツールが必要になります。

setenv および UBBCONFIG ファイルの編集

University サンプルアプリケーションが正常に動作するには、setenv および UBBCONFIG ファイルのパラメータを次のように設定する必要があります。

setenv ファイルでは、サンプルアプリケーションのビルドおよび実行に必要なシステム環境変数を設定する。各サンプルアプリケーションのディレクトリには、ユニークな setenv ファイルが格納されています。setenv ファイルの名前は、そのファイルを使用するサンプルアプリケーションを示します。たとえば、setenvb は、Basic サンプルアプリケーション用のファイルです。各サンプルアプリケーションのディレクトリには、Windows および UNIX オペレーティングシステム用の setenv ファイルが格納されています。setenv ファイルに固有のファイル名については、表 2-1 を参照してください。
UBBCONFIG ファイルは、サンプルアプリケーションのコンフィグレーションファイル。UBBCONFIG ファイルでは、サンプルアプリケーションでのクライアントアプリケーションとサーバアプリケーションの動作に関するパラメータを定義します。各サンプルアプリケーションのディレクトリには、ユニークな UBBCONFIG ファイルが格納されています。UBBCONFIG ファイルの名前は、そのファイルを使用するサンプルアプリケーションを示します。たとえば、ubb_b は、Basic サンプルアプリケーション用のファイルです。各サンプルアプリケーションのディレクトリには、Windows および UNIX オペレーティングシステム用の UBBCONFIG ファイルが格納されています。UBBCONFIG ファイルに固有のファイル名については、表 2-1 を参照してください。

setenv と UBBCONFIG ファイルの情報は一致している必要があります。以降の節では、setenv と UBBCONFIG ファイルの編集方法について説明します。

setenv および UBBCONFIG ファイルの命名規約

表 2-1 では、setenv および UBBCONFIG ファイルの命名規約について説明します。サンプルアプリケーションを識別する文字は太字で示しています。

表 2-1 setenv および UBBCONFIG ファイルの命名規約
University サンプルアプリケーション	命名規約
Basic	`setenvb.cmd` - Windows 用 `setenv` ファイル `setenvb.sh` - UNIX 用 `setenv` ファイル `ubb_b.nt` - Windows 用 `UBBCONFIG` ファイル `ubb_b.mk` - UNIX 用 `UBBCONFIG` ファイル
Security	`setenvs.cmd` - Windows 用 `setenv` ファイル `setenvs.sh` - UNIX 用 `setenv` ファイル `ubb_s.nt` - Windows 用 `UBBCONFIG` ファイル `ubb_s.mk` - UNIX 用 `UBBCONFIG` ファイル
Transactions	`setenvt.cmd` - Windows 用 `setenv` ファイル `setenvt.sh` - UNIX 用 `setenv` ファイル `ubb_t.nt` - Windows 用 `UBBCONFIG` ファイル `ubb_t.mk` - UNIX 用 `UBBCONFIG` ファイル
Wrapper	`setenvw.cmd` - Windows 用 `setenv` ファイル `setenvw.sh` - UNIX 用 `setenv` ファイル `ubb_w.nt` - Windows 用 `UBBCONFIG` ファイル `ubb_w.mk` - UNIX 用 `UBBCONFIG` ファイル
Production	`setenvP.cmd` - Windows 用 `setenv` ファイル `setenvP.sh` - UNIX 用 `setenv` ファイル `ubb_P.nt` - Windows 用 `UBBCONFIG` ファイル `ubb_P.mk` - UNIX 用 `UBBCONFIG` ファイル

setenv のパラメータの設定

表 2-2 に、setenv ファイルで変更する必要があるパラメータの一覧を示します。

表 2-2 `setenv` ファイルのパラメータ
パラメータ	説明
`APPDIR`	サンプルアプリケーションファイルをコピーしたディレクトリパス。たとえば、次のように入力する。 Windows `APPDIR=c:\work\university\basic` UNIX `APPDIR=/usr/work/university/basic`
`TUXCONFIG`	コンフィグレーションファイルのディレクトリパスと名前。たとえば、次のように入力する。 Windows `TUXCONFIG=c:¥work¥university¥basic¥tuxconfig` UNIX `TUXCONFIG=/usr/work/university/basic/tuxconfig`
`TUXDIR`	Oracle Tuxedo ソフトウェアをインストールしたディレクトリパス。たとえば、次のように入力する。 Windows `TUXDIR=c:¥Tux8` UNIX `TUXDIR=/usr/local/Tux8`
`ORACLE_HOME`	Oracle ソフトウェアをインストールしたディレクトリパス。たとえば、次のように入力する。 Windows `ORADIR=c:¥Orant` UNIX `ORACLE_HOME=/usr/local/oracle`
`TOBJADDR`	サーバアプリケーションとは異なるマシン上で CORBA C++ クライアントアプリケーションを使用している場合、サーバアプリケーションが動作しているマシンのホストとポートを入力する。ホストとポートは、そのマシンの `UBBCONFIG` ファイルの記述と同じになるように、大文字と小文字を区別して正確に指定しなければならない。たとえば、 `//BEANIE:2500` のように指定する。
`USERID`	Oracle データベースのリモートインスタンスを使用している場合、次の形式で指定する。 USERID`=username/password@aliasname` これは、Oracle データベースのリモートインスタンスの設定時に定義した情報と同じ。 Oracle データベースのローカルインスタンスを使用している場合は、次の形式で指定する。 USERID`=username/password`
`ORACLE_SID`	Oracle データベースのインスタンス ID。Windows の場合、`ORACLE_SID` は自動的に `ORCL` にデフォルト設定されるので、このパラメータの指定は不要。
`CCMPL`	C コンパイラのディレクトリの場所。このパラメータは、通常のインストール先のディレクトリに設定する。インストール先の場所と指定したディレクトリの場所が一致していることを確認し、必要に応じて場所を変更すること。このパラメータの適用対象は、UNIX オペレーティングシステムのみ。
`CPPCMPL`	C++ コンパイラのディレクトリの場所。このパラメータは、通常のインストール先のディレクトリに設定する。インストール先の場所と指定したディレクトリの場所が一致していることを確認し、必要に応じて場所を変更すること。このパラメータの適用対象は、UNIX オペレーティングシステムのみ。
`CPPINC`	C++ インクルードディレクトリのディレクトリの場所。このパラメータは、通常のインストール先のディレクトリに設定する。インストール先の場所と指定したディレクトリの場所が一致していることを確認し、必要に応じて場所を変更すること。このパラメータの適用対象は、UNIX オペレーティングシステムのみ。
`SHLIB_PATH、LD_LIBRARY_PATH、`または `LIBPATH`	共有ライブラリのディレクトリの場所。このパラメータは、通常のインストール先のディレクトリに設定する。インストール先の場所と指定したディレクトリの場所が一致していることを確認し、必要に応じて場所を変更すること。このパラメータの適用対象は、UNIX オペレーティングシステムのみ。
`PROC`	Oracle Programmer C/C++ SQL Precompiler のディレクトリの場所。このパラメータを指定する必要があるのは、Windows オペレーティングシステムを使用している場合のみ。
`PRODIR`	Oracle Programmer C/C++ SQL Precompiler のディレクトリの場所。このパラメータを指定する必要があるのは、Windows オペレーティングシステムを使用している場合のみ。

UBBCONFIG のパラメータの設定

表 2-3 に、UBBCONFIG ファイルで変更する必要があるパラメータの一覧を示します。

表 2-3 UBBCONFIG ファイルのパラメータ
パラメータ	説明
`MY_SERVER_MACHINE`	このパラメータを削除して、サーバマシンの名前に置き換える。 Windows の場合、サーバマシン名を取得するには、MS-DOS プロンプトで次のコマンドを入力する。 `set COMPUTERNAME` UNIX の場合、サーバマシン名を取得するには、シェルプロンプトで次のコマンドを入力する。 `prompt>uname -n` サーバマシン名は、コマンドの出力表示と同じになるように、大文字と小文字を区別して正確に入力しなければならない。表示されたサーバマシン名を指定する。たとえば、`BEANIE` のように指定する。マシンの完全名は、二重引用符で囲む必要がある。たとえば、`"beanie.bea.com"` というように入力する。
`APPDIR`	サンプルアプリケーションファイルをコピーしたディレクトリの絶対パス。ディレクトリパスは、二重引用符で囲む必要がある。たとえば、次のように入力する。 Windows `APPDIR="c:\work\university\basic"` UNIX `APPDIR="/usr/work/university/basic"` このパラメータは、`setenv` ファイルの `APPDIR` パラメータと一致している必要がある。
`TUXCONFIG`	コンフィグレーションファイルのディレクトリの絶対パス。これは、サンプルアプリケーションのサブディレクトリ。ディレクトリパスは、二重引用符で囲む必要がある。たとえば、次のように入力する。 Windows `TUXCONFIG="c:\work\university\basic\tuxconfig"` UNIX `TUXCONFIG="usr/work/university/basic/tuxconfig"` このパラメータは、`setenv` ファイルの `TUXCONFIG` パラメータと一致している必要がある。
`TUXDIR`	Oracle Tuxedo ソフトウェアをインストールしたディレクトリの絶対パス。ディレクトリパスは、二重引用符で囲む必要がある。たとえば、次のように入力する。 Windows `TUXDIR="c:¥Tux8"` UNIX `TUXDIR="/usr/local/Tux8"` このパラメータは、`setenv` ファイルの `TUXDIR` パラメータと一致している必要がある。
`CLOPT (ISL プロセス用)`	サーバアプリケーションがインストールされているマシンのホスト名とポート番号を入力する。たとえば、次のように入力する。 `ISL` `SRVGRP = SYS_GRP` `SRVID =` `CLOPT = "-A --n //BEANIE:2500"`
`OPENINFO`	Transactions、Wrapper、または Production の各サンプルアプリケーションを使用している場合、このパラメータを Oracle データベースに指定する必要がある。 Oracle データベースのリモートインスタンスを使用している場合、OPENINFO パラメータは次のように指定する。 `OPENINFO = "Oracle_XA:Oracle_XA+SqlNet=aliasname+Acc=P/account/password+SesTM=100+LogDir=.+MaxCur=5"` たとえば、Windows の場合は次のように指定する。 `OPENINFO = "Oracle_XA:Oracle_XA+SqlNet=ORCL+Acc=P/scott/ tiger+SesTM=100+LogDir=.+MaxCur=5"` Oracle データベースのローカルインスタンスを使用している場合、`OPENINFO` パラメータは次のように指定する。 `OPENINFO = "Oracle_XA:Oracle_XA+Acc=P /account/password+SesTM=100+LogDir=.+MaxCur=5"` たとえば、Windows の場合は次のように指定する。 `OPENINFO = "Oracle_XA:Oracle_XA+Acc=P /scott/tiger+SesTM=100+LogDir=.+MaxCur=5"`

setenv コマンドの実行

University サンプルアプリケーションを使用する前に、setenv スクリプトを実行して、データベース設定で加えた変更、およびコンフィグレーションがすべてシステム環境変数に反映されていることを確認しておく必要があります。setenv コマンドを実行する手順については、各サンプルアプリケーションのビルドに関する説明の中で記載されています。

Tuxedo CORBA University サンプル アプリケーション