Watchfolder Options

The following tables provide information on additional configurable settings that are available when creating watchfolders.

Watchfolder Settings

Note: A watchfolder groups new or updated files it detects in its source folder into "drops". A drop is defined by the duration set by the snapshot creation period. All files in a given drop are transferred in the same transfer session, post-processed together, and reported as a unit.
Option Description
Drop detection strategy The strategy this watchfolder uses to detect files dropped into the source folder.
  • Cool off only: Create a drop that includes new files added within the duration by the snapshot creation period.
  • Top level files: Create a drop for each file placed in the top level of the source folder.
  • Top level directories: Create a drop for each directory placed in the top level of the source folder. This drop also includes the sub-directories and files in the top level directory.
Drop detection cool off The duration allowed for new files to be included in a drop. Aspera recommends choosing a multiple of the specified snapshot_creation_period for predictable results.
Snapshot creation period The duration used to determine what files are included in the current drop.
Connect timeout The duration the source node waits to connect to the destination node.
Sample period The frequency of the system estimateing the available bandwidth.
Queue threshold The duration watchfolder adds files to a session. Use this feature to limit the number of files transferred based on the computed available bandwidth.
Retry duration The duration in which the source node tries to establish a connection with the destination node.
Wait between retries The duration the source node waits in between retries.
File detection cool off The duration watchfolder in which placing a new file in the source folder does not trigger a new drop.
Note: This setting does not apply to the Cool off only detection strategy.
File filters Click the button to add a new filter to identify file lists. You can set a filter to include or exclude files by globbing or by regular expression.

Transfer

Option Description
Target rate The transfer target rate.
Minimum rate The transfer minimum rate
Bandwidth policy Choose a transfer policy among fixed | high | fair | low.
Transport Encryption Select aes-128 to transfer with this encryption method.
Retry policy The number of attempts and the duration between each retry.

Security

Option Description
Content Protection
Select Encrypt transferred files with a password to enable content encryption. Enter and confirm the password the recipient must use to decrypt the transferred files.
Note: When editing a watchfolder with content protection enabled, you must re-The content protection password. A password must be provided in order to save changes to the watchfolder.

File Handling

Option Description
Resume policy Specify a resume policy and the overwrite rule when the file exists on the destination.
File attributes Preserve file UIDs, GIDs, or timestamps.
Source Archiving The designated directory source files are moved to after completing a transfer. The transfer's session details page display the archive directory's filepath as the After transfer path.
Note: The After transfer path will only be visible in the session details of the Console that initiated the transfer. Another Console monitoring the same managed nodes will not have access to the After transfer path.
Note: Re-running the transfer may generate a "No such file or directory" error since the source files were moved to the archive directory.
You can use archive directory variables in the filepath to define specific archive paths for each drop. Hover over the Archive directory variables link for a list of available variables.
Source deletion Delete the transferred files from the source computer after transfer.

Growing Files

Option Description
Maximum parallel transfers The maximum number of concurrent transfers of growing files watchfolder can initiate.
Target rate The target transfer rate.
Bandwidth policy The bandwidth policy.
Transport encryption Select aes-128 to transfer with this encryption method.
TCP port The TCP port to use for this watchfolder.
fasp™ port (UDP) The UDP port to use for this watchfolder.
Completion timeout The amount of time to wait for the file to no longer change for the session to finish.
Memory

The maximum amount of memory that the faspstream binary is allowed to use.

Chunk size The size of data to pack before sending over the network.
Growing file filters Click the button to add a new filter to identify growing files. You can set a filter to include or exclude files by globbing or by regular expression.

Packages / Drops

Option Description
Package timeout A package in watchfolder defines a set of files with dependencies. The package timeout defines the time in which watchfolder waits for required files. If the required files do not appear within the duration, files with dependencies are marked as not transferred because of unsatisfied dependencies.
Final transfer Defines which file has to be transferred last.
  • Last file in list: The last file in the package list is transferred last.
  • File list: The files are transferred without any specific order.
File list filters Click the button to add a new filter to identify file lists. You can set a filter to include or exclude files by globbing or by regular expression.