Interstage Application Server リファレンスマニュアル（コマンド編）

29.3 ihsrlog

名前

　ihsrlog　−　ログのローテーション

形式

(1) ファイルサイズ単位でのローテーション

　ihsrlog -s logfile size count [-c]

(2) 日数単位でのローテーション

　ihsrlog -d logfile time count [-c]

機能説明

　本コマンドは、アクセスログまたはエラーログとして出力するログファイルを、ファイルサイズまたは日数単位にローテーションを行うコマンドです。
　環境定義ファイル(httpd.conf)内のErrorLogディレクティブ、CustomLogディレクティブ、およびTransferLogディレクティブのパラメタ指定時に使用します。
　以下に、本コマンドのオプションとパラメタを示します。

-s

　ファイルサイズ単位でローテーションを行います。

-d

　日数単位でローテーションを行います。

logfile

　ログファイルを格納するディレクトリ、およびファイル名プレフィクスを指定します。

　ディレクトリは、Interstage HTTP Serverのインストールディレクトリからの相対パスで指定します。

　ディレクトリは、絶対パスで指定します。

　出力されるログファイルの形式は、以下のようになります。

• 最新ファイル：ファイル名プレフィクス
• ローテーションされたファイル：ファイル名プレフィクス.N
  • N：通番
    　Nは0から始まる連続の番号であり、新しいファイルの順に、1番目のファイルの通番は“.0”、N番目のファイルの通番は“.(N-1)”となります。

size

　1ファイル当たりの最大ログファイルサイズを、Mバイト単位で指定します（-sオプション指定時のみ有効）。1から2047までを指定することができます。ローテーションは、ログ出力によりログファイルを更新する際に、ファイルサイズが指定したサイズを超過している場合に行います。

　ulimitコマンド（ボーンシェル系）またはlimitコマンド（Cシェル系）で設定されたファイルサイズが本設定値よりも小さい場合は、ulimitコマンドまたはlimitコマンドで設定されたファイルサイズが最大ログファイルサイズとなります。なお、コマンドの詳細については、各OSのドキュメントを参照してください。

time

　ローテーション間隔を日数で指定します（-dオプション指定時のみ有効）。1から365までを指定することができます。ローテーションは、以下のタイミングで行います。

「Interstage HTTP Serverの起動日の0:00から指定した日数×24時間」経過後の次のログ出力時

　ただし、以下の条件の場合にもログファイルのローテーションを行います。なお、以下の条件でローテーションを行った場合でも、上記のタイミングに変更はありません。

• Interstage HTTP Serverを起動した後の最初のログ出力時に、logfileに指定したログファイル（ファイル名プレフィクス）がすでに存在し、そのファイルの更新日がInterstage HTTP Serverを起動した日の前日以前である場合。
• ログの出力によりログファイルを更新する際にファイルサイズが以下の上限値を超えている場合。

  

  　2Gバイト。

  

  　ulimitコマンド（ボーンシェル系）またはlimitコマンド（Cシェル系）で設定されたファイルサイズが2Gバイト以上の場合は、2Gバイト。小さい場合は、ulimitコマンドまたはlimitコマンドで設定されたファイルサイズ。

count

　ファイル数の上限値を指定します。0から999までを指定することができます。
　ファイル数が上限値に達した場合は、以下の条件により最も古いログファイルを削除して新しいログファイルを作成します。

　-sオプション指定時

　sizeで指定したファイルサイズ単位。

　-dオプション指定時

　timeで指定した日数単位。

　0、または1が指定された場合は、logfileパラメタで指定された1つのファイルでローテーションを行います。

-c

　本コマンドの以下の処理について、旧バーション（V6.0以前）の形式でログファイルを出力します。

　ローテーション処理

　本オプションを指定した場合、countで指定したファイル数の上限値は、Interstage HTTP Serverの起動から停止までの間だけ有効となります。したがって、再起動した場合は、前回の起動中に作成されたログファイルは削除の対象とならないため、不要であれば手動でログファイルを削除する必要があります。
注）削除せずに再起動を繰り返した場合は、ディスク容量を圧迫する可能性があります。
　本オプションを指定しない場合、countで指定したファイル数の上限値は、Interstage HTTP Serverの起動・停止にかかわらず、すべてのファイルに対して有効となります。したがって、再起動した場合でも、前回の起動中に作成されたログファイルを含めて、最も古いログファイルから削除されます。

　出力ファイル名

　本オプションを指定した場合、出力されるログファイルの形式は、以下のようになります。

• logfileパラメタに指定したファイル名プレフィクス.YYMMDDhhmmss[.N]
  • YYMMDDhhmmss：作成日時
    　YY：西暦年（04の場合は、2004年）
    　MM：月（1〜12）
    　DD：日（1〜31）
    　hh：時間（0〜23）
    　mm：分（0〜59）
    　ss：秒（0〜59）
  • N：通番（-sオプション指定時で、同じ日時にファイルサイズが指定したサイズを超えている場合）
    　Nは0から始まる連続の番号で、古いファイル順に、1番目のファイルの通番は“.0”、N番目のファイルの通番は“.(N-1)”となります。

　本オプションを指定しない場合、出力されるログファイルの形式は、以下のようになります。

• 最新ファイル：logfileパラメタに指定したファイル名プレフィクス
• ローテーションされたファイル：logfileパラメタに指定したファイル名プレフィクス.N
  • N：通番
    　Nは0から始まる連続の番号であり、新しいファイルの順に、1番目のファイルの通番は“.0”、N番目のファイルの通番は“.(N-1)”となります。

使用例

　環境定義ファイル(httpd.conf)において、アクセスログファイル（1Mバイト単位、ファイル数の上限値5）を、ファイル“C:\Interstage\F3FMihs\logs\accesslog”に出力する設定を行う場合(インストールパスはデフォルト)

CustomLog "|ihsrlog -s logs/accesslog 1 5" common

　上記を旧バーション（V6.0以前）の形式で設定する場合

CustomLog "|ihsrlog -s logs/accesslog 1 5 -c" common

　環境定義ファイル(httpd.conf)において、アクセスログファイル（1日単位、ファイル数の上限値5）を、ファイル“C:\Interstage\F3FMihs\logs\accesslog”に出力する設定を行う場合(インストールパスはデフォルト)

CustomLog "|ihsrlog -d logs/accesslog 1 5" common

　上記を旧バーション（V6.0以前）の形式で設定する場合

CustomLog "|ihsrlog -d logs/accesslog 1 5 -c" common

　環境定義ファイル(httpd.conf)において、アクセスログファイル（1Mバイト単位、ファイル数の上限値5）を、ファイル“/var/opt/FJSVihs/logs/accesslog”に出力する設定を行う場合(インストールパスはデフォルト)

CustomLog "|/opt/FJSVihs/bin/ihsrlog -s /var/opt/FJSVihs/logs/accesslog 1 5" common

　上記を旧バーション（V6.0以前）の形式で設定する場合

CustomLog "|/opt/FJSVihs/bin/ihsrlog -s /var/opt/FJSVihs/logs/accesslog 1 5 -c" common

　環境定義ファイル(httpd.conf)において、アクセスログファイル（1日単位、ファイル数の上限値5）を、ファイル“/var/opt/FJSVihs/logs/accesslog”に出力する設定を行う場合(インストールパスはデフォルト)

CustomLog "|/opt/FJSVihs/bin/ihsrlog -d /var/opt/FJSVihs/logs/accesslog 1 5" common

　上記を旧バーション（V6.0以前）の形式で設定する場合

CustomLog "|/opt/FJSVihs/bin/ihsrlog -d /var/opt/FJSVihs/logs/accesslog 1 5 -c" common