WebOTX V6 JDBCアプリケーションのトラブルシューティング（JDBC ...

WebOTX V6 JDBC アプリケーション
のトラブルシューティング
(JDBC データソース)
2006 年 12 月 初 版
改 版 履 歴
i

目 次
1 はじめに ........................................................................................................................1
2 障 害 の 切 り 分 け 方 法 ......................................................................................................1
3 障 害 発 生 時 の 対 処 ..........................................................................................................2
3.1 Oracleデータベースリンク 利 用 時 のトランザクション 障 害 への 対 応 ....................2
3.2 Oracleデータベースリンクの 再 接 続 障 害 への 対 応 .................................................4
3.3 JDBCデータソースの 設 定 変 更 が 効 かない 現 象 への 対 応 .......................................6
ii

1 はじめに
本 資 料 では、WebOTX の JDBC アプリケーションで 発 生 する 障 害 の 中 から、 比 較 的 発 生
しやすい 障 害 への 対 処 方 法 を、 最 近 の 事 例 をもとに 説 明 しています。
なお 本 資 料 は WebOTX Ver6 を 対 象 としています。Ver5 以 前 には 適 用 できませんので 注
意 してください。
2 障 害 の 切 り 分 け 方 法
WebOTX では、JDBC ドライバの 実 装 を 提 供 していませんので、データベースベンダや
JDBC ドライバベンダが 提 供 する JDBC ドライバをご 利 用 いただく 必 要 があります。JDBC
アプリケーションで 障 害 が 発 生 した 場 合 には、JDBC ドライバに 起 因 する 問 題 なのか、
WebOTX や JDBC アプリケーションの 問 題 なのかを 切 り 分 けたうえで、 原 因 を 究 明 してい
ただく 必 要 があります。
WebOTX の JDBC コネクションプール 機 能 である JDBC データソースでは、JDBC ドラ
イバから 受 け 取 った java.sql.SQLException をそのままアプリケーションに 返 却 します。
WebOTX の 内 部 で 障 害 が 発 生 した 場 合 には、 次 の 文 字 列 で 始 まるメッセージを 格 納 した
java.sql.SQLException を 返 却 します。
“[NEC][WOJDBC]”
アプリケーションが 上 記 の 文 字 列 を 含 まない java.sql.SQLException を 受 け 取 った 場 合
は、JDBC ドライバのオンラインマニュアルを 参 照 していただくか、または、JDBC ドラ
イバのサポート 部 門 にお 問 い 合 わせください。
本 書 で 説 明 するログファイルは、それぞれ 次 の 場 所 に 出 力 されます。
・ server.log( 標 準 出 力 用 )
/domains/ドメイン 名 /logs/server.log
・ webotx_agent.log(ドメインのエージェント 用 )
/domains/ドメイン 名 /logs/webotx_agent.log
・ プロセスグループのログファイル(Enterprise Edition, Standard Edition のみ)
/domains/ドメイン 名 /logs/tpsystem
///..log
1

3 障 害 発 生 時 の 対 処
3.1 Oracle データベースリンク 利 用 時 のトランザクション 障 害 への 対 応
事 象 説 明
J2EE のトランザクションに 参 加 するアプリケーションからデータベースリンクを 利 用
する SQL 命 令 を 実 行 した 際 に、java.sql.SQLException が 発 生 します。
状 況 の 確 認 方 法
アプリケーションでログ 出 力 を 抑 止 していなければ、 以 下 のいずれかのログファイルに、
次 のメッセージが 出 力 されます。
【ログファイル】アプリケーションのログファイル、server.log、webotx_agent.log、
プロセスグループのログファイル。
【メッセージ】 ORA-24777: 移 行 できないデータベースリンクは 使 用 できません
復 旧 方 法
この 障 害 は、Oracle の 仕 様 ( 制 限 事 項 )で 発 生 します。JDBC データソースの 属 性 のうち、
データソースの 種 類 [dataSourceType]を JDBC API[JDBC]に 変 更 することで 回 避 すること
ができます。 変 更 は、 次 の 二 つの 方 法 のいずれかで 行 います。
・ 統 合 運 用 管 理 ツールを 使 用 する 場 合 、 対 象 の「JDBC データソース」を 選 択 し、 右
側 の 属 性 画 面 の 一 般 タブで、データソースの 種 類 として「JDBC API」を 選 択 します。
2

・ 運 用 管 理 コマンドを 使 用 する 場 合 、 次 のコマンドを 実 行 します。
otxadmin> set server.resources.jdbc-datasource..dataSourceType=JDBC
なお、 上 記 の 回 避 を 行 う 場 合 は、2フェーズコミットを 行 う 上 で 以 下 の 制 限 事 項 があり
ますので、ご 注 意 ください。
[6.3 より 前 のバージョン]
JDBC API を 利 用 する JDBC データソースを2フェーズコミットのトランザクション
内 で 利 用 することはできません。データソースの 種 類 を 変 更 した JDBC データソースを
別 のトランザクション 内 で 利 用 してください。
[6.3 以 降 のバージョン]
JDBC API を 利 用 する 複 数 の JDBC データソースを、2フェーズコミットのトランザ
クション 内 で、 同 時 に 利 用 することはできません。1つのデータソースの 設 定 を 変 更 す
る 場 合 には 問 題 ありませんが、 複 数 のデータソースの 設 定 を 変 更 する 必 要 がある 場 合 は、
それぞれを 別 のトランザクション 内 で 利 用 してください。
3

3.2 Oracle データベースリンクの 再 接 続 障 害 への 対 応
事 象 説 明
データベースリンクのリンク 先 のデータベースサーバを 再 起 動 後 、データベースリンク
を 使 用 する SQL 命 令 を 実 行 すると、java.sql.SQLException が 発 生 し 続 けます。
状 況 の 確 認 方 法
アプリケーションでログ 出 力 を 抑 止 していなければ、 以 下 のいずれかのログファイルに、
次 のメッセージが 出 力 されます。
【ログファイル】アプリケーションのログファイル、server.log、webotx_agent.log、
プロセスグループのログファイル。
【メッセージ】 ORA-2068やORA-3113、ORA-24778といったOracleのエラー 番 号
復 旧 方 法
a) 運 用 操 作 によるJDBCコネクションの 切 断
復 旧 するためには、JDBCデータソース 内 にプール 管 理 している 全 てのJDBCコネクシ
ョンを 切 断 する 必 要 があります。データベースリンク 先 のデータベースサーバを 再 起 動
する 度 に、 次 の 操 作 またはコマンドを、ドメイン 毎 に 実 行 してください。
・ 統 合 運 用 管 理 ツールを 使 用 する 場 合 、「JDBC データソース」を 選 択 し、 右 クリック
メニューから、「すべての JDBC データソースでプールされたコネクションの 切 断 」
を 実 行 してください。
4

・ 運 用 管 理 コマンドを 使 用 する 場 合 、 次 のコマンドを 実 行 します。
otxadmin> reset-all-jdbc-datasources
b) データベースサーバの 状 態 監 視 機 能 の 利 用
データベースサーバの 監 視 コマンド[checkServerCommand]として、データベースリ
ンクを 使 用 するSQL 命 令 を 指 定 してください。ただし、 性 能 が 若 干 低 下 する 可 能 性 があ
る 点 にご 注 意 ください。
・ 統 合 運 用 管 理 ツールを 使 用 する 場 合 、 対 象 の JDBC データソースを 選 択 し、 右 側 の
属 性 画 面 の 拡 張 タブで、データベースサーバの 状 態 監 視 オプション
[checkServerOption]でオプションを 選 択 し、データベースサーバの 状 態 監 視 コマン
ド[checkServerCommand]で、 監 視 を 行 う SQL 命 令 を 指 定 します。
・ 運 用 管 理 コマンドを 使 用 する 場 合 、 次 のコマンドを 実 行 します。
otxadmin> set server.resources.jdbc-datasource..checkServerOption=method
otxadmin> set server.resources.jdbc-datasource..checkServerCommand="select * from dual"
5

3.3 JDBC データソースの 設 定 変 更 が 効 かない 現 象 への 対 応
事 象 説 明
domain.xml の JDBC データソースの 定 義 をエディタ 等 で 修 正 した 場 合 、 変 更 した 値 が
JDBC データソースの 動 作 に 反 映 されません。
状 況 の 確 認 方 法
domain.xmlの 内 容 と、 次 のディレクトリに 格 納 されているプロパティファイルの 内 容 を
比 較 して、 相 違 が 無 いか 確 認 してください。JDBCデータソースの 動 作 時 に 使 用 される 設 定
値 は、 次 のディレクトリ 配 下 にあるプロパティファイルに 格 納 されています。
/domains/ドメイン 名 /config/jndisp/datasources
domain.xml とプロパティファイルの 内 容 ( 例 )は、 次 の 通 りです。 同 じ 名 前 の 値 を 比 較
してください。ただし、プロパティファイルの poolCount は、minPoolSize に 読 み 替 えて
ください。
プロパティファイルが 複 数 存 在 する 場 合 は、jndiName の 値 を 確 認 して、 確 認 すべきプロ
パティファイルを 特 定 してください。
:
【1.properties】
#Wed Dec 01 12:00:00 JST 2006
poolCount=4
dataSourceName=jdbc¥:oracle¥:thin¥:@localhost¥:1521¥:orcl
jndiName=jdbc/Oracle
jdbcMajorVersion=3
useStaticPool=true
useJTA=true
userName=scott
password=tiger
dataSourceType=JDBCEX_Oracle
6

復 旧 方 法
設 定 を 変 更 する 時 は、JNDI サーバへの 登 録 処 理 を 行 う 必 要 があるため、 必 ず、 統 合 運 用
管 理 ツールか、 運 用 管 理 コマンドの set コマンドで 変 更 してください。ただし、 同 じ 値 を 再
設 定 しても JDBC データソースの 動 作 には 反 映 されません。いったん JDBC データソース
の 設 定 値 を 違 う 値 に 変 更 後 、 変 更 しようとしていた 値 を 設 定 し 直 してください。
例 えば、domain.xml の minPoolSize を 10 に 変 更 していた 場 合 、 運 用 管 理 コマンドで、
次 のように、 違 う 値 (12)をいったん 設 定 した 後 で、 変 更 しようとしていた 値 (10)を 設
定 し 直 してください。
otxadmin> set server.resources.jdbc-datasource..minPoolSize=12
otxadmin> set server.resources.jdbc-datasource..minPoolSize=10
7