Application Delivery Management

設定ジョブで SCP (put) コマンドを使用する

Citrix ADM の構成ジョブ機能を使用して、構成ジョブの作成、電子メール通知の送信、作成されたジョブの実行ログの確認を行うことができます。ジョブとは、管理対象インスタンスに対して作成および実行できる構成コマンドのセットです。たとえば、デバイスのアップグレードのために構成ジョブを使用できます。

NetScaler ADM の構成ジョブでは、Secure Shell(SSH)コマンドを使用してインスタンスを構成し、Secure Copy(SCP)を使用してファイルを安全に転送するように構成ジョブを構成できます。SCPは、SSHプロトコルに基づいています。構成ジョブに含めることができるSCPコマンドの1つは、「put」コマンドです。構成ジョブで「put」コマンドを使用して、システムのローカルディレクトリに保存されている1つ以上のファイルをNetScaler ADMにアップロードまたは転送し、次にNetScaler インスタンスまたはインスタンス上のディレクトリに転送できます。

注: ファイルはCitrix ADM にアップロードされ、後で選択したNetScalerインスタンスにコピー(配置)されます。アップロードされたファイルはNetScaler ADM に保存され、ジョブが削除されたときにのみ削除されます。これは、後で実行するようにスケジュールされているジョブの場合に、必要になります。

このコマンドの構文を次に示します:

put <local_filename> <remote_path/remote_filename>

各項目の意味は次のとおりです。

<local_filename>は、アップロードするローカルファイルの名前です。

<remote_path/remote_filename>はリモートディレクトリへのパスと、そのディレクトリにコピーされるときにファイルに割り当てる名前です。

構成ジョブの作成中に、ローカルファイル名とリモートファイル名のパラメーターを変数に変換できます。これにより、ジョブを実行するたびに、同じ一連のNetScalerインスタンスのために、これらのパラメーターに異なるファイルを割り当てることができます。また、1つのファイルをジョブ内の複数の位置で使用しており、そのファイルの名前を変更する必要がある場合は、すべての位置でファイル名を変更するのではなく、変数を再定義できます。

put コマンドを使用して、設定ジョブでファイルをアップロードするには、次の手順を実行します。

  1. [ ネットワーク ] > [ 構成ジョブ] に移動します。

  2. [ ジョブ ] ページで、[ ジョブの作成] をクリックします。

  3. [ ジョブの作成 ] ページで、[ジョブ名] フィールドにジョブの名前を入力し、[ 構成エディタ ] ペインで [put] コマンドを入力します。

    たとえば、ローカルシステム上に保存されているSSL証明書ファイルを複数のNetScalerインスタンスにコピーする構成ジョブを作成する必要がある場合は、特定のファイルの名前の代わりに変数を使用する「put」コマンドを追加し、変数のタイプを「ファイル」として定義できます。

    put ssl-file /nsconfig/ssl-file
    <!--NeedCopy-->
    

    この例の説明を次に示します。

    • ssl-file - これは、NetScalerインスタンスにアップロードする必要があるファイルの名前です。

    • /nsconfig/ssl-file - これは、タスクの実行後にssl-fileが格納される、インスタンス上の目的フォルダーです。

  4. 先ほど入力したコマンドで、変数に変換するファイル名を選択し、次の図に示すように「変数に 変換」をクリック します。

    ローカライズされた画像

  5. ファイル名がドル記号 (変数であることを示す) で囲まれていることを確認し、変数をクリックします。

  6. 名前、表示名、タイプなど、変数の詳細を指定します。

  7. [ タイプ ] ドロップダウンリストから [ ファイル] を選択します。[保存] をクリックします。変数を「ファイル」タイプとして宣言すると、ファイルをNetScaler ADM にアップロードできます。

    ローカライズされた画像

  8. [へ ] をクリック し、ファイルのコピー先のNetScalerインスタンスを選択します。

  9. 変数値の指定 ]タブで、[ すべてのインスタンスの共通変数値 ]セクションを選択し、システム上のローカルストレージからファイルを選択し、[アップロード]をクリックしてNetScaler ADMにファイルをアップロードし、[次へ]をクリックします。

    ローカライズされた画像

  10. [Job Preview] タブでは、各インスタンスまたはインスタンスグループで実行するコマンドを評価および検証できます。

  11. [実行 ] タブで は、ジョブを今すぐ実行することも、後で実行するようにスケジュールすることもできます。コマンドが失敗した場合にCitrix ADM が実行するアクションを選択することもできます。また、ジョブの成功または失敗、およびその他の詳細について通知を受け取るように、メール通知を作成できます。[完了]をクリックします。

  12. ジョブの詳細は、[ネットワーク ] > [構成ジョブ] に 移動し、 構成したばかりのジョブを選択すると表示されます。[ 詳細] をクリックし、[変数の詳細] をクリックして、ジョブに追加された変数を一覧表示します。

    ローカライズされた画像

設定ジョブで SCP (put) コマンドを使用する

この記事の概要