17.3.1 環境設定手順
実行者 スーパユーザ及びHiRDB管理者
Javaストアドプロシジャ及びJavaストアドファンクションを使用する場合の環境設定手順を次の図に示します。なお,ここでの説明はJava仮想マシン及びJDBC Driverの環境設定が終了していることを前提としています。
ここで説明した環境設定を終了すると,Javaストアドプロシジャ及びJavaストアドファンクションを作成して実行できます。作成及び実行方法については,マニュアル「HiRDB UAP開発ガイド」を参照してください。
- 〈この項の構成〉
(1) JARファイルを格納するディレクトリを作成します
JARファイルを格納するディレクトリを作成してください。ここで作成したディレクトリ名を(3)で指定するpd_java_archive_directoryオペランドに指定します。
- ポイント
-
-
JARファイルはJARファイル専用のディレクトリに格納してください。
-
JARファイルを格納するディレクトリには,インストールしたJARファイル以外のファイルを格納しないでください。
-
(2) pdstopコマンドでHiRDBを正常終了します
pdstop
システム構成変更コマンド(pdchgconfコマンド)を使用すると,HiRDBの稼働中にHiRDBシステム定義を変更できるため,ここでHiRDBを正常終了する必要がありません。ただし,このコマンドを使用する場合はHiRDB Advanced High Availabilityが必要になります。HiRDBの稼働中にHiRDBシステム定義を変更する方法については,「HiRDBの稼働中にHiRDBシステム定義を変更する方法(システム構成変更コマンド)」を参照してください。
(3) Java関連のHiRDBシステム定義のオペランドを指定します
HiRDBシステム定義の次に示すJava関連のオペランドを指定してください。
-
pd_java_routine_stack_size:外部Javaルーチンが使用するスタック領域長をバイト単位で指定します。
-
pd_java_archive_directory:JARファイル格納ディレクトリを指定します。
-
pd_java_runtimepath:Java Runtime Environmentのルートディレクトリを指定します。
-
pd_java_castoff:Java仮想マシンを起動したサーバプロセスを特定の契機で終了させるかどうかを指定します。※2
- 注※1
-
Javaストアドプロシジャ又はJavaストアドファンクションのデバッグ時に指定することをお勧めします。通常はこのオペランドを指定しないでください。
- 注※2
-
次の場合に指定することを検討してください。通常はこのオペランドを指定しないでください。
-
Java仮想マシンの使用によってメモリサイズが大きくなり,システムの空きメモリを圧迫している場合
-
別のコネクションでJava仮想マシンが設定したスタックサイズの上限が原因で,Java仮想マシンを使用しないコネクションでも探索条件が多いSQLを実行するとスタックの拡張ができなくなり,サーバプロセスがセグメンテーション障害でアボートする場合
-
(4) pdsetupコマンドでPOSIXライブラリ版をセットアップします(HP-UX版,及びAIX版限定)
Javaストアドプロシジャ及びJavaストアドファンクションを使用する場合は,POSIXライブラリ版を使用する必要があります。POSIXライブラリ版を使用する場合は,HiRDBの環境設定時に実行するpdsetupコマンドで-lオプションを指定します。HiRDBを新規導入する場合は忘れずにpdsetupコマンドで-lオプションを指定してください。
既にHiRDBを運用していてPOSIXライブラリ版を使用していない場合は,次に示す手順でHiRDBをPOSIXライブラリ版に変更してください。
- 〈手順〉
-
-
pdsetup -dコマンドでHiRDBをOSから削除してください。応答メッセージにはyを応答してください。
HiRDB/パラレルサーバの場合は全サーバマシンでpdsetup -dコマンドを実行してください。
-
pdsetupコマンドの-lオプションにPOSIXを指定して実行してください。
HiRDB/パラレルサーバの場合は全サーバマシンでpdsetup -lコマンドを実行してください。
- 注意事項
-
-
HP-UX (IPF)版の場合,POSIXに対応しているため,この作業は必要ありません。
-
HiRDB Version 5.0以前はPOSIXライブラリ版をサポートしていません。したがって,HiRDB Version 5.0以前からバージョンアップした場合は,この手順に従ってHiRDBをPOSIXライブラリ版に変更してください。
-
HiRDBの新規導入時,pdsetupコマンドに-lオプションを指定し忘れた場合もこの手順に従ってHiRDBをPOSIXライブラリ版に変更してください。
-
-
(5) pdstartコマンドでHiRDBを正常開始します
pdstart