環境設定

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

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

データベースの設定の詳細は、使用しているデータベースの製品ドキュメントを参照してください。

システムの前提条件

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 サンプル・アプリケーション	ネーミング・ルール
ベーシック	`setenvb.cmd` - Windows用`setenv`ファイル `setenvb.sh` - UNIX用`setenv`ファイル `ubb_b.nt` - Windows用`UBBCONFIG`ファイル `ubb_b.mk` - UNIX用`UBBCONFIG`ファイル
セキュリティ	`setenvs.cmd` - Windows用`setenv`ファイル `setenvs.sh` - UNIX用`setenv`ファイル `ubb_s.nt` - Windows用`UBBCONFIG`ファイル `ubb_s.mk` - UNIX用`UBBCONFIG`ファイル
トランザクション	`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プリコンパイラのディレクトリの場所。このパラメータを指定する必要があるのは、Windowsオペレーティング・システムを使用している場合のみです。
`PRODIR`	Oracle Programmer C/C++ SQLプリコンパイラのディレクトリの場所。このパラメータを指定する必要があるのは、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コマンドを実行する手順は、各サンプル・アプリケーションのビルドに関する説明に記載されています。

CORBA Universityサンプル・アプリケーション・ガイド