Log Files

Gateway Administrator and Transfer Server Logs

Log files for the FileXpress Gateway Administrator and the FileXpress Transfer Server are created in the logs folders:

<install path>\GatewayAdministrator\logs

<install path>\TransferServer\logs


Note: By default, the server log files and debug log files (when debug logging is enabled) roll over daily and are deleted after three days. This helps ensure that disk space is not used up by large, accumulating log files. If you alter the configuration to keep these files for a longer period, you should monitor the files and/or move them to another server to ensure that sufficient disk space is always available.

The following log files are available for both FileXpress Gateway Administrator and the FileXpress Transfer Server:


This is the primary troubleshooting log. By default, console logs roll over daily and include the date in year-month-date format. These files are not deleted.

To modify console log rollover, logging levels, and log deletion, use container.conf.



This file rolls over daily. The file called server.log captures log information for the current day. By default, rolled-over log files include the date in year-month-date format, and logs are deleted after three days. Only the first 15 lines of an exception are shown.



Debug logging is not enabled by default and is rarely needed. A debug.log file is created in the logs folder, but remains empty unless you enable debug logging.

To enable debug logging, edit logback.xml. The lines to edit and for instructions for making the change are under LOG SET-UP.


The following additional log is available for the Gateway Administrator:



The directory log contains logging related to the built-in FileXpress LDAP directory transactions.

To modify the directory log settings, use logback.xml.


Additional instructions for customizing logging are included in the logback.xml and container.conf files. You need to restart the server after editing these files. These files are located in the conf folder:

<install path>\GatewayAdministrator\conf

<install path>\TransferServer\conf

Note: Edits you make to logback.xml and container.conf need to be repeated each time you apply a hotfix or upgrade FileXpress Gateway.

FileXpress Secure Shell Proxy Logs

The FileXpress Secure Shell Proxy supports two methods of logging: to the Windows Event Viewer and/or to a text log file. To configure logging, use the FileXpress Secure Shell Proxy console (Attachmate FileXpress Gateway > FileXpress Secure Shell Proxy).

Windows Event Viewer

Logging to the Event Viewer is enabled by default.

To view the Event Viewer log from the FileXpress Secure Shell Proxy console, click the toolbar button, or go to View > Event Viewer.

To modify the Event Viewer log level, go to Configuration > Logging > Event logging.


Text file logs

Logging to text files is not enabled by default.

To enable logging to a text file, set the log level, specify a log file directory, and configure rollover, go to Configuration > Logging > Debug logging.

To view the log file from the FileXpress Secure Shell Proxy console, click the toolbar button, or go to View > Latest Debug Log File.