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

18.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までを指定することができます。

　作成中のログファイルのファイルサイズが以下の上限値を超えた場合にもログファイルを作成します。

　2Gバイト。

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

　なお、指定した日数ではなく、ファイルサイズの上限値を超えてログファイルを作成した場合は、1つ前のログファイル（日数を超えて作成したログファイル）の作成日からの日数により次のファイルを作成することになります。

count

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

　-sオプション指定時

　作成中のログファイルのファイルサイズがsizeで指定したサイズを超えたとき。

　ulimitコマンド（ボーンシェル系）またはlimitコマンド（Cシェル系）で設定されたファイルサイズがsizeで指定したサイズよりも小さい場合は、作成中のファイルサイズがulimitコマンドまたはlimitコマンドで設定されたファイルサイズを超えたとき。

　-dオプション指定時

　最新ファイルの作成日からtimeで指定した日数を超えたとき（システム時刻の日付更新時）、または作成中のログファイルのファイルサイズが以下の上限値を超えたとき。

　2Gバイト。

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

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

-c

　本コマンドの以下の処理について、V6.0.1以前と同じ形式でログファイルを出力します。

　ローテーション処理

　本オプションを指定した場合、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.1以前と同じ形式で設定する場合

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.1以前と同じ形式で設定する場合

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.1以前と同じ形式で設定する場合

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.1以前と同じ形式で設定する場合

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