エージェントレスアイコン:ジョブネット

エージェントレスアイコンは対象ホストにSSH接続を行い、コマンドの発行と実行結果の取得を行います。
また、任意のセッションIDを指定することにより、他のエージェントレスアイコンで接続したSSHセッションを共有することが可能です。なお、共有されたセッションは自ジョブネット、およびサブジョブネット内でのみ有効です。
※SSHの接続ポートは22固定となります。
※本アイコンで指定するホストにジョブエージェントをインストールする必要はありません。

エージェントレスアイコンの使用例

エージェントレスアイコンはセッションに「接続」を指定すると、他のエージェントレスアイコン(「継続」、「切断」)で、同一のSession-IDを利用できます。
また、セッションに「ワンタイム」を指定すると、ホストに対する接続、コマンドの実行、切断の一連の動作を実行します。
エージェントレスアイコンの使用例


エージェントレスアイコンの設定

(1).選択したエージェントレスアイコンのコンテキストメニューより「設定」を選択します。
(2).エージェントレスアイコンの設定ダイアログが表示されます。
Job Arranger for Zabbix エージェントレスアイコン Job Arranger for Zabbix エージェントレスアイコン
(3).各項目について入力します。

項目名 形式 説明
ジョブID テキストボックス ジョブを識別するIDを半角英数字、ハイフン(-)、アンダーバー(_)で指定します。
アイコン配置直後は初期値として「識別子(LESS-)+連番」のIDが自動採番されます。
重複登録不可です。
半角32文字まで入力可能です。
ジョブ名 テキストボックス ジョブの名称を指定します。
ひらがな、全角カタカナ、半角カタカナ、全角英数字、半角英数字、記号が使用可能です。
全角32文字、半角64文字まで入力可能です。
省略可能です。
セッション ラジオボタン ホストへの接続後のセッション状態を指定します。
「ワンタイム」はホストへの接続・コマンド実行・切断を一括して行います。なお、セッションIDによるセッションの共有は行えません。
「接続」はホストへの接続とコマンドの実行を行います。また、ホストとのセッション情報はセッションID単位で管理されます。
「継続」はセッションIDが示す接続先に対し、コマンドの実行のみを行います。
「切断」はセッションIDが示す接続先に対し、セッションの切断を行います。
セッションID テキストボックス ホストとの接続(セッション)を識別するユニークなIDを指定します。
半角英数字、ハイフン(-)、アンダーバー(_)のみ使用可能です。
半角64文字まで入力可能です。
セッションが「ワンタイム」の場合は指定不可となります。
ホスト リストボックス
テキストボックス
接続対象となるホスト(サーバ)を指定します。
「ホスト名」ではZabbixに登録済みのホストを選択します。
「変数名」ではホスト名が格納されたジョブコントローラ変数を指定します。
ASCII文字のみ使用可能です。半角128文字まで入力可能です。
認証方式 リストボックス SSH接続時の認証方式を指定します。
「パスワード」の場合、ユーザー名とパスワードによる認証を行います。
「公開鍵」の場合、ユーザー名、公開鍵、秘密鍵、パスフレーズによる認証を行います。
実行モード リストボックス コマンドの実行方式を指定します。
「対話モード」の場合、指定されたプロンプト文字を受信することでコマンド実行の終了とします。
コマンドの実行結果はジョブコントローラ変数(STD_OUT)に格納されます。なお、コマンドの戻り値(リターンコード)は取得できません。
「非対話モード」の場合、コマンド送信後に実行結果の取得を開始します。
コマンドの実行結果はジョブコントローラ変数(STD_OUT、STD_ERR、JOB_EXIT_CD)に格納されます。
ユーザー名 テキストボックス SSH接続時のユーザー名を指定します。
ひらがな、全角カタカナ、半角カタカナ、全角英数字、半角英数字、記号が使用可能です。全角128文字、半角256文字まで入力可能です。
また、ジョブコントローラ変数($変数名)を指定することも可能です。
パスワード テキストボックス SSH接続時のパスワードを指定します。
全角128文字、半角256文字まで入力可能です。
認証方式が「公開鍵」の場合のみ指定可能です。
また、ジョブコントローラ変数($変数名)を指定することも可能です。
公開鍵 テキストボックス SSH接続時に使用する公開鍵の格納されたファイル名を指定します。
ファイルはジョブサーバがアクセス可能なディレクトリに配置する必要があります。
ASCII文字のみ使用可能です。半角2048文字まで入力可能です。
認証方式が「公開鍵」の場合のみ指定可能です。
また、ジョブコントローラ変数($変数名)を指定することも可能です。
秘密鍵 テキストボックス SSH接続時に使用する秘密鍵の格納されたファイル名を指定します。
ファイルはジョブサーバがアクセス可能なディレクトリに配置する必要があります。
ASCII文字のみ使用可能です。半角2048文字まで入力可能です。
認証方式が「公開鍵」の場合のみ指定可能です。
また、ジョブコントローラ変数($変数名)を指定することも可能です。
パスフレーズ テキストボックス 公開鍵の作成時に指定したパスフレーズを指定します。
パスフレーズを使用していない場合は省略可能で
す。 全角128文字、半角256文字まで入力可能です。
認証方式が「公開鍵」の場合のみ指定可能です。
また、ジョブコントローラ変数($変数名)を指定することも可能です。
実行 テキストボックス ホストに対し実行するコマンドを指定します。
コマンド文字列にはジョブコントローラ変数(${変数名})を含む事が可能です。
ひらがな、全角カタカナ、半角カタカナ、全角英数字、半角英数字、記号が使用可能です。全角2000文字、半角4000文字まで入力可能です。
セッションが「切断」では指定不可です。
プロンプト文字列 テキストボックス コマンドの送信完了を判断する文字列を指定します。
コマンド文字列にはジョブコントローラ変数(${変数名})を含む事が可能です。
ひらがな、全角カタカナ、半角カタカナ、全角英数字、半角英数字、記号が使用可能です。全角128文字、半角256文字まで入力可能です。
実行モードが「非対話モード」では値が無視されます。また、セッションが「切断」では指定不可です。
文字コード リストボックス コマンドを含むホストと送受信するデータの文字コードを指定します。
また、リストに無い文字コードを直接入力することも可能です。
無効な文字コードが指定された場合は文字コードの変換を行いません。
有効な文字コードはジョブサーバが稼働するサーバ上で「iconv --list」コマンドを発行することで確認が可能です。
ASCII文字のみ使用可能です。半角80文字まで入力可能です。
セッションが「ワンタイム」および「接続」の場合のみ指定可能です。
改行コード リストボックス コマンドを送信する際に使用する改行コードを指定します。
「LF」、「CR」、「CRLF」の3種類が指定可能です。
セッションが「ワンタイム」および「接続」の場合のみ指定可能です。
タイムアウト警告 テキストボックス タイムアウト警告メッセージを出力するまでの時間を分単位(1~99999)で示します。(警告無し場合は0となります)
指定された時間(分)を経過してもジョブが終了しない場合、アイコンの色が橙色に変化し、警告メッセージをログに出力します。なお、タイムアウト後も処理は継続します。
半角数字のみ使用可能です。5桁まで入力可能です。
ジョブ停止コード テキストボックス ジョブの停止条件となる戻り値を指定します。指定された戻り値を検出した場合、アイコンを停止します。
カンマ(,)での複数指定、およびハイフン(-)での範囲指定が可能です。
半角数字、カンマ(,)、ハイフン(-)のみ使用可能です。
半角32文字まで入力可能です。省略可能です。
強制実行 チェックボックス ホストが無効の場合でも処理を実行します。
ホストが無効で、このオプションが無効の場合は、エラーが発生します。