設定ジョブで SCP (put) コマンドを使用する
NetScaler ADM の構成ジョブ機能を使用して 、構成ジョブの作成、電子メール通知の送信、作成されたジョブの実行ログの確認を行うことができます。ジョブとは、管理対象インスタンスに対して作成および実行できる構成コマンドのセットです。たとえば、デバイスのアップグレードのために構成ジョブを使用できます。
NetScaler ADM の構成ジョブでは、Secure Shell(SSH)コマンドを使用してインスタンスを構成し、Secure Copy(SCP)を使用してファイルを安全に転送するように構成ジョブを構成できます。SCP は SSH プロトコルに基づいています。構成ジョブに含めることができるSCPコマンドの1つは、「put」コマンドです。構成ジョブで「put」コマンドを使用して、システムのローカルディレクトリに保存されている1つ以上のファイルをCitrix ADMにアップロードまたは転送し、次にCitrix ADC インスタンスまたはインスタンス上のディレクトリに転送できます。
注:
ファイルはCitrix ADMにアップロードされ、後で選択したCitrix ADCインスタンスにコピー(PUT)されます。アップロードされたファイルはCitrix ADM に保存され、ジョブが削除されたときにのみ削除されます。これは、後で実行するようにスケジュールされているジョブに必要です。
このコマンドの構文を次に示します。
put <local_filename> <remote_path/remote_filename>
<!--NeedCopy-->
各項目の意味は次のとおりです。
<local_filename>は、アップロードするローカルファイルの名前です。
<remote_path/ remote_filename>は、リモートディレクトリへのパス、およびファイルがそのディレクトリにコピーされるときにそのファイルに割り当てる名前です。
構成ジョブの作成中に、ローカルファイル名とリモートファイル名のパラメーターを変数に変換できます。これにより、ジョブを実行するたびに、同じCitrix ADCインスタンスのセットに対して、これらのパラメーターに異なるファイルを割り当てることができます。また、1つのファイルをジョブ内の複数の位置で使用しており、そのファイルの名前を変更する必要がある場合は、すべての位置でファイル名を変更するのではなく、変数を再定義できます。
put コマンドを使用して、設定ジョブでファイルをアップロードするには、次の手順を実行します。
-
NetScaler ADM で、[ インフラストラクチャ]>[構成]>[構成ジョブ]に移動します
-
[ ジョブ ] ページで、[ ジョブの作成] をクリックします。
-
[ ジョブの作成 ] ページで、[ジョブ名] フィールドにジョブの名前を入力し、[ 構成エディタ ] ペインで [put] コマンドを入力します。
たとえば、ローカルシステムに保存されているSSL証明書ファイルを複数のCitrix ADCインスタンスにコピーする構成ジョブを作成する場合は、特定のファイルの名前の代わりに変数を使用する「put」コマンドを追加し、変数の種類を「file」として定義できます。
put ssl-file /nsconfig/ssl-file <!--NeedCopy-->
この例の説明を次に示します。
-
ssl-file
-Citrix ADCインスタンスにアップロードする必要があるファイルの名前です。 -
/nsconfig/ssl-file
- タスクの実行後にssl-file
が配置されるインスタンス上の宛先フォルダです。
-
-
次の図に示すように、入力したコマンドで、変数に変換するファイル名を選択し、[ 変数に変換] をクリックします。
-
ファイル名がドル記号 (変数であることを示す) で囲まれていることを確認し、変数をクリックします。
-
名前、表示名、タイプなど、変数の詳細を指定します。
-
[ タイプ ] ドロップダウンリストから [ ファイル] を選択します。[ 保存] をクリックします。
変数を「ファイル」タイプとして宣言すると、ファイルをCitrix ADM にアップロードできます。
-
[ 次へ ]をクリックし、ファイルをコピーするCitrix ADCインスタンスを選択します。
-
[ 変数値の指定 ]タブで、[ すべてのインスタンスの共通変数値 ]セクションで、システム上のローカルストレージからファイルを選択し、[ アップロード ]をクリックしてファイルをCitrix ADMにアップロードし、[ 次へ]をクリックします。
-
[ Job Preview ] タブでは、各インスタンスまたはインスタンスグループで実行するコマンドを評価および検証できます。
-
[ Execute ] タブでは、ジョブを今すぐ実行することも、後で実行するようにスケジュールすることもできます。コマンドが失敗した場合にCitrix ADMが実行する必要があるアクションを選択することもできます。また、ジョブの成功または失敗、およびその他の詳細について通知を受け取るように、メール通知を作成できます。[完了] をクリックします。
-
ジョブの詳細を確認するには、[ インフラストラクチャ] > [構成] > [構成ジョブ] に移動し、設定したジョブを選択します。 [ 詳細] をクリックし、[ 変数の詳細 ] をクリックすると、ジョブに追加された変数が一覧表示されます。