Adding a download folder to a connection

Note: Download folders are only supported for LN environments that run on a Windows platform. On the LN server, Tools version 10.6.0.1 or later is required.

You can use two types of storage for the location of a download folder in the cloud:

  • A location relative to the ${BSE}/appdata folder on the LN server
  • A location relative to a tenant-specific path in an Amazon S3 bucket

In the configuration console, these storage types are displayed as "LN" and "S3" respectively.

To use the "S3" functionality, Tools version 10.7.0.1 is required on the LN server. The ttrpiln-transfer-service.javaapp Java application must be deployed on the LN server. If required, use the Deploy Java Applications (ttadv2570m300) LN session to deploy the latest version of this application.

  1. This step is only applicable for the "LN" storage type. On the LN server, create a folder to be used as “source folder” for the download. Create this folder as a subfolder of ${BSE}/appdata.
    The service downloads all files from this source folder and its subfolders, and places them in a matching folder structure on a local system. After downloading the files, they are removed from the source folder.
  2. This step is only applicable for the "LN" storage type. Specify the appropriate folder permissions for the source folder and, if applicable, the archive folder.
    Ensure that the LN account that is used for the connection has read and write access for these folders.
  3. On the local system, create a folder to be used as target folder for the download.
    Create this folder on the file system of the system that runs the LN Transfer Service or on a share in the local network.
    Ensure that the permissions on the folder allow read and write access to the account that runs the service.
  4. In the configuration console, select the connection node in the tree and click Add Download Folder.
    1. Specify a name for the download folder. This name is displayed in the tree. It does not have to match the actual folder name on the LN server or the local system.
    2. Click OK.
  5. After the download folder is added, it is displayed in the tree as a child node of the connection. Select the download folder node to open the Download Folder view.
  6. Specify this information:
    Enabled
    If this check box is selected, the download folder is processed by the service, if the connection itself is also enabled.
    If this check box is cleared, the download folder is not processed.
    Storage Type
    Specify the desired type of storage by selecting one of these options:
    • LN

      The source path is relative to the ${BSE}/appdata folder in LN.

    • S3

      The source path is relative to the tenant-specific data area in the S3 bucket.

    Note: The "LN" storage type can only be used for files smaller than 10 MB.
    Remote Source
    Specify the folder from which the files must be downloaded:
    • For the "LN" storage type, this is a path on the LN server, relative to ${BSE}/appdata. The path consists of folder names, separated by "/" characters. For example, if you specify lndata/download, the ${BSE}/appdata/lndata/download folder is defined as source folder.
    • For the "S3" storage type, this is a folder path relative to a tenant-specific area in Amazon S3.
      • If the path starts with “AWS_S3_admin/”, the path is defined in the temporary AWS S3 bucket.
      • If the path starts with “AWS_S3/”, the path is defined in the AWS S3 bucket for app data.

    “AWS_S3_admin/” or “AWS_S3/” must be followed by one or more folder names, separated by “/“ characters. The AWS S3 bucket for app data is the default; a path that does not start with “AWS_S3_admin/” or “AWS_S3/” is equivalent to a path that starts with “AWS_S3/”.

    Archive files after transfer
    If this check box is selected, the files from the source folder are relocated to the archive folder after a successful download by the service.
    If this check box is cleared, the files from the source folder are deleted after a successful download by the service.
    Remote Archive
    Specify the folder where the processed files must be placed. The path consists of folder names, separated by "/" characters.
    On-premises LN server:
    • For the "LN" storage type, this is a path on the LN server, relative to ${BSE}/appdata.

      For example, if you specify lndata/archive, the ${BSE}/appdata/lndata/archive folder is defined as archive folder.

    • For the "S3" storage type, this is a folder path relative to the tenant-specific data area in the S3 bucket. Do not specify a subfolder of the Remote Source here.
    LN cloud
    Regardless of the selected “LN” or “S3” storage type, this is a folder path relative to the tenant-specific data area in the S3 bucket. Do not specify a subfolder of the Remote Source here.
    Local Target
    Specify the folder where the downloaded files are placed. This is a folder on a local system. For example:
    • If you specify C:\data\lndata\download, the C:\data\lndata\download folder on the local machine that runs the service is used as target folder for downloaded files.
    • If you specify \\server\share\download, the download folder on the \\server\share network share is used as target folder.

    Optionally, click Browse to browse to a folder instead of manually typing the path.

    Overwrite existing files
    If this check box is selected, new download files overwrite old download files with the same name.
    If this check box is cleared, new download files do not overwrite old download files with the same name; instead, new files are renamed so that both old and new files can exist in the same folder.
    File Name Filter
    If this check box is selected, file name filtering is applied to the files in the source folder. Only files that match the pattern are downloaded.
    If this check box is cleared, all files in the source folder are downloaded. The filter is applied to the file name only; the folder path of the file is not filtered.

    See File name filtering.

    Pattern
    The pattern expression. This is either a "wildcard expression" or a "regular expression". For example:
    • You specify this wildcard expression: *.pdf

      The abc.pdf and 123.pdf files are downloaded. The abc.dat and 123.txt files are not downloaded.

    • You specify this regular expression: .+\.(pdf|txt)$

      The abc.pdf and 123.txt files are downloaded. The abc.dat and 123.txt.tmp files are not downloaded.

    Regular expression
    If this check box is selected, the specified pattern is interpreted as a regular expression.
    If this check box is cleared, the specified pattern is interpreted as a wildcard expression.
    Case sensitive
    If this check box is selected, the pattern is interpreted as case-sensitive.
    If this check box is cleared, the specified pattern is interpreted as case-insensitive.
    For example:
    • A case-sensitive wildcard pattern a*.txt accepts file name all.txt, but does not accept ALL.txt.
    • A case-insensitive wildcard pattern a*.txt accepts both all.txt and ALL.txt.
  7. Optionally, test the status of the folders, to ensure you specified the correct paths for the folders.
  8. Click Save.