ファイル名
任意(*.*)
使用用途
スケジュール情報ファイルは、テキスト形式で任意のディレクトリに任意のファイル名で作成します。作成したスケジュール情報ファイルのパス名をDRMS編集ファイルのscheduleオプションで指定することで有効になります。また、本ファイルは資源配付サービス起動時および起動時に定期的に読み込まれて使用されます。
格納場所
任意
ファイル形式
func=要求機能 [，type= 起動契機] [，option= 要求機能詳細]
オプション
本形式は、1要求に対する形式です。1要求とは1個のfuncオプション単位のことを指します。1要求は1行に記述し、行末尾に改行を入れてください。1要求の途中で改行を入れることはできません。
本形式の要求は、行単位に複数記述することができます。
オプションおよびパラメタは、英小文字で指定してください。
指定内容に誤りがあった場合、誤りのある要求を無視し実行しません。その他の正しい指定の要求は実行されます。誤りがあった場合、警告メッセージを資源配付メッセージとして出力します。
コメント行としたい場合、行の先頭1バイトに「#」を指定します。
各オプションの指定値を以下に示します。
funcオプション | typeオプション | optionオプション |
|---|---|---|
complete(send) | quick | sysname(通知先のノード名) |
event(inventory) | time(日時) | sysname(通知先のノード名) |
funcオプションにcomplete(apply)を指定して、typeオプションにquickを指定した場合は、サーバ即時適用時にその資源グループだけの適用結果を通知します。クライアントの適用結果は通知されません。
クライアントの適用結果を通知する場合は、quick以外を指定してください。
func=要求機能
要求機能として指定する種別を以下に示します。
complete(send)：送信結果の通知 |
type=起動契機
通知する契機として指定する種別を以下に示します。
quick：要求を受け付けた際に即時に通知 |
要求を受け付けた際に即時に通知する場合に指定します。
funcオプションにcomplete(apply)を指定して、typeオプションにquickを指定した場合は、サーバ即時適用時にその資源グループだけの適用結果を通知します。なお、本オプションでは、クライアントの適用結果は通知されません。クライアントの適用結果を通知する場合は、typeオプションにquick以外を指定してください。
timeの起動時間(week / MM DD hh mm)の指定方法を以下に示します。
曜日(日曜日:sun,月曜日:mon,火曜日:tue,水曜日:wed,木曜日:thu,金曜日:fri,土曜日:sat)
月
日
時
分
曜日と月日時分は「/」で区切ります。「/」の前後に一つの空白が必要です。月日時分は、一つの空白で区切ります。
一定間隔を指定する場合は「*」を指定します。
「week」と「MM DD」の値の指定は、どちらか片方だけ指定してください。値を指定しない方は「*」を指定してください。「week」と「MM DD」の両方に値を指定した場合は、誤りとみなされます。
なお、指定された通知契機の処理中に資源配付を停止した場合、エラーメッセージを出力して処理を中断します。中断された結果通知の内容は、資源配付の再起動後、次回の該当資源のスケジュール時に自動的に通知されます。
資源配付の再起動時に通知する場合に指定します。
option=要求機能詳細
本オプションは、funcオプションに対する詳細情報を設定します。本オプションの指定は「"」(ダブルクォーテーション)で囲みます。「"」(ダブルクォーテーション)内の複数パラメタは「,」(カンマ)で区切ります。
func=complete(send)または、func=complete(apply)を指定した場合
sysname(運用管理サーバのノード名)：結果通知先として運用管理サーバのノード名を指定 |
func=compelete(send)指定時: 隣接サーバの情報を通知対象とします。
func=compelete(apply)指定時: 自分自身の情報と配下クライアントの情報を通知対象とします。
sysnameパラメタは、通知先の運用管理サーバのノード名を指定します。ノード名は、DRMS編集ファイルに記述したnametypeオプションに合わせて、IPアドレスまたはホスト名を指定します。複数指定する場合は「,」(カンマ)で区切ります。IPv4アドレスを指定する場合は、先頭に0を付けると8進数での指定扱いとなりますので、先頭に0は指定しないでください。
rscパラメタの指定値を、以下に示します。なお、複数指定する場合は「,」(カンマ)で区切ります。
メンテナンス版数資源を通知対象とします。
メンテナンス版数資源を含む全資源グループを通知対象とします。
指定の資源グループまたは製品を通知対象とします。
以下の形式で指定します。各項目は「/」で区切り、資源グループのバージョン・レベルは省略可能です。
資源グループ名[/バージョン・レベル]
製品名/バージョン・レベル/OS識別名
なお、製品名に「/」を指定することはできません。
共通・個別メンテナンス版数および個別資源のすべての結果(正常、異常、処理中)を、合わせて通知します。
retryパラメタには、通知が失敗した場合のリトライ間隔時間とリトライ回数を指定します。
本パラメタは省略可能であり、指定を省略した場合は、リトライを行いません。
リトライ間隔時間は、分を単位として指定します。1から1440までの10進数で指定します。
回数は、リトライを行う回数を指定します。1から30までの10進数で指定します。回数は省略可能であり、リトライ間隔時間を指定し回数を省略した場合のリトライ回数は1回となります。
すべてのメンテナンス版数を通知対象とする場合に指定します。
func=event(inventory)を指定した場合
sysnameパラメタは、インベントリ通知先の運用管理サーバまたは全体監視サーバのノード名を指定します。ノード名は、DRMS編集ファイルに記述したnametypeオプションに合わせてIPアドレスまたはホスト名を指定します。複数指定する場合は「,」(カンマ)で区切ります。IPv4アドレスを指定する場合は、先頭に0を付けると8進数での指定扱いとなりますので、先頭に0は指定しないでください。
retryパラメタには、通知が失敗した場合のリトライ間隔時間とリトライ回数を指定します。
本パラメタは省略可能であり、指定を省略した場合は、リトライを行いません。
リトライ間隔時間は、分を単位として指定します。1から1440までの10進数で指定します。
回数は、リトライを行う回数を指定します。1から30までの10進数で指定します。回数は省略可能であり、リトライ間隔時間を指定し回数を省略した場合のリトライ回数は1回となります。
参照
drmscsv(CSV情報（資源の配付・適用状況/インベントリ）の変更/データベース登録コマンド)
スケジューリング機能を用いて、運用管理サーバに通知されたあとに上記コマンドを実行した結果、インベントリ情報のCSVファイルが出力されます。出力形式の変更はありません。
注意事項
【UNIX版】
HP-UXおよびAIXでは、クライアントまたは業務サーバからHTTPSを使用した資源の取り出しはできませんのでHTTPを使用してください。また、S/MIMEも使用できません。
コンピュータの言語環境がUTF-8の場合、スケジュール情報ファイルを直接編集する際に全角文字を使用することはできません。
回避方法：
全角文字の指定が必要な場合は、[資源配付]ウィンドウを使用して編集してください。
コンピュータからスケジュール情報ファイルを編集するときに全角文字を使用する場合は、コンピュータの言語環境をEUCに切り替えてください。
使用例
通知スケジュールを行う場合のスケジュール情報ファイルの設定例を以下に示します。記載例は紙面の都合上、1要求途中で自動的に改行表示され、複数行に渡っているものもありますが、実際の記述は1要求=1行として記述する必要があります。また、「↓」を改行記号として表示しています。
設定例1
メンテナンス版数資源の資源中継(ダウンロード)で送信エラーが発生した場合、運用管理サーバ(IPアドレス:123.123.123.12)にすべての結果を通知します。リトライは10分後に1回実施します。
func=complete(send),type=quick,option="sysname(123.123.123.12),rsc(rms),sts(all),retry=10"↓
設定例2
メンテナンス版数資源の資源適用状況(すべての結果)を、適用が完了した時点で運用管理サーバ(IPアドレス:123.123.123.12)に通知します。リトライは10分後に1回実施します。
func=complete(apply),type=quick,option="sysname(123.123.123.12),rsc(rms),sts(all),retry=10"↓
設定例3
メンテナンス版数資源の資源適用状況(すべての結果)を、毎日9時0分に運用管理サーバ(IPアドレス:123.123.123.12)に通知します。リトライは10分間隔で3回実施します。
func=complete(apply),type=time(* / * * 9 0),option="sysname(123.123.123.12),rsc(rms),sts(all),retry=10/3"↓
設定例4
メンテナンス版数資源の資源適用状況(すべての結果)を、毎週水曜日12時30分に運用管理サーバ(ホスト名:server1)に通知します。リトライは30分後に1回実施します。
func=complete(apply),type=time(wed / * * 12 30),option="sysname(server1),rsc(rms),sts(all),retry=30"↓
設定例5
すべての資源の適用状況(すべての結果)を、毎月1日18時0分に運用管理サーバ(ホスト名:server1)に通知します。リトライは行いません。
func=complete(apply),type=time(* / * 1 18 0),option="sysname(server1),rsc(all),sts(all)"↓
設定例6
毎日9時に運用管理サーバ(ホスト名:server1)に、インベントリ情報を通知します。リトライは行いません。
func=event(inventory),type=time(* / * * 9 0),option="sysname(server1)"↓
設定例7
毎週土曜日の22時に運用管理サーバ(ホスト名:server1)に、インベントリ情報を通知し、失敗した場合はリトライを10分間隔で10回まで行う場合。
func=event(inventory),type=time(sat / * * 22 0),option="retry=10/10,sysname(server1)"↓
設定例8
毎週月、水、金曜日の8時30分に運用管理サーバ(ホスト名:server1)に、インベントリ情報を通知し、失敗した場合はリトライを15分間隔で5回まで行う場合
func=event(inventory),type=time(mon / * * 8 30),option="retry=15/5,sysname(server1)"↓ func=event(inventory),type=time(wed / * * 8 30),option="retry=15/5,sysname(server1)"↓ func=event(inventory),type=time(fri / * * 8 30),option="retry=15/5,sysname(server1)"↓
設定例9
毎月10日の22時に運用管理サーバ(ホスト名:server1)に、インベントリ情報を通知し、失敗した場合はリトライを5分間隔で10回まで行う場合。
func=event(inventory),type=time(* / * 10 22 0),option="retry=5/10,sysname(server1)" ↓
設定例10
7月4日の13時に運用管理サーバ(ホスト名:server1)に、インベントリ情報を通知し、失敗した場合はリトライを5分間隔で5回まで行う場合。
func=event(inventory),type=time(* / 7 4 13 0),option="retry=5/5,sysname(server1)"↓
設定例11
メンテナンス版数資源の情報を運用管理サーバ(IPアドレス:123.123.123.12)に通知します。リトライは10分後に1回実施します。
func=complete(send),type=quick,option="sysname(123.123.123.12),rsc(rms),sts(all),retry=10"↓
