3.4.3 環境設定ファイル(ajs3web.conf)の設定項目の詳細
環境設定ファイル(ajs3web.conf)の記述形式や設定項目の詳細について説明します。
(1) ファイルの格納場所
ajs3web.confの格納場所を次に示します。
JP1/AJS3 - Web Consoleのインストール先フォルダ\conf※
なお,同じフォルダ内にモデルファイルajs3web.conf.modelが格納されています。
- 注※
-
クラスタ運用時は,格納場所が次のようになります。
共有フォルダ\jp1ajs3web\conf
(2) ファイルの編集手順
ajs3web.confの編集方法は,ログのサイズや面数を変更する場合と,それ以外の項目を変更する場合で,手順が異なります。
(a) ログのサイズや面数を変更する手順
ログのサイズや面数を変更する場合,ajs3web.confを編集する前に,アプリケーションサーバログや関連ファイルをすべて削除する必要があります。
ログのサイズや面数を変更する手順を次に示します。
-
JP1/AJS3 HTTP Serverサービス,およびJP1/AJS3 Web Application Serverサービスを停止する。
-
すべてのログファイルを任意のフォルダにバックアップする。
-
次のファイルを削除する。
-
すべてのアプリケーションサーバログ
-
アプリケーションサーバログの格納フォルダ下の,mmapフォルダ配下のappserver.mmファイル
-
-
ajs3web.confを任意のフォルダにバックアップする。
-
モデルファイルajs3web.conf.modelをコピーして,ajs3web.confにリネームする。
-
ajs3web.confをテキストエディターで開く。
-
定義内容を変更する。
-
ファイルを保存する。
-
JP1/AJS3 HTTP Serverサービス,およびJP1/AJS3 Web Application Serverサービスを起動する。
(b) ログのサイズや面数以外の項目を変更する手順
ログのサイズや面数以外の項目を変更する手順を次に示します。
-
JP1/AJS3 HTTP Serverサービス,およびJP1/AJS3 Web Application Serverサービスを停止する。
-
ajs3web.confを任意のフォルダにバックアップする。
-
モデルファイルajs3web.conf.modelをコピーして,ajs3web.confにリネームする。
-
ajs3web.confをテキストエディターで開く。
-
定義内容を変更する。
-
ファイルを保存する。
-
JP1/AJS3 HTTP Serverサービス,およびJP1/AJS3 Web Application Serverサービスを起動する。
(3) 設定が有効になるタイミング
JP1/AJS3 Web Application Serverサービス起動時
(4) 記述形式
ajs3web.confの記述形式を次に示します。
[] HNTR_LOG_LEVEL=統合トレースログに出力するメッセージレベル HNTR_LOG_LANG=統合トレースログに出力するメッセージの言語種別 SYS_LOG_LEVEL=Windowsイベントログに出力するメッセージレベル SYS_LOG_LANG=Windowsイベントログに出力するメッセージの言語種別 COM_LOG_SIZE=コマンドログのファイルサイズ COM_LOG_LEVEL=コマンドログに出力するメッセージレベル COM_LOG_NUM=コマンドログのファイルの面数 COM_LOG_LANG=コマンドログに出力するメッセージの言語種別 SERVER_LOG_SIZE=アプリケーションサーバログのサイズ SERVER_LOG_LEVEL=アプリケーションサーバログに出力するメッセージレベル SERVER_LOG_NUM=アプリケーションサーバログのファイルの面数 SERVER_LOG_LANG=アプリケーションサーバログに出力するメッセージの言語種別 PFM_URL=PFM - Web ConsoleへのアクセスURL [接続先JP1/AJS3 - Managerのホスト名またはIPアドレス] TIMEZONE=接続先JP1/AJS3 - Managerのタイムゾーン SUMMARY_MAX_COUNT=Web GUIの監視対象の最大数 HOSTNAME_ALIAS_FOR_PFM=PFM - Web Consoleに渡すJP1/AJS3 - Managerのホストエイリアス名 [接続先JP1/AJS3 - Managerのホスト名またはIPアドレス] :
コメントを記載する際は,行の先頭に「;」(セミコロン)を記載してください。
(5) 設定項目
設定項目について説明します。各項目は改行文字で区切ってください。
(a) HNTR_LOG_LEVEL
統合トレースログに出力するメッセージレベルを指定します。
- 指定できる値
-
- none
-
どのメッセージも出力しません。
- error
-
エラーメッセージを出力します。
- warn
-
エラー,および警告メッセージを出力します。
- info
-
エラー,警告,および情報メッセージを出力します。
- デフォルト値
-
info
- 推奨値
-
デフォルト値
(b) HNTR_LOG_LANG
統合トレースログに出力するメッセージの言語種別を指定します。
- 指定できる値
-
- system
-
OSに設定されている言語種別で出力します。
OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は,英語ASCIIコードが仮定されます。
- C
-
英語ASCIIコードで出力します。
- SJIS
-
シフトJISコードで出力します。
- デフォルト値
-
system
- 推奨値
-
運用環境に応じて設定してください。
(c) SYS_LOG_LEVEL
Windowsイベントログに出力するメッセージレベルを指定します。
- 指定できる値
-
- none
-
どのメッセージも出力しません。
- error
-
エラーメッセージを出力します。
- warn
-
エラー,および警告メッセージを出力します。
- info
-
エラー,警告,および情報メッセージを出力します。
- デフォルト値
-
info
- 推奨値
-
デフォルト値
(d) SYS_LOG_LANG
Windowsイベントログに出力するメッセージの言語種別を指定します。
- 指定できる値
-
- system
-
OSに設定されている言語種別で出力します。
OSに設定されている文字コードが英語ASCIIコードでもシフトJISコードでもない場合は,英語ASCIIコードが仮定されます。
- C
-
英語ASCIIコードで出力します。
- SJIS
-
シフトJISコードで出力します。
- デフォルト値
-
system
- 推奨値
-
運用環境に応じて設定してください。
(e) COM_LOG_SIZE
コマンドログのファイルサイズを指定します。
- 指定できる値
-
4〜16,384(単位:キロバイト)
- デフォルト値
-
128
- 推奨値
-
デフォルト値
(f) COM_LOG_LEVEL
コマンドログに出力するメッセージレベルを指定します。
- 指定できる値
-
- none
-
どのメッセージも出力しません。
- error
-
エラーメッセージを出力します。
- warn
-
エラー,および警告メッセージを出力します。
- info
-
エラー,警告,および情報メッセージを出力します。
- デフォルト値
-
info
- 推奨値
-
デフォルト値
(g) COM_LOG_NUM
コマンドログのファイルの面数を指定します。
- 指定できる値
-
1〜16(単位:面)
- デフォルト値
-
2
- 推奨値
-
デフォルト値
(h) COM_LOG_LANG
コマンドログに出力するメッセージの言語種別を指定します。
- 指定できる値
-
- system
-
OSに設定されている言語種別で出力します。
OSに設定されている文字コードが,英語ASCIIコード,シフトJISコードのどちらでもない場合は,英語ASCIIコードが仮定されます。
- C
-
英語ASCIIコードで出力します。
- SJIS
-
シフトJISコードで出力します。
- デフォルト値
-
system
- 推奨値
-
運用環境に応じて設定してください。
(i) SERVER_LOG_SIZE
アプリケーションサーバログのファイルサイズを指定します。
- 指定できる値
-
4〜16,384(単位:キロバイト)
- デフォルト値
-
8,192
- 推奨値
-
デフォルト値
(j) SERVER_LOG_LEVEL
アプリケーションサーバログに出力するメッセージレベルを指定します。
- 指定できる値
-
- none
-
どのメッセージも出力しません。
- error
-
エラーメッセージを出力します。
- warn
-
エラー,および警告メッセージを出力します。
- info
-
エラー,警告,および情報メッセージを出力します。
- デフォルト値
-
info
- 推奨値
-
デフォルト値
(k) SERVER_LOG_NUM
アプリケーションサーバログのファイルの面数を指定します。
- 指定できる値
-
1〜16(単位:面)
- デフォルト値
-
2
- 推奨値
-
デフォルト値
(l) SERVER_LOG_LANG
アプリケーションサーバログに出力するメッセージの言語種別を指定します。
- 指定できる値
-
- system
-
OSに設定されている言語種別で出力します。
OSに設定されている言語種別が日本語でも英語でもない場合は,英語が仮定されます。
- ja
-
日本語で出力します。
- en
-
英語で出力します。
- デフォルト値
-
system
- 推奨値
-
運用環境に応じて設定してください。
(m) PFM_URL
PFM - Web Consoleへのログイン画面へのURLを指定します。
- 指定できる値
-
通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号/PFMWebConsole/login.do
「通信プロトコル://PFM - Web Consoleのホスト名またはIPアドレス:ポート番号」の部分は,環境に合わせて次のように設定してください。
- 通信プロトコル
-
通信プロトコルをhttpまたはhttpsで指定します。
- PFM - Web Consoleのホスト名またはIPアドレス
-
PFM - Web Consoleのホスト名またはIPアドレスを指定します。
- ポート番号
-
PFM - Web Consoleとの通信で使用するポート番号を記載します。デフォルトは「20358」です。
- デフォルト値
-
なし
- 推奨値
-
運用環境に応じて設定してください。
(n) 接続先JP1/AJS3 - Managerのホスト名またはIPアドレス
接続先のJP1/AJS3 - Managerのホスト名またはIPアドレスを指定します。
- 指定できる値
-
255バイト以内の文字列
- デフォルト値
-
なし
- 推奨値
-
運用環境に応じて設定してください。
(o) TIMEZONE
接続先JP1/AJS3 - Managerの物理ホストまたは論理ホストのタイムゾーンを指定します。
接続先JP1/AJS3 - ManagerのタイムゾーンがWeb Consoleサーバのタイムゾーンと異なる場合に指定する必要があります。
- 指定できる値
-
ajswebtz.batコマンドで取得できるタイムゾーンID
この設定項目を省略した場合は,OSのタイムゾーン設定に従います。
ajswebtz.batコマンドの詳細については,マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス 3. 通常の運用で使用するコマンド ajswebtz.bat(Windows限定)」を参照してください。
- デフォルト値
-
OSのタイムゾーン設定に従います。
- 推奨値
-
運用環境に応じて設定してください。
(p) SUMMARY_MAX_COUNT
Web GUIのダッシュボード画面に登録できる監視対象ユニットの最大数を指定します。
- 指定できる値
-
1〜20(単位:個)
- デフォルト値
-
5
- 推奨値
-
デフォルト値
(q) HOSTNAME_ALIAS_FOR_PFM
JP1/PFMが,監視しているJP1/AJS3 - Managerホストの監視ホスト名として,実ホスト名と異なる名称を指定している場合に,PFM - Web Consoleに渡す接続先JP1/AJS3 - Managerの監視ホスト名を指定します。
- 指定できる値
-
255バイト以内の文字列
- デフォルト値
-
なし
- 推奨値
-
運用環境に合わせて設定してください。
(6) 設定例
ajs3web.confの設定例を次に示します。
[] HNTR_LOG_LEVEL=info HNTR_LOG_LANG=system SYS_LOG_LEVEL=info SYS_LOG_LANG=system COM_LOG_SIZE=128 COM_LOG_LEVEL=info COM_LOG_NUM=2 COM_LOG_LANG=system SERVER_LOG_SIZE=8192 SERVER_LOG_LEVEL=info SERVER_LOG_NUM=2 SERVER_LOG_LANG=system [ManagerHostA] TIMEZONE=Asia/Tokyo SUMMARY_MAX_COUNT=5 [ManagerHostB] TIMEZONE=America/New_York SUMMARY_MAX_COUNT=5
(7) 注意事項
-
ここで説明した設定項目以外の項目は,変更しないでください。
-
定義行の「=」の前後には,スペースを入れないでください。
-
定義行の途中で改行を入れないでください。
-
設定できる項目以外を指定した場合,その行は無視されます。
-
設定項目が存在しない場合,デフォルト値を仮定して動作します。
-
設定が不正な場合,JP1/AJS3 Web Application Serverサービスが起動しません。
-
設定項目のキーのアルファベットの大文字と小文字は区別されませんが,設定値の大文字と小文字は区別されます。
-
同一の設定項目が複数行に定義されている場合,最初に記載されている行が有効になります。