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.