Use SCP (put) command in configuration jobs 编辑

You can use the Configuration Jobs feature of Citrix ADM to create configuration jobs, send email notifications, and check execution logs of the jobs created. A job is a set of configuration commands that you can create and run on a single managed instance or on multiple managed instances. For example, you can use configuration jobs for device upgrades.

Configuration jobs in Citrix ADM use Secure Shell (SSH) commands to configure instances, and you can configure a configuration job to use secure copy (SCP) to securely transfer files. SCP is based on the SSH protocol. One of the SCP commands that you can include in a configuration job is the “put” command. You can use the “put” command in configuration jobs to upload or transfer one or more files stored in a local directory on your system to Citrix ADM and then to a directory on the NetScaler instance or instances.

Note The file is uploaded to Citrix ADM and it is later copied (put) to the selected NetScaler instances. The uploaded file is stored in Citrix ADM and is deleted only when the job is deleted. This is necessary for jobs scheduled to execute at a later time.

The command has the following syntax:

put <local_filename> <remote_path/remote_filename>

where,

<local_filename> is the name of the local file to be uploaded.

<remote_path / remote_filename> is the path to a remote directory, and the name to assign to the file when it is copied to that directory.

While creating the configuration job, you can convert the local and remote file name parameters into variables. This lets you assign different files to these parameters for the same set of NetScaler instances every time you execute the job. Also, when you use a file at multiple places in a job and if you want to rename the file, you can redefine the variable instead of changing the file name at all places.

To use the put command to upload files in a configuration job:

1. Navigate to Networks > Configuration Jobs.

2. On the Jobs page, click Create Job.

3. On the Create Job page, enter the name of the job in the Job name field, and in the Configuration Editor pane, enter the “put” command.

   For example, if you want to create a configuration job that copies a SSL certificate file saved on your local system to multiple NetScaler instances, you can add a “put” command that uses a variable instead of the name of a particular file, and define the variable type as “file”.

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