WS_FTP Pro. User s Guide. Software Version 8.0. Ipswitch, Inc.

(1)

WS_FTP Pro

User’s Guide

Software Version 8.0

(2)

Ipswitch, Inc. Phone: 781-676-5700

10 Maguire Road Suite 220 Fax: 781-676-5710

Lexington, MA 02421-3127 Web: http://www.ipswitch.com

The information in this document is subject to change without notice and should not be construed as a commitment by Ipswitch, Inc. While every effort has been made to assure the accuracy of the informa-tion contained herein, Ipswitch, Inc. assumes no responsibility for errors or omissions.

Ipswitch, Inc. assumes no liability for damages resulting from the use of the information contained in this document.

The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of that license.

Copyright © 2003 by Ipswitch, Inc. All rights reserved. WS_FTP, the WS_FTP logos, Ipswitch, and the Ipswitch logo are trademarks of Ipswitch, Inc. Other products or company names are or may be trademarks or registered trademarks and are the property of their respective companies.

No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transferred without the expressed prior written consent of Ipswitch, Inc.

Printing History

May 1996 First Edition

December 1996 Second Edition

July 1997 Third Edition

February 1998 Fourth Edition

October 1998 Fifth Edition

May 2000 Sixth Edition

June 2001 Seventh Edition

March 2002 Eighth Edition

August 2002 Ninth Edition

(3)

Contents WS_FTP Pro iii

A vast store of software applications, games, images, and other types of files are available on FTP and SFTP sites all over the world. A site is a computer system (“host”) that uses an Internet protocol called FTP (File Transfer Protocol) or SFTP (Secure File Transfer Protocol.) FTP and SFTP offers fast and accurate transfers of large files or collections of files between computers on the Internet.

Many Web sites on the World Wide Web (which is based on another Internet protocol called HTTP) also provide links to files you can

download -- that is, copy to your PC. Especially for large files,

WS_FTP Pro will speed up the time it takes to copy such files to your PC. For more information, see “Browser Integration” on page 6. WS_FTP Pro also allows you to upload files -- that is, copy files from your PC to other computers. For example, you would upload files if you need to place your Web pages on a computer system designated by your ISP (Internet Service Provider), or if you want to store a picture of something you want to sell through an online auction site.

How FTP/SFTP Works

FTP/SFTP uses the client–server model: one computer (the FTP/SFTP Host) runs a server program “serving up” information to other computers. The other computers run client programs requesting information and receiving replies from the server.

Using This Book

The WS_FTP User’s Guide is a resource you should use to familiarize yourself with the different features of WS_FTP Version 8.0.

(10)

FTP

WS_FTP Pro turns your PC into a client, allowing it to communicate with virtually all types of FTP sites. When your PC is connected to the Internet (via a modem or local area network), WS_FTP Pro can connect to any system that has a valid Internet Address and is running an FTP server program. Once connected to an FTP site, you can copy files to and from your local PC or another FTP site.

SFTP

SFTP is a file transfer protocol that runs over a secure SSH (Secure Shell) client like WS_FTP Pro. It works a lot like FTP, except that all communications and transfers between the client and server are done over a single secure connection.

New in WS_FTP Version 8.0

• Thumbnails browsing option.

• Active Edit system.

• Use of both implicit and explicit SSL.

• Auto-connect to remote sites on application start-up • Hotdrop shortcuts to remote directories.

• SSL/NAT feature for specifying external IP address and port range for PORT commands.

• Support for ASCII transfers via SFTP.

• SOCKS4 and SOCKS5 Proxy support.

System Requirements

WS_FTP Pro requires the following system resources:

• An Intel Pentium processor

• Windows 98, 2000, ME, NT or XP

• Internet Explorer 4.02 or newer (does not have to be your default browser)

SFTP You can find more information about SFTP in “Chapter 8: Security” on page 45

(11)

3 Introduction

WS_FTP Pro

Installing WS_FTP Pro

The installation of WS_FTP Pro is the same for new users, those who are upgrading from a previous version of WS_FTP Pro, and those who are replacing an evaluation version with a purchased version.

To install WS_FTP Pro from a downloaded file:

1 Double-click the file you downloaded. (wsftppec.exe) 2 Follow the directions on your screen.

To install WS_FTP Pro from a CD-ROM:

1 If you already have a previous version of WS_FTP Pro on your

system, make sure you are not running the application (either Classic or Explorer).

2 Insert the WS_FTP Pro CD-ROM into a CD-ROM drive.

3 If the CD-ROM does not automatically display a “Welcome”

screen, click the Start button and select Run.

4 Enter the CD-ROM drive letter followed by autorun. For

example: d:autorun

5 Follow the instructions on your screen.

Please refer to the file named whatsnew.txt or relnotes.txt for information regarding enhancements or changes that may have been made to the software since this manual was printed.

Logging Onto an FTP Site

The FTP process begins when a connection is made between an FTP client and an FTP site. After establishing communication, the client “logs on” with a user ID and password. The user ID and password identify you to the site.

If you are upgrading from a previous version of WS_FTP Pro, or replacing an evaluation version, be sure to install the purchased version in the same location as your previous or evaluation version.

You can install both the Classic and Explorer interfaces and use them interchangeably. The two interfaces share the FTP site

configurations you create in either interface.

(12)

Most public FTP sites are set up with an “Anonymous” account: when you connect to one of these FTP sites, you need only identify yourself as “Anonymous” and use an e–mail address as a password. Normally, when you log on anonymously, you see a public folder (usually named something like /pub or /apps) containing the information and software that can be downloaded to your PC. (Access to other folders on the site is usually restricted.)

On anonymous FTP sites, look for files called readme, readme.txt,

index, or 00index. Many sites use a file like this to provide a catalog of

the information available on the site as well as other information about the site, such as a mission statement or operating hours. In addition, an FTP site administrator can give certain users “accounts” with special permissions. For example, a user with an account may be able to upload, download, delete, and edit files: while an “anonymous” user can usually only download files. To log on to a site on which you have an account, you will need to enter the Host Name, User ID, and Password that the site administrator has assigned to your account.

Interfaces for Windows 98, 2000, ME, XP

and NT

WS_FTP Pro provides two user interfaces: the Classic user interface, which runs as a standard Windows application, and the Explorer interface, which has the same look and feel as Windows Explorer.

(13)

5 Introduction

WS_FTP Pro

The Classic Interface of WS_FTP Pro

The Classic interface is a standard Windows application that looks similar to a two-paned window. When your PC (the “Local System”) connects to an FTP server (the “Remote System”), the WS_FTP Pro Classic interface displays a window with your PC’s files and folders on the left and the FTP site’s files and folders on the right. With the contents of both systems displayed, you can easily locate files on one system and transfer them to a specific folder on the other system. The Classic interface looks similar to this:

The buttons to the right of each list box provide file and folder operations for that list box.

The Explorer Interface of WS_FTP Pro

The second interface of WS_FTP Pro is the Explorer interface. The Explorer interface uses the same software engine as the Classic interface, but it lets you copy and move files within a system that has the same look and feel as Windows Explorer.

The current folder on the FTP site is shown in this pane. The current folder

on your PC is in this pane.

This list box shows the files and folders in the current folder on the FTP site. This list box

shows the files and folders in the current local folder.

Status bars show a total or selected number of files and their combined size.

(14)

The WS_FTP Pro Explorer interface looks similar to one of the following:

Browser Integration

You can set up WS_FTP Pro so that it automatically handles FTP URLs when you click them in your browser or in an e-mail message. (A URL, Uniform Resource Locator, is an Internet address describing an Internet resource. For example, the Web URL for the Ipswitch web site is http://www.ipswitch.com/; the FTP URL for the FTP site of WS_FTP Pro Patches is ftp://ftp.ipswitch.com.)

WS_FTP Pro handles FTP URLs as follows:

• If the URL is the name of an FTP server, such as

Files and folders in the current folder The appearance of the Explorer

window is determined by your View menu options.

Explorer interface

Browser Integration is NOT compatible with

(15)

7 Introduction

WS_FTP Pro

• If the URL includes the path and name of a file, such as ftp.ipswitch.com/French/ftp605F.txt, WS_FTP Pro attempts to download the file to your PC, and prompts you for a location to save or execute the file.

• If the URL includes the path and name of a folder (and not a file), such as ftp.ipswitch.com/French, WS_FTP Pro “handles” the URL by starting the Classic interface, connecting to the site, and navigating to the folder.

To turn on Browser Integration:

1 Select Browser Integration from the Program Options dialog.

2 If you use Netscape Navigator and want WS_FTP Pro to handle

FTP URLs, select the first check box.

3 If you use Microsoft Internet Explorer and want WS_FTP Pro to

handle FTP URLs, select the second check box.

4 If you want to be prompted each time you click an FTP URL so

you can choose whether or not to use WS_FTP Pro, select Ask

before using WS_FTP.

Other Ipswitch WS_FTP Products

WS_FTP Server and the WS_FTP Pro Development Kit can be purchased separately at www.ipswitch.com.

WS_FTP Server

The WS_FTP Server is a full-featured, secure (using SSL) FTP server for Windows NT/2000/XP systems. WS_FTP server lets you create an FTP site that makes files and folders on your PC available to other users. WS_FTP Server offers many features not found in most commercial servers today, including automatic resumption of interrupted transfers.

(16)

WS_FTP Pro Development Kit

You can develop custom applications using the WS_FTP Pro Development Kit. It lets you create programs to work with WS_FTP Pro for transferring files to or from FTP sites or between FTP sites. The Development Kit lets you create an FTP application without being concerned with the intricacies of network programming.

Getting Updates and Giving Feedback

Ipswitch frequently makes patches and upgrades available on our Web site. For the latest version information, please visit

www.ipswitch.com.

To access upgrades on the Ipswitch FTP site (using the Classic interface):

1 In the WS_FTP Pro window, click the Connect button.

2 In the Connect to Remote Host dialog, open the Predefined Sites and Ipswitch folder and select the site named WS_FTP Pro

Patches.

3 Click Connect. WS_FTP Pro connects to the WS_FTP Pro

folder.

4 Select the desired patch file; the last three digits of the file name indicate the version number. For example, wsftp606.exe is the patch file to update earlier versions to WS_FTP Pro 6.06. Read the accompanying text file (for example, wsftp606.txt) to verify that you have located the correct file.

5 Transfer the patch file and place it in a folder other than your

WS_FTP Pro folder or your Windows Temp folder. To update the

software, double-click the patch file and follow the instructions. To access patches on the Ipswitch Web site:

1 In your Web browser, go to: http://www.ipswitch.com

2 Click the Downloads link.

3 Click Software Updates, and then click the link for the product. 4 Save the patch file in a folder other than your WS_FTP Pro

(17)

9 Introduction

WS_FTP Pro

We welcome your feedback on WS_FTP Pro. Please e–mail any comments and suggestions to [email protected].

Accessibility

WS_FTP Pro is designed for use by all computer users, including those with certain disabilities that make using a mouse impossible. Every operation and feature included in WS_FTP Pro has a shortcut key, or series of keystrokes that allow the user to use their keyboard to execute the command.

The image below shows the WS_FTP Button bar:

Notice that each of the button labels have a letter that is underlined. To access the command performed by the button, hold the Alt key on your keyboard and press the underlined letter on the button you want to use. For example, Alt + C will disconnect you from the current FTP site, and Alt +X will close the program.

(18)

(19)

11 Getting Started

WS_FTP Pro

Chapter 2: Getting Started

This chapter describes how to get started using WS_FTP Pro. The two main windows of the Classic Interface are described for you, and in the sidebar are step-by-step instructions on the basic functions of WS_FTP Pro.

Making your First Connection

The first time WS_FTP Pro is run, the Classic Interface opens with the Connect to Remote Host dialog displayed.

WS_FTP Pro uses Site Profiles to store information it needs to make a connection to an FTP site. This information includes:

Some sites are set up for you when you install WS_FTP Pro. You can connect to one of these or configure your own.

When you select a configured site, the host information for that site is displayed in the Host Info tab of the Site Options dialog.

Access this dialog by selecting a site and clicking the Edit button.

Make your first connection: Before you make your first connection, you need to create a site profile for that FTP server. 1. From the Connect to Remote

Host dialog, click the Create Site button.

2. In the Name box enter what you want to call the site. 3. In the Create In box, select the

folder you want to create the site in.

4. Click Next.

5. In the Host Name or IP

address box, enter the internet

address for the FTP site you want to connect to. 6. Click Next. 7. Enter the UserID and

Password for that site.

8. Click Finish, or click Next to enter optional information about the site (described later in the User’s Guide and in the Online help.)

Your new site profile will now appear in the folder you selected. 9. Click Connect.

When you click connect, the Connection Dialog box disappears and the WS_FTP Pro Classic Interface attempts to make the connection.

(20)

• Hostname/IP Address. Every system (computer) on the Internet

has an official host name or an Internet (IP) address. In order to connect to an FTP site, you must find out the official name or address of the site. For example, a system might have a host name of superserv.ipswitch.com and an IP address of 123.124.125.126. In WS_FTP Pro, you can use either the host name or the IP address to specify a particular FTP site.

• User ID. The User ID or user name is given to you by the FTP

site administrator or owner when an account is created. For information on how to connect without a User ID, see “Anonymous Connections” on page 15.

• Password. When an account is created, a password is chosen or

issued to you. When used with the User ID, it allows you to connect to your FTP account.

• Site Options. There are many options you can set in a Site Profile

that controls how WS_FTP Pro makes and maintains connections to an FTP Site. These options are set through the Site Options dialog that can be found by selecting a site and clicking the Edit button on the Connect to Remote Host dialog.

To get started using WS_FTP Pro, you have two choices. You can either connect to one of the sites we have included in the application, or you can create you own Site Profile and use that to connect to the FTP site you identify in the profile.

To connect to a pre-configured site, simply select the site from the Sites list on the Connect to Remote Host dialog and click the

Connect button.

To configure your own site, click the Create Site button and follow the directions on the New Site wizard. Once you finish the wizard, you will be able to select your site and click Connect. From then on, your site profile will be there for you to use.

Transferring a File

After making your connection, WS_FTP closes the Connection dialog, leaving the WS_FTP Pro window. The image below shows

(21)

WS_FTP Pro

The following are boxes and window structures that are important in learning how to make an FTP transfer:

Local System. The left pane shows the directory set as your default

local directory, and all of the files and folders in it. You can change directories by selecting it from the list, by clicking the Browse (...) button next to the Local System box, or by typing the folder path in the box.

Remote System. The right plane displays the default directory for the

FTP site you connect to. You can change directories by selecting it from the list, by clicking the Browse (...) button next to the Remote

System box, or by typing the folder path in the box.

Address. The Address bar displays the complete path of the FTP Site

you are connected to. If you type this address in manually, the

Address bar will record the last ten sites and folders you have

connected to.

Transfer Arrows. Click these icons to transfer a file:

Upload Arrow

(22)

WS_FTP Pro Toolbar

Customizing the Toolbar

You can modify the appearance of the toolbar by selecting the

Toolbar dialog from the Program Options.

Connect. Click this icon to select or configure a site to connect to,

using the Connection Dialog box.

Disconnect. Click this icon to disconnect from a site.

Transfer Manager. Click this icon to display the Transfer Manager.

For more information, see “Chapter 7: WS_FTP Transfer Manager” on page 41.

Edit Manager. Click this button to display the Edit Manager for the

Active Edit function. For more information, see “Active Edit” on page 34

Batch Mode. Click this icon to place WS_FTP in Batch Mode. In

this mode, selected files will be added to the Transfer Manager to be transferred later.

Multipart Mode. Click this icon to put WS_FTP in multipart mode.

This is used to split large files into smaller more manageable downloads. For more information, see “Multipart Transfers” on page 29.

Options. Click this icon to access WS_FTP Program Options.

Views. Click this icon to select a view type from the menu. The

following is a list of these view types.

Large Icons. Click this icon to change the layout of the list pane to

show file names along with large icons associated with the file type.

Small Icons. Click this icon to change the layout of the list pane to

show file names along with small icons associated with the file type.

List. Click this icon to change the layout of the list pane to show an

ordered list of files in a selected directory.

Details. Click this icon to change the layout of the list pane to show

an ordered list of files with the name, size, type, time of last modification, and attributes listed.

Thumbnails. Changes the layout of the list pane to show

thumbnails of graphic files and icons of others.

How to...

Transfer a file:

Once you have connected to a site, you are ready to transfer a file. Downloading a File

1. Select the directory you want to download the file to in the

Local System list.

2. In the Remote System list, find the file by clicking on the folder it is stored in (unless the file is in the directory you connected to.)

3. Select the file you want to download.

4. Click the download transfer arrow. It is the one that looks similar to:

<--5. When the file is downloaded, it will appear in the Local

System list.

Uploading a File

1. Select the directory you want to upload the file to in the Remote

System list.

2. In the Local System list, select the file you want to upload. 3. Click the upload transfer arrow.

It is the one that looks similar to: -->

4. When the file is uploaded, it will appear in the Remote

(23)

WS_FTP Pro

Anonymous Connections

To log on to any FTP site, you must identify yourself with a user ID and password. For many FTP sites, you can use the word anonymous as a User ID, and your E-mail address as your password; this is known as an "anonymous login." (All of the Ipswitch preconfigured FTP sites are set up as anonymous logins.)

FTP sites that allow anonymous logins usually exist to provide files that can be downloaded by the general public; anyone on the Internet can log onto the site anonymously and copy files to their PC. This is similar to logging on to a file server as a "guest."

Anonymous logins have access to a vast store of software, games, music, and numerous other resources. However, if you log in anonymously, you usually are not allowed to do more than view public folders and download files. (You are usually unable to view private folders or to upload files.)

Assistance Center

The WS_FTP Pro Assistance Center has been created to help new users get up and running with WS_FTP Pro as quickly as possible, and to give more experienced users quick access to our online support. The Assistance Center includes:

• Tutorials. Our interactive tutorials are available to anyone

with a connection to the internet. The two lessons walk users through how to get connected to an FTP site and how to successfully transfer files.

• Getting Started Guide. This guide offers information on

how to get started using WS_FTP Pro, and a tour of the product that points out various functions.

• Common Terms and Definitions. Look here for a list of

common terms and phrases used in our documentation.

• Link to our Knowledge Base. You can also directly access

(24)

Using the Help System

Our Online Help system contains detailed descriptions and directions on how to use each and every function available in WS_FTP Pro. It should be the first place you look if you have any question using the product.

Individual topics are organized into books that relate to a spe-cific function. Some books have other books listed in-side.

Use the Index tab to look up keywords, and use the Search tab to search for words in the body of

the topics. The body of the help topic

appears in this pane. Click on blue words to ‘jump’ to another topic. Click green to access a ‘drop down’ list.

(25)

17 Connections

WS_FTP Pro

Chapter 3: Connections

This chapter details the different ways users can make FTP connections using WS_FTP Pro.

Using Site Profiles

For most FTP connections, WS_FTP Pro uses site profiles to store information it needs to establish the connection with the Server. These profiles control how WS_FTP Pro connects to the remote server, and how it performs once the connection is made. Site profiles are created and maintained on the Connect to Remote Host dialog.

Connect to Remote Host Dialog

The Connect to Remote Host Dialog is your main starting point in using WS_FTP Pro. From there, you can create and edit site profiles, organize your profiles, and use those profiles to connect to your FTP sites.

The following are descriptions of all of the features on the Connect to Remote Host dialog.

• Assistance Center. When this button is clicked, the Assistance

Center window appears. For more information, see “Assistance Center” on page 15.

• Connect. Click this button to connect to the selected site.

Look for more information in the Connecting to an

FTP Site section of the

(26)

• Create Site. Click this button to access the Site Profile wizard.

Use this wizard to create a new site profile.

• Create Folder. Click this button to access the New Folder

wizard.

• Edit. Click this button to edit the selected site profile.

• Delete. This button deletes a selected site or folder.

• Close. Click this button to close the Connect to Remote Host

dialog box.

• Help. Click this button to access the WS_FTP Pro Online Help

system.

• Configured Sites. This box lists all of your configured sites.

Host Info Dialog of Site Options

After creating a Site Profile through the Site Profile Wizard, you can edit the profile by selecting it and clicking the Edit button. The following is a description of the Host Info dialog of the Site Options dialog. For detailed information on the other dialogs in the Site Options, click the Help button on those dialogs.

• Host Name. Every system (computer) on the Internet has an

official host name or an Internet (IP) address. In order to connect to an FTP site, you must know the official name or address of the site. For example, a system might have a host name of

superserv.ipswitch.com and an IP address of 123.124.125.126. In WS_FTP Pro, you can use either the host name or the IP address to specify a particular FTP site.

• UserID. If you have an account on the FTP server you are

connecting to, enter your user identification name here. For

When a folder has a + next to it, it means that there may be folders or sites within this folder.

Select a site to connect to that site or to view the host information for that site. To rename a site, right click on the site name, select rename, and type the new name.

(27)

19 Connections

WS_FTP Pro

• Password. Enter your password for the site you are connecting

to.

• Account. Some FTP sites, notably VM/CMS hosts, require an

account in order to authenticate the client and provide access to a default directory for the user. For most sites, however, no account is required.

• Anonymous. Select this option if you are making an anonymous

connection to the selected site. For information on anonymous connections, see “Anonymous Connections” on page 15. • Save Password. When you select this option, the password will

be saved with the site information. It is recommended that you do not select this option if other people have access to your

computer.

• Save Account. Select this option to save the account information

entered in the Account box with the site information.

• Comment. Enter any comment you would like to make about the

site.

Organizing Sites

With the Organize Sites dialog, you can create, organize, and modify site profiles while connected to an FTP site (you have to disconnect before you can access the Connect to Remote Host dialog). To access this dialog, select Organize Sites from the Sites menu.

Notice that the buttons here also appear on the Connect to Remote

(28)

Automatic Connections

If you have a single site that you connect to over and over again, you can have WS_FTP Pro attempt to make a connection as soon as you start the application. This can be done in one of two ways, using the

Auto reconnect option on the General dialog of Program Options. Connect to Default Site

By setting this option, and choosing a default site profile on the

Connect to Remote Host or Organize Sites dialog, you can have

WS_FTP Pro connect to that site as soon as you open the application.

Open with last local and remote folders

If you do not want to set up a default site to use every time you open the application, you can select this option to have WS_FTP Pro open the last remote connection to the last remote folder you were in when you exit the application. It will also display the last local folder you were in as well.

If you do not have a remote connection when you close the application, it will not auto reconnect to any site.

Alternate Connecting Methods

WS_FTP Pro offers several ways of connecting to a remote site where you don’t have to use a site profile, or you don’t have to use the Connect to Remote Host dialog. In time, a user may find that they like using these methods better than going through the Connect to

Remote Host dialog. Below are descriptions of each of these

methods.

Sites Menu

You can connect to your configured sites by selecting the site from the Sites Menu. This menu is available in both the Classic and the Explorer interface.

Setting a default site

To set a default site, right-click on the site profile and select Default Site from the menu.

(29)

21 Connections

WS_FTP Pro

To change the folders or layout of this list, select Organize Sites and use the Organize Sites dialog.

Recent Sites

On the File menu, you will find the Recent sites submenu. This menu shows the last ten FTP sites you successfully connected to. You can establish a connection by selecting one of the sites from the menu.

Quick Connect

Quick Connect provides a means for you to connect to an FTP site

with minimal effort and time; for example, you might use Quick

Connect to connect to a site that you want to visit just once.

To use this feature, select Quick Connect from the File menu.

Note

(30)

Address Bar

The Address bar of the WS_FTP Pro Classic interface can be used in three ways to connect to an FTP server:

Type the address directly into the Address bar

If you type the address alone, WS_FTP Pro will prompt for a username and password. You can also type the username and password in front of the site address in this format:

username:[email protected]:port/path. Example:

robert:[email protected]:21/pub/

You can also enter the username and password in the boxes below the address bar, after entering the ftp address in the address box.

Note

You can make an SSL or SSH connection by selecting the type of secure connection from the lock icon next to the address box on the address bar. For more information, see “Chapter 8: Security” on page 45

Use the listbox to select a recently visited site

When you connect to a site, a record of that connection will be stored in the listbox. You can connect to that site by selecting the entry. WS_FTP Pro will attempt to make a connection using the same options defined when the site was last visited.

Internet Connection Settings

The following settings can be configured on the Internet Connection dialog of the Program Options (click the Options button on WS_FTP Pro) to have WS_FTP Pro automatically connect to and/or disconnect from the internet when scheduled items are run, or when time consuming tasks are being performed.

• Connect to Local Area Network (LAN). If you connect to the

internet via a LAN (or cable modem, DSL, T1, etc.), WS_FTP Pro will automatically set this option and disable all others.

(31)

23 Connections

WS_FTP Pro

• Connect using a dial-up connection. Select this option to have

WS_FTP Pro connect to the internet using a dial-up connection. This is a connection made by your computer using a modem and your telephone lines.

• Select a dial-up connection. If you have multiple dial-up

connections configured in your Windows Dial-Up Networking, select the configuration you want WS_FTP Pro to use here. • Disconnect when application exits. Select this option to have

WS_FTP Pro end your connection to the internet when the application is closed. This will end any connection you have made through any means.

• Disconnect only when application establishes connection.

Select this option to have WS_FTP Pro end your connection to the internet when the application is closed, only when WS_FTP Pro made the internet connection in the first place.

Passive Mode

Normally, when you connect to an FTP site, the site establishes the data connection to your PC. However, some FTP sites allow passive transfers. This means that your PC establishes the data connection. By default, passive mode is turned on in WS_FTP Pro; we recommend that you use it for transfers to and from FTP sites that support it. Note that passive mode may be required in the following instances:

• For users on networks behind some types of router-based firewalls

• Users on networks behind a gateway requiring passive transfers

• If transfers are erratic

• If you keep getting failed data channel or blocking call

(32)

(33)

25 Transferring Files

WS_FTP Pro

Chapter 4: Transferring Files

Transferring means moving or copying files or folders between computers. If you transfer a file from your computer (local system) to an FTP Site (remote system) it is called an upload. If you transfer a file from a remote system to your local system, it is called a

download. If you transfer between two remote sites, it is called a site

to site transfer.

Ways to Transfer Files

WS_FTP Pro allows you several ways to transfer a file.

Using the Transfer Arrows

Select a file or folder and click the Upload or Download Arrow to transfer it. You can select multiple files by holding down the Ctrl button while selecting.

Drag and Drop

With a file or folder selected, click and hold your left-mouse button and drag the file to where you want it transferred to. You can select multiple files by holding down the Ctrl or Shift button while selecting. As you drag the file, your cursor changes.

When you release the mouse button, WS_FTP Pro attempts to transfer the file to that location.

Upload Arrow

Download Arrow

When your cursor looks like this, you are at a place where you can transfer a file.

When your cursor looks like this, you cannot drop a dragged file there.

Look for more information in the Transferring Files section of the Online help.

Restarting Transfers!

Some FTP Servers allow clients to restart transfers that have failed or been interrupted due to a lost connection, cancellation, or other reason.

For specific directions on this process, see the

Transferring Files section

(34)

Copy and Paste

Right-mouse click a file, then select Copy from the pop-up menu. Right-click where you want to transfer the file to, and from the right-mouse menu select Paste. WS_FTP Pro then attempts to make the transfer.

Batch Mode

If you want to transfer multiple files from different sites, you can put WS_FTP Pro in Batch Mode.

While in batch mode, WS_FTP Pro will add a request to the Transfer Manager, to be performed when you choose. If you want to make an immediate transfer while in Batch Mode, without having it go through the queue, select the file and drag it to the destination folder.

Using the Transfer Manager

The WS_FTP Pro Transfer Manager is used to view the progress of transfers, to schedule the transfer of multiple files, and to view logs for individual transfers. For more information, see “Chapter 7: WS_FTP Transfer Manager” on page 41.

Upload Wizard

The Upload Wizard is a utility that allows you to transfer files from your local system to a remote FTP site without using the WS_FTP Pro interface. There are two ways to access the Upload Wizard:

• In Windows Explorer, select the files or folders you want to upload, then right-mouse click on the list. In that list you will see 'Upload using WS_FTP Upload Wizard.' After selecting that option, the Upload Wizard appears with the files already added to the upload list.

Confirming Overwrites

Most sites allow you to overwrite or replace a file without giving you any kind of visual warning. Through WS_FTP Pro, you can set it up so that a dialog box is displayed to warn you that you are about to overwrite a file. For specific directions on this feature, see the

Transferring Files section

(35)

WS_FTP Pro

• Select WS_FTP Upload Wizard from your Windows Start menu.

This will open the Wizard ready for you to add the files you want to upload.

After the files are added to the Upload wizard, you will be asked to select a remote folder or enter a remote URL. This is where the files are uploaded to.

Hotdrop Folder

Hotdrops are shortcuts to remote directories that you can create anywhere on your local system. They appear as files with the extension .fhf.

If you click on the file, WS_FTP Pro launches and automatically connects to the site and navigates to the local and remote folders that you identify when you set up the hotdrop.

You can also drag files and folders to the icon and drop them. The files and folders will then be automatically uploaded to that site. The Transfer Manager appears to show the progress of the transfers.

Using Hotdrops

Hotdrops are excellent ways for you to quickly upload files without having to launch WS_FTP Pro. If you are updating a web site, think about placing a Hotdrop in your production folder. When you update a file, just drag it on the Hotdrop icon and it will be transferred to your site.

(36)

Transfer Modes

There are three modes that WS_FTP Pro uses to transfer a file. Depending on the type of file, you may have to select this mode before you attempt to transfer a file.

These modes are called ASCII, Binary, or Auto. The following chart shows the icon that should be chosen for the described type of file.

Ascii Mode

A file that is text, HTML, postscript, other ASCII format (.txt, .html, .htm, .cgi), or EBCDIC should be transferred in ASCII mode. If you transfer a binary file in ASCII mode, you will not get the entire file.

Binary Mode

A file that is a bitmap, an executable, or compressed (.bmp, .jpg, .exe, .zip) should be transferred in binary mode. (Binary mode should also be used if there is no file extension or the file extension is not registered.) This is the default mode.

Auto Mode

If you turn on Auto mode, WS_FTP Pro checks to see if the file has an extension that is listed on the Extensions tab of the Options dialog. If so, ASCII mode is used; if not, binary mode is used.

(37)

WS_FTP Pro

Automatic Retry

If the initial attempt to transfer a file fails, WS_FTP Pro can automatically retry the attempt a set number of times. To set the Automatic retry:

1 From WS_FTP Pro, click the Options button.

2 Select the Transfers dialog.

3 In the Number of retries for failed transfers box, enter the number of times you want WS_FTP Pro to retry the transfer (0-99.)

Resuming a Failed Transfer

WS_FTP Pro can automatically resume interrupted transfers or transfer attempts when the application is started, if the WS_FTP Pro application is terminated while:

It is in the process of transferring a file or if it is still on the Transfer list (on the Transfer Manager) as a failed transfer.

To set this option:

1 From WS_FTP Pro, click the Options button.

2 Select the Transfers dialog.

3 Select the Automatically resume transfers when application

starts option.

4 Click OK.

Multipart Transfers

When in Multipart mode, WS_FTP Pro will split large files into smaller and download all sections with different, yet concurrent, connections. This will decrease the amount of time it takes to download large individual files.

(38)

The number of connections made is determined by the number of additional connections specified in the Site Profile, as well as the number of connections allowed by the server and the Number of

parts used on multi-part transfers option on the Transfers dialog

of Program Options.

The Transfer Manager will display the file, the number of segments that the file has been divided into, and the status of the transfer of each of the segments. When each of the segments are complete, the Transfer Manager will show the status of the re-combining of the files, if that process takes longer than 2 seconds.

If there are no segments listed under the file being transferred, than the file is not large enough to be divided.

Note: Multipart does not work with SSH connections or with uploads.

To use Multipart mode, click the Multipart mode button on the WS_FTP Pro toolbar.

(39)

31 Managing Files and Folders

WS_FTP Pro

Chapter 5: Managing Files and Folders

This chapter deals with using WS_FTP Pro to manage files and folders on both local and remote systems. Managing files and folders includes:

• Viewing and navigating

• Working with files and folders

Viewing and Navigating

WS_FTP provides many tools and techniques for viewing and navigating files and folders.

This section points out various structures on the WS_FTP Pro window that allow you to view files and folders, and to navigate both local and remote systems.

The Address bar displays the complete path to the FTP site directory you are currently connected to.

The left side of the WS_FTP Pro window shows your local system, and where on that system you are. The Local Directory listing displays everything that is visible in the folder identified in the Local

System box.

Look for more information in the Viewing and

Navigating section of the

Online help. Local System Display Icon Up one Level Remote System Address Bar Remote Directory Local Directory Refresh Buttons Change Directory Button

(40)

Click the folder next to the local system box to select a new folder on your local system.

The right side of the WS_FTP Pro window shows the Remote System (FTP site) you are connected to. The Remote Directory listing displays everything that is visible in the folder identified in the

Remote System box.

The way these listings look can be changed by the Display Icons, and can be refreshed (to make sure you are looking at the most up-to-date list of files and folders) by clicking the Refresh button next to the directory list box.

Click the ChgDir (Change Directory) button to type in a folder or local drive you want to navigate to.

Thumbnails View

The thumbnails view lets you navigate remote folders with graphics displayed in smaller images called thumbnails. With this, you can see what is on the remote folder without having to remember the

filename.

To use this view, select Thumbnails from the View menu.

There are two options on the Program Options: Display dialog that are important to this feature:

• Download images from remote server to create thumbnails.

Select this option to have WS_FTP Pro download all images to create a thumbnails database for the remote server. If this option is cleared, WS_FTP Pro will only obtain thumbnails if the remote server already has a database.

• Synchronize remote thumbnails databases. Select this option

to have WS_FTP Pro upload the thumbnails database to the server once it has been created locally. Any further changes to the image list will be updated in both the local and remote thumbnail databases.

Working with Files and Folders

(41)

WS_FTP Pro

The graphic below points out key features used during these tasks.

The Command buttons are very important to managing your files. You can change the order of the buttons, and which buttons appear using the Program Options: Command Bar dialog. The following is a description of the buttons that pertain to this section:

ChDir - Change Directory. The ChDir command offers one way

for you to change to a directory on the current system.

MkDir - Make Directory. The Make Directory command

allows you to create a folder/directory on your PC or on the FTP site if possible. (Not all FTP sites allow you to create folders; you must have an account on the site and "create" permissions.) When you select this command, you are prompted for a folder name that is valid for the current system.

View. The View command allows you to view a file. If you select

a filename on an FTP site and then click View, the file is transferred to a temporary folder and is opened in the default text viewer.

Edit. The Edit feature allows you to edit remote files quickly and

without having to actively transfer them first.

Append. The Append command allows you to select one or

more files on the source system and transfer those files to the destination system, appending them to a destination file. (The source system is where the files are coming from.)

Files

Command buttons (Command Bars)

(42)

Execute. The Execute command allows you to open an

application on a remote server. When you select this command, WS_FTP Pro downloads the file to a temp directory and runs the application associated with the file. If there is no association available, the user will be prompted with the ‘Open With’ dialog.

Rename. Use Rename to change the name of a selected file or

folder.

Delete. The Delete command allows you to delete a file or folder

on your PC or on the current FTP site, if you have the appropriate permissions. Remote files do NOT go to the Windows Recycle Bin.

DirInfo - Directory Information. The Directory Info command

opens a text document that displays information about the current directory. This document opens in the default Text Viewer (as specified on the General tab of Program Options). WS_FTP displays as much information as the FTP site delivers. Depending on the site, for each file or folder within the current directory, the following information may be shown: size, type, permission, creation date, date last modified, and name.

Click and Drag for Organization

You can organize your files by clicking on the files and dragging them to the folder you want to move them to. This is not an FTP transfer when you move the file from one folder to another on the same system.

Active Edit

The active edit feature allows you to edit remote files quickly and without having to actively transfer them first. When you select a file and click Edit, the file will be opened in the application that it is associated with. If you want the file to be associated with an

application other than the default application, you have to configure it on the Active Edit dialog.

(43)

WS_FTP Pro

To configure an extension for active edit:

1 From the Program Options, select the Active Edit dialog. 2 Click Add to add a new entry, or select one from the list and click

Edit. The Active Edit Properties dialog appears.

3 Enter the extension or extensions separated by commas.

4 In the Editor box, select or enter the path to the application that you want to open the file in.

(44)

Changing the File Permissions for UNIX Sites

You can change permissions for a file or folder on a UNIX FTP site, provided you have permission.

1 Select the file or folder and select Properties from the right-mouse menu,

2 Select the desired options by clicking the appropriate check boxes.

3 Click the OK button.

Background Information

The table below shows how WS_FTP Pro check box options correspond to the possible values for Owner, Group, and Other as viewed in the ten-position value in the first column of a directory list for a UNIX site.

In the directory list, the first position indicates whether the item is a file (-, s, S, or t) or directory (d), while positions two through ten show If you attempt to change

permissions, check the message area or the log to see if you were successful.

Selected options in WS_FTP Pro Permissions in directory list none ---Execute --x Write -w-Write, Execute -wx Read r--Read, Execute r-x Read, Write

(45)

WS_FTP Pro

For example, find drwxr-x--x in the directory list. This expression is comprised of four parts:

d rwx r-x --x

First position indicates whether item is a file (-,s,S, or t) or directory (d) Positions 2-4 indicate Owner permissions: read, write, execute. Positions 5-7 indicate Group permissions: read and execute. Positions 8-10 indicate Other permissions: execute only.

(46)

(47)

39 Explorer Interface

WS_FTP Pro

Chapter 6: Explorer Interface

This chapter explains some of the differences in how the Explorer interface works as opposed to the Classic interface of WS_FTP Pro.

Overview

The following graphic points out key features in the Explorer Interface that make it different from the Classic Interface. The graphic represents the appearance of the interface after you make a successful connection to an FTP server.

Using the Explorer Interface

The following describes how to get started using the Explorer Interface.

Configuring a Site

Before making a connection, you must either select a preconfigured site, or configure a new site. To configure a new site:

Display button changes the way the files are displayed.

This pane displays the remote directory when connected to an FTP site, or local files when a local folder is selected.

The site icon changes when connected.

Site Icon Site folders. The + means that there are configured sites in the folder.

The status bar displays the current state of the interface. My Computer. Select

this item to view your local system and mapped drives.

Look for more detailed information in the Online Help. Most sections are applicable to the Explorer Interface.

(48)

1 Select the folder you want the site configured in. 2 Click the New Site icon on the toolbar.

3 Follow the directions on the dialog to create a new site. 4 Click Finish once you have gone through the process. Once you click Finish, the site will be added to the folder.

Making a Connection

Once you have a site configured, you can connect to the site. To do this, all you have to do is click on the site name in the left-pane. If the settings are correct, and the FTP site is accepting connections, the right-pane will display the remote directory once connected.

Note

The Explorer interface allows multiple connections to remote servers at the same time.

Transferring Files

Transferring files in the Explorer Interface is very much like the drag-and-drop feature of the Classic interface. To transfer a file:

1 Connect to a site.

2 Move to the directory that holds the file you want to upload, or to the directory in which you want to place a downloaded file. 3 Select the file or folder you want to transfer (You can select

multiple files by holding down the Ctrl key while you click on a file.) Files to be uploaded can be selected from the desktop or from the mapped drives in the Explorer Interface (above the sites list).

4 With the file(s) selected, drag them to where you want them transferred to. If you are uploading them, drag them to your remote directory on the FTP site. If you are downloading the files, drag them to your desktop or to the directory you want them in.

(49)

41 WS_FTP Transfer Manager

WS_FTP Pro

Chapter 7: WS_FTP Transfer Manager

This chapter includes the following topics:

• What is the Transfer Manager?

• Transfer Manager Dialogs.

What is the Transfer Manager?

The WS_FTP Pro Transfer Manager is the module of WS_FTP Pro that performs transfers. It is also useful to users as a tool that lets them view the progress of transfers, to schedule the transfer of multiple files, and to view logs for individual transfers.

Transfer Manager Dialogs

The following sections describe each of the dialogs and tabs that are encountered while using the Transfer Manager.

Transfer Manager Transfers Tab

The Transfer Manager dialog displays a list of all pending, paused, and failed transfers. To access this dialog from either WS_FTP Pro interface: From the View menu, select Transfer Manager.

• Source. The path and name of the file or folder that is to be

transferred.

• Status. The current status of the listed item.

• Transferred. The number of bytes transferred.

• Rate (KB/S). The number of Kilobytes being transferred per

second.

• Size. The actual size of the file in bytes.

• Time Left. The estimated time left until the transfer is complete.

Use the Batch Mode. You can use the Batch Mode to add requests to the Transfer Manager (Classic Interface only.)

Batch mode (Classic Interface only)

1 Connect to an FTP server. 2 Click the Batch Mode button. 3 Select a file or files and click the

transfer arrow. The file will be

placed in the FTP Transfer Manager.

4 Once you have added all of the files to the ‘batch,’ click the Batch

Mode button to take WS_FTP Pro

out of batch mode.

5 In the Transfer Manager, select the requests you want to execute. Hold down the Ctrl key to select multiple requests.

6 Once you take the client out of batch mode, it will execute the transfers.

How to...

(50)

Transfer Manager History Tab

The History tab of the Transfer Manager displays a list of successful transfers. This list can be sorted by clicking on the column headers.

• Transfer Arrow. The arrow on the far left side of the item

identifies what type of transfer was performed. An up arrow means upload, a down for download, and a left-right arrow is for site to site transfers.

• Date. This is the date and time the transfer was completed.

• Source. This is the site profile that was used to connect to the

source.

• Source Path. The path on the source directory from the root to

the transferred item.

• Source File Name. The name of the source file that was

transferred.

• Destination. The site profile and folder that was used to connect

to the destination.

• Destination Path. The path on the destination directory from the

root to where the transferred item was placed.

• Destination File Name. The name of the file after it has been

transferred.

• Size. The number of bytes transferred. Executing a file

Once a file is successfully transferred, you can select it and choose

Execute from the History menu. If it is a download, the destination

file will be opened in its associated application. If it is an upload, the source file will be opened.

How to...

Pause a transfer

To pause an active transfer from the Transfer Manager:

1 Select the entry.

2 From the Transfers menu, select

Pause.

You can also click the Pause button next to the status column.

How to...

Remove an item

To remove an item from the Transfer Manager:

1 Select the file you want removed. 2 From the Transfers menu, select

(51)

43 WS_FTP Transfer Manager

WS_FTP Pro

Clearing the History

You can remove items from the history list by selecting them and choosing Delete from the History menu.

You can remove all items by selecting Clear All from the History menu.

Request Properties

You can double click any item on the Transfer Manager dialog to view the Request Properties dialog for that item.

The following information appears on the File Properties dialog.

• Elapsed Time. The amount of time that has passed since the

transfer began.

• Contains. Number of files and folders contained in the request.

(Only displayed when a folder is selected)

• Transferred Bytes. The number of bytes transferred.

• Transfer Rate. The number of Kilobytes being transferred per

second.

• Transfer Mode. The mode the file was transferred in. • Attempts. Number of times the application tried to make the

transfer.

• Operation. The type of transfer being performed. Either Upload

or Download.

• Status. The current status code of the listed item. • Source. The path name of the source of the transfer.

• Destination. The path name of the destination of the transfer.

How to...

Schedule a transfer To schedule a transfer from the Transfer Manager:

1 Select a request, file, or folder. 2 From the Transfers menu, select

Schedule.

3 In the Schedule Item Properties dialog, the date, time, and frequency of the transfer. 4 Click OK to add the item to

(52)

Log Window

To view the log for an item, select the item, then from the View menu, select Log.

The log window will contain all actions that have been initiated for the selected transfer request, including pause and resume.

Refer to Appendix B for descriptions of error messages that may appear in the log.

Operation After Transfers

The Operations After Transfers submenu can be found on both the

Transfers and History menus. This submenu allows you to select the

following operations.

Exit Application. After the application finishes all active or

scheduled transfer requests, WS_FTP Pro will close itself.

Shutdown Computer. After the application finishes all active or

scheduled transfer requests, WS_FTP Pro will attempt to shut the computer down.

(53)

45 SSL Utility

WS_FTP Pro

Chapter 8: Security

This chapter describes the two security protocols found in WS_FTP Pro: SSL and SSH. It also explains how to configure WS_FTP Pro to use these protocols to make secure connections.

SSL

SSL (Secure Socket Layer) is a protocol for encrypting and decrypting data sent across direct internet connections. When a client makes an SSL connection with a server, all data sent to and from that server is encoded with a complex mathematical algorithm that makes it extremely difficult to decode anything that is intercepted. The following is a step by step illustration of how SSL works.

Step 1. The client makes the initial connection with the server and

requests that an SSL connection be made. If Implicit SSL is used, the initial connection will be encrypted. If Explicit is used, the initial contact will be ‘in the clear.’

Step 2. If the server is properly configured, the server will send to the

client its certificate and public key.

Step 3. The client compares the certificate from the server to a trusted

authorities database. If the certificate is listed there, it means the client trusts the server and will move to step 4. If the certificate is not listed there, the user must add the certificate to the trusted authorities database before going to step 4.

WS_FTP Pro. User s Guide. Software Version 8.0. Ipswitch, Inc.

WS_FTP Pro

User’s Guide

Table of Contents

Chapter 1: Introduction

Why FTP?

How FTP/SFTP Works

New in WS_FTP Version 8.0

System Requirements

Installing WS_FTP Pro

Logging Onto an FTP Site

Interfaces for Windows 98, 2000, ME, XP

and NT

Browser Integration

Other Ipswitch WS_FTP Products

Getting Updates and Giving Feedback

Accessibility

Chapter 2: Getting Started

Making your First Connection

Transferring a File

How to...

Anonymous Connections

Assistance Center

Using the Help System

Chapter 3: Connections

Using Site Profiles

Automatic Connections

Alternate Connecting Methods

Internet Connection Settings

Passive Mode

Chapter 4: Transferring Files

Ways to Transfer Files

Upload Wizard

Hotdrop Folder

Transfer Modes

Automatic Retry

Resuming a Failed Transfer

Multipart Transfers

Chapter 5: Managing Files and Folders

Viewing and Navigating

Working with Files and Folders

Active Edit

Changing the File Permissions for UNIX Sites

d rwx r-x --x

Chapter 6: Explorer Interface

Overview

Using the Explorer Interface

Chapter 7: WS_FTP Transfer Manager

What is the Transfer Manager?

Transfer Manager Dialogs

How to...

How to...

How to...

How to...

Chapter 8: Security

SSL