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

Transcription

1 User s Guide Software Version 8.0 Ipswitch, Inc.

2 Ipswitch, Inc. Phone: Maguire Road Suite 220 Fax: Lexington, MA Web: 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 information 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 December 1996 July 1997 February 1998 October 1998 May 2000 June 2001 March 2002 August 2002 May 2003 First Edition Second Edition Third Edition Fourth Edition Fifth Edition Sixth Edition Seventh Edition Eighth Edition Ninth Edition Tenth Edition

3 Table of Contents Chapter 1: Introduction Why FTP? How FTP/SFTP Works FTP SFTP New in WS_FTP Version System Requirements Installing Logging Onto an FTP Site Interfaces for Windows 98, 2000, ME, XP and NT The Classic Interface of The Explorer Interface of Browser Integration Other Ipswitch ducts WS_FTP Server Development Kit Getting Updates and Giving Feedback Accessibility Chapter 2: Getting Started Making your First Connection Transferring a File Toolbar Anonymous Connections Assistance Center Using the Help System Chapter 3: Connections Using Site Profiles Connect to Remote Host Dialog Host Info Dialog of Site Options Organizing Sites Automatic Connections Connect to Default Site Open with last local and remote folders Alternate Connecting Methods Sites Menu Recent Sites Quick Connect Address Bar Contents iii

4 Internet Connection Settings Passive Mode Chapter 4: Transferring Files Ways to Transfer Files Using the Transfer Arrows Drag and Drop Copy and Paste Batch Mode Using the Transfer Manager Upload Wizard Hotdrop Folder Transfer Modes Automatic Retry Resuming a Failed Transfer Multipart Transfers Chapter 5: Managing Files and Folders Viewing and Navigating Thumbnails View Working with Files and Folders Click and Drag for Organization Active Edit Changing the File Permissions for UNIX Sites Background Information Chapter 6: Explorer Interface Overview Using the Explorer Interface Configuring a Site Making a Connection Transferring Files Chapter 7: WS_FTP Transfer Manager What is the Transfer Manager? Transfer Manager Dialogs Transfer Manager Transfers Tab Transfer Manager History Tab Request Properties Log Window Operation After Transfers Chapter 8: Security SSL iv Contents

5 How to make an SSL connection Client Certificate Verification Generating a Certificate Importing a Certificate Selecting a Certificate Trusted Authorities Adding a Certificate Exporting a Certificate Removing a Certificate Non-Trusted Certificate SSH How to make an SSH connection SSL vs. SSH Using a NAT Firewall To configure SSL through a NAT Firewall: Chapter 9: Synchronizing Files and Folders Using the Synchronize Utility Synchronize Dialog Example Using a Control File Exclusions Exclusion Examples Using the Synchronize Utility from the Command Line Chapter 10: The Find Utility Using the Find Utility Using the Search Results Examples Finding a File When You Are Not Sure of Its Name Finding a File Modified During a Specific Time Period Finding a File in a Particular Folder Finding a File Smaller Than a Certain Size Chapter 11: Scripting Using Scripting Writing and Debugging Scripts Executing Scripts Executing a Script from the Command Prompt Running a Script from the Scripting Utility Example Chapter 12: Scheduler Using the Scheduler Contents v

6 Examples Adding a Script to the Scheduler Updating a Web Site on a Nightly Basis Chapter 13: Using Firewalls Multiple Firewalls Firewall Types Configuring a Firewall Using a Configured Firewall Chapter 14: Using the Command Line Basic Command Line Syntax Site Information Transfer Source Transfer Destination File Transfer Options Uploading Files Downloading Files Renaming Files Transferring multiple files from the same location Converting File Names to Lower Case File Transfer Modes Transferring Files and Folders with Spaces in the Name Enclosing the Command Line in Quotes Using the MS-DOS Name Using a Batch File Multiple Folders or Commands Pre-scheduled Transfers ( Automated Transfers ) Extras Summary Appendix A: FireScript Editor What is a FireScript? FireScript Components The fwsc Section The Comment Section The Script Section The Connection Sequence The FireScript Language FireScript Variables String Expansion Function Expressions FireScript Statements Switch Statements vi Contents

7 Case Statements Examples of Case Statements Continue Jumps and Labels Return Autodetect SSL Statements FireScript Key Words FireScript reserved words FireScript statements FireScript intrinsic functions FireScript intrinsic variables Appendix B: Textual Error Messages Blocking call canceled Connection refused or Connection closed by remote Disk quota exceeded File too large to download Logon failure; Quitting MDTM User access denied Contents vii

8 viii Contents

9 Chapter 1: Introduction This chapter offers an introduction to, a brief description of File Transfer Protocols, system requirements, the installation procedure, information about software updates, and instructions for giving feedback to Ipswitch, Inc. Why FTP? 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. 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, will speed up the time it takes to copy such files to your PC. For more information, see Browser Integration on page 6. 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. Introduction 1

10 FTP 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), 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 You can find more information about SFTP in Chapter 8: Security on page 45 SFTP SFTP is a file transfer protocol that runs over a secure SSH (Secure Shell) client like. 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 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) 2 User s Guide

11 Installing If you are upgrading from a previous version of, 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. The installation of is the same for new users, those who are upgrading from a previous version of, and those who are replacing an evaluation version with a purchased version. To install from a downloaded file: 1 Double-click the file you downloaded. (wsftppec.exe) 2 Follow the directions on your screen. To install from a CD-ROM: 1 If you already have a previous version of on your system, make sure you are not running the application (either Classic or Explorer). 2 Insert the 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. Introduction 3

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 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. 4 User s Guide

13 The Classic Interface of 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 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 current folder on your PC is in this pane. The current folder on the FTP site is shown in this pane. This list box shows the files and folders in the current local folder. This list box shows the files and folders in the current folder on the FTP site. Status bars show a total or selected number of files and their combined size. The buttons to the right of each list box provide file and folder operations for that list box. The Explorer Interface of The second interface of 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. Introduction 5

14 The Explorer interface looks similar to one of the following: The appearance of the Explorer window is determined by your View menu options. Explorer interface Files and folders in the current folder Browser Integration Browser Integration is NOT compatible with Netscape 6. You can set up so that it automatically handles FTP URLs when you click them in your browser or in an 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 the FTP URL for the FTP site of Patches is ftp://ftp.ipswitch.com.) handles FTP URLs as follows: If the URL is the name of an FTP server, such as ftp.ipswitch.com, handles the URL by starting the Classic interface of and connecting to the site. 6 User s Guide

15 If the URL includes the path and name of a file, such as ftp.ipswitch.com/french/ftp605f.txt, 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, 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 to handle FTP URLs, select the first check box. 3 If you use Microsoft Internet Explorer and want 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, select Ask before using WS_FTP. Other Ipswitch ducts WS_FTP Server and the Development Kit can be purchased separately at 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. Introduction 7

16 Development Kit You can develop custom applications using the 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 To access upgrades on the Ipswitch FTP site (using the Classic interface): 1 In the 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 Patches. 3 Click Connect. connects to the 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 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 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: 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 folder or your Windows Temp folder. 5 Run the patch file to update the software. 8 User s Guide

17 We welcome your feedback on. Please e mail any comments and suggestions to feedback@ipswitch.com. Accessibility 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 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. Introduction 9

18 10 User s Guide

19 Chapter 2: Getting Started This chapter describes how to get started using. 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. How to... 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 Classic Interface attempts to make the connection. Making your First Connection The first time is run, the Classic Interface opens with the Connect to Remote Host dialog displayed. Some sites are set up for you when you install. 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. uses Site Profiles to store information it needs to make a connection to an FTP site. This information includes: Getting Started 11

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 In, 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 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, 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 window. The image below shows how the window looks once you have connected to a site. 12 User s Guide

21 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 Download Arrow Getting Started 13

22 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 System list. Toolbar 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 gram 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. Customizing the Toolbar You can modify the appearance of the toolbar by selecting the Toolbar dialog from the Program Options. 14 User s Guide

23 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 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 Assistance Center has been created to help new users get up and running with 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, 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 the Knowledge Base articles through this link. Getting Started 15

24 Using the Help System Our Online Help system contains detailed descriptions and directions on how to use each and every function available in. It should be the first place you look if you have any question using the product. Use the Index tab to look up keywords, and use the Search tab to search for words in the body of the topics. Individual topics are organized into books that relate to a specific function. Some books have other books listed inside. 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. 16 User s Guide

25 Chapter 3: Connections This chapter details the different ways users can make FTP connections using. Using Site Profiles Look for more information in the Connecting to an FTP Site section of the Online help. For most FTP connections, uses site profiles to store information it needs to establish the connection with the Server. These profiles control how 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. 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. Connections 17

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 Online Help system. Configured Sites. This box lists all of your configured sites. 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. 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 In, 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 information on connecting to sites you do not have an account on, see Anonymous Connections on page User s Guide

27 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 Host dialog. Connections 19

28 Automatic Connections Setting a default site To set a default site, rightclick on the site profile and select Default Site from the menu. If you have a single site that you connect to over and over again, you can have 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 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 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 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. 20 User s Guide

29 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 Quick Connect does not work for SSL or SSH connections. Connections 21

30 Address Bar The Address bar of the 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, 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:password@ftp.ipswitch.com:port/path. Example: robert:armstrong@ftp.ipswitch.com: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. 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 ) to have 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. 22 User s Guide

31 Connect using a dial-up connection. Select this option to have 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 to use here. Disconnect when application exits. Select this option to have 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 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 ; 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 cancelled errors. Connections 23

32 24 User s Guide

33 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 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. Upload Arrow Look for more information in the Transferring Files section of the Online help. Download Arrow Drag and Drop 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 of the Online help. 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 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. When you release the mouse button, attempts to transfer the file to that location. Transferring Files 25

34 Copy and Paste Confirming Overwrites Most sites allow you to overwrite or replace a file without giving you any kind of visual warning. Through, 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 of the Online help. 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 rightmouse menu select Paste. then attempts to make the transfer. Batch Mode If you want to transfer multiple files from different sites, you can put in Batch Mode. While in batch mode, 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 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 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. 26 User s Guide

35 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 Using Hotdrops Hotdrops are excellent ways for you to quickly upload files without having to launch. 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. 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, 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. Transferring Files 27