Versions Compared

Version Old Version 3 New Version 4
Changes made by

Former user

Kevin Wu

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


ItemDescription

Server Information Provider

The standard behavior is Single Server. If your system is installed with the Multi Server File functionality, you can configure the FTPS agent to collect from more than one server. For further information, contact your System Administrator. 

Host

Primary host name or IP address of the remote host to be connected. If a connection cannot be established to this host, the Additional Hosts specified in the Advanced tab, are tried.

Username

Username for an account on the remote host, enabling the FTPS session to login.

Password

Password related to the Username.

Note
titleNote!

Due to the limitations of the Apache Commons Library being used by our FTPS agents, we are currently unable to support the use of non-ASCII characters in the password when using our FTPS Collection and FTPS Forwarding agents.


Transfer Type

Data transfer type to be used during file retrieval.

  • Binary - agent uses binary transfer type. Default setting.

  • ASCII - agent uses ASCII transfer type.

Encryption Type

You can select an encryption type:

Implicit - Full encryption of FTP connection from the start of the session
Explicit - Explicitly define any required security/encryption mechanisms 

File System Type

Type of file system on the remote host.

  • Unix - remote host using Unix file system. Default setting.

  • Windows NT - remote host using Windows NT file system.

  • VAX/VMS - remote host using VAX/VMS file system.

Client AuthenticationIf you select this check box, you must enter the keystore file location (JKS format) and password to connect to the  FTPS  Server. The connection fails if the file is invalid or not found, or if the key in the file is not the same as the file stored in the  FTPS  server.
Keystore LocationEnter the keystore file location in JKS format. You must populate this field if you have selected the Client Authentication check box.
Keystore PasswordEnter the keystore password. You must populate this field if you have selected the Client Authentication check box.
Reuse SSL/TTL SessionSelect this check box to reuse the SSL/TTL session.

Enable Collection Retries

Select this check box to enable repetitive attempts to connect and start a file transfer.

When this option is selected, the agent will attempt to connect to the host as many times as is stated in the Max Retries field described below. If the connection fails, a new attempt will be made after the number of seconds entered in the Retry Interval (s) field described below.

Retry Interval (s)

Enter the time interval in seconds, between retries.

If a connection problem occurs, the actual time interval before the first attempt to reconnect will be the time set in the Timeout field in the Advanced tab plus the time set in the Retry Interval (s) field. For the remaining attempts, the actual time interval will be the number seconds entered in this field.

Max Retries

Enter the maximum number of retries to connect.

In case more than one connection attempt has been made, the number of used retries will be reset as soon as a file transfer is completed successfully.

Note
titleNote!

This number does not include the original connection attempt.


Enable RESTART Retries

Select this check box to enable the agent to send a RESTART command if the connection has been broken during a file transfer. The RESTART command contains information about where in the file you want to resume the file transfer.

Before selecting this option, ensure that the FTPS server supports the RESTART command.

When this option is selected, the agent will attempt to re-establish the connection, and resume the file transfer from the point in the file stated in the RESTART command, as many times as is entered in the Max Retries field described below. When a connection has been re-established, a RESTART command will be sent after the number of seconds entered in the Retry Interval (s) field described below.

Note
titleNote!

The RESTART Retries settings will not work if you have selected to decompress the files in the Source tab, see the section below, Source Tab.


Note
titleNote!

RESTART is not always supported for transfer type ASCII.


For further information about the RESTART command, see http://www.w3.org/Protocols/rfc959/.

Retry RESTARTS Interval (s)

Enter the time interval, in seconds, you want to wait before initiating a restart in this field. This time interval will be applied for all restart retries.

If a connection problem occurs, the actual time interval before the first attempt to send a RESTART command will be the time set in the Timeout field in the Advanced tab plus the time set in the Retry Interval (s) field. For the remaining attempts, the actual time interval will be the number seconds entered in this field.

Max RESTARTS

Enter the maximum number of restarts per file you want to allow.

In case more than one attempt to send the RESTART command has been made, the number of used retries will be reset as soon as a file transfer is completed successfully.


...