FTP Profile Dialog

Introduction

The FTP Profile dialog is available from the FTP Copy Files dialog. The dialog allows you to setup an FTP Profile. FTP Profiles define how to connect to a server and where to copy files to.

If you are unsure of what server settings to use contact your network administrator.

Profile Name

When OK is pressed all dialog settings are saved under this name. If the name already exists you will be asked whether to overwrite.

Example: If the dialog opens with Profile Name display as "ABC" and you change the name to "Fred". On clicking OK all profile settings are saved under the name "Fred". The profile name "Fred" will appear in the Profile dropdown in the FTP Copy Files dialog. If "Fred" already exist then you will be prompted to overwrite Yes/No. The profile "ABC" is left unchanged.

Page 1
Remote Host

These settings define the main parameters need to connect to an FTP server.

Host Name FTP Server address to connect to. Typically a name like ftp.domainname.com or a dotted IP address like 123.123.123.123
Username/
Password
Specify the Name and Password to use when logging onto the server.
Anonymous Login When checked "anonymous" is inserted into the Username field and the Password field is unmasked. Servers that allow anonymous logon often require you to specify your email address as the password.
Save Password FAR encrypts all passwords saved. Uncheck this box to tell FAR not to save the password field. In this case you will be prompted for a password when connecting to the server.
Directories

FTP Copy Files dialog knows where to copy local files to because of these two fields. They define the relationship between folders on the server and folders on the local PC.

Example:  Server Directory = "/public_html/" and Local Directory = "c:\Inetpub\wwwroot\JamWeb". Thus FAR would copy files in "c:\Inetpub\wwwroot\JamWeb\pub\new" to "/public_html/pub/new/".

Server Directory Defines where on the server to copy local files to. Note that some servers use case sensitive file and folder names, so take care with case, or better still use the the Browse button [...] to choose a server directory.  To specify the root folder of the server specify a single forward slash /.

Click the [...] browse button to connect to the server and browse for a server directory. Using the browse button is a good way to test your profile settings. In fact the Test Connection button simply opens the FTP Browse dialog.
See also FTP Browse dialog.

Local Directory Specify the associated local directory for the Server Directory above.
Click the [...] browse button to browse for a local directory.
Remote Port

Required for FTP connection. Most FTP servers use port 21.

Passive Transfer

If either your connection or uploads fail try enabling PASV transfer mode. Often required when behind a firewall. In PASV mode the Client not the Server forces the data connection.

Page 2
Proxy / Firewall Settings

If required to connect via a proxy server or firewall, then enable this section by checking the checkbox Proxy Settings.

See your network administrator if you are unsure of what settings to use.

Proxy Type Proxy Type sets the method used for authenticating the proxied connection.

If Proxy Host Name (below) is specified (not empty field) then HostName (below) means FAR uses the Proxy Host Name and Proxy Port. Otherwise HostName means use normal Host Name and Port previously defined.

This list describes the commands (in capital letters) sent to the server during logon.

  • USER SITE

    if ProxyUsername defined (not empty field) then
       Send USER ProxyUsername and PASS ProxyPassword (optional).
    Then send USER Username@HostName and PASS Password (optional).
     
  • SITE

    if ProxyUsername defined (not empty field) then
       Send USER ProxyUsername and PASS ProxyPassword (optional).
    Then send SITE HostName.
    Then send USER Username and PASS Password (optional).
     
  • OPEN

    if ProxyUsername defined (not empty field) then
       Send USER ProxyUsername and PASS ProxyPassword (optional).
    Then send OPEN HostName.
    Then send USER Username and PASS Password (optional).
     
  • USER PASS:

    Sends USER UserName@ProxyUsername@Hostname.
    If ProxyPassword defined (not empty field) then
       Send PASS Password@ProxyPassword
    else
       Send PASS Password.
     
  • TRANSPARENT:

    if ProxyUsername defined (not empty field) then
       Send USER ProxyUsername and PASS ProxyPassword (optional).
    Then send USER Username and PASS (optional) Password (see below).
Proxy Host Name

When Proxy Host Name is specified (field not empty) we connect to the FTP server using this Hostname and Port (not the general FTP Hostname and Port).

This may be a server name or dotted IP address like 123.123.123.123

Proxy Port If you enter a Proxy Host Name then also enter the a Proxy Port to use. This is usually 21 for FTP connections.
Proxy Username / Proxy Password Specify the Name and Password (if needed) required by the server.
Save Proxy Password FAR encrypts all passwords saved. Uncheck this box to tell FAR not to save the password field. In this case you will be prompted for a password when connecting to the server.
Read Timeout (s)

How long to wait (in seconds) for the server to respond to a command issued by FAR. If the server does not respond after N seconds then FAR will give up and report a timeout error.

Retry Attempts

When an upload fails FAR can retry that particular file upload a specified number of times before giving up and reporting a failure. Set to 0 to disable retries.

Failures Allowed

A file is marked as failed if it can not be uploaded (after the specified retry attempts). If Failures Allowed = 0 then any upload failure will terminate the entire job. If Failures Allowed = 3 then FTP Copy will tolerate 3 failed file uploads before terminating the entire job.

Reset All

The Reset All button sets all Profile controls back to their default factory settings.

Test Connection

The Test button simply opens the FTP Browse dialog which attempts to connect to the server using the settings specified in this dialog. If your settings are correct and the server is responding you will be able to list the contents of the server. See FTP Browse dialog.

Additional
Windows 95

FTP Copy requires Winsock 2 (available on W98 and later). Stock standard 95 only has Winsock 1.1. W95ws2setup.exe is a free download from the MS web site that installs Winsock 2 for Windows 95.

 


http://www.HelpwareGroup.com/