Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
(1) システムの構築で使用するファイル
J2EEアプリケーションを実行するシステムを構築する場合に使用する主なファイルを次に示します。各ファイルの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。
- 注意
- ファイルを変更する場合は,J2EEサーバを停止してください。J2EEサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。
- usrconf.properties(J2EEサーバ用ユーザプロパティファイル)
J2EEサーバのユーザプロパティを指定するファイルです。J2EEサーバが使用するネーミングサービス,トランザクション,コネクション,コンテナ,ログ,セキュリティなどを指定します。
ファイルの格納場所を次に示します。
- Windowsの場合
<Cosminexusのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\usrconf.properties
- UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties
- usrconf.cfg(J2EEサーバ用オプション定義ファイル)
J2EEサーバのJavaVMの起動オプションを指定するファイルです。
ファイルの格納場所を次に示します。
- Windowsの場合
<Cosminexusのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\usrconf.cfg
- UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg
- server.policy(J2EEサーバ用セキュリティポリシーファイル)
J2EEサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。
ファイルの格納場所を次に示します。
- Windowsの場合
<Cosminexusのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\server.policy
- UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy
- hitachi_web.properties(J2EEサーバ用Webアプリケーションプロパティファイル)
Webアプリケーション個別のプロパティを指定するファイルです。なお,J2EEサーバ全体でのプロパティの設定は,usrconf.propertiesで指定します。
ファイルの格納場所を次に示します。
- Windowsの場合
<WebアプリケーションのWEB-INFディレクトリ>\hitachi_web.properties
- UNIXの場合
<WebアプリケーションのWEB-INFディレクトリ>/hitachi_web.properties
hitachi_web.propertiesを変更した場合,WARファイルを作成,インポートし直してください。
(2) J2EEアプリケーションを実行するシステムを構築する流れ
ファイル編集とコマンド実行で,J2EEアプリケーションを実行するシステムを構築する場合の,システム構築の流れについて説明します。
- J2EEサーバをセットアップします。
デフォルトの設定のままで利用する場合は,セットアップ不要です。
インストール時にセットアップ済みのJ2EEサーバとは別のサーバ名称を使用したい場合に,セットアップしてください。詳細については,「付録C.2 J2EEサーバのセットアップ」を参照してください。
- J2EEサーバの動作設定をします。
デフォルトの設定のままで利用する場合は,設定不要です。
使用する機能の動作を変更したり,特定の機能を使用したりする場合には,アプリケーションサーバが提供するユーザ定義ファイルやコマンドを使用して,J2EEサーバの動作を設定,変更します。
J2EEサーバの動作を設定,変更できる機能の例を次に示します。
- ネーミングサービス
- トランザクション
- JavaVMの起動オプション
- コンテナ拡張ライブラリ
- CTMによるリクエストのスケジューリング
アプリケーションサーバが提供する主な機能の設定内容については,マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」のJ2EEサーバの動作設定に関する説明を参照してください。
- トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は,設定不要です。ただし,次の資料は,事前に取得のための設定をしておかないと,取得できません。これらの資料はトラブルシューティングで必要となるため,取得することをお勧めします。
- OSの統計情報,ユーザダンプ(Windowsの場合)またはcoreダンプ(UNIXの場合)
- JavaVMのガーベージコレクションのログ
これらの資料を取得する場合や,ほかの資料の取得設定を変更したい場合に,トラブルシューティングの資料取得の設定をしてください。トラブルシューティングに必要な資料の詳細と,システム構築時の設定の要否については「付録C.1(3) トラブルシューティングに必要な資料」を参照してください。
- Webサーバとの連携の設定をします。
Webサーバと連携しない場合は,設定不要です。
リダイレクタを利用したリクエストの振り分け,通信タイムアウト,エラーページのカスタマイズなど,Webサーバと連携するための設定をします。設定方法の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」のWebサーバとの連携の設定(アプリケーションの実行環境の場合)に関する説明を参照してください。
- 統合ユーザ管理機能の設定をします。
統合ユーザ管理機能を使用しない場合は,設定不要です。
Cosminexusシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや,統合ユーザ管理のコンフィグレーションファイルを設定します。設定方法の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」の統合ユーザ管理機能の設定に関する説明を参照してください。
- システムの可用性を高める設定をします。
システムの可用性を高める機能を使用しない場合は,設定不要です。
セッションフェイルオーバ機能によるJ2EEサーバへのセッション情報の引き継ぎの設定をします。設定方法の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」のJ2EEサーバ間のセッション情報の引き継ぎの設定に関する説明を参照してください。
- リソースとJ2EEアプリケーションの設定をします。
サーバ管理コマンドを使用して,リソースアダプタやJ2EEアプリケーションのプロパティを定義し,J2EEサーバにインポートします。設定方法の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」のリソースとJ2EEアプリケーションの設定に関する説明を参照してください。
- システムを起動して,システムの動作を確認します。
システムの起動および停止については,「付録D J2EEアプリケーションを実行するシステムの起動と停止(Windowsの場合)」,または「付録E J2EEアプリケーションを実行するシステムの起動と停止(UNIXの場合)」を参照してください。
- 注意
- 各ファイルでデフォルトの設定を変更する場合,簡易構築定義ファイルを使用して設定しているときは,マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」のJ2EEサーバの動作設定についての説明を参照してください。
(3) トラブルシューティングに必要な資料
トラブルシューティングに必要な資料と,システム構築時の設定の要否について次の表に示します。なお,設定方法の詳細については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守/移行/互換編」のトラブルシューティングの資料取得の設定に関する説明を参照してください。
表C-1 トラブルシューティングの資料の種類と設定要否(J2EEアプリケーションを実行するシステムの場合)
資料の種類 |
設定の要否 |
snapshotログ |
△※1 |
性能解析トレースファイル |
×※2 |
J2EEサーバのログ |
△ |
SFOサーバのログ |
△ |
Webサーバのログ |
△ |
リダイレクタのログ |
△ |
J2EEアプリケーションのユーザログ |
○ |
インプロセスHTTPサーバのログ |
△ |
稼働情報ファイル |
△ |
リソースアダプタのログ |
△ |
Cosminexus TPBrokerのトレースファイル |
△ |
Cosminexus DABroker Libraryのログ |
△ |
OSの統計情報 |
○ |
ユーザダンプ |
○ |
coreダンプ |
○ |
JavaVMの資料 |
○ |
サーバ管理コマンドのログ |
△ |
- (凡例)
- ○:資料を取得する場合には,設定が必要。
- △:デフォルトの資料取得の設定を変更する場合だけ,設定が必要。
- ×:設定は不要。
- 注※1
- snapshotlogコマンドを使用してsnapshotログを取得します。この場合,あらかじめ設定しておいたリストファイルを,コマンド実行時に引数として指定します。snapshotlogコマンド,およびデフォルトの設定で収集できるsnapshotログについては,「11.2 ログの運用で使用するコマンドの詳細」の「snapshotlog(snapshotログの収集)」を参照してください。なお,snapshotログの収集先を変更する場合には,snapshotログ収集対象定義ファイルを編集します。snapshotログ収集対象定義ファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。
- 注※2
- 日常的なシステム運用の作業で,cprfstartコマンドを実行してパフォーマンストレーサを起動するときに,PRFトレースの取得レベルやファイルの面数を指定できます。性能解析トレースファイルの取得については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守/移行/互換編」を参照してください。
表C-1に示したログは,snapshotログで一括収集できます。ただし,Cosminexus TPBrokerのトレースファイルについては,収集できるものと収集できないものが混在しています。このほかにも,snapshotログのデフォルトの設定で取得できないログについては,取得のための設定をしたり,snapshotログの収集先に追加したりする必要があります。
なお,次のログはログ出力先を変更できません。
- セットアップ時に作成されるinstall.log,移行コマンドなどのログファイル
- 次のディレクトリに出力されるJavaのスレッドダンプファイル
Windowsの場合
<作業ディレクトリ>\ejb\<サーバ名称>
UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>
ログの種類やデフォルト値,チャネル名,取得できるログの詳細や取得方法については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守/移行/互換編」を参照してください。
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.