セットアップまたはアンセットアップを実行しているときに，障害が発生したときの障害の調査手順について次の図に示します。

図7-17　障害の調査手順（セットアップまたはアンセットアップ時）

セットアップまたはアンセットアップでエラーが発生した場合，最初にコマンドの応答でコンソールに出力されるメッセージを確認します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報としてKDECで始まるメッセージが含まれている場合，「11.　メッセージ」を確認して，対処します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，KDEC以外で始まるメッセージが含まれている場合，各メッセージに対応したマニュアルを参照して対処します（例えば，KDJEメッセージが含まれている場合は，マニュアル「Cosminexus メッセージ1」を参照します）。具体例を次に示します。

コマンド応答のメッセージ

エラーメッセージの中に，詳細情報として別のメッセージが出力されます。

要因が特定できない場合は，取得しているメッセージログを参照します。セットアップまたはアンセットアップ実行時に参照する障害情報は，次のメッセージログです。詳細については，「7.4.1　メッセージログ」を参照してください。

• HCSC-Managerのログ
• Cosminexusの統合メッセージログ

障害が発生した原因は，コマンド実行以前の環境設定やシステムの状態でエラーとなることもあるため，コマンド応答のメッセージを出力している個所の前後を確認し，ほかにエラーメッセージが出ていないか確認して対策します。

なお，メッセージログの内容を確認するときに，コンソールに出力されたメッセージが重複して出力されていることもあるため，適宜実行時間を確認します。

ここでは，セットアップまたはアンセットアップ実行での代表的な障害とその対処方法について説明します。代表的な障害とその対処方法を次の表に示します。

表7-34　代表的な障害とその対処方法（セットアップまたはアンセットアップ時の障害調査）

手順（流れ）		代表的な障害	考えられる要因	対策	参照先
実行環境に必要なソフトウェアの設定	データベースのサーバ側のセットアップ	権限の設定ができない	データベース定義ユティリティ（pddef），SQL Executerのパスが設定されていません。	データベース定義ユティリティ（pddef），SQL Executerのパスを設定します。	−
	Cosminexus Managerのセットアップ	Cosminexus Managerが起動しない	mserver.propertiesの書式が誤っています。	mserver.propertiesを見直します。	3.1.2※1
			mserver.cfgの書式が誤っています。	mserver.cfgを見直します。
		Management Serverと運用管理エージェントが自動起動しない	Management Serverと運用管理エージェントを自動起動するように設定されていません。	Management Serverと運用管理エージェントを自動起動するように設定します。
		運用管理エージェントが起動しない	adminagent.cfgの書式が誤っています。	adminagent.cfgを見直します。	−
		MBeanの起動確認で，KEOS27010-Iメッセージが出力されない	Cosminexusインストールディレクトリ>\manager\mbean-plugins配下に，定義ファイルおよびjarが存在しません。	<Cosminexusインストールディレクトリ>\CSC\mbean-plugins配下のファイルを，<Cosminexusインストールディレクトリ>\manager\mbean-pluginsにコピーします。	3.1.2※1
	PRFのセットアップ	−	−	−	−
	J2EEサーバのセットアップ	J2EEサーバが起動しない	J2EEサーバのシステム環境変数が正しく設定されていません。	J2EEサーバのシステム環境変数を見直します。	−
	Hitachi Web Serverのセットアップ	−	−	−	−
	データベースのクライアント側のセットアップ	−	−	−	−
	JDBCドライバのセットアップ	−	−	−	−
	DB Connectorのセットアップ	DB Connectorのcjstartrarやcjtestres実行時にエラーが発生する	DB関連の問題です。 HiRDB未起動 HiRDBのコネクション不足 HiRDBのホスト名やIPアドレス，ポート番号の誤り HiRDBのユーザ名やパスワードの誤り	HiRDBが起動しているかどうか確認します。 HiRDBのコネクション不足の場合は，次のどちらかを実施します。 (1) %PDDIR%\CONF\pdsysのpd_max_usersを50程度に変更します。 (2) DB Connectorの定義やCosminexus RMのコンフィグレーションプロパティのMinPoolSizeを小さくします。 DB Connectorの定義を参照し，ホスト名やIPアドレス，ポート番号に誤りがないか確認します。 HiRDBのユーザ名やパスワードの誤りがないか確認します。	−
		UNIX/Linux環境で，DB Connectorに対してcjstartrarやcjtestres実行時にエラーが発生する KDJE37360-E KDJE48516-E （理由でjavax.resource.ResourceException: KDJE50018-E）	Linuxの場合はLD_LIBRARY_PATH，AIXの場合はLIBPATHに次のパスが設定されていません。 (1) DABrokerのパス /opt/DABroker/lib (2) HiRDBクライアント製品のパス /opt/HiRDB/client/lib (3) HiRDBサーバ製品のパス $PDDIR/client/lib	Linuxの場合はLD_LIBRARY_PATH，AIXの場合はLIBPATHに左記のパスを設定します。 なお，(1)はDABroker経由で接続する場合に必要です。 (2)と(3)はHiRDBに接続するときに，PPのインストール状況に応じて，どちらか一方を設定します。	3.1.2※1
	Cosminexus RMのセットアップ	DB Connectorのcjstartrarやcjtestres実行時にエラーが発生する	DB関連の問題です。 HiRDB未起動 HiRDBのコネクション不足 HiRDBのホスト名やIPアドレス，ポート番号の誤り HiRDBのユーザ名やパスワードの誤り。	HiRDBが起動しているかどうか確認します。 HiRDBのコネクション不足の場合は，次のどちらかを実施します。 (1) %PDDIR%\CONF\pdsysのpd_max_usersを50程度に変更します。 (2) DB Connectorの定義やCosmiRMのコンフィグレーションプロパティのMinPoolSizeを小さくします。 DB Connectorの定義を参照し，ホスト名やIPアドレス，ポート番号，ユーザ名やパスワードに誤りがないか確認します。	3.1.2※1
		Cosminexus RMの起動，またはJ2EEサーバの起動時に，KDJE48213-Wが出力される	Cosminexus RMのコンフィグレーションプロパティに指定しているキュー定義ファイルの記述が誤っています。	Cosminexusサービスプラットフォームの07-50を利用している場合，Cosminexus RMのコンフィグレーションプロパティのQueueConfigFileNameは指定不要です。	3.1.2※1
	Cosminexus Service Coordinator-Managerのセットアップ	−	−	−	−
	uCosminexus 日立コード変換 - Server RuntimeまたはuCosminexus 日立コード変換 - Runtimeのセットアップ	−	−	−	−
HCSCサーバのセットアップ		HCSCサーバのセットアップ時に次のエラーが発生する KEOS27105-E	Management Serverが起動していません。	Management Serverが起動しているか確認します。 また，Management Serverが自動起動になっているか確認します。	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50007-E（詳細コードでKDEC10011-E） KEOS27040-E	運用管理エージェントが起動していません。	運用管理エージェントが起動しているか確認します。 また，運用管理エージェントが自動起動になっているか確認します。 起動している場合，Management Serverの設定ファイルの内容を確認し，Management Serverを再起動します。	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50007-E（詳細コードでKDEC05001-EおよびKFPA11723-E）	HiRDBがダウンしています。	HiRDBサーバを起動します。起動できない場合は，マニュアル「スケーラブルデータベースサーバ　HiRDB Version 8 メッセージ」を参照して対処します。	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50007-E（詳細コードでKDEC05012-E）	HiRDB Type4 JDBC DriverまたはOracle JDBC Thin Driverの設定が漏れています。	次の三つのファイルに，ドライバのjarファイルのクラスパスを設定します。 (1) Management Server用オプション定義ファイル（mserver.cfg）で，web.add.class.pathを設定します。 (2) J2EEサーバのユーザ定義ファイル（usrconf.cfg）で，add.class.pathを設定します。 (3) HCSC-Messagingコマンド共通定義ファイル（cmdconf.batまたはcmdconf）で，HCSC_ADDCLASSPATHを設定します。	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50007-E（詳細コードでKDEC10013-E）	リソースアダプタのCosminexus RMが起動していません。	Cosminexus RMを起動します。	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50007-E（詳細コードでKDEC10010-E）	J2EEサーバが起動していません。	見直します。※2	−
		HCSCサーバのセットアップ時に次のエラーが発生する KEOS50004-E（詳細コードでKEOS27105）	運用管理エージェントが正常に動作していません。 または，作成したJ2EEサーバが，Cosminexus Managerの管理下にありません。	見直します。※2 見直し内容に該当しない場合，作成したJ2EEサーバが，Cosminexus Managerの管理下にいないことがあります。 Cosminexus Managerで管理できるように設定します。※3 読み込んできたJ2EEサーバの設定については，一とおり正しく設定されているか確認して，設定が変わっている個所は，元の設定に変更します。その後，画面内の「適用」ボタンをクリックします。すべての見直しが完了したあとに，画面右上の「設定情報の配布」をクリックして，設定を有効にします。 なお，Cosminexus ManagerでJ2EEサーバを管理する場合は，論理パフォーマンストレーサの設定が必要になります。また，「基本情報」の次に示す設定が読み込み後は必ず「しない」（使用しない）になります。そのため，必要に応じて変更してください。 運用監視エージェントの設定 Managementイベント発行機能の設定 起動オプションの設定	−
HCSCサーバの定義情報を設定		−	−	−	−
HCSCサーバの起動		HCSCサーバ起動に失敗する ログの中に「KDJE37356-E The communication timeout occurred.」が含まれている	DB Connectorの属性のmaxBinarySizeとLONGVARBINARY_AccessSizeが共に0になっています。	どちら一方，または両方を変更します。 DBConnectorの属性のmaxBinarySizeに0以外（例：64000）を設定します。 LONGVARBINARY_AccessSizeに0以外（例：64）を設定します。	−
		KEOS50007-Eが発生してコマンドが失敗 HCSC稼働マシンのメッセージログに次のメッセージが出力される KDJE50012-EまたはKFDJ02005-E	HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDB Connectorが，<transaction-support>にNoTransaction以外を定義したDB Connectorです。	二つのDB Connectorを準備していない場合は，DB Connectorを二つセットアップします。 DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。 HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。	3.1.2※1
サービスアダプタ/ビジネスプロセス/ユーザ定義受付の配備		KEOS50007-Eが発生してコマンドが失敗。HCSC稼働マシンのメッセージログに次のメッセージが出力される KDJE50012-EまたはKFDJ02005-E	HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDB Connectorが，<transaction-support>にNoTransaction以外を定義したDB Connectorです。	二つのDB Connectorを準備していない場合は，DB Connectorを二つセットアップします。 DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。 HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。	3.1.2※1
ユーザ定義受付の定義情報を設定		−	−	−	−

（凡例）

−：該当しません。

注※1　詳細は「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。

注※2　次の観点で見直します。

・該当J2EEサーバの稼働ホストで，運用管理エージェントが起動しているか。

・起動している運用管理エージェントのポート番号と，構成定義でホストに定義した運用管理エージェントのポート番号は一致しているか。

・構成定義で定義したホストと通信できるか。

・運用管理エージェントのプロパティで，アクセスしているCosminexus Management Serverの稼働ホストは接続が許可されているか。

・Management Serverと運用管理エージェントのCosminexusのバージョンが一致しているか。

・Management Serverと運用管理エージェントのCosminexusのエディションが異なる場合，接続できるエディション関係か。

・Managerのリモート管理機能が指定の「ホスト名（またはIPアドレス）:ポート番号」で起動されているか。

注※3　次の手順で，作成したJ2EEサーバがCosminexus Managerで管理できるように設定します。

1. 運用管理ポータルの「論理サーバの環境設定」で「論理J2EEサーバ」配下にあるJ2EEサーバ名を選択し，設定画面を表示させます。

2. 表示したメニューのタブ「読み込み」をクリックします。「サーバの設定読み込み」画面が表示されます。

3. 「接続先ホストから設定を読み込みます」を選択し，「読み込み」ボタンをクリックします。

4. 画面右上の「運用管理ポータル」をクリックします。いったんトップページに戻ります。

5. 「論理サーバの起動/停止」をクリックします。起動させるJ2EEサーバが起動できるか確認します。