FTP client scripting interface > FTP tester tool

FTP tester tool

You can use the ftpTester tool to exercise the FTP client outside of Activator. The script to start ftpTester can be found in <install directory>\tools.

ftpTester is a console-based application that can verify the operation of the FTP client in Activator and a partner’s FTP server. Activator server does not have to be running to use this tool. You can use it on UNIX or Windows.

ftpTester duplicates the way Activator accesses an FTP server. It is a test program to verify interoperability with FTP servers. If you can send, list, receive and delete files on a FTP server using ftpTester, this is a good indication Activator can interoperate with the server.

ftpTester prompts for all the information it needs, as the following illustrates. Two views are shown, depending on whether you are testing receiving (consuming) or producing (sending).

Consumer options

**** Welcome to the Cyclone FTP test program ****

-> Enter host: localhost

-> Enter user: ftpuser

-> Enter password: cyclone

-> Enter account (leave blank for most servers):

-> Enter pickup directory (blank for "pickup"):

-> Enter c for CONSUMER client (list, receive, delete), p for PRODUCER (send). (Blank assumes c): c

-> Should temp files be used to avoid read/write collisions? (Y/N - default is Y):

-> Should a separate inbox dir be used (instead of putting temp files in the pickup dir)? (Y/N - default is Y):

-> Enter inbox dir where files will initially be uploaded before being moved to pickup dir (blank for "inbox"):

-> Use SSL? (Y/N - default is N):

-> Should restarts be attempted for binary files if supported by the host? (Y/N - default is Y):

-> Enter minimum bytes a file must contain to be eligible for restarts (blank for 100000):

FtpClientSettings - host=localhost pickupDir=pickup ctlPort=21 passive=true type=Binary mode=Stream struct=File user=ftpuser account= transportId=FtpTester receiveTempDir=/Applications/cyclone/b1095/bin/ftpRestart_FtpTester connectTimeoutMs=30000 readTimeoutMs=30000 attemptRestarts=true evaluateRestartable=true restartableMinBytes=100000 commandSet=../conf/ftpcommandset.xml preserveFilename=true overwriteIfDupe=true fixOutputFilenames=false tempFileExt=.tmp useDebounce=true useInbox=true isSSLEnabled=false

Host working directory: "/Users/ftpuser" is the current directory.

Host pickup directory (used by REC, DEL and LIST): pickup

Local working directory (used by REC and LLIST): /Applications/cyclone/b1095/bin (LCD to change)

-> Enter CONSUMER command (e.g. ?, LIST, RECeive, DELete, LLIST, ASCII, BIN, LCD, QUIT): ?

CONSUMER metacommands (abbreviations shown in upper case):

? help

LIST list files on host

RECeive filename retrieve file from host

DELete filename delete file from host

ASCII perform ASCII data transfers

BINary perform binary data transfers

LCD change local working directory

LLIST list files in local working directory

PASV perform data transfers in passive mode (the default)

PORT perform data transfers in port mode

QUIT/EXIT/BYE exitNormal FtpTester

Note: Metacommands are scriptable via conf/ftpcommandset.xml

Host working directory: "/Users/ftpuser" is the current directory.

Host pickup directory (used by REC, DEL and LIST): pickup

Local working directory (used by REC and LLIST): /Applications/cyclone/b1095/bin (LCD to change)

-> Enter CONSUMER command (e.g. ?, LIST, RECeive, DELete, LLIST, ASCII, BIN, LCD, QUIT):

Producer options

**** Welcome to the Cyclone FTP test program ****

-> Enter host: localhost

-> Enter user: ftpuser

-> Enter password: cyclone

-> Enter account (leave blank for most servers):

-> Enter pickup directory (blank for "pickup"):

-> Enter c for CONSUMER client (list, receive, delete), p for PRODUCER (send). (Blank assumes c): p

-> Should original filenames be preserved when sending? (Y/N - default is Y):

-> Should existing files be overwritten? (Y/N - default is Y):

-> Should temp files be used to avoid read/write collisions? (Y/N - default is Y):

-> Should a separate inbox dir be used (instead of putting temp files in the pickup dir)? (Y/N - default is Y):

-> Enter inbox dir where files will initially be uploaded before being moved to pickup dir (blank for "inbox"):

-> Use SSL? (Y/N - default is N):

-> Should restarts be attempted for binary files if supported by the host? (Y/N - default is Y):

-> Enter minimum bytes a file must contain to be eligible for restarts (blank for 100000):

Host working directory: "/Users/ftpuser" is the current directory.

Host inbox directory (used by SEND for uploading, after which files are moved to pickup): inbox

Host pickup directory (used by SEND and LIST): pickup

Local working directory (used by SEND and LLIST): /Applications/cyclone/b1095/bin (LCD to change)

-> Enter PRODUCER command (e.g. ?, SEND, LLIST, ASCII, BIN, LCD, QUIT): ?

PRODUCER metacommands (abbreviations shown in upper case):

? help

SEND filename write file to host

ASCII perform ASCII data transfers

BINary perform binary data transfers

LCD change local working directory

LLIST list files in local working directory

PASV perform data transfers in passive mode (the default)

PORT perform data transfers in port mode

QUIT/EXIT/BYE exitNormal FtpTester

Note: Metacommands are scriptable via conf/ftpcommandset.xml

Host working directory: "/Users/ftpuser" is the current directory.

Host inbox directory (used by SEND for uploading, after which files are moved to pickup): inbox

Host pickup directory (used by SEND and LIST): pickup

Local working directory (used by SEND and LLIST): /Applications/cyclone/b1095/bin (LCD to change)

-> Enter PRODUCER command (e.g. ?, SEND, LLIST, ASCII, BIN, LCD, QUIT):

After prompting for the initial configuration information such as the host, user and password, FtpTester displays a main prompt that allows you to enter meta-commands to perform simple operations such as list, send and receive. You can enter a question mark (?) at this point to get more information.