Cosminexus　システム構築ガイド

手引・操作書

3020-3-M06-60

目　　次

前書き

変更内容

はじめに

第1編　システム構築の準備

1.　Cosminexusでのシステム構築の概要

1.1　構築する環境の概要

1.1.1　アプリケーション実行環境の構築（Application Server）

1.1.2　EJBクライアント環境の構築（uCosminexus Client）

1.1.3　Webリダイレクタ環境の構築（Web Redirector）

1.1.4　実行環境に対するGUI操作環境の構築（uCosminexus Operator）

1.2　J2EEアプリケーションを実行するシステムの構築の流れ

1.3　バッチアプリケーションを実行するシステムの構築の流れ

1.4　Windows Vista使用時の注意事項

1.4.1　管理者特権で実行する必要がある操作

1.4.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

2.　インストールと初期設定

2.1　インストールと初期設定の概要

2.1.1　インストールと初期設定の流れ

2.1.2　製品の導入手順

2.1.3　Component Container管理者の設定

2.2　インストールとアンインストール

2.2.1　インストール方法

2.2.2　アンインストール方法

2.2.3　C++ライブラリのバージョン指定（Linuxの場合）

2.2.4　Cosminexusでサポートしているシンボリックリンク

2.3　環境変数の設定

2.3.1　環境変数の設定の要否

2.3.2　環境変数の詳細

2.3.3　AIX固有の環境変数

2.4　リソースの見積もりと設定

2.4.1　J2EEサーバが使用するリソースの見積もり

2.4.2　バッチサーバが使用するリソースの見積もり

2.4.3　運用管理エージェントが使用するリソースの見積もり

2.4.4　パフォーマンストレーサが使用するリソースの見積もり

2.4.5　CTMが使用するリソースの見積もり

2.5　Server Plug-inの設定

2.5.1　Java実行環境の指定

2.5.2　Server Plug-inの組み込み手順

2.5.3　Server Plug-inを使用するためのManagement Serverの設定

2.6　インストール後のディレクトリ構成

2.6.1　Application Serverのディレクトリ構成

2.6.2　uCosminexus Clientのディレクトリ構成

2.6.3　Web Redirectorのディレクトリ構成

2.6.4　uCosminexus Operatorのディレクトリ構成

2.7　J2EEサーバの作業ディレクトリ

2.7.1　J2EEサーバの作業ディレクトリの構成

2.7.2　作業ディレクトリのパス長の見積もり式

2.8　バッチサーバの作業ディレクトリ

2.8.1　バッチサーバの作業ディレクトリの構成

2.8.2　作業ディレクトリのパス長の見積もり式

2.9　複数の構築済み実行環境を切り替えるための設定（UNIXの場合）

2.9.1　構築済み実行環境を切り替えるための準備

2.9.2　構築済み実行環境の切り替え手順

第2編　J2EEアプリケーションを実行するシステムの構築

3.　システム構築の概要（J2EEアプリケーションを実行するシステム）

3.1　システム構築の流れ

3.2　システムの起動と停止の設定

3.3　システム構築で使用するファイル

3.4　Management Serverの設定

3.4.1　Management Serverのセットアップ

3.4.2　Management Serverの環境設定

3.4.3　Management Serverの動作環境の設定

3.4.4　運用管理エージェントによる論理サーバの監視に関する設定

3.5　システムの構成定義

4.　J2EEサーバの動作設定（J2EEアプリケーションを実行するシステム）

4.1　J2EEサーバの動作設定の方法

4.2　J2EEサーバで設定できる主な項目

4.3　JSPファイルのコンパイル結果の保持の設定

4.4　同時実行スレッド数の制御の設定

4.5　静的コンテンツのキャッシュの設定

4.6　ユーザスレッド生成のための権限の設定

4.7　アノテーションの参照を抑止する設定

4.8　展開ディレクトリ形式のJ2EEアプリケーションの設定

4.9　J2EEアプリケーションの更新検知とリロードの設定

4.10　コンテナ拡張ライブラリの設定

4.11　CTMによるリクエストのスケジューリングの設定

4.12　リソース枯渇監視の設定

4.13　稼働情報ファイルの取得とイベント発行の設定

4.14　J2EEアプリケーション実行時間の監視の設定

4.15　データベース監査証跡との連携の設定

4.16　監査ログ出力の設定

5.　トラブルシューティングの資料取得の設定（J2EEアプリケーションを実行するシステム）

5.1　資料取得の設定の概要

5.2　snapshotログ収集の設定

5.3　障害検知時コマンドによる資料取得の設定

5.4　Management Serverのログ取得の設定

5.5　性能解析トレースファイル収集の設定

5.6　J2EEサーバのログ取得の設定

5.7　SFOサーバのログ取得の設定

5.8　Webサーバのログ取得の設定

5.9　リダイレクタのログ取得の設定

5.10　インプロセスHTTPサーバのログ取得の設定

5.11　Cosminexus Managerのログ取得の設定

5.12　コンソールログの取得の設定

5.13　リソースアダプタのログ取得の設定

5.14　Cosminexus TPBrokerのログ取得の設定

5.15　Cosminexus DABroker Libraryのログ取得の設定

5.16　OSの統計情報取得の設定

5.17　ユーザダンプ取得の設定

5.18　coreダンプ取得の設定

5.19　JavaVMの資料取得の設定

5.20　アプリケーションのユーザログ出力の設定

5.20.1　アプリケーションのユーザログ出力の設定方法

5.20.2　アプリケーションのユーザログ出力例

6.　システムの可用性を高める設定（J2EEアプリケーションを実行するシステム）

6.1　システムの可用性を高める設定の概要

6.2　J2EEサーバ間のセッション情報の引き継ぎの設定

6.2.1　J2EEサーバ間のセッション情報の引き継ぎの設定の概要

6.2.2　SFOサーバの設定

6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定

6.2.4　リクエストラインの最大サイズの設定

6.2.5　HTTPセッション数の上限値の設定

6.2.6　セッション情報の引き継ぎを行うWebアプリケーションの設定変更

6.2.7　Webアプリケーションの設定情報の削除

6.3　Managementイベントによる処理の自動実行の設定

6.3.1　Managementイベントによる処理の自動実行の設定手順

6.3.2　Managementイベント発行の設定

6.3.3　Managementイベント発行用メッセージIDリストファイルの設定

6.3.4　Managementイベント発行機能を利用する各機能の設定

6.3.5　Managementアクション実行用プロパティファイルの設定

6.3.6　Managementアクション実行コマンドの設定

7.　Webサーバとの連携の設定（J2EEアプリケーションを実行するシステム）

7.1　Webサーバとの連携の設定の概要

7.1.1　Webサーバとの連携機能の概要

7.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

7.2　リダイレクタを使用したリクエストの振り分けの設定

7.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

7.2.2　URLパターンでのリクエスト振り分けの設定

7.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

7.2.4　POSTデータサイズでのリクエストの振り分けの設定

7.3　通信タイムアウトの設定

7.3.1　リクエスト送受信時の通信タイムアウトの設定

7.3.2　レスポンス送受信時の通信タイムアウトの設定

7.4　エラーページのカスタマイズの設定

7.5　ドメイン名指定でトップページを表示するための設定

7.6　Webコンテナにゲートウェイ情報を通知するための設定

7.7　Hitachi Web Serverを使用するための設定

7.7.1　Hitachi Web Serverの設定

7.7.2　アップグレード時のHitachi Web Serverの設定

7.7.3　Hitachi Web ServerのSSLの設定

8.　インプロセスHTTPサーバの設定（J2EEアプリケーションを実行するシステム）

8.1　インプロセスHTTPサーバの設定の概要

8.2　Webクライアントからの接続数とリクエスト処理スレッド数の制御の設定

8.2.1　Webクライアントからの接続数の制御の設定

8.2.2　リクエスト処理スレッド数の制御の設定

8.3　Webクライアントからのアクセス制御の設定

8.3.1　アクセスを許可するホストの制限の設定

8.3.2　リクエストデータのサイズ制限の設定

8.3.3　有効なHTTPメソッドの制限の設定

8.4　リクエストの流量制御の設定

8.4.1　Webクライアントからの同時接続数の制御の設定

8.4.2　同時実行スレッド数の制御の設定

8.5　Webクライアントとの通信制御の設定

8.5.1　Persistent Connectionによる通信制御の設定

8.5.2　インプロセスHTTPサーバの通信タイムアウトの設定

8.5.3　インプロセスHTTPサーバのIPアドレスの設定

8.6　Webクライアントへのレスポンスのカスタマイズ

8.6.1　HTTPレスポンスヘッダのカスタマイズの設定

8.6.2　エラーページのカスタマイズの設定

8.7　リダイレクトによるリクエストの振り分けの設定

8.8　Webコンテナにゲートウェイ情報を通知するための設定

8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ

9.　リソースとJ2EEアプリケーションの設定（J2EEアプリケーションを実行するシステム）

9.1　リソースとJ2EEアプリケーションの設定の概要

9.1.1　リソースの設定の概要

9.1.2　J2EEアプリケーションの設定の概要

9.1.3　セキュリティアイデンティティの設定の概要

9.2　リソースとJ2EEアプリケーションの設定の前に

9.2.1　リソースとJ2EEアプリケーションの設定の注意事項

9.2.2　サーバ管理コマンドの動作設定のカスタマイズ

9.3　リソースアダプタの設定

9.3.1　リソースアダプタの設定の流れ（J2EEリソースアダプタとしてデプロイして使用する場合）

9.3.2　リソースアダプタの設定の流れ（J2EEアプリケーションに含めて使用する場合）

9.3.3　リソースアダプタの種類

9.4　JavaBeansリソースの設定

9.5　J2EEアプリケーションの設定

9.5.1　J2EEアプリケーションの設定の流れ

9.5.2　テストモードでのJ2EEアプリケーションの設定の流れ

9.6　リソースとJ2EEアプリケーションで設定できる主な項目

9.6.1　リソースアダプタのプロパティ定義で設定できること

9.6.2　JavaBeansリソースのプロパティ定義で設定できること

9.6.3　J2EEアプリケーションのプロパティ定義で設定できること

9.7　Webアプリケーションに組み込むサーブレットフィルタの設定

9.7.1　サーブレットフィルタの組み込み

9.7.2　セッションフェイルオーバ用フィルタの設定

9.7.3　HTTPレスポンス圧縮フィルタの設定

9.8　リソースまたはJ2EEアプリケーションの別名の設定

9.8.1　リソースの別名の設定

9.8.2　J2EEアプリケーションに含まれるEnterprise Beanの別名の設定

9.9　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定

9.9.1　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定の流れ

9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容

9.9.3　属性ファイルの指定例

10.　統合ユーザ管理機能の設定（J2EEアプリケーションを実行するシステム）

10.1　統合ユーザ管理機能の設定手順

10.2　レルム名の決定

10.3　LDAPディレクトリサーバの設定

10.3.1　LDAPディレクトリサーバの設置

10.3.2　ユーザの登録とアクセス権の設定

10.3.3　オブジェクトクラスとユーザ定義属性の拡張

10.4　ユーザ情報の登録

10.4.1　コマンドによる登録

10.4.2　統合ユーザ管理フレームワークのライブラリによる登録

10.4.3　登録するユーザ情報の文法

10.4.4　Active Directoryを使用する場合の設定

10.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）

10.5.1　暗号鍵ファイルの作成

10.5.2　暗号鍵ファイルの変更

10.6　ユーザ情報の登録（シングルサインオンを使用する場合）

10.6.1　コマンドによる登録

10.6.2　統合ユーザ管理フレームワークのライブラリによる登録

10.6.3　登録するユーザ情報の文法

10.7　コンフィグレーションファイルの作成

10.7.1　jaas.confの作成

10.7.2　ua.confの作成

10.7.3　コンフィグレーションファイルの設定例

10.8　JavaVMのプロパティの設定

10.8.1　usrconf.propertiesの指定内容

10.8.2　server.policyの指定内容

10.9　ファイルのデプロイ

第3編　バッチアプリケーションを実行するシステムの構築

11.　システム構築の概要（バッチアプリケーションを実行するシステム）

11.1　システム構築の流れ

11.2　システム構築で使用するファイル

11.3　システムの構成定義

12.　バッチサーバの動作設定（バッチアプリケーションを実行するシステム）

12.1　バッチサーバの動作設定の方法

12.2　バッチサーバで設定できる主な項目

12.2.1　バッチサーバの動作設定として必ず設定する項目

12.2.2　バッチサーバの動作設定として必要に応じて設定する項目

12.3　リソース枯渇監視の設定

12.4　稼働情報ファイルの取得とイベント発行の設定

13.　トラブルシューティングの資料取得の設定（バッチアプリケーションを実行するシステム）

13.1　資料取得の設定の概要

13.2　snapshotログ収集の設定

13.3　障害検知時コマンドによる資料取得の設定

13.4　バッチサーバのログ取得の設定

13.5　アプリケーションのユーザログ出力の設定

14.　システムの可用性を高めるための設定（バッチアプリケーションを実行するシステム）

14.1　Managementイベントによる処理の自動実行の設定

14.1.1　Managementイベントによる処理の自動実行の設定手順

14.1.2　Managementイベント発行機能を利用する各機能の設定

15.　リソースの設定（バッチアプリケーションを実行するシステム）

15.1　リソース設定の概要

15.2　リソースアダプタの設定

15.2.1　リソースアダプタの設定の流れ

15.2.2　リソースアダプタの種類

15.2.3　リソースアダプタのプロパティ定義で設定できること

第4編　ほかのプログラムとの連携

16.　JP1との連携の設定

16.1　JP1との連携の設定の概要

16.1.1　システムの集中監視および構成情報の定義・管理の設定（JP1/IMとの連携）

16.1.2　システムの自動運転の設定（JP1/AJS2，JP1/AJS2 - SOとの連携）

16.1.3　監査ログの収集／一元管理（JP1/NETM/Auditとの連携）

16.2　監視ツリーの自動生成の設定

16.2.1　Cosminexusアダプタコマンドのセットアップ

16.2.2　Cosminexusアダプタコマンドの実行環境の設定

16.2.3　Management Serverでの環境設定

16.2.4　JP1/Baseの構成定義の作成

16.2.5　監視ツリーの自動生成

16.3　障害監視の設定

16.3.1　CosminexusのJP1イベント発行の設定

16.3.2　JP1/Baseのイベントサーバ名の設定

16.3.3　JP1/Baseの構成定義の作成

16.4　稼働性能監視の設定

16.4.1　mngsvrutilコマンドの実行環境の設定

16.4.2　拡張MIBオブジェクト定義ファイルの登録

16.4.3　J2EEサーバの運用監視の設定

16.4.4　稼働状況監視のサンプリング時間の設定

16.5　ジョブによるシステムの自動運転の設定

16.5.1　mngsvrutilコマンドの実行環境の設定

16.5.2　J2EEサーバの運用監視の設定

16.5.3　CosminexusのJP1/AJS2定義プログラムのインストール（Windowsの場合）

16.5.4　Cosminexusのカスタムジョブの登録（Windowsの場合）

16.5.5　ジョブの定義

16.5.6　スケジュールの定義

16.6　監査ログの収集／一元管理の設定

16.6.1　監査ログの収集および一元管理に必要なプログラムのインストール

16.6.2　運用管理サーバ・アプリケーションサーバの設定

16.6.3　監査ログ管理サーバの設定

17.　クラスタソフトウェアと連携するための設定

17.1　クラスタソフトウェアと連携する設定の概要

17.2　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

17.2.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

17.2.2　クラスタサーバの環境設定

17.2.3　設定ファイルの編集

17.2.4　汎用スクリプトファイルの作成

17.2.5　クラスタアドミニストレータでのクラスタサーバの環境設定

17.2.6　アプリケーションサーバの設定

17.3　運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

17.3.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

17.3.2　クラスタサーバの環境設定

17.3.3　設定ファイルの編集

17.3.4　現用系から予備系へのManagement Serverの設定情報のコピー

17.3.5　汎用スクリプトファイルの作成

17.3.6　クラスタアドミニストレータでのクラスタサーバの環境設定

17.4　相互系切り替えシステムの設定（Windowsの場合）

17.4.1　相互系切り替えシステムの設定手順

17.4.2　クラスタサーバの環境設定

17.4.3　設定ファイルの編集

17.4.4　汎用スクリプトファイルの作成

17.4.5　クラスタアドミニストレータでのクラスタサーバの環境設定

17.4.6　アプリケーションサーバの設定

17.5　N:1リカバリシステムの設定（Windowsの場合）

17.5.1　N:1リカバリシステムの設定手順

17.5.2　クラスタサーバの環境設定

17.5.3　設定ファイルの編集

17.5.4　実行系の汎用スクリプトファイルの作成

17.5.5　待機系の汎用スクリプトファイルの作成

17.5.6　クラスタアドミニストレータでのクラスタサーバの環境設定

17.5.7　アプリケーションサーバの設定

17.6　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

17.6.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

17.6.2　クラスタサーバの環境設定

17.6.3　設定ファイルの編集

17.6.4　HAモニタの環境設定

17.6.5　シェルスクリプトファイルの作成

17.6.6　サーバ対応の環境設定

17.6.7　LANの状態設定

17.6.8　アプリケーションサーバの設定

17.7　運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

17.7.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

17.7.2　クラスタサーバの環境設定

17.7.3　設定ファイルの編集

17.7.4　現用系から予備系へのManagement Serverの設定情報のコピー

17.7.5　HAモニタの環境設定

17.7.6　シェルスクリプトファイルの作成

17.7.7　サーバ対応の環境設定

17.7.8　LANの状態設定

17.8　相互系切り替えシステムの設定（UNIXの場合）

17.8.1　相互系切り替えシステムの設定手順

17.8.2　クラスタサーバの環境設定

17.8.3　設定ファイルの編集

17.8.4　HAモニタの環境設定

17.8.5　シェルスクリプトファイルの作成

17.8.6　サーバ対応の環境設定

17.8.7　LANの状態設定

17.8.8　アプリケーションサーバの設定

17.9　N:1リカバリシステムの設定（UNIXの場合）

17.9.1　N:1リカバリシステムの設定手順

17.9.2　クラスタサーバの環境設定

17.9.3　設定ファイルの編集

17.9.4　HAモニタの環境設定

17.9.5　シェルスクリプトファイルの作成

17.9.6　サーバ対応の環境設定

17.9.7　LANの状態設定

17.9.8　アプリケーションサーバの設定

第5編　Webリダイレクタ環境の構築

18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）

18.1　Webサーバとの連携の設定の概要

18.1.1　Webサーバとの連携機能の概要

18.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

18.2　リダイレクタを使用したリクエストの振り分けの設定

18.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

18.2.2　URLパターンでのリクエスト振り分けの設定

18.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

18.2.4　POSTデータサイズでのリクエストの振り分けの設定

18.3　通信タイムアウトの設定

18.3.1　リクエスト送受信時の通信タイムアウトの設定

18.3.2　レスポンス送受信時の通信タイムアウトの設定

18.4　エラーページのカスタマイズの設定

18.5　ドメイン名指定でトップページを表示するための設定

18.6　Webコンテナにゲートウェイ情報を通知するための設定

18.7　リダイレクタのログ取得の設定

18.8　Hitachi Web Serverを使用するための設定

18.8.1　Hitachi Web Serverの設定

18.8.2　アップグレード時のHitachi Web Serverの設定

18.8.3　Hitachi Web ServerのSSLの設定

18.9　Microsoft IISを使用するための設定

18.9.1　Microsoft IISの設定

18.9.2　Microsoft IISのSSLの設定方法

第6編　EJBクライアント環境の構築

19.　EJBクライアントアプリケーションの設定と実行

19.1　EJBクライアントアプリケーション開始の流れ

19.1.1　cjclstartapコマンドの場合

19.1.2　vbjコマンドの場合

19.2　EJBクライアントアプリケーションの環境変数の設定

19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定

19.4　EJBクライアントアプリケーションのプロパティの設定

19.5　EJBクライアントアプリケーションのログ出力の設定

19.5.1　EJBクライアントアプリケーションのログの種類

19.5.2　システムログの出力先や出力レベルの変更

19.5.3　複数プロセスでのログ出力先のサブディレクトリの共有

19.5.4　ログ出力先のサブディレクトリ数の管理

19.5.5　ログ出力先ディレクトリのアクセス権の設定

19.6　EJBクライアントアプリケーションのトランザクションの設定

付録

付録A　Cosminexus Version 6およびCosminexus Version 7からの移行

付録A.1　Cosminexusの移行の概要

付録A.2　Cosminexusの移行の手順

付録A.3　旧バージョンからの仕様変更の確認

付録A.4　J2EEサーバの作業ディレクトリのディスク容量の確認

付録A.5　移行前の確認

付録A.6　定義などのバックアップ

付録A.7　J2EEサーバの移行コマンドの実行

付録A.8　リソースアダプタの移行コマンドの実行

付録A.9　Management Serverの移行コマンドの実行

付録A.10　手動による定義などの修正

付録A.11　移行コマンドで作成されたバックアップの削除

付録A.12　J2EEサーバの移行コマンドで自動的に追加される定義

付録A.13　セッションフェイルオーバ機能を使用している場合のバージョンアップ

付録B　Cosminexus Version 6およびCosminexus Version 7とのRMI-IIOP通信の相互接続性

付録C　推奨機能への移行

付録C.1　Microsoft IISからHitachi Web Serverへの移行

付録C.2　インプロセストランザクションサービスへの移行

付録D　サーバマネジャからServer Plug-inへの移行

付録D.1　Server Plug-inを使用する場合のシステム構成

付録D.2　システムの構築方法の差異

付録D.3　Server Plug-inのセットアップ

付録E　DDの見直しの観点

付録E.1　EARファイルの見直し観点

付録E.2　RARファイルの見直し観点

付録E.3　EJB-JARファイルの見直し観点

付録E.4　WARファイルの見直し観点

付録F　Oracleアクセスライブラリの再作成

付録F.1　AIXの場合

付録F.2　HP-UX（IPF）の場合

付録F.3　Linux（x86／AMD64 & Intel EM64T）の場合

付録F.4　Linux（IPF）の場合

付録F.5　Solarisの場合

付録F.6　Oracle9iまたはOracle10gで追加されたデータ型への対応状況

付録G　ベーシックモードの利用（互換用機能）

付録G.1　ベーシックモードの設定

付録G.2　データソースの設定

付録H　サーブレットエンジンモードの利用（互換用機能）

付録H.1　サーブレットエンジンモードでのシステム構築

付録H.2　Webコンテナサーバのセットアップ

付録H.3　Webコンテナサーバの動作設定のカスタマイズ

付録H.4　トラブルシューティングの資料取得の設定

付録H.5　統合ユーザ管理機能の設定

付録H.6　Webアプリケーションの設定

付録H.7　Webコンテナサーバの作業ディレクトリ

付録H.8　サーブレットエンジンモードの移行情報

付録I　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（Windowsの場合）

付録I.1　Cosminexus TPBroker構成のプランニング

付録I.2　ORB機能使用時の設定

付録J　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（UNIXの場合）

付録J.1　Cosminexus TPBroker構成のプランニング

付録J.2　ORB機能使用時の設定

付録K　Cosminexusで提供するサンプルプログラム

付録K.1　サーバ管理コマンドによるサンプル実行環境の構築，運用手順

付録K.2　Enterprise Bean（EJB2.0）のサンプルプログラム

付録K.3　Enterprise Bean（アノテーション）のサンプルプログラム

付録K.4　Enterprise Bean（Timer Service）のサンプルプログラム

付録K.5　JavaBeansリソースのサンプルプログラム

付録K.6　ユーザログ機能のサンプルプログラム

付録K.7　Webアプリケーションのサンプルプログラム

付録L　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64）

P-2443-7D74　 uCosminexus Application Server Standard　 07-60
P-2443-7K74　 uCosminexus Application Server Enterprise　 07-60
P-2443-7M74　 uCosminexus Web Redirector　 07-60
P-2443-7S74　 uCosminexus Service Platform　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP

P-2443-7E74　 uCosminexus Developer Standard　 07-60
P-2443-7F74　 uCosminexus Developer Professional　 07-60
P-2443-7T74　 uCosminexus Service Architect　 07-60※
P-2443-7U74　 uCosminexus Operator　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，Windows XP

P-2443-7H74　 uCosminexus Client　 07-60

●適用OS：AIX 5L V5.2，AIX 5L V5.3

P-1M43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1M43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1M43-7M71　 uCosminexus Web Redirector　 07-60※
P-1M43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：HP-UX 11i V2（IPF），HP-UX 11i V3（IPF）

P-1J43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1J43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1J43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）

P-9S43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9S43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9S43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5（AMD/Intel 64）

P-9S43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（IPF），Red Hat Enterprise Linux AS 4（IPF），Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）

P-9V43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9V43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9V43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Solaris 9，Solaris 10

P-9D43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9D43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9D43-7M71　 uCosminexus Web Redirector　 07-60※
P-9D43-7S71　 uCosminexus Service Platform　 07-60※

※印の製品については，サポート時期をご確認ください。
これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
本製品では日立トレース共通ライブラリをインストールします。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group,Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle8iは，米国Oracle Corporationの商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SecureWayは，米国における米国International Business Machines Corp.の登録商標です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。

■ 発行

2006年 4月 (第1版) 3020-3-M06
2007年12月 (第4版) 3020-3-M06-60

■ 著作権

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

変更内容

変更内容（3020-3-M06-60）uCosminexus Application Server Standard 07-60，uCosminexus Developer Standard 07-60，uCosminexus Developer Professional 07-60，uCosminexus Client 07-60，uCosminexus Application Server Enterprise 07-60，uCosminexus Web Redirector 07-60，uCosminexus Service Platform 07-60，uCosminexus Service Architect 07-60，uCosminexus Operator 07-60

追加・変更内容
変更個所

Application Serverで，バッチ処理を実行するアプリケーションの実行基盤をサポートした。これに伴い，バッチサーバの構築に関する説明を追加した。
1.1，1.1.1，1.3，2.1.1，2.1.2，2.1.3，2.2.1，2.2.3，2.3.1，2.4.2，2.6.1，2.8，11章，12章，13章，14章，15章，17.1，付録A.3，付録L

Solarisに関する説明を追加した。
2.3.1，2.3.2，2.4.4，2.4.5，2.6.1，2.9.2，17.1，19.2，付録A.3，付録C.2，付録F，付録F.5，付録J

システム構築ツールとしてセットアップウィザードをサポートした。これに伴い，ディレクトリ構成の説明を追加した。
2.6.1

J2EEサーバで設定できる主な項目（Webコンテナの機能を使用するための設定）で，「J2EEサーバ単位でのデフォルトの文字エンコーディング設定」の項目に，次のパラメタを追加した。

webserver.static_content.encoding.extension

4.2

J2EEサーバで設定できる主な項目（Webコンテナの機能を使用するための設定）に，前バージョンからのJSPの移行に関する項目を追加した。
4.2

リソース枯渇監視の設定で，メモリサイズに設定する値の説明を変更した。
4.12，6.3.4，12.3，14.1.2

セッションフェイルオーバ機能を使用する場合に，開発環境でグローバルセッション情報のサイズ見積もり機能を使用するときの設定の説明を追加した。
6.2.3，6.2.5，9.7.2

Connector 1.5仕様のInboundのリソースアダプタを使用できるようにした。
9.6.1，9.6.3，9.9

ローカルインタフェースに別名を設定できるようにした。
9.6.3，9.8

セッションフェイルオーバ機能を使用する場合に，グローバルセッション情報として指定できるセッション情報のデータ型として，直列化可能クラスのオブジェクトの説明を追加した。
9.7.1，9.7.2

セッションフェイルオーバ機能を使用する場合に，HTTPセッションに登録されたすべてのセッション情報をグローバルセッション情報として引き継ぐ設定の説明を追加した。
9.7.2

08-11以降のバージョンのJP1/NETM/Auditに対応した。
16.6.3

Cosminexus 07-60への移行情報を追加した。
付録A，付録H.8

次の製品の適用OSに，Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），およびRed Hat Enterprise Linux 5（AMD/Intel 64）を追加した。

uCosminexus Service Platform

－

次の製品の適用OSにLinux（IPF）を追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

次の製品の適用OSにSolarisを追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

uCosminexus Service Platform

－

HP-UX（PA-RISC）のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

次の製品の適用OSからHP-UX（IPF）を削除した。

uCosminexus Service Platform

－

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3020-3-M06-40）uCosminexus Application Server Standard 07-50，uCosminexus Developer Standard 07-50，uCosminexus Developer Professional 07-50，uCosminexus Client 07-50，uCosminexus Application Server Enterprise 07-50，uCosminexus Web Redirector 07-50，uCosminexus Service Platform 07-50，uCosminexus Service Architect 07-50，uCosminexus Operator 07-50

追加・変更内容

Cosminexusで構築するアプリケーションの実行環境の説明を，Management ServerのSmart Composer機能を使用して構築する記述に変更した。
この変更に伴い，Management Serverの運用管理ポータル，およびファイル編集とコマンド実行を使用して構築する記述を削除した。

Windows Vista使用時の注意事項を追加した。

インストール後の初期設定に関する次の記述を削除した。

メモリ所要量の見積もり

Cosminexus DABroker Libraryの設定

データベースの設定

複数の構築済み実行環境の切り替えを使用するための手順を追加した。

セキュリティアナライザ，およびセキュリティフィルタに関する記述を削除した。

Management Serverのセットアップ時に，Management Serverを利用する管理ユーザアカウントを設定できる機能を追加した。

EJBホームオブジェクトへの再接続できる機能を使用するための設定を追加した。

J2EEサーバ単位に，J2EEアプリケーションのアノテーションを参照する処理を抑止できる機能を追加した。

データベース監査証跡と連携する機能を追加した。

監査ログを出力する機能を追加した。

Webサーバのログを取得するための設定を追加した。

セッション管理で使用するグローバルセッションを，URL書き換えで制御するための設定を追加した。

リダイレクタを使用して，POSTデータサイズでリクエストを振り分けるための設定を追加した。

Hitachi Web Serverの再起動で出力されるエラーメッセージの出力条件を追加した。

リダイレクタのログ出力先ディレクトリのアクセス権に関する説明を追加した。

インプロセスHTTPサーバのエラーステータスコードに，Content-Lengthヘッダに関する説明を追加した。

J2EEアプリケーションに含めて使用するリソースアダプタの設定方法を追加した。

DB Connectorを新規に設定する場合に，使用できるConnector属性ファイルのテンプレートファイルを追加した。

使用できるJDBCドライバに，SQL Server 2005 JDBC Driverを追加した。

DB ConnectorでのXDM/RD E2接続で使用できるJDBCドライバに，HiRDB Type4 JDBC Driverを追加した。

Developerが提供するプラグインの変更に伴い，Studio Plug-inをMyEclipseの記述に変更した。

グローバルセッション情報の最大サイズの説明に，文字種ごとのURLエンコード後のサイズに関する説明を追加した。

JP1/NETM/Auditと連携した，監査ログの収集と一元管理の機能を使用するための設定を追加した。

JP1/PAM，JP1/Cm2/NNM，およびJP1/PFM/SSOと連携する機能を削除した。

JP1/IMとの連携時の障害監視の設定から，Cosminexusモニタ起動コマンドのセットアップおよび設定に関する記述を削除した。

Microsoft(R) Internet Information Services 5.0の記述を削除した。

java，javawコマンドに関する記述を削除した。

Cosminexus 07-50への移行情報を追加した。

Cosminexusで提供するサンプルプログラムの記述を追加した。

AIX 5L V5.1のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Advanced Server Operating System，Microsoft(R) Windows(R) 2000 Datacenter Server Operating System，およびMicrosoft(R) Windows(R) 2000 Server Operating Systemのサポート中止に伴い，これらのOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Professional Operating Systemのサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

次の製品の適用OSに，HP-UX（IPF）を追加した。

uCosminexus Service Platform

次の製品の適用OSに，HP-UX 11i V3（IPF）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Web Redirector

次の製品の適用OSに，Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），およびRed Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

次の製品の適用OSに，Windows Vistaを追加した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

第3版では第2版の内容の一部を，マニュアル「Cosminexus　簡易構築・運用ガイド」，およびマニュアル「Cosminexus　運用管理操作ガイド」に移動し，目次の構成を変更しました。また，マニュアル「Cosminexus　アプリケーション開発ガイド」から内容の一部を移動し，目次の構成を変更しました。第2版との対応は次のようになっています。

第2版
第3版

1.2　システムの構築方法の種類
1.2　構築する環境の概要

1.2.1　運用管理ポータルでのシステム構築（Application Server）
1.3　アプリケーションの実行環境の構築（Application Server）

1.2.2　ファイル編集とコマンド実行でのシステム構築（Application Server）

1.2.3　EJBクライアント環境の構築（uCosminexus Client）
1.4　EJBクライアント環境の構築（uCosminexus Client）

1.2.4　Webリダイレクタ環境の構築（Web Redirector）
1.5　Webリダイレクタ環境の構築（Web Redirector）

1.2.5　実行環境に対するGUI操作環境の構築（uCosminexus Operator）
1.6　実行環境に対するGUI操作環境の構築（uCosminexus Operator）

2.5　メモリ所要量の見積もり
マニュアル「Cosminexus　簡易構築・運用ガイド」へ移動

2.6　Cosminexus DABroker Libraryの設定（Windowsの場合）
マニュアル「Cosminexus　簡易構築・運用ガイド」へ移動

2.7　Cosminexus DABroker Libraryの設定（UNIXの場合）
マニュアル「Cosminexus　簡易構築・運用ガイド」へ移動

2.8　データベースの設定
マニュアル「Cosminexus　簡易構築・運用ガイド」へ移動

2.9　Server Plug-inの設定
2.5　Server Plug-inの設定

2.10　インストール後のディレクトリ構成
2.6　インストール後のディレクトリ構成

2.11　J2EEサーバの作業ディレクトリ
2.7　J2EEサーバの作業ディレクトリ

第2編　運用管理ポータルでのシステム構築
第2編　アプリケーションの実行環境の構築

3.　運用管理ポータルでのシステム構築方法
3.　システム構築の概要

3.1　システム構築の概要

3.1.1　システム構築の流れ
3.1　システム構築の流れ

3.1.2　Management Serverを利用するシステムの起動と停止の設定
3.2　システムの起動と停止の設定

3.1.3　システム構築で使用するファイル
3.3　システム構築で使用するファイル

3.2　Management Serverの設定
3.4　Management Serverの設定

3.2.1　Management Serverのセットアップ
3.4.1　Management Serverのセットアップ

3.2.2　Management Serverの環境設定
3.4.2　Management Serverの環境設定

3.2.3　Management Serverのユーザやネットワークの設定
3.4.3　Management Serverの動作環境の設定

3.3　論理サーバの設定
削除

3.3.1　Management Serverで管理できる論理サーバ
削除

3.3.2　運用管理ドメインの構成定義
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

3.3.3　論理サーバの環境設定
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

3.3.4　論理サーバの起動と停止の設定
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

3.3.5　論理サーバの起動と停止で使用する環境変数の設定
マニュアル「Cosminexus　簡易構築・運用ガイド」へ移動

3.3.6　論理サーバの動作確認の設定
3.4.4　運用管理エージェントによる論理サーバの監視に関する設定

3.3.7　論理ユーザサーバの設定
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

3.4　J2EEサーバの動作設定のカスタマイズ
4.　J2EEサーバの動作設定

3.4.1　J2EEサーバの動作設定のカスタマイズの方法
4.1　J2EEサーバの動作設定の方法

3.4.2　J2EEサーバのカスタマイズで設定できる主な項目
4.2　J2EEサーバで設定できる主な項目

3.5　トラブルシューティングの資料取得の設定
5.　トラブルシューティングの資料取得の設定

3.5.1　資料取得の設定の概要
5.1　資料取得の設定の概要

3.5.2　snapshotログ収集の設定
5.2　snapshotログ収集の設定

3.5.3　障害検知時コマンドによる資料取得の設定
5.3　障害検知時コマンドによる資料取得の設定

3.5.4　Cosminexus Managerのログ取得の設定
5.11　Cosminexus Managerのログ取得の設定

3.5.5　コンソールログの取得の設定
5.12　コンソールログの取得の設定

3.5.6　リソースアダプタのログ取得の設定
5.13　リソースアダプタのログ取得の設定

3.5.7　Cosminexus TPBrokerのログ取得の設定
5.14　Cosminexus TPBrokerのログ取得の設定

3.5.8　Cosminexus DABroker Libraryのログ取得の設定
5.15　Cosminexus DABroker Libraryのログ取得の設定

3.5.9　OSの統計情報取得の設定
5.16　OSの統計情報取得の設定

3.5.10　ユーザダンプ取得の設定
5.17　ユーザダンプ取得の設定

3.5.11　coreダンプ取得の設定
5.18　coreダンプ取得の設定

3.5.12　JavaVMの資料取得の設定
5.19　JavaVMの資料取得の設定

3.6　システムの起動と停止
削除

3.7　セキュリティアナライザ機能によるシステムのセキュリティ設定のチェック
削除

4.　統合ユーザ管理機能の設定（運用管理ポータルでのシステム構築）
10.　統合ユーザ管理機能の設定

4.1　統合ユーザ管理機能の設定手順
10.1　統合ユーザ管理機能の設定手順

4.2　レルム名の決定
10.2　レルム名の決定

4.3　LDAPディレクトリサーバの設定
10.3　LDAPディレクトリサーバの設定

4.4　ユーザ情報の登録
10.4　ユーザ情報の登録

4.4.1　コマンドによる登録
10.4.1　コマンドによる登録

4.4.2　統合ユーザ管理フレームワークのライブラリによる登録
10.4.2　統合ユーザ管理フレームワークのライブラリによる登録

4.4.3　Management Serverの運用管理ポータルによる登録
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

4.4.4　登録するユーザ情報の文法
10.4.3　登録するユーザ情報の文法

4.4.5　Active Directoryを使用する場合の設定
10.4.4　Active Directoryを使用する場合の設定

マニュアル「Cosminexus　運用管理操作ガイド」へ移動

4.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）
10.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）

4.6　ユーザ情報の登録（シングルサインオンを使用する場合）
10.6　ユーザ情報の登録（シングルサインオンを使用する場合）

4.6.1　コマンドによる登録
10.6.1　コマンドによる登録

4.6.2　統合ユーザ管理フレームワークのライブラリによる登録
10.6.2　統合ユーザ管理フレームワークのライブラリによる登録

4.6.3　Management Serverの運用管理ポータルによる登録
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

4.6.4　登録するユーザ情報の文法
10.6.3　登録するユーザ情報の文法

4.7　コンフィグレーションファイルの作成
10.7　コンフィグレーションファイルの作成

4.8　JavaVMのプロパティの設定
10.8　JavaVMのプロパティの設定

4.9　ファイルのデプロイ
10.9　ファイルのデプロイ

5.　システムの可用性を高める設定（運用管理ポータルでのシステム構築）
6.　システムの可用性を高める設定

5.1　システムの可用性を高める設定の概要
6.1　システムの可用性を高める設定の概要

12.1　クラスタソフトウェアと連携する設定の概要

5.2　J2EEサーバ間のセッション情報の引き継ぎの設定
6.2　J2EEサーバ間のセッション情報の引き継ぎの設定

5.3　Managementイベントによる処理の自動実行の設定
6.3　Managementイベントによる処理の自動実行の設定

5.4　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）
12.2　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

5.4.2　運用管理ポータルでのクラスタサーバの環境設定
12.2.2　クラスタサーバの環境設定

5.5　運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）
12.3　運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

5.5.2　運用管理ポータルでのクラスタサーバの環境設定
12.3.2　クラスタサーバの環境設定

5.6　相互系切り替えシステムの設定（Windowsの場合）
12.4　相互系切り替えシステムの設定（Windowsの場合）

5.6.2　運用管理ポータルでのクラスタサーバの環境設定
12.4.2　クラスタサーバの環境設定

5.7　N:1リカバリシステムの設定（Windowsの場合）
12.5　N:1リカバリシステムの設定（Windowsの場合）

5.7.2　運用管理ポータルでのクラスタサーバの環境設定
12.5.2　クラスタサーバの環境設定

5.8　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）
12.6　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

5.8.2　運用管理ポータルでのクラスタサーバの環境設定
12.6.2　クラスタサーバの環境設定

5.9　運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）
12.7　運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

5.9.2　運用管理ポータルでのクラスタサーバの環境設定
12.7.2　クラスタサーバの環境設定

5.10　相互系切り替えシステムの設定（UNIXの場合）
12.8　相互系切り替えシステムの設定（UNIXの場合）

5.10.2　運用管理ポータルでのクラスタサーバの環境設定
12.8.2　クラスタサーバの環境設定

5.11　N:1リカバリシステムの設定（UNIXの場合）
12.9　N:1リカバリシステムの設定（UNIXの場合）

5.11.2　運用管理ポータルでのクラスタサーバの環境設定
12.9.2　クラスタサーバの環境設定

6.　リソースと業務アプリケーションの設定（運用管理ポータルでのシステム構築）
9.　リソースと業務アプリケーションの設定

6.1　リソースと業務アプリケーションの設定の概要
9.1　リソースと業務アプリケーションの設定の概要

6.2　リソースと業務アプリケーションの設定の前に
9.2　リソースと業務アプリケーションの設定の前に

6.3　リソースアダプタの設定
9.3　リソースアダプタの設定

6.4　JavaBeansリソースの設定
9.4　JavaBeansリソースの設定

6.5　業務アプリケーションの設定
9.5　業務アプリケーションの設定

6.6　Webアプリケーションに組み込むサーブレットフィルタの設定
9.6　Webアプリケーションに組み込むサーブレットフィルタの設定

6.6.1　サーブレットフィルタの組み込み
9.6.1　サーブレットフィルタの組み込み

6.6.2　セッションフェールオーバ用フィルタの設定
9.6.2　セッションフェイルオーバ用フィルタの設定

6.6.3　HTTPレスポンス圧縮フィルタの設定
9.6.3　HTTPレスポンス圧縮フィルタの設定

6.6.4　セキュリティフィルタの設定
削除

7.　JP1との連携の設定
11.　JP1との連携の設定

7.1　JP1との連携の設定の概要
11.1　JP1との連携の設定の概要

7.2　監視ツリーの自動生成の設定
11.2　監視ツリーの自動生成の設定

7.3　障害監視の設定
11.3　障害監視の設定

7.3.4　Cosminexusモニタ起動コマンドのセットアップ（Windowsの場合）
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

7.3.5　Cosminexusモニタ起動コマンドの実行環境の設定（Windowsの場合）
マニュアル「Cosminexus　運用管理操作ガイド」へ移動

7.4　稼働性能監視の設定
11.4　稼働性能監視の設定

7.5　ジョブによるシステムの自動運転の設定
11.5　ジョブによるシステムの自動運転の設定

第3編　ファイル編集とコマンド実行でのシステム構築
削除

8.　ファイル編集とコマンド実行でのシステム構築方法
削除

8.1　システム構築の概要
削除

8.2　セットアップ
削除

8.3　J2EEサーバの動作設定のカスタマイズ
4.　J2EEサーバの動作設定

8.3.1　J2EEサーバの動作設定のカスタマイズの方法
4.1　J2EEサーバの動作設定の方法

8.3.2　J2EEサーバのカスタマイズで設定できる主な項目
4.2　J2EEサーバで設定できる主な項目

8.3.3　JSPファイルのコンパイル結果の保持の設定
4.3　JSPファイルのコンパイル結果の保持の設定

8.3.4　同時実行スレッド数の制御の設定
4.4　同時実行スレッド数の制御の設定

8.3.5　静的コンテンツのキャッシュの設定
4.5　静的コンテンツのキャッシュの設定

8.3.6　ユーザスレッド生成のための権限の設定
4.6　ユーザスレッド生成のための権限の設定

8.3.7　展開ディレクトリ形式の業務アプリケーションの設定
4.8　展開ディレクトリ形式の業務アプリケーションの設定

8.3.8　業務アプリケーションの更新検知とリロードの設定
4.9　業務アプリケーションの更新検知とリロードの設定

8.3.9　コンテナ拡張ライブラリの設定
4.10　コンテナ拡張ライブラリの設定

8.3.10　CTMによるリクエストのスケジューリングの設定
4.11　CTMによるリクエストのスケジューリングの設定

8.3.11　リソース枯渇監視の設定
4.12　リソース枯渇監視の設定

8.3.12　稼働情報ファイルの取得とイベント発行の設定
4.13　稼働情報ファイルの取得とイベント発行の設定

8.3.13　業務アプリケーション実行時間の監視の設定
4.14　業務アプリケーション実行時間の監視の設定

8.4　トラブルシューティングの資料取得の設定
削除

8.4.1　資料取得の設定の概要
削除

8.4.2　snapshotログ収集の設定
削除

8.4.3　J2EEサーバのログ取得の設定
5.6　J2EEサーバのログ取得の設定

8.4.4　SFOサーバのログ取得の設定
5.7　SFOサーバのログ取得の設定

8.4.5　リダイレクタのログ取得の設定
5.9　リダイレクタのログ取得の設定

13.7　リダイレクタのログ取得の設定

8.4.6　インプロセスHTTPサーバのログ取得の設定
5.10　インプロセスHTTPサーバのログ取得の設定

8.4.7　稼働情報ファイル取得の設定
削除

8.4.8　リソースアダプタのログ取得の設定
削除

8.4.9　Cosminexus TPBrokerのログ取得の設定
削除

8.4.10　Cosminexus DABroker Libraryのログ取得の設定
削除

8.4.11　OSの統計情報取得の設定
削除

8.4.12　ユーザダンプ取得の設定
削除

8.4.13　coreダンプ取得の設定
削除

8.4.14　JavaVMの資料取得の設定
削除

8.5　業務アプリケーションのユーザログ出力の設定
5.20　業務アプリケーションのユーザログ出力の設定

8.6　システムの起動と停止
削除

9.　Webサーバとの連携の設定
7.　Webサーバとの連携の設定（アプリケーションの実行環境の場合）

第4編　Webリダイレクタ環境の構築
13.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）

9.1　Webサーバとの連携の設定の概要
7.1　Webサーバとの連携の設定の概要

13.1　Webサーバとの連携の設定の概要

9.2　リダイレクタを使用したリクエストの振り分けの設定
7.2　リダイレクタを使用したリクエストの振り分けの設定

13.2　リダイレクタを使用したリクエストの振り分けの設定

9.3　通信タイムアウトの設定
7.3　通信タイムアウトの設定

13.3　通信タイムアウトの設定

9.4　エラーページのカスタマイズの設定
7.4　エラーページのカスタマイズの設定

13.4　エラーページのカスタマイズの設定

9.5　ドメイン名指定でトップページを表示するための設定
7.5　ドメイン名指定でトップページを表示するための設定

13.5　ドメイン名指定でトップページを表示するための設定

9.6　Webコンテナにゲートウェイ情報を通知するための設定
7.6　Webコンテナにゲートウェイ情報を通知するための設定

13.6　Webコンテナにゲートウェイ情報を通知するための設定

9.7　Hitachi Web Serverを使用するための設定
7.7　Hitachi Web Serverを使用するための設定

13.8　Hitachi Web Serverを使用するための設定

9.8　Microsoft IISを使用するための設定
13.9　Microsoft IISを使用するための設定

9.8.1　Microsoft IISの設定（Windows 2000の設定）
削除

9.8.2　Microsoft IISの設定（Windows Server 2003の設定）
13.9.1　Microsoft IISの設定

9.8.3　アップグレード時のMicrosoft IISの設定
削除

9.8.4　Microsoft IISのSSLの設定方法
13.9.2　Microsoft IISのSSLの設定方法

10.　インプロセスHTTPサーバの設定
8.　インプロセスHTTPサーバの設定

11.　統合ユーザ管理機能の設定（ファイル編集とコマンド実行でのシステム構築）
削除

12.　システムの可用性を高める設定（ファイル編集とコマンド実行でのシステム構築）
削除

12.1　システムの可用性を高める設定の概要
削除

12.2　J2EEサーバ間のセッション情報の引き継ぎの設定
削除

12.2.1　J2EEサーバ間のセッション情報の引き継ぎの設定手順
削除

12.2.2　SFOサーバのセットアップと設定
6.2.2　SFOサーバの設定

12.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定
6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定

12.2.4　HTTPセッション数の上限値の設定
削除

12.2.5　セッション情報の引き継ぎを行うWebアプリケーションの設定変更
削除

12.2.6　Webアプリケーションの設定情報の削除
削除

13.　リソースと業務アプリケーションの設定（ファイル編集とコマンド実行でのシステム構築）
削除

13.1　リソースと業務アプリケーションの設定の概要
削除

13.2　リソースと業務アプリケーションの設定の前に
削除

13.3　リソースアダプタの設定
9.3　リソースアダプタの設定

13.4　JavaBeansリソースの設定
削除

13.5　業務アプリケーションの設定
9.5　業務アプリケーションの設定

13.6　Webアプリケーションに組み込むサーブレットフィルタの設定
削除

「Cosminexus　アプリケーション開発ガイド」から移動
付録K　Cosminexusで提供するサンプルプログラム

付録K　用語解説
付録L　用語解説

変更内容（3020-3-M06-20）uCosminexus Application Server Standard 07-10，uCosminexus Application Server Enterprise 07-10，uCosminexus Developer Standard 07-10，uCosminexus Developer Professional 07-10，uCosminexus Client 07-10，uCosminexus Web Redirector 07-10，uCosminexus Service Platform 07-10，uCosminexus Service Architect 07-10，uCosminexus Operator 07-10

追加・変更機能

Linuxの場合に，C++ライブラリのバージョンを指定する方法を追加した。

uCosminexus Application Server Standard，uCosminexus Application Server Enterprise，uCosminexus Web Redirectorの適用OSに，HP-UX（PA-RISC）を追加した。

HiRDB Version 8に対応した。これに伴い，HiRDB Type4 JDBC Driverに関する記述を追加した。

コンソール出力情報を，コンソールログに出力したり，Server Plug-inまたはHCSC-Managerに表示したりするための設定を追加した。

Server Plug-inの表示言語の変更方法を追加した。

接続先ホストから設定情報を読み込める論理サーバに，論理SFOサーバを追加した。

リクエスト，レスポンスおよびJSPファイルのデフォルトの文字エンコーディングを設定する方法を追加した。

アプリケーションサーバの系切り替え時に，障害などの理由で停止しなかった論理サーバや運用管理エージェントを停止するための設定を追加した。

JP1 Version 8に対応した。これに伴い，JP1製品に関する記述を変更した。

cjclstartapコマンドを使用してEJBクライアントアプリケーション以外のJavaアプリケーションも開始できる機能を追加した。

cjclstartapコマンドが使用するワークファイルについて説明を追加した。

uCosminexus Application Server Standard，uCosminexus Application Server Enterprise，uCosminexus Web Redirectorの適用OSに，Linux（IPF）を追加した。

EJBクライアントアプリケーションのログの設定をusrconf.cfgで設定する方法を追加した。

Cosminexus 07-10への移行情報を追加した。

uCosminexus Service Platformの適用OSに，AIXを追加した。

はじめに

このマニュアルは，Cosminexus（コズミネクサス）を使用して構築するアプリケーションサーバの構築について説明したものです。

Cosminexusでは，次に示すプログラムプロダクトを使用してアプリケーションサーバを構築します。なお，これらのプログラムプロダクトを使用して構築したシステムを，Cosminexusシステムといいます。

P-1J43-7D71　uCosminexus Application Server Standard

P-1J43-7K71　uCosminexus Application Server Enterprise

P-1J43-7M71　uCosminexus Web Redirector

P-1M43-7D71　uCosminexus Application Server Standard

P-1M43-7K71　uCosminexus Application Server Enterprise

P-1M43-7M71　uCosminexus Web Redirector

P-1M43-7S71　uCosminexus Service Platform

P-2443-7D74　uCosminexus Application Server Standard

P-2443-7E74　uCosminexus Developer Standard

P-2443-7F74　uCosminexus Developer Professional

P-2443-7H74　uCosminexus Client

P-2443-7K74　uCosminexus Application Server Enterprise

P-2443-7M74　uCosminexus Web Redirector

P-2443-7S74　uCosminexus Service Platform

P-2443-7T74　uCosminexus Service Architect

P-2443-7U74　uCosminexus Operator

P-9D43-7D71　uCosminexus Application Server Standard

P-9D43-7K71　uCosminexus Application Server Enterprise

P-9D43-7M71　uCosminexus Web Redirector

P-9D43-7S71　uCosminexus Service Platform

P-9S43-7D71　uCosminexus Application Server Standard

P-9S43-7K71　uCosminexus Application Server Enterprise

P-9S43-7M71　uCosminexus Web Redirector

P-9S43-7S71　uCosminexus Service Platform

P-9V43-7D71　uCosminexus Application Server Standard

P-9V43-7K71　uCosminexus Application Server Enterprise

P-9V43-7M71　uCosminexus Web Redirector

このマニュアルでは，これらのプログラムプロダクトの構成ソフトウェアのうち，次に示す構成ソフトウェアについて説明しています。

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Operator Plug-in

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。OSごとの違いがある場合の表記方法については，「適用OSの違いによる機能相違点の表記」を参照してください。

対象読者

このマニュアルは，Cosminexusのシステムを構築する方を対象としています。

次の内容を理解されていることを前提としています。

OS（WindowsまたはUNIX）のシステム構築および運用に関する知識

J2EEに関する知識

SQLおよびリレーショナルデータベースに関する基本的な知識

CORBAに関する基本的な知識

JP1連携機能を使用する場合は，次の内容も理解されていることを前提とします。

JP1の統合管理，ジョブ管理，ネットワーク管理およびアベイラビリティ管理に関する基本的な知識

Microsoft Cluster Service連携機能を使用する場合は，次の内容も理解されていることを前提とします。

Microsoft Cluster Serviceを使用したクラスタ構成に関する基本的な知識

HAモニタ連携機能を使用する場合は，次の内容も理解されていることを前提とします。

HAモニタを使用したクラスタ構成に関する基本的な知識

また，このマニュアルは，マニュアル「Cosminexus　機能解説」，マニュアル「Cosminexus　システム設計ガイド」，およびマニュアル「Cosminexus　簡易構築・運用ガイド」を理解していることを前提としていますので，あらかじめお読みいただくことをお勧めします。

マニュアルの構成

このマニュアルは，次に示す編と付録から構成されています。

第1編　システム構築の準備

Cosminexusのシステムを構築する前に検討および決定しておくこと，Cosminexusを利用して構築できるシステムの概要，Cosminexusのアプリケーションサーバのインストールと初期設定について説明しています。

第2編　J2EEアプリケーションを実行するシステムの構築

J2EEアプリケーションを実行するシステムを構築する場合の，Cosminexusの提供する機能を使用するために設定する項目と設定方法について説明しています。また，システムの構築に必要な設定や，システムの構築で使用するユーザ定義ファイル，コマンドなどについても説明しています。

第3編　バッチアプリケーションを実行するシステムの構築

バッチアプリケーションを実行するシステムを構築する場合の，Cosminexusの提供する機能を使用するために設定する項目と設定方法について説明しています。また，システムの構築に必要な設定や，システムの構築で使用するユーザ定義ファイル，コマンドなどについても説明しています。

第4編　ほかのプログラムとの連携

CosminexusのManagement Serverを利用している場合に，JP1やクラスタソフトウェアと連携したシステムを構築するときに設定する項目と設定方法について説明しています。

第5編　Webリダイレクタ環境の構築

Web Redirectorを利用してWebリダイレクタ環境を構築する場合の，Webサーバと連携してWebアプリケーションを実行するときに必要な設定と設定方法について説明しています。

第6編　EJBクライアント環境の構築

EJBクライアントアプリケーションを使用する場合の，EJBクライアントアプリケーションの設定と実行方法について説明しています。

付録A　Cosminexus Version 6およびCosminexus Version 7からの移行

Cosminexus 07-60よりも前のバージョンからCosminexus 07-60に移行する場合の移行作業と，バージョン間の機能の差異について説明しています。

付録B　Cosminexus Version 6およびCosminexus Version 7とのRMI-IIOP通信の相互接続性

Cosminexus 07-60とCosminexus 07-60よりも前のバージョンとの間でのRMI-IIOP通信によるリモートのEJBクライアント呼び出しの相互接続性について説明しています。

付録C　推奨機能への移行

Cosminexusで推奨する機能への移行作業について説明しています。

付録D　サーバマネジャからServer Plug-inへの移行

Cosminexus Version 6で提供していたサーバマネジャから，Cosminexus Version 7以降で提供するServer Plug-inへの移行について説明しています。

付録E　DDの見直しの観点

J2EEアプリケーションをインポートするときや，Cosminexusの作業ディレクトリを移行するときのDDの見直しの観点について説明しています。

付録F　Oracleアクセスライブラリの再作成

Cosminexus DABroker Libraryが提供しているOracleアクセスライブラリを再作成する場合の方法について説明しています。

付録G　ベーシックモードの利用（互換用機能）

互換用機能であるベーシックモードを使用する場合の設定方法について説明しています。

付録H　サーブレットエンジンモードの利用（互換用機能）

互換用機能であるサーブレットエンジンモードを使用する場合のシステム構築方法，および設定方法について説明しています。

付録I　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（Windowsの場合）

クラスタソフトウェア（Microsoft Cluster Service）と連携するときのCosminexus TPBrokerの設定について説明しています。

付録J　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（UNIXの場合）

クラスタソフトウェア（HAモニタ）と連携するときのCosminexus TPBrokerの設定について説明しています。

付録K　Cosminexusで提供するサンプルプログラム

Cosminexusで提供しているサンプルプログラムについて説明しています。

付録L　用語解説

このマニュアルで使用している用語について説明しています。

関連マニュアル

Cosminexusのマニュアル体系について，次の図に示します。

マニュアル体系図で示した関連マニュアルについて，それぞれの位置づけを次に示します。

Cosminexus　概説

Cosminexusの製品概要について説明しています。

Cosminexus　機能解説

Cosminexus Component Containerの機能を中心に，uCosminexus Application Serverの概要と提供する機能について説明しています。

Cosminexus　システム設計ガイド

システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus　簡易構築・運用ガイド

セットアップウィザードおよびSmart Composer機能を使用して，システムを構築・運用する手順について説明しています。また，セットアップウィザードおよびSmart Composer機能が提供するコマンドやファイルについても説明しています。

Cosminexus　システム運用ガイド

Cosminexusを使用したシステムの運用方法のうち，Smart Composer機能を使用する運用以外の方法について説明しています。

Cosminexus　アプリケーション設定操作ガイド

Cosminexus Component Containerのサーバ管理コマンド，およびServer Plug-inを使用した操作について説明しています。

Cosminexus　運用管理操作ガイド

Cosminexus Component Containerの運用管理ポータルの使用方法について説明しています。

Cosminexus　リファレンス　コマンド編

Cosminexusのシステムを構築・運用するときに使用するコマンドについて説明しています。

Cosminexus　リファレンス　定義編

Cosminexusのシステムを構築・運用するとき，またはアプリケーションを開発するときに，使用するファイルの形式について説明しています。

Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編，Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編，Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編

Cosminexusで出力されるメッセージについて説明しています。

Hitachi Web Server

Hitachi Web Server（Webサーバ）の構築，管理方法について説明しています。

TPBroker　ユーザーズガイド

Cosminexus TPBrokerの概要，機能，運用方法について説明しています。

Cosminexus Reliable Messaging

Cosminexus RMを使用したメッセージの非同期通信によるアプリケーションの連携方法について説明しています。

Cosminexus　アプリケーション開発ガイド

構築したCosminexusのシステムで動作させる，アプリケーションの開発方法について説明しています。

Cosminexus　リファレンス　API編

アプリケーションの開発で使用するAPIおよびタグについて説明しています。

また，マニュアル体系図に示したマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド（3020-3-M45）

Cosminexus サービスプラットフォーム　概説（3020-3-M71）

Cosminexus サービスプラットフォーム　システム構築・運用ガイド（3020-3-M73）

高信頼化システム監視機能　HAモニタ　AIX(R)編（3000-9-130）

高信頼化システム監視機能　HAモニタ　HP-UX編（3000-9-131）

高信頼化システム監視機能　HAモニタ　Linux(R)編（3000-9-132）

スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）（3000-6-272）

スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）（3000-6-352）

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用）（3000-6-354）

スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（Windows(R)用）（3020-6-272）

スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（Windows(R)用）（3020-6-352）

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（Windows(R)用）（3020-6-354）

JP1 Version 7i JP1/Integrated Manager - Console システム構築・運用ガイド（3020-3-F01）

JP1 Version 7i JP1/Automatic Job Management System 2 操作ガイド（3020-3-F09）

JP1 Version 7i JP1/Extensible Service Probe（3020-3-F52）

JP1 Version 7i JP1/Cm2/Network Node Manager ネットワーク管理ガイド（3020-3-F89）

JP1 Version 7i JP1/Cm2/Extensible SNMP Agent（3020-3-F92）

JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド（3020-3-K01）

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド（3020-3-K24）

JP1 Version 8 JP1/NETM/Audit（3020-3-L50）

OpenTP1 Version 6 メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引（3000-3-838）

OpenTP1 Version 6 OpenTP1　クライアント使用の手引　TP1/Client/J編（3000-3-950）

OpenTP1 Version 7 OpenTP1　クライアント使用の手引　TP1/Client/J編（3000-3-D59）

VOS3　Database Connection Server（6190-6-648）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
高信頼化システム監視機能　HAモニタ　AIX(R)編 | 高信頼化システム監視機能　HAモニタ
高信頼化システム監視機能　HAモニタ　HP-UX編
高信頼化システム監視機能　HAモニタ　Linux(R)編
スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用） | HiRDB システム導入・設計ガイド
スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用） | HiRDB システム運用ガイド
スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（Windows(R)用）
JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド | JP1/Automatic Job Management System 2 操作ガイド
JP1 Version 7i JP1/Automatic Job Management System 2 操作ガイド
JP1 Version 8 JP1/NETM/Audit | JP1/NETM/Audit
OpenTP1 Version 7 OpenTP1　クライアント使用の手引　TP1/Client/J編 | OpenTP1　クライアント使用の手引　TP1/Client/J編
OpenTP1 Version 6 OpenTP1　クライアント使用の手引　TP1/Client/J編

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読みいただくことをお勧めします。

マニュアルを読む目的 | 記述個所
Cosminexusのシステムの構築の概要について知りたい。 | 構築する前に検討および決定しておくこと，Cosminexusを利用して構築できるシステムの概要について知りたい。 | 第1編 1章
Cosminexusのアプリケーションサーバのインストールと初期設定について知りたい。 | 第1編 2章
J2EEアプリケーションを実行するシステムの構築について知りたい。 | J2EEアプリケーションを実行するシステムを構築する手順の概要や，構築で使用するファイル，Management Serverの設定方法について知りたい。 | 第2編 3章
Cosminexusの機能を有効にするための設定方法について知りたい。 | 第2編 4章
トラブルシューティングの資料を取得するための設定方法について知りたい。 | 第2編 5章
システムの可用性を高める機能の設定について知りたい。 | 第2編 6章
Webサーバとの連携の設定について知りたい。 | 第2編 7章
インプロセスHTTPサーバの設定について知りたい。 | 第2編 8章
リソースとJ2EEアプリケーションの設定について知りたい。 | 第2編 9章
統合ユーザ管理機能の設定について知りたい。 | 第2編 10章
バッチアプリケーションを実行するシステムの構築について知りたい。 | バッチアプリケーションを実行するシステムを構築する手順の概要や，構築で使用するファイル，Management Serverの設定方法について知りたい。 | 第3編 11章
Cosminexusの機能を有効にするための設定方法について知りたい。 | 第3編 12章
トラブルシューティングの資料を取得するための設定方法について知りたい。 | 第3編 13章
システムの可用性を高める機能の設定について知りたい。 | 第3編 14章
リソースの設定について知りたい。 | 第3編 15章
そのほかのプログラムと連携するシステムの構築について知りたい。 | Management Serverを利用してJP1と連携する場合の設定方法について知りたい。 | 第4編 16章
Management Serverを利用してクラスタソフトウェアと連携する場合の設定方法について知りたい。 | 第4編 17章
Webリダイレクタ環境の構築について知りたい。 | Webサーバとの連携の設定について知りたい。 | 第5編 18章
EJBクライアントアプリケーションの実行について知りたい。 | EJBクライアントアプリケーションを使用する場合の設定方法と，EJBクライアントアプリケーションの実行方法について知りたい。 | 第6編 19章
移行情報について知りたい。 | Cosminexus 07-60よりも前のバージョンからCosminexus 07-60に移行する場合の移行作業と，バージョン間の機能の差異について知りたい。 | 付録A
Cosminexus 07-60とCosminexus 07-60よりも前のバージョンとの間でのRMI-IIOP通信によるリモートのEJBクライアント呼び出しの相互接続性について知りたい。 | 付録B
Cosminexusで推奨する機能への移行作業について知りたい。 | 付録C
Cosminexus Version 6で提供していたサーバマネジャからCosminexus Version 7以降で提供するServer Plug-inへの移行について知りたい。 | 付録D
DDの見直しの観点について知りたい。 | J2EEアプリケーションをインポートするときや，Cosminexusの作業ディレクトリを移行するときのDDの見直しの観点について知りたい。 | 付録E
Oracleアクセスライブラリの再作成方法について知りたい。 | Cosminexus DABroker Libraryの提供するOracleアクセスライブラリの再作成方法について知りたい。 | 付録F
互換用機能について知りたい。 | ベーシックモードの場合の設定，およびデータソースの設定について知りたい。 | 付録G
サーブレットエンジンモードの場合のシステムの構築，および設定について知りたい。 | 付録H
クラスタソフトウェアと連携するときのCosminexus TPBrokerの設定について知りたい。 | Microsoft Cluster Serviceと連携するときのCosminexus TPBrokerの設定について知りたい。 | 付録I
HAモニタと連携するときのCosminexus TPBrokerの設定について知りたい。 | 付録J
サンプルプログラムについて知りたい。 | Cosminexusが提供しているサンプルプログラムについて知りたい。 | 付録K
用語について知りたい。 | このマニュアルで使用している用語について知りたい。 | 付録L

ご利用製品ごとの用語の読み替えについて

ご利用の製品によっては，マニュアルで使用している用語を，ご利用の製品名に読み替える必要があります。

次の表に従って，マニュアルで使用している用語をご利用の製品名に読み替えてください。

ご利用の製品名 | マニュアルで使用している用語
uCosminexus Developer Professional※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Developer Standard※1※2 | Application Server
uCosminexus Service Architect※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Service Platform

注※1　テスト環境で使用している場合にだけ読み替えが必要です。

注※2　uCosminexus Developer StandardとApplication Serverには一部機能差があります。機能差については，マニュアル「Cosminexus　アプリケーション開発ガイド」のDeveloper Standard使用時の注意事項に関する説明を参照してください。

このマニュアルでの表記

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記 | 製品名
Application Server | Application Server Enterprise | uCosminexus Application Server Enterprise
Application Server Standard | uCosminexus Application Server Standard
Developer | Developer Professional | uCosminexus Developer Professional
Developer Standard | uCosminexus Developer Standard
HiRDB | HiRDB/Parallel Server | HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB/Single Server | HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDBクライアント | HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
Internet Explorer | Microsoft(R) Internet Explorer(R)
IPF | Itanium(R) Processor Family
JP1/AJS2 | JP1/AJS2 - Agent | JP1/Automatic Job Management System 2 - Agent
JP1/AJS2 - Light Edition | JP1/Automatic Job Management System 2 - Light Edition
JP1/AJS2 - Manager | JP1/Automatic Job Management System 2 - Manager
JP1/AJS2 - View | JP1/Automatic Job Management System 2 - View
JP1/AJS2 - SO | JP1/AJS2 - SO Manager | JP1/Automatic Job Management System 2 - Scenario Operation Manager
JP1/AJS2 - SO View | JP1/Automatic Job Management System 2 - Scenario Operation View
JP1/Cm2 | JP1/Cm2/ESA | JP1/Cm2/Extensible SNMP Agent
JP1/Cm2/ESA for Extension Mib Runtime | JP1/Cm2/Extensible SNMP Agent for Extension Mib Runtime
JP1/Cm2/NC | JP1/Cm2/NC - Manager | JP1/Cm2/Network Element Configuration - Manager
JP1/Cm2/NC - Manager for Cosminexus | JP1/Cm2/Network Element Configuration - Manager for Cosminexus
JP1/ESP | JP1/Extensible Service Probe
JP1/IM | JP1/IM - Central Console | JP1/Integrated Manager - Central Console
JP1/IM - CM | JP1/Integrated Manager - Central Information Master
JP1/IM - Central Scope | JP1/Integrated Management - Central Information Master
JP1/Integrated Manager - Central Scope
JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
JP1/Integrated Manager - View
JP1/NETM/Audit | JP1/NETM/Audit - Manager
JP1/PFM | JP1/Performance Management
JP1/SC/DPM | JP1/ServerConductor/Deployment Manager Standard Edition
Microsoft Cluster Service | Microsoft(R) Cluster Service
Microsoft IIS | Microsoft IIS 6.0 | Microsoft(R) Internet Information Services 6.0
Oracle | Oracle9i | Oracle9i
Oracle9i R2
Oracle10g | Oracle 10g
Oracle 10g R2
SQL Server | SQL Server 2000 | Microsoft(R) SQL Server(TM) 2000
SQL Server 2005 | Microsoft(R) SQL Server(TM) 2005
SQL Server 2000 Driver for JDBC | Microsoft(R) SQL Server(TM) 2000 Driver for JDBC
SQL Server 2005 JDBC Driver | Microsoft(R) SQL Server(TM) 2005 JDBC Driver
Sun Java System Directory Server | Sun Java(TM) System Directory Server 5.1
Sun Java(TM) System Directory Server Enterprise Edition
UNIX | AIX | AIX 5L V5.2
AIX 5L V5.3
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）
Linux（x86／AMD64 & Intel EM64T） | Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux 5 Advanced Platform（x86）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux ES 4（x86）
Red Hat Enterprise Linux 5（x86）
Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5（AMD/Intel 64）
Solaris | Solaris 9
Solaris 10
Web Redirector | uCosminexus Web Redirector
Windows Server 2003 | Windows Server 2003 Enterprise Edition | Microsoft(R) Windows Server(R) 2003，Enterprise Edition Operating System（x86）
Windows Server 2003 Standard Edition | Microsoft(R) Windows Server(R) 2003，Standard Edition Operating System（x86）
Windows Server 2003 R2 | Windows Server 2003 R2 Enterprise Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition Operating System（x86）
Windows Server 2003 R2 Standard Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard Edition Operating System（x86）
Windows Server 2003（x64） | Windows Server 2003 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003，Enterprise x64 Edition Operating System
Windows Server 2003 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003，Standard x64 Edition Operating System
Windows Server 2003 R2（x64） | Windows Server 2003 R2 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise x64 Edition Operating System
Windows Server 2003 R2 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard x64 Edition Operating System
Windows Vista | Windows Vista Business | Microsoft(R) Windows Vista(R) Business
Windows Vista Enterprise | Microsoft(R) Windows Vista(R) Enterprise
Windows Vista Ultimate | Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System
XDM/RD E2 | VOS3 XDM/RD E2

なお，Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，およびWindows XPを総称してWindowsと表記することがあります。

また，Linuxに関しては，バージョンごとに次のように表記することがあります。

表記 | OS名
Red Hat Enterprise Linux 3 | Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux 4 | Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（x86）

このマニュアルで使用している表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
Cosminexus RM | Cosminexus Reliable Messaging
CTM | Cosminexus Component Transaction Monitor
DB Connector for Cosminexus RM | DB Connector for Cosminexus Reliable Messaging
Management Server | Cosminexus Management Server
MyEclipse | MyEclipse for Cosminexus
PRF | Cosminexus Performance Tracer
Server Plug-in | Cosminexus Server Plug-in
Smart Composer | Cosminexus Smart Composer

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
DI | Dependency Injection
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
J2EEまたはJava 2 Platform, Enterprise Edition | JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAAS | JavaTM Authentication and Authorization Service
JAR | JavaTM Archive
Java | JavaTM
Java 2 Runtime Environment, Standard Edition | JavaTM 2 Runtime Environment, Standard Edition
Java 2 SDK, Standard Edition | JavaTM 2 Software Development Kit, Standard Edition
JavaBeans | JavaBeansTM
JavaMail | JavaMailTM
JAXP | JavaTM API for XML Processing
JCA | J2EETM Connector Architecture
JCE | JavaTM Cryptography Extension
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JNI | JavaTM Native Interface
JSP | JavaServer PagesTM
JTA | JavaTM Transaction API
JTS | JavaTM Transaction Service
Servletまたはサーブレット | JavaTM Servlet
WAR | Web ARchive

適用OSの違いによる機能相違点の表記

このマニュアルは，適用OSがWindows，AIX，HP-UX，Linux，およびSolarisの製品に対応します。OSによって記述を書き分ける場合，次に示す表記を使用して，それぞれの説明にOS名を明記しています。

表記 | 意味
Windowsの場合 | Windowsに該当する表記です。
AIXの場合 | AIXに該当する表記です。
HP-UXの場合 | HP-UXに該当する表記です。
Linuxの場合 | Linuxに該当する表記です。
Solarisの場合 | Solarisに該当する表記です。
UNIXの場合 | UNIX（AIX，HP-UX，Linux，Solaris）に該当する表記です。

このマニュアルで使用している略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BMP | Bean-Managed Persistence
BMT | Bean-Managed Transaction
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CPU | Central Processing Unit
CSR | Certificate Signing Request
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DIT | Directory Information Tree
DMZ | Demilitarized Zone
DN | Distinguished Name
DNS | Domain Name System
DTD | Document Type Definition
EIS | Enterprise Information System
EUC | Extended UNIX Code
GUI | Graphical User Interface
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IDE | Integrated Development Environment
IIOP | Internet Inter-Orb Protocol
ISAPI | Internet Server Application Programming Interface
ISO | International Organization for Standardization
JIS | Japanese Industrial Standards
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LDIF | LDAP Data Interchange Format
MIB | Management Information Base
OCI | Oracle Call Interface
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTM | Object Transaction Monitor
OTS | Object Transaction Service
PEM | Privacy Enhanced Mail
RAC | Real Application Clusters
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SAM | Security Account Manager
SFO | Session Fail Over
SHA | Secure Hash Algorithm
SNMP | Simple Network Management Protocol
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
SPP | Service Providing Program
SSL | Secure Sockets Layer
TAR | Tape Archival and Retrieval format
TCS | Transaction Context Server
UCS | Universal multi-octet coded Character Set
UML | Unified Modeling Language
UNC | Universal Naming Convention
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
VM | Virtual Machine
XML | Extensible Markup Language

このマニュアルの図中で使用している記号

このマニュアルの図中で使用している記号を，次のように定義します。

このマニュアルで使用している記号

注意

間違いやすい点，および間違うとトラブルが発生するような項目について説明しています。

ポイント

その説明の要点について説明しています。

参考

補足的な情報を説明しています。

このマニュアルのGUIの説明で使用している記号

このマニュアルでは，次に示す記号を使用してGUIを説明しています。

記号 | 意味
［　　］ | 画面の名称および画面に表示されている項目を表します。
［　　］－［　　］ | －の前に示したメニューから，－の後ろのメニューを選択することを表します。
＜　　＞ | ＜＞内の名称がユーザの環境によって異なることを表します。
「　　」 | 入力値，可変値，またはメッセージなどを表します。

このマニュアルの計算式で使用している記号

このマニュアルでは，次に示す記号を使用して計算式を説明しています。

記号 | 意味
↓計算式↓ | 計算式の答えの小数点以下を切り捨てることを示します。
↑計算式↑ | 計算式の答えの小数点以下を切り上げることを示します。

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

宛先（あてさき）　鍵（かぎ）　個所（かしょ）　全て（すべて）　溜める（ためる）　伝播（でんぱ）　汎用（はんよう）　必須（ひっす）　閉塞（へいそく）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　Cosminexusでのシステム構築の概要

この章では，Cosminexusを使用してアプリケーションの実行環境を構築する前の準備，Cosminexusを利用して構築できるシステムの概要について説明します。

＜この章の構成＞

1.1　構築する環境の概要

1.2　J2EEアプリケーションを実行するシステムの構築の流れ

1.3　バッチアプリケーションを実行するシステムの構築の流れ

1.4　Windows Vista使用時の注意事項

1.1　構築する環境の概要

この節では，Cosminexusを利用して構築できるシステムの概要について説明します。なお，このマニュアルでは，次に示す環境の構築方法について説明します。

Application Serverでのアプリケーションの実行環境の構築方法
Application Serverでは，次の2種類の実行環境を構築できます。

J2EEアプリケーションの実行環境

バッチアプリケーションの実行環境

J2EEアプリケーションおよびバッチアプリケーションの実行環境は，Cosminexusが提供する構築支援機能（Management Server）のSmart Composer機能を使用して構築します。Smart Composer機能を使用すると，同じ構成の業務サービスを提供するサーバを複数持つWebシステムが，ファイルやコマンドで迅速に構築できます。Smart Composer機能で構築したシステムでは，Smart Composer機能のコマンドを使用して一括運用したり，そのほかのCosminexusのコマンドを使用して個別運用したりできます。Smart Composer機能については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。
システムの構築方法については，「1.1.1　アプリケーション実行環境の構築（Application Server）」を参照してください。

参考

アプリケーションは，目的とする業務内容に合わせて開発してください。J2EEアプリケーションの開発については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。バッチアプリケーションの開発については，マニュアル「Cosminexus　機能解説」のバッチアプリケーションに関する説明を参照してください。

実行環境で使用できるオプション製品（uCosminexus Client，Web Redirector，uCosminexus Operator）の環境の構築方法
Cosminexusでは，実行環境で使用できるオプション製品として，uCosminexus Client，Web Redirector，uCosminexus Operatorを提供しています。これらのオプション製品を使用して，次のような環境と組み合わせることもできます。

EJBクライアント環境
EJBクライアントアプリケーションを実行する環境です。EJBクライアント環境は，uCosminexus Clientで構築します。
システムの構築方法については，「1.1.2　EJBクライアント環境の構築（uCosminexus Client）」を参照してください。

Webリダイレクタ環境
WebサーバとWebコンテナを別のサーバマシンで運用するシステムで，WebサーバとWebコンテナを連携させるための環境です。Webリダイレクタ環境は，Web Redirectorで構築します。
システムの構築方法については，「1.1.3　Webリダイレクタ環境の構築（Web Redirector）」を参照してください。

実行環境に対するGUI操作環境の構築
Application Serverをインストールしたマシンとは別のマシンから，GUI（Eclipseプラグイン）画面を使用して運用操作を実行する環境です。実行環境に対するGUI操作環境は，uCosminexus Operatorで構築します。
システムの構築方法については，「1.1.4　実行環境に対するGUI操作環境の構築（uCosminexus Operator）」を参照してください。

参考

J2EEアプリケーションの開発環境は，Developerで構築します。Developerでのシステム構築については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

サービス統合環境（Cosminexus サービスプラットフォーム）は，uCosminexus Service PlatformまたはuCosminexus Service Architectで構築します。uCosminexus Service PlatformまたはuCosminexus Service Architectについては，マニュアル「Cosminexus サービスプラットフォーム　概説」を参照してください。

Webアプリケーションだけを動作させる（Enterprise Beanを使用しない）実行環境を構築することもできます。Webアプリケーションだけを動作させる場合，サーバの動作モードとしてサーブレットエンジンモードを使用できます。サーブレットエンジンとは，サーブレット実行機能，JSP実行機能を持つサーバのことです。サーブレットエンジンモードで動作するシステムの構築については，「付録H　サーブレットエンジンモードの利用（互換用機能）」を参照してください。

＜この節の構成＞

1.1.1　アプリケーション実行環境の構築（Application Server）

1.1.2　EJBクライアント環境の構築（uCosminexus Client）

1.1.3　Webリダイレクタ環境の構築（Web Redirector）

1.1.4　実行環境に対するGUI操作環境の構築（uCosminexus Operator）

1.1.1　アプリケーション実行環境の構築（Application Server）

Application Serverでは，J2EEアプリケーションまたはバッチアプリケーションの実行環境を構築できます。Application ServerでJ2EEアプリケーションまたはバッチアプリケーションの実行環境を構築する場合，Cosminexusでは，Management ServerのSmart Composer機能を使用できます。Smart Composer機能を使用して構築するシステムでは，Cosminexusのシステムを構成するプログラムやプロセスなどをManagement Serverを利用して一括運用できます。Management Serverでは，複数のホストやサーバプロセスで構成されるCosminexusのシステム全体を，運用管理ドメインという概念でまとめて管理できます。これによって，運用操作の一括実行やシステムの集中管理などが実現でき，効率の良いシステム運用ができるようになります。

＜この項の構成＞

(1)　システム構築の概要

(2)　ほかのプログラムと連携する場合のシステム構築の概要

(1)　システム構築の概要

CosminexusでJ2EEアプリケーションの実行環境を構築する場合，Smart Composer機能のファイルとコマンドを使用します。必要最低限の情報をファイルに定義するだけで，定義したファイルから1回のコマンド操作でシステムを一括構築できます。Smart Composer機能のファイルとコマンドで，システムの構築から，日常の運用，保守作業を実行できます。ただし，一部の設定については，Smart Composer機能のファイルとコマンドだけでは設定できないので，サーバ管理コマンドやServer Plug-inを使用したり，そのほかの定義ファイルを直接編集したりして環境を構築する必要があります。サーバ管理コマンドは，J2EEサーバ上で動作するリソースとJ2EEアプリケーションのプロパティを定義し，リソースとJ2EEアプリケーションの起動／停止を実行するためのコマンド群です。Server Plug-inは，J2EEサーバ上で動作するリソースとJ2EEアプリケーションのプロパティを定義し，論理サーバ，リソース，およびJ2EEアプリケーションの起動／停止を実行するためのGUIを提供するEclipseのプラグインです。Smart Composer機能のファイルおよびコマンドについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

システム構築の流れについては，それぞれ次の個所を参照してください。

J2EEアプリケーションを実行するシステムを構築する場合
「1.2　J2EEアプリケーションを実行するシステムの構築の流れ」を参照してください。

バッチアプリケーションを実行するシステムを構築する場合
「1.3　バッチアプリケーションを実行するシステムの構築の流れ」を参照してください。

(2)　ほかのプログラムと連携する場合のシステム構築の概要

Management Serverを利用するシステムでは，JP1やクラスタソフトウェアと連携することもできます。

●JP1と連携する場合のシステム構築の概要

Management Serverを利用するシステムは，日立の統合運用管理ミドルウェアであるJP1と連携して運用できます。JP1と連携すると，Cosminexus以外のホストやサーバプロセスを含めた業務システム全体の状況を集中監視したり，システム上のサーバの起動や停止を自動化したりできるようになります。また，JP1のUNIXジョブまたはPCジョブとしてバッチアプリケーションの実行コマンドを定義しておくと，バッチアプリケーションの自動実行ができます。

JP1と連携する場合には，Smart Composer機能または運用管理ポータルを使用した環境構築に加えて，JP1と連携するための設定をする必要があります。JP1と連携するためには，Management ServerでのJP1連携の設定，Cosminexusの定義ファイルの作成，JP1との連携で使用するファイルのJP1への登録などが必要です。

参考

運用管理ポータルを使用した環境構築については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

なお，Cosminexusでは，JP1と連携するための環境構築や運用支援機能として，JP1で使用するツリーやジョブの作成支援機能，およびJP1が扱う形式のデータ出力機能を提供しています。

JP1と連携する場合のシステムの構築については，「16.　JP1との連携の設定」を参照してください。

●クラスタソフトウェアと連携する場合のシステム構築の概要

Management Serverを利用しているシステムは，クラスタソフトウェアと連携して運用できます。連携できるクラスタソフトウェアを次に示します。

Microsoft Cluster Service（Windowsの場合）
Microsoft Cluster Serviceは，高い可用性を実現するためにWindows Server 2003に含まれるクラスタサービスのサーバクラスタ機能です。なお，使用できるOSについては，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携して実現できる運用に関する説明を参照してください。

HAモニタ（AIX，HP-UXまたはLinuxの場合）
HAモニタは，システムの信頼性および稼働率の向上を目的とした，サーバプログラムを含めたシステムの切り替えを実現する日立のクラスタソフトウェアです。

クラスタソフトウェアと連携してシステムを運用することで，アプリケーションサーバに障害が発生した場合に，直ちに自動でアプリケーションサーバを切り替えたり，待機しているリカバリサーバで，障害が発生したアプリケーションサーバのリカバリ処理をしたりできます。これによって，システムの不稼働時間を短縮でき，信頼性や稼働率を高めることができます。

クラスタソフトウェアと連携する場合には，Smart Composer機能を使用した環境構築に加えて，クラスタソフトウェアと連携するための設定をする必要があります。Microsoft Cluster Serviceと連携する場合には，クラスタアドミニストレータの設定，汎用スクリプトファイルの設定などが必要です。HAモニタと連携する場合には，HAモニタの設定，各論理サーバの設定などが必要です。

クラスタソフトウェアと連携する場合のシステムの構築については，「17.　クラスタソフトウェアと連携するための設定」を参照してください。

1.1.2　EJBクライアント環境の構築（uCosminexus Client）

uCosminexus Clientは，EJBクライアントアプリケーションの実行環境（EJBクライアント環境）を構築するための製品です。アプリケーションサーバ上で動作しているJ2EEアプリケーション内のEnterprise Beanを，Webサーバ経由ではなく，クライアントマシン上のプログラムから直接呼び出すシステムを構築したい場合に，クライアントとして使用します。なお，uCosminexus Clientの対象OSはWindowsだけです。この節では，EJBクライアント環境の構築の概要について説明します。

EJBクライアント環境は，直接設定ファイルを編集したり，環境変数を設定したりして環境を構築します。また，cjclstartapコマンドなどを使用してEJBクライアントアプリケーションを起動します。

uCosminexus Clientをインストールして初期設定をしたあと，環境を構築してください。uCosminexus Clientの導入手順については，「2.1.2(2)　uCosminexus Client」を参照してください。EJBクライアント環境の構築については，「19.　EJBクライアントアプリケーションの設定と実行」を参照してください。

注意

Windows Vistaで，ログの出力先としてC:¥Program Files以下のディレクトリを指定している場合，EJBクライアントアプリケーションは，管理者特権で実行する必要があります。管理者特権のないユーザが，ログの出力先としてC:¥Program Files以下のディレクトリを指定して，EJBクライアントアプリケーションを実行した場合には，ログは保存されません。この場合，ログは次に示すディレクトリに保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

07-50より前のバージョンで使用していたEJBクライアントアプリケーションを，Windows Vistaで使用する場合は，ログの出力先を見直す必要があります。

Windows Vistaの場合に管理者特権で実行する方法については，「1.4.1(2)　Cosminexusが提供するコマンドの使用」を参照してください。

1.1.3　Webリダイレクタ環境の構築（Web Redirector）

Web Redirectorは，WebサーバとWebコンテナを連携させるための環境（Webリダイレクタ環境）を構築するための製品です。WebサーバとWebコンテナを別のサーバマシンで運用するシステムで，Webサーバを配置するサーバマシンにWeb Redirectorをインストールして使用します。この節では，Webリダイレクタ環境の構築の概要について説明します。

Webリダイレクタ環境には，Webサーバの設定が必要です。直接設定ファイルを編集して環境を構築します。

Web Redirectorをインストールして初期設定をしたあと，環境を構築してください。Web Redirectorの導入手順については，「2.1.2(3)　Web Redirector」を参照してください。Webリダイレクタ環境の構築については，「18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）」を参照してください。

1.1.4　実行環境に対するGUI操作環境の構築（uCosminexus Operator）

uCosminexus Operatorは，Application Serverをインストールしたマシンとは別のマシンから，GUI（Eclipseプラグイン）画面を使用して運用操作を実行するための製品です。例えば，実行環境がUNIXの場合に，別のWindowsのマシンでEclipseプラグインのGUIによる運用管理操作を実行したい場合に，この製品を使用します。この節では，実行環境に対するGUI操作環境の構築の概要について説明します。

uCosminexus Operatorをインストールして初期設定をしたあと，環境を構築してください。uCosminexus Operatorの導入手順については，「2.1.2(4)　uCosminexus Operator」を参照してください。

参考

サービス統合環境（Cosminexus サービスプラットフォーム）の運用操作でもuCosminexus Operatorを使用できます。サービス統合環境でのuCosminexus Operatorの使用方法については，マニュアル「Cosminexus サービスプラットフォーム　概説」を参照してください。

1.2　J2EEアプリケーションを実行するシステムの構築の流れ

この節では，J2EEアプリケーションを実行するシステムの構築に必要な作業として，システム設計から，構築したシステムの運用までの流れについて説明します。また，システム構築に必要な作業が，どのマニュアルに記載されているかについても説明します。システム構築に必要な作業と，マニュアルとの対応を次の図に示します。

図1-1　システム構築に必要な作業と，マニュアルとの対応（J2EEアプリケーション）

図中の1.～5.について(1)～(5)で説明します。各作業の詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。なお，このマニュアルを参照している作業については，作業ごとに参照先を説明しています。

＜この節の構成＞

(1)　システムの設計

(2)　インストール

(3)　システムの構築

(4)　チューニング

(5)　システムの運用

(1)　システムの設計

動作させるアプリケーションの種類やシステム構成などについては，あらかじめマニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　システム設計ガイド」で決定しておきます。ここでは，次の作業を実施します。

システムの構成の検討
J2EEアプリケーションで使用する機能に応じて，機能の実現に必要なプロセスやサーバの配置，マシンの台数などを検討します。システム全体の構成は，システムの特性や要件を考慮して決定しておいてください。システムの構成については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。
マニュアル「Cosminexus　システム設計ガイド」で決定したシステム構成を基に，Smart Composer機能の構成パターンを検討します。Smart Composer機能で構築できるシステムの構成パターンについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

使用リソースおよびメモリの見積もり
システムを動作させるために必要なリソースや，メモリを見積もります。
なお，オプション製品を使用した環境での見積もりや，プロセス単位の見積もりなどについては，「2.4　リソースの見積もりと設定」を参照してください。

運用・障害設計
システムの日常運用や保守，障害発生時のシステムの対応などを設計します。

(2)　インストール

構築するシステムに合わせて，必要な製品をインストールします。なお，オプション製品の導入手順や，構成ソフトウェアのインストールについては，「2.　インストールと初期設定」を参照してください。また，Application Serverの導入手順については，「2.1.2(1)　Application Server」を参照してください。

(3)　システムの構築

決定した構成に基づいて，システムを定義して構築します。また，構築するシステムで動作するリソースアダプタやJ2EEアプリケーションを設定します。システムを構築するために，次の作業を実施します。

なお，J2EEアプリケーションを実行するシステムの構築については，「第2編　J2EEアプリケーションを実行するシステムの構築」を参照してください。また，このマニュアルで説明しているシステム構築の流れについては，「3.1　システム構築の流れ」を参照してください。システム構築の一連の流れについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(a)　Management Serverの設定

Smart Composer機能で構築するシステムは，Management Serverを使用します。Management Serverを初めて使用するホストでは，Management Serverをセットアップしてください。Management Serverの設定については，「3.4　Management Serverの設定」を参照してください。

(b)　システムの構成定義

Smart Composer機能のファイルを使用して，決定したシステム構成を定義します。

(c)　使用する機能を有効にするための設定

デフォルトの設定では，無効となる機能があります。デフォルトの設定で無効となる機能は，Smart Composer機能のファイルなどを使用して，有効にする設定が必要になります。

システム構築時に，J2EEアプリケーションで使用する機能に応じて設定する項目を次の表に示します。なお，これらの設定項目は，基本的にSmart Composer機能のファイルやコマンドを使用して設定します。ただし，Smart Composer機能のファイルやコマンドで設定できない場合は，そのほかのCosminexusのコマンドやファイルを使用して設定します。

表1-1　J2EEアプリケーションで使用する機能に応じて設定する項目

項目 | 説明 | 参照先
J2EEサーバの動作設定 | J2EEアプリケーションで使用する機能に応じて，J2EEサーバの動作環境の設定をします。デフォルトのJ2EEサーバの動作を変更しない場合は，設定不要です。 | 4章
トラブルシューティングの資料取得の設定 | トラブルシューティングで使用する資料には，運用を開始する前に取得するための設定が必要なものがあります。デフォルトで取得する資料だけをトラブルシューティングで使用する場合は，設定不要です。 | 5章
システムの可用性を高める設定 | セッションフェイルオーバ機能によるJ2EEサーバへのセッション情報の引き継ぎの設定，Managementイベントによる障害の事前検知の設定など，システムの可用性を高める設定をします。 | 6章
Webサーバとの連携の設定 | リダイレクタを利用したリクエストの振り分け，通信タイムアウト，エラーページのカスタマイズなど，Webサーバとの連携の設定をします。なお，Webリダイレクタ環境構築時に必要なWebサーバとの連携の設定については，「18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）」を参照してください。 | 7章
インプロセスHTTPサーバの設定 | インプロセスHTTPサーバを利用したWebクライアントからのアクセス制御，リクエストの流量制御，Webクライアントとの通信制御などを設定します。 | 8章
リソースとJ2EEアプリケーションの設定 | サーバ管理コマンドを使用して，リソースやJ2EEアプリケーションのプロパティを定義し，運用管理ドメイン内のJ2EEサーバにデプロイします。 | 9章
統合ユーザ管理機能の設定 | Cosminexusシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定します。 | 10章
EJBクライアントアプリケーションの設定 | EJBクライアントアプリケーションを利用する場合には，EJBクライアントアプリケーションの実行環境を構築します。 | 19章

参考

Cosminexusを利用して構築したシステムでは，Smart Composer機能のコマンド以外に，運用管理コマンド（mngsvrutil）などを使用して運用できます。運用管理コマンドは，Management Serverを操作するためのコマンドで，日常の運用，保守作業を実行できます。システムの運用方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(d)　システムの構築

Smart Composer機能のコマンドを使用して，システムを構築します。

(e)　リソースアダプタの設定

リソースを利用する場合に，必要に応じて，リソースと接続するリソースアダプタを使用します。リソースアダプタは，コマンドを使用して，プロパティを設定したり，インポートしたりします。

リソースアダプタの種類や設定については，「9.　リソースとJ2EEアプリケーションの設定（J2EEアプリケーションを実行するシステム）」を参照してください。

(f)　J2EEアプリケーションの設定

コマンドを使用して，J2EEアプリケーションをインポートしてプロパティを定義します。J2EEアプリケーションの設定については，「9.　リソースとJ2EEアプリケーションの設定（J2EEアプリケーションを実行するシステム）」を参照してください。

(g)　ほかのプログラムと連携するための設定

JP1やクラスタソフトウェアと連携するために必要な設定をします。JP1/IM - CMおよびJP1/AJS2 - SO以外のJP1製品との連携の設定については，「16.　JP1との連携の設定」を参照してください。また，クラスタソフトウェアとの連携の設定については，「17.　クラスタソフトウェアと連携するための設定」を参照してください。

(h)　システムの開始

Smart Composer機能のコマンドを使用して，システムを開始します。

(4)　チューニング

構築したシステムで，アプリケーションサーバのパフォーマンスをチューニングします。初期構築完了後，構築したシステム環境で，実際にJ2EEアプリケーションに負荷を掛けながら，設定したパラメタが適切かどうかを検証し，検証結果に基づいて設定を変更することで，パフォーマンスを向上させます。パラメタの設定変更は，Smart Composer機能のファイルおよびコマンドを使用します。

(5)　システムの運用

構築したシステムを運用します。システムの日常運用，システムのメンテナンス，システム構成の変更などを，必要に応じて実施します。

1.3　バッチアプリケーションを実行するシステムの構築の流れ

この節では，バッチアプリケーションを実行するシステムの構築に必要な作業として，システム設計から，構築したシステムの運用までの流れについて説明します。また，システム構築に必要な作業が，どのマニュアルに記載されているかについても説明します。システム構築に必要な作業と，マニュアルとの対応を次の図に示します。

図1-2　システム構築に必要な作業と，マニュアルとの対応（バッチアプリケーション）

図中の1.～5.について(1)～(5)で説明します。各作業の詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。なお，このマニュアルを参照している作業については，作業ごとに参照先を説明しています。

＜この節の構成＞

(1)　システムの設計

(2)　インストール

(3)　システムの構築

(4)　チューニング

(5)　システムの運用

(1)　システムの設計

動作させるアプリケーションの種類やシステム構成などについては，あらかじめマニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　システム設計ガイド」で決定しておきます。ここでは，次の作業を実施します。

システムの構成の検討
バッチアプリケーションで使用する機能に応じて，機能の実現に必要なプロセスやサーバの配置，マシンの台数などを検討します。システム全体の構成は，システムの特性や要件を考慮して決定しておいてください。システムの構成については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。
マニュアル「Cosminexus　システム設計ガイド」で決定したシステム構成を基に，Smart Composer機能の構成パターンを検討します。Smart Composer機能で構築できるシステムの構成パターンについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

使用リソースおよびメモリの見積もり
システムを動作させるために必要なリソースや，メモリを見積もります。
なお，オプション製品を使用した環境での見積もりや，プロセス単位の見積もりなどについては，「2.4　リソースの見積もりと設定」を参照してください。

運用・障害設計
システムの日常運用や保守，障害発生時のシステムの対応などを設計します。

(2)　インストール

構築するシステムに合わせて，必要な製品をインストールします。なお，オプション製品の導入手順や，構成ソフトウェアのインストールについては，「2.　インストールと初期設定」を参照してください。また，Application Serverの導入手順については，「2.1.2(1)　Application Server」を参照してください。

(3)　システムの構築

決定した構成に基づいて，システムを定義して構築します。また，構築するシステムで動作するリソースアダプタを設定します。システムを構築するために，次の作業を実施します。

なお，バッチアプリケーションを実行するシステムの構築については，「第3編　バッチアプリケーションを実行するシステムの構築」を参照してください。また，このマニュアルで説明しているシステム構築の流れについては，「11.1　システム構築の流れ」を参照してください。システム構築の一連の流れについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(a)　Management Serverの設定

Smart Composer機能で構築するシステムは，Management Serverを使用します。Management Serverを初めて使用するホストでは，Management Serverをセットアップしてください。Management Serverの設定については，「3.4　Management Serverの設定」を参照してください。

(b)　システムの構成定義

Smart Composer機能のファイルを使用して，決定したシステム構成を定義します。

(c)　使用する機能を有効にするための設定

バッチサーバの場合，必ず指定する項目があります。必ず指定する項目については，「12.2.1　バッチサーバの動作設定として必ず設定する項目」を参照してください。

また，それ以外の項目については，デフォルトの設定で無効となる機能があります。デフォルトの設定で無効となる機能を使用する場合は，Smart Composer機能のファイルなどを使用して，有効にする設定が必要になります。

バッチサーバで使用する機能に応じて設定する項目を次の表に示します。なお，これらの設定項目は，基本的にSmart Composer機能のファイルやコマンドを使用して設定します。ただし，Smart Composer機能のファイルやコマンドで設定できない場合は，そのほかのCosminexusのコマンドやファイルを使用して設定します。

表1-2　バッチサーバで使用する機能に応じて設定する項目

項目 | 説明 | 参照先
バッチサーバの動作設定 | バッチサーバの動作環境の設定をします。デフォルトのバッチサーバの動作を変更しない場合は，設定不要です。 | 12章
トラブルシューティングの資料取得の設定 | トラブルシューティングで使用する資料には，運用を開始する前に取得するための設定が必要なものがあります。デフォルトで取得する資料だけをトラブルシューティングで使用する場合は，設定不要です。 | 13章
システムの可用性を高める設定 | Managementイベントによる障害の事前検知の設定など，システムの可用性を高める設定をします。 | 14章
リソースの設定 | サーバ管理コマンドを使用して，リソースのプロパティを定義し，運用管理ドメイン内のバッチサーバにデプロイします。 | 15章

参考

Cosminexusを利用して構築したシステムでは，Smart Composer機能のコマンド以外に，運用管理コマンド（mngsvrutil）などを使用して運用できます。運用管理コマンドは，Management Serverを操作するためのコマンドで，日常の運用，保守作業を実行できます。システムの運用方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(d)　システムの構築

Smart Composer機能のコマンドを使用して，システムを構築します。

(e)　リソースアダプタの設定

リソースを利用する場合に，必要に応じて，リソースと接続するリソースアダプタを使用します。リソースアダプタは，コマンドを使用して，プロパティを設定したり，インポートしたりします。

リソースアダプタの種類や設定については，「15.　リソースの設定（バッチアプリケーションを実行するシステム）」を参照してください。

(f)　ほかのプログラムと連携するための設定

JP1やクラスタソフトウェアと連携するために必要な設定をします。JP1/AJS2を使用したバッチアプリケーションのコマンドのジョブ定義については，マニュアル「Cosminexus　機能解説」のバッチアプリケーションの実行方法に関する説明を参照してください。JP1/IM - CMおよびJP1/AJS2 - SO以外のJP1製品との連携の設定については，「16.　JP1との連携の設定」を参照してください。また，クラスタソフトウェアとの連携の設定については，「17.　クラスタソフトウェアと連携するための設定」を参照してください。

(g)　システムの開始

Smart Composer機能のコマンドを使用して，システムを開始します。

(4)　チューニング

構築したシステムで，アプリケーションサーバのパフォーマンスをチューニングします。初期構築完了後，構築したシステム環境で，設定したパラメタが適切かどうかを検証し，検証結果に基づいて設定を変更することで，パフォーマンスを向上させます。パラメタの設定変更は，Smart Composer機能のファイルおよびコマンドを使用します。

(5)　システムの運用

構築したシステムを運用します。システムの日常運用，システムのメンテナンス，システム構成の変更などを，必要に応じて実施します。

1.4　Windows Vista使用時の注意事項

この節では，Windows Vistaで，Cosminexusを使用してアプリケーションサーバを構築，運用する場合の注意事項について説明します。

＜この節の構成＞

1.4.1　管理者特権で実行する必要がある操作

1.4.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

1.4.1　管理者特権で実行する必要がある操作

ここでは，Windows Vistaを使用している場合で，管理者特権で実行する必要がある操作について説明します。なお，システムドライブをCドライブとして説明します。

＜この項の構成＞

(1)　プログラムのインストール

(2)　Cosminexusが提供するコマンドの使用

(3)　Cosminexusが提供する定義ファイルの更新

(4)　Eclipseの起動

(5)　サンプルプログラムの使用

(1)　プログラムのインストール

Cosminexusの製品や構成ソフトウェア，Eclipseなどのプログラムを，C:¥Program Files以下のディレクトリにインストールする場合，管理者特権で実行する必要があります。インストール時に，Windows Vistaの［UAC］ダイアログが表示される場合は，［UAC］ダイアログで管理者アカウントのパスワードを入力してください。

(2)　Cosminexusが提供するコマンドの使用

Cosminexusが提供するコマンドは，管理者特権で実行する必要があります。Cosminexusが提供するコマンドは，「管理者：コマンドプロンプト」で実行してください。

「管理者：コマンドプロンプト」は，Windows Vistaで提供されている機能を使用して起動してください。起動方法の例を次に示します。

［スタート］ボタンをクリックします。

［プログラム］－［アクセサリ］を選択します。

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。
管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を提供してください。

(3)　Cosminexusが提供する定義ファイルの更新

Cosminexusが提供する定義ファイルは，管理者特権で更新する必要があります。管理者特権のないユーザが定義ファイルを更新しても，C:¥Program Files以下のディレクトリにある定義ファイルは更新されません。管理者特権のないユーザが更新したファイルは，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

なお，アプリケーションサーバは管理者特権で起動されるため，管理者特権のないユーザが更新した定義ファイルの内容は無視されます。

(4)　Eclipseの起動

EclipseをC:¥Program Files以下のディレクトリにインストールしている場合，Eclipseは管理者特権で起動する必要があります。管理者特権のないユーザが，Eclipseを起動するとエラーダイアログが表示されます。

これを回避するためには，次のどちらかの方法でeclipse.exeを実行してください。

「管理者：コマンドプロンプト」でeclipse.exeを実行する。
「管理者：コマンドプロンプト」の起動方法については，「(2)　Cosminexusが提供するコマンドの使用」を参照してください。

eclipse.exeに-configurationを指定する。
指定のしかたを次に示します。

<Eclipseのインストールディレクトリ>¥eclipse.exe -configuration <任意のフォルダ>

また，C:¥Program Files以下のディレクトリまたはC:¥windows以下のディレクトリに対する操作には制限があります。これらの制限されたディレクトリに対して，Eclipseのワークスペースを保存すると，リダイレクション機能によって，操作対象のファイルはリダイレクトされ，次の場所に格納されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

保存したファイルの実体は上記の場所に格納されていますが，Eclipse上からはC:¥Program Files以下に実ファイルがあるかのように，ファイルを読み込んだり，書き込んだりできます。

(5)　サンプルプログラムの使用

Cosminexusが提供するサンプルプログラムを実行する場合は，書き込み権限のある別のディレクトリへサンプルプログラムをコピーして使用することをお勧めします。

Cosminexusの製品をデフォルトでインストールした場合，サンプルプログラムは，C:¥Program Files以下のディレクトリに格納されます。管理者特権のないユーザがサンプルプログラムを実行すると，サンプルプログラムで出力されるログファイルなどが，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

このため，Cosminexusの製品をデフォルトでインストールしたディレクトリのまま，サンプルプログラムを使用する場合は，管理者特権で実行してください。サンプルプログラムを管理者特権で使用する場合は，「管理者：コマンドプロンプト」で実行する必要があります。エクスプローラからバッチファイルを右クリックして，［管理者として実行］をクリックした場合，正しく動作しません。

なお，Cosminexusが提供するサンプルプログラムについては，「付録K　Cosminexusで提供するサンプルプログラム」を参照してください。

1.4.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

Windows VistaでサポートされたJIS X0213:2004の第三水準および第四水準の文字の一部には，Unicodeの補助文字が含まれます。Unicodeの補助文字とは，基本多言語面以外の文字（UnicodeのコードポイントがU+10000～U+10FFFFの範囲の文字）のことです。UTF-16エンコーディングでは，サロゲートペアとして表されます。

Unicodeの補助文字を使用する場合の注意事項を次に示します。

＜この項の構成＞

(1)　リクエストで使用する場合の注意事項

(2)　環境構築／運用時の注意事項

(1)　リクエストで使用する場合の注意事項

アプリケーションサーバに対して，Internet Explorer 7などのクライアントからUnicodeの補助文字を含むリクエストを送信した場合，Unicodeの補助文字は，ログやPRFトレースに正しく出力されません。ただし，その場合も，Unicodeの補助文字以外の文字は，ログやPRFトレースに正しく出力されます。

また，リクエストにUnicodeの補助文字が含まれる場合も，アプリケーションは正しく動作します。

リクエストでのUnicodeの補助文字の使用を制限したい場合には，アプリケーションでの対応などを検討してください。

(2)　環境構築／運用時の注意事項

アプリケーションサーバを構築，運用する場合，およびアプリケーションやリソースをデプロイする場合に使用する定義に，Unicodeの補助文字は使用できません。

Unicodeの補助文字を使用できない定義の例を示します。

EAR，WAR，JAR，EJB-JAR，サーブレット，JSP，クラス，メソッド，引数，または変数の名称

DD内の各種定義

システムのインストール先の指定値

そのほか，各種定義ファイルの設定値

2.　インストールと初期設定

この章では，Cosminexusの製品のインストールとアンインストール，初期設定について説明します。

＜この章の構成＞

2.1　インストールと初期設定の概要

2.2　インストールとアンインストール

2.3　環境変数の設定

2.4　リソースの見積もりと設定

2.5　Server Plug-inの設定

2.6　インストール後のディレクトリ構成

2.7　J2EEサーバの作業ディレクトリ

2.8　バッチサーバの作業ディレクトリ

2.9　複数の構築済み実行環境を切り替えるための設定（UNIXの場合）

2.1　インストールと初期設定の概要

この節では，製品をインストールして初期設定する操作の概要について説明します。

なお，このマニュアルではDeveloperのインストールや環境設定については説明しません。Developerのインストールや初期設定については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

＜この節の構成＞

2.1.1　インストールと初期設定の流れ

2.1.2　製品の導入手順

2.1.3　Component Container管理者の設定

2.1.1　インストールと初期設定の流れ

インストールと初期設定の流れを次の図に示します。

図2-1　インストールと初期設定の流れ

参考

Application Serverの場合，構築済みの環境を1台のマシンに複数共存でき，それらを切り替えて使用できます。詳細については，「2.9　複数の構築済み実行環境を切り替えるための設定（UNIXの場合）」を参照してください。

図中の1.～6.について説明します。

Cosminexusの製品をインストールします。
Cosminexusの製品には次の4種類があります。構築する環境に応じて製品をインストールしてください。

Application Server

uCosminexus Client

Web Redirector

uCosminexus Operator

インストール後，必要に応じて次の内容を設定してください。

Component Container管理者の設定

UNIXでシステムを構築および運用する場合は，構成ソフトウェアであるCosminexus Component Containerのインストール後に，Component Container管理者を設定できます。Component Container管理者を設定すると，スーパーユーザ以外でもサーバの起動・停止などの操作が実施できるようになります。Component Container管理者の設定については，「2.1.3　Component Container管理者の設定」を参照してください。

C++ライブラリのバージョン設定

Linuxの場合，プロセス内で使用するC++ライブラリのバージョンを指定します。C++ライブラリのバージョン設定については，「2.2.3　C++ライブラリのバージョン指定（Linuxの場合）」を参照してください。

環境変数を設定します。
インストールした製品の種類，使用する機能に応じて，必要な環境変数を設定します。環境変数の設定については，「2.3　環境変数の設定」を参照してください。

リソースおよびメモリ所要量を見積もって設定します。
リソースおよびメモリ所要量の見積もりと設定をします。リソースの見積もりと設定については，「2.4　リソースの見積もりと設定」を参照してください。また，メモリ所要量については，マニュアル「Cosminexus　簡易構築・運用ガイド」の仮想メモリの使用量の見積もり，およびCosminexus DABroker Libraryのメモリ所要量に関する説明を参照してください。

必要に応じて，Cosminexus DABroker Libraryの設定をします。
Cosminexus DABroker Libraryを使用してデータベースに接続する場合は，Cosminexus DABroker Libraryのセットアップ，環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルでの動作環境の設定などが必要です。なお，OSによって設定方法が異なります。Cosminexus DABroker Libraryの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

必要に応じて，データベースの設定をします。
データベースとして，HiRDB，Oracle，またはXDM/RD E2を使用する場合，環境変数や権限の設定などが必要です。データベースの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

必要に応じて，Server Plug-inの設定をします。
Server Plug-inを使用してリソースやJ2EEアプリケーションを設定する場合には，Server Plug-inのEclipseへの組み込みやServer Plug-inの環境設定などが必要です。Server Plug-inの設定については，「2.5　Server Plug-inの設定」を参照してください。

なお，このマニュアルでは，Cosminexusの製品とその構成ソフトウェアに関連した初期設定だけを説明しています。LDAPディレクトリサーバ，EISなど，ほかの製品を使用している場合は，必要に応じてそれぞれの製品のマニュアルを参照して環境を設定してください。

各製品のインストール後のディレクトリ構成については，「2.6　インストール後のディレクトリ構成」を参照してください。Cosminexusの作業ディレクトリについては，「2.7　J2EEサーバの作業ディレクトリ」または「2.8　バッチサーバの作業ディレクトリ」を参照してください。

2.1.2　製品の導入手順

次の製品の導入手順について説明します。各製品の詳細については，マニュアル「Cosminexus　概説」を参照してください。

Application Server

uCosminexus Client

Web Redirector

uCosminexus Operator

＜この項の構成＞

(1)　Application Server

(2)　uCosminexus Client

(3)　Web Redirector

(4)　uCosminexus Operator

(1)　Application Server

Application Serverは，業務システムの実行環境となるアプリケーションサーバを構築するための製品で，Application Server StandardとApplication Server Enterpriseという2種類のエディションがあります。なお，エディションによって提供される構成ソフトウェアが異なります。それぞれのエディションで提供する構成ソフトウェアについては，マニュアル「Cosminexus　概説」を参照してください。

Application Serverの導入手順を次に示します。

Application Serverをインストールします。
「2.2.1　インストール方法」を参照してください。また，インストール後のApplication Serverのディレクトリ構成については，「2.6.1　Application Serverのディレクトリ構成」を参照してください。

環境変数を設定します。
Application Serverで設定が必要な環境変数については，「2.3　環境変数の設定」を参照してください。

リソースおよびメモリ所要量の見積もりと設定をします。
Application Serverをインストールしたマシンで使用するリソースの見積もりと設定をします。リソースの見積もりと設定については，「2.4　リソースの見積もりと設定」を参照してください。また，メモリ所要量の見積もりも実施します。マニュアル「Cosminexus　簡易構築・運用ガイド」のCosminexus DABroker Libraryのメモリ所要量に関する説明を参照してください。

構成ソフトウェアの設定をします。
必要に応じて，構成ソフトウェアやデータベースの設定をしてください。また，Server Plug-inを使用する場合は，Server Plug-inの設定もします。Cosminexus DABroker Libraryおよびデータベースの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。Server Plug-inの設定については，「2.5　Server Plug-inの設定」を参照してください。なお，Server Plug-inはUNIXでは使用できません。実行環境がUNIXの場合にServer Plug-inによる運用管理操作を実施したいときは，uCosminexus Operatorをインストールしたマシンを別途用意し，このマシン上でServer Plug-inを使用してください。uCosminexus Operatorについては，「(4)　uCosminexus Operator」を参照してください。

システムを構築します。
J2EEアプリケーションを実行するシステムの場合，「1.2　J2EEアプリケーションを実行するシステムの構築の流れ」の手順に従って構築してください。また，バッチアプリケーションを実行するシステムの場合，「1.3　バッチアプリケーションを実行するシステムの構築の流れ」の手順に従って構築してください。構築手順の詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(2)　uCosminexus Client

uCosminexus Clientは，EJBクライアント環境を構築するための製品です。EJBクライアントアプリケーションを実行する環境に必要です。Application Serverに含まれるコンポーネントのうち，EJBクライアント環境に必要なコンポーネント，またはそのサブセットに当たるコンポーネントによって構成されています。

uCosminexus Clientの導入手順を次に示します。

uCosminexus Clientをインストールします。
「2.2.1　インストール方法」を参照してください。また，インストール後のuCosminexus Clientのディレクトリ構成については，「2.6.2　uCosminexus Clientのディレクトリ構成」を参照してください。

環境変数を設定します。
uCosminexus Clientで設定が必要な環境変数については，「2.3　環境変数の設定」を参照してください。

リソースの見積もりと設定をします。
uCosminexus Clientをインストールしたマシンで使用するリソースの見積もりと設定をします。リソースの見積もりと設定については，「2.4　リソースの見積もりと設定」を参照してください。

EJBクライアントの環境を構築します。
EJBクライアントアプリケーションを実行する環境は，「19.　EJBクライアントアプリケーションの設定と実行」の手順に従って構築してください。

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，各ユーザ定義ファイルの格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

(3)　Web Redirector

Web Redirectorは，WebサーバとWebコンテナを連携させるためのWebリダイレクタ環境を構築するための製品です。WebサーバとWebコンテナを別のサーバマシンで運用するシステムで，Webサーバを配置するサーバマシンにWeb Redirectorをインストールして使用します。Application Serverに含まれるコンポーネントのうち，Webリダイレクタ環境に必要なコンポーネント，またはそのサブセットに当たるコンポーネントによって構成されています。

Web Redirectorの導入手順を次に示します。

Web Redirectorをインストールします。
「2.2.1　インストール方法」を参照してください。また，インストール後のWeb Redirectorのディレクトリ構成については，「2.6.3　Web Redirectorのディレクトリ構成」を参照してください。

環境変数を設定します。
Web Redirectorで設定が必要な環境変数については，「2.3　環境変数の設定」を参照してください。

リソースの見積もりと設定をします。
Web Redirectorをインストールしたマシンで使用するリソースの見積もりと設定をします。リソースの見積もりと設定については，「2.4　リソースの見積もりと設定」を参照してください。

Webリダイレクタ環境を構築します。
Webリダイレクタを使用する環境を構築するためには，Webサーバの設定が必要です。Webサーバの設定については，「18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）」を参照してください。

注意

Web Redirectorを使用してWebリダイレクタ環境を構築する場合は，各ユーザ定義ファイルの格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC，または/opt/Cosminexus/CC」を，「<Cosminexusのインストールディレクトリ>¥CCR，または/opt/Cosminexus/CCR」と読み替えてください。

(4)　uCosminexus Operator

uCosminexus Operatorは，別のマシンからApplication Serverをインストールしたマシンの運用操作を実行するための製品です。運用操作をするための機能として，Server Plug-inを提供しています。実行環境がUNIXの場合などに，実行環境の運用操作をServer Plug-inで実施したいときに使用します。Server Plug-inは，Eclipseプラグインです。

uCosminexus Operatorの導入手順を次に示します。

uCosminexus Operatorをインストールします。
「2.2.1　インストール方法」を参照してください。また，インストール後のuCosminexus Operatorのディレクトリ構成については，「2.6.4　uCosminexus Operatorのディレクトリ構成」を参照してください。

環境変数を設定します。
uCosminexus Operatorで設定が必要な環境変数については，「2.3　環境変数の設定」を参照してください。

リソースの見積もりと設定をします。
uCosminexus Operatorをインストールしたマシンで使用するリソースの見積もりと設定をします。リソースの見積もりと設定については，「2.4　リソースの見積もりと設定」を参照してください。

Server Plug-inを設定します。
Server Plug-inを使用するためには，EclipseのインストールやServer Plug-inのEclipseへの組み込みが必要です。Server Plug-inの設定については，「2.5　Server Plug-inの設定」を参照してください。

2.1.3　Component Container管理者の設定

UNIXの場合，サーバのセットアップ，起動と停止などはスーパーユーザで実施しますが，スーパーユーザ以外の一般ユーザでも権限を与えることで実施できるようになります。このユーザをComponent Container管理者といいます。これによって，スーパーユーザ以外のユーザでもシステムを構築，運用できるようになります。

注意

Component Container管理者の設定後，Component Container管理者が実施できる操作は，一部の操作を除き，スーパーユーザでは操作できなくなるので注意してください。

Component Container管理者が実施できる操作，Component Container管理者の設定に関する注意事項について説明します。

＜この項の構成＞

(1)　Component Container管理者が実施できる操作

(2)　Component Container管理者の設定に関する注意事項

(1)　Component Container管理者が実施できる操作

Component Container管理者を設定した場合に，スーパーユーザおよびComponent Container管理者が実施できる操作を次の表に示します。

表2-1　Component Container管理者の設定がある場合に実施できる操作

操作
スーパーユーザ
Component Container管理者

Cosminexus Component Containerのインストール
○
×

Component Container管理者のセットアップ（cjenvsetupコマンド）
○
×

作業ディレクトリおよびユーザ定義ファイルの移行（cjenvupdateコマンド，cjrarupdateコマンド）
×
○

J2EEサーバまたはバッチサーバのセットアップ／アンセットアップ
（cjsetupコマンド）
×
○

リダイレクタの設定
×
○

J2EEサーバまたはバッチサーバの起動／停止
（cjstartsvコマンド，cjstopsvコマンド）
×
○

サーバ管理コマンドの実行
○
○

スレッドダンプの取得（cjdumpsvコマンド）
○
○

OS状態情報の取得（cjgetsysinfoコマンド）
○
○

バッチ実行コマンド（cjexecjobコマンド）※
○
○

バッチ強制停止コマンド（cjkilljobコマンド）※
○
○

（凡例）　○：できる。　×：できない。

注※　バッチアプリケーションの場合に使用できるコマンドです。

なお，Component Container管理者を設定しない場合は，スーパーユーザが運用管理者となるため，Component Container管理者の操作もスーパーユーザが実施します。

(2)　Component Container管理者の設定に関する注意事項

Component Container管理者の設定に関する注意事項を次に示します。

Component Container管理者のアカウント
Component Container管理者のアカウントは，Cosminexus Component Containerをインストールするホストに一つだけしか登録できないため，複数のアカウントをComponent Container管理者として登録できません。なお，Component Container管理者として使用できるアカウントは，OSにログインできるアカウントに限定されます。

Component Container管理者の管理対象のサーバ
cjsetupコマンドでセットアップするJ2EEサーバやバッチサーバだけでなく，インストール時にデフォルトでセットアップされるホスト名のサーバについても，Component Container管理者が所有者となります。サーバごとに異なるComponent Container管理者を設定することはできません。

Component Container管理者で運用する場合のポート番号の変更
Component Container管理者でCORBAネーミングサービスを起動する場合（インプロセスで起動する場合も含みます）には，簡易構築定義ファイルでポート番号の設定を変更します。論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.naming.portパラメタで，ポート番号に1,024番以上を設定してください。CORBAネーミングサービスをデフォルトのポート番号（900番），または0～1,023番のポート番号で起動する場合には，スーパーユーザで手動起動してください。
なお，root権限を持たないComponent Container管理者では，0～1,023番のポート番号を開けません。このため，Component Container管理者を設定して運用する場合には，CORBAネーミングサービス以外のポート番号についても，1,024番以上に変更してください。

Component Container管理者の変更
Component Container管理者を設定していた場合は，上書きインストール後またはアップグレードインストール後も同じユーザがComponent Container管理者となります。Component Container管理者を変更したい場合には，Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループを変更して，Component Container管理者をセットアップしてください。
Component Container管理者をスーパーユーザに戻す場合も，同様の方法で変更できます。

ディレクトリおよびファイルの所有者の変更
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内では，次に示すディレクトリを変更して使用できます。

変更できるディレクトリ
指定方法

日立JavaVMログ出力先ディレクトリ
JavaVM起動パラメタを指定します。
JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:HitachiJavaLog:<ディレクトリ名>

J2EEサーバまたはバッチサーバのログ出力ディレクトリ
ejb.server.log.directoryパラメタで指定します。

JSP用一時ディレクトリ
webserver.work.directoryパラメタで指定します。

Cosminexus TPBrokerのトレース出力先ディレクトリ
vbroker.orb.htc.tracePathパラメタで指定します。

これらのディレクトリを変更して使用している場合には，Component Container管理者のセットアップ後に，次のどちらかを実行してください。

各ディレクトリおよびファイルの所有者をComponent Container管理者に変更する。

各ディレクトリおよびファイルに，Component Container管理者の書き込み権限を設定する。

Component Container管理者を設定している場合のディレクトリの属性
Component Container管理者を設定した場合，次に示すディレクトリ下のサブディレクトリおよびファイルの属性（所有者/グループ）が「Component Container管理者/Component Container管理者グループ」に変更されます。

/opt/Cosminexus/CC

<作業ディレクトリ>/ejb/

<作業ディレクトリ>/web/

ただし，/opt/Cosminexus/CC下の一部のファイル（/opt/Cosminexus/CC/server/bin/cjenvsetup，/opt/Cosminexus/CC/server/bin/cjgetsysinfoや，インストールログなど）の属性は変更されません。

EJBクライアントアプリケーションのログ出力先ディレクトリのアクセス権の設定
Component Container管理者を設定している場合，Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）以下のファイルおよびディレクトリの属性（所有者／グループ）が「Component Container管理者／Component Container管理者グループ」に変更されます。このため，EJBクライアントアプリケーションのログ出力先にデフォルトの/opt/Cosminexus/CC/client/logsを使用していて，かつComponent Container管理者とEJBクライアントアプリケーションの実行ユーザのアカウントが異なる場合，EJBクライアントアプリケーションのログ出力時にエラーとなることがあります。この場合，ログ出力先ディレクトリに出力されたログファイルのモードを，グループやほかのすべてのユーザに対して書き込みを許可するように設定してください。アクセス権の設定については，「19.5.5　ログ出力先ディレクトリのアクセス権の設定」を参照してください。

Component Container管理者を設定している場合のメッセージ
Component Container管理者を設定している場合，アプリケーションおよび各種リソースをインポートするときに，インポート対象ファイルの読み取り権限がないために次のメッセージが出力されることがあります。このような場合は，インポート対象ファイルのアクセス権を確認してください。
アクセス権の設定が不正な場合，メッセージに，KDJE37324-Eが出力されます。

2.2　インストールとアンインストール

この節では，次の製品のインストールとアンインストールについて説明します。

Application Server

uCosminexus Client

Web Redirector

uCosminexus Operator

＜この節の構成＞

2.2.1　インストール方法

2.2.2　アンインストール方法

2.2.3　C++ライブラリのバージョン指定（Linuxの場合）

2.2.4　Cosminexusでサポートしているシンボリックリンク

2.2.1　インストール方法

製品のインストールには，HITACHI総合インストーラを使用します。

インストールを実行する前に，構成ソフトウェアのすべてのプロセスが実行中でないことを確認してください。実行中の場合は，構成ソフトウェアのすべてのプロセスを停止してから，インストールを実行してください。

インストール作業には，Windowsの場合はAdministrator権限が，UNIXの場合はroot権限が必要です。なお，Windowsの場合には，すべての構成製品のインストールが終わると，再起動を促すダイアログが表示されますが，Cosminexus DABroker Libraryの設定後にも再起動が必要になるため，Cosminexus DABroker Libraryの設定が終了したあとに再起動することをお勧めします。なお，製品のインストールについては，各製品のリリースノートを参照してください。

ここでは，製品の構成ソフトウェアのインストールについて説明します。

Cosminexus Component Containerのインストール

ほかの構成ソフトウェアのインストール

なお，製品と構成ソフトウェアの対応については，マニュアル「Cosminexus　概説」を参照してください。

＜この項の構成＞

(1)　Cosminexus Component Containerのインストール

(2)　ほかの構成ソフトウェアのインストール

(1)　Cosminexus Component Containerのインストール

Cosminexus Component Containerは，Application Serverの構成ソフトウェアです。

新規インストール，上書きインストール，アップグレードインストールの場合のインストール方法についてそれぞれ説明します。上書きインストールおよびアップグレードインストールの場合，インストール時に注意が必要です。インストール時の注意事項については，「(d)　インストール時の注意事項」を参照してください。

なお，インストールに失敗した場合は，次の点を確認してください。

起動しているサービスやアクセス中のファイル，ディレクトリがないか

ファイル，ディレクトリのアクセス権が拒否されていないか

また，J2EEサーバまたはバッチサーバでの，インストール方法ごとのユーザ環境の扱いを次の表に示します。

表2-2　インストール方法ごとのユーザ環境の扱い

インストール方法
サーバのユーザ定義
サーバ管理コマンドのユーザ定義
サーバの作業ディレクトリ※

新規インストール
インストーラが，デフォルトのサーバをセットアップし，ユーザ定義を作成します。
インストーラが，デフォルトのユーザ定義を作成します。
サーバが，初回起動時に作成します。

上書きインストール
引き継ぎます。
引き継ぎます。
引き継ぎます。

アップグレードイントール
引き継ぎます。
引き継ぎます。
インストール後，cjenvupdateコマンドを実行して移行してください。
移行情報は，既存のディレクトリに格納され，そのまま利用されます。

注※　サーバの作業ディレクトリは，J2EEサーバとバッチサーバの場合で異なります。J2EEサーバの作業ディレクトリについては，「2.7　J2EEサーバの作業ディレクトリ」を参照してください。バッチサーバの作業ディレクトリについては，「2.8　バッチサーバの作業ディレクトリ」を参照してください。

(a)　新規インストールの場合

新規インストールとは，インストール先のマシンにCosminexus Component Containerがインストールされていない場合のインストールです。新規インストールの場合の手順について，OSごとに説明します。

●Windowsの場合

インストールディレクトリにファイルがないことを確認します。
インストールディレクトリが作成されていない場合は問題ありません。
インストールディレクトリが作成されている場合は，インストールディレクトリにファイルがないことを確認してください。
デフォルトでは，次のディレクトリ群にインストールされます。

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥CC

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥manager

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥c4web

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥CWC

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥plugins

インストール先に同名のファイルがあり，保護されていない場合は，上書きする可能性があります。ファイルを別の場所に移動するか，またはインストール先を変更してください。

Cosminexus Component Containerをインストールします。

●UNIXの場合

新規インストールの場合の手順を次の図に示します。なお，Component Container管理者を設定する場合と，Component Container管理者を設定しない場合では，手順が異なります。

図2-2　Cosminexus Component Containerの新規インストールの手順

図中の1.～6.について説明します。なお，グループと管理者の登録，ディレクトリの所有者とグループの変更については，ご使用のOS付属のマニュアルなどを参照してください。

Component Container管理者を登録するグループを登録します。
ここで登録するグループをComponent Container管理者グループと呼びます。

手順1.で登録したグループに，Component Container管理者を登録します。

Cosminexus Component Containerのインストールディレクトリ下に，ファイルまたはディレクトリがないことを確認します。
インストールディレクトリが作成されていない場合は問題ありません。
インストールディレクトリがある場合，インストールディレクトリにファイルがないことを確認してください。製品のインストールするファイルまたはディレクトリと同名のファイルまたはディレクトリがある場合は，ファイルまたはディレクトリが上書きされます。必要に応じて，ディレクトリやファイルの移動，またはバックアップの作成をしてください。

Cosminexus Component Containerをインストールします。
サーバが自動的にセットアップされます。デフォルトのサーバ名称はホスト名称です。

Cosminexus Component Containerのインストールディレクトリの所有者とグループを，手順1.および手順2.で登録したComponent Container管理者とComponent Container管理者グループに変更します。

cjenvsetupコマンドを実行して，Component Container管理者をセットアップします。
cjenvsetupコマンドでのComponent Container管理者の設定後，Component Container管理者が実施できる操作は，一部の操作を除き，スーパーユーザでは操作できなくなります。詳細については，「2.1.3　Component Container管理者の設定」を参照してください。

(b)　上書きインストールの場合

Cosminexus Component Containerの上書きインストールとは，インストール先のマシンにCosminexus Component Container 07-60がインストール済みの場合のインストールです。上書きインストールの場合の手順を次に示します。

Cosminexus Component Containerをインストールします。
上書きインストールすると，前の設定が自動的に引き継がれます。
なお，デフォルトのサーバの定義ディレクトリがない場合には，次に示すように自動的にセットアップされます。

デフォルトのサーバ（ホスト名称のサーバ）の定義ディレクトリ（<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<ホスト名称>，または/opt/Cosminexus/CC/server/usrconf/ejb/<ホスト名称>）がない場合には，定義ファイルが自動的にセットアップされます。

なお，UNIXの場合，上書きインストールの操作はComponent Container管理者の設定の有無によって異なります。

Component Container管理者を設定していた場合
上書きインストール後も同じユーザがComponent Container管理者となります。上書きインストール後のサーバのセットアップ，起動と停止などの操作はComponent Container管理者が実施してください。
Component Container管理者を変更したい場合には，Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループを変更して，cjenvsetupコマンドでComponent Container管理者をセットアップしてください。

Component Container管理者を設定する場合
上書きインストール前にComponent Container管理者を設定していない状態で，上書きインストール後，新規にComponent Container管理者を設定する場合は，スーパーユーザで次の操作を実施してください。

Component Container管理者グループの登録

Component Container管理者の登録

上書きインストール

Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループの変更

cjenvsetupコマンドでComponent Container管理者のセットアップ

Component Container管理者の設定方法については，「(a)　新規インストールの場合」を参照してください。
Component Container管理者の設定後，J2EEサーバやバッチサーバのセットアップ，起動と停止などの操作はComponent Container管理者が実施してください。

Component Container管理者を設定しない場合
上書きインストール前にComponent Container管理者を設定していない状態で，上書きインストール後もそのままComponent Container管理者を設定しない場合は，J2EEサーバやバッチサーバのセットアップ，起動と停止などの操作はスーパーユーザで実施できます。

(c)　アップグレードインストールの場合

Cosminexus Component Containerのアップグレードインストール時の注意事項を次に示します。

インストーラによるユーザデータの移行作業

以前のバージョンのCosminexus Component Containerがインストールされている場合，インストール時に，インストーラによるユーザデータの移行作業が行われます。インストーラでは完全に移行できないユーザデータについては，インストール後に移行作業用のコマンドを実行して，作業ディレクトリの移行やリソースアダプタのバージョンアップなどの移行作業をしてください。

アップグレードインストール時に削除されるディレクトリ

アップグレードインストール時には次のディレクトリが削除されます。必要なファイルがある場合は，アップグレードインストール前に退避してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥help

<Cosminexusのインストールディレクトリ>¥CC¥examples

<Cosminexusのインストールディレクトリ>¥CC¥gui

UNIXの場合

/opt/Cosminexus/CC/admin/help

/opt/Cosminexus/CC/examples

/opt/Cosminexus/CC/gui

Cosminexus Web Service - Baseをインストールしている場合のアップグレードインストール

Cosminexus Web Service - BaseはCosminexus Version 6までで提供されている構成ソフトウェアです。UNIXの場合で，Cosminexus Version 7にアップグレードインストールするときは，動作モードの移行が実施されるため，次の手順に従って操作してください。

アップグレードインストールをする前に，/opt/Cosminexus/c4web/lib/current_modeファイルを退避します。

アップグレードインストールを実施します。

/opt/Cosminexus/c4web/bin/setup_mode.shコマンドを実行します。
コマンドの引数については，退避したcurrent_modeファイルの内容を参照してください。

移行作業およびバージョン間の機能の差異については，「付録A　Cosminexus Version 6およびCosminexus Version 7からの移行」を参照してください。

なお，UNIXの場合，アップグレードインストールの操作はComponent Container管理者の設定の有無によって異なります。

Component Container管理者を設定していた場合
アップグレードインストール後も同じユーザがComponent Container管理者となります。
移行作業はComponent Container管理者が実施してください。また，その後のJ2EEサーバやバッチサーバのセットアップ，起動と停止などの操作もComponent Container管理者が実施してください。
Component Container管理者を変更したい場合には，Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループを変更して，cjenvsetupコマンドでComponent Container管理者をセットアップしてください。

Component Container管理者を設定する場合
アップグレードインストール前にComponent Container管理者を設定していない状態で，アップグレードインストール後，新規にComponent Container管理者を設定する場合は，次の手順でアップグレードインストールしてください。なお，これらの操作は，すべてスーパーユーザで実施してください。

Component Container管理者グループの登録

Component Container管理者の登録

Cosminexus Component Containerのインストール

移行作業

Cosminexus Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループの変更

cjenvsetupコマンドでComponent Container管理者のセットアップ

Component Container管理者の設定方法については，「(a)　新規インストールの場合」を参照してください。
Component Container管理者の設定後，J2EEサーバやバッチサーバのセットアップ，起動と停止などの操作はComponent Container管理者が実施してください。

Component Container管理者を設定しない場合
アップグレードインストール前にComponent Container管理者を設定していない状態で，アップグレードインストール後もそのままComponent Container管理者を設定しない場合は，移行作業はスーパーユーザが実施してください。
また，その後のJ2EEサーバやバッチサーバのセットアップ，起動と停止などの操作もスーパーユーザが実施してください。

(d)　インストール時の注意事項

Cosminexus Component Containerの上書きインストールおよびアップグレードインストール時の注意事項を次に示します。

旧バージョンからアップグレードインストールする場合，作業ディレクトリのディスク使用量の2倍以上の空き容量を確保してください。

UNIXの場合，旧バージョンのインストールディレクトリが変更されていたときは，新規インストールになります。

UNIXの場合，Cosminexus Version 6までで提供している構成ソフトウェアのうち，Cosminexus Component Library，Cosminexus Manager，およびCosminexus Web Service - Baseがインストールされている環境には，Cosminexus Component Containerをインストールできません。インストールされている場合は必ずアンインストールしてください。

旧バージョンからアップグレードインストールして環境を移行した場合，作業ディレクトリは旧バージョンで使用していたディレクトリを引き続き使用します。旧バージョンの作業ディレクトリを誤って削除しないようにしてください。

このバージョン（07-60）の製品をインストールしてアンインストールしたあとに古いバージョンの製品をインストールする場合は，インストール先にこのバージョンで作成された環境（<Cosminexusのインストールディレクトリ>¥CC，または/opt/Cosminexus/CC）が残っていないことを確認してください。このバージョンで作成された環境が残っていると，古いバージョンへ移行されないため，製品の動作やそのあとのアップグレードインストールなどが保証されません。このバージョンで作成された環境が残っている場合は，インストール先を変更するか，このバージョンで作成された環境を削除または移動してからインストールしてください。

運用管理エージェントの設定ファイルであるadminagent.xmlは，インストール時に上書きされ，既存のファイルはadminagent.xml.bakとして退避されます。adminagent.xmlを編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

以前のバージョンのCosminexus Managerからの移行作業およびバージョン間の機能の差異については，「付録A　Cosminexus Version 6およびCosminexus Version 7からの移行」を参照してください。

snapshotログ収集先対象リストファイルであるsnapshotlog.conf，およびsnapshotlog.2.confは，インストール時に上書きされ，既存のファイルはsnapshotlog.conf.bak，およびsnapshotlog.2.conf.bakとして退避されます。snapshotログの収集対象を編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

(2)　ほかの構成ソフトウェアのインストール

構成ソフトウェアのインストールディレクトリにファイルがないことを確認してください。インストール先に同名のファイルがあり，保護されていない場合は，上書きされて，元のファイルが失われるおそれがあります。ファイルを別の場所に移動するか，またはインストール先を変更してください。

2.2.2　アンインストール方法

Cosminexusの製品と構成ソフトウェアのアンインストールについて説明します。

なお，アンインストールを実行する前に，構成ソフトウェアのすべてのプロセスが実行中でないことを確認してください。実行中の場合は，構成ソフトウェアのすべてのプロセスを停止してから，アンインストールを実行してください。

製品および構成ソフトウェアのアンインストールについては，各製品のリリースノートを参照してください。

ここでは，UNIXの場合に，製品および構成ソフトウェアをアンインストールする場合の注意事項について説明します。

●UNIXの場合のアンインストール時の注意事項

UNIXの場合，製品のアンインストールは，日立PPインストーラを使用します。アンインストールにはroot権限が必要です。また，製品の構成ソフトウェアすべてを一度に削除できません。構成ソフトウェアごとに削除します。

アンインストール時の注意事項
ユーザ定義ファイルなど，カスタマイズ用のファイルが格納されたディレクトリ以外は，すべて削除されます。このため，製品のディレクトリ下に必要なファイルを格納しないでください。
削除対象となっているディレクトリは無条件に削除されます。このため，これらのディレクトリにユーザ固有のファイルなどを格納しないでください。
Cosminexus DABroker Libraryをアンインストールする場合，/opt/Cosminexus/DABJは削除されないので，手動で削除してください。

日立トレース共通ライブラリのアンインストール
日立トレース共通ライブラリは，製品の構成ソフトウェアをアンインストールしたときに，必要に応じてアンインストールされます。ただし，日立トレース共通ライブラリのアンインストールに失敗してメッセージが表示された場合には，コマンドを実行して日立トレース共通ライブラリ単体でアンインストールすることもできます。
アンインストールするには，次のコマンドを実行します。

/opt/hitachi/HNTRLib2/etc/hntr2setup

メニューが表示されるので，通常アンインストールは「9」を，強制アンインストールは「0」を選択してください。

2.2.3　C++ライブラリのバージョン指定（Linuxの場合）

Linuxの場合，プロセス内で使用するC++ライブラリのバージョンを指定します。使用できるC++ライブラリのバージョンは，使用するLinuxのバージョンによって異なります。

Red Hat Enterprise Linux 3の場合
libstdc++.so.5を使用します。

Red Hat Enterprise Linux 4の場合
x64ネイティブ版を使用する場合は，libstdc++.so.6を使用します。それ以外を使用する場合は，libstdc++.so.5またはlibstdc++.so.6を使用します。

libstdc++ライブラリのバージョンは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，cpp.library.versionパラメタで指定します。

x64ネイティブ版以外を使用する場合，デフォルトでは，libstdc++.so.5を使用する設定になっているため，Red Hat Enterprise Linux 4の場合で，libstdc++.so.6を使用するときは，cpp.library.versionキーの設定を次のように変更する必要があります。

libstdc++.so.6を使用する場合の設定

cpp.library.version=6

なお，簡易構築定義ファイルについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注意事項

Red Hat Enterprise Linux 3の場合，使用できるバージョンは，libstdc++.so.5だけです。このため，Red Hat Enterprise Linux 3の場合にcpp.library.versionキーに「6」を指定すると，J2EEサーバまたはバッチサーバ起動時にエラーが発生します。なお，EJBクライアントアプリケーション開始時には，PRFの初期化に失敗しますが，例外終了しません。

cpp.library.versionキーに「5」または「6」以外の数字を指定した場合は，メッセージKDJE40056-Eが出力されます。

参考

Cosminexusでは，次に示すプロセス内でC++ライブラリをロードします。

cjstartsvプロセス（J2EEサーバまたはバッチサーバの起動）

cjclstartapプロセス（EJBクライアントアプリケーションの開始）

cjstartwebプロセス（Webコンテナサーバの起動）

2.2.4　Cosminexusでサポートしているシンボリックリンク

UNIXの場合，次のディレクトリのシンボリックリンクをサポートしています。

/opt/Cosminexus/CC

/opt/Cosminexus/CCR

/opt/Cosminexus/manager

/opt/Cosminexus/c4web

/opt/Cosminexus/CWC

ただし，これらのディレクトリより下位のディレクトリのシンボリックリンクは未サポートとなります。

2.3　環境変数の設定

この節では，Application Server，uCosminexus Client，Web Redirector，uCosminexus Operatorで設定する環境変数について説明します。

＜この節の構成＞

2.3.1　環境変数の設定の要否

2.3.2　環境変数の詳細

2.3.3　AIX固有の環境変数

2.3.1　環境変数の設定の要否

Application Server，uCosminexus Client，Web Redirector，uCosminexus Operatorで設定する環境変数は，製品の種類，使用する機能によって異なります。次の表を参考にして，環境変数を設定してください。

表2-3　製品の種類および設定する環境変数の分類の対応

製品の種類
設定する環境変数の分類

Application Server（J2EEアプリケーションの実行環境）

CTMを使用しない場合
表2-4または表2-5のAを参照

CTMを使用する場合
表2-4または表2-5のBを参照

Application Server（バッチアプリケーションの実行環境）
表2-4または表2-5のAを参照

Web Redirector
表2-4または表2-5のCを参照

uCosminexus Client
「19.2　EJBクライアントアプリケーションの環境変数の設定」を参照

uCosminexus Operator
表2-4のDを参照

次に，それぞれの場合で設定が必要な環境変数について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windowsの場合に設定する環境変数と設定値を次の表に示します。環境変数の詳細については，「2.3.2　環境変数の詳細」を参照してください。

表2-4　設定する環境変数と設定値（Windowsの場合）

環境変数名 | 設定値 | 設定する環境変数の分類
A | B | C | D
PATH | <Cosminexusのインストールディレクトリ>¥jdk¥bin※ | ○ | ○ | － | ○
<Cosminexusのインストールディレクトリ>¥TPB¥bin | ○ | ○ | － | －
<Cosminexusのインストールディレクトリ>¥PRF¥bin | ○ | ○ | － | －
<ProgramFiles>¥Common Files¥Hitachi | ▲ | ▲ | － | －
TPDIR | <Cosminexusのインストールディレクトリ>¥TPB | ○ | ○ | － | －
VBROKER_ADM | <Cosminexusのインストールディレクトリ>¥TPB¥adm　など | ○ | ○ | － | －
PRFSPOOL | <Cosminexusのインストールディレクトリ>¥PRF¥spool | ▲ | ▲ | ▲ | －
OSAGENT_PORT | 14000　など | － | △ | － | －
CTMDIR | <Cosminexusのインストールディレクトリ>¥CTM | － | ○ | － | －
CTMSPOOL | %CTMDIR%¥spool | － | △ | － | －
TZ | JST-9　など | ○ | ○ | ○ | ○

（凡例）

○：設定する。

▲：インストーラによって設定される。

△：必要に応じて設定する。

－：設定しない。

注※　CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に指定してください。

注意

CLASSPATHは空にしてください。CLASSPATHは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に設定します。簡易構築定義ファイルの指定内容を次に示します。

<param-name>タグ

add.class.path

<param-value>タグ

設定値

(2)　UNIXの場合

UNIXの場合に設定する環境変数と設定値を次の表に示します。環境変数の詳細については，「2.3.2　環境変数の詳細」を参照してください。なお，AIXの場合は，次の表に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。詳細については，「2.3.3　AIX固有の環境変数」を参照してください。

表2-5　設定する環境変数と設定値（UNIXの場合）

環境変数名
設定値
設定する環境変数の分類

A
B
C

LIBPATH，
LD_LIBRARY_PATH※1
/opt/Cosminexus/TPB/lib
○
○
－

/opt/Cosminexus/PRF/lib
○
○
－

/opt/Cosminexus/CTM/lib
－
○
－

/opt/hitachi/common/lib
○
○
－

CSCCFJ_SERVER_HOME
/opt/Cosminexus/CC
○
○
－

PATH
/opt/Cosminexus/jdk/bin※2
○
○
－

/opt/Cosminexus/TPB/bin
○
○
－

/opt/Cosminexus/PRF/bin
○
○
－

/bin
○
○
－

TPDIR
/opt/Cosminexus/TPB
○
○
－

VBROKER_ADM
/opt/Cosminexus/TPB/adm　など
○
○
－

PRFSPOOL
/opt/Cosminexus/PRF/spool
○
○
○

OSAGENT_PORT
14000　など
－
△
－

CTMDIR
/opt/Cosminexus/CTM
－
○
－

CTMSPOOL
/opt/Cosminexus/CTM/spool
－
△
－

TZ
JST-9　など
○
○
○

（凡例）

○：設定する。

△：必要に応じて設定する。

－：設定しない。

注※1　OSによって，使用する環境変数名が異なります。

LIBPATH：AIXの場合

LD_LIBRARY_PATH：HP-UX（IPF），Linux，またはSolarisの場合

注※2　CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に指定してください。

注意

CLASSPATHは空にしてください。CLASSPATHは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に設定します。簡易構築定義ファイルの指定内容を次に示します。

<param-name>タグ

add.class.path

<param-value>タグ

設定値

2.3.2　環境変数の詳細

表2-4および表2-5に示す環境変数の詳細を説明します。

LIBPATH，またはLD_LIBRARY_PATH

指定する環境変数はOSごとに異なります。

LIBPATH
AIXを使用している場合は，LIBPATHに指定します。

LD_LIBRARY_PATH
HP-UX（IPF）を使用している場合，Linuxを使用している場合，およびSolarisを使用している場合は，LD_LIBRARY_PATHに指定します。

使用しているOSの環境変数に次のパスを指定してください。

/opt/Cosminexus/TPB/lib

/opt/Cosminexus/PRF/lib

/opt/Cosminexus/CTM/lib

/opt/hitachi/common/lib

なお，「/opt/Cosminexus/CTM/lib」は，表2-4の設定する環境変数の分類がBの場合に必要です。

CSCCFJ_SERVER_HOME

Cosminexus Component Containerのインストールディレクトリとして，次の値を指定してください。

/opt/Cosminexus/CC

PATH

次のパスを指定してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥jdk¥bin※1

<Cosminexusのインストールディレクトリ>¥TPB¥bin

<Cosminexusのインストールディレクトリ>¥PRF¥bin

<ProgramFiles>¥Common Files¥Hitachi※2

UNIXの場合

/opt/Cosminexus/jdk/bin※1

/opt/Cosminexus/TPB/bin

/opt/Cosminexus/PRF/bin

/bin

注※1

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に指定してください。

注※2

デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

なお，CTMドメインマネジャやCTMを起動するときには，パフォーマンストレーサのパス（<Cosminexusのインストールディレクトリ>¥PRF¥bin）を同時に設定しないでください。パフォーマンストレーサのパスを同時に設定すると，CTMがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

TPDIR

Cosminexus TPBrokerのインストールディレクトリとして，次の値を指定してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥TPB

UNIXの場合

/opt/Cosminexus/TPB

VBROKER_ADM

ログ出力先などの管理ディレクトリを指定してください。通常，次の値を指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥TPB¥adm

UNIXの場合

/opt/Cosminexus/TPB/adm

PRFSPOOL

Windowsの場合

必要に応じて，PRFデーモンの実行環境ディレクトリを変更してください。デフォルトでは，インストーラによってシステム環境変数に<Cosminexusのインストールディレクトリ>¥PRF¥spoolが設定されています。

UNIXの場合

パフォーマンストレーサの実行環境ディレクトリを指定してください。デフォルトのディレクトリ「/opt/Cosminexus/PRF/spool」がインストーラによって作成されています。

デフォルトのディレクトリを変更する場合は，パフォーマンストレーサの実行環境ディレクトリを作成して，この環境変数に指定してください。環境変数が指定されていない場合，パフォーマンストレーサは動作しません。

OSAGENT_PORT

スマートエージェント（osagent）が使用するポート番号を指定してください。5,001～65,535の整数で指定します。デフォルトは，「14000」です。

CTMDIR

CTMのインストールディレクトリとして，次の値を指定してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CTM

UNIXの場合

/opt/Cosminexus/CTM

CTMSPOOL

CTMの実行環境ディレクトリを指定してください。デフォルトのディレクトリがインストーラによって作成されます。

デフォルトのディレクトリを次に示します。

Windowsの場合

%CTMDIR%¥spool

UNIXの場合

/opt/Cosminexus/CTM/spool

デフォルトのディレクトリを変更する場合は，CTMの実行環境ディレクトリを作成して，この環境変数に指定してください。

TZ

タイムゾーンを設定してください。通常，「JST-9」を指定します。

2.3.3　AIX固有の環境変数

AIXの場合は，表2-5に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。AIX固有の環境変数を次の表に示します。

表2-6　AIX固有の環境変数

環境変数名
設定値
説明

PSALLOC※1 ※2
early
メモリ確保時に必要なページングスペースをすぐに確保する設定にします。

NODISCLAIM※1 ※2
true
free()に対するコールの処理方法として，nodisclaim()の発行抑止をする設定にします。

AIXTHREAD_SCOPE※2
S
コンテンションの有効範囲として，システム・ベースのコンテンションの有効範囲（1:1）を設定します。

AIXTHREAD_MUTEX_DEBUG※2
OFF
デバッグリストを使用しない設定にします。

AIXTHREAD_RWLOCK_DEBUG※2
OFF
デバッグリストを使用しない設定にします。

AIXTHREAD_COND_DEBUG※2
OFF
デバッグリストを使用しない設定にします。

EXTSHM
ON
プロセス空間の共有メモリ領域数の制限をなくす設定にします。

LDR_CNTRL（任意）
MAXDATA=0x40000000
カーネルの従来の区分化より大きいデータエリアを扱えるようにするための設定です。必要に応じて設定してください。
「0x40000000」は，未設定時のJ2EEサーバのmalloc領域サイズ（単位：バイト）です。mmap領域のJavaHeapや共用メモリなどを確保するためには，指定サイズを小さくするなど調整してください。

LC__FASTMSG（任意）
false
Cosminexus DABroker Libraryを使用してDBにアクセスし，かつCosminexus Component ContainerをCロケールで動作させる場合には，環境変数「LC__FASTMSG」に「false」を指定してください。

注※1　システム構築の初期段階でメモリの見積もりができていない場合は，Hitachi Web Serverに対してPSALLOCにearly，およびNODISCLAIMにtrueを設定しないでください。設定した場合，ページングスペースが十分に確保できなくなり，プロセスの起動に失敗することがあります。

注※2　Management Server利用時，これらの環境変数に対してユーザ側で値を設定していない場合には，運用管理エージェントに「設定値」に示した値が自動的に設定されます。なお，ユーザが値を設定している場合は，ユーザが設定した値が有効になります。

2.4　リソースの見積もりと設定

この節では，Cosminexusの各プロセスで使用するリソースの見積もり方法について説明します。Cosminexusを動作させるために必要なディスクおよびメモリの容量を算出するときの参考にしてください。

＜この節の構成＞

2.4.1　J2EEサーバが使用するリソースの見積もり

2.4.2　バッチサーバが使用するリソースの見積もり

2.4.3　運用管理エージェントが使用するリソースの見積もり

2.4.4　パフォーマンストレーサが使用するリソースの見積もり

2.4.5　CTMが使用するリソースの見積もり

2.4.1　J2EEサーバが使用するリソースの見積もり

J2EEサーバプロセスのスレッド数とファイルディスクリプタ数については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

参考

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバの計算式を使用して算出してください。

2.4.2　バッチサーバが使用するリソースの見積もり

バッチサーバプロセスのスレッド数とファイルディスクリプタ数については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

2.4.3　運用管理エージェントが使用するリソースの見積もり

運用管理エージェントが使用するリソースの計算式についてOSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windowsを使用する場合のスレッド数の計算式を次に示します。

スレッド数の計算式
使用スレッド数 = 30 + 論理サーバを構成するプロセスの数 × 7
（凡例）

30：運用管理エージェント本体が使用するスレッド数

7：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するスレッド数

論理サーバのステータスが稼働になったあとのスレッド数の計算式を次に示します。

平時のスレッド数の計算式
使用スレッド数 = 30 + 論理サーバを構成するプロセスの数 × 5
（凡例）

30：運用管理エージェント本体が使用するスレッド数

5：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するスレッド数

(2)　UNIXの場合

UNIXを使用する場合のスレッド数とファイルディスクリプタ数の計算式について説明します。

(a)　スレッド数

スレッド数の計算式を次に示します。

スレッド数の計算式
使用スレッド数 = 30 + 論理サーバを構成するプロセスの数 × 7
（凡例）

30：運用管理エージェント本体が使用するスレッド数

7：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するスレッド数

論理サーバのステータスが稼働になったあとのスレッド数の計算式を次に示します。

平時のスレッド数の計算式
使用スレッド数 = 30 + 論理サーバを構成するプロセスの数 × 5
（凡例）

30：運用管理エージェント本体が使用するスレッド数

5：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するスレッド数

(b)　ファイルディスクリプタ数

ファイルディスクリプタ数の計算式を次に示します。

ファイルディスクリプタ数の計算式
使用ファイルディスクリプタ数 = 20 + 論理サーバを構成するプロセスの数 × 6
（凡例）

20：運用管理エージェント本体が使用するファイルディスクリプタ数

6：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するファイルディスクリプタ数

論理サーバのステータスが稼働になったあとのファイルディスクリプタ数の計算式を次に示します。

平時のファイルディスクリプタ数の計算式
使用ファイルディスクリプタ数 = 20 + 論理サーバを構成するプロセスの数 × 3
（凡例）

20：運用管理エージェント本体が使用するファイルディスクリプタ数

3：論理サーバを構成する1プロセス当たりで運用管理エージェントが使用するファイルディスクリプタ数

2.4.4　パフォーマンストレーサが使用するリソースの見積もり

パフォーマンストレーサが使用するリソースの見積もりについて，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　AIXの場合

(3)　HP-UXの場合

(4)　Linuxの場合

(5)　Solarisの場合

(1)　Windowsの場合

Windowsを使用する場合の，パフォーマンストレーサが使用するリソースの見積もりについて説明します。

(a)　共用メモリ用ファイルサイズ

パフォーマンストレーサが使用する共用メモリ用ファイルサイズ（単位：バイト）は，PRFデーモンごとに算出します。計算式を次に示します。

PRFデーモンごとの共用メモリの計算式
共用メモリ用ファイルサイズ = -PrfTraceBufferSize指定値×1024 + 18496

(b)　%PRFSPOOL%のディスク占有量

%PRFSPOOL%のディスク占有量の計算式を次に示します。

%PRFSPOOL%のディスク占有量の計算式
ディスク占有量 = 2.0MB
＋｛（-PrfTraceBufferSize指定値＋20KB）×4
＋-PrfTraceFileSize指定値×-PrfTraceCount指定値×2｝×n
＋224KB×m
＋1120KB×（64＋p）
（凡例）

n：PRFデーモンの数

m：起動中のユーザアプリケーションのプロセス数と正常終了しなかったユーザアプリケーションのプロセス数
パフォーマンストレーサでは，ユーザアプリケーションごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されますが，プロセスが正常終了しない場合はファイルが残ります。ファイルの削除処理はPRFデーモン起動時，およびPRFデーモン起動後24時間ごとに実施しますが，256ファイルは削除されないで残ります。このため，最大ファイル数は「256＋起動中プロセス数」になります。

p：起動中のシステム系プロセス数
パフォーマンストレーサでは，プロセスごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されます。PRFデーモン起動時，およびPRFデーモン起動後24時間ごとにファイル削除処理を実施しますが，64ファイルは削除されないで残ります。このため，最大ファイル数は「64＋起動中プロセス数」になります。

上記のディスク容量は目安です。このため，十分な余裕を持って，%PRFSPOOL%を作成してください。

(2)　AIXの場合

AIXを使用する場合，パフォーマンストレーサを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，パフォーマンストレーサのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

パフォーマンストレーサが使用する共用メモリ用ファイルサイズ（単位：バイト）は，PRFデーモンごとに算出します。計算式を次に示します。

PRFデーモンごとの共用メモリの計算式
共用メモリ用ファイルサイズ = -PrfTraceBufferSize指定値×1024 + 18496

共用メモリ用ファイルサイズは，環境変数EXTSHMで設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。

(b)　ファイルディスクリプタ数

ファイルディスクリプタ数は，/etc/security/limitsファイルの「nofiles」で設定します。PRFデーモン起動時に使用するファイルディスクリプタの数は，32以上に設定してください。

(c)　$PRFSPOOLのディスク占有量

$PRFSPOOLのディスク占有量の計算式を次に示します。

$PRFSPOOLのディスク占有量の計算式
ディスク占有量 = 2.0MB
＋｛（-PrfTraceBufferSize指定値＋20KB）×4
＋-PrfTraceFileSize指定値×-PrfTraceCount指定値×2｝×n
＋224KB×m
＋1120KB×（64＋p）
（凡例）

n：PRFデーモンの数

m：起動中のユーザアプリケーションのプロセス数と正常終了しなかったユーザアプリケーションのプロセス数
パフォーマンストレーサでは，ユーザアプリケーションごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されますが，プロセスが正常終了しない場合はファイルが残ります。ファイルの削除処理はPRFデーモン起動時，およびPRFデーモン起動後24時間ごとに実施しますが，256ファイルは削除されないで残ります。このため，最大ファイル数は「256＋起動中プロセス数」になります。

p：起動中のシステム系プロセス数
パフォーマンストレーサでは，プロセスごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されます。PRFデーモン起動時，およびPRFデーモン起動後24時間ごとにファイル削除処理を実施しますが，64ファイルは削除されないで残ります。このため，最大ファイル数は「64＋起動中プロセス数」になります。

上記のディスク容量は目安です。このため，十分な余裕を持って，$PRFSPOOLを作成してください。

(3)　HP-UXの場合

HP-UXを使用する場合，パフォーマンストレーサを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，パフォーマンストレーサのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

パフォーマンストレーサが使用する共用メモリ用ファイルサイズ（単位：バイト）は，PRFデーモンごとに算出します。計算式を次に示します。

PRFデーモンごとの共用メモリの計算式
共用メモリ用ファイルサイズ = -PrfTraceBufferSize指定値×1024 + 18496

共用メモリ用ファイルサイズは，Kernel Configurationの「shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。

(b)　ファイルディスクリプタ数

ファイルディスクリプタ数は，Kernel Configurationの「maxfiles」で設定します。PRFデーモン起動時に使用するファイルディスクリプタの数は，32以上に設定してください。

(c)　$PRFSPOOLのディスク占有量

$PRFSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(4)　Linuxの場合

Linuxを使用する場合，パフォーマンストレーサを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，パフォーマンストレーサのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

パフォーマンストレーサが使用する共用メモリ用ファイルサイズ（単位：バイト）は，PRFデーモンごとに算出します。計算式を次に示します。

PRFデーモンごとの共用メモリの計算式
共用メモリ用ファイルサイズ = -PrfTraceBufferSize指定値×1024 + 18496

共用メモリ用ファイルサイズは，/etc/sysctl.confファイルの「kernel.shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。

(b)　ファイルディスクリプタ数

ファイルディスクリプタ数は，/etc/security/limits.confファイルの「nofiles」で設定します。PRFデーモン起動時に使用するファイルディスクリプタの数は，32以上に設定してください。

(c)　$PRFSPOOLのディスク占有量

$PRFSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(5)　Solarisの場合

Solarisを使用する場合，パフォーマンストレーサを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，パフォーマンストレーサのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

パフォーマンストレーサが使用する共用メモリ用ファイルサイズ（単位：バイト）は，PRFデーモンごとに算出します。計算式を次に示します。

PRFデーモンごとの共用メモリの計算式
共用メモリ用ファイルサイズ = -PrfTraceBufferSize指定値×1024 + 18496

共用メモリ用ファイルサイズは，/etc/systemファイルの「shmsys:shminfo_shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。

(b)　ファイルディスクリプタ数

ファイルディスクリプタ数は，/etc/systemファイルの「rlim_fd_max」で設定します。PRFデーモン起動時に使用するファイルディスクリプタの数は，32以上に設定してください。

(c)　$PRFSPOOLのディスク占有量

$PRFSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

2.4.5　CTMが使用するリソースの見積もり

CTMが使用するリソースの見積もりについて，OSごとに説明します。なお，バッチアプリケーションの実行環境ではCTMは使用できません。

＜この項の構成＞

(1)　Windowsの場合

(2)　AIXの場合

(3)　HP-UXの場合

(4)　Linuxの場合

(5)　Solarisの場合

(1)　Windowsの場合

Windowsを使用する場合にCTMが使用するリソースの見積もりについて説明します。

(a)　共用メモリ用ファイルサイズ

CTMで使用する共用メモリ用ファイルサイズ（単位：バイト）の計算式について説明します。CTMデーモンの場合は，複数の共用メモリを確保する必要があります。CTMデーモン単位で固定長の共用メモリファイルと，可変長の共用メモリファイルがあります。それぞれのファイルサイズの計算式を次に示します。

CTMドメインマネジャの共用メモリ用ファイルサイズの計算式
共用メモリ用ファイルサイズ = 1018320＋（2362 × -CTMMaxCTM指定値）

CTMデーモンの共用メモリ用ファイルサイズの計算式
CTMデーモンの場合は，CTMデーモン単位で固定長の共用メモリ用ファイルと可変長の共用メモリ用ファイルを確保する必要があります。

固定長の共用メモリ用ファイルサイズ =
551840 ＋ （1208 × -CTMQueueCount指定値）

可変長の共用メモリ用ファイルサイズ =
1027008
＋（928 × -CTMClientConnectCount指定値）
＋（256 × -CTMServerConnectCount指定値）
＋（512 × -CTMEntryCount指定値）
＋（1024 ×-CTMServerCacheSize指定値）
＋（512 × -CTMQueueCount指定値）
＋（544 × -CTMQueueCount指定値 × -CTMQueueRegistCount指定値）
＋（512 × -CTMDispatchParallelCount指定値）

(b)　稼働統計情報ファイルサイズ

稼働統計情報ファイルサイズ（単位：バイト）の計算式を次に示します。

オンライン開始から終了までに必要な稼働統計情報ファイルサイズの計算式
ファイルサイズ = A＋B
（凡例）

A：（オンライン開始から終了までに実行されるリクエストの数）×（1リクエストで出力される情報量）

B：（オンライン開始から終了までの時間（分） ／ ctmstsstart -CTMIntervalに指定した取得間隔）×（1回に出力されるCTMノード単位，キュー単位統計情報量）

1リクエストで出力される情報量と，1回に出力されるCTMノード単位，キュー単位統計情報量の計算式を次に示します。

1リクエストで出力される情報量の計算式
情報量 = （↑（80＋A＋B＋C＋D＋63） / 64↑ × 64） × 3
（凡例）

A：リクエストを実行するアプリケーションを管理しているCTMドメインのドメイン長

B：リクエストを実行するアプリケーションを管理しているCTMデーモンのCTM識別子の長さ

C：キュー名称の長さ

D：オペレーション名称の長さ

1回に出力されるCTMノード単位，キュー単位統計情報量の計算式
統計情報量 = ↑（2144＋344 × キュー数＋63） / 64↑ × 64

(c)　%CTMSPOOL%のディスク占有量

%CTMSPOOL%のディスク占有量の計算式を次に示します。

%CTMSPOOL%のディスク占有量の計算式
ディスク占有量 = 7.0MB
＋（18.5MB＋1.0MB×-CTMLogFileSize指定値×-CTMLogFileCount指定値）×n
＋（1KB＋0.5KB×k）×（m＋l）
＋ 1KB×m×j
＋ 224KB×p
＋ 1120KB×（64＋q）
＋ CTMドメインマネジャの共有メモリ用ファイルサイズ×5
＋ CTMデーモンの共有メモリ用ファイルサイズ×5×n
＋ CTMドメインマネジャのcoreサイズ
＋ CTMデーモンのcoreサイズ×n
＋ CTMレギュレータのcoreサイズ×3×m
＋ OTMゲートウェイのcoreサイズ×3×l
＋（-CTMStatsFileSize指定値×-CTMStatsFileCount指定値）×n
（凡例）

j：EJBの総数

k：CTMレギュレータおよびOTMゲートウェイに接続できるクライアント数（-CTMClientConnectCountオプション指定値）

l：OTMゲートウェイの総数

m：CTMレギュレータの総数

n：CTMデーモンの数

p：起動中のユーザアプリケーションのプロセス数と正常終了しなかったユーザアプリケーションのプロセス数
CTMでは，ユーザアプリケーションごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されますが，プロセスが正常終了しない場合はファイルが残ります。ファイルの削除処理はCTMドメインマネジャ起動時，およびCTMドメインマネジャ起動後24時間ごとに実施しますが，256ファイルは削除されないで残ります。このため，最大ファイル数は「256＋起動中プロセス数」になります。

q：起動中のシステム系プロセス数
CTMでは，プロセスごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されます。CTMドメインマネジャ起動時，およびCTMドメインマネジャ起動後24時間ごとにファイル削除処理を実施しますが，64ファイルは削除されないで残ります。このため，最大ファイル数は「64＋起動中プロセス数」になります。

上記のディスク容量は目安です。このため，十分な余裕を持って，%CTMSPOOL%を作成してください。

(2)　AIXの場合

AIXを使用する場合，CTMを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，CTMのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

共用メモリ用ファイルサイズは，環境変数EXTSHMで設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。なお，計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(b)　稼働統計情報ファイルサイズ

稼働統計情報ファイルサイズの計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(c)　ファイルディスクリプタ数

CTMデーモンでは，起動時のオプションを基に，次の計算式で示すように，プロセスで使用できるファイルディスクリプタの数を増加させます。OSの設定値が，計算式で設定したCTMデーモンで必要とするファイルディスクリプタの最大値に満たない場合には，プロセス起動でエラー終了します。計算式を基に/etc/security/limits.confファイルの「nofiles」を変更してください。

CTMデーモンで必要とするファイルディスクリプタ数の最大値の計算式
最大値 = （A×2＋B×4＋C×2＋D×E＋F×EJB数＋G＋100） / 0.8
（凡例）

A：-CTMMaxCTM値（ctmdが属するctmdmdで指定された値）

B：-CTMClientConnectCount値

C：-CTMServerConnectCount値

D：-CTMQueueCount値

E：-CTMQueueRegistCount値

F：-CTMDispatchParallelCount値

G：Createを発行するEJBクライアントの総数

(d)　$CTMSPOOLのディスク占有量

$CTMSPOOLのディスク占有量の計算式を次に示します。

$CTMSPOOLのディスク占有量の計算式
ディスク占有量 = 7.0MB
＋（18.5MB＋1.0MB×-CTMLogFileSize指定値×-CTMLogFileCount指定値）×n
＋（1KB＋0.5KB×k）×（m＋l）
＋ 1KB×m×j
＋ 224KB×p
＋ 1120KB×（64＋q）
＋ CTMドメインマネジャの共有メモリ用ファイルサイズ×5
＋ CTMデーモンの共有メモリ用ファイルサイズ×5×n
＋ CTMドメインマネジャのcoreサイズ
＋ CTMデーモンのcoreサイズ×n
＋ CTMレギュレータのcoreサイズ×3×m
＋ OTMゲートウェイのcoreサイズ×3×l
＋（-CTMStatsFileSize指定値×-CTMStatsFileCount指定値）×n
（凡例）

j：EJBの総数

k：CTMレギュレータおよびOTMゲートウェイに接続できるクライアント数（-CTMClientConnectCountオプション指定値）

l：OTMゲートウェイの総数

m：CTMレギュレータの総数

n：CTMデーモンの数

p：起動中のユーザアプリケーションのプロセス数と正常終了しなかったユーザアプリケーションのプロセス数
CTMでは，ユーザアプリケーションごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されますが，プロセスが正常終了しない場合はファイルが残ります。ファイルの削除処理はCTMドメインマネジャ起動時，およびCTMドメインマネジャ起動後24時間ごとに実施しますが，256ファイルは削除されないで残ります。このため，最大ファイル数は「256＋起動中プロセス数」になります。

q：起動中のシステム系プロセス数
CTMでは，プロセスごとに，保守情報として内部トレースをファイルに出力します。このファイルはプロセス起動時に作成されます。CTMドメインマネジャ起動時，およびCTMドメインマネジャ起動後24時間ごとにファイル削除処理を実施しますが，64ファイルは削除されないで残ります。このため，最大ファイル数は「64＋起動中プロセス数」になります。

上記のディスク容量は目安です。このため，十分な余裕を持って，$CTMSPOOLを作成してください。

(3)　HP-UXの場合

HP-UXを使用する場合，CTMを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，CTMのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

共用メモリ用ファイルサイズは，Kernel Configurationの「shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。なお，計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(b)　稼働統計情報ファイルサイズ

稼働統計情報ファイルサイズの計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(c)　ファイルディスクリプタ数

ファイルディスクリプタ数は，Kernel Configurationの「maxfiles」で設定します。計算式を基に「maxfiles」を変更してください。なお，計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(d)　スレッド数

CTMデーモンでは，J2EEサーバの起動やJ2EEアプリケーションの開始，およびEJBクライアントからの要求に対してスレッドが作成されます。計算式を基に，プロセスで使用するスレッドの最大値をKernel Configurationの「max_thread_proc」で変更してください。

CTMデーモンで必要とするスレッド数の最大値の計算式
最大値 = （A×4＋B×3＋C×2＋D×E＋F＋G＋32） / 0.8
（凡例）

A：-CTMMaxCTM値（ctmdが属するctmdmdで指定された値）

B：-CTMClientConnectCount値

C：-CTMServerConnectCount値

D：-CTMQueueCount値

E：-CTMQueueRegistCount値

F：-CTMDispatchParallelCount値

G：Createを発行するEJBクライアントの総数

(e)　$CTMSPOOLのディスク占有量

$CTMSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(4)　Linuxの場合

Linuxを使用する場合，CTMを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，CTMのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

共用メモリ用ファイルサイズは，/etc/sysctl.confファイルの「kernel.shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。なお，計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(b)　稼働統計情報ファイルサイズ

稼働統計情報ファイルサイズの計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(c)　ファイルディスクリプタ数

ファイルディスクリプタ数は，/etc/security/limits.confファイルの「nofiles」で設定します。計算式を基に「nofiles」を変更してください。なお，計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(d)　$CTMSPOOLのディスク占有量

$CTMSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(5)　Solarisの場合

Solarisを使用する場合，CTMを使用するために，次の値を考慮してカーネルパラメタを設定する必要があります。正しく設定できていない場合には，CTMのプロセスが起動できなかったり，動作中にリソース不足で異常終了になったりするおそれがあります。なお，カーネルパラメタの設定については，使用しているOSのマニュアルを参照してください。

(a)　共用メモリ用ファイルサイズ

共用メモリ用ファイルサイズは，/etc/systemファイルの「shmsys:shminfo_shmmax」で設定します。計算式で算出した値以上に共用メモリが割り当てられるように設定してください。なお，計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(b)　稼働統計情報ファイルサイズ

稼働統計情報ファイルサイズの計算式については，Windowsの場合と同じです。Windowsの計算式を参照してください。

(c)　ファイルディスクリプタ数

ファイルディスクリプタ数は，計算式を基に/etc/systemファイルの「rlim_fd_max」で設定します。計算式を基に「rlim_fd_max」を変更してください。なお，計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

(d)　$CTMSPOOLのディスク占有量

$CTMSPOOLのディスク占有量の計算式については，AIXの場合と同じです。AIXの計算式を参照してください。

2.5　Server Plug-inの設定

この節では，Server Plug-inを使用するための設定について説明します。Server Plug-inを使用してリソースアダプタやJ2EEアプリケーションの設定をする場合，あらかじめ，Server Plug-inを使用するための設定をしておく必要があります。次にServer Plug-inの設定の手順を示します。

Eclipseをインストールします。
インストールの手順については，Eclipseのドキュメントを参照してください。

Java実行環境を指定します。
Eclipseを使用するにはJava実行環境が必要です。Java実行環境の指定については，「2.5.1　Java実行環境の指定」を参照してください。

Server Plug-inをEclipseに組み込みます。
Server Plug-inの組み込み手順については，「2.5.2　Server Plug-inの組み込み手順」を参照してください。

Management Serverで，Server Plug-inを使用するための設定をします。
Server Plug-inが接続するManagement Serverで，Server Plug-inを使用するための設定をします。Server Plug-inを使用するための設定については，「2.5.3　Server Plug-inを使用するためのManagement Serverの設定」を参照してください。

Server Plug-inの環境設定をします。
Server Plug-inの環境設定では，ホストへの接続情報を設定します。
Server Plug-inはManagement Serverに接続して，Management Serverが管理している運用管理ドメイン内の論理サーバの操作をします。このため，操作したい運用管理ドメインが定義されているホストへの接続について設定します。
uCosminexus Operatorの場合は，接続先のApplication Serverマシンで定義されているホストについて，接続情報を設定します。
Server Plug-inの環境設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

また，必要に応じて，次の設定をしてください。

Server Plug-inの表示言語の変更
Server Plug-inの表示言語を変更できます。Server Plug-inの表示言語はOSのロケールに合わせて選択されますが，OSのロケールと異なる言語を表示させたい場合は，次のどちらかの方法で言語を指定してください。

Eclipseで提供されているeclipse.iniファイル内に次の行を追加する。
-vmargs
-Duser.language=en※

Eclipseの起動引数に次の内容を指定する。
exlipse.exe -vmargs -Duser.language=en※

注※

英語表示の場合は「en」，日本語表示の場合は「ja」を指定します。

コンテナ拡張ライブラリを使用するための設定
コンテナ拡張ライブラリを使用する場合は，運用管理エージェントのシステムクラスパスの設定が必要になります。さらに，コンテナ拡張ライブラリからJNI機能を使用する場合には，運用管理エージェントのライブラリパスの設定が必要になります。

システムクラスパスの設定
adminagentuser.cfgのadd.class.pathキーに，コンテナ拡張ライブラリ用のJARファイルのパスを指定します。

ライブラリパスの設定
adminagentuser.cfgのadd.library.pathキーに，JNI用ライブラリの検索パスを指定します。

ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。コンテナ拡張ライブラリの機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

＜この節の構成＞

2.5.1　Java実行環境の指定

2.5.2　Server Plug-inの組み込み手順

2.5.3　Server Plug-inを使用するためのManagement Serverの設定

2.5.1　Java実行環境の指定

Eclipseを使用するにはJava実行環境が必要です。Eclipseをインストールしたあと，次のどちらかの方法でJava実行環境を指定してください。

環境変数PATHの指定
環境変数PATHに次のパスを指定してください。
<Cosminexusのインストールディレクトリ>¥jdk¥bin

Eclipseの起動引数の指定
Eclipseの起動引数にJava仮想マシンを指定して起動します。
Eclipse.exe -vm "<Cosminexusのインストールディレクトリ>¥jdk¥bin¥javaw.exe"

2.5.2　Server Plug-inの組み込み手順

Server Plug-inをEclipseに組み込みます。組み込み手順を次に示します。

Eclipseを起動し，メニューから［ヘルプ］－［ソフトウェアの更新］－［構成の管理］を実行します。
［製品構成］ダイアログが表示されます。

左ペインのツリービューでコンテキストメニューを表示させて［追加］－［拡張ロケーション］を選択します。
［フォルダの参照］ダイアログが表示されます。

次のフォルダを指定します。
<Cosminexusのインストールディレクトリ>¥plugins¥eclipse

［OK］ボタンをクリックします。
［インストール/更新］ダイアログが表示されます。

［インストール/更新］ダイアログに［変更を適用］ボタンがある場合は［変更を適用］ボタンを，［変更を適用］ボタンがない場合は［はい］ボタンをクリックしてください。

［変更を適用］ボタンがある場合
パースペクティブの変更の受け入れを確認するダイアログが表示されます。ここで，［はい］ボタンをクリックして，手動で再起動します。再起動されると組み込みは完了です。

［変更を適用］ボタンがない場合
［はい］ボタンをクリックすると，再起動が実行されます。再起動されると，組み込みは完了です。

Server Plug-inが正しく組み込まれたかどうかについては，メニューから［ヘルプ］－［ソフトウェアの更新］－［構成の管理］を選択して表示される，［製品構成］ダイアログで確認できます。

Cosminexusを再インストールしたときの注意事項

バージョンアップなどによってCosminexusを再インストールした場合，次に示す操作を行ってから，Server Plug-inをEclipseに組み込む必要があります。

拡張ロケーションの削除
拡張ロケーションを削除して再度プラグインを組み込みます。拡張ロケーションの削除はEclipseのインストール先（eclipse.exeがあるフォルダ）で次のコマンドを実行します。
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command removeSite
-to "<Cosminexusのインストールディレクトリ>¥plugins¥eclipse"

Eclipseの起動引数の指定
Eclipseの起動引数に-cleanを指定して再起動します。
eclipse.exe -clean

2.5.3　Server Plug-inを使用するためのManagement Serverの設定

Server Plug-inを使用するための設定を，Server Plug-inの接続先となるManagement Serverで実施します。設定をするには，Management Serverが配置されているサーバにあるmserver.properties（Management Server環境設定ファイル）に，プロパティを追加します。なお，設定した情報をManagement Serverに反映させるためには，プロパティの追加後，必ず，Management Serverおよび運用管理エージェントを再起動してください。

次に，mserver.propertiesの格納先とmserver.propertiesに追加するプロパティを示します。

mserver.propertiesの格納先

Windowsの場合

<Cosminexusのインストールディレクトリ>¥manager¥config¥mserver.properties

UNIXの場合

/opt/Cosminexus/manager/config/mserver.properties

注意

uCosminexus Operatorを使用している場合など，Server Plug-inがインストールされているマシンとManagement Serverが配置されているマシンが別の場合は，Management Serverが配置されているマシンにあるmserver.propertiesで設定します。

追加するプロパティ
com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099※

注※

設定を省略した場合，デフォルトで28099が設定されます。なお，このキーの値を28099以外に設定した場合は，Server Plug-inの「リモート管理機能に接続するための環境設定」の「接続ポート番号」の値を，com.cosminexus.mngsvr.management.portキーに設定した値に変更する必要があります。リモート管理機能に接続するための環境設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のServer Plug-inの環境設定に関する説明を参照してください。

また，Server Plug-inの画面上に，論理J2EEサーバおよび論理ユーザサーバのコンソール出力情報を表示させたい場合は，設定が必要になります。コンソール出力情報を表示するための設定については，「5.12　コンソールログの取得の設定」を参照してください。

2.6　インストール後のディレクトリ構成

この節では，次の製品のインストール後のディレクトリ構成について説明します。

Application Server

uCosminexus Client

Web Redirector

uCosminexus Operator

このマニュアルでは，各製品のインストールディレクトリのことを，「Cosminexusのインストールディレクトリ」と表記します。インストールディレクトリを次に示します。

Windowsのインストールディレクトリ（デフォルト）
<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus

UNIXのインストールディレクトリ
/opt/Cosminexus

＜この節の構成＞

2.6.1　Application Serverのディレクトリ構成

2.6.2　uCosminexus Clientのディレクトリ構成

2.6.3　Web Redirectorのディレクトリ構成

2.6.4　uCosminexus Operatorのディレクトリ構成

2.6.1　Application Serverのディレクトリ構成

ここでは，Application Serverのディレクトリ構成について説明します。また，Application Serverの構成ソフトウェアのうち，Cosminexus Component ContainerとCosminexus DABroker Libraryのディレクトリ構成について説明します。

＜この項の構成＞

(1)　Application Serverのディレクトリ構成

(2)　Cosminexus Component Containerのディレクトリ構成

(3)　Cosminexus DABroker Libraryのディレクトリ構成

(1)　Application Serverのディレクトリ構成

Application Serverのディレクトリ構成を次の図に示します。

図2-3　Application Serverのディレクトリ構成（Windowsの場合）

図2-4　Application Serverのディレクトリ構成（UNIXの場合）

(2)　Cosminexus Component Containerのディレクトリ構成

Cosminexus Component Containerのディレクトリ構成を次の表に示します。

表2-7　Cosminexus Component Containerのディレクトリ構成

ディレクトリ
説明

CC
－
Cosminexus Component Containerの提供する機能のうち，コンテナなどの基盤部分の機能を提供するディレクトリです。
<Cosminexusのインストールディレクトリ>¥CC（Windowsの場合），または/opt/Cosminexus/CC（UNIXの場合）です。

admin
－
J2EEサーバ管理用ディレクトリです。

bin
サーバ管理コマンド格納用ディレクトリです。

dtds
CUI用のDTDファイル格納用ディレクトリです。

logs
サーバ管理コマンドのログ格納用ディレクトリです。

sysconf
サーバ管理コマンドのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates
属性ファイルのテンプレート格納用ディレクトリです。

usrconf
サーバ管理コマンドのユーザ定義ファイル格納用ディレクトリです（カスタマイズ用）。

batch
－
バッチアプリケーション用のディレクトリです。

bin
バッチアプリケーションの実行ファイル格納用ディレクトリです。

logs
バッチアプリケーションのログ出力用ディレクトリです。

sysconf
バッチアプリケーションのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates
バッチアプリケーションのユーザ定義ファイルのひな型格納用ディレクトリです。

client
－
EJBクライアントアプリケーション用のディレクトリです。

bin
EJBクライアントアプリケーションの実行ファイル格納用ディレクトリです。

lib
EJBクライアントアプリケーションのJARファイル格納用ディレクトリです。

logs
EJBクライアントアプリケーションのログ出力用ディレクトリです。

sysconf
EJBクライアントアプリケーションのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates
EJBクライアントアプリケーションのユーザ定義ファイルのひな型格納用ディレクトリです。

DBConnector
－
DB ConnectorのRARファイル格納用ディレクトリです。

ReliableMessaging
DB Connector for Cosminexus RMのRARファイル格納用ディレクトリです。

ClusterPool
コネクションプールのクラスタ化機能を使用する場合のRARファイル格納用ディレクトリです。

docs
ドキュメント格納ディレクトリです。

examples
サンプルプログラム格納用ディレクトリです。

lib
Cosminexus Component Container用クラスライブラリファイル格納用ディレクトリです。

logs
インストール時のログ格納用ディレクトリです。

server
－
－

bin
J2EEサーバ用コマンドツール格納用ディレクトリです。

lib
－
J2EEサーバ用ライブラリファイル格納用ディレクトリです。

dtds
Cosminexus Component Containerで使用するDTDファイル格納用ディレクトリです。ただし，修正禁止です。

schemas
J2EE 1.4のDD用スキーマ定義ファイル格納用ディレクトリです。

public
J2EEサーバのデフォルトの作業用ディレクトリです。

repository
一時作業用ディレクトリです。

sysconf
システム定義用ファイル格納用ディレクトリです。ただし，修正禁止です。

templates
コンフィグレーションファイルやプロパティファイルなどのひな型格納用ディレクトリです。

usrconf
－
－

ejb
－
－

<ローカルホスト名>
J2EEサーバのユーザ定義ファイルの格納用ディレクトリです（カスタマイズ用）。

sfo
－
セッションフェイルオーバ機能用ディレクトリです。

lib
セッションフェイルオーバ機能用ライブラリ格納用ディレクトリです。

sfo_server
SFOサーバアプリケーション格納用ディレクトリです。

sfo_war
セッションフェイルオーバ機能用のWebアプリケーションのDD（web.xml）格納用ディレクトリです。

spool
－
一時ディレクトリです。

web
－
サーブレットエンジンモード用ルートディレクトリです。

bin
サーブレットエンジンモード用コマンドツール格納ディレクトリです。

containers
－
－

<ローカルホスト名>
－
－

usrconf
<ローカルホスト名>用のユーザ定義ファイル格納用ディレクトリです。

webapps
<ローカルホスト名>用のWebアプリケーション格納用ディレクトリです。

jdbc
サーブレットエンジンモード用コネクションプール機能管理ツール格納用ディレクトリです。

redirector
－
リダイレクタ本体／定義ファイル格納用ディレクトリです。

sysconf
システム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates
ユーザ定義ファイルのひな型格納用ディレクトリです。ただし，修正禁止です。

manager
－
Cosminexus Component Containerの提供する機能のうち，Cosminexusの運用管理機能を提供するディレクトリです。

bin
運用管理機能で使用するコマンドなどの格納用ディレクトリです。

config
－
運用管理機能で使用する定義ファイルなどの格納用ディレクトリです。

templates
運用管理機能で使用する定義ファイルのサンプル格納用ディレクトリです。

containers
－
－

m
－
－

usrconf
ユーザ認証情報定義ファイル格納用ディレクトリです。

webapps
－
－

mngsvr
Management Serverの動作ファイル格納用ディレクトリです。

WEB-INF
web.xml格納用ディレクトリです。

examples
ユーザ管理のサンプル格納用ディレクトリです。

lib
ライブラリファイル格納用ディレクトリです。

log
ログ出力先ディレクトリです。

modules
統合ユーザ管理フレームワークのカスタムログインモジュール格納用ディレクトリです。

spool
－
ログ収集先ディレクトリです。

mibs
MIB格納用ディレクトリです。

tmp
一時的なワークディレクトリです。

apps
デフォルトのアプリケーション登録用ディレクトリです。

externals
－
－

jp1
－
JP1連携用ファイル格納用ディレクトリです。
なお，このディレクトリはWindows用です。

ajs2_custom_jobs
カスタムジョブ格納用ディレクトリです。

mngsvrmonitor
モニタ起動コマンド格納用ディレクトリです。

ScenarioTemplate
シナリオテンプレート格納用ディレクトリです。

compat3
－
旧バージョンのManagement Serverの動作ファイル格納用ディレクトリです。
なお，このディレクトリはWindows，AIX，HP-UX，Solaris用です。

bin
運用管理機能で使用するコマンドなどの格納用ディレクトリです。

config
－
運用管理機能で使用する定義ファイルなどの格納用ディレクトリです。

Administrator
ユーザパスワードやユーザ登録情報などの格納用ディレクトリです。

fwj
業務ごとのプロパティファイル格納用ディレクトリです。

log
トレースファイル格納用ディレクトリです。

tmp
一時的なワークディレクトリです。

setup
－
セットアップウィザードディレクトリです。

bin
－

config
セットアップ情報を保持するファイルなどを格納するディレクトリです。

lib
－

log
セットアップウィザードのトレースファイル用ディレクトリです。

tmp
セットアップウィザードの一時的なワークディレクトリです。

c4web
Cosminexus Component Containerの提供する機能のうち，SOAPアプリケーション実行基盤の機能を提供するディレクトリです。

CWC
Cosminexus Component Containerの提供する機能のうち，Webアプリケーション開発に利用する機能を提供するディレクトリです。

plugins
－
Cosminexus Component Containerの提供する機能のうち，Server Plug-inの機能を提供するディレクトリです。
なお，このディレクトリはWindows用です。

eclipse
Eclipseへ組み込み時に指定するフォルダです。

(3)　Cosminexus DABroker Libraryのディレクトリ構成

Cosminexus DABroker Libraryのディレクトリ構成を次の表に示します。

表2-8　Cosminexus DABroker Libraryのディレクトリ構成（Windowsの場合）

ディレクトリ | 説明
DAB | － | Cosminexus DABroker Libraryのインストールディレクトリ※です。
bin | ヘルプファイル格納用ディレクトリです。
lib | ライブラリ格納用ディレクトリです。
msg | メッセージファイル格納用ディレクトリです。
spool | － | トレースファイル，ログファイル格納用ディレクトリです。
dabcltrc | －
dabdump | －
db_access | －
tmp | 作業ディレクトリです。
DABJ | － | Cosminexus DABroker LibraryのJDBCドライバのインストールディレクトリです。

表2-9　Cosminexus DABroker Libraryのディレクトリ構成（UNIXの場合）

ディレクトリ | 説明
Cosminexus | DABJ | Cosminexus DABroker LibraryのJDBCドライバのインストールディレクトリです。
DABroker | － | Cosminexus DABroker Libraryのインストールディレクトリ※です。
bin | 実行コマンド格納用ディレクトリです。
lib | ライブラリ格納用ディレクトリです。
obj | オブジェクトファイル格納用ディレクトリです。
AGT | エージェント処理用ディレクトリです。
AGTGRP | グループ管理用ディレクトリです。
msg | メッセージファイル格納用ディレクトリです。
sample | サンプルファイル格納用ディレクトリです。
conf | 定義ファイル格納用ディレクトリです。
spool | トレースファイル，ログファイル格納用ディレクトリです。

注※　このマニュアルでは，Cosminexus DABroker Libraryのインストールディレクトリのことを，Cosminexus DABroker Library運用ディレクトリと呼びます。

2.6.2　uCosminexus Clientのディレクトリ構成

uCosminexus Clientと，その構成ソフトウェアであるCosminexus Component Container - Clientのディレクトリ構成を次の図に示します。

図2-5　uCosminexus Clientのディレクトリ構成

2.6.3　Web Redirectorのディレクトリ構成

Web Redirectorと，その構成ソフトウェアであるCosminexus Component Container - Redirectorのディレクトリ構成を次の図に示します。

図2-6　Web Redirectorのディレクトリ構成（Windowsの場合）

図2-7　Web Redirectorのディレクトリ構成（UNIXの場合）

2.6.4　uCosminexus Operatorのディレクトリ構成

uCosminexus Operatorのディレクトリ構成を次の図に示します。

図2-8　uCosminexus Operatorのディレクトリ構成

2.7　J2EEサーバの作業ディレクトリ

J2EEサーバは作業ディレクトリ中にサーバ名やアプリケーションの表示名，EARファイル中のファイルなどを用いてディレクトリやファイルを生成します。ディレクトリ名やファイル名，パス全体の長さには上限があり，作業ディレクトリ全体がパス全体の上限に収まらないとJ2EEサーバは正常に動作できません。この節では，作業ディレクトリの構成と作業ディレクトリのパス長の見積もり式について説明します。

＜この節の構成＞

2.7.1　J2EEサーバの作業ディレクトリの構成

2.7.2　作業ディレクトリのパス長の見積もり式

2.7.1　J2EEサーバの作業ディレクトリの構成

J2EEサーバの作業ディレクトリは，J2EEサーバが動作する上で必要な作業領域です。この領域には，ユーザのパスワード情報，インポートされたリソースアダプタ，EARファイル，EJB-JARファイル，WARファイル，作成されたJ2EEアプリケーションなどの情報が格納されます。

J2EEサーバは，作業ディレクトリ以下にJ2EEサーバごとの専用ディレクトリ構造を持ちます。このため，複数のJ2EEサーバで共通のディレクトリを指定できます。

作業ディレクトリを変更してJ2EEサーバを開始すると，既存のJ2EEアプリケーションなどは利用できません。

作業ディレクトリを別のマシンに移動した場合，別のマシン上のJ2EEサーバでは認識できません。

作業ディレクトリでは，2バイトコードを含むパス名称を利用できません。

作業ディレクトリのデフォルトを次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public

UNIXの場合
/opt/Cosminexus/CC/server/public

作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで変更できます。

J2EEサーバには，次の作業ディレクトリがあります。

J2EEアプリケーション（コンフィグレーション関連）

J2EEアプリケーション（デプロイ関連）

J2EEリソース

J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（デプロイ関連）

Webアプリケーション（JSP関連）

Webアプリケーション（その他）

上記の作業ディレクトリの構成についてそれぞれ説明します。また，移行コマンド実行後のディレクトリ構成についても説明します。

ディレクトリ構成を図で示したあと，各ディレクトリを説明します。なお，図中の番号と説明の番号は対応しています。また，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

＜この項の構成＞

(1)　J2EEアプリケーション（コンフィグレーション関連）

(2)　J2EEアプリケーション（デプロイ関連）

(3)　J2EEリソース

(4)　J2EEリソースアダプタ（コンフィグレーション関連）

(5)　J2EEリソースアダプタ（デプロイ関連）

(6)　Webアプリケーション（JSP関連）

(7)　Webアプリケーション（その他）

(8)　J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成

(9)　リソースアダプタの移行コマンド実行後のディレクトリ構成

(1)　J2EEアプリケーション（コンフィグレーション関連）

J2EEアプリケーション（コンフィグレーション関連）のディレクトリ構成を次の図に示します。

図2-9　J2EEアプリケーション（コンフィグレーション関連）のディレクトリ構成

J2EEアプリケーションごとに作られるディレクトリです。※

EARファイルをインポートした場合に作られるディレクトリです。ディレクトリ名はEARファイル名を基に付けられます。

EARファイルは，17けたの数字.earの名前でここに格納されます。

EJB-JARファイルごとに作られるディレクトリです。ディレクトリ名はEJB-JARファイル名を基に付けられます。

EJB-JARファイルは，17けたの数字.jarの名前でここに格納されます。

ライブラリJARファイルごとに作られるディレクトリです。ディレクトリ名はライブラリJARファイル名を基に付けられます。

ライブラリJARファイルは，17けたの数字.jarの名前でここに格納されます。

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

WARファイルごとに作られるディレクトリです。ディレクトリ名はWARファイル名を基に付けられます。

WARファイルは，17けたの数字.jarの名前でここに格納されます。

注※

J2EEアプリケーションを含んだまま06-70よりも前のバージョンからアップグレードインストールした場合，ディレクトリ名はアプリケーション名で作成されます。ただし，アプリケーション名の文字のうち，汎用文字，数字，_（アンダーバー）以外の文字は，_（アンダーバー）に置き換えられます。置換対象の文字が続けて出現する場合は一つの_（アンダーバー）にまとめられます。それ以外の場合は，16進数8けたの文字列が用いられます。

(2)　J2EEアプリケーション（デプロイ関連）

J2EEアプリケーション（デプロイ関連）のディレクトリ構成を次の図に示します。

図2-10　J2EEアプリケーション（デプロイ関連）のディレクトリ構成

J2EEアプリケーションごとに作られるディレクトリです。※

J2EEアプリケーションの開始時に作られるファイルです。J2EEアプリケーション中にホーム，リモートインタフェース，java.rmi.Remoteを実装したインタフェースがあると，それらのパッケージ名やクラス名を基にファイルが作られます。

J2EEアプリケーションの開始時に作られるファイルです。J2EEアプリケーション中にホーム，リモート，ローカル，ローカルホームインタフェースがあると，それらのパッケージ名やクラス名を基にファイルが作られます。

注※

J2EEアプリケーションを含んだまま06-70よりも前のバージョンからアップグレードインストールした場合，ディレクトリ名はアプリケーション名で作成されます。ただし，アプリケーション名の文字のうち，汎用文字，数字，_（アンダーバー）以外の文字は，_（アンダーバー）に置き換えられます。置換対象の文字が続けて出現する場合は一つの_（アンダーバー）にまとめられます。それ以外の場合は，16進数8けたの文字列が用いられます。

(3)　J2EEリソース

J2EEリソースのディレクトリ構成を次の図に示します。

図2-11　J2EEリソースのディレクトリ構成

EJB-JARファイルごとに作られるディレクトリです。ディレクトリ名はEJB-JARファイル名を基に付けられます。

EJB-JARファイルは，17けたの数字.jarの名前でここに格納されます。

データソースごとに作られるディレクトリです。ディレクトリ名はJDBCドライバのファイル名を基に付けられます。

JDBCドライバのファイルは，17けたの数字.jarの名前でここに格納されます。

JavaMailの設定ごとに作られるディレクトリです。ディレクトリ名はejbmailを基に付けられます。

JavaMailの設定を保存したファイルがここに保存されます。

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

WARファイルごとに作られるディレクトリです。ディレクトリ名はWARファイル名を基に付けられます。

WARファイルは，17けたの数字.jarの名前でここに格納されます。

(4)　J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（コンフィグレーション関連）のディレクトリ構成を次の図に示します。

図2-12　J2EEリソースアダプタ（コンフィグレーション関連）のディレクトリ構成

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

(5)　J2EEリソースアダプタ（デプロイ関連）

J2EEリソースアダプタ（デプロイ関連）のディレクトリ構成を次の図に示します。なお，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

図2-13　J2EEリソースアダプタ（デプロイ関連）のディレクトリ構成

RARファイル内のJARファイルは，17けたの数字.jarの名前でここに格納されます。

RARファイル内のネイティブライブラリファイルは，ここに格納されます。

(6)　Webアプリケーション（JSP関連）

Webアプリケーション（JSP関連）のディレクトリ構成を次の図に示します。

図2-14　Webアプリケーション（JSP関連）のディレクトリ構成

コンテキストルートに指定した名前でディレクトリが作られます。/が含まれている場合は3文字の文字列に置き換えられます。

JSPをコンパイルしてできたクラスファイルが格納されます。JSPのファイル名に英数字以外の文字が含まれている場合は，それぞれ6文字の文字列に置き換えられます。また，ファイル名が数字で始まる場合は1文字付加されます。

(7)　Webアプリケーション（その他）

Webアプリケーション（その他）のディレクトリ構成を次の図に示します。

図2-15　Webアプリケーション（その他）のディレクトリ構成

コンテキストルートに指定した名前でディレクトリが作られます。/が含まれている場合は3文字の文字列に置き換えられます。

WARファイルに含まれているファイルがここに解凍されます。

(8)　J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成

J2EEサーバ，またはWebコンテナサーバの移行コマンド実行時，作業ディレクトリの下に作業ディレクトリ_oldの名前でディレクトリを作成し，そこに旧バージョンの作業ディレクトリ下のファイルを退避します。将来，アップグレードインストールをするためには，パス長に作業ディレクトリ_old分の余裕が必要です。J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成を次の図に示します。

図2-16　J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成

(9)　リソースアダプタの移行コマンド実行後のディレクトリ構成

リソースアダプタの移行コマンド実行時，rarupdate_bkの名前でディレクトリを作成し，各J2EEサーバのリソースアダプタのファイルを退避します。作業ディレクトリが「・・・¥<ディレクトリ名>，または・・・/<ディレクトリ名>」の場合，バックアップRARディレクトリは，「・・・¥<ディレクトリ名>¥rarupdate_bk，または・・・/<ディレクトリ名>/rarupdate_bk」になります。リソースアダプタの移行コマンド実行後のディレクトリ構成を次の図に示します。

図2-17　リソースアダプタの移行コマンド実行後のディレクトリ構成

作業ディレクトリの下にrarupdate_bkのパス長を追加する余裕がない場合は，移行コマンド実行時に-backuptoオプションでバックアップ先ディレクトリを指定し，パス長に余裕がある領域にファイルを退避できます。-backuptoオプションを使用する場合のリソースアダプタの移行コマンド実行後のディレクトリ構成を次の図に示します。

図2-18　リソースアダプタの移行コマンド実行後のディレクトリ構成（-backuptoオプションでバックアップ先ディレクトリを指定する場合）

2.7.2　作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式は次のようになります（単位：バイト）。これらの式がすべて満たされるように，各種パラメタを調整してください。なお，見積もり式中の「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。

A+2×B+C+D+E+58≦最大パス長

A+2×B+C+E'+61≦最大パス長

A+2×B+C+E''+50≦最大パス長

A+2×B+C+D+（F+37またはM+68のどちらか大きい方の値）+23≦最大パス長（F≦35の場合は35で換算）

A+2×B+C+G+22≦最大パス長（G≦18の場合は18で換算）

A+B+C+H+I+8≦最大パス長

A+2×B+C+J+34≦最大パス長

J+K+18≦最大パス長

A+2×B+C+L+43≦最大パス長（Cosminexus RM使用時）

K+L+27≦最大パス長（Cosminexus RM使用時）

A+2×B+C+H+L+I+N+22≦最大パス長

A+2×B+C+H+L+O+N+39≦最大パス長

P+H+I+N+3≦最大パス長

O+H+M+N+20≦最大パス長

（凡例）

A：作業ディレクトリまでのパスの長さ

B：作業ディレクトリ名の長さ

C：最も長いサーバ名の長さ

D：最も長いJ2EEアプリケーション名の長さ

E：インポートしたときのEJB-JARファイル，WARファイル，RARファイル，ライブラリJAR，EARのファイル名のうち，最も長いファイル名（EARファイルに含まれているファイルも含む）の長さ

E'：インポートしたときのEJB-JARファイル，WARファイル，RARファイル，JDBCドライバ，メールのファイル名のうち，最も長いファイル名（EARファイルに含まれているファイルも含む）の長さ（メールは7で換算）

E''：インポートしたときのRARファイル名のうち，最も長いファイル名の長さ

F：J2EEアプリケーションに含まれるEJBのインタフェースクラス，java.rmi.Remoteを実装したインタフェースやクラス，EJBのコンポーネントクラスのうち，最も長いファイル名（パッケージ名も含む）の長さ

G：ネイティブライブラリファイルのうち，最も長いファイル名の長さ

H：最も長いコンテキストルートの長さ（/を含む場合は/×3で換算）

I：WARファイル内で最も長いパスの長さ

J：最も長いリソースアダプタ表示名の長さ

K：ログファイル出力先ディレクトリのパスの長さ（簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定する値）

L：最も長いCosminexus RMの表示名の長さ

M：J2EEアプリケーションに含まれるEJBのBeanクラスのうち，最も長いクラス名（パッケージ名を含まない）の長さ

N：最も長いJSP／タグファイルコンパイル結果のクラス名の長さ

O：最も長いタグファイルのパッケージ名の長さ

P：JSP用テンポラリディレクトリまでのパスの長さ

2.8　バッチサーバの作業ディレクトリ

バッチサーバは作業ディレクトリ中にサーバ名などを用いてディレクトリやファイルを生成します。ディレクトリ名やファイル名，パス全体の長さには上限があり，作業ディレクトリ全体がパス全体の上限に収まらないとバッチサーバは正常に動作できません。この節では，作業ディレクトリの構成と作業ディレクトリのパス長の見積もり式について説明します。

＜この節の構成＞

2.8.1　バッチサーバの作業ディレクトリの構成

2.8.2　作業ディレクトリのパス長の見積もり式

2.8.1　バッチサーバの作業ディレクトリの構成

バッチサーバの作業ディレクトリは，バッチサーバが動作する上で必要な作業領域です。この領域には，ユーザのパスワード情報，インポートされたリソースアダプタなどの情報が格納されます。

バッチサーバは，作業ディレクトリ以下にバッチサーバごとの専用ディレクトリ構造を持ちます。このため，複数のバッチサーバで共通のディレクトリを指定できます。

作業ディレクトリを別のマシンに移動した場合，別のマシン上のバッチサーバでは認識できません。

作業ディレクトリでは，2バイトコードを含むパス名称を利用できません。

作業ディレクトリのデフォルトを次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public

UNIXの場合
/opt/Cosminexus/CC/server/public

作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで変更できます。

バッチサーバには，次の作業ディレクトリがあります。

J2EEリソース

J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（デプロイ関連）

なお，2.および3.はJ2EEサーバの場合と同じです。詳細は，「2.7.1(4)　J2EEリソースアダプタ（コンフィグレーション関連）」および「2.7.1(5)　J2EEリソースアダプタ（デプロイ関連）」を参照してください。

ここでは，J2EEリソースの作業ディレクトリの構成について説明します。また，移行コマンド実行後のディレクトリ構成についても説明します。

＜この項の構成＞

(1)　J2EEリソース

(2)　バッチサーバの移行コマンド実行後のディレクトリ構成

(3)　リソースアダプタの移行コマンド実行後のディレクトリ構成

(1)　J2EEリソース

J2EEリソースのディレクトリ構成を図で示したあと，各ディレクトリを説明します。なお，図中の番号と説明の番号は対応しています。また，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

図2-19　J2EEリソースのディレクトリ構成

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

(2)　バッチサーバの移行コマンド実行後のディレクトリ構成

バッチサーバの移行コマンド実行時，作業ディレクトリの下に作業ディレクトリ_oldの名前でディレクトリを作成し，そこに旧バージョンの作業ディレクトリ下のファイルを退避します。バッチサーバの移行コマンド実行後のディレクトリ構成は，J2EEサーバの場合と同じです。詳細は，「2.7.1(8)　J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成」を参照してください。この際，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

(3)　リソースアダプタの移行コマンド実行後のディレクトリ構成

リソースアダプタの移行コマンド実行時，rarupdate_bkの名前でディレクトリを作成し，各バッチサーバのリソースアダプタのファイルを退避します。リソースアダプタの移行コマンド実行後のディレクトリ構成については，「2.7.1(9)　リソースアダプタの移行コマンド実行後のディレクトリ構成」を参照してください。

2.8.2　作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式は次のようになります（単位：バイト）。これらの式がすべて満たされるように，各種パラメタを調整してください。なお，見積もり式中の「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。

A+2×B+C+D+61≦最大パス長

A+2×B+C+E+34≦最大パス長

E+F+18≦最大パス長

（凡例）

A：作業ディレクトリまでのパスの長さ

B：作業ディレクトリ名の長さ

C：最も長いサーバ名の長さ

D：インポートしたときのRARファイル名のうち，最も長いファイル名の長さ

E：最も長いリソースアダプタ表示名の長さ

F：ログファイル出力先ディレクトリのパスの長さ（簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定する値）

2.9　複数の構築済み実行環境を切り替えるための設定（UNIXの場合）

Cosminexusでは，1台のマシンに複数の構築済み実行環境を共存させ，それぞれの実行環境を切り替える機能を提供しています。切り替えられる環境は，UNIX環境に，Application Server StandardおよびApplication Server Enterpriseで構築した実行環境です。

また，構築済み実行環境の切り替えで使用できる機能には，退避機能，回復機能，削除機能，および退避環境一覧出力機能があります。構築済み実行環境の切り替えによって，同一製品のバージョンやパッチの違い，設定内容の違いなどによるシステムの動作を，1台のマシンで検証できます。

この節では，1台のマシンに，構築済み実行環境を複数共存させ，切り替えて運用するための設定について説明します。

なお，各機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

＜この節の構成＞

2.9.1　構築済み実行環境を切り替えるための準備

2.9.2　構築済み実行環境の切り替え手順

2.9.1　構築済み実行環境を切り替えるための準備

ここでは，構築済み実行環境を切り替えるために必要な準備について説明します。

準備として次の作業が必要です。

退避対象外のファイルの退避

ディスク容量の確認

＜この項の構成＞

(1)　退避対象外のファイルの退避

(2)　ディスク容量の確認

(1)　退避対象外のファイルの退避

構築済み実行環境を切り替える場合，cosmienvコマンドを使用して，構築済み実行環境から退避環境を作成します。cosmienvコマンドによって作成される退避環境には，ユーザ任意の定義ファイルや，ログファイル，プロパティの設定によって作成されたファイルなどは含まれません。このため，cosmienvコマンドを実行する前に，退避対象外のファイルのうち，Cosminexusの動作に必要なファイルは，あらかじめ退避しておく必要があります。

なお，実行環境の回復時には，退避したファイルを回復した実行環境に戻す作業が必要になります。

(a)　退避作業が必要なファイル

退避対象外のファイルのうち，退避作業が必要なファイルと作業方法を次の表に示します。これらのファイルは，Cosminexusの動作に影響があるため，必ず退避作業を実施してください。なお，実行環境の回復時には，退避したファイルを回復した実行環境の退避元フォルダに戻す作業が必要になります。

表2-10　退避作業が必要なファイルと作業方法

項番 | ファイルまたはディレクトリ名 | 作業方法 | 備考 | 構成ソフトウェア
1 | 簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）のwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.fileパラメタに指定しているファイル | 退避してください。 | エラーステータスコードに対応するファイルを送信する場合に，レスポンスボディとしてクライアントに返すファイル | Cosminexus Component Container
2 | 簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）のwebserver.connector.inprocess_http.redirect.<リダイレクト定義名>.fileで指定しているファイル | 退避してください。 | 特定のファイルをレスポンスとしてクライアントに返す場合にレスポンスボディとして使用するファイル | Cosminexus Component Container
3 | 展開ディレクトリ形式のアプリケーション | 退避してください。 | － | Cosminexus Component Container
4 | コンテナ拡張ライブラリ | 退避してください。 | － | Cosminexus Component Container
5 | Cosminexusの構築・運用・アプリケーション開発で使用するファイルの形式や定義で，パスにデフォルト以外を設定しているディレクトリおよびファイル | 退避してください。 | － | Cosminexus Component Container
6 | Cosminexus RMの管理情報テーブル | 退避してください。 | DBMS上に作成したCosminexus RMの管理情報テーブル | Cosminexus Reliable Messaging
7 | Cosminexus RMのQueueConfigFileNameプロパティに指定しているファイル | プロパティを指定している場合は，退避してください。 | Cosminexus RMのキュー定義ファイル | Cosminexus Reliable Messaging
8 | Cosminexus RMのRMTRTransferControlDirプロパティに指定しているディレクトリ | プロパティを指定している場合は，退避してください。 | Cosminexus RMで使用するクライアント定義ファイルを格納したディレクトリ | Cosminexus Reliable Messaging
9 | Cosminexus RMのQueueMakeFileNameプロパティに指定しているファイル | プロパティを指定している場合は，退避してください。 | Cosminexus RMのキュー作成ファイル | Cosminexus Reliable Messaging
10 | Webサービスセキュリティの環境設定ファイル（cwsscfg.properties）のcwss.binding.KeyLocator.KeystoreDirプロパティに指定しているディレクトリ以下すべて | プロパティを指定している場合は，退避してください。 | 署名付与/検証で使用するキーストアファイルを格納するディレクトリ | Cosminexus Web Services - Security
11 | Webサービスセキュリティの環境設定ファイル（cwsscfg.properties）のcwss.binding.KeyLocator.CertificateDirプロパティに指定しているディレクトリ以下すべて | プロパティを指定している場合は，退避してください。 | 証明書検証で使用する証明書ファイルを格納するディレクトリ | Cosminexus Web Services - Security
12 | Webサービスセキュリティの環境設定ファイル（cwsscfg.properties）のcwss.binding.KeyLocator.SecretKeyDirプロパティに指定しているディレクトリ以下すべて | プロパティを指定している場合は，退避してください。 | 暗号化/復号化で使用する共通鍵ファイルを格納するディレクトリ | Cosminexus Web Services - Security
13 | 環境変数「VBROKER_ADM」またはCosminexus TPBrokerのvbroker.orb.admDirプロパティに/opt/Cosminexus/TPB/adm以外を設定している場合に，環境変数「VBROKER_ADM」またはvbroker.orb.admDirプロパティに設定しているディレクトリ以下にあるagentaddr，localaddr，HVMGTEE_DEF，htc.props，htc.clienthandleraddr，およびHVIORB_DEF | 環境変数またはプロパティを指定している場合は，退避してください。 | ユーザ作成の定義ファイル | Cosminexus TPBroker
14 | 環境変数「OSAGENT_ADDR_FILE」またはvbroker.agent.addrFileプロパティに指定しているファイル | 環境変数またはプロパティを指定している場合は，退避してください。 | ユーザ作成の定義ファイル | Cosminexus TPBroker
15 | 環境変数「OSAGENT_LOCAL_FILE」，またはvbroker.agent.localFileプロパティに指定しているファイル | 環境変数またはプロパティを指定している場合は，退避してください。 | ユーザ作成の定義ファイル | Cosminexus TPBroker
16 | -ORBpropStorageオプション，またはvbroker.orb.propStorageプロパティで指定しているファイル | オプションまたはプロパティを指定している場合は，退避してください。 | ユーザ作成の定義ファイル | Cosminexus TPBroker
17 | httpsd.confで指定した各種設定ファイル（Includeディレクティブ，TypeConfigディレクティブ，SSLによる暗号化，認証の定義など）のうち，opt/hitachi/httpsd以外にあるファイルすべて | opt/hitachi/httpsd以外を指定している場合は，退避してください。 | － | Hitachi Web Server
18 | httpsd.confで指定したコンテンツディレクトリのうち，opt/hitachi/httpsd以外にあるディレクトリすべて | opt/hitachi/httpsd以外を指定している場合は，退避してください。 | － | Hitachi Web Server

(b)　退避作業が不要なファイル

退避対象外のファイルのうち，退避作業が不要なファイルを次の表に示します。これらのファイルは，Cosminexusの動作に影響はありません。必要に応じて退避してください。なお，退避作業が不要なファイルの場合，実行環境の回復時に退避したファイルを戻す作業は不要です。

表2-11　退避作業が不要なファイル

項番
ファイルまたはディレクトリ名
説明
構成ソフトウェア

1
/opt/Cosminexus/XMLSEC/logs/*
Cosminexus Web Services - Securityに含まれるXML Security - Coreのログ
Cosminexus Web Services - Security

2
/opt/Cosminexus/env以下すべて
構築済み実行環境の切り替え機能のコマンド（cosmienvコマンド）の格納先ディレクトリ
－

3
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs以下すべて
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/logs以下すべて
/opt/Cosminexus/CC/server/public/public_old/ejb/<サーバ名称>/logs以下すべて
J2EEサーバのログ出力先ディレクトリ※1
Cosminexus Component Container

4
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/以下のcore*，およびjavacore*
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/以下のcore*，およびjavacore*
/opt/Cosminexus/CC/server/public/public_old/ejb/<サーバ名称>/以下のcore*，およびjavacore*
J2EEサーバのcoreファイル，およびJavaCoreファイル※1
Cosminexus Component Container

5
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats以下すべて
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/stats以下すべて
/opt/Cosminexus/CC/server/public/public_old/ejb/<サーバ名称>/stats以下すべて
J2EEサーバとSFOサーバの稼働情報ファイルの格納先ディレクトリ※1
Cosminexus Component Container

6
/opt/Cosminexus/CC/logs以下すべて
Cosminexus Component Containerのログ格納用ディレクトリ
Cosminexus Component Container

7
/opt/Cosminexus/CC/admin/logs以下すべて
サーバ管理コマンドのログ格納用ディレクトリ
Cosminexus Component Container

8
/opt/Cosminexus/CC/client/logs以下すべて
EJBクライアントアプリケーションのログ出力用ディレクトリ
Cosminexus Component Container

9
/opt/Cosminexus/CC/web/containers/<サーバ名称>/以下のcore*，およびjavacore*
Webコンテナサーバのcoreファイル，およびJavaCoreファイル
Cosminexus Component Container

10
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs以下すべて
Webコンテナサーバのログ出力先ディレクトリ
Cosminexus Component Container

11
/opt/Cosminexus/manager/log以下すべて
Cosminexus Component Containerの運用管理機能のログ出力先ディレクトリ
Cosminexus Component Container

12
/opt/Cosminexus/manager/tmp
Cosminexus Component Containerの運用管理機能の一時的なワークディレクトリ
Cosminexus Component Container

13
/opt/Cosminexus/manager/bin/以下のcore*，およびjavacore*
Cosminexus Component Containerの運用管理機能のcoreファイル，およびJavaCoreファイル
Cosminexus Component Container

14
/opt/Cosminexus/CC/web/redirector/logsおよび/opt/Cosminexus/CC/web/redirector/servers/<論理Webサーバ名>/logs以下すべて
リダイレクタのメッセージログ出力先ディレクトリおよび保守用トレースログ出力先ディレクトリ
Cosminexus Component Container

15
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/otsstatus以下すべて
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/otsstatus以下すべて
/opt/Cosminexus/CC/server/public/public_old/ejb/<サーバ名称>/otsstatus以下すべて
インプロセストランザクションサービスのステータスファイルの格納ディレクトリ※1
Cosminexus Component Container

16
/var/spool/TPBrokerOTM以下すべて
ドメイン情報ファイル格納ディレクトリ
Cosminexus Component Transaction Monitor

17
CTMSPOOL環境変数で指定したディレクトリ以下すべて
CTMSPOOLディレクトリ
Cosminexus Component Transaction Monitor

18
PRFSPOOL環境変数で指定したディレクトリ以下すべて
PRFSPOOLディレクトリ
Cosminexus Performance Tracer

19
/opt/Cosminexus/RM/logs以下すべて
Cosminexus RMコマンドのログ出力先ディレクトリ。
Cosminexus Reliable Messaging

20
/opt/Cosminexus/c4web/logs以下すべて
Cosminexus Component ContainerのSOAPアプリケーション開発支援機能のログ出力先ディレクトリ
Cosminexus Web Services - Security

21
<DABroker運用ディレクトリ>※2/AGT
エージェント処理用ディレクトリ
Cosminexus DABroker Library

22
<DABroker運用ディレクトリ>※2/AGTGRP
グループ管理用ディレクトリ
Cosminexus DABroker Library

23
<DABroker運用ディレクトリ>※2/spool以下すべて
トレースファイル，ログファイルの格納用ディレクトリ
Cosminexus DABroker Library

24
/opt/Cosminexus/TPB/adm/hgtfifo/以下すべて
バーボースログ出力用一時ディレクトリ
Cosminexus TPBroker

25
/opt/Cosminexus/TPB/adm/impl_dir/以下すべて
インプリメンテーションリポジトリデータ作成ディレクトリ
Cosminexus TPBroker

26
/opt/Cosminexus/TPB/log/以下すべて
C++ORB機能トレース出力ディレクトリ
Cosminexus TPBroker

27
/opt/Cosminexus/TPB/logj/以下すべて
JavaORB機能トレース出力ディレクトリ
Cosminexus TPBroker

28
/opt/hitachi/httpsd/logs以下すべて
Hitachi Web Serverのログ出力先ディレクトリ
Hitachi Web Server

29
/opt/hitachi/httpsd/admin/logs以下すべて
Hitachi Web Serverのadminサーバのログ出力先ディレクトリ
Hitachi Web Server

30
/opt/hitachi/httpsd/servers/<サーバ名称>/logs以下すべて
Hitachi Web Serverのログ出力先ディレクトリ
Hitachi Web Server

31
/opt/Cosminexus/wss/logs以下すべて
Cosminexus Web Services - Securityのログ出力先ディレクトリ
Cosminexus Web Services - Security

（凡例）－：Cosminexusの製品が該当します。

注　表内のディレクトリの意味を次に示します。

<Cosminexus作業ディレクトリ>
<Cosminexusの作業ディレクトリ>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）のejb.public.directoryパラメタに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/CC/server/public」です。

注※1　次のディレクトリも含まれます。

<Cosminexus作業ディレクトリ>を変更する前に使用したデフォルトの作業ディレクトリ

アップグレードインストール後に移行した際に作成されるデフォルトのバックアップディレクトリ

注※2　<DABroker運用ディレクトリ>のデフォルトは，<Cosminexus DABroker Libraryのインストールディレクトリ>です。<DABroker運用ディレクトリ>にデフォルト以外を指定している場合も退避対象外です。

(2)　ディスク容量の確認

構築済み実行環境から退避環境を作成する場合，退避対象ファイルをすべてアーカイブしたファイルが，退避環境として作成されます。このため，実行するマシンに十分なディスク容量があるかを確認してください。退避環境に必要なディスク容量は，構築済みの実行環境の状態によって変わります。製品の新規インストール直後の状態では，それぞれ次に示すディスク占有量が必要になります。

Application Server Standardの場合
750メガバイト

Application Server Enterpriseの場合
850メガバイト

注意

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）のejbserver.distributedtx.ots.status.directory1パラメタ，またはejbserver.distributedtx.ots.status.directory2パラメタで指定したディレクトリは，相対パスで指定している場合は退避されます。この場合，ディスク容量は，ejbserver.distributedtx.ots.status.directory1パラメタ，またはejbserver.distributedtx.ots.status.directory2パラメタで指定しているディレクトリが使用するディスク容量を加えた値で見積もる必要があります。

2.9.2　構築済み実行環境の切り替え手順

ここでは，構築済み実行環境を切り替える場合の手順と，退避環境作成時に退避されるファイルについて説明します。

＜この項の構成＞

(1)　構築済み実行環境の切り替え手順の例

(2)　退避環境作成時に退避対象となるファイル

(1)　構築済み実行環境の切り替え手順の例

ここでは，1台のマシンに実行環境Aを構築し，実行環境Bにバージョンアップして動作検証したあと，実行環境Aに戻す手順を例に説明します。

各実行環境の設定内容の例を次の表に示します。

表2-12　各実行環境の設定内容の例

設定内容 | 実行環境A | 実行環境B
退避環境の格納先 | /home/CosmiBackup
退避対象外のファイルの格納先 | /home/CosmiBackup/apsvAfiles | /home/CosmiBackup/apsvBfiles
退避環境の識別子 | apsvA | apsvB

実行環境の切り替え手順を次に示します。

実行環境Aを構築します。
Application Serverをインストールして，環境設定を実施し，システムを構築します。
実行環境Aが稼働可能状態となります。

実行環境Aの退避対象外のファイルを任意の場所に格納します。
ここでは，「/home/CosmiBackup/apsvAfiles」に格納します。退避対象外のファイルについては，「2.9.1(1)　退避対象外のファイルの退避」を参照してください。

実行環境Aを退避するために必要なディスク容量を確認します。
製品ごとに必要なディスク容量については，「2.9.1(2)　ディスク容量の確認」を参照してください。

cosmienvコマンドに引数-sを指定して，実行環境Aの退避環境を作成します。
コマンドの入力例を次に示します。
cosmienv -s -I apsvA -P /home/CosmiBackup
退避環境作成時に退避されるファイルについては，「(2)　退避環境作成時に退避対象となるファイル」を参照してください。
cosmienvコマンドを実行しても，実行環境Aは稼働可能状態のまま残ります。

実行環境Bを構築します。
実行環境Aにアップグレードインストールと環境設定を実施します。
実行環境Bが稼働可能状態となり，実行環境Aは退避環境だけとなります。

実行環境Bの退避対象外のファイルを任意の場所に格納します。
ここでは，「/home/CosmiBackup/apsvBfiles」に格納します。退避対象外のファイルについては，「2.9.1(1)　退避対象外のファイルの退避」を参照してください。

実行環境Bを退避するために必要なディスク容量を確認します。
製品ごとに必要なディスク容量については，「2.9.1(2)　ディスク容量の確認」を参照してください。

cosmienvコマンドに引数-sを指定して，実行環境Bの退避環境を作成します。
コマンドの入力例を次に示します。
cosmienv -s -I apsvB -P /home/CosmiBackup
退避環境作成時に退避されるファイルについては，「(2)　退避環境作成時に退避対象となるファイル」を参照してください。
cosmienvコマンドを実行しても，実行環境Bは稼働可能状態のまま残ります。

実行環境Bで動作検証をします。

cosmienvコマンドに引数-rを指定して，実行環境Aに戻します。
コマンドの入力例を次に示します。
cosmienv -r -I apsvA
実行環境Aが稼働可能状態となり，実行環境Bは退避環境だけとなります。回復元の退避環境Aはそのまま残ります。

手順2.で退避したファイルを該当個所（退避元ディレクトリ）に格納します。
退避対象外のファイルを実行環境Aの退避元ディレクトリにそれぞれ格納します。

cosmienvコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　退避環境作成時に退避対象となるファイル

退避環境作成時に退避対象となるファイルを次の表に示します。

表2-13　退避環境作成時に退避対象となるファイル

項番 | ファイルまたはディレクトリ名 | 説明 | 構成ソフトウェア
1 | /opt/Cosminexus/XMLSEC | Cosminexus Web Services - Securityに含まれるXML Security - Coreの製品，設定ファイルなど | Cosminexus Web Services - Security
2 | /opt/Cosminexus/.HTC_xxxx.inf | Cosminexus製品情報ファイル | －
3 | /opt/Cosminexus/common以下すべて | Cosminexus共通モジュール群 | －
4 | /opt/Cosminexus/CC | Cosminexus Component Containerのインストールディレクトリ | Cosminexus Component Container
5 | /opt/Cosminexus/CWC | Cosminexus Component ContainerのWebアプリケーション開発に利用する機能のインストールディレクトリ | Cosminexus Component Container
6 | /opt/Cosminexus/c4web | Cosminexus Component ContainerのSOAPアプリケーション開発支援機能，SOAP通信基盤のファイルがインストールされているディレクトリ | Cosminexus Component Container
7 | /opt/Cosminexus/manager | Cosminexus Component Containerの運用管理機能のインストールディレクトリ | Cosminexus Component Container
8 | /sbin/init.d/MngSvr | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（HP-UXの場合） | Cosminexus Component Container
9 | /sbin/init.d/AdminAgent | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（HP-UXの場合） | Cosminexus Component Container
10 | /etc/rc.d/init.d/MngSvr | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（Linuxの場合） | Cosminexus Component Container
11 | /etc/rc.d/init.d/AdminAgent | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（Linuxの場合） | Cosminexus Component Container
12 | /etc/init.d/MngSvr | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（Solarisの場合） | Cosminexus Component Container
13 | /etc/init.d/AdminAgent | インストール時に作成されるCosminexus Component Containerの運用管理機能のrcスクリプトファイル（Solarisの場合） | Cosminexus Component Container
14 | /opt/Cosminexus/CTM/bin以下すべて | Cosminexus Component Transaction Monitorのロードモジュール | Cosminexus Component Transaction Monitor
15 | /opt/Cosminexus/CTM/lib以下すべて | Cosminexus Component Transaction Monitorのライブラリ | Cosminexus Component Transaction Monitor
16 | /opt/Cosminexus/CTM/.HTC_xxxx.inf | Cosminexus Component Transaction Monitorの製品情報ファイル | Cosminexus Component Transaction Monitor
17 | /opt/Cosminexus/PRF/bin以下すべて | Cosminexus Performance Tracerのロードモジュール | Cosminexus Performance Tracer
18 | /opt/Cosminexus/PRF/lib以下すべて | Cosminexus Performance Tracerのライブラリ | Cosminexus Performance Tracer
19 | /opt/Cosminexus/PRF/.HTC_xxxx.inf | Cosminexus Performance Tracerの製品情報ファイル | Cosminexus Performance Tracer
20 | /opt/Cosminexus/jaxp | Cosminexus XML Processorのインストールディレクトリ | Cosminexus XML Processor
21 | /opt/Cosminexus/jdk | Cosminexus Developer's Kit for Javaのインストールディレクトリ | Cosminexus Developer's Kit for Java
22 | /opt/Cosminexus/RM | Cosminexus RMのインストールディレクトリ | Cosminexus Reliable Messaging
23 | /opt/Cosminexus/cFramework | Cosminexus cFrameworkのインストールディレクトリ | Cosminexus cFramework
24 | /opt/Cosminexus/DABJ以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
25 | /opt/DABroker/.HTC_2340.inf | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
26 | /opt/DABroker/.dabrokerenv | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
27 | <DABroker運用ディレクトリ>※/bin以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
28 | <DABroker運用ディレクトリ>※/lib以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
29 | <DABroker運用ディレクトリ>※/msg以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
30 | <DABroker運用ディレクトリ>※/obj以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
31 | <DABroker運用ディレクトリ>※/sample以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
32 | <DABroker運用ディレクトリ>※/conf以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
33 | <DABroker運用ディレクトリ>※/cpp以下すべて | Cosminexus DABroker Library製品ファイル | Cosminexus DABroker Library
34 | /opt/Cosminexus/TPB以下すべて | Cosminexus TPBroker インストールディレクトリ | Cosminexus TPBroker
35 | /opt/hitachi/httpsd | Hitachi Web Serverのインストールディレクトリ | Hitachi Web Server
36 | 簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）のejb.public.directoryパラメタで指定するディレクトリパス | J2EEサーバの作業ディレクトリ | Cosminexus Component Container
37 | /opt/Cosminexus/wss | Cosminexus Web Services Securityのインストールディレクトリ | Cosminexus Web Services - Security

（凡例）－：Cosminexusの製品が該当します。

注※　<DABroker運用ディレクトリ>のデフォルトは，<Cosminexus DABroker Libraryのインストールディレクトリ>です。<DABroker運用ディレクトリ>にデフォルト以外を指定している場合も退避対象となります。

3.　システム構築の概要（J2EEアプリケーションを実行するシステム）

この章では，J2EEアプリケーションを実行するシステムを構築する場合の，システム構築の流れや必要な設定について説明します。

＜この章の構成＞

3.1　システム構築の流れ

3.2　システムの起動と停止の設定

3.3　システム構築で使用するファイル

3.4　Management Serverの設定

3.5　システムの構成定義

3.1　システム構築の流れ

この節では，J2EEアプリケーションを実行するシステムを構築する場合の流れについて説明します。Management ServerのSmart Composer機能を使用して構築するシステムは，Smart Composer機能のコマンドや運用管理コマンド（mngsvrutil）を利用して運用します。Smart Composer機能のコマンドや運用管理コマンド（mngsvrutil）を利用して運用するシステムでは，Cosminexusのシステム全体のサーバの運用をManagement Serverで一括管理できます。システム構築の流れを次の図に示します。

図3-1　J2EEアプリケーションを実行するシステムの構築の流れ

図中の1.～9.について説明します。

Management Serverの設定をします。

Management Serverを初めて使用するホストは，Management Serverをセットアップしてください。セットアップ時に，Management Serverのユーザアカウントも設定できます。

Management Serverのプロパティファイル（mserver.properties）や運用管理エージェントのプロパティファイル（adminagent.properties）で，Management Serverが使用するポート番号や，Management Serverへのアクセスを許可するホストなどを指定してください。

必要に応じて，Management Serverが出力するログの設定や，JP1との連携時にManagement Serverの障害情報をJP1イベントとして発行するかどうかなど，Management Serverの動作環境を設定してください。

必要に応じて，運用管理エージェントが，論理サーバの動作を確認するレベル，間隔，リトライ回数などを設定してください。

Management Serverの設定については，「3.4　Management Serverの設定」を参照してください。

システムの構成定義をします。
Smart Composer機能では，J2EEアプリケーションを実行するシステム内に配置されたサーバマシンやサーバ（論理サーバ）の構成を，Webシステムという概念で管理します。サーバマシンの集合を物理ティア，サーバ（論理サーバ）の集合をサービスユニットといいます。
Management Serverが管理，運用する運用ドメイン内には，Webシステムを複数配置できます。Webシステムは，Smart Composer機能の簡易構築定義ファイルで定義します。Webシステムの構成定義の概要については，「3.5　システムの構成定義」を参照してください。
また，Smart Composer機能の簡易構築定義ファイルでは，必要に応じて，論理サーバごとに次の設定をします。

論理サーバを稼働させるために必要な設定

論理サーバの起動順序，自動再起動するときの回数など，論理サーバの起動と停止の設定

論理サーバの起動と停止で使用する環境変数の設定

J2EEサーバの動作設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。デフォルトで設定されているJ2EEサーバの動作を変更したい場合には，Smart Composer機能の簡易構築定義ファイルで論理サーバの設定値を設定もしくは変更したり，またはユーザ定義ファイルを編集したりする必要があります。
例えば，J2EEサーバのプロセス内で提供されるWebサーバ機能であるインプロセスHTTPサーバ機能を使用する場合には，機能を有効にする設定が必要になります。インプロセスHTTPサーバ機能を使用するための設定については，「8.　インプロセスHTTPサーバの設定（J2EEアプリケーションを実行するシステム）」を参照してください。

トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。ただし，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。
これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。

システムの可用性を高める設定をします。
システムの可用性を高める機能を使用しない場合は，設定不要です。セッションフェイルオーバ機能によるJ2EEサーバへのセッション情報の引き継ぎの設定，Managementイベントによる障害の事前検知の設定など，システムの可用性を高める設定をします。

Webサーバとの連携の設定をします。
Webサーバと連携しない場合は，設定不要です。リダイレクタを利用したリクエストの振り分け，通信タイムアウト，エラーページのカスタマイズなど，Webサーバと連携するための設定をします。

リソースとJ2EEアプリケーションの設定をします。
サーバ管理コマンドを使用して，リソースアダプタやJ2EEアプリケーションのプロパティなどを定義します。

統合ユーザ管理機能の設定をします。
統合ユーザ管理機能を使用しない場合は，設定不要です。Cosminexusシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定します。

システムを起動して，システムの動作を確認します。
システムの起動および停止手順については，「3.2　システムの起動と停止の設定」を参照してください。

参考

ほかのプログラムと連携する場合，システム全体をどのように運用するかによってシステムの構築のしかたが異なります。

JP1と連携して運用する場合

Management Serverを利用しているシステムは，JP1と連携することで，JP1の集中監視，運用の自動化，稼働状況の分析などの機能を使用して，Cosminexus以外で構築されたシステムも含めた業務システム全体を一括管理できるようになります。JP1と連携するシステムの構築については，「16.　JP1との連携の設定」を参照してください。

クラスタソフトウェアと連携して運用する場合

Management Serverを利用しているシステムは，クラスタソフトウェアと連携することで，プロセス監視，障害発生時の系切り替えなどの機能を使用して，Application Serverの稼働率を向上できます。連携できるクラスタソフトウェアは，Microsoft Cluster Service（Windowsの場合），およびHAモニタ（AIX，HP-UXまたはLinuxの場合）です。

クラスタソフトウェアと連携するシステムの構築については，「17.　クラスタソフトウェアと連携するための設定」を参照してください。

3.2　システムの起動と停止の設定

この節では，構築したシステムを起動，停止する手順と，自動で起動，停止する場合の設定について説明します。

構築したシステムのプログラムやサーバは，次の図に示す手順で起動，停止します。

図3-2　システムの起動と停止の手順

プログラムや，Webシステム内のサーバは，自動または手動で起動，停止できます。システムの運用方法に合わせて起動，停止の方法を検討し，必要な設定をしてください。

＜この節の構成＞

(1)　システムの起動

(2)　システムの停止

(1)　システムの起動

通常の運用では，運用管理エージェントとManagement Serverは自動起動する方法をお勧めします。

プログラムやサーバの起動手順と起動方法を次に示します。

運用管理エージェントの起動
自動起動する場合は，ホストと同時に起動するようにします。手動起動する場合は，サービスやコマンド（UNIXの場合はコマンド）から起動します。

Management Serverの起動
自動起動する場合は，ホストと同時に起動するようにします。手動起動する場合は，サービスやコマンド（UNIXの場合はコマンド）から起動します。

システムの起動
Smart Composer機能のコマンドで，Webシステムまたはサービスユニット単位に一括起動します。Webシステム単位で起動すると，Webシステム内にあるすべてのサービスユニット中の全論理サーバを起動します。

参考

論理サーバの起動順序は，デフォルトの設定を使用することをお勧めします。なお，論理サーバの起動順序は，簡易構築定義ファイルで各論理サーバの<configuration>タグ内にmstartup.noパラメタで設定できます。

運用管理エージェントとManagement Serverに自動起動を設定すると，運用管理エージェントの起動からManagement Serverの起動までの一連の操作を，ホスト起動と同時に処理できるようになります。自動起動する場合の設定方法をOSごとに説明します。

Windowsの場合
Windowsのサービス画面，またはCosminexusのmngautorunコマンドで，自動起動の設定をします。同一ホスト上でManagement Serverと運用管理エージェントを起動する場合には，mngautorunコマンドを使用して，運用管理エージェントが先に起動するように依存関係を設定する必要があります。

UNIXの場合
ホスト起動時のデーモンプロセスとして，ホストと同時に起動するようにします。

(2)　システムの停止

プログラムやサーバの停止手順と停止方法を次に示します。

システムの停止
Smart Composer機能のコマンドで，Webシステムまたはサービスユニット単位に一括停止します。

Management Serverの停止
手動停止する場合は，サービスやコマンド（UNIXの場合はコマンド）から停止します。UNIXの場合，自動停止ができます。自動停止する場合は，ホストと同時に停止するようにします。

運用管理エージェントの停止
手動停止する場合は，サービスやコマンド（UNIXの場合はコマンド）から停止します。UNIXの場合，自動停止ができます。自動停止する場合は，ホストと同時に停止するようにします。

3.3　システム構築で使用するファイル

この節では，システムの構築で使用するファイルのうち，主なファイルについて説明します。ここで説明していないファイルについては，システム構築の手順の中で適宜説明します。

注意

ファイルを変更する場合は，J2EEサーバを停止してください。J2EEサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

＜この節の構成＞

(1)　Management Serverのファイル

(2)　Smart Composer機能のファイル

(3)　J2EEサーバのファイル

(1)　Management Serverのファイル

adminagent.xml（運用管理エージェント設定ファイル）
運用管理エージェントが論理サーバを起動，停止するときに使用する環境変数を指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥adminagent.xml

UNIXの場合
/opt/Cosminexus/manager/config/adminagent.xml

adminagent.properties（運用管理エージェントプロパティファイル）
運用管理エージェントのプロパティを指定するファイルです。論理サーバの動作確認レベルやsnapshotログの収集先の設定などで使用します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥adminagent.properties

UNIXの場合
/opt/Cosminexus/manager/config/adminagent.properties

mserver.properties（Management Server環境設定ファイル）
Management Serverのプロパティを指定するファイルです。Management Serverの環境設定や障害検知時コマンドの動作の設定などで使用します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥mserver.properties

UNIXの場合
/opt/Cosminexus/manager/config/mserver.properties

(2)　Smart Composer機能のファイル

簡易構築定義ファイル
Smart Composer機能のコマンドで構築するWebシステムを定義するファイルです。任意の場所に格納できます。簡易構築定義ファイルのテンプレートファイルが提供されていますので，テンプレートファイルをコピーして利用してください。テンプレートファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml

(3)　J2EEサーバのファイル

server.policy（セキュリティポリシーファイル）
J2EEサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

hitachi_web.properties（Webアプリケーションプロパティファイル）
Webアプリケーション個別のプロパティを指定するファイルです。なお，J2EEサーバ全体でのプロパティは，簡易構築定義ファイルで指定します。
ファイルの格納場所を次に示します。

Windowsの場合
<WebアプリケーションのWEB-INFディレクトリ>¥hitachi_web.properties

UNIXの場合
<WebアプリケーションのWEB-INFディレクトリ>/hitachi_web.properties

hitachi_web.propertiesを変更した場合，WARファイルを作成，インポートし直してください。

参考

J2EEサーバのファイルには，このほかに次のファイルがあります。Smart Composer機能を使用してシステムを構築する場合，これらのファイルで設定する内容（キー）は，簡易構築定義ファイルのパラメタで設定します。

usrconf.properties（ユーザプロパティファイル）

J2EEサーバのユーザプロパティを指定するファイルです。J2EEサーバが使用するネーミングサービス，トランザクション，コネクション，コンテナ，ログ，セキュリティなどを指定します。

ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

usrconf.cfg（オプション定義ファイル）

J2EEサーバのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

usrconf.propertiesおよびusrconf.cfgと，簡易構築定義ファイルのパラメタの対応については，「4.1(3)　そのほかのユーザ定義ファイルの編集について」を参照してください。

usrconf.propertiesおよびusrconf.cfgは，Smart Composer機能を使用しないで，ファイル編集やコマンド実行でシステムを構築する場合などに使用します。usrconf.propertiesおよびusrconf.cfgについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

3.4　Management Serverの設定

この節では，Management Serverを使用するために必要な次の設定について説明します。

Management Serverのセットアップ

Management Serverの環境設定

Management Serverの動作環境の設定

運用管理エージェントによる論理サーバの監視に関する設定

＜この節の構成＞

3.4.1　Management Serverのセットアップ

3.4.2　Management Serverの環境設定

3.4.3　Management Serverの動作環境の設定

3.4.4　運用管理エージェントによる論理サーバの監視に関する設定

3.4.1　Management Serverのセットアップ

Management Serverを初めて使用するホストでは，まず，Management Serverをセットアップしてください。一度セットアップしたホストでは，この作業は不要です。

Management Serverのセットアップには，mngsvrctlコマンドの引数setupを使用します。Management Serverのセットアップ時に，Management Serverを利用するユーザのアカウント情報（管理ユーザアカウント）を設定できます。

Management Serverのセットアップ時に，管理ユーザアカウントを設定する場合

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl setup <サーバ名> -u 管理ユーザID -p 管理ユーザパスワード

UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl setup <サーバ名> -u 管理ユーザID -p 管理ユーザパスワード

セットアップ時に管理ユーザアカウントを設定する場合は，-uオプションと-pオプションでユーザのアカウント情報を指定します。なお，セットアップ時に設定した管理ユーザアカウントは，mngsvrctlコマンドで変更できます。

Management Serverのセットアップだけを実施する場合

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl setup

UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl setup

この場合，セットアップ完了後に，管理ユーザアカウントを設定してください。管理ユーザアカウントの設定方法については，「3.4.3　Management Serverの動作環境の設定」を参照してください。

次に示すように引数の指定を省略すると，mngsvrctlコマンドの使用方法を表示できます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl

UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl

なお，mngsvrctlコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

3.4.2　Management Serverの環境設定

Management Serverや運用管理エージェントのプロパティで，Management Serverの環境を設定してください。

＜この項の構成＞

(1)　Management Serverのプロパティの設定

(2)　運用管理エージェントのプロパティの設定

(1)　Management Serverのプロパティの設定

Management Serverのプロパティファイル（mserver.properties）で，Management Serverが使用するポート番号や，Management Serverへのアクセスを許可するホストなどを指定できます。

mserver.propertiesに指定するキーを次に示します。キーの詳細，およびここで説明していないキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.connector.comm.state.cache_max_time
運用管理エージェントとの通信状態をキャッシュする最大時間を指定します。

webserver.connector.ajp13.port
Management Server内部通信用ポート番号を指定します。

webserver.connector.http.port
Management Server接続HTTPポート番号を指定します。

webserver.shutdown.port
Management Server終了要求受信ポート番号を指定します。

webserver.connector.http.permitted.hosts
Management Serverへのアクセスを許可するホストおよび運用管理エージェント稼働ホストの，IPアドレスまたはホスト名を指定します。

mngsvr.myhost.name
Management Serverが稼働するホストに，論理サーバを配置するホストからアクセス可能なIPアドレス，またはそのIPアドレスを示すホスト名を指定します。Management Serverが稼働するホストが複数個のIPアドレスを持っていて，ホスト名が意図するIPアドレスに変換されないおそれがある場合に，このキーを指定します。

これらのキーのほかに，mserver.propertiesでは，snapshotログ収集や障害検知時コマンドによる資料取得のためのキーを設定できます。snapshotログ収集の設定については，「5.2　snapshotログ収集の設定」を参照してください。障害検知時コマンドによる資料取得のための設定については，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

(2)　運用管理エージェントのプロパティの設定

運用管理エージェントのプロパティファイル（adminagent.properties）で，運用管理エージェントが使用するポート番号などを指定できます。

adminagent.adapter.port
運用管理エージェントがManagement Serverとの通信に使用するポート番号を指定します。

これらのキーのほかに，adminagent.propertiesでは，論理サーバの動作確認やsnapshotログの収集先などを設定できます。論理サーバの動作確認の設定については，「3.4.4　運用管理エージェントによる論理サーバの監視に関する設定」を参照してください。snapshotログの収集先の設定については，「5.2　snapshotログ収集の設定」を参照してください。

3.4.3　Management Serverの動作環境の設定

mngsvrctlコマンドやManagement Serverのプロパティで，Management Serverを利用するユーザのアカウント情報，Management Serverが出力するログ情報など，Management Serverの動作環境を設定してください。

Management Serverの動作環境の設定内容を次の表に示します。

表3-1　Management Serverの動作環境の設定内容

設定項目
設定内容
設定の要否

管理ユーザアカウントの設定
Management Serverのセットアップ時に管理ユーザアカウントを設定していない場合は，mngsvrctlコマンドで引数setupを指定して，Management Serverを利用するユーザのアカウント情報を設定します。mngsvrctlコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。
○※

ログの設定
mserver.propertiesで，Management Serverが出力するログのログレベル，ファイル数，サイズなどを設定します。
次のキーを指定します。

com.cosminexus.mngsvr.log.levelキーに，Management Serverのログの出力レベルを指定します。

com.cosminexus.mngsvr.log.rotateキーに，Management Serverのログのファイル面数を指定します。

com.cosminexus.mngsvr.log.sizeキーに，Management Serverのログのファイルサイズを指定します。

△

開始時の設定
mserver.propertiesで，Management Serverを起動するときに，論理サーバを一括起動するかどうかを設定します。一括起動する場合には，この設定が必要です。
一括起動する設定については，「3.2　システムの起動と停止の設定」を参照してください。
△

性能解析トレース収集の設定
mserver.propertiesで，com.cosminexus.mngsvr.traceキーに，Management Serverで保持する性能解析トレースファイルの面数を設定します。
△

JP1連携の設定
mserver.propertiesで，com.cosminexus.mngsvr.jp1event.enabledキーに，Management Serverの障害情報（検知した障害や論理サーバの起動の通知など）をJP1イベントとして発行するかどうかを指定します。このほかに，com.cosminexus.mngsvr.jp1eventから始まるキーで，Management Serverの障害情報をJP1へ通知するための設定をします。JP1と連携する機能を利用する場合には，この設定が必要です。JP1との連携については，「16.　JP1との連携の設定」を参照してください。
△

（凡例）

○：設定する。

△：デフォルトの設定を変更する場合，特定の機能を使用する場合に設定する。

注※

Management Serverのセットアップ時に，管理ユーザアカウントを設定している場合は，設定不要です。ただし，セットアップ時に設定した管理ユーザアカウントを変更したい場合は，mngsvrctlコマンドを使用して再設定してください。

3.4.4　運用管理エージェントによる論理サーバの監視に関する設定

システムを運用する場合には，Management Serverの運用管理コマンド（mngsvrutil）を使用して論理サーバのステータスを確認することで，論理サーバの起動／停止状態がわかります。Management Serverで論理サーバを管理する場合には，運用管理エージェントが定期的に論理サーバのプロセス監視および動作確認を実施し，論理サーバのステータスをManagement Serverに通知します。運用管理エージェントが論理サーバの動作確認をするときのレベルや間隔の設定は変更できます。必要に応じて，論理サーバの動作確認に関する次の項目を設定してください。

論理サーバの動作確認レベルの設定

論理サーバの動作確認間隔の設定

論理サーバの動作確認タイムアウトの設定

論理サーバの動作確認リトライの設定

論理サーバの動作確認の開始時間の設定

Hitachi Web Serverの動作確認の設定

これらの項目は，運用管理エージェントの動作を設定するadminagent.propertiesで設定します。adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　論理サーバの動作確認レベルの設定

(2)　論理サーバの動作確認間隔の設定

(3)　論理サーバの動作確認タイムアウトの設定

(4)　論理サーバの動作確認リトライの設定

(5)　論理サーバの動作確認の開始時間の設定

(6)　Hitachi Web Serverの動作確認の設定

(1)　論理サーバの動作確認レベルの設定

運用管理エージェントでは，論理サーバが正常に動作しているかどうかを，プロセスの存在を確認したり，論理サーバにアクセスしたりすることで判断します。論理サーバの動作確認レベルは，adminagent.<論理サーバの種類>.watch.levelキーに指定します。必要に応じて，論理サーバの動作確認レベルを変更してください。指定できる値は「1」または「2」です。「1」はプロセスの存在を確認するだけで論理サーバの動作を確認します。また，「2」はプロセスの存在を確認し，実際に論理サーバにアクセスして動作を確認します。指定できる値は論理サーバの種類によって異なります。

(2)　論理サーバの動作確認間隔の設定

論理サーバの動作確認の間隔（秒）は，adminagent.<論理サーバの種類>.watch.intervalキーに指定します。デフォルトは10秒です。必要に応じて，論理サーバの動作を確認するときの間隔を変更してください。

(3)　論理サーバの動作確認タイムアウトの設定

論理サーバの動作確認のタイムアウト時間（秒）は，adminagent.<論理サーバの種類>.watch.timeoutキーに指定します。デフォルトは60秒です。必要に応じて，論理サーバの動作を確認するときのタイムアウト時間を変更してください。

(4)　論理サーバの動作確認リトライの設定

論理サーバの動作確認のリトライ回数は，adminagent.<論理サーバの種類>.watch.retry_countキーに指定します。デフォルトは1回です。

また，adminagent.watch.retry_timeout.enabledキーでは，タイムアウトの発生をリトライの対象にするかどうかを指定できます。デフォルトはfalse（リトライの対象にしない）です。なお，新規インストール時はtrue（リトライの対象にする）が指定されています。

必要に応じて，論理サーバの動作を確認するときのリトライの設定を変更してください。

(5)　論理サーバの動作確認の開始時間の設定

論理サーバを起動してから動作確認（動作確認レベル2）を開始するまでの時間（秒）は，adminagent.<論理サーバの種類>.watch.start_timeキーに指定します。デフォルト値は論理サーバの種類によって異なります。必要に応じて，論理サーバの動作確認の開始時間を変更してください。

なお，論理サーバの動作確認の開始時間を変更する場合は，「論理サーバの動作確認の開始時間（秒） ＜ 論理サーバの起動監視時間（分）」となるように注意してください。論理サーバの起動監視時間は，運用管理ポータルの「論理サーバの起動／停止」の［起動／停止の設定］画面で設定できます。起動監視時間が動作確認の開始時間よりも小さい場合は，論理サーバの起動に失敗します。

(6)　Hitachi Web Serverの動作確認の設定

Management Serverでは，WebサーバとしてHitachi Web Serverを管理できます。ここでは，動作確認用HTTPメソッドの設定，およびHitachi Web Serverの動作確認用URLの設定について説明します。ただし，Hitachi Web Server動作確認用URLは，動作確認用HTTPメソッドの設定で「HEAD」を指定している場合にだけ設定できます。

(a)　動作確認用HTTPメソッドの設定

論理サーバの動作確認レベル（adminagent.<論理サーバの種類>.watch.levelキー）で，「2」を指定（プロセスの存在を確認し，実際に論理サーバにアクセスして動作を確認する）した場合のHitachi Web Serverの動作確認用HTTPメソッドを指定します。指定できる値は「HEAD」または「OPTIONS」です。「HEAD」を指定した場合は，Hitachi Web Server動作確認用URL（adminagent.hws.watch.urlキー）で指定されたURLにアクセスして応答が返ることを確認します。また，「OPTIONS」を指定した場合は，WebサーバがHTTPメソッドを受け付け可能な状態であるかを確認します。

なお，「OPTIONS」を指定した場合，Hitachi Web Serverの設定で，ルートディレクトリに対してすべてのホストからのアクセスを禁止していると，運用管理エージェントからの動作確認アクセスも拒否されてしまうため，正しく稼働判定できなくなり，Hitachi Web Serverの起動に失敗します。その場合，ループバックアドレス（ホストの固定をしている場合は固定したIPアドレス）からのアクセスを許可する必要があります。Basic認証の設定をしている場合など，アクセスを制限している場合も正しく稼働判定できなくなるので注意してください。

(b)　Hitachi Web Server動作確認用URLの設定

運用管理エージェントは，Hitachi Web Serverが正常に動作しているかどうかを，設定したURLに対して定期的にダミーアクセスをすることで判断します。ダミーアクセスのレスポンスが返らないような状態（無応答の状態）になると，Hitachi Web Serverが異常と判断し，障害を検出します。このため，Webサーバを使用する場合には，動作確認用URLとして実際にアクセスできるURLを設定してください。Hitachi Web Server動作確認用URLは，adminagent.hws.watch.urlキーに指定します。

URLには，httpで始まる絶対パス，またはルートコンテキストからの相対パスを指定してください。デフォルト値は，ルートコンテキスト（http://localhost:<ポート番号>/）です。同一のホストに複数のWebサーバを構築する場合は相対パスで指定してください。

（例）

動作確認用URLに「http://HostA:80/index.html」を指定する場合の例を次に示します。
adminagent.hws.watch.url=http://HostA:80/index.html

動作確認用URLに「http://localhost:<ポート番号>/index.html」を指定する場合（複数Webサーバ対応）の例を次に示します。
adminagent.hws.watch.url=index.html

なお，障害発生時の自動再起動については，マニュアル「Cosminexus　機能解説」を参照してください。

3.5　システムの構成定義

この節では，J2EEアプリケーションを実行するシステムの構成定義について説明します。

Webシステムは，一つの業務システムに対応し，運用ドメイン内に複数配置できます。運用管理ドメインは，Management Serverが同一の運用管理ポリシーを適用して，複数のサーバをまとめて管理する範囲のことです。

Webシステムの構成は，Management ServerのSmart Composer機能の簡易構築定義ファイルで定義します。システム構成やJ2EEアプリケーションで使用する機能に応じて，その機能を実現するために必要な論理サーバや，サーバマシンをWebシステム内に適切に配置して，Webシステムの構成を定義してください。なお，Webシステムの構成を検討する指針については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。

●簡易構築定義ファイルの作成

簡易構築定義ファイルはテキストエディタを使用して作成しますが，テンプレートファイルが用意されているので，構成の基本情報を設定するだけで運用できます。

簡易構築定義ファイルの作成手順を次に示します。

簡易構築定義ファイルのテンプレートファイルを任意の場所にコピーします。
テンプレートファイルは次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合

/opt/Cosminexus/manager/config/templates/

簡易構築定義ファイルのテンプレートファイルを任意の名称に変更します。
テキストエディタなどを利用して，簡易構築定義ファイルに手順3.～手順7.の情報を定義します。

Management Serverで運用するWebシステム名，Webシステムの表示名などを定義します。
1Webシステムは，<web-system>タグから</web-system>タグまでの範囲に定義します。

負荷分散機を使用する場合は，使用する負荷分散機の種類や，管理用のIPアドレスなどを定義します。
負荷分散機を使用しないシステムの場合，負荷分散機の定義は不要です。負荷分散機は，<load-balancer>タグから</load-balancer>タグまでの範囲に定義します。

システム構成やJ2EEアプリケーションで使用する機能に応じて，物理ティアを定義します。必要に応じて，論理サーバ全体で共通のコンフィグレーションを定義します。
システム構成やJ2EEアプリケーションで使用する機能に応じて，その機能を実現するために必要な論理サーバが決定されます。Smart Composer機能では，同一のデプロイメント（論理サーバの配置，定義設定など）を適用するホスト（サーバマシン）の集合を物理ティアという単位で定義します。物理ティアは，<tier>タグから</tier>タグまでの範囲に，物理ティアの種類や，論理サーバ全体で共通のコンフィグレーションなどを定義します。

論理サーバ（サービスユニット）を配置するホストを定義します。必要に応じて，論理サーバごとのコンフィグレーションを定義します。
Smart Composer機能では，論理サーバの集合をサービスユニットという単位で定義します。サービスユニットは，<unit>タグから</unit>タグまででの範囲に，サービスユニットを配置するホストや，そのホストが属する物理ティア，論理サーバごとのコンフィグレーションなどを定義します。

ホストを定義します。
物理ティアに属するホストのホスト名や，運用管理エージェントのホスト名などを定義します。ホストは，Webシステムに依存しません。Management Serverで定義済みのホストを利用する場合は，ホストの定義を省略できます。ホストは，<host>タグから</host>タグまでの範囲に定義します。

手順3.～手順7.で定義した情報を反映します。

Smart Composer機能の簡易構築定義ファイルの詳細や，Webシステム，物理ティアおよびサービスユニットの概要については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

●論理サーバのコンフィグレーション定義

論理サーバの動作設定や，機能を使用するための設定などは，論理サーバのコンフィグレーションで定義します。論理サーバのコンフィグレーションは，論理サーバ全体，および論理サーバごとに定義できます。論理サーバ全体で共通の定義を設定する場合は物理ティアで，論理サーバごとの定義を設定する場合はサービスユニットで定義します。物理ティアで定義すると，その物理ティアに属するホストに配置する論理サーバ全体で共通のコンフィグレーションが設定されます。コンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグを次の表に示します。

表3-2　論理サーバのコンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグ

タグ名称
説明

<configuration>
論理サーバの動作環境を設定します。動作環境を設定する論理サーバの種類は，<logical-server-type>タグで指定します。
<configuration>タグは，物理ティアの定義（<tier>タグ内），およびサービスユニットの定義（<unit>タグ内）に設定できます。<tier>タグ内または<unit>タグ内のどちらの<configuration>タグに設定するかによって，設定内容を適用する論理サーバの範囲が異なります。論理サーバ全体で共通の設定を変更したい場合は，<tier>タグ内の<configuration>タグを編集し，特定の論理サーバの設定を変更したい場合は，<unit>タグ内の<configuration>タグを編集します。

<logical-server-type>
<configuration>タグで動作環境を設定する論理サーバの種類を定義します。論理サーバの種類を次に示します。

論理Webサーバ：web-server

論理J2EEサーバ：j2ee-server

論理SFOサーバ：sfo-server

論理パフォーマンストレーサ：performance-tracer

論理CTMドメインマネジャ：ctm-domain-manager

論理CTM：component-transaction-monitor

論理スマートエージェント：smart-agent

論理ユーザサーバ：user-server（<tier>タグ内には定義できません。）

<param>
論理サーバの動作環境を設定するパラメタ（パラメタ名と値の組み合わせ）を定義します。1種類のパラメタごとに<param>タグで囲んで定義します。

<param-name>
論理サーバの動作環境を設定するパラメタの名称を定義します。

<param-value>
<param-name>タグで指定したパラメタの設定値を定義します。

注　各論理サーバの<configuration>タグ内で，パラメタ名（<param-name>タグ）と値（<param-value>タグ）の設定を省略すると，論理サーバの動作環境にはデフォルトの値が設定されます。デフォルトの設定のままで利用する場合は，定義不要です。

Smart Composer機能の簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。なお，機能を使用するために設定する項目のうち，一部の設定項目は，簡易構築定義ファイルで定義できません。簡易構築定義ファイルで設定できない項目は，ほかのユーザ定義ファイルを使用して定義します。機能を使用するための設定の詳細については，「4.　J2EEサーバの動作設定（J2EEアプリケーションを実行するシステム）」を参照してください。また，機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

4.　J2EEサーバの動作設定（J2EEアプリケーションを実行するシステム）

この章では，マニュアル「Cosminexus　機能解説」で説明した機能を有効にするための設定項目と設定方法について説明します。デフォルトのJ2EEサーバの動作を変更しない場合は，設定不要です。デフォルトで設定されているJ2EEサーバの動作を変更したい場合には，ユーザ定義ファイルの編集によって，J2EEサーバの動作設定を変更する必要があります。

＜この章の構成＞

4.1　J2EEサーバの動作設定の方法

4.2　J2EEサーバで設定できる主な項目

4.3　JSPファイルのコンパイル結果の保持の設定

4.4　同時実行スレッド数の制御の設定

4.5　静的コンテンツのキャッシュの設定

4.6　ユーザスレッド生成のための権限の設定

4.7　アノテーションの参照を抑止する設定

4.8　展開ディレクトリ形式のJ2EEアプリケーションの設定

4.9　J2EEアプリケーションの更新検知とリロードの設定

4.10　コンテナ拡張ライブラリの設定

4.11　CTMによるリクエストのスケジューリングの設定

4.12　リソース枯渇監視の設定

4.13　稼働情報ファイルの取得とイベント発行の設定

4.14　J2EEアプリケーション実行時間の監視の設定

4.15　データベース監査証跡との連携の設定

4.16　監査ログ出力の設定

4.1　J2EEサーバの動作設定の方法

この節では，マニュアル「Cosminexus　機能解説」で説明したJ2EEサーバの機能を有効にするための設定項目と設定方法について説明します。

デフォルトで設定されているJ2EEサーバの動作を変更したい場合には，ユーザ定義ファイルを編集して，J2EEサーバの動作設定を変更する必要があります。例えば，J2EEサーバが使用するネーミングサービス，トランザクション，コネクション，コンテナ，ログ，セキュリティの設定を変更したい場合，J2EEサーバのJavaVMの起動オプションなどを変更したい場合などには，簡易構築定義ファイルで設定を変更します。簡易構築定義ファイルに，テキストエディタなどを使用して，変更対象のパラメタ名と変更後の値を設定します。変更後の値を設定した簡易構築定義ファイルをSmart Composer機能のコマンドを実行して反映することで，J2EEサーバの動作設定を変更できます。ただし，J2EEサーバのセキュリティポリシーとWebアプリケーションのプロパティを変更したい場合には，Management Serverでは設定できません。簡易構築定義ファイル以外のユーザ定義ファイルをテキストエディタなどで編集して，動作設定を変更してください。

＜この節の構成＞

(1)　前提条件

(2)　J2EEサーバの動作を設定するユーザ定義ファイル

(3)　そのほかのユーザ定義ファイルの編集について

(1)　前提条件

server.policyまたはhitachi_web.propertiesを編集する場合は，編集対象のJ2EEサーバのセットアップが完了していることが前提になります。また，UNIXの場合，動作設定を変更するときには，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

(2)　J2EEサーバの動作を設定するユーザ定義ファイル

次の三つのユーザ定義ファイルをテキストエディタなどで編集して，J2EEサーバの動作を設定します。

簡易構築定義ファイル

server.policy（J2EEサーバ用セキュリティポリシーファイル）

hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）

J2EEサーバの動作設定は，簡易構築定義ファイルのパラメタで指定します。簡易構築定義ファイルのパラメタは，<configuration>タグ内に，パラメタ名（<param-name>タグ）とパラメタ値（<param-value>タグ）を設定して，編集します。簡易構築定義ファイルでのパラメタの指定形式を次に示します。

簡易構築定義ファイルでのパラメタの指定形式

<param>
<param-name>パラメタ名</param-name>
<param-value>パラメタ値1</param-value>
：
<param-value>パラメタ値n</param-value>
</param>
<param>
：

簡易構築定義ファイルで編集した内容は，Smart Composer機能のコマンドを使用して反映します。ただし，J2EEサーバのセキュリティポリシーや，Webアプリケーションのプロパティについては，ほかのユーザ定義ファイルを編集して，動作設定を変更してください。

ユーザ定義ファイルのうち，簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。簡易構築定義ファイル以外のユーザ定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(3)　そのほかのユーザ定義ファイルの編集について

usrconf.properties，およびusrconf.cfgには，テキストエディタなどで直接編集しなくても，簡易構築定義ファイルのパラメタで設定した内容が反映されます。簡易構築定義ファイルのパラメタと，usrconf.propertiesおよびusrconf.cfgとの対応を次の表に示します。

表4-1　簡易構築定義ファイルのパラメタと，usrconf.propertiesおよびusrconf.cfgとの対応

簡易構築定義ファイルのパラメタ | ユーザ定義ファイルの種類
J2EEサーバ用ユーザプロパティを設定するパラメタ※ | usrconf.properties（J2EEサーバ用ユーザプロパティファイル）
J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ※
J2EEサーバ用オプション定義を設定するパラメタ※ | usrconf.cfg（J2EEサーバ用オプション定義ファイル）
J2EEサーバの拡張パラメタに設定できるパラメタ※

注※　論理SFOサーバの場合は，「J2EEサーバ」を「SFOサーバ」に読み替えてください。

簡易構築定義ファイルのパラメタについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

Smart Composer機能でシステムを構築する場合は，システムの一貫性を保つため，細かい設定を変更する場合でも，簡易構築定義ファイルを編集するようにしてください。テキストエディタなどで個別にファイルを直接編集する場合には，スペルミスなどに十分注意してください。usrconf.propertiesとusrconf.cfgについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

次に，このマニュアルでのパラメタの記載形式を，簡易構築定義ファイルのパラメタごとに説明します。

J2EEサーバ用のユーザプロパティを設定するパラメタ
J2EEサーバ用のユーザプロパティを設定するパラメタの記載形式を次に示します。
なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.propertiesで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.propertiesの<キー名称>に読み替えて設定してください。J2EEサーバ用のユーザプロパティを設定するパラメタの場合，<param-value>タグのパラメタ値がキーに指定する値となります。

J2EEサーバのJavaVMのシステムプロパティに設定するパラメタ
J2EEサーバのJavaVMのシステムプロパティに設定するパラメタの記載形式を次に示します。なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.propertiesで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.propertiesの<キー名称>に読み替えて設定してください。J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタの場合，<param-value>タグの設定値がキーに指定する値となります。J2EEサーバのJavaVMのシステムプロパティは，「J2EEサーバ用のユーザプロパティを設定するパラメタ」に設定できないものなどを指定する場合に使用します。

J2EEサーバ用オプション定義を設定するパラメタ
J2EEサーバ用オプション定義を設定するパラメタは，簡易構築定義ファイルのパラメタごとに記載形式が異なります。

add.jvm.argの場合
add.jvm.argの場合の記載形式を次に示します。
形式

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタの指定内容を次に示します。
<param-name>タグ
　add.jvm.arg
<param-value>タグ
　（設定値）

usrconf.cfgで直接編集する場合は，形式中に太字で示す「add.jvm.arg」をusrconf.cfgの<キー名称>に読み替えて設定してください。「add.jvm.arg」の場合，<param-value>タグのパラメタ値（（設定値））がキーに指定する値となります。

add.jvm.arg以外の場合
add.jvm.arg以外の場合は，J2EEサーバ用のユーザプロパティを設定するパラメタと記載形式は同じです。usrconf.cfgで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.cfgの<キー名称>に読み替えて設定してください。add.jvm.arg以外の場合，<param-value>タグのパラメタ値がキーに指定する値となります。

J2EEサーバの拡張パラメタに設定できるパラメタ
J2EEサーバの拡張パラメタに設定できるパラメタの記載形式を次に示します。なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.cfgで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.cfgの<キー名称>に読み替えて設定してください。J2EEサーバの拡張パラメタに設定できるパラメタの場合，<param-value>タグの設定値がキーに指定する値となります。J2EEサーバの拡張パラメタは，「J2EEサーバ用オプション定義を設定するパラメタ」に設定できないものなどを指定する場合に使用します。

4.2　J2EEサーバで設定できる主な項目

J2EEサーバの動作設定でユーザ定義ファイルを編集して設定できる項目のうち，主な項目とその項目を設定するユーザ定義ファイル，および各ファイルのパラメタやキーについて説明します。ユーザ定義ファイルのうち，簡易構築定義ファイルとパラメタの詳細，およびここで説明していないパラメタについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。簡易構築定義ファイル以外のユーザ定義ファイルとキーの詳細，およびここで説明していないキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

この節では，マニュアル「Cosminexus　機能解説」で説明した機能を使用するために設定する項目を，次の分類に分けて説明します。機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

Webコンテナの機能を使用するための設定

EJBコンテナの機能を使用するための設定

J2EEアプリケーションの実行の機能を使用するための設定

ネーミング管理の機能を使用するための設定

リソース接続とトランザクション管理の機能を使用するための設定

コンテナ拡張ライブラリの機能を使用するための設定

CTMの機能を使用するための設定

セッションフェイルオーバ機能を使用するための設定

システムの日常運用の支援機能を使用するための設定

システムの保守支援機能を使用するための設定

J2EEアプリケーションの運用機能を使用するための設定

システムの監査支援機能を使用するための設定

ポイント

J2EEアプリケーションやリソースの設定をする場合は，サーバ管理コマンドまたはServer Plug-inを使用します。ここではサーバ管理コマンドで使用する属性ファイルとタグについて説明します。

サーバ管理コマンドを使用する場合，ここで示した属性ファイル以外に，J2EEアプリケーションのすべての属性情報が含まれているアプリケーション統合属性ファイルも使用できます。

Server Plug-inを使用する場合，属性ファイルのタグに対応した項目に設定します。属性ファイルのタグと対応する画面，サーバ管理コマンドとServer Plug-inでの操作および設定項目については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この節の構成＞

(1)　Webコンテナの機能を使用するための設定

(2)　EJBコンテナの機能を使用するための設定

(3)　J2EEアプリケーションの実行の機能を使用するための設定

(4)　ネーミング管理の機能を使用するための設定

(5)　リソース接続とトランザクション管理の機能を使用するための設定

(6)　コンテナ拡張ライブラリの機能を使用するための設定

(7)　CTMの機能を使用するための設定

(8)　セッションフェイルオーバ機能を使用するための設定

(9)　システムの日常運用の支援機能を使用するための設定

(10)　システムの保守支援機能を使用するための設定

(11)　J2EEアプリケーションの運用機能を使用するための設定

(12)　システムの監査支援機能を使用するための設定

(1)　Webコンテナの機能を使用するための設定

Webコンテナの機能を使用するためには，簡易構築定義ファイルまたはserver.policyに設定します。設定内容を次の表に示します。

表4-2　Webコンテナの機能を使用するための設定内容（簡易構築定義ファイル，server.policy）

項目
設定個所
設定内容

インプロセスHTTPサーバ
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.connector.inprocess_http.enabled
インプロセスHTTPサーバを使用するかどうかを指定します。

このほかに，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.connector.inprocess_httpから始まるパラメタで，インプロセスHTTPサーバで提供する機能を設定します。設定方法については，「8.　インプロセスHTTPサーバの設定（J2EEアプリケーションを実行するシステム）」を参照してください。

セッション管理
簡易構築定義ファイル
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.session.server_id.enabled※2
セッションIDにサーバIDを付加するかどうかを指定します。

webserver.session.server_id.value※1
セッションIDに付加するサーバIDを指定します。

webserver.container.server_id.enabled※1
CookieにサーバIDを付加するかどうかを指定します。

webserver.container.server_id.name※1
サーバIDを付加するCookieの名称を指定します。

webserver.container.server_id.value※1
Cookieに付加するサーバIDを指定します。

J2EEサーバ単位でのデフォルトの文字エンコーディング設定※3
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.http.request.encoding
リクエストボディおよびクエリのデコードに使用する文字エンコーディングを指定します。

webserver.http.response.encoding
レスポンスボディのエンコードに使用する文字エンコーディングを指定します。

webserver.jsp.pageEncoding
JSPファイルのエンコーディングを指定します。

webserver.static_content.encoding.extension
デフォルトのレスポンス文字エンコーディングを適用する静的コンテンツの拡張子を指定します。

JSP事前コンパイル
簡易構築定義ファイル
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.jsp.keepgenerated※1
JSPファイルから生成したJavaソースファイルを保持しておくかどうかを指定します。

webserver.jsp.compile.backcompat※1
JavaソースファイルをコンパイルするときのJava言語仕様のバージョンを指定します。
なお，Webアプリケーションによって，JSPファイルから生成されたJavaソースファイルのバージョンが異なる場合は，Webアプリケーションごとにバージョンを指定してJSP事前コンパイルを実施してください。

webserver.jsp.precompile.jsp_work_dir※2
JSP事前コンパイルを実施する場合のコンパイル結果を出力するディレクトリを指定します。

なお，これらの設定は，cjstartappコマンドに-jspcオプションを指定して事前コンパイルを実施する場合の設定項目となります。

Servlet 2.3以前のバージョンの場合

Webアプリケーションに含まれるサーブレットのバージョンが2.4の場合，JSP事前コンパイル実行時にTLDファイルがDTDに従っているかどうかを検証します。Webアプリケーションに含まれるサーブレットのバージョンが2.3以前の場合は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを，指定しておく必要があります。

webserver.xml.validate※1
TLDファイルがDTDに従っているかを検証するかどうかを指定します。

前バージョンからのJSPの移行
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.jsp.translation.backcompat.customAction.declareVariable
複数のカスタムタグで，スクリプト変数名とスクリプト変数のスコープが重複する場合，JSPファイルから生成されたJavaコードで2回目のカスタムタグに対応するスクリプト変数の変数宣言を出力するかどうかを指定します。

webserver.jsp.translation.backcompat.taglib.noCheckPrefix
taglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかチェックするかどうかを指定します。

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue
Expressionが指定できないタグの属性値にExpressionが指定されているかどうか検証するかどうかを指定します。

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate
タグの属性値が，「"<%=」または「'<%=」で開始しており，「%>"」（「'<%」で開始した場合は「%>'」）で終了していない属性値の「"」（または「'」）で囲まれた値を文字列として扱うかどうかを指定します。

webserver.jsp.translation.backcompat.useBean.noCheckClass
JSPトランスレーション時に<jsp:useBean>タグのクラス属性値のチェック処理を実行するかどうかを指定します。

JSPファイルのコンパイル結果の保持
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタなどを指定します。設定方法については，「4.3　JSPファイルのコンパイル結果の保持の設定」を参照してください。

webserver.work.clean
JSPファイルのコンパイル結果を保持するかどうかを指定します。

セキュリティ管理
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.connector.redirect_https.port
Webサーバが使用しているHTTPSのポート番号を指定します。

また，通信路の暗号化レベルの要請には，さらに，サーバ管理コマンドを使用して，暗号化レベルの要請を指定する必要があります。サーバ管理コマンドを使用する場合は，WAR属性ファイルの<user-data-constraint>タグに指定します。
なお，この設定は，Webサーバと連携している場合だけ有効となります。

EJBコンテナとの連携
簡易構築定義ファイル
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.deploy.stub.generation.scope※2
別アプリケーションのEJBをリモートインタフェースで呼び出すためのスタブを指定します。

Webコンテナ単位の同時実行スレッド数の制御
簡易構築定義ファイル※1
Webコンテナ全体の最大同時実行スレッド数や，Webコンテナの実行待ちキューに格納できるリクエストの数を指定します。
設定方法については，「4.4　同時実行スレッド数の制御の設定」を参照してください。インプロセスHTTPサーバを使用する場合の設定方法については，「8.4.2　同時実行スレッド数の制御の設定」を参照してください。

Webアプリケーション単位の同時実行スレッド数の制御※4
簡易構築定義ファイル※1
Webアプリケーション単位に同時実行スレッド数を制御するかどうか，Webアプリケーションのデフォルトの実行待ちキューサイズを指定します。
なお，Webアプリケーション単位での最大同時実行スレッド数，占有スレッド数などは，サーバ管理コマンドで設定します。また，URLグループ単位での同時実行スレッド数の制御についても，サーバ管理コマンドで設定します。
設定方法については，「4.4　同時実行スレッド数の制御の設定」を参照してください。インプロセスHTTPサーバを使用する場合の設定方法については，「8.4.2　同時実行スレッド数の制御の設定」を参照してください。

Webコンテナの通信タイムアウト
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.connector.ajp13.receive_timeout
Webサーバからのリクエスト受信時の待ち時間を指定します。

webserver.connector.ajp13.send_timeout
Webコンテナでのレスポンス送信時の待ち時間を指定します。

設定方法については，「7.3　通信タイムアウトの設定」を参照してください。

Webサーバで使用するホストの固定
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.connector.ajp13.bind_host
Webサーバ連携機能を使用する場合のIPアドレスまたはホスト名を指定します。

webserver.connector.inprocess_http.bind_host
インプロセスHTTPサーバのIPアドレスまたはホスト名を指定します。

webserver.connector.http.bind_host
管理用サーバのIPアドレスまたはホスト名を指定します。

静的コンテンツのキャッシュ
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.static_content.cacheから始まるパラメタで，Webコンテナ単位で静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を指定します。
なお，Webアプリケーション単位での静的コンテンツのキャッシュの設定は，サーバ管理コマンドで指定します。
設定内容については，「4.5　静的コンテンツのキャッシュの設定」を参照してください。

管理用サーバ
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

webserver.connector.http.permitted.hosts
管理用サーバへのアクセスを許可するホストのIPアドレスまたはホスト名を指定します。

ejbserver.http.port
管理用サーバのポート番号を指定します。

ユーザスレッド生成のための権限
server.policy※5
ユーザがプログラムの中で明示して生成するスレッド（ユーザスレッド）を生成するためには，対象となるサーブレットやJSPにスレッドの生成権限を与える必要があります。
設定方法については，「4.6　ユーザスレッド生成のための権限の設定」を参照してください。

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

注※3　J2EEサーバ単位の設定とあわせて，Webアプリケーション単位での文字エンコーディング設定がある場合は，Webアプリケーション単位での設定が有効になります。設定の優先順位については，マニュアル「Cosminexus　機能解説」のデフォルトの文字エンコーディング設定に関する説明を参照してください。なお，Webアプリケーション単位での設定については，「9.6.3(1)　Webコンテナの機能を使用するためのJ2EEアプリケーションの設定」を参照してください。

注※4　Webアプリケーション単位の同時実行スレッド数の設定は，運用管理コマンド（mngsvrutil）を利用して，動的に変更することもできます。これによって，稼働中のWebアプリケーションのサービスを停止することなく，同時実行スレッド数の設定を変更できます。Webアプリケーションの最大同時実行スレッド数の動的変更については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

注※5　server.policyの場合は，Smart Composer機能のコマンドでシステムを構築したあとに設定してください。

(2)　EJBコンテナの機能を使用するための設定

EJBコンテナの機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表4-3　EJBコンテナの機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

RMI-IIOP通信のタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.rmi.request.timeout※1
RMI-IIOP通信のクライアントとサーバ間の通信タイムアウト時間を指定します。

ローカル呼び出し最適化機能の範囲
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.rmi.localinvocation.scope※1
EJBのリモートインタフェースでのローカル呼び出しの最適化の範囲を指定します。

リモートインタフェースの参照渡し機能
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.rmi.passbyreference※1
リモートインタフェースの参照渡し機能を有効にするかどうかを指定します。

また，サーバ管理コマンドでも参照渡し機能を有効にするかどうかを指定できます。サーバ管理コマンドを使用する場合は，Entity Bean属性ファイルやSession Bean属性ファイルの<pass-by-reference>タグに指定します。
簡易構築定義ファイルまたはサーバ管理コマンドのどちらかで有効を指定していれば，参照渡し機能は有効になります。

リモートインタフェースでの通信障害発生時のEJBクライアントの動作
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.rebindpolicy※2
指定先のJ2EEサーバがほかのJ2EEサーバのクライアントである場合に，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。

EJBコンテナの通信ポートとIPアドレスの固定
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

vbroker.se.iiop_tp.scm.iiop_tp.listener.port※1
EJBコンテナの通信ポートを指定します。

vbroker.se.iiop_tp.host※1
EJBコンテナの使用するIPアドレスまたはホスト名を固定するかどうかを指定します。

Timer Service
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.ejb.timerservice.retryCount※1
Timer Serviceのタイムアウトメソッドのコールバックをリトライする最大回数を指定します。

ejbserver.ejb.timerservice.retryInterval※1
Timer Serviceのタイムアウトメソッドのコールバックをリトライする間隔を秒単位で指定します。

ejbserver.ejb.timerservice.maxCallbackThreads※1
J2EEサーバ全体でのTimer Serviceのタイムアウトメソッドをコールバックする最大スレッド数を指定します。

EJBホームオブジェクトへの再接続機能
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.ejbhome.sessionbean.reconnect.enabled※1
EJBホームオブジェクトへの再接続機能を有効にするかどうかを指定します。

Enterprise Beanへのアクセス制御の抑止オプション
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.security.disabled※2
Enterprise Beanへのアクセス制御機能を抑止するかどうかを指定します。

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

(3)　J2EEアプリケーションの実行の機能を使用するための設定

J2EEサーバでJ2EEアプリケーションを実行するためには，簡易構築定義ファイルおよびserver.policyに設定します。設定内容を次の表に示します。

表4-4　J2EEアプリケーションの実行の機能を使用するための設定（簡易構築定義ファイル，server.policy）

項目
設定個所
設定内容

展開ディレクトリ形式のJ2EEアプリケーション
server.policy※1
展開ディレクトリ形式のJ2EEアプリケーションを使用する場合に，server.policyでアクセス権限を変更します。
設定方法については，「4.8　展開ディレクトリ形式のJ2EEアプリケーションの設定」を参照してください。

J2EEアプリケーションの更新検知とリロード
簡易構築定義ファイル※2
J2EEアプリケーションのリロード機能を使用するかどうか，リロードの適用範囲などを指定します。設定方法については，「4.9　J2EEアプリケーションの更新検知とリロードの設定」を参照してください。

注※1　server.policyの場合は，Smart Composer機能のコマンドでシステムを構築したあとに設定してください。

注※2　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

(4)　ネーミング管理の機能を使用するための設定

ネーミング管理の機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表4-5　ネーミング管理の機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

基本設定
デフォルトの設定では，J2EEサーバはホスト名「localhost」，ポート番号「900」のCORBAネーミングサービスをインプロセスで自動起動して使用します。設定を変更したい場合には，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.naming.host※1
CORBAネーミングサービスのホスト名を指定します。

ejbserver.naming.port※1
CORBAネーミングサービスのポート番号を指定します。

ejbserver.naming.startupMode※1
CORBAネーミングサービスの起動モードを指定します。

ラウンドロビン検索※2
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.namingservice.group.list※1
CORBAネーミングサービスのグループを指定します。

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls※1
各グループに属する，CORBAネーミングサービスのルート位置を指定します。

java.naming.factory.initial※1
InitialContextFactoryの実装をデレゲートしているクラスを指定します。

ネーミングのキャッシング
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.cache※1
ネーミングでのキャッシングを有効にするかどうかを指定します。

ejbserver.jndi.cache.interval※1
キャッシュクリアの間隔を指定します。

ejbserver.jndi.cache.interval.clear.option※1
キャッシュクリアの範囲を指定します。

キャッシュを定期的にクリアするときの設定例（物理ティアの定義の場合）を次に示します。

（例）

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.jndi.cache</param-name>
   <param-value>on</param-value>
 </param>
 <param>
   <param-name>ejbserver.jndi.cache.interval</param-name>
   <param-value>60</param-value>
 </param>
 <param>
   <param-name>ejbserver.jndi.cache.interval.clear.option</param-name>
   <param-value>check</param-value>
 </param>
 ：
</configuration>

ネーミングサービスの通信タイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.request.timeout※1
ネーミングサービスとの通信タイムアウト時間を指定します。

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　ラウンドロビン検索は，ユーザ指定名前空間機能を使用していることが前提になります。ユーザ指定名前空間機能を使用する場合，サーバ管理コマンドの動作設定のカスタマイズと，J2EEアプリケーションのプロパティの定義が必要です。設定方法については，「9.2.2　サーバ管理コマンドの動作設定のカスタマイズ」，および「9.6.3　J2EEアプリケーションのプロパティ定義で設定できること」を参照してください。

(5)　リソース接続とトランザクション管理の機能を使用するための設定

リソース接続とトランザクション管理の機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表4-6　リソース接続とトランザクション管理の機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

トランザクションの種類
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.distributedtx.XATransaction.enabled※1
ライトトランザクションを使用するか，グローバルトランザクションを使用するかどうかを指定します。デフォルトの設定では，ライトトランザクションが有効になっています。

トランザクションのタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.jta.TransactionManager.defaultTimeOut※1
トランザクションのタイムアウト時間を指定します。

トランザクションのリカバリ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.distributedtx.recovery.port※1
グローバルトランザクションを使用する場合に，トランザクションのリカバリで使用する固定ポート番号を指定します。

システム例外発生時のクライアントトランザクションの動作
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.distributedtx.rollbackClientTxOnSystemException※1
システム例外が発生したときにクライアントトランザクションをロールバックにマークするかどうかを指定します。

ステータスファイルの格納ディレクトリ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，インプロセストランザクションサービスのステータスファイルとステータスファイルのバックアップを格納するディレクトリとして，次のパラメタを指定します。

ejbserver.distributedtx.ots.status.directory1※1

ejbserver.distributedtx.ots.status.directory2※1

インプロセストランザクションサービスでは，トランザクションの整合性を保証するため，ホスト名またはIPアドレスをJ2EEサーバの識別情報としてステータスファイル内に取り込みます。このため，J2EEサーバのコンフィグレーション定義でvbroker.se.iiop_tp.hostパラメタを設定していて値を変更する場合，またはvbroker.se.iiop_tp.hostパラメタを設定しないでJ2EEサーバを起動するマシンのIPアドレスを変更する場合は，次の手順に従ってください。

J2EEサーバ上でトランザクションが存在しない状態で，J2EEサーバを停止してください。

IPアドレス，またはvbroker.se.iiop_tp.hostパラメタの設定を変更してください。

ejbserver.distributedtx.ots.status.directory1パラメタで指定したディレクトリを削除してください。

J2EEサーバを起動してください。

Application Serverが管理するトランザクションの外でコネクションシェアリングの有効化
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled※2
アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときの，コネクションシェアリングの動作を指定します。

コネクションアソシエーション
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.connectionpool.association.enabled※1
コネクションアソシエーション機能を使用するかどうかを指定します。

ejbserver.connectionpool.association.enabledDespiteUnshareableSetting※2
システムプロパティには，リソースの非共有を設定している場合※3でも，コネクションアソシエーション機能を使用するかどうかを指定します。

DataSourceオブジェクトのキャッシング
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.cache.reference※2
DataSourceオブジェクトのキャッシングを有効にするかどうかを指定します。

DB Connectorのコンテナ管理でのサインオンの最適化
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.connectionpool.applicationAuthentication.disabled※2
コンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。

コネクションの自動クローズ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.webj2ee.connectionAutoClose.enabled※1
Webアプリケーションでコネクションを自動クローズするかどうかを指定します。

トランザクションタイムアウト（J2EEサーバ単位）※4
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jta.TransactionManager.defaultTimeOut※1
J2EEサーバ上で開始されるトランザクションのタイムアウトのデフォルト値を指定します。

未決着トランザクションの確認時間のタイムアウト※5
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout※2
J2EEサーバ停止時に行われるトランザクション仕掛かり完了確認のタイムアウト時間を指定します。

スマートエージェントが使用する通信ポート
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

vbroker.agent.port※1
スマートエージェントが使用する通信ポートを指定します。

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

注※3　WAR属性ファイル，Entity Bean属性ファイル，Session Bean属性ファイル，またはMessage-driven Bean属性ファイルの<res-sharing-scope>タグで，Unshareable（リソースを共有しない）を指定している場合のことです。

注※4　CMTの場合，Enterprise Bean，インタフェース，メソッド単位の設定もできます。Enterprise Bean，インタフェース，メソッド単位に設定する場合には，J2EEアプリケーションの設定時にサーバ管理コマンドを使用して属性ファイルに設定します。J2EEアプリケーションの設定については，「9.6.3　J2EEアプリケーションのプロパティ定義で設定できること」を参照してください。

注※5　アプリケーション開発時にタイムアウトを設定してください。J2EEアプリケーション運用時には，トランザクションの信頼性を保証するために，タイムアウトを設定しないことをお勧めします。

(6)　コンテナ拡張ライブラリの機能を使用するための設定

コンテナ拡張ライブラリの機能を使用するためには，簡易構築定義ファイルに設定します。

論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

add.class.path
コンテナ拡張ライブラリのJARファイルのパスを指定します。

add.library.path
JNI用ライブラリの検索パスを指定します。

これらのパラメタは，簡易構築定義ファイルのJ2EEサーバの拡張パラメタに設定します。

コンテナ拡張ライブラリの機能を使用するための設定方法については，「4.10　コンテナ拡張ライブラリの設定」を参照してください。

(7)　CTMの機能を使用するための設定

CTMの機能を使用する場合，CTMを使用する構成でシステムを構築する必要があります。CTMを使用するシステムの構成や構築手順については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

CTMの機能を使用して，リクエストをスケジューリングするための設定は，簡易構築定義ファイルでejbserver.ctmから始まるパラメタに，CTMデーモンのCTM識別子，CTMキューの長さなどを指定します。設定方法については，「4.11　CTMによるリクエストのスケジューリングの設定」を参照してください。

(8)　セッションフェイルオーバ機能を使用するための設定

セッションフェイルオーバ機能を使用する場合，セッションフェイルオーバ機能を使用する構成でシステムを構築する必要があります。セッションフェイルオーバ機能を使用するシステムの構成や構築手順については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

セッションフェイルオーバ機能を使用するための設定は，簡易構築定義ファイルでSFOサーバ用のパラメタと，セッション情報の引き継ぎを行うJ2EEサーバ用のパラメタに設定します。設定方法については，「6.2　J2EEサーバ間のセッション情報の引き継ぎの設定」を参照してください。

(9)　システムの日常運用の支援機能を使用するための設定

システムの日常運用の支援機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表4-7　システムの日常運用の支援機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

リソース枯渇監視機能
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watchから始まるパラメタ※で，リソース枯渇監視機能の使用の有無，リソースの監視間隔やしきい値などを指定します。なお，リソースの種別によっては，リソースの監視間隔やしきい値は，サーバ管理コマンドで指定します。設定方法については，「6.3.4(1)　リソース枯渇監視の設定」を参照してください。

稼働情報収集機能
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.managementから始まるパラメタ※で，稼働情報の取得レベル，収集間隔，稼働情報ファイルの出力先，イベントを発行するためのしきい値や監視間隔などを指定します。
なお，URLグループ単位の実行待ちリクエスト数を監視してイベントを発行する場合の設定は，サーバ管理コマンドで指定します。
設定方法については，「4.13　稼働情報ファイルの取得とイベント発行の設定」を参照してください。
また，イベント発行時に出力されるメッセージを利用してManagementイベントを発行することもできます。Managementイベントの設定については，「6.3　Managementイベントによる処理の自動実行の設定」を参照してください。

Managementイベントによる処理の自動実行
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.manager.agent.MEventAgent.enabled※
Managementイベントの発行を有効にするかどうかを指定します。

このほかに，論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，manager.meventから始まるパラメタ※で，Managementイベント発行時の動作を設定します。設定方法については，「6.3　Managementイベントによる処理の自動実行の設定」を参照してください。

注※　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

(10)　システムの保守支援機能を使用するための設定

システムの保守支援機能を使用するためには，簡易構築定義ファイルおよびserver.policyに設定します。設定内容を次の表に示します。

表4-8　システムの保守支援機能を使用するための設定（簡易構築定義ファイル，server.policy）

項目
設定個所
設定内容

J2EEアプリケーションのユーザログ出力
簡易構築定義ファイル※1，
server.policy※2
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.applicationから始まるパラメタで，J2EEアプリケーションのユーザログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定します。また，server.policyにセキュリティポリシーを指定します。設定方法については，「5.20　アプリケーションのユーザログ出力の設定」を参照してください。

J2EEサーバのログ出力
簡易構築定義ファイル※1
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejb.server.log.directory
J2EEサーバのログの出力先ディレクトリを指定します。

ejbserver.loggerから始まるパラメタ
J2EEサーバのログのファイルサイズ，ファイル面数，出力レベルなどを指定します。

設定方法については，「5.6　J2EEサーバのログ取得の設定」を参照してください。

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　server.policyの場合は，Smart Composer機能のコマンドでシステムを構築したあとに設定してください。

(11)　J2EEアプリケーションの運用機能を使用するための設定

J2EEアプリケーションの運用機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表4-9　J2EEアプリケーションの運用機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

J2EEアプリケーションの強制停止
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.deploy.app.stopforcibly.disabled※1
J2EEアプリケーションの強制停止機能を使用するかどうかを指定します。

なお，J2EEアプリケーションのフロント（クライアントから見てリクエストの受け口になる要素）がEnterprise Beanの場合には，サーバ管理コマンドを使用してフロントとなるEnterprise Bean（フロントEJB）を指定する必要があります。サーバ管理コマンドを使用する場合は，SessionBean属性ファイル，EntityBean属性ファイル，またはMessageDrivenBean属性ファイルの<front-ejb>タグに指定します。

J2EEアプリケーション実行時間の監視
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.ext.method_observation.interval※2
J2EEアプリケーション実行時間の監視機能を使用するかどうか，動作中のリクエスト処理がタイムアウトしていないかを調査する時間間隔，およびタイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔を指定します。

なお，J2EEアプリケーション実行時間の監視機能で使用するメソッドタイムアウトの時間，メソッドキャンセルのモードは，サーバ管理コマンドで指定します。
設定方法については，「4.14　J2EEアプリケーション実行時間の監視の設定」を参照してください。

注※1　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

注※2　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

(12)　システムの監査支援機能を使用するための設定

システムの監査支援機能を使用するためには，簡易構築定義ファイルおよび監査ログファイルに設定します。設定内容を次の表に示します。

表4-10　システムの監査支援機能を使用するための設定（簡易構築定義ファイル，監査ログファイル）

項目
設定個所
設定内容

データベース監査証跡との連携
簡易構築定義ファイル※
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.audit_trail.enabled
データベース監査証跡連携機能を有効にするかどうかを指定します。

設定方法については，「4.15　データベース監査証跡との連携の設定」を参照してください。

監査ログ出力
監査ログ定義ファイル
監査ログ定義ファイルに，監査ログを出力するかどうかを指定します。設定方法については，「4.16　監査ログ出力の設定」を参照してください。

注※　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

4.3　JSPファイルのコンパイル結果の保持の設定

JSPは，Webコンテナ上でコンパイルされ，Javaソースファイルおよびクラスファイルが生成されます。Webコンテナでは，JSPのコンパイル結果である，Javaソースファイルおよびクラスファイルを，J2EEサーバの再起動時に保持するかどうか設定できます。この節では，JSPファイルのコンパイル結果を保持するための設定について説明します。

＜この節の構成＞

(1)　設定方法

(2)　コンパイル結果の出力先について

(1)　設定方法

JSPファイルのコンパイル結果を保持するかどうかは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.work.clean
コンパイル結果を保持するかどうかを指定します。

webserver.work.directory
コンパイル結果の出力先を指定します。デフォルトの出力先を変更する場合に指定します。デフォルトの出力先については，「(2)　コンパイル結果の出力先について」を参照してください。なお，この出力先はJSP事前コンパイルを実施しない場合の出力先となります。

webserver.xml.validate
JSP事前コンパイル実行時に，TLDファイルの検証を実施するかどうかを指定します。なお，このパラメタは，Webアプリケーションのバージョンが2.3以前のときに指定します。Webアプリケーションのバージョンが2.4のときはデフォルトで検証を実施するため，このパラメタへの指定はできません。

(2)　コンパイル結果の出力先について

JSP事前コンパイル機能を使用していない場合，JSPコンパイル結果は，JSP用テンポラリディレクトリ下に出力されます。デフォルトの出力先を変更する場合は，webserver.work.directoryパラメタに設定します。デフォルトの出力先を次に示します。

デフォルトの出力先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥web

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名称>/web

JSP用テンポラリディレクトリ下にはWebアプリケーション単位でディレクトリが作成され，該当するWebアプリケーション内のJSPコンパイル結果が出力されます。

なお，Webアプリケーション単位のディレクトリは，コンテキストルート名を基にしたディレクトリ名となります。コンテキストルート名にスラッシュ（/），ドル記号（$），パーセント（%），プラス記号（+）が含まれる場合は，次に示す文字に変換されます。

変換前の文字 | 変換後の文字
/ | $2f
$ | $24
% | $25
+ | $2b

例：

JSP用テンポラリディレクトリがデフォルト，コンテキストルート名が「J2EE_AP1/WEB_AP1_war」である場合，該当するWebアプリケーションのJSPコンパイル結果の出力先を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥web¥J2EE_AP1$2fWEB_AP1_war

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名称>/web/J2EE_AP1$2fWEB_AP1_war

注意

JSP用テンポラリディレクトリの設定を変更する場合

JSPコンパイル結果を保持する設定でWebコンテナを稼働したあと，JSP用テンポラリディレクトリの設定を変更した場合，変更前のJSP用テンポラリディレクトリは削除されません。このため，手動で削除する必要があります。

4.4　同時実行スレッド数の制御の設定

Webコンテナでは，マルチスレッドでサーブレットのリクエストを処理します。このとき，同時に実行できるスレッド数に上限を設定することで，スラッシングなどによるパフォーマンスの低下を防止できます。また，適切なスレッド数を設定することで，アクセス状況に従ったパフォーマンスのチューニングができます。この節では，同時に実行するスレッド数を制御するための設定について説明します。

＜この節の構成＞

(1)　設定方法

(2)　同時実行スレッド数設定の指針

(1)　設定方法

同時に実行するスレッド数を制御するには，Webコンテナ単位で制御する方法，Webアプリケーション単位で制御する方法，およびURLグループ単位で制御する方法があります。

(a)　Webコンテナ単位での制御

Webコンテナ単位で同時実行スレッド数を制御する場合，Webコンテナ全体で同時に実行できるスレッドの最大数を設定します。ここで設定したスレッド数は，WebコンテナにデプロイされているすべてのWebアプリケーションで共用するスレッド数となります。

Webコンテナ単位での同時実行スレッド数の制御は，簡易構築定義ファイルで設定します。指定するパラメタは，Webサーバ連携の場合と，インプロセスHTTPサーバを使用する場合で異なります。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のどちらかのパラメタを指定します。

webserver.connector.ajp13.max_threads
Webコンテナ全体の最大同時実行スレッド数を指定します。このパラメタはWebサーバ連携の場合に指定します。

webserver.connector.inprocess_http.max_execute_threads
Webコンテナ全体の最大同時実行スレッド数を指定します。このパラメタはインプロセスHTTPサーバを使用する場合に指定します。

(b)　Webアプリケーション単位での制御

Webアプリケーション単位で同時実行スレッド数を制御する場合，Webコンテナでのスレッド数制御も同時に設定する必要があります。Webアプリケーション単位での同時実行スレッド数制御で設定するパラメタを次の表に示します。

表4-11　Webアプリケーション単位でスレッド数を制御する場合の設定パラメタ

設定するパラメタ | 設定単位
Webコンテナ単位 | Webアプリケーション単位
最大同時実行スレッド数 | ○ | ○
占有スレッド数 | － | ○
実行待ちキューサイズ | － | ○
デフォルトの実行待ちキューサイズ | － | ○

（凡例）　○：設定する。　－：該当しない。

次に，Webアプリケーション単位での同時実行スレッド数制御の設定について説明します。Webアプリケーション単位での同時実行スレッド数の制御は，usrconf.propertiesおよびサーバ管理コマンドで設定します。なお，Webコンテナ単位での設定パラメタについては，「(a)　Webコンテナ単位での制御」を参照してください。

●簡易構築定義ファイルでの設定

簡易構築定義ファイルでは，次の内容が設定できます。

同時実行スレッド数の制御の有無
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.container.thread_control.enabledパラメタで，Webアプリケーション単位で同時実行スレッド数を制御するかどうかを指定します。「true」を指定すると，Webアプリケーション単位での同時実行スレッド数制御が有効になります。なお，「false」を指定するとWebアプリケーション単位での同時実行スレッド数制御が無効となり，Webコンテナ単位で同時実行スレッド数が制御されます。

デフォルトの実行待ちキューサイズ
実行スレッド数が最大数に達した場合，リクエストはキューに溜められます。このときの，Webアプリケーションで共通となる実行待ちキューサイズ（デフォルトの実行待ちキューサイズ）をwebserver.container.thread_control.queue_sizeパラメタで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定します。ここで設定した値は，Webアプリケーション単位での同時実行数を指定していない場合に適用されます。

●サーバ管理コマンドでの設定

サーバ管理コマンドでは，次の内容が設定できます。

Webアプリケーション単位での最大同時実行スレッド数
Webアプリケーションで，最大で幾つのスレッドを同時に実行できるかを指定できます。

Webアプリケーション単位の占有スレッド数
Webアプリケーションで，最低限確保するスレッド数（占有スレッド数）を指定できます。
なお，占有スレッド数を設定しない場合は，0を指定します。

Webアプリケーション単位の実行待ちキュー
実行スレッド数が最大数に達した場合，リクエストはキューに溜められます。このときの，実行待ちキューサイズをWebアプリケーション単位で指定します。

サーバ管理コマンドを使用する場合には，WAR属性ファイルの<thread-control>タグで，同時実行スレッド数を設定します。

<thread-control>タグ下の<thread-control-max-threads>タグに，Webアプリケーション単位での最大同時実行スレッド数を指定します。

<thread-control>タグ下の<thread-control-exclusive-threads>タグに，Webアプリケーション単位での占有スレッド数を指定します。

<thread-control>タグ下の<thread-control-queue-size>タグに，実行待ちキューサイズを指定します。

サーバ管理コマンドのcjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。サーバ管理コマンドについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(c)　URLグループ単位での制御

URLグループ単位で同時実行スレッド数を制御する場合，Webアプリケーション単位での同時実行スレッド数制御，およびWebコンテナでのスレッド数制御も同時に設定する必要があります。URLグループ単位での同時実行スレッド数制御で設定するパラメタを次の表に示します。

表4-12　URLグループ単位でスレッド数を制御する場合の設定パラメタ

設定するパラメタ | 設定単位
Webコンテナ単位 | Webアプリケーション単位 | URLグループ単位
同時実行スレッド数の制御をするかどうか | － | ○ | －
最大同時実行スレッド数 | ○ | ○ | ○
占有スレッド数 | － | ○ | ○
実行待ちキューサイズ | － | ○ | ○
デフォルトの実行待ちキューサイズ | － | ○ | －
URLグループ単位の同時実行スレッド数制御の定義名 | － | － | ○
制御対象となるURLパターン | － | － | ○

（凡例）　○：設定する。　－：該当しない。

次に，URLグループ単位での同時実行スレッド数制御の設定について説明します。URLグループ単位での同時実行スレッド数の制御は，サーバ管理コマンドで設定します。なお，Webコンテナ単位での設定パラメタについては，「(a)　Webコンテナ単位での制御」を，Webアプリケーション単位での設定パラメタについては，「(b)　Webアプリケーション単位での制御」を参照してください。

サーバ管理コマンドでは，次の内容が設定できます。

URLグループ単位の同時実行スレッド数制御の定義名
同時実行スレッド数制御をするURLのグループ名を指定します。グループ名はWebアプリケーション内で一意な名称を指定する必要があります。
使用できる文字は次のとおりです。

半角英数字（A～Z，a～z，0～9）

半角ハイフン（-）

半角アンダーバー（_）

また，文字列の長さは1～64文字となります。

URLグループ単位の最大同時実行スレッド数
URLグループで，最大で幾つのスレッドを同時に実行できるかを指定します。設定範囲は次のとおりです。

最大同時実行スレッド数の設定範囲

1≦最大同時実行スレッド数（URLグループ単位）≦最大同時実行スレッド数（Webアプリケーション単位）

URLグループ単位の占有スレッド数
URLグループで，最低限確保するスレッド数（占有スレッド数）を指定します。設定範囲は次のとおりです。

占有スレッド数の設定範囲

0≦占有スレッド数（URLグループ単位）≦最大同時実行スレッド数（URLグループ単位）

さらに，URLグループ単位の占有スレッド数は，Webアプリケーション単位の占有スレッド数以下である必要があります。

また，Webアプリケーション内のURLグループ単位に設定している占有スレッド数の総和は，次の条件を満たしている必要があります。なお，条件は，Webアプリケーション単位の最大同時実行スレッド数とWebアプリケーション単位の占有スレッド数の値によって異なります。

Webアプリケーション単位の設定が，最大同時実行スレッド数≠占有スレッド数の場合

占有スレッド数（Webアプリケーション単位）≧占有スレッド数の総和（URLグループ単位）

Webアプリケーション単位の設定が，最大同時実行スレッド数＝占有スレッド数の場合

占有スレッド数（Webアプリケーション単位）＞占有スレッド数の総和（URLグループ単位）

なお，占有スレッド数を設定しない場合は，0を指定します。

実行待ちキューサイズ
実行スレッド数が最大数に達した場合，リクエストはキューに溜められます。このときの，実行待ちキューサイズをURLグループ単位で指定します。設定範囲は次のとおりです。

実行待ちキューサイズの設定範囲

0≦実行待ちキューサイズ（URLグループ単位）≦2,147,483,647

なお，0を設定すると，実行待ちキューを使用しない設定になります。このとき，同時実行スレッド数が上限に達すると，リクエストはエラーとなります。

制御対象となるURLパターン
同時実行スレッド数の制御対象となるURLを指定します。URLパターンはWebアプリケーション内で一意な名称を指定する必要があります。また，Webアプリケーションのコンテキスト以下を指定してください。

サーバ管理コマンドを使用する場合は，WAR属性ファイルの<thread-control>タグ下の<urlgroup-thread-control>タグで，同時実行スレッド数を設定します。

<urlgroup-thread-control-name>タグに，同時実行スレッド数制御の定義名を指定します。

<urlgroup-thread-control-max-threads>タグに，URLグループ単位での最大同時実行スレッド数を指定します。

<urlgroup-thread-control-exclusive-threads>タグに，占有スレッド数を指定します。

<urlgroup-thread-control-queue-size>タグに，実行待ちキューサイズを指定します。

<urlgroup-thread-control-mapping>タグに，制御対象となるURLパターンを<url-pattern>タグで囲んで指定します。

サーバ管理コマンドのcjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。サーバ管理コマンドについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(2)　同時実行スレッド数設定の指針

Webアプリケーション単位またはURLグループ単位の同時実行スレッド数制御をする場合の設定の指針について説明します。

(a)　Webアプリケーション単位で制御する場合の指針

設定する値は，次の順に決定してください。

Webコンテナ単位の最大同時実行スレッド数を決定する。

Webアプリケーション単位の最大同時実行スレッド数を決定する。

Webアプリケーション単位の占有スレッド数を決定する。

実行待ちキューサイズを決定する。

Webアプリケーション単位の同時実行スレッド数の設定は，各Webアプリケーションの運用，およびJ2EEサーバが動作するホストの処理能力を考慮して設定してください。設定値が妥当であるかどうかは，Webアプリケーションを実行し，評価する必要があります。
なお，実行中のWebアプリケーションの稼働情報は，Management Serverを利用して確認できます。Webアプリケーションの稼働状況の確認については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

複数のWebアプリケーションに占有スレッド数を設定する場合，各Webアプリケーションの占有スレッド数の合計は，Webコンテナの最大同時実行スレッドの値以下にする必要があります。設定値については，Webコンテナ単位の同時実行スレッド数の制御とあわせて検討してください。

Webコンテナ単位の最大同時実行スレッド数が少ない場合，Webアプリケーション単位の最大同時実行スレッド数は，設定した数よりも少なくなるおそれがありますので，注意してください。

占有スレッド数は，Webアプリケーションの最大同時実行スレッド数以下にしてください。

(b)　URLグループ単位で制御する場合の指針

URLグループ単位の同時実行スレッド数制御の設定をする場合，事前に次の内容を設定しておいてください。

Webコンテナ単位の最大同時実行スレッド数

Webアプリケーション単位の最大同時実行スレッド数，占有スレッド数，実行待ちキューサイズ

設定する値は，次の順に決定してください。

URLグループ単位の最大同時実行スレッド数を設定する。

URLグループ単位の占有スレッド数を設定する。

URLグループ単位の実行待ちキューサイズを設定する。

URLパターンを設定する。

URLグループ単位の最大同時実行スレッド数は，J2EEアプリケーション内にある業務ロジックに対して，適切な値を設定してください。
例えば，特定の業務ロジックの処理が重い場合，その業務ロジックの同時実行スレッド数に上限を設けることで，特定の業務ロジックにアクセスが集中した場合でも，特定の業務ロジックがWebアプリケーション全体の処理能力を占有するのを防ぐことができます。

URLグループ単位の占有スレッド数は，特定の業務ロジックをWebアプリケーション内のほかの業務ロジックの影響を受けないで実行させるために設定します。

URLグループ単位の実行待ちキューサイズは，特定の業務ロジックへの流量の上限を設けるために設定します。URLグループ単位の実行待ちキューは，デフォルトの実行待ちキュー，Webアプリケーション単位の実行待ちキューと設定指針は同じです。

4.5　静的コンテンツのキャッシュの設定

静的コンテンツのキャッシュ機能を使用すると，一度アクセスした静的コンテンツをメモリ上にキャッシュし，2回目以降のアクセスではキャッシュからブラウザにレスポンスを返すことで，静的コンテンツのレスポンスタイムを短縮できます。

Webコンテナでは，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を設定して，静的コンテンツのキャッシュを制御します。

静的コンテンツのキャッシュは，Webコンテナ単位，およびWebアプリケーション単位で設定できます。この節では，それぞれの静的コンテンツのキャッシュの設定について説明します。

ポイント

Webコンテナ単位での設定，Webアプリケーション単位での設定をどちらも設定した場合には，Webアプリケーション単位での設定が優先されます。

＜この節の構成＞

(1)　Webコンテナ単位での設定

(2)　Webアプリケーション単位での設定

(1)　Webコンテナ単位での設定

Webコンテナ単位に，静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を設定します。設定した内容は，WebコンテナにデプロイされているすべてのWebアプリケーションに適用されます。

Webコンテナ単位での静的コンテンツのキャッシュは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで設定します。

webserver.static_content.cache.enabled
静的コンテンツのキャッシュの有効，無効，または強制無効を指定します。

webserver.static_content.cache.size
静的コンテンツのキャッシュを許可する，Webアプリケーション単位のメモリサイズを設定します。

webserver.static_content.cache.filesize.threshold
静的コンテンツのキャッシュを許可する，Webアプリケーション単位のファイルサイズの上限値を指定します。

パラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　Webアプリケーション単位での設定

Webアプリケーション単位に，静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を設定します。

Webアプリケーション単位での静的コンテンツのキャッシュの設定には，サーバ管理コマンドを使用した属性ファイルの編集による方法と，WebアプリケーションのDD（web.xml）の直接編集による方法の2種類があります。ここでは，サーバ管理コマンドを使用した属性ファイルの編集による設定について説明します。WebアプリケーションのDD（web.xml）の直接編集による設定については，マニュアル「Cosminexus　アプリケーション開発ガイド」のDDの編集に関する説明を参照してください。

(a)　設定方法

サーバ管理コマンドを使用して属性ファイルを編集する場合は，アプリケーション属性ファイルに，静的コンテンツのキャッシュの設定をします。cjgetapppropコマンドでアプリケーション属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容をWebアプリケーションに反映させてください。

(b)　設定内容

アプリケーション属性ファイルの<context-param>タグ内の<param-name>タグと<param-value>タグで，静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を設定します。

アプリケーション属性ファイルの<context-param>タグ内の<param-name>タグと<param-value>タグでの設定内容を次の表に示します。

表4-13　属性ファイルの設定内容（静的コンテンツのキャッシュの設定）

定義する項目
<param-name>に指定するパラメタ
<param-value>に指定する内容
デフォルト値

静的コンテンツのキャッシュの有効／無効
com.hitachi.software.web.static_content.cache.enabled
静的コンテンツのキャッシュの有効または無効を指定します。

true
静的コンテンツのキャッシュを有効にします。

false
静的コンテンツのキャッシュを無効にします。

false

Webアプリケーション単位のメモリサイズ
com.hitachi.software.web.static_content.cache.size
静的コンテンツのキャッシュを許可する，Webアプリケーション単位のメモリサイズ（バイト単位）を指定します。
0～2,147,483,647の範囲で指定できます。0を指定した場合は，メモリサイズは無制限となります。
10,485,760

Webアプリケーション単位のファイルサイズの上限値
com.hitachi.software.web.static_content.cache.filesize.threshold
静的コンテンツのキャッシュを許可する，Webアプリケーション単位のファイルサイズの上限値（バイト単位）を指定します。0～2,147,483,647の範囲で指定できます。0を指定した場合は，ファイルサイズは無制限となります。
524,288

なお，アプリケーション属性ファイルで無効な値や空文字が設定された場合は，Webコンテナ単位での設定内容（usrconf.propertiesの設定内容）が使用されます。

(c)　属性ファイルの記述例

アプリケーション属性ファイルの記述例を次に示します。

　　 （省略）
　　　　：
<hitachi-war-property>
 <description></description>
 <display-name>StaticContentCache_war</display-name>
 <small-icon></small-icon>
 <large-icon></large-icon>

<context-param>
<param-name>
com.hitachi.software.web.static_content.cache.enabled
</param-name>
<param-value>true</param-value>
</context-param>

<context-param>
<param-name>
com.hitachi.software.web.static_content.cache.size
</param-name>
<param-value>5242880</param-value>
</context-param>

<context-param>
<param-name>
com.hitachi.software.web.static_content.cache.filesize.threshold
</param-name>
<param-value>102400</param-value>
</context-param>

 <session-config>
   <session-timeout>30</session-timeout>
 </session-config>
 <runtime>
   <context-root>sys</context-root>
 </runtime>
 <http-session>
   <http-session-max-number>-1</http-session-max-number>
   <resource-watcher>
     <watcher-threshold>80</watcher-threshold>
     <watcher-interval>30</watcher-interval>
     <watcher-enabled>true</watcher-enabled>
     <watcher-writefile-enabled>true</watcher-writefile-enabled>
   </resource-watcher>
 </http-session>
 <start-notify-error>true</start-notify-error>
 <start-order>10</start-order>
</hitachi-war-property>
　　　　：
　　 （省略）

この記述例で設定される内容は，次のとおりです。

静的コンテンツキャッシュ機能を有効にしています。

キャッシュを許可するWebアプリケーション単位のメモリサイズを5,242,880バイトにしています。

キャッシュを許可するWebアプリケーション単位のファイルサイズの上限値を102,400バイトにしています。

4.6　ユーザスレッド生成のための権限の設定

アプリケーションを構成するサーブレットおよびJSPからスレッドを生成して，使用できます。ユーザがプログラムの中で明示して生成するスレッドのことを，ユーザスレッドといいます。

この節では，ユーザスレッドを生成するための権限の設定について説明します。なお，ユーザスレッドの使用条件やライフサイクル，ユーザスレッドの機能については，マニュアル「Cosminexus　機能解説」を参照してください。

ユーザスレッドを生成するには，server.policyに次の記述があるかどうかを確認してください。この定義によって，ユーザスレッドを生成するための権限が与えられます。

permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "modifyThreadGroup";

server.policyの記述例を次に示します。

：
//
// Grant permissions to JSP/Servlet
//
grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
permission java.lang.RuntimePermission "loadLibrary.*";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "modifyThreadGroup";
permission java.net.SocketPermission "*", "connect";
permission java.io.FilePermission "<<ALL FILES>>", "read, write";
permission java.util.PropertyPermission "*", "read";
};
：

4.7　アノテーションの参照を抑止する設定

この節では，J2EEサーバ単位にアノテーションの参照を抑止するために必要な設定について説明します。アノテーションの参照を抑止する機能については，マニュアル「Cosminexus　機能解説」のアノテーションの参照抑止に関する説明を参照してください。

J2EEサーバ単位に，アノテーションの参照を抑止するかどうかを設定します。設定した内容は，そのJ2EEサーバにデプロイされているすべてのJ2EEアプリケーションに適用されます。

J2EEサーバ単位でアノテーションの参照を抑止する設定は，簡易構築定義ファイルを編集して行います。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで設定します。

ejbserver.deploy.applications.metadata_complete
アノテーションの参照を抑止するかどうかを指定します。

パラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

アノテーションの参照を抑止する設定をした場合，設定したJ2EEサーバの起動時に，アノテーションの参照を抑止することを示すメッセージが出力されます。J2EEサーバ起動前または起動後にアノテーションの参照を抑止しているかどうかの設定を確認する場合は，簡易構築定義ファイルの<configuration>タグ内のパラメタ「ejbserver.deploy.applications.metadata_complete」に設定された値を参照してください。

4.8　展開ディレクトリ形式のJ2EEアプリケーションの設定

この節では，展開ディレクトリ形式のJ2EEアプリケーションを使用するために必要な設定について説明します。展開ディレクトリ形式のJ2EEアプリケーションについては，マニュアル「Cosminexus　機能解説」の展開ディレクトリ形式によるJ2EEアプリケーションのデプロイを参照してください。

展開ディレクトリ形式のJ2EEアプリケーションを使用する場合には，次のどちらかの方法でセキュリティの設定を変更することをお勧めします。

SecurityManagerの解除

セキュリティポリシーの設定変更

それぞれの方法について説明します。

＜この節の構成＞

(1)　SecurityManagerを解除する場合

(2)　セキュリティポリシーの設定を変更する場合

(1)　SecurityManagerを解除する場合

J2EEサーバを起動するときに，cjstartsvコマンドに-nosecurityオプションを指定し，SecurityManagerを解除します。

# cjstartsv -nosecurity <サーバ名称>

注意

SecurityManagerを解除することで，リソースアクセス時の権限チェックのオーバーヘッドを削減できますが，J2EEアプリケーションは任意のリソースへのアクセスができるようになるため，セキュリティが低下します。

(2)　セキュリティポリシーの設定を変更する場合

アプリケーションディレクトリ以下のJARファイルやクラスファイルに，リソースに対するアクセス権を与えるために，server.policyを次のように編集します。

grant codeBase "file:/D:/MyApplicationDir/Web.war/-"{
   permission java.lang.RuntimePermission "loadLibrary.*";
   permission java.lang.RuntimePermission "queuePrintJob";
   permission java.net.SocketPermission "*", "connect";
   permission java.io.FilePermission "<<ALL FILES>>", "read, write";
   permission java.util.PropertyPermission "*", "read";
};

4.9　J2EEアプリケーションの更新検知とリロードの設定

アプリケーション開発でのテストやシステムの運用中に，修正したJ2EEアプリケーションと動作中のJ2EEアプリケーションを入れ替えたい場合，リロード機能を使用した入れ替えができます。展開ディレクトリ形式のJ2EEアプリケーションを構成するファイルを更新した場合に，更新検知やコマンド実行によって，更新したJ2EEアプリケーションをリロードできます。リロード機能を使用することで，少ない手順でJ2EEアプリケーションを動的に入れ替えられるようになります。

この節では，展開ディレクトリ形式のJ2EEアプリケーションの更新検知とリロードをするための設定について説明します。更新検知とリロードについては，マニュアル「Cosminexus　機能解説」のJ2EEアプリケーションの更新検知とリロードに関する説明を参照してください。

展開ディレクトリ形式のJ2EEアプリケーションをリロードするために必要な設定は，構成ファイルの更新を検知してリロードするか，コマンドを実行してリロードするかによって異なります。展開ディレクトリ形式のJ2EEアプリケーションをリロードするために必要な設定を次の表に示します。

表4-14　リロードするために必要な設定

設定項目 | 更新検知によるリロードの場合 | コマンドによるリロードの場合
リロード機能の適用範囲の設定 | ○ | ○
更新検知インターバルの設定 | ○ | －
構成ファイル更新用インターバルの設定 | ○ | －
リロード遅延実行の設定 | ○ | －
セッション情報ファイル格納先ディレクトリの変更 | △ | △
JSP事前コンパイルの設定 | △ | △
J2EEアプリケーション実行時間の監視の設定 | △ | △

（凡例）　○：設定する。　△：必要に応じて設定する。　－：該当しない。

＜この節の構成＞

(1)　リロード機能の適用範囲の設定

(2)　更新検知インターバルの設定

(3)　構成ファイル更新用インターバルの設定

(4)　リロード遅延実行の設定

(5)　セッション情報ファイル出力先の変更

(6)　JSP事前コンパイルの設定

(7)　J2EEアプリケーション実行時間の監視の設定

(1)　リロード機能の適用範囲の設定

デフォルトの設定では，リロード機能は無効になっています。リロード機能を使用するためには，リロード機能を有効にして，適用範囲を設定する必要があります。リロード機能の適用範囲は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

ejbserver.deploy.context.reload_scope
リロード機能を使用するかどうか，またリロードの対象を指定します。

app：EJBアプリケーション（EJB-JAR）とWebアプリケーション（WAR）をリロードの対象とする。

web：Webアプリケーション（WAR）だけをリロードの対象とする。

jsp：JSPだけをリロードの対象とする。

none：リロード機能を使用しない。

なお，リロード機能の有効／無効は，usrconf.propertiesのejbserver.rmi.localinvocation.scopeパラメタで指定するローカル呼び出し最適化機能の適用範囲と，リロード機能の適用範囲の組み合わせによって決まります。ローカル呼び出し最適化機能の適用範囲とリロード機能の適用範囲の対応については，マニュアル「Cosminexus　機能解説」の更新検知とリロードの概要に関する説明を参照してください。

(2)　更新検知インターバルの設定

J2EEサーバは，J2EEアプリケーションの構成ファイルを定期的に監視していて，構成ファイルが更新されると更新を検知します。J2EEアプリケーションの構成ファイルを監視して更新を検知する間隔は，更新検知インターバルとして設定します。更新検知インターバルは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

ejbserver.deploy.context.check_interval
J2EEアプリケーションの構成ファイルを監視して更新を検知する間隔（秒）を指定します。

webserver.context.check_interval
Webアプリケーションの構成ファイルを監視して更新を検知する間隔（秒）を指定します。

webserver.jsp.check_interval
JSPの構成ファイルを監視して更新を検知する間隔（秒）を指定します。

更新検知インターバルの設定値の関係を次に示します。

EJBアプリケーションの場合

ejbserver.deploy.context.check_intervalの値が使用されます。なお，ejbserver.deploy.context.check_intervalに0を指定している場合，EJBアプリケーションは更新検知されません。

サーブレットの場合

webserver.context.check_intervalまたはejbserver.deploy.context.check_intervalの値が使用されます。優先順位を次に示します。

webserver.context.check_intervalの値

ejbserver.deploy.context.check_intervalの値

なお，webserver.context.check_intervalを指定していない場合には，ejbserver.deploy.context.check_intervalの値が使用されます。

また，webserver.context.check_intervalに0を指定している場合，サーブレットは更新検知されません。

JSPの場合

webserver.jsp.check_intervalまたはejbserver.deploy.context.check_intervalの値が使用されます。優先順位を次に示します。

webserver.jsp.check_intervalの値

ejbserver.deploy.context.check_intervalの値

なお，webserver.jsp.check_intervalを指定していない場合には，ejbserver.deploy.context.check_intervalの値が使用されます。

また，webserver.jsp.check_intervalに0を指定している場合，JSPは更新検知されません。

(3)　構成ファイル更新用インターバルの設定

構成ファイルの更新を検知してから，処理中のリクエスト数の監視を実施してリロードを開始するまでの時間を構成ファイル更新用インターバルとして設定します。構成ファイル更新用インターバルは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

ejbserver.deploy.context.update.interval
J2EEアプリケーションの構成ファイルのコピーに必要な時間（秒）を指定します。

webserver.context.update.interval
Webアプリケーションの構成ファイルのコピーに必要な時間（秒）を指定します。

webserver.jsp.update.interval
JSPの構成ファイルのコピーに必要な時間（秒）を指定します。

構成ファイル更新用インターバルの設定値の関係を次に示します。

EJBアプリケーションの場合

ejbserver.deploy.context.update.intervalの値が使用されます。

サーブレットの場合

webserver.context.update.intervalまたはejbserver.deploy.context.update.intervalの値が使用されます。優先順位を次に示します。

webserver.context.update.intervalの値

ejbserver.deploy.context.update.intervalの値

webserver.context.update.intervalを指定していない場合には，ejbserver.deploy.context.update.intervalの値が使用されます。

JSPの場合

webserver.jsp.update.intervalまたはejbserver.deploy.context.update.intervalの値が使用されます。優先順位を次に示します。

webserver.jsp.update.intervalの値

ejbserver.deploy.context.update.intervalの値

webserver.jsp.update.intervalを指定していない場合には，ejbserver.deploy.context.update.intervalの値が使用されます。

(4)　リロード遅延実行の設定

Webアプリケーションをリロードする場合，リロード遅延実行を設定できます。デフォルトの設定では，構成ファイル更新用インターバルのあとに新規リクエストを実行待ちにしますが，リロード遅延実行を設定しておくと，処理中のリクエスト数が0になるか，または設定した時間になるまで新規リクエストを受け付けることができます。リロード遅延実行では，リロード遅延実行を使用するかどうか，およびリロード処理を開始するまでの時間（最大遅延時間）を設定します。リロード遅延実行は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.context.reload_delay_timeout
Webアプリケーションをリロードする場合にリロード遅延実行を使用するかどうかを指定します。また，リロード遅延実行を使用する場合に，リロード処理を開始するまでの時間を設定するときは，最大遅延時間（秒）を指定します。

(5)　セッション情報ファイル出力先の変更

Webアプリケーションをリロードする場合は，リロード実行前に生成したセッション情報を引き継いで，リロード後も継続して利用します。セッション情報は，セッション情報ファイルに出力されます。

セッション情報ファイルの出力先

セッション情報ファイルは，デフォルトでは次の場所に出力されます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名>¥web¥<コンテキストルート名>¥cjwebsession.dat

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名>/web/<コンテキストルート名>/cjwebsession.dat

Webアプリケーション単位のディレクトリ名

Webアプリケーション単位のディレクトリは，コンテキストルート名を基に規則に従ったディレクトリ名となります。コンテキストルート名にスラッシュ（/），ドル記号（$），パーセント（%），プラス記号（+）が含まれる場合は，次に示す文字に変換します。

変換前の文字 | 変換後の文字
/ | $2f
$ | $24
% | $25
+ | $2b

出力先となるコンテキストルート名のディレクトリは，Webアプリケーションの開始時に作成されます。ただし，コンテキストルートがルートコンテキストの場合は，出力先ディレクトリのコンテキストルートは「$2f」として作成されます。作成されたディレクトリは，Webアプリケーションの終了時に削除されます。

セッション情報ファイルの出力先を変更する場合には，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定します。

ejbserver.deploy.session.work.directory
Webアプリケーションのセッション情報ファイルの出力先を指定します。
ejbserver.deploy.session.work.directoryパラメタで指定したディレクトリ下に，「web¥<コンテキストルート名>」というディレクトリが作成されて，そのディレクトリ下にセッション情報ファイルが出力されます。

（例）セッション情報ファイルの出力先の設定例

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.deploy.session.work.directory</param-name>
   <param-value>C:¥tmp¥session_work</param-value>
 </param>
 ：
</configuration>

この設定例の場合，コンテキストルート名が「examples」のWebアプリケーションのセッション情報ファイルは，次の場所に出力されます。

C:¥tmp¥session_work¥web¥examples¥cjwebsession.dat

(6)　JSP事前コンパイルの設定

JSP事前コンパイルでJSPファイルから生成されたクラスファイルを更新した場合も，J2EEアプリケーションの構成ファイルの更新を検知し，リロードが実行されます。

cjstartappコマンドに-jspcオプションを指定してJSP事前コンパイルを実行する場合には，usrconf.propertiesでJSPワークディレクトリなどを設定しておく必要があります。JSP事前コンパイルの設定については，「4.2(1)　Webコンテナの機能を使用するための設定」を参照してください。

なお，アプリケーション開発時にcjjspcコマンドを使用してJSP事前コンパイルを実行する場合には，JSPワークディレクトリなどはコマンドのオプションで指定します。cjjspcコマンドを使用したJSPの事前コンパイルについては，マニュアル「Cosminexus　アプリケーション開発ガイド」のJSPファイルの事前コンパイルに関する説明を参照してください。

(7)　J2EEアプリケーション実行時間の監視の設定

構成ファイルの更新を検知した場合，処理中のリクエストの処理が完了するとリロード処理を開始しますが，処理中のリクエストの処理が完了しない場合には，J2EEアプリケーション実行時間の監視のメソッドタイムアウトおよびメソッドキャンセルを実施することで，リロード処理を開始できます。

必要に応じて，J2EEアプリケーション実行時間の監視を設定してください。J2EEアプリケーション実行時間の監視の設定については，「4.14　J2EEアプリケーション実行時間の監視の設定」を参照してください。

4.10　コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリは，Enterprise Bean，サーブレット，JSPが利用する共通のライブラリです。コンテナ拡張ライブラリを利用することで，Enterprise Bean，サーブレット，JSPから共通のライブラリを呼び出せるようになります。

この節では，コンテナ拡張ライブラリを使用するための設定について説明します。コンテナ拡張ライブラリの機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。なお，コンテナ拡張ライブラリがJNIを利用する場合は，サーバ起動・停止フック機能を使用します。サーバ起動・停止フック機能の実装については，マニュアル「Cosminexus　機能解説」を参照してください。

コンテナ拡張ライブラリを使用するためには，次の設定が必要です。

コンテナ拡張ライブラリ用のJARファイルを作成します。
コンテナ拡張ライブラリの利用については，マニュアル「Cosminexus　機能解説」を参照してください。

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

add.class.path
add.class.pathの設定値には，手順1.で作成したJARファイルのパスをJ2EEサーバのシステムクラスパスを指定します。

add.class.pathは，簡易構築定義ファイルのJ2EEサーバの拡張パラメタに設定します。

コンテナ拡張ライブラリからJNI機能を使用する場合は，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

add.library.path
add.library.pathの設定値には，JNI用ライブラリの検索パスを指定します。

ejbserver.application.InitTermProcessClasses
ejbserver.application.InitTermProcessClassesの設定値には，サーバ起動・停止フック機能のクラス名を指定します。

add.library.pathおよびejbserver.application.InitTermProcessClassesは，簡易構築定義ファイルの，J2EEサーバの拡張パラメタに設定します。

サーバ管理コマンド用のファイルのキーにコンテナ拡張ライブラリ用のJARファイルを指定します。
指定するファイルおよびキーは，OSによって異なります。

Windowsの場合
usrconf.batのUSRCONF_JVM_CLASSPATHキー

UNIXの場合
usrconfのUSRCONF_JVM_CLPATHキー

コンテナ拡張ライブラリからJNI機能を使用する場合は，サーバ管理コマンド用のファイルのキーで，JNI用ライブラリの検索パスを指定します。
複数指定する場合は，セミコロン（;）で区切ってください。
指定するファイルは，OSによって異なります（キーは共通です）。

Windowsの場合
usrconf.batのUSRCONF_JVM_LIBPATHキー

UNIXの場合
usrconfのUSRCONF_JVM_LIBPATHキー

ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

簡易構築定義ファイルおよびユーザ定義ファイルの設定例を次に示します。この例では，コンテナ拡張ライブラリのJARファイルは「extended_container.jar」で，そのコンテナ拡張ライブラリがJNIを使用して「extended_container.dll」（UNIXの場合，extended_container）を呼び出します。

Windowsの場合

簡易構築定義ファイルの設定例

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>add.class.path</param-name>
   <param-value>c:¥jar¥extended_container.jar</param-value>
   <param-name>add.library.path</param-name>
   <param-value>c:¥lib</param-value>
 </param>
 ：
</configuration>

サーバ管理コマンド用のusrconf.batの設定例

rem system classpath
set USRCONF_JVM_CLASSPATH=c:¥jar¥extended_container.jar

rem library path
set USRCONF_JVM_LIBPATH=c:¥lib

UNIXの場合

簡易構築定義ファイルの設定例

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>add.class.path</param-name>
   <param-value>/work/classes/extended_container.jar</param-value>
   <param-name>add.library.path</param-name>
   <param-value>/work/lib</param-value>
 </param>
 ：
</configuration>

サーバ管理コマンド用のusrconfの設定例

#!/bin/csh -f
# system classpath
set USRCONF_JVM_CLPATH=/work/classes/extended_container.jar

# library path
set USRCONF_JVM_LIBPATH=/work/lib

4.11　CTMによるリクエストのスケジューリングの設定

Cosminexusでは，CTMを使用してリクエストをスケジューリングすることで，特定のJ2EEアプリケーションに大量のリクエストが集中した場合に，リクエストを複数のサーバに振り分けて処理させたり，一度に処理させるリクエストの数（流量）を制御したりできます。負荷の集中による障害の発生を防止することで，システムの信頼性を確保できます。また，処理を適切に分散させることで，システムの処理性能の向上も図れます。CTMを使用したリクエストのスケジューリングについては，マニュアル「Cosminexus　機能解説」のCTMによるリクエストのスケジューリングと負荷分散に関する説明を参照してください。

この節では，CTMを使用してリクエストのスケジューリングをするための設定方法について説明します。

CTMによるリクエストのスケジューリングをするためには，次の設定が必要です。

実行環境ディレクトリの作成と環境変数の設定

簡易構築定義ファイルでの設定

サーバ管理コマンドでの設定

＜この節の構成＞

(1)　実行環境ディレクトリの作成と環境変数の設定

(2)　簡易構築定義ファイルでの設定

(3)　サーバ管理コマンドでの設定

(1)　実行環境ディレクトリの作成と環境変数の設定

CTMを使用するためには，CTMとパフォーマンストレーサの実行環境ディレクトリを作成して，環境変数に指定する必要があります。

実行環境ディレクトリの作成および環境変数については，マニュアル「Cosminexus　簡易構築・運用ガイド」のCTMを使用する場合に必要な設定に関する説明を参照してください。

(2)　簡易構築定義ファイルでの設定

CTMを使用してリクエストをスケジューリングする場合には，簡易構築定義ファイルで論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。なお，CTMの機能を使用する場合，CTMを使用する構成でシステムを構築する必要があります。CTMを使用するシステムの構成や構築手順，および簡易構築定義ファイルについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

ejbserver.ctm.ActivateTimeOut
CTMを使用するJ2EEアプリケーションのデプロイ時に，J2EEサーバがスケジュールキューを活性化するときの待ち時間を指定します。

ejbserver.ctm.DeactivateTimeOut
CTMを使用するJ2EEアプリケーションのアンデプロイ時に，J2EEサーバがスケジュールキューを非活性化するときの待ち時間（実行中のリクエストの完了待ち時間）を指定します。

ejbserver.ctm.QueueLength
CTMを使用するJ2EEアプリケーションのデプロイ時に，J2EEサーバによって生成されるCTMキューの長さを指定します。

ejbserver.client.ctm.RequestPriority
J2EEサーバからCTMに送信するリクエストの優先度を指定します。

(3)　サーバ管理コマンドでの設定

サーバ管理コマンドで設定できる内容を次に示します。サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

J2EEアプリケーション単位での設定
アプリケーション属性ファイルで次の設定ができます。

<managed-by-ctm>タグで，CTMを利用するかどうかを設定できます。

<scheduling>タグで，スケジューリングをするキューの名称や長さなどを設定できます。

<scheduling-unit>タグで，スケジュールキューの配置単位として，J2EEアプリケーション単位またはBean単位のどちらかを選択できます。

Stateless Session Bean単位での設定
SessionBean属性ファイルで次の設定ができます。

<enable-scheduling>タグで，J2EEアプリケーションに含まれるどのStateless Session Beanをスケジューリングの対象にするかを設定できます。

<stateless><pooled-instance>タグ下の<maximum>タグまたは<minimum>タグで，プールしておくインスタンス数の最大値または最小値を設定できます。なお，運用時にCTMの同時実行数を動的に変更する場合は，最大値は無制限「0」に設定する必要があります。

<scheduling>タグで，スケジューリングをするキューの名称や長さなどを設定できます。

cjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容をJ2EEアプリケーションに反映させてください。

4.12　リソース枯渇監視の設定

リソースの監視間隔やしきい値を指定してリソースを監視し，しきい値を超えた場合にアラートを出力できます。また，リソース枯渇監視情報をファイルに出力できます。

リソース監視機能を使用できるのは，J2EEサーバまたはSFOサーバです。J2EEサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプ，HTTPリクエスト実行待ちキュー，セッション数，およびコネクションプールです。SFOサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプです。なお，Windows，AIXでは，ファイルディスクリプタは監視できません。また，Linuxではスレッド数を監視できません。

リソース枯渇監視機能を使用するためには，次の二つの設定が必要です。

リソース枯渇監視機能の有効化

リソース種別ごとの監視の設定

この節では，これらのリソース枯渇監視機能を使用するための設定について説明します。

＜この節の構成＞

(1)　リソース枯渇監視機能の有効化

(2)　リソース種別ごとの監視の設定

(1)　リソース枯渇監視機能の有効化

デフォルトの設定では，リソース枯渇監視機能は有効になっているので，設定は不要です。簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内で，ejbserver.watch.enabledパラメタにtrue（リソース枯渇監視機能を有効にする）が指定されていて，すべてのリソースが監視されるようになっています。なお，リソース枯渇監視機能を無効にしたい場合には，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内で，ejbserver.watch.enabledパラメタにfalse（リソース枯渇監視機能を無効にする）を指定してください。

(2)　リソース種別ごとの監視の設定

デフォルトの設定では，監視対象となるすべてのリソースにしきい値や監視間隔の時間などが設定されています。また，監視結果のリソース枯渇監視ログファイルへの出力も有効になっています。リソース枯渇監視の設定を変更したい場合には，次の方法で設定を変更してください。

次に示すリソースについては，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内で，各リソースの監視の設定をします。

メモリ

ファイルディスクリプタ

スレッド数

スレッドダンプ

HTTPリクエスト実行待ちキュー（デフォルトの実行待ちキューの場合）

次に示すリソースについては，サーバ管理コマンドを使用して，J2EEアプリケーション単位またはリソースアダプタ単位で，各リソースの監視の設定をします。

HTTPリクエスト実行待ちキュー（Webアプリケーションごとの実行待ちキューの場合）

セッション数

コネクションプール

ただし，リソース枯渇監視ログファイルの面数とサイズは，usrconf.propertiesで指定します。

リソース種別ごとの監視の設定を次の表に示します。

表4-15　リソース種別ごとの監視の設定

リソース種別
設定個所
設定内容

メモリ
簡易構築定義ファイル
J2EEサーバ単位またはSFOサーバ単位で，メモリ監視の設定をします。
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watch.memoryから始まるパラメタで，メモリ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。※1

ファイルディスクリプタ
J2EEサーバ単位またはSFOサーバ単位で，ファイルディスクリプタ監視の設定をします。
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watch.fileDescriptorから始まるパラメタで，ファイルディスクリプタ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

スレッド数
J2EEサーバ単位またはSFOサーバ単位で，スレッド数監視の設定をします。
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watch.threadから始まるパラメタで，スレッド数監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

スレッドダンプ
J2EEサーバ単位またはSFOサーバ単位で，スレッドダンプ監視の設定をします。
論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watch.threaddumpから始まるパラメタで，スレッドダンプ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

HTTPリクエスト実行待ちキュー
簡易構築定義ファイル
J2EEサーバ単位で，デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視の設定をします。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.defaultRequestQueueから始まるパラメタで，HTTPリクエスト実行待ちキュー監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

サーバ管理コマンド
J2EEアプリケーション単位で，Webアプリケーションごとの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視の設定をします。
WAR属性ファイルの<thread-control>タグの<resource-watcher>タグ下にある<watcher-enabled>，<watcher-threshold>，<watcher-interval>，<watcher-writefile-enabled>タグで，HTTPリクエスト実行待ちキュー監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetapppropコマンドでWAR属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。

セッション数
サーバ管理コマンド
J2EEアプリケーション単位でセッション数監視の設定をします。
WAR属性ファイルの<http-session>タグの<resource-watcher>タグ下にある<watcher-enabled>，<watcher-threshold>，<watcher-interval>，<watcher-writefile-enabled>タグで，セッション数監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetapppropコマンドでWAR属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。

簡易構築定義ファイル
J2EEサーバ単位で，リソース枯渇監視ログファイルの面数，サイズを指定します。

コネクションプール
サーバ管理コマンド
リソースアダプタ単位でコネクションプール監視の設定をします。
Connector属性ファイルの<property-name>タグとして指定する<WatchEnabled>，<WatchThreshold>，<WatchInterval>，<WatchWriteFileEnabled>タグで，コネクションプール監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。
リソースアダプタをデプロイしたあとで，サーバ管理コマンドのcjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映してください。※2

簡易構築定義ファイル
J2EEサーバ単位で，リソース枯渇監視ログファイルの面数，サイズを指定します。

注※1　メモリ監視をする場合は，論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内で，JavaVM起動パラメタを定義します。JavaVM起動パラメタには，-XX:PermSizeと-XX:MaxPermSizeを指定し，メモリサイズは同じにすることをお勧めします。メモリサイズに異なる値を指定した場合，Permanent領域の領域拡張でもアラートが出力されることがあります。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:PermSize=（設定値）

-XX:MaxPermSize=（設定値）

また，フルガーベージコレクションの予兆検知をするためには，JavaVMのOld領域，New領域のサイズをチューニングする必要があります。

注※2　リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

なお，リソース枯渇監視ログファイルのファイルの面数，サイズは，簡易構築定義ファイルの次に示すパラメタで指定します。

ejbserver.logger.channels.define.<監視リソース名>WatchLogFile.filenum
リソース種別ごとにリソース枯渇監視ログファイルのファイル数を指定します。

ejbserver.logger.channels.define.<監視リソース名>WatchLogFile.filesize
リソース種別ごとにリソース枯渇監視ログファイルのファイルサイズを指定します。

これらのパラメタの監視リソース名には，リソース種別ごとのチャネル名を指定します。

メモリの場合：MemoryWatchLogFile

ファイルディスクリプタの場合：FileDescriptorWatchLogFile

スレッド数の場合：ThreadWatchLogFile

スレッドダンプの場合：ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキューの場合：RequestQueueWatchLogFile

セッション数の場合：HttpSessionWatchLogFile

コネクションプールの場合：ConnectionPoolWatchLogFile

4.13　稼働情報ファイルの取得とイベント発行の設定

稼働情報の収集機能では，J2EEサーバの稼働状態を定期的に監視して，J2EEサーバの各機能から出力されるサーバ性能やリソースの情報などの稼働情報を取得できます。J2EEサーバの各機能から出力される稼働情報を収集して，稼働情報ファイルに出力できます。また，稼働情報の監視対象にしきい値を設定しておくと，監視対象がしきい値を超えたときにイベントを発行することができます。この節では，稼働情報ファイルを取得するための設定と，イベントを発行するための設定について説明します。

稼働情報ファイルを出力する場合のデフォルトの出力先を次に示します。なお，作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定します。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/stats

デフォルトの設定では，J2EEサーバが出力した稼働情報が収集されて，稼働情報ファイルに出力されます。また，稼働情報の監視対象がしきい値を超えたときにイベントが発行されます。稼働情報ファイルの出力先や面数を変更したい場合や，稼働情報のしきい値や監視間隔を変更したい場合には，簡易構築定義ファイルで設定を変更してください。稼働情報ファイルの収集とイベントの発行に必要な設定を次の表に示します。

表4-16　稼働情報ファイルの収集とイベントの発行に必要な設定

分類 | 設定個所 | 設定内容
稼働情報収集間隔 | 簡易構築定義ファイル | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.statistics.intervalパラメタで，稼働情報を取得する間隔（秒）を指定します。
稼働情報ファイルの出力 | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.enabledパラメタで，稼働情報ファイルを出力するかどうかを指定します。デフォルトはtrueです。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.dirパラメタで，稼働情報ファイルの出力先ディレクトリを指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.numパラメタで，稼働情報ファイルの面数を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.periodパラメタで，稼働情報ファイルの面を切り替える時間間隔（時間）を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.base_timeパラメタで，稼働情報ファイルの面を切り替える基点の時間を指定します。
イベント発行（フルガーベージコレクション回数の監視） | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.enabledパラメタで，フルガーベージコレクション回数の監視を有効にするかどうかを指定します。デフォルトはtrueです。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.thresholdパラメタで，フルガーベージコレクション回数の監視でのしきい値を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.intervalパラメタで，フルガーベージコレクション回数の監視でのしきい値監視の間隔を指定します。
イベント発行（URLグループ単位の実行待ちリクエスト数の監視） | サーバ管理コマンド※ | WAR属性ファイルの<urlgroup-thread-control> - <stats-monitor> - <waiting-request-count>タグ下の<enabled>タグで，URLグループ単位の実行待ちリクエスト数の監視を有効にするかどうかを指定します。デフォルトはtrueです。
WAR属性ファイルの<urlgroup-thread-control> - <stats-monitor> - <waiting-request-count>タグ下の<high-threshold>タグで，URLグループ単位の実行待ちリクエスト数の上限しきい値を指定します。値は，実行待ちスレッド数が格納された割合（%）で指定します。
WAR属性ファイルの<urlgroup-thread-control> - <stats-monitor> - <waiting-request-count>タグ下の<low-threshold>タグで，URLグループ単位の実行待ちリクエスト数の下限しきい値を指定します。値は，実行待ちスレッド数が格納された割合（%）で指定します。

注※　cjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容を反映させます。サーバ管理コマンドの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

WAR属性ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

4.14　J2EEアプリケーション実行時間の監視の設定

J2EEアプリケーション実行時間の監視とは，EJBおよびWebアプリケーションのリクエスト実行時間を監視する機能です。この節では，J2EEアプリケーション実行時間の監視機能を使用するための設定について説明します。J2EEアプリケーション実行時間の監視機能によって，J2EEアプリケーションで無限ループなどの障害発生を検知すると，一定時間内に終了しなかったメソッド処理をタイムアウトしてユーザに通知し，さらにメソッドキャンセル機能によって使用中のトランザクションの強制決着とメソッドのキャンセルを実施できます。J2EEアプリケーション実行時間の監視を使用する場合は，次に示す設定をしてください。

J2EEサーバ単位での設定

J2EEアプリケーション単位での設定

なお，J2EEアプリケーション実行時間の監視を使用する場合には，J2EEアプリケーション開発上の注意事項があります。J2EEアプリケーション実行時間の監視機能の実装については，マニュアル「Cosminexus　機能解説」を参照してください。

＜この節の構成＞

(1)　J2EEサーバ単位での設定

(2)　J2EEアプリケーション単位での設定

(1)　J2EEサーバ単位での設定

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.ext.method_observation.intervalパラメタで，J2EEアプリケーション実行時間の監視機能を使用するかどうかを指定します。0を指定すると，J2EEアプリケーションの実行時間の監視機能が無効になります。1以上の有効値を指定すると，J2EEアプリケーションの実行時間の監視機能が有効になり，その値が次の二つの時間間隔として使用されます。

動作中のリクエスト処理がタイムアウトしていないかを調査する時間間隔

タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔

(2)　J2EEアプリケーション単位での設定

J2EEアプリケーションの属性ファイルで，メソッドタイムアウトの時間と，メソッドキャンセルのモードを設定します。サーバ管理コマンドのcjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容をJ2EEアプリケーションに反映させます。

メソッドタイムアウトの時間の設定

EJB単位での設定

SessionBean属性ファイル，EntityBean属性ファイル，またはMessageDrivenBean属性ファイルの<ejb-method-observation-timeout>タグ下の<method-observation-timeout>タグで，メソッドタイムアウトの時間を指定します。

Webアプリケーション単位での設定

サーブレット属性ファイル，またはフィルタ属性ファイルの<method-observation-timeout>タグで，サーブレット内のメソッド共通のメソッドタイムアウトの時間を指定します。

メソッドキャンセルのモードの設定
アプリケーション属性ファイルの<method-observation-recovery-mode>タグで，メソッドキャンセルのモードを指定します。

4.15　データベース監査証跡との連携の設定

データベース監査証跡連携機能とは，データベースが提供する監査証跡の機能と連携して，Cosminexusシステムの情報をデータベース監査証跡に出力するための機能です。データベース監査証跡連携機能を使用すると，J2EEアプリケーションまたはJ2EEサーバ内からデータベース上のテーブルにアクセスした際に，ルートアプリケーション情報をデータベース監査証跡の情報の一部として出力できます。出力されたルートアプリケーション情報を利用して，データベースの監査対象のテーブルにアクセスしたリクエストを特定できます。

データベース監査証跡連携機能を使用して，データベース監査証跡にCosminexusシステムの情報を出力できるデータベースについては，マニュアル「Cosminexus　機能解説」のデータベース監査証跡との連携に関する説明を参照してください。また，データベース監査証跡の詳細については，データベースのマニュアルを参照してください。

この節では，データベース監査証跡連携機能を使用するための設定について説明します。データベース監査証跡連携機能を使用するには次の設定が必要です。

データベースサーバの監査証跡機能の有効化

J2EEサーバ単位での設定

JDBCドライバのJARファイルのパスの設定

＜この節の構成＞

(1)　データベースサーバの監査証跡機能の有効化

(2)　J2EEサーバ単位での設定

(3)　データベース監査証跡機能に対応したJDBCドライバのJARファイルのパスの設定

(1)　データベースサーバの監査証跡機能の有効化

データベース監査証跡連携機能を使用するには，データベースサーバでデータベース監査証跡の機能を有効にする必要があります。データベース監査証跡の機能を設定する際には，監査対象とするテーブルや操作を検討してください。なお，Cosminexusシステムでは，Cosminexus Component Containerやそのほかの構成ソフトウェアで使用する独自のテーブルを生成しています。これらのテーブルを監査対象にするかどうかも検討してください。

データベースサーバの監査証跡の機能の設定方法については，マニュアル「HiRDB システム運用ガイド」を参照してください。

(2)　J2EEサーバ単位での設定

簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.container.audit_trail.enabledパラメタで，データベース監査証跡連携機能を使用するかどうかを指定します。プロパティを省略した場合，データベース監査証跡連携機能は無効になります。ejbserver.container.audit_trail.enabledパラメタは，J2EEサーバのJavaVMのシステムプロパティで定義します。

なお，データベース監査証跡連携機能が有効かどうかは，J2EEサーバ起動時に確認できます。データベース監査証跡連携機能が有効な場合，J2EEサーバ起動時にKDJE54000-Iのメッセージが出力され，無効な場合，メッセージは出力されません。このデータベース監査証跡連携機能の有効・無効を通知するメッセージは，J2EEサーバ起動後には出力されません。そのため，データベース監査証跡連携機能を使用する場合は，J2EEサーバ起動時にKDJE54000-Iのメッセージが出力されることを確認してください。

注意

データベース監査証跡連携機能を使用して，監査証跡にCosminexusシステムの情報を出力できるデータベース以外のデータベースと接続する場合は，この機能を使用する設定にしないでください。CosminexusからJDBCドライバに監査証跡を出力しようとする不要な処理が行われる場合があります。この場合，KDJE54000-Iのメッセージが出力されても，データベース監査証跡連携機能は使用できません。

(3)　データベース監査証跡機能に対応したJDBCドライバのJARファイルのパスの設定

データベース監査証跡連携機能を使用するには，データベース監査証跡機能に対応したJDBCドライバのJARファイルが必要です。JDBCドライバのJARファイルをJ2EEサーバのユーザクラスパスに追加します。簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，add.class.pathパラメタで指定します。add.class.pathパラメタの設定値には，JARファイルのパスを指定します。add.class.pathは，簡易構築定義ファイルの，J2EEサーバの拡張パラメタに設定します。

HiRDBと連携する場合に使用するJDBCドライバ，およびJARファイルを次に示します。

データベース
使用するJDBCドライバ
JARファイル

HiRDB
（バージョン08-02以降）
HiRDB Type4 JDBC Driver
pdjdbc2.jar

なお，(2)でデータベース監査証跡連携機能を使用する設定をした場合でも，データベース監査証跡連携機能に対応したJDBCドライバのJARファイルがJ2EEサーバのユーザクラスパスに追加されていないときは，KDJE54001-Iのメッセージが出力され，データベース監査証跡連携機能は無効になります。この場合，J2EEサーバ起動時にKDJE54000-Iは出力されません。

4.16　監査ログ出力の設定

この節では，監査ログを出力するために必要な設定について説明します。監査ログを出力する機能については，マニュアル「Cosminexus　機能解説」の監査ログを使用したシステムの監査に関する説明を参照してください。

また，ここでは，監査ログの動作に関する情報が出力される，監査ログのメッセージログ，および監査ログの例外情報の出力に関する設定についても説明します。監査ログのメッセージログ，および監査ログの例外情報の詳細については，マニュアル「Cosminexus　システム運用ガイド」のCosminexusのログの取得に関する説明を参照してください。

監査ログ，監査ログのメッセージログ，および監査ログの例外情報の出力についての設定は，製品のインストール単位に設定します。

なお，監査ログの格納場所を変更したい場合は，それぞれのログの設定をする前に，次の環境変数をシステム環境変数に設定しておいてください。

COSMINEXUS_AUDITLOG_CONF=”<監査ログ定義ファイルの格納場所のパス>”

また，監査ログを出力する場合は，この節で説明している手順を必ず実施してください。この節で説明している手順を実施しなかった場合，監査ログ定義ファイルに設定した，出力ディレクトリや監査ログファイルに対するアクセス権が適用されません。監査ログ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」の監査ログ定義ファイルの説明を参照してください。それぞれのログの設定手順を次に示します。

監査ログ定義ファイルを編集します。
監査ログ，監査ログのメッセージログ，および監査ログの例外情報について，出力の有無やそれぞれのログの出力先などを，監査ログ定義ファイルのプロパティに設定します。
監査ログ定義ファイルに設定できるプロパティの詳細は，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

監査ログセットアップコマンド（auditsetupコマンド）を実行します。
監査ログセットアップコマンドを実行すると，監査ログ，監査ログのメッセージログ，および監査ログの例外情報に必要なアクセス権限が自動で設定されます。監査ログセットアップコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。
監査ログセットアップコマンドの実行例を次に示します。

Windowsの場合

C:¥Program Files¥Hitachi¥Cosminexus¥common¥bin¥auditsetup.exe

UNIXの場合

/opt/Cosminexus/common/bin/auditsetup

5.　トラブルシューティングの資料取得の設定（J2EEアプリケーションを実行するシステム）

この章では，トラブルシューティングの資料を取得するための設定方法について説明します。トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。

＜この章の構成＞

5.1　資料取得の設定の概要

5.2　snapshotログ収集の設定

5.3　障害検知時コマンドによる資料取得の設定

5.4　Management Serverのログ取得の設定

5.5　性能解析トレースファイル収集の設定

5.6　J2EEサーバのログ取得の設定

5.7　SFOサーバのログ取得の設定

5.8　Webサーバのログ取得の設定

5.9　リダイレクタのログ取得の設定

5.10　インプロセスHTTPサーバのログ取得の設定

5.11　Cosminexus Managerのログ取得の設定

5.12　コンソールログの取得の設定

5.13　リソースアダプタのログ取得の設定

5.14　Cosminexus TPBrokerのログ取得の設定

5.15　Cosminexus DABroker Libraryのログ取得の設定

5.16　OSの統計情報取得の設定

5.17　ユーザダンプ取得の設定

5.18　coreダンプ取得の設定

5.19　JavaVMの資料取得の設定

5.20　アプリケーションのユーザログ出力の設定

5.1　資料取得の設定の概要

トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログなどは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。この節では，トラブルシューティングに必要な資料と，その概要について説明します。

また，デフォルトの設定で取得できるようになっている資料については，特に設定は不要ですが，ログの出力先やサイズなどを変更したい場合には，簡易構築定義ファイルやユーザ定義ファイルを編集して，設定を変更してください。

トラブルシューティングの資料取得のための設定を次の表に示します。

表5-1　トラブルシューティングの資料取得のための設定

資料の種類
資料取得のための設定
設定の要否
設定方法の参照先

snapshotログ
snapshotログの収集先，収集方法や収集のタイミングを変更する場合には，ユーザ定義ファイルを編集します。
△
5.2，5.3

Management Serverのログ
mserver.properties（Management Server環境設定ファイル）で，ログの出力レベルや，ログファイルの面数などを設定します。
△
5.4

性能解析トレースファイル
mserver.properties（Management Server環境設定ファイル）で，性能解析トレースファイルの面数を設定します。
また，簡易構築定義ファイルで，論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に，パフォーマンストレーサのトレース取得レベルや，PFRトレースファイルの面数などを指定します。
△
5.5

J2EEサーバのログ
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数などを設定します。
また，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledで，システムログ出力の設定が有効になっている場合，J2EEサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合，syslog）に出力されます。
△
5.6

SFOサーバのログ
簡易構築定義ファイルで，論理SFOサーバ（sfo-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数などを設定します。
△
5.7

Webサーバのログ
簡易構築定義ファイルで，論理Webサーバ（web-server）の<configuration>タグ内に，Webサーバのログの出力レベル，出力先などを設定します。
△
5.8

リダイレクタのログ
簡易構築定義ファイルで，論理Webサーバ（web-server）の<configuration>タグ内に，リダイレクタのログの出力レベル，サイズ，面数などを設定します。
また，mod_jk.confにログファイル名のプリフィックスを指定します。
△
5.9

アプリケーションのユーザログ
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ロガーやハンドラの設定，ログの出力レベル，サイズ，面数などを設定します。また，server.policyで，セキュリティポリシーを設定します。
○
5.20

インプロセスHTTPサーバのログ
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，インプロセスHTTPサーバのログ出力の有無，ファイル面数などを設定します。また，アクセスログは，フォーマットを定義することで，出力形式をカスタマイズできます。
インプロセスHTTPサーバのアクセスログのカスタマイズについては，「8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ」を参照してください。
△
5.10

稼働情報ファイル
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，稼働情報ファイルの出力先や面数などを設定します。
△
4.13

Cosminexus Managerのログ
manager.cfgで統合ログの面数やサイズを指定します。
△
5.11

コンソールログ
adminagent.propertiesでコンソールログの出力の有無，面数やサイズを設定します。
△
5.12

リソースアダプタのログ
サーバ管理コマンドを使用して，リソースアダプタ単位でのログ出力の有無を設定します。
また，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数を設定します。
△
5.13

Cosminexus TPBrokerのトレースファイル
簡易構築定義ファイル（論理J2EEサーバ（j2ee-server）の<configuration>タグ内），サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，トレースファイルの出力先や面数などを設定します。
△
5.14

Cosminexus DABroker Libraryのログ
環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルで，ログファイルサイズなどを設定します。
△
5.15

OSの統計情報
Windowsの場合，Windowsのシステムモニタでシステムリソースのパフォーマンスデータ取得の設定をします。
○
5.16

ユーザダンプ
Windowsの場合，ワトソン博士で，ユーザダンプ取得の設定をします。
○
5.17

coreダンプ
UNIXの場合，簡易構築定義ファイルやシェルコマンドで，coreファイル取得の設定をします。
○
5.18

JavaVMの資料
簡易構築定義ファイルで，JavaVMのスレッドダンプや日立固有のJavaVMログ（日立JavaVMログファイル）の出力方法や出力内容などの設定をします。
○
5.19

サーバ管理コマンドのログ
サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，ログの出力レベルなどを設定できます。
△
9.2.2(3)

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

この表に示したログは，snapshotログで一括収集できます。ただし，Cosminexus TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。また，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）については，固定のファイル名に対して収集します。障害発生時に収集するためには，ユーザ作成の障害検知時コマンドを利用する必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

5.2　snapshotログ収集の設定

システムの構成ソフトウェアがトラブル発生時にそのときの状態を出力したログを，snapshotログといいます。snapshotログには，各種構成ソフトウェアのログのほかに，スレッドダンプ，性能解析トレースなど，システム保守に必要な情報とアプリケーション保守に必要な情報が含まれます。Cosminexusで構築したシステムでは，これらの情報をsnapshotログとして一括収集し，ZIP形式のログファイルとして取得できます。

なお，snapshotlogコマンドで収集できるsnapshotログと，Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログでは，デフォルトの状態で収集できるファイルが異なります。Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログは，デフォルトの状態でインストール情報やOSの状態・ログなどを収集できますが，snapshotlogコマンドでインストール情報やOSの状態・ログなどを収集するためには，コマンド実行時に指定するsnapshotログ収集先対象リストファイルを編集して，snapshotログの収集先を追加する必要があります。

この節では，snapshotログ収集のための設定について説明します。snapshotログの収集対象一覧については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。また，snapshotログ収集の設定で使用するコマンドやファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この節の構成＞

(1)　snapshotログの収集のタイミング

(2)　snapshotログで収集できるファイル

(3)　snapshotログの収集先のカスタマイズ

(1)　snapshotログの収集のタイミング

snapshotログの収集のタイミングと取得のための設定を次の表に示します。

表5-2　snapshotログの収集のタイミングと取得のための設定

分類
収集のタイミング
デフォルトの設定を変更するために必要な設定

自動的に収集する※
論理サーバが障害時に自動停止される直前

障害検知時コマンドの設定

snapshotログの収集先のカスタマイズ

J2EEサーバが障害時に自動再起動される直前

J2EEサーバを手動で一括再起動する直前

snapshotログの収集先のカスタマイズ

任意のタイミングで収集する
Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき

注※　論理サーバの停止前，またはJ2EEサーバの再起動前のどちらのタイミングでsnapshotログを収集するかは，mserver.propertiesのcom.cosminexus.mngsvr.snapshot.collect.pointキーで変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

(a)　自動的に収集する場合

次に示すどちらかのタイミングでsnapshotログを自動的に収集する場合には，Management Serverによって障害検知時コマンドが実行されて，スレッドダンプと性能解析トレースなどの資料が取得されます。

論理サーバが障害時に自動停止される直前（デフォルトの設定）

J2EEサーバが障害時に自動再起動される直前

障害検知時コマンドで取得された資料は，snapshotログとして収集できます。障害検知時コマンドの動作や設定の変更については，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

(b)　任意のタイミングで収集する場合

任意のタイミングでsnapshotログを収集する場合には，スレッドダンプファイルやユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）が出力されているときだけ，snapshotログとして収集できます。任意のタイミングでsnapshotログを収集する際に，コマンドが実行されてスレッドダンプファイルやユーザダンプまたはcoreダンプが出力されることはありません。

Management Serverの運用管理コマンド（mngsvrutil）を実行して任意のタイミングでsnapshotログを収集する場合は，コマンド実行時に収集先の種別（種別1，種別2）を指定して収集できます。それ以外のタイミングでは，種別1と種別2それぞれの収集対象として定義されているファイルがすべて収集されます。

(2)　snapshotログで収集できるファイル

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料と二次送付資料に分類されます。snapshotログでは，一次送付資料と二次送付資料を収集できます。

一次送付資料
メールの添付資料として送付できるファイルサイズの資料が該当します。メールなどで早急に保守員に送付できます。
一次送付資料としてどのファイルを収集するかは，一次送付資料用のsnapshotログ収集先対象リストファイル（snapshotlog.conf）で指定します。mngsvrutilコマンドで引数snapshot 1を指定してsnapshotログを収集する場合は，snapshotlog.confに指定されているファイルが収集されます。

二次送付資料
一次送付資料に加えて，ファイルサイズが比較的大きい資料が該当します。ファイルサイズが比較的大きい資料は資料の送付に時間が掛かるため，別途，保守員に送付する必要があります。
二次送付資料としてどのファイルを収集するかは，二次送付資料用のsnapshotログ収集先対象リストファイル（snapshotlog.2.conf）で指定します。mngsvrutilコマンドで引数snapshot 2を指定してsnapshotログを収集する場合は，snapshotlog.confとsnapshotlog.2.confに指定されているファイルが収集されます。

snapshotlog.confおよびsnapshotlog.2.confの指定については，「(3)　snapshotログの収集先のカスタマイズ」を参照してください。

デフォルトの設定で一次送付資料および二次送付資料として収集できる資料を次の表に示します。

表5-3　デフォルトの設定で一次送付資料および二次送付資料として収集できる資料

資料の種類 | 一次送付資料 | 二次送付資料
メッセージログ | ○ | ○
ユーザログ | ○ | ○
例外ログ | ○ | ○
保守用ログ | ○ | ○
性能解析トレース | － | ○※1
JavaVMのスレッドダンプ | ○※1 | ○※1
JavaVMのガーベージコレクションのログ | ○ | ○
メモリダンプ | － | ○
JavaVMログファイル | ○ | ○
エラーリポートファイル | ○ | ○
OSの状態・ログ | ○ | ○
OSの統計情報 | ○ | ○
定義情報 | ○ | ○
作業ディレクトリ | ○ | ○
リソースの設定 | －※2 | ○
Webサーバのログ | ○ | ○
JavaVMのスタックトレース情報 | ○※1 ※3 | ○※1 ※3
稼働情報 | ○ | ○
監査ログ | － | ○

（凡例）

○：収集できる。　－：収集できない。

注

Cosminexusの各構成ソフトウェアが出力するメッセージログや保守用ログは，snapshotログのデフォルトの設定では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリだけが収集対象となっています。構成ソフトウェアのログの出力先を変更している場合には，収集先も変更してください。

注※1

システム提供の障害検知時コマンドによって取得されたものが，snapshotログとして収集されます。システム提供の障害検知時コマンドについては，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

注※2

デフォルトの設定では，snapshotlog.confには収集先のパスが記述されていますが，コメントが付いているため収集対象外となっています。コメントを外すと収集できます。

注※3

UNIXの場合だけ取得できる資料です。

デフォルトでsnapshotログの収集先として定義されていないファイルをsnapshotログとして収集したい場合には，そのファイルの出力先をsnapshotログ収集先対象リストファイルに追加してください。また，資料によっては，次のような設定も必要になります。

運用開始前の資料取得のための設定
運用開始前に，資料取得のための設定をしておく必要があります。

コマンドなどによる資料の取得
snapshotログとして収集する前に，コマンドを実行して収集対象の資料を取得しておく必要があります。資料の取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

（例）

ユーザダンプまたはcoreダンプは，運用開始前にワトソン博士の設定またはcoreファイルのサイズの設定が必要です。運用開始前に取得のための設定をした上で，ユーザ作成の障害検知時コマンドを使用して障害発生時のユーザダンプまたはcoreダンプを取得し，そのユーザダンプまたはcoreダンプをsnapshotログとして収集することをお勧めします。

また，デフォルトのsnapshotログ収集先対象リストファイルには，ユーザダンプまたはcoreダンプのデフォルトの出力先が指定されています。ワトソン博士を設定した場合やOSをCドライブ以外に設定した場合にはsnapshotログの収集先を変更する必要があります。

運用開始前に実施する取得のための設定については，「5.17　ユーザダンプ取得の設定」，または「5.18　coreダンプ取得の設定」を参照してください。ユーザ作成の障害検知時コマンドについては，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

(3)　snapshotログの収集先のカスタマイズ

snapshotログの収集先は，snapshotログ収集先対象リストファイルでカスタマイズできます。また，adminagent.propertiesでは，論理サーバごとのsnapshotログのファイル数を指定できます。ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　snapshotログの収集先の指定

snapshotログ収集先対象リストファイルを編集して，snapshotログの収集先を指定してください。snapshotログ収集先対象リストファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.conf
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.2.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.conf
/opt/Cosminexus/manager/config/snapshotlog.2.conf

snapshotlog.confでは，一次送付資料として収集するファイルの格納ディレクトリを指定します。また，snapshotlog.2.confでは，二次送付資料として収集するファイルの格納ディレクトリを指定します。

なお，このリストファイルでは変数を使用できます。例えば，Cosminexusのインストールディレクトリを表す変数「${cosminexus.home}」を使用して，リストファイルに「${cosminexus.home}/manager/log/.+」（ピリオド（.）は任意の文字，プラス（+）は1回以上を表します）と指定すると，<Cosminexusのインストールディレクトリ>¥manager¥log（Windowsの場合），または/opt/Cosminexus/manager/logディレクトリ（UNIXの場合）直下のファイルがすべて収集されます。なお，リストファイルの変数の値には，ドル記号（$）を含めないでください。

(b)　snapshotログのファイル数の指定

adminagent.propertiesでは，論理サーバごとのsnapshotログファイルの数を指定できます。

adminagent.snapshotlog.num_snapshots
一次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

adminagent.snapshotlog.listfile.2.num_snapshots
二次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。

5.3　障害検知時コマンドによる資料取得の設定

障害検知時コマンドは，Management Serverで管理している論理サーバにトラブルが発生した場合に，システムによって実行されるコマンドです。この節では，トラブルシューティングの資料を障害検知時コマンドで取得するための設定について説明します。障害検知時コマンドを利用して，トラブル発生時のスレッドダンプやユーザダンプの取得などの処理を実行することで，トラブル発生時のタイムリーな資料を取得できるようになります。また，障害検知時コマンドを利用している場合，次のどちらかのタイミングでsnapshotログを自動収集することもできます。

論理サーバにトラブルが発生した場合，障害検知時コマンドが実行されて，論理サーバの停止前にsnapshotログが収集されます。

J2EEサーバにトラブルが発生した場合，障害検知時コマンドが実行されて，J2EEサーバの再起動前にsnapshotログが収集されます。

なお，障害検知時コマンドで取得した資料はsnapshotログとして収集できます。

障害検知時コマンドには，システムで提供しているコマンドとユーザが作成したコマンドの2種類があります。障害検知時コマンドの種類を次の表に示します。

表5-4　障害検知時コマンドの種類

コマンドの種類
コマンドの動作
コマンドを利用するための設定

システム提供の障害検知時コマンド
論理サーバにトラブルが発生したときに，トラブルが発生した論理サーバのスレッドダンプや性能解析トレースなどを取得できます。
ただし，J2EEサーバまたはSFOサーバのプロセスが存在しない場合は，スレッドダンプを取得できません。また，パフォーマンストレーサのプロセスが存在しない場合は，性能解析トレースを取得できません。

Management Serverでの環境設定（(1)参照）

運用管理エージェントでの環境設定（(2)参照）

ユーザ作成の障害検知時コマンド
論理サーバにトラブルが発生したときに，任意の処理を記述したコマンドファイルを実行できます。
例えば，コマンドファイルにdrwtsn32コマンドまたはkillコマンドの実行を記述しておくことで，J2EEサーバにトラブルが発生したときに，ユーザダンプまたはcoreダンプを取得できます。

Management Serverでの環境設定（(1)参照）

運用管理エージェントでの環境設定（(2)参照）

ユーザ作成の障害検知時コマンドのコマンドファイル作成（(3)参照）

デフォルトの設定では，論理サーバにトラブルが発生した場合にシステム提供の障害検知時コマンドが実行されて，スレッドダンプや性能解析トレースなどが取得されます。また，トラブルが発生した論理サーバの停止前にsnapshotログが収集されます。

システム提供の障害検知時コマンドで取得できる情報について，次の表に示します。

表5-5　システム提供の障害検知時コマンドで取得できる情報

論理サーバ
OS
取得できる情報

プロセスダウンを検出した場合
ハングアップを検出した場合

論理パフォーマンストレーサ
Windows
UNIX

バッファの内容を出力したPRFトレースファイル

－

論理J2EEサーバ
Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

論理SFOサーバ
Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

論理Webサーバ
Windows
UNIX

性能解析トレースファイル

内部トレース

性能解析トレースファイル

ほかの論理サーバ
Windows
UNIX

性能解析トレースファイル

性能解析トレースファイル

システム提供の障害検知時コマンドの動作設定を変更する場合，またはユーザ作成の障害検知時コマンドを利用する場合に必要な設定について，(1)～(3)で説明します。

注意

ユーザ作成の障害検知時コマンドで取得した資料をsnapshotログとして収集するためには，その資料の取得先をsnapshotログの収集先に追加する必要があります。snapshotログの収集先の追加については，「5.2(3)　snapshotログの収集先のカスタマイズ」を参照してください。

＜この節の構成＞

(1)　Management Serverでの環境設定

(2)　運用管理エージェントでの環境設定

(3)　ユーザ作成の障害検知時コマンドのコマンドファイル作成

(1)　Management Serverでの環境設定

mserver.properties（Management Server環境設定ファイル）で，障害検知時コマンドの動作を設定します。

次のキーで，障害検知時コマンドの動作を設定します。

キー
説明
設定の要否

システム
ユーザ

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled
システム提供の障害検知時コマンドを利用するかどうかを指定します。デフォルトは，true（利用する）です。
△
－

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled
ユーザ作成の障害検知時コマンドを利用するかどうかを指定します。デフォルトは，false（利用しない）です。
－
○

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout
システム提供の障害検知時コマンドの終了を待つ時間を指定します。指定時間を経過してもコマンドが終了しない場合は，ユーザ回復処理を続行します。
△
－

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout
ユーザ作成の障害検知時コマンドの終了を待つ時間を指定します。
－
△

com.cosminexus.mngsvr.snapshot.auto_collect.enabled
障害発生時，または一括再起動時にsnapshotログを取得するかどうかを指定します。デフォルトは，true（snapshotログを取得する）です。
△
△

com.cosminexus.mngsvr.snapshot.collect.point
snapshotログの収集タイミングとして，次のどちらかを指定します。

論理サーバの停止前

J2EEサーバの再起動前

デフォルトは，論理サーバの停止前です。
△
△

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す。

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す。

○：設定は必要。

△：デフォルトの設定を変更する場合だけ必要。

－：設定は不要。

(2)　運用管理エージェントでの環境設定

adminagent.properties（運用管理エージェントプロパティファイル）で，障害検知時コマンドで取得する資料を設定します。

adminagent.propertiesの次のキーで，障害検知時コマンドで取得する資料の数や取得の有無，障害検知時コマンドのパスなどを設定します。なお，snapshotログの収集先を定義するためのリストファイルについては，「5.2(3)　snapshotログの収集先のカスタマイズ」を参照してください。

キー | 説明 | 設定の要否
システム | ユーザ
adminagent.snapshotlog.num_snapshots | 一次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。 | △ | △
adminagent.snapshotlog.listfile.2.num_snapshots | 二次送付資料として収集する，論理サーバごとのsnapshotログファイルの数を指定します。 | △ | △
adminagent.j2ee.sys_cmd.abnormal_end.threaddump | システム提供の障害検知時コマンドで，スレッドダンプを取得するかどうかを指定します。 | △ | －
adminagent.sys_cmd.abnormal_end.prftrace | システム提供の障害検知時コマンドで，性能解析トレースファイルを取得するかどうかを指定します。 | △ | －
adminagent.<論理サーバの種類>.usr_cmd.abnormal_end | 論理サーバの種類ごとに，実行する障害検知時コマンドのパスを指定します。 | ○ | ○

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す。

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す。

○：設定は必要。

△：デフォルトの設定を変更する場合だけ必要。

－：設定は不要。

(3)　ユーザ作成の障害検知時コマンドのコマンドファイル作成

ユーザ作成の障害検知時コマンドは，コマンドファイル（バッチファイルまたはシェルスクリプトファイル）に記述できます。このとき，次の表に示す環境変数をコマンドファイルに記述しておくことで，障害の発生した論理サーバの情報や障害に関する情報を利用してコマンドを実行できます。

表5-6　ユーザ作成の障害検知時コマンドのコマンドファイルに記述できる環境変数

環境変数 | 説明
COSMI_MNG_LSNAME | 障害の発生した論理サーバの論理サーバ名。なお，論理CTM内のネーミングサービスで障害が発生した場合は，論理CTMの論理サーバ名が設定されます。
COSMI_MNG_RSNAME | 障害の発生した論理サーバの実サーバ名。J2EEサーバまたはSFOサーバ以外の論理サーバの場合，論理サーバ名が設定されます。
COSMI_MNG_LSPID | 論理サーバのプロセスID。
COSMI_MNG_LSARGS | 論理サーバを起動したときのコマンドライン。
COSMI_MNG_TIME_SUSPENDED | ハングアップを検知した時刻。万国標準時（UTC）の1970年1月1日午前0時からの経過時間（単位：ms）。なお，無応答を検知しない場合，値は設定されません。
COSMI_MNG_TIME_TERMINATED | 異常停止（プロセスダウン）を検知した時刻。万国標準時（UTC）の1970年1月1日午前0時からの経過時間（単位：ms）。なお，ハングアップの場合，値は設定されません。
COSMI_MNG_WEB_SYSTEM | 障害が発生した論理サーバが所属するWebシステム。Smart Composer機能を使用しない場合，値は設定不要です。
COSMI_MNG_TIER | 障害が発生した論理サーバが所属する物理ティア。Smart Composer機能を使用しない場合，値は設定不要です。
COSMI_MNG_UNIT | 障害が発生した論理サーバが所属するサービスユニット。Smart Composer機能を使用しない場合，値は設定不要です。
COSMI_MNG_HWS | Hitachi Web Serverのインストールディレクトリ。

なお，障害検知コマンドとして実行するコマンドから出力される標準出力，標準エラー出力は，Management Serverでは取得しません。このため，コマンドの標準出力，標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

(a)　コマンドファイルの例

J2EEサーバの障害発生時にdrwtsn32コマンドまたはkillコマンドを実行してユーザダンプまたはcoreダンプを取得する場合の例を次に示します。

ユーザダンプの取得の例（Windowsの場合）

rem 障害がプロセスダウンかハングアップかを，プロセスダウンを検知した時刻から判断する。
if defined COSMI_MNG_TIME_TERMINATED goto END

rem 障害がハングアップであるため，ユーザダンプを取得する。
"C:¥WINDOWS¥system32¥drwtsn32.exe" -p %COSMI_MNG_LSPID%

:END

coreダンプの取得の例（UNIXの場合）

#!/bin/sh

# 障害がプロセスダウンかハングアップかを，プロセスダウンを検知した時刻から判断する。
if [ "$COSMI_MNG_TIME_TERMINATED" = "" ] ; then

# 障害がハングアップであるため，coreダンプを取得する。
/bin/kill -6 $COSMI_MNG_LSPID
fi

(b)　ユーザ作成の障害検知時コマンドの動作

論理CTMでは，グローバルCORBAネーミングサービスとCTMデーモンの二つのプロセスが起動，停止，監視されます。そのため，論理CTM内のグローバルCORBAネーミングサービスの障害を検知した場合とCTMデーモンの障害を検知した場合とでは，実行するコマンドが異なります。

グローバルCORBAネーミングサービスの障害を検出した場合
adminagent.naming.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。

CTMデーモンの障害を検出した場合
adminagent.ctm.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。

また，論理CTM内の二つのプロセス（CTMデーモン，グローバルCORBAネーミングサービス）のどちらのプロセスで障害を検知しても，Management Serverのログには，論理サーバ（CTM）の障害検知時コマンドの開始を通知するログが出力されます。

5.4　Management Serverのログ取得の設定

この節では，Management Serverが出力するログを取得するための設定について説明します。

Management Serverのログの出力先ディレクトリを次に示します。Management Serverの出力先は固定で，変更できません。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥log

UNIXの場合
/opt/Cosminexus/manager/log

Management Serverのログの出力レベルや，ログファイルの面数などを変更する場合は，mserver.properties（Management Server環境設定ファイル）で，次のキーを指定します。

com.cosminexus.mngsvr.log.level
Management Serverのログの出力レベルを指定します。

com.cosminexus.mngsvr.log.rotate
Management Serverのログのファイル面数を指定します。

com.cosminexus.mngsvr.log.size
Management Serverのログのファイルサイズを指定します。

mserver.propertiesおよび各キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

5.5　性能解析トレースファイル収集の設定

WebクライアントまたはEJBクライアントからのリクエストを処理するときにCosminexusシステムの各機能がバッファに出力するトレース情報は，一定量たまるとバイナリ形式のPRFトレースファイルに出力されます。Management Serverでは，mngsvrutilコマンドを使用して，PRFトレースファイルやバッファにたまったトレース情報からCSV形式のテキストファイル（性能解析トレースファイル）を出力し，そのファイルをZIP形式に圧縮して，Management Serverが稼働するホスト（運用管理サーバ）に収集します。この節では，性能解析トレースファイルを収集するための設定について説明します。性能解析トレースの概要については，マニュアル「Cosminexus　機能解説」を参照してください。

性能解析トレースファイルの設定
Management Serverが収集する性能解析トレースファイルのファイル面数を変更する場合は，mserver.properties（Management Server環境設定ファイル）のcom.cosminexus.mngsvr.traceキーで設定します。
mserver.propertiesおよび各キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

PRFトレースの設定
Cosminexusシステムの各機能（Webサーバ，J2EEサーバ，CTMなどの機能レイヤ）がバッファに出力するPRFトレースの取得レベルや，パフォーマンストレーサが出力するPRFトレースファイルの面数などを簡易構築定義ファイルで設定します。
論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に，次のバラメタを指定します。

PrfTraceLevel
パフォーマンストレーサのトレース取得レベルを指定します。

PrfTraceCount
パフォーマンストレーサのファイル面数を指定します。

PrfTraceFileSize
パフォーマンストレーサのファイルサイズを指定します。PrfTraceFileSize≧PrfTraceBufferSizeの関係が成り立つ値を設定してください。

PrfTraceBufferSize
パフォーマンストレーサのバッファサイズを指定します。PrfTraceFileSize≧PrfTraceBufferSizeの関係が成り立つ値を設定してください。

簡易構築定義ファイルおよび各パラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

なお，性能解析トレースファイルの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

5.6　J2EEサーバのログ取得の設定

この節では，J2EEサーバのログ取得で設定できる項目について説明します。

J2EEサーバのログは，ログの出力先，ログサイズ，ログレベルを変更できます。変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表5-7　J2EEサーバのログ取得の設定項目

項目
対応する簡易構築定義ファイルのパラメタ

ログの出力先
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory

ログサイズ

ログファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filenum

ログファイル1面当たりの最大サイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filesize

ログレベル
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.enabled.*

なお，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledパラメタでtrue（デフォルト値）を指定した場合，またはこのパラメタの指定を省略した場合は，J2EEサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合は，syslog）に出力されます。

注意事項（UNIXの場合）

J2EEサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。また，syslogのログ出力先およびログファイル名は，syslogの設定に依存します。

syslogおよびsyslogの設定に関する詳細については，OS付属のマニュアルで，syslogdまたはsyslog.confの説明を参照してください。

簡易構築定義ファイルおよびパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

＜この節の構成＞

(1)　ログの出力先の変更

(2)　ログサイズの変更

(3)　ログレベルの変更

(1)　ログの出力先の変更

J2EEサーバのログの出力先を変更する場合は，簡易構築定義ファイルでログの出力先ディレクトリを指定します。

ログの出力先の変更

デフォルトのログ出力先を次に示します。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名>¥logs

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名>/logs

なお，作業ディレクトリのデフォルトは，<Cosminexusのインストールディレクトリ>¥CC¥server¥public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

作業ディレクトリおよびJ2EEサーバのログの出力先は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定すると変更できます。

ejb.public.directory
J2EEサーバの作業ディレクトリのパスを指定します。

ejb.server.log.directory
J2EEサーバのログの出力先ディレクトリを指定します。

設定例（物理ティアの定義の場合）

Windowsの場合

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejb.server.log.directory</param-name>
   <param-value>C:¥CClogs¥server¥MyServer</param-value>
 </param>
 ：
</configuration>

UNIXの場合

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejb.server.log.directory</param-name>
   <param-value>/CClogs/server/MyServer</param-value>
 </param>
 ：
</configuration>

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリを次に示します。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

注意事項

ログの出力先を変更した場合は，J2EEサーバを起動する前に，変更後のログの出力先ディレクトリを作成しておいてください。
変更後のログの出力先ディレクトリがない場合は，J2EEサーバの起動時にKDJE40024-Eのメッセージが出力されて異常終了します。また，サーバ管理コマンドの実行時にKDJE37209-E，KDJE37210-E，KDJE37211-Eのメッセージが出力されて異常終了します。

同一ホスト内で複数のJ2EEサーバを起動させている場合は，ログ出力先が同じディレクトリにならないように，ディレクトリにサーバ名称を含めるなど，サーバごとにユニークなディレクトリ名になるようにしてください。なお，パラメタの値に同じディレクトリを指定した場合は，動作の保証はしません。

ログの出力先を変更して作業ディレクトリ以外にログを出力する場合，ログファイルはサーバのアンセットアップ時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

簡易構築定義ファイルでログの出力先を設定していても，JavaVM起動パラメタでJavaVMの保守情報およびガーベージコレクションのログ出力先が設定されていると，JavaVM起動パラメタの設定が優先されますので，注意してください。
JavaVM起動パラメタは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

XX:HitachiJavaLog:<JavaVMの保守情報およびガーベージコレクションのログ出力先>

JavaVM起動パラメタを指定している場合は，JavaVMの保守情報およびガーベージコレクションのログ出力先に設定したディレクトリに，JavaVMの保守情報およびガーベージコレクションのログファイルが出力されます。

ログ出力先には，UNC名を含むパスは指定できません。

(2)　ログサイズの変更

J2EEサーバのログサイズを変更する場合は，簡易構築定義ファイルで，ログファイルの面数，およびログファイル1面当たりの最大サイズを設定します。

ログファイル面数の変更

J2EEサーバのログファイルの面数は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filenumパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.channels.define.MessageLogFile.filenum</param-name>
   <param-value>3</param-value>
 </param>
 ：
</configuration>

ログファイル1面当たりの最大サイズの変更

J2EEサーバのログファイル1面当たりの最大サイズ（単位：バイト）は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filesizeパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.channels.define.MessageLogFile.filesize</param-name>
   <param-value>2097152</param-value>
 </param>
 ：
</configuration>

(3)　ログレベルの変更

J2EEサーバのログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。

ログレベルは，簡易構築定義ファイルの論理J2EEサーバの<configuration>タグ内に，ejbserver.logger.enabled.*パラメタで設定します。ejbserver.logger.enabled.*の<param-value>タグにはレベル名を，「Error」，「Warning」，「Information」，「Debug」の文字列で一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

設定例（物理ティアの定義の場合）

1.

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.enabled.*</param-name>
   <param-value>Error</param-value>
 </param>
 ：
</configuration>

2.

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.enabled.*</param-name>
   <param-value>Error,Warning</param-value>
 </param>
 ：
</configuration>

3.

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.enabled.*</param-name>
   <param-value>Error,Warning,Information</param-value>
 </param>
 ：
</configuration>

4.

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.logger.enabled.*</param-name>
   <param-value>Error,Warning,Information,Debug</param-value>
 </param>
 ：
</configuration>

注意事項

記述例の1.，2.，3.，4.の順に，取得できるログの件数が増加していきます。複数のログレベルを設定してログを取得すると，性能が劣化し，ログファイルの面の切り替えが頻繁に起こるようになります。

レベル名に「Error」，「Warning」，「Information」，「Debug」以外の文字列，または空の値を設定した場合は，KDJE90009-Wのメッセージが出力されます。Errorレベルのログは取得されます。

ログレベルの推奨設定

ログレベルの推奨設定を次に示します。

通常運用時
レベル名に「Error」を指定します。

通常運用時（verbose）
通常運用時よりも詳細な情報を取得する場合には，レベル名に「Error,Warning」を指定します。

テスト時
レベル名に「Error,Warning,Information」を指定します。

障害調査時
レベル名に「Error,Warning,Information,Debug」を指定します。

5.7　SFOサーバのログ取得の設定

この節では，SFOサーバのログ取得で設定できる項目について説明します。

SFOサーバのログは，ログサイズ，ログレベルを変更できます。変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表5-8　SFOサーバのログ取得の設定項目

項目
対応する簡易構築定義ファイルのパラメタ

ログサイズ

ログファイル面数

論理SFOサーバ（sfo-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filenum

ログファイル1面当たりの最大サイズ

論理SFOサーバ（sfo-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filesize

ログレベル
論理SFOサーバ（sfo-server）の<configuration>タグ内のejbserver.logger.enabled.*

なお，論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledパラメタでtrue（デフォルト値）を指定した場合，またはこのパラメタの指定を省略した場合は，SFOサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合は，syslog）に出力されます。

注意事項（UNIXの場合）

SFOサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。また，syslogのログ出力先およびログファイル名は，syslogの設定に依存します。

syslogおよびsyslogの設定に関する詳細については，OS付属のマニュアルで，syslogdまたはsyslog.confの説明を参照してください。

簡易構築定義ファイルおよびパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

＜この節の構成＞

(1)　ログサイズの変更

(2)　ログレベルの変更

(1)　ログサイズの変更

SFOサーバのログサイズを変更する場合は，簡易構築定義ファイルで，ログファイルの面数，およびログファイル1面当たりの最大サイズを設定します。設定方法は，J2EEサーバのログ取得の設定と同じです。詳細については，「5.6　J2EEサーバのログ取得の設定」を参照してください。

(2)　ログレベルの変更

SFOサーバのログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。設定方法は，J2EEサーバのログ取得の設定と同じです。詳細については，「5.6　J2EEサーバのログ取得の設定」を参照してください。

5.8　Webサーバのログ取得の設定

この節では，Webサーバのログ取得で設定できる項目について説明します。ログ取得の設定対象となるWebサーバは，Hitachi Web Serverです。

Webサーバが出力するログには，エラーログ，アクセスログ，リクエストログなどがあります。出力するログの詳細については，マニュアル「Hitachi Web Server」を参照してください。Webサーバの出力するログのうち，エラーログ，アクセスログおよびリクエストログは，出力先やログの出力方式などを簡易構築定義ファイルで変更できます。

Webサーバのログ取得で変更できる設定項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表5-9　Webサーバのログ取得の設定項目

ログ | 項目 | 対応する簡易構築定義ファイルのパラメタ
エラーログ | 出力するエラーログのレベル | 論理Webサーバ（web-server）の<configuration>タグ内のLogLevel
エラーログの出力方式 | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdErrorMethod
エラーログの出力先ディレクトリ | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdErrorLogFileDir
アクセスログ | アクセスログの出力方式 | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomMethod
アクセスログの出力先ディレクトリ | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomLogFileDir
アクセスログ出力時のフォーマット | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdCustomlogFormat
リクエストログ | トレースの採取有無 | 論理Webサーバ（web-server）の<configuration>タグ内のHWSRequestLogLevel
リクエストログの出力方式 | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdRequestMethod
リクエストログの出力先ディレクトリ | 論理Webサーバ（web-server）の<configuration>タグ内のHttpsdRequestLogFileDir

また，エラーログ，アクセスログおよびリクエストログに出力する時刻ならびに時間の単位を，論理Webサーバ（web-server）の<configuration>タグ内のHWSLogTimeVerboseパラメタで指定できます。

5.9　リダイレクタのログ取得の設定

この節では，リダイレクタのログ取得で設定できる項目について説明します。

リダイレクタの出力するログは，出力先やログ出力レベルなどを変更できます。リダイレクタが出力するログは，メッセージログと保守用トレースログの二つに分けて出力されます。メッセージログには，障害発生時のログなどのメッセージが出力されます。保守用トレースログには，HTTPリクエストを受信し，レスポンスを送信するまでのトレース情報が出力されます。

保守用トレースログのログサイズは，見積もりの計算式に従い，障害発生時から障害を検知しログを収集するまで保持されるサイズにカスタマイズすることをお勧めします。

注意事項

ログファイル初期化処理の開始時および終了時には，メッセージログにそれぞれKDJE41029-I，KDJE41030-Iのメッセージが出力されます。Webサーバの起動時には，ログファイル初期化処理が正常に終了したことを確認するため，メッセージログにKDJE41029-I，KDJE41030-Iのメッセージが出力されていることを確認してください。

UNIXの場合，簡易構築定義ファイルに設定されたファイルサイズ，およびファイル面数のログファイルは，Webサーバとの連携の設定後の初回起動時に作成されます。ログファイルの作成は，ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合，またはファイル面数を増やした場合などは，ログファイルの作成処理に数分掛かる場合があります。

＜この節の構成＞

(1)　ログ取得の設定の変更

(1)　ログ取得の設定の変更

簡易構築定義ファイルおよびmod_jk.confで，リダイレクタのログ取得の設定を変更できます。なお，UNIXの場合，設定を変更できるのは，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）を持つユーザです。

(a)　変更した設定を有効にする方法

変更した設定を有効にする方法について，OSごとに説明します。

Windowsの場合

変更したリダイレクタのログ取得の設定を有効にするには，Hitachi Web Serverを再起動してください。

UNIXの場合

変更したリダイレクタのログ取得の設定を有効にする方法は，ファイルサイズまたはファイル面数の変更の有無によって異なります。

ファイルサイズまたはファイル面数を変更する場合

ファイルサイズまたはファイル面数を変更する場合に，変更したリダイレクタのログ取得の設定を有効にする方法を次に示します。

Hitachi Web Serverを停止します。

ログファイルおよび管理ファイルを移動または削除します。
メッセージログファイルの場合：メッセージログファイルおよびHNTRLibが使用する管理ファイル（<JkLogFilePrefixの設定値>.mm）を移動，または削除します。
保守用トレースログファイルの場合：保守用トレースログファイルおよびHNTRLibが使用する管理ファイル（<JkTrcaeLogFilePrefixの設定値>.mm）を移動，または削除します。

Hitachi Web Serverを再起動します。

ファイルサイズまたはファイル面数を変更しない場合

ファイルサイズまたはファイル面数を変更しない場合は，Hitachi Web Serverを再起動してください。

(b)　変更できる設定項目

変更できる設定項目と，項目に対応する各ファイルの設定内容を次の表に示します。

表5-10　リダイレクタのログ取得の設定（簡易構築定義ファイル，mod_jk.conf）

項目 | 設定個所 | 設定内容
メッセージログ，保守用トレースログのログ出力レベル | 簡易構築定義ファイル | 論理Webサーバ（web-server）の<configuration>タグ内に，JkLogLevelパラメタで，リダイレクタのログの出力レベルを指定します。
メッセージログ出力先 | 論理Webサーバ（web-server）の<configuration>タグ内に，JkLogFileDirパラメタで，リダイレクタのログ出力先ディレクトリを指定します。
メッセージログファイルサイズ | 論理Webサーバ（web-server）の<configuration>タグ内に，JkLogFileSizeパラメタで，リダイレクタのログを出力するログファイルの1ファイル当たりのサイズを指定します。
メッセージログファイル面数 | 論理Webサーバ（web-server）の<configuration>タグ内に，JkLogFileNumパラメタで，リダイレクタのログを出力するログファイルの面数を指定します。
メッセージログファイル名のプリフィックス | mod_jk.conf | mod_jk.confで，JkLogFilePrefixキーにリダイレクタのログを出力するログファイル名のプリフィックスを指定します。
保守用トレースログ出力の有無 | 簡易構築定義ファイル | 論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogパラメタで，リダイレクタの保守用トレースログを出力するかどうかを指定します。
保守用トレースログ出力先 | 論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogFileDir※パラメタで，リダイレクタの保守用トレースログの出力先ディレクトリを指定します。
保守用トレースログファイルサイズ | 論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogFileSizeパラメタで，リダイレクタの保守用トレースログを出力するログファイルの1ファイル当たりのサイズを指定します。
保守用トレースログファイル面数 | 論理Webサーバ（web-server）の<configuration>タグ内に，JkTraceLogFileNumパラメタで，リダイレクタの保守用トレースログを出力するログファイルの面数を指定します。
保守用トレースログファイル名のプリフィックス | mod_jk.conf | mod_jk.confで，JkTrcaeLogFilePrefix※キーにリダイレクタの保守用トレースログを出力するログファイル名のプリフィックスを指定します。

注※　保守用トレースログの出力先とプリフィックスには，同じ値を指定しないでください。同じ値を指定した場合は，リダイレクタが動作しません。

メッセージログ，および保守用トレースログのデフォルトの出力先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs※

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

注※　新規インストール時には，logsディレクトリは存在しません。logsディレクトリは，Hitachi Web Serverの起動時に生成されます。

ログレベルのレベル名

ログレベルのレベル名には，重要度の高い順に「emerg」※，「error」，「info」，「debug」のどれかを指定できます。

emerg：通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。※

error：通常運用時に指定します。

info：テスト時に指定します。

debug：障害調査時に指定します。

ログレベルは，単独で指定してください（コンマ区切りで複数のログレベルを指定しないでください）。あるログレベルを指定すると，指定されたログレベルおよびそれよりも重要度の高いログが出力されます。

注※　Windowsの場合に指定できます。

ログサイズの見積もりの計算式

GETリクエスト，POSTリクエストの1HTTPアクセス当たりのログサイズは，次の計算式で見積もってください。

GETによる1HTTPアクセス当たりのログサイズ
= 1.75 +（平均レスポンスボディサイズ / 16）* 0.25

POSTによる1HTTPアクセス当たりのログサイズ
= 2.00 +（平均POSTデータサイズ / 16）* 0.5 +（平均レスポンスボディサイズ / 16）* 0.25

なお，単位はすべてキロバイト，除算結果の小数点以下の値はすべて切り捨てです。また，計算式ではリクエストURLとクエリー文字列の平均サイズは，それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は，計算式の最初の値に，超える分のサイズを加えて計算してください。

5.10　インプロセスHTTPサーバのログ取得の設定

この節では，インプロセスHTTPサーバのログ取得で設定できる項目について説明します。

インプロセスHTTPサーバでは，アプリケーション開発のサポート，運用時の性能解析，および障害発生時のトラブルシュートのために，アクセスログ，性能解析トレース，スレッドトレース，および通信トレースを出力します。これらのファイルでは，ファイル面数やファイルサイズを簡易構築定義ファイルで変更できます。

インプロセスHTTPサーバのログ取得で変更できる設定項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。

表5-11　インプロセスHTTPサーバのログ取得の設定項目

ログおよびトレース
項目
対応する簡易構築定義ファイルのパラメタ

アクセスログ
アクセスログの出力の有無
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.inprocess_http.enabled※1
（デフォルトではアクセスログが出力されます）

アクセスログのファイル名
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.inprocess_http.filename※1

アクセスログのファイルサイズ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.inprocess_http.filesize※1

アクセスログのファイル面数
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.inprocess_http.filenum※1

アクセスログのフォーマット名
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.format_list※1※2

アクセスログの出力形式
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.<フォーマット名>※1※2

アクセスログ出力時のフォーマット
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.access_log.inprocess_http.usage_format※1※2

性能解析トレース
－
ほかの性能解析トレースと同様に，日常的なシステム運用の作業で，cprfedコマンドを実行するときに取得条件などを指定します。性能解析トレースファイルの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

スレッドトレース
スレッドトレースのファイル面数
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.thread_trace.inprocess_http.filenum※3

スレッドトレースのファイルサイズ
スレッドトレースのファイルサイズ＝（（（A+B）×32,786）＋32,914）バイト
A＝論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.connector.inprocess_http.max_connectionsパラメタの値
B＝論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.connector.inprocess_http.send_timeoutパラメタの値が0の場合0，0以外の場合1

通信トレース
通信トレースのファイル面数
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.logger.communication_trace.inprocess_http.filenum※3

通信トレースのファイルサイズ
通信トレースのファイルサイズ＝（（（A+B）×172,050）＋128）バイト
A＝論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.connector.inprocess_http.max_connectionsパラメタの値
B＝論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.connector.inprocess_http.send_timeoutパラメタの値が0の場合は0，0以外の場合は1

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　アクセスログでは，これらのキーでフォーマットを定義することで，ログの出力形式をカスタマイズできます。アクセスログのカスタマイズについては，「8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ」を参照してください。

注※3　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

5.11　Cosminexus Managerのログ取得の設定

運用管理エージェント，運用監視エージェント，およびManagement Serverのログには，個別に取得する以外に，統合ログとしてまとめて取得できるものがあります。統合ログとして取得できるのは，統合メッセージログファイル，統合トレースログファイル，コマンド保守ログファイルです。なお，統合ログとして取得できるログの詳細については，マニュアル「Cosminexus　システム運用ガイド」のCosminexusのログの取得に関する説明を参照してください。

この節では，統合ログの設定の変更について説明します。統合ログは，manager.cfgで設定します。manager.cfgの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥manager.cfg

UNIXの場合
/opt/Cosminexus/manager/config/manager.cfg

統合ログの設定を変更する場合には，manager.cfgで次のキーを設定してください。

com.cosminexus.manager.log.dir
統合ログの出力先を指定します。なお，デフォルトの設定では，次の場所に出力されます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥log

UNIXの場合
/opt/Cosminexus/manager/log

com.cosminexus.manager.messagelog.size
統合メッセージログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.messagelog.fnum
統合メッセージログファイルの面数を指定します。

com.cosminexus.manager.tracelog.size
統合トレースログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.tracelog.fnum
統合トレースログファイルの面数を指定します。

com.cosminexus.manager.cmdtracelog.size
コマンド保守ログファイルの1ファイル当たりの最大サイズを指定します。

com.cosminexus.manager.cmdtracelog.fnum
コマンド保守ログファイルの面数を指定します。

com.cosminexus.manager.log.compatible
運用管理エージェント，およびManagement Serverのログを個別で出力するかどうかを指定します。デフォルトの設定では，統合ログと同時に個別のログも出力されます。個別のログを出力しない場合には，falseを指定してください。

5.12　コンソールログの取得の設定

Management Serverを利用している場合には，運用管理エージェントが起動したプロセスの標準出力や標準エラー出力などを，コンソール出力情報として取得できます。この節では，コンソールログを取得するための設定の変更について説明します。コンソール出力情報のログファイル（コンソールログ）への出力の設定を変更する場合は，adminagent.propertiesで次のキーを設定してください。

adminagent.process.consolelog.enabled
コンソール出力情報を出力するかどうかを指定します。デフォルトの設定では，trueが指定されていて，出力するようになっています。

adminagent.j2ee.process.console_log.enabled
論理J2EEサーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。デフォルトの設定では，falseが指定されていて，出力されないようになっています。
また，adminagent.j2ee.process.console_log.enabledキーにtrueを指定する場合，adminagent.process.consolelog.enabledキーにもtrueを指定する必要があります。

adminagent.userserver.process.console_log.enabled
論理ユーザサーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。デフォルトの設定では，falseが指定されていて，出力されないようになっています。
また，adminagent.userserver.process.console_log.enabledキーにtrueを指定する場合，adminagent.process.consolelog.enabledキーにもtrueを指定する必要があります。

adminagent.j2ee.process.console_event.enabled
論理J2EEサーバのコンソール出力情報をServer Plug-inまたはHCSC-Managerに表示するかどうかを指定します。デフォルトの設定では，falseが指定されていて，表示されないようになっています。
また，adminagent.j2ee.process.console_event.enabledキーにtrueを指定する場合，adminagent.process.consolelog.enabledキーにもtrueを指定する必要があります。なお，HCSC-Managerについては，マニュアル「Cosminexus サービスプラットフォーム　システム構築・運用ガイド」を参照してください。

adminagent.userserver.process.console_event.enabled
論理ユーザサーバのコンソール出力情報をServer Plug-inまたはHCSC-Managerに表示するかどうかを指定します。デフォルトの設定では，falseが指定されていて，表示されないようになっています。
また，adminagent.userserver.process.console_event.enabledキーにtrueを指定する場合，adminagent.process.consolelog.enabledキーにもtrueを指定する必要があります。なお，HCSC-Managerについては，マニュアル「Cosminexus サービスプラットフォーム　システム構築・運用ガイド」を参照してください。

adminagent.process.consolelog.filenum
コンソールログの面数を指定します。

adminagent.process.consolelog.filesize
コンソールログの1面当たりの最大サイズを指定します。

5.13　リソースアダプタのログ取得の設定

この節では，リソースアダプタログを取得するための設定について説明します。リソースアダプタのログを取得するために必要な設定は次の二つです。

ログ出力の有無の設定
サーバ管理コマンドで，リソースアダプタ単位でのログ出力の有無を設定します。cjgetrarpropコマンドでConnector属性ファイルを取得し，<property>タグでLogEnabledにtrueを指定します。ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。なお，リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。
Connector属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。サーバ管理コマンドの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

ログのサイズ，面数，ログレベルの設定
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで，リソースアダプタのログのサイズ，面数を設定します。

ejbserver.connector.logwriter.filesize
リソースアダプタのログファイル1面当たりの最大サイズ（単位：バイト）を指定します。

ejbserver.connector.logwriter.filenum
リソースアダプタのログファイルの面数を指定します。

また，J2EEサーバのログの出力レベル（ログレベル）がリソースアダプタのログレベルになります。J2EEサーバのログレベルの設定については，「5.6(3)　ログレベルの変更」を参照してください。

5.14　Cosminexus TPBrokerのログ取得の設定

この節では，Cosminexus TPBrokerのトレースファイルの出力先，ファイル数，エントリ数の変更について説明します。

Cosminexus TPBrokerのトレースファイルのデフォルトの出力先は次のとおりです。

J2EEサーバのトレース情報の場合

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

サーバ管理コマンドのトレース情報の場合

Windowsの場合
<Cosminexusのインストールディレクトリ>CC¥admin¥logs¥TPB¥logj

UNIXの場合
/opt/Cosminexus/CC/admin/logs/TPB/logj

変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタまたはユーザ定義ファイルとキーを次の表に示します。

表5-12　Cosminexus TPBrokerのログ取得の設定項目

項目
分類
対応する簡易構築定義ファイルのパラメタまたはユーザ定義ファイルとキー

トレースファイルの出力先
J2EEサーバ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory※1
または
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.tracePath※2

サーバ管理コマンド
usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプション
または
サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキー※3

トレースファイルの面数
J2EEサーバ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.comt.fileCount※2

トレースファイルのエントリ数
J2EEサーバ
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のvbroker.orb.htc.comt.entryCount※2

注※1　簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

注※3　サーバ管理コマンド用のusrconf.batファイル（Windowsの場合）またはusrconfファイル（UNIXの場合），およびusrconf.propertiesについては，「9.2.2　サーバ管理コマンドの動作設定のカスタマイズ」を参照してください。サーバ管理コマンド用の各ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注意事項

トレースファイルの出力先を変更する場合は，変更後のトレースファイル出力先ディレクトリのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。出力先を変更すると，変更後のログ出力先ディレクトリ下のcomtrcとmdltrcにトレースファイルが出力されます。

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，<param-name>にejb.server.log.directoryと，vbroker.orb.htc.tracePathの両方を設定した場合は，vbroker.orb.htc.tracePathの設定が優先されます。

usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプションと，サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキーをどちらも設定した場合は，サーバ管理コマンド用のusrconf.propertiesのvbroker.orb.htc.tracePathキーの設定が優先されます。

Management Serverリモート管理機能から操作した場合，サーバ管理コマンドのログ出力先は変更できません。

5.15　Cosminexus DABroker Libraryのログ取得の設定

Cosminexus DABroker Libraryでは，JDBCドライバのトレース情報やスプール情報を取得できます。この節では，これらの情報を取得するための設定について説明します。

＜この節の構成＞

(1)　JDBCドライバのトレース情報の取得

(2)　スプール情報の取得

(1)　JDBCドライバのトレース情報の取得

Cosminexus DABroker Libraryでは，スプール情報のほかに次のJDBCドライバのトレースも取得できます。

JDBCインタフェースメソッドトレース

Cosminexus DABroker Libraryのイベントトレース

ただし，これらのトレースを取得するためには，アプリケーション開発時にJDBCドライバのトレース取得のための設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　機能解説」のデータベース接続の設定に関する説明を参照してください。

(2)　スプール情報の取得

Cosminexus DABroker Libraryでは，スプール情報として，メッセージログ，拡張データベースアクセストレース，Exceptionトレースログなどを取得できます。環境設定ユティリティ（Windowsの場合）またはCosminexus DABroker Library動作環境定義ファイル（UNIXの場合）で，メッセージログ，拡張データベースアクセストレースのファイルサイズなどを設定してください。環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

また，Exceptionトレースログを取得するためには，運用開始前に取得のための設定が必要です。ここでは，Exceptionトレースログ取得の設定について説明します。

Exceptionトレースログ取得の設定では，次の内容を設定します。

トレース取得レベル

ファイル出力先

ファイル出力情報量

メモリ内取得情報量

それぞれの設定方法について説明します。

(a)　トレース取得レベル

Exceptionトレースログは，メソッド実行時に，SQLException，BatchUpdateException，またはXAExceptionが発生した場合に出力されます。Exceptionトレースログを出力するメソッドには，メソッドごとにトレース取得レベルが定義されています。出力するトレース取得レベルを指定することで，目的に応じた内容のトレースを出力できるようになります。

設定方法
トレース取得レベルは，次の環境変数で指定します。

環境変数名
説明

DAB_TRACELEVEL
トレース取得レベルとして，1～5を指定します。ただし，トレース取得レベル4は現在未使用であり，4が指定された場合は3と同じ動きとなります。

ここでは，どのトレース取得レベルまでログを取得するかを指定します。例えば，トレース取得レベル3を指定した場合は，トレース取得レベル1および2の内容が取得できます。トレース取得レベル5が指定された場合は，内部呼び出しを含め，ログ取得対象メソッドをすべて取得します。

指定を省略した場合，または不正な値を指定した場合は，トレース取得レベルとして，1を仮定します。

ログを取得するメソッドは，指定された値で取得されるメソッドすべてとなります。

指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

トレース取得レベルと取得できるログの内容
Exceptionトレースログのトレース取得レベルと取得できるログの内容を次の表に示します。

表5-13　Exceptionトレースログのトレース取得レベル

トレース取得レベル
取得できるログの内容
説明

1

データベースとの接続と切断

ステートメントの作成とクローズ

静的SQLの実行

標準のトレース取得レベルです。コネクションとステートメントの状態と実行順序を調査したい場合に指定してください。

2

トレース取得レベル1の内容

トランザクションのコミット，およびロールバック

データベースへのアクセス要求

ResultSetクラスの処理

各オブジェクトの処理

データベースのアクセス要求の状態と実行順序を調査したい場合に指定してください。ソースとログの比較が容易になります。

3

トレース取得レベル1および2の内容

XA要求

XA要求の状態と実行順序を調査したい場合に指定してください。

5

トレース取得レベル1,2および3の内容

JDBCドライバの内部呼び出し

内部処理の状態と実行順序を調査したい場合に指定してください。

Exceptionトレースログを出力するメソッドのトレース取得レベル
Exceptionトレースログを出力するメソッドのトレース取得レベルを次の表に示します。

表5-14　Exceptionトレースログを取得するメソッドのトレース取得レベル

クラス名 | メソッド名 | トレース取得レベル | 備考
CallableStatement | boolean execute()※1 | 2 | Statementクラス，およびPreparedStatementクラスのメソッドをオーバーライドしたメソッド。
ResultSet executeQuery()※1 | 2
int executeUpdate()※1 | 2
boolean execute(String sql)※2 | 1
int[] executeBatch() | 2
ResultSet executeQuery(String sql)※2 | 1
int executeUpdate(String sql)※2 | 1
Connection | void close() | 1 | －
void commit() | 2 | －
Statement createStatement()※1 | 1 | －
Statement createStatement(int resultSetType, int resultSetConcurrency)※2 | 1 | －
DatabaseMetaData getMetaData() | 2 | －
CallableStatement prepareCall(String sql)※1 | 1 | －
CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency)※2 | 1 | －
PreparedStatement prepareStatement(String sql)※1 | 1 | －
PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency)※2 | 1 | －
void rollback() | 2 | －
void setAutoCommit(boolean autoCommit) | 2 | －
DatabaseMetaData | ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) | 2 | －
ResultSet getCatalogs() | 2 | －
ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) | 2 | －
ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) | 2 | －
Connection getConnection() | 2 | －
ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) | 2 | －
ResultSet getExportedKeys(String catalog, String schema, String table) | 2 | －
ResultSet getImportedKeys(String catalog, String schema, String table) | 2 | －
ResultSet getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate) | 2 | －
ResultSet getPrimaryKeys(String catalog, String schema, String table) | 2 | －
ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) | 2 | －
ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) | 2 | －
ResultSet getSchemas() | 2 | －
ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) | 2 | －
ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) | 2 | －
ResultSet getTableTypes() | 2 | －
ResultSet getTypeInfo() | 2 | －
ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) | 2 | －
ResultSet getVersionColumns(String catalog, String schema, String table) | 2 | －
Driver | Connection connect(String url, Properties info) | 1 | －
PreparedStatement | boolean execute()※1 | 2 | －
ResultSet executeQuery()※1 | 2 | －
int executeUpdate()※1 | 2 | －
ResultSetMetaData getMetaData() | 2 | －
boolean execute(String sql)※2 | 1 | Statementクラスのメソッドをオーバーライドしたメソッド。
int[] executeBatch() | 2
ResultSet executeQuery(String sql)※2 | 1
int executeUpdate(String sql)※2 | 1
ResultSet | boolean absolute(int row) | 2 | データベースにアクセスするときだけ取得します。
void afterLast() | 2
void beforeFirst() | 2
void close() | 2 | －
boolean first() | 2 | データベースにアクセスするときだけ取得します。
ResultSetMetaData getMetaData() | 2 | －
Statement getStatement() | 2 | －
boolean last() | 2 | データベースにアクセスするときだけ取得します。
boolean next() | 2
boolean relative(int rows) | 2
Statement | void cancel() | 2 | －
void close() | 1 | －
boolean execute(String sql) | 1 | －
int[] executeBatch() | 2 | －
ResultSet executeQuery(String sql) | 1 | －
int executeUpdate(String sql) | 1 | －
ResultSet getResultSet() | 2 | －
DataSource | Connection getConnection()※1 | 1 | －
Connection getConnection(String username, String password)※2 | 1 | －
PooledConnection | void close() | 1 | －
Connection getConnection() | 1 | －
ConnectionPoolDataSource | PooledConnection getPooledConnection()※1 | 1 | －
PooledConnection getPooledConnection(String username, String password) ※2 | 1 | －
XAConnection | XAResource getXAResource() | 1 | －
XADataSource | XAConnection getXAConnection()※1 | 1 | －
XAConnection getXAConnection(String user, String password)※2 | 1 | －
XAResource | void commit(Xid xid, boolean onePhase) | 3 | －
void end(Xid xid, int flags) | 3 | －
void forget(Xid xid) | 3 | －
boolean isSameRM(XAResource xares) | 3 | －
int prepare(Xid xid) | 3 | －
Xid[] recover(int flag) | 3 | －
void rollback(Xid xid) | 3 | －
void start(Xid xid, int flags) | 3 | －

注※1　メソッド名は，「メソッド名(1)」と出力されます。

注※2　メソッド名は，「メソッド名(2)」と出力されます。

(b)　ファイル出力先

Exceptionトレースログを出力するファイルの出力先を設定できます。

設定方法
ファイル出力先は，次の環境変数で指定します。

環境変数名
説明

DAB_FILEDIR
Exceptionトレースログの出力先のディレクトリを絶対パスで指定します。

指定を省略した場合は，次の場所にExceptionトレースログが出力されます。
Windowsの場合
<Cosminexus DABroker Library運用ディレクトリ>¥spool
UNIXの場合
<Cosminexus DABroker Library運用ディレクトリ>/spool

ファイルの出力先として，<ファイルの出力先ディレクトリ>¥<J2EEサーバ名称+MTrc.log>のバイト数が259バイトを超える値は指定しないでください。環境変数の設定値のバイト数の上限は，1,024バイトです。上限を超えた場合は，先頭から1,024バイト分だけが有効になります。

指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

(c)　ファイル出力情報量

Exceptionトレースログを出力するファイルの出力情報量を設定できます。

設定方法
ファイル出力情報量は，次の環境変数で指定します。

環境変数名
説明

DAB_FILEOUTNUM
ファイル出力情報量として，メモリ内取得情報をファイルに出力する回数の上限を指定します。指定できる範囲は，1～50です。

指定を省略した場合，または不正な値を指定した場合は，出力情報量として，5を仮定します。指定された値が1以下の場合は1，50以上の場合は50を出力情報量として仮定します。

指定した上限を超えて出力しようとすると，カレントファイルは１世代前のファイルとなり，新しくカレントファイルが作成されて，情報が出力されます。

環境変数の設定値のバイト数の上限は，10バイトです。上限を超えた場合には，先頭から10バイト分だけが有効になります。

指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

情報量の上限
一つのファイルに出力する情報量の上限（単位：行）は，次の算出式で求められます。

情報量の上限＝（DAB_ONMEMNUMの指定値）×（DAB_FILEOUTNUMの指定値）

なお，Exceptionトレースログを出力するためのファイルサイズの概算（単位：キロバイト）は，次の算出式で求められます。

出力するファイルサイズ＝2×メモリ内取得情報量（DAB_ONMEMNUMの指定値）×ファイル出力情報量（DAB_FILEOUTNUMの指定値）×2

(d)　メモリ内取得情報量

Exceptionトレースログを出力するファイルのメモリ内取得情報量を設定できます。

設定方法
メモリ内取得情報量は，次の環境変数で指定します。

環境変数名
説明

DAB_ONMEMNUM
メモリ内取得情報量として，メモリ内で保持する情報量の上限を指定します。指定できる範囲は500～10,000（単位は，行※）です。

指定を省略した場合，または不正な値を指定した場合は，メモリ内取得情報量として，1,000を仮定します。指定された範囲が500以下の場合は500，10,000以上の場合は10,000をメモリ内取得情報量として仮定します。

指定した上限を超えて保持しようとすると，ラップアラウンドします。

環境変数の設定値のバイト数の上限は，10バイトです。上限を超えた場合には，先頭から10バイト分だけが有効になります。

指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

注※　1行とは，メソッドの呼び出し情報，メソッドの戻り情報，およびException情報のそれぞれで一度に取得する情報のことです。

メモリ所要量の算出式
Exceptionトレースログを出力するために必要となるメモリ所要量（単位：キロバイト）は，次の算出式で求められます。

メモリ所要量＝2×メモリ内取得情報量（DAB_ONMEMNUMの指定値）

5.16　OSの統計情報取得の設定

この節では，Windowsの場合に，OSの統計情報を取得するための設定について説明します。

Windowsのシステムモニタを使用して，システムリソースのパフォーマンスデータを取得できます。トラブル発生時またはトラブルの兆候が見られる場合には，Windowsのシステムモニタでパフォーマンスデータの取得を開始し，トラブル発生後にパフォーマンスデータのログを保存します。システムモニタの操作の詳細については，OS付属のマニュアルなどを参照してください。

次の表に示すシステムモニタのログを60秒間隔で採取します。なお，具体的な設定方法は，OS付属のマニュアルなどを確認してください。

表5-15　システムモニタの設定内容

パフォーマンスオブジェクト | インスタンス | 項目名 | 説明
processor | － | %Processor Time | CPU使用率 (非アイドル状態のスレッドを除く合計値)
%Privileged Time | CPU使用率(カーネルモード分)
%User Time | CPU使用率(ユーザモード分)
memory | － | Cache Bytes | ファイルシステム キャッシュが現在使用しているバイト数
Cache Faults/sec | 1秒間当たりのメモリの別の場所からの取り出しか，ディスクから取り出しの回数
Page Faults/sec | 1秒間当たりのページフォールトの数
Transition Faults/sec | 1秒間当たりのフォールトの数
process | _Total | Handle Count | 現在オープンしているハンドルの総数
Page Faults/sec | ページフォールトの発生率
Private Bytes | メモリ使用量(バイト)
Virtual Bytes | 仮想メモリ使用量(バイト)
Working Set Bytes | 実メモリ使用量(バイト)
cjstartsv | %Processor Time | CPU使用率 (非アイドル状態のスレッドを除く合計値)
%Privileged Time | CPU使用率(カーネルモード分)
%User Time | CPU使用率(ユーザモード分)
Page Faults/sec | ページフォールトの発生率
Thread Count | スレッド数
Private Bytes | メモリ使用量(バイト)
Virtual Bytes | 仮想メモリ使用量(バイト)
Working Set Bytes | 実メモリ使用量(バイト)

（凡例）　－：該当しない。

5.17　ユーザダンプ取得の設定

この節では，Windowsの場合に，ユーザダンプを取得するための設定について説明します。

＜この節の構成＞

(1)　ワトソン博士を使用する場合

(2)　mngsvrutilコマンドを使用する場合

(1)　ワトソン博士を使用する場合

ワトソン博士を使用してユーザダンプを取得する場合は，ワトソン博士を使用できるように設定しておいてください。ワトソン博士のオプションとして「ダンプ シンボル テーブル」「すべてのスレッド コンテキストをダンプ」「クラッシュ ダンプ ファイルの作成」を設定します。ワトソン博士の使用方法についてはOS付属のマニュアルなどを確認してください。

また，プロセスがハングアップした場合にユーザダンプを取得するために，Microsoft社が提供しているuserdump.exeを入手しておきます。詳細はMicrosoft社のホームページなどを参照してください。

(2)　mngsvrutilコマンドを使用する場合

mngsvrutilコマンドのサブコマンドdumpを使用してユーザダンプを取得する場合は，プロセスがハングアップしたときにユーザダンプを取得するために，Microsoft社が提供しているuserdump.exeを入手しておきます。詳細はMicrosoft社のホームページなどを参照してください。

5.18　coreダンプ取得の設定

この節では，UNIXの場合に，coreダンプを取得するための設定について説明します。

＜この節の構成＞

(1)　coreファイルのサイズの上限値の設定

(2)　coreファイルのファイル数の上限値の設定

(1)　coreファイルのサイズの上限値の設定

システムの動作環境によっては，coreファイルのサイズの上限値が0になっている場合があります。この場合，サーバプロセスの異常終了時にcoreダンプを取得できないため，あらかじめcoreファイルのサイズの上限値を無制限に設定しておく必要があります。coreファイルのサイズの上限値を無制限にするためには，簡易構築定義ファイルでJavaVM起動パラメタにオプションを指定するか，またはシェルコマンドを実行します。

なお，簡易構築定義ファイルでJavaVM起動パラメタに指定するメモリプールサイズが大きいほど，coreファイルのサイズも大きくなるため，十分な空きディスク容量を確保してください。

簡易構築定義ファイルでJavaVM起動パラメタにオプションを指定する場合
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:+HitachiFullCore

指定例（物理ティアの定義の場合）

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>add.jvm.arg</param-name>
   <param-value>-XX:+HitachiFullCore</param-value>
 </param>
 ：
</configuration>

シェルコマンドを実行する場合
シェルコマンドを実行して，coreファイルの上限値を無制限にしてください。

csh（Cシェル）の場合の実行例

limit coredumpsize unlimit

sh（標準シェル）の場合の実行例

ulimit -c unlimited

(2)　coreファイルのファイル数の上限値の設定

coreのファイル数の上限値は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.corefilenumパラメタで定義できます。ejb.server.corefilenumパラメタは，J2EEサーバの拡張パラメタで定義します。

cjstartsvプロセスの再起動時に「<作業ディレクトリ>/ejb/<サーバ名称>/」に出力されるcoreダンプファイルの合計が上限値を超えた場合，出力日時が古い順に削除されます。

5.19　JavaVMの資料取得の設定

この節では，次に示すJavaVMの資料を取得するための設定について説明します。

JavaVMのスレッドダンプ

日立固有のJavaVMログ（日立JavaVMログファイル）

JavaVMのオプションについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

なお，JavaVMのスレッドダンプは，デフォルトでは次のディレクトリ下に出力されます。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

日立固有のJavaVMログは，デフォルトでは次のディレクトリ下に出力されます。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/logs

出力先を変更したい場合は，JavaVMまたはJ2EEサーバ起動前に，簡易構築定義ファイルで論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで，ログ出力ディレクトリを変更しておく必要があります。

次に，JavaVMのスレッドダンプ，日立固有のJavaVMログ（日立JavaVMログファイル）それぞれの取得の設定について説明します。

＜この節の構成＞

(1)　JavaVMのスレッドダンプ取得の設定

(2)　日立固有のJavaVMログ取得の設定

(3)　拡張verbosegc機能オプションの設定

(1)　JavaVMのスレッドダンプ取得の設定

JavaVMのスレッドダンプを取得するための設定について説明します。

JavaVMのスレッドダンプに出力される内容は，簡易構築定義ファイルでJavaVM起動パラメタに指定しているJavaVMの起動オプションによって異なります。JavaVMの起動オプションは，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

JavaVMのスレッドダンプを取得するために指定するオプションについては，表5-16を参照してください。

JavaVMのスレッドダンプを出力する場合に指定するオプションを次の表に示します。

表5-16　JavaVMのスレッドダンプを取得するために指定するオプション

オプション
説明

-XX:+HitachiThreadDump
拡張スレッドダンプを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpToStdout
拡張スレッドダンプを標準出力に出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithHashCode
スレッド情報にスレッドのハッシュコードを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithCpuTime
スレッド情報にスレッドを開始してからのユーザCPU時間，およびカーネルCPU時間を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithBlockCount
スレッド情報にスレッドが処理をブロックした回数，および処理が待ち状態になった回数を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiOutOfMemoryAbort
-XX:+HitachiOutOfMemoryAbortThreadDump
どちらも設定されている場合は，OutOfMemoryErrorによって強制終了した時に，スレッドダンプを出力します。ただし，J2SEクラスライブラリでCヒープ不足が発生した場合，およびJavaVMの処理中にCヒープ不足が発生した場合は，スレッドダンプを出力しません。

(2)　日立固有のJavaVMログ取得の設定

日立固有のJavaVMログを取得するための設定について説明します。

日立固有のJavaVMログとは，日立が標準のJavaVMに追加した拡張オプションを使用して取得できるログです。標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。このログファイルを，日立JavaVMログファイルといいます。

日立JavaVMログファイルを取得するためには，簡易構築定義ファイルでJavaVM起動パラメタにJavaVMの起動オプションを指定します。JavaVMの起動オプションは，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

日立固有のJavaVMログ（日立JavaVMログファイル）を取得するために指定するオプションについては，表5-17を参照してください。

日立JavaVMログファイルを取得するために指定するオプションを次の表に示します。

表5-17　日立固有のJavaVMログ（日立JavaVMログファイル）を取得するために指定するオプション

オプション
説明

-XX:+HitachiOutOfMemoryStackTrace
-XX:+HitachiVerboseGC
-XX:+HitachiJavaClassLibTrace
次のオプションのうちどれかを指定している場合に，日立JavaVMログファイルを出力します。

-XX:+HitachiOutOfMemoryStackTraceを指定している場合は，例外情報とスタックトレースを日立JavaVMログファイルに出力します。なお，このオプションを指定すると，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseも同時に指定されます。

-XX:+HitachiVerboseGCを指定している場合は，ガーベージコレクションが発生したときに，拡張verbosegc情報を日立JavaVMログファイルに出力します。

-XX:+HitachiJavaClassLibTraceを指定している場合は，クラスライブラリのスタックトレースを日立JavaVMログファイルに出力します。

必要に応じて，次の拡張オプションを指定して，日立JavaVMログファイルの出力方法や出力内容を設定してください。

日立JavaVMログファイルのファイルサイズやファイル数

拡張verbosegc機能オプション

OutOfMemoryError発生時の拡張機能オプション

クラスライブラリトレース機能オプション

ローカル変数情報出力機能オプション

スワップ領域の予約オプション　など

JavaVMのオプションについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(3)　拡張verbosegc機能オプションの設定

ここでは，JavaVMの保守情報（Javaヒープの情報）およびガーベージコレクションのログに拡張verbosegc情報を出力するための設定について説明します。次の表に示すオプションで，拡張verbosegc情報の出力を有効にして，拡張verbosegc情報の出力形式を指定してください。

表5-18　拡張verbosegc情報を出力するために指定するオプション

オプション | 説明
-XX:+HitachiVerboseGC | 拡張verbosegc情報を日立JavaVMログファイルに出力します。
-XX:+HitachiVerboseGCPrintDate | 拡張verbosegc情報の各行に日付を出力します。
-XX:+HitachiVerboseGCCpuTime※ | ガーベージコレクションの開始から終了までの間で，ガーベージコレクションを実行したスレッドのCPU利用時間を出力します。CPU利用時間は，ユーザモードで費やしたCPU時間とカーネルモードで費やしたCPU時間に分けて出力されます。
-XX:HitachiVerboseGCIntervalTime=<時間間隔(秒)> | 拡張verbosegc情報の出力間隔を指定します。
-XX:+HitachiVerboseGCPrintCause | 拡張verbosegc情報に，ガーベージコレクションが発生した要因を出力します。
-XX:+HitachiOutputMilliTime | 拡張verbosegc情報の各行に日時（ミリ秒まで）を出力します。
-XX:+HitachiCommaVerboseGC | 拡張verbosegc情報をCSV形式で出力します。

注※

HP-UXの場合，このオプションは使用できません。オプションを指定しても無視されます。

拡張verbosegc情報から，そのサーバで必要とするJavaヒープ領域サイズ，Perm領域サイズなどを見積もるための情報を取得できます。

5.20　アプリケーションのユーザログ出力の設定

Cosminexusでは，日立トレース共通ライブラリを使用して，アプリケーションが出力するログをCosminexusの構成ソフトウェアが出力するログと同じ形式（日立トレース共通ライブラリ形式）で出力できます。これによって，システムのログとアプリケーションのログを同じ形式で扱うことができるようになり，システム全体のログ運用の信頼性とログ出力の性能を高められます。

この節では，J2EEアプリケーションが出力するログを，日立トレース共通ライブラリ形式で出力するための設定方法について説明します。J2EEアプリケーションのログを出力しない場合は，この設定は不要です。

＜この節の構成＞

5.20.1　アプリケーションのユーザログ出力の設定方法

5.20.2　アプリケーションのユーザログ出力例

5.20.1　アプリケーションのユーザログ出力の設定方法

日立トレース共通ライブラリ形式でログを出力するためには，次の設定が必要です。

J2EEアプリケーションのログ出力処理

簡易構築定義ファイルでの設定

セキュリティポリシーの設定

＜この項の構成＞

(1)　J2EEアプリケーションのログ出力処理

(2)　簡易構築定義ファイルでの設定

(3)　セキュリティポリシーの設定

(1)　J2EEアプリケーションのログ出力処理

J2EEアプリケーションを開発する際に，CJLogRecordクラスを使用して，次のようなログ出力処理を設定してください。

例外の内容と対応したメッセージIDを出力するための設定

出力したJ2EEアプリケーションごとにアプリケーション名を出力するための設定

CJLogRecordクラスを使用したログ出力処理のコーディング方法およびAPI詳細については，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

(2)　簡易構築定義ファイルでの設定

簡易構築定義ファイルを編集して，ハンドラからのログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定してください。

(a)　設定内容

簡易構築定義ファイルで論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.applicationから始まるパラメタで，J2EEアプリケーションのユーザログを出力するための設定をします。ejbserver.applicationから始まるパラメタを次に示します。なお，<ハンドラ名称>には，キーの値を区別するためのハンドラ名称を指定してください。また，<ロガー名称>には，Loggerのインスタンスを取得するときに指定するロガー名称を指定してください。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname
ハンドラごとに，ログファイルに出力するメッセージのJ2EEアプリケーション名（AppNameフィールドの値）のデフォルト値を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count
ハンドラごとに，ログファイルの面数を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding
ハンドラごとに，ログファイルに出力する文字列のエンコーディングを指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter
ハンドラごとに，使用するフィルタ名を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter
ハンドラごとに，使用するフォーマッタ名を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level
ハンドラごとに，ログ取得レベルの上限を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit
ハンドラごとに，ログファイルのサイズを指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid
ハンドラごとに，ログファイルに出力するメッセージのメッセージID（MsgIDフィールドの値）のデフォルト値を指定します。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path
ハンドラごとに，ログファイルの出力先とプリフィックスを指定します。出力されるログファイル名は，「<プリフィックス><1～16の番号>.log」になります。このキーは必ず指定してください。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator
ハンドラごとに，ログファイルに出力するメッセージを1文で出力するための，要素区切り文字のデフォルト値を指定します。

ejbserver.application.userlog.loggers
使用するロガー名称を宣言します。このキーは必ず指定してください。

ejbserver.application.userlog.Logger.<ロガー名称>.handlers
ロガーごとに，使用するハンドラ名称を指定します。このキーは必ず指定してください。

ejbserver.application.userlog.Logger.<ロガー名称>.level
ロガーごとに，ロガーのログ取得レベルを指定します。

ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers
ロガーごとに，ロガーを通過するレベルのログレコードを，親のロガーが使用しているハンドラに伝播させるかどうかを指定します。

ejbserver.application.userlog.Logger.<ロガー名称>.filter
ロガーごとに，ロガーでメッセージの取捨選択に使用するフィルタを指定します。

J2EEアプリケーションのユーザログを出力するためには，少なくとも，次の三つのパラメタを指定する必要があります。

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path

ejbserver.application.userlog.loggers

ejbserver.application.userlog.Logger.<ロガー名称>.handlers

簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(b)　注意事項

ロガーには複数のハンドラを接続できます。ただし，複数のロガーに同一のPath設定を持つファイルハンドラ（CJMessageFileHandler）は接続できません。ファイルハンドラはロガーへの接続の指定（ejbserver.application.userlog.Logger.<ロガー名称>.handlersの値）を参照してインスタンス化します。この際，ログの出力先とプリフィックス（ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.pathの値）の同じハンドラがインスタンス化されている場合は，ログファイルのオープンに失敗します。

ハンドラやロガーの設定および構築については，簡易構築定義ファイルで指定できますが，ハンドラの作成やロガーの構成変更をJ2EEアプリケーション内に直接実装する場合は，実行するアプリケーションにLoggingPermission("control")のセキュリティ権限が必要になります。LoggingPermission("control")のセキュリティ権限の設定方法については，「(3)　セキュリティポリシーの設定」を参照してください。

(3)　セキュリティポリシーの設定

アプリケーションのソースプログラム上で，J2SE1.4仕様のLoggerクラスの構成を変更したり，FileHandlerクラスを作成したりする場合，セキュリティポリシーを設定する必要があります。セキュリティポリシーは，server.policyに設定します。

server.policyの設定内容を次に示します。

FilterクラスやFormatterクラスなどをリフレクションで作成する場合は，次に示す行を追加します。

permission java.lang.reflect.ReflectPermission "suppressAccessChecks";

Handlerクラスは，ログマネジャからプロパティ値を取得し，実行時にリフレクション機能を使用してFormatterクラスやFilterクラスを生成します。そのため，リフレクションに関する権限が必要となります。

ログマネジャのプロパティを設定する場合は，次に示す行を追加します。

permission java.util.PropertyPermission "*", "read, write";

ログマネジャがログ出力用のプロパティの値を読み込んだり，書き込んだりするための権限が必要となります。

File出力を行うクラス（FileHandler，CJMessageFileHandler）を使用する場合は，次に示す行を追加します。

permission java.io.FilePermission "<<ALL FILES>>", "read, write";

ログをファイルへ出力するために読み込むための権限だけではなく，書き込み権限も必要となります。

J2SE1.4仕様のロギングAPIを使用する場合は，次に示す行を追加します。

permission java.util.logging.LoggingPermission "control";

この値を指定しないと，ロギングAPIが使用できません。

J2EEアプリケーションでサーブレット上からJ2SE1.4仕様のロギングAPIを利用する場合の設定例を示します。

//
// Grant permissions to JSP/Servlet
//
grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
  permission java.lang.RuntimePermission "loadLibrary.*";
  permission java.lang.RuntimePermission "queuePrintJob";
  permission java.net.SocketPermission "*", "connect";
  permission java.io.FilePermission "<<ALL FILES>>", "read, write";
  permission java.util.PropertyPermission "*", "read";

  //For J2SE Logging Source
  permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
  permission java.util.PropertyPermission "*", "read, write";
  permission java.util.logging.LoggingPermission "control";

};

5.20.2　アプリケーションのユーザログ出力例

ここでは，具体的な例を示して，J2EEアプリケーションのユーザログを出力するための設定について説明します。

＜この項の構成＞

(1)　ユーザログ出力で使用する例

(2)　ユーザログ出力の設定例

(1)　ユーザログ出力で使用する例

次に示す例を使用して，J2EEアプリケーションのユーザログ出力の設定について説明します。使用する例の概要を次の図に示します。

図5-1　J2EEアプリケーションのユーザログ出力例

A社では，ロガーの機能を使用して，業務履歴としてJ2EEアプリケーションの動作履歴をログファイルに出力します。A社のJ2EEアプリケーションのうち，動作履歴を出力したいJ2EEアプリケーションは「Application1」と「Application2」の2種類です。J2EEアプリケーションごとに，別々のファイルに異なるメッセージレベルのログを出力します。また，J2EEアプリケーション名のディレクトリを作成して，それぞれのログファイルを格納します。

(a)　「Application1」の特徴

「Application1」のロガー名称は「com.example.userlogger1」とします。

「Application1」は，複雑で規模の大きいJ2EEアプリケーションです。「SEVERE」レベルの重大なエラーが起こったときに，原因の切り分けを素早く行うために，JavaのExceptionのトレース情報を含むメッセージを「logfileA」に残しておきます。また，動作のトレースログとして「INFO」レベル以下のメッセージを「logfileB」に出力します。「com.example.userlogger1」からは，ログの出力レベルおよび出力内容に応じて2種類のログファイルを出力するために，「conf1」と「conf2」という2種類のCJMessageFileHandlerハンドラを作成しています。

「logfileA」の詳細

トレース情報を取得するため，「logfileA」への出力フォーマッタとして，「CJSimpleFormatter」を使用します。

「logfileA」は，「SEVERE」レベルのメッセージだけが出力されるため，それほど多くのファイル容量を必要としません。しかし，トレース情報を出力するので，1メッセージ当たりのレコードは大きく（最大約4,096バイト），10,000レコードを蓄積できるようにするためには約40メガバイトの容量が必要となります。このため，サイズは10メガバイト，面数は4とします。

「Application1」が出力したメッセージであることを判別するために，J2EEアプリケーション名を「my_app1」とします。

「logfileB」の詳細

「logfileB」は，「INFO」レベル以下のすべてのメッセージが出力されるため，多くのファイル容量を必要とします。1日当たりのメッセージ量と保存期間から算出したログディスク容量は約256メガバイトです。また，ファイルの最大面数は16であるため，サイズは16メガバイト，面数は16とします。

「Application1」が出力したメッセージであることを判別するために，J2EEアプリケーション名を「my_app1」とします。

(b)　「Application2」の特徴

「Application2」のロガー名称は「com.example.userlogger2」とします。

「Application2」は，ログメッセージの作りこみ品質が高く，規模が小さいJ2EEアプリケーションです。必要最小限のメッセージだけをログに出力するため，「WARNING」レベル以上のメッセージを「logfileC」に残します。「com.example.userlogger2」からは1種類のログファイルを出力するため，「conf3」というCJMessageFileHandlerハンドラを作成しています。

「logfileC」の詳細

「WARNING」レベルのメッセージだけが出力されます。また，1メッセージ当たりの最大長が約200バイトであるので，10,000レコードを蓄積するためには約2メガバイトの容量が必要となります。このため，サイズは1メガバイト，面数は2とします。

「Application2」が出力したメッセージであることを判別するために，J2EEアプリケーション名を「my_app2」とします。

(c)　デバッグ用の設定

開発中のデバッグ用の設定もしておきます。「com.example.userlogger1」と「com.example.userlogger2」へ送信されてきたすべてのメッセージの内容を表示するために，ロガー名称「com.example」のロガーへ，java.util.loggingの「ConsoleHandler」を接続しておきます。このロガーでは，子のロガーから伝播されるすべてのメッセージの内容を表示したいので，ロガーおよびハンドラのログ取得レベルは「ALL」とします。

(2)　ユーザログ出力の設定例

「(1)　ユーザログ出力で使用する例」で示した例でユーザログを出力する場合の設定例を次に示します。

(a)　簡易構築定義ファイルの設定例

簡易構築定義ファイルの設定例（物理ティアの定義の場合）を次に示します。

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
<!-- ロガーに渡されたログレコードを，親ロガーが使用しているハンドラに -->
<!-- 伝播させないようにします（ルートロガーがデフォルトで存在するため）。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.useParentHandlers</param-name>
   <param-value>false</param-value>
 </param>
<!-- 「logfileA」のJ2EEアプリケーション名，出力先，サイズ，面数，ログ取得レベル， -->
<!-- 使用するフォーマッタ名を指定します。 -->
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.appname</param-name>
   <param-value>my_app1</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.path</param-name>
   <param-value>application1/logfileA</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.limit</param-name>
   <param-value>10485760</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.count</param-name>
   <param-value>4</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.level</param-name>
   <param-value>SEVERE</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf1.formatter</param-name>
   <param-value>com.hitachi.software.ejb.application.userlog.CJSimpleFormatter</param-value>
 </param>

<!-- 「logfileB」のJ2EEアプリケーション名，出力先，サイズ，面数，ログ取得レベルを指定します。 -->
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf2.appname</param-name>
   <param-value>my_app1</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf2.path</param-name>
   <param-value>application1/logfileB</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf2.limit</param-name>
   <param-value>16777216</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf2.count</param-name>
   <param-value>16</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf2.level</param-name>
   <param-value>INFO</param-value>
 </param>

<!-- 「com.example.userlogger1」の使用するハンドラ名称「conf1」「conf2」の設定を使用して，-->
<!-- ファイルハンドラ（CJMessageFileHandler）を初期化して接続します。-->
<!-- ここで，ロガーとハンドラが作成されます。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger1.handlers</param-name>
   <param-value>com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf1,com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf2</param-value>
 </param>

<!-- 「com.example.userlogger1」のログ取得レベルを指定します。-->
<!-- 「conf1」「conf2」のレベルの高い方に合わせて，「INFO」とします。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger1.level</param-name>
   <param-value>INFO</param-value>
 </param>

<!-- 「logfileC」の出力先，ログ取得レベルを指定します。-->
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf3.appname</param-name>
   <param-value>my_app2</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf3.path</param-name>
   <param-value>application2/logfileC</param-value>
 </param>
 <param>
   <param-name>ejbserver.application.userlog.CJLogHandler.conf3.level</param-name>
   <param-value>WARNING</param-value>
 </param>

<!-- 「com.example.userlogger2」の使用するハンドラ名称「conf3」の設定を使用して，-->
<!-- ファイルハンドラ（CJMessageFileHandler）を初期化して接続します。-->
<!-- ここで，ロガーとハンドラが作成されます。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger2.handlers</param-name>
   <param-value>com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf3</param-value>
 </param>

<!-- 「com.example.userlogger2」のログ取得レベルを指定します。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger2.level</param-name>
   <param-value>WARNING</param-value>
 </param>

<!-- デバッグ用の設定をします************************************************-->
<!-- 「ConsoleHandler」のログ取得レベルを指定します。-->
 <param>
   <param-name>java.util.logging.ConsoleHandler.level</param-name>
   <param-value>INFO</param-value>
 </param>

<!-- 「com.example」のロガーで使用するハンドラ名称「ConsoleHandler」を指定して，-->
<!-- ハンドラに接続します。ここで，ロガーとハンドラが作成されます。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.handlers</param-name>
   <param-value>java.util.logging.ConsoleHandler</param-value>
 </param>

<!-- 「com.example」のロガーのログ取得レベルを指定します。-->
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.level</param-name>
   <param-value>ALL</param-value>
 </param>

<!-- デバッグが不要になった場合は，親のロガーへの伝播の設定を解除します。-->
<!--
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger1.useParentHandlers</param-name>
   <param-value>false</param-value>
 </param>
-->
<!--
 <param>
   <param-name>ejbserver.application.userlog.Logger.com.example.userlogger2.useParentHandlers</param-name>
   <param-value>false</param-value>
 </param>
-->
<!-- デバッグが不要になった場合は，「com.example」の作成を解除します。-->
<!--
 <param>
   <param-name>ejbserver.application.userlog.loggers</param-name>
   <param-value>com.example.userlogger1, com.example.userlogger2</param-value>
 </param>
-->
<!-- *************************************************************************-->

<!-- ロガーの使用を宣言します。-->
 <param>
   <param-name>ejbserver.application.userlog.loggers</param-name>
   <param-value>com.example,com.example.userlogger1,com.example.userlogger2</param-value>
 </param>
</configuration>

(b)　「Application1」の設定例

「Application1」のソースコード例を次に示します。

import java.util.logging.*;
import com.hitachi.software.ejb.application.userlog.*;

public class application1{

   static Logger logger = Logger.getLogger("com.example.userlogger1");

   public static void exec(){

       logger.log(
                  CJLogRecord.create(Level.INFO,
                  "application1 start.","AP1_10000-I"));

       try{

           throw new Exception("Exception1!");

       }
       catch(Exception ex){

           logger.log(
                      CJLogRecord.create(Level.SEVERE,
                      "Catch an exception!", ex, "AP1_10100-E"));

       }

       logger.log(
                  CJLogRecord.create(Level.INFO,
                  "application1 end.","AP1_10001-I"));

   }

}

application1/logfileA1.logの出力例を次に示します。

    yyyy/mm/dd hh:mm:ss.sss            pid      tid      message-id  message(LANG=ja)
0047 2003/12/06 19:51:32.265  my_app1   00EB7859 012A54F9 AP1_10100-E 2003/12/06
19:51:32|application1|exec|致命的|Catch an exception!|java.lang.Exception:
Exception1!|application1.exec(application1.java.18)|application1.main(application1.java.64)

application1/logfileB1.logの出力例を次に示します。

    yyyy/mm/dd hh:mm:ss.sss           pid      tid      message-id   message(LANG=ja)
0046 2003/12/06 19:51:32.250  my_app1  00EB7859 012A54F9 AP1_10000-I  application1 start.
0048 2003/12/06 19:51:32.265  my_app1  00EB7859 012A54F9 AP1_10100-E  Catch an exception!
0049 2003/12/06 19:51:32.265  my_app1  00EB7859 012A54F9 AP1_10001-I  application1 end.

コンソール画面の出力例を次に示します。

情報: application1 start.
2003/12/06 19:51:32 application1 exec
致命的: Catch an exception!
java.lang.Exception: Exception1!
       at application1.exec(application1.java:18)
       at application1.main(application1.java:64)
2003/12/06 19:51:32 application1 exec
情報: application1 end.

(c)　「Application2」の設定例

「Application2」のソースコード例を次に示します。

import java.util.logging.*;
import com.hitachi.software.ejb.application.userlog.*;

public class application2{

   static Logger logger = Logger.getLogger("com.example.userlogger2");

   public static void exec(){

       logger.log(
                  CJLogRecord.create(Level.INFO,
                  "application2 start.","AP2_20000-I"));

       try{

           throw new Exception("Exception2!");

       }
       catch(Exception ex){

           logger.log(
                       CJLogRecord.create(Level.SEVERE,
                      "Catch an exception!", ex, "AP2_20100-E"));

       }

       logger.log(
                  CJLogRecord.create(Level.INFO,
                  "application2 end.","AP2_20001-I"));

   }

}

application2/logfileC1.logの出力例を次に示します。

    yyyy/mm/dd hh:mm:ss.sss           pid      tid      message-id   message(LANG=ja)
0048 2003/12/06 19:51:32.265  my_app2  00EB7859 012A54F9 AP2_20100-E  Catch an exception!

(d)　「Application3」の設定例

さらに，「Application3」というJ2EEアプリケーションのログを「Application1」と同じログファイルに出力する場合の例を説明します。この場合，「Application3」は「Application1」と同じプロセス内（スレッドは異なっていてもよい）で同じロガー名称を使用してロガーを取得する必要があります。

「Application3」のソースコード例を次に示します。

import java.util.logging.*;
import com.hitachi.software.ejb.application.userlog.*;

public class application1{

   static Logger logger = Logger.getLogger("com.example.userlogger1");

   public static void exec(){

       logger.log(,
                  CJLogRecord.create(Level.INFO,
                  "application3 start.","my_app3","AP3_30000-I"));

       try{

           throw new Exception("Exception3!");

       }
       catch(Exception ex){

           logger.log(,
                      CJLogRecord.create(Level.SEVERE,
                      "Catch an exception!", ex, "my_app3","AP3_30100-E"));

       }

       logger.log(
                  CJLogRecord.create(Level.INFO,
                  "application3 end.","my_app3","AP3_30001-I"));

   }

}

application1/logfileB1.logの出力例を次に示します。

    yyyy/mm/dd hh:mm:ss.sss           pid      tid      message-id   message(LANG=ja)
0046 2003/12/06 19:51:32.250  my_app1  00EB7859 012A54F9 AP1_10000-I  application1 start.
0093 2003/12/06 19:51:32.265  my_app3  00EB7859 010CB027 AP3_30000-I  application3 start.
0095 2003/12/06 19:51:32.265  my_app1  00EB7859 012A54F9 AP1_10100-E  Catch an exception!

6.　システムの可用性を高める設定（J2EEアプリケーションを実行するシステム）

Cosminexusのシステムでは，システムの可用性を高めるために，障害によるシステムダウンを防止したり，障害発生時でも業務の継続を可能にしたりする機能を提供しています。

この章では，障害発生時のJ2EEサーバ間のHTTPセッションの引き継ぎの設定方法，およびManagementイベントによる処理の自動実行の設定方法について説明します。

＜この章の構成＞

6.1　システムの可用性を高める設定の概要

6.2　J2EEサーバ間のセッション情報の引き継ぎの設定

6.3　Managementイベントによる処理の自動実行の設定

6.1　システムの可用性を高める設定の概要

この節では，システムの可用性を高めるための設定の概要について説明します。

障害によるシステムダウンを防止したり，障害発生時でも業務の継続を可能にしたりするために，次の表に示すシステムの可用性を高めるための機能を使用します。

表6-1　システムの可用性を高める機能の概要

機能 | 説明 | 参照先
J2EEサーバ間のセッション情報の引き継ぎ | J2EEアプリケーションで実行中のHTTPセッションの情報を管理し，J2EEサーバで障害が発生した場合に管理しているセッション情報をほかのJ2EEサーバに引き継ぐことで，J2EEサーバで障害が発生しても障害発生前の状態で業務を続行できるようになります。 | 6.2
Managementイベントによる処理の自動実行 | サーバの障害やリソース枯渇などの事象をイベントとして通知させて，発生したイベントに対応する動作を定義しておくことで，障害を回避するための対処など，発生した事象に対する処理を自動的に実行できるようになります。 | 6.3

以降の節では，上記の機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

6.2　J2EEサーバ間のセッション情報の引き継ぎの設定

この節では，セッションフェイルオーバ機能を使用したシステムを構築する場合に必要となる設定について説明します。

セッションフェイルオーバ機能は，J2EEサーバ間のHTTPセッションの情報を引き継ぐための機能です。この機能を使用すると，J2EEアプリケーションで実行中のセッション情報が管理され，J2EEサーバで障害が発生したときにそのセッション情報をほかのJ2EEサーバに引き継ぐことができるようになります。これによって，J2EEサーバで障害が発生しても，障害発生前の状態で業務を続行できるようになります。機能の詳細については，マニュアル「Cosminexus　機能解説」のJ2EEサーバ間のセッション情報の引き継ぎに関する説明を参照してください。

注意

J2EEサーバ間のセッション情報の引き継ぎは負荷分散機の使用が前提となります。リダイレクタの負荷分散機能では，J2EEサーバ間のセッション情報の引き継ぎはできません。J2EEサーバ間のセッション情報を引き継ぐためには，このほかにも前提条件があります。前提条件については，マニュアル「Cosminexus　機能解説」のJ2EEサーバ間のセッション情報の引き継ぎに関する説明を参照してください。

＜この節の構成＞

6.2.1　J2EEサーバ間のセッション情報の引き継ぎの設定の概要

6.2.2　SFOサーバの設定

6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定

6.2.4　リクエストラインの最大サイズの設定

6.2.5　HTTPセッション数の上限値の設定

6.2.6　セッション情報の引き継ぎを行うWebアプリケーションの設定変更

6.2.7　Webアプリケーションの設定情報の削除

6.2.1　J2EEサーバ間のセッション情報の引き継ぎの設定の概要

J2EEサーバ間でHTTPセッションの情報を引き継ぐためには，セッションフェイルオーバ機能を使用する構成でシステムを構築する必要があります。

セッションフェイルオーバ機能を使用したシステムを構築する場合，SFOサーバ，およびJ2EEサーバの設定が必要です。また，必要に応じて，アプリケーション開発時に設定したWebアプリケーションのセッションフェイルオーバ機能の設定内容を変更します。

ここでは，SFOサーバ，J2EEサーバ，およびWebアプリケーションで設定する内容の概要について説明します。なお，セッションフェイルオーバ機能を使用するシステムの構成，および構築手順については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

SFOサーバの設定
SFOサーバとして使用するJ2EEサーバのセットアップが完了したあと，SFOサーバでは，次の設定をします。SFOサーバ設定は必ず実施してください。

SFOサーバの基本設定

SFOサーバの起動オプションの設定

注意

SFOサーバは既存のJ2EEサーバを使用しないで，新規にセットアップしてください。SFOサーバのセットアップ終了後，SFOサーバアプリケーションが自動的にインポートされます。

また，Management Server以外の機能（サーバ管理コマンドまたはServer Plug-in）を使用して，SFOサーバアプリケーションの起動，停止，削除などの操作をしないでください。Management Server以外の機能を使用して操作した場合の動作は保証されません。

J2EEサーバの設定
セッション情報の引き継ぎを行うJ2EEサーバでは，次の設定をします。J2EEサーバ設定は必ず実施してください。

グローバルセッション情報を格納するSFOサーバの設定

SFOサーバとの通信タイムアウトの設定

また，URL書き換えによってグローバルセッションを制御する場合に，インプロセスHTTPサーバを使用するときは，次の設定をしてください。

リクエストラインの最大サイズの設定

Webサーバの設定
URL書き換えによってグローバルセッションを制御する場合に，Webサーバとの連携機能を使用するときは，次の設定をしてください。

リクエストラインの最大サイズの設定

Webアプリケーションの設定
セッション情報の引き継ぎを行うWebアプリケーション※では，次の設定をします。Webアプリケーションの設定は必要に応じて実施してください。

HTTPセッション数の上限値の設定

Webアプリケーションの設定変更

注※　ここでは，J2EEアプリケーションに含まれるWebアプリケーションを意味します。

SFOサーバに登録したWebアプリケーションの設定情報を削除する方法については，「6.2.7　Webアプリケーションの設定情報の削除」を参照してください。

6.2.2　SFOサーバの設定

テキストエディタなどを使用して，Smart Composer機能の簡易構築定義ファイルを編集することで，SFOサーバとして使用するJ2EEサーバの動作設定を変更できます。SFOサーバが使用するネーミングサービス，PRFデーモン，ログ，セキュリティなどの基本設定や，SFOサーバのJavaVMの起動オプションの設定を変更する場合に，必要に応じて実施してください。

注意

CTMを使用している場合，CTMを使用したリクエストのスケジューリングを無効にする必要があります。論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.ctm.enabledで「true」が指定されている場合，「false」に変更してください。

＜この項の構成＞

(1)　SFOサーバの基本設定

(2)　SFOサーバの起動オプションの設定

(1)　SFOサーバの基本設定

SFOサーバの設定で編集できる簡易構築定義ファイルのパラメタを次の表に示します。なお，ここで説明していないパラメタは編集しないでください。

表6-2　SFOサーバの設定で編集できる簡易構築定義ファイルのパラメタ

分類
簡易構築定義ファイルのパラメタ
説明

CORBAネーミングサービス※1
ejbserver.naming.port
利用するCORBAネーミングサービスのポート番号を指定します。

EJBコンテナ※1
ejbserver.container.remove.scan.interval
Stateful Session Beanのタイムアウトやプールの状態を監視するスレッドの起動間隔を指定します。

Webサーバ※1

ejbserver.http.port

webserver.connector.http.permitted.hosts

webserver.connector.http.bind_host

簡易Webサーバのポート番号，簡易Webサーバへのアクセスを許可するホストや，簡易Webサーバで使用するホストを指定します。

webserver.connector.ajp13.port

webserver.connector.ajp13.bind_host

webserver.connector.ajp13.max_threads※2

Webサーバとの通信ポート番号や，Webサーバ連携で使用するホストを指定します。

PRFデーモン※1
ejbserver.server.prf.PRFID
利用するPRFデーモンを指定します。

リソース枯渇監視※1

ejbserver.watch.enabled

ejbserver.watch.memory.enabled

ejbserver.watch.memory.interval

ejbserver.watch.memory.threshold

ejbserver.watch.memory.writefile.enabled

ejbserver.watch.fileDescriptor.enabled※3

ejbserver.watch.fileDescriptor.interval※3

ejbserver.watch.fileDescriptor.threshold※3

ejbserver.watch.fileDescriptor.writefile.enabled※3

ejbserver.watch.thread.enabled

ejbserver.watch.thread.interval

ejbserver.watch.thread.threshold

ejbserver.watch.thread.writefile.enabled

ejbserver.watch.threaddump.enabled

ejbserver.watch.threaddump.interval

ejbserver.watch.threaddump.threshold

ejbserver.watch.threaddump.writefile.enabled

ejbserver.watch.defaultRequestQueue.enabled※4

ejbserver.watch.defaultRequestQueue.interval

ejbserver.watch.defaultRequestQueue.threshold

ejbserver.watch.defaultRequestQueue.writefile.enabled※4

リソース枯渇監視機能の使用の有無，リソースの監視間隔やしきい値を指定します。
リソース枯渇監視機能の設定については，「4.12　リソース枯渇監視の設定」を参照してください。

SFOサーバのログ※1

ejbserver.logger.enabled.*

ejbserver.logger.channels.define.＜チャネル名＞※5.filenum

ejbserver.logger.channels.define.＜チャネル名＞※5.filesize

ejbserver.logger.systemlog.enabled

SFOサーバのログのファイル面数，ファイルサイズや，ログレベルを指定します。また，SFOサーバのログのイベントログ（UNIXの場合，syslog）への出力の有無を指定します。

スレッドダンプ出力※1
ejbserver.server.threaddump.filenum
J2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合の
スレッドダンプのファイル数の上限を指定します。

Cosminexus TPBrokerのトレース

vbroker.orb.htc.comt.entryCount※1

vbroker.orb.htc.comt.fileCount※6

vbroker.orb.htc.tracePath※6

Cosminexus TPBrokerのトレースファイルの出力先，ファイル数や，エントリ数を指定します。

Cosminexus TPBrokerのオプション※1

vbroker.se.iiop_tp.host

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

EJBコンテナの通信ポート，およびIPアドレスを固定する場合に，任意の値を指定します。

注※1

簡易構築定義ファイルの，SFOサーバ用のユーザプロパティに設定します。

注※2

SFOサーバではWebアプリケーションでリクエストを処理することがないため，このパラメタに指定する値を小さくすることでSFOサーバが作成するスレッド数を減らすことができます。値に最小値「1」を設定することをお勧めします。

注※3

UNIXの場合に指定できるパラメタです。

注※4

SFOサーバではWebアプリケーションを実行しないため，HTTPリクエスト実行待ちキュー監視は不要です。値に「false」を設定して監視を無効にすることをお勧めします。

注※5

チャネル名には，種別ごとのチャネル名を指定します。

MessageLogFile，MaintenanceLogFile，ExceptionLogFile，ConsoleLogFile，EJBContainerLogFile，MemoryWatchLogFile，FileDescriptorWatchLogFile，ThreadWatchLogFile，RequestQueueWatchLogFile

注※6

簡易構築定義ファイルの，SFOサーバのJavaVMのシステムプロパティに設定します。

これらのパラメタは，簡易構築定義ファイルで，論理SFOサーバ（sfo-server）の<configuration>タグ内に定義します。簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(2)　SFOサーバの起動オプションの設定

SFOサーバでは，Webアプリケーションのグローバルセッション情報の冗長化を開始する前に，グローバルセッション情報を格納するために必要な領域を確保します。このとき確保したメモリは，Webアプリケーションのグローバルセッション情報の冗長化が終了するまで解放されないで，JavaVMのTenured領域に格納されます。

JavaVMでは，Tenured領域の使用状態や，New領域の最大値に対するTenured領域の空き容量などを基に，フルガーベージコレクションを発生させます。SFOサーバでは，フルガーベージコレクションの発生を防ぐために，Webアプリケーションのグローバルセッション情報の冗長化で使用するTenured領域メモリサイズや，SFOサーバが使用するTenured領域のメモリサイズなど，Tenured領域に格納されるオブジェクトのメモリサイズを基に，JavaVMのTenured領域，New領域のサイズをチューニングする必要があります。

JavaVMのTenured領域，New領域のサイズは，簡易構築定義ファイルの論理SFOサーバ（sfo-server）の<configuration>タグ内に，JavaVM起動パラメタで定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-Xmx（設定値）

-XX:NewRatio=（設定値）

注意

JavaVMの領域をチューニングする場合は，JavaVMのガーベージコレクションログを確認して，SFOサーバの運用でフルガーベージコレクションが発生しないことを確認してください。

Webアプリケーションのグローバルセッション情報の冗長化で使用するTenured領域のメモリサイズ，およびSFOサーバが使用するTenured領域のメモリサイズの見積もり式を次に示します。

Webアプリケーションのグローバルセッション情報の冗長化で使用するTenured領域のメモリサイズの見積もり式

A＝{(B＋500)×C×1.2÷(1,024×1,024)}＋D×5

（凡例）

A：Webアプリケーションのグローバルセッション情報の冗長化で使用するTenured領域のメモリサイズ（単位：メガバイト）

B：グローバルセッション情報の最大サイズ（単位：バイト）※1

C：HTTPセッション数の上限値※2

D：接続するJ2EEサーバの数

注※1

Webアプリケーションのフィルタ属性ファイルまたはDD（web.xml）のGSInfosLengthMaxパラメタに指定した値です。グローバルセッション情報の最大サイズの詳細については，「9.7.2(3)　グローバルセッション情報の最大サイズ」を参照してください。

注※2

WebアプリケーションのWAR属性ファイルの<http-session-max-number>タグに指定する値です。HTTPセッション数の上限値の詳細については，「6.2.5　HTTPセッション数の上限値の設定」を参照してください。

SFOサーバが使用するTenured領域のメモリサイズの見積もり式

SFOサーバが使用するTenured領域のメモリサイズ＝A＋50

（凡例）

A：各Webアプリケーションのグローバルセッション情報の冗長化で使用するTenured領域のメモリサイズの合計（単位：メガバイト）

6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定

セッション情報の引き継ぎを行うJ2EEサーバの設定方法について説明します。

セッション情報の引き継ぎを行うJ2EEサーバの設定では，簡易構築定義ファイルを編集して次に示す設定をします。

グローバルセッション情報を格納するSFOサーバの設定
セッション情報の引き継ぎを行うJ2EEサーバのグローバルセッション情報を格納するSFOサーバの名称，およびSFOサーバ用のCORBAネーミングサービスのIPアドレスを設定します。

SFOサーバとの通信タイムアウトの設定
J2EEサーバとSFOサーバとの通信タイムアウトを設定します。
J2EEサーバでは，SFOサーバの状態を監視するためのスレッド（SFOサーバ監視スレッド）を作成します。SFOサーバ監視スレッドは，SFOサーバアプリケーションで用意している，コネクションの状態監視用のビジネスメソッドを呼び出してSFOサーバのヘルスチェックを実施します。SFOサーバに障害が発生して停止した場合，コネクションの状態監視用のビジネスメソッドの呼び出しができなくなります。SFOサーバとの通信タイムアウトは，このような場合に，SFOサーバに障害が発生したと判断するために使用される時間です。このタイムアウト時間を超えると，J2EEサーバでは，SFOサーバは障害のため停止していると判断し，リトライを実行しません。

HTTPセッションのセッションIDへのサーバIDの付加
HTTPセッションのセッションIDにサーバIDを付加する機能を有効にして，HTTPセッションのセッションIDに付加するサーバIDを設定します。

グローバルセッション情報のサイズ見積もり機能の設定
開発環境で，グローバルセッション情報のサイズ見積もり機能を有効にして，Webサーブレットログに出力されるメッセージから，グローバルセッション情報のサイズを見積もります。見積もった値は，必要に応じてグローバルセッション情報の最大サイズに設定します。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

サーバIDのCookieの付加
HTTP Cookieによってグローバルセッションを制御する場合に，HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する機能を有効にして，付加するサーバIDのCookieの名称を設定します。

リクエストラインの最大サイズの設定
URL書き換えによってグローバルセッションを制御する場合に，リクエストラインの最大サイズを設定します。URL書き換えによってグローバルセッションを制御する場合，URLのパスパラメタには，HTTPセッションのセッションIDとグローバルセッションIDが含まれます。HTTPリクエストのリクエストラインのサイズには，上限があります。このため，あらかじめリクエストラインの最大サイズを算出して，それを基にリクエストラインの最大サイズを設定する必要があります。
なお，リクエストラインの最大サイズをJ2EEサーバに設定するのは，インプロセスHTTPサーバを使用している場合です。Hitachi Web ServerまたはMicrosoft IISを使用している場合は，それぞれのWebサーバに設定します。
設定値の考え方および各Webサーバへの設定方法については，「6.2.4　リクエストラインの最大サイズの設定」を参照してください。

注意

J2EEサーバ間でのセッション情報の引き継ぎを行うために編集した，簡易構築定義ファイルのパラメタに不正な値が指定されていたり，必要なパラメタの指定が不足していたりした場合，J2EEサーバの起動時ではなく，セッション情報の引き継ぎ時にエラーが発生し，セッション情報の引き継ぎを行うWebアプリケーションを開始できません。

セッション情報の引き継ぎに関連する簡易構築定義ファイルのパラメタを次の表に示します。

表6-3　セッション情報の引き継ぎに関連する簡易構築定義ファイルのパラメタ

分類
簡易構築定義ファイルのパラメタ
指定内容

グローバルセッション情報を格納するSFOサーバの設定※1
webserver.sfo.sfo_servers※2※3
HTTPセッションの情報の引き継ぎを行うJ2EEサーバのグローバルセッション情報を格納するSFOサーバの名称（SFOフィルタのサーバ定義名）を指定します。
複数のSFOサーバにグローバルセッション情報を格納する場合，すべてのSFOサーバの名称（SFOフィルタのサーバ定義名）を指定します。

webserver.sfo.sfo_servers.<SFOフィルタのサーバ定義名>.naming
webserver.sfo.sfo_serversパラメタに指定したSFOサーバで起動するCORBAネーミングサービスのIPアドレス（またはホスト名）およびポート番号を指定します。
複数のSFOサーバにグローバルセッション情報を格納する場合，それぞれのSFOサーバで起動するCORBAネーミングサービスのIPアドレス（またはホスト名）およびポート番号を指定します。

SFOサーバとの通信タイムアウトの設定※1※4
webserver.sfo.sfo_servers.<SFOフィルタのサーバ定義名>.connectionTimeout
J2EEサーバとSFOサーバとの通信タイムアウトを指定します。
複数のSFOサーバにグローバルセッション情報を格納する場合，それぞれのSFOサーバとの通信タイムアウトを指定します。

グローバルセッション情報のサイズ見積もり機能の設定※1
webserver.sfo.check_size.mode
グローバルセッション情報のサイズ見積もり機能を有効にするかどうかを指定します。開発環境でグローバルセッション情報のサイズ見積もり機能を使用する場合，「on」を指定します。また，グローバルセッション情報のサイズ見積もり機能を使用しない場合，省略または「off」を指定します。

セッションIDへのサーバIDの付加
webserver.session.server_id.enabled※5
HTTPセッションのセッションIDにサーバIDを付加するかどうかを指定します。J2EEサーバ間でHTTPセッションの情報の引き継ぎを行う場合，「true」を指定します。

webserver.session.server_id.value※1※6※7
HTTPセッションのセッションIDに付加するサーバIDを指定します。

サーバIDのCookieの付加
（HTTP Cookieを使用する場合）※1※8
webserver.container.server_id.enabled
HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加するかどうかを指定します。同一セッションのリクエストを，同一のWebコンテナに転送する場合，「true」を指定します。

webserver.container.server_id.name※9
HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する場合に，Cookieの名称を指定します。

webserver.container.server_id.value※7
HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する場合に，Cookieの値を指定します。

リクエストラインの最大サイズの設定
（URL書き換えを使用する場合）※1
webserver.connector.inprocess_http.limit.max_request_line※10
リクエストラインの最大サイズを設定します。

注※1

簡易構築定義ファイルの，J2EEサーバ用のユーザプロパティに設定します。

注※2

webserver.sfo.sfo_serversに指定するSFOサーバ名（SFOフィルタのサーバ定義名）とは，セッション情報の引き継ぎを行うJ2EEサーバとWebアプリケーション間でのSFOサーバの識別に使用する名称です。指定したSFOフィルタのサーバ定義名にSFOサーバ（論理サーバ）を関連づけて利用します。ここで指定したSFOフィルタのサーバ定義名は，セッション情報の引き継ぎを行うWebアプリケーションの設定で使用します。セッション情報の引き継ぎを行うWebアプリケーションの設定については，「6.2.6　セッション情報の引き継ぎを行うWebアプリケーションの設定変更」を参照してください。

なお，一つのSFOサーバに対して複数のSFOフィルタのサーバ定義名を指定できます。複数のSFOサーバを指定する場合，それぞれのSFOサーバに異なるSFOフィルタのサーバ定義名を指定してください。ただし，複数のSFOサーバに同一のSFOフィルタのサーバ定義名を指定することはできません。

注※3

複数のSFOサーバを指定する場合，一つ目に指定されたSFOサーバが，Webアプリケーションでの指定が省略された場合にデフォルトで使用するSFOサーバとなります。

注※4

J2EEサーバでは，SFOサーバの状態を監視するためのスレッド（SFOサーバ監視スレッド）を作成します。SFOサーバ監視スレッドは，SFOサーバアプリケーションで用意している，コネクションの状態監視用のビジネスメソッドを呼び出してSFOサーバのヘルスチェックを実施します。SFOサーバに障害が発生して停止した場合，コネクションの状態監視用のビジネスメソッドの呼び出しができなくなります。SFOサーバとの通信タイムアウトは，このような場合に，SFOサーバに障害が発生したと判断するために使用される時間です。このタイムアウト時間を超えると，J2EEサーバでは，SFOサーバは障害のため停止していると判断し，リトライを実行しません。

注※5

簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

注※6

HTTPセッションのセッションIDに設定するサーバIDは，各J2EEサーバに対して一意な値となるように設定してください。HTTPセッションのセッションIDに設定されるサーバIDが，ほかのJ2EEサーバのサーバIDと重複した場合，SFOサーバとのネゴシエーションに失敗し，セッション情報の引き継ぎを行うWebアプリケーションは開始できません。

注※7

webserver.session.server_id.valueおよびwebserver.container.server_id.valueのデフォルト値には，サーバ環境の情報が含まれます。この値はクライアントに送信されるため，サーバ環境の情報を含まない値を明示的に指定することをお勧めします。

注※8

新たに負荷分散機を導入して，Webコンテナの機能でCookieによるリクエストの振り分けをする場合，HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する機能を有効にして，付加するサーバIDのCookieの名称およびCookieの値を設定します。

既存のアプリケーションで負荷分散機用にCookieの情報を設定している場合などは設定不要です。

注※9

Cookieに設定するサーバIDは，サーブレットやJSPで設定するCookieの名称，およびWebコンテナが自動設定するCookieの名称「JSESSIONID」と重複しないように注意してください。

注※10

インプロセスHTTPサーバを使用している場合のパラメタです。

設定値の算出方法と，Hitachi Web ServerまたはMicrosoft IISを使用している場合の設定個所については，「6.2.4　リクエストラインの最大サイズの設定」を参照してください。

これらのパラメタは，使用する機能によって設定するかどうかが異なります。使用する機能ごとの簡易構築定義ファイルのパラメタの設定要否を次の表に示します。

表6-4　使用する機能ごとの簡易構築定義ファイルのパラメタの設定要否

簡易構築定義ファイルのパラメタ | 使用する機能
セッションフェイルオーバ機能の設定要否 | グローバルセッション情報のサイズ見積もり機能の設定要否
webserver.sfo.sfo_servers | 必須 | 無効※
webserver.sfo.sfo_servers.<SFOフィルタのサーバ定義名>.naming | 必須 | 無効※
webserver.sfo.sfo_servers.<SFOフィルタのサーバ定義名>.connectionTimeout | 任意 | 無効※
webserver.sfo.check_size.mode | 任意 | 必須
webserver.session.server_id.enabled | 任意 | 任意
webserver.session.server_id.value | 任意 | 任意
webserver.container.server_id.enabled | 任意 | 任意
webserver.container.server_id.name | 任意 | 任意
webserver.container.server_id.value | 任意 | 任意
webserver.connector.inprocess_http.limit.max_request_line | 任意 | 任意

（凡例）

必須：必ず指定することを示す。省略した場合はエラーとなり，SFOサーバ用アプリケーションを開始できない。

無効：指定しても無効になることを示す。設定した値は使用されない。

任意：省略できることを示す。省略した場合はデフォルトの値が設定される。

注※

パラメタに設定した値は読み込みまれません。このため，不正な値を設定した場合も検出されません。

これらのパラメタは，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に定義します。簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

セッション情報の引き継ぎに関連する簡易構築定義ファイルの指定例を次に示します。

 :
<tier>
 <tier-type>combined-tier</tier-type>
 <configuration>
   <logical-server-type>j2ee-server</logical-server-type>
   <param>
     <param-name>webserver.container.server_id.enabled</param-name>
     <param-value>true</param-value>
   </param>
   <param>
     <param-name>webserver.sfo.sfo_servers</param-name>
     <param-value>sfo_server1,sfo_server2</param-value>
   </param>
   <param>
     <param-name>webserver.sfo.sfo_servers.sfo_server1.naming</param-name>
     <param-value>host1:910</param-value>
   </param>
   <param>
     <param-name>webserver.sfo.sfo_servers.sfo_server1.connectionTimeout</param-name>
     <param-value>5</param-value>
   </param>
   <param>
     <param-name>webserver.sfo.sfo_servers.sfo_server2.naming</param-name>
     <param-value>host2:911</param-value>
   </param>
   <param>
     <param-name>webserver.sfo.sfo_servers.sfo_server2.connectionTimeout</param-name>
     <param-value>10</param-value>
   </param>
     :
 </configuration>
   :
</tier>
<tier>
 <tier-type>sfo-tier</tier-type>
 <configuration>
   <logical-server-type>sfo-server</logical-server-type>
   <param>
     :
 </configuration>
 <configuration>
   <logical-server-type>performance-tracer</logical-server-type>
   <param>
     :
 </configuration>
</tier>
 :

この記述例で設定される内容は，次のとおりです。

SFOサーバとして，「sfo_server1」および「sfo_server2」の二つを使用します。

Webアプリケーションにグローバルセッション情報を格納するSFOサーバを指定していない場合，デフォルトで「sfo_server1」を使用します。

「sfo_server1」の稼働ホストは「host1」であり，使用するCORBAネーミングサービスのポート番号は「910」です。

「sfo_server1」との通信タイムアウトを「5秒」に設定し，通信時間が5秒を超えた場合は「sfo_server1」で障害が発生したと判断します。

「sfo_server2」の稼働ホストは「host2」であり，使用するCORBAネーミングサービスのポート番号は「911」です。

「sfo_server2」との通信タイムアウトを「10秒」に設定し，通信時間が10秒を超えた場合は「sfo_server2」で障害が発生したと判断します。

6.2.4　リクエストラインの最大サイズの設定

URL書き換えによってグローバルセッションを制御する場合の，リクエストラインの最大サイズの設定について説明します。

URL書き換えによってグローバルセッションを制御する場合，URLのパスパラメタには，HTTPセッションのセッションIDとグローバルセッションIDが含まれます。HTTPリクエストのリクエストラインのサイズは，サーバ側およびクライアント側でそれぞれ上限があります。このため，あらかじめリクエストラインの最大サイズを算出して，それを基に，必要に応じてリクエストラインの最大サイズを設定してください。

ここでは，URL書き換えによってグローバルセッションを制御する場合のリクエストラインのサイズの算出方法と，リクエストラインのサイズの上限値を設定する方法について説明します。

＜この項の構成＞

(1)　URL書き換え使用時のリクエストラインのサイズの算出

(2)　リクエストラインの最大サイズの算出と設定

(1)　URL書き換え使用時のリクエストラインのサイズの算出

リクエストライン全体のサイズは，リクエストラインを構成する各項目のサイズを基に算出してください。

URL書き換えをする場合のリクエストラインの構成を次の図に示します。URL書き換えで使用するパスパラメタは，(d)と(e)に挿入されます。

図6-1　URL書き換えをする場合のリクエストラインの構成

リクエストラインを構成する各項目について説明します。(a)～(h)は図中の文字と対応しています。

表6-5　URL書き換えをする場合のリクエストラインを構成する項目

図中の文字
項目
説明
例

(a)
メソッド
リクエストのメソッドです。
GET
POST

(b)
スペース
区切りを示す空白文字です。
1バイト固定です。
△

(c)
リクエストパス
宛先を示すパスです。
http://www.host1:1234/example/test.jsp/example/test.jsp

(d)
HTTPセッションのセッションIDを示すパスパラメタ
URL書き換えによってURLに付加された，HTTPセッションのセッションIDを示すパスパラメタです。
;jsessionid=01234567aaaabbbbccccddddeeeeffffserver1

(e)
グローバルセッションIDを示すパスパラメタ
URL書き換えによってURLに付加された。グローバルセッションIDを示すパスパラメタです。
;gsessionid=0123456789abcdef01234567aaaabbbbccccddddeeeeffffserver1

(f)
クエリ
リクエストに付加されたクエリ文字列です。
?a=b&x=y

(g)
スペース
区切りを示す空白文字です。
1バイト固定です。
△

(h)
HTTPバージョン
HTTPのバージョンを示す文字列です。
HTTP/1.1

（凡例）

△：空白文字

なお，リクエストラインおよびURLの構成についての詳細は，RFC 2616およびRFC 2396のドキュメントを参照してください。

表6-5の内容のうち，URL書き換えによって付加される(d)と(e)のパスパラメタのサイズの算出方法について説明します。

(d)のHTTPセッションのセッションIDを示すパスパラメタのサイズの算出方法

HTTPセッションのセッションIDを示すパスパラメタのサイズ(バイト)
= ";jsessionid=" + <HTTPセッションのセッションID>
=12バイト ＋ <HTTPセッションのセッションIDのサイズ(バイト)>※

注※

HTTPセッションのセッションIDの文字列長については，マニュアル「Cosminexus　機能解説」のセッション管理に関する説明を参照してください。

(e)のグローバルセッションIDを示すパスパラメタのサイズの算出方法

グローバルセッションIDの送信に使用するパスパラメタの文字列長(バイト)
= ";" ＋ <グローバルセッションIDの送信に使用するパスパラメタ名のサイズ>
  ＋ "=" ＋ <グローバルセッションID>
= 1バイト ＋ <GIDURLParamNameパラメタに設定した文字列のサイズ(バイト)>
  ＋ 1バイト ＋ <グローバルセッションIDのサイズ(バイト)>※

注※

グローバルセッションIDのサイズ（バイト）は，次の式で算出してください。

グローバルセッションIDのサイズ(バイト)
= <HTTPセッションのセッションIDのサイズ(バイト)> ＋ 16バイト

(2)　リクエストラインの最大サイズの算出と設定

リクエストラインの最大サイズの設定方法について説明します。「(1)URL書き換え使用時のリクエストラインのサイズの算出」で算出した値を基に，最大サイズを設定してください。

設定方法は，使用するWebサーバによって異なります。

●Webサーバ連携でHitachi Web Serverを使用する場合

Hitachi Web Serverを使用する場合は，Hitachi Web Serverの定義ファイル（httpsd.conf）のLimitRequestLineディレクティブで設定します。デフォルトの設定では，8,190バイトです。

LimitRequestLineディレクティブの設定方法の詳細については，マニュアル「Hitachi Web Server」を参照してください。

●Webサーバ連携でMicrosoft IISを使用する場合

Microsoft IISを使用する場合のリクエストラインの最大サイズの設定方法については，Microsoft IISのドキュメントを参照してください。

●インプロセスHTTPサーバを使用する場合

インプロセスHTTPサーバを使用する場合，リクエストラインの最大サイズは，簡易構築定義ファイルで設定します。

パラメタ名は，webserver.connector.inprocess_http.limit.max_request_lineです。webserver.connector.inprocess_http.limit.max_request_lineの値には，リクエストラインの終端を示す改行文字である，(CR(0x0d)+LF(0x0A))の2バイトを含めた値を指定してください。デフォルトの設定では，8,190バイトです。

簡易構築定義ファイルの設定方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

6.2.5　HTTPセッション数の上限値の設定

セッション情報の引き継ぎを行うWebアプリケーションに対するHTTPセッション数の上限値の設定方法について説明します。

セッション情報の引き継ぎを行うWebアプリケーションには，HTTPセッション数の上限値に1以上の有効な値を設定する必要があります。

HTTPセッション数の上限値を設定するには，WAR属性ファイルの<http-session-max-number>タグを編集します。WAR属性ファイルはサーバ管理コマンドのcjgetapppropコマンドで取得します。また，WAR属性ファイル編集後の内容はcjsetapppropコマンドで反映させます。WAR属性ファイルおよびサーバ管理コマンドについては，マニュアル「Cosminexus　リファレンス　定義編」，またはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

なお，HTTPセッション数の上限値を超えてHttpSessionオブジェクトが生成されるとき，メッセージ（KDJE39225-E）がログに出力されます。KDJE39225-Eは，HTTPセッションを使用するリクエストが実行されるたびに出力されるため，同じメッセージでログが埋まってしまうおそれがあります。同じメッセージが繰り返し出力されるのを抑止するために，KDJE39225-Eのインターバル（出力間隔）を設定できます。必要に応じて，インターバルを設定してください。このインターバルはWebアプリケーション単位に適用されます。

KDJE39225-Eのインターバルを設定する場合，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.session.max.log_intervalパラメタを定義します。webserver.session.max.log_intervalパラメタは，簡易構築定義ファイルの，J2EEサーバのJavaVMのシステムプロパティに設定します。

簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注意

Webアプリケーションにセッションフェイルオーバ機能を適用している場合，HTTPセッション数の上限値の設定が必要です。HTTPセッション数の上限値を設定していない場合，セッション情報の引き継ぎを行うWebアプリケーションの開始時にエラーとなり，Webアプリケーションを開始できません。

ただし，グローバルセッション情報のサイズ見積もり機能を有効にする場合，セッションフェイルオーバ機能の前提条件であるHttpSessionオブジェクト数の上限値の指定は不要です。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

6.2.6　セッション情報の引き継ぎを行うWebアプリケーションの設定変更

セッション情報の引き継ぎを行うWebアプリケーションの設定を変更する方法について説明します。

ポイント

セッション情報の引き継ぎを行うWebアプリケーションを含むJ2EEアプリケーションの開始後にWebアプリケーションの設定を変更する場合，J2EEアプリケーションを再開始する前に，SFOサーバに登録されたWebアプリケーションの設定情報を削除する必要があります。SFOサーバに登録されたWebアプリケーションの設定情報の削除方法については，「6.2.7　Webアプリケーションの設定情報の削除」を参照してください。

参考

Webアプリケーションへのセッションフェイルオーバ機能の適用は，アプリケーション開発時に実行します。設定方法については，マニュアル「Cosminexus　機能解説」のセッションフェイルオーバ機能を使用するアプリケーションの実装に関する説明を参照してください。

セッション情報の引き継ぎを行うWebアプリケーションの設定では，Webアプリケーションにセッションフェイルオーバ用フィルタを追加して，セッション情報の引き継ぎに関する項目やフィルタマッピングを定義します。

フィルタの設定の詳細については，「9.7.1　サーブレットフィルタの組み込み」，および「9.7.2　セッションフェイルオーバ用フィルタの設定」を参照してください。

6.2.7　Webアプリケーションの設定情報の削除

セッション情報の引き継ぎを行うWebアプリケーションを含むJ2EEアプリケーションの開始時に，SFOサーバにWebアプリケーションの設定情報が登録されます。このため，J2EEアプリケーションの開始後にWebアプリケーションの設定を変更する場合，J2EEアプリケーションを再開始する前に，SFOサーバに登録されたWebアプリケーションの設定情報を削除する必要があります。

ここでは，Webアプリケーションの設定情報を削除するときの手順について説明します。

Webアプリケーションの設定情報の削除手順を次の図に示します。

図6-2　Webアプリケーションの設定情報の削除手順

図中の1.～5.について説明します。

設定を変更するWebアプリケーションを含むJ2EEアプリケーションをすべて停止します。
J2EEアプリケーションの停止方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

SFOサーバが配置されているサービスユニットを停止します。
サービスユニット内のSFOサーバも停止されます。サービスユニットの停止には，Smart Composer機能のコマンドを使用します。サービスユニットの停止方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

手順2で停止したサービスユニットを開始します。
サービスユニット内のSFOサーバも開始されます。SFOサーバの再開始によって，SFOサーバに登録されているWebアプリケーションの設定情報は，すべて削除されます。サービスユニットの開始には，Smart Composer機能のコマンドを使用します。サービスユニットの開始方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注意

SFOサーバを再開始すると，SFOサーバに冗長化されているグローバルセッション情報もすべて削除されるため注意が必要です。また，SFOサーバで複数のWebアプリケーションのグローバルセッション情報を冗長化している場合，すべてのWebアプリケーションの設定情報，およびグローバルセッション情報が削除されるため注意してください。

Webアプリケーションの設定を変更します。
セッション情報の引き継ぎを行うWebアプリケーションの設定の変更方法については，「6.2.6　セッション情報の引き継ぎを行うWebアプリケーションの設定変更」を参照してください。

Webアプリケーションの設定変更が完了したら，J2EEアプリケーションを再開始します。
J2EEアプリケーションの開始方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

6.3　Managementイベントによる処理の自動実行の設定

この節では，Managementイベントによる処理の自動実行を行うための設定方法について説明します。

Managementイベントは，運用管理ドメイン内のJ2EEサーバ，またはSFOサーバで発生する障害やリソース枯渇などの事象をManagement Serverに通知するためのイベントです。J2EEサーバとSFOサーバが稼働中に出力するすべてのメッセージを契機にしてManagementイベントを発行できます。Management Server側では，Managementイベントが通知されたときの動作を定義しておくことで，Managementイベントが発生すると自動的にアクションを実行できるようになります。このアクションをManagementアクションといいます。

例えば，リソース枯渇監視機能を使用してメモリの使用状態を監視している場合に，しきい値を超えたらアラートを発生させてメッセージを出力し，フルガーベージコレクションが発生する前に，Managementイベントを通知するようにします。また，J2EEサーバでサービスを閉塞して再起動するというManagementアクションを定義しておくことで，フルガーベージコレクションの予兆を検知し，自動的にアクションが実行されて，リクエスト処理の停止を回避できるようになります。

Managementイベントを使用して障害などの事象を検知し，Managementイベントに対応する動作をManagementアクションとして定義しておくことで，障害を回避するための対処など，発生した事象に対する処理を自動的に実行できるようになります。

＜この節の構成＞

6.3.1　Managementイベントによる処理の自動実行の設定手順

6.3.2　Managementイベント発行の設定

6.3.3　Managementイベント発行用メッセージIDリストファイルの設定

6.3.4　Managementイベント発行機能を利用する各機能の設定

6.3.5　Managementアクション実行用プロパティファイルの設定

6.3.6　Managementアクション実行コマンドの設定

6.3.1　Managementイベントによる処理の自動実行の設定手順

Managementイベントによる処理の自動実行の設定手順を次の図に示します。

図6-3　Managementイベントによる処理の自動実行の設定手順

図中の1.～5.について説明します。

Managementイベント発行の設定をします。
Managementイベントの発行を有効にして，Managementイベント発行時の動作を設定します。

Managementイベント発行用メッセージIDリストファイルを設定します。
リストファイルで，Managementイベント発行対象となるメッセージを指定します。

Managementイベント発行機能を利用する各機能の設定をします。
Managementイベント発行機能を利用して，Management ServerにManagementイベントを通知する機能の設定をします。
次に，設定したManagementイベントに対応するManagementアクションを実行するための設定をします。

Managementアクション実行用プロパティファイルを設定します。
プロパティファイルで，Managementアクションの定義，メッセージIDとManagementアクションとのマッピングなどをします。

Managementアクション実行コマンドの設定をします。
Managementアクションとして実行するコマンドを記述するコマンドファイル（バッチファイルまたはシェルスクリプトファイル）を作成します。

6.3.2　Managementイベント発行の設定

ここでは，Managementイベントを発行するために必要な次の設定について説明します。

Managementイベント発行の有効化

Managementイベント発行時の動作の設定

＜この項の構成＞

(1)　Managementイベント発行の有効化

(2)　Managementイベント発行時の動作の設定

(1)　Managementイベント発行の有効化

ManagementイベントはJ2EEサーバ，またはSFOサーバから発行できます。簡易構築定義ファイルで，Managementイベントの発行を有効にする設定をします。

J2EEサーバの場合
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.manager.agent.MEventAgent.enabledパラメタで「true」を指定して，Managementイベントの発行を有効にします。

SFOサーバの場合
簡易構築定義ファイルの論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.manager.agent.MEventAgent.enabledパラメタで「true」を指定して，Managementイベントの発行を有効にします。

(2)　Managementイベント発行時の動作の設定

簡易構築定義ファイルで，Managementイベント発行時の動作を設定します。論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，次のパラメタを設定してください。

manager.mevent.send.timeout
Managementイベントの送信タイムアウトの時間（秒）を指定します。

manager.mevent.retry.limit
Managementイベントの再送期限を指定します。

manager.mevent.retry.interval
Managementイベントの再送間隔（秒）を指定します。

manager.mevent.send.max
Managementイベントの同時発行最大数を指定します。

manager.mevent.message_id.list
メッセージIDリストファイルのパスを指定します。

manager.mevent.sender.bind.host
ローカルアドレスの固定の有無を指定します。

6.3.3　Managementイベント発行用メッセージIDリストファイルの設定

Managementイベントを発行したいメッセージのメッセージIDは，Managementイベント発行用メッセージIDリストファイルに記述します。Managementイベント発行用メッセージIDリストファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　ファイルの指定内容

(2)　ファイルの格納場所

(3)　ファイルの作成例

(1)　ファイルの指定内容

Managementイベント発行用メッセージIDリストファイルに，Managementイベントを発行したいメッセージのメッセージIDを記述してください。

なお，Managementイベントを発行できるのは，J2EEサーバとSFOサーバが稼働中に出力するメッセージです。起動処理中，停止処理中のメッセージおよびユーザログは，Managementイベント発行の対象外です。

Managementイベント発行用メッセージIDリストファイルの設定を省略すると，デフォルトのメッセージIDでManagementイベントを発行します。デフォルトの設定のままで利用する場合には，Managementイベント発行用メッセージIDリストファイルは設定不要です。デフォルトのメッセージIDについては，Managementイベント発行用メッセージIDリストファイルの説明を参照してください。Managementイベント発行用メッセージIDリストファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　ファイルの格納場所

Managementイベント発行用メッセージIDリストファイルのサンプルは，次の場所に格納されています。サンプルのファイルをコピーして，リストファイルを作成してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥mevent.midlist.conf

UNIXの場合
/opt/Cosminexus/manager/config/templates/mevent.midlist.conf

作成したリストファイルのパスは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，manager.mevent.message_id.listパラメタでリストファイルのパスを指定してください。

(3)　ファイルの作成例

Managementイベント発行用メッセージIDリストファイルの作成例を次に示します。

# Monitoring of resources
# : Status of memory(Java Heap)
KDJE34500-W

# : Number of file descriptors
KDJE34520-W

# : Number of threads
KDJE34540-W
# : Number of thread dump files
-KDJE34580-W
KDJE34581-E

# : Number of HTTP requests in queue
-KDJE34621-W

# : Number of HTTP sessions
KDJE34640-W

# : Status of connection pool
-KDJE34660-W
KDJE34661-W

# Monitoring of execution time of user program
KDJE52702-W
KDJE52703-W
KDJE52705-W
KDJE52713-E

メッセージIDの前に「+」を記述した場合，そのメッセージはManagementイベントを発行します。「-」を記述した場合，そのメッセージはManagementイベントを発行しません。「+」または「-」を省略した場合，そのメッセージはManagementイベントを発行します。

6.3.4　Managementイベント発行機能を利用する各機能の設定

Managementイベントを発行する機能の設定をしてください。

ここでは，例として，次の機能でManagementイベントを発行させるために必要な設定について説明します。

リソース枯渇監視機能

J2EEアプリケーション実行時間の監視機能

＜この項の構成＞

(1)　リソース枯渇監視の設定

(2)　J2EEアプリケーション実行時間の監視の設定

(1)　リソース枯渇監視の設定

リソースの監視間隔やしきい値を指定してリソースを監視し，しきい値を超えた場合にManagementイベントが発行されるように設定します。

J2EEサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプ，HTTPリクエスト実行待ちキュー，セッション数，コネクションプールです。SFOサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプです。なお，Windows，AIXでは，ファイルディスクリプタは監視できません。また，Linuxではスレッド数を監視できません。

リソース枯渇監視機能を使用するためには，次の二つの設定が必要です。

リソース枯渇監視機能の有効化

リソース種別ごとのManagementイベント発行の設定

(a)　リソース枯渇監視機能の有効化

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.watch.enabledパラメタでリソース枯渇監視機能を使用するかどうかを指定します。デフォルトの設定では，リソース枯渇監視機能の使用が有効になっていて，すべてのリソースが監視されるようになっています。

(b)　リソース種別ごとのManagementイベント発行の設定

デフォルトの設定では，監視対象となるすべてのリソースにデフォルトのしきい値が設定されていて，そのしきい値を超えた場合にManagementイベントが発行されるようになっています。Managementイベント発行の設定を変更したい場合には，次の方法で設定を変更してください。

次に示すリソースについては，簡易構築定義ファイルで，各リソースの監視の設定やリソースの監視によるManagementイベント発行の有無などを指定します。

メモリ

ファイルディスクリプタ

スレッド数

スレッドダンプ

HTTPリクエスト実行待ちキュー（デフォルトの実行待ちキューの場合）

次に示すリソースについては，サーバ管理コマンドを使用して，J2EEアプリケーション単位またはリソースアダプタ単位で，各リソースの監視の設定やリソースの監視によるManagementイベント発行の有無などを指定します。

HTTPリクエスト実行待ちキュー（Webアプリケーションごとの実行待ちキューの場合）

セッション数

コネクションプール

ただし，リソース枯渇監視ログファイルの面数とサイズは，簡易構築定義ファイルで指定します。

リソース種別ごとのManagementイベント発行の設定を次の表に示します。

表6-6　リソース種別ごとのManagementイベント発行の設定

リソース種別
設定個所
設定内容

メモリ
簡易構築定義ファイル
J2EEサーバ単位またはSFOサーバ単位で，次のパラメタに，メモリ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。※1

ejbserver.watch.memory.enabled

ejbserver.watch.memory.threshold

ejbserver.watch.memory.writefile.enabled

ejbserver.watch.memory.interval

ファイルディスクリプタ
J2EEサーバ単位またはSFOサーバ単位で，次のパラメタに，ファイルディスクリプタ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.fileDescriptor.enabled

ejbserver.watch.fileDescriptor.threshold

ejbserver.watch.fileDescriptor.writefile.enabled

ejbserver.watch.fileDescriptor.interval

スレッド数
J2EEサーバ単位またはSFOサーバ単位で，次のパラメタに，スレッド数監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.thread.enabled

ejbserver.watch.thread.threshold

ejbserver.watch.thread.writefile.enabled

ejbserver.watch.thread.interval

スレッドダンプ
J2EEサーバ単位またはSFOサーバ単位で，次のパラメタに，スレッドダンプ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.threaddump.enabled

ejbserver.server.threaddump.filenum

ejbserver.watch.threaddump.threshold

ejbserver.watch.threaddump.writefile.enabled

ejbserver.watch.threaddump.interval

HTTPリクエスト実行待ちキュー
簡易構築定義ファイル
J2EEサーバ単位で，次のパラメタに，デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.defaultRequestQueue.enabled

ejbserver.watch.defaultRequestQueue.threshold

ejbserver.watch.defaultRequestQueue.writefile.enabled

ejbserver.watch.defaultRequestQueue.interval

サーバ管理コマンド
J2EEアプリケーション単位で，Webアプリケーションごとの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視の設定をします。
WAR属性ファイルの<thread-control>タグの<resource-watcher>タグ下にある<watcher-enabled>，<watcher-threshold>，<watcher-interval>，<watcher-writefile-enabled>タグで，HTTPリクエスト実行待ちキュー監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetapppropコマンドでWAR属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。

セッション数
サーバ管理コマンド
J2EEアプリケーション単位で，セッション数監視の設定をします。
WAR属性ファイルの<http-session>タグの<resource-watcher>タグ下にある<watcher-enabled>，<watcher-threshold>，<watcher-interval>，<watcher-writefile-enabled>タグで，セッション数監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetapppropコマンドでWAR属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。

簡易構築定義ファイル
J2EEサーバ単位で，次のパラメタに，リソース枯渇監視ログファイルの面数，サイズを指定します。

ejbserver.logger.channels.define.<チャネル名>※2.filenum

ejbserver.logger.channels.define.<チャネル名>※2.filesize

コネクションプール
サーバ管理コマンド
リソースアダプタ単位で，コネクションプール監視の設定をします。
Connector属性ファイルの<property-name>タグとして指定する<WatchEnabled>，<WatchThreshold>，<WatchInterval>，<WatchWriteFileEnabled>タグで，コネクションプール監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させてください。※3

簡易構築定義ファイル
J2EEサーバ単位で，次のパラメタに，リソース枯渇監視ログファイルの面数，サイズを指定します。

ejbserver.logger.channels.define.<チャネル名>※2.filenum

ejbserver.logger.channels.define.<チャネル名>※2.filesize

注※1　メモリ監視をする場合は，論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタには，-XX:PermSizeと-XX:MaxPermSizeを指定し，メモリサイズは同じにすることをお勧めします。メモリサイズに異なる値を指定した場合，Permanent領域の領域拡張でもアラートが出力されることがあります。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:PermSize=（設定値）

-XX:MaxPermSize=（設定値）

また，フルガーベージコレクションの予兆検知をするためには，JavaVMのTenured領域，New領域のサイズをチューニングする必要があります。

注※2　リソース種別ごとのチャネル名を次に示します。

メモリの場合：MemoryWatchLogFile

ファイルディスクリプタの場合：FileDescriptorWatchLogFile

スレッド数の場合：ThreadWatchLogFile

スレッドダンプの場合：ThreaddumpWatchLogFile

HTTPリクエスト実行待ちキューの場合：RequestQueueWatchLogFile

セッション数の場合：HttpSessionWatchLogFile

コネクションプールの場合：ConnectionPoolWatchLogFile

注※3　リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

(2)　J2EEアプリケーション実行時間の監視の設定

J2EEアプリケーション実行時間の監視とは，EJBおよびWebアプリケーションのリクエスト実行時間を監視する機能です。J2EEアプリケーション実行時間の監視機能によって，J2EEアプリケーションで無限ループなどの障害発生を検知すると，一定時間内に終了しなかったメソッド処理をタイムアウトしてユーザに通知し，さらにメソッドキャンセル機能によって使用中のトランザクションの強制決着とメソッドのキャンセルを実施できます。

リクエストの実行時間を監視して，無限ループなどの障害が発生した場合にManagementイベントが発行されるようにします。次に示す設定をしてください。

J2EEサーバ単位での設定

J2EEアプリケーション単位での設定

なお，メソッドタイムアウト機能の対象となる，Webアプリケーションのリクエスト処理やEJBのメソッド呼び出し処理にもタイムアウトを設定します。設定方法については，マニュアル「Cosminexus　機能解説」のJ2EEアプリケーション実行時間の監視機能の実装に関する説明を参照してください。

(a)　J2EEサーバ単位での設定

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.ext.method_observation.intervalパラメタで，J2EEアプリケーション実行時間の監視機能を使用するかどうか，および動作中のリクエスト処理がタイムアウトしていないか調査する時間間隔を指定します。

(b)　J2EEアプリケーション単位での設定

J2EEアプリケーションの属性ファイルで，メソッドタイムアウトの時間と，メソッドキャンセルのモードを設定します。サーバ管理コマンドのcjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容を反映させます。

メソッドタイムアウトの時間の設定

EJB単位での設定

SessionBean属性ファイル，EntityBean属性ファイル，MessageDrivenBean属性ファイルの<ejb-method-observation-timeout>タグで，メソッドタイムアウトの時間を指定します。

Webアプリケーション単位での設定

Servlet属性ファイルの<method-observation-timeout>タグで，サーブレット内のメソッド共通のメソッドタイムアウトの時間を指定します。

メソッドキャンセルのモードの設定
アプリケーション属性ファイルの<method-observation-recovery-mode>タグで，メソッドキャンセルのモードを指定します。

6.3.5　Managementアクション実行用プロパティファイルの設定

Managementアクションの定義，メッセージIDとManagementアクションとのマッピングなどは，Managementアクション実行用プロパティファイル（maction.properties）に定義します。maction.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　ファイルの格納場所

(2)　ファイルの設定例

(3)　注意事項

(1)　ファイルの格納場所

maction.propertiesの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥maction.properties

UNIXの場合
/opt/Cosminexus/manager/config/maction.properties

(2)　ファイルの設定例

Windowsの場合のManagementアクション実行用プロパティファイルの設定例を次に示します。

# Managementアクションの定義
maction.restart.command=c¥:¥¥tmp¥¥command1.bat
maction.restart.timeout=12
maction.restart.timeout.forced_stop=true
maction.restart.exclusive_time=60
maction.restart.max_executable_actions=1

# メッセージIDとManagementアクションのマッピング
maction.message.KDJE11111-E.mactions=restart
maction.message.KDJE22222-E.mactions=restart

# 論理サーバとManagementアクションのマッピング
maction.server.j2ee1.mactions=restart
maction.server.j2ee2.mactions=restart
maction.server.j2eeClstr1.mactions=restart

この設定例では，Managementアクションを識別するID（ManagementアクションID）として，「restart」を定義しています。「restart」のManagementアクションの動作および設定について説明します。

Managementアクション実行コマンドとして「command1.bat」というコマンドファイルを実行します。

Managementアクション実行コマンドのタイムアウトは，「12」秒とします。

Managementアクション実行コマンドのタイムアウトが発生すると，コマンドを強制終了します。

Managementアクションの抑止時間は「60」秒，Managementアクションの同時実行数は，「1」とします。※

J2EEサーバ「j2ee1」，「j2ee2」および「j2eeClstr1」から，メッセージ「KDJE11111-E」と「KDJE22222-E」が出力された場合に，このManagementアクションを実行します。

注※

Managementアクションは，ManagementアクションIDで区別され，複数のサーバや異なるメッセージIDに対して同一のManagementアクションを実行できます。抑止時間や同時実行数を設定してManagementアクションの実行を制御することで，Managementアクションの集約や重複実行の抑止ができます。実行制御については，マニュアル「Cosminexus　機能解説」のManagementアクションの実行制御を参照してください。

(3)　注意事項

Managementアクション実行用プロパティファイルに関する注意事項を次に示します。

プロパティの優先順位
次に示すキーで指定する論理サーバやクラスタには，「J2EEサーバ ＜ J2EEサーバクラスタ ＜ サービスユニット ＜ 物理ティア」という包含関係があります。

maction.server.<論理サーバ名>.mactions

maction.unit.<Webシステム名>.<サービスユニット名>.mactions

maction.tier.<Webシステム名>.<物理ティア種別名>.mactions

このため，J2EEサーバクラスタとそのJ2EEサーバクラスタの構成要素となるJ2EEサーバのように，包含関係を持つ論理サーバそれぞれに対して別々のManagementアクションを定義した場合，次に示す優先順位で，どれか一つのManagementアクションを実行します。

Managementイベントを発行したJ2EEサーバ

Managementイベントを発行したJ2EEサーバを含むJ2EEサーバクラスタ

Managementイベントを発行したJ2EEサーバを含むサービスユニット

Managementイベントを発行したJ2EEサーバを含む物理ティア

なお，Webシステム，サービスユニットや物理ティアは，Smart Composer機能を使用してシステムを構築する場合の概念です。Smart Composer機能については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

Managementアクションの指定順序
次に示す二つのキーでManagementアクションの指定順序が異なる場合は，maction.message.<メッセージID>.mactionsキーでの指定順序を優先します。

maction.message.<メッセージID>.mactions
メッセージIDとManagementアクションとをマッピングするキーです。

maction.server.<論理サーバ名>.mactions
論理サーバとManagementアクションとをマッピングするキーです。

（例）

この例では，「act1」が優先されます。

maction.message.KDJE99999-E.mactions=act1,act2

maction.server.J2EE01.mactions=act3,act2,act1

6.3.6　Managementアクション実行コマンドの設定

Managementアクションとして実行するコマンドは，コマンドファイル（バッチファイルまたはシェルスクリプトファイル）に記述できます。必要に応じて，コマンドファイルを作成してください。

ここでは，コマンドファイルで使用できる環境変数と，コマンドファイルのサンプルについて説明します。

＜この項の構成＞

(1)　コマンドファイルで使用できる環境変数

(2)　コマンドファイルのサンプル

(3)　Managementアクション実行コマンドの動作

(1)　コマンドファイルで使用できる環境変数

コマンドファイルでは，次の表に示す環境変数を使用できます。

表6-7　Managementアクション実行コマンドのコマンドファイルで使用できる環境変数

環境変数
説明

COSMI_MNG_MACT_LSNAME
Managementイベントを発行した論理サーバ名。

COSMI_MNG_MACT_HOST
Managementイベントを発行した論理サーバのホスト名。

COSMI_MNG_MACT_MSG_ID
Managementイベントで通知されたメッセージID。

COSMI_MNG_MACT_MSG_TEXT
Managementイベントで通知されたメッセージテキスト。

COSMI_MNG_MACT_CTM
Managementイベントを発行した論理サーバに設定された論理CTM名。

COSMI_MNG_MACT_WEBSYSTEM
Managementイベントを発行した論理サーバが所属するWebシステム名。

COSMI_MNG_MACT_UNIT
Managementイベントを発行した論理サーバが所属するサービスユニット名。

COSMI_MNG_MACT_TIER
Managementイベントを発行した論理サーバが所属する物理ティア種別。

COSMI_MNG_MACT_OPT<N>
Managementイベントで通知されたオプション文字列。オプション文字列としてメッセージの埋め字が使用されます。Nは，0以上の整数であり，オプション文字列の1番目を表す環境変数は「COSMI_MNG_MACT_OPT0」となります。
設定される文字列の詳細については，Managementイベント発行の対象となるメッセージのメッセージテキスト中の可変値に表示される情報を参照してください。

COSMI_MNG_MACT_MNGSVR_PORT
Management ServerのHTTPポート番号。

COSMI_MNG_MACT_RNAME
Managementイベントを発行した論理サーバの実サーバ名。

COSMI_MNG_MACT_NS_HOSTPORT
Managementイベントを発行した論理サーバが使用するネーミングサービスのホスト名とポート番号。例えば，ホスト名が「HostA」でポート番号が「900」の場合には，「HostA:900」となります。

(2)　コマンドファイルのサンプル

コマンドファイルのサンプルが提供されていますので，サンプルを参考にしてコマンドファイルを作成してください。サンプルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥examples¥maction

UNIXの場合
/opt/Cosminexus/manager/examples/maction

なお，サンプルを使用する場合は，mngsvrutilコマンドの引数（-m，-u，-pオプションなど）やログファイルの格納先を環境に合わせて適宜変更してください。

(a)　Managementイベント発行サーバを再起動するサンプル

サンプルのファイル名

Windowsの場合：mActionSample_restartServer.bat

UNIXの場合：mActionSample_restartServer.sh

サンプルの動作

Managementイベントを発行した論理サーバを再起動します。

このサンプルは，リソース枯渇監視機能でManagementイベントを発行する場合に使用できます。

リソース枯渇監視機能では，JavaVMでのメモリの使用状況を監視し，設定されているしきい値を超えて，フルガーベージコレクションが発生しそうな場合にメッセージを出力します。

Managementイベント発行機能は，出力されたメッセージに対応したManagementイベントを発行したあとManagementアクションを実行し，Managementイベントを発行したJ2EEサーバを再起動します。

Managementイベントを発行したJ2EEサーバを停止することで，J2EEアプリケーションを閉塞できます。また，J2EEサーバがCTMによってリクエストを負荷分散させている場合は，J2EEサーバを停止することで，新規リクエストをほかのJ2EEサーバに分散できます。

Managementイベント発行サーバを再起動するサンプルを次に示します。

Windowsの場合

　　　（省略）
　　　　：
rem Management action sample for restart server.

setlocal

set LSNAME=%COSMI_MNG_MACT_LSNAME%
set MSGID=%COSMI_MNG_MACT_MSG_ID%

set CJCLDELLOG=%COSMINEXUS_HOME%¥CC¥client¥bin¥cjcldellog.bat
set LOG_ROOT_DIR=%SystemDrive%¥<MyLogDir>
if not exist "%LOG_ROOT_DIR%" mkdir "%LOG_ROOT_DIR%"
call "%CJCLDELLOG%" -t 30d -f "%LOG_ROOT_DIR%"
set LOG_DIR=%LOG_ROOT_DIR%¥%date:/=%
if not exist "%LOG_DIR%" mkdir "%LOG_DIR%"
set LOG=%LOG_DIR%¥%time::=%_%LSNAME%_%MSGID%.txt

echo %0 > "%LOG%"

set MNGSVR=localhost:%COSMI_MNG_MACT_MNGSVR_PORT%
set UID=<User-id>
set PWD=<Password>

echo mngsvrutil.exe -m %MNGSVR% -u %UID% -p %PWD% -t %LSNAME% -s stop server >> "%LOG%" 2>&1
mngsvrutil.exe -m %MNGSVR% -u %UID% -p %PWD% -t %LSNAME% -s stop server >> "%LOG%" 2>&1
set RET=%ERRORLEVEL%
echo %RET% >> "%LOG%"

if not %RET% == 0 goto END
echo mngsvrutil.exe -m %MNGSVR% -u %UID% -p %PWD% -t %LSNAME% -s start server >> "%LOG%" 2>&1
mngsvrutil.exe -m %MNGSVR% -u %UID% -p %PWD% -t %LSNAME% -s start server >> "%LOG%" 2>&1
set RET=%ERRORLEVEL%
echo %RET% >> "%LOG%"

:END
exit %RET%

UNIXの場合

　　　（省略）
　　　　：
# Management action sample for restart server.

LSNAME=${COSMI_MNG_MACT_LSNAME}
MSGID=${COSMI_MNG_MACT_MSG_ID}

LOG_ROOT_DIR=/tmp/<MyLogDir>
if [ ! -d ${LOG_ROOT_DIR} ]; then
 /bin/mkdir ${LOG_ROOT_DIR}
fi
/usr/bin/find ${LOG_ROOT_DIR} -depth -mtime +30 -mindepth 1 -exec /bin/rm -fr {} ¥;
LOG_DIR=${LOG_ROOT_DIR}/`/bin/date +%y%m%d`
if [ ! -d ${LOG_DIR} ]; then
 /bin/mkdir ${LOG_DIR}
fi
LOG=${LOG_DIR}/`/bin/date +%H%M%S`_${LSNAME}_${MSGID}.txt

echo $0 > "${LOG}"

MNGSVR=localhost:${COSMI_MNG_MACT_MNGSVR_PORT}
USERID=<User-id>
PASSWD=<Password>

echo ./mngsvrutil -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -t ${LSNAME} -s stop server >> "${LOG}" 2>&1
./mngsvrutil -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -t ${LSNAME} -s stop server >> "${LOG}" 2>&1
RET=$?
echo ${RET} >> "${LOG}"

if [ $RET -eq 0 ]; then
 echo ./mngsvrutil -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -t ${LSNAME} -s start server >> "${LOG}" 2>&1
 ./mngsvrutil -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -t ${LSNAME} -s start server >> "${LOG}" 2>&1
 RET=$?
 echo ${RET} >> "${LOG}"
fi

exit ${RET}

(b)　Managementイベント発行サーバの所属サービスユニットを閉塞するサンプル

Managementイベント発行サーバの所属サービスユニットを閉塞するサンプルが提供されていますので，サンプルを参考にして作成してください。サンプルのファイル名と動作を次に示します。

サンプルのファイル名

Windowsの場合：mActionSample_closeUnit.bat

UNIXの場合：mActionSample_closeUnit.sh

サンプルの動作

サービスユニットに所属するJ2EEサーバにリソース枯渇などの障害が発生した場合に，Managementイベントを発行したサーバを閉塞します。

Managementイベント発行サーバの所属サービスユニットを閉塞するサンプルを次に示します。

Windowsの場合

　　　（省略）
　　　　：
rem Management action sample for close unit.

setlocal

set LSNAME=%COSMI_MNG_MACT_LSNAME%
set MSGID=%COSMI_MNG_MACT_MSG_ID%
set WEBSYSTEM=%COSMI_MNG_MACT_WEBSYSTEM%
set UNIT=%COSMI_MNG_MACT_UNIT%

set CJCLDELLOG=%COSMINEXUS_HOME%¥CC¥client¥bin¥cjcldellog.bat
set LOG_ROOT_DIR=%SystemDrive%¥<MyLogDir>
if not exist "%LOG_ROOT_DIR%" mkdir "%LOG_ROOT_DIR%"
call "%CJCLDELLOG%" -t 30d -f "%LOG_ROOT_DIR%"
set LOG_DIR=%LOG_ROOT_DIR%¥%date:/=%
if not exist "%LOG_DIR%" mkdir "%LOG_DIR%"
set LOG=%LOG_DIR%¥%time::=%_%LSNAME%_%MSGID%.txt

echo %0 > "%LOG%"

if "%WEBSYSTEM%" == "" goto :ERR
if "%UNIT%" == "" goto :ERR

set MNGSVR=localhost:%COSMI_MNG_MACT_MNGSVR_PORT%
set UID=<User-id>
set PWD=<Password>

echo cmx_stop_target.exe -m %MNGSVR% -u %UID% -p %PWD% -mode ALL -s %WEBSYSTEM% -unit %UNIT% >> "%LOG%" 2>&1
cmx_stop_target.exe -m %MNGSVR% -u %UID% -p %PWD% -mode ALL -s %WEBSYSTEM% -unit %UNIT% >> "%LOG%" 2>&1
set RET=%ERRORLEVEL%
echo %RET% >> "%LOG%"
goto :END

:ERR
set RET=2

:END
exit %RET%

UNIXの場合

　　　（省略）
　　　　：
# Management action sample for close unit.

LSNAME=${COSMI_MNG_MACT_LSNAME}
MSGID=${COSMI_MNG_MACT_MSG_ID}
WEBSYSTEM=${COSMI_MNG_MACT_WEBSYSTEM}
UNIT=${COSMI_MNG_MACT_UNIT}

LOG_ROOT_DIR=/tmp/<MyLogDir>
if [ ! -d ${LOG_ROOT_DIR} ]; then
 /bin/mkdir ${LOG_ROOT_DIR}
fi
/usr/bin/find ${LOG_ROOT_DIR} -depth -mtime +30 -mindepth 1 -exec /bin/rm -fr {} ¥;
LOG_DIR=${LOG_ROOT_DIR}/`/bin/date +%y%m%d`
if [ ! -d ${LOG_DIR} ]; then
 /bin/mkdir ${LOG_DIR}
fi
LOG=${LOG_DIR}/`/bin/date +%H%M%S`_${LSNAME}_${MSGID}.txt

echo $0 > "${LOG}"

if [ "${WEBSYSTEM}" = "" -o "${UNIT}" = "" ]; then
 exit 2
fi

MNGSVR=localhost:${COSMI_MNG_MACT_MNGSVR_PORT}
USERID=<User-id>
PASSWD=<Password>

echo ./cmx_stop_target -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -mode ALL -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
./cmx_stop_target -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -mode ALL -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
RET=$?
echo ${RET} >> "${LOG}"

exit ${RET}

(3)　Managementアクション実行コマンドの動作

Managementアクション実行コマンドの動作を次に示します。

Managementアクション実行コマンドから出力される標準出力，標準エラー出力は，Management Serverでは取得しません。このため，コマンドの標準出力，標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

Managementアクション実行コマンドはManagement Serverによって実行されます。実行ユーザは，Management Serverの実行ユーザになります。また，環境変数はManagement Serverに設定された環境変数を引き継ぎます。

Managementアクション実行コマンドのワーキングディレクトリは，<Cosminexusのインストールディレクトリ>¥manager¥bin（Windowsの場合），または/opt/Cosminexus/manager/bin（UNIXの場合）です。

7.　Webサーバとの連携の設定（J2EEアプリケーションを実行するシステム）

この章では，Smart Composer機能でJ2EEアプリケーションを実行するシステムを構築する場合に，Webサーバと連携してWebアプリケーションを実行する場合の設定方法について説明します。

なお，Smart Composer機能を使用しないでJ2EEアプリケーションを実行するシステムを構築する場合や，Webリダイレクタ環境構築時に必要なWebサーバとの連携の設定については，「18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）」を参照してください。

＜この章の構成＞

7.1　Webサーバとの連携の設定の概要

7.2　リダイレクタを使用したリクエストの振り分けの設定

7.3　通信タイムアウトの設定

7.4　エラーページのカスタマイズの設定

7.5　ドメイン名指定でトップページを表示するための設定

7.6　Webコンテナにゲートウェイ情報を通知するための設定

7.7　Hitachi Web Serverを使用するための設定

7.1　Webサーバとの連携の設定の概要

この節では，Webサーバとの連携機能の概要と，Webサーバとの連携機能を設定するユーザ定義ファイルについて説明します。

＜この節の構成＞

7.1.1　Webサーバとの連携機能の概要

7.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

7.1.1　Webサーバとの連携機能の概要

Webサーバとの連携機能を次の表に示します。

表7-1　Webサーバとの連携機能

機能 | 説明 | 参照先
リダイレクタを使用したリクエストの振り分け | Webサーバに登録したリダイレクタによって，リクエストをURLパターン，ラウンドロビン方式，またはPOSTデータサイズで複数のWebコンテナに振り分けて処理できます。 | 7.2
通信タイムアウト | クライアント－Webサーバ間，Webサーバ－Webコンテナ間で，リクエスト受信時およびレスポンス送信時の通信タイムアウトを設定しておき，トラブル発生時の応答待ちなどの場合に通信タイムアウトを検知できます。 | 7.3
エラーページのカスタマイズ | クライアントから，存在しないリソースに対してアクセスした場合などに，クライアントからのリクエストに対してユーザがカスタマイズしたエラーページを表示できます。 | 7.4
ドメイン名指定でのWebアプリケーションのトップページの表示 | ドメイン名指定によってWebアプリケーションのトップページを表示できます。 | 7.5
Webコンテナへのゲートウェイ情報の通知 | クライアントとWebサーバとの間にSSLアクセラレータや負荷分散機などのゲートウェイを配置している場合に，Webコンテナにゲートウェイ情報を通知して，WebアプリケーションのトップページやForm認証画面に自動的に正しくリダイレクトできます。 | 7.6
Hitachi Web ServerのSSLによる認証やデータ暗号化 | Hitachi Web Serverを使用する場合に，SSLによる認証機能やデータ暗号化の機能を使用できます。 | 7.7

以降の節では，上記の機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

ポイント

以降の節で説明する機能は，Webサーバの機能およびWebコンテナの機能のうち，Webサーバでの設定が必要となる機能です。Webサーバと連携する場合には，このほかに，Webクライアントとの通信制御やリクエストの流量制御などのWebコンテナの機能も使用できます。これらの機能を使用する場合には，J2EEサーバでの設定が必要です。J2EEサーバでの設定については，「4.　J2EEサーバの動作設定（J2EEアプリケーションを実行するシステム）」を参照してください。

7.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

Webサーバとの連携機能を設定するユーザ定義ファイルとユーザ定義ファイルに関する注意事項について説明します。

Webサーバとの連携機能は，次の四つのファイルで設定します。

簡易構築定義ファイル

workers.properties（ワーカ定義ファイル）

mod_jk.conf（リダイレクタ動作定義ファイル）

httpsd.conf（Hitachi Web Server定義ファイル）

ユーザ定義ファイルのうち，簡易構築定義ファイルについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を，httpsd.confの詳細については，マニュアル「Hitachi Web Server」を参照してください。ほかのユーザ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

Management Serverを使用してシステムを構築する場合，使用するWebサーバはHitachi Web Serverです。

各ファイルの詳細を次に説明します。

＜この項の構成＞

(1)　Smart Composer機能のファイル

(2)　そのほかのユーザ定義ファイル

(3)　注意事項

(1)　Smart Composer機能のファイル

簡易構築定義ファイル
リダイレクタ，Webコンテナ間のリクエスト送受信時や，レスポンス送受信時の通信タイムアウトを設定します。
テンプレートファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml

(2)　そのほかのユーザ定義ファイル

workers.properties（ワーカ定義ファイル）
ワーカの定義，およびワーカごとのパラメタを設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥workers.properties

UNIXの場合
/opt/Cosminexus/CC/web/redirector/workers.properties

mod_jk.conf（リダイレクタ動作定義ファイル）
Hitachi Web Serverでのリダイレクタの動作を設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.conf

UNIXの場合
/opt/Cosminexus/CC/web/redirector/mod_jk.conf

httpsd.conf（Hitachi Web Server定義ファイル）
Hitachi Web Serverの動作環境を定義するディレクティブ（Webサーバの実行環境を定義するパラメタ）を設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥httpsd¥conf¥httpsd.conf

UNIXの場合
/opt/hitachi/httpsd/conf/httpsd.conf

(3)　注意事項

ユーザ定義ファイルに関する注意事項を次に示します。

上書きインストールの場合，ユーザ定義ファイルは上書きされません。

アップグレードインストールの場合のワーカ定義ファイル，およびWebサーバ定義ファイルの処理については，「付録A　Cosminexus Version 6およびCosminexus Version 7からの移行」を参照してください。

リダイレクタの定義ファイルの1行の最大文字数は，1,023文字です。この文字数内で定義してください。

ワーカ定義ファイル，およびリダイレクタ動作定義ファイルの場合，キーの一部を簡易構築定義ファイルのパラメタで定義できます。簡易構築定義ファイルで設定した内容は，テキストエディタなどで直接編集しなくても，ワーカ定義ファイルと，リダイレクタ動作定義ファイルに反映されます。なお，Smart Composer機能でシステムを構築する場合は，システムの一貫性を保つため，細かい設定を変更する場合でも，簡易構築定義ファイルを編集するようにしてください。テキストエディタなどで個別にファイルを直接編集する場合には，スペルミスなどに十分注意してください。ワーカ定義ファイル（workers.properties），およびリダイレクタ動作定義ファイル（mod_jk.conf）の直接編集については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

次のユーザ定義ファイルで，同じ名称のパラメタが複数指定されている場合は，最初に指定されたパラメタの値を使用して動作します。

isapi_redirect.conf

workers.properties

uriworkermap.properties

7.2　リダイレクタを使用したリクエストの振り分けの設定

この節では，リダイレクタを使用したリクエストの振り分けの設定について説明します。

リダイレクタを使用したリクエストの振り分けでは，WebサーバあてのHTTPリクエストのうち，特定のリクエストを指定したWebコンテナに処理させたり，複数のWebコンテナにリクエストを振り分けて処理させたりします。機能の詳細については，マニュアル「Cosminexus　機能解説」のWebサーバ（リダイレクタ）によるリクエストの振り分けに関する説明を参照してください。

リダイレクタを使用してリクエストを振り分ける方法には，次の3種類があります。

URLパターンでのリクエスト振り分け

ラウンドロビン方式でのリクエスト振り分け

POSTデータサイズでのリクエスト振り分け

それぞれの方法でリクエストを振り分けるための設定について説明します。

＜この節の構成＞

7.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

7.2.2　URLパターンでのリクエスト振り分けの設定

7.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

7.2.4　POSTデータサイズでのリクエストの振り分けの設定

7.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

リクエストを振り分けるためには，次のユーザ定義ファイルをテキストエディタなどで編集して，ワーカ，URLパターンとワーカのマッピング，リダイレクタの動作を設定します。

簡易構築定義ファイル
ワーカの定義，およびワーカごとのパラメタ，URLパターンとワーカのマッピングを設定します。URLパターンでのリクエスト振り分けを設定する場合に使用します。ラウンドロビン方式でのリクエスト振り分け，およびPOSTデータサイズでのリクエスト振り分けの場合，設定内容が物理ティアがfree-tierに出力されます。

workers.properties（ワーカ定義ファイル）
ワーカの定義，およびワーカごとのパラメタを設定します。ラウンドロビン方式でのリクエスト振り分け，およびPOSTデータサイズでのリクエスト振り分けを設定する場合に使用します。

mod_jk.conf（リダイレクタ動作定義ファイル）
Hitachi Web ServerへのリクエストでどのURLパターンがWebコンテナへ転送されるかというURLパターンとワーカのマッピング，リダイレクタの動作を設定します。ラウンドロビン方式でのリクエスト振り分け，およびPOSTデータサイズでのリクエスト振り分けを設定する場合に使用します。

簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を，workers.propertiesおよびmod_jk.confの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

7.2.2　URLパターンでのリクエスト振り分けの設定

HTTPリクエストに含まれるURLパターンによってリクエストを振り分けることで，特定の処理だけをWebコンテナに実行させたり，複数のWebコンテナに処理内容に応じて振り分けたりできます。

＜この項の構成＞

(1)　設定の手順

(2)　簡易構築定義ファイルでの設定

(3)　設定例

(1)　設定の手順

URLパターンによるリクエストの振り分けは，次の手順で設定します。

簡易構築定義ファイルで，ワーカ，およびURLパターンとワーカのマッピングを定義します。
ワーカ名のリスト，ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名などを設定します。
また，すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「7.7　Hitachi Web Serverを使用するための設定」を参照してください。

(2)　簡易構築定義ファイルでの設定

URLパターンによるリクエストの振り分けの設定は，簡易構築定義ファイルで，論理Webサーバ（web-server）の<configuration>タグ内に定義します。簡易構築定義ファイルで定義するパラメタを次の表に示します。

表7-2　簡易構築定義ファイルで定義するパラメタ（URLパターンによるリクエストの振り分けの場合）

分類
パラメタ
説明

ワーカの定義
worker.list
一つまたは複数のワーカ名のリストを指定します。

worker.<ワーカ名>.host
ワーカのホスト名，またはIPアドレスを指定します。

worker.<ワーカ名>.port
ワーカのポート番号を指定します。

worker.<ワーカ名>.type
ワーカのタイプ（ajp13，lbまたはpost_size_lb）を指定します。

worker.<ワーカ名>.cachesize
リダイレクタで再利用するワーカのコネクション数を指定します。
Windowsの場合にだけ指定できます。

worker.<ワーカ名>.receive_timeout
通信タイムアウト値を指定します。

worker.<ワーカ名>.delegate_error_code
エラーページの作成をWebサーバに委任する場合に利用するエラーステータスコードを指定します。

URLパターンとワーカのマッピングの定義
JkMount
URLパターンと，worker.listで指定されているワーカのどれかとの組み合わせを指定します。

注　<ワーカ名>には，worker.listパラメタで指定したワーカの名称を定義します。

(3)　設定例

URLパターンでのリクエスト振り分けの例を次の図に示します。

図7-1　URLパターンでのリクエスト振り分けの例

この例では，ホストAにはWebアプリケーション「app1」，ホストBにはWebアプリケーション「app2」がそれぞれデプロイされています。処理したいWebアプリケーション名をリクエストのURLパターンに含めることで，「/app1/*」というURLパターンを持つリクエストはホストAで，「/app2/*」というURLパターンを持つリクエストはホストBで処理できるようにします。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。

簡易構築定義ファイルの例を次に示します。ここでは，複数のWebコンテナへリクエストを振り分けるので，Webサーバに登録したリダイレクタに，複数のWebコンテナのワーカを振り分け先として指定します。また，「/app1/*」というURLパターンと「worker1」，「/app2/*」というURLパターンと「worker2」とをマッピングします。

簡易構築定義ファイルの例

：
<param>
 <param-name>JkMount</param-name>
 <param-value>/app1/* worker1</param-value>
 <param-value>/app2/* worker2</param-value>
</param>
<param>
 <param-name>worker.list</param-name>
 <param-value>worker1,worker2</param-value>
</param>
<param>
 <param-name>worker.worker1.port</param-name>
 <param-value>8007</param-value>
</param>
<param>
 <param-name>worker.worker1.host</param-name>
 <param-value>hostA</param-value>
</param>
<param>
 <param-name>worker.worker1.type</param-name>
 <param-value>ajp13</param-value>
</param>
<param>
 <param-name>worker.worker1.cachesize</param-name>
 <param-value>64</param-value>
</param>
<param>
 <param-name>worker.worker2.port</param-name>
 <param-value>8007</param-value>
</param>
<param>
 <param-name>worker.worker2.host</param-name>
 <param-value>hostB</param-value>
</param>
<param>
 <param-name>worker.worker2.type</param-name>
 <param-value>ajp13</param-value>
</param>
<param>
 <param-name>worker.worker2.cachesize</param-name>
 <param-value>64</param-value>
</param>
：

7.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

振り分け先となるワーカのリストをロードバランサに定義することで，ラウンドロビン方式でワーカにリクエストを振り分けます。

振り分け先となる各ワーカに負荷分散値を設定して，リクエスト振り分けの比率を定義すると，ホストごとの負荷の割合を調整できます。リダイレクタは，この比率でHTTPリクエスト単位にラウンドロビンでリクエストを振り分けるので，比率が高いワーカほど転送されるリクエストの割合が多くなります。ただし，同じセッションに属するHTTPリクエストは前回と同じワーカに振り分けられます。

＜この項の構成＞

(1)　設定の手順

(2)　workers.propertiesおよびmod_jk.confでの設定

(3)　設定例

(1)　設定の手順

ラウンドロビン方式でのリクエスト振り分けは，次の手順で設定します。

workers.propertiesでロードバランサ，およびワーカを定義します。

ロードバランサの定義

ワーカ名のリスト，ワーカのタイプ（「lb」を設定），負荷分散の対象となるワーカのリストなどを設定します。

各ワーカの定義

ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名，負荷分散値などを設定します。

標準で提供されるworkers.propertiesには，デフォルト値が定義されています。コメントとして定義されているデフォルトの定義を使用する場合は，該当する行の先頭の「#」を削除してください。

mod_jk.confでURLパターンとワーカのマッピングを定義します。
すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「7.7　Hitachi Web Serverを使用するための設定」を参照してください。

注意事項

リダイレクタで負荷分散を使用する場合に，あるワーカで障害を検出すると，障害を検出してから60秒間はそのワーカはリダイレクト先ワーカの選択肢から除外されます。そのため，障害が回復しても，最大で60秒間はそのワーカが使用されない場合があります。

リダイレクタが動作するワーカプロセスを複数に設定した場合，ワーカプロセスを2以上に設定していると，workers.propertiesの最初に定義したワーカによって多く割り振られます。

UNIXの場合，Hitachi Web Serverのサーバプロセスを負荷に応じて生成・消滅させているときは，workers.propertiesの最初に定義したワーカによって多く割り振られます。また，サーバプロセス数を固定にしても，リクエストがどのサーバプロセスに割り振られるかは不定のため，同じ負荷分散値を指定してもラウンドロビンにならないことがあります。サーバプロセスは，消滅しなければ負荷に応じて増えてもよいため，サーバプロセスが短時間で生成・消滅しないようにディレクティブを指定する必要があります。
Hitachi Web Serverのhttpsd.confのディレクティブが次に示す条件を満すように，指定してください。

条件 | 意味
MaxSpareServers ≧ MaxClients | サーバプロセスはMaxClientsまで増加し，処理終了後も常駐します。
MaxRequestsPerChild 10000 | HTTPリクエストを10,000回処理後，リフレッシュのためにサーバプロセスを終了させます（10,000は推奨値）。振り分け先のJ2EEサーバまたはWebコンテナサーバ数に対して十分に大きな値を指定します。
StartServers = MaxClients | 最初に全サーバプロセスを起動しておく場合に指定します。

ディレクティブの指定例

StartServers 256
MaxClients 256
MaxSpareServers 256
MaxRequestsPerChild 10000

(2)　workers.propertiesおよびmod_jk.confでの設定

ラウンドロビン方式でのリクエストの振り分けの設定は，workers.propertiesおよびmod_jk.confで定義します。workers.propertiesおよびmod_jk.confで定義するキーを次の表に示します。

表7-3　workers.propertiesおよびmod_jk.confで定義するキー（ラウンドロビン方式でのリクエストの振り分けの場合）

ファイルの種類
キー名
説明

workers.properties
worker.list
一つまたは複数のワーカ名のリストを指定します。

worker.<ワーカ名>.host
ワーカのホスト名，またはIPアドレスを指定します。

worker.<ワーカ名>.port
ワーカのポート番号を指定します。

worker.<ワーカ名>.type
ワーカのタイプを指定します。ロードバランサには「lb」を，負荷分散の対象となるワーカには「ajp13」を指定します。

worker.<ワーカ名>.balanced_workers
負荷分散の対象となるワーカのリストを指定します。

worker.<ワーカ名>.lbfactor
負荷分散値を指定します。

worker.<ワーカ名>.cachesize
リダイレクタで再利用するワーカのコネクション数を指定します。
Windowsの場合にだけ指定できます。

worker.<ワーカ名>.receive_timeout
通信タイムアウト値を指定します。

worker.<ワーカ名>.delegate_error_code
エラーページの作成をWebサーバに委任する場合に利用するエラーステータスコードを指定します。

mod_jk.conf
JkMount
URLパターンと，worker.listで指定されているワーカのどれかとの組み合わせを指定します。

注　<ワーカ名>には，worker.listキー，またはworker.<ワーカ名>.balanced_workersキーで指定したワーカの名称を定義します。

ワーカの種類ごとに指定できるパラメタを次の表に示します。

表7-4　ワーカの種類ごとに指定できるキー

キー名
ワーカの種類（worker.<ワーカ名>.typeキーの指定値）

ロードバランサ
（「lb」を指定）
ワーカ
（「ajp13」を指定）

worker.<ワーカ名>.host
×
○

worker.<ワーカ名>.port
×
○

worker.<ワーカ名>.type
○
○

worker.<ワーカ名>.balanced_workers
○
×

worker.<ワーカ名>.lbfactor
×
△

worker.<ワーカ名>.cachesize
×
△

worker.<ワーカ名>.receive_timeout
×
△

worker.<ワーカ名>.delegate_error_code
×
△

（凡例）○：指定できる。　×：指定できない。　△：任意に指定できる。

(3)　設定例

ラウンドロビン方式でのリクエスト振り分けの例を次の図に示します。

図7-2　ラウンドロビン方式でのリクエスト振り分けの例

この例では，「/examples」以下のリクエストがホストA，ホストBに同じ比率で振り分けます。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。

workers.propertiesの例を次に示します。ここでは，ロードバランサとワーカを定義します。リクエストを同じ比率で振り分けるので，「worker1」と「worker2」の負荷分散値はどちらも「1」を指定します。

workers.propertiesの例（Windowsの場合）

worker.list=loadbalancer1

worker.loadbalancer1.balanced_workers=worker1,worker2
worker.loadbalancer1.type=lb

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.cachesize=64
worker.worker1.lbfactor=1

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.cachesize=64
worker.worker2.lbfactor=1

workers.propertiesの例（UNIXの場合）

worker.list=loadbalancer1

worker.loadbalancer1.balanced_workers=worker1,worker2
worker.loadbalancer1.type=lb

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.lbfactor=1

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.lbfactor=1

mod_jk.confの例を次に示します。ここでは，ロードバランサ名「loadbalancer1」を指定します。

mod_jk.confの例

JkMount /examples/* loadbalancer1

7.2.4　POSTデータサイズでのリクエストの振り分けの設定

振り分け先となるワーカのリストをPOSTリクエスト振り分けワーカに定義することで，POSTデータサイズでワーカにリクエストを振り分けます。

振り分け先となるPOSTリクエスト転送先ワーカに，POSTデータサイズの上限値を設定して，リクエスト振り分け先を定義します。これによって，特定のホストに，処理に時間が掛かる長大なPOSTデータサイズのリクエストの処理を振り分けられます。リダイレクタは，HTTPリクエスト単位にPOSTデータサイズの上限値で振り分けるので，長大なPOSTデータ以外のリクエストのスループットの低下や，レスポンス時間の低下を防ぐことができます。なお，POSTデータサイズの上限値が設定されている場合は，同じセッションに属するHTTPリクエストであっても，POSTデータサイズの値が優先されます。

＜この項の構成＞

(1)　設定の手順

(2)　workers.propertiesおよびmod_jk.confでの設定

(3)　設定例

(1)　設定の手順

POSTデータサイズでのリクエスト振り分けは，次の手順で設定します。

workers.propertiesでPOSTリクエスト振り分けワーカ，およびPOSTリクエスト転送先ワーカを定義します。

POSTリクエスト振り分けワーカの定義

ワーカ名のリスト，ワーカのタイプ（「post_size_lb」を設定），POSTデータサイズによる振り分けの対象となるワーカのリストなどを設定します。必要に応じて，デフォルトワーカも設定します。

各POSTリクエスト転送先ワーカの定義

ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名，POSTデータサイズの上限値などを設定します。

標準で提供されるworkers.propertiesには，デフォルト値が定義されています。コメントとして定義されているデフォルトの定義を使用する場合は，該当する行の先頭の「#」を削除してください。

mod_jk.confでURLパターンとワーカのマッピングを定義します。
すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「7.7　Hitachi Web Serverを使用するための設定」を参照してください。

(2)　workers.propertiesおよびmod_jk.confでの設定

POSTデータサイズでのリクエストの振り分けの設定は，workers.propertiesおよびmod_jk.confで定義します。workers.propertiesおよびmod_jk.confで定義するキーを次の表に示します。

表7-5　workers.propertiesおよびmod_jk.confで定義するキー（POSTデータサイズでのリクエストの振り分けの場合）

ファイルの種類
キー名
説明

workers.properties
worker.list
一つまたは複数のワーカ名のリストを指定します。

worker.<ワーカ名>.host
ワーカのホスト名，またはIPアドレスを指定します。

worker.<ワーカ名>.port
ワーカのポート番号を指定します。

worker.<ワーカ名>.type
ワーカのタイプを指定します。POSTリクエスト振り分けワーカには「post_size_lb」を，振り分け対象となるPOSTリクエスト転送先ワーカには「ajp13」を指定します。

worker.<ワーカ名>.post_size_workers
POSTデータサイズによる振り分けの対象となるワーカのリストを指定します。

worker.<ワーカ名>.post_data
リクエストのPOSTデータサイズの上限値（バイト単位）を指定します。

worker.<ワーカ名>.default_worker
リクエストの振り分け先に該当するワーカが，クラスタ構成内のPOSTリクエスト転送先ワーカにない場合に，リクエストを転送するワーカ（デフォルトワーカ）を指定します。

worker.<ワーカ名>.cachesize
リダイレクタで再利用するワーカのコネクション数を指定します。
Windowsの場合にだけ指定できます。

worker.<ワーカ名>.receive_timeout
通信タイムアウト値を指定します。

worker.<ワーカ名>.delegate_error_code
エラーページの作成をWebサーバに委任する場合に利用するエラーステータスコードを指定します。

mod_jk.conf
JkMount
URLパターンと，worker.listで指定されているワーカのどれかとの組み合わせを指定します。

注　<ワーカ名>には，worker.listキー，またはworker.<ワーカ名>.post_size_workersキーで指定したワーカの名称を定義します。

ワーカの種類ごとに指定できるキーを次の表に示します。

表7-6　ワーカの種類ごとに指定できるキー

キー名
ワーカの種類（worker.<ワーカ名>.typeキーの指定値）

POSTリクエスト振り分けワーカ
（「post_size_lb」を指定）
POSTリクエスト転送先ワーカ
（「ajp13」を指定）

worker.<ワーカ名>.host
×
○

worker.<ワーカ名>.port
×
○

worker.<ワーカ名>.type
○
○

worker.<ワーカ名>.post_size_workers
○
×

worker.<ワーカ名>.post_data
×
○

worker.<ワーカ名>.default_worker
△
×

worker.<ワーカ名>.cachesize
×
△

worker.<ワーカ名>.receive_timeout
×
△

worker.<ワーカ名>.delegate_error_code
×
△

（凡例）○：指定できる。　×：指定できない。　△：任意に指定できる。

(3)　設定例

POSTデータサイズでのリクエスト振り分けの例を次の図に示します。ここでは，リクエストを限定できない場合を例に説明します。

図7-3　POSTデータサイズでのリクエスト振り分けの例

この例では，「/examples」以下のリクエストのうち，POSTデータサイズが100メガバイト未満のリクエストをホストA，POSTデータサイズが100メガバイト以上200メガバイト未満のリクエストをホストBに振り分けます。リクエストの振り分け条件に満たないリクエストは，デフォルトワーカに設定したホストAに振り分けます。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。リクエストの振り分け条件については，マニュアル「Cosminexus　機能解説」のPOSTデータサイズでのリクエストの振り分けに関する説明を参照してください。

workers.propertiesの例を次に示します。ここでは，POSTリクエスト振り分けワーカ，POSTリクエスト転送先ワーカおよびデフォルトワーカを定義します。POSTデータサイズの上限値は，「worker1」に「100m」，「worker2」に「2048m」（POSTデータサイズの上限値の最大値）を指定します。デフォルトワーカには，「worker1」を指定します。

workers.propertiesの例（Windowsの場合）

worker.list=postsizelb1

worker.postsizelb1.post_size_workers=worker1,worker2
worker.postsizelb1.type=post_size_lb
worker.postsizelb1.default_worker=worker1

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.cachesize=64
worker.worker1.post_data=100m

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.cachesize=64
worker.worker2.post_data=2048m

workers.propertiesの例（UNIXの場合）

worker.list=postsizelb1

worker.postsizelb1.post_size_workers=worker1,worker2
worker.postsizelb1.type=post_size_lb
worker.postsizelb1.default_worker=worker1

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.post_data=100m

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.post_data=2048m

mod_jk.confの例を次に示します。ここでは，POSTリクエスト振り分けワーカ「postsizelb1」を指定します。

mod_jk.confの例

JkMount /examples/* postsizelb1

参考

POSTデータサイズの上限値は，httpsd.conf（Hitachi Web Server定義ファイル）のLimitRequestBodyディレクティブでも設定できます。LimitRequestBodyディレクティブの詳細については，マニュアル「Hitachi Web Server」を参照してください。

7.3　通信タイムアウトの設定

この節では，クライアント－Webサーバ間，およびWebサーバ（リダイレクタ）－Webコンテナ間の通信タイムアウトの設定について説明します。

通信タイムアウトは，リクエストの送受信時，またはレスポンスの送受信時に設定します。リクエスト送受信時およびレスポンス送受信時の通信タイムアウトの設定についてそれぞれ説明します。機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナおよびWebサーバでの通信タイムアウトの設定に関する説明を参照してください。

なお，通信タイムアウトは，EJBを呼び出すEJBクライアント側でも設定できます。EJBクライアント側での設定は，J2EEアプリケーション開発時に設定します。設定方法については，マニュアル「Cosminexus　機能解説」のRMI-IIOP通信のタイムアウトに関する説明を参照してください。

＜この節の構成＞

7.3.1　リクエスト送受信時の通信タイムアウトの設定

7.3.2　レスポンス送受信時の通信タイムアウトの設定

7.3.1　リクエスト送受信時の通信タイムアウトの設定

リクエスト送受信時の通信タイムアウトは，クライアント－Webサーバ間，リダイレクタ－Webコンテナ間に設定します。リクエスト送受信時の通信タイムアウトの設定場所について，次の図に示します。

図7-4　リクエスト送受信時の通信タイムアウトの設定場所

図について説明します。なお，図中の番号と説明の番号は対応しています。

Webサーバでのリクエスト受信時（クライアント－Webサーバ）
Webサーバでは，クライアントから転送されたリクエストの受信処理の時間に，タイムアウトを設定できます。

リダイレクタでのリクエスト送信時（リダイレクタ－Webコンテナ）
リダイレクタでは，Webコンテナへのリクエスト送信処理の時間に，タイムアウトを設定できます。

Webコンテナでのリクエスト受信時（リダイレクタ－Webコンテナ）
Webコンテナでは，リダイレクタから転送されたリクエストの受信処理の時間に，タイムアウトを設定できます。

それぞれの場合での通信タイムアウトの設定方法について説明します。

＜この項の構成＞

(1)　Webサーバでのリクエスト受信時の設定

(2)　リダイレクタでのリクエスト送信時の設定

(3)　Webコンテナでのリクエスト受信時の設定

(1)　Webサーバでのリクエスト受信時の設定

クライアントからのリクエストをWebサーバで受信するときの通信タイムアウトは，Webサーバに設定します。Webサーバには，Hitachi Web Serverを使用できます。

(a)　設定方法

クライアントから転送されたリクエストの受信処理の通信タイムアウトを，httpsd.confに設定してください。

リクエスト受信処理の待ち時間
Timeoutディレクティブに，クライアントからのリクエスト受信処理の待ち時間（秒）を設定します。Timeoutディレクティブのデフォルト値は300秒です。なお，ここに設定する値は，クライアントへのデータ送信処理に対する通信タイムアウトと共用です。クライアントへのデータ送信処理に対する通信タイムアウトについては，「7.3.2(3)　Webサーバでのレスポンス送信時の設定」を参照してください。

(b)　設定時の注意

Webサーバでのリクエスト受信時に設定するタイムアウト値については，クライアント－Webサーバ間のネットワーク構成，およびトラフィックの状態を考慮し，障害が発生したと判断できる時間を設定してください。

(2)　リダイレクタでのリクエスト送信時の設定

リダイレクタからWebコンテナにリクエストを送信するときには，Webコンテナとのコネクションを確立してからリクエストを送信します。リダイレクタからWebコンテナにリクエストを送信するときの通信タイムアウトは，コネクション確立時，およびリクエスト送信時に設定できます。また，コネクションの確立およびリクエストヘッダの送信に失敗した場合のリトライ回数を設定できます。

(a)　設定方法

リダイレクタからの，コネクション確立およびリクエスト送信処理の通信タイムアウトおよびリトライ回数を，簡易構築定義ファイルに設定してください。

コネクション確立の通信タイムアウト
論理Webサーバ（web-server）の<configuration>タグ内に，JkConnectTimeoutパラメタで，Webコンテナへのコネクション確立処理の待ち時間（秒）を設定します。JkConnectTimeoutパラメタのデフォルト値は30秒です。

リクエスト送信処理のタイムアウト
論理Webサーバ（web-server）の<configuration>タグ内に，JkSendTimeoutパラメタで，Webコンテナへのリクエスト送信処理の待ち時間（秒）を設定します。JkSendTimeoutパラメタのデフォルト値は100秒です。

コネクション確立およびリクエスト送信のリトライ回数
論理Webサーバ（web-server）の<configuration>タグ内に，JkRequestRetryCountパラメタで，Webコンテナへのコネクション確立およびリクエスト送信のリトライ回数を設定します。JkRequestRetryCountパラメタのデフォルト値は3回です。

(b)　設定時の注意

リダイレクタでのリクエスト送信時に設定する通信タイムアウト値，およびリトライ回数については，次の点に考慮して設定してください。

リトライ回数には，初回のコネクション確立およびリクエスト送信が含まれます。このため，初回のコネクション確立またはリクエスト送信処理で失敗した場合，コネクション確立またはリクエスト送信処理のリトライは，2回目としてカウントされます。

コネクション確立およびリクエスト送信処理の通信タイムアウト時間に0を指定した場合，またはTCPが持つコネクション確立およびデータ送信の再送タイマより長い時間を設定した場合は，通信タイムアウト時間はTCPの持つタイムアウト時間が適用されます。

(3)　Webコンテナでのリクエスト受信時の設定

リダイレクタからのリクエストをWebコンテナで受信するときの通信タイムアウトは，Webコンテナに設定します。

(a)　設定方法

リダイレクタから転送されたリクエストの受信処理の通信タイムアウトを，簡易構築定義ファイルに設定してください。

リクエスト受信処理のタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.connector.ajp13.receive_timeoutパラメタで，リダイレクタからのリクエスト受信処理の待ち時間（秒）を設定します。パラメタのデフォルト値は100秒です。

(b)　設定時の注意

Webコンテナでのリクエスト受信時に設定するタイムアウト値については，次の点に考慮して設定してください。

Webサーバのリクエスト受信時のタイムアウトに設定した時間より，大きい値を設定してください。
Webサーバのリクエスト受信時のタイムアウトに設定した時間より，小さい値を設定しているときに，クライアントや，クライアント－Webサーバ間でネットワーク障害が発生すると，Webサーバより先にWebコンテナでタイムアウトが発生してしまいます。この場合，障害が発生したのが，Webサーバ側であるのか，クライアント側であるのかが判別できなくなります。

クライアントからのデータ受信が必要な場合，クライアントとの通信速度を考慮して，データ受信ができる時間を設定してください。

リダイレクタでのWebコンテナへのデータの送信時に障害が発生した場合，TCPの再送タイマでのタイムアウトによって障害が検知されます。
なお，UNIXの場合，タイムアウトまでの時間は，OSによって異なります。

7.3.2　レスポンス送受信時の通信タイムアウトの設定

レスポンス送受信時の通信タイムアウトは，Webコンテナ－リダイレクタ間，Webサーバ－クライアント間に設定します。レスポンス送受信時の通信タイムアウトの設定場所について，次の図に示します。

図7-5　レスポンス送受信時の通信タイムアウトの設定場所

図について説明します。なお，図中の番号と説明の番号は対応しています。

Webコンテナでのレスポンス送信時（Webコンテナ－リダイレクタ）
Webコンテナでのレスポンス送信時にタイムアウトを設定します。

リダイレクタでのレスポンス受信時（Webコンテナ－リダイレクタ）
リダイレクタでのレスポンス受信時に，タイムアウトを設定します。

Webサーバでのレスポンス送信時（Webサーバ－クライアント）
Webサーバでのレスポンス送信時に，タイムアウトを設定します。

それぞれの場合での通信タイムアウトの設定方法について説明します。

＜この項の構成＞

(1)　Webコンテナでのレスポンス送信時の設定

(2)　リダイレクタでのレスポンス受信時の設定

(3)　Webサーバでのレスポンス送信時の設定

(1)　Webコンテナでのレスポンス送信時の設定

Webコンテナからリダイレクタにレスポンス送信処理するときの通信タイムアウトは，Webコンテナに設定します。Webコンテナからのレスポンス送信時の待ち時間は，簡易構築定義ファイルに，を設定してください。

レスポンス送信処理のタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.connector.ajp13.send_timeoutパラメタで，Webコンテナからのレスポンス送信時のタイムアウト時間（秒）を設定します。パラメタのデフォルト値は600秒です。

(2)　リダイレクタでのレスポンス受信時の設定

Webコンテナからのレスポンスを受信するときの通信タイムアウトをリダイレクタに設定します。

(a)　設定方法

Webコンテナからのレスポンス待ち時間を，簡易構築定義ファイルに設定してください。

レスポンス受信処理のタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，worker.<ワーカ名>.receive_timeoutパラメタで，ワーカごとのレスポンス待ち時間（秒）を設定します。パラメタのデフォルト値は3600秒です。J2EEアプリケーション単位で通信タイムアウトを設定したい場合は，J2EEアプリケーションごとにワーカを定義してマッピングしてください。

(b)　設定時の注意

リダイレクタでのレスポンス受信時のタイムアウトでは，Webアプリケーションの障害を検知できます。そのため，運用状況によっては，Webアプリケーションの処理に必要となる時間を考慮して，障害検知と判断できる値を通信タイムアウトに設定する必要があります。

リダイレクタでのレスポンス受信時に設定するタイムアウト値については，次の点に考慮して設定してください。

通信タイムアウトには，Webアプリケーションの処理に必要な時間より長い時間を設定してください。
設定したタイムアウトの時間が，Webアプリケーションの処理時間より短い場合，Webアプリケーションは正常に処理されていても，リダイレクタ側ではタイムアウトが発生したと判断して，クライアントにエラーが返されます。

Webコンテナのピーク時の，同時実行スレッド数の制御による待ち時間を考慮してください。
同時実行スレッド数の制御によって，Webコンテナのピーク時には，処理待ちリクエストの発生が考えられます。このため，サーバ管理コマンドを使用して同時実行スレッド数の制御を設定している場合，リクエストの処理時間が延長されることも考慮して，通信タイムアウトを設定しておく必要があります。サーバ管理コマンドでの同時実行スレッド数の制御の設定については，「4.4　同時実行スレッド数の制御の設定」を参照してください。

Webコンテナでのリダイレクタへのデータの送信時に障害が発生した場合，TCPの再送タイマでのタイムアウトによって障害が検知されます。
なお，UNIXの場合，タイムアウトまでの時間は，OSによって異なります。

(3)　Webサーバでのレスポンス送信時の設定

クライアントにレスポンスを送信するときの通信タイムアウトは，Webサーバに設定します。

(a)　設定方法

クライアントからのレスポンス待ち時間を，httpsd.confに設定してください。

データ送信処理の通信タイムアウト
Timeoutディレクティブに通信タイムアウトを設定してください。なお，Timeoutディレクティブで指定する通信タイムアウトは，リクエスト受信処理に対する通信タイムアウトおよびレスポンス送信処理に対する通信タイムアウトの両方の時間として指定します。このため，リクエスト受信処理の通信タイムアウトとレスポンス送信処理の通信タイムアウトで異なる時間を設定することはできません。
クライアントからのリクエスト受信処理に対する通信タイムアウトについては，「7.3.1(1)　Webサーバでのリクエスト受信時の設定」を参照してください。

(b)　設定時の注意

Webサーバでのレスポンス送信時に設定するタイムアウト値については，クライアント－Webサーバ間のネットワーク構成，およびトラフィックの状態を考慮し，クライアントとデータの送受信をするのに十分な時間を設定してください。

また，Webサーバでのレスポンス送信時のタイムアウトは，Webコンテナでのレスポンス送信時のタイムアウト値よりも小さな値を設定してください。Webサーバでのレスポンス送信時のタイムアウトを，Webコンテナでのレスポンス送受信時のタイムアウト値よりも大きな値を設定しているときに，クライアント－Webサーバ間で障害が発生すると，Webサーバでのクライアントへのレスポンス送信のタイムアウトよりも先に，Webコンテナでのリダイレクタへのレスポンス送信でタイムアウトが発生するおそれがあります。この場合，障害が発生したのが，クライアント－Webサーバ間か，リダイレクタ－Webコンテナ間か判別できなくなります。

7.4　エラーページのカスタマイズの設定

この節では，エラーページのカスタマイズの設定について説明します。

エラーが発生したときに，エラーステータスコードが表示されたエラーページの代わりにユーザが作成したエラーページを表示させるためには，ユーザが作成したエラーページを特定のエラーステータスコードと対応づけます。該当するエラーステータスコードのエラーが発生した場合には，Webサーバ（Hitachi Web Server）に設定された情報を基に，エラーステータスコードに対応したエラーページをクライアントに送信します。機能の詳細については，マニュアル「Cosminexus　機能解説」のエラーページのカスタマイズに関する説明を参照してください。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(3)　注意事項

(1)　設定方法

エラーステータスコードとエラーページとの対応づけは，次のファイルで定義します。

簡易構築定義ファイル
論理Webサーバ（web-server）の<configuration>タグ内に，worker.<ワーカ名>.delegate_error_codeパラメタで，エラーページに対応づけたいエラーステータスコードを設定します。

httpsd.conf
ErrorDocumentディレクティブで，エラーステータスコードと，対応するエラーページのファイル名を対応づけます。

(a)　エラーステータスコード設定時の注意事項

簡易構築定義ファイルでエラーステータスコードを指定する場合の注意事項を次に示します。

エラーステータスコードは，ワーカ単位で指定します。

エラーステータスコードを指定できるワーカのタイプは，「ajp13」だけです。ワーカのタイプが「lb」（ラウンドロビンに基づく負荷分散をするときの設定），および「post_size_lb」（POSTデータサイズに基づく振り分けをするとの設定）の場合，指定した内容は無視されます。

指定できるエラーステータスコードは，次の表のとおりです。これ以外のエラーステータスコードにエラーページを対応づけることはできません。

表7-7　エラーページと対応づけできるエラーステータスコード

エラーステータスコード | 説明句
400 | Bad Request
401 | Unauthorized
402 | Payment Required
403 | Forbidden
404 | Not Found
405 | Method Not Allowed
406 | Not Acceptable
407 | Proxy Authentication Required
408 | Request Time-out
409 | Conflict
410 | Gone
411 | Length Required
412 | Precondition Failed
413 | Request Entity Too Large
414 | Request-URI Too Long
415 | Unsupported Media Type
416 | Requested Range Not Satisfiable
417 | Expectation Failed
422 | Unprocessible Entity
423 | Locked
424 | Failed Dependency
500 | Internal Server Error
501 | Not Implemented
502 | Bad Gateway
503 | Service Unavailable
504 | Gateway Time-out
505 | HTTP Version not supported
507 | Insufficient Storage
510 | Not Extended

(b)　ErrorDocumentディレクティブ指定時の注意事項

httpsd.confでErrorDocumentディレクティブを指定する場合の注意事項を次に示します。

ErrorDocumentディレクティブにローカルURLを使用する場合には，リダイレクタがWebコンテナに転送しないURLを指定する必要があります。

ルートコンテキストの使用時など，リダイレクタの設定で「/*」というURLパターンをワーカにマッピングしている場合，すべてのリクエストがWebコンテナに転送されます。そのため，ErrorDocumentディレクティブには，Webコンテナ上のリソースを，完全URLを使用して設定してください。
ルートコンテキストを使用する場合で，エラーステータスコード404発生時に，Webコンテナ上のルートコンテキスト配下のerror404.jspを表示させるための設定例を次に示します。hostAは，Webサーバ稼働ホストです。

（例）

ErrorDocument 404 http://hostA/error404.jsp

また，このときWebコンテナが停止している場合には，リダイレクタはエラーステータスコード500のエラーを返します。このため，Webコンテナが停止している際のエラーページをカスタマイズするには，ErrorDocumentディレクティブで，エラーステータスコード500に対して別のWebサーバのリソースを，完全URLで指定する必要があります。

(2)　設定例

エラーページのカスタマイズの例を次に示します。

簡易構築定義ファイルの例

：
<param>
 <param-name>worker.list</param-name>
 <param-value>worker1</param-value>
</param>
<param>
 <param-name>worker.worker1.type</param-name>
 <param-value>ajp13</param-value>
</param>
<param>
 <param-name>worker.worker1.host</param-name>
 <param-value>host1</param-value>
</param>
<param>
 <param-name>worker.worker1.delegate_error_code</param-name>
 <param-value>404</param-value>
</param>
：

worker.<ワーカ名>.delegate_error_codeパラメタに，エラーステータスコード「404（Not Found）」を定義しています。

httpsd.confの例

# httpsd.confの記述#
#　　　　　：
ErrorDocument 404 /missing.html

エラーステータスコードと，対応するエラーページのファイル名を対応づけます。エラーステータスコード「404（Not Found）」のエラーが発生した場合に，missing.htmlファイルを表示するようになります。

ErrorDocumentディレクティブの詳細については，マニュアル「Hitachi Web Server」を参照してください。

(3)　注意事項

Servlet 2.3仕様に対応したWebアプリケーションでは，サーブレットの仕様で規定されているweb.xmlの<error-page>タグによるカスタムエラー機能を使用している場合，Webコンテナは<error-page>タグに記述されているページへのアクセス結果をステータスコードとして返却します。このため，<error-page>タグに記述されているページへのアクセスでエラーが発生しない場合には，この機能は動作しません。

エラーページの生成を委任するエラーステータスコードが簡易構築定義ファイルだけに定義されている（httpsd.confのErrorDocumentディレクティブを定義していない）場合，そのエラーステータスコードのエラーが発生したときに返却されるエラーページは，Hitachi Web Serverが自動生成したページになります。

7.5　ドメイン名指定でトップページを表示するための設定

この節では，ドメイン名指定でトップページを表示するための設定について説明します。

デプロイしたWebアプリケーションにアクセスするとき，URLにドメイン名を指定するだけで，index.htmlやindex.jspなどの，Webアプリケーションのトップページを表示させることができます。なお，機能の詳細については，マニュアル「Cosminexus　機能解説」のドメイン名指定でのトップページの表示に関する説明を参照してください。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(1)　設定方法

ドメイン名指定でトップページを表示するための設定方法を次に示します。

ルートコンテキストを設定します。
ルートコンテキストとは，コンテキストルートに名称が指定されていないコンテキストのことです。ルートコンテキストの指定は，動作モードによって異なります。
サーバ管理コマンドを使用してJ2EEアプリケーションのプロパティを定義するときにルートコンテキストを指定します。コンテキストルートとしてルートコンテキストを設定する場合は，空文字を指定します。J2EEアプリケーションのコンテキストルート定義については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リダイレクタで，ルートコンテキストへのリクエストの振り分けを設定します。
ルートコンテキストへのリクエストの振り分けは，簡易構築定義ファイルに指定します。

(2)　設定例

ルートコンテキストへのリクエストの振り分けの設定例について説明します。

URLにドメイン名を指定するだけで，Webアプリケーションのトップページを表示させるためには，リダイレクタのURLマッピング定義で，ルートコンテキストにリクエストが振り分けられるように設定してください。例えば，ルートコンテキストは「worker1」に，「/examples」はworker2に振り分ける場合には，次のように指定します。

簡易構築定義ファイルの例

：
<param>
 <param-name>JkMount</param-name>
 <param-value>/* worker1</param-value>
 <param-value>/examples/* worker2</param-value>
</param>
：

7.6　Webコンテナにゲートウェイ情報を通知するための設定

この節では，ゲートウェイ指定機能を使用するための設定について説明します。

クライアントとWebサーバとの間に，SSLアクセラレータや負荷分散機などのゲートウェイを配置している場合，ゲートウェイ指定機能を使用することで，Webコンテナにゲートウェイ情報を通知し，WebアプリケーションのトップページやForm認証画面に正しくリダイレクトできるようになります。なお，機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナへのゲートウェイ情報の通知に関する説明を参照してください。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(1)　設定方法

ゲートウェイ指定機能を使用するための設定方法を次に示します。

ゲートウェイのホスト名・ポート番号・リダイレクト先URLのスキームを，リダイレクタごとに指定します。

Webサーバを再起動します。

なお，ゲートウェイのホスト名・ポート番号・リダイレクト先URLのスキームは，簡易構築定義ファイルに指定します。論理Webサーバ（web-server）の<configuration>タグ内に，次のパラメタで指定します。

ホスト名：JkGatewayHost

ポート番号：JkGatewayPort

リダイレクト先URLのスキーム：JkGatewayHttpsScheme

(2)　設定例

ゲートウェイ指定機能の設定例を次に示します。

図7-6　ゲートウェイ指定機能の設定例

この例では，クライアントとWebサーバの間にSSLアクセラレータを配置しています。クライアントからSSLアクセラレータへのアクセスがHTTPSの場合でも，SSLアクセラレータからWebサーバへのアクセスはHTTPとなるため，WebコンテナはHTTPによるアクセスであると認識します。このため，WebアプリケーションのトップページやForm認証画面へのリダイレクト先URLのスキームはHTTPとなります。この場合，ゲートウェイ指定機能を使用して，スキームを常にHTTPSとみなすように指定することで，正しくリダイレクトできるようになります。

簡易構築定義ファイルの例を次に示します。ここでは，リダイレクト先URLのスキームを常にHTTPSとみなすようにJkGatewayHttpsSchemeパラメタで「On」を指定します。

簡易構築定義ファイルの例

：
<param>
 <param-name>JkGatewayHost</param-name>
 <param-value>host1</param-value>
</param>
<param>
 <param-name>JkGatewayPort</param-name>
 <param-value>4443</param-value>
</param>
<param>
 <param-name>JkGatewayHttpsScheme</param-name>
 <param-value>On</param-value>
</param>
：

7.7　Hitachi Web Serverを使用するための設定

この節では，Hitachi Web Serverを使用してWebサーバと連携する場合の設定について説明します。

Hitachi Web Serverの設定

アップグレード時のHitachi Web Serverの設定

Hitachi Web ServerのSSLの設定

＜この節の構成＞

7.7.1　Hitachi Web Serverの設定

7.7.2　アップグレード時のHitachi Web Serverの設定

7.7.3　Hitachi Web ServerのSSLの設定

7.7.1　Hitachi Web Serverの設定

J2EEサーバとHitachi Web Serverとの連携に必要な認証実施順序，および注意事項を説明します。

＜この項の構成＞

(1)　認証実施順序

(2)　注意事項

(1)　認証実施順序

Webコンテナが提供する認証機能とWebサーバの認証機能※を併用した場合，次の順序で認証が実施されます。

Webサーバでの認証

Webコンテナでの認証

注※

Webサーバの認証機能とは，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証を指します。Web認証機能の併用とは，Webコンテナが提供する認証機能を使用している場合に，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証のどれか一つ以上を使用しているときを指します。

認証機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナのセキュリティ管理に関する説明を参照してください。また，Hitachi Web Serverのユーザ認証機能，およびアクセス制御機能については，マニュアル「Hitachi Web Server」を参照してください。

(2)　注意事項

●Hitachi Web Serverの再起動時の注意事項

Hitachi Web Serverの再起動に失敗した原因が，簡易構築定義ファイルにある場合，次のどちらかにメッセージが出力されます。

Hitachi Web Serverの起動コマンド実行画面またはイベントログ

Hitachi Web Serverをコマンドプロンプトから起動，停止，または再起動するときは，起動コマンド実行画面に出力されます。

Hitachi Web Serverをサービスから起動，停止，または再起動するときは，イベントログに出力されます。Windowsの場合だけが該当します。

Hitachi Web Serverのエラーログファイル
エラーログファイルは，デフォルトでは次の場所に出力されます。

Windowsの場合
<Hitachi Web Serverのインストールディレクトリ>¥logs¥error.log

UNIXの場合
opt/hitachi/httpsd/logs/error.log

それぞれに出力されるメッセージを表に示します。

表7-8　Hitachi Web Serverの起動コマンド実行画面またはイベントログに出力されるメッセージ

メッセージ
原因・対策方法

JkWorkersFile file_name invalid※
JkWorkersFileキーに指定されたファイル名が無効です。JkWorkersFileキーに指定している値を修正したあと，Webサーバを再起動してください。

Can't find the workers file specified※
指定されたワーカ定義ファイルが見つかりません。JkWorkersFileキーに指定されているファイルの有無を確認したあと，Webサーバを再起動してください。

Content should start with /※
URLパターンの先頭文字が「/」（スラッシュ）以外です。JkMountキーに指定されているURLパターンの先頭文字を「/」（スラッシュ）に修正したあと，Webサーバを再起動してください。

JkOptions: Illegal option 'a...a'
JkOptionキーに指定された値（a...a）は不正です。
JkOptionキーに指定している値を修正したあと，Webサーバを再起動してください。

a...a takes b...b arguments,
a...aに示すキーに指定できる値の数はb...bです。
a...aに示すキーに指定している値の数を修正したあと，Webサーバを再起動してください。

a...a must be On or Off
a...aに示すキーに指定できる値はOnまたはOffです。
a...aに示すキーに指定している値をOnまたはOffにしたあと，Webサーバを再起動してください。

JkModulePriority: Invalid value specified.a...a
JkModulePriorityキーに設定された値a...aが不正です。JkModulePriorityキーに正しい値を設定して，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

表7-9　Hitachi Web Serverのエラーログファイル

メッセージ
説明・対策方法

[時刻] [emerg] Memory error
メモリが不足しています。
システムが利用できるメモリ使用量を確保したあと，Webサーバを再起動してください。

[時刻] [emerg] Error while opening the workers※
次のどちらかの問題が発生しています。

ワーカ定義ファイルのオープンに失敗しました。
JkWorkersFileキーに指定されているファイルのアクセス権に読み取り権限があることを確認したあと，Webサーバを再起動してください。

ワーカ定義ファイルの内容が不正です。
ワーカ定義ファイルの内容を正しく修正したあと，Webサーバを再起動してください。

[時刻] [emerg] Error while checking the mod_jk.conf※
リダイレクタ定義ファイルに不適切な記述がありました。リダイレクタに出力されているメッセージを確認したあと，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

●リダイレクタのログに関する注意事項

ログ出力先ディレクトリにHitachi Web Serverの実行アカウントの書き込み権限がない場合，リクエストは正常に処理されますが，ログは出力されません。

Windowsの場合，デフォルトの状態ではリダイレクタのログ出力先ディレクトリ（<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs）がありません。このため，Hitachi Web Serverは，起動時に一つ上のディレクトリ（redirectorディレクトリ）のアクセス権を引き継いで，logsディレクトリを生成してログを出力しようとします。このとき，Hitachi Web Serverの実行アカウントの書き込み権限がないとログは出力されません。この場合は，logsディレクトリを生成してアクセス権を設定するか，または一つ上のディレクトリ（redirectorディレクトリ）にアクセス権を設定してください。
また，リダイレクタのログ出力先ディレクトリを変更している場合に，指定しているパスが途中までしかないときは，存在する最下層のディレクトリに対してアクセス権を設定するか，または指定したパスに対応するディレクトリをすべて作成して，最下層のディレクトリにアクセス権を設定してください。

7.7.2　アップグレード時のHitachi Web Serverの設定

Hitachi Web Serverをアップグレードした場合，Hitachi Web Server用のリダイレクタの変更内容を反映するためには，Hitachi Web Serverを再起動する必要があります。Hitachi Web Serverの再起動の方法については，マニュアル「Hitachi Web Server」を参照してください。

7.7.3　Hitachi Web ServerのSSLの設定

Hitachi Web Serverを使用してSSLによる認証やデータの暗号化をする場合，秘密鍵の作成，認証局（CA）が発行した証明書の取得，およびhttpsd.conf（Hitachi Web Server定義ファイル）の設定が必要です。

また，クライアント認証をする場合，クライアント証明書と認証局（CA）の証明書の取得，およびhttpsd.conf（Hitachi Web Server定義ファイル）の設定が必要です。

ここでは，Hitachi Web ServerのSSLによる認証，暗号化の設定，およびクライアント認証の設定について説明します。なお，詳細については，マニュアル「Hitachi Web Server」を参照してください。

＜この項の構成＞

(1)　Hitachi Web ServerのSSLによる認証，暗号化の設定

(2)　クライアント認証の設定

(1)　Hitachi Web ServerのSSLによる認証，暗号化の設定

Hitachi Web Serverを使用してSSLによる認証やデータの暗号化をする場合，次の設定をしてください。

秘密鍵の作成と認証局が発行した証明書の取得

httpsd.confの設定

(a)　秘密鍵の作成と認証局が発行した証明書の取得

Hitachi Web Serverが用意しているsslcユティリティを使用し，次に示す手順に従って証明書発行局（CA）から証明書を取得します。なお，Hitachi Web Serverが提供するテスト用CAを利用する場合は，マニュアル「Hitachi Web Server」を参照してください。

秘密鍵の作成
sslc -genrsaコマンド（UNIXの場合，sslc genrsaコマンド）を使用して，Hitachi Web Server用の秘密鍵を作成します。

証明書発行要求（CSR）の作成
sslc -reqコマンド（UNIXの場合，sslc reqコマンド）を使用して，認証局（CA）に証明書を発行してもらうための証明書発行要求（CSR）を作成します。

認証局（CA）への証明書発行要求の送付
作成したCSRファイルを電子メールなどで認証局に送って証明書を取得してください。

(b)　httpsd.confの設定

httpsd.conf（Hitachi Web Server定義ファイル）に，次に示す設定を記述してください。

SSL通信用のポートの設定
ListenディレクティブにSSL通信で使用するポートを設定します。通常，SSL通信で使用するポート番号は443です。SSL通信で使用するポート番号を指定したListenディレクティブだけを定義した場合，そのサーバはブラウザからHTTPSのリクエスト（SSL通信）以外を受け付けなくなります。そのため，HTTPのリクエストも受け付ける場合には，HTTPのリクエスト用のポート番号（通常には80）を指定したListenディレクティブの指定は残した上で，SSL通信で使用するポート番号を指定したListenディレクティブを追加してください。

SSLを有効にする設定
SSLEnableディレクティブを指定します。

秘密鍵ファイルの設定
SSLCertificateKeyFileディレクティブに「(a) 秘密鍵の作成と認証局が発行した証明書の取得」で作成した秘密鍵ファイルへのパスを指定します。

認証局（CA）が発行した証明書ファイルの設定
SSLCertificateFileディレクティブに「(a) 秘密鍵の作成と認証局が発行した証明書の取得」で取得した証明書ファイルへのパスを指定します。

記述例

SSL通信に必要な設定をしたhttpsd.confの記述例を次に示します。なお，次の記述例は，ファイルの内容の一部となります。

Windowsの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
</VirtualHost>
Include "C:/Program Files/Hitachi/Cosminexus/CC/web/redirector/mod_jk.conf"

UNIXの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
</VirtualHost>
Include "/opt/Cosminexus/CC/web/redirector/mod_jk.conf"

(2)　クライアント認証の設定

クライアント認証をする場合，次の設定をしてください。

クライアント証明書と認証局（CA）の証明書の取得

httpsd.confの設定

(a)　クライアント証明書と認証局（CA）の証明書の取得

クライアント証明書の取得
証明書の発行に使用する認証局（CA）の指示に従って，Webブラウザにクライアント証明書をインストールします。

認証局（CA）の証明書の取得
クライアント証明書を発行した認証局（CA）の証明書（PEM形式）を入手します。

(b)　httpsd.confの設定

httpsd.conf（Hitachi Web Server定義ファイル）に，次に示す設定を記述してください。

認証局（CA）の証明書ファイルの設定
SSLCACertificateFileディレクティブに「(a)　クライアント証明書と認証局（CA）の証明書の取得」で取得した証明書ファイルへのパスを指定します。

クライアント認証についての設定
SSLVerifyClientおよびSSLVerifyDepthディレクティブを使用します。

クライアント証明書情報についての設定
SSLExportClientCertificatesおよびSSLExportCertChainDepthディレクティブを使用します。

記述例

クライアント認証に必要な設定をしたhttpsd.confの記述例を次に示します。なお，次の記述例は，ファイルの内容の一部となります。

Windowsの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
SSLCACertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/cacert/cacert.pem"
SSLVerifyClient 2
SSLVerifyDepth 2
SSLExportClientCertificates
SSLExportCertChainDepth 2
</VirtualHost>

Include "C:/Program Files/Hitachi/Cosminexus/CC/web/redirector/mod_jk.conf"

UNIXの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
SSLCACertificateFile "/opt/hitachi/httpsd/conf/ssl/cacert/cacert.pem"
SSLVerifyClient 2
SSLVerifyDepth 2
SSLExportClientCertificates
SSLExportCertChainDepth 2
</VirtualHost>

Include "/opt/Cosminexus/CC/web/redirector/mod_jk.conf"

8.　インプロセスHTTPサーバの設定（J2EEアプリケーションを実行するシステム）

インプロセスHTTPサーバは，J2EEサーバのプロセス内で提供されるWebサーバ機能です。Webサーバを経由しないで，HTTPリクエストをJ2EEサーバのプロセスが直接受信することによって，Webサーバ連携時よりも優れた処理性能でWebサーバの機能を利用できます。

この章では，インプロセスHTTPサーバ機能の設定について説明します。

＜この章の構成＞

8.1　インプロセスHTTPサーバの設定の概要

8.2　Webクライアントからの接続数とリクエスト処理スレッド数の制御の設定

8.3　Webクライアントからのアクセス制御の設定

8.4　リクエストの流量制御の設定

8.5　Webクライアントとの通信制御の設定

8.6　Webクライアントへのレスポンスのカスタマイズ

8.7　リダイレクトによるリクエストの振り分けの設定

8.8　Webコンテナにゲートウェイ情報を通知するための設定

8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ

8.1　インプロセスHTTPサーバの設定の概要

この節では，インプロセスHTTPサーバの設定手順について説明します。

J2EEサーバのプロセス内で提供されるWebサーバ機能を使用して，HTTPリクエストを受信するためには，インプロセスHTTPサーバ機能を使用する構成でシステムを構築する必要があります。インプロセスHTTPサーバ機能を使用するシステムの構成や構築手順については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

設定手順を次に示します。

インプロセスHTTPサーバ機能の使用を有効にします。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.connector.inprocess_http.enabledパラメタで「true」を指定して，インプロセスHTTPサーバ機能を使用できるようにします。デフォルトでは「false」が指定されています。

Webクライアントからの接続数の制御とリクエスト処理スレッド数の制御を設定します。
サーバを稼働するホストの性能やクライアントからのアクセス状況に合わせてリクエスト処理スレッド数を調節することで，インプロセスHTTPサーバのパフォーマンスを向上できます。設定については，「8.2　Webクライアントからの接続数とリクエスト処理スレッド数の制御の設定」を参照してください。
設定時の留意点を次に示します。

サーバ起動直後から大量のリクエストを処理する必要がある場合は，サーバ起動時に作成するリクエスト処理スレッド数に大きな値を指定してください。

予備スレッドの最大数を大きくすると急なアクセス増加にも迅速に対応できますが，リソースを多く消費するため注意してください。

Webクライアントからのアクセス制御の設定をします。
クライアントからの接続や送信されるリクエストに対するセキュリティを強化することで，外部からの不正アクセスやサーバへの攻撃を防ぐことができます。設定については，「8.3　Webクライアントからのアクセス制御の設定」を参照してください。

必要に応じて，次の機能についても設定してください。

リクエストの流量制御の設定
Webクライアントからの同時接続数やWebコンテナでの同時実行スレッド数を制御することで，J2EEサーバの負荷を抑えることができます。設定については，「8.4　リクエストの流量制御の設定」を参照してください。

Webクライアントとの通信制御の設定
Persistent Connectionの使用や通信タイムアウトの設定をすることで，WebクライアントとインプロセスHTTPサーバ間での処理時間の短縮，障害の発生の検知などができます。設定については，「8.5　Webクライアントとの通信制御の設定」を参照してください。

Webクライアントへのレスポンスのカスタマイズ
HTTPレスポンスのServerヘッダやエラー発生時のエラーページをカスタマイズできます。設定については，「8.6　Webクライアントへのレスポンスのカスタマイズ」を参照してください。

リダイレクトによるリクエストの振り分けの設定
HTTPリクエストに含まれるURLパターンによってリクエストを振り分けることができます。設定については，「8.7　リダイレクトによるリクエストの振り分けの設定」を参照してください。

Webコンテナにゲートウェイ情報を通知するための設定
Webコンテナにゲートウェイ情報を通知して，WebアプリケーションのトップページやForm認証画面に正しくリダイレクトできます。設定については，「8.8　Webコンテナにゲートウェイ情報を通知するための設定」を参照してください。

インプロセスHTTPサーバのアクセスログの設定
インプロセスHTTPサーバで出力するログやトレースのうち，アクセスログでは出力形式をカスタマイズできます。設定については，「8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ」を参照してください。

以降の節では，インプロセスHTTPサーバで提供する機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

なお，インプロセスHTTPサーバ機能の概要，Webサーバ（Hitachi Web ServerおよびIIS）との機能差異については，マニュアル「Cosminexus　機能解説」のインプロセスHTTPサーバによるリクエストの受け付けに関する説明を参照してください。また，簡易構築定義ファイルおよびパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

8.2　Webクライアントからの接続数とリクエスト処理スレッド数の制御の設定

この節では，Webクライアントからのリクエストを処理するスレッドを制御する機能として，次の機能の設定について説明します。

Webクライアントからの接続数の制御の設定

リクエスト処理スレッド数の制御の設定

＜この節の構成＞

8.2.1　Webクライアントからの接続数の制御の設定

8.2.2　リクエスト処理スレッド数の制御の設定

8.2.1　Webクライアントからの接続数の制御の設定

ここでは，Webクライアントからの接続数の制御の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(1)　概要

インプロセスHTTPサーバでは，一度に接続できるWebクライアントやプロキシサーバの数の最大値を設定することで，インプロセスHTTPサーバで作成するリクエスト処理スレッド数を制御できます。

(2)　設定方法

Webクライアントからの接続数の制御は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.max_connections
Webクライアントやプロキシサーバとの接続数の最大値を指定します。インプロセスHTTPサーバでは，Webクライアントからの接続数分のリクエスト処理スレッドを作成するため，ここで指定した値がリクエスト処理スレッド数の上限になります。

webserver.connector.inprocess_http.backlog
Webクライアントからの接続数の上限を超えたHTTPリクエストは，Listenキューに蓄えられます。ここでは，Listenキューの登録数の最大値を指定します。

8.2.2　リクエスト処理スレッド数の制御の設定

ここでは，リクエスト処理スレッド数の制御の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(1)　概要

インプロセスHTTPサーバでは，起動時にリクエスト処理スレッドを作成したあと，リクエスト処理スレッドの状態，およびスレッド数を定期的に監視することで，サーバの負荷に応じてリクエスト処理スレッドの数を調整できます。

(2)　設定方法

リクエスト処理スレッド数の制御は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.init_threads
J2EEサーバ起動時に作成するリクエスト処理スレッド数を指定します。

webserver.connector.inprocess_http.min_spare_threads
予備スレッドの最小値を指定します。予備スレッド数が指定した最小値より少ない場合は，リクエスト処理スレッドが追加されて予備スレッドとしてプールされます。

webserver.connector.inprocess_http.max_spare_threads
予備スレッドの最大値を指定します。予備スレッド数が指定した最大値より多い場合は，余分な予備スレッドが削除されます。予備スレッドの最大値をWebクライアントからの接続数の最大値と同じ値にすることによって，一度作成したリクエスト処理スレッドを削除しないで使い続けることができます。

webserver.connector.inprocess_http.keep_start_threads
J2EEサーバ起動時に作成したリクエスト処理スレッドを維持するかどうかを指定します。

8.3　Webクライアントからのアクセス制御の設定

この節では，Webクライアントからのアクセスを制御する機能として，次の機能の設定について説明します。

アクセスを許可するホストの制限の設定

リクエストデータのサイズ制限の設定

有効なHTTPメソッドの制限の設定

＜この節の構成＞

8.3.1　アクセスを許可するホストの制限の設定

8.3.2　リクエストデータのサイズ制限の設定

8.3.3　有効なHTTPメソッドの制限の設定

8.3.1　アクセスを許可するホストの制限の設定

ここでは，アクセスを許可するホストの制限の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

J2EEサーバへの不正アクセスを防ぐため，アクセスできるホストを制限できます。デフォルトでは，全ホストからのアクセスが可能な状態になっています。アクセスを許可するホストのホスト名やIPアドレスを設定しておくことで，特定のホストからのアクセスだけを許可して，不正アクセスを防止できます。

(2)　設定方法

アクセスを許可するホストの制限は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.permitted.hosts
アクセスを許可するホストのホスト名やIPアドレスを指定します。

注意

アクセスを許可するホストをホスト名で指定した場合の注意事項を次に示します。

hosts，またはDNSなどでホスト名を解決できるようにする必要があります。解決できない場合はデフォルトの設定（全ホストからのアクセスが可能な状態）でJ2EEサーバが起動されます。

J2EEサーバの起動時にホスト名を解決するため，J2EEサーバの起動に時間が掛かることがあります。また，起動後に変更されたIPアドレスは反映されないことがあります。

(3)　設定例

アクセスを許可するホストの制限の設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.permitted.hosts</param-name>
 <param-value>host1,host2</param-value>
</param>
：

この設定例では，「host1」と「host2」からのアクセスだけを許可し，ほかのホストからのアクセスを許可しません。

8.3.2　リクエストデータのサイズ制限の設定

ここでは，リクエストデータのサイズ制限の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバでは，一定のサイズ以下のリクエストデータだけを受け付けることによって，不正なリクエストデータの受け付けを拒否し，サーバへの負荷を抑え，安定した稼働を維持できます。

(2)　設定方法

リクエストデータのサイズ制限は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.limit.max_request_line
リクエストラインの上限値を指定します。

webserver.connector.inprocess_http.limit.max_headers
HTTPリクエストに含まれるHTTPヘッダ数の上限値を指定します。

webserver.connector.inprocess_http.limit.max_request_header
HTTPリクエストのリクエストヘッダのサイズの上限値を指定します。

webserver.connector.inprocess_http.limit.max_request_body
HTTPリクエストのボディサイズの上限値を指定します。

ポイント

SSLアクセラレータや負荷分散機などのゲートウェイ機器や，プロキシサーバを配置していて，ゲートウェイ機器やプロキシサーバにリクエストデータサイズの制御機能がある場合は，その制御機能の設定値以下の値を設定する必要があります。

(3)　設定例

リクエストデータのサイズ制限の設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.limit.max_request_line</param-name>
 <param-value>1024</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.limit.max_headers</param-name>
 <param-value>100</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.limit.max_request_header</param-name>
 <param-value>8192</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.limit.max_request_body</param-name>
 <param-value>16384</param-value>
</param>
：

8.3.3　有効なHTTPメソッドの制限の設定

ここでは，有効なHTTPメソッドの制限について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバでは，HTTPリクエストで有効なHTTPメソッドのメソッド名を設定しておき，無効なHTTPメソッドを含むリクエストの受け付けを拒否することで，サーバ上のリソースへの不正アクセスを防止できます。なお，有効なHTTPメソッドとして設定する値は，RFC2616に規定されている値を使用する必要があります。ただし，メソッド名の文字列にアスタリスク（*）は使用できません。

(2)　設定方法

有効なHTTPメソッドの制限は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.enabled_methods
有効なHTTPメソッドのメソッド名を指定します。

ポイント

静的コンテンツに対してOPTIONSメソッドを含むリクエストを送信した場合，静的コンテンツに対してデフォルトで有効なメソッド（GETメソッド，POSTメソッド，TRACEメソッド，およびOPTIONSメソッド）から，インプロセスHTTPサーバで無効なメソッドを除いたリクエストが返されます。サーブレット/JSPの場合，Webアプリケーションの実装に依存します。

(3)　設定例

有効なHTTPメソッドの制限の設定例を次に示します。なお，この設定例はデフォルトの設定です。

：
<param>
 <param-name>webserver.connector.inprocess_http.enabled_methods</param-name>
 <param-value>GET,HEAD,POST,PUT,DELETE,OPTIONS</param-value>
</param>
：

この設定例では，GETメソッド，HEADメソッド，POSTメソッド，PUTメソッド，DELETEメソッド，およびOPTIONSメソッドに対してアクセスを許可し，TRACEメソッドに対してアクセスを拒否します。

8.4　リクエストの流量制御の設定

この節では，リクエストの流量を制御する機能として，次の機能の設定について説明します。

Webクライアントからの同時接続数の制御の設定

Webコンテナでの同時実行スレッド数の制御の設定

＜この節の構成＞

8.4.1　Webクライアントからの同時接続数の制御の設定

8.4.2　同時実行スレッド数の制御の設定

8.4.1　Webクライアントからの同時接続数の制御の設定

ここでは，Webクライアントからの同時接続数の制御について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバでは，Webクライアントからの最大接続数の設定とあわせて，接続を拒否するリクエスト数を設定することで，Webクライアントからの同時接続数を制御できます。Webクライアントからの最大接続数から接続を拒否するリクエスト数を引いた値が，Webクライアントからの接続を承諾する数となります。

Webクライアントからの接続数の増加やJ2EEアプリケーションなどの影響でJ2EEサーバの負荷が高くなった場合に，Webクライアントからのリクエストの受け付けを拒否して即座にエラーを返すことで，Webクライアントは即座にレスポンスを受信できます。これによって，J2EEサーバの負荷を一定に抑え，リクエストに対するレスポンスタイムを維持できます。

(2)　設定方法

Webクライアントからの同時接続数の制御は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.rejection_threads
接続を拒否するリクエスト数を指定します。

注意

フレームを使用したページや，画像を挿入したページを表示する際，Webクライアントから複数のリクエストを受信する場合があります。その場合，Webクライアントからの同時接続数の制御によって表示されるページが部分的にエラーになることがあります。

(3)　設定例

Webクライアントからの同時接続数の制御の設定例について説明します。

次に，リクエスト処理スレッド数の上限が40，接続を拒否するリクエスト処理スレッド数が1の場合の設定例を示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.max_connections</param-name>
 <param-value>40</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.rejection_threads</param-name>
 <param-value>1</param-value>
</param>
：

この設定例では，接続後に同時にリクエストを処理できるWebクライアントの数は39となります。リクエスト処理中のスレッド数が39に達すると，残りの1スレッドはWebクライアントに対してエラーを返し続けます。

Webクライアントからの同時接続数の制御によって，接続を拒否したリクエストに対しては，ステータスコード503（Service Unavailable）のエラーをWebクライアントに返します。このときクライアントに返すエラーページをカスタマイズすると，レスポンスメッセージのカスタマイズや，ほかのサーバへのリダイレクトができます。それぞれの場合の設定例を次に示します。なお，エラーページのカスタマイズについては，「8.6.2　エラーページのカスタマイズの設定」を参照してください。

レスポンスメッセージをカスタマイズする場合
Webクライアントからの接続を拒否した場合に，レスポンスボディとして特定のファイルをWebクライアントに返すための設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.rejection_threads</param-name>
 <param-value>3</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.list</param-name>
 <param-value>REJECTION_1</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.status</param-name>
 <param-value>503</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.file</param-name>
 <param-value>C:/data/busy.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.file.content_type=text/html; charset</param-name>
 <param-value>ISO-8859-1</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.request_url</param-name>
 <param-value>/*</param-value>
</param>
：

この設定例では，エラーステータスコードに「503」，対応するエラーページのファイルに「C:/data/busy.html」，レスポンスのContent-Typeヘッダに「text/html; charset=ISO-8859-1（Media-Typeはtext/htmlで，ISO-8859-1文字セットを使用）」，URLパターンに「/*」を指定しています。このため，エラーステータスコード「503」が発生した場合には，リクエストのURIに関係なく，「C:/data/busy.html」のファイルの内容をレスポンスとして返します。

ほかのサーバへリダイレクトする場合
接続を拒否したリクエストをほかのサーバへリダイレクトする場合の設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.rejection_threads</param-name>
 <param-value>3</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.list</param-name>
 <param-value>REJECTION_1</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.status</param-name>
 <param-value>503</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.redirect_url</param-name>
 <param-value>http://host1/busy.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.REJECTION_1.request_url</param-name>
 <param-value>/*</param-value>
</param>
<param>
：

この設定例では，エラーステータスコードに「503」，対応するエラーページのファイルに「http://host1/busy.html」，URLパターンに「/*」を指定しています。このため，エラーステータスコード「503」が発生した場合には，リクエストのURIに関係なく，すべてのリクエストが「http://host1/busy.html」のURLにリダイレクトされます。

8.4.2　同時実行スレッド数の制御の設定

ここでは，Webコンテナでの同時実行スレッド数の制御の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(1)　概要

Webコンテナでは，マルチスレッドでサーブレットのリクエストを処理します。このとき，同時に実行できるスレッド数に上限を設定することで，スラッシングなどによるパフォーマンスの低下を防止できます。また，適切なスレッド数を設定することで，アクセス状況に従ったパフォーマンスのチューニングができます。

(2)　設定方法

同時に実行するスレッド数を制御するには，Webコンテナ単位で制御する方法，Webアプリケーション単位で制御する方法，およびURLグループ単位で制御する方法の3種類あります。

(a)　Webコンテナ単位での制御

Webコンテナ単位で同時実行スレッド数を制御する場合，Webコンテナ全体で同時に実行できるスレッドの最大数を設定します。ここで設定したスレッド数は，WebコンテナにデプロイされているすべてのWebアプリケーションで共用するスレッド数となります。

Webコンテナ単位での同時実行スレッド数の制御は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.max_execute_threads
Webコンテナ全体で同時に実行できるスレッドの最大数を指定します。

(b)　Webアプリケーション単位での制御

Webアプリケーション単位で同時実行スレッド数を制御する場合，Webコンテナでのスレッド数制御も同時に設定する必要があります。

Webアプリケーション単位での同時実行スレッド数の制御は，簡易構築定義ファイルおよびサーバ管理コマンドで設定します。設定方法は，Webサーバ連携機能を使用する場合と同じです。Webサーバ連携機能を使用する場合の，Webアプリケーション単位での同時実行スレッド数の設定方法については，「4.4　同時実行スレッド数の制御の設定」を参照してください。

(c)　URLグループ単位での制御

URLグループ単位で同時実行スレッド数を制御する場合，Webアプリケーション単位での同時実行スレッド数制御，およびWebコンテナでのスレッド数制御も同時に設定する必要があります。

URLグループ単位での同時実行スレッド数の制御は，サーバ管理コマンドで設定します。設定方法は，Webサーバ連携機能を使用する場合と同じです。Webサーバ連携機能を使用する場合の，URLグループ単位での同時実行スレッド数の設定方法については，「4.4　同時実行スレッド数の制御の設定」を参照してください。

8.5　Webクライアントとの通信制御の設定

この節では，Webクライアントとの通信を制御する機能として，次の機能の設定について説明します。

Persistent Connectionによる通信制御の設定

インプロセスHTTPサーバの通信タイムアウトの設定

インプロセスHTTPサーバのIPアドレスの設定

＜この節の構成＞

8.5.1　Persistent Connectionによる通信制御の設定

8.5.2　インプロセスHTTPサーバの通信タイムアウトの設定

8.5.3　インプロセスHTTPサーバのIPアドレスの設定

8.5.1　Persistent Connectionによる通信制御の設定

ここでは，Persistent Connectionによる通信制御の設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

Persistent Connectionは，WebクライアントとWebサーバ間で確立したTCPコネクションを持続して，複数のHTTPリクエスト間で使用し続けるための機能です。Persistent Connectionを使用することによって，WebクライアントとインプロセスHTTPサーバ間でのコネクション接続に掛かる時間を短縮し，処理時間の短縮と通信トラフィックの軽減を図れます。

(2)　設定方法

Persistent Connectionによる通信制御は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.persistent_connection.max_connections
一つのTCPコネクションで連続してリクエストを処理できるWebクライアント数を制御するため，Persistent Connection数の上限値を指定します。

webserver.connector.inprocess_http.persistent_connection.max_requests
同じWebクライアントから連続してリクエスト要求があった場合の処理を制御するため，Persistent Connectionのリクエスト処理回数の上限値を指定します。

webserver.connector.inprocess_http.persistent_connection.timeout
Persistent Connectionのリクエスト待ち時間を制御するため，Persistent Connectionのタイムアウトを指定します。

(3)　設定例

Persistent Connectionによる通信制御の設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.persistent_connection.max_connections</param-name>
 <param-value>5</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.persistent_connection.max_requests</param-name>
 <param-value>100</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.persistent_connection.timeout</param-name>
 <param-value>15</param-value>
</param>
：

この設定例では，TCPコネクション数が「5」を超えた場合，またはリクエスト処理回数が「100」を超えた場合には，リクエスト処理終了後にTCPコネクションを切断します。また，タイムアウト時間「15」秒を過ぎてもリクエスト処理要求がない場合は，TCPコネクションを切断します。

8.5.2　インプロセスHTTPサーバの通信タイムアウトの設定

ここでは，インプロセスHTTPサーバの通信タイムアウトの設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバを使用する場合，WebクライアントとインプロセスHTTPサーバ間での，リクエスト受信およびレスポンス送信に，通信のタイムアウトを設定できます。ネットワークの障害やアプリケーションの障害発生などで応答待ち状態になった場合，通信タイムアウトを設定していると，タイムアウトの発生によって障害の発生を検知できます。

(2)　設定方法

通信タイムアウトは，リクエストの受信時，またはレスポンスの送信時に設定します。リクエスト受信時およびレスポンス送信時の通信タイムアウトの設定についてそれぞれ説明します。

リクエスト受信時の通信タイムアウトの設定
リクエスト受信時の通信タイムアウトは，クライアント－インプロセスHTTPサーバ間に設定します。リクエスト受信時の通信タイムアウトの設定場所について，次の図に示します。

図8-1　リクエスト受信時の通信タイムアウトの設定場所（インプロセスHTTPサーバの場合）

インプロセスHTTPサーバでのリクエスト受信時の通信タイムアウトは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.receive_timeout
クライアントからのリクエスト受信処理の待ち時間を指定します。

レスポンス送信時の通信タイムアウトの設定
レスポンス送信時の通信タイムアウトは，インプロセスHTTPサーバ－クライアント間に設定します。レスポンス送信時の通信タイムアウトの設定場所について，次の図に示します。

図8-2　レスポンス送信時の通信タイムアウトの設定場所（インプロセスHTTPサーバの場合）

インプロセスHTTPサーバでのレスポンス送信時の通信タイムアウトは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.send_timeout
クライアントへのレスポンス送信処理の待ち時間を指定します。

(3)　設定例

インプロセスHTTPサーバの通信タイムアウトの設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.receive_timeout</param-name>
 <param-value>300</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.send_timeout</param-name>
 <param-value>600</param-value>
</param>
：

この設定例では，リクエスト受信のタイムアウトに「300」秒，リクエスト送信のタイムアウトに「600」秒を設定しています。

8.5.3　インプロセスHTTPサーバのIPアドレスの設定

ここでは，インプロセスHTTPサーバのIPアドレスの設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(1)　概要

Webコンテナでは，インプロセスHTTPサーバで利用するIPアドレスを明示的に指定できます。これを，バインド先アドレス設定機能といいます。この機能を使用することで，複数の物理ネットワークインタフェースを持つホスト，または一つの物理ネットワークインタフェースに対して，ホストで実行する場合に，特定の一つのIPアドレスだけを使用するように設定できます。

(2)　設定方法

インプロセスHTTPサーバのIPアドレスは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.bind_host
インプロセスHTTPサーバで利用するホスト名またはIPアドレスを指定します。

ホスト名またはIPアドレスを設定した場合は，指定されたIPアドレスへの接続要求しか受け付けません。IPアドレスを設定する代わりに，ワイルドカードアドレスを指定することで，そのホスト上の任意のIPアドレスへの接続を受け付けることができます。デフォルトでは，ワイルドカードアドレスを使用する設定になっています。なお，ワイルドカードアドレスを使用する場合は，次のことに注意してください。

指定されたホスト名が，hostsファイルまたはDNSなどで解決できない場合は，ワイルドカードアドレスを使用してサーバを起動します。

指定されたホスト名，またはIPアドレスがリモートホストの場合は，ワイルドカードアドレスを使用してサーバを起動します。

8.6　Webクライアントへのレスポンスのカスタマイズ

この節では，Webクライアントへのレスポンスのカスタマイズ機能として，次の機能の設定について説明します。

HTTPレスポンスヘッダのカスタマイズの設定

エラーページのカスタマイズの設定

＜この節の構成＞

8.6.1　HTTPレスポンスヘッダのカスタマイズの設定

8.6.2　エラーページのカスタマイズの設定

8.6.1　HTTPレスポンスヘッダのカスタマイズの設定

ここでは，HTTPレスポンスヘッダのカスタマイズの設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバでは，HTTPレスポンスのServerヘッダに自動設定する情報をカスタマイズできます。デフォルトでは，「CosminexusComponentContainer」が自動設定されます。なお，Serverヘッダに自動設定する値は，RFC2616に規定されている値を使用する必要があります。サーブレット/JSPでServerヘッダを使用する設定にしている場合はその設定が優先されます。

(2)　設定方法

HTTPレスポンスヘッダのカスタマイズは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.response.header.server
HTTPレスポンスのServerヘッダに自動設定する文字列を指定します。

(3)　設定例

HTTPレスポンスヘッダのカスタマイズの設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.response.header.server</param-name>
 <param-value>GyoumuServer/1.0</param-value>
</param>
：

この設定例では，Serverヘッダの値として「GyoumuServer/1.0」を指定しています。

8.6.2　エラーページのカスタマイズの設定

ここでは，エラーページのカスタマイズの設定について説明します。

＜この項の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

存在しないリソースへのアクセスなどのエラーが発生したときに，エラーステータスコードが表示されたエラーページの代わりにユーザが作成したエラーページをクライアントに表示させることができます。インプロセスHTTPサーバによるエラーページのカスタマイズを利用することで，特定のステータスコードに対応するエラーページのカスタマイズや，リクエストURLに対応するエラーページのカスタマイズをWebコンテナ単位にまとめて制御できます。また，次に示すようなWebアプリケーションによるエラーページのカスタマイズが実行できない場合でも，エラーページをカスタマイズできます。

リクエストに対応するコンテキストがない場合（ステータスコード404）

停止処理中のコンテキストでリクエスト処理を実行しようとした場合（ステータスコード503）

インプロセスHTTPサーバがエラーステータスコードを返す場合

インプロセスHTTPサーバが返すエラーステータスコードを次の表に示します。

表8-1　インプロセスHTTPサーバが返すエラーステータスコード

エラーステータスコード
説明句
エラーの発生条件

400
Bad Request

リクエストのHTTPバージョンが1.1であり，Hostヘッダがない。

リクエストのHostヘッダのポート番号が不正である。

リクエストヘッダのサイズが上限値を超えた。

リクエストヘッダの数が上限値を超えた。

リクエストURIが不正である。

リクエストのContent-Lengthヘッダの値が2,147,483,647より大きい，または0より小さい。

リクエストのContent-Lengthヘッダの値が数値以外である。

リクエストのContent-Lengthヘッダが複数指定されている。

リクエストラインのHTTPバージョンがサポートされていない。

405
Method Not Allowed

許可しないHTTPメソッドによってアクセスされた。

413
Request Entity Too Large

リクエストボディのサイズが上限値を超えた。

414
Request-URI Too Long

リクエストラインの長さが上限値を超えた。

500
Internal Server Error

リダイレクト機能によってステータスコード200でファイルを返す際に，ファイルの読み込みに失敗した。

501
Not Implemented

リクエストのtransfer-encodingヘッダの値がサポートされていない。

503
Service Unavailable

流量制御の上限を超えてリクエスト処理を実行しようとした。

インプロセスHTTPサーバによるエラーページのカスタマイズを実行する場合，javax.servlet.http.HttpServletResponseインタフェースのsendErrorメソッドを使用してレスポンスのステータスコードを設定する必要があります。なお，setStatusメソッドを使用した場合（JSPでsetStatusメソッドを使用した場合など），インプロセスHTTPサーバによるカスタマイズが実行されないことがあります。ただし，sendErrorメソッドを使用しても，Webアプリケーションが次に示すどちらかの条件に該当する場合，インプロセスHTTPサーバによるエラーページのカスタマイズは実行されません。

sendErrorメソッドの実行時に例外が発生した場合

Webアプリケーションでエラーページのカスタマイズの設定をしていて，エラー発生時にその設定によるエラーページの実行が正常終了した場合（エラーページでcatchされない例外が発生しないで，ステータスコードが400～599以外で終了した場合）

(2)　設定方法

エラーページのカスタマイズは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.error_custom.list
エラーページのカスタマイズ定義名を指定します。

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.status
エラーステータスコードに対応づけるエラーページのカスタマイズをする場合に，エラーページをカスタマイズするエラーステータスコードを指定します。

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file
エラーステータスコードに対応するファイルを送信する場合に，レスポンスボディとしてクライアントに返すファイルを指定します。

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file.content_type
webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.fileパラメタに指定したファイルをレスポンスボディとしてクライアントに送信する際のContent-Typeヘッダの値を指定します。

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.redirect_url
エラーステータスコードに対応するリダイレクトをする場合に，リダイレクト先のURLを指定します。

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.request_url
リクエストURLに対応づけるエラーページのカスタマイズをする場合に，エラーページのカスタマイズを適用するリクエストURLを指定します。

注意

HTTPレスポンスがHTMLファイルの場合，そのHTMLからほかのファイル（画像ファイルなど）を参照していると，エラーページが正しく表示されないことがあります。

ブラウザの設定によっては，ステータスコードがエラーを示し，レスポンスボディのサイズが小さい場合に，レスポンスボディをブラウザ固定のメッセージに置き換えて表示することがあるので注意してください。特にエラーページをカスタマイズしなかった場合に表示されるデフォルトのエラーページは，レスポンスボディのサイズが小さいため注意してください。

リダイレクトURLの指定値とリクエストURLの指定値が一致して，リダイレクト後に同じエラーステータスが発生すると，クライアントによってはリダイレクトを実行し続けることがあるため注意してください。

ステータスコードに対応するリダイレクトを実施する場合，エラー発生時にリクエストURLに付加されていたクエリー文字列はリダイレクトURLに付加されません。また，URLの書き換えによるセッション管理をしている場合，エラーの発生したページと同じWebアプリケーション内へのリダイレクトを実施してもセッションを引き継ぐことはできません。

(3)　設定例

エラーページのカスタマイズの設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.list</param-name>
 <param-value>ERR_CUSTOM_1,ERR_CUSTOM_2</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.status</param-name>
 <param-value>404</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.file</param-name>
 <param-value>C:/data/404.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.file.content_type</param-name>
 <param-value>text/html; charset=ISO-8859-1</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.status</param-name>
 <param-value>503</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.redirect_url</param-name>
 <param-value>http://host1/503.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.request_url</param-name>
 <param-value>/dir1/*</param-value>
</param>
：

この設定例では，エラーページのカスタマイズ定義名として，「ERR_CUSTOM_1」と「ERR_CUSTOM_2」を使用しています。「ERR_CUSTOM_1」では，レスポンスのステータスコードが「404」の場合には，「C:/data/404.html」をクライアントに返します。Content-Typeヘッダの値は，「text/html; charset=ISO-8859-1」を使用します。また，「ERR_CUSTOM_2」では，リクエストが「/dir1/」から始まるURLで，レスポンスのステータスコードが「503」の場合に，「http://host1/503.html」にリダイレクトします。

8.7　リダイレクトによるリクエストの振り分けの設定

この節では，リダイレクトによるリクエストの振り分けの設定について説明します。

＜この節の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

インプロセスHTTPサーバでは，HTTPリクエストに含まれるURLパターンによってリクエストを振り分けることができます。また，振り分けたリクエストに対するレスポンスをカスタマイズして特定のファイルをクライアントに返すこともできます。リダイレクトするURLへのリクエストに対するレスポンスのステータスコードが300番台の場合，レスポンスボディを自動生成してクライアントにレスポンスを返します。また，指定したファイルをレスポンスボディとして使用することもできます。ファイルを指定する場合，レスポンスのContent-Typeヘッダもあわせて指定します。

自動生成されるレスポンスボディを次に示します。

<HTML><HEAD>
<TITLE>ステータスコードおよび説明句</TITLE>
</HEAD><BODY>
<H1>ステータスコードおよび説明句</H1>
</BODY></HTML>

レスポンスボディが自動生成されるステータスコードおよび説明句を次に示します。

300 Multiple Choices

301 Moved Permanently

302 Found

303 See Other

305 Use Proxy

307 Temporary Redirect

リクエスト処理時にレスポンスボディとして使用するファイルの読み込みに失敗した場合，ステータスコードに300番台が指定されていれば，レスポンスボディを自動生成してクライアントに返します。ステータスコードに200が指定されていれば，ステータス500エラーをクライアントに返します。

(2)　設定方法

リダイレクトによるリクエストの振り分けは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.redirect.list
リダイレクト定義名を指定します。

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.request_url
リダイレクトするリクエストのURLを「/」（スラッシュ）で始まる絶対パスで指定します。

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.redirect_url
リクエストのリダイレクト先のURLを指定します。なお，ステータスコードに200を指定した場合は，URLを指定できません。

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.status
リダイレクトを実行する場合のレスポンスのステータスコードを指定します。

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.file
特定のファイルをレスポンスとしてクライアントに返す場合にレスポンスボディとして使用するファイルを指定します。なお，ステータスコードに200を指定した場合は，使用するファイルを指定する必要があります。

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.file.content_type
特定のファイルをレスポンスとしてクライアントに返す場合にレスポンスボディとして使用するファイルのContent-Typeヘッダを指定します。

注意

HTTPレスポンスがHTMLファイルの場合，そのHTMLからほかのファイル（画像ファイルなど）を参照していると，正しくブラウザに表示されないことがあります。

リダイレクトURLの指定値がリクエストURLの指定値と一致する場合，クライアントによってはリダイレクトを実行し続けることがあります。

URLの書き換えによるセッション管理をしている場合，リクエストURLと同じWebアプリケーション内へのリダイレクトを実行してもセッションを引き継ぐことはできません。

(3)　設定例

リダイレクトによるリクエストの振り分けの設定例について説明します。

設定例1
リダイレクトによるリクエストの振り分けの設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.redirect.list</param-name>
 <param-value>REDIRECT_1,REDIRECT_2</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_1.request_url</param-name>
 <param-value>/index.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_1.redirect_url</param-name>
 <param-value>http://host1/new_dir/index.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_1.status</param-name>
 <param-value>302</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_2.request_url</param-name>
 <param-value>/old_dir/*</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_2.redirect_url</param-name>
 <param-value>http://host1/new_dir/</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_2.status</param-name>
 <param-value>301</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_2.file</param-name>
 <param-value>C:/data/301.html</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_2.file.content_type</param-name>
 <param-value>text/html; charset=ISO-8859-1</param-value>
</param>
：

この設定例では，リダイレクト定義名として，「REDIRECT_1」と「REDIRECT_2」を使用しています。「REDIRECT_1」では，「/index.html」へのリクエストを「http://host1/new_dir/index.html」にステータスコード「302」でリダイレクトします。「REDIRECT_2」では，「/old_dir/」以下へのリクエストを「http://host1/new_dir/」以下にステータス「301」でリダイレクトします。また，レスポンスボディとして「C:/data/301.html」を使用し，Content-Typeヘッダとして「text/html; charset=ISO-8859-1」を使用します。

設定例2
リクエストURLとしてワイルドカードを使用し，リダイレクトURLに「/」で終わる値を指定した場合，レスポンスのLocationヘッダに設定される値は，「リダイレクトURLに指定した値」＋「実際のリクエストURLのワイルドカード以降のパス」になります。

：
<param>
 <param-name>webserver.connector.inprocess_http.redirect.list</param-name>
 <param-value>REDIRECT_3</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_3.request_url</param-name>
 <param-value>/dir1/*</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.redirect.REDIRECT_3.redirect_url</param-name>
 <param-value>http://host/dir2/</param-value>
</param>
：

この設定例の場合，実際のリクエストURLが「/dir1/subdir1/index.html」のときには，Locationヘッダには「http://host/dir2/subdir1/index.html」が設定されます。なお，リクエストURLの指定でワイルドカードを使用した場合でも，リダイレクトURLが「/」で終わらないときは，Locationヘッダの値は，リダイレクトURLと同じ値になります。
リダイレクトが行われる際，実際のリクエストURLにクエリー文字列が付加されていた場合，Locationヘッダに設定される値は，リダイレクトURLの指定値にクエリー文字列を付加した値となります。また，リダイレクトURLにはクエリー文字列の付いた値を指定できます。この場合，実際のリクエストURLにもクエリー文字列が付いているときは，Locationヘッダに設定される値は，リダイレクトURLの指定値の後ろにリクエストのクエリー文字列が付加された値となります。

8.8　Webコンテナにゲートウェイ情報を通知するための設定

この節では，Webコンテナにゲートウェイ情報を通知するための設定について説明します。

＜この節の構成＞

(1)　概要

(2)　設定方法

(3)　設定例

(1)　概要

クライアントとインプロセスHTTPサーバとの間に，SSLアクセラレータや負荷分散機などのゲートウェイを配置している場合，ゲートウェイ指定機能を使用することで，Webコンテナにゲートウェイ情報を通知し，WebアプリケーションのトップページやForm認証画面に正しくリダイレクトできるようになります。

(2)　設定方法

Webコンテナにゲートウェイ情報を通知するための設定は，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

webserver.connector.inprocess_http.gateway.https_scheme
リダイレクト先URLのスキームを指定します。

webserver.connector.inprocess_http.gateway.host
ゲートウェイのホスト名を指定します。

webserver.connector.inprocess_http.gateway.port
ゲートウェイのポート番号を指定します。

(3)　設定例

ゲートウェイ指定機能の設定例を次に示します。

：
<param>
 <param-name>webserver.connector.inprocess_http.gateway.host</param-name>
 <param-value>host1</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.gateway.port</param-name>
 <param-value>4443</param-value>
</param>
<param>
 <param-name>webserver.connector.inprocess_http.gateway.https_scheme</param-name>
 <param-value>true</param-value>
</param>
：

この設定例では，ゲートウェイ指定機能を使用して，スキームを常にHTTPSとみなすように設定しています。

8.9　インプロセスHTTPサーバのアクセスログのカスタマイズ

インプロセスHTTPサーバでは，アプリケーション開発のサポート，運用時の性能解析，および障害発生時のトラブルシュートのために，アクセスログ，性能解析トレース，スレッドトレース，および通信トレースを出力します。これらのファイルは，ファイル面数やファイルサイズなどを変更できます。また，アクセスログでは，ログの出力形式をカスタマイズできます。

この節では，インプロセスHTTPサーバのアクセスログの出力形式のカスタマイズについて説明します。インプロセスHTTPサーバのアクセスログおよびトレースファイルのファイル面数やファイルサイズなどの変更については，「5.10　インプロセスHTTPサーバのログ取得の設定」を参照してください。

＜この節の構成＞

(1)　カスタマイズの手順

(2)　アクセスログのフォーマット

(3)　アクセスログのフォーマットの引数

(1)　カスタマイズの手順

アクセスログの出力形式のカスタマイズの手順を次に示します。

アクセスログのフォーマット名を定義します。
フォーマットを新規作成する場合には，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.logger.access_log.format_listパラメタで，新規に作成するフォーマット名を追加します。なお，デフォルトで設定されている文字列「common,combined」は削除しないでください。

設定例

：
<param>
 <param-name>webserver.logger.access_log.format_list</param-name>
 <param-value>common,combined,formatA</param-value>
</param>
：

フォーマットを新規作成する場合には，デフォルトで提供されているアクセスログのフォーマットを参考にしてください。フォーマットについては，「(2)　アクセスログのフォーマット」を参照してください。

アクセスログの出力形式を定義します。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.logger.access_log.<フォーマット名>パラメタで，<フォーマット名>で指定したフォーマットでのアクセスログの出力形式を定義します。出力形式の定義では，アクセスログのフォーマットの引数を指定します。

設定例

：
<param>
 <param-name>webserver.logger.access_log.formatA</param-name>
 <param-value>%h %u %t "%r" %>s HostHeader="%{host}i"</param-value>
</param>
：

指定できるフォーマットの引数については，「(3)　アクセスログのフォーマットの引数」を参照してください。

アクセスログの出力に使用するフォーマットを指定します。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.logger.access_log.inprocess_http.usage_formatパラメタで，アクセスログの出力に使用するフォーマット名を指定します。ここで指定したフォーマットで，アクセスログが出力されるようになります。

設定例

：
<param>
 <param-name>webserver.logger.access_log.inprocess_http.usage_format</param-name>
 <param-value>formatA</param-value>
</param>
：

(2)　アクセスログのフォーマット

Cosminexusでは，インプロセスHTTPサーバのアクセスログのフォーマットとして，common（デフォルトフォーマット）とcombined（拡張フォーマット）という2種類のフォーマットを提供しています。フォーマットを新規作成する場合には，これらのフォーマットを参考にしてください。

(a)　出力形式

アクセスログの出力形式について説明します。なお，△は，半角スペースを表します。また，ここでは，表記の都合上，複数行にわたっていますが，実際には1行で出力されます。

デフォルトフォーマットの出力形式を次に示します。

Webクライアントのホスト名またはIPアドレス△リモートログ名△認証ユーザ名
△Webクライアントのリクエストに応答した時刻△リクエストライン
△最終ステータスコード△HTTPヘッダを除く送信バイト数

拡張フォーマットの出力形式を次に示します。

Webクライアントのホスト名またはIPアドレス△リモートログ名△認証ユーザ名
△Webクライアントのリクエストに応答した時刻△リクエストライン
△最終ステータスコード△HTTPヘッダを除く送信バイト数
△”Refererヘッダの内容”△”User-Agentヘッダの内容”

下線部分が，デフォルトフォーマットと拡張フォーマットの差異です。拡張フォーマットでは，デフォルトフォーマットの出力内容に加えて，「Refererヘッダの内容」と「User-Agentヘッダの内容」が出力されます。

(b)　出力例

デフォルトフォーマットでのアクセスログの出力例を次に示します。

10.20.30.40 - user [20/Dec/2004:15:45:01 +0900] "GET /index.html HTTP/1.1" 200 8358
10.20.30.40 - user [20/Dec/2004:15:45:01 +0900] "GET /left.html HTTP/1.1" 200 2358
10.20.30.40 - user [20/Dec/2004:15:45:01 +0900] "GET /rigth.html HTTP/1.1" 200 4358

拡張フォーマットでのアクセスログの出力例を次に示します。

10.20.30.40 - - [18/Jan/2005:13:06:10 +0900] "GET / HTTP/1.0" 200 38 "-" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"
10.20.30.40 - - [18/Jan/2005:13:06:25 +0900] "GET /demo/ HTTP/1.0" 500 684 "-" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"

(3)　アクセスログのフォーマットの引数

フォーマットの出力形式を定義するときに指定する，アクセスログのフォーマットの引数を次の表に示します。

表8-2　アクセスログのフォーマットの引数の一覧

フォーマットの引数
出力内容
出力例

%%
%記号
%

%a
WebクライアントのIPアドレス
10.20.30.40

%A
J2EEサーバのIPアドレス
10.20.30.100

%b
HTTPヘッダを除く送信バイト数
（0バイトの場合は「-」となる）
2048

%B
HTTPヘッダを除く送信バイト数
（0バイトの場合は「0」となる）
1024

%h
Webクライアントのホスト名またはIPアドレス
（ホスト名を取得できない場合はIPアドレスとなる）
10.20.30.40

%H
リクエストプロトコル
HTTP/1.1

%l
リモートログ名※1
（常に「-」になる）
-

%m
リクエストメソッド
GET

%p
Webクライアントからのリクエストを受け付けたポート番号
80

%q
クエリー文字列
（「?」から始まる。クエリー文字列がない場合は空文字となる）
?id=100&page=15

%r
リクエストライン
GET /index.html HTTP/1.1

%>s
最終ステータスコード
（内部リダイレクトされた値は出力しない）
200

%S※2
ユーザのセッションID
（セッションIDがない場合は「-」となる）
00455AFE4DA4E7B7789F247B8FE5D605

%t
Webクライアントのリクエストに応答した時刻
（単位：秒，出力形式：dd/MMM/YYYY:HH:mm:ss Z）
[18/Jan/2005:13:06:10 +0900]

%T
Webクライアントのリクエストの処理に掛かった時間
（単位：秒，出力形式：dd/MMM/YYYY:HH:mm:ss Z）
2

%d
Webクライアントのリクエストに応答した時刻
（単位：ミリ秒，出力形式：dd/MMM/YYYY:HH:mm:ss.nnn Z（nnnはミリ秒））
[18/Jan/2005:13:06:10.152 +0900]

%D
Webクライアントのリクエストの処理に掛かった時間
（単位：ミリ秒，出力形式：dd/MMM/YYYY:HH:mm:ss.nnn Z（nnnはミリ秒））
2000

%u
Basic認証ユーザ名，Form認証ユーザ名
（認証ユーザ名がない場合は「-」となる）
user

%U
リクエストファイルパス
/index.html

%v
J2EEサーバのローカルホスト名
server

%{foo}i※3
リクエストヘッダfooの内容
（fooヘッダが存在しない場合は「-」となる）
%{Host}iの場合www.example.com:8888

%{foo}c
Webクライアントが送信したCookie情報でCookieの名前がfooの内容
（Cookieの名前にfooがない場合は「-」となる）
%{JSESSIONID}cの場合00455AFE4DA4E7B7789F247B8FE5D605

%{foo}o※3
レスポンスヘッダfooの内容
（fooヘッダが存在しない場合は「-」となる）
%{Server}oの場合CosminexusComponentContainer

注※1

リモートログ名は，RFC 1413で規定されているIdentificationプロトコルで取得できるWebクライアント側のユーザ名です。

注※2

%Sで表示されるセッションIDは，Cookie名「JSESSIONID」の値です。セッションフェイルオーバでのグローバルセッションIDとは異なります。グローバルセッションIDを出力させたい場合には，%{GSESSIONID}cを指定してください。GIDCookieNameを変更した場合は，変更したGIDCookieNameの値を指定してください。

注※3

一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名を複数回送信する場合があります。この場合，最初に読み込んだヘッダの内容を出力します。

注意

フォーマットの引数の指定に誤りがある場合には，デフォルトフォーマットが使用されます。デフォルトフォーマットが使用される例を次に示します。

フォーマットの引数の一覧にない文字列（例：%Gなど）を指定した場合

リクエストヘッダの内容，レスポンスヘッダの内容，Cookie名で0文字（%{}iなど）を指定した場合

参考

デフォルトフォーマットと拡張フォーマットをフォーマットの引数で記述すると，次のような形式になります。

デフォルトフォーマット
%h %l %u %t "%r" %>s %b

拡張フォーマット
%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i"

9.　リソースとJ2EEアプリケーションの設定（J2EEアプリケーションを実行するシステム）

この章では，リソースとJ2EEアプリケーションの設定について説明します。

＜この章の構成＞

9.1　リソースとJ2EEアプリケーションの設定の概要

9.2　リソースとJ2EEアプリケーションの設定の前に

9.3　リソースアダプタの設定

9.4　JavaBeansリソースの設定

9.5　J2EEアプリケーションの設定

9.6　リソースとJ2EEアプリケーションで設定できる主な項目

9.7　Webアプリケーションに組み込むサーブレットフィルタの設定

9.8　リソースまたはJ2EEアプリケーションの別名の設定

9.9　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定

9.1　リソースとJ2EEアプリケーションの設定の概要

リソースとJ2EEアプリケーションを設定する際に，サーバ管理コマンドまたはServer Plug-inを使用します。

サーバ管理コマンドは，J2EEサーバ上で動作するリソースとJ2EEアプリケーションのプロパティを定義し，リソースとJ2EEアプリケーションの起動／停止を実行するためのコマンド群です。Server Plug-inは，J2EEサーバ上で動作するリソースとJ2EEアプリケーションのプロパティを定義し，論理サーバ，リソース，およびJ2EEアプリケーションの起動／停止を実行するためのGUIを提供するEclipseのプラグインです。

この節では，リソースとJ2EEアプリケーションの設定の概要について説明します。

＜この節の構成＞

9.1.1　リソースの設定の概要

9.1.2　J2EEアプリケーションの設定の概要

9.1.3　セキュリティアイデンティティの設定の概要

9.1.1　リソースの設定の概要

J2EEサーバはリソースとして，データベース，OpenTP1，SMTPサーバ，JavaBeansリソースなどを利用できます。これらのリソースを利用するために，リソースアダプタやメールコンフィグレーションを使用します。

＜この項の構成＞

(1)　リソースアダプタ

(2)　メールコンフィグレーション

(3)　JavaBeansリソース

(1)　リソースアダプタ

リソースとして，データベースやOpenTP1を利用する場合，リソースアダプタを使用して接続します。リソースと接続するリソースアダプタの種類を次の表に示します。

表9-1　リソースと接続するリソースアダプタの種類

リソースの種類
接続するリソースアダプタの種類

データベース
HiRDB

DB Connector

DB Connector for Cosminexus RM，およびCosminexus RMで提供するリソースアダプタ

Oracle

XDM/RD E2

DB Connector

SQL Server※

DB Connector

OpenTP1
SPP

uCosminexus TP1 Connector

TP1/Message Queue

TP1/Message Queue - Access

そのほか

Connector 1.0仕様またはConnector 1.5仕様に準拠するリソースアダプタ

注

データベースと接続する場合，接続先のデータベースの種類によって，データベースの接続方法，使用できるJDBCドライバなどが異なります。

リソースへの接続については，マニュアル「Cosminexus　機能解説」のリソースへの接続方法に関する説明を参照してください。

注※

SQL Serverと接続できるのはWindowsの場合だけです。

これらのリソースを利用するには，サーバ管理コマンドまたはServer Plug-inを使用して，リソースアダプタのプロパティの設定やインポートなどの作業が必要です。

リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。

(2)　メールコンフィグレーション

リソースとしてSMTPサーバを利用する場合，メールコンフィグレーションを使用して接続します。

メールコンフィグレーションを使用するには，サーバ管理コマンドを使用して，メールコンフィグレーションのプロパティを設定する作業などが必要です。なお，この作業はServer Plug-inではできません。

メールコンフィグレーションの設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(3)　JavaBeansリソース

リソースとしてJavaBeansリソースを利用する場合，サーバ管理コマンドを使用して，JavaBeansリソースのプロパティの設定やインポートなどの作業が必要です。なお，この作業はServer Plug-inではできません。

JavaBeansリソースの設定については，「9.4　JavaBeansリソースの設定」を参照してください。

9.1.2　J2EEアプリケーションの設定の概要

J2EEアプリケーションの設定では，サーバ管理コマンドまたはServer Plug-inを使用して，作成済みのJ2EEアプリケーションをインポートしてプロパティを定義します。

J2EEアプリケーションは，MyEclipse，サーバ管理コマンドなどを使用して作成します。サーバ管理コマンドを使用すると，WARファイルとEJB-JARファイルからJ2EEアプリケーションを作成したり，J2EEアプリケーションのプロパティを定義したりできます。

J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。また，Webアプリケーションへのサーブレットフィルタの追加については，「9.7　Webアプリケーションに組み込むサーブレットフィルタの設定」を参照してください。

なお，次の作業は，Server Plug-inでは操作できません。

J2EEアプリケーションの作成

テストモードでのJ2EEアプリケーションの設定

9.1.3　セキュリティアイデンティティの設定の概要

J2EEサーバによるユーザ認証が成功したときにWebコンテナやEJBコンテナに伝達される認証情報のことを，セキュリティアイデンティティといいます。セキュリティアイデンティティを使用してセキュリティを管理する場合は，サーバ管理コマンドを使用して，ユーザおよびロールの情報を登録します。Server Plug-inでは登録できません。なお，登録したユーザおよびロールを利用して，次の個所でセキュリティアイデンティティの詳細を定義してください。

J2EEアプリケーションを構成するEnterprise Bean，サーブレット，JSPの設定で，セキュリティアイデンティティの詳細を定義します。

J2EEアプリケーションを構成するEnterprise Bean，サーブレット，JSPのカスタマイズで，セキュリティアイデンティティを解決します。

セキュリティアイデンティティの設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

9.2　リソースとJ2EEアプリケーションの設定の前に

リソースやJ2EEアプリケーションの設定をする前に，リソースやJ2EEアプリケーションの設定に関する注意事項を理解しておいてください。また，サーバ管理コマンドを使用する場合には，必要に応じて，サーバ管理コマンドの動作設定をカスタマイズしてください。この節では，リソースやJ2EEアプリケーションの設定時の注意事項や，サーバ管理コマンドを使用するための動作設定について説明します。

＜この節の構成＞

9.2.1　リソースとJ2EEアプリケーションの設定の注意事項

9.2.2　サーバ管理コマンドの動作設定のカスタマイズ

9.2.1　リソースとJ2EEアプリケーションの設定の注意事項

リソースとJ2EEアプリケーションの設定をする場合に知っておく必要がある，Server Plug-inを使用する前に必要な設定，サーバ管理コマンド実行時の動作方法，リソースとJ2EEアプリケーションの設定の制約事項などを次に示します。注意事項の詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

サーバ管理コマンドとServer Plug-inでは，使用できる機能に差異があります。例えば，セキュリティアイデンティティの設定はサーバ管理コマンドでしか使用できません。それぞれのインタフェースで使用できる機能については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

Server Plug-inを使用する場合には，Eclipseへの組み込みや環境設定などが必要です。Server Plug-inを使用するための設定については，「2.5　Server Plug-inの設定」を参照してください。

Server Plug-inを起動する前に，運用管理エージェントとManagement Serverを起動しておく必要があります。運用管理エージェントの起動，Management Serverの起動については，「3.2　システムの起動と停止の設定」を参照してください。

サーバ管理コマンドは，J2EEサーバが起動している状態で実行できるコマンドです。J2EEサーバおよびその前提プロセスを起動してからサーバ管理コマンドを実行してください。

サーバ管理コマンドでは，J2EEアプリケーションやリソースのプロパティを設定するときに，属性情報が出力されたファイル（属性ファイル）を取得して，テキストエディタなどで編集します。このとき，Connector属性ファイルなど固有の属性ファイルを取得するほかに，すべての属性情報を含んだアプリケーション統合属性ファイルを取得して，属性情報を一括して編集することができます。

サーバ管理コマンドには，参照系コマンド，更新系コマンドおよび特権系コマンドがあります。これらは，組み合わせによって，同時に実行できるものと，排他処理されるものがあります。実行時には注意してください。参照系コマンドと更新系コマンドの分類については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

アクセス権やネットワークの設定をしておくことで，サーバ管理コマンド，J2EEサーバおよびCORBAネーミングサービスは，それぞれ別のホストで実行できます。別のホストで実行する場合には，次のことに注意してください。

J2EEサーバ間でCORBAネーミングサービスを共有している場合に，ほかのホスト上で実行されているJ2EEサーバの状態が表示されることがあります。誤操作に注意してください。

各ホストにインストールされているCosminexusのバージョンが異なると正常に実行できないことがあるので，同じバージョンの環境で使用してください。

9.2.2　サーバ管理コマンドの動作設定のカスタマイズ

ユーザ定義ファイルを編集することで，サーバ管理コマンドの動作設定をカスタマイズできます。必要に応じて，サーバ管理コマンドの動作設定をカスタマイズしてください。なお，UNIXの場合，カスタマイズにはroot権限，またはComponent Container管理者の権限が必要です。

次のディレクトリにあるコマンドがサーバ管理コマンドのコマンドになります。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin

UNIXの場合
/opt/Cosminexus/CC/admin/bin

コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

＜この項の構成＞

(1)　カスタマイズ対象のユーザ定義ファイル

(2)　サーバ管理コマンドのカスタマイズで設定できる主な項目

(3)　サーバ管理コマンドのログ取得の設定

(1)　カスタマイズ対象のユーザ定義ファイル

サーバ管理コマンドの動作設定をカスタマイズするには，次のユーザ定義ファイルをテキストエディタなどで編集します。なお，これらのユーザ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

usrconf.properties（ユーザプロパティファイル）
サーバ管理コマンドのユーザプロパティを指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/admin/usrconf/usrconf.properties

usrconf.bat（オプション定義ファイル）
Windowsの場合にサーバ管理コマンドのJavaVMの起動オプションを指定するファイルです。
ファイルの格納場所を次に示します。
<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf¥usrconf.bat

usrconf（オプション定義ファイル）
UNIXの場合にサーバ管理コマンドのJavaVMの起動オプションを指定するファイルです。
ファイルの格納場所を次に示します。
/opt/Cosminexus/CC/admin/usrconf/usrconf

(2)　サーバ管理コマンドのカスタマイズで設定できる主な項目

サーバ管理コマンドのカスタマイズでユーザ定義ファイルを編集して設定できる項目のうち，主な項目とその項目を設定するユーザ定義ファイルおよびキーを次の表に示します。キーの詳細，およびここで説明していないキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表9-2　サーバ管理コマンドのカスタマイズで設定できる主な項目

分類
項目
設定ファイル
設定方法

JavaVM
JavaVMのヒープサイズ
usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）
add.jvm.argキーに，JavaVMのヒープサイズを指定します。

ネーミングサービス
－
usrconf.properties
次のキーを指定します。

ejbserver.naming.hostキーに，サーバ管理コマンドが使用するCORBAネーミングサービスが動作するホストを指定します。

ejbserver.naming.portキーに，サーバ管理コマンドが使用するCORBAネーミングサービスのポート番号を指定します。

ejbserver.naming.protocolキーに，サーバ管理コマンドが使用するCORBAネーミングサービスへのアクセスプロトコルを指定します。

EJBホームオブジェクトリファレンスの別名付与（ユーザ指定名前空間機能）
usrconf.properties
ejbserver.cui.optionalname.enabledキーに，EJBホームオブジェクトの別名を指定するかどうかを指定します。
また，EJBホームオブジェクトに別名を付与するためには，このキーの指定に加えて，サーバ管理コマンドまたはServer Plug-inを使用してJ2EEアプリケーションのプロパティを定義するときに，EJBホームオブジェクトの別名を指定する必要があります。JNDI名前空間に登録される名称の参照と変更については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

J2EEリソースの別名付与（ユーザ指定名前空間機能）
usrconf.properties
ejbserver.cui.optionalname.enabledキーにJ2EEリソースの別名を指定するかどうかを指定します。
J2EEリソースに別名を付与するためには，さらに，J2EEアプリケーションのプロパティを定義するときに，サーバ管理コマンドまたはServer Plug-inを使用してJ2EEリソースの別名を指定する必要があります。JNDI名前空間に登録される名称の参照と変更については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

スマートエージェント
－
usrconf.properties
vbroker.agent.portキーに，サーバ管理コマンドが使用するスマートエージェントのポート番号を指定します。

ログ
Cosminexus TPBrokerのトレースファイル
usrconf.properties
vbroker.orb.htc.tracePathキーに，Cosminexus TPBrokerのトレースファイル出力先のパスを指定します。

サーバ管理コマンドのログ
usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）
usrconf.properties
サーバ管理コマンドのログは，ログの出力先，ログレベルを変更できます。
詳細については，「(3)　サーバ管理コマンドのログ取得の設定」を参照してください。

（凡例）　－：該当しない。

(3)　サーバ管理コマンドのログ取得の設定

サーバ管理コマンドのログは，ログの出力先，ログレベルを変更できます。変更できる項目と，項目に対応するユーザ定義ファイルとキーを次に示します。

項目 | 対応するユーザ定義ファイルとキー
ログの出力先 | usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプション
ログレベル | usrconf.propertiesのejbserver.logger.enabled.*キー

ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　ログの出力先の変更

サーバ管理コマンドのログの出力先を変更する場合は，サーバ管理コマンド用のusrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）でログの出力先ディレクトリを指定します。

ログの出力先の変更

デフォルトのログ出力先を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥logs

UNIXの場合
/opt/Cosminexus/CC/admin/logs/

サーバ管理コマンドのログの出力先は，usrconf.bat（Windowsの場合），またはusrconf（UNIXの場合）のUSRCONF_JVM_ARGSキーの-Dejbserver.log.directoryオプションで変更できます。

設定例

Windowsの場合
set USRCONF_JVM_ARGS="-Dejbserver.log.directory=C:¥CClogs¥admin"

UNIXの場合
set USRCONF_JVM_ARGS="-Dejbserver.log.directory=/CClogs/admin"

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリは，サーバ管理コマンドを実行したときのカレントディレクトリです。

例えば，ユーザIDが「Cosminexus」でユーザのホームディレクトリが「C:¥Documents and Settings¥Cosminexus」の場合に，このユーザIDでログインすると，ログイン直後のカレントディレクトリは「C:¥Documents and Settings¥Cosminexus」になります。ここで，サーバ管理コマンドを実行すると，カレントディレクトリは「C:¥Documents and Settings¥Cosminexus」になります。

注意事項

ログの出力先を変更した場合は，J2EEサーバを起動する前に，変更後のログの出力先ディレクトリを作成しておいてください。
変更後のログの出力先ディレクトリがない場合は，サーバ管理コマンドの実行時にKDJE37209-E，KDJE37210-E，KDJE37211-Eのメッセージが出力されて異常終了します。

同一ホスト内で複数のJ2EEサーバを起動させている場合は，ログ出力先が同じディレクトリにならないように，ディレクトリにサーバ名称を含めるなど，サーバごとにユニークなディレクトリ名になるようにしてください。なお，キーの値に同じディレクトリを指定した場合は，動作の保証はしません。

ログの出力先を変更して作業ディレクトリ以外にログを出力する場合，ログファイルはサーバのアンセットアップ時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

ユーザ定義ファイルでログの出力先を設定していても，次の設定が優先されますので，注意してください。
usrconf.cfgに，add.jvm.arg=-XX:HitachiJavaLog:<JavaVMの保守情報およびガーベージコレクションのログ出力先>キーを指定している場合は，JavaVMの保守情報およびガーベージコレクションのログ出力先に設定したディレクトリに，JavaVMの保守情報およびガーベージコレクションのログファイルが出力されます。

Management Serverリモート管理機能から操作した場合，サーバ管理コマンドのログ出力先は変更できません。

(b)　ログレベルの変更

サーバ管理コマンドのログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。

ログレベルは，サーバ管理コマンド用のusrconf.propertiesの次のキーで設定します。

ejbserver.logger.enabled.*=<レベル名>

レベル名には，「Error」，「Warning」，「Information」，「Debug」の文字列を一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

記述例

ejbserver.logger.enabled.*=Error

ejbserver.logger.enabled.*=Error,Warning

ejbserver.logger.enabled.*=Error,Warning,Information

ejbserver.logger.enabled.*=Error,Warning,Information,Debug

注意事項

記述例の1.，2.，3.，4.の順に，取得できるログの件数が増加していきます。複数のログレベルを設定してログを取得すると，性能が劣化し，ログファイルの面の切り替えが頻繁に起こるようになります。

レベル名に「Error」，「Warning」，「Information」，「Debug」以外の文字列，または空の値を設定した場合は，KDJE90009-Wのメッセージが出力されます。Errorレベルのログは取得されます。

9.3　リソースアダプタの設定

この節では，リソースアダプタの設定について説明します。リソースアダプタの設定には，次の二つの方法があります。

J2EEリソースアダプタとしてデプロイして設定する方法
リソースアダプタを，直接J2EEサーバにデプロイして設定する方法です。

J2EEアプリケーションに含めて設定する方法
J2EEアプリケーションに含めて使用するリソースアダプタに対して設定する方法です。

次に，それぞれの方法について説明します。

参考

リソースアダプタがDB Connectorの場合，Cosminexusが提供するConnector属性ファイルのテンプレートファイルが使用できます。Connector属性ファイルのテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。このため，編集対象のConnector属性ファイルをサーバ管理コマンド（cjgetrarpropコマンドまたはcjgetrespropコマンド）で取得する操作が不要になります。Connector属性ファイルのテンプレートは，次の場所に格納されています。テンプレートファイルはコピーして使用してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合
/opt/Cosminexus/CC/admin/templates/

なお，Connector属性ファイルのテンプレートファイル，およびテンプレートファイル使用時の注意事項については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

Cosminexus 07-00よりも前のバージョンで使用していたリソースアダプタをCosminexus 07-10以降で使用する場合には，リソースアダプタの移行作業が必要です。リソースの移行方法については，「付録A.8　リソースアダプタの移行コマンドの実行」を参照してください。

＜この節の構成＞

9.3.1　リソースアダプタの設定の流れ（J2EEリソースアダプタとしてデプロイして使用する場合）

9.3.2　リソースアダプタの設定の流れ（J2EEアプリケーションに含めて使用する場合）

9.3.3　リソースアダプタの種類

9.3.1　リソースアダプタの設定の流れ（J2EEリソースアダプタとしてデプロイして使用する場合）

リソースアダプタの設定には，サーバ管理コマンドを使用します。

ここでは，リソースアダプタをJ2EEリソースアダプタとしてデプロイして使用する場合の，次の流れについて説明します。

データベースやほかのリソースに接続する場合のリソースアダプタの新規設定の流れ

コネクションプールのクラスタ化機能を使用する場合のリソースアダプタの設定の流れ

リソースアダプタの設定を変更する場合の流れ

リソースアダプタを入れ替える場合の流れ

＜この項の構成＞

(1)　リソースアダプタの新規設定の流れ

(2)　リソースアダプタの設定の流れ（コネクションプールのクラスタ化の場合）

(3)　リソースアダプタの設定変更の流れ

(4)　リソースアダプタの入れ替えの流れ

(1)　リソースアダプタの新規設定の流れ

データベースやほかのリソースに接続する場合のリソースアダプタの新規設定の流れを次の図に示します。

図9-1　リソースアダプタの新規設定の流れ

図中の1.～4.について説明します。

サーバ管理コマンドを使用してリソースアダプタをインポートします。
cjimportresコマンドを使用して，リソースアダプタをインポートします。
DB Connectorを使用してデータベースに接続する場合と，ほかのリソースアダプタを使用してOpenTP1などの各種リソースに接続する場合では，インポートするRARファイルが異なります。インポートするリソースアダプタについては，「9.3.3　リソースアダプタの種類」を参照してください。

サーバ管理コマンドを使用してリソースアダプタをデプロイします。
cjdeployrarコマンドを使用して，リソースアダプタをデプロイします。
リソースアダプタは，デプロイするとJ2EEリソースアダプタとして使用できます。J2EEリソースアダプタとは，J2EEサーバに共有スタンドアロンモジュールとして配備したリソースアダプタのことです。サーバ管理コマンドでインポートしたリソースアダプタをデプロイすると，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用できるようになります。

サーバ管理コマンドを使用してリソースアダプタのプロパティを定義します。
cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。
リソースアダプタのプロパティ定義で設定できる内容については，「9.6.1　リソースアダプタのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用してリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，リソースアダプタの接続テストを実施します。リソースごとの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。

注意

DB Connector for Cosminexus RMとCosminexus RMを使用してデータベースに接続する場合の接続テストには次のような順序があります。

DB Connector for Cosminexus RMを開始します。

Cosminexus RMの接続テストを実施します。

Cosminexus RMを開始します。

DB Connector for Cosminexus RMの接続テストを実施します。

DB Connector for Cosminexus RMの場合の，J2EEリソースアダプタの接続テストについては，マニュアル「Cosminexus Reliable Messaging」を参照してください。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

リソースアダプタを使用する場合，J2EEアプリケーションからリソースアダプタへのリファレンスを解決しておく必要があります。リソースアダプタを使用しているJ2EEアプリケーションのプロパティを定義するときに，J2EEアプリケーションからリソースアダプタへのリファレンスを解決しておいてください。

参考

次のような場合，リソースアダプタをエクスポート・インポートすることで，効率良くリソースアダプタを設定できます。

開発環境で設定したリソースアダプタをエクスポートして，運用環境にインポートして使用する場合

運用環境ですでに動いているリソースアダプタをエクスポートして，増設したJ2EEサーバにインポートして使用する場合

エクスポートとインポートはcjexportrarとcjimportresで実行します。

なお，Application Serverのバージョンやプラットフォームが異なるホスト間では，リソースアダプタをエクスポート・インポートして使用することはできません。リソースアダプタをエクスポートするホストと，Application Serverのバージョンやプラットフォームが異なるホストでリソースアダプタを設定する場合は，リソースアダプタを新規に設定してください。

(2)　リソースアダプタの設定の流れ（コネクションプールのクラスタ化の場合）

コネクションプールをクラスタ化している場合の，データベースに接続するときのリソースアダプタの設定の流れを次の図に示します。

図9-2　コネクションプールのクラスタ化でのリソースアダプタの設定の流れ

図中の1.～10.について説明します。

サーバ管理コマンドを使用してメンバリソースアダプタをインポートします。
cjimportresコマンドを使用して，メンバリソースアダプタをインポートします。
インポートするリソースアダプタについては，「9.3.3　リソースアダプタの種類」を参照してください。

サーバ管理コマンドを使用してメンバリソースアダプタをデプロイします。
cjdeployrarコマンドを使用して，メンバリソースアダプタをデプロイします。

サーバ管理コマンドを使用してメンバリソースアダプタのプロパティを定義します。
cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。
メンバリソースアダプタとルートリソースアダプタのプロパティ定義では設定できる項目が異なります。メンバリソースアダプタおよびルートリソースアダプタで設定できるプロパティ定義の項目については，マニュアル「Cosminexus　機能解説」のコネクションプールのクラスタ化に関する説明を参照してください。
リソースアダプタのプロパティ定義で設定できる内容については，「9.6.1　リソースアダプタのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用してメンバリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，メンバリソースアダプタの接続テストを実施します。
メンバリソースアダプタの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。
また，1.～4.までの流れを，メンバリソースアダプタの数だけ繰り返します。

サーバ管理コマンドを使用してメンバリソースアダプタを開始します。
ルートリソースアダプタの接続テストを実施する場合には，あらかじめメンバリソースアダプタを開始しておいてください。cjstartrarコマンドを使用して，メンバリソースアダプタを開始します。

サーバ管理コマンドを使用してルートリソースアダプタをインポートします。
cjimportresコマンドを使用して，ルートリソースアダプタをインポートします。
インポートするリソースアダプタについては，「9.3.3　リソースアダプタの種類」を参照してください。

サーバ管理コマンドを使用してルートリソースアダプタをデプロイします。
cjdeployrarコマンドを使用してルートリソースアダプタをデプロイします。

サーバ管理コマンドを使用してルートリソースアダプタのプロパティを定義します。
cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。

サーバ管理コマンドを使用してルートリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，ルートリソースアダプタの接続テストを実施します。
ルートリソースアダプタの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。

サーバ管理コマンドを使用してメンバリソースアダプタを停止します。
ルートリソースアダプタの接続テストを実施した場合には，メンバリソースアダプタを停止してください。cjstoprarコマンドを使用して，メンバリソースアダプタを停止します。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

コネクションプールをクラスタ化する場合，J2EEアプリケーションからルートリソースアダプタへのリファレンスを解決しておく必要があります。ルートリソースアダプタを使用しているJ2EEアプリケーションのプロパティを定義するときに，J2EEアプリケーションからルートリソースアダプタへのリファレンスを解決しておいてください。

(3)　リソースアダプタの設定変更の流れ

デプロイ済みのリソースアダプタの設定を変更する場合の流れについて説明します。設定変更の流れを次の図に示します。

図9-3　リソースアダプタの設定変更の流れ

図中の1.～2.について説明します。

サーバ管理コマンドを使用して，リソースアダプタを停止します。
cjstoprarコマンドを使用してリソースアダプタを停止します。なお，リソースアダプタを停止する前に，そのリソースアダプタを使用しているJ2EEアプリケーションをすべて停止してください。

サーバ管理コマンドを使用してリソースアダプタのプロパティを定義します。
リソースアダプタはデプロイ済みであるため，cjgetrarpropコマンドを使用して属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。

(4)　リソースアダプタの入れ替えの流れ

リソースアダプタを入れ替える場合の流れについて説明します。なお，ここでは，入れ替える新しいリソースアダプタのプロパティの定義など（新規設定の場合の流れと同じです）が終わっていることを前提に，入れ替えの流れについて説明します。リソースアダプタの入れ替えの流れを次の図に示します。

図9-4　リソースアダプタの入れ替えの流れ

図中の1.～4.について説明します。

サーバ管理コマンドを使用して，リソースアダプタを停止します。
cjstoprarコマンドを使用して入れ替えるリソースアダプタを停止します。なお，リソースアダプタを停止する前に，そのリソースアダプタを使用しているJ2EEアプリケーションをすべて停止してください。

J2EEサーバを再起動します。
cjstopsvコマンドを使用してJ2EEサーバを停止し，cjstartsvコマンドを使用してJ2EEサーバを起動します。

サーバ管理コマンドを使用してリソースアダプタを削除します。
cjdeleteresコマンドを使用して，入れ替えるリソースアダプタを削除します。

サーバ管理コマンドを使用してリソースアダプタをインポートします。
cjimportresコマンドを使用して，新しいリソースアダプタをインポートします。

9.3.2　リソースアダプタの設定の流れ（J2EEアプリケーションに含めて使用する場合）

リソースアダプタの設定には，サーバ管理コマンドを使用します。ここでは，リソースアダプタをJ2EEアプリケーションに含めて使用する場合のリソースアダプタの設定の流れについて説明します。

なお，リソースアダプタをアプリケーションに含めて使用する場合のリソースアダプタの設定方法には，次の二つの方法があります。

リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする方法

J2EEサーバにインポート済みのJ2EEアプリケーションにリソースアダプタを追加する方法

ここでは，それぞれの方法について説明します。

なお，J2EEアプリケーションに含められるリソースアダプタには，制限があります。J2EEアプリケーションに含められるリソースアダプタについては，マニュアル「Cosminexus　機能解説」のリソースアダプタの使用方法に関する説明を参照してください。

＜この項の構成＞

(1)　リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする方法

(2)　インポート済みのJ2EEアプリケーションにリソースアダプタを追加する方法

(1)　リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする方法

リソースアダプタのRARファイルを含めてJ2EEアプリケーションを作成して，そのEARファイルをJ2EEサーバにインポートする方法です。この方法の概要を次の図に示します。

図9-5　リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする方法の概要

リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする流れを次の図に示します。

図9-6　リソースアダプタを含めたJ2EEアプリケーションをJ2EEサーバにインポートする流れ

図中の1.～4.について説明します。

サーバ管理コマンドを使用してリソースアダプタのRARファイルをJ2EEアプリケーションのEARファイルに追加します。
cjaddappコマンドを使用して，リソースアダプタのRARファイルをJ2EEアプリケーションのEARファイルに追加します。
EARファイルに含められるリソースアダプタには，制限があります。EARファイルに含められるリソースアダプタについては，マニュアル「Cosminexus　機能解説」のリソースアダプタの使用方法に関する説明を参照してください。

サーバ管理コマンドを使用してJ2EEアプリケーションをインポートします。
cjimportappコマンドを使用して，J2EEアプリケーションをインポートします。

サーバ管理コマンドを使用してリソースアダプタのプロパティを定義します。
cjgetapppropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させます。
リソースアダプタのプロパティ定義で設定できる内容については，「9.6.1　リソースアダプタのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用してリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，リソースアダプタの接続テストを実施します。リソースごとの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。

(2)　インポート済みのJ2EEアプリケーションにリソースアダプタを追加する方法

リソースアダプタ（RARファイル）をJ2EEサーバにインポートしてから，同じJ2EEサーバにインポート済みのJ2EEアプリケーションにリソースアダプタを追加する方法です。この方法の概要を次の図に示します。

図9-7　インポート済みのJ2EEアプリケーションにリソースアダプタを追加する方法の概要

インポート済みのJ2EEアプリケーションにリソースアダプタを追加する流れを次の図に示します。

図9-8　インポート済みのJ2EEアプリケーションにリソースアダプタを追加する流れ

図中の1.～5.について説明します。

サーバ管理コマンドを使用してJ2EEアプリケーションをインポートします。
cjimportappコマンドを使用して，J2EEアプリケーションをインポートします。

サーバ管理コマンドを使用してリソースアダプタをインポートします。
cjimportresコマンドを使用して，リソースアダプタをインポートします。

サーバ管理コマンドを使用してリソースアダプタをJ2EEアプリケーションに追加します。
cjaddappコマンドを使用して，リソースアダプタをJ2EEアプリケーションに追加します。

サーバ管理コマンドを使用してリソースアダプタのプロパティを定義します。
cjgetapppropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させます。
リソースアダプタのプロパティ定義で設定できる内容については，「9.6.1　リソースアダプタのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用してリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，リソースアダプタの接続テストを実施します。リソースごとの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。

9.3.3　リソースアダプタの種類

プロパティを定義するリソースアダプタは，接続するリソースや使用するトランザクションの種類などによって異なります。ここでは，次の場合に使用するリソースアダプタについて説明します。

DB Connectorを使用する場合

DB Connector for Cosminexus RMとCosminexus RMを使用する場合

ほかのリソースアダプタを使用する場合

＜この項の構成＞

(1)　DB Connectorを使用する場合

(2)　DB Connector for Cosminexus RMとCosminexus RMを使用する場合

(3)　ほかのリソースアダプタを使用する場合

(1)　DB Connectorを使用する場合

DB Connectorは，接続するデータベースの種類や使用するトランザクションの種類によって，ファイルが異なります。DB Connectorの種類を次の表に示します。

表9-3　DB Connectorの種類

RARファイル名 | 説明
DBConnector_HiRDB_Type4_CP.rar | HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDB，XDM/RD E2に接続する場合に選択します。
DBConnector_HiRDB_Type4_XA.rar | HiRDB Type4 JDBC Driverを使用して，グローバルトランザクションで，HiRDBに接続する場合に選択します。
DBConnector_DABJ_CP.rar | Cosminexus DABroker Libraryを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDB，Oracle，XDM/RD E2に接続する場合に選択します。
DBConnector_DABJ_XA.rar | Cosminexus DABroker Libraryを使用して，グローバルトランザクションで，HiRDB，Oracleに接続する場合に選択します。
DBConnector_Oracle_CP.rar | Oracle JDBC Thin Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。
DBConnector_Oracle_XA.rar | Oracle JDBC Thin Driverを使用して，グローバルトランザクションで，Oracleに接続する場合に選択します。
DBConnector_SQLServer_CP.rar | SQL Server 2000 Driver for JDBCを使用して，ローカルトランザクションまたはトランザクション管理なしで，SQL Server 2000（Windowsの場合だけ）に接続する場合に選択します。
DBConnector_SQLServer2005_CP.rar | SQL Server 2005 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，SQL Server 2005（Windowsの場合だけ）に接続する場合に選択します。
DBConnector_CP_ClusterPool_Root.rar | コネクションプールのクラスタ化機能のルートリソースアダプタです。ルートリソースアダプタに属するメンバリソースアダプタが，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。
DBConnector_Oracle_CP_ClusterPool_Member.rar | コネクションプールのクラスタ化機能のメンバリソースアダプタです。Oracle JDBC Thin Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。なお，J2EEアプリケーションのリソースリファレンスに設定して使用できません。

注　新規に，DB ConnectorのRARファイルを使用する場合，Cosminexusで提供するConnector属性ファイルのテンプレートファイルを使用して，プロパティを定義できます。Connector属性ファイルのテンプレートファイルは，すべてのDB ConnectorのRARファイルに対して提供しています。提供しているテンプレートファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　DB Connector for Cosminexus RMとCosminexus RMを使用する場合

Cosminexus RMと連携してデータベースに接続する場合には，Cosminexus RM連携用のリソースアダプタ（DB Connector for Cosminexus RM）と，Cosminexus RMで提供するリソースアダプタの両方をインポートする必要があります。Cosminexus RMで提供するリソースアダプタについては，マニュアル「Cosminexus Reliable Messaging」を参照してください。

DB Connector for Cosminexus RMは，使用するトランザクションの種類や接続するデータベースの種類によって，ファイルが異なります。DB Connector for Cosminexus RMの種類を次の表に示します。

表9-4　DB Connector for Cosminexus RMの種類

RARファイル名 | 説明
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar | HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDBに接続する場合に選択します。
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar | HiRDB Type4 JDBC Driverを使用して，グローバルトランザクションで，HiRDBに接続する場合に選択します。
DBConnector_DABJ_CP_Cosminexus_RM.rar | Cosminexus DABroker Libraryを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDBに接続する場合に選択します。
DBConnector_DABJ_XA_Cosminexus_RM.rar | Cosminexus DABroker Libraryを使用して，グローバルトランザクションで，HiRDBに接続する場合に選択します。
DBConnector_Oracle_CP_Cosminexus_RM.rar | Oracle JDBC Thin Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。
DBConnector_Oracle_XA_Cosminexus_RM.rar | Oracle JDBC Thin Driverを使用して，グローバルトランザクションで，Oracleに接続する場合に選択します。

注　新規に，DB Connector for Cosminexus RMのRARファイルを使用する場合，Cosminexusで提供するConnector属性ファイルのテンプレートファイルを使用して，プロパティを定義できます。Connector属性ファイルのテンプレートファイルは，すべてのDB ConnectorのRARファイルに対して提供しています。提供しているテンプレートファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ポイント

DB Connector for Cosminexus RMとCosminexus RMを使用して同一トランザクション内でJDBCとJMSのアクセスを行う場合に，同じ物理コネクションを共有することで，ローカルトランザクションの適用，グローバルトランザクションの1相コミット決着ができます。1相コミット決着のための条件を次に示します。

DB Connector for Cosminexus RMとCosminexus RMで使用するデータベースシステムが同一であり，かつサインオン方式とセキュリティ情報（ユーザ名，パスワード）が同一である。

リソースアダプタを使用するJ2EEアプリケーションの属性ファイル（Session Bean属性ファイル，Entity Bean属性ファイルなど）で<res-sharing-scope>タグに「Shareable」を指定している。

(3)　ほかのリソースアダプタを使用する場合

OpenTP1のSPPと接続する場合には，uCosminexus TP1 ConnectorおよびTP1/Client/Jの提供するリソースアダプタを使用します。詳細については，uCosminexus TP1 Connectorのドキュメント，およびマニュアル「OpenTP1　クライアント使用の手引　TP1/Client/J編」を参照してください。

TP1/Message Queueと接続する場合には，TP1/Message Queue - Accessの提供するリソースアダプタを使用します。詳細については，マニュアル「OpenTP1 Version 6 メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引」を参照してください。

また，Cosminexusでは，Connector 1.0仕様またはConnector 1.5仕様に準拠したリソースアダプタを使用して，任意のリソースに接続できます。これらのリソースアダプタを使用する場合は，リソースアダプタのドキュメントを参照してください。

9.4　JavaBeansリソースの設定

この節では，JavaBeansリソースの設定について説明します。

サーバ管理コマンドを使用してJavaBeansリソースのプロパティを設定し，JavaBeansリソースをインポートします。

JavaBeansリソースの設定には，サーバ管理コマンドを使用します。

ここでは，JavaBeansリソースの新規設定の流れ，設定変更の流れ，および入れ替えの流れについて説明します。

＜この節の構成＞

(1)　JavaBeansリソースの新規設定の流れ

(2)　JavaBeansリソースの設定変更の流れ

(3)　JavaBeansリソースの入れ替えの流れ

(1)　JavaBeansリソースの新規設定の流れ

JavaBeansリソースの新規設定の流れを次の図に示します。

図9-9　JavaBeansリソースの新規設定の流れ

図中の1.～2.について説明します。

JavaBeansリソース属性ファイルを作成し，JavaBeansリソースのプロパティを定義します。
JavaBeansリソース属性ファイルのテンプレートを使用してJavaBeansリソース属性ファイルを作成して，JavaBeansリソースのプロパティを定義してください。JavaBeansリソース属性ファイルのテンプレートは次のディレクトリに格納されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥admin¥templates¥jb_template.xml

UNIXの場合
/opt/Cosminexus/CC/admin/templates/jb_template.xml

JavaBeansリソースのプロパティ定義で設定できる内容については，「9.6.2　JavaBeansリソースのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用して，JavaBeansリソースをインポートします。
1.で設定したJavaBeansリソース属性ファイルと，JavaBeansリソースを含むJARファイルのパスを引数に指定し，cjimportjbコマンドを使用して，JavaBeansリソースをインポートします。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

参考

JavaBeansリソースを複数インポートする場合，インポート済みのJavaBeansリソースと同じ実装クラス名のJavaBeansリソースはインポートできません。先にインポートしたJavaBeansリソースを削除してからインポートするか，または実装クラス名を変更して再作成したあとでインポートしてください。
また，JavaBeansリソースの実装クラス以外にほかのクラスファイルを使用している場合，ほかのクラスファイルに関してはチェックされません。

インポート時にcjimportjbコマンドに-dオプションを使用すると，アーカイブを生成しないで，ディレクトリ構成のままインポートできます。ディレクトリは，インポートしたいディレクトリの最上位を指定します。
なお，指定したディレクトリがディレクトリ構成でない場合は，指定したディレクトリ直下のファイルをすべてインポートします。
指定したディレクトリ下にあるすべてのファイルをインポートするため，不要なファイルをディレクトリに含めないでください。

注意

JavaBeansリソースを使用する場合，J2EEアプリケーションからJavaBeansリソースへのリファレンスを解決しておく必要があります。JavaBeansリソースを使用しているJ2EEアプリケーションのプロパティを定義するときに，J2EEアプリケーションからJavaBeansリソースへのリファレンスを解決しておいてください。

(2)　JavaBeansリソースの設定変更の流れ

JavaBeansリソースの設定変更の流れを次の図に示します。

図9-10　JavaBeansリソースの設定変更の流れ

図中の1.～2.について説明します。

サーバ管理コマンドを使用して，JavaBeansリソースを停止します。
cjstopjbコマンドを使用してJavaBeansリソースを停止します。なお，JavaBeansリソースを停止する前に，そのJavaBeansリソースを使用しているJ2EEアプリケーションをすべて停止してください。

サーバ管理コマンドを使用して，JavaBeansリソースのプロパティを定義します。
cjgetjbpropコマンドを使用してJavaBeansリソース属性ファイルを取得し，ファイル編集後に，cjsetjbpropコマンドで編集内容を反映させます。
JavaBeansリソースのプロパティ定義で設定できる内容については，「9.6.2　JavaBeansリソースのプロパティ定義で設定できること」を参照してください。

(3)　JavaBeansリソースの入れ替えの流れ

JavaBeansリソースの入れ替えの流れを次の図に示します。

図9-11　JavaBeansリソースの入れ替えの流れ

図中の1.～4.について説明します。

サーバ管理コマンドを使用して，JavaBeansリソースを停止します。
cjstopjbコマンドを使用して入れ替えるJavaBeansリソースを停止します。なお，JavaBeansリソースを停止する前に，そのJavaBeansリソースを使用しているJ2EEアプリケーションをすべて停止してください。

J2EEサーバを再起動します。
cjstopsvコマンドを使用してJ2EEサーバを停止し，cjstarsvコマンドを使用してJ2EEサーバを再起動します。

サーバ管理コマンドを使用して，JavaBeansリソースを削除します。
cjdeletejbコマンドを使用して，入れ替えるJavaBeansリソースを削除します。

サーバ管理コマンドを使用してJavaBeansリソースをインポートします。
cjimportjbコマンドを使用して，新しいJavaBeansリソースをインポートします。

9.5　J2EEアプリケーションの設定

この節では，J2EEアプリケーションの設定について説明します。

＜この節の構成＞

9.5.1　J2EEアプリケーションの設定の流れ

9.5.2　テストモードでのJ2EEアプリケーションの設定の流れ

9.5.1　J2EEアプリケーションの設定の流れ

J2EEアプリケーションの設定には，サーバ管理コマンドを使用します。

なお，ここでは，アーカイブ形式のJ2EEアプリケーション（EAR形式／ZIP形式）や展開ディレクトリ形式のJ2EEアプリケーションが作成済みであることを前提に，J2EEアプリケーションの設定方法について説明します。J2EEアプリケーションは，MyEclipseなどを使用して，アプリケーション開発時に作成しておいてください。アプリケーションの作成については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

参考

サーバ管理コマンドでは，作成済みのEJB-JARファイルやWARファイルから，アーカイブ形式のJ2EEアプリケーションを作成することもできます。サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成については，「(3)　サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成」を参照してください。

＜この項の構成＞

(1)　J2EEアプリケーションの新規設定の流れ

(2)　J2EEアプリケーションの入れ替えについて

(3)　サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成

(1)　J2EEアプリケーションの新規設定の流れ

J2EEアプリケーションの新規設定の流れを次の図に示します。

図9-12　J2EEアプリケーションの新規設定の流れ

図中の1.～3.について説明します。

サーバ管理コマンドを使用してJ2EEアプリケーションをインポートします。
cjimportappコマンドを使用して，J2EEアプリケーションをインポートします。

アーカイブ形式のJ2EEアプリケーションをインポートする場合には，-fオプションにEAR形式／ZIP形式のファイルを指定します。

展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合には，-aオプションにアプリケーションディレクトリを指定します。

EAR形式／ZIP形式のファイルを展開ディレクトリ形式でインポートする場合には，-fオプションにEAR形式／ZIP形式のファイルを，-dオプションにアプリケーションディレクトリとなる展開先のディレクトリを指定します。

サーバ管理コマンドを使用してJ2EEアプリケーションにサーブレットフィルタを追加します。
サーブレットフィルタを追加する場合は，WARファイルにフィルタを登録したあと，フィルタのマッピングを定義します。サーブレットフィルタの追加については，「9.7　Webアプリケーションに組み込むサーブレットフィルタの設定」を参照してください。

サーバ管理コマンドを使用してJ2EEアプリケーションのプロパティを定義します。
cjgetapppropコマンドで各属性ファイルを取得し，ファイル編集後に，cjsetapppropコマンドで編集内容を反映させます。プロパティの設定内容については，「9.6.3　J2EEアプリケーションのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

参考

次のような場合，実行時情報を含んだJ2EEアプリケーションをエクスポート・インポートすることで，効率良くJ2EEアプリケーションを設定できます。

開発環境で作成したJ2EEアプリケーションをエクスポートして，運用環境にインポートして使用する場合

運用環境ですでに動いているJ2EEアプリケーションをエクスポートして，増設したJ2EEサーバにインポートして使用する場合

なお，Application Serverのバージョンやプラットフォームが異なるホスト間では，J2EEアプリケーションをエクスポート・インポートして使用することはできません。J2EEアプリケーションをエクスポートするホストと，Application Serverのバージョンやプラットフォームが異なるホストでJ2EEアプリケーションを設定する場合は，J2EEアプリケーションを新規に作成および設定してください。

(2)　J2EEアプリケーションの入れ替えについて

J2EEアプリケーションのバージョンアップやメンテナンスをするために，J2EEアプリケーションを入れ替えられます。

J2EEアプリケーションの入れ替えは，サーバ管理コマンドを使用して実行します。通常のデプロイ操作のほかに，リデプロイ機能やリロード機能を使用した入れ替えもできます。

アーカイブ形式のJ2EEアプリケーションの場合には，リデプロイ機能を使用して入れ替えができます。リデプロイでは，入れ替え前のJ2EEアプリケーションに対して設定した属性情報を入れ替え後のJ2EEアプリケーションに引き継げるため，少ない手順で高速に入れ替えができます。

展開ディレクトリ形式のJ2EEアプリケーションの場合には，J2EEアプリケーションを構成するクラスファイルなどの更新を検知し，更新したJ2EEアプリケーションをリロードする機能を使用できます。この機能を使用することで，J2EEアプリケーションを再デプロイしなくても，デプロイ済みのEJB-JAR，サーブレットやJSPを動的に入れ替えられるようになります。

また，J2EEアプリケーションを入れ替えるときに，既存のJ2EEアプリケーションの名前を変更することによって，J2EEアプリケーションの世代も管理できます。

24時間サービス提供が必要なJ2EEアプリケーションを入れ替える場合には，Webアプリケーションのサービスの部分閉塞やCTMの使用によって，サービスを停止しないでJ2EEアプリケーションを入れ替えることもできます。

J2EEアプリケーションの入れ替えと保守については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。サーバ管理コマンドの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(3)　サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成

サーバ管理コマンドでは，作成済みのEJB-JARファイルやWARファイルなどをEAR形式またはZIP形式にアセンブルして，アーカイブ形式のJ2EEアプリケーションを作成することもできます。サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成の流れを次の図に示します。

図9-13　サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成の流れ

ここでは，図中の作業のうち，J2EEアプリケーションの作成の作業について説明します。ほかの作業については，「(1)　J2EEアプリケーションの新規設定の流れ」を参照してください。

J2EEアプリケーションの構成によって，インポートするファイルや作業の手順が異なります。

EJB-JARファイルをインポートする場合は，cjimportresコマンドで-type ejbを指定します。

WARファイルをインポートする場合は，cjimportresコマンドで-type warを指定します。

インポートしたEJB-JARファイルやWARファイルからJ2EEアプリケーションを新規作成する場合は，cjaddappコマンドを使用します。

J2EEアプリケーションにライブラリJARを追加する場合は，cjimportlibjarコマンドを使用します。

サーバ管理コマンドでのJ2EEアプリケーションの作成については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

9.5.2　テストモードでのJ2EEアプリケーションの設定の流れ

テストモードは，J2EEアプリケーションをテスト用に動作させるための動作モードです。J2EEアプリケーションを新規作成した場合や，すでに動作中のJ2EEアプリケーションを入れ替える場合，本番運用を開始する前に，まず本番環境で問題なく動作するのを確認したいことがあります。このような場合にテストモードを使用します。

＜この項の構成＞

(1)　テストモードについて

(2)　テストモードでのJ2EEアプリケーションの設定の流れ

(1)　テストモードについて

J2EEアプリケーションのテストモードでの動作確認には，サーバ管理コマンドを使用します。

テストモードで動作中のJ2EEアプリケーションに対してできる操作を次に示します。テストモードでのJ2EEアプリケーションの運用については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

インポート

J2EEアプリケーションの開始

J2EEアプリケーションの停止（通常停止，および強制停止）

J2EEアプリケーションの削除

J2EEアプリケーションの設定の追加，変更，および削除

モード変更

リデプロイ

リロード

Management Serverでは，J2EEアプリケーションをテストモードでインポートして動作確認することはできません。ただし，次の場合には，Management Serverの運用管理コマンド（mngsvrutil）で，テストモードで動作しているJ2EEアプリケーションの稼働情報が参照できます。

Management Serverに登録されているJ2EEアプリケーションを，サーバ管理コマンドを使用してテストモードで動作させた場合

Management Serverに登録されているJ2EEアプリケーションと同名のJ2EEアプリケーションを，サーバ管理コマンドを使用してテストモードで動作させた場合

(2)　テストモードでのJ2EEアプリケーションの設定の流れ

ここでは，新規作成したJ2EEアプリケーションをテストモードで実行して問題なく動作することを確認してから，J2EEアプリケーションの動作モードを通常モードに切り替えて，本番運用を開始する場合の操作について説明します。すでに動作中のJ2EEアプリケーションを入れ替える場合には，動作中のJ2EEアプリケーションの停止や退避などの操作が必要になります。J2EEアプリケーションの入れ替えと保守については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

なお，Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，あらかじめ次の作業が必要です。

リダイレクタの設定（URLのマッピング）
通常モードのコンテキストルートを含むURLのマッピングに加えて，テストモードのコンテキストルートを含むURLのマッピングを設定してください。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，通常モードのコンテキストルートが「/jsptobean」の場合，テストモードのコンテキストルートは「/_test_/jsptobean」になります。
URLのマッピングについては，「7.2.2　URLパターンでのリクエスト振り分けの設定」を参照してください。

Webサーバの再起動
Webサーバを再起動して，リダイレクタの設定を有効にしてください。

ここでは，上記の作業が済んでいることを前提に，テストモードでのJ2EEアプリケーションの設定について説明します。

テストモードでのJ2EEアプリケーションの設定の流れを次の図に示します。

図9-14　テストモードでのJ2EEアプリケーションの設定の流れ

図中の1.～6.について説明します。

サーバ管理コマンドを使用して，J2EEアプリケーションをテストモードでインポートします。
J2EEアプリケーションのインポートには，cjimportappコマンドで-testを指定します。

必要に応じて，サーバ管理コマンドを使用して，J2EEアプリケーションのプロパティを定義します。
J2EEアプリケーションのプロパティの定義には，cjgetapppropコマンドおよびcjsetapppropコマンドで-testを指定します。cjgetappprop -testで各属性ファイルを取得し，ファイル編集後に，cjsetappprop -testで編集内容を反映させます。
J2EEアプリケーションのプロパティの定義で設定できる内容については，「9.6.3　J2EEアプリケーションのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用して，J2EEアプリケーションをテストモードで開始します。
cjstartappコマンドで-testを指定して，J2EEアプリケーションをテストモードで運用します。

テストを実施します。
テストモード用に設定した特定のクライアントから適宜操作を実行し，テストを実施して問題ないことが確認できたら，手順5.に進みます。
テスト結果に問題があった場合は，J2EEアプリケーションを修正して，手順1.からもう一度実行してください。なお，同じ名称のJ2EEアプリケーションは同じモードで登録できません。このため，テストが失敗したテストモードのJ2EEアプリケーションは，cjdeleteappコマンドで-testを指定して削除してください。

ポイント

テストモードで動作しているJ2EEアプリケーションは，テストモード用に設定した特定のクライアントからだけ利用できます。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，コンテキストルートが「/jsptobean」で，本番運用でのURLが「http://www.hitachi.co.jp/jsptobean/account.jsp」の場合，テストモードでのURLは，「http://www.hitachi.co.jp/_test_/jsptobean/account.jsp」になります。テスト用のクライアントからはこのURLを使用してJ2EEアプリケーションに対して操作を実行してください。

EJBを含むJ2EEアプリケーションをテストモードで運用する場合，EJBはテスト用の名前空間に登録されます。EJBクライアントアプリケーションからEJBを呼び出す場合には，通常モード用の名前空間のルートコンテキスト名で始まる検索文字列「HITACHI_EJB/…」ではなく，テストモード用の名前空間のルートコンテキスト名で始まる検索文字列「$HITACHI_TEST/…」を指定してlookupを実行してください。

サーバ管理コマンドを使用して，テストモードで運用しているJ2EEアプリケーションを停止します。
cjstopappコマンドで-testを指定して，J2EEアプリケーションを停止します。

サーバ管理コマンドを使用して，テストモードで運用していたJ2EEアプリケーションの動作モードを通常モードに変更します。
cjchmodappコマンドで-test -mode normalを指定して，J2EEアプリケーションの動作モードを通常モードに変更します。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

9.6　リソースとJ2EEアプリケーションで設定できる主な項目

この節では，リソースとJ2EEアプリケーションで設定できる項目のうち，主な項目と設定内容について説明します。ここで説明していない設定については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この節の構成＞

9.6.1　リソースアダプタのプロパティ定義で設定できること

9.6.2　JavaBeansリソースのプロパティ定義で設定できること

9.6.3　J2EEアプリケーションのプロパティ定義で設定できること

9.6.1　リソースアダプタのプロパティ定義で設定できること

リソースアダプタのプロパティとして設定する項目のうち，主な項目と，その項目の設定方法について説明します。

次のことを前提とします。

リソースアダプタのプロパティは，サーバ管理コマンドまたはServer Plug-inを使用して定義します。

ここではサーバ管理コマンドで使用するConnector属性ファイルのタグについて説明します。cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させてください。なお，リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

Server Plug-inを使用する場合，属性ファイルのタグに対応した項目に設定します。属性ファイルのタグと対応する画面については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

項目を設定するConnector属性ファイルのタグの詳細，サーバ管理コマンドとServer Plug-inでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ここで説明していない項目と，その項目を設定するConnector属性ファイルのタグの詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　DB Connectorで設定できる項目

(2)　Connector 1.5仕様に準拠したリソースアダプタで設定できる項目

(1)　DB Connectorで設定できる項目

リソースアダプタのプロパティとして設定する項目のうち，DB Connectorで設定できる主な項目と，その項目の設定方法について説明します。

DB Connectorのプロパティ定義で設定できる内容を次の表に示します。

表9-5　DB Connectorのプロパティ定義で設定できる内容

分類
項目
設定内容

一般情報
トランザクションサポートレベル
<transaction-support>タグで，トランザクションサポートレベルを設定します。トランザクション管理なし（NoTransaction），ローカルトランザクション（LocalTransaction），またはグローバルトランザクション（XATransaction）を指定します。

コンフィグレーションプロパティ
データベースコネクション確立までの待ち時間
<config-property>タグのloginTimeoutで，データベースコネクション確立までのJ2EEアプリケーションの待ち時間を指定します。

ステートメントキャンセル
<config-property>タグのCancelStatementで，トランザクションタイムアウト発生時のステートメントキャンセルを有効にするかどうかを指定します。

PreparedStatementのプールサイズ※1
<config-property>タグのPreparedStatementPoolSizeで，PreparedStatementのプールサイズを指定します。

CallableStatementのプールサイズ※1
<config-property>タグのCallableStatementPoolSizeで，CallableStatementのプールサイズを指定します。

実行時プロパティ
コネクションの最小値と最大値
<property>タグのMinPoolSizeとMaxPoolSizeで，コネクションプールにプールするコネクションの最小値と最大値を指定します。

コネクションの障害検知
<property>タグのValidationTypeでコネクションの障害を検知するタイミングを指定し，ValidationIntervalで障害を検知する間隔を指定します。
なお，コネクションの障害検知にタイムアウトを設定する場合には，NetworkFailureTimeoutでコネクション管理スレッドの使用を有効にします。※2

コネクションの取得リトライ
<property>タグのRetryCountでコネクション取得に失敗した場合のリトライ回数を指定し，RetryIntervalでリトライ間隔を指定します。

コネクションスイーパ
<property>タグのSweeperIntervalでコネクションの自動破棄（コネクションスイーパ）が動作する間隔を指定し，ConnectionTimeoutでコネクションの最終利用時刻からコネクションを自動破棄するかどうかを判定するまでの時間を指定します。

コネクション枯渇時のコネクション取得待ち
<property>タグのRequestQueueEnableでコネクション枯渇時のコネクション取得待ちを有効にするかどうかを指定し，RequestQueueTimeoutで待ち時間を指定します。

コネクションプールのウォーミングアップ
コネクションプールのウォーミングアップ機能を使用する場合，<property>タグで，Warmupを指定します。

コネクション管理スレッド
コネクション管理スレッドを使用する場合，<property>タグで，NetworkFailureTimeoutを指定します。
コネクション管理スレッドを使用する場合，コネクションの障害検知機能，およびコネクション数調節機能のタイムアウト（どちらもタイムアウト時間は5秒で固定）を使用する設定になります。

コネクション数調節機能
<property>タグのConnectionPoolAdjustmentIntervalで，コネクション数調節機能が動作する間隔を指定します。
なお，コネクション数調節機能にタイムアウトを設定する場合には，NetworkFailureTimeoutでコネクション管理スレッドの使用を有効にします。※2

別名情報
ルックアップ名称の別名
<resource-external-property>－<optional-name>タグにリソースの別名を指定します。
別名の設定方法については，「9.8　リソースまたはJ2EEアプリケーションの別名の設定」を参照してください。

注※1　XDM/RD E2 11-01以前のバージョンの場合，ステートメントプーリング機能を利用できないため，これらのプロパティには0を指定してください。

注※2　同じキーで設定します。このため，コネクションの障害検知機能でタイムアウトを使用する場合は，コネクション数調節機能でもタイムアウトを使用する設定となります。

なお，DB Connectorを使用してデータベースに接続する場合と，リソースアダプタを使用してOpenTP1などの各種リソースに接続する場合では，プロパティの設定内容が異なります。また，使用するデータベースの種類によっても，プロパティの設定内容が異なります。

DB Connectorを使用してデータベースに接続する場合に設定する，DB Connectorのプロパティ定義については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Cosminexus RMで提供するリソースアダプタに設定するプロパティについては，マニュアル「Cosminexus Reliable Messaging」を参照してください。

OpenTP1で提供するリソースアダプタに設定するプロパティについては，uCosminexus TP1 Connectorのドキュメント，およびマニュアル「OpenTP1　クライアント使用の手引　TP1/Client/J編」を参照してください。

TP1/Message Queueで提供するリソースアダプタに設定するプロパティについては，マニュアル「OpenTP1 Version 6 メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引」を参照してください。

(2)　Connector 1.5仕様に準拠したリソースアダプタで設定できる項目

リソースアダプタのプロパティとして設定する項目のうち，Connector 1.5仕様に準拠したリソースアダプタで設定できる主な項目と，その項目の設定方法について説明します。なお，ここでは，Connector 1.5仕様に準拠したリソースアダプタ固有の内容を説明します。

Connector 1.5仕様に準拠したリソースアダプタのプロパティ定義で設定できる内容を次の表に示します。

表9-6　Connector 1.5仕様に準拠したリソースアダプタのプロパティ定義で設定できる内容

分類
項目
設定内容

管理対象オブジェクト
管理対象オブジェクト名※1
<adminobject>－<adminobject-name>タグ※2にルックアップで使用するオブジェクト名を指定します。管理対象オブジェクトをルックアップの対象にする場合は必ず指定してください。オブジェクト名には，連続したアンダースコア"__"を含めてはいけません。
なお，管理対象オブジェクトをルックアップする場合には，J2EEアプリケーションの設定も必要です。「9.6.3(4)　リソース接続とトランザクション管理の機能を使用するための設定」を参照してください。

インタフェース
<adminobject>－<adminobject-interface>タグに使用するインタフェースを指定します。javax.jms.Queue，javax.jms.Topicなどを指定します。

実装クラスとプロパティ
<adminobject-class>タグに実装クラスを指定します。
<config-property>タグ下に管理対象オブジェクトのプロパティを設定します。

注※1　メッセージインフローで使用する管理対象オブジェクトの場合，指定する必要はありません。

注※2　DD（ra.xml）には存在しないタグです。

9.6.2　JavaBeansリソースのプロパティ定義で設定できること

JavaBeansリソースのプロパティを新規に設定する場合は，JavaBeansリソース属性ファイルのテンプレートを使用してJavaBeansリソース属性ファイルを作成して，プロパティを定義します。また，設定変更の場合は，サーバ管理コマンドでJavaBeansリソース属性ファイルを取得して，プロパティを定義します。cjgetjbpropコマンドでJavaBeansリソース属性ファイルを取得して，ファイル編集後に，cjsetjbpropコマンドで編集内容を反映させてください。

JavaBeansリソースのプロパティ定義で設定できる主な内容を次の表に示します。

表9-7　JavaBeansリソースのプロパティ定義で設定できる主な内容

分類
項目
設定内容

実行時プロパティ
リソースのタイプ
<res-type>タグにJavaBeansリソースのクラス名を指定します。

プロパティ情報
<property>タグ下の次のタグに設定します。

<property-name>タグにJavaBeansリソースのsetメソッド，getメソッドのメソッド名を指定します。

<property-type>タグにJavaBeansリソースのsetメソッドの引数の型を指定します。

<property-value>タグにJavaBeansリソースのsetメソッドの引数に渡す値を指定します。

別名情報
別名
JavaBeansリソースに別名を付与する場合，<resource-env-external-property>－<optional-name>タグにJavaBeansリソースの別名を指定します。
別名の設定については，「9.8　リソースまたはJ2EEアプリケーションの別名の設定」を参照してください。

参考

DD（ra.xml）の<resource-ref>タグで指定していた<res-auth>属性と，<res-sharing-scope>属性は，JavaBeansリソース属性ファイルの<resource-env-external-property>タグには指定できません。

9.6.3　J2EEアプリケーションのプロパティ定義で設定できること

J2EEアプリケーションのプロパティとして設定する項目のうち，主な項目と，その項目の設定方法について説明します。

J2EEアプリケーションのプロパティは，サーバ管理コマンドまたはServer Plug-inを使用して定義します。

ここではサーバ管理コマンドで使用する属性ファイルとタグについて説明します。cjgetapppropコマンドで属性ファイルを取得し，属性ファイル編集後に，cjsetapppropコマンドで編集内容を反映させてください。なお，ここで示した属性ファイル以外に，J2EEアプリケーションのすべての属性情報が含まれているアプリケーション統合属性ファイルも使用できます。

Server Plug-inを使用する場合，属性ファイルのタグに対応した項目に設定します。属性ファイルのタグと対応する画面については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

項目を設定する属性ファイルとタグ，サーバ管理コマンドとServer Plug-inでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ここで説明していない項目と，その項目を設定する属性ファイルやタグの詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　Webコンテナの機能を使用するためのJ2EEアプリケーションの設定

(2)　EJBコンテナの機能を使用するための設定

(3)　ネーミング管理の機能を使用するための設定

(4)　リソース接続とトランザクション管理の機能を使用するための設定

(5)　CTMの機能を使用するための設定

(1)　Webコンテナの機能を使用するためのJ2EEアプリケーションの設定

Webコンテナの機能を使用するためのJ2EEアプリケーションの設定を，次の表に示します。

表9-8　Webコンテナの機能を使用するためのJ2EEアプリケーションの設定

機能
項目
設定対象
設定内容

セッション管理
HttpSession数の上限値
WAR
WAR属性ファイルの<http-session-max-number>タグに，HTTPセッション数の上限値を指定します。
セッションフェイルオーバ機能を使用する場合には，セッション情報の引き継ぎを行うWebアプリケーションに対してHTTPセッション数の上限値を指定します。設定方法については，「6.2.5　HTTPセッション数の上限値の設定」を参照してください。

デフォルトの文字エンコーディング設定
Webアプリケーション単位での設定※1
WAR
WAR属性ファイルで，次のタグを設定します。

<http-request>－<encoding>タグに，リクエストボディおよびクエリのデコードに使用する，文字エンコーディングを設定します。

<http-response>－<encoding>タグに，レスポンスボディのエンコードに使用する，文字エンコーディングを設定します。

<jsp>－<page-encoding>タグに，JSPファイルの文字エンコーディングを設定します。

リクエストおよびレスポンスのフィルタリング
フィルタの定義
フィルタ，
WAR
フィルタ属性ファイル，WAR属性ファイル，またはweb.xml※2に，使用するフィルタおよびフィルタのマッピングを定義します。
フィルタの定義については，「9.7　Webアプリケーションに組み込むサーブレットフィルタの設定」を参照してください。

セキュリティ管理
SSL使用による認証情報とデータの暗号化をする場合の暗号レベルの設定
WAR
WAR属性ファイルまたはweb.xmlの<user-data-constraint>タグ※2に，暗号化レベルを指定します。

ロールに基づくWebコンテナのユーザ認証
WAR
WAR属性ファイルまたはweb.xmlの<security-constraint>タグ※2に，セキュリティ制約を指定します。
また，WAR属性ファイルまたはweb.xmlの<login-config>タグ※2に，Webコンテナでの認証方法を指定します。

同時実行スレッド数の制御
－
WAR
WAR属性ファイルの<thread-control>タグで，Webアプリケーション単位での同時実行スレッド数を設定します。また，<thread-control>－<urlgroup-thread-control>タグで，URLグループ単位での同時実行スレッド数を設定します。
同時実行スレッド数の制御については，「4.4　同時実行スレッド数の制御の設定」を参照してください。

ドメイン名指定でのトップページの表示
Webアプリケーションのコンテキストルートを空文字に設定
WAR
WAR属性ファイル，またはサーブレット属性ファイルの<context-root>タグに，空文字を指定します。
このほか，リダイレクタ（Webサーバ連携の場合）でリダイレクトするURLの設定が必要です。設定方法については，「7.5　ドメイン名指定でトップページを表示するための設定」を参照してください。

Webアプリケーション単位の静的コンテンツのキャッシュの制御
－
WAR
アプリケーション属性ファイルまたはweb.xml※2に，静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を指定します。設定方法については，「4.5　静的コンテンツのキャッシュの設定」を参照してください。

リファレンスマッピング定義
Enterprise Bean，またはリソースへのリファレンスの解決
WAR
WAR属性ファイルで，次のタグを設定します。

<ejb-ref>タグに，Enterprise Bean（リモートインタフェース）の情報を設定します。

<ejb-local-ref>タグに，Enterprise Bean（ローカルインタフェース）の情報を設定します。

<resource-ref>タグに，リソースの情報を設定します。

<resource-env-ref>タグに，リソース環境の情報を設定します。

注※1　Webアプリケーション内のサーブレットまたはJSPファイルに，Servlet仕様での文字エンコーディング設定がある場合は，Servlet仕様での設定が有効になります。設定の優先順位については，マニュアル「Cosminexus　機能解説」のデフォルトの文字エンコーディング設定に関する説明を参照してください。なお，J2EEサーバ単位での設定については，「4.2(1)　Webコンテナの機能を使用するための設定」を参照してください。

注※2　J2EEサーバにデプロイ済みのWebアプリケーションに設定する場合は属性ファイルに設定します。J2EEサーバにデプロイする前のWebアプリケーションに設定する場合は，web.xmlに設定します。

(2)　EJBコンテナの機能を使用するための設定

EJBコンテナの機能を使用するためのJ2EEアプリケーションの設定を，次の表に示します。

表9-9　EJBコンテナの機能を使用するためのJ2EEアプリケーションの設定

機能
項目
設定対象
設定内容

Enterprise Beanでのトランザクション設定
Enterprise Beanでのトランザクション管理方法（BMTまたはCMT）の選択※
Session Bean
Session Bean属性ファイルの<transaction-type>タグに，Bean（BMT）またはContainer（CMT）のどちらを選択するかを指定します。

Message-driven Bean
Message-driven Bean属性ファイルの<transaction-type>タグに，Bean（BMT）またはContainer（CMT）のどちらを選択するかを指定します。

CMT
メソッドに割り当てるトランザクション属性
Session Bean，
Entity Bean，
Message-driven Bean
Session Bean属性ファイル，
Entity Bean属性ファイル，または
Message-driven Bean属性ファイルの<trans-attribute>タグに，メソッドに割り当てるトランザクション属性を指定します。

プール管理
Stateless Session Beanのプーリング
Session Bean
Session Bean属性ファイルの<pooled-instance>タグに，プールするインスタンス数の最大値と最小値を指定します。

Entity Beanのプーリング
Entity Bean
Entity Bean属性ファイルの<pooled-instance>タグに，プールするインスタンス数の最大値と最小値を指定します。

Message-driven Beanのプーリング
Message-driven Bean
Message-driven Bean属性ファイルの<pooled-instance>タグに，プールするインスタンス数の最大値を指定します。

Entity Beanのコミットオプション
コミットオプション
Entity Bean
Entity Bean属性ファイルの<caching-model>タグに，CMPフィールドのキャッシュ方法を指定します。

EJBコンテナでのタイムアウト
Stateful Session Beanのタイムアウト
Session Bean
Session Bean属性ファイルの<inactivity-timeout>タグに，再びアクティブ化するまで非アクティブ状態に保持しておく時間を指定します。

Entity BeanのEJBオブジェクトのタイムアウト
Entity Bean
Entity Bean属性ファイルの<entity-timeout>タグに，EJBオブジェクトの存在時間を指定します。

インスタンス取得待ちのタイムアウト
Session Bean，
Entity Bean
Session Bean属性ファイルまたはEntity Bean属性ファイルの<instance-timeout>タグに，インスタンス取得タイムアウト時間を指定します。

リモートインタフェース呼び出し
リモートインタフェースでの値の参照渡しを有効にするかどうか
Session Bean，
Entity Bean
Session Bean属性ファイルまたはEntity Bean属性ファイルの<pass-by-reference>タグに，Enterprise Bean単位でEJBのリモートインタフェースでの値の参照渡しを有効にするかどうかを指定します。

セキュリティアイデンティティを使用した認証
セキュリティアイデンティティを使用した認証をするかどうか
Session Bean，
Entity Bean，
Message-driven Bean
Session Bean属性ファイル，Entity Bean属性ファイル，Message-driven Bean属性ファイルの<security-identity>タグに，認証するかどうかを指定します。

RunAs機能
RunAs機能を使用するかどうか
Session Bean属性ファイル，Entity Bean属性ファイル，Message-driven Bean属性ファイルの<run-as>タグに，RunAs機能を使用するかどうかを指定します。

RunAs機能で使用するセキュリティロール名
Session Bean属性ファイル，Entity Bean属性ファイル，Message-driven Bean属性ファイルの<role-name>タグに，セキュリティロール名を指定します。

RunAs機能で使用するプリンシパル名
Session Bean属性ファイル，Entity Bean属性ファイル，Message-driven Bean属性ファイルの<user-name>タグに，プリンシパル名を指定します。

リファレンスマッピング定義
Enterprise Bean，またはリソースへのリファレンスの解決
Session Bean，Entity Bean，Message-driven Bean
Session Bean属性ファイル，Entity Bean属性ファイルまたはMessage-driven Bean属性ファイルで，次のタグを設定します。

<ejb-ref>タグに，Enterprise Bean（リモートインタフェース）の情報を設定します。

<ejb-local-ref>タグに，Enterprise Bean（ローカルインタフェース）の情報を設定します。

<resource-ref>タグに，リソースの情報を設定します。

<resource-env-ref>タグに，リソース環境の情報を設定します。

注※　BMTを選択した場合，トランザクションの制御は，API（javax.transaction.UserTransactionクラスのメソッドなど）で実行する必要があります。

(3)　ネーミング管理の機能を使用するための設定

ネーミング管理の機能を使用するためのJ2EEアプリケーションの設定を，次の表に示します。

表9-10　ネーミング管理の機能を使用するためのJ2EEアプリケーションの設定

機能
項目
設定対象
設定内容

ルックアップ
ルックアップ名称
Session Bean，Entity Bean
Session Bean属性ファイルまたはEntity Bean属性ファイルの<lookup-name>タグに，ルックアップ名称を指定します。

ユーザ指定名前空間機能※
ルックアップ名称の別名
Session Bean，Entity Bean
Session Bean属性ファイルまたはEntity Bean属性ファイルの次のどちらかのタグに，ルックアップ名称の別名を指定します。

<optional-name>タグ
リモートインタフェースの別名を指定します。

<local-optional-name>タグ
ローカルインタフェースの別名を指定します。

別名の設定については，「9.8　リソースまたはJ2EEアプリケーションの別名の設定」を参照してください。

注※　この機能を使用する場合は，サーバ管理コマンドのusrconf.propertiesで別名を使用するかどうかを指定しておく必要があります。設定方法については，「9.2.2　サーバ管理コマンドの動作設定のカスタマイズ」を参照してください。

(4)　リソース接続とトランザクション管理の機能を使用するための設定

リソース接続とトランザクション管理の機能を使用するためのJ2EEアプリケーションの設定を，次の表に示します。

表9-11　リソース接続とトランザクション管理の機能を使用するためのJ2EEアプリケーションの設定

機能 | 項目 | 対象 | 設定内容
コネクションシェアリング | コネクションを共有するかどうか | WAR，Session Bean，Entity Bean，Message-driven Bean | WAR属性ファイル，Session Bean属性ファイル，Entity Bean属性ファイルまたはMessage-driven Bean属性ファイルの<res-sharing-scope>タグに，取得したコネクションを共有するかどうかを設定します。
トランザクションタイムアウト | Enterprise Bean，インタフェース，メソッド単位のトランザクションタイムアウト | Session Bean，Entity Bean，Message-driven Bean | Session Bean属性ファイル，Entity Bean属性ファイルまたはMessage-driven Bean属性ファイルの<ejb-transaction-timeout>タグに，CMTの場合のトランザクションをタイムアウトする時間を指定します。

Connector 1.5仕様のリソースアダプタを使用してリソースに接続する場合は，次の項目も設定できます。

表9-12　リソース接続とトランザクション管理の機能を使用するためのJ2EEアプリケーションの設定（Connector 1.5仕様に準拠するリソースアダプタを使用する場合）

機能
項目
対象
設定内容

管理対象オブジェクトのルックアップ
管理対象オブジェクトのルックアップで使用する情報
WAR，Session Bean，Entity Bean，Message-driven Bean
<resource-env-ref>タグ下の次のタグに設定します。

<resource-env-ref-name>タグに，ルックアップで使用する名前を指定します。

<resource-env-ref-type>タグに，管理対象オブジェクトの型を指定します。

<linked-adminobject>－<resourceadapter-name>タグに，管理対象オブジェクトが含まれるリソースアダプタの表示名を指定します。

<linked-adminobject>－<adminobject-name>タグに，管理対象オブジェクトのオブジェクト名を指定します。

メッセージインフロー※
リソースアダプタとの対応づけ
Message-driven Bean
<message-ref>－<connection-destination>タグ下の<resource-adapter>タグに，対応づけるリソースアダプタの表示名を指定します。

Message-driven Beanが使用するインタフェース
Message-driven Bean
<messaging-type>タグに，Message-driven Beanが実装するインタフェースを指定します。

ActivationSpecの設定
Message-driven Bean
<activation-config>－<activation-config-property>タグ下の<activation-config-property-name>タグおよび<activation-config-property-value>タグに，ActivationSpecに設定するプロパティを指定します。

注※

設定値の一部は，使用するリソースアダプタの設定値と合わせる必要があります。詳細は，「9.9　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定」を参照してください。

(5)　CTMの機能を使用するための設定

CTMの機能を使用するためのJ2EEアプリケーションの設定を，次の表に示します。

表9-13　CTMの機能を使用するためのJ2EEアプリケーションの設定

機能 | 項目 | 対象 | 設定内容
CTMによるリクエストのスケジューリング | J2EEアプリケーション単位でのスケジューリング | J2EEアプリケーション | アプリケーション属性ファイルの<managed-by-ctm>タグ，<scheduling>タグ，または<scheduling-unit>タグで，J2EEアプリケーション単位に，CTMの利用の有無や，スケジュールキューの長さなどを設定します。
Stateless Session Bean単位でのスケジューリング | SessionBean | SessionBean属性ファイルの<enable-scheduling>タグ，<stateless>－<pooled-instance>タグ，または<scheduling>タグで，Stateless Session Bean単位に，スケジューリングの対象にするStateless Session Beanの指定，プールしておくインスタンス数の最大値や最小値などを設定します。

9.7　Webアプリケーションに組み込むサーブレットフィルタの設定

この節では，Cosminexusで提供しているサーブレットフィルタの概要と，各サーブレットフィルタのWebアプリケーションへの組み込み方法について説明します。

＜この節の構成＞

9.7.1　サーブレットフィルタの組み込み

9.7.2　セッションフェイルオーバ用フィルタの設定

9.7.3　HTTPレスポンス圧縮フィルタの設定

9.7.1　サーブレットフィルタの組み込み

Cosminexusでは，Cosminexus独自の機能を使用するためのサーブレットフィルタを提供しています。Cosminexusが提供するサーブレットフィルタをbuilt-inフィルタといいます。

built-inフィルタの種類，サーバ管理コマンドでのbuilt-inフィルタの組み込み手順について説明します。

＜この項の構成＞

(1)　built-inフィルタの種類

(2)　built-inフィルタの組み込み手順

(1)　built-inフィルタの種類

Cosminexusで提供しているbuilt-inフィルタは，次の2種類です。

セッションフェイルオーバ用フィルタ

HTTPレスポンス圧縮フィルタ

ポイント

各フィルタをWebアプリケーションに組み込む場合は，フィルタマッピング定義で，「セッションフェイルオーバ用フィルタ」，「HTTPレスポンス圧縮フィルタ」の順に定義してください。セッションフェイルオーバ用フィルタは，すべてのbuilt-inフィルタ，ユーザのフィルタよりも前に配置する必要があります。

ここでは，各built-inフィルタの概要について説明します。なお，各built-inフィルタの処理内容，およびbuilt-inフィルタの組み込み順序については，マニュアル「Cosminexus　機能解説」のCosminexusが提供するサーブレットフィルタに関する説明を参照してください。

(a)　セッションフェイルオーバ用フィルタ

セッションフェイルオーバ機能とは，J2EEサーバやWebサーバでの障害発生時に，J2EEサーバ上のHTTPSessionオブジェクトに登録されたオブジェクトを引き継ぐ機能です。

セッションフェイルオーバ用フィルタは，J2EEアプリケーションで実行中のセッション情報を管理するサーブレットフィルタです。また，J2EEサーバで障害が発生したときに，管理しているセッション情報をほかのJ2EEサーバに引き継ぎます。セッションフェイルオーバ用フィルタでは，セッション情報を管理し，J2EEサーバ間のセッションの情報を引き継ぐために，次の内容を設定します。

グローバルセッション情報

グローバルセッション情報の最大サイズ

グローバルセッション情報を格納するSFOサーバの名称

グローバルセッションの制御方法

グローバルセッションIDの送信に使用するCookieの名称

グローバルセッションIDの送信に使用するURLのパスパラメタ名

グローバルセッション情報のロック待ちタイムアウト

byte型配列であるセッション情報の引き継ぎ許可

直列化可能クラスのオブジェクトであるセッション情報の引き継ぎ許可

(b)　HTTPレスポンス圧縮フィルタ

HTTPレスポンス圧縮機能とは，サーブレット，JSP，および静的コンテンツへのHTTPリクエストに対するHTTPレスポンスを，gzip形式に圧縮する機能です。この機能を使用してHTTPレスポンスを圧縮することで，WebコンテナとWebクライアント（ブラウザなど）との間のHTTPレスポンス通信に掛かる時間を削減できます。

HTTPレスポンス圧縮フィルタは，HTTPレスポンスの圧縮対象となる，HTTPリクエストのURLパターンやMedia-Typeなどを定義するサーブレットフィルタです。

(2)　built-inフィルタの組み込み手順

built-inフィルタをWebアプリケーションに組み込む方法には，サーバ管理コマンドを使用した属性ファイルの編集による方法と，Server Plug-inを使用する方法と，WebアプリケーションのDD（web.xml）の直接編集による方法の3種類があります。

ここでは，サーバ管理コマンドを使用した属性ファイルの編集によるフィルタの組み込みについて説明します。Server Plug-inを使用したフィルタの組み込みについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，WebアプリケーションのDD（web.xml）の直接編集によるフィルタの組み込みについては，マニュアル「Cosminexus　機能解説」を参照してください。

サーバ管理コマンドを使用した属性ファイルの編集によるフィルタの組み込みの手順を次に示します。なお，属性ファイルに指定する内容は，フィルタごとに異なります。各フィルタでの指定内容については，以降の項での各フィルタの設定を参照してください。

(a)　フィルタの追加

フィルタの追加は，サーバ管理コマンドで実行します。フィルタの追加手順を次に示します。

フィルタ属性ファイルを作成します。
テキストエディタなどを使用して，フィルタ属性ファイルを作成します。
フィルタ属性ファイルには，次の内容を指定します。

<filter-name>タグ，<filter-class>タグでのフィルタ定義

<filter-name>タグに，追加するフィルタ名称を指定します。

<filter-class>タグに，追加するフィルタのクラス名を指定します。

<init-param>タグでの各種定義

<init-param>タグ内の<param-name>タグ，および<param-value>タグに，初期化パラメタの名称および初期化パラメタの値を指定します。

フィルタ属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

cjaddappコマンドの引数に手順1.で作成したフィルタ属性ファイルを指定し，コマンドを実行してJ2EEアプリケーション内のWARファイルにフィルタを登録します。
コマンドの引数には，手順1.で作成したフィルタ属性ファイルを指定します。

コマンドの実行例（Windowsの場合）

cjaddapp MyServer -type filter -name app1 -warname adder_war -c C:¥home¥adder_filter.xml

コマンドの実行例（UNIXの場合）

cjaddapp MyServer -type filter -name app1 -warname adder_war -c /tmp/work/adder_filter.xml

(b)　フィルタのマッピング

WARファイルに登録したフィルタのマッピングを定義します。フィルタのマッピングは，サーバ管理コマンドで定義できます。

cjgetapppropコマンドを実行して，フィルタを登録したWARファイルからWAR属性ファイルを取得します。

コマンドの実行例（Windowsの場合）

cjgetappprop MyServer -name app1 -type war -resname adder_war -c C:¥home¥adder_war.xml

コマンドの実行例（UNIXの場合）

cjgetappprop MyServer -name app1 -type war -resname adder_war -c /tmp/work/adder_war.xml

テキストエディタなどでWAR属性ファイルを編集して，フィルタのマッピングを定義します。
WAR属性ファイルには，次の内容を指定します。

<filter-mapping>タグでのフィルタマッピング定義

<filter-mapping>タグ内の<filter-name>タグに，フィルタ名称を指定します。

<filter-mapping>タグ内の<url-pattern>タグ，または<servlet-name>タグに，フィルタとマッピングするURLパターンやサーブレットクラスを指定します。

WAR属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

cjsetapppropコマンドの引数に手順2.で編集したWAR属性ファイルを指定し，コマンドを実行してフィルタのマッピング情報を登録します。

コマンドの実行例（Windowsの場合）

cjsetappprop MyServer -name app1 -type war -resname adder_war -c C:¥home¥adder_war.xml

コマンドの実行例（UNIXの場合）

cjsetappprop MyServer -name app1 -type war -resname adder_war -c /tmp/work/adder_war.xml

9.7.2　セッションフェイルオーバ用フィルタの設定

セッションフェイルオーバ用フィルタを有効にするには，次の設定が必要です。

SFOサーバ，およびJ2EEサーバの設定
セッションフェイルオーバ機能を使用するために必要な設定については，「6.2　J2EEサーバ間のセッション情報の引き継ぎの設定」を参照してください。

セッションフェイルオーバ用フィルタのWebアプリケーションへの組み込み
サーバ管理コマンドを使用した属性ファイルの編集，またはWebアプリケーションのDD（web.xml）の直接編集によって，セッションフェイルオーバ用フィルタをWebアプリケーションに組み込みます。

ここでは，セッションフェイルオーバ用フィルタのWebアプリケーションへの組み込みについて説明します。

ポイント

セッション情報の引き継ぎを行うWebアプリケーションを含むJ2EEアプリケーションの開始後にWebアプリケーションの設定を変更する場合，J2EEアプリケーションを再開始する前に，SFOサーバに登録されたWebアプリケーションの設定情報を削除する必要があります。SFOサーバに登録されたWebアプリケーションの設定情報の削除方法については，「6.2.7　Webアプリケーションの設定情報の削除」を参照してください。

＜この項の構成＞

(1)　セッションフェイルオーバ用フィルタのWebアプリケーションへの組み込み

(2)　グローバルセッション情報

(3)　グローバルセッション情報の最大サイズ

(4)　グローバルセッション情報を格納するSFOサーバの名称

(5)　グローバルセッションの制御方法

(6)　グローバルセッションIDの送信に使用するCookieの名称

(7)　グローバルセッションIDの送信に使用するURLのパスパラメタ名

(8)　グローバルセッション情報のロック待ちタイムアウト

(9)　byte型配列であるセッション情報の引き継ぎ許可

(10)　直列化可能クラスのオブジェクトであるセッション情報の引き継ぎ許可

(11)　属性ファイルの記述例

(1)　セッションフェイルオーバ用フィルタのWebアプリケーションへの組み込み

セッション情報の引き継ぎを行うWebアプリケーションへのフィルタの組み込みには，サーバ管理コマンドを使用した属性ファイルの編集による方法と，Server Plug-inを使用する方法と，WebアプリケーションのDD（web.xml）の直接編集による方法の3種類があります。ここでは，サーバ管理コマンドで属性ファイルを編集してフィルタを組み込む方法について説明します。Server Plug-inを使用したフィルタの組み込みについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，WebアプリケーションのDD（web.xml）の直接編集によるフィルタの組み込みについては，マニュアル「Cosminexus　機能解説」のセッションフェイルオーバ機能を使用するアプリケーションの実装に関する説明を参照してください。

Webアプリケーションにセッションフェイルオーバ用フィルタを組み込むために，フィルタ属性ファイルおよびWAR属性ファイルに設定する内容を次の表に示します。なお，属性ファイルの取得，編集した属性ファイルの設定の手順については，「9.7.1(2)　built-inフィルタの組み込み手順」を参照してください。

表9-14　属性ファイルでの設定内容（セッションフェイルオーバ用フィルタ）

設定項目
属性ファイル名
タグ名
設定内容

フィルタ定義
フィルタ属性ファイル
<filter-name>タグ
追加するフィルタ名称を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.sfo.web.SFOFilter

<filter-class>タグ
追加するフィルタのクラス名を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.sfo.web.SFOFilter

セッション情報の引き継ぎの定義
<init-param>タグ内の<param-name>タグおよび<param-value>タグ
初期化パラメタの名称および初期化パラメタの値を指定します。セッション情報の引き継ぎに設定する項目については，表9-15および表9-16を参照してください。

フィルタマッピング定義※
WAR属性ファイル
<filter-mapping>タグ内の<filter-name>タグ
フィルタ名称を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.sfo.web.SFOFilter

<filter-mapping>タグ内の<url-pattern>タグ
URLパターンやサーブレットクラスと，セッションフェイルオーバ用フィルタのマッピングを指定します。
セッションフェイルオーバ用フィルタでは，すべてのWebアプリケーションに対してセッションフェイルオーバ用フィルタをマッピングするため，「/*」を指定してください。
設定値は，固定値です。

設定値（固定値）

/*

注※　フィルタマッピングを定義する場合，次の点に注意してください。

フィルタマッピング定義を複数定義する場合，セッションフェイルオーバ機能用のフィルタマッピング定義を最初に記述してください。最初に記述しない場合はアプリケーションを開始できません。

セッションフェイルオーバ機能用のフィルタマッピング定義は複数定義しないでください。複数定義した場合はアプリケーションを開始できません。

WebアプリケーションのバージョンがServlet2.4の場合，<filter-mapping>タグの要素，および<dispatcher>タグは指定しないでください。また，<dispatcher>タグで「FORWARD」，「INCLUDE」，「ERROR」を指定した場合，Webアプリケーションの開始時にセッションフェイルオーバ用フィルタの初期化でエラーが発生し，アプリケーションが開始できなくなるので，注意してください。

セッション情報の引き継ぎに設定する項目と<param-name>タグに指定する初期化パラメタの対応について次の表に指定します。

表9-15　セッション情報の引き継ぎに設定する項目と<param-name>タグに指定する初期化パラメタの対応

設定項目 | <param-name>タグに指定する初期化パラメタ | <param-value>タグに指定する内容の参照先
グローバルセッション情報 | 書き換え可能な情報 | GSInfoKey-RW | 9.7.2(2)
読み取り専用の情報 | GSInfoKey-R
グローバルセッション情報の最大サイズ | GSInfosLengthMax | 9.7.2(3)
グローバルセッション情報を格納するSFOサーバの名称 | SFOServerName | 9.7.2(4)
グローバルセッションの制御方法 | GSessionControl | 9.7.2(5)
グローバルセッションIDの送信に使用するCookieの名称 | GIDCookieName | 9.7.2(6)
グローバルセッションIDの送信に使用するURLのパスパラメタ名 | GIDURLParamName | 9.7.2(7)
グローバルセッション情報のロック待ちタイムアウト | LockTimeout | 9.7.2(8)
byte型配列であるセッション情報の引き継ぎ許可 | GSInfoTypeByteArrayEnable | 9.7.2(9)
直列化可能クラスのオブジェクトであるセッション情報の引き継ぎ許可 | GSInfoTypeSerializableEnable | 9.7.2(10)

これらのパラメタは，使用する機能によって設定するかどうかが異なります。使用する機能ごとの<param-name>タグに指定する初期化パラメタの設定要否を次の表に示します。

表9-16　使用する機能ごとの<param-name>タグに指定する初期化パラメタの設定要否

<param-name>タグに指定する初期化パラメタ | 使用する機能
セッションフェイルオーバ機能の設定要否 | グローバルセッション情報のサイズ見積もり機能の設定要否
GSInfoKey-RW | 任意※1 | 任意※1
GSInfoKey-R | 任意※1 | 任意※1
GSInfosLengthMax | 任意 | 無効※2
SFOServerName | 任意 | 無効※3
GSessionControl | 任意 | 任意
GIDCookieName | 任意 | 任意
GIDURLParamName | 任意 | 任意
LockTimeout | 任意 | 無効※2
GSInfoTypeByteArrayEnable | 任意 | 任意
GSInfoTypeSerializableEnable | 任意 | 任意

（凡例）

任意：省略できることを示す。省略した場合はデフォルトの値が設定される。

無効：指定しても無効になることを示す。設定した値は使用されない。

注※1　GSInfoKey-RWとGSInfoKey-Rの両方を省略することはできません。

注※2　パラメタに不正な値を指定した場合はエラーとなり，Webアプリケーションは開始できません。

注※3　指定したSFOサーバ名が，簡易構築定義ファイルで指定されているSFOフィルタのサーバ定義名にない場合もエラーになりません。SFOフィルタのサーバ定義名は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.sfo.sfo_serversパラメタで指定します。

注意

セッション情報の引き継ぎに関する設定を変更するときは，フィルタ属性ファイルの<init-param>タグ内にある<param-name>タグおよび<param-value>タグを編集します。なお，タグの指定を省略する場合，タグの記述も含めて省略する必要があります（<init-param>タグ～</init-param>タグの記述を省略します）。次のようにタグを記述して値だけ省略した場合，空白文字列が指定されたと判断してエラーとなります。

間違った省略方法の例

　　 （省略）
　　　　：
<init-param>
<param-name>LockTimeout</param-name>
<param-value></param-value>
</init-param>
　　　　：
　　 （省略）

(2)　グローバルセッション情報

HTTPセッションに登録されるセッション情報の中から，グローバルセッション情報として，SFOサーバに引き継ぐセッション情報を選択します。また，グローバルセッション情報には，書き換え可能な情報と読み取り専用の情報の2種類があるため，グローバルセッション情報の種別を指定します。

グローバルセッション情報の設定に使用する初期化パラメタは，GSInfoKey-RWパラメタ（書き換え可能な場合）またはGSInfoKey-Rパラメタ（読み取り専用の場合）です。GSInfoKey-RWパラメタおよびGSInfoKey-Rパラメタには同じ値を指定しないでください。同じ値を指定した場合，Webアプリケーションの開始時にエラーとなり，Webアプリケーションは開始できません。また，GSInfoKey-RWパラメタおよびGSInfoKey-Rパラメタの両方を省略することはできません。

グローバルセッション情報として指定できるセッション情報と，セッション情報のデータ型，グローバルセッション情報の種別について説明します。なお，統合ユーザ管理機能を使用する場合には，セッション情報の種別，およびパラメタの設定値が決まっています。詳細については，「(d)　統合ユーザ管理機能を使用する場合のグローバルセッション情報」を参照してください。

(a)　グローバルセッション情報として指定できるセッション情報

HTTPセッションに登録されるセッション情報の中から，グローバルセッション情報として，SFOサーバに引き継ぐセッション情報を選択します。

グローバルセッション情報として指定できるセッション情報は，HTTPセッションに登録された一部，またはすべてです。HTTPセッションに登録される一部のセッション情報をグローバルセッション情報として指定する場合は，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタで，SFOサーバに引き継ぐセッション情報のキー名称を指定します。HTTPセッションに登録されるすべてのセッション情報をグローバルセッション情報として指定する場合は，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタで，*（半角アスタリスク）を指定します。

グローバルセッション情報を選択するときの留意事項を次に示します。

グローバルセッション情報として，HTTPセッションに登録されたすべてのセッション情報を指定すると，引き継ぐ必要のない情報がHTTPセッションに登録されている場合にリクエスト処理のパフォーマンスが低下することがあります。このため，必要最小限のセッション情報を，グローバルセッション情報としてSFOサーバに引き継ぐように設定することをお勧めします。必要最小限のグローバルセッション情報を引き継ぐことで，SFOサーバのパフォーマンスの向上を図れます。

(b)　グローバルセッション情報として指定できるセッション情報のデータ型

グローバルセッション情報として指定できるセッション情報には，次のデータ型が指定できます。

java.lang.Stringクラスのオブジェクト

byte型配列

直列化可能クラスのオブジェクト

データ型にjava.lang.Stringクラスのオブジェクト以外を指定する場合は，どのデータ型のセッション情報に対して引き継ぎを許可するかを，GSInfoTypeByteArrayEnableパラメタまたはGSInfoTypeSerializableEnableパラメタで設定します。

グローバルセッション情報として，指定したデータ型以外のオブジェクトがHTTPセッションに登録されると，SFOサーバへのセッション情報の引き継ぎでエラーが発生し，セッション情報は保持されません。引き継ぎ対象外のオブジェクトがHTTPセッションに登録された場合の，引き継ぎ対象外のオブジェクトの扱いについては，マニュアル「Cosminexus　機能解説」を参照してください。

グローバルセッション情報のデータ型を指定するときの留意事項を次に示します。

引き継ぎ対象のセッション情報のデータ型が，直列化可能クラスのオブジェクトの場合，グローバルセッション情報の更新処理や，引き継ぎ処理で，オブジェクトのシリアライズ処理またはデシリアライズ処理が必要になります。このため，引き継ぐ必要のない情報を含むクラスの場合，性能が低下する原因となることがあります。また，シリアライズ処理およびデシリアライズ処理では，引き継ぎ対象のHTTPセッションに登録されたオブジェクトだけでなく，そのオブジェクトから参照されるオブジェクトも処理の対象となるため，SFOサーバのパフォーマンスが低下することがあります。
グローバルセッション情報として引き継ぐセッション情報のデータ型には，java.lang.Stringクラスのオブジェクトまたはbyte型配列を指定することをお勧めします。

(c)　グローバルセッション情報の種別

グローバルセッション情報として選択したセッション情報を書き換え可能な情報とするか，または読み取り専用の情報とするか，どちらかを選択します。

なお，複数のグローバルセッション情報を選択した場合，それぞれのグローバルセッション情報に対して種別を指定してください。

グローバルセッション情報の種別の選択基準を次に示します。

書き換え可能なグローバルセッション情報とする場合
HTTPセッションに登録されたあと，更新が必要となるセッション情報です。
次に示す性質を持つセッション情報の場合，書き換え可能なグローバルセッション情報としてください。

HTTPセッションに登録されたあと，更新または削除が必要なセッション情報である。

リクエスト処理の推移とともに更新される可能性のあるセッション情報である。

なお，書き換え可能なグローバルセッション情報は，SFOサーバに障害が発生した場合，破棄されます。

読み取り専用のグローバルセッション情報とする場合
HTTPセッションに登録されたあと，更新されないセッション情報です。
ログイン情報などのように，HTTPセッションに一度登録したあと，更新されないセッション情報の場合，読み取り専用のグローバルセッション情報としてください。
なお，読み取り専用のグローバルセッション情報は，SFOサーバに障害が発生しても，そのまま使用できます。例えば，J2EEアプリケーションのログイン情報などを，読み取り専用グローバルセッション情報に設定すると，SFOサーバで障害が発生した場合でも，ユーザに対して再ログインを要求する必要がありません。このため，障害発生時のユーザへの影響を軽減できます。

(d)　統合ユーザ管理機能を使用する場合のグローバルセッション情報

統合ユーザ管理機能を使用する場合のセッション情報は，HTTPセッションに登録したあと変更が必要になるため，書き換え可能なグローバルセッション情報（GSInfoKey-RWパラメタ）を選択してください。また，GSInfoKey-RWパラメタには，「com.cosminexus.admin.auth.user_data」を設定してください。

(3)　グローバルセッション情報の最大サイズ

SFOサーバに格納するグローバルセッション情報の一つ当たりの最大サイズを指定します。SFOサーバで冗長化できるグローバルセッション情報のサイズは，デフォルトでは1,024バイトまでです。冗長化するグローバルセッション情報の文字数がこの値を超える場合は，設定を変更する必要があります。グローバルセッション情報の最大サイズの設定に使用する初期化パラメタは，GSInfosLengthMaxパラメタです。

なお，グローバルセッション情報の最大サイズを小さくすることにより，SFOサーバのメモリの消費量を削減できます。ご使用の環境に応じて，グローバルセッション情報の最大サイズに適切な値を設定してください。

グローバルセッション情報の最大サイズの見積もり式は，統合ユーザ管理機能を使用する場合と使用しない場合とで異なります。それぞれの場合の見積もり式について説明します。

(a)　統合ユーザ管理機能を使用しない場合

統合ユーザ管理機能を使用しない場合のグローバルセッション情報の最大サイズの見積もり式を次に示します。直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可しているかどうか（GSInfoTypeSerializableEnableパラメタの指定）によって，見積もり式が異なります。

直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可していない場合

グローバルセッション情報の最大サイズ
　　　　　＝各グローバルセッション情報のキー※1の文字列長の合計
　　　　　＋HTTPセッションに登録されたオブジェクトのサイズの最大長※2の合計
　　　　　＋区切り文字数※3
　　　　　＋HTTPセッションの有効期間情報※4

注※1

グローバルセッション情報の設定に使用する初期化パラメタ，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタに指定したキーです。

注※2

グローバルセッション情報がjava.lang.Stringクラスの場合，最大長は「最大文字列長」になります。また，グローバルセッション情報がbyte型配列の場合，最大長は「byte型配列の最大長+5」になります。

注※3

区切り文字数は，2×（設定したグローバルセッション情報の数）-1で算出できます。これは，区切り文字には，グローバルセッション情報間の区切り文字と，各グローバルセッション情報のキーと値の区切り文字が含まれるためです。

注※4

HTTPセッションの有効期間情報は4バイトです。

ただし，グローバルセッション情報がjava.lang.Stringクラスの場合，文字列をUTF-8の文字エンコーディングでURLエンコードして冗長化します（URLエンコードにはjava.net.URLEncoderクラスを使用します）。そのため，グローバルセッション情報の文字列長は，セッション情報の文字列長と異なることがあります。文字種ごとのURLエンコード後の文字列長を次の表に示します。

表9-17　文字種ごとのURLエンコード後の文字列長

項番
文字種
文字列長（バイト）

1
ASCII文字
英数字（0～9およびa～Z）および次に示す特殊文字

ピリオド（.）

ハイフン（-）

アスタリスク（*）

アンダースコア（_）

1

上記以外のASCII文字
3

2
JIS X 0201のすべての非ASCII文字
6または9

3
JIS X 0208のすべての非ASCII文字
6または9

4
JIS X 0212のすべての非ASCII文字
6または9

5
Windows-31Jの拡張文字
9

6
Unicodeの補助文字（基本多言語面以外の文字）
12

7
JIS X 0213の第3，第4水準漢字
9または12

このため，グローバルセッション情報のサイズは，セッション情報の文字列を文字種ごとにURLエンコード後の文字列長に変換してから，それらを合計して見積もる必要があります。
n種類のグローバルセッション情報を設定した場合の見積もり式の例を次に示します。

グローバルセッション情報の最大サイズ
　　　　　＝グローバルセッション情報1のキーの文字数
　　　　　＋グローバルセッション情報2のキーの文字数
　　　　　：
　　　　　＋グローバルセッション情報nのキーの文字数
　　　　　＋HTTPセッションに登録されたオブジェクト1の最大サイズ長
　　　　　＋HTTPセッションに登録されたオブジェクト2の最大サイズ長
　　　　　：
　　　　　＋HTTPセッションに登録されたオブジェクトnの最大サイズ長
　　　　　＋（2n-1）
　　　　　＋4

参考

グローバルセッション情報のサイズ見積もり機能を使用すると，HTTPセッションに含まれるセッション情報ごとのバイト数が出力できます。出力されたサイズ情報を参考にして，グローバルセッション情報の最大サイズに適切な値を設定してください。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可している場合

グローバルセッション情報の最大サイズ
　＝各グローバルセッション情報のキー※1のシリアライズ後のバイト数合計
　＋各HTTPセッションに登録されたオブジェクトのシリアライズ後のバイト数合計
　＋HTTPセッションの有効期間情報※2

注

シリアライズは，一つのHTTPセッションに対して，一つのjava.io.ObjectOutputStreamのオブジェクトを使用して実施します。

注※1

グローバルセッション情報の設定に使用する初期化パラメタ，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタに指定したキーです。

注※2

HTTPセッションの有効期間情報は4バイトです。

n種類のグローバルセッション情報を設定した場合の見積もり式の例を次に示します。

グローバルセッション情報の最大サイズ
　　　＝グローバルセッション情報1のキーのシリアライズ後のバイト数
　　　＋グローバルセッション情報2のキーのシリアライズ後のバイト数
　　　：
　　　＋グローバルセッション情報nのキーのシリアライズ後のバイト数
　　　＋HTTPセッションに登録されたオブジェクト1のシリアライズ後のバイト数
　　　＋HTTPセッションに登録されたオブジェクト2のシリアライズ後のバイト数
　　　：
　　　＋HTTPセッションに登録されたオブジェクトnのシリアライズ後のバイト数
　　　＋4

注

シリアライズは，一つのHTTPセッションに対して，一つのjava.io.ObjectOutputStreamのオブジェクトを使用して実施します。

参考

グローバルセッション情報のサイズ見積もり機能を使用すると，各情報のシリアライズ後のバイト数が出力できます。出力されたサイズ情報を参考にして，グローバルセッション情報の最大サイズに適切な値を設定してください。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

(b)　統合ユーザ管理機能を使用する場合

統合ユーザ管理機能を使用する場合のグローバルセッション情報の最大サイズの見積もり式を次に示します。

グローバルセッション情報の最大サイズ
　　　　　＝統合ユーザ管理で使用する値
　　　　　＋ユーザアプリケーションで使用する値

統合ユーザ管理で使用する値は，統合ユーザ管理フレームワークのAPIを使用する場合とタグライブラリを使用する場合で異なります。また，パスワード保存機能を使用するかどうかによっても異なります。それぞれの場合の統合ユーザ管理で使用する値の計算式を次に示します。

APIを使用し，パスワード保存機能を使用する場合

統合ユーザ管理で使用する値
　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長＋パスワードの最大長
　　　　＋1,200）×レルム数｝×2

APIを使用し，パスワード保存機能を使用しない場合

統合ユーザ管理で使用する値
　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長＋1,200）×レルム数｝×2

タグライブラリを使用し，パスワード保存機能を使用する場合

統合ユーザ管理で使用する値
　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長
　　　　＋loginタグのid属性値の長さ＋loginタグのentry属性値の長さ
　　　　＋パスワードの最大長＋1,200）×レルム数｝×2

タグライブラリを使用し，パスワード保存機能を使用しない場合

統合ユーザ管理で使用する値
　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長
　　　　＋loginタグのid属性値の長さ＋loginタグのentry属性値の長さ
　　　　＋1,200）×レルム数｝×2

ポイント

計算式中の1,500と1,200は固定値です。統合ユーザ管理の管理情報を保存するために必要な値です。なお，この値はオブジェクトをシリアライズしたときのバイト数の最大値を基に算出しています。

注意

セッションフェイルオーバ用フィルタの設定に誤りがある場合，セッションフェイルオーバが正しく行われませんので注意してください。

統合ユーザ管理では，GIDCookieNameパラメタが示す値が取得できたときに統合ユーザ管理でのセッションフェイルオーバ機能を有効にしますが，統合ユーザ管理からはセッションフェイルオーバ用フィルタの内容が正しいかチェックできません。このため，フィルタの設定に誤りがあった場合，実際にフェイルオーバが発生するまで誤りに気づかないおそれがあります。

(4)　グローバルセッション情報を格納するSFOサーバの名称

グローバルセッション情報を格納するSFOサーバの名称を指定します。SFOサーバの名称の設定に使用する初期化パラメタは，SFOServerNameパラメタです。

グローバルセッション情報を格納するSFOサーバは，Webアプリケーションが配置されているJ2EEサーバのグローバルセッション情報を格納するSFOサーバから選択します。

J2EEサーバのグローバルセッション情報を格納するSFOサーバは，Smart Composer機能の簡易構築定義ファイルのsfo-tierで定義します。グローバルセッション情報を格納するSFOサーバの設定については，「6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定」を参照してください。

ポイント

システム内に複数のSFOサーバを配置する場合，セッションフェイルオーバ機能を使用するWebアプリケーション単位に，SFOサーバを割り当てることをお勧めします。Webアプリケーション単位にSFOサーバを割り当てることにより，SFOサーバでの障害発生時の影響範囲を特定のJ2EEアプリケーションに限定させることができます。システム内に複数のSFOサーバを配置する場合の設定例を次の図に示します。

図9-15　システム内に複数のSFOサーバを配置する場合の設定例

(5)　グローバルセッションの制御方法

グローバルセッションの制御方法を指定します。グローバルセッションの制御方法の設定に使用する初期化パラメタは，GSessionControlパラメタです。

GSessionControlパラメタに指定した値に応じて，Webクライアントに対するグローバルセッションIDの送信方法，およびWebクライアントからのグローバルセッションIDの受信方法が決まります。

GSessionControlパラメタに指定できる値と意味を次の表に示します。

表9-18　GsessionControlパラメタの指定値と意味

指定値
意味

cookie
グローバルセッション情報の制御にHTTP Cookieを使用します。

url-rewriting
グローバルセッション情報の制御にURL書き換えを使用します。

both
グローバルセッション情報の制御にHTTP CookieおよびURL書き換えの両方を使用します。
WebクライアントがHTTP Cookieをサポートしているかどうかを判別して，必要に応じてHTTP Cookieによる制御とURL書き換えによる制御を切り替えます。

注意

Smart Composer機能で構築する，セッションフェイルオーバ機能を使用したシステムでは，HTTP Cookieによるグローバルセッション情報の制御に対応していますが，URL書き換えによるグローバルセッション情報の制御には対応していません。グローバルセッション情報の制御にURL書き換えを使用するシステムは，運用管理ポータル，またはファイル編集とコマンド実行で構築してください。運用管理ポータルの場合は，マニュアル「Cosminexus　運用管理操作ガイド」を，ファイル編集とコマンド実行の場合は，マニュアル「Cosminexus　リファレンス　定義編」およびマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(6)　グローバルセッションIDの送信に使用するCookieの名称

HTTP Cookieを使用してグローバルセッションを制御している場合，グローバルセッションIDは，HTTPレスポンスヘッダのSet-Cookieヘッダに設定されて，Webクライアント（ブラウザなど）に送信されます。

グローバルセッションIDを設定するCookieに任意の名称を指定します。Cookieの名称の設定に使用する初期化パラメタは，GIDCookieNameパラメタです。

Cookieの名称は，Webアプリケーション単位に指定できます。ただし，次に示すCookieの名称と同じ値を指定することはできません。

HTTPセッションのセッションIDの送信に使用するCookieの名称「JSESSIONID」

HTTPセッションを生成したリクエストのレスポンスに付加されるサーバIDのCookieの名称
HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する機能を有効にしている場合に確認が必要です。
この機能を有効にしているかどうか，および付加されるサーバIDのCookieの名称については，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，次のパラメタの値を参照してください。

webserver.container.server_id.enabled

webserver.container.server_id.name

なお，グローバルセッションIDの送信に使用するCookieの名称が，上記のCookieの名称と重複した場合，Webアプリケーションに定義したセッションフェイルオーバ用フィルタ（J2EE仕様で規定されたjavax.servlet.Filterインタフェースを実装したクラス）の開始処理でエラーとなり，Webアプリケーションを実行できません。

(7)　グローバルセッションIDの送信に使用するURLのパスパラメタ名

グローバルセッションIDの送信に使用するURLのパスパラメタ名を指定します。URLのパスパラメタ名の設定に使用する初期化パラメタは，GIDURLParamNameパラメタです。

GSessionControlパラメタに「cookie」を指定した場合，GIDURLParamNameパラメタに設定した値は無効になります。なお，GSessionControlパラメタに「cookie」を指定した場合，GIDURLParamNameパラメタに設定した値はチェックされません。このため，GIDURLParamNameパラメタに不正な値を設定した場合も，検出はされません。

注意

Webアプリケーション内で使用するURLのパスパラメタと同じ名称を，GIDURLParamNameパラメタで指定しないでください。指定した場合，セッションフェイルオーバ機能が正しく動作しません。

(8)　グローバルセッション情報のロック待ちタイムアウト

すでにロックされた状態のセッションに対して，別のJ2EEサーバからロック要求があった場合に，ロック解除待ちがタイムアウトになるまでの時間を設定します。グローバルセッション情報のロック待ちタイムアウトの設定に使用する初期化パラメタは，LockTimeoutパラメタです。

J2EEサーバからSFOサーバに対してグローバルセッション情報のロック取得要求をしたあとでJ2EEサーバに障害が発生して停止した場合，SFOサーバ上のグローバルセッション情報がロックされたままの状態になってしまうおそれがあります。グローバルセッション情報のロック待ちタイムアウト時間は，このような場合に，J2EEサーバに障害が発生したと判断するために使用される時間です。このタイムアウト時間を超えると，SFOサーバ上のロックは解除されます。

また，次のような場合にロックされたままの状態になったときにも，このタイムアウト時間が有効になります。これらの状態は，負荷分散機を利用している環境で発生することがあります。

ページにフレームを使用している場合など，同じセッションを使用するリクエストが同時に送信され，それぞれのリクエストが負荷分散機のスケジュール機能によって異なるJ2EEサーバに分散されて転送された場合

ユーザの操作によってリクエストが二重に送信された場合など，リクエストを送信して応答が返されるよりも前に次のリクエストを送信したときに，それぞれのリクエストが負荷分散機のスケジュール機能によって異なるJ2EEサーバに分散されて転送された場合

なお，クライアントから同時に実行されることが想定されるWebアプリケーションがある場合，その処理に要する時間を考慮して，グローバルセッション情報のロック待ちタイムアウト時間を指定してください。

(9)　byte型配列であるセッション情報の引き継ぎ許可

byte型配列であるセッション情報を引き継ぎ対象とするかどうかを指定します。

GSInfoTypeByteArrayEnableパラメタにtrueを指定した場合には，byte型配列のセッション情報は引き継ぎ対象となります。

GSInfoTypeByteArrayEnableパラメタにfalseを指定した場合には，byte型配列のセッション情報は引き継ぎ対象となりません。このため，byte型配列のセッション情報の場合は，グローバルセッション情報の更新時にエラーとなります。

(10)　直列化可能クラスのオブジェクトであるセッション情報の引き継ぎ許可

直列化可能クラスのオブジェクトであるセッション情報を引き継ぎ対象とするかどうかを指定します。

GSInfoTypeSerializableEnableパラメタにtrueを指定した場合には，直列化可能クラスのオブジェクトであるセッション情報は引き継ぎ対象となります。

GSInfoTypeSerializableEnableパラメタにfalseを指定した場合には，直列化可能クラスのオブジェクトであるセッション情報は引き継ぎ対象となりません。

(11)　属性ファイルの記述例

属性ファイルの記述例を示します。

(a)　統合ユーザ管理機能を使用しない場合

統合ユーザ管理機能を使用しない場合の属性ファイルの記述例を次に示します。この例は，HTTP Cookieを使用してグローバルセッションを制御し，byte型配列のセッション情報を引き継ぐ場合の例です。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name>
   <filter-class>com.hitachi.software.was.sfo.web.SFOFilter</filter-class>
   <init-param>
       <param-name>GSInfoKey-RW</param-name>
       <param-value>page</param-value>
   </init-param>

   <init-param>
       <param-name>GSInfoKey-R</param-name>
       <param-value>userId;roll</param-value>
   </init-param>

   <init-param>
       <param-name>GSInfosLengthMax</param-name>
       <param-value>44</param-value>
   </init-param>

   <init-param>
       <param-name>SFOServerName</param-name>
       <param-value>sfo_server1</param-value>
   </init-param>

   <init-param>
       <param-name>GSessionControl</param-name>
       <param-value>cookie</param-value>
   </init-param>

   <init-param>
       <param-name>GIDCookieName</param-name>
       <param-value>SFOSESSIONID</param-value>
   </init-param>

   <init-param>
       <param-name>LockTimeout</param-name>
       <param-value>180</param-value>
   </init-param>

   <init-param>
       <param-name>GSInfoTypeByteArrayEnable</param-name>
       <param-value>true</param-value>
   </init-param>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
   <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

この記述例で設定される内容は，次のとおりです。

書き換え可能なグローバルセッション情報として，「page」の値を格納します。

読み取り専用のグローバルセッション情報として，「UserID」および「Roll」の2種類の値を格納します。

グローバルセッション情報の最大サイズとして，49を設定します。
最大サイズは，次の式で算出します。なお，ここでは，page（4文字）の値は1～2文字のASCII文字列，UserID（6文字）の値は1～12バイトのbyte型配列，roll（4文字）の値は1～7文字のASCII文字列とします。
（4＋4＋6）+（2＋7＋（12＋5））＋（2×3-1）＋4＝49

グローバルセッション情報を格納するSFOサーバの名称は，「sfo_server1」とします。

グローバルセッションの制御には，HTTP Cookieを使用します。

グローバルセッションIDの送信に使用するCookieの名称は，「SFOSESSIONID」とします。

グローバルセッション情報のロック待ちタイムアウトは，「180秒」とします。

byte型配列のセッション情報を引き継ぐため，GSInfoTypeByteArrayEnableパラメタにtrueを指定します。

(b)　統合ユーザ管理機能を使用する場合

統合ユーザ管理機能を使用する場合の属性ファイルの記述例を次に示します。この例は，HTTP Cookieを使用してグローバルセッションを制御している場合の例です。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name>
   <filter-class>com.hitachi.software.was.sfo.web.SFOFilter</filter-class>
   <init-param>
       <param-name>GSInfoKey-RW</param-name>
       <param-value>com.cosminexus.admin.auth.user_data</param-value>
   </init-param>

   <init-param>
       <param-name>GSInfoKey-R</param-name>
       <param-value></param-value>
   </init-param>

   <init-param>
       <param-name>GSInfosLengthMax</param-name>
       <param-value>10380</param-value>
   </init-param>

   <init-param>
       <param-name>SFOServerName</param-name>
       <param-value>sfo_server1</param-value>
   </init-param>

   <init-param>
       <param-name>GSessionControl</param-name>
       <param-value>cookie</param-value>
   </init-param>

   <init-param>
       <param-name>GIDCookieName</param-name>
       <param-value>GSESSIONID</param-value>
   </init-param>

   <init-param>
       <param-name>LockTimeout</param-name>
       <param-value>30</param-value>
   </init-param>

   <init-param>
       <param-name>GSInfoTypeByteArrayEnable</param-name>
       <param-value>false</param-value>
   </init-param>

</filter>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
   <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

この記述例で設定される内容は，次のとおりです。

書き換え可能なグローバルセッション情報として，「com.cosminexus.admin.auth.user_data」の値を格納します。

グローバルセッション情報の最大サイズとして，10,380文字を設定します。
最大サイズは，次の式で算出します。
｛1,500＋(10＋20＋1,200）×3｝×2＝10,380
なお，ここでは，次の条件で最大サイズを算出しています。

APIを使用する。

パスワード保存機能は使用しない。

レルム名の長さ：10

ユーザ名の最大長：20

レルム数（シングルサインオンを使用するシステムの数）：3

グローバルセッション情報を格納するSFOサーバの名称は，「sfo_server1」とします。

グローバルセッションの制御には，HTTP Cookieを使用します。

グローバルセッションIDの送信に使用するCookieの名称は，「GSESSIONID」とします。

グローバルセッション情報のロック待ちタイムアウトは，「30」秒とします。

グローバルセッション情報として，byte型配列を使用しないため，GSInfoTypeByteArrayEnableパラメタにfalseを指定します。

9.7.3　HTTPレスポンス圧縮フィルタの設定

HTTPレスポンス圧縮フィルタを有効にするためには，次の設定が必要です。

HTTPレスポンス圧縮フィルタのWebアプリケーションへの組み込み
サーバ管理コマンドを使用した属性ファイルの編集，またはWebアプリケーションのDD（web.xml）の直接編集によって，HTTPレスポンス圧縮フィルタをWebアプリケーションに組み込みます。

ここでは，HTTPレスポンス圧縮フィルタのWebアプリケーションへの組み込みについて説明します。

HTTPレスポンス圧縮機能を使用する場合の前提条件や圧縮条件については，マニュアル「Cosminexus　機能解説」のフィルタリングによるHTTPレスポンスの圧縮に関する説明を参照してください。また，HTTPレスポンス圧縮機能を使用するWebアプリケーション開発時の留意事項については，マニュアル「Cosminexus　機能解説」のHTTPレスポンス圧縮フィルタを使用するアプリケーションの実装に関する説明を参照してください。

＜この項の構成＞

(1)　HTTPレスポンス圧縮フィルタのWebアプリケーションへの組み込み

(2)　注意事項

(3)　属性ファイルの記述例

(1)　HTTPレスポンス圧縮フィルタのWebアプリケーションへの組み込み

WebアプリケーションへのHTTPレスポンス圧縮フィルタの組み込みには，サーバ管理コマンドを使用した属性ファイルの編集による方法と，Server Plug-inを使用する方法と，WebアプリケーションのDD（web.xml）の直接編集による方法の3種類があります。ここでは，サーバ管理コマンドで属性ファイルを編集してフィルタを組み込む方法について説明します。Server Plug-inを使用したフィルタの組み込みについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，WebアプリケーションのDD（web.xml）の直接編集によるフィルタの組み込みについては，マニュアル「Cosminexus　機能解説」のHTTPレスポンス圧縮フィルタを使用するアプリケーションの実装に関する説明を参照してください。

WebアプリケーションにHTTPレスポンス圧縮フィルタを組み込むために，フィルタ属性ファイルおよびWAR属性ファイルに設定する内容を次の表に示します。なお，属性ファイルの取得，編集した属性ファイルの設定の手順については，「9.7.1(2)　built-inフィルタの組み込み手順」を参照してください。

表9-19　属性ファイルでの設定内容（HTTPレスポンス圧縮フィルタ）

設定項目
属性ファイル名
タグ名
設定内容

フィルタ定義
フィルタ属性ファイル
<filter-name>タグ
追加するフィルタ名称を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.web.ResponseCompressionFilter

<filter-class>タグ
追加するフィルタのクラス名を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.web.ResponseCompressionFilter

URLパターンとHTTPレスポンス圧縮規則のマッピング
<init-param>タグ内の<param-name>タグ，<param-value>タグ
URLパターンとHTTPレスポンス圧縮機能のマッピングを指定します。
詳細については，「(a)　URLパターンとHTTPレスポンス圧縮規則のマッピングについて」を参照してください。

HTTPレスポンス圧縮規則
HTTPレスポンスの圧縮規則として，圧縮規則名，Media-Typeと圧縮しきい値を指定します。
詳細については，「(b)　HTTPレスポンス圧縮規則について」を参照してください。

フィルタマッピング定義
WAR属性ファイル
<filter-mapping>タグ内の<filter-name>タグ
フィルタ名称を指定します。設定値は，固定値です。

設定値（固定値）

com.hitachi.software.was.web.ResponseCompressionFilter

<filter-mapping>タグ内の<url-pattern>タグ
URLパターンやサーブレットクラスと，HTTPレスポンス圧縮フィルタのマッピングを指定します。HTTPレスポンス圧縮機能は，フィルタマッピング定義によって，マッピングされたURLパターンを持つリソースに対してリクエストがあった場合だけ有効となります。
設定値は，任意です。

(a)　URLパターンとHTTPレスポンス圧縮規則のマッピングについて

HTTPレスポンス圧縮機能が有効となるURLパターンと，指定したURLパターンに適用するHTTPレスポンス圧縮規則のマッピングを指定します。

URLパターンとHTTPレスポンス圧縮規則のマッピングは，フィルタ属性ファイルの<init-param>タグで定義します。初期化パラメタの名前（<param-name>タグ）には，「url-mapping」を指定します。また，初期化パラメタの値（<param-value>タグ）には，URLパターンとHTTPレスポンス圧縮機能のマッピングを指定します。デフォルトの設定では，URLパターン「/*」にデフォルトのレスポンス圧縮規則がマッピングされます。

パラメタ指定時の規則を示します。

URLパターンは，大文字と小文字が区別されます。

HTTPレスポンス圧縮規則名は，大文字と小文字が区別されます。

URLパターンとHTTPレスポンス圧縮規則名は，半角のイコール（=）で区切ります。

複数指定する場合は，半角のセミコロン（;）で区切ります。

複数のURLパターンに該当する場合は，先に指定したものが使用されます。

パラメタ値の改行，タブ，スペースは無視されます。

パラメタ値の末尾にある半角のセミコロン（;）は無視されます。

url-mappingパラメタに定義するURLパターンは，パス一致，拡張子一致，および完全一致のマッピング規則が適用されます。それぞれのマッピング規則を次に示します。

パス一致
URLパターンとして「/」で始まり「/*」で終わる文字列を指定した場合は，リクエストURLのコンテキストルートからの相対パスがURLパターンの「*」を除く文字列で始まっているときに一致します。また，URLパターンとして「/*」を指定した場合は，すべてのリクエストURLが一致します。

（例）

URLパターンが「/jsp/*」で，リクエストURLのコンテキストルートからの相対パスが「/jsp/index.jsp」の場合に一致します。

拡張子一致
URLパターンとして「*.」で始まる文字列を指定した場合は，リクエストURLの拡張子とURLパターンの「*.」に続く文字列が同じときに一致します。

（例）

URLパターンが「*.jsp」で，リクエストURLのコンテキストルートからの相対パスが「/jsp/index.jsp」の場合に一致します。

完全一致
URLパターンとして「/」で始まる上記以外の文字列を指定した場合は，リクエストURLのコンテキストルートからの相対パスがこのURLパターンと完全に同じときに一致します。

（例）

URLパターンが「/jsp/index.jsp」で，リクエストURLのコンテキストルートからの相対パスが「/ jsp/index.jsp」の場合に一致します。

(b)　HTTPレスポンス圧縮規則について

レスポンス圧縮規則が有効となるURLパターンに適用するレスポンス圧縮規則を設定します。

レスポンス圧縮規則は，フィルタ属性ファイルの<init-param>タグで定義します。初期化パラメタの名前（<param-name>タグ）には，圧縮規則名を指定します。また，初期化パラメタの値（<param-value>タグ）には，圧縮するHTTPレスポンスのMedia-Typeと圧縮しきい値を指定します。

Media-Type

HTTPレスポンス圧縮機能では，条件として指定したMedia-TypeがHTTPレスポンスに含まれる場合に，HTTPレスポンスを圧縮します。

圧縮しきい値

圧縮しきい値とは，HTTPレスポンスボディのサイズによって，HTTPレスポンスを圧縮するかどうかを判定するためのしきい値です。HTTPレスポンス圧縮機能では，HTTPレスポンスボディのサイズが圧縮しきい値に定義したサイズを超える場合に，HTTPレスポンスを圧縮します。

圧縮しきい値を定義することで，HTTPレスポンスのサイズが小さい場合に，HTTPレスポンスの圧縮に掛かる時間が，通信に掛かる時間よりも大きくならないようにします。

圧縮しきい値は，圧縮するリソースの種別と通信回線の速度によって適切なサイズが決まるので，圧縮しきい値に定義するサイズは実測で求め，適切なサイズを定義することをお勧めします。圧縮しきい値は，100から2,147,483,647までの整数値で指定します。デフォルトの設定では，すべてのMedia-Typeに対して圧縮しきい値「100」が適用されます。

パラメタ指定時の規則を示します。

Media-Typeにアスタリスク（*）を指定した場合は，すべてのMedia-Typeを表します。ただし，Media-Typeごとの指定がある場合は，Media-Typeごとの指定が優先されます。

Media-Typeは，大文字と小文字が区別されません。

Media-Typeと圧縮しきい値は，半角のコロン（:）で区切ります。

複数指定する場合は半角のセミコロン（;）で区切ります。

同じMedia-Typeを複数指定した場合はあとに指定したものが使用されます。

パラメタ値の改行・タブ・スペースは無視されます。

パラメタ値の末尾にある半角のセミコロン（;）は無視されます。

(2)　注意事項

HTTPレスポンス圧縮フィルタの設定時の注意事項を次に示します。

レスポンス圧縮用フィルタの初期化時に，フィルタ属性ファイルに定義された初期化パラメタの妥当性をチェックします。ここで初期化パラメタに定義された値に問題がある場合は，フィルタの初期化処理でエラーとなり，Webアプリケーションは開始しません。

リクエストURLがurl-mappingパラメタに指定したURLパターンに一致しても，レスポンス圧縮用フィルタがマッピングされているURLパターンに一致しない場合は，url-mappingパラメタに指定したレスポンス圧縮規則が適用されることはありません。

レスポンス圧縮フィルタに複数のURLパターンをマッピングする場合は，リクエストURLが同時に複数のURLパターンに一致しないようにフィルタマッピングの定義を記述する必要があります。複数のURLパターンに対して異なるレスポンス圧縮機能を設定する場合は，url-mappingパラメタに複数のURLパターンを指定してください。

セッションフェイルオーバ機能を使用している場合は，セッションフェイルオーバ用フィルタのフィルタマッピングの定義よりも下にレスポンス圧縮フィルタのフィルタマッピングの定義を記述してください。

WebアプリケーションのバージョンがServlet2.4の場合，<filter-mapping>タグの要素，および<dispatcher>タグは指定しないでください。また，<dispatcher>タグで「FORWARD」，「INCLUDE」，「ERROR」を指定した場合，Webアプリケーションの開始時にエラーが発生し，アプリケーションが開始できないので，注意してください。

(3)　属性ファイルの記述例

次に示すそれぞれの場合を例に，属性ファイルの記述例を示します。

HTTPレスポンスのボディサイズで圧縮条件を指定する場合

URLパターンで圧縮条件を指定する場合

HTTPレスポンスのMedia-Typeで圧縮条件を指定する場合

圧縮条件を組み合わせて指定する場合

(a)　HTTPレスポンスのボディサイズで圧縮条件を指定する場合

HTTPレスポンスのボディサイズで圧縮条件を指定する場合の記述例を示します。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <filter-class>com.hitachi.software.was.web.ResponseCompressionFilter</filter-class>
   <init-param>
       <param-name>url-mapping</param-name>
       <param-value>
        /*=rule1;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule1</param-name>
       <param-value>
        *:1000;
       </param-value>
   </init-param>
</filter>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

記述例では，URLパターンが「/*」のアクセスに対するHTTPレスポンスで，ボディサイズが1,000バイトを超えるものを圧縮します。

(b)　URLパターンで圧縮条件を指定する場合

URLパターンで圧縮条件を指定する場合の定義例を示します。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <filter-class>com.hitachi.software.was.web.ResponseCompressionFilter</filter-class>
   <init-param>
       <param-name>url-mapping</param-name>
       <param-value>
        /app/dir/*=rule1;
        *.html=rule1;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule1</param-name>
       <param-value>
        *:100;
       </param-value>
   </init-param>
</filter>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
  <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <url-pattern>/app/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

記述例では，URLパターンが「/app/*」のアクセスに対するHTTPレスポンスで次の条件を満たすものを圧縮します。

HTTPリクエストのURLパターンが「/app/dir/*」で，ボディサイズが100バイトを超えるHTTPレスポンス

HTTPリクエストのURLパターンが「*.html」で，ボディサイズが100バイトを超えるHTTPレスポンス

(c)　HTTPレスポンスのMedia-Typeで圧縮条件を指定する場合

HTTPレスポンスのMedia-Typeで圧縮条件を指定する場合の定義例を示します。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <filter-class>com.hitachi.software.was.web.ResponseCompressionFilter</filter-class>
   <init-param>
       <param-name>url-mapping</param-name>
       <param-value>
        /*=rule1;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule1</param-name>
       <param-value>
        text/html:500;
        application/pdf:1000;
       </param-value>
   </init-param>
</filter>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

記述例はURLパターンが「/*」のアクセスに対するHTTPレスポンスで次の条件を満たすものを圧縮します。

Media-Typeが「text/html」でボディサイズが500バイトを超えるHTTPレスポンス

Media-Typeが「application/pdf」でボディサイズが1,000バイトを超えるHTTPレスポンス

(d)　圧縮条件を組み合わせて指定する場合

次に示す例のように，圧縮条件を組み合わせて定義することもできます。

フィルタ属性ファイルの記述例

　　 （省略）
　　　　：
<filter>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <filter-class>com.hitachi.software.was.web.ResponseCompressionFilter</filter-class>
   <init-param>
       <param-name>url-mapping</param-name>
       <param-value>
        /app/dir1/*=rule1;
        /app/dir2/*=rule2;
        *.html=rule3;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule1</param-name>
       <param-value>
        *:500;
        application/pdf:1000;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule2</param-name>
       <param-value>
        application/pdf:2000;
       </param-value>
   </init-param>
   <init-param>
       <param-name>rule3</param-name>
       <param-value>
        *:100;
       </param-value>
   </init-param>
</filter>
　　　　：
　　 （省略）

WAR属性ファイルの記述例

　　 （省略）
　　　　：
<filter-mapping>
   <filter-name>com.hitachi.software.was.web.ResponseCompressionFilter</filter-name>
   <url-pattern>/app/*</url-pattern>
</filter-mapping>
　　　　：
　　 （省略）

定義例では，URLパターンが「/app/*」のアクセスに対するHTTPレスポンスで次の条件を満たすものを圧縮します。

HTTPリクエストのURLパターンが「/app/dir1/*」でMedia-Typeが「application/pdf」以外，ボディサイズが500バイトを超えるHTTPレスポンス

HTTPリクエストのURLパターンが「/app/dir1/*」でMedia-Typeが「application/pdf」，ボディサイズが1,000バイトを超えるHTTPレスポンス

HTTPリクエストのURLパターンが「/app/dir2/*」でMedia-Typeが「application/pdf」，ボディサイズが2,000バイトを超えるHTTPレスポンス

HTTPリクエストのURLパターンが「*.html」でボディサイズが100バイトを超えるHTTPレスポンス

9.8　リソースまたはJ2EEアプリケーションの別名の設定

この節では，リソースまたはJ2EEアプリケーションの別名の設定について説明します。

＜この節の構成＞

9.8.1　リソースの別名の設定

9.8.2　J2EEアプリケーションに含まれるEnterprise Beanの別名の設定

9.8.1　リソースの別名の設定

別名は，サーバ管理コマンドを使用して設定します。設定に使用するコマンドおよび属性ファイルは，リソースの種別ごとに異なります。

リソースの種別と別名を設定するコマンドおよび属性ファイルを次の表に示します。

表9-20　リソースの種別と別名を設定するコマンドおよび属性ファイル

リソースの種別 | コマンド | 属性ファイル | 指定するタグ
リソースアダプタ | cjsetrarpropコマンド | Connector属性ファイル | <resource-external-property>－<optional-name>タグ
メールコンフィグレーション | cjsetrespropコマンド | メール属性ファイル
JavaBeansリソース | cjsetjbpropコマンド | JavaBeansリソース属性ファイル | <resource-env-external-property>－<optional-name>タグ

属性ファイルでの別名の指定例を次に示します。この例は，Connector属性ファイルを使用して，リソースアダプタに別名を設定する場合の例です。

<hitachi-connector-property>
 <description></description>
 <display-name>DB_Connector_for_Oracle</display-name>
 <icon />
 <vendor-name>Hitachi, Ltd.</vendor-name>
 :
 <runtime>
   <resource-external-property>
   <description></description>
   <optional-name>jdbc/TestDB1</optional-name>
   <res-auth>Container</res-auth>
   <res-sharing-scope>Shareable</res-sharing-scope>
   </resource-external-property>
 </runtime>
</hitachi-connector-property>

この例の場合は，DB Connectorの別名として「jdbc/TestDB1」が設定されます。

9.8.2　J2EEアプリケーションに含まれるEnterprise Beanの別名の設定

別名は，サーバ管理コマンド（cjsetapppropコマンド）を使用して設定します。設定に使用する属性ファイルは，Enterprise Beanの種別ごとに異なります。リモートインタフェースに対する別名は，属性ファイルの<optional-name>タグに指定します。ローカルインタフェースに対する別名は，属性ファイルの<local-optional-name>タグに指定します。

属性ファイルでの別名の指定例を次に示します。この例は，SessionBean属性ファイルを使用して，Stateful Session Beanに別名を設定する場合の例です。

<hitachi-session-bean-property>
 <display-name>MyAdder</display-name>
 <session-type>Stateful</session-type>
 <transaction-type>Container</transaction-type>
 <runtime>
   <lookup-name>MyAdder</lookup-name>
   <optional-name>user/Adder</optional-name>
   <local-optional-name>user/localAdder</local-optional-name>
   <maximum-sessions>0</maximum-sessions>
   <stateful>
     <maximum-active-sessions>0</maximum-active-sessions>
     <inactivity-timeout>0</inactivity-timeout>

<removal-timeout>0</removal-timeout>

この例の場合は，リモートインタフェースの別名として「user/Adder」，ローカルインタフェースの別名として「user/localAdder」が設定されます。

参考

Enterprise Beanの別名は，アノテーションで設定することもできます。アノテーションによって別名が設定されている場合に，サーバ管理コマンドで異なる別名を設定すると，サーバ管理コマンドで設定した値が有効になります。

詳細は，マニュアル「Cosminexus　機能解説」の別名の設定方法に関する説明を参照してください。

9.9　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定

この節では，メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定について説明します。メッセージインフローは，Connector 1.5仕様に準拠したリソースアダプタを使用する場合に実行できます。

＜この節の構成＞

9.9.1　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定の流れ

9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容

9.9.3　属性ファイルの指定例

9.9.1　メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定の流れ

ここでは，メッセージインフローを実行する場合のリソースアダプタとJ2EEアプリケーションの設定の流れについて説明します。設定の流れは，リソースアダプタをJ2EEサーバに直接デプロイして使用するか，J2EEアプリケーションに含めて使用するかによって異なります。

＜この項の構成＞

(1)　リソースアダプタをJ2EEサーバに直接デプロイして使用する場合

(2)　リソースアダプタをJ2EEアプリケーションに含めて使用する場合

(1)　リソースアダプタをJ2EEサーバに直接デプロイして使用する場合

リソースアダプタをJ2EEサーバに直接デプロイして使用する場合の設定の流れを次の図に示します。

図9-16　リソースアダプタをJ2EEサーバに直接デプロイして使用する場合の設定の流れ

図中の1.～5.について説明します。ここでは，サーバ管理コマンドによる操作を示します。

Connector 1.5仕様に準拠したリソースアダプタをインポートします。
cjimportresコマンドに-type rarを指定して実行します。

リソースアダプタをデプロイします。
cjdeployrarコマンドを実行します。

リソースアダプタのプロパティを定義します。
cjgetrarpropコマンドでConnector属性ファイルを取得します。ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。
ここでは，管理対象オブジェクトを設定します。設定内容については，「9.9.2(1) 管理対象オブジェクトの設定」を参照してください。

Message-driven Beanを含むJ2EEアプリケーションをインポートします。
cjimportappコマンドを使用します。

J2EEアプリケーションのプロパティを定義します。
cjgetapppropコマンドに-type allを指定して実行し，アプリケーション統合属性ファイルを取得します。ファイル編集後に，cjsetapppropコマンドに-type allを指定して実行し，編集内容を反映させます。
ここでは，次の項目を設定します。

Message-driven Beanとリソースアダプタの対応づけ
設定内容については「9.9.2(2) Message-driven Beanとリソースアダプタの対応づけの設定」を参照してください。

Message-driven Beanが使用するインタフェース
設定内容については「9.9.2(3) Message-driven Beanが使用するインタフェースの設定」を参照してください。

ActivationSpecの設定
設定内容については「9.9.2(4) ActivationSpecの設定」を参照してください。

(2)　リソースアダプタをJ2EEアプリケーションに含めて使用する場合

リソースアダプタをJ2EEアプリケーションに含めて使用する場合の設定の流れを次の図に示します。

図9-17　リソースアダプタをJ2EEアプリケーションに含めて使用する場合の設定の流れ

図中の1.～2.について説明します。なお，ここでは，サーバ管理コマンドによる操作を示します。

Message-driven Beanを含むJ2EEアプリケーションをインポートします。
cjimportappコマンドを使用します。

J2EEアプリケーションのプロパティを定義します。
cjgetapppropコマンドに-type allを指定して実行し，アプリケーション統合属性ファイルを取得します。ファイル編集後に，cjsetapppropコマンドに-type allを指定して実行し，編集内容を反映させます。
ここでは，次の項目を設定します。

管理対象オブジェクトの情報
設定内容については「9.9.2(1) 管理対象オブジェクトの設定」を参照してください。

Message-driven Beanとリソースアダプタの対応づけ
設定内容については「9.9.2(2) Message-driven Beanとリソースアダプタの対応づけの設定」を参照してください。

Message-driven Beanが使用するインタフェース
設定内容については「9.9.2(3) Message-driven Beanが使用するインタフェースの設定」を参照してください。

ActivationSpecの設定
設定内容については「9.9.2(4) ActivationSpecの設定」を参照してください。

9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容

リソースアダプタとJ2EEアプリケーションでの設定内容について説明します。

設定は，それぞれConnector属性ファイルとアプリケーション統合属性ファイル※に指定します。

注※

この項の説明は，すべてアプリケーション統合属性ファイルを使用する場合の説明です。cjgetapppropコマンドでMessage-driven Bean属性ファイルを取得した場合は，Message-driven Bean属性ファイルに指定できます。Message-driven Bean属性ファイルを使用する場合は，「アプリケーション統合属性ファイルの<hitachi-connector-property>タグ下」を「Message-driven Bean属性ファイル」に読み替えてください。

＜この項の構成＞

(1)　管理対象オブジェクトの設定

(2)　Message-driven Beanとリソースアダプタの対応づけの設定

(3)　Message-driven Beanが使用するインタフェースの設定

(4)　ActivationSpecの設定

(1)　管理対象オブジェクトの設定

メッセージインフローで使用する管理対象オブジェクトの設定は，Connector属性ファイルに記述します。

管理対象オブジェクトに設定する内容は，リソースアダプタに依存します。使用するリソースアダプタのドキュメントを参照してください。

管理対象オブジェクトは，Message-driven Beanと対応づけて使用します。対応づけについては，「(4) ActivationSpecの設定」を参照してください。

(2)　Message-driven Beanとリソースアダプタの対応づけの設定

Message-driven Beanとリソースアダプタの対応づけは，アプリケーション統合属性ファイルの<resource-adapter>タグに指定します。リソースアダプタの表示名を指定してください。

<resource-adapter>の階層を次に示します。

<hitachi-message-bean-property>
 <message-ref>
   <connection-destination>
     <resource-adapter>

これらのタグは，DD（ejb-jar.xml）には存在しない要素です。ただし，<hitachi-message-bean-property>はDDの<message-driven>に対応します。

リソースアダプタとの対応づけは，Message-driven Beanを含むJ2EEアプリケーションを開始したときに実行されます。なお，次の場合には，Message-driven Beanを含むJ2EEアプリケーションの開始が失敗します。この場合は，KDJE42359-Eのメッセージが出力されます。

<resource-adapter>タグにリソースアダプタの表示名が指定されていない場合

<resource-adapter>タグに指定した表示名のリソースアダプタが開始されていない場合

<resource-adapter>タグに指定した表示名のリソースアダプタが見つからない場合

Message-driven Beanは，管理対象オブジェクトとも対応づける必要があります。対応づけについては，「(4) ActivationSpecの設定」を参照してください。

参考

Cosminexusでは，<message-driven>－<message-destination-link>タグの情報は指定できません。

(3)　Message-driven Beanが使用するインタフェースの設定

Message-driven Beanが使用するインタフェースは，アプリケーション統合属性ファイルの<messaging-type>タグに記述します。Message-driven Beanが実装するインタフェース名を指定してください。

<messaging-type>の階層を次に示します。

<hitachi-message-bean-property>
 <messaging-type>

<hitachi-message-bean-property>はDD（ejb-jar.xml）の<message-driven>に対応します。

Message-driven Beanが使用するインタフェースには，リソースアダプタがサポートしているインタフェースを指定する必要があります。リソースアダプタがサポートするインタフェースは，リソースアダプタのDD（ra.xml）の<messagelistener-type>タグに指定されています。このタグに指定されている以外のインタフェースを指定した場合は，Message-driven Beanを含むJ2EEアプリケーションの起動が失敗します。この場合は，KDJE43167-Eのメッセージが出力されます。

リソースアダプタがサポートしているインタフェースは，サーバ管理コマンドの次のコマンドでも確認できます。これらのコマンドの引数に，-resnameおよび-inboundを指定して実行してください。

cjlistresコマンド

cjlistrarコマンド

cjlistappコマンド

サーバ管理コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

なお，<messaging-type>タグの指定を省略した場合は，デフォルト値としてjavax.jms.MessageListenerインタフェースが使用されます。

参考

javax.jms.MessageListenerインタフェースは，EJB2.0まで固有のメッセージリスナインタフェースとして使用されていたインタフェースです。

(4)　ActivationSpecの設定

ActivationSpecとは，Message-driven Beanを活性化するために必要な設定を持つJavaBeansです。ActivationSpecには，リソースアダプタの設定に合わせて設定が必要なプロパティがあります。

(a)　ActivationSpecの設定の概要

ActivationSpecに設定する値は，アプリケーション統合属性ファイルの<activation-config>タグ下に記述します。プロパティ名とプロパティ値を指定してください。複数指定できます。

<activation-config>の階層を次に示します。

<hitachi-message-bean-property>
 <activation-config>
   <activation-config-property>
     <activation-config-property-name>
     <activation-config-property-value>

ActivationSpecについてのデフォルトの設定値は，リソースアダプタのDD（ra.xml）に設定できます。<resourceadapter>－<config-property>タグに設定した値が，デフォルト値として使用されます。デフォルト値を記載している場合にアプリケーション統合属性ファイルでActivationSpecの値を設定したときには，<hitachi-message-bean-property>タグ下で指定した値で上書きされます。

ActivationSpecのプロパティとして必ず設定しなくてはいけないプロパティについては，「(b) 設定が必要なプロパティ」で説明します。

(b)　設定が必要なプロパティ

ActivationSpecの設定では，リソースアダプタのDD（ra.xml）の<activationspec>－<required-config-property>タグに指定されているプロパティの値を設定する必要があります。設定が必要なプロパティは，サーバ管理コマンドの次のコマンドでも確認できます。これらのコマンドの引数に，-resnameおよび-listenertypeを指定して実行してください。

cjlistresコマンド

cjlistrarコマンド

cjlistappコマンド

このほか，ActivationSpecに設定できるプロパティはリソースアダプタに依存します。使用するリソースアダプタのドキュメントを参照してください。

(c)　JMSをサポートするメッセージリスナを使用する場合に設定が必要なプロパティ

JMSをサポートするメッセージリスナ（javax.jms.MessageListenerインタフェースを使用するメッセージリスナ）を使用する場合，ActivationSpecに次のプロパティが必要です。<activation-config>タグ下に指定してください。

destination

destinationType

なお，Cosminexusでは，これらのプロパティが指定されているかどうかのチェックは実施されません。プロパティ設定が適切かどうかは，リソースアダプタが提供するActivationSpec#validateメソッドで確認してください。

参考

EJB 2.0で<message-driven>タグ下の要素として指定していた次の項目は，EJB 2.1では削除されています。

<message-selector>

<acknowledge-mode>

<message-driven-destination>－<subscription-durability>

Connector 1.5仕様では，これらの要素を<activation-config>下のプロパティとして指定できることが推奨されています。ただし，指定できるかどうかは使用するリソースアダプタに依存します。

JMSをサポートするメッセージリスナを使用する場合のActivationSpec仕様の詳細については，Connector 1.5仕様のドキュメントを参照してください。

(d)　ActivationSpecの生成・設定で発生するエラー

ActivationSpecを生成，設定するときに，次の表に示す状態になった場合，エラーが発生します。エラーが発生すると，J2EEアプリケーションの開始は失敗します。

エラーが発生する場合と出力されるメッセージを次の表に示します。

表9-21　エラーが発生する場合と出力されるメッセージの対応

エラーが発生する場合 | 出力されるメッセージ
ActivationSpecの実装クラスのインスタンス生成に失敗した場合 | KDJE43168-E
ActivationSpecに指定したクラスがjavax.resource.spi.ActivationSpecインタフェースを実装していなかった場合 | KDJE43172-E
<activation-config-property-name>タグに対応するプロパティのsetterメソッドが，ActivationSpecにない場合 | KDJE43169-E
ActivationSpecに各プロパティを設定したあとで，設定が適切であるかをチェックするメソッド(ActivationSpec#validateメソッド)の呼び出しで例外がスローされた場合 | KDJE43170-E
リソースアダプタのDD（ra.xml）で指定したプロパティ<required-config-property>タグに対応する設定項目が，アプリケーション統合属性ファイルの<activation-config>タグとして記述されていない場合 | KDJE43171-E
ActivationSpecのsetResourceAdapterメソッドで例外がスローされた場合※ | KDJE43173-E

注※　setResourceAdapterメソッドはjavax.resource.spi.ResourceAdapterAssociationインタフェースで定義するメソッドです。javax.resource.spi.ResourceAdapterAssociationインタフェースは，javax.resource.spi.ActivationSpecインタフェースのスーパーインタフェースです。

9.9.3　属性ファイルの指定例

ここでは，メッセージインフローを実行する場合の属性ファイルの指定方法について，例を使用して説明します。

Connector属性ファイルとアプリケーション統合属性ファイルでは，次の図に示す個所の設定を合わせる必要があります。

図9-18　Connector属性ファイルとアプリケーション統合属性ファイルで同じ値を指定する個所

それぞれの指定内容は次のとおりです。

aには，Message-driven Beanが使用するインタフェースを指定します。

bには，ActivationSpecと管理対象オブジェクトの対応づけを指定します。

cには，Message-driven Beanとリソースアダプタの対応づけを指定します。

以降，a～cに指定する内容を中心に説明します。

＜この項の構成＞

(1)　javax.jms.MessageListenerインタフェースを使用したMessage-driven Beanおよびリソースアダプタの場合

(2)　任意のメッセージリスナインタフェースを使用したMessage-driven Beanおよびリソースアダプタの場合

(1)　javax.jms.MessageListenerインタフェースを使用したMessage-driven Beanおよびリソースアダプタの場合

メッセージリスナのインタフェースとしてjavax.jms.MessageListenerインタフェースを使用する場合の属性ファイルの指定例を示します。

ここでは，次の図に示す構成を例にして説明します。JMSに対応した二つのMessage-driven Beanが，それぞれ別の管理オブジェクト（javax.jms.Queue）からメッセージを受信する例です。

図9-19　javax.jms.MessageListenerインタフェースを使用したMessage-driven Beanおよびリソースアダプタの構成例

アプリケーション統合属性ファイルの指定例を次に示します。

図9-20　アプリケーション統合属性ファイルの指定例（javax.jms.MessageListenerインタフェースを使用する場合）

図の説明：

図中の(2)～(4)は，「9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容」での説明の項番と対応しています。また，a，b-1，b-2，cは，それぞれ次の設定を示します。

a：Message-driven Beanが使用するインタフェース

b-1，b-2：ActivationSpecと管理対象オブジェクトの対応づけ

c：Message-driven Beanとリソースアダプタの対応づけ

なお，a，b-1，b-2，cの設定値は，図9-21と対応しています。

Connector属性ファイルの指定例を次の図に示します。

図9-21　Connector属性ファイルの指定例（javax.jms.MessageListenerインタフェースを使用する場合）

図の説明：

図中の(1)～(3)は，「9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容」での説明の項番と対応しています。また，a，b-1，b-2，cは，それぞれ次の設定を示します。

a：Message-driven Beanが使用するインタフェース

b-1，b-2：ActivationSpecと管理対象オブジェクトの対応づけ

c：Message-driven Beanとリソースアダプタの対応づけ

なお，a，b-1，b-2，cの設定値は，図9-20と対応しています。

(2)　任意のメッセージリスナインタフェースを使用したMessage-driven Beanおよびリソースアダプタの場合

メッセージリスナのインタフェースとして任意のインタフェースを使用する場合の属性ファイルの指定例を示します。

ここでは，次の図に示す構成を例にして説明します。

図9-22　任意のメッセージリスナインタフェースを使用したMessage-driven Beanおよびリソースアダプタの構成例

この例では，リソースアダプタが次に示す二つの独自のインタフェースに対応しています。

examples.Listener1は管理対象オブジェクトと独立して使用するメッセージリスナインタフェースです。

examples.Listener2は管理対象オブジェクトと関連づけて使用するメッセージリスナインタフェースです。

アプリケーション統合属性ファイルの指定例を次の図に示します。

図9-23　アプリケーション統合属性ファイルの指定例（任意のメッセージリスナインタフェースを使用する場合）

図の説明：

図中の(2)～(4)は，「9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容」での説明の項番と対応しています。また，a-1，a-2，b，cは，それぞれ次の設定を示します。

a-1，a-2：Message-driven Beanが使用するインタフェース

b：ActivationSpecと管理対象オブジェクトの対応づけ

c：Message-driven Beanとリソースアダプタの対応づけ

なお，a-1，a-2，b，cの設定値は，図9-24と対応しています。

Connector属性ファイルの指定例を次の図に示します。

図9-24　Connector属性ファイルの指定例（任意のメッセージリスナインタフェースを使用する場合）

図の説明：

図中の(1)～(3)は，「9.9.2　リソースアダプタとJ2EEアプリケーションでの設定内容」での説明の項番と対応しています。また，a-1，a-2，b，cは，それぞれ次の設定を示します。

a-1，a-2：Message-driven Beanが使用するインタフェース

b：ActivationSpecと管理対象オブジェクトの対応づけ

c：Message-driven Beanとリソースアダプタの対応づけ

なお，a-1，a-2，b，cの設定値は，図9-23と対応しています。

10.　統合ユーザ管理機能の設定（J2EEアプリケーションを実行するシステム）

この章では，統合ユーザ管理機能の設定について説明します。統合ユーザ管理機能を使用しない場合は，この設定は不要です。

＜この章の構成＞

10.1　統合ユーザ管理機能の設定手順

10.2　レルム名の決定

10.3　LDAPディレクトリサーバの設定

10.4　ユーザ情報の登録

10.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）

10.6　ユーザ情報の登録（シングルサインオンを使用する場合）

10.7　コンフィグレーションファイルの作成

10.8　JavaVMのプロパティの設定

10.9　ファイルのデプロイ

10.1　統合ユーザ管理機能の設定手順

この節では，統合ユーザ管理機能の設定手順について説明します。

Cosminexusでは，Cosminexusで構築したシステムにログインするユーザを統合管理できます。統合ユーザ管理では，それぞれのJ2EEアプリケーションが管理しているユーザの情報が関連づけて管理され，一度のログイン処理でさまざまなJ2EEアプリケーションにログインできるようになります。統合ユーザ管理機能を使用する場合は，ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定する必要があります。

なお，統合ユーザ管理機能を使用するためには，J2EEアプリケーションの開発時に，JAASのAPIおよびCosminexusが提供している統合ユーザ管理API，ならびにJSPタグライブラリを使用して，標準ログインモジュールを呼び出す認証処理プログラムを作成しておく必要があります。また，それぞれのアプリケーションで独自の認証処理をする場合は，カスタムログインモジュールを作成する必要があります。作成方法については，マニュアル「Cosminexus　機能解説」のカスタムログインモジュールの実装に関する説明を参照してください。

統合ユーザ管理機能の設定手順を次の図に示します。

図10-1　統合ユーザ管理機能の設定手順

図中の1.～9.について説明します。

ユーザ管理方法を検討し，同一の認証ポリシーを適用する範囲（レルム）を決定します。
ユーザを管理する単位を検討し，対応するレルム名を決定します。レルム名の決定については，「10.2　レルム名の決定」を参照してください。

LDAPディレクトリサーバを設定します。
シングルサインオンを使用する場合には，シングルサインオン用のユーザ情報をLDAPディレクトリサーバで管理しますので，LDAPディレクトリサーバが必要です。LDAPディレクトリサーバの設定については，「10.3　LDAPディレクトリサーバの設定」を参照してください。
シングルサインオンを使用しないでRDB（HiRDBやOracleなど）の提供するユーザ認証だけを使用する場合は，この手順は不要です。

ユーザ認証に使用するユーザ情報をLDAPディレクトリサーバ，またはRDBに登録します。
LDAPディレクトリサーバへのユーザ情報の登録については，「10.4　ユーザ情報の登録」を参照してください。なお，Cosminexusでは，LDAPディレクトリサーバに格納するユーザ管理リポジトリの標準的なDIT構造を規定しています。リポジトリの構造については，マニュアル「Cosminexus　機能解説」の統合ユーザ管理で使用するユーザ情報の管理方法に関する説明を参照してください。
RDBへのユーザ情報の登録については，使用しているRDBのマニュアルを参照してください。

シングルサインオンを使用する場合で，シングルサインオン用のユーザ情報を暗号化したいときは，ユーザ情報を暗号化または復号化するための暗号鍵ファイルを作成します。
暗号鍵ファイルの作成については，「10.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）」を参照してください。
シングルサインオンを使用しない場合，またはユーザ情報を暗号化しない場合，この手順は不要です。

シングルサインオンを使用する場合は，シングルサインオン用のユーザ情報をLDAPディレクトリサーバに登録します。
LDAPディレクトリサーバへのシングルサインオン用のユーザ情報の登録については，「10.6　ユーザ情報の登録（シングルサインオンを使用する場合）」を参照してください。なお，Cosminexusでは，LDAPディレクトリサーバに格納するシングルサインオン用のユーザ管理リポジトリの標準的なDIT構造を規定しています。リポジトリの構造については，マニュアル「Cosminexus　機能解説」の統合ユーザ管理で使用するユーザ情報の管理方法に関する説明を参照してください。
シングルサインオンを使用しない場合，この手順は不要です。

コンフィグレーションファイルを作成します。
作成するファイルは，次の2種類です。

jaas.conf（JAASのコンフィグレーションファイル）

ua.conf（統合ユーザ管理のコンフィグレーションファイル）

コンフィグレーションファイルの作成については，「10.7　コンフィグレーションファイルの作成」を参照してください。

JavaVMのプロパティを設定します。
JavaVMのプロパティの設定については，「10.8　JavaVMのプロパティの設定」を参照してください。

統合ユーザ管理で使用するEARファイルをデプロイします。
ファイルのデプロイについては，「10.9　ファイルのデプロイ」を参照してください。

必要に応じて，統合ユーザ管理で使用する情報のバックアップを取ります。
LDAPディレクトリサーバのリポジトリのバックアップとリストアは，LDAPディレクトリサービスが提供するコマンド，またはディレクトリゲートウェイで操作します。詳細については，LDAPディレクトリサーバのマニュアルを参照してください。
jaas.conf，ua.conf，および暗号鍵ファイルのバックアップも取るようにしてください。

参考

統合ユーザ管理では，セッションフェイルオーバ機能を使用することで，ログイン状態を別のJ2EEサーバに引き継ぐことができます。セッションフェイルオーバ機能を使用するためのセッションフェイルオーバ用フィルタの設定は，統合ユーザ管理機能を使用する場合と使用しない場合で異なります。設定方法については，「9.7.2　セッションフェイルオーバ用フィルタの設定」を参照してください。

10.2　レルム名の決定

ユーザを管理する単位を検討し，対応するレルム名を決定してください。この節では，レルム名について説明します。この名称は，JAAS対応ユーザ管理の認証時に使用します。jaas.conf（JAASのコンフィグレーションファイル）内の該当するログインモジュールのオプションとして指定します。通常は，「SoumuSystem」のような，ユーザ管理を共有しているアプリケーション群を表すわかりやすい名称を使用します。

10.3　LDAPディレクトリサーバの設定

この節では，LDAPディレクトリサーバの設定について説明します。

LDAPディレクトリサーバの設定手順を次に示します。

LDAPディレクトリサーバを設置します。
詳細については，「10.3.1　LDAPディレクトリサーバの設置」を参照してください。

LDAPディレクトリサーバにユーザを登録して，アクセス権を設定します。
詳細については，「10.3.2　ユーザの登録とアクセス権の設定」を参照してください。

シングルサインオンを使用する場合は，シングルサインオンライブラリ固有のオブジェクトクラスとユーザ定義属性をLDAPディレクトリサーバに登録して，オブジェクトクラスとユーザ属性定義を拡張します。
詳細については，「10.3.3　オブジェクトクラスとユーザ定義属性の拡張」を参照してください。

＜この節の構成＞

10.3.1　LDAPディレクトリサーバの設置

10.3.2　ユーザの登録とアクセス権の設定

10.3.3　オブジェクトクラスとユーザ定義属性の拡張

10.3.1　LDAPディレクトリサーバの設置

Cosminexusでは，ユーザ情報を管理するリポジトリとして，LDAPディレクトリサーバを使用できます。LDAPディレクトリサーバをインストールして初期設定をしてください。インストールと初期設定については，使用しているLDAPディレクトリサーバのマニュアルを参照してください。

使用できるLDAPディレクトリサーバの例

Sun Java System Directory Server

IBM SecureWay Directory（またはIBM Directory Server）

Active Directory

すでにLDAPディレクトリサーバを使用している場合には，LDAPディレクトリサーバで使用中のスキーマを参照して，シングルサインオン固有のスキーマが使用されていないことを確認してください。詳細については，「10.3.3　オブジェクトクラスとユーザ定義属性の拡張」を参照してください。

10.3.2　ユーザの登録とアクセス権の設定

統合ユーザ管理でLDAPディレクトリに接続（バインド）するために，管理用および参照用のユーザを登録してアクセス権を設定してください。

管理用ユーザのDNのことを管理用のバインドDN，参照用ユーザのDNのことを参照用のバインドDNといいます。

管理用のバインドDNは，統合ユーザ管理フレームワークで使用するベースエントリ以下すべてのエントリ，およびエントリに設定されたすべての属性に対して，すべてのアクセス権（Read，Write，Add，Delete，Search，Compare，Selfwrite）を持つバインドDNです。管理用のバインドDNは，LDAPディレクトリサーバ上のユーザ管理情報を登録，参照，変更，および削除するときに使用します。

参照用のバインドDNは，統合ユーザ管理フレームワークで参照するベースエントリ以下すべてのエントリ，およびエントリに設定されたすべての属性に対して，ReadとSearchのアクセス権を持つバインドDNです。参照用のバインドDNは，LDAPディレクトリサーバからユーザ情報などを取得するときに使用します。

10.3.3　オブジェクトクラスとユーザ定義属性の拡張

シングルサインオンを使用する場合は，シングルサインオンライブラリ固有のオブジェクトクラスとユーザ定義属性をLDAPディレクトリサーバに登録して，オブジェクトクラスとユーザ定義属性を拡張してください。

なお，拡張するオブジェクトクラスとユーザ定義属性の属性はシングルサインオンライブラリ固有のスキーマで，ほかのシステムとは共有できません。すでにLDAPディレクトリサーバを使用している場合は，LDAPディレクトリサーバで使用中のスキーマを参照し，シングルサインオン固有のスキーマが使用されていないことを確認してください。

＜この項の構成＞

(1)　シングルサインオンライブラリで拡張するオブジェクトクラス

(2)　シングルサインオンライブラリで拡張するユーザ定義属性

(3)　拡張するオブジェクトクラスおよびユーザ定義属性の追加手順

(1)　シングルサインオンライブラリで拡張するオブジェクトクラス

シングルサインオンライブラリ固有のオブジェクトクラスを次の表に示します。

表10-1　シングルサインオンライブラリ固有のオブジェクトクラス

オブジェクトクラス
OID
必須属性
任意属性

CosminexusSSOEntry
1.2.392.200010.7.6.21
objectClass,
CosminexusSSOEntryID,
CosminexusSSOUID
CosminexusSSOSecretdata,
CosminexusSSOPublicdata,
CosminexusSSOMapping

(2)　シングルサインオンライブラリで拡張するユーザ定義属性

シングルサインオンライブラリ固有の属性を次の表に示します。

表10-2　シングルサインオンライブラリ固有の属性

属性 | OID | シンタックス | マルチバリュー／シングルバリュー
CosminexusSSOEntryID | 1.2.392.200010.7.4.71 | cis | シングルバリュー
CosminexusSSOUID | 1.2.392.200010.7.4.72 | ces | シングルバリュー
CosminexusSSOSecretdata | 1.2.392.200010.7.4.73 | bin | シングルバリュー
CosminexusSSOPublicdata | 1.2.392.200010.7.4.74 | ces | シングルバリュー
CosminexusSSOMapping | 1.2.392.200010.7.4.75 | dn | マルチバリュー

(3)　拡張するオブジェクトクラスおよびユーザ定義属性の追加手順

拡張するオブジェクトクラスおよびユーザ定義属性の追加手順について，LDAPディレクトリサーバの種類ごとに説明します。

Sun Java System Directory Serverの場合

LDAPディレクトリサーバが起動していることを確認し，uaschema.slapd.ldifを次のコマンドでLDAPディレクトリサーバに登録してください。

ldapmodify -h <ホスト名> -p <ポート番号> -D <管理用のバインドDN> -w <パスワード> -c -f uaschema.slapd.ldif

IBM SecureWay DirectoryまたはIBM Directory Serverの場合

LDAPディレクトリサーバが起動していることを確認し，uaschema.ldifを次のコマンドでLDAPディレクトリサーバに登録してください。

ldapmodify -h <ホスト名> -p <ポート番号> -D <バインドDN> -w <パスワード> -c -f uaschema.ldif

ここで，指定するバインドDNは管理者権限を持っている必要があります。

Active Directoryの場合

Active Directoryでスキーマ修正ができるように設定を変更します。Microsoft管理コンソール（mmc.exe）を起動して，「スナップインの追加と削除」でActive Directoryスキーマを追加してください。「Active Directoryスキーマ」を右クリックして「操作マスタ」を選択し，「このドメインコントローラでスキーマの修正が可能」をチェックして［OK］ボタンをクリックしてください。

次のコマンドでuaschema.ad.ldifをActive Directoryに登録してください（ログオン先のドメインのドメインコントローラに現在ログオンしているユーザとして接続する場合です）。

　　 ldifde -i -c "dc=domain" "<ToDN>" -f uaschema.ad.ldif

ここで，ToDNにはドメインによって異なる適切なDNを指定してください。例えば，ドメインが「hitachi.co.jp」の場合，ToDNは「dc=hitachi,dc=co,dc=jp」となります。

10.4　ユーザ情報の登録

この節では，LDAPディレクトリサーバへのユーザ情報の登録方法と，登録するユーザ情報の文法について説明します。RDBへのユーザ情報の登録方法については，使用しているRDBのマニュアルを参照してください。

なお，Cosminexusでは，LDAPディレクトリサーバに格納するユーザ管理リポジトリの標準的なDIT構造を規定しています。リポジトリの構造については，マニュアル「Cosminexus　機能解説」の統合ユーザ管理で使用するユーザ情報の管理方法に関する説明を参照してください。

ユーザ情報をユーザ情報リポジトリに登録する方法には，次の2種類があります。

コマンドによる登録

統合ユーザ管理フレームワークのライブラリによる登録

それぞれの登録方法について説明します。また，登録するユーザ情報の文法，およびActive Directoryを使用する場合の設定についても説明します。

＜この節の構成＞

10.4.1　コマンドによる登録

10.4.2　統合ユーザ管理フレームワークのライブラリによる登録

10.4.3　登録するユーザ情報の文法

10.4.4　Active Directoryを使用する場合の設定

10.4.1　コマンドによる登録

Cosminexusが提供するコマンドとLDAPディレクトリサーバが提供するコマンドを使用してユーザ情報を登録する場合の手順を次に示します。

ユーザ情報を，LDIFファイルに記述します。

convpwコマンドでLDIFファイル中のパスワードを暗号化します。
LDIFファイル中に指定されたパスワードが暗号化されます。convpwコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

暗号化したLDIFファイルを，LDAPディレクトリサーバが提供するldapmodifyコマンドでユーザ情報リポジトリに登録します。

また，LDAPディレクトリサーバが提供するGUIでユーザ情報を登録できる場合もあります。詳細については，使用しているLDAPディレクトリサーバのマニュアルを参照してください。

10.4.2　統合ユーザ管理フレームワークのライブラリによる登録

ユーザ認証ライブラリが提供するAPIを使用してアプリケーションを作成し，そのアプリケーションを使用してユーザ情報を登録します。

APIを利用するアプリケーションは，最初にLdapUserDataManagerオブジェクトを生成します。このクラスのコンストラクタにはLDAPディレクトリサーバの定義識別子を指定します。定義識別子は，jaas.conf（JAASのコンフィグレーションファイル）で指定します。定義識別子にはLDAPディレクトリサーバのURL，バインドDN，バインドDNのパスワード，ベースDNなどが関連づけられています。なお，LdapUserDataManagerオブジェクトは定義ごとに一つ生成するようにしてください。

なお，LDAPディレクトリサーバとしてActive Directoryを使用して，ユーザの登録，ユーザ情報の更新，およびリポジトリ情報のパスワードの変更をする場合の方法については，「10.4.4　Active Directoryを使用する場合の設定」を参照してください。

ユーザ認証の実装については，マニュアル「Cosminexus　機能解説」のAPIを使用したユーザ認証の実装に関する説明を参照してください。また，統合ユーザ管理フレームワークで使用するAPIについては，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

10.4.3　登録するユーザ情報の文法

ユーザ情報は，次の表に示す文法に従って登録してください。

表10-3　ユーザ情報の文法

情報の種類
意味
文法

ユーザID
ユーザの識別子。
英数字列。
長さは1～512（単位：文字）。

パスワード
ユーザに対応するパスワード。
英数字列および特殊文字。
長さは0～512（単位：文字）。

注１　英数字列は，英字（A～Z，a～z）と数字（0～9）の文字の並びを意味します。

注２　特殊文字は，次の記号を意味します。

（空白）｜!｜"｜#｜$｜%｜&｜'｜(｜)｜*｜+｜,｜-｜.｜/｜:｜;｜<｜=｜>｜?｜@｜[｜¥｜]｜^｜_（アンダースコア）｜`｜{｜}｜|（垂直バー）｜~

注３　「文法」欄で明記されていない場合は，英字の大文字と小文字の区別をします。

注４　ASCII文字列で指定してください（文法については，プログラムではチェックしていません）。

注５　パスワードを平文でリポジトリに格納する場合，空文字（""）をパスワードとして使用しないでください。使用した場合，そのユーザはログインできなくなることがあります。パスワードとして空文字を使用したい場合は，SHA-1などによる暗号化をしてください。

10.4.4　Active Directoryを使用する場合の設定

LDAPディレクトリサーバとしてActive Directoryを使用する場合の設定方法について説明します。

統合ユーザ管理フレームワークのライブラリを使用して，ユーザ情報リポジトリへのユーザの登録，ユーザ情報の更新（ユーザのパスワード変更を含む）を行う場合，SSLを使用して接続するための証明書の登録，およびActive Directory固有の環境設定が必要です。

SSLを使用して接続するための証明書の登録，およびActive Directory固有の環境設定の方法を次に示します。

ポイント

Active Directoryで管理するユーザは，ほかのLDAPディレクトリサーバで管理するユーザと，オブジェクトクラス，属性が大きく異なります。統合ユーザ管理フレームワークのライブラリを使用する場合には，オブジェクトクラスに「user」を使用します，その「user」を作成する場合には，「cn」，「unicodePwd」，「sAMAccountName」，および「userAccountControl」の四つの属性を指定します。

「sAMAccountName」には，セキュリティアカウントマネージャ（SAM）のアカウント名を指定します。なお，通常，アカウント名はユーザIDと同じ値を指定します。

「userAccountControl」には，ユーザアカウントのプロパティフラグを指定します。一般ユーザのユーザエントリを作成する場合は「512」を指定します。ただし，Active Directoryがインストールされているサーバのセキュリティポリシーで，パスワードの長さが1文字以上に設定されている場合，「userAccountControl」に「512」を指定すると，ユーザを作成できません。この場合は，次のどちらかの対処をして，ユーザエントリを作成してください。

セキュリティポリシーのパスワードの長さを0文字以上に変更して，「userAccountControl」に「512」を指定する。

セキュリティポリシーのパスワードの長さの設定を変更しないで，「userAccountControl」に「544」を指定する。

＜この項の構成＞

(1)　証明書の登録

(2)　jaas.confの設定

(3)　ua.confの設定

(4)　注意事項

(1)　証明書の登録

J2EEサーバとActive Directory間の通信でSSLを使用するための証明書を登録します。証明書の登録方法を次に示します。

作成したデジタル証明書を，Active Directoryがインストールされているサーバ（LDAPサーバ）に登録します。
デジタル証明書の作成，登録方法については，Active Directoryのドキュメントを参照してください。

認証局（CA）の証明書を，J2EEサーバに登録します。
認証局の証明書のJ2EEサーバへの登録は，Cosminexus Developer's Kit for Javaに付属するkeytoolを使用して実行できます。keytoolの詳細については，Java 2 SDK, Standard Editionのドキュメントを参照してください。keytoolの実行例を次に示します。なお，表記の都合上，複数行にわたっていますが，実際は一行で記述します。
Windowsの場合

keytool -import -alias cakey -file C:¥temp¥cacer.cer -trustcacerts -keystore
"<Cosminexusのインストールディレクトリ>¥jdk¥jre¥lib¥security¥cacerts"

UNIXの場合

/opt/Cosminexus/jdk/bin/keytool -import -alias cakey -file /tmp/cacer.cer
-trustcacerts -keystore /opt/Cosminexus/jdk/jre/lib/security/cacerts

なお，keytoolで証明書を登録する際にJ2EEサーバを起動していた場合は，J2EEサーバを再起動してください。

(2)　jaas.confの設定

jaas.confファイルの設定方法を次に示します。

ログインモジュールとして，「WebPasswordLDAPLoginModule」を指定します。

WebPasswordLDAPLoginModuleのオプションに「ldap.w」を指定します。

(3)　ua.confの設定

ua.confの設定方法を次に示します。

接続先のLDAPディレクトリサーバのURLのプロトコルに「ldaps」を指定します。指定例を次に示します。なお，ポート番号は省略できます。
java.naming.provider.url.0=ldaps://localhost:636

ユーザのログインIDおよびパスワードを表す属性値を次のとおり指定します。
com.cosminexus.admin.auth.ldap.attr.userid.0=cn
com.cosminexus.admin.auth.ldap.attr.password.0=unicodePwd

接続先のLDAPディレクトリサーバの種類を次のとおり指定します。
com.cosminexus.admin.auth.ldap.directory.kind.0=AD

(4)　注意事項

注意事項を次に示します。

ua.confでユーザのパスワードを表す属性値として「unicodePwd」を指定した場合，パスワード形式オプション「password.encrypt」および「password.encrypt.ex」の設定は無効になります。

Active Directoryでは，既存ユーザエントリのオブジェクトクラスの変更はサポートしていません。ua.confに「com.cosminexus.admin.auth.ldap.directory.kind.0=AD」を指定した場合，LdapUserDataManagerクラスのコンストラクタで新規にオブジェクトを追加したあとで，既存のユーザエントリを更新しても，ユーザエントリ作成時のオブジェクトクラスが適用されます。

10.5　暗号鍵ファイルの作成（シングルサインオンを使用する場合）

この節では，シングルサインオン用のユーザ情報を暗号化または復号化するための暗号鍵ファイルの作成と変更について説明します。ユーザ情報を暗号化しない場合，暗号鍵ファイルの作成は不要です。

シングルサインオン用のユーザ情報を暗号化する場合は，暗号鍵ファイルで暗号化してLDAPディレクトリサーバに格納します。また，ユーザ情報を参照するためには，暗号鍵ファイルで復号化して参照します。ユーザ情報を暗号化する場合は，LDAPディレクトリサーバに登録する前に，暗号鍵ファイルを作成してください。

＜この節の構成＞

10.5.1　暗号鍵ファイルの作成

10.5.2　暗号鍵ファイルの変更

10.5.1　暗号鍵ファイルの作成

シングルサインオン用のユーザ情報を暗号化または復号化するための暗号鍵ファイルは，ssogenkeyコマンドで作成します。なお，作成した暗号鍵ファイルは，システム管理者が安全な場所に保管してください。

また，シングルサインオン用のユーザ情報を暗号化または復号化するためには，ua.conf（統合ユーザ管理のコンフィグレーションファイル）で，使用する暗号エンジンに「JCE」を指定する必要があります。

ssogenkeyコマンド，およびua.confについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

10.5.2　暗号鍵ファイルの変更

シングルサインオン用のユーザ情報は登録済みで，暗号鍵ファイルを変更する場合は，次の手順で変更してください。暗号鍵ファイルを変更する手順を次に示します。

ssoexportコマンドでシングルサインオン情報リポジトリの内容をすべて取り出します。

ssogenkeyコマンドを実行して，暗号鍵ファイルを作成します。

ssoimportコマンドで，1.で取り出した内容を登録します。

各コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

10.6　ユーザ情報の登録（シングルサインオンを使用する場合）

この節では，LDAPディレクトリサーバへのシングルサインオン用のユーザ情報の登録方法と，登録するユーザ情報の文法について説明します。

なお，Cosminexusでは，LDAPディレクトリサーバに格納するシングルサインオン用のユーザ管理リポジトリの標準的なDIT構造を規定しています。リポジトリの構造については，マニュアル「Cosminexus　機能解説」の統合ユーザ管理で使用するユーザ情報の管理方法に関する説明を参照してください。

シングルサインオン用のユーザ情報をシングルサインオン情報リポジトリに登録する方法には，次の2種類があります。

コマンドによる登録

統合ユーザ管理フレームワークのライブラリによる登録

それぞれの登録方法について説明します。また，登録するユーザ情報の文法についても説明します。

＜この節の構成＞

10.6.1　コマンドによる登録

10.6.2　統合ユーザ管理フレームワークのライブラリによる登録

10.6.3　登録するユーザ情報の文法

10.6.1　コマンドによる登録

シングルサインオン用のユーザ情報をCSV形式ファイルで作成して，Cosminexusが提供するssoimportコマンドを使用してシングルサインオン情報リポジトリに登録します。

ssoimportコマンド，およびCSV形式ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

10.6.2　統合ユーザ管理フレームワークのライブラリによる登録

シングルサインオンライブラリが提供するAPIを使用してアプリケーションを作成し，そのアプリケーションを使用してユーザ情報を登録します。

APIを利用するアプリケーションは，最初にLdapSSODataManagerオブジェクトを生成します。このクラスのコンストラクタにはレルム名を指定します。なお，LdapSSODataManagerオブジェクトは定義ごとに一つ生成するようにしてください。

シングルサインオン情報リポジトリの内容をAPIで更新した場合に，それを通知するシングルサインオン用認証情報リスナクラスを実装すれば，シングルサインオン情報リポジトリの更新に同期して接続先システムのリポジトリの更新もできます。

ユーザ認証の実装については，マニュアル「Cosminexus　機能解説」のAPIを使用したユーザ認証の実装に関する説明を参照してください。また，統合ユーザ管理フレームワークで使用するAPIについては，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

10.6.3　登録するユーザ情報の文法

シングルサインオン用のユーザ情報は，次の表に示す文法に従って登録してください。

表10-4　シングルサインオン用のユーザ情報の文法

情報の種類
意味
文法

レルム名
ユーザ管理の範囲を示す識別子です。
英数字列。
大文字と小文字を区別しません。
DN名で使用できる名前を付けてください。

ユーザID
ユーザ管理機能を持つアプリケーションの使用者を表すユーザの識別子です。
英数字列。
長さは1～512（単位：文字）。

SecretData
ユーザ管理機能を持つアプリケーションのユーザIDに対応したパスワードなどの暗号化が必要な認証情報のことです。ユーザを認証するために使用する値を指定します。ここに指定された値は，暗号化されて保存されます。
英数字列および特殊文字。
長さは0～512（単位：文字）。

PublicData
ユーザ管理機能を持つアプリケーションが，ユーザの認証を行う際に，ユーザIDおよびSecretData以外で必要な認証情報のことです。ここに指定された値は，暗号化されません。
英数字列および特殊文字。
長さは0～512（単位：文字）。

注１　英数字列は，英字（A～Z，a～z）と数字（0～9）の文字の並びを意味します。

注２　特殊文字は，次の記号を意味します。

（空白）｜!｜"｜#｜$｜%｜&｜'｜(｜)｜*｜+｜,｜-｜.｜/｜:｜;｜<｜=｜>｜?｜@｜[｜¥｜]｜^｜_（アンダースコア）｜`｜{｜}｜|（垂直バー）｜~

注３　「文法」欄で明記されていない場合は，英字の大文字と小文字の区別をします。

注４　ASCII文字列で指定してください。文法については，プログラムではチェックしていません。

10.7　コンフィグレーションファイルの作成

この節では，次の二つのコンフィグレーションファイルの作成，およびコンフィグレーションファイルの設定例を説明します。

jaas.conf（JAASのコンフィグレーションファイル）

ua.conf（統合ユーザ管理のコンフィグレーションファイル）

＜この節の構成＞

10.7.1　jaas.confの作成

10.7.2　ua.confの作成

10.7.3　コンフィグレーションファイルの設定例

10.7.1　jaas.confの作成

jaas.confには，ユーザ認証ライブラリまたはシングルサインオンライブラリが使用する情報として，アプリケーション単位に，使用するログインモジュール名，ua.confで指定したリポジトリ（LDAPディレクトリサーバまたはRDB）の設定番号などを指定します。

＜この項の構成＞

(1)　格納場所

(2)　指定内容

(3)　jaas.confの再読み込み

(1)　格納場所

jaas.confの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥jaas.conf

UNIXの場合
/opt/Cosminexus/manager/config/jaas.conf

このjaas.confを上書きするか，任意の場所にコピーして使用してください。jaas.confの格納場所は，JavaVM起動時のプロパティで指定してください。JavaVM起動時のプロパティの指定については，「10.8　JavaVMのプロパティの設定」を参照してください。

(2)　指定内容

アプリケーション単位に次の情報を指定してください。

ユーザ認証ライブラリを使用してユーザ認証する場合

定義するログインモジュールはWebPasswordLoginModuleにしてください。このWebPasswordLoginModuleのオプションには，ua.confで定義しているリポジトリで定義したLDAP設定番号とレルム名を定義します。

WebPasswordLoginModuleとカスタムログインモジュールの連携をする場合，ログインモジュールの定義はDelegationLoginModuleにしてください。このDelegationLoginModuleのオプションに呼び出すカスタムログインモジュール名を定義します。

シングルサインオンライブラリを使用してユーザ認証する場合

定義するログインモジュールはWebSSOLoginModuleにしてください。このWebSSOLoginModuleのオプションには，ua.confで定義しているカスタムログインモジュールの識別子とレルム名を定義します。

jaas.confについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(3)　jaas.confの再読み込み

Management Serverの運用管理コマンドであるmngsvrutilコマンドを使用すると，J2EEサーバを再起動しないで，jaas.confの再読み込みができます。J2EEサーバを再起動しないで，ログインモジュールで使用するLDAP設定番号を変更したい場合などに利用します。

なお，mngsvrutilコマンドを使用するためには，Management Serverが起動されていて，適切に設定済みである必要があります。

jaas.confの再読み込みの流れを次の図に示します。

図10-2　jaas.confの再読み込みの流れ

mngsvrutilコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

10.7.2　ua.confの作成

ua.confには，ユーザ認証ライブラリまたはシングルサインオンライブラリが使用する情報として，リポジトリ（LDAPディレクトリサーバまたはRDB）へのアクセス情報，シングルサインオン用のユーザ情報を暗号化または復号化するための暗号鍵ファイルのパスなどを指定します。

＜この項の構成＞

(1)　格納場所

(2)　指定内容

(3)　パスワードの変更とスクランブル化

(1)　格納場所

ua.confの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥ua.conf

UNIXの場合
/opt/Cosminexus/manager/config/ua.conf

このua.confを上書きするか，任意の場所にコピーして使用してください。ua.confの格納場所は，JavaVM起動時のプロパティで指定します。JavaVM起動時のプロパティの指定については，「10.8　JavaVMのプロパティの設定」を参照してください。

また，Component Container管理者がファイルを参照できるようにua.confのアクセス権を変更してください。Component Container管理者の設定については，「2.1.3　Component Container管理者の設定」を参照してください。

(2)　指定内容

ユーザ認証ライブラリの機能を使用したユーザ認証およびシングルサインオンライブラリの機能を使用したシングルサインオンをするために，LDAPディレクトリサーバのURLやベースDN，アクセス権を設定してください。

シングルサインオンライブラリの機能を使用してシングルサインオンをする場合には，暗号化するための製品の選択，および暗号鍵ファイル名の指定をしてください。また，シングルサインオンの機能から呼び出すログインモジュールがカスタムログインモジュールの場合，カスタムログインモジュール名，およびカスタムログインモジュールと関連するクラスのクラスファイルを格納しているディレクトリを定義してください。

ua.confの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(3)　パスワードの変更とスクランブル化

ua.confに指定したLDAPディレクトリサーバやRDBに接続するためのパスワードを変更したい場合には，ua.confを編集するほかに，uachpwコマンドを使用して変更できます。uachpwコマンドを使用してLDAPディレクトリサーバやRDBに接続するためのパスワードを変更する場合に，-scrambleオプションを指定すると，パスワードのスクランブル化もできます。

なお，uachpwコマンドでパスワードをスクランブル化する場合には，必ずusrconf.propertiesでcom.cosminexus.admin.auth.passwordScramble.enable=trueを指定し，スクランブル化されたパスワードの復号化機能を有効にしておいてください。

10.7.3　コンフィグレーションファイルの設定例

ここでは，次の図に示すディレクトリ構成を持つユーザ情報の設定例を示します。

図10-3　ユーザ情報のディレクトリ構成の例

＜この項の構成＞

(1)　jaas.confの設定例

(2)　属性の一覧の設定例

(3)　ua.confの設定例

(4)　シングルサインオンへの対応例（標準ログインモジュールの場合）

(5)　シングルサインオンへの対応例（カスタムログインモジュールの場合）

(1)　jaas.confの設定例

jaas.confには，ユーザを認証するための情報を設定します。使用するログインモジュール名，ua.confで指定したリポジトリ（LDAPディレクトリサーバまたはRDB）の設定番号などを指定します。jaas.confの設定例を次の図に示します。

図10-4　jaas.confの設定例

(2)　属性の一覧の設定例

属性の一覧には，そのユーザで認証が成功した際に取得するユーザの情報（属性名）と参照に使用する別名（Alias）を指定します。属性の一覧の設定例（c:¥RealmA¥config¥AliasFile.csv（Windowsの場合），または/tmp/RealmA/config/AliasFile.csv（UNIXの場合））を次の図に示します。

図10-5　属性の一覧の設定例

なお，ファイルを作成しなくても，プログラム中で直接AttributeEntryクラスを使用して指定することもできます。

(3)　ua.confの設定例

ua.confには，リポジトリ（LDAPディレクトリサーバまたはRDB）へのアクセス情報などを設定します。ua.confの設定例を次の図に示します。

図10-6　ua.confの設定例（Windowsの場合）

図10-7　ua.confの設定例（UNIXの場合）

認証用プログラムのコーディング例を次の図に示します。

図10-8　認証用プログラムのコーディング例（Windowsの場合）

図10-9　認証用プログラムのコーディング例（UNIXの場合）

(4)　シングルサインオンへの対応例（標準ログインモジュールの場合）

ユーザ認証ライブラリのログインモジュールをシングルサインオンに対応させるには，jaas.confを変更する必要があります。シングルサインオンへの対応例（標準ログインモジュールの場合）を次の図に示します。

図10-10　シングルサインオンへの対応例（標準ログインモジュールの場合）

(5)　シングルサインオンへの対応例（カスタムログインモジュールの場合）

カスタムログインモジュールをシングルサインオンに対応させるには，jaas.conf，および認証用プログラムのコーディングを変更する必要があります。また，あらかじめ，ua.confに，ログインモジュールの識別子（対応例では「Krb5」）に対応するカスタムログインモジュールの定義項目を定義しておく必要があります。シングルサインオンへの対応例（カスタムログインモジュールの場合）を次の図に示します。

図10-11　シングルサインオンへの対応例（カスタムログインモジュールの場合）

10.8　JavaVMのプロパティの設定

統合ユーザ管理機能を使用する場合は，JavaVMの起動時に，J2EEサーバのusrconf.propertiesとserver.policyの設定が必要です。この節では，各ファイルでの設定内容の概要について説明します。

usrconf.propertiesでの設定
usrconf.propertiesでは，次の内容を設定します。

java.security.auth.login.configキーで，jaas.confの格納場所を指定します。

com.cosminexus.admin.auth.configキーで，ua.confの格納場所を指定します。

com.cosminexus.admin.auth.passwordScramble.enableキーで，uachpwコマンドでスクランブル化したパスワードの復号化機能の有効または無効を指定します。このキーの指定については，「10.7.2(3)　パスワードの変更とスクランブル化」を参照してください。

usrconf.propertiesの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

server.policyでの設定
server.policyでは，WebアプリケーションでLoginContextクラスを操作するためのアクセス権を設定します。
server.policyの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

次に各ファイルでの指定内容について説明します。なお，ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この節の構成＞

10.8.1　usrconf.propertiesの指定内容

10.8.2　server.policyの指定内容

10.8.1　usrconf.propertiesの指定内容

usrconf.propertiesの指定内容についてOSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

usrconf.propertiesに，次に示すテンプレートファイルの内容を追加します。

<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥template_usrconf.properties

template_usrconf.propertiesの内容を次に示します。

java.security.auth.login.config==C:/Program Files/Hitachi/Cosminexus/manager/config/jaas.conf
com.cosminexus.admin.auth.config=C:/Program Files/Hitachi/Cosminexus/manager/config/ua.conf

このうち，「C:/Program Files/Hitachi/Cosminexus/」はCosminexusの標準インストールディレクトリです。異なるディレクトリにインストールした場合は，この部分をインストールディレクトリに変更してください。

(2)　UNIXの場合

usrconf.propertiesに，次に示すテンプレートファイルの内容を追加します。

/opt/Cosminexus/manager/config/templates/template_usrconf.properties

template_usrconf.propertiesの内容を次に示します。

java.security.auth.login.config==/opt/Cosminexus/manager/config/jaas.conf
com.cosminexus.admin.auth.config=/opt/Cosminexus/manager/config/ua.conf

10.8.2　server.policyの指定内容

server.policyにWebアプリケーションでLoginContextクラスを操作するためのアクセス権の設定が必要です。設定するアクセス権の詳細については，javax.security.auth.AuthPermissionクラスを参照してください。

また，カスタムログインモジュールやパスワード認証時の暗号拡張機能を使用する場合，各クラスを操作するために，アクセス権の設定が必要です。

次に，server.policyの定義例を示します。

この定義例では，LoginContextクラスをExampleという名前でインスタンス化可能にする権限，およびSubjectを参照するために必要な権限を示します（//addの部分について定義が必要です）。また，次に示すディレクトリ以下に格納されているすべてのクラス（codeBase "file:${cosminexus.home}/manager/modules/-"で指定）にすべての権限を与えることを示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥modules

UNIXの場合
/opt/Cosminexus/manager/modules

実際に運用する際には，適切なコードソースとアクセス権を設定してください。

server.policyの例

grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
 permission java.lang.RuntimePermission "loadLibrary.*";
 permission java.lang.RuntimePermission "queuePrintJob";
 permission java.net.SocketPermission "*", "connect";
 permission java.io.FilePermission "<<ALL FILES>>", "read, write";
 permission java.util.PropertyPermission "*", "read";
 permission javax.security.auth.AuthPermission "getSubject"; //add
 permission javax.security.auth.AuthPermission "createLoginContext.*"; //add
};
grant codeBase "file:${cosminexus.home}/manager/modules/-" {
 permission java.security.AllPermission;
};

10.9　ファイルのデプロイ

この節では，統合ユーザ管理で使用するEARファイルをデプロイ方法について説明します。使用するJ2EEサーバに統合ユーザ管理用のuastartup.earをインポートし，uastartup.earを起動しておいてください。uastartup.earは，次に示すディレクトリにインストールされています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

uastartup.earは，Management Serverに登録して，J2EEサーバにインポートしてください。詳細については，「9.5.1　J2EEアプリケーションの設定の流れ」を参照してください。

統合ユーザ管理フレームワークの機能を使用する場合は，uastartup.earを必ず稼働させてください。稼働していない場合，統合ユーザ管理フレームワークの提供するAPIで，例外が発生することがあります。また，Management Serverのリソース監視機能，およびmngsvrutilコマンドのサブコマンドreload userAdminも使用できません。

11.　システム構築の概要（バッチアプリケーションを実行するシステム）

この章では，バッチアプリケーションを実行するシステムを構築する場合の，システム構築の流れや必要な設定について説明します。

＜この章の構成＞

11.1　システム構築の流れ

11.2　システム構築で使用するファイル

11.3　システムの構成定義

11.1　システム構築の流れ

この節では，バッチアプリケーションを実行するシステムを構築する場合の流れについて説明します。Management ServerのSmart Composer機能を使用して構築するシステムは，Smart Composer機能のコマンドや運用管理コマンド（mngsvrutil）を利用して運用します。Smart Composer機能のコマンドや運用管理コマンド（mngsvrutil）を利用して運用するシステムでは，Cosminexusのシステム全体のサーバの運用をManagement Serverで一括管理できます。システム構築の流れを次の図に示します。

図11-1　システム構築の流れ

図中の1.～7.について説明します。

Management Serverの設定をします。

Management Serverを初めて使用するホストは，Management Serverをセットアップしてください。セットアップ時に，Management Serverのユーザアカウントも設定できます。

Management Serverのプロパティファイル（mserver.properties）や運用管理エージェントのプロパティファイル（adminagent.properties）で，Management Serverが使用するポート番号や，Management Serverへのアクセスを許可するホストなどを指定してください。

必要に応じて，Management Serverが出力するログの設定や，JP1との連携時にManagement Serverの障害情報をJP1イベントとして発行するかどうかなど，Management Serverの動作環境を設定してください。

必要に応じて，運用管理エージェントが，論理サーバの動作を確認するレベル，間隔，リトライ回数などを設定してください。

Management Serverの設定については，「3.4　Management Serverの設定」を参照してください。

システムの構成定義をします。
Smart Composer機能では，バッチアプリケーションを実行するシステム内に配置されたサーバマシンやサーバ（論理サーバ）の構成を，Webシステムという概念で管理します。サーバマシンの集合を物理ティア，サーバ（論理サーバ）の集合をサービスユニットといいます。
Management Serverが管理，運用する運用ドメイン内には，Webシステムを複数配置できます。Webシステムは，Smart Composer機能の簡易構築定義ファイルで定義します。Webシステムの構成定義の概要については，「11.3　システムの構成定義」を参照してください。
また，Smart Composer機能の簡易構築定義ファイルでは，必要に応じて，論理サーバごとに次の設定をします。

論理サーバを稼働させるために必要な設定

論理サーバの起動順序，自動再起動するときの回数など，論理サーバの起動と停止の設定

論理サーバの起動と停止で使用する環境変数の設定

バッチサーバの動作設定をします。
バッチサーバの場合，必ず指定する項目があります。必ず指定する項目については，「12.2.1　バッチサーバの動作設定として必ず設定する項目」を参照してください。それ以外の項目はデフォルトの設定のままで利用する場合は，設定不要です。デフォルトで設定されているバッチサーバの動作を変更したい場合には，Smart Composer機能の簡易構築定義ファイルで論理サーバの設定値を設定もしくは変更したり，またはユーザ定義ファイルを編集したりする必要があります。

トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。ただし，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。
これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。

システムの可用性を高める設定をします。
Managementイベントによる障害の事前検知を設定します。Managementイベントによる障害の事前検知の機能を使用しない場合は，設定不要です。

リソースを設定します。
サーバ管理コマンドを使用して，リソースアダプタのプロパティなどを定義します。バッチアプリケーションからデータベースに接続しない場合は，設定不要です。

システムを起動して，システムの動作を確認します。
システムの起動および停止手順については，「3.2　システムの起動と停止の設定」を参照してください。

参考

ほかのプログラムと連携する場合，システム全体をどのように運用するかによってシステムの構築のしかたが異なります。

JP1と連携して運用する場合

バッチアプリケーションの開始をJP1のジョブとして定義できます。

また，Management Serverを利用しているシステムは，JP1と連携することで，JP1の集中監視，運用の自動化，稼働状況の分析などの機能を使用して，Cosminexus以外で構築されたシステムも含めた業務システム全体を一括管理できるようになります。JP1と連携するシステムの構築については，「16.　JP1との連携の設定」を参照してください。

クラスタソフトウェアと連携して運用する場合

Management Serverを利用しているシステムは，クラスタソフトウェアと連携することで，プロセス監視，障害発生時の系切り替えなどの機能を使用して，Application Serverの稼働率を向上できます。連携できるクラスタソフトウェアは，Microsoft Cluster Service（Windowsの場合），およびHAモニタ（AIX，HP-UXまたはLinuxの場合）です。

クラスタソフトウェアと連携するシステムの構築については，「17.　クラスタソフトウェアと連携するための設定」を参照してください。

11.2　システム構築で使用するファイル

この節では，システムの構築で使用するファイルのうち，主なファイルについて説明します。ここで説明していないファイルについては，システム構築の手順の中で適宜説明します。

注意

ファイルを変更する場合は，バッチサーバを停止してください。バッチサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

＜この節の構成＞

(1)　Management Serverのファイル

(2)　Smart Composer機能のファイル

(3)　バッチサーバのファイル

(1)　Management Serverのファイル

adminagent.xml（運用管理エージェント設定ファイル）
運用管理エージェントが論理サーバを起動，停止するときに使用する環境変数を指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥adminagent.xml

UNIXの場合
/opt/Cosminexus/manager/config/adminagent.xml

adminagent.properties（運用管理エージェントプロパティファイル）
運用管理エージェントのプロパティを指定するファイルです。論理サーバの動作確認レベルやsnapshotログの収集先の設定などで使用します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥adminagent.properties

UNIXの場合
/opt/Cosminexus/manager/config/adminagent.properties

mserver.properties（Management Server環境設定ファイル）
Management Serverのプロパティを指定するファイルです。Management Serverの環境設定や障害検知時コマンドの動作の設定などで使用します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥mserver.properties

UNIXの場合
/opt/Cosminexus/manager/config/mserver.properties

(2)　Smart Composer機能のファイル

簡易構築定義ファイル
Smart Composer機能のコマンドで構築するシステムを定義するファイルです。任意の場所に格納できます。簡易構築定義ファイルのテンプレートファイルが提供されていますので，テンプレートファイルをコピーして利用してください。テンプレートファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml

(3)　バッチサーバのファイル

server.policy（セキュリティポリシーファイル）
バッチサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

参考

バッチサーバのファイルには，このほかに次のファイルがあります。Smart Composer機能を使用してシステムを構築する場合，これらのファイルで設定する内容（キー）は，簡易構築定義ファイルのパラメタで設定します。

usrconf.properties（ユーザプロパティファイル）

バッチサーバのユーザプロパティを指定するファイルです。バッチサーバが使用するネーミングサービス，トランザクション，コネクション，ログ，セキュリティなどを指定します。

ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

usrconf.cfg（オプション定義ファイル）

バッチサーバのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

usrconf.propertiesおよびusrconf.cfgと，簡易構築定義ファイルのパラメタの対応については，「4.1(3)　そのほかのユーザ定義ファイルの編集について」を参照してください。

usrconf.propertiesおよびusrconf.cfgは，Smart Composer機能を使用しないで，ファイル編集やコマンド実行でシステムを構築する場合などに使用します。usrconf.propertiesおよびusrconf.cfgについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

11.3　システムの構成定義

この節では，バッチアプリケーションを実行するシステムの構成定義について説明します。

Webシステムは，一つの業務システムに対応し，運用ドメイン内に複数配置できます。運用管理ドメインは，Management Serverが同一の運用管理ポリシーを適用して，複数のサーバをまとめて管理する範囲のことです。

Webシステムの構成は，Management ServerのSmart Composer機能の簡易構築定義ファイルで定義します。システム構成に応じて，その機能を実現するために必要な論理サーバや，サーバマシンをWebシステム内に適切に配置して，システムの構成を定義してください。なお，システムの構成を検討する指針については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。

●簡易構築定義ファイルの作成

簡易構築定義ファイルはテキストエディタを使用して作成しますが，テンプレートファイルが用意されているので，構成の基本情報を設定するだけで作成できます。

簡易構築定義ファイルの作成手順を次に示します。

簡易構築定義ファイルのテンプレートファイルを任意の場所にコピーします。
テンプレートファイルは次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合

/opt/Cosminexus/manager/config/templates/

簡易構築定義ファイルのテンプレートファイルを任意の名称に変更します。
テキストエディタなどを利用して，簡易構築定義ファイルに手順3.～手順6.の情報を定義します。

Management Serverで運用するWebシステム名，Webシステムの表示名などを定義します。
1Webシステムは，<web-system>タグから</web-system>タグまでの範囲に定義します。

システム構成に応じて，物理ティアを定義します。必要に応じて，論理サーバ全体で共通のコンフィグレーションを定義します。
システム構成に応じて，その機能を実現するために必要な論理サーバが決定されます。Smart Composer機能では，同一のデプロイメント（論理サーバの配置，定義設定など）を適用するホスト（サーバマシン）の集合を物理ティアという単位で定義します。バッチサーバの場合，物理ティアにはj2ee-tierを使用します。
物理ティアは，<tier>タグから</tier>タグまでの範囲に，物理ティアの種類や，論理サーバ全体で共通のコンフィグレーションなどを定義します。

論理サーバ（サービスユニット）を配置するホストを定義します。必要に応じて，論理サーバごとのコンフィグレーションを定義します。
Smart Composer機能では，論理サーバの集合をサービスユニットという単位で定義します。サービスユニットは，<unit>タグから</unit>タグまででの範囲に，サービスユニットを配置するホストや，そのホストが属する物理ティア，論理サーバごとのコンフィグレーションなどを定義します。

ホストを定義します。
物理ティアに属するホストのホスト名や，運用管理エージェントのホスト名などを定義します。ホストは，Webシステムに依存しません。Management Serverで定義済みのホストを利用する場合は，ホストの定義を省略できます。ホストは，<host>タグから</host>タグまでの範囲に定義します。

手順3.～手順6.で定義した情報を反映します。

Smart Composer機能の簡易構築定義ファイルの詳細や，Webシステム，物理ティアおよびサービスユニットの概要については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

●論理サーバのコンフィグレーション定義

論理サーバの動作設定や，機能を使用するための設定などは，論理サーバのコンフィグレーションで定義します。論理サーバのコンフィグレーションは，論理サーバ全体，および論理サーバごとに定義できます。論理サーバ全体で共通の定義を設定する場合は物理ティアで，論理サーバごとの定義を設定する場合はサービスユニットで定義します。物理ティアで定義すると，その物理ティアに属するホストに配置する論理サーバ全体で共通のコンフィグレーションが設定されます。コンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグを次の表に示します。

表11-1　論理サーバのコンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグ

タグ名称
説明

<configuration>
論理サーバの動作環境を設定します。動作環境を設定する論理サーバの種類は，<logical-server-type>タグで指定します。バッチサーバの場合，j2ee-serverを指定します。
<configuration>タグは，物理ティアの定義（<tier>タグ内），およびサービスユニットの定義（<unit>タグ内）に設定できます。<tier>タグ内または<unit>タグ内のどちらの<configuration>タグに設定するかによって，設定内容を適用する論理サーバの範囲が異なります。論理サーバ全体で共通の設定を変更したい場合は，<tier>タグ内の<configuration>タグを編集し，特定の論理サーバの設定を変更したい場合は，<unit>タグ内の<configuration>タグを編集します。

<logical-server-type>
<configuration>タグで動作環境を設定する論理サーバの種類を定義します。定義できる論理サーバの種類を次に示します。

論理J2EEサーバ：j2ee-server

論理パフォーマンストレーサ：performance-tracer

バッチサーバは論理J2EEサーバとして定義します。

<param>
論理サーバの動作環境を設定するパラメタ（パラメタ名と値の組み合わせ）を定義します。1種類のパラメタごとに<param>タグで囲んで定義します。

<param-name>
論理サーバの動作環境を設定するパラメタの名称を定義します。

<param-value>
<param-name>タグで指定したパラメタの設定値を定義します。

注　各論理サーバの<configuration>タグ内で，パラメタ名（<param-name>タグ）と値（<param-value>タグ）の設定を省略すると，論理サーバの動作環境にはデフォルトの値が設定されます。デフォルトの設定のままで利用する場合は，定義不要です。

Smart Composer機能の簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。なお，機能を使用するために設定する項目のうち，一部の設定項目は，簡易構築定義ファイルで定義できません。簡易構築定義ファイルで設定できない項目は，ほかのユーザ定義ファイルを使用して定義します。機能を使用するための設定の詳細については，「12.1　バッチサーバの動作設定の方法」を参照してください。また，機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

12.　バッチサーバの動作設定（バッチアプリケーションを実行するシステム）

この章では，バッチサーバで，マニュアル「Cosminexus　機能解説」で説明した機能を有効にするための設定項目と設定方法について説明します。バッチサーバの場合は，必ず設定する項目があります。それ以外の項目はデフォルトのバッチサーバの動作を変更しない場合は，設定不要です。デフォルトで設定されているバッチサーバの動作を変更したい場合には，ユーザ定義ファイルの編集によって，バッチサーバの動作設定を変更する必要があります。

＜この章の構成＞

12.1　バッチサーバの動作設定の方法

12.2　バッチサーバで設定できる主な項目

12.3　リソース枯渇監視の設定

12.4　稼働情報ファイルの取得とイベント発行の設定

12.1　バッチサーバの動作設定の方法

この節では，マニュアル「Cosminexus　機能解説」で説明したバッチサーバの機能を有効にするための設定項目と設定方法について説明します。

デフォルトで設定されているバッチサーバの動作を変更したい場合には，ユーザ定義ファイルを編集して，バッチサーバの動作設定を変更する必要があります。例えば，バッチサーバが使用するネーミングサービス，トランザクション，コネクション，ログ，セキュリティの設定を変更したい場合，バッチサーバのJavaVMの起動オプションなどを変更したい場合などには，簡易構築定義ファイルで設定を変更します。簡易構築定義ファイルに，テキストエディタなどを使用して，変更対象のパラメタ名と変更後の値を設定します。変更後の値を設定した簡易構築定義ファイルをSmart Composer機能のコマンドを実行して反映することで，バッチサーバの動作設定を変更できます。ただし，バッチサーバのセキュリティポリシーを変更したい場合には，Management Serverでは設定できません。簡易構築定義ファイル以外のユーザ定義ファイルをテキストエディタなどで編集して，動作設定を変更してください。

＜この節の構成＞

(1)　前提条件

(2)　バッチサーバの動作を設定するユーザ定義ファイル

(3)　そのほかのユーザ定義ファイルの編集について

(1)　前提条件

server.policyを編集する場合は，編集対象のバッチサーバのセットアップが完了していることが前提になります。また，UNIXの場合，動作設定を変更するときには，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

(2)　バッチサーバの動作を設定するユーザ定義ファイル

次の二つのユーザ定義ファイルをテキストエディタなどで編集して，バッチサーバの動作を設定します。

簡易構築定義ファイル

server.policy（バッチサーバ用セキュリティポリシーファイル）

バッチサーバの動作設定は，簡易構築定義ファイルのパラメタで指定します。簡易構築定義ファイルのパラメタは，<configuration>タグ内に，パラメタ名（<param-name>タグ）とパラメタ値（<param-value>タグ）を設定して，編集します。簡易構築定義ファイルでのパラメタの指定形式を次に示します。

簡易構築定義ファイルでのパラメタの指定形式

<param>
<param-name>パラメタ名</param-name>
<param-value>パラメタ値1</param-value>
：
<param-value>パラメタ値n</param-value>
</param>
<param>
：

簡易構築定義ファイルで編集した内容は，Smart Composer機能のコマンドを使用して反映します。

ユーザ定義ファイルのうち，簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。server.policy（バッチサーバ用セキュリティポリシーファイル）の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(3)　そのほかのユーザ定義ファイルの編集について

usrconf.properties，およびusrconf.cfgには，テキストエディタなどで直接編集しなくても，簡易構築定義ファイルのパラメタで設定した内容が反映されます。簡易構築定義ファイルのパラメタと，usrconf.propertiesおよびusrconf.cfgとの対応を次の表に示します。

表12-1　簡易構築定義ファイルのパラメタと，usrconf.propertiesおよびusrconf.cfgとの対応

簡易構築定義ファイルのパラメタ | ユーザ定義ファイルの種類
バッチサーバ用ユーザプロパティを設定するパラメタ | usrconf.properties（バッチサーバ用ユーザプロパティファイル）
バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ※
バッチサーバ用オプション定義を設定するパラメタ | usrconf.cfg（バッチサーバ用オプション定義ファイル）
バッチサーバの拡張パラメタに設定できるパラメタ

簡易構築定義ファイルのパラメタについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

Smart Composer機能でシステムを構築する場合は，システムの一貫性を保つため，細かい設定を変更する場合でも，簡易構築定義ファイルを編集するようにしてください。テキストエディタなどで個別にファイルを直接編集する場合には，スペルミスなどに十分注意してください。usrconf.propertiesとusrconf.cfgについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

次に，このマニュアルでのパラメタの記載形式を，簡易構築定義ファイルのパラメタごとに説明します。

バッチサーバ用のユーザプロパティを設定するパラメタ
バッチサーバ用のユーザプロパティを設定するパラメタの記載形式を次に示します。なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.propertiesで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.propertiesの<キー名称>に読み替えて設定してください。バッチサーバ用のユーザプロパティを設定するパラメタの場合，<param-value>タグのパラメタ値がキーに指定する値となります。

バッチサーバのJavaVMのシステムプロパティに設定するパラメタ
バッチサーバのJavaVMのシステムプロパティに設定するパラメタの記載形式を次に示します。なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.propertiesで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.propertiesの<キー名称>に読み替えて設定してください。バッチサーバのJavaVMのシステムプロパティに設定できるパラメタの場合，<param-value>タグの設定値がキーに指定する値となります。バッチサーバのJavaVMのシステムプロパティは，「バッチサーバ用のユーザプロパティを設定するパラメタ」に設定できないものなどを指定する場合に使用します。

バッチサーバ用オプション定義を設定するパラメタ
バッチサーバ用オプション定義を設定するパラメタは，簡易構築定義ファイルのパラメタごとに記載形式が異なります。

add.jvm.argの場合
add.jvm.argの場合の記載形式を次に示します。
形式

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタの指定内容を次に示します。
<param-name>タグ
　add.jvm.arg
<param-value>タグ
　（設定値）

usrconf.cfgで直接編集する場合は，形式中に太字で示す「add.jvm.arg」をusrconf.cfgの<キー名称>に読み替えて設定してください。「add.jvm.arg」の場合，<param-value>タグのパラメタ値（（設定値））がキーに指定する値となります。

add.jvm.arg以外の場合
add.jvm.arg以外の場合は，バッチサーバ用のユーザプロパティを設定するパラメタと記載形式は同じです。usrconf.cfgで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.cfgの<キー名称>に読み替えて設定してください。add.jvm.arg以外の場合，<param-value>タグのパラメタ値がキーに指定する値となります。

バッチサーバの拡張パラメタに設定できるパラメタ
バッチサーバの拡張パラメタに設定できるパラメタの記載形式を次に示します。なお，形式1は，文章中や，設定するパラメタが一つの場合の形式で，形式2は，表中や，設定するパラメタが複数の場合の形式です。

形式1

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>の<configuration>タグ内に，<パラメタ名>パラメタで<設定内容の説明>を指定します。

形式2

<論理サーバ名（簡易構築定義ファイルの<logical-server-type>の指定値）>タグ内に次のパラメタを指定します。

<パラメタ名>

：

usrconf.cfgで直接編集する場合は，形式中に太字で示す<パラメタ名>をusrconf.cfgの<キー名称>に読み替えて設定してください。バッチサーバの拡張パラメタに設定できるパラメタの場合，<param-value>タグの設定値がキーに指定する値となります。バッチサーバの拡張パラメタは，「バッチサーバ用オプション定義を設定するパラメタ」に設定できないものなどを指定する場合に使用します。

12.2　バッチサーバで設定できる主な項目

バッチサーバを構築する場合，バッチサーバの動作設定として必ず設定する項目と，必要に応じて設定する項目があります。この節では，バッチサーバで設定する項目について説明します。

＜この節の構成＞

12.2.1　バッチサーバの動作設定として必ず設定する項目

12.2.2　バッチサーバの動作設定として必要に応じて設定する項目

12.2.1　バッチサーバの動作設定として必ず設定する項目

バッチサーバを構築する場合には，動作設定で必ず設定しなければならない項目があります。バッチサーバの動作設定で必ず設定する項目を次の表に示します。

表12-2　バッチサーバの動作設定で必ず設定する項目（簡易構築定義ファイル）

項目
設定内容

バッチサーバとしてサーバを構築するための設定
バッチサーバとしてサーバを構築するには，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

batch.service.enabled
バッチサーバとして構築するかどうかを指定します。パラメタの値は必ずtrueを指定してください。

SecurityManagerを使用しない設定
バッチサーバの場合，SecurityManagerは使用しません。SecurityManagerを使用しない設定をするには，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

use.security
バッチサーバの起動時にSecurityManagerを使用するかどうかを指定します。パラメタの値は必ずfalseを指定してください。

ライトトランザクション機能を有効にするための設定
バッチサーバの場合，ローカルトランザクションを使用します※。このため，ローカルトランザクションに最適化された環境を提供する，ライトトランザクション機能を使用します。
ライトトランザクション機能は次のパラメタで有効にします。

ejbserver.distributedtx.XATransaction.enabled

ただし，デフォルトの設定ではライトトランザクションが有効になっています。このため，このプロパティの設定を変更しないでください。このパラメタを設定する場合は，必ずfalseを指定してください。

注※　バッチサーバの場合，グローバルトランザクションは使用できません。

12.2.2　バッチサーバの動作設定として必要に応じて設定する項目

ここでは，マニュアル「Cosminexus　機能解説」で説明した機能を使用するために設定する項目を，次の分類に分けて説明します。機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

EJBアクセス機能を使用するための設定

ネーミング管理の機能を使用するための設定

リソース接続とトランザクション管理の機能を使用するための設定

ガーベージコレクション制御機能を使用するための設定

コンテナ拡張ライブラリの機能を使用するための設定

システムの日常運用の支援機能を使用するための設定

システムの保守支援機能を使用するための設定

システムの監査支援機能を使用するための設定

なお，ここでは，バッチサーバの動作設定でユーザ定義ファイルを編集して設定できる項目のうち，主な項目とその項目を設定するユーザ定義ファイル，および各ファイルのパラメタやキーについて説明します。ユーザ定義ファイルのうち，簡易構築定義ファイルとパラメタの詳細，およびここで説明していないパラメタについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。簡易構築定義ファイル以外のユーザ定義ファイルとキーの詳細，およびここで説明していないキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ポイント

リソースの設定をする場合は，サーバ管理コマンドまたはServer Plug-inを使用します。ここではサーバ管理コマンドで使用する属性ファイルとタグについて説明します。

Server Plug-inを使用する場合，属性ファイルのタグに対応した項目に設定します。属性ファイルのタグと対応する画面，サーバ管理コマンドとServer Plug-inでの操作および設定項目については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

＜この項の構成＞

(1)　EJBアクセス機能を使用するための設定

(2)　ネーミング管理の機能を使用するための設定

(3)　リソース接続とトランザクション管理の機能を使用するための設定

(4)　ガーベージコレクション制御機能を使用するための設定

(5)　コンテナ拡張ライブラリの機能を使用するための設定

(6)　システムの日常運用の支援機能を使用するための設定

(7)　システムの保守支援機能を使用するための設定

(8)　システムの監査支援機能を使用するための設定

(1)　EJBアクセス機能を使用するための設定

EJBアクセス機能を使用するためには，簡易構築定義ファイルに次の表に示す内容を設定します。

表12-3　EJBアクセス機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

RMI-IIOP通信のタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.rmi.request.timeout※1
RMI-IIOP通信のクライアントとサーバ間の通信タイムアウト時間を指定します。

リモートインタフェースでの通信障害発生時のEJBクライアントの動作
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.rebindpolicy※2
EJBメソッドの呼び出し時に通信障害が発生した場合のバッチサーバ側でのコネクションの再接続動作とリクエストの再送動作を指定します。

バッチサーバの通信ポートとIPアドレスの固定
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

vbroker.se.iiop_tp.scm.iiop_tp.listener.port※1
バッチサーバの通信ポートを指定します。

vbroker.se.iiop_tp.host※1
バッチサーバの使用するIPアドレスまたはホスト名を固定するかどうかを指定します。

注※1　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，バッチサーバのJavaVMのシステムプロパティに設定します。

(2)　ネーミング管理の機能を使用するための設定

ネーミング管理の機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表12-4　ネーミング管理の機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

基本設定
デフォルトの設定では，バッチサーバはホスト名「localhost」，ポート番号「900」のCORBAネーミングサービスをインプロセスで自動起動して使用します。設定を変更したい場合には，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.naming.host
CORBAネーミングサービスのホスト名を指定します。※1

ejbserver.naming.port
CORBAネーミングサービスのポート番号を指定します。※1

ラウンドロビン検索※2
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.namingservice.group.list※1
CORBAネーミングサービスのグループを指定します。

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls※1
各グループに属する，CORBAネーミングサービスのルート位置を指定します。

java.naming.factory.initial※1
InitialContextFactoryの実装をデレゲートしているクラスを指定します。

ネーミングのキャッシング
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.cache※1
ネーミングでのキャッシングを有効にするかどうかを指定します。

ejbserver.jndi.cache.interval※1
キャッシュクリアの間隔を指定します。

ejbserver.jndi.cache.interval.clear.option※1
キャッシュクリアの範囲を指定します。

キャッシュを定期的にクリアするときの設定例（物理ティアの定義の場合）を次に示します。

（例）

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.jndi.cache</param-name>
   <param-value>on</param-value>
 </param>
 <param>
   <param-name>ejbserver.jndi.cache.interval</param-name>
   <param-value>60</param-value>
 </param>
 <param>
   <param-name>ejbserver.jndi.cache.interval.clear.option</param-name>
   <param-value>check</param-value>
 </param>
 ：
</configuration>

ネーミングサービスの通信タイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jndi.request.timeout※1
ネーミングサービスとの通信タイムアウト時間を指定します。

注※1　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

注※2　ラウンドロビン検索は，ユーザ指定名前空間機能を使用していることが前提になります。ユーザ指定名前空間機能を使用する場合，サーバ管理コマンドの動作設定のカスタマイズが必要です。設定方法については，「9.2.2　サーバ管理コマンドの動作設定のカスタマイズ」を参照してください。

(3)　リソース接続とトランザクション管理の機能を使用するための設定

リソース接続とトランザクション管理の機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表12-5　リソース接続とトランザクション管理の機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

トランザクションのタイムアウト
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.jta.TransactionManager.defaultTimeOut※1
トランザクションのタイムアウト時間を指定します。

Application Serverが管理するトランザクションの外でコネクションシェアリングの有効化
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled※2
アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときの，コネクションシェアリングの動作を指定します。

コネクションアソシエーション
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.connectionpool.association.enabled※1
コネクションアソシエーション機能を使用するかどうかを指定します。

DataSourceオブジェクトのキャッシング
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.jndi.cache.reference※2
DataSourceオブジェクトのキャッシングを有効にするかどうかを指定します。

DB Connectorのコンテナ管理でのサインオンの最適化
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.connectionpool.applicationAuthentication.disabled※2
コンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。

トランザクションタイムアウト（バッチサーバ単位）
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.jta.TransactionManager.defaultTimeOut※1
バッチサーバ上で開始されるトランザクションのタイムアウトのデフォルト値を指定します。

注※1　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

注※2　簡易構築定義ファイルの，バッチサーバのJavaVMのシステムプロパティに設定します。

(4)　ガーベージコレクション制御機能を使用するための設定

ガーベージコレクション制御機能を使用するためには，簡易構築定義ファイルに設定します。

論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

ejbserver.batch.gc.watch.threshold
ガーベージコレクションを実行する条件となるメモリ使用量のしきい値を指定します。

ejbserver.batch.gc.watch.thresholdは，簡易構築定義ファイルの，バッチサーバのJavaVMのシステムプロパティに設定します。

(5)　コンテナ拡張ライブラリの機能を使用するための設定

コンテナ拡張ライブラリの機能を使用するためには，簡易構築定義ファイルに設定します。

論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

add.class.path
コンテナ拡張ライブラリのJARファイルのパスを指定します。

add.library.path
JNI用ライブラリの検索パスを指定します。

これらのパラメタは，簡易構築定義ファイルのバッチサーバの拡張パラメタに設定します。

コンテナ拡張ライブラリの機能を使用するための設定方法については，「4.10　コンテナ拡張ライブラリの設定」を参照してください。

(6)　システムの日常運用の支援機能を使用するための設定

システムの日常運用の支援機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表12-6　システムの日常運用の支援機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

リソース枯渇監視機能
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watchから始まるパラメタ※で，リソース枯渇監視機能の使用の有無，リソースの監視間隔やしきい値などを指定します。なお，リソースの種別によっては，リソースの監視間隔やしきい値は，サーバ管理コマンドで指定します。設定方法については，「12.3　リソース枯渇監視の設定」を参照してください。

稼働情報収集機能
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.managementから始まるパラメタ※で，稼働情報の取得レベル，収集間隔，稼働情報ファイルの出力先，イベントを発行するためのしきい値や監視間隔などを指定します。
設定方法については，「12.4　稼働情報ファイルの取得とイベント発行の設定」を参照してください。
また，イベント発行時に出力されるメッセージを利用してManagementイベントを発行することもできます。Managementイベントの設定については，「14.1　Managementイベントによる処理の自動実行の設定」を参照してください。

Managementイベントによる処理の自動実行
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.manager.agent.MEventAgent.enabled※
Managementイベントの発行を有効にするかどうかを指定します。

このほかに，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，manager.meventから始まるパラメタ※で，Managementイベント発行時の動作を設定します。設定方法については，「14.1　Managementイベントによる処理の自動実行の設定」を参照してください。

注※　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

(7)　システムの保守支援機能を使用するための設定

システムの保守支援機能を使用するためには，簡易構築定義ファイルに設定します。設定内容を次の表に示します。

表12-7　システムの保守支援機能を使用するための設定（簡易構築定義ファイル）

項目
設定内容

アプリケーションのユーザログ出力※
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.applicationから始まるパラメタで，バッチアプリケーションのユーザログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定します。設定方法については，「13.5　アプリケーションのユーザログ出力の設定」を参照してください。

バッチサーバのログ出力※
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejb.server.log.directory
バッチサーバのログの出力先ディレクトリを指定します。

ejbserver.loggerから始まるパラメタ
バッチサーバのログのファイルサイズ，ファイル面数，出力レベルなどを指定します。

設定方法については，「13.4　バッチサーバのログ取得の設定」を参照してください。

注※　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

(8)　システムの監査支援機能を使用するための設定

システムの監査支援機能を使用するためには，簡易構築定義ファイルおよび監査ログファイルに設定します。設定内容を次の表に示します。

表12-8　システムの監査支援機能を使用するための設定（簡易構築定義ファイル，監査ログファイル）

項目
設定個所
設定内容

データベース監査証跡との連携
簡易構築定義ファイル※
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定します。

ejbserver.container.audit_trail.enabled
データベース監査証跡連携機能を有効にするかどうかを指定します。

設定方法については，J2EEサーバの場合と同じです。詳細は，「4.15　データベース監査証跡との連携の設定」を参照してください。

監査ログ出力
監査ログ定義ファイル
監査ログ定義ファイルに，監査ログを出力するかどうかを指定します。設定方法については，J2EEサーバの場合と同じです。詳細は，「4.16　監査ログ出力の設定」を参照してください。

注※　簡易構築定義ファイルの，バッチサーバのJavaVMのシステムプロパティに設定します。

12.3　リソース枯渇監視の設定

リソースの監視間隔やしきい値を指定してリソースを監視し，しきい値を超えた場合にアラートを出力できます。また，リソース枯渇監視情報をファイルに出力できます。

バッチサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプ，およびコネクションプールです。なお，Windows，AIXでは，ファイルディスクリプタは監視できません。また，Linuxではスレッド数を監視できません。

リソース枯渇監視機能を使用するためには，次の二つの設定が必要です。

リソース枯渇監視機能の有効化

リソース種別ごとの監視の設定

この節では，これらのリソース枯渇監視機能を使用するための設定について説明します。

＜この節の構成＞

(1)　リソース枯渇監視機能の有効化

(2)　リソース種別ごとの監視の設定

(1)　リソース枯渇監視機能の有効化

デフォルトの設定では，リソース枯渇監視機能は有効になっているので，設定は不要です。簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，ejbserver.watch.enabledパラメタにtrue（リソース枯渇監視機能を有効にする）が指定されていて，すべてのリソースが監視されるようになっています。なお，リソース枯渇監視機能を無効にしたい場合には，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，ejbserver.watch.enabledパラメタにfalse（リソース枯渇監視機能を無効にする）を指定してください。

(2)　リソース種別ごとの監視の設定

デフォルトの設定では，監視対象となるすべてのリソースにしきい値や監視間隔の時間などが設定されています。また，監視結果のリソース枯渇監視ログファイルへの出力も有効になっています。リソース枯渇監視の設定を変更したい場合には，次の方法で設定を変更してください。

次に示すリソースについては，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，各リソースの監視の設定をします。

メモリ

ファイルディスクリプタ

スレッド数

スレッドダンプ

次に示すリソースについては，サーバ管理コマンドを使用して，リソースアダプタ単位で，各リソースの監視の設定をします。

コネクションプール

ただし，リソース枯渇監視ログファイルの面数とサイズは，usrconf.propertiesで指定します。

リソース種別ごとの監視の設定を次の表に示します。

表12-9　リソース種別ごとの監視の設定

リソース種別
設定個所
設定内容

メモリ
簡易構築定義ファイル※1
バッチサーバ単位で，メモリ監視の設定をします。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.memoryから始まるパラメタで，メモリ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。※2

ファイルディスクリプタ
バッチサーバ単位で，ファイルディスクリプタ監視の設定をします。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.fileDescriptorから始まるパラメタで，ファイルディスクリプタ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

スレッド数
バッチサーバ単位で，スレッド数監視の設定をします。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.threadから始まるパラメタで，スレッド数監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

スレッドダンプ
バッチサーバ単位で，スレッドダンプ監視の設定をします。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.threaddumpから始まるパラメタで，スレッドダンプ監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。また，ejbserver.logger.channels.defineから始まるパラメタで，ファイルの面数，サイズを指定します。

コネクションプール
サーバ管理コマンド
リソースアダプタ単位でコネクションプール監視の設定をします。
Connector属性ファイルの<property-name>タグとして指定する<WatchEnabled>，<WatchThreshold>，<WatchInterval>，<WatchWriteFileEnabled>タグで，コネクションプール監視によるアラート出力の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。
リソースアダプタをデプロイしたあとで，サーバ管理コマンドのcjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させてください。※3

簡易構築定義ファイル※1
バッチサーバ単位で，リソース枯渇監視ログファイルの面数，サイズを指定します。

注※1　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

注※2　メモリ監視をする場合は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，JavaVM起動パラメタを定義します。JavaVM起動パラメタには，-XX:PermSizeと-XX:MaxPermSizeを指定し，メモリサイズは同じにすることをお勧めします。メモリサイズに異なる値を指定した場合，Permanent領域の領域拡張でもアラートが出力されることがあります。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:PermSize=（設定値）

-XX:MaxPermSize=（設定値）

また，フルガーベージコレクションの予兆を検知をするためには，JavaVMのOld領域，New領域のサイズをチューニングする必要があります。

注※3　リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

なお，リソース枯渇監視ログファイルのファイルの面数，サイズは，簡易構築定義ファイルの次に示すパラメタで指定します。

ejbserver.logger.channels.define.<監視リソース名>WatchLogFile.filenum
リソース種別ごとにリソース枯渇監視ログファイルのファイル数を指定します。

ejbserver.logger.channels.define.<監視リソース名>WatchLogFile.filesize
リソース種別ごとにリソース枯渇監視ログファイルのファイルサイズを指定します。

これらのパラメタの監視リソース名には，リソース種別ごとのチャネル名を指定します。

メモリの場合：MemoryWatchLogFile

ファイルディスクリプタの場合：FileDescriptorWatchLogFile

スレッド数の場合：ThreadWatchLogFile

スレッドダンプの場合：ThreaddumpWatchLogFile

コネクションプールの場合：ConnectionPoolWatchLogFile

12.4　稼働情報ファイルの取得とイベント発行の設定

稼働情報の収集機能では，バッチサーバの稼働状態を定期的に監視して，バッチサーバの各機能から出力されるサーバ性能やリソースの情報などの稼働情報を取得できます。バッチサーバの各機能から出力される稼働情報を収集して，稼働情報ファイルに出力できます。また，稼働情報の監視対象にしきい値を設定しておくと，監視対象がしきい値を超えたときにイベントを発行することができます。この節では，稼働情報ファイルを取得するための設定と，イベントを発行するための設定について説明します。

稼働情報ファイルを出力する場合のデフォルトの出力先を次に示します。なお，作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで指定します。

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/stats

デフォルトの設定では，バッチサーバが出力した稼働情報が収集されて，稼働情報ファイルに出力されます。また，稼働情報の監視対象がしきい値を超えたときにイベントが発行されます。稼働情報ファイルの出力先や面数を変更したい場合や，稼働情報のしきい値や監視間隔を変更したい場合には，簡易構築定義ファイルで設定を変更してください。稼働情報ファイルの収集とイベントの発行に必要な設定を次の表に示します。

表12-10　稼働情報ファイルの収集とイベントの発行に必要な設定

分類 | 設定個所 | 設定内容
稼働情報収集間隔 | 簡易構築定義ファイル※ | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.statistics.intervalパラメタで，稼働情報を取得する間隔（秒）を指定します。
稼働情報ファイルの出力 | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.enabledパラメタで，稼働情報ファイルを出力するかどうかを指定します。デフォルトはtrueです。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.dirパラメタで，稼働情報ファイルの出力先ディレクトリを指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.numパラメタで，稼働情報ファイルの面数を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.periodパラメタで，稼働情報ファイルの面を切り替える時間間隔（時間）を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.stats_file.base_timeパラメタで，稼働情報ファイルの面を切り替える基点の時間を指定します。
イベント発行（フルガーベージコレクション回数の監視） | 論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.enabledパラメタで，フルガーベージコレクション回数の監視を有効にするかどうかを指定します。デフォルトはtrueです。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.thresholdパラメタで，フルガーベージコレクション回数の監視でのしきい値を指定します。
論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.management.JVM.stats_monitor.FullGCCount.intervalパラメタで，フルガーベージコレクション回数の監視でのしきい値監視の間隔を指定します。

注※　簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

13.　トラブルシューティングの資料取得の設定（バッチアプリケーションを実行するシステム）

この章では，バッチアプリケーションを実行するシステムでのトラブルシューティングの資料を取得するための設定方法について説明します。トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。

＜この章の構成＞

13.1　資料取得の設定の概要

13.2　snapshotログ収集の設定

13.3　障害検知時コマンドによる資料取得の設定

13.4　バッチサーバのログ取得の設定

13.5　アプリケーションのユーザログ出力の設定

13.1　資料取得の設定の概要

トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログなどは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。この節では，トラブルシューティングに必要な資料と，その概要について説明します。

また，デフォルトの設定で取得できるようになっている資料については，特に設定は不要ですが，ログの出力先やサイズなどを変更したい場合には，簡易構築定義ファイルやユーザ定義ファイルを編集して，設定を変更してください。

トラブルシューティングの資料取得のための設定を次の表に示します。

表13-1　トラブルシューティングの資料取得のための設定

資料の種類
資料取得のための設定
設定の要否
設定方法の参照先

snapshotログ
snapshotログの収集先，収集方法や収集のタイミングを変更する場合には，ユーザ定義ファイルを編集します。
△
13.2，13.3

Management Serverのログ
mserver.properties（Management Server環境設定ファイル）で，ログの出力レベルや，ログファイルの面数などを設定します。
△
5.4※

性能解析トレースファイル
mserver.properties（Management Server環境設定ファイル）で，性能解析トレースファイルの面数を設定します。
また，簡易構築定義ファイルで，論理パフォーマンストレーサ（performance-tracer）の<configuration>タグ内に，パフォーマンストレーサのトレース取得レベルや，PFRトレースファイルの面数などを指定します。
△
5.5※

バッチサーバのログ
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数などを設定します。
また，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledで，システムログ出力の設定が有効になっている場合，バッチサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合，syslog）に出力されます。
△
13.4

アプリケーションのユーザログ
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ロガーやハンドラの設定，ログの出力レベル，サイズ，面数などを設定します。また，server.policyで，セキュリティポリシーを設定します。
○
13.5

稼働情報ファイル
簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，稼働情報ファイルの出力先や面数などを設定します。
△
12.4

Cosminexus Managerのログ
manager.cfgで統合ログの面数やサイズを指定します。
△
5.11※

コンソールログ
adminagent.propertiesでコンソールログの出力の有無，面数やサイズを設定します。
△
5.12※

リソースアダプタのログ
サーバ管理コマンドを使用して，リソースアダプタ単位でのログ出力の有無を設定します。
また，簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ログの出力レベル，サイズ，面数を設定します。
△
5.13※

Cosminexus TPBrokerのトレースファイル
簡易構築定義ファイル（論理J2EEサーバ（j2ee-server）の<configuration>タグ内），サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，トレースファイルの出力先や面数などを設定します。
△
5.14※

Cosminexus DABroker Libraryのログ
環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルで，ログファイルサイズなどを設定します。
△
5.15※

OSの統計情報
Windowsの場合，Windowsのシステムモニタでシステムリソースのパフォーマンスデータ取得の設定をします。
○
5.16※

ユーザダンプ
Windowsの場合，ワトソン博士で，ユーザダンプ取得の設定をします。
○
5.17※

coreダンプ
UNIXの場合，簡易構築定義ファイルやシェルコマンドで，coreファイル取得の設定をします。
○
5.18※

JavaVMの資料
簡易構築定義ファイルで，JavaVMのスレッドダンプや日立固有のJavaVMログ（日立JavaVMログファイル）の出力方法や出力内容などの設定をします。
○
5.19※

サーバ管理コマンドのログ
サーバ管理コマンド用のusrconf.bat（UNIXの場合はusrconf）とusrconf.propertiesで，ログの出力レベルなどを設定できます。
△
9.2.2(3)

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

注※　J2EEサーバの場合と設定方法に差異はありません。参照先の記述の「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

この表に示したログは，snapshotログで一括収集できます。ただし，Cosminexus TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。また，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）については，固定のファイル名に対して収集します。障害発生時に収集するためには，ユーザ作成の障害検知時コマンドを利用する必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

13.2　snapshotログ収集の設定

システムの構成ソフトウェアがトラブル発生時にそのときの状態を出力したログを，snapshotログといいます。snapshotログには，各種構成ソフトウェアのログのほかに，スレッドダンプ，性能解析トレースなど，システム保守に必要な情報とアプリケーション保守に必要な情報が含まれます。Cosminexusで構築したシステムでは，これらの情報をsnapshotログとして一括収集し，ZIP形式のログファイルとして取得できます。

なお，snapshotlogコマンドで収集できるsnapshotログと，Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログでは，デフォルトの状態で収集できるファイルが異なります。Management Serverの運用管理コマンド（mngsvrutil）などで収集できるsnapshotログは，デフォルトの状態でインストール情報やOSの状態・ログなどを収集できますが，snapshotlogコマンドでインストール情報やOSの状態・ログなどを収集するためには，コマンド実行時に指定するsnapshotログ収集先対象リストファイルを編集して，snapshotログの収集先を追加する必要があります。

ここでは，バッチサーバを使用している場合の，snapshotログの収集のタイミングと，デフォルトの設定で収集できる資料について説明します。なお，このほかの説明については，J2EEサーバの場合と同じです。詳細は，「5.2　snapshotログ収集の設定」を参照してください。

＜この節の構成＞

(1)　snapshotログの収集のタイミング

(2)　snapshotログで収集できるファイル

(1)　snapshotログの収集のタイミング

snapshotログの収集のタイミングと取得のための設定を次の表に示します。

表13-2　snapshotログの収集のタイミングと取得のための設定

分類
収集のタイミング
デフォルトの設定を変更するために必要な設定

自動的に収集する※
論理サーバが障害時に自動停止される直前

障害検知時コマンドの設定

snapshotログの収集先のカスタマイズ

バッチサーバが障害時に自動再起動される直前

バッチサーバを手動で一括再起動する直前

snapshotログの収集先のカスタマイズ

任意のタイミングで収集する
Management Serverの運用管理コマンド（mngsvrutil）でsnapshotログの収集を実行したとき

注※　論理サーバの停止前，またはバッチサーバの再起動前のどちらのタイミングでsnapshotログを収集するかは，mserver.propertiesのcom.cosminexus.mngsvr.snapshot.collect.pointキーで変更できます。デフォルトの設定では，論理サーバの停止前にsnapshotログが収集されます。

(2)　snapshotログで収集できるファイル

トラブルシューティングに必要な資料は，資料を保守員へ送付するときのタイミングによって，一次送付資料と二次送付資料に分類されます。snapshotログでは，一次送付資料と二次送付資料を収集できます。

デフォルトの設定で一次送付資料および二次送付資料として収集できる資料を次の表に示します。

表13-3　デフォルトの設定で一次送付資料および二次送付資料として収集できる資料

資料の種類 | 一次送付資料 | 二次送付資料
メッセージログ | ○ | ○
ユーザログ | ○ | ○
例外ログ | ○ | ○
保守用ログ | ○ | ○
性能解析トレース | － | ○※1
JavaVMのスレッドダンプ | ○※1 | ○※1
JavaVMのガーベージコレクションのログ | ○ | ○
メモリダンプ | － | ○
JavaVMログファイル | ○ | ○
エラーリポートファイル | ○ | ○
OSの状態・ログ | ○ | ○
OSの統計情報 | ○ | ○
定義情報 | ○ | ○
作業ディレクトリ | ○ | ○
リソースの設定 | －※2 | ○
JavaVMのスタックトレース情報 | ○※1 ※3 | ○※1 ※3
稼働情報 | ○ | ○
監査ログ | － | ○

（凡例）

○：収集できる。　－：収集できない。

注

Cosminexusの各構成ソフトウェアが出力するメッセージログや保守用ログは，snapshotログのデフォルトの設定では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリだけが収集対象となっています。構成ソフトウェアのログの出力先を変更している場合には，収集先も変更してください。

注※1

システム提供の障害検知時コマンドによって取得されたものが，snapshotログとして収集されます。システム提供の障害検知時コマンドについては，「13.3　障害検知時コマンドによる資料取得の設定」を参照してください。

注※2

デフォルトの設定では，snapshotlog.confには収集先のパスが記述されていますが，コメントが付いているため収集対象外となっています。コメントを外すと収集できます。

注※3

UNIXの場合だけ取得できる資料です。

13.3　障害検知時コマンドによる資料取得の設定

障害検知時コマンドは，Management Serverで管理している論理サーバにトラブルが発生した場合に，システムによって実行されるコマンドです。この節では，トラブルシューティングの資料を障害検知時コマンドで取得するための設定について説明します。障害検知時コマンドを利用して，トラブル発生時のスレッドダンプやユーザダンプの取得などの処理を実行することで，トラブル発生時のタイムリーな資料を取得できるようになります。また，障害検知時コマンドを利用している場合，次のどちらかのタイミングでsnapshotログを自動収集することもできます。

論理サーバにトラブルが発生した場合，障害検知時コマンドが実行されて，論理サーバの停止前にsnapshotログが収集されます。

バッチサーバにトラブルが発生した場合，障害検知時コマンドが実行されて，バッチサーバの再起動前にsnapshotログが収集されます。

障害検知時コマンドで取得した資料はsnapshotログとして収集できます。

デフォルトの設定では，論理サーバにトラブルが発生した場合にシステム提供の障害検知時コマンドが実行されて，スレッドダンプや性能解析トレースなどが取得されます。また，トラブルが発生した論理サーバの停止前にsnapshotログが収集されます。

システム提供の障害検知時コマンドで取得できる情報について，次の表に示します。

表13-4　システム提供の障害検知時コマンドで取得できる情報

論理サーバ
OS
取得できる情報

プロセスダウンを検出した場合
ハングアップを検出した場合

論理パフォーマンストレーサ
Windows
UNIX

バッファの内容を出力したPRFトレースファイル

－

論理J2EEサーバ
Windows

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

UNIX

JavaVMのスタックトレース情報

性能解析トレースファイル

スレッドダンプ

性能解析トレースファイル

なお，障害検知時コマンドには，システムで提供しているコマンドとユーザが作成したコマンドの2種類があります。障害検知時コマンドの詳細については，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。

システム提供の障害検知時コマンドの動作設定を変更する場合，またはユーザ作成の障害検知時コマンドを利用する場合に必要な設定については，「5.3　障害検知時コマンドによる資料取得の設定」を参照してください。その際に，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

注意

ユーザ作成の障害検知時コマンドで取得した資料をsnapshotログとして収集するためには，その資料の取得先をsnapshotログの収集先に追加する必要があります。snapshotログの収集先の追加については，「5.2(3)　snapshotログの収集先のカスタマイズ」を参照してください。

13.4　バッチサーバのログ取得の設定

バッチサーバのログは，ログの出力先，ログサイズ，ログレベルを変更できます。変更できる項目と，項目に対応する簡易構築定義ファイルのパラメタを次の表に示します。なお，これらのパラメタは，簡易構築定義ファイルの，バッチサーバ用のユーザプロパティに設定します。

表13-5　バッチサーバのログ取得の設定項目

項目
対応する簡易構築定義ファイルのパラメタ

ログの出力先
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejb.server.log.directory

ログサイズ

ログファイル面数

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filenum

ログファイル1面当たりの最大サイズ

論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.channels.define.<チャネル名>.filesize

ログレベル
論理J2EEサーバ（j2ee-server）の<configuration>タグ内のejbserver.logger.enabled.*

なお，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.systemlog.enabledパラメタでtrue（デフォルト値）を指定した場合，またはこのパラメタの指定を省略した場合は，バッチサーバの起動，停止および異常終了のメッセージがイベントログ（UNIXの場合は，syslog）に出力されます。

それぞれの設定項目の詳細については，「5.6　J2EEサーバのログ取得の設定」を参照してください。その際に，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

また，簡易構築定義ファイルおよびパラメタの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

注意事項（UNIXの場合）

バッチサーバの起動，停止および異常終了のメッセージをsyslogに出力するためには，syslogの設定で，facility「daemon」に対するpriorityを「info」または「debug」に設定する必要があります。また，syslogのログ出力先およびログファイル名は，syslogの設定に依存します。

syslogおよびsyslogの設定に関する詳細については，OS付属のマニュアルで，syslogdまたはsyslog.confの説明を参照してください。

13.5　アプリケーションのユーザログ出力の設定

Cosminexusでは，日立トレース共通ライブラリを使用して，バッチアプリケーションが出力するログをCosminexusの構成ソフトウェアが出力するログと同じ形式（日立トレース共通ライブラリ形式）で出力できます。これによって，システムのログとバッチアプリケーションのログを同じ形式で扱うことができるようになり，システム全体のログ運用の信頼性とログ出力の性能を高められます。

なお，バッチアプリケーションのユーザログ出力の設定は，J2EEアプリケーションのユーザログと同じです。設定方法については，「5.20.1　アプリケーションのユーザログ出力の設定方法」を参照してください。ただし，バッチアプリケーションの場合，セキュリティポリシーの設定は不要です。バッチアプリケーションのログを出力しない場合は，この設定は不要です。

14.　システムの可用性を高めるための設定（バッチアプリケーションを実行するシステム）

Cosminexusのシステムでは，システムの可用性を高めるために，障害によるシステムダウンを防止する機能を提供しています。

この章では，Managementイベントによる処理の自動実行の設定方法について説明します。

＜この章の構成＞

14.1　Managementイベントによる処理の自動実行の設定

14.1　Managementイベントによる処理の自動実行の設定

障害によるシステムダウンを防止するために，バッチサーバではManagementイベントによる処理の自動実行の機能を使用できます。これによって，バッチアプリケーションを実行するシステムの可用性を高めることができます。

Managementイベントは，運用管理ドメイン内のバッチサーバで発生する障害やリソース枯渇などの事象をManagement Serverに通知するためのイベントです。バッチサーバが稼働中に出力するすべてのメッセージを契機にしてManagementイベントを発行できます。Management Server側では，Managementイベントが通知されたときの動作を定義しておくことで，Managementイベントが発生すると自動的にアクションを実行できるようになります。このアクションをManagementアクションといいます。

Managementイベントを使用して障害などの事象を検知し，Managementイベントに対応する動作をManagementアクションとして定義しておくことで，障害を回避するための対処など，発生した事象に対する処理を自動的に実行できるようになります。

＜この節の構成＞

14.1.1　Managementイベントによる処理の自動実行の設定手順

14.1.2　Managementイベント発行機能を利用する各機能の設定

14.1.1　Managementイベントによる処理の自動実行の設定手順

Managementイベントによる処理の自動実行は，次の手順で設定してください。

Managementイベント発行の設定をします。
Managementイベントの発行を有効にして，Managementイベント発行時の動作を設定します。設定方法については，「6.3.2　Managementイベント発行の設定」を参照してください。※

Managementイベント発行用メッセージIDリストファイルを設定します。
リストファイルで，Managementイベント発行対象となるメッセージを指定します。設定方法については，「6.3.3　Managementイベント発行用メッセージIDリストファイルの設定」を参照してください。※

Managementイベント発行機能を利用する各機能の設定をします。
Managementイベント発行機能を利用して，Management ServerにManagementイベントを通知する機能の設定をします。
次に，設定したManagementイベントに対応するManagementアクションを実行するための設定をします。
設定方法については，「14.1.2　Managementイベント発行機能を利用する各機能の設定」を参照してください。

Managementアクション実行用プロパティファイルを設定します。
プロパティファイルで，Managementアクションの定義，メッセージIDとManagementアクションとのマッピングなどをします。設定方法については，「6.3.5　Managementアクション実行用プロパティファイルの設定」を参照してください。※

Managementアクション実行コマンドの設定をします。
Managementアクションとして実行するコマンドを記述するコマンドファイル（バッチファイルまたはシェルスクリプトファイル）を作成します。設定方法については，「6.3.6　Managementアクション実行コマンドの設定」を参照してください。※ただし，バッチサーバの場合，CTMによるリクエストのスケジューリングは使用できないため，CTMに関する記述は該当しません。

注※　参照先の「J2EEサーバ」に関する説明を「バッチサーバ」に置き換えてお読みください。

14.1.2　Managementイベント発行機能を利用する各機能の設定

Managementイベントを発行する機能の設定をしてください。

ここでは，例として，リソース枯渇監視機能でManagementイベントを発行させるために必要な設定について説明します。リソースの監視間隔やしきい値を指定してリソースを監視し，しきい値を超えた場合にManagementイベントが発行されるように設定します。

バッチサーバの場合，監視対象にできるリソースは，メモリ，ファイルディスクリプタ，スレッド数，スレッドダンプ，コネクションプールです。なお，Windows，AIXでは，ファイルディスクリプタは監視できません。また，Linuxではスレッド数を監視できません。

リソース枯渇監視機能を使用するためには，次の二つの設定が必要です。

リソース枯渇監視機能の有効化

リソース種別ごとのManagementイベント発行の設定

＜この項の構成＞

(1)　リソース枯渇監視機能の有効化

(2)　リソース種別ごとのManagementイベント発行の設定

(1)　リソース枯渇監視機能の有効化

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.watch.enabledパラメタでリソース枯渇監視機能を使用するかどうかを指定します。デフォルトの設定では，リソース枯渇監視機能の使用が有効になっていて，すべてのリソースが監視されるようになっています。

(2)　リソース種別ごとのManagementイベント発行の設定

デフォルトの設定では，監視対象となるすべてのリソースにデフォルトのしきい値が設定されていて，そのしきい値を超えた場合にManagementイベントが発行されるようになっています。Managementイベント発行の設定を変更したい場合には，次の方法で設定を変更してください。

次に示すリソースについては，簡易構築定義ファイルで，各リソースの監視の設定やリソースの監視によるManagementイベント発行の有無などを指定します。

メモリ

ファイルディスクリプタ

スレッド数

スレッドダンプ

次に示すリソースについては，サーバ管理コマンドを使用してリソースアダプタ単位で，各リソースの監視の設定やリソースの監視によるManagementイベント発行の有無などを指定します。

コネクションプール

ただし，リソース枯渇監視ログファイルの面数とサイズは，簡易構築定義ファイルで指定します。

リソース種別ごとのManagementイベント発行の設定を次の表に示します。

表14-1　リソース種別ごとのManagementイベント発行の設定

リソース種別
設定個所
設定内容

メモリ
簡易構築定義ファイル
バッチサーバ単位で，次のパラメタに，メモリ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。※1

ejbserver.watch.memory.enabled

ejbserver.watch.memory.threshold

ejbserver.watch.memory.writefile.enabled

ejbserver.watch.memory.interval

ファイルディスクリプタ
バッチサーバ単位で，次のパラメタに，ファイルディスクリプタ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.fileDescriptor.enabled

ejbserver.watch.fileDescriptor.threshold

ejbserver.watch.fileDescriptor.writefile.enabled

ejbserver.watch.fileDescriptor.interval

スレッド数
バッチサーバ単位で，次のパラメタに，スレッド数監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.thread.enabled

ejbserver.watch.thread.threshold

ejbserver.watch.thread.writefile.enabled

ejbserver.watch.thread.interval

スレッドダンプ
バッチサーバ単位で，次のパラメタに，スレッドダンプ監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無，ファイルの面数，サイズを指定します。

ejbserver.watch.threaddump.enabled

ejbserver.server.threaddump.filenum

ejbserver.watch.threaddump.threshold

ejbserver.watch.threaddump.writefile.enabled

ejbserver.watch.threaddump.interval

コネクションプール
サーバ管理コマンド
リソースアダプタ単位で，コネクションプール監視の設定をします。
Connector属性ファイルの<property-name>タグとして指定する<WatchEnabled>，<WatchThreshold>，<WatchInterval>，<WatchWriteFileEnabled>タグで，コネクションプール監視によるManagementイベント発行の有無，監視のしきい値，監視の間隔，リソース枯渇監視ログファイルの出力の有無を指定します。サーバ管理コマンドのcjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させてください。※2

簡易構築定義ファイル
バッチサーバ単位で，次のパラメタに，リソース枯渇監視ログファイルの面数，サイズを指定します。

ejbserver.logger.channels.define.<チャネル名>※3.filenum

ejbserver.logger.channels.define.<チャネル名>※3.filesize

注※1　メモリ監視をする場合は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，JavaVM起動パラメタを定義します。JavaVM起動パラメタには，-XX:PermSizeと-XX:MaxPermSizeを指定し，メモリサイズは同じにすることをお勧めします。メモリサイズに異なる値を指定した場合，Permanent領域の領域拡張でもアラートが出力されることがあります。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:PermSize=（設定値）

-XX:MaxPermSize=（設定値）

また，フルガーベージコレクションの予兆検知をするためには，JavaVMのOld領域，New領域のサイズをチューニングする必要があります。

注※2　リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

注※3　リソース種別ごとのチャネル名を次に示します。

メモリの場合：MemoryWatchLogFile

ファイルディスクリプタの場合：FileDescriptorWatchLogFile

スレッド数の場合：ThreadWatchLogFile

スレッドダンプの場合：ThreaddumpWatchLogFile

コネクションプールの場合：ConnectionPoolWatchLogFile

15.　リソースの設定（バッチアプリケーションを実行するシステム）

この章では，リソースの設定について説明します。

＜この章の構成＞

15.1　リソース設定の概要

15.2　リソースアダプタの設定

15.1　リソース設定の概要

バッチサーバはリソースとして次に示すデータベースを利用できます。

HiRDB

Oracle

XDM/RD E2

SQL Server※
注※　SQL Serverと接続できるのはWindowsの場合だけです。

接続先のデータベースの種類によって，データベースの接続方法，使用できるJDBCドライバなどが異なります。リソースへの接続については，マニュアル「Cosminexus　機能解説」のリソースへの接続方法に関する説明を参照してください。

これらのデータベースを利用するためにはリソースアダプタを使用します。リソースアダプタを利用するには，サーバ管理コマンドまたはServer Plug-inを使用して，リソースアダプタのプロパティ設定やインポートなどの作業が必要です。リソースアダプタの設定については，「15.2　リソースアダプタの設定」を参照してください。

なお，リソースの設定をする前に，リソースの設定に関する注意事項を理解しておいてください。また，サーバ管理コマンドを使用する場合には，必要に応じて，サーバ管理コマンドの動作設定をカスタマイズしてください。リソース設定時の注意事項や，サーバ管理コマンドを使用するための動作設定については，「9.2　リソースとJ2EEアプリケーションの設定の前に」を参照してください。

15.2　リソースアダプタの設定

バッチアプリケーションからデータベースに接続するには，DB Connectorというリソースアダプタを使用します。この節では，バッチサーバで使用するリソースアダプタの設定について説明します。バッチサーバの場合，リソースアダプタは，J2EEリソースアダプタとしてデプロイして使用します。

参考

リソースアダプタがDB Connectorの場合，Cosminexusが提供するConnector属性ファイルのテンプレートファイルが使用できます。Connector属性ファイルのテンプレートファイルを使用すると，DB Connectorをインポートする前に，Connector属性ファイルを編集しておくことができます。このため，編集対象のConnector属性ファイルをサーバ管理コマンド（cjgetrarpropコマンドまたはcjgetrespropコマンド）で取得する操作が不要になります。Connector属性ファイルのテンプレートは，次の場所に格納されています。テンプレートファイルはコピーして使用してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates¥

UNIXの場合
/opt/Cosminexus/CC/admin/templates/

なお，Connector属性ファイルのテンプレートファイル，およびテンプレートファイル使用時の注意事項については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

Cosminexus 07-00よりも前のバージョンで使用していたリソースアダプタをCosminexus 07-10以降で使用する場合には，リソースアダプタの移行作業が必要です。リソースの移行方法については，「付録A.8　リソースアダプタの移行コマンドの実行」を参照してください。

＜この節の構成＞

15.2.1　リソースアダプタの設定の流れ

15.2.2　リソースアダプタの種類

15.2.3　リソースアダプタのプロパティ定義で設定できること

15.2.1　リソースアダプタの設定の流れ

リソースアダプタの設定には，サーバ管理コマンドを使用します。バッチサーバの場合，リソースアダプタは，J2EEリソースアダプタとしてデプロイして使用します。

バッチサーバで使用するリソースアダプタの新規設定の流れを次の図に示します。

図15-1　バッチサーバで使用するリソースアダプタの新規設定の流れ

図中の1.～4.について説明します。

サーバ管理コマンドを使用してリソースアダプタをインポートします。
cjimportresコマンドを使用して，リソースアダプタをインポートします。
インポートするリソースアダプタについては，「15.2.2　リソースアダプタの種類」を参照してください。

サーバ管理コマンドを使用してリソースアダプタをデプロイします。
cjdeployrarコマンドを使用して，リソースアダプタをデプロイします。
リソースアダプタは，デプロイするとJ2EEリソースアダプタとして使用できます。J2EEリソースアダプタとは，バッチサーバに共有スタンドアロンモジュールとして配備したリソースアダプタのことです。サーバ管理コマンドでインポートしたリソースアダプタをデプロイすると，バッチサーバ上で使用できるようになります。

サーバ管理コマンドを使用してリソースアダプタのプロパティを定義します。
cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。
バッチサーバの場合，ユーザ指定名前空間機能を使用してリソースアダプタに別名を設定してください。ユーザ指定名前空間機能を使用した別名の設定は，リソースアダプタのプロパティで定義します。ユーザ指定名前空間機能の設定については，マニュアル「Cosminexus　機能解説」のリソースに接続するバッチアプリケーションの作成に関する説明を参照してください。
リソースアダプタのプロパティ定義で設定できる内容については，「15.2.3　リソースアダプタのプロパティ定義で設定できること」を参照してください。

サーバ管理コマンドを使用してリソースアダプタの接続テストを実施します。
cjtestresコマンドを使用して，リソースアダプタの接続テストを実施します。リソースごとの接続テストでの検証内容については，マニュアル「Cosminexus　機能解説」のリソースへの接続テストに関する説明を参照してください。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

なお，次の手順については，「9.3.1　リソースアダプタの設定の流れ（J2EEリソースアダプタとしてデプロイして使用する場合）」を参照してください。その際，「J2EEサーバ」を「バッチサーバ」に，「J2EEアプリケーション」を「バッチアプリケーション」に置き換えてお読みください。

コネクションプールのクラスタ化機能を使用する場合のリソースアダプタの設定の流れ

リソースアダプタの設定を変更する場合の流れ

リソースアダプタを入れ替える場合の流れ

参考

次のような場合，リソースアダプタをエクスポート・インポートすることで，効率良くリソースアダプタを設定できます。

開発環境で設定したリソースアダプタをエクスポートして，運用環境にインポートして使用する場合

運用環境ですでに動いているリソースアダプタをエクスポートして，増設したバッチサーバにインポートして使用する場合

エクスポートとインポートはcjexportrarとcjimportresで実行します。

なお，Application Serverのバージョンやプラットフォームが異なるホスト間では，リソースアダプタをエクスポート・インポートして使用することはできません。リソースアダプタをエクスポートするホストと，Application Serverのバージョンやプラットフォームが異なるホストでリソースアダプタを設定する場合は，リソースアダプタを新規に設定してください。

15.2.2　リソースアダプタの種類

リソースアダプタは，接続するデータベースの種類によってファイルが異なります。リソースアダプタの種類を次の表に示します。なお，バッチサーバではグローバルトランザクションは使用できません。

表15-1　バッチサーバで使用できるリソースアダプタの種類

RARファイル名 | 説明
DBConnector_HiRDB_Type4_CP.rar | HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDB，XDM/RD E2に接続する場合に選択します。
DBConnector_DABJ_CP.rar | Cosminexus DABroker Libraryを使用して，ローカルトランザクションまたはトランザクション管理なしで，HiRDB，Oracle，XDM/RD E2に接続する場合に選択します。
DBConnector_Oracle_CP.rar | Oracle JDBC Thin Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。
DBConnector_SQLServer_CP.rar | SQL Server 2000 Driver for JDBCを使用して，ローカルトランザクションまたはトランザクション管理なしで，SQL Server 2000（Windowsの場合だけ）に接続する場合に選択します。
DBConnector_SQLServer2005_CP.rar | SQL Server 2005 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，SQL Server 2005（Windowsの場合だけ）に接続する場合に選択します。
DBConnector_CP_ClusterPool_Root.rar | コネクションプールのクラスタ化機能のルートリソースアダプタです。ルートリソースアダプタに属するメンバリソースアダプタが，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。
DBConnector_Oracle_CP_ClusterPool_Member.rar | コネクションプールのクラスタ化機能のメンバリソースアダプタです。Oracle JDBC Thin Driverを使用して，ローカルトランザクションまたはトランザクション管理なしで，Oracleに接続する場合に選択します。なお，J2EEアプリケーションのリソースリファレンスに設定して使用できません。

注　新規に，DB ConnectorのRARファイルを使用する場合，Cosminexusで提供するConnector属性ファイルのテンプレートファイルを使用して，プロパティを定義できます。Connector属性ファイルのテンプレートファイルは，すべてのDB ConnectorのRARファイルに対して提供しています。提供しているテンプレートファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

15.2.3　リソースアダプタのプロパティ定義で設定できること

リソースに接続するバッチアプリケーションの場合，ユーザ指定名前空間機能を使用してリソースアダプタに別名を設定します。バッチアプリケーションからリソースアダプタをルックアップするには，ユーザ指定名前空間機能で設定した別名を使用します。ユーザ指定名前空間機能の設定については，マニュアル「Cosminexus　機能解説」のリソースに接続するバッチアプリケーションの作成に関する説明を参照してください。

また，リソースアダプタのプロパティとして設定する項目のうち，DB Connectorで設定できる主な項目と，その項目の設定方法について説明します。

リソースアダプタのプロパティは，サーバ管理コマンドまたはServer Plug-inを使用して定義します。

ここではサーバ管理コマンドで使用するConnector属性ファイルのタグについて説明します。cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させてください。なお，リソースアダプタをデプロイする前にプロパティを定義する場合は，cjgetrespropコマンドとcjsetrespropコマンドを使用してください。

Server Plug-inを使用する場合，属性ファイルのタグに対応した項目に設定します。属性ファイルのタグと対応する画面については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

機能の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

項目を設定するConnector属性ファイルのタグの詳細，サーバ管理コマンドとServer Plug-inでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ここで説明していない項目と，その項目を設定するConnector属性ファイルのタグの詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」，およびマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

DB Connectorのプロパティ定義で設定できる内容を次の表に示します。

表15-2　DB Connectorのプロパティ定義で設定できる内容

分類
項目
設定内容

一般情報
トランザクションサポートレベル
<transaction-support>タグで，トランザクションサポートレベルを設定します。トランザクション管理なし（NoTransaction），またはローカルトランザクション（LocalTransaction）を指定します。バッチサーバの場合，グローバルトランザクション（XATransaction）は指定できません。

コンフィグレーションプロパティ
データベースコネクション確立までの待ち時間
<config-property>タグのloginTimeoutで，データベースコネクション確立までのバッチアプリケーションの待ち時間を指定します。

ステートメントキャンセル
<config-property>タグのCancelStatementで，トランザクションタイムアウト発生時のステートメントキャンセルを有効にするかどうかを指定します。

PreparedStatementのプールサイズ※1
<config-property>タグのPreparedStatementPoolSizeで，PreparedStatementのプールサイズを指定します。

CallableStatementのプールサイズ※1
<config-property>タグのCallableStatementPoolSizeで，CallableStatementのプールサイズを指定します。

実行時プロパティ
コネクションの最小値と最大値
<property>タグのMinPoolSizeとMaxPoolSizeで，コネクションプールにプールするコネクションの最小値と最大値を指定します。

コネクションの障害検知
<property>タグのValidationTypeでコネクションの障害を検知するタイミングを指定し，ValidationIntervalで障害を検知する間隔を指定します。
なお，コネクションの障害検知にタイムアウトを設定する場合には，NetworkFailureTimeoutでコネクション管理スレッドの使用を有効にします。※2

コネクションの取得リトライ
<property>タグのRetryCountでコネクション取得に失敗した場合のリトライ回数を指定し，RetryIntervalでリトライ間隔を指定します。

コネクションスイーパ
<property>タグのSweeperIntervalでコネクションの自動破棄（コネクションスイーパ）が動作する間隔を指定し，ConnectionTimeoutでコネクションの最終利用時刻からコネクションを自動破棄するかどうかを判定するまでの時間を指定します。

コネクション枯渇時のコネクション取得待ち
<property>タグのRequestQueueEnableでコネクション枯渇時のコネクション取得待ちを有効にするかどうかを指定し，RequestQueueTimeoutで待ち時間を指定します。

コネクションプールのウォーミングアップ
コネクションプールのウォーミングアップ機能を使用する場合，<property>タグで，Warmupを指定します。

コネクション管理スレッド
コネクション管理スレッドを使用する場合，<property>タグで，NetworkFailureTimeoutを指定します。
コネクション管理スレッドを使用する場合，コネクションの障害検知機能，およびコネクション数調節機能のタイムアウト（どちらもタイムアウト時間は5秒で固定）を使用する設定になります。

コネクション数調節機能
<property>タグのConnectionPoolAdjustmentIntervalで，コネクション数調節機能が動作する間隔を指定します。
なお，コネクション数調節機能にタイムアウトを設定する場合には，NetworkFailureTimeoutでコネクション管理スレッドの使用を有効にします。※2

注※1　XDM/RD E2 11-01以前のバージョンの場合，ステートメントプーリング機能を利用できないため，これらのプロパティには0を指定してください。

注※2　同じキーで設定します。このため，コネクションの障害検知機能でタイムアウトを使用する場合は，コネクション数調節機能でもタイムアウトを使用する設定となります。

なお，DB Connectorを使用してデータベースに接続する場合に設定する，DB Connectorのプロパティ定義については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

16.　JP1との連携の設定

この章では，Management Serverを利用してJP1と連携し，JP1の集中監視，運用の自動化，稼働状況の分析などの機能を使用して，Cosminexus以外で構築されたシステムも含めた業務システム全体を一括管理するために必要な設定について説明します。

＜この章の構成＞

16.1　JP1との連携の設定の概要

16.2　監視ツリーの自動生成の設定

16.3　障害監視の設定

16.4　稼働性能監視の設定

16.5　ジョブによるシステムの自動運転の設定

16.6　監査ログの収集／一元管理の設定

16.1　JP1との連携の設定の概要

この節では，JP1との連携の設定の概要について説明します。

Management Serverを利用してJP1と連携することで，JP1の集中監視，システム構成の定義・管理，運用の自動化，稼働状況の分析などの機能を使用して，Cosminexus以外で構築されたシステムも含めた業務システム全体を一括管理できるようになります。JP1との連携では，業務システムの運用形態に応じて，次の設定を組み合わせて環境を構築してください。

システムの集中監視および構成情報の定義・管理の設定（JP1/IMとの連携）

システムの自動運転の設定（JP1/AJS2またはJP1/AJS2 - SOとの連携）

監査ログの収集／一元管理（JP1/NETM/Auditとの連携）

＜この節の構成＞

16.1.1　システムの集中監視および構成情報の定義・管理の設定（JP1/IMとの連携）

16.1.2　システムの自動運転の設定（JP1/AJS2，JP1/AJS2 - SOとの連携）

16.1.3　監査ログの収集／一元管理（JP1/NETM/Auditとの連携）

16.1.1　システムの集中監視および構成情報の定義・管理の設定（JP1/IMとの連携）

JP1/IMと連携することで，システムの集中監視およびシステムの構成情報の定義・管理ができます。

システムの集中監視は，業務システム全体のリソースの状態を監視することで，稼働性能を把握，調査したり，障害の発生を検知し，原因を究明して対策したりします。また，システムの構成情報の定義・管理では，構築時にシステムの構成をGUIを使用して定義したり，定義したシステム構成を管理したりします。なお，JP1/IMと連携したシステムの運用の詳細については，マニュアル「Cosminexus　機能解説」のシステムの集中監視に関する説明を参照してください。

＜この項の構成＞

(1)　JP1/IMと連携したシステムの集中監視

(2)　JP1/IMと連携したシステムの構成情報の定義・管理

(1)　JP1/IMと連携したシステムの集中監視

JP1/IMと連携してシステムを集中監視する場合の設定内容を次に示します。

監視ツリーの自動生成の設定
JP1/IMでCosminexusの障害や稼働性能を監視するために必要な設定をして，JP1/IM - Central Console※の統合スコープに表示するCosminexus用の監視ツリーを自動生成します。設定方法については，「16.2　監視ツリーの自動生成の設定」を参照してください。

障害監視の設定
JP1/IM - Central Console※の統合コンソール，またはJP1/IM - Central Scope※の統合スコープから，Cosminexusシステムで発生した障害を監視するための設定をします。設定方法については，「16.3　障害監視の設定」を参照してください。

稼働性能監視の設定
JP1/IM - Central Console※の統合コンソールとJP1/IM - Central Scope※の統合スコープを使用して，Cosminexusシステムの稼働性能を監視するための設定をします。設定方法については，「16.4　稼働性能監視の設定」を参照してください。

注※　JP1/IM - Central ConsoleとJP1/IM - Central ScopeはJP1 Version 7iの製品です。JP1 Version 8の場合，この二つの製品はJP1/IM - Managerに統合され，内部コンポーネントとして提供されています。

(2)　JP1/IMと連携したシステムの構成情報の定義・管理

システムの構成情報の定義および管理をJP1/IM - CMと連携して実施できます。JP1/IM - CMを使用すると，GUIを使用してビジュアルにシステムの構成情報を定義したり，定義した構成情報を管理したりできます。また，JP1/IM - CMでは，定義したシステムの構成情報をXMLファイルとして出力できます。このXMLファイルは，Smart Composer機能でシステムを構築するときに作成する簡易構築定義ファイルとして使用できるので，Smart Composer機能を使用したシステム構築がより簡単になります。

なお，JP1/IM - CMとの連携の概要およびSmart Composer機能については，マニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

16.1.2　システムの自動運転の設定（JP1/AJS2，JP1/AJS2 - SOとの連携）

システムの自動運転は，サーバやアプリケーションの開始や停止のスケジュールをあらかじめ定義しておくことで，効率的なリソースの配分や業務の効率化，省略化を図る運用方法です。Cosminexusでは，JP1/AJS2と連携して，自動運転をジョブに定義します。Windowsの場合には，Cosminexus用のカスタムジョブを利用してジョブを定義できます。カスタムジョブは，JP1/AJS2以外のプログラムとJP1/AJS2が連携するジョブを定義する場合に，目的のジョブを容易に作成するために使用できるジョブのテンプレートです。

JP1/AJS2と連携したシステムの運用の詳細については，マニュアル「Cosminexus　機能解説」のジョブによるシステムの自動運転に関する説明を参照してください。JP1/AJS2と連携してCosminexusシステムを自動運転化するための設定方法については，「16.5　ジョブによるシステムの自動運転の設定」を参照してください。

また，システムの自動運転は，シナリオで定義することもできます。シナリオで定義する場合は，JP1/AJS2 - SOを使用します。JP1/AJS2 - SOは，Smart Composer機能でシステム構築をしている場合にだけ連携できます。JP1/AJS2 - SOとの連携の概要およびSmart Composer機能については，マニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

16.1.3　監査ログの収集／一元管理（JP1/NETM/Auditとの連携）

JP1/NETM/Auditを使用して，Cosminexusのアプリケーションサーバ，運用管理サーバ，連携する日立オープンミドルウェア製品などが出力した監査ログを自動で収集できます。また，JP1/NETM/Auditに組み込まれているデータベースを使用して，収集した監査ログを一元管理できます。なお，JP1/NETM/Auditと連携したシステムの収集および一元管理の詳細については，マニュアル「Cosminexus　機能解説」の監査ログの収集および一元管理に関する説明を参照してください。

16.2　監視ツリーの自動生成の設定

この節では，JP1/IMの統合スコープに表示するCosminexus用の監視ツリーを自動生成するための設定について説明します。

まず，次の表に示すサーバおよびクライアントに，監視ツリーの自動生成に必要なJP1の製品またはCosminexusの製品の構成ソフトウェアをインストール，セットアップしておいてください。なお，JP1/IMと連携する場合のシステム構成については，マニュアル「Cosminexus　機能解説」のシステムの集中監視に必要なプログラムに関する説明を参照してください。

表16-1　監視ツリーの自動生成に必要な製品または構成ソフトウェア

サーバ／クライアント
製品／構成ソフトウェア

J2EEサーバ

Cosminexus Component Container

Cosminexus Manager

Cosminexusの運用管理サーバ

Cosminexus Manager

JP1/Base

JP1統合運用管理サーバ

JP1/Base

JP1/IM - Central Console※

JP1/IM - Central Scope※

運用管理クライアント

JP1/IM - View

注※　JP1/IM - Central ConsoleとJP1/IM - Central ScopeはJP1 Version 7iの製品です。JP1 Version 8の場合，この二つの製品はJP1/IM - Managerに統合され，内部コンポーネントとして提供されています。JP1 Version 8を使用する場合は，JP1/IM - Central ConsoleとJP1/IM - Central ScopeをJP1/IM - Managerに置き換えてお読みください。

Cosminexus用の監視ツリーを自動生成するための手順を次に示します。

Cosminexusの運用管理サーバで，次の作業を実施します。

Cosminexusアダプタコマンドのセットアップ（16.2.1参照）

Cosminexusアダプタコマンドの実行環境の設定（16.2.2参照）

Management Serverでの環境設定（16.2.3参照）

JP1統合運用管理サーバで，次の作業を実施します。

JP1/Baseの構成定義の作成（16.2.4参照）

運用管理クライアントで，次の作業を実施します。

監視ツリーの自動生成（16.2.5参照）

＜この節の構成＞

16.2.1　Cosminexusアダプタコマンドのセットアップ

16.2.2　Cosminexusアダプタコマンドの実行環境の設定

16.2.3　Management Serverでの環境設定

16.2.4　JP1/Baseの構成定義の作成

16.2.5　監視ツリーの自動生成

16.2.1　Cosminexusアダプタコマンドのセットアップ

監視ツリーの自動生成に使用する定義情報を収集するために，JP1/Baseによって実行されるCosminexusアダプタコマンドをJP1/Baseに登録します。

Cosminexusの運用管理サーバでmngsvr_adapter_setupコマンドを実行して，JP1/Baseの環境にCosminexus用のアダプタコマンド設定ファイルを追加します。なお，mngsvr_adapter_setupコマンドを実行するユーザにはAdministrator権限（UNIXの場合は，root権限）が必要です。mngsvr_adapter_setupコマンドの実行例を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvr_adapter_setup -i -t IM_CS

UNIXの場合
/opt/Cosminexus/manager/bin/mngsvr_adapter_setup -i -t IM_CS

mngsvr_adapter_setupコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

16.2.2　Cosminexusアダプタコマンドの実行環境の設定

Cosminexusアダプタコマンドを実行するための環境は，Management Serverの運用管理コマンドであるmngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）に設定します。

Cosminexusの運用管理サーバで，OSユーザ（SYSTEMユーザ）のホームディレクトリ（UNIXの場合は，JP1/Baseを起動したOSユーザのホームディレクトリ）に，クライアント側定義ファイルを作成して，次のパラメタを指定します。

mngsvrutil.connect.host
Management Serverのホスト名とポート番号を指定します。

mngsvrutil.connect.userid
Management Serverのmngsvrctl setupコマンドで設定した管理ユーザIDを指定します。

mngsvrutil.connect.password
Management Serverのmngsvrctl setupコマンドで設定したパスワードを指定します。パスワードを設定していない場合，このパラメタの指定は省略できます。

クライアント側定義ファイルは，mngsvrutilコマンドのオプションのデフォルト値を設定するファイルです。なお，mngsvrutilコマンドの実行環境を変更したい場合は，Management Serverの運用管理コマンドであるmngsvrutilコマンドのサーバ側定義ファイル（mngsvrutil.properties）で変更します。

コマンドおよびファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

参考

クライアント側定義ファイルはクライアントごとに個別のデフォルト値を設定する場合に使用します。すべてのクライアント共通のデフォルト値を設定したい場合は，クライアント側共通設定ファイル（mngsvrutilcl.properties）を使用してください。なお，両方のファイルを使用している場合は，クライアント側定義ファイルが適用されます。クライアント側共通設定ファイルは読み込まれません。

16.2.3　Management Serverでの環境設定

監視ツリーを自動生成する前に，Management Serverで次の設定をしてください。

Webシステムの構成定義
決定したシステム構成パターンで，Webシステムを構築してください。Webシステムの構築には，Smart Composer機能のファイルとコマンドを使用します。
Smart Composer機能の簡易構築定義ファイルで，Webシステムの構成や，Webシステム内の論理サーバの環境を定義し，Smart Composer機能のコマンドで，定義したファイルを基にWebシステムを構築します。詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

J2EEサーバへのJ2EEアプリケーションのインポート
詳細については，「9.5.1　J2EEアプリケーションの設定の流れ」を参照してください。

運用管理エージェントとManagement Serverの起動および停止については，「3.2　システムの起動と停止の設定」を参照してください。

なお，論理サーバの構成やJ2EEアプリケーションの数を変更した場合は，もう一度監視ツリーを自動生成する必要があります。

16.2.4　JP1/Baseの構成定義の作成

JP1/IMが管理するシステムの構成を定義するJP1/Baseの構成定義ファイルを作成します。また，JP1/Baseの構成定義ファイルに定義したホストへ，定義情報を配布します。

JP1/Baseの構成定義の作成手順を次に示します。なお，詳細については，マニュアル「JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド」，またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Console システム構築・運用ガイド」のシステムの構成定義情報の設定に関する説明を参照してください。

JP1/Baseの構成定義ファイルを作成して，システムの構成を定義します。
構成定義ファイル（jbs_route.conf）は次の場所にインストールされています。

Windowsの場合
<JP1/Baseのインストールディレクトリ>¥jp1base¥conf¥route¥jbs_route.conf

UNIXの場合
/etc/opt/jp1base/conf/route/jbs_route.conf

構成定義ファイルの内容を次に示します。

構成定義ファイルの内容

［JP1統合運用管理サーバマシンのホスト名］

J2EEサーバマシンのホスト名

Cosminexusの運用管理サーバマシンのホスト名

jbsrt_distribコマンドを実行して，構成定義情報を配布します。

16.2.5　監視ツリーの自動生成

運用管理クライアントにあるJP1/IM - Viewで，監視ツリーを自動生成します。

監視ツリーを自動生成するための手順を次に示します。監視ツリーの自動生成は，JP1/IM - Viewがインストールされた運用管理クライアント（Windows）で実施してください。JP1/IMの起動と停止，ログインとログアウトなどの操作については，マニュアル「JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド」，またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Console　システム構築・運用ガイド」を参照してください。

Windowsの［スタート］メニューから［プログラム］-［JP1_Integrated Manager - View］-［監視ツリー編集］を選択します。
JP1/IM - Viewの［監視ツリー（編集中）］画面が起動されます。

［オプション］－［ツリーの自動生成］を選択します。
JP1/IM - Central Scopeにログインするための［ログイン］画面が表示されるため，ログイン処理をすると，［自動生成-構成選択］画面が表示されます。

自動生成する監視ツリーのモデルとして［業務指向ツリー］または［サーバ指向ツリー］を選択して，［生成］ボタンをクリックします。
監視ツリーが自動生成されます。

［監視ツリー(編集中)］画面で，［ファイル］－［サーバのツリーを更新］を選択します。
確認ダイアログが表示されるので，［はい］ボタンをクリックすると，生成された監視ツリーの情報がJP1統合運用管理サーバに反映されます。
JP1/IM - ViewでCosminexusの業務指向ツリーを生成および編集した場合の例を次の図に示します。

図16-1　Cosminexusの業務指向ツリーの生成，編集例

16.3　障害監視の設定

この節では，JP1/IMの統合コンソールまたは統合スコープから，Cosminexusシステムで発生した障害を監視するための設定について説明します。

まず，次の表に示すサーバおよびクライアントに，障害監視に必要なJP1の製品またはCosminexusの製品の構成ソフトウェアをインストール，セットアップしておいてください。なお，JP1/IMと連携する場合のシステム構成については，マニュアル「Cosminexus　機能解説」のシステムの集中監視に必要なプログラムに関する説明を参照してください。

表16-2　障害監視に必要な製品または構成ソフトウェア

サーバ／クライアント
製品／構成ソフトウェア

J2EEサーバ

Cosminexus Component Container

JP1/Base

Cosminexusの運用管理サーバ

JP1/Base

JP1統合運用管理サーバ

JP1/Base

JP1/IM - Central Console※1

JP1/IM - Central Scope※1※2

運用管理クライアント

JP1/IM - View

注※1　JP1/IM - Central ConsoleとJP1/IM - Central ScopeはJP1 Version 7iの製品です。JP1 Version 8の場合，この二つの製品はJP1/IM - Managerに統合され，内部コンポーネントとして提供されています。JP1 Version 8を使用する場合は，JP1/IM - Central ConsoleとJP1/IM - Central ScopeをJP1/IM - Managerに置き換えてお読みください。

注※2　JP1/IMの統合スコープで監視する場合に必要です。統合コンソールだけで監視する場合は必要ありません。

障害監視の設定手順を次に示します。

Cosminexusの運用管理サーバで，次の作業を実施します。

CosminexusのJP1イベント発行の設定（16.3.1参照）

JP1/Baseのイベントサーバ名の設定（16.3.2参照）

JP1統合運用管理サーバで，次の作業を実施します。

JP1/Baseの構成定義の作成（16.3.3参照）

J2EEサーバで，次の作業を実施します。

JP1/Baseのイベントサーバ名の設定（16.3.2参照）

＜この節の構成＞

16.3.1　CosminexusのJP1イベント発行の設定

16.3.2　JP1/Baseのイベントサーバ名の設定

16.3.3　JP1/Baseの構成定義の作成

16.3.1　CosminexusのJP1イベント発行の設定

Cosminexusシステムで発生するエラーやインフォメーション情報のうち，どのようなエラーやインフォメーション情報をJP1イベントとして発行するかを設定します。

Management Server用JP1イベントの設定

J2EEサーバ用JP1イベントの設定

J2EEユーザ用JP1イベントの設定

それぞれの設定方法について説明します。また，ユーザJP1イベントの推奨設定についても説明します。簡易構築定義ファイルについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。なお，SFOサーバでもシステムJP1イベントを発行できます。SFOサーバでシステムJP1イベントを発行させる場合の設定は，J2EEサーバでの設定と同じです。「(2)　J2EEサーバ用JP1イベントの設定」の「J2EEサーバ」を「SFOサーバ」と読み替えてください。

＜この項の構成＞

(1)　Management Server用JP1イベントの設定

(2)　J2EEサーバ用JP1イベントの設定

(3)　J2EEユーザ用JP1イベントの設定

(4)　ユーザJP1イベントの推奨設定

(1)　Management Server用JP1イベントの設定

Management Server用JP1イベントの設定手順を次に示します。

システムJP1イベント発行の設定をします。
mserver.propertiesで，com.cosminexus.mngsvr.jp1event.enabledキーで，Management Serverが検知した障害や通知をJP1イベントとして発行するかどうかを指定します。また，JP1イベントの重大度ごとに，JP1イベントを発行するかどうかを指定します。mserver.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

メッセージマッピングファイルを設定します。
Management Serverが検知した障害や通知を，メッセージマッピングファイルで，メッセージごとにどの重大度のJP1イベントに変換するかを定義します。なお，マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは，JP1イベントとして発行されません。
ファイル名は「mserver.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なファイルを提供しているので，必要に応じて，テキストエディタなどで編集してください。ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

Management Server用メッセージマッピングファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Management Serverを再起動します。
再起動後に，設定した情報が有効になります。

(2)　J2EEサーバ用JP1イベントの設定

J2EEサーバ用JP1イベントの設定手順を次に示します。

システムJP1イベント発行の設定をします。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，ejbserver.manager.agent.JP1EventAgent.enabledパラメタで「true」を指定します。デフォルトでは，「false」が指定されています。また，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）または論理SFOサーバ（sfo-server）の<configuration>タグ内に，次のパラメタでJP1イベントの重大度ごとに，JP1イベントを発行するかどうかを指定します。

manager.jp1event.system.filtering.severity.emergency

manager.jp1event.system.filtering.severity.alert

manager.jp1event.system.filtering.severity.critical

manager.jp1event.system.filtering.severity.error

manager.jp1event.system.filtering.severity.warning

manager.jp1event.system.filtering.severity.notice

manager.jp1event.system.filtering.severity.information

Management Serverおよび運用管理エージェントを再起動します。
再起動後に，設定した情報が有効になります。

メッセージマッピングファイルを設定します。
J2EEサーバが検知した障害や通知を，メッセージマッピングファイルで，メッセージごとにどの重大度のJP1イベントに変換するかを定義します。なお，マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは，JP1イベントとして発行されません。メッセージマッピングファイルには，J2EEサーバ共通用とJ2EEサーバ個別用があります。

J2EEサーバ共通用メッセージマッピングファイル

マシン内のJ2EEサーバ共通用で，J2EEサーバが検知した障害や通知をJP1イベントに変換するときに使用するファイルです。ファイル名は「manager.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なファイルを提供しているので，必要に応じて，テキストエディタなどで編集してください。ファイルの格納場所を次に示します。

Windowsの場合

　　<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合

　　/opt/Cosminexus/manager/config

J2EEサーバ個別用メッセージマッピングファイル

J2EEサーバごとに，J2EEサーバが検知した障害や通知をJP1イベントに変換したいときに使用するファイルです。このファイルとJ2EEサーバ共通用メッセージマッピングファイルが作成されている場合は，このファイルでの指定が優先されます。

ファイル名は「manager.<論理サーバ名>.jp1event.system.mapping.properties」です。このファイルは，テキストエディタなどを使用してユーザが作成してください。パラメタの記述形式は，J2EEサーバ共通用メッセージマッピングファイルと同じです。

メッセージマッピングファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

J2EEサーバを再起動します。
再起動後に，設定した情報が有効になります。

(3)　J2EEユーザ用JP1イベントの設定

J2EEユーザ用JP1イベントの設定手順を次に示します。

ユーザJP1イベント発行の設定をします。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタでJ2EEアプリケーションのユーザログをJP1イベントとして発行するかどうかを指定します。マッピングの設定で，ユーザログのログレベルにJP1イベントの重大度を割り当てたログがJP1イベントの発行対象になります。

manager.jp1event.user.mapping.level.severe

manager.jp1event.user.mapping.level.warning

manager.jp1event.user.mapping.level.info

manager.jp1event.user.mapping.level.config

manager.jp1event.user.mapping.level.fine

manager.jp1event.user.mapping.level.finer

manager.jp1event.user.mapping.level.finest

また，出力するユーザログをメッセージIDなどでフィルタリングできます。フィルタリングは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタで指定します。

manager.jp1event.user.filtering.enabled

manager.jp1event.user.filtering.filter

なお，ユーザJP1イベントの推奨設定については，「(4)　ユーザJP1イベントの推奨設定」を参照してください。

ロガーおよびハンドラを設定します。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタでJ2EEアプリケーションのユーザログで使用するロガーおよびハンドラを指定します。ハンドラにはJP1イベント用のハンドラ（com.cosminexus.mngsvr.externals.jp1event.JP1EventHandler）を指定してください。

ejbserver.application.userlog.loggers

ejbserver.application.userlog.Logger.<ロガー名称>.level

ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers

ejbserver.application.userlog.Logger.<ロガー名称>.filter

ejbserver.application.userlog.menu.handlers.

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding

ejbserver.application.userlog.Logger.<ロガー名称>.handlers

Management Serverおよび運用管理エージェントを再起動します。
再起動後に，設定した情報が有効になります。

J2EEサーバを再起動します。
再起動後に，設定した情報が有効になります。

(4)　ユーザJP1イベントの推奨設定

「(3)　J2EEユーザ用JP1イベントの設定」で設定するユーザJP1イベントの推奨設定について説明します。なお，J2EEアプリケーションのユーザログの出力の詳細については，「5.20　アプリケーションのユーザログ出力の設定」を参照してください。

(a)　ユーザJP1イベントのマッピングの設定

マッピングは次のように設定します。

ログレベル | JP1イベント重大度
SEVERE | Error
WARNING | Warning
INFO | Information
CONFIG | Notice
FINE | なし
FINER | なし
FINEST | なし

(b)　ユーザJP1イベントのフィルタリングの設定

ログを取得するときにメッセージIDを付けて，「MESSAGE_ID」でフィルタリングします。JP1イベントを発行させたいメッセージIDに対して「MESSAGE_ID EQU <メッセージID>」をORで接続して記述します。

また，J2EEアプリケーションごとにJP1イベントの発行をフィルタリングしたい場合は，ログを取得するときにJ2EEアプリケーション名を付けるか，デフォルトのJ2EEアプリケーション名を設定して，「APPLICATION」でフィルタリングします。

16.3.2　JP1/Baseのイベントサーバ名の設定

Microsoft Cluster ServiceまたはHAモニタを使用したクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき，Cosminexusの運用管理サーバ，およびJ2EEサーバでイベントサーバ名を設定します。

＜この項の構成＞

(1)　運用管理サーバ用イベントサーバ名の設定

(2)　J2EEサーバ用イベントサーバ名の設定

(1)　運用管理サーバ用イベントサーバ名の設定

Cosminexusの運用管理サーバでイベントサーバ名を設定するには，Management Server環境設定ファイル（mserver.properties）のmngsvr.jp1event.event_server_nameキーに，論理ホスト名または論理IPアドレスを指定します。なお，設定した情報を有効にするために，設定後は，Management Serverを再起動してください。

Management Server環境設定ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　J2EEサーバ用イベントサーバ名の設定

J2EEサーバでイベントサーバ名を設定する場合，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.manager.jp1event.event_server_nameパラメタで指定します。

16.3.3　JP1/Baseの構成定義の作成

JP1/IMが管理するシステムの構成を定義するJP1/Baseの構成定義ファイルを作成します。また，JP1/Baseの構成定義ファイルに定義したホストへ，定義情報を配布します。

JP1/Baseの構成定義の作成手順を次に示します。なお，詳細については，マニュアル「JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド」，またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Console システム構築・運用ガイド」のシステムの構成定義情報の設定に関する説明を参照してください。

JP1/Baseの構成定義ファイルを作成して，システムの構成を定義します。
構成定義ファイル（jbs_route.conf）は次の場所にインストールされています。

Windowsの場合
<JP1/Baseのインストールディレクトリ>¥jp1base¥conf¥route¥jbs_route.conf

UNIXの場合
/etc/opt/jp1base/conf/route/jbs_route.conf

構成定義ファイルの内容を次に示します。

構成定義ファイルの内容

［JP1統合運用管理サーバマシンのホスト名］

J2EEサーバマシンのホスト名

Cosminexusの運用管理サーバマシンのホスト名

jbsrt_distribコマンドを実行して，構成定義情報を配布します。

16.4　稼働性能監視の設定

この節では，JP1/IMの統合コンソールと統合スコープを使用して，Cosminexusシステムの稼働性能を監視するための設定について説明します。

まず，次の表に示すサーバおよびクライアントに，稼働性能監視に必要なJP1の製品またはCosminexusの製品の構成ソフトウェアをインストール，セットアップしておいてください。

JP1/IMと連携する場合のシステム構成については，マニュアル「Cosminexus　機能解説」のシステムの集中監視に必要なプログラムに関する説明を参照してください。

表16-3　稼働性能監視に必要な製品または構成ソフトウェア

サーバ／クライアント
製品／構成ソフトウェア

J2EEサーバ

Cosminexus Component Container

JP1/Cm2/ESA for Extension Mib Runtime※1

Cosminexusの運用管理サーバ

JP1/Base※2

JP1統合運用管理サーバ

JP1/Base

JP1/IM - Central Console※3

JP1/IM - Central Scope※2※3

運用管理クライアント

JP1/IM - View

注※1　JP1/Cm2/ESA for Extension Mib RuntimeはWindowsの場合に使用します。UNIXの場合，JP1/Cm2/ESAとなります。

注※2　JP1/IMの統合スコープで監視する場合に必要です。統合コンソールだけで監視する場合は必要ありません。

注※3　JP1 Version 7iのプログラムです。JP1 Version 8の場合，JP1/IM - Central ConsoleおよびJP1/IM - Central Scopeは，JP1/IM - Managerの内部コンポーネントです。

稼働性能を監視するための手順を次に示します。

J2EEサーバで，次の作業を実施します。

mngsvrutilコマンドの実行環境の設定（16.4.1参照）

拡張MIBオブジェクト定義ファイルの登録（16.4.2参照）

Cosminexusの運用管理サーバで，次の作業を実施します。

Management Serverの実行環境の設定（3章参照）

J2EEサーバの運用監視の設定（16.4.3参照）

稼働状況監視のサンプリング時間の設定（16.4.4参照）

＜この節の構成＞

16.4.1　mngsvrutilコマンドの実行環境の設定

16.4.2　拡張MIBオブジェクト定義ファイルの登録

16.4.3　J2EEサーバの運用監視の設定

16.4.4　稼働状況監視のサンプリング時間の設定

16.4.1　mngsvrutilコマンドの実行環境の設定

mngsvrutilコマンドの実行環境は，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）に設定します。

J2EEサーバ稼働マシンで，JP1/Cm2/ESAを起動したOSユーザのホームディレクトリに，クライアント側定義ファイルを作成して，次のパラメタを指定します。

mngsvrutil.connect.host
Management Serverのホスト名とポート番号を指定します。

mngsvrutil.connect.userid
Management Serverのmngsvrctl setupコマンドで設定した管理ユーザIDを指定します。

mngsvrutil.connect.password
Management Serverのmngsvrctl setupコマンドで設定したパスワードを指定します。パスワードを設定していない場合，このパラメタの指定は省略できます。

mngsvrutil.output.format
mngsvrutilコマンドの実行結果の出力形式としてSNMP連携用形式である「snmp」を指定します。

mngsvrutil.target_name
コマンドのサブコマンドの対象となる論理サーバ名，またはホスト名を指定します。Management ServerのSmart Composer機能の簡易構築定義ファイルで定義した内容に従います。簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

mngsvrutil.target_kind
コマンドのサブコマンドの対象（論理サーバ，またはホスト）を表す種別を指定します。

クライアント側定義ファイルは，mngsvrutilコマンドのオプションのデフォルト値を設定するファイルです。ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

なお，JP1/IMで稼働性能監視を行うために，クライアント側定義ファイルに次の記述を追加してください。

mngsvrutil.extended_keywords=FqnWithDomainName

この記述を追加することで，出力するMIB中のインスタンス名（インスタンスを一意に識別する完全修飾名）の先頭にドメイン名が付加されるようになります。

注意

JP1/Cm2/ESA for Extension Mibを利用してSNMP連携をする場合，JP1/Cm2/ESA for Extension Mib Runtimeを実行するユーザは，通常，ローカル システム アカウント（LocalSystem）になります。ローカル システム アカウント（LocalSystem）のホームディレクトリは隠しフォルダになっている場合があるので，エクスプローラの設定で隠しフォルダを表示するように設定してください。

次に，ローカル システム アカウント（LocalSystem）のホームディレクトリの場所を示します。

Windows Server 2003の場合
<システムドライブ>:¥WINDOWS¥system32¥config¥systemprofile

参考

クライアント側定義ファイルはクライアントごとに個別のデフォルト値を設定する場合に使用します。すべてのクライアント共通のデフォルト値を設定したい場合は，クライアント側共通設定ファイル（mngsvrutilcl.properties）を使用してください。なお，両方のファイルを使用している場合は，クライアント側定義ファイルが適用されます。クライアント側共通設定ファイルは読み込まれません。

16.4.2　拡張MIBオブジェクト定義ファイルの登録

J2EEサーバ稼働マシンで，JP1/Cm2/ESA for Extension Mib Runtime（UNIXの場合は，JP1/Cm2/ESA）にCosminexusの拡張MIBオブジェクト定義ファイルを登録します。

Cosminexusの拡張MIBオブジェクト定義ファイルは，最新版を登録してください。ファイル名「hitachi-cosmiMng-MIB_V-R」（UNIXの場合は，hitachi-cosmiMng-MIB_V-R_forESA）のうち，V-Rがバージョンを示しています。

Windowsの場合
JP1/Cm2/ESA for Extension Mib Runtimeの［環境設定］画面で，定義ファイル名に次のパスを指定します。

<Cosminexusのインストールディレクトリ>¥manager¥config¥hitachi-cosmiMng-MIB_V-R

UNIXの場合
Cosminexusの拡張MIBオブジェクト定義ファイルを/etc/SnmpAgent.d下に定義ファイル名snmpd.extendでコピーし，SNMPエージェントを再起動します。
コマンドの実行例を次に示します。

cp /opt/Cosminexus/manager/config/hitachi-cosmiMng-MIB_V-R_forESA /etc/SnmpAgent.d/snmpd.extend
snmpstart

詳細については，JP1/Cm2/ESA for Extension Mib Runtimeのオンラインヘルプ（Windowsの場合），またはマニュアル「JP1 Version 7i JP1/Cm2/Extensible SNMP Agent」（UNIXの場合）を参照してください。

16.4.3　J2EEサーバの運用監視の設定

J2EEサーバの運用監視の設定手順を次に示します。

J2EEサーバの運用監視エージェントで運用監視をする設定をします。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.instrumentation.enabledパラメタで「true」を指定します。デフォルトの設定では，運用監視エージェントで運用監視をする設定になっています。

Management Serverおよび運用管理エージェントを再起動します。
再起動後に，設定した情報が有効になります。

運用管理エージェントとManagement Serverの起動および停止については，「3.2　システムの起動と停止の設定」を参照してください。

16.4.4　稼働状況監視のサンプリング時間の設定

監視対象のリソースのサンプリング時間をmngsvrutilコマンドで設定します。

Management Serverの運用管理コマンドであるmngsvrutilコマンドで，監視対象のリソースのサンプリング時間を設定します。サンプリング時間は，mngsvrutilコマンドのサブコマンドsetの引数jvmSamplingTime <n>で指定します。mngsvrutilコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

16.5　ジョブによるシステムの自動運転の設定

この節では，JP1/AJS2と連携して，ジョブによってCosminexusシステムの運用を自動化するための設定について説明します。

まず，次の表に示すサーバおよびクライアントに，システムの自動運転に必要なJP1の製品またはCosminexusの製品の構成ソフトウェアをインストール，セットアップしておいてください。なお，JP1/AJS2と連携する場合のシステム構成については，マニュアル「Cosminexus　機能解説」のジョブによるシステムの自動運転に必要なプログラムに関する説明を参照してください。

表16-4　ジョブによるシステムの自動運転に必要な製品または構成ソフトウェア

サーバ／クライアント
製品／構成ソフトウェア

J2EEサーバ

Cosminexus Component Container

Cosminexusの運用管理サーバ

JP1/Base

JP1/AJS2 - Agent

JP1ジョブ運用管理サーバ

JP1/Base

JP1/AJS2 - Manager

運用管理クライアント

JP1/AJS2 - View

ジョブを使用して，システムを自動運転化するための手順を次に示します。

Cosminexusの運用管理サーバで，次の作業を実施します。

mngsvrutilコマンドの実行環境の設定（16.5.1参照）

J2EEサーバの運用監視の設定（16.5.2参照）

運用管理クライアントで，次の作業を実施します。

CosminexusのJP1/AJS2定義プログラムのインストール（16.5.3参照）※

Cosminexusのカスタムジョブの登録（16.5.4参照）※

ジョブの定義（16.5.5参照）

スケジュールの定義（16.5.6参照）

注※　Windowsの場合だけ実施してください。

＜この節の構成＞

16.5.1　mngsvrutilコマンドの実行環境の設定

16.5.2　J2EEサーバの運用監視の設定

16.5.3　CosminexusのJP1/AJS2定義プログラムのインストール（Windowsの場合）

16.5.4　Cosminexusのカスタムジョブの登録（Windowsの場合）

16.5.5　ジョブの定義

16.5.6　スケジュールの定義

16.5.1　mngsvrutilコマンドの実行環境の設定

JP1/AJS2と連携してCosminexusシステムの運用を自動化する場合，論理サーバやJ2EEアプリケーションの実行には，Management Serverの運用管理コマンドであるmngsvrutilコマンドを利用します。mngsvrutilコマンドの実行環境は，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）に設定します。

Cosminexusの運用管理サーバで，JP1/Baseのユーザマッピングで設定したOSユーザ（JP1/AJS2がmngsvrutilコマンドを起動するときのOSユーザ）のホームディレクトリに，クライアント側定義ファイルを作成して，次のパラメタを指定します。

mngsvrutil.connect.host
Management Serverのホスト名とポート番号を指定します。

mngsvrutil.connect.userid
Management Serverのmngsvrctl setupコマンドで設定した管理ユーザIDを指定します。

mngsvrutil.connect.password
Management Serverのmngsvrctl setupコマンドで設定したパスワードを指定します。パスワードを設定していない場合，このパラメタの指定は省略できます。

Windowsの場合，Cosminexusのカスタムジョブを利用して，論理サーバやJ2EEアプリケーションを実行する場合は，これら以外のパラメタの指定は無効になります。

クライアント側定義ファイルは，mngsvrutilコマンドのオプションのデフォルト値を設定するファイルです。

なお，mngsvrutilコマンドの実行環境を変更したい場合は，Management Serverの運用管理コマンドであるmngsvrutilコマンドのサーバ側定義ファイル（mngsvrutil.properties）で変更します。

ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

参考

クライアント側定義ファイルはクライアントごとに個別のデフォルト値を設定する場合に使用します。すべてのクライアント共通のデフォルト値を設定したい場合は，クライアント側共通設定ファイル（mngsvrutilcl.properties）を使用してください。なお，両方のファイルを使用している場合は，クライアント側定義ファイルが適用されます。クライアント側共通設定ファイルは読み込まれません。

16.5.2　J2EEサーバの運用監視の設定

J2EEサーバの運用監視の設定手順を次に示します。

J2EEサーバの運用監視エージェントで運用監視をする設定をします。
簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.instrumentation.enabledパラメタで「true」を指定します。デフォルトの設定では，運用監視エージェントで運用監視をする設定になっています。

Management Serverおよび運用管理エージェントを再起動します。
再起動後に，設定した情報が有効になります。

運用管理エージェントとManagement Serverの起動および停止については，「3.2　システムの起動と停止の設定」を参照してください。

16.5.3　CosminexusのJP1/AJS2定義プログラムのインストール（Windowsの場合）

JP1/AJS2定義プログラムをJP1/AJS2 - View稼働マシンに格納します。

Cosminexusが提供する次のファイルをJP1/AJS2 - View稼働マシンの任意のディレクトリにコピーしてください。

論理サーバ起動／停止ジョブ定義用の定義プログラム
<Cosminexusのインストールディレクトリ>¥manager¥externals¥jp1¥ajs2_custom_jobs¥cmsvcjdf.exe

J2EEアプリケーション起動／停止ジョブ定義用の定義プログラム
<Cosminexusのインストールディレクトリ>¥manager¥externals¥jp1¥ajs2_custom_jobs¥cmapcjdf.exe

16.5.4　Cosminexusのカスタムジョブの登録（Windowsの場合）

次の2種類のカスタムジョブをJP1/AJS2 - Viewに登録します。

論理サーバ制御用カスタムジョブ

アプリケーション制御用カスタムジョブ

カスタムジョブの登録手順を次に示します。なお，詳細については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド」を参照してください。

Windowsの［スタート］メニューから，［プログラム］－［JP1_Automatic Job Management System 2 - View］－［カスタムジョブ登録］を選択します。
［カスタムジョブの登録］ダイアログが表示されます。

［新規登録］ボタンをクリックします。
［カスタムジョブ登録情報］ダイアログが表示されます。

論理サーバ制御用カスタムジョブおよびアプリケーション制御用カスタムジョブの情報を登録します。

名前

カスタムジョブ名を任意の1～8バイトで指定します。

コメント

コメントを1～40バイトで任意の文字列で指定します。この指定は省略できます。

定義プログラム

JP1/AJS2 - View稼働マシンにコピーしたCosminexusのカスタムジョブの定義プログラムを絶対パスで指定します。論理サーバ制御用カスタムジョブの場合は「cmsvcjdf.exe」，アプリケーション制御用カスタムジョブの場合は「cmapcjdf.exe」を指定してください。

実行プログラム

mngsvrutil.コマンドを指定します。次のパスを指定してください。

<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrutil.exe

バージョン

「0600」を指定します。

バージョンはCosminexusのバージョンではなく，JP1/AJS2 - Viewのカスタムジョブのインタフェースのバージョンです。

クラス名

論理サーバ制御用カスタムジョブの場合は「COSMNGSV」，アプリケーション制御用カスタムジョブの場合は「COSMNGAP」を指定してください。

ジョブ種別

「PCジョブ」を選択してください。

［OK］ボタンをクリックします。
CosminexusのカスタムジョブがJP1/AJS2 - Viewに登録されます。

16.5.5　ジョブの定義

ジョブの定義についてOSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

カスタムジョブを登録すると，JP1/AJS2 - Viewでジョブネット中のジョブを定義するときにカスタムジョブが利用できるようになります。

Cosminexusのカスタムジョブを使用したジョブの定義手順を次に示します。なお，詳細については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド」のジョブの定義に関する説明を参照してください。

Windowsの［スタート］メニューから，［プログラム］－［JP1_Automatic Job Management System 2 - View］－［ジョブシステム運用］を選択します。
［ログイン］画面が表示されるので，ユーザ名，パスワード，および接続ホスト名を指定してログインすると，［JP1/AJS2 - View］ウィンドウが表示されます。

［編集］－［新規作成］－［ジョブネット］を選択します。
［詳細定義－［ジョブネット］］ダイアログが表示されます。

ジョブネットに属性などを定義して，［OK］ボタンをクリックします。
ジョブネットが作成され，リストエリアに表示されます。

作成したジョブネットをダブルクリックします。
［ジョブネットエディタ］ウィンドウが表示されます。

ジョブを定義したり関連づけたりするときにほかのユーザがアクセスできないように，［排他編集］をチェックします。

アイコンリストから必要なカスタムジョブのアイコンをマップエリアへドラッグします。

［詳細定義－［Custom Job］］ダイアログが表示されます。

ジョブに属性などを定義します。

ユニット名

ユニット名を30バイト以内の文字列で指定します。デフォルトは，カスタムジョブを登録したときのコメントが表示されます。

コメント

ユニットのコメントを80バイト以内の文字列で指定します。

実行ホスト

mngsvrutilコマンドを実行させるJP1/AJS2-Manager，またはJP1/AJS2-Agentホスト名を255バイト以内の文字列で指定します。

終了判定

正常終了と異常終了の判定基準とする値を定義します。mngsvrutilコマンドは終了コードが０以外は異常終了となるので次のようにデフォルトの値を指定してください。

判定結果：「しきい値による判定」

警告しきい値：空白

異常しきい値：「０」

［詳細］ボタンをクリックします。
［詳細］ボタンをクリックすると，Cosminexusの［論理サーバの制御］ダイアログが表示されます。

論理サーバ制御用カスタムジョブの場合は，Cosminexusの［論理サーバの制御］ダイアログで，次の内容を指定します。

論理サーバの指定

起動／停止の対象となる論理サーバ名（クラスタを含む）を指定します。すべての論理サーバを対象にしたいときは「全て」を選択します。

監視時間間隔

論理サーバの起動／停止の完了を監視する際の監視時間間隔を，「3秒」，「10秒」，「30秒」，「1分」から選択します。デフォルトでは，「3秒」が選択されています。なお，起動／停止で障害が発生した場合，障害回復のためにリトライ処理が行われます。この監視時間間隔は，障害回復時のリトライ処理間隔としても利用されます。

最大監視時間

論理サーバの起動／停止の完了を監視する際の最大監視時間を，「監視しない」，「1分」，「5分」，「10分」，「60分」，「120分」から選択します。デフォルトでは，「1分」が選択されています。

起動／停止

論理サーバの起動／停止を指定します。

アプリケーション制御用カスタムジョブの場合は，Cosminexusの［アプリケーションの制御］ダイアログで次の内容を指定します。

論理J2EEサーバ名

J2EEアプリケーションまたはリソースアダプタがインポートされている論理J2EEサーバ名またはJ2EEサーバクラスタ名を指定します。

J2EEアプリケーション／リソースアダプタの指定

起動／停止の対象となるJ2EEアプリケーション名またはリソースアダプタ名を指定します。「種別」でJ2EEアプリケーションまたはリソースアダプタを選択してから，「名前」にJ2EEアプリケーションまたはリソースアダプタ名を指定します。

監視時間間隔

J2EEアプリケーションまたはリソースアダプタの起動／停止の完了を監視する際の監視時間間隔を，「3秒」，「10秒」，「30秒」，「1分」から選択します。デフォルトでは，「3秒」が選択されています。なお，起動／停止で障害が発生した場合，障害回復のためにリトライ処理が行われます。この監視時間間隔は，障害回復時のリトライ処理間隔としても利用されます。

最大監視時間

J2EEアプリケーションまたはリソースアダプタの起動／停止の完了を監視する際の最大監視時間を，「監視しない」，「1分」，「5分」，「10分」，「60分」から選択します。デフォルトでは，「1分」が選択されています。

起動／停止

J2EEアプリケーションまたはリソースアダプタの起動／停止を指定します。

［OK］ボタンをクリックします。
ジョブネットにジョブが定義されます。必要に応じて，同様の手順で，ジョブを定義してください。

ジョブ同士を実行順序に従って関連づけます。
ジョブを関連づけたら，ジョブの定義は完了です。
JP1/AJS2 - Viewでのジョブの定義例を次の図に示します。

図16-2　ジョブの定義例

(2)　UNIXの場合

UNIXジョブを使用したジョブの定義手順を次に示します。

UNIXジョブを使用したジョブの定義には，JP1/AJS2 - Viewを使用します。JP1/AJS2 - Viewがインストールされた運用管理クライアント（Windows）で実施してください。詳細については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド」のジョブの定義に関する説明を参照してください。

Windowsの［スタート］メニューから，［プログラム］－［JP1_Automatic Job Management System 2 - View］－［ジョブシステム運用］を選択します。
［ログイン］画面が表示されるので，ユーザ名，パスワード，および接続ホスト名を指定してログインすると，［JP1/AJS2 - View］ウィンドウが表示されます。

［編集］－［新規作成］－［ジョブネット］を選択します。
［詳細定義－［ジョブネット］］ダイアログが表示されます。

ジョブネットに属性などを定義して，［OK］ボタンをクリックします。
ジョブネットが作成され，リストエリアに表示されます。

作成したジョブネットをダブルクリックします。
［ジョブネットエディタ］ウィンドウが表示されます。

ジョブを定義したり関連づけたりするときにほかのユーザがアクセスできないように，［排他編集］をチェックします。

アイコンリストから必要なUNIXジョブのアイコンをマップエリアへドラッグします。

［詳細定義－［UNIX Job］］ダイアログが表示されます。

ジョブに属性などを定義します。

ユニット名

ユニット名を30バイト以内の文字列で指定します。

コメント

ユニットのコメントを80バイト以内の文字列で指定します。

実行ホスト

mngsvrutilコマンドを実行させるJP1/AJS2-Manager，またはJP1/AJS2-Agentのホスト名を255バイト以内の文字列で指定します。

スクリプトファイル名

mngsvrutilコマンドを指定します。

パラメーター

論理サーバの開始／停止やアプリケーションの開始／停止などを行うためのmngsvrutilコマンドの引数を指定します。

終了判定

正常終了と異常終了の判定基準とする値を定義します。mngsvrutilコマンドは終了コードが０以外は異常終了となるので次のようにデフォルトの値を指定してください。

判定結果：「しきい値による判定」

警告しきい値：空白

異常しきい値：「０」

［OK］ボタンをクリックします。
ジョブネットにジョブが定義されます。必要に応じて，同様の手順で，ジョブを定義してください。

ジョブ同士を実行順序に従って関連づけます。
ジョブを関連づけたら，ジョブの定義は完了です。
JP1/AJS2 - Viewでのジョブの定義例を次の図に示します。

図16-3　ジョブの定義例

16.5.6　スケジュールの定義

JP1/AJS2 - Viewでジョブネットにスケジュールを定義します。スケジュールの定義では，業務の運用日・休業日を設定したカレンダー，実行を開始する日時や実行間隔などを定義します。ジョブネットにスケジュールを定義しておくと，決められた日時にジョブネットを自動的に開始できるようになります。

スケジュールの定義に必要な作業について説明します。

ジョブグループにカレンダー情報を定義します。
JP1/AJS2 - View の［月間カレンダー編集］ウィンドウ，または［年間カレンダー編集］ウィンドウでジョブグループにカレンダー情報（運用日と休業日）を定義します。
カレンダー情報は，ジョブグループ単位で定義します。定義したカレンダー情報は，そのジョブグループ中のすべてのジョブネットに有効です。ただし，各ジョブネットにスケジュールを定義する際，ほかのジョブグループのカレンダー情報を使用するように指定することもできます。ネストしたジョブグループの場合，上位のジョブグループのカレンダー情報を引き継げるので，カレンダー情報の定義は任意です。

ジョブネットにスケジュールを定義します。
JP1/AJS2 - View の［スケジュールの設定］ダイアログ，および［スケジュールルール］ダイアログで，ジョブネットにスケジュールを定義します。スケジュールとして定義するのは，スケジュールの有効期限や，ジョブネットの実行開始日時，実行処理サイクル，使用するカレンダー情報などです。
スケジュールはジョブネット単位で定義します。ただし，ネストジョブネットの場合，上位のジョブネットのスケジュールルールを引き継ぐこともできるので，スケジュールルールの定義は任意です。

なお，詳細については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド」のスケジュール定義に必要な作業に関する説明を参照してください。

16.6　監査ログの収集／一元管理の設定

この節では，JP1/NETM/Auditと連携して監査ログの収集および一元管理をするための設定について説明します。JP1/NETM/Audit，およびその前提PP（JP1/Base，Microsoft IIS）の基本的な設定方法は，マニュアル「JP1/NETM/Audit」を参照してください。

JP1/NETM/Auditと連携して監査ログの収集および一元管理をするためには，次の表に示すJP1の製品を，それぞれのサーバにインストール，およびセットアップします。

表16-5　監査ログの収集および一元管理をするために使用するJP1プログラムの機能

JP1プログラム
機能
配置するサーバ

JP1/NETM/Audit
JP1/Baseと連携して，アプリケーションサーバが出力する監査ログを収集します。また，収集した監査ログを監査ログ管理サーバのデータベースで一元管理します。

監査ログ管理サーバ

JP1/Base
出力された監査ログを，JP1イベントとして送受信します。

監査ログ管理サーバ

アプリケーションサーバ

運用管理サーバ

なお，JP1/NETM/Auditと連携する場合のシステム構成については，マニュアル「Cosminexus　機能解説」の監査ログの収集および一元管理に必要なプログラムに関する説明を参照してください。

＜この節の構成＞

16.6.1　監査ログの収集および一元管理に必要なプログラムのインストール

16.6.2　運用管理サーバ・アプリケーションサーバの設定

16.6.3　監査ログ管理サーバの設定

16.6.1　監査ログの収集および一元管理に必要なプログラムのインストール

監査ログ管理サーバに，JP1/NETM/Audit，およびMicrosoft IISをインストールします。また，監査ログ管理サーバ，および監査ログ収集対象となる運用管理サーバ，アプリケーションサーバに，JP1/Baseをインストールします。インストール方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

なお，監査ログ管理サーバで，Microsoft IISの設定をする必要があります。Microsoft IISの設定方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

16.6.2　運用管理サーバ・アプリケーションサーバの設定

ここでは，監査ログの収集対象となる運用管理サーバ，およびアプリケーションサーバの設定方法について説明します。運用管理サーバ，およびアプリケーションサーバの設定手順を次に示します。

JP1/Baseをセットアップします。
セットアップ方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

Windowsのイベントログ（セキュリティログ）を収集する場合，OSの設定をします。
Windowsのイベントログ（セキュリティログ）を収集しない場合は，手順3.に進んでください。OSの設定方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

監査ログ管理サーバから，監査ログ収集対象となる運用管理サーバとアプリケーションサーバに，JP1/Baseのアダプタコマンドのファイルとアダプタコマンドの動作に必要な定義ファイルをコピーします。
ファイルのコピーの詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

イベントサービスを起動します。
イベントサービスの起動の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

Windowsのイベントログを収集する場合，イベントログトラップを起動します。
イベントログトラップの起動の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

16.6.3　監査ログ管理サーバの設定

ここでは，監査ログ管理サーバの設定方法について説明します。監査ログ管理サーバの設定手順を次に示します。

＜この項の構成＞

(1)　JP1/NETM/Auditのバージョンが08-10の場合

(2)　JP1/NETM/Auditのバージョンが08-11以降の場合

(1)　JP1/NETM/Auditのバージョンが08-10の場合

JP1/Baseをセットアップして，基本的な設定をします。
セットアップ方法，および基本的な設定方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

［スタート］-［プログラム］-［JP1_NETM_Audit］-［データベースマネージャ］を選択してデータベースマネージャを起動します。

データベースをセットアップします。
セットアップ方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

製品定義ファイル，および動作定義ファイルを作成します。
製品定義ファイル，および動作定義ファイルは，次のファイル名で作成してください。

製品定義ファイルのファイル名
Cosminexus.conf

動作定義ファイルのファイル名
admjevlog_Cosminexus.conf

製品定義ファイル，および動作定義ファイルの記載内容の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。
製品定義ファイル，および動作定義ファイルの記載例を次に示します。

製品定義ファイルの設定例

AuditLogNum=1
AuditLogName=audit1.log
RegularPattern=admrglrule_CALFHM.conf

動作定義ファイルの設定例

retry-times=60
retry-interval=10
FILETYPE=SEQ2
ACTDEF =<Information>1000 "^CALFHM"

製品定義ファイル，および動作定義ファイルをコピーして，次の場所に格納します。

製品定義ファイルの格納場所
<JP1/NETM/Auditのインストールディレクトリ>¥conf¥product

動作定義ファイルの格納場所
<JP1/NETM/Auditのインストールディレクトリ>¥conf

［スタート］-［プログラム］-［JP1_NETM_Audit］-［マネージャセットアップ]を選択します。
マネージャセットアップが起動します。

［マネージャセットアップ］の［監査ログ収集設定］タブで，［追加］ボタンをクリックします。
［監査ログ収集対象の設定］画面で，監査ログの収集対象となるサーバのイベントサーバ名に，監査ログ収集対象となるサーバ（運用管理サーバまたはアプリケーションサーバ）のホスト名を入力して，プログラム名に「Cosminexus」を選択します。

ログファイル格納先ディレクトリに，監査ログが出力されるディレクトリをフルパスで指定して，［OK］ボタンをクリックします。

［監査ログ収集設定］タブのリストから監査ログの収集を開始したいサーバを選択して，［収集開始］ボタンをクリックします。

なお，手順6.～手順9.は，監査ログ管理サーバに監査ログの収集対象となるサーバを設定して，監査ログの収集を開始する手順です。これらの手順は，収集対象となる運用管理サーバ，およびアプリケーションサーバの台数分実行してください。

(2)　JP1/NETM/Auditのバージョンが08-11以降の場合

JP1/Baseをセットアップして，基本的な設定をします。
セットアップ方法，および基本的な設定方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

［スタート］-［プログラム］-［JP1_NETM_Audit］-［データベースマネージャ］を選択してデータベースマネージャを起動します。

データベースをセットアップします。
セットアップ方法の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

［スタート］-［プログラム］-［JP1_NETM_Audit］-［監査ログ収集マネージャ］を選択します。
監査ログ収集マネージャが起動します。

［監査ログ収集マネージャ］画面のメニューから［操作］-［収集対象］-［追加］を選択します。

［収集対象の設定］画面で次の設定をして，［OK］ボタンをクリックします。

［サーバ］

運用管理サーバ，およびアプリケーションサーバのホスト名を入力します。

［プログラム］

「Cosminexus」を選択します。

［ログフォルダ］

監査ログが出力されるディレクトリをフルパスで入力します。

Windowsのサービス画面で［JP1/NETM/Audit - Manager］を再起動します。

［監査ログ収集マネージャ］画面で，監査ログの収集を開始したいサーバを選択します。

メニューから［操作］-［監査ログの監視］-［開始］を選択します。

なお，手順5.～手順6.は，監査ログ管理サーバに監査ログの収集対象となるサーバを設定する手順です。これらの手順は，収集対象となる運用管理サーバ，およびアプリケーションサーバの台数分実行してください。

17.　クラスタソフトウェアと連携するための設定

Cosminexusのシステムでは，クラスタソフトウェアと連携して運用することで，障害発生時に，あらかじめ待機させておいたシステムに切り替えて業務の継続を可能にしたり，障害が発生したシステムのリカバリ処理を待機しているシステムで実施してシステムの不稼働時間を短縮したりできます。これによって，システムの信頼性や稼働率を高めることができます。

この章では，クラスタソフトウェア（Microsoft Cluster ServiceまたはHAモニタ）と連携するときの設定方法について説明します。

＜この章の構成＞

17.1　クラスタソフトウェアと連携する設定の概要

17.2　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

17.3　運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

17.4　相互系切り替えシステムの設定（Windowsの場合）

17.5　N:1リカバリシステムの設定（Windowsの場合）

17.6　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

17.7　運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

17.8　相互系切り替えシステムの設定（UNIXの場合）

17.9　N:1リカバリシステムの設定（UNIXの場合）

17.1　クラスタソフトウェアと連携する設定の概要

この節では，クラスタソフトウェアと連携するための設定の概要について説明します。

Cosminexusのシステムでは，クラスタソフトウェアと連携して運用することで，障害によるシステムの不稼働時間を短縮したり，障害発生時でも業務の継続を可能にしたりできます。Cosminexusでは，次に示すクラスタソフトウェアとの連携による系切り替え機能を使用します。

1:1系切り替えシステム

アプリケーションサーバの1:1系切り替え
実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1にした構成とすることで，実行系のアプリケーションサーバに障害が発生したときに系を切り替えて，業務を続行できます。

運用管理サーバの1:1系切り替え
実行系の運用管理サーバと待機系の運用管理サーバを1:1にした構成とすることで，実行系の運用管理サーバに障害が発生したときに系を切り替えて，業務を続行できます。

相互系切り替え
実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1にして，それぞれのアプリケーションサーバが実行系として動作しながらお互いの待機系として機能するシステムです。少ない台数のアプリケーションサーバマシンで，むだの少ない運用ができるようになります。

N:1リカバリシステム
N台の実行系のアプリケーションサーバに対して，1台のリカバリ専用の待機系のアプリケーションサーバを配置するシステムです。J2EEサーバを冗長化した構成でグローバルトランザクションを使用する場合に，特定のJ2EEサーバにトラブルが発生したとき，リカバリ専用サーバでトランザクションを決着できるようになります。

参考

Cosminexusで1:1系切り替えシステムやN:1リカバリシステムを構築，および運用するためには，次のクラスタソフトウェアを使用します。

Microsoft Cluster Service（Windowsの場合）

HAモニタ（AIX，HP-UXまたはLinuxの場合）
Solarisの場合，クラスタソフトウェアと連携したシステム運用はできません。

なお，クラスタソフトウェアと連携する場合には，次の用語を理解しておいてください。

クラスタソフトウェアでは，業務処理に必要なハードウェアのほか，実行するプログラムや通信機器を含めたシステム全体の総称を系といいます。システムで動作中の系を区別する呼び方に，実行系・待機系があります。

実行系
現在実行中のサーバがある系のことです。系切り替えが発生すると，待機系になります。

待機系
現在待機中のサーバがある系のことです。系切り替えが発生すると，実行系になります。

また，システムの設定などで，システムが動作していないときの系を区別する呼び方に，現用系・予備系があります。

現用系
起動したときに，最初に実行系として起動される系のことです。

予備系
起動したときに，最初に待機系として起動される系のことです。

クラスタソフトウェアとの連携による系切り替えの機能は，システムの種類によって使用できる機能が異なります。

●J2EEアプリケーションを実行するシステムの場合

J2EEアプリケーションを実行するシステムの場合，次の表に示す機能を使用できます。

表17-1　クラスタソフトウェアとの連携による系切り替え機能（J2EEアプリケーションを実行するシステム）

機能
参照先

1:1系切り替えシステム
アプリケーションサーバの1:1系切り替え※
Windowsの場合：17.2
UNIXの場合：17.6

運用管理サーバの1:1系切り替え
Windowsの場合：17.3
UNIXの場合：17.7

相互系切り替え
Windowsの場合：17.4
UNIXの場合：17.8

N:1リカバリシステム※
Windowsの場合：17.5
UNIXの場合：17.9

注※　これらのシステムは，Smart Composer機能では構築できません。運用管理ポータルを使用して，システムを構築してください。

以降の節では，上記の機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

●バッチアプリケーションを実行するシステムの場合

バッチアプリケーションを実行するシステムの場合，次の表に示す機能を使用できます。

表17-2　クラスタソフトウェアとの連携による系切り替え機能（バッチアプリケーションを実行するシステム）

機能
参照先

1:1系切り替えシステム
アプリケーションサーバの1:1系切り替え※
Windowsの場合：17.2
UNIXの場合：17.6

相互系切り替え
Windowsの場合：17.4
UNIXの場合：17.8

注※　このシステムは，Smart Composer機能では構築できません。運用管理ポータルを使用して，システムを構築してください。

以降の節では，上記の機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

17.2　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

1:1系切り替えシステムとは，実行系と待機系が1:1で対応しているシステムです。Cosminexusでは，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置するシステムと，実行系の運用管理サーバと待機系の運用管理サーバを1:1に配置するシステムを構築・運用できます。このシステムは，運用管理ポータルを使用して構築します。運用管理ポータルについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。この節では，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置して系を切り替えるシステムの設定について説明します。

アプリケーションサーバの実行系と待機系を1:1に配置して系を切り替えるシステムでは，実行系のアプリケーションサーバでマシンの障害や運用管理エージェントの終了などの障害が発生すると，Microsoft Cluster Serviceがこれを検知して，自動的に待機している系に切り替えて業務を続行します。また，障害が発生しなくても実行中のシステムに予防保守などが必要な場合には，オペレータの操作によって待機している系に計画的に切り替えることができます。

なお，アプリケーションサーバの1:1系切り替えシステムの詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のアプリケーションサーバの実行系と待機系を1:1にする構成に関する説明を参照してください。

＜この節の構成＞

17.2.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

17.2.2　クラスタサーバの環境設定

17.2.3　設定ファイルの編集

17.2.4　汎用スクリプトファイルの作成

17.2.5　クラスタアドミニストレータでのクラスタサーバの環境設定

17.2.6　アプリケーションサーバの設定

17.2.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

ここでは，システムの構築例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

アプリケーションサーバの1:1系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-1　アプリケーションサーバを対象にした1:1系切り替えシステムの構成例（Windowsの場合）

この例では，アプリケーションサーバの実行系（現用系）とアプリケーションサーバの待機系（予備系）を1:1で配置しています。また，Management Serverは，運用管理サーバとして，アプリケーションサーバとは別のマシンに配置しています。

アプリケーションサーバの1:1系切り替えシステムでは，まずクラスタを構築して，アプリケーションサーバをクラスタ（例ではCOSMI）内に現用系ノード（例ではNode1）と予備系ノード（例ではNode2）として定義します。また，現用系ノードと予備系ノードは，「物理ディスクリソース」，「IPアドレスリソース」，「ネットワーク名リソース」，および「汎用スクリプトリソース」を含めた，一つのリソースグループ（例ではClusterA）として定義します。

なお，Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。1:1系切り替えシステムの場合，エイリアスIPアドレスは，Microsoft Cluster Serviceによって動的に割り当てられるアドレス（クラスタIPアドレス）となります。

(2)　システムの設定手順

Microsoft Cluster Serviceと連携する場合には，運用管理ポータルやクラスタアドミニストレータの設定などが必要になります。アプリケーションサーバの1:1系切り替えシステムの設定手順を次の図に示します。

図17-2　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順（Windowsの場合）

図中の1.～7.について説明します。

共有ディスクにパーティションを作成して，ファイルシステムを構築します。
Microsoft Cluster Serviceのクラスタ管理用ファイルの格納場所を作成します。また，グローバルトランザクションを使用する場合には，トランザクション情報の格納場所を作成します。なお，クラスタ管理用ファイルの格納場所とトランザクション情報の格納場所は，同じパーティションでもかまいません。

システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系と予備系で，同じドライブ文字を割り当ててください。

運用管理ポータルでクラスタサーバの環境を設定します。
運用管理ポータルの「運用管理ドメインの構成定義」，および「論理サーバの環境設定」で，Microsoft Cluster Serviceを使用する場合の設定をします。

設定ファイルを編集します。
運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

汎用スクリプトファイルを作成します。
運用管理エージェントを監視，起動，停止するための汎用スクリプトファイルを作成します。

クラスタアドミニストレータでクラスタサーバの環境を設定します。
クラスタアドミニストレータを使用して，系で稼働させるサーバの環境を設定します。

運用管理ポータル，クラスタアドミニストレータなどで，アプリケーションサーバの設定をします。
運用管理ポータル，クラスタアドミニストレータなどを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

17.2.2　クラスタサーバの環境設定

ここでは，Microsoft Cluster Serviceと連携する場合の，運用管理ポータルでの設定の留意点について説明します。

参考

運用管理ポータルでシステムの動作環境を設定するには，あらかじめ，Management Serverの起動などが必要です。また，Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。運用管理ポータルでの動作環境の設定や，操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

＜この項の構成＞

(1)　「運用管理ドメインの構成定義」での設定

(2)　「論理サーバの環境設定」での設定

(1)　「運用管理ドメインの構成定義」での設定

論理サーバを設置するホストおよび各論理サーバの構成を定義します。このとき，［ホストの定義］画面で，「ホスト名」にクラスタIPアドレスを設定します。

(2)　「論理サーバの環境設定」での設定

論理J2EEサーバ，論理Webサーバ，論理SFOサーバ，および論理ネーミングサービスの設定での留意点を次に示します。

(a)　論理J2EEサーバの設定

ホストの固定の設定
次の個所では，「ホストの固定」に「する」を設定してください。

［J2EEコンテナの設定］画面にある「運用監視エージェントの設定」の「ホストの固定」

［EJBコンテナの設定］画面にある「ホストの固定」

［Webコンテナの設定］画面にある「Webサーバとの接続」または「管理用サーバの設定」の「ホストの固定」

ホストを固定すると，運用管理ポータルの「運用管理ドメインの構成定義」で定義したホスト名が使用されます。

グローバルトランザクションの設定
グローバルトランザクションを使用する場合は，次の設定をしてください。

［トランザクションの設定］画面にある「ライトトランザクション機能」を「無効」にします。

［トランザクションの設定］画面にある「インプロセスOTSのステータスファイル格納先」に，共有ディスク装置のディレクトリを設定します。
設定例
L:¥Group1¥otsstatus

(b)　論理Webサーバの設定

［Webサーバの設定］画面で，「ホストの固定」に「する」を設定してください。

(c)　論理SFOサーバの設定

Microsoft Cluster Serviceを使用してJ2EEサーバがクラスタ構成となるシステムで，セッションフェイルオーバ機能を使用する場合は，論理SFOサーバで次の設定が必要です。

サーバIDの重複の設定
［システムプロパティの設定］画面にある「システムプロパティの定義」で，次のように設定します。

設定例

webserver.sfo.negotiation.ignore_serverId=true

このように設定することで，HTTPセッションのセッションIDに設定されるサーバIDが，ほかのJ2EEサーバのサーバIDと重複していても，エラーにならないようになります。

注意

webserver.sfo.negotiation.ignore_serverIdキーに「true」を指定するのは，Microsoft Cluster Serviceを使用したクラスタ環境でセッションフェイルオーバ機能を使用する場合だけにしてください。

Microsoft Cluster Serviceを使用しない環境で「true」を指定すると，システム内のセッションIDが重複する場合があります。Microsoft Cluster Serviceを使用しない環境では，デフォルト値の「false」を指定してください。

(d)　論理ネーミングサービスの設定

［ネーミングサービスの設定］画面で，「ホストの固定」に「する」を設定してください。このとき，J2EEサーバが使用するネーミングサービス（アウトプロセスでの起動）を設定する場合は，「運用管理エージェントのホストで固定」のチェックボックスをチェックしないでください。このように設定することで，「運用管理ドメインの構成定義」の［ネーミングサービスの追加］画面で指定したホスト名が使用されます。

17.2.3　設定ファイルの編集

運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。ここでは，Microsoft Cluster Serviceと連携する場合に注意が必要なファイルの設定について説明します。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Hitachi Web Serverの設定（Webサーバと連携する場合）

(3)　ワーカの設定（Webサーバと連携する場合）

(4)　スマートエージェントの設定（CTMを利用する場合）

(1)　運用管理エージェントの設定

adminagent.properties（運用管理エージェントプロパティファイル）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでクラスタIPアドレスを指定します。管理用のリクエストは，クラスタIPアドレスだけで受け付けます。例では，次のように設定します。
adminagent.adapter.bind_host=172.16.12.30

adminagent.cluster.localaddress.checkキー
アプリケーションサーバの系切り替え時に，障害などの原因で停止しなかった待機系の論理サーバ，または運用管理エージェントを停止するための設定をします。
adminagent.cluster.localaddress.check=true

(2)　Hitachi Web Serverの設定（Webサーバと連携する場合）

httpsd.conf（Hitachi Web Server定義ファイル）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。なお，httpsd.confファイルの各ディレクティブについては，マニュアル「Hitachi Web Server」を参照してください。

Listenディレクティブ，BindAddressディレクティブなど
Listenディレクティブ，BindAddressディレクティブなどには，クラスタIPアドレスを指定します。クライアントへのサービス提供は，クラスタIPアドレスで実施します。

ServerNameディレクティブ
ServerNameディレクティブには，クラスタIPアドレス，またはクラスタIPアドレスに名前を解決できるホスト名を指定します。

(3)　ワーカの設定（Webサーバと連携する場合）

workers.properties（ワーカ定義ファイル）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。workers.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

workers.propertiesでは，ネットワーク設定に合わせて，次のキーを設定してください。

worker.<ワーカ名>.host=クラスタIPアドレス

(4)　スマートエージェントの設定（CTMを利用する場合）

Management Serverとの連携でCTMを利用する場合には，次のファイルを編集する必要があります。

localaddr
localaddrを作成します。localaddrでは，ステーショナリIPアドレスとクラスタIPアドレスを設定し，スマートエージェントがステーショナリIPアドレスとエイリアスIPアドレスを通信に使用できるようにします。localaddrの設定については，「付録I　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（Windowsの場合）」を参照してください。

17.2.4　汎用スクリプトファイルの作成

運用管理エージェントを監視，起動，および停止するためのスクリプトファイルをVBScriptで記述します。現用系のアプリケーションサーバと予備系のアプリケーションサーバで同一の汎用スクリプトファイルを使用し，同一のパスに配置してください。

＜この項の構成＞

(1)　汎用スクリプトファイルの例

(2)　汎用スクリプトファイルの関数

(3)　汎用スクリプトファイルの変数

(1)　汎用スクリプトファイルの例

アプリケーションサーバを1:1に配置して系を切り替える場合の汎用スクリプトファイルの例（GenericScript.vbs）を次に示します。なお，汎用スクリプトファイルに定義する関数と変数については，「(2)　汎用スクリプトファイルの関数」，および「(3)　汎用スクリプトファイルの変数」を参照してください。

Dim WshShell, fso, AccessInfoFile, oExec, oRun, oCosmiHome, oAdmin, oMngsvut, oCjsleep
Dim oMngHost, oAAHost, oUser, oPass
Set WshShell = CreateObject("WScript.Shell")

oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oAdminac = """" & oCosmiHome & "¥manager¥bin¥adminagentctl"""
oMngsvut = """" & oCosmiHome & "¥manager¥bin¥mngsvrutil"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

oMngHost = "172.16.12.39" '--- Management Server
oAAHost  = "172.16.12.30" '--- Adminagent Server
oUser = "admin" ' --- Management Server's userid
oPass = "admin" ' --- Management Server's password

' ==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   Open = True
End Function

' ==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"

   '--- adminagent.access.info file ---
   Set fso = CreateObject("Scripting.FileSystemObject")
   Set AccessInfoFile = fso.CreateTextFile(oCosmiHome & "¥manager¥tmp¥adminagent.access.info", True)
   AccessInfoFile.WriteLine(oMngHost & ":28080," & oAAHost & ":20295")
   AccessInfoFile.Close

   '--- adminagentctl ---
   Set oExec = WshShell.Exec(oAdminac & " start")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent cannot start. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oRun
       Resource.LogInformation oExec.StdOut.ReadAll
       Online = False
       Exit Function
   End If

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -u "&oUser&" -p "&oPass&" -s -l 360 start allServers"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers start failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   Online = True
End Function

' ==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq adminagent.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "adminagent.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
   End If
End Function

' ==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -u "&oUser&" -p "&oPass&" -t " & oAAHost & " -k host check adminAgent"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
   Else
       IsAlive = True
   End If
End Function

' ==== Offline ====
Function Offline( )
   Resource.LogInformation "======== Entering Offline. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -u "&oUser&" -p "&oPass&" -s -l 360 stop allServers"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers stopping failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   '--- adminagentctl ---
   Set oExec = WshShell.Exec(oAdminac & " stop")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent stopping failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If
   Offline = True
End Function

' ==== Close ====
Function Close( )
   Resource.LogInformation "======== Entering Close. ========"
   Close = True
End Function

' ==== Terminate ====
Function Terminate( )
   Resource.LogInformation "======== Entering Terminate. ========"
   Terminate = True
End Function

(2)　汎用スクリプトファイルの関数

汎用スクリプトファイルには，関数を定義する必要があります。各関数の戻り値は，正常終了時にはTrueを，異常終了時にはFalseを返します。汎用スクリプトファイルの関数を次の表に示します。

表17-3　汎用スクリプトファイルの関数（アプリケーションサーバの1:1系切り替えの場合）

関数名
内容

Open
この汎用スクリプトファイルが開かれるときに実行される関数です。Resource.LogInformationメソッドでクラスタログにログを出力します。

Online
汎用スクリプトリソースのオンライン時に実行される関数です。この関数でアクセス情報ファイルを作成し，運用管理エージェント，論理サーバを起動します。
アクセス情報ファイルのフォーマットを次に示します。
<Mng_ip>:<Mng_port>,<AA_ip>:<AA_port>

Mng_ip
Management Server稼働ホストのIPアドレス

Mng_port
Management Serverのポート番号

AA_ip
Management Serverの運用管理ポータルの「運用管理ドメインの構成定義」のホストに指定した値（運用管理エージェントのホスト名）

AA_port
Management Serverの運用管理ポータルの「運用管理ドメインの構成定義」の運用管理エージェントのポート番号

LooksAlive
リソースの稼働状況を簡単に把握するための関数です。この関数では，tasklistコマンドで運用管理エージェントのプロセスの有無を確認します。

IsAlive
リソースの稼働状況を厳密に把握するための関数です。この関数では，mngsvrutilのcheckコマンドで運用管理エージェントが正常に動作しているかを確認します。

Offline
汎用スクリプトリソースのオフライン時に実行される関数です。この関数で論理サーバと運用管理エージェントを停止します。

Close
この汎用スクリプトファイルが閉じるときに実行される関数です。

Terminate
汎用スクリプトリソースの強制終了時に実行される関数です。

(3)　汎用スクリプトファイルの変数

汎用スクリプトファイルでは，必要に応じて次の表に示す変数の値を変更してください。

表17-4　汎用スクリプトファイルの変数（アプリケーションサーバの1:1系切り替えの場合）

変数名 | 内容
oMngHost | Management Serverが稼働しているホスト
oAAHost | 運用管理エージェントが稼働しているホスト（クラスタIPアドレス）
oUser | Management ServerにログインするためのログインID
oPass | Management Serverにログインするためのパスワード

17.2.5　クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータを使用して，現用系，予備系アプリケーションサーバの系で稼働させる実行サーバや待機サーバの環境を定義します。なお，クラスタアドミニストレータの設定の詳細については，OSのマニュアルを参照してください。

アプリケーションサーバを1:1に配置して系を切り替える場合の設定内容を次に示します。

＜この項の構成＞

(1)　リソースグループの設定

(2)　リソースの設定

(1)　リソースグループの設定

次の手順でリソースグループを設定します。

クラスタノードを設定します。
クラスタにノード（Node1，Node2）を追加します。

リソースグループを作成します。
［ファイル］－［新規作成］－［グループ］を選択して，次のリソースグループを作成します。

項目 | 設定値
名前 | ClusterA
説明 | グループA
優先所有者 | Node1，Node2

(2)　リソースの設定

次の手順でリソースを設定します。

共有ディスクを設定します。

クラスタIPアドレスを設定します。

クラスタ名を設定します。

汎用スクリプトを設定します。

各作業について説明します。

(a)　共有ディスクの設定

トランザクション情報を共有ディスクに格納するための設定をします。Cosminexusで設定する「インプロセストランザクションサービスのステータスファイル」の格納先をこの共有ディスクに設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の物理ディスクリソースを作成します。

項目 | 設定値
名前 | DiskA
説明 | 共有ディスクA
リソースの種類 | 物理ディスク
グループ | ClusterA
実行所有者 | Node1,Node2
共有ディスク | Lドライブ（L:¥)

(b)　クラスタIPアドレスの設定

クラスタを管理するためのIPアドレスを設定します。クラスタIPアドレスとして，Management Serverやクライアントから認識されるIPアドレスを設定してください。［ファイル］－［新規作成］－［リソース］を選択して，次のIPアドレスリソースを作成します。

項目 | 設定値
名前 | IPAddressA
説明 | IPアドレスA
リソースの種類 | IPアドレス
グループ | ClusterA
実行所有者 | Node1,Node2
依存関係 | なし
アドレス | 172.16.12.30
サブネットマスク | 255.255.0.0
ネットワーク | ローカル エリア接続

(c)　クラスタ名の設定

［ファイル］－［新規作成］－［リソース］を選択して，次のネットワーク名リソースを作成します。

項目 | 設定値
名前 | HostNameA
説明 | ホストA
リソースの種類 | ネットワーク名
グループ | ClusterA
実行所有者 | Node1,Node2
依存関係 | IPAddressA
ネットワーク名 | COSMI

(d)　汎用スクリプトの設定

Microsoft Cluster ServiceからCosminexusを起動，停止する汎用スクリプトリソースを設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の汎用スクリプトリソースを作成します。

項目 | 設定値
名前 | ScriptA
説明 | スクリプトA
リソースの種類 | 汎用スクリプト
グループ | ClusterA
実行所有者 | Node1，Node2
依存関係 | DiskA，IPAddressA，HostNameA
スクリプトのファイルパス | C:¥MSCS¥GenericScript.vbs
詳細設定プロパティ | 再開しない
LooksAliveポーリング間隔 | 任意
IsAliveポーリング間隔 | 任意
待ちのタイムアウト | 任意

17.2.6　アプリケーションサーバの設定

アプリケーションサーバの設定では，運用管理ポータル，クラスタアドミニストレータなどを使用してCosminexusをクラスタ構成に配置します。また，論理サーバをセットアップして設定情報を配布し，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。アプリケーションサーバの設定手順を次に示します。

運用管理サーバを起動します。
運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

Node1で，リソースグループClusterAをオンラインにします。

運用管理ポータルで，J2EEサーバをセットアップします。
「運用管理ドメインの構成定義」の［セットアップ］画面で，J2EEサーバをセットアップします。運用管理ポータルでの操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

運用管理ポータルで，J2EEサーバに設定した情報をNode1に配布します。
「論理サーバの環境設定」の［設定情報の配布］画面で，J2EEサーバに設定した情報をNode1に配布します。

サーバ管理コマンドを使用して，Node1のJ2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。また，インポートしたJ2EEアプリケーションとリソースアダプタを設定および開始します。
J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。また，サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
なお，J2EEサーバおよびその前提プロセスを起動してからサーバ管理コマンドを実行してください。また，サーバ管理コマンドでの操作が終わったら，サーバ管理コマンドを停止させてください。

クラスタアドミニストレータで，リソースグループClusterAに対して「グループの移動」を実行して系を切り替え，リソースの所有者をNode2に変更します。

Node2で，手順3.～手順5.を実施します。

クラスタアドミニストレータで，リソースグループClusterAに対して「グループの移動」を実行して系を切り替え，リソースの所有者をNode1に戻します。

17.3　運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

1:1系切り替えシステムとは，実行系と待機系が1:1で対応しているシステムです。Cosminexusでは，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置するシステムと，実行系の運用管理サーバと待機系の運用管理サーバを1:1で配置するシステムを構築・運用できます。このシステムは，Smart Composer機能を使用して構築します。この節では，実行系の運用管理サーバと待機系の運用管理サーバを1:1に配置して系を切り替えるシステムの設定について説明します。

運用管理サーバを1:1に配置して系を切り替えるシステムでは，実行系の運用管理サーバでマシンの障害やManagement Serverのプロセスの終了が発生すると，Microsoft Cluster Serviceがこれを検知して，自動的に待機している系に切り替えて業務を続行します。また，障害が発生しなくても実行中のシステムに予防保守などが必要な場合には，オペレータの操作によって待機している系に計画的に切り替えることができます。

なお，運用管理サーバの1:1系切り替えシステムの詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」の運用管理サーバの実行系と待機系を1:1にする構成に関する説明を参照してください。

＜この節の構成＞

17.3.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

17.3.2　クラスタサーバの環境設定

17.3.3　設定ファイルの編集

17.3.4　現用系から予備系へのManagement Serverの設定情報のコピー

17.3.5　汎用スクリプトファイルの作成

17.3.6　クラスタアドミニストレータでのクラスタサーバの環境設定

17.3.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

ここでは，システムの構成例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

運用管理サーバの1:1系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-3　運用管理サーバを対象にした1:1系切り替えシステムの構成例（Windowsの場合）

この例では，運用管理サーバとアプリケーションサーバは，別のマシンに配置しています。運用管理サーバの実行系（現用系）と運用管理サーバの待機系（予備系）を1:1で配置しています。

運用管理サーバの1:1系切り替えシステムでは，まずクラスタを構築して，運用管理サーバをクラスタ（例ではCOSMI）内に現用系ノード（例ではNode1）と予備系ノード（例ではNode2）として定義します。また，現用系ノードと予備系ノードは，「物理ディスクリソース」，「IPアドレスリソース」，「ネットワーク名リソース」，および「汎用スクリプトリソース」を含めた，一つのリソースグループ（例ではGroup）として定義します。

なお，Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。1:1系切り替えシステムの場合，エイリアスIPアドレスは，Microsoft Cluster Serviceによって動的に割り当てられるアドレス（クラスタIPアドレス）となります。

(2)　システムの設定手順

Microsoft Cluster Serviceと連携する場合には，Management Serverやクラスタアドミニストレータの設定などが必要になります。運用管理サーバの1:1系切り替えシステムの設定手順を次の図に示します。なお，ここでは運用管理サーバをアプリケーションサーバとは別のマシンとして構築している場合の，運用管理サーバの設定手順について説明しています。運用管理サーバと別のマシンに構築しているアプリケーションサーバの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

図17-4　運用管理サーバを対象にした1:1系切り替えシステムの設定手順（Windowsの場合）

図中の1.～7.について説明します。

共有ディスクにパーティションを作成して，ファイルシステムを構築します。
Microsoft Cluster Serviceのクラスタ管理用ファイルの格納場所を作成します。また，グローバルトランザクションを使用する場合には，トランザクション情報の格納場所を作成します。なお，クラスタ管理用ファイルの格納場所とトランザクション情報の格納場所は，同じパーティションでもかまいません。

システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系と予備系で，同じドライブ文字を割り当ててください。

Management Serverでクラスタサーバの環境を設定します。
Management ServerのSmart Composer機能の簡易構築定義ファイルで，Microsoft Cluster Serviceを使用する場合の設定をします。

設定ファイルを編集します。
簡易構築定義ファイルでは設定できない，Management Serverなどの各種定義ファイルを設定します。

現用系から予備系にManagement Serverの設定情報をコピーします。
現用系と予備系を同じ環境にするために，現用系でのManagement Serverに関する設定内容を予備系にコピーします。

汎用スクリプトファイルを作成します。
運用管理サーバを監視，起動，および停止するための汎用スクリプトファイルを作成します。

クラスタアドミニストレータでクラスタサーバの環境を設定します。
クラスタアドミニストレータを使用して，系で稼働させるサーバの環境を設定します。

17.3.2　クラスタサーバの環境設定

ここでは，Microsoft Cluster Serviceと連携する場合の，Management Serverでの設定時の留意点について説明します。

参考

Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。Management Serverのセットアップについては，「3.4.1　Management Serverのセットアップ」を参照してください。

注意

運用管理サーバ上に論理サーバを定義している場合は，運用管理ポータルを使用して運用管理サーバ上の論理サーバを設定する必要があります。なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，設定不要です。Management Serverを初めて使用するホストの場合には，Management Serverをセットアップしてください。

＜この項の構成＞

(1)　簡易構築定義ファイルでの設定

(1)　簡易構築定義ファイルでの設定

Management ServerのSmart Composer機能の簡易構築定義ファイルで，論理サーバを設置するホストおよび各論理サーバの構成を定義します。また，必要に応じて，各論理サーバの<configuration>タグ内に，論理サーバの環境や起動／停止の動作などを設定します。設定済みの簡易構築定義ファイルを基に，Smart Composer機能のコマンドを使用して，Webシステムをセットアップします。

必要に応じて，サーバ管理コマンドを使用して，J2EEアプリケーション，リソースアダプタをインポートして，開始します。

17.3.3　設定ファイルの編集

設定ファイルを編集します。ここでは，Microsoft Cluster Serviceと連携する場合に注意が必要な設定ファイルについて説明します。なお，現用系と予備系で必要となる設定が異なります。

運用管理エージェントの設定

Management Serverの設定

Management Serverの運用管理コマンド（mngsvrutil）の設定

現用系では，2.と3.を設定してください。1.は運用管理サーバ上に論理サーバを定義している場合だけ設定してください。

予備系では，3.だけ設定してください。1.と2.については，現用系からManagement Serverの設定情報をコピーすることで設定できるため，ここでは設定不要です。

注意

運用管理サーバ上に論理サーバを定義している場合は，運用管理サーバ上の運用管理エージェントを設定する必要があります。なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，設定不要です。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Management Serverの設定

(3)　Management Serverの運用管理コマンド（mngsvrutil）の設定

(1)　運用管理エージェントの設定

運用管理エージェントプロパティファイル（adminagent.properties）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでクラスタIPアドレスを指定します。管理用のリクエストは，クラスタIPアドレスだけで受け付けます。

(2)　Management Serverの設定

Management Server環境設定ファイル（mserver.properties）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。なお，mserver.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

mngsvr.myhost.name
mngsvr.myhost.nameキーでクラスタIPアドレスを指定します。例では，次のように設定します。
mngsvr.myhost.name=192.168.255.111

webserver.connector.http.permitted.hosts
webserver.connector.http.permitted.hostsキーでクラスタIPアドレスを指定します。例では，次のように設定します。
webserver.connector.http.permitted.hosts=192.168.255.111,192.168.0.112
このように指定することで，運用管理サーバのエイリアスIPアドレスおよびアプリケーションサーバからのリクエスト受け付けだけを許可して，運用管理サーバのステーショナリIPアドレスからのリクエストを拒否できるようになります。

(3)　Management Serverの運用管理コマンド（mngsvrutil）の設定

ローカルシステムアカウントのホームディレクトリに，Management Serverの運用管理コマンド（mngsvrutil）のクライアント側定義ファイル（.mngsvrutilrc）を用意し，Management Serverの管理ユーザのユーザIDとパスワードを設定してください。また，クライアント側定義ファイルには適切なアクセス権限を設定してください。

このファイルは，Management Serverを監視，起動，および停止するスクリプトで，mngsvrutilコマンドを実行する際に使用します。

なお，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.3.4　現用系から予備系へのManagement Serverの設定情報のコピー

現用系と予備系を同じ環境にするために，現用系でのManagement Serverに関する設定情報を予備系にコピーします。Management Serverの設定情報の退避／回復コマンドを使用して，現用系で設定したManagement Serverの各種定義ファイル，Management Serverに登録したJ2EEアプリケーションやリソースアダプタなどを，現用系から予備系にコピーしてください。

＜この項の構成＞

(1)　Management Serverの設定情報のコピー手順

(2)　収集対象のファイルの定義

(1)　Management Serverの設定情報のコピー手順

Management Serverの設定情報のコピー手順を次に示します。

現用系で，mstrexportコマンドを実行します。
mstrexportコマンドでは，mstrexportコマンドの実行対象となる現用系のManagement Serverの設定情報を収集し，収集した情報をZIP形式のファイルに保存します。mstrexportコマンドの引数には，保存するZIP形式のファイルのファイル名を指定してください。

コマンドの格納場所
<Cosminexusのインストールディレクトリ>¥manager¥bin

実行例
mstrexport C:¥work¥mstruct.zip

なお，mstrexportコマンドは，mstrexportコマンドの実行対象となるManagement Serverの起動，停止に関係なく実行できます。

手順1.で保存されたZIP形式のファイルを，現用系から予備系にコピーします。

予備系で，mstrimportコマンドを実行します。
mstrimportコマンドでは，コピーしてきたZIP形式のファイルを，コマンドの実行対象となる予備系のManagement Serverに展開します。これによって，現用系のManagement Serverと予備系のManagement Serverを同じ設定にできます。
mstrimportコマンドの引数には，コピーしてきたZIP形式のファイルのファイル名を指定してください。

コマンドの格納場所
<Cosminexusのインストールディレクトリ>¥manager¥bin

実行例
mstrimport D:¥recovery¥mstruct.zip

なお，mstrimportコマンドは，mstrimportコマンドの実行対象のManagement Serverが停止している場合だけ実行できます。

コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　収集対象のファイルの定義

mstrexportコマンドの引数として，mstrexportコマンドの収集対象を記述するファイル（Management Server管理ファイル用退避対象定義ファイル）を指定できます。

実行例

mstrexport c:¥work¥mstruct.zip "C:¥Documents and Settings¥MyUser¥filelist.txt"

mstrexportコマンドでは，デフォルトの状態で，Management Serverの各種定義ファイル，Management Serverに登録したJ2EEアプリケーションやリソースアダプタなど，Management Serverでのシステム構築・運用に必要な情報が収集できます。これらの情報に加えて，ユーザ作成のコマンドなどもmstrexportコマンドでの収集対象に追加したい場合には，収集対象とするファイルの絶対パスをManagement Server管理ファイル用退避対象定義ファイルに記述してください。

ファイルの記述例

${cosminexus.home}/manager/apps/MyApp.ear

/home/confdir/message1.conf

ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.3.5　汎用スクリプトファイルの作成

Management Serverのプロセスを監視，起動および停止するための汎用スクリプトファイルをVBScriptで記述します。現用系の運用管理サーバと予備系の運用管理サーバで同一の汎用スクリプトファイルを使用し，同一のパスに配置してください。

＜この項の構成＞

(1)　汎用スクリプトファイルの例

(2)　汎用スクリプトファイルの関数

(3)　汎用スクリプトファイルの変数

(4)　運用管理サーバをアプリケーションサーバと同じマシンに構築している場合の汎用スクリプトファイルの例

(1)　汎用スクリプトファイルの例

運用管理サーバを1:1に配置して系を切り替える場合の汎用スクリプトファイルの例（GenericScript.vbs）を示します。なお，ここでは，運用管理サーバをアプリケーションサーバとは別のマシンに構築している場合の汎用スクリプトファイルの記述方法について説明します。運用管理サーバをアプリケーションサーバと同じマシンに構築している場合の汎用スクリプトファイルの記述方法については，「(4)　運用管理サーバをアプリケーションサーバと同じマシンに構築している場合の汎用スクリプトファイルの例」を参照してください。

汎用スクリプトファイルに定義する関数と変数については，「(2)　汎用スクリプトファイルの関数」，および「(3)　汎用スクリプトファイルの変数」を参照してください。

運用管理サーバをアプリケーションサーバとは別のマシンに構築している場合に，運用管理サーバで使用する汎用スクリプトファイルの例を次に示します。この汎用スクリプトファイルでは，Management Serverのプロセスを監視します。

Dim WshShell, fso, AccessInfoFile, oExec, oRun, oCosmiHome, oAdmin, oMngsvrc, oMngsvut, oCjsleep, oMngHost, oAAHost
Set WshShell = CreateObject("WScript.Shell")

oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oMngsvrc = """" & oCosmiHome & "¥manager¥bin¥mngsvrctl"""
oMngsvut = """" & oCosmiHome & "¥manager¥bin¥mngsvrutil"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

oMngHost = "192.168.255.111" '--- Management Server

' ==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   Open = True
End Function

' ==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"

   '--- mngsvrctl ---
   Set oExec = WshShell.Exec(oMngsvrc & " start")
   Resource.LogInformation "### Management Server get starting. ### "

   Retries = 20
   For i=0 to Retries
       oRun = oMngsvut & " -m " & oMngHost & ":28080 check mngsvr"
       Set oExec = WshShell.Exec(oRun)
       Do While oExec.Status = 0
           WshShell.Run oCjsleep & " 10", 0, True
       Loop
       If oExec.ExitCode = 0 Then
           Resource.LogInformation "### Management Server started. ### rtn=" & oExec.ExitCode
           Resource.LogInformation oExec.StdErr.ReadAll
           Exit For
       End If
   Next

   If i > Retries Then
       Resource.LogInformation "### Management Server cannot start. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdOut.ReadAll
   End If

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host -s -l 360 start server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers start failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   Online = True
End Function

' ==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq mngsvr.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "mngsvr.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
   End If
End Function

' ==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 check mngsvr"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Management Server command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
   Else
       IsAlive = True
   End If
End Function

' ==== Offline ====
Function Offline( )
   Resource.LogInformation "======== Entering Offline. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host -s -l 360 stop server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers stopping failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   '--- mngsvrctl ---
   Set oExec = WshShell.Exec(oMngsvrc & " stop")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Management Server cannot stop. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdOut.ReadAll
   End If

   Offline = True
End Function

' ==== Close ====
Function Close( )
   Resource.LogInformation "======== Entering Close. ========"
End Function

' ==== Terminate ====
Function Terminate( )
   Resource.LogInformation "======== Entering Terminate. ========"
End Function

(2)　汎用スクリプトファイルの関数

汎用スクリプトファイルには，関数を定義する必要があります。各関数の戻り値は，正常終了時にはTrueを，異常終了時にはFalseを返します。汎用スクリプトファイルの関数を次の表に示します。

表17-5　汎用スクリプトファイルの関数（運用管理サーバの1:1系切り替えの場合）

関数名 | 内容
Open | この汎用スクリプトファイルが開かれるときに実行される関数です。Resource.LogInformationメソッドでクラスタログにログを出力します。
Online | 汎用スクリプトリソースのオンライン時に実行される関数です。この関数で，Management Server，論理サーバを起動します。
LooksAlive | リソースの稼働状況を簡単に把握するための関数です。この関数では，tasklistコマンドでManagement Serverのプロセスの有無を確認します。
IsAlive | リソースの稼働状況を厳密に把握するための関数です。この関数では，mngsvrutilのcheckコマンドでManagement Serverの稼働状況を確認します。
Offline | 汎用スクリプトリソースのオフライン時に実行される関数です。この関数で論理サーバ，Management Serverを停止します。
Close | この汎用スクリプトファイルが閉じるときに実行される関数です。
Terminate | 汎用スクリプトリソースの強制終了時に実行される関数です。

(3)　汎用スクリプトファイルの変数

汎用スクリプトファイルでは，必要に応じて次の表に示す変数の値を変更してください。

表17-6　汎用スクリプトファイルの変数（運用管理サーバの1:1系切り替えの場合）

変数名
内容

oMngHost
Management Serverが稼働しているホストです。
クラスタIPアドレスを指定してください。

oAAHost
運用管理サーバ上の運用管理エージェントが稼働しているホストです。
クラスタIPアドレスを指定してください。

(4)　運用管理サーバをアプリケーションサーバと同じマシンに構築している場合の汎用スクリプトファイルの例

運用管理サーバをアプリケーションサーバと同じマシンに構築している場合に使用する汎用スクリプトファイルの例を次に示します。この汎用スクリプトファイルでは，Management Serverと運用管理エージェントのプロセスを監視します。

Dim WshShell, fso, AccessInfoFile, oExec, oRun, oCosmiHome, oAdmin, oMngsvrc, oMngsvut, oCjsleep, oMngHost, oAAHost
Set WshShell = CreateObject("WScript.Shell")

oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oAdminac = """" & oCosmiHome & "¥manager¥bin¥adminagentctl"""
oMngsvrc = """" & oCosmiHome & "¥manager¥bin¥mngsvrctl"""
oMngsvut = """" & oCosmiHome & "¥manager¥bin¥mngsvrutil"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

oMngHost = "192.168.255.111" '--- Management Server
oAAHost  = "192.168.255.111" '--- Adminagent Server

' ==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   Open = True
End Function

' ==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"

   '--- adminagentctl ---
   Set oExec = WshShell.Exec(oAdminac & " start")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent cannot start. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdOut.ReadAll
   End If

   '--- mngsvrctl ---
   Set oExec = WshShell.Exec(oMngsvrc & " start")
   Resource.LogInformation "### Management Server get starting. ### "

   Retries = 20
   For i=0 to Retries
       oRun = oMngsvut & " -m " & oMngHost & ":28080 check mngsvr"
       Set oExec = WshShell.Exec(oRun)
       Do While oExec.Status = 0
           WshShell.Run oCjsleep & " 10", 0, True
       Loop
       If oExec.ExitCode = 0 Then
           Resource.LogInformation "### Management Server started. ### rtn=" & oExec.ExitCode
           Resource.LogInformation oExec.StdErr.ReadAll
           Exit For
       End If
   Next

   If i > Retries Then
       Resource.LogInformation "### Management Server cannot start. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdOut.ReadAll
   End If

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host -s -l 360 start server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers start failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   Online = True
End Function

' ==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq adminagent.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "adminagent.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
       exit Function
   End If

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq mngsvr.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "mngsvr.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
   End If

End Function

' ==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"

   '--- mngsvrutil ---
   oRun = """" & oCosmiHome & "¥manager¥bin¥adminagentcheck"""
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
       exit Function
   End If

   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host check mngsvr"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Management Server command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
   Else
       IsAlive = True
   End If

End Function

17.3.6　クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータを使用して，現用系，予備系アプリケーションサーバの系で稼働させる実行サーバや待機サーバの環境を定義します。なお，クラスタアドミニストレータの設定の詳細については，OSのマニュアルを参照してください。

運用管理サーバの1:1系切り替えの場合の設定内容を次に示します。

＜この項の構成＞

(1)　リソースグループの設定

(2)　リソースの設定

(1)　リソースグループの設定

次の手順でリソースグループを作成します。

クラスタノードを設定します。
クラスタにノード（Node1，Node2）を追加します。

リソースグループを作成します。
［ファイル］－［新規作成］－［グループ］を選択して，次のリソースグループを作成します。

項目 | 設定値
名前 | Group
説明 | グループ
優先所有者 | Node1，Node2

(2)　リソースの設定

次の手順でリソースを設定します。

共有ディスクを設定します。

クラスタIPアドレスを設定します。

クラスタ名を設定します。

汎用スクリプトを設定します。

各作業について説明します。

(a)　共有ディスクの設定

Cosminexusで設定する「インプロセストランザクションサービスのステータスファイル」の格納先をこの共有ディスクに設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の物理ディスクリソースを作成します。

項目 | 設定値
名前 | Cluster_Disk
説明 | Cluster共有ディスク
リソースの種類 | 物理ディスク
グループ | Group
実行所有者 | Node1，Node2
共有ディスク | Lドライブ（L:¥）

(b)　クラスタIPアドレスの設定

クラスタを管理するためのIPアドレスを設定します。クラスタIPアドレスとして，Management Serverやクライアントから認識されるIPアドレスを設定してください。［ファイル］－［新規作成］－［リソース］を選択して，次のIPアドレスリソースを作成します。

項目 | 設定値
名前 | Cluster_IPAddress
説明 | ClusterIPアドレス
リソースの種類 | IP アドレス
グループ | Group
実行所有者 | Node1，Node2
依存関係 | なし
アドレス | 192.168.255.111
サブネットマスク | 255.255.255.0
ネットワーク | Public Cluster Connection

(c)　クラスタ名の設定

［ファイル］－［新規作成］－［リソース］を選択して，次のネットワーク名リソースを作成します。

項目 | 設定値
名前 | Cluster_HostName
説明 | Clusterクラスタ名
リソースの種類 | ネットワーク名
グループ | Group
実行所有者 | Node1，Node2
依存関係 | Cluster_IPAddress
ネットワーク名 | COSMI

(d)　汎用スクリプトの設定

Microsoft Cluster ServiceからCosminexusを起動，停止する汎用スクリプトリソースを設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の汎用スクリプトリソースを作成します。

項目 | 設定値
名前 | Cluster
説明 | Clusterスクリプト
リソースの種類 | 汎用スクリプト
グループ | Group
実行所有者 | Node1，Node2
依存関係 | Cluster_Disk，Cluster_IPAddress，Cluster_HostName
スクリプトのファイルパス | C:¥MSCS¥GenericScript.vbs

17.4　相互系切り替えシステムの設定（Windowsの場合）

相互系切り替えシステムは，アプリケーションサーバの実行系と待機系を1:1にする構成の一つで，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にする構成（相互スタンバイ構成）のシステムです。それぞれのアプリケーションサーバに同じ種類のJ2EEサーバを配置して，異なるJ2EEサーバを起動しておくことで，それぞれのアプリケーションサーバが実行系として動作しながらお互いの待機系として機能します。どちらか一方の系に障害が発生すると，もう一方の系に切り替えられます。これによって，少ない台数のアプリケーションサーバマシンで，むだの少ない運用ができるようになります。このシステムは，Smart Composer機能を使用して構築します。この節では，相互系切り替えシステムの設定について説明します。

なお，相互系切り替えシステムの詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のアプリケーションサーバの実行系と待機系を相互スタンバイにする構成に関する説明を参照してください。

＜この節の構成＞

17.4.1　相互系切り替えシステムの設定手順

17.4.2　クラスタサーバの環境設定

17.4.3　設定ファイルの編集

17.4.4　汎用スクリプトファイルの作成

17.4.5　クラスタアドミニストレータでのクラスタサーバの環境設定

17.4.6　アプリケーションサーバの設定

17.4.1　相互系切り替えシステムの設定手順

ここでは，システムの構成例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

相互系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-5　相互系切り替えシステムの構成例（Windowsの場合）

この例では，2種類のアプリケーションサーバ（アプリケーションサーバ1，アプリケーションサーバ2とします）を使用しています。アプリケーションサーバ1の実行系（現用系1）と待機系（予備系2），アプリケーションサーバ2の実行系（現用系2）と待機系（予備系1）をそれぞれ1:1で配置しています。それぞれ別の運用管理ドメインを持つManagement Serverを配置し，両方のマシンでManagement Serverを起動させています。

相互系切り替えシステムでは，一つの運用管理ドメイン内に二つの仮想ホストを定義し，それぞれを現用系アプリケーションサーバのホスト，予備系アプリケーションサーバのホストとして構築します。この例では，次のような組み合わせになります。

Node1の現用系1（仮想ホスト1）とNode2の予備系1（仮想ホスト1）

Node2の現用系2（仮想ホスト2）とNode1の予備系2（仮想ホスト2）

仮想ホストでは，一つの運用管理エージェントによってアプリケーションサーバの起動，停止を制御しますが，運用で使用するIPアドレスには異なるIPアドレスを割り当てて，見かけ上は異なるホストであるように定義しています。

Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。相互系切り替えシステムの場合，エイリアスIPアドレスは，Microsoft Cluster Serviceによって動的に割り当てられるアドレス（クラスタIPアドレス）となります。アプリケーションサーバの運用に使用するIPアドレスには，クラスタIPアドレスを使用し，Management Serverから運用管理エージェントに対するリクエストの送信には，系切り替えによって他系に移動しないIPアドレス（ステーショナリIPアドレス）を使用します。

(2)　システムの設定手順

Microsoft Cluster Serviceと連携する場合には，Management Serverやクラスタアドミニストレータの設定などが必要になります。相互系切り替えシステムの設定手順を次の図に示します。

図17-6　相互系切り替えシステムの設定手順（Windowsの場合）

図中の1.～7.について説明します。

共有ディスクにパーティションを作成して，ファイルシステムを構築します。
Microsoft Cluster Serviceのクラスタ管理用ファイルの格納場所を作成します。また，グローバルトランザクションを使用する場合には，トランザクション情報の格納場所を作成します。なお，クラスタ管理用ファイルの格納場所とトランザクション情報の格納場所は，同じパーティションでもかまいません。

システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系1と予備系1，現用系2と予備系2で，同じドライブ文字を割り当ててください。

Management Serverでクラスタサーバの環境を設定します。
Management ServerのSmart Composer機能の簡易構築定義ファイルで，Microsoft Cluster Serviceを使用する場合の設定をします。

設定ファイルを編集します。
簡易構築定義ファイルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

汎用スクリプトファイルを作成します。
アプリケーションサーバを起動，停止するための汎用スクリプトファイルを作成します。

クラスタアドミニストレータでクラスタサーバの環境を設定します。
クラスタアドミニストレータを使用して，系で稼働させるサーバの環境を設定します。

Management Serverとクラスタアドミニストレータで，アプリケーションサーバの設定をします。
Management Serverとクラスタアドミニストレータを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

17.4.2　クラスタサーバの環境設定

ここでは，Microsoft Cluster Serviceと連携する場合の，Management Serverでの設定時の留意点について説明します。

参考

Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。Management Serverのセットアップについては，「3.4.1　Management Serverのセットアップ」を参照してください。

＜この項の構成＞

(1)　簡易構築定義ファイルでの設定

(1)　簡易構築定義ファイルでの設定

Management ServerのSmart Composer機能の簡易構築定義ファイルで，論理サーバを設置するホストおよび各論理サーバの構成を定義するときの留意点を次に示します。

ホストの定義
運用管理ドメイン内のホストを定義します。現用系および予備系の仮想ホストで，<host-name>タグにそれぞれのサーバの運用に使用するクラスタIPアドレスを設定します。例では，次のように設定します。

Node1の現用系1とNode2の予備系1の場合：192.168.1.111

Node2の現用系2とNode1の予備系2の場合：192.168.2.222

また，<agent-host>タグには，自ホストのステーショナリIPアドレスを設定します。例では，次のように設定します。

Node1の場合：192.168.0.11

Node2の場合：192.168.0.22

また，論理J2EEサーバ（j2ee-server），論理Webサーバ（web-server）の<configuration>タグの設定での留意点を次に示します。

(a)　論理J2EEサーバの設定

ホストの固定の設定
論理J2EEサーバ（j2ee-server）の<configuration>タグ内の次のパラメタに，任意の値を設定して，管理用ホストおよび運用用ホストを固定してください。

mngagent.connector.hostパラメタ（運用管理エージェントのホスト名またはIPアドレス）

vbroker.se.iiop_tp.hostパラメタ（J2EEサーバ単位でEJBコンテナのホスト名またはIPアドレス）

webserver.connector.http.bind_hostパラメタ（Webコンテナの管理用サーバで使用するローカルIPアドレス，または解決できるローカルホスト名称）

グローバルトランザクションの設定
グローバルトランザクションを使用する場合は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内の次のパラメタに，次の設定をしてください。

ejbserver.distributedtx.XATransaction.enabledパラメタ（ライトトランザクション機能の有効または無効の設定）に「false」を設定します。デフォルトでは「false」が設定されています。

ejbserver.distributedtx.ots.status.directory1パラメタ（インプロセスOTSのステータスファイルのバックアップの格納先）に，共有ディスク装置のディレクトリを設定します。デフォルトでは「otsstatus」が設定されています。
設定例
L:¥Group1¥otsstatus

(b)　論理Webサーバの設定

論理Webサーバ（web-server）の<configuration>タグ内に，次の設定が必要です。

ホストの固定の設定
Listenパラメタで，リクエストを受け付けるIPアドレスまたはホスト名を設定して，Webサーバのホストを固定してください。

17.4.3　設定ファイルの編集

設定ファイルを編集します。ここでは，Microsoft Cluster Serviceと連携する場合に注意が必要な設定ファイルについて説明します。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Management Serverの運用管理コマンド（mngsvrutil）の設定

(1)　運用管理エージェントの設定

adminagent.properties（運用管理エージェントプロパティファイル）に設定する項目のうち，Microsoft Cluster Serviceと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでステーショナリIPアドレス（例では，192.168.0.11，または192.168.0.22）を指定します。管理用のリクエストは，ステーショナリIPアドレスだけで受け付けます。

(2)　Management Serverの運用管理コマンド（mngsvrutil）の設定

<Cosminexusのインストールディレクトリ>¥manager¥configディレクトリ下に，Management Serverの運用管理コマンド（mngsvrutil）のクライアント側共通定義ファイル（mngsvrutilcl.properties）を用意し，Management Serverの管理ユーザのユーザIDとパスワードを設定してください。また，クライアント側共通定義ファイルには適切なアクセス権限を設定してください。

このファイルは，運用管理エージェントを監視するスクリプト，および論理サーバを起動，停止するスクリプトで，mngsvrutilコマンドを実行する際に使用します。

なお，mngsvrutilコマンドのクライアント側共通定義ファイル（mngsvrutilcl.properties）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.4.4　汎用スクリプトファイルの作成

運用管理エージェントのプロセスを監視し，論理サーバを起動・停止するための汎用スクリプトファイルを作成します。

＜この項の構成＞

(1)　汎用スクリプトファイルの例

(2)　汎用スクリプトファイルの関数

(3)　汎用スクリプトファイルの変数

(1)　汎用スクリプトファイルの例

相互系切り替えの場合の汎用スクリプトファイルの例（GenericScriptA.vbs）を次に示します。なお，汎用スクリプトファイルに定義する関数と変数については，「(2)　汎用スクリプトファイルの関数」，および「(3)　汎用スクリプトファイルの変数」を参照してください。

Dim WshShell, oExec, oRun, oCosmiHome, oAdmin, oMngsvut, oCjsleep, oMngHost, oAAHost
Set WshShell = CreateObject("WScript.Shell")

oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oAdminac = """" & oCosmiHome & "¥manager¥bin¥adminagentctl"""
oMngsvut = """" & oCosmiHome & "¥manager¥bin¥mngsvrutil"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

oMngHost = "192.168.0.11" '--- Management Server
oAAHost  = "192.168.1.111" '--- Adminagent Server

' ==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   Open = True
End Function

' ==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host -s -l 360 start server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers start failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   Online = True
End Function

' ==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq adminagent.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "adminagent.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
   End If
End Function

' ==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host check adminAgent"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
   Else
       IsAlive = True
   End If
End Function

' ==== Offline ====
Function Offline( )
   Resource.LogInformation "======== Entering Offline. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -t " & oAAHost & " -k host -s -l 360 stop server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers stopping failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
   End If

   Offline = True
End Function

' ==== Close ====
Function Close( )
   Resource.LogInformation "======== Entering Close. ========"
End Function

' ==== Terminate ====
Function Terminate( )
   Resource.LogInformation "======== Entering Terminate. ========"
End Function

なお，この汎用スクリプトファイルは，Node1（現用系1と予備系2）で稼働する，運用管理エージェントのプロセスを監視する場合の例です。この汎用スクリプトファイルをNode2（予備系1と現用系2）で使用する場合には，次のように置き換えてください。

oMngHostをNode2のステーショナリIPアドレス（192.168.0.22）に置き換えます。

oAAHostをNode2の現用系2（仮想ホスト2）のクラスタIPアドレス（192.168.2.222）に置き換えます。

(2)　汎用スクリプトファイルの関数

汎用スクリプトファイルには，関数を定義する必要があります。各関数の戻り値は，正常終了時にはTrueを，異常終了時にはFalseを返します。汎用スクリプトファイルの関数を次の表に示します。

表17-7　汎用スクリプトファイルの関数（相互系切り替えシステムの場合）

関数名 | 内容
Open | この汎用スクリプトファイルが開かれるときに実行される関数です。Resource.LogInformationメソッドでクラスタログにログを出力します。
Online | 汎用スクリプトリソースのオンライン時に実行される関数です。この関数で，論理サーバを起動します。
LooksAlive | リソースの稼働状況を簡単に把握するための関数です。この関数では，tasklistコマンドで運用管理エージェントのプロセスの有無を確認します。
IsAlive | リソースの稼働状況を厳密に把握するための関数です。この関数では，mngsvrutilのcheckコマンドで運用管理エージェントが正常に動作しているかを確認します。
Offline | 汎用スクリプトリソースのオフライン時に実行される関数です。この関数で論理サーバを停止します。
Close | この汎用スクリプトファイルが閉じるときに実行される関数です。
Terminate | 汎用スクリプトリソースの強制終了時に実行される関数です。

(3)　汎用スクリプトファイルの変数

汎用スクリプトファイルでは，必要に応じて次の表に示す変数の値を変更してください。

表17-8　汎用スクリプトファイルの変数（相互系切り替えシステムの場合）

変数名
内容

oMngHost
Management Serverが稼働しているホストです。
自ホストのステーショナリIPアドレスを指定してください。

oAAHost
運用管理エージェントが稼働しているホストです。
現用系の仮想ホストのクラスタIPアドレスを指定してください。

17.4.5　クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータを使用して，現用系，予備系アプリケーションサーバの系で稼働させる実行サーバや待機サーバの環境を定義します。なお，クラスタアドミニストレータの設定の詳細については，OSのマニュアルを参照してください。

相互系切り替えシステムの場合の設定内容を次に示します。

＜この項の構成＞

(1)　リソースグループの設定

(2)　リソースの設定

(1)　リソースグループの設定

次の手順でリソースグループを作成します。

クラスタノードを設定します。
クラスタにノード（Node1，Node2）を追加します。

リソースグループを作成します。
［ファイル］－［新規作成］－［グループ］を選択して，次のリソースグループを作成します。

項目 | 設定値
現用系1（予備系2）の場合 | 予備系1（現用系2）の場合
名前 | GroupA | GroupB
説明 | グループA | グループB
優先所有者 | Node1，Node2 | Node2，Node1

(2)　リソースの設定

次の手順でリソースを設定します。

共有ディスクを設定します。

クラスタIPアドレスを設定します。

クラスタ名を設定します。

汎用スクリプトを設定します。

各作業について説明します。

(a)　共有ディスクの設定

トランザクション情報を共有ディスクに格納するための設定をします。Cosminexusで設定する「インプロセストランザクションサービスのステータスファイル」の格納先をこの共有ディスクに設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の物理ディスクリソースを作成します。

項目 | 設定値
現用系1（予備系2）の場合 | 予備系1（現用系2）の場合
名前 | ClusterA_Disk | ClusterB_Disk
説明 | ClusterA共有ディスク | ClusterB共有ディスク
リソースの種類 | 物理ディスク | 物理ディスク
グループ | GroupA | GroupB
実行所有者 | Node1，Node2 | Node1，Node2
共有ディスク | Lドライブ（L:¥） | Mドライブ（M:¥）

(b)　クラスタIPアドレスの設定

クラスタを管理するためのIPアドレスを設定します。クラスタIPアドレスとして，Management Serverやクライアントから認識されるIPアドレスを設定してください。［ファイル］－［新規作成］－［リソース］を選択して，次のIPアドレスリソースを作成します。

項目 | 設定値
現用系1（予備系2）の場合 | 予備系1（現用系2）の場合
名前 | ClusterA_IPAddress | ClusterB_IPAddress
説明 | ClusterA IPアドレス | ClusterB IPアドレス
リソースの種類 | IP アドレス | IP アドレス
グループ | GroupA | GroupB
実行所有者 | Node1，Node2 | Node1，Node2
依存関係 | なし | なし
アドレス | 192.168.0.11 | 192.168.0.22
サブネットマスク | 255.255.0.0 | 255.255.0.0
ネットワーク | Public Cluster Connection | Public Cluster Connection

(c)　クラスタ名の設定

クラスタを管理するためのクラスタ名を設定します。［ファイル］－［新規作成］－［リソース］を選択して，次のネットワーク名リソースを作成します。

項目 | 設定値
現用系1（予備系2）の場合 | 予備系1（現用系2）の場合
名前 | ClusterA_HostName | ClusterB_HostName
説明 | ClusterAクラスタ名 | ClusterBクラスタ名
リソースの種類 | ネットワーク名 | ネットワーク名
グループ | GroupA | GroupB
実行所有者 | Node1，Node2 | Node1，Node2
依存関係 | ClusterA_IPAddress | ClusterB_IPAddress
ネットワーク名 | COSMI1 | COSMI2

(d)　汎用スクリプトの設定

Microsoft Cluster ServiceからCosminexusを起動，停止する汎用スクリプトリソースを設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の汎用スクリプトリソースを作成してください。

項目
設定値

現用系1（予備系2）の場合
予備系1（現用系2）の場合

名前
ClusterA
ClusterB

説明
ClusterA用汎用スクリプト
ClusterB用汎用スクリプト

リソースの種類
汎用スクリプト
汎用スクリプト

グループ
GroupA
GroupB

実行所有者
Node1，Node2
Node1，Node2

依存関係
ClusterA_Disk，
ClusterA_IPAddress，
ClusterA_HostName
ClusterB_Disk，
ClusterB_IPAddress，
ClusterB_HostName

スクリプトのファイルパス
C:¥MSCS¥GenericScriptA.vbs
C:¥MSCS¥GenericScriptB.vbs

17.4.6　アプリケーションサーバの設定

アプリケーションサーバの設定では，Management Serverとクラスタアドミニストレータを使用してCosminexusをクラスタ構成に配置します。また，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポート，および開始します。アプリケーションサーバの設定手順を次に示します。

Node1およびNode2で，それぞれ運用管理エージェント，およびManagement Serverを起動します。
運用管理エージェント，およびManagement Serverの起動方法については，「3.2　システムの起動と停止の設定」を参照してください。

クラスタサービスを開始して，リソースグループGroupAとGroupBをそれぞれオンラインにします。
現用系のアプリケーションサーバ（Node1の現用系1とNode2の現用系2）が起動されて，予備系のアプリケーションサーバ（Node2の予備系1とNode1の予備系2）が待機状態になっている，通常の運用状態になります。

現用系のアプリケーションサーバ（Node1の現用系1とNode2の現用系2）に対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。また，サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

クラスタアドミニストレータで，リソースグループGroupBに対して「グループの移動」を実行して系を切り替え，Node1の予備系2のアプリケーションサーバを起動します。

Node1の予備系2のアプリケーションサーバに対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
Node1の予備系2には，Node2の現用系2と同じJ2EEアプリケーションとリソースアダプタをインポートします。

クラスタアドミニストレータで，リソースグループGroupBに対して「グループの移動」を実行して系を切り替え，Node2の現用系2のアプリケーションサーバを起動し，通常の運用状態に戻します。

リソースグループGroupAに対して「グループの移動」を実行して系を切り替え，Node2の予備系1のアプリケーションサーバを起動します。

Node2の予備系1のアプリケーションサーバに対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
Node2の予備系1には，Node1の現用系1と同じJ2EEアプリケーションとリソースアダプタをインポートします。

リソースグループGroupAに対して「グループの移動」を実行して系を切り替え，Node1の現用系1のアプリケーションサーバを起動し，通常の運用状態に戻します。

17.5　N:1リカバリシステムの設定（Windowsの場合）

N:1リカバリシステムは，N台の実行系に対して1台の待機系（リカバリ専用サーバ）を用意する構成のシステムです。J2EEサーバを冗長化した構成でグローバルトランザクションを使用する場合に，特定のJ2EEサーバにトラブルが発生したとき，トランザクションを決着するために使用します。このシステムは，運用管理ポータルを使用して構築します。運用管理ポータルについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。この節では，N:1リカバリシステムの設定について説明します。

業務は，N台の実行系のアプリケーションサーバで実行します。業務実行中のアプリケーションサーバに障害が発生すると，Microsoft Cluster Serviceがこれを検知して，リカバリ専用サーバで，障害が発生したアプリケーションサーバの仕掛かり中のトランザクションを決着します。その後，残りの稼働中の実行系のアプリケーションサーバで業務を続行します。

なお，N:1リカバリシステムの詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のリカバリ専用サーバを使用する場合の構成に関する説明を参照してください。

＜この節の構成＞

17.5.1　N:1リカバリシステムの設定手順

17.5.2　クラスタサーバの環境設定

17.5.3　設定ファイルの編集

17.5.4　実行系の汎用スクリプトファイルの作成

17.5.5　待機系の汎用スクリプトファイルの作成

17.5.6　クラスタアドミニストレータでのクラスタサーバの環境設定

17.5.7　アプリケーションサーバの設定

17.5.1　N:1リカバリシステムの設定手順

ここでは，システムの構成例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

N:1リカバリシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-7　システムの構成例（N:1リカバリシステムの場合）

この例では，4台の実行系サーバと1台のリカバリ専用サーバを配置しています。4台の実行系のうち，3台の実行系では，同じJ2EEサーバ名で同じJ2EEアプリケーションとリソースアダプタがデプロイされている「MyServer」というJ2EEサーバを配置しています。残りの1台の実行系では，J2EEサーバ名や，デプロイされているJ2EEアプリケーションとリソースアダプタが異なる「MyServer2」というJ2EEサーバを配置しています。

N:1リカバリ構成の場合，一つのクラスタ内に複数の仮想ホストを構築します。仮想ホストは実行系ノードとリカバリ専用ノードの組で構成し，J2EEサーバをクラスタ構成で配置します。N:1リカバリ構成の場合，J2EEサーバはクラスタ内ではなく，仮想ホスト内で動作します。このため，仮想ホストのIPアドレスおよびホスト名を設定してください。

仮想ホストは一つのリソースグループとして定義され，「物理ディスクリソース」，「IPアドレスリソース」，「ネットワークリソース名」，「汎用スクリプトリソース」が仮想ホストに含まれます。ここでのリソースグループの例を次の図に示します。

図17-8　リソースグループの例

Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。N:1リカバリ構成の場合，エイリアスIPアドレスは，仮想ホストのIPアドレスとなります。

待機系のJ2EEサーバには，実行系のJ2EEサーバで使用しているすべてのリソースアダプタと同じ設定のリソースアダプタをインポート，およびデプロイしてください。

(2)　システムの設定手順

Microsoft Cluster Serviceと連携する場合には，運用管理ポータルやクラスタアドミニストレータの設定などが必要になります。N:1リカバリシステムの設定手順を次の図に示します。

図17-9　システムの設定手順（N:1リカバリシステムの場合）

図中の1.～7.について説明します。

共有ディスクにN台分のパーティションを作成して，ファイルシステムを構築します。
Microsoft Cluster Serviceのクラスタ管理用ファイルの格納場所を作成します。また，N:1リカバリシステムではグローバルトランザクションを使用するため，トランザクション情報の格納場所を作成します。なお，クラスタ管理用ファイルの格納場所とトランザクション情報の格納場所は，同じパーティションでもかまいません。

システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，実行系と待機系で，同じドライブ文字を割り当ててください。

運用管理ポータルでクラスタサーバの環境を設定します。
運用管理ポータルの「運用管理ドメインの構成定義」，および「論理サーバの環境設定」で，Microsoft Cluster Serviceを使用する場合の設定をします。

設定ファイルを編集します。
運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

汎用スクリプトファイルを作成します。
アプリケーションサーバを監視，起動，停止するための汎用スクリプトファイルを作成します。

クラスタアドミニストレータでクラスタサーバの環境を設定します。
クラスタアドミニストレータを使用して，系で稼働させるサーバの環境を設定します。

運用管理ポータル，クラスタアドミニストレータなどで，アプリケーションサーバの設定をします。
運用管理ポータル，クラスタアドミニストレータなどを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

17.5.2　クラスタサーバの環境設定

Microsoft Cluster Serviceと連携する場合の，運用管理ポータルでの設定の留意点については，「17.2.2　クラスタサーバの環境設定」を参照してください。

なお，N:1リカバリ構成の場合，ホスト名には，クラスタIPアドレスではなく，仮想ホストのIPアドレスを設定してください。

17.5.3　設定ファイルの編集

運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。ここでは，Microsoft Cluster Serviceと連携する場合に注意が必要なファイルの設定について説明します。

＜この項の構成＞

(1)　設定が必要なファイル

(2)　待機系でのJ2EEサーバのプロパティの設定

(1)　設定が必要なファイル

設定が必要なファイルは実行系と待機系で異なります。

実行系の場合

実行系の場合に注意が必要な設定を次に示します。

運用管理エージェントの設定

Hitachi Web Serverの設定

ワーカの設定

スマートエージェントの設定

これらのファイルの設定については，「17.2.3　設定ファイルの編集」を参照してください。なお，N:1リカバリ構成の場合には，クラスタIPアドレスではなく，仮想ホストのIPアドレスを設定してください。

待機系（リカバリ専用）の場合

待機系（リカバリ専用）の場合に注意が必要な設定を次に示します。

J2EEサーバのプロパティの設定

この設定について，次に説明します。

(2)　待機系でのJ2EEサーバのプロパティの設定

待機系のJ2EEサーバでusrconf.propertiesにプロパティを設定するときに注意が必要なキーを次に示します。

ejbserver.distributedtx.XATransaction.enabled
ライトトランザクションを無効にするため「false」を設定してください。

17.5.4　実行系の汎用スクリプトファイルの作成

実行系のアプリケーションサーバを起動，停止するためのスクリプトファイルをVBScriptで記述します。実行系の各ノードで同一のスクリプトファイルを使用し，同一のパスに配置してください。

＜この項の構成＞

(1)　実行系の汎用スクリプトファイルの例

(2)　実行系の汎用スクリプトファイルの関数

(3)　実行系の汎用スクリプトファイルの変数

(4)　プライベートプロパティの設定

(1)　実行系の汎用スクリプトファイルの例

N:1リカバリシステムの実行系で使用する汎用スクリプトファイルの例を次に示します。なお，汎用スクリプトファイルに定義する関数と変数については，「(2)　実行系の汎用スクリプトファイルの関数」，および「(3)　実行系の汎用スクリプトファイルの変数」を参照してください。また，仮想サーバごとに設定するプライベートプロパティについては，「(4)　プライベートプロパティの設定」を参照してください。

Dim WshShell, fso, AccessInfoFile, oExec, oRun, oCosmiHome, oAdmin, oMngsvut, oCjsleep
Dim oMngHost, oUser, oPass
Set WshShell = CreateObject("WScript.Shell")

oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oAdminac = """" & oCosmiHome & "¥manager¥bin¥adminagentctl"""
oMngsvut = """" & oCosmiHome & "¥manager¥bin¥mngsvrutil"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

oMngHost = "172.16.12.39" '--- Management Server
oUser = "admin" ' --- Management Server's userid
oPass = "admin" ' --- Management Server's password

'==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   ' --- J2EE Server Name ---
   If Resource.PropertyExists("ServerName") = False Then
       Resource.LogInformation "### Private property ServerName is not set. ###"
   End If
   ' --- Inprocess OTS Status Path ---
   If Resource.PropertyExists("StatusPath") = False Then
       Resource.LogInformation "### Private property StatusPath is not set. ###"
   End If
   ' --- Cluster IP Address ---
   If Resource.PropertyExists("IPAddress") = False Then
       Resource.LogInformation "### Private property IPAddress is not set. ###"
   End If
   ' --- Cluster Host Name ---
   If Resource.PropertyExists("HostName") = False Then
       Resource.LogInformation "### Private property HostName is not set. ###"
   End If
   Open = True
End Function

'==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"

   '--- private properties ---
   If Resource.PropertyExists("ServerName") = False Or _
      Resource.PropertyExists("StatusPath") = False Or _
      Resource.PropertyExists("IPAddress") = False Or _
      Resource.PropertyExists("HostName") = False Then
        Resource.LogInformation "### Private property is not set. ###"
        Online = False
        Exit Function
   End If

   '--- adminagentctl ---
   Set oExec = WshShell.Exec(oAdminac & " start")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent cannot start. ### rtn=" & oResult
       Resource.LogInformation oExec.StdErr.ReadAll
       Online = False
       Exit Function
   End If

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m "& oMngHost &":28080 -u " & oUser & " -p " & oPass & _
                     " -t " & Resource.IPAddress & " -k host -s start server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Servers start failed. ### rtn=" & oResult
       Resource.LogInformation oExec.StdErr.ReadAll
       Online = False
       Exit Function
   End If
   Online = True
End Function

'==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"

   '--- tasklist ---
   Set oExec = WshShell.Exec("tasklist /NH /FI ""IMAGENAME eq adminagent.exe""")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop

   If InStr(1, oExec.StdOut.ReadAll, "adminagent.exe", 1) <> 0 Then
       LooksAlive = True
   Else
       LooksAlive = False
   End If
End Function

'==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -u " & oUser & " -p " & oPass & _
                     " -t " & Resource.IPAddress & " -k host check adminAgent"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent command failed. ### rtn=" & oExec.ExitCode
       Resource.LogInformation oExec.StdErr.ReadAll
       IsAlive = False
   Else
       IsAlive = True
   End If
End Function

'==== Offline ====
Function Offline( )
   Resource.LogInformation "======== Entering Offline. ========"

   '--- mngsvrutil ---
   oRun = oMngsvut & " -m " & oMngHost & ":28080 -u " & oUser & " -p " & oPass & _
                     " -t " & Resource.IPAddress & " -k host -s stop server"
   Set oExec = WshShell.Exec(oRun)
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Logical Server stopping failed. ### rtn=" & oResult
       Resource.LogInformation oExec.StdErr.ReadAll
       Offline = False
       Exit Function
   End If

   '--- adminagentctl ---
   Set oExec = WshShell.Exec(oAdminac & " stop")
   Do While oExec.Status = 0
       WshShell.Run oCjsleep & " 1", 0, True
   Loop
   If oExec.ExitCode <> 0 Then
       Resource.LogInformation "### Administration Agent stopping failed. ### rtn=" & oResult
       Resource.LogInformation oExec.StdErr.ReadAll
       Offline = False
       Exit Function
   End If
   Offline = True
End Function

'==== Close ====
Function Close( )
   Resource.LogInformation "======== Entering Close. ========"
   Close = True
End Function

'==== Terminate ====
Function Terminate( )
   Resource.LogInformation "======== Entering Terminate. ========"
   Terminate = True
End Function

(2)　実行系の汎用スクリプトファイルの関数

汎用スクリプトファイルには，関数を定義する必要があります。各関数の戻り値は，正常終了時には「True」を，異常終了時には「False」を返します。実行系の汎用スクリプトファイルに定義する関数を次の表に示します。

表17-9　実行系の汎用スクリプトファイルの関数（N:1リカバリシステムの場合）

関数名 | 内容
Open | この汎用スクリプトファイルが開かれるときに実行される関数です。プライベートプロパティが設定されているかどうかを判定します。
Online | 汎用スクリプトリソースのオンライン時に実行される関数です。この関数で運用管理エージェントと論理サーバを起動します。
LooksAlive | リソースの稼働状況を簡単に把握するための関数です。この関数では，tasklistコマンドで運用管理エージェントのプロセスの有無を確認します。
IsAlive | リソースの稼働状況を厳密に把握するための関数です。この関数では，運用管理エージェントのcheckコマンドで運用管理エージェントが正常に動作しているかを確認します。
Offline | 汎用スクリプトリソースのオフライン時に実行される関数です。この関数で運用管理エージェントと論理サーバを停止します。
Close | この汎用スクリプトファイルが閉じるときに実行される関数です。
Terminate | 汎用スクリプトリソースの強制終了時に実行される関数です。

(3)　実行系の汎用スクリプトファイルの変数

実行系の汎用スクリプトファイルでは，必要に応じて次の表に示す変数の値を変更してください。

表17-10　実行系の汎用スクリプトファイルの変数（N:1リカバリシステムの場合）

変数名 | 内容
oMngHost | Management Serverが稼働しているホスト
oUser | Management ServerにログインするためのログインID
oPass | Management Serverにログインするためのパスワード

(4)　プライベートプロパティの設定

N:1リカバリシステムの汎用スクリプトファイルでは，一つのスクリプトファイルを複数の仮想サーバから参照します。このため，汎用スクリプトファイルがサーバごとの設定を参照できるように，プライベートプロパティを使用します。

仮想サーバごとにプライベートプロパティを設定してください。汎用スクリプトファイルに必要なプライベートプロパティを次の表に示します。

表17-11　汎用スクリプトファイルに必要なプライベートプロパティ

プライベートプロパティ
内容（例）

ServerName
J2EEサーバ名
指定例：MyServer

StatusPath
インプロセスOTSのステータスパス
指定例：I:¥otsstatus

IPAddress
仮想サーバのIPアドレス
指定例：172.16.12.31

HostName
仮想サーバ名
指定例：Server1

プライベートプロパティはclusterコマンドで設定します。clusterコマンドについては，Windows Server 2003のマニュアルを参照してください。次にclusterコマンドを使用したプライベートプロパティの設定例を示します。

cluster res Script1 /priv ServerName=MyServer
cluster res Script1 /priv StatusPath="I:¥otsstatus"
cluster res Script1 /priv IPAddress=172.16.12.31
cluster res Script1 /priv HostName=Server1

cluster res Script2 /priv ServerName=MyServer
cluster res Script2 /priv StatusPath="J:¥otsstatus"
cluster res Script2 /priv IPAddress=172.16.12.32
cluster res Script2 /priv HostName=Server2

cluster res Script3 /priv ServerName=MyServer
cluster res Script3 /priv StatusPath="K:¥otsstatus"
cluster res Script3 /priv IPAddress=172.16.12.33
cluster res Script3 /priv HostName=Server3

cluster res Script4 /priv ServerName=MyServer2
cluster res Script4 /priv StatusPath="L:¥otsstatus"
cluster res Script4 /priv IPAddress=172.16.12.34
cluster res Script4 /priv HostName=Server4

17.5.5　待機系の汎用スクリプトファイルの作成

待機系でリカバリ処理を実行するための汎用スクリプトファイルをVBScriptで記述します。

＜この項の構成＞

(1)　待機系の汎用スクリプトファイルの例

(2)　待機系の汎用スクリプトファイルの関数

(3)　待機系の汎用スクリプトファイルの変数

(1)　待機系の汎用スクリプトファイルの例

N:1リカバリシステムの待機系で使用する汎用スクリプトファイルの例を次に示します。なお，汎用スクリプトファイルに定義する関数と変数については，「(2)　待機系の汎用スクリプトファイルの関数」，および「(3)　待機系の汎用スクリプトファイルの変数」を参照してください。

Dim WshShell, fso, oExec, oRun, oCosmiHome, oRecover, oCjsleep

Set WshShell = CreateObject("WScript.Shell")
oCosmiHome = WshShell.ExpandEnvironmentStrings("%COSMINEXUS_HOME%")
oRecover = """" & oCosmiHome & "¥CC¥server¥bin¥cjstartrecover"""
oCjsleep = """" & oCosmiHome & "¥CC¥server¥bin¥cjsleep"""

'==== Open ====
Function Open( )
   Resource.LogInformation "======== Entering Open. ========"
   ' --- J2EE Server Name ---
   If Resource.PropertyExists("ServerName") = False Then
       Resource.LogInformation "### Private property ServerName is not set. ###"
   End If
   ' --- Inprocess OTS Status Path ---
   If Resource.PropertyExists("StatusPath") = False Then
       Resource.LogInformation "### Private property StatusPath is not set. ###"
   End If
   ' --- Cluster IP Address ---
   If Resource.PropertyExists("IPAddress") = False Then
       Resource.LogInformation "### Private property IPAddress is not set. ###"
   End If
   ' --- Cluster Host Name ---
   If Resource.PropertyExists("HostName") = False Then
       Resource.LogInformation "### Private property HostName is not set. ###"
   End If
   Open = True
End Function

'==== Online ====
Function Online( )
   Resource.LogInformation "======== Entering Online. ========"
   RecoverSuccess = 0

   '--- private properties ---
   If Resource.PropertyExists("ServerName") = False Or _
      Resource.PropertyExists("StatusPath") = False Or _
      Resource.PropertyExists("IPAddress") = False Or _
      Resource.PropertyExists("HostName") = False Then

      Resource.LogInformation "### Private property is not set. ###"
      Online = False
      Exit Function
   End If

   ' --- A parameters of recover command ---
   Dir_Name = "C:¥MSCS¥RecoverExclusive"
   Sleep_Time = 60
   Retries = 30

   Set fso = CreateObject("Scripting.FileSystemObject")

   oRun = oRecover & " " & Resource.ServerName _
                   & " -p vbroker.se.iiop_tp.host=" & Resource.IPAddress _
                   & " -p ejbserver.distributedtx.ots.status.directory1=" & Resource.StatusPath _
                   & " -t 600"

   On Error Resume Next
   For i=0 To Retries
       Err.Clear
       fso.CreateFolder(Dir_Name)
       If Err.Number = 0 Then
           '--- cjstartrecover ---
           Resource.LogInformation "[" & Resource.HostName & "]--- cjstartrecover start... ---"
           Resource.LogInformation "[" & Resource.HostName & "]" & oRun
           Set oResult = WshShell.Run(oRun, 0, True)
           If oResult <> 0 Then
               Resource.LogInformation "[" & Resource.HostName & _
                   "]### cjstartrecover command is failed. ### rtn=" & oResult
           End If
           fso.DeleteFolder(Dir_Name)
           RecoverSuccess = 1
           Resource.LogInformation "[" & Resource.HostName & "]--- The revover command finished. ---"
           Exit For
       Else
           Resource.LogInformation "[" & Resource.HostName & "]CreateFolder()=" & Err.Number & " " & Err.Description
           Resource.LogInformation "[" & Resource.HostName & "]" & oCjsleep & " " & Sleep_Time & " retry=" & i
           WshShell.Run oCjsleep & " " & Sleep_Time, 0, True
       End If
   Next
   On Error Goto 0

   If RecoverSuccess = 0 Then
       Resource.LogInformation "[" & Resource.HostName & "]### Timeout occurred before starting cjstartrecover. ###"
       Resource.LogInformation "[" & Resource.HostName & "]### Perform following command manually. ###"
       Resource.LogInformation "[" & Resource.HostName & "]" & oRun
       Online = False
       Exit Function
   End If

   WshShell.Run "cluster res " & Resource.Name & " /off", 0, False
   Online = True
End Function

'==== LooksAlive ====
Function LooksAlive( )
   Resource.LogInformation "======== Entering LooksAlive. ========"
   LooksAlive = True
End Function

'==== IsAlive ====
Function IsAlive( )
   Resource.LogInformation "======== Entering IsAlive. ========"
   IsAlive = True
End Function

'==== Offline ====
Function Offline( )
   Resource.LogInformation "======== Entering Offline. ========"
   Offline = True
End Function

'==== Close ====
Function Close( )
   Resource.LogInformation "======== Entering Close. ========"
   Close = True
End Function

'==== Terminate ====
Function Terminate( )
   Resource.LogInformation "======== Entering Terminate. ========"
   Terminate = True
End Function

(2)　待機系の汎用スクリプトファイルの関数

汎用スクリプトファイルには，関数を定義する必要があります。各関数の戻り値は，正常終了時には「True」を，異常終了時には「False」を返します。待機系の汎用スクリプトファイルに定義する関数を次の表に示します。

表17-12　待機系の汎用スクリプトファイルの関数（N:1リカバリシステムの場合）

関数名 | 内容
Open | このスクリプトファイルが開かれるときに実行される関数です。プライベートプロパティが設定されているかどうかを判定します。
Online | 汎用スクリプトリソースのオンライン時に実行される関数です。CreateFolderメソッドを利用して，リカバリ処理が排他的に実行されるようにします。Dir_Nameフォルダが作成できた場合はErr.Numberに0が設定され，リカバリ処理を実行します。リカバリ処理終了後，Dir_Nameフォルダを削除して，リソースをオフラインにします。フォルダが作成できなかった場合は，Err.Numberに0以外が設定され，Sleep_Timeに設定した時間（秒）スリープし，再度フォルダの作成を試みます。リカバリ処理の実行が成功するまでRetriesに設定した回数分繰り返します。
LooksAlive | 常に「True」を返します。
IsAlive | 常に「True」を返します。
Offline | 常に「True」を返します。
Close | 常に「True」を返します。
Terminate | 常に「True」を返します。

(3)　待機系の汎用スクリプトファイルの変数

待機系の汎用スクリプトファイルでは，必要に応じて次の表に示す変数の値を変更してください。

表17-13　待機系の汎用スクリプトファイルの変数（N:1リカバリシステムの場合）

変数名
内容

Dir_Name
排他制御用のフォルダのパス
指定例：C:¥recover¥exclusive
この例では，C:¥recoverフォルダが存在している必要があります。exclusiveフォルダは存在していてはいけません。

Sleep_Time
リカバリコマンドの排他制御時にスリープする時間（秒）

Retries
リカバリコマンドの排他制御時のリトライ回数

17.5.6　クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータを使用して，実行系，待機系アプリケーションサーバの系で稼働させる実行サーバや待機サーバの環境を定義します。なお，クラスタアドミニストレータの設定の詳細については，OSのマニュアルを参照してください。

N:1リカバリシステムの場合の設定内容を次に示します。

＜この項の構成＞

(1)　リソースグループの設定

(2)　リソースの設定

(1)　リソースグループの設定

次の手順でリソースグループを設定します。

クラスタノードを設定します。
クラスタにノード（Node1，Node2，Node3，Node4，NodeR）を追加します。

リソースグループを作成します。
［ファイル］－［新規作成］－［グループ］を選択して，次のリソースグループを作成します。

項目 | 設定値
Node1 | Node2 | Node3 | Node4
名前 | Group1 | Group2 | Group3 | Group4
説明 | グループ1 | グループ2 | グループ3 | グループ4
優先所有者 | Node1，NodeR | Node2，NodeR | Node3，NodeR | Node4，NodeR

(2)　リソースの設定

次の手順でリソースを設定します。

共有ディスクを設定します。

クラスタIPアドレスを設定します。

クラスタ名を設定します。

汎用スクリプトを設定します。

各作業について説明します。

(a)　共有ディスクの設定

トランザクション情報を共有ディスクに格納するための設定をします。Cosminexusで設定する「インプロセストランザクションサービスのステータスファイル」の格納先をこの共有ディスクに設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の物理ディスクリソースを作成します。

項目 | 設定値
Node1 | Node2 | Node3 | Node4
名前 | Disk1 | Disk2 | Disk3 | Disk4
説明 | 共有ディスク1 | 共有ディスク2 | 共有ディスク3 | 共有ディスク4
リソースの種類 | 物理ディスク | 物理ディスク | 物理ディスク | 物理ディスク
グループ | Group1 | Group2 | Group3 | Group4
実行所有者 | Node1，NodeR | Node2，NodeR | Node3，NodeR | Node4，NodeR
共有ディスク | Iドライブ（I:¥) | Jドライブ（J:¥) | Kドライブ（K:¥) | Lドライブ（L:¥)

(b)　クラスタIPアドレスの設定

クラスタを管理するためのIPアドレスを設定します。Management Serverやクライアントから認識されるIPアドレスを設定してください。N:1リカバリ構成では，J2EEサーバはクラスタ内ではなく，仮想サーバ内で動作するため，クラスタIPアドレスではなく，仮想サーバのIPアドレスを設定します。［ファイル］－［新規作成］－［リソース］を選択して，次のIPアドレスリソースを作成します。

項目 | 設定値
Node1 | Node2 | Node3 | Node4
名前 | IPAddress1 | IPAddress2 | IPAddress3 | IPAddress4
説明 | 仮想サーバ1のIPアドレス | 仮想サーバ2のIPアドレス | 仮想サーバ3のIPアドレス | 仮想サーバ4のIPアドレス
リソースの種類 | IP アドレス | IP アドレス | IP アドレス | IP アドレス
グループ | Group1 | Group2 | Group3 | Group4
実行所有者 | Node1，NodeR | Node2，NodeR | Node3，NodeR | Node4，NodeR
依存関係 | なし | なし | なし | なし
アドレス | 172.16.12.31 | 172.16.12.32 | 172.16.12.33 | 172.16.12.34
サブネットマスク | 255.255.0.0 | 255.255.0.0 | 255.255.0.0 | 255.255.0.0
ネットワーク | Public Cluster Connection | Public Cluster Connection | Public Cluster Connection | Public Cluster Connection

(c)　クラスタ名の設定

クラスタを管理するためのクラスタ名を設定します。N:1リカバリ構成では，J2EEサーバはクラスタ内ではなく，仮想サーバ内で動作するため，仮想サーバのホスト名を設定します。［ファイル］－［新規作成］－［リソース］を選択して，次のネットワーク名リソースを作成します。

項目 | 設定値
Node1 | Node2 | Node3 | Node4
名前 | Server1 | Server2 | Server3 | Server4
説明 | 仮想サーバ名 | 仮想サーバ名 | 仮想サーバ名 | 仮想サーバ名
リソースの種類 | ネットワーク名 | ネットワーク名 | ネットワーク名 | ネットワーク名
グループ | Group1 | Group2 | Group3 | Group4
実行所有者 | Node1，NodeR | Node2，NodeR | Node3，NodeR | Node4，NodeR
依存関係 | IPAddress1 | IPAddress2 | IPAddress3 | IPAddress4
ネットワーク名 | COSMI | COSMI | COSMI | COSMI

(d)　汎用スクリプトの設定

Microsoft Cluster ServiceからCosminexusを起動，停止する汎用スクリプトリソースを設定します。［ファイル］－［新規作成］－［リソース］を選択して，次の汎用スクリプトリソースを作成してください。

項目
設定値

Node1
Node2
Node3
Node4

名前
ClusterA
ClusterA
ClusterA
ClusterA

説明
ClusterA用汎用スクリプト
ClusterA用汎用スクリプト
ClusterA用汎用スクリプト
ClusterA用汎用スクリプト

リソースの種類
汎用スクリプト
汎用スクリプト
汎用スクリプト
汎用スクリプト

グループ
Group1
Group2
Group3
Group4

実行所有者
Node1，NodeR
Node2，NodeR
Node3，NodeR
Node4，NodeR

依存関係
Disk1，
IPAddress1，
Server1
Disk2，
IPAddress2，
Server2
Disk3，
IPAddress3，
Server3
Disk4，
IPAddress4，
Server4

スクリプトのファイルパス
C:¥MSCS¥Script.vbs
C:¥MSCS¥Script.vbs
C:¥MSCS¥Script.vbs
C:¥MSCS¥Script.vbs

17.5.7　アプリケーションサーバの設定

アプリケーションサーバの設定では，運用管理ポータル，クラスタアドミニストレータなどを使用してCosminexusをクラスタ構成に配置します。また，論理サーバをセットアップして設定情報を配布し，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。アプリケーションサーバの設定手順を次に示します。

各実行系ノードで，各リソースグループをオンラインにします。
Node1のGroup1，Node2のGroup2，Node3のGroup3，およびNode4のGroup4をオンラインにします。

運用管理ポータルで，各実行系のJ2EEサーバをセットアップします。
「運用管理ドメインの構成定義」の［セットアップ］画面で，J2EEサーバをセットアップします。運用管理ポータルでの操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

運用管理ポータルで，J2EEサーバに設定した情報を実行系ノードに配布します。
「論理サーバの環境設定」の［設定情報の配布］画面で，J2EEサーバに設定した情報を各実行系に配布します。

サーバ管理コマンドを使用して，各実行系のアプリケーションサーバのJ2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。また，インポートしたJ2EEアプリケーションとリソースアダプタを設定および開始します。
J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。また，サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
なお，J2EEサーバおよびその前提プロセスを起動してからサーバ管理コマンドを実行してください。また，サーバ管理コマンドでの操作が終わったら，サーバ管理コマンドを停止してください。

クラスタアドミニストレータで，各リソースグループに対して「グループの移動」を実行して系を切り替え，リソースの所有者を待機系ノード（NodeR）に変更します。

サーバ管理コマンドを使用して，待機系のアプリケーションサーバにリソースアダプタをインポートします。
待機系のJ2EEサーバには，実行系の各J2EEサーバで使用しているリソースアダプタと同じ設定のリソースアダプタをインポートしてください。
ただし，待機系のJ2EEサーバに定義するリソースアダプタでは，コネクションプーリング機能を使用する必要はありません。サーバ管理コマンドで設定するコネクションの最小値と最大値には0を指定してください。

クラスタアドミニストレータで，各リソースグループに対して「グループの移動」を実行して系を切り替え，リソースの所有者を各実行系ノードに戻します。

17.6　アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

1:1系切り替えシステムとは，実行系と待機系が1:1で対応しているシステムです。Cosminexusでは，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置するシステムと，実行系の運用管理サーバと待機系の運用管理サーバを1:1に配置するシステムを構築・運用できます。このシステムは，運用管理ポータルを使用して構築します。運用管理ポータルについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。この節では，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置して系を切り替えるシステムの設定について説明します。

アプリケーションサーバの実行系と待機系を1:1に配置して系を切り替えるシステムでは，実行系のアプリケーションサーバでマシンの障害や運用管理エージェントの終了などの障害が発生すると，HAモニタがこれを検知して，自動的に待機している系に切り替えて業務を続行します。また，障害が発生しなくても実行中のシステムに予防保守などが必要な場合には，オペレータの操作によって待機している系に計画的に切り替えることができます。

なお，アプリケーションサーバの1:1系切り替えシステムの運用は，AIX，HP-UXまたはLinuxの場合だけ使用できます。

機能の詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のアプリケーションサーバの実行系と待機系を1:1にする構成に関する説明を参照してください。また，HAモニタについては，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

＜この節の構成＞

17.6.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

17.6.2　クラスタサーバの環境設定

17.6.3　設定ファイルの編集

17.6.4　HAモニタの環境設定

17.6.5　シェルスクリプトファイルの作成

17.6.6　サーバ対応の環境設定

17.6.7　LANの状態設定

17.6.8　アプリケーションサーバの設定

17.6.1　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

ここでは，システムの構築例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

アプリケーションサーバの1:1系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-10　アプリケーションサーバを対象にした1:1系切り替えシステムの構成例（UNIXの場合）

この例では，アプリケーションサーバの実行系（現用系）とアプリケーションサーバの待機系（予備系）を1:1で配置しています。また，Management Serverは，運用管理サーバとして，アプリケーションサーバとは別のマシンに配置しています。

アプリケーションサーバの1:1系切り替えシステムでは，まずクラスタを構築して，アプリケーションサーバをクラスタ内に現用系と予備系として定義します。また，HAモニタで使用するコマンドや出力するメッセージのための，サーバの識別名（サーバの別名）を指定します。現用系と予備系とで同じ名称（例ではCosminexusAP）を指定します。

なお，Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。1:1系切り替えシステムの場合，エイリアスIPアドレスは，HAモニタによって動的に割り当てられるアドレスとなります。

(2)　システムの設定手順

HAモニタと連携する場合には，運用管理ポータルやHAモニタのファイルの設定などが必要になります。アプリケーションサーバの1:1系切り替えシステムの設定手順を次の図に示します。

図17-11　アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順（UNIXの場合）

図中の1.～9.について説明します。

グローバルトランザクションを使用する場合は，共有ディスクにパーティションを作成して，ファイルシステムを構築します。
グローバルトランザクションを使用するためには，トランザクション情報の格納場所を作成します。

グローバルトランザクションを使用する場合は，システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系と予備系で，同じマウント先ディレクトリにしてください。

運用管理ポータルでクラスタサーバの環境を設定します。
運用管理ポータルの「運用管理ドメインの構成定義」，および「論理サーバの環境設定」で，HAモニタを使用する場合の設定をします。

設定ファイルを編集します。
運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

HAモニタの環境を設定します。
HAモニタのsysdefファイルで，HAモニタの環境を定義します。

シェルスクリプトファイルを作成します。
運用管理エージェントを監視，運用管理エージェントと論理サーバを起動および停止するためのシェルスクリプトファイルを作成します。

サーバ対応の環境を設定します。
HAモニタのserversファイルで，系で稼働させる現用系サーバや予備系サーバの環境を定義します。

LANの状態を設定します。
HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

運用管理ポータルとHAモニタのコマンドで，アプリケーションサーバの設定をします。
運用管理ポータル，HAモニタのコマンドを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

注意

HAモニタと連携する場合のシステム設定時の注意について，次に示します。

HAモニタ連携のアプリケーションサーバに接続するクライアントの設定
HAモニタ連携のアプリケーションサーバに接続するクライアントでは，EJBのルックアップなどで，HAモニタと連携しているアプリケーションサーバを呼び出す場合，エイリアスIPアドレスでアプリケーションサーバを指定してください。

17.6.2　クラスタサーバの環境設定

ここでは，HAモニタと連携する場合の，運用管理ポータルでの設定の留意点について説明します。

参考

運用管理ポータルでシステムの動作環境を設定するには，あらかじめ，Management Serverの起動などが必要です。また，Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。運用管理ポータルでの動作環境の設定や，操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

＜この項の構成＞

(1)　「運用管理ドメインの構成定義」での設定

(2)　「論理サーバの環境設定」での設定

(1)　「運用管理ドメインの構成定義」での設定

論理サーバを設置するホストおよび各論理サーバの構成を定義します。このとき，［ホストの定義］画面で，「ホスト名」にエイリアスIPアドレスを設定します。

(2)　「論理サーバの環境設定」での設定

論理J2EEサーバ，論理Webサーバ，論理SFOサーバ，および論理ネーミングサービスの設定での留意点を次に示します。

(a)　論理J2EEサーバの設定

ホストの固定の設定
次の個所では，「ホストの固定」に「する」を設定してください。

［J2EEコンテナの設定］画面にある「運用監視エージェントの設定」の「ホストの固定」

［EJBコンテナの設定］画面にある「ホストの固定」

［Webコンテナの設定］画面にある「Webサーバとの接続」または「管理用サーバの設定」の「ホストの固定」

ホストを固定すると，運用管理ポータルの「運用管理ドメインの構成定義」で定義したホスト名が使用されます。

グローバルトランザクションの設定
グローバルトランザクションを使用する場合は，次の設定をしてください。

［トランザクションの設定］画面にある「ライトトランザクション機能」を「無効」にします。

［トランザクションの設定］画面にある「インプロセスOTSのステータスファイル格納先」に，共有ディスク装置のディレクトリを設定します。
設定例
/hamon

(b)　論理Webサーバの設定

［Webサーバの設定］画面で，「ホストの固定」に「する」を設定してください。

(c)　論理SFOサーバの設定

HAモニタを使用してJ2EEサーバがクラスタ構成となるシステムで，セッションフェイルオーバ機能を使用する場合は，論理SFOサーバで次の設定が必要です。

サーバIDの重複の設定
［システムプロパティの設定］画面にある「システムプロパティの定義」で，次のように設定します。

設定例

webserver.sfo.negotiation.ignore_serverId=true

このように設定することで，HTTPセッションのセッションIDに設定されるサーバIDが，ほかのJ2EEサーバのサーバIDと重複していても，エラーにならないようになります。

注意

webserver.sfo.negotiation.ignore_serverIdキーに「true」を指定するのは，HAモニタを使用したクラスタ環境でセッションフェイルオーバ機能を使用する場合だけにしてください。

HAモニタを使用しない環境で「true」を指定すると，システム内のセッションIDが重複する場合があります。HAモニタを使用しない環境では，デフォルト値の「false」を指定してください。

(d)　論理ネーミングサービスの設定

［ネーミングサービスの設定］画面で，「ホストの固定」に「する」を設定してください。このとき，J2EEサーバが使用するネーミングサービス（アウトプロセスでの起動）を設定する場合は，「運用管理エージェントのホストで固定」のチェックボックスをチェックしないでください。このように設定することで，「運用管理ドメインの構成定義」の［ネーミングサービスの追加］画面で指定したホスト名が使用されます。

17.6.3　設定ファイルの編集

運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。ここでは，HAモニタと連携する場合に注意が必要なファイルの設定について説明します。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Hitachi Web Serverの設定（Webサーバと連携する場合）

(3)　ワーカの設定（Webサーバと連携する場合）

(4)　スマートエージェントの設定（CTMを利用する場合）

(5)　Management Serverの運用管理コマンド（mngsvrutil）の設定

(1)　運用管理エージェントの設定

adminagent.properties（運用管理エージェントプロパティファイル）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでエイリアスIPアドレスを指定します。管理用のリクエストは，エイリアスIPアドレスだけで受け付けます。例では，次のように設定します。
adminagent.adapter.bind_host=172.16.12.30

adminagent.cluster.localaddress.checkキー
アプリケーションサーバの系切り替え時に，障害などの原因で停止しなかった待機系の論理サーバ，または運用管理エージェントを停止するための設定をします。
adminagent.cluster.localaddress.check=true

(2)　Hitachi Web Serverの設定（Webサーバと連携する場合）

httpsd.conf（Hitachi Web Server定義ファイル）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。なお，httpsd.confファイルの各ディレクティブについては，マニュアル「Hitachi Web Server」を参照してください。

Listenディレクティブ，BindAddressディレクティブなど
Listenディレクティブ，BindAddressディレクティブなどには，エイリアスIPアドレスを指定します。クライアントへのサービス提供は，エイリアスIPアドレスだけで実施します。

ServerNameディレクティブ
ServerNameディレクティブには，エイリアスIPアドレス，またはエイリアスIPアドレスに名前を解決できるホスト名を指定します。

(3)　ワーカの設定（Webサーバと連携する場合）

workers.properties（ワーカ定義ファイル）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。workers.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

workers.propertiesでは，ネットワーク設定に合わせて，次のキーを設定してください。

worker.<ワーカ名>.host=クラスタIPアドレス

(4)　スマートエージェントの設定（CTMを利用する場合）

Management Serverとの連携でCTMを利用する場合には，次のファイルを編集する必要があります。

localaddr
localaddrを作成します。localaddrでは，ステーショナリIPアドレスとエイリアスIPアドレスを設定し，スマートエージェントがステーショナリIPアドレスとエイリアスIPアドレスを通信に使用できるようにします。localaddrの設定については，「付録J　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（UNIXの場合）」を参照してください。

(5)　Management Serverの運用管理コマンド（mngsvrutil）の設定

現用系と予備系のrootのホームディレクトリに，Management Serverの運用管理コマンド（mngsvrutil）のクライアント側定義ファイル（.mngsvrutilrc）を用意し，Management Serverの管理ユーザのユーザIDとパスワードを設定してください。また，クライアント側定義ファイルには適切なアクセス権限を設定してください。

このファイルは，運用管理エージェントのプロセスを監視するスクリプト，運用管理エージェントと論理サーバを起動および停止するスクリプトで，mngsvrutilコマンドを実行する際に使用します。

なお，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.6.4　HAモニタの環境設定

使用しているシステムに従って，sysdefという定義ファイルにHAモニタの環境を定義してください。

HAモニタの環境設定については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.6.5　シェルスクリプトファイルの作成

運用管理エージェントのプロセスを監視し，運用管理エージェントと論理サーバを起動および停止するために，次のシェルスクリプトファイルを作成します。

運用管理エージェントのプロセスを監視するシェルスクリプトファイル

運用管理エージェントと論理サーバを起動するシェルスクリプトファイル

運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

現用系のアプリケーションサーバと予備系のアプリケーションサーバで同一のシェルスクリプトファイルを使用し，同一のパスに配置してください。

＜この項の構成＞

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

(2)　運用管理エージェントと論理サーバを起動するシェルスクリプトファイル

(3)　運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

運用管理エージェントのプロセスを監視するシェルスクリプトファイルの例（manager_adminagent_monitor.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
AA=/opt/Cosminexus/manager/bin/adminagent

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

logg "### $0: started. ###"
while true
do
   CHECK=`ps -ef | grep $AA | grep -v grep`

   if [ "$CHECK" = "" ]
   then
       logg "### $0: stop. ###"
       exit 0
   fi
   sleep 10
done

(2)　運用管理エージェントと論理サーバを起動するシェルスクリプトファイル

運用管理エージェントと論理サーバを起動するシェルスクリプトファイルの例（manager_adminagent_start.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
SCRIPTDIR=/home/manager/hamon/bin
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

# make adminagent.access.info
logg "### $0: make adminagent.access.info ###"
echo 172.16.12.30:28080,hostA:20295 > $MNGDIR/tmp/adminagent.access.info

# start Administration Agent
logg "### $0: starting Administration Agent. ###"
$MNGDIR/bin/adminagentctl start
if [ $? -eq 0 ] ; then
 logg "### $0: Administration Agent start normally. ###"
else
 logg "### $0: Administration Agent cannot start. ###"
 exit 1
fi

sleep 10

# start logical server
logg "### $0: starting logical servers. ###"
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver1 -s start server
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver2 -s start server
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver3 -s start server

exit 0

このシェルスクリプトファイルでは，アクセス情報ファイル（/opt/Cosminexus/manager/tmp/adminagent.access.info）※の作成，運用管理エージェントの起動，論理サーバの起動をします。

注※

アクセス情報ファイルは，運用管理エージェントの起動後に削除され，Management Serverからアクセスがあった場合に再度作成されます。

ここでは，Management Serverからアクセスがあった場合に再度作成される内容と同じになるように設定してください。このファイルによって，系障害発生時に切り替わった場合に各論理サーバが再起動されます。

シェルスクリプトファイルでの設定内容のポイントを次に示します。

アクセス情報ファイルの作成

例のシェルスクリプトファイルで該当する記述

echo 172.16.12.30:28080,hostA:20295
                          > $MNGDIR/tmp/adminagent.access.info

フォーマット

<Mng_ip>:<Mng_port>,<AA_host>:<AA_port>

設定する内容について次に示します。

Mng_ip
Management ServerのあるホストのIPアドレスを指定します。

Mng_port
Management Server接続HTTPポート番号を指定します。

AA_host
運用管理エージェントのホスト名を指定します。Management Serverの運用管理ポータルの「運用管理ドメインの構成定義」のホストに指定した値を指定してください。

AA_port
運用管理エージェントのポート番号を指定します。Management Serverの運用管理ポータルの「運用管理ドメインの構成定義」の運用管理エージェントのポート番号に指定した値を指定してください。

論理サーバの起動

論理サーバを起動するように設定します。

論理サーバの起動にはmngsvrutilコマンドを使用します。mngsvrutilコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(3)　運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

運用管理エージェントと論理サーバを停止するシェルスクリプトファイルの例（manager_adminagent_stop.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

# stop logical server
logg "### $0: stop logical servers. ###"
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver3 -s stop server
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver2 -s stop server
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -t lserver1 -s stop server

# stop Administration Agent
logg "### $0: stopping Administration Agent. ###"
$MNGDIR/bin/adminagentctl stop

17.6.6　サーバ対応の環境設定

HAモニタでのサーバ対応の環境設定では，系で稼働させる実行サーバや待機サーバの環境を定義します。

serversという定義ファイルに，アプリケーションサーバの1:1系切り替え用のサーバ対応の環境を定義してください。サーバ対応の環境設定での設定内容を次の表に示します。

表17-14　サーバ対応の環境設定での設定内容（アプリケーションサーバの1:1系切り替えの場合）

オペランド
設定内容

name
運用管理エージェントと論理サーバを起動するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_adminagent_start.sh

alias
サーバの識別名を指定します。現用系と予備系で同じ名称を指定します。
指定例：CosminexusAP

acttype
サーバの起動方法を指定します。ここでは，HAモニタのコマンドでサーバを起動するため，「monitor」を指定します。

termcommand
運用管理エージェントと論理サーバを停止するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_adminagent_stop.sh

initial
サーバ起動時の状態を指定します。

現用系の場合
「online」を指定します。

予備系の場合
「standby」を指定します。

disk
共有ディスク装置のキャラクタ型スペシャルファイル名を指定します。
指定例：/dev/vg00

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。ここでは，LANの状態設定ファイルを使用するため，「use」を指定します。

fs_name
切り替えるファイルシステムに対応する論理ボリュームの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/dev/rdisk0

fs_mount_dir
切り替えるファイルシステムのマウント先ディレクトリの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/hamon

patrolcommand
運用管理エージェントのプロセスを監視するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_adminagent_monitor.sh

servexec_retry
障害を検出した場合の再起動の回数を指定します。ここでは，障害を検出した場合に再起動をしないで系を切り替えるため，「0」を指定します。

waitserv_exec
運用管理エージェントと論理サーバの起動完了処理を実行するときに起動コマンドの実行完了を待つかどうかを指定します。ここでは，実行完了を待つため，「yes」を指定します。

サーバ対応の環境設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.6.7　LANの状態設定

HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

次のファイルにエイリアスIPアドレスを設定してください。

<サーバ識別名>.upファイル
LANを接続する場合に使用します。LANアダプタに追加するエイリアスIPアドレスを指定します。

<サーバ識別名>.downファイル
LANを切り離す場合に使用します。LANアダプタから削除するエイリアスIPアドレスを指定します。

<サーバ識別名>には，サーバ対応の環境設定（serversファイル）のaliasの値を指定してください。

LANの状態設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.6.8　アプリケーションサーバの設定

アプリケーションサーバの設定では，運用管理ポータル，HAモニタのコマンドを使用してCosminexusをクラスタ構成に配置します。また，論理サーバをセットアップして設定情報を配布し，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。アプリケーションサーバの設定手順を次に示します。

運用管理サーバを起動します。
運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

Node1およびNode2でHAモニタのmonbeginコマンドを実行して，現用系のアプリケーションサーバを実行系として起動し，予備系のアプリケーションサーバを待機状態にします。

Node1でのコマンドの実行例
「# monbegin CosminexusAP」を実行して，Node1の現用系を起動します。

Node2でのコマンドの実行例
「# monbegin CosminexusAP」を実行して，Node2の予備系を待機状態にします。

運用管理ポータルで，Node1の現用系のJ2EEサーバをセットアップします。
「運用管理ドメインの構成定義」の［セットアップ］画面で，J2EEサーバをセットアップします。運用管理ポータルでの操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

運用管理ポータルで，J2EEサーバに設定した情報をNode1の現用系に配布します。
「論理サーバの環境設定」の［設定情報の配布］画面で，J2EEサーバに設定した情報をNode1の現用系に配布します。

サーバ管理コマンドを使用して，Node1の現用系のJ2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。また，インポートしたJ2EEアプリケーションとリソースアダプタを設定および開始します。
J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。また，サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
なお，J2EEサーバおよびその前提プロセスを起動してからサーバ管理コマンドを実行してください。また，サーバ管理コマンドでの操作が終わったら，サーバ管理コマンドを停止させてください。

Node1でHAモニタのmonswapコマンドを実行して，系を切り替えます。

Node1でのコマンドの実行例
「# monswap CosminexusAP」を実行して，サーバ識別名「CosminexusAP」で系を切り替えます。Node2の予備系が起動され，Node1の現用系が待機状態になります。

Node2の予備系で，手順3.～手順5.を実施します。
予備系には，現用系とまったく同じ設定をするため，設定手順や内容については，現用系と同じです。

Node2でHAモニタのmonswapコマンドを実行して，系を切り替えて通常の運用状態に戻します。

Node2でのコマンドの実行例
「# monswap CosminexusAP」を実行して，サーバ識別名「CosminexusAP」で系を切り替えます。Node1の現用系が起動され，Node2の予備系が待機状態になります。

17.7　運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

1:1系切り替えシステムとは，実行系と待機系が1:1で対応しているシステムです。Cosminexusでは，実行系のアプリケーションサーバと待機系のアプリケーションサーバを1:1に配置するシステムと，実行系の運用管理サーバと待機系の運用管理サーバを1:1で配置するシステムを構築・運用できます。このシステムは，Smart Composer機能を使用して構築します。この節では，実行系の運用管理サーバと待機系の運用管理サーバを1:1に配置して系を切り替えるシステムの設定について説明します。

運用管理サーバを1:1に配置して系を切り替えるシステムでは，実行系の運用管理サーバでマシンの障害やManagement Serverのプロセスの終了が発生すると，HAモニタがこれを検知して，自動的に待機している系に切り替えて業務を続行します。また，障害が発生しなくても実行中のシステムに予防保守などが必要な場合には，オペレータの操作によって待機している系に計画的に切り替えることができます。

なお，運用管理サーバの1:1系切り替えシステムの運用は，AIX，HP-UXまたはLinuxの場合だけ使用できます。

機能の詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」の運用管理サーバの実行系と待機系を1:1にする構成に関する説明を参照してください。また，HAモニタについては，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

＜この節の構成＞

17.7.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

17.7.2　クラスタサーバの環境設定

17.7.3　設定ファイルの編集

17.7.4　現用系から予備系へのManagement Serverの設定情報のコピー

17.7.5　HAモニタの環境設定

17.7.6　シェルスクリプトファイルの作成

17.7.7　サーバ対応の環境設定

17.7.8　LANの状態設定

17.7.1　運用管理サーバを対象にした1:1系切り替えシステムの設定手順

ここでは，システムの構築例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

運用管理サーバの1:1系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの設定例を示します。

図17-12　運用管理サーバを対象にした1:1系切り替えシステムの構成例（UNIXの場合）

この例では，運用管理サーバとアプリケーションサーバは，別のマシンに配置しています。運用管理サーバの実行系（現用系）と運用管理サーバの待機系（予備系）を1:1で配置しています。

運用管理サーバの1:1系切り替えシステムでは，まずクラスタを構築して，運用管理サーバをクラスタ内に現用系と予備系として定義します。また，HAモニタで使用するコマンドや出力するメッセージのための，サーバの識別名（サーバの別名）を指定します。現用系と予備系とで同じ名称（例ではCosminexusMS）を指定します。

なお，Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。1:1系切り替えシステムの場合，エイリアスIPアドレスは，HAモニタによって動的に割り当てられるアドレスとなります。

(2)　システムの設定手順

HAモニタと連携する場合には，Management ServerやHAモニタのファイルの設定などが必要になります。運用管理サーバの1:1系切り替えシステムの設定手順を次の図に示します。なお，ここでは運用管理サーバをアプリケーションサーバとは別のマシンとして構築している場合の，運用管理サーバの設定について説明しています。運用管理サーバと別のマシンに構築しているアプリケーションサーバの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

図17-13　運用管理サーバを対象にした1:1系切り替えシステムの設定手順（UNIXの場合）

図中の1.～9.について説明します。

グローバルトランザクションを使用する場合は，共有ディスクにパーティションを作成して，ファイルシステムを構築します。
グローバルトランザクションを使用するためには，トランザクション情報の格納場所を作成します。

グローバルトランザクションを使用する場合は，システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系と予備系で，同じマウント先ディレクトリにしてください。

Management Serverでクラスタサーバの環境を設定します。
Management ServerのSmart Composer機能の簡易構築定義ファイルで，HAモニタを使用する場合の設定をします。

設定ファイルを編集します。
簡易構築定義ファイルでは設定できない，Management Serverなどの各種定義ファイルを設定します。

現用系から予備系にManagement Serverの設定情報をコピーします。
現用系と予備系を同じ環境にするために，現用系でのManagement Serverに関する設定内容を予備系にコピーします。

HAモニタの環境を設定します。
HAモニタのsysdefファイルで，HAモニタの環境を定義します。

シェルスクリプトファイルを作成します。
Management Serverを監視，運用管理サーバを起動および停止するためのシェルスクリプトファイルを作成します。

サーバ対応の環境を設定します。
HAモニタのserversファイルで，系で稼働させる現用系サーバや予備系サーバの環境を定義します。

LANの状態を設定します。
HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

17.7.2　クラスタサーバの環境設定

ここでは，HAモニタと連携する場合の，Management Serverでの設定時の留意点について説明します。

参考

Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。Management Serverのセットアップについては，「3.4.1　Management Serverのセットアップ」を参照してください。

注意

運用管理サーバ上に論理サーバを定義している場合は，運用管理ポータルを使用して運用管理サーバ上の論理サーバを設定する必要があります。なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，設定不要です。Management Serverを初めて使用するホストの場合には，Management Serverをセットアップしてください。

＜この項の構成＞

(1)　簡易構築定義ファイルでの設定

(1)　簡易構築定義ファイルでの設定

Management ServerのSmart Composer機能の簡易構築定義ファイルで，論理サーバを設置するホストおよび各論理サーバの構成を定義します。また，必要に応じて，各論理サーバの<configuration>タグ内に，論理サーバの環境や起動／停止の動作などを設定します。設定済みの簡易構築定義ファイルを基に，Smart Composer機能のコマンドを使用して，Webシステムをセットアップします。

セットアップしたWebシステムをSmart Composer機能のコマンドで起動したあと，必要に応じて，サーバ管理コマンドを使用して，J2EEアプリケーション，リソースアダプタをインポートして，開始します。

17.7.3　設定ファイルの編集

設定ファイルを編集します。ここでは，HAモニタと連携する場合に注意が必要な設定ファイルについて説明します。なお，現用系と予備系で必要となる設定が異なります。

運用管理エージェントの設定

Management Serverの設定

Management Serverの運用管理コマンド（mngsvrutil）の設定

現用系では，2.と3.を設定してください。1.は運用管理サーバ上に論理サーバを定義している場合だけ設定してください。

予備系では，3.だけ設定してください。1.と2.については，現用系からManagement Serverの設定情報をコピーすることで設定できるため，ここでは設定不要です。

注意

運用管理サーバ上に論理サーバを定義している場合は，運用管理サーバ上の運用管理エージェントを設定する必要があります。なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，設定不要です。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Management Serverの設定

(3)　Management Serverの運用管理コマンド（mngsvrutil）の設定

(1)　運用管理エージェントの設定

運用管理エージェントプロパティファイル（adminagent.properties）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでエイリアスIPアドレスを指定します。管理用のリクエストは，エイリアスIPアドレスだけで受け付けます。

(2)　Management Serverの設定

Management Server環境設定ファイル（mserver.properties）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。なお，mserver.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

mngsvr.myhost.name
mngsvr.myhost.nameキーでエイリアスIPアドレスを指定します。例では，次のように設定します。
mngsvr.myhost.name=192.168.255.111

webserver.connector.http.permitted.hosts
webserver.connector.http.permitted.hostsキーでエイリアスIPアドレスを指定します。例では，次のように設定します。
webserver.connector.http.permitted.hosts=192.168.255.111,192.168.0.112
このように指定することで，運用管理サーバのエイリアスIPアドレスおよびアプリケーションサーバからのリクエスト受け付けだけを許可して，運用管理サーバのステーショナリIPアドレスからのリクエストを拒否できるようになります。

(3)　Management Serverの運用管理コマンド（mngsvrutil）の設定

ローカルシステムアカウントのホームディレクトリに，Management Serverの運用管理コマンド（mngsvrutil）のクライアント側定義ファイル（.mngsvrutilrc）を用意し，Management Serverの管理ユーザのユーザIDとパスワードを設定してください。また，クライアント側定義ファイルには適切なアクセス権限を設定してください。

このファイルは，Management Serverのプロセスを監視するスクリプト，運用管理サーバを起動および停止するスクリプトで，mngsvrutilコマンドを実行する際に使用します。

なお，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.7.4　現用系から予備系へのManagement Serverの設定情報のコピー

現用系と予備系を同じ環境にするために，現用系でのManagement Serverに関する設定情報を予備系にコピーします。Management Serverの設定情報の退避／回復コマンドを使用して，現用系で設定したManagement Serverの各種定義ファイル，Management Serverに登録したJ2EEアプリケーションやリソースアダプタなどを，現用系から予備系にコピーしてください。

＜この項の構成＞

(1)　Management Serverの設定情報のコピー手順

(2)　収集対象のファイルの定義

(1)　Management Serverの設定情報のコピー手順

Management Serverの設定情報のコピー手順を次に示します。

現用系で，mstrexportコマンドを実行します。
mstrexportコマンドでは，mstrexportコマンドの実行対象となる現用系のManagement Serverの設定情報を収集し，収集した情報をZIP形式のファイルに保存します。mstrexportコマンドの引数には，保存するZIP形式のファイルのファイル名を指定してください。

コマンドの格納場所
/opt/Cosminexus/manager/bin

実行例
mstrexport /tmp/work/mstruct.zip

なお，mstrexportコマンドは，mstrexportコマンドの実行対象となるManagement Serverの起動，停止に関係なく実行できます。

手順1.で保存されたZIP形式のファイルを，現用系から予備系にコピーします。

予備系で，mstrimportコマンドを実行します。
mstrimportコマンドでは，コピーしてきたZIP形式のファイルを，コマンドの実行対象となる予備系のManagement Serverに展開します。これによって，現用系のManagement Serverと予備系のManagement Serverを同じ設定にできます。
mstrimportコマンドの引数には，コピーしてきたZIP形式のファイルのファイル名を指定してください。

コマンドの格納場所
/opt/Cosminexus/manager/bin

実行例
mstrimport /tmp/recovery/mstruct.zip

なお，mstrimportコマンドは，mstrimportコマンドの実行対象のManagement Serverが停止している場合だけ実行できます。

コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(2)　収集対象のファイルの定義

mstrexportコマンドの引数として，mstrexportコマンドの収集対象を記述するファイル（Management Server管理ファイル用退避対象定義ファイル）を指定できます。

実行例

mstrexport /tmp/work/mstruct.zip "/work/filelist.txt"

mstrexportコマンドでは，デフォルトの状態で，Management Serverの各種定義ファイル，Management Serverに登録したJ2EEアプリケーションやリソースアダプタなど，Management Serverでのシステム構築・運用に必要な情報が収集できます。これらの情報に加えて，ユーザ作成のコマンドなどもmstrexportコマンドでの収集対象に追加したい場合には，収集対象とするファイルの絶対パスをManagement Server管理ファイル用退避対象定義ファイルに記述してください。

ファイルの記述例

${cosminexus.home}/manager/apps/MyApp.ear

/home/confdir/message1.conf

ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.7.5　HAモニタの環境設定

使用しているシステムに従って，sysdefという定義ファイルにHAモニタの環境を定義してください。

HAモニタの環境設定については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.7.6　シェルスクリプトファイルの作成

Management Serverのプロセスを監視し，運用管理サーバを起動および停止するために，次のシェルスクリプトファイルを作成します。

Management Serverのプロセスを監視するシェルスクリプトファイル

運用管理サーバを起動するシェルスクリプトファイル

運用管理サーバを停止するシェルスクリプトファイル

現用系の運用管理サーバと予備系の運用管理サーバで同一のシェルスクリプトファイルを使用し，同一のパスに配置してください。

＜この項の構成＞

(1)　Management Serverのプロセスを監視するシェルスクリプトファイル

(2)　運用管理サーバを起動するシェルスクリプトファイル

(3)　運用管理サーバを停止するシェルスクリプトファイル

(1)　Management Serverのプロセスを監視するシェルスクリプトファイル

Management Serverのプロセスを監視するシェルスクリプトファイルの例（manager_mngsvr_monitor.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/mngsvr.log 2>&1
}

logg "### $0: started. ###"
while true
do
$MNGDIR/bin/mngsvrutil -m 192.168.255.111:28080 check mngsvr
   if [ $? -ne 0 ]
   then
       logg "### $0: stop. ###"
       exit 0
   fi
   sleep 10
done

このシェルスクリプトファイルでは，mngsvrutilのcheckコマンドでManagement Serverの稼働状況を確認します。なお，mngsvrutilコマンドの-mオプションの引数のホスト名にはエイリアスIPアドレスを指定します。

(2)　運用管理サーバを起動するシェルスクリプトファイル

運用管理サーバを起動するシェルスクリプトファイルの例（manager_mngsvr_start.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager
RETRY_COUNT=20
RETRY_INTERVAL=10

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/mngsvr.log 2>&1
}
# start Management Server
logg "### $0: starting Management Server. ###"
$MNGDIR/bin/adminagentctl start
$MNGDIR/bin/mngsvrctl start &

I=0
while [ $I -lt $RETRY_COUNT ] ; do
 MNGDIR/bin/mngsvrutil -m 192.168.255.111:28080 check mngsvr
 if [ $? -eq 0 ] ; then
   break
 fi
 sleep $RETRY_INTERVAL
 I=`expr $I + 1`
done
$MNGDIR/bin/mngsvrutil -m 192.168.255.111:28080 -t 192.168.255.111 -k host -s start server
exit 0

運用管理サーバ上に論理サーバを定義している場合は，このシェルスクリプトファイルで，運用管理エージェント，Management Server，および論理サーバを起動します。

なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，シェルスクリプトファイル中の下線部分は不要です。運用管理サーバ上のManagement Serverだけを起動します。

(3)　運用管理サーバを停止するシェルスクリプトファイル

運用管理サーバを停止するシェルスクリプトファイルの例（manager_mngsvr_stop.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager
logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/mngsvr.log 2>&1
}
# stop Management Server
logg "### $0: stop Management Server. ###"
$MNGDIR/bin/mngsvrutil -m 192.168.255.111:28080 -t 192.168.255.111 -k host -s stop server
$MNGDIR/bin/mngsvrctl stop
$MNGDIR/bin/adminagentctl stop
exit 0

運用管理サーバ上に論理サーバを定義している場合は，このシェルスクリプトファイルで，論理サーバ，Management Server，および運用管理エージェントを停止します。

なお，システム構成例では，運用管理サーバ上に論理サーバを定義していないため，シェルスクリプトファイル中の下線部分は不要です。運用管理サーバ上のManagement Serverだけを停止します。

17.7.7　サーバ対応の環境設定

HAモニタでのサーバ対応の環境設定では，系で稼働させる実行サーバや待機サーバの環境を定義します。

serversという定義ファイルに，運用管理サーバの1:1系切り替え用のサーバ対応の環境を定義してください。サーバ対応の環境設定での設定内容を次の表に示します。

表17-15　サーバ対応の環境設定での設定内容（運用管理サーバの1:1系切り替えの場合）

オペランド
設定内容

name
運用管理サーバを起動するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_mngsvr_start.sh

alias
サーバの識別名を指定します。現用系と予備系で同じ名称を指定します。
指定例：CosminexusMS

acttype
サーバの起動方法を指定します。ここでは，HAモニタのコマンドでサーバを起動するため，「monitor」を指定します。

termcommand
運用管理サーバを停止するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_mngsvr_stop.sh

initial
サーバ起動時の状態を指定します。

現用系の場合
「online」を指定します。

予備系の場合
「standby」を指定します。

disk
共有ディスク装置のキャラクタ型スペシャルファイル名を指定します。
指定例：/dev/vg00

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。ここでは，LANの状態設定ファイルを使用するため，「use」を指定します。

fs_name
切り替えるファイルシステムに対応する論理ボリュームの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/dev/rdisk0

fs_mount_dir
切り替えるファイルシステムのマウント先ディレクトリの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/hamon

patrolcommand
Management Serverのプロセスを監視するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_mngsvr_monitor.sh

servexec_retry
障害を検出した場合の再起動の回数を指定します。ここでは，障害が発生した場合に再起動しないで系を切り替えるため，「0」を指定します。

waitserv_exec
運用管理サーバの起動完了処理を実行するときに起動コマンドの実行完了を待つかどうかを指定します。ここでは，実行完了を待つため，「yes」を指定します。

serversファイルの例を次に示します。

serversファイルの例（現用系の場合）

現用系の場合のserversファイルの例を次に示します。

server  name           /home/manager/hamon/bin/manager_mngsvr_start.sh,
       alias          CosminexusMS,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_mngsvr_stop.sh,
       initial        online,
       disk           /dev/vg00,
       lan_updown     use,
       fs_name        /dev/rdisk0,
       fs_mount_dir   /hamon,
       patrolcommand  /home/manager/hamon/bin/manager_mngsvr_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

serversファイルの例（予備系の場合）

予備系の場合のserversファイルの例を次に示します。

server  name           /home/manager/hamon/bin/manager_mngsvr_start.sh,
       alias          CosminexusMS,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_mngsvr_stop.sh,
       initial        standby,
       disk           /dev/vg00,
       lan_updown     use,
       fs_name        /dev/rdisk0,
       fs_mount_dir   /hamon,
       patrolcommand  /home/manager/hamon/bin/manager_mngsvr_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

サーバ対応の環境設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.7.8　LANの状態設定

HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

次のファイルにエイリアスIPアドレスを設定してください。

<サーバ識別名>.upファイル
LANを接続する場合に使用します。LANアダプタに追加するエイリアスIPアドレスを指定します。

<サーバ識別名>.downファイル
LANを切り離す場合に使用します。LANアダプタから削除するエイリアスIPアドレスを指定します。

<サーバ識別名>には，サーバ対応の環境設定（serversファイル）のaliasの値を指定してください。

LANの状態設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.8　相互系切り替えシステムの設定（UNIXの場合）

相互系切り替えシステムは，アプリケーションサーバの実行系と待機系を1:1にする構成の一つで，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にする構成（相互スタンバイ構成）のシステムです。それぞれのアプリケーションサーバに同じ種類のJ2EEサーバを配置して，異なるJ2EEサーバを起動しておくことで，それぞれのアプリケーションサーバが実行系として動作しながらお互いの待機系として機能します。どちらか一方の系に障害が発生すると，もう一方の系に切り替えられます。これによって，少ない台数のアプリケーションサーバマシンで，むだの少ない運用ができるようになります。このシステムは，Smart Composer機能を使用して構築します。この節では，相互系切り替えシステムの設定について説明します。

なお，相互系切り替えシステムの運用は，AIX，HP-UXまたはLinuxの場合だけ使用できます。

機能の詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のアプリケーションサーバの実行系と待機系を相互スタンバイにする構成に関する説明を参照してください。また，HAモニタについては，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

＜この節の構成＞

17.8.1　相互系切り替えシステムの設定手順

17.8.2　クラスタサーバの環境設定

17.8.3　設定ファイルの編集

17.8.4　HAモニタの環境設定

17.8.5　シェルスクリプトファイルの作成

17.8.6　サーバ対応の環境設定

17.8.7　LANの状態設定

17.8.8　アプリケーションサーバの設定

17.8.1　相互系切り替えシステムの設定手順

ここでは，システムの構成例とシステムの設定手順について説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(1)　システムの構成例

相互系切り替えシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの設定例を示します。

図17-14　相互系切り替えシステムの構成例（UNIXの場合）

この例では，2種類のアプリケーションサーバ（アプリケーションサーバ1，アプリケーションサーバ2とします）を使用しています。アプリケーションサーバ1の実行系（現用系1）と待機系（予備系2），アプリケーションサーバ2の実行系（現用系2）と待機系（予備系1）をそれぞれ1:1で配置しています。それぞれ別の運用管理ドメインを持つManagement Serverを配置し，両方のマシンでManagement Serverを起動させています。

相互系切り替えシステムでは，一つの運用管理ドメイン内に二つの仮想ホストを定義し，それぞれを現用系アプリケーションサーバのホスト，予備系アプリケーションサーバのホストとして構築します。この例では，次のような組み合わせになります。

Node1の現用系1（仮想ホスト1）とNode2の予備系1（仮想ホスト1）

Node2の現用系2（仮想ホスト2）とNode1の予備系2（仮想ホスト2）

仮想ホストでは，一つの運用管理エージェントによってアプリケーションサーバの起動，停止を制御しますが，運用で使用するIPアドレスには異なるIPアドレスを割り当てて，見かけ上は異なるホストであるように定義しています。

Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。相互系切り替えシステムの場合，エイリアスIPアドレスは，HAモニタによって動的に割り当てられるアドレスとなります。アプリケーションサーバの運用に使用するIPアドレスには，エイリアスIPアドレスを使用し，Management Serverから運用管理エージェントに対するリクエストの送信には，系切り替えによって他系に移動しないIPアドレス（ステーショナリIPアドレス）を使用します。

(2)　システムの設定手順

HAモニタと連携する場合には，Management ServerやHAモニタのファイルの設定などが必要になります。相互系切り替えシステムの設定手順を次の図に示します。

図17-15　相互系切り替えシステムの設定手順（UNIXの場合）

図中の1.～9.について説明します。

グローバルトランザクションを使用する場合は，共有ディスクにパーティションを作成して，ファイルシステムを構築します。
グローバルトランザクションを使用するためには，トランザクション情報の格納場所を作成します。

グローバルトランザクションを使用する場合は，システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系1と予備系1，現用系2と予備系2で，同じマウント先ディレクトリにしてください。

Management Serverでクラスタサーバの環境を設定します。
Management ServerのSmart Composer機能の簡易構築定義ファイルで，HAモニタを使用する場合の設定をします。

設定ファイルを編集します。
簡易構築定義ファイルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

HAモニタの環境を設定します。
HAモニタのsysdefファイルで，HAモニタの環境を定義します。

シェルスクリプトファイルを作成します。
運用管理エージェントを監視，論理サーバを起動および停止するためのシェルスクリプトファイルを作成します。

サーバ対応の環境を設定します。
HAモニタのserversファイルで，系で稼働させる現用系サーバや予備系サーバの環境を定義します。

LANの状態を設定します。
HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

Management ServerとHAモニタのコマンドで，アプリケーションサーバの設定をします。
Management ServerとHAモニタのコマンドを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

17.8.2　クラスタサーバの環境設定

ここでは，HAモニタと連携する場合の，Management Serverでの設定時の留意点について説明します。

参考

Management Serverを初めて使用するホストでは，Management Serverをセットアップする必要があります。Management Serverのセットアップについては，「3.4.1　Management Serverのセットアップ」を参照してください。

＜この項の構成＞

(1)　簡易構築定義ファイルでの設定

(1)　簡易構築定義ファイルでの設定

Management ServerのSmart Composer機能の簡易構築定義ファイルで，論理サーバを設置するホストおよび各論理サーバの構成を定義するときの留意点を次に示します。

ホストの定義
運用管理ドメイン内のホストを定義します。現用系および予備系の仮想ホストで，<host-name>タグにそれぞれのサーバの運用に使用するエイリアスIPアドレスを設定します。例では，次のように設定します。

Node1の現用系1とNode2の予備系1の場合：192.168.1.111

Node2の現用系2とNode1の予備系2の場合：192.168.2.222

また，<agent-host>タグには，自ホストのステーショナリIPアドレスを設定します。例では，次のように設定します。

Node1の場合：192.168.0.11

Node2の場合：192.168.0.22

また，論理J2EEサーバ（j2ee-server），論理Webサーバ（web-server）の<configuration>タグの設定での留意点を次に示します。

(a)　論理J2EEサーバの設定

ホストの固定の設定
論理J2EEサーバ（j2ee-server）の<configuration>タグ内の次のパラメタに，任意の値を設定して，管理用ホストおよび運用用ホストを固定してください。

mngagent.connector.hostパラメタ（運用管理エージェントのホスト名またはIPアドレス）

vbroker.se.iiop_tp.hostパラメタ（J2EEサーバ単位でEJBコンテナのホスト名またはIPアドレス）

webserver.connector.http.bind_hostパラメタ（Webコンテナの管理用サーバで使用するローカルIPアドレス，または解決できるローカルホスト名称）

グローバルトランザクションの設定
グローバルトランザクションを使用する場合は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内の次のパラメタに，次の設定をしてください。

ejbserver.distributedtx.XATransaction.enabledパラメタ（ライトトランザクション機能の有効または無効の設定）に「false」を設定します。デフォルトでは「false」が設定されています。

ejbserver.distributedtx.ots.status.directory1パラメタ（インプロセスOTSのステータスファイルのバックアップの格納先）に，共有ディスク装置のディレクトリを設定します。デフォルトでは「otsstatus」が設定されています。
設定例
/hamon

(b)　論理Webサーバの設定

論理Webサーバ（web-server）の<configuration>タグ内に，次の設定が必要です。

ホストの固定の設定
Listenパラメタで，リクエストを受け付けるIPアドレスまたはホスト名を設定して，Webサーバのホストを固定してください。

17.8.3　設定ファイルの編集

設定ファイルを編集します。ここでは，HAモニタと連携する場合に注意が必要な設定ファイルについて説明します。

＜この項の構成＞

(1)　運用管理エージェントの設定

(2)　Management Serverの運用管理コマンド（mngsvrutil）の設定

(1)　運用管理エージェントの設定

adminagent.properties（運用管理エージェントプロパティファイル）に設定する項目のうち，HAモニタと連携する場合に留意する設定項目について説明します。なお，adminagent.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

adminagent.adapter.bind_hostキー
adminagent.adapter.bind_hostキーでステーショナリIPアドレス（例では，192.168.0.11，または192.168.0.22）を指定します。管理用のリクエストは，ステーショナリIPアドレスだけで受け付けます。

(2)　Management Serverの運用管理コマンド（mngsvrutil）の設定

/opt/Cosminexus/manager/configディレクトリ下に，Management Serverの運用管理コマンド（mngsvrutil）のクライアント側共通定義ファイル（mngsvrutilcl.properties）を用意し，Management Serverの管理ユーザのユーザIDとパスワードを設定してください。また，クライアント側共通定義ファイルには適切なアクセス権限を設定してください。

このファイルは，運用管理エージェントのプロセスを監視するスクリプト，論理サーバを起動および停止するスクリプトで，mngsvrutilコマンドを実行する際に使用します。

なお，mngsvrutilコマンドのクライアント側共通定義ファイル（mngsvrutilcl.properties）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

17.8.4　HAモニタの環境設定

使用しているシステムに従って，sysdefという定義ファイルにHAモニタの環境を定義してください。

HAモニタの環境設定については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.8.5　シェルスクリプトファイルの作成

運用管理エージェントのプロセスを監視し，論理サーバを起動および停止するために，次のシェルスクリプトファイルを作成します。

運用管理エージェントのプロセスを監視するシェルスクリプトファイル

論理サーバを起動するシェルスクリプトファイル

論理サーバを停止するシェルスクリプトファイル

＜この項の構成＞

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

(2)　論理サーバを起動するシェルスクリプトファイル

(3)　論理サーバを停止するシェルスクリプトファイル

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

運用管理エージェントのプロセスを監視するシェルスクリプトファイルの例（manager_adminagent_monitor.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
AA=/opt/Cosminexus/manager/bin/adminagent
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

logg "### $0: started. ###"
while true
do
   $MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t 192.168.1.111 check adminAgent
   if [ $? -ne 0 ]
   then
       logg "### $0: stop. ###"
       exit 0
   fi
   sleep 10
done

このシェルスクリプトファイルでは，mngsvrutilのcheckコマンドで運用管理エージェントの稼働状況を確認します。mngsvrutilコマンドの-mオプションの引数のホスト名には自ホストのステーショナリIPアドレスを指定し，-tオプションの引数には現用系の仮想ホストのエイリアスIPアドレスを指定します。

なお，このシェルスクリプトファイルは，Node1の現用系1（予備系2）で稼働する運用管理エージェントを監視する場合の例です。Node2の予備系1（現用系2）で使用する場合には，-mオプションの引数のホスト名をNode2のステーショナリIPアドレス（192.168.0.22）に，-tオプションの引数を現用系の仮想ホストのエイリアスIPアドレス（192.168.2.222）に置き換えます。

(2)　論理サーバを起動するシェルスクリプトファイル

論理サーバを起動するシェルスクリプトファイルの例（manager_apserver1_start.sh）を次に示します。

#!/bin/sh

MNGDIR=/opt/Cosminexus/manager
logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}
# start logical server
logg "### $0: starting logical servers. ###"
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <パフォーマンストレーサ> -s start server
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <J2EEサーバ1> -s start server
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <Webサーバ1> -s start server
exit 0

このシェルスクリプトファイルでは，論理サーバを起動します。mngsvrutilコマンドの-mオプションの引数のホスト名には自ホストのステーショナリIPアドレスを指定し，-tオプションの引数には起動する論理サーバ名を指定します。

なお，このシェルスクリプトファイルは，Node1の現用系1で論理サーバを起動する場合の例です。

(3)　論理サーバを停止するシェルスクリプトファイル

論理サーバを停止するシェルスクリプトファイルの例（manager_apserver1_stop.sh）を次に示します。

#!/bin/sh

MNGDIR=/opt/Cosminexus/manager
logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}
# stop logical server
logg "### $0: stop logical servers. ###"
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <Webサーバ1> -s stop server graceful:300
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <J2EEサーバ1> -s stop server
$MNGDIR/bin/mngsvrutil -m 192.168.0.11:28080 -t <パフォーマンストレーサ> -s stop server

このシェルスクリプトファイルでは，論理サーバを停止します。mngsvrutilコマンドの-mオプションの引数のホスト名には自ホストのステーショナリIPアドレスを指定し，-tオプションの引数には停止する論理サーバ名を指定します。

なお，このシェルスクリプトファイルは，Node1の現用系1で論理サーバを停止する場合の例です。

17.8.6　サーバ対応の環境設定

HAモニタでのサーバ対応の環境設定では，系で稼働させる実行サーバや待機サーバの環境を定義します。

serversという定義ファイルに，相互系切り替えシステム用のサーバ対応の環境を定義してください。サーバ対応の環境設定での設定内容を次の表に示します。

表17-16　サーバ対応の環境設定での設定内容（相互系切り替えシステムの場合）

オペランド
設定内容

name
論理サーバを起動するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_apserver1_start.sh

alias
サーバの識別名を指定します。対応する現用系と予備系で同じ名称を指定します。
指定例：CosminexusAP1（現用系1と予備系1の場合），CosminexusAP2（現用系2と予備系2の場合）

acttype
サーバの起動方法を指定します。ここでは，HAモニタのコマンドでサーバを起動するため，「monitor」を指定します。

termcommand
論理サーバを停止するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_apserver1_stop.sh

initial
サーバ起動時の状態を指定します。

現用系の場合
「online」を指定します。

予備系の場合
「standby」を指定します。

disk
共有ディスク装置のキャラクタ型スペシャルファイル名を指定します。
指定例：/dev/vg00（現用系1と予備系1の場合），/dev/vg01（現用系2と予備系2の場合）

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。ここでは，LANの状態設定ファイルを使用するため，「use」を指定します。

fs_name
切り替えるファイルシステムに対応する論理ボリュームの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/dev/rdisk0

fs_mount_dir
切り替えるファイルシステムのマウント先ディレクトリの絶対パス名を指定します。なお，この設定は，$TPFSをUNIXファイルで使用する場合だけ必要です。
指定例：/hamon

patrolcommand
運用管理エージェントのプロセスを監視するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/manager_adminagent_monitor.sh

servexec_retry
障害を検出した場合の再起動の回数を指定します。ここでは，障害が発生した場合に再起動しないで系を切り替えるため，「0」を指定します。

waitserv_exec
論理サーバの起動完了処理を実行するときに起動コマンドの実行完了を待つかどうかを指定します。ここでは，実行完了を待つため，「yes」を指定します。

serversファイルの例を次に示します。

serversファイルの例（Node1の現用系1（予備系2）の場合）

Node1の現用系1（予備系2）の場合のserversファイルの例を次に示します。

server  name           /home/manager/hamon/bin/manager_apserver1_start.sh,
       alias          CosminexusAP1,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_apserver1_stop.sh,
       initial        online,
       disk           /dev/vg00,
       lan_updown     use,
       fs_name        /dev/rdisk0,
       fs_mount_dir   /hamon,
       patrolcommand  /home/manager/hamon/bin/manager_adminagent_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

server  name           /home/manager/hamon/bin/manager_apserver2_start.sh,
       alias          CosminexusAP2,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_apserver2_stop.sh,
       initial        standby,
       disk           /dev/vg01,
       lan_updown     use,
       fs_name        /dev/rdisk1,
       fs_mount_dir   /hamon1,
       patrolcommand  /home/manager/hamon/bin/manager_adminagent_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

serversファイルの例（Node2の予備系1（現用系2）の場合）

Node2の予備系1（現用系2）の場合のserversファイルの例を次に示します。

server  name           /home/manager/hamon/bin/manager_apserver1_start.sh,
       alias          CosminexusAP1,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_apserver1_stop.sh,
       initial        standby,
       disk           /dev/vg00,
       lan_updown     use,
       fs_name        /dev/rdisk0,
       fs_mount_dir   /hamon,
       patrolcommand  /home/manager/hamon/bin/manager_adminagent_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

server  name           /home/manager/hamon/bin/manager_apserver2_start.sh,
       alias          CosminexusAP2,
       acttype        monitor,
       termcommand    /home/manager/hamon/bin/manager_apserver2_stop.sh,
       initial        online,
       disk           /dev/vg01,
       lan_updown     use,
       fs_name        /dev/rdisk1,
       fs_mount_dir   /hamon1,
       patrolcommand  /home/manager/hamon/bin/manager_adminagent_monitor.sh,
       servexec_retry 0,
       waitserv_exec  yes;

この設定例では，インプロセストランザクションサービスのステータスファイル格納先に，共有ディスク上のディレクトリを指定しています。なお，インプロセストランザクションサービスのステータスファイル格納先は，Management ServerのSmart Composer機能の簡易構築定義ファイルで，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.distributedtx.ots.status.directory1パラメタで指定します。

17.8.7　LANの状態設定

HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

次のファイルにエイリアスIPアドレスを設定してください。

<サーバ識別名>.upファイル
LANを接続する場合に使用します。LANアダプタに追加するエイリアスIPアドレスを指定します。

<サーバ識別名>.downファイル
LANを切り離す場合に使用します。LANアダプタから削除するエイリアスIPアドレスを指定します。

<サーバ識別名>には，サーバ対応の環境設定（serversファイル）のaliasの値を指定してください。

LANの状態設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.8.8　アプリケーションサーバの設定

アプリケーションサーバの設定では，Management ServerとHAモニタのコマンドを使用してCosminexusをクラスタ構成に配置します。また，論理サーバをセットアップして設定情報を配布し，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポート，および開始します。アプリケーションサーバの設定手順を次に示します。

Node1およびNode2で，それぞれ運用管理エージェント，およびManagement Serverを起動します。
運用管理エージェント，およびManagement Serverの起動方法については，「3.2　システムの起動と停止の設定」を参照してください。

Node1およびNode2でHAモニタのmonbeginコマンドを実行して，現用系のアプリケーションサーバを実行系として起動し，予備系のアプリケーションサーバを待機状態にします。

Node1でのコマンドの実行例
「# monbegin CosminexusAP1」を実行して，Node1の現用系1を起動します。
「# monbegin CosminexusAP2」を実行して，Node1の予備系2を待機状態にします。

Node2でのコマンドの実行例
「# monbegin CosminexusAP1」を実行して，Node2の予備系1を待機状態にします。
「# monbegin CosminexusAP2」を実行して，Node2の現用系2を起動します。

現用系のアプリケーションサーバ（Node1の現用系1とNode2の現用系2）が起動されて，予備系のアプリケーションサーバ（Node2の予備系1とNode1の予備系2）が待機状態になっている，通常の運用状態になります。

現用系のアプリケーションサーバ（Node1の現用系1とNode2の現用系2）に対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして，起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
J2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。

Node2でHAモニタのmonswapコマンドを実行して，系を切り替えます。

Node2でのコマンドの実行例
「# monswap CosminexusAP2」を実行して，サーバ識別名「CosminexusAP2」で系を切り替えます。Node1の予備系2が起動され，Node2の現用系2が待機状態になります。

Node1の予備系2のアプリケーションサーバに対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
Node1の予備系2には，Node2の現用系2と同じJ2EEアプリケーションとリソースアダプタをインポートします。

Node1でHAモニタのmonswapコマンドを実行して，系を切り替えて通常の運用状態に戻します。

Node1でのコマンドの実行例
「# monswap CosminexusAP2」を実行して，サーバ識別名「CosminexusAP2」で系を切り替えます。Node2の現用系2が起動され，Node1の予備系2が待機状態になります。

Node1でHAモニタのmonswapコマンドを実行して，系を切り替えます。

Node1でのコマンドの実行例
「# monswap CosminexusAP1」を実行して，サーバ識別名「CosminexusAP1」で系を切り替えます。Node2の予備1が起動され，Node1の現用系1が待機状態になります。

Node2の予備系1のアプリケーションサーバに対して，Management ServerのSmart Composer機能のコマンドで，設定済みの簡易構築定義ファイルを基に，Webシステムをセットアップして起動します。また，サーバ管理コマンドを使用して，J2EEアプリケーションとリソースアダプタをインポートして，インポートしたJ2EEアプリケーションとリソースアダプタを開始します。
Node2の予備系1には，Node1の現用系1と同じJ2EEアプリケーションとリソースアダプタをインポートします。

Node2でHAモニタのmonswapコマンドを実行して，系を切り替えて通常の運用状態に戻します。

Node2でのコマンドの実行例
「# monswap CosminexusAP1」を実行して，サーバ識別名「CosminexusAP1」で系を切り替えます。Node1の現用系1が起動され，Node2の予備1が待機状態になります。

17.9　N:1リカバリシステムの設定（UNIXの場合）

N:1リカバリシステムは，N台の実行系に対して1台の待機系（リカバリ専用サーバ）を用意する構成のシステムです。J2EEサーバを冗長化した構成でグローバルトランザクションを使用する場合に，特定のJ2EEサーバにトラブルが発生したとき，トランザクションを決着するために使用します。このシステムは，運用管理ポータルを使用して構築します。運用管理ポータルについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。この節では，N:1リカバリシステムの設定について説明します。

業務は，N台の実行系のアプリケーションサーバで実行します。業務実行中のアプリケーションサーバに障害が発生すると，HAモニタがこれを検知して，リカバリ専用サーバで，障害が発生したアプリケーションサーバの仕掛かり中のトランザクションを決着します。その後，残りの稼働中の実行系のアプリケーションサーバで業務を続行します。

なお，N:1リカバリシステムの運用は，AIX，HP-UXまたはLinuxの場合だけ使用できます。

機能の詳細については，マニュアル「Cosminexus　機能解説」のクラスタソフトウェアと連携したシステムの運用に関する説明を参照してください。システム構成については，マニュアル「Cosminexus　システム設計ガイド」のリカバリ専用サーバを使用する場合の構成に関する説明を参照してください。また，HAモニタについては，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

＜この節の構成＞

17.9.1　N:1リカバリシステムの設定手順

17.9.2　クラスタサーバの環境設定

17.9.3　設定ファイルの編集

17.9.4　HAモニタの環境設定

17.9.5　シェルスクリプトファイルの作成

17.9.6　サーバ対応の環境設定

17.9.7　LANの状態設定

17.9.8　アプリケーションサーバの設定

17.9.1　N:1リカバリシステムの設定手順

ここでは，システムの構成例とシステムの設定手順について説明します。また，実行系を追加または削除する場合の設定手順についても説明します。

＜この項の構成＞

(1)　システムの構成例

(2)　システムの設定手順

(3)　実行系を追加または削除する場合の設定手順

(1)　システムの構成例

N:1リカバリシステムの構成例を次の図に示します。なお，以降の項では，このシステムの構成例を使用したシステムの構築例を示します。

図17-16　N:1リカバリシステムの構成例（UNIXの場合）

この例の概要を次に示します。

4台の実行系サーバと1台のリカバリ専用サーバを配置しています。4台の実行系のJ2EEサーバの構成はJ2EEアプリケーションとリソースアダプタの設定が均質な構成とします。違いはエイリアスIPアドレスとマウントする共有ディスクデバイスです。

実行系と待機系で，J2EEサーバは同じ名称にします。ここでは，実行系で「MyServer」というJ2EEサーバを配置しているため，待機系にも「MyServer」というJ2EEサーバを配置します。

Management Serverの運用管理ポータルを利用してシステムを構築，運用管理します。

実行系では運用管理エージェントを動作させます。待機系では運用管理エージェントを動作させません。

なお，N:1リカバリシステムを運用する場合は，次の条件を満たすアプリケーションサーバを構築してください。

OTSを使用したグローバルトランザクションを使用します。トランザクションのステータスファイルは共有ディスク装置に格納します。

ネーミングサービスはインプロセスで動作させます。

待機系のJ2EEサーバには，実行系のJ2EEサーバで使用しているすべてのリソースアダプタと同じ設定のリソースアダプタをインポート，およびデプロイします。

N:1リカバリ構成の場合，一つのクラスタ内に複数の仮想ホストを構築します。仮想ホストは実行系とリカバリ専用サーバの組で構成し，J2EEサーバをクラスタ構成で配置します。N:1リカバリ構成の場合，J2EEサーバはクラスタ内ではなく，仮想ホスト内で動作します。このため，仮想ホストのIPアドレスおよびホスト名を設定してください。
Cosminexusをクラスタ構成に配置するためには，エイリアスIPアドレスを設けて，稼働中のノードがエイリアスIPアドレスを引き継ぐことで，クライアントがクラスタ内のノードを意識しないようにします。N:1リカバリ構成の場合，エイリアスIPアドレスは，仮想ホストのIPアドレスとなります。N:1リカバリ構成での仮想ホストの構成例を次に示します。

図17-17　N:1リカバリ構成での仮想ホストの構成例

(2)　システムの設定手順

HAモニタと連携する場合には，運用管理ポータルやHAモニタのファイルの設定などが必要になります。N:1リカバリシステムの設定手順を次の図に示します。

図17-18　N:1リカバリシステムの設定手順（UNIXの場合）

図中の1.～9.について説明します。

共有ディスクにN個のパーティションを作成して，ファイルシステムを構築します。

システムに共有ディスクを割り当てます。
システムに共有ディスクを割り当てる際は，現用系と予備系で，同じマウント先ディレクトリにしてください。

運用管理ポータルでクラスタサーバの環境を設定します。
運用管理ポータルの「Cosminexus Management Serverの設定」，「運用管理ドメインの構成定義」，および「論理サーバの環境設定」で，HAモニタを使用する場合の設定をします。

設定ファイルを編集します。
運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種定義ファイルを設定します。

HAモニタの環境を設定します。
HAモニタのsysdefファイルで，HAモニタの環境を定義します。

シェルスクリプトファイルを作成します。
運用管理エージェントを監視，アプリケーションサーバ上の論理サーバを起動，停止するためのシェルスクリプトファイルを作成します。

サーバ対応の環境を設定します。
HAモニタのserversファイルで，系で稼働させる現用系サーバや予備系サーバの環境を定義します。

LANの状態を設定します。
HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

運用管理ポータルとHAモニタのコマンドで，アプリケーションサーバの設定をします。
運用管理ポータル，HAモニタのコマンドを使用して，Cosminexusをクラスタ構成に配置し，J2EEアプリケーションやリソースアダプタを設定します。

参考

N:1リカバリシステムで，待機系でのリカバリ処理がデータベースサーバの障害（サーバダウンやデッドロックなど）によってタイムアウトした場合は，手動でリカバリを実行する必要があります。
タイムアウトの原因を解消したあと，待機系のホストで，停止した実行系のホストに対応するmonbeginコマンドを実行し，停止した実行系のホストに対応するmonactコマンドを実行します。
N:1リカバリシステムでトラブルが発生した場合については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

N:1リカバリシステムで設定が必要なファイルは，実行系と待機系で異なります。N:1リカバリシステムでのファイルの設定の要否を次の表に示します。

表17-17　N:1リカバリシステムでのファイルの設定の要否

分類
ファイルの種類
ファイルの設定の要否
参照先

実行系（N台）
待機系（リカバリ専用1台）

Cosminexusの設定
運用管理エージェントの設定
adminagent.properties
必要（N台で個別の設定）
－
17.9.3

スマートエージェントの設定
localaddr

Hitachi Web Serverの設定
httpsd.conf※

J2EEサーバのプロパティの設定
usrconf.properties※
必要（N台で共通の設定）
必要（エイリアスIPアドレス以外は実行系とほとんど同じ）

ワーカの設定
workers.properties※
必要（N台で個別の設定）
－

HAモニタの設定
HAモニタの環境設定
sysdef
必要（各ホストで個別の設定）
必要（N台分の設定）
17.9.4

シェルスクリプトファイルの作成
monitor.sh
start.sh
stop.sh
必要（N台で共通のコマンドを使用）
－
17.9.5

サーバ対応の環境設定
servers
必要（N台で個別の設定）
必要（N台分の設定）
17.9.6

recover.sh
－
必要（N台の実行系に対して共通のコマンドを使用。差異は引数で渡す）

LANの状態設定
<サーバの識別名>.up
<サーバ識別名>.down
必要（各ホストで個別の設定）
必要（実行系の設定ファイルのコピー）
17.9.7

（凡例）　－：不要。

注※　運用管理ポータルを利用してCosminexusの実行環境を構築するときに，これらのファイルを設定できます。

(3)　実行系を追加または削除する場合の設定手順

N:1リカバリシステムで，1台の実行系を追加または削除（縮退）する場合の設定手順を次に示します。

1台の実行系を追加する場合

追加する実行系で，マウントディレクトリを作成します。

待機系のserversファイルに追加する実行系に対応したエントリを追加します。
なお，追加する実行系に対応したエントリがすでに存在する場合はこの手順は不要です。

待機系で，追加した実行系に対応するmonbeginコマンドを実行します。

実行系で，monbeginコマンドを実行します。

運用管理ポータルを利用して，追加する実行系にCosminexusの実行環境を構築します。

運用管理ポータルを使用して，一括起動で実行系のアプリケーションサーバを起動します。

1台の実行系を削除する場合

実行系で，monendコマンドを実行します。

17.9.2　クラスタサーバの環境設定

HAモニタと連携する場合の，運用管理ポータルでの設定の留意点については，「17.6.2　クラスタサーバの環境設定」を参照してください。なお，N:1リカバリ構成の場合，ホスト名には，エイリアスIPアドレスではなく，仮想ホストのIPアドレスを設定してください。

17.9.3　設定ファイルの編集

運用管理ポータルでは設定できない，運用管理エージェントやManagement Server，Hitachi Web Serverなどの各種設定ファイルを編集します。ここでは，HAモニタと連携する場合に注意が必要なファイルの設定について説明します。

＜この項の構成＞

(1)　設定が必要なファイル

(2)　待機系でのJ2EEサーバのプロパティの設定

(1)　設定が必要なファイル

設定が必要なファイルは実行系と待機系で異なります。

実行系（N台）の場合

実行系（N台）の場合に注意が必要な設定ファイルについて説明します。

ファイルを直接編集して設定できるファイル

次のファイルは，ファイルを直接編集して設定できます。

運用管理エージェントの設定（adminagent.properties）

スマートエージェントの設定（localaddr）

運用管理ポータルで設定できるファイル

次のファイルは，運用管理ポータルを利用してCosminexusの実行環境を構築するときに設定できます。

Hitachi Web Serverの設定（httpsd.conf）

J2EEサーバのプロパティの設定（usrconf.properties）

ワーカの設定（workers.properties）

これらのファイルの設定については，「17.6.3　設定ファイルの編集」を参照してください。なお，N:1リカバリ構成の場合，ホスト名には，エイリアスIPアドレスではなく，仮想ホストのIPアドレスを設定してください。

待機系（リカバリ専用1台）の場合

待機系（リカバリ専用1台）の場合に注意が必要な設定ファイルを次に示します。なお，このファイルは，ファイルを直接編集して設定できます。

J2EEサーバのプロパティの設定（usrconf.properties）

(2)　待機系でのJ2EEサーバのプロパティの設定

待機系のJ2EEサーバでusrconf.propertiesにプロパティを設定するときに注意が必要なキーを次に示します。

ejbserver.distributedtx.XATransaction.enabled
ライトトランザクションを無効にするため「false」を設定してください。

17.9.4　HAモニタの環境設定

使用しているシステムに従って，sysdefという定義ファイルにHAモニタの環境を定義してください。N台の実行系とリカバリ専用の1台の待機系を含めて各ホストで個別の設定が必要です。

name（HAモニタのホスト名），address（CPUリセット用のユニークな値），lan（LANのホスト名）をホスト環境に合わせて一意に設定してください。なお，N台の実行系とリカバリ専用の1台の待機系を含めて一意の値を設定する必要があります。また，lanport（lanオペランドで指定したホスト名に対応するサービス名）は，N台の実行系とリカバリ専用の1台の待機系を含めて同じ値を設定する必要があります。

sysdefファイルの例を次に示します。なお，サンプル中の「N」は，N番目の値であることを意味します。

environment name     $host_N,    #自系のホスト名
           address  $uniq_N,    #CPUリセット用のユニークな値
           patrol   5,          #系障害と判断する時間
           lan      $host_N     #LANのホスト名
           lanport  $service_N  #lanオペランドのホスト名に対応するサービス名

HAモニタの環境設定については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

17.9.5　シェルスクリプトファイルの作成

運用管理エージェントのプロセスを監視し，運用管理エージェントと論理サーバを起動および停止するために，次のシェルスクリプトファイルを作成します。

実行系（N台）の場合

実行系で設定が必要なシェルスクリプトファイルを次に示します。なお，N台で共通のコマンドを使用します。

運用管理エージェントのプロセスを監視するシェルスクリプトファイル

運用管理エージェントを起動するシェルスクリプトファイル

運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

待機系（リカバリ専用1台）の場合

待機系で設定が必要なシェルスクリプトファイルを次に示します。なお，N台の実行系に対して共通のコマンドを使用し，差異はコマンドの引数で渡すようにします。

リカバリ処理を実行するシェルスクリプトファイル

各スクリプトについて説明します。

＜この項の構成＞

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

(2)　運用管理エージェントを起動するシェルスクリプトファイル

(3)　運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

(4)　リカバリ処理を実行するシェルスクリプトファイル

(1)　運用管理エージェントのプロセスを監視するシェルスクリプトファイル

運用管理エージェントのプロセスを監視するシェルスクリプトファイルの例（monitor.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
AA=/opt/Cosminexus/manager/bin/adminagent

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

logg "### $0: started. ###"
while true
do
   CHECK=`ps -ef | grep $AA | grep -v grep`

   if [ "$CHECK" = "" ]
   then
       logg "### $0: stop. ###"
       exit 0
   fi
   sleep 10
done

この例では，運用管理エージェントのプロセスが存在しているかどうかを10秒おきに監視しています。

(2)　運用管理エージェントを起動するシェルスクリプトファイル

運用管理エージェントを起動するためのシェルスクリプトファイルの例（start.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

# start Administration Agent
logg "### $0: starting Administration Agent. ###"
$MNGDIR/bin/adminagentctl start
if [ $? -eq 0 ] ; then
 logg "### $0: Administration Agent start normally. ###"
else
 logg "### $0: Administration Agent cannot start. ###"
 exit 1
fi

exit 0

(3)　運用管理エージェントと論理サーバを停止するシェルスクリプトファイル

運用管理エージェントと論理サーバを停止するためのシェルスクリプトファイルの例（stop.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
MNGDIR=/opt/Cosminexus/manager

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

# stop logical server
logg "### $0: stop logical servers. ###"
$MNGDIR/bin/mngsvrutil -m mnghost:28080 -u admin -p admin ¥
                           -t 172.16.12.31 -k host -s stop server

# stop Administration Agent
logg "### $0: stopping Administration Agent. ###"
$MNGDIR/bin/adminagentctl stop

exit 0

シェルスクリプトファイルでの設定内容のポイントを説明します。なお，コマンドおよびファイルの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

論理サーバの停止
同一ホスト上の論理サーバを一括停止するように設定します。論理サーバの一括停止にはmngsvrutilコマンドを使用します。
ユーザ名とパスワードは引数として渡しています。これらの値は，mngsvrutilコマンドのクライアント側定義ファイル（.mngsvrutilrc）に記述して，適切なアクセス権を設定して管理するようにしてください。
また，mngsvrutilコマンドの-tオプションにはエイリアスIPアドレスを指定してください。

運用管理エージェントの停止
運用管理エージェントを停止するように設定します。運用管理エージェントの停止には，adminagentctl stopを使用します。

(4)　リカバリ処理を実行するシェルスクリプトファイル

各J2EEサーバに対してリカバリ処理を実行するためのシェルスクリプトファイルの例（recover.sh）を次に示します。

#!/bin/sh

LOGDIR=/home/manager/hamon/log
PATH=/opt/Cosminexus/CC/server/bin:/bin:/usr/bin:/home/manager/hamon/bin
LD_LIBRARY_PATH=/opt/DABroker/lib:/opt/Cosminexus/jdk/lib:/opt/Cosminexus/TPB/lib:/opt/Cosminexus/PRF/lib:/opt/Cosminexus/CTM/lib:/bin:/opt/HiRDB/client/lib:/opt/oracle/app/oracle/product/10.1.0/client_1/lib:/opt/oracle/app/oracle/product/10.1.0/client_1/lib/libclntsh.so.10.1:/opt/oracle/app/oracle/product/10.1.0/client_1/lib/libclntsh.so
export LD_LIBRARY_PATH

LOCKFILE=/var/lock/kosmi_recover.lock
SLEEP_TIME=60
RETRIES=30
STATUS_PATH=$3/otsstatus

cjlockfile()
{
   counter=$2
   TMP_LOCK_FILE=`dirname $3`/$$.lock
   echo $$ > $TMP_LOCK_FILE

   if [ -f $3 ]
   then
       kill -0 `cat $3` 2>/dev/null || rm -f $3
   fi

   until ln $TMP_LOCK_FILE $3 2>/dev/null
   do
       counter=`expr $counter - 1`
       if [ $counter -le 0 ]
       then
           rm -f $TMP_LOCK_FILE
           return 1
       fi
       sleep $1
   done

   rm -f $TMP_LOCK_FILE
   return 0
}

logg()
{
   echo `date '+[%Y/%m/%d %H:%M:%S]'`"[$$]: $1" ¥
       >> ${LOGDIR}/adminagent.log 2>&1
}

if cjlockfile ${SLEEP_TIME} ${RETRIES} ${LOCKFILE}
then
   logg "### $0: started for $1 ###"
   cjstartrecover MyServer -p vbroker.se.iiop_tp.host=$2 ¥
                 -p ejbserver.distributedtx.ots.status.directory1=$STATUS_PATH ¥
                 -t 600
   logg "### $0: ended. $? ###"
fi

rm -f $LOCKFILE

exit 0

シェルスクリプトファイルでの設定内容のポイントを説明します。なお，コマンドおよびファイルの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

リカバリ処理に必要で，実行系ごとに異なる情報（エイリアス名，エイリアスIPアドレス，マウントディレクトリ）は，serversファイルの待機系のactcommandで，コマンドの引数として渡します。

LD_LIBRARY_PATHなどの環境変数を明示的に指定する必要があります。環境変数については，「2.3　環境変数の設定」を参照してください。

cjlockfile関数を利用して，リカバリ処理が排他的に実行されるようにしています。この関数は，ファイルロックによるセマフォを提供しています。第1引数にスリープ時間（秒単位），第2引数にリトライ回数，第3引数にロックファイルを指定します。この関数では，第3引数で指定されたファイルがロックされている場合には，第1引数で指定した時間だけ待って再度ファイルロックの取得を試みます。第2引数に指定した回数分リトライしてもファイルロックが取得できない場合には，リカバリ処理に失敗します。ファイルをロックしているプロセスが存在しない場合は，ロックを横取りします。

J2EEサーバ（MyServer）に対してcjstartrecoverでリカバリ処理を実行します。

このサンプルでは，タイムアウト時間は600秒にしています。

cjstartrecover コマンドの-pオプションで，ejbserver.distributedtx.ots.status.directory1キーに停止した実行系のステータスファイルディレクトリが指定されるようにしています。

cjstartrecover コマンドの-pオプションで，vbroker.se.iiop_tp.hostキーに系切り替え後のエイリアスIPアドレスが指定されるようにしています。

停止した実行系ごとに異なるプロパティをcjstartrecover コマンドの-pオプションで上書き指定しています。

J2EEサーバが複数の構成の場合には，cjstartrecoverコマンドをJ2EEサーバの数だけ実行します。その際，J2EEサーバ名（MyServer）とOTSのステータスファイルディレクトリのパスは適宜修正してください。

17.9.6　サーバ対応の環境設定

HAモニタでのサーバ対応の環境設定では，系で稼働させる実行サーバや待機サーバの環境を定義します。

実行系（N台）の場合

N台で個別の設定が必要です。

待機系（リカバリ専用1台）の場合

N台分の実行系の設定が必要です。

serversという定義ファイルに，N:1リカバリシステム用のサーバ対応の環境を定義してください。サーバ対応の環境設定での設定内容を次の表に示します。

表17-18　サーバ対応の環境設定での設定内容（N:1リカバリシステムの場合）

オペランド
設定内容

name

実行系の場合
起動コマンドをN台で共通化するため，nameにはユニークな名前を指定し，actcommandに運用管理エージェントを起動するシェルスクリプトファイルを記述します。

待機系の場合
対応する実行系と同じ値を指定します。

alias

実行系の場合
サーバの識別名を指定します。
指定例：CosminexusAP1

待機系の場合
対応する実行系と同じ値を指定します。

acttype
サーバの起動方法を指定します。ここでは，HAモニタのコマンドでサーバを起動するため，「monitor」を指定します。

termcommand

実行系の場合
実行系の運用管理エージェントと論理サーバを停止するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/stop.sh

待機系の場合
待機系の運用管理エージェントと論理サーバを停止するシェルスクリプトファイルを指定します。

initial
サーバ起動時の状態を指定します。

実行系の場合
「online」を指定します。

待機系の場合
「standby」を指定します。

disk
共有ディスク装置のキャラクタ型スペシャルファイル名を指定します。

実行系の場合
割り当てられた共有ディスクに合わせて指定します。

待機系の場合
対応する実行系と同じ値を指定します。

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。ここでは，LANの状態設定ファイルを使用するため，「use」を指定します。

fs_name
切り替えるファイルシステムに対応する論理ボリュームの絶対パス名を指定します。

実行系の場合
割り当てられた共有ディスクに合わせて指定します。

待機系の場合
対応する実行系と同じ値を指定します。

fs_mount_dir
切り替えるファイルシステムのマウント先ディレクトリの絶対パス名を指定します。

実行系の場合
割り当てられた共有ディスクに合わせて指定します。

待機系の場合
対応する実行系ごとに異なるマウントディレクトリとします。存在するディレクトリでなくてはならないので，待機系の構築時にあらかじめ作成しておく必要があります。

patrolcommand

実行系の場合
運用管理エージェントのプロセスを監視するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/monitor.sh

待機系の場合
monendコマンドを指定して，actcommandでリカバリが終了したらHAモニタを終了させるようにします。

servexec_retry
実行系で障害を検出した場合の再起動の回数を指定します。実行系および待機系で同じ値を指定してください。

waitserv_exec
実行系および待機系で，起動完了処理を実行するときに起動コマンドの実行完了を待つようにするため，「yes」を指定します。

actcommand

実行系の場合
運用管理エージェントを起動するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/start.sh

待機系の場合
リカバリ処理を実行するシェルスクリプトファイルを指定します。
指定例：/home/manager/hamon/bin/recover.sh

serversファイルのサンプルを次に示します。なお，サンプル中の「N」や「N+1」は，N番目またはN+1番目の値であることを意味します。

serversファイルのサンプル（実行系の場合）

このサンプル中で下線の引いてある個所は，実行系ごとに内容が異なる個所であることを示します。

server name            $name_N,
      alias           $alias_N,
      acttype         monitor,
      initial         online,
      termcommand     /home/manager/hamon/bin/stop.sh,
      disk            $disk_N,
      lan_updown      use,
      fs_name         $fs_name_N,
      fs_mount_dir    /hamon,
      patrolcommand   /home/manager/hamon/bin/monitor.sh,
      servexec_retry  3,
      waitserv_exec   yes,
      actcommand      /home/manager/hamon/bin/start.sh;

serversファイルのサンプル（待機系の場合）

このサンプル中では，リカバリ処理を実行するコマンドを一つにするため，実行系ごとに異なる情報（エイリアス名，エイリアスIPアドレス，マウントディレクトリ）は引数として渡しています。また，このサンプル中で下線の引いてある個所は，実行系のserversファイルと内容が異なる個所であることを示します。

server name             $name_N,
      alias            $alias_N,
      acttype          monitor,
      initial          standby,
      termcommand      /home/manager/hamon/bin/stop.sh,
      disk             $disk_N,
      lan_updown       use,
      fs_name          $fs_name_N,
      fs_mount_dir     $mnt_N,
      patrolcommand    "/opt/hitachi/HAmon/bin/monend $alias_N",
      servexec_retry   3,
      waitserv_exec    yes,
      actcommand       "/home/manager/hamon/bin/recover.sh $alias_N $ip_N $mnt_N";

server name             $name_N+1,
      alias            $alias_N+1,
      acttype          monitor,
      initial          standby,
      termcommand      /home/manager/hamon/bin/stop.sh,
      lan_updown       use,
      disk             $disk_N+1,
      fs_name          $fs_name_N+1,
      fs_mount_dir     $mnt_N+1,
      patrolcommand    "/opt/hitachi/HAmon/bin/monend $alias_N+1",
      servexec_retry   3,
      waitserv_exec    yes,
      actcommand       "/home/manager/hamon/bin/recover.sh $alias_N+1 $ip_N+1 $mnt_N+1";

待機系のserversファイルの設定内容のポイントについて説明します。

待機系のserversファイルには，N台分の実行系の設定を記述してください。また，実行系に対応したエントリを記述してください。

リカバリ処理を実行するコマンドを一つにするため，実行系ごとに異なる情報（エイリアス名，エイリアスIPアドレス，マウントディレクトリ）は引数として渡すようにすることをお勧めします。

17.9.7　LANの状態設定

HAモニタのLANの状態設定ファイルで，LANアダプタのIPアドレスなどを指定してHAモニタでのLANの切り替えについて定義します。

次のファイルにエイリアスIPアドレスを設定してください。

<サーバ識別名>.upファイル
LANを接続する場合に使用します。LANアダプタに追加するエイリアスIPアドレスを指定します。

<サーバ識別名>.downファイル
LANを切り離す場合に使用します。LANアダプタから削除するエイリアスIPアドレスを指定します。

<サーバ識別名>には，サーバ対応の環境設定（serversファイル）のaliasの値を指定してください。

実行系および待機系で，それぞれLANの状態設定ファイルを作成してください。

実行系（N台）

エイリアスIPアドレスを設定・削除するスクリプトを作成します。ホストごとにエイリアスIPアドレスに合わせて設定してください。

待機系（リカバリ専用1台）

N台の実行系ホストの.upファイルと.downファイルを用意します。論理ネットワークデバイスは，N台の実行系ホストごとにユニークな値を指定してください。

LANの状態設定の詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

Linuxの場合のファイルの作成例を次に示します。このほかのOSの場合の作成例については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

<サーバの識別名>.upファイルの例

#!/bin/sh
/sbin/ifconfig eth0:1 inet 172.16.12.31 ¥
                         netmask 255.255.255.0 broadcast 10.209.112.255 up
/sbin/arping -U -c 2 -I eth0 172.16.12.31

<サーバの識別名>.downファイルの例

#!/bin/sh
/sbin/ifconfig eth0:1 down

17.9.8　アプリケーションサーバの設定

アプリケーションサーバの設定では，運用管理ポータルとHAモニタのコマンドを使用してCosminexusをクラスタ構成に配置します。また，論理サーバをセットアップして設定情報を配布し，J2EEサーバにJ2EEアプリケーションとリソースアダプタをインポート，および開始します。アプリケーションサーバの設定手順を次に示します。

待機系ノードで，リカバリ用のJ2EEサーバを起動します。
cjstartsvコマンドを使用して，待機系（NodeR）のリカバリ用のJ2EEサーバを起動します。

待機系ノードのリカバリ用のJ2EEサーバで，リソースアダプタを設定します。
待機系では，実行系で使用しているすべてのリソースアダプタと同じ設定のリソースアダプタをインポート，デプロイ，および開始状態にしてください。ただし，待機系のJ2EEサーバに定義するリソースアダプタでは，コネクションプーリング機能を使用する必要はありません。サーバ管理コマンドで設定するコネクションの最小値と最大値は0を指定してください。
リソースアダプタのインポート，デプロイ，および開始には，サーバ管理コマンドを使用します。サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リソースアダプタの設定が完了したら，待機系ノードのリカバリ用のJ2EEサーバを停止します。
cjstopsvコマンドを使用して，待機系（NodeR）のリカバリ用のJ2EEサーバを停止します。

待機系ノードでHAモニタのmonbeginコマンドを実行して，待機系のアプリケーションサーバを待機状態にします。

待機系ノードでのコマンドの実行例
待機系（NodeR）で，N台の実行系（Node1～Node4）に対応する「# monbegin <サーバ識別名>」を実行して，N台の実行系に対応する待機系を待機状態にします。

運用管理サーバを起動します。
運用管理サーバを起動して，運用管理サーバ上の運用管理エージェント，Management Server，および論理サーバ（監視用CORBAネーミングサービス）を起動します。運用管理サーバの起動方法については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

実行系ノード（Node1～Node4）でHAモニタのmonbeginコマンドを実行して，実行系のアプリケーションサーバを実行系として起動します。

実行系ノードでのコマンドの実行例
Node1～Node4で「# monbegin <サーバ識別名>」を実行して，各ノードの実行系を起動します。この例では，シェルスクリプトファイル（start.sh）が実行されて，Node1～Node4の各実行系の運用管理エージェントが起動されます。

運用管理ポータルで，Node1～Node4の各実行系のJ2EEサーバをセットアップします。
「運用管理ドメインの構成定義」の［セットアップ］画面で，J2EEサーバをセットアップします。運用管理ポータルでの操作手順および画面の詳細については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

運用管理ポータルで，J2EEサーバに設定した情報をNode1～Node4の各実行系に配布します。
「論理サーバの環境設定」の［設定情報の配布］画面で，J2EEサーバに設定した情報をNode1～Node4の各実行系に配布します。

運用管理ポータルで，各実行系の論理サーバを起動します。
この例では，シェルスクリプトファイル（start.sh）の中で実行系の論理サーバを起動しないため，運用管理ポータルを使用して論理サーバを起動してください。

サーバ管理コマンドを使用して，Node1～Node4の各実行系のJ2EEサーバにJ2EEアプリケーションとリソースアダプタをインポートします。また，インポートしたJ2EEアプリケーションとリソースアダプタを設定および開始します。
サーバ管理コマンドでのJ2EEアプリケーションの設定については，「9.5　J2EEアプリケーションの設定」を参照してください。リソースアダプタの設定については，「9.3　リソースアダプタの設定」を参照してください。また，サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
なお，J2EEサーバおよびその前提プロセスを起動してからサーバ管理コマンドを実行してください。また，サーバ管理コマンドでの操作が終わったら，サーバ管理コマンドを停止させてください。

18.　Webサーバとの連携の設定（Webリダイレクタ環境の場合）

この章では，Webリダイレクタ環境構築時や，Smart Composer機能を使用しないでアプリケーションの実行環境を構築する場合に，Webサーバと連携してWebアプリケーションを実行するときに必要な設定と設定方法について説明します。

なお，Smart Composer機能でアプリケーションの実行環境構築時に必要なWebサーバとの連携の設定については，「7.　Webサーバとの連携の設定（J2EEアプリケーションを実行するシステム）」を参照してください。

＜この章の構成＞

18.1　Webサーバとの連携の設定の概要

18.2　リダイレクタを使用したリクエストの振り分けの設定

18.3　通信タイムアウトの設定

18.4　エラーページのカスタマイズの設定

18.5　ドメイン名指定でトップページを表示するための設定

18.6　Webコンテナにゲートウェイ情報を通知するための設定

18.7　リダイレクタのログ取得の設定

18.8　Hitachi Web Serverを使用するための設定

18.9　Microsoft IISを使用するための設定

18.1　Webサーバとの連携の設定の概要

この節では，Webサーバとの連携機能の概要と，Webサーバとの連携機能を設定するユーザ定義ファイルについて説明します。

＜この節の構成＞

18.1.1　Webサーバとの連携機能の概要

18.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

18.1.1　Webサーバとの連携機能の概要

Webサーバとの連携機能を次の表に示します。

表18-1　Webサーバとの連携機能

機能 | 説明 | 参照先
リダイレクタを使用したリクエストの振り分け | Webサーバに登録したリダイレクタによって，リクエストをURLパターンまたはラウンドロビン方式で複数のWebコンテナに振り分けて処理できます。 | 18.2
通信タイムアウト | クライアント－Webサーバ間，Webサーバ－Webコンテナ間で，リクエスト受信時およびレスポンス送信時の通信タイムアウトを設定しておき，トラブル発生時の応答待ちなどの場合に通信タイムアウトを検知できます。 | 18.3
エラーページのカスタマイズ | クライアントから，存在しないリソースに対してアクセスした場合などに，クライアントからのリクエストに対してユーザがカスタマイズしたエラーページを表示できます。 | 18.4
ドメイン名指定でのWebアプリケーションのトップページの表示 | ドメイン名指定によってWebアプリケーションのトップページを表示できます。 | 18.5
Webコンテナへのゲートウェイ情報の通知 | クライアントとWebサーバとの間にSSLアクセラレータや負荷分散機などのゲートウェイを配置している場合に，Webコンテナにゲートウェイ情報を通知して，WebアプリケーションのトップページやForm認証画面に自動的に正しくリダイレクトできます。 | 18.6
Hitachi Web ServerのSSLによる認証やデータ暗号化 | Hitachi Web Serverを使用する場合に，SSLによる認証機能やデータ暗号化の機能を使用できます。 | 18.8
Microsoft IISのSSLによる認証やデータ暗号化 | Microsoft IISを使用する場合に，SSLによる認証機能やデータ暗号化の機能を使用できます。 | 18.9

以降の節では，上記の機能を使用するための設定方法について説明します。システムで使用する機能に応じて適宜設定してください。

また，リダイレクタのログの出力レベル，サイズ，面数などの設定については，「18.7　リダイレクタのログ取得の設定」を参照してください。

ポイント

以降の節で説明する機能は，Webサーバの機能およびWebコンテナの機能のうち，Webサーバでの設定が必要となる機能です。Webサーバと連携する場合には，このほかに，Webクライアントとの通信制御やリクエストの流量制御などのWebコンテナの機能も使用できます。これらの機能を使用する場合には，J2EEサーバでの設定が必要です。J2EEサーバでの設定については，「4.　J2EEサーバの動作設定（J2EEアプリケーションを実行するシステム）」を参照してください。

18.1.2　Webサーバとの連携機能を設定するユーザ定義ファイル

Webサーバとの連携機能を設定するユーザ定義ファイルとユーザ定義ファイルに関する注意事項について説明します。

設定するファイルは，使用するWebサーバによって異なります。共通のユーザ定義ファイルと，Webサーバごとのユーザ定義ファイルを分けて説明します。なお，ユーザ定義ファイルのうち，httpsd.confの詳細については，マニュアル「Hitachi Web Server」を参照してください。ほかのユーザ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

Web Redirectorを使用してWebリダイレクタ環境を構築する場合は，各ユーザ定義ファイルの格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CCまたは/opt/Cosminexus/CC」を，「<Cosminexusのインストールディレクトリ>¥CCRまたは/opt/Cosminexus/CCR」と読み替えてください。

＜この項の構成＞

(1)　共通のユーザ定義ファイル

(2)　Hitachi Web Serverを使用する場合のユーザ定義ファイル

(3)　Microsoft IISを使用する場合のユーザ定義ファイル

(4)　注意事項

(1)　共通のユーザ定義ファイル

Hitachi Web Server，Microsoft IISを使用する場合で共通のユーザ定義ファイルを次に示します。

workers.properties（ワーカ定義ファイル）
ワーカの定義，およびワーカごとのパラメタを設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥workers.properties

UNIXの場合
/opt/Cosminexus/CC/web/redirector/workers.properties

usrconf.properties（ユーザプロパティファイル）
リダイレクタからのリクエストをWebコンテナで受信するときの通信タイムアウトを設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

(2)　Hitachi Web Serverを使用する場合のユーザ定義ファイル

Hitachi Web Serverを使用する場合のユーザ定義ファイルを次に示します。

mod_jk.conf（リダイレクタ動作定義ファイル）
Hitachi Web Serverでのリダイレクタの動作を設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥mod_jk.conf

UNIXの場合
/opt/Cosminexus/CC/web/redirector/mod_jk.conf

httpsd.conf（Hitachi Web Server定義ファイル）
Hitachi Web Serverの動作環境を定義するディレクティブ（Webサーバの実行環境を定義するパラメタ）を設定します。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥httpsd¥conf¥httpsd.conf

UNIXの場合
/opt/hitachi/httpsd/conf/httpsd.conf

(3)　Microsoft IISを使用する場合のユーザ定義ファイル

Microsoft IISを使用する場合のユーザ定義ファイルを次に示します。

uriworkermap.properties（マッピング定義ファイル）
Microsoft IISでのURLパターンとワーカのマッピングを設定します。
ファイルの格納場所を次に示します。
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥uriworkermap.properties

isapi_redirect.conf（リダイレクタ動作定義ファイル）
Microsoft IISでのリダイレクタの動作を設定します。
ファイルの格納場所を次に示します。
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.conf

(4)　注意事項

ユーザ定義ファイルに関する注意事項を次に示します。

上書きインストールの場合，ユーザ定義ファイルは上書きされません。

アップグレードインストールの場合のワーカ定義ファイル，およびWebサーバ定義ファイルの処理については，「付録A　Cosminexus Version 6およびCosminexus Version 7からの移行」を参照してください。

リダイレクタの定義ファイルの1行の最大文字数は，1,023文字です。この文字数内で定義してください。

次のユーザ定義ファイルで，同じ名称のパラメタが複数指定されている場合は，最初に指定されたパラメタの値を使用して動作します。

isapi_redirect.conf

workers.properties

uriworkermap.properties

18.2　リダイレクタを使用したリクエストの振り分けの設定

この節では，リダイレクタを使用したリクエストの振り分けの設定について説明します。

リダイレクタを使用したリクエストの振り分けでは，WebサーバあてのHTTPリクエストのうち，特定のリクエストを指定したWebコンテナに処理させたり，複数のWebコンテナにリクエストを振り分けて処理させたりします。機能の詳細については，マニュアル「Cosminexus　機能解説」のWebサーバ（リダイレクタ）によるリクエストの振り分けに関する説明を参照してください。

リダイレクタを使用してリクエストを振り分ける方法には，次の3種類があります。

URLパターンでのリクエスト振り分け

ラウンドロビン方式でのリクエスト振り分け

POSTデータサイズでのリクエスト振り分け

それぞれの方法でリクエストを振り分けるための設定について説明します。

＜この節の構成＞

18.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

18.2.2　URLパターンでのリクエスト振り分けの設定

18.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

18.2.4　POSTデータサイズでのリクエストの振り分けの設定

18.2.1　リクエストの振り分け方法を設定するユーザ定義ファイル

リクエストを振り分けるためには，次のユーザ定義ファイルをテキストエディタなどで編集して，ワーカ，URLパターンとワーカのマッピング，リダイレクタの動作を設定します。

workers.properties
ワーカの定義，およびワーカごとのパラメタを設定します。

mod_jk.conf（Hitachi Web Serverの場合）
Hitachi Web ServerへのリクエストでどのURLパターンがWebコンテナへ転送されるかというURLパターンとワーカのマッピング，リダイレクタの動作を設定します。

uriworkermap.properties（Microsoft IISの場合）
Microsoft IISへのリクエストでどのURLパターンがWebコンテナへ転送されるかというURLパターンとワーカのマッピングを設定します。

isapi_redirect.conf（Microsoft IISの場合
Microsoft IISでのリダイレクタの動作を設定します。

18.2.2　URLパターンでのリクエスト振り分けの設定

HTTPリクエストに含まれるURLパターンによってリクエストを振り分けることで，特定の処理だけをWebコンテナに実行させたり，複数のWebコンテナに処理内容に応じて振り分けたりできます。

＜この項の構成＞

(1)　設定の手順

(2)　設定例

(1)　設定の手順

URLパターンによるリクエストの振り分けは，次の手順で設定します。

workers.propertiesでワーカを定義します。
ワーカ名のリスト，ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名などを設定します。
標準で提供されるworkers.propertiesには，デフォルト値が定義されています。コメントとして定義されているデフォルトの定義を使用する場合は，該当する行の先頭の「#」を削除してください。

Hitachi Web Serverを使用する場合は，mod_jk.confでURLパターンとワーカのマッピングを定義します。Microsoft IISを使用する場合は，uriworkermap.propertiesでURLパターンとワーカのマッピングを定義します。
すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「18.8　Hitachi Web Serverを使用するための設定」，または「18.9　Microsoft IISを使用するための設定」を参照してください。

(2)　設定例

URLパターンでのリクエスト振り分けの例を次の図に示します。

図18-1　URLパターンでのリクエスト振り分けの例

この例では，ホストAにはWebアプリケーション「app1」，ホストBにはWebアプリケーション「app2」がそれぞれデプロイされています。処理したいWebアプリケーション名をリクエストのURLパターンに含めることで，「/app1/*」というURLパターンを持つリクエストはホストAで，「/app2/*」というURLパターンを持つリクエストはホストBで処理できるようにします。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。

workers.propertiesの例を次に示します。ここでは，複数のWebコンテナへリクエストを振り分けるので，Webサーバに登録したリダイレクタに，複数のWebコンテナのワーカを振り分け先として指定します。

workers.propertiesの例（Windowsの場合）

worker.list=worker1,worker2

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.cachesize=64

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.cachesize=64

workers.propertiesの例（UNIXの場合）

worker.list=worker1,worker2

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13

mod_jk.confおよびuriworkermap.propertiesの例を次に示します。ここでは，「/app1/*」というURLパターンと「worker1」，「/app2/*」というURLパターンと「worker2」とをマッピングします。

mod_jk.confの例（Hitachi Web Serverの場合）

JkMount /app1/* worker1
JkMount /app2/* worker2

uriworkermap.propertiesの例（Microsoft IISの場合）

/app1/*=worker1
/app2/*=worker2

18.2.3　ラウンドロビン方式でのリクエスト振り分けの設定

振り分け先となるワーカのリストをロードバランサに定義することで，ラウンドロビン方式でワーカにリクエストを振り分けます。

振り分け先となる各ワーカに負荷分散値を設定して，リクエスト振り分けの比率を定義すると，ホストごとの負荷の割合を調整できます。リダイレクタは，この比率でHTTPリクエスト単位にラウンドロビンでリクエストを振り分けるので，比率が高いワーカほど転送されるリクエストの割合が多くなります。ただし，同じセッションに属するHTTPリクエストは前回と同じワーカに振り分けられます。

＜この項の構成＞

(1)　設定の手順

(2)　設定例

(1)　設定の手順

ラウンドロビン方式でのリクエスト振り分けは，次の手順で設定します。

workers.propertiesでロードバランサ，およびワーカを定義します。

ロードバランサの定義

ワーカ名のリスト，ワーカのタイプ（「lb」を設定），負荷分散の対象となるワーカのリストなどを設定します。

各ワーカの定義

ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名，負荷分散値などを設定します。

標準で提供されるworkers.propertiesには，デフォルト値が定義されています。コメントとして定義されているデフォルトの定義を使用する場合は，該当する行の先頭の「#」を削除してください。

Hitachi Web Serverを使用する場合は，mod_jk.confでURLパターンとワーカのマッピングを定義します。Microsoft IISを使用する場合は，uriworkermap.propertiesでURLパターンとワーカのマッピングを定義します。
すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「18.8　Hitachi Web Serverを使用するための設定」，または「18.9　Microsoft IISを使用するための設定」を参照してください。

注意事項

リダイレクタで負荷分散を使用する場合に，あるワーカで障害を検出すると，障害を検出してから60秒間はそのワーカはリダイレクト先ワーカの選択肢から除外されます。そのため，障害が回復しても，最大で60秒間はそのワーカが使用されない場合があります。

Microsoft IISを使用してリダイレクタが動作するワーカプロセスを複数に設定した場合，ワーカプロセスを2以上に設定していると，workers.propertiesの最初に定義したワーカによって多く割り振られます。また，リクエストがどのサーバプロセスに割り振られるかはMicrosoft IISの制御によるため，同じ負荷分散値を指定してもラウンドロビンにならないことがあります。

UNIXの場合，Hitachi Web Serverのサーバプロセスを負荷に応じて生成・消滅させているときは，workers.propertiesの最初に定義したワーカによって多く割り振られます。また，サーバプロセス数を固定にしても，リクエストがどのサーバプロセスに割り振られるかは不定のため，同じ負荷分散値を指定してもラウンドロビンにならないことがあります。サーバプロセスは，消滅しなければ負荷に応じて増えてもよいため，サーバプロセスが短時間で生成・消滅しないようにディレクティブを指定する必要があります。
Hitachi Web Serverのhttpsd.confのディレクティブが次に示す条件を満すように，指定してください。

条件 | 意味
MaxSpareServers ≧ MaxClients | サーバプロセスはMaxClientsまで増加し，処理終了後も常駐します。
MaxRequestsPerChild 10000 | HTTPリクエストを10,000回処理後，リフレッシュのためにサーバプロセスを終了させます（10,000は推奨値）。振り分け先のJ2EEサーバまたはWebコンテナサーバ数に対して十分に大きな値を指定します。
StartServers = MaxClients | 最初に全サーバプロセスを起動しておく場合に指定します。

ディレクティブの指定例

StartServers 256
MaxClients 256
MaxSpareServers 256
MaxRequestsPerChild 10000

(2)　設定例

ラウンドロビン方式でのリクエスト振り分けの例を次の図に示します。

図18-2　ラウンドロビン方式でのリクエスト振り分けの例

この例では，「/examples」以下のリクエストがホストA，ホストBに同じ比率で振り分けます。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。

workers.propertiesの例を次に示します。ここでは，ロードバランサとワーカを定義します。リクエストを同じ比率で振り分けるので，「worker1」と「worker2」の負荷分散値はどちらも「1」を指定します。

workers.propertiesの例（Windowsの場合）

worker.list=loadbalancer1

worker.loadbalancer1.balanced_workers=worker1,worker2
worker.loadbalancer1.type=lb

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.cachesize=64
worker.worker1.lbfactor=1

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.cachesize=64
worker.worker2.lbfactor=1

workers.propertiesの例（UNIXの場合）

worker.list=loadbalancer1

worker.loadbalancer1.balanced_workers=worker1,worker2
worker.loadbalancer1.type=lb

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.lbfactor=1

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.lbfactor=1

mod_jk.confおよびuriworkermap.propertiesの例を次に示します。ここでは，ロードバランサ名「loadbalancer1」を指定します。

mod_jk.confの例（Hitachi Web Serverの場合）

JkMount /examples/* loadbalancer1

uriworkermap.propertiesの例（Microsoft IISの場合）

/examples/*=loadbalancer1

18.2.4　POSTデータサイズでのリクエストの振り分けの設定

振り分け先となるワーカのリストをPOSTリクエスト振り分けワーカに定義することで，POSTデータサイズでワーカにリクエストを振り分けます。

振り分け先となるPOSTリクエスト転送先ワーカに，POSTデータサイズの上限値を設定して，リクエスト振り分け先を定義します。これによって，特定のホストに，処理に時間が掛かる長大なPOSTデータサイズのリクエストの処理を振り分けられます。リダイレクタは，HTTPリクエスト単位にPOSTデータサイズの上限値で振り分けるので，長大なPOSTデータ以外のリクエストのスループットの低下や，レスポンス時間の低下を防ぐことができます。なお，POSTデータサイズの上限値が設定されている場合は，同じセッションに属するHTTPリクエストであっても，POSTデータサイズの値が優先されます。

注意

Microsoft IISと連携する場合，POSTデータサイズによるリクエストの振り分けは設定できません。

＜この項の構成＞

(1)　設定の手順

(2)　設定例

(1)　設定の手順

POSTデータサイズでのリクエスト振り分けは，次の手順で設定します。

workers.propertiesでPOSTリクエスト振り分けワーカ，およびPOSTリクエスト転送先ワーカを定義します。

POSTリクエスト振り分けワーカの定義

ワーカ名のリスト，ワーカのタイプ（「post_size_lb」を設定），POSTデータサイズによる振り分けの対象となるワーカのリストなどを設定します。

必要に応じて，デフォルトワーカも設定します。

各POSTリクエスト転送先ワーカの定義

ワーカのタイプ（「ajp13」を設定），ポート番号，ホスト名，POSTデータサイズの上限値などを設定します。

標準で提供されるworkers.propertiesには，デフォルト値が定義されています。コメントとして定義されているデフォルトの定義を使用する場合は，該当する行の先頭の「#」を削除してください。

mod_jk.confでURLパターンとワーカのマッピングを定義します。
すでにマッピングが定義されている場合は，定義を削除，または置き換えてください。

Webサーバの環境を設定して，Webサーバを再起動します。
Webサーバの設定については，「18.8　Hitachi Web Serverを使用するための設定」を参照してください。

(2)　設定例

POSTデータサイズでのリクエスト振り分けの例を次の図に示します。ここでは，リクエストを限定できない場合を例に説明します。

図18-3　POSTデータサイズでのリクエスト振り分けの例

この例では，「/examples」以下のリクエストのうち，POSTデータサイズが100メガバイト未満のリクエストをホストA，POSTデータサイズが100メガバイト以上200メガバイト未満のリクエストをホストBに振り分けます。リクエストの振り分け条件に満たないリクエストは，デフォルトワーカに設定したホストAに振り分けます。ホストAのワーカ名は「worker1」，ホストBのワーカ名は「worker2」です。リクエストの振り分け条件については，マニュアル「Cosminexus　機能解説」のPOSTデータサイズでのリクエストの振り分けに関する説明を参照してください。

workers.propertiesの例を次に示します。ここでは，POSTリクエスト振り分けワーカ，POSTリクエスト転送先ワーカおよびデフォルトワーカを定義します。POSTデータサイズの上限値は，「worker1」に「100m」，「worker2」に「2048m」（POSTデータサイズの上限値の最大値）を指定します。デフォルトワーカには，「worker1」を指定します。

workers.propertiesの例（Windowsの場合）

worker.list=postsizelb1

worker.postsizelb1.post_size_workers=worker1,worker2
worker.postsizelb1.type=post_size_lb
worker.postsizelb1.default_worker=worker1

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.cachesize=64
worker.worker1.post_data=100m

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.cachesize=64
worker.worker2.post_data=2048m

workers.propertiesの例（UNIXの場合）

worker.list=postsizelb1

worker.postsizelb1.post_size_workers=worker1,worker2
worker.postsizelb1.type=post_size_lb
worker.postsizelb1.default_worker=worker1

worker.worker1.port=8007
worker.worker1.host=hostA
worker.worker1.type=ajp13
worker.worker1.post_data=100m

worker.worker2.port=8007
worker.worker2.host=hostB
worker.worker2.type=ajp13
worker.worker2.post_data=2048m

mod_jk.confの例を次に示します。ここでは，POSTリクエスト振り分けワーカ「postsizelb1」を指定します。

mod_jk.confの例

JkMount /examples/* postsizelb1

参考

POSTデータサイズの上限値は，httpsd.conf（Hitachi Web Server定義ファイル）のLimitRequestBodyディレクティブでも設定できます。LimitRequestBodyディレクティブの詳細については，マニュアル「Hitachi Web Server」を参照してください。

18.3　通信タイムアウトの設定

この節では，クライアント－Webサーバ間，およびWebサーバ（リダイレクタ）－Webコンテナ間の通信タイムアウトの設定について説明します。

通信タイムアウトは，リクエストの送受信時，またはレスポンスの送受信時に設定します。リクエスト送受信時およびレスポンス送受信時の通信タイムアウトの設定についてそれぞれ説明します。機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナおよびWebサーバでの通信タイムアウトの設定に関する説明を参照してください。

なお，通信タイムアウトは，EJBを呼び出すEJBクライアント側でも設定できます。EJBクライアント側での設定は，J2EEアプリケーション開発時に設定します。設定方法については，マニュアル「Cosminexus　機能解説」のRMI-IIOP通信のタイムアウトに関する説明を参照してください。

＜この節の構成＞

18.3.1　リクエスト送受信時の通信タイムアウトの設定

18.3.2　レスポンス送受信時の通信タイムアウトの設定

18.3.1　リクエスト送受信時の通信タイムアウトの設定

リクエスト送受信時の通信タイムアウトは，クライアント－Webサーバ間，リダイレクタ－Webコンテナ間に設定します。リクエスト送受信時の通信タイムアウトの設定場所について，次の図に示します。

図18-4　リクエスト送受信時の通信タイムアウトの設定場所

図について説明します。なお，図中の番号と説明の番号は対応しています。

Webサーバでのリクエスト受信時（クライアント－Webサーバ）
Webサーバでは，クライアントから転送されたリクエストの受信処理の時間に，タイムアウトを設定できます。

リダイレクタでのリクエスト送信時（リダイレクタ－Webコンテナ）
リダイレクタでは，Webコンテナへのリクエスト送信処理の時間に，タイムアウトを設定できます。

Webコンテナでのリクエスト受信時（リダイレクタ－Webコンテナ）
Webコンテナでは，リダイレクタから転送されたリクエストの受信処理の時間に，タイムアウトを設定できます。

それぞれの場合での通信タイムアウトの設定方法について説明します。

＜この項の構成＞

(1)　Webサーバでのリクエスト受信時の設定

(2)　リダイレクタでのリクエスト送信時の設定

(3)　Webコンテナでのリクエスト受信時の設定

(1)　Webサーバでのリクエスト受信時の設定

クライアントからのリクエストをWebサーバで受信するときの通信タイムアウトは，Webサーバに設定します。Webサーバには，Hitachi Web ServerまたはMicrosoft IISのどちらかを使用できます。

(a)　設定方法

クライアントから転送されたリクエストの受信処理の通信タイムアウトを，次のファイルに設定してください。

httpsd.conf（Hitachi Web Serverの場合）
Timeoutディレクティブに，クライアントからのリクエスト受信処理の待ち時間（秒）を設定します。Timeoutディレクティブのデフォルト値は300秒です。なお，ここに設定する値は，クライアントへのデータ送信処理に対する通信タイムアウトと共用です。クライアントへのデータ送信処理に対する通信タイムアウトについては，「18.3.2(3)　Webサーバでのレスポンス送信時の設定」を参照してください。

isapi_redirect.conf（Microsoft IISの場合）
receive_client_timeoutキーに，クライアントからのリクエスト受信処理の待ち時間（秒）を設定します。

(b)　設定時の注意

Webサーバでのリクエスト受信時に設定するタイムアウト値については，クライアント－Webサーバ間のネットワーク構成，およびトラフィックの状態を考慮し，障害が発生したと判断できる時間を設定してください。

(2)　リダイレクタでのリクエスト送信時の設定

リダイレクタからWebコンテナにリクエストを送信するときには，Webコンテナとのコネクションを確立してからリクエストを送信します。リダイレクタからWebコンテナにリクエストを送信するときの通信タイムアウトは，コネクション確立時，およびリクエスト送信時に設定できます。また，コネクションの確立およびリクエストヘッダの送信に失敗した場合のリトライ回数を設定できます。

(a)　設定方法

リダイレクタからの，コネクション確立およびリクエスト送信処理の通信タイムアウトおよびリトライ回数を，次のファイルに設定してください。

mod_jk.conf（Hitachi Web Serverの場合）

コネクション確立の通信タイムアウト
JkConnectTimeoutキーに，Webコンテナへのコネクション確立処理の待ち時間（秒）を設定します。JkConnectTimeoutキーのデフォルト値は30秒です。

リクエスト送信処理のタイムアウト
JkSendTimeoutキーに，Webコンテナへのリクエスト送信処理の待ち時間（秒）を設定します。JkSendTimeoutキーのデフォルト値は100秒です。

コネクション確立およびリクエスト送信のリトライ回数
JkRequestRetryCountキーに，Webコンテナへのコネクション確立およびリクエスト送信のリトライ回数を設定します。JkRequestRetryCountキーのデフォルト値は3回です。

isapi_redirect.conf（Microsoft IISの場合）

コネクション確立処理の通信タイムアウト
connect_timeoutキーに，Webコンテナへのコネクション確立処理の待ち時間（秒）を設定します。connect_timeoutキーのデフォルト値は30秒です。

リクエスト送信処理のタイムアウト
send_timeoutキーに，Webコンテナへのリクエスト送信処理の待ち時間（秒）を設定します。send_timeoutキーのデフォルト値は100秒です。

コネクション確立およびリクエスト送信のリトライ回数
request_retry_countキーに，Webコンテナへのコネクション確立およびリクエスト送信のリトライ回数を設定します。request_retry_countキーのデフォルト値は3回です。

(b)　設定時の注意

リダイレクタでのリクエスト送信時に設定する通信タイムアウト値，およびリトライ回数については，次の点に考慮して設定してください。

リトライ回数には，初回のコネクション確立およびリクエスト送信が含まれます。このため，初回のコネクション確立またはリクエスト送信処理で失敗した場合，コネクション確立またはリクエスト送信処理のリトライは，2回目としてカウントされます。

コネクション確立およびリクエスト送信処理の通信タイムアウト時間に0を指定した場合，またはTCPが持つコネクション確立およびデータ送信の再送タイマより長い時間を設定した場合は，通信タイムアウト時間はTCPの持つタイムアウト時間が適用されます。

(3)　Webコンテナでのリクエスト受信時の設定

リダイレクタからのリクエストをWebコンテナで受信するときの通信タイムアウトは，Webコンテナに設定します。

(a)　設定方法

リダイレクタから転送されたリクエストの受信処理の通信タイムアウトを，次のファイルに設定してください。

usrconf.properties
webserver.connector.ajp13.receive_timeoutキーに，リダイレクタからのリクエスト受信処理の待ち時間（秒）を設定します。

(b)　設定時の注意

Webコンテナでのリクエスト受信時に設定するタイムアウト値については，次の点に考慮して設定してください。

Webサーバのリクエスト受信時のタイムアウトに設定した時間より，大きい値を設定してください。
Webサーバのリクエスト受信時のタイムアウトに設定した時間より，小さい値を設定しているときに，クライアントや，クライアント－Webサーバ間でネットワーク障害が発生すると，Webサーバより先にWebコンテナでタイムアウトが発生してしまいます。この場合，障害が発生したのが，Webサーバ側であるのか，クライアント側であるのかが判別できなくなります。

クライアントからのデータ受信が必要な場合，クライアントとの通信速度を考慮して，データ受信ができる時間を設定してください。

リダイレクタでのWebコンテナへのデータの送信時に障害が発生した場合，TCPの再送タイマでのタイムアウトによって障害が検知されます。
なお，UNIXの場合，タイムアウトまでの時間は，OSによって異なります。

18.3.2　レスポンス送受信時の通信タイムアウトの設定

レスポンス送受信時の通信タイムアウトは，Webコンテナ－リダイレクタ間，Webサーバ－クライアント間に設定します。レスポンス送受信時の通信タイムアウトの設定場所について，次の図に示します。

図18-5　レスポンス送受信時の通信タイムアウトの設定場所

図について説明します。なお，図中の番号と説明の番号は対応しています。

Webコンテナでのレスポンス送信時（Webコンテナ－リダイレクタ）
Webコンテナでのレスポンス送信時にタイムアウトを設定します。

リダイレクタでのレスポンス受信時（Webコンテナ－リダイレクタ）
リダイレクタでのレスポンス受信時に，タイムアウトを設定します。

Webサーバでのレスポンス送信時（Webサーバ－クライアント）
Webサーバでのレスポンス送信時に，タイムアウトを設定します。

それぞれの場合での通信タイムアウトの設定方法について説明します。

＜この項の構成＞

(1)　Webコンテナでのレスポンス送信時の設定

(2)　リダイレクタでのレスポンス受信時の設定

(3)　Webサーバでのレスポンス送信時の設定

(1)　Webコンテナでのレスポンス送信時の設定

Webコンテナからリダイレクタにレスポンス送信処理するときの通信タイムアウトは，Webコンテナに設定します。Webコンテナからのレスポンス送信時の待ち時間は，次のファイルに，を設定してください。

usrconf.properties
webserver.connector.ajp13.send_timeoutキーに，Webコンテナからのレスポンス送信時のタイムアウト時間（秒）を設定します。デフォルト値は600秒です。

(2)　リダイレクタでのレスポンス受信時の設定

Webコンテナからのレスポンスを受信するときの通信タイムアウトをリダイレクタに設定します。

(a)　設定方法

次のファイルに，Webコンテナからのレスポンス待ち時間を設定してください。

workers.properties
worker.<ワーカ名>.receive_timeoutキーに，ワーカごとのレスポンス待ち時間（秒）を設定します。J2EEアプリケーション単位で通信タイムアウトを設定したい場合は，J2EEアプリケーションごとにワーカを定義してマッピングしてください。

(b)　設定時の注意

リダイレクタでのレスポンス受信時のタイムアウトでは，Webアプリケーションの障害を検知できます。そのため，運用状況によっては，Webアプリケーションの処理に必要となる時間を考慮して，障害検知と判断できる値を通信タイムアウトに設定する必要があります。

リダイレクタでのレスポンス受信時に設定するタイムアウト値については，次の点に考慮して設定してください。

通信タイムアウトには，Webアプリケーションの処理に必要な時間より長い時間を設定してください。
設定したタイムアウトの時間が，Webアプリケーションの処理時間より短い場合，Webアプリケーションは正常に処理されていても，リダイレクタ側ではタイムアウトが発生したと判断して，クライアントにエラーが返されます。

Webコンテナのピーク時の，同時実行スレッド数の制御による待ち時間を考慮してください。
同時実行スレッド数の制御によって，Webコンテナのピーク時には，処理待ちリクエストの発生が考えられます。このため，サーバ管理コマンドを使用して同時実行スレッド数の制御を設定している場合，リクエストの処理時間が延長されることも考慮して，通信タイムアウトを設定しておく必要があります。サーバ管理コマンドでの同時実行スレッド数の制御の設定については，「4.4　同時実行スレッド数の制御の設定」を参照してください。

Webコンテナでのリダイレクタへのデータの送信時に障害が発生した場合，TCPの再送タイマでのタイムアウトによって障害が検知されます。
なお，UNIXの場合，タイムアウトまでの時間は，OSによって異なります。

(3)　Webサーバでのレスポンス送信時の設定

クライアントにレスポンスを送信するときの通信タイムアウトをWebサーバに設定できます。

(a)　設定方法

次のファイルに，クライアントからのレスポンス待ち時間を設定してください。

httpsd.conf（Hitachi Web Serverの場合）
Timeoutディレクティブに通信タイムアウトを設定してください。なお，Timeoutディレクティブで指定する通信タイムアウトは，リクエスト受信処理に対する通信タイムアウトおよびレスポンス送信処理に対する通信タイムアウトの両方の時間として指定します。このため，リクエスト受信処理の通信タイムアウトとレスポンス送信処理の通信タイムアウトで異なる時間を設定することはできません。
クライアントからのリクエスト受信処理に対する通信タイムアウトについては，「18.3.1(1)　Webサーバでのリクエスト受信時の設定」を参照してください。

MinFileBytesPerSecプロパティ（Microsoft IISの場合）
MinFileBytesPerSecプロパティに通信タイムアウトを設定してください。MinFileBytesPerSecプロパティには，Webサーバからクライアントへ送信するレスポンスデータのスループット（バイト/秒）を指定します。レスポンスデータのスループットがMinFileBytesPerSecに設定した値を下回った場合に，通信タイムアウトが発生します。なお，通信タイムアウトのデフォルトは240バイト/秒です。
設定の詳細については，Microsoft IISのマニュアルを参照してください。

(b)　設定時の注意

Webサーバでのレスポンス送信時に設定するタイムアウト値については，クライアント－Webサーバ間のネットワーク構成，およびトラフィックの状態を考慮し，クライアントとデータの送受信をするのに十分な時間を設定してください。

また，Webサーバでのレスポンス送信時のタイムアウトは，Webコンテナでのレスポンス送信時のタイムアウト値よりも小さな値を設定してください。Webサーバでのレスポンス送信時のタイムアウトを，Webコンテナでのレスポンス送受信時のタイムアウト値よりも大きな値を設定しているときに，クライアント－Webサーバ間で障害が発生すると，Webサーバでのクライアントへのレスポンス送信のタイムアウトよりも先に，Webコンテナでのリダイレクタへのレスポンス送信でタイムアウトが発生するおそれがあります。この場合，障害が発生したのが，クライアント－Webサーバ間か，リダイレクタ－Webコンテナ間か判別できなくなります。

18.4　エラーページのカスタマイズの設定

この節では，エラーページのカスタマイズの設定について説明します。

エラーが発生したときに，エラーステータスコードが表示されたエラーページの代わりにユーザが作成したエラーページを表示させるためには，ユーザが作成したエラーページを特定のエラーステータスコードと対応づけます。該当するエラーステータスコードのエラーが発生した場合には，Hitachi Web Serverに設定された情報を基に，エラーステータスコードに対応したエラーページをクライアントに送信します。機能の詳細については，マニュアル「Cosminexus　機能解説」のエラーページのカスタマイズに関する説明を参照してください。

なお，エラーページのカスタマイズは，WebサーバがHitachi Web Serverの場合だけ使用できます。Microsoft IISでは使用できません。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(3)　注意事項

(1)　設定方法

エラーステータスコードとエラーページとの対応づけは，次のファイルで定義します。

workers.properties
worker.<ワーカ名>.delegate_error_codeキーに，エラーページに対応づけたい，エラーステータスコードを設定します。

httpsd.conf
ErrorDocumentディレクティブで，エラーステータスコードと，対応するエラーページのファイル名を対応づけます。

workers.properties設定時の注意事項

エラーステータスコードは，ワーカ単位で指定します。

エラーステータスコードを指定できるワーカのタイプは，「ajp13」だけです。ワーカのタイプが「lb」（ラウンドロビンに基づく負荷分散をするときの設定）の場合，指定した内容は無視されます。

指定できるエラーステータスコードは，次の表のとおりです。これ以外のエラーステータスコードにエラーページを対応づけることはできません。

表18-2　エラーページと対応づけできるエラーステータスコード

エラーステータスコード | 説明句
400 | Bad Request
401 | Unauthorized
402 | Payment Required
403 | Forbidden
404 | Not Found
405 | Method Not Allowed
406 | Not Acceptable
407 | Proxy Authentication Required
408 | Request Time-out
409 | Conflict
410 | Gone
411 | Length Required
412 | Precondition Failed
413 | Request Entity Too Large
414 | Request-URI Too Long
415 | Unsupported Media Type
416 | Requested Range Not Satisfiable
417 | Expectation Failed
422 | Unprocessible Entity
423 | Locked
424 | Failed Dependency
500 | Internal Server Error
501 | Not Implemented
502 | Bad Gateway
503 | Service Unavailable
504 | Gateway Time-out
505 | HTTP Version not supported
507 | Insufficient Storage
510 | Not Extended

ErrorDocumentディレクティブ指定時の注意事項

ErrorDocumentディレクティブにローカルURLを使用する場合には，リダイレクタがWebコンテナに転送しないURLを指定する必要があります。

ルートコンテキストの使用時など，リダイレクタの設定で「/*」というURLパターンをワーカにマッピングしている場合，すべてのリクエストがWebコンテナに転送されます。そのため，ErrorDocumentディレクティブには，Webコンテナ上のリソースを，完全URLを使用して設定してください。
ルートコンテキストを使用する場合で，エラーステータスコード404発生時に，Webコンテナ上のルートコンテキスト配下のerror404.jspを表示させるための設定例を次に示します。hostAは，Webサーバ稼働ホストです。

ErrorDocument 404 http://hostA/error404.jsp

また，このときWebコンテナが停止している場合には，リダイレクタはエラーステータスコード500のエラーを返します。このため，Webコンテナが停止している際のエラーページをカスタマイズするには，ErrorDocumentディレクティブで，エラーステータスコード500に対して別のWebサーバのリソースを，完全URLで指定する必要があります。

(2)　設定例

エラーページのカスタマイズの例を次に示します。

workers.propertiesの例

# ワーカ定義ファイルの記述
worker.list=worker1

worker.worker1.type=ajp13
worker.worker1.host=host1
worker.worker1.port=8007
worker.worker1.delegate_error_code=404

worker.<ワーカ名>.delegate_error_codeキーに，エラーステータスコード「404（Not Found）」を定義しています。

httpsd.confの例

# httpsd.confの記述#
#　　　　　：
ErrorDocument 404 /missing.html

エラーステータスコードと，対応するエラーページのファイル名を対応づけます。エラーステータスコード「404（Not Found）」のエラーが発生した場合に，missing.htmlファイルを表示するようになります。

ErrorDocumentディレクティブの詳細については，マニュアル「Hitachi Web Server」を参照してください。

(3)　注意事項

Microsoft IISを使用している場合に，workers.propertiesにこの機能の設定をしても無視されます。

Servlet 2.3仕様に対応したWebアプリケーションでは，サーブレットの仕様で規定されているweb.xmlの<error-page>タグによるカスタムエラー機能を使用している場合，Webコンテナは<error-page>タグに記述されているページへのアクセス結果をステータスコードとして返却します。このため，<error-page>タグに記述されているページへのアクセスでエラーが発生しない場合には，この機能は動作しません。

エラーページの生成を委任するエラーステータスコードがworkers.propertiesだけに定義されている（httpsd.confのErrorDocumentディレクティブを定義していない）場合，そのエラーステータスコードのエラーが発生したときに返却されるエラーページは，Hitachi Web Serverが自動生成したページになります。

18.5　ドメイン名指定でトップページを表示するための設定

この節では，ドメイン名指定でトップページを表示するための設定について説明します。

デプロイしたWebアプリケーションにアクセスするとき，URLにドメイン名を指定するだけで，index.htmlやindex.jspなどの，Webアプリケーションのトップページを表示させることができます。なお，機能の詳細については，マニュアル「Cosminexus　機能解説」のドメイン名指定でのトップページの表示に関する説明を参照してください。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(1)　設定方法

ドメイン名指定でトップページを表示するための設定方法を次に示します。

ルートコンテキストを設定します。
ルートコンテキストとは，コンテキストルートに名称が指定されていないコンテキストのことです。ルートコンテキストの指定は，動作モードによって異なります。
サーバ管理コマンドを使用してJ2EEアプリケーションのプロパティを定義するときにルートコンテキストを指定します。コンテキストルートとしてルートコンテキストを設定する場合は，空文字を指定します。J2EEアプリケーションのコンテキストルート定義については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リダイレクタで，ルートコンテキストへのリクエストの振り分けを設定します。
ルートコンテキストへのリクエストの振り分けは，WebサーバにHitachi Web Serverを使用している場合はmod_jk.confに，Microsoft IISを使用している場合はisapi_redirect.confに指定します。

(2)　設定例

ルートコンテキストへのリクエストの振り分けの設定例について説明します。

URLにドメイン名を指定するだけで，Webアプリケーションのトップページを表示させるためには，リダイレクタのURLマッピング定義で，ルートコンテキストにリクエストが振り分けられるように設定してください。例えば，ルートコンテキストは「worker1」に，「/examples」はworker2に振り分ける場合には，次のように指定します。

mod_jk.confの例（Hitachi Web Serverの場合）

JkMount /* worker1
JkMount /examples/* worker2

uriworkermap.propertiesの例（Microsoft IISの場合）

/*=worker1
/examples/*=worker2

18.6　Webコンテナにゲートウェイ情報を通知するための設定

この節では，ゲートウェイ指定機能を使用するための設定について説明します。

クライアントとWebサーバとの間に，SSLアクセラレータや負荷分散機などのゲートウェイを配置している場合，ゲートウェイ指定機能を使用することで，Webコンテナにゲートウェイ情報を通知し，WebアプリケーションのトップページやForm認証画面に正しくリダイレクトできるようになります。なお，機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナへのゲートウェイ情報の通知に関する説明を参照してください。

＜この節の構成＞

(1)　設定方法

(2)　設定例

(1)　設定方法

ゲートウェイ指定機能を使用するための設定方法を次に示します。

ゲートウェイのホスト名・ポート番号・リダイレクト先URLのスキームを，リダイレクタごとに指定します。

Webサーバを再起動します。

なお，ゲートウェイのホスト名・ポート番号・リダイレクト先URLのスキームは，WebサーバにHitachi Web Serverを使用している場合はmod_jk.confに，Microsoft IISを使用している場合はisapi_redirect.confに指定します。指定するキーはそれぞれ次のとおりです。

mod_jk.confの場合
ホスト名：JkGatewayHostキー
ポート番号：JkGatewayPortキー
リダイレクト先URLのスキーム：JkGatewayHttpsSchemeキー

isapi_redirect.confの場合
ホスト名：gateway_hostキー
ポート番号：gateway_portキー
リダイレクト先URLのスキーム：gateway_https_schemeキー

(2)　設定例

ゲートウェイ指定機能の設定例を次に示します。

図18-6　ゲートウェイ指定機能の設定例

この例では，クライアントとWebサーバの間にSSLアクセラレータを配置しています。クライアントからSSLアクセラレータへのアクセスがHTTPSの場合でも，SSLアクセラレータからWebサーバへのアクセスはHTTPとなるため，WebコンテナはHTTPによるアクセスであると認識します。このため，WebアプリケーションのトップページやForm認証画面へのリダイレクト先URLのスキームはHTTPとなります。この場合，ゲートウェイ指定機能を使用して，スキームを常にHTTPSとみなすように指定することで，正しくリダイレクトできるようになります。

mod_jk.conf，およびisapi_redirect.confの例を次に示します。ここでは，リダイレクト先URLのスキームを常にHTTPSとみなすようにmod_jk.confのJkGatewayHttpsSchemeキーで「On」，isapi_redirect.confのgateway_https_schemeキーで「true」を指定します。

mod_jk.confの例（Hitachi Web Serverの場合）

JkGatewayHost host1

JkGatewayPort 4443

JkGatewayHttpsScheme On

isapi_redirect.confの例（Microsoft IISの場合）

gateway_host=host1

gateway_port=4443

gateway_https_scheme=true

18.7　リダイレクタのログ取得の設定

この節では，リダイレクタの出力するログの出力先やログ出力レベルなどの変更について説明します。なお，ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

リダイレクタが出力するログは，メッセージログと保守用トレースログの二つに分けて出力されます。メッセージログには，障害発生時のログなどのメッセージが出力されます。保守用トレースログには，HTTPリクエストを受信し，レスポンスを送信するまでのトレース情報が出力されます。

保守用トレースログのログサイズは，見積もりの計算式に従い，障害発生時から障害を検知しログを収集するまで保持されるサイズにカスタマイズすることをお勧めします。

注意事項

ログファイル初期化処理の開始時および終了時には，メッセージログにそれぞれKDJE41029-I，KDJE41030-Iのメッセージが出力されます。Webサーバの起動時には，ログファイル初期化処理が正常に終了したことを確認するため，メッセージログにKDJE41029-I，KDJE41030-Iのメッセージが出力されていることを確認してください。

UNIXの場合，mod_jk.confファイルに設定されたファイルサイズ，およびファイル面数のログファイルは，Webサーバとの連携の設定後の初回起動時に作成されます。ログファイルの作成は，ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合，またはファイル面数を増やした場合などは，ログファイルの作成処理に数分掛かる場合があります。

＜この節の構成＞

(1)　Hitachi Web Serverの場合

(2)　Microsoft IISの場合

(1)　Hitachi Web Serverの場合

Hitachi Web Serverを使用している場合は，mod_jk.confファイルでリダイレクタのログ取得の設定を変更できます。なお，UNIXの場合，設定を変更できるのは，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）を持つユーザです。

(a)　変更した設定を有効にする方法

変更した設定を有効にする方法について，OSごとに説明します。

Windowsの場合

変更したリダイレクタのログ取得の設定を有効にするには，Hitachi Web Serverを再起動してください。

UNIXの場合

変更したリダイレクタのログ取得の設定を有効にする方法は，ファイルサイズまたはファイル面数の変更の有無によって異なります。

ファイルサイズまたはファイル面数を変更する場合

ファイルサイズまたはファイル面数を変更する場合に，変更したリダイレクタのログ取得の設定を有効にする方法を次に示します。

Hitachi Web Serverを停止します。

ログファイルおよび管理ファイルを移動または削除します。
メッセージログファイルの場合：メッセージログファイルおよびHNTRLibが使用する管理ファイル（<JkLogFilePrefixの設定値>.mm）を移動，または削除します。
保守用トレースログファイルの場合：保守用トレースログファイルおよびHNTRLibが使用する管理ファイル（<JkTrcaeLogFilePrefixの設定値>.mm）を移動，または削除します。

Hitachi Web Serverを再起動します。

ファイルサイズまたはファイル面数を変更しない場合

ファイルサイズまたはファイル面数を変更しない場合は，Hitachi Web Serverを再起動してください。

(b)　変更できる設定項目

変更できる設定項目と，項目に対応するユーザ定義ファイルとキーを次の表に示します。

表18-3　Hitachi Web Serverでのリダイレクタのログ取得の設定項目（ファイル編集とコマンド実行でのシステム構築）

項目 | mod_jk.confのキー
メッセージログ，保守用トレースログのログ出力レベル | JkLogLevel
メッセージログ出力先 | JkLogFileDir
メッセージログファイルサイズ | JkLogFileSize
メッセージログファイル面数 | JkLogFileNum
メッセージログファイル名のプリフィックス | JkLogFilePrefix
保守用トレースログ出力の有無 | JkTraceLog
保守用トレースログ出力先 | JkTraceLogFileDir※
保守用トレースログファイルサイズ | JkTraceLogFileSize
保守用トレースログファイル面数 | JkTraceLogFileNum
保守用トレースログファイル名のプリフィックス | JkTrcaeLogFilePrefix※

注※　保守用トレースログの出力先とプリフィックスには，同じ値を指定しないでください。同じ値を指定した場合は，リダイレクタが動作しません。

メッセージログ，および保守用トレースログのデフォルトの出力先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs※

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

注※　新規インストール時には，logsディレクトリは存在しません。logsディレクトリは，Hitachi Web Serverの起動時に生成されます。

ログレベルのレベル名

ログレベルのレベル名には，重要度の高い順に「emerg」※，「error」，「info」，「debug」のどれかを指定できます。

emerg：通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。※

error：通常運用時に指定します。

info：テスト時に指定します。

debug：障害調査時に指定します。

ログレベルは，単独で指定してください（コンマ区切りで複数のログレベルを指定しないでください）。あるログレベルを指定すると，指定されたログレベルおよびそれよりも重要度の高いログが出力されます。

注※　Windowsの場合に指定できます。

ログサイズの見積もりの計算式

GETリクエスト，POSTリクエストの1HTTPアクセス当たりのログサイズは，次の計算式で見積もってください。

GETによる1HTTPアクセス当たりのログサイズ
= 1.75 +（平均レスポンスボディサイズ / 16）* 0.25

POSTによる1HTTPアクセス当たりのログサイズ
= 2.00 +（平均POSTデータサイズ / 16）* 0.5 +（平均レスポンスボディサイズ / 16）* 0.25

なお，単位はすべてキロバイト，除算結果の小数点以下の値はすべて切り捨てです。また，計算式ではリクエストURLとクエリー文字列の平均サイズは，それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は，計算式の最初の値に，超える分のサイズを加えて計算してください。

(2)　Microsoft IISの場合

Microsoft IISを使用している場合は，isapi_redirect.confファイルでリダイレクタのログ取得の設定を変更できます。

注意事項

isapi_redirect.confファイルに設定されたファイルサイズ，およびファイル面数のログファイルは，Webサーバとの連携の設定後の初回リクエスト時に作成されます。ログファイルの作成は，ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合，またはファイル面数を増やした場合などは，ログファイルの作成処理に数分掛かる場合があります。

Webサーバとの連携の設定後およびログファイルの設定変更後の初回リクエストは，運用を開始する前に実施しておくことをお勧めします。

(a)　変更した設定を有効にする方法

ファイルサイズまたはファイル面数を変更する場合に，変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

Microsoft IISを停止します。

ログファイルおよび管理ファイルを移動または削除します。
メッセージログファイルの場合：メッセージログファイルおよびHNTRLibが使用する管理ファイル（<log_file_prefixの設定値>.mm）を移動，または削除します。
保守用トレースログファイルの場合：保守用トレースログファイルおよびHNTRLibが使用する管理ファイル（< trace_log_file_prefixの設定値>.mm）を移動，または削除します。

Microsoft IISを起動します。

ファイルサイズおよびファイル面数を変更しない場合に，変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

Microsoft IISを再起動するか，またはワーカプロセスのリサイクルを行います。
Microsoft IISの「インフォメーション サービス マネージャ」を使用して，ワーカプロセスのリサイクルができます。

(b)　変更できる設定項目

変更できる設定項目と，項目に対応するユーザ定義ファイルとキーを次の表に示します。isapi_redirect.confについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表18-4　Microsoft IISでのリダイレクタのログ取得の設定項目

項目 | isapi_redirect.confのキー
メッセージログ，保守用トレースログのログ出力レベル | log_level
メッセージログ出力先 | log_file_dir
メッセージログファイルサイズ | log_file_size
メッセージログファイル面数 | log_file_num
メッセージログファイル名のプリフィックス | log_file_prefix
保守用トレースログ出力の有無 | trace_log
保守用トレースログ出力先 | trace_log_file_dir※
保守用トレースログファイルサイズ | trace_log_file_size
保守用トレースログファイル面数 | trace_log_file_num
保守用トレースログファイル名のプリフィックス | trace_log_file_prefix※

注※　保守用トレースログの出力先とプリフィックスには，同じ値を指定しないでください。同じ値を指定した場合は，リダイレクタが動作しません。

メッセージログ，および保守用トレースログのデフォルトの出力先

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs※

注※　新規インストール時には，logsディレクトリは存在しません。logsディレクトリは，初回リクエスト時に生成されます。

ログレベルのレベル名

ログレベルのレベル名には，重要度の高い順に「emerg」，「error」，「info」，「debug」のどれかを指定できます。

emerg：通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。

error：通常運用時に指定します。

info：テスト時に指定します。

debug：障害調査時に指定します。

ログレベルは，単独で指定してください（コンマ区切りで複数のログレベルを指定しないでください）。あるログレベルを指定すると，指定されたログレベルおよびそれよりも重要度の高いログが出力されます。

ログサイズの見積もりの計算式

GETリクエスト，POSTリクエストの1HTTPアクセス当たりのログサイズは，次の計算式で見積もってください。

GETによる1HTTPアクセス当たりのログサイズ
= 2.25 +（平均レスポンスボディサイズ / 16）* 0.25

POSTによる1HTTPアクセス当たりのログサイズ
= 2.50 +（平均POSTデータサイズ / 16）* 0.5 +（平均レスポンスボディサイズ / 16）* 0.25

なお，単位はすべてキロバイト，除算結果の小数点以下の値はすべて切り捨てです。また，計算式ではリクエストURLとクエリー文字列の平均サイズは，それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は，計算式の最初の値に，超える分のサイズを加えて計算してください。

18.8　Hitachi Web Serverを使用するための設定

この節では，Hitachi Web Serverを使用してWebサーバと連携する場合の設定について説明します。

Hitachi Web Serverの設定

アップグレード時のHitachi Web Serverの設定

Hitachi Web ServerのSSLの設定

＜この節の構成＞

18.8.1　Hitachi Web Serverの設定

18.8.2　アップグレード時のHitachi Web Serverの設定

18.8.3　Hitachi Web ServerのSSLの設定

18.8.1　Hitachi Web Serverの設定

J2EEサーバとHitachi Web Serverとの連携に必要な，Hitachi Web Serverの設定方法，注意事項などを説明します。

＜この項の構成＞

(1)　設定方法

(2)　認証実施順序

(3)　注意事項

(1)　設定方法

J2EEサーバとHitachi Web Serverとの連携は，次に示す手順で設定します。

httpsd.conf（Hitachi Web Server定義ファイル）に次の行を追加します。

Windowsの場合
Include "<Cosminexusのインストールディレクトリ>/CC/web/redirector/mod_jk.conf"

UNIXの場合
Include /opt/Cosminexus/CC/web/redirector/mod_jk.conf

Hitachi Web Serverを再起動します。

httpsd.confの詳細，および再起動の方法については，マニュアル「Hitachi Web Server」を参照してください。

(2)　認証実施順序

Webコンテナが提供する認証機能とWebサーバの認証機能※を併用した場合，次の順序で認証が実施されます。

Webサーバでの認証

Webコンテナでの認証

注※

Webサーバの認証機能とは，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証を指します。Web認証機能の併用とは，Webコンテナが提供する認証機能を使用している場合に，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証のどれか一つ以上を使用しているときを指します。

認証機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナのセキュリティ管理に関する説明を参照してください。また，Hitachi Web Serverのユーザ認証機能，およびアクセス制御機能については，マニュアル「Hitachi Web Server」を参照してください。

(3)　注意事項

●Hitachi Web Serverの再起動時の注意事項

Hitachi Web Serverの再起動に失敗した原因がmod_jk.conf（リダイレクタ定義ファイル），またはworkers.properties（ワーカ定義ファイル）にある場合，次のどちらかにメッセージが出力されます。

Hitachi Web Serverの起動コマンド実行画面またはイベントログ

Hitachi Web Serverをコマンドプロンプトから起動，停止，または再起動するときは，起動コマンド実行画面に出力されます。

Hitachi Web Serverをサービスから起動，停止，または再起動するときは，イベントログに出力されます。Windowsの場合だけが該当します。

Hitachi Web Serverのエラーログファイル
エラーログファイルは，デフォルトでは次の場所に出力されます。

Windowsの場合
<Hitachi Web Serverのインストールディレクトリ>¥logs¥error.log

UNIXの場合
opt/hitachi/httpsd/logs/error.log

それぞれに出力されるメッセージを表に示します。

表18-5　Hitachi Web Serverの起動コマンド実行画面またはイベントログに出力されるメッセージ

メッセージ
原因・対策方法

JkWorkersFile file_name invalid※
JkWorkersFileキーに指定されたファイル名が無効です。JkWorkersFileキーに指定している値を修正したあと，Webサーバを再起動してください。

Can't find the workers file specified※
指定されたワーカ定義ファイルが見つかりません。JkWorkersFileキーに指定されているファイルの有無を確認したあと，Webサーバを再起動してください。

Content should start with /※
URLパターンの先頭文字が「/」（スラッシュ）以外です。JkMountキーに指定されているURLパターンの先頭文字を「/」（スラッシュ）に修正したあと，Webサーバを再起動してください。

JkOptions: Illegal option 'a...a'
JkOptionキーに指定された値（a...a）は不正です。
JkOptionキーに指定している値を修正したあと，Webサーバを再起動してください。

a...a takes b...b arguments,
a...aに示すキーに指定できる値の数はb...bです。
a...aに示すキーに指定している値の数を修正したあと，Webサーバを再起動してください。

a...a must be On or Off
a...aに示すキーに指定できる値はOnまたはOffです。
a...aに示すキーに指定している値をOnまたはOffにしたあと，Webサーバを再起動してください。

JkModulePriority: Invalid value specified.a...a
JkModulePriorityキーに設定された値a...aが不正です。JkModulePriorityキーに正しい値を設定して，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

表18-6　Hitachi Web Serverのエラーログファイル

メッセージ
説明・対策方法

[時刻] [emerg] Memory error
メモリが不足しています。
システムが利用できるメモリ使用量を確保したあと，Webサーバを再起動してください。

[時刻] [emerg] Error while opening the workers※
次のどちらかの問題が発生しています。

ワーカ定義ファイルのオープンに失敗しました。
JkWorkersFileキーに指定されているファイルのアクセス権に読み取り権限があることを確認したあと，Webサーバを再起動してください。

ワーカ定義ファイルの内容が不正です。
ワーカ定義ファイルの内容を正しく修正したあと，Webサーバを再起動してください。

[時刻] [emerg] Error while checking the mod_jk.conf※
リダイレクタ定義ファイルに不適切な記述がありました。リダイレクタに出力されているメッセージを確認したあと，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

●リダイレクタのログに関する注意事項

ログ出力先ディレクトリにHitachi Web Serverの実行アカウントの書き込み権限がない場合，リクエストは正常に処理されますが，ログは出力されません。

Windowsの場合，デフォルトの状態ではリダイレクタのログ出力先ディレクトリ（<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs）がありません。このため，Hitachi Web Serverは，起動時に一つ上のディレクトリ（redirectorディレクトリ）のアクセス権を引き継いで，logsディレクトリを生成してログを出力しようとします。このとき，Hitachi Web Serverの実行アカウントの書き込み権限がないとログは出力されません。この場合は，logsディレクトリを生成してアクセス権を設定するか，または一つ上のディレクトリ（redirectorディレクトリ）にアクセス権を設定してください。
また，リダイレクタのログ出力先ディレクトリを変更している場合に，指定しているパスが途中までしかないときは，存在する最下層のディレクトリに対してアクセス権を設定するか，または指定したパスに対応するディレクトリをすべて作成して，最下層のディレクトリにアクセス権を設定してください。

18.8.2　アップグレード時のHitachi Web Serverの設定

Hitachi Web Serverをアップグレードした場合，Hitachi Web Server用のリダイレクタの変更内容を反映するためには，Hitachi Web Serverを再起動する必要があります。Hitachi Web Serverの再起動の方法については，マニュアル「Hitachi Web Server」を参照してください。

18.8.3　Hitachi Web ServerのSSLの設定

Hitachi Web Serverを使用してSSLによる認証やデータの暗号化をする場合，秘密鍵の作成，認証局（CA）が発行した証明書の取得，およびhttpsd.conf（Hitachi Web Server定義ファイル）の設定が必要です。

また，クライアント認証をする場合，クライアント証明書と認証局（CA）の証明書の取得，およびhttpsd.conf（Hitachi Web Server定義ファイル）の設定が必要です。

ここでは，Hitachi Web ServerのSSLによる認証，暗号化の設定，およびクライアント認証の設定について説明します。なお，詳細については，マニュアル「Hitachi Web Server」を参照してください。

＜この項の構成＞

(1)　Hitachi Web ServerのSSLによる認証，暗号化の設定

(2)　クライアント認証の設定

(1)　Hitachi Web ServerのSSLによる認証，暗号化の設定

Hitachi Web Serverを使用してSSLによる認証やデータの暗号化をする場合，次の設定をしてください。

秘密鍵の作成と認証局が発行した証明書の取得

httpsd.confの設定

(a)　秘密鍵の作成と認証局が発行した証明書の取得

Hitachi Web Serverが用意しているsslcユティリティを使用し，次に示す手順に従って証明書発行局（CA）から証明書を取得します。なお，Hitachi Web Serverが提供するテスト用CAを利用する場合は，マニュアル「Hitachi Web Server」を参照してください。

秘密鍵の作成
sslc -genrsaコマンド（UNIXの場合，sslc genrsaコマンド）を使用して，Hitachi Web Server用の秘密鍵を作成します。

証明書発行要求（CSR）の作成
sslc -reqコマンド（UNIXの場合，sslc reqコマンド）を使用して，認証局（CA）に証明書を発行してもらうための証明書発行要求（CSR）を作成します。

認証局（CA）への証明書発行要求の送付
作成したCSRファイルを電子メールなどで認証局に送って証明書を取得してください。

(b)　httpsd.confの設定

httpsd.conf（Hitachi Web Server定義ファイル）に，次に示す設定を記述してください。

SSL通信用のポートの設定
ListenディレクティブにSSL通信で使用するポートを設定します。通常，SSL通信で使用するポート番号は443です。SSL通信で使用するポート番号を指定したListenディレクティブだけを定義した場合，そのサーバはブラウザからHTTPSのリクエスト（SSL通信）以外を受け付けなくなります。そのため，HTTPのリクエストも受け付ける場合には，HTTPのリクエスト用のポート番号（通常には80）を指定したListenディレクティブの指定は残した上で，SSL通信で使用するポート番号を指定したListenディレクティブを追加してください。

SSLを有効にする設定
SSLEnableディレクティブを指定します。

秘密鍵ファイルの設定
SSLCertificateKeyFileディレクティブに「(a)　秘密鍵の作成と認証局が発行した証明書の取得」で作成した秘密鍵ファイルへのパスを指定します。

認証局（CA）が発行した証明書ファイルの設定
SSLCertificateFileディレクティブに「(a)　秘密鍵の作成と認証局が発行した証明書の取得」で取得した証明書ファイルへのパスを指定します。

記述例

SSL通信に必要な設定をしたhttpsd.confの記述例を次に示します。なお，次の記述例は，ファイルの内容の一部となります。

Windowsの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
</VirtualHost>
Include "C:/Program Files/Hitachi/Cosminexus/CC/web/redirector/mod_jk.conf"

UNIXの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
</VirtualHost>
Include "/opt/Cosminexus/CC/web/redirector/mod_jk.conf"

(2)　クライアント認証の設定

クライアント認証をする場合，次の設定をしてください。

クライアント証明書と認証局（CA）の証明書の取得

httpsd.confの設定

(a)　クライアント証明書と認証局（CA）の証明書の取得

クライアント証明書の取得
証明書の発行に使用する認証局（CA）の指示に従って，Webブラウザにクライアント証明書をインストールします。

認証局（CA）の証明書の取得
クライアント証明書を発行した認証局（CA）の証明書（PEM形式）を入手します。

(b)　httpsd.confの設定

httpsd.conf（Hitachi Web Server定義ファイル）に，次に示す設定を記述してください。

認証局（CA）の証明書ファイルの設定
SSLCACertificateFileディレクティブに「(a)　クライアント証明書と認証局（CA）の証明書の取得」で取得した証明書ファイルへのパスを指定します。

クライアント認証についての設定
SSLVerifyClientおよびSSLVerifyDepthディレクティブを使用します。

クライアント証明書情報についての設定
SSLExportClientCertificatesおよびSSLExportCertChainDepthディレクティブを使用します。

記述例

クライアント認証に必要な設定をしたhttpsd.confの記述例を次に示します。なお，次の記述例は，ファイルの内容の一部となります。

Windowsの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "C:/Program Files/Hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
SSLCACertificateFile "C:/Program Files/Hitachi/httpsd/conf/ssl/cacert/cacert.pem"
SSLVerifyClient 2
SSLVerifyDepth 2
SSLExportClientCertificates
SSLExportCertChainDepth 2
</VirtualHost>

Include "C:/Program Files/Hitachi/Cosminexus/CC/web/redirector/mod_jk.conf"

UNIXの場合

ServerName localhost
Port 80
Listen 80

#--途中省略--
Listen 443
<VirtualHost host1:443>
SSLEnable
SSLCertificateFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdcert.pem"
SSLCertificateKeyFile "/opt/hitachi/httpsd/conf/ssl/server/httpsdkey.pem"
SSLCACertificateFile "/opt/hitachi/httpsd/conf/ssl/cacert/cacert.pem"
SSLVerifyClient 2
SSLVerifyDepth 2
SSLExportClientCertificates
SSLExportCertChainDepth 2
</VirtualHost>

Include "/opt/Cosminexus/CC/web/redirector/mod_jk.conf"

18.9　Microsoft IISを使用するための設定

この節では，Microsoft IISを使用してWebサーバと連携する場合の設定について説明します。

Microsoft IISの設定
Windows Server 2003（Microsoft IIS 6.0）の設定方法について説明します。

Microsoft IISのSSLの設定
Windows Server 2003（Microsoft IIS 6.0）のSSLの設定について説明します。

＜この節の構成＞

18.9.1　Microsoft IISの設定

18.9.2　Microsoft IISのSSLの設定方法

18.9.1　Microsoft IISの設定

Microsoft IISの設定方法について説明します。

J2EEサーバとMicrosoft IISとの連携は，次に示す手順で設定します。

仮想ディレクトリの作成

Webサーバの認証機能の解除

ISAPIフィルタの設定

Webサービス拡張の設定

WWWサービスの起動と動作確認

＜この項の構成＞

(1)　仮想ディレクトリの作成

(2)　Webサーバの認証機能の解除

(3)　ISAPIフィルタの設定

(4)　Webサービス拡張の設定

(5)　リダイレクタのログ出力先ディレクトリへのアクセス権の設定

(6)　WWWサービスの起動と動作確認

(7)　ほかのフィルタと共存させる場合の注意事項

(1)　仮想ディレクトリの作成

「hitachi_ccfj」という名称の仮想ディレクトリを作成します。仮想ディレクトリの作成の手順を次に示します。

［スタート］メニューの［すべてのプログラム］－［管理ツール］から，インターネット インフォメーション サービス（IIS）マネージャを起動します。

インターネット インフォメーション サービス（IIS）マネージャの左側ツリービューの「Webサイト」の下にある「既定のWebサイト」を右クリックし，表示されるメニューから［新規作成］－［仮想ディレクトリ］を選択します。

仮想ディレクトリの作成ウィザードダイアログが表示されたら，［次へ］ボタンをクリックします。
［仮想ディレクトリ エイリアス］画面が表示されます。

「エイリアス」欄に「hitachi_ccfj」と入力します。

［次へ］ボタンをクリックします。
ディレクトリの物理パスを入力する画面が表示されます。

isapi_redirect.dllが格納されているディレクトリ（デフォルトは，<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector）を指定します。

［次へ］ボタンをクリックします。
仮想ディレクトリのアクセス許可を設定する画面が表示されます。

「ISAPIアプリケーションやCGIなどを実行する」をチェックします。

［次へ］ボタンをクリックして終了します。

仮想ディレクトリ「hitachi_ccfj」を右クリックし，メニューから「プロパティ」を選択します。
プロパティダイアログが表示されます。

(2)　Webサーバの認証機能の解除

Webコンテナの認証機能を使用する場合，次に示すWebサーバの認証機能の解除が必要になります。

ダイジェスト認証
Webコンテナの認証機能の使用の有無に関係なく，必ず解除してください。

統合Windows認証
Webコンテナの認証機能（Basic認証）を使用する場合は解除してください。

Passport認証
Webコンテナが管理するリソースへアクセスする場合は解除してください。

ダイジェスト認証，統合Windows認証，およびPassport認証を解除する手順を次に示します。

「hitachi_ccfj」のプロパティダイアログで，［ディレクトリ セキュリティ］タブを選択します。

「認証とアクセス制御」の［編集］ボタンをクリックします。
［認証方法］画面が表示されます。

［認証方法］画面で，「Windowsドメインサーバーでダイジェスト認証を使用する」のチェックを外し，ダイジェスト認証を解除します（必須）。
Webコンテナの認証機能の使用の有無に関係なく，ダイジェスト認証は必ず解除してください。

［認証方法］画面で，「統合Windows認証」のチェックを外し，統合Windows認証を解除します（任意）。
WebコンテナのBasic認証を設定している場合は，必ず解除してください。

［認証方法］画面で，「.NET パスポート認証」のチェックを外し，Passport認証を解除します（任意）。
Webコンテナが管理するリソースへアクセスする場合は解除してください。

［OK］ボタンをクリックして各ウィンドウを閉じます。

(3)　ISAPIフィルタの設定

ISAPIフィルタの設定の手順を次に示します。

インターネット インフォメーション サービス（IIS）マネージャの左側ツリービュー内の「Webサイト」を右クリックし，表示されるメニューから「プロパティ」を選択します。

［Webサイトのプロパティ］画面が表示されたら，［ISAPIフィルタ］タブを選択します。

［追加］ボタンをクリックします。
［フィルタのプロパティの追加と編集］画面が表示されます。

フィルタ名に「hitachi_ccfj」，実行可能ファイルに「<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.dll」を指定します。

［OK］ボタンをクリックします。
［Webサイトのプロパティ］画面が表示されます。

ファイル名に「hitachi_ccfj」が登録されたのを確認して，［適用］ボタンをクリックします。

インターネット インフォメーション サービス（IIS）マネージャを終了します。

注意

ISAPIフィルタを追加すると，「hitachi_ccfj」の優先順位に「*不明*」と表示されますが，動作に問題はありません。初回リクエスト処理後に，isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）のfilter_priorityキーで指定した優先順位が表示されます。

(4)　Webサービス拡張の設定

Webサービス拡張の設定の手順を次に示します。

インターネット インフォメーション サービス（IIS）マネージャの左側ツリービュー内の［Webサービス拡張］を選択します。
右側のビューに，Webサービス拡張状態の一覧が表示されます。

Webサービス拡張状態の一覧から「すべての不明なISAPI拡張」を右クリックし，表示されるメニューから「許可」を選択します。

(5)　リダイレクタのログ出力先ディレクトリへのアクセス権の設定

Microsoft IISと連携する場合，リダイレクタの実行アカウントは「NetworkService」となります。このため，リダイレクタのログ出力先ディレクトリのアクセス権に，Usersグループに対する書き込み権限を付加しておく必要があります。エクスプローラから，リダイレクタのログ出力先ディレクトリにアクセス権を設定してください。

なお，新規インストール時には，デフォルトの状態ではリダイレクタのログ出力先ディレクトリ（<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs）がありません。このため，logsディレクトリを作成してアクセス権を設定するか，または一つ上のディレクトリ（redirectorディレクトリ）にアクセス権を設定してください。

また，リダイレクタのログ出力先ディレクトリを変更している場合に，指定しているパスが途中までしか存在しないときは，存在する最下層のディレクトリに対してアクセス権を設定するか，または指定したパスに対応するディレクトリをすべて作成して，最下層のディレクトリにアクセス権を設定してください。

(6)　WWWサービスの起動と動作確認

Microsoft IISのWWWサービスの起動と動作確認の手順を次に示します。

［スタート］メニューの［すべてのプログラム］－［管理ツール］から，［サービス］を選択します。
サービス一覧が表示されます。

サービス一覧の中から「World Wide Web Publishing Service」を選択します。

［サービスの開始］アンカーをクリックします。
WWWサービスが再起動します。

(7)　ほかのフィルタと共存させる場合の注意事項

Microsoft IISが受信したリクエストが，Webコンテナに転送するリクエストの場合，Microsoft IIS用リダイレクタはISAPIフィルタ内で使用するリクエストURL情報を変更します。そのため，Microsoft IIS用リダイレクタよりあとに実行されるISAPIフィルタでは，Microsoft IISが受信したリクエストURLを取得できません。Microsoft IISが受信したリクエストURLをフィルタで取得する場合は，Microsoft IIS用リダイレクタよりも順番が先になるように設定してください。順番を調整するために，Microsoft IIS用リダイレクタの優先順位を「中」または「低」に変更する必要がある場合は，isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）のfilter_priorityキーで指定します。isapi_redirect.conf（Microsoft IIS用リダイレクタ動作定義ファイル）のfilter_priorityキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

18.9.2　Microsoft IISのSSLの設定方法

Microsoft IISのSSLの設定方法については，Microsoft IISのSSLのヘルプを参照してください。

19.　EJBクライアントアプリケーションの設定と実行

この章では，EJBクライアントアプリケーションの開始に必要な設定と，実行方法について説明します。

＜この章の構成＞

19.1　EJBクライアントアプリケーション開始の流れ

19.2　EJBクライアントアプリケーションの環境変数の設定

19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定

19.4　EJBクライアントアプリケーションのプロパティの設定

19.5　EJBクライアントアプリケーションのログ出力の設定

19.6　EJBクライアントアプリケーションのトランザクションの設定

19.1　EJBクライアントアプリケーション開始の流れ

この節では，EJBクライアントアプリケーションの実行方法ごとに，EJBクライアントアプリケーションの開始の流れについて説明します。

EJBクライアントアプリケーションの開始に使用するコマンドを次の表に示します。

表19-1　EJBクライアントアプリケーションの開始に使用するコマンド

コマンド名
説明

cjclstartap
cjclstartapコマンドは，EJBクライアントアプリケーションの実行に必要なオプションやプロパティの指定を簡略化できるコマンドです。実行に必要なオプションやプロパティはあらかじめ，オプション定義ファイルやプロパティファイルに記述しておくことができます。また，各ファイルでオプションやプロパティの指定を省略した場合には，デフォルト値が適用されてコマンドが実行されます。
Cosminexusでは，トラブルシュート機能を強化したcjclstartap コマンドを使用したEJBクライアントアプリケーションの運用をお勧めします。
また，cjclstartapコマンドを使用すると，Javaアプリケーションも開始できます。
コマンドの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥client¥bin

UNIXの場合
/opt/Cosminexus/CC/client/bin

vbj
vbjコマンドは，EJBクライアントアプリケーションの実行に必要なオプションやプロパティをコマンドの引数として指定する必要があります。オプションやプロパティの省略はできません。
vbjコマンドは，旧バージョン互換用のコマンドです。従来の方法でvbjコマンドを使用してEJBクライアントアプリケーションを実行したい場合に使用してください。
コマンドの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥TPB¥bin¥vbj

UNIXの場合
/opt/Cosminexus/TPB/bin/vbj

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

それぞれのコマンドによるEJBクライアントアプリケーションの開始の流れについて説明します。

＜この節の構成＞

19.1.1　cjclstartapコマンドの場合

19.1.2　vbjコマンドの場合

19.1.1　cjclstartapコマンドの場合

cjclstartapコマンドによるEJBクライアントアプリケーションの開始の流れを次に示します。

EJBクライアントアプリケーションの実行に必要な環境変数を設定します。
EJBクライアントアプリケーションの実行に必要な環境変数のうち，cjclstartapコマンドでの実行に必要な環境変数を設定してください。必要な環境変数については，「19.2　EJBクライアントアプリケーションの環境変数の設定」を参照してください。

EJBクライアントアプリケーションのオプション定義ファイル（usrconf.cfg）に，JavaのオプションやJARファイルのクラスパスを指定します。

usrconf.cfgの格納場所

usrconf.cfgのひな型が次の場所に格納されていますので，このひな型ファイルを任意の場所にコピーして，使用してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥client¥templates¥usrconf.cfg

UNIXの場合

/opt/Cosminexus/CC/client/templates/usrconf.cfg

JavaVM起動オプションの指定

usrconf.cfgのadd.jvm.argキーに指定します。指定できるオプションの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

JARファイルのクラスパスの指定

usrconf.cfgのadd.class.pathキーに指定します。クラスパスへの設定が必要なJARファイルについては，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。

EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）に，プロパティを指定します。

usrconf.propertiesの格納場所

usrconf.propertiesのひな型が次の場所に格納されていますので，このひな型ファイルを任意の場所にコピーして，使用してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥client¥templates¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/client/templates/usrconf.properties

プロパティの指定

プロパティで指定できる内容については，「19.4　EJBクライアントアプリケーションのプロパティの設定」を参照してください。また，必要に応じて，「19.5　EJBクライアントアプリケーションのログ出力の設定」，および「19.6　EJBクライアントアプリケーションのトランザクションの設定」を参照してください。

指定できるプロパティの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

usrconf.cfgとusrconf.propertiesをcjclstartapコマンドを実行するカレントディレクトリ以外に格納した場合，環境変数「CJCLUSRCONFDIR」で，usrconf.cfgとusrconf.propertiesの格納場所の絶対パスを指定します。
作成したusrconf.cfgとusrconf.propertiesを同じディレクトリに格納して，そのディレクトリの絶対パスを環境変数「CJCLUSRCONFDIR」で指定してください。
なお，usrconf.cfgとusrconf.propertiesをcjclstartapコマンドを実行するカレントディレクトリに格納した場合はこの作業は必要ありません。手順5.に進んでください。

cjclstartapコマンドを使用してEJBクライアントアプリケーションを開始します。
cjclstartapコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

なお，ejb.client.directory.shareableにfalseが設定されている場合，cjclstartapコマンドを実行すると，コマンドが使用するワークファイルが作成されます。ワークファイルが破損した場合，cjclstartapコマンド，またはcjcldumpapコマンドの動作は保証されません。ワークファイルの出力先，およびファイル名を次に示します。

Windowsの場合

<カレントディレクトリ>¥.cjclstartap.lock

<ejb.client.log.directory>¥.ejbclientlog.lock

<カレントディレクトリ>¥cjclstartap.pid

UNIXの場合

<カレントディレクトリ>/.cjclstartap.lock

<ejb.client.log.directory>/.ejbclientlog.lock

<カレントディレクトリ>/cjclstartap.pid

<カレントディレクトリ>/.COSMINEXUS_CC_EJBCLIENT_プロセスID

参考

cjclstartapコマンドを使用すると，Javaアプリケーションも開始できます。cjclstartapコマンドを使用したJavaアプリケーションの開始方法については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

19.1.2　vbjコマンドの場合

vbjコマンドによるEJBクライアントアプリケーションの開始の流れを次に示します。なお，バッチファイルまたはシェルスクリプトファイルを使用してEJBクライアントアプリケーションを実行する場合は，バッチファイルまたはシェルスクリプトファイルにこれらの内容を記述できます。

EJBクライアントアプリケーションの実行に必要な環境変数を設定します。
EJBクライアントアプリケーションの実行に必要な環境変数のうち，vbjコマンドでの実行に必要な環境変数を設定してください。必要な環境変数については，「19.2　EJBクライアントアプリケーションの環境変数の設定」を参照してください。

JavaVM起動オプションを指定します。
vbjコマンドに適切なJavaVM起動オプションを指定します。指定できるオプションの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

JARファイルのクラスパスを指定します。
vbjコマンドに適切なクラスパスを指定します。必要なクラスパスについては，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。

プロパティを指定します。
プロパティで指定できる内容については，「19.4　EJBクライアントアプリケーションのプロパティの設定」を参照してください。また，必要に応じて，「19.5　EJBクライアントアプリケーションのログ出力の設定」，および「19.6　EJBクライアントアプリケーションのトランザクションの設定」を参照してください。
指定できるプロパティの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

vbjコマンドを使用してEJBクライアントアプリケーションを開始します。

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

19.2　EJBクライアントアプリケーションの環境変数の設定

この節では，EJBクライアントアプリケーションの環境変数の設定について説明します。EJBクライアントアプリケーションの実行に必要な環境変数を次に示します。

表19-2　EJBクライアントアプリケーションの実行に必要な環境変数（Windowsの場合）

環境変数 | 値 | 種別 | コマンド
cjclstartap | vbj
PATH※ | <Cosminexusのインストールディレクトリ>¥jdk¥bin | 固定 | － | ○
<Cosminexusのインストールディレクトリ>¥TPB¥bin | 固定 | ○ | －
<Cosminexusのインストールディレクトリ>¥PRF¥bin | 固定 | ○ | ○
VBROKER_ADM | <Cosminexusのインストールディレクトリ>¥TPB¥adm | 固定 | ○ | ○
PRFSPOOL | <Cosminexusのインストールディレクトリ>¥PRF¥spool | 固定 | ▲ | ▲
TZ | JST-9　など | 固定 | ○ | ○

（凡例）

○：コマンドに環境変数を指定する必要がある。

▲：インストーラによって設定される。

－：設定する必要がない。

固定：該当環境変数に対する値は固定で，指定する必要がある。

注※

環境変数「PATH」の先頭に「<Cosminexusのインストールディレクトリ>¥jdk¥bin」を指定してください。

表19-3　EJBクライアントアプリケーションの実行に必要な環境変数（UNIXの場合）

環境変数
値
種別
コマンド

cjclstartap
vbj

LIBPATH，またはLD_LIBRARY_PATH※1
/opt/Cosminexus/TPB/lib
/opt/Cosminexus/PRF/lib
固定
○
○

PATH※2
/opt/Cosminexus/jdk/bin
固定
－
○

/opt/Cosminexus/TPB/bin
固定
○
－

/bin
/usr/bin
固定
－
○

VBROKER_ADM
/opt/Cosminexus/TPB/adm
固定
○
○

PRFSPOOL
/opt/Cosminexus/PRF/spool
固定
○
○

TZ
JST-9　など
固定
○
○

（凡例）

○：コマンドに環境変数を指定する必要がある。

－：設定する必要がない。

固定：該当環境変数に対する値は固定で，指定する必要がある。

注※1

OSによって，使用する環境変数名が異なります。

LIBPATH：AIXの場合

LD_LIBRARY_PATH：HP-UX（IPF），Linux，またはSolarisの場合

注※2

環境変数「PATH」の先頭に「/opt/Cosminexus/jdk/bin」を指定してください。

実行環境がAIXの場合は，上記の表に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。詳細については，「2.3.3　AIX固有の環境変数」を参照してください。

19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定

この節では，EJBクライアントアプリケーションのクラスパスへのJARファイルの設定方法について説明します。EJBクライアントアプリケーションの開始に使用するコマンドによって，クラスパスへのJARファイルの設定方法が異なります。

cjclstartapコマンドの場合
cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのオプション定義ファイル（usrconf.cfg）で，クラスパスにJARファイルを設定します。

vbjコマンドの場合
vbjコマンドを使用する場合は，バッチファイル/シェルスクリプトファイル，またはコマンドの引数で設定します。

EJBクライアントアプリケーションの実行に必要なJARファイルを次の表に示します。

表19-4　EJBクライアントアプリケーションの実行に必要なJARファイル

JARファイル名
［種別］※1JARファイルの配置場所
含まれる内容
コマンド

cjclstartap
vbj

hitj2ee.jar
［固定］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥lib

UNIXの場合
/opt/Cosminexus/CC/lib

製品提供クラス
－
○

HiEJBClientStatic.jar
［固定］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥client¥lib

UNIXの場合
/opt/Cosminexus/CC/client/lib

製品提供クラス
－
○

vbjorb.jar
vbsec.jar
［固定］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥TPB¥lib

UNIXの場合
/opt/Cosminexus/TPB/lib

製品提供クラス
－
○

cprf.jar
［固定］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥PRF¥lib

UNIXの場合
/opt/Cosminexus/PRF/lib

製品提供クラス
－
○

hntrlib2j.jar
または
hntrlib2j64.jar
（サブディレクトリ専有モードの場合）※2
［固定］

Windowsの場合
<Program Files>¥Hitachi¥HNTRLib2¥classes

UNIXの場合
/opt/hitachi/HNTRLib2/classes

製品提供クラス
－
○

hntrlibMj.jar
または
hntrlibMj64.jar
（サブディレクトリ共有モードの場合）※2 ※3
［固定］

Windowsの場合
<Program Files>¥Hitachi¥HNTRLib2¥classes

UNIXの場合
/opt/hitachi/HNTRLib2/classes

製品提供クラス
－
○

tpotsinproc.jar
［トランザクション使用］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥TPB¥lib

UNIXの場合
/opt/Cosminexus/TPB/lib

製品提供クラス
－
△

ejbserver.jar
［トランザクション使用］

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥lib

UNIXの場合
/opt/Cosminexus/CC/lib

△
△

stubs.jar
［RMI-IIOPのスタブ］
J2EEサーバからダウンロード，またはダイナミッククラスローディング
RMI-IIOPのスタブ

EJBオブジェクトのスタブ

EJBホームオブジェクトのスタブ

スタブが参照するクラス

△
△

<数字>.jar
［RMI-IIOPのインタフェース］
J2EEサーバからダウンロード
RMI-IIOPのインタフェース

リモートインタフェース

ホームインタフェース

インタフェースが参照するクラス

○
○

ユーザ作成のJARファイル
ユーザ作成のクラス
EJBクライアントアプリケーションで利用するユーザ作成のクラスです。
ユーザが作成した独自のFilterクラス，Formatterクラス，またはHandlerクラスをEJBクライアントアプリケーションのユーザログ機能で使用する場合には，そのクラスもクラスパスに指定してください。※3
○
○

（凡例）

○：クラスパスに指定する必要がある。

△：必要に応じてクラスパスに指定する。

－：クラスパスに指定する必要がない。

注※1

種別には，次に示すものがあります。

［固定］
EJBクライアントアプリケーションから呼び出すアプリケーションの数，内容に関係なく，指定するJARファイルのファイル名と配置場所は固定です。

［トランザクション使用］
EJBクライアントアプリケーションでトランザクションを使用する場合に，該当するJARファイルを指定します。詳細については，「19.6　EJBクライアントアプリケーションのトランザクションの設定」を参照してください。

［RMI-IIOPのスタブ］
EJBクライアントアプリケーションから呼び出すアプリケーション単位に該当するJARファイルを指定します。ダイナミッククラスローディングを利用する場合は，指定する必要はありません。

［RMI-IIOPのインタフェース］
RMI-IIOPのインタフェースをEJBクライアントアプリケーション側に取得していない場合，アプリケーション単位に該当するJARファイルをダウンロードして指定します。すでにRMI-IIOPのインタフェースをEJBクライアントアプリケーション側に取得している場合は，取得済みのクラスまたはJARファイルを指定します。

注※2

EJBクライアントアプリケーションの動作モードに合わせて，JARファイルを使用してください。サブディレクトリ専有モードは06-50よりも前のバージョンとの互換用に使用するモードであるため，EJBクライアントアプリケーションを新規作成する場合は，サブディレクトリ共有モードを使用することをお勧めします。EJBクライアントアプリケーションのユーザログ機能を使用する場合は，サブディレクトリ共有モードを使用してください。サブディレクトリ専有モード，およびサブディレクトリ共有モードについては，「19.5　EJBクライアントアプリケーションのログ出力の設定」を参照してください。

また，使用しているOSに合わせて，JARファイルを使用してください。HP-UX（IPF）の場合およびLinux（IPF）の場合は，hntrlib2j64.jarまたはhntrlibMj64.jarを指定してください。それ以外の場合は，hntrlib2j.jarまたはhntrlibMj.jarを指定してください。

注※3

EJBクライアントアプリケーションのユーザログ出力機能を使用する場合に指定してください。EJBクライアントアプリケーションのユーザログ出力の設定については，マニュアル「Cosminexus　機能解説」のEJBクライアントアプリケーションでのユーザログ出力の実装に関する説明を参照してください。

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC」を，「<Cosminexusのインストールディレクトリ>¥CCL」と読み替えてください。

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，EJBクライアントアプリケーションのトランザクションは使用できません。

クラスパスでJARファイルを設定する場合，JARファイルの設定順序に注意してください。
トランザクションを使用する場合，クラスパスには，tpotsinproc.jarとejbserver.jarを設定します。このとき，ejbserver.jarよりも先に，HiEJBClientStatic.jarを設定してください。
性能解析トレース機能を利用する場合，クラスパスには，cprf.jarを設定します。このとき，HiEJBClientStatic.jarよりも先にcprf.jarを設定してください。
逆の順序で設定した場合は，性能解析トレースの初期化に失敗します。また，逆の順序で設定した場合に，EJBクライアントアプリケーションのログレベルをWarning以上に設定しているときは，KDJE51008-Wのメッセージが理由コード「-4」で出力されます。なお，性能解析トレースの初期化に失敗した場合は，性能解析トレースは出力されませんが，EJBクライアントアプリケーションの処理は継続できます。

19.4　EJBクライアントアプリケーションのプロパティの設定

この節では，EJBクライアントアプリケーションのプロパティの設定方法について説明します。EJBクライアントアプリケーションの開始に使用するコマンドによって，EJBクライアントアプリケーションのプロパティの設定方法が異なります。

cjclstartapコマンドの場合
cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）で，プロパティを設定します。

vbjコマンドの場合
vbjコマンドを使用する場合は，バッチファイル/シェルスクリプトファイル，またはコマンドの引数で，プロパティを設定します。

＜この節の構成＞

(1)　プロパティでの設定内容

(2)　コマンドによって指定の要否が異なるプロパティ

(1)　プロパティでの設定内容

EJBクライアントアプリケーションのプロパティは，JavaアプリケーションからEnterprise Beanを呼び出す場合に使用されます。また，WebコンテナサーバからEnterprise Beanを呼び出す場合は，Enterprise Beanを呼び出す場合に必要なプロパティをカスタマイズする必要があります。J2EEアプリケーションの内容に応じて，必要なプロパティを設定してください。設定できるプロパティについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

プロパティで設定できる内容の一例

EJBクライアントアプリケーションのログの設定
ejbserver.client.logで始まるキーやejbserver.loggerで始まるキーなどで，システムが出力するシステムログと，EJBクライアントアプリケーションが出力するユーザログの出力先やログレベルなどを変更できます。詳細については，「19.5　EJBクライアントアプリケーションのログ出力の設定」を参照してください。

EJBクライアントアプリケーションのトランザクションの設定
ejbserver.client.transactionで始まるキーで，EJBクライアントアプリケーションでトランザクションを使用するかどうか，トランザクションサービスが使用するクライアント名などを指定できます。なお，uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，EJBクライアントアプリケーションのトランザクションは使用できません。詳細については，「19.6　EJBクライアントアプリケーションのトランザクションの設定」を参照してください。

EJBのリモートインタフェースでの通信障害発生時のEJBクライアントの動作
ejbserver.container.rebindpolicyキーに，EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定できます。

EJBクライアントアプリケーションからラウンドロビン検索を実行する設定
ejbserver.jndi.namingservice.group.listキー，ejbserver.jndi.namingservice.group.<Specify group name>.providerurlsキーおよびjava.naming.factory.initialキーに，CORBAネーミングサービスのグループ，各グループに属するCORBAネーミングサービスのルート位置，およびInitialContextFactoryの実装をデレゲートしているクラスを指定できます。なお，ラウンドロビン検索は，J2EEサーバのサーバ管理コマンドのカスタマイズでユーザ指定名前空間機能を使用する設定をしている場合に有効になります。

EJBクライアントアプリケーションからCTMへのリクエストの優先度の設定
ejbserver.client.ctm.RequestPriorityキーに，EJBクライアントアプリケーションからCTMに送信するリクエストの優先度を設定できます。

(2)　コマンドによって指定の要否が異なるプロパティ

ここでは，EJBクライアントアプリケーションのコマンド（vbjコマンド）によって指定の要否が異なるプロパティについて説明します。EJBクライアントアプリケーションのコマンドによって指定の要否が異なるプロパティのキーを次の表に示します。

表19-5　EJBクライアントアプリケーションのコマンドによって指定の要否が異なるプロパティのキー

プロパティのキー | 種別 | コマンド
cjclstartap | vbj
org.omg.CORBA.ORBClass | 固定 | － | －
org.omg.CORBA.ORBSingletonClass | 固定 | － | －
javax.rmi.CORBA.UtilClass | 固定 | － | ○
javax.rmi.CORBA.StubClass | 固定 | － | －
javax.rmi.CORBA.PortableRemoteObjectClass | 固定 | － | ○
java.endorsed.dirs | 可変 | － | －

（凡例）

○：コマンドにキーを指定する必要がある。

－：コマンドにキーを指定する必要がない。

固定：該当するキーに対する値は固定で，指定する必要がある。

可変：システムの実行環境に従って値を指定する必要がある。

19.5　EJBクライアントアプリケーションのログ出力の設定

この節では，EJBクライアントアプリケーションのログの種類とログ出力の設定について説明します。

＜この節の構成＞

19.5.1　EJBクライアントアプリケーションのログの種類

19.5.2　システムログの出力先や出力レベルの変更

19.5.3　複数プロセスでのログ出力先のサブディレクトリの共有

19.5.4　ログ出力先のサブディレクトリ数の管理

19.5.5　ログ出力先ディレクトリのアクセス権の設定

19.5.1　EJBクライアントアプリケーションのログの種類

EJBクライアントアプリケーションでは，システムが出力するシステムログと，EJBクライアントアプリケーションが出力するユーザログを出力できます。

＜この項の構成＞

(1)　EJBクライアントアプリケーションのシステムログ

(2)　EJBクライアントアプリケーションのユーザログ

(1)　EJBクライアントアプリケーションのシステムログ

EJBクライアントアプリケーションのシステムログでは，メッセージログ，例外ログ，保守用ログの3種類のログが出力されます。EJBクライアントアプリケーションでは，必要に応じて，システムログの出力先や出力レベル，出力先のサブディレクトリの設定を変更できます。

(a)　システムログの設定方法

EJBクライアントアプリケーションの開始に使用するコマンドによって，EJBクライアントアプリケーションのシステムログの設定方法が異なります。

cjclstartapコマンドの場合
cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）で，システムログのプロパティを設定します。

vbjコマンドの場合
vbjコマンドを使用する場合は，バッチファイル/シェルスクリプトファイル，またはコマンドの引数で，システムログのプロパティを設定します。

(b)　システムログの出力先や出力レベルの設定

出力先や出力レベルの設定の変更については，「19.5.2　システムログの出力先や出力レベルの変更」を参照してください。

(c)　システムログの出力先のサブディレクトリの設定

EJBクライアントアプリケーションのシステムログは，EJBクライアントアプリケーションのプロセス単位で出力されます。システムログでは，プロセスごとにログ出力先のサブディレクトリを作成するか，複数のプロセスでログ出力先のサブディレクトリを共有することができます。プロセスごとにログ出力先のサブディレクトリを作成する動作モードのことをサブディレクトリ専有モード，複数のプロセスでログ出力先のサブディレクトリを共有する動作モードのことをサブディレクトリ共有モードといいます。なお，既存のEJBクライアントアプリケーションをそのまま使用する場合は，サブディレクトリ専有モードで動作します。

サブディレクトリ共有モードとサブディレクトリ専有モードの違いを次の表に示します。

表19-6　サブディレクトリ共有モードとサブディレクトリ専有モードの違い

項目 | サブディレクトリ共有モード | サブディレクトリ専有モード
複数のプロセスでのサブディレクトリ共有の可否 | 共有できます。 | 共有できません。
ログ管理ファイル作成 | 作成されます。 | 作成されません。
ejbserver.client.ejb.logキー※のデフォルト値 | system | ejb
ejbserver.client.log.appidキー※のデフォルト値 | ejbcl | EJBクライアントアプリケーション識別ID
ejbserver.client.log.directorynumキー※の指定 | 常に無効です。 | ejbserver.client.log.appidキーを指定した場合は，無効です。
ejbserver.logger.channels.define.<チャネル名>.filenumキー※に指定できる面数 | 1～64 | 1～16
ejbserver.logger.channels.define.<チャネル名>.filesizeキー※に指定できる容量（バイト） | 4,096～16,777,216 | 4,096～2,147,483,647

注※　EJBクライアントアプリケーションの開始時に指定するシステムプロパティです。

ポイント

サブディレクトリ専有モードは06-50よりも前のバージョンとの互換用に使用するモードであるため，EJBクライアントアプリケーションを新規作成する場合は，サブディレクトリ共有モードを使用することをお勧めします。

注意

cjclstartapコマンドでEJBクライアントアプリケーションを実行する場合は，サブディレクトリ共有モードを使用してください。

EJBクライアントアプリケーションのユーザログ機能を使用する場合は，サブディレクトリ共有モードを使用してください。

動作モードの指定
サブディレクトリ共有モードとサブディレクトリ専有モードのどちらを使用するかは，クラスパスで指定できます。使用する動作モードによって，クラスパスに指定するJARファイルが異なります。クラスパスの指定については，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。

サブディレクトリの共有
サブディレクトリ共有モードを使用している場合は，ログ出力先のサブディレクトリを共有できます。サブディレクトリの共有については，「19.5.3　複数プロセスでのログ出力先のサブディレクトリの共有」を参照してください。

サブディレクトリ数の管理
サブディレクトリ専有モードを使用している場合は，ログ出力先のサブディレクトリ数を管理できます。サブディレクトリ数の管理については，「19.5.4　ログ出力先のサブディレクトリ数の管理」を参照してください。

(2)　EJBクライアントアプリケーションのユーザログ

EJBクライアントアプリケーションが出力するログ（ユーザログ）を日立トレース共通ライブラリ形式で出力できます。日立トレース共通ライブラリ形式で出力することで，システムログとEJBクライアントアプリケーションのログを同じ形式で扱うことができるようになり，システム全体のログ運用の信頼性を高められます。

EJBクライアントアプリケーションの開始に使用するコマンドによって，EJBクライアントアプリケーションのユーザログの設定方法が異なります。

cjclstartapコマンドの場合
cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）でユーザログの設定をします。ejbserver.applicationから始まるキーで，ユーザログの出力先ファイル，ログレベル，ログ面数，使用するフィルタおよびフォーマッタなどを指定してください。指定できるキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

vbjコマンドの場合
EJBクライアントアプリケーションのユーザログのファイルハンドラとして，CJMPMessageFileHandlerが提供されています。vbjコマンドを使用する場合は，CJMPMessageFileHandlerのログの出力先ファイル，ログレベル，ログ面数，使用するフィルタおよびフォーマッタなどは，EJBクライアントアプリケーションのユーザログ用の設定ファイルで設定します。設定方法については，マニュアル「Cosminexus　機能解説」のEJBクライアントアプリケーションでのユーザログ出力の実装に関する説明を参照してください。

19.5.2　システムログの出力先や出力レベルの変更

Javaアプリケーション用オプション定義ファイル（usrconf.cfg），またはJavaアプリケーション用ユーザプロパティファイル（usrconf.properties）をカスタマイズすることで，EJBクライアントアプリケーションのシステムログの属性を変更できます。変更できる項目と，変更を設定するプロパティのキーを次の表に示します。また，この表では，EJBクライアントアプリケーションの実行コマンドに指定するプロパティの指定の要否についても説明します。

表19-7　EJBクライアントアプリケーションのシステムログの出力先や出力レベルを変更するキー

変更できる項目 | Javaアプリケーション用オプション定義ファイルのキー | Javaアプリケーション用ユーザプロパティファイルのキー | 種別
ログの出力先※1 | ejb.client.log.directory | ejbserver.client.log.directory | 可変
EJBクライアントアプリケーション単位で作成されるログ出力先ディレクトリ名※1 | ejb.client.ejb.log | ejbserver.client.ejb.log | 選択可変
EJBクライアントアプリケーションのプロセス単位で作成されるログ出力先サブディレクトリ名※1 | ejb.client.log.appid | ejbserver.client.log.appid | 選択可変
標準出力へのメッセージ出力停止※2 | ejb.client.log.stdout.enabled | － | 選択可変
EJBクライアントアプリケーションのプロセス単位で作成されるログ出力先サブディレクトリ数 | － | ejbserver.client.log.directorynum | 可変
ログファイル面数 | － | ejbserver.logger.channels.define.<チャネル名※3>.filenum | 選択可変
ログファイルサイズ | － | ejbserver.logger.channels.define.<チャネル名※3>.filesize | 選択可変
ログの出力レベル※4 | － | ejbserver.logger.enabled.* | 選択可変
Cosminexus TPBrokerのトレースファイルの出力先 | － | vbroker.orb.htc.tracePath | 選択可変
Cosminexus TPBrokerのトレースファイルの個数 | － | vbroker.orb.htc.comt.fileCount | 選択可変
Cosminexus TPBrokerのトレースファイル1個当たりのエントリ数 | － | vbroker.orb.htc.comt.entryCount | 選択可変

（凡例）

可変：システムの実行環境に従って値を指定する必要がある。

選択可変：システムの実行環境に従って値を指定するか，または指定を省略する。

－：設定できない。

注※1

usrconf.cfgでは，稼働ログ，ログ稼働ログ，障害発生時の例外情報，および保守情報の設定を変更できます。

また，usrconf.cfgとusrconf.propertiesで同じ項目が設定された場合，usrconf.propertiesで設定した内容が優先されます。

注※2

稼働ログ，cjclstartapコマンドログ，および起動プロセス標準出力情報のメッセージを標準出力に出力しないように設定できます。

注※3

チャネル名として，ログの種類を示す次の名称が設定されます。

ClientMessageLogFile（稼働ログ）（ファイル名：cjclmessage[n].log）

ClientExceptionLogFile（障害発生時の例外情報）（ファイル名：cjclexception[n].log）

ClientMaintenanceLogFile（保守情報）（ファイル名：cjclmaintenance[n].log）

注※4

シェルスクリプトを使用してシステムプロパティを設定する場合，ログの出力レベル（ejbserver.logger.enabled.*キー）は指定できません。

システムプロパティを指定できるかどうかは，EJBクライアントアプリケーションの使用形態によって異なる場合があります。EJBクライアントアプリケーションの使用形態とシステムプロパティの関係を次の表に示します。なお，表19-8と表19-9の番号は対応しています。

表19-8　EJBクライアントアプリケーションの使用形態

EJBクライアントアプリケーションの種類 | EJBクライアントアプリケーションの同時起動の多重度
1多重 | 2～8多重 | 9～16多重
1種類 | 1. | 2. | 3.
2種類以上 | 4. | 5. | 6.

表19-9　EJBクライアントアプリケーションの使用形態とシステムプロパティ

システムプロパティの指定 | EJBクライアントアプリケーションの使用形態
1. | 2. | 3. | 4. | 5. | 6.
ejbserver.client.ejb.log | 可能 | 可能 | 必須 | 必須 | 必須 | 必須
ejbserver.client.log.appid | 可能 | 不可 | 不可 | 可能 | 不可 | 不可
ejbserver.client.log.directorynum | 可能 | 可能 | 必須 | 可能 | 可能 | 必須

上記表の番号について説明します。

ejbserver.client.ejb.logキーは，デフォルトディレクトリでもかまいません。
ejbserver.client.log.appidキーを指定した場合は，ejbserver.client.log.directorynumキーの指定は無効となります。

ejbserver.client.ejb.logキーは，デフォルトディレクトリでもかまいません。
複数同時に起動するため，ejbserver.client.log.appidキーは指定しないでください。ejbserver.client.log.directorynumキーを指定する場合は，必ずejbserver.client.ejb.logキーを指定してください。

ejbserver.client.ejb.logキーをEJBクライアントアプリケーションごとに必ず指定してください。複数同時に起動するため，ejbserver.client.log.appidキーを指定しないでください。ejbserver.client.log.directorynumキーの値を多重度に合わせて指定してください。

ejbserver.client.ejb.logキーをEJBクライアントアプリケーションごとに必ず指定してください。
ejbserver.client.log.appidキーを指定した場合は，ejbserver.client.log.directorynumキーの指定は無効となります。

ejbserver.client.ejb.logキーをEJBクライアントアプリケーションごとに必ず指定してください。複数同時に起動するため，ejbserver.client.log.appidキーを指定しないでください。
ejbserver.client.log.directorynumキーを指定する場合は，必ずejbserver.client.ejb.logキーを指定してください。

ejbserver.client.ejb.logキーをEJBクライアントアプリケーションごとに必ず指定してください。複数同時に起動するため，ejbserver.client.log.appidキーを指定しないでください。ejbserver.client.log.directorynumキーの値を多重度に合わせて指定してください。

注意事項

EJBクライアントアプリケーションの同時起動の多重度が17多重以上の場合は，ejbserver.client.log.directorynumキーに0を指定してください。cjcldellogコマンドを使用してサブディレクトリ数を管理してください。

EJBクライアントアプリケーションを複数同時に起動すると，KDJE51005-Wのメッセージが出力されることがあります。EJBクライアントアプリケーションの動作には問題ありませんが，サブディレクトリ数がejbserver.client.log.directorynumキーに指定した値を超えている場合があります。このメッセージが頻繁に出力される場合は，ejbserver.client.log.directorynumキーの値を0にし，cjcldellogコマンドを使用してサブディレクトリ数を管理してください。ログ出力先のサブディレクトリ数を管理できるのは，サブディレクトリ専有モードを使用している場合だけです。サブディレクトリ共有モードを使用している場合は，サブディレクトリ数の管理はできません。

19.5.3　複数プロセスでのログ出力先のサブディレクトリの共有

サブディレクトリ共有モードを使用している場合は，ログ出力先のサブディレクトリを共有できます。

EJBクライアントアプリケーションのシステムログは，EJBクライアントアプリケーション単位に作成されるログ出力先ディレクトリ（ejbserver.client.log.directoryキー，およびejbserver.client.ejb.logキーに指定したディレクトリ）下のサブディレクトリに格納されます。なお，サブディレクトリ名は，ejbserver.client.log.appidキーで指定できます。

サブディレクトリ共有モードを使用する場合，ログ出力先ディレクトリを指定するejbserver.client.ejb.logキーには，サブディレクトリ専有モードを使用する場合とは異なる値を指定してください。サブディレクトリ専有モードと同じ値を指定した場合には，サブディレクトリ専有モードでのログ出力先のサブディレクトリ数が管理できなくなります。

サブディレクトリ共有モードで動作するEJBクライアントがログの稼働情報（cjlogger.logファイル）にKDJE90002-Eメッセージを出力して終了する場合，またはKDJE90003-Eメッセージを出力する場合は，ログファイルの排他に失敗しているおそれがあります。ejbserver.client.log.lockRetryCount，およびejbserver.client.log.lockIntervalキーを使用してリトライ回数とリトライ間隔を大きくすることで，ログファイルの排他の失敗を回避できます。

EJBクライアントアプリケーションのシステムログの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

注意事項

EJBクライアントアプリケーションを初回起動時に複数同時に起動すると，同時刻に起動したほかのEJBクライアントアプリケーションとログディレクトリ生成処理が衝突し，KDJE51003-Eメッセージを出力して異常終了する場合があります。EJBクライアントアプリケーションの初回起動時には複数同時に起動しないようにするか，あらかじめログ出力先ディレクトリを作成してください。

19.5.4　ログ出力先のサブディレクトリ数の管理

サブディレクトリ専有モードを使用している場合は，ログ出力先のサブディレクトリ数を管理できます。

EJBクライアントアプリケーションのシステムログは，EJBクライアントアプリケーション単位に作成されるログ出力先ディレクトリ（ejbserver.client.log.directoryキー，およびejbserver.client.ejb.logキーに指定したディレクトリ）下の，サブディレクトリに格納されます。EJBクライアントアプリケーションを複数起動すると，起動したプロセス分のサブディレクトリが生成されます。このサブディレクトリが単調増加しないように管理できます。

サブディレクトリ数は，EJBクライアントアプリケーションのプロセス単位に作成されるサブディレクトリの数となります。ただし，EJBクライアントアプリケーション単位に作成されるログ出力先ディレクトリ下にユーザ作成のサブディレクトリがある場合，ユーザ作成のサブディレクトリの数もサブディレクトリとして数えられます。

デフォルトでは，ログ出力先のサブディレクトリ数を8個までとし，古いサブディレクトリから削除されるようになっています。サブディレクトリ数を変更する場合には，ejbserver.client.log.directorynumキーで変更してください。EJBクライアントアプリケーションのシステムログの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

19.5.5　ログ出力先ディレクトリのアクセス権の設定

UNIXの場合，複数ユーザアカウントで同じログ出力先ディレクトリを使用してEJBクライアントアプリケーションを実行するときは，ログ出力先ディレクトリのアクセス権を設定する必要があります。

ログ出力先ディレクトリのモードを，グループやほかのすべてのユーザに対して書き込みを許可するように設定し，umaskを0に設定してからEJBクライアントアプリケーションを実行してください。

19.6　EJBクライアントアプリケーションのトランザクションの設定

この節では，EJBクライアントアプリケーションでトランザクションを使用するための設定について説明します。

注意

uCosminexus Clientを使用してEJBクライアント環境を構築する場合は，EJBクライアントアプリケーションのトランザクションは使用できません。

EJBクライアントアプリケーションでトランザクションを使用するためには，次の設定が必要です。

JARファイルの設定

プロパティの設定

UserTransactionの取得の設定

UserTransactionの取得の設定は，J2EEアプリケーション開発時の設定内容です。EJBクライアントアプリケーションでトランザクションを使用するために，EJBクライアントアプリケーションからUserTransaction（javax.transaction.UserTransaction）を取得するための設定が必要です。設定方法については，マニュアル「Cosminexus　機能解説」のEJBクライアントアプリケーションでのトランザクションの実装に関する説明を参照してください。

ここでは，EJBクライアントアプリケーションでトランザクションを使用するためのJARファイルとプロパティの設定について説明します。

＜この節の構成＞

(1)　JARファイルの設定

(2)　プロパティの設定

(3)　注意事項

(1)　JARファイルの設定

EJBクライアントアプリケーションでトランザクションを使用するために，次のJARファイルをクラスパスに設定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥TPB¥lib¥tpotsinproc.jar

<Cosminexusのインストールディレクトリ>¥CC¥lib¥ejbserver.jar※

UNIXの場合

/opt/Cosminexus/TPB/lib/tpotsinproc.jar

/opt/Cosminexus/CC/lib/ejbserver.jar※

注※

クラスパスの設定で，ejbserver.jarはHiEJBClientStatic.jarよりも後ろに設定してください。

クラスパスへのJARファイルの設定については，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。

(2)　プロパティの設定

EJBクライアントアプリケーションでトランザクションを使用するために設定が必要なキーについて説明します。プロパティの設定については，「19.4　EJBクライアントアプリケーションのプロパティの設定」を参照してください。各キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

EJBクライアントアプリケーションでトランザクションを使用するためには，次のキーを設定します。

(a)　必須のプロパティ

ejbserver.client.transaction.enabled
「true」を指定して，EJBクライアントアプリケーションでのトランザクションの使用を有効にします。

ejbserver.distributedtx.recovery.port
グローバルトランザクションを使用するとき，トランザクションリカバリで使用する固定ポート番号を指定します。EJBクライアントのプロセスごとに別のポート番号を指定してください。また，同一マシン上で動作するアプリケーションサーバのリカバリ用ポート番号とは別のポート番号を指定してください。

ejbserver.client.transaction.clientName
トランザクションサービスが使用するクライアント名を指定します。ここでは，EJBクライアントのプロセスごとに別の名前を指定してください。また，同一マシン上で動作するJ2EEサーバ名とは別の名前を指定してください。

ejbserver.distributedtx.ots.status.directory1
トランザクションサービスが使用するステータスファイルや，そのバックアップを配置するディレクトリを指定します。EJBクライアントのプロセスごとに別のディレクトリを指定してください。また，J2EEサーバに指定したステータスファイルのディレクトリとは別のディレクトリを指定してください。

(b)　任意のプロパティ

ejbserver.jta.TransactionManager.defaultTimeOut
トランザクションタイムアウトが発生するまでの時間を指定します。

ejbserver.distributedtx.ots.status.directory2
トランザクションサービスが使用するステータスファイルや，そのバックアップを配置する二つ目のディレクトリを指定します。EJBクライアントのプロセスごとに別のディレクトリを指定してください。また，J2EEサーバに指定したステータスファイルのディレクトリとは別のディレクトリを指定してください。

(3)　注意事項

EJBクライアントアプリケーションのトランザクションの設定での注意事項を次に示します。

グローバルトランザクションを使用するためには，アプリケーションサーバ側でライトトランザクション機能を無効にする必要があります。デフォルトの設定では，ライトトランザクション機能が有効になっています。J2EEサーバのusrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーで「true」を指定すると，ライトトランザクション機能が無効となり，グローバルトランザクションが利用できるようになります。

付録

＜この付録の構成＞

付録A　Cosminexus Version 6およびCosminexus Version 7からの移行

付録B　Cosminexus Version 6およびCosminexus Version 7とのRMI-IIOP通信の相互接続性

付録C　推奨機能への移行

付録D　サーバマネジャからServer Plug-inへの移行

付録E　DDの見直しの観点

付録F　Oracleアクセスライブラリの再作成

付録G　ベーシックモードの利用（互換用機能）

付録H　サーブレットエンジンモードの利用（互換用機能）

付録I　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（Windowsの場合）

付録J　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（UNIXの場合）

付録K　Cosminexusで提供するサンプルプログラム

付録L　用語解説

付録A　Cosminexus Version 6およびCosminexus Version 7からの移行

旧バージョンからCosminexus 07-60への移行方法について説明します。移行の対象となる旧バージョンを次に示します。

Cosminexus 07-50

Cosminexus 07-10

Cosminexus 07-00

Cosminexus 06-71

Cosminexus 06-70

Cosminexus 06-51

Cosminexus 06-50

Cosminexus 06-02（Windowsだけのバージョン）

Cosminexus 06-00

なお，このマニュアルでは，次に示す構成ソフトウェアの移行を中心に説明します。

Cosminexus Performance Tracer

Cosminexus Component Container

Cosminexus Component Transaction Monitor

Cosminexus Component Container - Client

旧バージョンからの移行を行う場合，使用しているCosminexusの全構成ソフトウェアを同時に移行する必要があります。上記で示していないほかの構成ソフトウェア（以降，他構成ソフトウェアと呼びます）の移行については，各構成ソフトウェアのドキュメントを参照してください。

＜この節の構成＞

付録A.1　Cosminexusの移行の概要

付録A.2　Cosminexusの移行の手順

付録A.3　旧バージョンからの仕様変更の確認

付録A.4　J2EEサーバの作業ディレクトリのディスク容量の確認

付録A.5　移行前の確認

付録A.6　定義などのバックアップ

付録A.7　J2EEサーバの移行コマンドの実行

付録A.8　リソースアダプタの移行コマンドの実行

付録A.9　Management Serverの移行コマンドの実行

付録A.10　手動による定義などの修正

付録A.11　移行コマンドで作成されたバックアップの削除

付録A.12　J2EEサーバの移行コマンドで自動的に追加される定義

付録A.13　セッションフェイルオーバ機能を使用している場合のバージョンアップ

付録A.1　Cosminexusの移行の概要

Cosminexusの移行の概要について説明します。

＜この項の構成＞

(1)　移行のためのアップグレードインストール

(2)　移行時のJ2EEサーバの動作モード

(3)　移行時に引き継がれる情報

(4)　移行時のJ2EEアプリケーションの動作

(1)　移行のためのアップグレードインストール

旧バージョンからCosminexus 07-60へ移行するためには，アップグレードインストールを行います。アップグレードインストールとは，インストール先のマシンに旧バージョンのCosminexusがインストール済みの場合のインストールです。

なお，アップグレードインストールの場合は，Cosminexusのインストールディレクトリを旧バージョンのインストールディレクトリから変更できません。旧バージョンがインストールされているディレクトリに上書きインストールされます。

(2)　移行時のJ2EEサーバの動作モード

旧バージョンからCosminexus 07-60へ移行する場合の，J2EEサーバの動作モードの対応を次の表に示します。

表A-1　移行時のJ2EEサーバの動作モードの対応

移行前の旧バージョンでのJ2EEサーバの動作モード
移行後のJ2EEサーバの動作モード

アドバンスドモード
スタンダードモード
1.4モード

ベーシックモード
ベーシックモード

なお，ベーシックモードは，互換用のサーバの動作モードであり，1.4モードに比べて，使用できる機能に制限があります。J2EEサーバの動作モードとしては，1.4モードを使用することをお勧めします。

(3)　移行時に引き継がれる情報

Cosminexusを旧バージョンから07-60に移行する場合，旧バージョンで使用されていた，Cosminexusのインストールディレクトリ以下に配置される定義情報，DD情報，構成情報などのユーザ資産は，移行コマンドなどで必要に応じて自動変換され，07-60で引き続き使用されます（一部，手動での定義修正が必要な場合もあります）。Cosminexus Component Containerで引き継がれる定義情報，DD情報，構成情報などを次の表に示します。他構成ソフトウェアについては，それぞれのドキュメントを参照してください。

表A-2　Cosminexus Component Containerで移行時に引き継がれる情報

機能
引き継がれる情報
ファイル名称，または格納場所

J2EEサーバ
オプション定義ファイル
usrconf.cfg

ユーザプロパティファイル
usrconf.properties

セキュリティポリシーファイル
server.policy

Webアプリケーションプロパティファイル
hitachi_web.properties

作業ディレクトリ

定義情報

アプリケーション

DD情報

ユーザ・パスワード情報

オプション定義ファイルで指定されているejb.public.directoryの値。デフォルトは，次のとおり。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public以下

UNIXの場合
/opt/Cosminexus/CC/server/public以下

サーバ管理コマンド
オプション定義ファイル

Windowsの場合
usrconf.bat

UNIXの場合
usrconf

ユーザプロパティファイル
usrconf.properties

Webサーバ連携
Hitachi Webサーバ用リダイレクタ動作定義ファイル
mod_jk.conf

Microsoft IIS用リダイレクタ動作定義ファイル（Windowsだけのファイル）
isapi_redirect.conf※

Microsoft IIS用マッピング定義ファイル（Windowsだけのファイル）
uriworkermap.properties

ワーカ定義ファイル
workers.properties

Management Server
運用管理エージェントプロパティファイル
adminagent.properties

運用管理エージェント設定ファイル
adminagent.xml
別のファイル名称でバックアップされたあと，新規のファイルで上書きされます。
Management Serverの「論理サーバの起動／停止」で使用する環境変数を指定する機能を利用している場合，手動による定義修正が必要となります。

運用監視エージェント設定ファイル
mngagent.<実サーバ名>.properties

Management Server環境設定ファイル
mserver.properties

mngsvrutilコマンドのサーバ側定義ファイル
mngsvrutil.properties

構成情報定義

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config以下

UNIXの場合
/opt/Cosminexus/manager/config以下

Managementアクション実行用プロパティファイル
maction.properties

Management Server用メッセージマッピングファイル
mserver.jp1event.system.mapping.properties

J2EEサーバ共通用メッセージマッピングファイル
manager.jp1event.system.mapping.properties

J2EEサーバ個別用メッセージマッピングファイル
manager.<論理サーバ名>.jp1event.system.mapping.properties

J2EEアプリケーションの登録ディレクトリのデフォルトパス

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥apps以下

UNIXの場合
/opt/Cosminexus/manager/apps以下

統合ユーザ管理
JAASのコンフィグレーションファイル
jaas.conf

統合ユーザ管理のコンフィグレーションファイル
ua.conf

カスタムログインモジュール格納用ディレクトリ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥modules

UNIXの場合
/opt/Cosminexus/manager/modules

Smart Composer機能
サーバ設定プロパティファイル
cmxserver.properties

負荷分散機定義プロパティファイル
lb.properties

注※　Windows Server 2003の場合で，06-02以前のバージョンからアップグレードインストールしたときは，既存のMicrosoft IIS用リダイレクタ動作定義ファイルはisapi_redirect.conf.backという名称でバックアップされます。

(4)　移行時のJ2EEアプリケーションの動作

Cosminexusをアップグレードインストールする場合，または旧バージョンのJ2EEアプリケーションをインポートする場合には，次に示す処理で，自動的にJ2EEアプリケーションに含まれるEJBの再デプロイが実行されます。

開始状態のJ2EEアプリケーションが存在する状態でCosminexusをアップグレードインストールしたあとの初回J2EEサーバ起動時

停止状態のJ2EEアプリケーションが存在する状態でCosminexusをアップグレードインストールしたあとの初回J2EEアプリケーション開始時

旧バージョンのCosminexusでエクスポートした実行時情報を含む，開始状態のJ2EEアプリケーションのインポート時

旧バージョンのCosminexusでエクスポートした実行時情報を含む，停止状態のJ2EEアプリケーションをインポートしたあとの初回J2EEアプリケーション開始時

J2EEアプリケーションにEJBが含まれている場合は，旧バージョンのCosminexusで同一の処理を実行したときと比べて性能が悪くなります。

付録A.2　Cosminexusの移行の手順

次の手順に従って，旧バージョンからCosminexus 07-60へ移行してください。

旧バージョンからの仕様変更の確認

J2EEサーバの作業ディレクトリのディスク容量の確認

移行前の確認

定義などのバックアップ

他構成ソフトウェアの移行準備

全構成ソフトウェアのアップグレードインストール

J2EEサーバの移行コマンドの実行

リソースアダプタの移行コマンドの実行

Management Serverの移行コマンドの実行

手動による定義などの修正

他構成ソフトウェアの移行実施

移行後の確認

移行コマンドで作成されたバックアップ削除

このほか，セッションフェイルオーバ機能を使用している場合，Management Serverを使用しているシステムでは，手動でSFOサーバを移行する必要があります。詳細については，「付録A.10　手動による定義などの修正」を参照してください。なお，Management Serverを使用していないシステムでは，J2EEサーバの移行前に，SFOサーバの移行が必要です。SFOサーバの移行手順については，「付録A.13　セッションフェイルオーバ機能を使用している場合のバージョンアップ」を参照してください。

＜この項の構成＞

(1)　旧バージョンからの仕様変更の確認

(2)　J2EEサーバの作業ディレクトリのディスク容量の確認

(3)　移行前の確認

(4)　定義などのバックアップ

(5)　他構成ソフトウェアの移行準備

(6)　全構成ソフトウェアのアップグレードインストール

(7)　J2EEサーバの移行コマンドの実行

(8)　リソースアダプタの移行コマンドの実行

(9)　Management Serverの移行コマンドの実行

(10)　手動による定義などの修正

(11)　他構成ソフトウェアの移行実施

(12)　移行後の確認

(13)　移行コマンドで作成されたバックアップ削除

(1)　旧バージョンからの仕様変更の確認

旧バージョンからの仕様変更を確認します。機能の変更や追加に伴い，旧バージョンで使用している機能，使用条件，使用方法によっては，次の作業が必要となります。

操作手順の変更

運用手順の変更

アプリケーション，およびDDの変更

なお，互換性を保つためのオプションが提供されている場合もありますが，推奨のオプションではありません。詳細については，「付録A.3　旧バージョンからの仕様変更の確認」を参照してください。

(2)　J2EEサーバの作業ディレクトリのディスク容量の確認

移行のために十分なディスク容量があるかを確認します。詳細については，「付録A.4　J2EEサーバの作業ディレクトリのディスク容量の確認」を参照してください。

(3)　移行前の確認

移行前にCosminexusの動作環境，動作状態などを確認します。詳細については，「付録A.5　移行前の確認」を参照してください。

(4)　定義などのバックアップ

移行前に定義ファイルなどをバックアップします。詳細については，「付録A.6　定義などのバックアップ」を参照してください。

(5)　他構成ソフトウェアの移行準備

次に示す構成ソフトウェア以外の，他構成ソフトウェアの移行を準備します。

Cosminexus Performance Tracer

Cosminexus Component Container

Cosminexus Manager

Cosminexus Component Transaction Monitor

移行の準備の詳細はそれぞれの他構成ソフトウェアのドキュメントを参照してください。なお，ここで準備した情報を基に，「(11)　他構成ソフトウェアの移行実施」で他構成ソフトウェアを移行してください。

(6)　全構成ソフトウェアのアップグレードインストール

使用しているCosminexusの全構成ソフトウェアをアップグレードインストールします。ただし，Cosminexus Version 6から移行する場合で，UNIX環境に次の構成ソフトウェアがインストールされているときは，これらの構成ソフトウェアを必ずアンインストールしてから，アップグレードインストールを実施してください。

Cosminexus Component Library

Cosminexus Manager

Cosminexus Web Services - Base

なお，インストール方法やインストール時の注意事項については，「2.2.1　インストール方法」を参照してください。また，Cosminexus Component Containerのアップグレードインストールの注意については，「2.2.1(1)(c)　アップグレードインストールの場合」を参照してください。

(7)　J2EEサーバの移行コマンドの実行

定義情報，DD情報などを継続して利用できるようにするため，J2EEサーバの移行コマンド（cjenvupdate）を実行します。詳細については，「付録A.7　J2EEサーバの移行コマンドの実行」を参照してください。

(8)　リソースアダプタの移行コマンドの実行

旧バージョンでDB Connectorを使用していた場合，またはほかのリソースアダプタ（uCosminexus TP1 ConnectorおよびTP1/Message Queue-Access）をアップグレードインストールする場合，DB Connectorやリソースアダプタを入れ替えるためには，リソースアダプタの移行コマンド（cjrarupdate）を実行します。詳細については，「付録A.8　リソースアダプタの移行コマンドの実行」を参照してください。

(9)　Management Serverの移行コマンドの実行

旧バージョンでManagement Serverを使用していた場合，J2EEサーバの移行に合わせてManagement Serverの構成情報も移行するためには，Management Serverの移行コマンド（mngsvrupdate）を実行します。詳細については，「付録A.9　Management Serverの移行コマンドの実行」を参照してください。

(10)　手動による定義などの修正

手動で定義などを修正します。機能の変更，追加に伴い，互換性を保つためのオプションが提供されています。旧バージョンで使用している機能，使用方法，使用条件によっては，次の作業が必要となります。

ユーザプロパティファイルなどの定義ファイルの変更

Javaのユーザクラスパスの変更

環境変数の変更

詳細については，「付録A.10　手動による定義などの修正」を参照してください。

(11)　他構成ソフトウェアの移行実施

他構成ソフトウェアを移行します。移行の詳細はそれぞれの他構成ソフトウェアのドキュメントを参照してください。なお，「(5)　他構成ソフトウェアの移行準備」で準備した情報を基に移行を実施してください。

(12)　移行後の確認

移行後にCosminexusの動作確認を実施します。

(13)　移行コマンドで作成されたバックアップ削除

移行コマンドでは，各種バックアップを作成します。移行後の確認が完了したあと，バックアップを削除してください。詳細については，「付録A.11　移行コマンドで作成されたバックアップの削除」を参照してください。

付録A.3　旧バージョンからの仕様変更の確認

旧バージョンからの仕様変更を次の表に示します。

表A-3　旧バージョンからの仕様変更

分類
仕様変更の項目
07-50
07-10
07-00
06-71/
06-70
06-51/
06-50
06-02/
06-00

全体
(1)　J2SEのバージョン
－
－
－
○
○
○

(2)　TPBrokerの運用支援機能の非サポート
－
－
－
○
○
○

Management
Server
(3)　snapshotログの収集タイミング
－
－
－
－
－
○

(4)　運用管理エージェント停止時の動作
－
－
－
－
－
○

(5)　Management Server用のネーミングサービスの設定変更
－
－
－
○
○
○

(6)　旧バージョン互換用のWebサーバの扱い
－
○
○
○
○
○

J2EEサーバ
(7)　動作モードの変更
－
－
－
○
○
○

(8)　JavaVMのタイプ
－
－
－
－
－
○

(9)　Management Serverとの連携
－
－
－
○
○
○

(10)　JSPから生成されたサーブレット用コンパイラのバージョン
－
－
－
○
○
○

(11)　WebコンテナがサポートするServlet仕様のバージョン
－
－
－
○
○
○

(12)　デフォルトのエラーページの内容
－
－
－
－
○
○

(13)　Enterprise Beanの命名規則
－
－
－
○
○
○

(14)　インターセプタに関連するクラスのパッケージの変更
－
－
○
－
－
－

(15)　インターセプタに関連するInvocationContextの変更
－
－
○
－
－
－

(16)　アノテーションの指定方法の変更
－
－
○
－
－
－

(17)　Session Bean属性ファイルおよびEJB-JAR属性ファイルの変更
－
－
○
－
－
－

(18)　コネクションの共有機能の有効範囲
－
－
－
－
－
○

(19)　コネクションアソシエーションの有効化方法
－
－
－
－
－
○

(20)　コネクションスイーパの動作オプションの設定方法
－
－
－
－
－
○

(21)　コネクションプールのウォーミングアップ機能の設定方法
－
－
－
○
○
○

(22)　コネクションの障害検知，ネットワーク障害のタイムアウトの設定方法
－
－
－
○
○
○

(23)　コネクションの自動クローズのプロパティのデフォルト値
－
－
－
○
○
○

(24)　リソースアダプタのログのサイズと面数
－
－
－
○
○
○

(25)　リソースアダプタのプロパティのデフォルト値
－
－
－
○
○
○

(26)　ログ出力ディレクトリの構成変更
－
－
－
○
○
○

(27)　1.4モードのデータソース廃止
－
－
－
－
－
○

(28)　Naming Manager機能の削除
－
－
－
○
○
○

(29)　リロード機能適用範囲を指定するプロパティ値の変更
－
－
○
－
－
－

(30)　Cosminexus RM連携用のリソースアダプタのプロパティへの，CancelStatementプロパティの追加
－
○
○
○
○
－

(31)　リソース枯渇機能でのメモリ枯渇監視情報の計算式の変更
○
○
○
○
○
－

(32)　異なるJ2EEアプリケーションに含まれるリソースアダプタでの別名の重複指定
○
－
－
－
－
－

(33)　カスタムタグのスクリプト変数定義の変更
－
－
－
○
○
○

(34)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更
－
－
－
○
○
○

(35)　タグの属性値のExpressionチェックの変更
－
－
－
○
○
○

(36)　タグの属性値に指定するExpressionに関する変更
－
－
－
○
○
○

(37)　taglibディレクティブのprefix属性に関する変更
－
－
－
○
○
○

(38)　JSPの$の扱いについての変更
－
－
－
○
○
○

サーバ管理コマンド
(39)　サーバ管理コマンドの同時実行制御
－
－
－
－
－
○

(40)　J2EEサーバとの通信の時間監視
－
－
－
－
－
○

(41)　リデプロイ機能で実施するJ2EEアプリケーション属性の引き継ぎの動作
－
－
－
－
○
－

(42)　ログファイルの出力方法の変更
－
－
－
○
○
○

(43)　属性ファイルの<icon>タグの変更
－
－
－
○
○
○

(44)　属性ファイルのxml:lang属性の出力
－
○
－
○
○
○

(45)　Connector属性ファイルでのユーザIDおよびパスワードの非表示
－
－
○
○
○
○

(46)　メール属性ファイルの<reply-to>タグの削除
－
－
○
○
○
○

(47)　EJB-JAR属性ファイルの<interceptor-class>タグの出現パターンの変更
－
－
○
－
－
－

(48)　Connector属性ファイルでのXA_OPEN文字列の非表示
－
○
○
○
○
○

(49)　Connector属性ファイルの構造変更
－
○
○
○
○
○

(50)　属性ファイル中に指定されたメソッドのチェック
－
○
○
○
○
○

(51)　Connector属性ファイルの<config-property>タグに指定できるプロパティの並び順の変更
－
○
○
○
○
○

(52)　サーバマネジャ，ユーザマネジャの削除
－
－
－
○
○
○

(53)　MessageDrivenBean属性ファイルでの指定必須要素の省略
○
○
○
○
○
－

EJBクライアント
(54)　RMI-IIOPスタブおよびRMI-IIOPインタフェースの取得方法
－
－
－
－
－
○

(55)　cjclstartapコマンドの仕様変更
－
－
○
○
－
－

（凡例）　○：仕様変更あり。　－：該当しない。

次に仕様変更の項目の詳細について説明します。なお，表の「仕様変更の項目」の項番は，説明の項番と対応しています。

＜この項の構成＞

(1)　J2SEのバージョン

(2)　TPBrokerの運用支援機能の非サポート

(3)　snapshotログの収集タイミング

(4)　運用管理エージェント停止時の動作

(5)　Management Server用のネーミングサービスの設定変更

(6)　旧バージョン互換用のWebサーバの扱い

(7)　動作モードの変更

(8)　JavaVMのタイプ

(9)　Management Serverとの連携

(10)　JSPから生成されたサーブレット用コンパイラのバージョン

(11)　WebコンテナがサポートするServlet仕様のバージョン

(12)　デフォルトのエラーページの内容

(13)　Enterprise Beanの命名規則

(14)　インターセプタに関連するクラスのパッケージの変更

(15)　インターセプタに関連するInvocationContextの変更

(16)　アノテーションの指定方法の変更

(17)　Session Bean属性ファイルおよびEJB-JAR属性ファイルの変更

(18)　コネクションの共有機能の有効範囲

(19)　コネクションアソシエーションの有効化方法

(20)　コネクションスイーパの動作オプションの設定方法

(21)　コネクションプールのウォーミングアップ機能の設定方法

(22)　コネクションの障害検知，ネットワーク障害のタイムアウトの設定方法

(23)　コネクションの自動クローズのプロパティのデフォルト値

(24)　リソースアダプタのログのサイズと面数

(25)　リソースアダプタのプロパティのデフォルト値

(26)　ログ出力ディレクトリの構成変更

(27)　1.4モードのデータソース廃止

(28)　Naming Manager機能の削除

(29)　リロード機能適用範囲を指定するプロパティ値の変更

(30)　Cosminexus RM連携用のリソースアダプタのプロパティへの，CancelStatementプロパティの追加

(31)　リソース枯渇機能でのメモリ枯渇監視情報の計算式の変更

(32)　異なるJ2EEアプリケーションに含まれるリソースアダプタでの別名の重複指定

(33)　カスタムタグのスクリプト変数定義の変更

(34)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更

(35)　タグの属性値のExpressionチェックの変更

(36)　タグの属性値に指定するExpressionに関する変更

(37)　taglibディレクティブのprefix属性に関する変更

(38)　JSPでの$の扱いの変更

(39)　サーバ管理コマンドの同時実行制御

(40)　J2EEサーバとの通信の時間監視

(41)　リデプロイ機能で実施するJ2EEアプリケーション属性の引き継ぎの動作

(42)　ログファイルの出力方法の変更

(43)　属性ファイルの<icon>タグの変更

(44)　属性ファイルのxml:lang属性の出力

(45)　Connector属性ファイルでのユーザIDおよびパスワードの非表示

(46)　メール属性ファイルの<reply-to>タグの削除

(47)　EJB-JAR属性ファイルの<interceptor-class>タグの出現パターンの変更

(48)　Connector属性ファイルでのXA_OPEN文字列の非表示

(49)　Connector属性ファイルの構造変更

(50)　属性ファイル中に指定されたメソッドのチェック

(51)　Connector属性ファイルの<config-property>タグに指定できるプロパティの並び順の変更

(52)　サーバマネジャ，ユーザマネジャの削除

(53)　MessageDrivenBean属性ファイルでの指定必須要素の省略

(54)　RMI-IIOPスタブおよびRMI-IIOPインタフェースの取得方法

(55)　cjclstartapコマンドの仕様変更

(1)　J2SEのバージョン

07-00以降で使用されているJ2SE 5.0は，07-00より前のJ2SE 1.4.2と異なる部分があります。J2EEアプリケーションのコンパイル時に，今までコンパイルできたJava言語仕様に違反する構文がエラーになることがあります。詳細については，J2SEのドキュメントを参照してください。

(2)　TPBrokerの運用支援機能の非サポート

07-00以降では，07-00より前まで提供していたTPBrokerの運用支援機能は使用できません。システムの各プロセスを一括起動，停止，および監視する場合には，Management Serverを使用してください。Management Serverを使用する場合には，Smart Composer機能や運用管理ポータルでシステムを構築してください。

(3)　snapshotログの収集タイミング

06-50以降では，障害検知時のsnapshotログの収集タイミングが変更されます。06-50より前までは，障害を検知したJ2EEサーバを停止後，snapshotログを収集していました。06-50以降では，障害を検知したときに，障害検知時コマンドによってsnapshotログを収集し，その後論理サーバを停止します。これによって，障害発生時のタイムリーなログが取得できるようになります。

注意事項

Management Server環境設定ファイル（mserver.properties）にcom.cosminexus.mngsvr.snapshot.collect.point=j2ee_restartを指定することで，06-50より前の動作に戻すことができますが，お勧めしません。

キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(4)　運用管理エージェント停止時の動作

06-50以降では，運用管理エージェント停止時の動作が変更されます。06-50より前までは，論理サーバを停止しないで運用管理エージェントを終了すると，稼働中の論理サーバを強制停止していました。06-50以降では，論理サーバを停止しないで運用管理エージェントを終了しても，稼働中の論理サーバはそのまま動作を続けます。運用管理エージェントを再起動することで，稼働中の論理サーバについての情報を引き継ぎ，論理サーバの管理を継続できます。運用管理エージェントを停止するときに論理サーバも停止させていた場合は，運用管理エージェントを停止する前に，その運用管理エージェントの稼働しているホスト上の論理サーバをすべて停止するように運用の手順を変更してください。

注意事項

運用管理エージェントのプロパティファイル（adminagent.properties）にadminagent.finalization.stop_servers=trueを指定することで，06-50より前の動作に戻すことができますが，お勧めしません。

キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(5)　Management Server用のネーミングサービスの設定変更

06-71まではManagement Server用にネーミングサービスを起動していましたが，07-00以降は，J2EEサーバのプロセス内で起動するRMIレジストリを利用します。このため，Management Server用のネーミングサービスが起動不要になりました。Management Serverのほかに論理ネーミングサービスを使用しているプロセスがない場合には，その論理ネーミングサービスを削除してください。また，Management Server用のネーミングサービスが起動不要になることで，ネーミングサービスのホストとポート番号なども設定不要になります。設定の変更方法については，「付録A.10(5)　Management Server用のネーミングサービスの設定変更」を参照してください。

(6)　旧バージョン互換用のWebサーバの扱い

06-71までは，Management Serverの運用管理ポータルで，論理サーバとして旧バージョン互換用のWebサーバを新規作成できました。07-00以降では，旧バージョン互換用のWebサーバは使用できますが，新規作成はできません。

なお，旧バージョン互換用のWebサーバを使用していた場合には，現バージョンのWebサーバへの移行をお勧めします。運用管理ポータルの「論理サーバの環境設定」のWebサーバ環境のセットアップで，現バージョンへ移行できます。Webサーバ環境のセットアップについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

(7)　動作モードの変更

J2EEサーバの動作モードが変更されて，06-71までの「アドバンスドモード」と「スタンダードモード」は，07-00以降は「1.4モード」となります。

06-71までの動作モード
07-00以降の動作モード

アドバンスドモード（1.3advanced）
スタンダードモード（1.3standard）
1.4モード（1.4）

ベーシックモード（1.3basic）
ベーシックモード（1.3basic）

括弧内の文字列は，usrconf.propertiesのejbserver.server.j2ee.featureキーの値です。

07-00より前から07-60へ移行する場合，07-00より前でejbserver.server.j2ee.feature=1.3standard，または，ejbserver.server.j2ee.feature=1.3advancedを指定していたときは，J2EEサーバの移行コマンドが自動的にejbserver.server.j2ee.feature=1.4に変更します。

(8)　JavaVMのタイプ

06-50より前では，J2EEサーバは，Java HotSpot(TM) Client VM上で動作していました。06-50以降，J2EEサーバは，Java HotSpot(TM) Server VM上で動作します。ただし，AIXおよびSolarisではJava HotSpot(TM) Server VMは未サポートです。

Java HotSpot(TM) Server VMでは，Java HotSpot(TM) Client VMと比較して，J2EEアプリケーションまたはバッチアプリケーションの実行性能が向上する場合がありますが，J2EEサーバ，J2EEアプリケーション，バッチサーバ，またはバッチアプリケーションを開始するときの起動性能が劣化する場合もあります。

注意事項

usrconf.cfgに定義するjvm.typeキーの値をclientに変更することで，J2EEサーバの使用するJavaVMをJava HotSpot(TM) Client VMに変更できます。通常は，Java HotSpot(TM) Server VMを使用することをお勧めします。キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。また，Java HotSpot(TM) Server VM，およびJava HotSpot(TM) Client VMの詳細については，J2SEのドキュメントを参照してください。

(9)　Management Serverとの連携

07-00以降では，Management Serverと連携するかどうかを設定するusrconf.propertiesのejbserver.instrumentation.enabledキーのデフォルト値がfalseからtrueに変更となります。

なお，ejbserver.instrumentation.enabledキーの指定がない場合，J2EEサーバの移行コマンドが自動的にejbserver.instrumentation.enabled=falseを追加します。

(10)　JSPから生成されたサーブレット用コンパイラのバージョン

07-00以降では，J2EEサーバは，Java SE 5.0のJava言語仕様に従ってJSPから生成されたサーブレットのソースファイルをコンパイルします。

注意事項

07-00より前と同様に，J2SE 1.2またはJ2SE 1.3のJava言語仕様に従ってJSPから生成されたサーブレットのソースファイルをコンパイルする場合は，J2EEサーバのusrconf.propertiesのwebserver.jsp.compile.backcompatキーに，1.2または1.3を設定します。J2SE 5.0のJava言語仕様のコンパイルでエラーが発生する場合だけ，1.2または1.3と設定することをお勧めします。

(11)　WebコンテナがサポートするServlet仕様のバージョン

Servlet APIでは，WebコンテナがサポートするServlet仕様のバージョン情報を取得できます。07-00以降では，WebアプリケーションのバージョンがServlet 2.2／JSP 1.1，またはServlet 2.3／JSP 1.2の場合でも，WebコンテナがサポートするServlet仕様のバージョンは，Servlet 2.4／JSP 2.0となります。このため，次のServlet APIでは，Servlet 2.4／JSP 2.0の情報を返します。

javax.servlet.ServletContextのgetMajorVersionおよびgetMinorVersionメソッド

javax.servlet.jsp.JspEngineInfoのgetSpecificationVersionメソッド

(12)　デフォルトのエラーページの内容

06-70より前までは，リクエスト処理時に発生したエラーをカスタマイズしない場合に出力されるデフォルトのエラーページに，製品名が出力されていましたが，06-70以降では製品名が出力されません。

(13)　Enterprise Beanの命名規則

07-00以降では，デフォルトパッケージにEnterprise Beanクラスを作成する場合，次に示す文字列で終わるクラスを作成しないでください。

_LocalHomeImpl

_LocalComponentImpl

_RemoteHomeImpl

_RemoteComponentImpl

_LocalBIProxyImpl

_LocalBIClientSideProxyImpl

_RemoteBIProxyInterface

_RemoteBIProxyImpl

_RemoteBIClientSideProxyImpl

_CallbackWrapperImpl

_InvocationContextImpl

(14)　インターセプタに関連するクラスのパッケージの変更

07-10以降では，インターセプタに関連する次のクラスのパッケージが，javax.ejbからjavax.interceptorに変更になります。

javax.ejb.AroundInvoke

javax.ejb.Interceptors

javax.ejb.ExcludeDefaultInterceptors

javax.ejb.ExcludeClassInterceptors

javax.ejb.InvocationContext

(15)　インターセプタに関連するInvocationContextの変更

07-10以降では，インターセプタに関連するInvocationContextに変更があります。変更点を次に示します。

getParametersメソッドおよびsetParametersメソッドの変更

setParametersメソッドで，ビジネスメソッドに適合しない引数を指定した場合，IllegalArgumentException例外が発生するようになります。

getParametersメソッドおよびsetParametersメソッドをライフサイクルコールバックメソッドの中で呼び出した場合，IllegalStateException例外が発生するようになります。

getContextDataメソッドの変更
getContextDataメソッドの返り値であるMapは，Genericsによって，<String, Object>に型指定されたMapに変更になります。

getBeanメソッドの変更
getBeanメソッドはgetTargetメソッドに変更になります。

(16)　アノテーションの指定方法の変更

07-10以降では，アノテーションの指定方法に変更があります。変更点を次に示します。

ビジネスインタフェースでの@Localおよび@Remoteアノテーションの指定
一つのビジネスインタフェースに@Localおよび@Remoteアノテーションを同時に指定することはできません。

ステートフルセッションビーンでの@Removeアノテーションの指定
ステートフルセッションビーンに@Removeアノテーションを指定したメソッドは，CMTでクライアントトランザクションを引き継ぐ場合や，BMTでトランザクションがコミットされる前であっても，呼び出しができるようになりました。

メソッドでの@Timeoutアノテーションの指定
Timer Serviceに関連する@Timeoutアノテーションを指定したメソッドで，public以外の修飾子が許容されます。

(17)　Session Bean属性ファイルおよびEJB-JAR属性ファイルの変更

07-10以降，Session Bean属性ファイルおよびEJB-JAR属性ファイルの，次に示すタグ名に変更があります。変更点を次の表に示します。

表A-4　Session Bean属性ファイルおよびEJB-JAR属性ファイルのタグ名の変更

07-00でのタグ名
07-10以降でのタグ名

<around-invoke-method>
<method-name>
<method-params>
<around-invoke>
<class>
<method-name>

<post-construct-method>
<method-name>
<method-params>
<post-construct>
<lifecycle-callback-class>
<lifecycle-callback-method>

<pre-destroy-method>
<method-name>
<method-params>
<pre-destroy>
<lifecycle-callback-class>
<lifecycle-callback-method>

<post-activate-method>
<method-name>
<method-params>
<post-activate>
<lifecycle-callback-class>
<lifecycle-callback-method>

<pre-passivate-method>
<method-name>
<method-params>
<pre-passivate>
<lifecycle-callback-class>
<lifecycle-callback-method>

(18)　コネクションの共有機能の有効範囲

06-50以降と06-50より前では，コネクションの共有機能の有効範囲が異なります。有効範囲がJ2EEコンポーネント内の場合は，サーブレット，JSP，Enterprise Beanなどの同一コンポーネントだけでコネクションが共有されます。有効範囲がJ2EEコンポーネントをわたる場合は，J2EEコンポーネント間でローカル呼び出しした場合，呼び出された複数のJ2EEコンポーネントにわたってコネクションが共有されます。

06-50以降，ローカルトランザクション内でのコネクションシェアリングが複数のJ2EEコンポーネントにわたって有効となります。06-50より前では，ローカルトランザクション内でのコネクションシェアリングは，J2EEコンポーネント内だけで有効で，J2EEコンポーネントをわたった場合はコネクションアソシエーションが有効でした。

また，06-50以降，グローバルトランザクション内でコネクションシェアリングが複数のJ2EEコンポーネントにわたって有効となります。06-50より前では，トランザクション内でのコネクションシェアリングはJ2EEコンポーネント内だけで有効で，J2EEコンポーネントをわたった場合はコネクションアソシエーションが有効でした。ただし，コネクションアソシエーションが有効になるのは，ejbserver.connectionpool.xatx.association=trueが指定された場合に限ります。

コネクションの共有機能については，マニュアル「Cosminexus　機能解説」のコネクションシェアリング・アソシエーションに関する説明を参照してください。

(19)　コネクションアソシエーションの有効化方法

06-50以降，コネクションアソシエーションを有効にするプロパティがローカルトランザクションとグローバルトランザクションで統一されたので，ユーザプロパティファイルにはejbserver.connectionpool.association.enabledキーを指定します。06-50より前では，コネクションアソシエーションはローカルトランザクションの場合は常に有効で，グローバルトランザクションの場合はejbserver.connectionpool.xatx.association.enabledキーで有効／無効の切り替えができました。

06-50より前で，ユーザプロパティファイルにejbserver.connectionpool.xatx.association.enabled=trueを指定していた場合は，J2EEサーバの移行コマンドがejbserver.connectionpool.association.enabled=trueに自動的に変換します。変換後に取得したConnector属性ファイルと旧バージョンでのプロパティの対応関係を次に示します。

旧バージョンでの条件 | 変換後のユーザプロパティ
ejbserver.connectionpool.xatx.association.enabled=trueの指定がある場合 | ejbserver.connectionpool.association.enabled=true

コネクションの共有機能については，マニュアル「Cosminexus　機能解説」のコネクションシェアリング・アソシエーションに関する説明を参照してください。

(20)　コネクションスイーパの動作オプションの設定方法

06-50以降，J2EEサーバのコネクションプーリングでのコネクションスイーパの監視時間，および監視間隔をリソースアダプタ単位に設定できます。06-50より前では，ユーザプロパティファイルにejbserver.connectionpool.connection.timeout，およびejbserver.connectionpool.sweeper.intervalキーを指定することで，それぞれ監視時間，および監視間隔をJ2EEサーバ単位に設定していました。06-50以降，Connector属性ファイルの<property>タグで，ConnectionTimeout，またはSweeperIntervalに指定します。

06-50より前で，監視時間と監視間隔をそれぞれejbserver.connectionpool.connection.timeout，およびejbserver.connectionpool.sweeper.intervalキーに指定していた場合は，J2EEサーバの移行コマンドが自動的に変換します。旧バージョンでのプロパティと，変換後にcjgetrarpropコマンドで取得したConnector属性ファイルの値の対応関係は次のとおりです。

旧バージョンでの条件
変換後のConnector属性ファイルの値

ejbserver.connectionpool.connection.timeoutに値が指定されている場合

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-name>

値

ConnectionTimeout

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-value>

値

[値]

ejbserver.connectionpool.sweeper.intervalに値が指定されている場合

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-name>

値

SweeperInterval

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-value>

値

[値]

コネクションスイーパについては，マニュアル「Cosminexus　機能解説」を参照してください。

(21)　コネクションプールのウォーミングアップ機能の設定方法

07-00以降では，J2EEサーバのコネクションプールのウォーミングアップを有効にするかどうかをリソースアダプタ単位に設定します。

07-00より前では，usrconf.propertiesにejbserver.connectionpool.warmupキーを指定してJ2EEサーバ単位に設定していました。07-00以降は，Connector属性ファイルの<property>タグで，Warmupを設定します。

ejbserver.connectionpool.warmupキーからConnector属性ファイルの<property>タグへの設定変更は，J2EEサーバの移行コマンドが自動的に移行します。

(22)　コネクションの障害検知，ネットワーク障害のタイムアウトの設定方法

07-00以降では，J2EEサーバのコネクションの障害検知のタイムアウト，およびネットワーク障害のタイムアウトをリソースアダプタ単位に設定します。

07-00より前では，usrconf.propertiesにejbserver.connectionpool.validation.timeout.enabledキー，およびejbserver.connectionpool.NetworkFailureTimeout.enabledキーを指定してJ2EEサーバ単位に設定していました。07-00以降は，Connector属性ファイルの<property>タグで，NetworkFailureTimeoutを設定します。

ejbserver.connectionpool.validation.timeout.enabledキー，およびejbserver.connectionpool.NetworkFailureTimeout.enabledキーからConnector属性ファイルの<property>タグへの設定変更は，J2EEサーバの移行コマンドが自動的に移行します。

(23)　コネクションの自動クローズのプロパティのデフォルト値

07-00以降，Webコンテナによるコネクションの自動クローズ機能は，デフォルトで有効となり，usrconf.propertiesに次のキーが設定されます。

ejbserver.webj2ee.connectionAutoClose.enabled=true

J2EEサーバの移行コマンドを使用して移行する場合には，旧バージョンでの設定値が有効になります。

(24)　リソースアダプタのログのサイズと面数

07-00以降では，usrconf.propertiesのキーで指定していたリソースアダプタのログのサイズと面数のデフォルト値が次のように変更されます。

ejbserver.connector.logwriter.filesize=2097152

ejbserver.connector.logwriter.filenum=4

アップグレードインストールの場合には，旧バージョンでの設定値が有効になります。

(25)　リソースアダプタのプロパティのデフォルト値

07-00以降，リソースアダプタのプロパティを定義する，Connector属性ファイルのデフォルト値が変更されます。

コネクションプーリング機能
07-00以降，コネクションプーリング機能はデフォルトで有効となり，Connector属性ファイルの<property>タグで次の値が設定されます。

MaxPoolSize=10

MinPoolSize=10

J2EEサーバの移行コマンドを使用して移行する場合には，旧バージョンでの設定値が有効になります。

コネクションの障害検知機能
07-00以降，コネクションの障害検知機能はデフォルトで有効となり，Connector属性ファイルの<property>タグで次の値が設定されます。

ValidationType=1

J2EEサーバの移行コマンドを使用して移行する場合には，旧バージョンでの設定値が有効になります。

データベースへの接続試行のタイムアウト
07-00以降，データベースへの接続試行のタイムアウトのデフォルト値が0秒から8秒に変更となり，Connector属性ファイルの<config-property>タグで次の値が設定されます。

loginTimeout=8（秒）

Cosminexus DABroker Library用のDB Connectorのデフォルト値は変更ありません。
J2EEサーバの移行コマンドを使用して移行する場合には，旧バージョンでの設定値が有効になります。

(26)　ログ出力ディレクトリの構成変更

07-00以降では，ログファイルの出力ディレクトリ構成が変更になり，保守用ログの出力先ディレクトリ構成が変更されました。

07-00より前から07-60へ移行する場合は，J2EEサーバの移行コマンドが自動的にejb.server.log.mode=6を設定するため，07-00より前のログファイルの出力ディレクトリ構成で保守用ログが出力されます。

(27)　1.4モードのデータソース廃止

06-50以降，1.4モード（06-71までのスタンダードモード，アドバンスドモード）のJ2EEサーバのデータソースが廃止になり，DB Connectorだけが利用できるようになりました。そのため，データソースを使用していた場合は，操作手順，運用手順が変更になります。なお，ベーシックモードでは引き続きデータソースだけが利用できます。

06-50より前で，データソースを使用していた場合，J2EEサーバの移行コマンドがデータソースをDB Connectorへ変換します。変換後にコマンドで取得したConnector属性ファイルと旧バージョンでコマンドを使用して取得したデータソース属性ファイルの対応関係を表に示します。表A-5から表A-7は，変換後にcjgetrarpropコマンドで取得したConnector属性ファイルの値を示します。表A-5から表A-7の「値」の列の括弧付きの数字は，表A-8または表A-9の括弧付きの数字に指定されていた値が設定されることを意味します。「デフォルト」はデフォルト値が設定されることを意味します。

表A-5　変換後にcjgetrarpropコマンドを使用して取得したConnector属性ファイル

タグ名 | 値
<hitachi-connector-property> | －
| <description> | 表A-8の(1)
| <display-name> | 表A-8の(2)
| <icon> | －
|  | <small-icon> | デフォルト
|  | <large-icon> | デフォルト
| <vender-name> | デフォルト
| <spec-version> | デフォルト
| <eis-type> | デフォルト
| <version> | デフォルト
| <license> | －
|  | <license-required> | デフォルト
| <resourceadaptor> | －
|  | <managedconnectionfactory-class> | デフォルト
|  | <connectionfactory-interface> | デフォルト
|  | <connectionfactory-impl-class> | デフォルト
|  | <connection-interface> | デフォルト
|  | <connection-impl-class> | デフォルト
|  | <transaction-support> | デフォルト
|  | <config-property> | －
|  |  | <description> | デフォルト
|  |  | <config-property-name> | 指定されるプロパティについては表A-6参照
|  |  | <config-property-type> | デフォルト
|  |  | <config-property-value> | 指定される値については表A-6参照
|  | <reauthentication-support> | －
|  | <security-permission> | －
|  |  | <description> | デフォルト
|  |  | <security-permission-spec> | デフォルト
| <runtime> | －
|  | <property> | －
|  |  | <property-name> | 指定されるプロパティについては表A-7参照
|  |  | <property-type> | デフォルト
|  |  | <property-value> | 指定される値については表A-7参照
|  |  | <property-default-value> | デフォルト

表A-6　Connector属性ファイルの<config-property>タグに指定されるプロパティと値

<config-property-name>タグに指定されるプロパティ | <config-property-value>タグに指定される値
loginTimeout | 表A-9の(12)
networkProtocol | 表A-9の(13)
serverName | 表A-9の(14)
portNumber | 表A-9の(15)
databaseName | 表A-9の(16)
description | 表A-9の(17)
DBHostName | 表A-9の(18)
DBEnv | 表A-9の(19)
encodLang | 表A-9の(20)
JDBC_IF_TRC | 表A-9の(21)
SV_EVENT_TRC | 表A-9の(22)
TRC_NO | 表A-9の(23)
uapName | 表A-9の(24)
bufSize | 表A-9の(25)
rowSize | 表A-9の(26)
OSAuthorize | 表A-9の(27)
HiRDBCursorMode | 表A-9の(28)
blockUpdate | 表A-9の(29)
executeDirectMode | 表A-9の(30)
SQLWarningIgnore | 表A-9の(31)
LONGVARBINARY_Access | 表A-9の(32)
XAOpenString | 表A-9の(33)
XACloseString | 表A-9の(34)
RMID | 表A-9の(35)
XAThreadMode | 表A-9の(36)
XALocalCommitMode | 表A-9の(37)
PreparedStatementPoolSize | 0
CallableStatementPoolSize | 0
CancelStatement | false
logLevel | デフォルト

表A-7　Connector属性ファイルの<property>タグに指定されるプロパティと値

<property-name>タグに指定されるプロパティ | <property-value>タグに指定される値
MinPoolSize | 表A-8の(3)
MaxPoolSize | 表A-8の(4)
LogEnabled | デフォルト
User | 表A-9の(38)
Password | 表A-9の(39)
ValidationType | デフォルト
ValidationInterval | デフォルト
RetryCount | 表A-8の(10)
RetryInterval | 表A-8の(11)
ConnectionTimeout | ejbserver.connectionpool.connection.timeoutに値が指定されている場合はその値。指定されていない場合はデフォルト。
SweeperInterval | ejbserver.connectionpool.sweeper.intervalに値が指定されている場合はその値。指定されていない場合はデフォルト。
RequestQueueEnable | false
RequestQueueTimeout | デフォルト
WatchEnabled | デフォルト
WatchInterval | デフォルト
WatchThreshold | デフォルト
WatchWriteFileEnabled | デフォルト

表A-8　旧バージョンでcjgetrespropコマンドによって取得したデータソース属性ファイル

タグ名 | 項目番号
<hitachi-datasource-property> | －
| <description> | (1)
| <display-name> | (2)
| <property> | －
|  | <name> | 指定されるプロパティについては表A-9参照
|  | <XADataSource> | 指定される値については表A-9参照
| <PoolConfiguration> | －
|  | <MinimumSize> | (3)
|  | <MaximumSize> | (4)
|  | <Threshold> | (5)
|  | <GrowthIncrement> | (6)
|  | <WaitTimeout> | (7)
|  | <ConnectionTimeout> | (8)
|  | <SweeperInterval> | (9)
|  | <RetryCount> | (10)
|  | <RetryInterval> | (11)

表A-9　データソース属性ファイルの<property>タグに指定されるプロパティ

<name>タグに指定されるプロパティ | <XADataSource>タグに指定される値
LoginTimeout | (12)
NetworkProtocol | (13)
ServerName | (14)
PortNumber | (15)
DatabaseName | (16)
Description | (17)
DBHostName | (18)
DBEnv | (19)
EncodLang | (20)
JDBC_IF_TRC | (21)
SV_EVENT_TRC | (22)
TRC_NO | (23)
UapName | (24)
BufSize | (25)
RowSize | (26)
OSAuthorize | (27)
HiRDBCursorMode | (28)
BlockUpdate | (29)
ExecuteDirectMode | (30)
SQLWarningIgnore | (31)
LONGVARBINARY_Access | (32)
XAOpenString | (33)
XACloseString | (34)
RMID | (35)
XAThreadMode | (36)
XALocalCommitMode | (37)
User | (38)
Password | (39)

なお，移行コマンドでデータソースからDB Connectorへ変換するときに，すでに同一表示名称（display-name）のDB Connector，またはリソースアダプタが存在した場合には，表示名称の最後に連番を付与し，表示名称を一意にします。DB Connectorによる接続については，マニュアル「Cosminexus　機能解説」を参照してください。

(28)　Naming Manager機能の削除

07-00以降では，07-00より前まで提供していたNaming Manager機能（別名付与とクラスタ化）は使用できません。この機能を使用していた場合は，次に示す機能を使用するように変更してください。

別名付与
EJBホームオブジェクトリファレンスに別名を付ける場合は，ネーミング管理機能のユーザ指定名前空間機能を使用してください。ユーザ指定名前空間機能については，マニュアル「Cosminexus　機能解説」のJNDI名前空間へのオブジェクトのバインドとルックアップに関する説明を参照してください。

クラスタ化
複数のEJBホームオブジェクトリファレンスの中からラウンドロビンのポリシーで選択されたものを検索する場合は，ネーミング管理機能のラウンドロビンポリシーによるCORBAネーミングサービスの検索機能を使用してください。
ラウンドロビンポリシーによるCORBAネーミングサービスの検索については，マニュアル「Cosminexus　機能解説」を参照してください。

(29)　リロード機能適用範囲を指定するプロパティ値の変更

07-10以降，J2EEアプリケーションのリロード機能適用範囲を設定する，usrconf.propertiesのejbserver.deploy.context.reload_scopeキーのデフォルト値が変更になります。07-00では，デフォルト値は「none」でしたが，07-10以降は「app」に変更になります。

なお，移行コマンドを使用して07-00以前から移行する場合は，既定値が有効になります。

(30)　Cosminexus RM連携用のリソースアダプタのプロパティへの，CancelStatementプロパティの追加

07-50以降では，Cosminexus RM連携用のリソースアダプタ（DB Connector for Cosminexus RM）で，ステートメントキャンセル機能がデフォルトで有効になります。次に示すRARファイルのConnector属性ファイルの<config-property>タグに，「CancelStatement=true」が追加されます。

DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar

DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar

DBConnector_DABJ_CP_Cosminexus_RM.rar

DBConnector_DABJ_XA_Cosminexus_RM.rar

DBConnector_Oracle_CP_Cosminexus_RM.rar

DBConnector_Oracle_XA_Cosminexus_RM.rar

なお，07-10以前から移行する場合は，「CancelStatement=false」が設定されます。

(31)　リソース枯渇機能でのメモリ枯渇監視情報の計算式の変更

07-60以降，リソース枯渇監視機能のメモリ枯渇監視情報として出力されるRate2の値の計算式が変更になります。

07-50以前
Rate2の値＝New領域消費サイズ／Old領域空きサイズ×100（%）

07-60以降
Rate2の値＝New領域合計サイズ／Old領域最大空きサイズ×100（%）

(32)　異なるJ2EEアプリケーションに含まれるリソースアダプタでの別名の重複指定

07-50以前では，異なるJ2EEアプリケーションに含まれるリソースアダプタであっても，すでに別のオブジェクトが使用している別名は指定できませんでした。

07-60以降では，異なるJ2EEアプリケーションに含まるリソースアダプタの場合に，すでに同じ名称が指定されている別名でも指定できます。

(33)　カスタムタグのスクリプト変数定義の変更

07-00以降と07-00より前では，複数のカスタムタグで，スクリプト変数名とスクリプト変数のスコープが重複した場合に，JSPファイルのコンパイル結果が異なります。

07-00より前の場合
JSPファイルのコンパイルでコンパイルエラーが発生します。

07-00以降の場合
JSPファイルのコンパイルでコンパイルエラーは発生しません。
この場合，JSPトランスレーション下位互換機能を使用すると，JSPファイルのコンパイル結果が07-00より前と同じになります。

(34)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更

07-00以降と07-00より前では，<jsp:useBean>タグのclass属性に対して，インスタンス化できないクラス名を指定した場合に，JSPファイルのコンパイル結果が異なります。

07-00より前の場合
JSPファイルのコンパイルでコンパイルエラーは発生しません。

07-00以降の場合
JSPファイルのコンパイルでコンパイルエラーが発生します。
この場合，JSPトランスレーション下位互換機能を使用すると，JSPファイルのコンパイル結果が07-00より前と同じになります。

(35)　タグの属性値のExpressionチェックの変更

07-00以降と07-00より前では，Expressionが指定可能な属性以外にExpressionを指定したタグを含むJSPファイルの場合に，コンパイル結果が異なります。

07-00より前の場合
JSPファイルのコンパイルでコンパイルエラーは発生しません。

07-00以降の場合
JSPファイルのコンパイルでコンパイルエラーが発生します。
この場合，JSPトランスレーション下位互換機能を使用すると，JSPファイルのコンパイル結果が07-00より前と同じになります。

(36)　タグの属性値に指定するExpressionに関する変更

07-00以降と07-00より前では，タグの属性値が，「"<%=」または「'<%=」で開始して，「%>"」または「%>'」で終了していない場合（例えば，「%>」と「"」または「'」の間に，任意の文字列があるような場合）に，JSPファイルのコンパイル結果が異なります。

07-00より前の場合
JSPファイルのコンパイルでコンパイルエラーは発生しません。

07-00以降の場合
JSPファイルのコンパイルでコンパイルエラーが発生します。
この場合，JSPトランスレーション下位互換機能を使用すると，JSPファイルのコンパイル結果が07-00より前と同じになります。

(37)　taglibディレクティブのprefix属性に関する変更

07-00以降と07-00より前では，taglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述している場合に，JSPファイルのコンパイル結果が異なります。

07-00より前の場合
JSPファイルのコンパイルでコンパイルエラーは発生しません。

07-00以降の場合
JSPファイルのコンパイルでコンパイルエラーが発生します。
この場合，JSPトランスレーション下位互換機能を使用すると，JSPファイルのコンパイル結果が07-00より前と同じになります。

(38)　JSPでの$の扱いの変更

07-00以降，JSP仕様では"$"が予約語になっています。

JSPファイル内に"¥$"と記述した場合は，エスケープシーケンスによって"$"と出力されます。"¥$"と出力したい場合には，"¥¥$"と記述してください。

(39)　サーバ管理コマンドの同時実行制御

06-50以降では，排他制御によるサーバ管理コマンドの同時実行制御は，J2EEサーバごとに行います。また，サーバ管理コマンドを，処理内容に応じて「更新」，「参照」，「特権」と三つの系統に分別し，系統ごとに排他制御します。06-50より前では，排他制御によるサーバ管理コマンドの同時実行制御は，CORBAネーミングサービスごとに行っていました。

(a)　サーバ管理コマンドの同時実行の制約

06-50より前では，サーバ管理コマンドは，CORBAネーミングサービスごとに同時に一つしか実行できなかったため，同じJ2EEサーバに対してサーバ管理コマンドを同時に実行すると一方のサーバ管理コマンドはエラー終了していました。また，複数のJ2EEサーバを同じCORBAネーミングサービスで管理し，異なるJ2EEサーバに対してサーバ管理コマンドを同時に実行する場合でも，一方のサーバ管理コマンドはエラー終了していました。06-50以降では，同じJ2EEサーバ上で系統が異なるサーバ管理コマンドを同時に実行できます。

同系統のサーバ管理コマンドを同時に実行した場合，あとに実行したサーバ管理コマンドは，最初に実行したサーバ管理コマンドの終了を待ちます。また，同じCORBAネーミングサービスが複数のJ2EEサーバを管理する場合，異なるJ2EEサーバに対してサーバ管理コマンドを同時に実行できます。コマンドの分類については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。また，サーバ管理コマンドの実行と排他制御については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(b)　時間監視によるロック強制解除

06-50より前では，サーバ管理コマンドがエラーなどによって不正終了し，排他制御のロックが解除されないで不正な状態になった場合，cjresetsvコマンドを実行してロックを強制解除する必要があります。06-50以降では，J2EEサーバとサーバ管理コマンド間の通信間隔の時間を監視し，排他制御のためのロックを強制解除します（J2EEサーバとサーバ管理コマンドは複数回通信します）。これによって，サーバ管理コマンドが処理の途中に不正終了した場合でも，時間監視によってロックが強制解除されます。ただし，時間監視によってロックが強制解除されたあと，サーバ管理コマンドがJ2EEサーバと通信した場合，コマンドはエラー終了します。このような場合には，時間監視によるロック強制解除のタイムアウト値を変更したあとに，サーバ管理コマンドを再実行してください。usrconf.propertiesのejbserver.deploy.exclusive.lockAliveIntervalキーに値を指定することで，タイムアウト値を変更できます。キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(c)　排他制御のロック強制解除コマンド

06-50より前では，cjresetsvコマンドのオプションにCORBAネーミングサービスを指定し，排他制御のロックを強制解除していました。06-50以降では，cjresetsvコマンドのオプションにJ2EEサーバを指定し，排他制御のロックを強制解除します。コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(40)　J2EEサーバとの通信の時間監視

06-50以降では，サーバ管理コマンドとJ2EEサーバ間の通信は時間監視され，デフォルトのタイムアウト値は，180（秒）です。06-50より前では，時間監視されません。

注意事項

06-50より前と同様にJ2EEサーバとの通信を時間監視しない場合には，サーバ管理コマンドのusrconf.propertiesのejbserver.rmi.request.timeoutキーに0を設定します。適切な値を設定して，時間監視機能を使用することをお勧めします。キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(41)　リデプロイ機能で実施するJ2EEアプリケーション属性の引き継ぎの動作

cjreplaceappコマンドを使用してリデプロイを実施する際に，入れ替え前のJ2EEアプリケーションの情報を，入れ替え後のJ2EEアプリケーションに引き継ぎますが，Cosminexusのバージョンによって引き継ぐ情報が異なります。

06-70より前のバージョンでは，J2EEアプリケーションのランタイム属性※だけを引き継ぎます。06-70以降のバージョンでは，デフォルトでは，J2EEアプリケーションのすべての属性情報を引き継ぎます。06-70より前のバージョンと同じように，ランタイム属性だけを引き継ぎたい場合は，オプションを指定してcjreplaceappコマンドを実行します。コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

注※

属性ファイルには，DD（application.xml，ejb-jar.xml，ra.xml，web.xml）の定義と属性ファイル独自の定義が設定できます。属性ファイル独自の定義のことをランタイム属性といいます。

(42)　ログファイルの出力方法の変更

07-00以降，サーバ管理コマンドのログファイルの出力方法が変更されます。07-00より前までは，コマンドのプロセスごとにログファイルを生成してログを出力しましたが，07-00以降では，コマンドの複数プロセスで共通のログファイルにログを出力します。

07-00より前から07-60へ移行する場合，J2EEサーバの移行コマンドが自動的にejbserver.cui.logfile.compatible=trueを設定するため，07-00より前のログファイルの出力方法でログが出力されます。

(43)　属性ファイルの<icon>タグの変更

07-00以降，次の属性ファイルで，<icon>タグの下位に，<small-icon>タグと<large-icon>タグが出力されるようになりました。

アプリケーション属性ファイル

EJB-JAR属性ファイル

Session Bean属性ファイル

Entity Bean属性ファイル

WAR属性ファイル

サーブレット属性ファイル

Messsage-driven Bean 属性ファイル

フィルタ属性ファイル

(44)　属性ファイルのxml:lang属性の出力

07-00以降，次の属性ファイルで，<description>，<display-name>，および<icon>タグにxml:lang属性が出力されるようになりました。xml:lnag属性のデフォルト値は「en」です。なお，バージョンによって，xml:lang属性が出力される属性ファイルが異なります。

07-00以降

EJB-JAR属性ファイル

Session Bean属性ファイル

Entity Bean属性ファイル

WAR属性ファイル

サーブレット属性ファイル

Messsage-driven Bean 属性ファイル

フィルタ属性ファイル

07-50以降

Connector属性ファイル

(45)　Connector属性ファイルでのユーザIDおよびパスワードの非表示

07-10以降では，cjgetrespropコマンドまたはcjgetrarpropコマンドでのConnector属性ファイル取得時に，Connector属性ファイルの<property-name>タグの値として「User」または「Password」が設定されている場合，これらのタグに対応する<property-value>タグの値は，セキュリティ上の理由で表示されなくなりました。<property-name>タグの値として「User」または「Password」が設定されているタグの，<property-value>タグの値を変更する場合は，<property-value>タグを追加して変更後の値を設定してください。

(46)　メール属性ファイルの<reply-to>タグの削除

07-10以降，メール属性ファイルの<reply-to>タグは削除されました。<reply-to>タグは指定できません。

(47)　EJB-JAR属性ファイルの<interceptor-class>タグの出現パターンの変更

EJB-JAR属性ファイルの<interceptor-binding>直下の<interceptor-class>タグの出現パターンが変更されます。07-10より前では，<interceptor-class>タグの出現パターンは1回以上でした。07-10以降では，<interceptor-class>タグの出現パターンは０回以上になります。

(48)　Connector属性ファイルでのXA_OPEN文字列の非表示

07-50以降では，cjgetrespropコマンド，cjgetrarpropコマンド，またはcjgetapppropコマンドでConnector属性ファイル取得時に，Connector属性ファイルの<config-property-name>タグの値として「XAOpenString」が設定されている場合，このタグに対応する<config-property-value>タグの値は，セキュリティ上の理由で表示されなくなりました。<config-property-name>タグの値として「XAOpenString」が設定されているタグの，<config-property-value>タグの値を変更する場合は，<config-property-value>タグを追加して変更後の値を設定してください。

(49)　Connector属性ファイルの構造変更

07-50以降では，Connector属性ファイルの構造が変更され，<outbound-resourceadapter>タグ，および<outbound-resourceadapter>タグの<connection-definition>タグの下位に，次のタグが出力されるようになりました。

<outbound-resourceadapter>タグの下位に出力されるタグ

<transaction-support>タグ

<reauthentication-support>タグ

<outbound-resourceadapter>タグの<connection-definition>タグの下位に出力されるタグ

<managedconnectionfactory-class>タグ

<config-property>タグ

<connectionfactory-interface>タグ

<connectionfactory-impl-class>タグ

<connection-interface>タグ

<connection-impl-class>タグ

<connector-runtime>タグ

(50)　属性ファイル中に指定されたメソッドのチェック

07-50以降では，cjsetapppropコマンドまたはcjsetrespropコマンド実行時に，引数で指定された属性ファイル中の<container-transaction>，<ejb-method-observation-timeout>，または<ejb-transaction-timeout>タグで指定されたメソッドが，Enterprise Bean中にあるかどうかをチェックします。属性ファイル中のこれらのタグに指定されたメソッドが，Enterprise Bean中にない場合は，エラーとなります。

07-10より前から07-60へ移行する場合は，J2EEサーバの移行コマンドが自動的にejbserver.cui.checkmethod.compatible=trueを設定するため，07-10より前のメソッドのチェック方法でメソッドはチェックされます。

(51)　Connector属性ファイルの<config-property>タグに指定できるプロパティの並び順の変更

07-50以降では，Connector属性ファイルの<config-property>タグに指定できるプロパティの並び順が，一部変更になります。移行コマンドで07-10以前から移行する場合，<config-property>タグに指定できるプロパティの並び順は，07-50以降の並び順に変更されます。

(52)　サーバマネジャ，ユーザマネジャの削除

07-00より前までJ2EEアプリケーションやリソースの設定で使用されていたサーバマネジャ（cjadminsvコマンド）とユーザマネジャ（cjadminusrコマンド）は，07-00以降は使用できません。

J2EEアプリケーションやリソースを設定する場合には，サーバ管理コマンド，またはServer Plug-inを使用してください。なお，Server Plug-inはManagement Serverの利用が前提となるため，Smart Composer機能や運用管理ポータルでシステムを構築する場合だけ使用できます。

(53)　MessageDrivenBean属性ファイルでの指定必須要素の省略

07-60以降で，Connector 1.5仕様に準拠したリソースアダプタの場合，MessageDrivenBean属性ファイルの次に示す要素が省略できます。

<message-ref>-<connection-factory>

<message-ref>-<connection-destination>-<queue>

ただし，Cosminexus RMおよびTP1/Message Queue - Accessによるデータベース接続で，Message-driven Beanを使用する場合は，MessageDrivenBean属性ファイルでこれらの要素の指定は省略できません。この場合，MessageDrivenBean属性ファイルでこれらの要素の指定を省略しても，cjsetapppropコマンドでの属性設定時にはエラーになりませんが，Message-driven Beanを含むJ2EEアプリケーションの開始時にエラーとなります。

(54)　RMI-IIOPスタブおよびRMI-IIOPインタフェースの取得方法

06-50以降，アプリケーションのRMI-IIOPスタブおよびRMI-IIOPインタフェースを一括で取得する機能をサポートします。06-50より前では，RMI-IIOPスタブ，およびRMI-IIOPインタフェースをJ2EEサーバからダウンロードしていましたが，06-50以降では，cjgetstubsjarコマンドを使用して該当のファイルを一括で取得できます。コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(55)　cjclstartapコマンドの仕様変更

07-10以降，cjclstartapコマンドの仕様が変更になります。変更点を次に示します。

Javaオプション指定の追加
cjclstartapコマンドの引数にJavaオプションを指定できるようになりました。

デフォルトのログ出力先の変更
デフォルトのログ出力先は，07-10より前では，<Cosminexusのインストールディレクトリ>¥CC¥client¥logs（Windowsの場合）または/opt/Cosminexus/CC/client/logs（UNIXの場合）となっていました。07-10以降では，デフォルトのログ出力先は次の場所に変更になりました。

07-10以降のデフォルトのログ出力先

<cjclstartapコマンド実行ディレクトリ>/logs

ログファイル取得の追加
次に示すログファイルを取得できるようになりました。

ユーザ出力ログ

ユーザエラーログ

JavaVMの保守情報およびガーベージコレクションのログ

EJBコンテナの保守情報

起動プロセス標準出力情報

起動プロセス標準エラー情報

オプションの追加
ログ出力に関するオプションを追加しました。

ejb.client.log.directory

ejb.client.ejb.log

ejb.client.log.appid

ejb.client.log.stdout.enabled

なお，各オプションの詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（Javaアプリケーション用オプション定義ファイル）に関する説明を参照してください。

複数プロセスの起動抑止
同一のディレクトリ上で複数のプロセスを起動できません。

ログ出力先の共有不可
07-10以降で追加取得するログは，複数のプロセス間でログ出力先を共有できません。

付録A.4　J2EEサーバの作業ディレクトリのディスク容量の確認

J2EEサーバの作業ディレクトリ用に十分なディスク容量があるかを確認します。

旧バージョンからの移行で幾つかの移行コマンドを実行する必要がありますが，移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。バックアップはJ2EEサーバの作業ディレクトリ以下に作成されます。また，移行コマンドを実行すると，バックアップ分の容量に加えて，J2EEサーバの作業ディレクトリ自体のサイズも大きくなります。

これらの理由から，移行の前に作業ディレクトリに割り当てられているディスク領域の容量が十分かどうかを確認してください。バックアップと移行後の作業ディレクトリのサイズは次のとおりです。

なお，ここでのバックアップとは，バックアップ作業ディレクトリとバックアップRARディレクトリを示します。詳細については，「付録A.7　J2EEサーバの移行コマンドの実行」，および「付録A.8　リソースアダプタの移行コマンドの実行」を参照してください。

旧バージョンでのJ2EEサーバの作業ディレクトリのサイズがNバイトの場合，バックアップ領域のサイズは，次の計算式で算出してください。

N×（cjenvupdateコマンドによって作業ディレクトリが移行される場合は1，移行されない場合は0）＋N×（DB Connectorを使用している場合は1，使用していない場合は0）+Ｎ×（リソースアダプタを使用している場合は，バージョンアップするリソースアダプタの数）

また，旧バージョンでのJ2EEサーバの作業ディレクトリのサイズがNバイトの場合，作業ディレクトリ自体の増加分のサイズは次の計算式で算出してください。

N×（cjenvupdateコマンドによって作業ディレクトリが移行される場合は1，移行されない場合は0）＋N×（DB Connectorを使用している場合は1，使用していない場合は0）+Ｎ×（リソースアダプタを使用している場合は，バージョンアップするリソースアダプタの数）

注意事項

移行するためには，J2EEサーバの作業ディレクトリが割り当てられているディスクの空き容量が，バックアップ領域分と作業ディレクトリ自体の増加分を足した値よりも大きい必要があります。なお，移行が完了したあと，バックアップ領域は削除できます。

付録A.5　移行前の確認

移行前に，Cosminexusの動作環境，および動作状態を確認します。次に確認項目を示します。

運用管理サーバ（Management Serverだけ起動するマシン）を利用するシステム構成の場合，運用管理サーバのCosminexusは07-60に移行する必要があります。

旧バージョンのCosminexusが終了していることを確認してください。Cosminexusの全構成ソフトウェアを終了させます。

Microsoft IISを使用している場合は，Microsoft IISを終了させます。

Cosminexus 06-50より前で，J2EEサーバのスタンダードモード，アドバンスドモードでデータソースを使用していた場合には，移行する前に，セットアップされているすべてのJ2EEサーバで，インポートされているすべてのデータソースの設定が正しく行われていること，接続テストに成功することを必ず確認してください。正しく設定されていないために接続テストに失敗するデータソースは，削除するか，または設定を見直して接続テストに成功するようにしてください。
接続テストに失敗するデータソースが存在する状態で，アップグレードインストールした場合には，移行したDB ConnectorおよびJ2EEサーバが停止できなくなるので，注意してください。停止できなくなった場合は，保守員に連絡してください。

付録A.6　定義などのバックアップ

移行前に定義ファイルなどのバックアップを取ります。バックアップを取るディレクトリを次の表に示します。

表A-10　バックアップを取るディレクトリ

機能
バックアップを取るディレクトリ

Management Server／統合ユーザ管理

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager

UNIXの場合
/opt/Cosminexus/manager

J2EEサーバ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf
J2EEサーバ用作業ディレクトリ

UNIXの場合
/opt/Cosminexus/CC/server/usrconf
J2EEサーバ用作業ディレクトリ

サーバ管理コマンド

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥usrconf

UNIXの場合
/opt/Cosminexus/CC/admin/usrconf

Webサーバ連携

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector

UNIXの場合
/opt/Cosminexus/CC/web/redirector

付録A.7　J2EEサーバの移行コマンドの実行

ここでは，J2EEサーバの移行コマンドであるcjenvupdateコマンドの実行について説明します。

＜この項の構成＞

(1)　バックアップ作業ディレクトリ

(2)　J2EEサーバの移行方法

(1)　バックアップ作業ディレクトリ

J2EEサーバの移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。このマニュアルでは，バックアップされた作業ディレクトリのことを，バックアップ作業ディレクトリと呼びます。バックアップ作業ディレクトリには，移行前の情報（ファイル）が残ります。移行コマンドの実行が終了したとき，バックアップ作業ディレクトリは自動的に削除されません。

注意事項

Windowsで，作業ディレクトリが「・・・¥<ディレクトリ名>」の場合，バックアップ作業ディレクトリは，「・・・¥<ディレクトリ名>¥<ディレクトリ名>_old」になります。例えば，作業ディレクトリが「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」の場合，バックアップ作業ディレクトリは，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥public_old」になります。

UNIXで，作業ディレクトリが「・・・/<ディレクトリ名>」の場合，バックアップ作業ディレクトリは，「・・・/<ディレクトリ名>/<ディレクトリ名>_old」になります。例えば，作業ディレクトリが「/opt/Cosminexus/CC/server/public」の場合，バックアップ作業ディレクトリは，「/opt/Cosminexus/CC/server/public/public_old」になります。

作業ディレクトリの移行が必要ないバージョンからのバージョンアップの場合，cjenvupdateコマンドは作業ディレクトリの移行は行いません。この場合，バックアップ作業ディレクトリは作成されません。

(2)　J2EEサーバの移行方法

cjenvupdateコマンドを実行します。cjenvupdateコマンドの実行形式を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥cjenvupdate

UNIXの場合
/opt/Cosminexus/CC/server/bin/cjenvupdate

cjenvupdateコマンドを実行すると，作業ディレクトリおよびユーザ定義ファイルが移行されます。なお，cjenvupdateコマンドのログは，06-00以降，次の場所に出力されます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs

UNIXの場合
/opt/Cosminexus/CC/logs

cjenvupdateコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

付録A.8　リソースアダプタの移行コマンドの実行

ここでは，リソースアダプタの移行コマンドであるcjrarupdateコマンドの実行について説明します。

＜この項の構成＞

(1)　バックアップRARディレクトリ

(2)　Cosminexus 06-00以降からの移行

(1)　バックアップRARディレクトリ

リソースアダプタの移行コマンドを実行すると，J2EEサーバの作業ディレクトリ内のファイルを変換する前にバックアップを作成します。このマニュアルでは，バックアップされた作業ディレクトリのことを，バックアップRARディレクトリと呼びます。バックアップRARディレクトリには，移行前の情報（ファイル）が残ります。リソースアダプタの移行コマンドの実行が終了したとき，バックアップRARディレクトリは自動的に削除されません。

また，リソースアダプタの移行コマンドを複数回実行する場合（例えば，DB Connector用に1回とuCosminexus TP1 Connector用に1回の合計2回実行する），バックアップRARディレクトリはコマンド実行ごとに生成され，最終的には複数残ります。

(a)　Windowsの場合

Windowsの場合のバックアップRARディレクトリの例，移行処理に失敗した場合に自動で回復する方法について説明します。

バックアップRARディレクトリの例
作業ディレクトリが「・・・¥<ディレクトリ名>」の場合，バックアップRARディレクトリは，「・・・¥<ディレクトリ名>¥rarupdate_bk」になります。例を次に示します。

作業ディレクトリが「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」の場合，バックアップRARディレクトリは「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk」になります。

作業ディレクトリが「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」で，すでにバックアップRARディレクトリ「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk」が作成されている場合，既存のバックアップディレクトリは「<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk_0000000[n]」（nは17けたの番号で年月日時間の情報）にリネームされたあと，新たにバックアップRARディレクトリが作成されます。

移行処理に失敗した場合に自動で回復する方法
移行処理に失敗した場合に自動で回復するには，cjrarupdateコマンドに引数-recoverfromを指定して実行してください。引数-recoverfromには，バックアップ格納先ディレクトリを指定します。バックアップ処理の開始時，および完了時には，メッセージが出力されます。また，引数-recoverfromに指定したバックアップ格納先ディレクトリが不正な場合，および回復処理に失敗した場合，エラーメッセージが出力されます。

(b)　UNIXの場合

UNIXの場合のバックアップRARディレクトリの例移行処理に失敗した場合に自動で回復する方法について説明します。

バックアップRARディレクトリの例
作業ディレクトリが「・・・/<ディレクトリ名>」の場合，バックアップRARディレクトリは，「・・・/<ディレクトリ名>/rarupdate_bk」になります。例を次に示します。

作業ディレクトリが「/opt/Cosminexus/CC/server/public」の場合，バックアップRARディレクトリは「/opt/Cosminexus/CC/server/public/rarupdate_bk」になります。

作業ディレクトリが「/opt/Cosminexus/CC/server/public」で，すでにバックアップRARディレクトリ「/opt/Cosminexus/CC/server/public/rarupdate_bk」が作成されている場合，既存のバックアップディレクトリは「/opt/Cosminexus/CC/server/public/rarupdate_bk_0000000[n]」（nは17けたの番号で年月日時間の情報）にリネームされたあと，新たにバックアップRARディレクトリが作成されます。

移行処理に失敗した場合に自動で回復する方法
移行処理に失敗した場合に自動で回復するには，cjrarupdateコマンドに引数-recoverfromを指定して実行してください。引数-recoverfromには，バックアップ格納先ディレクトリを指定します。バックアップ処理の開始時，および完了時には，メッセージが出力されます。また，引数-recoverfromに指定したバックアップ格納先ディレクトリが不正な場合，および回復処理に失敗した場合，エラーメッセージが出力されます。

(2)　Cosminexus 06-00以降からの移行

cjrarupdateコマンドを実行します。DB Connector，およびバージョンアップする各リソースアダプタに対して，一回ずつcjrarupdateコマンドを実行します。

cjrarupdateコマンドの実行形式を次に示します。

DB Connectorを使用している場合

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥cjrarupdate -type dbconnector

UNIXの場合
/opt/Cosminexus/CC/server/bin/cjrarupdate -type dbconnector

DB Connector以外のリソースアダプタを使用している場合

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥cjrarupdate -type rar -f <リソースアダプタのパス>

UNIXの場合
/opt/Cosminexus/CC/server/bin/cjrarupdate -type rar -f <リソースアダプタのパス>

なお，cjrarupdateコマンドのログは，次の場所に出力されます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥logs

UNIXの場合
/opt/Cosminexus/CC/logs

cjrarupdateコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

注意事項

cjrarupdateコマンドを同時に実行すると正しく環境が移行されないことがあります。コマンドを同時に実行しないでください。

複数のリソースアダプタを使用している場合，cjrarupdateコマンドを1回実行して，すべてのリソースアダプタを一括で移行できます。また，バックアップRARディレクトリのディレクトリパスを明示的に指定できます。

TP1/Message Queue-Accessを移行する場合に，新しいRARファイルが同一バージョンと認識されることがあります。その場合は-forceオプションを指定して強制的に移行処理を実行してください。

cjrarupdateコマンドに引数-recoverfromを指定して，J2EEアプリケーションに含めて使用するリソースアダプタを自動で回復する場合，移行処理に失敗したときに，回復が完了するまでJ2EEサーバに対する操作を実行しないでください。回復が完了する前にJ2EEサーバに対する操作を実行すると，回復処理が正しく実行されないことがあります。

付録A.9　Management Serverの移行コマンドの実行

ここでは，Management Serverの移行コマンドであるmngsvrupdateコマンドの実行について説明します。

Management Serverが動作するホストでmngsvrupdateコマンドを実行します。運用管理ドメイン内のすべてのホストを一括して変更します。mngsvrupdateコマンドの実行形式を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrupdate d2r

UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrupdate d2r

注意事項

mngsvrupdateコマンドを同時に実行すると正しく環境が移行されないことがあります。コマンドを同時に実行しないでください。

付録A.10　手動による定義などの修正

各旧バージョンから移行する場合に，手動で定義などの修正が必要な項目を次の表に示します。

表A-11　手動で定義などの修正が必要な項目

分類
修正項目
07-50
07-10
07-00
06-71/
06-70
06-51/
06-50
06-02/
06-00

Management
Server
(1)　論理サーバの設定情報の再読み込み
○
○
○
○
○
○

(2)　論理サーバの環境変数定義の再設定
○
○
○
○
○
○

(3)　論理サーバの起動順序，および前提となる論理サーバの変更
－
－
－
－
－
○

(4)　トランザクションサービスのインプロセス化
－
－
－
○
○
○

(5)　Management Server用のネーミングサービスの設定変更
－
－
－
○
○
○

(6)　JP1イベントメッセージマッピングファイルの再設定
○
○
○
○
○
○

(7)　Smart Composer機能の定義変更
○
○
○
○
○
－

(8)　論理サーバの起動／停止の設定の変更
－
－
－
○
○
○

(9)　論理サーバの環境設定情報の変更
－
－
－
○
○
○

(10)　J2EEアプリケーションとリソースの再インポート
○
○
○
－
○
○

(11)　snapshotログ収集先対象リストファイルの再設定
○
○
○
○
○
○

(12)　Management Serverおよび運用管理エージェントのサービス再設定
－
○
○
○
○
○

(13)　論理サーバごとの強制停止監視時間の設定の追加
○
○
○
○
○
－

J2EEサーバ
(14)　Unshareable指定時のコネクションアソシエーションのプロパティ追加
－
－
－
－
－
○

(15)　セキュリティポリシーファイルの変更
－
－
－
○
○
○

(16)　統合ユーザ管理のタグライブラリの入れ替え
－
－
－
○
○
○

(17)　デフォルトエラーページのスタックトレース表示
－
－
－
－
○
○

(18)　リダイレクタへのデータ送信処理のタイムアウト追加
－
－
－
○
○
○

(19)　ユーザスレッドの生成に必要な権限の追加
－
－
－
－
○
○

(20)　セッションIDへのサーバIDの付加
－
－
－
－
○
○

(21)　RMIレジストリが使用するポート番号の追加
－
－
－
○
○
○

SFOサーバ
(22)　SFOサーバの移行
－
○
○
○
○
－

Webサーバ連携
(23)　リダイレクタのログ出力先変更
－
－
－
－
－
○

(24)　Webコンテナへのデータ送信処理のタイムアウト追加
－
－
－
○
○
○

(25)　リダイレクタの保守用トレースログの面数変更
－
－
－
○
○
－

EJBクライアント
(26)　ログ出力先の設定
－
－
○
○
－
－

（凡例）　○：修正が必要。　－：該当しない。

次に修正項目の詳細について説明します。なお，表の「修正項目」の項番は，説明の項番と対応しています。

＜この項の構成＞

(1)　論理サーバの設定情報の再読み込み

(2)　論理サーバの環境変数定義の再設定

(3)　論理サーバの起動順序，および前提となる論理サーバの変更

(4)　トランザクションサービスのインプロセス化

(5)　Management Server用のネーミングサービスの設定変更

(6)　JP1イベントメッセージマッピングファイルの再設定

(7)　Smart Composer機能の定義変更

(8)　論理サーバの起動／停止の設定の変更

(9)　論理サーバの環境設定情報の変更

(10)　J2EEアプリケーションとリソースの再インポート

(11)　snapshotログ収集先対象リストファイルの再設定

(12)　Management Serverおよび運用管理エージェントのサービス再設定

(13)　論理サーバごとの強制停止監視時間の設定の追加

(14)　Unshareable指定時のコネクションアソシエーションのプロパティ追加

(15)　セキュリティポリシーファイルの変更

(16)　統合ユーザ管理のタグライブラリの入れ替え

(17)　デフォルトエラーページのスタックトレース表示

(18)　リダイレクタへのデータ送信処理のタイムアウト追加

(19)　ユーザスレッドの生成に必要な権限の追加

(20)　セッションIDへのサーバIDの付加

(21)　RMIレジストリが使用するポート番号の追加

(22)　SFOサーバの移行

(23)　リダイレクタのログ出力先変更

(24)　Webコンテナへのデータ送信処理のタイムアウト追加

(25)　リダイレクタの保守用トレースログの面数変更

(26)　ログ出力先の設定

(1)　論理サーバの設定情報の再読み込み

Management Serverを使用している場合，移行後にManagement Serverを最初に起動したときに，運用管理ドメインに構成定義された既存の論理J2EEサーバおよびSFOサーバに対して，接続先ホストから設定情報の読み込みを実施する必要があります。移行の手順中で，既存の論理J2EEサーバおよびSFOサーバの設定ファイルの内容が自動的に変更されるためです。

設定情報の読み込みは，Management Serverの運用管理ポータルの「論理サーバの環境設定」，またはmngsvrutilコマンドのサブコマンドreloadで実施できます。「論理サーバの環境設定」については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。また，mngsvrutilコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

注意

06-50より前のバージョンから移行して，論理J2EEサーバの設定情報の再読み込みをした場合で，［トランザクションの設定］画面の「タイムアウト時間」に「設定しない」を指定しているときは，設定画面には0秒が表示されます。設定値を見直し，適切な値を指定してください。

(2)　論理サーバの環境変数定義の再設定

Management Serverを使用している場合，運用管理ポータルの「論理サーバの起動／停止」で使用する環境変数を設定していたときは，新たにインストールされたadminagent.xmlファイルに環境変数を再設定する必要があります。adminagent.xmlは次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

adminagent.xmlでの環境変数の設定については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意事項

adminagent.xmlはインストール時に上書きされ，既存のファイルはadminagent.xml.bakに退避されます。

adminagent.xmlはバージョンアップによって変更されている可能性があります。adminagent.xmlを編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

(3)　論理サーバの起動順序，および前提となる論理サーバの変更

06-50以降から論理サーバとしてSFOサーバが追加され，論理サーバの起動順序が「SFOサーバ→J2EEサーバ」に変更されました。SFOサーバを使用する場合には，J2EEサーバの前に起動するようにしてください。

運用管理ドメイン全体の論理サーバの起動順序は，運用管理ポータルの「論理サーバの起動／停止」で設定できます。論理サーバごとに数値（デフォルト値があります）を設定し，値の小さなものから起動されるようにします。各論理サーバで「前提となる論理サーバ」を設定している場合は，該当する論理サーバの起動順序が前提の論理サーバより先になっていないか注意してください。

運用管理ドメイン全体の論理サーバの起動順序の設定については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

(4)　トランザクションサービスのインプロセス化

トランザクションサービスをJ2EEサーバとは別のプロセス（アウトプロセス）で起動していた場合，07-00以降はJ2EEサーバ起動時にインプロセスで起動されるのでそれに合わせて設定を変更してください。

Management Serverの運用管理ポータルでシステムを構築する場合には，次の方法で設定を変更してください。

トランザクションサービスをインプロセスで起動する場合には，論理OTSが使用していたスマートエージェントは不要となります。論理OTS以外の論理サーバがスマートエージェントを使用していない場合には，［トランザクションの設定］画面で，「利用するスマートエージェント」を「設定しない」と選択します。

不要となった論理OTSと論理TCSは，「運用管理ドメインの構成定義」で削除します。

設定の変更後は，Management Serverを再起動します。

ファイル編集とコマンド実行でシステムを構築する場合の設定の変更方法については，「付録C.2　インプロセストランザクションサービスへの移行」を参照してください。

(5)　Management Server用のネーミングサービスの設定変更

07-00以降は，Management Server用にネーミングサービスを起動する必要がなくなるため，次のように設定を変更することをお勧めします。

論理ネーミングサービスの削除
Management Serverのほかに論理ネーミングサービスを使用しているプロセスがない場合には，運用管理ポータルの「運用管理ドメインの構成定義」で論理ネーミングサービスを削除してください。また，論理ネーミングサービスを定義するために作成したホストにほかの論理サーバが定義されていない場合には，そのホストも削除してください。

運用監視エージェントのプロパティの変更
07-00以降，Management Server用のネーミングサービスのホストとポート番号を設定する，mngagent.naming.hostキーとmngagent.naming.portキーは設定不要となり，設定されていても値は無効になります。
また，通信ポートの固定とIPアドレスの固定に使用していた，vbroker.se.iiop_tp.scm.iiop_tp.listener.portキーとvbroker.se.iiop_tp.hostキーの設定は非推奨になります。これらのプロパティの設定は有効ですが，それぞれmngagent.connector.portキーとmngagent.connector.hostキーに変更することをお勧めします。
なお，これらの変更は，設定情報の配布を実施すると自動で行われます。

Smart Composer機能でシステムを構築している場合に，Management Server用のネーミングサービスを削除する方法については，「(7)　Smart Composer機能の定義変更」を参照してください。

(6)　JP1イベントメッセージマッピングファイルの再設定

次に示すJP1イベントメッセージマッピングファイルは，アップグレードインストール時に上書きされないで旧バージョンのファイルが引き継がれます。

Management Server用メッセージマッピングファイル
mserver.jp1event.system.mapping.properties

J2EEサーバ共通用メッセージマッピングファイル
manager.jp1event.system.mapping.properties

J2EEサーバ個別用メッセージマッピングファイル
manager.<論理サーバ名>.jp1event.system.mapping.properties

(a)　JP1イベントメッセージマッピングファイルをカスタマイズしないで使用していた場合

次の場所に格納されているManagement Server用メッセージマッピングファイルとJ2EEサーバ共通用メッセージマッピングファイルを修正しないで，旧バージョンのファイルに上書きしてください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates

UNIXの場合
/opt/Cosminexus/manager/config/templates

(b)　JP1イベントメッセージマッピングファイルをカスタマイズして使用していた場合

次の場所に格納されているManagement Server用メッセージマッピングファイルとJ2EEサーバ共通用メッセージマッピングファイルをコピーして，旧バージョンのときと同様にカスタマイズした上で，旧バージョンのファイルに上書きしてください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥templates

UNIXの場合
/opt/Cosminexus/manager/config/templates

(7)　Smart Composer機能の定義変更

Smart Composer機能でシステムを構築している場合には，次の設定変更をお勧めします。

Management Server用のネーミングサービスの削除
07-00以降，旧バージョンでのcmx_build_modelコマンドの実行時に自動的に作成していたManagement Server用のネーミングサービス「cmx_naming」は不要になります。Smart Composer機能以外でこのネーミングサービスを利用していない場合は，運用管理ポータルを使用して削除してください。また，このネーミングサービスを定義するためにSmart Composerが作成したホスト「localhost」も，必要がなければ削除してください。なお，運用管理ポータルについては，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。
なお，07-50以降では，cmx_delete_systemコマンドの-nsオプションを使用すると，Webシステムに関連づいていない論理サーバやホストを一括で削除できます。-nsオプションの対象となる論理サーバやホストは，運用管理ポータル，mngsvrutilコマンドで追加したSmart Composer機能のfree-tier内に設定されている論理サーバ，およびホストです。

簡易構築定義ファイルと構成変更定義ファイルのスキーマのバージョンの変更
07-00よりも前のバージョンで作成した簡易構築定義ファイルと構成変更定義ファイルはそのまま利用できますが，07-00以降で追加された機能（負荷分散機の冗長構成機能など）を使用する場合は，スキーマのバージョンを最新に変更する必要があります。バージョンごとの変更点を次に示します。

07-00（スキーマのバージョン2.0）以降の変更点
スキーマのバージョン2.0以降では，ホストはWebシステムの外側に定義します。スキーマのバージョンを2.0以降に変更する場合は，ホストの定義位置も変更してください。

07-50（スキーマのバージョン2.5）以降の変更点
スキーマのバージョン2.5以降では，一部のタグのタグ名，および<host-ref>タグの指定値が変更になっています。スキーマのバージョン2.5以降に変更または削除となるタグのタグ名を次の表に示します。

表A-12　スキーマのバージョン2.5以降に変更または削除となるタグのタグ名

分類 | スキーマのバージョン2.5より前のタグ名 | スキーマのバージョン2.5以降のタグ名
負荷分散機の定義 | management-ip | management-host
redundant-management-ip | redundant-management-host
ホストの定義 | name | 削除
operational-ip | host-name
management-ip | agent-host

なお，スキーマのバージョン2.5以降では，ホストの定義の<name>タグが削除となったため，<host-ref>タグの指定値は，ホストの定義の<name>タグから，ホストの定義の<host-name>タグの指定値に変更になります。
スキーマのバージョンを2.5以降に変更する場合は，表A-12のタグのタグ名と，<host-ref>タグの指定値も変更してください。

パフォーマンストレーサのトレース取得レベルの変更
07-00から機能レイヤの詳細レベルのトレースを取得できるようになりました。詳細レベルのトレースを取得する場合は，物理ティアのPrfTraceLevelパラメタの設定値を「55555554」から「DETAIL」に変更してください。また，「DETAIL」に設定したあとトレース取得レベルを標準に戻す場合は，「00000000」ではなく「STANDARD」に設定してください。

(8)　論理サーバの起動／停止の設定の変更

旧バージョンで，論理サーバの起動と停止の設定を更新（運用管理ポータルの「論理サーバの起動／停止」で設定を更新）していなかった場合，起動または停止の監視時間，自動再起動回数が，07-00以降のデフォルト値に変更されます。

論理サーバ | 変更内容
パフォーマンストレーサ | ［起動／停止の設定］画面の「停止監視時間」の値が「1分」から「10分」に変更されます。
［起動／停止の設定］画面の「自動再起動回数」の値が「5回」から「1回」に変更されます。
J2EEサーバ | ［起動／停止の設定］画面の「起動監視時間」の値が「1分」から「10分」に変更されます。

旧バージョンと同等の動作をさせるためには，設定を変更する必要があります。

(9)　論理サーバの環境設定情報の変更

論理サーバの環境設定情報の変更について説明します。

07-00よりも前のバージョンで，論理サーバの環境設定情報を更新（運用管理ポータルの「論理サーバの環境設定」で設定を更新）していなかった場合，次の環境設定情報が，07-00以降のデフォルト値に変更されます。

論理サーバ | 変更内容
J2EEサーバ | ［J2EEサーバの基本設定］画面の「Managementイベントの発行」の値が「しない」から「する」に変更されます。
SFOサーバ | ［SFOサーバの基本設定］画面の「Managementイベントの発行」の値が「しない」から「する」に変更されます。
Webサーバ | ［リダイレクタの設定］画面の「保守用のトレースログ」の「ファイル面数」の値が「16面」から「4面」に変更されます。

旧バージョンと同等の動作をさせるためには，設定を変更する必要があります。

SFOサーバを使用している場合には，SFOサーバの保守用ログの出力モードを指定する必要があります。［コンテナの設定］画面の「拡張パラメタ」で，次の設定を追加してください。
ejb.server.log.mode=6
add.jvm.arg=-XX:HitachiJavaLogFileSize=256k

(10)　J2EEアプリケーションとリソースの再インポート

運用管理ドメイン内のCosminexusをアップグレードインストールし，J2EEサーバの移行作業を実施する場合には次のことに注意してください。

06-50よりも前のManagement Serverで，スタンダードモード，アドバンスドモードのJ2EEサーバに対してデータソースをインポートしていた場合，次の作業を実施する必要があります。

運用管理ポータルの「論理サーバの起動／停止」で，該当するJ2EEサーバを起動する。

サーバ管理コマンドで，インポートしていたデータソースから移行されたリソースアダプタをエクスポートし，サーバ管理コマンドを終了する。

サーバ管理コマンドでエクスポートしたリソースアダプタを，運用管理ポータルでインポートする。

06-50よりも前のスタンダードモード，アドバンスドモードのJ2EEサーバで，運用管理ポータルの「論理サーバのアプリケーション管理」でインポートしたJ2EEアプリケーションがデータソースを使用していた場合，次の作業を実施する必要があります。

運用管理ポータルの「論理サーバの起動／停止」で，該当するJ2EEサーバを起動する。

サーバ管理コマンドで，J2EEアプリケーションをエクスポートし，サーバ管理コマンドを終了する。

運用管理ポータルの「論理サーバのアプリケーション管理」で，エクスポートしたJ2EEアプリケーションをManagement Serverに登録する。

運用管理ポータルの「論理サーバのアプリケーション管理」で，該当するJ2EEアプリケーションを停止していない場合は停止し，削除する。

登録したJ2EEアプリケーションを，該当するJ2EEサーバに新規インポートする。

運用管理ポータルの「論理サーバのアプリケーション管理」では，次に示すJ2EEアプリケーションをインポート，または開始できません。

06-50以降にアップグレードした1.4モード（06-71までのスタンダードモード，アドバンスドモード）のJ2EEサーバに対して，データソースを参照している実行時情報付きのJ2EEアプリケーション

データソースからリソースアダプタへの移行については，「付録A.3(27)　1.4モードのデータソース廃止」を参照してください。

(11)　snapshotログ収集先対象リストファイルの再設定

snapshotログを収集する場合に，snapshotログ収集先対象リストファイル（snapshotlog.confとsnapshotlog.2.conf）を編集して使用していたときは，新たにインストールされたsnapshotログ収集先対象リストファイルでsnapshotログの収集先を再設定する必要があります。

snapshotログ収集先対象リストファイルは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

snapshotログ収集先対象リストファイルの設定については，「5.2(3)　snapshotログの収集先のカスタマイズ」を参照してください。

注意事項

snapshotログ収集先対象リストファイルはバージョンアップ時に上書きされ，既存のファイルはsnapshotlog.conf.bakとsnapshotlog.2.conf.bakに退避されます。

バージョンアップによってsnapshotログの収集先が変更されることがあります。snapshotログの収集対象を編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

(12)　Management Serverおよび運用管理エージェントのサービス再設定

Management Serverおよび運用管理エージェントのサービスの設定を，サービスメニューまたはmngautorunコマンドで変更している場合，アップグレードインストール時に設定がリセットされます。その場合は，再度サービスの設定を変更してください。

(13)　論理サーバごとの強制停止監視時間の設定の追加

06-50以降のバージョンで，adminagent.properties（運用管理エージェントプロパティファイル）でadminagent.forcestop.threaddump=trueを指定している場合は，adminagent.forcestop.threaddump.timeoutの指定値より長い値，または同じ値を，「強制停止監視時間」に指定してください。「強制停止監視時間」は，論理サーバの起動と停止の設定で指定します。

07-50より前からバージョンアップした場合には，「強制停止監視時間」の値に「1分」が設定されます。「強制停止監視時間」の値を変更しないと，adminagent.forcestop.threaddump.timeoutの値は無視され，スレッドダンプ出力が「1分」で終了しない場合も強制停止されるようになります。

(14)　Unshareable指定時のコネクションアソシエーションのプロパティ追加

06-50以降，ejbserver.connectionpool.association.enabled=trueが設定されたとしても，EJBまたはサーブレット／JSPのDDの<res-sharing-scope>タグにUnshareableが指定された場合，コネクションアソシエーションは行われません。06-50より前では，同条件でコネクションアソシエーションは行われていました。追加になったプロパティを次に示します。なお，ここでは，表記の都合上，キー名の途中で改行しています。

システムプロパティのキー名称
デフォルト値
（旧バージョンと同等の値）
手順

ejbserver.connectionpool.association.
enabledDespiteUnshareableSetting
false（true）
旧バージョンと同等の動作をさせるためには，明示的にプロパティを指定する必要があります。

プロパティの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(15)　セキュリティポリシーファイルの変更

統合ユーザ管理機能を使用している場合はセキュリティポリシーファイルの内容を見直してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥<サーバ名称>¥server.policy

UNIXの場合
opt/Cosminexus/CC/server/usrconf/<サーバ名称>/server.policy

セキュリティポリシーファイルで，Webアプリケーションのコードベース（file:${ejbserver.http.root}/web/${ejbserver.serverName}/-）のアクセス権の次の内容を見直してください。設定するアクセス権の内容については，javax security.auth.AuthPermissionクラスを参照してください。

permission javax.security.auth.AuthPermission "createLoginContext.{name}";
permission javax.security.auth.AuthPermission "getSubject";

{name}には，JAASのコンフィグレーションファイルのアプリケーション名を指定します。{name}では，任意の名前を表すのにワイルドカード「*」を使用できます。

(16)　統合ユーザ管理のタグライブラリの入れ替え

統合ユーザ管理でタグライブラリを使用している場合は，uatags.jarとuatags.tldを入れ替えてください。

uatags.jarを，WebアプリケーションのWEB-INF¥libまたはWEB-INF/libに上書きコピーします。

uatags.tldを，作成するWebアプリケーションのWEB-INFに上書きコピーします。

(17)　デフォルトエラーページのスタックトレース表示

Servlet/JSPの実行中にcatchされない例外が発生し，Webアプリケーションがそのエラーをカスタマイズしない場合，デフォルトのエラーページが生成されクライアントに送信されます。このとき，06-51よりも前のバージョンではデフォルトのエラーページにスタックトレースを出力します。06-70以降では，スタックトレースを出力するかどうかをusrconf.propertiesで設定できます（デフォルトでは出力されません）。スタックトレースを出力する場合は，usrconf.propertiesで「webserver.errorpage.stack_trace.enabled=true」を指定してください。

(18)　リダイレクタへのデータ送信処理のタイムアウト追加

07-00以降では，Webコンテナからリダイレクタへのデータ送信処理でタイムアウト機能が追加されました。usrconf.propertiesで次のキーが追加されています。

webserver.connector.ajp13.send_timeout

デフォルト値は600（秒）です。旧バージョンと同等の動作をさせるためには，0（秒）を指定する必要があります。

(19)　ユーザスレッドの生成に必要な権限の追加

ユーザスレッドの生成に必要な権限の追加について，06-71以前のバージョンではserver.policyに権限の追加を定義する必要がありましたが，07-00以降ではserver.policyにデフォルトで定義が追加されています。

ただし，06-71以前のバージョンから07-60に移行する場合には，server.policyには定義が追加されません。06-71以前のバージョンから07-60に移行してユーザスレッドを使用する場合は，06-71以前と同様に，server.policyを編集して定義を追加する必要があります。

server.policyで，Webアプリケーションのコードベース（file:${ejbserver.http.root}/web/${ejbserver.serverName}/-）のアクセス権に次の内容を追加します。

permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "modifyThreadGroup";

(20)　セッションIDへのサーバIDの付加

06-51以前では，javax.servlet.http.HttpSessionのセッションIDへサーバIDを付加する機能がデフォルトで無効でしたが，06-70以降ではデフォルトで有効になります。この機能によって，webserver.session.server_id.valueキーで指定したサーバIDがセッションIDに付加されます。セッションIDはCookie（名前はJSESSIONID）やURL書き換えによるセッション情報の管理に使用されます。

ただし，サーバIDはデフォルトではWebコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号（インプロセスHTTPサーバを使用する場合はインプロセスHTTPサーバが使用するポート番号）から生成されます。

セッションIDはクライアントに送信されるため，IPアドレスなどサーバ環境の情報を含まない値をサーバIDとして明示的に指定することをお勧めします。また，サーバIDがセッションIDに付加されることでセッションIDの文字列長は，06-51以前で，かつこの機能を使用していない場合に比べサーバIDの長さ分増加します。

06-51以前から07-60への移行で，セッションIDの長さの増加によって問題が発生する場合，次の対処を行ってください。

システムが負荷分散機によって複数のWebコンテナで冗長構成となっていない場合
次の設定をusrconf.propertiesに追加して，この機能を無効にしてください。
webserver.session.server_id.enabled=false

システムが負荷分散機によって複数のWebコンテナで冗長構成となっている場合
この機能を無効にしないで，セッションIDの文字列長が増加することで発生する問題に対策してください。この機能を無効にした場合の動作は保証できません。

セッションIDおよびCookieへのサーバIDの付加については，マニュアル「Cosminexus　機能解説」を参照してください。usrconf.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(21)　RMIレジストリが使用するポート番号の追加

07-00以降では，RMIレジストリを使用します。RMIレジストリが使用するポート番号は，usrconf.propertiesの次のキーで指定します。

ejbserver.rmi.naming.port

なお，デフォルト値は23,152です。

(22)　SFOサーバの移行

07-50以降では，セッションフェイルオーバ機能を使用している場合，バージョンアップ時にSFOサーバを移行する必要があります。

注意

SFOサーバの移行作業を実施しないで，07-50より前のバージョンで構築したSFOサーバを07-50以降の環境で使用すると，SFOサーバの起動に失敗します。

Management Serverを使用しているシステムの場合は，SFOサーバの設定情報の再読み込みを実施したあとに，SFOサーバのセットアップを実施してください。SFOサーバのセットアップは，Smart Composer機能を使用して構築したシステムの場合は，SFOサーバを含むWebシステムに対して，cmx_build_systemコマンドを実行してください。cmx_build_systemコマンドについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。Management Serverの運用管理ポータルを使用して構築したシステムの場合は，運用管理ポータルの「運用管理ドメインの構成定義」で，SFOサーバに対してセットアップを実施してください。なお，バージョンアップ前にセットアップを実施したSFOサーバの場合，バージョンアップ後も［セットアップ］画面で「セットアップ済」と表示されますが，「セットアップ済」のSFOサーバに対しても必ずセットアップを実施してください。「運用管理ドメインの構成定義」については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

Management Serverを使用していないシステムの場合は，J2EEサーバを移行する前に，サーバ管理コマンドを使用してSFOサーバを移行してください。サーバ管理コマンドを使用したSFOサーバの移行手順については，「付録A.13　セッションフェイルオーバ機能を使用している場合のバージョンアップ」を参照してください。

(23)　リダイレクタのログ出力先変更

UNIXの場合，06-50以降では，mod_jk.confのJkLogFileDirキーおよびJkTraceLogFileDirキーで指定したディレクトリにリダイレクタのログを出力します。また，06-50以降では，mod_jk.confのJkLogFileキーは使用しません。06-50以降で使用する場合，このキーの指定を削除またはコメントにする必要があります。指定が残っている場合，Hitachi Web Server起動時に警告メッセージがリダイレクタのログに出力されます。

(24)　Webコンテナへのデータ送信処理のタイムアウト追加

07-00以降では，リダイレクタからWebコンテナへのデータ送信処理でタイムアウト機能が追加され，リダイレクタ動作定義ファイルにキーが追加されました。追加されたHitachi Web Server用リダイレクタ動作定義ファイル（mod_jk.conf）とMicrosoft IIS用リダイレクタ動作定義ファイル（isapi_redirect.conf）のキーを次に示します。

ファイル名
キー名
説明

mod_jk.conf
JkConnectTimeout
デフォルト値は，30（秒）です。
旧バージョンと同等の動作をさせるためには，0（秒）を指定する必要があります。

JkSendTimeout
デフォルト値は，100（秒）です。
旧バージョンと同等の動作をさせるためには，0（秒）を指定する必要があります。

JkRequestRetryCount
デフォルト値は，3（秒）です。
旧バージョンと同等の動作をさせるためには，デフォルト値のままにしてください。

isapi_redirect.conf
connect_timeout
デフォルト値は，30（秒）です。
旧バージョンと同等の動作をさせるためには，0（秒）を指定する必要があります。

send_timeout
デフォルト値は，100（秒）です。
旧バージョンと同等の動作をさせるためには，0（秒）を指定する必要があります。

request_retry_count
デフォルト値は，3（秒）です。
旧バージョンと同等の動作をさせるためには，デフォルト値のままにしてください。

(25)　リダイレクタの保守用トレースログの面数変更

07-00以降では，次のキーで指定するリダイレクタの保守用トレースログファイルの面数のデフォルト値が，2から4に変更となります。

mod_jk.confのJkTraceLogFileNumキー（Hitachi Web Serverの場合）

isapi_redirect.confのtrace_log_file_numキー（Microsoft IISの場合）

アップグレードインストールの場合は，旧バージョンでの設定値が有効になります。旧バージョンで明示的に値を指定していなかった場合，旧バージョンと同等の動作をさせるためには，2を指定してください。

(26)　ログ出力先の設定

07-10以降，cjclstartapコマンドを使用してEJBクライアントアプリケーションを起動した場合のデフォルトのログ出力先が変更になります。このため，既存のログ出力先を移行前のディレクトリにしたい場合，ejb.client.log.directoryプロパティを設定してください。なお，07-10以降でのデフォルトのログ出力先については，「付録A.3(55)　cjclstartapコマンドの仕様変更」を参照してください。

付録A.11　移行コマンドで作成されたバックアップの削除

旧バージョンから移行する場合，アプリケーションの動作確認後，手動でバックアップ作業ディレクトリ，およびバックアップRARディレクトリを削除する必要があります。バックアップ作業ディレクトリ，およびバックアップRARディレクトリを別の場所に保存しておくことをお勧めします。

移行前の作業ディレクトリ，移行後の作業ディレクトリ，バックアップ作業ディレクトリ，およびバックアップRARディレクトリの例を次の表に示します。

表A-13　ディレクトリの移行の例（Windowsの場合）

J2EEサーバのサーバ名称
移行前の作業ディレクトリ
移行後の作業ディレクトリ，およびバックアップ作業ディレクトリ

SERVERA
<Cosminexusのインストールディレクトリ>¥CC¥server¥public
（デフォルト）

変換後の作業ディレクトリ

<Cosminexusのインストールディレクトリ>¥CC¥server¥public

バックアップ作業ディレクトリ

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥public_old

バックアップRARディレクトリ

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥rarupdate_bk

SERVERB
C:¥work_dir

変換後の作業ディレクトリ

C:¥work_dir

バックアップ作業ディレクトリ

C:¥work_dir¥work_dir_old

バックアップRARディレクトリ

C:¥work_dir¥rarupdate_bk

SERVERC

－
D:¥replication_dir

D:¥replication_dir

未使用のディレクトリは移行されません。

（凡例）

－：作業ディレクトリとして使用しているサーバがないことを示す。

表A-14　ディレクトリの移行の例（UNIXの場合）

J2EEサーバのサーバ名称
移行前の作業ディレクトリ
移行後の作業ディレクトリ，およびバックアップ作業ディレクトリ

SERVERA
/opt/Cosminexus/CC/server/public
（デフォルト）

変換後の作業ディレクトリ

/opt/Cosminexus/CC/server/public

バックアップ作業ディレクトリ

/opt/Cosminexus/CC/server/public/public_old

バックアップRARディレクトリ

/opt/Cosminexus/CC/server/public/rarupdate_bk

SERVERB
/・・・/work_dir

変換後の作業ディレクトリ

/・・・/work_dir

バックアップ作業ディレクトリ

/・・・/work_dir/work_dir_old

バックアップRARディレクトリ

/・・・/work_dir/rarupdate_bk

SERVERC

－
/・・・/replication_dir

/・・・/replication_dir

未使用のディレクトリは移行されません。

（凡例）

－：作業ディレクトリとして使用しているサーバがないことを示す。

上記の表の例では，アップグレードインストール前に，「SERVERA」，「SERVERB」，および「SERVERC」のJ2EEサーバがセットアップされています。「SERVERA」，および「SERVERB」ではDB Connectorを使用しています。これらのJ2EEサーバが利用している作業ディレクトリが，Windowsの場合は「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」と「C:¥work_dir」，UNIXの場合は「/opt/Cosminexus/CC/server/public」と「/・・・/work_dir」です。Windowsの場合の「D:¥replication_dir」，UNIXの場合の「/・・・/replication_dir」はユーザが複製した作業ディレクトリで，J2EEサーバからは利用されていません。

このような状況でcjenvupdateコマンド，およびcjrarupdateコマンドを実行した場合，それぞれ使用中の作業ディレクトリに対して，バックアップが作成されます。アプリケーションの動作確認後，手動でバックアップを削除してください。なお，未使用の作業ディレクトリ「D:¥replication_dir」または「/・・・/replication_dir」は，移行されません。

注意

作業ディレクトリの移行が必要ないバージョンからのバージョンアップの場合，cjenvupdateコマンドは作業ディレクトリを移行しません。この場合，バックアップ作業ディレクトリは作成されません。

付録A.12　J2EEサーバの移行コマンドで自動的に追加される定義

旧バージョンからCosminexus 07-60へ移行する場合，J2EEサーバのユーザプロパティファイルや作業ディレクトリ内のDD情報は，旧バージョンのものが07-60の環境でもそのまま継続使用されます。ただし，新バージョンで追加された機能，およびデフォルト値が変更された機能があり，互換性を維持するために，J2EEサーバの移行コマンドがユーザプロパティファイルのプロパティや作業ディレクトリ内のDD情報を部分的に変換します。移行コマンド実行時に追加／変更されるキーと値，およびコマンドで取得した属性ファイルに追加されるタグを次の表に示します。

表A-15　J2EEサーバのusrconf.propertiesに自動的に追加される定義

追加／変更されるキーと値
旧バージョンでの環境条件
07-10/
07-50
07-00
06-71/
06-70
06-51/
06-50
06-02/
06-00

ejbserver.distributedtx.rollbackClientTxOnSystemException=true
スタンダードモード／アドバンスドモードの場合
－
－
－
－
○

ejbserver.distributedtx.ots.InProcessMode.enabled=false
グローバルトランザクションが有効の場合※
－
－
－
－
○

ejbserver.connector.logwriter.filenum=2
このキーがない場合
－
－
○
○
○

ejbserver.connector.logwriter.filesize=1048576
このキーがない場合
－
－
○
○
○

ejbserver.instrumentation.enabled=false
このキーがない場合
－
－
○
○
○

ejbserver.deploy.context.reload_scope=none
このキーがない場合
－
○
○
○
○

ejbserver.server.j2ee.feature=1.3basic
ベーシックモードの場合
－
－
○
○
○

ejbserver.server.j2ee.feature=1.4
スタンダードモード／アドバンスドモードの場合
－
－
○
○
○

ejbserver.watch.enabled=false
－
－
－
－
－
○

ejbserver.webj2ee.connectionAutoClose.enabled=false
このキーがない場合
－
－
○
○
○

webserver.container.thread_control.queue_size=10
queue_sizeは指定なし
－
－
－
－
○

（凡例）　○：定義が自動的に追加されることを示す。

注※　ejbserver.distributedtx.XATransaction.enabled=trueの指定がある場合です。

表A-16　J2EEサーバのusrconf.cfgに自動的に追加される定義

追加／変更されるキーと値
旧バージョンでの環境条件
07-00/
07-10/
07-50
06-71/
06-70
06-51/
06-50
06-02/
06-00

ejb.server.log.mode=6
－
－
○
○
○

（凡例）　○：定義が自動的に追加されることを示す。

表A-17　J2EEサーバの属性ファイルに自動的に追加される定義

追加されるタグ
旧バージョンでの環境条件
07-00/
07-10/
07-50
06-71/
06-70
06-51/
06-50
06-02/
06-00

Connector属性ファイル

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-name>

値

RequestQueueEnable

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-value>

値

false

スタンダードモード／アドバンスドモードの場合
－
－
－
○

Connector属性ファイル

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-name>

値

Warmup

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-value>

値

ejbserver.connectionpool.warmupキーの指定値（指定がない場合，true）

－
○
○
○

Connector属性ファイル

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-name>

値

NetworkFailureTimeout

タグ

<hitachi-connector-property>

<runtime>

<property>

<property-value>

値

計算式によって算出された値

－
○
○
○

（凡例）　○：定義が自動的に追加されることを示す。

なお，NetworkFailureTimeoutの値は，次の計算式によって算出されます。

（コネクション障害検知機能 &&（コネクション障害検知タイムアウト機能
||ネットワーク障害タイムアウト機能））||
（コネクション数調節機能 && ネットワーク障害タイムアウト機能）

計算式の「&&」は論理積，「||」は論理和を表します。また，各機能の値を次に示します。

機能 | キーと値
コネクション障害検知機能 | ValidationType = 1 または 2
コネクション数調節機能 | ConnectionPoolAdjustmentInterval > 0
コネクション障害検知タイムアウト機能 | ejbserver.connectionpool.validation.timeout.enabled = true
ネットワーク障害タイムアウト機能 | ejbserver.connectionpool.NetworkFailureTimeout.enabled = true

なお，ejbserver.connectionpool.validation.timeout.enabledキー，ejbserver.connectionpool.NetworkFailureTimeout.enabledキーが設定されていなかった場合は，それぞれの値をfalseと仮定して算出されます。

表A-18　サーバ管理コマンドのusrconf.propertiesに自動的に追加される定義

仕様変更の項目
07-50
07-00/
07-10
06-71/
06-70
06-51/
06-50
06-02/
06-00

ejbserver.cui.checkmethod.compatible=true
－
○
○
○
○

ejbserver.cui.logfile.compatible=true
－
－
○
○
○

（凡例）　○：定義が自動的に追加されることを示す。

表A-19　J2EEサーバのserver.policyに自動的に追加される定義

追加される定義
07-50
07-00/
07-10
06-71/
06-70
06-51/
06-50
06-02/
06-00

permission javax.security.auth.AuthPermission "modifyPrivateCredentials";
－
○
○
○
○

permission java.lang.RuntimePermission "getenv.HRMDIR";
－
○
○
○
○

（凡例）　○：定義が自動的に追加されることを示す。

付録A.13　セッションフェイルオーバ機能を使用している場合のバージョンアップ

セッションフェイルオーバ機能を使用している場合，07-50以降のバージョンアップするときには，07-50以降のバージョンアップするときに，SFOサーバの移行を実施する必要があります。ここでは，Management Serverを使用していないシステムの場合の，SFOサーバの移行手順について説明します。なお，ここで示している手順は，サーバ管理コマンドを使用した移行手順です。SFOサーバの移行は，J2EEサーバを移行する前に実施してください。

なお，Management Serverを使用しているシステムの場合の，SFOサーバの移行については，「付録A.10(22)　SFOサーバの移行」を参照してください。

注意

SFOサーバの移行作業を実施しないで，バージョンが07-50より前のSFOサーバアプリケーションを07-50以降の環境で使用すると，SFOサーバアプリケーションのデプロイに失敗して，SFOサーバアプリケーションは開始できません。

＜この項の構成＞

(1)　SFOサーバの移行の手順

(2)　SFOサーバ移行の準備

(3)　SFOサーバの移行

(4)　SFOサーバアプリケーションのセットアップ

(5)　サーバ管理コマンドを使用したSFOサーバ移行の実行例

(1)　SFOサーバの移行の手順

次の手順に従って，SFOサーバを07-50以降の環境に移行してください。

SFOサーバ移行の準備

SFOサーバの移行

SFOサーバアプリケーションのセットアップ

(2)　SFOサーバ移行の準備

SFOサーバ移行に必要な準備として，次の作業を実施します。

J2EEサーバを停止します。
移行するSFOサーバに接続するJ2EEサーバの稼働状況を確認して，稼働中のJ2EEサーバがあった場合は停止してください。停止には，cjstopsvコマンドを使用します。

SFOサーバを起動します。
移行するSFOサーバの稼働状況を確認して，停止している場合は起動してください。起動には，cjstartsvコマンドを使用します。

SFOサーバアプリケーションを停止します。
SFOサーバにインポートされているSFOサーバアプリケーションを停止します。停止するSFOサーバアプリケーションの名称は，「CCC_SFO_Server_Application」です。
停止には，サーバ管理コマンドのcjstopappコマンドを使用します。

SFOサーバアプリケーションを削除します。
手順3.で停止したSFOサーバアプリケーション「CCC_SFO_Server_Application」を，サーバ管理コマンドを使用して削除します。削除には，サーバ管理コマンドのcjdeleteappコマンドを使用します。

SFOサーバを停止します。
停止には，cjstopsvコマンドを使用します。

(3)　SFOサーバの移行

SFOサーバとして構築したJ2EEサーバを，新しいバージョンに移行します。

J2EEサーバの移行手順については，「付録A.2　Cosminexusの移行の手順」を参照してください。

(4)　SFOサーバアプリケーションのセットアップ

移行したSFOサーバに対して，SFOサーバアプリケーションをセットアップします。

SFOサーバアプリケーションのセットアップとして，次の作業を実施します。

SFOサーバを起動します。
起動には，cjstartsvコマンドを使用します。

SFOサーバアプリケーションをインポートします。
インポートには，サーバ管理コマンドのcjimportappコマンドを使用します。
SFOサーバアプリケーションの格納場所を次に示します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥sfo¥sfo_server¥sfo_server_application.zip

UNIXの場合

/opt/Cosminexus/CC/sfo/sfo_server/sfo_server_application.zip

注意

SFOサーバアプリケーションのインポートだけを実行する場合でも，cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを起動してください。SFOサーバアプリケーションは，インポートすると自動的に開始する設定になっています。そのため，-nosecurityオプションなしでSFOサーバを起動した場合，SFOサーバアプリケーションの開始処理でエラーとなり，SFOサーバとしての機能を開始できません。

SFOサーバアプリケーションは実行時情報付きファイルの形式（ZIP形式）で提供されており，実行に必要なJ2EEリソースの設定は実施済みです。インポート後，SFOサーバアプリケーションの設定を変更してはいけません。

(5)　サーバ管理コマンドを使用したSFOサーバ移行の実行例

サーバ管理コマンドによるSFOサーバの移行の実行例を示します。

前提としている条件

この実行例は，次の条件に従っています。

SFOサーバのJ2EEサーバ名は「MySFOServer」である。

SFOサーバが稼働するホストと同一のホストでサーバ管理コマンドを実行する。

SFOサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号は900である（デフォルトの設定）。

Cosminexus Component Containerのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus¥CC」である（デフォルトの設定）。

J2EEサーバはすべて停止している状態とする。

SFOサーバは開始している状態とする。

なお，この例では，PRFデーモンの起動と終了の操作については省略しています。

SFOサーバ移行準備をします。
コンソールでの実行例を次に示します。

C:¥>cd "Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin"
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin >cjstopapp MySFOServer -name CCC_SFO_Server_Application
KDJE37048-I Connecting to MySFOServer...
KDJE37049-I Searching CCC_SFO_Server_Application...
KDJE37055-I Stopping CCC_SFO_Server_Application...
KDJE37046-I Application has been stopped successfully. Name=[CCC_SFO_Server_Application]

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjdeleteapp MySFOServer -name CCC_SFO_Server_Application
KDJE37048-I Connecting to MySFOServer...
KDJE37049-I Searching CCC_SFO_Server_Application...
KDJE37056-I Deleting CCC_SFO_Server_Application...
KDJE37047-I Application has been deleted successfully. Name=[CCC_SFO_Server_Application]

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cd ..¥..¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstopsv MySFOServer

SFOサーバを移行します。

SFOサーバアプリケーションをセットアップします。
まず，SFOサーバを起動する実行例を次に示します。

C:¥>cd "Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin"
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstartsv MySFOServer -nosecurity
　　　（省略：J2EEサーバ起動メッセージ）
KDJE30028-I The J2EE server has started. Server name = MySFOServer

次に，SFOサーバアプリケーションのインポートの実行例を次に示します。

C:¥>cd "Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin"
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjimportapp MySFOServer -f "C:¥Program Files¥HITACHI¥Cosminexus¥CC¥sfo¥sfo_server¥sfo_server_application.zip"

付録B　Cosminexus Version 6およびCosminexus Version 7とのRMI-IIOP通信の相互接続性

Cosminexus 07-60と旧バージョン間で，RMI-IIOP通信でリモートのEJBを呼び出せます。

トランザクションコンテキストのプロパゲーションを使用しない場合，EJBクライアントアプリケーション，およびクライアント側のJ2EEサーバと，サーバ側のJ2EEサーバ間の相互接続性について次の表に示します。

表B-1　バージョン間のRMI-IIOP通信の相互接続性（トランザクションコンテキストのプロパゲーションを使用しない場合）

EJBクライアントアプリケーションまたはクライアント側のJ2EEサーバ | サーバ側のJ2EEサーバ
07-00以降 | 06-71～06-00
07-00以降 | ○ | △
06-71～06-00 | △ | ○

（凡例）

○：相互接続性がある。

△：一部制限がある。

トランザクションコンテキストのプロパゲーションを使用する場合，クライアント側のJ2EEサーバと，サーバ側のJ2EEサーバ間の相互接続性について次の表に示します。

表B-2　バージョン間のRMI-IIOP通信の相互接続性（トランザクションコンテキストのプロパゲーションを使用する場合）

クライアント側のJ2EEサーバ | サーバ側のJ2EEサーバ
07-00以降 | 06-71～06-50 | 06-02/06-00
07-00以降 | ○ | △ | ×
06-71～06-50 | △ | ○ | ×
06-02/06-00 | × | × | ○

（凡例）

○：相互接続性がある。

△：一部制限がある。

×：相互接続性がない。

参考

表B-1と表B-2の「一部制限」は，次の内容です。

次のクラスをメソッドの引数，戻り値，またはユーザ例外で使用した場合，受信側でorg.omg.CORBA.MARSHAL例外が発生します。ほかのクラスを使用してください。

java.lang.StringBuffer，java.math.BigDecimal，java.net.Inet6Address，

java.security.SecureRandom，java.text.DecimalFormat，

java.util.Locale，javax.naming.Binding，javax.naming.directory.SearchResult，

javax.naming.NameClassPair

なお，EJBクライアントアプリケーションから異なるバージョンのJ2EEサーバを呼び出す場合，EJBクライアントアプリケーションで使用するRMI-IIOPスタブは，EJBクライアントアプリケーションと同じバージョンのJ2EEサーバから取得する，またはRMI-IIOPスタブ互換性があるバージョンのJ2EEサーバから取得する必要があります。EJBクライアントアプリケーションで使用できるRMI-IIOPスタブがどのバージョンのJ2EEサーバから取得できるかを次の表に示します。

表B-3　RMI-IIOPスタブの互換性

EJBクライアントアプリケーションのバージョン | RMI-IIOPスタブを取得するJ2EEサーバのバージョン
07-00以降 | 06-71～06-50 | 06-02/06-00
07-00以降 | ○ | ○ | ○
06-71～06-50 | × | ○ | ○
06-02/06-00 | × | × | ○

（凡例）

○：RMI-IIOPスタブを使用できる。

×：RMI-IIOPスタブを使用できない。

具体例としては，07-00以降と06-00間でRMI-IIOP通信によってリモートのEJBを呼び出す場合，07-00以降がEJBクライアントアプリケーション，06-00がJ2EEサーバになるときは，07-00以降のJ2EEサーバから取得したスタブを使用してください。逆に，06-00がEJBクライアントアプリケーション，07-00以降がJ2EEサーバになるときは，06-00のJ2EEサーバから取得したスタブを使用してください。

付録C　推奨機能への移行

Cosminexusで従来サポートしている機能から推奨機能への移行方法について説明します。

＜この節の構成＞

付録C.1　Microsoft IISからHitachi Web Serverへの移行

付録C.2　インプロセストランザクションサービスへの移行

付録C.1　Microsoft IISからHitachi Web Serverへの移行

Microsoft IIS用リダイレクタからHitachi Web Server用リダイレクタへ移行する場合の定義ファイルの対応を次に示します。

定義内容 | Microsoft IIS用リダイレクタ | Hitachi Web Server用リダイレクタ
リダイレクタ定義 | isapi_redirect.conf | mod_jk.conf
URLパターンとワーカのマッピング定義 | uriworkermap.properties
ワーカ定義 | workers.properties | workers.properties

Microsoft IIS用リダイレクタを使用している環境からHitachi Web Server用リダイレクタを使用する環境に移行する場合，uriworkermap.propertiesに指定していたURLパターンとワーカのマッピング定義を，JkMountキーを使用してmod_jk.confに指定する必要があります。workers.propertiesは，Microsoft IIS用リダイレクタで使用していたものをそのまま使用できます。

Microsoft IIS用リダイレクタを使用している環境からの移行の手順の概要を次に示します。

Hitachi Web Serverをインストールします。

uriworkermap.propertiesに定義されているURLパターンとワーカのマッピング定義をmod_jk.confに指定します。

Webサーバ連携の定義をします。
詳細については，「18.8.1　Hitachi Web Serverの設定」を参照してください。

Hitachi Web Serverを起動します。

付録C.2　インプロセストランザクションサービスへの移行

トランザクションサービスをJ2EEサーバとは別のプロセス（アウトプロセス）で起動していた場合，07-00以降からはJ2EEサーバ起動時にインプロセスで起動するように変更してください。

ここでは，ファイル編集とコマンド実行でシステムを構築する場合の設定の変更方法について説明します。Management Serverの運用管理ポータルでシステムを構築する場合の設定の変更方法については，「付録A.10(4)　トランザクションサービスのインプロセス化」を参照してください。

＜この項の構成＞

(1)　移行作業の流れ

(2)　運用の移行

(3)　トラブルシュート情報の取得方法の移行

(4)　プログラムソースコードの移行

(1)　移行作業の流れ

次の手順に従って，環境を移行してください。

アウトプロセストランザクションサービスのアンセットアップ

プロパティの設定

環境変数の変更

(a)　アウトプロセストランザクションサービスのアンセットアップ

アウトプロセストランザクションサービスのセットアップ用のコマンドを実行して，アウトプロセストランザクションサービスをアンセットアップしてください。

アウトプロセストランザクションサービスのセットアップ用のコマンドを実行するタイミングによって，使用するコマンドが異なります。

Cosminexus 07-50以降への移行後に実行する場合

Windowsの場合
tstpbsetup -dコマンド

UNIXの場合
tssetup -dコマンド

Cosminexus 07-50以降への移行前に実行する場合
tssetup -dコマンド

(b)　プロパティの設定

インプロセストランザクションサービスでは，セットアップコマンドの実行は必要ありません。また，アウトプロセストランザクションサービスではtsdefvalueコマンドを使用してシステム環境定義をカスタマイズしましたが，インプロセストランザクションサービスではJ2EEサーバ用のユーザプロパティファイルを使用してシステム環境定義をカスタマイズします。インプロセストランザクションサービスで設定が必要なJ2EEサーバのプロパティを次の表に示します。

表C-1　インプロセストランザクションサービスで設定が必要なJ2EEサーバのプロパティ

キー名称
値
見積もりの指針

ejbserver.distributedtx.enableXidReuseOptimization
false
－

ejbserver.distributedtx.ots.status.directory1
インプロセストランザクションサービスのステータスファイルを格納するディレクトリ
指定したパスのパーティションが枯渇しないように運用する必要があります。
また，アウトプロセストランザクションサービスでは，環境変数「TPFS」をカスタマイズして共有ディスク上に配置し，HA構成で運用していた場合は，共有ディスク上のパスを設定する必要があります。

ejbserver.distributedtx.ots.status.directory2※

注※　インプロセストランザクションサービスでステータスファイルを1面で運用する場合，設定の必要はありません。

キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(c)　環境変数の変更

インプロセストランザクションサービスとアウトプロセストランザクションサービスでは，設定が必要な環境変数が異なります。不要となった環境変数は削除してください。トランザクションサービスの環境変数の設定要否を次の表に示します。なお，環境変数に設定する値については，「2.3.2　環境変数の詳細」を参照してください。

表C-2　トランザクションサービスの環境変数の設定要否

環境変数名
指定する内容
設定の要否

アウトプロセストランザクションサービスの場合
インプロセストランザクションサービスの場合

OSAGENT_PORT
スマートエージェントが使用するポート番号
○
　△※1

PATH
プログラム実行パス
◎
◎

LIBPATH，またはLD_LIBRARY_PATH※2
ライブラリ検索パス
◎
◎

TPDIR
Cosminexus TPBrokerのインストール先
◎
◎

TZ
タイムゾーン
◎
◎

VBROKER_ADM
スマートエージェントの定義情報が格納されているディレクトリ
◎
◎

TPFS
Cosminexus TPBrokerのステータスファイル格納先
（任意のディレクトリまたはキャラクタデバイスファイル）
○
△

TPSPOOL
Cosminexus TPBrokerの稼働情報格納先
（任意のディレクトリ）
○
△

（凡例）

◎：設定する必要がある。

○：使用する機能によっては設定する必要がある。

△：設定は不要（設定しても無視される）。

注※1　CTMなどの機能でスマートエージェントを使用する場合があります。ほかの機能で使用している場合は，環境変数「OSAGENT_PORT」を削除しないでください。

注※2　OSによって，使用する環境変数名が異なります。

LIBPATH：AIXの場合

LD_LIBRARY_PATH：HP-UX（IPF），Linux，またはSolarisの場合

(2)　運用の移行

システムの運用環境も移行する必要があります。次の内容を変更して，システムの運用環境を移行してください。

起動プロセスの変更

メッセージの監視方法の変更

(a)　起動プロセスの変更

インプロセストランザクションサービスでは，次のプロセスは起動不要です。

OTS（tsstartコマンドで起動）

TCS（trnctxsvコマンドで起動）

スマートエージェント（osagentコマンドで起動）※

注※

CTMなどの機能でスマートエージェントを使用する場合があります。ほかの機能で使用している場合は，スマートエージェントを起動してください。

(b)　メッセージの監視方法の変更

メッセージを監視する運用を行っている場合，メッセージの出力や内容の変更があります。監視対象となるメッセージIDを変更してください。メッセージの変更点を次の表に示します。

表C-3　メッセージの変更点

変更点 | アウトプロセストランザクションサービスの場合 | インプロセストランザクションサービスの場合
出力先 | イベントログ，またはsyslog | cjmessage?.log
cjmessage?.log
メッセージIDの範囲 | KFCB29500～KFCB32401 | KFCB40000～KFCB49999
メッセージが記載されているドキュメント | TPBrokerのドキュメント | マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」

注　「?」は通番を意味します。

(3)　トラブルシュート情報の取得方法の移行

アウトプロセストランザクションサービスを使用した場合は，環境変数「TPSPOOL」および「TPFS」に指定したディレクトリ以下のトレースファイルやログファイルを取得する必要がありました。インプロセストランザクションサービスでは，アウトプロセストランザクションサービスで取得していた資料は，取得不要です。インプロセストランザクションサービスで取得する必要があるトラブルシュート情報を次の表に示します。

表C-4　インプロセストランザクションサービスで取得する必要があるトラブルシュート情報

取得先
取得情報

Cosminexus Component Containerのメッセージログ

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥cjmessage?.log

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/logs/cjmessage?.log）

Cosminexus TPBrokerのメッセージ

Cosminexus Component Containerのユーザログ

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥user_out?.log

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/logs/user_out?.log）

Cosminexus TPBrokerのメッセージ

Cosminexus Component Containerのメンテナンスログ

Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥cjmeintenance?.log

UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>/logs/cjmeintenance?.log）

Cosminexus TPBrokerのトレース情報

インプロセストランザクションサービスのステータスファイル
（J2EEサーバのejbserver.distributedtx.ots.status.directory1，またはejbserver.distributedtx.ots.status.directory2キーで指定されるディレクトリ以下のファイル）
インプロセストランザクションサービスのステータスファイルおよびステータスファイルのバックアップ

注　「?」は通番を意味します。

(4)　プログラムソースコードの移行

次に示すように運用手順を変更して移行してください。

インプロセストランザクションサービスを使用する場合，アウトプロセストランザクションサービスを使用していた場合と比べて，動作が異なります。発生条件に合致する場合，プログラムソースコードを変更する必要があります。

表C-5　プログラムソースコードの変更点

動作変更内容
発生条件
修正内容

SetRollbackOnly後のトランザクション決着時にbeforeCompletionが呼ばれません（アウトプロセストランザクションサービスを使用した場合は呼ばれます）。
Stateful Session Beanを使用し，SessionSynchronizationを実装している場合
SetRollbackOnly後のトランザクション決着時にbeforeCompletionが呼ばれることを期待しないプログラムに変更してください。

SetRollbackOnly後のトランザクション決着時にejbStoreが呼ばれません（アウトプロセストランザクションサービスを使用した場合は呼ばれます）。
Entity Beanを使用している場合
SetRollbackOnly後のトランザクション決着時にejbStoreが呼ばれることを期待しないプログラムに変更してください。

afterCompletionの引数（boolean commited）の決定方法は，アウトプロセストランザクションサービスの場合にはトップルートトランザクションの処理結果を反映していましたが，インプロセストランザクションサービスの場合には，該当するブランチと，サブオーディネートブランチの処理結果だけで決定されます。
次の条件をすべて満たす場合

複数のJ2EEサーバで，プロセス間をわたってトランザクショナルなEJB呼び出しを行う。

Stateful Session Beanを使用している。

SessionSynchronizationを実装している。

afterCompletionの引数の使い方として，トップルートトランザクションの決着結果を期待しないプログラムに変更してください。

付録D　サーバマネジャからServer Plug-inへの移行

Cosminexus Version 6では，リソースやJ2EEアプリケーションを実行，カスタマイズするためのGUIとして，サーバマネジャを提供しました。

Cosminexus Version 7では，リソースやJ2EEアプリケーションを実行，カスタマイズするためのGUIとして，Server Plug-inを提供します。

Server Plug-inを使用すると，論理サーバ，J2EEリソース，およびJ2EEアプリケーションの操作をGUIで対話的に実行できます。また，アプリケーションの開発を支援するMyEclipseと組み合わせて使用すると，アプリケーションの開発から実行までの作業を，アプリケーション開発のサイクルに沿って円滑に進められます。

アプリケーション開発のサイクルとプラグインの関係を次の図に示します。

図D-1　アプリケーション開発のサイクルとプラグインの関係

リソースやJ2EEアプリケーションの実行・カスタマイズでサーバマネジャを使用して実行していた操作は，Cosminexus Version 7ではServer Plug-inを使用して実行します。ただし，Cosminexus Version 7では，サーバマネジャを使用して実行していた操作の一部をMyEclipse，またはサーバ管理コマンドを使用して実行します。

サーバマネジャとServer Plug-inの機能の差異については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のサーバマネジャからServer Plug-inへの機能の移行に関する説明を参照してください。

ここでは，サーバマネジャからServer Plug-inへの移行について説明します。

＜この節の構成＞

付録D.1　Server Plug-inを使用する場合のシステム構成

付録D.2　システムの構築方法の差異

付録D.3　Server Plug-inのセットアップ

付録D.1　Server Plug-inを使用する場合のシステム構成

Server Plug-inを使用する場合，システム内に必ずManagement Serverを配置する必要があります。これは，J2EEサーバ上のJ2EEリソースおよびJ2EEアプリケーションの操作方法が，サーバマネジャの場合とServer Plug-inの場合で異なるためです。

サーバマネジャの場合，次の図のように，直接J2EEサーバに接続してサーバ上のJ2EEリソースおよびJ2EEアプリケーションを操作していました。

図D-2　サーバマネジャでのJ2EEサーバの操作

一方，Server Plug-inでは，次の図のように，Management Server（リモート管理機能）に接続して，J2EEサーバの操作やJ2EEサーバ上のJ2EEリソースおよびJ2EEアプリケーションを操作します。

図D-3　Server Plug-inでのJ2EEサーバの操作

このため，Server Plug-inは，Management Serverで構築した環境だけで使用できます。Server Plug-inを使用する場合のシステム構成を次の図に示します。

図D-4　Server Plug-inのシステム構成

Server Plug-inの提供状況を，Cosminexus Version 7の製品ごとに次の表に示します。

表D-1　Cosminexusの製品ごとのServer Plug-inの提供状況

Cosminexus Version 7の製品 | 適用OS
Windows | UNIX
uCosminexus Developer Standard※ | ○ | －
uCosminexus Developer Professional※ | ○ | －
uCosminexus Service Architect※ | ○ | －
uCosminexus Application Server Standard※ | ○ | ×
uCosminexus Application Server Enterprise※ | ○ | ×
uCosminexus Service Platform※ | ○ | ×
uCosminexus Operator | ○ | －
uCosminexus Client | × | －
uCosminexus Web Redirector | × | ×

（凡例）○：提供する。　×：提供しない。　－：製品が存在しない。

注※　uCosminexus Operatorをインストールしたマシンから，これらの製品をインストールしたマシンを操作できます。

付録D.2　システムの構築方法の差異

Server Plug-inは，システムの構築方法によって使用できるかどうかが異なります。システムの構築方法とServer Plug-inを使用できるかどうかの対応を，サーバマネジャと比較して次の表に示します。

表D-2　システムの構築方法とサーバマネジャ・Server Plug-inを使用できるかどうかの対応

システムの構築方法 | サーバマネジャ | Server Plug-in
Management Serverを使用して構築したシステム | Smart Composer機能でのシステム構築 | ○ | ○
運用管理ポータルでのシステム構築 | ○ | ○
Management Serverを使用しないで構築したシステム | ファイル編集とコマンド実行でのシステム構築 | ○ | ×

（凡例）○：使用できる。　×：使用できない。

Cosminexus Version 6では，システムの構築方法に関係なくサーバマネジャを使用してJ2EEサーバを操作することができました。

Cosminexus Version 7では，Smart Composer機能，または運用管理ポータルを使用してシステムを構築した場合にServer Plug-inでJ2EEサーバを操作できます。

Smart Composer機能を使用したシステムの構築については，マニュアル「Cosminexus　簡易構築・運用ガイド」のシステム構築に関する説明を参照してください。運用管理ポータルを使用したシステム構築については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

付録D.3　Server Plug-inのセットアップ

ここでは，Server Plug-inを使用するために必要な設定について説明します。

Server Plug-inを使用するためには，Management Server，Eclipseなどの設定が必要です。

Server Plug-inを使用するために必要な設定の詳細については，「2.5　Server Plug-inの設定」を参照してください。

付録E　DDの見直しの観点

作業ディレクトリ移行やインポートでは，XMLプロセッサで検証したあと，DDが仕様に準拠しているかをチェックします。作業をする前に，次の観点でDDを見直してください。

DD共通の注意事項

DDの文書型宣言に内部サブセットは記述できません。

J2EE仕様で定められたDTD／XMLスキーマ以外は参照できません。

＜この節の構成＞

付録E.1　EARファイルの見直し観点

付録E.2　RARファイルの見直し観点

付録E.3　EJB-JARファイルの見直し観点

付録E.4　WARファイルの見直し観点

付録E.1　EARファイルの見直し観点

DDをEARファイルのMETA-INF¥application.xml（Windowsの場合），またはEARファイルのMETA-INF/application.xml（UNIXの場合）に配置しているか

DDの文書型宣言に次のどれかが指定されているか

<!DOCTYPE application PUBLIC
"-//Sun Microsystems, Inc.//DTD J2EE Application 1.2//EN"
"http://java.sun.com/j2ee/dtds/application_1_2.dtd">

<!DOCTYPE application PUBLIC
"-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN"
"http://java.sun.com/dtd/application_1_3.dtd">

<application
xmlns="http://java.sun.com/xml/ns/j2ee"xmlns:
xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application_1_4.xsd"
version="1.4">

moduleで指定されたファイルがEARファイルにあるか

付録E.2　RARファイルの見直し観点

DDをRARファイルのMETA-INF¥ra.xml（Windowsの場合），またはRARファイルのMETA-INF/ra.xml（UNIXの場合）に配置しているか

DDの文書型宣言に次に示すものが指定されているか

<!DOCTYPE connector PUBLIC
"-//Sun Microsystems, Inc.//DTD Connector 1.0//EN"
"http://java.sun.com/dtd/connector_1_0.dtd">

transaction-supportに「NoTransaction」，「LocalTransaction」または「XATransaction」のどれかが指定されているか

authentication-mechanism-typeに「BasicPassword」または「Kerbv5」のどちらかが指定されているか

security-permission-specに適切な値が指定されているか

付録E.3　EJB-JARファイルの見直し観点

DDをJARファイルのMETA-INF¥ejb-jar.xml（Windowsの場合），またはJARファイルのMETA-INF/ejb-jar.xml（UNIXの場合）に配置しているか

DDの文書型宣言に次のどれかが指定されているか

<!DOCTYPE ejb-jar PUBLIC
"-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
"http://java.sun.com/j2ee/dtds/ejb-jar_1_1.dtd">

<!DOCTYPE ejb-jar PUBLIC
"-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN"
"http://java.sun.com/dtd/ejb-jar_2_0.dtd">

<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd"
version="2.1">

ejb-nameが正しく指定されているか

home，local-homeのどちらか（または両方）が指定されているか

homeを指定した場合，remoteも指定しているか

local-homeを指定した場合，localも指定しているか

ejb-classが正しく指定されているか

env-entry-typeに，「java.lang.Boolean」，「java.lang.Byte」，「java.lang.Character」，「java.lang.String」，「java.lang.Short」，「java.lang.Integer」，「java.lang.Long」，「java.lang.Float」または「java.lang.Double」のどれかが指定されているか

env-entry-typeが「java.lang.Character」の場合，env-entry-valueに1文字だけ指定しているか

env-entry-typeで扱える値がenv-entry-valueに指定されているか

ejb-ref-typeに「Entity」または「Session」のどちらかが指定されているか

ejb-local-refで参照するEJBに「local」が定義されているか

ejb-refで参照するEJBに「remote」が定義されているか

ejb-ref-nameでリンクされるEJBの種別は，ejb-ref-typeで指定される種別と一致しているか

ejb-ref-nameでリンクされるEJBのホームインタフェース名と，homeで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのリモートインタフェース名と，remoteで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのローカルホームインタフェース名と，local-homeで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのローカルインタフェース名と，localで指定されたインタフェース名が一致しているか

session-typeに「Stateful」または「Stateless」のどちらかが指定されているか

transaction-typeに「Bean」または「Container」のどちらかが指定されているか

transaction-typeに「Bean」が指定されている場合，「container-transaction」を指定しないようにしているか

persistence-typeに「Bean」または「Container」のどちらかが指定されているか

reentrantに次の値が指定されているか

EJB2.0の場合：「True」または「False」

EJB2.1の場合：「true」または「false」

cmp-versionに「1.x」または「2.x」のどちらかが指定されているか

cmp-versionに「2.x」が指定されている場合，abstract-schema-nameが指定されているか

field-nameまたはcmr-field-nameに正しく値が指定されているか

field-nameまたはcmr-field-nameの先頭文字は小文字になっているか

cmp-versionに「1.x」が指定されている場合，cmp-fieldに対応するフィールドがあるか

cmp-versionに「2.x」が指定されている場合，cmp-fieldに対応するアクセスメソッドがあるか

cascade-deleteが指定されている場合，multiplicityに「One」が指定されているか

multiplicityに「One」または「Many」のどちらかが指定されているか

query-methodで指定されたメソッド名が正しいか

query-methodのmethod-nameにアスタリスク（*）を指定しないようにしているか

cmr-fieldを指定した場合，そのEJBにlocalも指定しているか

cmr-field-typeに「java.util.Collection」または「java.util.Set」のどちらかが指定されているか

acknowledge-modeに「Auto-acknowledge」または「Dups-ok-acknowledge」のどちらかが指定されているか

destination-typeに「javax.jms.Queue」または「javax.jms.Topic」のどちらかが指定されているか

subscription-durabilityに「Durable」または「NonDurable」のどちらかが指定されているか

Session Bean，Entity Beanの場合，trans-attributeに「NotSupported」，「Supports」，「Required」，「RequiresNew」，「Mandatory」または「Never」のどれかが指定されているか

Message-driven Beanの場合，trans-attributeに「NotSupported」，「Required」のどちらかが指定されているか

methodで指定されたメソッド名が正しいか

付録E.4　WARファイルの見直し観点

DDをWARファイルのWEB-INF¥web.xml（Windowsの場合），またはWARファイルのWEB-INF/web.xml（UNIXの場合）に配置しているか

DDの文書型宣言に次のどれかが指定されているか

<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">

env-entry-typeに「java.lang.Boolean」，「java.lang.Byte」，「java.lang.Character」，「java.lang.String」，「java.lang.Short」，「java.lang.Integer」，「java.lang.Long」，「java.lang.Float」または「java.lang.Double」のどれかが指定されているか

env-entry-typeが「java.lang.Character」の場合，env-entry-valueに1文字だけ指定しているか

env-entry-typeで扱える値がenv-entry-valueに指定されているか

ejb-ref-typeに「Entity」または「Session」のどちらかが指定されているか

ejb-local-refで参照するEJBに「local」が定義されているか

ejb-refで参照するEJBに「remote」が定義されているか

ejb-ref-nameでリンクされるEJBの種別は，ejb-ref-typeで指定される種別と一致しているか

ejb-ref-nameでリンクされるEJBのホームインタフェース名と，homeで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのリモートインタフェース名と，remoteで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのローカルホームインタフェース名と，local-homeで指定されたインタフェース名が一致しているか

ejb-ref-nameでリンクされるEJBのローカルインタフェース名と，localで指定されたインタフェース名が一致しているか

jsp-fileに指定されたファイルがWARにあるか

transport-guaranteeに「NONE」，「INTEGRAL」または「CONFIDENTIAL」のどれかが指定されているか

auth-methodに「BASIC」，「FORM」，または「CLIENT-CERT」のどれかが指定されているか

次に示すタグの値が重複していないか

固有の値を指定するタグ | 固有の値を指定する範囲 | 値が重複している場合の現象
<filter>で定義する<filter-name> | <web-app>から</web-app>の間※1 | Servlet2.4の場合，インポート時にエラーになる。
<servlet>で定義する<servlet-name> | <web-app>から</web-app>の間※2
<resource-env-ref-name> | <web-app>から</web-app>の間
<res-ref-name> | <web-app>から</web-app>の間
<security-role>で定義する<role-name> | <web-app>から</web-app>の間※3
<env-entry-name> | <web-app>から</web-app>の間
<ejb-ref>または<ejb-local-ref>で定義する<ejb-ref-name> | <web-app>から</web-app>の間

注※1

<filter>で定義する<filter-name>とは重複できません。<filter-mapping>で定義する<filter-name>とは重複できます。

注※2

<servlet>で定義する<servlet-name>とは重複できません。<filter-mapping>または<servlet-mapping>で定義する<servlet-name>とは重複できます。

注※3

<security-role>で定義する<role-name>とは重複できません。<run-as>，<security-role-ref>または<auth-constraint>で定義する<role-name>とは重複できます。

付録F　Oracleアクセスライブラリの再作成

Cosminexus DABroker Libraryでは，OracleにアクセスするためのライブラリとしてOracleアクセスライブラリを提供しています。Oracleアクセスライブラリは，OracleのOCIプログラムです。OCIプログラムは，Oracleのインストール状況によって，その作成方法（make方法）が異なる場合があります。Oracleのインストールの状況によっては，Cosminexus DABroker Libraryが提供しているOracleアクセスライブラリではOracleにアクセスできないため，ユーザの環境に合わせたOracleアクセスライブラリの再作成が必要になります。

ここでは，Oracleアクセスライブラリを再作成する方法について，OSごとに説明します。

AIXの場合

HP-UX（IPF）の場合

Linux（x86／AMD64 & Intel EM64T）の場合

Linux（IPF）の場合

Solarisの場合

＜この節の構成＞

付録F.1　AIXの場合

付録F.2　HP-UX（IPF）の場合

付録F.3　Linux（x86／AMD64 & Intel EM64T）の場合

付録F.4　Linux（IPF）の場合

付録F.5　Solarisの場合

付録F.6　Oracle9iまたはOracle10gで追加されたデータ型への対応状況

付録F.1　AIXの場合

AIXを使用する場合のOracleアクセスライブラリの再作成方法について説明します。

＜この項の構成＞

(1)　適用範囲

(2)　Oracleアクセスライブラリ再作成の手順

(1)　適用範囲

Oracleアクセスライブラリを作成する機能は，次のOracleシステムを運用している場合に適用してください。

Oracle9i R9.2.0を使用している場合

Oracle10g R10.1.0を使用している場合

(2)　Oracleアクセスライブラリ再作成の手順

Oracleアクセスライブラリを再作成する手順を次に説明します。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

Cosminexus DABroker Libraryの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，Cosminexus DABroker Libraryのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

Cosminexus DABroker Libraryの既存ライブラリのバックアップ
Cosminexus DABroker Libraryの既存ライブラリのバックアップを次のように取得してください。
cd　/opt/DABroker/lib

Oracle9i R9.2.0を使用している場合
mv　libdaO7920.a　　libdaO7920.a_bk

Oracle10g R10.1.0を使用している場合
mv　libdaO7101.a　　libdaO7101.a_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO8920.a　　libdaO8920.a_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO8101.a　　libdaO8101.a_bk

提供サンプルメイクファイルの修正
Cosminexus DABroker Libraryでは，表F-1から表F-4に示す，Oracleアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。
なお，表中の番号は，次の内容を示しています。

1：Cosminexus DABroker Libraryアクセスライブラリ名称

修正しないでください。

2：Cosminexus DABroker Library共用ライブラリ

修正しないでください。

3：Oracleクライアントライブラリ，およびOS提供ライブラリ

Cosminexus DABroker LibraryのOracleアクセスライブラリは，OracleのOCIプログラムです。Oracleのマニュアルを参照し，OCIプログラム作成時に必要なOracleクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：Cosminexus DABroker Library共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

Oracle9i R9.2.0を使用している場合
ファイル名：/opt/DABroker/sample/oramake7920

表F-1　Oracle9i R9.2.0サンプルメイクファイル（AIXの場合）

番号
定義文

1

PROGRAM     = libdaO7920.a

1

PROGRAM1    = libdaO7920.o

2

LIBS        = -L /opt/DABroker/lib　-ldacommon

3

LIBS1       = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

             -bnoentry -lm -lc_r

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -G

4

OBJS        = /opt/DABroker/obj/dacdcntl.o ¥

4

             /opt/DABroker/obj/daO7920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                  $(ORALIB)
            ar rv $(PROGRAM) $(PROGRAM1)
            rm -f $(PROGRAM1)
            echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
ファイル名：/opt/DABroker/sample/oramake8920

表F-2　Oracle9i R9.2.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（AIXの場合）

番号
定義文

1

PROGRAM     = libdaO8920.a

1

PROGRAM1    = libdaO8920.o

2

LIBS        = -L /opt/DABroker/lib　-ldacommon

3

LIBS1       = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

             -bnoentry -lm -lc_r

3

ORALIB      = -L $(ORACLE_HOME)/lib32 -lclntsh

3

LDFLAGS     = -G

4

OBJS        = /opt/DABroker/obj/dacd8920.o ¥

4

             /opt/DABroker/obj/daO8920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                  $(ORALIB)
            ar rv $(PROGRAM) $(PROGRAM1)
            rm -f $(PROGRAM1)
            echo "done"

Oracle10g R10.1.0 を使用している場合
ファイル名：/opt/DABroker/sample/oramake7101

表F-3　Oracle10g R10.1.0サンプルメイクファイル（AIXの場合）

番号
定義文

1

PROGRAM     = libdaO7101.a

1

PROGRAM1    = libdaO7101.o

2

LIBS        = -L /opt/DABroker/lib　-ldacommon

3

LIBS1       = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

             -bnoentry -lm -lc_r

3

ORALIB      = -L $(ORACLE_HOME)/lib32 -lclntsh

3

LDFLAGS     = -G

4

OBJS        = /opt/DABroker/obj/dacdcntl.o ¥

4

             /opt/DABroker/obj/daO7101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                  $(ORALIB)
            ar rv $(PROGRAM) $(PROGRAM1)
            rm -f $(PROGRAM1)
            echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
ファイル名：/opt/DABroker/sample/oramake8101

表F-4　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（AIXの場合）

番号
定義文

1

PROGRAM     = libdaO8101.a

1

PROGRAM1    = libdaO8101.o

2

LIBS        = -L /opt/DABroker/lib　-ldacommon

3

LIBS1       = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

             -bnoentry -lm -lc_r

3

ORALIB      = -L $(ORACLE_HOME)/lib32 -lclntsh

3

LDFLAGS     = -G

4

OBJS        = /opt/DABroker/obj/dacd8101.o ¥

4

             /opt/DABroker/obj/daO8101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                  $(ORALIB)
            ar rv $(PROGRAM) $(PROGRAM1)
            rm -f $(PROGRAM1)echo "done"

Cosminexus DABroker LibraryのOracleアクセスライブラリの再作成
サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。
（メイクファイル実行手順　Bシェルを使用の場合）
ORACLE_HOME＝ORACLE HOMEディレクトリ
export　ORACLE_HOME
DABDIR＝/opt/DABroker
export　DABDIR

Oracle9i R9.2.0を使用している場合
make -f oramake7920（修正後のメイクファイルを実行する）

Oracle10g R10.1.0を使用している場合
make -f oramake7101（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
make -f orameke8920（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
make -f orameke8101（修正後のメイクファイルを実行する）

再作成後のOracleアクセスライブラリのCosminexus DABroker Libraryのライブラリ格納用ディレクトリへのコピー
makeコマンドを実行したディレクトリ環境下で再作成したOracleアクセスライブラリを次のようにコピーしてください。
再作成したOracleアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Oracle9i R9.2.0を使用している場合
cp　libdaO7920.a　　/opt/DABroker/lib/libdaO7920.a

Oracle10g R10.1.0を使用している場合
cp　libdaO7101.a　　/opt/DABroker/lib/libdaO7101.a

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO8920.a　　/opt/DABroker/lib/libdaO8920.a

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO8101.a　　/opt/DABroker/lib/libdaO8101.a

Cosminexus DABroker Libraryの再セットアップ
作成したOracleアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，Cosminexus DABroker Libraryのセットアップコマンドを実行してください。

付録F.2　HP-UX（IPF）の場合

HP-UX（IPF）を使用する場合のOracleアクセスライブラリの再作成方法について説明します。

＜この項の構成＞

(1)　適用範囲

(2)　Oracleアクセスライブラリ再作成の手順

(1)　適用範囲

Oracleアクセスライブラリを作成する機能は，次のOracleシステムを運用している場合に適用してください。

Oracle9i R9.2.0

Oracle10g R10.1.0

(2)　Oracleアクセスライブラリ再作成の手順

Cosminexus DABroker Libraryでは，Oracleが提供している各バージョンのOCIサンプルメイクファイルにCosminexus DABroker Library専用のリンケージラインを埋め込んで提供しています。使用しているOracleのバージョンに従い，次の手順で実行してください。

次の手順は，必ず，運用ディレクトリが/opt/DABroker の環境で実行してください。

Cosminexus DABroker Libraryの運用ディレクトリを/opt/DABroker 以外に設定している場合は，いったん，Cosminexus DABroker Libraryのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

Cosminexus DABroker Library既存ライブラリのバックアップ
Cosminexus DABroker Libraryの既存ライブラリのバックアップを次のように取得してください。
cd　/opt/DABroker/lib

Oracle9i R9.2.0を使用している場合
mv　libdaO7920.so　　libdaO7920.so_bk

Oracle10g R10.1.0を使用している場合
mv　libdaO7101.so　　libdaO7101.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO8920.so　　libdaO8920.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0 を使用している場合
mv　libdaO8101.so　　libdaO8101.so_bk

提供サンプルメイクファイルの修正
Cosminexus DABroker Libraryでは，表F-5から表F-8に示す，各Oracleアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。
なお，表中の番号は，次の内容を示しています。

1：Cosminexus DABroker Libraryアクセスライブラリ名称

修正しないでください。

2：Cosminexus DABroker Library共用ライブラリ

修正しないでください。

3：Oracleクライアントライブラリ，およびOS提供ライブラリ

Cosminexus DABroker LibraryのOracleアクセスライブラリは，OracleのOCIプログラムです。Oracleのマニュアルを参照し，OCIプログラム作成時に必要なOracleクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：Cosminexus DABroker Library共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

Oracle9i R9.2.0を使用している場合
ファイル名：/opt/DABroker/sample/oramake7920

表F-5　Oracle9i R9.2.0 サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（HP-UX（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO7920.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

3

LIBS1       = -lpthread -lcl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -b +s

4

OBJS        = $(DABDIR)/obj/dacdcntl.o  $(DABDIR)/obj/daO7920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(ORALIB)
            echo "done"

Oracle10g R10.1.0を使用している場合
ファイル名：/opt/DABroker/sample/oramake7101

表F-6　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（HP-UX（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO7101.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

3

LIBS1       = -lpthread -lcl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -b +s

4

OBJS        = $(DABDIR)/obj/dacdcntl.o  $(DABDIR)/obj/daO7101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(ORALIB)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake8920

表F-7　Oracle9i R9.2.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（HP-UX（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO8920.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

3

LIBS1       = -lpthread -lcl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -b +s

4

OBJS        = $(DABDIR)/obj/dacd8920.o  $(DABDIR)/obj/daO8920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(ORALIB)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake8101

表F-8　Oracle10g R10.1.0 サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（HP-UX（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO8101.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

3

LIBS1       = -lpthread -lcl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -b +s

4

OBJS        = $(DABDIR)/obj/dacd8110.o  $(DABDIR)/obj/daO8110.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(ORALIB)
            echo "done"

Cosminexus DABroker LibraryのOracleアクセスライブラリの再作成
サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。
（メイクファイル実行手順　B シェルを使用の場合）
ORACLE_HOME＝ORACLE HOMEディレクトリ
export　ORACLE_HOME
DABDIR＝/opt/DABroker
export　DABDIR

Oracle9i R9.2.0を使用している場合
make -f oramake7920（修正後のメイクファイルを実行する）

Oracle10g R10.1.0を使用している場合
make -f oramake7101（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
make -f orameke8920（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
make -f orameke8101（修正後のメイクファイルを実行する）

再作成後のOracleアクセスライブラリのCosminexus DABroker Libraryのライブラリ格納用ディレクトリへのコピー
makeコマンドを実行したディレクトリ環境下で再作成したOracleアクセスライブラリを次のようにコピーしてください。
再作成したOracleアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Oracle9i R9.2.0を使用している場合
cp　libdaO7920.so　　/opt/DABroker/lib/libdaO7920.so

Oracle10g R10.1.0を使用している場合
cp　libdaO7101.so　　/opt/DABroker/lib/libdaO7101.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO8920.so　　/opt/DABroker/lib/libdaO8920.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0 を使用している場合
cp　libdaO8101.so　　/opt/DABroker/lib/libdaO8101.so

Cosminexus DABroker Libraryの再セットアップ
作成したOracleアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，Cosminexus DABroker Libraryのセットアップコマンドを実行してください。

付録F.3　Linux（x86／AMD64 & Intel EM64T）の場合

Linux（x86／AMD64 & Intel EM64T）を使用する場合のOracleアクセスライブラリの再作成方法について説明します。

＜この項の構成＞

(1)　適用範囲

(2)　Oracleアクセスライブラリ再作成の手順

(1)　適用範囲

Oracleアクセスライブラリを作成する機能は，次のOracleシステムを運用している場合に適用してください。

Oracle9i R9.2.0

Oracle10g R10.1.0

(2)　Oracleアクセスライブラリ再作成の手順

Cosminexus DABroker Libraryでは，Oracleが提供している各バージョンのOCIサンプルメイクファイルにCosminexus DABroker Library専用のリンケージラインを埋め込んで提供しています。使用しているOracleのバージョンに従い，次の手順で実行してください。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

Cosminexus DABroker Libraryの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，Cosminexus DABroker Libraryのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

Cosminexus DABroker Libraryの既存ライブラリのバックアップ
Cosminexus DABroker Libraryの既存ライブラリのバックアップを次のように取得してください。
cd　/opt/DABroker/lib

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO7920.so　　libdaO7920.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO7101.so　　libdaO7101.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO8920.so　　libdaO8920.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO8101.so　　libdaO8101.so_bk

提供サンプルメイクファイルの修正
Cosminexus DABroker Libraryでは，表F-9から表F-12に示す，各Oracleアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。
なお，表中の番号は，次の内容を示しています。

1：Cosminexus DABroker Libraryアクセスライブラリ名称

修正しないでください。

2：Cosminexus DABroker Library共用ライブラリ

修正しないでください。

3：Oracleクライアントライブラリ，およびOS提供ライブラリ

Cosminexus DABroker LibraryのOracleアクセスライブラリは，OracleのOCIプログラムです。Oracleのマニュアルを参照し，OCIプログラム作成時に必要なOracleクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：Cosminexus DABroker Library共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

ファイル名：/opt/DABroker/sample/oramake7920

表F-9　Oracle9i R9.2.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Linux（x86／AMD64 & Intel EM64T）の場合）

番号
定義文

1

PROGRAM     = libdaO7920.so

2

LIBS        = -L $(DABDIR)/lib -ldacommon

3

ORALIB      = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS     = -ldl -lnsl -lpthread -G

4

OBJS        = $(DABDIR)/obj/dacdcntl.o  $(DABDIR)/obj/daO7920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake7101

表F-10　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Linux（x86／AMD64 & Intel EM64T）の場合）

番号
定義文

1

PROGRAM     = libdaO7101.so

2

LIBS        = -L $(DABDIR)/lib -ldacommon

3

ORALIB      = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS     = -ldl -lnsl -lpthread -G

4

OBJS        = $(DABDIR)/obj/dacdcntl.o  $(DABDIR)/obj/daO7101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake8920

表F-11　Oracle9i R9.2.0 サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Linux（x86／AMD64 & Intel EM64T）の場合）

番号
定義文

1

PROGRAM     = libdaO8920.so

2

LIBS        = -L $(DABDIR)/lib -ldacommon

3

ORALIB      = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS     = -ldl -lnsl -lpthread -G

4

OBJS        = $(DABDIR)/obj/dacd8920.o  $(DABDIR)/obj/daO8920.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake8101

表F-12　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Linux（x86／AMD64 & Intel EM64T）の場合）

番号
定義文

1

PROGRAM     = libdaO8101.so

2

LIBS        = -L $(DABDIR)/lib -ldacommon

3

ORALIB      = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS     = -ldl -lnsl -lpthread -G

4

OBJS        = $(DABDIR)/obj/dacd8101.o  $(DABDIR)/obj/daO8101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
            echo "done"

Cosminexus DABroker LibraryのOracleアクセスライブラリの再作成
サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。
（メイクファイル実行手順　Bシェルを使用の場合）
ORACLE_HOME＝ORACLE HOME ディレクトリ
export　ORACLE_HOME
DABDIR＝/opt/DABroker
export　DABDIR

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
make -f oramake7920（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
make -f oramake7101（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，R9.2.0を使用している場合
make -f orameke8920（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
make -f orameke8101（修正後のメイクファイルを実行する）

再作成後のOracleアクセスライブラリのCosminexus DABroker Libraryのライブラリ格納用ディレクトリへのコピー
makeコマンドを実行したディレクトリ環境下で再作成したOracleアクセスライブラリを次のようにコピーしてください。
再作成したOracleアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO7920.so　　/opt/DABroker/lib/libdaO7920.so

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO7101.so　　/opt/DABroker/lib/libdaO7101.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO8920.so　　/opt/DABroker/lib/libdaO8920.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO8101.so　　/opt/DABroker/lib/libdaO8101.so

Cosminexus DABroker Libraryの再セットアップ
作成したOracleアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，Cosminexus DABroker Libraryのセットアップコマンドを実行してください。

付録F.4　Linux（IPF）の場合

Linux（IPF）を使用する場合のOracleアクセスライブラリの再作成方法について説明します。

＜この項の構成＞

(1)　適用範囲

(2)　Oracleアクセスライブラリ再作成の手順

(1)　適用範囲

Oracleアクセスライブラリを作成する機能は，次のOracleシステムを運用している場合に適用してください。

Oracle10g R10.1.0

(2)　Oracleアクセスライブラリ再作成の手順

Cosminexus DABroker Libraryでは，Oracleが提供している各バージョンのOCIサンプルメイクファイルにCosminexus DABroker Library専用のリンケージラインを埋め込んで提供しています。使用しているOracleのバージョンに従い，次の手順で実行してください。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

Cosminexus DABroker Libraryの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，Cosminexus DABroker Libraryのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

Cosminexus DABroker Library既存ライブラリのバックアップ
Cosminexus DABroker Libraryの既存ライブラリのバックアップを次のように取得してください。
cd　/opt/DABroker/lib

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO7101.so　　libdaO7101.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO8101.so　　libdaO8101.so_bk

提供サンプルメイクファイルの修正
Cosminexus DABroker Libraryでは，表F-13から表F-14に示す，各Oracleアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。
なお，表中の番号は，次の内容を示しています。

1：Cosminexus DABroker Libraryアクセスライブラリ名称

修正しないでください。

2：Cosminexus DABroker Library共用ライブラリ

修正しないでください。

3：Oracleクライアントライブラリ，およびOS提供ライブラリ

Cosminexus DABroker LibraryのOracleアクセスライブラリは，OracleのOCIプログラムです。Oracleのマニュアルを参照し，OCIプログラム作成時に必要なOracleクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：Cosminexus DABroker Library共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

ファイル名：/opt/DABroker/sample/oramake7101

表F-13　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Linux（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO7101.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

2

LIBS1       = -lpthread -ldl -lnsl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -shared

4

OBJS        = $(DABDIR)/obj/dacdcntl.o  $(DABDIR)/obj/daO7101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(RRALIB)
            echo "done"

ファイル名：/opt/DABroker/sample/oramake8101

表F-14　Oracle10g R10.1.0 サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Linux（IPF）の場合）

番号
定義文

1

PROGRAM     = libdaO8101.so

2

LIBS        = -L /opt/DABroker/lib -ldacommon

2

LIBS1       = -lpthread -ldl -lnsl

3

ORALIB      = -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS     = -shared

4

OBJS        = $(DABDIR)/obj/dacd8101.o  $(DABDIR)/obj/daO8101.a

5

all:        $(PROGRAM)

5

$(PROGRAM): $(OBJS)
            echo "Linking $(PROGRAM) ..."
            $(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥
                     $(ORALIB)
            echo "done"

Cosminexus DABroker LibraryのOracleアクセスライブラリの再作成
サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。
（メイクファイル実行手順　Bシェルを使用の場合）
ORACLE_HOME＝ORACLE HOMEディレクトリ
export　ORACLE_HOME
DABDIR＝/opt/DABroker
export　DABDIR

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
make -f oramake7101（修正後のメイクファイルを実行する）

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
make -f orameke8101（修正後のメイクファイルを実行する）

再作成後のOracleアクセスライブラリのCosminexus DABroker Libraryのライブラリ格納用ディレクトリへのコピー
makeコマンドを実行したディレクトリ環境下で再作成したOracleアクセスライブラリを次のようにコピーしてください。
再作成したOracleアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO7101.so　　/opt/DABroker/lib/libdaO7101.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO8101.so　　/opt/DABroker/lib/libdaO8101.so

Cosminexus DABroker Libraryの再セットアップ
作成したOracleアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，Cosminexus DABroker Libraryのセットアップコマンドを実行してください。

付録F.5　Solarisの場合

Solarisを使用する場合のOracleアクセスライブラリの再作成方法について説明します。

＜この項の構成＞

(1)　適用範囲

(2)　Oracleアクセスライブラリ再作成の手順

(1)　適用範囲

Oracleアクセスライブラリを作成する機能は，次のOracleシステムを運用している場合に適用してください。

Oracle9i R9.0.1

Oracle9i R9.2.0

Oracle10g R10.1.0

また，Oracleアクセスライブラリを作成する機能を使用するには，Sun WorkShop Cコンパイラが必要です。

(2)　Oracleアクセスライブラリ再作成の手順

Oracleアクセスライブラリを再作成する手順を次に説明します。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerとなっている環境で実行してください。Cosminexus DABroker Libraryの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，Cosminexus DABroker Libraryのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

Cosminexus DABroker Library既存ライブラリのバックアップ
Cosminexus DABroker Libraryの既存ライブラリのバックアップを次のように取得してください。
cd　/opt/DABroker/lib

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.0.1を使用している場合
mv　libdaO7901.so　　libdaO7901.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO7920.so　　libdaO7920.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO7101.so　　libdaO7101.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.0.1を使用している場合
mv　libdaO8901.so　　libdaO8901.so_bk

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
mv　libdaO8920.so　　libdaO8920.so_bk

Cosminexus DABroker Library のデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
mv　libdaO8101.so　　libdaO8101.so_bk

提供サンプルメイクファイルの修正
Cosminexus DABroker Libraryでは，表F-15から表F-20に示す，各Oracleアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，サンプルメイクファイルを修正して使用してください。なお，表中の番号は，次の内容を示しています。

1：Cosminexus DABroker Libraryアクセスライブラリ名称

修正しないでください。

2：Cosminexus DABroker Library共用ライブラリ

修正しないでください。

3：Oracleクライアントライブラリ，およびOS提供ライブラリ

Cosminexus DABroker LibraryのOracleアクセスライブラリは，OracleのOCIプログラムです。Oracleのマニュアルを参照し，OCIプログラム作成時に必要なOracleクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：Cosminexus DABroker Library共用オブジェクトファイル

修正しないでください。

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.0.1 を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms7901.mk

表F-15　Oracle9i R9.0.1サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO7901.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacdcntl.o  $(DABLIB_HOME)/obj/daO7901.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms7920.mk

表F-16　Oracle9i R9.2.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO7920.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacdcntl.o  $(DABLIB_HOME)/obj/daO7920.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms7101.mk

表F-17　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO7101.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacdcntl.o  $(DABLIB_HOME)/obj/daO7101.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.0.1を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms8901.mk

表F-18　Oracle9i R9.0.1サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO8901.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacd8901.o  $(DABLIB_HOME)/obj/daO8901.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms8920.mk

表F-19　Oracle9i R9.2.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO8920.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacd8920.o  $(DABLIB_HOME)/obj/daO8920.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
ファイル名：/opt/DABroker/sample/dab_demo_rdbms8101.mk

表F-20　Oracle10g R10.1.0サンプルメイクファイル（Cosminexus DABroker Libraryのデータベース種別でOracle8i指定時）（Solarisの場合）

番号
定義文

1

PROGRAM         = libdaO8101.so

2

LIBS            = -L $(DABLIB_HOME)/lib -ldacommon

3

ORALIB          = -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS         = -lposix4 -lthread -ldl -lc -lnsl -lsocket -G

4

OBJS            = $(DABLIB_HOME)/obj/dacd8101.o  $(DABLIB_HOME)/obj/daO8101.a

4

all:            $(PROGRAM)

4

$(PROGRAM):     $(OBJS)
               echo "Linking $(PROGRAM) ..."
               ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)
               echo "done"

Cosminexus DABroker LibraryのOracleアクセスライブラリの再作成
サンプルメイクファイルを修正後，次の環境変数を入力し，シェルを実行してください。なお，シェルを実行するときは，カレントディレクトリをシェルファイルがあるディレクトリに移動してください。
（メイクファイル実行手順　標準シェルを使用の場合）
ORACLE_HOME ＝ ORACLE HOMEディレクトリ
export　ORACLE_HOME
DABDIR ＝ /opt/DABroker
export　DABDIR

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.0.1を使用している場合
$ sh ./dab_rdbms7901.sh

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
$ sh ./dab_rdbms7920.sh

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
$ sh ./dab_rdbms7101.sh

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.0.1を使用している場合
$ sh ./dab_rdbms8901.sh

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
$ sh ./dab_rdbms8920.sh

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
$ sh ./dab_rdbms8101.sh

再作成後のOracleアクセスライブラリのCosminexus DABroker Libraryのライブラリ格納用ディレクトリへのコピー
makeコマンドを実行したディレクトリ環境下で再作成したOracleアクセスライブラリを次のようにコピーしてください。
再作成したOracleアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.0.1を使用している場合
cp　libdaO7901.so　　/opt/DABroker/lib/libdaO7901.so

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO7920.so　　/opt/DABroker/lib/libdaO7920.so

Cosminexus DABroker Libraryのデータベース種別にOracleを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO7101.so　　/opt/DABroker/lib/libdaO7101.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.0.1を使用している場合
cp　libdaO8901.so　　/opt/DABroker/lib/libdaO8901.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle9i R9.2.0を使用している場合
cp　libdaO8920.so　　/opt/DABroker/lib/libdaO8920.so

Cosminexus DABroker Libraryのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0を使用している場合
cp　libdaO8101.so　　/opt/DABroker/lib/libdaO8101.so

Cosminexus DABroker Libraryの再セットアップ
作成したOracleアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，Cosminexus DABroker Libraryのセットアップコマンドを実行してください。

付録F.6　Oracle9iまたはOracle10gで追加されたデータ型への対応状況

Oracle9i，またはOracle10gで追加されたデータ型に対するCosminexus DABroker Libraryの対応状況を次の表に示します。

表F-21　Oracle9iで追加されたデータ型

データ型 | Cosminexus DABroker Libraryでのサポート状況
TIMESTAMP(fractional_seconds_precision) | 未サポート
TIMESTAMP(fractional_seconds_precision) WITH TIME ZONE | 未サポート
TIMESTAMP(fractional_seconds_precision) WITH LOCAL TIME ZONE | 未サポート
INTERVAL YEAR(year_precision) TO MONTH | 未サポート
INTERVAL DAY(day_precision) TO SECOND (fractional_seconds_precision) | 未サポート

表F-22　Oracle10gで追加されたデータ型

データ型 | Cosminexus DABroker Libraryでのサポート状況
BINARY_FLOAT | 未サポート
BINARY_DOUBLE | 未サポート

付録G　ベーシックモードの利用（互換用機能）

互換用のサーバの動作モードとして，ベーシックモードがあります。ベーシックモードは，J2EEサーバモードの一つです。単一のデータベースだけのリソースをトランザクションで使用するシステムに適用できます。旧バージョンとの互換性を重視したモードです。ここでは，ベーシックモードの利用について説明します。旧バージョンとの互換用機能については，マニュアル「Cosminexus　機能解説」を参照してください。

なお，ベーシックモードは，1.4モードに比べて，使用できる機能に制限があります。J2EEサーバモードを使用する場合は，1.4モードを使用することをお勧めします。

＜この節の構成＞

付録G.1　ベーシックモードの設定

付録G.2　データソースの設定

付録G.1　ベーシックモードの設定

動作モードは，usrconf.propertiesのejbserver.server.j2ee.featureキーで変更できます。ベーシックモードを使用する場合には，「ejbserver.server.j2ee.feature=1.3basic」を指定します。

なお，旧バージョンでベーシックモードを使用していた場合，Cosminexusをアップグレードインストールしたときには，J2EEサーバの動作モードはベーシックモードになっています。新規インストールした場合には，J2EEサーバの動作モードは1.4モードになっています。

付録G.2　データソースの設定

ベーシックモードを使用する場合，データソースを使用してデータベースに接続できます。データソースを利用して接続できるデータベースには，HiRDB，Oracle9iがあります。なお，データソースを使用する場合，データベースとの接続にはCosminexus DABroker Libraryを使用します。また，使用できるトランザクションの種類は，ローカルトランザクションだけとなります。

注意

データソースもDB Connectorと同様の使用方法でJ2EEアプリケーションから利用できますが，データベース接続には1.4モードでのDB Connectorの使用をお勧めします。DB Connectorを利用したデータベース接続は，データソースを利用したデータベース接続と比較して，トランザクション管理のパフォーマンスを向上できます。

また，データベース接続にデータソースを使用できるのは，J2EEサーバの動作モードがベーシックモードの場合だけです。1.4モードでデータベースに接続する場合には，DB Connectorを使用してください。

Cosminexusでは，データソースからDB Connectorへの移行をサポートしています。データソースからDB Connectorへの移行方法については，「付録A　Cosminexus Version 6およびCosminexus Version 7からの移行」を参照してください。

運用管理ポータルでシステムを構築する場合と，ファイル編集とコマンド実行でシステムを構築する場合で，データソースの設定方法が異なります。それぞれの設定方法について説明します。

＜この項の構成＞

(1)　運用管理ポータルでシステムを構築する場合

(2)　ファイル編集とコマンド実行でシステムを構築する場合

(1)　運用管理ポータルでシステムを構築する場合

運用管理ポータルでは，開発環境（サーバ管理コマンドが動作する環境）で設定したデータソースを，運用環境（データソースを使用する環境）に移す作業をサポートしています。開発環境でサーバ管理コマンドを使用してデータソースのプロパティの設定，接続の確認などを実施したあとで，運用管理ポータルを使用して運用環境にデータソースをインポートします。

データソースの設定の流れを次の図に示します。

図G-1　データソースの設定の流れ（運用管理ポータルでのシステム構築）

図中の1.～5.について説明します。なお，ここでは，開発環境と運用環境は，同じホストにある別々のJ2EEサーバ上にあると仮定して説明します。

開発環境で，サーバ管理コマンドを使用してデータソースをインポートします。
cjimportresコマンドを使用して，データソースをインポートします。

開発環境で，サーバ管理コマンドを使用してデータソースのプロパティを定義します。
cjgetrespropコマンドでデータソース属性ファイルを取得し，ファイル編集後に，cjsetrespropコマンドで編集内容を反映させます。
なお，使用するデータベースの種類によって，プロパティの定義内容が異なります。

開発環境で，サーバ管理コマンドを使用してデータソースの接続テストを実施します。
cjtestresコマンドを使用して，データソースの接続テストを実施します。

運用環境で設定済みのデータソースから，サーバ管理コマンドを使用してデータソース属性ファイルを取得します。
cjgetrespropコマンドを使用して，データソース属性ファイルを取得します。

参考

同一のデータソースは，同一のJ2EEサーバにインポートできません。開発環境のJ2EEサーバと運用環境のJ2EEサーバが同一の場合は，運用環境のJ2EEサーバにデータソースをインポートする前に，開発環境のJ2EEサーバにあるデータソースを削除してください。

開発環境のホストと運用環境のホストが異なる場合には，開発環境のホストにあるデータソースを運用環境のホストに移動してください。
開発環境のホストにあるデータソースからcjgetrespropコマンドでデータソース属性ファイルを取得し，データソース設定ファイルを用意します。データソース設定ファイルの格納場所を次に示します。
Windowsの場合
　　<Cosminexusのインストールディレクトリ>¥CC¥examples¥dsconf
UNIXの場合
　　/opt/Cosminexus/CC/examples/dsconf
取得および用意したデータソース属性ファイルとデータソース設定ファイルを，運用環境のホスト（Management Server稼働ホスト）にコピーします。

運用管理ポータルの「論理サーバのアプリケーション管理」で，運用環境のJ2EEサーバにデータソースをインポートします。
［データソースのインポート］画面で，データソースをインポートします。なお，インポート時に指定するファイルは，JDBCドライバファイル，データソース属性ファイル，およびデータソース設定ファイルです。JDBCドライバファイルはJDBCドライバのクラスライブラリファイル，属性ファイルと設定ファイルはリソースのプロパティや使用するドライバのクラスなどの情報を定義したファイルです。

運用管理ポータルでの操作については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，コマンドや属性ファイルについては，マニュアル「Cosminexus　リファレンス　コマンド編」，またはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　ファイル編集とコマンド実行でシステムを構築する場合

ファイル編集とコマンド実行でシステムを構築する場合，サーバ管理コマンドを使用してデータソースのプロパティの設定，接続の確認などを実施してください。

データソースの設定手順を次の図に示します。

図G-2　データソースの設定手順（ファイル編集とコマンド実行でのシステム構築）

図中の1.～3.について説明します。

サーバ管理コマンドを使用してデータソースをインポートします。
cjimportresコマンドを使用して，データソースをインポートします。

サーバ管理コマンドを使用してデータソースのプロパティを定義します。
cjgetrespropコマンドでデータソース属性ファイルを取得し，ファイル編集後に，cjsetrespropコマンドで編集内容を反映させます。
なお，使用するデータベースの種類によって，プロパティの定義内容が異なります。

サーバ管理コマンドを使用してデータソースの接続テストを実施します。
cjtestresコマンドを使用して，データソースの接続テストを実施します。

サーバ管理コマンドでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

参考

次のような場合，データソースをインポートすることで，効率良くデータソースを設定できます。

開発環境で設定したデータソースを，運用環境にインポートして使用する場合

運用環境ですでに動いているデータソースを，増設したJ2EEサーバにインポートして使用する場合

付録H　サーブレットエンジンモードの利用（互換用機能）

互換用のサーバの動作モードとして，Webコンテナだけを使用するサーブレットエンジンモードがあります。ここでは，サーブレットエンジンモードの利用について説明します。

なお，旧バージョンでサーブレットエンジンモードを使用していた場合には，J2EEサーバモードに移行することをお勧めします。

＜この節の構成＞

付録H.1　サーブレットエンジンモードでのシステム構築

付録H.2　Webコンテナサーバのセットアップ

付録H.3　Webコンテナサーバの動作設定のカスタマイズ

付録H.4　トラブルシューティングの資料取得の設定

付録H.5　統合ユーザ管理機能の設定

付録H.6　Webアプリケーションの設定

付録H.7　Webコンテナサーバの作業ディレクトリ

付録H.8　サーブレットエンジンモードの移行情報

付録H.1　サーブレットエンジンモードでのシステム構築

サーブレットエンジンモードを使用する場合のインストール，システム構築の流れ，システム構築で使用するファイルについて説明します。なお，旧バージョンでサーブレットエンジンモードを使用していた場合の移行情報については，「付録H.8　サーブレットエンジンモードの移行情報」を参照してください。

＜この項の構成＞

(1)　インストールと初期設定

(2)　システム構築の流れ

(3)　システム構築で使用するファイル

(1)　インストールと初期設定

サーブレットエンジンモードの場合，インストールと初期設定は，J2EEサーバの場合と同じです。J2EEサーバの場合のインストールと初期設定の概要については，「2.1　インストールと初期設定の概要」，「2.2　インストールとアンインストール」，および「2.3　環境変数の設定」を参照してください。なお，サーブレットエンジンモードの場合には，次のように読み替えてください。

J2EEサーバ→Webコンテナサーバ

cjsetupコマンド→cjwebsetupコマンド

cjstartsvコマンド→cjstartwebコマンド

cjstopsvコマンド→cjstopwebコマンド

cjdumpsvコマンド→cjdumpwebコマンド

また，インストール後のディレクトリ構成については，「2.6.1　Application Serverのディレクトリ構成」を参照してください。

ここでは，J2EEサーバモードの場合と異なる内容について説明します。

Webコンテナサーバの場合の，インストール方法ごとのユーザ環境の扱いを次の表に示します。

表H-1　インストール方法ごとのユーザ環境の扱い（Webコンテナサーバの場合）

インストール方法 | Webコンテナサーバのユーザ定義 | Webアプリケーション配置ディレクトリ | リダイレクタのユーザ定義
新規インストール | インストーラが，デフォルトのWebコンテナサーバをセットアップし，ユーザ定義を作成します。 | インストーラが，デフォルトのWebコンテナサーバをセットアップし，Webアプリケーション配置ディレクトリを作成します。 | インストーラが，デフォルトの定義を作成します。
上書きインストール | 引き継ぎます。 | 引き継ぎます。 | 引き継ぎます。
アップグレードイントール | 引き継ぎます。 | 引き継ぎます。 | 引き継ぎます。

(a)　インストールとアンインストール

Cosminexus Component Containerを上書きインストールをすると，前の設定が自動的に引き継がれます。なお，デフォルトのWebコンテナサーバ（ホスト名称のサーバ）のディレクトリ（<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<ホスト名称>，または/opt/Cosminexus/CC/web/containers/<ホスト名称>）がない場合には，サーバが自動的にセットアップされます。

(b)　環境変数の設定

サーブレットエンジンモードの場合，環境変数の設定は，J2EEサーバモードで，CTMおよびトランザクションサービスの両方を使用しないときの設定と同じです。詳細については，「2.3.1　環境変数の設定の要否」を参照してください。

(c)　見積もりと設定

Webコンテナサーバで使用するリソースの見積もり方法を次に示します。

スレッド数
最大スレッド数 = （8＋A＋B＋C＋D＋E＋F）/ 0.8
（凡例）

A：Webサーバの同時接続クライアント数（ただし，Webサーバの同時接続クライアント数がWebコンテナの最大同時実行スレッド数（usrconf.propertiesのwebserver.connector.ajp13.max_threadsキーに指定した値）以下の場合は，Webコンテナの最大同時実行スレッド数を指定する）

B：簡易Webサーバを有効にしている場合は1，無効にしている場合は0

C：簡易Webサーバへの同時接続クライアント数（ただし，簡易Webサーバへの同時接続クライアント数が5以下の場合は5，100以上の場合は100を指定する）

D：デプロイ済みのWebアプリケーションの数

E：Webアプリケーションのリロード機能を使用するWebアプリケーション数（ただし，usrconf.propertiesのwebserver.context.reloadableキーにtrueを指定している場合は，Webアプリケーションのリロード機能を使用するWebアプリケーション数を指定する）

F：JSPファイルの再コンパイル機能を使用するWebアプリケーション数（ただし，usrconf.propertiesのwebserver.jsp.recompilableキーにtrueを指定している場合は，JSPファイルの再コンパイル機能を使用するWebアプリケーション数を指定する）

ファイルディスクリプタ数
最大ファイルディスクリプタ数 = （19＋A＋B＋C＋D×2）/ 0.8
（凡例）

A：Webサーバの同時接続クライアント数（ただし，Webサーバの同時接続クライアント数がWebコンテナの最大同時実行スレッド数（usrconf.propertiesのwebserver.connector.ajp13.max_threadsキーに指定した値）より大きい場合は，Webサーバの同時接続クライアント数+1を指定する）

B：Webコンテナの最大同時実行スレッド数

C：簡易Webサーバを有効にしている場合は1，無効にしている場合は0

D：簡易Webサーバへの同時接続クライアント数

(d)　作業ディレクトリ

Webコンテナサーバの作業ディレクトリについては，「付録H.7　Webコンテナサーバの作業ディレクトリ」を参照してください。

(2)　システム構築の流れ

サーブレットエンジンモードでのシステム構築の流れを次の図に示します。

図H-1　システム構築の流れ（サーブレットエンジンモードの場合）

図中の1.～8.について説明します。

サーバをセットアップします。
デフォルトの設定のままで利用する場合は，セットアップ不要です。インストール時にセットアップ済みのWebコンテナサーバとは別のサーバ名称を使用したい場合，Webコンテナサーバをセットアップしてください。

Webサーバの設定をします。
使用するWebサーバとして，Hitachi Web Server，またはMicrosoft IIS（Windowsの場合）の設定をします。

サーバをカスタマイズします。
デフォルトの設定のままで利用する場合は，カスタマイズ不要です。Webコンテナサーバが使用するネーミングサービス，JavaVMの起動オプションなどを変更したい場合や，コンテナ拡張ライブラリ，コネクションプーリングなど特定の機能を使用したい場合には，Cosminexusが提供するユーザ定義ファイルやコマンドを使用して，Webコンテナサーバの動作を設定，カスタマイズします。

トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。ただし，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。
これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。

Webサーバとの連携の設定をします。
Webサーバと連携しない場合は，設定不要です。リダイレクタを利用したリクエストの振り分け，通信タイムアウト，エラーページのカスタマイズなど，Webサーバと連携するための設定をします。

統合ユーザ管理機能の設定をします。
統合ユーザ管理機能を使用しない場合は，設定不要です。Cosminexusシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定します。

Webアプリケーションの設定をします。
WARファイルをWebコンテナサーバにデプロイします。

システムを起動して，システムの動作を確認します。

参考

運用支援機能を持つプログラムを利用することで，システムで運用操作の一括実行や自動実行などの運用方法を実現することもできます。この場合には，図H-1の環境構築に加えて，運用支援機能を持つプログラムの設定が必要になります。運用支援機能を持つほかのプログラムを使用する場合には，使用しているプログラムのマニュアルなどを参照して，環境を構築してください。

(3)　システム構築で使用するファイル

ここでは，システムの構築で使用するファイルのうち，主なファイルについて説明します。ここで説明していないファイルについては，システム構築の手順の中で適宜説明します。

注意

ファイルを変更する場合は，Webコンテナサーバを停止してください。Webコンテナサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

usrconf.properties（ユーザプロパティファイル）
Webコンテナサーバのユーザプロパティを定義するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

usrconf.cfg（オプション定義ファイル）
WebコンテナサーバのJavaVMの起動オプションを定義するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.cfg

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.cfg

web.policy（セキュリティポリシーファイル）
Webコンテナサーバのセキュリティポリシーを定義するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web.policy

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web.policy

hitachi_web.properties（Webアプリケーションプロパティファイル）
WebアプリケーションごとのプロパティをWebコンテナサーバのプロパティに指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<WebアプリケーションのWEB-INFディレクトリ>¥hitachi_web.properties

UNIXの場合
<WebアプリケーションのWEB-INFディレクトリ>/hitachi_web.properties

hitachi_web.propertiesを変更した場合，WARファイルを作成，インポートし直してください。

web-users.xml（ユーザ認証情報定義ファイル）
ユーザ名，パスワード，所属するロールなどのユーザ認証情報を定義するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web-users.xml

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web-users.xml

付録H.2　Webコンテナサーバのセットアップ

Webコンテナサーバは，製品のインストール時にセットアップ済みです。デフォルトの設定では，Webコンテナサーバ名はホスト名です。デフォルトの設定を変更したい場合には，Webコンテナサーバをセットアップしてください。また，同じホスト内で複数のWebコンテナサーバを起動する場合には，それぞれのWebコンテナサーバに別のサーバ名を割り当てる必要があるため，Webコンテナサーバをセットアップしてください。

Webコンテナサーバはサーバ名称によって識別されます。各コマンドの引数にサーバ名称を指定することで，複数のWebコンテナを開始したり，管理したりできます。また，Webコンテナサーバのサーバ名称は，J2EEサーバの名称とは独立して管理されます。

Webコンテナサーバでは，次に示すファイル，ディレクトリがサーバ名称ごとに独立に管理されます。

ユーザ定義ファイル

Webアプリケーション配置ディレクトリ

ログファイル格納ディレクトリ

一時ファイル格納ディレクトリ

インストール時には，インストールされたマシンのホスト名がデフォルトのサーバ名称として設定されます。新たにサーバ名称を設定するには，cjwebsetupコマンドを実行します。なお，UNIXの場合，コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

Windowsの場合

"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjwebsetup サーバ名称"

UNIXの場合

#　/opt/Cosminexus/CC/web/bin/cjwebsetup サーバ名称

なお，同一マシン内では，同じサーバ名称でcjwebsetupコマンドを複数回実行してはいけません。実行した場合エラーになります。Webコンテナサーバを再セットアップする場合，cjwebsetup -d <サーバ名称>でサーバの環境をいったん削除してから再度セットアップコマンドを実行してください。cjwebsetupコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

同一マシンで複数のWebコンテナを同時に起動する場合，使用するポート番号が重ならないように，usrconf.propertiesのユーザ定義を正しく設定する必要があります。また，webserver.connector.ajp13.portキーで設定されているポート番号に対し，同時に起動するWebコンテナ間で異なる値を使用するように設定してください。webserver.connector.http.portキーについても，同様に異なるポート番号を設定するか，またはwebserver.connector.http.enabledキーにfalseを設定することで，ポート番号を使用しないようにする必要があります。さらに，webserver.shutdown.portキーについても，ポート番号が重ならないように注意する必要があります。

付録H.3　Webコンテナサーバの動作設定のカスタマイズ

ここでは，Webコンテナサーバの動作設定のカスタマイズについて説明します。

デフォルトで設定されているWebコンテナサーバの動作設定を変更したい場合には，ユーザ定義ファイルを編集して，Webコンテナサーバの動作をカスタマイズする必要があります。例えば，Webコンテナサーバが使用するコンテナ，ログなどの設定を変更したい場合には，usrconf.propertiesを編集してください。また，WebコンテナサーバのJavaVMの起動オプションなどを変更したい場合には，usrconf.cfgを編集してください。

＜この項の構成＞

(1)　Webコンテナサーバの動作設定のカスタマイズの方法

(2)　コンテナ拡張ライブラリの設定

(3)　JSPファイルのコンパイル結果の保持の設定

(4)　アプリケーションの更新検知とリロードの設定

(5)　コネクションプーリングの設定

(1)　Webコンテナサーバの動作設定のカスタマイズの方法

Webコンテナサーバの動作設定のカスタマイズでは，ユーザ定義ファイルを編集して，サーバ名で識別されるWebコンテナサーバ単位に，Webコンテナサーバの動作をカスタマイズします。

(a)　カスタマイズの前提

カスタマイズ対象のWebコンテナサーバのセットアップが完了していることが前提になります。また，UNIXの場合，カスタマイズにはroot権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

(b)　カスタマイズ対象のユーザ定義ファイル

次の五つのユーザ定義ファイルをテキストエディタなどで編集して，Webコンテナサーバの動作をカスタマイズします。これらのユーザ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

usrconf.properties（ユーザプロパティファイル）

usrconf.cfg（オプション定義ファイル）

web.policy（セキュリティポリシーファイル）

hitachi_web.properties（Webアプリケーションプロパティファイル）

web-users.xml（ユーザ認証情報定義ファイル）

(c)　Webコンテナサーバのカスタマイズで設定できる主な項目

Webコンテナサーバのカスタマイズでユーザ定義ファイルを編集して設定できる項目のうち，主な項目とその項目を設定するユーザ定義ファイルおよびキーを次の表に示します。キーの詳細，およびここで説明していないキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表H-2　ユーザ定義ファイルのカスタマイズで設定できる主な項目（サーブレットエンジンモードの場合）

分類
項目
設定ファイル
設定内容

ネーミングサービス
ネーミングのキャッシング
usrconf.properties
次のキーを指定します。

ejbserver.jndi.cacheキーに，ネーミングでのキャッシングを有効にするかどうかを指定します。

ejbserver.jndi.cache.intervalキーに，キャッシュクリアの間隔を設定します。

ejbserver.jndi.cache.interval.clear.optionキーに，キャッシュクリアの範囲を指定します。

ネーミングサービスの通信タイムアウト
usrconf.properties
ejbserver.jndi.request.timeoutキーに，ネーミングサービスとの通信タイムアウト時間を指定します。

コンテナ
コンテナ拡張ライブラリ
usrconf.cfg
usrconf.cfgで，コンテナ拡張ライブラリ用のJARファイルのパスをWebコンテナサーバのシステムクラスパスに追加します。詳細については，「(2)　コンテナ拡張ライブラリの設定」を参照してください。

RMI-IIOP通信のタイムアウト
usrconf.properties
ejbserver.rmi.request.timeoutキーに，RMI-IIOP通信のクライアントとサーバ間の通信タイムアウト時間を指定します。

Webコンテナ単位での同時実行スレッド数の制御
usrconf.properties
webserver.connector.ajp13.max_threadsキーに，Webコンテナ単位での同時実行スレッド数を指定します。

Webコンテナの通信タイムアウト
usrconf.properties
webserver.connector.ajp13.receive_timeoutキーに，Webサーバからのリクエスト待ち時間（秒）を設定します。詳細については，「18.3.1　リクエスト送受信時の通信タイムアウトの設定」を参照してください。

JSPファイルのコンパイル結果の保持
usrconf.properties
次のキーを指定します。

webserver.work.cleanキーに，コンパイル結果を保持するかどうかを指定します。

webserver.work.directoryキーに，コンパイル結果の出力先を指定します。

設定方法については，「(3)　JSPファイルのコンパイル結果の保持の設定」を参照してください。

静的コンテンツのキャッシュ
－
サーブレットエンジンモードの場合は，WebアプリケーションのDD（web.xml）を直接編集して静的コンテンツのキャッシュの設定をします。DD（web.xml）を直接編集して，Webコンテナ単位で静的コンテンツのキャッシュ機能を使用するかどうか，キャッシュを許可する静的コンテンツのメモリサイズ，およびファイルサイズの上限値を指定します。静的コンテンツのキャッシュ機能を使用する場合のDDの定義については，マニュアル「Cosminexus　アプリケーション開発ガイド」のweb.xml編集時の注意事項に関する説明を参照してください。

アプリケーションの更新検知とリロード
usrconf.properties
hitachi_web.properties
Webアプリケーションが更新された場合に検知する機能，およびJSPファイルが更新された場合にリロードする設定を，usrconf.propertiesまたはhitachi_web.propertiesに指定します。設定方法については，「(4)　アプリケーションの更新検知とリロードの設定」を参照してください。

リモートインタフェースでの通信障害発生時のEJBクライアントの動作
usrconf.properties
WebコンテナサーバがEJBクライアントの場合に，ejbserver.container.rebindpolicyキーに障害発生時の動作を指定します。

Webコンテナコネクションプーリング機能
プール管理情報設定ファイル
Webアプリケーションからデータベースへ接続する場合，Webコンテナコネクションプーリング機能を利用してデータベースへの接続をプールできます。設定方法については，「(5)　コネクションプーリングの設定」を参照してください。

Webサーバ
通信路の暗号化レベルの要請
usrconf.properties
webserver.connector.redirect_https.portキーに，転送先のhttpsのポート番号を指定します。
また，通信路の暗号化レベルを要請するには，さらに，通信路の暗号化レベルの要請をDD（WEB-INF/web.xml）内に指定する必要があります。

簡易Webサーバ機能を使用するかどうかの設定
usrconf.properties
webserver.connector.http.enabledキーに，簡易Webサーバ機能を使用するかどうかを指定します。デフォルトでは使用しない設定になっています。

簡易Webサーバへのアクセス許可
usrconf.properties
webserver.connector.http.permitted.hostsキーに，簡易Webサーバへのアクセスを許可するホストのIPアドレスまたはホスト名を指定します。
デフォルトでは次のように設定されています。

ポート番号

8080

同一ホスト内で複数のWebコンテナを開始する場合，各Webコンテナで使用するポート番号が重複しないように，次に示すユーザ定義用カスタマイズキーで設定してください。

ドキュメントルート

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public

UNIXの場合
/opt/Cosminexus/CC/server/public

ログ
ログの出力先や出力レベルの変更
usrconf.cfg，
usrconf.properties
usrconf.cfgのweb.server.log.directoryキーに，ログの出力先を指定します。また，usrconf.propertiesのejbserver.loggerから始まるキーに，ログサイズとログレベルを指定します。詳細については，「付録H.4(2)　Webコンテナサーバのログ取得の設定」を参照してください。

Webアプリケーションのユーザログ出力
usrconf.properties，
web.policy
ejbserver.applicationから始まるキーに，ログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定します。また，web.policyファイルにセキュリティポリシーを指定します。詳細については，「付録H.4(10)　Webアプリケーションのユーザログ出力の設定」を参照してください。

ユーザスレッドの生成
ユーザスレッド生成のための権限
web.policy
cjstartwebコマンドに-security オプションを指定し，Webコンテナサーバの実行時保護機能を有効にした場合，ユーザがプログラムの中で明示して生成するスレッド（ユーザスレッド）を生成するためには，対象となるサーブレットやJSPにスレッドの生成権限を与える必要があります。
詳細については，「4.6　ユーザスレッド生成のための権限の設定」を参照してください。ただし，サーブレットエンジンモードの場合は，server.policyファイルではなくweb.policyファイルに設定してください。

(2)　コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリは，Enterprise Bean，サーブレット，JSPが利用する共通のライブラリです。コンテナ拡張ライブラリを利用することで，Enterprise Bean，サーブレット，JSPから共通のライブラリを呼び出せるようになります。

ここでは，コンテナ拡張ライブラリを使用するための設定について説明します。機能の詳細については，マニュアル「Cosminexus　機能解説」のコンテナ拡張ライブラリの利用に関する説明を参照してください。なお，コンテナ拡張ライブラリがJNIを利用する場合は，サーバ起動・停止フック機能を使用します。サーバ起動・停止フック機能の実装については，マニュアル「Cosminexus　機能解説」を参照してください。

コンテナ拡張ライブラリを使用するためには，次の設定が必要です。

コンテナ拡張ライブラリ用のJARファイルを作成します。
コンテナ拡張ライブラリについては，マニュアル「Cosminexus　機能解説」を参照してください。

Webコンテナサーバ用のusrconf.cfgのweb.add.class.pathキーで，手順1.で作成したJARファイルのパスをWebコンテナサーバのシステムクラスパスに指定します。

コンテナ拡張ライブラリからJNI機能を使用する場合は，Webコンテナサーバ用のusrconf.cfgのadd.library.pathキーで，JNI用ライブラリの検索パスを指定します。

コンテナ拡張ライブラリからJNI機能を使用する場合は，Webコンテナサーバ用のusrconf.propertiesのejbserver.application.InitTermProcessClassesキーに，サーバ起動・停止フック機能のクラス名を指定します。

ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ユーザ定義ファイルの設定例を示します。この例では，コンテナ拡張ライブラリのJARファイルは「extended_container.jar」で，そのコンテナ拡張ライブラリがJNIを使用して「extended_container.dll」（UNIXの場合，extended_container）を呼び出します。

Webコンテナサーバ用のusrconf.cfgの設定例を次に示します。

Windowsの場合

# system classpath
web.add.class.path=c:¥jar¥extended_container.jar

# ADM service
web.adm.service=false

# library path
add.library.path=c:¥lib

UNIXの場合

# system classpath
web.add.class.path=/work/classes/extended_container.jar

# library path
add.library.path=/work/lib

(3)　JSPファイルのコンパイル結果の保持の設定

ここでは，JSPコンパイル結果の保持に関する設定について説明します。

(a)　JSPコンパイル結果保持の設定方法

JSPのコンパイル結果は，デフォルトでは保持する設定となっています。この設定は，usrconf.propertiesのwebserver.work.cleanキーでの指定で，変更できます。

デフォルトでは，次のように設定されています。

webserver.work.clean=false

webserver.work.cleanキーにfalseが設定されていると，コンパイル結果を保持します。サーバ終了時にJSPコンパイル結果を削除する場合は，webserver.work.cleanキーにtrueを設定します。

usrconf.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(b)　JSPコンパイル結果の出力先の設定

JSPコンパイル結果は，JSP用テンポラリディレクトリ下に出力されます。JSP用テンポラリディレクトリは，usrconf.propertiesのwebserver.work.directoryキーに設定します。デフォルトの出力先を次に示します。

デフォルトの出力先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥work

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/work

JSP用テンポラリディレクトリ下にはWebアプリケーション単位でディレクトリが作成され，該当するWebアプリケーション内のJSPコンパイル結果が出力されます。

Webアプリケーション単位の出力先

JSP用テンポラリディレクトリ下に作成されるWebアプリケーション単位のディレクトリは，コンテキストルート名を基に次の規則に従ったディレクトリ名となります。

コンテキストルート名にドル記号（$），パーセント（%），プラス記号（+）が含まれる場合は，次に示す文字に変換します。なお，サーブレットエンジンモードの場合は，コンテキストルート名にスラッシュ（/）は使用できません。

変換前の文字 | 変換後の文字
$ | $24
% | $25
+ | $2b

例：

サーブレットエンジンモードで，JSP用テンポラリディレクトリがデフォルト，コンテキストルート名が「J2EE_AP1%WEB_AP1_war」である場合，該当するWebアプリケーションのJSPコンパイル結果の出力先を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥work¥J2EE_AP1$25WEB_AP1_war

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/work/J2EE_AP1$25WEB_AP1_war

注意

JSP用テンポラリディレクトリの設定を変更する場合

JSPコンパイル結果を保持する設定でWebコンテナを稼働したあと，JSP用テンポラリディレクトリの設定を変更した場合，変更前のJSP用テンポラリディレクトリは削除されません。このため，手動で削除する必要があります。

(4)　アプリケーションの更新検知とリロードの設定

サーブレットエンジンモードでは，Webアプリケーション開発時のテストを支援する機能として，Webコンテナ上のアプリケーションの更新を検知し，更新したアプリケーションをリロードする機能を備えています。

ここでは，アプリケーションの更新を検知し，リロードする機能を使用する場合の設定について説明します。また，JSPファイルが更新された場合に，更新後のJSPを再コンパイルする機能の設定についても説明します。

(a)　リロードの動作に関する設定

Webアプリケーションのリロード機能を使用するためには，次に示す設定が必要となります。設定内容と設定ファイルについて説明します。

●リロード機能を使用するための設定

Webアプリケーションのリロード機能を使用する場合は，usrconf.propertiesまたはhitachi_web.propertiesに次の指定をします。

webserver.context.reloadable=true

●更新検知のインターバル

Webアプリケーションの更新を検知する間隔を指定できます。更新検知は，デーモンスレッドによって実行されます。デフォルトでは1秒間隔となっています。

デーモンスレッドの実行間隔を変更する場合，usrconf.propertiesのwebserver.context.check_intervalキーに値（単位：秒）を指定します。

ポイント

更新検知の対象となるファイル数が増えると，更新検知処理のオーバーヘッドが大きくなり，CPU使用率が高くなります。このような場合は，更新検知インターバルを変更することによって，性能への影響が小さくなります。更新検知インターバルの値は大きくすることをお勧めします。

●リソース更新用インターバル

リソース更新用インターバルとは，Webアプリケーションの更新を検知してから，処理中のリクエスト数の監視を実施するまでの時間を指します。

リソース更新用インターバルは，usrconf.propertiesまたはhitachi_web.propertiesのwebserver.context.update.intervalキーに値（単位：秒）を指定します。

●リロード遅延実行（任意）

リロード遅延実行機能を使用する場合は，ファイル（リソース）の更新を検知してから，リロードを開始するまでの時間を設定します。

リロード遅延実行は，usrconf.propertiesまたはhitachi_web.propertiesのwebserver.context.reload_delay_timeoutキーに値（単位：秒）を指定します。

●リロード時のセッション引き継ぎ（任意）

Webアプリケーションのリロード実行前に生成したセッション情報を，リロード後も継続して利用するかどうかを設定します。

セッション情報を引き継ぐかどうかの指定は，usrconf.propertiesまたはhitachi_web.propertiesのwebserver.context.reload_enabledキーに指定します。セッション情報を引き継ぐ場合は「true」，引き継がない場合は「false」を指定します。デフォルトは「false」で，セッション情報は引き継ぎません。

なお，セッション情報を引き継ぐ場合，セッション情報は，シリアライズされて，セッション情報ファイルに出力されます。次に，セッション情報ファイルの出力先と，出力先ディレクトリの変更方法について説明します。

セッション情報ファイルの出力先

セッション情報ファイルはデフォルトでは次のディレクトリに作成されます。

ディレクトリ

Windowsの場合
<Cosminexusインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥work¥<コンテキストルート名>¥cjwebsession.dat

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/work/<コンテキストルート名>/cjwebsession.dat

なお，出力先ディレクトリはWebコンテナサーバ起動時に作成されます。作成されたディレクトリは，Webコンテナサーバを終了しても削除されません。ディレクトリが不要になった場合は，手動で削除してください。

セッション情報ファイルの出力先ディレクトリの変更

セッション情報ファイルの出力先は変更できます。変更するには，usrconf.propertiesのwebserver.session.work.directoryキーに，変更後の出力先ディレクトリを指定します。

出力先のディレクトリを変更するときの設定例を次に示します。

出力先ディレクトリ変更の設定例

Windowsの場合（C:¥tmp¥session_workに変更する場合）
webserver.session.work.directory=C:/tmp/session_work

UNIXの場合（/usr/tmp/session_workに変更する場合）
webserver.session.work.directory=/usr/tmp/session_work

なお，この例の場合，コンテキストルートが“examples”のWebアプリケーションのセッション情報ファイルは，次に示すパスに生成されます。

Windowsの場合
C:¥tmp¥session_work¥examples¥cjwebsession.dat

UNIXの場合
/usr/tmp/session_work/examples/cjwebsession.dat

●設定ファイル

リロードに関する設定は，usrconf.propertiesまたはhitachi_web.propertiesのどちらかで設定します。なお，両方のファイルに設定している場合は，hitachi_web.propertiesの指定が優先されます。設定項目と，設定できるファイルを次の表に示します。

表H-3　リロードに関する設定項目と設定ファイル

設定項目 | ファイル名
usrconf.properties | hitachi_web.properties
リロード機能を使用するための設定 | ○ | ○
更新検知のインターバル | ○ | ×
リソース更新用インターバル | ○ | ○
リロード遅延実行 | ○ | ○
セッション情報の引き継ぎ | ○ | ○
セッション情報ファイルの出力先 | ○ | ×

（凡例）　○：設定できる。　×：設定できない。

(b)　JSPファイルの再コンパイルに関する設定

JSPファイルの再コンパイル機能を使用するためには，次に示す設定が必要となります。設定内容と設定ファイルについて説明します。

●再コンパイル機能を使用するための設定

JSPファイルの再コンパイル機能を使用する場合は，usrconf.propertiesまたはhitachi_web.propertiesに次の内容を指定します。

webserver.jsp.recompilable=true

なお，usrconf.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

●更新検知のインターバル

JSPファイルの更新を検知する間隔を変更する場合は，usrconf.propertiesのwebserver.jsp.check_intervalキーに値（秒単位）を指定します。デフォルトでは1秒間隔となっています。

●JSPファイル更新用インターバル

JSPファイル更新用インターバルとは，JSPファイルの更新を検知してから，JSPファイルをコンパイルするまでの間隔を指します。

JSPファイル更新用インターバルは，usrconf.propertiesまたはhitachi_web.propertiesのwebserver.jsp.update.intervalキーに値（単位：秒）を指定します。

●設定ファイル

JSPファイルの再コンパイルに関する設定は，usrconf.propertiesまたはhitachi_web.propertiesのどちらかで設定します。なお，両方のファイルに設定している場合は，hitachi_web.propertiesの指定が優先されます。設定項目と，設定できるファイルを次の表に示します。

表H-4　JSPファイルの再コンパイルに関する設定項目と設定ファイル

設定項目 | ファイル名
usrconf.properties | hitachi_web.properties
JSPファイル再コンパイル機能を使用するための設定 | ○ | ○
更新検知のインターバル | ○ | ×
JSPファイル更新用インターバル | ○ | ○

（凡例）　○：設定できる。　×：設定できない。

(5)　コネクションプーリングの設定

サーブレットエンジンモード上で動作するWebアプリケーションからデータベースへ接続する場合，Webコンテナコネクションプーリング機能を利用してデータベースへの接続をプールできます。これによって，コネクション生成時のパフォーマンスを向上できます。Webコンテナコネクションプーリング機能を利用するには，管理機能用のWebアプリケーションをデプロイし，プール管理情報を登録してください。

Webコンテナコネクションプーリング機能を利用するための手順を次に示します。

プール管理情報設定ファイルを作成します。
プール管理情報設定ファイルは，プール管理情報を登録するときに使用するファイルです。プール管理情報設定ファイルには次の情報を記述します。

一意のデータベースID
プール管理情報の登録で登録した一意のデータベースIDを指定します。

Cosminexus DABroker LibraryのクラスおよびデータベースURL（Cosminexus DABroker Libraryを利用する場合）
クラス名には，「Class.forName」に渡すクラス名として「com.hitachi.software.web.jdbc.WccpDriver」を指定します。また，URLには，データベースURLとして，「jdbc:hitachi:wccp://DBID=<データベースURL>」を指定します。

コネクションの最小値と最大値など

プール管理情報設定ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

管理機能用のWebアプリケーションをデプロイします。
管理機能用のWebアプリケーションの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥jdbc¥cjwebconpool.war

UNIXの場合
/opt/Cosminexus/CC/web/jdbc/cjwebconpool.war

Webアプリケーションのデプロイについては，「付録H.6(1)　Webアプリケーションのデプロイ」を参照してください。

Webコンテナサーバを起動します。
Webコンテナサーバの起動については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

cjwebeditpoolコマンドの引数にプール管理情報設定ファイルを指定して，プール管理情報を登録します。
cjwebeditpoolコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

ユーザ作成のWebアプリケーションをデプロイします。
Webアプリケーションのデプロイについては，「付録H.6(1)　Webアプリケーションのデプロイ」を参照してください。
なお，コネクションの取得処理は，Webアプリケーションで実施します。このため，ユーザ作成のWebアプリケーションに，コネクションを操作するための記述が必要になります。Webアプリケーションの記述方法については，マニュアル「Cosminexus　機能解説」のWebコンテナコネクションプール機能によるデータベース接続に関する説明を参照してください。

付録H.4　トラブルシューティングの資料取得の設定

ここでは，トラブルシューティングの資料を取得するための設定方法について説明します。

＜この項の構成＞

(1)　資料取得の設定の概要

(2)　Webコンテナサーバのログ取得の設定

(3)　リダイレクタのログ取得の設定

(4)　Cosminexus TPBrokerのログ取得の設定

(5)　Cosminexus DABroker Libraryのログ取得の設定

(6)　OSの統計情報取得の設定

(7)　ユーザダンプ取得の設定

(8)　coreダンプ取得の設定

(9)　JavaVMの資料取得の設定

(10)　Webアプリケーションのユーザログ出力の設定

(1)　資料取得の設定の概要

トラブルシューティングに必要な資料のうち，一部の資料は，運用を開始する前に資料取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合），JavaVMのガーベージコレクションのログなどは，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

デフォルトの設定で取得できるようになっている資料については，特に設定は不要ですが，ログの出力先やサイズなどを変更したい場合には，ユーザ定義ファイルを編集して，設定を変更してください。

トラブルシューティングの資料取得のための設定を次の表に示します。

表H-5　トラブルシューティングの資料取得のための設定（サーブレットエンジンモードの場合）

資料の種類
資料取得のための設定
設定の要否
設定方法の参照先

性能解析トレースファイル
事前に，取得のための設定をしておく必要はありません。日常的なシステム運用の作業で，cprfedコマンドを実行するときに取得条件などを指定します。性能解析トレースファイルの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。
×
－

Webコンテナサーバのログ
Webコンテナサーバ用のusrconf.cfgとusrconf.propertiesで，ログの出力レベル，サイズ，面数などを設定します。
△
(2)

リダイレクタのログ
mod_jk.conf（Hitachi Web Serverの場合）またはisapi_redirect.conf（Microsoft IISの場合）で，ログの出力レベル，サイズ，面数などを設定します。
△
(3)

Cosminexus TPBrokerのトレースファイル
Webコンテナサーバ用のusrconf.cfgとusrconf.propertiesで，トレースファイルの出力先や面数などを設定します。
△
(4)

Cosminexus DABroker Libraryのログ
環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルで，ログファイルサイズなどを設定します。
△
(5)

OSの統計情報
Windowsの場合，Windowsのシステムモニタでシステムリソースのパフォーマンスデータ取得の設定をします。
○
(6)

ユーザダンプ
Windowsの場合，ワトソン博士で，ユーザダンプ取得の設定をします。
○
(7)

coreダンプ
UNIXの場合，usrconf.cfgやシェルコマンドで，coreファイル取得の設定をします。
○
(8)

JavaVMの資料
Webコンテナサーバ用のusrconf.cfgで，JavaVMのスレッドダンプや日立固有のJavaVMログ（日立JavaVMログファイル）の出力方法や出力内容などの設定をします。
○
(9)

Webアプリケーションのユーザログ
Webコンテナサーバ用のusrconf.propertiesで，ロガーやハンドラの設定，ログの出力レベル，サイズ，面数などを設定します。また，web.policyで，セキュリティポリシーを設定します。
設定方法は，J2EEアプリケーションの場合と同じです。Webアプリケーションのユーザログ出力については，「5.20　アプリケーションのユーザログ出力の設定」を参照してください。ただし，サーブレットエンジンモードの場合は，簡易構築定義ファイルではなく，Webコンテナサーバ用のusrconf.propertiesで設定します。設定時には，簡易構築定義ファイルで設定するパラメタを，Webコンテナサーバ用のusrconf.propertiesのキーに読み替えてください。Webコンテナサーバ用のusrconf.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。
○
(10)

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの設定をカスタマイズする場合だけ，設定が必要。

×：設定は不要。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥<サーバ名称>

UNIXの場合
/opt/Cosminexus/CC/web/<サーバ名称>

(2)　Webコンテナサーバのログ取得の設定

Webコンテナサーバのログの出力先，ログサイズ，ログレベルの変更について説明します。変更できる項目と，項目に対応するユーザ定義ファイルとキーを次の表に示します。

表H-6　Webコンテナサーバのログ取得の設定項目

項目
対応するユーザ定義ファイルとキー

ログの出力先
usrconf.cfgのweb.server.log.directoryキー

ログサイズ
usrconf.propertiesのejbserver.logger.channels.define.<チャネル名>.filenumキー
usrconf.propertiesのejbserver.logger.channels.define.<チャネル名>.filesizeキー

ログレベル
usrconf.propertiesのejbserver.logger.enabled.*キー

ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(a)　ログの出力先の変更

デフォルトのログ出力先を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs

ログの出力先を変更する場合は，usrconf.cfgのweb.server.log.directoryキーでログの出力先ディレクトリを指定します。

設定例

Windowsの場合
web.server.log.directory=C:¥CClogs¥web¥YourServer

UNIXの場合
web.server.log.directory=/CClogs/web/YourServer

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリを次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>

注意事項

ログの出力先を変更した場合は，Webコンテナサーバを起動する前に，変更後のログの出力先ディレクトリを作成しておいてください。変更後のログの出力先ディレクトリがない場合は，Webコンテナサーバのサーバ起動時にKDJE40024-Eのメッセージが出力されて異常終了します。

同じマシン内で複数のWebコンテナサーバを起動させている場合は，ログ出力先が同じディレクトリにならないように，ディレクトリにサーバ名称を含めるなど，サーバごとにユニークなディレクトリ名になるようにしてください。なお，キーの値に同じディレクトリを指定した場合は，動作の保証はしません。

ログの出力先を変更して作業ディレクトリ以外にログを出力する場合，ログファイルはサーバのアンセットアップ時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

ユーザ定義ファイルでログの出力先を設定していても，次の設定が優先されますので，注意してください。
usrconf.cfgに，add.jvm.arg=-XX:HitachiJavaLog:<JavaVMの保守情報およびガーベージコレクションのログ出力先>キーを指定している場合は，JavaVMの保守情報およびガーベージコレクションのログ出力先に設定したディレクトリに，JavaVMの保守情報およびガーベージコレクションのログファイルが出力されます。

ログ出力先には，UNC名を含むパスは指定できません。

(b)　ログサイズの変更

ログサイズを変更する場合は，usrconf.propertiesで，ログファイルの面数，およびログファイル1面当たりの最大サイズを設定します。

ログファイル面数の変更

ログファイルの面数は，usrconf.propertiesのejbserver.logger.channels.define.<チャネル名>.filenumキーで設定します。

記述例

ejbserver.logger.channels.define.MessageLogFile.filenum=3

ログファイル1面当たりの最大サイズの変更

ログファイル1面当たりの最大サイズは（単位：バイト），usrconf.propertiesのejbserver.logger.channels.define.<チャネル名>.filesizeキーで設定します。

記述例

ejbserver.logger.channels.define.MessageLogFile.filesize=2097152

(c)　ログレベルの変更

ログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。

ログレベルは，Webコンテナサーバ用のusrconf.propertiesのejbserver.logger.enabled.*キーで設定します。

ejbserver.logger.enabled.*=<レベル名>

レベル名には，「Error」，「Warning」，「Information」，「Debug」の文字列を一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

記述例

ejbserver.logger.enabled.*=Error

ejbserver.logger.enabled.*=Error,Warning

ejbserver.logger.enabled.*=Error,Warning,Information

ejbserver.logger.enabled.*=Error,Warning,Information,Debug

注意事項

記述例の1.，2.，3.，4.，の順に，取得できるログの件数が増加していきます。複数のログレベルを設定してログを取得すると，性能が劣化し，ログファイルの面の切り替えが頻繁に起こるようになります。

レベル名に「Error」，「Warning」，「Information」，「Debug」以外の文字列，または空の値を設定した場合は，KDJE90009-Wのメッセージが出力されます（Errorレベルのログは取得されます）。

ログレベルの推奨設定

ログレベルの推奨設定を次に示します。

通常運用時
「ejbserver.logger.enabled.*=Error」を指定します。

通常運用時（verbose）
通常運用時よりも詳細な情報を取得する場合には，「ejbserver.logger.enabled.*=Error,Warning」を指定します。

テスト時
「ejbserver.logger.enabled.*=Error,Warning,Information」を指定します。

障害調査時
「ejbserver.logger.enabled.*=Error,Warning,Information,Debug」を指定します。

(3)　リダイレクタのログ取得の設定

リダイレクタの出力するログの出力先やログ出力レベルなどの変更について説明します。なお，ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

リダイレクタが出力するログは，メッセージログと保守用トレースログの二つに分けて出力されます。メッセージログには，障害発生時のログなどのメッセージが出力されます。保守用トレースログには，HTTPリクエストを受信し，レスポンスを送信するまでのトレース情報が出力されます。

保守用トレースログのログサイズは，見積もりの計算式に従い，障害発生時から障害を検知しログを収集するまで保持されるサイズにカスタマイズすることをお勧めします。

注意事項

ログファイル初期化処理の開始時および終了時には，メッセージログにそれぞれKDJE41029-I，KDJE41030-Iのメッセージが出力されます。Webサーバの起動時には，ログファイル初期化処理が正常に終了したことを確認するため，メッセージログにKDJE41029-I，KDJE41030-Iのメッセージが出力されていることを確認してください。

UNIXの場合，mod_jk.confに設定されたファイルサイズ，およびファイル面数のログファイルは，Webサーバとの連携の設定後の初回起動時に作成されます。ログファイルの作成は，ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合，またはファイル面数を増やした場合などは，ログファイルの作成処理に数分掛かる場合があります。

(a)　Hitachi Web Serverの場合

Hitachi Web Serverを使用している場合は，mod_jk.confでリダイレクタのログ取得の設定を変更できます。なお，UNIXの場合，設定を変更できるのは，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）を持つユーザです。

●変更した設定を有効にする方法

変更した設定を有効にする方法について，OSごとに説明します。

Windowsの場合

変更したリダイレクタのログ取得の設定を有効にするには，Hitachi Web Serverを再起動してください。

UNIXの場合

変更したリダイレクタのログ取得の設定を有効にする方法は，ファイルサイズまたはファイル面数の変更の有無によって異なります。

ファイルサイズまたはファイル面数を変更する場合

ファイルサイズまたはファイル面数を変更する場合に，変更したリダイレクタのログ取得の設定を有効にする方法を次に示します。

Hitachi Web Serverを停止します。

ログファイルおよび管理ファイルを移動または削除します。
メッセージログファイルの場合：メッセージログファイルおよびHNTRLibが使用する管理ファイル（<JkLogFilePrefixの設定値>.mm）を移動，または削除します。
保守用トレースログファイルの場合：保守用トレースログファイルおよびHNTRLibが使用する管理ファイル（<JkTrcaeLogFilePrefixの設定値>.mm）を移動，または削除します。

Hitachi Web Serverを再起動します。

ファイルサイズまたはファイル面数を変更しない場合

ファイルサイズまたはファイル面数を変更しない場合は，Hitachi Web Serverを再起動してください。

●変更できる設定項目

変更できる設定項目と，項目に対応するユーザ定義ファイルとキーを次の表に示します。

表H-7　Hitachi Web Serverでのリダイレクタのログ取得の設定項目（サーブレットエンジンモードの場合）

項目 | mod_jk.confのキー
メッセージログ，保守用トレースログのログ出力レベル | JkLogLevel
メッセージログ出力先 | JkLogFileDir
メッセージログファイルサイズ | JkLogFileSize
メッセージログファイル面数 | JkLogFileNum
メッセージログファイル名のプリフィックス | JkLogFilePrefix
保守用トレースログ出力の有無 | JkTraceLog
保守用トレースログ出力先 | JkTraceLogFileDir※
保守用トレースログファイルサイズ | JkTraceLogFileSize
保守用トレースログファイル面数 | JkTraceLogFileNum
保守用トレースログファイル名のプリフィックス | JkTrcaeLogFilePrefix※

注※　保守用トレースログの出力先とプリフィックスには，同じ値を指定しないでください。同じ値を指定した場合は，リダイレクタが動作しません。

メッセージログ，および保守用トレースログのデフォルトの出力先

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs

UNIXの場合
/opt/Cosminexus/CC/web/redirector/logs

ログレベルのレベル名

ログレベルのレベル名には，重要度の高い順に「emerg」※，「error」，「info」，「debug」のどれかを指定できます。

emerg：通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。※

error：通常運用時に指定します。

info：テスト時に指定します。

debug：障害調査時に指定します。

ログレベルは，単独で指定してください（コンマ区切りで複数のログレベルを指定しないでください）。あるログレベルを指定すると，指定されたログレベルおよびそれよりも重要度の高いログが出力されます。

注※　Windowsの場合に指定できます。

ログサイズの見積もりの計算式

GETリクエスト，POSTリクエストの1HTTPアクセス当たりのログサイズは，次の計算式で見積もってください。

GETによる1HTTPアクセス当たりのログサイズ
= 1.75 +（平均レスポンスボディサイズ / 16）* 0.25

POSTによる1HTTPアクセス当たりのログサイズ
= 2.00 +（平均POSTデータサイズ / 16）* 0.5 +（平均レスポンスボディサイズ / 16）* 0.25

なお，単位はすべてキロバイト，除算結果の小数点以下の値はすべて切り捨てです。また，計算式ではリクエストURLとクエリー文字列の平均サイズは，それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は，計算式の最初の値に，超える分のサイズを加えて計算してください。

(b)　Microsoft IISの場合

Microsoft IISを使用している場合は，isapi_redirect.confでリダイレクタのログ取得の設定を変更できます。

注意事項

isapi_redirect.confに設定されたファイルサイズ，およびファイル面数のログファイルは，Webサーバとの連携の設定後の初回リクエスト時に作成されます。ログファイルの作成は，ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合，またはファイル面数を増やした場合などは，ログファイルの作成処理に数分掛かる場合があります。

Webサーバとの連携の設定後およびログファイルの設定変更後の初回リクエストは，運用を開始する前に実施しておくことをお勧めします。

●変更した設定を有効にする方法

変更したリダイレクタのログ取得の設定を有効にする方法は，Microsoft IISのバージョンによって異なります。

ファイルサイズまたはファイル面数を変更する場合に，変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

Microsoft IISを停止します。

ログファイルおよび管理ファイルを移動または削除します。
メッセージログファイルの場合：メッセージログファイルおよびHNTRLibが使用する管理ファイル（<log_file_prefixの設定値>.mm）を移動，または削除します。
保守用トレースログファイルの場合：保守用トレースログファイルおよびHNTRLibが使用する管理ファイル（< trace_log_file_prefixの設定値>.mm）を移動，または削除します。

Microsoft IISを起動します。
ファイルサイズおよびファイル面数を変更しない場合に，変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

Microsoft IISを再起動するか，またはワーカプロセスのリサイクルを行います。
Microsoft IISの「インフォメーション サービス マネージャ」を使用して，ワーカプロセスのリサイクルができます。

●変更できる設定項目

変更できる設定項目と，項目に対応するユーザ定義ファイルとキーを次の表に示します。なお，Microsoft IISのバージョンによっては，キーに指定する値が異なります。isapi_redirect.confについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表H-8　Microsoft IISでのリダイレクタのログ取得の設定項目（サーブレットエンジンモードの場合）

項目 | isapi_redirect.confのキー
メッセージログ，保守用トレースログのログ出力レベル | log_level
メッセージログ出力先 | log_file_dir
メッセージログファイルサイズ | log_file_size
メッセージログファイル面数 | log_file_num
メッセージログファイル名のプリフィックス | log_file_prefix
保守用トレースログ出力の有無 | trace_log
保守用トレースログ出力先 | trace_log_file_dir※
保守用トレースログファイルサイズ | trace_log_file_size
保守用トレースログファイル面数 | trace_log_file_num
保守用トレースログファイル名のプリフィックス | trace_log_file_prefix※

注※　保守用トレースログの出力先とプリフィックスには，同じ値を指定しないでください。同じ値を指定した場合は，リダイレクタが動作しません。

メッセージログ，および保守用トレースログのデフォルトの出力先

<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs

ログレベルのレベル名

ログレベルのレベル名には，重要度の高い順に「emerg」，「error」，「info」，「debug」のどれかを指定できます。

emerg：通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。

error：通常運用時に指定します。

info：テスト時に指定します。

debug：障害調査時に指定します。

ログレベルは，単独で指定してください（コンマ区切りで複数のログレベルを指定しないでください）。あるログレベルを指定すると，指定されたログレベルおよびそれよりも重要度の高いログが出力されます。

ログサイズの見積もりの計算式

GETリクエスト，POSTリクエストの1HTTPアクセス当たりのログサイズは，次の計算式で見積もってください。

GETによる1HTTPアクセス当たりのログサイズ
= 2.25 + (平均レスポンスボディサイズ / 16) * 0.25

POSTによる1HTTPアクセス当たりのログサイズ
= 2.50 + (平均POSTデータサイズ / 16) * 0.5 + (平均レスポンスボディサイズ / 16) * 0.25

なお，単位はすべてキロバイト，除算結果の小数点以下の値はすべて切り捨てです。また，計算式ではリクエストURLとクエリー文字列の平均サイズは，それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は，計算式の最初の値に，超える分のサイズを加えて計算してください。

(4)　Cosminexus TPBrokerのログ取得の設定

Cosminexus TPBrokerのトレースファイルの出力先，ファイル数，エントリ数の変更について説明します。

Cosminexus TPBrokerのトレースファイルのデフォルトの出力先は次のとおりです。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/logs/TPB/logj

変更できる項目と，項目に対応するユーザ定義ファイルとキーを次に示します。

項目
対応するユーザ定義ファイルとキー

トレースファイルの出力先
usrconf.cfgのweb.server.log.directoryキー
または
usrconf.propertiesのvbroker.orb.htc.tracePathキー

トレースファイルのファイル数
usrconf.propertiesのvbroker.orb.htc.comt.fileCountキー

トレースファイルのエントリ数
usrconf.propertiesのvbroker.orb.htc.comt.entryCountキー

ファイルおよびキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意事項

トレースファイルの出力先を変更する場合は，変更後のトレースファイル出力先ディレクトリのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。出力先を変更すると，変更後のログ出力先ディレクトリ下のcomtrcとmdltrcにトレースファイルが出力されます。

usrconf.cfgのweb.server.log.directoryキーと，usrconf.propertiesのvbroker.orb.htc.tracePathキーをどちらも設定した場合は，usrconf.propertiesのvbroker.orb.htc.tracePathキーの設定が優先されます。

(5)　Cosminexus DABroker Libraryのログ取得の設定

環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルで，ログファイルサイズなどを設定します。環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(6)　OSの統計情報取得の設定

Windowsのシステムモニタを使用して，システムリソースのパフォーマンスデータを取得できます。システムリソースのパフォーマンスデータを取得するための設定方法は，運用管理ポータルでシステムを構築する場合の設定方法と同じです。詳細については，マニュアル「Cosminexus　運用管理操作ガイド」および「5.16　OSの統計情報取得の設定」を参照してください。

(7)　ユーザダンプ取得の設定

ユーザダンプを取得するためには，ワトソン博士を使用できるように設定しておいてください。ユーザダンプを取得するための設定方法は，運用管理ポータルでシステムを構築する場合の設定方法と同じです。詳細については，マニュアル「Cosminexus　運用管理操作ガイド」および「5.17　ユーザダンプ取得の設定」を参照してください。

(8)　coreダンプ取得の設定

coreダンプを取得するための設定方法は，運用管理ポータルでシステムを構築する場合の設定方法と同じです。詳細については，マニュアル「Cosminexus　運用管理操作ガイド」および「5.18　coreダンプ取得の設定」を参照してください。ただし，サーブレットエンジンモードの場合は，簡易構築定義ファイルではなく，Webコンテナサーバ用のusrconf.cfgで設定します。設定時には，簡易構築定義ファイルで設定するパラメタを，Webコンテナサーバ用のusrconf.cfgのキーに読み替えてください。Webコンテナサーバ用のusrconf.cfgについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(9)　JavaVMの資料取得の設定

ここでは，次に示すJavaVMの資料を取得するための設定について説明します。

JavaVMのスレッドダンプ

日立固有のJavaVMログ（日立JavaVMログファイル）

(a)　JavaVMのスレッドダンプ取得の設定

JavaVMのスレッドダンプを取得するための設定について説明します。

JavaVMのスレッドダンプに出力される内容は，usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）のadd.jvm.argキーに指定しているJavaVMの起動オプションによって異なります。

JavaVMのスレッドダンプを出力する場合に指定するオプションを次の表に示します。

表H-9　JavaVMのスレッドダンプを取得するために指定するオプション（サーブレットエンジンモードの場合）

オプション
説明

-XX:+HitachiThreadDump
拡張スレッドダンプを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpToStdout
拡張スレッドダンプを標準出力に出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithHashCode
スレッド情報にスレッドのハッシュコードを出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithCpuTime
スレッド情報にスレッドを開始してからのユーザCPU時間，およびカーネルCPU時間を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiThreadDumpWithBlockCount
スレッド情報にスレッドが処理をブロックした回数，および処理が待ち状態になった回数を出力します。デフォルトの状態では，出力するように設定されています。

-XX:+HitachiOutOfMemoryAbort
-XX:+HitachiOutOfMemoryAbortThreadDump
どちらも設定されている場合は，OutOfMemoryErrorによって強制終了した時に，スレッドダンプを出力します。ただし，J2SEクラスライブラリでCヒープ不足が発生した場合，およびJavaVMの処理中にCヒープ不足が発生した場合は，スレッドダンプを出力しません。

(b)　日立固有のJavaVMログ取得の設定

日立固有のJavaVMログを取得するための設定について説明します。

日立固有のJavaVMログとは，日立が標準のJavaVMに追加した拡張オプションを使用して取得できるログです。標準のJavaVMよりも，多くのトラブルシュート情報が取得できます。このログファイルを，日立JavaVMログファイルといいます。

日立JavaVMログファイルを取得するためには，usrconf.cfg（Webコンテナサーバ用オプション定義ファイル）のadd.jvm.argキーにJavaVMの起動オプションを指定します。

日立JavaVMログファイルを取得するために指定するオプションを次の表に示します。

表H-10　日立固有のJavaVMログ（日立JavaVMログファイル）を取得するために指定するオプション（サーブレットエンジンモードの場合）

オプション
説明

-XX:+HitachiOutOfMemoryStackTrace
-XX:+HitachiVerboseGC
-XX:+HitachiJavaClassLibTrace
三つのオプションのうちどれかを指定している場合に，日立JavaVMログファイルを出力します。

-XX:+HitachiOutOfMemoryStackTraceを指定している場合は，例外情報とスタックトレースを日立JavaVMログファイルに出力します。なお，このオプションを指定すると，-XX:+HitachiOutOfMemorySizeおよび-XX:+HitachiOutOfMemoryCauseも同時に指定されます。

-XX:+HitachiVerboseGCを指定している場合は，ガーベージコレクションが発生したときに，拡張verbosegc情報を日立JavaVMログファイルに出力します。

-XX:+HitachiJavaClassLibTraceを指定している場合は，クラスライブラリのスタックトレースを日立JavaVMログファイルに出力します。

必要に応じて，次の拡張オプションを指定して，日立JavaVMログファイルの出力方法や出力内容を設定してください。

日立JavaVMログファイルのファイルサイズやファイル数

拡張verbosegc機能オプション

OutOfMemoryError発生時の拡張機能オプション

クラスライブラリトレース機能オプション

ローカル変数情報出力機能オプション

スワップ領域の予約オプション　など

JavaVMのオプションについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(c)　拡張verbosegc機能オプションの設定

ここでは，JavaVMの保守情報（Javaヒープの情報）およびガーベージコレクションのログに拡張verbosegc情報を出力するための設定について説明します。次の表に示すオプションで，拡張verbosegc情報の出力を有効にして，拡張verbosegc情報の出力形式を指定してください。

表H-11　拡張verbosegc情報を出力するために指定するオプション（サーブレットエンジンモードの場合）

オプション | 説明
-XX:+HitachiVerboseGC | 拡張verbosegc情報を日立JavaVMログファイルに出力します。
-XX:+HitachiVerboseGCPrintDate | 拡張verbosegc情報の各行に日付を出力します。
-XX:+HitachiVerboseGCCpuTime※ | ガーベージコレクションの開始から終了までの間で，ガーベージコレクションを実行したスレッドのCPU利用時間を出力します。CPU利用時間は，ユーザモードで費やしたCPU時間とカーネルモードで費やしたCPU時間に分けて出力されます。
-XX:HitachiVerboseGCIntervalTime=<時間間隔(秒)> | 拡張verbosegc情報の出力間隔を指定します。
-XX:+HitachiVerboseGCPrintCause | 拡張verbosegc情報に，ガーベージコレクションが発生した要因を出力します。
-XX:+HitachiOutputMilliTime | 拡張verbosegc情報の各行に日時（ミリ秒まで）を出力します。
-XX:+HitachiCommaVerboseGC | 拡張verbosegc情報をCSV形式で出力します。

注※

HP-UXの場合，このオプションは使用できません。オプションを指定しても無視されます。

拡張verbosegc情報から，そのサーバで必要とするJavaヒープ領域サイズ，Perm領域サイズなどを見積もるための情報を取得できます。

(10)　Webアプリケーションのユーザログ出力の設定

ここでは，Webアプリケーションが出力するログを，日立トレース共通ライブラリ形式で出力するための設定方法について説明します。Webアプリケーションのユーザログを出力しない場合は，この設定は不要です。

Cosminexusでは，日立トレース共通ライブラリを使用して，Webアプリケーションが出力するログをCosminexusの構成ソフトウェアが出力するログと同じ形式（日立トレース共通ライブラリ形式）で出力できます。これによって，システムのログとWebアプリケーションのログを同じ形式で扱うことができるようになり，システム全体のログ運用の信頼性とログ出力の性能を高められます。

Webアプリケーションが出力するログを，日立トレース共通ライブラリ形式で出力する場合は，Webアプリケーションを開発する際に，ログ出力処理を設定する必要があります。また，usrconf.propertiesを編集して，ハンドラからのログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定する必要があります。

ユーザログを出力するための設定方法については，「5.20　アプリケーションのユーザログ出力の設定」を参照してください。ただし，次の点に注意してください。ただし，サーブレットエンジンモードの場合は，簡易構築定義ファイルではなく，Webコンテナサーバ用のusrconf.propertiesで設定します。設定時には，簡易構築定義ファイルで設定するパラメタを，Webコンテナサーバ用のusrconf.propertiesのキーに読み替えてください。Webコンテナサーバ用のusrconf.propertiesについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

サーブレットエンジンモードの場合は，usrconf.propertiesの格納場所が異なります。サーブレットエンジンモードのusrconf.propertiesの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

サーブレットエンジンモードの場合は，セキュリティポリシーをweb.policyに指定してください。web.policyの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web.policy

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web.policy

付録H.5　統合ユーザ管理機能の設定

ここでは，サーブレットエンジンモードの場合の，統合ユーザ管理機能の設定について説明します。統合ユーザ管理機能を使用しない場合は，この設定は不要です。

＜この項の構成＞

(1)　統合ユーザ管理機能の設定手順

(2)　統合ユーザ管理機能の設定方法

(1)　統合ユーザ管理機能の設定手順

統合ユーザ管理機能の設定手順について説明します。

Cosminexusでは，Cosminexusで構築したシステムにログインするユーザを統合管理できます。統合ユーザ管理では，それぞれのJ2EEアプリケーションが管理しているユーザの情報が関連づけて管理され，一度のログイン処理でさまざまなJ2EEアプリケーションにログインできるようになります。統合ユーザ管理機能を使用する場合は，ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定する必要があります。

統合ユーザ管理機能を使用するための設定手順は，運用管理ポータルを使用してシステムを構築するときの設定手順とほとんど同じです。運用管理ポータルを使用したシステム構築の場合の統合ユーザ管理機能の設定手順については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

(2)　統合ユーザ管理機能の設定方法

統合ユーザ管理機能の設定方法について説明します。

統合ユーザ管理機能を使用するための設定方法は，運用管理ポータルを使用してシステムを構築するときの設定方法とほとんど同じです。運用管理ポータルを使用したシステム構築の場合の統合ユーザ管理機能の設定方法については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。ただし，サーブレットエンジンモードの場合では，設定方法が少し異なります。設定方法の差異を次に示します。

(a)　サーバ名について

サーブレットエンジンモードの場合は，「J2EEサーバ」を「Webコンテナサーバ」と読み替えてください。

(b)　ユーザ情報の登録について

サーブレットエンジンモードの場合は，統合ユーザ管理GUI（Management Serverの運用管理ポータルの「リポジトリ管理」）でのユーザ情報の登録はできません。ユーザ情報は，コマンド，ユーザ認証ライブラリまたはシングルサインオンライブラリのAPIを使用して登録してください。

(c)　JavaVMのプロパティの設定について

サーブレットエンジンモードの場合は，次の点に注意してください。

プロパティを設定するusrconf.propertiesの格納場所が異なります。サーブレットエンジンモードのusrconf.propertiesの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.properties

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

「server.policy」を「web.policy」と読み替えてください。web.policyの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web.policy

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web.policy

サーブレットエンジンモードの場合は，JavaVM起動時のプロパティの設定例で，codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-"が，codeBase "file:${webserver.install.root}/containers/${webserver.serverName}/webapps/-"となります。

(d)　ファイルのデプロイについて

サーブレットエンジンモードの場合は，デプロイする統合ユーザ管理用の「EARファイル（uastartup.ear）」を「WARファイル（uastartup.war）」と読み替えてください。また，WARファイルのデプロイについては，「付録H.6(1)　Webアプリケーションのデプロイ」を参照してください。uastartup.warは，次に示すディレクトリにインストールされています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

(e)　JSPタグライブラリを使用している場合の設定について

Webコンテナサーバにデプロイ済みのWebアプリケーションで，JSPタグライブラリを使用している場合には，ファイルのコピーや編集が必要です。

JSPタグライブラリ用のJARファイル（uatags.jar）とタグライブラリ記述子ファイル（uatags.tld）をコピーして，WebアプリケーションのDD（web.xml）を編集してください。手順を次に示します。

uatags.jarを，<デプロイ先ディレクトリ>¥<Webアプリケーション名>¥WEB-INF¥lib（Windowsの場合），または<デプロイ先ディレクトリ>/<Webアプリケーション名>/WEB-INF/lib（UNIXの場合）にコピーします。
例えば，uCosminexus Portal Frameworkを使用する場合，<Webアプリケーション名>は，Portalです。

uatags.tldを，<デプロイ先ディレクトリ>¥<Webアプリケーション名>¥WEB-INF（Windowsの場合），または<デプロイ先ディレクトリ>/<Webアプリケーション名>/WEB-INF（UNIXの場合）にコピーします。

web.xmlの適切な位置に次の記述を追加します。

<taglib>
<taglib-uri>http://cosminexus.com/admin/auth/uatags</taglib-uri>
<taglib-location>/WEB-INF/uatags.tld</taglib-location>
</taglib>

web.xmlは次の場所に格納されています。

Windowsの場合
<デプロイ先ディレクトリ>¥<Webアプリケーション名>¥WEB-INF¥web.xml

UNIXの場合
<デプロイ先ディレクトリ>/<Webアプリケーション名>/WEB-INF/web.xml

<デプロイ先ディレクトリ>については，「付録H.7　Webコンテナサーバの作業ディレクトリ」を参照してください。

参考

JSPタグライブラリを使用したWebアプリケーションの作成については，マニュアル「Cosminexus　機能解説」のタグライブラリを使用したユーザ認証の実装に関する説明を参照してください。なお，JSPタグライブラリを使用する場合は，上記の手順3.に従ってweb.xmlを編集してください。

付録H.6　Webアプリケーションの設定

サーブレットエンジンモードの環境では，Webアプリケーションを実行する前に，Webコンテナサーバにデプロイします。Webアプリケーションのデプロイについては，「(1)　Webアプリケーションのデプロイ」を参照してください。Webアプリケーションのアンデプロイについては，「(2)　Webアプリケーションのアンデプロイ」を参照してください。また，Webアプリケーションへのサーブレットフィルタの追加については，「(3)　Webアプリケーションに組み込むサーブレットフィルタの設定」を参照してください。

なお，Webアプリケーションは，DeveloperやIDEなどを使用して，あらかじめ作成しておいてください。DeveloperやIDEによるWebアプリケーションの作成については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

＜この項の構成＞

(1)　Webアプリケーションのデプロイ

(2)　Webアプリケーションのアンデプロイ

(3)　Webアプリケーションに組み込むサーブレットフィルタの設定

(1)　Webアプリケーションのデプロイ

Webアプリケーションのデプロイ方法は，次の2種類あります。

WARファイルのコピーによるデプロイ

ディレクトリのコピーによるデプロイ

それぞれのデプロイ方法について説明します。また，ルートコンテキストを使用し，ドメイン名を指定してWebアプリケーションのトップページを表示させる方法についても説明します。

(a)　WARファイルのコピーによるデプロイ

WARファイルのコピーによるデプロイの手順を次に示します。

WARファイルを次に示す場所にコピーします。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps"

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps

cjstartwebコマンドを実行して，Webコンテナサーバを起動します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstartweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>

これによって，WARファイルが自動展開され，Webアプリケーションを利用できるようになります。デプロイ後は，手順1.で示した場所にWARファイル名の拡張子（.war）を除いた名前のディレクトリが作成されます。このディレクトリ名が，コンテキスト名として使用されます。
cjstartwebコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(b)　ディレクトリのコピーによるデプロイ

ディレクトリのコピーによるデプロイの手順を次に示します。

次に示す場所にWebアプリケーションのディレクトリ階層をコピーします。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps"

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps

cjstartwebコマンドを実行して，Webコンテナサーバを起動します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstartweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>

これによって，Webアプリケーションを利用できるようになります。コンテキスト名としては，コピーされたディレクトリ名がそのまま使用されます。
cjstartwebコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(c)　ドメイン名指定でのトップページの表示

デプロイしたWebアプリケーションにアクセスするとき，URLにドメイン名を指定するだけで，Webアプリケーションのトップページを表示させるには，次の設定が必要です。

リダイレクタのURLマッピング定義で，ルートコンテキストにリクエストが振り分けられるように設定する必要があります。リダイレクタでの設定については，「18.5　ドメイン名指定でトップページを表示するための設定」を参照してください。
なお，サーブレットエンジンモードの場合は，Webアプリケーションをデプロイするときにルートコンテキストを指定します。

index.htmlやindex.jspなどのWebアプリケーションのトップページをルートコンテキストに配置する必要があります。Webアプリケーションのコンテキストルートを「ROOT」にしてデプロイしてください。

WARファイルのコピーによるデプロイの場合

WARファイル名を「ROOT.war」にしてデプロイしてください。

なお，拡張子（.war）を除いたWARの名前はすべて大文字の「ROOT」にします。「Root」や「root」のように小文字を含んでいる場合は，拡張子（.war）を除いたWARの名前がコンテキストルートとなります。例えば，WARファイル名が「Root.war」の場合，ルートコンテキストではなく，コンテキストルートが「Root」のコンテキストになります。

ディレクトリのコピーによるデプロイの場合

ディレクトリ名を「ROOT」にしてデプロイしてください。

なお，ディレクトリ名「ROOT」はすべて大文字にします。「Root」や「root」のように小文字を含んでいる場合は，指定したディレクトリの名前がコンテキストルートとなります。例えば，ディレクトリ名が「Root」の場合，ルートコンテキストではなく，コンテキストルートが「Root」のコンテキストになります。

(2)　Webアプリケーションのアンデプロイ

Webアプリケーションのアンデプロイ方法は，次の2種類あります。

WARファイルの削除によるアンデプロイ

ディレクトリの削除によるアンデプロイ

それぞれのアンデプロイ方法について説明します。

(a)　WARファイルの削除によるアンデプロイ

WARファイルの削除によるアンデプロイの手順を次に示します。

cjstopwebコマンドを実行して，Webコンテナサーバを停止します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstopweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstopweb <サーバ名称>

該当するWARファイル，および次に示す場所に自動展開されたディレクトリを削除します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps"

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps

Webコンテナサーバを再起動します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstartweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>

これによって，Webアプリケーションのアンデプロイが有効になります。

(b)　ディレクトリの削除によるアンデプロイ

ディレクトリの削除によるアンデプロイの手順を次に示します。

cjstopwebコマンドを実行して，Webコンテナサーバを停止します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstopweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstopweb <サーバ名称>

次に示す場所にコピーしたディレクトリを削除します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥webapps"

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps

Webコンテナサーバを再起動します。

Windowsの場合
"<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjstartweb <サーバ名称>"

UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>

これによって，Webアプリケーションのアンデプロイが有効になります。

(3)　Webアプリケーションに組み込むサーブレットフィルタの設定

Cosminexusでは，Cosminexus独自の機能を使用するためのサーブレットフィルタを提供しています。Cosminexusが提供するサーブレットフィルタをbuilt-inフィルタといいます。

Cosminexusで提供しているbuilt-inフィルタのうち，サーブレットエンジンモードで使用できるフィルタは，HTTPレスポンス圧縮フィルタだけです。

各built-inフィルタの処理内容，およびbuilt-inフィルタの組み込み順序については，マニュアル「Cosminexus　機能解説」のCosminexusが提供するサーブレットフィルタに関する説明を参照してください。

サーブレットエンジンモードの場合は，WebアプリケーションのDD（web.xml）を直接編集してフィルタを組み込む必要があります。built-inフィルタの組み込みについては，マニュアル「Cosminexus　機能解説」のHTTPレスポンス圧縮フィルタを使用するアプリケーションの実装に関する説明を参照してください。

付録H.7　Webコンテナサーバの作業ディレクトリ

Webコンテナサーバは作業ディレクトリ中にサーバ名やWebアプリケーションのコンテキストルート名，WARファイル中のファイルなどを用いてディレクトリやファイルを生成します。ディレクトリ名やファイル名，パス全体の長さには上限があり，作業ディレクトリ全体がパス全体の上限に収まらないとWebコンテナサーバは正常に動作できません。ここでは，Webコンテナサーバの作業ディレクトリの構成と作業ディレクトリのパス長の見積もり式を説明します。

＜この項の構成＞

(1)　作業ディレクトリの構成

(2)　作業ディレクトリのパス長の見積もり式

(1)　作業ディレクトリの構成

Webコンテナサーバの作業ディレクトリは，Webコンテナサーバが動作する上で必要な作業領域です。この領域には，ユーザ定義ファイル，ログ，Webアプリケーションなどの情報が格納されます。

Webコンテナサーバには，次の作業ディレクトリがあります。

Webアプリケーション

JSP用一時ディレクトリ

上記の作業ディレクトリの構成についてそれぞれ説明します。

ディレクトリ構成を図で示したあと，各ディレクトリを説明します。なお，図中の番号と説明の番号は対応しています。

(a)　Webアプリケーション

Webアプリケーションのディレクトリ構成を次の図に示します。

図H-2　Webアプリケーションのディレクトリ構成

WARファイル名の拡張子（.war）を除いた名前のディレクトリが作成されます。

WARファイルに含まれているファイルがここに解凍されます。

(b)　JSP用一時ディレクトリ

JSP用一時ディレクトリのディレクトリ構成を次の図に示します。

図H-3　JSP用一時ディレクトリのディレクトリ構成

WARファイル名の拡張子（.war）を除いた名前のディレクトリが作成されます。

JSPをコンパイルして作成されたクラスファイルが格納されます。JSPのファイル名に英数字以外の文字が含まれている場合は，それぞれ6文字の文字列に置き換えられます。また，ファイル名が数字で始まる場合は1文字付加されます。

(2)　作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式は次のようになります（単位：バイト）。これらの式がすべて満たされるように，各種パラメタを調整してください。なお，見積もり式中の「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。

A+B+C+D+25≦最大パス長

A'+C+E+2≦最大パス長

（凡例）

A：インストールディレクトリのパスの長さ。

A'：JSP用一時ディレクトリまでのパスの長さ。

B：最も長いサーバ名の長さ。

C：最も長いコンテキストルートの長さ。

D：WARファイル内で最も長いパスの長さ。

E：最も長いJSPのファイル名（WARファイル内のパスを含む。英数字以外を含む場合は英数字以外の文字×6で換算。JSPファイルが数字で始まる場合は1を加算）の長さ。

付録H.8　サーブレットエンジンモードの移行情報

サーブレットエンジンモードの場合の，旧バージョンからCosminexus 07-60への移行方法について説明します。移行の対象となるバージョンを次に示します。

Cosminexus 07-50

Cosminexus 07-10

Cosminexus 07-00

Cosminexus 06-71

Cosminexus 06-70

Cosminexus 06-51

Cosminexus 06-50

Cosminexus 06-02（Windowsだけのバージョン）

Cosminexus 06-00

なお，このマニュアルでは，次に示す構成ソフトウェアの移行を中心に説明します。

Cosminexus Component Container

Cosminexus Performance Tracer

旧バージョンからの移行を行う場合，使用しているCosminexusの全構成ソフトウェアを同時に移行する必要があります。上記で示していないほかの構成ソフトウェア（以降，他構成ソフトウェアと呼びます）の移行については，各構成ソフトウェアのドキュメントを参照してください。

＜この項の構成＞

(1)　Cosminexusの移行の概要

(2)　Cosminexusの移行の手順

(3)　旧バージョンからの仕様変更の確認

(4)　移行前の確認

(5)　定義などのバックアップ

(6)　手動による定義などの修正

(1)　Cosminexusの移行の概要

Cosminexusの移行の概要について説明します。

(a)　移行のためのアップグレードインストール

旧バージョンからCosminexus 07-60へ移行するためには，アップグレードインストールを行います。アップグレードインストールとは，インストール先のマシンに旧バージョンのCosminexusがインストール済みの場合のインストールです。

なお，アップグレードインストールの場合は，Cosminexusのインストールディレクトリを旧バージョンのインストールディレクトリから変更できません。旧バージョンがインストールされているディレクトリに上書きインストールされます。

(b)　移行時に引き継がれる情報

Cosminexusを旧バージョンから07-60に移行する場合，旧バージョンで使用されていた，Cosminexusのインストールディレクトリ以下に配置される定義情報，DD情報，構成情報などのユーザ資産は，移行コマンドなどで必要に応じて自動変換され，07-60で引き続き使用されます（一部，手動での定義修正が必要な場合もあります）。Cosminexus Component Containerで引き継がれる定義情報，DD情報，構成情報などを次の表に示します。他構成ソフトウェアについては，それぞれのドキュメントを参照してください。

表H-12　Cosminexus Component Containerで移行時に引き継がれる情報（サーブレットエンジンモードの場合）

機能
引き継がれる情報
ファイル名称，または配置場所

Webコンテナサーバ
オプション定義ファイル
usrconf.cfg

ユーザプロパティファイル
usrconf.properties

Webアプリケーションプロパティファイル
hitachi_web.properties

ユーザ認証情報定義ファイル
web-users.xml

Security Manager定義ファイル
web.policy

作業ディレクトリ

定義情報

アプリケーション

DD情報

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers以下

UNIXの場合
/opt/Cosminexus/CC/web/containers以下

Webサーバ連携
Hitachi Webサーバ用リダイレクタ動作定義ファイル
mod_jk.conf

Microsoft IIS用リダイレクタ動作定義ファイル（Windowsだけのファイル）
isapi_redirect.conf

Microsoft IIS用マッピング定義ファイル（Windowsだけのファイル）
uriworkermap.properties

ワーカ定義ファイル
workers.properties

統合ユーザ管理
JAASのコンフィグレーションファイル
jaas.conf

統合ユーザ管理のコンフィグレーションファイル
ua.conf

カスタムログインモジュール格納用ディレクトリ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥modules

UNIXの場合
/opt/Cosminexus/manager/modules

(2)　Cosminexusの移行の手順

次の手順に従って，旧バージョンからCosminexus 07-60へ移行してください。

旧バージョンからの仕様変更の確認

移行前の確認

定義などのバックアップ

他構成ソフトウェアの移行準備

全構成ソフトウェアのアップグレードインストール

Webコンテナサーバの移行コマンドの実行

手動による定義などの修正

他構成ソフトウェアの移行実施

移行後の確認

それぞれの手順について説明します。

(a)　旧バージョンからの仕様変更の確認

旧バージョンからの仕様変更を確認します。機能の変更や追加に伴い，旧バージョンで使用している機能，使用条件，使用方法によっては，次の作業が必要となります。

操作手順の変更

運用手順の変更

アプリケーション，およびDDの変更

なお，互換性を保つためのオプションが提供されている場合もありますが，推奨のオプションではありません。詳細については，「(3)　旧バージョンからの仕様変更の確認」を参照してください。

(b)　移行前の確認

移行前にCosminexusの動作環境，動作状態などを確認します。詳細については，「(4)　移行前の確認」を参照してください。

(c)　定義などのバックアップ

移行前に定義ファイルなどをバックアップします。詳細については，「(5)　定義などのバックアップ」を参照してください。

(d)　他構成ソフトウェアの移行準備

次に示す構成ソフトウェア以外の，他構成ソフトウェアの移行を準備します。

Cosminexus Component Container

Cosminexus Performance Tracer

移行の準備の詳細はそれぞれの他構成ソフトウェアのドキュメントを参照してください。なお，ここで準備した情報を基に，「(h)　他構成ソフトウェアの移行実施」で他構成ソフトウェアを移行してください。

(e)　全構成ソフトウェアのアップグレードインストール

使用しているCosminexusの全構成ソフトウェアをアップグレードインストールします。

(f)　Webコンテナサーバの移行コマンドの実行

定義情報，DD情報などを継続して利用できるようにするため，Webコンテナサーバの移行コマンドを実行します。実行する移行コマンドはcjenvupdateコマンドで，J2EEサーバを移行する場合と同じです。

移行コマンドの実行については，「付録A.7　J2EEサーバの移行コマンドの実行」を参照してください。このとき，J2EEサーバをWebコンテナサーバと読み替えてください。

(g)　手動による定義などの修正

手動で定義などを修正します。機能の変更，追加に伴い，互換性を保つためのオプションが提供されています。旧バージョンで使用している機能，使用方法，使用条件によっては，次の作業が必要となります。

ユーザプロパティファイルなどの定義ファイルの変更

Javaのユーザクラスパスの変更

環境変数の変更

詳細については，「(6)　手動による定義などの修正」を参照してください。

(h)　他構成ソフトウェアの移行実施

他構成ソフトウェアを移行します。移行の詳細はそれぞれの他構成ソフトウェアのドキュメントを参照してください。なお，「(d)　他構成ソフトウェアの移行準備」で準備した情報を基に移行を実施してください。

(i)　移行後の確認

移行後にCosminexusの動作確認を実施します。

(3)　旧バージョンからの仕様変更の確認

旧バージョンからの仕様変更を次の表に示します。

表H-13　旧バージョンからの仕様変更（サーブレットエンジンモードの場合）

分類
仕様変更の項目
07-10/
07-50
07-00
06-71/
06-70
06-51/
06-50
06-02/
06-00

全体
(a)　J2SEのバージョン
－
－
○
○
○

(b)　TPBrokerの運用支援機能の非サポート
－
－
○
○
○

Webコンテナサーバ
(c)　JavaVMのタイプ
－
－
－
－
○

(d)　JSPから生成されたサーブレット用コンパイラのバージョン
－
－
○
○
○

(e)　WebコンテナがサポートするServlet仕様のバージョン
－
－
○
○
○

(f)　デフォルトのエラーページの内容
－
－
－
○
○

(g)　カスタムタグのスクリプト変数定義の変更
－
－
○
○
○

(h)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更
－
－
○
○
○

(i)　タグの属性値のExpressionチェックの変更
－
－
○
○
○

(j)　タグの属性値に指定するExpressionに関する変更
－
－
○
○
○

(k)　taglibディレクティブのprefix属性に関する変更
－
－
○
○
○

(l)　JSPでの$の扱いの変更
－
－
○
○
○

（凡例）　○：仕様変更あり。　－：該当しない。

次に仕様変更の項目の詳細について説明します。なお，表の「仕様変更の項目」の項番は，説明の項番と対応しています。

(a)　J2SEのバージョン

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(1)　J2SEのバージョン」を参照してください。

(b)　TPBrokerの運用支援機能の非サポート

07-00以降では，07-00より前まで提供していたTPBrokerの運用支援機能は使用できません。システムの各プロセスを一括起動，停止，および監視する場合には，Management Serverを使用してください。Management Serverを使用する場合には，J2EEサーバモードに移行して，Smart Composer機能や運用管理ポータルでシステムを構築してください。

(c)　JavaVMのタイプ

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(8)　JavaVMのタイプ」を参照してください。なお，サーブレットエンジンモードの場合は，「J2EEサーバ」を「Webコンテナサーバ」と読み替えてください。

(d)　JSPから生成されたサーブレット用コンパイラのバージョン

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(10)　JSPから生成されたサーブレット用コンパイラのバージョン」を参照してください。なお，サーブレットエンジンモードの場合は，「J2EEサーバ」を「Webコンテナサーバ」と読み替えてください。

(e)　WebコンテナがサポートするServlet仕様のバージョン

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(11)　WebコンテナがサポートするServlet仕様のバージョン」を参照してください。なお，サーブレットエンジンモードの場合は，「J2EEサーバ」を「Webコンテナサーバ」と読み替えてください。

(f)　デフォルトのエラーページの内容

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(12)　デフォルトのエラーページの内容」を参照してください。

(g)　カスタムタグのスクリプト変数定義の変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(33)　カスタムタグのスクリプト変数定義の変更」を参照してください。

(h)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(34)　<jsp:useBean>タグのclass属性に対するエラーチェックの変更」を参照してください。

(i)　タグの属性値のExpressionチェックの変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(35)　タグの属性値のExpressionチェックの変更」を参照してください。

(j)　タグの属性値に指定するExpressionに関する変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(36)　タグの属性値に指定するExpressionに関する変更」を参照してください。

(k)　taglibディレクティブのprefix属性に関する変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(37)　taglibディレクティブのprefix属性に関する変更」を参照してください。

(l)　JSPでの$の扱いの変更

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.3(38)　JSPでの$の扱いの変更」を参照してください。

(4)　移行前の確認

移行前に，Cosminexusの動作環境，および動作状態を確認します。次に確認項目を示します。

旧バージョンのCosminexusが終了していることを確認してください。Cosminexusの全構成ソフトウェアを終了させます。

Microsoft IISを使用している場合は，Microsoft IISを終了させます。

(5)　定義などのバックアップ

移行前に定義ファイルなどのバックアップを取ります。バックアップを取るディレクトリを次の表に示します。

表H-14　バックアップを取るディレクトリ（サーブレットエンジンモードの場合）

機能
バックアップを取るディレクトリ

統合ユーザ管理

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager

UNIXの場合
/opt/Cosminexus/manager

Webサーバ連携

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector

UNIXの場合
/opt/Cosminexus/CC/web/redirector

Webコンテナサーバ

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers

UNIXの場合
/opt/Cosminexus/CC/web/containers

(6)　手動による定義などの修正

旧バージョンから移行する場合に，手動で定義などの修正が必要な項目を次の表に示します。

表H-15　手動で定義などの修正が必要な項目（サーブレットエンジンモードの場合）

分類
修正項目
07-00/
07-10/
07-50
06-71/
06-70
06-51/
06-50
06-02/
06-00

Webコンテナサーバ
(a)　セキュリティポリシーファイルの変更
－
○
○
○

(b)　統合ユーザ管理のタグライブラリの入れ替え
－
○
○
○

(c)　デフォルトエラーページのスタックトレース表示
－
－
○
○

(d)　JSPのコンパイル結果の削除
－
○
○
○

(e)　リダイレクタへのデータ送信処理のタイムアウト追加
－
○
○
○

(f)　ユーザスレッドの生成に必要な権限の追加
－
－
○
○

(g)　セッションIDへのサーバIDの付加
－
－
○
○

Webサーバ連携
(h)　リダイレクタのログ出力先変更
－
－
－
○

(i)　Webコンテナへのデータ送信処理のタイムアウト追加
－
○
○
○

(j)　リダイレクタの保守用トレースログの面数変更
－
○
○
－

（凡例）　○：修正が必要。　－：該当しない。

次に修正項目の詳細について説明します。なお，表の「修正項目」の項番は，説明の項番と対応しています。

(a)　セキュリティポリシーファイルの変更

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(15)　セキュリティポリシーファイルの変更」を参照してください。なお，サーブレットエンジンモードの場合は，「server.policyファイル」を「web.policyファイル」と読み替えてください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web.policy

UNIXの場合
opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web.policy

(b)　統合ユーザ管理のタグライブラリの入れ替え

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(16)　統合ユーザ管理のタグライブラリの入れ替え」を参照してください。

(c)　デフォルトエラーページのスタックトレース表示

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(17)　デフォルトエラーページのスタックトレース表示」を参照してください。

(d)　JSPのコンパイル結果の削除

07-00以降では，サーブレット／JSPのバージョンが変更になりました。このため，07-00より前のWebコンテナサーバのusrconf.propertiesファイルで，webserver.work.clean=falseを設定してJSPコンパイル結果を保持していた場合，07-00以降へ移行後，07-00より前で生成されたコンパイル結果を手動で削除してください。

次のどちらかの方法で，JSPコンパイル結果を削除します。

usrconf.propertiesでwebserver.work.clean=trueを設定して，Webコンテナサーバを再起動する。

JSPコンパイル結果を手動で削除する。

JSPコンパイル結果を手動で削除する方法については，マニュアル「Cosminexus　機能解説」のJSPファイルのコンパイル結果の保持に関する説明を参照してください。

(e)　リダイレクタへのデータ送信処理のタイムアウト追加

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(18)　リダイレクタへのデータ送信処理のタイムアウト追加」を参照してください。

(f)　ユーザスレッドの生成に必要な権限の追加

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(19)　ユーザスレッドの生成に必要な権限の追加」を参照してください。なお，サーブレットエンジンモードの場合は，「server.policyファイル」を「web.policyファイル」と読み替えてください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥web.policy

UNIXの場合
opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/web.policy

(g)　セッションIDへのサーバIDの付加

変更内容は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(20)　セッションIDへのサーバIDの付加」を参照してください。

(h)　リダイレクタのログ出力先変更

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(23)　リダイレクタのログ出力先変更」を参照してください。

(i)　Webコンテナへのデータ送信処理のタイムアウト追加

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(24)　Webコンテナへのデータ送信処理のタイムアウト追加」を参照してください。

(j)　リダイレクタの保守用トレースログの面数変更

変更方法は，J2EEサーバモードの場合と同じです。詳細については，「付録A.10(25)　リダイレクタの保守用トレースログの面数変更」を参照してください。

付録I　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（Windowsの場合）

クラスタソフトウェア（Microsoft Cluster Service）を使用して，Cosminexus TPBrokerをクラスタ構成で運用することができます。

Cosminexus TPBrokerでは，系切り替えの要因として次のものに対応します。

ハードウェア障害などクラスタサービスによるシステム障害の検出

ユーザによる計画的な系切り替え

＜この節の構成＞

付録I.1　Cosminexus TPBroker構成のプランニング

付録I.2　ORB機能使用時の設定

付録I.1　Cosminexus TPBroker構成のプランニング

システムの要求事項によって，系切り替えの構築に必要なCosminexus TPBrokerの機能と環境設定項目を決定します。

まず，次の機能を使用するかどうかを決定してください。

ORB機能

OTS機能

また，OTS機能を使用する場合，共有ディスクを使用します。

＜この項の構成＞

(1)　ORB機能

(2)　OTS機能

(1)　ORB機能

スマートエージェントやスマートエージェントに接続するプロセスをクラスタソフトウェア（Microsoft Cluster Service）で運用する場合は，ORB機能に関する各種IPアドレスを設定する必要があります。詳細については，「付録I.2　ORB機能使用時の設定」を参照してください。

なお，スマートエージェントに接続するプロセスとは，CORBAネーミングサービス，CTMデーモンおよびスマートエージェントを使用するJ2EEサーバ※のことです。

注※

usrconf.propertiesファイルのvbroker.agent.enableLocatorキーにtrueを指定してJ2EEサーバを起動している場合を指します。

(2)　OTS機能

トランザクションサービスはインプロセスで起動してください。

付録I.2　ORB機能使用時の設定

ここでは，ORB機能を使用する場合の設定について説明します。

この設定は，Microsoft Cluster Serviceを起動するホスト上で次のプロセスを起動する場合に設定してください。

スマートエージェント

CORBAネーミングサービス

また，スマートエージェントをフェイルオーバの対象とする場合は，Microsoft Cluster Serviceに「汎用アプリケーション」として登録してください。

＜この項の構成＞

(1)　スマートエージェントのlocaladdrファイルおよびhtc.clienthandleraddrファイルの設定

(2)　スマートエージェントまたはスマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，および環境変数「OSAGENT_ADDR」の設定

(3)　CORBAネーミングサービスの設定

(4)　J2EEサーバのvbroker.se.iiop_tp.hostキー，およびvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーの設定

(5)　環境変数およびオプションの設定

(6)　設定例

(1)　スマートエージェントのlocaladdrファイルおよびhtc.clienthandleraddrファイルの設定

クラスタソフトウェア上でスマートエージェントを起動する場合，各ノードのlocaladdrファイルおよびhtc.clienthandleraddrファイルを設定してください。なお，設定内容は，マルチホームドホスト環境の場合とそれ以外の場合で異なります。

マルチホームドホスト環境，またはマルチホームドホストでないホスト環境上でクラスタ環境を構築する場合の，スマートエージェントのlocaladdrファイルの設定内容を次の表に示します。

表I-1　スマートエージェントのlocaladdrファイルの設定内容

クラスタサービスおよびスマートエージェントを起動するホスト環境
スマートエージェントのlocaladdrファイルの設定内容

スマートエージェントをフェイルオーバの対象にする場合
スマートエージェントをフェイルオーバの対象にしない場合

マルチホームドホスト環境

ステーショナリIPアドレス（プライマリIPアドレス）

スマートエージェントに明示的に指定したいIPアドレス

クラスタIPアドレス

ステーショナリIPアドレス（プライマリIPアドレス）

スマートエージェントに明示的に指定したいIPアドレス

マルチホームドホストではないホスト環境

ステーショナリIPアドレス（プライマリIPアドレス）

クラスタIPアドレス

ステーショナリIPアドレス（プライマリIPアドレス）

次に，環境ごとの設定内容の詳細について説明します。また，htc.clienthandleraddrファイルについても説明します。

(a)　マルチホームドホスト環境

スマートエージェントをフェイルオーバの対象にする場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス），スマートエージェントに明示的に指定したいIPアドレス※，およびスマートエージェントが使用するクラスタIPアドレスを必ず設定してください。
また，スマートエージェントに接続するプロセスに対して，クラスタIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

スマートエージェントをフェイルオーバの対象にしない場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス），およびスマートエージェントに明示的に指定したいIPアドレス※を必ず設定してください。クラスタIPアドレスは設定しないでください。
また，スマートエージェントに接続するプロセスに対して，ステーショナリIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

注※

localaddrファイルを設定すると，スマートエージェントは，localaddrファイルに設定されたIPアドレスだけを認識します。localaddrファイルを設定しない場合，スマートエージェントはデフォルトでgethostbyname()から取得できるIPアドレスを認識します。

(b)　マルチホームドホストではないホスト環境

スマートエージェントをフェイルオーバの対象にする場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス）およびスマートエージェントが使用するクラスタIPアドレスを必ず設定してください。
また，スマートエージェントに接続するプロセスに対して，クラスタIPアドレスを返却するようにhtc.clienthandleraddrを定義してください。

スマートエージェントをフェイルオーバの対象にしない場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス）を必ず設定してください。クラスタIPアドレスは設定しないでください。
また，スマートエージェントに接続するプロセスに対して，ステーショナリIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

(2)　スマートエージェントまたはスマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，および環境変数「OSAGENT_ADDR」の設定

異なるネットワークドメイン上にあるスマートエージェント間で通信をする場合，または異なるネットワークドメイン上にあるスマートエージェントとスマートエージェントに接続するプロセス間の通信をする場合は，スマートエージェントまたはスマートエージェントに接続するプロセスの設定が必要です。設定は，各ノードのagentaddrファイル，vbroker.agent.addrプロパティ，環境変数「OSAGENT_ADDR」に設定します。

(a)　スマートエージェントへの設定

異なるネットワークドメイン上のスマートエージェント間で通信していて，スマートエージェントをフェイルオーバの対象とする場合，対象のスマートエージェントと通信をするスマートエージェントのagentaddrファイルに，クラスタIPアドレスを必ず設定してください。

(b)　スマートエージェントに接続するプロセスへの設定

スマートエージェントとスマートエージェントに接続するプロセスとを異なるネットワークドメイン上で起動し，かつスマートエージェントをフェイルオーバの対象とする場合，スマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，環境変数「OSAGENT_ADDR」のどれかに，フェイルオーバの対象となるスマートエージェントのクラスタIPアドレスを必ず設定してください。

(3)　CORBAネーミングサービスの設定

CORBAネーミングサービスをフェイルオーバの対象とする場合は，CORBAネーミングサービスの起動プロパティを設定します。

nameservコマンドに次の起動プロパティを設定してCORBAネーミングサービスを起動してください。

-J-Dvbroker.se.iiop_tp.host=クラスタIPアドレスまたはクラスタのネットワーク名

また，このプロパティに設定したクラスタIPアドレスまたはクラスタのネットワークを，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のキーの設定内容に反映してください。

ejbserver.naming.hostキーに設定するIPアドレスまたはホスト名称

ejbserver.jndi.namingservice.group.<Specify group name>.providerurlsキーに設定するプロバイダURL

usrconf.propertiesの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。nameservコマンドを使用したCORBAネーミングサービスの起動については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(4)　J2EEサーバのvbroker.se.iiop_tp.hostキー，およびvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーの設定

J2EEサーバをフェイルオーバの対象とする場合は，vbroker.se.iiop_tp.hostキーには，クラスタIPアドレスを指定してJ2EEサーバを起動してください。また，J2EEサーバが使用するポート番号は，すべての系で同じポート番号が使用できるように，usrconf.propertiesファイルのvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーを使用して管理してください。

(5)　環境変数およびオプションの設定

クラスタ環境でスマートエージェントを起動する場合，スマートエージェントに次の環境変数およびオプションの設定が必要です。

オプションは，スマートエージェントをフェイルオーバの対象とする場合だけ指定してください。

環境変数名：OSAGENT_CLIENT_HANDLER_PORT

オプション：-m

なお，環境変数の設定方法については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」のVisiBroker ORBドメイン内の作業についての説明を参照してください。

(6)　設定例

IPアドレスの設定例を次に示します。

設定例1

図I-1　スマートエージェントをフェイルオーバの対象にする場合のIPアドレスの設定例

図中の1.～5.について説明します。

hostAのlocaladdrファイルに「hostAのステーショナリIPアドレス（A.A.A.A） subnet broadcast」，「クラスタIPアドレス（C.C.C.C） subnet broadcast」を記述します。

hostBのlocaladdrファイルに「hostBのステーショナリIPアドレス（B.B.B.B） subnet broadcast」，「クラスタIPアドレス（C.C.C.C） subnet broadcast」を記述します。

hostA，hostBのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet クラスタIPアドレス（C.C.C.C）」を記述します。

hostAおよびhostBで起動するスマートエージェントに環境変数「OSAGENT_CLIENT_HANDLER_PORT」および-mオプションを設定します。

hostCのagentaddrファイルにクラスタIPアドレス（C.C.C.C）を記述します。

設定例2

図I-2　スマートエージェントをフェイルオーバの対象にしない場合のIPアドレスの設定例

図中の1.～6.について説明します。

hostAのlocaladdrファイルに「hostAのステーショナリIPアドレス（A.A.A.A） subnet broadcast」を記述します。

hostBのlocaladdrファイルに「hostBのステーショナリIPアドレス（B.B.B.B） subnet broadcast」を記述します。

hostAのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet hostAのステーショナリIPアドレス（A.A.A.A）」を記述します。

hostBのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet hostBのステーショナリIPアドレス（B.B.B.B）」を記述します。

hostCのagentaddrファイルにA.A.A.AおよびB.B.B.Bを記述します。

hostAおよびhostBで起動するスマートエージェントに環境変数「OSAGENT_CLIENT_HANDLER_PORT」を設定します。

付録J　クラスタソフトウェア連携時のCosminexus TPBrokerの設定（UNIXの場合）

クラスタソフトウェア（HAモニタ）を使用して，Cosminexus TPBrokerをクラスタ構成で運用することができます。

ただし，Solarisの場合は，HAモニタと連携できません。

Cosminexus TPBrokerでは，系切り替えの要因として次のものに対応します。

ハードウェア障害などクラスタサービスによるシステム障害の検出

ユーザによる計画的な系切り替え

＜この節の構成＞

付録J.1　Cosminexus TPBroker構成のプランニング

付録J.2　ORB機能使用時の設定

付録J.1　Cosminexus TPBroker構成のプランニング

システムの要求事項によって，系切り替えの構築に必要なCosminexus TPBrokerの機能と環境設定項目を決定します。

まず，次の機能を使用するかどうかを決定してください。

ORB機能

OTS機能

また，OTS機能を使用する場合，共有ディスクを使用します。

＜この項の構成＞

(1)　ORB機能

(2)　OTS機能

(3)　クラスタ構成で運用するための留意点

(1)　ORB機能

スマートエージェントやスマートエージェントに接続するプロセスをクラスタソフトウェア（HAモニタ）で運用する場合は，ORB機能に関する各種IPアドレスを設定する必要があります。詳細については，「付録J.2　ORB機能使用時の設定」を参照してください。

なお，スマートエージェントに接続するプロセスとは，CORBAネーミングサービス，CTMデーモンおよびスマートエージェントを使用するJ2EEサーバ※のことです。

注※

usrconf.propertiesのvbroker.agent.enableLocatorキーにtrueを指定してJ2EEサーバを起動している場合を指します。

(2)　OTS機能

トランザクションサービスはインプロセスで起動してください。

(3)　クラスタ構成で運用するための留意点

Cosminexus TPBrokerをクラスタ構成で運用する場合，次の点に留意してください。

Cosminexus TPBrokerを含むプログラム群は各系のローカルディスクに格納してください。

すべての系のCosminexus TPBrokerのバージョンを統一してください。

すべての系のCosminexus TPBrokerのシステム環境定義を統一してください。

J2EEアプリケーションで使用するポート番号が固定の場合，すべての系で同じポート番号が使用できるように管理してください。

付録J.2　ORB機能使用時の設定

ここでは，ORB機能を使用する場合の設定について説明します。

この設定は，HAモニタを起動するホスト上で次のプロセスを起動する場合に設定してください。

スマートエージェント

CORBAネーミングサービス

＜この項の構成＞

(1)　スマートエージェントのlocaladdrファイルおよびhtc.clienthandleraddrファイルの設定

(2)　スマートエージェントまたはスマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，および環境変数「OSAGENT_ADDR」の設定

(3)　CORBAネーミングサービスの設定

(4)　J2EEサーバのvbroker.se.iiop_tp.hostキー，およびvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーの設定

(5)　環境変数の設定

(6)　設定例

(1)　スマートエージェントのlocaladdrファイルおよびhtc.clienthandleraddrファイルの設定

クラスタソフトウェア上でスマートエージェントを起動する場合，各ノードのlocaladdrファイルおよびhtc.clienthandleraddrファイルを設定してください。なお，設定内容は，マルチホームドホスト環境の場合とそれ以外の場合で異なります。

マルチホームドホスト環境，またはマルチホームドホストでないホスト環境上でクラスタ環境を構築する場合の，スマートエージェントのlocaladdrファイルの設定内容を次の表に示します。

表J-1　スマートエージェントのlocaladdrファイルの設定内容

クラスタサービスおよびスマートエージェントを起動するホスト環境
スマートエージェントのlocaladdrファイルの設定内容

スマートエージェントを系切り替えの対象にする場合
スマートエージェントを系切り替えの対象にしない場合

マルチホームドホスト環境

ステーショナリIPアドレス（プライマリIPアドレス）

スマートエージェントに明示的に指定したいIPアドレス

エイリアスIPアドレス

ステーショナリIPアドレス（プライマリIPアドレス）

スマートエージェントに明示的に指定したいIPアドレス

マルチホームドホストではないホスト環境

ステーショナリIPアドレス（プライマリIPアドレス）

エイリアスIPアドレス

ステーショナリIPアドレス（プライマリIPアドレス）

次に，環境ごとの設定内容の詳細について説明します。また，htc.clienthandleraddrファイルについても説明します。

(a)　マルチホームドホスト環境

スマートエージェントを系切り替えの対象にする場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス），スマートエージェントに明示的に指定したいIPアドレス※，およびスマートエージェントが使用するエイリアスIPアドレスを必ず設定してください。
また，スマートエージェントに接続するプロセスに対して，エイリアスIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

スマートエージェントを系切り替えの対象にしない場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス），およびスマートエージェントに明示的に指定したいIPアドレス※を必ず設定してください。エイリアスIPアドレスは設定しないでください。
また，スマートエージェントに接続するプロセスに対して，ステーショナリIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

注※

localaddrファイルを設定すると，スマートエージェントは，localaddrファイルに設定されたIPアドレスだけを認識します。localaddrファイルを設定しない場合，スマートエージェントはデフォルトでgethostbyname()から取得できるIPアドレスを認識します。なお，スマートエージェントで認識するIPアドレスは，スマートエージェント起動時に，osagentコマンドに-vオプションを指定して，バーボースモードをオンにして起動することで確認できます。

(b)　マルチホームドホストではないホスト環境

スマートエージェントを系切り替えの対象にする場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス）およびスマートエージェントが使用するエイリアスIPアドレスを必ず設定してください。
また，スマートエージェントに接続するプロセスに対して，エイリアスIPアドレスを返却するようにhtc.clienthandleraddrを定義してください。

スマートエージェントを系切り替えの対象にしない場合
localaddrファイルには，ステーショナリIPアドレス（プライマリIPアドレス）を必ず設定してください。エイリアスIPアドレスは設定しないでください。
また，スマートエージェントに接続するプロセスに対して，ステーショナリIPアドレスを返却するようにhtc.clienthandleraddrファイルを定義してください。

(2)　スマートエージェントまたはスマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，および環境変数「OSAGENT_ADDR」の設定

異なるネットワークドメイン上にあるスマートエージェント間で通信をする場合，または異なるネットワークドメイン上にあるスマートエージェントとスマートエージェントに接続するプロセス間の通信をする場合は，スマートエージェントまたはスマートエージェントに接続するプロセスの設定が必要です。設定は，各ノードのagentaddrファイル，vbroker.agent.addrプロパティ，環境変数「OSAGENT_ADDR」に設定します。

(a)　スマートエージェントへの設定

異なるネットワークドメイン上のスマートエージェント間通信で，スマートエージェントを系切り替えの対象とする場合，対象のスマートエージェントと通信をするスマートエージェントのagentaddrファイルに，エイリアスIPアドレスを必ず設定してください。

(b)　スマートエージェントに接続するプロセスへの設定

スマートエージェントとスマートエージェントに接続するプロセスとを異なるネットワークドメイン上で起動し，かつスマートエージェントを系切り替えの対象とする場合，スマートエージェントに接続するプロセスのagentaddrファイル，vbroker.agent.addrプロパティ，環境変数「OSAGENT_ADDR」のどれかに，系切り替えの対象となるスマートエージェントのエイリアスIPアドレスを必ず設定してください。

(3)　CORBAネーミングサービスの設定

CORBAネーミングサービスを系切り替えの対象とする場合は，CORBAネーミングサービスの起動プロパティを設定します。

nameservコマンドに次の起動プロパティを設定してCORBAネーミングサービスを起動してください。

-J-Dvbroker.se.iiop_tp.host=エイリアスIPアドレスまたはエイリアスホスト名

また，このプロパティに設定したエイリアスIPアドレスまたはエイリアスホスト名を，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次のキーの設定内容に反映してください。

ejbserver.naming.hostキーに設定するIPアドレスまたはホスト名称

ejbserver.jndi.namingservice.group.<Specify group name>.providerurlsキーに設定するプロバイダURL

usrconf.propertiesの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。nameservコマンドを使用したCORBAネーミングサービスの起動については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

(4)　J2EEサーバのvbroker.se.iiop_tp.hostキー，およびvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーの設定

J2EEサーバをフェイルオーバの対象とする場合は，vbroker.se.iiop_tp.hostキーには，クラスタIPアドレスを指定してJ2EEサーバを起動してください。また，J2EEサーバが使用するポート番号は，すべての系で同じポート番号が使用できるように，usrconf.propertiesファイルのvbroker.se.iiop_tp.scm.iiop_tp.listener.portキーを使用して管理してください。

(5)　環境変数の設定

クラスタ環境でスマートエージェントを起動する場合，スマートエージェントに次の環境変数の設定が必要です。

環境変数名：OSAGENT_CLIENT_HANDLER_PORT

なお，環境変数の設定方法については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」のVisiBroker ORBドメイン内の作業についての説明を参照してください。

(6)　設定例

IPアドレスの設定例を次に示します。

設定例1

図J-1　スマートエージェントを系切り替えの対象にする場合のIPアドレスの設定例

図中の1.～5.について説明します。

hostAのlocaladdrファイルに「hostAのステーショナリIPアドレス（A.A.A.A） subnet broadcast」，「エイリアスIPアドレス（C.C.C.C） subnet broadcast」を記述します。

hostBのlocaladdrファイルに「hostBのステーショナリIPアドレス（B.B.B.B） subnet broadcast」，「エイリアスIPアドレス（C.C.C.C） subnet broadcast」を記述します。

hostA，hostBのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet エイリアスIPアドレス（C.C.C.C）」を記述します。

hostAおよびhostBで起動するスマートエージェントに環境変数「OSAGENT_CLIENT_HANDLER_PORT」を設定します。

hostCのagentaddrファイルにエイリアスIPアドレス（C.C.C.C）を記述します。

設定例2

図J-2　スマートエージェントを系切り替えの対象にしない場合のIPアドレスの設定例

図中の1.～6.について説明します。

hostAのlocaladdrファイルに「hostAのステーショナリIPアドレス（A.A.A.A） subnet broadcast」を記述します。

hostBのlocaladdrファイルに「hostBのステーショナリIPアドレス（B.B.B.B） subnet broadcast」を記述します。

hostAのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet hostAのステーショナリIPアドレス（A.A.A.A）」を記述します。

hostBのhtc.clienthandleraddrファイルに「クライアントのステーショナリIPアドレス（F.F.F.F） subnet hostBのステーショナリIPアドレス（B.B.B.B）」を記述します。

hostCのagentaddrファイルにA.A.A.AおよびB.B.B.Bを記述します。

hostAおよびhostBで起動するスマートエージェントに環境変数「OSAGENT_CLIENT_HANDLER_PORT」を設定します。

付録K　Cosminexusで提供するサンプルプログラム

Cosminexusでは，次に示すサンプルプログラムを提供しています。

Enterprise Bean（EJB2.0）のサンプルプログラム

Enterprise Bean（アノテーション）のサンプルプログラム

Enterprise Bean（Timer Service）のサンプルプログラム

Java Beansリソースのサンプルプログラム

ユーザログ機能のサンプルプログラム

Webアプリケーションのサンプルプログラム

ここでは，各サンプルの概要，サンプルの実行手順，およびサンプルの実行例を説明します。なお，サンプルプログラムは，サーバ管理コマンドを使用した実行手順と実行例について説明しています。

注意

ここでは，Windows環境でのサンプルプログラムの概要と実行方法について説明します。UNIX環境で使用する場合は，本文を次のとおりに読み替えてください。

Windows用のディレクトリ（<Cosminexusのインストールディレクトリ>¥）を，UNIX用のディレクトリ（/opt/Cosminexus/）に読み替えてください。

Windows環境で使用するバッチファイルは，UNIX環境ではシェルスクリプトになります。拡張子を除いて読み替えてください。
（例）Windows環境：testClient.bat，UNIX環境：testClient

また，07-50以降は，EJBクライアントアプリケーションの開始に，cjclstartapコマンドを使用します。cjclstartapコマンドの詳細は，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

なお，Cosminexusが提供するサンプルプログラムを実行する場合は，書き込み権限のある別のディレクトリへサンプルプログラムをコピーして使用することをお勧めします。

＜この節の構成＞

付録K.1　サーバ管理コマンドによるサンプル実行環境の構築，運用手順

付録K.2　Enterprise Bean（EJB2.0）のサンプルプログラム

付録K.3　Enterprise Bean（アノテーション）のサンプルプログラム

付録K.4　Enterprise Bean（Timer Service）のサンプルプログラム

付録K.5　JavaBeansリソースのサンプルプログラム

付録K.6　ユーザログ機能のサンプルプログラム

付録K.7　Webアプリケーションのサンプルプログラム

付録K.1　サーバ管理コマンドによるサンプル実行環境の構築，運用手順

ここでは，サーバ管理コマンドを使用してサンプルプログラムを実行する場合のJ2EEサーバの構築，運用手順を説明します。この手順は，付録K.3以降の各サンプルプログラムを実行するときに必要になります。

＜この項の構成＞

(1)　J2EEサーバのセットアップ

(2)　J2EEサーバのカスタマイズ

(3)　J2EEサーバの起動

(4)　リソースアダプタの設定

(5)　アプリケーションのインポート，設定，および開始

(6)　アプリケーションの停止，削除

(7)　J2EEサーバの終了

(1)　J2EEサーバのセットアップ

コマンドプロンプトでcjsetupコマンドを入力し，J2EEサーバをセットアップします。セットアップの実行例を次に示します。実行例では，「MyServer」という名称のJ2EEサーバをセットアップしています。

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup MyServer
KDJE40001-I The setup for the J2EE server has finished successfully. Server name = MyServer
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

(2)　J2EEサーバのカスタマイズ

アプリケーションにアクセスするための設定をします。アプリケーションにアクセスするには，次のどちらかの方法を使用します。

Webサーバと連携する。

J2EEサーバのインプロセスHTTPサーバ機能を使用する。

ここでは，設定や運用が容易なJ2EEサーバのインプロセスHTTPサーバ機能を使用する方法を説明します。

インプロセスHTTPサーバ機能を有効にするため，ユーザ定義ファイル（usrconf.properties）にプロパティキーを定義します。

ユーザ定義ファイルの格納先：

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥usrconf¥ejb¥MyServer¥usrconf.properties

定義するプロパティキー：

webserver.connector.inprocess_http.enabled=true

注意

インプロセスHTTPサーバでは，80番ポートをデフォルトで使用します。ポート番号を変更するには，ユーザ定義ファイル（usrconf.properties）に，webserver.connector.inprocess_http.portプロパティキーを定義します。

インプロセスHTTPサーバで使用するポート番号に8081番を定義する例を示します。

webserver.connector.inprocess_http.port=8081

(3)　J2EEサーバの起動

cjstartsvコマンドでセットアップ済みのJ2EEサーバを起動します。

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstartsv MyServer
＜起動ログが出力される＞
 ：
KDJE30028-I The J2EE server has started. Server name = MyServer

(4)　リソースアダプタの設定

次の手順でリソースアダプタの設定をします。

cjimportresコマンドでリソースアダプタをインポートします。

cjdeployrarコマンドを使用して，リソースアダプタをデプロイします。

cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。

cjtestresコマンドを使用して，リソースアダプタのテストをします。

cjstartrarコマンドを使用して，リソースアダプタを開始します。

(5)　アプリケーションのインポート，設定，および開始

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションを操作します。このバッチファイルでは，アプリケーションのJ2EEサーバへのインポートから，設定，開始が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjimportappコマンドが実行され，アプリケーションがJ2EEサーバにインポートされます。

cjsetapppropコマンドが実行され，アプリケーションの情報が設定されます。使用される属性ファイルは，「config.xml」です。

cjstartappコマンドが実行され，アプリケーションが開始されます。

cjlistappコマンドが実行され，J2EEサーバ上のアプリケーションの状態が一覧表示されます。この一覧を確認することで，アプリケーションが稼働状態（running）になっていることを確認できます。

(6)　アプリケーションの停止，削除

サンプルで提供するバッチファイル（undeployApp.bat）を使用して，アプリケーションを操作します。このバッチファイルでは，アプリケーションの停止とJ2EEサーバからの削除が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjstopappコマンドが実行され，アプリケーションが停止します。

cjdeleteappコマンドが実行され，アプリケーションがJ2EEサーバから削除されます。

cjlistappコマンドが実行され，J2EEサーバ上のアプリケーションの状態が一覧表示されます。この一覧を確認することで，アプリケーションが削除されたことを確認できます。

(7)　J2EEサーバの終了

cjstopsvコマンドでJ2EEサーバを終了します。

cjstopsvコマンドのコンソール

> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstopsv MyServer
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

J2EEサーバのコンソール

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstartsv MyServer
＜起動ログが出力される＞
 ：
KDJE30028-I The J2EE server has started. Server name = MyServer
 ：
<終了ログが出力される>
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

付録K.2　Enterprise Bean（EJB2.0）のサンプルプログラム

Enterprise Bean（EJB2.0）を使用したサンプルプログラムは，次に示すディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CC¥examples¥ejb¥ejb20

ここでは，サンプルプログラムの一覧，実行例，および各サンプルプログラムの概要について説明します。

＜この項の構成＞

(1)　Enterprise Bean（EJB2.0）のサンプルプログラム一覧

(2)　Enterprise Bean（EJB2.0）のサンプル実行手順

(3)　Enterprise Bean（EJB2.0）のサンプルの概要

(1)　Enterprise Bean（EJB2.0）のサンプルプログラム一覧

サンプルプログラムの一覧およびサンプルプログラム実行時の注意事項を示します。サンプルプログラムの一覧は，Enterprise Beanの種類と動作概要をまとめた一覧と，利用する技術，リソース，および動作モードをまとめた一覧に分けて示します。

注意

Enterprise Beanのサンプルプログラムは，現在使用している製品のバージョン・リビジョンのものを使用してください。旧バージョン・リビジョンのサンプルプログラムの動作は保証されません。

(a)　サンプルプログラム一覧（Enterprise Beanの種類と動作内容）

表K-1　サンプルプログラムの一覧（Enterprise Beanの種類と動作内容）

サンプル名 | Enterprise Bean種別 | パーシスタンス | トランザクション | 動作概要
account | Entity Bean | BMP | － | 預金や払い戻しに応じて残高を計算し，データベースを更新します。
adder | Stateful Session Bean | － | CMT | 入力数値の合計を計算して，ブラウザ上に表示します。
bank | Stateful Session Bean | － | CMT | 当座預金口座から普通預金口座に資金を移動し，データベースを更新します。
cart | Stateful Session Bean | － | CMT | 購入する本をショッピングカートに入れます。カートにない本をカートから出そうとした場合は，例外を発生させます。
checker | Stateful Session Bean | － | CMT | 割引対象となる金額を超えた場合，割引率を基に割引後の金額を計算します。割引対象となる金額と割引率は，Enterprise Beanの環境エントリで指定します。
cmp20product | Entity Bean | CMP2.0 | － | 商品情報をデータベースに登録し，登録された商品情報を検索します。このサンプルは，CMP 2.0形式のEnterprise Beanを利用します。
confirmer | Stateless Session Bean | － | CMT | 商品の注文に対する確認メールを送信します。
converter | Stateless Session Bean | － | CMT | 通貨の種類をドルから円，円からユーロに変換します。
enroller | Stateless Session Bean | － | CMT | 学生と科目の追加，および受講登録をして，データベースを更新します。
Entity Bean | BMP | －
jsptag | Stateless Session Bean | － | CMT | 通貨の種類をドルから円，円からユーロに変換します。このサンプルは，JSPを利用してブラウザ上に表示します。
jsptobean | Entity Bean | BMP | － | 預金や払い戻しに応じて残高を計算し，データベースを更新します。残高は，JSPを利用してブラウザ上に表示します。
localadder | Stateful Session Bean | － | CMT | 入力数値の合計を計算して，ブラウザ上に表示します。このサンプルは，サーブレットからローカルインタフェースを利用してEnterprise Beanを呼び出します。
message | Stateless Session Bean | － | CMT | JMSのキューを利用して，メッセージを送受信します。
Message -driven Bean | － | CMT
order | Entity Bean | BMP | － | 注文番号と対応する商品情報を検索して表示します。注文番号と商品情報はデータベースで管理します。
product | Entity Bean | CMP | － | 商品情報をデータベースに登録し，登録された商品情報を検索します。
salesrep | Entity Bean | BMP | － | 顧客の追加と，担当する販売員の変更を行い，データベースを更新します。
shipper | Stateful Session Bean | － | CMT | 注文に対する商品在庫を計算し，データベースを更新します。在庫が一定の数量を下回った場合，引き当て処理を呼び出します。
Entity Bean | BMP | －
storagebin | Entity Bean | BMP | － | データベースの部品情報テーブルと部品在庫情報テーブルから，対応する部品の情報と在庫を検索します。
teller | Stateful Session Bean | － | BMT | 銀行用端末機から当座預金のお金を引き出し，残高を計算します。
warehouse | Stateless Session Bean | － | CMT | 注文を受けた商品の状態，および商品の在庫を更新します。

（凡例）

－：該当しないことを示す。

(b)　サンプルプログラムの一覧（接続するリソース，クライアントの種類，動作モード）

サンプルプログラムの一覧と，接続するリソース，クライアントの種類，動作モードを次の表に示します。

表K-2　サンプルプログラム一覧（接続するリソース，クライアントの種類，動作モード）

サンプル | 接続するリソース※1 | クライアントの種類※2 | 動作モード
データベース | メール | JMS | EJBクライアントアプリケーション | Webブラウザ | B | 1.4
account | ○ | － | － | ○ | － | ◎ | ◎
adder | － | － | － | － | ○ | ◎ | ◎
bank | ○ | － | － | ○ | － | ◎ | ◎
cart | － | － | － | ○ | － | ◎ | ◎
checker | － | － | － | ○ | － | ◎ | ◎
confirmer | － | ○ | － | ○ | － | ◎ | ◎
converter | － | － | － | ○ | － | ◎ | ◎
enroller | ○ | － | － | ○ | － | ◎ | ◎
jsptag | － | － | － | － | ○ | ◎ | ◎
jsptobean | ○ | － | － | － | ○ | ◎ | ◎
order | ○ | － | － | ○ | － | ◎ | ◎
product | ○ | － | － | ○ | － | ◎ | ◎
salesrep | ○ | － | － | ○ | － | ◎ | ◎
shipper | ○ | － | － | ○ | － | ◎ | ◎
storagebin | ○ | － | － | ○ | － | ◎ | ◎
teller | ○ | － | － | ○ | － | ◎ | ◎
warehouse | ○ | － | － | ○ | － | ◎ | ◎
message | － | － | ○ | ○ | － | × | ◎
cmp20product | ○ | － | － | ○ | － | × | ◎
localadder | － | － | － | － | ○ | × | ◎

（凡例）

B：ベーシックモードを意味する。

1.4：1.4モードを意味する。

○：該当することを示す。　－：該当しないことを示す。

◎：実行できることを示す。　×：実行できないことを示す。

注※1

接続するリソースごとに，必要な設定があります。接続するリソースに応じて，「付録K.2(1)(c)　サンプルプログラムで使用するデータベースの設定」，「付録K.2(1)(d)　サンプルプログラムで使用するメールの設定」または「付録K.2(1)(e)　サンプルプログラムで使用するJMSの設定」を参照してください。

注※2

クライアントの種類に応じて，実行方法などが異なります。詳細は，「付録K.2(1)(f)　サンプルプログラムのクライアントの種類」を参照してください。

(c)　サンプルプログラムで使用するデータベースの設定

ここでは，サンプルプログラムで使用するデータベースの設定について説明します。

表K-2の「データベース」列に「○」が付いているサンプルプログラムでは，リソースとしてデータベースを利用します。サンプルプログラムを実行する前に，データベースおよびデータベース接続関連の設定を適切にしてください。

なお，データベースとして利用できるのは，OracleまたはHiRDBです。

必要な設定を次に示します。

HiRDBを利用する場合は，HiRDB Version 7 07-01以降を利用してください。また，外部キーの指定（参照制約）を有効に設定してください。
設定方法については，マニュアル「HiRDB　システム導入・設計ガイド」を参照してください。

利用するデータベース種別に従って，サンプルが提供する「createTable_Oracle.sql」（Oracleの場合）または「createTable_HiRDB.sql」（HiRDBの場合）を実行して，データベースのテーブルを初期化してください。なお，HiRDBを利用する場合，外部キーの指定（参照制約）が有効になっていないと，「createTable_HiRDB.sql」の実行に失敗します。

サーバ管理コマンドでDB Connectorまたはデータソースの設定をします。どちらを利用するかは，J2EEサーバの動作モードによって異なります。
J2EEサーバの動作モードが1.4モードの場合，DB Connectorを利用します。このとき，「DBConnector_DABJ_CP.rar」を利用することをお勧めします。「DBConnector_DABJ_XA.rar」を利用した場合は，ライトトランザクション機能が無効になるように設定してからJ2EEサーバを起動して，DB Connectorを設定します。ライトトランザクション機能は，usrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーにtrueを指定すると無効になります。
なお，J2EEサーバの動作モードがベーシックモードの場合は，データソースを利用してください。

必要に応じてリソースのリンクを解決します。DB Connectorとして「DBConnector_DABJ_XA.rar」を利用する場合，またはデータソースを利用する場合は，リンクの解決が必要です。なお，DB Connectorとして「DBConnector_DABJ_CP.rar」を利用する場合は，DB Connectorのデフォルトの表示名を変更したときだけリンクの解決が必要です。
リンクの解決には，サンプルで提供するアプリケーションの属性ファイル「config.xml」を利用します。「config.xml」の<resource-ref>タグにリソースの表示名を指定して，サーバ管理コマンドを利用して設定してください。サーバ管理コマンドの利用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

サンプルプログラムのうち，「product」と「cmp20product」では，「config.xml」の<schema-name>に「user1」が設定されています。利用するデータベース環境に応じて，適切な値に変更してからアプリケーションのデプロイ操作を実行してください。

サンプルプログラムのうち，「teller」の実行にHiRDBを使用する場合，TellerEJB.javaファイル中の日付指定関数を指定している個所を，HiRDB用に書き換えてコンパイルしてください。

(d)　サンプルプログラムで使用するメールの設定

ここでは，サンプルプログラムで使用するメールの設定について説明します。

表K-2の「メール」列に「○」が付いているサンプルプログラムでは，リソースとしてメールを利用します。サンプルプログラムを実行する前に，メールサーバへの接続関連の設定を適切にしてください。

必要な設定を次に示します。

EJBクライアントアプリケーションのソースファイル（ConfirmerClient.java）に，受信メールアドレスがコーディングされています。この個所を適切な受信メールアドレスに書き換えてからコンパイルしてください。

サーバ管理コマンドでメールコンフィグレーションを設定する必要があります。サーバ管理コマンドについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リソースのリンクを解決します。ただし，メールコンフィグレーションの表示名を「Cosminexus_SMTP_Server」と定義した場合は，リンクの解決は不要です。これ以外の表示名を定義した場合は，リンクを解決してください。
リンクの解決には，サンプルで提供するアプリケーションの属性ファイル「config.xml」を利用します。「config.xml」の<resource-ref>タグにリソースの表示名を指定して，サーバ管理コマンドで設定してください。サーバ管理コマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

(e)　サンプルプログラムで使用するJMSの設定

ここでは，サンプルプログラムで使用するJMSの設定について説明します。

表K-2の「JMS」列に「○」が付いているサンプルプログラムでは，リソースとしてJMSを利用します。サンプルプログラムを実行する前に，JMSへの接続関連の設定を適切にしてください。

必要な設定を次に示します。

JMSとしてTP1/Message Queue - Accessを使用するため，あらかじめTP1/Message Queue - Accessをインストールしておきます。また，OpenTP1および TP1/Message Queueのサーバ実行環境もあらかじめ準備しておきます。

サーバ管理コマンドによって，TP1/Message Queue - Accessの設定をします。
ライトトランザクション機能を無効にしてJ2EEサーバを起動してから，TP1/Message Queue - Accessの設定をします。なお，ライトトランザクション機能は，usrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーにtrueを指定すると無効になります。
また，TP1/Message Queue - Accessのトランザクションサポートレベルを，「XATransaction」にしてください。

リソースのリンクを解決します。ただし，TP1/Message Queue - Accessのデフォルトの表示名を変更しないで，かつ，キュー定義ファイルに表示名が「QUEUE1」となるキューを定義している場合，リンクの解決は不要です。TP1/Message Queue - Accessのデフォルトの表示名を変更した場合や，キュー定義ファイルに表示名が「QUEUE1」となるキューを定義していない場合は，リンクの解決が必要です。
リンクの解決には，サンプルで提供するアプリケーションの属性ファイル「config.xml」を利用します。「config.xml」の<resource-ref>タグ，<resource-env-ref>タグ，および<message-ref>タグにリソースの表示名を指定して，サーバ管理コマンドで設定してください。サーバ管理コマンドの利用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

(f)　サンプルプログラムのクライアントの種類

サンプルプログラムのクライアントには，EJBクライアントアプリケーションと，Webブラウザで表示するアプリケーションの2種類があります。

表K-2の「EJBクライアントアプリケーション」列に「○」が付いているサンプルプログラムは，EJBクライアントアプリケーションです。サンプルとして提供されている「testClient.bat」を使用して，クライアントアプリケーションを開始してください。

表K-2の「Webブラウザ」列に「○」が付いているサンプルプログラムは，Webブラウザから操作するWebアプリケーションです。クライアントから操作する場合は，Webブラウザを起動して，次のURLを指定してください。

http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>

例えば，ローカルホストで動作するサンプル「adder」の場合は，次のように指定します。

http://localhost/adder/adder_war/adder.html

(2)　Enterprise Bean（EJB2.0）のサンプル実行手順

converterを例に，サンプルの実行例を示します。converterは，クライアントのJavaアプリケーションからEnterprise Beanを呼び出すプログラムです。データベースなどのリソースは利用しません。リソースを利用する場合は，ここで示す手順に加え，リソースにアクセスできる環境を整える必要があります。リソースの設定方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(a)　converterの概要

通貨の種類をドルから円，円からユーロに変換します。converterの構成を次に示します。

図K-1　converterの構成

(b)　コンパイル

サンプルで提供するバッチファイル（compileBean.batおよびcompileClient.bat）を使用して，Enterprise Beanとクライアントをコンパイルします。このバッチファイルで，アプリケーション（.earファイル）が作成されます。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥converter
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>compileBean
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>compileClient
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>

(c)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(f)　アプリケーションのデプロイ

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションをデプロイします。このバッチファイルでは，アプリケーションのJ2EEサーバへのインポートから，アプリケーションの設定，開始，EJBのスタブおよびインタフェースファイルの取得までが実行されます。

このバッチファイルで実行される処理の内容を示します。

アプリケーションのインポート，設定，開始，一覧表示
実行内容については，「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

Enterprise Beanのスタブ・インタフェースファイルの取得
cjgetsubsjarコマンドで，Enterprise Beanのスタブとインタフェースを取得します。

(g)　アプリケーションの実行

サンプルで提供するバッチファイル（testClient.bat）を使用して，アプリケーションを実行します。実行後，EJBクライアントアプリケーションの起動コンソール画面に次のように表示されれば成功です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥converter, PID = 3684)
12160.0
0.77
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter>

(h)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

(3)　Enterprise Bean（EJB2.0）のサンプルの概要

Enterprise Bean（2.0）のサンプルの概要，構成，実行例を示します。なお，必要な設定については，「付録K.2(1)(b)　サンプルプログラムの一覧（接続するリソース，クライアントの種類，動作モード）」を参照してください。

(a)　accountの概要

預金や払い戻しに応じて残高を計算し，銀行口座テーブルを更新します。accountの構成を次に示します。

図K-2　accountの構成

accountの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥account>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥account, PID = 3684)
balance = 68.25
balance = 32.55
456: 44.77
730: 19.54
268: 100.07
456: 44.77
836: 32.55
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥account>

(b)　adderの概要

ブラウザから入力された数値の合計を計算します。adderの構成を次に示します。

図K-3　adderの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/adder.html

インプロセスHTTPサーバが使用できる場合，デフォルトでは次のURLを指定します。

http://localhost/adder/adder_war/adder.html

adderの実行例を示します。

図K-4　adderの実行例

(c)　bankの概要

当座預金口座から普通預金口座に資金を移動します。資金はデータベースで管理し，資金移動時に，対応する当座預金口座テーブルと普通預金口座テーブルを更新します。bankの構成を次に示します。

図K-5　bankの構成

bankの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥bank>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥bank, PID = 3684)
checking: 60.0
saving: 540.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥bank>

(d)　cartの概要

本を購入するショッピングカートです。3冊の本をカートに入れ，カートにない本1冊をカートから出そうとして「BookException」を発生させます。cartの構成を次に示します。

図K-6　cartの構成

cartの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cart>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥cart, PID = 3684)
The Martian Chronicles
2001 A Space Odyssey
The Left Hand of Darkness
Caught a BookException： Alice in Wonderland not in cart.
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cart>

(e)　checkerの概要

割引対象となる金額を超えた場合，割引率を基に割引後の金額を計算します。割引対象となる金額と割引率は，Enterprise Beanの環境エントリで指定します。checkerの構成を次に示します。

図K-7　checkerの構成

checkerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥checker>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥checker, PID = 3684)
discount = 4200.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥checker>

(f)　cmp20productの概要

商品情報をデータベースに登録し，登録された商品情報を検索します。このサンプルは，CMP 2.0形式のEnterprise Beanを利用します。cmp20productの構成を次に示します。

図K-8　cmp20productの構成

cmp20productの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cmp20product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥cmp20product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cmp20product>

(g)　confirmerの概要

商品の注文に対する確認メールを送信します。confirmerの構成を次に示します。

図K-9　confirmerの構成

confirmerのクライアント（メール送信側）の実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥confirmer>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥confirmer, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥confirmer>

クライアント実行後，ConfirmerClient.javaで指定したアドレスにメールが送信されます。受信されるメールの例を示します。

件名:"Test Message from ConfirmerEJB"
文面:
Thank you for your order.
We received your order on 2002/03/18 12:35.

(h)　converterの概要

converterについては，「付録K.2(2)　Enterprise Bean（EJB2.0）のサンプル実行手順」を参照してください。

(i)　enrollerの概要

学生と科目の追加，および受講登録をして，対応する学生情報テーブル，科目テーブル，受講登録情報テーブルを更新します。enrollerの構成を次に示します。

図K-10　enrollerの構成

enrollerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥enroller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥enroller, PID = 3684)
Denise Smith:
220 Power J2EE Programming
333 XML Made Easy
777 An Introduction to Java Programming

An Introduction to Java Programming:
823 Denise Smith
456 Joe Smith
388 Elizabeth Willis
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥enroller>

(j)　jsptagの概要

通貨の種類をドルから円，円からユーロに変換します。変換した結果は，JSPを利用して，ブラウザに表示します。jsptagの構成を次に示します。

図K-11　jsptagの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/Converter.jsp

インプロセスHTTPサーバが使用できる場合，デフォルトでは次のURLを指定します。

http://localhost/jsptag/converter_war/Converter.jsp

jsptagの実行例を示します。

図K-12　jsptagの実行例

(k)　jsptobeanの概要

預金や払い戻しに応じて残高を計算し，データベースを更新します。残高は，JSPを利用してブラウザ上に表示します。jsptobeanの構成を次に示します。

図K-13　jsptobeanの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/Account.jsp

インプロセスHTTPサーバが使用できる場合，デフォルトでは次のURLを指定します。

http://localhost/jsptobean/account_war/Account.jsp

jsptobeanの実行例を示します。

図K-14　jsptobeanの実行例

(l)　localadderの概要

入力数値の合計を計算して，ブラウザ上に表示します。このサンプルは，サーブレットからローカルインタフェースを利用してEnterprise Beanを呼び出します。localadderの構成を次に示します。

図K-15　localadderの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/adder.html

インプロセスHTTPサーバが使用できる場合，デフォルトでは次のURLを指定します。

http://localhost/localadder/localadder_war/adder.html

localadderの実行例を示します。

図K-16　localadderの実行例

(m)　messageの概要

Session BeanからJMSのQueueへ送信したメッセージを，Message-driven Beanで受信します。messageの構成を次に示します。

図K-17　messageの構成

messageのクライアントの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥message>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥message, PID = 3684)
sending message=MY MESSAGE
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥message>

クライアント実行後，メッセージの送受信が正常に完了した場合は，J2EEサーバの起動コンソール上に次のように表示されます。

...
MessageBean: onMessage（）
MessageBean: received message=MY MESSAGE
...

(n)　orderの概要

注文番号と対応する商品情報を検索して表示します。注文番号と商品情報は，それぞれ注文情報テーブルと商品情報テーブルで管理します。orderの構成を次に示します。

図K-18　orderの構成

orderの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥order>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥order, PID = 3684)
about to create
123 1 p23 12.0
123 2 p67 89.0
123 3 p11 41.0

123
456
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥order>

(o)　productの概要

商品名や価格などの商品情報をデータベースに登録し，登録された商品情報を検索します。商品情報は，商品情報テーブルで管理します。productの構成を次に示します。

図K-19　productの構成

productの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥product>

(p)　salesrepの概要

顧客の追加と，担当する販売員の変更を行い，データベースを更新します。二つのEnterprise Beanを連携し，顧客テーブルと販売員テーブルへの検索と更新を行います。salesrepの構成を次に示します。

図K-20　salesrepの構成

salesrepの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥salesrep>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥salesrep, PID = 3684)
customerId = 221
customerId = 388
customerId = 456
customerId = 844

987: Mary Jackson
221: Alice Smith
388: Bill Williamson
456: Joe Smith
844: Buzz Murphy
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥salesrep>

(q)　shipperの概要

注文に対する商品在庫を計算し，データベースを更新します。在庫が一定の数量を下回った場合，引き当て処理を呼び出します。二つのEnterprise Beanを連携し，商品在庫情報テーブルへの検索と更新を行います。shipperの構成を次に示します。

図K-21　shipperの構成

shipperの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥shipper>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥shipper, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥shipper>

shipperの実行後，J2EEサーバの起動コンソール上に次のように表示されます。

...
ShipperEJB： ejbCreate()
ShipperEJB： shipItem()
StockEJB： updateOnHand()
StockEJB： reorderNeeded()
...

(r)　storagebinの概要

データベースから部品の情報と在庫を検索します。二つのEnterprise Beanを連携し,部品情報テーブルと部品在庫情報テーブルへの検索を行います。storagebinの構成を次に示します。

図K-22　storagebinの構成

storagebinの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥storagebin>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥storagebin, PID = 3684)
777 388 500 1.0 Duct Tape
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥storagebin>

(s)　tellerの概要

銀行用端末機から当座預金を引き出し，残高を計算します。データベースの（銀行用端末機の）入金情報テーブルと取引履歴情報テーブルに対し，取引内容を追加します。

tellerの構成を次に示します。

図K-23　tellerの構成

tellerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥teller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥teller, PID = 3684)
checking = 500.0
checking = 440.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥teller>

(t)　warehouseの概要

注文を受けた商品の状態，および商品の在庫を更新します。データベースの商品情報テーブルと在庫情報テーブルのそれぞれを更新します。warehouseの構成を次に示します。

図K-24　warehouseの構成

warehouseの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥warehouse>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥warehouse, PID = 3684)
status = shipped
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥warehouse>

付録K.3　Enterprise Bean（アノテーション）のサンプルプログラム

アノテーションに対応したEnterprise Beanのサンプルプログラムは，次の3種類を提供します。

アノテーション対応のEnterprise Bean（データベース接続なし）
格納場所は<Cosminexusのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥statelessです。

アノテーション対応のEnterprise Bean（データベース接続あり）
格納場所は<Cosminexusのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥statefulです。

Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Bean
格納場所は<Cosminexusのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥homeです。

サンプルプログラムの概要と，実行手順を示します。

＜この項の構成＞

(1)　アノテーション対応のEnterprise Bean（データベース接続なし）の概要

(2)　アノテーション対応のEnterprise Bean（データベース接続あり）の概要

(3)　Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Beanの概要

(4)　Enterprise Bean（アノテーション）のサンプルプログラムの実行手順

(1)　アノテーション対応のEnterprise Bean（データベース接続なし）の概要

データベースに接続しない場合のアノテーション対応のEnterprise Beanサンプルプログラム「annotation_stateless」の構成を次に示します。

図K-25　annotation_statelessの構成（アノテーション対応・データベース接続なし）

Webブラウザ経由でサーブレットにアクセスし，実行結果をブラウザ上に表示します。このサンプルプログラムでは，サーブレットからビジネスインタフェースを使用したEnterprise Beanを呼び出します。

アノテーション対応のEnterprise Beanの参照を取得するため，サーブレット側で@EJBアノテーションを使用します。

@EJB(beanName="MyConverter")
Converter converter;

実行例を次に示します。

図K-26　アノテーション対応Enterprise Beanのサンプルプログラム（データベース接続なし）の実行例

(2)　アノテーション対応のEnterprise Bean（データベース接続あり）の概要

データベースに接続する場合のアノテーション対応のEnterprise Beanサンプルプログラム「annotation_stateful」の構成を次に示します。

図K-27　annotation_statefulの構成（アノテーション対応・データベース接続あり）

このサンプルプログラムでは，アノテーションを使用してデータベースに接続します。アノテーション対応のEnterprise Beanで，@Resourceアノテーションを使用してリソースを取得します。

@Resource(mappedName="DB_Connector_for_Cosminexus_Driver")
private DataSource ds;

サーブレット側からビジネスインタフェースを使用したStateful Session Beanをlookupするには，JNDIを使用します。

Context initial = new InitialContext();
duke = (Bank)initial.lookup("java:comp/env/ejb/Bank");

実行例を次に示します。

図K-28　アノテーション対応Enterprise Beanのサンプルプログラム（データベース接続あり）の実行例

ユーザID，金額を入力して処理を実行します。指定できるユーザIDは001だけです。初期残高は10,000円です。

(3)　Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Beanの概要

アノテーション対応のEnterprise Beanにホームインタフェースの定義を追加することで，EJB2.0からアノテーション対応のEnterprise Beanを呼び出せます。この処理を実行するサンプルプログラム「annotation_home」の構成を次に示します。

図K-29　annotation_homeの構成（アノテーション対応・EJB2.0からの接続）

このサンプルプログラムでは，EJB2.0のEnterprise Beanからローカルホームインタフェースが使用されているアノテーション対応のEnterprise Beanを呼び出します。EJB2.0のEnterprise Beanのコードでは，ローカルホームインタフェースをlookupします。

...
Context ctx = new InitialContext();
Converter2LocalHome home = (Converter2LocalHome)ctx.lookup("java:comp/env/ejb/Converter2");
...

アノテーション対応のEnterprise Beanのローカルホームインタフェースは，Enterprise Beanに@LocalHomeアノテーションを指定します。

@Stateless(name="MyConverter2")
@LocalHome(value=Converter2LocalHome.class)
public class Converter2EJB {
...
}

(4)　Enterprise Bean（アノテーション）のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイルを使用して，サンプルプログラムをコンパイルします。

アノテーション対応のEnterprise Bean（データベース接続あり／なし）のサンプルプログラムは，「compile.bat」を実行します。

EJB2.0のEnterprise Beanからアノテーション対応のEnterprise Beanへ接続するサンプルは，「compileBean.bat」および「compileClient.bat」を実行します。

(b)　SQLの実行（アノテーション対応のEnterprise Bean（データベース接続ありの場合））

データベースに接続するサンプルプログラムの場合は，あらかじめSQLを実行してください。SQL文はサンプルで提供しています（createTable_Oracle.sql，createTable_HiRDB.sql）。

(c)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(f)　リソースアダプタの設定（アノテーション対応のEnterprise Bean（データベース接続ありの場合））

データベースに接続するサンプルプログラムの場合は，リソースアダプタの設定が必要です。「付録K.1(4)　リソースアダプタの設定」を参照してください。

(g)　アプリケーションのデプロイ

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションをデプロイします。このバッチファイルは，アプリケーションのインポート，開始，一覧表示，およびEnterprise Beanのスタブ・インタフェースの取得をします。

このバッチファイルで実行される処理の内容を示します。

アプリケーションのインポート，開始，一覧表示
実行内容については，「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

Enterprise Beanのスタブ・インタフェースファイルの取得
cjgetsubsjarコマンドで，Enterprise Beanのスタブとインタフェースを取得します。

(h)　アプリケーションの実行

アプリケーションごとに実行方法を示します。

アノテーション対応のEnterprise Bean（データベース接続なし）の場合
ブラウザを起動し，URLに次の文字列を指定します。
http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>
インプロセスHTTPサーバが使用できる場合，デフォルトでは，次のURLを指定します。
http://localhost/annotation_stateless/servlet/ConverterServlet

アノテーション対応のEnterprise Bean（データベース接続あり）の場合
ブラウザを起動し，URLに次の文字列を指定します。
http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>
インプロセスHTTPサーバが使用できる場合，デフォルトでは，次のURLを指定します。
http://localhost/annotation_stateful/bank.html

Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Beanの場合
サンプルで提供するバッチファイル（testClient.bat）を使用してEJBクライアントアプリケーションを実行します。実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥annotation¥home>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥annotation¥home, PID = 3684)
93.632
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

(i)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(j)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

付録K.4　Enterprise Bean（Timer Service）のサンプルプログラム

Timer Serviceを実装するサンプルプログラムは，次のディレクトリに格納されます。

<Cosminexusのインストールディレクトリ>¥CC¥examples¥ejb¥timerservice

サンプルの概要と実行手順を示します。

＜この項の構成＞

(1)　Enterprise Bean（Timer Service）のサンプルプログラムの概要

(2)　Enterprise Bean（Timer Service）のサンプルプログラムの実行手順

(1)　Enterprise Bean（Timer Service）のサンプルプログラムの概要

Timer Serviceのサンプルプログラム「TimerService」の構成を次に示します。

図K-30　TimerServiceの構成

このサンプルプログラムでは，Webブラウザ経由でEJBタイマの生成，一覧表示，キャンセルができます。EJBタイマがタイムアウトすると，ユーザログにメッセージを出力します。

実行例を次に示します。

図K-31　TimerServiceのサンプルプログラムの実行例

サンプルでは，次の機能を提供します。

EJBタイマの生成
アプリケーションの開始時に，EJBタイマが一つ生成されます。サーブレットに対してDDに<load-on-startup>タグを指定し，サーブレットのinitメソッドでEJBタイマを生成するStateless Session Beanのメソッドを呼び出します。
また，WebページEJBタイマ種別とタイムアウト時間と文字列情報を指定して［Create］ボタンをクリックすると，EJBタイマが生成されます。

EJBタイマ一覧の表示
WebページにEJBタイマの一覧が表示されます。［Refresh］ボタンをクリックすると，最新のEJBタイマ一覧が表示されます。

EJBタイマのキャンセル
Webページの［Cancel］ボタンをクリックすると，該当するEJBタイマがキャンセルされます。

ユーザログへの出力
EJBタイマがタイムアウト日時になると，タイムアウトメソッドが呼び出されユーザログにメッセージが出力されます。出力例を下記に示します。

The timeout method was invoked. (Information = MyTimer02)

(2)　Enterprise Bean（Timer Service）のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，EJB-JARファイル（timerservice.jar）とWARファイル（timerservice.war）とEARファイル（timerservice.ear）が作成されます。

(b)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(e)　アプリケーションのデプロイ

「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/TimerServiceServlet

インプロセスHTTPサーバが使用できる場合，デフォルトでは，次のURLを指定します。

http://localhost/timerservice/TimerServiceServlet

(g)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(h)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

付録K.5　JavaBeansリソースのサンプルプログラム

JavaBeansリソースを使用するサンプルプログラムは，次のディレクトリに格納されます。

<Cosminexusのインストールディレクトリ>¥CC¥examples¥javabeans

サンプルの概要と実行手順を説明します。

＜この項の構成＞

(1)　JavaBeansリソースのサンプルプログラムの概要

(2)　JavaBeansリソースのサンプルプログラムの実行手順

(1)　JavaBeansリソースのサンプルプログラムの概要

JavaBeansリソースのサンプルプログラムの構成を次に示します。

図K-32　JavaBeansリソースのサンプルプログラムの構成

このサンプルプログラムは，JavaBeansリソース属性ファイルのプロパティに指定された各設定情報に基づき，ブラウザにその値を表示します。

実行例を次に示します。

図K-33　JavaBeansリソースのサンプルプログラムの実行例

(2)　JavaBeansリソースのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，JavaBeansリソース（MyJavaBean.jar）とEARファイル（LookupBean.ear）が作成されます。

(b)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(e)　JavaBeansリソースのインポート，開始

サンプルで提供するバッチファイル（deployJb.bat）を使用して，JavaBeansリソースをデプロイします。このバッチファイルでは，JavaBeansリソースのインポート，開始が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjimportjbコマンドが実行され，JavaBeansリソースがJ2EEサーバにインポートされます。使用されるJavaBeansリソース属性ファイルは「jb_resource.xml」です。

cjstartjbコマンドが実行され，JavaBeansリソースが開始されます。使用されるJavaBeansリソース表示名は「JavaBean_resource」です。

cjlistjbコマンドが実行され，J2EEサーバ上のJavaBeansリソースの状態が一覧表示されます。この一覧を確認することで，JavaBeansリソースが稼働状態（running）になっていることを確認できます。

(f)　アプリケーションのデプロイ

「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(g)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/servlet/LookupBeanServlet

インプロセスHTTPサーバが使用できる場合，デフォルトでは，次のURLを指定します。

http://localhost/web_jb/servlet/LookupBeanServlet

(h)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　JavaBeansリソースの停止

cjstopjbコマンドでJavaBeansリソースを停止します。

C:¥>cd Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjstopjb MyServer -resname JavaBean_resource

(j)　J2EEサーバの再起動

cjstopsvコマンドでJ2EEサーバを終了し，cjstartsvコマンドでJ2EEサーバを起動します。J2EEサーバの終了方法については，「付録K.1(7)　J2EEサーバの終了」を参照してください。J2EEサーバの起動方法については，「付録K.1(3)　J2EEサーバの起動」を参照してください。

(k)　JavaBeansリソースの削除

cjdeletejbコマンドでJavaBeansリソースを削除します。

C:¥>cd Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjdeletejb MyServer -resname JavaBean_resource

(l)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

付録K.6　ユーザログ機能のサンプルプログラム

ユーザログ機能の動作確認用のサンプルプログラムとして，userlogが提供されています。また，このサンプルプログラムを実行するためのソースファイルと定義ファイルのサンプルとして次の表に示すファイルが提供されています。

表K-3　ユーザログ機能の動作確認用のサンプルプログラム

ファイル名 | 用途
UserLogServlet.java | ユーザログのサーブレットプログラムです。
UserLogHome.java | ホームインタフェースです。
UserLog.java | リモートインタフェースです。
AdderEJB.java | 整数の合計を計算するEnterprise Beanの実装クラスです。
sample.properties | プロパティにセットするロガーのサンプルプロパティです。
MyFormatter.java | フォーマッタとして提供される独自クラスです。
MyFilter.java | フィルタとして提供される独自クラスです。

これらのファイルは，次の場所にあります。

<Cosminexusのインストールディレクトリ>¥CC¥examples¥userlog

ユーザログ機能のサンプルプログラムの概要と実行手順を説明します。

＜この項の構成＞

(1)　ユーザログ機能のサンプルプログラムの概要

(2)　ユーザログ機能のサンプルプログラムの実行手順

(1)　ユーザログ機能のサンプルプログラムの概要

このサンプルプログラムでは，三つのタイプのログ出力を実行できます。

タイプ1：Sample for outputting messages from servlet
入力されたメッセージがサーブレット側から出力されます。

タイプ2：Sample for outputting the entered numbers and total value from AdderEJB
入力された整数の合計を計算する「AdderEJB（Enterprise Bean）」から，入力した値とその値を足した合計値がログファイルに出力されます。

タイプ3：Sample for outputting exception logs from the servlet
Exceptionが発生し，その内容がサーブレットからログファイルに出力されます。

サンプルプログラムでは，次の図に示す流れで処理が行われます。

図K-34　ユーザログのサンプルプログラムの構造（サーブレット，Enterprise Bean）

［入力］画面で選択するロガー名およびログレベルによって，出力先のログファイルが異なります。

ロガー名「com.example.userlogger1」を選択した場合は，どのレベルを指定してもlogfileAに出力されます。

ロガー名「com.example.userlogger1」を選択して，ログレベルで「SEVERE」以上を指定した場合は，logfileAとlogfileBに出力されます。

ロガー名「com.example.userlogger2」を選択し，ログレベルで「INFO」以上を指定した場合，かつ「MyFilter」によってフィルタリングされなかった場合に，logfileCに出力されます。出力フォーマッタは「MyFormatter（独自クラス）」が使用されます。

MyFormatterの仕様

次の形式で出力します。

message：<入力されたメッセージ>　　　　LEVEL：<指定されたレベル>

MyFilterの仕様

メッセージの頭に「debug:」が付いているものは，ログに出力しません。

(2)　ユーザログ機能のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(b)　サンプルファイルのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，ユーザログサンプルをコンパイルします。

コンパイルすると「myloglib.jar」というファイルが作成されます。これを任意のディレクトリに格納し，JARファイルにパスを通します。パスを通す方法については，マニュアル「Cosminexus　システム構築ガイド」に記載されているコンテナ拡張ライブラリの設定を参照してください。

(c)　プロパティ情報の設定

セットアップしたサーバにプロパティ情報を設定します。セットアップしたサーバのusrconf.propertiesの内容の一部を，サンプルで提供する設定ファイル（sample.properties）に書き換えます。Management Serverを利用してシステムを構築している場合は，マニュアル「Cosminexus　システム構築ガイド」に記載されているJ2EEサーバの動作設定のカスタマイズを参照して設定してください。

セットアップしたサーバを「MyServer」としたときのusrconf.propertiesの格納場所と，usrconf.propertiesファイル内の書き換え位置を次に示します。

ファイルの場所
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥MyServer¥usrconf.properties

ファイルの書き換え位置
次に示す個所を，sample.propertyの内容に書き換えます。

    ：
# user-log handler settings
#ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.path=user_log
#ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.count=2
    ：
# user-log logger settings
#ejbserver.application.userlog.Logger.<Specify logger-name>.handlers=<Specify handler-class>
#ejbserver.application.userlog.Logger.<Specify logger-name>.useParentHandlers=true
    ：

サンプルで提供するsample.propertiesの内容を示します。

# user-log handler settings
#conf1 settings
ejbserver.application.userlog.CJLogHandler.conf1.path=userlog/logFileA
ejbserver.application.userlog.CJLogHandler.conf1.level=ALL
ejbserver.application.userlog.CJLogHandler.conf1.appname=userlog_app
ejbserver.application.userlog.CJLogHandler.conf1.formatter=com.hitachi.software.ejb.application.userlog.CJSimpleFormatter

#conf2 settings
ejbserver.application.userlog.CJLogHandler.conf2.path=userlog/logFileB
ejbserver.application.userlog.CJLogHandler.conf2.level=SEVERE
ejbserver.application.userlog.CJLogHandler.conf2.appname=userlog_app

#conf3 settings
ejbserver.application.userlog.CJLogHandler.conf3.path=userlog/logFileC
ejbserver.application.userlog.CJLogHandler.conf3.level=INFO
ejbserver.application.userlog.CJLogHandler.conf3.appname=userlog_app

# user-log logger settings
#logger1 settings
ejbserver.application.userlog.Logger.com.example.userlogger1.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf1,com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf2
ejbserver.application.userlog.Logger.com.example.userlogger1.level=ALL

#logger2 settings
ejbserver.application.userlog.Logger.com.example.userlogger2.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf3
ejbserver.application.userlog.Logger.com.example.userlogger2.level=INFO

ejbserver.application.userlog.loggers=com.example.userlogger1, com.example.userlogger2

インプロセスHTTPサーバの設定については，「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(e)　アプリケーションのデプロイ

「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>：<ポート番号>/<ContextRoot>/userlog.html

インプロセスHTTPサーバが使用できる場合，デフォルトでは次のURLを指定します。

http://localhost/userlog/userlog_war/userlog.html

(g)　userlogの実行例

userlogの実行例を示します。アプリケーションを実行して，URLを指定すると，次に示す［実行サンプルタイプの選択］画面が表示されます。

図K-35　［実行サンプルタイプの選択］画面（ユーザログのサンプルプログラム）

実行するサンプルのタイプを選択し，各データ入力フォームへ移ります。この画面以降の操作とログ出力例については，選択したタイプごとに説明します。

出力結果のログファイルは，セットアップしたサーバ名を「MyServer」とした場合，usrconf.propertiesに設定したファイル名で，次に示すディレクトリに出力されます。

<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥MyServer¥logs¥user¥userlog

タイプ1：outputting messageの実行例
［実行サンプルタイプの選択］画面で「Sample for outputting message from the servlet」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。
タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger1

メッセージ：AAA

メッセージレベル：SEVERE（致命的）

次に，タイプ1を選択した場合の［入力］画面を示します。

図K-36　［入力］画面（タイプ1：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図K-37　［入力結果表示］画面（タイプ1：ユーザログのサンプルプログラム）

この例では，logfileAとlogfileBに出力されます。
logfileAの出力結果を示します。

0310 2005/01/21 20:37:53.296     userlog_app      00922804 01000BCF Msg_100               2005/01/21 20:37:53|UserLogServlet|doPost|致命的|AAA

logfileBの出力結果を示します。

0888 2005/01/21 19:41:03.609     userlog_app      00922804 009B6220 Msg_100               AAA

タイプ2：outputting the entered numbers and total valueの実行例
［実行サンプルタイプの選択］画面で「Sample for outputting the entered numbers and total value from AdderEJB」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。
タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger1

入力数：10

次に，タイプ2を選択した場合の［入力］画面を示します。

図K-38　［入力］画面（タイプ2：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図K-39　［入力結果表示］画面（タイプ2：ユーザログのサンプルプログラム）

この例では，logfileAだけに出力されます。
logfileAの出力結果を示します。

0324 2005/01/21 20:38:59.500     userlog_app      00922804 015C998A Adder_200             2005/01/21 20:38:59|AdderEJB|add|情報|inputNumber = 10
0327 2005/01/21 20:38:59.500     userlog_app      00922804 015C998A Adder_201             2005/01/21 20:38:59|AdderEJB|getTotal|情報|total = 10

タイプ3：outputting exception logsの実行例
［実行サンプルタイプの選択］画面で「Sample for outputting exception logs from the servlet」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。
タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger2

次に，タイプ3を選択した場合の［入力］画面を示します。

図K-40　［入力］画面（タイプ3：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図K-41　［入力結果表示］画面（タイプ3：ユーザログのサンプルプログラム）

この例では，logfileCだけに出力されます。
logfileCの出力結果を示します。

1077 2005/01/21 19:55:19.328     userlog_app      00922804 006458A6 Exp_300               message:Exception     LEVEL:SEVERE

(h)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

付録K.7　Webアプリケーションのサンプルプログラム

Webアプリケーションのサンプルプログラムは，次のディレクトリに格納されます。

<Cosminexusのインストールディレクトリ>¥CC¥examples¥webapps

サンプルプログラムの概要と実行手順を示します。

＜この項の構成＞

(1)　Webアプリケーションのサンプルプログラムの概要

(2)　Webアプリケーションのサンプルプログラムの実行手順

(1)　Webアプリケーションのサンプルプログラムの概要

Webアプリケーションのサンプルとして，Servlet 2.4仕様に準じたサーブレットおよびJSPのサンプルプログラムを利用できます。ここでは，前提事項，サンプルプログラムの種類，およびサンプルプログラムの構成について説明します。

(a)　前提事項

Webアプリケーションのサンプルプログラムの前提事項を次に示します。

Webアプリケーションのバージョンは，Servlet 2.4であること。

J2EEサーバモードで実行すること。

また，Webアプリケーションのサンプルプログラムでは，JSTL 1.1を使用します。JSTL 1.1はサンプルに含まれないため，別途用意する必要があります。

(b)　サンプルプログラムの種類

提供するサンプルプログラムの種類を次に示します。

サーブレット

「Hello World」の表示

HTTPリクエスト情報の表示

HTTPヘッダの表示

HTTPリクエストのパラメタ表示

Cookie操作

HTTPセッションの操作

JSP

Expression Language※1

シンプルタグハンドラ，JSPフラグメント

タグファイル※1

XMLシンタックスのJSP※1※2

その他JSP2.0仕様の機能

JSP1.2仕様の機能

注※1

JSTLを使用するサンプルプログラムです。JSTLをインストールしていない場合，JSPのコンパイルで失敗し，JSPを実行できません。

注※2

このサンプルでは，実行結果としてSVG形式のデータを返します。SVG形式のデータをブラウザで表示するには，SVGに対応したブラウザが必要です。

(c)　サンプルプログラムの構成

Webアプリケーションのサンプルプログラムは，展開ディレクトリ形式のアプリケーションとしてそのまま使用できます。次に，<Cosminexusのインストールディレクトリ>¥CC¥examples¥webapps以下のを示します。

図K-42　webappsディレクトリ以下の構成

以降に説明するWebアプリケーションのサンプルプログラムの実行手順では，<Cosminexusのインストールディレクトリ>¥CC¥examplesの下にあるwebappディレクトリを，<webappsディレクトリ>と表記します。

(2)　Webアプリケーションのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。この手順では，次の機能を使用します。

展開ディレクトリ形式のデプロイ

JSPの事前コンパイル

(a)　JSTL1.1のインストール

JSTL 1.1で提供されるjstl.jarおよびstandard.jarを次のディレクトリ以下に配置します。

<webappsディレクトリ>¥app¥webapp-examples¥WEB-INF¥lib

(b)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，Webアプリケーションのサーブレット，フィルタ，リスナ，JavaBeansのJavaソースファイル，およびJSPファイルをコンパイルします。

なお，サーブレットやフィルタなどJavaソースファイルはjavacコマンドが使用され，JSPファイルのコンパイルには，cjjspcコマンドが使用されます。

(c)　J2EEサーバのセットアップ

「付録K.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録K.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録K.1(3)　J2EEサーバの起動」を参照してください。

(f)　ユーザ，ロールの登録

サンプルで提供するバッチファイル（setupUsers.bat）を使用して，ユーザおよびロールを登録します。このバッチファイルでは，J2EEサーバ名「MyServer」のJ2EEサーバに対し，ユーザの登録とロールの登録の処理が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjaddsecコマンドが実行され，次のユーザが登録されます。
ユーザ１：ユーザ名「user1」，パスワード「passwd1」
ユーザ２：ユーザ名「user2」，パスワード「passwd2」

cjaddsecコマンドが実行され，ロール「role1」とロール「role2」が登録されます。

cjmapsecコマンドが実行され，次のマッピングが登録されます。
マッピング１：ロール「role1」とユーザ「user1」
マッピング２：ロール「role2」とユーザ「user2」

ここで登録したユーザ名とパスワードは，JSPのサンプルページの「Security」で使用します。

(g)　アプリケーションのデプロイ

「付録K.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(h)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定してWebアプリケーションのトップページにアクセスします。

http://<マシン名>/examples

ポート番号をカスタマイズしている場合は，<マシン名>のあとに，「:<ポート番号>」を指定してください。

J2EEサーバを起動したホストからアクセスする場合は，次のように指定します。

http://localhost/examples

アクセスに成功すると，次のようなトップ画面が表示されます。

図K-43　Webアプリケーションのサンプルプログラムの実行例

(i)　アプリケーションのアンデプロイ

「付録K.1(6)　アプリケーションの停止，削除」を参照してください。

(j)　J2EEサーバの終了

「付録K.1(7)　J2EEサーバの終了」を参照してください。

付録L　用語解説

Application Server，uCosminexus Client，Web Redirector，およびuCosminexus Operatorで使用する用語について説明します。

（数字）

1.4モード

サーバの動作モードです。J2EE 1.4の機能を使用できます。データベースを含む複数のリソースのトランザクション管理ができます。

1:1系切り替えシステム

実行系のアプリケーションサーバと待機系のアプリケーションサーバが1:1で対応しているシステムです。実行系のアプリケーションサーバに障害が発生すると，待機系のアプリケーションサーバで処理を引き継ぎます。

（英字）

Application Server

Cosminexusの実行環境を構築する基盤製品です。Application Server Standardと，Application Server Enterpriseの総称です。

BJEX

uCosminexus Batch Job Execution Serverのことです。

BMP（Bean-Managed Persistence）

Enterprise Beanのビジネスメソッド内でデータの永続化を管理するモデルです。

BMT（Bean-Managed Transaction）

Enterprise Beanでトランザクションを管理するモデルです。Session BeanおよびMessage-driven Beanが対象になります。Entity Beanは対象外です。

CMP（Container-Managed Persistence）

EJBコンテナがデータの永続化を管理するモデルです。

CMT（Container-Managed Transaction）

EJBコンテナがトランザクションを管理するモデルです。Session Bean，Entity BeanおよびMessage-driven Beanが対象になります。

Component Container管理者

スーパーユーザ以外の，J2EEサーバやバッチサーバのセットアップ，J2EEサーバやバッチサーバの起動・停止などを実施できるユーザを指します。Component Container管理者はUNIXの場合に設定できます。

Cookieスイッチング機能

負荷分散機で提供しているサーバスイッチング機能の一つです。Cookieスイッチング機能を使用すると，クライアントからのリクエストパケット内のCookie情報に基づいて，同じサーバにセッションをリダイレクトします。

CORBAネーミングサービス

CORBAの仕様に準拠した，リモートオブジェクトの格納場所を管理するためのネーミングサービスです。Application Serverの構成ソフトウェアであるCosminexus TPBrokerによって提供される機能です。

Cosminexus

アプリケーションサーバを中核とした，性能および信頼性の高いアプリケーションを実行および開発するためのシステム構築基盤製品です。

Cosminexus Component Container

サーバ・サイドの業務処理プログラム（ビジネスロジック）をコンポーネントとして実行するための構成ソフトウェアです。また，Cosminexusシステムの運用管理をするためのManagement Server，統合ユーザ管理，snapshotログ収集などの機能も提供しています。

Cosminexus Component Transaction Monitor

クライアントからのリクエストのスケジューリングを実現するための構成ソフトウェアです。

Cosminexus Operator Plug-in

実行環境を運用管理操作するための構成ソフトウェアです。Server Plug-inとHCSC-Managerを提供しています。HCSC-Managerとは，Cosminexusサービスプラットフォームの運用環境で利用する運用管理機能です。なお，HCSC-Managerについては，マニュアル「Cosminexus　サービスプラットフォーム　システム構築・運用ガイド」を参照してください。

Cosminexus Performance Tracer

リクエストが処理されるときに，決められたポイントごとに各機能が出力する性能解析情報をファイルに出力するための構成ソフトウェアです。

Cosminexus Reliable Messaging

Cosminexus システム上のJ2EEアプリケーションがメッセージを使用して非同期に通信するためのミドルウェアです。JMSインタフェースでのメッセージ通信機能をJ2EEアプリケーションに提供します。

Cosminexusシステム

Application Serverを実行基盤として構築されているシステムのことです。

Cosminexus標準ログインモジュール

統合ユーザ管理のユーザ認証処理で使用するログインモジュールです。javax.security.auth.spiに含まれるLoginModuleインタフェースの実装クラスです。

次のログインモジュールがあります。

WebPasswordLoginModule
パスワードを使用してユーザを認証します。

WebCertificateLoginModule
クライアント証明書を使用してユーザを認証します。

WebPasswordLDAPLoginModule
LDAPディレクトリサーバの認証機能を使用してユーザを認証します。

WebPasswordJDBCLoginModule
RDBに格納された情報を使用してユーザを認証します。

DelegationLoginModule
カスタムログインモジュールを呼び出します。

WebSSOLoginModule
シングルサインオンをするときに，ほかのログインモジュールを呼び出します。

CTM

Cosminexus Component Transaction Monitorのことです。リクエストのスケジューリングをするための構成ソフトウェアです。

CTMデーモン

クライアントからのリクエストを制御するスケジュールキューを管理するプロセスです。リクエストのスケジューリングを実現する，スケジューラとして機能します。

Management Serverを利用している場合，CTMデーモンは論理サーバとして扱えます。

CTMドメイン

複数のCTMデーモンで構成される，情報共有と負荷分散の対象になる範囲です。CTMデーモンはCTMドメイン内で，それぞれに登録された業務処理プログラムの情報やスケジュールキューの負荷情報を交換してリクエストを振り分けます。

CTMドメインマネジャ

CTMドメインを管理するプロセスです。ホスト内のCTMデーモンの情報を，CTMドメイン内のほかのCTMドメインマネジャに配布します。

Management Serverを利用している場合，CTMドメインマネジャは論理サーバとして扱えます。

CTMレギュレータ

EJBクライアントからCTMデーモンに集中するリクエストを，分散集約するためのプロセスです。TPBrokerクライアント（CORBAクライアント）からJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能も提供します。

DB Connector

データベースに接続するためのリソースアダプタです。

DD

アプリケーションを運用環境に配置するときの定義情報を記述したものです。EJB用，Webアプリケーション用，Enterpriseアプリケーション用などがSun Microsystems, Inc.からの仕様で規定されています。

Dependency Injection

EJBやインターセプタクラスのフィールドやsetterメソッドに，@EJBや@Resourceアノテーションを指定することで，EJBやリソースへの参照をEJBコンテナが自動的にセットする機能です。Dependency Injectionを使用すると，EJBやリソースへの参照をJNDIを使用してルックアップする必要がなくなります。

DIターゲット

Dependency Injection機能を使用して参照を注入する対象のことです。DIターゲット名と名前が一致するフィールド，またはDIターゲット名をプロパティとして持つsetterメソッドに対して，Dependency Injectionが実行されます。

DTD

XMLで使用するタグの属性や階層構造や出現順序などを定義したものです。

EARファイル

J2EEアプリケーションを構成する複数のEJB-JARファイル，WARファイル，およびDDをEARファイル形式でパッケージ化したものです。

EIS

データベースやトランザクションサーバなど，企業内に構築されているバックエンドシステムです。

EJB（Enterprise JavaBeans）

業務ロジックをプログラムとして記述したビジネスロジック，および永続的データを格納するオブジェクトであるエンティティをJavaコンポーネント化したものです。Sun Microsystems, Inc.からEJB仕様が公開されています。

EJB-JARファイル

Enterprise Bean，DDなどをJARファイル形式に圧縮したものです。

EJBクライアント

J2EEサーバ上で開始されているEnterprise Beanを呼び出すクライアントプログラムです。次の3種類があります。

EJBクライアントアプリケーション

サーブレットまたはJSPなどのWebアプリケーション

ほかのEnterprise Bean

EJBクライアントアプリケーション

Enterprise Beanを呼び出すJavaアプリケーションです。

EJBコンテナ

Enterprise Beanを制御すると同時に，通信，トランザクション管理などのシステムレベルのサービスを提供する実行環境です。Enterprise Beanの実体は，EJBコンテナの中で実行されます。

EJBタイマ

EJBコンテナのTimer Serviceの機能を利用して，タイムアウト時間を管理するタイマです。指定された時刻または間隔で，タイムアウトメソッドをコールバックし，イベントを実行します。

Enterprise Bean

ビジネスロジックをEJBアーキテクチャに従って作成したものです。業務処理プログラムに該当します。

Entity Bean

永続化されたデータそのものを表すBeanです。Entity Beanは，さらにCMP Entity BeanとBMP Entity Beanに分類されます。

HAモニタ

クラスタソフトウェアの一つです。

システムを監視し，障害発生時などにシステムの切り替えを実行するプログラムです。HAモニタと連携することで，Cosminexusシステムの信頼性や稼働率を向上できます。AIX，HP-UXまたはLinuxを使用しているときに連携できます。

HAモニタと連携することで，1：1系切り替えシステム，相互系切り替えシステム，N：1リカバリシステムが実現できます。

Inbound

Connector 1.5仕様で定められたJ2EEサーバとリソースアダプタ間の通信モデルの一つです。リソースアダプタからJ2EEサーバにアクセスする通信モデルです。

J2EE

JavaTM 2 Platform, Enterprise Editionの略です。Sun Microsystems, Inc.からJ2EE仕様が公開されています。

J2EEアプリケーション

JSP，サーブレット，EnterpriseBeanなどで構成されるアプリケーションです。Cosminexusで扱うJ2EEアプリケーションの形式には，EARファイル形式でパッケージ化されたアーカイブ形式のアプリケーションと，アーカイブ化しない展開ディレクトリ形式のアプリケーションがあります。EARファイル形式でパッケージ化されたアプリケーションの場合，複数のEJB-JARファイル，複数のWARファイル，および一つのDDから構成されます。

J2EEアプリケーション実行時間の監視機能

EJBおよびWebアプリケーションのリクエスト実行時間を監視する機能です。実行時間監視中に障害を検知すると，メソッドタイムアウト機能およびメソッドキャンセル機能が動作します。

J2EEアプリケーションの強制停止

J2EEアプリケーションの停止での強制停止とは，J2EEアプリケーションで処理中のリクエストがある場合でも，強制的に処理を中止する方法です。

J2EEアプリケーションの通常停止

J2EEアプリケーションの停止での通常停止とは，WebアプリケーションやEJBの停止処理を順番に実施して，J2EEアプリケーションを安全に停止させる方法です。

J2EEコンテナ

J2EEアプリケーションを実行するためのサーバ基盤です。

J2EEコンポーネントへ各種APIを提供する，Webコンテナ，EJBコンテナから構成されます。

J2EEコンポーネント

サーブレット，JSP，Enterprise Beanなどのユーザアプリケーションプログラムのことです。

J2EEサーバ

J2EEコンテナを生成，実行する環境です。

J2EEサーバモード

J2EEサーバの動作モードの一つです。このモードの場合，J2EEコンテナ上で動作するアプリケーションから，J2EE関連のAPIを利用できます。なお，J2EEサーバモードには，1.4モードと，互換用の動作モードであるベーシックモードがあります。

J2EEサービス

J2EEコンテナの部品機能として利用されます。J2EEコンポーネントにJNDI，JDBC，JTA，RMI-IIOPおよびJavaMailのAPIを提供します。

J2EEリソース

サーバから利用できるリソースです。J2EEサーバの場合，データベース，OpenTP1，SMTPサーバなどを利用できます。また，バッチサーバの場合，データベースを利用できます。

J2EEリソースアダプタ

J2EEサーバに共有スタンドアロンモジュールとして配備したリソースアダプタのことです。

jaas.conf（JAASのコンフィグレーションファイル）

ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要なJAAS認証用の設定ファイルです。

Java

1991年にSun Microsystems, Inc.内の研究グループが開発したインタプリタ言語を基に，C++をより移植性と信頼性が高くなるように改良した言語です。Webの普及によってブラウザに応用されています。

JavaロギングAPI

J2SEで提供されているコアロギング機能のクラスおよびインタフェースです。Application Serverでは，JavaロギングAPIを使用してユーザログを日立トレース共通ライブラリ形式で出力する機能を提供しています。

JCAコンテナ

J2EEサーバやバッチサーバと，EISを接続するためのシステムレベルのプラグイン機能を提供するコンテナです。

JDBC（Java Database Connectivity）

Javaのプログラムでデータベースを利用するためのAPIです。

JavaSoftが1996年前半に仕様を公開しました。Javaプログラムから，JDBC APIを経由して「JDBCドライバ」を呼び出し，ドライバがデータベース・サーバへの接続機能を提供します。

JNDI（Java Naming and Directory Interface）

Javaプラットフォーム用の標準拡張機能で，Java テクノロジに対応したアプリケーションに，企業内の複数のネーミングおよびディレクトリサービスへの統一したインタフェースを提供します。

Application Serverでは，Cosminexus TPBrokerのCORBAネーミングサービスを利用して，JNDIの機能を実現しています。

JNDI名前空間

JNDIによってアクセスする名前情報が管理されている名前空間です。Application Serverでは，J2EEアプリケーションをデプロイした時に，EJBオブジェクトリファレンスがJNDI名前空間の名前にバインドされます。

Application Serverで使用するJNDI名前空間の名前には，別名を付けることができます。これによって，Enterprise BeanやJ2EEリソースを別名でルックアップできるようになります。

JP1

日立の統合システム運用管理ソフトウェアです。

JP1/AJS2

日々の業務の中から，定型的・定期的なものを自動化して，システム運用に掛かるコストを削減し，少ない人員で確実な運用を実現するめたのプログラム群です。JP1/AJS2 - Manager，JP1/AJS2 - Agent，JP1/AJS2 - Viewの製品で構成されます。

JP1/AJS2 - SO

一つ一つの運用手順を蓄積し，ライブラリとして統合する運用管理の基盤機能を提供するプログラムです。立案したシナリオに合う運用手順をライブラリから選択し，運用環境に合わせてカスタマイズすることで，業務運用の設計を容易に，かつ高品質で実現することができます。

JP1/Cm2/NC - Manager

負荷分散機の設定をしたり，負荷分散機の制御をしたりするためのプログラムプロダクトです。

JP1/Cm2/NC - Manager for Cosminexus

Cosminexusと連携して，負荷分散機を制御するためのプログラムプロダクトです。Management Serverから負荷分散機を動的に制御できます。

JP1/IM

企業情報システム全体を統合管理する基盤になるプログラム群です。JP1 Version 8の場合は，JP1/IM - Manager，JP1/IM - View，およびJP1/IM - CMの三つの製品で構成されます。JP1 Version 7iの場合は，JP1/IM - Central ConsoleおよびJP1/IM - Central Scope，JP1/IM - View，およびJP1/IM - CMの四つの製品で構成されます。

JP1/IM - CM

業務システムを構成する各種のリソース（サーバ，ストレージなど）やシステム構成に関する情報を集約して管理するためのプログラムです。管理対象のリソースを任意にグルーピングできるため，システムの監視（性能，障害）や運用（設定配布，構成変更）の際に，グループ単位で管理したり操作したりできます。

JP1/NETM/Audit

システム内の製品が出力した監査ログを自動収集して，一括管理するためのプログラムプロダクトです。JP1/Baseと連携して，Cosminexusのアプリケーションサーバ，運用管理サーバ，連携する日立オープンミドルウェア製品などが出力した監査ログを監査ログ管理サーバで自動収集できます。また，収集した監査ログを，監査ログ管理サーバのデータベースで一元管理できます。

JP1/SC/DPM

デプロイメント操作を実行するためのソフトウェアです。ディスクイメージをバックアップしたり，OSやアプリケーションのインストールを一括して実施したりできます。

JP1イベント

システム内で何らかの事象が発生した際に，その事象に関してJP1/Baseに通知される情報です。

JP1ジョブ運用管理サーバ

JP1/AJS2と連携してシステムの自動運転をする場合に，JP1/AJS2 - Managerを配置するホストのことです。

JP1統合運用管理サーバ

JP1/IMと連携してシステムの集中監視をする場合に，JP1/IM - Manager（JP1 Version 8の場合）を配置するホストのことです。JP1 Version 7iの場合は，JP1/IM - Central ConsoleおよびJP1/IM - Central Scopeを配置するホストのことです。

JSP（JavaServer Pages）

Webページを作成するHTMLの中にJSP固有のタグを埋め込んでEnterprise Beanを呼び出すことや，サーブレットから値を受け取ることができます。また，簡単なJava言語を直接記述することもできます。

JSP EL

JSP 2.0で定義された式言語です。JSPファイルやタグファイル内に

JavaBeansの属性へのアクセスなどを記述できます。また，APIも提供されています。

JSPコンパイル結果

JSPファイルおよびタグファイルのコンパイルで生成されるJavaソースファイルやクラスファイルです。

JSP事前コンパイル

Webアプリケーションに含まれるJSPファイルおよびタグファイルをデプロイ前にコンパイルし，Javaソースファイルやクラスファイルを生成する機能です。JSP事前コンパイル機能を使用してあらかじめJavaソースファイルやクラスファイルを生成しておくと，Webアプリケーション実行時の初回リクエストでのレスポンスタイムを短縮できます。

JSPタグライブラリ

JSPタグを作成するためのもので，JSP仕様で規定されています。Cosminexusでは，統合ユーザ管理をする場合に，Cosminexus標準ログインモジュールを使用してユーザ認証をするためのJSPタグライブラリを提供しています。

Management Server

運用管理ドメインを構成するサーバプログラムです。運用管理ドメイン単位に一つ配置します。

Management Serverは運用管理ドメイン内の各ホストに配置した運用管理エージェントに指示を出して，運用管理ドメイン全体の運用管理を実行します。

Managementアクション

Managementイベント発生時に自動的に実行される処理です。Managementアクションとしてどのような処理をするかは，Management Server側であらかじめ定義しておきます。

Managementイベント

Management Serverを利用して運用している場合に，運用管理ドメイン内の論理サーバで発生した事象に応じてManagement Serverで発行するイベントです。論理サーバでメッセージが出力されたタイミングで発行できます。例えば，リソース監視中に設定したしきい値を超えた場合などに発行できます。

Managementイベントに対してManagementアクションを定義しておくと，発生した事象に応じたアクションを自動的に実行できます。

Message-driven Bean

JMSと連携するメッセージ駆動タイプのBeanです。EJBコンテナはJMSのDestinationからのJMSメッセージ受信を契機にBeanを起動します。

MIBオブジェクト

SNMPプロトコルで使用するオブジェクトです。

MIBファイル

SNMPプロトコルで使うオブジェクトの構造体を記述したテキストファイルです。すべてのオブジェクト（情報）は，オブジェクトIDで一意に決まります。

Microsoft Cluster Service

クラスタソフトウェアの一つです。

システムを監視し，障害発生時などにシステムの切り替えを実行するプログラムです。Microsoft Cluster Serviceと連携することで，Cosminexusシステムの信頼性や稼働率を向上できます。Windows Server 2003で使用できます。

Microsoft Cluster Serviceと連携したシステムでは，1：1系切り替えシステム，相互系切り替えシステム，N：1リカバリシステムが実現できます。

N:1リカバリシステム

クラスタ構成の実行系のアプリケーションサーバに対して，1台のリカバリ専用サーバを待機系として配置したシステムです。リカバリ専用サーバでは，障害が発生した実行系のアプリケーションサーバのトランザクションの決着をします。

Oracle RAC

Oracleデータベースのクラスタ機能です。Cosminexusでは，Oracle RAC機能を使用してクラスタ化されたOracleデータベースに接続できます。

ORBゲートウェイ

CORBAクライアントからJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能です。CTMレギュレータプロセスによって提供されます。

OTMゲートウェイ

TPBroker OTMのクライアントからJ2EEサーバ内で動作しているEJBアプリケーションを直接呼び出しできるゲートウェイ機能です。OTMゲートウェイプロセスによって提供されます。

OTS（Object Transaction Service）

1.4モードで，TPBroker OTSによる分散トランザクションを使用するために必要なサービスです。

Outbound

Connector 1.5仕様で定められたJ2EEサーバとリソースアダプタ間の通信モデルの一つです。J2EEサーバからリソースアダプタにアクセスする通信モデルです。

PRFデーモン

バッファに出力されたPRFトレースをPRFトレースファイルに出力するIOプロセスです。

Management Serverでは，論理サーバとして扱えます。Management Serverで扱う場合は，パフォーマンストレーサといいます。

PRFトレース

リクエストを処理する時にCosminexusシステムの各機能で出力されたトレース情報です。バッファに出力されて，一定量たまったらPRFトレースファイルに出力されます。

PRFトレース出力ライブラリ

Cosminexusシステムの各機能に組み込まれているライブラリです。機能レイヤごとのPRFトレースをバッファに出力する機能を提供しています。

PRFトレース取得レベル

PRFトレースを取得するレベルです。「標準レベル」，「詳細レベル」，「保守レベル」があります。「詳細レベル」または「保守レベル」を指定した場合，「標準レベル」に比べてトレース取得ポイントが多くなります。

PRFトレースファイル

PRFトレースを出力したバイナリ形式のファイルです。性能解析トレースファイル（CSV形式）に変換する基になるファイルです。

RMI-IIOP

JavaRMI とJavaIDLを統合したAPIです。

SecurityManager

セキュリティポリシーに基づいたWebコンテナの実行時保護をするJ2EEサーバの機能です。

Server Plug-in

Eclipseのプラグインです。Server Plug-inを使用すると次の操作ができます。

リソースアダプタのプロパティを設定したり，設定したリソースアダプタをJ2EEサーバやバッチサーバにデプロイしたりする。

J2EEアプリケーションのプロパティを設定したり，設定したJ2EEアプリケーションをJ2EEサーバにインポートしたりする。

論理サーバを起動・停止する。

Session Bean

主に業務処理を実行するためのBeanです。Session Beanは，クライアントを一つだけ持つことができます。クライアントが終了すると，対応するSession Bean も終了します。クライアントとのセッションの間だけ動作するため，一時的であり，非永続的なBeanです。Session Beanは，Stateful Session Beanと，Stateless Session Beanに分類されます。

SFOサーバ

システム内のJ2EEサーバのJ2EEアプリケーション内で生成されたグローバルセッション情報を管理するJ2EEサーバです。セッションフェイルオーバ機能を使用するときにシステム構成に含めます。

SFOサーバアプリケーション

SFOサーバ上で稼働するJ2EEアプリケーションを，SFOサーバアプリケーションといいます。SFOサーバアプリケーションはEJBで実装されています。なお，SFOサーバアプリケーションはCosminexusで提供しています。

Smart Composer機能

Cosminexusを使用してアプリケーションサーバを構築する場合に，一般的な3階層モデルのアプリケーションサーバのシステムを，簡単に構築および運用できるよう支援する機能です。システム全体に対して，システムの設定，およびJ2EEアプリケーションやリソースアダプタのデプロイを一括で実行できるので，簡単，迅速にシステム構築ができます。

構築したシステムを一括で起動したり，一括でシステムの設定を変更したりなど，運用機能についてもサポートしています。

snapshotログ

ある時点でのJ2EEサーバやバッチサーバの状態が出力されたログファイルです。

トラブルシューティングに必要な情報が自動的に出力されます。

Management Serverを利用している場合は，次のタイミングで出力されます。

論理サーバに異常が発生した時

運用管理ポータルまたは運用管理コマンドによってsnapshotログの収集を要求した時

Management Serverを利用していない場合は，コマンド（snapshotlog）を実行した時に出力されます。このコマンドで出力できるのは，そのコマンドを実行したホストの情報だけです。

SNMP連携用形式ファイル

SNMP Manager製品と連携するためのファイルです。MIBファイルに変換する基になる形式のファイルです。Management Serverの運用管理コマンド（mngsvrutil）で出力できます。

Stateful Session Bean

内部的な状態を保持できるBeanです。Stateless Session Beanとは異なり，ホームインタフェースからの生成によってインスタンス化されたあとは，メソッドの呼び出しごとに生成，消滅することはありません。セッション単位で連続した処理をする場合に適したBeanです。

Stateless Session Bean

状態を保持しないBeanです。Beanのインスタンスの生成・消滅は，すべてEJBコンテナが独自に管理しています。同じBeanのメソッドを続けて呼び出した場合にも，それらが同じインスタンスである保証はありません。そのため，Stateless Session Beanでは，内部状態を保持して，複数メソッドで連続した処理をすることはできません。1メソッドで完結するような処理を記述する場合に適しています。

Timer Service

EJBコンテナで提供される機能です。指定した時刻，経過時間，または間隔で，EJBコンテナがタイムアウトメソッドをコールバックします。

ua.conf（統合ユーザ管理のコンフィグレーションファイル）

JAAS対応ユーザ管理，およびシングルサインオンの機能を使用するための設定ファイルです。

uCosminexus Batch Job Execution Server

オープン環境で基幹系のバッチ業務を実行・運用するためのバッチジョブ実行基盤を提供する製品です。JP1/AJS2とあわせて使用します。

uCosminexus Client

EJBクライアント環境を構築するための製品です。

uCosminexus Operator

Application Serverをインストールしたマシンとは別のマシンから，GUI（Eclipseプラグイン）画面を使用して運用操作を実行するための製品です。例えば，実行環境がUNIXの場合に，別のWindowsのマシンでEclipseプラグインのGUIによる運用管理操作を実行したいときに，この製品を使用します。

usrconf.properties（ユーザプロパティファイル）

J2EEサーバ，バッチサーバ，Webコンテナサーバ，またはサーバ管理コマンドで使用するJavaVMのシステムプロパティを定義するファイルです。

WARファイル

Webアプリケーションの構成要素をJARファイル形式に圧縮したファイルです。

Webアプリケーション実行に必要なHTMLファイル，JSPページ，Javaクラスファイル，JARファイル，およびWebアプリケーション配置記述子が含まれます。

Webアプリケーション

Webブラウザを備えたクライアントを対象に作成されたアプリケーションです。具体的には，サーブレットプログラム，JSPページ，HTML/XMLドキュメントなどの集合体です。

Webコンテナ

J2EEアーキテクチャのWebコンポーネント規約を実装するコンテナです。セキュリティ，トランザクションなどの各種サービスを提供する実行環境です。Webアプリケーションは，Webコンテナ上で動作します。

Java Servlet2.4仕様，およびJavaServer Pages Specification v2.0仕様に準拠したWebアプリケーションを実行できます。

Webコンテナサーバ

サーブレットエンジンモードで動作するサーバを指します。

Webサーバ

Webブラウザからのリクエスト受信およびWebブラウザへのデータ送信に関連する処理を実行するプログラムです。Cosminexusでは，Hitachi Web Server，Microsoft IIS，またはインプロセスHTTPサーバを使用できます。インプロセスHTTPサーバは，J2EEサーバプロセス内で動作するWebサーバです。

なお，Management Serverを利用する場合，Hitachi Web Serverは論理サーバとして扱えます。

Webサーバ連携

アプリケーションサーバで使用するWebサーバとして，Hitachi Web ServerまたはMicrosoft IISを使用する方法です。

Hitachi Web ServerまたはMicrosoft IISにCosminexus Component Containerが提供するリダイレクタモジュールを組み込んで使用します。

Webシステム

1台の負荷分散機（ロードバランサ）と複数のWebサーバおよびアプリケーションサーバで構築されるWebクラスタシステムで，単一の業務サービスを提供します。

（ア行）

アーカイブ形式

EJBやサーブレットなどのアプリケーションの実体をJ2EEサーバの作業ディレクトリに持つJ2EEアプリケーションの形式です。

アウトプロセス

プロセスの起動のしかたです。アウトプロセスで起動させると，J2EEサーバのプロセス外で実行します。アウトプロセスでネーミングサービスを使用する場合，CORBAネーミングサービスはユーザが起動する必要があります。

アセンブル

単体では動作しないEJB-JARをアプリケーションの1構成要素として位置づけるための組み立て作業のことです。

アノテーション

ソースコードにクラスやメソッドの付加情報などを埋め込むための記述方式です。

アプリケーションサーバ

情報システムの中間に位置し，ユーザの要求（プレゼンテーション層）とデータベースなどの業務システム（データ層）の処理を橋渡しするためのアプリケーション層を構築するためのミドルウェアです。

日立のアプリケーションサーバCosminexusは，業務の開発から運用まで一貫した環境を提供します。

アプレット

Web経由で読み手のマシンのブラウザ上にダウンロードされるJavaプログラムです。

イベントリスナ

イベントを受け取って処理するオブジェクトです。Application Serverでは，Webアプリケーション単位でサーブレットコンテキストオブジェクトまたはセッションオブジェクトの状態変化イベントを受け取ります。

インプロセス

プロセスの起動のしかたです。インプロセスで起動させると，J2EEサーバのプロセス内で実行するように最適化されるので，パフォーマンスの高いシステムが実現できます。ネーミングサービス，トランザクションサービスおよびHTTPサーバ機能をインプロセスで起動できます。このとき，CORBAネーミングサービス，インプロセスOTSおよびインプロセスHTTPサーバは，J2EEサーバ起動時に自動で起動されます。

インプロセスHTTPサーバ

J2EEサーバのインプロセスで動作するWebサーバ機能です。Webコンテナの機能の一部として提供されます。

運用監視エージェント

ホスト上で動作する論理サーバの稼働状況を監視して，稼働情報を収集するエージェントプログラムです。

運用管理エージェント

運用管理者の代わりに，それぞれのホスト上の論理サーバを起動したり，設定ファイルを更新したりするエージェントプログラムです。

運用管理コマンド（mngsvrutil）

Management Serverを操作するためのCUIです。

運用管理サーバ

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，Management Serverを配置したホストです。運用管理ドメイン内の各ホストに配置されている運用管理エージェントに対して，管理操作を指示します。

運用管理サーバモデル

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，アプリケーションサーバとは別の運用管理用のホストにManagement Serverを配置するシステム構成モデルです。

運用管理ドメイン

Management Serverが管理する論理サーバの集合です。同じ運用管理ポリシーが適用されます。

運用管理ポータル

Management Serverを操作するためのGUIです。Webブラウザで表示します。

運用管理ポリシー

運用，監視，セキュリティなど，運用管理に関するポリシーです。

エラーページのカスタマイズ

Webクライアントから存在しないリソースへのアクセスなどがあった場合に，Webコンテナから返却されるエラーページをユーザが作成した任意のページに変更して表示させる機能です。

（カ行）

ガーベージコレクション制御機能

リソースの排他中にガーベージコレクションの実行を待ち状態にする機能です。リソースの排他中にフルガーベージコレクションが発生し，処理が長時間中断されるのを回避できます。ガーベージコレクション制御機能は，バッチサーバの場合に使用できます。

カスタムジョブ

JP1/AJS2以外のプログラムとJP1/AJS2が連携するジョブを定義する場合に，目的のジョブを容易に作成するために使用できるジョブのテンプレートです。Windowsの場合，Cosminexusでは，「論理サーバ制御用カスタムジョブ」と「アプリケーション制御用カスタムジョブ」の2種類を提供しています。

カスタムログインモジュール

Cosminexus標準ログインモジュール以外を使用して，各アプリケーションのユーザ認証をしたい場合に作成する実装クラスです。

仮想サーバ

負荷分散機で複数の実サーバを管理するための仮想的なサーバです。負荷分散機では，クライアントから仮想サーバにアクセスされたトラフィックを，実サーバに自動分配します。

稼働情報収集機能

J2EEサーバやバッチサーバ内の各機能の稼働情報を定期的に収集し，ファイルに出力する機能です。出力されたファイルを稼働情報ファイルといいます。

簡易Webサーバ

WebコンテナをHTTPサーバとして使用して，スタブなどのダウンロードに利用する機能です。インプロセスHTTPサーバとは異なり，実運用時にはスタブのダウンロード以外の目的では使用できません。

Management Serverを利用する場合は，「管理用サーバ」という名称で扱います。

監査証跡

データベースの機能で出力する，データベースに対する操作記録のことです。データベースに対する権限の運用が適切に行われているかどうかをチェックするために使用します。Cosminexusでは，監査証跡にCosminexusシステムの情報を出力するためのデータベース監査証跡連携機能を提供しています。

監査ログ

システム構築者やシステム運用者がCosminexusのプログラムに対して実行した操作，およびその操作に伴うプログラムの動作の履歴が出力されるファイルです。監査者が監査ログを調査することで，「いつ」「だれが」「何をしたか」を知ることができて，システムの運用が法規制，セキュリティ評価基準，または業界ごとの各種の基準に準拠していることを証明できます。

監視ツリー

JP1/IM連携をしている場合に，統合スコープに表示するツリーのことです。Cosminexusシステムでは，監視ツリーとして，Cosminexus業務指向ツリーとサーバ指向ツリーの2種類を作成する機能を提供しています。

管理対象オブジェクト（AdminObject）

Connector 1.5仕様で定義された，キューやトピックなどを使用したメッセージの送受信で使用するオブジェクトです。メッセージ送信や，同期または非同期でのメッセージ受信でのメッセージ変換で使用します。

管理対象オブジェクトは，メッセージプロバイダごとに特有のオブジェクトです。リソースアダプタが使用する管理対象オブジェクトは，リソースアダプタのDD（ra.xml）の<adminobject>タグで指定します。

機能レイヤ

性能解析トレース収集をする場合に，PRFトレースを出力する機能の層です。EJBクライアント，リダイレクタ，Webコンテナ，CTM，EJBコンテナ，JNDI，JTA，JCA/JDBCなどがあります。

業務指向ツリー

JP1/IMと連携している場合に統合スコープに表示する監視ツリーの一つです。Cosminexusシステム上で稼働しているJ2EEアプリケーションを主体に構成されている監視ツリーです。どの業務で問題が発生しているか，業務の視点でトラブルを監視できます。

業務処理プログラム

ビジネスロジックを実装したEnterprise Beanのことです。

共有スレッド数

Webコンテナ上にデプロイされているWebアプリケーションで共有されるスレッド数です。

クライアントアプリケーション情報

性能解析トレースに出力される情報です。次に示すEnterprise Beanを呼び出す単位で設定される情報です。

WebコンテナからEJBコンテナの呼び出し

EJBクライアントからEJBコンテナの呼び出し

EJBコンテナからEJBコンテナの呼び出し

クラスタ

ある共通の機能を提供するサーバの集合です。

Management Serverでは，J2EEサーバクラスタまたはWebサーバクラスタを論理サーバとして扱えます。

クラスタソフトウェア

システムの信頼性向上，稼働率向上を目的として，システムの切り替えを実現するプログラムです。

実行中のサーバシステムに障害が発生した場合，事前に待機しているサーバシステムに，直ちに自動で切り替えることができます。そのため，オペレータが特に意識することなく，システムの信頼性や稼働率を高められます。

Cosminexusでは，クラスタソフトウェアを使用して，1:1系切り替えシステム，N:1リカバリシステム，および相互系切り替えシステムを実現できます。

AIX，HP-UXまたはLinuxを使用している場合は，クラスタソフトウェアとしてHAモニタが使用できます。Windowsの場合は，クラスタソフトウェアとしてMicrosoft Cluster Serviceが使用できます。

グローバルCORBAネーミングサービス

CTMによってリクエストをスケジューリングする場合に，CTMドメイン内に含まれる複数のJ2EEサーバに登録されている業務処理プログラム（Stateless Session Bean）の情報を共有管理するネーミングサービスです。

グローバルセッション

セッションフェイルオーバ機能では，障害発生前のHTTPセッションと，障害発生後に引き継がれたHTTPセッションを一つのセッションとして扱います。これをグローバルセッションといいます。

グローバルセッションID

グローバルセッションを管理するIDです。システム内でグローバルセッション情報を一意に識別するために，グローバルセッションに付けられます。

グローバルセッション情報

グローバルセッションが持つ情報をグローバルセッション情報といいます。グローバルセッション情報はSFOサーバで管理されます。

グローバルトランザクション

J2EEサーバが提供するトランザクションマネジャによって管理されるトランザクションです。2フェーズコミットプロトコルを使用できるので，トランザクションに複数のリソースを参加させることができます。

系

系とは，業務処理に必要なハードウェアのほか，実行するプログラムや通信機器を含めたシステム全体の総称です。系の種類には，実行系と待機系があります。

計画系切り替え

系切り替えの方法の一つで，オペレータが系を保守する際に，計画的に系を切り替える方法です。

系切り替え

システムに障害が発生した場合やシステムの保守のために，システムを切り替えることをいいます。系切り替えが行われると，待機系は業務処理を引き継いで実行系となります。一方，実行系は，さらに障害が発生した場合に備えて待機系となります。以降，系切り替えのたびに，実行と待機を交代して，どちらかの系で常に業務処理を実行するようにします。

系障害

サーバを除いた系に発生する障害を指します。系のハードウェア障害やHAモニタの障害などがあります。なお，サーバに発生する障害はサーバ障害といいます。

ゲートウェイ指定機能

クライアントとWebサーバとの間に，SSLアクセラレータや負荷分散機などのゲートウェイを配置している場合に，Webコンテナにゲートウェイ情報を通知し，welcomeファイルやForm認証画面に正しくリダイレクトできるようにするための機能です。

現用系

最初に実行系として動作させる系を現用系といいます。系切り替えによって，実行系が待機系になった場合でも，呼び方は変わりません。

コネクションスイーパ

一定の間隔でコネクションプール内の未使用コネクションを破棄する機能です。

コネクションプーリング

サーブレット，JSP，Enterprise BeanなどのJ2EEコンポーネントや，バッチアプリケーションからリソースへのアクセス量に応じて，リソースコネクションをメモリ上にプーリングする機能です。リソースコネクションには，JDBCコネクション，リソースアダプタのコネクションなどがあります。コネクションをプーリングしておくことで，アプリケーションからのリソース接続要求を高速に処理できます。

コミットオプション

CMPフィールドのキャッシュ方法とEntity Beanの状態遷移のキャッシュモデルを指定するオプションです。

Full cachingの場合，Entity Beanは前回のトランザクションコミット時と同じ状態で開始されます。

Cachingの場合，Entity Beanはデータベースの最新状態と同じ状態で開始されます。

No cachingの場合，Entity Beanはデータベースの最新状態と同じ状態で開始され，かつ，トランザクションコミット時にEntity Beanは非活性になります。

コンテキスト

Webアプリケーションをまとめた管理単位です。

コンテキストルート

コンテキストのルートパスです。コンテキスト内のWebアプリケーションにアクセスするときにURL上に指定します。コンテキストパスとも呼びます。

コンテナ拡張ライブラリ

ユーザ作成ライブラリのインタフェースおよび機能を，J2EEコンテナ，Webコンテナ，またはバッチサーバから利用できるように拡張したライブラリです。Enterprise Bean，サーブレットおよびJSPから共通して利用できます。

（サ行）

サーバ管理コマンド

サーバで管理しているアプリケーションおよびリソースの設定をするためのコマンド群です。

サーバ起動・停止フック機能

J2EEサーバ，バッチサーバまたはWebサーバの起動・停止時に，コンテナ拡張ライブラリを使用するための初期化処理および停止処理を自動的に呼び出す機能です。J2EEサーバまたはWebサーバが異常終了した場合には機能しません。

サーバ指向ツリー

JP1/IMと連携している場合に統合スコープに表示する監視ツリーの一つです。サーバマシン（ホスト）を主体に構成されている監視ツリーです。

サービス閉塞

J2EEアプリケーションの運用中に特定の業務処理プログラムを入れ替えたい場合などに，システム全体は稼働させたまま，該当サービスだけを安全に閉塞させる機能です。

サービスユニット

J2EEサーバやWebサーバで構成される業務サービスを提供する閉じた部分系を，サービスユニットといいます。Smart Composer機能では，サービスユニット単位でシステムを構築したり，一括起動や一括停止をしたりできます。

Smart Composer機能を利用してシステムを構築するときの概念です。

サーブレット

サーバ側でJavaを実行させる方法の一つです。

サーブレットは，Webサーバに対して，単にHTML文書や画像ファイルを送るだけではなく，Webサーバと連携して，アプリケーションを実行し，その結果をHTML文書として送り返す機能を提供します。

サーブレットエンジンモード

サーバの動作モードの一つです。Webコンテナ部分だけを使用して，サーブレットエンジンを単独で動作させます。Enterprise Beanは動作しません。

サーブレットエンジンとは，サーブレット実行機能およびJSP実行機能を持つサーバのことです。

なお，サーブレットエンジンモードは互換用の動作モードとなります。

サーブレットフィルタ

サーブレット/JSPへのリクエストや，サーブレット/JSPからのレスポンスを，フィルタリングする機能です。サーブレットフィルタによって，サーブレット/JSPの実行前のリクエスト，または実行後のレスポンスをラップして，データの変更，リソースに対するトレースの取得などができます。

Cosminexusの機能を実現するためのサーブレットフィルタとしては，セッションフェイルオーバ用フィルタ，およびHTTPレスポンス圧縮用フィルタが提供されています。

実行系

業務処理を実行させる系（実行中のサーバ）を指します。

実行待ちキュー

同時実行スレッドの最大値を設定している場合に，実行スレッド数が最大に達したときに，リクエストをためておくキューのことです。

実パラメタ

Cosminexusの定義ファイルに設定するパラメタです。Smart Composer機能では，抽象パラメタを一つ設定することで，互いに関連のある複数の実パラメタに，一括で値を設定できます。

自動系切り替え

系切り替えの方法の一つで，クラスタソフトウェアが自動的に系を切り替える方法です。

シナリオ

JP1/AJS2 - SOで扱う，シナリオジョブに実行順序を付けてネットワーク化したオブジェクトです。シナリオジョブとは，シナリオ中に定義されたコマンド，シェルスクリプト，Windows実行ファイルなどを定義したオブジェクトです。

シナリオはJP1/AJS2に登録して実行できます。

ジョブ

JP1/AJS2で扱うシステム運用の各作業のことです。

ジョブネット

JP1/AJS2で扱うジョブの実行順序を関連づけたものです。

シングルサインオン

一度のログイン処理で，ユーザIDが異なる複数のシステムをシームレスに利用できるようにする機能です。

シングルサインオン情報リポジトリ

統合ユーザ管理フレームワークのユーザマッピングを実行して，シングルサインオンでユーザ認証するための各システムの認証情報とマッピング情報を格納するリポジトリです。

シングルサインオンライブラリ

ユーザマッピング情報の格納されたシングルサインオン情報リポジトリの情報を基にユーザマッピングをして，シングルサインオンを実現するライブラリです。

スケールアウト

システム全体の処理性能を向上させることを目的として，サーバの台数を増やすことをいいます。

スケールイン

システムの規模を縮小する場合などに，サーバの台数を減らすことをいいます。

スケジュールキュー

CTMによってリクエストをスケジューリングする場合に，リクエストをためておくキューです。J2EEアプリケーション単位で作成され，CTMデーモンによって管理されます。

スケジュールポリシー

CTMによってリクエストをスケジューリングする場合に，振り分ける基準を決めるポリシーです。負荷が軽いCTMデーモンに振り分ける方法と，リクエストを受け付けたCTMデーモンに優先的に処理させる方法のどちらかを選択できます。

スマートエージェント

1.4モードでグローバルトランザクションを使用する場合，またはCTMを使用する場合に，動的な分散ディレクトリサービスを提供するプロセスです。

Management Serverを利用する場合，スマートエージェントは論理サーバとして扱えます。CTMはスマートエージェントによって管理されます。

なお，グローバルトランザクションの場合でも，インプロセストランザクションサービスを利用するときは，スマートエージェントは不要です。

静的コンテンツ

HTMLファイルや画像ファイルなど，クライアントからの要求に対する応答に使用するファイルのうち，リクエスト内容に影響されないで常に同じ内容になるコンテンツのことです。

性能解析トレース

Cosminexusシステムの性能解析をするためのトレース情報です。

性能解析トレースファイル

Cosminexusシステムの性能解析をするためのトレース情報をCSV形式で編集出力したテキストファイルです。

セキュリティアイデンティティ

J2EEサーバによるユーザ認証が成功した時にWebコンテナやEJBコンテナに伝達される認証情報です。

セッション

Webアプリケーションに対する一連の作業を示す単位です。セッションは通常，WebクライアントからWebサーバへの複数のリクエストの集合から構成されます。

セッションフェイルオーバ機能

J2EEアプリケーション実行中のHttpSessionオブジェクトに登録されたオブジェクトをセッション情報として管理し，J2EEサーバで障害が発生した場合には，管理しているセッション情報をほかのJ2EEサーバに引き渡す機能です。J2EEサーバで障害が発生し，ほかのJ2EEサーバにリクエストが転送された場合でも，障害発生前の状態で業務を続行できます。

セッションフェイルオーバサーバ

セッションフェイルオーバ機能を使用する場合に，J2EEサーバを配置しないで，SFOサーバを配置して使用するホストです。

セットアップウィザード

対話形式のウィザードプログラムを使用してシステムを構築するための機能です。必要最低限の項目を設定するだけで，J2EEアプリケーションを実行するためのシステムを構築できます。できるだけ少ない手順で実行環境を構築したい場合にお勧めの機能です。ただし，セットアップウィザードで実行できるのは，1台のマシンを対象にしたシステム構築だけです。

占有スレッド数

利用できるスレッド数のうち，同時実行スレッド数制御の対象となるリクエストを確実に実行できるスレッド数です。Webコンテナ上にデプロイされているWebアプリケーションごと，またはWebアプリケーション内の業務処理ロジックごとに指定できます。

相互系切り替えシステム

クラスタソフトウェアを使用して実現できるシステムの一つです。アプリケーションサーバの実行系と待機系を1：1にする構成で，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にするシステムです。

相互スタンバイ

クラスタソフトウェアを使用した運用をする場合に，アプリケーションサーバの実行系と待機系を1:1にする構成で，それぞれのアプリケーションサーバを実行系として稼働させながら，お互いの待機系にすることです。

（タ行）

待機系

障害に備えて待機させている系（待機中のサーバ）を指します。

抽象パラメタ

互いに関連のあるパラメタを一つのパラメタとしてまとめたものです。Smart Composer機能で使用します。Smart Composer機能のコマンドを使用してパラメタを展開すると，一度に複数の実パラメタに値が展開されます。

通常モード

J2EEアプリケーションの動作モードです。通常モードは，本番稼働するJ2EEアプリケーションを動作させるためのモードです。

データソース

JDBCを使用してデータベースに接続する機能です。

テストモード

J2EEアプリケーションの動作モードです。テストモードは，テスト用のJ2EEアプリケーションを本番環境と同じように動作させるためのモードです。

デプロイ

J2EEアプリケーションの場合，J2EEサーバ内にインポートしたJ2EEアプリケーションを，クライアントから実行可能な状態にすることです。

J2EEリソースアダプタの場合，J2EEサーバ内にインポートしたJ2EEリソースアダプタを，そのJ2EEサーバ上で動作するすべてのJ2EEアプリケーションから使用可能な状態にすることです。

展開ディレクトリ形式

EJBやサーブレットなどのアプリケーションの実体を，J2EEサーバの外部にある一定のルールに従ったファイル／ディレクトリに持つJ2EEアプリケーションの形式です。

統合コンソール

JP1/IMと連携している場合に，システムで発生した事象に関するエラーメッセージなどを表示する画面です。

統合スコープ

JP1/IMと連携している場合に，システムの監視画面として管理者の目的に合った監視ツリーを表示する画面です。

統合ネーミングスケジューラサーバ

CTMによるリクエストのスケジューリングをする場合に，J2EEサーバを配置しないで，グローバルCORBAネーミングサービスを配置して使用するホストです。統合ネーミングスケジューラサーバのレプリカを作成することで，可用性を向上できます。なお，統合ネーミングスケジューラサーバにもCTMデーモンは必要です。

統合ネーミングスケジューラサーバモデル

CTMによるリクエストのスケジューリングをする場合に，J2EEサーバを配置しないでグローバルCORBAネーミングサービスを配置するホストを作成するシステム構成モデルです。

統合ユーザ管理

Cosminexusシステムにログインするユーザを統合管理するための仕組みです。ユーザ認証を実現する統合ユーザ管理フレームワークと，リポジトリ管理およびリソース監視を実現する統合ユーザ管理GUIが使用できます。

統合ユーザ管理GUI

Management Serverの運用管理ポータルから，統合ユーザ管理の対象になるユーザ情報を格納したリポジトリを管理したり，統合ユーザ管理に関連するリソースを監視したりするためのGUIです。

統合ユーザ管理フレームワーク

統合ユーザ管理でのユーザ認証を実現するフレームワークです。Java標準仕様（JAAS）に従ったAPIが提供されています。

動作モード

サーバの動作モードです。J2EEサーバモードとサーブレットエンジンモードがあります。J2EEサーバモードには，さらに，1.4モード，ベーシックモードがあります。

ただし，ベーシックモードおよびサーブレットエンジンモードは旧バージョンとの互換用の動作モードとなります。

動的コンテンツ

サーブレットやJSPのように，クライアントからの要求に応じて動的に生成されるコンテンツのことです。

トランザクションサービス

グローバルトランザクションを使用する場合に，トランザクションを管理するサービスです。TPBroker OTSによって提供されるサービス全体を表します。トランザクションサービスは，J2EEサーバのインプロセスで起動されます。

トランザクションマネジャ

トランザクションを管理する機能です。Application Serverが提供しています。グローバルトランザクションの場合は，トランザクションマネジャのバックエンドでTPBroker OTSが使用されています。

トレース取得ポイント

Cosminexusシステムの各機能レイヤでPRFトレースを出力するポイントのことです。PRFトレース取得レベルの指定によって，トレース取得ポイントの数は異なります。

（ナ行）

ネーミング切り替え

JNDIを介してEJBホームオブジェクトの登録，削除，検索をする時に，JNDIが接続するCORBAネーミングサービスを切り替えることです。

ネーミングサービス

オブジェクトに名前を付けて格納場所を管理しておくことで，格納先を知らなくても名前からそのオブジェクトを利用できるようにするサービスです。Application ServerではCORBAネーミングサービスを利用します。

Management Serverでは，ネーミングサービスを論理サーバとして扱えます。

（ハ行）

バインド先アドレス設定機能

Webサーバ連携および簡易Webサーバで利用するIPアドレスを，Webコンテナで明示的に指定する機能をバインド先アドレス設定機能といいます。複数の物理ネットワークインタフェースを持つホストまたは一つの物理ネットワークインタフェースに対して，ホストで実行する場合に，この機能を使用することで，任意のIPアドレスを設定できます。

バッチアプリケーション

バッチ処理を実装したJavaアプリケーションです。バッチ実行コマンドを使用して，バッチサーバ上で実行します。バッチ実行コマンドをJP1/AJS2のジョブとして定義しておくと，JP1/AJS2からバッチアプリケーションを実行できます。

バッチサーバ

バッチアプリケーションを実行するためのサーバです。バッチアプリケーションの実行機能のほかに，バッチアプリケーションからデータベースに接続したり，EJBにアクセスしたりする機能も提供しています。

パフォーマンストレーサ

PRFデーモンのことです。

Management Serverでは，パフォーマンストレーサを論理サーバとして扱えます。

ハンドラ

ロガーから受け取ったアプリケーションのログをファイルやコンソールに出力する，JavaロギングAPIのHandlerオブジェクトです。J2EEアプリケーション，バッチアプリケーション，EJBクライアントアプリケーションで使用できます。

Application Serverでは，日立トレース共通ライブラリ形式のログをファイルに出力するためのファイルハンドラである，CJMessageFileHandlerを提供しています。

ビジネスインタフェース

Enterprise Beanを呼び出すためのビジネスメソッドを定義するインタフェースです。

日立トレース共通ライブラリ

日立が提供するトレース採取用のライブラリです。複数の製品で共通のライブラリを利用するので，各製品のトレース形式が統一できます。

非保護区

メソッドキャンセルができる領域を指します。ユーザプログラムのコードが非保護区に該当します。メソッドキャンセルとは，J2EEアプリケーション実行時間の監視で提供される機能の一つです。また，バッチ強制停止コマンドでも使用されます。

負荷分散機

Webブラウザなどからのリクエストを一元的に受け付けて，同等の機能を持つ複数のサーバに転送して各サーバの負荷を分散させるための装置です。

物理コネクション

接続先リソースのコネクションです。通常はJ2EEコンテナが操作します。リソースアダプタの場合は，javax.resource.spi.ManagedConnection，JDBCの場合はjavax.sql.XAConnectionに該当します。

物理ティア

同一のデプロイメント（プロセスの配置，J2EEアプリケーションやリソースアダプタのデプロイ，定義）を適用するサーバマシンの集合を物理ティアといいます。

Smart Composer機能を利用してシステムを構築するときの概念です。

フロントEJB

リクエストの受け口となるEnterprise BeanをフロントEJBといいます。

ベーシックモード

旧バージョンとの互換性を確保するためのサーバの動作モードの一つです。

単一リソースとのトランザクション管理ができます。

別名

JNDI名前空間に登録するEJBホームオブジェクトリファレンスや，J2EEリソースに付けられる任意の名前です。ユーザ指定名前空間機能を使用している場合，別名を付けられます。Optional Nameともいいます。

保護区

メソッドキャンセルができない領域を指します。J2EEサービスのソースなどが保護区に該当します。メソッドキャンセルとは，J2EEアプリケーション実行時間の監視で提供される機能の一つです。また，バッチ強制停止コマンドでも使用されます。

ホスト単位管理モデル

Smart Composer機能または運用管理ポータルでシステムを構築している場合に，Management Serverをアプリケーションサーバと同じホストに配置するシステム構成モデルです。

（マ行）

未決着トランザクション

決着していない，仕掛かり中のトランザクションです。

メソッドキャンセル機能

J2EEアプリケーション実行時間の監視機能の機能の一つです。メソッドタイムアウト機能でタイムアウトが通知されたあと，メソッドのキャンセルを実施する機能です。キャンセル時にデータベースにアクセスしている場合は，トランザクションの強制決着もします。

また，メソッドキャンセル機能は，バッチ強制停止コマンド実行時にも使用されます。

メソッドタイムアウト機能

J2EEアプリケーション実行時間の監視機能の機能の一つです。監視基盤にあるリクエストのうち，一定時間内に終了しなかったメソッド処理を，タイムアウトとしてユーザに通知します。

メッセージインフロー

メッセージプロバイダがアプリケーションサーバ上のメッセージエンドポイントにメッセージを配送する場合の規約です。Connector 1.5のInboundの通信モデルを使用する場合に使用できる機能です。

メッセージプロバイダにはEISなどが該当します。アプリケーションサーバ上のメッセージエンドポイントにはMessage-driven Beanが該当します。

面数

ログファイルを保持する数です。ログファイルは面数分作成され，循環して使用されます。

メンバリソースアダプタ

コネクションプールをクラスタ構成にしている場合に，データベースノードに接続するリソースアダプタです。メンバリソースアダプタは，必ずルートリソースアダプタを経由してアクセスされます。

（ヤ行）

ユーザ指定名前空間機能

JNDI名前空間に登録するEJBホームオブジェクトリファレンスやJ2EEリソースの名前に，ユーザが任意の別名を付けられる機能です。別名を付与することによって，CTMによってリクエストを振り分けたり，負荷分散機やロードバランサによって負荷分散したりする場合に，サーバ名やアプリケーション名に依存しない名前でルックアップできるようになります。

ユーザ情報

Cosminexusシステムにユーザがログインするための情報です。

ユーザ情報リポジトリ

統合ユーザ管理をする場合に，ログイン時のユーザ認証に使用する情報を格納するリポジトリです。LDAPディレクトリサーバまたはデータベース（RDB）が使用できます。

ユーザスレッド

ユーザがプログラムの中で明示して生成するスレッドのことです。

ユーザ認証ライブラリ

LDAPディレクトリサーバで構築されたユーザ情報リポジトリの情報を基にユーザ認証をして，認証したユーザの情報をアプリケーションに提供する，JAAS対応ユーザ管理用ライブラリです。

ユーザプロパティファイル

usrconf.propertiesのことです。J2EEサーバ，Webコンテナサーバまたはサーバ管理コマンドを実行するJavaVMのシステムプロパティを指定します。なお，J2EEサーバ，Webコンテナサーバおよびサーバ管理コマンドで使用するユーザプロパティファイルは，それぞれ格納先および指定できるキーが異なります。

ユーザマッピング

異なるユーザ情報リポジトリに格納した同じユーザについての情報を対応づけることです。

ユーザログ

J2EEアプリケーション，バッチアプリケーション，またはEJBクライアントアプリケーションが出力するログのことです。

予備系

最初に待機系として起動する系を予備系といいます。系切り替えによって，待機系が実行系になった場合でも，呼び方は変わりません。

（ラ行）

ライトトランザクション

ローカルトランザクションを最適化した状態で使用できる機能です。

ライブラリJAR

JARファイル形式でパッケージされた，共通ライブラリです。J2EEアプリケーション内のJ2EEコンポーネントから共通に使用できます。

ラウンドロビン検索

複数のCORBAネーミングサービス上にある同一名称のEJBホームオブジェクトを，ラウンドロビンポリシーに従ってルックアップする検索機能のことです。

ラウンドロビンポリシー

複数のCORBAネーミングサービス上にある同一名称のEJBホームオブジェクトをルックアップする場合に適用されるポリシーです。

EJBホームオブジェクトリファレンスをラウンドロビン検索によって取得できるので，EJBクライアントでは意識しないでJ2EEサーバに送信するリクエストの負荷分散を実現できます。

リカバリ専用サーバ

クラスタソフトウェアを使用してN:1リカバリシステムを構築している場合に待機系として機能するアプリケーションサーバです。

障害が発生した実行系のアプリケーションサーバに未決着のトランザクションがあった場合に，系が切り替えられ，該当するトランザクションを解決してリソースを解放します。

リクエスト処理スレッド

Webブラウザなどのクライアントからのリクエストを受け付けて処理するためにWebサーバで生成されるスレッドです。インプロセスHTTPサーバの場合は，Webコンテナで生成されます。

リクエストのスケジューリング

クライアントからのリクエストを実行するサーバを負荷に応じて的確に振り分けたり，サーバに送信するリクエストの数を制限したりする機能です。

リソースアダプタ

J2EE Connector Architectureによって，J2EEサーバまたはバッチサーバと，EISを接続するための接続機能です。

Cosminexusシステムでは，データベースに接続するためのリソースアダプタであるDB ConnectorおよびDB Connector for Cosminexus RMを提供しています。また，OpenTP1のSPPと接続するためのリソースアダプタであるuCosminexus TP1 Connector，TP1/Message Queueと接続するためのリソースアダプタであるTP1/Message Queue - Access，データベース上に実現したキューに接続するためのリソースアダプタであるCosminexus RMも使用できます。

リソースマネジャ

リソースを管理する機能です。DBMSなどが該当します。

リダイレクタ

Webサーバに登録しWebコンテナへの接続を可能にするプラグインコンポーネント（ライブラリ）です。Webサーバに登録したリダイレクタによって，リクエストをURLパターンまたはラウンドロビン方式で複数のWebコンテナに振り分けて処理できます。

リデプロイ機能

J2EEアプリケーションを入れ替えるときに使用する機能です。リデプロイ機能による入れ替えは，J2EEアプリケーションのテスト時などに，修正したJ2EEアプリケーションと動作中のJ2EEアプリケーションを入れ替えたいときに使用します。

リバースプロキシサーバ

インターネットなどの外部ネットワークとアプリケーションサーバが配置されている内部ネットワークの間のDMZに配置され，外部ネットワークからのリクエストを内部ネットワークに中継するための機能を持つWebサーバです。

Cosminexusでは，Hitachi Web Serverをリバースプロキシサーバとして使用できます。リバースプロキシサーバには，リバースプロキシモジュールが組み込まれて動作します。

リモートインタフェース

Java RMIのインタフェース規定に従い，RMI-IIOP通信によってEnterprise Beanの呼び出しをするインタフェースです。

リモートホームインタフェースとリモートビジネスインタフェースが含まれます。

リロード機能

開始状態にあるアプリケーションを停止させないで，アプリケーションを構成するクラスやJSPを，少ない手順で動的に入れ替える機能です。

ルートアプリケーション情報

性能解析トレースに出力される情報です。イベントで一連の処理の先頭になるプロセスで取得した情報です。

ルートコンテキスト

コンテキストルートが空文字（コンテキストルートに名称が指定されていない）の，WARファイル内のルートパスです。

ルートリソースアダプタ

コネクションプールをクラスタ構成にしている場合に，メンバリソースアダプタを束ね，ユーザプログラムからのリクエストを受け付けるアダプタのことです。

レルム

統合ユーザ管理をしているシステムで，同一の認証ポリシーを適用する範囲のことです。

ローカルインタフェース

Enterprise Beanの呼び出しをJavaのメソッド呼び出しで実行するインタフェースです。通信は発生しません。

ローカルホームインタフェースとローカルビジネスインタフェースが含まれます。

ローカルトランザクション

接続先のリソースマネジャによって管理されるトランザクションです。単一のリソースだけがトランザクションに参加できます。

ロードバランサ

リダイレクタを使用してリクエストを振り分ける場合に使用するワーカ定義のうち，クラスタ構成の場合に使用する特殊なワーカ定義です。振り分け先のWebコンテナのリストが定義されています。リダイレクタでは，この定義を基に，ラウンドロビン方式でリクエストの振り分け処理をします。

ロール

コンテキストに対し，アクセス制御するときに使用される単位です。ロールはグループごとに定義されます。また，アクセス制御するコンテキストについては，そのコンテキストにアクセスするのに必要なロールが定義されます。アクセスしたユーザの持つロールがコンテキストに定義されたロールと一致した場合，そのコンテキストへのアクセスは成功します。

ロガー

J2EEアプリケーション，バッチアプリケーション，またはEJBクライアントアプリケーションのログを取得する，JavaロギングAPIのLoggerオブジェクトです。

ログインモジュール

JAASに準拠した統合ユーザ管理のユーザ認証に使用する，JAAS APIのLoginModuleインタフェースの実装クラスです。

論理コネクション

サーブレットやEnterprise BeanなどのJ2EEコンポーネントが直接操作するコネクションです。

リソースアダプタの場合はjavax.resource.cci.Connection，JDBCの場合はjava.sql.Connectionに該当します。

論理サーバ

Management Serverの運用管理の対象になる，サーバまたはクラスタです。サーバには，Webサーバ，J2EEサーバなどがあります。クラスタとは，ある共通の機能を提供するサーバの集合です。

論理ネーミングサービス

JNDIがラウンドロビン検索の対象にする複数のCORBAネーミングサービスのことです。

論理ユーザサーバ

任意のサービスやプロセスをManagement Serverの管理対象として定義した論理サーバです。Management Serverで起動・停止したり，ステータス監視したりできるようになります。

（ワ行）

ワーカプロセス

Webサーバの背後で動作するWebコンテナのプロセスです。リダイレクタから見た場合のWebコンテナ実行プロセスになります。具体的には，J2EEサーバまたはWebコンテナサーバに当たります。

索引

[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(数字)

1.4モード

1:1系切り替えシステム

(英字)

(Ａ)

accountの概要

Active Directoryを使用する場合の設定

add.class.path

add.class.path

add.jvm.arg

add.library.path

add.library.path

add.library.path

adderの概要

adminagent.adapter.bind_host

adminagent.adapter.bind_host

adminagent.cluster.localaddress.check

adminagent.cluster.localaddress.check

adminagent.j2ee.process.console_event.enabled

adminagent.j2ee.process.console_log.enabled

adminagent.process.consolelog.enabled

adminagent.process.consolelog.filenum

adminagent.process.consolelog.filesize

adminagent.properties

adminagent.properties

adminagent.userserver.process.console_event.enabled

adminagent.userserver.process.console_log.enabled

adminagent.xml

adminagent.xml

Application Server

Application Server

Application Serverが管理するトランザクションの外でコネクションシェアリングの有効化

Application Serverが管理するトランザクションの外でコネクションシェアリングの有効化

Application Serverのディレクトリ構成

Application Serverのディレクトリ構成（Windowsの場合）

(Ｂ)

bankの概要

batch.service.enabled

Bean-Managed Persistence

Bean-Managed Transaction

BJEX

BMP

BMT

built-inフィルタ

built-inフィルタ

built-inフィルタの組み込み手順

built-inフィルタの種類

byte型配列であるセッション情報の引き継ぎ許可

(Ｃ)

C++ライブラリのバージョン指定（Linuxの場合）

CallableStatementのプールサイズ

CallableStatementのプールサイズ

cartの概要

checkerの概要

cjclstartap

cjenvupdate

cjenvupdate

cjwebeditpool

cjwebsetup

CMP

cmp20productの概要

CMT

com.cosminexus.manager.cmdtracelog.fnum

com.cosminexus.manager.cmdtracelog.size

com.cosminexus.manager.log.compatible

com.cosminexus.manager.log.dir

com.cosminexus.manager.messagelog.fnum

com.cosminexus.manager.messagelog.size

com.cosminexus.manager.tracelog.fnum

com.cosminexus.manager.tracelog.size

com.cosminexus.mngsvr.log.level

com.cosminexus.mngsvr.log.rotate

com.cosminexus.mngsvr.log.size

com.cosminexus.mngsvr.trace

Component Container管理者

Component Container管理者

Component Container管理者が実施できる操作

Component Container管理者グループ

Component Container管理者の設定

confirmerの概要

Container-Managed Persistence

Container-Managed Transaction

Cookieスイッチング機能

CORBAネーミングサービス

coreダンプ取得の設定

Cosminexus

Cosminexus Component Container

Cosminexus Component Containerのインストール

Cosminexus Component Containerのディレクトリ構成

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library運用ディレクトリ

Cosminexus DABroker Libraryのディレクトリ構成

Cosminexus DABroker Libraryのログ取得の設定

Cosminexus Managerのログ取得の設定

Cosminexus Operator Plug-in

Cosminexus Performance Tracer

Cosminexus Reliable Messaging

Cosminexus RM

Cosminexus TPBrokerのログ取得の設定

Cosminexus Version 6およびCosminexus Version 7からの移行

Cosminexus Version 6およびCosminexus Version 7とのRMI-IIOP通信の相互接続性

Cosminexusアダプタコマンドの実行環境の設定

Cosminexusアダプタコマンドのセットアップ

Cosminexusシステム

Cosminexusでサポートしているシンボリックリンク

CosminexusのJP1/AJS2定義プログラムのインストール（Windowsの場合）

CosminexusのJP1イベント発行の設定

Cosminexusの移行の概要

Cosminexusの移行の概要

Cosminexusの移行の手順

Cosminexusの移行の手順

Cosminexusのカスタムジョブの登録（Windowsの場合）

Cosminexus標準ログインモジュール

CSCCFJ_SERVER_HOME

CTM

CTMDIR

CTMSPOOL

CTMデーモン

CTMドメイン

CTMドメインマネジャ

CTMによるリクエストのスケジューリングの設定

CTMの機能を使用するための設定

CTMレギュレータ

(Ｄ)

DataSourceオブジェクトのキャッシング

DataSourceオブジェクトのキャッシング

DB Connector

DB Connector for Cosminexus RM

DB Connectorのコンテナ管理でのサインオンの最適化

DB Connectorのコンテナ管理でのサインオンの最適化

DD

DDの見直しの観点

Dependency Injection

Developer

DIターゲット

DTD

(Ｅ)

EARファイル

EARファイルの見直し観点

ebserver.jsp.pageEncoding

EIS

EJB

ejb.server.corefilenum

ejb.server.log.directory

ejb.server.log.directory

ejb.server.log.directory

ejb.server.log.directory

ejb.server.log.directory

EJB-JARファイル

EJB-JARファイルの見直し観点

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path

ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator

ejbserver.application.userlog.Logger.<ロガー名称>.filter

ejbserver.application.userlog.Logger.<ロガー名称>.handlers

ejbserver.application.userlog.Logger.<ロガー名称>.level

ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers

ejbserver.application.userlog.loggers

ejbserver.batch.gc.watch.threshold

ejbserver.client.ctm.RequestPriority

ejbserver.client.transaction.clientName

ejbserver.client.transaction.enabled

ejbserver.connectionpool.applicationAuthentication.disabled

ejbserver.connectionpool.applicationAuthentication.disabled

ejbserver.connectionpool.association.enabled

ejbserver.connectionpool.association.enabled

ejbserver.connectionpool.association.enabledDespiteUnshareableSetting

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled

ejbserver.connector.logwriter.filenum

ejbserver.connector.logwriter.filesize

ejbserver.container.audit_trail.enabled

ejbserver.container.audit_trail.enabled

ejbserver.container.ejbhome.sessionbean.reconnect.enabled

ejbserver.container.rebindpolicy

ejbserver.container.rebindpolicy

ejbserver.container.security.disabled

ejbserver.ctm.ActivateTimeOut

ejbserver.ctm.DeactivateTimeOut

ejbserver.ctm.QueueLength

ejbserver.cui.optionalname.enabled

ejbserver.cui.optionalname.enabled

ejbserver.deploy.app.stopforcibly.disabled

ejbserver.deploy.applications.metadata_complete

ejbserver.deploy.context.check_interval

ejbserver.deploy.context.reload_scope

ejbserver.deploy.context.update.interval

ejbserver.deploy.session.work.directory

ejbserver.deploy.stub.generation.scope

ejbserver.distributedtx.ots.status.directory1

ejbserver.distributedtx.ots.status.directory1

ejbserver.distributedtx.ots.status.directory2

ejbserver.distributedtx.ots.status.directory2

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout

ejbserver.distributedtx.recovery.port

ejbserver.distributedtx.recovery.port

ejbserver.distributedtx.rollbackClientTxOnSystemException

ejbserver.distributedtx.XATransaction.enabled

ejbserver.distributedtx.XATransaction.enabled

ejbserver.ejb.timerservice.maxCallbackThreads

ejbserver.ejb.timerservice.retryCount

ejbserver.ejb.timerservice.retryInterval

ejbserver.ext.method_observation.interval

ejbserver.http.port

ejbserver.jndi.cache

ejbserver.jndi.cache

ejbserver.jndi.cache

ejbserver.jndi.cache.interval

ejbserver.jndi.cache.interval

ejbserver.jndi.cache.interval

ejbserver.jndi.cache.interval.clear.option

ejbserver.jndi.cache.interval.clear.option

ejbserver.jndi.cache.interval.clear.option

ejbserver.jndi.cache.reference

ejbserver.jndi.cache.reference

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls

ejbserver.jndi.namingservice.group.list

ejbserver.jndi.namingservice.group.list

ejbserver.jndi.request.timeout

ejbserver.jndi.request.timeout

ejbserver.jndi.request.timeout

ejbserver.jta.TransactionManager.defaultTimeOut

ejbserver.jta.TransactionManager.defaultTimeOut

ejbserver.jta.TransactionManager.defaultTimeOut

ejbserver.jta.TransactionManager.defaultTimeOut

ejbserver.jta.TransactionManager.defaultTimeOut

ejbserver.logger.channels.define.<チャネル名>.filenum

ejbserver.logger.channels.define.<チャネル名>.filenum

ejbserver.logger.channels.define.<チャネル名>.filenum

ejbserver.logger.channels.define.<チャネル名>.filenum

ejbserver.logger.channels.define.<チャネル名>.filesize

ejbserver.logger.channels.define.<チャネル名>.filesize

ejbserver.logger.channels.define.<チャネル名>.filesize

ejbserver.logger.channels.define.<チャネル名>.filesize

ejbserver.logger.enabled.*

ejbserver.logger.enabled.*

ejbserver.logger.enabled.*

ejbserver.logger.enabled.*

ejbserver.logger.enabled.*

ejbserver.manager.agent.MEventAgent.enabled

ejbserver.manager.agent.MEventAgent.enabled

ejbserver.naming.host

ejbserver.naming.host

ejbserver.naming.host

ejbserver.naming.port

ejbserver.naming.port

ejbserver.naming.port

ejbserver.naming.protocol

ejbserver.naming.startupMode

ejbserver.rmi.localinvocation.scope

ejbserver.rmi.passbyreference

ejbserver.rmi.request.timeout

ejbserver.rmi.request.timeout

ejbserver.rmi.request.timeout

ejbserver.server.j2ee.feature

ejbserver.watch.enabled

ejbserver.watch.enabled

ejbserver.webj2ee.connectionAutoClose.enabled

EJBクライアント

EJBクライアントアプリケーション

EJBクライアントアプリケーションの環境変数の設定

EJBクライアントアプリケーションのクラスパスへのJARファイルの設定

EJBクライアントアプリケーションの使用形態

EJBクライアントアプリケーションの使用形態とシステムプロパティ

EJBクライアントアプリケーションの設定と実行

EJBクライアントアプリケーションのプロパティの設定

EJBクライアントアプリケーションのログ出力の設定

EJBクライアント環境の構築（uCosminexus Client）

EJBコンテナ

EJBコンテナとの連携

EJBコンテナの機能を使用するための設定

EJBコンテナの通信ポートとIPアドレスの固定

EJBタイマ

EJBホームオブジェクトへの再接続機能

EJBホームオブジェクトリファレンスの別名付与

enrollerの概要

Enterprise Bean

Enterprise Bean（EJB2.0）のサンプル実行手順

Enterprise Bean（EJB2.0）のサンプルの概要

Enterprise Bean（EJB2.0）のサンプルプログラム

Enterprise Bean（Timer Service）のサンプルプログラム

Enterprise Bean（アノテーション）のサンプルプログラム

Enterprise Bean（アノテーション）のサンプルプログラムの実行手順

Enterprise Beanへのアクセス制御の抑止オプション

Enterprise JavaBeans

Entity Bean

Exceptionトレースログ取得の設定

(Ｈ)

HAモニタ

HAモニタ

HAモニタの環境設定

HAモニタの環境設定

HAモニタの環境設定

HAモニタの環境設定

hitachi_web.properties

hitachi_web.properties

Hitachi Web Server動作確認用URLの設定

Hitachi Web ServerのSSLによる認証，暗号化の設定

Hitachi Web ServerのSSLによる認証，暗号化の設定

Hitachi Web ServerのSSLの設定

Hitachi Web ServerのSSLの設定

Hitachi Web Serverの設定

Hitachi Web Serverの設定

Hitachi Web Serverの動作確認の設定

httpsd.conf

httpsd.conf

HttpsdCustomLogFileDir

HttpsdCustomlogFormat

HttpsdCustomMethod

HttpsdErrorLogFileDir

HttpsdErrorMethod

HttpsdRequestLogFileDir

HttpsdRequestMethod

HTTPセッション数の上限値の設定

HTTPレスポンス圧縮規則について

HTTPレスポンス圧縮フィルタ

HTTPレスポンス圧縮フィルタのWebアプリケーションへの組み込み

HTTPレスポンス圧縮フィルタの設定

HTTPレスポンスヘッダのカスタマイズの設定

HWSLogTimeVerbose

HWSRequestLogLevel

(Ｉ)

Inbound

isapi_redirect.conf

(Ｊ)

J2EE

J2EEアプリケーション

J2EEアプリケーション（コンフィグレーション関連）のディレクトリ構成

J2EEアプリケーション（デプロイ関連）のディレクトリ構成

J2EEアプリケーション実行時間の監視

J2EEアプリケーション実行時間の監視機能

J2EEアプリケーション実行時間の監視の設定

J2EEアプリケーション実行時間の監視の設定

J2EEアプリケーションの強制停止

J2EEアプリケーションの強制停止

J2EEアプリケーションの更新検知とリロード

J2EEアプリケーションの更新検知とリロードの設定

J2EEアプリケーションの設定の流れ

J2EEアプリケーションの通常停止

J2EEアプリケーションのプロパティ定義で設定できること

J2EEアプリケーションのユーザログ出力

J2EEアプリケーションを実行するシステムの構築の流れ

J2EEコンテナ

J2EEコンポーネント

J2EEサーバ

J2EEサーバ間のセッション情報の引き継ぎの設定

J2EEサーバ間のセッション情報の引き継ぎの設定の概要

J2EEサーバの移行コマンドで自動的に追加される定義

J2EEサーバの移行コマンドの実行

J2EEサーバの運用監視の設定

J2EEサーバの運用監視の設定

J2EEサーバの作業ディレクトリ

J2EEサーバの作業ディレクトリの構成

J2EEサーバの作業ディレクトリのディスク容量の確認

J2EEサーバの動作設定

J2EEサーバのログ出力

J2EEサーバのログ取得の設定

J2EEサーバモード

J2EEサービス

J2EEリソース

J2EEリソースアダプタ

J2EEリソースアダプタ

J2EEリソースアダプタ

J2EEリソースアダプタ（コンフィグレーション関連）のディレクトリ構成

J2EEリソースアダプタ（デプロイ関連）のディレクトリ構成

J2EEリソースのディレクトリ構成

J2EEリソースの別名付与

jaas.conf

jaas.confの再読み込み

jaas.confの作成

JAASのコンフィグレーションファイル

Java

java.naming.factory.initial

java.naming.factory.initial

JavaBeansリソース

JavaBeansリソースの入れ替えの流れ

JavaBeansリソースのサンプルプログラム

JavaBeansリソースの新規設定の流れ

JavaBeansリソースの設定変更の流れ

JavaBeansリソースのプロパティ定義で設定できること

Java Database Connectivity

Java Naming and Directory Interface

JavaServer Pages

JavaVMの資料取得の設定

JavaVMのスレッドダンプ取得の設定

JavaVMのスレッドダンプ取得の設定

JavaVMのヒープサイズ

JavaVMのプロパティの設定

Java実行環境の指定

JavaロギングAPI

JCAコンテナ

JDBC

JDBCドライバのトレース情報の取得

JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

JNDI

JNDI名前空間

JP1

JP1

JP1/AJS2

JP1/AJS2 - SO

JP1/Baseのイベントサーバ名の設定

JP1/Baseの構成定義の作成

JP1/Baseの構成定義の作成

JP1/Cm2/NC - Manager

JP1/Cm2/NC - Manager for Cosminexus

JP1/IM

JP1/IM - CM

JP1/NETM/Audit

JP1/SC/DPM

JP1イベント

JP1ジョブ運用管理サーバ

JP1統合運用管理サーバ

JP1との連携の設定

JSP

JSP EL

jsptagの概要

jsptobeanの概要

JSPコンパイル結果

JSPコンパイル結果の出力先の設定〔サーブレットエンジンモード〕

JSP事前コンパイル

JSPタグライブラリ

JSPタグライブラリ

JSPファイル更新用インターバル

JSPファイルのコンパイル結果の保持

JSPファイルのコンパイル結果の保持

JSPファイルのコンパイル結果の保持の設定

JSPファイルのコンパイル結果の保持の設定

JSPファイルの再コンパイルに関する設定項目と設定ファイル

JSP用一時ディレクトリのディレクトリ構成

(Ｌ)

LANの状態設定

LANの状態設定

LANの状態設定

LANの状態設定

LD_LIBRARY_PATH

LDAPディレクトリサーバの設置

LDAPディレクトリサーバの設定

LIBPATH

LimitRequestLineディレクティブ

localadderの概要

LogLevel

(Ｍ)

Management Server

Management Serverの移行コマンドの実行

Management Serverの環境設定

Management Serverの設定

Management Serverの設定情報のコピー手順

Management Serverのセットアップ

Management Serverの動作環境の設定

Managementアクション

Managementアクション

Managementアクション

Managementアクション実行コマンドの設定

Managementアクション実行用プロパティファイルの設定

Managementイベント

Managementイベント

Managementイベント

Managementイベントによる処理の自動実行

Managementイベントによる処理の自動実行

Managementイベントによる処理の自動実行の設定

Managementイベントによる処理の自動実行の設定

Managementイベントによる処理の自動実行の設定手順

Managementイベント発行機能を利用する各機能の設定

Managementイベント発行機能を利用する各機能の設定

Managementイベント発行サーバを再起動するサンプル

Managementイベント発行時の動作の設定

Managementイベント発行の設定

Managementイベント発行の有効化

Managementイベント発行用メッセージIDリストファイルの設定

Message-driven Bean

messageの概要

MIBオブジェクト

MIBファイル

Microsoft Cluster Service

Microsoft Cluster Service

Microsoft IISからHitachi Web Serverへの移行

Microsoft IISの設定

mngsvr.myhost.name

mngsvr.myhost.name

mngsvrutil

mngsvrutil.connect.host

mngsvrutil.connect.host

mngsvrutil.connect.host

mngsvrutil.connect.password

mngsvrutil.connect.password

mngsvrutil.connect.password

mngsvrutil.connect.userid

mngsvrutil.connect.userid

mngsvrutil.connect.userid

mngsvrutil.extended_keywords

mngsvrutil.output.format

mngsvrutil.target_kind

mngsvrutil.target_name

mngsvrutilコマンドの実行環境の設定

mngsvrutilコマンドの実行環境の設定

mod_jk.conf

mod_jk.conf

mserver.properties

mserver.properties

(Ｎ)

N:1リカバリシステム

N:1リカバリシステムの設定（UNIXの場合）

N:1リカバリシステムの設定（Windowsの場合）

N:1リカバリシステムの設定手順

N:1リカバリシステムの設定手順

(Ｏ)

Object Transaction Service

OpenTP1のSPP

Oracle RAC

Oracleアクセスライブラリの再作成

ORBゲートウェイ

orderの概要

OSAGENT_PORT

OSの統計情報取得の設定

OTMゲートウェイ

OTS

Outbound

(Ｐ)

PATH

Persistent Connection

Persistent Connectionによる通信制御の設定

POSTデータサイズでのリクエストの振り分けの設定

POSTデータサイズでのリクエストの振り分けの設定

PreparedStatementのプールサイズ

PreparedStatementのプールサイズ

PRFSPOOL

PrfTraceBufferSize

PrfTraceCount

PrfTraceFileSize

PrfTraceLevel

PRFデーモン

PRFトレース

PRFトレース出力ライブラリ

PRFトレース取得レベル

PRFトレースファイル

productの概要

(Ｒ)

RARファイルの見直し観点

RMI-IIOP

RMI-IIOP通信のタイムアウト

RMI-IIOP通信のタイムアウト

RMI-IIOP通信のタイムアウト

(Ｓ)

salesrepの概要

SecurityManager

SecurityManagerを使用しない設定

server.policy

server.policy

Server Plug-in

Server Plug-inの組み込み手順

Server Plug-inの設定

Server Plug-inの表示言語の変更

Server Plug-inを使用するためのManagement Serverの設定

Session Bean

SFOサーバ

SFOサーバアプリケーション

SFOサーバの設定

SFOサーバのログ取得の設定

shipperの概要

Smart Composer機能

snapshotログ

snapshotログ

snapshotログ

snapshotログ収集の設定

snapshotログ収集の設定

SNMP連携用形式ファイル

Stateful Session Bean

Stateless Session Bean

storagebinの概要

sysdef

sysdef

(Ｔ)

tellerの概要

Timer Service

Timer Service

TP1/Message Queue

TPDIR

TZ

(Ｕ)

ua.conf

ua.confの作成

uachpwコマンド

uatags.jar

uatags.tld

uCosminexus Batch Job Execution Server

uCosminexus Client

uCosminexus Client

uCosminexus Client

uCosminexus Clientのディレクトリ構成

uCosminexus Operator

uCosminexus Operator

uCosminexus Operator

uCosminexus Operatorのディレクトリ構成

uCosminexus Service Architect

uCosminexus Service Platform

uriworkermap.properties

URLパターンでのリクエスト振り分けの設定

URLパターンでのリクエスト振り分けの設定

URLパターンとHTTPレスポンス圧縮規則のマッピングについて

use.security

usrconf

usrconf.bat

usrconf.cfg

usrconf.properties

usrconf.properties

usrconf.properties

usrconf.properties

USRCONF_JVM_ARGS

USRCONF_JVM_ARGS

USRCONF_JVM_CLASSPATH

USRCONF_JVM_CLPATH

USRCONF_JVM_LIBPATH

USRCONF_JVM_LIBPATH

(Ｖ)

vbj

vbroker.agent.port

vbroker.agent.port

vbroker.orb.htc.comt.entryCount

vbroker.orb.htc.comt.entryCount

vbroker.orb.htc.comt.fileCount

vbroker.orb.htc.comt.fileCount

vbroker.orb.htc.tracePath

vbroker.orb.htc.tracePath

vbroker.orb.htc.tracePath

vbroker.orb.htc.tracePath

vbroker.se.iiop_tp.host

vbroker.se.iiop_tp.host

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

VBROKER_ADM

(Ｗ)

warehouseの概要

WARファイル

WARファイルの見直し観点

web.add.class.path

web.policy

web.server.log.directory

web.server.log.directory

web.server.log.directory

web.xml

web-users.xml

Web Redirector

Web Redirector

Web Redirectorのディレクトリ構成

webserver.connector.ajp13.bind_host

webserver.connector.ajp13.max_threads

webserver.connector.ajp13.max_threads

webserver.connector.ajp13.receive_timeout

webserver.connector.ajp13.receive_timeout

webserver.connector.ajp13.send_timeout

webserver.connector.http.bind_host

webserver.connector.http.enabled

webserver.connector.http.permitted.hosts

webserver.connector.http.permitted.hosts

webserver.connector.http.permitted.hosts

webserver.connector.http.permitted.hosts

webserver.connector.inprocess_http.backlog

webserver.connector.inprocess_http.bind_host

webserver.connector.inprocess_http.bind_host

webserver.connector.inprocess_http.enabled

webserver.connector.inprocess_http.enabled_methods

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file.content_type

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.redirect_url

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.request_url

webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.status

webserver.connector.inprocess_http.error_custom.list

webserver.connector.inprocess_http.gateway.host

webserver.connector.inprocess_http.gateway.https_scheme

webserver.connector.inprocess_http.gateway.port

webserver.connector.inprocess_http.init_threads

webserver.connector.inprocess_http.keep_start_threads

webserver.connector.inprocess_http.limit.max_headers

webserver.connector.inprocess_http.limit.max_request_body

webserver.connector.inprocess_http.limit.max_request_header

webserver.connector.inprocess_http.limit.max_request_line

webserver.connector.inprocess_http.max_connections

webserver.connector.inprocess_http.max_execute_threads

webserver.connector.inprocess_http.max_execute_threads

webserver.connector.inprocess_http.max_spare_threads

webserver.connector.inprocess_http.min_spare_threads

webserver.connector.inprocess_http.permitted.hosts

webserver.connector.inprocess_http.persistent_connection.max_connections

webserver.connector.inprocess_http.persistent_connection.max_requests

webserver.connector.inprocess_http.persistent_connection.timeout

webserver.connector.inprocess_http.receive_timeout

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.file

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.file.content_type

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.redirect_url

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.request_url

webserver.connector.inprocess_http.redirect.＜リダイレクト定義名＞.status

webserver.connector.inprocess_http.redirect.list

webserver.connector.inprocess_http.rejection_threads

webserver.connector.inprocess_http.response.header.server

webserver.connector.inprocess_http.send_timeout

webserver.connector.redirect_https.port

webserver.connector.redirect_https.port

webserver.container.server_id.enabled

webserver.container.server_id.name

webserver.container.server_id.value

webserver.container.thread_control.enabled

webserver.container.thread_control.queue_size

webserver.context.check_interval

webserver.context.reload_delay_timeout

webserver.context.update.interval

webserver.http.request.encoding

webserver.http.response.encoding

webserver.jsp.check_interval

webserver.jsp.compile.backcompat

webserver.jsp.keepgenerated

webserver.jsp.precompile.jsp_work_dir

webserver.jsp.translation.backcompat.customAction.declareVariable

webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue

webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate

webserver.jsp.translation.backcompat.taglib.noCheckPrefix

webserver.jsp.translation.backcompat.useBean.noCheckClass

webserver.jsp.update.interval

webserver.logger.access_log.<フォーマット名>

webserver.logger.access_log.format_list

webserver.logger.access_log.inprocess_http.enabled

webserver.logger.access_log.inprocess_http.filename

webserver.logger.access_log.inprocess_http.filenum

webserver.logger.access_log.inprocess_http.filesize

webserver.logger.access_log.inprocess_http.usage_format

webserver.logger.communication_trace.inprocess_http.filenum

webserver.logger.thread_trace.inprocess_http.filenum

webserver.session.server_id.enabled

webserver.session.server_id.value

webserver.static_content.cache.enabled

webserver.static_content.cache.filesize.threshold

webserver.static_content.cache.size

webserver.static_content.encoding.extension

webserver.work.clean

webserver.work.clean

webserver.work.clean

webserver.work.directory

webserver.work.directory

webserver.xml.validate

webserver.xml.validate

Webアプリケーション

Webアプリケーション（JSP関連）のディレクトリ構成

Webアプリケーション（その他）のディレクトリ構成

Webアプリケーションのアンデプロイ

Webアプリケーションのサンプルプログラム

Webアプリケーションの設定情報の削除

Webアプリケーションのディレクトリ構成

Webアプリケーションのデプロイ

Webアプリケーションのユーザログ出力

Webアプリケーションのユーザログ出力の設定

Webクライアントからのアクセス制御の設定

Webクライアントからの接続数とリクエスト処理スレッド数の制御の設定

Webクライアントからの接続数の制御の設定

Webクライアントからの同時接続数の制御の設定

Webクライアントとの通信制御の設定

Webクライアントへのレスポンスのカスタマイズ

Webコンテナ

Webコンテナサーバ

Webコンテナサーバの作業ディレクトリ

Webコンテナサーバのセットアップ

Webコンテナサーバの動作設定のカスタマイズ

Webコンテナサーバのログ取得の設定

Webコンテナ単位での同時実行スレッド数の制御

Webコンテナにゲートウェイ情報を通知するための設定

Webコンテナにゲートウェイ情報を通知するための設定

Webコンテナにゲートウェイ情報を通知するための設定

Webコンテナの機能を使用するためのJ2EEアプリケーションの設定

Webコンテナの通信タイムアウト

Webコンテナの通信タイムアウト

Webサーバ

Webサーバで使用するホストの固定

Webサーバとの連携の設定（J2EEアプリケーションを実行するシステム）

Webサーバとの連携の設定（Webリダイレクタ環境の場合）

Webサーバのログ取得の設定

Webサーバ連携

Webシステム

Webシステム

Webシステム

Webリダイレクタ環境の構築（Web Redirector）

Windows Vista使用時の注意事項

workers.properties

workers.properties

(ア行)

(あ)

アーカイブ形式

アウトプロセス

アクセスを許可するホストの制限の設定

アセンブル

アップグレード時のHitachi Web Serverの設定

アップグレード時のHitachi Web Serverの設定

アノテーション

アノテーションの参照を抑止する設定

アプリケーションサーバ

アプリケーションサーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

アプリケーションサーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

アプリケーションサーバを対象にした1:1系切り替えシステムの設定手順

アプリケーションの更新検知とリロードの設定

アプリケーションのユーザログ出力の設定

アプリケーションのユーザログ出力例

アプレット

アンインストール方法

暗号鍵ファイルの作成

暗号鍵ファイルの作成（シングルサインオンを使用する場合）

暗号鍵ファイルの変更

(い)

移行コマンドで作成されたバックアップの削除

移行前の確認

一次送付資料

イベントリスナ

インストールとアンインストール

インストールと初期設定

インストールと初期設定の流れ

インストール方法

インプロセス

インプロセスHTTPサーバ

インプロセスHTTPサーバ

インプロセスHTTPサーバのIPアドレスの設定

インプロセスHTTPサーバのアクセスログのカスタマイズ

インプロセスHTTPサーバの通信タイムアウトの設定

インプロセスHTTPサーバのログ取得の設定

インプロセストランザクションサービスへの移行

(う)

運用監視エージェント

運用管理エージェント

運用管理エージェントによる論理サーバの監視に関する設定

運用管理コマンド

運用管理サーバ

運用管理サーバモデル

運用管理サーバを対象にした1:1系切り替えシステムの設定（UNIXの場合）

運用管理サーバを対象にした1:1系切り替えシステムの設定（Windowsの場合）

運用管理サーバを対象にした1:1系切り替えシステムの設定手順

運用管理サーバを対象にした1:1系切り替えシステムの設定手順

運用管理ドメイン

運用管理ドメイン

運用管理ドメイン

運用管理ポータル

運用管理ポリシー

(え)

エラーページのカスタマイズ

エラーページのカスタマイズの設定

エラーページのカスタマイズの設定

エラーページのカスタマイズの設定

(お)

オブジェクトクラスとユーザ定義属性の拡張

(カ行)

(か)

ガーベージコレクション制御機能

拡張MIBオブジェクト定義ファイルの登録

拡張スレッドダンプ

拡張スレッドダンプ

カスタムジョブ

カスタムジョブ

カスタムログインモジュール

仮想サーバ

稼働状況監視のサンプリング時間の設定

稼働情報収集機能

稼働情報収集機能

稼働情報収集機能

稼働情報ファイル

稼働情報ファイル

稼働情報ファイルの取得とイベント発行の設定

稼働情報ファイルの取得とイベント発行の設定

稼働性能監視の設定

簡易Webサーバ

簡易Webサーバ機能を使用するかどうかの設定

簡易Webサーバへのアクセス許可

簡易構築定義ファイル

簡易構築定義ファイル

環境変数の設定

監査証跡

監査ログ

監査ログ出力の設定

監査ログの収集／一元管理（JP1/NETM/Auditとの連携）

監査ログの収集／一元管理の設定

監視ツリー

監視ツリーの自動生成

監視ツリーの自動生成の設定

管理機能用のWebアプリケーション

管理者特権で実行する必要がある操作

管理対象オブジェクト（AdminObject）

管理用サーバ

(き)

機能レイヤ

旧バージョンからの仕様変更の確認

旧バージョンからの仕様変更の確認

業務指向ツリー

業務処理プログラム

共有スレッド数

(く)

クライアントアプリケーション情報

クライアント証明書と認証局（CA）の証明書の取得

クライアント証明書と認証局（CA）の証明書の取得

クライアント認証の設定

クライアント認証の設定

クラスタ

クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタアドミニストレータでのクラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタサーバの環境設定

クラスタソフトウェア

グローバルCORBAネーミングサービス

グローバルセッション

グローバルセッションID

グローバルセッションIDの送信に使用するCookieの名称

グローバルセッションIDの送信に使用するURLのパスパラメタ名

グローバルセッション情報

グローバルセッション情報

グローバルセッション情報として指定できるセッション情報

グローバルセッション情報として指定できるセッション情報のデータ型

グローバルセッション情報の最大サイズ

グローバルセッション情報の種別

グローバルセッション情報のロック待ちタイムアウト

グローバルセッション情報を格納するSFOサーバの名称

グローバルセッションの制御方法

グローバルトランザクション

(け)

系

系

計画系切り替え

系切り替え

系障害

ゲートウェイ指定機能

現用系

現用系

現用系から予備系へのManagement Serverの設定情報のコピー

現用系から予備系へのManagement Serverの設定情報のコピー

(こ)

更新検知のインターバル

更新検知のインターバル

構築済み実行環境の切り替え手順

構築済み実行環境を切り替えるための準備

構築する環境の概要

コネクションアソシエーション

コネクションアソシエーション

コネクション管理スレッド

コネクション管理スレッド

コネクション枯渇時のコネクション取得待ち

コネクション枯渇時のコネクション取得待ち

コネクションシェアリング

コネクションスイーパ

コネクションスイーパ

コネクションスイーパ

コネクション数調節機能

コネクション数調節機能

コネクションの最小値と最大値

コネクションの最小値と最大値

コネクションの自動クローズ

コネクションの取得リトライ

コネクションの取得リトライ

コネクションの障害検知

コネクションの障害検知

コネクションプーリング

コネクションプーリングの設定

コネクションプールのウォーミングアップ

コネクションプールのウォーミングアップ

コマンドによる登録

コマンドによる登録

コミットオプション

コンソールログの取得の設定

コンテキスト

コンテキストルート

コンテナ拡張ライブラリ

コンテナ拡張ライブラリ

コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリを使用するための設定

コンフィグレーションファイルの作成

コンフィグレーションファイルの設定例

(サ行)

(さ)

サーバ管理コマンド

サーバ管理コマンドでのアーカイブ形式のJ2EEアプリケーションの作成

サーバ管理コマンドによるサンプル実行環境の構築，運用手順

サーバ管理コマンドの動作設定のカスタマイズ

サーバ起動・停止フック機能

サーバ指向ツリー

サーバ対応の環境設定

サーバ対応の環境設定

サーバ対応の環境設定

サーバ対応の環境設定

サーバマネジャからServer Plug-inへの移行

サービス閉塞

サービスユニット

サーブレット

サーブレットエンジンモード

サーブレットエンジンモードでのシステム構築

サーブレットエンジンモードの移行情報

サーブレットエンジンモードの利用（互換用機能）

サーブレットフィルタ

サーブレットフィルタの組み込み

再コンパイル機能を使用するための設定

再コンパイルに関する設定

作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式

サブディレクトリ共有モード

サブディレクトリ専有モード

サンプルプログラム一覧（Enterprise Beanの種類と動作内容）

サンプルプログラムで使用するJMSの設定

サンプルプログラムで使用するデータベースの設定

サンプルプログラムで使用するメールの設定

サンプルプログラムのクライアントの種類

(し)

シェルスクリプトファイルの作成

システム内に複数のSFOサーバを配置する場合の設定例

システムの可用性を高める設定

システムの起動と停止の設定

システムの構成定義

システムの構成定義

システムの自動運転の設定（JP1/AJS2，JP1/AJS2 - SOとの連携）

システムの集中監視および構成情報の定義・管理の設定（JP1/IMとの連携）

システムモニタの設定内容

システム例外発生時のクライアントトランザクションの動作

システムログの出力先や出力レベルの変更

実行環境に対するGUI操作環境の構築（uCosminexus Operator）

実行系

実行系

実行系の汎用スクリプトファイルの関数

実行系の汎用スクリプトファイルの作成

実行系の汎用スクリプトファイルの変数

実行待ちキュー

実パラメタ

自動系切り替え

シナリオ

手動による定義などの修正

障害監視の設定

障害検知時コマンド

障害検知時コマンド

障害検知時コマンドによる資料取得の設定

障害検知時コマンドによる資料取得の設定

ジョブ

ジョブによるシステムの自動運転の設定

ジョブネット

ジョブの定義

シングルサインオン

シングルサインオン情報リポジトリ

シングルサインオンライブラリ

(す)

推奨機能への移行

スケールアウト

スケールイン

スケジュールキュー

スケジュールの定義

スケジュールポリシー

ステータスファイルの格納ディレクトリ

ステートメントキャンセル

ステートメントキャンセル

スマートエージェント

スマートエージェントが使用する通信ポート

(せ)

静的コンテンツ

静的コンテンツのキャッシュ

静的コンテンツのキャッシュ

静的コンテンツのキャッシュの設定

性能解析トレース

性能解析トレースファイル

製品の導入手順

セキュリティアイデンティティ

セキュリティアイデンティティ

セキュリティ管理

セキュリティポリシーの設定

セッション

セッション管理

セッション情報の引き継ぎを行うJ2EEサーバの設定

セッション情報の引き継ぎを行うWebアプリケーションの設定変更

セッション情報ファイル

セッションフェイルオーバ機能

セッションフェイルオーバ機能

セッションフェイルオーバサーバ

セッションフェイルオーバ用フィルタ

セッションフェイルオーバ用フィルタのWebアプリケーションへの組み込み

セッションフェイルオーバ用フィルタの設定

セットアップウィザード

占有スレッド数

占有スレッド数

占有スレッド数

(そ)

相互系切り替えシステム

相互系切り替えシステムの設定（UNIXの場合）

相互系切り替えシステムの設定（Windowsの場合）

相互系切り替えシステムの設定手順

相互系切り替えシステムの設定手順

相互スタンバイ

相互スタンバイ構成

相互スタンバイ構成

属性ファイルの記述例

(タ行)

(た)

待機系

待機系

待機系の汎用スクリプトファイルの関数

待機系の汎用スクリプトファイルの作成

待機系の汎用スクリプトファイルの変数

(ち)

抽象パラメタ

直列化可能クラスのオブジェクトであるセッション情報の引き継ぎ許可

(つ)

通常モード

通信タイムアウトの設定

通信タイムアウトの設定

通信路の暗号化レベルの要請

通信路の暗号化レベルの要請

(て)

定義などのバックアップ

データソース

データソースの設定

データベース監査証跡との連携の設定

データベース監査証跡連携機能

データベースコネクション確立までの待ち時間

データベースコネクション確立までの待ち時間

テストモード

テストモードでのJ2EEアプリケーションの設定の流れ

デプロイ

展開ディレクトリ形式

展開ディレクトリ形式のJ2EEアプリケーション

展開ディレクトリ形式のJ2EEアプリケーションの設定

(と)

統合コンソール

統合スコープ

統合ネーミングスケジューラサーバ

統合ネーミングスケジューラサーバモデル

統合ユーザ管理

統合ユーザ管理GUI

統合ユーザ管理機能の設定

統合ユーザ管理のコンフィグレーションファイル

統合ユーザ管理フレームワーク

統合ユーザ管理フレームワークのライブラリによる登録

統合ユーザ管理フレームワークのライブラリによる登録

統合ログ

動作確認用HTTPメソッドの設定

動作モード

同時実行スレッド数設定の指針

同時実行スレッド数の制御の設定

同時実行スレッド数の制御の設定

動的コンテンツ

登録するユーザ情報の文法

登録するユーザ情報の文法

ドメイン名指定でトップページを表示するための設定

ドメイン名指定でトップページを表示するための設定

ドメイン名指定でのトップページの表示

トランザクションサービス

トランザクションサポートレベル

トランザクションサポートレベル

トランザクションタイムアウト

トランザクションタイムアウト（J2EEサーバ単位）

トランザクションタイムアウト（バッチサーバ単位）

トランザクションの種類

トランザクションのタイムアウト

トランザクションのタイムアウト

トランザクションのリカバリ

トランザクションマネジャ

トレース取得ポイント

(ナ行)

(に)

二次送付資料

(ね)

ネーミング管理の機能を使用するための設定

ネーミング切り替え

ネーミングサービス

ネーミングサービスの通信タイムアウト

ネーミングサービスの通信タイムアウト

ネーミングサービスの通信タイムアウト

ネーミングのキャッシング

ネーミングのキャッシング

ネーミングのキャッシング

(ハ行)

(は)

バインド先アドレス設定機能

バインド先アドレス設定機能

バッチアプリケーション

バッチアプリケーションを実行するシステムの構築の流れ

バッチサーバ

バッチサーバで設定できる主な項目

バッチサーバとしてサーバを構築するための設定

バッチサーバの作業ディレクトリ

バッチサーバの作業ディレクトリの構成

バッチサーバの通信ポートとIPアドレスの固定

バッチサーバの動作設定として必ず設定する項目

バッチサーバの動作設定として必要に応じて設定する項目

バッチサーバの動作設定の方法

バッチサーバのログ取得の設定

パフォーマンストレーサ

ハンドラ

汎用スクリプトファイルの関数

汎用スクリプトファイルの関数

汎用スクリプトファイルの関数

汎用スクリプトファイルの作成

汎用スクリプトファイルの作成

汎用スクリプトファイルの作成

汎用スクリプトファイルの変数

汎用スクリプトファイルの変数

汎用スクリプトファイルの変数

汎用スクリプトファイルの例

(ひ)

ビジネスインタフェース

日立JavaVMログファイル

日立JavaVMログファイル

日立固有のJavaVMログ取得の設定

日立固有のJavaVMログ取得の設定

日立トレース共通ライブラリ

日立トレース共通ライブラリ

日立トレース共通ライブラリ

日立トレース共通ライブラリ

日立トレース共通ライブラリ形式

日立トレース共通ライブラリ形式

日立トレース共通ライブラリ形式

非保護区

秘密鍵の作成と認証局が発行した証明書の取得

秘密鍵の作成と認証局が発行した証明書の取得

(ふ)

ファイルのデプロイ

フィルタの追加

フィルタのマッピング

プール管理情報設定ファイル

負荷分散機

複数の構築済み実行環境を切り替えるための設定

物理コネクション

物理ティア

プライベートプロパティの設定

フロントEJB

フロントEJB

(へ)

ベーシックモード

ベーシックモードの設定

ベーシックモードの利用（互換用機能）

別名

(ほ)

ほかの構成ソフトウェアのインストール

保護区

ホスト単位管理モデル

(マ行)

(み)

未決着トランザクション

未決着トランザクションの確認時間のタイムアウト

(め)

メールコンフィグレーション

メソッドキャンセル機能

メソッドタイムアウト機能

メッセージインフロー

面数

メンバリソースアダプタ

(ヤ行)

(ゆ)

有効なHTTPメソッドの制限の設定

ユーザJP1イベントの推奨設定

ユーザ指定名前空間機能

ユーザ指定名前空間機能

ユーザ指定名前空間機能

ユーザ指定名前空間機能

ユーザ情報

ユーザ情報の登録

ユーザ情報の登録（シングルサインオンを使用する場合）

ユーザ情報リポジトリ

ユーザスレッド

ユーザスレッド

ユーザスレッド生成のための権限

ユーザスレッド生成のための権限の設定

ユーザダンプ取得の設定

ユーザ認証ライブラリ

ユーザの登録とアクセス権の設定

ユーザプロパティファイル

ユーザプロパティファイル

ユーザマッピング

ユーザログ

ユーザログ

ユーザログ機能のサンプルプログラム

(よ)

予備系

予備系

(ラ行)

(ら)

ライトトランザクション

ライトトランザクション機能を有効にするための設定

ライブラリJAR

ラウンドロビン検索

ラウンドロビン検索

ラウンドロビン検索

ラウンドロビン方式でのリクエスト振り分けの設定

ラウンドロビン方式でのリクエスト振り分けの設定

ラウンドロビンポリシー

ランタイム属性

(り)

リカバリ専用サーバ

リカバリ専用サーバ

リカバリ専用サーバ

リクエスト処理スレッド

リクエスト処理スレッド数の制御の設定

リクエスト送受信時の通信タイムアウトの設定

リクエスト送受信時の通信タイムアウトの設定

リクエストデータのサイズ制限の設定

リクエストのスケジューリング

リクエストの流量制御の設定

リクエストラインの最大サイズの設定

リソースアダプタ

リソースアダプタ

リソースアダプタの移行コマンドの実行

リソースアダプタの種類

リソースアダプタの種類

リソースアダプタの新規設定の流れ

リソースアダプタの設定

リソースアダプタの設定の流れ

リソースアダプタの設定の流れ（J2EEリソースアダプタとしてデプロイして使用する場合）

リソースアダプタのプロパティ定義で設定できること

リソースアダプタのプロパティ定義で設定できること

リソースアダプタのログ取得の設定

リソースグループの設定

リソース更新用インターバル

リソース枯渇監視機能

リソース枯渇監視機能

リソース枯渇監視機能の有効化

リソース枯渇監視機能の有効化

リソース枯渇監視の設定

リソース枯渇監視の設定

リソース枯渇監視の設定

リソース種別ごとのManagementイベント発行の設定

リソース種別ごとのManagementイベント発行の設定

リソース接続とトランザクション管理の機能を使用するための設定

リソース設定の概要

リソースとJ2EEアプリケーションの設定の注意事項

リソースの設定の概要

リソースの見積もりと設定

リソースマネジャ

リダイレクタ

リダイレクタのログ取得の設定

リダイレクタのログ取得の設定

リダイレクタを使用したリクエストの振り分けの設定

リダイレクタを使用したリクエストの振り分けの設定

リダイレクトによるリクエストの振り分けの設定

リデプロイ機能

リバースプロキシサーバ

リモートインタフェース

リモートインタフェースでの通信障害発生時のEJBクライアントの動作

リモートインタフェースでの通信障害発生時のEJBクライアントの動作

リモートインタフェースの参照渡し機能

リロード機能

リロード機能を使用するための設定

リロード時のセッション引き継ぎ

リロード遅延実行

リロードに関する設定項目と設定ファイル

(る)

ルートアプリケーション情報

ルートコンテキスト

ルートリソースアダプタ

ルックアップ名称の別名

ルックアップ名称の別名

(れ)

レスポンス送受信時の通信タイムアウトの設定

レスポンス送受信時の通信タイムアウトの設定

レルム

レルム名の決定

(ろ)

ローカルインタフェース

ローカルトランザクション

ローカル呼び出し最適化機能の範囲

ロードバランサ

ロール

ロガー

ログインモジュール

ログサイズの変更

ログサイズの変更

ログサイズの変更

ログ出力先のサブディレクトリ数の管理

ログの出力先の変更

ログの出力先の変更

ログの出力先の変更

ログの出力先や出力レベルの変更

ログレベルの変更

ログレベルの変更

ログレベルの変更

ログレベルの変更

論理コネクション

論理サーバ

論理サーバの動作確認間隔の設定

論理サーバの動作確認タイムアウトの設定

論理サーバの動作確認の開始時間の設定

論理サーバの動作確認リトライの設定

論理サーバの動作確認レベルの設定

論理ネーミングサービス

論理ユーザサーバ

(ワ行)

(わ)

ワーカプロセス

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model　Driven　Architectureは，Object Management Group,Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle8iは，米国Oracle Corporationの商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SecureWayは，米国における米国International Business Machines Corp.の登録商標です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。