Locate (Contains) :
Eco Time FTP Manager
Overview

FTP (File Transfer Protocol) is one of the oldest and most widely used protocols on the internet. It is designed to transfer files between an FTP client and an FTP server.

The Eco Time FTP Manager includes a built-in FTP client that allows Eco Time to automatically upload, download, and synchronise files and directories with an FTP server. It is typically used for system integrations, automated data exchanges, and scheduled file transfers.

How FTP Works

FTP differs from most modern network protocols because it uses two separate connections between the client and the server:

  1. Control Connection
    Used for commands and responses (login, directory listing requests, file commands, etc.).
  2. Data Connection
    Created only when data needs to be transferred. The actual file or directory content is transmitted over this connection.
  3. Originally, the FTP server initiated the data connection back to the client. While this worked in the early days of the internet, it requires special firewall and network configuration and is now considered a security risk. As security standards evolved, this approach became impractical.
Passive Mode FTP

To address these security concerns, Passive Mode FTP was introduced.

In passive mode:

  1. The client initiates both the control and data connections
  2. This significantly improves compatibility with firewalls and modern network security policies
  3. Passive mode is now the industry standard and is required by most FTP servers
  4. Eco Time FTP Manager supports passive mode, and it is enabled by default.
Secure FTP Protocols

As security requirements increased, FTP was extended to support encrypted connections.

Eco Time FTP Manager supports the following secure FTP options:

  1. Secure FTP (FTPS)
  2. FTP over TLS
  3. Explicit SSL (FTP-ES)
  4. Implicit SSL
  5. Implicit SSL (Control only)
  6. No SSL (not recommended)
Eco Time FTP Manager Features

Eco Time FTP Manager is configurable to perform the following automated actions:

  1. Download a single file from an FTP server
  2. Upload a single file to an FTP server
  3. Download an entire directory from an FTP server
  4. Upload an entire directory to an FTP server
  5. Execute transfers at configurable time intervals
  6. Run interactively or as a Windows service
User Interface Overview

The Eco Time FTP Manager consists of five tabs, each serving a specific purpose:

  1. Options
  2. FTP Server Settings
  3. FTP Manager Settings
  4. FTP Manager Log
  5. FTP Log
  6. Services
Options

The Options tab allows manual execution of FTP operations, including:

  1. Get file from FTP server
  2. Send file to FTP server
  3. Download a directory from the FTP server
  4. Upload a directory to the FTP server

To manually execute an operation:

  1. Select the desired option
  2. Click the Select button
  3. If Display Progress is enabled, real-time progress will be shown

This tab is typically used for testing and validation before enabling automated or service-based execution.

FTP Server Settings

The FTP Server Settings tab defines the connection details for the FTP server.

Configuration Fields

  1. FTP Server Host IP - A domain name or IP address of the FTP server
  2. FTP Port - The port used for FTP communication (Refer to Appendix A – FTP Ports for details)
  3. FTP User Login - Username for FTP authentication
  4. FTP User Password - Password for FTP authentication
  5. Passive Mode - Enables or disables passive mode (Recommended and required for most modern servers)
  6. FTP SSL Mode - Available options:
    1. No SSL (not recommended)
    2. Implicit SSL (Control)
    3. Implicit SSL
    4. Explicit SSL
    5. Secure FTP
  7. Transfer Mode
    1. Binary
    2. Non-binary (ASCII)
    3. Binary mode is recommended for most file types.
FTP Manager Settings

The FTP Manager Settings tab controls directory locations and scheduling.

Remote File Name (on FTP Server)
  1. This option is only used in the case of single file upload or download transfer option.
  2. Remote File Name sets the file name which will be placed on the FTP server
  3. Note When the file is places in a subdirectory on the FTP Server, the forward slash "/" structure is used. Do not place a forward slash "/" at the start of the file name
Remote Directories (on FTP Server)
  1. FTP Remote Inbox Directory Example: /inbox
  2. FTP Remote Outbox Directory - Example: /outbox
Local Directories (on Eco Time Server)
  1. FTP Local Inbox Directory
  2. Recommended name: FTP Inbox
  3. This directory is automatically created when Eco Time FTP Manager runs.
  1. FTP Local Outbox Directory
  2. Recommended name: FTP Outboxbox
  3. Automatically created when Eco Time FTP Manager runs.
Local File Name (on Eco Time Server)
  1. This option is only used in the case of single file upload or download transfer option.
  2. Local File Name sets the file name which will be transferred to the FTP server
  3. Note The local outbox directory path is appended to the local file name on transfer, which means the file needs to be placed in the local outbox directory or a subdirectory thereof. Do not place a back slash "\" at the start of the file name
Scheduling Options
  1. FTP Download Interval - Interval (in minutes) to check for files or directories available for download
  2. FTP Upload Interval - Interval (in minutes) to check for files in the local outbox that must be uploaded
  3. Enable / Disable Options
    1. Enable File Upload
    2. Enable File Download
    3. Enable Directory Upload
    4. Enable Directory Download
  4. These options should be configured based on the specific integration requirements.
FTP Manager Log

The Log displays detailed runtime information, including:

  1. File and directory checks
  2. Connection status
  3. Login success or failure
  4. Data transfer progress
  5. Error messages
  6. The log is essential for troubleshooting and debugging.

⚠️ Note: For full visibility, Eco Time FTP Manager should be run as a process, not as a service, when reviewing logs interactively.

FTP Log

The Log displays detailed runtime information, including:

  1. FTP client raw transfer information
  2. FTP client raw transfer progress
  3. Additional FTP batch process raw information
  4. Error messages
  5. The log is essential for troubleshooting and debugging
  6. The log is cleared and refershed on every transfer batch process
Services Tab

The Services tab allows Eco Time FTP Manager to be:

  1. Installed as a Windows service
  2. Removed as a Windows service
  3. Started and stopped as a service
  4. Run automatically in the background without user interaction

This mode is recommended for production environments where unattended operation is required.

Appendix A – Default FTP Ports

This appendix describes the default network ports used by the various FTP and SFTP protocols. Understanding these ports is important when configuring firewalls, routers, and the Eco Time FTP Manager.

FTP (Unsecured)
  1. FTP (File Transfer Protocol) without encryption.
  2. Control Port: 21
  3. Data Ports:
    1. Active mode: initiated by the server (dynamic)
    2. Passive mode: assigned by the server (configurable range)

⚠️ Note: Unsecured FTP is not recommended because usernames, passwords, and data are transmitted without encryption.

FTP-ES (Explicit FTP over TLS)
  1. FTP-ES uses TLS encryption that is explicitly initiated after the FTP session is established.
  2. Control Port: 21
  3. Data Ports:
    1. Passive mode: server-defined range

✔️ This is the most commonly used and recommended secure FTP configuration.

FTP-S (Implicit FTP over TLS)

FTP-S starts TLS encryption immediately when the connection is opened.

  1. Control Port: 990
  2. Data Ports:
    1. Passive mode: typically 989 or a configurable range

⚠️ Note: FTP-S is less flexible than FTP-ES and is no longer enabled by default on some modern FTP servers.

SFTP (SSH File Transfer Protocol)

SFTP is a completely different protocol from FTP and operates over SSH.

  1. Control and Data Port: 22
Summary of Default Ports
Protocol Security Default Port
FTP None 21
FTP-ES (Explicit TLS) TLS 21
FTP-S (Implicit TLS) TLS 990
SFTP (SSH) SSH 22
Firewall and Network Notes
  1. Ensure that passive data ports are allowed through firewalls
  2. For FTP-ES and FTP-S, TLS inspection or deep packet inspection must be correctly configured if enabled
  3. For production environments, FTP-ES in passive mode is strongly recommended
Updated by Robert de Jager on 23 JAN 2026
Locate (Contains) :