管理者ガイド
© 2002-2008 Unify Corporation All rights reserved. Sacramento California, USA
No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise without the prior written consent of Unify Corporation.
Unify Corporation makes no representations or warranties with respect to the contents of this document and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Further, Unify Corporation reserves the right to revise this document and to make changes from time to time in its content without being obligated to notify any person of such revisions or changes.
The Software described in this document is furnished under a Software License Agreement. The Software may be used or copied only in accordance with the terms of the license agreement. It is against the law to copy the Software on tape, disk, or any other medium for any purpose other than that described in the license agreement. The Unify Corporation Documentation Group values and appreciates any comments you may have concerning our documents. Please address comments to:
1-800-24 UNIFY or 1-800-GO-UNIFY;(916) 928-6400 FAX (916) 928-6401
UNIFY and DataServer are registered trademarks of Unify Corporation. Unify NXJ is a trademark of Unify Corporation. Java and J2EE are registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. JReport is a trademark of Jinfonet Corporation. IBM, Lotus, Lotus Notes, Cloudscape, and WebSphere are trademarks of International Business Machines Corporation in the United States, other countries, or both. CASAHL Technology and ecKnowledge are registered trademarks of CASAHL Technology, Inc. in the U.S. and other countries.All other products or services mentioned herein may be registered trademarks, trademarks, or service marks of their respective manufacturers, companies, or organizations.
Name: Administrator’s Guide Release: Unify NXJ 12
目次
1.0 はじ めに ...1
1.1 Unify NXJ の環境 ... 1
1.2 NXJ アプ リ ケーシ ョ ンはどのよ う に動作するか？ ... 4
1.2.1 ユーザイ ン タ フ ェ ース ... 4
1.2.2 デー タ ソ ース ... 5
1.2.3 ビ ジネスルール ... 5
1.2.4 配備担当者 と管理者 ... 5
1.2.5 リ ソ ース ... 6
1.2.6 セキュ リ テ ィ ... 6
2.0 NXJ リ ポジ ト リ の構成 ...7
2.1 IBM DB2 デー タ ベース ... 8
2.2 Informix デー タ ベース... 9
2.3 MS SQL Server デー タ ベース... 9
2.4 Oracle デー タ ベース ... 9
2.5 SQLBase...10
2.6 JBoss アプ リ ケーシ ョ ンサーバ...10
2.7 WebSphere アプ リ ケーシ ョ ンサーバ ...11
2.7.1 リ ポジ ト リ テーブルの作成 ...11
2.8 WebLogic アプ リ ケーシ ョ ンサーバ ...11
2.8.1 リ ポジ ト リ テーブルの作成 ...11
2.8.2 WebLogic 開始ス ク リ プ ト の更新 ...11
2.8.3 WebLogic の構成を更新 ...12
2.8.4 WebLogic アプ リ ケーシ ョ ンサーバの再起動 ...14
2.9 Oracle アプ リ ケーシ ョ ンサーバ （OC4J or 10g） ...14
2.9.1 リ ポジ ト リ テーブルの作成 ...14
ii
© Copyright 2008 Unify Corporation3.0 デー タ ソ ース定義 ... 15
3.1 BEA WebLogic アプ リ ケーシ ョ ンサーバ ...15
3.2 IBM WebSphere アプ リ ケーシ ョ ンサーバ ...19
3.3 JBoss アプ リ ケーシ ョ ンサーバ...24
3.3.1 既存の JBoss デー タ ソ ース定義を コ ピーする ...24
3.3.2 新 し いデー タ ソ ース定義 XML フ ァ イルを作成する ...25
3.4 Oracle Application Server 10g...27
3.4.1 OC4J ...27
3.4.2 Enterprise Edition ...29
4.0 NXJ - アプ リ ケーシ ョ ンサーバの構成 ... 30
4.1 JBoss - NXJ の構成 ...30
4.1.1 NXJ Developer の構成 ...31
4.1.2 NXJ Enterprise Developer の構成 ...31
4.2 WebSphere - NXJ の構成 ...32
4.2.1 NXJ Developer の構成 ...32
4.2.2 NXJ Enterprise Developer の構成 ...32
4.3 Weblogic - NXJ の構成...33
4.3.1 NXJ Developer の構成 ...34
4.3.2 NXJ Enterprise Developer の構成 ...34
4.4 Oracle 10g - NXJ の構成...35
4.4.1 NXJ Developer の構成 ...35
4.4.2 NXJ Enterprise Developer の構成 ...35
5.0 NXJ ActiveSOA - アプ リ ケーシ ョ ンサーバの構成 ... 37
5.1 JBoss - NXJ ActiveSOA の構成 ...37
5.1.1 JBoss アプ リ ケーシ ョ ンサーバを シ ャ ッ ト ダウン ...38
5.1.2 JBoss アプ リ ケーシ ョ ンサーバの systinet war の作成 ...38
5.1.3 Production jboss サーバログ イ ン - config.xml フ ァ イルの構成 ...38
5.1.4 bin/run.conf の編集 ...38
5.1.5 アプ リ ケーシ ョ ンサーバに security-ng.jar を コ ピー ...39
5.1.6 アプ リ ケーシ ョ ンサーバに nxjwaspjass.jar を コ ピー ...39
5.1.7 アプ リ ケーシ ョ ンサーバに jass.config を コ ピー ...39
5.1.8 ‘jboss-service.xml’ フ ァ イルの構成 ...39
5.1.9 ‘ear-deployer.xml’ フ ァ イルの構成 ...39
5.1.10 アプ リ ケーシ ョ ンサーバ startup ス ク リ プ ト の編集 ...40
5.1.11 joss アプ リ ケーシ ョ ンサーバを起動 し て
NXJ ActiveSOA admin console にア ク セス ...41
5.1.12 NXJ アプ リ ケーシ ョ ン ear の配備と web サービ スの関連付け ...41
5.2 Weblogic - NXJ ActiveSOA の構成 ...42
5.2.1 weblogic アプ リ ケーシ ョ ンサーバを シ ャ ッ ト ダウン ...42
5.2.2 weblogic アプ リ ケーシ ョ ンサーバの systinet war の作成 ...42
5.2.3 アプ リ ケーシ ョ ンサーバに security-ng.jar を コ ピー ...43
5.2.4 アプ リ ケーシ ョ ンサーバに nxjwaspjass.jar を コ ピー ...43
5.2.5 アプ リ ケーシ ョ ンサーバに j2ee_jndi_connerctor.jar を コ ピー ...43
5.2.7 admin user の作成 ...45
5.2.8 アプ リ ケーシ ョ ンサーバに systinet.war を配備 ...45
5.2.9 weblogic アプ リ ケーシ ョ ンサーバを開始 し て
NXJ ActiveSOA 管理コ ン ソ ールにア ク セス ...45
5.3 Oracle 10g - NXJ ActiveSOA の構成 ...45
5.3.1 Oracle 10g アプ リ ケーシ ョ ンサーバの systinet war の作成 ...45
5.3.2 2 つの NXJ ActiveSOA 関連 jar フ ァ イル用に
shared library を Oracle 10g アプ リ ケーシ ョ ンサーバに作成 ...46
5.3.3 systinet.war フ ァ イルの配備 ...46
5.3.4 Oracle 10g アプ リ ケーシ ョ ンサーバフ ァ イルの更新 ...47
5.3.5 NXJ ActiveSOA java オプシ ョ ンの追加 ...47
5.3.6 Oracle 10g アプ リ ケーシ ョ ンサーバを開始 し て、
NXJ ActiveSOA 管理コ ン ソ ールにア ク セス ...48
6.0 NXJ ActiveWorkflow - アプ リ ケーシ ョ ンサーバの構成 ... 49
6.1 NXJBPM.ear フ ァ イルの構成 ...49
6.1.1 NXJ ActiveWorkflow ear フ ァ イルを開 く ...49
6.1.2 Portal.properties の構成 ...49
6.1.3 hibernate.cfg.xml の構成 ...50
6.1.4 quartz.properties の構成 ...51
6.2 JBoss - ActiveWorkflow の構成...51
6.2.1 アプ リ ケーシ ョ ンサーバの startup ス ク リ プ ト の編集 ...51
6.2.2 NXJ リ ポジ ト リ デー タ ソ ースの設定 ...52
6.2.3 jboss-service.xml フ ァ イルの構成 ...52
6.2.4 ear-deployer.xml フ ァ イルの構成 ...52
6.2.5 NXJBPM.ear フ ァ イルの配備 ...52
6.3 WebSphere - ActiveWorkflow の構成 ...52
6.4 Weblogic - ActiveWorkflow の構成 ...53
6.4.1 JMS Connection factory の作成 ...53
6.4.2 JMS Destination Queue の作成 ...53
6.4.3 BPM commons-logging.jar を CLASSPATH 上に置 く ...53
6.4.4 NXJBPM.ear フ ァ イルの配備 ...53
6.5 Oracle 10g - ActiveWorkflow の構成 ...54
6.5.1 NXJ リ ポジ ト リ デー タ ソ ースの設定 ...54
6.5.2 global jndi lookup の有効 ...54
6.5.3 BPM Events Queue の JMS destination の作成 ...54
6.5.4 shared library の作成 ...54
6.5.5 NXJBPM.ear フ ァ イルの配備 ...55
7.0 NXJ ActiveReporting - アプ リ ケーシ ョ ンサーバの構成... 57
7.1 JBoss - NXJ ActiveReporting の構成 ...57
7.2 WebSphere - NXJ ActiveReporting の構成...58
7.3 Weblogic - NXJ ActiveReporting の構成 ...58
7.4 Oracle 10g - NXJ ActiveReporting の構成 ...59
© Copyright 2008 Unify Corporation
1
1
は じ めに
Unify NXJ は、 NXJ ア プ リ ケーシ ョ ン を構築 ・ 配備 ・ 管理 を す る ためのプ ラ ッ ト フ ォ ー ムです。 NXJア プ リ ケーシ ョ ンは、 ビ ジネ ス プ ロ セ ス を自動化 し て、 それ ら のプ ロ セ スにおけ る デー タ への安全な ア ク セ スが保証 さ れた J2EE 準拠の Web ア プ リ ケーシ ョ ン です。 例 えば、 NXJ ア プ リ ケーシ ョ ンは経費申請の承認プ ロ セスに使用する こ と がで き ます。 そ のア プ リ ケーシ ョ ン では、 従業員が申請書を提出 し てその進捗を確認す る こ と がで き た り 、 給与支払い担当者が従業員の提出 し た申請書を処理 し て、 支払い処理に自動的に送 る こ と がで き た り し ます。 こ のよ う に自動化 さ れた プ ロ セ スは、 申請書が正 し く 取 り 扱 われる こ と を確実にす る こ と がで き ます。 ま た、 セキ ュ リ テ ィ に関 し ては、 従業員は申 請の追加 ・ 確認に限定 さ れる一方で給与支払い担当者は追加 ・ 削除 ・ 更新 ・ 確認がで き る と い っ た形で保証す る こ と がで き ます。 各 NXJ ア プ リ ケーシ ョ ンは ZIP フ ァ イルでパ ッ ケージ さ れ、 J2EE ア プ リ ケーシ ョ ン サーバに配備 さ れます。 サポー ト さ れる ア プ リ ケーシ ョ ンサーバについては、 『Unify NXJ がサポー ト す る構成』 に一覧 さ れてい ます。1.1
Unify NXJ の環境
Unify NXJ は、 開発環境 と 実行環境で動作 し ます。 NXJ ア プ リ ケーシ ョ ンは開発環境で 作成 さ れて、 パ ッ ケージ さ れます。 こ れ ら のパ ッ ケージは、 ユーザがア プ リ ケーシ ョ ン にア ク セ スする実行環境において、 ア プ リ ケーシ ョ ンサーバに配備 さ れます。 管理者 と 配備担当者は実行環境で作業 し 、 以下を使用 し ます。 • NXJ イ ン タ ラ ク シ ョ ンサーバ ア プ リ ケーシ ョ ンサーバ と 連携 し て NXJ ア プ リ ケーシ ョ ンの実行を調整する。は じ めに
• 管理シ ス テム
NXJ テ ク ノ ロ ジに基づいて イ ン ス ト ール さ れたい ろ い ろ なサーバサ イ ド 管理 コ ン ソ ールがあ り ます。
Systinet Server Admin Console:
ホ ス ト さ れた Web サービ ス を管理する ために使用 し ます。 こ れは、 http: // <host>: <por>/systinet/server/admin/console で ア ク セ スす る こ と がで き ます。
Business Process Admin Console:
配備 さ れた ビ ジ ネ ス プ ロ セ スワー ク フ ロ ー を管理す る ために使用 し ます。 こ れ は、 http://<host>:<port>/BPMAdmin で ア ク セ スする こ と がで き ます。 Report Server: 配備 さ れた NXJ レ ポー ト を管理する ために使用 し ます。 こ れは、 http: //<host>: <port>/jreport で ア ク セ スす る こ と がで き ます。 エ ン ド ユーザは、 ブ ラ ウザのア ド レ スバーに NXJ ア プ リ ケーシ ョ ンの URL を入力する こ と に よ り 、 実行環境の NXJ ア プ リ ケーシ ョ ン にア ク セ ス し ます。
は じ めに
3
© Copyright 2008 Unify Corporation
以下は、 Unify NXJ で こ れ らの コ ン ポーネ ン ト と 他の コ ンポーネ ン ト の関係を示 し ま す。
こ のガ イ ド は、 こ れ ら の コ ン ポーネ ン ト を使用す る方法に関す る情報を提供 し ます。 ガ イ ド は、 管理者や配備担当者、 そ し て NXJ ア プ リ ケーシ ョ ン を配備 し て管理する ため に Unify NXJ を使用する その他のユーザを対象 と し ています。
は じ めに
1.2
NXJ ア プ リ ケーシ ョ ンはどのよ う に
動作するか？
NXJ ア プ リ ケーシ ョ ンは、 ユーザ イ ン タ フ ェ ース、 デー タ ソ ースへの リ ン ク 、 ユーザ イ ン タ フ ェ ース と デー タ ソ ース （以下の図） 間の相互作用を定義す る ビ ジネ スルールか ら 成 り ます。1.2.1
ユーザイ ン タ フ ェ ース
ユーザ イ ン タ フ ェ ースは、 主に Java Server Pages （JSP） ページに表示 さ れるフ ォ ー ムか ら 成 り ます。 ユーザは、 Web ブ ラ ウザで フ ォ ームの URL を入力 し て フ ォ ームにア ク セ ス し ます。 各 フ ォ ームは、 コ ン ポーネ ン ト と 機能を ド ラ ッ グ＆ ド ロ ッ プ で配置で き る グ ラ フ ィ カルな ツ ールのア プ リ ケーシ ョ ン デザ イ ナで作成 さ れます。 各 フ ォ ームは、 一般的にデー タ ソ ースか ら のタ ーゲ ッ ト テーブルに関連付け ら れています。 以下は、 一 般的な フ ォ ームの例です。 ヘ ッ ダや フ ッ タ はア プ リ ケーシ ョ ンのス テー タ スに関す る情報を提供 し ます。 ツ ール バーは、 NXJ ア プ リ ケーシ ョ ン を ナ ビゲー ト し た り 、 デー タ を ナ ビゲー ト し た り 、 デー タ ベース操作を実行す る コ マ ン ド ボ タ ン を ユーザに提供 し ます。 ビ ジ ネスルール デー タ ソ ース ユーザ
If adding, then call... If adding, then call... If deleting, then... If searching, then... If invalid ID, then... イ ン タ フ ェ ース フッタ ツールバー ヘ ッ ダ フォーム 本体
は じ めに
5
© Copyright 2008 Unify Corporation
ユーザが フ ォ ーム を操作 し た と き、 NXJ イ ン タ ラ ク シ ョ ンサーバはユーザのア ク シ ョ ン を デー タ ベースに発行 さ れる SQL 文に変換 し ます。 どんな結果で も、 フ ォ ームに返 さ れ、 適切な フ ィ ール ド に表示 さ れます。 例えば、 ユーザは検索条件を入力 し 、 ツ ール バーにあ る検索ボ タ ン を ク リ ッ ク す る こ と で タ ーゲ ッ ト テーブルを検索する こ と がで き ます。 NXJ イ ン タ ラ ク シ ョ ンサーバは、 こ の検索 コ マ ン ド を フ ォ ームに レ コ ー ド を返す SQL SELECT 文に変換 し ます。
1.2.2
デー タ ソ ース
NXJ ア プ リ ケーシ ョ ン で使用 さ れるデー タ ソ ースは、 一般的に Java DataBase Connectivity （JDBC） を通 し て接続 さ れる デー タ ベース です。 開発者は、 ア プ リ ケー シ ョ ンのプ ロパテ ィ の一部 と し て NXJ ア プ リ ケーシ ョ ンデー タ ソ ース を確立 し ます。 管理者 と 配備担当者は、 配備で使用す る デー タ ソ ース を選択 し ます。 管理者 と 配備担当 者は、 実行時にア プ リ ケーシ ョ ンサーバにおいて、 デー タ ソ ース定義を設定する必要が あ るか も し れません。 デー タ ソ ース定義についての詳細は、15 ページの 「デー タ ソ ー ス定義」 を参照 し て く だ さ い。 サポー ト さ れる デー タ ベースベ ン ダーの一覧は、 『Unify NXJ がサポー ト す る構成』 にあ り ます。1.2.3
ビ ジネスルール
ビ ジネスルールは利息を計算 し た り 、 請求額の合計を計算 し た り と い っ た カ ス タ マ イ ズ さ れた ロ ジ ッ ク を使用 し て特定の作業を実行 し ます。 開発者は、 組織のビ ジ ネ ス プ ロ セ スに合 う よ う に NXJ ア プ リ ケーシ ョ ン を作成する ために ビ ジネスルールを使用 し ます。 例えば、 NXJ ア プ リ ケーシ ョ ンは、 新 し い経費申請書のレ コ ー ド がデー タ ベースに追加 さ れる と 、 自動的に申請書番号を生成する ビ ジ ネスルールを含む こ と がで き ます。 あ る いは、 従業員が新 し い経費申請書を提出す る際に、 従業員 ID を確認する ために ビ ジネ スルールを使用で き ます。1.2.4
配備担当者 と 管理者
NXJ配備担当者は、 NXJ ア プ リ ケーシ ョ ン、 ス タ ン ド ア ローン ActiveWorkflow プ ロ セ ス と レ ポー ト を配備す る NXJ ユーザの特別な タ イ プ です。 NXJ管理者は、 NXJ ア プ リ ケーシ ョ ン、 ス タ ン ド ア ローン ActiveWorkflow プ ロ セ ス と ス タ ン ド ア ロ ー ン レ ポー ト を配備、 再配備、 ま たは削除す る NXJ ユーザの特別な タ イ プ です。は じ めに
1.2.5
リ ソ ース
リ ソ ースと は、 ア プ リ ケーシ ョ ン フ ォ ーム、 静的 コ ン テ ン ト 、 動的 コ ン テ ン ト 等、 NXJ ア プ リ ケーシ ョ ン を通 じ てユーザがア ク セ ス で き る物です。 静的 コ ン テ ン ト には、 PDF、 HTML ページ、 イ メ ージが含まれます。 静的 コ ン テ ン ト フ ァ イルは、 ア プ リ ケーシ ョ ンパ ッ ケージに含めるか、 ま たは管理者に よ っ て追加 さ れ ます。 一部の静的 コ ン テ ン ト は、 PDF フ ァ イルのために Adobe Acrobat Reader のよ う な別のビ ュ ーワ を必要 と し ます。 動的 コ ン テ ン ト は、 レ ポー ト 等のよ う に NXJ ア プ リ ケーシ ョ ン に組み込まれる ロ ジ ッ ク の結果、 生成 さ れるか変更 さ れます。1.2.6
セキ ュ リ テ ィ
NXJ ア プ リ ケーシ ョ ンは、 特定の フ ォ ーム、 デー タ と その他の機能へア ク セ スす る ユー ザを制限す る こ と を保証 し ます。 NXJ ア プ リ ケーシ ョ ンのセキ ュ リ テ ィ は、 NXJ ア プ リ ケーシ ョ ンの機能に割 り 当て ら れる ロ ール と ユーザのセキ ュ リ テ ィ プ ロバイ ダーで定義 さ れる ユーザのグループ間の関 係に基づ き ます。 セキ ュ リ テ ィ についての詳細は、 『Securing an NXJ Application』 を 参照 し て く だ さ い。© Copyright 2008 Unify Corporation
7
2 NXJ リ ポジ ト リ の構成
NXJ リ ポジ ト リ は、 カ レ ン ト ビ ジ ネ ス プ ロ セ スや完了プ ロ セ スの履歴のよ う な情報を格 納 し ます。 デ フ ォ ル ト では、 NXJ リ ポジ ト リ は Unify NXJ にバン ド ル さ れてい る SQL Base リ レ ーシ ョ ナルデー タ ベースにデー タ リ ポジ ト リ を作成す る よ う に構成 さ れてい ます。 NXJ ア プ リ ケーシ ョ ン を テ ス ト す る際には、 実行環境を エ ミ ュ レ ー ト で き る よ う 、 開発 環境にデー タ リ ポジ ト リ を構成 し て く だ さ い。 つま り 、 実行環境でデー タ リ ポジ ト リ を Oracle 上に構成す るのであれば、 開発環境で も Oracle デー タ ベース を使用 し て下 さ い。 こ の章の残 り のセ ク シ ョ ン では、 NXJ デー タ リ ポジ ト リ を他のデー タ ベース上に構成す る方法について説明 し ます。 以下のア プ リ ケーシ ョ ンサーバ / デー タ ベースの組み合わ せがサポー ト さ れています。 ア プ リ ケーシ ョ ン サーバ デー タ ベース 参照JBoss IBM DB2 8 ページの 「IBM DB2 デー タ ベース」
Informix 9 ページの 「Informix デー タ ベース」
MS SQL Server 9 ページの 「MS SQL Server デー タ ベース」
NXJ リ ポジ ト リ の構成
2.1
IBM DB2 デー タ ベース
DB2 デー タ ベース を リ ポジ ト リ と し て使用す る には、 以下の手順で NXJ リ ポジ ト リ を 構成する必要があ り ます。
注 : DB2 デー タ ベース を作成す る手順は、 “Type-2” CLI-based driver を 使用する こ と を前提 と し ています。 これには DB2 ク ラ イ ア ン ト 製品 を イ ン ス ト ール し 、 実際のデー タ ベースへの “alias” を作成する必要 があ り ます。 こ の alias はロー カルア ク セスする際のデー タ ベース名 と し て使用 さ れます。 NXJ から デー タ ベースにア ク セスするには、 “Type-4” ド ラ イバを使用 し ます （デー タ ベース alias は使用 し ませ ん）。 また、 32KB ページサイ ズのテーブル領域が利用可能でなければな り ません。 こ れは、 リ ポジ ト リ デー タ ベース中のあ る テーブルの行 サイ ズで非常に大き い ものがあ り 、 その行がデー タ ベースページに 収ま る必要があ るか ら です。 User 領域および System 一時領域を作 成 し て下 さ い。 1. DB2 “db2sql92” ユー テ ィ リ テ ィ と repository-db2.sql ス ク リ プ ト (<UNIFY_HOME>/lib/repository) を実行 し リ ポジ ト リ テー ブル を作成 し ます。 db2sql92 -d ALIAS -a user/password < repository-db2.sql ALIAS はデー タ ベース alias 名、 user/password はテー ブル作成のために必要な ユーザ認証です。 さ ら に、 CLI-based ド ラ イバを使用する には、 ド ラ イバの Jar フ ァ イルを ア プ リ ケーシ ョ ンサーバの ク ラ スパスに追加 し 、 DB2 “bin” デ ィ レ ク ト リ を ア プ リ ケー シ ョ ンサーバの PATH に追加する必要があ り ます。 WebSphere IBM DB2 Informix Oracle 11 ページの 「WebSphere ア プ リ ケー シ ョ ンサーバ」 WebLogic Oracle MS SQL Server 11 ページの 「WebLogic ア プ リ ケー シ ョ ンサーバ」
Oracle 10g & OC4J Oracle 14 ページの 「Oracle ア プ リ ケーシ ョ ン サーバ （OC4J or 10g）」
ア プ リ ケーシ ョ ン
NXJ リ ポジ ト リ の構成
9
© Copyright 2008 Unify Corporation
2.2
Informix デー タ ベース
Informix デー タ ベース を NXJ デー タ リ ポジ ト リ と し て使用す る には、 以下の手順で構 成す る必要があ り ます。 1. NXJ リ ポジ ト リ デー タ を保持す る テー ブルを デー タ ベース に作成 し ます。 dbaccess ま たは同様のツ ールを用い、 <UNIFY_HOME>/lib/repository デ ィ レ ク ト リ にあ る “repository-informix.sql” ス ク リ プ ト を実行 し ます。 こ のス ク リ プ ト は、同 じ デ ィ レ ク ト リ にあ る turbineUser-ifx.dat も使用 し ますので注意 し て下 さ い。 dbaccess を実行す る ために必要な環境変数は以下の と お り です。 - INFORMIXDIR Informix イ ン ス ト ールデ ィ レ ク ト リ ; - INFORMIXSERVER Informix サーバ イ ン ス タ ン ス名 ;- PATH Informix “bin” デ ィ レ ク ト リ をパスに含めます
Informix 環境変数を設定後、 dbaccess を実行 し ます。 dbaccess <repository> repository-informix.sql
<repository> はデー タ ベース名です。 ま た “repository-informix.sql” お よ び “turbineUser-ifx.dat” は現在のデ ィ レ ク ト リ に存在す る も の と し ます。
2.3
MS SQL Server デー タ ベース
MS SQL Server デー タ ベース を NXJ デー タ リ ポジ ト リ と し て使用す る には、 以下の手 順で構成す る必要があ り ます。 1. NXJ リ ポジ ト リ デー タ を保持す る テー ブルを デー タ ベース に作成 し ます。 osql ま たは同様のツ ールを使用 し 、 <UNIFY_HOME>/lib/repository にあ る "repository-mssql.sql" ス ク リ プ ト を実行 し ます。注 : Microsoft SQL Server ク ラ イ ア ン ト ツールに含まれる "isql" ユー テ ィ リ テ ィ はス ク リ プ ト を実行で き ません。 CT-Library ベース の osql ユーテ ィ リ テ ィ が代わ り に使用で き ます。
2.4
Oracle デー タ ベース
Oracle デー タ ベース を NXJ デー タ リ ポジ ト リ と し て使用す る には、 以下の手順で構成 する必要があ り ます。 1. NXJ リ ポジ ト リ デー タ を保持す る テー ブルを デー タ ベース に作成 し ます。 sqlplus ま たは同様のツ ールを使用 し 、 <UNIFY_HOME>/lib/repository デ ィ レ ク ト リ にあ る "repository-oracle.sql" ス ク リ プ ト を実行 し ます。 こ のス ク リ プ ト は リ ソ ー ス権限を持 っ たユーザで実行す る必要があ り ます。 こ の権限は以下の方法で許可で き ます。NXJ リ ポジ ト リ の構成
GRANT “RESOURCE” TO “<username>”; テーブルスペースは 3MB 以上割 り 当て て下 さ い。
2.5
SQLBase
SQLBase で リ ポジ ト リ テー ブルを作成す る には、 Unify sqltalk ユーテ ィ リ テ ィ を使 用 し て SQLBase デー タ ベースに接続 し て、 sql ス ク リ プ ト を実行 し て く だ さ い。 : <UNIFY_HOME>/lib/ repository/repository-sqlbase.sql
2.6
JBoss アプ リ ケーシ ョ ンサーバ
JBoss が、 デー タ ソ ース を認識す る ために必要 と す る 2 つの構成項目があ り ます。 1. 必要な jdbc デー タ ベース ド ラ イバ jar フ ァ イルを イ ン ス ト ール し ます。 2. デー タ ソ ース xml フ ァ イルを設定 し ます。 デー タ ソ ース xml フ ァ イルが、 各サポー ト さ れたデー タ ベースに対 し て どの様に構 成 さ れなければな ら ないかを示すテ ン プ レ ー ト フ ァ イルがあ り ます。 こ れ ら のテ ン プ レ ー ト は、 <UNIFY_HOME>/lib/repository デ ィ レ ク ト リ にあ り ます。 こ れ ら は、 <database>-NXJCCDS-ds.xml と 名付け られます。 こ こ で、 <database> は db2、 oracle、 informix、 mssql、 または sqlbase の こ と です。例 ： db2 デー タ ソ ース を構成 し たい場合、 .../jboss/server/default/deploy デ ィ レ ク ト リ に db2-NXJCCDS-ds.xml を コ ピー し ます。 新 し く コ ピー さ れた フ ァ イルを編集 し て、 以下の値を db2 に置き換え ます。 YOUR_HOST YOUR_PORT YOUR_DBNAME YOUR_USER NAME YOUR_PASSWORD
注 : oracle デー タ ベース を使用す る場合、 以下の <attribute name= Pad >true</attribute> のよ う に表示 さ れる Pad" 属性を ア ン コ メ ン ト する必要があ り ます。 こ の属性は、 デ ィ レ ク ト リ ../jboss/server/ default/conf に格納 さ れる jboss-service.xml フ ァ イルにおいて構成 さ れます。
NXJ リ ポジ ト リ の構成
11
© Copyright 2008 Unify Corporation
2.7
WebSphere アプ リ ケーシ ョ ンサーバ
WebSphere ア プ リ ケーシ ョ ンサーバを使用す る場合、 IBM DB2、 Informix、 MS SQL、 Oracle デー タ ベースに NXJ デー タ リ ポジ ト リ を構成す る こ と がで き ます。 使用する DBMS のバージ ョ ンは、 本バージ ョ ンの Unify NXJ がサポー ト するバージ ョ ン で なければな り ません。 『Unify NXJ がサポー ト する構成』 を参照 し て下 さ い。 以下の手順に従 っ て、 リ ポジ ト リ と し て他のデー タ ベース を使用する NXJ リ ポジ ト リ を構成 し て く だ さ い。
2.7.1
リ ポジ ト リ テーブルの作成
NXJ リ ポジ ト リ デー タ を保持す る リ ポジ ト リ テー ブルを デー タ ベースに作成 し ま す。 8 ページの 「IBM DB2 デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。 9 ページの 「Informix デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。 9 ページの 「Oracle デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。2.8
WebLogic アプ リ ケーシ ョ ンサーバ
WebLogic ア プ リ ケーシ ョ ンサーバに NXJ リ ポジ ト リ を構成す る には、 ア プ リ ケーシ ョ ンサーバを構成する必要があ り ます。2.8.1
リ ポジ ト リ テーブルの作成
NXJ リ ポジ ト リ デー タ を保持す る リ ポジ ト リ テー ブルを デー タ ベースに作成 し ます。 9 ページの 「MS SQL Server デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。 9 ページの 「Oracle デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。2.8.2
WebLogic 開始ス ク リ プ ト の更新
テキス ト エデ ィ タ を使用 し て WebLogic サーバの開始ス ク リ プ ト を編集 し ます。 通常、 こ のス ク リ プ ト は startWebLogic.cmd （Unix/Linux では startWebLogic.sh） と い う フ ァ イルです。 フ ァ イルは、 ../bea/<user_projects>/Domains/<yourdomain> に格納 さ れま す。NXJ リ ポジ ト リ の構成
1. （Oracle の場合） サーバの CLASSPATH に必要な jar フ ァ イルを追加 し ます。
Windows: %UNIFY_HOME%/lib/jdbcDrivers/ojdbc14.jar Unix/Linux: ${UNIFY_HOME}/lib/jdbcDrivers/ojdbc14.jar 注 : デ フ ォ ル ト の WebLogic 開始ス ク リ プ ト の CLASSPATH には Oracle デー タ ベース ド ラ イバが含まれています。 開始ス ク リ プ ト を変更 し た場合、 以下の jar を追加する よ う に し て く だ さ い。 ${UNIFY_HOME}/lib/jdbcDrivers/ojdbc14.jar
2. （MS SQL Server の場合） サーバの CLASSPATH に必要な jar フ ァ イルを追加 し ま す。 Windows %UNIFY_HOME%/lib/jdbcDrivers/jtds-1.1.jar Unix/Linux ${UNIFY_HOME}/lib/jdbcDrivers/jtds-1.1.jar 3. WebLogic サーバを再起動 し ます。
2.8.3
WebLogic の構成を更新
WebLogic Server Console を使用 し て、 以下の変更 を正 し い ド メ イ ン に対 し て行 っ て下 さ い。 1. NXJ デー タ リ ポジ ト リ テー ブル を含むデー タ ベース を使用す る コ ネ ク シ ョ ン プ ール を作成 し ます。 < Oracle デー タ ベース では以下 を実行 し ます。 > a. ナ ビ ゲーシ ョ ン ツ リ ーで、 Services Configurations > JDBC を選択 し 、 Connection Pools リ ン ク を ク リ ッ ク し ます。
b. Configure a new JDBC Connection Pool リ ン ク を ク リ ッ ク し ます。
c. Choose Database フ ォ ームに以下を入力 し Continue を ク リ ッ ク し ます。
Database Type: Oracle
Database Driver: Oracle's Driver (Thin) Version 9.0.1, 9.2.0, 10 d. “Define and test connection” フ ォ ームに以下を入力 し 、 Test Driver
Configuration を ク リ ッ ク し ます。 Name: NXJDSPool
Driver Classname: oracle.jdbc.OracleDriver URL: jdbc:oracle_clob:thin:@<host>:<port>:<sid> Database User Name: <username>
Password: <password>
NXJ リ ポジ ト リ の構成
13
© Copyright 2008 Unify Corporation
<host> は、 デー タ ベースサーバ名です。
<port> は、 デー タ ベース に接続用ポー ト 番号です。 <sid> は、 デー タ ベース sid です。
<username> は、 デー タ ベースに ロ グ イ ン す る ためのユーザ名です。 <password> は、 そのユーザのパスワー ド です。
Test Driver Configuration を ク リ ッ ク す る と 、 “Connection successful” と い う メ ッ セージが表示 さ れます。 表示 さ れない場合は、 上記設定を確認 し て下 さ い。
注 : デー タ ベース ド ラ イバがサーバの CLASSPATH に含まれていな
い場合、WebLogic Server Console は “JDBC driver is not on the CLASSPATH” と い う メ ッ セージ を表示 し ます。
JdbcOraWrapperDriver が正 し く Driver Classname に設定 さ れ てい る場合、 JdbcOraWrapper.jar がサーバの CLASSPATH に 設定 さ れてい るか確認 し て下 さ い。 ( 上記ス テ ッ プ 2 を参照の こ
と )
e. Create and Deploy を ク リ ッ ク し ます。
< Microsoft SQL Server デー タ ベース では以下を実行 し ます。 >
a. ナ ビ ゲーシ ョ ン ツ リ ーで、 Services > JDBC を選択 し 、 Connection Pools リ ン ク を ク リ ッ ク し ます。
b. “Configure a new JDBC Connection Pools...” リ ン ク を ク リ ッ ク し ます。 c. Choose Database フ ォ ームに以下を入力 し Continue を ク リ ッ ク し ます。
Database Type: Other Database Driver: Other
d. Define Connection プ ロパテ ィ に以下を入力 し Continue を ク リ ッ ク し ます。
Name: NXJCCDSPool
Driver Classname: net.sourceforge.jtds.jdbc.Driver
URL: jdbc:jtds:sqlserver://<database host>:<database port>/<database name> Database User Name: <username>
Password: <password>
Confirm Password: <password>
<database host> は、 デー タ ベースサーバのホ ス ト 名です。 <database port> は、 デー タ ベース接続用ポー ト 番号です。 <database name> は、 デー タ ベース名です。
<username> は、 デー タ ベースに ロ グ イ ン す る ためのユーザ名です。 <password> は、 そのユーザのパスワー ド です。
e. Test data connection フ ォ ームにおいて、 Test Driver Configuration ボ タ ン を ク リ ッ ク す る と 、 “Connection successful” と い う メ ッ セージが表示 さ れます。 表示 さ れない場合は、 上記設定を確認 し て下 さ い。
f. Create and Deploy を ク リ ッ ク し ます。
2. NXJ デー タ リ ポジ ト リ テー ブル を含むデー タ ベース に対す る デー タ ソ ース を作成 し ます。
a. ナ ビ ゲーシ ョ ン ツ リ ーで、 Services Configurations > JDBC を開き、 Data
Sources を ク リ ッ ク し ます。
NXJ リ ポジ ト リ の構成
c. “Configure the data source” フ ォ ームに以下の値を入力 し 、 Continue を ク リ ッ ク し ます。
Name: NXJDS JNDI Name: NXJDS
Honor Global Transactions: (check)
Emulate Two-Phase Commit for non-XA Driver: (check)
d. “Connect to connection pool” フ ォ ームに以下の値を入力 し Continue を ク リ ッ ク し ます。
Pool Name: NXJDSPool
e. “Target the data source” フ ォ ームで、 NXJ ア プ リ ケーシ ョ ン を配備す るサーバ を選択 し 、 Create を ク リ ッ ク し ます。
2.8.4
WebLogic アプ リ ケーシ ョ ンサーバの再起動
2.9
Oracle アプ リ ケーシ ョ ンサーバ （OC4J or 10g）
NXJ ア プ リ ケーシ ョ ン を ホ ス ト す る Oracle ア プ リ ケーシ ョ ンサーバ （OAS） を構成す る には、 oracle NXJ リ ポジ ト リ を示す oracle デー タ ソ ース を構成する必要があ り ます。 注 : 現時点では、 OAS を使用する場合、 Oracle デー タ ベースのみがサ ポー ト さ れています。2.9.1
リ ポジ ト リ テーブルの作成
NXJ リ ポジ ト リ デー タ を リ ポジ ト リ テー ブル を デー タ ベースに作成 し ます。 9 ページの 「Oracle デー タ ベース」 のス テ ッ プ 1 を参照 し て く だ さ い。© Copyright 2008 Unify Corporation
15
3
デー タ ソ ース定義
デー タ ソ ース定義は、 DataSource オブ ジ ェ ク ト を示 し 、 それはデー タ ベース等の特定 のデー タ ソ ースへの物理接続を表 し ています。 ア プ リ ケーシ ョ ンサーバがデー タ ソ ース 定義を持 っ ていない場合は、 NXJ ア プ リ ケーシ ョ ン を配備する こ と はで き ません。 開発環境のア プ リ ケーシ ョ ンサーバは、 ア プ リ ケーシ ョ ンデザ イ ナで自動的に作成 さ れ る デー タ ソ ース定義を使用 し ます。 実行環境が、 開発環境において使用 さ れる同 じ ア プ リ ケーシ ョ ンサーバ イ ン ス タ ン ス を使用す る場合は、 新 し いデー タ ソ ース定義を作成す る必要はあ り ません。 実行環境が異な る ア プ リ ケーシ ョ ンサーバを使用する場合は、 そ のサーバ上に新 し いデー タ ソ ース定義を作成 し なければな り ません。 こ のセ ク シ ョ ンは、 以下のア プ リ ケーシ ョ ンサーバ上でデー タ ソ ース定義を作成す る た めのガ イ ド ラ イ ン を提供 し ます。 • BEA WebLogic ア プ リ ケーシ ョ ンサーバ • IBM WebSphere ア プ リ ケーシ ョ ンサーバ • JBoss ア プ リ ケーシ ョ ンサーバ • Oracle 10g ア プ リ ケーシ ョ ンサーバ3.1
BEA WebLogic アプ リ ケーシ ョ ンサーバ
Unify NXJ の使用に対す る動作保証 さ れた BEA WebLogic のバージ ョ ン については、 『Unify NXJ がサポー ト する構成』 を参照 し て く だ さ い。
1. 該当する JDBC ド ラ イバ フ ァ イル （.zip ま たは .jar） を含める よ う に、 BEA WebLogic CLASSPATH を更新 し ます。
デー タ ソ ース定義
CLASSPATH は、 BEA WebLogic デ フ ォ ル ト サーバを起動す る ス ク リ プ ト に定義 さ れています。 こ のス ク リ プ ト は BEA WebLogic で提供 さ れます。 Windows では “setDomainEnv.cmd”、 UNIX では “setDomainEnv.sh” が こ のス ク リ プ ト に該当 し 、 BEA WebLogic イ ン ス ト ールデ ィ レ ク ト リ に格納 さ れてい ます。 （デ フ ォ ル ト "weblogic81） 注 : Oracle JDBC ド ラ イ バを使用す る場合は、 CLASSPATH 定義文 の先頭に .jar フ ァ イルを追加 し て、 WebLogic が提供する Oracle .jar フ ァ イ ルを使用 し ない よ う に し ます。 2. ア プ リ ケーシ ョ ン に必要なデー タ ソ ースの JDBC Connection Pool を新 し く 構成 し ます。 a. BEA WebLogic デ フ ォ ル ト サーバを起動 し ます。 こ れは NXJ ア プ リ ケーシ ョ ンが配備 さ れたサーバです。 サーバを起動 さ せる方法はい く つかあ り ます。 ”startWebLogic” や ”startManagedWebLogic” のス ク リ プ ト を実行 し ます。 あ る いは Windows の場 合、 ス タ ー ト > プ ログ ラ ム > WebLogic >Start Default Server を選択 し ます。
b. BEA WebLogic Server Console にて、 Services > JDBC > Connection Pools を選択 し ます。
c. Configure a new JDBC Connection Pool を ク リ ッ ク し ます。
d. General パネルで、 デー タ ベース タ イ プ に関す る フ ィ ール ド エ ン ト リ の値を入 力 し ます。
デー タ ベース
タ イ プ フ ィ ール ド 名 フ ィ ール ド エ ン ト リ
IBM DB2 Name <pool name>
URL jdbc:db2:<database name>
Driver Classname COM.ibm.db2.jdbc.app.DB2Driver Properties <user-name> ACLName ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま
IBM Informix Name <pool name>
URL jdbc:informix-sqli://<host>:<port>/<database
name>: INFORMIXSERVER=<database server name>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 ;
<database server name>= デー タ ベースサーバ名 Driver Classname com.informix.jdbc.IfxDriver
Properties user=<user> ACLName ブ ラ ン ク のま ま Password <password>
デー タ ソ ース定義
17
© Copyright 2008 Unify Corporation
Open String Password
ブ ラ ン ク のま ま MS SQL
Server 2000
Name <pool name>
URL jdbc:jtds:sqlserver://<host>:<port>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 Driver Classname net.sourceforge.jtds.jdbc.Driver Properties user=<user> ACLName ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま MySQL Name <pool name>
URL jdbc:mysql://<host>:<port>/<dbname>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 ; <dbname>= デー タ ベース名 Driver Classname com.mysql.jdbc.Driver Properties user = <user > ACL Name ブ ラ ン ク のま ま Password <password> Oracle Name <pool name>
URL jdbc:oracle:thin:@<host>:<port>:<sid>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 ; <sid> = デー タ ベース SID Driver Classname oracle.jdbc.driver.OracleDriver Properties user=<user> ACLName ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま
Sybase Name <pool name>
URL jdbc:sybase:Tds:<host>:<port>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 Driver Classname com.sybase.jdbc2.jdbc.SybDriver デー タ ベース
デー タ ソ ース定義
e. 作成 を ク リ ッ ク し ます。 接続プールが作成 さ れます。
f. DataServer の場合、 以下の方法で プ ロパテ ィ を設定 し ます。 i. 接続 タ ブ を開き ます。
ii. Prepared Statement Cache Size プ ロパテ ィ を 0 に設定 し ます。
iii. 適用 を ク リ ッ ク し ます。 g. タ ーゲ ッ ト タ ブ で、 適切なサーバ名を選択 さ れた列に移動 し ます。 Properties user=<user> ACLName ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま Unify DataServer
Name <pool name>
URL jdbc:simba:<host>:<port>/<DSN>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 ; <DSN>= デー タ ソ ース名
Driver Classname simba.jdbc.SimbaDriver Properties user=<user> ACL Name ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま Unify SQLBase
Name <pool name>
URL jdbc:sqlbase:<host>:<port>/<DSN>
説明 :
<host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 ; <DSN>= デー タ ソ ース名
Driver Classname jdbc.gupta.sqlbase.SqlbaseDriver Properties user=<user> ACL Name ブ ラ ン ク のま ま Password <password> Open String Password ブ ラ ン ク のま ま デー タ ベース タ イ プ フ ィ ール ド 名 フ ィ ール ド エ ン ト リ
デー タ ソ ース定義
19
© Copyright 2008 Unify Corporation
デ フ ォ ル ト のサーバ名は “default” です。
h. 適用 を ク リ ッ ク し ます。
3. 接続プールの JDBC デー タ ソ ース定義を作成 し ます。
a. Services > JDBC > Tx Data Sources を選択 し ます。
b. “ 新 し い JDBC Tx Data Source の コ ン フ ィ グ レ ーシ ョ ン ” を ク リ ッ ク し ます。 c. コ ン フ ィ グ レ ーシ ョ ン タ ブ で、 以下のよ う に入力 し ます。
Name: <data source name> JNDI Name: <data source name> Pool Name: <pool name>
その他の設定はデ フ ォ ル ト のま まに し てお き ます。 d. 作成 を ク リ ッ ク し ます。 e. タ ーゲ ッ ト タ ブ で、 適切なサーバを選択 フ ィ ール ド に移 し ます f. 適用 を ク リ ッ ク し ます。 以上でデー タ ソ ース定義が作成 さ れま し た。 サーバを再起動 し ます。
3.2
IBM WebSphere アプ リ ケーシ ョ ンサーバ
こ の章では、 IBM WebSphere ア プ リ ケーシ ョ ンサーバに関 し ての手順を示 し ます。 Unify NXJ の使用に対す る動作保証 さ れた IBM Websphere のバージ ョ ン については、 『Unify NXJ がサポー ト する構成』 を参照 し て く だ さ い。1. WebSphere Application Server Administrative Console を開 き ます。
デー タ ソ ースは NXJ ア プ リ ケーシ ョ ン を配備する ホス ト 上に作成する必要があ り ま す。
ま た、 デー タ ソ ースにア ク セ ス可能なユーザエ イ リ ア スの リ ス ト を指定する必要が あ り ます。
2. デー タ ベースに J2C 認証デー タ エ ン ト リ を作成 し ます。
a. Security > JAAS Configuration > J2C Authentication Data を選択 し ます。
b. New を ク リ ッ ク し ます。
c. 新規エ ン ト リ の General プ ロパテ ィ で以下の情報を入力 し 、 OK を ク リ ッ ク し ます。
Alias: NXJDS_Credenitials User ID: <username> Password: <password>
<username>/<password> には、 NXJ デー タ ソ ース リ ポジ ト リ テー ブルを持つデー タ ベースへロ グ イ ン す る際に使用す る ユーザ名 / パスワー ド を指定 し ます。 こ れに よ り 、 <node>/NXJDS_Credenitials と い う エ ン ト リ が作成 さ れます。 <node> は WebSphere サーバの ノ ー ド です （通常、 ホ ス ト 名です）。
デー タ ソ ース定義 3. デー タ ソ ース を作成 し ます。 デー タ ソ ース NXJDS は NXJ デー タ リ ポジ ト リ テーブルにア ク セス し ます。 Oracle デー タ ベースの設定 a. ナ ビ ゲーシ ョ ン ツ リ ーで、 Resources > JDBC Providers を選択 し ます。 b. New を ク リ ッ ク し ます。
c. JDBC Providers ド ロ ッ プ ダウ ン リ ス ト か ら User-defined JDBC Driver を選
択 し 、 OK を ク リ ッ ク し ます。
d. 新 し い JDBC Provider の General プ ロパテ ィ テーブルへ以下の情報を入力 し 、
OK を ク リ ッ ク し ます。 Name: JdbcOraWrapper
Description: JDBC provider for the NXJ Data Repository running on Oracle. Classpath: ${UNIFY_HOME}/lib/jdbcDrivers/ojdbc14.jar
${UNIFY_HOME}/lib/jdbcDrivers/JdbcOraWrapper.jar
Implementation Classname: JdbcOraWrapperConnectionPoolDataSource
${UNIFY_HOME} は NXJ が イ ン ス ト ール さ れたデ ィ レ ク ト リ を表 し ます。 ま た は、 WebSphere 変数 （UNIFY_HOME） を NXJ の イ ン ス ト ールデ ィ レ ク ト リ を指すよ う 作成す る と 、 上記のよ う に指定する こ と も可能です。 WebSphere Administrative Console では、 ク ラ スパスの各項目は改行に よ っ て区切る こ と が で き ます。 e. JdbcOraWrapper を ク リ ッ ク し ます。 f. Data Sources を ク リ ッ ク し ます。 g. New を ク リ ッ ク し ます。 h. デー タ ソ ースの General プ ロパテ ィ テーブルに以下の情報を入力 し 、 OK を ク リ ッ ク し ます。 Name: NXJDS JNDI Name: NXJDS
Database Helper Classname:
com.ibm.Websphere.rsadapter.OracleDataStoreHelper
Component-managed Authentication Alias: <node>/NXJDS_Credenitials Container-managed Authentication Alias: <node>/NXJDS_Credenitials
i. NXJDS を ク リ ッ ク し ます。 j. Custom Properties を ク リ ッ ク し ます。 k. New を ク リ ッ ク し ます。 l. General プ ロパテ ィ テーブルに以下の情報を入力 し 、 OK を ク リ ッ ク し ます。 Name: URL Value: jdbc:oracle:thin:@<hostname>:<port>:<sid> <hostname> はデー タ ベースのホ ス ト 名です。 <port> はデー タ ベースのポー ト 番号です （Oracle では通常 1521）。 <sid> はデー タ ベースの SID です。
Microsoft SQL Server デー タ ベースの設定
デー タ ソ ース定義
21
© Copyright 2008 Unify Corporation
c. JDBC Providers ド ロ ッ プ ダウ ン リ ス ト か ら Microsoft JDBC driver for MSSQLServer 2000 を選択 し 、 OK を ク リ ッ ク し ます。
d. JDBC Provider の General プ ロパテ ィ テー ブルへ以下の情報 を入力 し 、 OK を ク リ ッ ク し ます。
Classpath プ ロパテ ィ は MSSQLSERVER_JDBC_DRIVER_PATH （WebSphere 変数） を参照 し ています。 こ のプ ロバ イ ダ でデー タ ソ ース を使用する には、 Environment -> Manage WebSphere Variables を選択 し 、 Microsoft ド ラ イ バを 含むデ ィ レ ク ト リ を指定 し ます。 ま たは、 Classpath プ ロパテ ィ に jar フ ァ イル への絶対パス を用いて指定 し ます。
e. Microsoft JDBC driver for MSSQLServer 2000 を ク リ ッ ク し ます。
f. Data Sources を ク リ ッ ク し ます。 g. New を ク リ ッ ク し ます。 h. デー タ ソ ースの General プ ロパテ ィ テーブルに以下の情報を入力 し 、 OK を ク リ ッ ク し ます。 Name: NXJCCDS JNDI Name: NXJCCDS
Component-managed Authentication Alias: <node>/NXJCCDS server
（Value フ ィ ール ド に入力 し ます） デー タ ベースが 1433 以外のポー ト を使用 し てい る場合、 portNumber リ ン ク を ク リ ッ ク し 、 ポー ト 番号を Value フ ィ ール ド に指定 し 、 OK を ク リ ッ ク し ます。 4. Resouces グルー プ で JDBC Prividers を ク リ ッ ク し ます。 JDBC Providers ページが表示 さ れます。 5. New を ク リ ッ ク し ます。 Configuration 情報が表示 さ れます。 6. General プ ロパテ ィ の ド ロ ッ プ ダウ ン リ ス ト か ら 作成す る JDBC Provider の タ イ プ を選択 し て、 ApplyClick ボ タ ン を押下 し ます。 以下の表は、 Unify NXJ に よ っ てサポー ト さ れる様々なデー タ ベースの タ イ プ を示 し ています。 残 り の General プ ロパテ ィ は、 JDBC プ ロバ イ ダの タ イ プに基づいて 表示 さ れます。 以下の表は、 Unify NXJ での使用において動作保証 さ れた各デー タ ベースに対する推奨 さ れる プ ロパテ ィ の値を記述 し ています。 プ ロバ イ ダ フ ィ ール ド ラ ベル フ ィ ール ド エ ン ト リ DB2 Universal JDBC provider Scope デー タ ソ ースが適用 さ れる ノ ー ド の名前を指定 し ます。 (Type 4) Name DB2 Universal JDBC Driver Provider
Description DB2 Universal JDBC Driver-compliant Provider Classpath ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/ db2jcc_license_cu.jar
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/ db2jcc_license_cisuz.jar
デー タ ソ ース定義
7. Apply を ク リ ッ ク し ます。
8. JDBC Providers ページ で、 Additional プ ロパテ ィ の下の Data Sources を ク リ ッ
Native Library Path ( ブ ラ ン ク ) Implementati on Classname com.ibm.db2.jcc.DB2ConnectionPoolDataSource DB2 Legacy JDBC provider Scope デー タ ソ ースが適用 さ れる ノ ー ド の名前を指定 し ます。
(Type 2) Name DB2 Legacy CLI-based Type 2 JDBC Driver Description DB2 JDBC2-compliant Provider
Classpath ${DB2_JDBC_DRIVER_PATH}/db2java.zip Native Library Path ( ブ ラ ン ク ) Implementati on Classname COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource Informix こ の リ リ ース ではサポー ト さ れていません。 MS SQL Server 2000 こ の リ リ ース ではサポー ト さ れていません。 MySQL こ の リ リ ース ではサポー ト さ れていません。
Sybase JDBC Driver Scope デー タ ソ ースが適用 さ れる ノ ー ド を指定 し ます。 Name Sybase JDBC Driver
Description Sybase JDBC Driver
Classpath ${SYBASE_JDBC_DRIVER_PATH}/jconn2.jar Native Library Path （ブ ラ ン ク ） Implementati on Classname com.sybase.jdbc2.jdbc.SybConnectionPoolDataSource
Oracle JDBC Driver Scope デー タ ソ ースが適用 さ れる ノ ー ド を指定 し ます。 Name Oracle JDBC Driver
Description Oracle JDBC Driver
Classpath ${ORACLE_JDBC_DRIVER_PATH}/ojdbc14.jar Native Library Path （ブ ラ ン ク ） Implementati on Classname oracle.jdbc.pool.OracleConnectionPoolDataSource Unify DataServer こ の リ リ ース ではサポー ト さ れていません。 プ ロバ イ ダ フ ィ ール ド ラ ベル フ ィ ール ド エ ン ト リ
デー タ ソ ース定義
23
© Copyright 2008 Unify Corporation
Data Sources ページがデー タ ベース ド ラ イ バに表示 さ れます。 9. Data Sources ページ で New を ク リ ッ ク し ます。
リ ソ ースのユニー ク な名前を入力 し て、 それがま だ ク リ アに さ れない場合は、 Container managed persistence チ ェ ッ ク ボ ッ ク ス を ク リ ア に し ます。
Component-managed Authentication Alias では、 実行時のデー タ ベース認証のため のエ イ リ ア ス を入力 し ます。 その他の フ ィ ール ド 値が、 生成 さ れます。 10. Apply を ク リ ッ ク し ます。 新 し く 追加 さ れたデー タ ソ ースの構成が表示 さ れます。 11. Additinal プ ロパテ ィ グルー プ で、 Custom プ ロパテ ィ を ク リ ッ ク し ます。 12. 以下の表で要約 さ れる よ う に、 デー タ ベースのプ ロパテ ィ を設定 し ます。 13. Apply を ク リ ッ ク し ます。 14. デー タ ソ ース構成 を保存 し ます。 15. ア プ リ ケーシ ョ ンサーバ を再起動 し ます。 プ ロバ イ ダ タ イ プ フ ィ ール ド ラ ベル フ ィ ール ド エ ン ト リ DB2 JDBC provider (Type 4) databaseName serverName portNumber デー タ ベース名 サーバ名 ポー ト 番号 DB2 JDBC provider (Type 2) databaseName デー タ ベース名 Informix JDBC Driver こ の リ リ ース ではサポー ト さ れていません。 Sybase JDBC Driver databaseName デー タ ベース名 serverName デー タ ベースサーバ名 portNumber デー タ ベースサーバのポー ト Oracle JDBC Thin Driver URL デー タ ソ ースが コ ネ ク シ ョ ン を得るデー タ ベー ス。 MSSQL Server 2000 こ の リ リ ース ではサポー ト さ れていません。 Unify DataServer こ の リ リ ース ではサポー ト さ れていません。
デー タ ソ ース定義
3.3
JBoss アプ リ ケーシ ョ ンサーバ
JBoss ア プ リ ケーシ ョ ンサーバのデー タ ソ ース定義 を作成す る には、 開発環境で使用 さ れる デー タ ソ ース定義を コ ピ ーするか、 ま たは新 し いデー タ ソ ース定義を作成 し ます。 こ のセ ク シ ョ ン では、 こ の 2 つの作業について記述 し ています。 • 既存の JBoss デー タ ソ ース定義を コ ピーする方法 • 新 し い JBoss デー タ ソ ース定義を作成する方法Unify NXJ の使用に対す る動作保証 さ れた JBoss のバージ ョ ン については、 『Unify NXJ がサポー ト する構成』 を参照 し て く だ さ い。
3.3.1
既存の
JBoss デー タ ソ ース定義を コ ピーする
NXJ 開発環境か ら 実行環境に JBoss デー タ ソ ース定義を コ ピ ーす る ス テ ッ プは、 以下 の と お り です。 1. デー タ ソ ース定義を含む XML フ ァ イルの場所を指定 し ます。 JBoss は、 そのデー タ ソ ース定義を XML フ ァ イ ルに格納 し ます。 フ ァ イ ル名 と デ ィ レ ク ト リ は以下の と お り です。 <UNIFY_WORK>\jboss\server\default\deploy\UnifyNXJ-<connection name>-ds.XML. 例えば、 NXJ チ ュ ー ト リ アルア プ リ ケーシ ョ ンの場合、 以下の フ ァ イルがあ り ま す。 <C:\Unify\NXJWork\jboss\server\default\deploy\UnifyNXJ-tutorial-ds.xml 2. プ ロ ダ ク シ ョ ン実行環境に XML フ ァ イルを コ ピー し ます。 フ ァ イルは、 ス テ ッ プ 1 のよ う に同等のパス ですが、 現在のプ ロ ダ ク シ ョ ン実行環 境に配置す る必要があ り ます。 従 っ て、 プ ロ ダ ク シ ョ ン実行環境のホ ス ト で以下の デ ィ レ ク ト リ に フ ァ イルを配置 し ます。 <JBOSS_HOME>\server\default\deploy\<yourXMLfile> 3. 必要に応 じ て、 フ ァ イルを編集 し ます。 必要であれば、 ユーザ名 と パスワー ド を入力する こ と がで き ます。 ま た異な る JDBC ド ラ イ バを使用す る場合は、 こ こ に登録 し ます。 接続名を変更 し ないで下 さ い。 例 : <?xml version="1.0" encoding="UTF-8" ?> <datasources> <local-tx-datasource> <jndi-name>tutorial</jndi-name> <connection-url>jdbc:csv:C:/Unify/NXJWork/projects/ tutorials/databases/inet/db</connection-url> <driver-class>com.inet.csv.CsvDriver</driver-class> <user-name />デー タ ソ ース定義
25
© Copyright 2008 Unify Corporation
<password /> </local-tx-datasource> </datasources> 4. JBoss イ ン ス ト ールデ ィ レ ク ト リ に JDBC ド ラ イ バを コ ピ ー し ます。 NXJ イ ン ス ト ールは、 サポー ト さ れる JDBC ド ラ イ バのサブ セ ッ ト のみ を含みま す。 DBMS ド ラ イバが含まれるかど う かを確認する ために、 『Unify NXJ 開発者ガ イ ド 』 の第 3 章の 3.2 を確認 し て く だ さ い。 DBMS ド ラ イバが含まれていない場合、 それを取得 し ます。 JDBC ド ラ イ バの .zip あ る いは .jar フ ァ イ ルを以下に コ ピ ー し ます。 <JBossInstallDir>/server/<serverName>/lib 説明 ： <JBossInstallDir> は、 JBoss が イ ン ス ト ール さ れてい る場所で、 <serverName> は、 JBoss サーバの名称です。 JDBC ド ラ イ バを コ ピ ーす る場所は、 『Unify NXJ 開発者ガ イ ド 』 の第 3 章の 「プ ロ ジ ェ ク ト の作成」 に記述 さ れています。 5. DB2 デー タ ベース を使用す る場合は、 JBoss 起動ス ク リ プ ト を変更す る必要があ り
ます。 Windows の場合は run.bat、 UNIX の場合は run.sh を変更 し て DB2 ク ラ スパ ス を追加 し ます。 Windows の run.bat では set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;%JAVAC_JAR%;%RUNJAR% の後に以下の行を追加 し ます。 set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;<SQLLIB>/java/ db2java.zip UNIX の run.sh では JAVA_OPTS="$JAVA_OPTS -Dprogram.name=$PROGNAME" の前に以下の行を追加 し ます。 JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<SQLLIB>/java/db2java.zip 説明 ： <SQLLIB> は、 DB2 が イ ン ス ト ール さ れてい る場所です。 こ の作業の実行後、 サーバで JDBC ド ラ イバ ク ラ スが利用で き る よ う にする ために JBoss サーバを再起動 し ます。
3.3.2
新 し いデー タ ソ ース定義
XML フ ァ イルを
作成する
1. テキス ト エデ ィ タ で -ds.xml フ ァ イルを作成 し ます。 以下のテ ン プ レ ー ト を エデ ィ タ に コ ピ ーす る こ と がで き ます。 -ds.xml フ ァ イルの 構文は以下の と お り です。デー タ ソ ース定義 <datasources> <local-tx-datasource> <jndi-name>yourDataSourceName</jndi-name> <connection-url>yourJdbcURL</connection-url> <driver-class>yourJdbcDriverClass</driver-class> <user-name>yourUserName</user-name> <password>yourPassword</password> </local-tx-datasource> </datasources> 説明 : yourDataSourceName は、 デー タ ソ ースの名称です。 yourJdbcURL は、 JDBC URL です （以下の表 を参照）。 yourJdbcDriverClass は、 ド ラ イ バの ク ラ ス名です （以下の表を参照）。 yourUserName は、 接続の確立に使用す る ユーザです。 yourPassword は、 接続の確立に使用す るパスワー ド です。 デー タ ベース名 ド ラ イバ URL IBM DB2 COM.ibm.db2.jdbc.app. DB2Driver jdbc:db2:<database name> 説明 : <database name> = デー タ ベース ID IBM Informix com.informix.jdbc.IfxDrive r jdbc:informix-sqli: //<host>:<port>/<database name>:
INFORMIXSERVER=<database server name> 説明 : <host>= ホス ト 名 ;
<port>= デー タ ベースポー ト 番号 <database name>= デー タ ベース名 <database server name>= デー タ サーバ名 MS SQL Server 2000 net.sourceforge.jtds.jdbc. Driver jdbc:jtds:sqlserver://<host>:<port> 説明 : <host> = ホス ト 名 <port> = デー タ ベースポー ト 番号 MySQL com.mysql.jdbc.Driver 以下のサ イ ト か ら ド ラ イ バを ダウ ン ロ ー ド し て <UNIFY_HOME>\lib\ jdbcDrivers\ に イ ン ス ト ー ルする必要があ り ます。 http://www.mysql.com/ downloads/api-idebc-stable.html jdbc:mysql://<host>:<port>/<dbname> 説明 : <host>= ホス ト 名 ; <port>= デー タ ベースポー ト 番号 ; <dbname>= デー タ ベース名 Oracle oracle.jdbc.driver. OracleDriver jdbc:oracle:thin:@<host>:<port>:<SID> 説明 : <host> = ホス ト 名 <port> = デー タ ベースポー ト 番号 <SID> = デー タ ベース SID
デー タ ソ ース定義
27
© Copyright 2008 Unify Corporation
2. サーバの deploy デ ィ レ ク ト リ にそれを コ ピーする こ と で、 こ の フ ァ イルを配備 し ます。 <JBossInstallDir>/server/<serverName>/deploy 説明 : <JBossInstallDir> は、 JBoss が イ ン ス ト ール さ れてい る場所です。 <serverName> は、 JBoss サーバの名称です。 3. JBoss サーバを再起動 し ます。 こ れで、 デー タ ソ ースの定義が完了 し ます。
3.4
Oracle Application Server 10g
Unify NXJ の使用に対す る動作保証 さ れた OracleAS のバージ ョ ン については、 『Unify NXJ がサポー ト す る構成』 を参照 し て く だ さ い。
デー タ ソ ースの定義方法は、 使用 し てい る Oracle Application サーバの タ イ プ （OC4J ま たは Enterprise Edition） に よ っ て異な り ます。
3.4.1
OC4J
1. コ マ ン ド ウ ィ ン ド ウ を開き ます。
2. <Oracle installation directory>/j2ee/<server name>デ ィ レ ク ト リ に移動 し ます。 説明 :
<Oracle installation directory> は、 Oracle9iAS Containers for J2EE （OC4J） が イ ン ス ト ール さ れてい る デ ィ レ ク ト リ の名称です。 SQL Base jdbc.gupta.sqlbase.Sqlbas eDriver jdbc:sqlbase://<host>:<port>/<dbname> 説明 : <host>= ホス ト 名 ; <port>= デー タ ベースポー ト 番号 <dbname>= デー タ ベースの名前 Sybase com.sybase.jdbc2. jdbc.SybDriver jdbc:sybase:Tds:<host>:<port> 説明 : <host> = ホス ト 名 <port> = デー タ ベースポー ト 番号 Unify DataServer simba.jdbc.SimbaDriver jdbc:simba:<host>:<port>/<DSN> 説明 : <host> = ホス ト 名 <port> = デー タ ベースポー ト 番号 <DSN> = デー タ ソ ース名 デー タ ベース名 ド ラ イバ URL
デー タ ソ ース定義
<server name> はア プ リ ケーシ ョ ンサーバの名称で、 デ フ ォ ル ト の名称は Unify NXJ ア プ リ ケーシ ョ ンサーバのデ フ ォ ル ト の イ ン ス タ ン ス であ る “home” です。 3. ア プ リ ケーシ ョ ンサーバを起動する ために、 java -jar oc4j.jar コ マ ン ド を入
力 し ます。 4. 新 し い コ マ ン ド ウ ィ ン ド ウ を開き、 ス テ ッ プ 2 にア ク セス し て<Oracle installation directory>/j2ee/<server name> デ ィ レ ク ト リ に移動 し ます。 5. config/rmi.xml フ ァ イ ルを開 き、 rmi-server ポー ト を確認 し ます。 こ の <port number> はス テ ッ プ 6 で使用 し ます。 6. 以下の java コ マ ン ド を入力 し 、 デ フ ォル ト サーバにデー タ ソ ース を イ ン ス ト ール し ます。 コ マ ン ド の大文字 と 小文字は区別 さ れます。
% java -jar admin.jar ormi://<localhost>:<port number> admin <administrative password> -application default -installDataSource -className com.evermind.sql.OrionCMTDataSource -url jdbc:oracle:thin:@<host>:<port>:<sid> -connectionDriver oracle.jdbc.OracleDriver -location <data source name>
-username <database username> -password <database password> 説明 :
<localhost> は、 ORMI ホ ス ト です。 <port number> は、 ORMI ポー ト です。
<administrative password> は、 ORMI 管理パス ワー ド です。 <host> は、 デー タ ベースのホ ス ト 名です。
<port> は、 デー タ ベース に接続す る ためのポー ト 番号です。 <sid> は、 デー タ ベース シ ス テム ID です。
<data source name> は、 作成す る デー タ ベース定義の名称です。 className は、 デー タ ソ ース を実装す る ク ラ スの名称です。 url は、 デー タ ベース接続の URL です。 connectionDriver は、 こ のデー タ ソ ースの JDBC ド ラ イ バの ク ラ ス名です。 location は、 デー タ ソ ースオ ブ ジ ェ ク ト の JNDI 論理名です。 username は、 接続先スキーマの名称です （オ プ シ ョ ン）。 password は、 接続先スキーマのパスワー ド です （オ プ シ ョ ン）。 以上でデー タ ソ ースが作成 さ れま し た。
デー タ ソ ース定義
29
© Copyright 2008 Unify Corporation
3.4.2
Enterprise Edition
Appllication Server Control ページの J2EE Applications リ ン ク を ク リ ッ ク し ます。
1. default を ク リ ッ ク し ます。
2. Resources リ ス ト 以下にあ る、 Data Sources を ク リ ッ ク し ます。
3. こ のア プ リ ケーシ ョ ンサーバ イ ン ス タ ン ス用のデー タ ソ ース定義が既に存在する場 合には、 Create Like を ク リ ッ ク し て下 さ い。 デー タ ソ ース定義が無い場合は、 Create を ク リ ッ ク し ます。 定義する デー タ ソ ースに応 じ てページの各項目を指定 し て下 さ い。 詳細について は、 Oracle 10g の ド キ ュ メ ン ト を参照 し て く だ さ い。 4. ページの一番下で、 Create を ク リ ッ ク し ます。 デー タ ソ ースが作成 さ れます。
4 NXJ
-
ア プ リ ケーシ ョ ンサーバの
構成
こ の ド キ ュ メ ン ト は、 以下のア プ リ ケーシ ョ ンサーバの NXJ フ ォ ームア プ リ ケーシ ョ ン を配備す る ための構成ガ イ ド ラ イ ン を提供 し ます。 • JBoss ア プ リ ケーシ ョ ンサーバ • IBM WebSphere ア プ リ ケーシ ョ ンサーバ • WebLogic ア プ リ ケーシ ョ ンサーバ • Oracle 10g ア プ リ ケーシ ョ ンサーバ4.1
JBoss - NXJ の構成
こ の説明は、 ス タ ン ド ア ロ ー ン JBoss ア プ リ ケーシ ョ ン マ シ ン用です。 動作保証 さ れ た JBoss ア プ リ ケーシ ョ ンサーバについては、 『UNIFY NXJ がサポー ト する構成』 を参 照 し て く だ さ い。注 : NXJ Developer または NXJ Enterprise Developer にバン ド ル さ れて いる JBoss の場合、 予め設定 さ れています。
注 : jboss4.2.2GA を使用す る ために以下を設定 し ます。
Windows イ ン ス ト ール − run.bat -b 0.0.0.0 Unix イ ン ス ト ール − run.sh -b 0.0.0.0
NXJ Developer と NXJ Enterprise Developer の 2 種類の構成があ り ますので、 使用す る 製品の構成を行 っ て く だ さ い。
（NXJ Developer につ き ま し ては、 2010 年 1 月現在、 日本国内では販売 し てお り ませ ん。 NXJ Enterprise Developer に関する記載を参照 し て く だ さ い。）
