JDBC ドライバーを使用できるように Web アプリケーション・サーバーを構成する

キャンペーンを配置する予定の Web アプリケーション・サーバーには、JDBC 接続をサポートするための適切な JAR ファイルがなければなりません。この JAR ファイルによって、Web アプリケーションはシステム・テーブルに接続できます。Web アプリケーション・サーバーのクラスパスに、JAR ファイルの場所を含める必要があります。

このタスクについて

WebSphere®、Weblogic、Tomcat を使用していて、この製品をインストールしたときにインストーラーでデータ・ソースを作成した場合は、この手順に含まれているクラスパスの設定に関するステップを省略できます。インストール時のデータ・ソースの自動作成を有効にするには、「キャンペーンデータ・ソース作成」パネルで、「データ・ソースの作成」チェック・ボックスにチェック・マークを付け、アプリケーション・サーバーについての情報を指定します。インストーラーでデータ・ソースを作成しない場合は、以下の手順をすべて実行します。

WebLogic アプリケーション・サーバーを使用している場合は、以下の手順をすべて実行する必要があります。

手順

「推奨されるソフトウェア環境および最小システム要件」の資料を調べて、ご使用のデータベース・タイプに合う適切な JAR ファイルを判別します。
IBM® Marketing Software がサポートしている、ベンダー提供の最新のタイプ 4 JDBC ドライバーを入手します。
- Campaign を配置する予定のマシンにドライバーが存在しない場合は、そのマシン上の任意の場所にドライバーをコピーします。スペースを含まないパスにドライバーを解凍してください。
- データ・ソース・クライアントがインストールされているマシンからドライバーを入手する場合は、バージョンがサポートされていることを確認してください。
ドライバーの絶対パスとファイル名を、Campaign を配置する予定の Web アプリケーション・サーバーのクラスパスに含めます。
- サポートされるすべてのバージョンの WebLogic で、環境変数が構成される WebLogic_domain_directory/bin ディレクトリーの setDomainEnv スクリプトにクラスパスを設定します。
  
  ドライバーは CLASSPATH の値のリスト内ですべての既存値よりも前の最初のエントリーでなければなりません。以下に例を示します。
  
  UNIX
```
CLASSPATH="/home/oracle/product/<version>/jdbc/lib/ojdbc7.jar:
		${PRE_CLASSPATH}${CLASSPATHSEP}${WEBLOGIC_CLASSPATH} 
		${CLASSPATHSEP}${POST_CLASSPATH}${CLASSPATHSEP}${WLP_POST_CLASSPATH}"
		export CLASSPATH
```
  Windows
```
set CLASSPATH=c:\oracle\jdbc\lib\ojdbc7.jar;%PRE_CLASSPATH%;
%WEBLOGIC_CLASSPATH%;%POST_CLASSPATH%;%WLP_POST_CLASSPATH%
```
- サポートされているすべてのバージョンの WebSphere で、IBM Marketing Software 製品のための JDBC プロバイダーをセットアップする際に、管理コンソールでクラスパスを設定します。
- Marketing Campaign インストール・ワークシートにこのデータベース・ドライバー・クラスパスを書き留めておきます。インストーラーの実行時にこのパスを入力する必要があります。
Web アプリケーション・サーバーを再始動して、変更内容が有効になるようにします。
起動の際に、コンソール・ログをモニターして、クラスパスにデータベース・ドライバーへのパスが含まれていることを確認します。

このタスクについて

インストール中のデータベースの作成は、JBOSS アプリケーション・サーバーの場合はサポートされないので、この手順をすべて実行する必要があります。

手順

「推奨されるソフトウェア環境および最小システム要件」のガイドの説明に従って、IBM Marketing Software でサポートされるシステム・テーブル・データベース用に、ベンダー提供の最新のタイプ 4 JDBC ドライバーを入手します。
JDBC ドライバーの入手後、以下のガイドラインを使用します。
- キャンペーンを配置する予定のサーバー上にこのドライバーが存在しない場合は、それを入手し、そのサーバーでアンパックします。スペースを含まないパスにドライバーを解凍してください。
- データ・ソース・クライアントのインストール場所であるサーバーからドライバーを入手する場合、キャンペーンでサポートされる最新バージョンであることを確認してください。
次のコマンドを使用して、ファイル名を含むドライバーのフルパスをモジュールに追加および登録します。
- サポートされるすべてのバージョンの JBoss で、JDBC ドライバーをモジュールとして追加します。次の手順を使用して、JDBC ドライバーをモジュールとして追加します。
  例えば、SQL サーバーの場合:
  module add --name=com.microsoft.sqlserver.jdbc --resources=<JDBC_Driver_Location>\sqljdbc4.jar --dependencies=javax.api,javax.transaction.api
- 次のガイドラインを使用して、この SQL JDBC ドライバーを登録します。以下に例を示します。
  - /subsystem=datasources/jdbc-driver=sql:add(driver-module-name=com.microsoft.sqlserver.jdbc,driver-name=sql,driver-xa-datasource-class-name=com.microsoft.sqlserver.jdbc.SQLServerXADataSource)
  - /subsystem=datasources/jdbc-driver=sql:read-resource
  - /subsystem=ee/service=default-bindings:write-attribute(name=datasource, value=undefined)
キャンペーンインストール・ワークシートにこのデータベース・ドライバー・クラスパスを書き留めておきます。インストーラーの実行時にこのパスを入力する必要があります。
変更内容を有効にするため、Web アプリケーション・サーバーを再始動します。
始動時にコンソール・ログをモニターして、データベース・ドライバーのパスがクラスパスに含まれていることを確認してください。

このタスクについて

Apache Tomcat を使用している場合は、以下の手順をすべて実行する必要があります。

手順

「推奨されるソフトウェア環境および最小システム要件」のガイドの説明に従って、IBM Marketing Software でサポートされるシステム・テーブル・データベース用に、ベンダー提供の最新のタイプ 4 JDBC ドライバーを入手します。
JDBC ドライバーの入手後、以下のガイドラインを使用します。
- キャンペーンを配置する予定のサーバー上にこのドライバーが存在しない場合は、それを入手し、そのサーバーでアンパックします。スペースを含まないパスにドライバーを解凍してください。
- データ・ソース・クライアントのインストール場所であるサーバーからドライバーを入手する場合、キャンペーンでサポートされる最新バージョンであることを確認してください。
jar ファイルを手動で $Tomcat_Installed_Location/lib/ にコピーします。$Tomcat_Installed_Location は Campaign を配置する Tomcat ルート・インストール・ディレクトリーです。
キャンペーンインストール・ワークシートにこのデータベース・ドライバー・クラスパスを書き留めておきます。インストーラーの実行時にこのパスを入力する必要があります。
変更内容を有効にするため、Web アプリケーション・サーバーを再始動します。
始動時にコンソール・ログをモニターして、データベース・ドライバーのパスがクラスパスに含まれていることを確認してください。