FTP Monitors

AlertSite can help you verify that your FTP server is available. AlertSite monitors can test the FTP server connection and optionally test user authentication and file upload/download.

In This Topic

Supported FTP Features

AlertSite FTP monitors support the following:

You might need to configure your firewall to allow connections from the IP addresses of AlertSite monitoring locations.

The following are not supported:

How FTP Monitors Work

1. Standard handshake

  1. Connect to the specified FTP server and port (default ports are 21 for FTP and 990 for FTPS).
  2. Receive Response 220 (Service ready for new user).

2. (Optional) Log in

If the user name and password are specified:

  1. Send the user name via the USER command.
  2. Receive Response 231 (User name is OK, password needed).
  3. Send the password by using the PASS command.
  4. Receive Response 230 (User is logged in, proceed).

3. (Optional) Change working directory

If the URL contains a directory name, such as ftp.example.com/path/subpath:

  1. Change the working directory using the CWD command.
  2. Receive Response 250 (Requested file action okay, completed).

4. (Optional) Test file upload and download

If the Attempt to upload a file option is selected and both the user name and password are provided, the monitor uploads and downloads a small file:

  1. Generate a small test file.
  2. Upload the file to the server by using the STOR command.
  3. Download the file by using the RETR command.
  4. Compare the uploaded and downloaded files.
  5. Delete the uploaded file from the server by using the DELE command.
  6. Close the session with the QUIT command.

Creating an FTP Monitor

Currently, FTP monitors can be created only in AlertSite 1.0 (classic interface). However, you can view and edit existing FTP monitors in both AlertSite 1.0 and AlertSite UXM.

To create an FTP monitor:

  1. In AlertSite UXM, select Settings > AlertSite 1.0 from the top menu to switch to the classic interface.
  2. Navigate to Configure > Sites and click Add a new site.

    Add a new site

    This will open the monitor configuration screen.

  3. Specify the basic settings:
  4. Click Submit in the top right corner. AlertSite will create the monitor and display additional settings.
  5. (Optional.) To test file upload and download, select Upload/Download Test File. This option requires Userid and Password.
  6. Click Locations in the top right and select the locations the monitor will run from. The default locations for all new monitors can be configured in your account settings.
  7. Configure other settings as needed. See FTP Monitor Settings for a description of applicable settings.

    Note: Not all of the settings displayed in AlertSite 1.0 apply to FTP monitors.

  8. Once you are happy with the configuration, click Test on Demand to test your monitor. The results will be displayed on the screen. If there are errors, review the monitor settings. See Common Error Statuses below for some tips.

Your monitor is ready and will test the connection to your FTP server at the configured intervals. You will see the first results on AlertSite dashboards in a few minutes.


Common Error Statuses

Monitor status 0 indicates a successful test, and any other statuses are errors. The following table lists common error statuses for FTP monitors. For a complete list, see AlertSite Status Codes.

Status Description
1 - TCP connection failed Possible reasons:
  • Your FTP server uses an unsupported mode. See Supported FTP Features.
  • Wrong port number is specified for a non-secure FTP server.
2 - Test timed out Possible reasons:
  • There was no response from your FTP server within the timeout configured for the monitor. This usually indicates that your system is very busy and experiencing a slowdown. If things look normal, you will need to increase the monitor timeout.
  • Wrong port is specified for an FTPS server.
  • Your server uses explicit FTPS, which we do not support.
3 - Invalid response from server Possible reasons:
  • Access denied. Your FTP server requires authentication, but the Userid and Password are missing or incorrect.
  • The Upload/Download Test File option is used with a read-only user or read-only server.
  • Bad response to one of the FTP commands used issued by the monitor. Please contact SmartBear Support to troubleshoot the issue.
5 - Keyword verification error When using the Upload/Download Test File option, this status indicates that the downloaded file does not match the uploaded file.
6 - No response from server Possible reasons:
  • Your server uses an unsupported mode, such as SFTP. See Supported FTP Features.
  • Monitor configuration is invalid. For example, your server is FTPS but the monitor type is set to FTP Server instead of FTP over SSL (FTPS)
51 - Unable to resolve IP address We could not resolve your domain name to an IP address. Double-check whether the domain name is correct.

Viewing FTP Diagnostic Log

When troubleshooting monitor errors, use the diagnostic log to view the debug messages from the monitor. The diagnostic log is only available for regular monitor runs and not for tests on demand.

To view the log:

  1. In AlertSite UXM, go to Monitors > Summary and select your monitor.
  2. On the Availability History chart, click a time period. This opens a scatter plot where each dot corresponds to a monitor run.
  3. Click a dot, then click View Detail Report.
  4. In the report, click the icon in the table.

The log contains all FTP commands sent to your server and the response to these commands. You can see the command that failed and the exact error message, such as Access denied.

FTP monitor - diagnostic log

What’s Next

See Also

© 2017 SmartBear Software. All rights reserved.      Terms of Use · Privacy Policy