Creating a Push Watch Folder with ATS Node Destination

Create a local-to-remote (push) Watch Folder with an Aspera Transfer Service (ATS) node as the destination node. If Watch Folder detects new files in the source directory, it transfers those files to a directory on ATS node.

Important: Using Watch Folders with an ATS node requires that both source and destination nodes run IBM Aspera High-Speed Transfer Server version 3.8 and later.

To use Watch Folders, you must enable the feature (Configuration > Defaults and select Enable Watchfolder management) and add Watch Folder-enabled nodes to Console as managed nodes. For instructions on enabling Watch Folders on a node, see IBM Aspera High-Speed Transfer Server Admin Guide: Watch Folders and the Aspera Watch Service.

  1. Go to Activity > Watchfolders and click Create New Watchfolder.
  2. Enter a name for your watch folder in the Name field.
  3. Select Push for the Watch Folder type.
  4. Configure the source node and directory. Files dropped into the source directory are transferred to the destination node and directory.
    1. Select your source node from the drop-down menu. Only Watch Folder-configured nodes appear in the list.
    2. Select the source directory.
      You can Browse and select the source directory, or manually enter the source path.
      Important: The path is relative to the associated system user's docroot. For example, if you enter project1/final and the user's docroot is /aspera/projects, the source path is /aspera/projects/project1/final.
  5. Enter Node API authentication credentials for the ATS node in the Target pane.
    1. Enter the IP address or hostname of the target node.
    2. Enter the Node API username in the Login field.
    3. Choose Node API for the target authentication credential type.
    4. Enter the Node API username in the Login field.
  6. If you want, you can also enter a token string to authenticate the transfers, with the syntax "Basic token_string".
    For instructions on creating an access key on the remote node and generating a token from it, see the IBM Aspera High-Speed Transfer Server Admin Guide: Access Key Authentication.
  7. If you want to specify an Aspera forward proxy for the Watch Folder, enter the proxy address in the following format:
    dnat://login:password@address:port

    For more information on forward proxies, see the IBM Aspera Proxy Admin Guide.

  8. Set ports for the Node API:
    • Node API: 443
    • UDP: 33001
  9. Select the destination directory.
    You can Browse and select the destination directory, or manually enter the destination path.
    Important: Just like for the source path, the destination path is relative to the associated system user's docroot.
  10. Configure additional watchfolder settings. See Watchfolder Options.
  11. Click Create.
  12. Test your watch folder.

    Add files to the source directory. Watch Folder detects the new files and transfers the new files to the target directory. You can see the transfer on the Activity Overview page.