6.2.2. コアモジュールとしての JDBC ドライバーのインストール

手順6.4 管理 CLI を使用してコアモジュールとしての JDBC ドライバーのインストール

1. サーバーを起動します。
2. 管理 CLI を起動しますが、稼働中のインスタンスへの接続に --connect 引数または -c 引数を使用しないでください。
3. module add CLI コマンドを使用して、新しいモジュールを追加します。

   例6.1 MySQL JDBC ドライバーモジュールを追加する CLI コマンドの例

   module add --name=com.mysql --resources=/path/to/mysql.jar --dependencies=javax.api,javax.transaction.api

   Copy to Clipboard
   注記
   module 管理 CLI コマンドを使用してモジュールの追加および削除は テクノロジープレビュー としてのみ提供されるため、リモート JBoss EAP インスタンスにモジュールを追加しないでください。本番環境では、モジュールを手作業で追加および削除する必要があります。

   以下の手順に従って、モジュールを手動で追加します。

   1. ファイルパス構造は EAP_HOME/modules/ ディレクトリーの下に作成されます。たとえば、MySQL JDBC ドライバーの場合は、EAP_HOME/modules/com/mysql/main/ のようになります。
   2. リソースとして指定された JAR ファイルは main/ サブディレクトリーにコピーされます。
   3. 指定の依存関係を持つ module.xml ファイルが main/ サブディレクトリーに作成されます。module.xml ファイルの例は、「モジュール」 を参照してください。

   このコマンドを使用してモジュールを追加および削除する方法は、module --help を実行します。
4. CLI コマンド connect を使用して、実行中のインスタンスに接続します。
5. CLI コマンドを実行して JDBC ドライバーモジュールをサーバー設定に追加します。
   選択するコマンドは、JDBC ドライバー JAR にある /META-INF/services/java.sql.Driver ファイルにリストされているクラスの数によって異なります。たとえば、MySQL 5.1.20 JDBC JAR の /META-INF/services/java.sql.Driver ファイルには、2 つのクラスが一覧表示されます。

   • com.mysql.jdbc.Driver
   • com.mysql.fabric.jdbc.FabricMySQLDriver

   複数のエントリーがある場合は、ドライバークラスの名前も指定する必要があります。これを実行しないと、以下のようなエラーが発生します。

   例6.2 ドライバークラスエラー

   JBAS014749: Operation handler failed: Service jboss.jdbc-driver.mysql is already registered

   Copy to Clipboard
   • 1 つのクラスエントリーを含む JDBC JAR に対して CLI コマンドを実行します。

     /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME)

     Copy to Clipboard

     例6.3 1 つのドライバークラスを持つ JDBC JAR に対するスタンドアロンモードの CLI コマンド

     /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

     Copy to Clipboard

     例6.4 1 つのドライバークラスを持つ JDBC JAR に対するドメインモードの CLI コマンド

     /profile=ha/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

     Copy to Clipboard
   • 複数のクラスエントリーを含む JDBC JAR に対して CLI コマンドを実行します。

     /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME, driver-class-name=DRIVER_CLASS_NAME)

     Copy to Clipboard

     例6.5 複数のドライバークラスエントリーを持つ JDBC JAR に対するスタンドアロンモードの CLI コマンド

     /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)

     Copy to Clipboard

     例6.6 複数のドライバークラスエントリーを持つ JDBC JAR に対するドメインモードの CLI コマンド

     /profile=ha/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)

     Copy to Clipboard

     例6.7 複数の非 XA ドライバークラスエントリーを持つ JDBC JAR に対するドメインモードの CLI コマンド

     /profile=ha/subsystem=datasources/jdbc-driver=oracle/:add(driver-module-name=com.oracle,driver-name=oracle,jdbc-compliant=true,driver-datasource-class-name=oracle.jdbc.OracleDriver)

     Copy to Clipboard