Copying a file

You may copy a file from your PC (local file) or a Supervisor file to your remote stations. A local file may be anywhere on your PC. It is a file that is outside of the directory structure that is available from inside your Supervisor station.

Prerequisites: You are working in Workbench and are connected to your Supervisor station. A ProvisioningNwExt component and a NiagaraNetworkJobPrototype component are available under your NiagaraNetwork.

Expand Config > Drivers and do one of the following:
- To set up a one-time job that copies a local file from anywhere on your PC to your remote devices, double-click ProvisioningNwExt
- To set up a repeating job that copies a file from inside the directory structure that is available from inside your Supervisor station, double-click NiagaraNetworkJobPrototype.
For the local file, a Niagara Network Job Builder opens. For the Supervisor file, a Niagara Network Prototype View opens. They look the same except for the title and buttons at the bottom.
In the top pane, Provisioning steps to run, click add () and select the a copy file step.
The system opens the file chooser.
If you are creating a one-time job using the Niagara Network Job Builder, you can select either a Supervisor file or a local file on your PC. If you are creating a job prototype using the Niagara Network Prototype View, you can select only a Supervisor file.
Select a local source file to copy.
A Destination window prompts you for the target destination to copy this file to.
This destination folder applies to all stations in the job.
To edit the destination, click into the entry box and type a destination.
In the example above, the destination was changed to specify a nav folder under the station root absolute (^). If a destination folder does not already exist on the target host, the step creates it.

NOTE: The destination string must always begin with the character for either the system-home relative (!) or the station-home relative (^). The system provides no means to modify any files outside of the release directory on any target hosts.

When the job runs, the system makes a temporary copy of the file on the Supervisor unless the file being copied is local to the Supervisor (that is, you are using Workbench on the Supervisor). Once the job completes, the system deletes this temporary file.

To run the provisioning job more efficiently, the system combines file copy steps with other file copy steps, install software steps, or upgrade out-of-date software steps.