5. インストール・アンインストールに関するトラブルシューティング

本章では、インストールやアンインストール時に発生する障害とその対処方法について説明します。

5.1. バッチドメイン作成失敗時の対処方法

Derbyのセットアップに失敗

setupDomain createコマンド実行時に使用されるコンフィグファイル(<domainName>.properties) 中のパラメータ webotx.batch.setup.derby.enabled=true の状態でsetupDomainコマンドを実行した時に、以下のようなエラーメッセージが出力された場合はDerbyのセットアップに失敗している可能性があります。

(Derbyのセットアップに失敗した例)

[root@localhost batch]# ./setupDomain.sh create --edition Standard batchsv1
2011/06/07 12:26:47 028  INFO  main SetupDomainCommand - [BS240342017] ドメイン batchsv1 Standard edition を作成しています。少々お待ちください。
2011/06/07 12:26:51 210  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [createDomainFlowStep] COMPLETED
2011/06/07 12:27:59 412  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [configDomainFlowStep] COMPLETED
2011/06/07 12:28:14 909  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [startDomainStep] COMPLETED
2011/06/07 12:28:17 119  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [registerDataSourceStep] COMPLETED
2011/06/07 12:28:19 535  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [defaultDataSourceStep] COMPLETED
2011/06/07 12:28:19 611 ERROR  main SetupDomainCommand - [BS240322018] Derbyのセットアップに失敗しました。指定されているsampleDBはDerbyのセットアップに使用できません。ドメイン作成コンフィグファイルの内容を見直して、再度setupDomainを実行してください。
2011/06/07 12:28:23 828  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [errorStopDomainStep] COMPLETED
2011/06/07 12:28:23 963 ERROR  main SetupDomainCommand - [BS240322005] ドメイン batchsv1 のセットアップに失敗しました。
Exit Code = 1
[root@localhost batch]# 

この場合、作成されたバッチドメインは不完全な状態ですので、作成されたバッチドメインを削除して、再度setupDomain createコマンドを実行する必要があります。
コンフィグファイル(<domainName>.properties) のパラメータ webotx.batch.setup.jobrepository.database=<DB情報識別名> として指定したデータソースの定義が正しいことを 確認してください。また、webotx.batch.database.<DB情報識別名>.dbType=derby となっていることを 確認してください。

以上を確認のうえ、setupDomain deleteによってバッチドメインを削除した後に、再度setupDomain createを実行してください。

ジョブリポジトリのセットアップに失敗

コンフィグファイル(<domainName>.properties) のパラメータ webotx.batch.setup.jobrepository.create=true の状態でsetupDomain createコマンドを実行した時に、以下のようなエラーメッセージが出力された場合は ジョブリポジトリのセットアップに失敗している可能性があります。

(ジョブリポジトリのセットアップに失敗した例)

[root@localhost batch]# ./setupDomain.sh create --edition Standard batchsv1
2011/06/07 12:33:36 691  INFO  main SetupDomainCommand - [BS240342017] ドメイン batchsv1 Standard edition を作成しています。少々お待ちください。
2011/06/07 12:33:40 846  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [createDomainFlowStep] COMPLETED
2011/06/07 12:34:50 399  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [configDomainFlowStep] COMPLETED
2011/06/07 12:35:06 383  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [startDomainStep] COMPLETED
2011/06/07 12:35:09 444 ERROR executor-1 ExternalCommandExecutor - [BS240120114] コマンド実行に失敗しました。コマンド名:/opt/WebOTX/bin/otxadmin 引数[create-jdbc-datasource, --user, bsadmin, --password, adminadmin, --port, 6312, --serverName, 127.0.0.2, --jdbcPassword, bsadmin, --dataSourceName, REPO, --jdbcUserName, bsadmin, --jdbcMajorVersion, 4, --useJTA=true, --portNumber, 1527, --dataSourceType, JDBCEX_Derby, jdbc/default] 戻り値:1
2011/06/07 12:35:09 955  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [registerDataSourceStep] COMPLETED
2011/06/07 12:35:11 816  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [defaultDataSourceStep] COMPLETED
2011/06/07 12:35:12 822  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [derbyFlowStep] COMPLETED
2011/06/07 12:35:17 394  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [dbControllerStep] COMPLETED
2011/06/07 12:35:20 021 ERROR  main SetupDomainCommand - [BS240322003] コマンドが正常に終了しませんでした : exitCode = 7 ;  /opt/WebOTX/batch/bin/repoadmin.sh:[setup, --user, bsadmin, --password, **********, --port, 6312, --dbtype, derby, --jndiName, jdbc/default]
2011/06/07 12:35:20 022  INFO  main SetupDomainCommand - [BS240349106] コマンド(/opt/WebOTX/batch/bin/repoadmin.sh) 標準出力 : 
2011/06/07 12:35:18 577  INFO  main RepoAdminCommand - [BS240348001] repoadmin setup の処理を開始します
2011/06/07 12:35:19 166 ERROR  main RepoAdminCommand - [BS240328106] データソースに定義されているデータベースへの接続に失敗しました
Exit Code = 7

2011/06/07 12:35:20 022  INFO  main SetupDomainCommand - [BS240349107] コマンド(/opt/WebOTX/batch/bin/repoadmin.sh) 標準エラー出力 : 

2011/06/07 12:35:20 025 ERROR  main SetupDomainCommand - [BS240329111] ステップ実行失敗 : [repoadminStep] FAILED : description=com.nec.webotx.batch.core.tools.SystemCommandItemProcessor$CommandProcessorExecutionException: exitCode = 7 ;  /opt/WebOTX/batch/bin/repoadmin.sh:[setup, --user, bsadmin, --password, **********, --port, 6312, --dbtype, derby, --jndiName, jdbc/default]

[BS240349106] コマンド(/opt/WebOTX/batch/bin/repoadmin.sh) 標準出力 : 
2011/06/07 12:35:18 577  INFO  main RepoAdminCommand - [BS240348001] repoadmin setup の処理を開始します
2011/06/07 12:35:19 166 ERROR  main RepoAdminCommand - [BS240328106] データソースに定義されているデータベースへの接続に失敗しました
Exit Code = 7

[BS240349107] コマンド(/opt/WebOTX/batch/bin/repoadmin.sh) 標準エラー出力 : 


2011/06/07 12:35:20 254 ERROR  main SetupDomainCommand - [BS240322019] ジョブリポジトリの作成に失敗しました。ジョブリポジトリ作成対象のDBの状態を見直して、repoadmin コマンドを実行してジョブリポジトリの作成を行ってください。
2011/06/07 12:35:23 201  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [setupServerPolicyBeforeError] COMPLETED
2011/06/07 12:35:26 657  INFO  main SetupDomainCommand - [BS240349109] ステップを実行しました : [errorStopDomainStep] COMPLETED
2011/06/07 12:35:26 971 ERROR  main SetupDomainCommand - [BS240322005] ドメイン batchsv1 のセットアップに失敗しました。
Exit Code = 1
[root@localhost batch]# 

この場合、ジョブリポジトリの作成には失敗していますが、バッチドメインの作成には成功しています。したがって、setupDomainコマンドで バッチドメインを再作成せずに、 repoadmin コマンドによって、ジョブリポジトリのみを再度セットアップすることも可能です。

参照