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 Default Example
Maximum parallel transfers The maximum number of concurrent transfers of growing files watchfolder can initiate. 8 4
Target rate The target transfer rate. 10000 10000
Bandwidth policy The bandwidth policy used for prioritizing growing file transfers. fair high
Transport encryption Transfer with an encryption method. none aes128
TCP port TCP port to use for this Watch Folder. If different, Console connects to the target node using this port instead. 22 22
fasp™ port (UDP) UDP port to use for this Watch Folder. If different, Console connects to the target node using this port instead. 33001 33001
Completion timeout Duration in seconds of inactivity after which Console considers the growing file transfer to be complete. 10 15
Memory

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

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

Packages / Drops

Option Description Default Example
Package timeout The duration in seconds for which the Watch Folder waits for files defined in the file list. If the required files do not appear within the duration, files with dependencies are not transferred because of unsatisfied dependencies. 10 30
Final transfer Defines which file is transferred last.
  • Last file in list: The last file in the package list is transferred last.
  • File list: The file list is transferred last, but the other files are transferred without any specific order.
 Last file in list Last file in list
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.  

Glob
Include*.package