When you have specified To File as the destination component for a channel, you can indicate that the files that are created by this channel are to be sent to an FTP server at the destination site. To do this, select the Upload to FTP check box.

	New Feature in Iguana 4.5 The Upload to FTP feature is new in Iguana 4.5.

When this check box is selected, additional fields appear that enable you to provide information about the FTP server to which the files are to be sent:

• From the FTP protocol list box, select the FTP protocol that you want to use. You can select FTP (standard FTP), FTPS (FTP over SSL) or SFTP (Secure Shell FTP).
• In the FTP server field, type the name of the FTP server to which you want to send the files.
• In the FTP port field, type the port that the FTP server is using. If you are using the FTP protocol, this is usually port 21. If you are using FTPS, this is usually port 990. If you are using SFTP, this is usually port 22.
• In the FTP username field, type the username that you use to access the FTP server.
• If your FTP server requires a password for access, type the password in the FTP password field.
• In the FTP path field, type the location of the directory on the FTP server into which the generated files are to be written. How this field is interpreted depends on the protocol that you are using. See the note below for more details.
• Select the Use remote temporary file check box if Iguana is to use a temporary file when uploading. When the upload is complete, this temporary file is renamed to the final file name. This is useful for ensuring that remote systems do not read a partially uploaded file. (Disable this option if the remote server reports a "rename failed" error and leaves a temporary file with the extension -upload, and the channel stops. This typically means that the server is employing its own temporary file mechanism that is incompatible with Iguana.)

	New Feature in Iguana 4.5.4 The Use remote temporary file check box is new in Iguana 4.5.4.

	If you are using the FTP or FTPS protocol, the directory specified in the FTP path field is relative to the home directory for the FTP user. For example, if the FTP user is iguanauser and the user's home directory is C:\iguanauser\FTP, specifying iguanadir in the FTP path field indicates that files should be written to C:\iguanauser\FTP\iguanadir. If you are using the SFTP protocol, the FTP path field must contain the full path of the directory into which files are to be written. If the FTP path field is empty, the files are stored in the user's home directory if you are using the FTP or FTPS protocol, and in the FTP server's root directory if you are using the SFTP protocol.

If you have selected FTPS from the FTP protocol list box, fields appear that enable you to specify encryption information:

• In the Certificate file field, type or browse for the location of your certificate file.
• In the Private key file field, type or browse for the location of your private key file.

	For information on how to create a public/private key file, see Creating Public/Private Key Files.

• If you want to verify the authenticity of the server to which you are sending messages, select the Verify peer check box. If the Verify peer check box is selected, the Certificate authority file field is displayed:

• In the Certificate authority file field, type or browse for the location of the certificate authority file.

If you have selected SFTP from the FTP protocol list box, fields appear that enable you to specify how to authenticate your connection:

From the Authentication list box, select the type of SFTP authentication to use (either Username/Password or Private/Public Key).

If you have selected Username/Password from the Authentication list box, the FTP Options section of the Destination screen will appear as shown above. Continue as follows:

• In the FTP password field, type the password that your FTP server is expecting.
• Select the Verify host fingerprint check box to verify the authenticity of the server that is receiving the messages.

	New Feature in Iguana 4.5.3 The ability to specify a password when using the SFTP protocol is new in Iguana 4.5.3. Host fingerprint verification is new in Iguana 4.5.3.

If you have selected the Verify host fingerprint check box, the Host fingerprint field appears:

This field contains the host fingerprint, which is a 32-character string created using the MD5 cryptographic hash function. If the field is empty, click the Get Fingerprint link to obtain the host fingerprint.

If you have selected Private/Public Key from the Authentication list box, the FTP Options section of the Destination screen displays the fields shown below:

Continue as follows:

• Select the Verify host fingerprint check box to verify the authenticity of the server that is receiving the messages. If you have selected this check box, the Host fingerprint field appears:

This field contains the host fingerprint, which is a 32-character string created using the MD5 cryptographic hash function. If the field is empty, click the Get Fingerprint link to obtain the host fingerprint.

• In the Private key file field, type or browse for the location of your private key file.
• In the Public key file field, type or browse for the location of your public key file.

	If you have selected Private/Public Key from the Authentication list box, you will need to configure your FTP server's SSH daemon so that it will not prompt for a password when Iguana is uploading files. For information on how to create a public/private key file, see Creating Public/Private Key Files.

At the bottom of the FTP Options section, fields enable you to specify how reconnection should be handled, whether to keep local files, and what to do if the FTP file transfer is about to overwrite an existing file:

• From the Attempt to reconnect? list box, select whether you want Iguana to try and reconnect to the FTP server if an initial connection could not be made or if the connection is dropped. Select No if you do not want Iguana to reconnect, Yes (unlimited) if you want Iguana to keep trying to connect forever, or Yes, with limit if you want Iguana to make a limited number of reconnection attempts.
• If you select Yes, with limit from the Attempt to reconnect? list box, a text field appears:

In this text field, type the amount of times that Iguana should try to connect before giving up.

• If you select Yes, with limit or Yes (unlimited) from the Attempt to reconnect? list box, the Reconnection interval text field is displayed. In this field, type the number of milliseconds that Iguana should wait before trying to connect again.
• Select the Keep local files check box if a copy of the generated files is to be kept on the Iguana server.
• From the FTP overwrite handling list box, select what you want the channel to do when a remote file that you are attempting to write already exists. Select be overwritten if you want to overwrite the existing remote file, be skipped if you want to skip writing the remote file if it already exists, or stop the channel if you want the channel to stop if a remote file already exists.