THE INFORMATION IN THIS ARTICLE APPLIES TO:
- EFT Server (All Versions)
DISCUSSION
When EFT Server’s Download and Copy/Move action offloads or downloads files to/from other servers, the session is recorded to a log file: cl[yymmdd].log, e.g., cl060312.log.
The log file is formatted as: Time; Protocol; Host Name; Port; User Name; Local Path; Remote Path; Operation; GetLastCode
For example:
2006-03-06 10:11:03; ftp; 192.168.20.171; 21; ClientA; C:\test1.txt; /test1.txt; download; 226;
(In
v6.4 and later) A tenth column can be added to
the CL log by defining a registry entry. The tenth column indicates
status of the Event, Success (0) or Failure (1). To enable the
tenth column, create the DWORD Enable10ColumnInClientLog
at the following path:
32-bit: HKEY_LOCAL_MACHINE\SOFTWARE\GlobalSCAPE
Inc.\EFT Server 4.0
64-bit: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\GlobalSCAPE
Inc.\EFT Server 4.0
Value:
- 0 or not present = disabled
- 1 = enabled
With the tenth column enabled, the CL log columns
are:
TIME; PROT: HOST:PORT; USER; LOCAL_PATH; REMOTE_PATH;
OPERATION; LAST_RESULT_CODE; ACTION_RESULT
If ACTION_RESULT = 0, any "if action FAILED"
Actions in the Rule are skipped.
|
The log can be used for trouble-shooting connection and transfer errors. The "GetLastCode" value returns the protocol success or error code or socket error. For example, trying to connect to an non-existent website will result in the socket error code 10060, connection timeout. See a Microsoft Library article for a complete list of common socket error codes. Aside from the standard socket error codes (1nnnn), EFT Server defines a few of its own:
- 0 - Success (connected ok)
- 1 - General socks failure
- 2 - Socket connection not allowed by ruleset
- 3 - The network is unreachable
- 4 - The host is unreachable
- 5 - The remote server actively refused the connection
- 6 - The Time To Live (TTL) expired. This could indicate a network problem.
- 7 - The command was not supported by the remote host. Also a catch all error code.
- 8 - The address type or format is not supported
- 10 - Illegal socks name
- 11 - Socks5 authentication failure (username/password incorrect)
- 12 - Can't connect to socks server
- 2000 - Internal timeout error code (multiple reasons, such as firewall blocking connection, etc.)
FTP and FTP over SSL only return protocol-level success and error codes. For example, a successful transfer would return 226 or a bad login password would return 530. Refer to RFC 959 for a complete list of FTP/S return codes.
SFTP (SSH2) returns the following success and error codes:
- -1 - Undefined or unknown error (not enough information to determine exactly why it failed)
- 0 - The operation completed successfully
- 1 - The operation failed because of trying to read at end of file
- 2 - The requested file does not exist
- 3 - Insufficient privileges to perform the operation
- 4 - The requested operation failed for some other reason
- 5 - A badly formatted message was received. This indicates an error or incompatibility in the protocol implementation
- 6 - Connection has not been established (yet) and a timeout occurred
- 7 - Connection to the server was lost, and the operation could not be performed
- 8 - A timeout occurred