Cosminexus　簡易構築・運用ガイド

手引・文法・操作書

3020-3-M05-60

目　　次

前書き

変更内容

はじめに

第1編　システム構築の概要

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

1.1　構築するシステムの概要

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

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

1.2　セットアップウィザードの概要

1.2.1　セットアップウィザードの目的

1.2.2　セットアップウィザードの利点

1.2.3　セットアップウィザードを使用したシステムのセットアップの流れ

1.3　Smart Composer機能の概要

1.3.1　Smart Composer機能の目的

1.3.2　Smart Composer機能の利点

1.3.3　ほかのプログラムとの連携

1.3.4　Smart Composer機能を使用したシステム構築の作業の流れ

1.4　Windows Vista使用時の注意事項

第2編　セットアップウィザードを使用したシステムのセットアップと運用

2.　セットアップウィザードを使用したシステムのセットアップ

2.1　システムをセットアップする前に

2.1.1　システム構成とセットアップ方法の決定

2.1.2　インストール

2.1.3　セットアップウィザードを使用する前に

2.2　システムのセットアップ

2.2.1　システムのセットアップの流れ

2.2.2　セットアップウィザードの起動

2.2.3　セットアップの開始

2.2.4　セットアップ方法の選択

2.2.5　運用管理ユーザの設定

2.2.6　運用管理機能の設定

2.2.7　J2EEサーバの起動ユーザの設定

2.2.8　システム構成の選択

2.2.9　システム環境の設定

2.2.10　データベース接続環境の設定

2.2.11　セットアップ情報の確認

2.2.12　セットアップの実行

2.2.13　セットアップウィザードの終了

2.2.14　J2EEアプリケーションのインポートと開始

2.2.15　セットアップ情報ファイルを使用した一括セットアップ

2.2.16　アンセットアップ要求

2.2.17　セットアップウィザードで設定できる項目

2.3　システムの運用

2.3.1　セットアップウィザードでセットアップしたシステムの起動と停止

2.3.2　チューニング

2.3.3　システムのアンセットアップ

3.　セットアップウィザードで使用するコマンドとファイル

3.1　setupwizardコマンド（システムのセットアップとアンセットアップ）

setupwizardコマンド

3.2　セットアップウィザードで出力されるファイル

第3編　Smart Composer機能を使用したシステムの構築と運用

4.　J2EEアプリケーションを実行するシステムの構成の検討

4.1　システムの構成

4.2　製品構成およびプロセス構成

4.2.1　Webフロントシステムの製品構成とプロセス構成

4.2.2　バックシステムの製品構成とプロセス構成

4.3　システム構成パターン

4.3.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成

4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成

4.3.3　インプロセスHTTPサーバ機能を使用する構成

4.3.4　負荷分散機を冗長化する構成

4.3.5　セッションフェイルオーバ機能を使用する構成

4.3.6　CTMを使用する構成

4.3.7　サーバマシン内に複数のサービスユニットを配置する構成

4.3.8　論理ユーザサーバを使用する構成

4.4　JP1/SC/DPMを利用して構築する場合のシステム構成

5.　J2EEアプリケーションを実行するシステムを構築する前に

5.1　使用リソースの見積もり

5.1.1　Windowsの場合

5.1.2　AIXの場合

5.1.3　HP-UXの場合

5.1.4　Linuxの場合

5.1.5　Solarisの場合

5.1.6　仮想メモリの使用量の見積もり

5.1.7　セッションフェイルオーバ機能使用時の見積もり

5.2　運用・障害設計

5.2.1　Cosminexusのシステムでできる運用作業

5.2.2　運用設計

5.2.3　障害設計

5.3　簡易構築定義ファイルの運用方法

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

6.1　システム構築の概要

6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例

6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ

6.2　インストール

6.3　負荷分散機の設定

6.3.1　BIG-IP 1500の場合

6.3.2　BIG-IP 1000の場合

6.3.3　Loadflowbalの場合

6.4　ホスティング環境の設定

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

6.5.1　環境変数の設定

6.5.2　データベースを使用するための設定

6.5.3　運用管理エージェントの設定

6.6　運用管理サーバの設定

6.6.1　環境変数の設定

6.6.2　Management Serverの設定

6.7　Cosminexusから負荷分散機を制御するための設定

6.7.1　ssh接続を利用する負荷分散機への接続の設定

6.7.2　Telnet接続を利用する負荷分散機への接続の設定

6.8　システムの構成定義

6.8.1　簡易構築定義ファイルの設定内容

6.8.2　テンプレートファイル

6.8.3　簡易構築定義ファイルの作成例

6.9　DB ConnectorのConnector属性ファイルの編集

6.10　システムの一括構築

6.11　システムの一括起動

6.11.1　システムの一括起動（READY）

6.11.2　リソースアダプタのインポートと開始

6.11.3　J2EEアプリケーションのインポートと開始

6.11.4　サービスユニットの開始

6.12　チューニング

6.12.1　簡易構築定義ファイルのパラメタだけを編集する場合のチューニング

6.12.2　リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニング

6.13　インプロセスHTTPサーバ機能を使用する場合に必要な設定

6.13.1　簡易構築定義ファイルの作成

6.14　負荷分散機を冗長化する場合に必要な設定

6.14.1　Cosminexusから負荷分散機を制御するための設定

6.14.2　簡易構築定義ファイルの作成

6.15　セッションフェイルオーバ機能を使用する場合に必要な設定

6.15.1　インストール

6.15.2　ホスティング環境の設定

6.15.3　セッションフェイルオーバサーバの設定

6.15.4　簡易構築定義ファイルの作成

6.16　CTMを使用する場合に必要な設定

6.16.1　インストール

6.16.2　ホスティング環境の設定

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

6.16.4　統合ネーミングスケジューラサーバの設定

6.16.5　運用管理サーバの設定

6.16.6　簡易構築定義ファイルの作成

6.17　サーバマシン内に複数のサービスユニットを配置する場合に必要な設定

6.17.1　簡易構築定義ファイルの作成

6.18　論理ユーザサーバを使用する場合に必要な設定

6.18.1　簡易構築定義ファイルの作成

6.19　障害に対応したシステムの構築

6.19.1　障害発生時にサービスユニットを自動閉塞するための設定

6.19.2　サービスユニットを自動再起動するための設定

7.　J2EEアプリケーションを実行するシステムの運用

7.1　システム運用の概要

7.2　日常運用の操作

7.2.1　すべてのサービスユニットの一括起動と一括停止

7.2.2　サービスユニット単位の一括起動と一括停止

7.3　システムのメンテナンス

7.3.1　サービスユニットの閉塞によるシステムの部分メンテナンス

7.3.2　J2EEアプリケーションの入れ替え

7.4　システム全体の設定変更

7.4.1　システムの設定の一括変更

7.4.2　システム全体の設定変更時の注意事項

7.5　システムのスケールアウト

7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト

7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト

7.5.3　CTMを使用したシステムのスケールアウト

7.5.4　論理ユーザサーバを使用したシステムのスケールアウト

7.6　システムのスケールイン

7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン

7.6.2　セッションフェイルオーバ機能を使用したシステムのスケールイン

7.7　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

7.7.1　運用管理サーバモデルでのシステムのスケールアウト

7.7.2　ホスト単位管理モデルでのシステムのスケールアウト

7.7.3　JP1/SC/DPMを利用して構築したシステムのスケールイン

7.8　構築済みのシステムの移行

7.8.1　構築済みのシステムの移行手順

7.8.2　構築済みのシステムの移行時に出力する簡易構築定義ファイルの内容

7.8.3　構築済みのシステムを移行するときの注意事項

7.9　システムの削除

7.10　トラブルへの対処

7.10.1　トラブルの種別と対処

7.10.2　負荷分散機の冗長化構成でトラブルが発生した場合の対処

8.　バッチアプリケーションを実行するシステムの構成の検討

8.1　バッチアプリケーションを実行するシステムの構成

8.2　製品構成およびプロセス構成

8.3　バッチアプリケーションを実行するシステムの構成パターン

8.3.1　1台のサーバマシンに一つのサービスユニットを配置する構成

8.3.2　サーバマシン内に複数のサービスユニットを配置する構成

9.　バッチアプリケーションを実行するシステムを構築する前に

9.1　使用リソースの見積もり

9.1.1　Windowsの場合

9.1.2　AIXの場合

9.1.3　HP-UXの場合

9.1.4　Linuxの場合

9.1.5　Solarisの場合

9.1.6　仮想メモリの使用量の見積もり

9.2　運用・障害設計

9.2.1　Cosminexusのシステムでできる運用作業

9.2.2　運用設計

9.2.3　障害設計

9.3　簡易構築定義ファイルの運用方法

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

10.1　システム構築の概要

10.1.1　コマンドとシステム構築の関係

10.1.2　バッチサーバを配置する構成のシステムの構築例

10.1.3　バッチサーバを配置する構成のシステムを構築する流れ

10.2　インストール

10.3　ホスティング環境の設定

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

10.5　システムの構成定義

10.5.1　簡易構築定義ファイルの設定内容

10.5.2　簡易構築定義ファイルの作成例

10.6　DB ConnectorのConnector属性ファイルの編集

10.7　システムの一括構築

10.8　システムの開始

10.8.1　システムの一括起動

10.8.2　リソースアダプタのインポートと開始

10.9　チューニング

10.10　障害に対応したシステムの構築

10.10.1　サービスユニットを自動再起動するための設定

11.　バッチアプリケーションを実行するシステムの運用

11.1　システム運用の概要

11.2　日常運用の操作

11.2.1　すべてのサービスユニットの一括起動と一括停止

11.2.2　サービスユニット単位の一括起動と一括停止

11.3　システム全体の設定変更

11.3.1　システムの設定の一括変更

11.4　システムのスケールアウトとスケールイン

11.4.1　システムのスケールアウト

11.4.2　システムのスケールイン

11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

11.6　構築済みのシステムの移行

11.7　トラブルへの対処

11.8　システムの削除

12.　コマンド

12.1　コマンドの概要

12.1.1　コマンドの入力形式

12.1.2　コマンドの文法の記述形式

12.1.3　コマンドの使用について

12.1.4　バッチアプリケーションを実行するシステムの場合

12.2　コマンドの一覧

12.3　コマンドの詳細

cmx_add_serverref

cmx_admin_passwd

cmx_build_model

cmx_build_system

cmx_change_model

cmx_define_application

cmx_define_resource

cmx_delete_serverref

cmx_delete_system

cmx_deploy_application

cmx_deploy_resource

cmx_export_model

cmx_list_model

cmx_list_status

cmx_register_application

cmx_register_resource

cmx_resume_lb

cmx_scaleout_host

cmx_start_application

cmx_start_resource

cmx_start_target

cmx_stop_application

cmx_stop_resource

cmx_stop_target

cmx_test_lb

cmx_trans_param

cmx_undefine_application

cmx_undefine_resource

cmx_undeploy_application

cmx_undeploy_resource

cmx_unregister_application

cmx_unregister_resource

13.　ファイル

13.1　ファイルの概要

13.1.1　ファイルの文法の記述形式

13.2　ファイルの一覧

13.3　cmxserver.properties（サーバ設定プロパティファイル）

13.4　.cmxrc（クライアント設定プロパティファイル）

13.5　cmxclient.properties（クライアント共通設定プロパティファイル）

13.6　lb.properties（負荷分散機定義プロパティファイル）

13.7　簡易構築定義ファイル

13.8　構成変更定義ファイル

13.9　論理サーバ参照定義ファイル

13.10　スケールアウト用ホスト定義ファイル

14.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ

14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ

14.1.1　J2EEアプリケーションを実行するシステムで指定できるタグ

14.1.2　バッチアプリケーションを実行するシステムで指定できるタグ

14.2　システムの構成パターンと定義する論理サーバ

14.2.1　J2EEアプリケーションを実行するシステムを構築する場合

14.2.2　バッチアプリケーションを実行するシステムを構築する場合

14.3　各論理サーバ共通で指定できるパラメタ

14.3.1　論理サーバ共通で指定できるパラメタ

14.3.2　論理サーバにデフォルトで設定されている環境変数

14.4　論理Webサーバで指定できるパラメタ

14.4.1　Webサーバ用定義を設定するパラメタ

14.4.2　Hitachi Web Server用リダイレクタ動作定義を設定するパラメタ

14.4.3　ワーカ定義を設定するパラメタ

14.4.4　Hitachi Web Serverのログの出力方法を設定するパラメタ

14.5　論理J2EEサーバで指定できるパラメタ

14.5.1　J2EEサーバ用ユーザプロパティを設定するパラメタ

14.5.2　J2EEサーバ用オプション定義を設定するパラメタ

14.5.3　J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.5.4　J2EEサーバの拡張パラメタ

14.5.5　バッチサーバ用ユーザプロパティを設定するパラメタ

14.5.6　バッチサーバ用オプション定義を設定するパラメタ

14.5.7　バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.5.8　バッチサーバの拡張パラメタ

14.5.9　運用監視エージェントプロパティを設定するパラメタ

14.5.10　Managementイベント発行用プロパティを設定するパラメタ

14.5.11　JP1連携を設定するパラメタ

14.5.12　SecurityManagerの使用を設定するパラメタ

14.6　論理パフォーマンストレーサで指定できるパラメタ

14.7　論理SFOサーバで指定できるパラメタ

14.7.1　SFOサーバ用ユーザプロパティを設定するパラメタ

14.7.2　SFOサーバ用オプション定義を設定するパラメタ

14.7.3　SFOサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.7.4　SFOサーバの拡張パラメタ

14.7.5　運用監視エージェントプロパティを設定するパラメタ

14.7.6　Managementイベント発行用プロパティを設定するパラメタ

14.7.7　JP1連携を設定するパラメタ

14.8　論理CTMドメインマネジャで指定できるパラメタ

14.9　論理CTMで指定できるパラメタ

14.10　論理スマートエージェントで指定できるパラメタ

14.11　論理ユーザサーバで指定できるパラメタ

14.12　論理ネーミングサービスで指定できるパラメタ

15.　JP1と連携したSmart Composer機能でのシステム構築・運用

15.1　JP1と連携したシステム構築・運用の概要

15.1.1　JP1/IM - CMを使用したシステムの構築・運用

15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用

15.2　JP1/IM - CMと連携したシステム構築の流れ

15.3　JP1/IM - CMと連携するための設定

15.3.1　運用管理サーバの設定

15.3.2　JP1統合運用管理サーバの設定

15.4　JP1/AJS2 - SOと連携したシステム構築・運用の流れ

15.5　JP1/AJS2 - SOと連携するための設定

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

15.5.2　運用管理サーバの設定

15.5.3　JP1ジョブ運用管理サーバの設定

付録

付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド

付録A.1　BIG-IP 1500の場合

付録A.2　BIG-IP 1000の場合

付録A.3　Loadflowbalの場合

付録B　抽象パラメタ

付録B.1　抽象パラメタの展開

付録B.2　抽象パラメタによって展開される実パラメタ

付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル

付録D　JP1/Cm2/NCとの連携

付録D.1　JP1/Cm2/NCと連携したときの製品構成およびプロセス構成

付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定

付録E　論理サーバのコンフィグレーションに指定できるパラメタ（互換用）

付録E.1　各論理サーバ共通で指定できるパラメタ（互換用）

付録E.2　論理Webサーバで指定できるパラメタ（互換用）

付録E.3　論理J2EEサーバで指定できるパラメタ（互換用）

付録E.4　論理SFOサーバで指定できるパラメタ（互換用）

付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり

付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり

付録H　Cosminexus DABroker Libraryのメモリ所要量

付録H.1　JDBCのメモリサイズの計算式に使用するデータのサイズ

付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）

付録I.1　Cosminexus DABroker Libraryの動作環境の設定

付録I.2　データベース接続のための設定

付録I.3　J2EEアプリケーション運用のための設定

付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）

付録J.1　Cosminexus DABroker Libraryのセットアップ

付録J.2　Cosminexus DABroker Libraryの動作環境の設定

付録J.3　データベース接続のための設定

付録J.4　J2EEアプリケーション運用のための設定

付録K　データベースの設定

付録K.1　HiRDBの設定（Cosminexus DABroker Libraryの場合）

付録K.2　Oracleの設定（Cosminexus DABroker Libraryの場合）

付録K.3　XDM/RD E2の設定

付録K.4　SQL Serverの設定

付録L　セットアップウィザードで設定されるパラメタ

付録L.1　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

付録L.2　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

付録L.3　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

付録M　用語解説

索引

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

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※

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

■ 輸出時の注意

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

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
BIG-IP，3-DNS，iControl Services Manager，FirePassおよびF5はF5 Networks Incの商標，または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
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.の商品名称です。
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. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Symantecは，米国におけるSymantec Corporation の登録商標です。
Symantec AntiVirus Scan Engineは，Symantec Corporation の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国およびその他の国における米国Microsoft Corp.の商標です。
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-M05
2007年 12月 (第4版) 3020-3-M05-60

■ 著作権

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

変更内容

変更内容（3020-3-M05-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.2，1.3.2，1.3.3，1.3.4，8章，9章，10章，11章，12.1.4，12.2，13.2，13.4，13.5，13.7，13.10，14.1，14.1.2，14.2，14.5，14.5.5，14.5.6，14.5.7，14.5.8，14.5.9，14.5.10，14.5.11，14.5.12，付録C，付録G，付録M

システム構築のツールとして，セットアップウィザード機能をサポートした。これに伴い，セットアップウィザード機能の説明を追加した。
1.1.1，1.2，2章，3章，付録M

セッションフェイルオーバ機能使用時にJ2EEサーバで使用するメモリ増加量の説明を追加した。
5.1.2，5.1.3，5.1.4，5.1.7

Solarisに関する記述を追加した。
5.1.5，6.5.1，6.5.3(2)，6.6.1，6.6.2(3)，6.15.3，6.16.3，6.16.4，6.16.5，14.3.2，15.3.1(6)，15.5.1(4)，付録D.2(3)，付録J.3(2)，付録J.4(3)，付録K.1(1)，付録K.2(1)

次のコマンドを，Webシステムに関連づいていない論理サーバに対して使用できるようにした。

cmx_list_model

cmx_list_status

cmx_start_target

cmx_stop_target

5.2.1(2)，12.3

システムの削除に関する記述を追加した。
5.2.1(6)，5.2.2，7.1，7.9

リソースアダプタのデプロイ手順を変更した。また，リソースアダプタおよびJ2EEアプリケーションの開始手順を変更した。
6.1，6.1.2，6.11，6.12.2，6.13，6.14，6.15，6.16，6.17，6.18

J2EEサーバおよびSFOサーバの拡張パラメタとJavaVMのシステムプロパティを設定するパラメタについて，指定形式を変更した。
6.5.2，14.5.3，14.5.4，14.7.3，14.7.4，付録I.3，付録K.4

抽象パラメタの展開を推奨の手順から削除した。これに伴い，記述を移動した。
6.8，付録B

次のパラメタを簡易構築定義ファイルでサポートした。

ejbserver.container.audit_trail.enabled

mstartup.force.watchtime

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.sfo.check_size.mode

webserver.static_content.encoding.extension

14.2，14.3，14.5.1，14.5.5

次の製品の適用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

－

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

第4版では，目次の構成を変更し，編構成としました。第3版との対応は次のようになっています。

第3版 | 第4版
－ | 第1編　システム構築の概要
－ | 第2編　セットアップウィザードを使用したシステムのセットアップと運用
－ | 第3編　Smart Composer機能を使用したシステムの構築と運用
2.　システム構成の検討 | 4.　J2EEアプリケーションを実行するシステムの構成の検討
3.　システムを構築する前に | 5.　J2EEアプリケーションを実行するシステムを構築する前に
4.　システム構築 | 6.　J2EEアプリケーションを実行するシステムの構築
5.　システムを運用する前に | －
5.1　運用を開始する前の設定 | 6.19　障害に対応したシステムの構築
5.2　障害発生時にサービスユニットを自動閉塞するための設定 | 6.19.1　障害発生時にサービスユニットを自動閉塞するための設定
5.3　サービスユニットを自動再起動するための設定 | 6.19.2　サービスユニットを自動再起動するための設定
6.　システム運用 | 7.　J2EEアプリケーションを実行するシステムの運用
7.　コマンド | 12.　コマンド
8.　ファイル | 13.　ファイル
9.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ | 14.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ
10.　JP1と連携したSmart Composer機能でのシステム構築・運用 | 15.　JP1と連携したSmart Composer機能でのシステム構築・運用

変更内容（3020-3-M05-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

追加・変更内容

システムを構築・運用する方法の推奨を，Smart Composer機能を使用する方法に変更するのに伴い，記述を変更した。

インプロセスHTTPサーバを使用する構成に関する記述を追加した。

構築済みのシステムの移行に関する記述を追加した。

次の操作で使用するコマンドをサーバ管理コマンドに変更した。

リソースアダプタのデプロイ

業務アプリケーションのインポートと設定

リソースアダプタ，および業務アプリケーションの開始

リソースアダプタ，および業務アプリケーションの停止

業務アプリケーションの入れ替え

システムを構築する前の初期設定に関する次の記述を追加した。

メモリ所要量の見積もり

Cosminexus DABroker Libraryの設定

データベースの設定

システムの監査を支援する機能を追加した。

簡易構築定義ファイルの運用方法の変更に伴い，記述を追加，および変更した。

Windows Vistaを使用している場合の注意事項を追加した。

情報モデルの生成から，Webシステムの構築まで，一括で実行できる機能を追加した。

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

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

論理ユーザサーバを簡易構築定義ファイルに定義できるようにした。

cmx_delete_systemコマンド使用時の注意事項を追加した。

cmx_export_modelコマンドを追加した。

.cmxrcファイルおよびcmxclient.propertiesファイルにWebシステム名を設定できるようにした。
また，それに伴って，次のコマンドの形式でWebシステム名を省略できるようにした。

cmx_build_system

cmx_define_application

cmx_define_resource

cmx_delete_serverref

cmx_delete_system

cmx_deploy_application

cmx_deploy_resource

cmx_list_model

cmx_list_status

cmx_resume_lb

cmx_start_application

cmx_start_resource

cmx_start_target

cmx_stop_application

cmx_stop_resource

cmx_stop_target

cmx_test_lb

cmx_undefine_application

cmx_undefine_resource

cmx_undeploy_application

cmx_undeploy_resource

次のコマンドに注意事項を追加した。

cmx_add_serverref

cmx_build_model

cmx_build_system

cmx_change_model

cmx_delete_serverref

cmx_list_model

クライアント設定プロパティファイルおよびクライアント共通設定プロパティファイルに設定できるキーに，次のキーを追加した。

cmx.websystem.name

cmx.encoding

cmx.indent

cmx.myhost

Management Serverマシンと負荷分散機との接続構成を変更した場合の注意事項を追加した。

論理サーバ参照定義ファイルを互換用のファイルとした。

推奨のパラメタに変更した。
また，パラメタと運用管理ポータルの画面の対応を削除した。

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

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

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

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

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版では，マニュアル「Cosminexus　システム構築ガイド」から内容の一部を移動し，目次の構成を変更しました。第2版との対応は次のようになっています。

第2版 | 第3版
1.　簡易構築・運用の概要 | 1.　Cosminexusでのシステム構築の概要
2.　システム構成の検討 | 2.　システム構成の検討
3.　システムを構築する前に | 3.　システムを構築する前に
4.　システム構築 | 4.　システム構築
「Cosminexus　システム構築ガイド」から移動 | 4.5.2　データベースを使用するための設定
5.　システムを運用する前に | 5.　システムを運用する前に
6.　システム運用 | 6.　システム運用
7.　コマンド | 7.　コマンド
8.　ファイル | 8.　ファイル
9.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ | 9.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ
10.　JP1と連携したSmart Composer機能でのシステム構築・運用 | 10.　JP1と連携したSmart Composer機能でのシステム構築・運用
付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド | 付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド
付録B　抽象パラメタによって展開される実パラメタ | 付録B　抽象パラメタによって展開される実パラメタ
付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル | 付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル
付録D　JP1/Cm2/NCとの連携 | 付録D　JP1/Cm2/NCとの連携
－ | 付録E　論理サーバのコンフィグレーションに指定できるパラメタ（互換用）
「Cosminexus　システム構築ガイド」から移動 | 付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり
「Cosminexus　システム構築ガイド」から移動 | 付録G　Cosminexus DABroker Libraryのメモリ所要量
「Cosminexus　システム構築ガイド」から移動 | 付録H　Cosminexus DABroker Libraryの設定（Windowsの場合）
「Cosminexus　システム構築ガイド」から移動 | 付録I　Cosminexus DABroker Libraryの設定（UNIXの場合）
「Cosminexus　システム構築ガイド」から移動 | 付録J　データベースの設定
付録E　用語解説 | 付録H　用語解説

変更内容（3020-3-M05-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

追加・変更機能

CTMを使用したシステムを構築・運用できる機能を追加した。

JP1/SC/DPMと連携して，ホスト単位管理モデルでWebシステムを構築できる機能と，構築済みのマシンを複製して，Webシステムをスケールアウトできる機能を追加した。

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

J2EEサーバごとに，デフォルトの文字エンコーディングを設定できる機能の追加に伴い，次に示すパラメタを追加した。

webserver.http.request.encoding

webserver.http.response.encoding

webserver.jsp.pageEncoding

JP1 Version8に対応した。

HiRDB Version8に対応した。

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

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

はじめに

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

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の違いによる機能相違点の表記」を参照してください。

対象読者

このマニュアルは，Smart Composer機能を使用して，J2EEに準拠したアプリケーションを実行するためのシステムを構築または運用する方を対象としています。

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

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

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

J2EEに関する知識

マニュアルの構成

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

第1編　システム構築の概要

Cosminexusで構築できるシステムの概要について説明しています。また，Cosminexusが提供する構築ツールであるセットアップウィザードおよびSmart Composer機能の概要について説明しています。

第2編　セットアップウィザードを使用したシステムのセットアップと運用

セットアップウィザードを使用したシステムのセットアップと運用について説明しています。

第3編　Smart Composer機能を使用したシステムの構築と運用

Smart Composer機能を使用したシステムの構築と運用について説明しています。

付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド

Smart Composer機能が実行する負荷分散機のCLIコマンドについて説明しています。

付録B　抽象パラメタ

Smart Composer機能が提供する抽象パラメタについて説明しています。

付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル

JP1/SC/DPMを利用して，Webシステムをスケールアウトする際に削除するログファイルについて説明しています。

付録D　JP1/Cm2/NCとの連携

JP1/Cm2/NCと連携して負荷分散機を制御する場合の製品構成，および設定方法について説明しています。

付録E　論理サーバのコンフィグレーションに指定できるパラメタ（互換用）

論理サーバのコンフィグレーションに設定できる，互換用のパラメタについて説明しています。

付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり

J2EEサーバのスレッド数とファイルディスクリプタ数の見積もりについて説明しています。

付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり

バッチサーバのスレッド数とファイルディスクリプタ数の見積もりについて説明しています。

付録H　Cosminexus DABroker Libraryのメモリ所要量

Cosminexus DABroker Libraryのメモリ所要量の計算式について説明しています。

付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）

WindowsでCosminexus DABroker Libraryを使用する場合の環境設定について説明しています。

付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）

UNIXでCosminexus DABroker Libraryを使用する場合の環境設定について説明しています。

付録K　データベースの設定

データベースとして，HiRDB，Oracle，XDM/RD E2，またはSQL Serverを使用する場合に必要な設定について説明しています。

付録L　セットアップウィザードで設定されるパラメタ

セットアップウィザードの画面で値を設定していないパラメタのうち，パラメタの省略値と異なる値が設定されるパラメタについて説明しています。

付録M　用語解説

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

関連マニュアル

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

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

Cosminexus　概説

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

Cosminexus　機能解説

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

Cosminexus　システム設計ガイド

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

Cosminexus　システム構築ガイド

システム構築時に必要な機能の設定方法について説明しています。

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）

Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス（3020-3-M46）

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

DABroker for C++（3020-6-032）

スケーラブルデータベースサーバ HiRDB Version 7 解説（UNIX(R)用）（3000-6-271）

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

スケーラブルデータベースサーバ HiRDB Version 7 システム定義（UNIX(R)用）（3000-6-273）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-276）

スケーラブルデータベースサーバ HiRDB Version 7 XDM/RD E2接続機能（3000-6-281）

スケーラブルデータベースサーバ HiRDB Version 8 解説（UNIX(R)用）（3000-6-351）

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

スケーラブルデータベースサーバ HiRDB Version 8 システム定義（UNIX(R)用）（3000-6-353）

スケーラブルデータベースサーバ HiRDB Version 7 解説（Windows(R)用）（3020-6-271）

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

スケーラブルデータベースサーバ HiRDB Version 7 システム定義（Windows(R)用）（3020-6-273）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（Windows(R)用）（3020-6-276）

スケーラブルデータベースサーバ HiRDB Version 8 解説（Windows(R)用）（3020-6-351）

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

スケーラブルデータベースサーバ HiRDB Version 8 システム定義（Windows(R)用）（3020-6-353）

スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド（3020-6-356）

スケーラブルデータベースサーバ HiRDB Version 8 XDM/RD E2接続機能（3020-6-365）

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

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

JP1 Version 7i JP1/Automatic Job Management System 2 - Scenario Operation（3020-3-F23）

JP1 Version 7i JP1/ServerConductor/Deployment Manager（3020-3-F40）

JP1 Version 7i JP1/Cm2/Network Element Configuration（3020-3-G17）

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

JP1 Version 8 JP1/Integrated Management - Central Information Master　システム構築・運用ガイド（3020-3-K04 ）

JP1 Version 8 JP1/Automatic Job Management System 2 - Scenario Operation（3020-3-K42）

JP1 Version 8 JP1/Cm2/Network Element Configuration　機能・構築ガイド（3020-3-L13）

JP1 Version 8 JP1/ServerConductor/Deployment Manager（3020-3-L53）

VOS3　Database Connection Server（6190-6-648）

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

正式名称 | このマニュアルでの表記
JP1 Version 8 JP1/Automatic Job Management System 2 - Scenario Operation | JP1/Automatic Job Management System 2 - Scenario Operation
JP1 Version 7i JP1/Automatic Job Management System 2 - Scenario Operation
JP1 Version 8 JP1/ServerConductor/Deployment Manager | JP1/ServerConductor/Deployment Manager
JP1 Version 7i JP1/ServerConductor/Deployment Manager
スケーラブルデータベースサーバ 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)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（Windows(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 UAP開発ガイド | HiRDB UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 XDM/RD E2接続機能 | HiRDB XDM/RD E2接続機能
スケーラブルデータベースサーバ HiRDB Version 7 XDM/RD E2接続機能

読書手順

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

マニュアルを読む目的 | 記述個所
Cosminexusでのシステム構築の概要を知りたい。また，セットアップウィザードおよびSmart Composer機能の概要について知りたい。 | 1章
セットアップウィザードを使用したシステム構築について知りたい。 | 2章
セットアップウィザードで使用するコマンドやファイルについて知りたい。 | 3章
Smart Composer機能を使用した，J2EEアプリケーションを実行するシステムの構築と運用について知りたい。 | J2EEアプリケーションを実行するシステムの構築について知りたい。 | Smart Composer機能で構築できる，J2EEアプリケーションを実行するシステムの構成，構築できるシステム構成パターンについて知りたい。 | 4章
使用リソースの見積もり，運用・障害設計などの，システム構築前に検討が必要なことについて知りたい。 | 5章
Smart Composer機能でのJ2EEアプリケーションを実行するシステム構築手順について知りたい。また，障害に対応した運用や，J2EEアプリケーションのリロードなどをするために必要な設定手順について知りたい。 | 6章
J2EEアプリケーションを実行するシステムの運用について知りたい。 | Smart Composer機能で構築した，J2EEアプリケーションを実行するシステムの運用手順について知りたい。 | 7章
Smart Composer機能を使用した，バッチアプリケーションを実行するシステムの構築と運用について知りたい。 | バッチアプリケーションを実行するシステムの構築について知りたい。 | Smart Composer機能で構築できる，バッチアプリケーションを実行するシステムの構成，構築できるシステム構成パターンについて知りたい。 | 8章
使用リソースの見積もり，運用・障害設計などの，システム構築前に検討が必要なことについて知りたい。 | 9章
Smart Composer機能でのバッチアプリケーションを実行するシステム構築手順について知りたい。また，障害に対応した運用や，バッチアプリケーションのリロードなどをするために必要な設定手順について知りたい。 | 10章
バッチアプリケーションを実行するシステムの運用について知りたい。 | Smart Composer機能で構築した，バッチアプリケーションを実行するシステムの運用手順について知りたい。 | 11章
Smart Composer機能で使用するコマンドの形式や指定内容について知りたい。 | 12章
Smart Composer機能で使用するファイルの形式や指定内容について知りたい。 | 13章，14章
Smart Composer機能と連携できるJP1製品の概要，JP1製品と連携するためのシステム構築の流れおよび設定について知りたい。 | 15章
Smart Composer機能で実行する負荷分散機のCLIコマンドについて知りたい。 | 付録A
Smart Composer機能が提供する抽象パラメタについて知りたい。 | 付録B
JP1/SC/DPMを利用して，Webシステムをスケールアウトする際に削除するログファイルについて知りたい。 | 付録C
JP1/Cm2/NCと連携する場合の製品構成，および設定方法について知りたい。 | 付録D
互換用のパラメタについて知りたい。 | 付録E
J2EEサーバのスレッド数とファイルディスクリプタ数の見積もりについて知りたい。 | 付録F
バッチサーバのスレッド数とファイルディスクリプタ数の見積もりについて知りたい。 | 付録G
Cosminexus DABroker Libraryのメモリ所要量について知りたい。 | 付録H
Cosminexus DABroker Libraryの設定について知りたい。 | 使用するOSがWindowsの場合のCosminexus DABroker Libraryの設定について知りたい。 | 付録I
使用するOSがUNIXの場合のCosminexus DABroker Libraryの設定について知りたい。 | 付録J
データベースの設定について知りたい。 | 付録K
セットアップウィザードでシステムをセットアップする場合にデフォルト値と異なる値が設定されるパラメタについて知りたい。 | 付録L
Cosminexusのマニュアルで使用している用語について知りたい。 | 付録M

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

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

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

ご利用の製品名 | マニュアルで使用している用語
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
BJEX | Batch Job Execution System - Base
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 Run Time | HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
Internet Explorer 7 | Microsoft(R) Windows(R) Internet Explorer(R) 7
IPF | Itanium(R) Processor Family
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/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/IM - Central Console | JP1/Integrated Manager - Central Console
JP1/IM - CM | JP1/Integrated Management - Central Information Master
JP1/Integrated Manager - Central Information Master
JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
JP1/Integrated Manager - View
JP1/SC/DPM | JP1/ServerConductor/Deployment Manager Standard Edition
Loadflowbal | HA8000-ie/Loadflowbal
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のJDBCドライバ | 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
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） | 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）
Linux（AMD64 & Intel EM64T） | 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
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と表記することがあります。

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

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

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

表記 | Java関連用語
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
EJB QL | EJBTM Query Language
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
JavaBeans | JavaBeansTM
JavaMail | JavaMailTM
JCA | J2EETM Connector Architecture
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JSP | JavaServer PagesTM
JTA | JavaTM Transaction API
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
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DMZ | Demilitarized Zone
DTD | Document Type Definition
EIS | Enterprise Information System
EL | Expression Language
GUI | Graphical User Interface
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IIOP | Internet Inter-Orb Protocol
MIB | Management Information Base
OS | Operating System
OTM | Object Transaction Monitor
OTS | Object Transaction Service
RAC | Real Application Clusters
RDB | Relational Database
RMI | Remote Method Invocation
SFO | Session Fail Over
SNMP | Simple Network Management Protocol
SPP | Service Providing Program
ssh | Secure Shell
SSL | Secure Sockets Layer
URL | Uniform Resource Locator
VM | Virtual Machine
XML | Extensible Markup Language

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

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

注意

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

ポイント

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

参考

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

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

このマニュアルで使用する記号について次に示します。

記号
意　味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

［　］
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。
（例１）　［A］
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　［B｜C］
　「何も指定しない」か「BまたはCを指定する」ことを示します。

<　>
この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。
（例1）　<プロパティ>
　プロパティを記述します。またはプロパティが表示されます。
（例2）　<ファイル名>
　ファイル名を指定します。

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

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

記号
意味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

［　］
この記号で囲まれている項目は画面名であることを表します。

<　>
<　>内の名称がユーザの環境によって異なることを表します。

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

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

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

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

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

個所（かしょ）　伝播（でんぱ）　必須（ひっす）　閉塞（へいそく）　漏洩（ろうえい）

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

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

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

Cosminexusで構築するシステムには，J2EEアプリケーションを実行するシステムと，バッチアプリケーションを実行するシステムがあります。J2EEアプリケーションを実行するシステムの構築方法には，セットアップウィザードを使用する方法と，Smart Composer機能を使用する方法があります。バッチアプリケーションを実行するシステムは，Smart Composer機能を使用して構築します。

この章では，システム構築の概要について，システムの目的ごとに説明します。また，それぞれのシステム構築に必要な作業の流れとこのマニュアルでの記載範囲について説明します。

＜この章の構成＞

1.1　構築するシステムの概要

1.2　セットアップウィザードの概要

1.3　Smart Composer機能の概要

1.4　Windows Vista使用時の注意事項

1.1　構築するシステムの概要

Cosminexusで構築できるシステムには，次の2種類があります。どちらのシステムを構築するかは，目的とする業務に応じて決定します。

J2EEアプリケーションを実行するシステム

J2EEアプリケーションを実行するシステムです。J2EEアプリケーションは，オンライン業務を実行するためのアプリケーションです。

バッチアプリケーションを実行するシステム

バッチアプリケーションを実行するシステムです。バッチアプリケーションは，バッチ業務を実行するためのアプリケーションです。

それぞれのシステムおよびアプリケーションで使用できる機能については，マニュアル「Cosminexus　機能解説」を参照してください。また，アプリケーションの種類とシステム構成の関係については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。

ここでは，Cosminexusで構築できるシステムの概要を説明します。

注意

バッチアプリケーションを実行するシステムは，Application Server EnterpriseまたはDeveloper Professionalを使用している場合にだけ構築できます。

＜この節の構成＞

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

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

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

J2EEアプリケーションを実行するシステムの構築には，次の2種類の機能を使用できます。

セットアップウィザード
ウィザードプログラムを使用して，対話形式でシステムを構築できます。最小限の手順で実運用を開始できます。ただし，構築できるシステムの構成や設定できる内容に制限があります。

Smart Composer機能
定義ファイルおよびコマンドによってシステムを一括構築できます。
Webサーバ，J2EEサーバ，負荷分散機などのシステムを構成する複数のプロセスに対する操作を一括して実行できます。また，目的に応じたさまざまな構成のシステムを構築できます。

それぞれの機能を使用して構築できるシステムの概要について説明します。

●セットアップウィザードを使用する場合

セットアップウィザードで構築できるのは，1台のマシンで構成されるJ2EEアプリケーションの実行環境です。Webブラウザからリクエストを受け付けて，そのリクエストを処理するWebフロントシステムを構築できます。

セットアップウィザードで構築できるシステムの構成例を次の図に示します。

図1-1　セットアップウィザードで構築できるシステムの構成例

この図のように，セットアップウィザードで構築したシステムでは，必要なプロセスがすべて1台のサーバに含まれます。

構築作業は，対話形式のプログラムで必要な情報を入力しながら進めます。事前に定義ファイルを用意したり，幾つものコマンドを実行したりする必要がなく，スムーズな環境構築を実現できます。

セットアップウィザードを使用して構築したシステムでは，Management Serverを利用した一括運用を実現できます。例えば，システムの起動や，システムの設定変更などを一括で実施できます。実行できる運用作業については，「5.2　運用・障害設計」を参照してください。

●Smart Composer機能を使用する場合

Smart Composer機能では，1台または複数台のマシンで構成されるJ2EEアプリケーションの実行環境を構築できます。

次のようなシステムを構築できます。

Webブラウザからリクエストを受け付けて，そのリクエストを処理するWebフロントシステム

バックシステムとしてSFOサーバを使用してセッション情報の引き継ぎを実現するシステム

CTMを利用してリクエストを制御するシステム（統合ネーミングスケジューラサーバモデル）

Smart Composer機能で構築できるシステム構成の例を次の図に示します。

図1-2　Smart Composer機能で構築できるシステム構成の例（J2EEアプリケーションの実行環境）

Smart Composer機能は，規模が大きく，一つの業務を複数のアプリケーションサーバで分散して実行するシステムを構築する場合に適しています。例えば，使用する機能やプロセス構成がパターン化されたアプリケーションサーバを複数構築する場合に，一括して構築できます。

注意

CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

Smart Composer機能を使用して構築したシステムでは，Management Serverを利用した一括運用を実現できます。例えば，システムの起動や，システムの設定変更などを一括で実施できます。また，日常運用では，J2EEアプリケーションを停止させることなく，J2EEアプリケーションを入れ替えたりすることもできます。実行できる運用作業については，「5.2　運用・障害設計」を参照してください。

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

バッチアプリケーションを実行するシステムは，Smart Composer機能を使用して構築できます。

Smart Composer機能では，1台または複数台のマシンで構成されるバッチアプリケーションの実行環境を構築できます。バッチアプリケーションの実行環境では，バッチアプリケーションを実行できます。バッチアプリケーションを実行するタイミングは，JP1/AJS2などの関連プログラムでスケジューリングできます。

Smart Composer機能で構築できるシステム構成例を次の図に示します。次の図は，関連プログラムとしてJP1/AJS2を使用する例です。

図1-3　Smart Composer機能で構築できるシステム構成例（バッチアプリケーションの実行環境）

Smart Composer機能を使用して構築したシステムでは，Management Serverを利用した一括運用を実現できます。例えば，システムの起動や，システムの設定変更などを一括で実施できます。実行できる運用作業については，「9.2　運用・障害設計」を参照してください。

1.2　セットアップウィザードの概要

セットアップウィザードは，ウィザードに従って対話形式で操作を進めることで，J2EEアプリケーションの実行環境を構築できる機能です。必要な設定を画面で選択しながら作業を進められるので，事前に複雑なパラメタの検討や定義ファイルの編集をしないで済みます。

ここでは，セットアップウィザードの目的と利点について説明します。

＜この節の構成＞

1.2.1　セットアップウィザードの目的

1.2.2　セットアップウィザードの利点

1.2.3　セットアップウィザードを使用したシステムのセットアップの流れ

1.2.1　セットアップウィザードの目的

セットアップウィザードの目的は，Cosminexusを導入してから実際のシステム運用を開始するまでに掛かる時間を短縮し，運用をスムーズに開始することです。

セットアップウィザードでは，1台のマシンで構成される基本的なシステムを，最小限の手順で構築できるようにしています。構築作業では，J2EEアプリケーションを動作させる環境に最小限必要な項目だけを設定します。構築前に複雑な機能について検討しなくても，速やかに運用を開始できます。なお，セットアップウィザードで構築したシステムは，必要に応じてチューニングできます。

まずは最小限の設定でシステムの運用を開始して，稼働状況に応じてシステム設定を最適化する，という運用ができるようになります。

1.2.2　セットアップウィザードの利点

セットアップウィザードの利点について説明します。

＜この項の構成＞

(1)　対話形式のプログラムによる構築手順の簡略化

(2)　デフォルト設定によるシステム構築作業時間の短縮化

(1)　対話形式のプログラムによる構築手順の簡略化

セットアップウィザードを使用すると，対話形式でシステムを構築できます。事前に定義ファイルを作成したり，構築中に幾つものコマンドを実行したりする必要がありません。セットアップウィザードでは，画面に表示される内容を確認しながら，必要な項目を入力することで作業を進められます。このため，迷うことなく，システムの構築を進められます。

(2)　デフォルト設定によるシステム構築作業時間の短縮化

セットアップウィザードには，標準セットアップとカスタムセットアップという2種類のセットアップ方法があります。

標準セットアップを選択した場合，WebサーバとJ2EEサーバで構成されるシステムをすべてデフォルト値で構築できます。データベースに接続するシステムの場合は，データベース接続環境についてだけ設定すれば，それ以外の項目はすべてデフォルト値を使用して構築できます。設定項目について細かく検討したり，設定したりする必要がありません。このため，システム構築作業時間を短縮できます。なお，一度設定した内容は，システム構築完了後に必要に応じてチューニングすることもできます。

システム構成，ユーザ名，使用するポート番号などを変更したい場合は，カスタムセットアップを選択できます。カスタムセットアップでは，それぞれの設定項目に任意の値を設定できます。なお，カスタムセットアップを選択した場合も，必要な項目だけをカスタマイズできます。それ以外の項目は，デフォルト値を使用してシステムを構築できます

1.2.3　セットアップウィザードを使用したシステムのセットアップの流れ

セットアップウィザードを使用したシステムのセットアップに必要な作業の流れについて説明します。また，システム構築に必要な作業が，どのマニュアルに記載されているかについても説明します。システム構築に必要な作業と，マニュアルとの対応を次の図に示します。

図1-4　システム構築に必要な作業と，マニュアルとの対応（セットアップウィザードを使用する場合）

図中の1.～5.について説明します。

システムの設計
ここでは，構築しようとしているシステムの構成が，セットアップウィザードで構築できる構成かどうかを確認してください。セットアップウィザードでは，次の構成のシステムを構築できます

1台のアプリケーションサーバに，WebサーバとJ2EEサーバが一つずつ含まれるシステム

1台のアプリケーションサーバに，Webサーバをインプロセスで動作させるJ2EEサーバが一つ含まれるシステム

これ以外の構成は，セットアップウィザードでは構築できません。Smart Composer機能を使用して構築してください。Smart Composer機能を使用したシステム構築作業の流れについては，「1.3.4　Smart Composer機能を使用したシステム構築の作業の流れ」を参照してください。

インストール
必要な製品をインストールします。

システムの構築
次の作業を実行します。

セットアップウィザードによるシステムの構成定義とシステム構築
セットアップウィザードを開始して，システムの構成定義とシステムの構築を実行します。
システムの構成定義では，WebサーバをJ2EEサーバと別プロセスとして構築するかどうかを選択します。
カスタムセットアップを選択した場合は，ユーザ名，使用するポート番号などを設定します。
また，データベースと接続する場合は，データベース接続環境の設定として，リソースアダプタの設定をします。

サーバ管理コマンドによるJ2EEアプリケーションの設定
サーバ管理コマンドを使用して，J2EEアプリケーションをインポートしてプロパティを定義します。

チューニング
必要に応じてアプリケーションサーバのパフォーマンスをチューニングします。チューニングは，セットアップウィザードによる初期構築後，実際にJ2EEアプリケーションに負荷を掛けながら実施します。設定したパラメタが適切かどうかを検証し，検証結果に基づいて設定を変更することで，パフォーマンスを向上させます。パラメタの設定変更は，次のどちらかの機能で実行します。

Smart Composer機能のファイルおよびコマンド

運用管理ポータル

チューニングについては，「6.12　チューニング」を参照してください。

システムの運用
構築したシステムを運用します。システムの日常運用，システムのメンテナンス，システム構成の変更などを，必要に応じて実施します。
システムの運用については「7.　J2EEアプリケーションを実行するシステムの運用」を参照してください。

1.3　Smart Composer機能の概要

Smart Composer機能とは，一般的な3階層モデルのアプリケーションサーバのシステムを，簡単に構築および運用できるよう支援するための機能です。Smart Composer機能の利用によってシステム設計の定型化・簡易化が実現するので，簡単に，そして迅速にシステム構築ができます。ここでは，Smart Composer機能の目的と，利点について説明します。

＜この節の構成＞

1.3.1　Smart Composer機能の目的

1.3.2　Smart Composer機能の利点

1.3.3　ほかのプログラムとの連携

1.3.4　Smart Composer機能を使用したシステム構築の作業の流れ

1.3.1　Smart Composer機能の目的

システムは，負荷分散機，アプリケーションサーバ，データベース，運用管理サーバ，障害性能監視サービスやトランザクショントレースサービスなどの付加サービスといった多くの機能コンポーネントで構成されています。これらを業務要件に合わせて適切にシステム設計，定義設計，運用設計，障害設計，および構築することは，多大なノウハウと時間を必要としました。Smart Composer機能は，運用設計・障害設計がビルトインされた高信頼でスケーラブルな実績のある推奨構成のシステムを迅速に構築することを目的としています。

また，従来は，システムを構成する細かいプロセスを意識して，設定したり，運用操作をしたりする必要がありました。このため，プロセスの数だけ同じ設定をしたり，運用操作をしたりする必要がありました。Smart Composer機能では，プロセスを抽象的なモデルで表し，細かいプロセス単位の操作を排除できるので，操作性が飛躍的に向上し，運用コストの低減が図れます。

1.3.2　Smart Composer機能の利点

Smart Composer機能の利点について説明します。

＜この項の構成＞

(1)　推奨システム構成による設計の定型化

(2)　一括初期構築，一括デプロイによるシステム構築の迅速化

(3)　運用機能の強化

(1)　推奨システム構成による設計の定型化

システムには，特に，一部の障害が発生しても業務を継続できる高可用性，業務を停止しないで日常の運用メンテナンスができる運用容易性，業務の拡大に伴ってシステムを拡張できるスケーラビリティが要求されています。

これらの要件を満たすため，Smart Composer機能では，業務サービスを提供する同じ構成のサーバ※を複数持つシステムの構成を推奨しています。システム内の機能構成およびプロセス構成をパターン化することで，システムの設計を定型化・簡易化します。

注※

Smart Composer機能では，業務サービスを提供する同じ構成のサーバをサービスユニットと呼びます。J2EEアプリケーションを実行するシステムのサービスユニットについては，「4.1(2)　サービスユニット」を参照してください。また，バッチアプリケーションを実行するシステムのサービスユニットについては，「8.1　バッチアプリケーションを実行するシステムの構成」を参照してください。

(2)　一括初期構築，一括デプロイによるシステム構築の迅速化

Smart Composer機能で構築するシステムには，同じ機能構成やプロセス構成でパターン化されたサービスユニットが複数存在することになります。Smart Composer機能では，最初に必要最小限の定義を記述しておくだけで，これら複数のサービスユニットに対して，一度に初期構築できます。また，複数のJ2EEアプリケーションやリソースアダプタをすべてのサービスユニットに一括でデプロイしたり，すべてのサービスユニットの環境を一括で設定したりできます。

このように，Smart Composer機能を使用すると，推奨構成のシステムを迅速に構築できます。

(3)　運用機能の強化

Smart Composer機能では，次の操作ができます。

サービスユニット単位でのシステムの開始・停止

負荷分散機の閉塞（負荷分散機による振り分け停止）

システムの一括設定変更・スケールアウト・スケールイン

これらによって，業務を停止しないで日常の運用メンテナンスができます。

さらに，Cosminexusの障害検知時コマンドを利用したり，リソース枯渇監視機能やJ2EEアプリケーションの実行時間監視機能と組み合わせたりして，問題発生時にサービスユニットを自動部分閉塞したり，自動部分再起動したりするような高度な運用ができます。

1.3.3　ほかのプログラムとの連携

Smart Composer機能を使用して構築するシステムでは，JP1やクラスタソフトウェアと連携することもできます。

＜この項の構成＞

(1)　JP1との連携

(2)　クラスタソフトウェアとの連携

(1)　JP1との連携

Smart Composer機能を使用してシステムを構築するとき，次に示すJP1製品とも連携できます。

JP1/IMとの連携（システムの集中監視）
Cosminexusシステムを含めたシステム全体の監視ができるようになります。集中監視では，障害が発生した場合や，あらかじめ指定しておいたしきい値を超える事象が発生した場合などに，運用管理者に自動アクションで通知するように設定できます。

JP1/IM - CMとの連携（システムの構成定義および管理）
業務システムをユーザの視点で，システム構成を定義したり，定義した構成情報を管理したりできます。システム全体に散在する各種リソースの情報を集中して管理することで，システム構成に関する情報を統合管理できます。

JP1/AJS2との連携（カスタムジョブによるシステムの自動運転）
Cosminexusシステムの論理サーバやJ2EEアプリケーションの起動や停止のスケジュールをカスタムジョブに定義することで，システムの運用を自動化できます。
また，Cosminexusシステムの論理サーバやバッチアプリケーションの起動や停止のスケジュールをカスタムジョブに定義することで，バッチアプリケーションの自動実行ができます。

JP1/AJS2 - SOとの連携（シナリオによるシステムの自動運転）
Cosminexusシステムの論理サーバやJ2EEアプリケーションの起動や停止のスケジュールをシナリオに定義することで，システムの運用を自動化できます。
Cosminexusが提供するシナリオテンプレートを使用することで，Smart Composer機能を使用して構築したシステムの自動運転の定義が容易にできるようになります。

JP1/NETM/Auditとの連携（監査ログの収集と一元管理）
Cosminexusが出力する監査ログを自動で収集，および一元管理できます。

このマニュアルでは，JP1/IM - CMおよびJP1/AJS2 - SOと連携する場合のシステム構築について説明します。JP1/IM - CMおよびJP1/AJS2 - SOと連携する場合のシステム構築については，「15.　JP1と連携したSmart Composer機能でのシステム構築・運用」を参照してください。

なお，JP1/IM，JP1/AJS2，およびJP1/NETM/Auditと連携する場合のシステム構築については，マニュアル「Cosminexus　システム構築ガイド」のJP1との連携の設定に関する説明を参照してください。

(2)　クラスタソフトウェアとの連携

Smart Composer機能を使用すると，クラスタソフトウェアと連携できます。クラスタソフトウェアと連携することで，運用管理サーバの1:1系切り替えシステム，および相互系切り替えシステムを構築できます。クラスタソフトウェアとの連携の設定については，マニュアル「Cosminexus　システム構築ガイド」のクラスタソフトウェアと連携するための設定に関する説明を参照してください。

1.3.4　Smart Composer機能を使用したシステム構築の作業の流れ

Smart Composer機能を使用して構築できるシステムには，次の2種類があります。

J2EEアプリケーションを実行するシステム

バッチアプリケーションを実行するシステム

ここでは，それぞれのアプリケーションを実行するシステムの構築の流れを説明します。

＜この項の構成＞

(1)　J2EEアプリケーションを実行するシステムの構築に必要な作業の流れ

(2)　バッチアプリケーションを実行するシステムの構築に必要な作業の流れ

(1)　J2EEアプリケーションを実行するシステムの構築に必要な作業の流れ

J2EEアプリケーションを実行するシステムの構築に必要な作業の流れについて説明します。また，システム構築に必要な作業が，どのマニュアルに記載されているかについても説明します。システム構築に必要な作業と，マニュアルとの対応を次の図に示します。

図1-5　システム構築に必要な作業と，マニュアルとの対応（J2EEアプリケーション）

図中の1.～5.について説明します。

システムの設計
動作させるアプリケーションの種類やシステム構成などについては，あらかじめマニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　システム設計ガイド」で決定しておきます。ここでは，次の作業を実施します。

システムの構成の検討
J2EEアプリケーションで使用する機能に応じて，機能の実現に必要なプロセスやサーバの配置，マシンの台数などを検討します。システム全体の構成は，システムの特性や要件を考慮して決定しておいてください。システムの構成については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。
マニュアル「Cosminexus　システム設計ガイド」で決定したシステム構成を基に，Smart Composer機能の構成パターンを検討します。システム構成の検討については，「4.　J2EEアプリケーションを実行するシステムの構成の検討」を参照してください。

使用リソースおよびメモリの見積もり
システムを動作させるために必要なリソースや，メモリを見積もります。リソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。
なお，オプション製品を使用した環境での見積もりや，プロセス単位の見積もりなどについては，マニュアル「Cosminexus　システム構築ガイド」のリソースの見積もりと設定に関する説明を参照してください。

運用・障害設計
システムの日常運用や保守，障害発生時のシステムの対応などを設計します。運用・障害設計については，「5.2　運用・障害設計」を参照してください。

インストール
構築するシステムに合わせて，必要な製品をインストールします。なお，オプション製品の導入手順や，構成ソフトウェアのインストールについては，マニュアル「Cosminexus　システム構築ガイド」のインストールと初期設定に関する説明を参照してください。

システムの構築
決定した構成に基づいて，システムを定義して構築します。また，構築するシステムで動作するリソースアダプタやJ2EEアプリケーションを設定します。システムを構築するために，次の作業を実施します。
なお，各作業の詳細については，「6.　J2EEアプリケーションを実行するシステムの構築」を参照してください。

Management Serverの設定
Smart Composer機能で構築するシステムは，Management Serverを使用します。Management Serverを初めて使用するホストでは，Management Serverをセットアップしてください。

システムの構成定義
Smart Composer機能のファイルを使用して，決定したシステム構成を定義します。

使用する機能を有効にするための設定
デフォルトの設定では，無効となる機能があります。デフォルトの設定で無効となる機能は，Smart Composer機能のファイルなどを使用して，有効にする設定が必要になります。
各機能を有効にするための設定や，トラブルシューティングの資料取得の設定などについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

システムの構築
Smart Composer機能のコマンドを使用して，システムを構築します。

リソースアダプタの設定
リソースを利用する場合に，必要に応じて，リソースと接続するリソースアダプタを使用します。リソースアダプタは，コマンドを使用して，プロパティを設定したり，インポートしたりします。
リソースアダプタの種類や設定手順については，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。また，リソースとしてJavaBeansリソースを利用する場合の設定については，マニュアル「Cosminexus　システム構築ガイド」のJavaBeansリソースの設定に関する説明を参照してください。

J2EEアプリケーションの設定
コマンドを使用して，J2EEアプリケーションをインポートしてプロパティを定義します。

ほかのプログラムと連携するための設定
JP1やクラスタソフトウェアと連携するために必要な設定をします。
JP1/IM - CMおよびJP1/AJS2 - SOとの連携については，「15.　JP1と連携したSmart Composer機能でのシステム構築・運用」を参照してください。JP1/IM - CMおよびJP1/AJS2 - SO以外のJP1製品との連携の設定については，マニュアル「Cosminexus　システム構築ガイド」のJP1との連携の設定に関する説明を参照してください。
また，クラスタソフトウェアとの連携の設定については，マニュアル「Cosminexus　システム構築ガイド」のクラスタソフトウェアと連携するための設定に関する説明を参照してください。

システムの開始
Smart Composer機能のコマンドを使用して，システムを開始します。

チューニング
構築したシステムで，アプリケーションサーバのパフォーマンスをチューニングします。初期構築後，構築したシステム環境で，実際にJ2EEアプリケーションに負荷を掛けながら，設定したパラメタが適切かどうかを検証し，検証結果に基づいて設定を変更することで，パフォーマンスを向上させます。パラメタの設定変更は，Smart Composer機能のファイルおよびコマンドを使用します。チューニングについては，「6.12　チューニング」を参照してください。

システムの運用
構築したシステムを運用します。システムの日常運用，システムのメンテナンス，システム構成の変更などを，必要に応じて実施します。
システムの運用については「7.　J2EEアプリケーションを実行するシステムの運用」を参照してください。

(2)　バッチアプリケーションを実行するシステムの構築に必要な作業の流れ

バッチアプリケーションを実行するシステムの構築に必要な作業の流れについて説明します。また，システム構築に必要な作業が，どのマニュアルに記載されているかについても説明します。システム構築に必要な作業と，マニュアルとの対応を次の図に示します。

図1-6　システム構築に必要な作業と，マニュアルとの対応（バッチアプリケーション）

図中の1.～5.について説明します。

システムの設計
動作させるアプリケーションの種類やシステム構成などについては，あらかじめマニュアル「Cosminexus　機能解説」，およびマニュアル「Cosminexus　システム設計ガイド」で決定しておきます。ここでは，次の作業を実施します。

システムの構成の検討
バッチアプリケーションで使用する機能に応じて，機能の実現に必要なプロセスやサーバの配置，マシンの台数などを検討します。システム全体の構成は，システムの特性や要件を考慮して決定しておいてください。システムの構成については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。
マニュアル「Cosminexus　システム設計ガイド」で決定したシステム構成を基に，Smart Composer機能の構成パターンを検討します。システム構成の検討については，「8.　バッチアプリケーションを実行するシステムの構成の検討」を参照してください。

使用リソースおよびメモリの見積もり
システムを動作させるために必要なリソースや，メモリを見積もります。リソースの見積もりについては，「9.1　使用リソースの見積もり」を参照してください。
なお，オプション製品を使用した環境での見積もりや，プロセス単位の見積もりなどについては，マニュアル「Cosminexus　システム構築ガイド」のリソースの見積もりと設定に関する説明を参照してください。

運用・障害設計
システムの日常運用や保守，障害発生時のシステムの対応などを設計します。運用・障害設計については，「9.2　運用・障害設計」を参照してください。

インストール
構築するシステムに合わせて，必要な製品をインストールします。なお，オプション製品の導入手順や，構成ソフトウェアのインストールについては，マニュアル「Cosminexus　システム構築ガイド」のインストールと初期設定に関する説明を参照してください。

システムの構築
決定した構成に基づいて，システムを定義して構築します。また，構築するシステムで動作するリソースアダプタを設定します。システムを構築するために，次の作業を実施します。
なお，各作業の詳細については，「10.　バッチアプリケーションを実行するシステムの構築」を参照してください。

Management Serverの設定
Smart Composer機能で構築するシステムは，Management Serverを使用します。Management Serverを初めて使用するホストでは，Management Serverをセットアップしてください。

システムの構成定義
Smart Composer機能のファイルを使用して，決定したシステム構成を定義します。

使用する機能を有効にするための設定
バッチサーバの場合，必ず指定する項目があります。また，それ以外の項目については，デフォルトの設定で無効となる機能があります。デフォルトの設定で無効となる機能を使用する場合は，Smart Composer機能のファイルなどを使用して，有効にする設定が必要になります。
各機能を有効にするための設定や，トラブルシューティングの資料取得の設定などについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

システムの構築
Smart Composer機能のコマンドを使用して，システムを構築します。

リソースアダプタの設定
リソースを利用する場合に，必要に応じて，リソースと接続するリソースアダプタを使用します。リソースアダプタは，コマンドを使用して，プロパティを設定したり，インポートしたりします。
リソースアダプタの種類や設定手順については，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。

ほかのプログラムと連携するための設定
JP1やクラスタソフトウェアと連携するために必要な設定をします。JP1/AJS2を使用したバッチアプリケーションのコマンドのジョブ定義については，マニュアル「Cosminexus　機能解説」のバッチアプリケーションの実行方法に関する説明を参照してください。
JP1/IM - CMおよびJP1/AJS2 - SOとの連携については，「15.　JP1と連携したSmart Composer機能でのシステム構築・運用」を参照してください。JP1/IM - CMおよびJP1/AJS2 - SO以外のJP1製品との連携の設定については，マニュアル「Cosminexus　システム構築ガイド」のJP1との連携の設定に関する説明を参照してください。
また，クラスタソフトウェアとの連携の設定については，マニュアル「Cosminexus　システム構築ガイド」のクラスタソフトウェアと連携するための設定に関する説明を参照してください。

システムの開始
Smart Composer機能のコマンドを使用して，システムを開始します。

チューニング
構築したシステムで，アプリケーションサーバのパフォーマンスをチューニングします。初期構築後，構築したシステム環境で，設定したパラメタが適切かどうかを検証し，検証結果に基づいて設定を変更することで，パフォーマンスを向上させます。パラメタの設定変更は，Smart Composer機能のファイルおよびコマンドを使用します。チューニングについては，「10.9　チューニング」を参照してください。

システムの運用
構築したシステムを運用します。システムの日常運用，システムのメンテナンス，システム構成の変更などを，必要に応じて実施します。
システムの運用については「11.　バッチアプリケーションを実行するシステムの運用」を参照してください。

1.4　Windows Vista使用時の注意事項

ここでは，Windows Vistaで，Cosminexusを使用してアプリケーションサーバを構築，運用する場合の注意事項について説明します。なお，システムドライブをCドライブとして説明します。

●Cosminexusが提供するコマンド使用時の注意事項

Cosminexusが提供するコマンドは，管理者特権で実行する必要があります。Cosminexusが提供するコマンドは，「管理者：コマンドプロンプト」で実行してください。

「管理者：コマンドプロンプト」は，Windows Vistaで提供されている機能を使用して起動してください。起動方法の例を次に示します。

［スタート］ボタンをクリックします。

［プログラム］－［アクセサリ］を選択します。

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。
管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を提供してください。

●Cosminexusが提供する定義ファイルの更新

Cosminexusが提供する定義ファイルは，管理者特権で更新する必要があります。管理者特権のないユーザが定義ファイルを更新しても，C:¥Program Files以下のディレクトリにある定義ファイルは更新されません。管理者特権のないユーザが更新したファイルは，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

なお，アプリケーションサーバは管理者特権で起動されるため，管理者特権のないユーザが更新した定義ファイルの内容は無視されます。

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

Windows VistaでサポートされたJIS X0213:2004の第三水準および第四水準の文字の一部には，Unicodeの補助文字が含まれます。Unicodeの補助文字とは，基本多言語面以外の文字（UnicodeのコードポイントがU+10000～U+10FFFFの範囲の文字）のことです。UTF-16エンコーディングでは，サロゲートペアとして表されます。

Unicodeの補助文字を使用する場合の注意事項を次に示します。

リクエストで使用する場合の注意事項

アプリケーションサーバに対して，Internet Explorer 7などのクライアントからUnicodeの補助文字を含むリクエストを送信した場合，Unicodeの補助文字は，ログやPRFトレースに正しく出力されません。ただし，その場合も，Unicodeの補助文字以外の文字は，ログやPRFトレースに正しく出力されます。

また，リクエストにUnicodeの補助文字が含まれる場合も，アプリケーションは正しく動作します。

リクエストでのUnicodeの補助文字の使用を制限したい場合には，アプリケーションでの対応などを検討してください。

環境構築／運用時の注意事項

アプリケーションサーバを構築，運用する場合，およびアプリケーションやリソースをデプロイする場合に使用する定義に，Unicodeの補助文字は使用できません。

Unicodeの補助文字を使用できない定義の例を示します。

EAR，WAR，JAR，EJB-JAR，サーブレット，JSP，クラス，メソッド，引数，または変数の名称

DD内の各種定義

システムのインストール先の指定値

そのほか，各種定義ファイルの設定値

2.　セットアップウィザードを使用したシステムのセットアップ

この章では，セットアップウィザードを使用したシステムのセットアップについて説明します。なお，セットアップウィザードで使用するコマンドやファイルについては，「3.　セットアップウィザードで使用するコマンドとファイル」を参照してください。

＜この章の構成＞

2.1　システムをセットアップする前に

2.2　システムのセットアップ

2.3　システムの運用

2.1　システムをセットアップする前に

ここでは，セットアップウィザードでシステムをセットアップする前に必要な次のことについて説明しています。

システム構成とセットアップ方法の決定

インストール

セットアップウィザードを使用するための準備

また，セットアップウィザードを使用する場合の注意事項についても説明しています。

＜この節の構成＞

2.1.1　システム構成とセットアップ方法の決定

2.1.2　インストール

2.1.3　セットアップウィザードを使用する前に

2.1.1　システム構成とセットアップ方法の決定

ここでは，セットアップするシステム構成と，セットアップ方法を決定します。

セットアップしたいシステム構成によって選択できるセットアップ方法が異なります。そのため，システム構成を決定してからセットアップ方法を決定します。

＜この項の構成＞

(1)　システム構成の決定

(2)　セットアップ方法の決定

(1)　システム構成の決定

セットアップウィザードを使用してセットアップできるシステム構成には，次の2種類があります。

WebサーバとJ2EEサーバを配置するシステム

J2EEサーバだけを配置するシステム

セットアップウィザードを使用する前に，どちらのシステム構成でセットアップするか決定します。また，データベースに接続するかどうかも決定します。

それぞれのシステムの概要について説明します。

●WebサーバとJ2EEサーバを配置するシステム

WebサーバとJ2EEサーバを別々のプロセスで運用する場合のシステム構成です。アプリケーションサーバマシンの中に，Webサーバ，J2EEサーバ，およびPRFデーモンの三つのサーバプロセスを配置します。また，Cosminexusが提供する運用管理プロセスであるManagement Serverと運用管理エージェントを配置します。データベースへ接続する場合は，データベースを配置したデータベースサーバマシンが必要です。

WebサーバとJ2EEサーバを配置するシステムの構成例を次の図に示します。

図2-1　WebサーバとJ2EEサーバを配置するシステムの構成例

アプリケーションサーバ上に配置されたサーバプロセスの構成は，Webシステムという概念で管理されます。

●J2EEサーバだけを配置するシステム

Webサーバを配置しないでクライアントからのリクエストを受け付けたい場合のシステム構成です。クライアントからのリクエストはJ2EEサーバで受け付けます。アプリケーションマシンの中にWebサーバをインプロセスで動作させるJ2EEサーバおよびPRFデーモンの二つのサーバプロセスを配置します。また，Cosminexusが提供する運用管理プロセスであるManagement Serverと運用管理エージェントを配置します。データベースへ接続する場合は，データベースを配置したデータベースサーバマシンが必要です。

J2EEサーバだけを配置するシステムの構成例を次の図に示します。

図2-2　J2EEサーバだけを配置するシステムの構成例

(2)　セットアップ方法の決定

セットアップウィザードを使用したセットアップには，標準セットアップとカスタムセットアップの2種類の方法があります。

どちらのセットアップ方法でシステムをセットアップするかは，セットアップするシステム構成によって異なります。「(1)　システム構成の決定」で決定したシステム構成から，セットアップ方法を選択します。セットアップするシステム構成と選択できるセットアップ方法の関係について，次の表に示します。

表2-1　セットアップするシステム構成と選択できるセットアップ方法

システム構成 | セットアップ方法
標準セットアップ | カスタムセットアップ
WebサーバとJ2EEサーバを配置するシステム | ○ | ○
J2EEサーバだけを配置するシステム | × | ○

（凡例）○：セットアップできる　×：セットアップできない

それぞれのセットアップ方法について説明します。

標準セットアップ
すべての設定項目にデフォルト値を自動的に設定するセットアップ方法です。WebサーバとJ2EEサーバを配置するシステムをセットアップできます。ただし，データベース接続環境については設定が必要です。

カスタムセットアップ
運用管理ユーザのユーザIDおよびパスワード，Webサーバのポート番号などの設定値を変更できるセットアップ方法です。WebサーバとJ2EEサーバを配置するシステムとJ2EEサーバだけを配置するシステムの両方をセットアップできます。システム構成を選択したい場合，および設定値を変更したい場合はこちらのセットアップ方法を選択してください。なお，設定値を変更しない項目については，デフォルト値のままセットアップできます。

セットアップウィザードで設定できる項目，および設定項目に対するデフォルト値については，「2.2.17　セットアップウィザードで設定できる項目」を参照してください。

2.1.2　インストール

製品をインストールします。各サーバマシンにそれぞれ必要なソフトウェア製品をインストールしてください。アプリケーションサーバおよびデータベースサーバそれぞれについてインストールする製品を説明します。

なお，Application Serverのインストール方法についてはリリースノートを参照してください。HiRDBのインストール方法については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。Oracleのインストール方法については，Oracleのマニュアルを参照してください。

＜この項の構成＞

(1)　アプリケーションサーバマシンにインストールする製品

(2)　データベースサーバマシンにインストールする製品

(1)　アプリケーションサーバマシンにインストールする製品

アプリケーションサーバマシンにインストールする製品について次に示します。

Application Server

HiRDB Run TimeまたはOracle JDBC Thin Driver※
注※　データベースを使用する場合だけインストールします。

(2)　データベースサーバマシンにインストールする製品

データベースサーバマシンにインストールする製品について次に示します。データベースを使用しない場合は，データベースサーバマシンは不要です。

HiRDBまたはOracle※1，※2

注※1

データベースサーバの初期設定については，HiRDBの場合は，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。Oracleの場合は，Oracleのドキュメントを参照してください。

注※2

セットアップウィザードでセットアップするシステムから接続できるデータベースのバージョンは限られています。接続できるデータベースのバージョンは次のとおりです。

HiRDBの場合

HiRDB/Parallel Server Version 8以降およびHiRDB/Single Server Version 8以降

Oracleの場合

Oracle9i以降

2.1.3　セットアップウィザードを使用する前に

ここでは，セットアップウィザードを使用するための準備と，セットアップウィザードを使用する場合の注意事項について説明します。

＜この項の構成＞

(1)　セットアップウィザードを使用するための準備

(2)　セットアップウィザードを使用する場合の注意事項

(1)　セットアップウィザードを使用するための準備

セットアップウィザードを使用するための準備について次に示します。

セットアップ済みのシステムが存在する場合，セットアップウィザードは使用できません。セットアップした方法ごとに次の対処を実施してください。

セットアップウィザードでセットアップしたシステムが存在する場合
セットアップウィザードを使用してアンセットアップしてください。

セットアップウィザード以外の方法でセットアップしたシステムが存在する場合
Application Serverをアンインストールして，再度インストールしてください。

使用するOSがUNIXの場合，次に示すユーザとグループをOSに登録してください。OSに登録されていないユーザまたはグループを指定した場合は，セットアップ実行時にエラーとなります。

Management Serverグループ

J2EEサーバを起動するユーザおよびグループ

Management Serverグループの設定については「2.2.6　運用管理機能の設定」を参照してください。J2EEサーバを起動するユーザについては「2.2.7　J2EEサーバの起動ユーザの設定」を参照してください。

(2)　セットアップウィザードを使用する場合の注意事項

セットアップウィザードを使用する場合の注意事項について次に示します。

セットアップウィザードを実行できるユーザは次のとおりです。次に示すユーザ以外がセットアップウィザードを実行した場合，エラーとなります。

Windows Vista の場合

管理者特権のあるユーザ

Windows Vista以外のWindowsの場合

Administrator権限のあるユーザ

UNIXの場合

root権限のあるユーザ

コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

セットアップ処理の途中でエラーが発生した場合は，セットアップ処理は停止され，セットアップ失敗の画面が表示されます。この場合，セットアップ中のシステムを削除してから再度セットアップを実行してください。セットアップ中のシステムを削除するには，セットアップウィザードでアンセットアップを実行します。アンセットアップについては「2.3.3　システムのアンセットアップ」を参照してください。

セットアップウィザード操作時に，設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，設定項目にデフォルト値が適用されます。なお，デフォルト値がない設定項目もあります。デフォルト値がない設定項目でEnterキーを押すとエラーとなり，再度設定値の入力が求められます。

設定値の入力を求められている場合に，設定できない値を入力してEnterキーを押すとエラーとなり，次の画面が表示されます。

図2-3　設定できない値を入力した場合の画面

設定できる値が「0文字以上」の設定項目について設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，空文字が適用されます。
なお，一度値を設定した項目について値を再入力する場合は次の画面が表示されます。

図2-4　設定できる値が「0文字以上」の設定項目について値を再入力する場合の画面

この画面が表示された場合に何も入力しないでEnterキーを押すと，設定済みの値は適用されないで，空文字が適用されます。

セットアップウィザードでは，セットアップウィザードを実行するホスト上にだけシステムをセットアップできます。ほかのホスト上にはシステムをセットアップできません。

セットアップウィザードを起動するために必要な環境変数はありません。ただし，セットアップ完了後は，運用作業で必要となる環境変数を設定してください。環境変数の設定については，マニュアル「Cosminexus　システム構築ガイド」の環境変数の設定に関する説明を参照してください。

2.2　システムのセットアップ

セットアップウィザードを起動して，システムのセットアップをします。

ここでは，セットアップウィザードを使用したシステムのセットアップの流れを説明します。また，サーバ管理コマンドを使用したアプリケーションのインポートと開始の方法や，セットアップ情報ファイルを使用した一括セットアップについても説明します。セットアップ情報ファイルを使用した一括セットアップの詳細については，「2.2.15　セットアップ情報ファイルを使用した一括セットアップ」を参照してください。

＜この節の構成＞

2.2.1　システムのセットアップの流れ

2.2.2　セットアップウィザードの起動

2.2.3　セットアップの開始

2.2.4　セットアップ方法の選択

2.2.5　運用管理ユーザの設定

2.2.6　運用管理機能の設定

2.2.7　J2EEサーバの起動ユーザの設定

2.2.8　システム構成の選択

2.2.9　システム環境の設定

2.2.10　データベース接続環境の設定

2.2.11　セットアップ情報の確認

2.2.12　セットアップの実行

2.2.13　セットアップウィザードの終了

2.2.14　J2EEアプリケーションのインポートと開始

2.2.15　セットアップ情報ファイルを使用した一括セットアップ

2.2.16　アンセットアップ要求

2.2.17　セットアップウィザードで設定できる項目

2.2.1　システムのセットアップの流れ

システムのセットアップの流れについて次の図に示します。

図2-5　システムのセットアップの流れ

図中の1.～13.について，次の表で説明します。それぞれの手順の詳細については，表中の参照先を参照してください。

表2-2　システムのセットアップの流れ

項番
実施項目
説明
参照先

1
セットアップウィザードの起動
セットアップウィザードを起動します。
2.2.2

2
セットアップの開始
セットアップを開始します。
2.2.3

3
セットアップ方法の選択
次のどちらかのセットアップ方法を選択します。

標準セットアップ

カスタムセットアップ

2.2.4

4
運用管理ユーザの設定
運用管理ユーザのユーザIDとパスワードを設定します。Cosminexusでは，運用管理ユーザをManagement Serverの管理ユーザと呼びます。
2.2.5

5
運用管理機能の設定
運用管理機能を使用する場合に必要なポート番号や管理グループを設定します。
2.2.6

6
J2EEサーバの起動ユーザの設定※
J2EEサーバのセットアップ・運用に関する操作を実行できる権限を持つJ2EEサーバの起動ユーザと，J2EEサーバの起動ユーザのグループを設定します。Cosminexusでは，J2EEサーバの起動ユーザをComponent Container管理者と呼びます。
2.2.7

7
システム構成の選択
システム構成を選択します。WebサーバとJ2EEサーバを配置するシステムにするか，J2EEサーバだけを配置するシステムにするかを選択します。
2.2.8

8
システム環境の設定
システム名やポート番号を設定します。
2.2.9

9
データベース接続環境の設定
データベース接続環境を設定します。使用するデータベースをHiRDBとOracleのどちらにするかもここで設定します。
2.2.10

10
セットアップ情報の確認
3.～9.までに設定したセットアップ情報を確認します。
標準セットアップの場合，設定値はすべてデフォルト値となっています。
設定値を変更する場合は3.へ戻って設定をし直すことができます。
2.2.11

11
セットアップの実行
セットアップを実行します。
2.2.12

12
セットアップウィザードの終了
セットアップウィザードを終了します。
2.2.13

13
J2EEアプリケーションのインポートと開始
セットアップしたシステムに，J2EEアプリケーションをインポートします。J2EEアプリケーションのインポートと開始には，サーバ管理コマンドを使用します。
2.2.14

注※　UNIXの場合にだけ設定が必要です。

2.2.2　セットアップウィザードの起動

セットアップウィザードを起動します。

セットアップウィザードの起動方法はOSによって異なります。OSごとのセットアップウィザードの起動方法について説明します。

Windowsの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザには，Windows Vistaの場合は管理者特権，Windows Vista以外のWindowsの場合はAdministrator権限が必要です。

<Cosminexusインストールディレクトリ>¥manager¥setup¥bin¥setupwizard

UNIXの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはroot権限が必要です。

# /opt/Cosminexus/manager/setup/bin/setupwizard

なお，セットアップウィザードは起動後もコマンドプロンプト上で動作します。

2.2.3　セットアップの開始

セットアップウィザードを起動すると，［ようこそ］画面が表示されます。ここでは，セットアップの開始を選択します。

なお，セットアップ済みのシステムがある場合は，［アンセットアップ要求］画面（［ようこそ］画面）が表示されます。セットアップ済みのシステムを削除してからセットアップを開始します。アンセットアップ要求については「2.2.16　アンセットアップ要求」を参照してください。

［ようこそ］画面では，次のように画面が遷移します。

図2-6　［ようこそ］画面での画面遷移

操作の流れ

［ようこそ］画面での操作の流れを次に示します。

システムをセットアップするかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，［セットアップ方法の選択］画面が表示されます。
9を選択した場合，［終了確認］画面が表示されます。

［ようこそ］画面を次に示します。

図2-7　［ようこそ］画面

設定項目

［ようこそ］画面で設定する項目を次の表に示します。

表2-3　［ようこそ］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップの実行 | システムをセットアップします。 | 1 | ［セットアップ方法の選択］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

2.2.4　セットアップ方法の選択

ここでは，「2.1.1(2)　セットアップ方法の決定」で決定したシステムのセットアップ方法を指定します。

［セットアップ方法の選択］画面では，操作の流れに従って次のように画面が遷移します。

図2-8　［セットアップ方法の選択］画面での画面遷移

操作の流れ

［セットアップ方法の選択］画面での操作の流れを次に示します。

システムのセットアップ方法を数字で入力します。

Enterキーを押します。
1を選択した場合，［データベース接続環境の設定］画面が表示されます。
2を選択した場合，［運用管理ユーザの設定］画面が表示されます。

［セットアップ方法の選択］画面を次に示します。

図2-9　［セットアップ方法の選択］画面

設定項目

［セットアップ方法の選択］画面で設定する項目を次の表に示します。

表2-4　［セットアップ方法の選択］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップ方法の選択 | 標準セットアップでシステムをセットアップします。すべての設定項目にデフォルト値※が適用されます。 | 1 | ［データベース接続環境の設定］画面
カスタムセットアップでシステムをセットアップします。設定項目にはそれぞれ任意の値を指定できます。 | 2 | ［運用管理ユーザの設定］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

注※　設定できる項目とデフォルト値の一覧については，「2.2.17　セットアップウィザードで設定できる項目」を参照してください。

2.2.5　運用管理ユーザの設定

カスタムセットアップの場合，ここで運用管理ユーザのアカウント（Management Serverの管理ユーザアカウント）を設定します。

［運用管理ユーザの設定］画面では，操作の流れに従って次のように画面が遷移します。

図2-10　［運用管理ユーザの設定］画面での画面遷移

操作の流れ

［運用管理ユーザの設定］画面での操作の流れを次に示します。

Management Serverの管理ユーザアカウントの設定が現在の設定でよいかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，［運用管理機能の設定］画面が表示されます。
2を選択した場合，［運用管理ユーザの設定］画面（設定内容変更）が表示されます。

手順2.で2を選択した場合，［運用管理ユーザの設定］画面（設定内容変更）で必要な項目に適切な値を入力します。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［運用管理ユーザの設定］画面が表示されます。

＜この項の構成＞

(1)　［運用管理ユーザの設定］画面

(2)　［運用管理ユーザの設定］画面（設定内容変更）

(1)　［運用管理ユーザの設定］画面

［運用管理ユーザの設定］画面を次に示します。

図2-11　［運用管理ユーザの設定］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-5　［運用管理ユーザの設定］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | －
カスタムセットアップ | Windows | 1/5
UNIX | 1/6

（凡例）－：該当なし

設定項目

［運用管理ユーザの設定］画面で設定する項目を次の表に示します。

表2-6　［運用管理ユーザの設定］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
運用管理ユーザの設定 | 運用管理ユーザアカウントについて，現在の設定を適用します。 | 1 | ［運用管理機能の設定］画面
設定内容を変更します。 | 2 | ［運用管理ユーザの設定］画面（設定内容変更）
前の画面に戻ります。 | 0 | ［セットアップ方法の選択］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

(2)　［運用管理ユーザの設定］画面（設定内容変更）

［運用管理ユーザの設定］画面（設定内容変更）を次に示します。

図2-12　［運用管理ユーザの設定］画面（設定内容変更）

設定項目

［運用管理ユーザの設定］画面（設定内容変更）で設定する項目を次の表に示します。

表2-7　［運用管理ユーザの設定］画面（設定内容変更）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
運用管理ユーザアカウントのユーザID | Management Serverの管理ユーザアカウントのユーザIDを指定します。 | 半角英数字，一部の半角特殊文字※1，および半角スペース1文字以上 | －
管理ユーザアカウントのパスワード | Management Serverの管理ユーザアカウントのパスワードを指定します。 | 半角英数字，一部の半角特殊文字※1，および半角スペース0文字以上※2 | ［運用管理ユーザの設定］画面

（凡例）　－：該当なし

注※1

入力できる半角特殊文字について次に示します。

! # $ & ' ( ) * + , - . / : ; < = > ? @ [ ] ^ _ ` { | } ~

注※2

空文字も入力値となります。

2.2.6　運用管理機能の設定

カスタムセットアップの場合，ここで運用管理機能（Management Server）の設定をします。

［運用管理機能の設定］画面では，操作の流れに従って次のように画面が遷移します。

図2-13　［運用管理機能の設定］画面での画面遷移

操作の流れ

［運用管理機能の設定］画面での操作の流れを次に示します。

Management Serverの設定が現在の設定でよいかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，使用しているOSによって表示される画面が異なります。
Windowsの場合は［システム構成の選択］画面が表示されます。
UNIXの場合は［J2EEサーバの起動ユーザの設定］画面が表示されます。
2を選択した場合，［運用管理機能の設定］画面（設定内容変更）が表示されます。

手順2.で2を選択した場合，［運用管理機能の設定］画面（設定内容変更）で必要な項目に適切な値を入力します。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［運用管理機能の設定］画面が表示されます。

＜この項の構成＞

(1)　［運用管理機能の設定］画面

(2)　［運用管理機能の設定］画面（設定内容変更）

(1)　［運用管理機能の設定］画面

［運用管理機能の設定］画面を次に示します。

図2-14　［運用管理機能の設定］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-8　［運用管理機能の設定］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | －
カスタムセットアップ | Windows | 2/5
UNIX | 2/6

（凡例）－：該当なし

設定項目

［運用管理機能の設定］画面で設定する項目を次の表に示します。

表2-9　［運用管理機能の設定］画面で設定する項目

設定項目
設定内容
入力値
設定後に表示される画面

運用管理機能の設定
Management Serverについて，現在の設定を適用します。
1

Windowsの場合
［システム構成の選択］画面

UNIXの場合
［J2EEサーバの起動ユーザの設定］画面

設定内容を変更します。
2
［運用管理機能の設定］画面（設定内容変更）

前の画面に戻ります。
0
［運用管理ユーザの設定］画面

セットアップウィザードを終了します。
9
［終了確認］画面

(2)　［運用管理機能の設定］画面（設定内容変更）

［運用管理機能の設定］画面（設定内容変更）の図を次に示します。

図2-15　［運用管理機能の設定］画面（設定内容の変更）

設定項目

［運用管理機能の設定］画面（設定内容の変更）で設定する項目を次の表に示します。

表2-10　［運用管理機能の設定］画面（設定内容の変更）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
Management Server接続HTTPポート番号 | Management Server接続HTTPポート番号を指定します。 | 1-65535の整数値 | －
Management Server終了要求受信ポート番号 | Management Server終了要求受信ポート番号を指定します。 | 1-65535の整数値 | －
Management Server内部通信用ポート番号 | Management Server内部通信用ポート番号を指定します。 | 1-65535の整数値 | －
運用管理エージェントのポート番号 | 運用管理エージェントのポート番号を指定します。 | 1-65535の整数値 | ［運用管理機能の設定］画面※1
Management Server管理グループに設定するグループ※2 | Management Server管理グループに設定するグループを指定します。 | 1文字以上 | ［運用管理機能の設定］画面

（凡例）－：なし

注※1　Windowsの場合だけ表示されます。

注※2　UNIXの場合だけ表示されます。

2.2.7　J2EEサーバの起動ユーザの設定

カスタムセットアップの場合，ここでJ2EEサーバの起動ユーザ（Component Container管理者）を設定します。J2EEサーバの起動ユーザは，UNIXの場合にだけ設定します。

［J2EEサーバの起動ユーザの設定］画面では，操作の流れに従って次のように画面が遷移します。

図2-16　［J2EEサーバの起動ユーザの設定］画面での画面遷移

操作の流れ

［J2EEサーバの起動ユーザの設定］画面での操作の流れを次に示します。

J2EEサーバの起動ユーザの設定が現在の設定でよいかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，［システム構成の選択］画面が表示されます。
2を選択した場合，［J2EEサーバの起動ユーザの設定］画面（設定内容変更）が表示されます。

手順2.で2を選択した場合，［J2EEサーバの起動ユーザの設定］画面（設定内容変更）で必要な項目に適切な値を入力します。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［J2EEサーバの起動ユーザの設定］画面が表示されます。

＜この項の構成＞

(1)　［J2EEサーバの起動ユーザの設定］画面

(2)　［J2EEサーバの起動ユーザの設定］画面（設定内容変更）

(1)　［J2EEサーバの起動ユーザの設定］画面

［J2EEサーバの起動ユーザの設定］画面を次に示します。

図2-17　［J2EEサーバの起動ユーザの設定］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-11　［J2EEサーバの起動ユーザの設定］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | －
カスタムセットアップ | Windows | －
UNIX | 3/6

（凡例）－：該当なし

設定項目

［J2EEサーバの起動ユーザの設定］画面で設定する項目を次の表に示します。

表2-12　［J2EEサーバの起動ユーザの設定］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
J2EEサーバの起動ユーザの設定 | Component Container管理者について，現在の設定を適用します。 | 1 | ［システム構成の選択］画面
設定内容を変更します。 | 2 | ［J2EEサーバの起動ユーザの設定］画面（設定内容変更）
前の画面に戻ります。 | 0 | ［運用管理機能の設定］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

(2)　［J2EEサーバの起動ユーザの設定］画面（設定内容変更）

［J2EEサーバの起動ユーザの設定］画面（設定内容変更）の図を次に示します。

図2-18　［J2EEサーバの起動ユーザの設定］画面（設定内容変更）

設定項目

［J2EEサーバの起動ユーザの設定］画面（設定内容変更）で設定する項目を次の表に示します。

表2-13　［J2EEサーバの起動ユーザの設定］画面（設定内容変更）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
Component Container管理者 | Component Container管理者を指定します。 | 1文字以上 | －
Component Container管理者グループ | Component Container管理者グループを指定します。 | 1文字以上 | ［J2EEサーバの起動ユーザの設定］画面

（凡例）－：なし

2.2.8　システム構成の選択

カスタムセットアップの場合，ここでシステム構成を選択します。

［システム構成の選択］画面では，操作の流れに従って次のように画面が遷移します。

図2-19　［システム構成の選択］画面での画面遷移

操作の流れ

［システム構成の選択］画面での操作の流れを次に示します。

システム構成が現在の設定でよいかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，［システム環境の設定］画面が表示されます。
2を選択した場合，［システム構成の選択］画面（設定内容変更）が表示されます。

手順2.で2を選択した場合，［システム構成の選択］画面（設定内容変更）で必要な項目に適切な値を入力します。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［システム構成の選択］画面が表示されます。

＜この項の構成＞

(1)　［システム構成の選択］画面

(2)　［システム構成の選択］画面（設定内容変更）

(1)　［システム構成の選択］画面

［システム構成の選択］画面を次に示します。

図2-20　［システム構成の選択］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-14　［システム構成の選択］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | －
カスタムセットアップ | Windows | 3/5
UNIX | 4/6

（凡例）－：該当なし

設定項目

［システム構成の選択］画面で設定する項目を次の表に示します。

表2-15　［システム構成の選択］画面で設定する項目

設定項目
設定内容
入力値
設定後に表示される画面

システム構成の選択（システム構成の確認）
システム構成について，現在の設定を適用します。
1
［システム環境の設定］画面

設定内容を変更します。
2
［システム構成の選択］画面（設定内容変更）

前の画面に戻ります。
0

Windowsの場合
［運用管理機能の設定］画面

UNIXの場合
［J2EEサーバの起動ユーザの設定］画面

セットアップウィザードを終了します。
9
［終了確認］画面

(2)　［システム構成の選択］画面（設定内容変更）

［システム構成の選択］画面（設定内容変更）の図を次に示します。

図2-21　［システム構成の選択］画面（設定内容変更）

設定項目

［システム構成の選択］画面（設定内容変更）で設定する項目を次の表に示します。

表2-16　［システム構成の選択］画面（設定内容変更）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
システム構成の選択 | WebサーバとJ2EEサーバを配置するシステム構成を選択します。 | 1 | ［システム構成の選択］画面
Webサーバをインプロセスで動作させるJ2EEサーバだけを配置するシステム構成を選択します。 | 2 | ［システム構成の選択］画面

（凡例）　－：該当なし

2.2.9　システム環境の設定

カスタムセットアップの場合，ここでシステム環境を設定します。

［システム環境の設定］画面では，操作の流れに従って次のように画面が遷移します。

図2-22　［システム環境の設定］画面での画面遷移

操作の流れ

［システム環境の設定］画面での操作の流れを次に示します。

システム環境の設定が現在の設定でよいかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合，［データベース接続環境の設定］画面が表示されます。
2を選択した場合，［システム環境の設定］画面（設定内容変更）が表示されます。

手順2.で2を選択した場合，［システム環境の設定］画面（設定内容変更）で必要な項目に適切な値を入力します。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［システム環境の設定］画面が表示されます。

＜この項の構成＞

(1)　［システム環境の設定］画面

(2)　［システム環境の設定］画面（設定内容変更）

(1)　［システム環境の設定］画面

［システム環境の設定］画面を次に示します。

図2-23　［システム環境の設定］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-17　［システム環境の設定］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | －
カスタムセットアップ | Windows | 4/5
UNIX | 5/6

（凡例）－：該当なし

設定項目

［システム環境の設定］画面で設定する項目を次の表に示します。

表2-18　［システム環境の設定］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
システム環境の確認 | システム環境について，現在の設定を適用します。 | 1 | ［データベース接続環境の設定］画面
設定内容を変更します。 | 2 | ［システム環境の設定］画面（設定内容変更）
前の画面に戻ります。 | 0 | ［システム構成の選択］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

(2)　［システム環境の設定］画面（設定内容変更）

［システム環境の設定］画面（設定内容変更）の図を次に示します。

図2-24　［システム環境の設定］画面（設定内容変更）

設定項目

［システム環境の設定］画面（設定内容変更）で設定する項目を次の表に示します。

表2-19　［システム環境の設定］画面（設定内容変更）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
Webシステム名 | Webシステム名を指定します。 | 半角英数字，記号（アンダースコア，ハイフン）32文字以内 | －
Webサーバの設定 | Webサーバのポート番号※1 | Webサーバのポート番号を指定します。 | 1-65535の整数値 | －
J2EEサーバの設定 | httpのポート番号※2 | J2EEサーバのhttpのポート番号を指定します。 | 1-65535の整数値※3 | －
管理用サーバのポート番号 | J2EEサーバの管理用サーバのポート番号を指定します。 | 1-65535の整数値※3 | －
ajp13のポート番号※1 | J2EEサーバのajp13のポート番号を指定します。 | 1-65535の整数値※3 | －
インプロセスのネーミングサービスのポート番号 | J2EEサーバで使用するインプロセスのネーミングサービスのポート番号を指定します。 | 1-65535の整数値※3 | －
RMIレジストリのポート番号 | J2EEサーバのRMIレジストリのポート番号を指定します。 | 1-65535の整数値※3 | ［システム環境の設定］画面

（凡例）－：なし

注※1　

システム構成がWebサーバとJ2EEサーバを配置する構成（combined-tier）のときだけ表示されます。

注※2　

システム構成がJ2EEサーバだけを配置する構成（j2ee-tier）のときだけ表示されます。

注※3　

［J2EEサーバの起動ユーザの設定］画面（設定内容変更）でComponent Container管理者を設定済みの場合，1024-65535の整数値で指定します。［J2EEサーバの起動ユーザの設定］画面（設定内容変更）については，「2.2.7　J2EEサーバの起動ユーザの設定」を参照してください。

2.2.10　データベース接続環境の設定

ここでは，データベース接続環境を設定します。

［データベース接続環境の設定］画面では，操作の流れに従って次のように画面が遷移します。

図2-25　［データベース接続環境の設定］画面での画面遷移

操作の流れ

［データベース接続環境の設定］画面での操作の流れを次に示します。

データベースの接続環境を設定するかどうか英字で入力します。

Enterキーを押します。
yを選択した場合，［データベース接続環境の設定］画面（使用するデータベースの決定）が表示されます。
nを選択した場合，［データベース接続環境の設定］画面（設定内容確認）が表示されます。

手順2.でyを選択した場合，［データベース接続環境の設定］画面（使用するデータベースの決定）で使用するデータベースを選択します。
1を選択した場合，［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）が表示されます。
2を選択した場合，［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）が表示されます。

値を入力するごとにEnterキーを押します。
すべての設定項目に値を入力すると，［データベース接続環境の設定］画面（設定内容確認）が表示されます。

［データベース接続環境の設定］画面（設定内容確認）で現在の設定でよいかどうか数字で入力します。
1を選択した場合，［セットアップ情報］画面が表示されます。
2を選択した場合，［データベース接続環境の設定］画面が表示されます。

＜この項の構成＞

(1)　［データベース接続環境の設定］画面

(2)　［データベース接続環境の設定］画面（使用するデータベースの決定）

(3)　［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）

(4)　［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）

(5)　［データベース接続環境の設定］画面（設定内容確認）

(1)　［データベース接続環境の設定］画面

データベースの接続環境を設定するかどうかを決定します。

［データベース接続環境の設定］画面を次に示します。

図2-26　［データベース接続環境の設定］画面

注

図中の（n/m）は，セットアップの進行状況を表す数字です。セットアップ方法および使用するOSによって表示される数字が異なります。表示される数字について，次の表に示します。

表2-20　［データベース接続環境の設定］画面に表示される数字

セットアップ方法 | 使用するOS | 表示される数字
標準セットアップ | Windows/UNIX | 1/1
カスタムセットアップ | Windows | 5/5
UNIX | 6/6

設定項目

［データベース接続環境の設定］画面で設定する項目について次の表に示します。

表2-21　［データベース接続環境の設定］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
データベース接続環境の設定 | データベース接続環境の設定をします。 | y | ［データベース接続環境の設定］画面（使用するデータベースの決定）
データベース接続環境の設定をしません。 | n | ［データベース接続環境の設定］画面（設定内容確認）

(2)　［データベース接続環境の設定］画面（使用するデータベースの決定）

使用するデータベースを決定します。

［データベース接続環境の設定］画面（使用するデータベースの決定）を次に示します。

図2-27　［データベース接続環境の設定］画面（使用するデータベースの決定）

設定項目

［データベース接続環境の設定］画面（使用するデータベースの決定）で設定する項目について次の表に示します。

表2-22　［データベース接続環境の設定］画面（使用するデータベースの決定）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
使用するデータベース | HiRDB（バージョン8以降）を使用します。 | 1 | ［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）
Oracle（バージョン9i以降）を使用します。 | 2 | ［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）

(3)　［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）

データベース（HiRDB）への接続設定をします。

［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）を次に示します。

図2-28　［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）

設定項目

［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）で設定する項目について次の表に示します。

表2-23　［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
データベースのホスト名 | データベースのホスト名を指定します。 | 1文字以上 | －
データベースのポート番号 | データベースのポート番号を指定します。 | 1-65535の整数値 | －
データベースのアクセスユーザ | データベースのアクセスユーザを指定します。 | 0文字以上 | －
アクセスユーザのパスワード | アクセスユーザのパスワードを指定します。 | 0文字以上 | －
JDBCドライバのパス | HiRDBが提供するJDBCドライバ（pdjdbc2.jar）のパスを絶対パスで指定します。 | 1文字以上-OSの最大パス長※以下 | ［データベース接続環境の設定］画面（設定内容確認）

（凡例）－：なし

注※　「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。ただし，使用するOSがWindowsの場合，最大パス長は259です。

(4)　［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）

データベース（Oracle）への接続設定をします。

［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）を次に示します。

図2-29　［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）

設定項目

［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）で設定する項目について次の表に示します。

表2-24　［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
データベース名（SID） | データベース名（SID）を指定します。 | 1文字以上 | －
データベースのホスト名 | データベースのホスト名を指定します。 | 1文字以上 | －
データベースのポート番号 | データベースのポート番号を指定します。 | 1-65535の整数値 | －
データベースのアクセスユーザ | データベースのアクセスユーザを指定します。 | 0文字以上 | －
アクセスユーザのパスワード | アクセスユーザのパスワードを指定します。 | 0文字以上 | －
JDBCドライバのパス | Oracleが提供するJDBCドライバ（ojdbc14.jar）のパスを絶対パスで指定します。 | 1文字以上-OSの最大パス長※以下 | ［データベース接続環境の設定］画面（設定内容確認）

（凡例）－：なし

注※　「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。ただし，使用するOSがWindowsの場合，最大パス長は259です。

(5)　［データベース接続環境の設定］画面（設定内容確認）

［データベース接続環境の設定］画面（設定内容確認）の図を次に示します。

図2-30　［データベース接続環境の設定］画面（設定内容確認）

設定項目

［データベース接続環境の設定］画面（設定内容確認）で設定する項目を次の表に示します。

表2-25　［データベース接続環境の設定］画面（設定内容確認）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
データベース接続環境の設定（設定内容確認） | データベース接続環境について，現在の設定を適用します。 | 1 | ［セットアップ情報］画面
設定内容を変更します。 | 2 | ［データベース接続環境の設定］画面
前の画面に戻ります。 | 0 | ［システム環境の設定］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

2.2.11　セットアップ情報の確認

ここでは，セットアップ情報を確認して，セットアップの実行の決定をします。

［セットアップ情報］画面では，操作の流れに従って次のように画面が遷移します。

図2-31　［セットアップ情報］画面での画面遷移

操作の流れ

［セットアップ情報］画面での操作の流れを次に示します。

現在設定されているセットアップ情報でセットアップを開始するかどうかを数字で入力します。

Enterキーを押します。

1を選択した場合，［セットアップの実行］画面が表示されます。
ポート番号の指定値に不正があった場合はエラーとなり，［セットアップ情報］画面（ポート番号エラー）が表示されます。［セットアップ情報］画面（ポート番号エラー）でエラーの原因を確認し，Enterキーを押すと［セットアップ情報］画面に戻ります。

2を選択した場合，［セットアップ情報］画面（セットアップ情報の再設定）が表示されます。
yを選択すると［セットアップ方法の選択］画面が表示されます。
nを選択すると［セットアップ情報］画面に戻ります。

3を選択した場合，［セットアップ情報］画面（セットアップ情報ファイルの保存）が表示されます。
セットアップ情報ファイルがある場合，［セットアップ情報］（セットアップ情報ファイルの上書き）画面が表示されます。
yを選択すると［セットアップ情報］画面（セットアップ情報ファイルの保存）が表示されます。
nを選択すると［セットアップ情報］画面に戻ります。
セットアップ情報ファイルがない場合，［セットアップ情報］画面（セットアップ情報ファイルの保存）が表示されます。

＜この項の構成＞

(1)　［セットアップ情報］画面

(2)　［セットアップ情報］画面（セットアップ情報の再設定）

(3)　［セットアップ情報］画面（セットアップ情報の保存）

(1)　［セットアップ情報］画面

［セットアップ情報］画面の図を次に示します。

図2-32　［セットアップ情報］画面

設定項目

［セットアップ情報］画面で設定する項目を次の表に示します。

表2-26　［セットアップ情報］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップ情報の確認 | 現在設定されているセットアップ情報でセットアップを開始します。 | 1 | ［セットアップの実行］画面※
セットアップ情報を再設定します。現在の設定は保持されます。 | 2 | ［セットアップ情報］画面（セットアップ情報の再設定）
セットアップ情報をファイルに保存します。 | 3 | ［セットアップ情報］画面（セットアップ情報ファイルの保存）
前の画面に戻ります。 | 0 | ［データベース接続環境の設定］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

注※　セットアップ開始後に，ポート番号の指定値に不正があった場合は，エラーとなり，［セットアップ情報］画面（ポート番号エラー）が表示されます。［セットアップ情報］画面（ポート番号エラー）の例を次に示します。

図2-33　［セットアップ情報］画面（ポート番号エラー）の例

この画面でEnterキーを押すと，［セットアップ情報］画面に戻ります。

(2)　［セットアップ情報］画面（セットアップ情報の再設定）

［セットアップ情報］画面（セットアップ情報の再設定）の図を次に示します。

図2-34　［セットアップ情報］画面（セットアップ情報の再設定）

設定項目

［セットアップ情報］画面（セットアップ情報の再設定）で設定する項目を次の表に示します。

表2-27　［セットアップ情報］画面（セットアップ情報の再設定）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップ情報（セットアップ情報の再設定） | セットアップ情報を再設定します。現在の設定は保持されます。 | y | ［セットアップ方法の選択］画面
セットアップ情報を再設定しないで，前の画面に戻ります。 | n | ［セットアップ情報］画面

［セットアップ情報］画面（セットアップ情報の再設定）から［セットアップ方法の選択］画面に戻って1（標準セットアップ）を指定した場合，すべての設定項目にデフォルト値が適用されます。そのため，［セットアップ方法の選択］画面（設定値確認）が表示されます。［セットアップ方法の選択］画面（設定値確認）を次に示します。

図2-35　［セットアップ方法の選択］画面（設定値確認）

設定項目

［セットアップ方法の選択］画面（設定値確認）で設定する項目を次の表に示します。

表2-28　［セットアップ方法の選択］画面（設定値確認）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
［セットアップ方法の選択］画面（設定値確認） | 標準セットアップでシステムをセットアップします。すべての設定項目にデフォルト値※が適用されます。設定済みの値は破棄されます。 | y | ［データベース接続環境の設定］画面
標準セットアップを中止して，［セットアップ方法の選択］画面に戻ります。 | n | ［セットアップ方法の選択］画面

注※　設定できる項目とデフォルト値の一覧については，「2.2.17　セットアップウィザードで設定できる項目」を参照してください。

(3)　［セットアップ情報］画面（セットアップ情報の保存）

［セットアップ情報］画面で3を設定したあとに表示される画面はセットアップ情報ファイルがあるかどうかによって異なります。セットアップ情報の保存を選択したあとに表示される画面について次の表に示します。

表2-29　セットアップ情報の保存を選択したあとに表示される画面

セットアップ情報ファイルの有無 | 実行後に表示される画面
あり | ［セットアップ情報］画面（セットアップ情報ファイルの上書き）
なし | ［セットアップ情報］画面（セットアップ情報ファイルの保存）

(a)　［セットアップ情報］画面（セットアップ情報ファイルの上書き）

図2-36　［セットアップ情報］画面（セットアップ情報ファイルの上書き）

設定項目

［セットアップ情報］画面（セットアップ情報ファイルの上書き）で設定する項目を次の表に示します。

表2-30　［セットアップ情報］画面（セットアップ情報ファイルの上書き）画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップ情報（セットアップ情報ファイルの上書き） | セットアップ情報ファイルを上書きします。 | y | ［セットアップ情報］画面（セットアップ情報ファイルの保存）
セットアップ情報ファイルを作成しないで，前の画面に戻ります。 | n | ［セットアップ情報］画面

(b)　［セットアップ情報］画面（セットアップ情報ファイルの保存）

［セットアップ情報］画面（セットアップ情報ファイルの保存）の図を次に示します。

図2-37　［セットアップ情報］画面（セットアップ情報ファイルの保存）

この画面でEnterキーを押すと，［セットアップ情報］画面に戻ります。

2.2.12　セットアップの実行

ここではセットアップの実行について説明します。

［セットアップの実行］画面は，セットアップの実行結果および操作に従って次のように画面が遷移します。

図2-38　［セットアップの実行］画面での画面遷移

操作の流れ

［セットアップの実行］画面でセットアップが失敗した場合の操作の流れを次に示します。なお，セットアップが成功した場合の操作はありません。

障害時のログを採取するかどうかを英字で入力します。

Enterキーを押します。
yを選択した場合，［セットアップ失敗］画面（障害時のログを採取する場合）が表示されます。
nを選択した場合，［セットアップ失敗］画面（障害時のログを採取しない場合）が表示されます。
それぞれ画面が表示されたあと，セットアップウィザードは終了します。

＜この項の構成＞

(1)　［セットアップの実行］画面

(2)　［セットアップ完了］画面

(3)　［セットアップ失敗］画面

(1)　［セットアップの実行］画面

［セットアップの実行］画面を次に示します。

図2-39　［セットアップの実行］画面

セットアップの実行後，表示される画面はセットアップの実行結果によって異なります。セットアップ実行後に表示される画面について次の表に示します。

表2-31　セットアップ実行後に表示される画面

セットアップの実行結果 | 実行後に表示される画面
完了 | ［セットアップ完了］画面
失敗 | ［セットアップ失敗］画面

(2)　［セットアップ完了］画面

［セットアップ完了］画面を次に示します。

図2-40　［セットアップ完了］画面

(3)　［セットアップ失敗］画面

［セットアップ失敗］画面を次に示します。

図2-41　［セットアップ失敗］画面

設定項目

［セットアップ失敗］画面で設定する項目を次の表に示します。

表2-32　［セットアップ失敗］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
資料の採取 | 障害時の資料（snapshotログ）を採取して，セットアップウィザードを終了します。 | y | ［セットアップ失敗］画面（障害時のログを採取する場合）
障害時の資料（snapshotログ）を採取しないで，セットアップウィザードを終了します。 | n | ［セットアップ失敗］画面（障害時のログを採取しない場合）

［セットアップ失敗］画面（障害時のログを採取する場合）を次に示します。

図2-42　［セットアップ失敗］画面（障害時のログを採取する場合）

［セットアップ失敗］画面（障害時のログを採取しない場合）を次に示します。

図2-43　［セットアップ失敗］画面（障害時のログを採取しない場合）

2.2.13　セットアップウィザードの終了

セットアップウィザードを終了すると，［終了確認］画面が表示されます。［終了確認］画面での操作を次に示します。

操作の流れ

セットアップウィザードを終了するかどうかを英字で入力します。

Enterキーを押します。

［終了確認］画面を次に示します。

図2-44　［終了確認］画面

設定項目

［終了確認］画面で設定する項目を次の表に示します。

表2-33　［終了確認］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップの終了 | セットアップウィザードを終了します。 | y | －
セットアップウィザードを終了しないで，直前の画面に戻ります。 | n | 直前の画面

（凡例）－：なし

2.2.14　J2EEアプリケーションのインポートと開始

J2EEアプリケーションのインポートと開始の手順について説明します。

J2EEアプリケーションのインポートと開始には，サーバ管理コマンドを使用します。

サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」，サーバ管理コマンドでのリソースアダプタの操作の詳細についてはマニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

なお，ここで説明するJ2EEアプリケーションは作成済みであることを前提としています。J2EEアプリケーションは，アプリケーション開発時に作成しておいてください。アプリケーションの作成については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

ここでは，次のJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表2-34　J2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

J2EEアプリケーションをインポートします。
サーバ管理コマンドを使用して，J2EEアプリケーションをJ2EEサーバへインポートします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp MyJ2EEServer -f MyApp.ear

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp MyJ2EEServer -f MyApp.ear

アプリケーション統合属性ファイルを取得します。
サーバ管理コマンドを使用して，アプリケーション統合属性ファイルを取得します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetappprop MyJ2EEServer -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetappprop MyJ2EEServer -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

アプリケーション統合属性ファイルを編集します。
手順2.で取得したアプリケーション統合属性ファイルを編集します。
J2EEアプリケーションのプロパティの設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の属性ファイルによるプロパティの設定についての説明，およびマニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションのプロパティ定義で設定できることについての説明を参照してください。J2EEアプリケーションのプロパティ定義で設定できる機能については，マニュアル「Cosminexus　機能解説」の各機能についての説明を参照してください。

編集したアプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。
サーバ管理コマンドを使用して，編集したアプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。-cオプションには，手順3.で編集したアプリケーション統合属性ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop MyJ2EEServer -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjsetappprop MyJ2EEServer -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

J2EEアプリケーションを開始します。
サーバ管理コマンドを使用して，J2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp MyJ2EEServer -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartapp MyJ2EEServer -name MyApp

注意

システムをセットアップしているホストと別のホストからサーバ管理コマンドを実行する場合は，-nameserverオプションを指定する必要があります。-nameserverオプションの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

2.2.15　セットアップ情報ファイルを使用した一括セットアップ

setupwizardコマンドを使用するとセットアップ情報ファイルを使用した一括セットアップができます。ここでは，セットアップ情報ファイルを使用した一括セットアップについて説明します。

セットアップ情報ファイルは，セットアップ情報の確認時に保存しているか，一度セットアップを実行している場合に保存されるファイルです。セットアップ情報ファイルには，設定済みのシステムの情報が保存されています。セットアップ情報ファイルを使用すると，設定済みの情報を適用してシステムのセットアップができます。一括セットアップで使用できるセットアップ情報ファイルの種類，および出力先については「3.2　セットアップウィザードで出力されるファイル」を参照してください。セットアップ情報ファイルの作成については「2.2.11(3)　［セットアップ情報］画面（セットアップ情報の保存）」を参照してください。

一括セットアップには，セットアップ情報ファイルの内容を確認してからセットアップを開始する方法（通常開始）と，セットアップ情報ファイルの内容を確認しないで直ちにセットアップを開始する方法（強制開始）があります。

＜この項の構成＞

(1)　一括セットアップ（通常開始）

(2)　一括セットアップ（強制開始）

(1)　一括セットアップ（通常開始）

一括セットアップ（通常開始）の操作の流れについて説明します。

操作の流れ

［一括セットアップ］画面（通常開始）での操作を次に示します。

setupwizardコマンドを実行します。
［一括セットアップ］画面（通常開始）が表示されます。

システムを一括セットアップするかどうかを数字で入力します。

Enterキーを押します。
1を選択した場合は［セットアップの実行］画面が表示されます。
2を選択した場合は［セットアップ方法の選択］画面が表示されます。

(a)　一括セットアップ（通常開始）の開始

一括セットアップ（通常開始）の開始方法はOSによって異なります。OSごとの一括セットアップの開始方法について説明します。

Windowsの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザには，Windows Vistaの場合は管理者特権，Windows Vista以外のWindowsの場合はAdministrator権限が必要です。

<Cosminexusインストールディレクトリ>¥manager¥setup¥bin¥setupwizard -f <セットアップ情報ファイル>

UNIXの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはroot権限が必要です。

# /opt/Cosminexus/manager/setup/bin/setupwizard -f <セットアップ情報ファイル>

一括セットアップ（通常開始）を開始すると，［一括セットアップ］画面（通常開始）が表示されます。なお，セットアップ済みのシステムがある場合は，［アンセットアップ要求］画面（［一括セットアップ］画面）が表示されます。

(b)　［一括セットアップ］画面（通常開始）

［一括セットアップ］画面（通常開始）の図を次に示します。

図2-45　［一括セットアップ］画面（通常開始）

設定項目

［一括セットアップ］画面（通常開始）で設定する項目を次の表に示します。

表2-35　［一括セットアップ］画面（通常開始）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップの実行 | システムをセットアップします。 | 1 | ［セットアップの実行］画面
セットアップ情報を再設定します。セットアップ情報ファイルに保存されている設定は保持されます。 | 2 | ［セットアップ方法の選択］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

(2)　一括セットアップ（強制開始）

一括セットアップ（強制開始）の操作の流れについて説明します。

操作の流れ

［一括セットアップ］画面（強制開始）での操作を次に示します。

setupwizardコマンドに-forceオプションを指定して実行します。

(a)　一括セットアップ（強制開始）の開始

一括セットアップ（強制開始）の開始方法はOSによって異なります。OSごとの一括セットアップの開始方法について説明します。

Windowsの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザには，Windows Vistaの場合は管理者特権，Windows Vista以外のWindowsの場合はAdministrator権限が必要です。

<Cosminexusインストールディレクトリ>¥manager¥setup¥bin¥setupwizard -f <セットアップ情報ファイル> -force

UNIXの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはroot権限が必要です。

# /opt/Cosminexus/manager/setup/bin/setupwizard -f <セットアップ情報ファイル> -force

コマンドを実行すると，一括セットアップ（強制開始）が開始されます。一括セットアップ（強制開始）開始後に表示される画面は一括セットアップ（強制開始）の実行結果によって異なります。一括セットアップ（強制開始）実行後に表示される画面については表2-36を参照してください。なお，セットアップ済みのシステムがある場合，［一括セットアップ］画面（アンセットアップ実行中）が表示されます。

(b)　［一括セットアップ］画面（強制開始）

一括セットアップ（強制開始）の実行後，表示される画面は一括セットアップ（強制開始）の実行結果によって異なります。一括セットアップ（強制開始）実行後に表示される画面について次の表に示します。

表2-36　一括セットアップ（強制開始）実行後に表示される画面

一括セットアップ（強制開始）の実行結果 | 実行後に表示される画面
完了 | ［一括セットアップ完了］画面（強制開始）
失敗 | ［一括セットアップ失敗］画面（強制開始）

参考

なお，一括セットアップ（強制開始）実行時に，セットアップ済みのシステムがある場合，次の画面が表示されます。

図2-46　［一括セットアップ］画面（アンセットアップ実行中）

この画面が表示されたあと，一括セットアップ（強制開始）の実行結果に従って，［一括セットアップ完了］画面（強制開始）または［一括セットアップ失敗］画面（強制開始）が表示されます。

●［一括セットアップ完了］画面（強制開始）

［一括セットアップ完了］画面（強制開始）を次に示します。

図2-47　［一括セットアップ完了］画面（強制開始）

●［一括セットアップ失敗］画面（強制開始）

［一括セットアップ失敗］画面（強制開始）を次に示します。

図2-48　［一括セットアップ失敗］画面（強制開始）

一括セットアップ（強制開始）が失敗した場合，セットアップ情報ファイルとsnapshotログが自動で保存されます。

2.2.16　アンセットアップ要求

セットアップウィザードでセットアップ済みのシステムが存在する状態でセットアップウィザードを起動すると，［アンセットアップ要求］画面が表示されます。ここでは，セットアップ済みのシステムをアンセットアップするかどうかを決定します。

［アンセットアップ要求］画面では，操作の流れに従って次のように画面が遷移します。なお，［ようこそ］画面でアンセットアップ要求があったか，［一括セットアップ］画面でアンセットアップ要求があったかによって表示される画面が異なります。

図2-49　［アンセットアップ要求］画面での画面遷移

操作の流れ

［アンセットアップ要求］画面での操作の流れを次に示します。

システムをアンセットアップするかどうかを英字で入力します。

Enterキーを押します。
yを選択すると［アンセットアップ要求］画面（アンセットアップの実施確認）が表示されます。
nを選択するとセットアップウィザードを終了します。

［アンセットアップ要求］画面（アンセットアップの実施確認）で，セットアップ済みのシステムをすべてアンセットアップするかどうかを英字で入力します。

Enterキーを押します。
yを選択すると［アンセットアップ完了］画面が表示されます。
nを選択するとセットアップウィザードを終了します。

システムをセットアップするかどうかを数字で入力します（［ようこそ］画面の場合だけ）。

Enterキーを押します。
1を選択すると［セットアップ方法の選択］画面が表示されます。
9を選択すると［終了確認］画面が表示されます。

＜この項の構成＞

(1)　［アンセットアップ要求］画面

(2)　［アンセットアップ要求］画面（アンセットアップの実施確認）

(3)　［アンセットアップ完了］画面

(1)　［アンセットアップ要求］画面

［アンセットアップ要求］画面は，［一括セットアップ］画面で表示されるか，［ようこそ］画面で表示されるかによって異なります。それぞれの［アンセットアップ要求］画面を次に示します。

［アンセットアップ要求］画面（［ようこそ］画面）
［アンセットアップ要求］画面（［ようこそ］画面）を次に示します。

図2-50　［アンセットアップ要求］画面（［ようこそ］画面）

［アンセットアップ要求］画面（［一括セットアップ］画面）
［アンセットアップ要求］画面（［一括セットアップ］画面）を次に示します。

図2-51　［アンセットアップ要求］画面（［一括セットアップ］画面）

設定項目

［アンセットアップ要求］画面で設定する項目を次の表に示します。

表2-37　［アンセットアップ要求］画面で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
アンセットアップの実行 | システムをアンセットアップします。 | y | ［アンセットアップ要求］画面（アンセットアップの実施確認）
セットアップウィザードを終了します。 | n | －

（凡例）－：該当なし

(2)　［アンセットアップ要求］画面（アンセットアップの実施確認）

［アンセットアップ要求］画面でyを入力すると，［アンセットアップ要求］画面（アンセットアップの実施確認）が表示されます。

［アンセットアップ要求］画面（アンセットアップの実施確認）を次に示します。

図2-52　［アンセットアップ要求］画面（アンセットアップの実施確認）

設定項目

［アンセットアップ要求］画面（アンセットアップの実施確認）で設定する項目を次の表に示します。

表2-38　［アンセットアップ要求］画面（アンセットアップの実施確認）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
アンセットアップの実行 | システムをアンセットアップします。 | y | ［アンセットアップ完了］画面
セットアップウィザードを終了します。 | n | －

（凡例）－：該当なし

(3)　［アンセットアップ完了］画面

［アンセットアップ要求］画面（アンセットアップの実施確認）でyを入力すると，［アンセットアップ完了］画面が表示されます。

［アンセットアップ完了］画面は，［一括セットアップ］画面で表示されるか，［ようこそ］画面で表示されるかによって異なります。それぞれの［アンセットアップ完了］画面を次に示します。

［アンセットアップ完了］画面（［ようこそ］画面）
［アンセットアップ完了］画面（［ようこそ］画面）を次に示します。

図2-53　［アンセットアップ完了］画面（［ようこそ］画面）

設定項目

［アンセットアップ完了］画面（［ようこそ］画面）で設定する項目を次の表に示します。

表2-39　［アンセットアップ完了］画面（［ようこそ］画面）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
セットアップの実行 | システムをセットアップします。 | 1 | ［セットアップ方法の選択］画面
セットアップウィザードを終了します。 | 9 | ［終了確認］画面

［アンセットアップ完了］画面（［一括セットアップ］画面）
［アンセットアップ完了］画面（［一括セットアップ］画面）を次に示します。

図2-54　［アンセットアップ完了］画面（［一括セットアップ］画面）

アンセットアップが完了すると，［一括セットアップ］画面（通常開始）が表示されます。なお，アンセットアップでエラーが発生した場合は，セットアップウィザードを終了します。

2.2.17　セットアップウィザードで設定できる項目

セットアップウィザードで設定できる項目について，画面ごとに説明します。

＜この項の構成＞

(1)　［ようこそ］画面で設定できる項目

(2)　［セットアップ方法の選択］画面で設定できる項目

(3)　［運用管理ユーザの設定］画面で設定できる項目

(4)　［運用管理機能の設定］画面で設定できる項目

(5)　［J2EEサーバの起動ユーザの設定］画面で設定できる項目

(6)　［システム構成の選択］画面で設定できる項目

(7)　［システム環境の設定］画面で設定できる項目

(8)　［データベース接続環境の設定］画面で設定できる項目

(9)　［セットアップ情報］画面で設定できる項目

(10)　［終了確認］画面で設定できる項目

(11)　［一括セットアップ］画面で設定できる項目

(1)　［ようこそ］画面で設定できる項目

［ようこそ］画面で設定できる項目について次の表に示します。［ようこそ］画面については，「2.2.3　セットアップの開始」を参照してください。

表2-40　［ようこそ］画面で設定できる項目

設定項目
設定内容
デフォルト値

セットアップの実行
システムのセットアップを実施するかどうかを設定します。次のどちらかを指定します。

1：

システムをセットアップします。

9：

セットアップウィザードを終了します。

1

アンセットアップの実行
システムのアンセットアップを実施するかどうかを設定します。次のどちらかを指定します。

y：

システムをアンセットアップします。

n：

セットアップウィザードを終了します。

なし

(2)　［セットアップ方法の選択］画面で設定できる項目

［セットアップ方法の選択］画面で設定できる項目について次の表に示します。［セットアップ方法の選択］画面については，「2.2.4　セットアップ方法の選択」を参照してください。

表2-41　［セットアップ方法の選択］画面で設定できる項目

設定項目
設定内容
デフォルト値

セットアップ方法の選択
セットアップ方法を選択します。次のどれかを指定します。

1：

標準セットアップでシステムをセットアップします。

2：

カスタムセットアップでシステムをセットアップします。

9：

セットアップウィザードを終了します。

1

(3)　［運用管理ユーザの設定］画面で設定できる項目

［運用管理ユーザの設定］画面で設定できる項目について次の表に示します。［運用管理ユーザの設定］画面については，「2.2.5　運用管理ユーザの設定」を参照してください。

表2-42　［運用管理ユーザの設定］画面で設定できる項目

設定項目
設定内容
デフォルト値

運用管理ユーザアカウントのユーザIDの設定
Management Serverの管理ユーザアカウントのユーザIDが現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在設定されているユーザIDをManagement Serverの管理ユーザアカウントのユーザIDとして設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

運用管理ユーザアカウントのユーザID
Management Serverの管理ユーザアカウントのユーザIDを半角英数字，一部の半角特殊文字※，および半角スペース1文字以上で指定します。
admin

運用管理ユーザアカウントのパスワード
Management Serverの管理ユーザアカウントのパスワードを半角英数字，一部の半角特殊文字※，および半角スペース0文字以上で指定します。空文字も入力値となります。
なし

注※

入力できる半角特殊文字について次に示します。

! # $ & ' ( ) * + , - . / : ; < = > ? @ [ ] ^ _ ` { | } ~

(4)　［運用管理機能の設定］画面で設定できる項目

［運用管理機能の設定］画面で設定できる項目について次の表に示します。［運用管理機能の設定］画面については，「2.2.6　運用管理機能の設定」を参照してください。

表2-43　［運用管理機能の設定］画面で設定できる項目

設定項目
設定内容
デフォルト値

運用管理機能の設定
Management Serverの設定が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在の設定値をManagement Serverの設定値として設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

Management Server接続HTTPポート番号
Management Server接続HTTPポート番号を1-65535の整数値で指定します。
28080

Management Server終了要求受信ポート番号
Management Server終了要求受信ポート番号を1-65535の整数値で指定します。
28005

Management Server内部通信用ポート番号
Management Server内部通信用ポート番号を1-65535の整数値で指定します。
28009

運用管理エージェントのポート番号
運用管理エージェントのポート番号を1-65535の整数値で指定します。
20295

Management Server管理グループに設定するグループ※
Management Server管理グループに設定するグループを1文字以上で指定します。

AIXの場合
system

HP-UXの場合
sys

Linuxの場合
root

Solarisの場合
sys

注※

UNIXの場合だけ設定できます。

(5)　［J2EEサーバの起動ユーザの設定］画面で設定できる項目

［J2EEサーバの起動ユーザの設定］画面で設定できる項目について次の表に示します。［J2EEサーバの起動ユーザの設定］画面については，「2.2.7　J2EEサーバの起動ユーザの設定」を参照してください。

表2-44　［J2EEサーバの起動ユーザの設定］画面で設定できる項目

設定項目
設定内容
デフォルト値

J2EEサーバの起動ユーザの設定
Component Container管理者の設定が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在の設定値をComponent Container管理者の設定値として設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

Component Container管理者
Component Container管理者を1文字以上で指定します。
root

Component Container管理者グループ
Component Container管理者グループを1文字以上で指定します。

AIXの場合
system

HP-UXの場合
sys

Linuxの場合
root

Solarisの場合
sys

(6)　［システム構成の選択］画面で設定できる項目

［システム構成の選択］画面で設定できる項目について次の表に示します。［システム構成の選択］画面については，「2.2.8　システム構成の選択」を参照してください。

表2-45　［システム構成の選択］画面で設定できる項目

設定項目
設定内容
デフォルト値

システム構成の選択（システム構成の確認）
システム構成が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在設定されている構成をシステム構成として設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

システム構成の選択
システム構成を選択します。次のどちらかを指定します。

1：

WebサーバとJ2EEサーバを配置するシステム構成を選択します。

2：

Webサーバ機能を持つJ2EEサーバだけを配置するシステム構成を選択します。

1

(7)　［システム環境の設定］画面で設定できる項目

［システム環境の設定］画面で設定できる項目について次の表に示します。［システム環境の設定］画面については，「2.2.9　システム環境の設定」を参照してください。

表2-46　［システム環境の設定］画面で設定できる項目

設定項目
設定内容
デフォルト値

システム環境の設定（システム環境の確認）
システム環境が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在設定されている環境をシステム環境として設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

Webシステム名
Webシステム名を半角英数字，記号（アンダースコア，ハイフン）32文字以内で指定します。
MyWebSystem

Webサーバの設定
Webサーバのポート番号※1
Webサーバのポート番号を1-65535の整数値で指定します。
80

J2EEサーバの設定
httpのポート番号※2
J2EEサーバのhttpのポート番号を1-65535の整数値で指定します。※3
80

管理用サーバのポート番号
J2EEサーバの管理用サーバのポート番号を1-65535の整数値で指定します。※3
8080

ajp13のポート番号※1
J2EEサーバのajp13のポート番号を1-65535の整数値で指定します。※3
8007

インプロセスのネーミングサービスのポート番号
J2EEサーバで使用するインプロセスのネーミングサービスのポート番号を1-65535の整数値で指定します。※3
900

RMIレジストリのポート番号
J2EEサーバのRMIレジストリのポート番号を1-65535の整数値で指定します。※3
23152

注※1

システム構成がWebサーバとJ2EEサーバを配置する構成（combined-tier）のときだけ設定できます。

注※2

システム構成がJ2EEサーバだけを配置する構成（j2ee-tier）のときだけ設定できます。

注※3　

［J2EEサーバの起動ユーザの設定］画面（設定内容変更）でComponent Container管理者を設定済みの場合，1024-65535の整数値で指定します。

(8)　［データベース接続環境の設定］画面で設定できる項目

［データベース接続環境の設定］画面で設定できる項目について次の表に示します。［データベース接続環境の設定］画面については，「2.2.10　データベース接続環境の設定」を参照してください。

表2-47　［データベース接続環境の設定］画面で設定できる項目

設定項目
設定内容
デフォルト値

データベースの接続設定
データベースの接続を設定するかどうかを指定します。次のどちらかを指定します。

y：

設定します。

n：

設定しません。

y

使用するデータベースの選択
使用するデータベースを設定します。次のどちらかを指定します。

1：

HiRDB（バージョン8以降）を使用します。

2：

Oracle（バージョン9i以降）を使用します。

1

データベース名（SID）※1
データベース名（SID）を1文字以上で指定します。
なし

データベースのホスト名
データベースのホスト名を1文字以上で指定します。
なし

データベースのポート番号
データベースのポート番号を1-65535の整数値で指定します。

HiRDBの場合
22200

Oracleの場合
1521

データベースのアクセスユーザ
データベースのアクセスユーザを0文字以上で指定します。
なし

アクセスユーザのパスワード
アクセスユーザのパスワードを0文字以上で指定します。
なし

JDBCドライバのパス
JDBCドライバのパスを1文字以上-OSの最大パス長※2以下の絶対パスで指定します。
なし

データベース接続環境の設定（データベース接続環境の確認）
データベース接続環境が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在設定されているデータベース接続環境をデータベース接続環境として設定します。

2：

設定内容を変更します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

1

注※1

使用するデータベースがOracleのときだけ設定できます。

注※2

「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。ただし，使用するOSがWindowsの場合，最大パス長は259です。

(9)　［セットアップ情報］画面で設定できる項目

［セットアップ情報］画面で設定できる項目について次の表に示します。［セットアップ情報］画面については，「2.2.11　セットアップ情報の確認」を参照してください。

表2-48　［セットアップ情報］画面で設定できる項目

設定項目
設定内容
デフォルト値

セットアップ情報の確認
セットアップ情報が現在の設定でよいかどうかを設定します。次のどれかを指定します。

1：

現在設定されているセットアップ情報でセットアップを開始します。

2：

セットアップ情報を再設定します。現在の設定は保持されます。

3：

セットアップ情報をファイルに保存します。

0：

前の画面に戻ります。

9：

セットアップウィザードを終了します。

なし

セットアップ情報（セットアップ情報の再設定）
セットアップ情報を再設定するかどうかを設定します。次のどちらかを指定します。

y：

セットアップ情報を再設定します。現在の設定は保持されます。

n：

セットアップ情報を再設定しないで，前の画面に戻ります。

なし

セットアップ情報（セットアップ情報ファイルの上書き）
セットアップ情報ファイルを上書きするかどうかを設定します。次のどちらかを指定します。

y：

セットアップ情報ファイルを上書きします。

n：

セットアップ情報ファイルを作成しないで，前の画面に戻ります。

なし

(10)　［終了確認］画面で設定できる項目

［終了確認］画面で設定できる項目について次の表に示します。［終了確認］画面については，「2.2.13　セットアップウィザードの終了」を参照してください。

表2-49　［終了確認］画面で設定できる項目

設定項目
設定内容
デフォルト値

セットアップの終了
セットアップを終了するかどうかを設定します。次のどちらかを指定します。

y：

セットアップウィザードを終了します。

n：

セットアップウィザードを終了しないで，前の画面に戻ります。

なし

(11)　［一括セットアップ］画面で設定できる項目

［一括セットアップ］画面で設定できる項目について次の表に示します。［一括セットアップ］画面については，「2.2.15　セットアップ情報ファイルを使用した一括セットアップ」を参照してください。

表2-50　［一括セットアップ］画面で設定できる項目

設定項目
設定内容
デフォルト値

セットアップの実行
システムのセットアップを実行するかどうかを設定します。次のどれかを指定します。

1：

システムをセットアップします。

2：

セットアップ情報を再設定します。セットアップ情報ファイルに保存されている設定は保持されます。

9：

セットアップウィザードを終了します。

なし

アンセットアップの実行
アンセットアップを実行するかどうかを設定します。次のどちらかを指定します。

y：

システムをアンセットアップします。

n：

セットアップウィザードを終了します。

なし

2.3　システムの運用

セットアップウィザードでセットアップしたシステムの次の運用項目について説明します。

セットアップウィザードでセットアップしたシステムの起動と停止

チューニング

システムのアンセットアップ

なお，システムを運用する前に，運用管理エージェントおよびManagement Serverの自動起動の設定をする必要があります。運用管理エージェントの自動起動の設定については，「6.5.3(2)　運用管理エージェントの自動起動の設定」を参照してください。Management Serverの自動起動の設定については，「6.6.2(3)　Management Serverの自動起動の設定」を参照してください。

＜この節の構成＞

2.3.1　セットアップウィザードでセットアップしたシステムの起動と停止

2.3.2　チューニング

2.3.3　システムのアンセットアップ

2.3.1　セットアップウィザードでセットアップしたシステムの起動と停止

セットアップウィザードでセットアップしたシステムの起動と停止には，Smart Composer機能のコマンドを使用します。

Smart Composer機能のコマンドを使用する場合，事前に環境変数の設定が必要です。環境変数の設定については，マニュアル「Cosminexus　システム構築ガイド」の環境変数の設定に関する説明を参照してください。

システムを起動する前に，運用管理エージェントおよびManagement Serverが起動していない場合は運用管理エージェントおよびManagement Serverを起動してください。運用管理エージェントの起動については，「6.5.3(1)　運用管理エージェントの起動」を参照してください。Management Serverの起動については，「6.6.2(2)　Management Serverの起動」を参照してください。

システムの起動方法と停止方法について説明します。

●システムの起動

cmx_start_targetコマンドを使用して，システムを起動します。cmx_start_targetコマンドのオプションに指定する値については表2-51を参照してください。

ここでは，cmx_start_targetコマンドのオプションに指定する値がすべてデフォルト値である場合の実行例を説明します。

次にコマンドの実行例を示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m localhost:28080 -u admin -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m localhost:28080 -u admin -s MyWebSystem -mode ALL

cmx_start_targetコマンドのオプションに指定する値について，次の表に示します。

表2-51　cmx_start_targetコマンドのオプションに指定する値

オプション | 指定する値 | 設定内容 | 参照先
-m | localhost:<ポート番号> | <ポート番号>にManagement Server接続HTTPポート番号を指定します。 | 「2.2.6　運用管理機能の設定」
-u | <管理ユーザID> | Management Serverの管理ユーザIDを指定します。 | 「2.2.5　運用管理ユーザの設定」
-p※1 | <管理パスワード> | Management Serverの管理ユーザIDのパスワードを指定します。
-s | <Webシステム名> | Webシステム名を指定します。 | 「2.2.9　システム環境の設定」
-mode | ALL※2 | － | －

（凡例）－：該当なし

注※1

指定を省略できます。

注※2

必ずこの値を指定してください。

cmx_start_targetコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_start_target」を参照してください。

●システムの停止

cmx_stop_targetコマンドを使用して，システムを停止します。cmx_stop_targetコマンドのオプションに指定する値については表2-51を参照してください。

ここでは，cmx_stop_targetコマンドのオプションに指定する値がすべてデフォルト値である場合の実行例を説明します。

次にコマンドの実行例を示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:28080 -u admin -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m localhost:28080 -u admin -s MyWebSystem -mode ALL

cmx_stop_targetコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_stop_target」を参照してください。

2.3.2　チューニング

セットアップウィザードでセットアップしたシステムのチューニングには，Smart Composer機能または運用管理ポータルを使用します。

チューニングする項目については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。

Smart Composer機能を使用したシステムのチューニングの方法については，「6.12　チューニング」を参照してください。運用管理ポータルを使用したシステムのチューニングの方法については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

2.3.3　システムのアンセットアップ

setupwizardコマンドを使用するとシステムのアンセットアップができます。ここでは，setupwizardコマンドを使用したアンセットアップについて説明します。setupwizardコマンドの詳細については，「3.1　setupwizardコマンド（システムのセットアップとアンセットアップ）」を参照してください。

注意

セットアップウィザードでセットアップしていないシステムはアンセットアップできません。

セットアップしたシステムに対して，セットアップウィザード以外の方法でシステムの設定変更やファイルの追加などを実施している場合，設定情報やファイルが削除されるときがあります。

＜この項の構成＞

(1)　アンセットアップの開始

(2)　［アンセットアップ］画面（アンセットアップの実施決定）

(3)　［アンセットアップ］画面

(1)　アンセットアップの開始

アンセットアップには，アンセットアップするかどうかを確認してからアンセットアップを開始する方法（通常開始）と，アンセットアップするかどうかを確認しないで直ちにアンセットアップを開始する方法（強制開始）があります。それぞれについて説明します。

(a)　アンセットアップ（通常開始）

アンセットアップ（通常開始）の開始方法はOSによって異なります。OSごとのアンセットアップの開始方法について説明します。

Windowsの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはWindows Vistaの場合は管理者特権，Windows Vista以外のWindowsの場合はAdministrator権限が必要です。

<Cosminexusインストールディレクトリ>¥manager¥setup¥bin¥setupwizard -clean

UNIXの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはroot権限が必要です。

# /opt/Cosminexus/manager/setup/bin/setupwizard -clean

アンセットアップ（通常開始）を開始すると，［アンセットアップ］画面（アンセットアップの実施決定）が表示されます。

(b)　アンセットアップ（強制開始）

アンセットアップ（強制開始）の開始方法はOSによって異なります。OSごとのアンセットアップの開始方法について説明します。

Windowsの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはWindows Vistaの場合は管理者特権，Windows Vista以外のWindowsの場合はAdministrator権限が必要です。

<Cosminexusインストールディレクトリ>¥manager¥setup¥bin¥setupwizard -clean -force

UNIXの場合

次のコマンドをコマンドプロンプトで実行します。なお，実行するユーザにはroot権限が必要です。

# /opt/Cosminexus/manager/setup/bin/setupwizard -clean -force

-forceを指定してアンセットアップ（強制開始）を開始すると，［アンセットアップ］画面が表示されます。

(2)　［アンセットアップ］画面（アンセットアップの実施決定）

アンセットアップを開始すると，［アンセットアップ］画面（アンセットアップの実施決定）が表示されます。ここでは，アンセットアップを実施するかどうかを決定します。

［アンセットアップ］画面（アンセットアップの実施決定）の図を次に示します。

図2-55　［アンセットアップ］画面（アンセットアップの実施決定）

(a)　操作の流れ

［アンセットアップ］画面（アンセットアップの実施決定）での操作を次に示します。

システムをアンセットアップするかどうかを英字で入力します。

Enterキーを押します。

(b)　設定項目

［アンセットアップ］画面（アンセットアップの実施決定）で設定する項目を次の表に示します。

表2-52　［アンセットアップ］画面（アンセットアップの実施決定）で設定する項目

設定項目 | 設定内容 | 入力値 | 設定後に表示される画面
アンセットアップの実行 | システムをアンセットアップします。 | y | ［アンセットアップ］画面
セットアップウィザードを終了します。 | n | －

（凡例）－：該当なし

(3)　［アンセットアップ］画面

アンセットアップ（通常開始）およびアンセットアップ（強制開始）の実行後，表示される画面はアンセットアップの実行結果によって異なります。アンセットアップ実行後に表示される画面について次の表に示します。

表2-53　アンセットアップ実行後に表示される画面

アンセットアップの実行結果 | 実行後に表示される画面
完了 | ［アンセットアップ完了］画面
エラーが発生して失敗 | ［アンセットアップ失敗］画面（エラーが発生した場合）
セットアップウィザードでセットアップしていないシステムに対して実行して失敗 | ［アンセットアップ失敗］画面（アンセットアップできないシステムの場合）

(a)　［アンセットアップ完了］画面

［アンセットアップ完了］画面を次に示します。

図2-56　［アンセットアップ完了］画面

(b)　［アンセットアップ失敗］画面（エラーが発生した場合）

［アンセットアップ失敗］画面（エラーが発生した場合）を次に示します。

図2-57　［アンセットアップ失敗］画面（エラーが発生した場合）

(c)　［アンセットアップ失敗］画面（アンセットアップできないシステムの場合）

［アンセットアップ失敗］画面（アンセットアップできないシステムの場合）を次に示します。

図2-58　［アンセットアップ失敗］画面（アンセットアップできないシステムの場合）

3.　セットアップウィザードで使用するコマンドとファイル

この章では，セットアップウィザードで使用するコマンドやファイルについて説明します。

＜この章の構成＞

3.1　setupwizardコマンド（システムのセットアップとアンセットアップ）

3.2　セットアップウィザードで出力されるファイル

3.1　setupwizardコマンド（システムのセットアップとアンセットアップ）

setupwizardコマンドについて説明します。

＜この節の構成＞

setupwizardコマンド

setupwizardコマンド

形式

セットアップウィザードの起動
setupwizard

セットアップ情報ファイルを使用した一括セットアップ
setupwizard -f <セットアップ情報ファイル> [-force]

アンセットアップ
setupwizard -clean [-force]

機能

セットアップウィザードの起動
セットアップウィザードを起動します。

セットアップ情報ファイルを使用した一括セットアップ
-fオプションに指定したセットアップ情報ファイルの情報に従って，一括セットアップをします。-forceオプションを指定すると，セットアップ情報ファイルの内容を確認しないで一括セットアップをします。

アンセットアップ
セットアップウィザードでセットアップしたシステムのアンセットアップをします。-forceオプションを指定すると，アンセットアップをするかどうか確認しないでアンセットアップをします。

引数

-f <セットアップ情報ファイル>

セットアップ情報ファイルのパスを指定します。

-clean

システムのアンセットアップをする場合に指定します。

-force

セットアップ情報ファイルを使用した一括セットアップおよびアンセットアップを，処理の実施確認をしないで実施するときに指定します。

入力例

セットアップウィザードの起動
setupwizard

セットアップ情報ファイルを使用した一括セットアップ
setupwizard -f <Cosminexusインストールディレクトリ>/manager/setup/config/setupwizard.dat -force

実施確認をしないアンセットアップ
setupwizard -clean -force

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

注意事項

コマンドを実行できるユーザは次のとおりです。次に示すユーザ以外がコマンドを実行した場合，エラーとなります。

Windows Vista の場合

管理者特権のあるユーザ

Windows Vista以外のWindowsの場合

Administrator権限のあるユーザ

UNIXの場合

root権限のあるユーザ

コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。停止した場合は再度セットアップウィザードを実行してください。再度セットアップウィザードを実行してもエラーが発生する場合は，OSを再起動してください。

3.2　セットアップウィザードで出力されるファイル

セットアップウィザードで出力するファイルの一覧を，次の表に示します。

表3-1　セットアップウィザードで出力するファイルの一覧

分類
ファイル名称
概要
出力先

セットアップ情報リスト
setupwizardlist.txt
セットアップ処理完了（成功）後出力されます。
セットアップウィザードで構築した環境を確認するためのファイルです。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥setup¥config

UNIXの場合
<Cosminexusインストールディレクトリ>/manager/setup/config

セットアップ情報ファイル
setupwizard.dat
［セットアップ情報］画面で「セットアップ情報を保存する」を選択した場合に出力されます。
一括セットアップで使用できます。

setupwizard_success.dat
セットアップ処理完了（成功）後に自動的に出力されます。
一括セットアップで使用できます。

setupwizard_failed.dat
セットアップ処理完了（失敗）後に自動的に出力されます。
一括セットアップで使用できます。
ただし，このファイルを使用して一括セットアップをする場合は，セットアップ処理失敗の原因を取り除く必要があります。

ログファイル
setupwizard<ファイル面数>.log
セットアップウィザードのログが出力されます。

最大ファイルサイズ：32MB

最大ファイル面数：4

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥setup¥log

UNIXの場合
<Cosminexusインストールディレクトリ>/manager/setup/log

4.　J2EEアプリケーションを実行するシステムの構成の検討

システムを構築する前に，まず，システムの構成を検討します。

この章では，Smart Composer機能で構築するJ2EEアプリケーションを実行するシステムを構成する要素や，プロセス，製品などについて説明します。また，Smart Composer機能で構築できるJ2EEアプリケーションを実行するシステムの構成パターンについて説明します。

＜この章の構成＞

4.1　システムの構成

4.2　製品構成およびプロセス構成

4.3　システム構成パターン

4.4　JP1/SC/DPMを利用して構築する場合のシステム構成

4.1　システムの構成

ここでは，Smart Composer機能で構築，運用するシステムの概要や，システムを構成する要素について説明します。

Smart Composer機能で構築，運用するシステムは，負荷分散機，J2EEサーバなどが動作するアプリケーションサーバマシン，データベースが構築されているデータベースサーバマシン，アプリケーションサーバ全体を運用管理するための機能を集約したサーバである運用管理サーバマシンなどで構成されます。J2EEアプリケーションを実行するシステムの概要を次の図に示します。

図4-1　J2EEアプリケーションを実行するシステムの概要

Smart Composer機能では，システム内のサーバやサービスユニットの構成をWebシステムという概念で管理します。Webシステムは，人事システムや給与システムなどの一つの業務システムに対応し，Management Serverが管理，運用する運用管理ドメイン内に複数配置できます。なお，異なるWebシステム間でも，同じ負荷分散機や，同じサーバマシン（ホスト）を共有できます。異なるWebシステム間で同じ負荷分散機を共有する場合の設定は，使用する負荷分散機によって異なります。負荷分散機を共有する場合の設定については，「6.17.1(2)　異なるWebシステムのサービスユニットを1台のサーバマシンに配置する場合」を参照してください。また，同じホストを共有する場合の設定については，「6.17　サーバマシン内に複数のサービスユニットを配置する場合に必要な設定」を参照してください。

運用管理ドメイン内では，Webシステムおよびサーバマシン（ホスト）をIDで識別して管理しています。このため，Webシステムおよびサーバマシン（ホスト）のIDは，運用管理ドメイン内で一意になるように設定してください。

参考

Smart Composer機能では，Management Serverを運用管理サーバマシンに配置する運用管理サーバモデルで，システムを構築します。ただし，JP1/SC/DPMを利用すると，Management Serverをアプリケーションサーバマシン（ホスト）ごとに配置するホスト単位管理モデルでも，システムを構築できます。JP1/SC/DPMを利用したシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

また，Smart Composer機能では，Webシステム内のサーバマシンの集合や，サーバの集合を，それぞれ物理ティア，サービスユニットという論理的なまとまりで扱っています。また，サービスユニット内に配置する論理サーバの構成は，物理ティアの種類によって決まります。次に，物理ティアおよびサービスユニットについて説明します。

＜この節の構成＞

(1)　物理ティア

(2)　サービスユニット

(1)　物理ティア

同一のデプロイメント（プロセスの配置，J2EEアプリケーションやリソースアダプタのデプロイ，定義設定）を適用するサーバマシンの集合を物理ティアといいます。J2EEアプリケーションを実行するシステムで使用できる物理ティアには，combined-tier，http-tier，j2ee-tier，sfo-tier，ctm-tier，およびfree-tierの6種類があります。

参考

構築するシステム構成（Webフロントシステムまたはバックシステム）によって，指定できる物理ティアが異なります。システム構成と指定できる物理ティアの関係については，「4.3　システム構成パターン」を参照してください。

(a)　combined-tier

業務サービス用の物理ティアで，アプリケーションサーバマシンの中に，Webサーバ，J2EEサーバ，およびパフォーマンストレーサ（PRFデーモン）の三つの論理サーバを配置する構成です。combined-tierのシステム構成については，「4.3.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成」を参照してください。

(b)　http-tier

業務サービス用の物理ティアで，Webサーバ側のマシンの集合です。

Webサーバマシンの中に，Webサーバ，およびパフォーマンストレーサ（PRFデーモン）の二つの論理サーバを配置する構成です。http-tierは，WebサーバとJ2EEサーバを配置するマシンを分けたい場合に，j2ee-tierと組み合わせて利用します。http-tierのシステム構成については，「4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成」を参照してください。

(c)　j2ee-tier

業務サービス用の物理ティアで，J2EEサーバ側のマシンの集合です。

アプリケーションサーバマシンの中に，J2EEサーバ，およびパフォーマンストレーサ（PRFデーモン）の二つの論理サーバを配置する構成です。

j2ee-tierは，http-tierと組み合わせて利用する場合と，http-tierと組み合わせないで利用する場合があります。別マシンに配置したWebサーバを使用してクライアントからのリクエストを受け付けたい場合は，http-tierと組み合わせて利用します。J2EEサーバだけでクライアントからのリクエストを受け付けたい場合は，http-tierと組み合わせないで，j2ee-tierだけで利用します。それぞれの場合について，次に示します。

http-tierと組み合わせて利用する場合

WebサーバとJ2EEサーバを配置するマシンを分けたい場合に，http-tierと組み合わせて利用します。j2ee-tierのシステム構成については，「4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成」を参照してください。

http-tierと組み合わせないで利用する場合

J2EEサーバだけでクライアントからのリクエストを受け付けたい場合，インプロセスHTTPサーバ機能を使用します。インプロセスHTTPサーバ機能を使用する場合のj2ee-tierのシステム構成については，「4.3.3　インプロセスHTTPサーバ機能を使用する構成」を参照してください。なお，インプロセスHTTPサーバ機能の概要については，マニュアル「Cosminexus　機能解説」のインプロセスHTTPサーバによるリクエストの受け付けに関する説明を参照してください。

(d)　sfo-tier

セッションフェイルオーバ用の物理ティアで，セッションフェイルオーバサーバマシンの中に，セッションフェイルオーバサーバ（SFOサーバ），およびパフォーマンストレーサ（PRFデーモン）の二つの論理サーバを配置する構成です。セッションフェイルオーバサーバは，セッションフェイルオーバ機能を使用する場合に必要になります。sfo-tierは，WebフロントシステムのJ2EEサーバを配置したほかの物理ティアと組み合わせて利用します。sfo-tierのシステム構成については，「4.3.5　セッションフェイルオーバ機能を使用する構成」を参照してください。

(e)　ctm-tier

CTM用の物理ティアで，次に示すマシンの中に，CTM関連の論理サーバや，J2EEサーバなどを配置する構成です。CTMを使用する場合に必要になります。

アプリケーションサーバマシン
CTMドメインマネジャ，CTM，スマートエージェント，J2EEサーバ，およびパフォーマンストレーサ（PRFデーモン）の五つの論理サーバを配置します。

統合ネーミングスケジューラサーバマシン
CTMドメインマネジャ，CTM，スマートエージェント，およびパフォーマンストレーサ（PRFデーモン）の四つの論理サーバを配置します。

CTMドメインマネジャ，CTMおよびスマートエージェントは，CTMを利用したシステムを構築する場合に必要になります。ctm-tierは，ほかの物理ティアとは別のWebシステムに属し，バックシステムとして単独で利用できます。ctm-tierのシステム構成については，「4.3.6　CTMを使用する構成」を参照してください。

(f)　free-tier

ほかのどの物理ティアの構成にも当てはまらない構成です。ほかの物理ティアとは異なり，システムを構築する場合には使用しないで，運用管理ポータルなどで構築したシステムをほかの環境に移行する場合に使用します。運用管理ポータルなどを使用して構築したシステムの内容を簡易構築定義ファイルに出力する場合，ほかのどの物理ティアの構成にも当てはまらない構成が含まれていると，その構成がfree-tier構成として出力されます。

free-tier構成には，Webシステム名，およびサービスユニット名がありません。そのため，free-tier構成を含むシステムに対して，Smart Composer機能のコマンドでできる操作は，システムの構築，起動および停止です。そのほかの操作は，Smart Composer機能のコマンドでは実施できません。

(2)　サービスユニット

業務サービスを提供する，閉じた部分系などのサーバの集合をサービスユニットといいます。サービスユニットは，サーバの起動・停止，J2EEアプリケーションの入れ替え時の閉塞処理，スケールアウトなどの単位となります。

サービスユニットは，1台のサーバマシンに複数配置でき，サーバマシン内のサーバは，サービスユニット単位で増やすことができます。また，異なるWebシステムのサービスユニットを，1台のサーバマシンに配置することもできます。複数のサービスユニットを配置するシステム構成の詳細については，「4.3.7　サーバマシン内に複数のサービスユニットを配置する構成」を参照してください。

参考

サービスユニットを配置するサーバマシンには，構築済みのWebシステムなどで使用しているマシンを指定することもできます。

サービスユニットには，サービスユニットを配置するサーバマシンが属する物理ティアによって，業務サービスを提供するものや，セッション情報を管理するものなどがあります。サービスユニットの種類と，サービスユニットを構成するプロセスを次の表に示します。なお，構築するシステムごとに配置するプロセスについては，「4.3　システム構成パターン」を参照してください。

表4-1　サービスユニットの種類と，サービスユニットを構成するプロセス

物理ティアの種類 | サービスユニットの種類 | サービスユニットを構成するプロセス | 1サービスユニットに配置できる数
combined-tier | 業務サービス用のサービスユニット | J2EEサーバ | 1
Webサーバ | 1
PRFデーモン | 1
ユーザサーバ | 0～n
http-tier※ | 業務サービス用のサービスユニット | Webサーバ | 1
PRFデーモン | 1
ユーザサーバ | 0～n
j2ee-tier | 業務サービス用のサービスユニット | J2EEサーバ | 1
PRFデーモン | 1
ユーザサーバ | 0～n
sfo-tier | セッションフェイルオーバ用のサービスユニット | SFOサーバ | 1
PRFデーモン | 1
ユーザサーバ | 0～n
ctm-tier | CTM用のサービスユニット | CTMドメインマネジャ | 1
CTM | 1
スマートエージェント | 1
J2EEサーバ | 1～32
PRFデーモン | 1
ユーザサーバ | 0～n
統合ネーミングスケジューラサーバ用のサービスユニット | CTMドメインマネジャ | 1
CTM | 1
スマートエージェント | 1
PRFデーモン | 1
ユーザサーバ | 0～n

注※　http-tierはj2ee-tierと組み合わせて使用します。サービスユニットは，http-tierとj2ee-tierに属するサーバマシンに配置するサーバの組み合わせで構成されます。詳細については，「4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成」を参照してください。

次に，サービスユニットを構成する各プロセスについて説明します。

(a)　J2EEサーバ

J2EEサーバは，J2EEアプリケーションの実行基盤となるプロセスです。

(b)　Webサーバ

Webサーバは，Webブラウザからのリクエスト受信，およびWebブラウザへのデータ送信に関連する処理を実行するプロセスです。

(c)　PRFデーモン（パフォーマンストレーサ）

アプリケーションサーバは，リクエストを処理するときにトレース情報をバッファへ出力します。PRFデーモン（パフォーマンストレーサ）は，バッファに出力されたトレース情報をファイルに出力するためのI／Oプロセスです。

(d)　ユーザサーバ

ユーザが定義する任意のプロセスです。ユーザサーバは，論理ユーザサーバとして定義することで，Management Serverで運用・管理できるようになります。論理ユーザサーバを特定のサービスユニットに関連づけると，サービスユニットの起動／停止と同時に，ユーザサーバも起動したり，停止したりできます。

参考

複数のユーザサーバを，一つのサービスユニットに関連づけることができますが，一つのユーザサーバを，複数のサービスユニットに関連づけることはできません。

(e)　SFOサーバ（セッションフェイルオーバサーバ）

セッションフェイルオーバ機能を使用する場合に，J2EEサーバ間のセッション情報を管理するためのプロセスです。

(f)　CTMドメインマネジャ

同じCTMドメイン内のCTMデーモンの情報を管理するプロセスです。CTMデーモンを配置したホスト上に一つずつ配置します。CTMドメインは，複数のCTMデーモン間で，それぞれに登録された業務処理プログラムの情報やスケジュールキューの負荷情報を交換して，情報共有と負荷分散をする範囲のことで，ドメイン名称で識別されます。

(g)　CTM

J2EEアプリケーション内のStateless Session Beanに対するリクエストをスケジューリングするためのプロセス群です。CTMを使用すると，クライアントからのリクエストを適切に分散し，スケジューリングできます。CTMは，次に示すプロセスから構成されています。

CTMデーモン
クライアントからのリクエストを制御するスケジュールキューを管理するプロセスです。

CTMレギュレータ
CTMデーモンに集中するリクエストを，分散集約するためのプロセスです。

グローバルCORBAネーミングサービス
同じCTMドメイン内に含まれるホスト上の業務処理プログラムの情報を共有管理しているネーミングサービスです。

(h)　スマートエージェント

Cosminexus TPBrokerで提供されている，動的な分散ディレクトリサービスを提供するプロセスです。異なるネットワークセグメントにあるCTMデーモンに情報を配布する場合に使用されます。詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R)　デベロッパーズガイド」を参照してください。

4.2　製品構成およびプロセス構成

J2EEアプリケーションを実行するシステムには，Webフロントシステムとバックシステムの2種類があります。ここでは，Smart Composer機能を使用して，これらのシステムを構築する場合に，必要な製品構成およびプロセス構成について説明します。なお，Webフロントシステムおよびバックシステムの定義については，マニュアル「Cosminexus　システム設計ガイド」のCosminexusのシステム構成の分類に関する説明を参照してください。Smart Composer機能を使用して構築できるシステムの構成パターンについては，「4.3　システム構成パターン」を参照してください。

＜この節の構成＞

4.2.1　Webフロントシステムの製品構成とプロセス構成

4.2.2　バックシステムの製品構成とプロセス構成

4.2.1　Webフロントシステムの製品構成とプロセス構成

Smart Composer機能を使用して，Webフロントシステムを構築する場合に，必要な製品構成およびプロセス構成を次の図に示します。

図4-2　製品構成およびプロセス構成（Webフロントシステムの場合）

Webフロントシステムの場合は，一つのWebシステム内に，Webブラウザから送信されるリクエストを受け付けて，処理するアプリケーションサーバを構築します。Webブラウザから送信されるリクエストの振り分けには，負荷分散機を使用します。

システム内のサーバと，使用する製品について説明します。

＜この項の構成＞

(1)　負荷分散機

(2)　アプリケーションサーバマシン

(3)　データベースサーバマシン

(4)　運用管理サーバマシン

(1)　負荷分散機

負荷分散機では，一つの仮想IPアドレスで複数のサーバを管理するロードバランシング機能によって，トラフィックを効率的に分散し，処理性能を向上できます。負荷分散機は，Smart Composer機能から制御できます。Smart Composer機能で使用できる負荷分散機の種類を次に示します。

BIG-IP 1500

BIG-IP 1000

HA8000-ie/Loadflowbal

Smart Composer機能で構築したシステムは，負荷分散機のCookieスイッチング機能を使用して運用することもできます。Cookieスイッチング機能とは，Cookieを利用してセッションを維持する機能です。プロキシ経由などで要求元IPアドレスからクライアントが特定できない場合でも，同じクライアントからの一連のHTTPリクエストを同じサービスユニットに振り分けることができます。

参考

BIG-IP 1500およびBIG-IP 1000のCookieスイッチング機能のうち，Smart Composer機能で対応しているスイッチングモードはハッシュモードだけです。

また，Smart Composer機能で構築したシステムでは，異なるWebシステム間や，異なる運用管理ドメインの同じWebシステム間で同じ負荷分散機を共有したり，一つのWebシステム内で負荷分散機を冗長化構成で配置したりできます。

注意

インプロセスHTTPサーバ機能を使用する構成，およびfree-tierを利用したシステム構成では，負荷分散機を配置できません。

(a)　負荷分散機の制御方法

Cosminexusから負荷分散機を制御する方法には，次の3種類があります。

sshコマンドを使用して制御する方法
ssh接続を利用できる負荷分散機は，BIG-IP 1500です。sshコマンドを使用して制御する場合は，「6.7　Cosminexusから負荷分散機を制御するための設定」を実施します。

Telnetを直接使用して制御する方法
Telnet接続を利用できる負荷分散機は，BIG-IP 1000，およびHA8000-ie/Loadflowbalです。Telnetを直接使用して制御する場合は，「6.7　Cosminexusから負荷分散機を制御するための設定」を実施します。

JP1/Cm2/NCを使用して制御する方法
JP1/Cm2/NCは，負荷分散機を含むスイッチ機器の設定を一元管理したい場合に利用します。JP1/Cm2/NCを使用して負荷分散機を制御する場合は，「付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定」を実施します。なお，JP1/Cm2/NCを使用して制御する場合，BIG-IP 1500は使用できません。

(b)　Webシステム間での負荷分散機の共有

Smart Composer機能で構築するWebシステムでは，異なるWebシステム間で，同じ（1台の）負荷分散機を共有できます。異なるWebシステム間で1台の負荷分散機を共有する場合の設定は，使用する負荷分散機によって異なります。負荷分散機を共有する場合の設定については，「6.17.1(2)　異なるWebシステムのサービスユニットを1台のサーバマシンに配置する場合」を参照してください。

また，JP1/SC/DPMを利用して構築するホスト単位管理モデルの場合，異なる運用管理ドメイン（サーバマシン）の同じWebシステム間でも，同じ（1台の）負荷分散機を共有できます。JP1/SC/DPMを利用したシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

(c)　負荷分散機の冗長化

Smart Composer機能で構築するWebシステムでは，負荷分散機を2台構成で配置できます。冗長化構成で配置できる負荷分散機は，BIG-IP 1500，BIG-IP 1000，またはHA8000-ie/Loadflowbalです。負荷分散機を冗長化したシステム構成については，「4.3.4　負荷分散機を冗長化する構成」を参照してください。

また，Cosminexusから冗長化構成で配置する負荷分散機を制御する場合は，sshコマンドまたはTelnetを使用します。JP1/Cm2/NCは使用できません。負荷分散機を冗長化する場合の設定については，「6.14　負荷分散機を冗長化する場合に必要な設定」を参照してください。

参考

既存のWebシステムの負荷分散機を冗長化構成に変更したい場合は，既存のWebシステムを削除してから，負荷分散機を冗長化したWebシステムを再構築してください。

(2)　アプリケーションサーバマシン

アプリケーションサーバを配置したマシンをアプリケーションサーバマシンといいます。アプリケーションサーバマシン上では，J2EEサーバなどが動作します。Smart Composer機能を使用するシステム構成では，アプリケーションサーバマシンはクラスタ構成になっており，それぞれをサービスユニットという単位で扱います。

アプリケーションサーバマシンにインストールする製品と，アプリケーションサーバマシン上で動作するプロセスを次の表に示します。

表4-2　アプリケーションサーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server | Webサーバ
PRFデーモン
J2EEサーバ
運用管理エージェント
JP1/SC/DPM※ | クライアントサービス for DPM

注※

JP1/SC/DPMを使用して，OSやアプリケーションの一括インストールをする場合だけ必要になります。JP1/SC/DPMを使用した場合のシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

(3)　データベースサーバマシン

データベースが構築されているマシンをデータベースサーバマシンといいます。

インストールする製品

HiRDB，Oracle，SQL Server，またはXDM/RD E2

(4)　運用管理サーバマシン

Management Serverを配置したマシンを，運用管理サーバマシンといいます。運用管理サーバとは，すべてのサービスユニットを運用管理するための機能を集約したサーバで，Management Serverで運用管理します。運用管理ドメイン（Management Serverが管理する論理サーバの集合）内の各ホストに配置されている運用管理エージェントに対して，管理操作を指示します。

運用管理サーバマシンにインストールする製品と，運用管理サーバマシン上で動作するプロセスを次の表に示します。

表4-3　運用管理サーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server | Management Server

4.2.2　バックシステムの製品構成とプロセス構成

Smart Composer機能を使用して，構築できるバックシステムを次に示します。

セッションフェイルオーバ機能を使用するシステム

CTMを使用するシステム

これらのバックシステムを構築する場合に，必要な製品構成およびプロセス構成について説明します。

＜この項の構成＞

(1)　セッションフェイルオーバ機能を使用するシステムの製品構成とプロセス構成

(2)　CTMを使用するシステムの製品構成とプロセス構成

(1)　セッションフェイルオーバ機能を使用するシステムの製品構成とプロセス構成

Smart Composer機能で，セッションフェイルオーバ機能を使用するシステムを構築する場合は，Webフロントシステムで使用する製品に加えて，セッションフェイルオーバサーバが必要になります。セッションフェイルオーバ機能を使用するシステムで必要な製品構成およびプロセス構成を次の図に示します。

図4-3　製品構成およびプロセス構成（セッションフェイルオーバ機能を使用するシステムの場合）

セッションフェイルオーバ機能を使用するシステムの場合は，一つのシステム内に，Webフロントシステムと，セッション情報を管理するセッションフェイルオーバサーバを構築します。

システム内のサーバと，使用する製品について説明します。なお，Webフロントシステムで使用する製品については，「4.2.1　Webフロントシステムの製品構成とプロセス構成」を参照してください。

(a)　セッションフェイルオーバサーバマシン

SFOサーバを配置したマシンをセッションフェイルオーバサーバマシンといいます。

セッションフェイルオーバサーバマシンにインストールする製品と，セッションフェイルオーバサーバマシン上で動作するプロセスを次の表に示します。

表4-4　セッションフェイルオーバサーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server | SFOサーバ
PRFデーモン
運用管理エージェント

(2)　CTMを使用するシステムの製品構成とプロセス構成

Smart Composer機能で，CTMを使用するシステムを構築する場合は，統合ネーミングスケジューラサーバの使用を前提とした統合ネーミングスケジューラサーバモデルを使用します。統合ネーミングスケジューラサーバモデルは，グローバルCORBAネーミングサービスを独立したサーバマシン（ホスト）に配置する構成です。統合ネーミングスケジューラサーバモデルについては，マニュアル「Cosminexus　機能解説」のプロセス配置の指針に関する説明を参照してください。

CTMを使用するシステムで必要な製品構成およびプロセス構成を次の図に示します。ここでは，CTMにリクエストを送信するクライアントとしてEJBクライアントを例に使用して，説明しています。なお，EJBクライアントについては，マニュアル「Cosminexus　システム構築ガイド」のEJBクライアント環境の構築（uCosminexus Client）に関する説明を参照してください。

図4-4　製品構成およびプロセス構成（CTMを使用するシステムの場合）

CTMを使用するシステムの場合は，CTMドメイン内にあるアプリケーションサーバの業務処理プログラムの情報を共有管理する統合ネーミングスケジューラサーバと，スケジューリングされたリクエストを処理するアプリケーションサーバを，それぞれ別のWebシステムに構築します。この図では，統合ネーミングスケジューラサーバを構築するWebシステムをWebシステム1，アプリケーションサーバを構築するWebシステムをWebシステム2として説明しています。

各Webシステム内のサーバと，使用する製品について説明します。

(a)　アプリケーションサーバマシン（CTM用）

アプリケーションサーバを配置したマシンをアプリケーションサーバマシンといいます。アプリケーションサーバマシン上では，CTMドメインマネジャ，CTM，J2EEサーバなどが動作します。CTMを使用する構成の場合，アプリケーションサーバには，一つのCTMに対して，同じ構成のJ2EEサーバを複数配置できます。

アプリケーションサーバマシンにインストールする製品と，アプリケーションサーバマシン上で動作するプロセスを次の表に示します。

表4-5　アプリケーションサーバマシンにインストールする製品と動作するプロセス（CTM用）

インストールする製品 | 動作するプロセス
Application Server Enterprise※1 | CTMドメインマネジャ
CTM
スマートエージェント
PRFデーモン
J2EEサーバ
運用管理エージェント
JP1/SC/DPM※2 | クライアントサービス for DPM

注※1

CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

注※2

JP1/SC/DPMを使用して，OSやアプリケーションの一括インストールをする場合だけ必要になります。JP1/SC/DPMを使用した場合のシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

(b)　統合ネーミングスケジューラサーバマシン

統合ネーミングスケジューラサーバを配置したマシンを統合ネーミングスケジューラサーバマシンといいます。統合ネーミングスケジューラサーバマシン上では，CTMドメインマネジャ，CTMなどが動作します。

統合ネーミングスケジューラサーバマシンにインストールする製品と，統合ネーミングスケジューラサーバマシン上で動作するプロセスを次の表に示します。

表4-6　統合ネーミングスケジューラサーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server Enterprise※1 | CTMドメインマネジャ
CTM
スマートエージェント
PRFデーモン
運用管理エージェント
JP1/SC/DPM※2 | クライアントサービス for DPM

注※1

CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

注※2

JP1/SC/DPMを使用して，OSやアプリケーションの一括インストールをする場合だけ必要になります。JP1/SC/DPMを使用した場合のシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

(c)　データベースサーバマシン

データベースサーバマシンにインストールする製品については，「4.2.1(3)　データベースサーバマシン」を参照してください。

(d)　運用管理サーバマシン

運用管理サーバマシンにインストールする製品と動作するプロセスについては，「4.2.1(4)　運用管理サーバマシン」を参照してください。

4.3　システム構成パターン

ここでは，Smart Composer機能を使用して構築できるシステムの構成パターンについて説明します。

Smart Composer機能で構築できるシステム構成パターンと，指定できる物理ティアの組み合わせを次の表に示します。

表4-7　Smart Composer機能で構築できるシステム構成パターンと，指定できる物理ティアの組み合わせ

項番
システム構成パターン
システム構成の特長
Webフロントシステム
バックシステム

combined-tier
http-tier
と
j2ee-tier
j2ee-tier
sfo-tier
ctm-tier

1
WebサーバとJ2EEサーバを同じサーバマシンに配置する構成
（4.3.1参照）
1台のマシンにWebサーバとJ2EEサーバを配置します。日常のメンテナンスやシステムの拡張が容易なシンプルな構成です。
○
－
－
－
－

2
WebサーバとJ2EEサーバを別のサーバマシンに配置する構成
（4.3.2参照）
WebサーバとJ2EEサーバを異なるマシンに分けて配置します。セキュリティを考慮した運用をする場合に使用します。
－
○
－
－
－

3
インプロセスHTTPサーバ機能を使用する構成
（4.3.3参照）
インプロセスHTTPサーバ機能を使用すると，J2EEサーバが直接クライアントからのリクエストを受け付けられます。この構成ではWebサーバの配置は不要です。1台のマシンに，J2EEサーバだけを配置します。
－
－
○
－
－

4
負荷分散機を冗長化する構成
（4.3.4参照）
一つのWebシステム内に負荷分散機を2台配置できます。1台の負荷分散機で障害が発生した場合も業務を続行できます。
○
○
－
－
－

5
セッションフェイルオーバ機能を使用する構成
（4.3.5参照）
SFOサーバでセッション情報を管理して，J2EEサーバで障害が発生した場合には，ほかのJ2EEサーバにセッション情報を引き渡します。障害発生前のセッション情報が引き継がれるため，J2EEサーバに障害が発生しても業務を続行できます。
○※1
○※1
－
○
－

6
CTMを使用する構成
（4.3.6参照）
リクエストをスケジューリングして，各J2EEサーバの負荷を分散させることで，安定して稼働するシステムを構築できます。
－※2
－※2
－※2
－
○

7
サーバマシン内に複数のサービスユニットを配置する構成
（4.3.7参照）
1台のサーバマシンに複数のサービスユニットを配置できます。複数の業務を1台のサーバマシンで運用できます。
○
○
○
○
○※3

8
論理ユーザサーバを使用する構成
（4.3.8参照）
ユーザが定義したプロセスを論理ユーザサーバとして定義すると，Management Serverで運用管理できるようになります。
○
○
○
○
○

（凡例）

○：指定できます。

－：該当しません。

注※1

セッションフェイルオーバ機能を使用するバックシステムの場合，Smart Composer機能で構築できるWebフロントシステムと組み合わせて構築します。

注※2

CTMを使用するバックシステムの場合，Smart Composer機能で構築できるWebフロントシステム以外にも，EJBクライアントやユーザが独自に定義するWebフロントシステムと組み合わせて構築できます。

注※3

同じCTMドメインのサービスユニットは，1サーバマシン内に複数配置できません。

参考

Smart Composer機能を使用して，Webフロントシステムやバックシステムを構築する場合，JP1/SC/DPMが利用できます。JP1/SC/DPMと連携すると，構築したシステムのディスクイメージを複製できるので，より迅速にシステムを構築できます。詳細については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。ただし，セッションフェイルオーバ機能を使用する構成の場合，セッションフェイルオーバサーバマシンではJP1/SC/DPMを利用できません。

表4-7に示した構成以外にも，サーバの構成を限定しない，free-tier構成があります。free-tier構成は，Smart Composer機能以外の方法で構築したシステムをエクスポートしたときに出力されます。

＜この節の構成＞

4.3.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成

4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成

4.3.3　インプロセスHTTPサーバ機能を使用する構成

4.3.4　負荷分散機を冗長化する構成

4.3.5　セッションフェイルオーバ機能を使用する構成

4.3.6　CTMを使用する構成

4.3.7　サーバマシン内に複数のサービスユニットを配置する構成

4.3.8　論理ユーザサーバを使用する構成

4.3.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成

WebサーバとJ2EEサーバを同じマシン（アプリケーションサーバマシン）で運用する場合に使用する構成です。この構成をcombined-tier構成といいます。物理ティアのcombined-tierを使用したシステムはシンプルな構成のため，日常のメンテナンスやシステムの拡張が容易です。

combined-tierの場合のシステム構成例を次の図に示します。

図4-5　combined-tierの場合のシステム構成例

4.3.2　WebサーバとJ2EEサーバを別のサーバマシンに配置する構成

セキュリティを考慮して，WebサーバとJ2EEサーバを別のサーバマシン（Webサーバマシンおよびアプリケーションサーバマシン）に配置して運用する場合に使用する構成です。この構成をhttp-tierとj2ee-tierを組み合わせた構成といいます。物理ティアのhttp-tierとj2ee-tierを組み合わせて使用します。

http-tierとj2ee-tierを組み合わせた場合のシステム構成例を次の図に示します。

図4-6　http-tierとj2ee-tierを組み合わせた場合のシステム構成例

4.3.3　インプロセスHTTPサーバ機能を使用する構成

Webサーバを配置しないでクライアントからのリクエストを受け付けたい場合に使用する構成です。クライアントからのリクエストを受け付けるために，インプロセスHTTPサーバ機能を使用します。なお，インプロセスHTTPサーバ機能の詳細については，マニュアル「Cosminexus　機能解説」のインプロセスHTTPサーバによるリクエストの受け付けに関する説明を参照してください。

この構成をインプロセスHTTPサーバ機能を使用する構成といいます。物理ティアのj2ee-tierを，http-tierと組み合わせないで使用します。

インプロセスHTTPサーバ機能を使用する場合のシステム構成例を次の図に示します。

図4-7　インプロセスHTTPサーバ機能を使用する場合のシステム構成例

注　このシステム構成パターンでは，負荷分散機を配置できません。

4.3.4　負荷分散機を冗長化する構成

Smart Composer機能でWebフロントシステムを構築する場合，一つのWebシステム内に，負荷分散機を冗長化構成（アクティブ・スタンバイ構成）で配置できます。配置できる負荷分散機の台数は，2台です。負荷分散機を冗長化構成で配置すると，実行系（アクティブ）の負荷分散機で障害が発生した場合に，リクエストの振り分け処理が自動的に待機系（スタンバイ）の負荷分散機に切り替わって，業務を続行できます。

負荷分散機を2台配置する場合のシステム構成例を次の図に示します。なお，ここでは，combined-tier構成で，実行系の負荷分散機を負荷分散機1，待機系の負荷分散機を負荷分散機2として配置している場合を例に説明しています。

図4-8　負荷分散機を2台配置する場合のシステム構成例

このシステム構成パターンは，http-tierとj2ee-tierを組み合わせた構成のシステムでも構築できます。

4.3.5　セッションフェイルオーバ機能を使用する構成

Smart Composer機能では，セッションフェイルオーバ機能を使用したバックシステムを構築，運用できます。セッションフェイルオーバ機能を使用すると，J2EEサーバでの障害発生時に，セッション情報がほかのJ2EEサーバに引き継がれるので，障害発生前の状態で業務を続行できます。セッションフェイルオーバ機能を使用する場合は，セッション情報を管理するセッションフェイルオーバサーバ（SFOサーバ）が必要です。そのためには，SFOサーバを配置するセッションフェイルオーバサーバマシンを用意して，そのマシンに，セッションフェイルオーバ用のサービスユニットを配置する必要があります。

セッションフェイルオーバ機能を使用する場合のシステム構成例を次の図に示します。ここでは，combined-tier構成のシステムと組み合わせたシステムを例に使用して，説明しています。

図4-9　セッションフェイルオーバ機能を使用する場合のシステム構成例

なお，セッションフェイルオーバ機能の詳細については，マニュアル「Cosminexus　機能解説」のJ2EEサーバ間のセッション情報の引き継ぎに関する説明を参照してください。

このシステム構成パターンは，http-tierとj2ee-tierを組み合わせた構成を使用しても構築できます。

4.3.6　CTMを使用する構成

Smart Composer機能では，CTMを利用してリクエストをスケジューリングするバックシステムを構築，運用できます。CTMを使用すると，クライアントから送信されたリクエストをスケジューリングして，リクエストの送信先を分散したり，送信先へのリクエストの流量を一定時間内で制御したり，特定のアプリケーションに対するリクエストの受け付けを制御したりできます。リクエストのスケジューリングによって，安定して稼働するシステムを構築でき，システム全体の処理性能が向上させられます。また，障害発生時の復旧作業やメンテナンスも容易に実施できます。

Smart Composer機能の場合，CTMを使用したシステムは，統合ネーミングスケジューラサーバを使用した統合ネーミングスケジューラサーバモデルで構築することを前提としています。

このため，CTM関連のプロセスおよびJ2EEサーバを配置するアプリケーションサーバと，グローバルCORBAネーミングサービスを独立したマシンに配置する統合ネーミングスケジューラサーバが必要になります。この場合，アプリケーションサーバマシンと統合ネーミングスケジューラサーバマシンを用意して，それぞれにCTM用のサービスユニット，統合ネーミングスケジューラサーバ用のサービスユニットを配置します。

参考

CTM関連のプロセスには，リクエストを振り分けてスケジューリングするCTM，同じCTMドメイン内のCTMの情報を管理するCTMドメインマネジャ，異なるネットワークセグメントにあるCTMに情報を配布するスマートエージェントがあります。

また，CTMにリクエストを送信できるクライアントは，EJBクライアントおよびWebクライアントです。WebクライアントのリクエストをCTMに送信するWebフロントシステムには，Smart Composer機能以外で構築したユーザ独自のシステムも使用できます。

CTMを使用する場合のシステム構成例を次の図に示します。ここでは，EJBクライアントを例に使用して，説明しています。

図4-10　CTMを使用する場合のシステム構成例

この図のように，CTMを使用するシステムの場合，アプリケーションサーバには，一つのCTMに対して，J2EEアプリケーションや環境設定などの構成が同じJ2EEサーバを，複数配置できます。

なお，CTMの機能の詳細については，マニュアル「Cosminexus　機能解説」のCTMを使用したリクエストのスケジューリングの概要に関する説明を参照してください。

4.3.7　サーバマシン内に複数のサービスユニットを配置する構成

Smart Composer機能で構築するシステムでは，1台のサーバマシンに，複数のサービスユニットを配置できます。サーバマシン中のサーバをサービスユニット単位で増やしてシステムを拡張したり，異なるWebシステムのサービスユニットを配置して複数の業務を1台のマシンで運用したりできます。

1台のサーバマシンには，同じWebシステムのサービスユニットも，異なるWebシステムのサービスユニットも配置できます。なお，1台のサーバマシンに配置した異なるWebシステムで，1台の負荷分散機を共有する場合は，それぞれのWebシステムで使用する負荷分散機の仮想サーバを分ける必要があります。

サーバマシン内に複数のサービスユニットを配置する場合のシステム構成例を次の図に示します。ここでは，combined-tier構成で構築したシステムを例に使用して，説明しています。この図では，異なるWebシステムのサービスユニットを1台のマシンに配置しています。業務AはWebシステムAに，業務BはWebシステムBに対応しています。

図4-11　サーバマシン内に複数のサービスユニットを配置する場合のシステム構成例（異なるWebシステムの場合）

このシステム構成パターンは，Smart Composer機能で構築できるWebフロントシステムおよびバックシステムで使用できます。ただし，CTMを使用するシステムの場合，同じCTMドメインのサービスユニットは，サーバマシン内に複数配置できません。また，インプロセスHTTPサーバ機能を使用する構成の場合は負荷分散機を配置できません。

4.3.8　論理ユーザサーバを使用する構成

Smart Composer機能で構築したシステムでは，ユーザが定義する論理サーバを論理ユーザサーバとして配置できます。特定のサービスやプロセスを論理ユーザサーバとして定義しておくことで，そのサービスやプロセスがManagement Serverの管理対象となり，そのほかの論理サーバと同様に，一括管理できるようになります。

システムでの論理ユーザサーバは，特定のサービスユニットと同時に起動，停止できます。同時に起動，停止したいプロセスを，あらかじめ論理ユーザサーバとして定義しておき，特定のサービスユニットに関連づけます。サービスユニットとの関連づけは，Smart Composer機能のファイルおよびコマンドで定義します。一つのユーザサーバは，一つのサービスユニットと関連づけます。ユーザサーバは，一つのサービスユニットに複数配置できます。

論理ユーザサーバの設定方法については，「6.18　論理ユーザサーバを使用する場合に必要な設定」を参照してください。

論理ユーザサーバを使用する場合のシステム構成例を次の図に示します。ここでは，combined-tier構成で構築したシステムを例に使用して，説明しています。

図4-12　論理ユーザサーバを使用する場合のシステム構成例

このシステム構成パターンは，Smart Composer機能で構築できるWebフロントシステムおよびバックシステムで使用できます。ただし，インプロセスHTTPサーバ機能を使用する構成の場合は，負荷分散機を配置できません。

参考

ユーザサーバは，Application Server上で動作します。アプリケーションサーバマシン以外にも，Application Serverをインストールしているマシンであれば，ユーザサーバを配置できます。なお，これらのマシンには，運用管理エージェントも配置する必要があります。

4.4　JP1/SC/DPMを利用して構築する場合のシステム構成

JP1/SC/DPMは，Smart Composer機能を使用したシステムの初期構築や，スケールアウトをするときに利用できます。

また，JP1/SC/DPMを利用する場合，運用管理プロセス（Management Server）をどこに配置するかによって，次に示すモデルのシステムが構築できます。

運用管理サーバモデル
Management Serverを運用管理サーバマシンに配置する構成です。Management Serverが管理する運用管理ドメイン内のマシンを，一括して運用管理，監視するシステムを構築する場合に適しています。サービスユニット単位にスケールアウトできるので，システム内を容易に拡張できます。

ホスト単位管理モデル
Management Serverをアプリケーションサーバマシンに配置する構成です。この場合，運用管理サーバマシンは不要です。マシン（運用管理ドメイン）単位にスケールアウトできるので，同じ構成のWebシステムを持つマシンを複数台配置するシステムを構築する場合に適しています。スケールアウト時には，Management Serverも複製されます。

JP1/SC/DPMでは，構築したシステムのディスクイメージ（OSとアプリケーション）を複製できます。Smart Composer機能でのシステムの構築が完了したあと，構築したサービスユニットまたは運用管理ドメインのディスクイメージをJP1/SC/DPMを使用して複製しておきます。スケールアウトが必要になったときは，複製しておいたディスクイメージを基にして，追加するサービスユニットにOSやアプリケーションの一括インストールができるので，スケールアウトするサーバのセットアップが簡単になります。これによって，1台ずつインストールする場合と比較して，セットアップ時間を大幅に短縮できます。

モデルごとに，JP1/SC/DPMを使用する場合のシステム構成と，製品およびプロセス構成例を示します。ここでは，combined-tier構成で構築したシステムを例に使用して，説明しています。

図4-13　JP1/SC/DPMを使用する場合のシステム構成と，製品およびプロセス構成例（運用管理サーバモデル）

図4-14　JP1/SC/DPMを使用する場合のシステム構成と，製品およびプロセス構成例（ホスト単位管理モデル）

JP1/SC/DPMのうち，管理サーバfor DPMおよびWebサーバfor DPMがインストールされたマシンを，JP1/SC/DPM管理サーバマシンといいます。JP1/SC/DPM管理サーバマシンは必要に応じて用意してください。

JP1/SC/DPM管理サーバマシンにインストールする製品と，JP1/SC/DPM管理サーバマシン上で動作するプロセスを次の表に示します。

表4-8　JP1/SC/DPM管理サーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
JP1/SC/DPM | 管理サーバ for DPM
Webサーバ for DPM

なお，JP1/SC/DPMを利用してスケールアウトできるOSは，WindowsおよびLinuxです。詳細については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。

JP1/SC/DPMは，Smart Composer機能で構築できるWebフロントシステムおよびバックシステムで利用できます。ただし，セッションフェイルオーバ機能を使用するシステムの場合，セッションフェイルオーバサーバマシンではJP1/SC/DPMと連携したスケールアウトを利用できません。

JP1/SC/DPMを利用したスケールアウト手順の詳細については，「7.7　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン」を参照してください。

5.　J2EEアプリケーションを実行するシステムを構築する前に

決定した構成でシステムを構築する前に，使用リソースの見積もりをしたり，運用設計をしたりします。

この章では，J2EEアプリケーションを実行するシステムを構築する前の準備，および注意事項について説明します。

＜この章の構成＞

5.1　使用リソースの見積もり

5.2　運用・障害設計

5.3　簡易構築定義ファイルの運用方法

5.1　使用リソースの見積もり

システムが動作するためには，OSやデータベースなどのホスティング環境の設定が必要な場合があります。ここでは，Smart Composer機能を使用して構築されたシステムが必要とするリソースの見積もりについて，OSごとに説明します。

＜この節の構成＞

5.1.1　Windowsの場合

5.1.2　AIXの場合

5.1.3　HP-UXの場合

5.1.4　Linuxの場合

5.1.5　Solarisの場合

5.1.6　仮想メモリの使用量の見積もり

5.1.7　セッションフェイルオーバ機能使用時の見積もり

5.1.1　Windowsの場合

Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量を見積もるための計算式を，次の表に示します。

Windowsシステムでは，Windowsシステムで利用できるプロセス数，およびWindowsシステムやプロセスで利用できるスレッド数に，特に制限はありません。Windowsシステムで利用できる数だけ利用できます。

表5-1　使用リソースの見積もり（Windowsの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※

Webサーバで同時に処理できるリクエストの最大数を指します。

なお，仮想メモリ所要量については，「5.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application ServerまたはDeveloperのリリースノートを参照してください。

5.1.2　AIXの場合

見積もりは物理ティアの種類によって異なります。AIXの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて，参照先を次の表に示します。

表5-2　使用リソースの見積もりの参照先（AIXの場合）

内容
参照先

サービスユニットの見積もり
combined-tierの構成
「(1)　サービスユニットの使用リソースの見積もり」

http-tierとj2ee-tierを組み合わせた構成

「(2)　Webサーバマシンの使用リソースの見積もり」

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

インプロセスHTTPサーバ機能を使用する構成

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

データベースの見積もり
「(4)　DBMSの使用リソースの見積もり」

運用管理サーバの見積もり
「(5)　運用管理サーバの使用リソースの見積もり」

セッションフェイルオーバ機能使用時の見積もり※
「(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり」

CTM使用時の見積もり
「(7)　ctm-tierのサービスユニットの使用リソースの見積もり」

注※　セッションフェイルオーバ機能を使用する場合，J2EEサーバが使用するメモリ量が増加します。J2EEサーバが使用するメモリ増加量については，「5.1.7　セッションフェイルオーバ機能使用時の見積もり」を参照してください。

なお，仮想メモリ所要量については，「5.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　サービスユニットの使用リソースの見積もり

(2)　Webサーバマシンの使用リソースの見積もり

(3)　アプリケーションサーバマシンの使用リソースの見積もり

(4)　DBMSの使用リソースの見積もり

(5)　運用管理サーバの使用リソースの見積もり

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

(1)　サービスユニットの使用リソースの見積もり

サービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-3　サービスユニットの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | － | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | －
プロセス数 | － | リクエスト最大同時処理数※2×2＋5 | －
スレッド数 | － | リクエスト最大同時処理数※2×2＋41＋J2EEサーバのスレッド数※3 | －
ファイルディスクリプタ数 | nofiles | J2EEサーバのファイルディスクリプタ数※3＋76＋リクエスト最大同時処理数※2×4 | /etc/security/limits

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　Webサーバマシンの使用リソースの見積もり

Webサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-4　Webサーバマシンの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | － | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | －
プロセス数 | － | リクエスト最大同時処理数※2×2＋4 | －
スレッド数 | － | リクエスト最大同時処理数※2×2＋35 | －
ファイルディスクリプタ数 | nofiles | リクエスト最大同時処理数※2×4＋75 | /etc/security/limits

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

(3)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-5　アプリケーションサーバマシンの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | － | PrfTraceBufferSize※1＋18496 | －
プロセス数 | － | 4 | －
スレッド数 | － | J2EEサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | nofiles | J2EEサーバのファイルディスクリプタ数※2＋43 | /etc/security/limits

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(4)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表5-6　DBMSの使用リソースの見積もり（AIXの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※×2＋ユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※＋ユニット内リソースアダプタ数)×サービスユニット数

注※

Webサーバで同時に処理できるリクエストの最大数を指します。

(5)　運用管理サーバの使用リソースの見積もり

運用管理サーバの使用リソースの見積もりについて，次の表に示します。

表5-7　運用管理サーバの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
プロセス数 | － | 5 | －
スレッド数 | － | 56 | －
ファイルディスクリプタ数 | nofiles | 43＋J2EEサーバ数 | /etc/security/limits

（凡例）－：該当しません。

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

セッションフェイルオーバサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-8　セッションフェイルオーバサーバマシンの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | － | PrfTraceBufferSize※1＋18496 | －
プロセス数 | － | 4 | －
スレッド数 | － | SFOサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | nofiles | SFOサーバのファイルディスクリプタ数※2＋43 | /etc/security/limits

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

ctm-tierのサービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-9　ctm-tierのサービスユニットの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | － | PrfTraceBufferSize＋18496＋CTMドメインマネジャの共用メモリ※1＋CTMデーモンの共用メモリ※1 | －
プロセス数 | － | 7＋J2EEサーバ数※2 | －
スレッド数 | － | 72＋(J2EEサーバのスレッド数※3＋7)×J2EEサーバ数※2＋CTMデーモンで必要とするスレッド数※4 | －
ファイルディスクリプタ数 | nofiles | 88＋(J2EEサーバのファイルディスクリプタ数※3＋6)×J2EEサーバ数※2＋CTMデーモンで必要とするファイルディスクリプタ数※4 | /etc/security/limits

（凡例）－：該当しません。

注※1

値については，「5.1.2(7)(a)　共用メモリ用ファイルサイズの計算式」を参照して算出してください。

注※2

簡易構築定義ファイルの<j2ee-server-count>タグの指定値を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

注※4

CTMデーモンで必要とするスレッド数とファイルディスクリプタ数については，「5.1.2(7)(b)　CTMデーモンで必要とするスレッド数とファイルディスクリプタ数の計算式」を参照して算出してください。

(a)　共用メモリ用ファイルサイズの計算式

共用メモリ用ファイルサイズを算出するには，CTMドメインマネジャの共用メモリおよびCTMデーモンの共用メモリを算出する必要があります。それぞれの計算式について次に示します。

なお，計算式中の可変値には，次の値を使用してください。「ctm.」で始まるパラメタについては，簡易構築定義ファイルの「14.9　論理CTMで指定できるパラメタ」を参照してください。

計算式に使用する値

-CTMMaxCTM：64

-CTMQueueCount：ctm.QueueCount

-CTMClientConnectCount：256

-CTMServerConnectCount：ctm.ServerConnectCount

-CTMEntryCount：-CTMClientConnectCount＋-CTMServerConnectCount

-CTMServerCacheSize：ctm.ServerCacheSize

-CTMQueueRegistCount：ctm.QueueRegistCount

-CTMDispatchParallelCount：ctm.DispatchParallelCount

●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)　CTMデーモンで必要とするスレッド数とファイルディスクリプタ数の計算式

スレッド数およびファイルディスクリプタ数を算出するには，CTMデーモンで必要とするスレッド数とファイルディスクリプタ数を算出する必要があります。それぞれの計算式について次に示します。

●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クライアントの総数

●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クライアントの総数

5.1.3　HP-UXの場合

見積もりは物理ティアの種類によって異なります。HP-UXの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて，参照先を次の表に示します。

表5-10　使用リソースの見積もりの参照先（HP-UXの場合）

内容
参照先

サービスユニットの見積もり
combined-tierの構成
「(1)　サービスユニットの使用リソースの見積もり」

http-tierとj2ee-tierを組み合わせた構成

「(2)　Webサーバマシンの使用リソースの見積もり」

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

インプロセスHTTPサーバ機能を使用する構成

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

データベースの見積もり
「(4)　DBMSの使用リソースの見積もり」

運用管理サーバの見積もり
「(5)　運用管理サーバの使用リソースの見積もり」

セッションフェイルオーバ機能使用時の見積もり※
「(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり」

CTM使用時の見積もり
「(7)　ctm-tierのサービスユニットの使用リソースの見積もり」

注※　セッションフェイルオーバ機能を使用する場合，J2EEサーバが使用するメモリ量が増加します。J2EEサーバが使用するメモリ増加量については，「5.1.7　セッションフェイルオーバ機能使用時の見積もり」を参照してください。

なお，仮想メモリ所要量については，「5.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　サービスユニットの使用リソースの見積もり

(2)　Webサーバマシンの使用リソースの見積もり

(3)　アプリケーションサーバマシンの使用リソースの見積もり

(4)　DBMSの使用リソースの見積もり

(5)　運用管理サーバの使用リソースの見積もり

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

(1)　サービスユニットの使用リソースの見積もり

サービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-11　サービスユニットの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shmmax | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | kctune shmmax= 1073741824
プロセス数 | nproc | リクエスト最大同時処理数※2×2＋5 | kctune nproc=4200
スレッド数 | nkthread | リクエスト最大同時処理数※2×2＋41＋J2EEサーバのスレッド数※3 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | J2EEサーバのファイルディスクリプタ数※3＋76＋リクエスト最大同時処理数※2×4 | kctune nfile= 65536

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　Webサーバマシンの使用リソースの見積もり

Webサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-12　Webサーバマシンの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shmmax | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | kctune shmmax= 1073741824
プロセス数 | nproc | リクエスト最大同時処理数※2×2＋4 | kctune nproc=4200
スレッド数 | nkthread | リクエスト最大同時処理数※2×2＋35 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | リクエスト最大同時処理数※2×4＋75 | kctune nfile= 65536

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

(3)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-13　アプリケーションサーバマシンの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shmmax | PrfTraceBufferSize※1＋18496 | kctune shmmax= 1073741824
プロセス数 | nproc | 4 | kctune nproc=4200
スレッド数 | nkthread | J2EEサーバのスレッド数※2＋34 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | J2EEサーバのファイルディスクリプタ数※2＋43 | kctune nfile= 65536

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(4)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表5-14　DBMSの使用リソースの見積もり（HP-UXの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※×2＋ユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※＋ユニット内リソースアダプタ数)×サービスユニット数

注※

Webサーバで同時に処理できるリクエストの最大数を指します。

(5)　運用管理サーバの使用リソースの見積もり

運用管理サーバの使用リソースの見積もりについて，次の表に示します。

表5-15　運用管理サーバの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
プロセス数 | nproc | 5 | kctune nproc=4200
スレッド数 | nkthread | 56 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | 43＋J2EEサーバ数 | kctune nfile= 65536

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

セッションフェイルオーバサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-16　セッションフェイルオーバサーバマシンの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shmmax | PrfTraceBufferSize※1＋18496 | kctune shmmax= 1073741824
プロセス数 | nproc | 4 | kctune nproc=4200
スレッド数 | nkthread | SFOサーバのスレッド数※2＋34 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | SFOサーバのファイルディスクリプタ数※2＋43 | kctune nfile= 65536

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

ctm-tierのサービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-17　ctm-tierのサービスユニットの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shmmax | PrfTraceBufferSize＋18496＋CTMドメインマネジャの共用メモリ※1＋CTMデーモンの共用メモリ※1 | kctune shmmax= 1073741824
プロセス数 | nproc | 7＋J2EEサーバ数※2 | kctune nproc=4200
スレッド数 | nkthread | 72＋(J2EEサーバのスレッド数※3＋7)×J2EEサーバ数※2＋CTMデーモンで必要とするスレッド数※4 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | 88＋(J2EEサーバのファイルディスクリプタ数※3＋6)×J2EEサーバ数※2＋CTMデーモンで必要とするファイルディスクリプタ数※4 | kctune nfile= 65536

注※1

値については，「5.1.2(7)(a)　共用メモリ用ファイルサイズの計算式」を参照して算出してください。

注※2

簡易構築定義ファイルの<j2ee-server-count>タグの指定値を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

注※4

CTMデーモンで必要とするスレッド数とファイルディスクリプタ数については，「5.1.2(7)(b)　CTMデーモンで必要とするスレッド数とファイルディスクリプタ数の計算式」を参照して算出してください。

5.1.4　Linuxの場合

見積もりは物理ティアの種類によって異なります。Linuxの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて，参照先を次の表に示します。

表5-18　使用リソースの見積もりの参照先（Linuxの場合）

内容
参照先

サービスユニットの見積もり
combined-tierの構成
「(1)　サービスユニットの使用リソースの見積もり」

http-tierとj2ee-tierを組み合わせた構成

「(2)　Webサーバマシンの使用リソースの見積もり」

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

インプロセスHTTPサーバ機能を使用する構成

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

データベースの見積もり
「(4)　DBMSの使用リソースの見積もり」

運用管理サーバの見積もり
「(5)　運用管理サーバの使用リソースの見積もり」

セッションフェイルオーバ機能使用時の見積もり※
「(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり」

CTM使用時の見積もり
「(7)　ctm-tierのサービスユニットの使用リソースの見積もり」

注※　セッションフェイルオーバ機能を使用する場合，J2EEサーバが使用するメモリ量が増加します。J2EEサーバが使用するメモリ増加量については，「5.1.7　セッションフェイルオーバ機能使用時の見積もり」を参照してください。

なお，仮想メモリ所要量については，「5.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

＜この項の構成＞

(1)　サービスユニットの使用リソースの見積もり

(2)　Webサーバマシンの使用リソースの見積もり

(3)　アプリケーションサーバマシンの使用リソースの見積もり

(4)　DBMSの使用リソースの見積もり

(5)　運用管理サーバの使用リソースの見積もり

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

(1)　サービスユニットの使用リソースの見積もり

サービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-19　サービスユニットの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | SHMMAX | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | /proc/sys/kernel/shmmax
プロセス数 | threads-max※3 | リクエスト最大同時処理数※2×2＋5 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※3 | リクエスト最大同時処理数※2×2＋41＋J2EEサーバのスレッド数※4 | －
ファイルディスクリプタ数 | fs.file-max | J2EEサーバのファイルディスクリプタ数※4＋76＋リクエスト最大同時処理数※2×4 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

注※3

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

注※4

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　Webサーバマシンの使用リソースの見積もり

Webサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-20　Webサーバマシンの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | SHMMAX | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | /proc/sys/kernel/shmmax
プロセス数 | threads-max※3 | リクエスト最大同時処理数※2×2＋4 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※3 | リクエスト最大同時処理数※2×2＋35 | －
ファイルディスクリプタ数 | fs.file-max | リクエスト最大同時処理数※2×4＋75 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

注※3

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

(3)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-21　アプリケーションサーバマシンの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | SHMMAX | PrfTraceBufferSize※1＋18496 | /proc/sys/kernel/shmmax
プロセス数 | threads-max※2 | 4 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※2 | J2EEサーバのスレッド数※3＋34 | －
ファイルディスクリプタ数 | fs.file-max | J2EEサーバのファイルディスクリプタ数※3＋43 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(4)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表5-22　DBMSの使用リソースの見積もり（Linuxの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※

Webサーバで同時に処理できるリクエストの最大数を指します。

(5)　運用管理サーバの使用リソースの見積もり

運用管理サーバの使用リソースの見積もりについて，次の表に示します。

表5-23　運用管理サーバの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
プロセス数 | threads-max※ | 5 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※ | 56 | －
ファイルディスクリプタ数 | fs.files-max | 43＋J2EEサーバ数 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

セッションフェイルオーバサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-24　セッションフェイルオーバサーバマシンの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | SHMMAX | PrfTraceBufferSize※1＋18496 | /proc/sys/kernel/shmmax
プロセス数 | threads-max※2 | 4 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※2 | SFOサーバのスレッド数※3＋34 | －
ファイルディスクリプタ数 | fs.file-max | SFOサーバのファイルディスクリプタ数※3＋43 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

注※3

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

ctm-tierのサービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-25　ctm-tierのサービスユニットの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | SHMMAX | PrfTraceBufferSize＋18496＋CTMドメインマネジャの共用メモリ※1＋CTMデーモンの共用メモリ※1 | /proc/sys/kernel/shmmax
プロセス数 | threads-max | 7＋J2EEサーバ数※2 | /proc/sys/kernel/threads-max
スレッド数 | threads-max | 72＋(J2EEサーバのスレッド数※3＋7)×J2EEサーバ数※2＋CTMデーモンで必要とするスレッド数※4 | －
ファイルディスクリプタ数 | fs.file-max | 88＋(J2EEサーバのファイルディスクリプタ数※3＋6)×J2EEサーバ数※2＋CTMデーモンで必要とするファイルディスクリプタ数※4 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

値については，「5.1.2(7)(a)　共用メモリ用ファイルサイズの計算式」を参照して算出してください。

注※2

簡易構築定義ファイルの<j2ee-server-count>タグの指定値を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

注※4

CTMデーモンで必要とするスレッド数とファイルディスクリプタ数については，「5.1.2(7)(b)　CTMデーモンで必要とするスレッド数とファイルディスクリプタ数の計算式」を参照して算出してください。

5.1.5　Solarisの場合

見積もりは物理ティアの種類によって異なります。Solarisの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて，参照先を次の表に示します。

表5-26　使用リソースの見積もりの参照先（Solarisの場合）

内容
参照先

サービスユニットの見積もり
combined-tierの構成
「(1)　サービスユニットの使用リソースの見積もり」

http-tierとj2ee-tierを組み合わせた構成

「(2)　Webサーバマシンの使用リソースの見積もり」

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

インプロセスHTTPサーバ機能を使用する構成

「(3)　アプリケーションサーバマシンの使用リソースの見積もり」

データベースの見積もり
「(4)　DBMSの使用リソースの見積もり」

運用管理サーバの見積もり
「(5)　運用管理サーバの使用リソースの見積もり」

セッションフェイルオーバ機能使用時の見積もり※
「(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり」

CTM使用時の見積もり
「(7)　ctm-tierのサービスユニットの使用リソースの見積もり」

注※　セッションフェイルオーバ機能を使用する場合，J2EEサーバが使用するメモリ量が増加します。J2EEサーバが使用するメモリ増加量については，「5.1.7　セッションフェイルオーバ機能使用時の見積もり」を参照してください。

なお，仮想メモリ所要量については，「5.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　サービスユニットの使用リソースの見積もり

(2)　Webサーバマシンの使用リソースの見積もり

(3)　アプリケーションサーバマシンの使用リソースの見積もり

(4)　DBMSの使用リソースの見積もり

(5)　運用管理サーバの使用リソースの見積もり

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

(1)　サービスユニットの使用リソースの見積もり

サービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-27　サービスユニットの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shminfo_shmmax | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | /etc/system
プロセス数 | max_nprocs | リクエスト最大同時処理数※2×2＋5 | /etc/system
スレッド数 | － | リクエスト最大同時処理数※2×2＋41＋J2EEサーバのスレッド数※3 | －
ファイルディスクリプタ数 | rlim_fd_max | J2EEサーバのファイルディスクリプタ数※3＋76＋リクエスト最大同時処理数※2×4 | /etc/system

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　Webサーバマシンの使用リソースの見積もり

Webサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-28　Webサーバマシンの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shminfo_shmmax | PrfTraceBufferSize※1＋18496＋リクエスト最大同時処理数※2×14 | /etc/system
プロセス数 | max_nprocs | リクエスト最大同時処理数※2×2＋4 | /etc/system
スレッド数 | － | リクエスト最大同時処理数※2×2＋35 | －
ファイルディスクリプタ数 | rlim_fd_max | リクエスト最大同時処理数※2×4＋75 | /etc/system

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

Webサーバで同時に処理できるリクエストの最大数を指します。

(3)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-29　アプリケーションサーバマシンの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shminfo_shmmax | PrfTraceBufferSize※1＋18496 | /etc/system
プロセス数 | max_nprocs | 4 | /etc/system
スレッド数 | － | J2EEサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | rlim_fd_max | J2EEサーバのファイルディスクリプタ数※2＋43 | /etc/system

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(4)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表5-30　DBMSの使用リソースの見積もり（Solarisの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×リクエスト最大同時処理数※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※

Webサーバで同時に処理できるリクエストの最大数を指します。

(5)　運用管理サーバの使用リソースの見積もり

運用管理サーバの使用リソースの見積もりについて，次の表に示します。

表5-31　運用管理サーバの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
プロセス数 | maxuprc | 5 | /etc/system
スレッド数 | － | 56 | －
ファイルディスクリプタ数 | rlim_fd_max | 43＋J2EEサーバ数 | /etc/system

（凡例）－：該当しません。

(6)　セッションフェイルオーバサーバマシンの使用リソースの見積もり

セッションフェイルオーバサーバマシンの使用リソースの見積もりについて，次の表に示します。

表5-32　セッションフェイルオーバサーバマシンの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shminfo_shmmax | PrfTraceBufferSize※1＋18496 | /etc/system
プロセス数 | max_nprocs | 4 | /etc/system
スレッド数 | － | SFOサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | rlim_fd_max | SFOサーバのファイルディスクリプタ数※2＋43 | /etc/system

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(7)　ctm-tierのサービスユニットの使用リソースの見積もり

ctm-tierのサービスユニットの使用リソースの見積もりについて，次の表に示します。

表5-33　ctm-tierのサービスユニットの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
共用メモリ | shminfo_shmmax | PrfTraceBufferSize＋18496＋CTMドメインマネジャの共用メモリ※1＋CTMデーモンの共用メモリ※1 | /etc/system
プロセス数 | max_nprocs | 7＋J2EEサーバ数※2 | /etc/system
スレッド数 | － | 72＋(J2EEサーバのスレッド数※3＋7)×J2EEサーバ数※2＋CTMデーモンで必要とするスレッド数※4 | －
ファイルディスクリプタ数 | rlim_fd_max | 88＋(J2EEサーバのファイルディスクリプタ数※3＋6)×J2EEサーバ数※2＋CTMデーモンで必要とするファイルディスクリプタ数※4 | /etc/system

（凡例）－：該当しません。

注※1

値については，「5.1.2(7)(a)　共用メモリ用ファイルサイズの計算式」を参照して算出してください。

注※2

簡易構築定義ファイルの<j2ee-server-count>タグの指定値を指します。

注※3

J2EEサーバのスレッド数とファイルディスクリプタ数については，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

注※4

CTMデーモンで必要とするスレッド数とファイルディスクリプタ数については，「5.1.2(7)(b)　CTMデーモンで必要とするスレッド数とファイルディスクリプタ数の計算式」を参照して算出してください。

5.1.6　仮想メモリの使用量の見積もり

ここでは，仮想メモリの使用量の見積もり方法について説明します。なお，仮想メモリの使用量の計算式に使用しているJavaVM起動時のオプションの詳細については，マニュアル「Cosminexus　システム設計ガイド」のJavaVMで使用するメモリ空間の構成とJavaVMオプションに関する説明を参照してください。

＜この項の構成＞

(1)　仮想メモリの使用量の計算式

(2)　仮想メモリの使用量を計算する場合の注意事項

(1)　仮想メモリの使用量の計算式

仮想メモリの使用量（単位：メガバイト）の計算式を次に示します。

J2EEサーバの仮想メモリの使用量 = A＋B＋C＋（D＋10）×E

（凡例）

A：Javaヒープサイズ
初期値は，JavaVM起動時のオプション-Xmsに指定した値です。この値は，J2EEサーバ起動中に，最大でJavaVM起動時のオプション-Xmxに指定した値まで拡張されます。

B：Permanent領域サイズ
初期値は，JavaVM起動時のオプション-XX:PermSizeに指定した値です。この値は，J2EEサーバ起動中に，最大でJavaVM起動時のオプション-XX:MaxPermSizeに指定した値まで拡張されます。
監査ログを使用する場合
監査ログを使用する場合は，値に1メガバイトを加えてください。

C：ネイティブプログラム使用領域サイズ
OSごとに使用する値が異なります。ネイティブプログラム使用領域サイズのOSごとの値について，次の表に示します。

表5-34　ネイティブプログラム使用領域サイズの値一覧

OS種別
使用領域の値
（単位：メガバイト）

Windows
300

AIX
400

HP-UX
400

Linux（x86）
400

Linux（AMD64 & Intel EM64T）
600

監査ログを使用する場合
監査ログを使用する場合は，OSごとのネイティブプログラム使用領域サイズの値に，監査ログで使用する値を加える必要があります。監査ログで使用する値を算出するには，auditlog.raslog.message.filesizeキー，およびauditlog.raslog.exception.filesizeキーを使用します。これらのキーは，auditlog.properties（監査ログ定義ファイル）で指定するキーです。これらのキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」の監査ログ定義ファイルに関する説明を参照してください。
監査ログで使用する値（単位：メガバイト）の計算式を次に示します。
監査ログで使用する値 =
8＋（auditlog.raslog.message.filesizeの指定値 / 1,024²）※＋（auditlog.raslog.exception.filesizeの指定値 / 1,024²）※
注※　指定値の単位はバイトです。仮想メモリの使用量の値の単位はメガバイトであるため，1,024²で割る必要があります。

D：J2EEサーバのスレッド数
J2EEサーバが使用するスレッド数です。J2EEサーバが使用するスレッド数についての詳細は，「付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照してください。

E：スタック領域サイズ
JavaVM起動時のオプション-Xssに指定した値です。

(2)　仮想メモリの使用量を計算する場合の注意事項

セッションフェイルオーバ機能を使用する構成の場合，SFOサーバのJavaVMのOld領域，New領域のサイズをJ2EEサーバの仮想メモリの使用量に加える必要があります。詳細については，マニュアル「Cosminexus　システム構築ガイド」のSFOサーバの起動オプションの設定についての説明を参照してください。

ネイティブプログラム使用領域サイズの値は変動します。値が変動するのは次のような場合です。

ORBのトレースサイズを変更した場合

JDBCドライバの使用領域サイズの値を変更した場合

使用する製品のネイティブライブラリ使用領域サイズの値を変更した場合

このような場合，製品ごとのメモリ使用量をネイティブプログラム使用領域サイズの値に加えてください。製品ごとのメモリ使用量は，使用する製品のドキュメントに従って算出してください。

J2EEサーバの標準構成で使用する仮想メモリの使用量は，使用するソフトウェア製品の影響で，見積もり値よりも大きくなる場合があります。その場合の増加分については，仮想メモリの使用量の値に加えてください。増加分のメモリ使用量は，使用するソフトウェア製品のドキュメントに従い，製品ごとのメモリ使用量を算出してください。

5.1.7　セッションフェイルオーバ機能使用時の見積もり

セッションフェイルオーバ機能を使用する場合，J2EEサーバが使用するメモリ量が増加します。J2EEサーバ単位のメモリ増加量を求める式を次に示します。

J2EEサーバ単位のメモリ増加量（単位：メガバイト）
　＝Webアプリケーション単位のメモリ増加量の合計＋1.5

Webアプリケーション単位のメモリ増加量の合計は，それぞれのWebアプリケーションで使用するメモリ増加量を合計したものです。Webアプリケーションで使用するメモリ増加量は，次の式で求められます。

Webアプリケーションで使用するメモリ増加量（単位：メガバイト）
　＝最大同時実行スレッド数※1×グローバルセッション情報の最大サイズ※2×1.5

注※1

Webアプリケーション単位の同時実行スレッド数を設定しているかどうかによって値が異なります。最大同時実行スレッド数に指定する値を次の表に示します。

表5-35　最大同時実行スレッド数に指定する値

Webアプリケーション単位の同時実行スレッド数の設定 | 最大同時実行スレッド数に指定する値
設定有り | Webアプリケーション単位の最大同時実行スレッド数
設定無し | Webコンテナ単位の最大同時実行スレッド数

なお，Webアプリケーション単位の同時実行スレッド数については，マニュアル「Cosminexus　機能解説」のWebアプリケーション単位での同時実行スレッド数の制御に関する説明を参照してください。

注※2

DD（web.xml）で設定したセッションフェイルオーバ機能用の設定パラメタ（GSInfosLengthMax）の値です。GSInfosLengthMaxパラメタについては，マニュアル「Cosminexus　機能解説」のDDの定義に関する説明を参照してください。

5.2　運用・障害設計

日常運用の操作，メンテナンス，運用スケジュールなどの運用設計，および障害発生時のシステム運用の障害設計について，検討します。

＜この節の構成＞

5.2.1　Cosminexusのシステムでできる運用作業

5.2.2　運用設計

5.2.3　障害設計

5.2.1　Cosminexusのシステムでできる運用作業

J2EEアプリケーションを実行するシステムでは次に示す運用作業を実施できます。

システムの起動と停止

システムの運用監視

システムの処理性能解析

J2EEアプリケーションとリソースの管理

システムの監査

システムの変更

システム環境の移行

トラブルシューティング

それぞれの運用作業について説明します。

＜この項の構成＞

(1)　システムの起動と停止で実行できる作業

(2)　システムの運用監視で実行できる作業

(3)　システムの処理性能解析で実行できる作業

(4)　J2EEアプリケーションとリソースの管理で実行できる作業

(5)　システムの監査で実行できる運用作業

(6)　システムの変更でできる運用作業

(7)　システム環境の移行で実行できる運用作業

(8)　トラブルシューティングで実行できる作業

(1)　システムの起動と停止で実行できる作業

システムの起動と停止で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-36　システムの起動と停止で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットを一括起動します。 | 不要 | － | 7.2 | cmx_start_target
サービスユニットを一括停止します。 | 不要 | － | 7.2 | cmx_stop_target
クラスタソフトウェアを使用したシステムを起動・停止します。 | 必要 | 構築 | 運用 | Cosminexusのコマンド，クラスタソフトウェアの機能

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

(2)　システムの運用監視で実行できる作業

システムの運用監視で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-37　システムの運用監視で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットのステータス，およびWebシステムに関連づいていない論理サーバを確認します。 | 不要 | － | cmx_list_status
論理サーバのステータスを確認します。 | 不要 | 構築 | 運用 | 運用管理コマンド（mngsvrutil）
Webシステム内のサービスユニットの構成，およびWebシステムに関連づいていない論理サーバの一覧を確認します。 | 不要 | － | cmx_list_model
稼働情報ファイルを参照して，J2EEサーバおよびSFOサーバの稼働情報を監視します。 | 省略可 | 構築 | 運用 | －
運用管理コマンドを使用して，J2EEサーバおよびSFOサーバの稼働情報を監視します。 | 不要 | － | 運用 | 運用管理コマンド（mngsvrutil）
リソースの使用率や使用数を監視して，しきい値を超えた場合に原因を調査します。 | 省略可 | 構築 | 運用 | －
稼働情報ファイルに出力される稼働情報，またはリソースの枯渇状況に応じてメッセージが出力された場合の処理を自動化します（Managementアクション）。 | 必要 | 5.2.3(3)，6.19.2，構築 | － | －
CTMの稼働統計情報を出力します。※ | 不要 | － | 運用 | 運用管理コマンド（mngsvrutil）
トランザクションの状態を確認します。 | 不要 | － | 運用 | サーバ管理コマンド（cjlisttrn）

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

注※　CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

(3)　システムの処理性能解析で実行できる作業

システムの処理性能解析で実行できる作業について，次の表に示します。

表5-38　システムの処理性能解析で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
性能解析トレースファイルを収集します。 | 不要 | － | 運用 | 運用管理コマンド（mngsvrutil）
収集した性能解析トレースファイルを利用してシステムの処理性能を解析します。 | 不要 | － | 運用 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

運用：マニュアル「Cosminexus　システム運用ガイド」

(4)　J2EEアプリケーションとリソースの管理で実行できる作業

J2EEアプリケーションとリソースの管理で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-39　J2EEアプリケーションとリソースの管理で実行できる作業

運用作業
運用前の設定の要否
運用前の設定方法の参照先
運用方法

参照先
手段

Webアプリケーションの稼働状況を確認します。
不要
－
運用
運用管理コマンド（mngsvrutil）

アクセス状況に応じて，Webアプリケーションの同時実行スレッド数を動的に変更します。
不要
－
運用
運用管理コマンド（mngsvrutil）

CTMのスケジュールキューの稼働状況を確認して，同時実行数を動的に変更します。※1
不要
－
運用

確認：運用管理コマンド（mngsvrutil）

確認と変更：CTMのコマンド（ctmlsque，ctmchpara）

J2EEアプリケーションの実行状態を確認して，J2EEアプリケーションでタイムアウトが発生したリクエストをキャンセルします（J2EEアプリケーションの実行時間監視機能）。
必要
5.2.3(3)，6.19.2，構築
運用

確認：サーバ管理コマンド（cjlistthread）

キャンセル：サーバ管理コマンド（cjstopthread）

J2EEアプリケーションを通常開始します。
不要
－
リファレンス
サーバ管理コマンド（cjstartapp）

J2EEアプリケーションを通常停止します。
不要
－
運用
サーバ管理コマンド（cjstopapp）

J2EEアプリケーションを強制停止します。
不要
－
運用
サーバ管理コマンド（cjstopapp）

負荷分散機を使用してサービスを閉塞します。※2
－
－
運用
負荷分散機の機能

CTMを利用してサービスを閉塞します。※1
不要
－
運用
運用管理コマンド（mngsvrutil）

J2EEアプリケーションを入れ替えます。
リデプロイによる入れ替え
省略可
構築
7.3.2(1)，運用
サーバ管理コマンド（cjreplaceapp）

通常の入れ替え
不要
－
7.3.2(2)，運用
サーバ管理コマンド（cjstopapp，cjimportapp）

リロードによる入れ替え
必要
構築
運用
サーバ管理コマンド（cjreloadapp）

JSPを事前にコンパイルしてから，J2EEアプリケーションを入れ替えます。
省略可／不要
構築
運用
cjjspcコマンド

J2EEアプリケーションの名称を変更します。
不要
－
－
サーバ管理コマンド（cjrenameapp）

CTMを利用して，オンライン状態でJ2EEアプリケーションを入れ替えます。※1
不要
－
運用
運用管理コマンド（mngsvrutil）

J2EEアプリケーションを本番環境でテストしてから本番運用を開始します。
不要
－
運用
サーバ管理コマンド（cjimportapp，cjstartapp）

コネクションプールの情報を表示します。
不要
－
解説
サーバ管理コマンド（cjlistpool）

コネクションプールをクリアします。
不要
－
解説
サーバ管理コマンド（cjclearpool）

JavaBeansリソースを入れ替えます。
不要
－
運用
サーバ管理コマンド（cjdeletejb，cjimportjb）

クラスタ構成のデータベースをメンテナンスします。
不要
－
運用
サーバ管理コマンド（cjlistrar，cjsuspendpool，cjresumepool）

リソースの接続テストをします。
必要
構築
解説
サーバ管理コマンド（cjtestres）

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

解説：マニュアル「Cosminexus　機能解説」

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

注※1　CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

注※2　負荷分散機をSmart Composer機能で管理していない場合に実行します。負荷分散機をSmart Composer機能で管理している場合は，cmx_stop_targetコマンドを使用してサービスを閉塞してください。cmx_stop_targetコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_start_target」を参照してください。

(5)　システムの監査で実行できる運用作業

監査ログを使用したシステムの監査，およびデータベース監査証跡と連携した運用で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-40　システムの監査で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
監査ログを出力して，管理します。 | 必要 | 構築 | 運用 | －
監査ログを収集して調査します。 | 必要 | 構築 | 運用 | －
データベース監査証跡に出力された情報を基に，データベースにアクセスしたリクエストの情報を特定します。 | 不要 | － | 運用 | －

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

(6)　システムの変更でできる運用作業

システムの変更で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-41　システムの変更で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
設定変更 | システム全体の設定を一括で変更します。 | 不要 | － | 7.4
構成変更 | システムをスケールアウトします。 | 不要 | － | 7.5，7.7
システムをスケールインします。 | 不要 | － | 7.6，7.7
削除 | システムを削除します。 | 不要 | － | 7.9

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(7)　システム環境の移行で実行できる運用作業

システム環境の移行で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-42　システム環境の移行で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
構築済みのシステムの環境を移行します。 | 不要 | － | 7.8 | cmx_export_model

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(8)　トラブルシューティングで実行できる作業

トラブルシューティングで実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表5-43　トラブルシューティングで実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
トラブルシューティングに必要な資料を収集します。 | 必要／省略可 | 5.2.3(1)，構築 | 運用 | 運用管理コマンド（mngsvrutil）
論理サーバ（構成ソフトウェアのサーバプロセス）に異常が発生した場合の処理を自動化します。 | 省略可 | 構築 | 運用 | －
トラブルシューティングに必要な資料を調査します。 | 不要 | － | 運用 | －
負荷分散機を閉塞して，Webシステムの部分メンテナンスをします。 | 不要 | － | 7.3.1

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

5.2.2　運用設計

運用設計では，システムの起動や停止などの日常運用操作，OSパッチや予防保守・点検のための部分閉塞・再開／J2EEアプリケーション入れ替えなどのメンテナンス，運用スケジュール，運用スケジュールの自動化，監視，稼働性能統計などを設計します。

ここでは，Smart Composer機能で構築したシステムで実現できる次に示す運用について説明しています。

日常運用

サービスユニットの一括起動

サービスユニットの一括停止

メンテナンス

システムの部分メンテナンス

J2EEアプリケーションの入れ替え

システムの一括設定変更

システムの構成変更

システムのスケールアウト

システムのスケールイン

構築済みのシステムの移行

システムの削除

これらの運用の操作手順，および設定の変更方法については，それぞれ次の個所を参照してください。

日常運用の操作手順
「7.2　日常運用の操作」

メンテナンスの方法
「7.3　システムのメンテナンス」

システムの設定変更の方法
「7.4　システム全体の設定変更」

システムの構成変更の方法

システムのスケールアウトの方法
「7.5　システムのスケールアウト」，「7.7.1　運用管理サーバモデルでのシステムのスケールアウト」または「7.7.2　ホスト単位管理モデルでのシステムのスケールアウト」

システムのスケールインの方法
「7.6　システムのスケールイン」または「7.7.3　JP1/SC/DPMを利用して構築したシステムのスケールイン」

構築済みのシステムの移行の方法
「7.8　構築済みのシステムの移行」

システムの削除の方法
「7.9　システムの削除」

combined-tier構成で構築したWebシステムを例に使用して，それぞれの運用について説明します。なお，ここで説明している運用は，http-tierとj2ee-tierを組み合わせた構成，sfo-tierと組み合わせた構成，およびctm-tierを使用する構成で構築したWebシステムでも操作できます。

また，各構成で構築したWebシステムのサービスユニットに対する一括起動，一括停止，スケールイン，スケールアウトなどの操作も，ここで説明している業務サービス用のサービスユニットに対する操作と同じです。

＜この項の構成＞

(1)　日常運用

(2)　メンテナンス

(3)　システムの設定変更

(4)　システムの構成変更

(5)　システム環境の移行

(6)　システムの削除

(1)　日常運用

Smart Composer機能で構築したシステムで実施できる，日常運用の操作を説明します。

(a)　サービスユニットの一括起動と一括停止

サービスユニットの一括起動と一括停止ができます。一括起動および一括停止は，Webシステム内のすべてのサービスユニットに対して実施したり，特定のサービスユニットに対して実施したりできます。

一括起動および一括停止の範囲を次の図に示します。

図5-1　一括起動および一括停止の範囲

特定のサービスユニットに対して起動または停止できるので，例えば，サービスユニット1だけを停止させるという操作が実現できます。

参考

セッションフェイルオーバ機能を使用したシステムの場合，業務用のサービスユニットとセッションフェイルオーバ用のサービスユニットとの間で依存関係はありません。このため，特定のサービスユニットに対して起動／停止を実施する場合，起動／停止順序に優先順位はありません。なお，通常の場合，起動時はセッションフェイルオーバ用のサービスユニットを先に起動し，停止時はセッションフェイルオーバ用のサービスユニットをあとで停止します。

(2)　メンテナンス

Smart Composer機能で構築したシステムで実施できる，メンテナンス時の操作を説明します。

(a)　システムの部分メンテナンス

サービスユニット単位での一括停止および一括開始のコマンドを使用して，サービスユニットを閉塞・再開できます。これを利用して，OSのパッチ適用や予防保守・点検などの，システムの部分メンテナンスを，業務を停止しないで実施できます。

システムの部分メンテナンス（サービスユニット1をメンテナンスする場合）について，次の図を使用して説明します。

図5-2　サービスユニット1をメンテナンスする場合

サービスユニットをメンテナンスする場合の流れについて説明します。なお，1.および2.の操作は，Smart Composer機能のコマンドを使用して実施します。

一括停止のコマンドを使用して，サービスユニット1だけを閉塞します。

サービスユニット1に対してメンテナンスを実施したあと，一括開始コマンドを使用して，サービスユニット1を再開します。
なお，サービスユニット2はこの間，業務を続行します。

(b)　J2EEアプリケーションの入れ替え

J2EEアプリケーションを入れ替えられます。J2EEアプリケーションを修正した場合などに利用できます。J2EEアプリケーションの入れ替えには，リデプロイによる入れ替えと，通常の入れ替えがあります。

リデプロイによる入れ替えと通常の入れ替えについて，次の図にそれぞれ示します。

図5-3　J2EEアプリケーションの入れ替え

J2EEアプリケーションのリデプロイによる入れ替えと通常の入れ替えの流れそれぞれについて説明します。なお，リデプロイによる入れ替えにはサーバ管理コマンド，通常の入れ替えにはSmart Composer機能のコマンドおよびサーバ管理コマンドを使用します。

J2EEアプリケーションのリデプロイによる入れ替え

入れ替えるEARファイルのパスを指定して，リデプロイします。

J2EEアプリケーションの通常の入れ替え

システムを閉塞します。

J2EEアプリケーションを停止します。

入れ替え前のJ2EEアプリケーションを削除します。

入れ替え後のJ2EEアプリケーションをインポートします。

J2EEアプリケーションに必要な情報を設定，およびカスタマイズします。

J2EEアプリケーションを開始します。

システムを再開します。

(3)　システムの設定変更

Smart Composer機能でできる，システムの設定変更の操作を説明します。

(a)　システムの設定の一括変更

システム全体の設定は，一括で変更できます。システム全体の設定の一括変更について次の図に示します。

図5-4　システム全体の設定の一括変更

システム全体の設定の一括変更の流れについて説明します。なお，1.～3.の操作はすべてSmart Composer機能のコマンドを使用して実施します。それぞれの操作は，システム内のすべてのサービスユニットに対して一括で実施できます。

システムを停止します。

変更後の設定をシステムに反映させます。
システム内のすべての設定を一度に変更できます。

システムを起動します。

(4)　システムの構成変更

システムの構成変更について説明します。

(a)　システムのスケールアウトおよびスケールイン

システムのスケールアウトおよびスケールインができます。スケールアウトとは，システム全体の処理性能を向上させることを目的として，サーバの台数を増やすことをいいます。また，スケールインとは，システムの規模を縮小する場合などに，サーバの台数を減らすことをいいます。

スケールアウトおよびスケールインは，サービスユニット単位またはWebシステム単位で実施できます。なお，スケールアウトおよびスケールインは，業務全体を停止することなく実施できます。

スケールアウトおよびスケールインについて次の図に示します。

図5-5　スケールアウトおよびスケールイン

この図では，サービスユニット3をシステムに追加（スケールアウト），およびシステムから削除（スケールイン）しています。サービスユニット3のスケールアウトおよびスケールインに際しては，稼働中のサービスユニット1およびサービスユニット2には影響はないため，業務全体を停止することなく，スケールアウトおよびスケールインができます。

(b)　JP1/SC/DPMと連携したスケールアウト

Smart Composer機能でシステムをスケールアウトする際に，JP1/SC/DPMと連携できます。ただし，セッションフェイルオーバ機能を使用するシステムの場合，セッションフェイルオーバサーバマシンでは，JP1/SC/DPMと連携したスケールアウトを利用できません。

JP1/SC/DPMでは，システムのディスクイメージを複製し，複製したデータを基にして，OSやアプリケーションを一括でサーバにインストールできます（ディスク複製OSインストール機能）。Smart Composer機能でシステムをスケールアウトするときにJP1/SC/DPMと連携すると，構築済みのシステムの複製した情報を使用して，追加するアプリケーションサーバにOSやアプリケーションを一括インストールできます。

JP1/SC/DPMと連携してスケールアウトをするときの流れを次の図に示します。

図5-6　JP1/SC/DPMと連携したスケールアウト

JP1/SC/DPMと連携したスケールアウトの流れについて説明します。なお，ここでは，サービスユニット1が構築済みの場合に，JP1/SC/DPMを使用して，サービスユニット2をシステムに追加（スケールアウト）するときの例で説明します。

Smart Composer機能で構築済みのサービスユニット1のディスクイメージを，JP1/SC/DPMを使用して複製します。

1.で複製したディスクイメージに従って，追加するサービスユニット2にOSやアプリケーションをインストールします。

Smart Composer機能のコマンドを使用して，サービスユニット2をシステムに追加（スケールアウト）します。

参考

JP1/SC/DPMと連携すると，ホスト単位管理モデルのシステムも構築できます。ホスト単位管理モデルのシステムでは，マシン（運用管理ドメイン）単位に，スケールアウトしてサーバの台数を増やしたり，またはスケールインしてサーバの台数を減らしたりできます。ホスト単位管理モデルでのスケールアウトおよびスケールインについては，「7.7.2　ホスト単位管理モデルでのシステムのスケールアウト」，および「7.7.3(2)　ホスト単位管理モデルでのシステムのスケールイン」を参照してください。

(5)　システム環境の移行

システム環境の移行について説明します。

(a)　構築済みのシステムの移行

構築済みのシステムの移行ができます。テスト環境で構築したシステムを本番環境に移行する場合などに利用できます。

構築済みのシステムの移行について次の図に示します。

図5-7　構築済みのシステムの移行

構築済みのシステムの移行の流れについて説明します。構築済みのシステムを移行するためには，移行先のシステムで，Management Serverが動作している必要があります。構築済みのシステムを移行する前に，移行先のシステムでインストールと初期設定を済ませておいてください。なお，1.～2.の操作はSmart Composer機能のコマンドを使用して実施します。

移行元の環境で，システムの設定内容を簡易構築定義ファイルの形式で出力します。

移行先の環境で，出力した簡易構築定義ファイルを使用して，システムを構築します。移行先の環境では，移行元の環境のシステムと同じ設定内容のシステムが構築されます。

(6)　システムの削除

不要になったシステムを削除できます。システムを削除するには，Smart Composer機能で提供するコマンドを使用します。システムの削除については，「7.9　システムの削除」を参照してください。

5.2.3　障害設計

障害設計では，障害発生時の対応に関して，障害部分の切り離し，障害からの復旧，障害時の取得資料，障害原因の切り分け，障害調査などについて設計します。

Smart Composer機能では，障害発生時の資料取得に加えて，問題発生時にサービスユニットを自動部分閉塞したり，自動部分再起動したりするような高度な運用ができます。これには，Cosminexusの障害検知時コマンドを利用したり，リソース枯渇監視機能やJ2EEアプリケーションの実行時間監視機能を利用したりします。

Smart Composer機能で実施できる障害発生時の運用を次に示します。

障害発生時のサービスユニットの自動閉塞
障害が発生したサービスユニットの自動閉塞（障害発生時のシステムの自動部分閉塞）

障害発生時のサービスユニットの自動再起動
障害が発生したサービスユニットの自動再起動（障害発生時のシステムの自動部分再起動）

これらの運用をする場合は，システム構築時に設定をしておく必要があります。設定手順については，それぞれ次の個所を参照してください。

サービスユニットを自動閉塞するための設定
「6.19.1　障害発生時にサービスユニットを自動閉塞するための設定」

サービスユニットを自動再起動するための設定
「6.19.2　サービスユニットを自動再起動するための設定」

なお，そのほかの障害時の対応については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

combined-tier構成で構築したWebシステムを例に使用して，障害発生時の運用について次に説明します。なお，ここで説明している運用は，http-tierとj2ee-tierを組み合わせた構成で構築したWebシステムでも設定できます。

＜この項の構成＞

(1)　障害発生時の資料取得

(2)　障害発生時のサービスユニットの自動閉塞

(3)　障害発生時のサービスユニットの自動再起動

(1)　障害発生時の資料取得

システムで障害が発生した場合，トラブルシューティングに必要な資料が収集できます。トラブルシューティングに必要な資料は，個別に取得したり，snapshotログとして一括して取得したりできます。snapshotログは，システムの構成ソフトウェアが障害発生時にそのときの状態を出力したログで，各種構成ソフトウェアのログのほかに，スレッドダンプ（ハングアップの場合だけ），性能解析トレースなどが含まれます。

障害発生時のタイムリーな情報をsnapshotログとして収集するためには，障害検知時コマンドを利用します。障害検知時コマンドは，Management Serverが論理サーバの障害を検知したときに，システムによって実行されるコマンドです。障害検知時コマンドを利用して，トラブル発生時のスレッドダンプやユーザダンプの取得などの処理を実行することで，障害発生時のタイムリーな資料を取得できるようになります。障害検知時コマンドには，システム提供の障害検知時コマンドとユーザ作成の障害検知時コマンドの2種類があります。

システム提供の障害検知時コマンド
障害の発生したJ2EEサーバのスレッドダンプ（ハングアップの場合だけ）および性能解析トレースなどを取得します。

ユーザ作成の障害検知時コマンド
障害発生時に実行する処理をユーザが定義します。

障害検知時コマンドの実行とsnapshotログの収集によって，トラブルシューティングに必要な情報を取得できます。障害検知時コマンドの概要については，マニュアル「Cosminexus　機能解説」の障害検知時コマンドによる資料取得に関する説明を参照してください。

また，資料によっては，事前に取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプなどは，システム構築時に取得のための設定をしておかないと取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。デフォルトの設定ではsnapshotログとして収集できない資料でも，その資料の取得先をsnapshotログの収集対象として定義することで，snapshotログとして一括収集できるようになります。

デフォルトの設定でsnapshotログとして収集できる資料とsnapshotログ収集の設定については，マニュアル「Cosminexus　システム構築ガイド」のsnapshotログ収集の設定に関する説明を参照してください。取得できる資料の詳細については，マニュアル「Cosminexus　システム運用ガイド」の取得が必要な資料の種類に関する説明を参照してください。

参考

ユーザ作成の障害検知時コマンドには，Smart Composer機能のコマンドを定義しておくこともできます。例えば，致命的な障害が発生したサービスユニットを自動閉塞するコマンドを，障害検知時コマンドとして設定しておくことができます。障害検知時コマンドを利用したサービスユニットの自動閉塞については，「(2)　障害発生時のサービスユニットの自動閉塞」を，障害検知時コマンドを利用して自動閉塞する場合の設定については，「6.19.1　障害発生時にサービスユニットを自動閉塞するための設定」を参照してください。

(2)　障害発生時のサービスユニットの自動閉塞

システムで障害が発生した場合に，Management Serverが障害を検知すると，システムによってCosminexusの障害検知時コマンドが実行されます。Smart Composer機能では，この障害検知時コマンドを利用して，致命的な障害が発生したサービスユニットを自動閉塞できます。

障害発生時のサービスユニットの自動閉塞を次の図に示します。

図5-8　障害発生時のサービスユニットの自動閉塞

障害発生時のサービスユニット自動閉塞の仕組みについて説明します。

サービスユニット内の論理サーバで障害が発生すると，アプリケーションサーバ内の運用管理エージェントは障害発生を検知し，Management Serverに障害発生を通知します。Management Serverでは，障害発生を検知すると，自動的にコマンドを実行できます。このコマンドを障害検知時コマンドといいます。障害検知時コマンドには，システム提供の障害検知時コマンドと，ユーザ作成の障害検知時コマンドの2種類があり，ユーザ作成の障害検知時コマンドでは，障害が発生したときに呼び出すコマンドを定義できます。

ユーザ作成の障害検知時コマンドとして，Smart Composer機能のコマンドを定義することで，障害が発生したサービスユニットを自動閉塞できます。

なお，障害検知時コマンドの概要については，マニュアル「Cosminexus　機能解説」の障害検知時コマンドによる資料取得に関する説明を参照してください。

(3)　障害発生時のサービスユニットの自動再起動

JavaVMのフルガーベージコレクションやスレッド数などのリソース枯渇を事前に検知したり，J2EEアプリケーションの実行時間監視タイムアウトを検知したりすると，問題が発生したサービスユニットを自動再起動します。サービスユニットの自動再起動には，Cosminexusのリソース枯渇監視機能や，J2EEアプリケーションの実行時間監視機能を利用します。

障害発生時のサービスユニットを自動再起動する図を次に示します。

図5-9　障害発生時のサービスユニットの自動再起動

障害発生時のサービスユニット自動再起動の仕組みについて説明します。

サービスユニットの自動再起動では，Cosminexusのリソース枯渇監視機能，およびJ2EEアプリケーションの実行時間監視機能を利用します。リソース枯渇監視機能でリソース枯渇を事前に検知したり，J2EEアプリケーションの実行時間監視でタイムアウトを検知したりすると，これらの情報がManagementイベントとして，運用管理サーバに通知されます。Managementイベントが通知されると，Management ServerではManagementアクションが実行されます。Managementアクションでは，ユーザがあらかじめ定義しておいた処理を実施します。

Managementアクションとして，サービスユニットを再起動するSmart Composer機能のコマンドを定義することで，障害の発生したサービスユニットを自動再起動できます。

なお，Managementイベント，Managementアクション，リソース枯渇機能，およびJ2EEアプリケーションの実行時間監視機能については，マニュアル「Cosminexus　機能解説」のシステムの運用支援に関する説明を参照してください。

5.3　簡易構築定義ファイルの運用方法

Cosminexusのシステム構築には，簡易構築定義ファイルを使用します。簡易構築定義ファイルは，Webシステムの設定内容をXML形式で定義するファイルです。

システム運用中は，簡易構築定義ファイルをシステムの資産として保持し，設定情報を常に管理することを推奨します。

システムを構築したあとに，システムの設定内容を変更する場合は，システム構築時に使用した簡易構築定義ファイルをメンテナンスします。メンテナンスした簡易構築定義ファイルを基にシステムを再構築すると，メンテナンス結果がシステムに反映されます。

システムを構築したあとにシステムの構成変更をする場合は，構成変更定義ファイルを使用してください。簡易構築定義ファイルの編集で，システムの構成変更はできません。

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

この章では，Smart Composer機能を使用した，J2EEアプリケーションを実行するシステムの構築について説明します。なお，システム構築で使用するSmart Composer機能のコマンドやファイルについては，「12.　コマンド」および「13.　ファイル」を参照してください。

＜この章の構成＞

6.1　システム構築の概要

6.2　インストール

6.3　負荷分散機の設定

6.4　ホスティング環境の設定

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

6.6　運用管理サーバの設定

6.7　Cosminexusから負荷分散機を制御するための設定

6.8　システムの構成定義

6.9　DB ConnectorのConnector属性ファイルの編集

6.10　システムの一括構築

6.11　システムの一括起動

6.12　チューニング

6.13　インプロセスHTTPサーバ機能を使用する場合に必要な設定

6.14　負荷分散機を冗長化する場合に必要な設定

6.15　セッションフェイルオーバ機能を使用する場合に必要な設定

6.16　CTMを使用する場合に必要な設定

6.17　サーバマシン内に複数のサービスユニットを配置する場合に必要な設定

6.18　論理ユーザサーバを使用する場合に必要な設定

6.19　障害に対応したシステムの構築

6.1　システム構築の概要

各サーバの初期設定が終わったら，システムの一括構築，リソースアダプタのインポートと開始，J2EEアプリケーションのインポートと開始の順に操作してシステムを構築していきます。システムの一括構築の操作はSmart Composer機能のコマンド，リソースアダプタとJ2EEアプリケーションの操作はサーバ管理コマンドを使用して実施します。サーバ管理コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」のJ2EEサーバで使用するコマンドに関する説明を参照してください。

ここでは，Smart Composer機能を使用したシステム構築の概要を説明します。なお，JP1/IM - CMおよびJP1/AJS2 - SOと連携するときのシステム構築については，「15.　JP1と連携したSmart Composer機能でのシステム構築・運用」もあわせて参照してください。

J2EEアプリケーションを実行するシステムの一括構築について，使用するコマンドとシステム構築との関係を，次の図に示します。なお，システムの一括構築で使用するSmart Composer機能のコマンドは，運用管理サーバ上で実行します。

図6-1　コマンドとシステム構築の関係（J2EEアプリケーションを実行するシステムの一括構築）

図中の記号（A-1～A-2）について説明します。

操作 | 図中の記号 | 操作の詳細 | 使用するコマンド
システムの一括構築 | A-1 | 簡易構築定義ファイルの情報を基にして，Management Server上にシステムの情報モデルを生成します。 | cmx_build_system
A-2 | 生成した情報モデルに従って，すべてのアプリケーションサーバ上にシステムを構築します。

参考

cmx_から始まるSmart Composer機能のコマンドには共通引数（-m，-u，-p，-waitまたは-nowait，-verboseまたは-noverbose）があります。共通引数を省略したときのデフォルト値を，.cmxrcファイルまたはcmxclient.propertiesファイルに設定できます。

省略時のデフォルト値を，クライアントごとに設定する場合は.cmxrcファイルに，すべてのクライアント共通で設定する場合はcmxclient.propertiesファイルに設定します。

.cmxrcファイルの詳細については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を，cmxclient.propertiesファイルの詳細については，「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

リソースアダプタおよびJ2EEアプリケーションのインポートと開始について，使用するコマンドとシステム構築との関係を，次の図に示します。なお，リソースアダプタおよびJ2EEアプリケーションのインポートと開始で使用するサーバ管理コマンドは，アプリケーションサーバ上で実行します。

図6-2　コマンドとシステム構築の関係（リソースアダプタおよびJ2EEアプリケーションのインポートと開始）

図中の記号（B-1～C-3）について説明します。

操作 | 図中の記号 | 操作の詳細 | 使用するコマンド
リソースアダプタのインポートと開始 | B-1 | リソースアダプタをJ2EEサーバにインポートします。 | cjimportres
B-2 | J2EEサーバにリソースアダプタをデプロイします。 | cjdeployrar
B-3 | Connector属性ファイルをリソースアダプタに反映します。 | cjsetrarprop
B-4 | リソースアダプタの接続テストをします。 | cjtestres
B-5 | J2EEサーバでリソースアダプタを開始します。 | cjstartrar
J2EEアプリケーションのインポートと開始 | C-1 | J2EEアプリケーションをJ2EEサーバにインポートします。 | cjimportapp
C-2 | アプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。 | cjsetappprop
C-3 | J2EEサーバでJ2EEアプリケーションを開始します。 | cjstartapp

リソースアダプタおよびJ2EEアプリケーションのインポートと開始は，J2EEサーバごとに実施してください。

参考

サーバ管理コマンドを実行する際には-nameserverオプションにプロバイダURLを指定する必要があります。-nameserverオプションに指定するプロバイダURLは，usrconf.properties（サーバ管理コマンド用システムプロパティファイル）に幾つかの設定をすることで省略できます。プロバイダURLを省略するための設定の詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」のJ2EEサーバで使用するコマンドの概要に関する説明を参照してください。

Smart Composer機能を使用して構築できるシステムと，システム構築手順の参照先を次の表に示します。なお，Smart Composer機能を使用して構築できるシステムの構成パターンについては，「4.3　システム構成パターン」を参照してください。

表6-1　Smart Composer機能を使用して構築できるシステムと，システム構築手順の参照先

システムの構成パターン | システム構築手順の参照先
WebサーバとJ2EEサーバを同じサーバマシンに配置する構成（combined-tier構成） | 「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」
WebサーバとJ2EEサーバを別のサーバマシンに配置する構成（http-tierとj2ee-tierを組み合わせた構成） | 「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」
インプロセスHTTPサーバ機能を使用する構成 | 「6.13　インプロセスHTTPサーバ機能を使用する場合に必要な設定」
負荷分散機を冗長化する構成 | 「6.14　負荷分散機を冗長化する場合に必要な設定」
セッションフェイルオーバ機能を使用する構成 | 「6.15　セッションフェイルオーバ機能を使用する場合に必要な設定」
CTMを使用する構成 | 「6.16　CTMを使用する場合に必要な設定」
サーバマシン内に複数のサービスユニットを配置する構成 | 「6.17　サーバマシン内に複数のサービスユニットを配置する場合に必要な設定」
論理ユーザサーバを使用する構成 | 「6.18　論理ユーザサーバを使用する場合に必要な設定」

＜この節の構成＞

6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例

6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ

6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例

Smart Composer機能を使用したシステム構築では，システムを一括構築できます。

ここでは，WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを一括構築する場合の，システム構築例について説明します。システム構築例を次の図に示します。次の図に示すシステム構築例を，以降のシステム構築の説明に使用します。

図6-3　システム構築例

＜この項の構成＞

(1)　システム構築例で使用している設定

(2)　コマンドを実行するサーバ

(1)　システム構築例で使用している設定

システム構築例で使用している設定を，次に示します。

運用管理サーバ

管理IPアドレス　192.168.100.100

Management Server

ユーザID　cosmi_admin

パスワード　cosmi_admin_passwd

負荷分散機（BIG-IP 1500）※

名称　MyBIGIPv9

管理IPアドレス　192.168.100.10

仮想サーバ

サーバ名　www.sample.com

IPアドレス　192.168.1.10

ポート番号　80

サービスユニット1（サービスユニット名：unit1）

アプリケーションサーバ1（アプリケーションサーバ名：apsv1）

管理IPアドレス　192.168.100.11

IPアドレス　192.168.1.11

ポート番号　80

サービスユニット2（サービスユニット名：unit2）

アプリケーションサーバ2（アプリケーションサーバ名：apsv2）

管理IPアドレス　192.168.100.12

IPアドレス　192.168.1.12

ポート番号　80

注※

負荷分散機としてBIG-IP 1500を使用している場合を例にしています。

(2)　コマンドを実行するサーバ

コマンドの種類によって，コマンドを実行するサーバが異なります。コマンドの種類ごとに，コマンドを実行するサーバを次に示します。

Smart Composer機能のコマンドを使用する場合
運用管理サーバでコマンドを実行します。

サーバ管理コマンドを使用する場合
アプリケーションサーバ1またはアプリケーションサーバ2で，それぞれコマンドを実行します。

コマンドの種類と，コマンドを実行するサーバの関係について，次の図に示します。

図6-4　コマンドを実行するサーバ

6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ

システム構築の流れについて説明します。ここでは，「6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例」で示すシステムを一括構築する場合を例に説明します。WebサーバとJ2EEサーバを別のサーバマシンに配置する構成のシステムを一括構築する場合の流れも，ここで説明している流れと同じです。

WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを一括構築する場合の流れを，次の図に示します。

図6-5　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを一括構築する場合の流れ

図中の1.～8.について説明します。

インストール
アプリケーションサーバ，運用管理サーバ，データベースサーバにそれぞれ必要なソフトウェア製品をインストールします。

負荷分散機の設定
sshコマンドを使用，または負荷分散機へTelnetでログインして，負荷分散機の設定をします。使用する負荷分散機によって設定が異なります。

初期設定

必要に応じて，OSやデータベースなどのホスティング環境を設定します。

アプリケーションサーバでは，環境変数の設定，データベースを使用するための設定，および運用管理エージェントを自動起動するための設定をします。

運用管理サーバでは，環境変数の設定，Management Serverの設定および自動起動するための設定をします。

必要に応じて，Cosminexusから負荷分散機を制御するための設定をします。

構成定義
簡易構築定義ファイルで，システムの構成を定義します。簡易構築定義ファイルはエディタを使用して作成しますが，テンプレートファイルが用意されているので，構成の基本情報を設定するだけで運用できます。

DB ConnectorのConnector属性ファイルの編集
DB Connectorを使用する場合，Connector属性ファイルのテンプレートを取得して，編集します。

システムの構築
システムの構築では，次の二つの内容を実施します。

構成定義で作成した簡易構築定義ファイルの情報を基に，Management Server上にシステムの情報モデルを生成する

システムの情報モデルからシステムを構築する

システムの構築では，システムの情報モデルの生成から，システムの構築まで，一つのコマンドを使用して一括で実行できます。システムの構成として定義されている，すべてのアプリケーションサーバ上にWebサーバおよびJ2EEサーバをセットアップし，各論理サーバの環境を設定します。

システム内のすべてのサービスユニットを準備状態で開始します。

リソースアダプタのインポートと開始，およびJ2EEアプリケーションのインポートと開始をします。

システムの開始
システム内のすべてのサービスユニットを稼働状態にします。

チューニング
構築したシステムについて，スループット，レスポンス時間，CPU時間などの性能メトリックの相関が適切かどうか多角的に検証し，必要に応じてシステムの構成を変更します。

また，「5.2.3　障害設計」で説明した運用をするためには，システムを構築したあとで設定が必要です。設定方法については，それぞれ次の個所を参照してください。

障害発生時にサービスユニットを自動閉塞するための設定（6.19.1参照）

サービスユニットを自動再起動するための設定（6.19.2参照）

6.2　インストール

各サーバに製品をインストールします。「4.　J2EEアプリケーションを実行するシステムの構成の検討」を参照して，各サーバマシンにそれぞれ必要なソフトウェア製品をインストールしてください。

ここでは，「6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例」の場合に必要な製品を説明します。ここで説明する製品のうち，Application Serverのインストール方法については，リリースノートを参照してください。そのほかの製品のインストール方法については，各製品のマニュアルを参照してください。

負荷分散機

BIG-IP 1500，BIG-IP 1000またはHA8000-ie/Loadflowbal

アプリケーションサーバ

Application Server

HiRDB Type4 JDBC DriverまたはOracle JDBC Thin Driver※1

運用管理サーバ

Application Server

データベースサーバ

HiRDBまたはOracle※2

注※1

Cosminexus DABroker Libraryを使用してデータベースにアクセスする場合は，HiRDB Run TimeまたはOracle Clientをインストールする必要があります。

注※2

データベースサーバの初期設定については，HiRDBの場合は，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。Oracleの場合は，Oracleのドキュメントを参照してください。

参考

JP1/SC/DPMのディスク複製OSインストール機能を使用する場合，JP1/SC/DPM管理サーバにJP1/SC/DPMをインストールする必要があります。

6.3　負荷分散機の設定

ここでは，負荷分散機の設定について，負荷分散機の種類ごとに説明します。

＜この節の構成＞

6.3.1　BIG-IP 1500の場合

6.3.2　BIG-IP 1000の場合

6.3.3　Loadflowbalの場合

6.3.1　BIG-IP 1500の場合

Cosminexusは，sshコマンドを使用して，BIG-IP 1500のCLIコマンドを実行します。BIG-IP 1500を利用するためには，sshコマンドの実行環境を設定する必要があります。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

BIG-IP 1500を利用するためには，運用管理サーバにsshクライアントプログラムが必要です。使用できるsshクライアントプログラムは，PuTTYのCLIコマンドです。PuTTYのCLIコマンドは，事前に入手してください。このコマンドに関する運用管理サーバの環境設定については，「6.6　運用管理サーバの設定」を参照してください。なお，Windowsの場合，以降に記述しているsshコマンドは，PuTTYのCLIコマンドを指します。

(2)　UNIXの場合

sshコマンドは，初めて使用する際に接続確認の問い合わせ要求を実行します。BIG-IP 1500を使用する場合は，この問い合わせを抑止する必要があります。Management Serverを起動する前に，運用管理サーバで次に示す設定をして，問い合わせを抑止してください。

root権限のあるユーザでsshコマンドを実行してBIG-IP 1500と接続し，接続確認の問い合わせ要求（Are you sure you want to continue connecting (yes/no)?）に対して「yes」を応答してください。「yes」を応答したあと，sshコマンドは接続確認の問い合わせ要求を実行しなくなります。

6.3.2　BIG-IP 1000の場合

Cosminexusは，TelnetでログインしてBIG-IP 1000のCLIコマンドを発行し，BIG-IP 1000の設定をします。このとき，ローカルユーザアカウントは，あらかじめ用意されているroot権限のあるユーザ（rootやsupportなど）を使用してください。

ただし，これらのユーザでログインした場合，ログイン中にTerminal typeの問い合わせがある場合があります。BIG-IP 1000を使用する場合は，この問い合わせを抑止する設定が必要です。

Terminal typeの問い合わせは，ホームディレクトリ下の.bash_profileから実行しています。.bash_profileの中にtsetコマンドが記述されている場合は，tsetコマンドに「-m network:network」オプションを追加して，Terminal typeの問い合わせを抑止してください。

.bash_profileの設定例を次に示します。「-m network:network」オプションの追加個所を太字にしています。

：
if [ "$vgadev" = "1" ]
then
   TERM=ibmpc3
elif [ "$serial_console" = "1" ]
then
   eval `tset -m ansi:ansi -m :¥?vt100 -e '^?' -r -s -Q`
elif ( [ "$TERM" == "bsdos-pc" ] ||
      [ "$TERM" == "linux" ] )
then
   eval `tset -m ansi:ansi -m :¥?ibmpc3 -e '^?' -r -s -Q`
else
   eval `tset -m ansi:ansi -m network:network -m :¥?${TERM:-vt100} -e '^?' -r -s -Q`
：

6.3.3　Loadflowbalの場合

負荷分散機（Loadflowbal）の管理機能へのアクセスセキュリティ保護を設定します。LoadflowbalにTelnetでログインして，次の設定をします。なお，Loadflowbalの設定に関する詳細については，HA8000-ie/Loadflowbalのドキュメントを参照してください。

Privileged EXECレベルに必要なパスワードの設定

パスワード（privileged_exec_passwd）を設定する場合の例を示します。

telnet@ServerIron>enable privileged_exec_passwd

Telnetローカルユーザアカウントの設定

ユーザID（lfuser），パスワード（lfuser_passwd）を設定する場合の例を示します。

telnet@ServerIron>enable
Password:

telnet@ServerIron#configure terminal
telnet@ServerIron(config)#username lfuser password lfuser_passwd

Telnetアクセスをローカルアクセス制御で認証する設定

telnet@ServerIron(config)#enable telnet authentication

アクセス認証のためのauthentication-methodリストの設定

telnet@ServerIron(config)#aaa authentication login default local

6.4　ホスティング環境の設定

Smart Composer機能によって構築されたシステムが動作するために，OSやデータベースなどのホスティング環境の設定が必要な場合があります。ここでは，ホスティング環境の設定について説明します。

Smart Composer機能によって構築されたシステムが使用するリソースと設定の要否を，次の表に示します。なお，各リソースに必要な見積もりの詳細については，「5.1　使用リソースの見積もり」を参照してください。

表6-2　使用リソースの設定要否

分類 | リソース | Windowsの場合 | UNIXの場合
データベース | 最大同時接続数 | ○ | ○
サービスユニット | 共有メモリ | × | ○
プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○
運用管理サーバ※ | プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○

（凡例）

○：必要です。

×：不要です。

注※

JP1/SC/DPMを利用して，ホスト単位管理モデルのシステムを構築する場合は，Management Serverが稼働する各サーバマシンで設定します。

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

アプリケーションサーバでは，次の設定をします。

環境変数の設定

データベースを使用するための設定

運用管理エージェントの設定

それぞれの設定の詳細について説明します。

参考

Cosminexus DABroker Libraryを使用して，データベースに接続する場合には，アプリケーションサーバで次の設定をします。

環境変数の設定
Cosminexus DABroker Libraryを使用しない場合と同じです。設定については，「6.5.1　環境変数の設定」を参照してください。

Cosminexus DABroker Libraryの設定
Cosminexus DABroker Libraryの設定については，「付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）」，または「付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）」を参照してください。

データベースの設定
データベースの設定については，「付録K　データベースの設定」を参照してください。

運用管理エージェントの設定
Cosminexus DABroker Libraryを使用しない場合と同じです。設定については，「6.5.3　運用管理エージェントの設定」を参照してください。

＜この節の構成＞

6.5.1　環境変数の設定

6.5.2　データベースを使用するための設定

6.5.3　運用管理エージェントの設定

6.5.1　環境変数の設定

アプリケーションサーバでは，次の表に示す環境変数を設定します。データベースの接続に必要な環境変数については，各データベースのマニュアルを参照してください。なお，Windowsで，システム環境変数を設定した場合は，OSを再起動する必要があります。

表6-3　アプリケーションサーバに設定する環境変数と設定値（Windowsの場合）

環境変数名
設定値
備考

PATH

<Cosminexusのインストールディレクトリ>¥jdk¥bin

<Cosminexusのインストールディレクトリ>¥TPB¥bin

<Cosminexusのインストールディレクトリ>¥PRF¥bin

<ProgramFiles>¥Common Files¥Hitachi※

－

TPDIR
<Cosminexusのインストールディレクトリ>¥TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
<Cosminexusのインストールディレクトリ>¥TPB¥adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
<Cosminexusのインストールディレクトリ>¥PRF¥spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

注※

<ProgramFiles>¥Common Files¥Hitachiは，デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

表6-4　アプリケーションサーバに設定する環境変数と設定値（UNIXの場合）

環境変数名
設定値
備考

LIBPATH
（AIXの場合）

/opt/Cosminexus/TPB/lib

/opt/Cosminexus/PRF/lib

/opt/hitachi/common/lib

－

LD_LIBRARY_PATH
（HP-UX，Linux，またはSolarisの場合）

CSCCFJ_SERVER_HOME
/opt/Cosminexus/CC
Cosminexus Component Containerのインストールディレクトリを設定します。

PATH

/opt/Cosminexus/jdk/bin

/opt/Cosminexus/TPB/bin

/opt/Cosminexus/PRF/bin

/bin

－

TPDIR
/opt/Cosminexus/TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
/opt/Cosminexus/TPB/adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
/opt/Cosminexus/PRF/spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

AIXの場合は，表6-4に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。AIX固有の環境変数を次の表に示します。

表6-5　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利用時，これらの環境変数に対してユーザ側で値を設定していない場合には，運用管理エージェントに「設定値」に示した値が自動的に設定されます。なお，ユーザが値を設定している場合は，ユーザが設定した値が有効になります。

6.5.2　データベースを使用するための設定

データベースとして，HiRDB，またはOracleを使用する場合に必要な設定について説明します。ここでは，HiRDB Type4 JDBC Driverを使用してHiRDBに接続する場合，およびOracle JDBC Thin Driverを使用してOracleに接続する場合に必要な設定について，設定方法を，データベースごとに示します。

なお，Cosminexus DABroker Libraryを使用した場合のHiRDBまたはOracleの設定，XDM/RD E2の設定，およびSQL Serverの設定については，「付録K　データベースの設定」を参照してください。

＜この項の構成＞

(1)　HiRDBの設定（HiRDB Type4 JDBC Driverの場合）

(2)　Oracleの設定（Oracle JDBC Thin Driverの場合）

(1)　HiRDBの設定（HiRDB Type4 JDBC Driverの場合）

HiRDB Type4 JDBC Driverを使用してHiRDBに接続する場合の設定について説明します。なお，データベースとしてHiRDBを使用する場合は，HiRDBをインストールして初期設定を済ませておいてください。詳細については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

ここでは，HiRDB Type4 JDBC Driverを使用して，HiRDBでJ2EEリソースを扱う場合に必要な次の設定について説明します。

HiRDB Type4 JDBC Driverの準備

HiRDBクライアント環境変数グループ設定ファイルの作成

タイムアウトの設定

(a)　HiRDB Type4 JDBC Driverの準備

ここでは，HiRDB Type4 JDBC Driverの準備について説明します。

HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）を用意します。pdjdbc2.jarは，次の製品に含まれています。

HiRDB/Parallel Server Version 8

HiRDB/Single Server Version 8

HiRDB/Run Time Version 8

HiRDB/Developer's Kit Version 8

これらの製品でのpdjdbc2.jarの格納場所は，マニュアル「HiRDB UAP開発ガイド」を参照してください。

簡易構築定義ファイルに，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）のパスを設定します。
簡易構築定義ファイルを作成するときに，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグに次の設定を追加してください。

<param-name>タグの指定値 | <param-value>タグの指定値
add.class.path | <pdjdbc2.jarのクラスパス>

簡易構築定義ファイルの作成については，「6.8　システムの構成定義」を参照してください。設定内容の詳細については，「13.7　簡易構築定義ファイル」，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」および「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

(b)　HiRDBクライアント環境変数グループ設定ファイルの作成

HiRDBクライアント環境変数グループを使用するには，HiRDBのクライアント環境変数グループの設定ファイルを作成します。この場合，DB Connectorのプロパティ定義内のHiRDBクライアント環境変数グループ名を指定する部分には，ここで作成した設定ファイルのパスを指定してください。設定ファイルの作成方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

なお，グローバルトランザクションを使用する場合には，必ずHiRDBクライアント環境変数グループを設定する必要があります。グローバルトランザクションを使用しない場合には，HiRDBクライアント環境変数グループの使用は任意です。

(c)　タイムアウトの設定

HiRDBのタイムアウトは，次に示すHiRDBのクライアント環境変数を，DB ConnectorのenvironmentVariablesプロパティまたはHiRDBのクライアント環境変数グループの設定ファイルに追加することで設定します。

PDSWAITTIME

PDCWAITTIME

なお，コネクション確立時のタイムアウトは，DB ConnectorのloginTimeoutプロパティに設定します。

DB Connectorのプロパティは，システム構築前，またはシステム構築後のリソースアダプタのデプロイ時に設定します。リソースアダプタのデプロイについては「6.11.2　リソースアダプタのインポートと開始」を参照してください。

また，タイムアウトの設定の詳細についてはマニュアル「Cosminexus　システム設計ガイド」のデータベースのタイムアウトに関する説明を参照してください。DB Connectorのプロパティの設定については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のDB Connectorのプロパティ定義に関する説明を参照してください。

(2)　Oracleの設定（Oracle JDBC Thin Driverの場合）

Oracle JDBC Thin Driverを使用してOracleに接続する場合の設定について説明します。なお，データベースとしてOracleを使用する場合は，Oracleをインストールして初期設定を済ませておいてください。詳細については，Oracleのマニュアルを参照してください。

ここでは，Oracle JDBC Thin Driverを使用して，OracleでJ2EEリソースを扱う場合に必要なデータベース側での設定と，J2EEサーバ側での設定について説明します。また，Oracleのタイムアウトの設定についても説明します。

(a)　データベース側での設定

ここでは，Oracle JDBC Thin Driverを使用する場合に，データベース側で必要な設定について説明します。詳細については，マニュアル「Cosminexus　システム設計ガイド」，およびOracleのマニュアルを参照してください。

Oracleへの接続でグローバルトランザクションを使用する場合には，Oracleの接続ユーザにトランザクションリカバリを行うための権限を付与する必要があります。

付与する権限

SYS.DBA_PENDING_TRANSACTIONSのSELECT権限

FORCE_ANY_TRANSACTION権限

SYS.DBMS_SYSTEMをEXECUTEする権限（Oracle JDBC Thin Driver 9.2.0.6，10.1.0.3.0以降を使用する場合）

権限の付与の方法

権限の付与の方法については，「付録K.2(2)　トランザクションリカバリを行うための権限の設定」を参照してください。

(b)　J2EEサーバ側での設定

ここでは，Oracle JDBC Thin Driverを使用する場合に，J2EEサーバ側で必要な設定について説明します。なお，Oracle JDBC Thin Driverを使用する場合，J2EEサーバに追加する環境変数はありません。

Cosminexusがサポートするバージョンの，Oracle JDBC Thin DriverのJARファイルを入手してください。Oracleクライアントのインストールディレクトリ下の「jdbc/lib/ojdbc14.jar」，および「jdbc/lib/ojdbc14_g.jar」が該当するJARファイルです。

このとき，Oracle JDBC Thin Driverのバージョンは，パッチレベル（パッチ番号）まで一致している必要があります。例えば，Oracle JDBC Thin Driverのバージョンが9.2.0.5の場合は，「9.2.0」がバージョン番号で，末尾の「5」がパッチ番号になります。

Oracle JDBC Thin Driverの入手方法の具体例としては，J2EEサーバを動作させるマシンにOracleクライアントをインストールする方法があります。Oracleクライアントのインストール手順の概略を次に示します。

J2EEサーバを動作させるマシンに，Cosminexusがサポートするバージョン番号のOracleクライアントをインストールします。
このとき，Oracle JDBC Thin Driverもインストールされます。

Cosminexusがサポートするパッチレベル（パッチ番号）のパッチを適用します。

簡易構築定義ファイルに，Oracle JDBC Thin DriverのJARファイル（ojdbc14.jar）のパスを指定します。
簡易構築定義ファイルを作成するときに，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグに次の設定を追加してください。

<param-name>タグの指定値 | <param-value>タグの指定値
add.class.path | <ojdbc14.jarのクラスパス>

設定内容の詳細については，「13.7　簡易構築定義ファイル」，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」および「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

J2EEサーバに，Oracle JDBC Thin Driver用のDB Connectorをインポートします。
DB Connectorのインポートについては，「6.11.2　リソースアダプタのインポートと開始」を参照してください。
Oracle JDBC Thin Driver用のDB Connectorは，2種類あります。トランザクションの管理方法によって，次のどちらかのファイルを選択してください。

DBConnector_Oracle_CP.rar

ローカルトランザクション，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。Oracle JDBC Thin DriverのConnectionPoolDataSourceを使用してデータベースに接続します。

DBConnector_Oracle_XA.rar

グローバルトランザクションを使用する場合（トランザクションのサポートレベルにXATransactionを指定する場合）に選択します。Oracle JDBC Thin DriverのXADataSourceを使用してデータベースに接続します。

トランザクションの管理方法の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

(c)　タイムアウトの設定

Oracleのサーバ定義のDISTRIBUTED_LOCK_TIMEOUTパラメタに設定します。

なお，このほか，XAOpenStringのSesTmパラメタの設定がタイムアウトに影響します。このパラメタは，チューニングできません。

詳細については，マニュアル「Cosminexus　システム設計ガイド」，およびOracleのマニュアルを参照してください。

(d)　動的パフォーマンスビューの参照権の設定

Oracleに接続するユーザは，動的パフォーマンスビューの参照権を持っている必要があります。次のどちらかの方法でOracleに接続するユーザに動的パフォーマンスビューの参照権を設定してください。

「GRANT SELECT_CATALOG_ROLE TO <ユーザ名>;」を実行する。

「GRANT SELECT ON V_$INSTANCE TO <ユーザ名>;」，「GRANT SELECT ON V_$PROCESS TO <ユーザ名>;」，および「GRANT SELECT ON V_$SESSION TO <ユーザ名>;」を実行する。

6.5.3　運用管理エージェントの設定

＜この項の構成＞

(1)　運用管理エージェントの起動

(2)　運用管理エージェントの自動起動の設定

(1)　運用管理エージェントの起動

アプリケーションサーバ１およびアプリケーションサーバ2で，それぞれadminagentctlコマンドを使用して，運用管理エージェントを起動します。起動方法を次に示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

UNIXの場合

# /opt/Cosminexus/manager/bin/adminagentctl start

(2)　運用管理エージェントの自動起動の設定

運用管理エージェントを自動起動するための設定をします。設定方法を，OSごとに示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun agent

AIXの場合

mkitabコマンドを使用して，運用管理エージェントの起動スクリプト（/opt/Cosminexus/manager/bin/adminagentctl start）を，/etc/inittabファイルに登録します。なお，mkitabコマンドの詳細については，AIXのドキュメントを参照してください。

# mkitab "adminagentctl:2:once:/opt/Cosminexus/manager/bin/adminagentctl start > /dev/console # Cosminexus Management Server - Administration Agent Start"

HP-UXの場合

/sbin/rc<N>.dディレクトリに，/sbin/init.d/MngSvrおよび/sbin/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /sbin/init.d/MngSvr /sbin/rc2.d/S900MngSvr
# chmod 755 /sbin/rc2.d/S900MngSvr
# ln -s /sbin/init.d/AdminAgent /sbin/rc2.d/S800AdminAgent
# chmod 755 /sbin/rc2.d/S800AdminAgent

Linuxの場合

/etc/rc.d/rc<N>.dディレクトリに，/etc/rc.d/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/rc.d/init.d/AdminAgent /etc/rc.d/rc2.d/S80AdminAgent
# chmod 755 /etc/rc.d/rc2.d/S80AdminAgent

Solarisの場合

/etc/rc<N>.dディレクトリに，/etc/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/init.d/AdminAgent /etc/rc2.d/S80AdminAgent
# chmod 755 /etc/rc2.d/S80AdminAgent

6.6　運用管理サーバの設定

運用管理サーバでは，次の設定をします。

環境変数の設定

Management Serverの設定

負荷分散機への接続の設定※

注※

Cosminexusから負荷分散機を制御する場合は，負荷分散機への接続設定が必要になります。詳細については，「6.7　Cosminexusから負荷分散機を制御するための設定」を参照してください。

また，JP1/Cm2/NCを使用して負荷分散機を制御する場合は，JP1/Cm2/NCの各設定および負荷分散機への接続設定が必要になります。詳細については，「付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定」を参照してください。

参考

JP1/SC/DPMを利用して，ホスト単位管理モデルのシステムを構築する場合は，Management Serverが稼働する各サーバマシンで設定します。

それぞれの設定の詳細について説明します。

＜この節の構成＞

6.6.1　環境変数の設定

6.6.2　Management Serverの設定

6.6.1　環境変数の設定

運用管理サーバでは，次の表に示す環境変数を設定します。なお，Windowsで，システム環境変数を設定した場合は，OSを再起動する必要があります。

表6-6　運用管理サーバに設定する環境変数と設定値（Windowsの場合）

環境変数名
設定値
備考

PATH

<Cosminexusのインストールディレクトリ>¥jdk¥bin

<Cosminexusのインストールディレクトリ>¥TPB¥bin

<Cosminexusのインストールディレクトリ>¥PRF¥bin

<ProgramFiles>¥Common Files¥Hitachi※1

<sshコマンドを格納したパス>※2

－

TPDIR
<Cosminexusのインストールディレクトリ>¥TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
<Cosminexusのインストールディレクトリ>¥TPB¥adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
<Cosminexusのインストールディレクトリ>¥PRF¥spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

注※1

<ProgramFiles>¥Common Files¥Hitachiは，デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

注※2

負荷分散機にBIG-IP 1500を使用する場合に設定してください。

表6-7　運用管理サーバに設定する環境変数と設定値（UNIXの場合）

環境変数名
設定値
備考

LIBPATH
（AIXの場合）

/opt/Cosminexus/TPB/lib

/opt/Cosminexus/PRF/lib

/opt/hitachi/common/lib

－

LD_LIBRARY_PATH
（HP-UX，Linuxの場合，またはSolarisの場合）

CSCCFJ_SERVER_HOME
/opt/Cosminexus/CC
Cosminexus Component Containerのインストールディレクトリを設定します。

PATH

/opt/Cosminexus/jdk/bin

/opt/Cosminexus/TPB/bin

/opt/Cosminexus/PRF/bin

/bin

<sshコマンドを格納したパス>※

－

TPDIR
/opt/Cosminexus/TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
/opt/Cosminexus/TPB/adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
/opt/Cosminexus/PRF/spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

注※

負荷分散機にBIG-IP 1500を使用する場合に設定してください。

AIXの場合は，表6-7に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。AIX固有の環境変数については，「6.5.1　環境変数の設定」を参照してください。

6.6.2　Management Serverの設定

Management Serverを使用するための設定について説明します。

＜この項の構成＞

(1)　Management Serverのセットアップ

(2)　Management Serverの起動

(3)　Management Serverの自動起動の設定

(4)　cmxserver.properties（サーバ設定プロパティファイル）の編集

(1)　Management Serverのセットアップ

mngsvrctlコマンドに引数「setup」を指定して実行して，Management Serverのセットアップをします。Management Serverのセットアップ時に，管理ユーザアカウントおよび管理ユーザパスワードを設定できます。セットアップ時に使用する，mngsvrctlコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

ユーザID（cosmi_admin），パスワード（cosmi_admin_passwd）を設定して，Management Serverを起動する場合の例を，OSごとに示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl setup -u cosmi_admin -p cosmi_admin_passwd

UNIXの場合

# /opt/Cosminexus/manager/bin/mngsvrctl setup -u cosmi_admin -p cosmi_admin_passwd

(2)　Management Serverの起動

mngsvrctlコマンドに，引数「start」を指定してManagement Serverを起動します。起動方法を次に示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl start

UNIXの場合

# /opt/Cosminexus/manager/bin/mngsvrctl start

(3)　Management Serverの自動起動の設定

Management Serverを自動起動するための設定をします。OSごとの設定方法を，次に示します。

Windowsの場合

mngautorunコマンドで，引数「server」を指定して実行します。

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun server

AIXの場合

mkitabコマンドを使用して，Management Serverの起動スクリプト（/opt/Cosminexus/manager/bin/mngsvrctl start）を，/etc/inittabファイルに登録します。なお，mkitabコマンドの詳細については，AIXのドキュメントを参照してください。

# mkitab "mngsvrctl:2:once:/opt/Cosminexus/manager/bin/mngsvrctl start > /dev/console
# Cosminexus Management Server Start"

HP-UXの場合

/sbin/rc<N>.dディレクトリに，/sbin/init.d/MngSvrへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /sbin/init.d/MngSvr /sbin/rc2.d/S900MngSvr
# chmod 755 /sbin/rc2.d/S900MngSvr

Linuxの場合

/etc/rc.d/rc<N>.dディレクトリに，/etc/rc.d/init.d/MngSvrへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/rc.d/init.d/MngSvr /etc/rc.d/rc2.d/S90MngSvr
# chmod 755 /etc/rc.d/rc2.d/S90MngSvr

Solarisの場合

/etc/rc<N>.dディレクトリに /etc/init.d/MngSvrへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/init.d/MngSvr /etc/rc2.d/S90MngSvr
# chmod 755 /etc/rc2.d/S90MngSvr

(4)　cmxserver.properties（サーバ設定プロパティファイル）の編集

Smart Composer機能で使用するコマンドの実行環境を，必要に応じて設定します。

cmx.max_wait_time
共通オプション-waitを指定して実行したコマンドに有効で，すでに実行しているコマンドの完了を待つときの最大待ち時間を指定します。デフォルトで，180秒が設定されています。

なお，cmxserver.propertiesファイルの詳細については，「13.3　cmxserver.properties（サーバ設定プロパティファイル）」を参照してください。

6.7　Cosminexusから負荷分散機を制御するための設定

sshコマンドを使用，またはTelnetを直接使用してCosminexusから負荷分散機を制御する場合は，負荷分散機への接続の設定をする必要があります。ここでは，負荷分散機への接続設定について説明します。なお，ssh接続を利用できる負荷分散機は，BIG-IP 1500です。Telnet接続を利用できる負荷分散機は，BIG-IP 1000およびLoadflowbalです。

＜この節の構成＞

6.7.1　ssh接続を利用する負荷分散機への接続の設定

6.7.2　Telnet接続を利用する負荷分散機への接続の設定

6.7.1　ssh接続を利用する負荷分散機への接続の設定

lb.propertiesファイル（負荷分散機定義プロパティファイル）に，負荷分散機へのアクセスに必要な接続情報を設定します。

lb.propertiesファイルは，次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

次のキーを設定します。

lb.list
負荷分散機の管理IPアドレスを設定します。負荷分散機が複数ある場合はコンマで区切って指定します。

lb.connect_type.<負荷分散機の管理IPアドレス>
負荷分散機への接続方式を設定します。「ssh」を設定してください。

lb.ssh.port.<負荷分散機の管理IPアドレス>
負荷分散機のsshサーバのポート番号を設定します。

lb.ssh.user.<負荷分散機の管理IPアドレス>
負荷分散機にsshで接続するときのユーザ名を設定します。

lb.ssh.passwd.<負荷分散機の管理IPアドレス>
負荷分散機にsshで接続するときのパスワードを設定します。

lb.ssh.timeout.<負荷分散機の管理IPアドレス>
負荷分散機へのsshコマンド実行（接続処理）時のタイムアウト時間（秒）を設定します。

なお，設定するキーの詳細については，「13.6　lb.properties（負荷分散機定義プロパティファイル）」を参照してください。

lb.propertiesファイルの設定例を，次に示します。

lb.list=192.168.100.10

lb.connect_type.192.168.100.10=ssh
#lb.ssh.port.192.168.100.10=22
lb.ssh.user.192.168.100.10=user01
lb.ssh.passwd.192.168.100.10=user01pw
#lb.ssh.timeout.192.168.100.10=10

注意

lb.propertiesファイルには，負荷分散機の接続ユーザ名，および接続ユーザのパスワードを記述するため，これらの情報が漏洩しないように適切にファイルのアクセス権を設定してください。

6.7.2　Telnet接続を利用する負荷分散機への接続の設定

lb.propertiesファイル（負荷分散機定義プロパティファイル）に，負荷分散機へのアクセスに必要な接続情報を設定します。

lb.propertiesファイルは，次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

次のキーを設定します。

lb.list
負荷分散機の管理IPアドレスを設定します。負荷分散機が複数ある場合はコンマで区切って指定します。

lb.enable_passwd.<負荷分散機の管理IPアドレス>
負荷分散機に設定したPrivileged EXECレベルに必要なパスワードを設定します。
このキーの設定は，負荷分散機がLoadflowbalの場合だけ設定します。BIG-IP 1000の場合は，設定しても無効になります。

lb.connect_type.<負荷分散機の管理IPアドレス>
負荷分散機への接続方式を設定します。「telnet」を設定してください。

lb.telnet.port.<負荷分散機の管理IPアドレス>
負荷分散機のTelnetサーバのポート番号を設定します。

lb.telnet.user.<負荷分散機の管理IPアドレス>
負荷分散機にTelnetでログインするときのユーザ名を設定します。

lb.telnet.passwd.<負荷分散機の管理IPアドレス>
負荷分散機にTelnetでログインするときのパスワードを設定します。

lb.telnet.user_prompt.<負荷分散機の管理IPアドレス>※
負荷分散機への接続時の，ユーザ名入力プロンプトに表示される文字列を設定します。

lb.telnet.passwd_prompt.<負荷分散機の管理IPアドレス>※
負荷分散機への接続時の，パスワード入力プロンプトに表示される文字列を設定します。

lb.telnet.login_prompt.<負荷分散機の管理IPアドレス>※
負荷分散機への接続時の，ログイン完了後プロンプトに表示される文字列を設定します。

lb.telnet.login_timeout.<負荷分散機の管理IPアドレス>
負荷分散機へのログイン処理時のタイムアウト時間（秒）を設定します。

lb.telnet.command_timeout.<負荷分散機の管理IPアドレス>
負荷分散機へのコマンド送信時のタイムアウト時間（秒）を設定します。

注※

実際に接続する負荷分散機にTelnetを使用してログインして，あらかじめ，設定する内容を確認しておいてください。

なお，設定するキーの詳細については，「13.6　lb.properties（負荷分散機定義プロパティファイル）」を参照してください。

lb.propertiesファイルの設定例を，次に示します。

lb.list=192.168.1.100
lb.enable_passwd.192.168.1.100=ServerIron

lb.connect_type.192.168.1.100=telnet
lb.telnet.port.192.168.1.100=23
lb.telnet.user.192.168.1.100=user01
lb.telnet.passwd.192.168.1.100=user01
lb.telnet.user_prompt.192.168.1.100="Please Enter Login Name: "
lb.telnet.passwd_prompt.192.168.1.100="Please Enter Password: "
lb.telnet.login_prompt.192.168.1.100=>
lb.telnet.login_timeout.192.168.1.100=10
lb.telnet.command_timeout.192.168.1.100=10

注意

lb.propertiesファイルには，LoadflowbalのPrivileged EXECレベルパスワード，負荷分散機の接続ユーザ名，および接続ユーザのパスワードを記述するため，これらの情報が漏洩しないように適切にファイルのアクセス権を設定してください。

6.8　システムの構成定義

ここでは，簡易構築定義ファイルの作成について説明します。テンプレートファイルが提供されているので，Webシステムの基本的な構成情報を編集するだけで作成できます。

「6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例」のシステム構成を定義する場合を，ファイル作成例を使用して説明します。

なお，簡易構築定義ファイルで機能を設定したい場合は，マニュアル「Cosminexus　システム構築ガイド」を参照してください。機能の詳細についてはマニュアル「Cosminexus　機能解説」を参照してください。

参考

Smart Composer機能では，一つのサービスユニットでのリクエストの最大同時処理数に関連のあるパラメタを，抽象パラメタを使って一括で設定できます。設定できるパラメタは，Webサーバのリクエスト実行キューや同時実行スレッド数，J2EEサーバのバックログ，スレッドプールなどです。また，コネクションプールに設定する値を決定できます。抽象パラメタの詳細については，「付録B　抽象パラメタ」を参照してください。

＜この節の構成＞

6.8.1　簡易構築定義ファイルの設定内容

6.8.2　テンプレートファイル

6.8.3　簡易構築定義ファイルの作成例

6.8.1　簡易構築定義ファイルの設定内容

簡易構築定義ファイルでは，Webシステムの次の構成について設定します。

Webシステムの属性定義（<web-system>タグの定義）

負荷分散機の定義（<load-balancer>タグの定義）※1

cookieスイッチングの定義（<load-balancer>タグの<cookie-switching>タグの定義）※2

仮想サーバの定義（<load-balancer>タグの<virtual-server>タグの定義）

物理ティアの定義（<tier>タグの定義）

物理ティアに属する論理サーバの種類ごとの定義（<tier>タグの<configuration>タグの定義）

データベースを使用するための設定の定義（<tier>タグの<configuration>タグの定義）※3

サービスユニットの定義（<unit>タグの定義）

サービスユニットを構成するホストの定義（<unit>タグの<allocation-host>タグの定義）

ホストが属する物理ティアの論理サーバごとの定義（<unit>タグの<allocation-host>タグの<define-server>タグの定義）

ホストの定義（<host>タグの定義）

注※1

Smart Composer機能で負荷分散機の設定，および実サーバポートの開始・閉塞をしない場合は，負荷分散機の定義（<load-balancer>タグの定義）を記述する必要はありません。

注※2

負荷分散機のCookieスイッチング機能を使用する場合に必要です。この設定によって，一連のHTTPリクエストが一つのWebサーバまたはJ2EEサーバで処理されます。また，負荷分散機のCookieスイッチング機能を使用する場合は，物理ティアの定義（<tier>タグ）で，J2EEサーバのWebコンテナの設定に「webserver.container.server_id.enabled=true」を指定してください。

注※3

データベースを使用するための設定の定義については，「6.5.2　データベースを使用するための設定」を参照してください。

物理ティアおよびサービスユニットのコンフィグレーション定義で，同じパラメタを指定した場合は，サービスユニットの定義，物理ティアの定義の順に優先して適用されます。

なお，設定内容の詳細については，「13.7　簡易構築定義ファイル」，および「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

注意

JP1/SC/DPMを利用してシステムを構築する場合は，簡易構築定義ファイルの物理ティアの定義で，WebサーバおよびJ2EEサーバのコンフィグレーション（<configuration>タグ）の設定が必要になります。JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタを次の表に示します。

表6-8　JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタ

論理サーバの種類（<tier>タグ配下の<logical-server-type>タグの指定値） | <param-name>タグの指定値 | <param-value>タグの指定値
web-server | realservername | 実サーバ名
Listen.host.value※ | true
j2ee-server | realservername | 実サーバ名
webserver.connector.http.bind_host.value※ | true
webserver.connector.ajp13.bind_host.value※ | true
manager.mevent.sender.bind.host.value※ | true
vbroker.se.iiop_tp.host.value※ | true
mngagent.connector.host.value※ | true

注※

Management Serverが稼働するホスト（サーバマシン）が，複数個のIPアドレスを持っている構成の場合に設定が必要です。

6.8.2　テンプレートファイル

簡易構築定義ファイルのテンプレートファイル（cmxdefcombinedmodel.xml）は，次の場所に提供されています。テンプレートファイルを任意の場所にコピーして，簡易構築定義ファイルを作成してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合

/opt/Cosminexus/manager/config/templates/

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。

6.8.3　簡易構築定義ファイルの作成例

テンプレートファイルをコピーし，名称を変更して，任意の場所に格納します。

なお，ここでは，ファイル名を「MyWebSystemDef.xml」に変更して，次の図に示す構成を定義しています。

図6-6　簡易構築定義ファイルの作成例で使用している構成情報

簡易構築定義ファイル（MyWebSystemDef.xml）の作成例を次に示します。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     <name>MyBIGIPv9</name>
     <load-balancer-type>BIG-IPv9</load-balancer-type>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <cookie-switching-enabled>true</cookie-switching-enabled>
       <cookie-name>CMX_SERVER_ID</cookie-name>
       <server-id-rule>1024-2048</server-id-rule>
     </cookie-switching>
     <management-host>192.168.100.10</management-host>
     <!-- 仮想サーバの定義 -->
     <virtual-server>
       <virtual-server-name>www.sample.com</virtual-server-name>
       <ip-address>192.168.1.10</ip-address>
       <http-port>80</http-port>
     </virtual-server>
   </load-balancer>
   <!-- 物理ティアの定義 -->
   <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>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>apsv2</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
 <host>
   <host-name>apsv2</host-name>
   <agent-host>192.168.100.12</agent-host>
 </host>
</model-definition>

注　太字の部分が編集部分です。

6.9　DB ConnectorのConnector属性ファイルの編集

DB Connectorを使用する場合，システムを起動する前にConnector属性ファイルを編集できます。

DB Connector以外のリソースアダプタを使用する場合は，システムを起動する前にConnector属性ファイルを編集できません。DB Connector以外のリソースアダプタを使用する場合のConnector属性ファイルの取得と編集については，「6.11.2(2)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connector以外のリソースアダプタを使用する場合）」を参照してください。

ここでは，DBConnector_HiRDB_Type4_CP.rarを使用した場合の，DB ConnectorのConnector属性ファイルの取得，および編集手順を例に使用して説明します。DBConnector_HiRDB_Type4_CP.rar以外のRARファイルを使用する場合は，利用するDB ConnectorのRARファイルに読み替えてください。なお，提供されるRARファイルの種類や使い分けについては，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。

Connector属性ファイルの編集手順について次に示します。

Connector属性ファイルを取得します。
DB Connectorについては，CosminexusがConnector属性ファイルのテンプレートファイルを提供しています。次の場所からテンプレートファイルを取得してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates

UNIXの場合

/opt/Cosminexus/CC/admin/templates

DBConnector_HiRDB_Type4_CP.rarを使用する場合，DBConnector_HiRDB_Type4_CP_cfg.xmlを取得します。
Cosminexusが提供しているConnector属性ファイルのテンプレート，およびテンプレートファイルに関する注意事項については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Connector属性ファイルを編集します。
取得したConnector属性ファイルを任意の場所に保存します。ここでは，Connector属性ファイルを，MyDBConnectorAttr.xmlの名前で保存します。
保存したConnector属性ファイルについて，データベースへの接続の設定など必要な項目を編集してください。

Connector属性ファイルを編集したあとのDB Connectorのデプロイ手順については，「6.11.2(1)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connectorを使用する場合）」を参照してください。

6.10　システムの一括構築

システムの一括構築では，情報モデルの生成，その情報モデルを基にしたWebサーバおよびJ2EEサーバのセットアップ，および各論理サーバの環境設定を一つのコマンドで一括で実施します。

また，必要に応じて負荷分散機に仮想サーバや実サーバを作成します。

システムの一括構築手順を，次に示します。

運用管理サーバでcmx_build_systemコマンドを使用してシステムを一括構築します。cmx_build_systemコマンドの-fオプションには，簡易構築定義ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml

注意

Smart Composer機能では，負荷分散機の基本的な情報（仮想サーバや実サーバの定義，仮想サーバポートと実サーバポートとのバインドなど）だけ設定します。特定のネットワーク構成をサポートするためなどの設定はシステムの一括構築後，手動で設定してください。

Smart Composer機能が実行するBIG-IP 1500，BIG-IP 1000およびLoadflowbalのCLIコマンドについては，「付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド」を参照してください。

6.11　システムの一括起動

ここでは，システムの一括起動に必要な次に示す作業について説明します。

システムの一括起動（READY）

リソースアダプタのインポートと開始

J2EEアプリケーションのインポートと開始

サービスユニットの開始

＜この節の構成＞

6.11.1　システムの一括起動（READY）

6.11.2　リソースアダプタのインポートと開始

6.11.3　J2EEアプリケーションのインポートと開始

6.11.4　サービスユニットの開始

6.11.1　システムの一括起動（READY）

「6.10　システムの一括構築」で構築したシステムを，負荷分散機からのリクエストの振り分けを抑止した状態（準備状態）で一括起動します。

システムを準備状態で一括起動する手順を，次に示します。

システムを準備状態で開始します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを準備状態で起動します。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

cmx_list_statusコマンドを使用して，システム内のすべてのサービスユニットが準備状態（READY）であることを確認してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_list_status -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem
unit1,MyWebSystem,done,ready
unit2,MyWebSystem,done,ready

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_list_status -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem
unit1,MyWebSystem,done,ready
unit2,MyWebSystem,done,ready

cmx_start_targetコマンドおよびcmx_list_statusコマンドの-sオプションには，簡易構築定義ファイルMyWebSystemDef.xmlの<web-system>タグの<name>タグで指定したWebシステム名を指定します。

6.11.2　リソースアダプタのインポートと開始

DB Connectorを使用する場合と，ほかのリソースアダプタを使用する場合で，Connector属性ファイルの取得方法が異なります。それぞれの場合のリソースアダプタのインポートと開始について説明します。リソースアダプタのインポートと開始には，サーバ管理コマンドを使用します。サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。サーバ管理コマンドでのリソースアダプタの操作の詳細についてはマニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

また，Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始についても説明します。

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，すべてサービスユニット1を対象としています。サービスユニット2に対しても，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

J2EEサーバ名：cmx_MyWebSystem_unit2_J2EE_01

-nameserver指定値：corbaname::192.168.1.12:900

＜この項の構成＞

(1)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connectorを使用する場合）

(2)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connector以外のリソースアダプタを使用する場合）

(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始

(1)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connectorを使用する場合）

DB Connectorを使用する場合のリソースアダプタのインポートと開始について説明します。ここでは，次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表6-9　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | DBConnector_HiRDB_Type4_CP.rar※
表示名 | DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名 | MyDBConnectorAttr.xml

注※　HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしでHiRDBに接続する場合に使用するRARファイルです。

なお，「6.9　DB ConnectorのConnector属性ファイルの編集」でConnector属性ファイルの取得と編集が済んでいることを前提にしています。

DB Connectorを使用する場合のリソースアダプタのインポートと開始の手順を次に示します。

リソースアダプタをインポートします。
サーバ管理コマンドを使用して，リソースアダプタをJ2EEサーバへインポートします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f /opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar

リソースアダプタをデプロイします。
サーバ管理コマンドを使用して，J2EEサーバにリソースアダプタをデプロイします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

編集したConnector属性ファイルをリソースアダプタに反映します。
サーバ管理コマンドを使用して，Connector属性ファイルをリソースアダプタに反映します。-cオプションには，「6.9　DB ConnectorのConnector属性ファイルの編集」で編集したConnector属性ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

リソースアダプタの接続を確認します。
サーバ管理コマンドを使用して，リソースアダプタの接続を確認します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

リソースアダプタを開始します。
サーバ管理コマンドを使用して，リソースアダプタを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

(2)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connector以外のリソースアダプタを使用する場合）

DB Connector以外のリソースアダプタを使用する場合のリソースアダプタのインポートと開始について説明します。

ここでは，次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表6-10　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | MyResourceAdapter.rar
表示名 | MyResourceAdapter
Connector属性ファイルのファイル名 | MyResourceAdapter.xml

なお，提供されるRARファイルの種類や使い分けについては，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。

DB Connector以外のリソースアダプタを使用する場合のリソースアダプタのインポートと開始の手順を次に示します。

リソースアダプタをインポートします。
サーバ管理コマンドを使用して，リソースアダプタをJ2EEサーバへインポートします。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <任意のディレクトリ>¥MyResourceAdapter.rar

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <任意のディレクトリ>/MyResourceAdapter.rar

リソースアダプタをデプロイします。
サーバ管理コマンドを使用して，J2EEサーバにリソースアダプタをデプロイします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

Connector属性ファイルを取得します。
サーバ管理コマンドを使用して，Connector属性ファイルを取得します。ここでは，Connector属性ファイルを，MyResourceAdapter.xmlの名前で出力します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>¥MyResourceAdapter.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900  -resname MyResourceAdapter -c <任意のディレクトリ>/MyResourceAdapter.xml

なお，Connector属性ファイルの取得方法については，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。また，Connector属性ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Connector属性ファイルを編集します。
取得したConnector属性ファイルで，データベースへの接続の設定など必要な項目を編集してください。

編集したConnector属性ファイルをリソースアダプタに反映します。
サーバ管理コマンドを使用して，Connector属性ファイルを各リソースアダプタに反映します。-cオプションには，手順4で編集したConnector属性ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>¥MyResourceAdapter.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>/MyResourceAdapter.xml

リソースアダプタの接続を確認します。
サーバ管理コマンドを使用して，リソースアダプタの接続を確認します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

リソースアダプタを開始します。
サーバ管理コマンドを使用して，リソースアダプタを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始

Smart Composer機能のコマンドを使うと，リソースアダプタの一括開始ができます。リソースアダプタの一括開始の手順を次に示します。各手順で使用するSmart Composer機能のコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

Connector属性ファイルを取得します。

Connector属性ファイルを編集します。

cmx_register_resourceコマンドを使って，リソースアダプタをManagement Serverに登録します。

cmx_define_resourceコマンドを使って，リソースアダプタをWebシステムへ関連づけます。

cmx_deploy_resourceコマンドを使って，リソースアダプタを一括デプロイします。

cmx_start_resourceコマンドを使って，リソースアダプタを一括開始します。

なお，手順1.～2.は，使用するリソースアダプタによって操作が異なります。それぞれの操作について次に示します。

DB Connectorを使用する場合
「6.9　DB ConnectorのConnector属性ファイルの編集」を参照してください。

DB Connector以外のリソースアダプタを使用する場合
「6.11.2(2)　サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connector以外のリソースアダプタを使用する場合）」の手順1.～4.の操作を参照してください。なお，サーバ管理コマンドでインポートしたリソースアダプタはcmx_register_resourceコマンドを使用する前に削除してください。

注意

リソースアダプタの種類によっては一括開始できない場合があります。一括開始できないリソースアダプタについては，「12.3　コマンドの詳細」の「cmx_start_resource」を参照してください。

6.11.3　J2EEアプリケーションのインポートと開始

J2EEアプリケーションのインポートと開始について説明します。J2EEアプリケーションのインポートと開始には，サーバ管理コマンドを使用します。サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」，サーバ管理コマンドでのリソースアダプタの操作の詳細についてはマニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

また，Smart Composer機能のコマンドを使用したJ2EEアプリケーションのインポートと一括開始についても説明します。

ここで説明するJ2EEアプリケーションは作成済みであることを前提としています。J2EEアプリケーションは，アプリケーション開発時に作成しておいてください。アプリケーションの作成については，マニュアル「Cosminexus　アプリケーション開発ガイド」を参照してください。

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，すべてサービスユニット1を対象としています。サービスユニット2に対しても，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

J2EEサーバ名：cmx_MyWebSystem_unit2_J2EE_01

-nameserver指定値：corbaname::192.168.1.12:900

＜この項の構成＞

(1)　サーバ管理コマンドを使用したJ2EEアプリケーションのインポートと開始

(2)　Smart Composer機能のコマンドを使用したJ2EEアプリケーションのインポートと一括開始

(1)　サーバ管理コマンドを使用したJ2EEアプリケーションのインポートと開始

J2EEアプリケーションのインポートと開始の手順を次に示します。ここでは，次に示すJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表6-11　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

J2EEアプリケーションをインポートします。
サーバ管理コマンドを使用して，J2EEアプリケーションをJ2EEサーバへインポートします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp.ear

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp.ear

アプリケーション統合属性ファイルを取得します。
サーバ管理コマンドを使用して，アプリケーション統合属性ファイルを取得します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

アプリケーション統合属性ファイルを編集します。
手順2.で取得したアプリケーション統合属性ファイルを編集します。
J2EEアプリケーションのプロパティの設定の詳細については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の属性ファイルによるプロパティの設定についての説明，およびマニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションのプロパティ定義で設定できることについての説明を参照してください。J2EEアプリケーションのプロパティ定義で設定できる機能の詳細については，マニュアル「Cosminexus　機能解説」の各機能についての説明を参照してください。

編集したアプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。
サーバ管理コマンドを使用して，編集したアプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。-cオプションには，手順3.で編集したアプリケーション統合属性ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

J2EEアプリケーションを開始します。
サーバ管理コマンドを使用して，J2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

(2)　Smart Composer機能のコマンドを使用したJ2EEアプリケーションのインポートと一括開始

Smart Composer機能のコマンドを使うと，J2EEアプリケーションのインポートと開始が一括で実行できます。J2EEアプリケーションのインポートと一括開始の手順を次に示します。各手順で使用するSmart Composer機能のコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

cmx_register_applicationコマンドを使用して，J2EEアプリケーションをManagement Serverに登録します。

cmx_define_applicationコマンドを使用して，Management Serverへ登録したJ2EEアプリケーションをWebシステムに関連づけます。

cmx_deploy_applicationコマンドを使用して，Webシステムへ関連づけたJ2EEアプリケーションをシステムに一括デプロイします。

cmx_start_applicationコマンドを使用して，J2EEアプリケーションを一括開始します。

6.11.4　サービスユニットの開始

cmx_start_targetコマンドを使用して，Webシステム内のすべてのサービスユニットを稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

cmx_start_targetコマンドの-sオプションには，簡易構築定義ファイルMyWebSystemDef.xmlの<web-system>タグの<name>タグで指定したWebシステム名を指定します。

6.12　チューニング

チューニングでは，システムのパフォーマンスを生かす最適の設定を見つける作業（パフォーマンスチューニング）を実施します。構築した環境で，実際にJ2EEアプリケーションに負荷を掛けながら，スループット，レスポンス時間，CPU時間などの性能メトリックの相関が適切かどうか多角的に検証し，パラメタの調整やボトルネックの調査，解消によってパフォーマンスを向上させていきます。パフォーマンスチューニングの詳細については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。

ここでは，簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの手順，およびリソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニングの手順について説明します。

なお，パラメタを変更するとシステムが動作するために必要なリソースも変更する必要があります。システムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この節の構成＞

6.12.1　簡易構築定義ファイルのパラメタだけを編集する場合のチューニング

6.12.2　リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニング

6.12.1　簡易構築定義ファイルのパラメタだけを編集する場合のチューニング

簡易構築定義ファイルのパラメタだけを編集する場合のチューニングについて説明します。簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの流れを次の図に示します。

図6-7　簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの流れ

＜この項の構成＞

(1)　パラメタの編集

(2)　システムの設定変更

(1)　パラメタの編集

簡易構築定義ファイル（MyWebSystemDef.xml）のパラメタの値を編集して，チューニングを実施します。チューニングできる項目，およびパフォーマンスチューニングの詳細については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。

(2)　システムの設定変更

cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデルを変更します。変更した情報モデルを実システムに適用します。

システムの設定変更の手順を，次に示します。

システムが稼働している場合は，システムを停止します。
cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

システムの情報モデルを変更して実システムに展開します。
cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデルを変更し，変更した情報モデルからシステムを構築します。-fオプションには，パフォーマンスチューニングを実施した簡易構築定義ファイルを指定します。-fオプションで指定したファイルの内容をシステムに反映するには，-changeオプションを指定します。cmx_build_systemコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

構成を変更したシステムを開始します。

cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

6.12.2　リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニング

リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニングの手順について説明します。リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニングの流れを次の図に示します。

図6-8　リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニングの流れ

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，すべてサービスユニット1を対象としています。サービスユニット2に対しても，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

J2EEサーバ名：cmx_MyWebSystem_unit2_J2EE_01

-nameserver指定値：corbaname::192.168.1.12:900

＜この項の構成＞

(1)　パラメタの編集

(2)　システム，リソースアダプタおよびJ2EEアプリケーションの設定変更

(1)　パラメタの編集

簡易構築定義ファイル（MyWebSystemDef.xml）のパラメタの値を編集して，チューニングを実施します。チューニングできる項目，およびパフォーマンスチューニングの詳細については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。

(2)　システム，リソースアダプタおよびJ2EEアプリケーションの設定変更

cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデル，リソースアダプタの設定およびJ2EEアプリケーションの設定を変更します。変更した情報モデルを実システムに適用します。

システムが稼働している場合は，システム内のサービスユニットを閉塞します。
cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを閉塞状態にして，サービスユニットを負荷分散機から切り離します。閉塞状態にするには，-modeオプションに「HOLD」を指定します。
なお，システムが停止している場合は手順1.から手順3.までの操作は不要です。システムが停止している場合は手順4.から実施してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode HOLD

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode HOLD

J2EEアプリケーションおよびリソースアダプタを停止します。

サーバ管理コマンドを使用して，J2EEアプリケーションを停止します。

サーバ管理コマンドを使用して，リソースアダプタを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

# /opt/Cosminexus/CC/admin/bin/cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

手順2.をサービスユニット1およびサービスユニット2で実施したあとで，システムを停止します。
cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

システムの情報モデルを変更して実システムに展開します。
cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデルを変更し，変更した情報モデルからシステムを構築します。-fオプションには，パフォーマンスチューニングを実施した簡易構築定義ファイルを指定します。-fオプションで指定したファイルの内容をシステムに反映するには，-changeオプションを指定します。cmx_build_systemコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

構成を変更したシステムを負荷分散機からのリクエストの振り分けを抑止した状態で一括起動します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを準備状態にします。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

リソースアダプタのプロパティを変更します。
ここでは，サーバ管理コマンドを使用して，次の作業を実施しています。

Connector属性ファイルを取得します。
取得したConnector属性ファイルは必要に応じて編集します。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタを開始します。

Connector属性ファイルの詳細についてはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

J2EEアプリケーションのプロパティを変更します。
ここでは，サーバ管理コマンドを使用して，次の作業を実施しています。

アプリケーション統合属性ファイルを取得します。
取得したアプリケーション統合属性ファイルは必要に応じて編集します。

アプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。

J2EEアプリケーションを開始します。

アプリケーション統合属性ファイルの詳細についてはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

手順5.から手順6.までをサービスユニット1およびサービスユニット2で実施したあとで，システムを開始します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

6.13　インプロセスHTTPサーバ機能を使用する場合に必要な設定

ここでは，インプロセスHTTPサーバ機能を使用するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

インプロセスHTTPサーバ機能を使用するシステムを一括構築する場合の流れについて，次の図に示します。

図6-9　インプロセスHTTPサーバ機能を使用するシステムを一括構築する場合の流れ

インプロセスHTTPサーバ機能を使用する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.13.1　簡易構築定義ファイルの作成

6.13.1　簡易構築定義ファイルの作成

インプロセスHTTPサーバ機能を使用するシステムを構築する場合は，簡易構築定義ファイルの物理ティアの定義で，インプロセスHTTPサーバ機能を使用するための設定を有効にする必要があります。インプロセスHTTPサーバ機能を使用するシステムを構築する場合は，簡易構築定義ファイルの次に示す定義が異なります。

物理ティアの定義
j2ee-tierを定義します。また，j2ee-tierで，インプロセスHTTPサーバ機能を使用するための設定を定義します。

サービスユニットの定義
インプロセスHTTPサーバ機能を使用するJ2EEサーバ用のサービスユニットを定義します。インプロセスHTTPサーバが使用するポート番号を定義します。

「6.8　システムの構成定義」で示す構成情報を基に，インプロセスHTTPサーバ機能を使用する場合の構成情報を，次の図に示します。

図6-10　インプロセスHTTPサーバ機能を使用する場合の構成情報

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，インプロセスHTTPサーバ機能を使用する場合に差異のある定義について説明します。簡易構築定義ファイル（MyWebSystemDef.xml）ファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>j2ee-tier</tier-type>
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
          <param-name>webserver.connector.inprocess_http.enabled</param-name>
          <param-value>true</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>j2ee-tier</hosts-for>
       <define-server>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration>
           <param>
             <param-name>webserver.connector.inprocess_http.port</param-name>
             <param-value>8091</param-value>
           </param>
              ：
         </configuration>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
</model-definition>

注1　太字の部分が設定の異なる部分です。

注　インプロセスHTTPサーバ機能を使用する構成では，負荷分散機が使用できないため，負荷分散機の定義は削除します。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

6.14　負荷分散機を冗長化する場合に必要な設定

ここでは，combined-tier構成で，負荷分散機を冗長化するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

なお，http-tierとj2ee-tierを組み合わせた構成で，負荷分散機を冗長化するシステムを一括構築する場合も，ここで説明している設定が必要です。

負荷分散機を冗長化するシステムを一括構築する場合の流れを，次の図に示します。

図6-11　負荷分散機を冗長化するシステムを一括構築する場合の流れ

負荷分散機を冗長化する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.14.1　Cosminexusから負荷分散機を制御するための設定

6.14.2　簡易構築定義ファイルの作成

6.14.1　Cosminexusから負荷分散機を制御するための設定

Cosminexusから冗長化構成の負荷分散機を制御する場合，それぞれの負荷分散機への接続の設定をする必要があります。

lb.propertiesファイル（負荷分散機定義プロパティファイル）に，2台分の負荷分散機へのアクセスに必要な接続情報を設定します。

BIG-IP 1500の場合の，lb.propertiesファイルの設定例を次に示します。ここでは，負荷分散機LB1とLB2を配置した場合で，LB1の管理IPアドレスを「192.168.100.10」，LB2の管理IPアドレスを「192.168.100.20」として説明します。

lb.list=192.168.100.10,192.168.100.20

#冗長化構成の負荷分散機LB1の設定
lb.connect_type.192.168.100.10=ssh※
#lb.ssh.port.192.168.100.10=22
lb.ssh.user.192.168.100.10=user01
lb.ssh.passwd.192.168.100.10=user01pw
#lb.ssh.timeout.192.168.100.10=10

#冗長化構成の負荷分散機LB2の設定
lb.connect_type.192.168.100.20=ssh※
#lb.ssh.port.192.168.100.20=22
lb.ssh.user.192.168.100.20=user01
lb.ssh.passwd.192.168.100.20=user01pw
#lb.ssh.timeout.192.168.100.20=10

注※

冗長化構成の負荷分散機の場合，接続方式（lb.connect_type）は同じ値にしてください。

なお，設定するキーの詳細については，「13.6　lb.properties（負荷分散機定義プロパティファイル）」を参照してください。

6.14.2　簡易構築定義ファイルの作成

負荷分散機を冗長化するシステムを構築する場合は，簡易構築定義ファイルの負荷分散機の定義に，負荷分散機2台分（実行系および待機系）の管理IPアドレスを設定する必要があります。

「6.8　システムの構成定義」で示す構成情報を基に，負荷分散機を冗長化した場合の構成情報を，次の図に示します。なお，ここでは，実行系の負荷分散機を負荷分散機1，待機系の負荷分散機を負荷分散機2として配置している場合を例に説明しています。

図6-12　負荷分散機を冗長化した場合の構成情報

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，負荷分散機を冗長化した場合に差異のある定義について説明します。MyWebSystemDef.xmlファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     <name>MyBIGIPv9</name>
     <load-balancer-type>BIG-IPv9</load-balancer-type>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <cookie-switching-enabled>true</cookie-switching-enabled>
       <cookie-name>CMX_SERVER_ID</cookie-name>
       <server-id-rule>1024-2048</server-id-rule>
     </cookie-switching>
     <management-host>192.168.100.10</management-host>
     <redundant-management-host>192.168.100.20</redundant-management-host>
     <!-- 仮想サーバの定義 -->
     <virtual-server>
       <virtual-server-name>www.sample.com</virtual-server-name>
       <ip-address>192.168.1.10</ip-address>
       <http-port>80</http-port>
     </virtual-server>
   </load-balancer>
      :
</model-definition>

注　太字の部分が設定の異なる部分です。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

参考

冗長化した負荷分散機を複数のWebシステムで共有する場合は，各Webシステムの負荷分散機の定義で，<management-host>タグおよび<redundant-management-host>タグに同じIPアドレスを設定してください。

6.15　セッションフェイルオーバ機能を使用する場合に必要な設定

ここでは，combined-tier構成で，セッションフェイルオーバ機能を使用するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

なお，http-tierとj2ee-tierを組み合わせた構成で，セッションフェイルオーバ機能を使用するシステムを一括構築する場合も，ここで説明している設定が必要です。

セッションフェイルオーバ機能を使用するシステムを一括構築する場合の流れを，次の図に示します。

図6-13　セッションフェイルオーバ機能を使用するシステムを一括構築する場合の流れ

セッションフェイルオーバ機能を使用する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.15.1　インストール

6.15.2　ホスティング環境の設定

6.15.3　セッションフェイルオーバサーバの設定

6.15.4　簡易構築定義ファイルの作成

6.15.1　インストール

セッションフェイルオーバ機能を使用するシステムを構築する場合は，J2EEアプリケーションのセッション情報を引き継ぐために，セッションフェイルオーバサーバ（SFOサーバ）を用意する必要があります。セッションフェイルオーバサーバを配置するセッションフェイルオーバサーバマシンには，Application Serverをインストールする必要があります。

6.15.2　ホスティング環境の設定

Smart Composer機能によって構築されたシステムが動作するために，OSやデータベースなどのホスティング環境の設定が必要な場合があります。

セッションフェイルオーバ機能を使用するシステムが使用するリソースと設定の要否を，次の表に示します。なお，各リソースに必要な見積もりの詳細については，「5.1　使用リソースの見積もり」を参照してください。

表6-12　使用リソースの設定要否

分類 | リソース | Windowsの場合 | UNIXの場合
データベース | 最大同時接続数 | ○ | ○
サービスユニット※ | 共有メモリ | × | ○
プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○
セッションフェイルオーバサーバ | 共有メモリ | × | ○
プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○
運用管理サーバ | プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○

（凡例）

○：必要です。

×：不要です。

6.15.3　セッションフェイルオーバサーバの設定

セッションフェイルオーバサーバでは，次の設定をします。

環境変数の設定

運用管理エージェントの自動起動の設定

＜この項の構成＞

(1)　環境変数の設定

(2)　運用管理エージェントの自動起動の設定

(1)　環境変数の設定

セッションフェイルオーバサーバでは，次の表に示す環境変数を設定します。なお，Windowsで，システム環境変数を設定した場合は，OSを再起動する必要があります。

表6-13　セッションフェイルオーバサーバに設定する環境変数と設定値（Windowsの場合）

環境変数名
設定値
備考

PATH

<Cosminexusのインストールディレクトリ>¥jdk¥bin

<Cosminexusのインストールディレクトリ>¥TPB¥bin

<Cosminexusのインストールディレクトリ>¥PRF¥bin

<ProgramFiles>¥Common Files¥Hitachi※

－

TPDIR
<Cosminexusのインストールディレクトリ>¥TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
<Cosminexusのインストールディレクトリ>¥TPB¥adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
<Cosminexusのインストールディレクトリ>¥PRF¥spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

注※

<ProgramFiles>¥Common Files¥Hitachiは，デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

表6-14　セッションフェイルオーバサーバに設定する環境変数と設定値（UNIXの場合）

環境変数名
設定値
備考

LIBPATH
（AIXの場合）

/opt/Cosminexus/TPB/lib

/opt/Cosminexus/PRF/lib

/opt/hitachi/common/lib

－

LD_LIBRARY_PATH
（HP-UX，Linux，またはSolarisの場合）

CSCCFJ_SERVER_HOME
/opt/Cosminexus/CC
Cosminexus Component Containerのインストールディレクトリを設定します。

PATH

/opt/Cosminexus/jdk/bin

/opt/Cosminexus/TPB/bin

/opt/Cosminexus/PRF/bin

/bin

－

TPDIR
/opt/Cosminexus/TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
/opt/Cosminexus/TPB/adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
/opt/Cosminexus/PRF/spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

AIXの場合は，表6-14に示す環境変数とは別に，AIX固有の環境変数を設定する必要があります。AIX固有の環境変数については，「6.5.1　環境変数の設定」を参照してください。

(2)　運用管理エージェントの自動起動の設定

運用管理エージェントを自動起動するための設定をします。設定方法を，OSごとに示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun agent

AIXの場合

mkitabコマンドを使用して，運用管理エージェントの起動スクリプト（/opt/Cosminexus/manager/bin/adminagentctl start）を，/etc/inittabファイルに登録します。なお，mkitabコマンドの詳細については，AIXのドキュメントを参照してください。

# mkitab "adminagentctl:2:once:/opt/Cosminexus/manager/bin/adminagentctl start > /dev/console # Cosminexus Management Server - Administration Agent Start"

HP-UXの場合

/sbin/rc<N>.dディレクトリに，/sbin/init.d/MngSvrおよび/sbin/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /sbin/init.d/MngSvr /sbin/rc2.d/S900MngSvr
# chmod 755 /sbin/rc2.d/S900MngSvr
# ln -s /sbin/init.d/AdminAgent /sbin/rc2.d/S800AdminAgent
# chmod 755 /sbin/rc2.d/S800AdminAgent

Linuxの場合

/etc/rc.d/rc<N>.dディレクトリに，/etc/rc.d/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/rc.d/init.d/AdminAgent /etc/rc.d/rc2.d/S80AdminAgent
# chmod 755 /etc/rc.d/rc2.d/S80AdminAgent

Solarisの場合

/etc/rc<N>.dディレクトリに，/etc/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/init.d/AdminAgent /etc/rc2.d/S80AdminAgent
# chmod 755 /etc/rc2.d/S80AdminAgent

6.15.4　簡易構築定義ファイルの作成

セッションフェイルオーバ機能を使用するシステムを構築する場合は，簡易構築定義ファイルの次に示す定義が異なります。

物理ティアの定義
セッションフェイルオーバ用の物理ティア（sfo-tier）を定義します。sfo-tierでは，SFOサーバおよびパフォーマンストレーサのコンフィグレーションを設定できます。
また，業務サービス用の物理ティア（combined-tierまたはj2ee-tier）で，SFOサーバとJ2EEサーバとを関連づける設定，およびJ2EEサーバで使用するセッションフェイルオーバ用フィルタの設定を定義します。

サービスユニットの定義
セッションフェイルオーバ用のサービスユニットを定義します。J2EEサーバとの関係を定義するためのSFOサーバの論理サーバ名や，SFOサーバごとのコンフィグレーションを定義します。

ホストの定義
セッションフェイルオーバ用のサービスユニットを構成するホストを定義します。

「6.8　システムの構成定義」で示す構成情報を基に，セッションフェイルオーバ機能を使用した場合の構成情報を，次の図に示します。

図6-14　セッションフェイルオーバ機能を使用した場合の構成情報

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，セッションフェイルオーバ機能を使用した場合に差異のある定義について説明します。MyWebSystemDef.xmlファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     :
   <!-- 物理ティアの定義 -->
   <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>sfoserver1,sfoserver2</param-value>
       </param>
       <param>
          <param-name>webserver.sfo.sfo_server.sfoserver1.serverName</param-name>
          <param-value>sfo01</param-value>
       </param>
       <param>
          <param-name>webserver.sfo.sfo_server.sfoserver2.serverName</param-name>
          <param-value>sfo02</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>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     :
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>sfosv1</host-ref>
       <hosts-for>sfo-tier</hosts-for>
       <define-server>
         <logical-server-name>sfo01</logical-server-name>
         <logical-server-type>sfo-server</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
   <unit>
     <name>unit4</name>
     <allocated-host>
       <host-ref>sfosv2</host-ref>
       <hosts-for>sfo-tier</hosts-for>
       <define-server>
         <logical-server-name>sfo02</logical-server-name>
         <logical-server-type>sfo-server</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
 <host>
   :
 <host>
   <host-name>sfosv1</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>
 <host>
   <host-name>sfosv2</host-name>
   <agent-host>192.168.100.14</agent-host>
 </host>
</model-definition>

注　太字の部分が設定の異なる部分です。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

6.16　CTMを使用する場合に必要な設定

ここでは，CTMを使用するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

CTMを使用するシステムを一括構築する場合の流れを，次の図に示します。

図6-15　CTMを使用するシステムを一括構築する場合の流れ

CTMを使用する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.16.1　インストール

6.16.2　ホスティング環境の設定

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

6.16.4　統合ネーミングスケジューラサーバの設定

6.16.5　運用管理サーバの設定

6.16.6　簡易構築定義ファイルの作成

6.16.1　インストール

CTMを使用するシステムを構築する場合は，統合ネーミングスケジューラサーバと，アプリケーションサーバを用意する必要があります。統合ネーミングスケジューラサーバを配置する統合ネーミングスケジューラサーバマシン，およびアプリケーションサーバを配置するアプリケーションサーバマシンには，構成ソフトウェアに，Cosminexus Component Transaction Monitorが含まれている製品※をインストールする必要があります。

注※

構成ソフトウェアに，Cosminexus Component Transaction Monitorが含まれている製品については，マニュアル「Cosminexus　概説」を参照してください。

6.16.2　ホスティング環境の設定

Smart Composer機能によって構築されたシステムが動作するために，OSやデータベースなどのホスティング環境の設定が必要な場合があります。

CTMを使用するシステムが使用するリソースと設定の要否を，次の表に示します。なお，各リソースに必要な見積もりの詳細については，「5.1　使用リソースの見積もり」を参照してください。

表6-15　使用リソースの設定要否

分類 | リソース | Windowsの場合 | UNIXの場合
データベース | 最大同時接続数 | ○ | ○
ctm-tierのサービスユニット | 共有メモリ | × | ○
プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○
運用管理サーバ | プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○

（凡例）

○：必要です。

×：不要です。

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

アプリケーションサーバでは，次の設定をします。

環境変数の設定

Cosminexus DABroker Libraryの設定※

データベースの設定

運用管理エージェントの自動起動の設定

注※

Cosminexus DABroker Libraryを使用して，データベースに接続する場合に設定が必要になります。

ここでは，CTMを使用する場合に追加して設定する環境変数についてだけ説明します。環境変数以外の設定内容については，「6.5　アプリケーションサーバの設定」を参照してください。

＜この項の構成＞

(1)　環境変数の設定

(1)　環境変数の設定

アプリケーションサーバでは，CTMを使用する場合，次の表に示す環境変数の設定を追加します。なお，AIX固有の環境変数については「6.5.1　環境変数の設定」を参照してください。

表6-16　アプリケーションサーバに追加設定する環境変数と設定値（CTMを使用する場合（Windowsの場合））

環境変数名 | 設定値 | 備考
OSAGENT_PORT | 14000 | 必要に応じて，スマートが使用するポート番号を設定します。
CTMDIR | <Cosminexusのインストールディレクトリ>¥CTM | CTMのインストールディレクトリを設定します。
CTMSPOOL | %CTMDIR%¥spool | 必要に応じて，CTMの実行環境ディレクトリを設定します。

表6-17　アプリケーションサーバに追加設定する環境変数と設定値（CTMを使用する場合（UNIXの場合））

環境変数名
設定値
備考

LIBPATH
（AIXの場合）
/opt/Cosminexus/CTM/lib
－

LD_LIBRARY_PATH
（HP-UX，Linux，およびSolarisの場合）

OSAGENT_PORT
14000
必要に応じて，スマートエージェントが使用するポート番号を設定します。

CTMDIR
/opt/Cosminexus/CTM
CTMのインストールディレクトリを設定します。

CTMSPOOL
/opt/Cosminexus/CTM/spool
必要に応じて，CTMの実行環境ディレクトリを設定します。

6.16.4　統合ネーミングスケジューラサーバの設定

統合ネーミングスケジューラサーバでは，次の設定をします。

環境変数の設定

運用管理エージェントの自動起動の設定

＜この項の構成＞

(1)　環境変数の設定

(2)　運用管理エージェントの自動起動の設定

(1)　環境変数の設定

統合ネーミングスケジューラサーバでは，次の表に示す環境変数を設定します。AIX固有の環境変数については「6.5.1　環境変数の設定」を参照してください。なお，Windowsで，システム環境変数を設定した場合は，OSを再起動する必要があります。

表6-18　統合ネーミングスケジューラサーバに設定する環境変数と設定値（Windowsの場合）

環境変数名
設定値
備考

PATH

<Cosminexusのインストールディレクトリ>¥jdk¥bin

<Cosminexusのインストールディレクトリ>¥TPB¥bin

<Cosminexusのインストールディレクトリ>¥PRF¥bin

<ProgramFiles>¥Common Files¥Hitachi※

－

TPDIR
<Cosminexusのインストールディレクトリ>¥TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
<Cosminexusのインストールディレクトリ>¥TPB¥adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
<Cosminexusのインストールディレクトリ>¥PRF¥spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

OSAGENT_PORT
14000
必要に応じて，スマートエージェントが使用するポート番号を設定します。

CTMDIR
<Cosminexusのインストールディレクトリ>¥CTM
CTMのインストールディレクトリを設定します。

CTMSPOOL
%CTMDIR%¥spool
必要に応じて，CTMの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

注※

<ProgramFiles>¥Common Files¥Hitachiは，デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

表6-19　統合ネーミングスケジューラサーバに設定する環境変数と設定値（UNIXの場合）

環境変数名
設定値
備考

LIBPATH
（AIXの場合）

/opt/Cosminexus/TPB/lib

/opt/Cosminexus/PRF/lib

/opt/hitachi/common/lib

/opt/Cosminexus/CTM/lib

－

LD_LIBRARY_PATH
（HP-UX，Linux，およびSolarisの場合）

CSCCFJ_SERVER_HOME
/opt/Cosminexus/CC
Cosminexus Component Containerのインストールディレクトリを設定します。

PATH

/opt/Cosminexus/jdk/bin

/opt/Cosminexus/TPB/bin

/opt/Cosminexus/PRF/bin

/bin

－

TPDIR
/opt/Cosminexus/TPB
Cosminexus TPBrokerのインストールディレクトリを設定します。

VBROKER_ADM
/opt/Cosminexus/TPB/adm
ログ出力先などの管理ディレクトリを設定します。

PRFSPOOL
/opt/Cosminexus/PRF/spool
必要に応じて，パフォーマンストレーサの実行環境ディレクトリを設定します。

OSAGENT_PORT
14000
必要に応じて，スマートエージェントが使用するポート番号を設定します。

CTMDIR
/opt/Cosminexus/CTM
CTMのインストールディレクトリを設定します。

CTMSPOOL
/opt/Cosminexus/CTM/spool
必要に応じて，CTMの実行環境ディレクトリを設定します。

TZ
JST-9
タイムゾーンを設定します。

(2)　運用管理エージェントの自動起動の設定

運用管理エージェントを自動起動するための設定をします。設定方法を，OSごとに示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun agent

AIXの場合

mkitabコマンドを使用して，運用管理エージェントの起動スクリプト（/opt/Cosminexus/manager/bin/adminagentctl start）を，/etc/inittabファイルに登録します。なお，mkitabコマンドの詳細については，AIXのドキュメントを参照してください。

# mkitab "adminagentctl:2:once:/opt/Cosminexus/manager/bin/adminagentctl start > /dev/console # Cosminexus Management Server - Administration Agent Start"

HP-UXの場合

/sbin/rc<N>.dディレクトリに，/sbin/init.d/MngSvrおよび/sbin/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /sbin/init.d/MngSvr /sbin/rc2.d/S900MngSvr
# chmod 755 /sbin/rc2.d/S900MngSvr
# ln -s /sbin/init.d/AdminAgent /sbin/rc2.d/S800AdminAgent
# chmod 755 /sbin/rc2.d/S800AdminAgent

Linuxの場合

/etc/rc.d/rc<N>.dディレクトリに，/etc/rc.d/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/rc.d/init.d/AdminAgent /etc/rc.d/rc2.d/S80AdminAgent
# chmod 755 /etc/rc.d/rc2.d/S80AdminAgent

Solarisの場合

/etc/rc<N>.dディレクトリに，/etc/init.d/AdminAgentへのシンボリックリンクを作成します（<N>は起動時の実行レベルを表します）。

# ln -s /etc/init.d/AdminAgent /etc/rc2.d/S80AdminAgent
# chmod 755 /etc/rc2.d/S80AdminAgent

6.16.5　運用管理サーバの設定

運用管理サーバでは，次の設定をします。

環境変数の設定

Management Serverの設定

Management Serverの自動起動の設定

参考

JP1/SC/DPMを利用して，ホスト単位管理モデルのシステムを構築する場合は，Management Serverが稼働する各サーバマシンで設定します。

ここでは，CTMを使用する場合に追加して設定する環境変数についてだけ説明します。環境変数以外の設定内容については，「6.6　運用管理サーバの設定」を参照してください。

＜この項の構成＞

(1)　環境変数の設定

(1)　環境変数の設定

運用管理サーバでは，CTMを使用する場合，次の表に示す環境変数の設定を追加します。なお，AIX固有の環境変数については「6.5.1　環境変数の設定」を参照してください。

表6-20　運用管理サーバに追加設定する環境変数と設定値（CTMを使用する場合（Windowsの場合））

環境変数名 | 設定値 | 備考
OSAGENT_PORT | 14000 | 必要に応じて，スマートが使用するポート番号を設定します。
CTMDIR | <Cosminexusのインストールディレクトリ>¥CTM | CTMのインストールディレクトリを設定します。
CTMSPOOL | %CTMDIR%¥spool | 必要に応じて，CTMの実行環境ディレクトリを設定します。

表6-21　運用管理サーバに追加設定する環境変数と設定値（CTMを使用する場合（UNIXの場合））

環境変数名
設定値
備考

LIBPATH
（AIXの場合）
/opt/Cosminexus/CTM/lib
－

LD_LIBRARY_PATH
（HP-UX，Linux，およびSolarisの場合）

OSAGENT_PORT
14000
必要に応じて，スマートが使用するポート番号を設定します。

CTMDIR
/opt/Cosminexus/CTM
CTMのインストールディレクトリを設定します。

CTMSPOOL
/opt/Cosminexus/CTM/spool
必要に応じて，CTMの実行環境ディレクトリを設定します。

6.16.6　簡易構築定義ファイルの作成

CTMを使用するシステムを構築する場合，簡易構築定義ファイルでは，統合ネーミングスケジューラサーバと，アプリケーションサーバを定義する必要があります。統合ネーミングスケジューラサーバは，統合ネーミングスケジューラサーバ用のシステムで定義し，アプリケーションサーバは，CTM用のシステムで定義します。

システムごとに，簡易構築定義ファイルの設定内容と作成例を説明します。

参考

CTMにリクエストを送信するシステムとして，Smart Composer機能で構築するWebフロントシステムを使用する場合は，別のWebシステムで定義してください。

＜この項の構成＞

(1)　ファイルの設定内容

(2)　ファイルの作成例

(1)　ファイルの設定内容

Webシステムごとに，簡易構築定義ファイルの設定内容について説明します。

●統合ネーミングスケジューラサーバ用のWebシステム

Webシステムの属性定義
統合ネーミングスケジューラサーバを構築するWebシステムを定義します。

負荷分散機の定義
負荷分散機は定義できません。負荷分散機を定義した場合は，エラーとなります。

物理ティアの定義
物理ティア（ctm-tier）を定義します。
統合ネーミングスケジューラサーバではJ2EEサーバを配置しないため，ctm-tierで，J2EEサーバの数に0を設定します。
ctm-tierでは，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションを設定できます。

サービスユニットの定義
統合ネーミングスケジューラサーバ用のサービスユニットを定義します。

ホストの定義
統合ネーミングスケジューラサーバ用のサービスユニットを構成するホストを定義します。

●CTM用のWebシステム

Webシステムの属性定義
アプリケーションサーバを構築するWebシステムを定義します。

負荷分散機の定義
負荷分散機は定義できません。負荷分散機を定義した場合は，エラーとなります。

物理ティアの定義
物理ティア（ctm-tier）を定義します。
アプリケーションサーバでは，複数のJ2EEサーバが配置できます。複数のJ2EEサーバを配置する場合は，物理ティアの定義で，1ホストに配置するJ2EEサーバの数を設定します。

参考

1ホストに配置するJ2EEサーバの数は，Webシステムの構成変更時に変更できません。

ctm-tierでは，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションと，J2EEサーバ全体で共通のコンフィグレーションを設定できます。複数のJ2EEサーバを配置する場合は，同じ番号（<server-no>タグ）を持つJ2EEサーバで共通のコンフィグレーションも設定できます。

注意

統合ネーミングスケジューラサーバとの関係を定義するため，次に示すパラメタは，統合ネーミングスケジューラサーバと同じ値を設定してください。

CTMドメインマネジャが属するCTMドメイン名（論理CTMドメインマネジャのctmdomname）

CTMドメインマネジャで使用するポート番号（論理CTMドメインマネジャのcdm.port）

スマートエージェントで使用するポート番号（論理スマートエージェントのsmartagent.port）

サービスユニットの定義
CTM用のサービスユニットを定義します。
サービスユニットごとに，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションと，特定のJ2EEサーバのコンフィグレーションを設定できます。複数のJ2EEサーバを配置する場合，サービスユニット内のJ2EEサーバは，番号（<server-no>タグ）で特定します。

注意

CTMを識別するCTM識別子（ctmid）は，運用管理ドメイン内でユニークな値を設定する必要があります。CTM識別子（ctmid）の設定は省略できます。

ホストの定義
CTM用のサービスユニットを構成するホストを定義します。

複数のJ2EEサーバを配置する場合も，物理ティアおよびサービスユニットの定義で，コンフィグレーションを定義できます。J2EEサーバのコンフィグレーション定義の適用範囲を次の図に示します。

図6-16　J2EEサーバのコンフィグレーション定義の適用範囲

この図の場合に，各サービスユニットのJ2EEサーバごとに適用されるコンフィグレーション定義を次の表に示します。

表6-22　各サービスユニットのJ2EEサーバごとに適用されるコンフィグレーション定義

サービスユニット
J2EEサーバ
適用されるコンフィグレーション定義

unit1
J2EEサーバ（1A）

サービスユニットの定義（特定のJ2EEサーバの定義）

物理ティアの定義（同じ番号を持つJ2EEサーバで共通の定義）

物理ティアの定義（J2EEサーバ全体で共通の定義）

J2EEサーバ（1B）
物理ティアの定義（J2EEサーバ全体で共通の定義）

unit2
J2EEサーバ（2A）

物理ティアの定義（同じ番号を持つJ2EEサーバで共通の定義）

物理ティアの定義（J2EEサーバ全体で共通の定義）

J2EEサーバ（2B）
物理ティアの定義（J2EEサーバ全体で共通の定義）

この表のように，J2EEサーバごとに適用されるコンフィグレーション定義が複数ある場合，各定義で同じパラメタを指定したときは，次の1.，2.，3.の順に優先して適用されます。

サービスユニットの定義（特定のJ2EEサーバの定義）

物理ティアの定義（同じ番号を持つJ2EEサーバで共通の定義）

物理ティアの定義（J2EEサーバ全体で共通の定義）

なお，設定内容の詳細については，「13.7　簡易構築定義ファイル」，および「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

注意

JP1/SC/DPMを利用してCTMを使用するシステムを構築する場合に，ホスト単位管理モデルを使用するときは，ctmid（CTM識別子）の設定を省略することをお勧めします。ctmidの省略値については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

また，簡易構築定義ファイルの物理ティアの定義で，J2EEサーバおよびCTMのコンフィグレーション（<configuration>タグ）の設定が必要になります。JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタを次の表に示します。

表6-23　JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタ（CTMを使用するシステムの場合）

論理サーバの種類（<tier>タグ配下の<logical-server-type>タグの指定値） | <param-name>タグの指定値 | <param-value>タグの指定値
j2ee-server | realservername | 実サーバ名
webserver.connector.http.bind_host.value※ | true
webserver.connector.ajp13.bind_host.value※ | true
manager.mevent.sender.bind.host.value※ | true
vbroker.se.iiop_tp.host.value※ | true
mngagent.connector.host.value※ | true
CTM | ctm.NsBindHost※ | true

注※

Management Serverが稼働するホスト（サーバマシン）が，複数個のIPアドレスを持っている構成の場合に設定が必要です。

(2)　ファイルの作成例

CTMを使用するシステムの場合も，簡易構築定義ファイルのテンプレートファイル（cmxdefcombinedmodel.xml）を任意の場所にコピーして，作成します。テンプレートファイルの格納先については，「13.7　簡易構築定義ファイル」を参照してください。

CTMを使用した場合の構成情報を，次の図に示します。ここでは，CTMにリクエストを送信するクライアントとしてEJBクライアントを使用し，アプリケーションサーバには，J2EEサーバを二つ配置する例を使用して，説明しています。

図6-17　CTMを使用した場合の構成情報

簡易構築定義ファイルの作成例を次に示します。ここでは，テンプレートファイルをコピーして，ファイル名を「MyBackSystemDef.xml」に変更して作成しています。なお，統合ネーミングスケジューラサーバ用のWebシステムは，Webシステム1の「MyNamingSystem」，CTM用のWebシステムは，Webシステム2の「MyBackSystem」に対応しています。

MyBackSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステム(統合ネーミングスケジューラサーバ用のWebシステム)の属性定義 -->
 <web-system>
   <name>MyNamingSystem</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>ctm-tier</tier-type>
     <j2ee-server-count>0</j2ee-server-count>
     <configuration>
       <logical-server-type>ctm-domain-manager</logical-server-type>
       <param>
          <param-name>ctmdomname</param-name>
          <param-value>CTMDOMAIN</param-value>
       </param>
       <param>
          <param-name>cdm.port</param-name>
          <param-value>20137</param-value>
       </param>
     </configuration>
     <configuration>
       <logical-server-type>smart-agent</logical-server-type>
       <param>
          <param-name>smartagent.port</param-name>
          <param-value>14000</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>namsv1</host-ref>
       <hosts-for>ctm-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>namsv2</host-ref>
       <hosts-for>ctm-tier</hosts-for>
     </allocated-host>
   </unit>
 </web-system>
 <!-- Webシステム(CTM用のWebシステム)の属性定義 -->
 <web-system>
   <name>MyBackSystem</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>ctm-tier</tier-type>
     <j2ee-server-count>2</j2ee-server-count>
     <configuration>
       <logical-server-type>ctm-domain-manager</logical-server-type>
       <param>
          <param-name>ctmdomname</param-name>
          <param-value>CTMDOMAIN</param-value>
       </param>
       <param>
          <param-name>cdm.port</param-name>
          <param-value>20137</param-value>
       </param>
     </configuration>
     <configuration>
       <logical-server-type>smart-agent</logical-server-type>
       <param>
          <param-name>smartagent.port</param-name>
          <param-value>14000</param-value>
       </param>
     </configuration>
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <server-no>2</server-no>
       <param>
          <param-name>http</param-name>
          <param-value>8081</param-value>
       </param>
       <param>
          <param-name>webserver.connector.ajp13.port</param-name>
          <param-value>8008</param-value>
       </param>
       <param>
          <param-name>inprocess.ns.port</param-name>
          <param-value>901</param-value>
       </param>
       <param>
          <param-name>ejbserver.distributedtx.recovery.port</param-name>
          <param-value>20303</param-value>
       </param>
       <param>
          <param-name>ejbserver.rmi.naming.port</param-name>
          <param-value>23153</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>ctmsv1</host-ref>
       <hosts-for>ctm-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit4</name>
     <allocated-host>
       <host-ref>ctmsv2</host-ref>
       <hosts-for>ctm-tier</hosts-for>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>namsv1</host-name>
   <agent-host>192.168.100.31</agent-host>
 </host>
 <host>
   <host-name>namsv2</host-name>
   <agent-host>192.168.100.32</agent-host>
 </host>
 <host>
   <host-name>ctmsv1</host-name>
   <agent-host>192.168.100.33</agent-host>
 </host>
 <host>
   <host-name>ctmsv2</host-name>
   <agent-host>192.168.100.34</agent-host>
 </host>
</model-definition>

注　太字の部分が編集部分です。

6.17　サーバマシン内に複数のサービスユニットを配置する場合に必要な設定

ここでは，combined-tier構成で，サーバマシン内に複数のサービスユニットを配置するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

なお，http-tierとj2ee-tierを組み合わせた構成，インプロセスHTTPサーバ機能を使用する構成，セッションフェイルオーバ機能を使用する構成，およびCTMを使用する構成で，サーバマシン内に複数のサービスユニットを配置するシステムを一括構築する場合も，ここで説明している設定が必要です。ただし，CTMを使用する構成の場合，同じCTMドメインのサービスユニットは，サーバマシン内に複数配置できません。

サーバマシン内に複数のサービスユニットを配置するシステムを一括構築する場合の流れを，次の図に示します。

図6-18　サーバマシン内に複数のサービスユニットを配置するシステムを一括構築する場合の流れ

ここでは，サーバマシン内に複数のサービスユニットを配置する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.17.1　簡易構築定義ファイルの作成

6.17.1　簡易構築定義ファイルの作成

1台のサーバマシンに複数のサービスユニットを配置すると，1台のサーバマシン内に，同じ種類の論理サーバが複数存在することになります。このため，各論理サーバのコンフィグレーションで，次に示す項目の指定値を重複しないようにしてください。

表6-24　論理サーバごとに重複しないように設定する項目

論理サーバの種類 | 項目 | param-nameの指定値
Webサーバ | httpポート番号 | Listen
J2EEサーバ | 管理用サーバのポート番号 | ejbserver.http.port
ajp13のポート番号 | webserver.connector.ajp13.port
httpsのポート番号 | webserver.connector.redirect_https.port
インプロセスのネーミングサービス用のポート番号 | inprocess.ns.port
インプロセスのHTTPサーバのポート番号 | webserver.connector.inprocess_http.port
JTAリカバリの固定ポート番号 | ejbserver.distributedtx.recovery.port
RMIレジストリのポート番号 | ejbserver.rmi.naming.port
パフォーマンストレーサ | PRF識別子 | PRFID
SFOサーバ | 管理用サーバのポート番号 | ejbserver.http.port
ajp13のポート番号 | webserver.connector.ajp13.port
インプロセスのネーミングサービス用のポート番号 | inprocess.ns.port
RMIレジストリのポート番号 | ejbserver.rmi.naming.port
スマートエージェント | スマートエージェントが監視するポート番号 | smartagent.port
CTMドメインマネジャ | CTMドメインマネジャが属するCTMドメイン名 | ctmdomname
CTM実行環境ディレクトリ | ctmspool
CTMドメインマネジャがCTMドメイン構成情報を交換するために使用するポート番号 | cdm.port
CTM | CTMの識別子 | ctmid※
CTMが使用するポート番号 | ctm.port
CTMと対となるネーミングサービスのポート番号 | ctm.ns.port

注※

ctmidの設定は省略できます。省略時は，ホスト間で一意になるようにManagement Serverで自動的に設定されます。ctmidの省略値については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

参考

1台のサーバマシン内にある複数のサービスユニットを同時に起動しない運用をする場合は，各サービスユニットの同じ種類の論理サーバに同じ値を設定できます。

サーバマシンに配置するサービスユニットが属するWebシステムによって，これらの設定項目をどの定義のコンフィグレーションで指定するかが異なります。

同じWebシステムのサービスユニットを1台のサーバマシンに配置する場合
各サービスユニットの論理サーバ定義（<define-server>タグ）内の<configuration>タグで指定します。

異なるWebシステムのサービスユニットを1台のサーバマシンに配置する場合
各Webシステムの物理ティア定義（<tier>タグ）内の<configuration>タグで指定します。

＜この項の構成＞

(1)　同じWebシステムのサービスユニットを1台のサーバマシンに配置する場合

(2)　異なるWebシステムのサービスユニットを1台のサーバマシンに配置する場合

(1)　同じWebシステムのサービスユニットを1台のサーバマシンに配置する場合

「6.8　システムの構成定義」で示す構成情報を基に，同じWebシステムで，サーバマシン内に複数のサービスユニットを配置する場合の構成情報を，次の図に示します。

図6-19　サーバマシン内に複数のサービスユニットを配置する場合の構成情報（同一のWebシステムの場合）

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，同じWebシステムで，サーバマシン内に複数のサービスユニットを配置する場合に差異のある定義について説明します。MyWebSystemDef.xmlファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     :
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <configuration>
       :
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>apsv2</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv2</host-ref>
       <hosts-for>combined-tier</hosts-for>
       <!-- Webサーバのコンフィグレーション -->
       <define-server>
         <logical-server-type>web-server</logical-server-type>
         <configuration>
           <!-- httpポート番号 -->
           <param>
             <param-name>Listen</param-name>
             <param-value>81</param-value>
           </param>
         </configuration>
       </define-server>
       <!-- J2EEサーバのコンフィグレーション -->
       <define-server>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration>
           <!-- 管理用サーバのポート番号 -->
           <param>
             <param-name>ejbserver.http.port</param-name>
             <param-value>8081</param-value>
           </param>
           <!-- ajp13のポート番号 -->
           <param>
             <param-name>webserver.connector.ajp13.port</param-name>
             <param-value>8008</param-value>
           </param>
           <!-- インプロセスネーミングサービス用のポート番号 -->
           <param>
             <param-name>inprocess.ns.port</param-name>
             <param-value>901</param-value>
           </param>
           <!-- JTAリカバリの固定ポート番号 -->
           <param>
             <param-name>ejbserver.distributedtx.recovery.port</param-name>
             <param-value>20303</param-value>
           </param>
           <!-- RMIレジストリのポート番号 -->
           <param>
             <param-name>ejbserver.rmi.naming.port</param-name>
             <param-value>23153</param-value>
           </param>
         </configuration>
       </define-server>
       <!-- パフォーマンストレーサのコンフィグレーション -->
       <define-server>
         <logical-server-type>performance-tracer</logical-server-type>
         <configuration>
           <!-- PRF識別子 -->
           <param>
             <param-name>PRFID</param-name>
             <param-value>PRF_ID2</param-value>
           </param>
         </configuration>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
 <host>
   <host-name>apsv2</host-name>
   <agent-host>192.168.100.12</agent-host>
 </host>
</model-definition>

注　太字の部分が設定の異なる部分です。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

(2)　異なるWebシステムのサービスユニットを1台のサーバマシンに配置する場合

「6.8　システムの構成定義」で示す構成情報を基に，異なるWebシステムのサービスユニットを，1台のサーバマシンに配置する場合の構成情報を，次の図に示します。

なお，ここでは，異なるWebシステム間で1台の負荷分散機を共有している場合の例で説明しています。この場合，それぞれのWebシステムで使用する負荷分散機の仮想サーバを分ける必要があります。また，各Webシステムの負荷分散機の定義で，同じIPアドレスを定義してください。共有する負荷分散機の種類によっては，次の点にも注意してください。

BIG-IP 1500およびBIG-IP 1000の場合
各Webシステムの仮想サーバの定義で，仮想サーバ名，仮想サーバのIPアドレスおよびポート番号が重複しないように設定してください。

Loadflowbalの場合
各Webシステムの仮想サーバの定義で，仮想サーバ名，仮想サーバのIPアドレスが重複しないように設定してください。

図6-20　サーバマシン内に複数のサービスユニットを配置する場合の構成情報（異なるWebシステムの場合）

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，異なるWebシステムのサービスユニットを，1台のサーバマシンに配置する場合に差異のある定義について説明します。MyWebSystemDef.xmlファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステム1の属性定義 -->
 <web-system>
   <name>MyWebSystem1</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     <name>MyBIGIPv9</name>
     <load-balancer-type>BIG-IPv9</load-balancer-type>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <cookie-switching-enabled>true</cookie-switching-enabled>
       <cookie-name>CMX_SERVER_ID</cookie-name>
       <server-id-rule>1024-2048</server-id-rule>
     </cookie-switching>
     <management-host>192.168.100.10</management-host>
     <!-- 仮想サーバ1の定義 -->
     <virtual-server>
       <virtual-server-name>www.sample1.com</virtual-server-name>
       <ip-address>192.168.1.10</ip-address>
       <http-port>80</http-port>
     </virtual-server>
   </load-balancer>
   <!-- 物理ティアの定義 -->
   <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>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>apsv2</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
 </web-system>
 <!-- Webシステム2の属性定義 -->
 <web-system>
   <name>MyWebSystem2</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     <name>MyBIGIPv9</name>
     <load-balancer-type>BIG-IPv9</load-balancer-type>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <cookie-switching-enabled>true</cookie-switching-enabled>
       <cookie-name>CMX_SERVER_ID</cookie-name>
       <server-id-rule>1024-2048</server-id-rule>
     </cookie-switching>
     <management-host>192.168.100.10</management-host>
     <!-- 仮想サーバ2の定義 -->
     <virtual-server>
       <virtual-server-name>www.sample2.com</virtual-server-name>
       <ip-address>192.168.1.20</ip-address>
       <http-port>81</http-port>
     </virtual-server>
   </load-balancer>
   <!-- 物理ティアの定義 -->
   <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>http</param-name>
         <param-value>8081</param-value>
       </param>
       <!-- ajp13のポート番号 -->
       <param>
         <param-name>webserver.connector.ajp13.port</param-name>
         <param-value>8008</param-value>
       </param>
       <!-- インプロセスネーミングサービス用のポート番号 -->
       <param>
         <param-name>inprocess.ns.port</param-name>
         <param-value>901</param-value>
       </param>
       <!-- JTAリカバリの固定ポート番号 -->
       <param>
         <param-name>ejbserver.distributedtx.recovery.port</param-name>
         <param-value>20303</param-value>
       </param>
       <!-- RMIレジストリのポート番号 -->
       <param>
         <param-name>ejbserver.rmi.naming.port</param-name>
         <param-value>23153</param-value>
       </param>
     </configuration>
     <configuration>
       <logical-server-type>web-server</logical-server-type>
       <!-- httpポート番号 -->
       <param>
         <param-name>Listen</param-name>
         <param-value>81</param-value>
      </param>
     </configuration>
     <configuration>
       <logical-server-type>performance-tracer</logical-server-type>
       <!-- PRF識別子 -->
       <param>
         <param-name>PRFID</param-name>
         <param-value>PRF_ID2</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv2</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
     :
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
 <host>
   <host-name>apsv2</host-name>
   <agent-host>192.168.100.12</agent-host>
 </host>
</model-definition>

注　太字の部分が設定の異なる部分です。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

6.18　論理ユーザサーバを使用する場合に必要な設定

ここでは，combined-tier構成で，論理ユーザサーバを使用するシステムを一括構築する場合に必要な設定について説明します。「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」で説明した流れと，システムの構築手順または設定内容が異なる部分だけを記載しています。

なお，http-tierとj2ee-tierを組み合わせた構成，インプロセスHTTPサーバ機能を使用する構成，セッションフェイルオーバ機能を使用する構成，およびCTMを使用する構成で，論理ユーザサーバを使用するシステムを一括構築する場合も，ここで説明している設定が必要です。

論理ユーザサーバを使用するシステムを一括構築する場合の流れを，次の図に示します。

図6-21　論理ユーザサーバを使用するシステムを一括構築する場合の流れ

論理ユーザサーバを使用する場合に，システム構築で設定内容が異なる手順について説明します。

＜この節の構成＞

6.18.1　簡易構築定義ファイルの作成

6.18.1　簡易構築定義ファイルの作成

簡易構築定義ファイルで，論理ユーザサーバを設定します。

「6.8　システムの構成定義」で示す構成情報を基に，論理ユーザサーバを使用する場合の構成情報を，次の図に示します。

図6-22　論理ユーザサーバを使用する場合の構成情報

「6.8　システムの構成定義」で示す簡易構築定義ファイル（MyWebSystemDef.xml）を基に，論理ユーザサーバを使用する場合に差異のある定義について説明します。MyWebSystemDef.xmlファイルの作成例を，次に示します（一部抜粋）。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
       ：
   </load-balancer>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>host1</host-ref>
       <hosts-for>combined-tier</hosts-for>
       <define-server>
       <logical-server-type>UserServer1</logical-server-type>
         <configuration>
         <param>
         <!-- サーバ起動用コマンド -->
           <param-name>start.arg</param-name>
           <param-value>c:/test/start.exe</param-value>
         </param>
         </configuration>
       </define-server>
       <define-server>
       <logical-server-type>UserServer2</logical-server-type>
         <configuration>
         <param>
         <!-- サーバ起動用コマンド -->
           <param-name>start.arg</param-name>
           <param-value>c:/test/start.exe</param-value>
         </param>
         </configuration>
       </define-server>
     </allocated-host>
   </unit>
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>host1</host-ref>
       <hosts-for>combined-tier</hosts-for>
       <define-server>
     <logical-server-type>UserServer3</logical-server-type>
         <configuration>
         <param>
         <!-- サーバ起動用コマンド -->
           <param-name>start.arg</param-name>
           <param-value>c:/test/start.exe</param-value>
         </param>
         </configuration>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   :
 </host>
</model-definition>

注　論理ユーザサーバのパラメタは，物理ティアの定義には設定できません。論理ユーザサーバのパラメタを設定する場合は，サービスユニットの定義に設定してください。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

6.19　障害に対応したシステムの構築

ここでは，「5.2.3　障害設計」で説明した障害に対応した次のようなシステムを構築します。

障害発生時にサービスユニットを自動閉塞するシステム

障害発生時にサービスユニットを自動再起動するシステム

＜この節の構成＞

6.19.1　障害発生時にサービスユニットを自動閉塞するための設定

6.19.2　サービスユニットを自動再起動するための設定

6.19.1　障害発生時にサービスユニットを自動閉塞するための設定

Cosminexusでは，システムに障害が発生した場合の動作を障害検知時コマンドで定義できます。ユーザ作成の障害検知時コマンドにSmart Composer機能のコマンドを定義しておくことで，システムの運用中に障害が発生した場合にサービスユニットを自動閉塞できるため，迅速な障害対応ができます。

J2EEサーバのハングアップなどシステムの一部で致命的な障害が発生した場合に，障害発生時の情報を収集し，障害の発生しているサービスユニットを自動的に閉塞します。障害検知時コマンドによるサービスユニットの自動閉塞処理を次の図に示します。

図6-23　障害検知時コマンドによるサービスユニットの自動閉塞処理

Smart Composer機能を使用すると，致命的な障害が発生した場合に，そのサービスユニットを自動閉塞できます。

ここでは例として，J2EEサーバがハングアップまたはプロセスダウンした場合，障害検知時コマンドを使用してサービスユニットを自動閉塞する方法について説明します。必要な操作は次のとおりです。

J2EEサーバの自動再起動設定の無効化

障害検知時コマンドの作成

Management Serverの設定

運用管理エージェントの設定

障害検知時コマンドの概要については，マニュアル「Cosminexus　機能解説」の障害検知時コマンドによるトラブルシューティングの資料取得に関する説明を，設定については，マニュアル「Cosminexus　システム構築ガイド」の障害検知時コマンドによる資料取得の設定に関する説明を参照してください。

＜この項の構成＞

(1)　J2EEサーバの自動再起動設定の無効化

(2)　障害検知時コマンドの作成

(3)　Management Serverの設定

(4)　運用管理エージェントの設定

(1)　J2EEサーバの自動再起動設定の無効化

前準備として，J2EEサーバの自動再起動の設定を無効にする必要があります。この設定が有効になっている場合（デフォルトでは有効に設定されています）は，次の手順で設定を変更してください。

構築済みのシステムの構築時に使用した簡易構築定義ファイルを編集します。
物理ティアの定義（<tier>タグの定義）の<configuration>タグに，次の設定を追加します。なお，指定するパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

<logical-server-type>タグ：j2ee-server

<param-name>タグ：mstartup.restartcnt

<param-value>タグ：0

MyWebSystemDef.xmlファイルの設定例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">  <web-system>
 <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     :
   </load-balancer>
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- J2EEサーバの障害検知時自動再起動を無効にする設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>mstartup.restartcnt</param-name>
         <param-value>0</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     :
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   :
 </host>
</model-definition>

注　太字の部分が編集部分です。

変更した簡易構築定義ファイルの内容を実際のシステムに反映して，システムの設定を一括で変更します。
システムの設定の一括変更の方法については，「6.12.1(2)　システムの設定変更」を参照してください。

(2)　障害検知時コマンドの作成

障害検知時コマンドには，障害発生時に呼び出すコマンドを定義します。

システム提供の障害検知時コマンドについては，提供されているものを使用するため，ここで作成する必要はありません。

ここでは，J2EEサーバのハングアップまたはプロセスダウンを検知しときに障害の発生したJ2EEサーバを含むサービスユニットを閉塞する，ユーザ作成の障害検知時コマンドを作成します。なお，作成例で使用している環境変数の詳細については，マニュアル「Cosminexus　システム構築ガイド」の環境変数の設定に関する説明を参照してください。

Windowsの場合

バッチファイル（holdunit.bat）の作成例を示します。

@echo off

"<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target" -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s "%COSMI_MNG_WEB_SYSTEM%" -unit "%COSMI_MNG_UNIT%"

UNIXの場合

シェルスクリプトファイル（holdunit.sh）の作成例を示します。

#!/bin/sh

/opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s "${COSMI_MNG_WEB_SYSTEM}" -unit "${COSMI_MNG_UNIT}"

(3)　Management Serverの設定

mserver.properties（Management Server環境設定ファイル）で，ユーザ作成の障害検知時コマンドの動作を設定します。なお，システム提供の障害検知時コマンドについては，デフォルトで利用する設定になっているため，ここでの設定は必要ありません。

運用管理サーバでmserver.propertiesファイルを編集します。
次のプロパティを設定します。

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled
ユーザ作成の障害検知時コマンドを利用する（true）に設定します。

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout
ユーザ作成の障害検知時コマンドの終了を待つ時間を設定します。

なお，プロパティの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。
mserver.propertiesファイルの設定例を示します。

...
com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled=true
com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout=300
...

mserver.propertiesファイルは，次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

Management Serverが稼働中の場合は，再起動します。

mngsvrctlコマンドに，引数「stop」を指定してManagement Serverを停止します。

mngsvrctlコマンドに，引数「start」を指定してManagement Serverを起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl stop
<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl start

UNIXの場合

# /opt/Cosminexus/manager/bin/mngsvrctl stop
# /opt/Cosminexus/manager/bin/mngsvrctl start

(4)　運用管理エージェントの設定

adminagent.properties（運用管理エージェントプロパティファイル）で，ユーザ作成の障害検知時コマンドを実行するための設定をします。

ユーザ作成の障害検知時コマンドを，各アプリケーションサーバに配置します。
ここでは，ユーザ作成の障害検知時コマンドを次の場所に格納します。

Windowsの場合

C:¥work¥holdunit.bat

UNIXの場合

/work/holdunit.sh

各アプリケーションサーバのadminagent.properties（運用管理エージェントプロパティファイル）を編集します。
ここでは，J2EEサーバ障害発生時に，ユーザ作成の障害検知時コマンドを実行する場合の例を示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥adminagent.propertiesの設定例を，次に示します。

...
adminagent.j2ee.usr_cmd.abnormal_end=%{ComSpec} /c "C:/work/holdunit.bat"
...

UNIXの場合

/opt/Cosminexus/manager/config/adminagent.propertiesの設定例を，次に示します。

...
adminagent.j2ee.usr_cmd.abnormal_end=/bin/sh /work/holdunit.sh
...

運用管理エージェントが稼働中の場合は，再起動します。

adminagentctl コマンドに，引数「stop」を指定して運用管理エージェントを停止します。

adminagentctl コマンドに，引数「start」を指定して運用管理エージェントを起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl stop
<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

UNIXの場合

# /opt/Cosminexus/manager/bin/adminagentctl stop
# /opt/Cosminexus/manager/bin/adminagentctl start

6.19.2　サービスユニットを自動再起動するための設定

Cosminexusでは，システムに障害が発生しそうな場合の動作をManagementアクションで定義できます。ManagementアクションにSmart Composer機能のコマンドを定義しておくことで，システムの運用中に障害が発生しそうな場合にサービスユニットを自動再起動できるため，迅速な障害対応ができます。

リソース枯渇監視機能でリソースの枯渇を事前に検知したり，J2EEアプリケーションの実行時間監視機能でJ2EEアプリケーションのタイムアウトを検知したりして，障害の発生しそうな状況になるとManagementイベントが発行されます。そのManagementイベントと対応づけたManagementアクションを実行し，障害が発生しそうなサービスユニットを自動的に再起動して，障害の発生を事前に回避します。Managementアクションによるサービスユニットの自動再起動処理を次の図に示します。

図6-24　Managementアクションによるサービスユニットの自動再起動処理

Smart Composer機能を使用すると，JavaVMのフルガーベージコレクションやスレッドなどのリソース枯渇を事前検知した場合，およびJ2EEアプリケーションの実行時間監視でタイムアウトなどが発生した場合に，問題の発生したサービスユニットを自動再起動できます。

ここでは例として，J2EEサーバのフルガーベージコレクションの予兆を検知した場合に，Managementアクションを使用してサービスユニットを自動再起動する方法について説明します。必要な操作は次のとおりです。

Managementアクション実行コマンドの作成

Managementイベントの発行の設定

Managementイベント発行用メッセージIDリストファイルおよびリソース監視機能の設定

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

なお，リソース枯渇監視機能およびManagementアクションの概要については，マニュアル「Cosminexus　機能解説」のシステムの運用支援に関する説明を，設定については，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

＜この項の構成＞

(1)　Managementアクション実行コマンドの作成

(2)　Managementイベントの発行の設定

(3)　Managementイベント発行用メッセージIDリストファイルおよびリソース枯渇監視機能の設定

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

(1)　Managementアクション実行コマンドの作成

JavaVMのフルガーベージコレクションやスレッドなどのリソース枯渇を事前検知した場合，J2EEアプリケーションの実行時間監視でタイムアウトが発生した場合などに発行されるManagementイベントを受信したときに，Management Serverが実行するManagementアクション実行コマンドを作成します。

ここでは，J2EEサーバのフルガーベージコレクションの予兆を検知した場合，次の順序でサービスユニットを再起動するManagementアクション実行コマンドを作成します。

障害の発生したJ2EEサーバを含むサービスユニットを自動閉塞します。

障害の発生したJ2EEサーバを再起動します。

サービスユニットを開始します。

Managementアクション実行コマンドのサンプルファイルをコピーして，Managementアクション実行コマンド（バッチファイルまたはシェルスクリプト）を作成してください。

(a)　Windowsの場合

サンプルファイル（<Cosminexusインストールディレクトリ>¥manager¥examples¥maction¥mActionSample_closeUnit.bat）を，C:¥work ¥maction_restartunit.batにコピーして，次のようなバッチファイルを作成します。

maction_restartunit.batファイルの記述例（一部抜粋）

...
set CJCLDELLOG=<Cosminexusインストールディレクトリ>¥CC¥client¥bin¥cjcldellog.bat
set LOG_ROOT_DIR=%SystemDrive%¥work
...
set MNGSVR=192.168.100.100:%COSMI_MNG_MACT_MNGSVR_PORT%
set UID=cosmi_admin
set PWD=cosmi_admin_passwd

echo cmx_stop_target.exe -m %MNGSVR% -u %UID% -p %PWD% -mode HOLD -s %WEBSYSTEM% -unit %UNIT% >> "%LOG%" 2>&1
cmx_stop_target.exe -m %MNGSVR% -u %UID% -p %PWD% -mode HOLD -s %WEBSYSTEM% -unit %UNIT% >> "%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 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 cmx_start_target.exe -m %MNGSVR% -u %UID% -p %PWD% -mode ALL -s %WEBSYSTEM% -unit %UNIT% >> "%LOG%" 2>&1
cmx_start_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%

(b)　UNIXの場合

サンプルファイル（/opt/Cosminexus/manager/examples/maction/mActionSample_closeUnit.sh）を，/work/maction_restartunit.shにコピーして，次のようなシェルスクリプトを作成します。

maction_restartunit.shファイルの記述例（一部抜粋）

...
LOG_ROOT_DIR=/work
if [ ! -d ${LOG_ROOT_DIR} ]; then
...
MNGSVR=192.168.100.100:${COSMI_MNG_MACT_MNGSVR_PORT}
USERID=cosmi_admin
PASSWD=cosmi_admin_passwd

echo ./cmx_stop_target -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -mode HOLD -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
./cmx_stop_target -m ${MNGSVR} -u ${USERID} -p ${PASSWD} -mode HOLD -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
RET=$?
echo ${RET} >> "${LOG}"

if [ $RET -eq 0 ]; then
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 ./cmx_start_target -m ${MNGSVR} -u ${USERID} -p {PASSWD} -mode ALL -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
./cmx_start_target -m ${MNGSVR} -u ${USERID} -p {PASSWD} -mode ALL -s ${WEBSYSTEM} -unit ${UNIT} >> "${LOG}" 2>&1
RET=$?
echo ${RET} >> "${LOG}"

exit ${RET}

(2)　Managementイベントの発行の設定

J2EEサーバのManagementイベントの発行が有効になっていない場合は，Managementイベントの発行を有効にします。Managementイベントの発行を有効にするには，次の手順で設定を変更してください。

構築済みのシステムの構築時に使用した簡易構築定義ファイルを編集します。
物理ティアの定義（<tier>タグの定義）の<configuration>タグに，次の設定を追加します。なお，指定するパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

<logical-server-type>タグ：j2ee-server

<param-name>タグ：ejbserver.manager.agent.MEventAgent.enabled

<param-value>タグ：true

MyWebSystemDef.xmlファイルの設定例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">    <web-system>
 <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     :
   </load-balancer>
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- J2EEサーバのManagementイベントの発行を有効にする設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>ejbserver.manager.agent.MEventAgent.enabled</param-name>
         <param-value>true</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     :
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   :
 </host>
</model-definition>

注　太字の部分が編集部分です。

変更した簡易構築定義ファイルの内容を実際のシステムに反映して，システムの設定を一括で変更します。
システムの設定の一括変更の方法については，「6.12.1(2)　システムの設定変更」を参照してください。

(3)　Managementイベント発行用メッセージIDリストファイルおよびリソース枯渇監視機能の設定

Managementイベントを発行するために，Managementイベント発行用メッセージIDリストファイルの設定や，リソース枯渇監視機能の設定が必要な場合があります。

通常はデフォルトのまま使用するため，設定の必要はありません。必要に応じて設定してください。

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

Managementイベントを発行したいメッセージのメッセージIDを，Managementイベント発行用メッセージIDリストファイルに記述します。Managementイベント発行用メッセージIDリストファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(b)　リソース枯渇監視機能の設定

リソースの監視間隔やしきい値を指定してリソースを監視し，しきい値を超えた場合にアラートを出力できます。また，リソース枯渇監視情報をファイルに出力できます。

リソース枯渇監視機能を使用するためには，次の二つの設定が必要です。

リソース枯渇監視機能の有効化

リソース種別ごとの監視の設定

デフォルトの設定では，リソース枯渇監視機能は有効になっています。リソース枯渇監視機能の設定については，マニュアル「Cosminexus　システム構築ガイド」のリソース枯渇監視の設定に関する説明を参照してください。

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

Managementアクションの定義，メッセージIDとManagementアクションとのマッピングなどは，Managementアクション実行用プロパティファイル（maction.properties）に定義します。maction.propertiesファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

運用管理サーバでManagementアクション実行用プロパティファイル（maction.properties）を編集します。
ここでは，メッセージKDJE34500-Wが発行された場合に，「6.19.2(1)　Managementアクション実行コマンドの作成」で作成したManagementアクション実行コマンドが実行される例を示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥maction.propertiesファイルの設定例を，次に示します。

# Definition of Management action.
maction.restart_unit.command=C:/work/maction_restartunit.bat
maction.restart_unit.timeout=180
maction.restart_unit.timeout.forced_stop=false

# Mapping of Message ID and Management actions.
# KDJE34500-W: Alert - Memory(Java Heap)
maction.message.KDJE34500-W.mactions=restart_unit

# Mapping of Logical server and Management actions.
maction.tier.MyWebSystem.combined-tier.mactions=restart_unit

UNIXの場合

/opt/Cosminexus/manager/config/maction.propertiesファイルの設定例を，次に示します。

# Definition of Management action.
maction.restart_unit.command=/work/maction_restartunit.sh
maction.restart_unit.timeout=180
maction.restart_unit.timeout.forced_stop=false

# Mapping of Message ID and Management actions.
# KDJE34500-W: Alert - Memory(Java Heap)
maction.message.KDJE34500-W.mactions=restart_unit

# Mapping of Logical server and Management actions.
maction.tier.MyWebSystem.combined-tier.mactions=restart_unit

Management Serverが稼働中の場合は，再起動します。

mngsvrctlコマンドに，引数「stop」を指定してManagement Serverを停止します。

mngsvrctlコマンドに，引数「start」を指定してManagement Serverを起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl stop
<Cosminexusインストールディレクトリ>¥manager¥bin¥mngsvrctl start

UNIXの場合

# /opt/Cosminexus/manager/bin/mngsvrctl stop
# /opt/Cosminexus/manager/bin/mngsvrctl start

7.　J2EEアプリケーションを実行するシステムの運用

この章では，J2EEアプリケーションを実行するシステムの運用について説明します。なお，システム運用で使用するコマンドやファイルについては，「12.　コマンド」および「13.　ファイル」を参照してください。

＜この章の構成＞

7.1　システム運用の概要

7.2　日常運用の操作

7.3　システムのメンテナンス

7.4　システム全体の設定変更

7.5　システムのスケールアウト

7.6　システムのスケールイン

7.7　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

7.8　構築済みのシステムの移行

7.9　システムの削除

7.10　トラブルへの対処

7.1　システム運用の概要

ここでは，Smart Composer機能を使用した運用操作について説明します。そのほかの運用作業については，「5.2　運用・障害設計」を参照してください。

Smart Composer機能を使用した運用操作では，一括起動・一括停止の日常運用の操作，J2EEアプリケーションの入れ替えなどによるシステムのメンテナンス，スケールインやスケールアウト，環境の移行や削除などが実施できます。ここでは，次に示す運用操作の手順を説明しています。

日常運用（7.2参照）

サービスユニットの一括起動

サービスユニットの一括停止

メンテナンス

システムの部分メンテナンス（7.3.1参照）

J2EEアプリケーションの一括入れ替え（7.3.2参照）

システムの一括設定変更（7.4参照）

システムの構成変更

システムのスケールアウト（7.5，7.7.1および7.7.2参照）

システムのスケールイン（7.6および7.7.3参照）

構築済みのシステムの移行（7.8参照）

システムの削除（7.9参照）

それぞれの運用の概要については，「5.2.2　運用設計」を参照してください。また，Smart Composer機能のコマンドの詳細については「12.　コマンド」を参照してください。サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

7.2　日常運用の操作

Smart Composer機能では，日常運用の操作として，システムの一括起動および一括停止がサービスユニット単位で実施できます。システム内のすべてのサービスユニットを一括で起動および停止することも，特定のサービスユニットだけを一括で起動および停止することもできます。

＜この節の構成＞

7.2.1　すべてのサービスユニットの一括起動と一括停止

7.2.2　サービスユニット単位の一括起動と一括停止

7.2.1　すべてのサービスユニットの一括起動と一括停止

一括起動をするにはcmx_start_targetコマンドを，一括停止をするには，cmx_stop_targetコマンドを使用します。システム内のすべてのサービスユニットを一括起動したり，一括停止したりするには，これらのコマンドを使用するときに，-unitオプションの指定を省略します。

ここでは，システム内のすべてのサービスユニットを，一括起動および一括停止する手順について説明します。

＜この項の構成＞

(1)　一括起動

(2)　一括停止

(1)　一括起動

システム内のすべてのサービスユニットを一括で起動するときの手順を次に示します。リソースアダプタおよびJ2EEアプリケーションが停止している場合は，サービスユニットを起動したあとで，開始する必要があります。リソースアダプタおよびJ2EEアプリケーションの開始については，「6.11.2　リソースアダプタのインポートと開始」および「6.11.3　J2EEアプリケーションのインポートと開始」を参照してください。

cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

(2)　一括停止

システム内のすべてのサービスユニットを一括で停止するときの手順を次に示します。

cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

業務実行中の場合は，最初にシステム内のすべてのサービスユニットを負荷分散機から切り離し，実行中のリクエストを処理したあとに，サービスユニット内のすべての論理サーバを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

7.2.2　サービスユニット単位の一括起動と一括停止

一括起動をするにはcmx_start_targetコマンドを，一括停止をするにはcmx_stop_targetコマンドを使用します。特定のサービスユニットを一括起動したり，一括停止したりするには，これらのコマンドを使用するときに，-unitオプションにサービスユニット名を指定します。

ここでは，特定のサービスユニットだけを，一括起動および一括停止する手順について説明します。

＜この項の構成＞

(1)　一括起動

(2)　一括停止

(1)　一括起動

特定のサービスユニットを一括で起動するときの手順を次に示します。

リソースアダプタおよびJ2EEアプリケーションが停止している場合は，サービスユニットを起動したあとで，開始する必要があります。リソースアダプタおよびJ2EEアプリケーションの開始については，「6.11.2　リソースアダプタのインポートと開始」および「6.11.3　J2EEアプリケーションのインポートと開始」を参照してください。

cmx_start_targetコマンドを使用して，サービスユニット「unit1」を稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

参考

Smart Composer機能のコマンドを使用すると，リソースアダプタおよびJ2EEアプリケーションの一括開始ができます。ただし，Smart Composer機能のコマンドで，リソースアダプタおよびJ2EEアプリケーションをManagement Serverに登録してデプロイしている必要があります。Smart Composer機能のコマンドを使用したリソースアダプタおよびJ2EEアプリケーションのデプロイについては，「6.11.2　リソースアダプタのインポートと開始」，および「6.11.3　J2EEアプリケーションのインポートと開始」を参照してください。

リソースアダプタの一括開始には，cmx_start_resourceコマンドを使用します。J2EEアプリケーションの一括開始には，cmx_start_applicationコマンドを使用します。それぞれのコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

(2)　一括停止

特定のサービスユニットを一括で停止するときの手順を次に示します。

cmx_stop_targetコマンドを使用して，サービスユニット「unit1」を停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

業務実行中の場合は，最初に，停止させたいサービスユニットを負荷分散機から切り離し，実行中のリクエストを処理したあとに，サービスユニット内のすべての論理サーバを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

参考

Smart Composer機能のコマンドでも，リソースアダプタおよびJ2EEアプリケーションの一括停止ができます。ただし，Smart Composer機能のコマンドで，リソースアダプタおよびJ2EEアプリケーションをManagement Serverに登録してデプロイしている必要があります。Smart Composer機能のコマンドを使用したリソースアダプタおよびJ2EEアプリケーションのデプロイについては，「6.11.2(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始」および「6.11.3　J2EEアプリケーションのインポートと開始」を参照してください。

リソースアダプタの一括停止には，cmx_stop_resourceコマンドを使用します。J2EEアプリケーションの一括停止には，cmx_stop_applicationコマンドを使用します。それぞれのコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

7.3　システムのメンテナンス

Smart Composer機能で構築したシステムは，サービスユニットを閉塞することでシステムを部分的に点検したり，J2EEアプリケーションを入れ替えたりして，システムのメンテナンスができます。

ここでは，システムのメンテナンスについて説明します。

＜この節の構成＞

7.3.1　サービスユニットの閉塞によるシステムの部分メンテナンス

7.3.2　J2EEアプリケーションの入れ替え

7.3.1　サービスユニットの閉塞によるシステムの部分メンテナンス

Smart Composer機能では，サービスユニット単位で一括起動および一括停止のコマンドを実行できるので，業務全体を停止することなく，特定のサービスユニットを閉塞したり，再開したりできます。これによって，OSのパッチ適用や予防保守・点検などのシステムの部分メンテナンスを，業務を停止しないで実施できます。

さらに，サービスユニットの閉塞・メンテナンス・再開の処理をサービスユニット単位に順次適用することで，業務全体を停止することなく，システム全体のメンテナンスも実施できます。

ここでは，サービスユニットを閉塞して，システムの部分メンテナンスをするときの手順について説明します。

メンテナンスをしたいサービスユニットを閉塞します。
サービスユニットを閉塞するには，サービスユニットをWebシステムから切り離す方法と，サービスユニットをWebシステムから切り離して停止する方法の二つがあります。どちらの方法もcmx_stop_targetコマンドを使用しますが，コマンドの-modeオプションに指定する値が異なります。
アプリケーションの入れ替えなどの場合は「HOLD」を指定してサービスユニットをWebシステムから切り離します。OSのメンテナンスでマシンの再起動が必要な場合などの場合は「ALL」を指定して，サービスユニットをWebシステムから切り離して停止します。
なお，サービスユニットをWebシステムから切り離すだけの場合は，実行中のリクエストを処理したあとは，最終的にサービスユニット内の論理Webサーバだけが停止した状態になります。

サービスユニットをWebシステムから切り離す方法
-modeオプションに「HOLD」を指定します。サービスユニット「unit1」を閉塞状態にして，Webシステムから切り離します。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem -unit unit1

サービスユニットをWebシステムから切り離して，停止する方法
-modeオプションに「ALL」を指定します。サービスユニット「unit1」を停止状態にして，Webシステムから切り離します。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

閉塞したサービスユニットをメンテナンスします。
閉塞したサービスユニットに対して，OSのパッチ適用や予防保守・点検などのメンテナンスを実施します。

サービスユニットを再開します。
cmx_start_targetコマンドを使用してサービスユニット「unit1」を再開します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

7.3.2　J2EEアプリケーションの入れ替え

J2EEアプリケーションを入れ替える手順には，リデプロイによる入れ替えと通常の入れ替えの2種類があります。ここでは，それぞれの手順について，次のJ2EEアプリケーションを使用する場合を例にして説明します。

表7-1　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
入れ替え前のファイル名 | MyApp.ear
入れ替え後のファイル名 | MyApp-1_1.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，すべてサービスユニット1を対象としています。サービスユニット2に対しても，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

J2EEサーバ名：cmx_MyWebSystem_unit2_J2EE_01

-nameserver指定値：corbaname::192.168.1.12:900

参考

リロードによる入れ替え

入れ替えの対象となるJ2EEアプリケーションが展開ディレクトリ形式の場合，リロードによる入れ替えができます。

リロードによる入れ替えの方法については，マニュアル「Cosminexus　システム運用ガイド」のJ2EEアプリケーションの入れ替えと保守に関する説明を参照してください。また，リロードによる入れ替えを実行するには，事前に設定が必要です。設定方法の詳細は，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの更新検知とリロードの設定に関する説明を参照してください。

＜この項の構成＞

(1)　リデプロイによる入れ替え

(2)　通常の入れ替え

(1)　リデプロイによる入れ替え

アーカイブ形式のJ2EEアプリケーションを入れ替える場合には，リデプロイによる入れ替えが実行できます。リデプロイによる入れ替えを実行すると，少ない手順でJ2EEアプリケーションを入れ替えられます。

リデプロイによるJ2EEアプリケーションの入れ替えには，実施する際の注意事項や条件があります。詳細については，マニュアル「Cosminexus　システム運用ガイド」のリデプロイによるJ2EEアプリケーションの入れ替えに関する説明を参照してください。

J2EEアプリケーションのリデプロイによる入れ替えの手順を次に示します。

システムの状態に応じて，システムを起動または閉塞します。
システムが停止している場合は，システム全体を起動します。システムが稼働している場合はシステム全体を閉塞します。

システムが停止している場合
cmx_start_targetコマンドを使用して一括起動します。このとき，コマンドの-modeオプションに「READY」を指定して，サービスユニットを準備状態※にします。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

システムが稼働している場合
cmx_stop_targetコマンドを使用して一括停止します。このとき，コマンドの-modeオプションに「HOLD」を指定して，サービスユニットを閉塞状態※にします。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem

注※

どちらも負荷分散機からのリクエストの振り分けが抑止されている状態になります。準備状態と閉塞状態の差異は，論理Webサーバが停止しているかどうかだけとなります。閉塞状態のときは論理Webサーバが停止しています。

入れ替えるEARファイルのパスを指定して，リデプロイします。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjreplaceapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -f MyApp-1_1.ear

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjreplaceapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -f MyApp-1_1.ear

手順2.をサービスユニット1およびサービスユニット2で実施したあとで，システム全体を一括起動します。
cmx_start_targetコマンドを使用して，システムを一括起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

参考

CTMを使用する構成のシステムでは，システムを閉塞しないでバックシステムのアプリケーションを入れ替えることができます。そのため，CTMを使用する構成のシステムでは，手順1.と手順3.が不要です。

(2)　通常の入れ替え

J2EEアプリケーションの通常の入れ替えとは，変更前のJ2EEアプリケーションを削除し，変更後のJ2EEアプリケーションをインポートすることです。J2EEアプリケーションの通常の入れ替えの手順を次に示します。

システムの状態に応じて，システムを起動または閉塞します。
システムが停止している場合は，システム全体を起動します。システムが稼働している場合はシステム全体を閉塞します。

システムが停止している場合
cmx_start_targetコマンドを使用して一括起動します。このとき，コマンドの-modeオプションに「READY」を指定して，サービスユニットを準備状態※にします。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem

システムが稼働している場合
cmx_stop_targetコマンドを使用して一括停止します。このとき，コマンドの-modeオプションに「HOLD」を指定して，サービスユニットを閉塞状態※にします。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem

注※

どちらも負荷分散機からのリクエストの振り分けが抑止されている状態になります。準備状態と閉塞状態の差異は，論理Webサーバが停止しているかどうかだけとなります。閉塞状態のときは論理Webサーバが停止しています。

J2EEアプリケーションを停止します。
サーバ管理コマンドを使用して，J2EEアプリケーションを停止します。-nameオプションには，J2EEアプリケーション名を指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

入れ替え前のJ2EEアプリケーションを削除します。
サーバ管理コマンドを使用して，J2EEアプリケーションを削除します。-nameオプションには，削除するJ2EEアプリケーション名を指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjdeleteapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjdeleteapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

入れ替え後のJ2EEアプリケーションをインポートします。
サーバ管理コマンドを使用して，入れ替え後のJ2EEアプリケーションをインポートします。-fオプションには，入れ替え後のJ2EEアプリケーションのパスを指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp-1_1.ear

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp-1_1.ear

J2EEアプリケーションに必要な情報を設定，およびカスタマイズします。
サーバ管理コマンドを使用して，J2EEアプリケーションに必要な情報を設定，およびカスタマイズします。cjgetapppropコマンドでアプリケーション統合属性ファイルを取得して，ファイルを編集してから，cjsetapppropコマンドを実行して設定します。-nameオプションには，J2EEアプリケーション名を指定します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

J2EEアプリケーションを開始します。
サーバ管理コマンドを使用して，J2EEアプリケーションを開始します。-nameオプションには，J2EEアプリケーション名を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name Myapp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

手順2.から6.までをサービスユニット1およびサービスユニット2で実施したあとで，システム全体を一括起動します。
cmx_start_targetコマンドを使用して，システムを一括起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

参考

CTMを使用する構成のシステムでは，システムを閉塞しないでバックシステムのアプリケーションを入れ替えることができます。そのため，CTMを使用する場合の構成のシステムでは，手順1.と手順7.が不要です。

7.4　システム全体の設定変更

Smart Composer機能では，システム全体の設定を変更できます。ここでは，システム全体の設定変更について説明します。

＜この節の構成＞

7.4.1　システムの設定の一括変更

7.4.2　システム全体の設定変更時の注意事項

7.4.1　システムの設定の一括変更

Smart Composer機能を使用して，システムの設定を一括変更できます。設定を変更するには，次の内容を実施します。

簡易構築定義ファイルの編集

設定の一括変更

注意

変更する設定内容によっては，変更時に注意が必要です。設定変更時の注意事項については，「7.4.2　システム全体の設定変更時の注意事項」を参照してください。

システムの設定の一括変更の手順について，説明します。

＜この項の構成＞

(1)　簡易構築定義ファイルの編集

(2)　設定の一括変更

(1)　簡易構築定義ファイルの編集

実際のシステムの構築に使用した簡易構築定義ファイルの内容を編集します。ここでは，MyWebSystemDef.xmlファイルを編集します。

実際のシステムの構築に使用した簡易構築定義ファイルを編集します。
ここでは，Webサーバの停止監視時間を5分に変更して，J2EEサーバの稼働性能を監視するように設定します。
設定後のMyWebSystemDef.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">    <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
       ：
   </load-balancer>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- Webサーバの停止監視時間を5分に設定 -->
     <configuration>
       <logical-server-type>web-server</logical-server-type>
       <param>
         <param-name>mstartup.watchtime</param-name>
         <param-value>300</param-value>
       </param>
     </configuration>
     <!-- J2EEサーバの稼働性能監視を行う設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>ejbserver.instrumentation.enabled</param-name>
         <param-value>true</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     ：
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   ：
 </host>
 </web-system>
</model-definition>

注　太字の部分が編集部分です。

なお，物理ティアに指定できるパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

(2)　設定の一括変更

変更した簡易構築定義ファイルの内容を基に，システムの設定を一括で変更します。

システムが稼働している場合は，システムを停止します（必要に応じて）。
cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを一括停止します。このとき，コマンドの-modeオプションに「ALL」を指定して，停止状態にします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

変更した簡易構築定義ファイルの内容を実際のシステムに展開します。
cmx_build_systemコマンドに-changeオプションを指定して，(1)で変更した簡易構築定義ファイルの内容を実際のシステムに適用します。-fオプションには，(1)で作成した簡易構築定義ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml -change

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml -change

システムを開始します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

7.4.2　システム全体の設定変更時の注意事項

Smart Composer機能を使用して，システム全体の設定を変更する場合の，注意事項について説明します。

＜この項の構成＞

(1)　Webサーバのポート番号変更時の注意事項

(1)　Webサーバのポート番号変更時の注意事項

サーバマシン内に複数のサービスユニットを配置する場合に，Webサーバのポート番号を変更するときは，次に示す制限事項があります。なお，複数のサービスユニットが，同一のWebシステム内にある場合も，異なるWebシステムにある場合も，この制限事項の対象となります。

(a)　複数のサービスユニットのWebサーバで同じポート番号を設定している場合

1台のサーバマシン内で，複数のサービスユニットを同時に起動しない運用をする場合は，各サービスユニットのWebサーバに同じポート番号を設定できます。

この場合は，次のどちらかの手順で変更してください。

すべてのサービスユニットのWebサーバのポート番号を同時に変更します。

一部のサービスユニットのWebサーバのポート番号を変更します。そのあと，ほかのサービスユニットのWebサーバのポート番号を変更します。

注意

一部のサービスユニットのWebサーバのポート番号を変更した場合，ほかのサービスユニットのWebサーバのポート番号は削除され，ポート番号を削除されたWebサーバは使用できなくなります。このため，必ず，あとからほかのサービスユニットのWebサーバのポート番号も変更してください。

(b)　複数のサービスユニットのWebサーバで異なるポート番号を設定している場合

ここでは，サービスユニット１（unit1）のWebサーバでポート番号に80，サービスユニット2（unit2）のWebサーバでポート番号に81を設定している場合を例に説明します。ポート番号の設定変更の方法と変更可否を次の表に示します。

表7-2　ポート番号の変更方法と変更可否

ポート番号の変更方法 | 論理サーバのパラメタ変更用の構成変更定義ファイルの設定方法 | 変更後のWebサーバのポート番号 | 変更可否
unit1 | unit2
各サービスユニットのWebサーバのポート番号を同じ番号へ変更 | サービスユニット1のWebサーバにポート番号81を設定します。 | 81 | 81 | ○
サービスユニット2のWebサーバにポート番号80を設定します。 | 80 | 80 | ○
各サービスユニットのWebサーバのポート番号の入れ替え | サービスユニット1のWebサーバにポート番号81を，サービスユニット2のWebサーバにポート番号80を設定します。 | 81 | 80 | ×
一方のサービスユニットのWebサーバを他方で設定済みのポート番号に変更して，他方のサービスユニットのWebサーバを未使用のポート番号（82とする）へ変更 | サービスユニット1のWebサーバにポート番号81を，サービスユニット2のWebサーバにポート番号82を設定します。 | 81 | 82 | ×
サービスユニット1のWebサーバにポート番号82を，サービスユニット2のWebサーバにポート番号80を設定します。 | 82 | 80 | ×
一方のサービスユニットのWebサーバを未使用のポート番号（82とする）へ変更 | サービスユニット1のWebサーバにポート番号82を設定します。 | 82 | 81 | ○
サービスユニット2のWebサーバにポート番号82を設定します。 | 80 | 82 | ○

（凡例）○：変更できます。　×：変更できません。

参考

設定済みのポート番号に変更する場合に，1回の操作で変更できない変更方法は，いったん未使用のポート番号を設定してから入れ替えたり，複数回に分けて変更したりするなどの，設定変更操作を実施すれば変更できます。

7.5　システムのスケールアウト

Smart Composer機能を使用すると，業務全体を停止することなく，システムの構成を変更できます。システムの規模を拡張する場合は，システムをスケールアウトします。

Smart Composer機能を使用して構築できるシステムと，システムのスケールアウト手順の参照先を次の表に示します。なお，Smart Composer機能を使用して構築できるシステムの構成パターンについては，「4.3　システム構成パターン」を参照してください。

表7-3　Smart Composer機能を使用して構築できるシステムと，システムのスケールアウト手順の参照先

システムの構成パターン | システムのスケールアウト手順の参照先
WebサーバとJ2EEサーバを同じサーバマシンに配置する構成（combined-tier構成） | 「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」
WebサーバとJ2EEサーバを別のサーバマシンに配置する構成（http-tierとj2ee-tierを組み合わせた構成） | 「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」
負荷分散機を冗長化する構成 | 「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」
セッションフェイルオーバ機能を使用する構成 | 「7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト」
CTMを使用する構成 | 「7.5.3　CTMを使用したシステムのスケールアウト」
サーバマシン内に複数のサービスユニットを配置する構成 | 「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」
論理ユーザサーバを使用する構成 | 「7.5.4　論理ユーザサーバを使用したシステムのスケールアウト」

なお，追加するアプリケーションサーバのセットアップに，JP1/SC/DPMのディスク複製OSインストール機能を利用することもできます。この機能を利用すると，すでに稼働しているホストの環境を複製して，新規に作成するホストに対してOSや必要なアプリケーションのインストール，および環境設定が一括で操作できます。JP1/SC/DPMを利用する場合の，システムのスケールアウトの手順については，「7.7　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン」を参照してください。

＜この節の構成＞

7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト

7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト

7.5.3　CTMを使用したシステムのスケールアウト

7.5.4　論理ユーザサーバを使用したシステムのスケールアウト

7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト

「6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例」を基に構築したシステムをスケールアウトする手順について説明します。

システムをスケールアウトする前に，あらかじめ追加するアプリケーションサーバのOSやアプリケーションをセットアップしてください。システムをスケールアウトするには，次の内容を実施します。

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの追加

システムのスケールアウトの手順について説明します。

なお，ここでは，次に示すサービスユニットを追加する場合を例にして，説明しています。

ホスト名：apsv3

サービスユニット名：unit3

IPアドレス：192.168.1.13

管理IPアドレス：192.168.100.13

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　構成変更定義ファイルの作成

(2)　システムの情報モデルの変更

(3)　サービスユニットの追加

(1)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemAdd.xml」に変更しています。

コピーした構成変更定義ファイルを編集します。
MyWebSystemAdd.xmlファイルを編集します。ここでは，追加するサービスユニットの内容と，ホストの定義をします。
設定後のMyWebSystemAdd.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyWebSystem</name>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv3</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>

 </web-system>
 <!-- 追加するホストの定義 -->
 <host>
   <host-name>apsv3</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>

</unit-addition>

注　太字の部分が編集部分です。

(2)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成した構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemAdd.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemAdd.xml

(3)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(2)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

負荷分散機からのリクエストの振り分けを抑止した状態で，追加したサービスユニットを一括起動します。
ここでは次の内容を実施しています。

cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を準備状態で起動することで，負荷分散機からのリクエストの振り分けを抑止します。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

追加したサービスユニットのリソースアダプタをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

リソースアダプタをインポートします。

J2EEサーバにリソースアダプタをデプロイします。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタの接続を確認します。

リソースアダプタを開始します。

次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表7-4　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | DBConnector_HiRDB_Type4_CP.rar
表示名 | DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名 | MyDBConnectorAttr.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

# /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml※

# /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

注※

スケールアウトの対象とするサービスユニットのリソースアダプタに反映したConnector属性ファイルを使用します。Connector属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにデプロイしたリソースアダプタからサーバ管理コマンド（cjgetrarprop）を使用して取得します。取得したConnector属性ファイルは必要に応じて編集します。

J2EEアプリケーションをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

J2EEアプリケーションをJ2EEサーバへインポートします。

アプリケーション統合属性ファイル※をJ2EEアプリケーションに反映します。

J2EEアプリケーションを開始します。

次に示すJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表7-5　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -f MyApp.ear

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -f MyApp.ear

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml※

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

注※

スケールアウトの対象とするサービスユニットのJ2EEアプリケーションに反映したアプリケーション統合属性ファイルを使用します。アプリケーション統合属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにインポートしたJ2EEアプリケーションからサーバ管理コマンド（cjgetappprop）を使用して取得します。取得したアプリケーション統合属性ファイルは必要に応じて編集します。

追加したサービスユニットを起動します。
cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト

セッションフェイルオーバ機能を使用したシステムをスケールアウトする手順について説明します。

システムをスケールアウトする前に，あらかじめ追加するアプリケーションサーバのOSやアプリケーションをセットアップしてください。システムをスケールアウトするには，次の内容を実施します。

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの追加

J2EEアプリケーションのデプロイ

システムのスケールアウトの手順について説明します。

なお，ここでは，次に示すセッションフェイルオーバ用のサービスユニットを追加する場合を例にして，説明しています。業務サービス用のサービスユニットを追加する場合の手順については，「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」を参照してください。

ホスト名：sfosv3

サービスユニット名：unit5

IPアドレス：192.168.1.15

管理IPアドレス：192.168.100.15

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，すべてサービスユニット1を対象としています。サービスユニット2に対しても，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

J2EEサーバ名：cmx_MyWebSystem_unit2_J2EE_01

-nameserver指定値：corbaname::192.168.1.12:900

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　構成変更定義ファイルの作成

(2)　システムの情報モデルの変更

(3)　サービスユニットの追加

(4)　J2EEアプリケーションのインポートと開始

(1)　構成変更定義ファイルの作成

セッションフェイルオーバ用のサービスユニットを追加する場合，次の構成変更定義ファイルが必要になります。

サービスユニット・ホスト追加用の構成変更定義ファイル
追加するセッションフェイルオーバ用のサービスユニットを定義します。

論理サーバのパラメタ変更用の構成変更定義ファイル
J2EEサーバで使用するセッションフェイルオーバ用フィルタを定義して，追加するSFOサーバとJ2EEサーバを関連づけます。

サービスユニット・ホスト追加用，および論理サーバのパラメタ変更用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

サービスユニット・ホスト追加用の構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemAddSfo.xml」に変更しています。

コピーしたサービスユニット・ホスト追加用の構成変更定義ファイルを編集します。
MyWebSystemAddSfo.xmlファイルを編集します。ここでは，追加するサービスユニットの内容と，ホストの定義をします。
設定後のMyWebSystemAddSfo.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyWebSystem</name>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit5</name>
     <allocated-host>
       <host-ref>sfosv3</host-ref>
       <hosts-for>sfo-tier</hosts-for>
       <define-server>
         <logical-server-name>sfo03</logical-server-name>
         <logical-server-type>sfo-server</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>

 </web-system>
 <!-- 追加するホストの定義 -->
 <host>
   <host-name>sfosv3</host-name>
   <agent-host>192.168.100.15</agent-host>
 </host>

</unit-addition>

注　太字の部分が編集部分です。

論理サーバのパラメタ変更用の構成変更定義ファイルを作成します。
論理サーバのパラメタ変更用の構成変更定義ファイル（cmxmodcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemMod4.xml」に変更しています。

コピーした論理サーバのパラメタ変更用の構成変更定義ファイルを編集します。
MyWebSystemMod4.xmlファイルを編集します。ここでは，J2EEサーバで使用するセッションフェイルオーバ用フィルタの追加を定義します。
設定後のMyWebSystemMod4.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<model-modification xmlns="http://www.cosminexus.com/mngsvr/schema/ModelModification-2.5">
 <web-system>
 <name>MyWebSystem</name>
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- 追加するセッションフェイルオーバ用フィルタの定義 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>webserver.sfo.sfo_servers</param-name>
         <param-value>sfoserver1,sfoserver2,sfoserver3</param-value>
       </param>
       <param>
         <param-name>webserver.sfo.sfo_server.sfoserver3.serverName</param-name>
         <param-value>sfo03</param-value>
       </param>
     </configuration>
   </tier>
 </web-system>
</model-modification>

注　太字の部分が編集部分です。

(2)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。セッションフェイルオーバ用のサービスユニットを追加する場合，(1)で作成した2種類の構成変更定義ファイルごとに，システムの情報モデルに反映する必要があります。

サービスユニット・ホスト追加用の構成変更定義ファイルを指定して，システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成したサービスユニット・ホスト追加用の構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemAddSfo.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemAddSfo.xml

論理サーバのパラメタ変更用の構成変更定義ファイルを指定して，システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成した論理サーバのパラメタ変更用の構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemMod4.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemMod4.xml

(3)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(2)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

追加したセッションフェイルオーバ用のサービスユニットを一括起動します。
ここでは次の内容を実施しています。

cmx_start_targetコマンドを使用して，追加したサービスユニット「unit5」を稼働状態で起動します。-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit5

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit5

業務サービス用のサービスユニットを停止して，起動します。システム内のすべての業務サービス用のサービスユニットに対して実施します。
ここでは次の内容を実施しています。

cmx_stop_targetコマンドを使用して，業務サービス用のサービスユニット「unit1」および「unit2」を停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

cmx_start_targetコマンドを使用して，業務サービス用のサービスユニット「unit1」および「unit2」を稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

(4)　J2EEアプリケーションのインポートと開始

追加したセッションフェイルオーバ用のサービスユニットを利用するJ2EEアプリケーションのインポートと開始をします。

次に示すJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表7-6　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp2.ear
表示名 | MyApp2
アプリケーション統合属性ファイルのファイル名 | MyAppprop2.xml

追加したセッションフェイルオーバ用のサービスユニットを利用するJ2EEアプリケーションをインポートして，プロパティを設定します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

J2EEアプリケーションをJ2EEサーバへインポートします。

アプリケーション統合属性ファイルを取得します。
取得したアプリケーション統合属性ファイルは必要に応じて編集します。

編集したアプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp2.ear

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2 -type all -c <任意のディレクトリ>¥MyAppprop2.xml

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2 -type all -c <任意のディレクトリ>¥MyAppprop2.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp2.ear

# /opt/Cosminexus/CC/admin/bin/cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2 -type all -c <任意のディレクトリ>/MyAppprop2.xml

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2 -type all -c <任意のディレクトリ>/MyAppprop2.xml

デプロイしたJ2EEアプリケーションを起動します。
サーバ管理コマンドを使用してJ2EEアプリケーションを起動します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp2

7.5.3　CTMを使用したシステムのスケールアウト

CTMを使用したシステムをスケールアウトする手順について説明します。

システムをスケールアウトする前に，あらかじめ追加するアプリケーションサーバのOSやアプリケーションをセットアップしてください。システムをスケールアウトするには，次の内容を実施します。

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの追加

システムのスケールアウトの手順について説明します。

なお，ここでは，CTM用のWebシステム（MyBackSystem）に，次に示すサービスユニットを追加する場合を例にして，説明しています。

ホスト名：ctmsv3

サービスユニット名：unit5

IPアドレス：192.168.1.35

管理IPアドレス：192.168.100.35

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　構成変更定義ファイルの作成

(2)　システムの情報モデルの変更

(3)　サービスユニットの追加

(1)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyBackSystemAdd.xml」に変更しています。

コピーした構成変更定義ファイルを編集します。
MyBackSystemAdd.xmlファイルを編集します。ここでは，追加するサービスユニットの内容と，ホストの定義をします。
設定後のMyBackSystemAdd.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyBackSystem</name>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit5</name>
     <allocated-host>
       <host-ref>ctmsv3</host-ref>
       <hosts-for>ctm-tier</hosts-for>
     </allocated-host>
   </unit>

 </web-system>
   <!-- 追加するホストの定義 -->
   <host>
     <host-name>ctmsv3</host-name>
     <agent-host>192.168.100.35</agent-host>
   </host>

</unit-addition>

注　太字の部分が編集部分です。

(2)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成した構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyBackSystemAdd.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyBackSystemAdd.xml

(3)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(2)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyBackSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyBackSystem

追加したサービスユニットを一括起動します。
ここでは次の内容を実施しています。

cmx_start_targetコマンドを使用して，追加したサービスユニット「unit5」を稼働状態で起動します。-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyBackSystem -unit unit5

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyBackSystem -unit unit5

追加したサービスユニットのリソースアダプタをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

リソースアダプタをインポートします。

J2EEサーバにリソースアダプタをデプロイします。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタの接続を確認します。

リソースアダプタを開始します。

次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表7-7　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | DBConnector_HiRDB_Type4_CP.rar
表示名 | DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名 | MyDBConnectorAttr.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -type rar -f /opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar

# /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml※

# /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900  -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -resname DB_Connector_for_HiRDB_Type4

注※

スケールアウトの対象とするサービスユニットのリソースアダプタに反映したConnector属性ファイルを使用します。Connector属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにデプロイしたリソースアダプタからサーバ管理コマンド（cjgetrarprop）を使用して取得します。取得したConnector属性ファイルは必要に応じて編集します。

J2EEアプリケーションをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。J

J2EEアプリケーションをJ2EEサーバへインポートします。

アプリケーション統合属性ファイル※をJ2EEアプリケーションに反映します。

J2EEアプリケーションを開始します。

次に示すJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表7-8　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -f MyApp.ear

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -f MyApp.ear

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.35:900 -name MyApp

注※

スケールアウトの対象とするサービスユニットのJ2EEアプリケーションに反映したアプリケーション統合属性ファイルを使用します。アプリケーション統合属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにインポートしたJ2EEアプリケーションからサーバ管理コマンド（cjgetappprop）を使用して取得します。取得したアプリケーション統合属性ファイルは必要に応じて編集します。

7.5.4　論理ユーザサーバを使用したシステムのスケールアウト

論理ユーザサーバを使用してシステムをスケールアウトする手順について説明します。

システムをスケールアウトする前に，あらかじめ追加するアプリケーションサーバのOSやアプリケーションをセットアップしてください。システムをスケールアウトするには，次の内容を実施します。

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの追加

なお，ここでは，次に示すサービスユニットを追加する場合を例にして，説明しています。

ホスト名：apsv3

サービスユニット名：unit3

IPアドレス：192.168.1.13

管理IPアドレス：192.168.100.13

論理ユーザサーバ名：UserServer4

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　構成変更定義ファイルの作成

(2)　システムの情報モデルの変更

(3)　サービスユニットの追加

(1)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemAddUser.xml」に変更しています。

コピーした構成変更定義ファイルを編集します。
MyWebSystemAddUser.xmlファイルには，追加するサービスユニット，およびサービスユニットに追加する論理ユーザサーバを定義します。
設定後のMyWebSystemAddUser.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyWebSystem</name>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv3</host-ref>
       <hosts-for>combined-tier</hosts-for>
       <define-server>
         <logical-server-name>UserServer4</logical-server-name>
         <logical-server-type>user-server</logical-server-type>
         <configuration>
           <param>
             <!-- サーバ起動用コマンド -->
             <param-name>start.arg</param-name>
             <param-value>c:/test/start.exe</param-value>
           </param>
         </configuration>
       </define-server>
     </allocated-host>
   </unit>

 </web-system>
 <!-- 追加するホストの定義 -->
 <host>
   <host-name>apsv3</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>

</unit-addition>

注　太字の部分が編集部分です

(2)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成した構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemAddUser.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemAddUser.xml

(3)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(2)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

負荷分散機からのリクエストの振り分けを抑止した状態で，追加したサービスユニットを一括起動します。
cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を準備状態で起動することで，負荷分散機からのリクエストの振り分けを抑止します。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

追加したサービスユニットのリソースアダプタをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

リソースアダプタをインポートします。

J2EEサーバにリソースアダプタをデプロイします。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタの接続を確認します。

リソースアダプタを開始します。

次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表7-9　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | DBConnector_HiRDB_Type4_CP.rar
表示名 | DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名 | MyDBConnectorAttr.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900  -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -type rar -f /opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar

# /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml※

# /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

注※

スケールアウトの対象とするサービスユニットのリソースアダプタに反映したConnector属性ファイルを使用します。Connector属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにデプロイしたリソースアダプタからサーバ管理コマンド（cjgetrarprop）を使用して取得します。取得したConnector属性ファイルは必要に応じて編集します。

J2EEアプリケーションをインポートして開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。

J2EEアプリケーションをJ2EEサーバへインポートします。

アプリケーション統合属性ファイルをJ2EEアプリケーションに反映します。

J2EEアプリケーションを開始します。

次に示すJ2EEアプリケーションをインポートして開始する手順を例にして説明します。

表7-10　例で使用するJ2EEアプリケーションのファイル名と表示名

種別 | 名前
ファイル名 | MyApp.ear
表示名 | MyApp
アプリケーション統合属性ファイルのファイル名 | MyAppprop.xml

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -f MyApp.ear

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetappprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp -type all -c <任意のディレクトリ>¥MyAppprop.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -f MyApp.ear

# /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml※

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

注※

スケールアウトの対象とするサービスユニットのJ2EEアプリケーションに反映したアプリケーション統合属性ファイルを使用します。アプリケーション統合属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにインポートしたJ2EEアプリケーションからサーバ管理コマンド（cjgetappprop）を使用して取得します。取得したアプリケーション統合属性ファイルは必要に応じて編集します。

追加したサービスユニットを起動します。
cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

7.6　システムのスケールイン

Smart Composer機能を使用すると，業務全体を停止することなく，システムの構成を変更できます。システムの規模を縮小する場合は，システムをスケールインします。

Smart Composer機能を使用して構築できるシステムと，システムのスケールイン手順の参照先を次の表に示します。なお，Smart Composer機能を使用して構築できるシステムの構成パターンについては，「4.3　システム構成パターン」を参照してください。

表7-11　Smart Composer機能を使用して構築できるシステムと，システムのスケールイン手順の参照先

システムの構成パターン | システムのスケールイン手順の参照先
WebサーバとJ2EEサーバを同じサーバマシンに配置する構成（combined-tier構成） | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」
WebサーバとJ2EEサーバを別のサーバマシンに配置する構成（http-tierとj2ee-tierを組み合わせた構成） | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」
負荷分散機を冗長化する構成 | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」
セッションフェイルオーバ機能を使用する構成 | 「7.6.2　セッションフェイルオーバ機能を使用したシステムのスケールイン」
CTMを使用する構成 | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」
サーバマシン内に複数のサービスユニットを配置する構成 | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」
論理ユーザサーバを使用する構成 | 「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」

＜この節の構成＞

7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン

7.6.2　セッションフェイルオーバ機能を使用したシステムのスケールイン

7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン

「7.5.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト」，および「7.5.4　論理ユーザサーバを使用したシステムのスケールアウト」で追加したサービスユニットを削除する場合を例にして，説明しています。このため，削除するサービスユニット名は「unit3」となります。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

サービスユニットを削除します。
削除するサービスユニットを停止して，システムの情報モデルから削除します。なお，削除するサービスユニットは実行中のリクエストの処理を完了してから停止します。
ここでは次の内容を実施しています。

cmx_stop_targetコマンドを使用して，削除するサービスユニット「unit3」を一括停止します。このとき，コマンドの-modeオプションで「ALL」を指定して，停止状態にします。

cmx_delete_systemコマンドを使用して，サービスユニット「unit3」を削除します。なお，このコマンドを実行すると，Management Serverに登録されたシステムの情報モデルと負荷分散機に設定した情報は削除されます。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit3

cmx_delete_systemコマンドについて

J2EEサーバやWebサーバの環境削除などのアンセットアップを実行しません。cmx_delete_systemコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。

参考

Webシステムを削除して，Webシステム単位でもスケールインできます。この場合は，cmx_stop_targetコマンドおよびcmx_delete_systemコマンドで，削除対象のWebシステムを指定します。各コマンドの詳細については，「12.3　コマンドの詳細」の「cmx_stop_target」および「cmx_delete_system」を参照してください。

注意

cmx_delete_systemコマンドを実行すると，Management Serverに登録された論理ユーザサーバも同時に削除されます。論理ユーザサーバを削除したくないときは，cmx_delete_serverrefコマンドで論理ユーザサーバと削除対象のサービスユニットの関連を削除したあとに，cmx_delete_systemコマンドを実行してください。

7.6.2　セッションフェイルオーバ機能を使用したシステムのスケールイン

セッションフェイルオーバ機能を使用したシステムをスケールインする手順について説明します。システムをスケールインするには，次の内容を実施します。

J2EEアプリケーションのアンデプロイ

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの削除

システムのスケールインの手順について説明します。

なお，ここでは，「7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト」で追加した，セッションフェイルオーバ用のサービスユニットを削除する場合を例にして，説明しています。このため，削除するサービスユニット名は「unit5」となります。業務サービス用のサービスユニットを削除する場合の手順については，「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」を参照してください。

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　J2EEアプリケーションのアンデプロイ

(2)　構成変更定義ファイルの作成

(3)　システムの情報モデルの変更

(4)　サービスユニットの削除

(1)　J2EEアプリケーションのアンデプロイ

削除するセッションフェイルオーバ用のサービスユニットを利用しているJ2EEアプリケーションを，システムからアンデプロイします。ここでは，「7.5.2　セッションフェイルオーバ機能を使用したシステムのスケールアウト」でデプロイしたJ2EEアプリケーションをアンデプロイする場合を例にして，説明しています。このため，アンデプロイするJ2EEアプリケーションのファイル名は「MyApp2.ear」，表示名は「MyApp2」となります。

削除するセッションフェイルオーバ用のサービスユニットを利用しているJ2EEアプリケーションを停止し，アンデプロイします。

ここでは次の内容を実施しています。

サーバ管理コマンドを使用して，J2EEアプリケーションが稼働している場合は停止します（必要に応じて）。

サーバ管理コマンドを使用して，J2EEアプリケーションを削除します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstopapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.15:900 -name MyApp2

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjdeleteapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.15:900 -name MyApp2

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.15:900 -name MyApp2

# /opt/Cosminexus/CC/admin/bin/cjdeleteapp cmx_MyWebSystem_unit5_J2EE_01 -nameserver corbaname::192.168.1.15:900 -name MyApp2

(2)　構成変更定義ファイルの作成

論理サーバのパラメタ変更用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

論理サーバのパラメタ変更用の構成変更定義ファイルを作成します。
論理サーバのパラメタ変更用の構成変更定義ファイル（cmxmodcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemMod5.xml」に変更しています。

コピーした論理サーバのパラメタ変更用の構成変更定義ファイルを編集します。
MyWebSystemMod5.xmlファイルを編集します。ここでは，J2EEサーバから削除するセッションフェイルオーバ用フィルタの定義をします。
設定後のMyWebSystemMod5.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<model-modification xmlns="http://www.cosminexus.com/mngsvr/schema/ModelModification-2.1">
 <web-system>
 <name>MyWebSystem</name>
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- 削除するセッションフェイルオーバ用フィルタの定義 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>webserver.sfo.sfo_servers</param-name>
         <param-value>sfoserver1,sfoserver2</param-value>
       </param>
       <param>
         <param-name>webserver.sfo.sfo_server.sfoserver3.serverName</param-name>
       </param>
     </configuration>
   </tier>
 </web-system>
</model-modification>

注　太字の部分が編集部分です。

(3)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(2)で作成した論理サーバのパラメタ変更用の構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MMyWebSystemMod5.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemMod5.xml

変更したシステムの情報モデルを実システムに適用します。
cmx_build_systemコマンドを使用して，変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

(4)　サービスユニットの削除

セッションフェイルオーバ用のサービスユニットを，システムから削除します。

業務サービス用のサービスユニットを停止して，起動します。Webシステム内のすべての業務サービス用のサービスユニットに対して実施します。
ここでは次の内容を実施しています。

cmx_stop_targetコマンドを使用して，業務サービス用のサービスユニット「unit1」および「unit2」を停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

cmx_start_targetコマンドを使用して，業務サービス用のサービスユニット「unit1」および「unit2」を稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit2

セッションフェイルオーバ用のサービスユニットを停止します。
cmx_stop_targetコマンドを使用して，サービスユニット「unit5」を停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit5

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit5

セッションフェイルオーバ用のサービスユニットを削除します。
cmx_delete_systemコマンドを使用して，サービスユニット「unit5」を削除します。なお，このコマンドを実行すると，Management Serverに登録されたシステムの情報モデルに設定した情報は削除されます。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit5

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit5

7.7　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

Smart Composer機能を使用してシステムをスケールアウトする場合に，追加するアプリケーションサーバのセットアップにJP1/SC/DPMのディスク複製OSインストール機能を利用できます。この場合，通常のシステムのスケールアウトの手順の前に，複製元のディスクイメージを作成する準備が必要です。JP1/SC/DPMを利用すると，運用管理サーバモデルおよびホスト単位管理モデルでシステムを構築できます。

ここでは，JP1/SC/DPMを利用してシステムをスケールアウトする手順を，モデルごとに説明します。また，JP1/SC/DPMを利用して構築したシステムをスケールインする手順を説明します。

注意

セッションフェイルオーバ機能を使用するシステムの場合，セッションフェイルオーバサーバマシンでは，JP1/SC/DPMと連携したスケールアウトを利用できません。

＜この節の構成＞

7.7.1　運用管理サーバモデルでのシステムのスケールアウト

7.7.2　ホスト単位管理モデルでのシステムのスケールアウト

7.7.3　JP1/SC/DPMを利用して構築したシステムのスケールイン

7.7.1　運用管理サーバモデルでのシステムのスケールアウト

ここでは，運用管理サーバモデルでの，システムのスケールアウトの準備およびスケールアウトで実施する内容について説明します。

スケールアウトの準備

システムのスケールアウトの準備とは，複製元のディスクイメージを作成する作業です。システム構築が終わって，運用環境が整ったところで実施します。スケールアウトの準備では次の内容を実施します。

複製元アプリケーションサーバでの準備

スケールアウト用ディスクイメージの作成

スケールアウト

複製したディスクイメージを使用して，スケールアウトをします。スケールアウトでは，次の内容を実施します。

ディスクイメージのリストア

構成変更定義ファイルの作成

システムの情報モデルの変更（サービスユニットの追加）

注意

JP1/AJS2 - SOを使用してシステムのスケールアウトを自動化する場合

JP1/SC/DPMを使用したシステムのスケールアウトを，JP1/AJS2 - SOを使用して自動化する場合，ディスク複製インストール（リストア）が完了してから運用管理エージェントを自動起動するように設定する必要があります。設定方法については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。また，JP1/AJS2 - SOとの連携については，「15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用」を参照してください。

ここでは，「6.1.1　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムの構築例」を基に構築したシステムで，JP1/SC/DPMを利用して，システムをスケールアウトする手順について説明します。JP1/SC/DPMを利用したスケールアウトの例を次の図に示します。

図7-1　JP1/SC/DPMを利用したスケールアウトの例（運用管理サーバモデルの場合）

この図では，JP1/SC/DPMを使用して，サービスユニット1を構成する複製元アプリケーションサーバのディスクイメージを複製し，そのディスクイメージに従って，新たなアプリケーションサーバにOSやアプリケーションをインストールします。次に，Smart Composer機能のコマンドを使用して，サービスユニット3をシステムにスケールアウトします。この例で使用するサービスユニットの設定例を次の表に示します。

表7-12　サービスユニットの設定例（運用管理サーバモデルの場合）

設定項目 | 複製元のサービスユニット | 追加するサービスユニット
ホスト名 | apsv1 | apsv3
サービスユニット名 | unit1 | unit3
IPアドレス | 192.168.1.11 | 192.168.1.13
管理IPアドレス | 192.168.100.11 | 192.168.100.13

なお，Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

＜この項の構成＞

(1)　複製元アプリケーションサーバでの準備

(2)　JP1/SC/DPMを使用したスケールアウト用ディスクイメージの作成

(3)　JP1/SC/DPMを使用したディスクイメージのリストア

(4)　構成変更定義ファイルの作成

(5)　システムの情報モデルの変更（サービスユニットの追加）

(1)　複製元アプリケーションサーバでの準備

複製元アプリケーションサーバで，JP1/SC/DPMによるディスクイメージ作成のための準備をします。

リソースアダプタおよびJ2EEアプリケーションを一括停止します（必要に応じて）。
複製先アプリケーションサーバで，リソースアダプタおよびJ2EEアプリケーションを自動で開始する場合には，この操作は不要です。
ここでは，次の内容を実施します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のJ2EEアプリケーションを停止します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のリソースアダプタを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name Myapp

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

Linuxの場合

# /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

# /opt/Cosminexus/CC/admin/bin/cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

サービスユニット，および運用管理エージェントを停止します。
ここでは，次の内容を実施します。

cmx_stop_targetコマンドを使用して，サービスユニット「unit1」を停止します。

adminagentctlコマンドを使用して，運用管理エージェントを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl stop

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

# /opt/Cosminexus/manager/bin/adminagentctl stop

運用管理エージェントのサービスを手動起動に設定します。
ここでは，次の内容を実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun -d

Linuxの場合

# rm /etc/rc.d/rc2.d/S80AdminAgent

デフォルトのJ2EEサーバをアンセットアップします。
インストール時にホスト名で作成されているデフォルトのJ2EEサーバをアンセットアップします。
ここでは，次の内容を実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d apsv1

Linuxの場合

# /opt/Cosminexus/CC/server/bin/cjsetup -d apsv1

ログを削除します。
ログファイルを削除します。削除対象ログファイルが格納されているディレクトリについては，「付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル」を参照してください。

注意

JP1/SC/DPMを使用してスケールアウトする場合，複製先アプリケーションサーバマシンが複数のIPアドレスで構成されているときは，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.adapter.bind_hostキーに設定するIPアドレスを正規表現で指定する必要があります。これは，スケールアウトするマシンはIPアドレスが変わり，固定のIPアドレスが指定できないためです。なお，adminagent.properties（運用管理エージェントプロパティファイル）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　JP1/SC/DPMを使用したスケールアウト用ディスクイメージの作成

JP1/SC/DPMを使用して複製元アプリケーションサーバからディスクイメージを作成します。なお，複製元アプリケーションサーバは，ディスクイメージの作成後，業務を再開します。

スケールアウト用ディスクイメージを作成します。
複製元アプリケーションサーバから，スケールアウト用のディスクイメージを作成します。なお，詳細については，マニュアル「JP1/ServerConductor/Deployment Manager」のディスク複製OSインストール機能の説明を参照してください。

運用管理エージェントを開始します。
adminagentctlコマンドを使用して，運用管理エージェントを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

Linuxの場合

# /opt/Cosminexus/manager/bin/adminagentctl start

なお，必要に応じて，運用管理エージェントの自動起動を再設定してください。設定方法については，「6.5.3(2)　運用管理エージェントの自動起動の設定」を参照してください。

リソースアダプタおよびJ2EEアプリケーションを開始します（必要に応じて）。
リソースアダプタおよびJ2EEアプリケーションを自動で開始する場合，この操作は不要です。
ここでは，次の内容を実施します。

cmx_start_targetコマンドを使用して，サービスユニット「unit1」を準備状態で起動します。準備状態にするには，-modeオプションに「READY」を指定します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のリソースアダプタを開始します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のJ2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit1

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit1

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

サービスユニットを開始します。
cmx_start_targetコマンドを使用して，サービスユニット「unit1」を稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

(3)　JP1/SC/DPMを使用したディスクイメージのリストア

作成したディスクイメージを，サービスユニットを追加するアプリケーションサーバにリストアします。なお，リストアの操作手順については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。

また，追加したアプリケーションサーバの運用管理エージェントを起動する場合は，ここで実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

Linuxの場合

# /opt/Cosminexus/manager/bin/adminagentctl start

なお，運用管理エージェントの自動起動の設定については，「6.5.3(2)　運用管理エージェントの自動起動の設定」を参照してください。

(4)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

Linuxの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemAdd.xml」に変更しています。

コピーした構成変更定義ファイルを編集します。
MyWebSystemAdd.xmlファイルを編集します。ここでは，追加するサービスユニットの内容と，ホストの定義をします。また，<addition-mode>タグを追加し，「DEPLOYED」を指定してください。
設定後のMyWebSystemAdd.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyWebSystem</name>
   <addition-mode>DEPLOYED</addition-mode>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv3</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>

 </web-system>
 <!-- 追加するホストの定義 -->
 <host>
   <host-name>apsv3</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>

</unit-addition>

注　太字の部分が編集部分です。

(5)　システムの情報モデルの変更（サービスユニットの追加）

作成した構成変更定義ファイルの内容を，Management Serverのシステムの情報モデルに反映します。変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(4)で作成した構成変更定義ファイルを指定して，Management Serverのシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemAdd.xml

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemAdd.xml

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(5)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

負荷分散機からのリクエストの振り分けを抑止した状態で，追加したサービスユニットを一括起動します。
ここでは次の内容を実施しています。

cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を準備状態で起動することで，負荷分散機からのリクエストの振り分けを抑止します。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem -unit unit3

リソースアダプタおよびJ2EEアプリケーションを開始します（必要に応じて）。
リソースアダプタおよびJ2EEアプリケーションが自動で開始しない場合は，最初に，リソースアダプタおよびJ2EEアプリケーションを一括開始します。JP1/SC/DPMを使用してディスクイメージを作成するときに，複製元アプリケーションサーバでリソースアダプタおよびJ2EEアプリケーションを一括停止しなかった場合，この操作は必要ありません。
ここでは次の内容を実施しています。

サーバ管理コマンドを使用して，サービスユニット「unit3」のリソースアダプタを開始します。

サーバ管理コマンドを使用して，サービスユニット「unit3」のJ2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

Linuxの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit3_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

追加したサービスユニットを一括起動します。
cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

7.7.2　ホスト単位管理モデルでのシステムのスケールアウト

ここでは，ホスト単位管理モデルでの，システムのスケールアウトの準備およびスケールアウトで実施する内容について説明します。

スケールアウトの準備

システムのスケールアウトの準備とは，複製元のディスクイメージを作成する作業です。システム構築が終わって，運用環境が整ったところで実施します。スケールアウトの準備では次の内容を実施します。

複製元アプリケーションサーバでの準備

スケールアウト用ディスクイメージの作成

スケールアウト

複製したディスクイメージを使用して，スケールアウトをします。スケールアウトでは，次の内容を実施します。

ディスクイメージのリストア

スケールアウト用ホスト定義ファイルの作成

システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

注意

JP1/AJS2 - SOを使用してシステムのスケールアウトを自動化する場合

JP1/SC/DPMを使用したシステムのスケールアウトを，JP1/AJS2 - SOを使用して自動化する場合，ディスク複製インストール（リストア）が完了してから運用管理エージェントを自動起動するように設定する必要があります。設定方法については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。また，JP1/AJS2 - SOとの連携については，「15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用」を参照してください。

ここで使用するJP1/SC/DPMを利用したスケールアウトの例を次の図に示します。

図7-2　JP1/SC/DPMを利用したスケールアウトの例（ホスト単位管理モデルの場合）

この図では，JP1/SC/DPMを使用して，アプリケーションサーバ1のディスクイメージを複製し，そのディスクイメージに従って，新たなアプリケーションサーバにOSやアプリケーションをインストールします。次に，Smart Composer機能のコマンドを使用して，複製先アプリケーションサーバの情報をシステムにスケールアウトします。この例で使用するアプリケーションサーバの設定例を次の表に示します。

表7-13　各アプリケーションサーバの設定例（ホスト単位管理モデルの場合）

設定項目 | 複製元アプリケーションサーバ | 複製先アプリケーションサーバ
Webシステム | Webシステム名 | MyWebSystem1 | MyWebSystem1※1
負荷分散機 | リクエストの振り分け先を識別するサーバID※2 | 1024-2048 | 2049-3073
サービスユニット | サービスユニット名 | unit1 | unit1※1
ホスト名 | apsv1 | apsv1※1
ホスト | ホスト名 | apsv1 | apsv1※1
IPアドレス | 192.168.1.11 | 192.168.1.13
管理IPアドレス | 192.168.100.11 | 192.168.100.13

注※1

アプリケーションサーバ（運用管理ドメイン）ごと複製するため，複製先アプリケーションサーバのWebシステム，サービスユニット，ホストの名称は，複製元と同じになります。

注※2

同じWebシステム間では，負荷分散機の仮想サーバを共有します。このため，リクエストの振り分け先を識別するサーバID（<server-id-rule>タグ）は，負荷分散機の仮想サーバ内で一意になるように設定してください。

なお，Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8　システムの構成定義」で，実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

＜この項の構成＞

(1)　複製元アプリケーションサーバでの準備

(2)　JP1/SC/DPMを使用したスケールアウト用ディスクイメージの作成

(3)　JP1/SC/DPMを使用したディスクイメージのリストア

(4)　スケールアウト用ホスト定義ファイルの作成

(5)　システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

(1)　複製元アプリケーションサーバでの準備

複製元アプリケーションサーバで，JP1/SC/DPMによるディスクイメージ作成のための準備をします。

リソースアダプタおよびJ2EEアプリケーションを停止します（必要に応じて）。
複製先アプリケーションサーバで，リソースアダプタおよびJ2EEアプリケーションを自動で開始する場合には，この操作は不要です。
ここでは，次の内容を実施します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のJ2EEアプリケーションを停止します。

サーバ管理コマンドを使用して，サービスユニット「unit1」のリソースアダプタを停止します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

Linuxの場合

# /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

# /opt/Cosminexus/CC/admin/bin/cjstoprar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

サービスユニット，運用管理エージェント，およびManagement Serverを停止します。
ここでは，次の内容を実施します。

cmx_stop_targetコマンドを使用して，サービスユニット「unit1」を停止します。

adminagentctlコマンドを使用して，運用管理エージェントを停止します。

mngsvrctlコマンドを使用して，Management Serverを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl stop

<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl stop

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

# /opt/Cosminexus/manager/bin/adminagentctl stop

# /opt/Cosminexus/manager/bin/mngsvrctl stop

運用管理エージェント，およびManagement Serverのサービスを手動起動に設定します。
ここでは，次の内容を実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥mngautorun -d

Linuxの場合

# rm /etc/rc.d/rc2.d/S80AdminAgent
# rm /etc/rc.d/rc2.d/S90MngSvr

デフォルトのJ2EEサーバをアンセットアップします。
インストール時にホスト名で作成されているデフォルトのJ2EEサーバをアンセットアップします。
ここでは，次の内容を実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d apsv1

Linuxの場合

# /opt/Cosminexus/CC/server/bin/cjsetup -d apsv1

ログを削除します。
ログファイルを削除します。削除対象ログファイルが格納されているディレクトリについては，「付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル」を参照してください。

次のファイルを編集します。
編集対象のファイルおよびキーと，指定値を次の表に示します。

表7-14　編集対象のファイルおよびキーと，指定値

ファイル名称
キー名称
指定値

.cmxrc（クライアント設定プロパティファイル）
cmx.lb
keepvs

cmxclient.properties（クライアント共通設定プロパティファイル）
cmx.lb
keepvs

adminagent.properties（運用管理エージェントプロパティファイル）
adminagent.adapter.allowedHosts※
mserver.properties（Management Server環境設定ファイル）のmngsvr.myhost.nameキーを指定しているかどうかで指定値が異なります。

mngsvr.myhost.nameキーを指定している場合

mserver.properties（Management Server環境設定ファイル）のmngsvr.myhost.nameキーと同じ値を指定します。

mngsvr.myhost.nameキーを指定していない場合

複製元アプリケーションサーバマシンおよび複製先アプリケーションサーバマシンの管理IPアドレスの，両方にマッチする正規表現を指定します。

注

.cmxrc（クライアント設定プロパティファイル）については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を，cmxclient.properties（クライアント共通設定プロパティファイル）については，「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

また，adminagent.properties（運用管理エージェントプロパティファイル）およびmserver.properties（Management Server環境設定ファイル）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※

adminagentcheckコマンドは，このキーで指定したIPアドレスのアプリケーションサーバマシン以外では実行できません。adminagentcheckコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

また，次の表に示すキーに，ループバックアドレス以外を指定している場合は，複製元アプリケーションサーバマシンおよび複製先アプリケーションサーバマシンで，共通して使用できる管理IPアドレスとマッチする正規表現に変更してください。ループバックアドレス以外を指定している場合に，IPアドレスを正規表現に変更するキーを次の表に示します。

表7-15　ループバックアドレス以外を指定している場合に，IPアドレスを正規表現に変更するキー

ファイル名称 | キー名称
.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル） | mngsvrutil.connect.host
mngsvrutil.target_name
mngsvrutilrc.properties（mngsvrutilコマンドのクライアント側共通定義ファイル） | mngsvrutil.connect.host
mngsvrutil.target_name
.cmxrc（クライアント設定プロパティファイル） | cmx.connect.host
cmxclient.properties（クライアント共通設定プロパティファイル） | cmx.connect.host

なお，各ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

JP1/SC/DPMを使用してスケールアウトする場合，複製先アプリケーションサーバマシンが複数のIPアドレスで構成されているときは，次の表に示すキーに設定するIPアドレスを正規表現で指定する必要があります。これは，スケールアウトするマシンはIPアドレスが変わり，固定のIPアドレスが指定できないためです。

複数のIPアドレス構成時に，IPアドレスを正規表現で指定するキーを次の表に示します。

表7-16　複数のIPアドレス構成時に，IPアドレスを正規表現で指定するキー

ファイル名称 | キー名称
mserver.properties（Management Server環境設定ファイル） | mngsvr.myhost.name
webserver.connector.http.bind_host
adminagent.properties（運用管理エージェントプロパティファイル） | adminagent.adapter.bind_host

なお，mserver.properties（Management Server環境設定ファイル）およびadminagent.properties（運用管理エージェントプロパティファイル）については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　JP1/SC/DPMを使用したスケールアウト用ディスクイメージの作成

JP1/SC/DPMを使用して複製元アプリケーションサーバからディスクイメージを作成します。なお，複製元アプリケーションサーバは，ディスクイメージの作成後，業務を再開します。

スケールアウト用ディスクイメージを作成します。
複製元アプリケーションサーバから，スケールアウト用のディスクイメージを作成します。なお，詳細については，マニュアル「JP1/ServerConductor/Deployment Manager」のディスク複製OSインストール機能の説明を参照してください。

複製元アプリケーションサーバの運用管理エージェント，およびManagement Serverを開始します。
ここでは，次の内容を実施します。

adminagentctlコマンドを使用して，複製元アプリケーションサーバの運用管理エージェントを開始します。

mngsvrctlコマンドを使用して，複製元アプリケーションサーバのManagement Serverを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl start

Linuxの場合

# /opt/Cosminexus/manager/bin/adminagentctl start

# /opt/Cosminexus/manager/bin/mngsvrctl start

なお，必要に応じて，運用管理エージェントおよびManagement Serverの自動起動を再設定してください。運用管理エージェントの設定方法については，「6.5.3(2)　運用管理エージェントの自動起動の設定」を，Management Serverの設定方法については，「6.6.2(3)　Management Serverの自動起動の設定」を参照してください。

複製元アプリケーションサーバのリソースアダプタおよびJ2EEアプリケーションを開始します（必要に応じて）。
リソースアダプタおよびJ2EEアプリケーションを自動で開始する場合，この操作は不要です。
ここでは，次の内容を実施します。

cmx_start_targetコマンドを使用して，複製元アプリケーションサーバのサービスユニット「unit1」を準備状態で起動します。準備状態にするには，-modeオプションに「READY」を指定します。

サーバ管理コマンドを使用して，複製元アプリケーションサーバのサービスユニット「unit1」のリソースアダプタを開始します。

サーバ管理コマンドを使用して，複製元アプリケーションサーバのサービスユニット「unit1」のJ2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem1 -unit unit1

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem1 -unit unit1

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp

複製元アプリケーションサーバのサービスユニットを開始します。
cmx_start_targetコマンドを使用して，複製元アプリケーションサーバのサービスユニット「unit1」を稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

(3)　JP1/SC/DPMを使用したディスクイメージのリストア

作成したディスクイメージを，複製先アプリケーションサーバにリストアします。なお，リストアの操作手順については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。

また，複製先アプリケーションサーバの運用管理エージェント，およびManagement Serverを起動する場合は，ここで実施します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥adminagentctl start

<Cosminexusのインストールディレクトリ>¥manager¥bin¥mngsvrctl start

Linuxの場合

# /opt/Cosminexus/manager/bin/adminagentctl start

# /opt/Cosminexus/manager/bin/mngsvrctl start

なお，必要に応じて，運用管理エージェントおよびManagement Serverの自動起動を再設定してください。運用管理エージェントの自動起動の設定については，「6.5.3(2)　運用管理エージェントの自動起動の設定」を，Management Serverの自動起動の設定については，「6.6.2(3)　Management Serverの自動起動の設定」を参照してください。

(4)　スケールアウト用ホスト定義ファイルの作成

スケールアウト用ホスト定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

スケールアウト用ホスト定義ファイルを作成します。
スケールアウト用ホスト定義ファイル（cmxscaleouthostdef.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

Linuxの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemHostScaleout.xml」に変更しています。

コピーしたスケールアウト用ホスト定義ファイルを編集します。
MyWebSystemHostScaleout.xmlファイルを編集します。ここでは，複製先アプリケーションサーバのWebシステムの内容と，ホストの定義をします。
設定後のMyWebSystemHostScaleout.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.5">
 <!-- 複製先のWebシステムの定義 -->
 <web-system>
   <name>MyWebSystem1</name>
   <!-- 複製先のWebシステムで使用する負荷分散機の定義 -->
   <load-balancer>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <server-id-rule>2049-3073</server-id-rule>
     </cookie-switching>
   </load-balancer>
 </web-system>
 <!-- 複製先のホストの定義 -->
 <host>
   <host-name>192.168.1.13</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>
</host-scaleout>

注　太字の部分が編集部分です。

(5)　システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

作成したスケールアウト用ホスト定義ファイルの内容を，複製先アプリケーションサーバのManagement Serverの，システムの情報モデルに反映します。また，変更したシステムの情報モデルを実システムに適用して，複製先アプリケーションサーバのホスト情報を変更します。

システムの情報モデルを変更します。
cmx_scaleout_hostコマンドに，(4)で作成したスケールアウト用ホスト定義ファイルを指定して，複製先アプリケーションサーバのManagement Serverの，システムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_scaleout_host -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemHostScaleout.xml

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_scaleout_host -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemHostScaleout.xml

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，手順1.で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1

負荷分散機からのリクエストの振り分けを抑止した状態で，複製先アプリケーションサーバのサービスユニットを一括起動します。
ここでは次の内容を実施しています。

cmx_start_targetコマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」を準備状態で起動することで，負荷分散機からのリクエストの振り分けを抑止します。準備状態にするには，-modeオプションに「READY」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem1 -unit unit1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem1 -unit unit1

複製先アプリケーションサーバのリソースアダプタおよびJ2EEアプリケーションを開始します（必要に応じて）。
リソースアダプタおよびJ2EEアプリケーションが自動で開始しない場合は，最初に，リソースアダプタおよびJ2EEアプリケーションを開始します。JP1/SC/DPMを使用してディスクイメージを作成するときに，複製元アプリケーションサーバでリソースアダプタおよびJ2EEアプリケーションを一括停止しなかった場合，この操作は必要ありません。
ここでは次の内容を実施しています。

サーバ管理コマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」のリソースアダプタを開始します。

サーバ管理コマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」のJ2EEアプリケーションを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

Linuxの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.13:900 -name MyApp

複製先アプリケーションサーバのサービスユニットを一括起動します。
cmx_start_targetコマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

7.7.3　JP1/SC/DPMを利用して構築したシステムのスケールイン

ここでは，JP1/SC/DPMを利用して構築したシステムをスケールインする手順を，モデルごとに説明します。

＜この項の構成＞

(1)　運用管理サーバモデルでのシステムのスケールイン

(2)　ホスト単位管理モデルでのシステムのスケールイン

(1)　運用管理サーバモデルでのシステムのスケールイン

運用管理サーバモデルで構築したシステムを縮小する場合は，サービスユニットまたはWebシステム単位にスケールインできます。

ここでは，「7.7.1　運用管理サーバモデルでのシステムのスケールアウト」で追加したサービスユニットを削除する場合を例にして，説明しています。このため，削除するサービスユニット名は「unit3」となります。

注意

Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，「5.1　使用リソースの見積もり」を参照してください。

サービスユニットを削除します。
削除するサービスユニットを停止して，システムの情報モデルから削除します。なお，削除するサービスユニットは実行中のリクエストの処理を完了してから停止します。
ここでは次の内容を実施しています。

cmx_stop_targetコマンドを使用して，削除するサービスユニット「unit3」を一括停止します。このとき，コマンドの-modeオプションで「ALL」を指定して，停止状態にします。

cmx_delete_systemコマンドを使用して，サービスユニット「unit3」を削除します。なお，このコマンドを実行すると，Management Serverに登録されたシステムの情報モデルと負荷分散機に設定した情報は削除されます。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit3

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -unit unit3

cmx_delete_systemコマンドについて

J2EEサーバやWebサーバの環境削除などのアンセットアップを実行しません。cmx_delete_systemコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。

参考

Webシステム単位でスケールインする場合は，cmx_stop_targetコマンドおよびcmx_delete_systemコマンドで，削除対象のWebシステムを指定します。各コマンドの詳細については，「12.3　コマンドの詳細」の「cmx_stop_target」および「cmx_delete_system」を参照してください。

(2)　ホスト単位管理モデルでのシステムのスケールイン

ホスト単位管理モデルで構築したシステムを縮小する場合は，Webシステム単位にスケールインできます。ホスト単位管理モデルの場合，サービスユニット単位ではシステムをスケールインできません。

ここでは，「7.7.2　ホスト単位管理モデルでのシステムのスケールアウト」で追加したWebシステムを削除する場合を例にして，説明しています。このため，削除するWebシステム名は「MyWebSystem1」となります。この例では，複製元アプリケーションサーバと負荷分散機の仮想サーバを共有しているため，仮想サーバを削除しない設定をしてスケールインします。

システムを削除します。
削除するシステムを停止して，システムの情報モデルから削除します。なお，削除するシステムのサービスユニットは，実行中のリクエストの処理を完了してから停止します。
ここでは次の内容を実施しています。

cmx_stop_targetコマンドを使用して，削除するWebシステム「MyWebSystem1」を一括停止します。このとき，コマンドの-modeオプションで「ALL」を指定して，停止状態にします。

cmx_delete_systemコマンドを使用して，Webシステム「MyWebSystem1」を削除します。このコマンドを実行すると，Management Serverに登録されたシステムの情報モデルと負荷分散機に設定した情報は削除されます。この例では，負荷分散機の仮想サーバを複製元アプリケーションサーバと共有しているため，-lbオプションで「keepvs」（負荷分散機の仮想サーバを削除しない）を設定して，システムを削除します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1 -lb keepvs

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1 -lb keepvs

cmx_delete_systemコマンドについて

J2EEサーバやWebサーバの環境削除などのアンセットアップを実行しません。cmx_delete_systemコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。

参考

cmx_delete_systemコマンドの-lbオプションは，.cmxrc（クライアント設定プロパティファイル）またはcmxclient.properties（クライアント共通設定プロパティファイル）のcmx.lbキーで，デフォルト値を設定しておくことができます。cmx.lbキーのデフォルト値に「keepvs」を設定しておくと，最後のホスト（アプリケーションサーバ）からシステムを削除する場合以外は，-lbオプションの指定を省略できます。最後のホスト（アプリケーションサーバ）からシステムを削除する場合は，-lbオプションに「deletevs」を指定してcmx_delete_systemコマンドを実行します。.cmxrc（クライアント設定プロパティファイル）については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を，cmxclient.properties（クライアント共通設定プロパティファイル）については，「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

7.8　構築済みのシステムの移行

Smart Composer機能を使用すると，構築済みのシステムの設定内容をほかの環境に移行できます。

ここでは，構築済みのシステムの移行について説明します。

＜この節の構成＞

7.8.1　構築済みのシステムの移行手順

7.8.2　構築済みのシステムの移行時に出力する簡易構築定義ファイルの内容

7.8.3　構築済みのシステムを移行するときの注意事項

7.8.1　構築済みのシステムの移行手順

ここでは，構築済みのシステムをほかの環境に移行する場合の手順について説明します。

構築済みのシステムを移行するためには，移行先のシステムで，Management Serverが動作している必要があります。構築済みのシステムを移行する前に，移行先のシステムでインストールと初期設定を済ませておいてください。

構築済みのシステムの移行の手順を次に示します。

移行元の環境で，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。
移行元の環境で，cmx_export_modelコマンドを使用して，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。cmx_export_modelコマンドの-oオプションには，出力先の簡易構築定義ファイルのパスを指定します。cmx_export_modelコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_export_model -o <任意のディレクトリ>¥MyWebSystemexport.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_export_model -o <任意のディレクトリ>/MyWebSystemexport.xml

移行先の環境で，構築済みのシステムと同じシステムを構築します。
移行先の環境で，cmx_build_systemコマンドを使用して，構築済みのシステムと同じシステムを構築します。cmx_build_systemコマンドの-fオプションには，手順1.で出力した簡易構築定義ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -f <任意のディレクトリ>¥MyWebSystemexport.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -f <任意のディレクトリ>/MyWebSystemexport.xml

なお，Webシステムに関連づいていない論理サーバを含むシステムを構築する場合は，次に示す手順で，移行先の環境に，構築済みのシステムと同じシステムを構築してください。

移行元の環境で，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。
移行元の環境で，cmx_export_modelコマンドを使用して，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。cmx_export_modelコマンドの-oオプションには，出力先の簡易構築定義ファイルのパスを指定します。
Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_export_model -o <任意のディレクトリ>¥MyWebSystemexport.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_export_model -o <任意のディレクトリ>/MyWebSystemexport.xml

出力した簡易構築定義ファイルを使用して，移行先の環境にシステムの情報モデルを構築します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_model -f <任意のディレクトリ>¥MyWebSystemexport.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_model -f <任意のディレクトリ>/MyWebSystemexport.xml

移行先の環境で，構築したシステムの情報モデルを基に，cmx_build_systemコマンドを使用してWebシステムに関連づいていない論理サーバを含むシステムを構築します。
構築するシステムにWebシステムに関連づいている論理サーバが含まれる場合，-sオプションにWebシステム名を指定して，再度cmx_build_systemコマンドを実行します。

構築するシステムにWebシステムに関連づいていない論理サーバだけ含まれる場合

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -ns

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -ns

構築するシステムにWebシステムに関連づいていない論理サーバおよびWebシステムに関連づいている論理サーバが含まれる場合

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -s <Webシステム名>

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -ns

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -s <Webシステム名>

# /opt/Cosminexus/manager/bin/cmx_build_system -ns

7.8.2　構築済みのシステムの移行時に出力する簡易構築定義ファイルの内容

ここでは，cmx_export_modelコマンドを使用して構築済みのシステムの設定内容を出力した場合の出力内容について説明します。

＜この項の構成＞

(1)　XMLスキーマのバージョン

(2)　物理ティアの構成

(3)　論理サーバのコンフィグレーションに設定しているパラメタ

(4)　出力例

(1)　XMLスキーマのバージョン

XMLスキーマのバージョンは，最新のバージョンで出力されます。旧バージョンの簡易構築定義ファイルを使用して構築したシステムに対して設定内容を出力した場合，最新のXMLスキーマのバージョンに従って，タグ名称が最新の名称に変換されます。

(2)　物理ティアの構成

「4.3　システム構成パターン」にある構成を，Smart Composer機能を使用して構築している場合は，簡易構築定義ファイルで定義した物理ティアの構成が出力されます。「4.3　システム構成パターン」にない構成で，Smart Composer機能を使用しないで構築したシステムの場合は，free-tier構成で出力されます。例えば，運用管理ポータルを使用して構築したシステムはfree-tier構成で出力されます。free-tier構成の場合，システムの構成に応じて，次に示す論理サーバが出力されます。

論理Webサーバ

論理J2EEサーバ

論理パフォーマンストレーサ

論理SFOサーバ

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

論理ユーザサーバ

論理ネーミングサービス

出力される論理サーバのパラメタについては，「14.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ」を参照してください。

(3)　論理サーバのコンフィグレーションに設定しているパラメタ

出力規則

非推奨のパラメタは，推奨のパラメタに変換されます。

値を指定しているパラメタは出力されます。値を省略しているパラメタは出力されません。

簡易構築定義ファイルでパラメタにデフォルト値を設定している場合，または運用管理ポータルでキーにデフォルト値を設定している場合，そのパラメタは出力されます。

出力順序

論理サーバの種類ごとに，パラメタの種類によって出力順序があります。また，同じパラメタの種類の中でのパラメタの出力順序は，パラメタ名称の昇順です。パラメタの出力順序を，次の表に示します。

表7-17　パラメタの出力順序

パラメタを設定するサーバ | 出力順序 | パラメタの種類
J2EEサーバ | 1 | 各論理サーバ共通で指定できるパラメタ
2 | J2EEサーバ用オプション定義のパラメタ
3 | J2EEサーバ用ユーザプロパティのパラメタ
Webサーバ | 1 | 各論理サーバ共通で指定できるパラメタ
2 | Hitachi Web Server定義のパラメタ
3 | Hitachi Web Server用リダイレクタ動作定義のパラメタ
4 | ワーカ定義のパラメタ
そのほかの論理サーバ | 1 | 各論理サーバ共通で指定できるパラメタ
2 | 該当する論理サーバのパラメタ

設定先

構築済みのシステムの論理サーバによってパラメタの設定先が異なります。パラメタの設定先を，次の表に示します。なお，free-tier構成では，物理ティアの定義にパラメタを設定できないため，サービスユニットの定義にすべてのパラメタが設定されます。

表7-18　パラメタの設定先

同じ種類の論理サーバの数 | パラメタに指定している値 | パラメタの設定先
1 | － | 物理ティアの定義
2～n | すべての論理サーバで同じ | 物理ティアの定義
論理サーバごとに異なる | サービスユニットの定義

（凡例）　－：なし

システムの中に同じ種類の論理サーバが一つしかない場合，すべてのパラメタが物理ティアの定義に設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに同じ値をそれぞれ指定していると，パラメタの値は，物理ティアの定義にそれぞれ設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに異なる値をそれぞれ指定していると，パラメタはサービスユニットの定義にそれぞれ設定されます。

(4)　出力例

簡易構築定義ファイルの出力例を次に示します。

ここでは，簡易構築定義ファイルを使用して構築したcombined-tier構成のシステムに，運用管理ポータルでホスト（host1），論理J2EEサーバ（j2ee01），および論理パフォーマンストレーサ（prf01）を追加したシステムの設定内容の出力例を示します。

簡易構築定義ファイルの出力例

<?xml version="1.0" encoding="UTF-8" ?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <web-system>
   <name>sample-system</name>
   <tier>
     <tier-type>combined-tier</tier-type>
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>ejbserver.http.port</param-name>
         <param-value>8085</param-value>
       </param>
     </configuration>
   </tier>
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>combined-tier</hosts-for>
     </allocated-host>
   </unit>
 </web-system>
 <web-system>※1
   <tier>
     <tier-type>free-tier※2</tier-type>
   </tier>    
   <unit>※1
     <allocated-host>
       <host-ref>host1</host-ref>
       <hosts-for>free-tier</hosts-for>
       <define-server>
         <logical-server-name>prf01</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>j2ee01</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration>
           <param>※3
             <param-name>ejbserver.server.prf.PRFID</param-name>
             <param-value>PRF_ID</param-value>
           </param>
         </configuration>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <host>
   <host-name>apsv1</host-name>
 </host>
 <host>
   <host-name>host1</host-name>
 </host>
</model-definition>

注※1

free-tier構成には，Webシステム名，およびサービスユニット名がありません。

注※2

ほかのどの物理ティアの構成にも当てはまらない構成が含まれていると，その構成がfree-tier構成として出力されます。

注※3

free-tier構成では，ティアの定義にパラメタを設定できないため，サービスユニットの定義にパラメタが設定されます。

7.8.3　構築済みのシステムを移行するときの注意事項

構築済みのシステムを移行するときの注意事項を次に示します。

移行後のシステム環境に，free-tier構成が含まれている場合，Smart Composer機能のコマンドで実施できる運用作業は次のとおりです。

システムの起動・停止

システム中の論理サーバのステータス監視

システム中の論理サーバのcmx_build_systemの実行状態の表示

free-tier構成を含むシステムについてほかの運用作業をする場合は，運用管理ポータル，またはサーバ管理コマンドを使用してください。

Smart Composer機能のコマンドで簡易構築定義ファイルに出力できるのは，システム環境の内容のうち，簡易構築定義ファイルで定義できる情報だけです。簡易構築定義ファイル以外のファイルを直接編集している場合，その編集内容は反映されません。

7.9　システムの削除

不要になったシステムは削除できます。ここでは，不要になったシステムの削除の流れを説明します。

J2EEアプリケーションやリソースアダプタを停止します。
J2EEアプリケーションやリソースアダプタは，サーバ管理コマンドやServer Plug-inを使用して停止します。

cmx_stop_targetコマンドを使用してシステムを停止します。
削除対象となるシステムを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

cmx_delete_systemコマンドを使用してManagement Server上からシステムを削除します。
Management Serverで管理されているシステムの情報モデルを削除します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

WebサーバまたはJ2EEサーバをアンセットアップします。
cmx_delete_systemコマンドでは，サーバの環境はアンセットアップされません。ホスト上のWebサーバまたはJ2EEサーバの環境は，それぞれ次の方法でアンセットアップします。

Webサーバの環境のアンセットアップ
Hitachi Web Serverのユティリティを使用して，Webサーバをアンセットアップします。Hitachi Web Serverのユティリティには，Webサーバの論理サーバ名を指定します。

J2EEサーバの環境のアンセットアップ
cjsetupコマンドを使用して，J2EEサーバをアンセットアップします。cjsetupコマンドには，J2EEサーバの論理サーバ名を指定します。

論理サーバ名はcmx_list_modelコマンドを使用して確認できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。
ただし，システム構築時に，WebサーバやJ2EEサーバの実サーバ名を指定している場合は，アンセットアップ時には実サーバ名を指定してください。実サーバ名の指定は，簡易構築定義ファイルの物理ティアのrealservernameパラメタに指定します。
アンセットアップ時に指定するサーバ名の詳細は，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。
次の実行例は，実サーバ名を指定していないJ2EEサーバをアンセットアップする場合の例です。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d MyServer

UNIXの場合

# /opt/Cosminexus/CC/server/bin/cjsetup -d MyServer

7.10　トラブルへの対処

ここでは，Smart Composer機能で構築したシステムの運用中に，トラブルが発生した場合の対処について説明します。

Cosminexusで想定されるトラブルと，Smart Composer機能固有の構成で構築したシステムで想定されるトラブルについて説明します。

＜この節の構成＞

7.10.1　トラブルの種別と対処

7.10.2　負荷分散機の冗長化構成でトラブルが発生した場合の対処

7.10.1　トラブルの種別と対処

Smart Composer機能で構築したシステムで想定されるトラブルには，Cosminexusで想定されるトラブルと同じように，次に示す種別があります。

エラーメッセージ出力
エラーメッセージが出力されます。

システムダウン
Cosminexusのサーバプロセスが異常終了します。

ハングアップ（無応答）
アプリケーション呼び出しの応答が返らなくなります。

スローダウン
アプリケーション呼び出しの応答は返りますが，応答時間が長くなります。

これらのトラブル種別ごとに，トラブルシューティングに必要な資料が取得できます。資料の取得方法と対処方法については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

7.10.2　負荷分散機の冗長化構成でトラブルが発生した場合の対処

ここでは，Smart Composer機能を利用して，負荷分散機を冗長化構成で構築したシステムで，負荷分散機に障害が発生した場合の対処について説明します。

Smart Composer機能では，冗長化構成の負荷分散機に対して，同時に同じ設定処理を実行しています。一方の負荷分散機に障害が発生すると，障害が発生した負荷分散機を障害中の状態にして設定処理を抑止し，もう一方の負荷分散機だけに設定処理を続行します。

障害が発生した負荷分散機は，負荷分散機のコマンドを利用して復旧します。復旧が完了した負荷分散機は，次に示す手順で，冗長化構成での運用を再開してください。

cmx_test_lbコマンドを入力して，負荷分散機の状態を確認します。
障害から復旧した負荷分散機へ問題なくアクセスできることを確認します。

cmx_resume_lbコマンドを入力します。
障害が発生していた負荷分散機で休止中の状態が解除されて，冗長化構成の運用が再開されます。Smart Composer機能は，冗長化構成の負荷分散機に対して，同時に同じ設定処理を実行します。

また，冗長化構成の負荷分散機に障害が発生している場合に，負荷分散機を操作するコマンド（cmx_build_system，cmx_start_target，cmx_stop_target，cmx_delete_systemおよびcmx_test_lb）を入力すると，異常終了したり，警告終了したりします。その場合は，出力されるメッセージに従って対処してください。

参考

負荷分散機の障害は，負荷分散機のコマンドを利用して復旧してください。負荷分散機の復旧に関するコマンドの詳細については，各負荷分散機のドキュメントを参照してください。

8.　バッチアプリケーションを実行するシステムの構成の検討

システムを構築する前に，まず，システムの構成を検討します。

この章では，Smart Composer機能で構築するバッチアプリケーションを実行するシステムを構成する要素や，プロセス，製品などについて説明します。また，Smart Composer機能で構築できるバッチアプリケーションを実行するシステムの構成パターンについて説明します。

＜この章の構成＞

8.1　バッチアプリケーションを実行するシステムの構成

8.2　製品構成およびプロセス構成

8.3　バッチアプリケーションを実行するシステムの構成パターン

8.1　バッチアプリケーションを実行するシステムの構成

ここでは，Smart Composer機能で構築，運用するバッチアプリケーションを実行するシステムの概要や，システムを構成する要素について説明します。

Smart Composer機能で構築，運用するシステムは，バッチサーバなどが動作するアプリケーションサーバマシン，データベースが構築されているデータベースサーバマシンなどで構成されます。バッチアプリケーションを実行するシステムの概要を次の図に示します。

図8-1　バッチアプリケーションを実行するシステムの概要

Smart Composer機能では，システム内のサーバやサービスユニットの構成をWebシステムという概念で管理します。Webシステムは一つの業務システムに対応し，Management Serverが管理，運用する運用管理ドメイン内に複数配置できます。バッチアプリケーションを実行するシステムの場合，一つの業務につき，一つのWebシステムを定義します。なお，Management Serverはアプリケーションサーバに配置します。

運用管理ドメイン内では，Webシステムおよびサーバマシン（ホスト）をIDで識別して管理しています。このため，Webシステムおよびサーバマシン（ホスト）のIDは，運用管理ドメイン内で一意になるように設定してください。

また，Smart Composer機能では，Webシステム内のサーバマシンの集合や，サーバの集合を，それぞれ物理ティア，サービスユニットという論理的なまとまりで扱っています。また，サービスユニット内に配置する論理サーバの構成は，物理ティアの種類によって決まります。次に，物理ティアおよびサービスユニットについて説明します。

●物理ティア

同一のデプロイメント（プロセスの配置，リソースアダプタのデプロイ，定義設定）を適用するサーバマシンの集合を物理ティアといいます。バッチアプリケーションを実行するシステムで使用する物理ティアはj2ee-tierです。j2ee-tierは，アプリケーションサーバマシンの中に，バッチサーバ，およびパフォーマンストレーサ（PRFデーモン）の二つの論理サーバを配置する構成です。

参考

free-tier

ほかのどの物理ティアの構成にも当てはまらない構成です。ほかの物理ティアとは異なり，システムを構築する場合には使用しないで，運用管理ポータルなどで構築したシステムをほかの環境に移行する場合に使用します。運用管理ポータルなどを使用して構築したシステムの内容を簡易構築定義ファイルに出力する場合，ほかのどの物理ティアの構成にも当てはまらない構成が含まれていると，その構成がfree-tier構成として出力されます。

free-tier構成には，Webシステム名，およびサービスユニット名がありません。そのため，free-tier構成を含むシステムに対して，Smart Composer機能のコマンドでできる操作は，システムの構築，起動および停止です。そのほかの操作は，Smart Composer機能のコマンドでは実施できません。

●サービスユニット

業務サービスを提供する，閉じた部分系などのサーバの集合をサービスユニットといいます。サービスユニットは，サーバの起動・停止や，スケールアウトをするための単位となります。

サービスユニットは，1台のサーバマシンに複数配置できます。これによって，サーバマシン内に複数のバッチサーバを配置できます。サービスユニットの配置については，「8.3　バッチアプリケーションを実行するシステムの構成パターン」を参照してください。

参考

サービスユニットを配置するサーバマシンには，構築済みのWebシステムなどで使用しているマシンを指定することもできます。

バッチサーバの場合，サービスユニットにはバッチサーバとPRFデーモンの二つのプロセスを配置します。次の表に，バッチサーバの場合にサービスユニットに配置するプロセスと，1サービスユニットに配置できるプロセスの数を示します。

表8-1　サービスユニットに配置するプロセスと配置できる数

サービスユニットに配置するプロセス | 1サービスユニットに配置できる数
バッチサーバ | 1
PRFデーモン | 1

次に，サービスユニットを構成する各プロセスについて説明します。

バッチサーバ
バッチサーバは，バッチアプリケーションの実行基盤となるプロセスです。

PRFデーモン（パフォーマンストレーサ）
アプリケーションサーバは，リクエストを処理するときにトレース情報をバッファへ出力します。PRFデーモン（パフォーマンストレーサ）は，バッファに出力されたトレース情報をファイルに出力するためのI／Oプロセスです。

参考

ユーザサーバ

ユーザが定義する任意のプロセスです。ユーザサーバは，論理ユーザサーバとして定義することで，Management Serverで運用・管理できるようになります。バッチアプリケーションを実行するシステムの場合もユーザサーバを使用できます。ユーザサーバについては，「4.1(2)　サービスユニット」を参照してください。

8.2　製品構成およびプロセス構成

Smart Composer機能を使用して，バッチアプリケーションを実行するシステムを構築する場合に，必要な製品構成およびプロセス構成を次の図に示します。

図8-2　製品構成およびプロセス構成（バッチアプリケーションを実行するシステムの場合）

システムには，アプリケーションサーバマシンを配置します。またバッチアプリケーションからデータベースに接続する場合は，データベースサーバマシンも配置します。次に，システム内のサーバと，使用する製品について説明します。

●アプリケーションサーバマシン

アプリケーションサーバを配置したマシンをアプリケーションサーバマシンといいます。アプリケーションサーバマシン上では，バッチサーバが動作します。Smart Composer機能を使用するシステム構成では，アプリケーションサーバマシンはクラスタ構成になっており，それぞれをサービスユニットという単位で扱います。

アプリケーションサーバマシンにインストールする製品と，アプリケーションサーバマシン上で動作するプロセスを次の表に示します。

表8-2　アプリケーションサーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server Enterprise | PRFデーモン
バッチサーバ
Management Server
運用管理エージェント
JP1/SC/DPM※ | クライアントサービス for DPM

注※

JP1/SC/DPMを使用して，OSやアプリケーションの一括インストールをする場合だけ必要になります。JP1/SC/DPMを使用した場合のシステム構成については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」のホスト単位管理モデルの説明を参照してください。

●データベースサーバマシン

データベースが構築されているマシンをデータベースサーバマシンといいます。

インストールする製品

HiRDB，Oracle，SQL Server，またはXDM/RD E2

8.3　バッチアプリケーションを実行するシステムの構成パターン

Smart Composer機能を使用してバッチサーバを構築する場合，バッチサーバ用のサービスユニットをシステムに配置します。サービスユニットの配置方法には，次の2種類があります。

1台のサーバマシンに一つのサービスユニットを配置する

1台のサーバマシンに複数のサービスユニットを配置する

ここでは，これらの構成について説明します。

ポイント

複数のバッチアプリケーションを並行して実行したい場合

一つのバッチサーバ上で実行できるバッチアプリケーションは一つです。複数のバッチアプリケーションを並行して実行したい場合は，次に示すシステム構成にします。

サーバマシンを複数用意し，各サーバマシンにバッチサーバを一つ配置する

1台のサーバマシン内に複数のバッチサーバを配置する

参考

Smart Composer機能を使用して，システムを構築する場合，JP1/SC/DPMが利用できます。JP1/SC/DPMと連携すると，構築したシステムのディスクイメージを複製できるので，より迅速にシステムを構築できます。詳細については，「4.4　JP1/SC/DPMを利用して構築する場合のシステム構成」を参照してください。

j2ee-tier構成以外にも，サーバの構成を限定しない，free-tier構成があります。free-tier構成は，Smart Composer機能以外の方法で構築したシステムをエクスポートしたときに出力されます。

＜この節の構成＞

8.3.1　1台のサーバマシンに一つのサービスユニットを配置する構成

8.3.2　サーバマシン内に複数のサービスユニットを配置する構成

8.3.1　1台のサーバマシンに一つのサービスユニットを配置する構成

1台のサーバマシンに一つのサービスユニットを配置する構成です。シンプルな構成のため，日常のメンテナンスやシステムの拡張が容易です。

1台のサーバマシンに一つのサービスユニットを配置したシステム構成例を次の図に示します。

図8-3　1台のサーバマシンに一つのサービスユニットを配置したシステム構成例

8.3.2　サーバマシン内に複数のサービスユニットを配置する構成

Smart Composer機能で構築するシステムでは，1台のサーバマシンに複数のバッチサーバ用のサービスユニットを配置できます。サーバマシン中のサーバをサービスユニット単位で増やしてシステムを拡張できます。

また，Smart Composer機能では，システム内のサーバやサービスユニットの構成をWebシステムという概念で管理します。バッチサーバの場合で，1台のサーバマシンに複数のサービスユニットを配置するときは，それぞれのサービスユニットを異なるWebシステムとして配置します。

サーバマシン内に複数のサービスユニットを配置する例を次の図に示します。

図8-4　サーバマシン内に複数のサービスユニットを配置する場合のシステム構成例

9.　バッチアプリケーションを実行するシステムを構築する前に

決定した構成でシステムを構築する前に，使用リソースの見積もりをしたり，運用設計をしたりします。

この章では，バッチアプリケーションを実行するシステムを構築する前の準備，および注意事項について説明します。

＜この章の構成＞

9.1　使用リソースの見積もり

9.2　運用・障害設計

9.3　簡易構築定義ファイルの運用方法

9.1　使用リソースの見積もり

システムが動作するためには，OSやデータベースなどのホスティング環境の設定が必要な場合があります。ここでは，Smart Composer機能を使用して構築されたシステムが必要とするリソースの見積もりについて，OSごとに説明します。

＜この節の構成＞

9.1.1　Windowsの場合

9.1.2　AIXの場合

9.1.3　HP-UXの場合

9.1.4　Linuxの場合

9.1.5　Solarisの場合

9.1.6　仮想メモリの使用量の見積もり

9.1.1　Windowsの場合

Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量を見積もるための計算式を，次の表に示します。

Windowsシステムでは，Windowsシステムで利用できるプロセス数，およびWindowsシステムやプロセスで利用できるスレッド数に，特に制限はありません。Windowsシステムで利用できる数だけ利用できます。

表9-1　使用リソースの見積もり（Windowsの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×MaxPoolSize※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×MaxPoolSize※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※　Connector属性ファイルのMaxPoolSizeパラメタの値を指定します。

なお，仮想メモリ所要量については，「9.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application ServerまたはDeveloperのリリースノートを参照してください。

9.1.2　AIXの場合

AIXの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて説明します。

なお，仮想メモリ所要量については，「9.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　アプリケーションサーバマシンの使用リソースの見積もり

(2)　DBMSの使用リソースの見積もり

(1)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表9-2　アプリケーションサーバマシンの使用リソースの見積もり（AIXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
サービスユニット | 共用メモリ | － | PrfTraceBufferSize※1＋18496 | －
プロセス数 | － | 4 | －
スレッド数 | － | バッチサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | nofiles | バッチサーバのファイルディスクリプタ数※2＋43 | /etc/security/limits
Management Server | プロセス数 | － | 5 | －
スレッド数 | － | 56 | －
ファイルディスクリプタ数 | nofiles | 43＋バッチサーバ数 | /etc/security/limits

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

バッチサーバのスレッド数とファイルディスクリプタ数については，「付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表9-3　DBMSの使用リソースの見積もり（AIXの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×MaxPoolSize※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×MaxPoolSize※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※　Connector属性ファイルのMaxPoolSizeパラメタの値を指定します。

9.1.3　HP-UXの場合

HP-UXの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて説明します。

なお，仮想メモリ所要量については，「9.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　アプリケーションサーバマシンの使用リソースの見積もり

(2)　DBMSの使用リソースの見積もり

(1)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表9-4　アプリケーションサーバマシンの使用リソースの見積もり（HP-UXの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
サービスユニット | 共用メモリ | shmmax | PrfTraceBufferSize※1＋18496 | kctune shmmax= 1073741824
プロセス数 | nproc | 4 | kctune nproc=4200
スレッド数 | nkthread | バッチサーバのスレッド数※2＋34 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | バッチサーバのファイルディスクリプタ数※2＋43 | kctune nfile= 65536
Management Server | プロセス数 | nproc | 5 | kctune nproc=4200
スレッド数 | nkthread | 56 | kctune nkthread= 8416
ファイルディスクリプタ数 | nfile | 43＋バッチサーバ数 | kctune nfile= 65536

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

バッチサーバのスレッド数とファイルディスクリプタ数については，「付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表9-5　DBMSの使用リソースの見積もり（HP-UXの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×MaxPoolSize※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×MaxPoolSize※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※　Connector属性ファイルのMaxPoolSizeパラメタの値を指定します。

9.1.4　Linuxの場合

Linuxの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて説明します。

なお，仮想メモリ所要量については，「9.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　アプリケーションサーバマシンの使用リソースの見積もり

(2)　DBMSの使用リソースの見積もり

(1)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表9-6　アプリケーションサーバマシンの使用リソースの見積もり（Linuxの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
サービスユニット | 共用メモリ | SHMMAX | PrfTraceBufferSize※1＋18496 | /proc/sys/kernel/shmmax
プロセス数 | threads-max※2 | 4 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※2 | バッチサーバのスレッド数※3＋34 | －
ファイルディスクリプタ数 | fs.file-max | バッチサーバのファイルディスクリプタ数※3＋43 | /proc/sys/fs/file-max
Management Server | プロセス数 | threads-max※2 | 5 | /proc/sys/kernel/threads-max
スレッド数 | threads-max※2 | 56 | －
ファイルディスクリプタ数 | fs.files-max | 43＋バッチサーバ数 | /proc/sys/fs/file-max

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

threads-maxパラメタには，プロセス数とスレッド数の合計を指定してください。

注※3

バッチサーバのスレッド数とファイルディスクリプタ数については，「付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表9-7　DBMSの使用リソースの見積もり（Linuxの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×MaxPoolSize※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×MaxPoolSize※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※　Connector属性ファイルのMaxPoolSizeパラメタの値を指定します。

9.1.5　Solarisの場合

Solarisの場合の，Smart Composer機能を使用して構築されたシステムが必要とするリソースと，リソースの所要量の見積もりについて，参照先を次の表に示します。

なお，仮想メモリ所要量については，「9.1.6　仮想メモリの使用量の見積もり」を参照してください。また，ディスク占有量については，Application Serverのリリースノートを参照してください。

また，各表の見積もりにある，「オプション設定ファイル例」については，使用しているOSのバージョン，およびカーネルのバージョンごとに異なります。使用しているOSのマニュアルを参照して，表中の見積もり式を基に見積もった値を設定してください。なお，使用しているOSで該当するカーネルパラメタが設定できない場合には，設定は不要です。

＜この項の構成＞

(1)　アプリケーションサーバマシンの使用リソースの見積もり

(2)　DBMSの使用リソースの見積もり

(1)　アプリケーションサーバマシンの使用リソースの見積もり

アプリケーションサーバマシンの使用リソースの見積もりについて，次の表に示します。

表9-8　アプリケーションサーバマシンの使用リソースの見積もり（Solarisの場合）

システムリソース | パラメタ | 所要量 | オプション設定ファイル例
サービスユニット | 共用メモリ | shminfo_shmmax | PrfTraceBufferSize※1＋18496 | /etc/system
プロセス数 | max_nprocs | 4 | /etc/system
スレッド数 | － | バッチサーバのスレッド数※2＋34 | －
ファイルディスクリプタ数 | rlim_fd_max | バッチサーバのファイルディスクリプタ数※2＋43 | /etc/system
Management Server | プロセス数 | maxuprc | 5 | /etc/system
スレッド数 | － | 56 | －
ファイルディスクリプタ数 | rlim_fd_max | 43＋バッチサーバ数 | /etc/system

（凡例）－：該当しません。

注※1

パフォーマンストレーサのバッファメモリサイズを512～102400の範囲で指定します（単位はキロバイトになります）。PrfTraceBufferSizeについては，「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

注※2

バッチサーバのスレッド数とファイルディスクリプタ数については，「付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照して算出してください。

(2)　DBMSの使用リソースの見積もり

DBMSの使用リソースの見積もりについて，次の表に示します。

表9-9　DBMSの使用リソースの見積もり（Solarisの場合）

コンポーネント | 使用リソース | 所要量
DBMS（HiRDBの場合） | 最大同時接続数(pd_max_users) | (サービスユニット内リソースアダプタ数×MaxPoolSize※×2＋サービスユニット内リソースアダプタ数)×サービスユニット数
DBMS（Oracleの場合） | 最大同時接続数(PROCESSES) | (サービスユニット内リソースアダプタ数×MaxPoolSize※＋サービスユニット内リソースアダプタ数)×サービスユニット数

注※　Connector属性ファイルのMaxPoolSizeパラメタの値を指定します。

9.1.6　仮想メモリの使用量の見積もり

ここでは，仮想メモリの使用量の見積もり方法について説明します。なお，仮想メモリの使用量の計算式に使用しているJavaVM起動時のオプションの詳細については，マニュアル「Cosminexus　システム設計ガイド」のJavaVMで使用するメモリ空間の構成とJavaVMオプションに関する説明を参照してください。

＜この項の構成＞

(1)　仮想メモリの使用量の計算式

(2)　仮想メモリの使用量を計算する場合の注意事項

(1)　仮想メモリの使用量の計算式

仮想メモリの使用量（単位：メガバイト）の計算式を次に示します。

バッチサーバの仮想メモリの使用量 = A＋B＋C＋（D＋10）×E

（凡例）

A：Javaヒープサイズ
初期値は，JavaVM起動時のオプション-Xmsに指定した値です。この値は，J2EEサーバ起動中に，最大でJavaVM起動時のオプション-Xmxに指定した値まで拡張されます。

B：Permanent領域サイズ
初期値は，JavaVM起動時のオプション-XX:PermSizeに指定した値です。この値は，J2EEサーバ起動中に，最大でJavaVM起動時のオプション-XX:MaxPermSizeに指定した値まで拡張されます。
監査ログを使用する場合
監査ログを使用する場合は，値に1メガバイトを加えてください。

C：ネイティブプログラム使用領域サイズ
OSごとに使用する値が異なります。ネイティブプログラム使用領域サイズのOSごとの値について，次の表に示します。

表9-10　ネイティブプログラム使用領域サイズの値一覧

OS種別
使用領域の値
（単位：メガバイト）

Windows
300

AIX
400

HP-UX
400

Linux（x86）
400

Linux（AMD64 & Intel EM64T）
600

監査ログを使用する場合
監査ログを使用する場合は，OSごとのネイティブプログラム使用領域サイズの値に，監査ログで使用する値を加える必要があります。監査ログで使用する値を算出するには，auditlog.raslog.message.filesizeキー，およびauditlog.raslog.exception.filesizeキーを使用します。これらのキーは，auditlog.properties（監査ログ定義ファイル）で指定するキーです。これらのキーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」の監査ログ定義ファイルに関する説明を参照してください。
監査ログで使用する値（単位：メガバイト）の計算式を次に示します。
監査ログで使用する値 =
8＋（auditlog.raslog.message.filesizeの指定値 / 1,024²）※＋（auditlog.raslog.exception.filesizeの指定値 / 1,024²）※
注※　指定値の単位はバイトです。仮想メモリの使用量の値の単位はメガバイトであるため，1,024²で割る必要があります。

D：バッチサーバのスレッド数
バッチサーバが使用するスレッド数です。バッチサーバが使用するスレッド数についての詳細は，「付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり」を参照してください。

E：スタック領域サイズ
JavaVM起動時のオプション-Xssに指定した値です。

(2)　仮想メモリの使用量を計算する場合の注意事項

ネイティブプログラム使用領域サイズの値は変動します。値が変動するのは次のような場合です。

ORBのトレースサイズを変更した場合

JDBCドライバの使用領域サイズの値を変更した場合

使用する製品のネイティブライブラリ使用領域サイズの値を変更した場合

このような場合，製品ごとのメモリ使用量をネイティブプログラム使用領域サイズの値に加えてください。製品ごとのメモリ使用量は，使用する製品のドキュメントに従って算出してください。

バッチサーバの標準構成で使用する仮想メモリの使用量は，使用するソフトウェア製品の影響で，見積もり値よりも大きくなる場合があります。その場合の増加分については，仮想メモリの使用量の値に加えてください。増加分のメモリ使用量は，使用するソフトウェア製品のドキュメントに従い，製品ごとのメモリ使用量を算出してください。

9.2　運用・障害設計

日常運用の操作，メンテナンス，運用スケジュールなどの運用設計，および障害発生時のシステム運用の障害設計について，検討します。

＜この節の構成＞

9.2.1　Cosminexusのシステムでできる運用作業

9.2.2　運用設計

9.2.3　障害設計

9.2.1　Cosminexusのシステムでできる運用作業

バッチアプリケーションを実行するシステムでは次に示す運用作業を実施できます。

システムの起動と停止

システムの運用監視

システムの処理性能解析

リソースの管理

システムの監査

システムの変更

システム環境の移行

トラブルシューティング

それぞれの運用作業について説明します。

＜この項の構成＞

(1)　システムの起動と停止で実行できる作業

(2)　システムの運用監視で実行できる作業

(3)　システムの処理性能解析で実行できる作業

(4)　リソースの管理で実行できる作業

(5)　システムの監査で実行できる運用作業

(6)　システムの変更でできる運用作業

(7)　システム環境の移行で実行できる運用作業

(8)　トラブルシューティングで実行できる作業

(1)　システムの起動と停止で実行できる作業

システムの起動と停止で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-11　システムの起動と停止で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットを一括起動します。 | 不要 | － | 11.2 | cmx_start_target
サービスユニットを一括停止します。 | 不要 | － | 11.2 | cmx_stop_target
クラスタソフトウェアを使用したシステムを起動・停止します。 | 必要 | 構築 | 運用 | Cosminexusのコマンド，クラスタソフトウェアの機能

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

(2)　システムの運用監視で実行できる作業

システムの運用監視で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-12　システムの運用監視で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
サービスユニットのステータス，およびWebシステムに関連づいていない論理サーバを確認します。 | 不要 | － | cmx_list_status
論理サーバのステータスを確認します。 | 不要 | 構築 | 運用 | 運用管理コマンド（mngsvrutil）
Webシステム内のサービスユニットの構成，およびWebシステムに関連づいていない論理サーバの一覧を確認します。 | 不要 | － | cmx_list_model
稼働情報ファイルを参照して，バッチサーバの稼働情報を監視します。 | 省略可 | 構築 | 運用 | －
運用管理コマンドを使用して，バッチサーバの稼働情報を監視します。 | 不要 | － | 運用 | 運用管理コマンド（mngsvrutil）
リソースの使用率や使用数を監視して，しきい値を超えた場合に原因を調査します。 | 省略可 | 構築 | 運用 | －
稼働情報ファイルに出力される稼働情報，またはリソースの枯渇状況に応じてメッセージが出力された場合の処理を自動化します（Managementアクション）。 | 必要 | 9.2.3(2)，構築 | － | －

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

(3)　システムの処理性能解析で実行できる作業

システムの処理性能解析で実行できる作業について，次の表に示します。

表9-13　システムの処理性能解析で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
性能解析トレースファイルを収集します。 | 不要 | － | 運用 | 運用管理コマンド（mngsvrutil）
収集した性能解析トレースファイルを利用してシステムの処理性能を解析します。 | 不要 | － | 運用 | －

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

運用：マニュアル「Cosminexus　システム運用ガイド」

(4)　リソースの管理で実行できる作業

リソースの管理で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-14　リソースの管理で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
コネクションプールの情報を表示します。 | 不要 | － | 解説 | サーバ管理コマンド（cjlistpool）
コネクションプールをクリアします。 | 不要 | － | 解説 | サーバ管理コマンド（cjclearpool）
クラスタ構成のデータベースをメンテナンスします。 | 不要 | － | 運用 | サーバ管理コマンド（cjlistrar，cjsuspendpool，cjresumepool）
リソースの接続テストをします。 | 必要 | 構築 | 解説 | サーバ管理コマンド（cjtestres）

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

解説：マニュアル「Cosminexus　機能解説」

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

リファレンス：マニュアル「Cosminexus　リファレンス　コマンド編」

(5)　システムの監査で実行できる運用作業

監査ログを使用したシステムの監査，およびデータベース監査証跡と連携した運用で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-15　システムの監査で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
監査ログを出力して，管理します。 | 必要 | 構築 | 運用 | －
監査ログを収集して調査します。 | 必要 | 構築 | 運用 | －
データベース監査証跡に出力された情報を基に，データベースにアクセスしたリクエストの情報を特定します。 | 不要 | － | 運用 | －

（凡例）

必要：運用前の設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

(6)　システムの変更でできる運用作業

システムの変更で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-16　システムの変更で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
設定変更 | システム全体の設定を一括で変更します。 | 不要 | － | 11.3
構成変更 | システムをスケールアウトします。 | 不要 | － | 11.4.1，11.5
システムをスケールインします。 | 不要 | － | 11.4.2，11.5
削除 | システムを削除します。 | 不要 | － | 11.8

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(7)　システム環境の移行で実行できる運用作業

システム環境の移行で実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-17　システム環境の移行で実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
構築済みのシステムの環境を移行します。 | 不要 | － | 11.6 | cmx_export_model

（凡例）

不要：運用前の設定は不要です。

－：該当しません。

(8)　トラブルシューティングで実行できる作業

トラブルシューティングで実行できる作業について，次の表に示します。なお，Cosminexusのシステムで実行できる運用作業には，運用前に設定が必要なものもあります。

表9-18　トラブルシューティングで実行できる作業

運用作業 | 運用前の設定の要否 | 運用前の設定方法の参照先 | 運用方法
参照先 | 手段
トラブルシューティングに必要な資料を収集します。 | 必要／省略可 | 9.2.3(1)，構築 | 運用 | 運用管理コマンド（mngsvrutil）
論理サーバ（構成ソフトウェアのサーバプロセス）に異常が発生した場合の処理を自動化します。 | 省略可 | 構築 | 運用 | －
トラブルシューティングに必要な資料を調査します。 | 不要 | － | 運用 | －

（凡例）

必要：運用前の設定が必要です。

省略可：デフォルトの設定で使用できるため，運用前の設定は省略できます。この動作をデフォルトから変更する場合は設定が必要です。

不要：運用前の設定は不要です。

－：該当しません。

構築：マニュアル「Cosminexus　システム構築ガイド」

運用：マニュアル「Cosminexus　システム運用ガイド」

9.2.2　運用設計

運用設計では，システムの起動や停止などの日常運用操作，運用スケジュール，運用スケジュールの自動化，監視，稼働性能統計などを設計します。

ここでは，Smart Composer機能で構築したシステムで実現できる次に示す運用について説明しています。

日常運用

サービスユニットの一括起動

サービスユニットの一括停止

システムの一括設定変更

システムの構成変更

システムのスケールアウト

システムのスケールイン

構築済みのシステムの移行

システムの削除

これらの運用の操作手順，および設定の変更方法については，それぞれ次の個所を参照してください。

日常運用の操作手順
「11.2　日常運用の操作」

システムの設定変更の方法
「11.3　システム全体の設定変更」

システムの構成変更の方法（システムのスケールアウトおよびスケールインの方法）
「11.4　システムのスケールアウトとスケールイン」，または「11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン」

構築済みのシステムの移行の方法
「11.6　構築済みのシステムの移行」

システムの削除の方法
「11.8　システムの削除」

バッチアプリケーションを実行するシステムの運用について説明します。

＜この項の構成＞

(1)　日常運用

(2)　システムの設定変更

(3)　システムの構成変更

(4)　システム環境の移行

(5)　システムの削除

(1)　日常運用

Smart Composer機能で構築したシステムで実施できる，日常運用の操作を説明します。

(a)　サービスユニットの一括起動と一括停止

サービスユニットの一括起動と一括停止ができます。一括起動および一括停止は，システム内のすべてのサービスユニットに対して実施したり，特定のサービスユニットに対して実施したりできます。

一括起動および一括停止の範囲を次の図に示します。

図9-1　一括起動および一括停止の範囲

特定のサービスユニットに対して起動または停止できるので，例えば，サービスユニット1だけを停止させるという操作が実現できます。

(2)　システムの設定変更

Smart Composer機能でできる，システムの設定変更の操作を説明します。

(a)　システムの設定の一括変更

システム全体の設定は，一括で変更できます。システム全体の設定の一括変更について次の図に示します。

図9-2　システム全体の設定の一括変更

システム全体の設定の一括変更の流れについて説明します。なお，1.～3.の操作はすべてSmart Composer機能のコマンドを使用して実施します。それぞれの操作は，システム内のすべてのサービスユニットに対して一括で実施できます。

システムを停止します。

変更後の設定をシステムに反映させます。
システム内のすべての設定を一度に変更できます。

システムを起動します。

(3)　システムの構成変更

システムの構成変更について説明します。

(a)　システムのスケールアウトおよびスケールイン

システムのスケールアウトおよびスケールインができます。スケールアウトとは，システム全体の処理性能を向上させることを目的として，サーバの台数を増やすことをいいます。また，スケールインとは，システムの規模を縮小する場合などに，サーバの台数を減らすことをいいます。

スケールアウトおよびスケールインは，サービスユニット単位またはWebシステム単位で実施できます。なお，スケールアウトおよびスケールインは，業務全体を停止することなく実施できます。

スケールアウトおよびスケールインについて次の図に示します。

図9-3　スケールアウトおよびスケールイン

この図では，サービスユニット3をシステムに追加（スケールアウト），およびシステムから削除（スケールイン）しています。サービスユニット3のスケールアウトおよびスケールインに際しては，稼働中のサービスユニット1およびサービスユニット2には影響はないため，業務全体を停止することなく，スケールアウトおよびスケールインができます。

(b)　JP1/SC/DPMと連携したスケールアウト

Smart Composer機能でシステムをスケールアウトする際に，JP1/SC/DPMと連携できます。JP1/SC/DPMと連携すると，マシン（運用管理ドメイン）単位にスケールアウトしてサーバの台数を増やしたり，またはスケールインしてサーバの台数を減らしたりできます。JP1/SC/DPMでのスケールアウトおよびスケールインについては，「11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン」を参照してください。

JP1/SC/DPMでは，システムのディスクイメージを複製し，複製したデータを基にして，OSやアプリケーションを一括でサーバにインストールできます（ディスク複製OSインストール機能）。Smart Composer機能でシステムをスケールアウトするときにJP1/SC/DPMと連携すると，構築済みのシステムの複製した情報を使用して，追加するアプリケーションサーバにOSやアプリケーションを一括インストールできます。

JP1/SC/DPMと連携してスケールアウトをするときの流れを次の図に示します。

図9-4　JP1/SC/DPMと連携したスケールアウト

JP1/SC/DPMと連携したスケールアウトの流れについて説明します。なお，ここでは，サービスユニット1が構築済みの場合に，JP1/SC/DPMを使用して，サービスユニット2をシステムに追加（スケールアウト）するときの例で説明します。

Smart Composer機能で構築済みのサービスユニット1のディスクイメージを，JP1/SC/DPMを使用して複製します。

1.で複製したディスクイメージに従って，追加するサービスユニット2にOSやアプリケーションをインストールします。

Smart Composer機能のコマンドを使用して，サービスユニット2をシステムに追加（スケールアウト）します。

(4)　システム環境の移行

システム環境の移行について説明します。

(a)　構築済みのシステムの移行

構築済みのシステムの移行ができます。テスト環境で構築したシステムを本番環境に移行する場合などに利用できます。

構築済みのシステムの移行について次の図に示します。

図9-5　構築済みのシステムの移行

構築済みのシステムの移行の流れについて説明します。構築済みのシステムを移行するためには，移行先のシステムで，Management Serverが動作している必要があります。構築済みのシステムを移行する前に，移行先のシステムでインストールと初期設定を済ませておいてください。なお，1.～2.の操作はSmart Composer機能のコマンドを使用して実施します。

移行元の環境で，システムの設定内容を簡易構築定義ファイルの形式で出力します。

移行先の環境で，出力した簡易構築定義ファイルを使用して，システムを構築します。移行先の環境では，移行元の環境のシステムと同じ設定内容のシステムが構築されます。

(5)　システムの削除

不要になったシステムを削除できます。システムを削除するには，Smart Composer機能で提供するコマンドを使用します。システムの削除については，「11.8　システムの削除」を参照してください。

9.2.3　障害設計

障害設計では，障害発生時の対応に関して，障害部分の切り離し，障害からの復旧，障害時の取得資料，障害原因の切り分け，障害調査などについて設計します。

Smart Composer機能では，障害発生時の資料取得に加えて，問題発生時にサービスユニットを自動部分閉塞したり，自動部分再起動したりするような高度な運用ができます。これには，Cosminexusの障害検知時コマンドを利用したり，リソース枯渇監視機能を利用したりします。

Smart Composer機能で実施できる障害発生時の運用を次に示します。

障害発生時のサービスユニットの自動再起動
障害が発生したサービスユニットの自動再起動（障害発生時のシステムの自動部分再起動）

この運用をする場合は，システム構築時に設定をしておく必要があります。設定手順については，「6.19.2　サービスユニットを自動再起動するための設定」を参照してください。

なお，そのほかの障害時の対応については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

障害発生時の運用について次に説明します。

＜この項の構成＞

(1)　障害発生時の資料取得

(2)　障害発生時のサービスユニットの自動再起動

(1)　障害発生時の資料取得

システムで障害が発生した場合，トラブルシューティングに必要な資料が収集できます。トラブルシューティングに必要な資料は，個別に取得したり，snapshotログとして一括して取得したりできます。snapshotログは，システムの構成ソフトウェアが障害発生時にそのときの状態を出力したログで，各種構成ソフトウェアのログのほかに，スレッドダンプ（ハングアップの場合だけ），性能解析トレースなどが含まれます。

障害発生時のタイムリーな情報をsnapshotログとして収集するためには，障害検知時コマンドを利用します。障害検知時コマンドは，Management Serverが論理サーバの障害を検知したときに，システムによって実行されるコマンドです。障害検知時コマンドを利用して，トラブル発生時のスレッドダンプやユーザダンプの取得などの処理を実行することで，障害発生時のタイムリーな資料を取得できるようになります。障害検知時コマンドには，システム提供の障害検知時コマンドとユーザ作成の障害検知時コマンドの2種類があります。

システム提供の障害検知時コマンド
障害の発生したバッチサーバのスレッドダンプ（ハングアップの場合だけ）および性能解析トレースなどを取得します。

ユーザ作成の障害検知時コマンド
障害発生時に実行する処理をユーザが定義します。

障害検知時コマンドの実行とsnapshotログの収集によって，トラブルシューティングに必要な情報を取得できます。障害検知時コマンドの概要については，マニュアル「Cosminexus　機能解説」の障害検知時コマンドによる資料取得に関する説明を参照してください。

また，資料によっては，事前に取得のための設定をしておく必要があります。例えば，OSの統計情報，ユーザダンプなどは，システム構築時に取得のための設定をしておかないと取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。デフォルトの設定ではsnapshotログとして収集できない資料でも，その資料の取得先をsnapshotログの収集対象として定義することで，snapshotログとして一括収集できるようになります。

デフォルトの設定でsnapshotログとして収集できる資料とsnapshotログ収集の設定については，マニュアル「Cosminexus　システム構築ガイド」のsnapshotログ収集の設定に関する説明を参照してください。取得できる資料の詳細については，マニュアル「Cosminexus　システム運用ガイド」の取得が必要な資料の種類に関する説明を参照してください。

参考

ユーザ作成の障害検知時コマンドには，Smart Composer機能のコマンドを定義しておくこともできます。例えば，致命的な障害が発生したサービスユニットを自動閉塞するコマンドを，障害検知時コマンドとして設定しておくことができます。

(2)　障害発生時のサービスユニットの自動再起動

JavaVMのフルガーベージコレクションやスレッド数などのリソース枯渇を事前に検知すると，問題が発生したサービスユニットを自動再起動します。サービスユニットの自動再起動には，Cosminexusのリソース枯渇監視機能を利用します。

障害発生時のサービスユニットを自動再起動する図を次に示します。

図9-6　障害発生時のサービスユニットの自動再起動

障害発生時のサービスユニット自動再起動の仕組みについて説明します。

サービスユニットの自動再起動では，Cosminexusのリソース枯渇監視機能を利用します。リソース枯渇監視機能でリソース枯渇を事前に検知すると，これらの情報がManagementイベントとして，Management Serverに通知されます。Managementイベントが通知されると，Management ServerではManagementアクションが実行されます。Managementアクションでは，ユーザがあらかじめ定義しておいた処理を実施します。

Managementアクションとして，サービスユニットを再起動するSmart Composer機能のコマンドを定義することで，障害の発生したサービスユニットを自動再起動できます。

なお，Managementイベント，Managementアクション，およびリソース枯渇機能については，マニュアル「Cosminexus　機能解説」のシステムの運用支援に関する説明を参照してください。

9.3　簡易構築定義ファイルの運用方法

Cosminexusのシステム構築には，簡易構築定義ファイルを使用します。簡易構築定義ファイルは，システムの設定内容をXML形式で定義するファイルです。

システム運用中は，簡易構築定義ファイルをシステムの資産として保持し，設定情報を常に管理することを推奨します。

システムを構築したあとに，システムの設定内容を変更する場合は，システム構築時に使用した簡易構築定義ファイルをメンテナンスします。メンテナンスした簡易構築定義ファイルを基にシステムを再構築すると，メンテナンス結果がシステムに反映されます。

システムを構築したあとにシステムの構成変更をする場合は，構成変更定義ファイルを使用してください。簡易構築定義ファイルの編集で，システムの構成変更はできません。

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

この章では，Smart Composer機能を使用した，バッチアプリケーションを実行するシステムの構築について説明します。なお，システム構築で使用するSmart Composer機能のコマンドやファイルについては，「12.　コマンド」および「13.　ファイル」を参照してください。

＜この章の構成＞

10.1　システム構築の概要

10.2　インストール

10.3　ホスティング環境の設定

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

10.5　システムの構成定義

10.6　DB ConnectorのConnector属性ファイルの編集

10.7　システムの一括構築

10.8　システムの開始

10.9　チューニング

10.10　障害に対応したシステムの構築

10.1　システム構築の概要

各サーバの初期設定が終わると，システムの一括構築，リソースアダプタのインポートと開始の順に操作してシステムを構築していきます。システムの一括構築の操作はSmart Composer機能のコマンド，リソースアダプタの操作はサーバ管理コマンドを使用します。

ここでは，Smart Composer機能を使用したシステム構築の概要を説明します。なお，バッチアプリケーションの作成およびJP1/AJS2からのバッチアプリケーションの実行については，マニュアル「Cosminexus　機能解説」のバッチアプリケーションに関する説明を参照してください。また，JP1/IM - CMおよびJP1/AJS2 - SOと連携するときのシステム構築については，「15.　JP1と連携したSmart Composer機能でのシステム構築・運用」もあわせて参照してください。

＜この節の構成＞

10.1.1　コマンドとシステム構築の関係

10.1.2　バッチサーバを配置する構成のシステムの構築例

10.1.3　バッチサーバを配置する構成のシステムを構築する流れ

10.1.1　コマンドとシステム構築の関係

システムの構築にはSmart Composer機能で提供するコマンドを使用します。また，リソースアダプタを設定するには，サーバ管理コマンドを使用します。サーバ管理コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」のバッチサーバで使用するコマンドに関する説明を参照してください。

Smart Composer機能のコマンドおよびサーバ管理コマンドは，アプリケーションサーバ上で実行します。

Smart Composer機能のコマンドとシステム構築の関係，およびサーバ管理コマンドとシステム構築の関係を説明します。

＜この項の構成＞

(1)　Smart Composer機能のコマンドとシステム構築の関係

(2)　サーバ管理コマンドとシステム構築の関係

(1)　Smart Composer機能のコマンドとシステム構築の関係

バッチアプリケーションを実行するシステムの一括構築について，使用するコマンドとシステム構築との関係を次の図に示します。

図10-1　コマンドとシステム構築の関係（バッチアプリケーションを実行するシステムの一括構築）

図中の項番について説明します。

操作
図中の項番
操作の詳細
使用するコマンド

システムの一括構築
1.
簡易構築定義ファイルの情報を基にして，Management Server上にシステムの情報モデルを生成します。
さらに，Management Server上の情報モデルに従って，すべてのアプリケーションサーバ上にシステムを構築します。
cmx_build_system

参考

cmx_から始まるSmart Composer機能のコマンドには共通引数（-m，-u，-p，-waitまたは-nowait，-verboseまたは-noverbose）があります。共通引数を省略したときのデフォルト値を，.cmxrcファイルまたはcmxclient.propertiesファイルに設定できます。

省略時のデフォルト値を，クライアントごとに設定する場合は.cmxrcファイルに，すべてのクライアント共通で設定する場合はcmxclient.propertiesファイルに設定します。

.cmxrcファイルの詳細については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を，cmxclient.propertiesファイルの詳細については，「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

(2)　サーバ管理コマンドとシステム構築の関係

リソースアダプタのインポートと開始について，使用するコマンドとシステム構築との関係を，次の図に示します。

図10-2　コマンドとシステム構築の関係（リソースアダプタのインポートと開始）

図中の項番について説明します。

操作 | 図中の項番 | 操作の詳細 | 使用するコマンド
リソースアダプタの操作 | 1. | リソースアダプタを各バッチサーバにインポートします。 | cjimportres
2. | 各バッチサーバにリソースアダプタをデプロイします。 | cjdeployrar
3. | Connector属性ファイルをリソースアダプタに反映します。 | cjsetrarprop
4. | リソースアダプタの接続テストをします。 | cjtestres
5. | 各バッチサーバでリソースアダプタを開始します。 | cjstartrar

なお，リソースアダプタの操作はバッチサーバごとに実行します。

参考

サーバ管理コマンドを実行する際には-nameserverオプションにプロバイダURLを指定する必要があります。-nameserverオプションに指定するプロバイダURLは，usrconf.properties（サーバ管理コマンド用システムプロパティファイル）に幾つかの設定をすることで省略できます。プロバイダURLを省略するための詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」のJ2EEサーバで使用するコマンドの概要に関する説明を参照してください。

10.1.2　バッチサーバを配置する構成のシステムの構築例

Smart Composer機能を使用したシステム構築では，システムを一括構築できます。構築できるシステムの構成には，バッチサーバ用のサービスユニットの配置のしかたによって次の2種類があります。

1台のサーバマシンに一つのサービスユニットを配置する

1台のサーバマシンに複数のサービスユニットを配置する

参考

Smart Composer機能で構築するシステムは，システム内のサーバやサービスユニットの構成をWebシステムという概念で管理します。Webシステムは，簡易構築定義ファイルで定義します。

ここでは，バッチサーバを配置する構成のシステムを一括構築する場合のシステム構築例について説明します。

＜この項の構成＞

(1)　1台のサーバマシンに一つのサービスユニットを配置する構成

(2)　1台のサーバマシンに複数のサービスユニットを配置する構成

(1)　1台のサーバマシンに一つのサービスユニットを配置する構成

1台のサーバマシンに一つのサービスユニットを配置する場合のシステム構成を図に示します。なお，以降のシステム構築の説明は，次の図に示すシステム構築例を使用します。

図10-3　システム構築例

システム構築例で使用している設定を，次に示します。以降の説明では，次に示す内容でシステムを構築しています。

アプリケーションサーバ（アプリケーションサーバ名：apsv1）

管理IPアドレス　192.168.100.11

IPアドレス　192.168.1.11

ポート番号　80

サービスユニット1（サービスユニット名：unit1）

Management Server

ユーザID　cosmi_admin

パスワード　cosmi_admin_passwd

管理IPアドレス　192.168.100.11

(2)　1台のサーバマシンに複数のサービスユニットを配置する構成

サーバマシン内に複数のサービスユニットを配置する場合の構築例を次の図に示します。

図10-4　サーバマシン内に複数のサービスユニットを配置する場合の構築例

この図では，アプリケーションサーバ内に，サービスユニット1とサービスユニット2が配置されています。この場合，複数の業務をそれぞれサービスユニットに対応させているため，サービスユニット1およびサービスユニット2は別のWebシステムとして簡易構築定義ファイルに定義します。なお，複数のサービスユニットを同じWebシステムにも配置できます。

定義の詳細については，「10.5.2　簡易構築定義ファイルの作成例」を参照してください。

10.1.3　バッチサーバを配置する構成のシステムを構築する流れ

ここでは，「10.1.2　バッチサーバを配置する構成のシステムの構築例」で示すシステムを一括構築する場合の，システム構築の流れについて説明します。

バッチサーバを配置する構成のシステムを一括構築する場合の流れを，次の図に示します。

図10-5　バッチサーバを配置する構成のシステムを一括構築する場合の流れ

図中の1.～7.について説明します。

インストール
アプリケーションサーバ，データベースサーバにそれぞれ必要なソフトウェア製品をインストールします。

初期設定

必要に応じて，OSやデータベースなどのホスティング環境を設定します。

アプリケーションサーバでは，環境変数の設定，データベースを使用するための設定，Management Serverの設定および自動起動するための設定，および運用管理エージェントを自動起動するための設定をします。

構成定義
簡易構築定義ファイルで，Webシステムの構成を定義します。簡易構築定義ファイルはエディタを使用して作成しますが，テンプレートファイルが用意されているので，構成の基本情報を設定するだけで運用できます。

DB ConnectorのConnector属性ファイルの編集
DB Connectorを使用する場合，Connector属性ファイルのテンプレートを取得して，編集します。

システムの構築
システムの構築では，次の二つの内容を実施します。

構成定義で作成した簡易構築定義ファイルの情報を基に，Management Server上にシステムの情報モデルを生成する

システムの情報モデルからバッチアプリケーションを実行するシステムを構築する

システムの構築では，システムの情報モデルの生成から，システムの構築まで，一つのコマンドを使用して一括で実行できます。システムの構成として定義されている，すべてのアプリケーションサーバ上にバッチサーバをセットアップし，各論理サーバの環境を設定します。

システムの開始
システム内のすべてのサービスユニットを開始します。サービスユニット開始後，リソースアダプタをインポートし，リソースアダプタを開始します。

チューニング
構築したシステムについて，性能メトリックの相関が適切かどうか多角的に検証し，必要に応じてシステムの構成を変更します。

また，「9.2.3　障害設計」で説明した運用をするためには，次の説明も参照してください。

サービスユニットを自動再起動するための設定（10.10.1参照）

10.2　インストール

各サーバに製品をインストールします。「8.　バッチアプリケーションを実行するシステムの構成の検討」を参照して，各サーバマシンにそれぞれ必要なソフトウェア製品をインストールしてください。

ここでは，「10.1.2　バッチサーバを配置する構成のシステムの構築例」の場合に必要な製品を説明します。ここで説明する製品のうち，Application Serverのインストール方法については，リリースノートを参照してください。そのほかの製品のインストール方法については，各製品のマニュアルを参照してください。

アプリケーションサーバ

Application Server Enterprise

HiRDB Type4 JDBC DriverまたはOracle JDBC Thin Driver※1

データベースサーバ

HiRDBまたはOracle※2

注※1

Cosminexus DABroker Libraryを使用してデータベースにアクセスする場合は，HiRDB Run TimeまたはOracle Clientをインストールする必要があります。

注※2

データベースサーバの初期設定については，HiRDBの場合は，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。Oracleの場合は，Oracleのドキュメントを参照してください。

参考

JP1/SC/DPMのディスク複製OSインストール機能を使用する場合，JP1/SC/DPM管理サーバにJP1/SC/DPMをインストールする必要があります。

10.3　ホスティング環境の設定

Smart Composer機能によって構築されたシステムが動作するために，OSやデータベースなどのホスティング環境の設定が必要な場合があります。ここでは，ホスティング環境の設定について説明します。

Smart Composer機能によって構築されたシステムが使用するリソースと設定の要否を，次の表に示します。なお，各リソースに必要な見積もりの詳細については，「9.1　使用リソースの見積もり」を参照してください。

表10-1　使用リソースの設定要否

分類 | リソース | Windowsの場合 | UNIXの場合
データベース | 最大同時接続数 | ○ | ○
サービスユニット | 共有メモリ | × | ○
プロセス数 | × | ○
スレッド数 | × | ○
ファイルディスクリプタ数 | × | ○

（凡例）

○：必要です。

×：不要です。

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

アプリケーションサーバでは，次の設定をします。

環境変数の設定
アプリケーションサーバで環境変数を設定します。アプリケーションサーバで設定する環境変数については，「6.5.1　環境変数の設定」を参照してください。

データベースを使用するための設定
データベースを設定します。HiRDB，またはOracleを使用する場合に必要な設定については，「6.5.2　データベースを使用するための設定」を参照してください。ただし，バッチサーバでは，グローバルトランザクションは使用できません。また，参照先の記述にある「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

Management Serverの設定
Management Serverを使用するための設定をします。また，必要に応じて，Management Serverを自動起動するための設定もします。Management Serverの設定については，「6.6.2　Management Serverの設定」を参照してください。

運用管理エージェントの設定
運用管理エージェントを自動起動するための設定をします。設定については，「6.5.3　運用管理エージェントの設定」を参照してください。

参考

Cosminexus DABroker Libraryを使用して，データベースに接続する場合には，アプリケーションサーバで次の設定をします。

環境変数の設定
Cosminexus DABroker Libraryを使用しない場合と同じです。設定については，「6.5.1　環境変数の設定」を参照してください。

Cosminexus DABroker Libraryの設定
Cosminexus DABroker Libraryの設定については，「付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）」，または「付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）」を参照してください。

データベースの設定
データベースの設定については，「付録K　データベースの設定」を参照してください。

Management Serverの設定
Cosminexus DABroker Libraryを使用しない場合と同じです。設定については，「6.6.2　Management Serverの設定」を参照してください。

運用管理エージェントの設定
Cosminexus DABroker Libraryを使用しない場合と同じです。設定については，「6.5.3　運用管理エージェントの設定」を参照してください。

10.5　システムの構成定義

ここでは，簡易構築定義ファイルの作成について説明します。テンプレートファイルが提供されているので，システムの基本的な構成情報を編集するだけで作成できます。

「10.1.2　バッチサーバを配置する構成のシステムの構築例」のシステム構成を定義する場合を，ファイル作成例を使用して説明します。

なお，簡易構築定義ファイルで機能を設定したい場合は，マニュアル「Cosminexus　システム構築ガイド」を参照してください。機能の詳細についてはマニュアル「Cosminexus　機能解説」を参照してください。

＜この節の構成＞

10.5.1　簡易構築定義ファイルの設定内容

10.5.2　簡易構築定義ファイルの作成例

10.5.1　簡易構築定義ファイルの設定内容

簡易構築定義ファイルでは，Webシステムの次の構成について設定します。

Webシステムの属性定義（<web-system>タグの定義）

物理ティアの定義（<tier>タグの定義）

物理ティアに属する論理サーバの種類ごとの定義（<tier>タグの<configuration>タグの定義）

データベースを使用するための設定の定義（<tier>タグの<configuration>タグの定義）※

サービスユニットの定義（<unit>タグの定義）

サービスユニットを構成するホストの定義（<unit>タグの<allocation-host>タグの定義）

ホストが属する物理ティアの論理サーバごとの定義（<unit>タグの<allocation-host>タグの<define-server>タグの定義）

ホストの定義（<host>タグの定義）

注※

データベースを使用するための設定の定義については，「6.5.2　データベースを使用するための設定」を参照してください。

物理ティアおよびサービスユニットのコンフィグレーション定義で，同じパラメタを指定した場合は，サービスユニットの定義，物理ティアの定義の順に優先して適用されます。

なお，設定内容の詳細については，「13.7　簡易構築定義ファイル」，および「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

注意

JP1/SC/DPMを利用してシステムを構築する場合は，簡易構築定義ファイルの物理ティアの定義で，バッチサーバのコンフィグレーション（<configuration>タグ）の設定が必要になります。JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタを次の表に示します。

表10-2　JP1/SC/DPMを利用してシステムを構築する場合に，物理ティアの定義で設定が必要なパラメタ

論理サーバの種類（<tier>タグ配下の<logical-server-type>タグの指定値） | <param-name>タグの指定値 | <param-value>タグの指定値
j2ee-server | realservername | 実サーバ名
webserver.connector.http.bind_host.value※ | true
webserver.connector.ajp13.bind_host.value※ | true
manager.mevent.sender.bind.host.value※ | true
vbroker.se.iiop_tp.host.value※ | true
mngagent.connector.host.value※ | true

注※

Management Serverが稼働するホスト（サーバマシン）が，複数個のIPアドレスを持っている構成の場合に設定が必要です。

10.5.2　簡易構築定義ファイルの作成例

簡易構築定義ファイルの内容は，バッチサーバの配置のしかたによって異なります。1台のサーバマシン内に一つのバッチサーバを配置する場合，および1台のサーバマシン内に複数のバッチサーバを配置する場合の簡易構築定義ファイルの作成例を示します。

なお，Cosminexusでは，簡易構築定義ファイルのテンプレートファイル（cmxdefcombinedmodel.xml）を提供しています。テンプレートファイルは次の場所に提供されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合

/opt/Cosminexus/manager/config/templates/

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。

テンプレートファイルを任意の場所にコピーし，名称を変更します。なお，ここでは，ファイル名を「MyWebSystemDef.xml」に変更して，構成を定義しています。

＜この項の構成＞

(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合

(2)　1台のサーバマシン内に複数のバッチサーバを配置する場合

(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合

システムの情報を簡易構築定義ファイルに定義します。ここでは，「10.1.2(1)　1台のサーバマシンに一つのサービスユニットを配置する構成」の設定情報の，簡易構築定義ファイル（MyWebSystemDef.xml）の作成例を次に示します。

MyWebSystemDef.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>j2ee-tier</tier-type>※1
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>※2
       <param>
          <param-name>batch.service.enabled</param-name>※3
          <param-value>true</param-value>※3
       </param>
       <param>
          <param-name>use.security</param-name>※4
          <param-value>false</param-value>※4
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>j2ee-tier</hosts-for>※1
       <define-server>
         <logical-server-name>BatchServer</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>PRF</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
</model-definition>

注1　太字の部分が編集部分です。

注2　バッチサーバの場合，負荷分散機を使用しません。このため，テンプレートにある<load-balancer>タグの記述は削除してください。

注※1　バッチサーバの場合，物理ティアとしてj2ee-tierを使用するため，「j2ee-tier」を指定します。

注※2　バッチサーバは論理J2EEサーバとして定義します。このため，<logical-server-type>タグには，「j2ee-server」を指定します。

注※3　バッチサーバを構築する場合は，必ずこの設定を記載してください。

注※4　SecurityManagerを解除するための設定です。バッチサーバの場合，SecurityManagerを使用しないため，この定義は必ず指定してください。

(2)　1台のサーバマシン内に複数のバッチサーバを配置する場合

Smart Composer機能では，1台のサーバマシン内に複数のサービスユニットを配置するシステムを構築できます。1台のサーバマシン内に複数のバッチサーバを配置する場合は，簡易構築定義ファイルで複数のバッチサーバ用のサービスユニットを定義します。

ただし，1台のサーバマシンに複数のバッチサーバを配置すると，1台のサーバマシン内に，同じ種類の論理サーバが複数存在することになります。このため，簡易構築定義ファイルを作成する際には，各論理サーバのコンフィグレーションで，次に示す項目の指定値を重複しないようにしてください。

表10-3　論理サーバごとに重複しないように設定する項目

論理サーバの種類 | 項目 | param-nameの指定値
J2EEサーバ※ | 管理用サーバのポート番号 | ejbserver.http.port
ajp13のポート番号 | webserver.connector.ajp13.port
RMIレジストリのポート番号 | ejbserver.rmi.naming.port
パフォーマンストレーサ | PRF識別子 | PRFID

注※　バッチサーバは論理J2EEサーバとして定義します。

参考

1台のサーバマシン内にある複数のサービスユニットを同時に起動しない運用をする場合は，各サービスユニットの同じ種類の論理サーバに同じ値を設定できます。

「10.1.2(2)　1台のサーバマシンに複数のサービスユニットを配置する構成」に示す構成の場合，1台のサーバマシンには，サービスユニット1とサービスユニット2が配置されます。

この場合，簡易構築定義ファイルで表10-3に示す項目が，サービスユニット1と定義が重複しないように，サービスユニット2の設定を変更してください。簡易構築定義ファイル（MyWebSystemDef.xml）の作成例を次に示します。

MyWebSystemDef.xmlファイル

 <!-- Webシステム1の属性定義 -->
 <web-system>
   <name>MyWebSystem1</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>j2ee-tier</tier-type>※1
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>※2
       <param>
          <param-name>batch.service.enabled</param-name>※3
          <param-value>true</param-value>※3
       </param>
       <param>
          <param-name>use.security</param-name>※4
          <param-value>false</param-value>※4
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>j2ee-tier</hosts-for>※1
       <define-server>
         <logical-server-name>BatchServer01</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>PRF01</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- Webシステム2の属性定義 -->
 <web-system>
   <name>MyWebSystem2</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>j2ee-tier</tier-type>※1
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <!-- 管理用サーバのポート番号 -->
       <param>
         <param-name>ejbserver.http.port</param-name>※5
         <param-value>8081</param-value>※5
       </param>
       <!-- ajp13のポート番号 -->
       <param>
         <param-name>webserver.connector.ajp13.port</param-name>※5
         <param-value>8008</param-value>※5
       </param>
       <!-- RMIレジストリのポート番号 -->
       <param>
         <param-name>ejbserver.rmi.naming.port</param-name>※5
         <param-value>23153</param-value>※5
       </param>
     </configuration>
     <configuration>
       <logical-server-type>performance-tracer</logical-server-type>※5
       <!-- PRF識別子 -->
       <param>
         <param-name>PRFID</param-name>※5
         <param-value>PRF_ID2</param-value>※5
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     <name>unit2</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>
       <hosts-for>j2ee-tier</hosts-for>※1
       <define-server>
         <logical-server-name>BatchServer02</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>PRF02</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>apsv1</host-name>
   <agent-host>192.168.100.11</agent-host>
 </host>
</model-definition>

注1　太字の部分が編集部分です。

注2　バッチサーバの場合，負荷分散機を使用しません。このため，テンプレートにある<load-balancer>タグの記述は削除してください。

注※1　バッチサーバの場合，物理ティアとしてj2ee-tierを使用するため，「j2ee-tier」を指定します。

注※2　バッチサーバは論理J2EEサーバとして定義します。このため，<logical-server-type>タグには，「j2ee-server」を指定します。

注※3　バッチサーバを構築する場合は，必ず設定してください。

注※4　SecurityManagerを解除するための設定です。バッチサーバの場合，SecurityManagerを使用しないため，この項目は必ず設定してください。

注※5　これらの項目は，サービスユニット1と定義が重複しないように，サービスユニット2の設定を変更してください。

なお，設定内容の詳細については，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

10.6　DB ConnectorのConnector属性ファイルの編集

DB Connectorを使用してデータベースに接続するバッチアプリケーションを開発している場合，バッチサーバでDB Connectorの設定が必要になります。DB Connectorを使用する場合，システムを起動する前にConnector属性ファイルを編集できます。

ここでは，DBConnector_HiRDB_Type4_CP.rarを使用した場合の，DB ConnectorのConnector属性ファイルの取得，および編集手順を例に使用して説明します。DBConnector_HiRDB_Type4_CP.rar以外のRARファイルを使用する場合は，利用するDB ConnectorのRARファイルに読み替えてください。ただし，バッチサーバの場合，グローバルトランザクションは使用できないため，グローバルトランザクション用のRARファイルは使用できません。なお，バッチサーバで使用できるRARファイルについては，マニュアル「Cosminexus　システム構築ガイド」のリソースアダプタの設定に関する説明を参照してください。

Connector属性ファイルの編集手順について次に示します。

Connector属性ファイルを取得します。
DB Connectorについては，CosminexusがConnector属性ファイルのテンプレートファイルを提供しています。次の場所からテンプレートファイルを取得してください。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates

UNIXの場合

/opt/Cosminexus/CC/admin/templates

DBConnector_HiRDB_Type4_CP.rarを使用する場合，DBConnector_HiRDB_Type4_CP_cfg.xmlを取得します。
Cosminexusが提供しているConnector属性ファイルのテンプレート，およびテンプレートファイルに関する注意事項については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Connector属性ファイルを編集します。
取得したConnector属性ファイルを任意の場所に保存します。ここでは，Connector属性ファイルを，MyDBConnectorAttr.xmlの名前で保存します。
保存したConnector属性ファイルで，データベースへの接続の設定など必要な項目を編集してください。
なお，バッチサーバの場合，リソースへのルックアップには，ユーザ指定名前空間機能を使用してリソースアダプタをルックアップしてください。ユーザ指定名前空間機能での任意のルックアップ名称は，Connector属性ファイルで設定します。

Connector属性ファイルを編集したあとのDB Connectorのデプロイ手順については，「10.8.2　リソースアダプタのインポートと開始」を参照してください。

10.7　システムの一括構築

システムの一括構築では，情報モデルの生成，その情報モデルを基にしたバッチサーバのセットアップ，および各論理サーバの環境設定を一つのコマンドで一括で実施します。

1台のサーバマシンに一つのサービスユニットを配置する構成のシステムを一括構築する手順を，次に示します。

アプリケーションサーバでcmx_build_systemコマンドを使用してシステムを一括構築します。cmx_build_systemコマンドの-fオプションには，簡易構築定義ファイルを指定します。ここでは，「10.5.2(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合」で作成した簡易構築定義ファイルを使用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml

10.8　システムの開始

ここでは，システムの開始に必要な次に示す作業について説明しています。

システムの一括起動

リソースアダプタのインポートと開始

＜この節の構成＞

10.8.1　システムの一括起動

10.8.2　リソースアダプタのインポートと開始

10.8.1　システムの一括起動

「10.7　システムの一括構築」で構築したシステムを一括起動します。

システムの一括起動システムを一括起動する手順を，次に示します。

システムを開始します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

cmx_list_statusコマンドを使用して，システム内のすべてのサービスユニットが起動されていることを確認してください。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_list_status -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem
unit1,MyWebSystem,done,working

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_list_status -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem
unit1,MyWebSystem,done,working

cmx_start_targetコマンドおよびcmx_list_statusコマンドの-sオプションには，簡易構築定義ファイルMyWebSystemDef.xmlの<web-system>タグの<name>タグで指定したWebシステム名を指定します。

10.8.2　リソースアダプタのインポートと開始

バッチアプリケーションからデータベースに接続するには，DB Connectorというリソースアダプタを使用します。リソースアダプタのインポートと開始には，サーバ管理コマンドを使用します。

ここでは，次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表10-4　例で使用するリソースアダプタのファイル名と表示名

種別 | 名前
ファイル名 | DBConnector_HiRDB_Type4_CP.rar※
表示名 | DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名 | MyDBConnectorAttr.xml

注※　HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしでHiRDBに接続する場合に使用するRARファイルです。

DBConnector_HiRDB_Type4_CP.rar以外のRARファイルを使用する場合は，利用するDB ConnectorのRARファイルに読み替えてください。ただし，バッチサーバの場合，グローバルトランザクションは使用できないため，グローバルトランザクション用のRARファイルは使用できません。なお，「10.6　DB ConnectorのConnector属性ファイルの編集」でConnector属性ファイルの取得と編集が済んでいることを前提にしています。

DB Connectorを使用する場合のリソースアダプタのインポートと開始の手順を次に示します。サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」，サーバ管理コマンドでのリソースアダプタの操作の詳細についてはマニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リソースアダプタをインポートします。
サーバ管理コマンドを使用して，リソースアダプタをバッチサーバへインポートします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres BatchServer -nameserver corbaname::192.168.1.11:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres BatchServer -nameserver corbaname::192.168.1.11:900 -type rar -f /opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar

リソースアダプタをデプロイします。
サーバ管理コマンドを使用して，バッチサーバにリソースアダプタをデプロイします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjdeployrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

編集したConnector属性ファイルをリソースアダプタに反映します。
サーバ管理コマンドを使用して，Connector属性ファイルをリソースアダプタに反映します。-cオプションには，「10.6　DB ConnectorのConnector属性ファイルの編集」で編集したConnector属性ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

リソースアダプタの接続を確認します。
サーバ管理コマンドを使用して，リソースアダプタの接続を確認します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjtestres BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

リソースアダプタを開始します。
サーバ管理コマンドを使用して，リソースアダプタを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。簡易構築定義ファイルに実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。論理サーバ名は，簡易構築定義ファイルのサービスユニットの定義内に，<logical-server-name>タグで指定している値です。

なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。バッチサーバの場合，<種別>には「J2EE」と表示されます。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，「10.5.2(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合」のサービスユニット1を対象としています。「10.5.2(2)　1台のサーバマシン内に複数のバッチサーバを配置する場合」のように，複数のサービスユニットを配置している場合は，各サービスユニットに対してサーバ管理コマンドを実行します。その場合，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

BatchServer：簡易構築定義ファイルの<logical-server-name>タグの指定値

参考

リソースアダプタのインポートと開始は，Smart Composer機能のコマンドでも実行できます。詳細については，「6.11.2　リソースアダプタのインポートと開始」の参考情報を参照してください。

10.9　チューニング

チューニングでは，システムのパフォーマンスを生かす最適の設定を見つける作業（パフォーマンスチューニング）を実施します。構築した環境で性能メトリックの相関が適切かどうか多角的に検証し，パラメタの調整やボトルネックの調査，解消によってパフォーマンスを向上させていきます。パフォーマンスチューニングの詳細については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。

なお，パラメタを変更するとシステムが動作するために必要なリソースも変更する必要があります。システムが動作するために必要なリソースの見積もりについては，「9.1　使用リソースの見積もり」を参照してください。

チューニングの流れを次の図に示します。

図10-6　チューニングの流れ

システムの設定変更には，システムの情報モデルの変更とリソースアダプタの設定変更があります。(1)に従ってパラメタを変更してから，(2)に従ってシステムの設定を変更します。

＜この節の構成＞

(1)　パラメタの編集

(2)　システムの設定変更

(1)　パラメタの編集

簡易構築定義ファイル（MyWebSystemDef.xml）およびConnector属性ファイルについてパラメタの値を編集して，チューニングを実施します。編集できるパラメタについてはマニュアル「Cosminexus　システム構築ガイド」を参照してください。

なお，チューニングできる項目，およびパフォーマンスチューニングの詳細については，マニュアル「Cosminexus　システム設計ガイド」のパフォーマンスチューニングに関する説明を参照してください。Connector属性ファイル，およびアプリケーション統合属性ファイルの詳細についてはマニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(2)　システムの設定変更

cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデルを変更します。変更した情報モデルを実システムに適用します。

なお，設定変更をする場合は，バッチアプリケーションが停止していることを確認してから実施してください。

リソースアダプタを停止します。
バッチアプリケーションからリソースに接続している場合は，サーバ管理コマンドを使用してリソースアダプタを停止します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjstoprar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

システム内のサービスユニットを停止します。
システムの情報モデルを変更する場合だけ停止します。システムの情報モデルを変更しない場合は，手順4.に進んでください。
システムの情報モデルを変更する場合は，cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを停止します。なお，システムが停止している場合はこの手順は不要です。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

システムの情報モデルを変更して実システムに展開し，システムを一括起動します。
システムの情報モデルを変更する場合だけ実施します。

cmx_build_systemコマンドを使用して，Management Server上のシステムの情報モデルを変更し，変更した情報モデルからシステムを構築します。-fオプションには，パフォーマンスチューニングを実施した簡易構築定義ファイルを指定します。-fオプションで指定したファイルの内容をシステムに反映するには，-changeオプションを指定します。cmx_build_systemコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -f MyWebSystemDef.xml -change -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

リソースアダプタのプロパティを変更します。
リソースアダプタのプロパティを変更する場合だけ実施します。ここでは，サーバ管理コマンドを使用して，次の作業を実施しています。

Connector属性ファイルを取得します。

Connector属性ファイルのプロパティを編集します。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjgetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

# /opt/Cosminexus/CC/admin/bin/cjstartrar BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。簡易構築定義ファイルに実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。論理サーバ名は，簡易構築定義ファイルのサービスユニットの定義内に，<logical-server-name>タグで指定している値です。

なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。バッチサーバの場合，<種別>には「J2EE」と表示されます。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作

ここで説明する操作のうち，サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

なお，ここで示すサーバ管理コマンドの実行例は，「10.5.2(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合」のサービスユニット1を対象としています。「10.5.2(2)　1台のサーバマシン内に複数のバッチサーバを配置する場合」のように，複数のサービスユニットを配置している場合は，各サービスユニットに対してサーバ管理コマンドを実行します。その場合，コマンド実行例中の値を次のように読み替えて同じ操作をしてください。

BatchServer：簡易構築定義ファイルの<logical-server-name>タグの指定値

10.10　障害に対応したシステムの構築

障害に対応したシステムとして，ここでは，サービスユニットを自動再起動するシステムの構築について説明します。

＜この節の構成＞

10.10.1　サービスユニットを自動再起動するための設定

10.10.1　サービスユニットを自動再起動するための設定

Cosminexusでは，システムに障害が発生しそうな場合の動作をManagementアクションで定義できます。ManagementアクションにSmart Composer機能のコマンドを定義しておくことで，システムの運用中に障害が発生しそうな場合にサービスユニットを自動再起動できるため，迅速な障害対応ができます。

障害の発生しそうな状況になるとManagementイベントが発行されます。障害の発生しそうな状況は，例えばリソース枯渇監視機能でリソースの枯渇を事前に検知できます。そのManagementイベントと対応づけたManagementアクションを実行し，障害が発生しそうなサービスユニットを自動的に再起動して，障害の発生を事前に回避します。Managementアクションによるサービスユニットの自動再起動処理を次の図に示します。

図10-7　Managementアクションによるサービスユニットの自動再起動処理

Smart Composer機能を使用すると，JavaVMのフルガーベージコレクションやスレッドなどのリソース枯渇を事前検知した場合，問題の発生したサービスユニットを自動再起動できます。

例として，バッチサーバのフルガーベージコレクションの予兆を検知した場合に，Managementアクションを使用してサービスユニットを自動再起動する方法について説明します。必要な操作は次のとおりです。

Managementアクション実行コマンドの作成

Managementイベントの発行の設定

Managementイベント発行用メッセージIDリストファイルおよびリソース監視機能の設定

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

それぞれの操作の概要を説明します。

なお，リソース枯渇監視機能およびManagementアクションの概要については，マニュアル「Cosminexus　機能解説」のシステムの運用支援に関する説明を，設定については，マニュアル「Cosminexus　システム構築ガイド」のManagementイベントによる処理の自動実行の設定に関する説明を参照してください。

●Managementアクション実行コマンドの作成

JavaVMのフルガーベージコレクションやスレッドなどのリソース枯渇を事前検知した場合，Managementイベントが発行されます。ここでは，Managementイベントを受信したときにManagement Serverが実行するManagementアクション実行コマンドの作成について説明します。

バッチサーバでフルガーベージコレクションの予兆を検知した場合に，サービスユニットを再起動するManagementアクション実行コマンドを作成します。

障害の発生したバッチサーバを含むサービスユニットを自動閉塞します。

障害の発生したバッチサーバを再起動します。

サービスユニットを開始します。

Managementアクション実行コマンドのサンプルファイルをコピーして，Managementアクション実行コマンド（バッチファイルまたはシェルスクリプト）を作成してください。Managementアクション実行コマンドの作成方法はJ2EEサーバの場合と同じです。詳細は，「6.19.2(1)　Managementアクション実行コマンドの作成」を参照してください。

●Managementイベントの発行の設定

バッチサーバのManagementイベントの発行が有効になっていない場合は，Managementイベントの発行を有効にします。Managementイベントの発行を有効にするには，次の手順で設定を変更してください。

簡易構築定義ファイルの編集

システムの設定の一括変更

Managementイベントの発行の設定については，J2EEサーバの場合と同じです。設定方法については，「6.19.2(2)　Managementイベントの発行の設定」を参照してください。

●Managementイベント発行用メッセージIDリストファイルおよびリソース枯渇監視機能の設定

Managementイベントを発行するために，Managementイベント発行用メッセージIDリストファイルの設定や，リソース枯渇監視機能の設定が必要な場合があります。

通常はデフォルトのまま使用するため，設定の必要はありません。必要に応じて設定してください。

なお，Managementイベント発行用メッセージIDリストファイルやリソース枯渇監視機能の設定については，「6.19.2(3)　Managementイベント発行用メッセージIDリストファイルおよびリソース枯渇監視機能の設定」を参照してください。

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

Managementアクションの定義，メッセージIDとManagementアクションとのマッピングなどは，Managementアクション実行用プロパティファイル（maction.properties）に定義します。maction.propertiesファイルの設定については，「6.19.2(4)　Managementアクション実行用プロパティファイルの設定」を参照してください。

ただし，バッチサーバの場合は，Managementアクション実行用プロパティファイル（maction.properties）の下記のプロパティ名について，下線部の「combined-tier」を「j2ee-tier」に置き換えてお読みください。

# Mapping of Logical server and Management actions.
maction.tier.MyWebSystem.combined-tier.mactions=restart_unit

11.　バッチアプリケーションを実行するシステムの運用

この章では，バッチアプリケーションを実行するシステムの運用について説明します。なお，システム運用で使用するコマンドやファイルについては，「12.　コマンド」および「13.　ファイル」を参照してください。

＜この章の構成＞

11.1　システム運用の概要

11.2　日常運用の操作

11.3　システム全体の設定変更

11.4　システムのスケールアウトとスケールイン

11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

11.6　構築済みのシステムの移行

11.7　トラブルへの対処

11.8　システムの削除

11.1　システム運用の概要

ここでは，Smart Composer機能を使用した運用操作について説明します。そのほかの運用作業については，「9.2　運用・障害設計」を参照してください。

Smart Composer機能を使用した運用操作では，一括起動・一括停止の日常運用の操作，スケールインやスケールアウト，環境の移行や削除などが実施できます。ここでは，次に示す運用操作の手順を説明しています。

日常運用（11.2参照）

サービスユニットの一括起動

サービスユニットの一括停止

システムの一括設定変更（11.3参照）

システムの構成変更

システムのスケールアウト（11.4.1，および11.5参照）

システムのスケールイン（11.4.2および11.5参照）

構築済みのシステムの移行（11.6参照）

システムの削除（11.8参照）

それぞれの運用の概要については，「9.2.2　運用設計」を参照してください。また，Smart Composer機能のコマンドの詳細については「12.　コマンド」を，サーバ管理コマンドの詳細についてはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

11.2　日常運用の操作

Smart Composer機能では，日常運用の操作として，システムの一括起動および一括停止がサービスユニット単位で実施できます。システム内のすべてのサービスユニットを一括で起動および停止することも，特定のサービスユニットだけを一括で起動および停止することもできます。

＜この節の構成＞

11.2.1　すべてのサービスユニットの一括起動と一括停止

11.2.2　サービスユニット単位の一括起動と一括停止

11.2.1　すべてのサービスユニットの一括起動と一括停止

一括起動をするにはcmx_start_targetコマンドを，一括停止をするには，cmx_stop_targetコマンドを使用します。システム内のすべてのサービスユニットを一括起動したり，一括停止したりするには，これらのコマンドを使用するときに，-unitオプションの指定を省略します。

ここでは，システム内のすべてのサービスユニットを，一括起動および一括停止する手順について説明します。

＜この項の構成＞

(1)　一括起動

(2)　一括停止

(1)　一括起動

システム内のすべてのサービスユニットを一括で起動するときの手順を次に示します。リソースアダプタが停止している場合は，サービスユニットを起動したあとで開始する必要があります。リソースアダプタを開始するには，cjstartrarコマンドを使用します。リソースアダプタの開始については，「10.8.2　リソースアダプタのインポートと開始」を参照してください。

cmx_start_targetコマンドの-modeオプションにALLを指定して，システム内のすべてのサービスユニットを稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

(2)　一括停止

システム内のすべてのサービスユニットを一括で停止するときの手順を次に示します。

cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

11.2.2　サービスユニット単位の一括起動と一括停止

一括起動をするにはcmx_start_targetコマンドを，一括停止をするにはcmx_stop_targetコマンドを使用します。特定のサービスユニットを一括起動したり，一括停止したりするには，これらのコマンドを使用するときに，-unitオプションにサービスユニット名を指定します。

ここでは，特定のサービスユニットだけを，一括起動および一括停止する手順について説明します。

＜この項の構成＞

(1)　一括起動

(2)　一括停止

(1)　一括起動

特定のサービスユニットを一括で起動するときの手順を次に示します。

リソースアダプタが停止している場合は，サービスユニットを起動したあとで，開始する必要があります。リソースアダプタを開始するには，cjstartrarコマンドを使用します。リソースアダプタの開始については，「10.8.2　リソースアダプタのインポートと開始」を参照してください。

cmx_start_targetコマンドの-modeオプションにALLを指定して，サービスユニット「unit1」を稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

参考

Smart Composer機能のコマンドでも，リソースアダプタの一括開始ができます。ただし，Smart Composer機能のコマンドでリソースアダプタを開始するには，Smart Composer機能のコマンドを使用してリソースアダプタをデプロイしておく必要があります。Smart Composer機能のコマンドを使用したリソースアダプタのデプロイについては，「6.11.2(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始」を参照してください。

リソースアダプタの一括開始には，cmx_start_resourceコマンドを使用します。コマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

(2)　一括停止

特定のサービスユニットを一括で停止するときの手順を次に示します。

cmx_stop_targetコマンドを使用して，サービスユニット「unit1」を停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit1

参考

Smart Composer機能のコマンドでも，リソースアダプタの一括停止ができます。ただし，Smart Composer機能のコマンドでリソースアダプタを停止するには，Smart Composer機能のコマンドを使用してリソースアダプタをデプロイしておく必要があります。Smart Composer機能のコマンドを使用したリソースアダプタのデプロイについては，「6.11.2(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始」を参照してください。

リソースアダプタの一括停止には，cmx_stop_resourceコマンドを使用します。コマンドの詳細については，「12.3　コマンドの詳細」を参照してください。

11.3　システム全体の設定変更

Smart Composer機能では，システム全体の設定を変更できます。ここでは，システム全体の設定変更について説明します。

＜この節の構成＞

11.3.1　システムの設定の一括変更

11.3.1　システムの設定の一括変更

Smart Composer機能を使用して，システムの設定を一括変更できます。設定を変更するには，次の内容を実施します。

簡易構築定義ファイルの編集

設定の一括変更

注意

バッチアプリケーションを実行するシステムの設定を変更する場合，次のパラメタの値は変更しないでください。

batch.service.enabled（「14.5.8　バッチサーバの拡張パラメタ」を参照）

use.security（「14.5.12　SecurityManagerの使用を設定するパラメタ」を参照）

システムの設定の一括変更の手順について説明します。

＜この項の構成＞

(1)　簡易構築定義ファイルの編集

(2)　設定の一括変更

(1)　簡易構築定義ファイルの編集

システム構築で使用した簡易構築定義ファイルの内容を編集します。ここでは，「10.5.2(1)　1台のサーバマシン内に一つのバッチサーバを配置する場合」で作成したMyWebSystemDef.xmlファイルを編集します。

システム構築で使用した簡易構築定義ファイルを編集します。
ここでは，サーバの稼働性能を監視するように設定します。
設定後のMyWebSystemDef.xmlファイルを次に示します。

<!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>j2ee-tier</tier-type>
     <!-- バッチサーバの稼働性能監視を行う設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
          <param-name>batch.service.enabled</param-name>※
          <param-value>true</param-value>※
       </param>
       <param>
          <param-name>use.security</param-name>※
          <param-value>false</param-value>※
       </param>
       <param>
         <param-name>ejbserver.instrumentation.enabled</param-name>
         <param-value>true</param-value>
       </param>
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     ：
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   ：
 </host>
 </web-system>
</model-definition>

注　太字の部分が編集部分です。

注※　パラメタの値を変更しないでください。

なお，物理ティアに指定できるパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

(2)　設定の一括変更

変更した簡易構築定義ファイルの内容を基に，システムの設定を一括で変更します。

システムが稼働している場合は，システムを停止します（必要に応じて）。
cmx_stop_targetコマンドを使用して，システム内のすべてのサービスユニットを一括停止します。このとき，コマンドの-modeオプションに「ALL」を指定して，停止状態にします。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem -mode ALL

変更した簡易構築定義ファイルの内容を実際のシステムに展開します。
cmx_build_systemコマンドに-changeオプションを指定して，(1)で変更した簡易構築定義ファイルの内容をシステムに適用します。-fオプションには，(1)で作成した簡易構築定義ファイルを指定します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml -change

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f MyWebSystemDef.xml -change

システムを開始します。
cmx_start_targetコマンドを使用して，システム内のすべてのサービスユニットを一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

11.4　システムのスケールアウトとスケールイン

Smart Composer機能を使用すると，業務全体を停止することなく，システムの構成を変更できます。システムの規模を拡張する場合は，システムをスケールアウトします。また，システムの規模を縮小する場合は，システムをスケールインします。

なお，追加するアプリケーションサーバのセットアップに，JP1/SC/DPMのディスク複製OSインストール機能を利用することもできます。この機能を利用すると，すでに稼働しているホストの環境を複製して，新規に作成するホストに対してOSや必要なアプリケーションのインストール，および環境設定が一括で操作できます。JP1/SC/DPMを利用する場合の，システムのスケールアウトの手順については，「11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン」を参照してください。

＜この節の構成＞

11.4.1　システムのスケールアウト

11.4.2　システムのスケールイン

11.4.1　システムのスケールアウト

「10.1.2(1)　1台のサーバマシンに一つのサービスユニットを配置する構成」を基に構築したシステムをスケールアウトする手順について説明します。

システムをスケールアウトするには，次の内容を実施します。

構成変更定義ファイルの作成

システムの情報モデルの変更

サービスユニットの追加

システムのスケールアウトの手順について説明します。

なお，ここでは，既存のサーバマシンに，次に示すサービスユニットを追加する場合を例にして，説明しています。

ホスト名：apsv1

サービスユニット名：unit3

バッチサーバの論理サーバ名：BatchServer03

パフォーマンストレーサの論理サーバ名：PRF03

参考

サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名

サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。構成変更定義ファイルに実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。論理サーバ名は，構成変更定義ファイルのサービスユニットの定義内に，<logical-server-name>タグで指定している値です。

なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。バッチサーバの場合，<種別>には「J2EE」と表示されます。論理サーバ名の定義ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

注意

システムの構成を変更するとシステムが動作するために必要なリソースも変更する必要があります。システムが動作するために必要なリソースの見積もりについては，「9.1　使用リソースの見積もり」を参照してください。

＜この項の構成＞

(1)　構成変更定義ファイルの作成

(2)　システムの情報モデルの変更

(3)　サービスユニットの追加

(1)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルを作成します。
サービスユニット・ホスト追加用の構成変更定義ファイル（cmxaddcombinedmodel.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

UNIXの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemAdd.xml」に変更しています。

コピーした構成変更定義ファイルを編集します。
MyWebSystemAdd.xmlファイルを編集します。ここでは，追加するサービスユニットの内容と，ホストの定義をします。
設定後のMyWebSystemAdd.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <web-system>
   <name>MyWebSystem</name>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>unit3</name>
     <allocated-host>
       <host-ref>apsv1</host-ref>※
       <hosts-for>j2ee-tier</hosts-for>
       <define-server>
         <logical-server-name>BatchServer03</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>PRF03</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>

 </web-system>
</unit-addition>

注　太字の部分が編集部分です。

注※　サービスユニットを追加する既存のサーバマシンのホスト名を指定します。この場合，既存のサーバマシンを使用するため，ホストの定義は不要です。

(2)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverが保持するシステムの情報モデルに反映します。

システムの情報モデルを変更します。
cmx_change_modelコマンドに，(1)で作成した構成変更定義ファイルを指定して，Management Serverが保持するシステムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_change_model -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemAdd.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_change_model -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemAdd.xml

(3)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，(2)で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

追加したサービスユニットを起動します。
cmx_start_targetコマンドを使用して，追加したサービスユニット「unit3」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem -unit unit3

追加したサービスユニットのリソースアダプタをインポートし，開始します。
ここでは，サーバ管理コマンドを使用して，次の内容を実施しています。ファイル名をDBConnector_HiRDB_Type4_CP.rar，表示名をDB_Connector_for_HiRDB_Type4，Connector属性ファイルのファイル名をMyDBConnectorAttr.xmlとした場合の手順を例にして説明します。DBConnector_HiRDB_Type4_CP.rar以外のRARファイルを使用する場合は，利用するDB ConnectorのRARファイルに読み替えてください。

リソースアダプタをインポートします。

バッチサーバにリソースアダプタをデプロイします。

Connector属性ファイルをリソースアダプタに反映します。

リソースアダプタの接続を確認します。

リソースアダプタを開始します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjimportres BatchServer03 -nameserver corbaname::192.168.1.11:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml※

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

UNIXの場合

# /opt/Cosminexus/CC/admin/bin/cjimportres BatchServer03 -nameserver corbaname::192.168.1.11:900 -type rar -f <Cosminexusインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

# /opt/Cosminexus/CC/admin/bin/cjdeployrar BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjsetrarprop BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml※

# /opt/Cosminexus/CC/admin/bin/cjtestres BatchServer -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

# /opt/Cosminexus/CC/admin/bin/cjstartrar BatchServer03 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

注※

サービスユニット1のリソースアダプタに反映したConnector属性ファイルを使用します。Connector属性ファイルを保管していない場合は，サービスユニット1にデプロイしたリソースアダプタからサーバ管理コマンド（cjgetrarprop）を使用して取得します。取得したConnector属性ファイルは必要に応じて編集します。

11.4.2　システムのスケールイン

Smart Composer機能を使用すると，業務全体を停止することなく，システムの構成を変更できます。システムの規模を縮小する場合は，システムをスケールインします。

なお，システムのスケールインについては，J2EEアプリケーションを実行するシステムと同じです。システムのスケールインについては，「7.6.1　WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールイン」を参照してください。参照の際には次の点に注意してください。

注意

システムの構成を変更するとシステムが動作するために必要なリソースも変更する必要があります。システムが動作するために必要なリソースの見積もりについては，「9.1　使用リソースの見積もり」を参照してください。

参考

システムを削除して，システム単位でもスケールインできます。この場合は，cmx_stop_targetコマンドおよびcmx_delete_systemコマンドで，削除対象のシステムを指定します。各コマンドの詳細については，「12.3　コマンドの詳細」の「cmx_stop_target」および「cmx_delete_system」を参照してください。

なお，cmx_delete_systemコマンドを実行しても，バッチサーバの環境削除などのアンセットアップを実行しません。cmx_delete_systemコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。

11.5　JP1/SC/DPMを利用したシステムのスケールアウトとスケールイン

Smart Composer機能を使用してシステムをスケールアウトする場合に，追加するアプリケーションサーバのセットアップにJP1/SC/DPMのディスク複製OSインストール機能を利用できます。この場合，通常のシステムのスケールアウトの手順の前に，複製元のディスクイメージを作成する準備が必要です。

なお，JP1/SC/DPMを利用して構築したシステムのスケールインについては，「7.7.3　JP1/SC/DPMを利用して構築したシステムのスケールイン」を参照してください。参照の際には次の点に注意してください。

スケールインをする場合は，バッチアプリケーションの処理が完了してから実施してください。

バッチサーバでは負荷分散機を使用しないため，負荷分散機に関する記述は該当しません。

JP1/SC/DPMを使用して，アプリケーションサーバのディスクイメージを複製し，そのディスクイメージに従って，新たなアプリケーションサーバにOSやアプリケーションをインストールします。次に，Smart Composer機能のコマンドを使用して，複製先アプリケーションサーバの情報をシステムにスケールアウトします。スケールアウトの概要については，「7.7.2　ホスト単位管理モデルでのシステムのスケールアウト」を参照してください。

なお，スケールアウトの方法は，J2EEアプリケーションを実行するシステムと同じです。ここでは，システムのスケールアウトの準備およびスケールアウトで実施する内容と参照先について説明します。

スケールアウトの準備

システムのスケールアウトの準備とは，複製元のディスクイメージを作成する作業です。システム構築が終わって，運用環境が整ったところで実施します。スケールアウトの準備では次の内容を実施します。

複製元アプリケーションサーバでの準備
複製元アプリケーションサーバで，JP1/SC/DPMでのディスクイメージ作成のための準備をします。準備方法については，「7.7.2(1)　複製元アプリケーションサーバでの準備」を参照してください※1※2。

スケールアウト用ディスクイメージの作成
JP1/SC/DPMを使用して，複製元アプリケーションサーバからディスクイメージを作成します。作成方法については，「7.7.2(2)　JP1/SC/DPMを使用したスケールアウト用ディスクイメージの作成」を参照してください※1。

注※1　バッチサーバの場合，J2EEアプリケーションに関する記述は該当しません。

注※2　バッチサーバの場合，負荷分散機を使用しません。このため，参照先の手順6のcmx.lbキーの変更に関する記述は該当しません。

スケールアウト

複製したディスクイメージを使用して，スケールアウトをします。スケールアウトでは，次の内容を実施します。

ディスクイメージのリストア
作成したディスクイメージを，複製先アプリケーションサーバにリストアします。リストアの手順については，「7.7.2(3)　JP1/SC/DPMを使用したディスクイメージのリストア」を参照してください。

スケールアウト用ホスト定義ファイルの作成
スケールアウト用ホスト定義ファイルに複製先アプリケーションサーバを定義します。スケールアウト用ホスト定義ファイルの作成については，(1)を参照してください。

システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）
2.で作成したスケールアウト用ホスト定義ファイルを基に，Management Serverが保持するシステムの情報モデルを変更します。情報モデルの変更方法については，(2)を参照してください。

なお，システムの構成を変更するとシステムが動作するために必要なリソースも変更する必要があります。システムが動作するために必要なリソースの見積もりについては，「9.1　使用リソースの見積もり」を参照してください。

注意

アプリケーションサーバ（運用管理ドメイン）ごと複製するため，複製先アプリケーションサーバのサービスユニット，ホストの名称は，複製元と同じになります。

注意

JP1/AJS2 - SOを使用してシステムのスケールアウトを自動化する場合

JP1/SC/DPMを使用したシステムのスケールアウトを，JP1/AJS2 - SOを使用して自動化する場合，ディスク複製インストール（リストア）が完了してから運用管理エージェントを自動起動するように設定する必要があります。設定方法については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。また，JP1/AJS2 - SOとの連携については，「15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用」を参照してください。

＜この節の構成＞

(1)　スケールアウト用ホスト定義ファイルの作成

(2)　システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

(1)　スケールアウト用ホスト定義ファイルの作成

スケールアウト用ホスト定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

スケールアウト用ホスト定義ファイルを作成します。
スケールアウト用ホスト定義ファイル（cmxscaleouthostdef.xmlファイル）は，次の場所に提供されています。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥

Linuxの場合
/opt/Cosminexus/manager/config/templates/

このファイルをコピーし，名称を変更して，任意の場所に格納します。なお，ここではファイル名を「MyWebSystemHostScaleout.xml」に変更しています。

コピーしたスケールアウト用ホスト定義ファイルを編集します。
MyWebSystemHostScaleout.xmlファイルを編集します。ここでは，複製先アプリケーションサーバのシステムの内容と，ホストの定義をします。
設定後のMyWebSystemHostScaleout.xmlファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.5">
 <!-- 複製先のWebシステムの定義 -->
 <web-system>
   <name>MyWebSystem1</name>
 </web-system>
 <!-- 複製先のホストの定義 -->
 <host>
   <host-name>192.168.1.13</host-name>
   <agent-host>192.168.100.13</agent-host>
 </host>
</host-scaleout>

注　太字の部分が編集部分です。

(2)　システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

作成したスケールアウト用ホスト定義ファイルの内容を，複製先アプリケーションサーバのManagement Serverの，システムの情報モデルに反映します。また，変更したシステムの情報モデルを実システムに適用して，複製先アプリケーションサーバのホスト情報を変更します。

システムの情報モデルを変更します。
cmx_scaleout_hostコマンドに，(1)で作成したスケールアウト用ホスト定義ファイルを指定して，複製先アプリケーションサーバのManagement Serverの，システムの情報モデルを変更します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_scaleout_host -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>¥MyWebSystemHostScaleout.xml

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_scaleout_host -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -f <任意のディレクトリ>/MyWebSystemHostScaleout.xml

変更したシステムの情報モデルを実システムに展開します。
cmx_build_systemコマンドを使用して，1.で変更したシステムの情報モデルを実システムに適用します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_build_system -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_build_system -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem1

複製先アプリケーションサーバのサービスユニットを一括起動します。
cmx_start_targetコマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」を一括起動します。このとき，コマンドの-modeオプションに「ALL」を指定して，稼働状態で起動します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_start_target -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

Linuxの場合

# /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.13 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem1 -unit unit1

複製先アプリケーションサーバのリソースアダプタを開始します（必要に応じて）。
リソースアダプタが自動で開始しない場合は，最初に，リソースアダプタを開始します。JP1/SC/DPMを使用してディスクイメージを作成するときに，複製元アプリケーションサーバでリソースアダプタを一括停止しなかった場合，この操作は必要ありません。
ここでは次の内容を実施しています。

サーバ管理コマンドを使用して，複製先アプリケーションサーバのサービスユニット「unit1」のリソースアダプタを開始します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar BatchServer -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

Linuxの場合

# /opt/Cosminexus/CC/admin/bin/cjstartrar BatchServer -nameserver corbaname::192.168.1.13:900 -resname DB_Connector_for_HiRDB_Type4

11.6　構築済みのシステムの移行

Smart Composer機能を使用すると，構築済みのシステムの設定内容をほかの環境に移行できます。

●構築済みのシステムの移行

システムの移行手順は，J2EEアプリケーションを実行するシステムと同じです。手順の詳細については，「7.8.1　構築済みのシステムの移行手順」を参照してください。

●構築済みのシステムの移行時に出力する簡易構築定義ファイルの内容

cmx_export_modelコマンドを使用して構築済みのシステムの設定内容を出力した場合の出力内容について説明します。

XMLスキーマのバージョン

XMLスキーマのバージョンは，最新のバージョンで出力されます。旧バージョンの簡易構築定義ファイルを使用して構築したシステムに対して設定内容を出力した場合，最新のXMLスキーマのバージョンに従って，タグ名称が最新の名称に変換されます。

物理ティアの構成

「8.3　バッチアプリケーションを実行するシステムの構成パターン」にある構成は，その構成に従った物理ティアの構成で出力されます。「8.3　バッチアプリケーションを実行するシステムの構成パターン」にない構成は，free-tier構成で出力されます。

論理サーバのコンフィグレーションに設定しているパラメタ

出力規則

非推奨のパラメタは，推奨のパラメタに変換されます。

値を指定しているパラメタは出力されます。値を省略しているパラメタは出力されません。

簡易構築定義ファイルでパラメタにデフォルト値を設定している場合，または運用管理ポータルでキーにデフォルト値を設定している場合，そのパラメタは出力されます。

出力順序

論理サーバの種類ごとに，パラメタの種類によって出力順序があります。また，同じパラメタの種類の中でのパラメタの出力順序は，パラメタ名称の昇順です。パラメタの出力順序を，次の表に示します。

表11-1　パラメタの出力順序

パラメタを設定するサーバ | 出力順序 | パラメタの種類
バッチサーバ | 1 | 各論理サーバ共通で指定できるパラメタ
2 | バッチサーバ用オプション定義のパラメタ
3 | バッチサーバ用ユーザプロパティのパラメタ
そのほかの論理サーバ | 1 | 各論理サーバ共通で指定できるパラメタ
2 | 該当する論理サーバのパラメタ

設定先

構築済みのシステムの論理サーバによってパラメタの設定先が異なります。パラメタの設定先を，次の表に示します。なお，free-tier構成では，ティアの定義にパラメタを設定できないため，サービスユニットの定義にすべてのパラメタが設定されます。

表11-2　パラメタの設定先

同じ種類の論理サーバの数 | パラメタに指定している値 | パラメタの設定先
1 | － | ティアの定義
2～n | すべての論理サーバで同じ | ティアの定義
論理サーバごとに異なる | ユニットの定義

（凡例）　－：なし

システムの中に同じ種類の論理サーバが一つしかない場合，すべてのパラメタがティアの定義に設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに同じ値をそれぞれ指定していると，パラメタの値は，ティアの定義にそれぞれ設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに異なる値をそれぞれ指定していると，パラメタはユニットの定義にそれぞれ設定されます。

●構築済みのシステムを移行するときの注意事項

構築済みのシステムを移行するときの注意は，J2EEアプリケーションを実行するシステムと同じです。詳細については，「7.8.3　構築済みのシステムを移行するときの注意事項」を参照してください。

11.7　トラブルへの対処

Smart Composer機能で構築したシステムで想定されるトラブルには，Cosminexusで想定されるトラブルと同じように，次に示す種別があります。

エラーメッセージ出力
エラーメッセージが出力されます。

システムダウン
Cosminexusのサーバプロセスが異常終了します。

ハングアップ（無応答）
アプリケーション呼び出しの応答が返らなくなります。

スローダウン
アプリケーション呼び出しの応答は返りますが，応答時間が長くなります。

これらのトラブル種別ごとに，トラブルシューティングに必要な資料が取得できます。資料の取得方法と対処方法については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

11.8　システムの削除

不要になったシステムは削除できます。ここでは，不要になったシステムの削除の流れを説明します。なお，システムを削除する際には，実行中のバッチアプリケーションがないことを確認してから実施してください。

リソースアダプタを停止します。
リソースアダプタは，サーバ管理コマンドやServer Plug-inを使用して停止します。

cmx_stop_targetコマンドを使用してシステムを停止します。
削除対象となるシステムを停止します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem

cmx_delete_systemコマンドを使用してManagement Server上からWebシステムを削除します。
Management Serverで管理されているWebシステムの情報モデルを削除します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_delete_system -m 192.168.100.11 -u cosmi_admin -p cosmi_admin_passwd -s MyWebSystem

cjsetupコマンドに-dオプションを指定して，バッチサーバをアンセットアップします。
cmx_delete_systemコマンドでは，サーバの環境はアンセットアップされません。cjsetupコマンドを使用して，ホスト上のバッチサーバの環境をアンセットアップします。cjsetupコマンドには，バッチサーバの論理サーバ名を指定します。
論理サーバ名はcmx_list_modelコマンドを使用して確認できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。
ただし，システム構築時に，バッチサーバの実サーバ名を指定している場合は，cjsetupコマンドには実サーバ名を指定してください。実サーバ名の指定は，簡易構築定義ファイルの物理ティアのrealservernameパラメタに指定します。
アンセットアップ時に指定するサーバ名の詳細は，「12.3　コマンドの詳細」の「cmx_delete_system」を参照してください。
次の実行例は，実サーバ名を指定していないバッチサーバをアンセットアップする場合の例です。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d BatchServer

UNIXの場合

# /opt/Cosminexus/CC/server/bin/cjsetup -d BatchServer

12.　コマンド

この章では，Smart Composer機能で使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

12.1　コマンドの概要

12.2　コマンドの一覧

12.3　コマンドの詳細

12.1　コマンドの概要

Smart Composer機能で使用するコマンドの入力形式，文法などの記述形式について説明します。

＜この節の構成＞

12.1.1　コマンドの入力形式

12.1.2　コマンドの文法の記述形式

12.1.3　コマンドの使用について

12.1.4　バッチアプリケーションを実行するシステムの場合

12.1.1　コマンドの入力形式

コマンドの入力形式を次に示します。

コマンド名称 [オプション…]

各項目について説明します。なお，コマンドプロンプトを「$」，コマンド名称を「cmd」と表記します。

＜この項の構成＞

(1)　コマンド名称

(2)　引数

(1)　コマンド名称

実行するコマンドのファイル名を指定します。

空白を含むパスを指定してコマンドを実行する場合，パス全体を""で囲む必要があります。

Windowsの場合

誤った指定例：$ C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin¥cmd

正しい指定例：$ "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin¥cmd"

UNIXの場合

誤った指定例：$ /opt/program path/bin/command

正しい指定例：$ "/opt/program path/bin/command"

(2)　引数

引数には，オプションも含まれます。オプションの入力形式および指定規則を次に示します。

(a)　オプションの入力形式

オプションは，「-」（ハイフン）で始まる文字列です。オプションに対するオプション引数を空白，またはタブで区切り入力します。指定するオプションによっては，オプション引数は不要です。

（入力例）

cmx_start_target -m localhost -verbose -s web01

(b)　オプションの指定規則

オプションフラグは，一つの「-」（ハイフン）にまとめて指定できません。
誤った指定例：$ cmd -abc
正しい指定例：$ cmd -a -b -c

オプション引数を必要とするオプションフラグのオプション引数は，省略できません。

オプションフラグとオプション引数の間には，スペースまたはタブが必要です。
誤った指定例：$ cmd -afile
正しい指定例：$ cmd -a file

同じオプションフラグは，複数指定できません。
誤った指定例：$ cmd -a 1 -a 2

オプション引数に空白を含む場合，オプション引数全体を""で囲む必要があります。
誤った指定例：$ cmd -a file 1
正しい指定例：$ cmd -a "file 1"

12.1.2　コマンドの文法の記述形式

「12.3　コマンドの詳細」の説明では，コマンドの文法について次の形式で説明します。

形式

コマンドの入力形式を示します。

機能

コマンドの機能について説明します。

引数

コマンドの引数およびオプションについて説明します。

出力形式

コマンドの出力形式を示します。

入力例・出力例

コマンドの入力例および出力例を示します。

戻り値

コマンドの戻り値について説明します。

注意事項

コマンドを実行する上での注意事項について説明します。

参考

すべてのコマンドで上記の項目をすべて説明しているわけではありません。また，上記以外に，各コマンドの固有情報を記載している場合があります。

12.1.3　コマンドの使用について

ここでは，コマンドを使用するときの注意点について説明します。

＜この項の構成＞

(1)　コマンドを同時に複数実行した場合の動作

(2)　注意事項

(1)　コマンドを同時に複数実行した場合の動作

Smart Composer機能のコマンドを同時に複数実行した場合，コマンドによっては，あとから実行したコマンドが排他制御されるものと，排他制御されないものがあります。

Smart Composer機能のコマンドについて，排他制御の対象となるかどうかを次の表に示します。

表12-1　排他制御の対象/対象外のコマンド

コマンドの種類 | コマンド名 | 排他制御の対象
Webシステム全体に対するコマンド | cmx_add_serverref | ○
cmx_build_model | ○
cmx_change_model | ○
cmx_delete_serverref | ○
cmx_register_application | ○
cmx_register_resource | ○
cmx_scaleout_host | ○
cmx_unregister_application | ○
cmx_unregister_resource | ○
Webシステムに対するコマンド | cmx_admin_passwd | ×
cmx_build_system | ○
cmx_define_application | ○
cmx_define_resource | ○
cmx_delete_system | ○
cmx_deploy_application | ○
cmx_deploy_resource | ○
cmx_export_model | ×
cmx_list_model | ×
cmx_list_status | ×
cmx_resume_lb | ○
cmx_start_application | ○
cmx_start_resource | ○
cmx_start_target | ○
cmx_stop_application | ○
cmx_stop_resource | ○
cmx_stop_target | ○
cmx_test_lb | ○
cmx_trans_param | ×
cmx_undefine_application | ○
cmx_undefine_resource | ○
cmx_undeploy_application | ○
cmx_undeploy_resource | ○

（凡例）

○：排他制御の対象です。これらのコマンドは，「12.3　コマンドの詳細」の共通引数にある，-wait/-nowaitオプションが指定できるコマンドです。

×：排他制御の対象外です。実行中のコマンドがある場合でも実行できます。

排他制御の対象となるコマンドでは，コマンドの共通引数の-wait/-nowaitオプションの指定によって，複数のコマンドを同時に実行したときの動作が変わります。また，コマンドの種類や，どのWebシステムを対象としてコマンドを実行するかの組み合わせで，排他制御される場合とされない場合があります。

次の表に，複数のコマンドを同時に実行したときの排他制御のルールを示します。なお，表中の「Webシステム全体に対するコマンド」および「Webシステムに対するコマンド」に分類されるコマンドの種類については，表12-1を参照してください。

表12-2　排他制御のルール

あとから実行するコマンド | 実行中のコマンド
コマンドの種類 | 対象となるシステム | 共通引数の指定 | コマンドの種類
Webシステム全体に対するコマンド | Webシステムに対するコマンド
Webシステム全体に対するコマンド | － | -wait | △ | △
-nowait | × | ×
Webシステムに対するコマンド | 同じWebシステム | -wait | △ | △
-nowait | × | ×
異なるWebシステム | -wait | △ | ○
-nowait | × | ○

（凡例）

×：あとから実行するコマンドは排他エラーが返ります。

△：あとから実行するコマンドは実行中のコマンドが終了するまで待ちます。

○：あとから実行するコマンドを実行します。

－：該当しません。

(2)　注意事項

Smart Composer機能のコマンドを使用して，Management Server上に定義したホストや論理サーバ，およびManagement Server上に登録したアプリケーションやリソースアダプタは，運用管理ポータルを使用して削除しないでください。

Smart Composer機能のコマンドを使用して起動した論理サーバ，およびサーバ管理コマンドを使用して開始したアプリケーションやリソースアダプタは，運用管理ポータルやmngsvrutilコマンドを使用して停止しないでください。

サーバ管理コマンドやSmart Composer機能のコマンドを使用してデプロイしたアプリケーションやリソースアダプタは，運用管理ポータルやサーバ管理コマンドを使用してアンデプロイしないでください。

次のコマンドを使用する場合は，物理ティアのJ2EEサーバのコンフィグレーション設定で，J2EEサーバの運用監視を有効（ejbserver.instrumentation.enabledパラメタにtrueを設定）にしてください。

cmx_start_application

cmx_stop_application

cmx_start_resource

cmx_stop_resource

なお，物理ティアの設定は，簡易構築定義ファイルで実施します。簡易構築定義ファイルについては，「13.7　簡易構築定義ファイル」を参照してください。

12.1.4　バッチアプリケーションを実行するシステムの場合

この章では，J2EEアプリケーションを実行するシステムを前提にして説明しています。

バッチアプリケーションを実行するシステムの場合は，次の点に留意してください。

バッチアプリケーションを実行するシステムでは，サービスユニットとしてj2ee-tierだけを使用します。それ以外のティアの説明は，バッチアプリケーションを実行するシステムでは該当しません。

Smart Composer機能のコマンドでは，バッチサーバをJ2EEサーバとして扱います。このため，この章の説明中の「J2EEサーバ」は，「バッチサーバ」に読み替えてください。

また，バッチアプリケーションを実行するシステムの場合，使用できるコマンドが一部異なります。バッチアプリケーションを実行するシステムで使用できるコマンドの種類については，「12.2(2)　バッチアプリケーションを実行するシステムで使用できるコマンドの一覧」を参照してください。

12.2　コマンドの一覧

Smart Composer機能で使用するコマンドの一覧を示します。

＜この節の構成＞

(1)　J2EEアプリケーションを実行するシステムで使用できるコマンドの一覧

(2)　バッチアプリケーションを実行するシステムで使用できるコマンドの一覧

(1)　J2EEアプリケーションを実行するシステムで使用できるコマンドの一覧

J2EEアプリケーションを実行するシステムで使用できるコマンドの一覧を次の表に示します。

表12-3　Smart Composer機能で使用するコマンドの一覧（J2EEアプリケーションを実行するシステムの場合）

分類 | コマンド名称 | 概要
環境設定 | cmx_admin_passwd | Management Serverの管理ユーザアカウントを設定します。または，設定済みの管理ユーザアカウントを変更，解除します。
Webシステムの構築 | cmx_build_model※1 | Management Server上にWebシステムの情報モデルを生成します。
cmx_build_system | Management Server上のWebシステムの情報モデルからWebシステムを構築します。
cmx_change_model | Management Server上のWebシステムの情報モデルを変更します。
cmx_delete_system | 構築したWebシステムやWebシステム中のサービスユニットを削除します。
cmx_resume_lb | 負荷分散機の休止状態を解除して，設定処理を再開します。
cmx_scaleout_host | Management Server上の，ホスト単位管理モデルのWebシステムの情報モデルを変更します。
cmx_test_lb | 負荷分散機との接続に問題がないか接続テストします。
cmx_trans_param | 抽象パラメタを実パラメタに展開します。
サービスユニットの操作 | cmx_add_serverref※2 | 論理ユーザサーバをサービスユニットに追加します。
cmx_delete_serverref※3 | 論理ユーザサーバをサービスユニットから削除します。
cmx_list_status | サービスユニットの稼働状況のステータスや運用環境の構築状況を表示します。
cmx_start_target | 単一のサービスユニット，またはWebシステム中の全サービスユニットを開始します。
cmx_stop_target | 単一のサービスユニット，またはWebシステム中の全サービスユニットを停止します。
リソースアダプタの操作※4 | cmx_define_resource | Management Serverに登録したリソースアダプタまたはJavaBeansリソースをWebシステムに関連づけます。
cmx_deploy_resource | Webシステムに関連づけたリソースアダプタまたはJavaBeansリソースをデプロイします。
cmx_register_resource | リソースアダプタまたはJavaBeansリソースをManagement Serverに登録します。
cmx_start_resource | デプロイ済みのリソースアダプタまたはJavaBeansリソースを開始します。
cmx_stop_resource | 開始済みのリソースアダプタまたはJavaBeansリソースを停止します。
cmx_undefine_resource | リソースアダプタまたはJavaBeansリソースとWebシステムの関連づけを解除します。
cmx_undeploy_resource | デプロイ済みのリソースアダプタまたはJavaBeansリソースをアンデプロイします。
cmx_unregister_resource | リソースアダプタまたはJavaBeansリソースをManagement Serverから削除します。
アプリケーションの操作※4 | cmx_define_application | Management Serverに登録したJ2EEアプリケーションをWebシステムに関連づけます。
cmx_deploy_application | Webシステムに関連づけたJ2EEアプリケーションをデプロイします。
cmx_register_application | J2EEアプリケーションをManagement Serverに登録します。
cmx_start_application | デプロイ済みのJ2EEアプリケーションを開始します。
cmx_stop_application | 開始済みのJ2EEアプリケーションを停止します。
cmx_undefine_application | J2EEアプリケーションとWebシステムの関連づけを解除します。
cmx_undeploy_application | デプロイ済みのJ2EEアプリケーションをアンデプロイします。
cmx_unregister_application | J2EEアプリケーションをManagement Serverから削除します。
構成情報の参照 | cmx_list_model | Management Server上に構築したWebシステムの情報モデルの内容をCSV形式で取得します。
構築済みのシステムの設定内容の出力 | cmx_export_model | 構築済みのシステムの設定内容を，簡易構築定義ファイルの形式で出力します。

注※1

Smart Composer機能で使用するコマンドの実行状況は，Cosminexusのログ（コマンド保守ログ）として出力されます。Cosminexusのログ（コマンド保守ログ）については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

注※2

旧バージョンとの互換用のコマンドです。論理サーバ参照定義ファイルを使用する場合だけに使用します。07-50以降は，論理ユーザサーバは，簡易構築定義ファイルで設定することをお勧めします。

注※3

旧バージョンとの互換用のコマンドです。論理ユーザサーバだけを削除したい場合に使用します。07-50以降は，cmx_delete_systemコマンドで削除することをお勧めします。

注※4

リソースアダプタおよびアプリケーションの操作に関するコマンドは，統合ネーミングスケジューラサーバ用のWebシステムでは使用できません。統合ネーミングスケジューラサーバ用のWebシステムでこれらのコマンドを実行した場合は，エラーになります。

(2)　バッチアプリケーションを実行するシステムで使用できるコマンドの一覧

バッチアプリケーションを実行するシステムで使用できるコマンドの一覧を次の表に示します。

表12-4　Smart Composer機能で使用するコマンドの一覧（バッチアプリケーションを実行するシステムの場合）

分類 | コマンド名称 | 概要
環境設定 | cmx_admin_passwd | Management Serverの管理ユーザアカウントを設定します。または，設定済みの管理ユーザアカウントを変更，解除します。
Webシステムの構築 | cmx_build_model※ | Management Server上にWebシステムの情報モデルを生成します。
cmx_build_system | Management Server上のWebシステムの情報モデルからWebシステムを構築します。
cmx_change_model | Management Server上のWebシステムの情報モデルを変更します。
cmx_delete_system | 構築したWebシステムやWebシステム中のサービスユニットを削除します。
cmx_scaleout_host | Management Server上の，ホスト単位管理モデルのWebシステムの情報モデルを変更します。
サービスユニットの操作 | cmx_list_status | サービスユニットの稼働状況のステータスや運用環境の構築状況を表示します。
cmx_start_target | 単一のサービスユニット，またはWebシステム中の全サービスユニットを開始します。
cmx_stop_target | 単一のサービスユニット，またはWebシステム中の全サービスユニットを停止します。
リソースアダプタの操作 | cmx_define_resource | Management Serverに登録したリソースアダプタをWebシステムに関連づけます。
cmx_deploy_resource | Webシステムに関連づけたリソースアダプタをデプロイします。
cmx_register_resource | リソースアダプタをManagement Serverに登録します。
cmx_start_resource | デプロイ済みのリソースアダプタを開始します。
cmx_stop_resource | 開始済みのリソースアダプタを停止します。
cmx_undefine_resource | リソースアダプタとWebシステムの関連づけを解除します。
cmx_undeploy_resource | デプロイ済みのリソースアダプタをアンデプロイします。
cmx_unregister_resource | リソースアダプタをManagement Serverから削除します。
構成情報の参照 | cmx_list_model | Management Server上に構築したWebシステムの情報モデルの内容をCSV形式で取得します。
構築済みのシステムの設定内容の出力 | cmx_export_model | 構築済みのシステムの設定内容を，簡易構築定義ファイルの形式で出力します。

注※

Smart Composer機能で使用するコマンドの実行状況は，Cosminexusのログ（コマンド保守ログ）として出力されます。Cosminexusのログ（コマンド保守ログ）については，マニュアル「Cosminexus　システム運用ガイド」のトラブルシューティングに関する説明を参照してください。

12.3　コマンドの詳細

Smart Composer機能で使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

Smart Composer機能で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥

UNIXの場合
/opt/Cosminexus/manager/bin/

共通引数

各コマンドには，次の引数を共通引数として指定します。共通引数は，.cmxrc（クライアント設定プロパティファイル）またはcmxclient.properties（クライアント共通設定ファイル）で，指定を省略したときのデフォルト値を設定できます。.cmxrcファイルについては「13.4　.cmxrc（クライアント設定プロパティファイル）」，cmxclient.propertiesファイルについては「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

形式

コマンド名称 [-m <ホスト名>[:<ポート番号>]]
            [-u 管理ユーザID] [-p 管理ユーザパスワード]
            [-wait | -nowait] [-verbose | -noverbose]

説明

-m <ホスト名>[:<ポート番号>]

Management Serverのホスト名とポート番号を指定します。

<ホスト名>
ドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で指定します。なお，xxxには0～255の整数を指定します。

<ポート番号>
Management Serverの設定に従います。デフォルト値は28080です。

-u <管理ユーザID>

「6.6.2(1)　Management Serverのセットアップ」で設定した，Management Serverの管理ユーザIDを指定します。

-p <管理ユーザパスワード>

「6.6.2(1)　Management Serverのセットアップ」で設定した，Management Serverの管理ユーザパスワードを指定します。

-wait | -nowait

コマンド実行時に，すでに実行しているコマンドとの排他が必要な場合，処理できるようになるまで待つか（-wait），待たずにエラーリターンするか（-nowait）のどちらかを指定します。詳細は，「12.1.3(1)　コマンドを同時に複数実行した場合の動作」を参照してください。

-verbose | -noverbose

コマンドの実行結果の詳細を出力するか（-verbose），出力しないか（-noverbose）のどらかを指定します。

共通引数は，コマンドによって指定が有効になる場合と，無効になる場合があります。コマンドに無効な引数を指定した場合，その引数は無視されます。共通引数の指定について，コマンドごとに次の表に示します。

表12-5　共通引数の指定の可否

コマンド名称
共通引数

-m
-u
-p
-wait
-nowait
-verbose
-noverbose

cmx_add_serverref
○
○
○
○
○

cmx_admin_passwd
○
○
○
×
×

cmx_build_model
○
○
○
○
×

cmx_build_system
○
○
○
○
○

cmx_change_model
○
○
○
○
×

cmx_define_application
○
○
○
○
○

cmx_define_resource
○
○
○
○
○

cmx_delete_serverref
○
○
○
○
○

cmx_delete_system
○
○
○
○
○

cmx_deploy_application
○
○
○
○
○

cmx_deploy_resource
○
○
○
○
○

cmx_export_model
○
○
○
×
×

cmx_list_model
○
○
○
×
×

cmx_list_status
○
○
○
×
×

cmx_register_application
○
○
○
○
○

cmx_register_resource
○
○
○
○
○

cmx_resume_lb
○
○
○
○
○

cmx_scaleout_host
○
○
○
○
○

cmx_start_application
○
○
○
○
○

cmx_start_resource
○
○
○
○
○

cmx_start_target
○
○
○
○
○

cmx_stop_application
○
○
○
○
○

cmx_stop_resource
○
○
○
○
○

cmx_stop_target
○
○
○
○
○

cmx_test_lb
○
○
○
○
○

cmx_trans_param
×
×
×
×
×

cmx_undefine_application
○
○
○
○
○

cmx_undefine_resource
○
○
○
○
○

cmx_undeploy_application
○
○
○
○
○

cmx_undeploy_resource
○
○
○
○
○

cmx_unregister_application
○
○
○
○
○

cmx_unregister_resource
○
○
○
○
○

（凡例）

○：有効です。

×：無効です。指定した場合，無視されます。

終了コード

Smart Composer機能で使用するコマンドは，次の範囲で戻り値を返します。

表12-6　Smart Composer機能で使用するコマンドの戻り値

戻り値 | 意味
0 | コマンドの処理が正常終了しました。
1～63 | コマンドの処理で軽微な障害が発生しました。
64～127 | コマンドの処理が異常終了しました。

＜この節の構成＞

cmx_add_serverref

cmx_admin_passwd

cmx_build_model

cmx_build_system

cmx_change_model

cmx_define_application

cmx_define_resource

cmx_delete_serverref

cmx_delete_system

cmx_deploy_application

cmx_deploy_resource

cmx_export_model

cmx_list_model

cmx_list_status

cmx_register_application

cmx_register_resource

cmx_resume_lb

cmx_scaleout_host

cmx_start_application

cmx_start_resource

cmx_start_target

cmx_stop_application

cmx_stop_resource

cmx_stop_target

cmx_test_lb

cmx_trans_param

cmx_undefine_application

cmx_undefine_resource

cmx_undeploy_application

cmx_undeploy_resource

cmx_unregister_application

cmx_unregister_resource

cmx_add_serverref

形式

cmx_add_serverref [共通引数] -f <論理サーバ参照定義ファイル>

機能

cmx_add_serverrefコマンドを使用すると，論理サーバ参照定義ファイルの内容に従って，Webシステム中のサービスユニットにユーザ定義の論理サーバ（論理ユーザサーバ）を追加します。

論理サーバ参照定義ファイルで複数の論理ユーザサーバが指定されている場合は，定義順にサービスユニットへ追加します。追加した論理ユーザサーバに対するエラーチェックは，処理開始時に実行されます。

引数

-f <論理サーバ参照定義ファイル>

論理サーバ参照定義ファイルのパスを指定します。

入力例

cmx_add_serverref -f UserServerRef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定した論理ユーザサーバが，同じサービスユニット，またはほかのサービスユニットに追加済みの場合はエラーになります。

論理ユーザサーバの追加先に指定したWebシステム，およびサービスユニットが存在しない場合はエラーになります。

このコマンドは，旧バージョンとの互換用のコマンドです。論理サーバ参照定義ファイルを使用して，構築済みのシステムに論理ユーザサーバを追加する場合だけに使用します。07-50以降は，簡易構築定義ファイルで論理ユーザサーバを設定することをお勧めします。

cmx_admin_passwd

形式

cmx_admin_passwd [共通引数] [-np <新管理ユーザパスワード>] [-nu <新管理ユーザID>]

機能

Management Serverへログインするための管理ユーザアカウントを設定します。新管理ユーザアカウントを指定している場合は，設定済みの管理ユーザアカウントを新管理ユーザアカウントに変更します。また，-npオプションに空文字（" "）を指定している場合は，設定済みの管理ユーザパスワードを解除します。

引数

-np <新管理ユーザパスワード>

新しいManagement Serverの管理ユーザパスワードを指定します。

-nu <新管理ユーザID>

新しいManagement Serverの管理ユーザIDを指定します。

入力例

新規に管理ユーザアカウントを設定する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809

設定済みの管理ユーザアカウントを変更する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809 -np passwd123 -nu admin02

管理ユーザパスワードを解除する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809 -np " "

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

管理ユーザパスワードが設定されていない状態で，-npオプションを指定したコマンドを入力すると，共通引数の-pオプションの指定は無視されて，新管理ユーザパスワードが設定されます。また，管理ユーザIDが設定されていない状態で，-nuオプションを指定したコマンドを入力すると，共通引数の-uオプションの指定は無視されて，新管理ユーザIDが設定されます。

cmx_build_model

形式

cmx_build_model [共通引数] -f <簡易構築定義ファイル>

機能

cmx_build_modelコマンドを使用すると，簡易構築定義ファイルの内容に従って，Management Serverにホストおよび論理サーバを定義し，Webシステムの情報モデルを構築します。

cmx_build_modelコマンドでManagement Server上に論理サーバ名が定義される場合のルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

引数

-f <簡易構築定義ファイル>

簡易構築定義ファイルのパスを指定します。

入力例

cmx_build_model -f MyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

構築済みのWebシステムを処理対象に指定した場合はエラーになります。

07-50以降は，cmx_build_systemコマンドを使用して，Webシステムの情報モデルの生成から，Webシステムの構築まで一括で実行することをお勧めします。

cmx_build_system

形式

Webシステムの構築

簡易構築定義ファイルからWebシステムを構築する場合
cmx_build_system [共通引数] -f <簡易構築定義ファイル>

登録済みの情報モデルを基にWebシステムを構築する場合
cmx_build_system [共通引数] [-s <Webシステム名>]

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合
cmx_build_system [共通引数] -ns

構築済みのシステムのパラメタ変更

構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合
cmx_build_system [共通引数] -f <簡易構築定義ファイル> -change

機能

Webシステムを構築します。また，構築済みのシステムのパラメタを変更します。

Webシステムの構築
登録済みのWebシステムの情報モデルに従って，Webシステムを構築します。または，簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを生成し，その情報モデルに従ってWebシステムを構築します。
cmx_build_systemコマンドは，各ホストのWebサーバとJ2EEサーバのセットアップ，および各論理サーバの環境を設定します。また，必要に応じて負荷分散機に仮想サーバや実サーバを作成します。
登録済みの情報モデルを基にWebシステムを構築する場合，簡易構築定義ファイルからWebシステムを構築する場合，またはWebシステムに関連づいていない論理サーバを含むシステムを構築する場合で，構築のしかたが異なります。

簡易構築定義ファイルからWebシステムを構築する場合
指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを構築します。さらに，その情報モデルに従って，Webシステムを構築します。あらかじめcmx_build_modelでモデルを登録しないで，Webシステムの構築ができます。

登録済みの情報モデルを基にWebシステムを構築する場合
cmx_build_modelコマンド，またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って，Webシステムを構築します。

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合
cmx_build_modelコマンド，またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って，Webシステムに関連づいていない論理サーバを含むシステムを構築します。

構築済みのシステムのパラメタ変更
-changeオプションを指定することで，構築済みのシステムのパラメタを，-fオプションで指定した簡易構築定義ファイルに定義されたパラメタに変更します。

-changeオプションを指定して構築済みのシステムのパラメタを変更する場合
-fオプションにパラメタ変更済みの簡易構築定義ファイルを指定して，-changeオプションを指定します。-fオプションで指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを，パラメタを変更した状態で再生成します。さらに，その情報モデルを基にして，Webシステムを再構築します。ただし，構成変更はできません。

Webシステムの構築時に，論理サーバ名および実サーバ名を簡易構築定義ファイルで定義していない場合，Management Server上に論理サーバ名，および実サーバ名が定義されます。なお，登録済みの情報モデルに従ってWebシステムを構築する場合，論理サーバ名はcmx_build_modelコマンド実行時に定義されます。Management Server上に論理サーバ名，および実サーバ名が定義されるときのルールを次に示します。

論理サーバ名の定義ルール

論理サーバ名は次の形式で定義されます。

形式

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

<種別>は，論理サーバの種類によって異なります。論理サーバの種類と<種別>との対応を次の表に示します。

表12-7　論理サーバの種類と<種別>との対応

論理サーバの種類 | <種別>
論理Webサーバ | HTTP
論理J2EEサーバ | J2EE
論理パフォーマンストレーサ | PRF
論理SFOサーバ | SFO
論理CTMドメインマネジャ | CTMDM
論理CTM | CTM
論理スマートエージェント | SA
論理ユーザサーバ | USER

<通番>は，基本的に「01」が設定されます。ただし，CTMを使用するシステムのように論理サーバを複数配置する場合は，重複しない番号が割り振られます。

実サーバ名の定義ルール

負荷分散機にLoadflowbalを使用する場合だけ，負荷分散機に作成する実サーバの名称が必要となります。実サーバの名称はSmart Composer機能で自動的に設定されます。負荷分散機に作成する実サーバの名称の定義ルールを次に示します。

形式

cmx_rs_<WebサーバマシンのIPアドレス>

引数

-s <Webシステム名>

Webシステム名を指定します。

登録済みの情報モデルから，指定したWebシステムが構築されます。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-fオプションを指定している場合には指定が無効になります。

-f <簡易構築定義ファイル>

簡易構築定義ファイルのパスを指定します。

簡易構築定義ファイルの内容に従って，Webシステムの情報モデルが生成されます。さらに，その情報モデルを基にしてWebシステムが構築されます。

-change

パラメタを変更する場合に指定します。

-fオプションで指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルが再生成されます。さらに，その情報モデルを基にしてWebシステムが再構築されます。

-ns

登録済みの情報モデルから，Webシステムに関連づいていない論理サーバを含むシステムを構築する場合に指定します。

このオプションを指定する場合，cmx_build_modelコマンドを使用して，情報モデルを登録しておく必要があります。cmx_build_modelコマンドについては，「12.3　コマンドの詳細」の「cmx_build_model」を参照してください。

入力例

簡易構築定義ファイルからWebシステムを構築する場合

cmx_build_system -f MyWebSystemDef.xml

登録済みの情報モデルを基にWebシステムを構築する場合

cmx_build_system -s sample-system

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合

cmx_build_system -ns

構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合

cmx_build_system -f MyWebSystemDef2.xml -change

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-changeオプションを指定する場合，次のことに注意してください。

構築済みのWebシステムに対してパラメタ変更以外の変更をしようとした場合はエラーになります。

-fオプションで指定した簡易構築定義ファイルのスキーマのバージョンが，構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンより古いときは，動作が保証されません。

構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンが2.1以前の場合，-fオプションで指定する簡易構築定義ファイルのホストの定義の<host-ref>タグは次のように指定します。

<host-ref>タグに指定する値

構築済みのシステムの構築時に使用した簡易構築定義ファイルのホストの定義の<operational-ip>タグで指定している値

cmx_change_model

形式

cmx_change_model [共通引数] -f <構成変更定義ファイル>

機能

構成変更定義ファイルの内容に従って，Webシステムの情報モデルを変更（サービスユニット・ホストの追加またはパラメタの一括変更）します。

サービスユニット・ホストの追加
Webシステムの情報モデルに，構成変更定義ファイルで定義したサービスユニットまたはホストを追加します。サービスユニットに指定するホストには，新規のものも，Management Server上のWebシステムの情報モデルにあるものも指定できます。
cmx_change_modelコマンドでは，サービスユニットに対応するホストおよび論理サーバをManagement Serverに定義します。論理サーバ名の設定ルールについては，「12.3　コマンドの詳細」の「cmx_build_system」を参照してください。

パラメタの一括変更
構成変更定義ファイルに指定した論理サーバのコンフィグレーション定義の情報に変更します。

引数

-f <構成変更定義ファイル>

構成変更定義ファイルのパスを指定します。

入力例

cmx_change_model -f MyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-fオプションで指定した構成変更定義ファイルのスキーマのバージョンが，構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンより古いときは，動作が保証されません。

構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンが2.1以前の場合，-fオプションで指定する構成変更定義ファイルのホストの定義の<host-ref>タグは次のように指定します。

<host-ref>タグに指定する値

構築済みのシステムの構築時に使用した簡易構築定義ファイルのホストの定義の<operational-ip>タグで指定している値

cmx_define_application

形式

アーカイブ形式のJ2EEアプリケーションを関連づける場合

cmx_define_application [共通引数] [-s <Webシステム名>] -appname <アプリケーション表示名> -appver <アプリケーションバージョンID>

展開ディレクトリ形式のJ2EEアプリケーションを関連づける場合

cmx_define_application [共通引数] [-s <Webシステム名>] -appname <アプリケーション表示名>

機能

J2EEアプリケーションをWebシステムに関連づけます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

-appver <アプリケーションバージョンID>

J2EEアプリケーションのバージョンIDを指定します。

入力例

cmx_define_application -s sample-system -appname App1 -appver 1.0

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

cmx_define_resource

形式

リソースアダプタを関連づける場合

cmx_define_resource [共通引数] [-s <Webシステム名>] -resname <リソースアダプタ表示名>

JavaBeansリソースを関連づける場合

cmx_define_resource [共通引数] [-s <Webシステム名>] -resname <JavaBeansリソース表示名>

機能

リソースアダプタまたはJavaBeansリソースをWebシステムに関連づけます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_define_resource -s sample-system -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

cmx_delete_serverref

形式

cmx_delete_serverref [共通引数] [-s <Webシステム名>] -unit <サービスユニット名> -name <論理サーバ名>

機能

Webシステム中のサービスユニットから論理ユーザサーバを削除します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-name <論理サーバ名>

論理サーバ名を指定します。

入力例

cmx_delete_serverref -s sample-system -unit Unit01 -name cmx_Web02_Unit01_User_01

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定した論理ユーザサーバが，同じサービスユニット，またはほかのサービスユニットに追加済みの場合はエラーになります。

このコマンドは，旧バージョンとの互換用のコマンドです。論理ユーザサーバだけを削除したい場合に使用します。07-50以降は，cmx_delete_systemコマンドで，論理ユーザサーバもほかの論理サーバと同時に削除することをお勧めします。

cmx_delete_system

形式

Webシステムを削除する場合

cmx_delete_system [共通引数] [-s <Webシステム名>] [-lb {keepvs|deletevs}]

サービスユニットを削除する場合

cmx_delete_system [共通引数] [-s <Webシステム名>] -unit <サービスユニット名>

Webシステムに関連づいていない論理サーバ，およびホストをすべて削除する場合

cmx_delete_system [共通引数] -ns

機能

Webシステム，またはWebシステム中のサービスユニットを削除します。-unitオプションの指定を省略した場合はWebシステムを，-unitオプションを指定した場合はWebシステム中のサービスユニットを削除します。ホスト単位管理モデルで構築したWebシステムの場合に，複数のアプリケーションサーバ（ホスト）で負荷分散機の仮想サーバを共有しているときは，-lbオプションで仮想サーバを削除するかどうかを指定して，Webシステムを削除してください。

また，-nsオプションを指定した場合は，Webシステムに関連づいていない論理サーバ，およびホストをすべて削除します。

なお，このコマンドは，Management Serverに登録したWebシステムの情報モデル，負荷分散機に設定した情報，および削除対象のWebシステムまたはサービスユニットに関連づいている，すべてのホストも削除します。ただし，ほかのWebシステムや削除対象外のサービスユニットから参照しているホスト，およびSmart Composer機能以外で論理サーバを追加したホストは削除しません。運用管理ドメイン内に登録されていて，Webシステムと関連づいていないホストを削除する場合は，一時的なWebシステムやサービスユニットに削除対象とするホストを関連づけて，関連づけたWebシステムまたはサービスユニットごと削除する必要があります。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-lb

負荷分散機の仮想サーバを削除するかどうかを指定します。ホスト単位管理モデルで構築したWebシステムをスケールアウトする場合に指定します。

keepvs
負荷分散機の仮想サーバは削除しません。負荷分散機の設定情報を削除します。複数のホストで負荷分散機の仮想サーバを共有している場合に指定します。

deletevs
負荷分散機の仮想サーバおよび負荷分散機の設定情報を削除します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.lbキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.lbキーを省略している場合に，このオプションを省略したときはdeletevsが仮定されます。.cmxrcファイルの詳細については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を，cmxclient.propertiesファイルの詳細については，「13.5　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

-ns

Webシステムに関連づいていない論理サーバ，およびホストをすべて削除します。

入力例

cmx_delete_system -s sample-system -unit unit1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

このコマンドで，Webシステムやサービスユニットを削除した場合，サービスユニットを構成するホストにWebサーバやJ2EEサーバの環境が残ります。
このホストをSmart Composer機能を使って再利用する場合は，次の方法でサーバの環境をアンセットアップしてください。

Webサーバの環境のアンセットアップ
Hitachi Web Serverのユティリティを使用してアンセットアップします。
ユティリティに指定するWebサーバ名は，「HWS_<Webサーバの論理サーバ名>」の形式で指定します。Webサーバの論理サーバ名はcmx_list_modelコマンドを使用して参照できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。
ただし，物理ティアのrealservernameパラメタでWebサーバの実サーバ名を指定している場合は，ユティリティに指定するサーバ名は，「HWS_<Webサーバの実サーバ>」を指定してください。

J2EEサーバの環境のアンセットアップ
サーバ管理コマンドのcjsetupコマンドを使用してアンセットアップします。
コマンドには，J2EEサーバの論理サーバ名を指定します。J2EEサーバの論理サーバ名はcmx_list_modelコマンドを使用して参照できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。
ただし，物理ティアのrealservernameパラメタでJ2EEサーバの実サーバ名を指定している場合は，コマンドに指定するサーバ名は実サーバ名を指定してください。

それぞれのサーバの環境削除の例を次に示します。

Webサーバの環境削除の例

Windowsの場合

<Cosminexusインストールディレクトリ>¥httpsd¥admin¥bin¥hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01

UNIXの場合

/opt/hitachi/httpsd/admin/bin/hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01

J2EEサーバの環境削除の例

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_sample-system_unit1_J2EE_01

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjsetup -d cmx_sample-system_unit1_J2EE_01

Hitachi Web Serverのユティリティについてはマニュアル「Hitachi Web Server」を，cjsetupコマンドについてはマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

このコマンドを実行すると，論理ユーザサーバも同時に削除されます。論理ユーザサーバだけを削除したい場合は，cmx_delete_serverrefコマンドを使用してください。

cmx_deploy_application

形式

アーカイブ形式のJ2EEアプリケーションを指定する場合

cmx_deploy_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -appname <アプリケーション表示名> -appver <アプリケーションバージョンID>

展開ディレクトリ形式のJ2EEアプリケーションを指定する場合

cmx_deploy_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -appname <アプリケーション表示名>

J2EEアプリケーションを指定しない場合

cmx_deploy_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

J2EEアプリケーションをデプロイします。コマンドにJ2EEアプリケーションを指定している場合と，指定していない場合とでデプロイのしかたが異なります。

アーカイブ形式のJ2EEアプリケーションを指定する場合
Webシステムに含まれるすべてのサービスユニットに，指定されたアーカイブ形式のJ2EEアプリケーションをデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットに，指定されたアーカイブ形式のJ2EEアプリケーションをデプロイします。

展開ディレクトリ形式のJ2EEアプリケーションを指定する場合
Webシステムに含まれるすべてのサービスユニットに，指定された展開ディレクトリ形式のJ2EEアプリケーションをデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットに，指定された展開ディレクトリ形式のJ2EEアプリケーションをデプロイします。

J2EEアプリケーションを指定しない場合
Webシステムに含まれるすべてのサービスユニットに，そのWebシステムに関連づけられているすべてのJ2EEアプリケーション（アーカイブ形式および展開ディレクトリ形式）をデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットに，そのWebシステムに関連づけられているすべてのJ2EEアプリケーションをデプロイします。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

-appver <アプリケーションバージョンID>

J2EEアプリケーションのバージョンIDを指定します。

入力例

cmx_deploy_application -s sample-system -unit unit1 -appname App1 -appver 1.0

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

アーカイブ形式のJ2EEアプリケーションの場合，バージョンIDが異なる，同じ表示名のJ2EEアプリケーションを同時にデプロイできません。

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_deploy_resource

形式

リソースアダプタを指定してデプロイする場合

cmx_deploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <リソースアダプタ表示名>

JavaBeansリソースを指定してデプロイする場合

cmx_deploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <JavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースを指定しないでデプロイする場合

cmx_deploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

リソースアダプタまたはJavaBeansリソースをサービスユニットにデプロイします。コマンドにリソースアダプタまたはJavaBeansリソースを指定している場合と，指定していない場合とでデプロイのしかたが異なります。

リソースアダプタまたはJavaBeansリソースを指定している場合
Webシステムに含まれるすべてのサービスユニットに，指定されたリソースアダプタまたはJavaBeansリソースをデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットに，指定されたリソースアダプタまたはJavaBeansリソースをデプロイします。

リソースアダプタまたはJavaBeansリソースを指定していない場合
Webシステムに含まれるすべてのサービスユニットに，Webシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースをデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットに，Webシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースをデプロイします。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_deploy_resource -s sample-system -unit unit1 -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_export_model

形式

cmx_export_model [共通引数] [-indent <インデントサイズ>] [-myhost <置換するホスト名>] [-encoding <文字エンコーディング名>] -o <出力ファイル>

機能

構築されているWebシステムの内容に従って，簡易構築定義ファイルを出力します。

引数

-indent <インデントサイズ>

簡易構築定義ファイルのタグのインデントサイズを指定します。下位タグの開始位置を上位のタグから半角スペースで何文字分右にずらすかを0～8の範囲で指定します。

「-indent 4」を指定した場合の出力例

<web-system>
△△△△<name>MyWebSystem</name>
△△△△<tier>
△△△△△△△△<tier-type>combined-tier</tier-type>
△△△△</tier>
      ：

（凡例）△：半角スペース1文字分

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.indentキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.indentキーを省略している場合に，このオプションを省略してコマンドを実行したときは，2が設定されます。

-myhost <置換するホスト名>

出力する簡易構築定義ファイルの運用管理サーバマシンのホスト名を指定します。

ホスト単位管理モデルのシステムを，別のホストに移行する場合に指定します。

なお，移行先の環境で，このオプションの指定が有効になるのは次の場合です。

ホストの定義の<host-name>に，移行先の環境の運用管理サーバマシンのIPアドレスと一致するIPアドレス，または移行先の環境の運用管理サーバマシンのIPアドレスと一致するIPアドレスに変換できるホスト名を指定している。

ホストの定義の<host-name>にlocalhostかループバックアドレスを指定している。

これらの条件を満たさないホスト名を指定した場合，指定は無効になります。

指定する値は，移行先の環境の運用管理サーバマシンのホスト名，または@myhostです。移行先の環境の運用管理サーバマシンのホスト名を指定した場合と，@myhostを指定した場合のホスト名の置換について，それぞれ説明します。

移行先の環境の運用管理サーバマシンのホスト名を指定する場合

移行先の環境の運用管理サーバマシンのホスト名を指定すると，出力する簡易構築定義ファイルで，次に示すタグの値が指定したホスト名に置換されます。

ホストの定義の<host-name>タグ

ユニットの定義の<host-ref>タグ

論理サーバのコンフィグレーションに指定されているパラメタのホスト名

@myhostを指定する場合

@myhostを指定すると，出力する簡易構築定義ファイルで，次に示すタグの値が@myhostに置換されます。

ユニットの定義の<host-ref>タグ

論理サーバのコンフィグレーションに指定されているパラメタのホスト名

@myhostを指定した場合，ホストの定義は出力されません。ただし，@myhostを指定した場合に，ホストの定義の<display-name>タグ，<description>タグ，<agent-host>タグ，または<agent-port>タグに値を指定したときは，ホストの定義が出力されます。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.myhostキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.myhostキーを省略している場合に，このオプションを省略してコマンドを実行したときは，出力する簡易構築定義ファイルの運用管理サーバマシンのホスト名が設定されません。

-encoding <文字エンコーディング名>

出力する簡易構築定義ファイルの文字エンコーディングを指定します。指定を省略した場合はUTF-8が設定されます。

設定できる文字エンコーディングは，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.encodingキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.encodingキーを省略している場合に，このオプションを省略してコマンドを実行したときは，UTF-8が設定されます。

-o <出力ファイル>

出力する簡易構築定義ファイルの出力先を指定します。

入力例

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_export_model -o c:¥temp¥MyWebSystemexport.xml

出力形式

XMLファイル形式の簡易構築定義ファイルで出力します。簡易構築定義ファイルの出力例については，「7.8.2(4)　出力例」を参照してください。

注意事項

「4.3　システム構成パターン」にない構成は，free-tier構成で出力されます。出力したシステムに，free-tier構成が含まれていた場合，出力したシステムに対して，Smart Composer機能のコマンドでは，システム構築以外の操作は実行できません。free-tier構成を含むシステムを運用する場合は，運用管理ポータル，またはサーバ管理コマンドを使用してください。

cmx_list_model

形式

Webシステムの情報モデルを取得する場合

cmx_list_model [共通引数] -modeltype {SERVER|APPLICATION|RESOURCE|RESADAPTER|RESJAVABEANS|SERVEREX} [{-s <Webシステム名>|-all|-r}]

Webシステムに関連づいていない論理サーバの一覧を取得する場合

cmx_list_model [共通引数] -ns

機能

Webシステムの情報モデルを取得する場合
登録されているWebシステムの情報モデルを取得し，標準出力に取得結果を出力します。
-sオプション，または.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーでWebシステム名が指定されている場合は，そのWebシステムだけを対象とします。

Webシステムに関連づいていない論理サーバの一覧を取得する場合
Webシステムに関連づいていない論理サーバの一覧を取得し，標準出力に取得結果を出力します。一覧には論理サーバの種別も表示します。

引数

-modeltype

表示する対象を指定します。

SERVER
Webシステムの情報モデル中の論理サーバの一覧を表示します。

APPLICATION
Webシステムの情報モデル中のJ2EEアプリケーションの一覧を表示します。

RESOURCE※
Webシステムの情報モデル中のリソースアダプタの一覧を表示します。

RESADAPTER
Webシステムの情報モデル中のリソースアダプタの一覧を表示します。

RESJAVABEANS
Webシステムの情報モデル中のJavaBeansリソースの一覧を表示します。

SERVEREX
Webシステムの情報モデル中の論理サーバの一覧を表示します。一覧には論理サーバの種別も表示します。

注※　互換用の引数です。RESADAPTERを使用することをお勧めします。

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。

-all

登録されているすべてのWebシステムを表示する対象とします。

-r

cmx_register_applicationコマンドで登録したJ2EEアプリケーションの一覧，またはcmx_register_resourceコマンドで登録したリソースアダプタの一覧を表示する場合に指定します。

-ns

Webシステムに関連づいていない論理サーバの一覧表示する場合に指定します。

出力形式

CSV形式で出力します。

Webシステムの情報モデルを取得する場合

論理サーバ一覧の場合（SERVER指定時）

<論理サーバ名>,<ホスト名>,<ティア種類>※,<サービスユニット名>,<Webシステム名>

注※

論理ユーザサーバの場合，ティア種類には空文字が出力されます。

論理サーバ一覧の場合（SERVEREX指定時）

<論理サーバ名>,<論理サーバ種別>,<ホスト名>,<ティア種類>※,<サービスユニット名>,<Webシステム名>

注※

論理ユーザサーバの場合，ティア種類には空文字が出力されます。

Webシステムに関連づけられたアプリケーション一覧の場合

<アプリケーション表示名>,<アプリケーションバージョン>,<Webシステム名>

登録されているJ2EEアプリケーション一覧の場合

<アプリケーション表示名>,<アプリケーションバージョン>

Webシステムに関連づけられたリソースアダプタ一覧の場合

<リソースアダプタ表示名>,<Webシステム名>

登録されているリソースアダプタ一覧の場合

<リソースアダプタ表示名>

Webシステムに関連づけられたJavaBeansリソース一覧の場合

<JavaBeansリソース表示名>,<Webシステム名>

登録されているJavaBeansリソース一覧の場合

<JavaBeansリソース表示名>

Webシステムに関連づいていない論理サーバの一覧

<論理サーバ名>,<論理サーバ種別>,<ホスト名>

入力例・出力例

論理サーバ一覧（SERVER指定時）

>cmx_list_model -modeltype SERVER
cmx_Web01_Unit01_PRF_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_J2EE_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_HTTP_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit02_PRF_01,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_J2EE_01,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_HTTP_01,Host01,combined-tier,Unit02,Web01
cmx_Web02_Unit01_PRF_01,Host01,combined-tier,Unit01,Web02
cmx_Web02_Unit01_USER_01,Host01,,Unit01,Web02
：

論理サーバ一覧（SERVEREX指定時）

>cmx_list_model -modeltype SERVER
cmx_Web01_Unit01_PRF_01,PRF,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_J2EE_01,J2EEServer,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_HTTP_01,Webserver,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit02_PRF_01,PRF,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_J2EE_01,J2EEServer,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_HTTP_01,Webserver,Host01,combined-tier,Unit02,Web01
cmx_Web02_Unit01_PRF_01,PRF,Host01,combined-tier,Unit01,Web02
cmx_Web02_Unit01_USER_01,UserServer,Host01,,Unit01,Web02
：

Webシステムに関連づけられたアプリケーション一覧

>cmx_list_model -modeltype APPLICATION
App01,Ver01,Web01
App02,Ver02,Web02
App03,Ver01,Web02

登録されているアプリケーション一覧

>cmx_list_model -modeltype APPLICATION -r
App01,Ver01
App02,Ver01
App02,Ver02
App03,Ver01

Webシステムに関連づけられたリソースアダプタ一覧

>cmx_list_model -modeltype RESADAPTER
Rar01,Web01
Rar02,Web02

登録されているリソースアダプタ一覧

>cmx_list_model -modeltype RESADAPTER -r
Rar01
Rar02
Rar03
Rar04

Webシステムに関連づけられたJavaBeansリソース一覧

>cmx_list_model -modeltype RESJAVABEANS
Jar01,Web01
Jar02,Web02

登録されているJavaBeansリソース一覧

>cmx_list_model -modeltype RESJAVABEANS -r
Jar01
Jar02
Jar03
Jar04

Webシステムに関連づいていない論理サーバ一覧

>cmx_list_model -ns
PRF_01,PRF,Host01
J2EE_01,J2EEServer,Host01
HTTP_01,Webserver,Host01
：

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-sオプション，-allオプション，および.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーの指定をすべて省略した場合は，登録されているすべてのWebシステムを表示する対象とします。

.cmxrcファイル，またはcmxclient.propertiesファイルのcmx.websystem.nameキーにWebシステム名を指定している場合に，すべてのWebシステムのモデルを取得するには，-allオプションを指定してください。

modeltype SERVERと-rを同時に指定した場合，エラーになります。

統合ネーミングスケジューラサーバ用のWebシステムの場合，-modeltypeオプションにAPPLICATION，RESOURCE，RESADAPTER，またはRESJAVABEANSを指定すると，何も表示されません。

cmx_list_status

形式

Webシステム中のサービスユニットのステータスを取得する場合

cmx_list_status [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

Webシステムに関連づいていない論理サーバのステータスを取得する場合

cmx_list_status [共通引数] -ns

機能

Webシステム中のサービスユニットのステータスを取得する場合

サービスユニットの稼働状況のステータス，およびサービスユニットに対するcmx_build_systemコマンドの実行状態を取得し，標準出力に取得結果を出力します。

サービスユニットの稼働状況のステータス
サービスユニットの状態を取得し，標準出力に取得結果を出力します。出力されるサービスユニット稼働状況のステータスは次の5種類です。

working
稼働状態を表します。サービスユニット中の全論理サーバが稼働中で，負荷分散機からリクエストが振り分けられる状態です。

ready
準備状態を表します。サービスユニット中の全論理サーバが稼働中で，負荷分散機からのリクエスト振り分けが抑止されている状態です。
通常，アプリケーションのテストなどは，停止状態から準備状態にして，アプリケーションのデプロイや外部との接続をしないで実施します。

hold
閉塞状態を表します。サービスユニット中のWebサーバが計画停止済み（ほかの論理サーバは稼働中）で，負荷分散機からのリクエスト振り分けが抑止されている状態です。通常，J2EEアプリケーションの入れ替えなどは，稼働状態から閉塞状態にして，実施します。
なお，閉塞状態と準備状態との違いは，Webサーバが起動しているかどうかだけです。

stopped
停止状態を表します。サービスユニット中の全論理サーバが停止済みで，負荷分散機からのリクエスト振り分けが抑止されている状態です。

unknown
障害発生や未セットアップのために状態の判別がつかない状態を表します。

cmx_build_systemの実行状態
サービスユニットに対するcmx_build_systemの実行状態を取得し，標準出力にdone（実行済み）とnot done（未実行）で取得結果を出力します。

コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全ユニットが表示の対象となります。

なお，それぞれのJ2EEアプリケーションやそれぞれの論理サーバの稼働状態を知りたい場合は，mngsvrutilコマンドを使用してください。mngsvrutilコマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

Webシステムに関連づいていない論理サーバのステータスを取得する場合

論理サーバの稼働状況のステータス
論理サーバの状態を取得し，標準出力に取得結果を出力します。出力されるサービスユニット稼働状況のステータスについては，マニュアル「Cosminexus　リファレンス　コマンド編」のmngsvrutilコマンドのサブコマンドの詳細に関する説明を参照してください。

論理サーバの設定情報の配布の実行状態
論理サーバに対する設定情報の配布の実行状態を取得し，標準出力にdone（実行済み）とnot done（未実行）で取得結果を出力します。設定情報の配布が実行済みの状態とは，次の2種類の状態を指します。

cmx_build_systemコマンドを引数に-nsを指定して実行し，正常にシステムの構築が完了した状態

運用管理ポータルで正常に論理サーバの配布が完了した状態

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-ns

Webシステムに関連づいていない論理サーバのステータスを取得する場合に指定します。

出力形式

CSV形式で出力されます。

Webシステム中のサービスユニットのステータスを表示する場合

<サービスユニット名>,<Webシステム名>,<cmx_build_system実行状態>,<サービスユニットの稼働状態>

Webシステムに関連づいていない論理サーバのステータスを表示する場合

<論理サーバ名>,<論理サーバの設定情報の配布の実行状態>※,<論理サーバの稼働状態>

注※　論理サーバの種別がJ2EEサーバ，SFOサーバ，Webサーバ以外の場合は論理サーバの設定情報の配布の実行状態は空文字で表示されます。

入力例・出力例

Webシステム中のサービスユニットのステータスを表示する場合

>cmx_list_status -s sample-system
unit01,sample-system,done,working
unit02,sample-system,done,ready
unit03,sample-system,done,hold
unit04,sample-system,done,stopped
unit05,sample-system,done,unknown
unit06,sample-system,not done,unknown

Webシステムに関連づいていない論理サーバのステータスを表示する場合

>cmx_list_status -s sample-system
PRF01,,working
J2EE01,done,working
HTTP01,done,working

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットの場合，サービスユニットの稼働状況のステータスには，「working」，「stopped」および「unknown」の3種類が表示されます。

CTM用のサービスユニットおよび統合ネーミングスケジューラサーバ用のサービスユニットの場合，サービスユニットの稼働状況のステータスには，「working」，「stopped」および「unknown」の3種類が表示されます。

CTM用のサービスユニットに複数のJ2EEサーバを配置している場合に，サービスユニットが正常に起動したあと，一部のJ2EEサーバが異常停止したときは，サービスユニットの稼働状況のステータスには「unknown」が表示されます。

cmx_register_application

形式

アーカイブ形式のJ2EEアプリケーションを登録する場合

cmx_register_application [共通引数] -f <EARファイル> -appver <アプリケーションバージョンID> [-replace]

展開ディレクトリ形式のJ2EEアプリケーションを登録する場合

cmx_register_application [共通引数] -appname <アプリケーション表示名> -d <アプリケーションディレクトリ> [-replace]

機能

Management Serverが管理するドメインにJ2EEアプリケーションを登録します。

登録できるJ2EEアプリケーションの形式には，アーカイブ形式および展開ディレクトリ形式があります。

アーカイブ形式のJ2EEアプリケーションを登録する場合
アーカイブ形式のJ2EEアプリケーションは，アプリケーション表示名とアプリケーションバージョンIDで一意に識別されます。同じアプリケーション表示名，同じアプリケーションバージョンIDのアプリケーションがすでに登録されている場合は，-replaceオプションを指定することによって再登録できます。

展開ディレクトリ形式のJ2EEアプリケーションを登録する場合
展開ディレクトリ形式のJ2EEアプリケーションは，アプリケーション表示名で一意に識別されます。同じアプリケーション表示名のアプリケーションがすでに登録されている場合は，-replaceオプションを指定することによって再登録できます。

引数

-f <EARファイル>

J2EEアプリケーションのEARファイルのパスを指定します。

-appver <アプリケーションバージョンID>

J2EEアプリケーションのバージョンIDを指定します。

-appname <アプリケーション表示名>

アプリケーションディレクトリ下のDD（application.xml）のdisplay-nameタグに記述したアプリケーション表示名を指定します。

-d <アプリケーションディレクトリパス>

アプリケーションサーバマシン（J2EEサーバ）から参照できるアプリケーションディレクトリのパスを指定します。

-replace

J2EEアプリケーションを再登録する場合に指定します。

入力例

cmx_register_application -f App1.ear -appver 1.1 -replace

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

J2EEアプリケーションを登録する形式が異なっていても，同じアプリケーション表示名のアプリケーションは登録できません。

また，同じアプリケーション表示名のアプリケーションがすでに登録されている場合に，-replaceオプションを指定しても，登録するアプリケーションの形式が異なるときは再登録できません。異なる形式のアプリケーションを再登録する場合は，登録済みのアプリケーションを削除してから登録してください。

cmx_register_resource

形式

リソースアダプタを登録する場合

cmx_register_resource [共通引数] -f <RARファイル> [-c <Connector属性ファイル>] [-replace]

JavaBeansリソースを登録する場合

cmx_register_resource [共通引数] -f <JARファイル> -c <JavaBeansリソース属性ファイル> [-replace]

機能

Management Serverが管理するドメインにリソースアダプタまたはJavaBeansリソースを登録します。

-fオプションの引数で指定したリソースアダプタまたはJavaBeansリソースの表示名と同じ表示名のリソースアダプタがすでに登録されている場合は，-replaceオプションを指定することによって，再登録できます。

引数

-f <RARファイルまたはJARファイル>

登録するリソースアダプタのRARファイルまたはJavaBeansリソースのJARファイルのパスを指定します。

-c <Connector属性ファイルまたはJavaBeansリソース属性ファイル>

登録するリソースアダプタのConnector属性ファイルまたはJavaBeansリソース属性ファイルのパスを指定します。JavaBeansリソースを登録する場合は，-cオプションでJavaBeansリソース属性ファイルを必ず指定してください。

-replace

リソースを再登録する場合に指定します。

入力例

cmx_register_resource -f App1.rar -replace

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

RARファイルとConnector属性ファイルで異なる表示名が指定された場合，Connector属性ファイルの表示名で登録します。リソースアダプタとJavaBeansリソースで同じ表示名が指定された場合はエラーになります。

cmx_resume_lb

形式

cmx_resume_lb [共通引数] [-s <Webシステム名>]

機能

負荷分散機を冗長化したシステムの場合に，障害の発生した負荷分散機の休止状態を解除して，設定処理を再開します。

負荷分散機を冗長化したシステムの場合，cmx_build_systemコマンドなどを入力すると，2台の負荷分散機に対して同じ設定が同時に実行されます。一方の負荷分散機で障害が発生すると，障害が発生した負荷分散機に対する設定は抑止され，もう一方の負荷分散機だけに設定を実行する運用になります。この場合，障害の発生した負荷分散機を正常な負荷分散機と同じ設定に復旧してから，cmx_resume_lbコマンドを実行します。cmx_resume_lbコマンドが正常に受け付けられると，両方の負荷分散機に対して同じ設定を同時に実行する運用に回復されます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

入力例

cmx_resume_lb -s sample-system

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

負荷分散機を冗長化したシステムでない場合，または負荷分散機が休止状態でない場合はエラーになります。

cmx_scaleout_host

形式

cmx_scaleout_host [共通引数] -f <スケールアウト用ホスト定義ファイル>

機能

スケールアウト用ホスト定義ファイルの内容に従って，ホスト単位管理モデルのWebシステムの情報モデルを変更します。JP1/SC/DPMを利用して，ホスト単位管理モデルのWebシステムをスケールアウトする場合に使用します。このコマンドは，複製先のホストで実行します。

引数

-f <スケールアウト用ホスト定義ファイル>

スケールアウト用ホスト定義ファイルのパスを指定します。

入力例

cmx_scaleout_host -f MyWebSystemHostScaleout.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

運用管理サーバモデルのWebシステムのホストに対して，このコマンドを実行した場合はエラーになります。

負荷分散機およびCTMを使用したシステムで，このコマンドを実行する場合の注意事項を次に示します。

負荷分散機を使用したシステムの場合
複製元のホストと複製先のホストは，負荷分散機の仮想サーバを共有します。負荷分散機で使用するサーバIDの割り振りルールの範囲が，ホスト間で重複しないように，スケールアウト用ホスト定義ファイルを設定してください。

CTMを使用したシステムの場合
複製元のホストと複製先のホストは，同じCTMドメインに属します。複製元のホストにCTM識別子が定義されている場合，複製先のホストにも同じCTM識別子が定義されるため，CTMドメイン内でCTM識別子が重複することになります。このため，複製元のホストでは，CTM識別子の設定を省略することをお勧めします。CTM識別子の設定を省略した場合，CTM識別子は，ホスト間で一意になるように，Management Serverで自動的に設定されます。
なお，複製元のホストでCTM識別子を定義している場合は，このコマンドを実行したあとに，複製先のホストのCTM識別子をCTMドメイン内でユニークになるように設定し直してください。

cmx_start_application

形式

J2EEアプリケーションを指定して開始する場合

cmx_start_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -appname <アプリケーション表示名>

J2EEアプリケーションを指定しないで開始する場合

cmx_start_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

J2EEアプリケーションを開始します。コマンドにJ2EEアプリケーションを指定している場合と，指定していない場合とで開始対象となるJ2EEアプリケーションが異なります。

J2EEアプリケーションを指定する場合
Webシステムに含まれるすべてのサービスユニット上で，指定されたJ2EEアプリケーションを開始します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，指定されたJ2EEアプリケーションを開始します。

J2EEアプリケーションを指定していない場合
Webシステムに含まれるすべてのサービスユニット上で，そのWebシステムに関連づけられているすべてのJ2EEアプリケーション（アーカイブ形式および展開ディレクトリ形式）を開始します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，そのWebシステムに関連づけられているすべてのJ2EEアプリケーションを開始します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_start_application -s sample-system -unit unit1 -appname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_start_resource

形式

リソースアダプタを指定して開始する場合

cmx_start_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <リソースアダプタ表示名>

JavaBeansリソースを指定して開始する場合

cmx_start_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <JavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースを指定しないで開始する場合

cmx_start_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

リソースアダプタまたはJavaBeansリソースを開始します。コマンドにリソースアダプタまたはJavaBeansリソースを指定している場合と，指定していない場合とで開始対象となるリソースアダプタまたはJavaBeansリソースが異なります。

リソースアダプタまたはJavaBeansリソースを指定している場合
Webシステムに含まれるすべてのサービスユニット上で，指定されたリソースアダプタまたはJavaBeansリソースを開始します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，指定されたリソースアダプタまたはJavaBeansリソースを開始します。

リソースアダプタまたはJavaBeansリソースを指定していない場合
Webシステムに含まれるすべてのサービスユニット上で，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースを開始します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースを開始します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_start_resource -s sample-system -unit unit1 -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

コネクションプールのクラスタ化機能を利用しているリソースアダプタが開始対象に含まれている場合は，必ず-resnameオプションでリソースアダプタを指定して，一つずつ開始してください。この場合，メンバリソースアダプタを開始したあとに，ルートリソースアダプタを開始してください。
また，コネクションプールのクラスタ化機能を利用しているリソースアダプタと，利用していないリソースアダプタとが開始対象に含まれている場合は，コネクションプールのクラスタ化機能を利用しているリソースアダプタをすべて開始したあと，-resnameオプションを指定しないcmx_start_resourceコマンドを入力して，ほかのリソースアダプタを開始してください。

データベース上のキューに接続するためのリソースアダプタが開始対象に含まれている場合は，必ず-resnameオプションでリソースアダプタを指定して，次の順序で開始してください。

DB Connector for Cosminexus RM

Cosminexus RM

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_start_target

形式

Webシステムを開始する場合

cmx_start_target [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -mode { ALL|READY }

Webシステムに関連づいていない論理サーバを含むシステムを開始する場合

cmx_start_target [共通引数] -ns

機能

システムの開始をします。Webシステムを開始する場合と，Webシステムに関連づいていない論理サーバを含むシステムを開始する場合で動作が異なります。それぞれの場合の動作について説明します。

Webシステムを開始する場合
指定されたモードに応じて，開始対象のサービスユニットの状態を稼働状態または準備状態にします。稼働状態とは，サービスユニット中の全論理サーバが稼働中で負荷分散機からリクエストが振り分けられる状態です。準備状態とは，サービスユニット中の全論理サーバが稼働中で，負荷分散機からのリクエスト振り分けが抑止されている状態です。
コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全サービスユニットが，開始の対象となります。
サービスユニットの状態は，cmx_list_statusコマンドで参照できます。サービスユニットの状態の種類，およびサービスユニットの状態の参照方法については，「12.3　コマンドの詳細」の「cmx_list_status」を参照してください。

Webシステムに関連づいていない論理サーバを含むシステムを開始する場合
開始対象のシステムに含まれるすべての論理サーバを起動して，稼働状態にします。すでに稼働中の論理サーバは，引き続き稼働状態が保たれ，この操作によって再起動されることはありません。
運用管理ポータルで論理サーバの起動順序を設定している場合は，その順序に従って起動されます。
Webシステムに関連づいていない論理サーバの状態は，cmx_list_statusコマンドに-nsオプションを指定することで参照できます。論理サーバの状態の種類，および論理サーバの状態の参照方法については，「12.3　コマンドの詳細」の「cmx_list_status」を参照してください。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-mode { ALL|READY }

開始モードを指定します。

ALL
停止状態，閉塞状態，準備状態を稼働状態に引き上げます。

READY
停止状態，閉塞状態を準備状態に引き上げます。
稼働状態のサービスユニットを準備状態に引き下げることはできません。

-ns

Webシステムに関連づいていない論理サーバを含むシステムを起動する場合に指定します。

入力例

cmx_start_target -s sample-system -unit unit1 -mode ALL

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-unitオプションでセッションフェイルオーバ用，CTM用または統合ネーミングスケジューラサーバ用のサービスユニットを指定する場合，-modeオプションにREADYを指定したときはエラーになります。-unitオプションを省略している場合に，-modeオプションにREADYを指定した場合，Webシステムに属するセッションフェイルオーバ用，CTM用および統合ネーミングスケジューラサーバ用のサービスユニットの状態は，稼働状態に引き上げられます。

開始対象のサービスユニットに含まれている論理ユーザサーバは，-modeオプションの指定に関係なく，起動されます。開始対象のサービスユニットに論理ユーザサーバが含まれている場合に，論理ユーザサーバの起動に失敗したときは，サービスユニットの開始も失敗したとみなされます。この場合，-unitオプションを指定したコマンドは異常終了し，-unitオプションを省略したコマンドは警告終了します。

複数のJ2EEサーバを配置したCTM用のサービスユニットを起動する場合，一部のJ2EEサーバで起動処理を失敗しても，すべてのJ2EEサーバに対して起動処理を実行します。この場合，コマンドは異常終了します。

cmx_stop_application

形式

J2EEアプリケーションを指定して停止する場合

cmx_stop_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -appname <アプリケーション表示名>

J2EEアプリケーションを指定しないで停止する場合

cmx_stop_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

J2EEアプリケーションを停止します。コマンドにJ2EEアプリケーションを指定している場合と，指定していない場合とで停止対象となるJ2EEアプリケーションが異なります。

J2EEアプリケーションを指定する場合
Webシステムに含まれるすべてのサービスユニット上で，指定されたJ2EEアプリケーションを停止します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，指定されたJ2EEアプリケーションを停止します。

J2EEアプリケーションを指定していない場合
Webシステムに含まれるすべてのサービスユニット上で，そのWebシステムに関連づけられているすべてのJ2EEアプリケーション（アーカイブ形式および展開ディレクトリ形式）を停止します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，そのWebシステムに関連づけられているすべてのJ2EEアプリケーションを停止します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_stop_application -s sample-system -unit unit1 -appname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_stop_resource

形式

リソースアダプタを指定して停止する場合

cmx_stop_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <リソースアダプタ表示名>

JavaBeansリソースを指定して停止する場合

cmx_stop_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <JavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースを指定しないで停止する場合

cmx_stop_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

リソースアダプタまたはJavaBeansリソースを停止します。コマンドにリソースアダプタまたはJavaBeansリソースを指定している場合と，指定していない場合とで停止対象となるリソースアダプタまたはJavaBeansリソースが異なります。

リソースアダプタまたはJavaBeansリソースを指定している場合
Webシステムに含まれるすべてのサービスユニット上で，指定されたリソースアダプタまたはJavaBeansリソースを停止します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，指定されたリソースアダプタまたはJavaBeansリソースを停止します。

リソースアダプタまたはJavaBeansリソースを指定していない場合
Webシステムに含まれるすべてのサービスユニット上で，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースを停止します。
サービスユニットが指定されている場合は，指定されたサービスユニット上で，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースを停止します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_stop_resource -s sample-system -unit unit1 -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

コネクションプールのクラスタ化機能を利用しているリソースアダプタが停止対象に含まれている場合は，必ず-resnameオプションでリソースアダプタを指定して，一つずつ停止してください。この場合，ルートリソースアダプタを停止したあとに，メンバリソースアダプタを停止してください。
また，コネクションプールのクラスタ化機能を利用しているリソースアダプタと，利用していないリソースアダプタとが停止対象に含まれている場合は，コネクションプールのクラスタ化機能を利用しているリソースアダプタをすべて停止したあと，-resnameオプションを指定しないcmx_stop_resourceコマンドを入力して，ほかのリソースアダプタを停止してください。

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_stop_target

形式

Webシステムを停止する場合

cmx_stop_target [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -mode { ALL|HOLD }

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合

cmx_stop_target [共通引数] -ns [-normal]

機能

Webシステムを停止する場合
指定されたモードに応じて，停止対象のサービスユニットの状態を停止状態または閉塞状態にします。停止状態とは，サービスユニット中の全論理サーバが停止済みで，負荷分散機からのリクエスト振り分けが抑止されている状態です。また，閉塞状態とは，サービスユニット中のWebサーバが計画停止済み（ほかの論理サーバは稼働中）で，負荷分散機からのリクエスト振り分けが抑止されている状態です。
コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全サービスユニットが停止の対象となります。
なお，このコマンドでは，実行中のクライアントからのリクエストを中断させないために，Webサーバは計画停止させます。
サービスユニットの状態は，cmx_list_statusコマンドで参照できます。サービスユニットの状態の種類，およびサービスユニットの状態の参照方法については，「12.3　コマンドの詳細」の「cmx_list_status」を参照してください。

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合
開始対象のシステムに含まれるすべての論理サーバを停止します。すでに停止中の論理サーバは，引き続き停止状態が保たれます。
運用管理ポータルで論理サーバの起動順序を設定している場合は，その順序の逆順に従って停止されます。また，Webサーバは計画停止します。計画停止とは，現在受け付けているすべてのリクエストの処理終了を待って論理サーバを停止させることです。Webサーバの計画停止をしたくない場合は-normalオプションを指定します。
Webシステムに関連づいていない論理サーバの状態は，cmx_list_statusコマンドに-nsオプションを指定することで参照できます。論理サーバの状態の種類，および論理サーバの状態の参照方法については，「12.3　コマンドの詳細」の「cmx_list_status」を参照してください。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-mode { ALL | HOLD }

停止モードを指定します。

ALL
稼働状態，準備状態，閉塞状態を停止状態に引き下げます。

HOLD
稼働状態，準備状態を閉塞状態に引き下げます。
停止状態のサービスユニットを閉塞状態に引き上げることはできません。

-ns

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合に指定します。

-normal

Webサーバの計画停止をしたくない場合に指定します。このオプションを指定しないでコマンドを実行すると，Webサーバは計画停止します。

入力例

cmx_stop_target -s sample-system -unit unit1 -mode ALL

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-unitオプションでセッションフェイルオーバ用，CTM用または統合ネーミングスケジューラサーバ用のサービスユニットを指定する場合に，-modeオプションにHOLDを指定したときはエラーになります。-unitオプションを省略している場合に，-modeオプションにHOLDを指定した場合，Webシステム中のセッションフェイルオーバ用，CTM用および統合ネーミングスケジューラサーバ用のサービスユニットは，稼働状態のままで変更されません。

停止対象のサービスユニットに論理ユーザサーバが含まれている場合に，-modeオプションにHOLDを指定したときは，サービスユニットは閉塞状態となりますが，論理ユーザサーバが停止されません。また，停止対象のサービスユニットに論理ユーザサーバが含まれている場合に，-modeオプションにALLを指定したときは，論理ユーザサーバが停止されます。論理ユーザサーバの停止に失敗した場合は，サービスユニットの停止も失敗したとみなされます。この場合，-unitオプションを指定したコマンドは異常終了し，-unitオプションを省略したコマンドは警告終了します。

複数のJ2EEサーバを配置したCTM用のサービスユニットを停止する場合，一部のJ2EEサーバで停止処理を失敗しても，すべてのJ2EEサーバに対して停止処理を実行します。この場合，コマンドは異常終了します。

cmx_test_lb

形式

cmx_test_lb [共通引数] [-s <Webシステム名>]

機能

引数で指定されたWebシステムに定義している負荷分散機を操作できるか，テストします。

このコマンドを利用することで，簡易構築定義ファイルの負荷分散機の定義内容やSmart Composer機能の環境設定，およびJP1/Cm2/NCの環境設定が正しく設定されているかどうか確認できます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

入力例

cmx_test_lb -s sample-system

戻り値

0：

負荷分散機の接続に成功しました。

1：

指定されたWebシステムには負荷分散機が定義されていません。

64：

負荷分散機との接続に失敗しました。

cmx_trans_param

形式

cmx_trans_param -i <入力ファイル> -p <抽象パラメタ指定> -o <出力ファイル>

機能

入力した簡易構築定義ファイル，または構成変更定義ファイル（論理サーバのパラメタ変更用）に対して，指定された抽象パラメタを展開し，Webシステムに適した物理ティアのコンフィグレーションを生成します。

参考

Webシステムを初期構築する場合は簡易構築定義ファイルを，構築したWebシステムの構成を変更する（論理サーバのパラメタを変更する）場合は構成変更定義ファイルを使用します。

なお，構成変更定義ファイルには，論理サーバのパラメタ変更用と，サービスユニット・ホスト追加用の2種類があります。このコマンドは，Webシステムの初期構築をする場合，およびWebシステム全体の設定を変更する場合に使用するため，サービスユニット・ホスト追加用の構成変更定義ファイルは指定できません。

引数

-i <入力ファイル>

簡易構築定義ファイル，または構成変更定義ファイル（論理サーバのパラメタ変更用）を指定します。

-p <抽象パラメタ指定>

<抽象パラメタ指定>には，<抽象パラメタ>=<値>の形式で，抽象パラメタとその値を指定します。

抽象パラメタにはリクエスト最大同時処理数を指定します。リクエスト最大同時処理数のパラメタ名は「UnitMaxParallelCount」であるため，<抽象パラメタ指定>には，「UnitMaxParallelCount=<値>」を指定します。

なお，抽象パラメタの詳細については，「付録B　抽象パラメタ」を参照してください。

-o <出力ファイル>

抽象パラメタ展開後の出力ファイルを指定します。

入力例

cmx_trans_param -i MyWebSystemDef.xml -p UnitMaxParallelCount=10 -o outMyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

<入力ファイル>に指定した物理ティアがcombined-tier以外の場合はエラーになります。

cmx_undefine_application

形式

アーカイブ形式のJ2EEアプリケーションの関連づけを削除する場合

cmx_undefine_application [共通引数] [-s <Webシステム名>] -appname <アプリケーション表示名> -appver <アプリケーションバージョンID>

展開ディレクトリ形式のJ2EEアプリケーションの関連づけを削除する場合

cmx_undefine_application [共通引数] [-s <Webシステム名>] -appname <アプリケーション表示名>

機能

J2EEアプリケーションとWebシステムの関連づけを削除します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

-appver <アプリケーションバージョンID>

J2EEアプリケーションのバージョンIDを指定します。

入力例

cmx_undefine_application -s sample-system -appname App1 -appver 1.0

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定したJ2EEアプリケーションがデプロイされている場合はエラーとなります。

cmx_undefine_resource

形式

リソースアダプタの関連づけを削除する場合

cmx_undefine_resource [共通引数] [-s <Webシステム名>] -resname <リソースアダプタ表示名>

JavaBeansリソースの関連づけを削除する場合

cmx_undefine_resource [共通引数] [-s <Webシステム名>] -resname <JavaBeansリソース表示名>

機能

リソースアダプタまたはJavaBeansリソースとWebシステムの関連づけを削除します。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_undefine_resource -s sample-system -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定したリソースアダプタまたはJavaBeansリソースがデプロイされている場合はエラーとなります。

cmx_undeploy_application

形式

J2EEアプリケーションを指定してアンデプロイする場合

cmx_undeploy_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -appname <アプリケーション表示名>

J2EEアプリケーションを指定しないでアンデプロイする場合

cmx_undeploy_application [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

J2EEアプリケーションをアンデプロイします。コマンドにJ2EEアプリケーションを指定している場合と，指定していない場合とでアンデプロイのしかたが異なります。

J2EEアプリケーションを指定する場合
Webシステムに含まれるすべてのサービスユニットから，指定されたJ2EEアプリケーションをアンデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットから，指定されたJ2EEアプリケーションをアンデプロイします。

J2EEアプリケーションを指定しない場合
Webシステムに含まれるすべてのサービスユニットから，そのWebシステムに関連づけられているすべてのJ2EEアプリケーション（アーカイブ形式および展開ディレクトリ形式）をアンデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットから，そのWebシステムに関連づけられているすべてのJ2EEアプリケーションをアンデプロイします。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_undeploy_application -s sample-system -unit unit1 -appname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_undeploy_resource

形式

リソースアダプタを指定してアンデプロイする場合

cmx_undeploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <リソースアダプタ表示名>

JavaBeansリソースを指定してアンデプロイする場合

cmx_undeploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -resname <JavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースを指定しないでアンデプロイする場合

cmx_undeploy_resource [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

機能

リソースアダプタまたはJavaBeansリソースをサービスユニットからアンデプロイします。コマンドにリソースアダプタまたはJavaBeansリソースを指定している場合と，指定していない場合とでアンデプロイのしかたが異なります。

リソースアダプタまたはJavaBeansリソースを指定している場合
Webシステムに含まれるすべてのサービスユニットから，指定されたリソースアダプタまたはJavaBeansリソースをアンデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットから，指定されたリソースアダプタまたはJavaBeansリソースをアンデプロイします。

リソースアダプタまたはJavaBeansリソースを指定していない場合
Webシステムに含まれるすべてのサービスユニットから，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースをアンデプロイします。
サービスユニットが指定されている場合は，指定したサービスユニットから，そのWebシステムに関連づけられているすべてのリソースアダプタまたはJavaBeansリソースをアンデプロイします。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_undeploy_resource -s sample-system -unit unit1 -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

セッションフェイルオーバ用のサービスユニットを処理対象に指定した場合はエラーになります。

cmx_unregister_application

形式

アーカイブ形式のJ2EEアプリケーションを削除する場合

cmx_unregister_application [共通引数] -appname <アプリケーション表示名> -appver <アプリケーションバージョンID>

展開ディレクトリ形式のJ2EEアプリケーションを削除する場合

cmx_unregister_application [共通引数] -appname <アプリケーション表示名>

機能

Management Serverが管理するドメインから，指定されたJ2EEアプリケーションを削除します。

アーカイブ形式のJ2EEアプリケーションを削除する場合
J2EEアプリケーションはアプリケーション表示名とアプリケーションバージョンIDで一意に識別されます。

展開ディレクトリ形式のJ2EEアプリケーションを削除する場合
J2EEアプリケーションはアプリケーション表示名で一意に識別されます。

引数

-appname <アプリケーション表示名>

J2EEアプリケーションの表示名を指定します。cmx_register_applicationコマンド実行後にメッセージに出力される表示名を使用します。

-appver <アプリケーションバージョンID>

J2EEアプリケーションのバージョンIDを指定します。

入力例

cmx_unregister_application -appname App1 -appver 1.0

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定したJ2EEアプリケーションがcmx_define_applicationコマンドでWebシステムに関連づけられている場合はエラーになります。

cmx_unregister_resource

形式

リソースアダプタを削除する場合

cmx_unregister_resource [共通引数] -resname <リソースアダプタ表示名>

JavaBeansリソースを削除する場合

cmx_unregister_resource [共通引数] -resname <JavaBeansリソース表示名>

機能

Management Serverが管理するドメインから，指定したリソースアダプタまたはJavaBeansリソースを削除します。

引数

-resname <リソースアダプタ表示名またはJavaBeansリソース表示名>

リソースアダプタまたはJavaBeansリソースの表示名を指定します。cmx_register_resourceコマンド実行後にメッセージに出力される表示名を使用します。

入力例

cmx_unregister_resource -resname App1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

指定されたリソースアダプタまたはJavaBeansリソースが，cmx_define_resourceコマンドでWebシステムに関連づけられている場合はエラーになります。

13.　ファイル

この章では，Smart Composer機能で使用するファイルの形式，格納先，機能，指定するキーについて説明します。

＜この章の構成＞

13.1　ファイルの概要

13.2　ファイルの一覧

13.3　cmxserver.properties（サーバ設定プロパティファイル）

13.4　.cmxrc（クライアント設定プロパティファイル）

13.5　cmxclient.properties（クライアント共通設定プロパティファイル）

13.6　lb.properties（負荷分散機定義プロパティファイル）

13.7　簡易構築定義ファイル

13.8　構成変更定義ファイル

13.9　論理サーバ参照定義ファイル

13.10　スケールアウト用ホスト定義ファイル

13.1　ファイルの概要

ファイルの文法の記述形式について説明します。

＜この節の構成＞

13.1.1　ファイルの文法の記述形式

13.1.1　ファイルの文法の記述形式

形式

ファイルの記述形式を示します。

ファイルの格納先

ファイルの格納先を示します。

機能

ファイルの機能について説明します。

指定できるキー

ファイルの中で指定できるキーについて説明します。

指定できる要素

ファイルの中で指定できる要素について説明します。

記述例

ファイルの内容の記述例を示します。

注意事項

ファイルを設定または使用する際の注意事項を説明します。

参考

すべてのファイルで上記の項目をすべて説明しているわけではありません。また，上記以外に，各ファイルの固有情報を記載している場合があります。

13.2　ファイルの一覧

Smart Composer機能で使用するファイルについて説明します。使用するファイルはJ2EEアプリケーションを実行するシステムとバッチアプリケーションを実行するシステムで異なります。システムごとに使用するファイルについて説明します。

＜この節の構成＞

(1)　J2EEアプリケーションを実行するシステムで使用するファイル

(2)　バッチアプリケーションを実行するシステムで使用するファイル

(1)　J2EEアプリケーションを実行するシステムで使用するファイル

J2EEアプリケーションを実行するシステムで使用するファイルの一覧を次の表に示します。

表13-1　J2EEアプリケーションを実行するシステムで使用するファイルの一覧

分類
ファイル名称
概要

コマンドの動作環境設定ファイル
cmxserver.properties（サーバ設定プロパティファイル）
Smart Composer機能のコマンドの実行環境を設定します。

.cmxrc（クライアント設定プロパティファイル）
Smart Composer機能のコマンドの共通引数のデフォルト値を設定できます。
クライアントごとに，異なるデフォルト値を設定したい場合に使用します。

cmxclient.properties（クライアント共通設定プロパティファイル）
Smart Composer機能のコマンドの共通引数のデフォルト値を設定できます。
すべてのクライアントに，共通のデフォルト値を設定したい場合に使用します。

lb.properties（負荷分散機定義プロパティファイル）
負荷分散機へのアクセスに必要な接続情報を設定します。

Webシステム構築用定義ファイル
簡易構築定義ファイル
Smart Composer機能のコマンドで構築するWebシステムを定義します。

構成変更定義ファイル
Smart Composer機能のコマンドで構築したWebシステムの構成変更内容を定義します。

論理サーバ参照定義ファイル※
Smart Composer機能のコマンドで構築したWebシステム中のサービスユニットに追加する，論理ユーザサーバを定義します。

スケールアウト用ホスト定義ファイル
Smart Composer機能のコマンドで構築した，ホスト単位管理モデルのWebシステムをスケールアウトする場合に，複製先のWebシステムの構成内容を定義します。

注※　論理サーバ参照定義ファイルは旧バージョンとの互換用ファイルです。07-50以降，論理ユーザサーバを設定する場合は，簡易構築定義ファイルを使用してください。

(2)　バッチアプリケーションを実行するシステムで使用するファイル

バッチアプリケーションを実行するシステムで使用するファイルの一覧を次の表に示します。

表13-2　バッチアプリケーションを実行するシステムで使用するファイルの一覧

分類
ファイル名称
概要

コマンドの動作環境設定ファイル
cmxserver.properties（サーバ設定プロパティファイル）
Smart Composer機能のコマンドの実行環境を設定します。

.cmxrc（クライアント設定プロパティファイル）
Smart Composer機能のコマンドの共通引数のデフォルト値を設定できます。
クライアントごとに，異なるデフォルト値を設定したい場合に使用します。

cmxclient.properties（クライアント共通設定プロパティファイル）
Smart Composer機能のコマンドの共通引数のデフォルト値を設定できます。
すべてのクライアントに，共通のデフォルト値を設定したい場合に使用します。

Webシステム構築用定義ファイル
簡易構築定義ファイル
Smart Composer機能のコマンドで構築するWebシステムを定義します。

構成変更定義ファイル
Smart Composer機能のコマンドで構築したWebシステムの構成変更内容を定義します。

スケールアウト用ホスト定義ファイル
Smart Composer機能のコマンドで構築した，ホスト単位管理モデルのWebシステムをスケールアウトする場合に，複製先のWebシステムの構成内容を定義します。

13.3　cmxserver.properties（サーバ設定プロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

Javaプロパティファイル形式です。

Smart Composer機能のサーバ設定プロパティファイルです。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Smart Composer機能のコマンドの実行環境を設定します。

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称 | 内容 | デフォルト値
cmx.max_wait_time | 共通オプション-waitを指定して実行したコマンドに有効で，すでに実行しているコマンドの完了を待つときの最大待ち時間を，1～2147483647の範囲で指定します。単位は秒です。ここで設定した時間を超えても，すでに実行しているコマンドが完了しない場合は，あとから実行したコマンドはエラーリターンします。 | 180

(5)　記述例

cmx.max_wait_time=360

(6)　注意事項

パラメタが存在しない，または誤っている場合はデフォルト値を仮定します。

Management Server起動中に設定ファイルを更新した場合，Management Serverの再起動後に更新情報が反映されます。

13.4　.cmxrc（クライアント設定プロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

Javaプロパティ形式です。

(2)　ファイルの格納先

コマンドを実行するOSユーザのホームディレクトリに格納します。

(3)　機能

Smart Composer機能で提供するコマンドの共通引数のデフォルト値を設定します。このファイルはクライアントごとに個別にデフォルト値を設定する場合に使用します。

次のテンプレートファイルをコピーして利用してください。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥.cmxrc

UNIXの場合
/opt/Cosminexus/manager/config/templates/.cmxrc

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

cmx.connect.host※1
共通引数の-mオプション省略時に仮定するホスト名，およびポート番号を設定します。
IPアドレスは，メタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用できるローカルIPアドレスのうちマッチするIPアドレスを採用します。※2
なし

cmx.connect.userid
共通引数の-uオプション省略時に仮定するユーザIDを設定します。
なし

cmx.connect.passwd
共通引数の-pオプション省略時に仮定するパスワードを設定します。
なし

cmx.wait
共通引数の-waitオプションをデフォルトにする場合は，trueを，-nowaitオプションをデフォルトにする場合は，falseを設定します。
false

cmx.verbose
共通引数の-verboseオプションをデフォルトにする場合は，trueを，-noverboseオプションをデフォルトにする場合は，falseを設定します。
false

cmx.websystem.name
次に示すコマンドの-sオプション省略時に，Webシステム名を設定します。

cmx_build_system※3

cmx_define_application※4

cmx_define_resource

cmx_delete_serverref※4

cmx_delete_system

cmx_deploy_application※4

cmx_deploy_resource

cmx_list_model※5

cmx_list_status

cmx_resume_lb※4

cmx_start_application※4

cmx_start_resource

cmx_start_target

cmx_stop_application※4

cmx_stop_resource

cmx_stop_target

cmx_test_lb※4

cmx_undefine_application※4

cmx_undefine_resource

cmx_undeploy_application※4

cmx_undeploy_resource

なし

cmx.lb※4
cmx_delete_systemコマンドの-lbオプション省略時に，負荷分散機の仮想サーバに対する動作を設定します。

keepvs：仮想サーバを削除しません。

deletevs：仮想サーバを削除します。

なし

cmx.encoding
cmx_export_modelコマンドの-indentオプション省略時に仮定する文字エンコーディングを指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
UTF-8

cmx.indent
cmx_export_modelコマンドの-indentオプション省略時に仮定するインデントサイズを指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
2

cmx.myhost
cmx_export_modelコマンドの-myhostオプション省略時に仮定する運用管理サーバマシンのホスト名を指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
なし

注※1

次の場合にmserver.propertiesのwebserver.connector.http.bind_hostに値を指定しているときは，cmx.connect.hostキーにも同じ値を指定してください。

J2EEアプリケーションを実行するシステムをホスト単位管理モデルで運用する場合

バッチアプリケーションを実行するシステムの場合

注※2

運用管理ドメイン内で運用管理エージェントとの通信に使用されるIPアドレスのサブネットが一つに決められている場合，指定するIPアドレスを"192¥¥.168¥¥.0¥¥..+"のように記述しておけば，前方が"192.168.0."であるIPアドレス（"192.168.0.32"や"192.168.0.128"など）にマッチするため，設定ファイルを修正しないで，すべてのホストに配布して利用できます。正規表現についての詳細は，Javaのjava.util.regex.Patternクラスの仕様を確認してください。

指定した正規表現にマッチするIPアドレスが複数個検出された場合は，最も小さい値のIPアドレスを採用します。例えば，"192.168.0.32"と"192.168.0.128"が検出された場合は"192.168.0.32"を採用します。この場合，採用されたIPアドレスが意図するIPアドレスになるとは限らないため，"192¥¥.168¥¥.0¥¥.1.."のように必ず1個だけマッチする正規表現を記述してください。

IPアドレスを正規表現で指定する場合は，次の点に注意してください。

¥を指定する場合は2文字連続して（¥¥）指定してください。¥¥は1文字の¥に置き換えられます。

コロン（:）を使用しないでください。コロン以降はポート番号とみなされます。

注※3

cmx_build_systemコマンド実行時に，-fオプションを指定している場合は，キーの設定は無効になります。

注※4

バッチアプリケーションを実行するシステムでは使用できません。

注※5

cmx.websystem.nameキーを設定している場合に，cmx_list_modelコマンドを使用して，登録されているすべてのWebシステムの情報モデルを取得するときは，-allオプションを指定してください。

(5)　記述例

cmx.connect.host=localhost:28080
cmx.connect.userid=admin
cmx.connect.passwd=p1574809
cmx.wait=true
#cmx.verbose=false
cmx.websystem.name=MyWebSystem
cmx.lb=deletevs

(6)　注意事項

このファイルには，ユーザIDやパスワードなどを記載するため，適切にファイルのアクセス権を設定してください。

ASCII文字以外の文字を記述する場合は，設定ファイルの文字エンコーディングとSmart Composer機能のコマンド実行時のOSロケールの文字エンコーディングを合わせてください。また，日本語を使用する場合にUnicodeエンコードされた文字（Unicode-encoded character）を含めた文字列で指定しないでください。

各パラメタが存在しない，または誤っている場合はデフォルト値を仮定します。

設定値（true，false）は，大文字，小文字の区別はしません。

13.5　cmxclient.properties（クライアント共通設定プロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

Javaプロパティ形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合
/opt/Cosminexus/manager/config/

(3)　機能

Smart Composer機能で提供するコマンドの共通引数のデフォルト値を設定します。このファイルはすべてのクライアントで共通のデフォルト値を設定する場合に使用します。

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。

キー名称
内容
デフォルト値

cmx.apply_user
このファイルを適用するクライアントのOSのユーザIDを設定します。ユーザIDはコンマで区切って指定します。
なし

cmx.connect.host※1
共通引数の-mオプション省略時に仮定するホスト名，およびポート番号を設定します。
IPアドレスは，メタキャラクタを用いた正規表現で指定できます。IPアドレスが正規表現で指定された場合，利用できるローカルIPアドレスのうちマッチするIPアドレスを採用します。※2
なし

cmx.connect.userid
共通引数の-uオプション省略時に仮定するユーザIDを設定します。
なし

cmx.connect.passwd
共通引数の-pオプション省略時に仮定するパスワードを設定します。
なし

cmx.wait
共通引数の-waitオプションをデフォルトにする場合は，trueを，-nowaitオプションをデフォルトにする場合は，falseを設定します。
false

cmx.verbose
共通引数の-verboseオプションをデフォルトにする場合は，trueを，-noverboseオプションをデフォルトにする場合は，falseを設定します。
false

cmx.websystem.name
次に示すコマンドの-sオプション省略時に，Webシステム名を設定します。

cmx_build_system※3

cmx_define_application※4

cmx_define_resource

cmx_delete_serverref※4

cmx_delete_system

cmx_deploy_application※4

cmx_deploy_resource

cmx_list_model※5

cmx_list_status

cmx_resume_lb※4

cmx_start_application※4

cmx_start_resource

cmx_start_target

cmx_stop_application※4

cmx_stop_resource

cmx_stop_target

cmx_test_lb※4

cmx_undefine_application※4

cmx_undefine_resource

cmx_undeploy_application※4

cmx_undeploy_resource

なし

cmx.lb※4
cmx_delete_systemコマンドの-lbオプション省略時に，負荷分散機の仮想サーバに対する動作を設定します。

keepvs：仮想サーバを削除しません。

deletevs：仮想サーバを削除します。

なし

cmx.encoding
cmx_export_modelコマンドの-indentオプション省略時に仮定する文字エンコーディングを指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
UTF-8

cmx.indent
cmx_export_modelコマンドの-indentオプション省略時に仮定するインデントサイズを指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
2

cmx.myhost
cmx_export_modelコマンドの-myhostオプション省略時に仮定する運用管理サーバマシンのホスト名を指定します。
指定できる値については，「12.3　コマンドの詳細」の「cmx_export_model」を参照してください。
なし

注※1

J2EEアプリケーションを実行するシステムをホスト単位管理モデルで運用する場合，またはバッチアプリケーションを実行するシステムの場合，次の点に注意してください。

mserver.propertiesのwebserver.connector.http.bind_hostに値を指定ているときは，cmx.connect.hostキーにも同じ値を指定してください。

注※2

運用管理ドメイン内で運用管理エージェントとの通信に使用されるIPアドレスのサブネットが一つに決められている場合，指定するIPアドレスを"192¥¥.168¥¥.0¥¥..+"のように記述しておけば，前方が"192.168.0."であるIPアドレス（"192.168.0.32"や"192.168.0.128"など）にマッチするため，設定ファイルを修正しないで，すべてのホストに配布して利用できます。正規表現についての詳細は，Javaのjava.util.regex.Patternクラスの仕様を確認してください。

指定した正規表現にマッチするIPアドレスが複数個検出された場合は，最も小さい値のIPアドレスを採用します。例えば，"192.168.0.32"と"192.168.0.128"が検出された場合は"192.168.0.32"を採用します。この場合，採用されたIPアドレスが意図するIPアドレスになるとは限らないため，"192¥¥.168¥¥.0¥¥.1.."のように必ず1個だけマッチする正規表現を記述してください。

IPアドレスを正規表現で指定する場合は，次の点に注意してください。

¥を指定する場合は2文字連続して（¥¥）指定してください。¥¥は1文字の¥に置き換えられます。

コロン（:）を使用しないでください。コロン以降はポート番号とみなされます。

注※3

cmx_build_systemコマンド実行時に，-fオプションを指定している場合は，キーの設定は無効になります。

注※4

バッチアプリケーションを実行するシステムでは使用できません。

注※5

cmx.websystem.nameキーを設定している場合に，cmx_list_modelコマンドを使用して，登録されているすべてのWebシステムの情報モデルを取得するときは，-allオプションを指定してください。

(5)　記述例

cmx.apply_user=Administrator,muser1
cmx.connect.host=localhost:28080
cmx.connect.userid=admin
cmx.connect.passwd=p1574809
cmx.wait=true
#cmx.verbose=false
cmx.websystem.name=MyWebSystem
cmx.lb=deletevs

(6)　注意事項

このファイルには，ユーザIDやパスワードなどを記載するため，適切にファイルのアクセス権を設定してください。

ASCII文字以外の文字を記述する場合は，設定ファイルの文字エンコーディングとSmart Composer機能のコマンド実行時のOSロケールの文字エンコーディングを合わせてください。また，日本語を使用する場合にUnicodeエンコードされた文字（Unicode-encoded character）を含めた文字列で指定しないでください。

各パラメタが存在しない，または誤っている場合はデフォルト値を仮定します。

設定値（true，false）は，大文字，小文字の区別はされません。

cmx.apply_userキーに指定する内容は，UNIXの場合，大文字，小文字が区別されます。Windowsの場合は，大文字と小文字の区別はされません。

.cmxrcファイルとcmxclient.propertiesファイルの両方を使用している場合は，.cmxrcファイルが適用されます。cmxclient.propertiesファイルは読み込まれません。

.cmxrcファイルを使用していないクライアントで，cmxclient.propertiesファイルにアクセス権限のないクライアントは，cmxclient.propertiesファイルの読み込み時にエラーが発生します。このため，Smart Composer機能のコマンドを使用するクライアントには，cmx.apply_userキーにユーザIDを設定して，cmxclient.propertiesファイルへのアクセス権を与えてください。

13.6　lb.properties（負荷分散機定義プロパティファイル）

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できるキー

(5)　記述例

(6)　注意事項

(1)　形式

Javaプロパティ形式です。

(2)　ファイルの格納先

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config

UNIXの場合
/opt/Cosminexus/manager/config

(3)　機能

負荷分散機へのアクセスに必要な接続情報を設定します。Cosminexusから負荷分散機を制御する場合に使用します。

(4)　設定できるキー

指定できるキーとデフォルト値を次に示します。なお，負荷分散機の制御方法によって，設定できるキーが異なるので注意してください。

キー名称
内容
デフォルト値
負荷分散機の制御方法

ssh
Telnet
JP1/Cm2/NC

lb.list
負荷分散機の管理IPアドレスをドット記法（xxx.xxx.xxx.xxx）で設定します。xxxには0～255の整数を指定します。なお，複数の負荷分散機を使用する場合は，コンマで区切り，複数の管理IPアドレスを設定します。
なし
○
○
○

lb.connect_type.<IPアドレス>※1※2
負荷分散機への接続形態を次のように設定します。

sshコマンドを使用する場合
「ssh」

Telnetを直接使用する場合
「telnet」

JP1/Cm2/NCを使用する場合
「jp1_nc」，または指定なし

上記以外の場合はエラーになります。
なし
○
○
○

lb.ssh.port.<IPアドレス>※1
負荷分散機のポート番号を設定します。指定できる値は1～65535の整数です。
22
○
×
×

lb.ssh.user.<IPアドレス>※1
負荷分散機にsshで接続するときのユーザ名を設定します。
なし
○
×
×

lb.ssh.passwd.<IPアドレス>※1
負荷分散機にsshで接続するときのユーザのパスワードを設定します。
なし
○
×
×

lb.ssh.timeout.<IPアドレス>※1※2
負荷分散機へのsshコマンド実行（接続処理）時のタイムアウト時間（秒）を設定します。
このキーで設定した時間内に，負荷分散機への接続処理が完了しない場合は，Smart Composer機能のコマンド（cmx_build_systemなど）がタイムアウトエラーで異常終了します。
なお，設定できる値は1～2147483の整数です。
10
○
×
×

lb.telnet.port.<IPアドレス>※1※2
負荷分散機のポート番号を設定します。指定できる値は1～65535の整数です。
23
×
○
×

lb.telnet.user.<IPアドレス>※1
負荷分散機にTelnetでログインするときのユーザ名を設定します。
なし
×
○
×

lb.telnet.passwd.<IPアドレス>※1
負荷分散機にTelnetでログインするときのユーザのパスワードを設定します。
なし
×
○
×

lb.telnet.login_timeout.<IPアドレス>※1
負荷分散機へ接続時のログイン処理時のタイムアウト時間（秒）を設定します。
このキーで設定した時間内に，負荷分散機へのログイン処理が完了しない場合は，Smart Composer機能のコマンド（cmx_build_systemなど）がタイムアウトエラーで異常終了します。
なお，設定できる値は1～2147483の整数です。
10
×
○
×

lb.telnet.command_timeout.<IPアドレス>※1※2
負荷分散機へのコマンド送信時のタイムアウト時間(秒)を設定します。
このキーで設定した時間内に，負荷分散機に対して発行したCLIコマンドが完了しない場合は，Smart Composer機能のコマンド（cmx_build_systemなど）がタイムアウトエラーで異常終了します。
なお，設定できる値は1～2147483の整数です。
10
×
○
×

lb.telnet.user_prompt.<IPアドレス>※1
負荷分散機への接続時の，ユーザ名入力プロンプトに表示される文字列を設定します。※3※4
なし
×
○
×

lb.telnet.passwd_prompt.<IPアドレス>※1
負荷分散機への接続時の，パスワード入力プロンプトに表示される文字列を設定します。※3※4
なし
×
○
×

lb.telnet.login_prompt.<IPアドレス>※1
負荷分散機への接続時の，ログイン完了後プロンプトに表示される文字列を設定します。※3※4
なし
×
○
×

lb.enable_passwd.<IPアドレス>※1
負荷分散機に設定したPrivileged EXECレベルに必要なパスワードを負荷分散機ごとに設定します。
Loadflowbalの場合に設定します。BIG-IP 1500およびBIG-IP 1000の場合はこのキーの設定は不要です。
なし
×
×
○

ncm.host
接続するJP1/Cm2/NC - Managerのホストをドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で設定します。なお，xxxには0～255の整数を指定します。
なし
×
×
○

ncm.port
JP1/Cm2/NC - Managerに接続するためのポート番号を設定します。JP1/Cm2/NC - Manager動作条件定義ファイル（ncm.conf）のmgr_portに指定したポート番号を設定してください。なお，JP1/Cm2/NC - Manager動作条件定義ファイル（ncm.conf）については，マニュアル「JP1 Version 8 JP1/Cm2/Network Element Configuration　機能・構築ガイド」またはマニュアル「JP1 Version 7i JP1/Cm2/Network Element Configuration」を参照してください。
20344
×
×
○

ncm.user
JP1/Cm2/NC - Managerにログインするためのログインユーザを設定します。JP1/Cm2/NC - Managerのncmuserコマンドで登録したログインユーザを設定してください。
なし
×
×
○

ncm.passwd
JP1/Cm2/NC - Managerにログインするためのログインユーザのパスワードを設定します。JP1/Cm2/NC - Managerのncmuserコマンドで登録したログインユーザのパスワードを設定してください。
なし
×
×
○

（凡例）

○：指定します。

×：指定しません。

ssh：sshコマンドを使用して負荷分散機を制御する場合を示します。

Telnet：Telnetを直接使用して負荷分散機を制御する場合を示します。

JP1/Cm2/NC：JP1/Cm2/NCを使用して負荷分散機を制御する場合を示します。

注※1

lb.listに指定した負荷分散機の管理IPアドレスを指定します。

注※2

指定できる値以外の値が指定された場合は，cmx_test_lbコマンド，cmx_build_systemコマンド，cmx_delete_systemコマンド，cmx_start_targetコマンド，およびcmx_stop_targetコマンドを実行したときにエラーになるので注意してください。

注※3

設定する文字列の先頭または最後の文字が空白文字の場合は，文字列全体を""で囲んでください。

注※4

実際に接続する負荷分散機にTelnetを使用してログインして，あらかじめ，設定する内容を確認しておいてください。

(5)　記述例

sshコマンドを使用してCosminexusから負荷分散機を制御する場合

# 192.168.100.10 ... BIG-IP 1500

lb.list=192.168.100.10

lb.connect_type.192.168.100.10=ssh
#lb.ssh.port.192.168.100.10=22
lb.ssh.user.192.168.100.10=user01
lb.ssh.passwd.192.168.100.10=user01pw
#lb.ssh.timeout.192.168.100.10=10

Telnetを直接使用してCosminexusから負荷分散機を制御する場合

# 192.168.1.20 ... Loadflowbal
# 192.168.1.21 ... BIG-IP 1000

lb.list=192.168.1.20,192.168.1.21

lb.enable_passwd.192.168.1.20=ServerIron
lb.connect_type.192.168.1.20=telnet
#lb.telnet.port.192.168.1.20=23
lb.telnet.user.192.168.1.20=user01
lb.telnet.passwd.192.168.1.20=user01
lb.telnet.user_prompt.192.168.1.20="Please Enter Login Name: "
lb.telnet.passwd_prompt.192.168.1.20="Please Enter Password: "
lb.telnet.login_prompt.192.168.1.20=>
#lb.telnet.login_timeout.192.168.1.20=10
#lb.telnet.command_timeout.192.168.1.20=10

lb.connect_type.192.168.1.21=telnet
#lb.telnet.port.192.168.1.21=23
lb.telnet.user.192.168.1.21=support
lb.telnet.passwd.192.168.1.21=support
lb.telnet.user_prompt.192.168.1.21="login: "
lb.telnet.passwd_prompt.192.168.1.21="Password:"
lb.telnet.login_prompt.192.168.1.21="# "
#lb.telnet.login_timeout.192.168.1.21=10
#lb.telnet.command_timeout.192.168.1.21=10

JP1/Cm2/NCを使用してCosminexusから負荷分散機を制御する場合

# 192.168.1.10 ... Loadflowbal
# 192.168.1.11 ... BIG-IP 1000

ncm.host=localhost
#ncm.port=20344
ncm.user=admin
ncm.passwd=user01

lb.list=192.168.1.10,192.168.1.11
lb.enable_passwd.192.168.1.10=ServerIron

(6)　注意事項

このファイルには，パスワードなどの情報が含まれているため，適切にファイルのアクセス権を設定してください。

各パラメタが存在しない，または誤っている場合はデフォルト値を仮定します。

Management Server起動中に設定ファイルを更新した場合，Management Serverの再起動後に更新情報が反映されます。

このファイルを更新した場合，またはManagement Serverマシンと負荷分散機との接続構成を変更した場合，cmx_test_lbコマンドを使用して，負荷分散機への接続を確認してください。cmx_test_lbコマンドの詳細については，「12.3　コマンドの詳細」を参照してください。負荷分散機へ接続できない場合は，cmx_test_lbコマンドが出力したメッセージを基に，次の設定内容を確認してください。

負荷分散機の設定（「6.3　負荷分散機の設定」参照）

JP1/Cm2/NCの設定（「付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定」参照）

簡易構築定義ファイルの負荷分散機の定義（<load-balancer>タグの定義）（「6.8　システムの構成定義」参照）

13.7　簡易構築定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できる要素

(1)　形式

XML形式です。

(2)　ファイルの格納先

任意の作業場所に格納してください。

(3)　機能

Smart Composer機能のコマンドで構築するWebシステムを定義します。

次のテンプレートファイルをコピーして利用してください。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。

(4)　設定できる要素

簡易構築定義ファイルには，Webシステムの属性，負荷分散機，物理ティア，サービスユニット，およびサービスユニットを構成するホストを定義します。Webシステムの属性，物理ティア，サービスユニット，およびホストは，定義ファイル内に必要な数だけ定義し，負荷分散機はWebシステム内に一つ定義します。

ただし，Cosminexusから負荷分散機を制御する場合（Smart Composer機能で負荷分散機の設定，および実サーバポートの開始・閉塞をしない場合）は，負荷分散機の定義を記述する必要はありません。また，バッチアプリケーションを実行するシステムの場合，負荷分散機を使用しないため，負荷分散機の定義を記述する必要はありません。

簡易構築定義ファイルの構造を次に示します。<model-definition>タグおよび<web-system>タグは，このままの形式で指定します。

簡易構築定義ファイルの構造

<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの定義 -->
 <web-system>
   <!-- Webシステムの属性定義 -->
   <name>Webシステム名</name>
   <display-name>Webシステムの表示名</display-name>
   <description>Webシステムのコメント</description>

   <!-- 負荷分散機の定義 -->※1
   <load-balancer>
     <name>負荷分散機名</name>
     <load-balancer-type>負荷分散機の種類</load-balancer-type>
     <display-name>負荷分散機の表示名</display-name>
     <description>負荷分散機のコメント</description>
     <!-- cookieスイッチングの定義 -->※2
     <cookie-switching>
       <cookie-switching-enabled>true/false</cookie-switching-enabled>
       <cookie-name>cookie名</cookie-name>
       <server-id-rule>最小値-最大値</server-id-rule>
     </cookie-switching>
     <management-host>負荷分散機の管理IPアドレスまたはホスト名</management-host>
     <redundant-management-host>2台目の負荷分散機の管理IPアドレスまたはホスト名※3</redundant-management-host>
     <!-- 仮想サーバの定義 -->
     <virtual-server>
       <virtual-server-name>仮想サーバ名</virtual-server-name>
       <display-name>仮想サーバの表示名</display-name>
       <description>仮想サーバのコメント</description>
       <ip-address>仮想サーバのIPアドレス</ip-address>
       <http-port>仮想サーバのhttpポート番号</http-port>
     </virtual-server>
   </load-balancer>

   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>物理ティアの種類</tier-type>
     <configuration>
       <logical-server-type>論理サーバの種類</logical-server-type>
       <param>
         <param-name>パラメタ名</param-name>
         <param-value>パラメタ値1</param-value>
           ：
         <param-value>パラメタ値ｎ</param-value>
       </param>
       <param>
         ：
     </configuration>
     <configuration>
       ：
   </tier>
   <tier>
     ：

   <!-- サービスユニットの定義 -->
   <unit>
     <name>サービスユニット名</name>
     <display-name>サービスユニットの表示名</display-name>
     <description>サービスユニットのコメント</description>
     <allocated-host>
       <host-ref>サービスユニットの構成ホストのホスト名またはIPアドレス</host-ref>
       <hosts-for>構成ホストが属する物理ティアの種類</hosts-for>
       <define-server>
         <logical-server-name>論理サーバ名</logical-server-name>
         <display-name>論理サーバの表示名</display-name>
         <description>論理サーバのコメント</description>
         <logical-server-type>論理サーバの種類</logical-server-type>
         <configuration>
           <param>
             <param-name>パラメタ名</param-name>
             <param-value>パラメタ値1</param-value>
               ：
             <param-value>パラメタ値ｎ</param-value>
           </param>
           <param>
             ：
         </configuration>
         <configuration>
           ：
     </allocated-host>
     <allocated-host>
       ：
   </unit>
   <unit>
     ：
 </web-system>
 <web-system>
   ：

 <!-- ホストの定義 -->
 <host>
   <host-name>ホスト名またはIPアドレス</host-name>
   <display-name>ホストの表示名</display-name>
   <description>ホストのコメント</description>
   <agent-host>運用管理エージェントのホスト名またはIPアドレス</agent-host>
   <agent-port>Cosminexus運用管理エージェントのポート番号</agent-port>
 </host>
 <host>
   ：
</model-definition>

注※1

バッチアプリケーションを実行するシステムでは負荷分散機の定義は不要です。

注※2

負荷分散機のCookieスイッチング機能を使用する場合に必要です。この設定によって，一連のHTTPリクエストが一つのWebサーバまたはJ2EEサーバで処理されます。

注※3

負荷分散機を冗長化しているシステムの場合に指定します。

定義ごとに指定できるタグについては，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

13.8　構成変更定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できる要素

(1)　形式

XML形式です。

(2)　ファイルの格納先

任意の作業場所に格納してください。

(3)　機能

Smart Composer機能のコマンドで構築したWebシステムの構成を変更する場合に使用する定義ファイルです。構成変更定義ファイルには，論理サーバのパラメタ変更用とサービスユニット・ホスト追加用の二つの定義ファイルがあります。

次のテンプレートファイルをコピーして利用してください。

論理サーバのパラメタ変更用

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxmodcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxmodcombinedmodel.xml

注

論理サーバのパラメタ変更用の構成変更定義ファイルは，前バージョンとの互換用のファイルです。論理サーバのパラメタを変更する場合は，簡易構築定義ファイルを使用してください。

サービスユニット・ホスト追加用

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxaddcombinedmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxaddcombinedmodel.xml

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。

(4)　設定できる要素

構成変更定義ファイルには，簡易構築定義ファイルに指定するタグの一部が指定できます。

次に，簡易構築定義ファイルとの違いを中心に説明します。

(a)　論理サーバのパラメタ変更用の構成変更定義ファイル

論理サーバのパラメタ変更用の構成変更定義ファイルの構造を次に示します。<model-modification>タグおよび<web-system>タグは，このままの形式で指定します。

論理サーバのパラメタ変更用の構成変更定義ファイルの構造

<model-modification xmlns="http://www.cosminexus.com/mngsvr/schema/ModelModification-2.5">
 <!-- 構成変更対象のWebシステムの定義 -->
 <web-system>
   <!-- 構成変更対象のWebシステムの属性定義 -->
   <name>Webシステム名</name>

   <!-- パラメタ変更する物理ティアの論理サーバの定義 -->
   <tier>
     <tier-type>物理ティアの種類</tier-type>
     <configuration>
       <logical-server-type>論理サーバの種類</logical-server-type>
       <param>
         <param-name>パラメタ名</param-name>
         <param-value>パラメタ値1</param-value>
           ：
         <param-value>パラメタ値ｎ</param-value>
       </param>
       <param>
         ：
     </configuration>
     <configuration>
       ：
   </tier>
   <tier>
     ：

   <!-- パラメタ変更するサービスユニットの論理サーバの定義 -->
   <unit>
     <name>サービスユニット名</name>
     <allocated-host>
       <host-ref>サービスユニットの構成ホストのホスト名またはIPアドレス</host-ref>
       <hosts-for>構成ホストが属する物理ティアの種類</hosts-for>
       <define-server>
         <logical-server-type>論理サーバの種類</logical-server-type>
         <configuration>
           <param>
             <param-name>パラメタ名</param-name>
             <param-value>パラメタ値1</param-value>
               ：
             <param-value>パラメタ値ｎ</param-value>
           </param>
           <param>
             ：
         </configuration>
         <configuration>
           ：
     </allocated-host>
     <allocated-host>
        ：
   </unit>
   <unit>
     ：
 </web-system>
 <web-system>
   ：
</model-modification>

各定義での簡易構築定義ファイルとの違いを次に示します。

Webシステムの属性定義

<name>タグのWebシステム名には，構成変更対象のWebシステムの名称を指定します。

物理ティアの定義
物理ティア内の論理サーバの種類ごとにコンフィグレーションを変更する場合に指定します。

<configuration>タグは必ず定義します。ただし，cmx_trans_paramコマンドを使用し，抽象パラメタを展開して物理ティアのコンフィグレーションを生成する場合は省略できます。

<param-value>タグの指定が省略できます。省略した場合，設定済みのパラメタ値をすべて削除し，デフォルトの状態に戻します。

サービスユニットの定義
サービスユニット内の特定の論理サーバごとにコンフィグレーションを変更する場合に指定します。

CTM用のWebシステムで，物理ティアの定義に<j2ee-server-count>タグを指定している場合，特定のJ2EEサーバのコンフィグレーションを変更するときは，<server-no>タグを必ず指定してください。

<param-value>タグの指定が省略できます。省略した場合，設定済みのパラメタ値をすべて削除し，デフォルトの状態に戻します。

定義ごとに指定できるタグについては，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

(b)　サービスユニット・ホスト追加用の構成変更定義ファイル

サービスユニット・ホスト追加用の構成変更定義ファイルの構造を次に示します。<unit-addition>タグおよび<web-system>タグは，このままの形式で指定します。

サービスユニット・ホスト追加用の構成変更定義ファイルの構造

<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
 <!-- 構成変更対象のWebシステムの定義 -->
 <web-system>
   <!-- 構成変更対象のWebシステムの属性定義 -->
   <name>Webシステム名</name>
   <addition-mode>追加モード</addition-mode>

   <!-- 追加するサービスユニットの定義 -->
   <unit>
     <name>サービスユニット名</name>
     <display-name>サービスユニットの表示名</display-name>
     <description>サービスユニットのコメント</description>
     <allocated-host>
       <host-ref>サービスユニットの構成ホストのホスト名またはIPアドレス</host-ref>
       <hosts-for>構成ホストが属する物理ティアの種類</hosts-for>
       <define-server>
         <logical-server-name>論理サーバ名</logical-server-name>
         <display-name>論理サーバの表示名</display-name>
         <description>論理サーバのコメント</description>
         <logical-server-type>論理サーバの種類</logical-server-type>
         <configuration>
           <param>
             <param-name>パラメタ名</param-name>
             <param-value>パラメタ値1</param-value>
               ：
             <param-value>パラメタ値ｎ</param-value>
           </param>
           <param>
             ：
         </configuration>
         <configuration>
           ：
     </allocated-host>
     <allocated-host>
        ：
   </unit>
   <unit>
     ：
 </web-system>
 <web-system>
   ：

 <!-- 追加するホストの定義 -->
 <host>
   <host-name>ホスト名またはIPアドレス</host-name>
   <display-name>ホストの表示名</display-name>
   <description>ホストのコメント</description>
   <agent-host>運用管理エージェントのホスト名またはIPアドレス</agent-host>
   <agent-port>Cosminexus運用管理エージェントのポート番号</agent-port>
 </host>
 <host>
   ：
</unit-addition >

各定義での簡易構築定義ファイルとの違いを次に示します。

Webシステムの属性定義

<name>タグのWebシステム名には，構成変更対象のWebシステムの名称を指定します。

JP1/SC/DPMを使用してスケールアウトを実施する場合は，<addition-mode>タグに「DEPLOYED」を指定してください。<addition-mode>タグは，サービスユニット・ホスト追加用の構成変更定義ファイルでだけ指定できます。

サービスユニットの定義

簡易構築定義ファイルと同じです。

ホストの定義

簡易構築定義ファイルと同じです。

定義ごとに指定できるタグについては，「14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ」を参照してください。

13.9　論理サーバ参照定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できる要素

(5)　記述例

(1)　形式

XML形式です。

(2)　ファイルの格納先

任意の作業場所に格納してください。

(3)　機能

Smart Composer機能のコマンドで構築したWebシステム中のサービスユニットに，ユーザ定義の論理サーバ（論理ユーザサーバ）を追加する場合に使用する定義ファイルです。論理ユーザサーバをサービスユニットに関連づけるための情報を定義します。

次のテンプレートファイルをコピーして利用してください。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxaddserverref.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxaddserverref.xml

なお，論理サーバ参照定義ファイルは，旧バージョンとの互換用のファイルです。構築済みのシステムに論理ユーザサーバを追加する場合だけに使用します。07-50以降は，論理ユーザサーバを設定する場合は，簡易構築定義ファイルで設定することをお勧めします。

(4)　設定できる要素

論理サーバ参照定義ファイルには，追加する論理サーバ名，追加先のWebシステムおよびサービスユニットを定義します。Webシステム，サービスユニット，および論理サーバは，必要な数だけ定義します。

論理サーバ参照定義ファイルの構造を次に示します。<server-reference>タグおよび<web-system>タグは，このままの形式で指定します。

論理サーバ参照定義ファイルの構造

<server-reference xmlns="http://www.cosminexus.com/mngsvr/schema/ServerReference-2.0">
 <!-- Webシステムの定義 -->
 <web-system>
   <!-- Webシステムの属性定義 -->
   <name>Webシステム名</name>

   <!-- サービスユニットの定義 -->
   <unit>
     <name>サービスユニット名1</name>
     <logical-server-ref>論理ユーザサーバ名1</logical-server-ref>
       ：
     <logical-server-ref>論理ユーザサーバ名n</logical-server-ref>
   </unit>
   <unit>
     ：
 </web-system>
 <web-system>
   ：
</server-reference>

各タグの説明とデフォルト値を次に示します。

タグ名称
内容
デフォルト値

web-system
Webシステムを定義します。
複数のWebシステムを定義する場合は，<web-system>タグを複数指定します。
なし

name
Webシステムを識別するための名称を32文字以下で指定します。ドメイン内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-sオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
なし

unit
サービスユニットを定義します。
複数のサービスユニットを定義する場合は，<unit>タグを複数指定します。
なし

name
サービスユニットを識別するための名称を32文字以下で指定します。Webシステム内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-unitオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
なし

logical-server-ref
サービスユニットに追加する論理ユーザサーバの名称を128文字以下で指定します。
論理ユーザサーバ定義ファイルの<logical-server-name>タグで指定した名称を指定します。mngsvrutil add userserverコマンドで追加済みの論理ユーザサーバを指定してください。
複数の論理ユーザサーバを定義する場合は，<logical-server-ref>タグを複数指定します。
なし

(5)　記述例

サービスユニットunit1に論理ユーザサーバusersv1およびusersv2を，サービスユニットunit2に論理ユーザサーバusersv3およびusersv4を追加する例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<server-reference xmlns="http://www.cosminexus.com/mngsvr/schema/ServerReference-2.0">
 <web-system>
   <name>MyWebSystem</name>
   <unit>
     <name>unit1</name>
     <logical-server-ref>usersv1</logical-server-ref>
     <logical-server-ref>usersv2</logical-server-ref>
   </unit>
   <unit>
     <name>unit2</name>
     <logical-server-ref>usersv3</logical-server-ref>
     <logical-server-ref>usersv4</logical-server-ref>
   </unit>
 </web-system>
</server-reference>

13.10　スケールアウト用ホスト定義ファイル

＜この節の構成＞

(1)　形式

(2)　ファイルの格納先

(3)　機能

(4)　設定できる要素

(5)　記述例

(1)　形式

XML形式です。

(2)　ファイルの格納先

任意の作業場所に格納してください。

(3)　機能

Smart Composer機能のコマンドで構築した，ホスト単位管理モデルのWebシステムをスケールアウトする場合に使用する定義ファイルです。複製先のホストの，Webシステムの情報を定義します。

次のテンプレートファイルをコピーして利用してください。

Windowsの場合
<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥cmxscaleouthostdef.xml

UNIXの場合
/opt/Cosminexus/manager/config/templates/cmxscaleouthostdef.xml

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。

(4)　設定できる要素

スケールアウト用ホスト定義ファイルには，追加するホスト，および複製先のWebシステムで使用する負荷分散機を定義します。

スケールアウト用ホスト定義ファイルの構造を次に示します。<host-scaleout>タグおよび<web-system>タグは，このままの形式で指定します。

スケールアウト用ホスト定義ファイルの構造

<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.5">
 <!-- 複製先のWebシステムの定義 -->
 <web-system>
   <!-- Webシステムの属性定義 -->
   <name>Webシステム名</name>

   <!-- 複製先のWebシステムで使用する負荷分散機の定義 -->
   <load-balancer>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <server-id-rule>最小値-最大値</server-id-rule>
     </cookie-switching>
   </load-balancer>
 </web-system>

 <!-- 複製先のホストの定義 -->
 <host>
   <host-name>ホスト名またはIPアドレス</host-name>
   <display-name>ホストの表示名</display-name>
   <description>ホストのコメント</description>
   <agent-host>Cosminexus運用管理エージェントのホスト名またはIPアドレス</agent-host>
 </host>
</host-scaleout>

各タグの説明とデフォルト値を次に示します。

タグ名称
内容
デフォルト値

web-system※1
複製先のWebシステムを定義します。
複製先のWebシステムの定義を変更する場合に指定します。複数のWebシステムを定義する場合は，<web-system>タグを複数指定します。
なし

name※1
設定を変更する複製先のWebシステムの名称を指定します。
なし

load-balancer※1※2
複製先のWebシステムで使用する負荷分散機を定義します。
なし

cookie-switching※1※2
cookieスイッチング機能の設定を変更します。
なし

server-id-rule※1※2
負荷分散機でリクエスト振り分け先（サービスユニットのWebサーバ）を識別するサーバIDの割り当てルールを，<最小値>-<最大値>の形式で指定します。
すべてのサービスユニットで一意となるサーバIDを割り当てられる範囲を指定します。
また，スケールアウトするホスト間で設定範囲が重ならないように指定してください。

BIG-IP 1500またはBIG-IP 1000の場合
1000～9999の範囲で指定します。
指定例：1024-2048

Loadflowbalの場合
0～1023の範囲で指定します。
指定例：0-1023

なお，範囲外の値が指定された場合，次のようになります。

BIG-IP 1500またはBIG-IP 1000の場合
業務リクエストが正しく振り分けされません。

Laodflowbalの場合
CLIコマンド実行時にエラーが発生します。

なし

host※3
複製先のホストを定義します。
ホストは複数のWebシステムで共有できます。
なし

host-name
運用用のホスト名またはIPアドレスを指定します。ホスト名を指定する場合は，32文字以下で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。IPアドレスを指定する場合は，ドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
なし

display-name
ホストの表示名を128文字以下で指定します。指定する文字に制限はありません。
なし

description
ホストのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
なし

agent-host
Cosminexus運用管理エージェントのホスト名，またはIPアドレスを指定します。ホスト名を指定する場合は，32文字以下で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。IPアドレスを指定する場合は，ドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
<host-name>タグに指定した値

注※1

複製先のWebシステムの定義は，複製元のWebシステムで負荷分散機のCookieスイッチング機能を使用していない場合は省略できます。

注※2

バッチアプリケーションを実行するシステムでは負荷分散機の定義は不要です。

注※3

ホストの定義を省略した場合は，複製先のホストのホスト名が<host-name>タグに仮定され，ホストが定義されます。

(5)　記述例

複製元のホストと複製先のホストの設定項目例を次に示します。

表13-3　複製元のホストと複製先のホストの設定項目例

設定項目 | 複製元のホスト | 複製先のホスト
Webシステム名 | MyWebSystem | MyWebSystem
サーバIDの割り当てルール | 1001-1010 | 1011-1020
ホスト名 | apsvA | apsvA
IPアドレス | 192.168.1.20 | 192.168.1.21
管理IPアドレス | 192.168.100.20 | 192.168.100.21

ホストapsvAを複製して作成したディスクイメージを使用してスケールアウトする例を次に示します。この例は，J2EEアプリケーションを実行するシステムをスケールアウトする場合の記述例です。

<?xml version="1.0" encoding="UTF-8"?>
<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.1">
 <!-- 複製先のWebシステムの定義 -->
 <web-system>
   <name>MyWebSystem</name>
   <!-- 複製先のWebシステムで使用する負荷分散機の定義 -->
   <load-balancer>
     <!-- cookieスイッチングの定義 -->
     <cookie-switching>
       <server-id-rule>1011-1020</server-id-rule>
     </cookie-switching>
   </load-balancer>
 </web-system>
 <!-- 複製先のホストの定義 -->
 <host>
   <host-name>apsvA</host-name>
   <agent-host>192.168.100.21</agent-host>
 </host>
</host-scaleout>

14.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ

この章では，簡易構築定義ファイルおよび構成変更定義ファイルで指定できるタグと，各論理サーバのコンフィグレーション（<configuration>タグの定義）で指定できるパラメタについて説明します。

＜この章の構成＞

14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ

14.2　システムの構成パターンと定義する論理サーバ

14.3　各論理サーバ共通で指定できるパラメタ

14.4　論理Webサーバで指定できるパラメタ

14.5　論理J2EEサーバで指定できるパラメタ

14.6　論理パフォーマンストレーサで指定できるパラメタ

14.7　論理SFOサーバで指定できるパラメタ

14.8　論理CTMドメインマネジャで指定できるパラメタ

14.9　論理CTMで指定できるパラメタ

14.10　論理スマートエージェントで指定できるパラメタ

14.11　論理ユーザサーバで指定できるパラメタ

14.12　論理ネーミングサービスで指定できるパラメタ

14.1　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ

簡易構築定義ファイル，論理サーバのパラメタ変更用の構成定義変更ファイル，およびサービスユニット・ホスト追加用の構成変更定義ファイルで指定できるタグについて説明します。

J2EEアプリケーションを実行するシステムで使用するタグ，およびバッチアプリケーションを実行するシステムで使用するタグについて，システムごとに説明します。

なお，簡易構築定義ファイルの構造については「13.7　簡易構築定義ファイル」を，構成定義変更ファイルの構造については「13.8　構成変更定義ファイル」を参照してください。

＜この節の構成＞

14.1.1　J2EEアプリケーションを実行するシステムで指定できるタグ

14.1.2　バッチアプリケーションを実行するシステムで指定できるタグ

14.1.1　J2EEアプリケーションを実行するシステムで指定できるタグ

ここでは，J2EEアプリケーションを実行するシステムで指定できるタグについて説明します。

＜この項の構成＞

(1)　Webシステムの属性定義

(2)　負荷分散機の定義

(3)　物理ティアの定義

(4)　サービスユニットの定義

(5)　ホストの定義

(1)　Webシステムの属性定義

Webシステムの属性として定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

web-system
Webシステムを定義します。
複数のWebシステムを定義する場合は，<web-system>タグを複数指定します。
△※1
△
△※2
なし

name
Webシステムを識別するための名称を32文字以下で指定します。運用管理ドメイン内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-sオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
◎
◎
◎
なし

addition-mode
追加モードを指定します。

DEPLOYED※3
JP1/SC/DPMを使用してディスクイメージのスケールアウトをする場合に指定します。この指定によって，システム構築時のJ2EEアプリケーションおよびリソースアダプタでのデプロイが不要になります。

NORMAL
通常のスケールアウトの場合に指定します。

－
－
△
NORMAL

display-name
Webシステムの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
－
なし

description
Webシステムのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
－
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注※1

Smart Composer機能で定義済みのWebシステムを利用する場合は省略できます。

注※2

サービスユニットを追加しない場合は省略できます。

注※3

この設定を有効にする場合，Smart Composer機能のコマンドを使用したインポートと一括開始をしておく必要があります。詳細については「6.11.2(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始」および「6.11.3　J2EEアプリケーションのインポートと開始」を参照してください。

(2)　負荷分散機の定義

負荷分散機の定義は，<load-balancer>以下のタグで定義します。定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

load-balancer
負荷分散機を定義します。
Smart Composer機能で負荷分散機の設定，および実サーバポートの開始・閉塞をしない場合は，負荷分散機の定義（<load-balancer>タグから</load-balancer>タグまで）は必要ありません。
△
－
－
なし

name
負荷分散機の名称を32文字以下で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
△
－
－
なし

load-balancer-type
負荷分散機の種類を指定します。次のどれかを指定します。

BIG-IPv9
BIG-IP 1500を使用する場合に指定します。

BIG-IP
BIG-IP 1000を使用する場合に指定します。

Loadflowbal
Loadflowbalを使用する場合に指定します。

Smart Composer機能で負荷分散機の設定をする場合は，必ず指定してください。
◎
－
－
なし

display-name
負荷分散機の表示名を128文字以下で指定します。指定する文字に制限はありません。
△
－
－
なし

description
負荷分散機のコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
－
－
なし

cookie-switching
cookieスイッチング機能を使用する場合に定義します。
この設定によって，一連のHTTPリクエストが一つのWebサーバまたはJ2EEサーバで処理されます。
△※
－
－
なし

cookie-switching-enabled
cookieスイッチング機能を使用する場合はtrueを，使用しない場合はfalseを指定します。
△
－
－
false

cookie-name
cookieの名称を1～64文字の文字列で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア）の組み合わせです。ただし，次の名前はWebコンテナが使用するため，大文字・小文字の区別なく使用できません。

JSESSIONID

△
－
－
CMX_SERVER_ID

server-id-rule
負荷分散機でリクエスト振り分け先（サービスユニットのWebサーバ）を識別するサーバIDの割り当てルールを，<最小値>-<最大値>の形式で指定します。
すべてのサービスユニットで一意となるサーバIDを割り当てられる範囲を指定します。

BIG-IP 1500またはBIG-IP 1000の場合
1000～9999の範囲で指定します。
指定例：1024-2048

Loadflowbalの場合
0～1023の範囲で指定します。
指定例：0-1023

なお，範囲外の値が指定された場合，次のようになります。

BIG-IP 1500またはBIG-IP 1000の場合
業務リクエストが正しく振り分けされません。

Laodflowbalの場合
CLIコマンド実行時にエラーが発生します。

△
－
－
なし

management-host
負荷分散機に設定した管理IPアドレスまたはホスト名を指定します。管理IPアドレスはドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。ホスト名に指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムで同じ管理IPアドレスまたはホスト名を指定してください。
◎
－
－
なし

redundant-management-host
負荷分散機を冗長化したシステムの場合に，2台目の負荷分散機に設定した管理IPアドレスまたはホスト名を指定します。管理IPアドレスはドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。ホスト名に指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムで同じ管理IPアドレスまたはホスト名を指定してください。
△
－
－
なし

virtual-server
仮想サーバを定義します。
◎
－
－
なし

virtual-server-name
仮想サーバ名を1～31文字で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン），.（ピリオド）の組み合わせです。
複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムで仮想サーバ名が重複しないように指定してください。
◎
－
－
なし

display-name
仮想サーバの表示名を指定します。
△
－
－
なし

description
仮想サーバのコメントを指定します。
△
－
－
なし

ip-address
仮想サーバのIPアドレスを指定します。
複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムで仮想サーバのIPアドレスが重複しないように指定してください。
◎
－
－
なし

http-port
仮想サーバのhttpポート番号を1～65535の間で指定します。
BIG-IP 1500またはBIG-IP 1000の場合で，複数のWebシステムで負荷分散機を共有するときは，共有するWebシステムで仮想サーバのhttpポート番号が重複しないように指定してください。
◎
－
－
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：負荷分散機を定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注※

負荷分散機のCookieスイッチング機能を使用しない場合は省略できます。

(3)　物理ティアの定義

構築するシステムの構成に合わせて，物理ティアを定義します。物理ティアは<tier>以下のタグで定義します。定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

tier
物理ティアを定義します。
物理ティアには，combined-tier，http-tier，j2ee-tier，sfo-tier，ctm-tier，およびfree-tierの6種類があります。それぞれの物理ティアは，単独，または複数を組み合わせて，Webシステムを構成します。
指定できる物理ティアの構成を次に示します。

combined-tier構成

http-tierとj2ee-tierの構成

j2ee-tier構成

combined-tierにsfo-tierを組み合わせた構成

http-tierとj2ee-tierにsfo-tierを組み合わせた構成

ctm-tier構成

free-tier構成

combined-tier構成の場合

サービスユニット内のWebサーバとJ2EEサーバを1ホストで構成し，一つの<tier>タグで定義します。

http-tierとj2ee-tierの構成の場合

サービスユニット内のWebサーバとJ2EEサーバを別々のホストで構成し，二つの<tier>タグで定義します。

j2ee-tierの構成の場合

サービスユニット内のJ2EEサーバを1ホストで構成し，一つの<tier>タグで定義します。j2ee-tier構成を使用する場合は，インプロセスHTTPサーバ機能を有効に設定しておく必要があります。

combined-tierまたはhttp-tierとj2ee-tierに組み合わせて構成するsfo-tierの場合

サービスユニット内のセッションフェイルオーバサーバ（SFOサーバ）を1ホストで構成し，一つの<tier>タグで定義します。

ctm-tier構成の場合

ctm-tierは，combined-tier，http-tier，j2ee-tier，sfo-tierを定義するWebシステムとは別のWebシステムで定義します。ctm-tierは，統合ネーミングスケジューラサーバ用およびCTM用のWebシステムに分けて，それぞれ定義します。

統合ネーミングスケジューラサーバ用のWebシステム
サービスユニット内のCTM関連の論理サーバ※1を1ホストで構成し，一つの<tier>タグで定義します。

CTM用のWebシステム
サービスユニット内のCTM関連の論理サーバ※1とJ2EEサーバを1ホストで構成し，一つの<tier>タグで定義します。

free-tier構成の場合

ほかのどの物理ティアの定義にも当てはまらない構成が，一つの<tier>タグで定義されます。

◎
△※2
－
なし

tier-type
物理ティアの種類を次のどれかで指定します。

combined-tier

http-tier

j2ee-tier

sfo-tier

ctm-tier

free-tier

◎
◎
－
なし

j2ee-server-count
<tier-type>タグでctm-tierを指定した場合に，1ホストに配置するJ2EEサーバの数を0～32の整数で指定します。

統合ネーミングスケジューラサーバ用のWebシステムの場合
0を指定します。

CTM用のWebシステムの場合
Webシステムごとに，1ホスト内に配置するJ2EEサーバの数を指定します。

なお，Webシステムの構成変更時，J2EEサーバの数は変更できません。
△
－
－
1

configuration
物理ティアに属するすべての論理サーバに適用するコンフィグレーションを，論理サーバの種類ごとに定義します。例えば，WebサーバとJ2EEサーバの二つのコンフィグレーションを定義する場合は，<configuration>タグを二つ定義し，一つをWebサーバ用，もう一つをJ2EEサーバ用として定義します。
△※3
◎※4
－
なし

logical-server-type
コンフィグレーションを定義する論理サーバの種類を指定します。指定できる論理サーバの種類を次に示します。

web-server：Webサーバ

j2ee-server：J2EEサーバ

sfo-server：セッションフェイルオーバサーバ（SFOサーバ）

performance-tracer：パフォーマンストレーサ

ctm-domain-manager：CTMドメインマネジャ

component-transaction-monitor：CTM

smart-agent：スマートエージェント

物理ティアの種類によって，コンフィグレーションが定義できる論理サーバが異なります。

combined-tierの場合

Webサーバ，J2EEサーバとパフォーマンストレーサ

http-tierの場合

Webサーバとパフォーマンストレーサ

j2ee-tierの場合

J2EEサーバとパフォーマンストレーサ

sfo-tierの場合

セッションフェイルオーバサーバ（SFOサーバ）とパフォーマンストレーサ

ctm-tierの場合

Webシステムごとに定義できる論理サーバが異なります。

統合ネーミングスケジューラサーバ用のWebシステムの場合
CTMドメインマネジャ，CTM，スマートエージェントとパフォーマンストレーサ

CTM用のWebシステムの場合
CTMドメインマネジャ，CTM，スマートエージェント，J2EEサーバとパフォーマンストレーサ

◎
◎
－
なし

server-no
物理ティア内の特定のJ2EEサーバで，共通のコンフィグレーションを指定する場合に，J2EEサーバを識別するための番号を指定します。指定できる範囲は，1～<j2ee-server-count>の指定値です。物理ティア内で番号が重複しないように指定してください。このタグは，<tier-type>タグでctm-tierを指定して，<j2ee-server-count>タグを指定した場合にだけ指定できます。
物理ティア内のすべてのJ2EEサーバで，共通のコンフィグレーションを指定する場合は，このタグを指定する必要はありません。
△
△
－
なし

param※5
論理サーバの環境を設定するパラメタを，パラメタ名と値で定義します。1種類のパラメタごとに<param>タグで囲んで定義します。
◎
◎
－
なし

param-name※5
論理サーバの環境を設定するパラメタの名称を指定します。
◎
◎
－
なし

param-value※5
<param-name>タグで指定したパラメタへの設定値を指定します。パラメタによっては，複数の値を設定する場合，<param-valueタグ>を複数指定します。
◎
△※6
－
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

物理ティアの定義では，ユーザサーバ，およびfree-tier構成に含まれる論理サーバのコンフィグレーションが設定できません。これらの論理サーバのコンフィグレーションはユニットの定義で設定してください。

注※1

CTM関連の論理サーバには，CTMドメインマネジャ，CTMおよびスマートエージェントがあります。

注※2

物理ティアの定義を変更しない場合は省略できます。

注※3

Management Serverが論理サーバ作成時に仮定する，環境設定値で運用する場合は省略できます。

注※4

cmx_trans_paramコマンドを使用して，抽象パラメタを展開して物理ティアのコンフィグレーションを生成する場合は省略できます。

注※5

<param>タグに指定できるパラメタは論理サーバの種類によって異なります。また，定義する論理サーバはシステムの構成パターンによって異なります。「14.2　システムの構成パターンと定義する論理サーバ」を参照して，定義する論理サーバを確認してください。それぞれの論理サーバに設定できるパラメタについては，使用する論理サーバの種類に応じて14.3以降の節を参照してください。

注※6

<param-name>タグで指定したパラメタを削除する場合は省略できます。

(4)　サービスユニットの定義

サービスユニットは<unit>以下のタグに定義します。定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

unit
サービスユニットを定義します。
複数のサービスユニットを定義する場合は，<unit>タグを複数指定します。
◎
△※1
◎
なし

name
サービスユニットを識別するための名称を32文字以下で指定します。Webシステム内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-unitオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
◎
△※2
◎
なし

display-name
サービスユニットの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

description
サービスユニットのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

allocated-host
サービスユニットを構成するホストのリファレンスを定義します。<allocated-host>タグは一つだけ指定します。free-tier構成のWebシステムでは，<allocated-host>タグを複数指定できます。
◎
◎
◎
なし

host-ref
ホスト定義の<name>タグに指定したホスト名，構築済みのWebシステムで定義されているホスト名，または@myhostを指定します。
@myhostを指定していると，システム構築時に，ホストの定義の<host-name>タグの値が自動で設定されます。
なお，複数ホストがある場合，一つのサービスユニット内で同じホストを共有することはできません。
◎
◎
◎
なし

hosts-for
<host-ref>タグで指定したホストが属する物理ティアの種類を，次のどれかで指定します。

combined-tier

http-tier

j2ee-tier

sfo-tier

ctm-tier

free-tier

◎
◎
◎
なし

define-server
<hosts-for>タグで指定した物理ティアに属する論理サーバごとに，コンフィグレーションを定義します。例えば，<hosts-for>タグがhttp-tierの場合は，Webサーバ用と，パフォーマンストレーサ用にそれぞれ一つずつ論理サーバを定義できます。複数の論理サーバを定義する場合は，<define-server>タグを複数指定します。
△※3
◎
△※3
なし

logical-server-name
論理サーバまたはクラスタを識別するための名称を128文字以下で指定します。Smart Composer機能のコマンドの-sオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
△
－
△
cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

display-name
論理サーバの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

description
論理サーバのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

logical-server-type
コンフィグレーションを定義する論理サーバの種類を指定します。指定できる論理サーバの種類を次に示します。

web-server：Webサーバ

j2ee-server：J2EEサーバ

sfo-server：セッションフェイルオーバサーバ（SFOサーバ）

performance-tracer：パフォーマンストレーサ

ctm-domain-manager：CTMドメインマネジャ

component-transaction-monitor：CTM

smart-agent：スマートエージェント

naming-service：ネーミングサービス

user-server：ユーザサーバ

ホストが属する物理ティアの種類によって，コンフィグレーションが定義できる論理サーバが異なります。

combined-tierの場合

Webサーバ，J2EEサーバ，パフォーマンストレーサとユーザサーバ

http-tierの場合

Webサーバ，パフォーマンストレーサとユーザサーバ

j2ee-tierの場合

J2EEサーバ，パフォーマンストレーサとユーザサーバ

sfo-tierの場合

セッションフェイルオーバサーバ（SFOサーバ），パフォーマンストレーサとユーザサーバ

ctm-tierの場合

Webシステムごとに定義できる論理サーバが異なります。

統合ネーミングスケジューラサーバ用のWebシステムの場合
CTMドメインマネジャ，CTM，スマートエージェント，パフォーマンストレーサとユーザサーバ

CTM用のWebシステムの場合
CTMドメインマネジャ，CTM，スマートエージェント，J2EEサーバ，パフォーマンストレーサとユーザサーバ

free-tierの場合

Webサーバ，J2EEサーバ，セッションフェイルオーバサーバ（SFOサーバ），CTMドメインマネジャ，CTM，スマートエージェント，ネーミングサービス，パフォーマンストレーサ，Webサーバクラスタ，J2EEサーバクラスタとユーザサーバ

◎
◎
◎
なし

cluster-ref
論理サーバをクラスタのメンバにする場合に，クラスタ名を指定します。
クラスタのメンバにする論理サーバがJ2EEサーバの場合はJ2EEサーバクラスタ名を，Webサーバの場合はWebサーバクラスタ名を指定します。
J2EEサーバおよびWebサーバ以外の論理サーバは，クラスタのメンバとして設定できません。
free-tier構成の場合だけに定義されます。
△
×
×
なし

server-no
サービスユニット内の特定のJ2EEサーバのコンフィグレーションを指定する場合に，J2EEサーバを識別するための番号を指定します。指定できる範囲は，1～<j2ee-server-count>の指定値です。1ホスト内で番号が重複しないように指定してください。このタグは，物理ティアの定義で<j2ee-server-count>タグを指定した場合に，J2EEサーバのコンフィグレーションを指定するときは，必ず指定してください。
△
△
△
なし

configuration
論理サーバごとに適用するコンフィグレーションを定義します。
なお，物理ティアの定義で定義した環境設定値で運用する場合は，<configuration>タグの定義は不要です。
<logical-server-type>でJ2EEサーバクラスタまたはWebサーバクラスタを指定していた場合は指定できません。
△
△
△
なし

param※4
論理サーバの環境を設定するパラメタを，パラメタ名と値で定義します。1種類のパラメタごとに<param>タグで囲んで定義します。
◎
◎
◎
なし

param-name※4
論理サーバの環境を設定するパラメタの名称を指定します。指定できるパラメタ名については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。
◎
◎
◎
なし

param-value※4
<param-name>タグで指定したパラメタへの設定値を指定します。パラメタによっては，複数の値を設定する場合，<param-value>タグを複数指定します。それぞれのパラメタの設定値については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。
◎
△※5
◎
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

構成変更定義ファイルには，free-tier構成に含まれる論理サーバのコンフィグレーションが設定できません。

注※1

サービスユニットの定義を変更しない場合は省略できます。

注※2

クライアント設定プロパティファイルまたはクライアント共通設定プロパティファイルにcmx.websystem.nameを指定している場合は省略できます。

注※3

論理サーバごとにコンフィグレーションを定義しない場合は省略できます。

注※4

<param>タグに指定できるパラメタは論理サーバの種類によって異なります。また，定義する論理サーバはシステムの構成パターンによって異なります。「14.2　システムの構成パターンと定義する論理サーバ」を参照して，定義する論理サーバを確認してください。それぞれの論理サーバに設定できるパラメタについては，使用する論理サーバの種類に応じて14.3以降の節を参照してください。

注※5

<param-name>タグで指定したパラメタを削除する場合は省略できます。

(5)　ホストの定義

使用するホストの情報は<host>以下のタグに定義します。定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

host
ホストを定義します。
複数のホストを定義する場合は，hostタグを複数指定します。ホストは複数のWebシステムで共有できます。
△※1
－
△※2
なし

host-name
ホストを識別するための名称またはIPアドレスを32文字以下で指定します。
ホスト名に指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。管理IPアドレスはドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
IPアドレス変換できないホスト名を指定した場合，システム構築時にエラーとなります。
<host-name>タグには@myhostも指定できます。@myhostを指定すると，システム構築時に，構築先の環境の運用管理サーバマシンのホスト名に自動で置換されます。
◎
－
◎
なし

display-name
ホストの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
－
△
なし

description
ホストのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
－
△
なし

agent-host
Cosminexus運用管理エージェントのホスト名，またはIPアドレスを指定します。ホスト名を指定する場合は，32文字以下で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。IPアドレスを指定する場合は，ドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
<agent-host>タグには@myhostも指定できます。@myhostを指定していると，システム構築時に，ホストの定義の<host-name>タグの値が自動で設定されます。
△
－
△
host-nameで指定した値

agent-port
Cosminexus運用管理エージェントのポート番号を1～65535の間で指定します。
△
－
△
20295

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：ホストを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

ユニットの定義の<host-ref>タグで@myhostを指定して，ホストの定義の<display-name>タグ，<description>タグ，<agent-host>タグ，または<agent-port>タグの値を省略している場合，ホストの定義は出力されません。この場合，ホストの定義の<host-name>タグの値は，Management Serverが必要に応じて自動生成します。Management Serverが自動作成するホスト名は，Windowsの場合はコンピュータ名，UNIXの場合は，hostnameコマンドで設定したホスト名です。ホストの中に論理サーバが一つも含まれなくなったとき，Management Serverが，そのホストを自動で削除します。

注※1

Smart Composer機能で定義済みのホストを利用する場合は省略できます。

注※2

ホストの定義を変更しない場合は省略できます。

14.1.2　バッチアプリケーションを実行するシステムで指定できるタグ

ここでは，バッチアプリケーションを実行するシステムで指定できるタグについて説明します。

＜この項の構成＞

(1)　Webシステムの属性定義

(2)　物理ティアの定義

(3)　サービスユニットの定義

(4)　ホストの定義

(1)　Webシステムの属性定義

Webシステムの属性として定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

web-system
Webシステムを定義します。
複数のWebシステムを定義する場合は，<web-system>タグを複数指定します。
△※1
△
△※2
なし

name
Webシステムを識別するための名称を32文字以下で指定します。運用管理ドメイン内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-sオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
◎
◎
◎
なし

addition-mode
追加モードを指定します。

DEPLOYED※3
JP1/SC/DPMを使用してディスクイメージのスケールアウトをする場合に指定します。この指定によって，システム構築時のリソースアダプタでのデプロイが不要になります。

NORMAL
通常のスケールアウトの場合に指定します。

－
－
△
NORMAL

display-name
Webシステムの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
－
なし

description
Webシステムのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
－
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注※1

Smart Composer機能で定義済みのWebシステムを利用する場合は省略できます。

注※2

サービスユニットを追加しない場合は省略できます。

注※3

この設定を有効にする場合，Smart Composer機能のコマンドを使用したインポートと一括開始をしておく必要があります。詳細については「6.11.2(3)　Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始」を参照してください。

(2)　物理ティアの定義

物理ティアを<tier>以下のタグで定義します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

tier
物理ティアを定義します。
バッチアプリケーションを実行するシステムでは物理ティアにj2ee-tierを指定してください。j2ee-tierは，一つの<tier>タグで定義します。
◎
△※1
－
なし

tier-type
物理ティアの種類を指定します。バッチアプリケーションを実行するシステムでは，j2ee-tierを指定します。
◎
◎
－
なし

configuration
物理ティアに属するすべての論理サーバに適用するコンフィグレーションを，論理サーバの種類ごとに定義します。
△※2
◎※3
－
なし

logical-server-type
コンフィグレーションを定義する論理サーバの種類を指定します。バッチアプリケーションを実行するシステムではバッチサーバを論理J2EEサーバとして定義します。タグに指定できる論理サーバの種類を次に示します。

j2ee-server：J2EEサーバ

performance-tracer：パフォーマンストレーサ

◎
◎
－
なし

param※4
論理サーバの環境を設定するパラメタを，パラメタ名と値で定義します。1種類のパラメタごとに<param>タグで囲んで定義します。
◎
◎
－
なし

param-name※4
論理サーバの環境を設定するパラメタの名称を指定します。
◎
◎
－
なし

param-value※4
<param-name>タグで指定したパラメタへの設定値を指定します。パラメタによっては，複数の値を設定する場合，<param-valueタグ>を複数指定します。
◎
△※5
－
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

物理ティアの定義では，ユーザサーバ，およびfree-tier構成に含まれる論理サーバのコンフィグレーションが設定できません。これらの論理サーバのコンフィグレーションはユニットの定義で設定してください。

注※1

物理ティアの定義を変更しない場合は省略できます。

注※2

Management Serverが論理サーバ作成時に仮定する，環境設定値で運用する場合は省略できます。

注※3

cmx_trans_paramコマンドを使用して，抽象パラメタを展開して物理ティアのコンフィグレーションを生成する場合は省略できます。

注※4

<param>タグに指定できるパラメタは論理サーバの種類によって異なります。また，定義する論理サーバはシステムの構成パターンによって異なります。「14.2　システムの構成パターンと定義する論理サーバ」を参照して，定義する論理サーバを確認してください。それぞれの論理サーバに設定できるパラメタについては，使用する論理サーバの種類に応じて14.3以降の節を参照してください。

注※5

<param-name>タグで指定したパラメタを削除する場合は省略できます。

(3)　サービスユニットの定義

サービスユニットは<unit>以下のタグに定義します。定義できる内容を次の表に示します。

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

unit
サービスユニットを定義します。
複数のサービスユニットを定義する場合は，<unit>タグを複数指定します。
◎
△※1
◎
なし

name
サービスユニットを識別するための名称を32文字以下で指定します。Webシステム内でユニークな名称を指定する必要があります。Smart Composer機能のコマンドの-unitオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
◎
△※2
◎
なし

display-name
サービスユニットの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

description
サービスユニットのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

allocated-host
サービスユニットを構成するホストのリファレンスを定義します。<allocated-host>タグは一つだけ指定します。
◎
◎
◎
なし

host-ref
ホスト定義の<name>タグに指定したホスト名，構築済みのWebシステムで定義されているホスト名，または@myhostを指定します。
@myhostを指定していると，システム構築時に，ホストの定義の<host-name>タグの値が自動で設定されます。
なお，複数ホストがある場合，一つのサービスユニット内で同じホストを共有することはできません。
◎
◎
◎
なし

hosts-for
<host-ref>タグで指定したホストが属する物理ティアの種類を指定します。バッチアプリケーションを実行するシステムではj2ee-tierを指定します。
◎
◎
◎
なし

define-server
<hosts-for>タグで指定した物理ティアに属する論理サーバごとに，コンフィグレーションを定義します。<hosts-for>タグがj2ee-tierの場合は，バッチサーバ用と，パフォーマンストレーサ用にそれぞれ一つずつ論理サーバを定義できます。複数の論理サーバを定義する場合は，<define-server>タグを複数指定します。
△※3
◎
△※3
なし

logical-server-name
論理サーバまたはクラスタを識別するための名称を128文字以下で指定します。Smart Composer機能のコマンドの-sオプションには，ここで指定した名称を指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。
△
－
△
cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

display-name
論理サーバの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

description
論理サーバのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
△
△
なし

logical-server-type
コンフィグレーションを定義する論理サーバの種類を指定します。バッチアプリケーションを実行するシステムでは，バッチサーバを論理J2EEサーバとして定義します。タグに指定できる論理サーバの種類を次に示します。

j2ee-server：J2EEサーバ

performance-tracer：パフォーマンストレーサ

user-server：ユーザサーバ

◎
◎
◎
なし

configuration
論理サーバごとに適用するコンフィグレーションを定義します。
なお，物理ティアの定義で定義した環境設定値で運用する場合は，<configuration>タグの定義は不要です。
△
△
△
なし

param※4
論理サーバの環境を設定するパラメタを，パラメタ名と値で定義します。1種類のパラメタごとに<param>タグで囲んで定義します。
◎
◎
◎
なし

param-name※4
論理サーバの環境を設定するパラメタの名称を指定します。指定できるパラメタ名については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。
◎
◎
◎
なし

param-value※4
<param-name>タグで指定したパラメタへの設定値を指定します。パラメタによっては，複数の値を設定する場合，<param-value>タグを複数指定します。それぞれのパラメタの設定値については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。
◎
△※5
◎
なし

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：Webシステムを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

構成変更定義ファイルには，free-tier構成に含まれる論理サーバのコンフィグレーションが設定できません。

注※1

サービスユニットの定義を変更しない場合は省略できます。

注※2

クライアント設定プロパティファイルまたはクライアント共通設定プロパティファイルにcmx.websystem.nameを指定している場合は省略できます。

注※3

論理サーバごとにコンフィグレーションを定義しない場合は省略できます。

注※4

<param>タグに指定できるパラメタは論理サーバの種類によって異なります。また，定義する論理サーバはシステムの構成パターンによって異なります。「14.2　システムの構成パターンと定義する論理サーバ」を参照して，定義する論理サーバを確認してください。それぞれの論理サーバに設定できるパラメタについては，使用する論理サーバの種類に応じて14.3以降の節を参照してください。

注※5

<param-name>タグで指定したパラメタを削除する場合は省略できます。

(4)　ホストの定義

タグ名称
内容
簡易構築定義ファイル
構成定義変更ファイル
デフォルト値

P
U

host
ホストを定義します。
複数のホストを定義する場合は，hostタグを複数指定します。ホストは複数のWebシステムで共有できます。
△※1
－
△※2
なし

host-name
ホストを識別するための名称またはIPアドレスを32文字以下で指定します。
ホスト名に指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。管理IPアドレスはドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
IPアドレス変換できないホスト名を指定した場合，システム構築時にエラーとなります。
<host-name>タグには@myhostも指定できます。@myhostを指定すると，システム構築時に，構築先の環境の運用管理サーバマシンのホスト名に自動で置換されます。
◎
－
◎
なし

display-name
ホストの表示名を128文字以下で指定します。指定する文字に制限はありません。
△
－
△
なし

description
ホストのコメントを1,024文字以下で指定します。指定する文字に制限はありません。
△
－
△
なし

agent-host
Cosminexus運用管理エージェントのホスト名，またはIPアドレスを指定します。ホスト名を指定する場合は，32文字以下で指定します。指定できる文字は，半角文字のA～Z，a～z，0～9，_（アンダースコア），-（ハイフン）の組み合わせです。IPアドレスを指定する場合は，ドット記法（xxx.xxx.xxx.xxx）で指定します。xxxには0～255の整数を指定します。
<agent-host>タグには@myhostも指定できます。@myhostを指定していると，システム構築時に，ホストの定義の<host-name>タグの値が自動で設定されます。
△
－
△
host-nameで指定した値

agent-port
Cosminexus運用管理エージェントのポート番号を1～65535の間で指定します。
△
－
△
20295

（凡例）

P：論理サーバのパラメタ変更用の構成定義変更ファイルを示します。

U：サービスユニット・ホスト追加用の構成定義変更ファイルを示します。

◎：ホストを定義する場合は，必ず指定します。

△：省略できます。

－：該当しません。

注

ユニットの定義の<host-ref>タグで@myhostを指定して，ホストの定義の<display-name>タグ，<description>タグ，<agent-host>タグ，または<agent-port>タグの値を省略している場合，ホストの定義は出力されません。この場合，ホストの定義の<host-name>タグの値は，Management Serverが必要に応じて自動生成します。Management Serverが自動作成するホスト名は，Windowsの場合はコンピュータ名，UNIXの場合は，hostnameコマンドで設定したホスト名です。ホストの中に論理サーバが一つも含まれなくなったとき，Management Serverが，そのホストを自動で削除します。

注※1

Smart Composer機能で定義済みのホストを利用する場合は省略できます。

注※2

ホストの定義を変更しない場合は省略できます。

14.2　システムの構成パターンと定義する論理サーバ

構築するシステムの構成パターンによって，定義する論理サーバの種類が異なります。システムの構成パターンと定義する論理サーバの種類について，J2EEアプリケーションを実行するシステムの構築，およびバッチアプリケーションを実行するシステムの構築に分けて説明します。

＜この節の構成＞

14.2.1　J2EEアプリケーションを実行するシステムを構築する場合

14.2.2　バッチアプリケーションを実行するシステムを構築する場合

14.2.1　J2EEアプリケーションを実行するシステムを構築する場合

ここでは，J2EEアプリケーションを実行するシステムの構成パターンごとに，定義が必要な論理サーバを説明します。

また，論理サーバの動作をデフォルトの設定から変更したい場合は，論理サーバのパラメタを設定します。設定するパラメタは論理サーバの種類によって異なります。ここでは，論理サーバに指定できるパラメタの参照先も示します。

＜この項の構成＞

(1)　システムの構成パターンと定義する必要がある論理サーバ

(2)　論理サーバに指定できるパラメタの参照先

(1)　システムの構成パターンと定義する必要がある論理サーバ

J2EEアプリケーションを実行するシステムの構成パターンごとに，定義する必要がある論理サーバを次の表で説明します。

表14-1　システム構成パターンと定義する論理サーバ

項番
システム構成パターン
定義する論理サーバ

1
WebサーバとJ2EEサーバを同じサーバマシンに配置する構成
（4.3.1参照）※
物理ティアとしてcombined-tierを指定します。次の論理サーバを定義します。

論理Webサーバ

論理J2EEサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

2
WebサーバとJ2EEサーバを別のサーバマシンに配置する構成
（4.3.2参照）※
物理ティアとしてhttp-tierとj2ee-tierを指定します。それぞれ次の論理サーバを定義します。

Webサーバ（http-tier）

論理Webサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

J2EEサーバ（j2ee-tier）

論理J2EEサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

3
インプロセスHTTPサーバ機能を使用する構成
（4.3.3参照）
物理ティアとしてj2ee-tierを指定します。次の論理サーバを定義します。

論理J2EEサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

5
セッションフェイルオーバ機能を使用する構成
（4.3.5参照）
セッションフェイルオーバ機能を使用する構成の場合，SFOサーバを配置します。SFOサーバには，物理ティアとしてsfo-tierを指定します。次の論理サーバを定義します。

論理SFOサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

6
CTMを使用する構成
（4.3.6参照）
CTMを使用する構成の場合，統合ネーミングスケジューラサーバとJ2EEサーバを配置します。それぞれ次の論理サーバを定義します。

統合ネーミングスケジューラサーバ（ctm-tier）

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

論理パフォーマンストレーサ

論理ユーザサーバ

J2EEサーバ（ctm-tier）

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

論理J2EEサーバ

論理パフォーマンストレーサ

論理ユーザサーバ

注1　サーバマシン内に複数のサービスユニットを配置できます。複数のサービスユニットの配置はどの構成でもできます。ただし，CTMを使用する構成の場合，同じCTMドメインのサービスユニットは，1サーバマシン内に複数配置できません。

注2　論理ユーザサーバはどの構成にも配置できます。必要に応じて配置してください。論理ユーザサーバを使用する構成については，「4.3.8　論理ユーザサーバを使用する構成」を参照してください。

注※　負荷分散機を冗長化する構成もできます。

(2)　論理サーバに指定できるパラメタの参照先

簡易構築定義ファイルおよび構成変更定義ファイルの「物理ティアの定義」および「サービスユニットの定義」では，各論理サーバのコンフィグレーション（<configuration>タグの定義）を指定します。定義する論理サーバごとに，コンフィグレーションで指定できるパラメタが異なります。

論理サーバに指定できるパラメタの参照先を次に示します。

また，それぞれの論理サーバに共通で指定できるパラメタがあります。論理サーバ共通のパラメタについては，「14.3　各論理サーバ共通で指定できるパラメタ」を参照してください。

論理Webサーバ
「14.4　論理Webサーバで指定できるパラメタ」を参照してください。

論理J2EEサーバ
次の個所を参照してください。

「14.5.1　J2EEサーバ用ユーザプロパティを設定するパラメタ」

「14.5.2　J2EEサーバ用オプション定義を設定するパラメタ」

「14.5.3　J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ」

「14.5.4　J2EEサーバの拡張パラメタ」

「14.5.9　運用監視エージェントプロパティを設定するパラメタ」

「14.5.10　Managementイベント発行用プロパティを設定するパラメタ」

「14.5.11　JP1連携を設定するパラメタ」

「14.5.12　SecurityManagerの使用を設定するパラメタ」

論理パフォーマンストレーサ
「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

論理SFOサーバ
「14.7　論理SFOサーバで指定できるパラメタ」を参照してください。

論理CTMドメインマネジャ
「14.8　論理CTMドメインマネジャで指定できるパラメタ」を参照してください。

論理CTM
「14.9　論理CTMで指定できるパラメタ」を参照してください。

論理スマートエージェント
「14.10　論理スマートエージェントで指定できるパラメタ」を参照してください。

論理ユーザサーバ
「14.11　論理ユーザサーバで指定できるパラメタ」を参照してください。

なお，cmx_export_modelコマンドを使用して出力した簡易構築定義ファイルの物理ティアの種別がfree-tierの場合，論理ネーミングサービスが出力されることがあります。論理ネーミングサービスで出力されるパラメタについては，「14.12　論理ネーミングサービスで指定できるパラメタ」を参照してください。

参考

<configuration>タグで定義する<param-value>タグの指定値には，マニュアル「Cosminexus　機能解説」およびマニュアル「Cosminexus　システム構築ガイド」を参照して，各機能の概要や設定方法を確認した上で，適切な値を設定してください。

14.2.2　バッチアプリケーションを実行するシステムを構築する場合

バッチアプリケーションを実行するシステムでは，次の論理サーバを定義します。

論理J2EEサーバ※

論理パフォーマンストレーサ

注※　バッチサーバは論理J2EEサーバとして定義します。

また，定義する論理サーバごとに，コンフィグレーション（<configuration>タグの定義）で指定できるパラメタが異なります。論理サーバに指定できるパラメタについては，それぞれ次の個所を参照してください。

バッチサーバとしての論理J2EEサーバ
次の個所を参照してください。

「14.5.5　バッチサーバ用ユーザプロパティを設定するパラメタ」

「14.5.6　バッチサーバ用オプション定義を設定するパラメタ」

「14.5.7　バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ」

「14.5.8　バッチサーバの拡張パラメタ」

「14.5.9　運用監視エージェントプロパティを設定するパラメタ」

「14.5.10　Managementイベント発行用プロパティを設定するパラメタ」

「14.5.11　JP1連携を設定するパラメタ」

「14.5.12　SecurityManagerの使用を設定するパラメタ」※
注※　バッチサーバの場合，このパラメタは必ず指定してください。

論理パフォーマンストレーサ
「14.6　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

なお，それぞれの論理サーバに共通で指定できるパラメタがあります。論理サーバ共通のパラメタについては，「14.3　各論理サーバ共通で指定できるパラメタ」を参照してください。

参考

<configuration>タグで定義する<param-value>タグの指定値には，マニュアル「Cosminexus　機能解説」およびマニュアル「Cosminexus　システム構築ガイド」を参照して，各機能の概要や設定方法を確認した上で，適切な値を設定してください。

14.3　各論理サーバ共通で指定できるパラメタ

ここでは，次に示す論理サーバで共通に指定できるパラメタについて説明します。

論理Webサーバ

論理J2EEサーバ

論理パフォーマンストレーサ

論理SFOサーバ

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

論理ユーザサーバ

論理ネーミングサービス

＜この節の構成＞

14.3.1　論理サーバ共通で指定できるパラメタ

14.3.2　論理サーバにデフォルトで設定されている環境変数

14.3.1　論理サーバ共通で指定できるパラメタ

各論理サーバ共通で指定できるパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-2　各論理サーバ共通で指定できるパラメタ

param-name指定値
param-value指定内容
省略値

additional.startcmd※1
起動コマンドに追加するオプションを256文字以内で指定します。
なし

mstartup.force.watchtime
論理サーバの強制停止監視時間を秒単位で指定します。0を指定した場合監視しません。0，60，300，600，1800のどれかを指定します。
60

mstartup.no
一括起動時のサーバの起動順序を整数で指定します。一括起動をしない場合は-1を指定してください。
90

mstartup.premised.serverName※2
論理サーバの前提となる論理サーバを指定します。
なし

mstartup.restartcnt
論理サーバの自動再起動回数を指定します。
0，1，5，10，1000のどれかを指定します。
1

mstartup.retrywait
論理サーバの自動再起動リトライ間隔を秒単位で指定します。0，60，300，600，1800のどれかを指定します。
パフォーマンストレーサ：0
そのほか：60

mstartup.start.watchtime
論理サーバの起動監視時間を秒単位で指定します。
0，60，300，600，3600のどれかを指定します。
0を指定した場合は監視しません。
60

mstartup.watchtime
論理サーバの停止監視時間を秒単位で指定します。
0，60，300，600，1800のどれかを指定します。
0を指定した場合監視しません。
60

realservername※3
実サーバ名を128文字以下で指定します。cmx_build_systemコマンド実行後は，変更できません。
論理サーバ名

user.env.variable
サーバ起動時の環境変数を指定します。※4
なし※5

注※1

論理ユーザサーバでは指定できません。

注※2

論理パフォーマンストレーサでは指定できません。

注※3

論理Webサーバ，論理J2EEサーバおよび論理SFOサーバだけで指定できます。

注※4

値を複数指定する際は，複数の<param-value>で指定します。

（例）

　　<param-name>user.env.variable</param-name>

　　<param-value>AAA=1024</param-value>

　　<param-value>BBB=2048</param-value>

注※5

user.env.variableを指定しない場合，論理サーバにはデフォルトの環境変数が設定されます。論理サーバにデフォルトで設定されている環境変数については，「14.3.2　論理サーバにデフォルトで設定されている環境変数」を参照してください。

14.3.2　論理サーバにデフォルトで設定されている環境変数

論理サーバにデフォルトで設定されている環境変数を，OSごとに次の表に示します。

表14-3　論理サーバにデフォルトで設定されている環境変数（Windowsの場合）

論理サーバ | 環境変数 | 設定値
論理パフォーマンストレーサ | Path | ${cosminexus.home}¥PRF¥bin;%{Path}
論理スマートエージェント | Path | ${cosminexus.home}¥TPB¥bin;%{Path}
TPDIR | ${cosminexus.home}¥TPB
VBROKER_ADM | ${cosminexus.home}¥TPB¥adm
論理ネーミングサービス | CLASSPATH | 設定されません。
Path | ${cosminexus.home}¥jdk¥bin;${cosminexus.home}¥TPB¥bin;%{Path}
TPDIR | ${cosminexus.home}¥TPB
TPJDIR | ${cosminexus.home}¥TPB
VBROKER_ADM | ${cosminexus.home}¥TPB¥adm
論理CTMドメインマネジャ | CTMDIR | ${cosminexus.home}¥CTM
Path | ${cosminexus.home}¥CTM¥bin;${cosminexus.home}¥TPB¥bin;%{Path}
TPDIR | ${cosminexus.home}¥TPB
VBROKER_ADM | ${cosminexus.home}¥TPB¥adm
論理CTM | CTMDIR | ${cosminexus.home}¥CTM
Path | ${cosminexus.home}¥CTM¥bin;${cosminexus.home}¥TPB¥bin;%{Path}
TPDIR | ${cosminexus.home}¥TPB
VBROKER_ADM | ${cosminexus.home}¥TPB¥adm
論理SFOサーバ | CSCCFJ_SERVER_HOME | ${cosminexus.home}¥CC
Path | ${cosminexus.home}¥CTM¥bin;%{Path}
論理J2EEサーバ | CSCCFJ_SERVER_HOME | ${cosminexus.home}¥CC
Path | ${cosminexus.home}¥CTM¥bin;%{Path}

表14-4　論理サーバにデフォルトで設定されている環境変数（UNIXの場合）

論理サーバ
環境変数
設定値

論理パフォーマンストレーサ
PATH
${cosminexus.home}/PRF/bin:%{PATH}

ライブラリパス※1
${cosminexus.home}/PRF/lib:%{ライブラリパス}

EXTSHM※2
ON

LDR_CNTRL※2
MAXDATA=0x40000000

NODISCLAIM※2
true

PSALLOC※2
early

論理スマートエージェント
PATH

AIXの場合
${cosminexus.home}/TPB/bin:/bin:${PATH}

HP-UX，Linux，およびSolarisの場合
${cosminexus.home}/TPB/bin:/bin:/usr/bin:${PATH}

TPDIR
${cosminexus.home}/TPB

VBROKER_ADM
${cosminexus.home}/TPB/adm

AIXTHREAD_COND_DEBUG※2
設定されません。

AIXTHREAD_MUTEX_DEBUG※2
設定されません。

AIXTHREAD_RWLOCK_DEBUG※2
設定されません。

AIXTHREAD_SCOPE※2
設定されません。

NODISCLAIM※2
true

PSALLOC※2
early

論理ネーミングサービス
CLASSPATH
設定されません。

PATH

AIXの場合
${cosminexus.home}/jdk/bin:${cosminexus.home}/TPB/bin:/bin:${PATH}

HP-UX，Linux，およびSolarisの場合
${cosminexus.home}/jdk/bin:${cosminexus.home}/TPB/bin:/bin:/usr/bin:${PATH}

TPDIR
${cosminexus.home}/TPB

VBROKER_ADM
${cosminexus.home}/TPB/adm

ライブラリパス※1
${cosminexus.home}/TPB/lib:${ライブラリパス※1}

AIXTHREAD_COND_DEBUG※2
OFF

AIXTHREAD_MUTEX_DEBUG※2
OFF

AIXTHREAD_RWLOCK_DEBUG※2
OFF

AIXTHREAD_SCOPE※2
S

NODISCLAIM※2
true

PSALLOC※2
early

論理CTMドメインマネジャ
CTMDIR
${cosminexus.home}/CTM

PATH
${cosminexus.home}/CTM/bin:${cosminexus.home}/TPB/bin:%{PATH}

TPDIR
${cosminexus.home}/TPB

VBROKER_ADM
${cosminexus.home}/TPB/adm

ライブラリパス※1
${cosminexus.home}/CTM/lib:${cosminexus.home}/TPB/lib:${ライブラリパス※1}

EXTSHM※2
ON

LDR_CNTRL※2
MAXDATA=0x40000000

PSALLOC※2
early

論理CTM
CTMDIR
${cosminexus.home}/CTM

PATH
${cosminexus.home}/CTM/bin:${cosminexus.home}/TPB/bin:%{PATH}

TPDIR
${cosminexus.home}/TPB

VBROKER_ADM
${cosminexus.home}/TPB/adm

ライブラリパス※1
${cosminexus.home}/CTM/lib:${cosminexus.home}/TPB/lib:${ライブラリパス※1}

EXTSHM※2
ON

LDR_CNTRL※2
MAXDATA=0x40000000

PSALLOC※2
early

論理SFOサーバ
CSCCFJ_SERVER_HOME
${cosminexus.home}/CC

ライブラリパス※1
/opt/DABroker/lib:${cosminexus.home}/manager/bin:${ライブラリパス※1}

AIXTHREAD_COND_DEBUG※2
OFF

AIXTHREAD_MUTEX_DEBUG※2
OFF

AIXTHREAD_RWLOCK_DEBUG※2
OFF

AIXTHREAD_SCOPE※2
S

EXTSHM※2
ON

NODISCLAIM※2
true

PSALLOC※2
early

論理J2EEサーバ
CSCCFJ_SERVER_HOME
${cosminexus.home}/CC

ライブラリパス※1
/opt/DABroker/lib:${cosminexus.home}/manager/bin:${ライブラリパス※1}

AIXTHREAD_COND_DEBUG※2
OFF

AIXTHREAD_MUTEX_DEBUG※2
OFF

AIXTHREAD_RWLOCK_DEBUG※2
OFF

AIXTHREAD_SCOPE※2
S

EXTSHM※2
ON

NODISCLAIM※2
true

PSALLOC※2
early

論理Webサーバ
PATH
${cosminexus.home}/PRF/bin

ライブラリパス※1
${cosminexus.home}/PRF/lib:${ライブラリパス※1}

LDR_CNTRL※2
MAXDATA=0x40000000

EXTSHM※2
ON

注※1　ライブラリパスに指定する環境変数名は，OSごとに異なります。

AIXの場合：LIBPATH

HP-UX，Linux，およびSolarisの場合：LD_LIBRARY_PATH

注※2　AIX固有の環境変数です。AIX以外のOSには該当しません。

14.4　論理Webサーバで指定できるパラメタ

ここでは，論理Webサーバで指定できるパラメタについて説明します。

＜この節の構成＞

14.4.1　Webサーバ用定義を設定するパラメタ

14.4.2　Hitachi Web Server用リダイレクタ動作定義を設定するパラメタ

14.4.3　ワーカ定義を設定するパラメタ

14.4.4　Hitachi Web Serverのログの出力方法を設定するパラメタ

14.4.1　Webサーバ用定義を設定するパラメタ

Webサーバ用定義を設定するパラメタについて，次の表に示します。

なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Hitachi Web Server」のディレクティブ一覧についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-5　Webサーバ用定義を設定するパラメタ

param-name指定値
省略値

CoreDumpDirectory

Windowsの場合

<Hitachi Web Serverインストールディレクトリ>¥servers¥HWS_<サーバ名称>

UNIXの場合

<Hitachi Web Serverインストールディレクトリ>/servers/HWS_<サーバ名称>

Group
bin

HWSKeepStartServers
Off

HWSLogTimeVerbose
On

KeepAliveTimeout
15

Listen
なし

LogLevel
info

MaxClients
150

StartServers
5

ThreadsPerChild
50

User
bin

14.4.2　Hitachi Web Server用リダイレクタ動作定義を設定するパラメタ

Hitachi Web Server用リダイレクタ動作定義を設定するパラメタについて，次の表に示します。

なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のmod_jk.conf（Hitachi Web Server用リダイレクタ動作定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-6　Hitachi Web Server用リダイレクタ動作定義を設定するパラメタ

param-name指定値
省略値

JkConnectTimeout
30

JkGatewayHost
なし

JkGatewayHttpsScheme
Off

JkGatewayPort
なし

JkLogFileDir
logs

JkLogFileNum
8

JkLogFileSize
4194304

JkLogLevel
error

JkModulePriority
FIRST

JkMount

combined-tierとhttp-tierの場合※1
/* [J2EEサーバ名]

combined-tierとhttp-tier以外の場合
なし

JkPrfId
なし※2

JkRequestRetryCount
3

JkSendTimeout
100

JkTraceLog
On

JkTraceLogFileDir
logs

JkTraceLogFileNum
4

JkTraceLogFileSize
16777216

JkTranslateBackcompat
Off

注※1

なお，combined-tierとhttp-tierでこのパラメタを省略した場合，次のように関連するパラメタに値が設定されます。

<param>

<param-name>JkMount</param-name>

<param-value>/* [J2EEサーバ名]</param-value>

</param>

<param>

<param-name>worker.list</param-name>

<param-value>[J2EEサーバ名]</param-value>

</param>

<param>

<param-name>worker.[J2EEサーバ名].host</param-name>

<param-value>[ホスト名]</param-value>

</param>

<param>

<param-name>worker.[J2EEサーバ名].port</param-name>

<param-value>[ポート番号]</param-value>

</param>

<param>

<param-name>worker.[J2EEサーバ名].type</param-name>

<param-value>ajp13</param-value>

</param>

注※2

free-tier以外の場合，値は自動で設定されます。

14.4.3　ワーカ定義を設定するパラメタ

ワーカ定義を設定するパラメタについて，次の表に示します。

なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のworkers.properties（ワーカ定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-7　ワーカ定義を設定するパラメタ

param-name指定値 | 省略値
worker.<ワーカ名>.balanced_workers | なし
worker.<ワーカ名>.cachesize | 64
worker.<ワーカ名>.default_worker | なし
worker.<ワーカ名>.delegate_error_code | なし
worker.<ワーカ名>.host | なし
worker.<ワーカ名>.lbfactor | 1
worker.<ワーカ名>.port | なし
worker.<ワーカ名>.post_data | なし
worker.<ワーカ名>.post_size_workers | なし
worker.<ワーカ名>.receive_timeout | 3600
worker.list | なし

14.4.4　Hitachi Web Serverのログの出力方法を設定するパラメタ

Hitachi Web Serverのログの出力方法を設定するパラメタについて，次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-8　Hitachi Web Serverのログの出力方法を設定するパラメタ

param-name指定値
param-valueの指定内容
省略値

CustomDivideFileNum
HttpsdCustomMethodで「Div」を設定したときに有効になります。
分割したログファイルのファイル数を0～256の範囲で指定します。分割したファイル数がここで指定した数を超えた場合，最も古いファイルから削除されます。0を指定した場合，ファイルは削除されません。
8

CustomDivideTimeDifference
HttpsdCustomMethodで「Div」を設定したときに有効になります。
ログファイルを分割する基準となる時間（単位：分）を，GMTに対する差として-1439～1439の範囲で指定します。0を指定すると，1970年1月1日0時0分0秒（GMT）が基準時間となります。
540

CustomDivideTimeInterval
HttpsdCustomMethodで「Div」を設定したときに有効になります。
一つのログファイルで採取する時間間隔を1～31536000の範囲で指定します。
86400

CustomWraparoundFileNum
HttpsdCustomMethodで「Wrap」を設定したときに有効になります。
出力するログファイルの最大数を1～256の範囲で指定します。
ログファイルのサイズがCustomWraparoundFilesizeで指定したサイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，すでにこのパラメタに指定した最大数と同じ数のログファイルが作成されていた場合，「.001」という名称がついているファイルから再度使用されます。
5

CustomWraparoundFilesize
HttpsdCustomMethodで「Wrap」を設定したときに有効になります。
ログファイルの最大サイズ（単位：キロバイト）を1～2097151の範囲で指定します。
ログを出力するときに，ログファイルのサイズがこのパラメタで指定した最大サイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，移動先のログファイルの内容はクリアされます。
8192

ErrorDivideFileNum
HttpsdErrorMethodで「Div」を設定したときに有効になります。
分割したログファイルのファイル数を0～256の範囲で指定します。分割したファイル数がここで指定した数を超えた場合，最も古いファイルから削除されます。0を指定した場合，ファイルは削除されません。
8

ErrorDivideTimeDifference
HttpsdErrorMethodで「Div」を設定したときに有効になります。
ログファイルを分割する基準となる時間（単位：分）を，GMTに対する差として-1439～1439の範囲で指定します。0を指定すると，1970年1月1日0時0分0秒（GMT）が基準時間となります。
540

ErrorDivideTimeInterval
HttpsdErrorMethodで「Div」を設定したときに有効になります。
一つのログファイルで採取する時間間隔を1～31536000の範囲で指定します。
86400

ErrorWraparoundFileNum
HttpsdErrorMethodで「Wrap」を設定したときに有効になります。
出力するログファイルの最大数を1～256の範囲で指定します。
ErrorWraparoundFilesizeで指定したサイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，すでにこのパラメタに指定した最大数と同じ数のログファイルが作成されていた場合，「.001」という名称がついているファイルから再度使用されます。
5

ErrorWraparoundFilesize
HttpsdErrorMethodで「Wrap」を設定したときに有効になります。
ログファイルの最大サイズ（単位：キロバイト）を1～2097151の範囲で指定します。
ログを出力するときに，ログファイルのサイズがこのパラメタで指定した最大サイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，移動先のログファイルの内容はクリアされます。
8192

HttpsdCustomLogFileDir
Webサーバが出力するアクセスログの出力先ディレクトリを指定します。
logs

HttpsdCustomlogFormat
Hitachi Web Serverが提供するラベル名または任意のフォーマットを指定します。
Hitachi Web Serverが提供するラベル名と対応するフォーマットは次のとおりです。

common

combined

combinedio

hws_std

hws_trace

これ以外のフォーマットを指定する場合は，任意のフォーマットを指定してください。フォーマットで指定した内容が，httpsd.conf（Hitachi Web Server定義ファイル）のCustomLogディレクティブの引数に設定されます。
フォーマットの指定内容の詳細については,マニュアル「Hitachi Web Server」のCustomLogディレクティブに関する説明を参照してください。
hws_std

HttpsdCustomMethod
アクセスログの出力方式として，次のどれかを指定します。

Off：

httpsd.conf（Hitachi Web Server定義ファイル）の設定を変更しません。

httpsd.confを編集していない場合，省略値が設定されます。

On：

単調増加でログを出力します。

Div：

一定時間単位にログを分割して出力します。

Wrap：

ファイルサイズでログを分割してラップアラウンドに出力します。

Div

HttpsdErrorLogFileDir
Webサーバの出力するエラーログの出力先ディレクトリを指定します。
logs

HttpsdErrorMethod
エラーログの出力方式として，次のどれかを指定します。

Off：

httpsd.conf（Hitachi Web Server定義ファイル）の設定を変更しません。httpsd.confを編集していない場合，「Wrap」が設定されます。

On：

単調増加でログを出力します。

Div：

一定時間単位にログを分割して出力します。

Wrap：

ファイルサイズでログを分割してラップアラウンドに出力します。

Div

HttpsdLogFileDir
Webサーバの出力するログの出力先ディレクトリを指定します。
logs

HttpsdRequestLogFileDir
Webサーバの出力するリクエストログの出力先ディレクトリを指定します。
logs

HttpsdRequestMethod
リクエストログの出力方式として，次のどれかを指定します。

Off：

httpsd.conf（Hitachi Web Server定義ファイル）の設定を変更しません。httpsd.confを編集していない場合，省略値が設定されます。

On：

単調増加でログを出力します。

Div：

一定時間単位にログを分割して出力します。

Wrap：

ファイルサイズでログを分割してラップアラウンドに出力します。

Div

HWSRequestIofilter
HWSRequestLogLevelで「on」を設定したときに有効になります。
モジュールが実装している入出力フィルタ関数の，実行契機を示すI/Oフィルタトレースを出力する場合に指定します。出力量が多いため，実運用での指定は推奨しません。
次のどちらかを指定します。

true：

出力します。

false：

出力しません。

false

HWSRequestLogLevel
リクエストログに出力するかどうかを指定します。次のどちらかを指定します。

on：

出力します。

none：

出力しません。

また，このパラメタで「on」を設定した場合，次に示すパラメタの設定が有効になります。

HWSRequestIofilter

HWSRequestModuleDebug

HWSRequestModuleInfo

HWSRequestRequest

デフォルトでは，次に示すパラメタが出力されます。

HWSRequestModuleInfo

HWSRequestRequest

On

HWSRequestModuleDebug
HWSRequestLogLevelで「on」を設定したときに有効になります。
内部モジュールに対するモジュールトレースと，外部モジュール相当のトレースを出力する場合に指定します。出力量が多いため，実運用での指定は推奨しません。
次のどちらかを指定します。

true：

出力します。

false：

出力しません。

false

HWSRequestModuleInfo
HWSRequestLogLevelで「on」を設定したときに有効になります。
外部モジュールに対するモジュールトレースを出力する場合に指定します。
次のどちらかを指定します。

true：

出力します。

false：

出力しません。

true

HWSRequestRequest
HWSRequestLogLevelで「on」を設定したときに有効になります。
次の場合に指定します。

コネクション確立後とレスポンス完了後にトレースを出力したい場合

KeepAlive接続の場合に，次のリクエストライン受信後にもトレースを出力したい場合

次のどちらかを指定します。

true：

出力します。

false：

出力しません。

true

RequestDivideFileNum
HttpsdRequestMethodで「Div」を設定したときに有効になります。
分割したログファイルのファイル数を0～256の範囲で指定します。分割したファイル数がここで指定した数を超えた場合，最も古いファイルから削除されます。0を指定した場合，ファイルは削除されません。
8

RequestDivideTimeDifference
HttpsdRequestMethodで「Div」を設定したときに有効になります。
ログファイルを分割する基準となる時間（単位：分）を，GMTに対する差として-1439～1439の範囲で指定します。0を指定すると，1970年1月1日0時0分0秒（GMT）が基準時間となります。
540

RequestDivideTimeInterval
HttpsdRequestMethodで「Div」を設定したときに有効になります。
一つのログファイルで採取する時間間隔を1～31536000の範囲で指定します。
86400

RequestWraparoundFileNum
HttpsdRequestMethodで「Wrap」を設定したときに有効になります。
出力するログファイルの最大数を1～256の範囲で指定します。
ログファイルのサイズがRequestWraparoundFilesizeで指定したサイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，すでにこのパラメタに指定した最大数と同じ数のログファイルが作成されていた場合，「.001」という名称がついているファイルから再度使用されます。
5

RequestWraparoundFilesize
HttpsdRequestMethodで「Wrap」を設定したときに有効になります。
ログファイルの最大サイズ（単位：キロバイト）を1～2097151の範囲で指定します。
ログを出力するときに，ログファイルのサイズがこのパラメタで指定した最大サイズを超えた場合，ログの出力先は次のログファイルに移ります。このとき，移動先のログファイルの内容はクリアされます。
8192

worker.<ワーカ名>.type
ワーカのタイプを次に示すタイプから指定します。タイプごとに設定できるパラメタについては，マニュアル「Cosminexus　リファレンス　定義編」のworkers.properties（ワーカ定義ファイル）の説明を参照してください。なお，このパラメタはワーカごとに指定する必要があります。
次のどれかを指定します。

ajp13：

外部プロセスで動作しているWebコンテナサーバにリクエストを転送するワーカです。

lb：

ラウンドロビンに基づく負荷分散機能を持つワーカです。

post_size_lb：

POSTデータサイズによってリクエストの転送先J2EEサーバを振り分ける機能を持つワーカです。

なし

14.5　論理J2EEサーバで指定できるパラメタ

ここでは，論理J2EEサーバで指定できるパラメタについて説明します。

論理J2EEサーバでは，J2EEサーバとバッチサーバのどちらを使用するかで指定できるパラメタが異なります。指定できるパラメタとパラメタの参照先について，サーバごとに次の表に示します。

表14-9　使用するサーバと指定するパラメタの参照先の対応

使用するサーバ | 指定するパラメタ
J2EEサーバ | J2EEサーバ用ユーザプロパティを設定するパラメタ（14.5.1参照）
J2EEサーバ用オプション定義を設定するパラメタ（14.5.2参照）
J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ（14.5.3参照）
J2EEサーバの拡張パラメタ（14.5.4参照）
バッチサーバ | バッチサーバ用ユーザプロパティを設定するパラメタ（14.5.5参照）
バッチサーバ用オプション定義を設定するパラメタ（14.5.6参照）
バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ（14.5.7参照）
バッチサーバの拡張パラメタ（14.5.8参照）
J2EEサーバとバッチサーバ | 運用監視エージェントプロパティを設定するパラメタ（14.5.9参照）
Managementイベント発行用プロパティを設定するパラメタ（14.5.10参照）
JP1連携を設定するパラメタ（14.5.11参照）
SecurityManagerの使用を設定するパラメタ（14.5.12参照）

＜この節の構成＞

14.5.1　J2EEサーバ用ユーザプロパティを設定するパラメタ

14.5.2　J2EEサーバ用オプション定義を設定するパラメタ

14.5.3　J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.5.4　J2EEサーバの拡張パラメタ

14.5.5　バッチサーバ用ユーザプロパティを設定するパラメタ

14.5.6　バッチサーバ用オプション定義を設定するパラメタ

14.5.7　バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.5.8　バッチサーバの拡張パラメタ

14.5.9　運用監視エージェントプロパティを設定するパラメタ

14.5.10　Managementイベント発行用プロパティを設定するパラメタ

14.5.11　JP1連携を設定するパラメタ

14.5.12　SecurityManagerの使用を設定するパラメタ

14.5.1　J2EEサーバ用ユーザプロパティを設定するパラメタ

J2EEサーバ用ユーザプロパティを設定するパラメタについて説明します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）についての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

なお，「param-valueの指定内容」が記載されているパラメタは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）と指定方法が異なるパラメタです。

＜この項の構成＞

(1)　ejbserver.applicationから始まるパラメタ

(2)　ejbserver.clientから始まるパラメタ

(3)　ejbserver.compilerから始まるパラメタ

(4)　ejbserver.connectionpoolから始まるパラメタ

(5)　ejbserver.connectorから始まるパラメタ

(6)　ejbserver.containerから始まるパラメタ

(7)　ejbserver.ctmから始まるパラメタ

(8)　ejbserver.deployから始まるパラメタ

(9)　ejbserver.distributedtxから始まるパラメタ

(10)　ejbserver.DynamicStubLoadingから始まるパラメタ

(11)　ejbserver.ejbから始まるパラメタ

(12)　ejbserver.extから始まるパラメタ

(13)　ejbserver.httpから始まるパラメタ

(14)　ejbserver.instrumentationから始まるパラメタ

(15)　ejbserver.jdbcから始まるパラメタ

(16)　ejbserver.jndiから始まるパラメタ

(17)　ejbserver.jtaから始まるパラメタ

(18)　ejbserver.loggerから始まるパラメタ

(19)　ejbserver.managementから始まるパラメタ

(20)　ejbserver.managerから始まるパラメタ

(21)　ejbserver.namingから始まるパラメタ

(22)　ejbserver.rmiから始まるパラメタ

(23)　ejbserver.serverから始まるパラメタ

(24)　ejbserver.statefulから始まるパラメタ

(25)　ejbserver.watchから始まるパラメタ

(26)　ejbserver.webj2eeから始まるパラメタ

(27)　javaから始まるパラメタ

(28)　vbjから始まるパラメタ

(29)　vbrokerから始まるパラメタ

(30)　webserver.connectorから始まるパラメタ

(31)　webserver.containerから始まるパラメタ

(32)　webserver.contextから始まるパラメタ

(33)　webserver.httpから始まるパラメタ

(34)　webserver.jspから始まるパラメタ

(35)　webserver.loggerから始まるパラメタ

(36)　webserver.sessionから始まるパラメタ

(37)　webserver.sfoから始まるパラメタ

(38)　webserver.staticから始まるパラメタ

(39)　webserver.workから始まるパラメタ

(40)　webserver.xmlから始まるパラメタ

(1)　ejbserver.applicationから始まるパラメタ

ejbserver.applicationから始まるパラメタについて次の表に示します。

表14-10　ejbserver.applicationから始まるパラメタ

param-name指定値 | 省略値
ejbserver.application.InitTermProcessClasses※1 | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname | user_app
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count | 2
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level | SEVERE
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit | 1048576
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid | 0001
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path | user_log
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator | ｜
ejbserver.application.userlog.Logger.<ロガー名称>.filter | なし
ejbserver.application.userlog.Logger.<ロガー名称>.handlers※1 | なし
ejbserver.application.userlog.Logger.<ロガー名称>.level | SEVERE
ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers | true
ejbserver.application.userlog.loggers※1 | なし
ejbserver.application.userlog.menu.handlers.※1 ※2 | なし

注※1

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

注※2

このパラメタには，ハンドラの名称一覧を指定します。

このパラメタからハンドラ名を削除する場合は，関連するパラメタ（ejbserver.application.userlog.CJLogHandler.<削除するハンドラ名称>.XXX）も削除してください。

なお，このパラメタに対応するキーはマニュアル「Cosminexus　リファレンス　定義編」にはありません。

(2)　ejbserver.clientから始まるパラメタ

ejbserver.clientから始まるパラメタについて次の表に示します。

表14-11　ejbserver.clientから始まるパラメタ

param-name指定値 | 省略値
ejbserver.client.ctm.RequestPriority | 4

(3)　ejbserver.compilerから始まるパラメタ

ejbserver.compilerから始まるパラメタについて次の表に示します。

表14-12　ejbserver.compilerから始まるパラメタ

param-name指定値
param-valueの指定内容
省略値

ejbserver.compiler.jvm.maxHeapSize※
J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの最大サイズを1～4095の範囲（単位：メガバイト）で指定します。
ejbserver.compiler.jvm.minHeapSize≦ejbserver.compiler.jvm.maxHeapSizeの関係が成り立つ値を設定してください。
256

ejbserver.compiler.jvm.minHeapSize※
J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの初期サイズを1～4095の範囲（単位：メガバイト）で指定します。
ejbserver.compiler.jvm.minHeapSize≦ejbserver.compiler.jvm.maxHeapSizeの関係が成り立つ値を設定してください。
32

注※

メガバイト単位で指定する場合に，文字「m」または「M」は不要です。

また，文字「k」または「K」を付けてキロバイト単位で指定することはできません。

(4)　ejbserver.connectionpoolから始まるパラメタ

ejbserver.connectionpoolから始まるパラメタについて次の表に示します。

表14-13　ejbserver.connectionpoolから始まるパラメタ

param-name指定値 | 省略値
ejbserver.connectionpool.association.enabled | false

(5)　ejbserver.connectorから始まるパラメタ

ejbserver.connectorから始まるパラメタについて次の表に示します。

表14-14　ejbserver.connectorから始まるパラメタ

param-name指定値 | 省略値
ejbserver.connector.logwriter.filenum | 4
ejbserver.connector.logwriter.filesize | 2097152

(6)　ejbserver.containerから始まるパラメタ

ejbserver.containerから始まるパラメタについて次の表に示します。

表14-15　ejbserver.containerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.container.audit_trail.enabled | false
ejbserver.container.passivate.scan.interval | 0
ejbserver.container.remove.scan.interval | 5

(7)　ejbserver.ctmから始まるパラメタ

ejbserver.ctmから始まるパラメタについて次の表に示します。

表14-16　ejbserver.ctmから始まるパラメタ

param-name指定値 | 省略値
ejbserver.ctm.ActivateTimeOut | 180
ejbserver.ctm.CTMID | <IPアドレス>
ejbserver.ctm.DeactivateTimeOut | 180
ejbserver.ctm.QueueLength | なし

(8)　ejbserver.deployから始まるパラメタ

ejbserver.deployから始まるパラメタについて次の表に示します。

表14-17　ejbserver.deployから始まるパラメタ

param-name指定値
省略値

ejbserver.deploy.applications.metadata_complete
false

ejbserver.deploy.context.check_interval
0

ejbserver.deploy.context.reload_scope
app

ejbserver.deploy.context.update.interval
0

ejbserver.deploy.resourcefile.scramble.enabled
false

ejbserver.deploy.session.work.directory

Windowsの場合

&{cosminexus.home}¥CC¥server¥repository¥&{server.name}

UNIXの場合

&{cosminexus.home}/CC/server/repository/&{server.name}

(9)　ejbserver.distributedtxから始まるパラメタ

ejbserver.distributedtxから始まるパラメタについて次の表に示します。

表14-18　ejbserver.distributedtxから始まるパラメタ

param-name指定値 | 省略値
ejbserver.distributedtx.enableXidReuseOptimization | false
ejbserver.distributedtx.ots.status.directory1 | otsstatus
ejbserver.distributedtx.ots.status.directory2 | なし
ejbserver.distributedtx.recovery.port | 20302
ejbserver.distributedtx.rollbackClientTxOnSystemException | false
ejbserver.distributedtx.XATransaction.enabled | false

(10)　ejbserver.DynamicStubLoadingから始まるパラメタ

ejbserver.DynamicStubLoadingから始まるパラメタについて次の表に示します。

表14-19　ejbserver.DynamicStubLoadingから始まるパラメタ

param-name指定値 | 省略値
ejbserver.DynamicStubLoading.Enabled | false

(11)　ejbserver.ejbから始まるパラメタ

ejbserver.ejbから始まるパラメタについて次の表に示します。

表14-20　ejbserver.ejbから始まるパラメタ

param-name指定値 | 省略値
ejbserver.ejb.timerservice.maxCallbackThreads | 1
ejbserver.ejb.timerservice.retryCount | 1
ejbserver.ejb.timerservice.retryInterval | 5

(12)　ejbserver.extから始まるパラメタ

ejbserver.extから始まるパラメタについて次の表に示します。

表14-21　ejbserver.extから始まるパラメタ

param-name指定値 | 省略値
ejbserver.ext.method_observation.interval | 0

(13)　ejbserver.httpから始まるパラメタ

ejbserver.httpから始まるパラメタについて次の表に示します。

表14-22　ejbserver.httpから始まるパラメタ

param-name指定値 | 省略値
ejbserver.http.port | 8080

(14)　ejbserver.instrumentationから始まるパラメタ

ejbserver.instrumentationから始まるパラメタについて次の表に示します。

表14-23　ejbserver.instrumentationから始まるパラメタ

param-name指定値 | 省略値
ejbserver.instrumentation.enabled | true

(15)　ejbserver.jdbcから始まるパラメタ

ejbserver.jdbcから始まるパラメタについて次の表に示します。

表14-24　ejbserver.jdbcから始まるパラメタ

param-name指定値 | 省略値
ejbserver.jdbc.propertyInfo.BUF_SIZE | なし
ejbserver.jdbc.propertyInfo.ENCODELANG | なし

(16)　ejbserver.jndiから始まるパラメタ

ejbserver.jndiから始まるパラメタについて次の表に示します。

表14-25　ejbserver.jndiから始まるパラメタ

param-name指定値 | 省略値
ejbserver.jndi.cache | on
ejbserver.jndi.cache.interval | 0
ejbserver.jndi.cache.interval.clear.option | refresh
ejbserver.jndi.namingservice.group.<Specify group name>.providerurls | なし
ejbserver.jndi.namingservice.group.list | なし
ejbserver.jndi.request.timeout | 0

(17)　ejbserver.jtaから始まるパラメタ

ejbserver.jtaから始まるパラメタについて次の表に示します。

表14-26　ejbserver.jtaから始まるパラメタ

param-name指定値 | 省略値
ejbserver.jta.TransactionManager.defaultTimeOut | 180

(18)　ejbserver.loggerから始まるパラメタ

ejbserver.loggerから始まるパラメタについて次の表に示します。

表14-27　ejbserver.loggerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ConsoleLogFile.filenum | 2
ejbserver.logger.channels.define.ConsoleLogFile.filesize | 1048576
ejbserver.logger.channels.define.EJBContainerLogFile.filenum | 2
ejbserver.logger.channels.define.EJBContainerLogFile.filesize | 1048576
ejbserver.logger.channels.define.ExceptionLogFile.filenum | 2
ejbserver.logger.channels.define.ExceptionLogFile.filesize | 1048576
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filenum | 2
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.HttpSessionWatchLogFile.filenum | 2
ejbserver.logger.channels.define.HttpSessionWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.MaintenanceLogFile.filenum | 4
ejbserver.logger.channels.define.MaintenanceLogFile.filesize | 16777216
ejbserver.logger.channels.define.MemoryWatchLogFile.filenum | 2
ejbserver.logger.channels.define.MemoryWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.MessageLogFile.filenum | 2
ejbserver.logger.channels.define.MessageLogFile.filesize | 1048576
ejbserver.logger.channels.define.RequestQueueWatchLogFile.filenum | 2
ejbserver.logger.channels.define.RequestQueueWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ThreadWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreadWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.UserErrLogFile.filenum | 2
ejbserver.logger.channels.define.UserErrLogFile.filesize | 1048576
ejbserver.logger.channels.define.UserOutLogFile.filenum | 2
ejbserver.logger.channels.define.UserOutLogFile.filesize | 1048576
ejbserver.logger.channels.define.WebAccessLogFile.filenum | 16
ejbserver.logger.channels.define.WebAccessLogFile.filesize | 2097152
ejbserver.logger.channels.define.WebContainerLogFile.filenum | 2
ejbserver.logger.channels.define.WebContainerLogFile.filesize | 1048576
ejbserver.logger.channels.define.WebServletLogFile.filenum | 4
ejbserver.logger.channels.define.WebServletLogFile.filesize | 4194304
ejbserver.logger.enabled.* | Error，Warning
ejbserver.logger.systemlog.enabled | true

(19)　ejbserver.managementから始まるパラメタ

ejbserver.managementから始まるパラメタについて次の表に示します。

表14-28　ejbserver.managementから始まるパラメタ

param-name指定値
省略値

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled
true

ejbserver.management.JVM.stats_monitor.FullGCCount.interval
600

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold
10

ejbserver.management.statistics.interval
60

ejbserver.management.stats_file.base_time
0

ejbserver.management.stats_file.dir

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats

ejbserver.management.stats_file.enabled
true

ejbserver.management.stats_file.num
7

ejbserver.management.stats_file.period
24

(20)　ejbserver.managerから始まるパラメタ

ejbserver.managerから始まるパラメタについて次の表に示します。

表14-29　ejbserver.managerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.manager.agent.JP1EventAgent.conf | なし
ejbserver.manager.agent.JP1EventAgent.enabled | false
ejbserver.manager.agent.MEventAgent.conf | なし
ejbserver.manager.agent.MEventAgent.enabled | true

(21)　ejbserver.namingから始まるパラメタ

ejbserver.namingから始まるパラメタについて次の表に示します。

表14-30　ejbserver.namingから始まるパラメタ

param-name指定値 | 省略値
ejbserver.naming.host | J2EEサーバと同じホスト
ejbserver.naming.port※1 | 900
ejbserver.naming.startupMode※2 | inprocess
ejbserver.naming.startupRetryCount※1 | 9
ejbserver.naming.startupWaitTime※1 | 1

注※1

ejbserver.naming.startupModeに「inprocess」以外を指定した場合，指定は無視されます。

注※2

「automatic」は指定できません。

(22)　ejbserver.rmiから始まるパラメタ

ejbserver.rmiから始まるパラメタについて次の表に示します。

表14-31　ejbserver.rmiから始まるパラメタ

param-name指定値 | 省略値
ejbserver.rmi.localinvocation.scope | app
ejbserver.rmi.naming.host | なし
ejbserver.rmi.naming.port | 23152
ejbserver.rmi.passbyreference | false
ejbserver.rmi.remote.listener.port | 0
ejbserver.rmi.request.timeout | 0

(23)　ejbserver.serverから始まるパラメタ

ejbserver.serverから始まるパラメタについて次の表に示します。

表14-32　ejbserver.serverから始まるパラメタ

param-name指定値 | 省略値
ejbserver.server.j2ee.feature | 1.4
ejbserver.server.prf.PRFID | なし
ejbserver.server.threaddump.filenum | 256

(24)　ejbserver.statefulから始まるパラメタ

ejbserver.statefulから始まるパラメタについて次の表に示します。

表14-33　ejbserver.statefulから始まるパラメタ

param-name指定値 | 省略値
ejbserver.stateful.passivate.switch | false

(25)　ejbserver.watchから始まるパラメタ

ejbserver.watchから始まるパラメタについて次の表に示します。

表14-34　ejbserver.watchから始まるパラメタ

param-name指定値 | 省略値
ejbserver.watch.defaultRequestQueue.enabled | true
ejbserver.watch.defaultRequestQueue.interval | 30
ejbserver.watch.defaultRequestQueue.threshold | 80
ejbserver.watch.defaultRequestQueue.writefile.enabled | true
ejbserver.watch.enabled | true
ejbserver.watch.fileDescriptor.enabled | true
ejbserver.watch.fileDescriptor.interval | 60
ejbserver.watch.fileDescriptor.threshold | 2147483647
ejbserver.watch.fileDescriptor.writefile.enabled | true
ejbserver.watch.memory.enabled | true
ejbserver.watch.memory.interval | 60
ejbserver.watch.memory.threshold | 80
ejbserver.watch.memory.writefile.enabled | true
ejbserver.watch.thread.enabled | true
ejbserver.watch.thread.interval | 60
ejbserver.watch.thread.threshold | 2147483647
ejbserver.watch.thread.writefile.enabled | true
ejbserver.watch.threaddump.enabled | true
ejbserver.watch.threaddump.interval | 30
ejbserver.watch.threaddump.threshold | 80
ejbserver.watch.threaddump.writefile.enabled | true

(26)　ejbserver.webj2eeから始まるパラメタ

ejbserver.webj2eeから始まるパラメタについて次の表に示します。

表14-35　ejbserver.webj2eeから始まるパラメタ

param-name指定値 | 省略値
ejbserver.webj2ee.connectionAutoClose.enabled | true

(27)　javaから始まるパラメタ

javaから始まるパラメタについて次の表に示します。

表14-36　javaから始まるパラメタ

param-name指定値 | 省略値
java.naming.factory.initial | com.hitachi.software.ejb.jndi.InsContextFactory

(28)　vbjから始まるパラメタ

vbjから始まるパラメタについて次の表に示します。

表14-37　vbjから始まるパラメタ

param-name指定値
param-valueの指定内容
省略値

vbj.java2iiop.jvm.maxHeapSize※
J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの最大サイズを1～4095の範囲（単位：メガバイト）で指定します。
vbj.java2iiop.jvm.minHeapSize≦vbj.java2iiop.jvm.maxHeapSizeの関係が成り立つ値を設定してください。
128

vbj.java2iiop.jvm.minHeapSize※
J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの初期サイズを1～4095の範囲（単位：メガバイト）で指定します。
vbj.java2iiop.jvm.minHeapSize≦vbj.java2iiop.jvm.maxHeapSizeの関係が成り立つ値を設定してください。
16

注※

メガバイト単位で指定する場合に，文字「m」または「M」は不要です。

また，文字「k」または「K」を付けてキロバイト単位で指定することはできません。

(29)　vbrokerから始まるパラメタ

vbrokerから始まるパラメタについて次の表に示します。

表14-38　vbrokerから始まるパラメタ

param-name指定値 | 省略値
vbroker.agent.port | 14000
vbroker.se.iiop_tp.host | なし
vbroker.se.iiop_tp.scm.iiop_tp.listener.port | 0

(30)　webserver.connectorから始まるパラメタ

webserver.connectorから始まるパラメタについて次の表に示します。

表14-39　webserver.connectorから始まるパラメタ

param-name指定値 | 省略値
webserver.connector.ajp13.backlog | 100
webserver.connector.ajp13.bind_host | なし
webserver.connector.ajp13.max_threads | 10
webserver.connector.ajp13.port | 8007
webserver.connector.ajp13.receive_timeout | 600
webserver.connector.ajp13.send_timeout | 600
webserver.connector.http.bind_host | なし
webserver.connector.http.permitted.hosts※ | なし
webserver.connector.inprocess_http.backlog | 511
webserver.connector.inprocess_http.bind_host | なし
webserver.connector.inprocess_http.enabled | false
webserver.connector.inprocess_http.enabled_methods | GET,HEAD,POST,PUT,DELETE,OPTIONS
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file | なし
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file.content_type | text/html
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 | false
webserver.connector.inprocess_http.gateway.port | なし
webserver.connector.inprocess_http.init_threads | 10
webserver.connector.inprocess_http.keep_start_threads | false
webserver.connector.inprocess_http.limit.max_headers | 100
webserver.connector.inprocess_http.limit.max_request_body | -1
webserver.connector.inprocess_http.limit.max_request_header | 16384
webserver.connector.inprocess_http.limit.max_request_line | 8190
webserver.connector.inprocess_http.max_connections | 100
webserver.connector.inprocess_http.max_execute_threads | 10
webserver.connector.inprocess_http.max_spare_threads | 20
webserver.connector.inprocess_http.min_spare_threads | 5
webserver.connector.inprocess_http.permitted.hosts | *
webserver.connector.inprocess_http.persistent_connection.max_connections | 100
webserver.connector.inprocess_http.persistent_connection.max_requests | 100
webserver.connector.inprocess_http.persistent_connection.timeout | 3
webserver.connector.inprocess_http.port | 80
webserver.connector.inprocess_http.receive_timeout | 300
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file | なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file.content_type | text/html
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.redirect_url | なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.request_url | なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status | 302
webserver.connector.inprocess_http.redirect.list | なし
webserver.connector.inprocess_http.rejection_threads | 1
webserver.connector.inprocess_http.response.header.server | CosminexusComponentContainer
webserver.connector.inprocess_http.send_timeout | 300
webserver.connector.redirect_https.port | なし

注※

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

(31)　webserver.containerから始まるパラメタ

webserver.containerから始まるパラメタについて次の表に示します。

表14-40　webserver.containerから始まるパラメタ

param-name指定値 | 省略値
webserver.container.ac.logEnabled | false
webserver.container.server_id.enabled | false
webserver.container.server_id.name | 空文字※1
webserver.container.server_id.value | なし※2
webserver.container.thread_control.enabled | true
webserver.container.thread_control.queue_size | 8192

注※1

負荷分散機の設定で指定した<cookie-name>の値が自動的に設定されます。

注※2

負荷分散機の設定で指定した<server-id-rule>に従ってManagement Serverが自動的に生成した値が設定されます。

(32)　webserver.contextから始まるパラメタ

webserver.contextから始まるパラメタについて次の表に示します。

表14-41　webserver.contextから始まるパラメタ

param-name指定値 | 省略値
webserver.context.check_interval | なし
webserver.context.reload_delay_timeout※ | 0
webserver.context.update.interval | なし

注※

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（Webコンテナサーバ用ユーザプロパティファイル）についての説明を参照してください。

(33)　webserver.httpから始まるパラメタ

webserver.httpから始まるパラメタについて次の表に示します。

表14-42　webserver.httpから始まるパラメタ

param-name指定値 | 省略値
webserver.http.request.encoding | なし
webserver.http.response.encoding | なし

(34)　webserver.jspから始まるパラメタ

webserver.jspから始まるパラメタについて次の表に示します。

表14-43　webserver.jspから始まるパラメタ

param-name指定値 | 省略値
webserver.jsp.check_interval | なし
webserver.jsp.compile.backcompat | false
webserver.jsp.keepgenerated | false
webserver.jsp.pageEncoding | なし
webserver.jsp.translation.backcompat.customAction.declareVariable | false
webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue | false
webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate | false
webserver.jsp.translation.backcompat.taglib.noCheckPrefix | false
webserver.jsp.translation.backcompat.useBean.noCheckClass | false
webserver.jsp.update.interval | なし

(35)　webserver.loggerから始まるパラメタ

webserver.loggerから始まるパラメタについて次の表に示します。

表14-44　webserver.loggerから始まるパラメタ

param-name指定値
省略値

webserver.logger.access_log.<フォーマット名>
%h %l %u %t "%r" %>s %b

webserver.logger.access_log.format_list
なし

webserver.logger.access_log.inprocess_http.enabled
true

webserver.logger.access_log.inprocess_http.filename

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥http¥cjhttp_access.inprocess_http

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/http/cjhttp_access.inprocess_http

webserver.logger.access_log.inprocess_http.filenum
16

webserver.logger.access_log.inprocess_http.filesize
4194304

webserver.logger.access_log.inprocess_http.usage_format
common

(36)　webserver.sessionから始まるパラメタ

webserver.sessionから始まるパラメタについて次の表に示します。

表14-45　webserver.sessionから始まるパラメタ

param-name指定値 | 省略値
webserver.session.server_id.value | なし※

注※

free-tier以外の場合，Management Serverによって8けたの16進数が自動設定されます。

(37)　webserver.sfoから始まるパラメタ

webserver.sfoから始まるパラメタについて次の表に示します。

表14-46　webserver.sfoから始まるパラメタ

param-name指定値 | 省略値
webserver.sfo.check_size.mode | off
webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.connectionTimeout | 30
webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.naming | なし
webserver.sfo.sfo_servers※ | なし

注※

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

(38)　webserver.staticから始まるパラメタ

webserver.staticから始まるパラメタについて次の表に示します。

表14-47　webserver.staticから始まるパラメタ

param-name指定値 | 省略値
webserver.static_content.cache.enabled | false
webserver.static_content.cache.filesize.threshold | 524288
webserver.static_content.cache.size | 10485760
webserver.static_content.encoding.extension | なし

(39)　webserver.workから始まるパラメタ

webserver.workから始まるパラメタについて次の表に示します。

表14-48　webserver.workから始まるパラメタ

param-name指定値
省略値

webserver.work.clean
false

webserver.work.directory

Windowsの場合

&{cosminexus.home}¥CC¥server¥repository¥&{server.name}¥web

UNIXの場合

&{cosminexus.home}/CC/server/repository/&{server.name}/web

(40)　webserver.xmlから始まるパラメタ

webserver.xmlから始まるパラメタについて次の表に示します。

表14-49　webserver.xmlから始まるパラメタ

param-name指定値 | 省略値
webserver.xml.validate | true

14.5.2　J2EEサーバ用オプション定義を設定するパラメタ

J2EEサーバ用オプション定義を設定するパラメタについて，次の表に示します。なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（J2EEサーバ用オプション定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-50　J2EEサーバ用オプション定義を設定するパラメタ

param-name指定値
省略値

add.jvm.arg※
なし

ejb.public.directory

Windowsの場合

&{cosminexus.home}¥CC¥server¥public

UNIXの場合

&{cosminexus.home}/CC/server/public

ejb.server.log.directory

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs

注※

値の指定形式について，次に示します。

（例）

<param-name>add.jvm.arg</param-name>

　 <param-value>-Xms256m</param-value>

<param-value>-Xmx512m</param-value>

　　　　　　　　　　　　　　：

14.5.3　J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ

J2EEサーバのJavaVMのシステムプロパティを設定するパラメタについて，次の表に示します。「param-value指定値」に指定する値の詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

J2EEサーバのJavaVMのシステムプロパティを設定するパラメタを指定する場合の指定形式を次に示します。

指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>
<param-value>値</param-value>

表14-51　J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ

param-name指定値
省略値

ejbserver.connectionpool.applicationAuthentication.disabled
false

ejbserver.connectionpool.association.enabledDespiteUnshareableSetting
false

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled
false

ejbserver.container.bmp.backcompatible
false

ejbserver.container.ejbhome.sessionbean.reconnect.enabled
false

ejbserver.container.rebindpolicy
VB_TRANSPARENT

ejbserver.container.security.disabled
false

ejbserver.ctm.CTMDomain
CTMDOMAIN

ejbserver.ctm.CTMMyHost
<hostnameコマンドで取得されるホスト名称>

ejbserver.ctm.enabled
true

ejbserver.deploy.app.stopforcibly.disabled
false

ejbserver.deploy.exclusive.lockAliveInterval
60

ejbserver.deploy.stub.generation.scope
ejb

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout
-1

ejbserver.ejb.cmp20.cmr.use.existing_table
false

ejbserver.jndi.cache.reference
off

ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled
true

ejbserver.manager.agent.Agent.conf※1
なし

ejbserver.manager.agent.Agent.enabled※1
false

ejbserver.manager.jp1event.event_server_name
localhost

ejbserver.naming.exec.args
なし

ejbserver.naming.nameroot
なし

ejbserver.naming.protocol
corbaname

ejbserver.rmi.stateless.unique_id.enabled
false

ejbserver.server.mutex.invocation.timeout
45

vbroker.agent.enableLocator※2
false

vbroker.orb.htc.comt.entryCount
120000

vbroker.orb.htc.comt.fileCount
3

vbroker.orb.htc.tracePath

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

webserver.connector.ajp12.backlog※3
なし

webserver.connector.ajp12.max_threads※3
なし

webserver.connector.ajp12.port※3
なし

webserver.connector.inprocess_http.hostname_lookups
false

webserver.errorpage.stack_trace.enabled
false

webserver.jsp.precompile.jsp_work_dir
cosminexus_jsp_work

webserver.logger.communication_trace.inprocess_http.filenum
16

webserver.logger.thread_trace.inprocess_http.filenum
16

webserver.session.max.log_interval
60

webserver.session.server_id.enabled
true

webserver.sfo.negotiation.ignore_serverId
false

注

param-valueに値を複数指定する際は，複数の<param-value>を指定します。

（例）

<param-name>パラメタ名</param-name>

<param-value>値</param-value>

<param-value>値</param-value>

注※1

Management Serverが自動で設定するため，指定は非推奨です。

注※2

通常は設定不要です。

注※3

旧バージョンとの互換性を保つためのパラメタです。

参考

なお，表14-51に示すパラメタは，次の形式で指定することもできます。

指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

<param-value>パラメタ名=値</param-value>

14.5.4　J2EEサーバの拡張パラメタ

J2EEサーバの拡張パラメタを設定するパラメタについて，次の表に示します。なお，「param-value指定値」に指定する値の詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（J2EEサーバ用オプション定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

J2EEサーバの拡張パラメタを指定する場合の指定形式を次に示します。

指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>
<param-value>値</param-value>

表14-52　J2EEサーバの拡張パラメタに設定できるパラメタ

param-name指定値 | 省略値
add.class.path | なし
add.library.path | なし
batch.service.enabled※1 | false
cpp.library.version | 5
ejb.server.corefilenum※2 | 1
ejb.server.log.mode | なし
ejb.server.log.stderr.filesize | 1048576
ejb.server.log.stdout.filesize | 1048576
jvm.type | server

注

param-valueに値を複数指定する際は，複数の<param-value>を指定します。

（例）

<param-name>パラメタ名</param-name>

<param-value>値</param-value>

<param-value>値</param-value>

注※1

batch.service.enabledパラメタにtrueを指定しないでください。なお，デフォルトではfalseになっています。また，このパラメタはWebシステムの初期構築時だけ指定できます。Webシステムの構成変更では値を変更しないでください。

注※2

UNIX用のパラメタです。

参考

なお，表14-52に示すパラメタは，次の形式で指定することもできます。

指定形式

<param-name>ex.param</param-name>

<param-value>パラメタ名=値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>ex.param</param-name>

<param-value>パラメタ名=値</param-value>

<param-value>パラメタ名=値</param-value>

14.5.5　バッチサーバ用ユーザプロパティを設定するパラメタ

バッチサーバ用ユーザプロパティを設定するパラメタについて説明します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（バッチサーバ用ユーザプロパティファイル）についての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

なお，「param-valueの指定内容」が記載されているパラメタは，usrconf.properties（バッチサーバ用ユーザプロパティファイル）と指定方法が異なるパラメタです。

＜この項の構成＞

(1)　ejbserver.applicationから始まるパラメタ

(2)　ejbserver.batchから始まるパラメタ

(3)　ejbserver.clientから始まるパラメタ

(4)　ejbserver.connectionpoolから始まるパラメタ

(5)　ejbserver.connectorから始まるパラメタ

(6)　ejbserver.containerから始まるパラメタ

(7)　ejbserver.deployから始まるパラメタ

(8)　ejbserver.extから始まるパラメタ

(9)　ejbserver.httpから始まるパラメタ

(10)　ejbserver.instrumentationから始まるパラメタ

(11)　ejbserver.jndiから始まるパラメタ

(12)　ejbserver.jtaから始まるパラメタ

(13)　ejbserver.loggerから始まるパラメタ

(14)　ejbserver.managementから始まるパラメタ

(15)　ejbserver.managerから始まるパラメタ

(16)　ejbserver.namingから始まるパラメタ

(17)　ejbserver.rmiから始まるパラメタ

(18)　ejbserver.serverから始まるパラメタ

(19)　ejbserver.watchから始まるパラメタ

(20)　javaから始まるパラメタ

(21)　vbrokerから始まるパラメタ

(22)　webserver.connectorから始まるパラメタ

(1)　ejbserver.applicationから始まるパラメタ

ejbserver.applicationから始まるパラメタについて次の表に示します。

表14-53　ejbserver.applicationから始まるパラメタ

param-name指定値 | 省略値
ejbserver.application.InitTermProcessClasses※1 | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname | user_app
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count | 2
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter | なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level | SEVERE
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit | 1048576
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid | 0001
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path | user_log
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator | ｜
ejbserver.application.userlog.Logger.<ロガー名称>.filter | なし
ejbserver.application.userlog.Logger.<ロガー名称>.handlers※1 | なし
ejbserver.application.userlog.Logger.<ロガー名称>.level | SEVERE
ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers | true
ejbserver.application.userlog.loggers※1 | なし
ejbserver.application.userlog.menu.handlers.※1 ※2 | なし

注※1

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

注※2

このパラメタには，ハンドラの名称一覧を指定します。

このパラメタからハンドラ名を削除する場合は，関連するパラメタ（ejbserver.application.userlog.CJLogHandler.<削除するハンドラ名称>.XXX）も削除してください。

なお，このパラメタに対応するキーはマニュアル「Cosminexus　リファレンス　定義編」にはありません。

(2)　ejbserver.batchから始まるパラメタ

ejbserver.batchから始まるパラメタについて次の表に示します。

表14-54　ejbserver.batchから始まるパラメタ

param-name指定値 | 省略値
ejbserver.batch.gc.watch.threshold | 0

(3)　ejbserver.clientから始まるパラメタ

ejbserver.clientから始まるパラメタについて次の表に示します。

表14-55　ejbserver.clientから始まるパラメタ

param-name指定値 | 省略値
ejbserver.client.ctm.RequestPriority | 4

(4)　ejbserver.connectionpoolから始まるパラメタ

ejbserver.connectionpoolから始まるパラメタについて次の表に示します。

表14-56　ejbserver.connectionpoolから始まるパラメタ

param-name指定値 | 省略値
ejbserver.connectionpool.association.enabled | false

(5)　ejbserver.connectorから始まるパラメタ

ejbserver.connectorから始まるパラメタについて次の表に示します。

表14-57　ejbserver.connectorから始まるパラメタ

param-name指定値 | 省略値
ejbserver.connector.logwriter.filenum | 4
ejbserver.connector.logwriter.filesize | 2097152

(6)　ejbserver.containerから始まるパラメタ

ejbserver.connectorから始まるパラメタについて次の表に示します。

表14-58　ejbserver.connectorから始まるパラメタ

param-name指定値 | 省略値
ejbserver.container.audit_trail.enabled | false

(7)　ejbserver.deployから始まるパラメタ

ejbserver.deployから始まるパラメタについて次の表に示します。

表14-59　ejbserver.deployから始まるパラメタ

param-name指定値 | 省略値
ejbserver.deploy.resourcefile.scramble.enabled | false

(8)　ejbserver.extから始まるパラメタ

ejbserver.extから始まるパラメタについて次の表に示します。

表14-60　ejbserver.extから始まるパラメタ

param-name指定値 | 省略値
ejbserver.ext.method_observation.interval | 0

(9)　ejbserver.httpから始まるパラメタ

ejbserver.httpから始まるパラメタについて次の表に示します。

表14-61　ejbserver.httpから始まるパラメタ

param-name指定値 | 省略値
ejbserver.http.port | 8080

(10)　ejbserver.instrumentationから始まるパラメタ

ejbserver.instrumentationから始まるパラメタについて次の表に示します。

表14-62　ejbserver.instrumentationから始まるパラメタ

param-name指定値 | 省略値
ejbserver.instrumentation.enabled | true

(11)　ejbserver.jndiから始まるパラメタ

ejbserver.jndiから始まるパラメタについて次の表に示します。

表14-63　ejbserver.jndiから始まるパラメタ

param-name指定値 | 省略値
ejbserver.jndi.cache | on
ejbserver.jndi.cache.interval | 0
ejbserver.jndi.cache.interval.clear.option | refresh
ejbserver.jndi.namingservice.group.<Specify group name>.providerurls | なし
ejbserver.jndi.namingservice.group.list | なし
ejbserver.jndi.request.timeout | 0

(12)　ejbserver.jtaから始まるパラメタ

ejbserver.jtaから始まるパラメタについて次の表に示します。

表14-64　ejbserver.jtaから始まるパラメタ

param-name指定値 | 省略値
ejbserver.jta.TransactionManager.defaultTimeOut | 180

(13)　ejbserver.loggerから始まるパラメタ

ejbserver.loggerから始まるパラメタについて次の表に示します。

表14-65　ejbserver.loggerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ConsoleLogFile.filenum | 2
ejbserver.logger.channels.define.ConsoleLogFile.filesize | 1048576
ejbserver.logger.channels.define.EJBContainerLogFile.filenum | 2
ejbserver.logger.channels.define.EJBContainerLogFile.filesize | 1048576
ejbserver.logger.channels.define.ExceptionLogFile.filenum | 2
ejbserver.logger.channels.define.ExceptionLogFile.filesize | 1048576
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filenum | 2
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.MaintenanceLogFile.filenum | 4
ejbserver.logger.channels.define.MaintenanceLogFile.filesize | 16777216
ejbserver.logger.channels.define.MemoryWatchLogFile.filenum | 2
ejbserver.logger.channels.define.MemoryWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.MessageLogFile.filenum | 2
ejbserver.logger.channels.define.MessageLogFile.filesize | 1048576
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ThreadWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreadWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.UserErrLogFile.filenum | 2
ejbserver.logger.channels.define.UserErrLogFile.filesize | 1048576
ejbserver.logger.channels.define.UserOutLogFile.filenum | 2
ejbserver.logger.channels.define.UserOutLogFile.filesize | 1048576
ejbserver.logger.enabled.* | Error，Warning

(14)　ejbserver.managementから始まるパラメタ

ejbserver.managementから始まるパラメタについて次の表に示します。

表14-66　ejbserver.managementから始まるパラメタ

param-name指定値
省略値

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled
true

ejbserver.management.JVM.stats_monitor.FullGCCount.interval
600

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold
10

ejbserver.management.statistics.interval
60

ejbserver.management.stats_file.base_time
0

ejbserver.management.stats_file.dir

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats

ejbserver.management.stats_file.enabled
true

ejbserver.management.stats_file.num
7

ejbserver.management.stats_file.period
24

(15)　ejbserver.managerから始まるパラメタ

ejbserver.managerから始まるパラメタについて次の表に示します。

表14-67　ejbserver.managerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.manager.agent.JP1EventAgent.conf | なし
ejbserver.manager.agent.JP1EventAgent.enabled | false
ejbserver.manager.agent.MEventAgent.conf | なし
ejbserver.manager.agent.MEventAgent.enabled | true

(16)　ejbserver.namingから始まるパラメタ

ejbserver.namingから始まるパラメタについて次の表に示します。

表14-68　ejbserver.namingから始まるパラメタ

param-name指定値 | 省略値
ejbserver.naming.host | バッチサーバと同じホスト
ejbserver.naming.port※ | 900
ejbserver.naming.startupRetryCount※ | 9
ejbserver.naming.startupWaitTime※ | 1

注※

ejbserver.naming.startupModeに「inprocess」以外を指定した場合，指定は無視されます。

(17)　ejbserver.rmiから始まるパラメタ

ejbserver.rmiから始まるパラメタについて次の表に示します。

表14-69　ejbserver.rmiから始まるパラメタ

param-name指定値 | 省略値
ejbserver.rmi.naming.host | なし
ejbserver.rmi.naming.port | 23152
ejbserver.rmi.remote.listener.port | 0
ejbserver.rmi.request.timeout | 0

(18)　ejbserver.serverから始まるパラメタ

ejbserver.serverから始まるパラメタについて次の表に示します。

表14-70　ejbserver.serverから始まるパラメタ

param-name指定値 | 省略値
ejbserver.server.prf.PRFID | なし
ejbserver.server.threaddump.filenum | 256

(19)　ejbserver.watchから始まるパラメタ

ejbserver.watchから始まるパラメタについて次の表に示します。

表14-71　ejbserver.watchから始まるパラメタ

param-name指定値 | 省略値
ejbserver.watch.enabled | true
ejbserver.watch.fileDescriptor.enabled | true
ejbserver.watch.fileDescriptor.interval | 60
ejbserver.watch.fileDescriptor.threshold | 2147483647
ejbserver.watch.fileDescriptor.writefile.enabled | true
ejbserver.watch.memory.enabled | true
ejbserver.watch.memory.interval | 60
ejbserver.watch.memory.threshold | 80
ejbserver.watch.memory.writefile.enabled | true
ejbserver.watch.thread.enabled | true
ejbserver.watch.thread.interval | 60
ejbserver.watch.thread.threshold | 2147483647
ejbserver.watch.thread.writefile.enabled | true
ejbserver.watch.threaddump.enabled | true
ejbserver.watch.threaddump.interval | 30
ejbserver.watch.threaddump.threshold | 80
ejbserver.watch.threaddump.writefile.enabled | true

(20)　javaから始まるパラメタ

javaから始まるパラメタについて次の表に示します。

表14-72　javaから始まるパラメタ

param-name指定値 | 省略値
java.naming.factory.initial | com.hitachi.software.ejb.jndi.InsContextFactory

(21)　vbrokerから始まるパラメタ

vbrokerから始まるパラメタについて次の表に示します。

表14-73　vbrokerから始まるパラメタ

param-name指定値 | 省略値
vbroker.agent.port | 14000
vbroker.se.iiop_tp.host | なし
vbroker.se.iiop_tp.scm.iiop_tp.listener.port | 0

(22)　webserver.connectorから始まるパラメタ

webserver.connectorから始まるパラメタについて次の表に示します。

表14-74　webserver.connectorから始まるパラメタ

param-name指定値 | 省略値
webserver.connector.ajp13.bind_host | なし
webserver.connector.ajp13.port | 8007
webserver.connector.http.bind_host | なし
webserver.connector.http.permitted.hosts※ | なし

注※

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

14.5.6　バッチサーバ用オプション定義を設定するパラメタ

バッチサーバ用オプション定義を設定するパラメタについて，次の表に示します。なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（バッチサーバ用オプション定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-75　バッチサーバ用オプション定義を設定するパラメタ

param-name指定値
省略値

add.jvm.arg※
なし

ejb.public.directory

Windowsの場合

&{cosminexus.home}¥CC¥server¥public

UNIXの場合

&{cosminexus.home}/CC/server/public

ejb.server.log.directory

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs

注※

値の指定形式について，次に示します。

（例）

<param-name>add.jvm.arg</param-name>

　 <param-value>-Xms256m</param-value>

<param-value>-Xmx512m</param-value>

　　　　　　　　　　　　　　：

14.5.7　バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ

バッチサーバのJavaVMのシステムプロパティを設定するパラメタについて，次の表に示します。なお，「param-value指定値」に指定する値の詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（バッチサーバ用ユーザプロパティファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-76　バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ

param-name指定値
省略値

ejbserver.connectionpool.applicationAuthentication.disabled
false

ejbserver.connectionpool.sharingOutsideTransactionScope.enabled
false

ejbserver.deploy.exclusive.lockAliveInterval
60

ejbserver.jndi.cache.reference
off

ejbserver.manager.agent.Agent.conf※1
なし

ejbserver.manager.agent.Agent.enabled※1
false

ejbserver.manager.jp1event.event_server_name
localhost

ejbserver.naming.nameroot
なし

vbroker.agent.enableLocator※2
false

vbroker.orb.htc.comt.entryCount
120000

vbroker.orb.htc.comt.fileCount
3

vbroker.orb.htc.tracePath

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

注

param-valueに値を複数指定する際は，複数の<param-value>を指定します。

（例）

<param-name>パラメタ名</param-name>

<param-value>値</param-value>

<param-value>値</param-value>

注※1

Management Serverが自動で設定するため，指定は非推奨です。

注※2

通常は設定不要です。

参考

表14-76に示すパラメタは，次の形式で指定することもできます。

指定形式

<param-name>パラメタ名</param-name>

<param-value>パラメタ名=値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

<param-value>パラメタ名=値</param-value>

14.5.8　バッチサーバの拡張パラメタ

バッチサーバの拡張パラメタを設定するパラメタについて，次の表に示します。バッチサーバの場合，batch.service.enabledパラメタは必ず指定してください。パラメタの値にはtrueを指定します。

なお，「param-value指定値」に指定する値の詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（バッチサーバ用オプション定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-77　バッチサーバの拡張パラメタ

param-name指定値 | 省略値
add.class.path | なし
add.library.path | なし
batch.service.enabled※1 | false
cpp.library.version | 5
ejb.server.corefilenum※2 | 1
ejb.server.log.mode | なし
ejb.server.log.stderr.filesize | 1048576
ejb.server.log.stdout.filesize | 1048576
jvm.type | server

注

param-valueに値を複数指定する際は，複数の<param-value>を指定します。

（例）

<param-name>パラメタ名</param-name>

<param-value>値</param-value>

<param-value>値</param-value>

注※1

batch.service.enabledパラメタは必ず指定してください。設定値にはtrueを指定します。パラメタの指定を省略するとfalseが設定されます。また，このパラメタはWebシステムの初期構築時だけ指定できます。Webシステムの構成変更では値を変更しないでください。

注※2

UNIX用のパラメタです。

参考

なお，表14-77に示すパラメタは，次の形式で指定することもできます。

指定形式

<param-name>パラメタ名</param-name>

<param-value>パラメタ名=値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

<param-value>パラメタ名=値</param-value>

14.5.9　運用監視エージェントプロパティを設定するパラメタ

運用監視エージェントプロパティを設定するパラメタについて次の表に示します。これらのパラメタはJ2EEサーバおよびバッチサーバで指定できます。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のmngagent.<実サーバ名>.properties （運用監視エージェントプロパティファイル）についての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-78　運用監視エージェントプロパティを設定するパラメタ

param-name指定値 | 省略値
mngagent.connector.host | vbroker.se.iiop_tp.hostに定義された値
mngagent.connector.port | vbroker.se.iiop_tp.scm.iiop_tp.listener.portに定義された値
mngagent.log.filesize | 65536

14.5.10　Managementイベント発行用プロパティを設定するパラメタ

Managementイベント発行用プロパティを設定するパラメタについて次の表に示します。これらのパラメタはJ2EEサーバおよびバッチサーバで指定できます。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のManagementイベント発行用プロパティファイルについての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-79　Managementイベント発行用プロパティ設定するパラメタ

param-name指定値 | 省略値
manager.mevent.message_id.list | なし
manager.mevent.retry.interval | 10
manager.mevent.retry.limit | 0
manager.mevent.send.max | 10
manager.mevent.send.timeout | 90
manager.mevent.sender.bind.host | なし

14.5.11　JP1連携を設定するパラメタ

JP1連携を設定するパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。これらのパラメタはJ2EEサーバおよびバッチサーバで指定できます。

表14-80　JP1連携を設定するパラメタ

param-name指定値
param-valueの指定内容
省略値

manager.jp1event.system.filtering.severity.alert
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Alert」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.critical
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Critical」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.emergency
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Emergency」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.error
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Error」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.information
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Information」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.notice
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Notice」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.warning
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Warning」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.user.filtering.enabled
ユーザJP1イベントをフィルタリングするかどうかを指定します。次のどちらかを指定します。

true：

フィルタリングします。

false：

フィルタリングしません。

false

manager.jp1event.user.filtering.filter
ユーザJP1イベントのフィルタを指定します。指定した文字列中の¥nは改行に変換されます。
なし

manager.jp1event.user.mapping.level.config
ユーザJP1イベントのマッピングのログレベル「CONFIG」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

manager.jp1event.user.mapping.level.fine
ユーザJP1イベントのマッピングのログレベル「FINE」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

manager.jp1event.user.mapping.level.finer
ユーザJP1イベントのマッピングのログレベル「FINER」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

manager.jp1event.user.mapping.level.finest
ユーザJP1イベントのマッピングのログレベル「FINEST」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

manager.jp1event.user.mapping.level.info
ユーザJP1イベントのマッピングのログレベル「INFO」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

manager.jp1event.user.mapping.level.severe
ユーザJP1イベントのマッピングのログレベル「SEVERE」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません
なし

manager.jp1event.user.mapping.level.warning
ユーザJP1イベントのマッピングのログレベル「WARNING」に対するJP1イベント重大度を指定します。次のどれかを指定します。

Emergency：

緊急

Alert：

警戒

Critical：

致命的

Error：

エラー

Warning：

警告

Notice：

通知

Information：

情報

指定しない場合，JP1イベントは発行されません。
なし

14.5.12　SecurityManagerの使用を設定するパラメタ

SecurityManagerの使用を設定するパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。このパラメタはJ2EEサーバおよびバッチサーバで指定できます。

表14-81　SecurityManagerの使用を設定するパラメタ

param-name指定値
param-valueの指定内容
省略値

use.security
J2EEサーバまたはバッチサーバの起動オプションにSecurityManagerを使用するかどうかを指定します。次のどちらかを指定します。

true：

使用します。

false：

使用しません。

なお，バッチサーバで指定する場合は必ず「false」を指定してください。
true

14.6　論理パフォーマンストレーサで指定できるパラメタ

ここでは，論理パフォーマンストレーサで指定できるパラメタについて説明します。

論理パフォーマンストレーサで指定できるパラメタについて次の表に示します。なお，表中の「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-82　論理パフォーマンストレーサに設定できるパラメタ

param-name指定値
param-valueの指定内容
省略値

PRFID
PRF識別子を31文字以内で指定します。
PRF_ID

prfspool
PRFトレース出力ディレクトリを256文字以内で指定します。
Windowsの場合，ここで指定する値は，システム環境変数PRFSPOOLで指定された値と一致している必要があります。
&{cosminexus.home}/PRF/spool

PrfTraceBufferSize
パフォーマンストレーサのバッファメモリサイズを512～102400の範囲（単位：キロバイト）で指定します。
PrfTraceFileSize≧ PrfTraceBufferSizeの関係が成り立つ値を設定してください。
8192

PrfTraceCount
パフォーマンストレーサのファイル面数を指定します。
指定できる値は，4，16，32，64，128，256です。
4

PrfTraceFileSize
パフォーマンストレーサのファイルサイズをキロバイト単位で指定します。
指定できる値は，1024，4096，8192，16384，32768，65536，131072，262144，524288，1048576です。
PrfTraceFileSize ≧ PrfTraceBufferSizeの関係が成り立つ値を設定してください。
32768

PrfTraceLevel
パフォーマンストレーサのトレース取得レベルを指定します。次のどれかを設定してください。

STANDARD：

標準

DETAIL：

詳細

任意のトレース取得レベル値：

指定できる値については，マニュアル「Cosminexus　リファレンス　コマンド編」の，cprfstartコマンドの引数-PrfTraceLevelの説明を参照してください。

STANDARD

14.7　論理SFOサーバで指定できるパラメタ

ここでは，論理SFOサーバで指定できるパラメタについて説明します。

＜この節の構成＞

14.7.1　SFOサーバ用ユーザプロパティを設定するパラメタ

14.7.2　SFOサーバ用オプション定義を設定するパラメタ

14.7.3　SFOサーバのJavaVMのシステムプロパティに設定できるパラメタ

14.7.4　SFOサーバの拡張パラメタ

14.7.5　運用監視エージェントプロパティを設定するパラメタ

14.7.6　Managementイベント発行用プロパティを設定するパラメタ

14.7.7　JP1連携を設定するパラメタ

14.7.1　SFOサーバ用ユーザプロパティを設定するパラメタ

SFOサーバ用ユーザプロパティを設定するパラメタについて説明します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）についての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

なお，「param-valueの指定内容」が記載されているパラメタは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）と指定方法が異なるパラメタです。

＜この項の構成＞

(1)　ejbserver.containerから始まるパラメタ

(2)　ejbserver.httpから始まるパラメタ

(3)　ejbserver.instrumentationから始まるパラメタ

(4)　ejbserver.loggerから始まるパラメタ

(5)　ejbserver.managementから始まるパラメタ

(6)　ejbserver.managerから始まるパラメタ

(7)　ejbserver.namingから始まるパラメタ

(8)　ejbserver.rmiから始まるパラメタ

(9)　ejbserver.serverから始まるパラメタ

(10)　ejbserver.watchから始まるパラメタ

(11)　vbrokerから始まるパラメタ

(12)　webserver.connectorから始まるパラメタ

(1)　ejbserver.containerから始まるパラメタ

ejbserver.containerから始まるパラメタについて次の表に示します。

表14-83　ejbserver.containerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.container.remove.scan.interval | 5

(2)　ejbserver.httpから始まるパラメタ

ejbserver.httpから始まるパラメタについて次の表に示します。

表14-84　ejbserver.httpから始まるパラメタ

param-name指定値 | 省略値
ejbserver.http.port | 8080

(3)　ejbserver.instrumentationから始まるパラメタ

ejbserver.instrumentationから始まるパラメタについて次の表に示します。

表14-85　ejbserver.instrumentationから始まるパラメタ

param-name指定値 | 省略値
ejbserver.instrumentation.enabled | true

(4)　ejbserver.loggerから始まるパラメタ

ejbserver.loggerから始まるパラメタについて次の表に示します。

表14-86　ejbserver.loggerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.logger.channels.define.ConsoleLogFile.filenum | 2
ejbserver.logger.channels.define.ConsoleLogFile.filesize | 1048576
ejbserver.logger.channels.define.EJBContainerLogFile.filenum | 2
ejbserver.logger.channels.define.EJBContainerLogFile.filesize | 1048576
ejbserver.logger.channels.define.ExceptionLogFile.filenum | 2
ejbserver.logger.channels.define.ExceptionLogFile.filesize | 1048576
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filenum | 2
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.hreadWatchLogFile.filenum | 2
ejbserver.logger.channels.define.MaintenanceLogFile.filenum | 4
ejbserver.logger.channels.define.MaintenanceLogFile.filesize | 16777216
ejbserver.logger.channels.define.MemoryWatchLogFile.filenum | 2
ejbserver.logger.channels.define.MemoryWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.MessageLogFile.filenum | 2
ejbserver.logger.channels.define.MessageLogFile.filesize | 1048576
ejbserver.logger.channels.define.RequestQueueWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filenum | 2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filesize | 1048576
ejbserver.logger.channels.define.ThreadWatchLogFile.filesize | 1048576
ejbserver.logger.enabled.* | Error，Warning
ejbserver.logger.systemlog.enabled | true

(5)　ejbserver.managementから始まるパラメタ

ejbserver.managementから始まるパラメタについて次の表に示します。

表14-87　ejbserver.managementから始まるパラメタ

param-name指定値
省略値

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled
true

ejbserver.management.JVM.stats_monitor.FullGCCount.interval
600

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold
10

ejbserver.management.statistics.interval
60

ejbserver.management.stats_file.base_time
0

ejbserver.management.stats_file.dir

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥stats

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats

ejbserver.management.stats_file.enabled
true

ejbserver.management.stats_file.num
7

ejbserver.management.stats_file.period
24

(6)　ejbserver.managerから始まるパラメタ

ejbserver.managerから始まるパラメタについて次の表に示します。

表14-88　ejbserver.managerから始まるパラメタ

param-name指定値 | 省略値
ejbserver.manager.agent.JP1EventAgent.conf | なし
ejbserver.manager.agent.JP1EventAgent.enabled | false
ejbserver.manager.agent.MEventAgent.conf | なし
ejbserver.manager.agent.MEventAgent.enabled | true

(7)　ejbserver.namingから始まるパラメタ

ejbserver.namingから始まるパラメタについて次の表に示します。

表14-89　ejbserver.namingから始まるパラメタ

param-name指定値 | 省略値
ejbserver.naming.port | 900

(8)　ejbserver.rmiから始まるパラメタ

ejbserver.rmiから始まるパラメタについて次の表に示します。

表14-90　ejbserver.rmiから始まるパラメタ

param-name指定値 | 省略値
ejbserver.rmi.naming.host | なし
ejbserver.rmi.naming.port | 23152
ejbserver.rmi.remote.listener.port | 0

(9)　ejbserver.serverから始まるパラメタ

ejbserver.serverから始まるパラメタについて次の表に示します。

表14-91　ejbserver.serverから始まるパラメタ

param-name指定値 | 省略値
ejbserver.server.prf.PRFID | なし
ejbserver.server.threaddump.filenum | 256

(10)　ejbserver.watchから始まるパラメタ

ejbserver.watchから始まるパラメタについて次の表に示します。

表14-92　ejbserver.watchから始まるパラメタ

param-name指定値 | 省略値
ejbserver.watch.defaultRequestQueue.enabled | true
ejbserver.watch.defaultRequestQueue.interval | 30
ejbserver.watch.defaultRequestQueue.threshold | 80
ejbserver.watch.defaultRequestQueue.writefile.enabled | true
ejbserver.watch.enabled | true
ejbserver.watch.fileDescriptor.enabled | true
ejbserver.watch.fileDescriptor.interval | 60
ejbserver.watch.fileDescriptor.threshold | 2147483647
ejbserver.watch.fileDescriptor.writefile.enabled | true
ejbserver.watch.memory.enabled | true
ejbserver.watch.memory.interval | 60
ejbserver.watch.memory.threshold | 80
ejbserver.watch.memory.writefile.enabled | true
ejbserver.watch.thread.enabled | true
ejbserver.watch.thread.interval | 60
ejbserver.watch.thread.threshold | 2147483647
ejbserver.watch.thread.writefile.enabled | true
ejbserver.watch.threaddump.enabled | true
ejbserver.watch.threaddump.interval | 30
ejbserver.watch.threaddump.threshold | 80
ejbserver.watch.threaddump.writefile.enabled | true

(11)　vbrokerから始まるパラメタ

vbrokerから始まるパラメタについて次の表に示します。

表14-93　vbrokerから始まるパラメタ

param-name指定値 | 省略値
vbroker.orb.htc.comt.entryCount | 120000
vbroker.se.iiop_tp.host | なし
vbroker.se.iiop_tp.scm.iiop_tp.listener.port | 0

(12)　webserver.connectorから始まるパラメタ

webserver.connectorから始まるパラメタについて次の表に示します。

表14-94　webserver.connectorから始まるパラメタ

param-name指定値 | 省略値
webserver.connector.ajp13.bind_host | なし
webserver.connector.ajp13.max_threads | 10
webserver.connector.ajp13.port | 8007
webserver.connector.http.bind_host | なし
webserver.connector.http.permitted.hosts※ | なし

注※

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

14.7.2　SFOサーバ用オプション定義を設定するパラメタ

SFOサーバ用オプション定義を設定するパラメタについて，次の表に示します。なお，「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.cfg（J2EEサーバ用オプション定義ファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-95　SFOサーバ用オプション定義を設定するパラメタ

param-name指定値 | 省略値
add.jvm.arg※ | なし

注※

値の指定形式について，次に示します。

（例）

<param-name>add.jvm.arg</param-name>

　 <param-value>-Xms256m</param-value>

<param-value>-Xmx512m</param-value>

　　　　　　　　　　　　　　：

14.7.3　SFOサーバのJavaVMのシステムプロパティに設定できるパラメタ

SFOサーバのJavaVMのシステムプロパティを設定するパラメタについて説明します。

SFOサーバのJavaVMのシステムプロパティを指定する場合の指定形式を次に示します。

指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>
<param-value>値</param-value>

SFOサーバのJavaVMのシステムプロパティを設定するパラメタについて，次の表に示します。なお，「param-value指定値」に指定する値の詳細については，マニュアル「Cosminexus　リファレンス　定義編」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）についての説明を参照してください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-96　SFOサーバのJavaVMのシステムプロパティに設定できるパラメタ

param-name指定値
省略値

ejbserver.ctm.enabled
true

ejbserver.manager.agent.Agent.conf※
なし

ejbserver.manager.agent.Agent.enabled※
false

vbroker.orb.htc.comt.fileCount
3

vbroker.orb.htc.tracePath

Windowsの場合

<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥logs¥TPB¥logj

UNIXの場合

<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj

webserver.sfo.negotiation.ignore_serverId
false

注※

Management Serverが自動で設定するため，指定は非推奨です。

参考

なお，表14-96に示すパラメタは，次の形式で指定することもできます。

指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>ex.properties</param-name>

<param-value>パラメタ名=値</param-value>

<param-value>パラメタ名=値</param-value>

14.7.4　SFOサーバの拡張パラメタ

SFOサーバの拡張パラメタを設定するパラメタについて説明します。

SFOサーバの拡張パラメタを指定する場合の指定形式を次に示します。

指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>

値を複数指定する際には，複数の<param-value>を指定します。

値を複数指定する場合の指定形式

<param-name>パラメタ名</param-name>
<param-value>値</param-value>
<param-value>値</param-value>

14.7.5　運用監視エージェントプロパティを設定するパラメタ

運用監視エージェントプロパティを設定するパラメタについて次の表に示します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のmngagent.<実サーバ名>.properties （運用監視エージェントプロパティファイル）についての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-97　運用監視エージェントプロパティを設定するパラメタ

param-name指定値 | 省略値
mngagent.connector.host | vbroker.se.iiop_tp.hostに定義された値
mngagent.connector.port | vbroker.se.iiop_tp.scm.iiop_tp.listener.portに定義された値

14.7.6　Managementイベント発行用プロパティを設定するパラメタ

Managementイベント発行用プロパティを設定するパラメタについて次の表に示します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」のManagementイベント発行用プロパティファイルについての説明を参照してください。マニュアル「Cosminexus　リファレンス　定義編」を参照する場合は，キーをパラメタに読み替えてください。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-98　Managementイベント発行用プロパティを設定するパラメタ

param-name指定値 | 省略値
manager.mevent.message_id.list | なし
manager.mevent.retry.interval | 10
manager.mevent.retry.limit | 0
manager.mevent.send.max | 10
manager.mevent.send.timeout | 90
manager.mevent.sender.bind.host | なし

14.7.7　JP1連携を設定するパラメタ

JP1連携を設定するパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-99　JP1連携を設定するパラメタ

param-name指定値
param-valueの指定内容
省略値

manager.jp1event.system.filtering.severity.alert
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Alert」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.critical
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Critical」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.emergency
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Emergency」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.error
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Error」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.information
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Information」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.notice
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Notice」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

manager.jp1event.system.filtering.severity.warning
システムが発行するJP1イベントのフィルタリングを設定する項目です。
JP1イベント重大度「Warning」を発行するかどうかを指定します。次のどちらかを指定します。

true：

発行します。

false：

発行しません。

false

14.8　論理CTMドメインマネジャで指定できるパラメタ

ここでは，論理CTMドメインマネジャで指定できるパラメタについて説明します。

論理CTMドメインマネジャで指定できるパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-100　論理CTMドメインマネジャに設定できるパラメタ

param-name指定値
param-valueの指定内容
省略値

cdm.agent.port
スマートエージェントのポート番号を指定します。
このパラメタは，free-tierの場合にだけ使用します。
14000

cdm.AliveCheckCount
CTMドメインマネジャ間の稼働状態の監視間隔の係数を，2～255の範囲の整数で指定します。
2

cdm.port
CTMドメインマネジャがCTMドメイン構成情報を交換するために使用するポート番号を5001～65535の範囲の整数で指定します。
20137

cdm.prf.PRFID
PRF識別子を指定します。
PRFデーモン起動時にPRF識別子を指定した場合に，同じPRF識別子を指定します。
PRFデーモン起動時にPRF識別子を省略した場合は，指定しないでください。PRF識別子が一致しないと，性能解析トレースが取得できません。
このパラメタは，free-tierの場合にだけ使用します。
なし

cdm.SendHost※
CTMドメイン構成情報の配布先となる，異なるネットワークセグメントにあるCTMドメインマネジャが動作するホストのIPアドレスを指定します。このとき指定するIPアドレスは，ホストの定義の<host-name>タグで指定するIPアドレスです。
この指定によって，複数のネットワークセグメントで構成したCTMドメインで，CTM構成情報を配布できるようになります。
なし

cdm.SendHostInterval
cdm.SendHostで指定したホストに対してCTMドメイン構成情報を送信する間隔を0～65535の範囲の整数（単位：秒）で指定します。
なお，指定しない場合は，ブロードキャスト間隔と同じであることを示します。0を指定した場合は送信しないことを示します。
なし

cdm.SendInterval
CTMドメインマネジャがCTMドメイン構成情報をネットワークセグメント内にブロードキャストする間隔を0～65535の範囲の整数（単位：秒）で指定します。0は送信しないことを表します。
60

cdm.SubnetMask
ネットワークのサブネットマスクを指定します。
255.255.255.0

ctmdomname
CTMドメインマネジャが属するCTMドメイン名称を31文字以内で指定します。使用できる文字は英数字，アンダースコア(_)です。「CTMDOMAIN」以外の，「CTM」または「ctm」で始まる文字列は指定しないでください。
同一ホスト内でユニークな名称にする必要があります。
CTMDOMAIN

ctmspool
CTM実行環境ディレクトリを指定します。ファイルセパレータには「/」を使用します。
&{cosminexus.home}/CTM/spool

注※

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）

<param-value>値1,値2,値3</param-value>

14.9　論理CTMで指定できるパラメタ

ここでは，論理CTMで指定できるパラメタについて説明します。

論理CTMで指定できるパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-101　論理CTMに設定できるパラメタ

param-name指定値
param-valueの指定内容
省略値

ctm.Agent
CTMレギュレータのORBゲートウェイ機能を使用するかどうかを指定します。次のどちらかを指定します。

1：

使用します。

0：

使用しません。

0

ctm.cdm
利用するCTMドメインマネジャの論理サーバ名を指定します。同一ホスト内のCTMドメインマネジャを指定してください。
CTMDOMAIN

ctm.CreatePolicy
create要求のCTMノード選択ポリシーを選択します。次のどちらかを指定します。

normalDispatch：

スケジュールキューの負荷状況に応じてCTMデーモンを選択します。

priorDispatch：

create要求を受け付けたCTMデーモンを，優先的に選択します。ただし，そのCTMデーモンに登録されているスケジュールキューが高負荷状態，および閉塞状態の場合は，ほかのCTMデーモンを選択します。

normalDispatch

ctm.DCSendTimeOut
CTM間通信のリクエスト転送時のタイムアウト時間を0～2147483647の範囲の整数（単位：秒）で指定します。
0は設定しないことを表します。
180

ctm.DispatchParallelCount
自CTM内でクライアントからの要求メッセージをJ2EEサーバに振り分けるスレッドの最大値を0～32767の範囲の整数で指定します。
255

ctm.DispatchPolicy
リクエストのスケジュールポリシーを選択します。

normalDispatch：

スケジュールキューの負荷状況に応じてリクエストをスケジュールします。

priorDispatch：

リクエストを受け付けたCTMデーモンに登録されているスケジュールキューに，優先的にリクエストをスケジュールします。ただし，そのCTMデーモンに登録されているスケジュールキューが高負荷状態，および閉塞状態の場合は，ほかのCTMデーモンに登録しているスケジュールキューにリクエストをスケジュールします。

priorDispatch

ctm.EjbPort
EJBクライアントがCTMデーモンの新しいコネクションを探すときに使用するポート番号を5001～65535の範囲の整数で指定します。指定しない場合はOSが自動的に割り当てたポート番号を使用します。
自動

ctm.LoadCheckInterval
スケジュールキューの負荷状況を監視する時間間隔を0から32767の範囲の整数（単位：秒）で指定します。0は一定時間間隔での負荷状況監視を行わないことを表します。
10

ctm.LogFileCount
CTMログファイルの面数を指定します。
指定できる値は，2，4，8，16，24，32です。
2

ctm.LogFileSize
CTMログファイルの1ファイルの最大サイズを1～3の範囲の整数（単位：メガバイト）で指定します。
1

ctm.MaxRequestCount
CTMに登録するCTMキューが，同時に登録できるリクエスト数を1～32767の範囲の整数で指定します。
50

ctm.ns.port
CTMと対となるネーミングサービスのポート番号を1～65535の範囲の整数で指定します。
20348

ctm.NsBindHost
一つのマシンに複数のIPアドレスが割り当てられている場合に，特定のIPアドレスに割り当てるかどうかを指定します。次のどちらかを指定します。

true：

特定のIPアドレスに割り当てます。

false：

特定のIPアドレスに割り当てません。

false

ctm.port
CTMが使用するポート番号を5001～65535の範囲の整数で指定します。
20138

ctm.QueueCount
CTMに登録できるCTMキュー数を1～32767の範囲の整数で指定します。
128

ctm.QueueDeleteWait
異常終了したJ2EEサーバが登録していたCTMキューを削除しないで保留し，J2EEサーバの再開始を待つ場合の待ち時間を，0～2147483647の範囲の整数（単位：秒）で指定します。
0

ctm.QueueInterval
システム停止しきい値の処理率を求める時間間隔を1～32767の範囲の整数（単位：秒）で指定します。
なし

ctm.QueueRate
キュー滞留監視状態へ移行する滞留率のしきい値を0～99の範囲の整数（単位：％）で指定します。
なし

ctm.QueueRegistCount
同じCTMキューを共有できるJ2EEアプリケーション数を1～32767の範囲の整数で指定します。
64

ctm.RegOption
CTMレギュレータの設定ファイルを，CTM稼働ホストの絶対パス（256文字以内の文字列）で指定します。
なし

ctm.RegStart
CTM開始時に自動開始するCTMレギュレータのプロセス数を0～32767の範囲の整数で指定します。
1

ctm.RequestCount
何回タイムアウトが発生したら自動閉塞するかを1～32767の範囲の整数で指定します。
なし

ctm.RequestInterval
タイムアウト発生回数を求める時間間隔を1～32767の範囲の整数（単位：秒）で指定します。
なし

ctm.ServerCacheSize
CTMドメインの構成情報を格納するキャッシュテーブルのサイズを1～32767の範囲の整数（単位：キロバイト）で指定します。
1024

ctm.ServerConnectCount
CTMに接続するJ2EEサーバの最大数を0～32767の範囲の整数で指定します。
64

ctm.StatsFileCount
CTM稼働統計情報の世代数を指定します。
指定できる値は，3，4，16，32，64，128，256です。
3

ctm.StatsFileSize
CTM稼働統計情報のファイルのサイズをメガバイト単位で指定します。
指定できる値は，1，2，3，4，8，16，32，64，128，256，512，1024です。
3

ctm.StatsInterval
CTM稼働統計情報をファイルに出力する時間間隔を1～1440の範囲の整数（単位：分）で指定します。
1

ctm.StatsUse
CTM稼働統計情報を取得するかしないかを設定します。次のどちらかを指定します。

Y：

取得します。

N：

取得しません。

Y

ctm.SystemDown
システムを停止するかどうかを指定します。次のどちらかを指定します。

1：

停止します。

0：

停止しません。

1

ctm.SystemDownRate
システム停止へ移行する処理率のしきい値を1～100の範囲の整数（単位：％）で指定します。
なし

ctm.TSCGwOption
OTMゲートウェイの設定ファイルを，CTM稼働ホストの絶対パス（256文字以内の文字列）で指定します。
なし

ctm.TSCGwStart
CTM開始時に自動開始するOTMゲートウェイのプロセス数を0～32767の範囲の整数で指定します。
0はOTMゲートウェイを起動しないことを表します。
0

ctm.WatchQueue
キューの停留監視をするかどうかを指定します。次のどちらかを指定します。

true：

キューの停止監視をします。

false：

キューの停止監視をしません。

false

ctm.WatchRequest
J2EEサーバへのリクエストの送信でタイムアウトが発生したときにキューを閉塞するかどうかを指定します。次のどちらかを指定します。

true：

キューを閉塞します。

false：

キューを閉塞しません。

false

ctmid
CTMの識別子を31文字以内の文字列で指定します。使用できる文字は英数字，アンダースコア(_)，およびピリオド（.）です（ピリオドはIPアドレスの場合だけ指定できます）。「CTM」または「ctm」で始まる文字列は指定しないでください。
このパラメタを指定する場合，運用管理ドメイン内のすべての論理CTMサーバで一意の値を指定する必要があります。
なお，IPアドレスを指定した場合，ピリオド（.）は，アンダースコア（_）に置き換えられます。
<ホストの定義の<agent-host>タグに指定された値>※_<CTMのポート番号>

注※

<agent-host>タグにホスト名を指定している場合，IPアドレスに変換した値が指定されます。また，<agent-host>タグにIPアドレスを指定している場合，ピリオド（.）はアンダースコア(_)に置き換えられます。

14.10　論理スマートエージェントで指定できるパラメタ

ここでは，論理スマートエージェントで指定できるパラメタについて説明します。

論理スマートエージェントで指定できるパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-102　論理スマートエージェントに設定できるパラメタ

param-name指定値 | param-valueの指定内容 | 省略値
smartagent.port | スマートエージェントが監視するポート番号を5001～65535の範囲の整数で指定します。 | 14000

14.11　論理ユーザサーバで指定できるパラメタ

ここでは，論理ユーザサーバで指定できるパラメタについて説明します。

「param-name指定値」に対応するparam-valueの指定内容については，マニュアル「Cosminexus　リファレンス　定義編」の論理ユーザサーバ定義ファイルについての説明を参照してください。なお，マニュアル「Cosminexus　リファレンス　定義編」を参照する場合，要素名をパラメタに読み替えてください。

論理ユーザサーバで指定できるパラメタについて次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-103　論理ユーザサーバに設定できるパラメタ

param-name指定値 | 省略値
forceStop.arg※1 | なし
forceStop.timeout※2 | 180
getProcessID.arg※1 | なし
getProcessID.timeout※2 | 180
group-id | なし
isAlive.arg※1 | なし
isAlive.timeout※2 | 180
start.arg※1 | なし
start.timeout※2 | 180
start-time-watch-interval | 1
stop.arg※1 | なし
stop.timeout※2 | 180
type | direct
user-id | なし
watch-interval | 1
working-dir | <Cosminexusのインストールディレクトリ>/manager/bin

注※1

マニュアル「Cosminexus　リファレンス　定義編」の論理ユーザサーバ定義ファイルの要素名<arg>についての説明を参照してください。

注※2

マニュアル「Cosminexus　リファレンス　定義編」の論理ユーザサーバ定義ファイルの要素名<timeout>についての説明を参照してください。

14.12　論理ネーミングサービスで指定できるパラメタ

ここでは，論理ネーミングサービスで指定できるパラメタについて説明します。

論理ネーミングサービスで指定できるパラメタについて次の表に示します。なお，表中の「省略値」とは，パラメタの指定がない場合に仮定される値です。

表14-104　論理ネーミングサービスに設定できるパラメタ

param-name指定値
param-valueの指定内容
省略値

ns.agenthost
ホスト固定時に運用管理エージェントのホストで固定するかどうかを指定します。

true：

特定のIPアドレスに割り当てます。

false：

特定のIPアドレスに割り当てません。

false

ns.agent.port
スマートエージェントのポート番号を指定します。
14000

ns.bind.host
特定のIPアドレスに割り当てるかどうかを指定します。次のどちらかを指定します。

true：

特定のIPアドレスに割り当てます。

false：

特定のIPアドレスに割り当てません。

false

port
ネーミングサービスが稼働する時に使用するポート番号を指定します。
900

15.　JP1と連携したSmart Composer機能でのシステム構築・運用

Smart Composer機能では，JP1/IM - CMおよびJP1/AJS2 - SOと連携して，Webシステムを構築したり，運用したりできます。この章では，JP1/IM - CMとの連携およびJP1/AJS2 - SOとの連携について説明します。

＜この章の構成＞

15.1　JP1と連携したシステム構築・運用の概要

15.2　JP1/IM - CMと連携したシステム構築の流れ

15.3　JP1/IM - CMと連携するための設定

15.4　JP1/AJS2 - SOと連携したシステム構築・運用の流れ

15.5　JP1/AJS2 - SOと連携するための設定

15.1　JP1と連携したシステム構築・運用の概要

Smart Composer機能では，JP1/IM - CMと連携してシステムを構築したり，構築したシステムをJP1/AJS2 - SOと連携して運用したりできます。JP1/IM - CMはWebシステムの構成情報を定義するときに利用できます。また，Cosminexusでは，Smart Composer機能のコマンドを定義したシナリオテンプレートを提供しているので，JP1/AJS2 - SOと連携してシステム運用のシナリオを作成できます。

ここでは，JP1/IM - CMおよびJP1/AJS2 - SOとの連携について説明します。なお，JP1/IM - CMおよびJP1/AJS2 - SOと連携する場合のシステム構成などについては，マニュアル「Cosminexus　機能解説」のJP1と連携したシステムの運用に関する説明を参照してください。

また，Smart Composerで構築したWebシステムは，ほかのJP1製品と連携することで，Webシステム中の論理サーバやJ2EEアプリケーションの，障害監視，および稼働性能監視ができます。ほかのJP1製品との連携の概要やシステム構成などについては，マニュアル「Cosminexus　機能解説」のJP1と連携したシステムの運用に関する説明を参照してください。

＜この節の構成＞

15.1.1　JP1/IM - CMを使用したシステムの構築・運用

15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用

15.1.1　JP1/IM - CMを使用したシステムの構築・運用

Smart Composer機能では，JP1/IM - CMを使用して，システムを構築したり，運用したりできます。JP1/IM - CMと連携すると，Webシステムの構成情報をビジュアルに定義したり，定義したWebシステムの構成情報を管理・収集したりできます。

ポイント

Smart Composer機能で構築できるシステムのうち，combined-tier構成のシステムがJP1/IM - CMと連携できます。

Webシステムの構成情報の定義
JP1/IM - CMを使用すると，Webシステムの構成をGUIで定義できます。また，定義したWebシステムの構成情報は，JP1/IM - CMのエクスポート機能を使用することで，Cosminexus Smart Composer用ファイルとして出力できます。Cosminexus Smart Composer用ファイルは，Smart Composer機能で使用する，簡易構築定義ファイルに当たります。
JP1/IM - CMを使用することで，システム構成をビジュアルに定義でき，またエディタを使用して簡易構築定義ファイルを作成する必要がなくなるので，Smart Composer機能を使用したWebシステムの構築がより簡単になります。

Webシステムの構成情報の管理・収集
Smart Composer機能で構築するWebシステムの構成を，JP1/IM - CMで定義すると，その構成情報はJP1/IM - CMで管理されます。例えば，Smart Composer機能を使用して構築したWebシステムをスケールアウトすると，構成変更の情報がJP1イベントとして，JP1/IM - CMがインストールされたJP1統合運用管理サーバに通知されます。このJP1イベントを契機に，ユーザ側で情報を収集します。
これによって，JP1/IM - CMでは，Webシステムの構成情報を常に最新の状態で管理できます。

JP1/IM - CMと連携する場合のシステム構築については，「15.2　JP1/IM - CMと連携したシステム構築の流れ」および「15.3　JP1/IM - CMと連携するための設定」を参照してください。なお，JP1/IM - CMを使用したシステムの構築・運用の概要，およびシステム構成については，マニュアル「Cosminexus　機能解説」のJP1と連携したシステムの運用に関する説明を参照してください。

15.1.2　JP1/AJS2 - SOを使用したシナリオによるシステムの運用

Smart Composer機能では，JP1/AJS2 - SOと連携することで，Smart Composer機能で構築したシステムを，シナリオを使用して運用できます。Cosminexusでは，Smart Composer機能用のシナリオテンプレートを提供しています。シナリオテンプレートには，Smart Composer機能のコマンドを定義しています。提供するシナリオテンプレートを組み合わせることで，Smart Composer機能でシステムを運用するためのシナリオを作成できます。これによって，Smart Composer機能を使用したシステム運用が自動化できます。

JP1/AJS2 - SOと連携する場合のシステム構築については，「15.4　JP1/AJS2 - SOと連携したシステム構築・運用の流れ」および「15.5　JP1/AJS2 - SOと連携するための設定」を参照してください。なお，JP1/AJS2 - SOを使用したシステムの運用の概要，およびシステム構成については，マニュアル「Cosminexus　機能解説」のJP1と連携したシステムの運用に関する説明を参照してください。

15.2　JP1/IM - CMと連携したシステム構築の流れ

JP1/IM - CMと連携してシステムを構築するときの流れを次の図に示します。システム構築の流れについては，「6.　J2EEアプリケーションを実行するシステムの構築」とあわせてお読みください。

図15-1　JP1/IM - CMと連携したシステム構築の流れ

図中の1.～9.について説明します。

インストール
必要となる製品をインストールします。JP1/IM - CM連携の場合は，「6.2　インストール」に示す製品のほかに，各サーバマシンにそれぞれ次の製品をインストールします。

表15-1　JP1/IM - CM連携時に必要な製品

サーバ／クライアント
製品／構成ソフトウェア

運用管理サーバ

JP1/Base

JP1統合運用管理サーバ

JP1/Base

JP1/IM - ManagerまたはJP1/IM - Central Console※

JP1/IM - CM

運用管理クライアント

JP1/IM - View

注※

JP1 Version 8の場合，JP1/IM - Central Consoleは，JP1/IM - Managerを構成するコンポーネントに含まれています。

負荷分散機の設定
負荷分散機を設定します。

初期設定

必要に応じて，OSやデータベースなどのホスティング環境を設定します。

アプリケーションサーバでは，環境変数の設定，Cosminexus DABroker Libraryの動作環境の設定，および運用管理エージェントを自動起動するための設定をします。

運用管理サーバでは，環境変数の設定，Management Serverの設定および自動起動するための設定をします。また，JP1/IM - CMと連携するために，Cosminexusアダプタコマンドの設定や，JP1/BaseのJP1イベントなどを設定します。

JP1統合運用管理サーバでは，JP1/Baseの構成定義を作成します。

必要に応じて，Cosminexusから負荷分散機を制御するための設定をします。

JP1/IM - CMでの構成定義
JP1/IM - CMでシステムの構成情報を定義します。システム構成を定義したあとは，JP1/IM - CMのエクスポート機能を使用して，Cosminexus Smart Composer用ファイルを出力します。出力したCosminexus Smart Composer用ファイルは，Smart Composer機能の簡易構築定義ファイルとしてそのまま利用できます。
詳細については，マニュアル「JP1 Version 8 JP1/Integrated Management - Central Information Master　システム構築・運用ガイド」，またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Central Information Master　システム構築・運用ガイド」を参照してください。

Smart Composer機能での構成定義
抽象パラメタと4.で出力した簡易構築定義ファイルから，Smart Composer機能のコマンドを使用して「抽象パラメタ展開済み簡易構築定義ファイル」を作成します。

システムの構築
5.で作成した「抽象パラメタ展開済み簡易構築定義ファイル」の情報を基に，Management Server上にWebシステムの情報モデルを生成します。さらに，そのWebシステムの情報モデルからWebシステムを構築します。Webシステムの構成として定義されている，すべてのアプリケーションサーバ上にWebサーバおよびJ2EEサーバをセットアップし，各論理サーバの環境を設定します。

一括起動およびデプロイ
Webシステム内のすべてのサービスユニットを準備状態で開始したあと，リソースアダプタおよびJ2EEアプリケーションをデプロイします。
なお，リソースアダプタのデプロイ時には，抽象パラメタの展開に合わせて，Connector属性ファイルを編集する必要があります。

システムの開始
リソースアダプタおよびJ2EEアプリケーションを開始したあと，Webシステム内のすべてのサービスユニットを稼働状態にします。

チューニング
構築したWebシステムについて，スループット，レスポンス時間，CPU時間などの性能メトリックの相関が適切かどうか多角的に検証し，必要に応じてWebシステムの構成を変更します。

15.3　JP1/IM - CMと連携するための設定

JP1/IM - CM連携時に必要となる各サーバマシンの設定について説明します。

なお，ここでは，「15.2　JP1/IM - CMと連携したシステム構築の流れ」の手順3.にある初期設定のうち，CosminexusとJP1/IM - CMが連携する場合に必要となる設定について説明しています。JP1/IM - CMを使用するための設定については，マニュアル「JP1 Version 8 JP1/Integrated Management - Central Information Master　システム構築・運用ガイド」，またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Central Information Master　システム構築・運用ガイド」を参照してください。

また，Smart Composer機能でシステムを構築するときに必要となる，そのほかの設定については，「6.　J2EEアプリケーションを実行するシステムの構築」を参照してください。

＜この節の構成＞

15.3.1　運用管理サーバの設定

15.3.2　JP1統合運用管理サーバの設定

15.3.1　運用管理サーバの設定

JP1/IM - CMと連携するため，運用管理サーバでは次の設定をします。

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

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

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

JP1/BaseのJP1イベント転送の設定

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

Management Serverの自動起動の設定

＜この項の構成＞

(1)　Cosminexusアダプタコマンドのセットアップ

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

(3)　CosminexusのJP1イベント発行の設定

(4)　JP1/BaseのJP1イベント転送の設定

(5)　JP1/Baseのイベントサーバ名の設定

(6)　Management Serverの自動起動の設定

(1)　Cosminexusアダプタコマンドのセットアップ

Smart Composer機能を使用して構築したWebシステムの構成情報を収集するために，JP1/Baseによって実行されるCosminexusアダプタコマンドをJP1/Baseに登録します。

Cosminexusの運用管理サーバでmngsvr_adapter_setupコマンドを実行して，JP1/Baseの環境にCosminexus用のアダプタコマンド設定ファイルを追加します。なお，mngsvr_adapter_setupコマンドを実行するユーザには，Windowsの場合はAdministrator権限が，UNIXの場合はroot権限が必要です。mngsvr_adapter_setupコマンドの実行例を次に示します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥bin¥mngsvr_adapter_setup -i -t IM_CM

UNIXの場合

/opt/Cosminexus/bin/mngsvr_adapter_setup -i -t IM_CM

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

Cosminexusアダプタコマンドを実行するための環境は，.mngsvrutilrc（クライアント側定義ファイル）に設定します。.mngsvrutilrcファイルは，Management Serverの運用管理コマンドであるmngsvrutilコマンドのオプションのデフォルト値を設定するファイルです。.mngsvrutilrcの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

Cosminexusの運用管理サーバで，Windowsの場合はOSユーザ（SYSTEMユーザ）の，UNIXの場合はJP1/Baseを起動したOSユーザのホームディレクトリに，.mngsvrutilrcファイルを作成して，次のパラメタを指定します。

mngsvrutil.connect.host
Management Serverのホスト名とポート番号を指定します。

mngsvrutil.connect.userid
「6.6.2　Management Serverの設定」で設定した管理ユーザIDを指定します。

mngsvrutil.connect.password
「6.6.2　Management Serverの設定」で設定したパスワードを指定します。パスワードを設定していない場合，このパラメタの指定は省略できます。

なお，アダプタコマンドの実行環境を変更したい場合は，mngsvrutil.properties（サーバ側定義ファイル）で変更します。mngsvrutil.propertiesの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

参考

.mngsvrutilrcファイルはクライアントごとに個別のデフォルト値を設定する場合に使用します。すべてのクライアント共通のデフォルト値を設定したい場合は，mngsvrutilcl.properties（クライアント側共通設定ファイル）を使用してください。なお，両方のファイルを使用している場合は，.mngsvrutilrcファイルが適用されます。mngsvrutilcl.propertiesファイルは読み込まれません。

(3)　CosminexusのJP1イベント発行の設定

JP1/IM - CMに対して，Management Serverの稼働状況およびシステムの構成変更を，JP1イベントとして上げるための設定をします。JP1イベントによって，JP1/IM - CMはシステムの構成変更を検知できるので，最新の状態でシステム構成を管理できます。

JP1/IM - CM連携時，Management Serverでは，次の表に示す種類のJP1イベントを発行します。

表15-2　JP1/IM - CM連携時に発行されるJP1イベント

JP1イベントID | JP1イベントのSeverity | 発行のタイミング
00012050 | Notice | Management Serverが起動したとき
00012051 | Notice | Management Serverが停止したとき
00012060 | Notice | Smart Composer機能を使用してWebシステムを構築したとき
00012061 | Notice | Smart Composer機能を使用してWebシステムを削除したとき
0001206A | Notice | Smart Composer機能を使用してWebシステムを変更したとき

JP1イベント発行の設定手順を次に示します。

システムJP1イベント発行の設定をします。
運用管理ポータルの「Cosminexus Management Serverの設定」にある［JP1連携の設定］画面の［システムJP1イベント発行機能を有効にする］を「する」に設定します。

Management Serverを再起動します。
再起動後に，設定した情報が有効になります。

JP1/IM - CM連携用のJP1イベントは，常にJP1イベントを発行するため，Management Serverではフィルタリングできません。フィルタリングが必要な場合は，JP1/Baseのフィルタ機能を利用してください。

(4)　JP1/BaseのJP1イベント転送の設定

JP1/BaseのJP1イベント転送の設定をします。この設定によって，JP1/IM - CMがインストールされたJP1統合運用管理サーバマシンにJP1イベントが転送されるようになります。JP1/BaseのJP1イベント転送の設定手順を次に示します。

JP1/Baseで，JP1イベント転送の設定をします。
JP1/Baseのforward（転送設定ファイル）の転送条件に「E.JP1_HC_EVENT IN Y」をOR条件で追加します。記述例を次に示します。

JP1/Baseのforwardファイルの記述例

# JP1/Base - Event Server Forwarding Setting
to-upper
E.SEVERITY IN Warning Error Critical Alert Emergency Emergence
OR
E.JP1_HC_EVENT IN Y
end-to

(5)　JP1/Baseのイベントサーバ名の設定

Microsoft Cluster ServiceやHAモニタを使用したクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき，イベントサーバ名を設定します。イベントサーバ名を設定するには，mserver.properties（Management Server環境設定ファイル）のmngsvr.jp1event.event_server_nameキーに，論理ホスト名または論理IPアドレスを指定します。設定した情報を有効にするために，設定後は，Management Serverを再起動してください。

なお，mserver.propertiesの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(6)　Management Serverの自動起動の設定

Management ServerがJP1/Baseのイベントサービスよりも先に起動した場合，JP1イベントサービスが起動するまでに発行したJP1イベントは失われます。確実にJP1イベントを発行するためには，次の設定が必要です。

(a)　Windowsの場合

JP1/Baseの起動管理機能を使用してManagement Serverを自動起動します。

Management Serverを自動起動するには，JP1/BaseのJp1svprm.dat（起動順序定義ファイル）に「Cosminexus Management Server」のサービスを追加してください。なお，ホスト起動時にManagement Serverを自動起動する設定をしている場合は，いったん手動起動に設定してから実施してください。

JP1/BaseのJp1svprm.datファイルの格納場所と記述例を次に示します。

Jp1svprm.datファイルの格納場所

<JP1/Baseインストールディレクトリ>¥jp1base¥conf¥boot¥Jp1svprm.dat

Jp1svprm.datファイルの記述例

JP1/BaseのJp1svprm.datファイル記述例を次に示します。

：
[OtherServiceCosminexusManagementServer]
Name=Cosminexus Management Server
ServiceName=mngsvr
Parallel=YES

：

(b)　AIXの場合

/etc/inittabファイルにJP1/Baseの起動スクリプトを登録したあとに，Management Server用起動スクリプト（/opt/Cosminexus/manager/bin/mngsvrctl start）を登録します。

(c)　HP-UXの場合

/sbin/init.d/MngSvrのシンボリックリンクの名称の起動順序を，JP1/Baseよりあとに起動されるように設定する必要があります。起動順序には，901以降を指定してください。

(d)　Linuxの場合

/etc/rc.d/rc<N>.dディレクトリ（<N>は起動時の実行レベル）に/etc/rc.d/init.d/MngSvrへのシンボリックリンクを作成する際，JP1/Baseよりもあとに起動されるようにシンボリック名称の起動順序およびスクリプト名称を指定します。起動順序には「99」を，スクリプト名称の先頭は「_」（アンダーバー）よりコード値が大きい文字を指定してください。

(e)　Solarisの場合

/etc/rc<N>.dディレクトリ（<N>は起動時の実行レベル）に/etc/init.d/MngSvrへのシンボリックリンクを作成する際，JP1/Baseよりもあとに起動されるように，シンボリック名称の起動順序およびスクリプト名称を指定します。起動順序には「99」を，スクリプト名称の先頭は「_」（アンダーバー）よりコード値が大きい文字を指定してください。

15.3.2　JP1統合運用管理サーバの設定

JP1/IM - CMと連携するためには，WebシステムにJP1統合運用管理サーバを配置します。JP1統合運用管理サーバとは，JP1/IM - CMと連携してシステムの構成を定義する場合に，JP1/IM - CMや，JP1/IM - ManagerまたはJP1/IM - Central Consoleを配置するホストのことです。JP1統合運用管理サーバでは，次の設定をします。

JP1/Baseの構成定義ファイルの作成

＜この項の構成＞

(1)　JP1/Baseの構成定義ファイルの作成

(1)　JP1/Baseの構成定義ファイルの作成

JP1/Baseの構成定義ファイル（jbs_route.confファイル）は，JP1/IM - ManagerまたはJP1/IM - Central Consoleが管理するシステムの構成を定義するファイルです。ここでは，jbs_route.confファイルを作成し，JP1/Baseのjbs_route.confファイルに定義したホストへ，定義情報を配布します。

JP1/Baseのjbs_route.confファイルの作成手順を次に示します。なお，詳細については，マニュアル「JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド」またはマニュアル「JP1 Version 7i JP1/Integrated Manager - Console システム構築・運用ガイド」のシステムの構成定義情報の設定に関する説明を参照してください。

JP1/Baseのjbs_route.confを作成して，システムの構成を定義します。
jbs_route.confファイルは次の場所にインストールされています。

Windowsの場合

<JP1/Baseのインストールディレクトリ>¥jp1base¥conf¥route¥jbs_route.conf

UNIXの場合

/etc/opt/jp1base/conf/route/jbs_route.conf

また，jbs_route.confファイルには，次のように定義します。

jbs_route.confファイルの内容

［JP1統合運用管理サーバマシンのホスト名］
Cosminexusの運用管理サーバマシンのホスト名

jbsrt_distribコマンドを実行して，構成定義情報を配布します。

15.4　JP1/AJS2 - SOと連携したシステム構築・運用の流れ

JP1/AJS2 - SOと連携してシステムを運用するための，システム構築・運用の流れを次の図に示します。システム構築の流れについては，「6.　J2EEアプリケーションを実行するシステムの構築」とあわせてお読みください。

図15-2　JP1/AJS2 - SOと連携したシステム構築・運用の流れ

図中の1.～9.について説明します。

インストール
必要となる製品をインストールします。JP1/AJS2 - SO連携の場合は，「6.2　インストール」に示す製品のほかに，各サーバマシンにそれぞれ次の製品をインストールします。

表15-3　JP1/AJS2 - SO連携時に必要な製品

サーバ／クライアント
製品／構成ソフトウェア

アプリケーションサーバ

JP1/Base

運用管理サーバ

JP1/Base

JP1/AJS2 - Agent

JP1ジョブ運用管理サーバ

JP1/Base

JP1/AJS2 - SO Manager

JP1/AJS2 - Manager

運用管理クライアント

JP1/AJS2 - SO View

JP1/AJS2 - View

負荷分散機の設定
負荷分散機を設定します。

初期設定

必要に応じて，OSやデータベースなどのホスティング環境を設定します。

アプリケーションサーバでは，環境変数の設定，Cosminexus DABroker Libraryの動作環境の設定，運用管理エージェントを自動起動するための設定をします。また，JP1/AJS2 - SOと連携するために，JP1/BaseのJP1イベントなどの設定をします。

運用管理サーバでは，環境変数の設定，Management Serverの設定および自動起動するための設定をします。

JP1ジョブ運用管理サーバでは，シナリオテンプレートを利用するための設定をします。

必要に応じて，Cosminexusから負荷分散機を制御するための設定をします。

構成定義
簡易構築定義ファイルで，Webシステムの構成を定義します。簡易構築定義ファイルはエディタを使用して作成しますが，テンプレートファイルが用意されているので，構成の基本情報を設定するだけで運用できます。
作成した簡易構築定義ファイルと抽象パラメタから，「抽象パラメタ展開済み簡易構築定義ファイル」を作成します。

システムの構築
4.で作成した「抽象パラメタ展開済み簡易構築定義ファイル」の情報を基に，Management Server上にWebシステムの情報モデルを生成します。さらに，そのWebシステムの情報モデルからWebシステムを構築します。Webシステムの構成として定義されている，すべてのアプリケーションサーバ上にWebサーバおよびJ2EEサーバをセットアップし，各論理サーバの環境を設定します。

一括起動およびデプロイ
Webシステム内のすべてのサービスユニットを準備状態で開始したあと，リソースアダプタおよびJ2EEアプリケーションをデプロイします。
なお，リソースアダプタのデプロイ時には，抽象パラメタの展開に合わせて，Connector属性ファイルを編集する必要があります。

システムの開始
リソースアダプタおよびJ2EEアプリケーションを開始したあと，Webシステム内のすべてのサービスユニットを稼働状態にします。

チューニング
構築したWebシステムについて，スループット，レスポンス時間，CPU時間などの性能メトリックの相関が適切かどうか多角的に検証し，必要に応じてWebシステムの構成を変更します。

システムの運用
3.で取り込んだシナリオテンプレートを基に，JP1/AJS2 - SOを使用してシナリオを作成します。作成したシナリオをJP1/AJS2に登録して，システムの運用を開始します。

15.5　JP1/AJS2 - SOと連携するための設定

JP1/AJS2 - SO連携時に必要となる各サーバマシンの設定について説明します。

なお，ここでは，「15.4　JP1/AJS2 - SOと連携したシステム構築・運用の流れ」の手順3.にある初期設定のうち，JP1/AJS2 - SO連携の場合に必要となる設定について説明しています。Smart Composer機能でシステムを構築するときに必要となる，そのほかの設定については，「6.　J2EEアプリケーションを実行するシステムの構築」を参照してください。

＜この節の構成＞

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

15.5.2　運用管理サーバの設定

15.5.3　JP1ジョブ運用管理サーバの設定

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

JP1/AJS2 - SOと連携するため，アプリケーションサーバでは次の設定をします。

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

JP1/BaseのJP1イベント転送の設定

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

運用管理エージェントの自動起動の設定

＜この項の構成＞

(1)　CosminexusのJP1イベント発行の設定

(2)　JP1/BaseのJP1イベント転送の設定

(3)　JP1/Baseのイベントサーバ名の設定

(4)　運用管理エージェントの自動起動の設定

(1)　CosminexusのJP1イベント発行の設定

自動運用するシナリオの中には，例えばOSのメンテナンスなどのように，アプリケーションサーバの再起動が必要になる場合があります。アプリケーションサーバの再起動後にJP1/AJS2のジョブから実行するSmart Composer機能のコマンドを正常実行させるには，運用管理エージェントの起動完了を待つ必要があります。

シナリオの流れの中で，運用管理エージェントの起動完了を待つには，JP1イベント発行の設定をして，JP1イベント監視ジョブで，運用管理エージェント起動時に発行されるJP1イベントを監視します。

運用管理エージェントからJP1イベント発行するには，adminagent.propertiesのadminagent.jp1event_enabledキーにtrueを設定します。

JP1/AJS2 - SO連携時に運用管理エージェントが発行するJP1イベントの種類を次の表に示します。

表15-4　JP1/AJS2 - SO連携時に運用管理エージェントが発行するJP1イベント一覧

JP1イベントID | JP1イベントのSeverity | 発行契機
00012070 | Notice | 運用管理エージェントが起動したとき
00012071 | Notice | 運用管理エージェントが停止したとき

(2)　JP1/BaseのJP1イベント転送の設定

JP1/BaseのJP1イベント転送の設定をします。この設定によって，JP1/AJS2 - ManagerにJP1イベントが通知されます。JP1/BaseのJP1イベント転送の設定手順を次に示します。

JP1/Baseで，JP1イベント転送の設定をします。
JP1/Baseのforward（転送設定ファイル）の転送条件に「E.JP1_HC_EVENT IN Y」をOR条件で追加します。記述例を次に示します。

JP1/Baseのforwardファイルの記述例

# JP1/Base - Event Server Forwarding Setting
to hostxxx
E.SEVERITY IN Warning Error Critical Alert Emergency Emergence
OR
E.JP1_HC_EVENT IN Y
end-to

(3)　JP1/Baseのイベントサーバ名の設定

Microsoft Cluster ServiceやHAモニタを使用したクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき，イベントサーバ名を設定します。イベントサーバ名を設定するには，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.jp1event.event_server_nameキーに，論理ホスト名または論理IPアドレスを指定します。設定した情報を有効にするために，設定後は，Management Serverを再起動してください。

なお，adminagent.propertiesの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

(4)　運用管理エージェントの自動起動の設定

運用管理エージェントがJP1/Baseのイベントサービスよりも先に起動した場合，JP1イベントサービスが起動するまでに発行したJP1イベントは失われます。確実にJP1イベントを発行するためには，次の設定が必要です。

(a)　Windowsの場合

JP1/Baseの起動管理機能を使用して，運用管理エージェントを自動起動します。

運用管理エージェントを自動起動するには，JP1/BaseのJp1svprm.dat（起動順序定義ファイル）に「Cosminexus Management Server - Administration Agent」のサービスを追加してください。なお，ホスト起動時に運用管理エージェントを自動起動する設定をしている場合は，いったん手動起動に設定してから実施してください。

JP1/BaseのJp1svprm.datファイルの格納場所と記述例を次に示します。

JP1/BaseのJp1svprm.datファイルの格納場所

<JP1/Baseインストールディレクトリ>¥jp1base¥conf¥boot¥Jp1svprm.dat

JP1/BaseのJp1svprm.datファイルの記述例

JP1/BaseのJp1svprm.datファイル記述例を次に示します。

：
[OtherServiceCosminexusAdministrationAgent]
Name=Cosminexus Management Server - Administration Agent
ServiceName=CosmiAdminAgent
Parallel=YES
：

(b)　AIXの場合

/etc/inittabファイルにJP1/Baseの起動スクリプトを登録したあとに運用管理エージェント用起動スクリプト（/opt/Cosminexus/manager/bin/adminagentctl start）を登録します。

(c)　HP-UXの場合

/sbin/init.d/AdminAgentのシンボリックリンクの名称の起動順序を，JP1/Baseよりあとに起動されるように設定する必要があります。起動順序には，901以降を指定してください。

(d)　Linuxの場合

/etc/rc.d/rc<N>.dディレクトリ（<N>は起動時の実行レベル）に/etc/rc.d/init.d/AdminAgentへのシンボリックリンクを作成する際，JP1/Baseよりもあとに起動されるようにシンボリック名称の起動順序およびスクリプト名称を指定します。起動順序には「99」を，スクリプト名称の先頭は「_」（アンダーバー）よりコード値が大きい文字を指定してください。

(e)　Solarisの場合

/etc/rc<N>.dディレクトリ（<N>は起動時の実行レベル）に/etc/init.d/AdminAgentへのシンボリックリンクを作成する際，JP1/Baseよりもあとに起動されるようにシンボリック名称の起動順序およびスクリプト名称を指定します。起動順序には「99」を，スクリプト名称の先頭は「_」（アンダーバー）よりコード値が大きい文字を指定してください。

15.5.2　運用管理サーバの設定

JP1/AJS2 - SOと連携するため，運用管理サーバでは次の設定をします。

PATH環境変数の設定

.cmxrcファイルの作成

＜この項の構成＞

(1)　PATH環境変数の設定

(2)　.cmxrcファイルの作成

(1)　PATH環境変数の設定

Cosminexusが提供するシナリオテンプレートを使用した自動運用では，JP1/AJS2のジョブの実行先ホストを運用管理サーバにします。このジョブからは，Smart Composer機能で提供するコマンドを実行するため，運用管理サーバでは，Windowsの場合PATHシステム環境変数に，UNIXの場合OSユーザのPATH環境変数の設定に次のパスを追加します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin

UNIXの場合

/opt/Cosminexus/manager/bin

(2)　.cmxrcファイルの作成

Cosminexusで提供するシナリオテンプレートでは，外部からSmart Composer機能のコマンドの共通オプションを指定できます。この共通オプションを指定しなかった場合のデフォルト値を，Smart Composer機能で提供する.cmxrc（クライアント設定プロパティファイル）に指定しておくことで，外部から与える情報を少なくすることができます。

.cmxrcファイルは，JP1/AJS2 - AgentがSmart Composer機能で提供するコマンドを実行する際のOSユーザ（JP1/Baseのユーザマッピングで設定）のホームディレクトリに作成します。

なお，.cmxrcファイルの詳細については，「13.4　.cmxrc（クライアント設定プロパティファイル）」を参照してください。

参考

.cmxrcファイルはクライアントごとに個別のデフォルト値を設定する場合に使用します。すべてのクライアント共通のデフォルト値を設定したい場合は，cmxclient.properties（クライアント共通設定プロパティファイル）を使用してください。なお，両方のファイルを使用している場合は，.cmxrcファイルが適用されます。cmxclient.propertiesファイルは読み込まれません。

15.5.3　JP1ジョブ運用管理サーバの設定

JP1/AJS2 - SOと連携するためには，WebシステムにJP1ジョブ運用管理サーバを配置します。JP1ジョブ運用管理サーバとは，JP1/AJS2 - SOと連携してシステムの自動運転をする場合に，JP1/AJS2 - ManagerおよびJP1/AJS2 - SO Managerを配置するホストのことです。JP1ジョブ運用管理サーバでは，次の設定をします。

シナリオテンプレートを使用するための設定

＜この項の構成＞

(1)　シナリオテンプレートを使用するための設定

(1)　シナリオテンプレートを使用するための設定

Cosminexusが提供するシナリオテンプレートを利用する場合は，次に示すシナリオテンプレート定義ファイルを，JP1/AJS2 - SO Managerに組み込む必要があります。

シナリオテンプレート定義ファイル

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥externals¥jp1¥ScenarioTemplate¥CosminexusManager.sjis.xml

UNIXの場合

/opt/Cosminexus/manager/externals/jp1/ScenarioTemplate/CosminexusManager.sjis.xml

なお，組み込み方法については，マニュアル「JP1/Automatic Job Management System 2 - Scenario Operation」を参照してください。

付録

＜この付録の構成＞

付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド

付録B　抽象パラメタ

付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル

付録D　JP1/Cm2/NCとの連携

付録E　論理サーバのコンフィグレーションに指定できるパラメタ（互換用）

付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり

付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり

付録H　Cosminexus DABroker Libraryのメモリ所要量

付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）

付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）

付録K　データベースの設定

付録L　セットアップウィザードで設定されるパラメタ

付録M　用語解説

付録A　Smart Composer機能が実行する負荷分散機のCLIコマンド

Smart Composer機能で提供するコマンドを実行すると，Management Serverと接続して，負荷分散機の設定をします。負荷分散機の設定は，業務リクエストをWebサーバに振り分けるための設定で，仮想サーバや実サーバの作成，仮想サーバと実サーバの接続，および実サーバへのリクエスト振り分けの開始・停止などを設定します。

ここでは，Smart Composer機能が実行する負荷分散機のCLIコマンドについて，BIG-IP 1500，BIG-IP 1000またはLoadflowbalの場合に分けて紹介します。

＜この節の構成＞

付録A.1　BIG-IP 1500の場合

付録A.2　BIG-IP 1000の場合

付録A.3　Loadflowbalの場合

付録A.1　BIG-IP 1500の場合

Smart Composer機能が実行するBIG-IP 1500のCLIコマンドを次の表に示します。

BIG-IP 1500のCLIコマンドの詳細については，BIG-IP 1500のドキュメントを参照してください。

表A-1　Smart Composer機能が実行するBIG-IP 1500のCLIコマンド

Smart Composer機能のコマンド | cookieスイッチング | 実行するBIG-IP 1500のCLIコマンド
共通 | － | b save
cmx_build_system（Webシステムを構築する場合） | × | b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable
b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http enable}
○ | b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable
b profile persist <仮想サーバ名> {mode cookie cookie mode hash cookie name <cookie名> cookie hash offset 0 cookie hash length 4}
b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http persist <仮想サーバ名> enable}
cmx_build_system（スケールアウトする場合） | － | b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable
cmx_build_system（実ポートを変更する場合） | － | b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> add
b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> session disable
b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete
cmx_delete_system（サービスユニットを削除，およびホスト単位管理モデルをスケールインする場合） | － | b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete
b node <実サーバIPアドレス> delete
cmx_delete_system（Webシステムを削除する場合） | × | b virtual <仮想サーバ名> delete
b pool <仮想サーバ名> delete
b node <実サーバIPアドレス> delete
○ | b virtual <仮想サーバ名> delete
b pool <仮想サーバ名> delete
b node <実サーバIPアドレス> delete
b profile persist <仮想サーバ名> delete
cmx_start_target | － | b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session enable
cmx_stop_target | － | b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

（凡例）○：使用します。　×：使用しません。　－：該当しません。

参考

BIG-IP 1500の場合，仮想サーバ名をプール名として使用します。

付録A.2　BIG-IP 1000の場合

Smart Composer機能が実行するBIG-IP 1000のCLIコマンドを次の表に示します。

BIG-IP 1000のCLIコマンドの詳細については，BIG-IP 1000のドキュメントを参照してください。

表A-2　Smart Composer機能が実行するBIG-IP 1000のCLIコマンド

Smart Composer機能のコマンド | cookieスイッチング | BIG-IP 1000のCLIコマンド
共通 | － | b save
cmx_build_system（Webシステムを構築する場合） | × | b service <仮想ポート> tcp enable
b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}
b pool <仮想サーバ名> add {member <実サーバIPアドレス>:<実ポート>}
b node <実サーバIPアドレス>:<実ポート> disable
b virtual <仮想サーバIPアドレス>:<仮想ポート> use pool <仮想サーバ名>
○ | b service <仮想ポート> tcp enable
b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}
b pool <仮想サーバ名> modify {persist_mode cookie cookie_mode hash cookie_hash_ name <cookie名> cookie_hash_offset 0 cookie_hash_length 4}
b pool <仮想サーバ名> add {member <実サーバIPアドレス>:<実ポート>}
b node <実サーバIPアドレス>:<実ポート> disable
b virtual <仮想サーバIPアドレス>:<仮想ポート> use pool <仮想サーバ名>
cmx_build_system（スケールアウトする場合） | － | b pool <仮想サーバ名> add {member <実サーバIPアドレス>:<実ポート>}
b node <実サーバIPアドレス>:<実ポート> disable
cmx_build_system（実ポートを変更する場合） | － | b pool <仮想サーバ名> add {member <実サーバIPアドレス>:<変更後の実ポート>}
b node <実サーバIPアドレス>:<変更後の実ポート> disable
b pool <仮想サーバ名> delete {member <実サーバIPアドレス>:<変更前の実ポート>}
cmx_delete_system（サービスユニットを削除，およびホスト単位管理モデルをスケールインする場合） | － | b pool <仮想サーバ名> delete {member <実サーバIPアドレス>:<実ポート>}
cmx_delete_system（Webシステムを削除する場合） | － | b virtual <仮想サーバIPアドレス>:<仮想ポート> delete
b pool <仮想サーバ名> delete
b service <仮想ポート> tcp disable
cmx_start_target | － | b node <実サーバIPアドレス>:<実ポート> enable
cmx_stop_target | － | b node <実サーバIPアドレス>:<実ポート> disable

（凡例）○：使用します。　×：使用しません。　－：該当しません。

参考

BIG-IP 1000の場合，仮想サーバ名をプール名として使用します。

付録A.3　Loadflowbalの場合

Smart Composer機能が実行するLoadflowbalのCLIコマンドを次の表に示します。

LoadflowbalのCLIコマンドの詳細については，HA8000-ie/Loadflowbalのドキュメントを参照してください。

表A-3　Smart Composer機能が実行するLoadflowbalのCLIコマンド

Smart Composer機能のコマンド | cookieスイッチング | LoadflowbalのCLIコマンド
共通 | － | enable
configure terminal
write memory
quit
cmx_build_system（Webシステムを構築する場合） | × | server virtual-name <仮想サーバ名> <仮想サーバIPアドレス>
port <仮想ポート>
server real-name <実サーバ名> <実サーバIPアドレス>
port <実ポート> disable
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <実ポート>
○ | server virtual-name <仮想サーバ名> <仮想サーバIPアドレス>
port <仮想ポート>
port <仮想ポート> cookie-name <cookie名>
port <仮想ポート> cookie-switching
server real-name <実サーバ名> <実サーバIPアドレス>
port <実ポート> disable
port <実ポート> group-id <グループID> <グループID>
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <実ポート>
cmx_build_system（スケールアウトする場合） | × | server real-name <実サーバ名> <実サーバIPアドレス>
port <実ポート> disable
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <実ポート>
○ | server real-name <実サーバ名> <実サーバIPアドレス>
port <実ポート> disable
port <実ポート> group-id <グループID> <グループID>
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <実ポート>
cmx_build_system（実ポートを変更する場合） | × | server real-name <実サーバ名>
no port <変更前の実ポート>
port <変更後の実ポート> disable
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <変更後の実ポート>
○ | server real-name <実サーバ名>
no port <変更前の実ポート>
port <変更後の実ポート> disable
port <実ポート> group-id <グループID> <グループID>
server virtual-name <仮想サーバ名>
bind <仮想ポート> <実サーバ名> <変更後の実ポート>
cmx_delete_system（サービスユニットを削除，およびホスト単位管理モデルをスケールインする場合） | － | no server real-name <実サーバ名>
cmx_delete_system（Webシステムを削除する場合） | － | no server real-name <実サーバ名>
no server virtual-name <仮想サーバ名>
cmx_start_target | － | server real-name <実サーバ名>
no port <実ポート> disable
cmx_stop_target | － | server real-name <実サーバ名>
port <実ポート> disable

（凡例）○：使用します。　×：使用しません。　－：該当しません。

付録B　抽象パラメタ

Smart Composer機能では，互いに関連があるパラメタを一つにまとめたパラメタとして提供しています。これを抽象パラメタといいます。抽象パラメタとは，個々の製品のそれぞれ具体的な実パラメタではなく，システム設計の見地からシステムの性能要件として定義されるパラメタのことをいいます。Smart Composer機能では，次の抽象パラメタを使用します。

リクエスト最大同時処理数

一つのサービスユニットでの，リクエストの最大同時処理数です。リクエストとは，クライアントから送られるHTTPリクエストに端を発する，一連の業務処理をいいます。

cmx_trans_paramコマンドを実行すると，定義した抽象パラメタの値が，展開規則に従って複数の実パラメタとして展開されます。なお，そのほかの実パラメタについては，パラメタのデフォルト値を使用します。それぞれのパラメタの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

抽象パラメタの展開機能は，物理ティアがcombined-tier構成の場合だけ利用できます。combined-tier以外の物理ティアの場合は，Smart Composer機能を利用しない場合のWebシステム構築と同様のパラメタ定義設計が必要です。

ここでは，抽象パラメタの展開，および抽象パラメタによって展開される実パラメタについて説明します。

＜この節の構成＞

付録B.1　抽象パラメタの展開

付録B.2　抽象パラメタによって展開される実パラメタ

付録B.1　抽象パラメタの展開

cmx_trans_paramコマンドに，簡易構築定義ファイルと抽象パラメタを入力することによって，抽象パラメタから実パラメタに展開された定義ファイル（抽象パラメタ展開済み簡易構築定義ファイル）が作成されます。抽象パラメタ展開のイメージを，次の図に示します。

図B-1　抽象パラメタ展開のイメージ

なお，抽象パラメタの展開には，抽象パラメタが設計されている必要があります。抽象パラメタを展開する前に，リクエスト最大同時処理数の見積もりをしてください。

次に，リクエスト最大同時処理数を20と見積もった場合の抽象パラメタの展開の実行例を示します。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥bin¥cmx_trans_param -i <任意のディレクトリ>¥MyWebSystemDef.xml -p UnitMaxParallelCount=20 -o <任意のディレクトリ>¥MyWebSystemDef2.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_trans_param -i <任意のディレクトリ>/MyWebSystemDef.xml -p UnitMaxParallelCount=20 -o <任意のディレクトリ>/MyWebSystemDef2.xml

cmx_trans_paramコマンドの詳細については，「12.3　コマンドの詳細」の「cmx_trans_param」を参照してください。

付録B.2　抽象パラメタによって展開される実パラメタ

抽象パラメタであるリクエスト最大同時処理数は，cmx_trans_paramコマンドを実行すると，簡易構築定義ファイルの次の七つの実パラメタに値が展開されます。

ThreadsPerChild

MaxClients

StartServers

HWSKeepStartServers

KeepAliveTimeout

webserver.connector.ajp13.backlog

webserver.connector.ajp13.max_threads

また，この抽象パラメタを使用して，Connector属性ファイルの，次の二つのパラメタの値を決定できます。なお，Connector属性ファイルとは，リソースアダプタの属性を取得，編集する場合に使用するファイルです。

MaxPoolSize

MinPoolSize

ここでは，簡易構築定義ファイルに展開される実パラメタの展開規則と，Connector属性ファイルに設定するパラメタの値の設定規則について説明します。

＜この項の構成＞

(1)　簡易構築定義ファイルに展開される実パラメタ

(2)　抽象パラメタの展開例

(3)　Connector属性ファイルのパラメタの値

(1)　簡易構築定義ファイルに展開される実パラメタ

リクエスト最大同時処理数の値が，それぞれの実パラメタへの展開されるときの規則および実パラメタの説明を，実パラメタごとに説明します。なお，説明中の「設定先のファイル」とは，抽象パラメタ展開済みの簡易構築定義ファイルの情報が最終的に反映される，Cosminexusのファイルを指します。

(a)　ThreadsPerChild

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

Hitachi Web Serverで，Webサーバとして起動するスレッド数を指定するパラメタです。指定したスレッド数はWebサーバの最大同時接続数を示します。

詳細については，マニュアル「Hitachi Web Server」を参照してください。

設定先のファイル：httpsd.conf（Hitachi Web Server定義ファイル）

(b)　MaxClients

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

Hitachi Web Serverで，同時に接続できるクライアントの最大数を指定するパラメタです。

設定先のファイル：httpsd.conf（Hitachi Web Server定義ファイル）

(c)　StartServers

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

Hitachi Web Serverで，Webサーバ起動時のサーバプロセス数を指定するパラメタです。

詳細については，マニュアル「Hitachi Web Server」を参照してください。

設定先のファイル：httpsd.conf（Hitachi Web Server定義ファイル）

(d)　HWSKeepStartServers

展開規則

「On」が展開されます。

実パラメタの説明

Hitachi Web Serverで，サーバプロセスの稼働数をStartServersパラメタに指定した数だけ維持するかどうかを指定するパラメタです。

詳細については，マニュアル「Hitachi Web Server」を参照してください。

設定先のファイル：httpsd.conf（Hitachi Web Server定義ファイル）

(e)　KeepAliveTimeout

展開規則

「3」（秒）が展開されます。

実パラメタの説明

KeepAliveTimeoutは，HTTP1.1の持続型接続をしているときの，コネクションを持続する時間を指定するパラメタです。

持続型接続を使用する場合（KeepAliveディレクティブをオンにする場合），レスポンスの高速化のため，クライアントからのリクエストに対して応答を返したあともコネクションを切断しないで，同じクライアントからの次のリクエストを待ちます。このため，KeepAliveTimeoutでタイムアウト時間を設定します。

詳細については，マニュアル「Hitachi Web Server」を参照してください。

設定先のファイル：httpsd.conf（Hitachi Web Server定義ファイル）

(f)　webserver.connector.ajp13.backlog

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

リダイレクタからの接続要求の最大の待ち行列数を指定します。

設定先のファイル：usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

(g)　webserver.connector.ajp13.max_threads

展開規則

リクエスト最大同時処理数がそのまま展開されます。

実パラメタの説明

Webコンテナがリクエストを処理する同時実行数を指定します。

設定先のファイル：usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

(2)　抽象パラメタの展開例

cmx_trans_paramコマンドを実行すると物理ティアの定義（<tier>タグの定義）の<configuration>タグに，次の表に示すパラメタが自動展開されて，抽象パラメタ展開済み簡易構築定義ファイルが作成されます。

表B-1　cmx_trans_paramコマンドによって自動展開されるパラメタ一覧

logical-server-type | param-name
web-server | ThreadsPerChild
MaxClients
StartServers
HWSKeepStartServers
KeepAliveTimeout
j2ee-server | webserver.connector.ajp13.backlog
webserver.connector.ajp13.max_threads

なお，パラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を，抽象パラメタの展開規則については，「付録B.2　抽象パラメタによって展開される実パラメタ」を参照してください。

抽象パラメタ展開済み簡易構築定義ファイルの内容を，次に示します（一部抜粋）。

抽象パラメタ展開済み簡易構築定義ファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <web-system>
   <name>MyWebSystem</name>
   <!-- 負荷分散機の定義 -->
   <load-balancer>
     :
   </load-balancer>
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>

     <!-- Generate web-server configuration by cmx_trans_param -->
     <configuration>
       <logical-server-type>web-server</logical-server-type>
       <param>
         <param-name>ThreadsPerChild</param-name>
         <param-value>40</param-value>
       </param>
       <param>
         <param-name>MaxClients</param-name>
         <param-value>40</param-value>
       </param>
       <param>
         <param-name>StartServers</param-name>
         <param-value>40</param-value>
       </param>
       <param>
         <param-name>HWSKeepStartServers</param-name>
         <param-value>On</param-value>
       </param>
       <param>
         <param-name>KeepAliveTimeout</param-name>
         <param-value>3</param-value>
       </param>
     </configuration>

     <!-- Generate j2ee-server configuration by cmx_trans_param -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
         <param-name>webserver.connector.ajp13.backlog</param-name>
         <param-value>40</param-value>
       </param>
       <param>
         <param-name>webserver.connector.ajp13.max_threads</param-name>
         <param-value>20</param-value>
       </param>
         :
     </configuration>
   </tier>
   <!-- サービスユニットの定義 -->
   <unit>
     :
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   :
 </host>
</model-definition>

注　太字の部分が自動展開された定義です。

(3)　Connector属性ファイルのパラメタの値

Connector属性ファイルの，MaxPoolSizeおよびMinPoolSizeのパラメタについては，抽象パラメタの値を基に設定値を決定できます。これらのパラメタは，cmx_trans_paramコマンドで自動的に設定されません。手動でConnector属性ファイルに設定し，リソースアダプタをデプロイしてください。

(a)　MaxPoolSize

設定値

リクエスト最大同時処理数に設定した値を設定します。

実パラメタの説明

コネクションプールの最大値を指定します。

設定先のファイル：Connector属性ファイル

(b)　MinPoolSize

設定値

リクエスト最大同時処理数に設定した値を設定します。

実パラメタの説明

コネクションプールの最小値を指定します。

設定先のファイル：Connector属性ファイル

付録C　JP1/SC/DPMを利用したスケールアウト時に削除するログファイル

JP1/SC/DPMを利用して，Webシステムをスケールアウトする際に，複製元アプリケーションサーバのログファイルを削除する必要があります。Smart Composer機能を使用して構築できるシステムごとに，削除が必要なログファイルが格納されているディレクトリの一覧を次に示します。

＜この節の構成＞

(1)　J2EEアプリケーションを実行するシステムの場合

(2)　バッチアプリケーションを実行するシステムの場合

(1)　J2EEアプリケーションを実行するシステムの場合

J2EEアプリケーションを実行するシステムの場合，複製元アプリケーションサーバで，次の表に示すディレクトリ下にログファイルがある場合は削除してください。なお，ログファイルが格納されているディレクトリは，削除対象外です。削除対象ログファイルが格納されているディレクトリパスを次の表に示します。

表C-1　削除対象ログファイルが格納されているディレクトリパス（Windowsの場合）

項番 | ディレクトリパス
1 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*
2 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥*
3 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥mmap¥*
4 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥*
5 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥mmap¥*
6 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥mmap¥*
7 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥*
8 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥comtrc¥*
9 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥mdltrc¥*
10 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥*
11 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥mmap¥*
12 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥system¥ejbcl¥*
13 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥system¥ejbcl¥mmap¥*
14 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥*
15 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥comtrc¥*
16 | <Cosminexusのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥mdltrc¥*
17 | <Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥*
18 | <Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥*
19 | <Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*
20 | <Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*
21 | <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs¥*
22 | <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs¥mmap¥*
23 | <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<サーバ名>¥logs¥*
24 | <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<サーバ名>¥logs¥mmap¥*
25 | <Cosminexusのインストールディレクトリ>¥manager¥spool¥default¥*
26 | <Cosminexusのインストールディレクトリ>¥manager¥spool¥lsinfo¥*
27 | <Cosminexusのインストールディレクトリ>¥manager¥tmp¥*
28 | <Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥*
29 | <Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥maintenance¥*
30 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥*
31 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥CC¥maintenance¥*
32 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥CC¥rmi¥*
33 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥connectors¥*
34 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥connectors¥<アプリケーション表示名>¥*
35 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥connectors¥TEST#¥<アプリケーション表示名>¥*
36 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥http¥*
37 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥http¥comm¥*
38 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥http¥thr¥*
39 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥*
40 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*
41 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*
42 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥watch¥*
43 | <Managerのログ出力ディレクトリ>※2¥*
44 | <Managerのログ出力ディレクトリ>※2¥maintenance¥*
45 | <Managerのログ出力ディレクトリ>※2¥maintenance¥mmap¥*
46 | <Managerのログ出力ディレクトリ>※2¥message¥*
47 | <Managerのログ出力ディレクトリ>※2¥message¥mmap¥*
48 | <Managerのログ出力ディレクトリ>※2¥trace¥*
49 | <Managerのログ出力ディレクトリ>※2¥trace¥mmap¥*
50 | <snapshotログの出力先ディレクトリ>※3¥*
51 | <監査ログ出力ディレクトリ>※4¥*
52 | <監査ログのメッセージログ出力ディレクトリ>※5¥*
53 | <監査ログのメッセージログ出力ディレクトリ>※5¥mmap¥*
54 | <監査ログの例外情報ログ出力ディレクトリ>※6¥*
55 | <監査ログの例外情報ログ出力ディレクトリ>※6¥mmap¥*

注※1

<Cosminexusの作業ディレクトリ>は，usrconf.cfgのejb.public.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」です。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）のcom.cosminexus.manager.log.dirキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥manager¥log」です。

注※3

<snapshopログの出力先ディレクトリ>は，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーに設定されているディレクトリです。デフォルト値は，「<Managerのログ出力ディレクトリ>¥snapshot」です。

注※4

<監査ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

注※5

<監査ログのメッセージログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.message.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

注※6

<監査ログの例外情報ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.exception.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

表C-2　削除対象ログファイルが格納されているディレクトリパス（Linuxの場合）

項番 | ディレクトリパス
1 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/*
2 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/maintenance/*
3 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/maintenance/mmap/*
4 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/rmi/*
5 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/rmi/mmap/*
6 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/mmap/*
7 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/*
8 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/comtrc/*
9 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/mdltrc/*
10 | <Cosminexusのインストールディレクトリ>/CC/client/logs/*
11 | <Cosminexusのインストールディレクトリ>/CC/client/logs/mmap/*
12 | <Cosminexusのインストールディレクトリ>/CC/client/logs/system/ejbcl/*
13 | <Cosminexusのインストールディレクトリ>/CC/client/logs/system/ejbcl/mmap/*
14 | <Cosminexusのインストールディレクトリ>/CC/client/logs/system/TPB/logj/*
15 | <Cosminexusのインストールディレクトリ>/CC/client/logs/system/TPB/logj/comtrc/*
16 | <Cosminexusのインストールディレクトリ>/CC/client/logs/system/TPB/logj/mdltrc/*
17 | <Cosminexusのインストールディレクトリ>/CC/web/containers/<サーバ名>/logs/*
18 | <Cosminexusのインストールディレクトリ>/CC/web/containers/<サーバ名>/logs/TPB/logj/*
19 | <Cosminexusのインストールディレクトリ>/CC/web/containers/<サーバ名>/logs/TPB/logj/comtrc/*
20 | <Cosminexusのインストールディレクトリ>/CC/web/containers/<サーバ名>/logs/TPB/logj/mdltrc/*
21 | <Cosminexusのインストールディレクトリ>/CC/web/redirector/logs/*
22 | <Cosminexusのインストールディレクトリ>/CC/web/redirector/logs/mmap/*
23 | <Cosminexusのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名>/logs/*
24 | <Cosminexusのインストールディレクトリ>/CC/web/redirector/servers/<サーバ名>/logs/mmap/*
25 | <Cosminexusのインストールディレクトリ>/manager/spool/default/*
26 | <Cosminexusのインストールディレクトリ>/manager/spool/lsinfo/*
27 | <Cosminexusのインストールディレクトリ>/manager/tmp/*
28 | <Cosminexusのインストールディレクトリ>/manager/setup/log/*
29 | <Cosminexusのインストールディレクトリ>/manager/setup/log/maintenance/*
30 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/*
31 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/CC/maintenance/*
32 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/CC/rmi/*
33 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/connectors/*
34 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/connectors/<アプリケーション表示名>/*
35 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/connectors/TEST#/<アプリケーション表示名>/*
36 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/http/*
37 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/http/comm/*
38 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/http/thr/*
39 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/*
40 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/comtrc/*
41 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/mdltrc/*
42 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/watch/*
43 | <Managerのログ出力ディレクトリ>※2/*
44 | <Managerのログ出力ディレクトリ>※2/maintenance/*
45 | <Managerのログ出力ディレクトリ>※2/maintenance/mmap/*
46 | <Managerのログ出力ディレクトリ>※2/message/*
47 | <Managerのログ出力ディレクトリ>※2/message/mmap/*
48 | <Managerのログ出力ディレクトリ>※2/trace/*
49 | <Managerのログ出力ディレクトリ>※2/trace/mmap/*
50 | <snapshotログの出力先ディレクトリ>※3/*
51 | <監査ログ出力ディレクトリ>※4/*
52 | <監査ログのメッセージログ出力ディレクトリ>※5/*
53 | <監査ログのメッセージログ出力ディレクトリ>※5/mmap/*
54 | <監査ログの例外情報ログ出力ディレクトリ>※6/*
55 | <監査ログの例外情報ログ出力ディレクトリ>※6/mmap/*

注※1

<Cosminexusの作業ディレクトリ>は，usrconf.cfgのejb.public.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/CC/server/public」です。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）のcom.cosminexus.manager.log.dirキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/manager/log」です。

注※3

<snapshopログの出力先ディレクトリ>は，adminagent.propertiesファイル（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーに設定されているディレクトリです。デフォルト値は，「<Managerのログ出力ディレクトリ>/snapshot」です。

注※4

<監査ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

注※5

<監査ログのメッセージログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.message.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

注※6

<監査ログの例外情報ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.exception.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

(2)　バッチアプリケーションを実行するシステムの場合

バッチアプリケーションを実行するシステムの場合，複製元アプリケーションサーバで，次の表に示すディレクトリ下にログファイルがある場合は削除してください。なお，ログファイルが格納されているディレクトリは，削除対象外です。削除対象ログファイルが格納されているディレクトリパスを次の表に示します。

表C-3　削除対象ログファイルが格納されているディレクトリパス（Windowsの場合）

項番 | ディレクトリパス
1 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥*
2 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥*
3 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥mmap¥*
4 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥*
5 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥mmap¥*
6 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥mmap¥*
7 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥*
8 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥comtrc¥*
9 | <Cosminexusのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥mdltrc¥*
10 | <Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥*
11 | <Cosminexusのインストールディレクトリ>¥CC¥batch¥logs¥mmap¥*
12 | <Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥*
13 | <Cosminexusのインストールディレクトリ>¥manager¥spool¥default¥*
14 | <Cosminexusのインストールディレクトリ>¥manager¥spool¥lsinfo¥*
15 | <Cosminexusのインストールディレクトリ>¥manager¥tmp¥*
16 | <Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥*
17 | <Cosminexusのインストールディレクトリ>¥manager¥setup¥log¥maintenance¥*
18 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥*
19 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥CC¥maintenance¥*
20 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥CC¥rmi¥*
21 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥connectors¥*
22 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥*
23 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*
24 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*
25 | <Cosminexusの作業ディレクトリ>※1¥ejb¥<サーバ名>¥logs¥watch¥*
26 | <Managerのログ出力ディレクトリ>※2¥*
27 | <Managerのログ出力ディレクトリ>※2¥maintenance¥*
28 | <Managerのログ出力ディレクトリ>※2¥maintenance¥mmap¥*
29 | <Managerのログ出力ディレクトリ>※2¥message¥*
30 | <Managerのログ出力ディレクトリ>※2¥message¥mmap¥*
31 | <Managerのログ出力ディレクトリ>※2¥trace¥*
32 | <Managerのログ出力ディレクトリ>※2¥trace¥mmap¥*
33 | <snapshotログの出力先ディレクトリ>※3¥*
34 | <監査ログ出力ディレクトリ>※4¥*
35 | <監査ログのメッセージログ出力ディレクトリ>※5¥*
36 | <監査ログのメッセージログ出力ディレクトリ>※5¥mmap¥*
37 | <監査ログの例外情報ログ出力ディレクトリ>※6¥*
38 | <監査ログの例外情報ログ出力ディレクトリ>※6¥mmap¥*

注※1

<Cosminexusの作業ディレクトリ>は，usrconf.cfgのejb.public.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」です。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）のcom.cosminexus.manager.log.dirキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥manager¥log」です。

注※3

<snapshopログの出力先ディレクトリ>は，adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーに設定されているディレクトリです。デフォルト値は，「<Managerのログ出力ディレクトリ>¥snapshot」です。

注※4

<監査ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

注※5

<監査ログのメッセージログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.message.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

注※6

<監査ログの例外情報ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.exception.directoryキーに設定されているディレクトリです。デフォルト値は，「<Cosminexusのインストールディレクトリ>¥auditlog」です。

表C-4　削除対象ログファイルが格納されているディレクトリパス（Linuxの場合）

項番 | ディレクトリパス
1 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/*
2 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/maintenance/*
3 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/maintenance/mmap/*
4 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/rmi/*
5 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/CC/rmi/mmap/*
6 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/mmap/*
7 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/*
8 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/comtrc/*
9 | <Cosminexusのインストールディレクトリ>/CC/admin/logs/TPB/logj/mdltrc/*
10 | <Cosminexusのインストールディレクトリ>/CC/batch/logs/*
11 | <Cosminexusのインストールディレクトリ>/CC/batch/logs/mmap/*
12 | <Cosminexusのインストールディレクトリ>/CC/web/containers/<サーバ名>/logs/*
13 | <Cosminexusのインストールディレクトリ>/manager/spool/default/*
14 | <Cosminexusのインストールディレクトリ>/manager/spool/lsinfo/*
15 | <Cosminexusのインストールディレクトリ>/manager/tmp/*
16 | <Cosminexusのインストールディレクトリ>/manager/setup/log/*
17 | <Cosminexusのインストールディレクトリ>/manager/setup/log/maintenance/*
18 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/*
19 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/CC/maintenance/*
20 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/CC/rmi/*
21 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/connectors/*
22 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/*
23 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/comtrc/*
24 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/TPB/logj/mdltrc/*
25 | <Cosminexusの作業ディレクトリ>※1/ejb/<サーバ名>/logs/watch/*
26 | <Managerのログ出力ディレクトリ>※2/*
27 | <Managerのログ出力ディレクトリ>※2/maintenance/*
28 | <Managerのログ出力ディレクトリ>※2/maintenance/mmap/*
29 | <Managerのログ出力ディレクトリ>※2/message/*
30 | <Managerのログ出力ディレクトリ>※2/message/mmap/*
31 | <Managerのログ出力ディレクトリ>※2/trace/*
32 | <Managerのログ出力ディレクトリ>※2/trace/mmap/*
33 | <snapshotログの出力先ディレクトリ>※3/*
34 | <監査ログ出力ディレクトリ>※4/*
35 | <監査ログのメッセージログ出力ディレクトリ>※5/*
36 | <監査ログのメッセージログ出力ディレクトリ>※5/mmap/*
37 | <監査ログの例外情報ログ出力ディレクトリ>※6/*
38 | <監査ログの例外情報ログ出力ディレクトリ>※6/mmap/*

注※1

<Cosminexusの作業ディレクトリ>は，usrconf.cfgのejb.public.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/CC/server/public」です。

注※2

<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）のcom.cosminexus.manager.log.dirキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/manager/log」です。

注※3

<snapshopログの出力先ディレクトリ>は，adminagent.propertiesファイル（運用管理エージェントプロパティファイル）のadminagent.snapshotlog.log_dirキーに設定されているディレクトリです。デフォルト値は，「<Managerのログ出力ディレクトリ>/snapshot」です。

注※4

<監査ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

注※5

<監査ログのメッセージログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.message.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

注※6

<監査ログの例外情報ログ出力ディレクトリ>は，auditlog.properties（監査ログ定義ファイル）のauditlog.raslog.exception.directoryキーに設定されているディレクトリです。デフォルト値は，「/opt/Cosminexus/auditlog」です。

付録D　JP1/Cm2/NCとの連携

Cosminexusから負荷分散機を制御する場合，JP1/Cm2/NCと連携して制御することもできます。JP1/Cm2/NCは，負荷分散機を含むスイッチ機器の設定を一元管理したい場合に利用してください。

ここでは，JP1/Cm2/NCと連携したときの製品構成およびプロセス構成と，JP1/Cm2/NCを使用するための設定について説明します。

＜この節の構成＞

付録D.1　JP1/Cm2/NCと連携したときの製品構成およびプロセス構成

付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定

付録D.1　JP1/Cm2/NCと連携したときの製品構成およびプロセス構成

JP1/Cm2/NCと連携したときの製品構成およびプロセス構成について説明します。

＜この項の構成＞

(1)　Webシステムの製品構成およびプロセス構成

(2)　運用管理サーバマシンの製品構成およびプロセス構成

(3)　運用管理サーバのOSがUNIXの場合

(1)　Webシステムの製品構成およびプロセス構成

JP1/Cm2/NCと連携する場合のWebシステムの製品構成およびプロセス構成を次の図に示します。

図D-1　JP1/Cm2/NCと連携する場合の製品構成およびプロセス構成

運用管理サーバマシン内の製品構成およびプロセス構成については(2)で説明します。なお，それ以外のサーバマシンの説明については，「4.2　製品構成およびプロセス構成」を参照してください。

(2)　運用管理サーバマシンの製品構成およびプロセス構成

Cosminexusから負荷分散機を制御する場合で，JP1/Cm2/NCを使用するときの，運用管理サーバマシン内の製品構成，および動作するプロセスを次の表に示します。

表D-1　運用管理サーバマシンにインストールする製品と動作するプロセス

インストールする製品 | 動作するプロセス
Application Server | Management Server
JP1/Cm2/NC - Manager | JP1/Cm2/NC - Manager
JP1/Cm2/NC - Manager for Cosminexus | JP1/Cm2/NC - Manager for Cosminexus ランタイム部
JP1/Cm2/NC - Manager for Cosminexus アダプター部

(3)　運用管理サーバのOSがUNIXの場合

JP1/Cm2/NCがインストールされている運用管理サーバが，UNIXの場合は，運用管理サーバマシンとは別に，JP1/Cm2/NC管理サーバマシンを1台用意する必要があります。

運用管理サーバがUNIXの場合のシステム構成を次の図に示します。なお，次の図のアプリケーションサーバマシン内のプロセス構成については，(1)を参照してください。

図D-2　運用管理サーバがUNIXの場合のシステム構成

JP1/Cm2/NC管理サーバマシンには，JP1/Cm2/NC - ManagerとJP1/Cm2/NC - Manager for Cosminexusのアダプター部をインストールします。一方，運用管理サーバマシンには，JP1/Cm2/NC - Manager for Cosminexusのランタイム部をインストールします。なお，JP1/Cm2/NC - Manager，およびJP1/Cm2/NC - Manager for Cosminexusのインストールについては，マニュアル「JP1 Version 8 JP1/Cm2/Network Element Configuration　機能・構築ガイド」またはマニュアル「JP1 Version 7i JP1/Cm2/Network Element Configuration」を参照してください。

付録D.2　JP1/Cm2/NCを使用して負荷分散機を制御するための設定

JP1/Cm2/NCを使用して負荷分散機を制御する場合，JP1/Cm2/NC - Manager，およびJP1/Cm2/NC - Manager for Cosminexusの設定が必要になります。なお，JP1/Cm2/NCを使用して負荷分散機を制御する場合，BIG-IP 1500は使用できません。また，負荷分散機を冗長化したシステムは構築できません。

ここでは，運用管理サーバまたはJP1/Cm2/NC管理サーバにインストールされたJP1/Cm2/NC - Manager，およびJP1/Cm2/NC - Manager for Cosminexusの設定について説明します。Smart Composer機能で負荷分散機の設定や，実サーバポートの開始および閉塞を制御する場合に必要な設定です。

JP1/Cm2/NCを使用して負荷分散機を制御するための設定は，アプリケーションサーバ，および運用管理サーバの初期設定が終わったあとに実施します。Smart Composer機能でのシステム構築の流れについては，「6.1.2　WebサーバとJ2EEサーバを同じサーバマシンに配置する構成のシステムを構築する流れ」を参照してください。

なお，JP1/Cm2/NCの設定の詳細については，マニュアル「JP1 Version 8 JP1/Cm2/Network Element Configuration　機能・構築ガイド」またはマニュアル「JP1 Version 7i JP1/Cm2/Network Element Configuration」を参照してください。

＜この項の構成＞

(1)　JP1/Cm2/NC - Managerの設定

(2)　JP1/Cm2/NC - Manager for Cosminexusアダプター部の設定

(3)　JP1/Cm2/NC - Manager for Cosminexusランタイム部のセットアップ

(4)　負荷分散機への接続の設定

(5)　JP1/Cm2/NCのサービスの起動

(1)　JP1/Cm2/NC - Managerの設定

JP1/Cm2/NC - Managerの設定について説明します。

(a)　ncmadpt.confの編集

JP1/Cm2/NC - Managerが接続するアダプタサーバを識別する名称を定義します。なお，アダプタサーバとは，JP1/Cm2/NC - Manager for Cosminexusアダプター部がインストールされたサーバです。ここでは，「AdpCosmi」を設定します。

ncmadpt.confファイルの編集内容を，次に示します。

[Adaptor List]
adpt_name=AdpCosmi

ncmadpt.confファイルは，次の場所に格納されています。

<JP1/Cm2/NCインストールディレクトリ>¥manager¥conf¥

注意事項

adpt_nameキーには，nca.confファイルのadpt_nameキーと同じ値を設定してください。

(b)　JP1/Cm2/NC - Managerのログインユーザの設定

ncmuserコマンドを使用して，JP1/Cm2/NC - Managerのログインユーザを設定します。

ユーザID（ncm_admin），パスワード（ncm_admin_passwd）を設定する場合の例を示します。

次のコマンドを入力します。

<JP1/Cm2/NCインストールディレクトリ>¥manager¥bin¥ncmuser -n -np ncm_admin_passwd ncm_admin

(c)　JP1/Cm2/NC - Managerの自動起動の設定

JP1/Cm2/NC - Managerを自動起動する設定をします。

Windowsのサービス管理コンソールで，「JP1/Cm2/NC - Manager」を選択し，スタートアップの種類を「自動」に設定してください。

(2)　JP1/Cm2/NC - Manager for Cosminexusアダプター部の設定

JP1/Cm2/NC - Manager for Cosminexusアダプター部の設定について説明します。

(a)　nca.confの編集

JP1/Cm2/NC - Manager for Cosminexusアダプター部をインストールしたサーバを識別する名称を定義します。ここでは，「AdpCosmi」を設定します。

nca.confファイルの編集内容を，次に示します。

[Adaptor]
adpt_name=AdpCosmi
...

nca.confファイルは，次の場所に格納されています。

<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥conf¥

注意事項

adpt_nameキーには，ncmadpt.confファイルのadpt_nameキーと同じ値を設定してください。

(b)　Telnetパラメタ定義ファイルのコピー

Telnetパラメタ定義ファイルをコピーします。

Telnetに接続するユーザのログインIDやパスワードの入力を求めるメッセージ，ログイン完了後に表示するプロンプトを定義しているファイルです。ここでは，デフォルトのまま使用します。

<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥newconfig¥telnet_lf_sample.confを<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥confにコピーします。

(c)　ncaswitch.confの編集

負荷分散機の基本情報（ホスト名またはIPアドレス，モデル名，TelnetのユーザID，Telnetのポート番号，Telnetパラメタ定義ファイル名）を設定します。

ncaswitch.confファイルの編集内容の例を次に示します。

負荷分散機がBIG-IP 1000の場合

[Switch]
switch_name=192.168.100.10
model=BIG-IP
telnet_id=lfuser
telnet_port=23
telnet_param_file=telnet_lf_sample.conf

注

JP1/Cm2/NCが標準提供しているtelnet_lf_sample.confファイルは，Loadflowbal用に設定されているため，BIG-IP 1000の場合は，ファイルの内容を修正する必要があります。ファイルの内容を，次のように設定してください。

[Login]login_string="login: "
login_pw_string="Password:"
login_prompt="# "

負荷分散機がLoadflowbalの場合

[Switch]
switch_name=192.168.100.10
model=Loadflowbal
telnet_id=lfuser
telnet_port=23
telnet_param_file=telnet_lf_sample.conf

ncaswitch.confファイルは，次の場所に格納されています。

<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥conf¥

注意事項

switch_nameキーには，簡易構築定義ファイル（「6.8　システムの構成定義」参照）の負荷分散機定義（<load-balancer>タグの定義）に指定する負荷分散機の管理用IPアドレス（<agent-host>タグ）と同じ値を指定してください。

telnet_idキーには，負荷分散機のローカルユーザアカウントの設定（「6.3　負荷分散機の設定」参照）で指定した，ユーザIDを指定してください。

modelキーには，簡易構築定義ファイル（「6.8　システムの構成定義」参照）の負荷分散機定義（<load-balancer>タグの定義）に指定する負荷分散機の種類（<load-balancer-type>タグ）と同じ値（「BIG-IP」または「Loadflowbal」）を指定してください。

(d)　Telnetローカルユーザアカウントのパスワードの登録

ncacopwdコマンドを使用して，Telnetローカルユーザアカウントのパスワードを登録します。JP1/Cm2/NC - Manager for Cosminexusが負荷分散機に接続するために必要です。

負荷分散機（IPアドレス=192.168.100.10）にパスワード（lfuser_passwd）を登録する場合の例を示します。

次のコマンドを入力します。

<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥bin¥ncacopwd -n -s 192.168.100.10 -nt lfuser_passwd

(e)　JP1/Cm2/NC - Manager for Cosminexusの自動起動の設定

JP1/Cm2/NC - Manager for Cosminexusを自動起動するための設定をします。

Windowsのサービス管理コンソールで，「JP1/Cm2/NC - Manager-CO」を選択し，スタートアップの種類を「自動」に設定してください。

(3)　JP1/Cm2/NC - Manager for Cosminexusランタイム部のセットアップ

JP1/Cm2/NC - Manager for Cosminexusランタイム部をセットアップします。セットアップ方法をOSごとに示します。

Windowsの場合

<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥runtime¥ncmcoruntime.exeを実行して，任意のディレクトリに展開します。

<任意のディレクトリ>¥ncmcoruntime¥Setup.exeを実行し，指示に従って，JP1/Cm2/NC - Manager for Cosminexusランタイム部をセットアップしてください。

UNIXの場合

JP1/Cm2/NC管理サーバにインストールされている，<JP1/Cm2/NCインストールディレクトリ>¥manager-co¥runtime¥ncmcoruntime_rhl.tarを，運用管理サーバの任意のディレクトリにコピーして展開してください。

AIXの場合

# cd /
# tar xvf <任意のディレクトリ>/ncmcoruntime_aix.tar .

HP-UXの場合

# cd /
# tar xvf <任意のディレクトリ>/ncmcoruntime_hpux.tar .

Linuxの場合

# cd /
# tar xvpkf <任意のディレクトリ>/ncmcoruntime_rhl.tar .

Solarisの場合

# cd /
# tar xvf <任意のディレクトリ>/ncmcoruntime_solaris.tar .

(4)　負荷分散機への接続の設定

lb.propertiesファイル（負荷分散機定義プロパティファイル）に，負荷分散機へのアクセスに必要な接続情報を設定します。

lb.propertiesファイルは，次の場所に格納されています。

Windowsの場合

<Cosminexusインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

次のキーを設定します。

ncm.host
JP1/Cm2/NC - Managerが稼働しているサーバ名またはIPアドレスを指定します。

ncm.port
JP1/Cm2/NC - Managerの接続ポート番号を指定します。省略した場合，20344が仮定されます。指定できる値は1～65535の整数です。

ncm.user
(1)で設定した，JP1/Cm2/NC - ManagerにログインするためのユーザIDを設定します。

ncm.passwd
(1)で設定した，JP1/Cm2/NC - Managerにログインするためのパスワードを設定します。

lb.list
負荷分散機の管理IPアドレスを設定します。負荷分散機が複数ある場合はコンマで区切って指定します。

lb.enable_passwd.<負荷分散機の管理IPアドレス>
負荷分散機に設定したPrivileged EXECレベルに必要なパスワードを設定します。このキーの設定は，負荷分散機がLoadflowbalの場合だけ設定します。BIG-IP 1000の場合は，設定しても無効になります。

なお，設定するキーの詳細については，「13.6　lb.properties（負荷分散機定義プロパティファイル）」を参照してください。

lb.propertiesファイルの設定例を，次に示します。

ncm.host=192.168.100.100
#ncm.port=20344
ncm.user=ncm_admin
ncm.passwd=ncm_admin_passwd

lb.list=192.168.100.10
lb.enable_passwd.192.168.100.10=privileged_exec_passwd

注意事項

lb.propertiesファイルには，JP1/Cm2/NC - ManagerのログインユーザID／パスワード，およびLoadflowbalのPrivileged EXECレベルパスワードを記述するため，これらの情報が漏洩しないように適切にファイルのアクセス権を設定してください。

(5)　JP1/Cm2/NCのサービスの起動

ここで，JP1/Cm2/NCのサービスを起動します。起動方法を示します。

netコマンドを使用してJP1/Cm2/NCのサービスを起動します。

<OSインストールディレクトリ>¥system32¥net start "JP1/Cm2/NC - Manager"
<OSインストールディレクトリ>¥system32¥net start "JP1/Cm2/NC - Manager-CO"

付録E　論理サーバのコンフィグレーションに指定できるパラメタ（互換用）

ここでは，論理サーバのコンフィグレーションに指定できるパラメタのうち，互換用のパラメタについて説明します。

互換用のパラメタがあるのは，次のパラメタです。

各論理サーバ共通で指定できるパラメタ

論理Webサーバで指定できるパラメタ

論理J2EEサーバで指定できるパラメタ

論理SFOサーバで指定できるパラメタ

ポイント

ここで説明するパラメタは互換用です。新しく定義する項目については，推奨のパラメタを使用することをお勧めします。推奨のパラメタについては，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。なお，推奨のパラメタと互換用のパラメタを両方指定した場合，推奨のパラメタが有効になります。

＜この節の構成＞

付録E.1　各論理サーバ共通で指定できるパラメタ（互換用）

付録E.2　論理Webサーバで指定できるパラメタ（互換用）

付録E.3　論理J2EEサーバで指定できるパラメタ（互換用）

付録E.4　論理SFOサーバで指定できるパラメタ（互換用）

付録E.1　各論理サーバ共通で指定できるパラメタ（互換用）

ここでは，次に示す論理サーバで共通に指定できるパラメタについて説明します。

論理Webサーバ

論理J2EEサーバ

論理パフォーマンストレーサ

論理SFOサーバ

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

各論理サーバに共通で指定できる互換用のパラメタについて，次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。「推奨のparam-name指定値」とは，互換用のパラメタに対応する，推奨のパラメタです。

表E-1　各論理サーバ共通で指定できるパラメタ（互換用）

param-name指定値 | param-value指定値 | 省略値 | 推奨のparam-name指定値
user.env.variable.m | サーバ起動時の環境変数の名称および値を，「変数名=値」の形式で指定します。※ | なし | user.env.variable

注※

値を複数指定する際は，複数の<param-value>で指定します。

また，パラメタを有効にする場合は，文字列の先頭に’.’を付加して指定します。無効にしたい場合は，文字列の先頭に’#’を付加して指定します。

（例）

　　<param-name>user.env.variable.m</param-name>

　　<param-value>.AAA=XXX</param-value>

　　<param-value>#BBB=XXX</param-value>

付録E.2　論理Webサーバで指定できるパラメタ（互換用）

論理Webサーバに共通で指定できる互換用のパラメタについて，次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。「推奨のparam-name指定値」とは，互換用のパラメタに対応する，推奨のパラメタです。

表E-2　論理Webサーバで指定できるパラメタ（互換用）

param-name指定値
param-value指定値
省略値
推奨のparam-name指定値

JkGatewayHost.value
ゲートウェイのホスト名を255文字以内で指定します。
なし
JkGatewayHost

JkGatewayPort.value
ゲートウェイのポート番号を1～65535の範囲で指定します。
なし
JkGatewayPort

Listen.host.value
一つのマシンに複数のアドレスが割り当てられている場合に，Webサーバを特定のアドレスに割り当てるかどうかを指定します。
true：割り当てます。
false：割り当てません。
false
Listen

Port
Webブラウザからの要求を受け付けるサーバのポート番号を1～65535の範囲で指定します。
80
Listen

urlmap.m
リダイレクタがJ2EEサーバにリクエストを振り分ける際の振り分け対象URLのパターンを指定します。※
urlmap.mには，mod_jk.confファイルのJkMountキーで指定したURLを指定できます。
./*（すべてのリクエストが対象）
JkMount

worker.cachesize
リダイレクタで再利用するワーカのコネクション数を1～2147483647の範囲で指定します。
64
worker.<ワーカ名>.cachesize

worker.receive_timeout
リダイレクタで再利用するワーカのコネクションの通信タイムアウト値を0～3600の範囲（単位：秒）で指定します。
3600
worker.<ワーカ名>.receive_timeout

注※

値を複数指定する際は，複数の<param-value>で指定します。

また，パラメタを有効にする場合は，文字列の先頭に’.’を付加して指定します。無効にしたい場合は，文字列の先頭に’#’を付加して指定します。

（例）

　　<param-name>urlmap.m</param-name>

　　<param-value>.ssss</param-value>

　　<param-value>#rrrr</param-value>

付録E.3　論理J2EEサーバで指定できるパラメタ（互換用）

論理J2EEサーバに共通で指定できる互換用のパラメタについて，次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。「推奨のparam-name指定値」とは，互換用のパラメタに対応する，推奨のパラメタです。

表E-3　論理J2EEサーバで指定できるパラメタ（互換用）

param-name指定値
param-value指定値
省略値
推奨のparam-name指定値

add.jvm.arg.m
拡張起動パラメタを設定します。
JavaVMを起動するときに指定できるJavaVMのオプションを指定します。※1
なし
add.jvm.arg

ejbserver.manager.jp1event.enabled
JP1イベント発行機能を有効にするかどうかを指定します。
true：有効にします。
false：無効にします。
false
ejbserver.manager.agent.JP1EventAgent.enabled

ejbserver.rmi.naming.host.value
マルチホームドホスト環境で，J2EEサーバがプロバイダとして使用するRMIレジストリのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
ejbserver.rmi.naming.host

ex.param.m
J2EEサーバの拡張パラメタをJ2EEサーバで使用する任意のオプション※1で指定します。
なし
ex.param

ex.properties.m
JavaVMのシステムプロパティを指定します。※1
なし
ex.properties

http
管理用サーバ（簡易Webサーバ）のポート番号を1～65535の範囲で指定します。
8080
ejbserver.http.port

inprocess.ns.port
インプロセスのネーミングサービス用のポート番号を1～65535の範囲で指定します。
900
ejbserver.naming.startupMode,ejbserver.naming.host,ejbserver.naming.port

inprocess.ns.retryCount
インプロセスのネーミングサービス起動完了待ちリトライ回数を0～2147483647の範囲で指定します。
9
ejbserver.naming.startupRetryCount

inprocess.ns.waitTime
インプロセスのネーミングサービス起動完了待ち時間を0～2147483647の範囲（単位：秒）で指定します。
1
ejbserver.naming.startupWaitTime

jndi.rr.ns.list
ラウンドロビン検索のグループ名称とそのメンバを指定します。グループ名=メンバ名1[;メンバ名2]※2

注意

メンバ名にはCTM，J2EEサーバ，ネーミングサービスの論理サーバ名を指定します。

なし
ejbserver.jndi.namingservice.group.list

jvm.ms.size
JavaVMのメモリ使用量の初期サイズを0～9999999999の範囲（単位：メガバイト）で指定します。
jvm.ms.size ≦ jvm.mx.sizeの関係が成り立つ値を設定してください。
256
add.jvm.arg

jvm.mx.size
JavaVMのメモリ使用量の最大サイズを0～9999999999の範囲（単位：メガバイト）で指定します。
jvm.ms.size ≦ jvm.mx.sizeの関係が成り立つ値を設定してください。
512
add.jvm.arg

LogFile.Console.filenum
コンソールログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ConsoleLogFile.filenum

LogFile.Console.filesize
コンソールログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ConsoleLogFile.filesize

LogFile.EJBContainer.filenum
EJBコンテナ保守ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.EJBContainerLogFile.filenum

LogFile.EJBContainer.filesize
EJBコンテナ保守ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.EJBContainerLogFile.filesize

LogFile.Exception.filenum
例外ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ExceptionLogFile.filenum

LogFile.Exception.filesize
例外ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ExceptionLogFile.filesize

LogFile.Maintenance.filenum
保守ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
4
ejbserver.logger.channels.define.MaintenanceLogFile.filenum

LogFile.Maintenance.filesize
保守ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
16777216
ejbserver.logger.channels.define.MaintenanceLogFile.filesize

LogFile.Message.filenum
メッセージログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.MessageLogFile.filenum

LogFile.Message.filesize
メッセージログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.MessageLogFile.filesize

LogFile.UserErr.filenum
ユーザエラーログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.UserErrLogFile.filenum

LogFile.UserErr.filesize
ユーザエラーログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.UserErrLogFile.filesize

LogFile.UserOut.filenum
ユーザ出力ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.UserOutLogFile.filenum

LogFile.UserOut.filesize
ユーザ出力ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.UserOutLogFile.filesize

LogFile.WebAccess.filenum
Webコンテナトレースログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
16
ejbserver.logger.channels.define.WebAccessLogFile.filenum

LogFile.WebAccess.filesize
Webコンテナトレースログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
4194304
ejbserver.logger.channels.define.WebAccessLogFile.filesize

LogFile.WebContainer.filenum
Webコンテナ保守ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.WebContainerLogFile.filenum

LogFile.WebContainer.filesize
Webコンテナ保守ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.WebContainerLogFile.filesize

LogFile.WebServlet.filenum
Webサーブレットログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
4
ejbserver.logger.channels.define.WebServletLogFile.filenum

LogFile.WebServlet.filesize
Webサーブレットログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
4194304
ejbserver.logger.channels.define.WebServletLogFile.filesize

loglevel
ログの出力レベルを指定します。
Error：通常運用
Error,Warning：通常運用（verbose）
Error,Warning,Information：テスト時
Error,Warning,Information,Debug：障害調査
Error
ejbserver.logger.enabled.*

manager.mevent.sender.bind.host.value
Managementイベント発行機能のローカルアドレスを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
manager.mevent.sender.bind.host

mngagent.connector.host.value
J2EEコンテナの運用監視エージェントのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
mngagent.connector.host

mngagent.connector.port.value
J2EEコンテナの運用監視エージェントのポート番号を0～65535の範囲で指定します。
0は「自動」を表します。
0（自動）
mngagent.connector.port

mngagent.vbroker.se.iiop_tp.host.value
J2EEコンテナの運用監視エージェントのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
mngagent.connector.host

mngagent.vbroker.se.iiop_tp.scm.iiop_tp.listener.port.value
J2EEコンテナの運用監視エージェントのポート番号を0～65535の範囲で指定します。
0は「自動」を表します。
0（自動）
mngagent.connector.port

vbroker.se.iiop_tp.host.value
EJBコンテナでのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
vbroker.se.iiop_tp.host

WatchFile.ConnectionPool.filenum
コネクションプールの監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filenum

WatchFile.ConnectionPool.filesize
コネクションプールの監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ConnectionPoolWatchLogFile.filesize

WatchFile.FileDescriptor.filenum
ファイルディスクリプタ数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filenum

WatchFile.FileDescriptor.filesize
ファイルディスクリプタ数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filesize

WatchFile.HttpSession.filenum
HTTPセッション数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.HttpSessionWatchLogFile.filenum

WatchFile.HttpSession.filesize
HTTPセッション数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.HttpSessionWatchLogFile.filesize

WatchFile.Memory.filenum
メモリの監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.MemoryWatchLogFile.filenum

WatchFile.Memory.filesize
メモリの監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.MemoryWatchLogFile.filesize

WatchFile.RequestQueue.filenum
HTTPリクエスト実行待ちキューの監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.RequestQueueWatchLogFile.filenum

WatchFile.RequestQueue.filesize
HTTPリクエスト実行待ちキューの監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.RequestQueueWatchLogFile.filesize

WatchFile.Thread.filenum
スレッド数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ThreadWatchLogFile.filenum

WatchFile.Thread.filesize
スレッド数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ThreadWatchLogFile.filesize

WatchFile.Threaddump.filenum
スレッドダンプファイル数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filenum

WatchFile.Threaddump.filesize
スレッドダンプファイル数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filesize

webserver.connector.ajp13.bind_host.value
WebコンテナのWebサーバとの接続設定でホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
webserver.connector.ajp13.bind_host

webserver.connector.http.bind_host.value
Webコンテナの管理用サーバ（簡易Webサーバ）の設定でホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
webserver.connector.http.bind_host

webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.serverName
SFOフィルタのサーバ定義名に関連づけるSFOサーバ名を128文字以下で指定します。
なし
webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.naming

注※1

値を複数指定する際は，複数の<param-value>で指定します。

また，パラメタを有効にする場合は，文字列の先頭に’.’を付加して指定します。無効にしたい場合は，文字列の先頭に’#’を付加して指定します。

（例）

　　<param-name>ex.param.m</param-name>

　　<param-value>.ssss</param-value>

　　<param-value>#rrrr</param-value>

注※2

param-valueに値を複数指定する際は，コンマ（,）で区切って指定します。

（例）　<param-value>値1,値2,値3</param-value>

付録E.4　論理SFOサーバで指定できるパラメタ（互換用）

論理SFOサーバに共通で指定できる互換用のパラメタについて，次の表に示します。「省略値」とは，パラメタの指定がない場合に仮定される値です。「推奨のparam-name指定値」とは，互換用のパラメタに対応する，推奨のパラメタです。

表E-4　論理SFOサーバで指定できるパラメタ（互換用）

param-name指定値
param-value指定値
省略値
推奨のparam-name指定値

add.jvm.arg.m
拡張起動パラメタを設定します。
JavaVMを起動するときに指定できるJavaVMのオプションを指定します。※
なし
add.jvm.arg

ejbserver.rmi.naming.host.value
マルチホームドホスト環境で，J2EEサーバがプロバイダとして使用するRMIレジストリのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
ejbserver.rmi.naming.host

ex.param.m
SFOサーバの拡張パラメタをSFOサーバで使用する任意のオプション※で指定します。
なし
ex.param

ex.properties.m
JavaVMのシステムプロパティを指定します。※
なし
ex.properties

http
管理用サーバ（簡易Webサーバ）のポート番号を1～65535の範囲で指定します。
8080
ejbserver.http.port

inprocess.ns.port
インプロセスのネーミングサービス用のポート番号を1～65535の範囲で指定します。
900
ejbserver.naming.port

jvm.ms.size
JavaVMのメモリ使用量の初期サイズを0～9999999999の範囲（単位：メガバイト）で指定します。
jvm.ms.size ≦ jvm.mx.sizeの関係が成り立つ値を設定してください。
128
add.jvm.arg

jvm.mx.size
JavaVMのメモリ使用量の最大サイズを0～9999999999の範囲（単位：メガバイト）で指定します。
jvm.ms.size ≦ jvm.mx.sizeの関係が成り立つ値を設定してください。
128
add.jvm.arg

LogFile.Console.filenum
コンソールログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ConsoleLogFile.filenum

LogFile.Console.filesize
コンソールログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ConsoleLogFile.filesize

LogFile.EJBContainer.filenum
EJBコンテナ保守ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.EJBContainerLogFile.filenum

LogFile.EJBContainer.filesize
EJBコンテナ保守ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.EJBContainerLogFile.filesize

LogFile.Exception.filenum
例外ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ExceptionLogFile.filenum

LogFile.Exception.filesize
例外ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ExceptionLogFile.filesize

LogFile.Maintenance.filenum
保守ログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
4
ejbserver.logger.channels.define.MaintenanceLogFile.filenum

LogFile.Maintenance.filesize
保守ログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
16777216
ejbserver.logger.channels.define.MaintenanceLogFile.filesize

LogFile.Message.filenum
メッセージログのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.MessageLogFile.filenum

LogFile.Message.filesize
メッセージログのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.MessageLogFile.filesize

loglevel
ログの出力レベルを指定します。
Error：通常運用
Error,Warning：通常運用（verbose）
Error,Warning,Information：テスト時
Error,Warning,Information,Debug：障害調査
Error
ejbserver.logger.enabled.*

manager.mevent.sender.bind.host.value
Managementイベント発行機能のローカルアドレスを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
manager.mevent.sender.bind.host

mngagent.connector.host.value
J2EEコンテナの運用監視エージェントのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
mngagent.connector.host

mngagent.connector.port.value
J2EEコンテナの運用監視エージェントのポート番号を0～65535の範囲で指定します。
0は「自動」を表します。
0（自動）
mngagent.connector.port

vbroker.se.iiop_tp.host.value
EJBコンテナでのホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
vbroker.se.iiop_tp.host

WatchFile.FileDescriptor.filenum
ファイルディスクリプタ数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filenum

WatchFile.FileDescriptor.filesize
ファイルディスクリプタ数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.FileDescriptorWatchLogFile.filesize

WatchFile.Memory.filenum
メモリの監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.MemoryWatchLogFile.filenum

WatchFile.Memory.filesize
メモリの監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.MemoryWatchLogFile.filesize

WatchFile.Thread.filenum
スレッド数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ThreadWatchLogFile.filenum

WatchFile.Thread.filesize
スレッド数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ThreadWatchLogFile.filesize

WatchFile.Threaddump.filenum
スレッドダンプファイル数の監視結果出力ファイルのファイル面数を指定します。
指定できる値は，1，2，4，8，16です。
2
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filenum

WatchFile.Threaddump.filesize
スレッドダンプファイル数の監視結果出力ファイルのファイルサイズをバイト単位で指定します。
指定できる値は，4096，65536，262144，524288，1048576，2097152，4194304，16777216，67108864です。
1048576
ejbserver.logger.channels.define.ThreaddumpWatchLogFile.filesize

webserver.connector.ajp13.bind_host.value
WebコンテナのWebサーバとの接続設定でホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
etc：ループバックアドレス（localhost）に対して接続を受け付けます。
false
webserver.connector.ajp13.bind_host

webserver.connector.http.bind_host.value
Webコンテナの管理用サーバ（簡易Webサーバ）の設定でホストを固定するかどうかを指定します。
true：固定します。
false：固定しません。
false
webserver.connector.http.bind_host

注※

値を複数指定する際は，複数の<param-value>で指定します。

また，パラメタを有効にする場合は，文字列の先頭に’.’を付加して指定します。無効にしたい場合は，文字列の先頭に’#’を付加して指定します。

（例）

　　<param-name>ex.param.m</param-name>

　　<param-value>.ssss</param-value>

　　<param-value>#rrrr</param-value>

付録F　J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり

ここでは，J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり方法について説明します。Cosminexusを動作させるために必要なディスクおよびメモリの容量を算出するときの参考にしてください。

なお，ここで示すのは，EJBをSession Beanで記述した場合の計算式になります。

参考

SFOサーバのスレッド数とファイルディスクリプタ数は，J2EEサーバと同じです。J2EEサーバの計算式を使用して算出してください。

＜この節の構成＞

(1)　スレッド数

(2)　ファイルディスクリプタ数

(3)　CORBAネーミングサービス（インプロセス起動時）のスレッド数の見積もり

(1)　スレッド数

スレッド数の計算式を次に示します。

CORBAネーミングサービスをインプロセスで起動し，インプロセスHTTPサーバを使用する場合
最大スレッド数 = （65＋A＋B＋3×C＋D＋5×E＋2×F＋G＋H＋I） / 0.8

CORBAネーミングサービスをインプロセスで起動し，Hitachi Web Serverを使用する場合
最大スレッド数 = （63＋A＋B＋3×C＋D＋5×E＋2×F＋G＋J＋H） / 0.8

（凡例）

A：デプロイ済みのEntity Bean，Stateless Session Bean，Stateful Session Beanの数の合計

B：Message-Driven Beanを使用する場合，Message-Driven Beanの最大インスタンス数

C：EJBサーバ側の最大同時実行数（接続する最大EJBクライアント数）

D：CORBAネーミングサービスのスレッド数（ただし，CORBAネーミングサービスをインプロセスで起動（usrconf.propertiesのejbserver.naming.startupModeキーにinprocessを指定）した場合だけ加算する）

E：データベースコネクションの数

F：リソースアダプタ数

G：簡易Webサーバへの同時接続クライアント数（ただし，簡易Webサーバへの同時接続クライアント数が5以下の場合は5，100以上の場合は100を指定する）

H：デプロイ済みのWebアプリケーションの数

I：インプロセスHTTPサーバのスレッド数（インプロセスHTTPサーバ機能を利用する場合だけ加算する。このスレッド数は，usrconf.propertiesで制御できる）

J：Webサーバの同時接続クライアント数（ただし，Webサーバの同時接続クライアント数がWebコンテナの最大同時実行スレッド数（usrconf.propertiesのwebserver.connector.ajp13.max_threadsキーに指定した値）以下の場合は，Webコンテナの最大同時実行スレッド数を指定する）

(2)　ファイルディスクリプタ数

ファイルディスクリプタ数の計算式を次に示します。

最大ファイルディスクリプタ数 = （79＋A＋B＋C＋D＋2×E＋F＋G） / 0.8

（凡例）

A：データベースコネクションの数

B：EJBクライアントのプロセス数

C：Webサーバの同時接続クライアント数（ただし，Webサーバの同時接続クライアント数がWebコンテナの最大同時実行スレッド数（usrconf.propertiesのwebserver.connector.ajp13.max_threadsキーに指定した値）より大きい場合は，Webサーバの同時接続クライアント数＋1を指定する）

D：Webコンテナの最大同時実行スレッド数

E：簡易Webサーバへの同時接続クライアント数

F：インプロセスHTTPサーバ機能を有効にしている場合は4，無効にしている場合は0

G：インプロセスHTTPサーバへの同時接続クライアント数

(3)　CORBAネーミングサービス（インプロセス起動時）のスレッド数の見積もり

CORBAネーミングサービスをJ2EEサーバ起動時にインプロセスで起動させる場合に，J2EEサーバ上で生成されるCORBAネーミングサービスのスレッド数の見積もりについて説明します。

インプロセスで起動する場合のCORBAネーミングサービスのスレッド数は，次のように見積もります。

合計スレッド数 = 初期化時に生成されるスレッド数＋ワーカスレッド数

(a)　初期化時に生成されるスレッド数

初期化時に生成されるスレッド数は，usrconf.propertiesのvbroker.agent.enableLocatorキーの値がtrueの場合は6，falseの場合は4です。なお，vbroker.agent.enableLocatorキーは，CTM連携機能を有効（ejbserver.ctm.enabledキーにtrueを指定）にした場合，自動的にtrueが設定されます。

(b)　ワーカスレッド数

ワーカスレッド数は，「同時受け付けリクエスト数＋1」と「クライアントとCORBAネーミングサービス間のコネクション数」の合計になります。

ワーカスレッド数に関連するキーを次に示します。

vbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMax

vbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMin

vbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMaxIdle

これらのキーは，usrconf.propertiesのejbserver.naming.exec.argsキーの値として指定します。これらのキーの詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」，およびマニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。

vbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMaxキーで最大値を指定している場合のワーカスレッド数は，「ワーカスレッド数の最大値」と「クライアントとCORBAネーミングサービス間のコネクション数」になります。

ただし，vbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMinキーでワーカスレッド数の最小値を指定している場合，ワーカスレッド合計数が最小値に満たないときは，最小値がワーカスレッド数となります。

最大値を指定していない場合は，多重度の増加に伴いワーカスレッド数も増加していきます。ただし，ワーカスレッドは，アイドルになってからvbroker.se.iiop_tp.scm.iiop_tp.dispatcher.threadMaxIdleキー（デフォルト値は300秒）で指定した時間が経過したあとに消滅（30秒の誤差があります）しますので，負荷が下がるとスレッド数も減少します。

ワーカスレッド数の最大値を指定している場合に，スレッド数とワーカスレッドの最大値が同じになったときは，これ以降のリクエスト受け付けはエラー扱いにはしないで，次のように処理を継続します。

受信済みのリクエストについては処理を継続します。

新規のリクエストはソケットからread()されないで，TCPの受信バッファ，クライアント側の送信バッファで滞留します。TCPのバッファがいっぱいの場合は，クライアント側で送信待ちとなります。

処理中だったワーカスレッドが空きになった（応答を返した）時点で，次のリクエストの受信処理が行われます。

付録G　バッチサーバのスレッド数とファイルディスクリプタ数の見積もり

ここでは，バッチサーバのスレッド数とファイルディスクリプタ数の見積もり方法について説明します。Cosminexusを動作させるために必要なディスクおよびメモリの容量を算出するときの参考にしてください。

＜この節の構成＞

(1)　スレッド数

(2)　ファイルディスクリプタ数

(1)　スレッド数

スレッド数の計算式を次に示します。

最大スレッド数 = （63＋A＋5×B＋2×C＋D） / 0.8

（凡例）

A：CORBAネーミングサービスのスレッド数（ただし，CORBAネーミングサービスをインプロセスで起動（usrconf.propertiesのejbserver.naming.startupModeキーにinprocessを指定）した場合だけ加算する）
CORBAネーミングサービスのスレッド数の見積もりについては，「付録F(3)　CORBAネーミングサービス（インプロセス起動時）のスレッド数の見積もり」を参照してください。

B：データベースコネクションの数

C：リソースアダプタ数

D：簡易Webサーバへの同時接続クライアント数（ただし，簡易Webサーバへの同時接続クライアント数が5以下の場合は5，100以上の場合は100を指定する）

(2)　ファイルディスクリプタ数

ファイルディスクリプタ数の計算式を次に示します。

最大ファイルディスクリプタ数 = （79＋A＋2×B） / 0.8

（凡例）

A：データベースコネクションの数

B：簡易Webサーバへの同時接続クライアント数

付録H　Cosminexus DABroker Libraryのメモリ所要量

ここでは，Cosminexus DABroker Libraryのメモリ所要量の計算式について説明します。

なお，Cosminexus DABroker Libraryのメモリ所要量の計算式には，JDBCのメモリサイズを使用します。JDBCのメモリサイズの計算式に使用するデータのサイズについては，「付録H.1　JDBCのメモリサイズの計算式に使用するデータのサイズ」を参照してください。

Cosminexus DABroker Libraryのメモリ所要量の計算式を次に示します。

メモリ所要量＝128＋データベース同時接続数
×〔386＋A×｛20＋B＋定義列数×2＋C×2＋D×E＋F×（G＋H）｝〕＋I

（凡例）

A：並列に使用しているカーソル数

並列に使用しているカーソル数は，一つのConnectionオブジェクトから派生して，同時に使用するStatementインスタンス数，PreparedStatementインスタンス数，CallableStatementインスタンス数，ResultSetインスタンス数の総和です。

B：bufSizeの値

JDBCを使用してデータベースに接続するときに指定するbufSizeの値です。

C：SQLのサイズ

SQLのサイズは，KB（キロバイト）単位に切り上げて算出してください。

D：?パラメタのサイズ

?パラメタのサイズは，一つのSQL文に指定する，?パラメタのデータ長の総和です。?パラメタに指定する列属性ごとのデータ長を次の表に示します。

表H-1　パラメタ長一覧（ネイティブライブラリ内）

データベース種別
列属性
データ長（バイト）
備考

HiRDB
INTEGER
12
－

SMALLINT
8
－

LARGE DECIMAL(m, n)
↓（M/2）↓＋7

Mは指定した値の精度を表します。

4バイト単位で切り上げます。

FLOAT，DOUBLE PRECISION
16
－

SMALLFLT, REAL
12
－

CHAR(n)，MCHAR(n)，NCHAR(n)，VARCHAR(n)，MVARCHAR(n)，NVARCHAR(n)
指定した実データ長+8
4バイト単位で切り上げます。

DATE
16
－

TIME
16
－

TIMESTAMP(p)
p=0，p=2の場合：28
p=4，p=6の場合：32
－

BINARY(n)，BLOB(n)
指定した実データ長＋4
－

ORACLE，Oracle8i
FLOAT
56
－

DATE
64
－

その他のデータ型
指定した実データ長＋54
4バイト単位で切り上げます。

E：配列更新の配列数

配列更新の配列数は，HiRDBの「配列を使用したINSERT機能」，「配列を使用したUPDATE機能」，または「配列を使用したDELETE機能」を使用する場合はaddBatchメソッドの実行回数，そのほかの場合は1となります。

F：検索データのサイズ

検索データのサイズは，検索する列のデータ長の総和（1行分）です。

ただし，接続するデータベースがOracleであり，CLOB，NCLOB，BLOB，BFILE，LONG LAW，LONGのどれかの列を一つ以上含む検索の場合，検索データのサイズはほかの列に関係なく，bufSizeの値となります。

列属性ごとのデータ長を次の表に示します。

表H-2　検索する列のデータ長一覧（ネイティブライブラリ内）

データベース種別
列属性
データ長（バイト）
備考

HiRDB
INTEGER
4
－

SMALLINT
2
－

LARGE DECIMAL(m, n)
m＋2
－

FLOAT，DOUBLE PRECISION
8
－

SMALLFLT，REAL
4
－

CHAR(n)，MCHAR(n)
n＋1
－

NCHAR(n)
n×2＋1
－

VARCHAR(n)，MVARCHAR(n)
n＋2
－

NVARCHAR(n)
n×2＋2
－

DATE
11
－

TIME
9
－

TIMESTAMP(p)

p=0の場合：20

p=0以外の場合：21+p

－

BINARY(n)，BLOB(n)
HiRDBの位置付け子機能を使用する場合
12
－

HiRDBの位置付け子機能を使用しない場合
（nとbufSizeの値を比較してより小さい方の値）＋8
bufSizeの値とは，JDBCを使用してデータベースに接続するときに指定するbufSizeの値です。

ORACLE，Oracle8i
NUMBER
44
－

VARCHAR2(n)，CHAR(n)，VARCHAR2(n)，NCHAR(n)
n＋1
－

MLSLABEL(n)，RAW(n)
n
－

ROWID
9
－

FLOAT
8
－

DATE
20
－

G：FETCHサイズ

FETCHサイズは，Statement，またはResultSetクラスのsetFetchSizeメソッドの指定値です。ただし，指定値が0，または指定を省略した場合は，次のようになります。

指定値が0または指定を省略した場合のFETCHサイズ＝64KB/検索データのサイズ
計算の結果0になる場合は，1に繰り上げられます。

H：データベース用データ領域

データベース用データ領域は，接続データベースがHiRDBの場合は0，そのほかのデータベースの場合は1となります。

I：JDBCのメモリサイズ

JDBCのメモリサイズは，次の値です。

JDBCのメモリサイズ＝（Connectionオブジェクトサイズ
＋Statementオブジェクトサイズ
＋ResultSetオブジェクトサイズ
＋PreparedStatementオブジェクトサイズ
＋CallableStatementオブジェクトサイズ
＋?パラメタの実データサイズ
＋検索データのトータルサイズ
＋SQLサイズ
＋bufSizeの値によるデータサイズ
＋トレースサイズ）/1,024

なお，それぞれのサイズの計算式については，「付録H.1　JDBCのメモリサイズの計算式に使用するデータのサイズ」を参照してください。

＜この節の構成＞

付録H.1　JDBCのメモリサイズの計算式に使用するデータのサイズ

付録H.1　JDBCのメモリサイズの計算式に使用するデータのサイズ

JDBCのメモリサイズの計算式に使用するデータのサイズについて，(1)から(10)で説明します。

＜この項の構成＞

(1)　Connectionオブジェクトサイズ

(2)　Statementオブジェクトサイズ

(3)　ResultSetオブジェクトサイズ

(4)　PreparedStatementオブジェクトサイズ

(5)　CallableStatementオブジェクトサイズ

(6)　?パラメタの実データサイズ

(7)　検索データのトータルサイズ

(8)　SQLサイズ

(9)　bufSizeの値によるデータサイズ

(10)　トレースサイズ

(1)　Connectionオブジェクトサイズ

Connection オブジェクトサイズ（単位バイト）の計算式を次に示します。

Connectionオブジェクトサイズ＝1223500※¹＋（80364※¹＋bufSizeの値※²×1024）×Connectionインスタンス数※³

注

Connectionオブジェクトサイズとして，次のどちらかのタイミングで「bufSizeに指定した値 × 生成したコネクション数分のメモリ」をJavaヒープ領域に確保します。

コネクションプールのウォーミングアップ機能使用時

初回getConnection()発行時

bufSizeに必要以上に大きな値を設定すると，Connectionオブジェクトサイズ分のメモリを確保したときにJavaヒープを使い切り，OutOfMemoryErrorが発生するおそれがあります。

HiRDBのBLOB型データやBINARY型データへアクセスする場合は，bufSizeに大きな値を指定しないで，HiRDBの位置付け子機能を使用することを検討してください。HiRDBの位置付け子機能については，マニュアル「HiRDB 解説」を参照してください。

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

bufSizeのデフォルト値は64です。

注※3

Connectionインスタンス数とは，同時接続数のことです。

(2)　Statementオブジェクトサイズ

Statementオブジェクトサイズ（単位バイト）の計算式を次に示します。

Statementオブジェクトサイズ＝1000※¹＋1400※¹×Statementインスタンス数※²

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

Statementインスタンス数とは，システム全体で同時に使用するStatement数です。システム全体でStatementオブジェクトを使用しないときは0になります。

(3)　ResultSetオブジェクトサイズ

ResultSetオブジェクトサイズは，接続先のデータベースがOracle8i以降で，BLOB，CLOBの列属性がある表を検索した場合と，それ以外の処理を実行した場合で異なります。それぞれの場合の，ResultSetオブジェクトサイズ（単位バイト）の計算式を次に示します。

接続先のデータベースがOracle8i以降で，BLOB，CLOBの列属性がある表を検索した場合
ResultSetオブジェクトサイズ＝
2400※¹＋｛3400※¹＋MIN（ROW_SIZEの値※²×1024×1024, BLOBおよびCLOBの実データ長）×2｝×ResultSetインスタンス数※³

1.以外の処理を実行した場合
ResultSetオブジェクトサイズ＝2400※¹＋3400※¹×ResultSetインスタンス数※³

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

デフォルト値は16です。

注※3

ResultSetインスタンス数とは，システム全体で同時に使用するResultSet数です。システム全体で，検索SQLを実行しない，またはResultSetオブジェクトを生成しないときは0になります。

(4)　PreparedStatementオブジェクトサイズ

PreparedStatementオブジェクトサイズ（単位バイト）の計算式を次に示します。

PreparedStatementオブジェクトサイズ＝

79900※¹＋4700※¹×PreparedStatementインスタンス数※²

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

PreparedStatementインスタンス数とは，全体で同時に使用するPreparedStatement数です。システム全体でPreparedStatementオブジェクトを使用しないときは0になります。

(5)　CallableStatementオブジェクトサイズ

CallableStatementオブジェクトサイズ（単位バイト）の計算式を次に示します。

CallableStatementオブジェクトサイズ＝

65000※¹＋4700※¹×CallableStatementインスタンス数※²

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

CallableStatementインスタンス数とは，全体で同時に使用するCallableStatement数です。システム全体でCallableStatementオブジェクトを使用しないときは0になります。

(6)　?パラメタの実データサイズ

?パラメタの実データサイズ（単位バイト）の計算式を次に示します。

?パラメタの実データサイズ＝

9000※¹＋180※¹×?パラメタ数※²＋?パラメタのトータル長※²

注※1

オブジェクトを構成する大きさであり，実行するプラットフォームおよびJDKのバージョンにより若干値が異なる場合があります。

注※2

?パラメタ数と?パラメタのトータル長は，システム全体で同時に指定する，?パラメタ数と?パラメタのトータル長です。?パラメタのトータル長は，実データの長さの総和です。?パラメタに指定する列属性ごとの実データ長を次の表に示します。

表H-3　パラメタ長一覧（JDBC内）

データベース種別 | 列属性 | データ長（バイト）
HiRDB | INTEGER | 4
SMALLINT | 2
LARGE DECIMAL(m, n) | ↓（m/2）↓+1
FLOATまたはDOUBLE PRECISION | 8
SMALLFLTまたはREAL | 4
上記以外 | 指定した実データ長
ORACLE，Oracle8i | NUMBER | 指定した実データを数値文字列で表現したときの実際の長さ
FLOAT | 8
上記以外 | 指定した実データ長

(7)　検索データのトータルサイズ

検索データのトータルサイズ（単位バイト）は，実際のレコード長＋4×（取得する列数＋1）を1件のレコード長とし，検索した件数の総和になります。実際のレコード長は列属性ごとの実際のデータ長の総和です。

なお，検索データのトータルサイズは，ResultSetのタイプがスクロール可能のときだけ必要です。それ以外は0になります。

列属性ごとの実際のデータ長を次の表に示します。

表H-4　検索する列のデータ長一覧（JDBC内）

データベース種別 | 列属性 | データ長（バイト）
HiRDB | INTEGER | 4
SMALLINT | 2
LARGE DECIMAL(m, n) | ↓(m/2)↓+1
FLOATまたはDOUBLE PRECISION | 8
SMALLFLTまたはREAL | 4
上記以外 | データベースに格納している実データ長
ORACLE，Oracle8i | NUMBER | データベースに格納している実データを数値文字列で表現したときの実際の長さ
FLOAT | 8
上記以外 | データベースに格納している実データ長

(8)　SQLサイズ

実際のSQLのサイズがbufSizeの値×1024バイト以上のときだけ必要です。それ以外は0になります。なお，bufSizeのデフォルト値は64です。

(9)　bufSizeの値によるデータサイズ

bufSizeの値によるデータサイズ（単位バイト）の計算式を次に示します。なお，計算式は，受信バッファプール数指定機能の使用の有無によって異なります。

受信バッファプール数指定機能を使用しない場合
データサイズ＝bufSizeの値※×1024
×（同一コネクション内に存在する，検索SQL以外を実行するStatementインスタンス数
＋同一コネクション内に存在する，検索SQL以外を実行するPreparedStatementインスタンス数
＋同一コネクション内に存在する，CallableStatementインスタンス数
＋同一コネクション内に存在する，ResultSetインスタンス数）

受信バッファプール数指定機能を使用する場合
データサイズ＝bufSizeの値※×1024
×（同一コネクション内で同時に使用する，検索SQL以外を実行するStatementインスタンス数
＋同一コネクション内で同時に使用する，検索SQL以外を実行するPreparedStatementインスタンス数
＋同一コネクション内で同時に使用する，CallableStatementインスタンス数
＋同一コネクション内で同時に存在する，ResultSetインスタンス数）

注※　bufSizeのデフォルト値は64です。

(10)　トレースサイズ

トレースサイズの計算式（単位バイト）を次に示します。

トレースサイズ＝2048×メモリ情報取得量

メモリ情報取得量とは，環境変数DAB_ONMEMNUMの値です。デフォルト値は1000です。

付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）

WindowsでCosminexus DABroker Libraryを使用する場合の環境設定の流れを次に示します。

Cosminexus DABroker Libraryの動作環境の設定

データベース接続のための設定

J2EEアプリケーション運用のための設定

なお，これらの設定は，次の環境構築が済んでいることを前提にしています。

DBMSを使用できる環境が構築されていること

開発したJ2EEアプリケーションを組み込むホスト，およびCosminexus DABroker Libraryを組み込むホストをネットワーク上で使用できる環境が構築されていること

設定を変更する場合，Cosminexus DABroker Libraryを使用したプロセス（J2EEサーバなど）が起動しているときには，設定を変更できません。該当するプロセスを停止してから，設定を変更してください。

＜この節の構成＞

付録I.1　Cosminexus DABroker Libraryの動作環境の設定

付録I.2　データベース接続のための設定

付録I.3　J2EEアプリケーション運用のための設定

付録I.1　Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryの動作環境は，環境設定ユティリティで設定します。また，環境設定ユティリティでは，トレース取得の設定ができます。ここでは，Cosminexus DABroker Libraryで取得できるトレースと，Cosminexus DABroker Libraryの動作環境の設定について説明します。

＜この項の構成＞

(1)　Cosminexus DABroker Libraryで取得できるトレース

(2)　Cosminexus DABroker Libraryの動作環境の設定

(1)　Cosminexus DABroker Libraryで取得できるトレース

Cosminexus DABroker Libraryの動作環境設定で，必要に応じて，トレース取得の設定をしてください。取得できるトレースを次に示します。

拡張データベースアクセストレース

XAトレース

拡張データベースアクセストレース

通常の運用ではトレースは採取しませんが，障害などの不具合の調査が必要なときに，拡張データベースアクセストレースを取得します。

拡張データベースアクセストレースは，データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。

拡張データベースアクセストレースは，次のように利用できます。

データベースのアクセス中に発生したトラブルの迅速な切り分け

24時間稼働に対応するJ2EEアプリケーションの稼働状態でのトラブル調査

マルチスレッド環境でJ2EEアプリケーションが動作している場合のスレッドごとのデータベースアクセス履歴取得

コネクションプーリングなどの機能を使用している場合のデータベースへの接続ごとのデータベースアクセス履歴取得

トラブルが再現調査できない場合の常時トレース取得

XAトレース

XAトレースはXAインタフェースでエラーを検知した場合に，エラートレースを取得します。XAインタフェースでエラーが発生した場合にエラーの内容をトレースできるように，XAトレースの取得を設定してください。

(2)　Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryの動作環境は，環境設定ユティリティで設定します。なお，環境設定ユティリティにはオンラインヘルプがありますので，設定内容の詳細については，オンラインヘルプを参照してください。［スタート］メニューの［プログラム］から［Cosminexus※］－［DABrokerLibrary］－［ヘルプ］を選択すると，Cosminexus DABroker Libraryのオンラインヘルプが表示されます。

注※

プログラムフォルダ名を変更している場合，任意のプログラムフォルダから，選択してください。

Cosminexus DABroker Libraryの動作環境の設定手順を次に示します。

環境変数を設定します。
システム環境変数のPATHに「<Cosminexusのインストールディレクトリ>¥DAB¥lib」を設定してください。設定されていない場合，環境設定ユティリティは起動できません。

［スタート］メニューの［プログラム］から［Cosminexus］－［DABrokerLibrary］－［環境設定］を選択します。
［DABroker動作環境設定］ダイアログが表示されます。

［DABroker動作環境設定］ダイアログで必要事項を設定して，［適用］ボタンをクリックします。
［DABroker動作環境設定］ダイアログには次の三つのタブがあります。

［共通設定］タブ

［リモートアクセス設定］タブ

［for C++設定］タブ

各タブの設定内容については，(a)～(c)で説明します。

［DABroker動作環境設定］ダイアログでの必要事項の設定が終わったら，［OK］ボタンをクリックしてダイアログを閉じます。

システムを再起動します。

(a)　［共通設定］タブの設定内容

ここでは，［共通設定］タブの設定内容について説明します。Cosminexus DABroker Libraryを使用する場合の［共通設定］タブの設定内容を次に示します。

「作業ディレクトリ」に，作業ディレクトリ（例：「C:¥Program Files¥Hitachi¥Cosminexus¥DAB¥tmp」）が表示されていることを確認します。

「使用するORACLEのバージョン」に，Oracleのバージョン（例：ORACLE9i）を指定します。

拡張データベースアクセストレースを取得する場合は，［拡張データベースアクセストレースを取得する］チェックボックスをチェックします。

拡張データベースアクセストレースを取得する場合は，［データベースアクセストレース設定］ボタンをクリックします。
［アクセストレース設定］ダイアログが表示されます。

［アクセストレース設定］ダイアログで，取得しない情報の項目のチェックを外して，［OK］ボタンをクリックします。
［DABroker動作環境設定］ダイアログに戻ります。

XAトレースを取得する場合は，［XAトレースを取得する］チェックボックスをチェックします。

［適用］ボタンをクリックします。

(b)　［リモートアクセス設定］タブの設定内容

ここでは，［リモートアクセス設定］タブの設定内容について説明します。Cosminexus DABroker Libraryを使用する場合の［リモートアクセス設定］タブの設定内容を次に示します。

次の項目を設定します。

HiRDBのBLOB型データ受取バッファサイズ

ORACLEのLONG型データ受取バッファサイズ

漢字コードセット

［適用］ボタンをクリックします。

(c)　［for C++設定］タブの設定内容

ここでは，［for C++設定］タブの設定内容について説明します。Cosminexus DABroker Libraryがインストールされている環境で，DABroker for C++をインストールし，DABroker for C++を使用してデータベースにアクセスする場合の設定です。

［for C++設定］タブでは，DABroker for C++を使用して開発したJ2EEアプリケーションからのアクセスでエラーが発生した場合の，DABroker for C++のイベントトレースの取得について設定します。エラーが発生した場合にイベントトレースを取得しておくことで，トレースを参照してエラーに対処できるようになります。

Cosminexus DABroker Libraryを使用する場合の［for C++設定］タブの設定内容を次に示します。

イベントトレースの取得の有無，取得する場合のトレース取得サイズやトレース取得レベルを設定します。

取得するトレースの種別を設定します。

［適用］ボタンをクリックします。

DABroker for C++のイベントトレースの詳細については，マニュアル「DABroker for C++」を参照してください。

(d)　環境設定ユティリティとファイルとの対応

環境設定ユティリティで設定した内容は，Cosminexus DABroker Library動作環境定義ファイルに反映されます。環境設定ユティリティとCosminexus DABroker Library動作環境定義ファイルの対応を次の表に示します。

表I-1　環境設定ユティリティとCosminexus DABroker Library動作環境定義ファイルの対応

環境設定ユティリティ | Cosminexus DABroker Library動作環境定義ファイルの項目名
タブ名 | 項目名
［共通設定］タブ | 作業ディレクトリ | DABTMP
データベースアクセス処理終了待ちタイムアウト | DABDBA_TIMEOUT
表検索カラム数 | DABSELECTCOLCNT
更新・検索条件カラム数 | DABSELECTINFCNT
ログファイルサイズ［dabsv.log］ | DABSVLOGSIZE
使用するORACLEのバージョン | DABORACLE_TYPE
HiRDBのディクショナリ表のデータ属性 | DABSQL_HiRDB_DICTIONARY_DATATYPE
HiRDB環境変数区切り文字 | DAB_HIRDB_DBINF_ESC
拡張データベースアクセストレースを取得する | DABEXSQL_TRCLINE
トレースファイルサイズ | DABEXSQL_TRC_LINE
XAトレースを取得する | DABXA_LOG_ERROR
［リモートアクセス設定］タブ | HiRDBのBLOB型データ受取バッファサイズ | DABHIRDBA_BLOBBUFSIZE
ORACLEのLONG型データ受取バッファサイズ | DABORADBA_LONGBUFSIZE
漢字コードセット | DABLANGMODE
［for C++設定］タブ | DABroker for C++のトレース取得サイズ | DABCPP_EVTTRC_SIZE
DABroker for C++のトレース取得レベル | DABCPP_EVTTRC_LEVEL
DABroker for C++のトレース取得種別 | DABCPP_EVTTRC_nn

環境設定ユティリティの［アクセストレース設定］ダイアログの項目とCosminexus DABroker Library動作環境定義ファイルの対応を次の表に示します。

表I-2　［アクセストレース設定］ダイアログの項目とCosminexus DABroker Library動作環境定義ファイルの対応

項目名（アクセストレースの種類） | Cosminexus DABroker Library動作環境定義ファイルの項目名
CANCEL | DABSQL_TRC_CANCEL
CLOSE | DABSQL_TRC_CLOSE
COMMIT | DABSQL_TRC_COMMIT
CONNECT | DABSQL_TRC_CONNECT
DECLARE | DABSQL_TRC_DECLARE
DESCRIBE | DABSQL_TRC_DESCRIBE
DISCONNECT | DABSQL_TRC_DISCONNECT
EXECUTE | DABSQL_TRC_EXECUTE
FETCH | DABSQL_TRC_FETCH
LOGGING | DABSQL_TRC_LOGGING
LOGLESS | DABSQL_TRC_LOGLESS
PREPARE | DABSQL_TRC_PREPARE
ROLLBACK | DABSQL_TRC_ROLLBACK
OPEN | DABSQL_TRC_OPEN
AUTO_COMMIT_OFF | DABSQL_TRC_AUTO_COMMIT_OFF
AUTO_COMMIT_ON | DABSQL_TRC_AUTO_COMMIT_ON
ATTACH | DABSQL_TRC_ATTACH
ATTRGET | DABSQL_TRC_ATTRGET
ATTRSET | DABSQL_TRC_ATTRSET
BIND | DABSQL_TRC_BIND
CHARFORM | DABSQL_TRC_CHARFORM
CHARID | DABSQL_TRC_CHARID
DEFINE | DABSQL_TRC_DEFINE
DESALLOC | DABSQL_TRC_DESALLOC
DESCANY | DABSQL_TRC_DESCANY
DESFREE | DABSQL_TRC_DESFREE
DETACH | DABSQL_TRC_DETACH
ENVCREATE | DABSQL_TRC_ENVCREATE
ERRGET | DABSQL_TRC_ERRGET
GETPIECE | DABSQL_TRC_GETPIECE
HDLALLOC | DABSQL_TRC_HDLALLOC
HDLFREE | DABSQL_TRC_HDLFREE
LOBCLOSE | DABSQL_TRC_LOBCLOSE
LOBLEN | DABSQL_TRC_LOBLEN
LOBOPEN | DABSQL_TRC_LOBOPEN
LOBREAD | DABSQL_TRC_LOBREAD
LOBWRITE | DABSQL_TRC_LOBWRITE
PARAMGET | DABSQL_TRC_PARAMGET
SESBEGIN | DABSQL_TRC_SESBEGIN
SESEND | DABSQL_TRC_SESEND
SETPIECE | DABSQL_TRC_SETPIECE
GETDIAG | DABSQL_TRC_GETDIAG
GET_INFO | DABSQL_TRC_GET_INFO
SET_INFO | DABSQL_TRC_SET_INFO
EXECUTE_DIRECT | DABSQL_TRC_EXECUTE_DIRECT

Cosminexus DABroker Library動作環境定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

付録I.2　データベース接続のための設定

Cosminexus DABroker Libraryがインストールされている環境で，DABroker for C++をインストールし，DABroker for C++を使用してデータベースに接続する場合には，接続先データベースの定義が必要です。

DABroker for C++を使用してデータベースに接続する場合は，接続先データベース定義ユティリティで設定したデータベース種別名，およびデータベース名を使用してデータベースにアクセスします。接続先データベース定義ユティリティで設定した情報を使用すると，接続条件などが変更されてもアプリケーションを変更する必要がありません。ただし，OTS機能，またはJTS機能を使用する場合は，接続先データベース定義ユティリティで設定した情報を使用できません。

＜この項の構成＞

(1)　接続先データベース定義の設定

(2)　データベース名のグループに定義する情報

(1)　接続先データベース定義の設定

接続先データベース定義ユティリティは，プログラムフォルダに登録された「DABroker接続先データベース定義」から起動します。「DABroker接続先データベース定義」は，すべてのユーザが操作できます。

接続先データベース定義ユティリティで設定した内容は，接続先データベース定義ファイル（<Cosminexus DABroker Library運用ディレクトリ>¥conf¥dabenv）に出力されます。なお，Cosminexus DABroker Library運用ディレクトリは，Cosminexus DABroker Libraryのインストールディレクトリ（<Cosminexusのインストールディレクトリ>¥DAB）です。

接続先データベース定義の設定手順を次に示します。

プログラムフォルダに登録された［接続先データベース定義］を起動します。
［DABroker接続先データベース定義］ダイアログが表示されます。

使用するデータベースの製品名が記載されたタブを選択し，接続情報を設定します。
次の情報を定義します。

データベース種別名
使用するデータベースに対して付ける任意の名称です。

データベース名
データベースごとに異なる情報の集まりに対して付ける任意の名称です。

データベース名のグループに定義する情報
データベース名のグループに定義する情報は，データベースごとに異なります。詳細については，「付録I.2(2)　データベース名のグループに定義する情報」を参照してください。

［接続先データベース定義］ダイアログでの必要事項の設定が終わったら，［OK］ボタンをクリックしてダイアログを閉じます。

なお，［接続先データベース定義］ダイアログで設定する，データベース種別名，データベース名，およびデータベース名のグループに定義する情報は，次のような親子関係になります。

この例で示すように，データベース名は，同一データベース種別名に対して，複数定義できます。例えば，ホスト名が異なる二つのHiRDBを，一つのデータベース種別として定義し，アプリケーションでは，データベース名でホストの異なるHiRDBを使い分けられます。このような場合の［接続先データベース定義］ダイアログでの設定方法を次に示します。

データベース種別名，データベース名を新規登録する場合
設定後，［追加］ボタンを選択します。

同一データベース種別名に対して，別のデータベース名を登録する場合
設定後，［追加］ボタンを選択します。

登録されている情報を変更する場合
登録内容を変更したあと，［追加］ボタンを選択します。

データベース種別名またはデータベース名を削除する場合
削除するデータベース種別またはデータベース名を選択して［削除］ボタンを選択してください。

(2)　データベース名のグループに定義する情報

データベース名のグループに定義する情報について，データベースごとに説明します。

(a)　HiRDBまたはXDM/RDE2を使用する場合

HiRDBまたはXDM/RD E2を使用する場合に，データベース名のグループに定義する情報を次の表に示します。

表I-3　データベース名のグループに定義する情報（HiRDBまたはXDM/RD E2を使用する場合）

設定項目名
指定内容

データベース種別名
使用するデータベースに対して付ける任意の名称を指定します。設定規則を次に示します。

接続先データベース定義ユティリティ内でユニークな名称にしてください。

23文字まで指定できます。2バイト文字，半角かたかな文字は使用しないでください。

データベース名
データベースごとに異なる情報の集まりに対して付ける任意の名称を指定します。設定規則を次に示します。

同一データベース種別名内でユニークな名称にしてください。

23文字まで指定できます。2バイト文字，半角かたかな文字は使用しないでください。

接続先ホスト名（DBHOST）
HiRDBのホスト名を指定します。

接続先ポート番号（DBNAME）
ポート番号を指定します。

ユーザID（USERID）
接続ユーザIDを指定します。※

パスワード（PASSWD）
パスワードを指定します。※

環境変数
HiRDBクライアントへ渡す環境変数を指定します。設定規則を次に示します。

1,024文字まで指定できます。2バイト文字，および半角かたかな文字は使用しないでください。

各環境変数の先頭に，必ず区切り文字（@）を記述してください。

PDHOST（ホスト名称，またはIPアドレス），およびPDNAMEPORT（接続するポート番号）は，必ず先頭か末尾で指定してください。

PDHOST，およびPDNAMEPORTは，重複して指定しないでください。PDHOST，およびPDNAMEPORT以外の環境変数は，Cosminexus DABroker Libraryで設定した値をそのまま使えます。

Cosminexus DABroker Libraryでは，指定した環境変数の妥当性はチェックしません。

環境変数グループ
HiRDBクライアントへ渡す環境変数グループ名を指定します。設定規則を次に示します。

30文字まで指定できます。2バイト文字，および半角かたかな文字は使用しないでください。

Cosminexus DABroker Libraryでは，指定した環境変数グループが有効かどうかはチェックしません。

注※

J2EEアプリケーションでユーザIDとパスワードを指定していない場合は，ここで指定したユーザID，パスワードを使用してデータベースにアクセスします。Cosminexus DABroker Libraryでは，接続先データベース定義ファイルの出力時にパスワードを暗号化していないため，パスワードはJ2EEアプリケーション側で指定するようにしてください。

なお，接続先データベース定義ユティリティで複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

(b)　Oracleを使用する場合

Oracleを使用する場合に，データベース名のグループに定義する情報を次の表に示します。

表I-4　データベース名のグループに定義する情報（Oracleを使用する場合）

設定項目名
指定内容

データベース種別名
使用するデータベースに対して付ける任意の名称を指定します。設定規則を次に示します。

接続先データベース定義ユティリティ内でユニークな名称にしてください。

23文字まで指定できます。2バイト文字，半角かたかな文字は使用しないでください。

データベース名
データベースごとに異なる情報の集まりに対して付ける任意の名称を指定します。設定規則を次に示します。

同一データベース種別名内でユニークな名称にしてください。

23文字まで指定できます。2バイト文字，半角かたかな文字は使用しないでください。

リスナー名（DBNAME）
SQL*NET経由でアクセスするOracleのリスナー名称を指定します。ただし，リモートアクセスしない場合は省略します。

ユーザID（USERID）
接続ユーザIDを指定します。※

パスワード（PASSWD）
パスワードを指定します。※

注※

J2EEアプリケーションでユーザIDとパスワードを指定していない場合は，ここで指定したユーザID，パスワードを使用してデータベースにアクセスします。Cosminexus DABroker Libraryでは，接続先データベース定義ファイルの出力時にパスワードを暗号化していないため，パスワードはJ2EEアプリケーション側で指定するようにしてください。

なお，接続先データベース定義ユティリティで複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

付録I.3　J2EEアプリケーション運用のための設定

J2EEアプリケーションを運用する前に，次の設定をしてください。

J2EEアプリケーションの組み込み

J2EEアプリケーションのインタフェースの定義

サーバで動作するJ2EEアプリケーションの動作環境の設定

＜この項の構成＞

(1)　J2EEアプリケーションの組み込み

(2)　J2EEアプリケーションのインタフェースの定義

(3)　サーバで動作するJ2EEアプリケーションの動作環境の設定

(1)　J2EEアプリケーションの組み込み

Cosminexus DABroker Libraryが組み込まれたサーバにJava Applicationを格納します。また，次に示すクラスパスを指定します。

<Cosminexusのインストールディレクトリ>¥DABJ¥JdbcDbpsv.jar

<Cosminexusのインストールディレクトリ>¥DABJ¥JdbcDbpsvEx.jar※

注※

Cosminexus DABroker LibraryでJDBC2.0拡張機能を使用する場合に，このパスを指定してください。

ここでは，例として，「<Cosminexusのインストールディレクトリ>¥DABJ¥JdbcDbpsvEx.jar」をクラスパスとして指定します。

簡易構築定義ファイルでは，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにクラスパスの設定を追加します。なお，指定するパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
     :
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- J2EEアプリケーションの組み込みの設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
          <param-name>add.class.path</param-name>
          <param-value><Cosminexusのインストールディレクトリ>¥DABJ¥JdbcDbpsvEx.jar</param-value>
       </param>
     </configuration>
   </tier>
     :
 </web-system>
 <host>
   :
</model-definition>

注　太字の部分が編集部分です。

(2)　J2EEアプリケーションのインタフェースの定義

J2EEアプリケーションのインタフェースを定義します。

JNDI連携，接続プール，および分散トランザクション機能を使用する場合
JDBC2.0 Standard Extension API ImplementationをJavaSoftのホームページから入手しておきます。

分散トランザクション機能を使用する場合
JTA（JTA Implementation）をJavaSoftのホームページから入手しておきます。

JNDI連携を使用する場合
JNDI 1.1.2以降をJavaSoftのホームページから入手しておきます。

(3)　サーバで動作するJ2EEアプリケーションの動作環境の設定

Cosminexus DABroker Libraryでは，JNIを使ってDABrokerの提供するネイティブライブラリを使用します。Cosminexus DABroker Libraryをサーバで動作するJavaアプリケーションとして動作させるときは，次の設定が必要です。

ネイティブライブラリの動作環境の設定

データベースクライアントライブラリの動作環境の設定

(a)　ネイティブライブラリの動作環境の設定

ネイティブライブラリはJDBCドライバを実行する（呼び出す）プロセス上で読み込まれて動作するので，ネイティブライブラリ実行のための動作環境を設定する必要があります。

設定内容

システム環境変数のPATHに「<Cosminexus DABroker Library運用ディレクトリ>¥lib」を設定します。

(b)　データベースクライアントライブラリの動作環境の設定

ネイティブライブラリは，データベースにアクセスする場合に，各データベースが提供するクライアントライブラリを呼び出します。データベースクライアントライブラリの動作環境の設定を次に示します。

データベースライブラリのパスを設定します。
特別な設定は必要ありません。ただし，接続するデータベースによっては動作環境の設定が必要な場合があります。詳細については，接続するデータベースのマニュアルなどを参照してください。
PATHに，次の値を設定します。

HiRDB，またはXDM/RD E2の場合：HiRDBクライアントライブラリのパス名

Oracleの場合：Oracleライブラリ（libclntsh）のパス名

データベースの提供する環境変数を設定します。
JDBCドライバを実行する（呼び出す）プロセス上で有効な環境変数として，各データベースの提供する環境変数を設定する必要があります。
詳細については，「付録K　データベースの設定」，接続するデータベースのマニュアルなどを参照してください。

付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）

UNIXでCosminexus DABroker Libraryを使用する場合の環境設定の流れを次に示します。

Cosminexus DABroker Libraryのセットアップ

Cosminexus DABroker Libraryの動作環境の設定

データベース接続のための設定

J2EEアプリケーション運用のための設定

なお，これらの設定は，次の環境構築が済んでいることを前提にしています。

DBMSを使用できる環境が構築されていること

開発したJ2EEアプリケーションを組み込むホスト，およびCosminexus DABroker Libraryを組み込むホストをネットワーク上で使用できる環境が構築されていること

設定を変更する場合，Cosminexus DABroker Libraryを使用したプロセス（J2EEサーバなど）が起動しているときには，設定を変更できません。該当するプロセスを停止してから，設定を変更してください。

＜この節の構成＞

付録J.1　Cosminexus DABroker Libraryのセットアップ

付録J.2　Cosminexus DABroker Libraryの動作環境の設定

付録J.3　データベース接続のための設定

付録J.4　J2EEアプリケーション運用のための設定

付録J.1　Cosminexus DABroker Libraryのセットアップ

セットアップでは，Cosminexus DABroker Libraryを管理するユーザをOSに登録し，Cosminexus DABroker Libraryの運用ディレクトリを作成します。セットアップの手順を次に示します。

Cosminexus DABroker Libraryを管理するユーザ（UNIXログインユーザ）をOSに登録します。
ユーザID登録後，パスワードも登録してください。登録方法はOSのマニュアルを参照してください。ここで登録したユーザを，Cosminexus DABroker Libraryの管理ユーザと呼びます。Cosminexus DABroker Libraryの管理ユーザに与えられる権限は，次のとおりです。

Cosminexus DABroker Libraryで提供するファイルおよびディレクトリの所有者としてのアクセス権

Cosminexus DABroker Libraryの運用コマンドの実行権

注　Oracleにアクセスする場合は，登録するユーザのUIDを「3」以上にしてください。

Cosminexus DABroker Libraryのインストールディレクトリのグループおよびユーザを，手順1.で登録した管理グループおよびユーザに変更します。

Cosminexus DABroker Libraryセットアップコマンド（dabsetup）を実行します。
スーパーユーザで，/opt/DABroker/binディレクトリにあるdabsetupを実行します。
(例)　dabsetup /home
dabsetupコマンドは，Cosminexus DABroker Library運用ディレクトリを指定するコマンドです。このコマンドを実行すると，インストールディレクトリのディレクトリおよびファイルが，<パス名>に指定した運用ディレクトリに移動されます。<パス名>を省略した場合，運用ディレクトリはCosminexus DABroker Libraryのインストールディレクトリ（/opt/DABroker）となります。また，dabsetupコマンドに-dオプションを指定すると，運用ディレクトリの削除もできます。

注意

AIXの場合で，Cosminexus Component ContainerをCロケールで動作させるときは，環境変数「LC__FASTMSG」に「false」が指定されているか確認してください。Cosminexus DABroker Libraryを使用してDBにアクセスし，かつCosminexus Component ContainerをCロケールで動作させる場合には，環境変数「LC__FASTMSG」に「false」を指定する必要があります。

付録J.2　Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryの動作環境は，Cosminexus DABroker Library動作環境定義ファイルで設定します。また，Cosminexus DABroker Library動作環境定義ファイルでは，トレース取得の設定ができます。ここでは，Cosminexus DABroker Libraryで取得できるトレースと，Cosminexus DABroker Libraryの動作環境の設定について説明します。

＜この項の構成＞

(1)　Cosminexus DABroker Libraryで取得できるトレース

(2)　Cosminexus DABroker Libraryの動作環境の設定

(1)　Cosminexus DABroker Libraryで取得できるトレース

Cosminexus DABroker Libraryの動作環境設定で，必要に応じて，トレース取得の設定をしてください。取得できるトレースを次に示します。

拡張データベースアクセストレース

XAトレース

拡張データベースアクセストレース

通常の運用ではトレースは採取しませんが，障害などの不具合の調査が必要なときに，拡張データベースアクセストレースを取得します。

拡張データベースアクセストレースは，データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。

拡張データベースアクセストレースは，次のように利用できます。

データベースのアクセス中に発生したトラブルの迅速な切り分け

24時間稼働に対応するJ2EEアプリケーションの稼働状態でのトラブル調査

マルチスレッド環境でJ2EEアプリケーションが動作している場合のスレッドごとのデータベースアクセス履歴取得

コネクションプーリングなどの機能を使用している場合のデータベースへの接続ごとのデータベースアクセス履歴取得

トラブルが再現調査できない場合の常時トレース取得

XAトレース

XAトレースはXAインタフェースでエラーを検知した場合に，エラートレースを取得します。XAインタフェースでエラーが発生した場合にエラーの内容をトレースできるように，XAトレースの取得を設定してください。

(2)　Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryの動作環境は，Cosminexus DABroker Library動作環境定義ファイルで設定します。動作環境定義ファイルは，インストール時に提供されるサンプルを使用して作成します。

提供されるサンプルファイル
/opt/DABroker/sample/dasysconf

動作環境定義ファイルの格納先
<Cosminexus DABroker Library運用ディレクトリ>/conf

Cosminexus DABroker Libraryの動作環境の設定手順を次に示します。

サンプルファイルを動作環境定義ファイルの格納先へコピーします。

コピーしたサンプルファイルを編集します。
必要に応じて，標準値の変更や値の追加をしてください。

共通設定項目（作業ディレクトリ，Oracleのバージョン，拡張データベースアクセストレースの取得の有無など）

リモートアクセス設定項目（データの受け取りバッファサイズなど）

HiRDB設定項目

Oracle設定項目

なお，Cosminexus DABroker Library動作環境定義ファイルは，「DAB」ブロックと「OTHERS」ブロックで構成されます。

「DAB」ブロック

共通設定項目やリモートアクセス設定項目を指定するブロックです。Cosminexus DABroker Libraryはこのブロックの設定項目をチェックするため，不正な名称などを指定していた場合はエラーになります。

「OTHERS」ブロック

HiRDB設定項目やOracle設定項目を指定するブロックです。Cosminexus DABroker Libraryはこのブロックの設定項目をチェックしません。指定したすべての項目が有効となります。

Cosminexus DABroker Library動作環境定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ファイルを保存します。

なお，作成済みのCosminexus DABroker Library動作環境定義ファイルの内容を変更する場合は，J2EEサーバを停止してください。

付録J.3　データベース接続のための設定

ここでは，Cosminexus DABroker Libraryを使用してデータベースに接続するために必要な設定について説明します。

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

HiRDBの言語モードの設定

Cosminexus DABroker LibraryおよびJDBCでの言語モードの設定

＜この項の構成＞

(1)　Oracleアクセスライブラリの再作成

(2)　HiRDBの言語モードの設定

(3)　Cosminexus DABroker LibraryおよびJDBCでの言語モードの設定

(1)　Oracleアクセスライブラリの再作成

Cosminexus DABroker Libraryでは，OracleにアクセスするためのライブラリとしてOracleアクセスライブラリを提供しています。Oracleアクセスライブラリは，OracleのOCIプログラムです。OCIプログラムは，Oracleのインストール状況によって，その作成方法（make方法）が異なる場合があります。Oracleのインストールの状況によっては，Cosminexus DABroker Libraryが提供しているOracleアクセスライブラリではOracleにアクセスできないため，ユーザの環境に合わせたOracleアクセスライブラリの再作成が必要になります。再作成の方法については，マニュアル「Cosminexus　システム構築ガイド」のOracleアクセスライブラリの再作成に関する説明を参照してください。

(2)　HiRDBの言語モードの設定

データベースとしてHiRDBを使用する場合は，言語モードを設定してください。Cosminexus DABroker Libraryの言語モードとHiRDBの言語モードの対応を次の表に示します。なお，Cosminexus DABroker Libraryの言語モードとは，Cosminexus DABroker Library動作環境定義ファイルのDAB_LANG（LANG環境変数）のことです。

表J-1　Cosminexus DABroker Libraryの言語モードとHiRDBの言語モードの対応

Cosminexus DABroker Libraryの言語モード | HiRDBの言語モード
OS | 言語モード | DAB_LANGの指定値 | SJIS | EUC日本語 | ASCII | UTF-8
AIX | SJIS | Ja_JP | ○ | － | － | －
Ja_JP.IBM-932 | ○ | － | － | －
Ja_JP.IBM-943 | ○ | － | － | －
EUC | ja_JP | － | ○ | － | －
ja_JP.IBM-eucJP | － | ○ | － | －
ASCII | C※ | － | － | ○ | －
UTF-8 | UTF-8 | － | － | － | ○
HP-UX | SJIS | ja_JP.SJIS※ | ○ | － | － | －
EUC | ja_JP.EUC | － | ○ | － | －
ja_JP.UJIS | － | ○ | － | －
ja_JP.eucJP | － | ○ | － | －
ASCII | C | － | － | ○ | －
UTF-8 | UTF-8 | － | － | － | ○
Linux | EUC | ja_JP | － | ○ | － | －
ja_JP.ujis | － | ○ | － | －
japanese | － | ○ | － | －
japanese.euc | － | ○ | － | －
ja_JP.eucjp | － | ○ | － | －
Ja_JP | － | ○ | － | －
ASCII | C※ | － | － | ○ | －
UTF-8 | UTF-8 | － | － | － | ○
Solaris | SJIS | ja_JP.PCK※ | ○ | － | － | －
EUC | ja | － | ○ | － | －
japanese | － | ○ | － | －
ASCII | C | － | － | ○ | －
UTF-8 | UTF-8 | － | － | － | ○

（凡例）　○：使用できる。　－：使用できない。

注※　DAB_LANGの標準値を示します。

(3)　Cosminexus DABroker LibraryおよびJDBCでの言語モードの設定

ENCODELANG，またはsetEncodLangに指定する言語モードは，Cosminexus DABroker Libraryの言語モードと合わせる必要があります。ENCODELANG，またはsetEncodLangの指定方法について次に説明します。

OSの言語モードとCosminexus DABroker Libraryの言語モードが同じ場合

ENCODELANG，またはsetEncodLangの指定は必要ありません。

OSの言語モードとCosminexus DABroker Libraryの言語モードが異なる場合

ENCODELANG，またはsetEncodLangに，Cosminexus DABroker Libraryの言語モードと同等の値を指定する必要があります。

注意事項

Cosminexus DABroker Libraryの言語モードと，データベースの言語モードは必ず合わせてください。

データベースの言語モードをCosminexus DABroker Libraryがサポートしていない場合，Cosminexus DABroker Libraryの言語モードにはASCIIモードを設定し，ENCODELANGまたはsetEncodLangにデータベースの言語モードを指定してください。

付録J.4　J2EEアプリケーション運用のための設定

J2EEアプリケーションを運用する前に，次の設定をしてください。

J2EEアプリケーションの組み込み

J2EEアプリケーションのインタフェースの定義

サーバで動作するJ2EEアプリケーションの動作環境の設定

＜この項の構成＞

(1)　J2EEアプリケーションの組み込み

(2)　J2EEアプリケーションのインタフェースの定義

(3)　サーバで動作するJ2EEアプリケーションの動作環境の設定

(1)　J2EEアプリケーションの組み込み

Cosminexus DABroker Libraryが組み込まれたサーバにJava Applicationを格納します。また，環境変数「CLASSPATH」に次に示すパスを追加します。

/opt/Cosminexus/DABJ/JdbcDbpsv.jar

/opt/Cosminexus/DABJ/JdbcDbpsvEx.jar※

注※

Cosminexus DABroker LibraryでJDBC2.0拡張機能を使用する場合に，このパスを指定してください。

(2)　J2EEアプリケーションのインタフェースの定義

J2EEアプリケーションのインタフェースを定義します。

JNDI連携，接続プール，および分散トランザクション機能を使用する場合
JDBC2.0 Standard Extension API ImplementationをJavaSoftのホームページから入手しておきます。

分散トランザクション機能を使用する場合
JTA（JTA Implementation）をJavaSoftのホームページから入手しておきます。

JNDI連携を使用する場合
JNDI 1.1.2以降をJavaSoftのホームページから入手しておきます。

(3)　サーバで動作するJ2EEアプリケーションの動作環境の設定

Cosminexus DABroker Libraryでは，JNIを使ってDABrokerの提供するネイティブライブラリを使用します。Cosminexus DABroker Libraryをサーバで動作するJavaアプリケーションとして動作させるときは，次の設定が必要です。

ネイティブライブラリの動作環境の設定

データベースクライアントライブラリの動作環境の設定

(a)　ネイティブライブラリの動作環境の設定

ネイティブライブラリはJDBCドライバを実行する（呼び出す）プロセス上で読み込まれて動作するので，ネイティブライブラリ実行のための動作環境を設定する必要があります。

設定内容

ライブラリ検索パスを指定する環境変数に，「<Cosminexus DABroker Library運用ディレクトリ>/lib」を設定します。設定する環境変数はOSによって異なります。

LIBPATH（AIXの場合）

LD_LIBRARY_PATH（HP-UX，Linux，およびSolarisの場合）

(b)　データベースクライアントライブラリの動作環境の設定

ネイティブライブラリは，データベースにアクセスする場合に，各データベースが提供するクライアントライブラリを呼び出します。データベースクライアントライブラリの動作環境の設定を次に示します。

データベースライブラリのパスを設定します。
特別な設定は必要ありません。ただし，接続するデータベースによっては動作環境の設定が必要な場合があります。詳細については，接続するデータベースのマニュアルなどを参照してください。
ライブラリ検索パスを指定する環境変数に，次の値を指定します。設定する環境変数はOSによって異なります。

LIBPATH（AIXの場合）

LD_LIBRARY_PATH（HP-UX，Linux，およびSolarisの場合）

使用しているOSの環境変数に次のパスを設定してください。

HiRDB，またはXDM/RD E2の場合：HiRDBクライアントライブラリのパス名

Oracleの場合：Oracleライブラリ（libclntsh）のパス名

データベースの提供する環境変数を設定します。
JDBCドライバを実行する（呼び出す）プロセス上で有効な環境変数として，各データベースの提供する環境変数を設定する必要があります。
詳細については，「付録K　データベースの設定」，接続するデータベースのマニュアルなどを参照してください。

付録K　データベースの設定

この節では，データベースとして，HiRDB，Oracle，XDM/RD E2，またはSQL Serverを使用する場合に必要な設定について説明します。なお，HiRDB Type4 JDBC Driverを使用した場合のHiRDBの設定，およびOracle JDBC Thin Driverを使用した場合のOracleの設定については，「6.5.2　データベースを使用するための設定」を参照してください。

HiRDBの設定（Cosminexus DABroker Libraryによる接続）

Oracleの設定（Cosminexus DABroker Libraryによる接続）

XDM/RD E2の設定

SQL Serverの設定

＜この節の構成＞

付録K.1　HiRDBの設定（Cosminexus DABroker Libraryの場合）

付録K.2　Oracleの設定（Cosminexus DABroker Libraryの場合）

付録K.3　XDM/RD E2の設定

付録K.4　SQL Serverの設定

付録K.1　HiRDBの設定（Cosminexus DABroker Libraryの場合）

Cosminexus DABroker Libraryを使用してHiRDBに接続する場合の設定について説明します。なお，データベースとしてHiRDBを使用する場合は，HiRDBをインストールして初期設定を済ませておいてください。詳細については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。Cosminexus DABroker Libraryの設定については，「付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）」，または「付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）」を参照してください。

ここでは，Cosminexus DABroker Libraryを使用して，HiRDBでJ2EEリソースを扱う場合に必要な次の設定について説明します。

環境変数の設定

環境変数のグループ登録

タイムアウトの設定

なお，同一の環境変数を環境変数グループと環境変数の両方に設定した場合は，環境変数グループで設定した環境変数が優先されます。

＜この項の構成＞

(1)　環境変数の設定

(2)　環境変数のグループ登録

(3)　タイムアウトの設定

(1)　環境変数の設定

次の環境変数を設定する必要があります。環境変数の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

PATH（Windowsの場合）

HiRDBのクライアントライブラリとして，次の値を指定します。通常，HiRDBのインストーラによってシステム環境変数に設定されます。

<HiRDBのホームディレクトリ>¥client¥lib

LIBPATH（AIXの場合）

HiRDBのクライアントライブラリとして，次の値を指定します。

<HiRDBのホームディレクトリ>/client/lib

LD_LIBRARY_PATH（HP-UX，Linux，およびSolarisの場合）

HiRDBのクライアントライブラリとして，次の値を指定します。

<HiRDBのホームディレクトリ>/client/lib

PDXAMODE※¹

「1」を指定します。

PDTXACANUM※¹

（HiRDBにアクセスするJ2EEコンポーネントの同時実行数）×（J2EEコンポーネントでアクセスする可能性があるHiRDB数）を指定します。

PDHOST※²

データベースのホスト名またはIPアドレスを指定します。

PDUSER※²

データベースのユーザ名およびデータベースのパスワードを指定します。

PDNAMEPORT※²

データベースのポート番号を指定します。

PDSWAITTIME※²

リクエスト間隔タイムアウトを指定します。

PDCWAITTIME※²

レスポンスタイムアウトを指定します。

PDSWATCHTIME※²

「0」を指定します。コネクションプーリング機能を使用する場合は，「0」を指定してください。

注※1

グローバルトランザクションを使用する場合に設定します。この環境変数は，HiRDBのクライアント環境変数グループには登録できません。

注※2

これらの環境変数は，HiRDBのクライアント環境変数グループとして登録することもできます。登録方法については，「付録K.1(2)　環境変数のグループ登録」で説明します。

(2)　環境変数のグループ登録

環境変数のグループは，次の方法で登録します。

Windowsの場合
HiRDBのクライアント環境変数登録ツールで「システムグループ」を選択して，環境変数のグループを登録します。この場合，DB Connectorのプロパティ定義では，ここで登録したグループ名を指定してください。

UNIXの場合
HiRDBのクライアント環境変数グループの設定ファイルに登録します。この場合，DB Connectorのプロパティ定義では，ここで登録した環境変数グループの設定ファイルのパスを指定してください。

なお，環境変数のグループ登録の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(3)　タイムアウトの設定

HiRDBのタイムアウトは，次に示すHiRDBのクライアント環境変数に設定します。

PDSWAITTIME

PDCWAITTIME

PDCONNECTWAITTIME

PDNBLOCKWAITTIME

HiRDBのクライアント環境変数の設定については，「付録K.1(1)　環境変数の設定」を参照してください。

タイムアウトの設定については，マニュアル「Cosminexus　システム設計ガイド」，マニュアル「HiRDB システム定義」，およびマニュアル「HiRDB UAP開発ガイド」を参照してください。

付録K.2　Oracleの設定（Cosminexus DABroker Libraryの場合）

Cosminexus DABroker Libraryを使用してOracleに接続する場合の設定について説明します。なお，データベースとしてOracleを使用する場合は，Oracleをインストールして初期設定を済ませておいてください。詳細については，Oracleのマニュアルを参照してください。Cosminexus DABroker Libraryの設定については，「付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）」，または「付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）」を参照してください。

ここでは，Cosminexus DABroker Libraryを使用して，OracleでJ2EEリソースを扱う場合に必要な次の設定について説明します。

環境変数の設定

トランザクションリカバリを行うための権限の設定

タイムアウトの設定

＜この項の構成＞

(1)　環境変数の設定

(2)　トランザクションリカバリを行うための権限の設定

(3)　タイムアウトの設定

(4)　動的パフォーマンスビューの参照権の設定

(1)　環境変数の設定

次の環境変数を設定する必要があります。

PATH（Windowsの場合）

Oracleのクライアントライブラリとして，次の値を指定します。通常，Oracleのインストーラによってシステム環境変数に設定されます。

<Oracleのホームディレクトリ>¥bin

LIBPATH（AIXの場合）

Oracleのクライアントライブラリとして，次の値を指定します。

<Oracleのホームディレクトリ>/lib32

LD_LIBRARY_PATH（HP-UX，Linux，およびSolarisの場合）

Oracleのクライアントライブラリとして，次の値を指定します。

<Oracleのホームディレクトリ>/lib32

NLS_LANG（UNIXの場合）

Oracleのクライアントで使用する言語を設定します。

設定値の例

japanese_japan.ja16sjis
Japanese_Japan.UTF8

(2)　トランザクションリカバリを行うための権限の設定

Oracleへの接続でグローバルトランザクションを使用する場合には，Oracleの接続ユーザにトランザクションリカバリを行うための権限を付与する必要があります。

付与する権限

SYS.DBA_PENDING_TRANSACTIONSのSELECT権限

FORCE_ANY_TRANSACTION権限

権限の付与の方法

次のどちらかの方法で権限を付与します。

Oracle Enterprise Managerコンソールを使用する

sqlplusを使用する

次に，Oracle 9.2.0で権限を付与する場合の例を示します。なお，権限を付与する方法の詳細については，Oracleのマニュアルを参照してください。

Oracle Enterprise Managerコンソールを使用する場合の例
Oracle Enterprise Managerコンソールを使用して権限を付与する場合の手順を次に示します。

sysユーザでデータベースに接続します。

［セキュリティ］－［ユーザー］－［<権限を付与するユーザ名>］－［オブジェクト権限］を開きます。

［SYS］－［ビュー］－［DBA_PENDING_TRANSACTIONS］を選択して，SELECT権限を付与します。

sqlplusを使用する場合の例
sqlplusを使用して権限を付与する場合の手順を次に示します。

sysユーザでデータベースに接続します。

次のSQL文を発行します。
grant select on DBA_PENDING_TRANSACTIONS to <権限を付与するユーザ名>;
commit;

(3)　タイムアウトの設定

必要に応じて，Oracleのタイムアウトを設定してください。タイムアウトは，Oracleのサーバ定義のDISTRIBUTED_LOCK_TIMEOUTパラメタに設定します。

なお，このほか，XAOpenStringのSesTmパラメタの設定がタイムアウトに影響します。このパラメタは，チューニングできません。

詳細については，マニュアル「Cosminexus　システム設計ガイド」，およびOracleのマニュアルを参照してください。

(4)　動的パフォーマンスビューの参照権の設定

Oracleに接続するユーザは，動的パフォーマンスビューの参照権を持っている必要があります。次のどちらかの方法でOracleに接続するユーザに動的パフォーマンスビューの参照権を設定してください。

「GRANT SELECT_CATALOG_ROLE TO <ユーザ名>;」を実行する。

「GRANT SELECT ON V_$INSTANCE TO <ユーザ名>;」，「GRANT SELECT ON V_$PROCESS TO <ユーザ名>;」，および「GRANT SELECT ON V_$SESSION TO <ユーザ名>;」を実行する。

付録K.3　XDM/RD E2の設定

Cosminexus DABroker Library，およびHiRDB Type4 JDBC Driverを使用してXDM/RD E2に接続する場合の設定について説明します。なお，データベースとしてXDM/RD E2を使用する場合は，XDM/RD E2をインストールして初期設定を済ませておいてください。詳細については，マニュアル「HiRDB XDM/RD E2接続機能」を参照してください。

Cosminexus DABroker Libraryの設定については，「付録I　Cosminexus DABroker Libraryの設定（Windowsの場合）」，または「付録J　Cosminexus DABroker Libraryの設定（UNIXの場合）」を参照してください。

HiRDB Type4 JDBC Driverの設定については，「6.5.2(1)　HiRDBの設定（HiRDB Type4 JDBC Driverの場合）」を参照してください。

ここでは，XDM/RD E2でJ2EEリソースを扱う場合に必要な次の設定について説明します。

環境変数の設定

環境変数のグループ登録

タイムアウトの設定

＜この項の構成＞

(1)　環境変数の設定

(2)　環境変数のグループ登録

(3)　タイムアウトの設定

(1)　環境変数の設定

次の環境変数を設定する必要があります。詳細については，マニュアル「HiRDB XDM/RD E2接続機能」，およびマニュアル「HiRDB UAP開発ガイド」を参照してください。

PDHOST

データベースのホスト名またはIPアドレスを指定します。

PDUSER

データベースのユーザ名およびデータベースのパスワードを指定します。

PDNAMEPORT

DBコネクションサーバのサーバスケジュール番号を指定します。

PDSRVTYPE

サーバの種別として，「VOS3」（固定値）を指定します。

PDCLTRDNODE

接続するXDM/RD E2のデータベース識別子として，RDノード名称（例：XRAA）を指定します。

PDXAMODE

トランザクションの移行機能は使用しないので，「0」（固定値）を指定します。

PDCWAITTIME

レスポンスタイムアウトとして，トランザクションタイムアウトの値よりも大きな値を指定します。

(2)　環境変数のグループ登録

環境変数のグループは，次の方法で登録します。

Windowsの場合
HiRDBのクライアント環境変数登録ツールで「システムグループ」を選択して，環境変数のグループを登録します。この場合，DB Connectorのプロパティ定義では，ここで登録したグループ名を指定してください。

UNIXの場合
HiRDBのクライアント環境変数グループの設定ファイルに登録します。この場合，DB Connectorのプロパティ定義では，ここで登録した環境変数グループの設定ファイルのパスを指定してください。

なお，環境変数のグループ登録の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(3)　タイムアウトの設定

XDM/RD E2のタイムアウトは，HiRDBのクライアント環境変数，またはDBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文に設定します。

XDM/RD E2のタイムアウトを設定するチューニングパラメタを次の表に示します。

表K-1　XDM/RD E2のタイムアウトを設定するチューニングパラメタ

タイムアウトの種類 | 設定個所 | 設定方法（パラメタ名） | 設定内容
レスポンスタイムアウト | HiRDBクライアント環境変数 | PDCWAITTIME | 任意の値を指定します。※1
SQL実行CPU時間タイムアウト | DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文 | SQLCTIME | 任意の値を指定します。※2
SQL実行経過時間タイムアウト | DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文 | SQLETIME | 任意の値を指定します。※2
トランザクション経過時間タイムアウト | DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文 | SVETIME | 任意の値を指定します。※2
サーバ処理要求の間隔時間 | DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文 | SVINTERVAL | コネクションプーリング機能を使用する場合は，「0」を指定してください。※2

注※1

詳細については，マニュアル「HiRDB XDM/RD E2接続機能」を参照してください。

注※2

詳細については，マニュアル「VOS3　Database Connection Server」を参照してください。

タイムアウトの設定については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。

付録K.4　SQL Serverの設定

SQL ServerのJDBCドライバを使用してSQL Serverに接続する場合の設定について説明します。なお，データベースとしてSQL Serverを使用する場合は，SQL Serverをインストールして初期設定を済ませておいてください。詳細については，SQL Serverのマニュアルを参照してください。

ここでは，SQL ServerのJDBCドライバを使用して，SQL ServerでJ2EEリソースを扱う場合に必要なデータベース側での設定，J2EEサーバ側での設定について説明します。また，SQL Serverのタイムアウトの設定についても説明します。

＜この項の構成＞

(1)　データベース側での設定

(2)　J2EEサーバ側での設定（SQL Server 2000 Driver for JDBCの場合）

(3)　J2EEサーバ側での設定（SQL Servere 2005 JDBC Driverの場合）

(4)　タイムアウトの設定

(5)　コネクション障害検知を行うための設定

(1)　データベース側での設定

DB Connectorを使用してSQL Serverに接続する場合は，データベースのマシン上にSQL Serverをインストールして初期設定を済ませておいてください。また，SQL Serverに接続するためには，認証モードの設定が必要です。認証モードはインストール時に指定しますが，インストール後の変更もできます。

Cosminexusで設定できるSQL Serverの認証モードは，設定できる認証方法によって，混合モードとWindows認証モードの2種類に分かれています。認証モード，および認証方法についてそれぞれ説明します。

認証モード

混合モード
Windows認証とSQL Server認証の両方の認証方法を使用できる認証モードです。

Windows認証モード
Windows認証を使用できる認証モードです。

認証方法

Windows 認証
SQL Serverのインスタンスへの接続の試行を検証するメカニズムの一つです。ユーザが，接続時にWindowsのユーザまたはグループによって識別されます。

SQL Server認証
SQL Serverのインスタンスへの接続の試行を検証するメカニズムの一つです。接続するには，SQL Server ログインIDおよびパスワードを指定する必要があります。SQL Serverインスタンスでは，ログインIDとパスワードの組み合わせが有効であることを確認してから接続します。

設定できる認証モード，および認証方法は，SQL ServerのJDBCドライバごとに異なります。設定できる認証モード，および認証方法について，使用するSQL ServerのJDBCドライバごとに次の表に示します。

表K-2　設定できる認証モード，および認証方法

使用するSQL ServerのJDBCドライバ | 設定できる認証モード | 設定できる認証方法
SQL Server認証 | Windows認証
SQL Server 2000 Driver for JDBC | 混合モード | ○ | ×※
SQL Server 2005 JDBC Driver（バージョン1.0） | 混合モード | ○ | ×※
SQL Server 2005 JDBC Driver（バージョン1.1） | 混合モード | ○ | ○
Winsows認証モード | × | ○

（凡例）○：設定できる　×：設定できない

注※

SQL Server 2000 Driver for JDBC，およびSQL Server 2005 JDBC Driverのバージョン1.0を使用する場合には，混合モードを使用しますが，Windows認証は使用できません。

SQL Serverの認証モード，および認証方法の詳細については，SQL Serverのマニュアルを参照してください。

(2)　J2EEサーバ側での設定（SQL Server 2000 Driver for JDBCの場合）

Cosminexusがサポートするバージョンの，SQL Server 2000 Driver for JDBCのJARファイルを入手して，J2EEサーバのクラスパスに指定してください。JARファイルの入手方法とクラスパスの指定方法について説明します。

Microsoft社のホームページからCosminexusがサポートするバージョン番号のSQL Server 2000 Driver for JDBCをダウンロードします。

J2EEサーバを動作させるマシンに，ダウンロードしたSQL Server 2000 Driver for JDBCをインストールします。

J2EEサーバのユーザクラスパスにJARファイルを指定します。
指定するJARファイルは，<SQL Server 2000 Driver for JDBCのインストールディレクトリ>¥libディレクトリ下にある次の三つのファイルです。

mssqlserver.jar

msbase.jar

msutil.jar

簡易構築定義ファイルでは，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにJARファイルの設定を追加します。なお，指定するパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
     :
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- SQLサーバを使用するための設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
          <param-name>add.class.path</param-name>
          <param-value><SQL Server Driver for JDBCのインストールディレクトリ>¥lib¥mssqlserver.jar</param-value>
          <param-name>add.class.path</param-name>
          <param-value><SQL Server Driver for JDBCのインストールディレクトリ>¥lib¥msbase.jar</param-value>
          <param-name>add.class.path</param-name>
          <param-value><SQL Server Driver for JDBCのインストールディレクトリ>¥lib¥msutil.jar</param-value>
       </param>
     </configuration>
   </tier>
     :
 </web-system>
 <host>
   :
</model-definition>

注　太字の部分が編集部分です。

J2EEサーバに，SQL Server用のDB Connector（DBConnector_SQLServer_CP.rar）をインポートします。
DB Connectorの詳細については，マニュアル「Cosminexus　機能解説」を参照してください。
cjimportresコマンドを使用して，DBConnector_SQLServer_CP.rarをインポートしてください。

(3)　J2EEサーバ側での設定（SQL Servere 2005 JDBC Driverの場合）

Cosminexusがサポートするバージョンの，SQL Servere 2005 JDBC DriverのJARファイルを入手して，J2EEサーバのクラスパスに指定してください。JARファイルの入手方法とクラスパスの指定方法について説明します。

Microsoft社のホームページからCosminexusがサポートするバージョン番号のSQL Servere 2005 JDBC Driverをダウンロードします。

J2EEサーバを動作させるマシンに，ダウンロードしたSQL Servere 2005 JDBC Driverをインストールします。

J2EEサーバのユーザクラスパスにJARファイルを指定します。
指定するJARファイルは，<SQL Servere 2005 JDBC Driverのインストールディレクトリ>¥libディレクトリ下にあるsqljdbc.jarです。
簡易構築定義ファイルでは，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにJARファイルの設定を追加します。なお，指定するパラメタの詳細については，「14.2　システムの構成パターンと定義する論理サーバ」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem</name>
     :
   <!-- 物理ティア(combined-tier)の定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
     <!-- SQLサーバを使用するための設定 -->
     <configuration>
       <logical-server-type>j2ee-server</logical-server-type>
       <param>
          <param-name>add.class.path</param-name>
          <param-value><SQL Server Driver for JDBCのインストールディレクトリ>¥lib¥sqljdbc.jar</param-value>
     <!-- Windows認証を使用するための設定 -->
          <param-name>add.library.path</param-name>
          <param-value><SQL Server Driver for JDBCのインストールディレクトリ>¥lib¥sqljdbc_auth.dll</param-value>
       </param>
     </configuration>
   </tier>
     :
 </web-system>
 <host>
   :
</model-definition>

注　太字の部分が編集部分です。
Windows認証を使用する場合は，JARファイルの設定に加えて，次の設定も必要となります。なお，SQL Servere 2005 JDBC Driverのバージョンが1.0の場合，Windows認証は使用できません。Windows認証を使用する場合に必要となる設定について説明します。

J2EEサーバのコンテナ拡張ライブラリのJNI用ライブラリの検索パスにdllファイルを指定します。
指定するdllファイルは，<SQL Servere 2005 JDBC Driverのインストールディレクトリ>¥libディレクトリ下にあるsqljdbc_auth.dllです。

J2EEサーバに，SQL Server用のDB Connector（DBConnector_SQLServer_CP.rar）をインポートします。
DB Connectorの詳細については，マニュアル「Cosminexus　機能解説」を参照してください。
cjimportresコマンドを使用して，DBConnector_SQLServer_CP.rarをインポートしてください。

(4)　タイムアウトの設定

必要に応じて，SQL Serverのタイムアウトを設定してください。タイムアウトの設定については，マニュアル「Cosminexus　システム設計ガイド」，およびSQL Serverのマニュアルを参照してください。

(5)　コネクション障害検知を行うための設定

コネクションの障害検知やリソースアダプタの接続テストのために，SQL Serverの接続ユーザには，sysobjectsオブジェクトのSELECT権限が必要です。sysobjectsオブジェクトのSELECT権限は，デフォルトで付いているので外さないでください。

付録L　セットアップウィザードで設定されるパラメタ

セットアップウィザードでシステムをセットアップした場合，システムの各パラメタには，次の値が使用されます。

画面で値を設定したパラメタ
設定した値が使用されます。

画面で値を設定していないパラメタ
簡易構築定義ファイルに指定できるパラメタの省略値が使用されます。
簡易構築定義ファイルに指定できるパラメタ，およびパラメタの省略値については，「14.　簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグとパラメタ」を参照してください。

ただし，2.のパラメタについては省略値と異なる値が設定されるものがあります。

ここでは，2.のパラメタのうち，省略値と異なる値が設定されるパラメタについて，設定される論理サーバごとに説明します。

＜この節の構成＞

付録L.1　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

付録L.2　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

付録L.3　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

付録L.1　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理Webサーバに設定されるパラメタについて次の表に示します。パラメタの詳細については，表中の参照先を参照してください。

表L-1　パラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

パラメタ名
パラメタの省略値
セットアップウィザードで設定される値
説明
参照先

HWSKeepStartServers※1
Off
On
サーバプロセス稼働数が維持されます。
14.4.1

KeepAliveTimeout
15
3
KeepAlive接続時の要求待ち時間として3（単位：秒）を指定します。

Listen
－
80
リクエストを受け付けるポート番号として80を指定します。
「2.2.9　システム環境の設定」でWebサーバのポート番号を設定した場合，設定した値が有効になります。

MaxClients※1
150
20
同時に接続できるクライアントの最大数として20を指定します。

StartServers※1
5
20
Webサーバ起動時のサーバプロセス数として20を指定します。

ThreadsPerChild※2
50
20
サーバとして起動するスレッド数として20を指定します。なお，指定したスレッド数はサーバの最大同時接続数を示します。

JkMount
/* <J2EEサーバ名>
/* worker1
Hitachi Web Serverへのすべてのリクエストがworker1に転送されるようにします。
14.4.2

worker.<ワーカ名>※3.host
<ホスト名>※4
@myhost
ワーカのホスト名として@myhostを指定します。
14.4.3

worker.<ワーカ名>※3.port
<J2EEサーバのポート番号>※4
8007
ワーカのポート番号を8007にします。
「2.2.9　システム環境の設定」でajp13のポート番号を設定した場合，設定した値が有効になります。

worker.<ワーカ名>※3.receive_timeout
3600
120
通信タイムアウト値を120秒にします。

worker.list
<J2EEサーバ名>※4
worker1
ワーカ名としてworker1を指定します。

HttpsdCustomlogFormat
hws_std
"%h %l %u %t ¥"%r¥" %>s %b %T ¥"%{Referer}i¥" ¥"%{User-Agent}i¥" %P"
次の情報をHitachi Web Serverのカスタムログに出力します。

クライアントのホスト名

クライアントの識別情報

クライアントのユーザ名

リクエスト処理を開始した時刻

HTTP通信のリクエストの先頭行

最終ステータス

送信バイト数

リクエスト処理に掛かった時間

httpプロトコルヘッダのReferer値

httpプロトコルヘッダのUser-Agent値

HTTP通信のリクエストを処理するプロセスID

14.4.4

HttpsdErrorMethod
Div
Wrap
Hitachi Web Serverのエラーログをラップアラウンド方式で出力します。

（凡例）－：なし

注※1　使用するOSがUNIXの場合にだけ指定されます。

注※2　使用するOSがWidowsの場合にだけ指定されます。

注※3　<ワーカ名>はworker.listパラメタでworker1が指定されるため，worker1となります。

注※4　JKMountパラメタを省略すると指定されます。

付録L.2　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理J2EEサーバに設定されるパラメタについて次の表に示します。パラメタの詳細については，表中の参照先を参照してください。

表L-2　パラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

パラメタ名 | パラメタの省略値 | セットアップウィザードで設定される値 | 説明 | 参照先
ejbserver.connectionpool.applicationAuthentication.disabled | false | true | コンテナ管理のサインオンの最適化機能を有効にします。 | 14.5.1
ejbserver.ext.method_observation.interval | 0 | 10 | J2EEアプリケーション実行時間監視機能を使用します。また，タイムアウトとメソッドキャンセルを異なるスレッドで実行する時間間隔として10（単位：秒）を指定します。
ejbserver.jta.TransactionManager.defaultTimeOut | 180 | 60 | J2EEサーバ上で開始されるトランザクションのトランザクションタイムアウトの値として60（単位：秒）を指定します。
ejbserver.logger.channels.define.WebServletLogFile.filesize | 4194304 | 16777216 | Webサーブレットログのファイルサイズとして16777216（単位：バイト）を指定します。
webserver.connector.inprocess_http.enabled | false | true | インプロセスHTTPサーバ機能を有効にします。
add.jvm.arg | － | -Xms512m | Javaヒープメモリ領域の初期サイズとして512（単位：メガバイト）を指定します。 | 14.5.2
－ | -Xmx512m | Javaヒープメモリ領域の最大サイズとして512（単位：メガバイト）を指定します。
－ | -XX:PermSize=128m | Permanent領域の初期サイズとして128（単位：メガバイト）を指定します。
－ | -XX:MaxPermSize=128m | Permanent領域の最大サイズとして128（単位：メガバイト）を指定します。
－ | -XX:+HitachiVerboseGC | 拡張verbosegc情報を出力します。
－ | -XX:HitachiVerboseGCIntervalTime=0 | 拡張verbosegc情報を出力する時間の間隔として0（単位：秒）を指定します。
－ | -XX:+HitachiVerboseGCPrintCause | ガーベージコレクションの要因内容を，拡張verbosegc情報の行末に出力します。
－ | -XX:+HitachiOutputMilliTime | 日立JavaVMログファイルに出力する日時に，ミリ秒まで出力します。
－ | -XX:+HitachiCommaVerboseGC | 拡張verbosegc情報の出力を，CSVファイルで取得できるようにコンマ形式で出力します。
－ | -XX:HitachiJavaLogFileSize=4096k | JavaVMの作成するログファイルの最大サイズとして4096（単位：キロバイト）を指定します。
－ | -XX:HitachiJavaLogNumberOfFile=4 | JavaVMの作成するログファイルの最大数として4を指定します。
ex.properties | － | sun.nio.cs.map=UTF-8 | 文字エンコーディングをUTF-8に置換します。 | 14.5.3
use.security | true | false | SecurityManagerを使用しません。 | 14.5.12

（凡例）－：なし

付録L.3　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理パフォーマンストレーサに設定されるパラメタについて次の表に示します。パラメタの詳細については，表中の参照先を参照してください。

表L-3　パラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

パラメタ名
パラメタの省略値
セットアップウィザードで設定される値
説明
参照先

mstartup.retrywait
0
60
自動再起動リトライ間隔として60（単位：秒）を指定します。
14.3.1

PrfTraceLevel
STANDARD
00140000
パフォーマンストレーサのトレース取得レベルを次のように指定します。

JCA/DB Connector
詳細

他機能レイヤ
標準

14.6

付録M　用語解説

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コンテナサーバに当たります。

索引

[記号]
[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｈ][Ｉ][Ｊ][Ｋ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(記号)

.cmxrc

.cmxrcファイルの作成

(数字)

1.4モード

1:1系切り替えシステム

(英字)

(Ａ)

Application Server

(Ｂ)

Bean-Managed Persistence

Bean-Managed Transaction

BJEX

BMP

BMT

(Ｃ)

CLIコマンド

CMP

CMT

cmx_add_serverref

cmx_admin_passwd

cmx_build_model

cmx_build_system

cmx_change_model

cmx_define_application

cmx_define_resource

cmx_delete_serverref

cmx_delete_system

cmx_deploy_application

cmx_deploy_resource

cmx_export_model

cmx_list_model

cmx_list_status

cmx_register_application

cmx_register_resource

cmx_resume_lb

cmx_scaleout_host

cmx_start_application

cmx_start_resource

cmx_start_target

cmx_stop_application

cmx_stop_resource

cmx_stop_target

cmx_test_lb

cmx_trans_param

cmx_undefine_application

cmx_undefine_resource

cmx_undeploy_application

cmx_undeploy_resource

cmx_unregister_application

cmx_unregister_resource

cmxclient.properties

cmxserver.properties

cmxserver.properties（サーバ設定プロパティファイル）の編集

combined-tier

combined-tier構成

Component Container管理者

Connector属性ファイルのパラメタの値

Container-Managed Persistence

Container-Managed Transaction

Cookieスイッチング機能

Cookieスイッチング機能

CORBAネーミングサービス

CORBAネーミングサービス（インプロセス起動時）のスレッド数の見積もり

Cosminexus

Cosminexus Component Container

Cosminexus Component Transaction Monitor

Cosminexus DABroker Libraryの管理ユーザ

Cosminexus DABroker Libraryの設定（UNIXの場合）

Cosminexus DABroker Libraryの設定（Windowsの場合）

Cosminexus DABroker Libraryのセットアップ

Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryの動作環境の設定

Cosminexus DABroker Libraryのメモリ所要量

Cosminexus Operator Plug-in

Cosminexus Performance Tracer

Cosminexus Reliable Messaging

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

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

Cosminexusが提供するコマンド使用時の注意事項

Cosminexusが提供する定義ファイルの更新

Cosminexusから負荷分散機を制御するための設定

Cosminexusシステム

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

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

Cosminexus標準ログインモジュール

CTM

CTM

ctm-tier

CTMデーモン

CTMデーモン

CTMドメイン

CTMドメイン

CTMドメインマネジャ

CTMドメインマネジャ

CTMレギュレータ

CTMレギュレータ

(Ｄ)

［DABroker動作環境設定］ダイアログ

DB Connector

DB ConnectorのConnector属性ファイルの編集

DB ConnectorのConnector属性ファイルの編集

DD

Dependency Injection

DIターゲット

DTD

(Ｅ)

EARファイル

EIS

EJB

EJB-JARファイル

EJBクライアント

EJBクライアントアプリケーション

EJBコンテナ

EJBタイマ

Enterprise Bean

Enterprise JavaBeans

Entity Bean

(Ｆ)

free-tier

free-tier

(Ｈ)

HAモニタ

HiRDBの設定（Cosminexus DABroker Libraryの場合）

HiRDBの設定（HiRDB Type4 JDBC Driverの場合）

Hitachi Web Serverのログの出力方法を設定するパラメタ

Hitachi Web Server用リダイレクタ動作定義を設定するパラメタ

hold

http-tier

http-tierとj2ee-tierを組み合わせた構成

HWSKeepStartServers

(Ｉ)

Inbound

(Ｊ)

J2EE

j2ee-tier

J2EEアプリケーション

J2EEアプリケーション運用のための設定

J2EEアプリケーション運用のための設定

J2EEアプリケーション実行時間の監視機能

J2EEアプリケーションの一括入れ替え

J2EEアプリケーションの入れ替え

J2EEアプリケーションのインポートと開始

J2EEアプリケーションのインポートと開始

J2EEアプリケーションのインポートと開始

J2EEアプリケーションの強制停止

J2EEアプリケーションの実行時間監視機能

J2EEアプリケーションの通常停止

J2EEアプリケーションを実行するシステムで指定できるタグ

J2EEアプリケーションを実行するシステムで使用するファイルの一覧

J2EEコンテナ

J2EEコンポーネント

J2EEサーバ

J2EEサーバ

J2EEサーバのJavaVMのシステムプロパティに設定できるパラメタ

J2EEサーバの拡張パラメタ

J2EEサーバの起動ユーザの設定

［J2EEサーバの起動ユーザの設定］画面

［J2EEサーバの起動ユーザの設定］画面（設定内容変更）

［J2EEサーバの起動ユーザの設定］画面での画面遷移

J2EEサーバの自動再起動設定の無効化

J2EEサーバのスレッド数とファイルディスクリプタ数の見積もり

J2EEサーバモード

J2EEサーバ用オプション定義を設定するパラメタ

J2EEサーバ用ユーザプロパティを設定するパラメタ

J2EEサービス

J2EEリソース

J2EEリソースアダプタ

jaas.conf

JAASのコンフィグレーションファイル

Java

Java Database Connectivity

Java Naming and Directory Interface

JavaServer Pages

JavaロギングAPI

jbs_route.confファイル

JCAコンテナ

JDBC

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

JNDI

JNDI名前空間

JP1

JP1/AJS2

JP1/AJS2 - SO

JP1/AJS2 - SOと連携したシステム構築・運用の流れ

JP1/AJS2 - SOと連携するための設定

JP1/AJS2 - SOを使用したシナリオによるシステムの運用

JP1/BaseのJP1イベント転送の設定

JP1/BaseのJP1イベント転送の設定

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

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

JP1/Baseの構成定義ファイルの作成

JP1/Cm2/NC - Manager

JP1/Cm2/NC - Manager for Cosminexus

JP1/Cm2/NC - Manager for Cosminexusアダプター部の設定

JP1/Cm2/NC - Manager for Cosminexusの自動起動の設定

JP1/Cm2/NC - Manager for Cosminexusランタイム部のセットアップ

JP1/Cm2/NC - Managerの自動起動の設定

JP1/Cm2/NC - Managerの設定

JP1/Cm2/NC - Managerのログインユーザの設定

JP1/Cm2/NC管理サーバマシン

JP1/Cm2/NCと連携したときの製品構成およびプロセス構成

JP1/Cm2/NCのサービスの起動

JP1/Cm2/NCを使用して負荷分散機を制御するための設定

JP1/IM

JP1/IM - CM

JP1/IM - CMと連携したシステム構築の流れ

JP1/IM - CMと連携するための設定

JP1/IM - CMを使用したシステムの構築・運用

JP1/NETM/Audit

JP1/SC/DPM

JP1/SC/DPMと連携したスケールアウト

JP1/SC/DPMと連携したスケールアウト

JP1/SC/DPMを利用したシステムのスケールアウト

JP1/SC/DPMを利用したシステムのスケールアウト

JP1/SC/DPMを利用して構築したシステムのスケールイン

JP1イベント

JP1ジョブ運用管理サーバ

JP1ジョブ運用管理サーバの設定

JP1統合運用管理サーバ

JP1統合運用管理サーバの設定

JP1との連携

JP1と連携したシステム構築・運用の概要

JP1連携を設定するパラメタ

JP1連携を設定するパラメタ

JSP

JSP EL

JSPコンパイル結果

JSP事前コンパイル

JSPタグライブラリ

(Ｋ)

KeepAliveTimeout

(Ｌ)

lb.properties

(Ｍ)

Management Server

Management Serverの起動

Management Serverの自動起動の設定

Management Serverの設定

Management Serverの設定

Management Serverのセットアップ

Managementアクション

Managementアクション

Managementアクション

Managementアクション実行コマンドの作成

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

Managementイベント

Managementイベント

Managementイベント

Managementイベントの発行の設定

Managementイベント発行用プロパティを設定するパラメタ

Managementイベント発行用プロパティを設定するパラメタ

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

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

MaxClients

MaxPoolSize

Message-driven Bean

MIBオブジェクト

MIBファイル

Microsoft Cluster Service

MinPoolSize

mngsvrutil

mngsvrutil.connect.host

mngsvrutil.connect.password

mngsvrutil.connect.userid

(Ｎ)

N:1リカバリシステム

nca.confの編集

ncaswitch.confの編集

ncmadpt.confの編集

(Ｏ)

Object Transaction Service

Oracle RAC

Oracleの設定（Cosminexus DABroker Libraryの場合）

Oracleの設定（Oracle JDBC Thin Driverの場合）

ORBゲートウェイ

OTMゲートウェイ

OTS

Outbound

(Ｐ)

PATH環境変数の設定

PRFデーモン

PRFデーモン

PRFデーモン

PRFトレース

PRFトレース出力ライブラリ

PRFトレース取得レベル

PRFトレースファイル

(Ｒ)

ready

RMI-IIOP

(Ｓ)

SecurityManager

SecurityManagerの使用を設定するパラメタ

Server Plug-in

Session Bean

setupwizardコマンド（システムのセットアップとアンセットアップ）

sfo-tier

SFOサーバ

SFOサーバ

SFOサーバアプリケーション

SFOサーバのJavaVMのシステムプロパティに設定できるパラメタ

SFOさーばの拡張パラメタ

SFOサーバ用オプション定義を設定するパラメタ

SFOサーバ用ユーザプロパティを設定するパラメタ

Smart Composer機能

Smart Composer機能が実行するBIG-IP 1000のCLIコマンド

Smart Composer機能が実行するBIG-IP 1500のCLIコマンド

Smart Composer機能が実行するLoadflowbalのCLIコマンド

Smart Composer機能で使用するコマンドの一覧（J2EEアプリケーションを実行するシステムの場合）

Smart Composer機能で使用するコマンドの一覧（バッチアプリケーションを実行するシステムの場合）

Smart Composer機能の概要

Smart Composer機能のコマンドを使用したJ2EEアプリケーションのインポートと一括開始

Smart Composer機能のコマンドを使用したリソースアダプタのインポートと一括開始

Smart Composer機能の目的

Smart Composer機能の利点

snapshotログ

SNMP連携用形式ファイル

SQL Serverの設定

ssh接続を利用する負荷分散機への接続の設定

StartServers

Stateful Session Bean

Stateless Session Bean

stopped

(Ｔ)

Telnet接続を利用する負荷分散機への接続の設定

Telnetパラメタ定義ファイルのコピー

Telnetローカルユーザアカウントのパスワードの登録

ThreadsPerChild

Timer Service

(Ｕ)

ua.conf

uCosminexus Batch Job Execution Server

uCosminexus Client

uCosminexus Operator

unknown

usrconf.properties

(Ｗ)

WARファイル

webserver.connector.ajp13.backlog

webserver.connector.ajp13.max_threads

Webアプリケーション

Webコンテナ

Webコンテナサーバ

Webサーバ

Webサーバ

WebサーバとJ2EEサーバを同じサーバマシンに配置したシステムのスケールアウト

Webサーバ用定義を設定するパラメタ

Webサーバ連携

Webシステム

Webシステムの属性定義

Webシステムの属性定義

Windows Vista使用時の注意事項

working

(Ｘ)

XDM/RD E2の設定

(ア行)

(あ)

アーカイブ形式

アウトプロセス

アセンブル

アノテーション

アプリケーションサーバ

アプリケーションサーバに設定する環境変数と設定値（UNIXの場合）

アプリケーションサーバに設定する環境変数と設定値（Windowsの場合）

アプリケーションサーバに追加設定する環境変数と設定値（CTMを使用する場合（UNIXの場合））

アプリケーションサーバに追加設定する環境変数と設定値（CTMを使用する場合（Windowsの場合））

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

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

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

アプリケーションサーバの設定〔CTM用〕

アプリケーションサーバマシン

アプリケーションサーバマシン

アプレット

［アンセットアップ］画面（アンセットアップの実施決定）

［アンセットアップ完了］画面

［アンセットアップ完了］画面（［一括セットアップ］画面）

［アンセットアップ完了］画面（［ようこそ］画面）

［アンセットアップ失敗］画面（アンセットアップできないシステムの場合）

［アンセットアップ失敗］画面（エラーが発生した場合）

［アンセットアップ要求］画面（アンセットアップの実施確認）

［アンセットアップ要求］画面（［一括セットアップ］画面）

アンセットアップ要求画面（ようこそ画面）

(い)

一括起動〔サービスユニット単位〕

一括起動〔サービスユニット単位〕

一括起動〔すべてのサービスユニット〕

一括起動〔すべてのサービスユニット〕

［一括セットアップ］画面（通常開始）

［一括セットアップ完了］画面（強制開始）

［一括セットアップ失敗］画面（強制開始）

一括停止〔サービスユニット単位〕

一括停止〔サービスユニット単位〕

一括停止〔すべてのサービスユニット〕

一括停止〔すべてのサービスユニット〕

イベントリスナ

インストール

インストール

インストール

インプロセス

インプロセスHTTPサーバ

インプロセスHTTPサーバ機能を使用する構成

インプロセスHTTPサーバ機能を使用する場合に必要な設定

(う)

運用監視エージェント

運用監視エージェントプロパティを設定するパラメタ

運用監視エージェントプロパティを設定するパラメタ

運用管理エージェント

運用管理エージェントの自動起動の設定〔アプリケーションサーバ〕

運用管理エージェントの自動起動の設定〔セッションフェイルオーバサーバ〕

運用管理エージェントの自動起動の設定〔統合ネーミングスケジューラサーバ〕

運用管理エージェントの設定

運用管理エージェントの設定

運用管理機能の設定

［運用管理機能の設定］画面

［運用管理機能の設定］画面（設定内容の変更）

運用管理コマンド

運用管理サーバ

運用管理サーバに設定する環境変数と設定値（UNIXの場合）

運用管理サーバに設定する環境変数と設定値（Windowsの場合）

運用管理サーバに追加設定する環境変数と設定値（CTMを使用する場合（UNIXの場合））

運用管理サーバに追加設定する環境変数と設定値（CTMを使用する場合（Windowsの場合））

運用管理サーバの設定

運用管理サーバの設定

運用管理サーバの設定

運用管理サーバの設定〔CTM用〕

運用管理サーバマシン

運用管理サーバモデル

運用管理サーバモデル

運用管理サーバモデルでのシステムのスケールアウト

運用管理サーバモデルでのシステムのスケールイン

運用管理ドメイン

運用管理ポータル

運用管理ポリシー

運用管理ユーザの設定

［運用管理ユーザの設定］画面

［運用管理ユーザの設定］画面（設定内容変更）

運用設計

運用設計

(え)

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

(お)

同じWebシステムのサービスユニットを1台のサーバマシンに配置する場合

オプションの指定規則

オプションの入力形式

(カ行)

(か)

ガーベージコレクション制御機能

各論理サーバ共通で指定できるパラメタ

各論理サーバ共通で指定できるパラメタ（互換用）

カスタムジョブ

カスタムセットアップ

カスタムセットアップ

カスタムログインモジュール

仮想サーバ

仮想メモリの見積もり

仮想メモリの見積もり

稼働情報収集機能

簡易Webサーバ

簡易構築定義ファイル

簡易構築定義ファイルおよび構成変更定義ファイルに指定できるタグ

簡易構築定義ファイルに展開される実パラメタ

簡易構築定義ファイルの運用方法

簡易構築定義ファイルの運用方法

簡易構築定義ファイルのパラメタだけを編集する場合のチューニング

環境変数の設定〔アプリケーションサーバ（CTM用）〕

環境変数の設定〔アプリケーションサーバ〕

環境変数の設定〔運用管理サーバ（CTM用）〕

環境変数の設定〔運用管理サーバ〕

環境変数の設定〔セッションフェイルオーバサーバ〕

環境変数の設定〔統合ネーミングスケジューラサーバ〕

監査証跡

監査ログ

監視ツリー

管理対象オブジェクト（AdminObject）

(き)

機能レイヤ

共通引数

業務指向ツリー

業務処理プログラム

共有スレッド数

(く)

クライアントアプリケーション情報

クライアント共通設定プロパティファイル

クライアント設定プロパティファイル

クラスタ

クラスタソフトウェア

グローバルCORBAネーミングサービス

グローバルCORBAネーミングサービス

グローバルセッション

グローバルセッションID

グローバルセッション情報

グローバルトランザクション

(け)

系

計画系切り替え

系切り替え

系障害

ゲートウェイ指定機能

現用系

(こ)

構成変更定義ファイル

構成変更定義ファイルの作成

構成変更定義ファイルの作成

構成変更定義ファイルの作成

構成変更定義ファイルの作成

構成変更定義ファイルの作成

構成変更定義ファイルの作成

構築済みのシステムの移行

構築済みのシステムの移行

構築済みのシステムの移行

構築済みのシステムの移行

構築済みのシステムの移行時に出力する簡易構築定義ファイルの内容

構築済みのシステムの移行手順

構築済みのシステムを移行するときの注意事項

コネクションスイーパ

コネクションプーリング

コマンドの一覧

コマンドの概要

コマンドの格納先

コマンドの詳細

コマンドの使用について

コマンドの入力形式

コマンドの文法の記述形式

コマンド名称

コマンドを同時に複数実行した場合の動作

コミットオプション

コンテキスト

コンテキストルート

コンテナ拡張ライブラリ

(サ行)

(さ)

サーバ管理コマンド

サーバ管理コマンドを使用したJ2EEアプリケーションのインポートと開始

サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connector以外のリソースアダプタを使用する場合）

サーバ管理コマンドを使用したリソースアダプタのインポートと開始（DB Connectorを使用する場合）

サーバ起動・停止フック機能

サーバ指向ツリー

サーバ設定プロパティファイル

サービス閉塞

サービスユニット

サービスユニット

サービスユニット

サービスユニット・ホスト追加用の構成変更定義ファイル

サービスユニット単位の一括起動と一括停止

サービスユニット単位の一括起動と一括停止

サービスユニットの一括起動と一括停止

サービスユニットの一括起動と一括停止

サービスユニットの開始

サービスユニットの稼働状況のステータス

サービスユニットの追加

サービスユニットの追加

サービスユニットの追加

サービスユニットの追加

サービスユニットの追加

サービスユニットの定義

サービスユニットの定義

サービスユニットの閉塞によるシステムの部分メンテナンス

サービスユニットを自動再起動するための設定

サービスユニットを自動再起動するための設定

サーブレット

サーブレットエンジンモード

サーブレットフィルタ

(し)

システム環境の移行

システム環境の移行

システム環境の設定

［システム環境の設定］画面

［システム環境の設定］画面（設定内容変更）

システム構成とセットアップ方法の決定

システム構成の検討

システム構成の検討

システム構成の選択

［システム構成の選択］画面

［システム構成の選択］画面（設定内容変更）

システム構築の概要

システム構築の概要

システム全体の設定変更

システム全体の設定変更

システム全体の設定変更時の注意事項

システム提供の障害検知時コマンド

システム提供の障害検知時コマンド

システムのアンセットアップ

システムの一括起動

システムの一括起動

システムの一括起動（READY）

システムの一括構築

システムの一括構築

システムの運用

システムの開始

システムの構成

システムの構成定義

システムの構成定義

システムの構成変更

システムの構成変更

システムの削除

システムの削除

システムの削除

システムの削除

システムの情報モデルの変更

システムの情報モデルの変更

システムの情報モデルの変更

システムの情報モデルの変更

システムの情報モデルの変更

システムの情報モデルの変更（サービスユニットの追加）

システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

システムの情報モデルの変更（複製先アプリケーションサーバのホスト情報変更）

システムのスケールアウト

システムのスケールアウトおよびスケールイン

システムのスケールアウトおよびスケールイン

システムのスケールアウトとスケールイン

システムのスケールイン

システムのスケールイン

システムの設定の一括変更

システムの設定の一括変更

システムの設定の一括変更

システムの設定の一括変更

システムの設定変更

システムの設定変更

システムの設定変更

システムの設定変更

システムの設定変更

システムのセットアップ

システムのセットアップの流れ

システムの部分メンテナンス

システムのメンテナンス

システムをセットアップする前に

実行系

実行待ちキュー

実パラメタ

自動系切り替え

シナリオ

シナリオテンプレート定義ファイル

シナリオテンプレートを使用するための設定

［終了確認］画面

障害検知時コマンド

障害検知時コマンドの作成

障害設計

障害設計

障害発生時にサービスユニットを自動閉塞するための設定

障害発生時のサービスユニットの自動再起動

障害発生時のサービスユニットの自動再起動

障害発生時のサービスユニットの自動閉塞

使用するサーバと指定するパラメタの参照先の対応

使用リソースの見積もり

使用リソースの見積もり

ジョブ

ジョブネット

シングルサインオン

シングルサインオン情報リポジトリ

シングルサインオンライブラリ

(す)

スケールアウト

スケールアウト用ホスト定義ファイル

スケールアウト用ホスト定義ファイルの作成

スケールアウト用ホスト定義ファイルの作成

スケールイン

スケジュールキュー

スケジュールポリシー

すべてのサービスユニットの一括起動と一括停止

すべてのサービスユニットの一括起動と一括停止

スマートエージェント

スマートエージェント

(せ)

静的コンテンツ

性能解析トレース

性能解析トレースファイル

セキュリティアイデンティティ

セッション

セッションフェイルオーバ機能

セッションフェイルオーバサーバ

セッションフェイルオーバサーバ

セッションフェイルオーバサーバの設定

セッションフェイルオーバサーバマシン

セッションフェイルオーバサーバに設定する環境変数と設定値（UNIXの場合）

セッションフェイルオーバサーバに設定する環境変数と設定値（Windowsの場合）

セットアップウィザード

セットアップウィザード

セットアップウィザードで出力されるファイル

セットアップウィザードで使用するコマンドとファイル

セットアップウィザードで設定できる項目

セットアップウィザードでセットアップしたシステムの起動と停止

セットアップウィザードの起動

セットアップウィザードを使用したシステムのセットアップ

セットアップウィザードを使用するための準備

セットアップウィザードを使用する場合の注意事項

セットアップウィザードを使用する前に

［セットアップ完了］画面

［セットアップ失敗］画面

［セットアップ失敗］画面（障害時のログを採取しない場合）

［セットアップ失敗］画面（障害時のログを採取する場合）

［セットアップ情報］画面

［セットアップ情報］画面（セットアップ情報の再設定）

［セットアップ情報］画面（セットアップ情報の保存）

［セットアップ情報］画面（セットアップ情報ファイルの上書き）

［セットアップ情報］画面（セットアップ情報ファイルの保存）

［セットアップ情報］画面（ポート番号エラー）の例

セットアップ情報の確認

セットアップ情報ファイルを使用した一括セットアップ

セットアップの開始

セットアップの実行

［セットアップの実行］画面

セットアップ方法の選択

［セットアップ方法の選択］画面

［セットアップ方法の選択］画面（設定値確認）

占有スレッド数

(そ)

相互系切り替えシステム

相互スタンバイ

(タ行)

(た)

待機系

(ち)

抽象パラメタ

抽象パラメタ

抽象パラメタによって展開される実パラメタ

抽象パラメタの展開

抽象パラメタの展開例

チューニング

チューニング

チューニング

(つ)

通常モード

(て)

ディスク複製OSインストール機能

ディスク複製OSインストール機能

データソース

データベースサーバマシン

データベースサーバマシン

データベース接続環境の設定

［データベース接続環境の設定］画面

［データベース接続環境の設定］画面（使用するデータベースの決定）

［データベース接続環境の設定］画面（設定内容確認）

［データベース接続環境の設定］画面（データベースへの接続設定：HiRDB）

［データベース接続環境の設定］画面（データベースへの接続設定：Oracle）

データベース接続のための設定

データベース接続のための設定

データベースの設定

データベースを使用するための設定

テストモード

デプロイ

展開ディレクトリ形式

(と)

統合コンソール

統合スコープ

統合ネーミングスケジューラサーバ

統合ネーミングスケジューラサーバに設定する環境変数と設定値（UNIXの場合）

統合ネーミングスケジューラサーバに設定する環境変数と設定値（Windowsの場合）

統合ネーミングスケジューラサーバの設定

統合ネーミングスケジューラサーバモデル

統合ユーザ管理

統合ユーザ管理GUI

統合ユーザ管理のコンフィグレーションファイル

統合ユーザ管理フレームワーク

動作モード

動的コンテンツ

トラブルの種別と対処

トラブルへの対処

トラブルへの対処

トランザクションサービス

トランザクションマネジャ

トレース取得ポイント

(ナ行)

(に)

日常運用

日常運用

(ね)

ネーミング切り替え

ネーミングサービス

(ハ行)

(は)

バインド先アドレス設定機能

バッチアプリケーション

バッチアプリケーションを実行するシステムで指定できるタグ

バッチアプリケーションを実行するシステムで使用するファイルの一覧

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

バッチサーバ

バッチサーバのJavaVMのシステムプロパティに設定できるパラメタ

バッチサーバの拡張パラメタ

バッチサーバ用オプション定義を設定するパラメタ

バッチサーバ用ユーザプロパティを設定するパラメタ

パフォーマンストレーサ

パフォーマンストレーサ

パフォーマンストレーサ

ハンドラ

(ひ)

引数

ビジネスインタフェース

日立トレース共通ライブラリ

非保護区

標準セットアップ

標準セットアップ

(ふ)

ファイルの一覧

ファイルの概要

ファイルの文法の記述形式

負荷分散機

負荷分散機

負荷分散機定義プロパティファイル

負荷分散機の冗長化構成でトラブルが発生した場合の対処

負荷分散機の設定

負荷分散機の定義

負荷分散機への接続の設定

物理コネクション

物理ティア

物理ティア

物理ティア

物理ティアの定義

物理ティアの定義

フロントEJB

(へ)

ベーシックモード

別名

(ほ)

保護区

ホスティング環境の設定

ホスティング環境の設定

ホスト単位管理モデル

ホスト単位管理モデル

ホスト単位管理モデルでのシステムのスケールアウト

ホスト単位管理モデルでのシステムのスケールイン

ホストの定義

ホストの定義

(マ行)

(み)

未決着トランザクション

(め)

メソッドキャンセル機能

メソッドタイムアウト機能

メッセージインフロー

面数

メンテナンス

メンバリソースアダプタ

(ヤ行)

(ゆ)

ユーザサーバ

ユーザサーバ

ユーザ作成の障害検知時コマンド

ユーザ作成の障害検知時コマンド

ユーザ指定名前空間機能

ユーザ情報

ユーザ情報リポジトリ

ユーザスレッド

ユーザ認証ライブラリ

ユーザプロパティファイル

ユーザプロパティファイル

ユーザマッピング

ユーザログ

(よ)

［ようこそ］画面

予備系

(ラ行)

(ら)

ライトトランザクション

ライブラリJAR

ラウンドロビン検索

ラウンドロビンポリシー

(り)

リカバリ専用サーバ

リクエスト処理スレッド

リクエストのスケジューリング

リソースアダプタ

リソースアダプタのインポートと開始

リソースアダプタのインポートと開始

リソースアダプタまたはJ2EEアプリケーションの設定変更を伴う場合のチューニング

リソース枯渇監視機能

リソース枯渇監視機能

リソース枯渇監視機能の設定

リソース枯渇監視機能の設定

リソースマネジャ

リダイレクタ

リデプロイ機能

リデプロイによる入れ替え

リバースプロキシサーバ

リモートインタフェース

リロード機能

リロードによる入れ替え

(る)

ルートアプリケーション情報

ルートコンテキスト

ルートリソースアダプタ

(れ)

レルム

(ろ)

ローカルインタフェース

ローカルトランザクション

ロードバランサ

ロール

ロガー

ログインモジュール

論理CTMで指定できるパラメタ

論理CTMドメインマネジャで指定できるパラメタ

論理J2EEサーバで指定できるパラメタ

論理J2EEサーバで指定できるパラメタ（互換用）

論理SFOサーバで指定できるパラメタ

論理SFOサーバで指定できるパラメタ（互換用）

論理Webサーバで指定できるパラメタ

論理Webサーバで指定できるパラメタ（互換用）

論理コネクション

論理サーバ

論理サーバ参照定義ファイル

論理サーバのパラメタ変更用の構成変更定義ファイル

論理スマートエージェントで指定できるパラメタ

論理ネーミングサービス

論理ネーミングサービスで指定できるパラメタ

論理パフォーマンストレーサで指定できるパラメタ

論理ユーザサーバ

論理ユーザサーバで指定できるパラメタ

(ワ行)

(わ)

ワーカ定義を設定するパラメタ

ワーカプロセス

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
BIG-IP，3-DNS，iControl Services Manager，FirePassおよびF5はF5 Networks Incの商標，または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
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.の商品名称です。
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. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Symantecは，米国におけるSymantec Corporation の登録商標です。
Symantec AntiVirus Scan Engineは，Symantec Corporation の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国およびその他の国における米国Microsoft Corp.の商標です。
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.が著作権を有している部分が含まれています。