A Microsoft SQL Serverをデハイドレーション・ストアとして使用

この付録では、Microsoft SQL Server Databaseをハイドレーション・ストアとしてOracle BPEL Process Managerと使用する方法を説明します。

この付録の内容は次のとおりです。

要件の概要
手順1: Microsoft SQL Server Databaseのインストールと構成
手順2: Oracle BPEL Process Managerのインストール
手順3: Oracle BPEL Process Manager表をMicrosoft SQL Server Databaseで作成
手順4: JDBCドライバのダウンロードと構成
手順5: Microsoft SQL Serverをデハイドレーション・ストアとして使用

注意:

この付録では、Oracle BPEL Process Manager on Windowsのインストールと構成を説明します。Oracle BPEL Process Manager on UNIXオペレーティング・システムをインストールする場合は、付録内のディレクトリ・パスを正しく置き換えてください。

A.1 要件の概要

表A-1は、サポートされるMicrosoft SQL Serverデータベース、JDBCドライバおよびOracle BPEL Process Managerで使用するアプリケーション・サーバーを示します。Oracle BPEL Process Managerメモリー、ディスク領域、スワップ領域およびモニターの要件については、表1-2を参照してください。

表A-1 Microsoft SQL Server Databaseの要件

コンポーネント	要件
データベース	MS SQL Server 2000 Service Pack（SP）4
JDBCドライバ	Oracle&DataDirect JDBCドライバ10.1.2.0.2
アプリケーション・サーバー	Oracle Application Server 10.1.2.0.2

A.2 手順1: Microsoft SQL Server Databaseのインストールと構成

Microsoft SQL Serverをインストールするホストに移動します。（たとえば、ホストはmy_DBHOSTと名付けられています）必要に応じて使用するホスト名に変えてください。

使用するMicrosoft SQL Serverデータベースを次のようにインストールし、構成します。

要素タイプ	要素名の例
データベース名	`orabpeldb`（使用が推奨される名前）
データベース・ログイン・ユーザー名	`orabpel`（使用が推奨される名前）
データベース・ログイン・パスワード	`orabpel_pword`

この章全体で、これらの要素名を使用します。使用する名前が異なる場合は、必要に応じて名前を置き換えてください。

手順2で作成したユーザー名とパスワードを使用し、Microsoft SQL Serverデータベースとの接続をテストします。
接続に問題がある場合は、Microsoft SQL Serverデータベースの管理者に問い合せてください。

A.3 手順2: Oracle BPEL Process Managerのインストール

第2章「Oracle BPEL Process Managerのインストール」の指示に従い、環境に適した10.1.2.0.2のインストール・タイプをインストールします。
- Oracle BPEL Process Manager for Developers
- Oracle BPEL Process Manager for OracleAS Middle Tier
Oracle BPEL Process Manager for OracleAS Middle Tierをインストールする場合は、Oracle Universal Installerでのインストール中に「デハイドレーション・データベースのタイプの選択」画面で「Oracle以外のデータベース」を選択します。

これにより、「デハイドレーション・データベース情報の指定」などのその他のインストール画面をスキップして、インストール・プロセスを完了できます。

A.4 手順3: Oracle BPEL Process Manager表をMicrosoft SQL Server Databaseで作成

次の場所から、OracleMetaLinkパッチ番号5099565をダウンロードします。
```
http://metalink.oracle.com
```
このパッチには、次のOracle BPEL Process Manager表スクリプトが含まれています。
- server_sqlserver.ddl
- domain_sqlserver.ddl
- workflow_sqlserver.sql
- sensor_sqlserver.sql
これらのファイルを、isql SQLユーティリティがインストールされたホスト（c:\tempなど）上のディレクトリにコピーします。

スクリプトを実行するためには、isql SQLユーティリティが必要です。
isqlを使用して、Oracle BPEL Serverデータベースの表を作成します。
```
c:\temp>isql -U orabpel –P orabpel_pword –S myDB_Host -d orabpeldb -i server_sqlserver.ddl

c:\temp>isql -U orabpel –P orabpel_pword –S myDB_Host -d orabpeldb -i domain_sqlserver.ddl
```
それぞれの意味は次のとおりです。
- orabpelは、「手順1: Microsoft SQL Server Databaseのインストールと構成」で指定したユーザー名です。
- orabpel_ pwordは、「手順1: Microsoft SQL Server Databaseのインストールと構成」で指定したパスワードです。
- myDB_Hostは、Microsoft SQL Serverデータベースがインストールされたホストの名前です。
- orabpeldbは、「手順1: Microsoft SQL Server Databaseのインストールと構成」で指定したデータベース名です。

Oracle BPEL Process Managerワークフロー・データベース表を作成します。

c:\temp>isql -U orabpel –P orabpel_pword –S myDB_Host -d orabpeldb -i workflow_sqlserver.sql

Oracle BPEL Process Managerセンサー・データベース表を作成します。

c:\temp>isql -U orabpel –P orabpel_pword –S myDB_Host -d orabpeldb -i sensor_sqlserver.sql

A.5 手順4: JDBCドライバのダウンロードと構成

次のURLから、DirectData JDBCドライバをダウンロードします。

http://www.oracle.com/technology/software/products/ias/htdocs/utilsoft.html

「Oracle Technology Network Developer License Terms」の内容を確認し、すべての使用条件に同意します。

「Oracle Application Server 10g」ページが表示されます。
「Version 10.1.2.0.2」ヘッダーに進みます。
「DirectData JDBC Drivers」をクリックして、ドライバをダウンロードします。
Oracle BPEL Process Managerホスト上にJDBCドライバを置くディレクトリを作成します。ここでは、次のディレクトリ名を使用します。
```
C:\dataDirectOc4jJDBCDriver
```
インストール・タイプに合せて、JDBCドライバJARファイルをapplication.xmlファイルに追加します。
- Oracle BPEL Process Manager for Developersの場合
  
  Oracle_Home\integration\orabpel\system\appserver\oc4j\j2ee\home\config\ application.xml
- Oracle BPEL Process Manager for OracleAS Middle Tierの場合
  
  Oracle_Home\j2ee\OC4J_BPEL\config\ application.xml
```
...

...
<library path="C:\dataDirectOc4jJDBCDriver\lib\YMbase.jar"/>
<library path="C:\dataDirectOc4jJDBCDriver\lib\YMsqlserver.jar"/>
<library path="C:\dataDirectOc4jJDBCDriver\lib\YMutil.jar"/>
...
```

A.6 手順5: Microsoft SQL Serverをデハイドレーション・ストアとして使用

「手順3: Oracle BPEL Process Manager表をMicrosoft SQL Server Databaseで作成」でダウンロードしたOracleMetaLinkパッチ内のdata-sources_sqlserver.xmlファイルを開きます。

このファイルの情報で、次の設定を構成できます。
- JDBCドライバ
- 「手順1: Microsoft SQL Server Databaseのインストールと構成」でMicrosoft SQL Server Databaseをインストールしたホスト名とポート。
- 「手順1: Microsoft SQL Server Databaseのインストールと構成」で作成したユーザー名とパスワード。
使用するインストール・タイプの次のディレクトリにあるdata-sources.xmlファイルを開きます。
- Oracle BPEL Process Manager for Developersの場合
  
  Oracle_Home\integration\orabpel\system\appserver\oc4j\j2ee\home\config\ sources.xml
- Oracle BPEL Process Manager for OracleAS Middle Tierの場合
  
  Oracle_Home\j2ee\OC4J_BPEL\config\data-sources.xml
data-sources_sqlserver.xmlファイルの次のセクションをコピーし、data-sources.xmlファイルに貼り付けます。

次のセクションで、ホスト名、ポート、パスワード、ユーザー名を（orabpelから変更した場合のみ）使用環境の正しい値に変更します。

<?xml version="1.0" standalone='yes'?>
<!DOCTYPE data-sources PUBLIC "Orion data-sources"
"http://xmlns.oracle.com/ias/dtds/data-sources-9_04.dtd">

<data-sources>
<!--

An example/default DataSource that uses
Oracle JDBC-driver to create the connections.
This tag creates all the needed kinds
of data-sources, transactional, pooled and EJB-aware sources.
The source generally used in application code is the "EJB"
one - it provides transactional safety and connection
pooling. Oracle thin driver could be used as well,
like below.
url="jdbc:oracle:thin:@host:port:sid"
-->

<!-- Use this datasource to connect to Microsoft SQL Server -->

<data-source class="com.evermind.sql.DriverManagerDataSource"
     name="BPELServerDataSource"
     location="jdbc/BPELServerDataSourceWorkflow"
     xa-location="BPELServerDataSource"
     ejb-location="jdbc/BPELServerDataSource"
     connection-driver="com.oracle.ias.jdbc.sqlserver.SQLServerDriver"
     max-connections="50"
     min-connections="10"
     connection-retry-interval="30"
     max-connect-attempts="10"
url="jdbc:oracle:sqlserver://
[DB_HOST]:[PORT];SelectMethod=cursor;User=orabpel;Password=orabpel_pword"/>

<data-source class="com.evermind.sql.DriverManagerDataSource"
     name="BPELSamplesDataSource"
     location="jdbc/BPELSamplesDataSource"
     xa-location="BPELSamplesDataSource"
     ejb-location="jdbc/BPELSamplesDataSource"
     connection-driver="com.oracle.ias.jdbc.sqlserver.SQLServerDriver"
     max-connections="50"
     min-connections="10"
     connection-retry-interval="30"
     max-connect-attempts="10"
url="jdbc:oracle:sqlserver:
//[DB_HOST]:[PORT];SelectMethod=cursor;User=orabpel;Password=orabpel_pword"/>

<data-source class="com.evermind.sql.DriverManagerDataSource"
             name="AdminConsoleDateSource"
             location="jdbc/AdminConsoleDateSource"
             xa-location="AdminConsoleDateSource"
             ejb-location="jdbc/AdminConsoleDateSource"
             connection-driver="com.oracle.ias.jdbc.sqlserver.SQLServerDriver"
             max-connections="80"
             min-connections="2"
     connection-retry-interval="30"
     max-connect-attempts="10"
url="jdbc:oracle:sqlserver:
//[DB_HOST]:[PORT];SelectMethod=cursor;User=orabpel;Password=orabpel_pword"/>

data-sources.xmlのOracle Database Liteセクションをコメント・アウトします。

<!-- Use these datasources to connect to Oracle Lite -->
<!-- 
<data-source class="com.evermind.sql.DriverManagerDataSource"
. . .
. . .
. . .
<data-source class="com.evermind.sql.DriverManagerDataSource"
. . .
. . .
<data-source class="com.evermind.sql.DriverManagerDataSource"
. . .
. . .     
url="jdbc:polite4@127.0.0.1:100:orabpel"/>
 -->

data-sources.xmlファイルの変更を保存します。
Windows上にOracle BPEL Process Managerをインストールした場合、Oracle Database Liteの行を次のようにファイルから削除するかコメント・アウトします。
- Oracle_Home\integration\orabpel\bin\startorabpel.batファイル内
```
@rem start /d "Oracle_Home\integration\orabpel\bin" /min /realtime start_olite.bat
```
- Oracle_Home\integration\orabpel\bin\ shutdowntorabpel.batファイル内
```
@rem start /min /d "Oracle_Home\integration\orabpel\bin\kill_olite.bat"
```
Microsoft SQL Server Databaseの構成が完了しました。