Oracle® JDBC for Rdb

ユーザーズ・ガイド

2008年5月

リリース7.2.5.2

Oracle JDBC for Rdbユーザーズ・ガイド, リリース7.2.5.2

部品番号: E06181-01

原本名: Oracle JDBC for Rdb User Guide, Release 7.2.5.2

Copyright © 2005, 2008 Oracle Corporation. All rights reserved.

制限付権利の説明

このプログラム（ソフトウェアおよびドキュメントを含む）には、オラクル社およびその関連会社に所有権のある情報が含まれています。このプログラムの使用または開示は、オラクル社およびその関連会社との契約に記された制約条件に従うものとします。著作権、特許権およびその他の知的財産権と工業所有権に関する法律により保護されています。

独立して作成された他のソフトウェアとの互換性を得るために必要な場合、もしくは法律によって規定される場合を除き、このプログラムのリバース・エンジニアリング、逆アセンブル、逆コンパイル等は禁止されています。

このドキュメントの情報は、予告なしに変更される場合があります。オラクル社およびその関連会社は、このドキュメントに誤りが無いことの保証は致し兼ねます。これらのプログラムのライセンス契約で許諾されている場合を除き、プログラムを形式、手段（電子的または機械的）、目的に関係なく、複製または転用することはできません。

このプログラムが米国政府機関、もしくは米国政府機関に代わってこのプログラムをライセンスまたは使用する者に提供される場合は、次の注意が適用されます。

U.S. GOVERNMENT RIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.

このプログラムは、核、航空、大量輸送、医療あるいはその他の本質的に危険を伴うアプリケーションで使用されることを意図しておりません。このプログラムをかかる目的で使用する際、上述のアプリケーションを安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。万一かかるプログラムの使用に起因して損害が発生いたしましても、オラクル社およびその関連会社は一切責任を負いかねます。

Oracleは米国Oracle Corporationおよびその子会社、関連会社の登録商標です。その他の名称は、他社の商標の可能性があります。

このプログラムは、第三者のWebサイトへリンクし、第三者のコンテンツ、製品、サービスへアクセスすることがあります。オラクル社およびその関連会社は第三者のWebサイトで提供されるコンテンツについては、一切の責任を負いかねます。当該コンテンツの利用は、お客様の責任になります。第三者の製品またはサービスを購入する場合は、第三者と直接の取引となります。オラクル社およびその関連会社は、第三者の製品およびサービスの品質、契約の履行（製品またはサービスの提供、保証義務を含む）に関しては責任を負いかねます。また、第三者との取引により損失や損害が発生いたしましても、オラクル社およびその関連会社は一切の責任を負いかねます。

目次

はじめに. 7

このマニュアルの目的7

対象読者. 7

このマニュアルの構成. 7

表記規則. 7

第1章       概要. 9

第2章       Oracle JDBC for Rdb. 11

2.1      Oracle JDBC for Rdbネイティブ・ドライバ. 11

2.1.1        Oracle RdbデータベースのURL指定（Oracle JDBC for Rdbネイティブ・ドライバを使用する場合）11

2.1.2        クラス（Oracle JDBC for Rdbネイティブ・ドライバを使用する場合）12

2.2      Oracle JDBC for Rdb Thinドライバ. 12

2.2.1        Oracle RdbデータベースのURL指定（Oracle Rdb Thinドライバを使用する場合）13

2.2.2        クラス（Oracle JDBC for Rdb Thinドライバを使用する場合）14

2.3      接続オプション. 14

2.4      Oracle JDBC for Rdbのシステム・プロパティ. 17

第3章       Oracle JDBC for Rdbサーバー. 19

3.1      Oracle JDBC for Rdb Thinサーバー. 19

3.1.1        Thinサーバーの起動20

3.2      Oracle JDBC for Rdbマルチプロセス・サーバー. 21

3.2.1        マルチプロセス・サーバーの起動22

3.2.2        共有メモリーの使用. 24

3.2.3        エグゼキュータの事前起動. 24

3.2.4        エグゼキュータの命名. 25

3.2.5        エグゼキュータ・プロセスの起動. 26

3.3      Oracle JDBC for Rdbプール・サーバー. 28

3.3.1        プール・サーバーの起動29

3.3.2        プール・サーバーの操作. 30

第4章       サーバーの構成. 32

4.1      サーバーの構成オプション. 32

4.2      プール・サーバーの構成オプション. 40

4.3      構成ファイル. 43

4.3.1        標準のプロパティ・ファイル. 43

4.3.2        XML書式の構成ファイル. 44

第5章       SSLの使用.. 56

5.1      SSLの構成. 56

5.1.1        クライアントSSLの構成. 56

5.1.2        サーバーSSLの構成. 58

5.2      SSLとコントローラ. 59

5.3      SSL構成オプション. 60

5.4      自己署名付き証明書を使用したテスト. 61

第6章       Oracle JDBC for Rdbコントローラ. 63

6.1      コントローラの実行. 66

6.1.2        コントローラのコマンドライン. 69

6.2      サーバーへの接続. 74

6.2.1        connectコマンド. 75

6.2.2        暗黙的な接続. 76

6.3      制御パスワード. 76

6.4      サーバーの操作. 77

6.4.1        サーバーのクローズ. 78

6.4.2        サーバーのオープン. 79

6.4.3        サーバーの表示. 81

6.4.4        サーバーの起動. 83

6.4.5        サーバーの停止. 85

6.4.6        サーバーの監視. 87

6.4.7        サーバーのポーリング. 88

6.5      クライアントの操作. 90

6.5.1        クライアントの表示. 90

6.5.2        クライアントの停止. 91

第7章       Oracle SQL/ServicesとOracle JDBC for Rdbサーバー. 95

7.1      JDBCディスパッチャ. 95

7.1.1        Oracle SQL/Services JDBCディスパッチャの作成95

7.1.2        サーバーに対するOracle SQL/Services JDBCディスパッチャの関連付け96

7.1.3        JDBCディスパッチャの起動102

7.1.4        JDBCディスパッチャの停止103

7.2      Oracle SQL/Servicesによって使用されるコマンド・プロシージャ. 103

7.2.1        JDBCディスパッチャの設定手順. 104

7.3      プール・サーバーの使用. 105

第8章       その他の機能. 108

8.1      匿名のユーザー名. 108

8.2      BYPASS権限. 108

8.2.1        BYPASSとマルチプロセス・サーバー. 109

8.3      persona. 110

8.3.1        personaとサーバーの操作. 110

8.4      デフォルト・トランザクション. 111

8.5      Rdbネイティブ・ドライバとエグゼキュータ・サブプロセスの併用. 112

8.5.1        ハンドシェークの最大試行回数と待ち時間の設定. 112

8.6      FetchSize. 113

8.7      Statement.cancel()メソッド・コールの無視. 113

8.8      非アクティブ・タイムアウト. 114

8.8.1        クライアント接続タイムアウト114

8.8.2        サーバー非アクティブ・タイムアウト115

8.9      JDBCヒント・メソッド. 116

8.10     lockwaitとmaxtries. 116

8.10.1      lockwaitの優先順位. 117

8.11     ロギング. 119

8.12     名前. 119

8.13     名前付きデータベース. 121

8.14     起動時コマンド. 122

8.14.1      srv.onStartCmd. 122

8.14.2      srv.onExecStartCmd. 124

8.15     サーバー構成ファイルにおけるパスワードの不明瞭化. 124

8.16     サーバーおよびデータベース・アクセスの制限. 126

8.16.1      データベース・アクセスの制限. 126

8.16.2      ユーザー・アクセスの制限. 127

8.16.3      サーバーに対するその他のアクセス保護. 128

8.17     CONNECTION.setReadOnly()のスコープ129

8.18     サーバー・コマンド・プロシージャ. 129

8.18.1      サーバー起動コマンド・プロシージャ. 130

8.18.2      エグゼキュータ起動コマンド・プロシージャ. 131

8.19     サーバー/クライアントのプロトコル・チェック. 132

8.20     OpenVMS FailSAFE IPの使用132

8.21     SET文. 133

8.22     SQL文のキャッシュ. 134

8.23     トレース. 136

8.23.1      tracelevelの設定136

8.23.2      tracelevelの短縮形138

8.23.3      トレース値. 138

8.24     ファイルおよびディレクトリに関するアクセス要件. 139

第9章       Oracle RdbのJDBC拡張機能. 141

9.1      BLOB処理の拡張. 141

9.2      ResultSet.getBytes()142

第10章         その他の情報. 143

10.1     許可されていない動的SQL文. 143

10.2     Oracle JDBC for Rdb Thinサーバーの設定、起動および使用（例）143

10.3     Oracle SQL/ServicesによるOracle JDBC for Rdb Thinサーバーの設定と起動（例）152

10.4     構成ファイルの例（MY_SERVERS.XML）. 158

10.5     Oracle Rdbからjava.sql.Typesへのデータ型のマッピング. 160

10.6     java.sql.TypesからOracle Rdbへのデータ型のマッピング. 161

10.7     JDBC仕様: SQLからJavaへのデータ型のマッピング. 162

10.8     JDBC仕様: JavaからSQLへのデータ型のマッピング. 163

はじめに

このマニュアルの目的

『Oracle JDBC for Rdbユーザーズ・ガイド』では、Oracle JDBC for Rdbドライバおよびサーバーの概念、機能および使用方法について説明します。このマニュアルでは、AlphaサーバーおよびIntegrityサーバー上のOpenVMS用Oracle JDBC for Rdbについて説明します。

対象読者

このマニュアルでは、次のタスクを担当するユーザーを対象としています。

§   システム管理

§   データベース管理

§   アプリケーション・プログラミング

このマニュアルの構成

このマニュアルは、10の章から構成されています。

表記規則

Oracle JDBC for Rdbは、JDBCとも表記されます。

Hewlett-Packard社は、HP社とも表記されます。

このマニュアルでは次の表記規則を使用します。

目次

第1章  
概要

Oracleでは、次のOracle JDBC for Rdbドライバを提供しています。

§   Oracle JDBC for Rdbネイティブ・ドライバ: クライアント側で使用、Oracle Rdbのインストールが必要。

§   Oracle JDBC for Rdb Thinドライバ: クライアント側用の100% Pure Javaドライバ、Oracle Rdbのインストールが不要。アプレットと併用する際に特に便利です。

どちらのOracle JDBC for Rdbドライバも、提供する基本機能は同じです。どちらも、次の標準と機能をサポートしています。

§   JDK 1.4/JDBC 3.0

§   同一の構文とAPI

どちらのOracle JDBC for Rdbドライバも、Sun社の標準的なjava.sqlインタフェースを実装しています。これらの注意事項を読む読者は、JavaおよびJDBCにすでに精通しているものとします。

Javaの一般的な情報:

http://java.sun.com/reference

JDBCの一般的な情報:

http://java.sun.com/products/jdbc/index.html

HP社のOpenVMSシステム用Javaに関するドキュメント:

http://www.compaq.com/java/documentation/index.html - Java 2

http://h18012.www1.hp.com/java/documentation/index.html 

Oracle JDBC for Rdb Thinドライバとともに、Oracleでは次のOracle JDBC for Rdbサーバーも提供しています。

§   Oracle Rdb Thinサーバー

§   Oracle Rdb Thinマルチプロセス・サーバー

§   Oracle Rdb Thinプール・サーバー

Oracle JDBC for Rdbサーバーでは、Oracle JDBC for Rdb Thinドライバに代わって、リモート・データベース・アクセス操作を実行します。

Oracle JDBC for Rdbサーバーの管理は、Oracle JDBC for RdbコントローラまたはOracle SQL/Servicesマネージャを使用すると実行できます。

目次

第2章  
Oracle JDBC for Rdb

Oracle JDBC for Rdbドライバには、次の2つのタイプがあります。

§   Oracle JDBC for Rdbネイティブ・ドライバ

§   Oracle JDBC for Rdb Thinドライバ 

2.1         Oracle JDBC for Rdbネイティブ・ドライバ

Oracle JDBC for Rdbネイティブ・ドライバは、クライアント/サーバーJavaアプリケーションで使用するためのタイプ2ドライバです。

このネイティブ・ドライバは、JavaとCを組み合せてコーディングされており、独自の方法を使用してCのエントリ・ポイントをコールすることにより、JDBCの起動をSQLMODモジュールに対するコールに変換します。

ネイティブ・ドライバの使用時は、SQLMODを使用して、ネイティブ・ドライバからOracle Rdbデータベース・システムに直接接続されます。Rdbリモート・アクセスを使用しない場合は、ネットワーク接続が存在しません。つまり、ネイティブ・ドライバは、Oracle JDBC for Rdbドライバ内で利用可能な最高速のJDBCアクセス方法になる場合もあります。

ドライバは、SQLMODライブラリを使用してOracle Rdbにアクセスするため、同じクライアント・マシン上でOracle Rdb Clientライブラリも利用可能な場合は、そのマシン上でのみ使用できます。また、ネイティブ・ドライバでは、そのJava JNIインタフェースで使用する共有イメージを動的にロードする必要もあります。そのため、ネイティブ・ドライバは、Javaアプレットを必要とするアプリケーションには適していません。

2.1.1               Oracle RdbデータベースのURL指定（Oracle JDBC for Rdbネイティブ・ドライバを使用する場合）

JDBC DriverManagerを使用してOracle Rdbデータベースに接続する際にネイティブ・ドライバを使用する場合は、次の接続URL書式を使用します。

書式

               jdbc:RdbNative:<database_specification><connect_switches>

要素

 書式要素を表2–1「RdbNative書式要素」に示します。

表2-1         RdbNative書式要素

例

      MY_DB_DIR:PERSONNELへの接続方法:

     Connection conn = DriverManager.getConnection(

           "jdbc:RdbNative:my_db_dir:personnel",user, pass);

注意:

<database_specification>は、OpenVMSスタイルの有効なファイル指定または論理名である必要があります。

     my_disk:[my_directory]my_database

2.1.2               クラス（Oracle JDBC for Rdbネイティブ・ドライバを使用する場合）

Rdbネイティブ・ドライバは、次のクラスにあります。

  oracle.rdb.jdbc.rdbNative.Driver

2.2         Oracle JDBC for Rdb Thinドライバ

Oracle JDBC for Rdb Thinドライバは、100% Pure Javaのタイプ4ドライバです。すべてJavaで記述されているので、このドライバはプラットフォームに依存しません。クライアント側にOracleソフトウェアを追加する必要もありません。

アプレットと併用する場合、Thinドライバは実行されるJavaアプレットとともにブラウザにダウンロードできます。HTTPプロトコルはステートレスですが、Thinドライバは違います。アプレットおよびThinドライバをダウンロードする最初のHTTPリクエストは、ステートレスです。Thinドライバがデータベース接続を確立すると、ブラウザとデータベースの間の接続はステートフルになり、2層構成になります。

Thinドライバを使用すると、Javaソケット上でTCP/IPを使用し、Oracle JDBC for Rdbサーバーを介して任意のOracle Rdbデータベースに直接接続できます。

注意:

Thinドライバとアプレットを併用する場合、クライアント側のブラウザではJavaソケットをサポートしている必要があります。

2.2.1               Oracle RdbデータベースのURL指定（Oracle Rdb Thinドライバを使用する場合）

JDBC DriverManagerを使用してOracle Rdbデータベースに接続する際にThinドライバを使用する場合は、次の接続URL書式を使用します。

書式

  jdbc:rdbThin://<node>:<port>/<database_specification><connect_switches>

要素

 書式要素を表2–2「RdbThin書式要素」に示します。

表2-2         RdbThin書式要素

例

ポート1701を使用してノードBRAVO上のMY_DB_DIR:PERSONNELにThinドライバを介して接続する場合の手順:

        Connection conn = DriverManager.getConnection(

             "jdbc:rdbThin://bravo:1701/my_db_dir:personnel",user, pass);

注意:

<database_specification>は、次のようにOpenVMSスタイルの有効なファイル指定または論理名である必要があります。

  my_disk:[my_directory]my_database

Oracle Rdb Thinドライバによる接続を使用する場合、データベースの指定で使用する論理名および相対ディレクトリ指定は、Oracle Rdb Thinサーバーの起動元アカウントおよびディレクトリに対して有効である必要があります。

2.2.2               クラス（Oracle JDBC for Rdb Thinドライバを使用する場合）

Rdb Thinドライバは、次のクラスにあります。

                 oracle.rdb.jdbc.rdbThin.Driver

目次

2.3         接続オプション

Oracle JDBC for Rdbドライバでは、接続時に確立される特定のデフォルトの動作および設定を指定するために接続文字列に追加される可能性がある一連のオプションを認識します。

接続オプションは、セパレータとして@文字を使用し接続URLに直接追加することもできますし、DriverManager.GetConnection()メソッドに渡すことができるプロパティ・ブロック内のプロパティ値として追加することもできます。

接続URL内での書式

               @<option_name>=<value>

オプション

使用可能な接続オプションを、表2–3「接続オプション」に示します。

表2-3     接続オプション

NONE

例

ポート1755を使用するノードBRAVO上のMY_DB_DIR:PERSに、Oracle JDBC for Rdbサーバーを介してThinドライバを使用し接続する手順（該当する接続のフル・トレース・ロギングを有効化）:

      Connection conn = DriverManager.getConnection(

          "jdbc:rdbThin://bravo:1755/my_db_dir:pers@tracelevel=-1",

          user, pass);

これらのオプションは、プロパティ・ブロックに配置することもできます。

            Properties info = new Properties();

            info.put("user", user);

            info.put("password", password);

            info.put("tracelevel", traceLevel);

            Connection conn = DriverManager.getConnection(

            "jdbc:rdbThin://bravo:1755/my_db_dir:pers", info);

2.4         Oracle JDBC for Rdbのシステム・プロパティ

Oracle JDBC for Rdbのドライバおよびサーバーは、アプリケーションの起動時にオペレーティング・システムのコマンドラインからJavaシステム・プロパティとして渡される構成プロパティまたは接続プロパティを認識できます。

Rdbネイティブ・ドライバまたはRdb Thinドライバは、それらのドライバを起動するアプリケーションとともに使用される場合、有効な接続オプションに類似した<option_name>を持つシステム・プロパティを認識できます。それらのオプションの詳細は、「接続オプション」を参照してください。

同じ構成オプションをRdbシステム・プロパティとして指定し、接続URL内でも指定した場合は、接続URL内の値が優先されます。

Rdbサーバーの起動とともに使用すると、該当するサーバーはサーバー構成オプションとして使用可能な<option_name>を持つシステム・プロパティを認識します。それらのオプションの詳細は、「サーバーの構成オプション」および「プール・サーバーの構成オプション」を参照してください。

サーバーの起動時に指定したRdbシステム・プロパティは、標準の構成オプションとしてコマンドラインで指定したプロパティまたは構成ファイルで指定したプロパティよりも優先されます。

書式 

      -Doracle.rdb.jdbc.<option_name>=<value>

例 

Rdbネイティブ・ドライバまたはRdb Thinドライバを使用するアプリケーションに対し、すべての情報をトレースするようトレース・レベルを設定する手順:

                $java –Doracle.rdb.jdbc.tracelevel=-1 my_application

目次

第3章  
Oracle JDBC for Rdbサーバー

Oracle JDBC for Rdbサーバーは、Oracle Rdb Thinドライバを使用するアプリケーションによって発行されたJDBCリクエストにサービスを提供するサーバー側のコンポーネントです。

Oracle JDBC for Rdbサーバーには、次の3つのタイプがあります。

§   Oracle JDBC for Rdb Thinサーバー

§   Oracle JDBC for Rdbマルチプロセス・サーバー

§   Oracle JDBC for Rdbプール・サーバー

いずれのサーバーもマルチスレッドであり、複数のクライアント・リクエストを同時に処理できます。

Oracle JDBC for Rdbサーバーは、Oracle Rdbデータベースにサービスを提供する各ノードにインストールし、各ノード上で起動する必要があります。

Oracle JDBC for Rdb Thinドライバは、TCP/IP上でJavaソケットを使用し、Oracle JDBC for Rdbサーバーと通信します。

各サーバー・タイプと、システム上でサーバーを起動する様々な方法を、後述の項で説明します。

注意:

Oracle JDBC for Rdbサーバーを起動するには、Oracle JDBC for Rdbのディレクトリおよびファイルに対する所定のアクセス権が必要です。詳細は、「ファイルおよびディレクトリに関するアクセス要件」を参照してください。

3.1         Oracle JDBC for Rdb Thinサーバー

Oracle JDBC for Rdb Thinサーバーは、Oracle Rdb Thinドライバを使用するアプリケーションによって発行されたJDBCリクエストにサービスを提供するサーバー側のコンポーネントです。

標準のThinサーバーはマルチスレッドであり、複数のクライアント・リクエストを同時に処理できます。このサーバーは単一のOpenVMSプロセスとして管理されるため、各スレッドにおけるデータベース・アクセスは同期化されます。

Thinサーバーは、Oracle Rdbデータベースにサービスを提供する各ノードにインストールされ、各ノード上で起動されます。該当するノードでは、Oracle Rdbがすでにインストールされていて、稼働している必要があります。

Thinサーバーは、TCP/IP上でJavaソケットを使用し、Oracle Rdb Thinドライバと通信します（デフォルトのポートIDは1701）。

3.1.1         Thinサーバーの起動

Thinサーバーを起動する方法には、コントローラ内で適切なstart文を使用する方法、Oracle SQL/Services JDBCディスパッチャとして起動する方法、およびオペレーティング・システムのコマンドラインから直接起動する方法があります。

3.1.1.1   Oracle JDBC for RdbコントローラからThinサーバーを起動する方法

Thinサーバーは、XML書式の構成ファイル内でThinサーバーの定義を参照することにより、コントローラから起動できます。詳細は、「Oracle JDBC for Rdbコントローラ」の「サーバーの起動」を参照してください。

例

XML書式の構成ファイルmycfg.xmlの中に次のようなserverセクションがある場合:

<server

      name="serv1"

      type="RdbThinSrv"

      url="//localhost:1707/"

      logfile="myLogs:serv1.log"

/>

次のコマンドを使用すると、該当するサーバーをコントローラ内から起動できます。

rdbthincontrol> start server serv1

また、コントローラをコマンド・モードで使用し、サーバーを起動することもできます。

$ java –jar rdbthincontrol.jar –cfg mycfg.xml –

       –name serv1 –startserver

3.1.1.2   Oracle SQL/ServicesからThinサーバーを起動する方法

Thinサーバーは、Oracle SQL/Servicesマネージャから起動することもできます。

Oracle SQL/Servicesマネージャを使用する場合はまず、SQL/Serviceサーバーに対する接続を確立する必要があります。接続が確立されたら、JDBCディスパッチャを起動できます。

ただし、JDBCディスパッチャは、Oracle SQL/Services環境でその定義を作成しておかないと、起動することができません。

詳細は、「Oracle SQL/ServicesとOracle JDBC for Rdbサーバー」を参照してください。

例

$run sys$system:SQLSRV_MANAGE71

SQLSRV> connect server;

Connecting to server 

Connected

SQLSRV> start disp JDBC_MPDISP;

SQLSRV>

3.1.1.3   コマンドラインからThinサーバーを起動する方法

Thinサーバーは、OpenVMSのコマンドラインから起動することもできます。

コマンドラインで一連のオプションを指定するより、XML書式の構成ファイル内でサーバーの定義を作成した後、そのサーバー名を指定してサーバーを起動するとよいでしょう。この場合のサーバー定義におけるサーバー・タイプは、標準的なThinサーバーを表すRdbThinSrvに設定します。

書式

$ java –jar rdbthinsrv.jar [-option ]

有効なオプションについては、「サーバーの構成オプション」を参照してください。DCLコマンドラインの場合は、各構成オプションの前にハイフン（-）を付ける必要があります。

デフォルト時、サーバーはタイプRdbThinSrv（標準的なThinサーバー）であると仮定されます。

例

$ java –jar rdbthinsrv.jar -port 1707

XML書式の構成ファイルmycfg.xmlの中に次のようなserverセクションがある場合:

<server

      name="serv1"

      type="RdbThinSrv"

      url="//localhost:1707/"

      logfile="myLogs:serv1.log"

/>

次の方法を使用すると、該当するThinサーバーを起動できます。

$ java –jar rdbthinsrv.jar –cfg mycfg.xml –name serv1

構成ファイル内のサーバー定義の詳細は、「XML書式の構成ファイル」を参照してください。

3.2         Oracle JDBC for Rdbマルチプロセス・サーバー

Oracle JDBC for Rdbマルチプロセス・サーバーは、メモリー・フットプリントが小さいサブプロセスを使用してOracle JDBC for Rdb Thinドライバからのリクエストを処理し、要求された操作をOracle Rdbデータベース上で実行するサーバー側のコンポーネントです。

マルチプロセス・サーバーはマルチスレッドであり、各クライアントにデータベース・アクセス用の独自のサブプロセスを割り当てることにより複数のクライアントを同時に処理し、同時実行性と可用性を向上させます。

マルチプロセス・サーバーの操作のほとんどはメインのサーバー・プロセスの中のクライアント・スレッド・コンテキスト内で実行され、クライアントに割り当てられたサブプロセスに制御が渡されるのは、Oracle Rdbデータベースに対する直接的な操作が必要な場合のみです。どのクライアントもそれ独自のOpenVMSサブプロセスを持つので、同時実行性が改善されます。それは、データベース操作の同期化をサーバーで行う必要がないためです。

割り当てられたサブプロセスはデフォルト時、クライアントの切断時に終了します。エグゼキュータは、クライアントの切断後に再利用できるよう、そのままにしておくこともできます。詳細は、「エグゼキュータの事前起動」を参照してください。

マルチプロセス・サーバーは、Oracle Rdbデータベースにサービスを提供する各ノードにインストールされ、各ノード上で起動されます。該当するノードでは、Oracle Rdbがすでにインストールされていて、稼働している必要があります。

マルチプロセス・サーバーは、TCP/IP上でJavaソケットを使用し、Thinドライバと通信します（デフォルトのポートIDは1701）。

3.2.1         マルチプロセス・サーバーの起動

マルチプロセス・サーバーを起動する方法には、コントローラ内で適切なstart文を使用する方法、Oracle SQL/Services JDBCディスパッチャとして起動する方法、およびオペレーティング・システムのコマンドラインから直接起動する方法があります。

3.2.1.1   コントローラからマルチプロセス・サーバーを起動する方法

マルチプロセス・サーバーは、XML書式の構成ファイル内でマルチプロセス・サーバーの定義を参照することにより、コントローラから起動できます。詳細は、「Oracle JDBC for Rdbコントローラ」の「サーバーの起動」を参照してください。

例 

XML書式の構成ファイルmycfg.xmlの中に次のようなserverセクションがある場合:

<server

      name="Mpserv1"

      type="RdbThinSrvMP"

      url="//localhost:1799/"

      logfile="myLogs:serv1.log"

/>

次のコマンドを使用すると、該当するサーバーをコントローラ内から起動できます。

rdbthincontrol> start server Mpserv1

また、コントローラをコマンド・モードで使用し、サーバーを起動することもできます。

$ java –jar rdbthincontrol.jar –cfg mycfg.xml –

   –name Mpserv1 –startserver

3.2.1.2   Oracle SQL/Servicesからマルチプロセス・サーバーを起動する方法

マルチプロセス・サーバーは、Oracle SQL/Servicesマネージャから起動することもできます。

Oracle SQL/Servicesマネージャを使用する場合はまず、SQL/Serviceサーバーに対する接続を確立する必要があります。接続が確立されたら、JDBCディスパッチャを起動できます。

ただし、JDBCディスパッチャは、Oracle SQL/Services環境でその定義を作成しておかないと、起動することができません。

詳細は、「Oracle SQL/ServicesとOracle JDBC for Rdbサーバー」を参照してください。

例 

$run sys$system:SQLSRV_MANAGE71

SQLSRV> connect server;

Connecting to server

Connected

SQLSRV> start disp JDBC_MPDISP;

SQLSRV>

 詳細は、「Oracle SQL/ServicesとOracle JDBC for Rdbサーバー」を参照してください。

3.2.1.3   コマンドラインからマルチプロセス・サーバーを起動する方法

マルチプロセス・サーバーは、OpenVMSのコマンドラインから起動することもできます。

書式

$ java –jar rdbthinsrv.jar [-option]

有効なオプションについては、「サーバーの構成オプション」を参照してください。DCLコマンドラインの場合は、各構成オプションの前にハイフン（-）を付ける必要があります。

Thinサーバーもマルチプロセス・サーバーも、同一のrdbthinsrv.jarファイルを使用して起動されます。起動されるサーバーのスタイルを決定するのは、サーバー・タイプです。

デフォルト時、サーバーはタイプRdbThinSrv（標準的なThinサーバー）であると仮定されます。マルチプロセス・サーバーを起動するには、サーバー・タイプをRdbThinSrvMPに設定する必要があります。

 例

$ java –jar rdbthinsrv.jar –port 1755 –type "RdbThinSrvMP"

DCLのコマンドラインの場合、タイプ名の大文字/小文字の区別を維持するには二重引用符で囲む必要があります。

また、XML書式の構成ファイル内でサーバーの定義を作成し、そのサーバー名を指定してサーバーを起動することもできます。その場合も、サーバー・タイプはRdbThinSrvMPに設定する必要があります。

XML書式の構成ファイルmycfg.xmlの中に次のようなserverセクションがある場合:

<server

      name="Mpserv1"

      type="RdbThinSrvMP"

      url="//localhost:1799/"

      sharedmem="102400"

      logfile="myLogs:serv1.log"

/>

次の方法を使用すると、該当するマルチプロセス・サーバーを起動できます。

$ java –jar rdbthinsrv.jar –cfg mycfg.xml –name Mpserv1

3.2.2   共有メモリーの使用

マルチプロセス・サーバーでは、そのエグゼキュータと通信するために、共有グローバル・メモリーを割り当てる必要があります。その場合は、サーバー構成オプションのsharedmemを使用して指定できます。

共有メモリーのデフォルトの割当ては1024KBであり、これが十分なのはエグゼキュータが1つまたは2つの場合のみです。

サーバーと同時に動作すると考えられるエグゼキュータごとに1024KBを割り当てるのが目安ですが、それは問合せの複雑さ、関連する列の数、Rdbからエグゼキュータに返されるデータを保持するために作成される必要があるデータ領域のサイズによって異なります。

3.2.3   エグゼキュータの事前起動

マルチプロセス・サーバーの場合は、サーバーの起動時に事前開始できるエグゼキュータ・プロセスの数を指定することもできます。

また、サーバーの稼働中に待機させておくことができる解放されたエグゼキュータ・プロセスの最大数を指定することもできます。システム・ロードが原因でOpenVMSのプロセスおよびサブプロセスの起動にシステムで時間が少しかかる場合、これは特に便利です。

エグゼキュータ・プロセスを事前起動しておけば、クライアントがその最初のデータベース接続にかかる時間全体を短縮できます。

3.2.4   エグゼキュータの命名

単一のシステム上で起動される各エグゼキュータは、該当するシステム上で一意なプロセス名を持ちます。デフォルト時、その名前は、起動元サーバーの名前と、そのサーバーに関連するエグゼキュータ・プロセスのインスタンスを表す16進値から作成されます。

エグゼキュータの命名書式は、srv.execPrefix構成オプションを使用して変更することもできます。

マルチプロセス・サーバーに対してsrv.execPrefix構成オプションを指定すると、該当するサーバーのすべてのエグゼキュータの名前にその接頭辞が付きます。サーバーは、指定された接頭辞の後にエグゼキュータの16進数値ID（文字データ）を付加して各エグゼキュータ・インスタンスに一意な名前を付けます（それでもエグゼキュータ名はOpenVMSが要求するプロセス名のサイズに収まっている）。

エグゼキュータの名前は大/小文字が区別されます。

サーバー定義の詳細は、「XML書式の構成ファイル」を参照してください。

エグゼキュータ・サブプロセスの名前はデフォルト時、次の書式です。

書式

サーバー名の最初の7文字+16進IDの8文字。

例

RDBTHNS00000220

そのため、同一のシステム内で起動されるマルチプロセス・サーバーの名前の先頭7文字は、大/小文字の区別以外は一意である必要があります。そうしないと、エグゼキュータ・プロセスの名前が重複するおそれがあります。

srv.execPrefixを指定すると、このデフォルトの命名書式が無効になります。

srv.execPrefixに"MY_EXECUTOR_"を設定した場合、4番目のエグゼキュータの名前は次のようになります。

MY_EXECUTOR_004

注意:

接頭辞が長くなると、一意性を確保するための文字数が短くなります。そのため、エグゼキュータ名の接頭辞をカスタマイズする際は、サーバーに同時に維持させるエグゼキュータの数を考慮する必要があります。

3.2.5               エグゼキュータ・プロセスの起動

マルチプロセス・サーバーは、割り当てて起動するエグゼキュータごとに、サブプロセスを1つ作成します。このサブプロセスの作成時には、OpenVMSのコマンド・プロシージャが使用されます。これらのコマンド・プロシージャについては、このドキュメントの「サーバー・コマンド・プロシージャ」および「起動時コマンド」を参照してください。

サーバーでpersona（詳細は「persona」を参照）が指定されている場合、サーバーはOpenVMS CREPRCシステム・サービスを使用して該当プロセスを起動します。personaが指定されていない場合は、Java System.exec()メソッドがかわりに使用されます。

サーバーを稼働させるための環境またはJDBCディレクトリが適切に設定されていないと、エグゼキュータ・プロセスの起動時にエラーが発生する可能性があります。

JDBCディレクトリのアクセス要件の詳細は、 「ファイルおよびディレクトリに関するアクセス要件」 を参照してください。

エグゼキュータ・プロセスを起動する際の手順は、サーバーでpersonaを使用するかどうかによって異なります。

3.2.5.1   エグゼキュータの起動手順

personaを使用しない場合

personaを使用しない場合は、サーバーによって次の手順が実行され、エグゼキュータが起動されます。

1.      サーバー名に基づき、新しいプロセスのエグゼキュータ名が生成されます。詳細は、「エグゼキュータの命名」を参照してください。

2.      System.exec()メソッドを使用して、アタッチされたプロセスが作成されます。

3.      マルチプロセス・サーバーのsrv.execStartupオプションによって指定されているコマンド・プロシージャが実行されます。このオプションがサーバーでも構成ファイル内のDEFAULTサーバーでも指定されていない場合は、RDB$JDBC_HOME:RDBJDBC_STARTEXEC.COM が使用されます。「サーバー起動コマンド・プロシージャ」を参照してください。

4.      該当するサーバーまたはDEFAULTサーバーでsrv.onExecStartCmdオプションが指定されている場合は、該当するコマンドが実行されます。これは通常、サーバー環境およびサイト固有環境の設定に使用されます。「srv.onExecStartCmd」を参照してください。

5.      論理名RDBJDBCEXECによって指定されているエグゼキュータ・イメージが実行されます。

6.      エグゼキュータとサーバーが、通信チャネルを確立します。    

personaを使用する場合

personaを使用する場合は、次の手順が実行されます。

1.      サーバー名に基づき、新しいプロセスのエグゼキュータ名が生成されます。詳細は、「エグゼキュータの命名」を参照してください。

2.      稼働中のサーバーの現在の割当て制限に基づいて、エグゼキュータ・プロセスの割当て制限が決定されます。 

3.      終了メールボックスがエグゼキュータ・プロセスのために設定され、読取りが発行されます。

4.      CREPRCを使用してプロセスが作成され、SYS$SYSTEM:LOGINOUT.EXEが実行されます。

5.      先のリストの手順3〜6が実行されます。

3.2.5.2   エグゼキュータ・プロセスの起動時の問題

エグゼキュータ・サブプロセスの作成時にサーバーで問題が発生すると、その問題に関連するステータス・コードがサーバー・ログに書き込まれます。

  Java.sql.SQLException: Unable to start process,

     status: 0x56EC03C : substatus 65535

今示したステータス・コードは、VMSのステータス・コードまたはRdb固有のステータス・コードです。このステータス・コードの詳細は、OpenVMSおよびOracle Rdbのドキュメントを参照してください。

検出された問題の詳細は、substatusで示されます。表3–1「サブコードの説明」に、サブコードの値とその意味を示します。

表3-1      サブコードの説明

注意:

JDBC$RDB_HOME、RDB$JDBC_COMおよびRDB$JDBC_LOGSの論理名によって指定されたディレクトリに対してサーバー・プロセスが適切なアクセス権を所持していることが重要です。詳細は、「ファイルおよびディレクトリに関するアクセス要件」を参照してください。

目次

3.3         Oracle JDBC for Rdbプール・サーバー

Oracle JDBC for Rdbプール・サーバーは、Thinドライバから接続リクエストを受け取り、次に利用可能なOracle JDBC for Rdbサーバーにそれらのリクエストをリダイレクトして処理させるサーバー側コンポーネントです。

プール・サーバーを使用する場合に指定できる単一のポートIDをクライアント側アプリケーションで使用すれば、次に利用可能なサーバーに接続できます。プール・サーバーは、一連の候補のサーバーから構成されるテーブルから、次に利用可能なサーバーをラウンドロビン法で選択します。

接続リクエストのリダイレクトが完了すると、Thinドライバと指定されたサーバーが互いに直接通信します。

プール・サーバーは、Oracle JDBC for Rdbサーバーにアクセスをリダイレクトする各ノードにインストールされ、各ノード上で起動されます。プール・サーバーはOracle Rdbと直接通信しないので、それらのノードにOracle Rdbが存在している必要はありません。プール・サーバーと、そのプール・サーバーによってプーリングされるサーバーは、同じノード上に存在している必要がありません。

プール・サーバーは、TCP/IP上でJavaソケットを使用し、Thinドライバと通信します（デフォルトのポートIDは1702）。

注意:

Thinプール・サーバーは、接続のプーリングではなくサーバーのプーリングを実行します。接続は、各接続リクエスト内で作成されますが、再利用可能ではありません。

3.3.1    プール・サーバーの起動

プール・サーバーは、サーバーのリダイレクトを実行する各ノード上で起動する必要があります。プール・サーバーは、そのプール・サーバーによってプーリングされるサーバーと同じノード上に存在している必要がありません。

プール・サーバーを起動する方法には、コントローラ内で適切なstart文を使用する方法、Oracle SQL/Services JDBCディスパッチャとして起動する方法、およびオペレーティング・システムのコマンドラインから直接起動する方法があります。

3.3.1.1   コントローラからプール・サーバーを起動する方法

プール・サーバーは、XML書式の構成ファイル内でThinプール・サーバーの定義を参照することにより、コントローラから起動できます。詳細は、「Oracle JDBC for Rdbコントローラ」の「サーバーの起動」を参照してください。

例

XML書式の構成ファイルmycfg.xmlの中に次のようなserverセクションがある場合:

<server

      name="mypoolserver"

      type="RdbThinSrvPool"

      url="//localhost:1702/" >

      <pooledServer name="srv1forRdb"/>

      <pooledServer name="srv2forRdb"/>

      <pooledServer name="srvMPforRdb"/>

</server>

次のコマンドを使用すると、該当するサーバーをコントローラ内から起動できます。

rdbthincontrol> start server mypoolserver

また、コントローラをコマンド・モードで使用し、サーバーを起動することもできます。

$ java –jar rdbthincontrol.jar –cfg mycfg.xml –

   –name mypoolserver –startserver

3.3.1.2   Oracle SQL/Servicesからプール・サーバーを起動する方法

プール・サーバーは、Oracle SQL/Servicesマネージャから起動することもできます。

Oracle SQL/Servicesマネージャを使用する場合はまず、SQL/Serviceサーバーに対する接続を確立する必要があります。接続が確立されたら、JDBCディスパッチャを起動できます。

ただし、JDBCディスパッチャは、Oracle SQL/Services環境でその定義を作成しておかないと、起動することができません。

詳細は、「Oracle SQL/ServicesとOracle JDBC for Rdbサーバー」を参照してください。

例 

$run sys$system:SQLSRV_MANAGE71

SQLSRV> connect server;

Connecting to server

Connected

SQLSRV> start disp JDBC_DISP;

SQLSRV>

詳細は、「Oracle SQL/ServicesとOracle JDBC for Rdbサーバー」を参照してください。

3.3.1.3   コマンドラインからプール・サーバーを起動する方法

プール・サーバーは、OpenVMSのコマンドラインから起動することもできます。

書式

      $ java –jar rdbthinsrvpool.jar [-option ]

有効なオプションについては、「プール・サーバーの構成オプション」を参照してください。

どのオプションにも、前にハイフン（–）を付ける必要があります。

例 

$ java –jar rdbthinsrvpool.jar –cfg mycfg.xml –

–name mypoolserver

3.3.2         プール・サーバーの操作

プール・サーバーは、起動されると、プーリングされているサーバーのリストをラウンドロビン法でスキャンし、次に利用可能なサーバーを選択します。

プール内のサーバーの起動と停止は、いつでも実行できます。利用できないサーバーは、プール・サーバーによってバイパスされます。プール・サーバーでは、プール・サーバー自体の起動時に、プーリングされているサーバーの1つ以上を自動的に起動することもできます。

プール・サーバーの起動時は、そのプール内の各サーバーに対してチェックが実行され、プーリングされているサーバーのautoStartオプションが有効になっているかどうかが調べられます。autoStartが有効な場合は、プーリングされているサーバーのsrv.startupオプションによって指定されているコマンド・プロシージャが実行されます。詳細は、「サーバー・コマンド・プロシージャ」を参照してください。

プール・サーバーは稼働中、サーバーのプールにプーリングされている各サーバーでautoRestartオプションが有効になっていてまだ実行されているかを定期的にチェックします。プーリングされているものの稼働していないサーバーに対してautoRestartが有効になっていると、そのサーバーのsrv.startupオプションによって指定されているコマンド・プロシージャが実行され、そのサーバーが再起動されます。

プール・サーバーの起動時にsrv.keepAliveTimerオプションを使用すると、稼働していないautoRestartサーバーのチェックの間の時間を指定できます。詳細は、「プール・サーバーの構成オプション」を参照してください。

コントローラまたはOracle SQL/Servicesマネージャを使用してプール・サーバーを停止すると、該当サーバーの停止中に、該当プールにプーリングされているサーバーでautoStartが有効になっている全サーバーも停止されます。

3.3.2.1   プール・サーバーによるリダイレクトとfailSAFE IP

プール・サーバーによる接続のリダイレクト時、プーリングされているサーバーの中で選択されたサーバーのIPがThinドライバに返されます。そのため、Thinドライバは、その選択されたサーバーにクライアントの接続リクエストをリダイレクトできます。DNSノード名の変換がクライアント・ノードとサーバー・ノードで異なる可能性があるので、プール・サーバーは指定されたノードをすべてIPアドレスに暗黙的に変換した後、得られたIPをThinドライバに返します。

このIPアドレスへの変換により、failSAFE IPによって実行されるスタンバイ・アドレスへのフェイルオーバーが制限される場合もあります。

failSAFE IPはOpenVMS上のTCP/IP Servicesによって提供されるオプション・サービスであり、これにより、ノードで障害が発生した場合にIPアドレスのフェイルオーバーが可能になります。

指定されたIPの「論理的」な性質を維持し、failSAFE IPがスタンバイ・ノードに正しくリダイレクトされるように、接続のリダイレクト時、指定されたノードをプール・サーバーがIPアドレスに変換しないように指定することもできます。

詳細は、「プール・サーバーの構成オプション」の–srv.useLogicalIpsを参照してください。

目次

第4章  
サーバーの構成

Oracle JDBC for Rdbサーバーに適用される構成オプションは多数あり、それらはコマンドライン・オプションとして使用することもできますし、構成ファイル内のサーバー・オプションとして使用することもできます。

これらのオプションを構成ファイル内で使用する方法の詳細は、「構成ファイル」を参照してください。

利用可能な構成オプションの詳細を、次の項で説明します。

4.1         サーバーの構成オプション

次のサーバー構成オプションは、標準のThinサーバーおよびマルチプロセス・サーバーの場合に、コマンドラインまたは構成ファイルで使用できます。プール・サーバーで使用可能なオプションについては、「プール・サーバーの構成オプション」を参照してください。

表4–1「サーバーの構成オプション」に、これらのオプションを示します。

表4-1     サーバーの構成オプション

目次

4.2         プール・サーバーの構成オプション

プール・サーバーで使用できる有効な構成オプションを、表4–2「プール・サーバーの構成オプション」に示します。

表4-2     プール・サーバーの構成オプション

サーバー・プール内に一連のサーバーがリストされている可能性があるので、前述のオプションは構成ファイルを使用して指定した方がよいでしょう。標準的な構成ファイルを使用する場合、プール内のサーバーの数はpoolsizeオプションによって指定します。XML書式の構成ファイルの場合、プール内のサーバーの数はPooledServerサブセクションの数によって決定されます。プールに含まれるサーバーごとに、ノードとポートIDを指定する必要があります。

プール・サーバーの構成例は、「構成ファイル」を参照してください。

目次

4.3         構成ファイル

コマンドラインで一連のスイッチを設定するかわりに、構成ファイルを指定し、設定の詳細を示すこともできます。

次の2つの書式の構成ファイルが認識されます。

§   標準のJavaプロパティ・ロード・ファイル

§   XML書式のファイル

4.3.1               標準のプロパティ・ファイル

ここでは、標準のJavaプロパティ・ロード・ファイルという書式を持つ構成ファイルの使用方法について説明します。XML書式の構成ファイルの使用の詳細は、「XML書式の構成ファイル」を参照してください。

「サーバーの構成オプション」および「プール・サーバーの構成オプション」で示したのと同じサーバー構成オプションを使用できますが、次の変更点があります。

1.      どのキーワード（コマンドライン上で値を持たないものも含む）の場合も、値が必要です。それらのオプションはブールと考えられるため、適切な‘TRUE’値を持つ必要があります。

2.      各キーワードの値は、等号（=）を使用して指定する必要があります。

コマンドラインの–cfgスイッチを使用すると、構成ファイルを指定できます。

書式

$java –jar rdb$jdbc_home:rdbthinsrv.jar –cfg thinsrv.cfg

例

構成ファイルの中では、次のように、Javaスタイルのコメント行と空の行を指定できます。

      //

        // configuration file for our thin server

        //

        // the default port for the thin server is 1701 but we

        // want it to listen on another port

        port=1708

        // allow anonymous connections

        anonymous=true

        // enable password display

        showpass=true

        // limit the number of clients

        maxclients=10

        // set the locking keywords

        lockwait=2

        maxtries=20

               // end of config file

また、Thinプール・サーバーの構成ファイルの中では、次のように、接続リクエストの委任先となる可能性があるThinサーバーのリストに関する情報を指定する必要があります。

//

// configuration file for pool server

//

// the default port for the pool server is 1702

port=1702

// show is a pool server and the poolsize ( number of subservient servers)

poolserver=true

poolsize=4

// now add the servers

node1=MYNODE1

port1=1704

node2=MYNODE1

port2=1705

node3=MYNODE1

port3=1706

node4=MYNODE2

port4=1704

// end of config file

目次

4.3.2               XML書式の構成ファイル

コマンドラインで一連のスイッチを設定するかわりに、XML書式の構成ファイルを指定し、それらスイッチの設定の詳細を示すこともできます。XML書式の構成ファイルは、標準のCFGファイルに比べて指定できる構成オプションの数が多いので、構成ファイルの書式としてお薦めです。

XML書式の構成ファイルが標準のCFGファイルと異なっている点は、同じ構成ファイルの中で複数のサーバーに関する情報を指定できる点です。

どのサーバーも、各serverセクションで指定し、一意な名前を持つ必要があります。この名前は、サーバーの起動時に該当するサーバーのデフォルトの構成情報を取得したり、システム上およびコントローラ・インタフェース内でのサーバーの特定方法を取得したりするのに使用されます。

コマンドラインの–cfgスイッチを使用すると、この構成ファイルを指定できます。

「サーバーの構成オプション」および「プール・サーバーの構成オプション」で示したのと同じサーバー構成オプションを使用できますが、次の変更点があります。

·        どのキーワード（コマンドライン上で値を持たないものも含む）の場合も、値が必要です。それらのオプションはブール値と考えられるため、適切な‘TRUE’値を持つ必要があります。

·        各キーワードの値は、等号（=）を使用して指定する必要があります。

·        どのオプション値も、二重引用符で囲む必要があります。

この構成ドキュメントは、階層的なXMLオブジェクトです。どのキーワードも、適切なセクションまたはサブセクションに記述する必要があります。同一の構成ファイル内で、複数のサーバーを指定できます。どのサーバーも、一意な名前を持つ必要があります。

               この構成ファイルの内容の書式は、XML V1.0です。

書式

               $java –jar rdb$jdbc_home:rdbthinsrv.jar –cfg rdbjdbccfg.xml

例

<?xml version = ‘1.0’?>

<!—Configuration file for Rdb Thin JDBC Drivers and Servers -->

<config>

  <!—SERVERS -->

  <servers>

    <!—DEFAULT server characteristics-->

    <server

      name="DEFAULT"

      type="RdbThinSrv"

      url="//localhost:1701/"

      maxClients="-1"

      srv.bindTimeout="1000"

      srv.idleTimeout="0"

      srv.mcBasePort="5517"

      srv.mcGroupIP="239.192.1.1"

      tracelevel = "0"

      autostart = "false"

      autorestart = "false"

      restrictAccess = "false"

      anonymous = "false"

      bypass = "false"

      tracelocal = "false"

      relay = "false"

      controlUser="control_user"

      controlPass="0x18E007C81F6B2E2EA02065F78A587BD3"

      cfg="rdb$jdbc_com:rdbjdbccfg.xml"

      srv.execStartup="rdb$jdbc_home:rdbjdbc_startexec.com"

      srv.startup="rdb$jdbc_home:rdbjdbc_startsrv.com"

      sharedmem = "0"

    />

    <!—DEFAULT Secure socket server -->

    <server

      name="DEFAULTSSL"

      type="RdbThinSrvSSL"

      ssl.default="false"

      ssl.context="TLS"

      ssl.keyManagerFactory="SunX509"

      ssl.keyStoreType="jks"

      ssl.keyStore="rdbjdbcsrv.kst"

      ssl.keyStorePassword="CHANGETHIS"

      ssl.trustStore="rdbjdbcsrv.kst"

      ssl.trustStorePassword="CHANGETHIS"

    />

    <!—now specific servers that will be started up by pool server -->

    <server

      name="srv1forRdb"

      type="RdbThinSrv"

      url="//localhost:1701/"

      autoStart="true"

      autoRestart="true"

      logfile="rdb$jdbc_logs:srv1forRdb.log"

      tracelevel="-1"

      maxClients=1

    />

    <server

      name="srv2forRdb"

      type="RdbThinSrv"

      url="//localhost:1708/"

      autoStart="true"

      logfile="rdb$jdbc_logs:srv2forRdb.log"

    />

    <!—MP server -->  

    <!—sharedmem is in KB default = 1024 -->

    <server

      name="srvMPforRdb"

      type="RdbThinSrvMP"

      url="//localhost:1705/"

      autoStart="true"

      maxClients="10"

      maxFreeExecutors="10"

      prestartedExecutors="10"

      sharedMem="10240"

    />

    <!—the pool server -->

    <server

      name="rdbpool"

      type="RdbThinSrvPool"

      url="//localhost:1702/" >

      <pooledServer name="srv1forRdb"/>

      <pooledServer name="srv2forRdb"/>

      <pooledServer name="srvMPforRdb"/>

    </server>

    <!—Secure socket server -->

    <server

      name="srvssl1forRdb"

      type="RdbThinSrvSSL"

      url="//localhost:1709/"

    />

  </servers>

<!—database -->

  <databases>

   <database

      name="mf_pers"

      url="//localhost:1701/mydisk:[databases]mf_personnel"

      driver="oracle.rdb.jdbc.rdbThin.Driver"

      URLPrefix="jdbc:rdbThin:"

   />

   <database

      name="pers"

      url="//localhost:1702/mydisk:[databases]personnel"

      driver="oracle.rdb.jdbc.rdbThin.Driver"

      URLPrefix="jdbc:rdbThin:"

   />

 </databases>

</config>

次は、XML書式の構成ファイルの様々なセクションについて説明します。

4.3.2.1   configセクション

このセクションでは、構成設定の全体をカバーし、次のような各構成セクションを規定します。

書式

<config>

       [ session section ]

       [ databases section ]

       [ servers section ]   

</config>

4.3.2.2   sessionセクション

このセクションでは、対話型セッションのセッション特性を規定します。sessionセクション内の情報を使用するのは現在、Oracle JDBC for Rdbコントローラだけです。コントローラ・セッションの起動時に使用される可能性があるパスワードやユーザー名のような情報を指定できます。コントローラが現在認識できるのは、DEFAULTという名前のセッション1つだけです。

後述のセッション・プロパティを使用すると、コントローラの起動時にコマンドライン・オプション以外のオプションを別の方法で指定できます。

書式

<session

       [ session properties ]

/>

オプション

sessionセクションで有効なプロパティを、表4-3「sessionセクションのプロパティ」に示します。

表4-3      sessionセクションのプロパティ

例

<session

      name="DEFAULT"

      controlPass="jdbc_control"

      user="jdcb_user"

      password="jdbc_control"

      tracelevel="0"

      srv.mcBasePort="5517"

      srv.mcGroupIP="239.192.1.1"

/>

注意:

1.      セッション・プロパティsrv.mcBasePortおよびsrv.mcGroupIPでは、サーバーに対するポーリングで使用されるマルチキャスト属性を指定します。指定したマルチキャスト・グループに参加しているそのようなサーバーだけが、コントローラによって発行されるポーリング・リクエストに応答します。

2.      前述の例のようにユーザーおよび制御パスワードは構成ファイルのsessionセクションにプレーン・テキストの書式で格納できますが、そのような方法は組織のセキュリティ・ポリシーに反している場合もあります。プレーン・テキストのパスワードを構成ファイルに格納するのではなく、適切なコマンドライン・スイッチを使用して適切なパスワードを指定してください。サーバーに関連付けられている制御パスワードを、不明瞭化された形態により構成ファイルのserverセクションで指定することもできます。

4.3.2.3   databasesセクション

 このセクションでは、databaseセクションを1つ以上指定します。

書式

            <databases>

           [ database section ]

            </databases>

4.3.2.4   databaseセクション

このセクションでは、データベースの名前と一連のプロパティを指定します。

書式

<database>

       [ database property  ]

/>

 オプション

databaseセクションで有効なプロパティを、表4–4「databaseセクションのプロパティ」に示します。

表4-4     databaseセクションのプロパティ

例

<!—database -->

  <databases>

    <database

      name="mf_pers"

      url="//localhost:1701/mydisk:[databases]mf_personnel"

      driver="oracle.rdb.jdbc.rdbThin.Driver"

      URLPrefix="jdbc:rdbThin:"

   />

   <database

      name="pers"

      url="//localhost:1702/mydisk:[databases]personnel"

      driver="oracle.rdb.jdbc.rdbThin.Driver"

      URLPrefix="jdbc:rdbThin:"

   />

</databases>

4.3.2.5   serversセクション

              このセクションでは、サーバー・プロパティ・セクションを1つ以上指定します。

書式

<servers>

    [ server section ]

</servers>

4.3.2.6    serverセクション

このセクションでは、該当するサーバーに割り当てるプロパティを1つ以上指定します。

設定対象のプロパティの詳細は、「サーバーの構成」を参照してください。

書式

<server

   <property="value"/>

/>

または

<server

   <property="value"/>

>

[ pooled server subsection ]…

[ allowed database subsection ]…

[ allowed user subsection ]…

</server>

例

ポート1799をリスニングするserv1という名前の標準Thinサーバーは、次のサーバー・プロパティ・セクションを使用して記述できます。

<server

      name="serv1"

      type="RdbThinSrv"

      url="//localhost:1799/"

      logfile="myLogs:serv1.log"

/>

注意:

サーバー構成におけるデフォルトのサーバー特性は、個々のサーバー構成セクション内でオプションを繰り返し指定することなく指定できます。デフォルトのサーバー・オプションは、DEFAULTまたはDEFAULTSSLという名前を持つserverセクションを宣言することにより指定できます。

<server

      name="DEFAULT"

      type="RdbThinSrv"

      url="//localhost:1701/"

      maxClients="-1"

      srv.bindTimeout="0"

      srv.idleTimeout="0"

      srv.mcBasePort="5517"

      srv.mcGroupIP="239.1.1.1"

      autoStart="false"

      controlUser="jdbc_user"

      controlPass="0x811B15F866179583EB3C96751585B843"

/>

DEFAULTおよびDEFAULTSSLというサーバーの定義は、デフォルトのサーバー特性を定義する場合にのみ使用し、コントローラまたはプール・サーバーによって起動できる実際のサーバー・インスタンスを表すためのものではありません。

これらのデフォルトのサーバー・プロパティは、特定のserverサブセクション内で明示的にオーバーライドされないかぎり、構成ファイル内でその後に定義されている各サーバーに割り当てられます。

DEFAULTおよびDEFAULTSSLというserverセクションは、構成ファイル内での位置が重要です。それらのサーバーは、これらのデフォルトの定義の後にあるセクション内で定義されている場合にのみ、それらのデフォルト特性を持ちます。デフォルトのserverセクションより前で指定されているserverセクションは、それらのデフォルト特性を持ちません。これら2つのセクションは、構成ファイル内先頭の2つのserverセクションとしてください。

pooledServerやallowDatabaseのようなサブセクションが必要な場合は、2番目の書式のserverセクションを使用する必要があります。

例

<server

      name="rdbpool"

      type="RdbThinSrvPool"

      url="//localhost:1702/" >

      <pooledServer name="srv1forRdb"/>

      <pooledServer name="srv2forRdb"/>

      <pooledServer name="srvMPforRdb"/>

</server>

4.3.2.7   pooledServerサブセクション

このサブセクションでは、親サーバーのサーバー・プールに入るサーバーを指定します。宣言するサーバー名では、該当する構成ファイル内ですでに指定されているサーバーを参照する必要があります。

pooledServerサブセクションは、単一のサーバー宣言内に複数存在することができます。

このサブセクションは、RdbThinSrvPoolサーバーの宣言内で使用する場合にのみ有効です。 

指定した一連のpooledServerは、親のプール・サーバーからアクセスされる可能性があるサーバー・プールを形成します。

書式

             <pooledServer name="declared server"/>

  例

<server

      name="rdbpool"

      type="RdbThinSrvPool"

      url="//localhost:1702/" >

      <pooledServer name="srv1forRdb"/>

      <pooledServer name="srv2forRdb"/>

      <pooledServer name="srvMPforRdb"/>

</server>

4.3.2.8   allowDatabaseサブセクション

このサブセクションでは、サーバーを使用するクライアントからアクセスされる可能性があるデータベースを指定します。宣言するデータベース名は、この構成ファイルのdatabaseセクションで指定済のデータベースを参照するか、有効なデータベース・ファイル指定または論理名である必要があります。

このサブセクションは、サーバーの宣言内で使用する場合にのみ有効です。

allowDatabaseサブセクションは、単一のサーバー宣言内に複数存在することができます。

データベース・アクセスを制限するには、サーバー属性restrictAccessを"true"に設定する必要があります。

詳細は、「データベース・アクセスの制限」を参照してください。

書式

              <allowDatabase name="db specification" />

 例

<server

      name="srv2restrict"

      type="RdbThinSrv"

      url="//localhost:1701/"

      restrictAccess="true">

      <allowDatabase name="mf_pers"/>

      <allowDatabase name="disk1:[databases]customers"/>

</server>

4.3.2.9   allowUserサブセクション

このサブセクションでは、サーバーによってアクセスが許可されるユーザー名を指定します。宣言するユーザー名は、Rdbによって認識される有効なユーザー名である必要があります。このレベルの制限に対するサーバーでのユーザー名のマッチングでは、大/小文字が区別されません。

このサブセクションは、サーバーの宣言内で使用する場合にのみ有効です。

allowUserサブセクションは、単一のサーバー宣言内に複数存在することができます。

ユーザー・アクセスを制限するには、サーバー属性restrictAccessを"true"に設定する必要があります。

詳細は、「ユーザー・アクセスの制限」を参照してください。

書式

              <allowUser name="username" />

 例

<server

      name="srv2restrict"

      type="RdbThinSrv"

      url="//localhost:1701/"

      restrictAccess="true">

      <allowUser name="smith"/>

      <allowUser name="jones"/>

</server>

4.3.2.10                構成ファイル内でのファイル名の指定

構成ファイルのセクション内では、一連の属性で次のようなファイル名を指定する必要があります。

§   cfg="<filename>"

§   log="<filename>"

§   srv.execStartup="<filename>"

§   srv.startup="<filename>"

ファイル名は、ファイル・パスが全部または一部含まれる可能性がある有効なOpenVMSファイルでなければならず、論理名を含むことができます。

論理名を使用する場合、サーバーが起動されるコンテキストで利用できる必要があり、ファイルはサーバーを起動するVMSユーザーからアクセスできる必要があります。

構成内で定義されているサーバーが、コントローラを使用して起動されるか、プール・サーバーによってプーリングされているサーバーとして起動されるか、またはOracle SQL/Servicesによって起動されると、該当するサーバーのためにデタッチされたプロセスが作成され、JavaおよびOracle Rdbにアクセスできる有効なプロセス環境がLOGINOUT.EXEの実行によって保証されます。

LOGINOUT.EXEプログラムが実行されるため、相対ファイル・パスを使用するファイル指定はすべて、起動者のログイン・ディレクトリに対して相対的である必要があります。そうでない場合は、完全ファイル指定を使用する必要があります。

目次

第5章  
SSLの使用

Secure Sockets Layer（SSL）は、機密保護、メッセージの整合性、認証などのセキュリティをWebトラフィックに提供するために開発されました。SSLでは、暗号化、デジタル署名および証明書の使用により、その目的を達成しています。

Oracle JDBC for RdbのサーバーおよびThinクライアントでは、SSLを使用し、TCP/IP上で通信を実行できます。SSLの場合、SSL対応のサーバーはSSL対応のクライアントに対して自分自身の認証を実行し、SSL対応のクライアントはSSL対応のサーバーに対して自分自身の認証を実行できます。そして、両方のマシンで、暗号化された接続を確立できます。

SSLとThinドライバを併用する前に、JavaのセキュリティとSSLに関する一般的な概念に精通しておく必要があります。SSLとJavaのセキュリティに関する一般的な情報については、Javaのドキュメントを参照してください。

次の項では、SSLとThinドライバを併用する場合のSSLに関する情報を示しますが、JavaのセキュリティとSSLに関する基本的な理解が前提になります。

5.1         SSLの構成

SSLの接続特性に関する情報を、クライアントにもサーバーにも渡す必要があります。また、通信チャネルを確立するには、SSLのセキュリティ特性に関してサーバーもクライアントも同意する必要があります。

さらに、クライアントもサーバーも、認可用の同じセキュリティ証明書を持つことが重要です。後述の項では、クライアントの接続リクエストでSSL特性をSSL対応のOracle JDBC for Rdbサーバーに渡す方法の詳細を示します。

5.1.1               クライアントSSLの構成

クライアント・アプリケーションでは、Thinドライバに対する接続リクエスト時に、そのSSL特性を指定する必要があります。その最も簡単な方法は、DriverManager.getConnection()メソッドに渡されるプロパティ・ブロックに入れて余分なSSL情報を提供するという方法です。

そのSSL情報では、SSL接続に適した証明書の検索先や、接続設定時にSSLハンドシェークの実行に使用するコンテキストおよびプロトコルなどを示します。

例

Properties info = new Properties();

info.put("user", user);

info.put("password", password);

info.put("tracelevel", traceLevel);

info.put("ssl", "true");

info.put("ssl.default", "false");

info.put("ssl.context", "TLS");

info.put("ssl.keyManagerFactory", "SunX509");

info.put("ssl.keyStoreType", "jks");

info.put("ssl.keyStore", "rdbjdbccli.kst");

info.put("ssl.keyStorePassword", "CHANGETHIS");

info.put("ssl.trustStore", "rdbjdbccli.kst");

info.put("ssl.trustStorePassword", "CHANGETHIS");

Connection conn = DriverManager.getConnection(

  "jdbc:rdbThin://bravo:1755/my_db_dir:pers", info);

SSL接続を試行するには、プロパティ・ブロックでプロパティsslにtrueを設定する必要があります。

また、SSL特性をプロパティとして明示的に指定したり、ssl.defaultにtrueを設定してシステムのデフォルトのSSL特性を使用するよう要求したりすることもできます。

Properties info = new Properties();

info.put("user", user);

info.put("password", password);

info.put("tracelevel", traceLevel);

info.put("ssl", "true");

info.put("ssl.default", "true");

Connection conn = DriverManager.getConnection(

  "jdbc:rdbThin://bravo:1755/my_db_dir:pers", info);

ssl.*オプションの詳細は、「SSL構成オプション」を参照してください。

注意:

SSL接続を確立するには、アタッチ先のサーバーに適した証明書が、接続に対するSSLプロパティ内で指定されているキーストアの中にある必要があります。

証明書が見つからないと、次の例外が通知されます。

javax.net.ssl.SSLException: No available certificate corresponds to

 the SSL cipher suites, which are enabled.

             証明書の詳細は、Javaセキュリティのドキュメントを参照してください。

5.1.2   サーバーSSLの構成

SSL構成情報とともに、SSL対応のサーバーも指定する必要があります。これは通常、XMLベースの構成ファイル内で指定したサーバーのserverセクション内で指定します。

サーバーがSSL対応であることを示すには、サーバーを次のいずれか1つのSSLサーバー・タイプとして定義する必要があります。

RdbThinSrvSSL

RdbThinSrvMPSSL

RdbThinSrvPoolSSL

例

<server

      name="MYSSL"

      type="RdbThinSrvSSL"

      ssl.default="false"

      ssl.context="TLS"

      ssl.keyManagerFactory="SunX509"

      ssl.keyStoreType="jks"

      ssl.keyStore="rdbjdbcsrv.kst"

      ssl.keyStorePassword="CHANGETHIS"

      ssl.trustStore="rdbjdbcsrv.kst"

      ssl.trustStorePassword="CHANGETHIS"

/>

SSL特性が同じ一連のSSL対応サーバーを定義するには、特別なDEFAULTSSLサーバーの定義を使用してデフォルトの特性を定義します。いずれか1つのSSLサーバー・タイプを持つ後続の各サーバー定義では、サーバー定義で明示的にオーバーライドされないかぎり、それらのデフォルトの定義を持ちます。

<server

      name="DEFAULTSSL"

      type="RdbThinSrvSSL"

      ssl.default="false"

      ssl.context="TLS"

      ssl.keyManagerFactory="SunX509"

      ssl.keyStoreType="jks"

      ssl.keyStore="rdbjdbcsrv.kst"

      ssl.keyStorePassword="CHANGETHIS"

      ssl.trustStore="rdbjdbcsrv.kst"

      ssl.trustStorePassword="CHANGETHIS"

 />

<server

      name="SSLsrv1"

      type="RdbThinSrvSSL"

      url="//localhost:1707/"

/>

<server

      name="SSLsrv2"

      type="RdbThinSrvMPSSL"

      url="//localhost:1708/"

      sharedMem="10000"

/>

これらのオプションの詳細は、「SSL構成オプション」を参照してください。

注意:

プール・サーバーは、SSL対応である場合、セキュリティ上の理由から、そのプール内のプーリングされているサーバー（これもSSL対応）とのみ通信します。該当するプール内のプーリングされているサーバーで、SSL対応でないものは、無視され、接続リクエストのリダイレクトの候補とみなされます。

5.2         SSLとコントローラ

SSL対応のサーバーに対する接続はすべて、SSL接続を使用して確立する必要があります。これにはコントローラも含まれます。

コントローラを使用してSSL対応のサーバーを管理する場合は、サーバーに対してセキュアな接続を確立できるよう、コントローラ・セッションでも正確なSSL情報を持つ必要があります。

SSL対応のThinサーバーに接続する際にコントローラによって使用されるSSL情報は、適切なSSL情報がsessionセクションで指定されているXML書式の構成ファイルを使用してコントローラを起動すれば、指定できます。

例

<session

      name="DEFAULT"

      controlPass="jdbc_user"

      user="cts1"

      password="jdbc_user"

      tracelevel="0"

      srv.mcBasePort="5518"

      srv.mcGroupIP="239.192.1.2"

      ssl.default="false"

      ssl.context="TLS"

      ssl.keyManagerFactory="SunX509"

      ssl.keyStoreType="jks"

      ssl.keyStore="rdbjdbccli.kst"

      ssl.keyStorePassword="CHANGETHIS"

      ssl.trustStore="rdbjdbccli.kst"

      ssl.trustStorePassword="CHANGETHIS"

/>

これは、「クライアントSSLの構成」で示したのと同じSSL情報です。

この情報を与えると、コントローラは該当するSSL構成を使用して、SSL対応のサーバーとしてポーリング・リクエストに応答する任意のサーバーに接続します。

5.3         SSL構成オプション

設定が可能な様々なSSL構成オプションを、表5–1「SSL構成オプション」に示します。

表5-1      SSL構成オプション

5.4         自己署名付き証明書を使用したテスト

次のサンプル・コードを使用すると、SSLの通信で使用可能な証明書の作成やコピーが行えます。この場合、クライアントとサーバーは、Java環境が設定済のOpenVMSノード上にあります。

キーストアやパスワードなどの情報は、使用する環境に合せて変更してください。

$! The following should be done on the Server node

$ write sys$output "Generating the Server KeyStore in file rdbjdbcsrv.kst

$ keytool –genkey –alias rdbjdbc-sv

-dname "CN=Jim Murray, OU=Rdb Engineering, O=Oracle, c=US"

-keypass "CHANGETHIS" –storepass "CHANGETHIS" –KeyStore rdbjdbcsrv.kst

$!

$write sys$output "Exporting the certificate from keystore to external file server.cer

$ keytool –export –alias rdbjdbc-sv –storepass "CHANGETHIS" –

-file server.cer –keystore rdbjdbcsrv.kst

$!

$!----------------------------------------------------------------------

$!

$! The following should be done on the client node

$!

$write sys$output "Generating the Client KeyStore in file rdbjdbccli.kst

$ keytool –genkey –alias rdbjdbc-cl –

-dname "CN=Rdbjdbc Client, OU=X, O=Y, L=Z, S=XY, C=YZ"

-keyalg RSA –keypass "CHANGETHIS" –storepass "CHANGETHIS" –keystore rdbjdbccli.kst

$!

$write sys$output "Exporting the certificate from keystore to external file client.cer

$ keytool –export –alias rdbjdbc-cl –storepass "CHANGETHIS"

-file client.cer –keystore rdbjdbccli.kst

$!

$!----------------------------------------------------------------------

$!

$! Exchange the certificates by copying the client certificate file (client.cer) to

$! The server node, and the server certificate file (server.cer) to the client node

$!

$!----------------------------------------------------------------------

$!

$! Now on the server node

$write sys$output "Importing Client’s certificate into Server’s keystore

$ keytool –import –v –trustcacerts –alias rdbjdbc –file client.cer

-keystore rdbjdbcsrv.kst –keypass "CHANGETHIS" –storepass "CHANGETHIS"

yes

$!

$!----------------------------------------------------------------------

$!

$! Now on the client node

$write sys$output "Importing Server’s certificate into Client’s keystore

$ keytool –import –v –trustcacerts –alias rdbjdbc –file server.cer

-keystore rdbjdbccli.kst –keypass "CHANGETHIS" –storepass "CHANGETHIS"

yes

前述のkeytoolコマンドは、Javaがインストールされているほとんどのオペレーティング・システムで正常に機能するはずです。

パスワードなどの値は、サーバーまたはクライアントのSSL接続構成プロパティで指定するのと同じように、二重引用符で囲む点に注意してください。

キーストアの設定が終わり、前述の項で示したようにクライアントおよびサーバーのSSLプロパティを正しく設定したら、Thinドライバ内でSSLを使用し、クライアント/サーバーの通信が行えます。

目次

第6章  
Oracle JDBC for Rdbコントローラ

Oracle JDBC for Rdbコントローラ（以降、「コントローラ」と表記）を使用すると、Oracle JDBC for Rdbサーバーの基本的な管理が行えます。

rdbthincontrol.jarファイルに含まれるこのアプリケーションを使用すると、パスワードで保護されたローカルおよびリモートのサーバー管理操作を、Thinサーバーまたはプール・サーバー上で実行できます。それらの操作には、現在接続されているクライアントの表示、クライアント・スレッドの停止、Thinサーバーの起動と停止が含まれます。

 コントローラは、対話型モードまたはシングル・コマンド・モードで実行できます。対話型モードでは通常、管理対象のサーバーに接続し、管理リクエストを発行します。コントローラの使用が終わったら、exitコマンドを発行してイメージを終了することができます。

 シングル・コマンド・モードの場合は、コマンドライン・スイッチを使用して、実行する必要があるアクションをコントローラに指示します。アクションが完了すると、コントローラ・イメージが終了します。

コントローラは通常、システム上で実行できるOracle JDBC for Rdbサーバーに関する情報を提供するXML書式の構成ファイルとともに使用されます。また、その構成ファイルからは、ポーリング操作の実行時に使用されるブロードキャスト・ポート情報などのセッション情報が提供される場合もあります。構成ファイルの詳細は、「構成ファイル」を参照してください。

コントローラを使用すると、サーバーの起動および停止や、サーバーおよび接続先クライアントに関するその他の操作が行えます。また、コントローラを使用すると、ネットワーク全体で稼働しているOracle JDBC for Rdbサーバーの現行ステータスを表示することもできます。

コントローラを対話型モードで使用する場合のセッションの例を次に示します。

例

rdbthincontrol> show stored servers

Stored server info

RDB$NODE               : localhost

RDB$PORT               : 1702

RDB$STATUS             : not available

RDB$SERVER_NAME        : SRV2

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : not available

RDB$SERVER_SHR_VERSION : not available

RDB$SERVER_PID         : not available

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$NODE               : localhost

RDB$PORT               : 1701

RDB$STATUS             : not available

RDB$SERVER_NAME        : SRV1

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : not available

RDB$SERVER_SHR_VERSION : not available

RDB$SERVER_PID         : not available

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$NODE               : localhost

RDB$PORT               : 1701

RDB$STATUS             : not available

RDB$SERVER_NAME        : DEFAULT

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : not available

RDB$SERVER_SHR_VERSION : not available

RDB$SERVER_PID         : not available

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

rdbthincontrol> start server srv1

Starting server ...

.

RDB$NODE               : 138.1.14.91

RDB$PORT               : 1701

RDB$STATUS             : Idle

RDB$SERVER_NAME        : srv1

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : T7.2-510 20070109 B719

RDB$SERVER_SHR_VERSION : T7.2-510 20061221 B6CL

RDB$SERVER_PID         : 0x20238378(539198328)

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$TRACE_LEVEL        : 0

RDB$LOG_FILE           : rdbjdbclog

RDB$RESTRICT_ACCESS    : false

rdbthincontrol> poll

Polling servers ...

srv1(0) //138.1.14.91:1701/ (0x20238378<539198328>)

rdbthincontrol> start server srv2

Starting server ...

.

RDB$NODE               : 138.1.14.91

RDB$PORT               : 1702

RDB$STATUS             : Idle

RDB$SERVER_NAME        : srv2

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : T7.2-510 20070109 B719

RDB$SERVER_SHR_VERSION : T7.2-510 20061221 B6CL

RDB$SERVER_PID         : 0x2033137C(540218236)

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$TRACE_LEVEL        : 0

RDB$LOG_FILE           : rdbjdbclog

RDB$RESTRICT_ACCESS    : false

rdbthincontrol> poll

Polling servers ...

srv2(0) //138.1.14.91:1702/ (0x2033137C<540218236>)

srv1(0) //138.1.14.91:1701/ (0x20238378<539198328>)

rdbthincontrol> show active servers

Active server info

RDB$NODE               : 138.1.14.91

RDB$PORT               : 1702

RDB$STATUS             : Idle

RDB$SERVER_NAME        : srv2

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : T7.2-510 20070109 B719

RDB$SERVER_SHR_VERSION : T7.2-510 20061221 B6CL

RDB$SERVER_PID         : 0x2033137C(540218236)

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$TRACE_LEVEL        : 0

RDB$LOG_FILE           : rdbjdbclog

RDB$RESTRICT_ACCESS    : false

RDB$NODE               : 138.1.14.91

RDB$PORT               : 1701

RDB$STATUS             : Idle

RDB$SERVER_NAME        : srv1

RDB$SERVER_TYPE        : RdbThinSrv

RDB$SERVER_VERSION     : T7.2-510 20070109 B719

RDB$SERVER_SHR_VERSION : T7.2-510 20061221 B6CL

RDB$SERVER_PID         : 0x20238378(539198328)

RDB$ALLOWS_ANON        : false

RDB$ALLOWS_BYPASS      : false

RDB$NUMBER_OF_CLIENTS  : 0

RDB$MAX_CLIENTS        : -1

RDB$TRACE_LEVEL        : 0

RDB$LOG_FILE           : rdbjdbclog

RDB$RESTRICT_ACCESS    : false

rdbthincontrol> stop all servers

Successfully stopped Thin Server : srv1 (//138.1.14.91:1701/)

Successfully stopped Thin Server : srv2 (//138.1.14.91:1702/)

rdbthincontrol> poll

Polling servers ...

rdbthincontrol> exit

6.1         コントローラの実行

コントローラを使用すると、Oracle JDBC for Rdbサーバーの基本的な管理を実行できます。

コントローラは、OpenVMSのDCLコマンドラインから、シングル・コマンド・モードで実行するか、コマンドライン・インタフェースとして実行できます。

 書式

$java –jar rdb$jdbc_home:rdbthincontrol.jar [<option> | <command_keyword>]

有効なオプションについては、表6–1「コントローラのオプション」を参照してください。

有効なcommand_keywordについては、表6–2「コントローラのコマンド・キーワード」を参照してください。

注意:

サーバーが制御パスワードを所持していないと、コントローラでOracle JDBC for Rdbサーバーを管理することができません。

制御パスワードの指定の詳細は、「サーバーの構成オプション」を参照してください。

表6-1     コントローラのオプション

注意:

 これらの一連のオプションは、対話型コントローラ・セッションの起動に使用されるXML書式の構成ファイルのsessionセクションで指定することもできます。詳細は、「XML書式の構成ファイル」の「sessionセクション」を参照してください。

表6-2     コントローラのコマンド・キーワード

コントローラは、適切な接続情報とコマンド・キーワード（1つ）を指定して起動されると、該当するリクエストをサーバーに発行し（結果が表示される場合もある）、即座に終了します。

コマンド・キーワードが複数存在する場合は、前述の表で示した優先順位に従って、1つだけ発行されます。

例

コントローラに対するコマンド・キーワードの発行例:

$java -jar rdb$jdbc_home:rdbthincontrol.jar -u jan –

 -controlpass mpass -node nd1 -port 1701 –stopserver

6.1.2   コントローラのコマンドライン

コントローラの起動時にコマンド・キーワードを1つも指定しないと、アプリケーションは複数のコマンドを発行できるコマンドライン・プロンプト・モードになります。

コントローラの起動時に有効な接続情報（ノード、ポート、ユーザーおよびパスワード）を指定すると、コントローラは指定されたサーバーに自動的に接続しようとします。

接続が確立されていない場合または別のサーバー接続が必要な場合は、制御コマンドラインでconnectコマンドを発行できます。詳細は、「サーバーへの接続」を参照してください。

connectコマンドラインでユーザー名およびパスワードを指定しないと、コントローラ起動時の構成オプションの値が使用されます。構成ファイルを指定すると、構成ファイルのセッション特性が使用されます。セッション特性の詳細は、「XML書式の構成ファイル」の「sessionセクション」を参照してください。

コマンドは、制御コマンドラインで、サーバー接続のコンテキスト内または特定のサーバー接続のコンテキスト外で発行できます。  

サーバーに対する接続が確立された後で発行できるコマンドについては、「サーバー接続を必要とするコマンド」を参照してください。

サーバー接続を必要としないコマンドについては、「サーバー接続を必要としないコマンド」を参照してください。

書式

$java -jar rdb$jdbc_home:rdbthincontrol.jar –cfg my_servers.xml

6.1.2.1   サーバー接続を必要とするコマンド

有効なサーバー接続が確立された後は、表6–3「コントローラのコマンドライン・コマンド（接続内）」のコマンドを発行できます。

表6-3     コントローラのコマンドライン・コマンド（接続内）

例

$java -jar rdb$jdbc_home:rdbthincontrol.jar

rdbthincontrol> connect //localhost:1701/ jones mypassword

rdbthincontrol> show server

RDB$NODE : localhost

RDB$PORT : 1701

RDB$STATUS : Idle

RDB$SERVER_NAME : rdbthnsrv1

RDB$SERVER_TYPE : RdbThinSrv

RDB$SERVER_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_SHR_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_PID : 0x0B24(2852)

RDB$ALLOWS_ANON : false

RDB$ALLOWS_BYPASS : false

RDB$NUMBER_OF_CLIENTS : 0

RDB$MAX_CLIENTS : -1

rdbthincontrol>

rdbthincontrol> stop server

Successfully stopped Rdb Thin Server : //localhost:1701/

rdbthincontrol> exit

$

6.1.2.2     サーバー接続を必要としないコマンド

接続を確立しなくても発行できるコマンドは多数ありますが、pollおよびquit以外のコマンドではすべて、ユーザー名と制御パスワード（サーバーに接続して必要な情報を取得するために使用される）を指定する必要があります。それらのコマンドを、表6–4「コントローラのコマンドライン・コマンド（接続なし）」に示します。

表6-4     コントローラのコマンドライン・コマンド（接続なし）

例

$java -jar rdb$jdbc_home:rdbthincontrol.jar -user jones –

 -controlpass jdbc_user

rdbthincontrol> show active servers

RDB$NODE : localhost

RDB$PORT : 1701

RDB$STATUS : Idle

RDB$SERVER_NAME : rdbthnsrv1

RDB$SERVER_TYPE : RdbThinSrv

RDB$SERVER_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_SHR_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_PID : 0x0B30(2864)

RDB$ALLOWS_ANON : false

RDB$ALLOWS_BYPASS : false

RDB$NUMBER_OF_CLIENTS : 0

RDB$MAX_CLIENTS : -1

RDB$NODE : localhost

RDB$PORT : 1711

RDB$STATUS : Idle

RDB$SERVER_NAME : myserver

RDB$SERVER_TYPE : RdbThinSrv

RDB$SERVER_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_SHR_VERSION : V7.1-300 20040624 B46N

RDB$SERVER_PID : 0x0B88(2952)

RDB$ALLOWS_ANON : false

RDB$ALLOWS_BYPASS : false

RDB$NUMBER_OF_CLIENTS : 0

RDB$MAX_CLIENTS : -1

rdbthincontrol>

サーバーは、指定された制御パスワードを認識できないと、エラー・メッセージを返します。

rdbthincontrol> show active servers

Failed to connect <CONTROL>

No Rdb Thin Server connection has been established

Unable to connect to server //localhost:1701/

Failed to connect <CONTROL>

No Rdb Thin Server connection has been established

Unable to connect to server //localhost:1711/

rdbthincontrol>

目次

6.2         サーバーへの接続

コントローラから発行できるコマンドのほとんどでは、サーバーと有効な制御接続を確立する必要があります。コントローラの起動時に有効な接続情報（ノード、ポート、ユーザーおよびパスワード）を指定すると、コントローラは指定されたサーバーに自動的に接続しようとします。

コントローラの起動時にユーザーおよびパスワードを指定すると、その情報はコマンド文で明示的にオーバーライドされないかぎり、コントローラのセッション全体で維持され、後続の接続リクエストで使用されます。

コマンドは、制御接続が確立されている場合にのみサーバー上で実行されます。制御接続を確立するには、接続リクエスト時に正しい制御パスワードを指定する必要があります。このパスワードの詳細は、「制御パスワード」を参照してください。

この制御接続は、connectコマンドを使用し、該当するセッションで明示的に確立することができます。また、アクセス制御が正常に実行されることが必要なサーバーにコマンドが発行される場合は、暗黙的に実行することもできます。多くのコントローラ・コマンドでは、コマンドの適用先サーバーを示し、サーバー接続情報を指定できます。また、その接続情報では、該当するサーバーで使用されるユーザー名およびパスワードを指定することもできます。

書式

              <command> <server_connection>

<server_connection>情報は、サーバーID文字列と、オプションの接続ユーザー名および制御パスワードから構成されます。

書式

<server_ident> [<server_uid>]

<server_ident>文字列は、次のいずれか1つとすることができます。

•         ポートID: //localhost:<port>/の発行と同じ

•         フルURL（書式は//<node>:<port>/）

•          サーバーの名前（コントローラを起動する場合に使用される構成と同じ）

<server_uid>は次のとおりです。

         <username> [<password>]

制御接続を正常に実行するには、<password>はサーバーの制御パスワードと一致する必要があります。

コマンドラインでユーザー名またはパスワードを指定しないと、現在のセッション情報が使用されます。

この接続は、一度確立されると、明示的なdisconnectが発行されるか、別のサーバーに対して新しい接続が確立されるか、またはコントローラが終了するまで、維持されます。

接続を確立しないでコントローラ・コマンドを発行しようとすると、エラー状態が通知されます。

例

rdbthincontrol> watch

No Rdb Thin Server connection has been established

connectコマンドラインでユーザー名およびパスワードを指定しないと、コントローラの起動時に設定される適切な構成オプションの値が使用されます。構成ファイルを指定すると、構成ファイルのセッション特性が使用されます。セッション特性の詳細は、「XML書式の構成ファイル」の「sessionセクション」を参照してください。

6.2.1   connectコマンド

接続が確立されていない場合、現在の接続が切断されている場合、または別のサーバー接続が必要な場合は、制御コマンドラインでconnectコマンドを発行できます。

書式

connect [server] <server_connection>

このコマンドを実行すると、<server_connection>情報によって指定したサーバーに接続されます。

例 

connectコマンドの使用例を次に示します。

rdbthincontrol> connect //localhost:1701/ jones mypassword

rdbthincontrol> connect server 1701

rdbthincontrol> connect myServer jim xxxxx

注意:

connectコマンドラインでユーザー名およびパスワードを指定しないと、コントローラの起動時に構成オプションに入力された値が使用されます。構成ファイルを指定すると、構成ファイルのセッション特性が使用されます。セッション特性の詳細は、「XML書式の構成ファイル」の「sessionセクション」を参照してください。

6.2.2               暗黙的な接続

いくつかの制御コマンドでは、ターゲット・サーバーとの制御接続の確立が必要です。ターゲット・サーバーが現在接続されていない場合は、明示的に指定した接続情報とセッション接続情報が使用され、制御接続の確立が試行される場合があります。

接続情報は、次のように、該当するコマンドとともにコマンドラインで指定することもできます。

例

rdbthincontrol> stop server //localhost:1701/ jones mypassword

暗黙的な接続は、いったん確立されると、別の暗黙的な接続または明示的な接続によってオーバーライドされるまで、現在のセッション接続として確立されます。

6.3         制御パスワード

アクティブなサーバーまたはクライアント上で操作を実行するには、制御パスワードを指定する必要があります。

 このパスワードは、該当するアクティブなサーバーの制御パスワードに一致する必要があります。そうしないと、例外が通知され、該当する操作に失敗します。

コントローラを起動する場合、パスワードはコマンドライン・オプションとして指定することもできますし、「XML書式の構成ファイル」のsessionセクション内で指定することもできます。パスワードとcontrolPassを両方とも指定すると、controlPassが優先されます。

例

rdbthincontrol> stop server myMPServer

Failed to connect <CONTROL>

No Rdb Thin Server connection has been established

Unable to connect to server //localhost:1788/

また、制御パスワードは、コントローラのコマンドライン・プロンプトでset session controlpass文を使用し、セッションで設定することもできます。

rdbthincontrol> set session controlpass badpassword

rdbthincontrol> show server 1701

Failed to connect <CONTROL>

No Rdb Thin Server connection has been established

rdbthincontrol> set session controlpass mypassword

rdbthincontrol> show server 1701

RDB$NODE : 192.168.1.100

RDB$PORT : 1701

RDB$STATUS : Idle

RDB$SERVER_NAME : jiserv

RDB$SERVER_TYPE : RdbThinSrv

RDB$SERVER_VERSION : X7.1-301 20040713 B47C

RDB$SERVER_SHR_VERSION : X7.1-301 20040712 B47C

RDB$SERVER_PID : 0x1728(5928)

RDB$ALLOWS_ANON : false

RDB$ALLOWS_BYPASS : false

RDB$NUMBER_OF_CLIENTS : 0

RDB$MAX_CLIENTS : -1

目次

6.4         サーバーの操作

               ここでは、コントローラを使用し、サーバー上で対話型またはコマンド・モードで実行できる操作の詳細を示します。

注意:

この項で示す例では、Javaが設定済であり、次のDCL記号が環境内で設定済であることを前提としています。

$ thincontrol :== 'java'  -jar rdb$jdbc_home:rdbthincontrol.jar –

  –cfg my_servers.xml –controlpass "MySecretPassword"

それらの例で使用される構成ファイルの内容については、「構成ファイルの例（MY_SERVERS.XML）」を参照してください。

6.4.1               サーバーのクローズ

アクティブなサーバーは、コントローラを使用してクローズできます。その場合は、該当するサーバーの有効な制御パスワードを指定する必要があります。

サーバーをクローズすると、そのmaxClients属性がゼロ（0）に設定されるため、接続をそれ以上確立することができなくなります。すでに確立されている接続は、影響を受けません。クローズされているサーバーは、後でopenコマンドを発行し、再度オープンすることができます。その場合は、該当するサーバーのmaxClientsの値が再確立され、クローズする前の値に戻されます。詳細は、「サーバーのオープン」を参照してください。

制御パスワードが制御セッションの制御パスワードに一致するサーバーだけがクローズされます。

6.4.1.1   対話型モード 

サーバーをクローズする際に利用できる対話型の制御コマンドを、表6–5「サーバーのクローズ（対話型モード）」に示します。

表6-5      サーバーのクローズ（対話型モード）

例

rdbthincontrol> close server myserver

rdbthincontrol> close server //prod_node:1766/

rdbthincontrol> close server 1701

rdbthincontrol> close active servers

rdbthincontrol> close server myserver george MySecretPassword

6.4.1.2   コマンド・モード

サーバーをクローズする際に利用できるコマンド・モードのコマンドを、表6–6「サーバーのクローズ（コマンド・モード）」に示します。

表6-6     サーバーのクローズ（コマンド・モード）

例

$ thincontrol –closeServer –url //prod_node:1766/

$ thincontrol –closeServer–port 1701 –node localhost

$ thincontrol –closeServer –active

$ thincontrol –closeServer –name myserver

6.4.2   サーバーのオープン

アクティブなサーバーは、コントローラを使用してオープンできます。その場合は、該当するサーバーの有効な制御パスワードを指定する必要があります。

サーバーをオープンすると、該当するサーバーを使用して、新しいクライアント接続を確立できます。

クローズされているサーバーは、openコマンドを発行し、再度オープンすることができます。その場合は、該当するサーバーのmaxClientsの値が再確立され、クローズする前の値に戻されます。

制御パスワードが制御セッションの制御パスワードに一致するサーバーだけがオープンされます。

6.4.2.1   対話型モード 

サーバーをオープンする際に利用できる制御コマンドを、表6–7「サーバーのオープン（対話型モード）」に示します。

表6-7      サーバーのオープン（対話型モード）

例

rdbthincontrol> openserver

rdbthincontrol> open server myserv

rdbthincontrol> openserver //prod_node:1766/

rdbthincontrol> open server 1701

rdbthincontrol> openall servers

rdbthincontrol> open server //prod_node:1766/ fred mypass

6.4.2.2   コマンド・モード

サーバーをオープンする際に利用できるコマンド・モードのコマンドを、表6–8「サーバーのオープン（コマンド・モード）」に示します。

表6-8     サーバーのオープン（コマンド・モード）

例

$ thincontrol –openServer –url //prod_node:1766/

$ thincontrol –openServer–port 1701 –node localhost

$ thincontrol –openServer –active

$ thincontrol –openServer –name myserver

6.4.3   サーバーの表示

アクティブなサーバーおよび認識されているサーバーの情報は、コントローラを使用して表示できます。ただし、情報を表示するには、該当するサーバーの有効な制御パスワードを指定する必要があります。

すべてのサーバーまたはアクティブなサーバーを表示する場合は、制御パスワードが制御セッションの制御パスワードに一致するサーバーの情報だけが表示されます。

構成ファイルに格納されているサーバーまたは全サーバーを表示する場合は、構成ファイルに格納されているものとして全サーバーの定義が制御パスワードとは無関係に表示されます。

6.4.3.1   対話型モード 

サーバーを表示する際に利用できる制御コマンドを、表6–9「サーバーの表示（対話型モード）」に示します。

表6-9      サーバーの表示（対話型モード）

例

rdbthincontrol> show server

rdbthincontrol> show server myserv

rdbthincontrol> show server //prod_node:1766/

rdbthincontrol> show server 1701

rdbthincontrol> show active servers

rdbthincontrol> show server //prod_node:1766/ fred mypass

6.4.3.2    コマンド・モード

サーバーを表示する際に利用できるコマンド・モードのコマンドを、表6–10「サーバーの表示（コマンド・モード）」に示します。

表6-10  サーバーの表示（コマンド・モード）

注意:

競合する複数のキーワードが同一のコマンドライン上で検出されると、次の優先順位に従ってアクションが1つだけ実行されます。

•         -all

•         -active

•         -stored

•         指定されたサーバー

例

$ thincontrol –showServer –url //prod_node:1766/

$ thincontrol –showServer–port 1701 –node localhost

$ thincontrol –showServer –active

$ thincontrol –showServer –all

$ thincontrol –showServer –stored

$ thincontrol –showServer –name myserver

6.4.4   サーバーの起動

サーバーは、コントローラを使用して起動することができます。

コントローラが実行されているノードとは異なるノードまたはURLをサーバーで指定すると、例外が通知されます。

注意:

サーバーは現在、コントローラが実行されているのと同じノードが該当サーバーの構成で指定されている場合にのみ、起動できます。

リモート・サーバーの起動は現在、利用できません。

6.4.4.1   対話型モード 

サーバーを起動する際に利用できる制御コマンドを、表6–11「サーバーの起動（対話型モード）」に示します。

表6-11  サーバーの起動（対話型モード）

例

rdbthincontrol> start server myserver

rdbthincontrol> start server 1799

rdbthincontrol> start server all

6.4.4.2    コマンド・モード

サーバーを起動する際に利用できるコマンド・モードのコマンドを、表6–12「サーバーの起動（コマンド・モード）」に示します。

表6-12  サーバーの起動（コマンド・モード）

例

$ thincontrol –startServer–port 1701 –node localhost

$ thincontrol –startServer –name myserver

$ thincontrol –startServer –all

6.4.5   サーバーの停止

アクティブなサーバーは、コントローラを使用して停止できます。その場合は、該当するサーバーの有効な制御パスワードを指定する必要があります。

制御パスワードが制御セッションの制御パスワードに一致するサーバーだけが停止されます。

注意:

サーバーを停止すると、該当するサーバー上のすべてのデータベース接続が強制的に終了され、クライアント・トランザクションの完了は待ちません。まずclose serverコマンドを使用してクライアント接続がさらに確立されるのを停止し、次にバインドされているクライアントが1つも存在しないときにstop serverコマンドを使用します。詳細は、「サーバーのクローズ」を参照してください。

サーバーを現在使用しているクライアントがあるかどうか確認するには、show serverまたはshow clientsコマンドを使用できます。詳細は、「サーバーの表示」を参照してください。

6.4.5.1   対話型モード 

サーバーを停止する際に利用できる制御コマンドを、表6–13「サーバーの停止（対話型モード）」に示します。

表6-13  サーバーの停止（対話型モード）

例

rdbthincontrol> stop server

rdbthincontrol> stop server myserv

rdbthincontrol> stop server //prod_node:1766/

rdbthincontrol> stop server 1701

rdbthincontrol> stop active servers

rdbthincontrol> stop server //prod_node:1766/ fred mypass

6.4.5.2   コマンド・モード

 サーバーを停止する際に利用できるコマンド・モードのコマンドを、表6–14「サーバーの停止（コマンド・モード）」に示します。

表6-14  サーバーの停止（コマンド・モード）

例

$ thincontrol –stopServer –url //prod_node:1766/

$ thincontrol –stopServer–port 1701 –node localhost

$ thincontrol –stopServer –active

$ thincontrol –stopServer –name myserver

6.4.6         サーバーの監視

アクティブなサーバーのトレース出力を、コントローラのコンソールに表示できます。ただし、サーバーの有効な制御パスワードを指定しないと、そのトレースを監視することはできません。制御パスワードが制御セッションの制御パスワードに一致するサーバーだけが監視されます。

サーバーを監視する場合、該当するサーバーのトレース出力はすべて、コントローラを実行している現在のコンソールにも送られます。

トレース出力のメッセージ表示は、コマンドライン・インタフェースと非同期に実行されます。同じトレース情報は、サーバーのログ・ファイルにも送られます。

 
監視は、対話型モードでのみ利用できます。

注意:

サーバーはJavaログ出力を使用してトレース・メッセージをコントローラのようなリモート・コンソールにロギングするため、サーバーからの出力はバッファリングされてから、ネットワーク経由でコンソールに送信されます。つまり、バッファが満杯になった後消去されるので、トレース出力は散発的にコンソールに表示される可能性があります。

6.4.6.1   対話型モード 

サーバーを監視する際に利用できる制御コマンドを、表6–15「サーバーの監視（対話型モード）」に示します。

表6-15  サーバーの監視（対話型モード）

例

rdbthincontrol> watch server myserv

rdbthincontrol> watch server //prod_node:1766/

rdbthincontrol> watch server 1701 jack password1

rdbthincontrol> watch

6.4.7   サーバーのポーリング

pollコマンドでは、マルチキャスト情報を使用して、応答のあったOracle JDBC for Rdbサーバーをポーリングします。

利用可能な各サーバーは、各自がリスニングするノードおよびポートに関する情報を使って応答します。また、ポーリング応答により、該当するノード上でサーバーが使用しているプロセスIDもわかります。

制御パスワードがなくても、pollコマンドは使用できます。

6.4.7.1   対話型モード 

サーバーをポーリングする際に利用できる制御コマンドを、表6–16「サーバーのポーリング（対話型モード）」に示します。

表6-16  サーバーのポーリング（対話型モード）

例

rdbthincontrol> poll

Polling servers ...

myserver(0) //localhost:1711/ (0x0B88<2952>)

rdbthnsrv1(0) //localhost:1701/ (0x0B30<2864>)

rdbthincontrol>

6.4.7.2   コマンド・モード

サーバーをポーリングする際に利用できるコマンド・モードのコマンドを、表6–17「サーバーのポーリング（コマンド・モード）」に示します。

表6-17  サーバーのポーリング（コマンド・モード）

例

$ thincontrol –poll

6.4.7.3   マルチキャスト・ポーリング

コントローラは、マルチキャスト・ポーリングを使用して、ネットワーク上で利用可能なOracle JDBC for Rdbサーバーを検出します。

マルチキャストは、ネットワーク接続を介して多数の接続先サーバーにデータを効率よくブロードキャストする1つのスタイルです。マルチキャストIPアドレスをリスニングするサーバーはすべて、ポーリング・リクエストのようなブロードキャストされるデータ・パケットを受信します。

Oracle JDBC for Rdbサーバーで使用するアドレスの管理有効範囲では、マルチキャスト転送をネットワーク内の明確な境界に、簡単に制限できます。

管理有効範囲は、マルチキャスト・グループのアドレス範囲に基づくマルチキャスト・トランスポートの制限です。それは、RFC 2365 「Administratively Scoped IP Multicast」によって定義され、次のアドレス範囲に制限されます。

         239.0.0.0〜239.255.255.255

サーバー・マルチキャスト・ポーリングのIPアドレスは、次の範囲から選択できます。

         239.192.0.0〜239.192.255.255

この範囲はIPv4 Organization Local Scopeとして知られており、そのサブネット・マスクは255.252.0.0です。これは、独自の内部用または組織用にマルチキャスト・スコープをプライベートに設定する組織全体で使用するためのものであり、グループ・アドレスは262,144個まで許可されています。

Rdbサーバーではデフォルト時、マルチキャストIP 239.192.1.1（ベース・ポートは5517）を使用します。

マルチキャスト・グループのIPアドレスは、srv.mcGroupIPオプションをサーバー構成ファイル内またはサーバー起動時のコマンドライン内で使用すると、サーバーに割り当てることができます。

srv.mcBasePortオプションを使用すると、マルチキャスト・ベース・ポートを変更できます。

注意:

サーバーがマルチキャスト・グループに入っていると、該当グループ内でのその存在は標準のマルチキャスト・プロトコルの一部として、定期的にブロードキャストされます。これは、ユーザーのネットワーク管理のネットワーク・ポリシーおよび手順と矛盾する場合があります。

マルチキャスト・ポーリングがシステム上で許可されていることを、ネットワーク管理者に確認してください。Rdbネイティブ・ドライバが使用できる特殊なIPアドレスおよびポート範囲をネットワーク管理者が割り当てる場合もあります。そのような場合は、割り当てられたそれらのアドレスが反映されるように、サーバーおよびセッションの構成ファイルを変更する必要があります。

マルチキャスト・ベース・ポートをゼロ（0）に設定すると、マルチキャスト/ブロードキャストと、該当サーバーにおけるその受取りを無効にすることができます。これは、コントローラによって発行されたポーリング・リクエストに該当サーバーが応答しないことも意味しています。

目次

6.5         クライアントの操作

6.5.1         クライアントの表示

アクティブなサーバー内のクライアントに関する情報は、コントローラを使用して表示できます。その場合は、該当するサーバーの有効な制御パスワードを指定する必要があります。

クライアントが表示されるのは、制御パスワードが制御セッションの制御パスワードに一致するサーバーの場合のみです。

6.5.1.1    対話型モード 

クライアントを表示する際に利用できる制御コマンドを、表6–18「クライアントの表示（対話型モード）」に示します。

表6-18   クライアントの表示（対話型モード）