18.3.2 DABroker Libraryのインストールおよび動作環境の設定(UNIXの場合)
ここでは,UNIXでDABroker Libraryを使用するためのインストールおよび動作環境の設定について説明します。
- 〈この項の構成〉
(1) インストール
製品のインストールには,インストーラを使用します。
使用するJava VMによって,異なった環境変数を設定する必要があることがあります。設定する項目については,各Java VMのドキュメントを参照してください。
(2) インストール後のDABroker Libraryのディレクトリ構成
UNIXの場合のインストール後のDABroker Libraryのディレクトリ構成を次の表に示します。
ディレクトリ |
説明 |
|
---|---|---|
/opt/Cosminexus |
DABJ |
DABroker LibraryのJDBCドライバのインストールディレクトリです。 |
/opt/DABroker |
− |
DABroker Libraryのインストールディレクトリです。 |
bin |
実行コマンド格納用ディレクトリです。 |
|
lib |
ライブラリ格納用ディレクトリです。 |
|
obj |
オブジェクトファイル格納用ディレクトリです。 |
|
AGT |
エージェント処理用ディレクトリです。 |
|
AGTGRP |
グループ管理用ディレクトリです。 |
|
msg |
メッセージファイル格納用ディレクトリです。 |
|
sample |
サンプルファイル格納用ディレクトリです。 |
|
conf |
定義ファイル格納用ディレクトリです。 |
|
spool |
トレースファイル,ログファイル格納用ディレクトリです。 |
- 注意事項
-
DABroker Libraryをアンインストールする場合,/opt/Cosminexus/DABJは削除されないので,手動で削除してください。
(3) DABroker Libraryのセットアップ
セットアップでは,DABroker Libraryを管理するユーザをOSに登録し,DABroker Libraryの運用ディレクトリを作成します。セットアップの手順を次に示します。
-
DABroker Libraryを管理するユーザ(UNIXログインユーザ)をOSに登録します。
ユーザID登録後,パスワードも登録してください。登録方法はOSのマニュアルを参照してください。ここで登録したユーザを,DABroker Libraryの管理ユーザと呼びます。DABroker Libraryの管理ユーザに与えられる権限は,次のとおりです。
-
DABroker Libraryで提供するファイルおよびディレクトリの所有者としてのアクセス権
-
DABroker Libraryの運用コマンドの実行権
注 Oracleにアクセスする場合は,登録するユーザのUIDを「3」以上にしてください。
-
-
DABroker Libraryのインストールディレクトリのグループおよびユーザを,手順1.で登録した管理グループおよびユーザに変更します。
-
DABroker Libraryセットアップコマンド(dabsetup)を実行します。
スーパーユーザで,/opt/DABroker/binディレクトリにあるdabsetupを実行します。
(例) dabsetup /home
dabsetupコマンドは,DABroker Library運用ディレクトリを指定するコマンドです。このコマンドを実行すると,インストールディレクトリのディレクトリおよびファイルが,<パス名>に指定した運用ディレクトリに移動されます。<パス名>を省略した場合,運用ディレクトリはDABroker Libraryのインストールディレクトリ(/opt/DABroker)となります。また,dabsetupコマンドに-dオプションを指定すると,運用ディレクトリの削除もできます。
- 注意事項
-
AIXの場合で,Component ContainerをCロケールで動作させるときは,環境変数「LC__FASTMSG」に「false」が指定されているか確認してください。DABroker Libraryを使用してDBにアクセスし,かつComponent ContainerをCロケールで動作させる場合には,環境変数「LC__FASTMSG」に「false」を指定する必要があります。
(4) DABroker Libraryの動作環境の設定(UNIXの場合)
DABroker Libraryの動作環境は,DABroker Library動作環境定義ファイルで設定します。また,DABroker Library動作環境定義ファイルでは,トレース取得の設定ができます。DABroker Libraryで取得できるトレースについては,「18.6.5 DABroker Libraryで取得できるトレース」を参照してください。
ここでは,DABroker Libraryの動作環境の設定について説明します。
DABroker Libraryの動作環境は,DABroker Library動作環境定義ファイルで設定します。動作環境定義ファイルは,インストール時に提供されるサンプルを使用して作成します。
-
提供されるサンプルファイル
/opt/DABroker/sample/dasysconf
-
動作環境定義ファイルの格納先
<DABroker Library運用ディレクトリ>/conf
DABroker Libraryの動作環境の設定手順を次に示します。
-
サンプルファイルを動作環境定義ファイルの格納先へコピーします。
-
コピーしたサンプルファイルを編集します。
必要に応じて,標準値の変更や値の追加をしてください。
-
共通設定項目(作業ディレクトリ,Oracleのバージョン,拡張データベースアクセストレースの取得の有無など)
-
リモートアクセス設定項目(データの受け取りバッファサイズなど)
-
HiRDB設定項目
-
Oracle設定項目
なお,DABroker Library動作環境定義ファイルは,「DAB」ブロックと「OTHERS」ブロックで構成されます。
- 「DAB」ブロック
-
共通設定項目やリモートアクセス設定項目を指定するブロックです。DABroker Libraryはこのブロックの設定項目をチェックするため,不正な名称などを指定していた場合はエラーになります。
- 「OTHERS」ブロック
-
HiRDB設定項目やOracle設定項目を指定するブロックです。DABroker Libraryはこのブロックの設定項目をチェックしません。指定したすべての項目が有効となります。
DABroker Library動作環境定義ファイルについては,「18.24.1 DABroker Library動作環境定義ファイル」を参照してください。
-
-
ファイルを保存します。
なお,作成済みのDABroker Library動作環境定義ファイルの内容を変更する場合は,J2EEサーバを停止してください。
(5) データベース接続のための設定
ここでは,DABroker Libraryを使用してデータベースに接続するために必要な設定について説明します。
-
HiRDBの言語モードの設定
-
DABroker LibraryおよびJDBCでの言語モードの設定
(a) HiRDBの言語モードの設定
データベースとしてHiRDBを使用する場合は,言語モードを設定してください。DABroker Libraryの言語モードとHiRDBの言語モードの対応を次の表に示します。なお,DABroker Libraryの言語モードとは,DABroker Library動作環境定義ファイルのDAB_LANG(LANG環境変数)のことです。
DABroker Libraryの言語モード |
HiRDBの言語モード |
|||||
---|---|---|---|---|---|---|
OS |
言語モード |
DAB_LANGの指定値 |
SJIS |
EUC日本語 |
ASCII |
UTF-8 |
AIX |
SJIS |
Ja_JP |
○ |
− |
− |
− |
Ja_JP.IBM-932 |
○ |
− |
− |
− |
||
Ja_JP.IBM-943 |
○ |
− |
− |
− |
||
EUC |
ja_JP |
− |
○ |
− |
− |
|
ja_JP.IBM-eucJP |
− |
○ |
− |
− |
||
ASCII |
C※ |
− |
− |
○ |
− |
|
UTF-8 |
UTF-8 |
− |
− |
− |
○ |
|
Linux |
EUC |
ja_JP |
− |
○ |
− |
− |
ja_JP.ujis |
− |
○ |
− |
− |
||
japanese |
− |
○ |
− |
− |
||
japanese.euc |
− |
○ |
− |
− |
||
ja_JP.eucjp |
− |
○ |
− |
− |
||
Ja_JP |
− |
○ |
− |
− |
||
ASCII |
C※ |
− |
− |
○ |
− |
|
UTF-8 |
UTF-8 |
− |
− |
− |
○ |
(b) DABroker LibraryおよびJDBCでの言語モードの設定
ENCODELANG,またはsetEncodLangに指定する言語モードは,DABroker Libraryの言語モードと合わせる必要があります。ENCODELANG,またはsetEncodLangの指定方法について次に説明します。
- OSの言語モードとDABroker Libraryの言語モードが同じ場合
-
ENCODELANG,またはsetEncodLangの指定は必要ありません。
- OSの言語モードとDABroker Libraryの言語モードが異なる場合
-
ENCODELANG,またはsetEncodLangに,DABroker Libraryの言語モードと同等の値を指定する必要があります。
- 注意事項
-
-
DABroker Libraryの言語モードと,データベースの言語モードは必ず合わせてください。
-
データベースの言語モードをDABroker Libraryがサポートしていない場合,DABroker Libraryの言語モードにはASCIIモードを設定し,ENCODELANGまたはsetEncodLangにデータベースの言語モードを指定してください。
-
(6) J2EEアプリケーション運用のための設定
J2EEアプリケーションを運用する前に,次の設定をしてください。
-
J2EEアプリケーションの組み込み
-
J2EEアプリケーションのインタフェースの定義
-
サーバで動作するJ2EEアプリケーションの動作環境の設定
(a) J2EEアプリケーションの組み込み
DABroker Libraryが組み込まれたサーバにJ2EEアプリケーションを格納します。また,環境変数「CLASSPATH」に次に示すパスを追加します。
-
/opt/Cosminexus/DABJ/JdbcDbpsv.jar
-
/opt/Cosminexus/DABJ/JdbcDbpsvEx.jar※
- 注※
-
DABroker LibraryでJDBC2.0拡張機能を使用する場合に,このパスを指定してください。
(b) J2EEアプリケーションのインタフェースの定義
J2EEアプリケーションのインタフェースを定義します。
(c) サーバで動作するJ2EEアプリケーションの動作環境の設定
DABroker Libraryでは,JNIを使ってDABrokerの提供するネイティブライブラリを使用します。DABroker Libraryをサーバで動作するJavaアプリケーションとして動作させるときは,次の設定が必要です。
-
ネイティブライブラリの動作環境の設定
-
データベースクライアントライブラリの動作環境の設定
-
ネイティブライブラリの動作環境の設定
ネイティブライブラリはJDBCドライバを実行する(呼び出す)プロセス上で読み込まれて動作するので,ネイティブライブラリ実行のための動作環境を設定する必要があります。
- 設定内容
-
ライブラリ検索パスを指定する環境変数に,「<DABroker Library運用ディレクトリ>/lib」を設定します。設定する環境変数はOSによって異なります。
・LIBPATH(AIXの場合)
・LD_LIBRARY_PATH(Linuxの場合)
-
データベースクライアントライブラリの動作環境の設定
ネイティブライブラリは,データベースにアクセスする場合に,各データベースが提供するクライアントライブラリを呼び出します。データベースクライアントライブラリの動作環境の設定を次に示します。
-
データベースライブラリのパスを設定します。
特別な設定は必要ありません。ただし,接続するデータベースによっては動作環境の設定が必要な場合があります。詳細については,接続するデータベースのマニュアルなどを参照してください。
ライブラリ検索パスを指定する環境変数に,次の値を指定します。設定する環境変数はOSによって異なります。
・LIBPATH(AIXの場合)
・LD_LIBRARY_PATH(Linuxの場合)
使用しているOSの環境変数に次のパスを設定してください。
・HiRDB,またはXDM/RD E2の場合:HiRDBクライアントライブラリのパス名
・Oracleの場合:Oracleライブラリ(libclntsh)のパス名
-
データベースの提供する環境変数を設定します。
JDBCドライバを実行する(呼び出す)プロセス上で有効な環境変数として,各データベースの提供する環境変数を設定する必要があります。
詳細については,「18.3.3 データベースの設定」,接続するデータベースのマニュアルなどを参照してください。
-