Download (Pull) File from Host Action

(Available in EFT Server Enterprise) You can configure a Server Event Rule to copy or download from a specific location to a specified local folder using a particular protocol when an Event occurs. You must provide EFT Server with connection information (protocol and login details) and file information (source path and destination path). (Also refer to Copy/Move (push) File to Host Action.)

icon_info.gif

The Download Action is available with all Events except Site Stopped and Service Stopped.

To set up EFT Server to download files

  1. Follow the procedure in Creating Event Rules or select the Rule to which you want to add the Action.

  2. In the Actions list, click Download (pull) file from host. The Rule parameters are added to the Rule in the Rule pane.

  3. Click one of the undefined parameters where the parameters are listed in the Rule pane. The Download Action wizard appears.

    wiz_downloadaction_filedownloadconfiguration64.png

  4. Click the list to specify a Download method for the connection: Local (Local File or LAN), FTP (standard File Transfer Protocol), FTP SSL/TLS (AUTH TLS), FTP with SSL (Explicit encryption), FTP with SSL (Implicit encryption), SFTP using SSH2 (Secure Shell), HTTP (HyperText Transfer Protocol), HTTPS (Secure HTTP access).

  5. If you selected Local (Local Files or LAN), provide the Windows account username and Password.

  6. If you chose anything but Local do the following; otherwise, skip to the Source File page step.

    1. In the Host address box, type the IP or host address of the EFT Server to which you want to connect.

    2. The Port number for the selected protocol changes automatically based on the offload method. Provide a different port number, if necessary.

    3. In the Username and Password boxes, type the username and password used to authenticate.

  7. Select the Use connected client's login credentials to authenticate check box if you want to use the local system account to authenticate. The availability of this check box is controlled by the Persist username and password credentials for use in Event Rule context variables check box on the Site's Security tab.

  8. If you chose SFTP, provide the client SFTP certificate information.

  9. If you chose a protocol that uses SSL (FTPS or HTTPS), provide the client SSL certificate information.

  10. If you connect to EFT Server through a proxy server, click Proxy. The Proxy Settings dialog box appears.

    db_proxysettings_62.gif

    1. Specify the Proxy type, Host name, Port, Username, and Password.

      icon_info.gif

      Using the DMZ Gateway as proxy is available only in the Enterprise edition of EFT Server. For security best practices, selecting PORT mode in the Advanced Options dialog box below is not allowed when brokering outbound connections through DMZ Gateway.

    2. To specify an Authentication Type and login sequence, click Advanced. You must select FTP Proxy or HTTP Proxy to specify advanced settings.

      db_advancedproxysettings.gif

    3. Specify one of the following Authentication Types:

      • USER user@site if your proxy server requires the USER command followed by your user name and the Site name to allow connection with a remote Site. You can change the @ symbol if a different separator is required by your proxy server.

      • SITE site if your proxy server requires the SITE command followed by the address of the remote FTP site to allow a connection.

      • USER with logon if your proxy server requires the USER command followed by a user name and password to allow connection with a remote Site.

      • USER/PASS/ACCT if your proxy server requires all three commands before allowing a connection to a remote Site.

      • OPEN site if your proxy server requires the OPEN command followed by the Site name before allowing connection to the Site.

      • Custom if your proxy server requires a login sequence different from those above. Refer to To create a custom authentication method for a proxy server below for details of creating a login sequence.

      • To create a custom authentication method for a proxy server

        1. In the Advanced Proxy Settings dialog box, click Custom, then specify the login sequence in the text box using the following variables: %host%, % user%, %pass%, %port%, %fire_pass%, %fire_user%. Be sure to type each variable with percent signs before and after, and press ENTER to separate commands.

        2. Type any other commands and variables, separating commands with a line break (press ENTER).

        3. Click OK to accept the changes and close the Advanced Proxy Settings dialog box.

        icon_info.gif

        Contact your system administrator for the proper Host name, Port, User name, Password, and proxy type, as well as any required advanced authentication methods.

  11. Click OK to accept the changes and close the Advanced Proxy Settings dialog box.

  12. If you connect to EFT Server through a Socks server, click SOCKS.

    db_sockssettings2.gif

    1. Specify the Socks Type (SOCKS4 or SOCKS5).

    2. Specify the Host name and Port.

    3. If you specified SOCKS5 and the server requires authentication, select the Use Authentication check box, then provide a Username and Password.

    4. Click OK to save the changes and close the SOCKS Settings dialog box.

  13. To configure advanced transfer options, in the Download Action wizard, click Advanced. The Advanced Options dialog box appears.

    db_advancedoptions64.png

    1. In the General transfer options area, you can provide more control over Max concurrent transfer threads, Connection timeout, Connection retry attempts, and Delay between retries. When files are being transferred with Event Rules (copy/move), if there are connection problems (e.g., the network is unavailable), the Server will attempt to establish a connection the number of times specified in Connection retry attempts. When EFT Server is able to re-establish the connection, it continues to transfer the file even if there are multiple interruptions.

    2. Select the Validate file integrity after transfer check box to specify that EFT Server should double check binary files to ensure the files downloaded completely and correctly. (Not applicable to SFTP.)

    3. In the Data port mode box, click the drop-down list and select one of the following (not applicable to SFTP):

      • Auto—When Auto is selected, EFT Server initially makes connections in PASV mode. If the PASV connection fails, EFT Server attempts to connect in PORT mode automatically.

      • Port—When Port mode is selected, EFT Server opens an additional port and tells the remote server to connect to <IP:PORT_RANGE> to establish a data connection. This is useful when the server is behind a firewall that closes all unnecessary ports. If you select this mode, specify the port range from which the client will choose.

      • Pasv—When Pasv mode is selected, EFT Server tells the remote server to provide <IP:PORT> to which EFT Server can connect to establish a data connection. This is useful when a client is behind a firewall that closes all unnecessary ports. Helps avoid conflicts with security systems

    1. Select the Clear command channel check box to send FTP commands in clear text. (Only available when FTPS is specified.)

    2. Select the Clear data channel check box to transfer files without encryption. (Only available when FTPS is specified.)

    3. In the ASCII transfer mode area, specify the file types that can be transferred. TXT, INF, HTML, and HTM are specified by default. If an asterisk (*) is specified, all files are downloaded in ASCII mode, even if that file doesn't have an extension.

    4. In the Time stamps area, select one of the following:

      • Select the Preserve remote time stamp for downloaded files check box to keep the time stamp the same on the destination file as it is on remote file.

      • Select the Preserve the local time stamp for uploaded files if the server allows MDTM check box to keep the time stamp the same on the remote file as it is on the source file. (Not applicable to SFTP.)

    1. Click OK to accept the changes and close the Advanced Options dialog box.

  14. Click Next. The Source File Path page appears.

    wiz_download_sourcefilepath64.png

  15. In the Source path box, provide the path to the file(s) that you want to download. For example, type:
    /pub/usr/jsmith/file.txt or \\mydomain\common\jsmith\file.txt

    icon_info.gif

    If you type a path to a remote folder that does not exist, the Event Rule will fail.

  16. Select the Delete source file after it is downloaded check box if you want to delete the file after it is retrieved. (If the file is marked read-only, it will not be deleted.)

  17. Click Next. The Destination File Folder page appears.

    wiz_downloadaction_destination64.png

  18. In the Destination folder box, click the folder icon  and specify the location in which to save the downloaded file. You can insert variables by double-clicking them in the box below the Destination folder box.

    icon_info.gif

    If you type a path to a remote folder that does not exist, the Event Rule will fail.

  19. Click Finish, then click Apply to save the changes on EFT Server and/or add other Actions and Conditions to the Rule.