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

Transcription

1 User s Guide Software Version 7.0 Ipswitch, Inc.

2 Ipswitch, Inc. Phone: Hartwell Ave 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 2001 by Ipswitch, Inc. All rights reserved. IPing, the IPing logo, 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 First Edition Second Edition Third Edition Fourth Edition Fifth Edition Sixth Edition Seventh Edition

3 Table of Contents Chapter 1: Introduction Why FTP? How FTP Works New in WS_FTP Version System Requirements Installing Logging Onto an FTP Site Interfaces for Windows 95, 98, 2000, ME 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 Uninstalling Accessibility Chapter 2: Getting Started Making your First Connection Connection Dialog Toolbar and Buttons Connection Dialog Boxes and Options Transferring a file Toolbar Anonymous Connections Using the Help System Chapter 3: Transferring Files Ways to Transfer Files Using the Transfer Arrows Drag and Drop Copy and Paste Batch Mode Using the Transfer Manager Transfer Modes Passive Transfers Chapter 4: Managing Files and Folders Viewing and Navigating Working with Files and Folders Click and Drag for Organization Contents iii

4 Changing the Permissions for UNIX Files Background Information Chapter 5: Explorer Interface Overview Using the Explorer Interface Configuring a Site Making a Connection Transferring Files Chapter 6: WS_FTP Transfer Manager What is the Transfer Manager? Transfer Manager Dialogs Transfers Manager Dialog Request Properties Log Window Chapter 7: SSL Utility What is SSL? How to make an SSL connection Client Certificate Verification Generating a Certificate Selecting a Certificate Trusted Authorities Adding a Certificate Exporting a Certificate Removing a Certificate Non-Trusted Certificate Chapter 8: Synchronizing Files and Folders A Word of Caution Using the Synchronize Utility Example Exclusions Using the Synchronize Utility from the Command Line Chapter 9: 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 iv Contents

5 Chapter 10: 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 11: Scheduler Using the Scheduler Examples Adding a Script to the Scheduler Updating a Web Site on a Nightly Basis Chapter 12: Using Firewalls Multiple Firewalls Firewall Types Configuring a Firewall Using a Configured Firewall Chapter 13: Using the Command Line Basic Command Line Syntax Site Information Transfer Source Transfer Destination File Transfer Options Uploading Files Downloading Files Transferring multiple files from the same location Converting File Names to Lower Case File Transfer Modes Transferring Files with Spaces in the File Names Enclosing the Command Line in Quotes Using the MS-DOS Name Using a Batch File Multiple Folders or Commands Pre-scheduled Transfers ( Automated Transfers ) Transferring a Folder Containing Subfolders Using a Site Profile with a Host Name Extras Summary Appendix A: FireScript Editor What is a FireScript? Contents v

6 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 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 Cannot create file Can t get xxx host entry Can t set guest privileges Connection refused Directory identifier unavailable Disk quota exceeded Failed data channel File too large to download Illegal port command Invalid page fault Logon failure; Quitting MDTM Port command failed User access denied Index vi Contents

7 Chapter 1: Introduction This chapter offers an introduction to, a brief description of File Transfer Protocol, 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 7.0. A vast store of software applications, games, images, and other types of files are available on FTP sites all over the world. An FTP site is a computer system ( host ) that uses an Internet protocol called FTP, File Transfer Protocol. FTP offers fast and accurate transfer 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 Works File Transfer Protocol uses the client server model: one computer (the FTP 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. turns your PC into an FTP 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 contains an FTP server program. Once connected to an FTP site, you can download files, upload files, and copy files from one FTP site to another. Introduction 1

8 Your PC FTP site A FTP site B New in WS_FTP Version 7.0 Redesigned interface. Explorer interface is no longer tightly integrated with Windows Explorer but navigation remains similar for familiarity. New Wizard interface for adding new sites. (Classic and Explorer) Improved firewall support, allows scripting of custom firewall types. Transfer Manager allows pausing, restarting, scheduling and deleting transfers. Multiple transfers can be executed simultaneously or sequentially. Scheduler interface uses Windows scheduler to schedule transfers for future execution. URL bar in Classic allows a user to connect to an FTP site with minimal effort. New button bar in Classic allows quick access to common functions. System Requirements requires the following system resources: An Intel 386, 486, or Pentium processor Windows 95, 98, 2000, ME or NT Internet Explorer 4.02 or newer (does not have to be your default browser) 2 User s Guide

9 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 can 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. (ftpproec.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

10 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 95, 98, 2000, ME and NT provides two user interfaces: the Classic user interface, which runs as a standard Windows application, and the Explorer interface, which has the look of Windows Explorer. 4 User s Guide

11 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 shown under the words Local System. The current folder on the FTP site is shown under the words Remote System. 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. 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

12 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 Classic 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

13 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 Tools menu. 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 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

14 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: 1 In the window, click the Connect button. 2 In the Connection dialog box, open the 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 Service & Support link at the top right of the Web page. 3 Click Patches and Upgrades, and then click the link for the product. 8 User s Guide

15 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. We welcome your feedback on. Please e mail any comments and suggestions to feedback@ipswitch.com. Uninstalling The uninstall function can remove all files associated with WS_FTP Pro from your PC, including your configured sites. It also removes the Explorer icon from your desktop. To uninstall : 1 Click the Start button and select Programs -> Uninstall. 2 When prompted, choose Uninstall. 3 Follow the on screen instructions to uninstall. 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

16 10 User s Guide

17 Chapter 2: Getting Started This chapter describes how to get started using. The two main windows are mapped out for you, and in the sidebar are step-bystep 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 Connection dialog, select the folder you want to create the site profile in. 2. Click the New Site icon in the Toolbar. 3. In the Create a Site Profile named box enter what you want to call the site. 4. In the Host Name or IP address box, enter the internet address for the FTP site you want to connect to. 5. Click Next. 6. Enter the UserID and Password for that site. 7. 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. 8. Click Save to save the information with the site profile. 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 Connection dialog box 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 here. When you create a site of your own, this is where you set the host information. Getting Started 11

18 Connection Dialog Toolbar and Buttons Connect. After selecting or creating a site, click this icon to connect to that site. New Site. Click this icon to create a new site in the folder you select in the Configured Sites box. New Folder. Click this icon to create a new folder in the Configured Sites box. Delete Site or Folder. Click this icon to delete the folder or site you select in the Configured Sites box. Help. Click this icon to access the online help system. Save. Click this button to save the site information. You should do this when the site is first configured, and any time host information is edited. Advanced Properties. Click this button for more site configuration options. See the Online help for more information on the Site properties. Connect. Click this button to connect to the selected site. Cancel. Click this button to close the Connection dialog box. Connection Dialog Boxes and Options 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 and type the new name. Host Name. Every system (computer) on the Internet has an official host name and 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 12 User s Guide

19 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 16. 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 many 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 16. 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. Firewall. If you have to use a Firewall script to connect to an FTP server, select the type from this list. For more information on Firewalls, see Chapter 12: Using Firewalls on page 59. Passive Mode. Normally, when you connect to an FTP site, the site establishes the data connection to your PC (the client). However, if the site allows passive transfers, you can have your PC establish the data connection. We recommend that you use passive mode for most transfers. Note that passive mode may be required for users who are behind some types of router-based firewalls or behind a gateway requiring passive transfers. Secure (SSL). Select this option to make a secure SSL connection to the selected site. For more information on SSL, see Chapter 7: SSL Utility on page 33. Getting Started 13

20 Local Folder. If there is a folder on your PC that you want to use as your starting location when you connect to this FTP site, enter the path of the folder here. (For example, C:\) Comment. Enter any comment you would like to make about the site. 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. 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. 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. The following are boxes and window structures that are important in learning how to make an FTP transfer: Local System. This box displays 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. This box 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. 14 User s Guide

21 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 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. FTP Manager. Click this icon to display the Transfer Manager. For more information, see Chapter 6: WS_FTP Transfer Manager on page 29. 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. Options. Click this icon to access gram Options. 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. Help. Click this icon to access the online help system. Getting Started 15

22 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.) 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

23 Chapter 3: 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. This chapter includes the following topics: Ways to Transfer Files Transfer Modes Doing Passive Transfers Ways to Transfer Files allows you several ways to transfer a file. Using the Transfer Arrows Look for more information in the Transferring Files section of the Online help. 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 Download Arrow 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. 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 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. Transferring Files 17

24 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. When you release the mouse button, attempts to transfer the file to that location. Copy and Paste Right-mouse click a file, then select Copy from the pop-up menu. This will copy your file to the clipboard. Right-click where you want to transfer the file to, and from the right-mouse 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 place all transfers in the Transfer Manager for download. If you want to make an immediate transfer while in Batch Mode, without having it go through the Transfer Manager 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 6: WS_FTP Transfer Manager on page 29. Transfer Modes There are three modes that uses to transfer a file from place to place. Depending on the type of file, you may have to select this mode before you attempt to transfer a file. Transfer Mode 18 User s Guide

25 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 Binary Mode Auto 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. 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. If you turn on Auto mode, 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. Passive Transfers 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 errors Transferring Files 19

26 20 User s Guide

27 Chapter 4: Managing Files and Folders This chapter deals with using 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 Look for more information in the Viewing and Navigating section of the Online help. WS_FTP provides many tools and techniques for viewing and navigating files and folders. This section points out various structures on the window that allow you to view files and folders, and to navigate both local and remote systems. Display Icons Address Bar Local System Remote System Up one Level Local Directory Mapped Drives Remote Directory Change Directory Button Refresh Buttons The Address bar displays the complete path to the FTP site directory you are currently connected to. You can edit this path manually to navigate to the folders listed in the Remote Directory listing. When you do this, the Address bar stores the last five paths that have been entered. Managing Files and Folders 21

28 The left side of the 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. Click on one of the Mapped Drives icons in the Local Directory listing to access that drive. The right side of the 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. You can use the ChgDir (Change Directory) button to navigate by doing one of the following: Select the desired folder and click the ChgDir button. A dialog box appears, allowing you to enter the name of the directory you want to move to. To get a dialog box that asks for the folder name, make sure nothing is selected in the list box and click the ChgDir button. When you see the dialog box, you can also change drives by entering a drive letter followed by a colon (for example, d:). Working with Files and Folders Look for more information in the Working with files and folders section of the Online help. gives you a variety of features that make it quick and easy to organize, manipulate, and delete files and folders. 22 User s Guide

29 The graphic below points out key features used during these tasks. Connection buttons (Connection Bars) Folder Files The Connection buttons are very important to managing your files. The following is a description of the buttons that pertain to this section: 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 your temporary folder and is opened in the default text viewer. Execute. The Execute command allows you to open an application on a remote server. When you select this command, downloads the file to your Windows Temp directory and runs the application from there. 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. 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 Managing Files and Folders 23

30 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. Changing the Permissions for UNIX Files The selected options do not necessarily indicate the current permissions for the selected file or folder. You can change modes for a UNIX file on an FTP site, provided you have permission. 1 Select the file, select FTP Commands from the right-mouse menu, and then select chmod (UNIX). If you attempt to change permissions, check the message area or the log to see if you were successful. 2 Do one of the following: Select the desired options by clicking the appropriate check boxes. Enter a three- or four-digit number that represents the options (as described in the table below). 3 Click the OK button. Background Information Permissions can also be expressed as three- or four-digit values; for example: The first digit is interpreted as follows: 24 User s Guide

31 If the first digit is 1 (known in UNIX circles as the sticky bit ), it sets the link permission to directories or sets the save-text attribute for a file. If the first digit is 2, it sets the group ID on execution. If the first digit is 4, it sets the user ID on execution. The second digit expresses Owner permissions The third, Group permissions The fourth, Other. Four-digit values are used in the log, in the message area, and by some system administrators and ISPs. The table below shows how check box options correspond to the last three digits. The third column shows the possible values for Owner, Group, and Other as viewed in the tenposition value in the first column of a directory list for a UNIX site. Selected options in 2nd, 3rd, or 4th digit of 4-digit number Permissions in directory list none Execute 1 --x Write 2 -w- Write, Execute 3 -wx Read 4 r-- Read, Execute 5 r-x Read, Write 6 rw- Read, Write, Execute 7 rwx 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 the permissions for Owner, Group, and Other. For example, the value 751 corresponds to drwxr-x--x in the Managing Files and Folders 25

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

33 Chapter 5: Explorer Interface Unlike previous versions of, version 7.0 contains an Explorer Interface that runs independently of Microsoft Windows Explorer. Now, most of the functions of the interface work like the Classic Interface, and the speed and performance of the Explorer Interface has greatly increased. Overview Look for more detailed information in the Online Help. Most sections are applicable to the Explorer Interface. 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. Display buttons change the way the files are displayed. Site folders. The + means that there are configured sites in the folder. The site icon changes when connected. This pane displays the remote directory when connected to an FTP site. Site Icon The status bar displays the current state of the interface. Explorer Interface 27

34 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: 1 Select the folder you want the site configured in. 2 In the right-pane, select New. 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. Transferring Files Transferring files in the Explorer Interface is very much like the dragand-drop feature of the Classic interface. To transfer a file: 1 Connect to a site. 2 Open Windows Explorer. 3 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. 4 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 a Windows Explorer window. 5 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 Windows Explorer window. 28 User s Guide

35 Chapter 6: WS_FTP Transfer Manager This chapter includes the following topics: What is the Transfer Manager Transfer Manager Dialogs What is 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. How to... 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 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 From the Transfer menu, select Start. You can remove completed items individually, or you can select Remove Completed Requests from Transfer Manager on the General tab of the Options dialog. Transfer Manager Dialogs The following sections describe each of the dialog boxes that are encountered while using the Transfer Manager. Transfers Manager Dialog The Transfer Manager dialog displays a list of all pending, paused, and completed 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 code 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. WS_FTP Transfer Manager 29