イベント監視機能では、メッセージログ、コマンドログを切り替えるために、メッセージログ/コマンドログの切り替えコマンドを提供しています。
本コマンドは、イベント監視機能とリモートコマンドに関連するログファイルを、任意の時点で強制的に切り替えるために使用します。インストール種別により、切り替えの対象ファイルは、次のように異なります。
イベント監視機能で使用するメッセージログデータベースのDSI
リモートコマンドで使用するログファイル
イベント監視機能で使用するメッセージログファイル
リモートコマンドで使用するコマンドログファイル
それぞれのインストール種別で切り替えられるログは、一方だけを切り替えることも、両方を同時に切り替えることもできます。
機能説明
運用管理サーバ上で実行する場合と、その他のサーバおよびクライアント上で実行する場合とで、切り替え内容が異なります。
使用中であったメッセージログDB内のDSIを次に使われるformat済のDSIに切り替えます。
使用中であったメッセージログファイルを新しいメッセージログファイルに切り替えます。
使用中であったコマンドログファイルを、新しいコマンドログファイルに切り替えます。
記述形式
opalogchg | [-m] [-c] [-n lognum] |
オプション
運用管理サーバ上で実行した場合は、メッセージログDSIを切り替えます。
その他のサーバおよびクライアント上で実行した場合は、メッセージログファイルを切り替えます。
コマンドログファイルを切り替えます。
ログファイルを切り替え後、新しく作成されるログファイルの1ログファイルあたりの格納データ数を指定します。ただし、運用管理サーバでメッセージログDSIのみを切り替える場合(-mオプションのみ指定時)は、-nのオプションは無効です。
Windows版の場合、値の範囲は255～16383です。
UNIX版の場合、値の範囲は255～100000です。
省略すると、[システム監視設定]-[通信環境定義]-[通信環境定義詳細]の[ログファイル定義]で定義した数値となります。
注意
-mおよび-cオプションを同時に省略/指定した場合
-mと-cの両方を省略した場合、または-mと-cの両方が指定された場合は、運用管理サーバ上ではメッセージログDSIとコマンドログファイルの両方が、その他のサーバおよびクライアント上ではメッセージログファイルとコマンドログファイルの両方が切り替えられます。
復帰値
正常終了
異常終了
参照
コマンド格納場所
Windows | Systemwalkerインストールディレクトリ\MpWalker.dm\bin |
UNIX | /opt/systemwalker/bin |
実行に必要な権限/実行環境
【Windows】
運用管理サーバ/部門管理サーバ/業務サーバでは、Administratorユーザのみが実行できます。
運用管理クライアント/クライアントでは、Administrator権限が必要です。
本コマンドは、[管理者として実行]を選択して起動したコマンドプロンプト上で実行してください。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。
【UNIX】
運用管理サーバ/部門管理サーバ/業務サーバでは、システム管理者(スーパーユーザ)権限が必要です。
運用管理クライアント/クライアントでは、Administrator権限が必要です。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。
注意事項
【UNIX】
本コマンドを実行するには、本コマンドの実行環境のロケールとシステムのロケールが一致している必要があります。実行環境のロケールとシステムのロケールが一致していない状態で本コマンドを実行すると、異常終了します。
実行結果/出力形式
ログDSI(ログファイル)の切り替えが行われた後にコマンド復帰します。 正常にログDSI(ログファイル)の切り替えが行われた場合、標準エラーに以下のメッセージを出力して復帰コード0で正常終了します。
運用管理サーバ上で実行した場合
【Windows版】
新しく使用中となったDSIKEY
↓
NT:opalogchg: 情報: 0001: メッセージログDSIの切替えに成功しました DSIKEY=2
opalogchg:情報:571:コマンドログファイルの切替えに成功しました file=C:\・・・\tmp\opalogcmd01
↑
新しく使用中となったログファイル【UNIX版】
新しく使用中となったDSIKEY
↓
UX:opalogchg: 情報: 0001: メッセージログDSIの切替えに成功しました DSIKEY=02
UX:opalogchg: 情報: 571: コマンドログファイルの切替えに成功しました file=/var/opt/・・・/cmdlog01/opalogcmd07
↑
新しく使用中となったログファイルその他のサーバおよびクライアント上で実行した場合
【Windows版】
opalogchg:情報:570:メッセージログファイルの切替えに成功しました file=C:\・・・t\msglog\opalogmsg00 opalogchg:情報:571:コマンドログファイルの切替えに成功しました file=C:\・・・\tmp\opalogcmd00
【UNIX版】
UX:opalogchg: 情報: 570: メッセージログファイルの切替えに成功しました file=/var/opt/・・・/log/opalogmsg05 UX:opalogchg: 情報: 571: コマンドログファイルの切替えに成功しました file=/var/opt/・・・/cmdlog01/opalogcmd07