Troubleshooting Guide

Table of contents

FTP troubleshooting checklist

  1. Check the FTP client's configuration.
  2. Check for messages.
  3. Check the connection to the host.
  4. Check to see if the problem is security related.
  5. Enable debug on the FTP server and check for errors.
  6. Check to see if the cursor disappears.


  1. Check the FTP client's configuration.
    1. Make sure that the FTP server address and the port number are correctly configured in the session configuration.
    2. Check to make sure you are able to ping the FTP server.
  2. Check for messages.
    1. Check the status bar history for FTP commands and the server replies.
  3. Check the connection to the host.
    1. Check the 3270 and 5250 emulation troubleshooting checklist if the FTP client is not connecting. The connection check steps in that checklist are the same.
    2. Check to see if the SSH (Secure Shell) FTP session fails to start.
    3. If the FTP client fails to connect, try a newer JRE.
    4. When connecting through a firewall, the control connection may break down or the data connection may time out. Refer to the IETF Internet-Draft FTP/TLS Friendly Firewalls at http://www.ietf.org for more information about running secure FTP through firewalls.
  4. Check to see if the problem is security related.
    1. Make sure that the server certificate is imported in the SSL keyring database file. Also, if client authentication is enabled, make sure that the client certificate is properly configured in the session configuration and a valid password is entered when asked.
    2. Check the SSL handshake flow by enabling FTPSession component trace level 2. The flow is traced to the Java Console by the SSL Package.
    3. Check the Security troubleshooting checklist, as most of the steps apply to secure FTP session as well.
  5. Enable debug mode on the FTP server and run the test scenario.
    1. Check the trace data for errors.
  6. Check to see if the cursor disappears.
    1. If the cursor disappears from the user ID field on the FTP login window, click here.

Top of page Table of contents