Service Response Monitor › Test Management › Create Tests › FTP Tests

FTP Tests

The FTP test monitors the amount of time required to log in and test the specified FTP server.

Options and Arguments

FTP tests require the following specific options and arguments:

• FTP Operation. The type of FTP operation to test. Select either Login-only, Get, or Put. If you select Login-only, specify the name of the FTP Server, a valid port number (default is 21), username and password. This test logs in using the specified username and password and then logs out.

  If you select Get, specify the name of the FTP Server, a valid port number (default is 21), username, password and a Remote File name (the path to the file to be read). This test logs in and reads the specified file (but does not perform a write operation), then logs out.
  If you select Put, specify the name of the FTP Server, a valid port number (default is 21), username, password, and the name of the Local File to be written to the FTP Server. This test logs in and writes the specified file out to the FTP Server, then logs out. If the remote directory does not have writer permission, the test will fail.

• FTP Server. The hostname of the FTP server that you are testing.

  Note: As of Service Availability r2.1 IPv6 addresses can be used, but they must be embedded in brackets, for example [0aff::230:6eff:fe4b:51db]:8080. Here 0aff::230:6eff:fe4b:51db represents the IPv6 address and 8080 represents the port number.

• FTP Port. (Optional) The port on which the FTP service is running if it is running on a port other than 21 (the default).
• User Name. A valid user name for this FTP server.
• Password. The password for the specified user name. SRM stores the password in encrypted form.

  Note: You retype the password in the Verify Password field to verify that you have entered it correctly.

You specify these options and arguments when you create or modify tests.

Example

Use this example to create a test that monitors the amount of time required to log in and test the status of the FTP service at ftpstage.ca.com. This example tests the server once every 3600 seconds (1 hour) and waits up to 10 seconds for a successful response. It calculates response time and availability statistics over the last 604,800 seconds (1 week).

To create a new test in a policy

1. Click + (New) on the Test Monitors toolbar.

   The New test pane appears.

2. In the Test Name field, specify FTP Test.
3. In the Description field, specify ftptest
4. In the Test Interval field, specify 3600.
5. In the Test Timeout field, specify 10.
6. In the Samples Per Interval field, specify 1.
7. In the Statistics Window field, specify 604800.
8. In the FTP Operation field, specify Login-only.
9. In the FTP Server field, specify ftpstage.mydomain.com.
10. Accept the default value in the FTP Port field.
11. In the User Name field, specify ftpuser.
12. In the Password field, specify ftp123.
13. Accept defaults for all other fields.
14. Click Save Test.

When you commit your changes, SRM adds an entry similar to the following to the svcrsp.cf file:

{ 
index=289 
type=ftp
desc="ftptest" 
dest=ftpstage.mydomain.com:21
username="ftpuser" 
encoded=yes 
password="bmh12cy" 
args="op=login" 
interval=3600
samples=1 
timeout=10 
window=604800 
tos=0 
limit=0 
status=active 
name="FTP-Test"
class=""
context=""
flags="1"
loglevel=1
}

For information about errors you may encounter when running FTP tests, see FTP Test Error Codes.