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

TFTP Tests

The TFTP test monitors the amount of time required to read or write a file using the TFTP protocol.

Options and Arguments

TFTP tests require the following specific options and arguments:

• TFTP Server. The hostname of the TFTP server that you are testing. Some TFTP servers may require that you create a writable seed file (stub file) in the TFTP root directory before you perform the Write test. A stub file is a file with the same name as the file being written by the TFTP test. If the stub file is not writable, the test will fail.

  Note: 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.

  Note: The agent must have access to the file being written to the TFTP server, either locally or mounted.

• TFTP Port. (Optional) The port on which the TFTP service is running. The default is 69.
• Operation. The type of operation to perform; one of the following:
  • Read File – Reads (attempts to download) a file from the server.
  • Write File – Writes a file to a remote file system. Output from TFTP Write tests go to the TFTP root directory. This is a directory configured either before or after installation (of the TFTP server) on Windows. For UNIX systems, it may appear in the system startup configuration file (such as \etc\inetd.conf on Solaris).
• Filename. A complete path and file name for the file to write. In the case of a read operation, you must supply either a complete path or just a file name -- it depends on the requirements of TFTP server you are contacting. You must specify the file or path name on the TFTP server in a manner consistent with the particular server. In most cases, the path is relative to the root of the TFTP directory.

  Note: When you are specifying pathnames, be sure to use the correct type of slashes for the operating system on which the test will run. That is, use forward slashes (/) when you specify directories for tests that you intend to run on UNIX systems and backslashes (\) when you specify directories for tests that you intend to run on Windows systems.

Specify these options and arguments when you create or modify tests.

Example 1: Reading a File with TFTP

Use this example to create a test that monitors the amount of time required to read a file through the TFTP service at tftpserver.yourdomain. This example tests the server once every 30 seconds and waits up to 10 seconds for a successful response. It calculates response time and availability statistics over the last 120 seconds (2 minutes).

To create a new test in a policy

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

   The New test pane appears.

2. From the Test Type list, select TFTP.
3. In the Description field, specify tftpserver_read.
4. In the Test Name field, specify TFTP Reading File Test.
5. In the Test Interval field, specify 30.
6. In the Test Timeout field, specify 10.
7. In the Samples Per Interval field, specify 1.
8. In the Statistics Window field, specify 120.
9. In the TFTP Server field, specify tftpserver.yourdomain.
10. In the TFTP Port field, accept the default of 69.
11. In the Operation field, select Read File.
12. In the Filename field, specify I:\SA\TFTP\get.txt.
13. Accept defaults for all other fields.
14. Click Save Test.

When you perform a commit/sync of the test, SRM adds an entry similar to the following to the svcrsp.cf file:

{ 
index=11 
type=tftp
desc="tftpserver.read" 
dest="tftpserver@yourdomain.com:69" 
args="op=r&path=I:\SA\TFTP\get.txt" 
interval=30 
samples=1 
timeout=10 
window=120 
tos=0 
limit=0 
status=active 
name="TFTP Reading File Test"
class=""
context=""
flags="1"
loglevel=1
}

Example 2: Writing a File with TFTP

Use this example to create a test that monitors the amount of time required to write a file through the TFTP service at tftpserver.yourdomain. This example tests the server once every 30 seconds and waits up to 10 seconds for a successful response. It calculates response time and availability statistics over the last 120 seconds (2 minutes).

To create a new test in a policy

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

   The New test pane appears.

2. From the Test Type list, select TFTP.
3. In the Description field, specify tftpserver_write.
4. In the Test Name field, specify TFTP Writing File Test.
5. In the Test Interval field, specify 30.
6. In the Test Timeout field, specify 10.
7. In the Samples Per Interval field, specify 1.
8. In the Statistics Window field, specify 120.
9. In the TFTP Server field, specify tftpserver.yourdomain.
10. In the TFTP Port field, accept the default of 69.
11. In the Operation field, select Write File.
12. In the Filename field, specify I:\SA\TFTP\put.txt.
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=22 
type=tftp
desc="tftpserver_write" 
dest="tftpserver.yourdomain.com:69" 
args="op=w&path=I:\SA\TFTP\put.txt" 
interval=30 
samples=1 
timeout=10 
window=120 
tos=0 
status=active 
name="TFTP Writing File Test"
class=""
context=""
flags="1"
loglevel=1
}

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