Cute FTP Manual
Cute FTP Manual
Cute FTP Manual
5
What Is File Transfer Protocol (FTP)? ....................................... 5 What Is CuteFTP Pro? ............................................................... 5 How Can You Use CuteFTP Pro? ............................................. 5
Index ............................................................................65
Introduction
What Is File Transfer Protocol (FTP)? File Transfer Protocol (FTP), a standard Internet protocol, is the simplest way to exchange files between computers on the Internet. Like Hypertext Transfer Protocol (HTTP), which transfers Web pages and related files, and Simple Mail Transfer Protocol (SMTP), which transfers e-mail, FTP is an application protocol that uses the Internets TCP/IP protocols. FTP is commonly used to transfer Web page files from their creator to the computer that acts as their server for everyone on the Internet. Its also commonly used to download programs and other files to your computer from other servers. To access an FTP server, users must have the ability to connect to the Internet (via a modem or local area network) and an FTP client program. What Is CuteFTP Pro? CuteFTP Pro is a business-class client for accomplished FTP users. It provides the same time-tested features contained in CuteFTP 4.0 and many new additions. CuteFTP Pro embodies the accumulated knowledge gained from the evolution of CuteFTP and imparts it in this well-designed, built from the ground up application. How Can You Use CuteFTP Pro? CuteFTP Pro offers a variety of features which enhance file transfer. The accessible interface allows even novice users to easily update and maintain corporate websites. The security features safeguard transfers of mission critical files. Multi-part accelerated downloads speed the transfer of large architectural, graphic, or engineering files. Site caching allows you to minimize bandwidth while you browse. You can even schedule and script FTP transactions with minimal overhead using the autonomous transfer engine.
At least 16MB of free memory Internet Explorer 4.0 or greater (5.0 or greater required for full functionality under Win2000) Approximately 5MB free hard disk space A connection to the Internet
Installing To Install from Download: Download the program at www.globalscape.com. Double-click the executable to run the install. Follow the on-screen instructions.
Note: If, during the installation process, you check Launch Connection Wizard on initial startup, CuteFTP Pro will launch the Connection Wizard upon startup to assist you with connections to FTP sites. Registering From the menu bar, choose Help > Enter Serial Number. Provide the necessary information and then click Register. You may also update your user information here. Manually Registering Use manual registration if server or Internet connection errors occur during the online registration. The fastest way to register manually is to choose Help > Enter Serial Number from the menu bar. Complete the required information and click Register. Another method of manual registration uses the Server Connection Error dialog box. In that box, click the Manual Registration button. Complete any missing information on the form. Click the Copy to Clipboard button in the Manual Registration dialog box. Address the e-mail to support@globalscape.com. Press the Control-V key to copy the clipboard contents (registration information) to the body of your e-mail. Send the e-mail. The GlobalSCAPE support team will reply with instructions and a file needed to complete the successful registration of your program. Uninstalling The uninstall function removes all files installed with CuteFTP Pro from your PC, including your configured sites. It also removes the CuteFTP Pro icon from your desktop. To uninstall CuteFTP Pro: Click the Start button, select Settings > Control Panel > Add/Remove Programs. Choose CuteFTP Pro from the list and select the Add/Remove button. Follow the on-screen instructions.
The main screen is used to transfer files to and from remote servers and is divided into three areas, or panes: a left pane, a right pane and a lower pane. Left pane (Local Window and Site Manager): The Local Window displays the selected directory from your hard drive and Site Manager. This pane also contains a tabbed interface; press tab to switch between your local drive and the Site Manager. Right pane (Remote Window): The Remote Window displays the files and directories of the remote server. Lower pane (Queue Window and Log Window): The lower window can display either the Queue Window or the Log Window. The Queue Window is used for temporary storage of files you wish to transfer at a later time. The Log Window allows you to view the log information of each session. This window also has a tabbed interface; simply press tab to switch between the Queue and the Log Windows.
Customizing the Main Screen CuteFTP Pro allows customization of its interface. Each pane described in the previous section can be resized, closed, or relocated to different areas of the screen. Note the X button on a corner of each pane which resembles a smaller version of the standard Windows close button. Clicking this button will remove that pane from the display. Moving and resizing the pane relies on first clicking a button which resembles a smaller version of the standard Windows resize button. Clicking this will undock the pane from the edge of the main CuteFTP Pro window and allows you to relocate and resize it. Move and resize CuteFTP Pro windows in the same way as any other window; click and drag in the title bar to move, click and drag in a corner to resize. To re-enable disabled panes, select the desired pane from the Window menu. The pane reappears and a check mark is displayed next to its name in the Window menu. Switch focus among CuteFTP Pros multiple windows by either clicking within the window you want to view or using keyboard shortcuts. Pressing Control + Tab will cycle between all open site and document windows in the remote pane. Note: Pressing Control + ~ (control + tilde) will cycle between all open panes. Establishing Your Internet Connection Before you can connect to your FTP site, you must be connected to your Internet Service Provider (ISP). Since virtually all ISPs differ in connection routines, following the specific instructions of your service provider is critical to ensure your computers connection to the Internet. NOTE: CuteFTP Pro can be set up to automatically connect to your ISP through Windows. Launching the Program To launch CuteFTP Pro, click on the Windows Start button and select Programs > GlobalSCAPE > CuteFTP Pro or double click on the CuteFTP Pro icon on your desktop. CuteFTP Pro will call the transfer engine upon startup and minimize it to the system tray, located in lower right-hand corner of your screen.
of asterisks. 5. Default Local Directory: This optional field is part of the Connection Wizard. Leave this field blank if you do not wish to specify a default directory. Enter information in this field if you wish to move to a specific local directory when you connect to the site being added. Other Methods for Adding a New Site Within the main screen, there are two popular methods for adding a new site. 1. Go to the menu bar, click File > New and then fill in the required fields. 2. Right click on a folder within the Site Manager and choose Add New Site. 3. After either of these choices, specify the type of site you want to add. 4. When the Site Properties Dialog Box (depicted below) appears, make sure . Only the fields in the General tab are required. 5. After making sure that all of the information is correct, click OK. Your new site will automatically be saved in the Site Manager.
To create a folder for your site, right click on a folder within the Site Manager. Choose New Folder. Enter the new folder name and click OK. You can now add new sites to this folder or drag existing sites into it. To connect to your new site, click Connect from within the Site Properties Dialog Box, or highlight the site name in Site Manager and do one of the following: 1. In the Menu, choose File > Connect. 2. Double click on the new site. 3. Right click and choose Connect. 4. Select the Connect icon on the toolbar.
10
NOTE: You can secure access to your sites by protecting the entire Site Manager with a password. CuteFTP Pro will ask for a password before allowing you to access any of the sites in the Site Manager when this option is enabled. Using Quick Connect This feature is useful for one-time connections. However, users have the option of adding the session to the Site Manager before terminating the session. To perform a quick connect, select File > Quick Connect from the menu bar, or click the Quick Connect icon, the lightning bolt, on the Toolbar. Enter the site address in the Host field, and a User Name and Password if necessary. Click the Connect icon on the right of the port field to connect. Using Connect to URL This feature saves time by utilizing the copy function to paste a URL into CuteFTP Pro. From any Windows application, highlight the URL. The URL may be general (ftp://www.globalscape.com) or specific (ftp://www.globalscape.com/ pub/cuteftp/cute2632.exe). Copy the URL to the clipboard. Return to CuteFTP Pro and select File > Connect to URL from the menu bar or press Control-U. Paste the URL into the Connect to URL window. Click OK. CuteFTP Pro will parse the URL and start downloading the file. The following formats are supported: ftp://user:pass@host.host.com:port ftp://user:pass@host.host.com ftp://user@host.host.com ftp://host.host.com:port ftp://host.host.com ftp://ftp.sitename.com/pub l: user p: pass ftp://ftp.sitename.com/pub:44 l: user p: pass ftp://ftp.sitename.com/pub port:44 l: user p: pass ftp://ftp.sitename.com/pub l/p: user/pass ftp://ftp.sitename.com/pub:44 l/p: user/pass ftp://ftp.sitename.com/pub p:44 l/p: user/pass ftp://ftp.sitename.com/pub port:44 l/p: user/pass ftp://ftp.sitename.com/pub l: user p: pass ftp://ftp.sitename.com/pub:44 l: user p: pass ftp://ftp.sitename.com/pub p:44 l: user p: pass ftp://ftp.sitename.com/pub port:44 l: user p: pass Connecting to HTTP Sites CuteFTP Pro includes a method for connecting to and browsing the contents of Hypertext Transfer Protocol (HTTP) sites. Choose the File Menu > New. Select HTTP site When the Site Properties dialog box appears, type in the host, user name and password. Then click Connect. See Site Properties Dialog topic for further instructions.
11
Connecting to Secure HTTP (HTTPS) Sites HTTPS (Secure HTTP) connections are initiated in the same manner as regular HTTP site connections. If a sites certificate appears unusual or does not match the operators name, it is suggested you reject the request. Connecting to Secure FTP (SFTP) Sites In order to connect to Secure File Transfer Protocol (SFTP) sites, choose File Menu > New. Select SFTP Site. When the Site Properties dialog box appears, enter the host name and your user name and password. Connecting to Sites Using Secure Socket Layer (SSL) Secure Socket Layer (SSL) is a public key based security protocol. In order to secure your communications to and from a new site using this encryption method, choose File Menu > New. Select FTP with SSL site The Site Properties dialog box will appear. Type in the host, user name and password and then click Connect. In order to apply SSL for any existing site in your Site Manager: 1. Right click on the site and select Site Properties. 2. When the Site Properties dialog box appears, go to the Type tab. 3. Choose FTP w/SSL Implicit or FTP w/SSL Explicit. Both Implicit and Explicit SSL will provide file transfer security. Implict means that the SSL will be used automatically before connection, securing all file transfers to or from that site. This ensures that you will not forget to engage the protocol. Explicit SSL, on the other hand, engages after connecting over the standard port. Once engaged, however, neither protocol can be disengaged. Depending on which one you choose, the appropriate port will be selected. Certain servers support only one of the two methods. Maintaining a Connection with Smart Keep Alive (SKA) CuteFTP Pro compensates for idle time during sessions by using the Smart Keep Alive (SKA) feature. This feature is completely configurable, and assures that CuteFTP Pro will remain connected to a server. SKA sends commands at random intervals to the FTP server, which maintains an active connection. In order to enable Smart Keep Alive: 1. Go to Edit > Global Settings > Connection > Smart Keep Alive. 2. Click in the box next to Smart Keep Alive. When checked, Smart Keep Alive will be active when connected to any FTP site. 3. You may want to configure this option before exiting: Underneath the place you enable SKA, you have several other ways to configure this option. Start SKA ____ seconds after the last command: CuteFTP Pro will begin using SKA after the specified idle time. Maintain SKA for ____ minutes: CuteFTP Pro will maintain a connection to the FTP server for the specified length of time.
12
Send command at random intervals between ___ and ___ seconds: Commands will randomly be sent to the server between the intervals specified. Have SKA use these commands in random order: Click Add or Remove to customize the commands listed. CuteFTP Pro will issue a random command in the list when utilizing SKA. Enable auto-reconnect if booted from the server using a__ second delay: If the server terminates the connection, CuteFTP Pro will automatically reconnect to the FTP site. Disconnecting and Reconnecting In the event of a broken connection or the need to stop a process, you may use either of the following: To Disconnect: From the menu bar, click File > Disconnect or click the Disconnect icon on the Toolbar or choose Control-F4 on the keyboard. To Reconnect: From the menu bar, click File > Reconnect to reconnect to your most recently used site or choose the site from the MRU List (most recently used) under the file menu. Browsing Sites Offline CuteFTP Pro allows users to browse the cached contents of sites without connecting to them. When you connect to a site, CuteFTP Pro automatically stores the sites contents to your local drive. In normal operation, this cache is used to speed access times by eliminating duplicate downloads. CuteFTP Pro will check to see if a file is in the cache before transferring it, and use the local copy if it exists. This feature can also be used to view the contents of sites without connecting to those sites or even connecting to the Internet at all. Beginning toBrowse a Site in Offline Mode Right-click on the sites Site Manager entry and choose Browse Offline. A remote window will open showing the sites cached contents. The status bar of the remote window will indicate offline status, and display the date/time the site was cached. You can navigate through whatever directories are cached, but if you attempt to navigate to a non-cached area of the site, CuteFTP Pro will try to connect to that site. If you have never connected to a site and choose to browse in offline mode, CuteFTP Pro will make a normal connection. The status bar will indicate Connected to show that CuteFTP Pro was unable to browse the site in offline mode.
13
Connection Properties These options set the general connection properties and are found under Global Settings > Connection. E-mail Address (for anonymous logins): Type the e-mail address you want to use for anonymous logins. You can use your actual or simulated e-mail address. Connection Type: Choose one of the following connection types. Pasv: CuteFTP Pro uses PASV Mode to initiate all connections while the server only waits for requests. When active, this feature helps avoid conflicts with the security system. For both security and connection reasons, CuteFTP Pro supports the standard PASV Mode connection. A PASV request asks the server to accept a connection on a new port selected by the server. All servers that support file transfers are required to support PASV Mode. Many FTP clients rely on PASV and will give up on a file transfer if PASV is rejected. An FTP client with PASV support is necessary for some firewalls, because FTP usually tries to open the dataconnection from the server to the client. The FTP PASV-command tells the FTP server not to open a connection and instead wait for the client to open the connection. Port: Another standard connection method utilized by FTP clients is the PORT method. When an FTP client connects using PORT, it will tell the server which IP address to connect to and which port to open at that address. Connection Retry Attempts: You can customize CuteFTP Pros retry options by setting retry and retry delay options. This feature is great for busy FTP sites that require multiple retries to connect. Delay Between Retries: Your timing choice tells CuteFTP Pro how long to wait after an unsuccessful attempt before trying to connect to the server again.
14
login will automatically be supplied to the server, and then a second login will occur using the supplied user name and password. Once you have filled in the above fields, you will have provided enough information to connect to a site. Click on Connect or click on the other tabs for additional configuration options. Under the Type Tab: Protocol Type: This drop down field reflects your chosen connection protocol. Port: The default port for your chosen connection protocol is entered in this field already. Host Type: By default, CuteFTP Pro will automatically detect which type of server (host) it is connecting to. The drop down list may be used to select a server if problems occur in connecting to a specific host. Data Connection Type: If not specified, each site will automatically use CuteFTP Pros Global Settings by default. (The default data connection type is PASV.) However, you can directly choose either PASV or PORT. PASV Mode is recommended over PORT since it is more difficult to protect against port connection theft. Password Protection: Select a method of password encryption here. Please refer to the Password Encryption section for more information. Transfer Type: Select one of the following three radio buttons to specify which method will be used to transfer files. Ascii: This radio button forces all file transfers in ASCII (plain text format). Binary: This radio button forces all file transfers in binary mode. AutoDetect: CuteFTP Pro defaults to AutoDetect which determines if the files should be transferred using ASCII or Image (Binary) protocols. Under the Actions Tab: Upon Connection Switch to this Remote folder: Specify the initial remote folder (path). Upon Connection Switch to this Local folder: Specify the initial local folder (path). For Navigation use the following caching options: CuteFTP Pro can cache (store in memory) folder listings of a remote site. This is useful for various reasons. Large folder listings (previously visited) will load almost instantly if pulled from cache; this is especially useful when you want to pull these listings using a slow modem. Storing in cache also allows you
16
to go offline (see: Browsing Sites Offline) and still browse the site, minimizing bandwidth usage. The three cache options are: Use cache during the session: The listings will be reloaded every time you connect to the site, but they will be cached as you navigate through the site. Always use cache: This choice requires CuteFTP Pro to retrieve the listing (if available) from memory. Do not use cache forces: This choice requires CuteFTP Pro to always reload listings. NOTE: A cache of sites will expire after 30 days. If you always use cache for a particular site, CuteFTP Pro will reload it upon expiration when you next visit the site.
Under the Options Tab: Site specific configuration options: Either choose Global Settings for all options or choose the Use site specific option. Apply auto-rename scheme to transfers: Use the configured autorename scheme when transferring files to and from this site. Please refer to the Rename Rules section for more information. Display folder simple listings [raw listing]: Use the raw listing command when having difficulties seeing any listing on the remote server. This works with certain MVS hosts and other non-compliant FTP servers. CuteFTP Pro Version 1 Users Guide
17
Using raw listing will affect other settings in CuteFTP Pro and should only be used as a last resort. Site specific firewall settings: When Use site specific is chosen as the configuration option, the following two buttons will be active. Proxy: This button will activate the proxy settings dialog box. See Proxy section for more information. Socks: This button will activate the SOCKS settings dialog box. See SOCKS section for more information. Retries/Delay between retries: The Connection Retries field specifies how many times CuteFTP Pro should attempt to connect to the server. The Delay Between Retries field tells CuteFTP Pro how long to wait after an unsuccessful attempt before trying to connect to the server again. Locating Sites in Your Site Manager Locating sites in your Site Manager is easily achieved in one of two ways. 1. From the menu under File > Site Manager choose Find > Site Manager (binocular icon). Type in the site you are trying to locate. Click OK or Cancel. 2. Right click and choose Find in Site Manager (binocular icon). Type in the file you wish to locate. Click OK or Cancel. Choose Site Manager Tab. Choose the Binocular icon from the Toolbar. Type in the file you wish to locate. Protecting Your Site Manager Make sure that CuteFTP Pro is password protected. Click on File > Site Manager > Site Manager Security > Set Password. Enter a password and write it down for future reference. The next time you open CuteFTP Pro, you will be prompted for a password. If you forget your password, CuteFTP Pro can back up your existing Site Manager database file and create a new one. Importing Site Lists from Other FTP Clients CuteFTP Pro can automatically merge other clients site listings into your Site Manager, making your transition to CuteFTP Pro almost effortless. CuteFTP Pro can convert the following clients site listings: CuteFTP 4.0 and up CuteFTP 1.4-2.0 WS_FTP 5.0 and up LeapFTP 2.7 TransSoft 4.4 Crystal FTP 2000 CuteFTP 3.0-3.5 CuteFTP 1.3 FTP Voyager 6.0 and up CoffeeCup 4.0 LapLink 2.0 FTP Explorer 1.0 BlueZone 1.01 FTP Commander 4.0
18
To import site listings: 1. Select Site Import Utility from the Tools menu. 2. Select your old FTP client from the Choose FTP Client Type pop-up menu. 3. Enter the path to your old client site list, or click the folder icon to find it using a standard Windows Open dialog. 4. Select Merge site entries in the Conversion Type section. 5. Press Start Conversion to begin. To write other clients site listings to CuteFTP Pro: 1. Select Create a New CuteFTP Pro Database instead of Merge Site Entries. 2. Check the Create radio button. 3. An additional field will appear, allowing you to select the name of the output file. 4. Replace CuteFTP Pros Site Manager database (sm.dat) with this file. NOTE: Do not overwrite CuteFTP Pros sm.dat file while CuteFTP Pro is running. CuteFTP Pro automatically saves its sm.dat file upon exit. This means that if you replace the sm.dat file while the program is running, CuteFTP Pro will replace it again when you exit, resulting in the loss of your replacement file. Exporting Site Manager Listings CuteFTP Pro also allows you to export Site Manager listings as a text file in two different formats. You may export the listings as URLs only, or as a more detailed listing of host names, directories and descriptions. The exported text files could be used in several different ways. For instance, you might send them to friends who use other FTP clients or use them to create a web page of links. To export site listings as a text file: 1. Select File > Site Manager > Export Site Info, or right-click in the Site Manager window and select that menu item. 2. Click Save in the Save As dialog box.. To export site listings as a detailed text file: 1. Choose File > Site Manager > Export Site Info > Full Site Info. 2. Enter a name for your exported text file in the standard Windows Save As dialog box that appears. 3. Click Save. To export site listings as URLs: 1. Choose File > Site Manager > Export Site Info > As URL. 2. Click Save in the Save As dialog box.
19
Using Standard File Transfer Options There are several options for standard file transfer. Menu Choice: To upload, select a file from the local window and select Upload from the Commands menu. To download, select a file from the remote window and select Download from the Commands menu. Drag and Drop: Select a file from the remote window and drag it into the local window, or vice versa. The file will be transferred to (or from) your computer. Double-click: Double-clicking a file in the remote window will download it to the folder currently selected in the local window. Double-clicking a file in the local window will transfer it to the remote system. The functionality of doubleclicking can be changed in the Navigation Settings section of Global Settings. In addition to transferring immediately, your options are Add to Queue & Suspend, Launch in Viewer, Execute, and Edit.
20
Keystroke: Select a file from the local window and press Control-PgUp to upload it to the remote system. Select a file from the remote window and press Control-PgDn to download it to your local drive. Right-click: Select a file from the local window, click the right mouse button and select Upload to send the file to the remote system. Select a file from the remote window, click the right mouse button, and select Download to retrieve the file to the local system. Cut/Copy & Paste: Selecting a file and choosing Copy from the Edit menu (or pressing Control-C) allows you to transfer the file almost anywhere. Paste the file by selecting Paste from the Edit menu (or pressing Control-V). Files can be pasted into the remote window to upload, or into the local window, Windows Explorer, or Windows Desktop to download. Using the Queue To Transfer Files Files may be added to the queue using most of the methods under the Transferring Files section and then batch transferred manually at a later date. Just click on the Transfer Queue button on the Toolbar. Many queue functions can be accessed by using the right-click menu in the Queue Window. The Queue Window (as well as the Transfer Engine) comes complete with helpful columns to assist you in gathering information concerning the transfer. These columns can be easily added or removed from the Queue Window with a simple right click to the column name. A drop down list will appear; using this you will be able to select or deselect columns to customize the appearance. The columns are: the items name, upload/download label, size of file, progress measured with a color coded percentage bar, the name of the local and remote folder, elapsed time, time left, speed of transfer, type of transfer (i.e. multipart, normal), and status of transfer (i.e. scheduled, finished, etc.). NOTE: The elapsed time column estimates the amount of time left for the selected transfer. If the item is a top level item (such as folder or multi-part file) then the time will show the largest time listed in one of the child threads. If multiple items are being transferred in the queue, the estimated time is based upon the queue item with the largest amount of transfer time. To add items to the Queue: 1. Highlight the file(s). 2. Select Commands > Queue Commands > Add Selected to Queue from the menu bar. To remove items from the Queue: 1. Highlight a file listed in the Queue Window. 2. Select Commands > Queue Commands > Delete Selected from Queue. 3. Click YES in the Delete Confirmation dialog box.
21
NOTE: Remove All Items will delete every file in the queue. Remove Finished will remove items that have completed their transfer. Transferring Queued Items: Select Commands > Queue Commands > Queue Commands Items to initiate the transfer of queued files. Editing the Queue Entries: Highlight a file listed in the queue window. Select Commands > Queue Commands > Edit Item Properties. Edit the information of the Local file as necessary. Edit the Remote file information as needed. Accomplishing Multiple Concurrent Transfers You can now browse multiple FTP sites and transfer files from them simultaneously. This gives users the much requested threaded transfer ability, allowing full control over their sessions activities, limited only by their hardware and bandwidth. CuteFTP Pro can open multiple sessions to an FTP site as needed, allowing you to transfer files simultaneously from the same or disparate sites or simply browse multiple sessions at the same time. One of the benefits of this new feature is the ability to connect to two different sites, tile corresponding windows, and then initiate a Site-To-Site transfer. (See Performing Site-to-Site Transfers.) Using Multiple Concurrent Transfers Multiple Concurrent Transfers are a built-in function of the program and not a special command that you need to invoke. To accomplish this type of transfer, simply connect to multiple sites from the Site Manager. This feature also allows you to transfer files from a site while you continue to browse folders on that same site during the transfer. The seamless integration of this feature, and all of its added advantages, should be so natural that your user experience with this feature will seem effortless. Performing Site-to-Site Transfers CuteFTP Pro allows users to perform direct Site-to-Site transfers, simplifying the process of transferring files from one server to another. A Site-to-Site transfer can greatly expedite a large file transfer, by utilizing the bandwidth between the sending and receiving servers. Instead of downloading the file from one server to your PC and then uploading it to another server, enjoy the benefit of Site-to-Site transfers. To perform a Site-to-Site transfer: 1. Connect to each site (source and destination). 2. Drag the file from one remote window to another. 3. Follow the progress of your transfer. The log window will display a double arrow (<- > ), which indicates a Site-to-Site transfer. Once the transfer is complete, the progress bar in the Queue window will show 100% and the status column will display finished.
22
Another way to perform a Site-to-Site transfer: 1. Connect to the source site. Select a file in the remote window. 2. Choose Download Advanced from the Commands the menu. 3. Select Site-to-Site Transfer To: [select destination site] Note: Because Site-to-Site transfers may be considered a security risk, some servers may not be formatted to support them or may decline to support them. Performing Multi-Part Downloads CuteFTP Pro brings unprecedented power to your FTP transfers. Certain files can be downloaded in multiple parts to maximize your bandwidth. This means that a single file is transferred in two or four parts simultaneously, greatly increasing the overall speed of the transfer. Multi-part transfers will break up a file and transfer all of the parts simultaneously (when using MAX priority), increasing the speed of the transfer by a power of four. EXAMPLE: If the user can receive at 300 kb a second, but the server can only transfer at 20 kb a second, CuteFTP Pro can speed up the transfer to 80 kb a second. To transfer a file in multiple parts: 1. Highlight the file in the remote pane. 2. Right-click the file. 3. Choose Download Advanced > Multi-part Download > HIGH or MAX. This can also be accomplished from the Commands menu on the menu bar or from the Download icon on the toolbar by clicking on the small arrow next to the icon. The majority of the transfer occurs primarily in the background of the application, but you can quickly gauge the effectiveness of the transfer by highlighting the transferring item in the queue pane and clicking on the small plus sign + next to the item name. The item will expand to show you all parts of the transfer with the average speed of each part. Multi-part transfers will not occur: for files less than 100 kb in size (please refer to Transfer Settings for information on adjusting this parameter). for sites that do not support resume downloading.
if the FTP site does not allow multiple simultaneous connections from the same user or IP address.
Multi-part transfers are not very effective: for transfers within your own network because they can only transfer as fast as your Ethernet can handle them. for modems slower then 56 kb. This is because most FTP servers can at least transfer at that speed. for encrypted transfers via SSH and SSL. Due to the servers added processor overhead of generating these encrypted transfers, multi-part CuteFTP Pro Version 1 Users Guide
23
downloads over these two secure protocols can be ineffective and are not recommended. Manually Getting a File Use this function to download a specific file if you know its exact folder location. From the menu bar, click Transfer > Manual Get. Type in the path of the file to be downloaded and click the OK button. Stopping, Resuming, and Using Persistent Transfers CuteFTP Pro allows for easy transfer management. You may stop, resume, or use the persistent transfer methods to resume and complete transfer requests stopped by a broken connection. In the event of a break in communication or other interruptions during file transfers, CuteFTP Pro will automatically take action to complete the transfer process without user intervention. The following describes CuteFTP Pros response to various situations. CuteFTP Pro: Monitors the transfer for server disconnections. If a user is downloading a file and the transfer is broken (by the server) then CuteFTP Pro reconnects and resumes the transfer automatically. Detects a broken network connection. If a file is being transferred and the connection is broken (i.e. the modem disconnected, a network failure, etc.) CuteFTP Pro uses dial-up networking to resume the transfer. Similarly, CuteFTP Pro detects restored network connectivity and restores a broken transfer. Determines that a server is no longer responding and attempts to restore the connection and broken transfer. In some cases it is necessary to monitor the rate of transfer in order to detect that the connection to the server is broken. In this case, a minimum transfer rate may need to be adjusted. For example, 0 bytes received in the last 20 seconds might need to be the initial condition to assume a broken connection. Adjusts for permissions. If a server does not allow downloading/uploading, the conditions are taken into account (e.g. ratio server) and CuteFTP Pro warns you before attempting to download/upload multiple files. Monitors the queue session. CuteFTP Pro holds files in queue even after the program is closed or disconnected. The next time the program is launched, it remembers all of the site-specific information (as to each files location local/remote path) so that when you hit Commands > Queue Commands > Transfer Queue on the menu bar, it reconnects to that site and grabs the files.
24
Automatically reconnects and resumes the transfer of files. CuteFTP Pro remembers which files were successfully transferred before the disconnection and will resume the transfer where the last session ended. Remembers broken transfers from previous sessions. CuteFTP Pro remembers these broken transfers and continues the transfer when the software is launched again. Allows users to stop a transfer. In order to stop a transfer, select the Commands > Stop icon from the menu bar. You can also press the F9 key or the Stop button on the Toolbar. Resuming Incomplete Transfers If the connection breaks while you are downloading or uploading a file, CuteFTP Pro will automatically reconnect or keep trying to connect until the transfer is successful. (See Stopping, Resuming, and Using Persistent Transfers for more information.) In rare cases involving power failure or when the application is prematurely shut down, the transfer may not automatically resume. If this occurs, check to see if the incomplete transfer is still in the queue. If it is, click on the icon to resume the transfer. If the item is no longer in the queue, you must manually go back to access the site where the transfer was broken. In this instance, CuteFTP Pro sees that you are replacing an existing file and it may ask to Resume, Overwrite, or Skip, the file, depending on the default action and any Smart Overwrite rules you have defined. Choose Overwrite if you are replacing the file. Choose Resume to complete a broken transfer, or Skip to cancel the operation. Using CuteFTP Pros Autonomous Transfer Engine Built on a modular design platform, CuteFTP Pros FTP Transfer Engine (TE) is completely independent of the main applications interface. Current and future uses of this feature include the Transfer Engine serving as a download manager, continuing transfers after closing the main application, API and COM support for application developers seeking a canned FTP solution, and more. CuteFTP Pro has harnessed time-tested FTP code into this powerful FTP Transfer Engine. The Transfer Engine (TE) is represented by a yellow, rectangular icon in the systray, or bottom right corner of your screen. When CuteFTP Pro is launched, the TE is also launched. The TE is closed when CuteFTP Pro is closed, unless otherwise specified. One of the most powerful aspects of the Transfer Engine is that it is COM-enabled. This allows you to execute scripts to drive FTP commands in the TE. If specified in Settings, the TE can remain open even after the main CuteFTP Pro program is closed. This will allow CuteFTP Pro to finish any pending or inprogress transfers. The TE will remain open until manually closed. CuteFTP Pro Version 1 Users Guide
25
By right-clicking on the TE icon located in the systray, you will be able to access the current download queue (only visible if the main program interface is closed), restore the main program interface, or close the TE.
down menu. This action will take you to the parent folder (the folder above the current one). 6. In the Remote Browser pane, click on the drop down menu to select previously visited folders. Refreshing Folders In order to refresh your directories, click the Refresh button from the toolbar, press F5, or right click in a blank area of the remote pane and select Refresh. Utilizing Folder Synchronization Folder Synchronization is another of CuteFTP Pros useful new features. Folder Synchronization allows you to duplicate a remote folder on the local drive, or vice versa. The most common use for this feature is in maintaining a local working folder for files that reside on the remote server. Folder Synchronization eliminates the task of remembering which files have been edited and need to be transferred. Folder Synchronization can be combined with CuteFTP Pros powerful scheduling feature to accomplish recurring or continuous mirroring of a particular directory. This is useful if you want to have your Web site updated automatically every few minutes. CuteFTP Pro can accomplish this without the main application interface open through its powerful Transfer Engine. To perform folder synchronization: 1. Make sure that you are connected to the site. 2. Navigate to the desired folder in both the local and remote window. 3. Choose Folder Synchronization Tool from the Tools menu, right-click in the remote pane and choose Folder Synchronization Tool, or press F11. 4. The Folder Synchronization dialog box will pop up with the currently selected local and remote folders in the local and remote path fields. Check to make sure that you navigated to the correct folder before beginning the process. If you forgot, you can manually enter the desired directories into these fields. 5. The Folder Synchronization tool also asks for the direction of synchronization. Choose the direction you intend to synchronize. There are four options: Mirror local - makes the contents of the remote drive exactly like the contents of the local drive. Mirror remote - makes the contents of the local drive exactly like the contents of the remote drive. Mirror both - is used when both directories have been changed and need to be updated. Force binary transfers - forces binary transfers through your server, which means that file size will not be changed in the transfer. This is useful when users want to compare or mirror two directories. CuteFTP Pro Version 1 Users Guide
27
If the Include Subfolders box is checked, CuteFTP Pro will include the contents of all subdirectories when performing folder synchronization. Clicking the Advanced button displays a few additional options, described in Advanced Options. When you are done configuring the Folder Synchronization tool, click the Play button to begin folder synchronization, the Schedule button to schedule your transfers, or the Stop button to cancel. The following examples show the way that different folder synchronization options work. (NOTE: This behavior may be customized through the Advanced settings, described in the next section.) Before: Local Directory File1.doc, 12/1/00 File2.doc, 11/1/00 File3.doc, 12/1/00 After a Mirror Local: Local Directory File1.doc, 12/1/00 File2.doc, 11/1/00 File3.doc, 12/1/00 Remote Directory File1.doc, 11/1/00 File2.doc, 12/1/00
Remote Directory File1.doc, 12/1/00 The newer version of this file is uploaded. File2.doc, 12/1/00 This file isnt uploaded. The local version is older. File3.doc, 12/1/00 This file is uploaded because it is not present.
After a Mirror Remote: Local Directory Remote Directory File1.doc, 12/1/00 File1.doc, 11/1/00 No action is taken because local version is newer. File2.doc, 12/1/00 File2.doc, 12/1/00 The newer version of this file is downloaded. Note: File3.doc has been deleted from the local folder. After Mirror Both: Local Directory File1.doc, 12/1/00 File2.doc, 12/1/00 File3.doc, 12/1/00 Remote Directory File1.doc, 12/1/00 This file is uploaded. File2.doc, 12/1/00 This file is downloaded. File3.doc, 12/1/00 This file is uploaded.
Using Advanced Options for Folder Synchronization You may want more carefully configure your folder synchronization. If so, choose Folder Synchronization Tool from the Tools menu, right-click in the remote pane and choose Folder Synchronization Tool, or press F11.Clicking on the Advanced button expands the Synchronization Tool dialog box to display a few more options. For matching filenames always: This setting controls the action taken by CuteFTP Pro when synchronizing files with identical names. The default action, Use global overwrite settings can be set in the Global Settings dialog box.
28
There are three other choices: Overwrite: Copies the file with the more recent date (this is the behavior demonstrated in the above example). Numerate: Copies both files and number them to distinguish between the two. Skip: Iignores matching files, and only mirrors those files not yet present on the other system. Ignore symbolic links. This option, on by default, prevents CuteFTP Pro from following symbolic links when mirroring subdirectories. This option should be left on unless symbolic links are absolutely needed. If a symbolic link points to a spot further up the folder tree from where the mirroring began, disabling this option can result in an infinite loop condition. When one-way mirroring, delete the destination file if it does not exist in the source folder. This will make the mirrored folder a strict duplicate of the source folder, not only updating old files but deleting unused files. When disabled, any extraneous files present in the mirrored folder will be left in place. Always prompt before deleting. Disabling this option will turn off the file deletion confirmation notices, which can be useful when unattended or automated operation is required. Remote file names that differ only in case: This setting tells CuteFTP Pro what to do with files having identically-spelled but differently-cased names. The options are: Transfer first file only and skip others, numerate files, or show rename prompt. Since Windows file systems do not support differently-cased file names, you may want to use this option when working with file systems like Unix, which do support differentlycased file names. Continuous Synchronization To perform Continuous Synchronization of two folders, set up your mirroring options as instructed above, and then click on the Schedule icon, rather than the Play icon. When the Scheduler appears, set your start time, enable recurrence and set the recurrence value. Once that is done, the item will be added to your Queue. You can close CuteFTP Pro if you want, since the Transfer Engine (represented by the icon in the Systray) will handle the mirroring and scheduling. Sorting Files Smart Sorting: Use Smart Sorting for alphanumeric filenames (default). CuteFTP Pros Smart Sorting feature, which gives you a natural language sorting alternative to the traditional yet unwieldy lexicographic sorting of alphanumeric sequences, was developed by David Wincelberg from: FileJockey Software, http://www.FileJockeySoftware.com. CuteFTP Pro Version 1 Users Guide
29
An example of Smart Sorting: Filename1.ext Filename4.ext Filename6.ext Filename9.ext Filename13.ext Filename20.ext Filename21.ext Standard Lexicographic Sorting: Lexicographic is the most commonly used file sorting method, and is employed by the Windows operating system by default. Sorting via this method is much like dictionary sorting or telephone book sorting. For example, A1 would be followed by A12 and then by A2. While correct, this can be unwieldy when sorting groups of filenames with numbers at the end. A more cognitive and arguably more logical sorting order would be A1, then A2, then A12, which is why CuteFTP Pro offers the additional Smart Sorting method. An example of Lexicographic Sorting: Filename1.ext Filename13.ext Filename20.ext Filename21.ext Filename4.ext Filename6.ext Filename9.ext Using Bookmarks to Access Frequently Used Sites Sites in the Site Manager can have special entries called Bookmarks associated with them. Bookmarks specify a local or remote folder (or both) to open when the bookmark is selected. Bookmarks can be very handy for site administrators or anyone else who has to transfer files or folders. The easiest way to create a Bookmark: 1. Navigate to the folder you want to bookmark. 2. Right-click in either the remote or local window. 3. Choose Bookmark Current Folder from the pop-up menu. 4. The Bookmark will appear in the Site Manager as a sub-listing of the remote sites entry. Bookmarks created in this manner are assigned the remote folder as their default name. Another way to create a Bookmark: 1. Right-click a sites entry in the Site Manager. 2. Select Add Bookmark from the pop-up menu. A bookmark will immediately appear under that sites listing in the Site Manager. The bookmark will be assigned the default name Bookmark and will be automatically editable. 3. Enter a name for your bookmark. 4. Right-click on the bookmark and choose Properties (or select the Bookmark and press Alt-Enter).
30
5. In the Bookmark Properties dialog box, enter a local and remote path in the appropriate field. The local path can be selected from a standard Windows Open dialog box by clicking on the small folder icon to the right of the local path field. To change a Bookmarks name, do one of the following: Select the Bookmark by single-clicking on its name, the way you would to rename a file in Windows Explorer. Select the Bookmark and press F2.
To access a Bookmark: Double-click the bookmarks Site Manager entry, or select it and press Enter. A new remote window will open and CuteFTP Pro will automatically place you in the bookmarks remote folder if there is one specified. If one is not specified, you will be placed in the root folder. The Site Manager will switch to the local window view, displaying the local folder specified in the bookmark (unless none is specified). To remove a Bookmark from the Site Manager: 1. Select the Bookmark. 2. Press the Delete key or right-click on the Bookmark and then choose Delete from the pop-up menu.
31
32
Configuring the Site Properties Cache Options CuteFTP Pro will also attempt to use the cache during normal online connections to prevent retrieving directory listings unnecessarily. You can configure this behavior from the sites Site Manager entry. Bring up the sites properties in Site Manager. Choose the Actions tab. To control caching behavior, choose the pop-up menu. For navigation, use the following caching options: Use cache during session: Cache will be checked when accessing all directories for the duration of a single connection. This means that if you open ftp.globalscape.com, and switch to the /pub directory, the /pub directory will always be loaded from cache until you disconnect from the site. When you reconnect, the directory will be downloaded as normal. Always use cache: This option forces CuteFTP Pro to use the cached directory contents every single time. You can force a manual reload of the directory by pushing the Refresh button or pressing F5. Do not use cache: This disables directory caching during normal connections. You can still access the site cache by using the Browse Offline function, described above. Filtering Transfers CuteFTP Pro includes the ability to filter batch file transfers, allowing you to easily transfer large numbers of files without manually selecting desired files. You define filters in a special filter dialog box, and can then apply these filters to individual transfers or use them on all transfers. There are two uses for filters. Use them to filter folder listings and to filter file transfers. To filter folder listings: 1. Right-click in a local or remote window. 2. Choose Filter Contents (local) or Filter Current View (remote). 3. Define any additional filters (see above) and make sure Enable Filtering is checked. 4. Click OK and the folders contents will be filtered. To filter a file transfer from the Local Window: 1. Select a site in the Local Window. 2. Right-click and choose Site Properties. 3. Choose the Actions tab and then click the Filter button. Use the three tabs in the Filter dialog box that appears to configure your filter. 4. Click Apply. NOTE: Unlike filtering folder listings, a filtered download will not present you with the filter dialog box before proceeding. Any filters you need defined for your filtered transfer must be defined before beginning the transfer.
33
Enabling and Defining Filters To bring up the filter dialog box, right-click in a local or remote window and choose Filter Contents (local) or Filter Current View (remote), or Activate a local/remote window and press Control-L. The Filter Properties tab will appear, allowing users to set the following options: Enable Filtering: This activates or de-activates the filtering feature. Apply Filtering To Folder Name(s): If selected, folders as well as files will be checked against the filter masks. Apply To File Transfers: If this is checked, every file transfer will be filtered. Normally, downloads are filtered only when you specify. Case Sensitive Filtering: Filters will differentiate between upper and lowercase letters. Server Side Filtering: With this option, you can define a custom listing command for remote systems supporting this feature. These custom commands are typically parameters to the Unix ls command. For example, to force display of hidden files, use the parameter -a. Define filters: Define filters in CuteFTP Pro the same way you would in the Windows Find program. Use combinations of letters and the wildcard character (see Wildcard Mask) to match any character(s). For example, the Filter Mask index.html would filter only files named index.html. The mask index.* would filter out index.html and index.doc but not index2.html. Filter Mask Filter Mask specifies files to be included in a filtered transfer. In order to specify particular files for a file transfer, select a site in the Local Window. Right-click and choose Site Properties. Choose the Actions tab and then click the Filter button. Use the Filter Mask tab in the Filter dialog box that appears to configure your filter. Remember, any files that match the parameters defined in the Filter Mask tab will be displayed. For instance, if you wish to see only JPEG files, you would add the filter *.jpg. Filter NOT Mask Filter NOT Mask specifies files to be excluded from a filtered transfer. In order to specify particular files for a file transfer, select a site in the Local Window. Right-click and choose Site Properties. Choose the Actions tab and then click the Filter button. Use the Filter NOT Mask tab in the Filter dialog box that appears to configure your filter. Files matching any filters listed in the Filter Not Mask tab will not be displayed. This allows you to eliminate any group of files while leaving others unaffected. Adding a filter such as *.jpg would cause CuteFTP Pro to no longer display JPEG files.
34
Adding a Filter In the Filter dialog box, accessible while connected with F11, select the Filter Mask or Filter NOT Mask tab. Enter the filter definition in the top box. Click the Add button. The filter information should appear in the bottom box. Removing a Filter In the Filter dialog box, accessible while connected with F11, select the Filter Mask or Filter NOT Mask tab. Highlight the filter you wish to remove in the bottom box. Click the Remove button. The filter information should no longer appear.
35
Automating Functions
Smart Overwrite A common hassle when transferring files is dealing with a transfer in which both the destination and source files have the same name. Previous versions of CuteFTP prompted you to decide whether a transfer should overwrite, resume, or skip the destination (existing) file. CuteFTP Pro has expanded on this area by allowing configuration of more complicated logic, making unattended file transfers much easier. Find Smart Overwrite at Global Settings > Transfer Settings > Rename Rules To change the Smart Overwrite Settings: 1. Choose Global Settings from the Edit menu or press Alt-F7. 2. Select the Smart Overwrite item under Transfer Settings from the list on the left-hand side of the settings window. 3. At the top of the Smart Overwrite Settings window are two radio buttons. Choose either Prompt or Defined. Prompt: When Prompt is selected, CuteFTP Pro asks you before overwriting any files. Defined: Switching to the Defined button turns on the Smart Overwrite feature and activates the fields in the bottom portion of the settings window. To set a Smart Overwrite rule: 1. Select the desired criteria from each of the four pop-up menus. 2. Click Add Rule. To remove a rule: 1. Select the rule from the list. 2. Click Remove Rule. Should none of the rules apply to the current transfer, CuteFTP Pro will prompt you with the choice to overwrite, resume, rename or numerate the file. Smart Overwrite rules are generated with four criteria: file date, size, direction of transfer and the resulting action. Smart Overwrite rules are generated in an easy-to-follow English format. The following criteria may be set for each rule: File Date: The day and time the files were last edited are compared. CuteFTP Pro can trigger on a newer file, an older file, files with matching dates, and files with any difference in date. To ignore the date, choose no matter. File Size: The sizes of the two files (in bytes) are compared. Action can be taken on smaller files, larger files, identically sized files, or differently sized files. To ignore the size, choose no matter.
36
During: This controls what transfer type to which the rule applies. Rules can apply to uploads only, downloads only, site-to-site transfers only, or to all transfers. Then: This field controls the action CuteFTP Pro will take if the file transfer matches the three previously described criteria. Select from the following check boxes to set your general program and Transfer Engine settings at Global Settings > General Settings: Overwrite: The file being transferred will replace the file on the destination system. Numerate: The file being transferred will have a numeric extension added to its file name so it does not overwrite destination files. Resume: The file is treated as an interrupted download, and CuteFTP Pro will attempt to resume the transfer if the remote system supports this action show prompt. Basically, CuteFTP Pro asks you what to do. Skip: The file is ignored. Here are some examples of rules constructed from these criteria. Note how they affect file transfers: If destination file date is same and size is smaller during download, then resume. This means that if you are downloading a file called Report.xls and the size is 100 kb, and you have in the remote directory a Report.xls that is 50 kb, both with the same date, CuteFTP Pro will attempt to resume the transfer, downloading the last 50 kb of the file. If destination file date is same and size is smaller during any transfer, then resume. Although choosing to resume might work perfectly for the majority of users, resuming could be disastrous for a few. For example, if you downloaded a file index.htm, modified its contents by adding some lines of code and then uploaded it. The modified file would meet the requirements of the above rule and the program would resume the transfer, basically concatenating the files contents. Since the reverse is unlikely (there are no server side editors), applying the first rule safeguards transfers that may resemble the previous example since it only applies to downloads.
37
Other examples: If destination file date is older and size is different during download, then overwrite. This rule would make CuteFTP Pro assume that any file with an older date should be overwritten by a newer file with the same name and a different size. If destination date and size are the same during any transfer, then skip. This rule would provide a rudimentary means of skipping duplicate files. If the files date and size match, then skip the download. Although it is possible that two files with matching names, time stamps and sizes may be different files, it is not very likely. Rename Rules Use this option if you wish CuteFTP Pro to automatically rename files or file extensions during transfer (i.e., use this to change .htm to .html). It is located at Edit > Global Settings > Transfer Settings > Rename Rules. Check Apply auto-rename rules to transfers to globally apply your rename rules. Remember that rename rules are case sensitive (i.e. to rename extension htm to html would not rename HTM to html). To Set Rename Rules: 1. Enter the original file name or extension in the first field (Rename from). 2. Enter the desired new file name or extension in second field (Rename to). 3. Click Add to include new rename rules. To Delete Rename Rules: 1. Select a rule. 2. Click Remove to delete rename rules from your list. 3. Click Apply to set these rename rules. CuteFTP Pros Transfer Engine CuteFTP Pros autonomous Transfer Engine (TE) can allow users to complete and schedule file transfers for times when the user interface has been shut down. More advanced users can even use their own programming languages to direct and schedule the TEs file transfers, bypassing the program interface completely. Startup and Shutdown sequences: Launch FTP Transfer Engine on Windows startup. This check box initiates CuteFTP Pros transfer engine upon startup. Launch Transfer Engine on program startup: CuteFTP Pros transfer engine will introduce itself upon startup of Windows. Closing the Transfer Engine: Select one of the three TE close options.
38
Do not close TE if tasks are pending: The TE will close when the client closes unless queue items are pending. On exit, dont close the TE: With this option, the TE will stay open when the client closes. On exit, close the TE: The TE will exit regardless of remaining files. Use the currently selected folder in the local pane as the default. If this box is checked, the default folder becomes whatever folder is currently highlighted in your local pane. Default download folder: This option is available only if Use currently selected folder... is unchecked. Select the default download folder in this window. The default local folder will be used for all download methods except for when files are dragged into a specific folder in the navigation pane. Scripts Scripts can be created with any text editor, like Notepad, or from within CuteFTP Pro by either selecting File > New > Macro Script File or Tools > Macros and Scripting Tool > Create New Script or by pressing New > Macro Script File from the toolbar. CuteFTP Pro will open a new template script file in a document window. To execute scripts (macros) created in older versions of CuteFTP: 1. Within CuteFTP Pro, select Tools > Macros and Scripting Tool > Run Script or 4.x Macro > Browse. 2. Then, select the macro file to run from a standard Windows open dialog. Once you have opened a macro file, its name will appear below the Browse item in the Run Script submenu for easy future access. In addition, you can execute scripts from the command line by double clicking on the script file (such as myscript.vbs). Execute old CuteFTP scripts from the Windows Start > Run menu item as follows: ftpte.exe /Script [scriptname].mcr. Replace scriptname and the brackets with the name of your macro file. Requirements to Run Script Files In order to run the new CuteFTP Pro script files, you must have the Windows Scripting Host (WSH). WSH relies on the Visual Basic Script and JavaScript engines provided with Internet Explorer 3.0 or later. WSH is also installed as part of Windows 98, Windows 2000, and Internet Information Server 4.0. A separate setup program may be able to be downloaded for Windows 95 from http://www.microsoft.com/msdownload/vbscript/scripting.asp. The CuteConnection Object The CuteConnection object is a COM object that provides basic functionality for remote site navigation, file transfers and other operations on local and remote file systems. In the near future, this object will support many more of the Transfer Engines features (such as multi-part transfers, Smart Keep Alive, etc.). CuteFTP Pro Version 1 Users Guide
39
Registering Components of the CuteConnection Object For all platforms except the earliest versions of Windows 95, all necessary components are registered upon the first run of CuteFTP Pros Transfer Engine. Additional install-time registration is necessary for Windows 95. Execute the file in your CuteFTP Pro directory called win95script.reg to update your Win95 system to register this COM object. The CuteConnection Interface The interface, or method for communicating with the TE is implemented by the CuteConnection object. This dual-dispatch interface is synchronous, meaning all steps are executed in sequential fashion. A Sample Script File For creation of a script file, you will need to have at least some familiarity with programming concepts, and ideally some experience with VB or Java. For those of you that have neither, or if you just want a template to work from, load one of the predefined scripts included with CuteFTP Pro and edit it to suit your needs. A sample script is included below with line-by-line comments. Comments may be included in the code by prefacing comment lines with a singlequote character (). Public Properties Supported by the CuteConnection Object Below is a list of public properties and methods supported by the CuteConnection Object. Data Type Command: BSTR Host: This is the address of the remote site. This should be set before calling the connect function. BSTR Protocol: Specify the protocol of the remote site. Choose one: FTP, HTTP, SFTP, FTPS or HTTPS. The default value FTP should be set before calling connect function. Long Port: This is the listening port of the remote site. If this value equals 1 then the default protocol value should be used. It should be set before calling the connect function. BSTR Login: This is the users login. It should be set before calling the connect function. BSTR Password: This is the users password. It should be set before calling the connect function. BSTR UseProxy: This refers to proxy settings. Choose one: OFF Do not use proxy. PROXY Use current FTP/HTTP proxy. SOCKS Use current SOCKS proxy. BOTH Use current SOCKS proxy and current FTP/HTTP proxy. DEFAULT Use global settings.
40
BSTR TransferType: Transfer type settings. Choose: ASCII ASCII mode BINARY binary mode AUTO auto detect file type DEFAULT use global settings. BSTR LocalFolder: This points to the local folder. The local working folder is changed when value of the property changed. BSTR RemoteFolder: This points to the remote folder. The remote working folder is changed when value of the property changed. BSTR LocalFilterExclude, LocalFilterInclude: Filter for local working folder. If empty, do not filter. BSTR RemoteFilterExclude, RemoteFilterInclude: Filter for remote working folder. If empty, do not filter. Long Retries: Connection retries count. Long Delay: Delay between retries. BSTR Autorename: Choose either ON, OFF or DEFAULT. BSTR Links: Links handling setting, can be GETASFILES or RESOLVE. Public Functions: void Connect (): Used to connect to the remote site using connection information provided in public properties. Some information from global settings (default proxy, socks, transfer mode, etc.) will also be used. All other methods that work with the remote site should use the current connection rather than creating a new one. void Download (BSTR RemoteName, BSTR LocalName): Download file with given name from remote site to given location. void Upload (BSTR LocalName, BSTR RemoteName): Upload file with given name from local machine to given remote location. void CreateLocalFolder (BSTR strName): Creates local folder with given name. void CreateRemoteFolder (BSTR strName): Creates remote folder with given name. void LocalRemove (BSTR strName): Removes local file or folder with given name. void RemoteRemove (BSTR strName): Removes remote file or folder with given name. CuteFTP Pro Version 1 Users Guide
41
void RemoteRename (BSTR strFrom, BSTR strTo): Renames remote file. void LocalRename (BSTR strFrom, BSTR strTo): Renames local file. short LocalExist (BSTR strName): Check if file with given name exist on local machine. short RemoteExist (BSTR strName): Check if file with given name exist on remote machine.
42
43
Use Simple Listing when retrieving remote folder listings: This option should be used with sites that do not properly display their folder listing. Simple Listing can affect certain transfer options and should only be used as a last resort. Customizing Logs The Log file visible in the lower portion of the CuteFTP Pro screen shows every action performed as well as server responses during connection. The type and number of server responses may be changed by selections made in program settings using the following steps. Go to Global Settings > Logs. Utilize the following options to customize your log window characteristics: Select from available colors or define custom colors to visually distinguish the: Color used for status events in logs Color used for command events in logs Color used for error events in logs Text color for all other log events Select Font: Choose the typeface viewed in the Log window by clicking Select Font. Enable Individual Queue Item Transfer Logs: If selected, each individual transfer thread will have its own log file. With this enabled, you will receive detailed error logs when file transfer threads fail. Enable Navigation (Session) Logs: If selected, the main thread used for navigation and browsing will have its own log file. This enables the inwindow display of logs when connected to a remote site. Enable Consolidated Transfer (Log Pane) Logs: If selected, all of the log pane session records will be combined into a single unit, as opposed to a single log file for each thread. Log files folder: Insert the location desired for log files in this browse window. Delete logs every: Check this box if you want old log files to be automatically deleted. Select the amount of time which shall pass before CuteFTP Pro deletes these log files. Delete all logs now: Press this button to delete all logs except those currently in use. Delete logs after closing transfer engine: This setting will cause all logs to be deleted every time CuteFTP Pro shuts down. Show time stamps in logs: This will log an additional time stamp to all transfer and listing operations performed by CuteFTP Pro. This is useful for determining how long transfers have taken.
44
Viewing Table of Contents Files Index files are used by FTP sites to report the number, size, name, date, and permissions on files within a folder. In this way, index files are similar to a table of contents (TOC), supplying a helpful list of the folders contents and revealing their location in the folder. TOC files are optional index files contained in directories which reveal the directorys information. The following settings, located at Global Settings > Navigation Settings > TOC Files, affect the retrieval and display of these Table of Contents files: Load TOC files. CuteFTP Pro will automatically load index files when this feature is active, otherwise it will completely ignore them. These are listed as TOC files (Table of Contents). If the TOC file size exceeds ___________ Kbytes, ask before loading. This field specifies the size (in kilobytes) of the largest TOC file (not to be confused with index.htm) to load without any prompts. If the TOC file size exceeds this specified limit, CuteFTP Pro will prompt you to continue. Setting this parameter to zero will cause CuteFTP Pro to prompt you for all TOC files whereas setting it to 32000 effectively disables any prompting. It is not advisable to set this parameter too high because there might be multi-folder index files on the sites. The default is 100 kilobytes. Specifying TOC Include Masks Users may specify masks for CuteFTP Pro to use in identifying TOC files. Click the Add button to enter additional masks. Multiple masks can be added before leaving the dialog box. CuteFTP Pro uses these masks to match against file names. If any item in the list matches the file name, it is then matched against the Index Files NOT mask (see next section). If it doesnt match any of the items in that second list, the file is then considered to be an index file. Specifying TOC Exclude Masks Users may specify masks CuteFTP Pro should not consider in identifying TOC files. Click the Add button to enter additional masks. Multiple masks can be added before leaving the dialog box. If you look at the default TOC Files Mask list, you will notice a file named *index* using Wildcards. CuteFTP Pro will consider any file with the word index in it, to be an TOC file. That could cause a problem since your web page might be called index.htm. However, CuteFTP Pro passes the filename through a second filter, the TOC Files NOT Mask, and sees the *.htm extension in the list. It will no longer consider your web page as an TOC file because of the double filtering system.
45
Interpreting Symbolic Links CuteFTP Pro provides a variety of options for interpreting Symbolic Links. Many other FTP clients either do not offer link interpretation, or very poor implementation of the same. Go to Global Settings > Navigation Settings > Links in order to configure these settings. Symbolic Links are similar to but not identical to Windows shortcuts. The biggest difference between them and a shortcut is that a shortcut is an actual file, which points to another file (target). A UNIX shortcut is not a file (at least in the usual sense), but rather a virtual reference to target file. A link to a folder on a UNIX machine is not a file, but rather a virtual reference to this folder. Proper link interpretation is important for various reasons, one of the main ones being the need to avoid problems when downloading large folder trees, which may contain links to targets above the physical parent folder from which the download was started. Situations like that can cause CuteFTP Pro to obtain non-intended folders. Or, if some folders are linked to each other, the program could even get stuck in an endless loop. The options provided by CuteFTP Pro are: Server side link resolution: Resolve links by sending LISTL command. This option allows the server to interpret links via the LISTL command issued by the client. FTP servers will not always handle this command correctly, which is why additional client side interpretation options are given. These allow CuteFTP Pro to take additional precautions. Client side link resolution: Determine type of the links TARGET by extension. This option tells CuteFTP Pro to try and determine whether a links target is a file or a folder for visual identification and for proper navigation. This is useful if you wish to download the target or change folders to that target. Dont attempt to resolve links: This option tells CuteFTP Pro to ignore the link and treat it simply as a file, similar to a shortcut file. If downloaded, a 0 byte place holder file will be received by the client, which is pretty much useless. This option should be checked if you are downloading large folder trees and wish to avoid any complications. WarFTP Specific These settings are specific to WarFTP servers. WarFTP treats PASV Mode and links differently. CuteFTP Pro resolves this by giving you some additional options. Go to Global Settings > Navigation Settings > WarFTP Specific to adjust these options: Force RFC compliant PASV Mode: Uncheck if you are having problems connecting to WarFTP sites, or receive error messages indicating that PASV Mode is not supported. Treat .lnk files as linked files: .lnk files will be treated as links instead of as directories. This solves problems with folder navigation when connected to WarFTP sites.
46
Display CuteFTP Pro allows you to configure the visual display of items and windows to suit your needs or preferences by providing these useful options at Edit > Global Settings > Display. Under Select the toolbars to display: Choose which toolbars you would like CuteFTP Pro to offer upon launching the program. Note: You may also customize the toolbars. To do this, simply choose the customize button and select or deselect toolbar button icons. Under General Display: Show grid lines on all view panes: Grid lines can be visually helpful to some and distracting to others as they are distinguished with light gray lines a list of files or transfers, so CuteFTP Pro allows for you to make your visual choice. Show individual logs for each connection window: CuteFTP Pro provides log windows for each site you open by default. To remove these logs, uncheck this box. Under Smart Sorting: Use Smart Sorting for alphanumeric filenames: This option means that files will be sort in 1, 2, 3 order. Use Standard Lexicographic Sorting for alphanumeric filenames: Files wil be sorted in 1, 11, 2, 21, etc. order. Prompts CuteFTP Pro will send prompts during program operation to help users avoid mistakes, confirm that actions were successfully completed, or to offer help for certain functions. You can edit these at Edit > Global Settings > Display > Prompts. Under Confirmations: When deleting an item on local view: Select this box to direct CuteFTP Pro to prompt you when deleting a file in local view. When deleting an item on remote view: Select this box to direct CuteFTP Pro to prompt you when deleting a file on an FTP site. When deleting an item from the queue: Select this box to direct CuteFTP Pro to prompt you when deleting a file in your queue. When closing a remote view: Select this box to direct CuteFTP Pro to prompt you before closing a remote window. Under Auto-Close Prompts: Automatically close prompt windows after___seconds: Select a default number of seconds to display a prompt window before closing. Click the CuteFTP Pro Version 1 Users Guide
47
up arrow to increase the number of seconds and the down arrow to decrease the number of seconds. Other Settings: Show user name and password prompts: Prompts for user names and passwords when necessary. Show error prompts dialog: Disable this option to turn off the automatic display of error boxes. Helper Applications In Global Settings > Helper Applications, specify the external programs CuteFTP Pro will utilize for viewing text and HTML. Text Files Viewer: Specify the viewer you wish to use when viewing text. The default viewer is the Integrated HTML Editor. If you wish to use a different viewer, click the button at the end of the field and browse for the .exe file that launches the program. Specifying the HTML Editor: Specify the HTML editor program you wish to use. By default, Use the Integrated HTML Editor is selected. If you want to use an external editor, deselect this item, then click the button at the end of the field and browse for the program. Configuring SOCKS/Firewall Settings SOCKS is a protocol that a proxy server can use to accept requests from client users in a companys network so that it can forward them across the Internet. SOCKS uses sockets to represent and keep track of individual connections. The client side of SOCKS is built into certain Web browsers and the server side can be added to a proxy server. Go to Global Settings > Connection > SOCKS/ Firewall. If your network uses the SOCKS protocol, the following settings will allow you to connect to external FTP sites. Contact your System Administrator to obtain the information needed. Use the highlighted SOCKS Server. Select the check box and add SOCKS server(s) to the list provided. To add a SOCKS server, complete the fields belw and click Add: Host Name: Enter the Host Name of the SOCKS proxy server. PORT: PORT number of the SOCKS proxy server. 1080 is the default port for SOCKS and unless otherwise specified by your administrator, this is your SOCKS port number. If you wish to use Authentication, you will be asked to fill in the following information: User Name: Enter your name for the SOCKS proxy server.
48
Password: Enter your Password to connect to the SOCKS proxy server. Select from two SOCKS options in the following radio buttons: SOCKS4: Select this option if your network uses the SOCKS4 protocol. You must also enter the SOCKS Host and PORT Number. SOCKS5: Select if your network uses the SOCKS5 protocol. Enter the Host and PORT Number. If SOCKS5 is checked, enter the user ID and password supplied by your System Administrator. Configuring Proxy/Firewall Settings A proxy server is a safeguard utilized by many Local Area Networks (LANs) or Wide Area Networks (WANs) to protect the network from unauthorized access from the outside. If you are using CuteFTP Pro on a LAN or WAN, you may have some problems caused by the network settings. When you first try to use CuteFTP Pro, leave these settings as they are and try to connect to some of the predefined sites in the Site Manager pane. If every site you try to connect to prompts you with Cant connect or Cant login, still trying then you probably need to configure the firewall settings. These are located at Global Settings > Connection > Proxy/Firewall. Note: If your LAN or WAN supports FTP Proxy protocol, you will need the following information: 1. IP address for your proxy host 2. PORT number for the FTP proxy server 3. User name and password. Settings: Use the highlighted proxy when connecting. When using a proxy server, select this box and enter or remove proxy servers in the following list. To add a Proxy server: Fill out the following fields and then click Add. Host name: Enter your host name here. Port: Enter your port number here. 8000 is the default Proxy port number and unless otherwise specified by your administrator, this is your port number. User Name: Enter your user name here. Password: You must enter your password here. Host type: Choose whether you are seeking an FTP connection or an HTTP connection. Examples of Advanced Proxy Commands Go to Global Settings > Connection > Proxy > Firewall > Advanced (button). The following is a list of scripts that correspond to existing choices in this Proxy > Advanced dialog. CuteFTP Pro Version 1 Users Guide
49
USER @ site: USER %user%@%host%:%port% PASS %pass% USER/PASS/ACCT: USER %user%@%host%:%port% %fire_user% PASS %pass% ACCT %fire_pass% SITE site: USER %fire_user% PASS %fire_pass% SITE %host% USER %user% PASS %pass% OPEN site: USER %fire_user% PASS %fire_pass% OPEN %host% USER %user% PASS %pass% Custom Proxy Commands If Custom is the selected Authentication Type, you may need to manually configure the login commands sent to the FTP server. This is the information required. %HOST% %USER% %PASS% The address of the FTP site to connect Valid username for the FTP server Password associated with the specified FTP username CuteFTP Pro Version 1 Users Guide
50
PORT used by the FTP server (If this command is not used, it will default to 21, the standard FTP port.) Firewall user name (Some network configurations may require a login for the firewall.) Password associated with the Firewall username.
Example of Advanced Custom Commands After setting the Host and PORT fields to the correct Firewall/Proxy server, select the Advanced option. Enter each command necessary to initiate an FTP session with the remote server, one command per line. A typical series of commands might look like this: fire_user jimmy fire_pass $53a&8* host ftp.microsoft.com user anonymous pass somename@domain.com port 21 This will first send the username jimmy and the password $53a&8* to the Firewall/Proxy server (as required by that specific server configuration). Then, CuteFTP Pro will open a connection to the Microsoft FTP site and login anonymously on Port 21. Contact your System Administrator for the exact sequence of commands needed.
51
HTML Editor
HTML Editor Features CuteFTP Pro contains a free, integrated HTML Editor. The editor is located at Global Settings > Helper Applications > HTML Editor. The integrated HTML editor includes the following features: Auto-tag fill
Auto validation Customizable color-coded HTML tags Easy-to-use Bold, Italic, and Font selector Color fonts (easy document comprehension and layout) Line numbering option (for better code management) Sophisticated word/paragraph Find and Replace Multi-document tabbed interface Color and RBG to HEX converter Dynamic view in browser function Multiple document/folder file open Drag and drop support Unlimited Undo and Redo commands Document weight feature (indicates total time for the document to load) Word Wrap toggle Smart Anchor and Image dialogs (remember commonly used data) Highly customizable Java script support (for commonly used scripts) Handy and customizable Code Snippet Customizable default template for HTML documents Ablity to view unsaved changes in browser Auto tagging of unsaved documents Support for mouse wheels
Creating an HTML Document To create a new HTML document, select New > HTML Document from the File menu. Build your document by adding code to the template. See Use Tag Tips for reference. To use Tag Tips to display HTML codes for building your document: 1. To access the tags, press < or right-click in the document window. 2. The tag tips box displays the tags in alphabetical order. 3. Scroll down to your selection and double-click to insert. Subsequent boxes will display until the selected code is complete.
52
To open additional new documents: From the menu bar, click File > New > HTML Document. Inserting Images The Insert Image icon located on the Toolbar inserts images into your HTML document using information entered into dialog boxes. Begin at the Toolbar and click the Insert Image icon (represented by a page with a paintbrush inside of it). In the Image tag dialog box, click the open folder icon to find the source of the image or type it in if you know the path. <IMG SRC=path/ filename> will automatically be inserted into the HTML code to designate that a graphic image will be displayed. Browsers display GIF, JPEG, or PNG images. If you want, specify the width and height of your image in pixels. These attributes will designate a fixed pixel width and height for the image. Advanced Tab: Click the Advanced tab. Type the text you wish to appear in place of the image in the Alt text field. This attribute displays text in place of an image that does not load. This attribute should be used for all important images. This can help people with slow browsers or bad connections to navigate through your site successfully. VSPACE: The VSPACE attribute will place padding on the top and bottom of the image equal to the pixel value. HSPACE: The HSPACE attribute will place padding on the right and left sides of the image equal to the pixel value. Border: Type a number of pixels in the Border field to put a border around an image that is the width of the pixel value. This field may be left blank. Align: Click the down arrow at the end of the Align field and select an alignment for the image. The ALIGN attribute controls the placement of the image on the Web page. The values TOP and BOTTOM refer to where the text will align itself after an image. Click the OK button to accept the information or Cancel to exit and return to the document without adding the image. Drag and Drop You can simply drag an image into the current HTML document to speed up editing. To do this, select an image file in the Navigation Pane. Drag the image into the HTML document. The Image Tag Attribute dialog box will appear. Click the View in Browser icon to see if the image is correct in appearance, size and position. Closing an HTML Document From the menu bar, click File > Close, or click the Windows Close button in the upper-right corner of the document window. If your document has unsaved changes, a prompt to save your document will appear. Click Yes to save the document. Click No to exit without saving the document or changes. Click Cancel to return to the document without saving the document or changes. CuteFTP Pro Version 1 Users Guide
53
Changing the HTML Editor Settings From the menu bar, select Edit > Global Settings. Select the Helper Applications > HTML Editor section to change program defaults for any of the following: Enable Word Wrap: The HTML editor can wrap lines of text for complete document visibility. To turn on word wrap, click the check box next to the Enable Word Wrap option. Prefix Each Line with Line Numbers: The HTML editor shows line numbers for better code management. To hide line numbers, uncheck the check box next to the Prefix Each Line with Line Numbers option. Allow Editing Beyond the End of Line: Inactive by default, this feature enables you to insert text anywhere after the end of a line of text, as opposed to after the last character only. To enable the Allow Editing Beyond End of Line feature, click the check mark next to the Allow Editing Beyond End of Line field. The check mark will appear indicating the feature is active. Tab Size: Select the number of spaces the tab key will indent. Type the number of spaces in the box provided. Edit New Document Template: The existing template may be changed to fit each users needs. Changes to the template will affect all new documents created from that point forward. Click the Edit New Document Template button. Position your cursor at the point you wish to edit and click with the left mouse button. (Notice the entire template is highlighted and will be deleted if you start typing before you click to refocus the cursor.) Make your changes and click OK to save or Cancel to retain the original template. Choose Font for Editor: The default type, style and size may be changed for current and future documents. Click the Choose Font for Editor button. Select a new type, style, and size. Click OK to save the new settings or Cancel to retain the default settings. Setting Comment Colors in the HTML Editor Comment colors may be changed to user preference. Documents previously created as well as new documents will assume the new color settings as they are viewed in CuteFTP Pros Integrated HTML Editor. Comment colors may be changed at Global Settings > Helper Applications > HTML Editor > Colors. Simply move to the HTML or Perl comment you wish to make changes to and click the down arrow at the end of the field to select a new color from the myriad of hues in CuteFTP Pros palette. Click OK to accept the change and return to the HTML document window. In order to make sure that the colors you set manually will be used, go to the Use System Settings box in the Colors dialog. When checked, this box alerts the program to use the Windows default background and system font (text) colors. Unchecking this box will let you select these colors manually. Click OK to set the changes you have made.
54
Folders CuteFTP Pro allows you to set your working folders for your HTML Editor in this easy to use dialog box. Default browser and folder paths may be changed to user preference. Simply go to Global Settings > Helper Applications > HTML Editor > Folders and adjust the following options. Browser Path: To select another browser, click the check mark in the Use Default Browser field to enable browser selection. Next, type in the new path or click on the Browse button to find the path of the executable file to your browser. Code snippets path: To change the directories for the snippets, type in the new path or click the Browse button to find a new locale for this folder. Java scripts path: To shift the directories for the snippets or Java scripts, type in the new path or click the Browse button to find the new location. Spelling Spell checking options for CuteFTP Pros HTML Editor may be changed at Global Settings > Helper Applications > HTML Editor > Spelling. Click Check Spelling as you type if you wish the editor to underline words not found in the dictionary. You can select the underline color in the drop down menu. Select the language the HTML file will use from the Dictionary drop down menu. You can also choose to Use Custom Dictionary from this menu. To go one step further, choose Use Custom Dictionary and then click Edit Custom Dictionary to personalize the built-in dictionary. Tag Tips The following selections, at Global Settings > Helper Application > HTML Editor > Tag Tips, customize your HTML tag characteristics. Show tag tips: Check this box to enable viewing of tag tips. Capitalize tag tips: Capitalize tag tips for ease of viewing. Tag tips delay (milliseconds.) Enter the amount of time in milliseconds before CuteFTP Pro drops down a list of possible tag tips to choose from. Primary Browsers: Select up to two primary browsers from those available.
55
Troubleshooting
Frequently Asked Questions What is CuteFTP Pro? CuteFTP Pro is an FTP client based on the original client, CuteFTP. CuteFTP Pro is equipped with additional tools that the original CuteFTP did not contain such as the Transfer Engine (TE), built in HTML editor, and Secure FTP Transfers. How can I get a copy of CuteFTP Pro? CuteFTP Pro is available by download from our Web site at http:// www.globalscape.com How long does it take to download? This depends on your modem speed. On a regular 56K modem, CuteFTP Pro will take about seven minutes. The time to download decreases as your connection speed increases. Do you offer any online or offline support? Telephone support for CuteFTP Pro is available to registered customers only. The telephone number for support is 210-308-8267. All other users may e-mail support questions to support@globalscape.com How do I upload my files with CuteFTP Pro? You can upload your files by browsing to the directory where your files are located on the left hand window of the screen. Click on the files you wish to upload and drag them across to the corresponding right hand window (the server side). You will see the upload progress of your files in the queue window at the bottom of your Cute FTP Pro screen. How do I transfer files from one site to another? Connect to two different servers. Click on the files you wish to transfer located in the first server window. Drag and drop these files to the second server window and they will be transferred from the first server to the second server. How do I navigate the directory tree in CuteFTP Pro? The Local Pane, located by default on the left-hand side of the screen, contains a Local Drives tab. Select this tab and you can navigate your local drives in the same fashion as Windows Explorer. How do I change the permissions of my files (CHMOD)? Connect to your UNIX server using CuteFTP Pro. Click on the file you wish to change permissions for so that it is highlighted. Right click on the file and choose Properties. The different options for the permissions are located at the bottom of this dialog box. Only servers that support the CHMOD command will let you change permissions. For the servers that do not support CHMOD, you cannot change permissions.
56
How do I delete files off my server? To delete files off of your server, simply click on the file you wish to delete and press the Delete key on your keyboard. You can right click on the file and click Delete. You can click on the file and then click on the red X up on the Toolbar. Finally, you can click on the file, click Commands>Delete. How do I set up a connection to my FTP Server? To create a site in your Site Manager, click File>New and choose the type of connection you wish to connect on. It will bring up a window that will ask you for a Label for the site and the rest of the log in information provided to you by your Web Host Provider. What is my FTP Host Address? This information is assigned by your Web Hosting Provider. If you dont know what the FTP address is or are not sure, you can contact your Web Hosting Provider or Internet Service Provider and they can give that information to you. What is my user name and password? Your Web Hosting Provider or Internet Service Provider assigns this information. If you need to find out what this information is, you can contact them and they will be able to give that information back to you. Why cant I connect to my FTP site? If you have tried to log into your FTP site and have been unsuccessful, a window will appear telling you that it could not log in. Click on the button Details and it will list the exact error message sent to you by the server. Contact your Internet Service Provider or your Web Host Provider with this error message and they will be able to assist you in getting connected. What is the difference between an FTP site with SSL and an SFTP site? Both of these are secure protocols. SFTP, which is a component of SSH2, is supported by various types of Unix FTP servers while SSL is more platform independent and is supported by servers such as WS-FTP Server and CuteFTP Server. Check with your server administrator to verify that the server uses SSL or SFTP (SSH2). How do I connect if Im behind a firewall? If you are behind a firewall and you cannot connect, you will need to set up CuteFTP Pro to connect through that firewall. Click Edit>Settings and expand the menu option entitled Connection. Click on the Proxy/Firewall option and fill out the information. If you are unsure of whether or not you are behind a Proxy Firewall or a SOCKS Firewall or are not sure of the specific settings for that firewall, consult your system administrator for the correct settings. Why wont my files transfer? If youve tried to transfer files and they are not transferring, you will receive a window telling you that the files could not be transferred. Click Details for more information on the exact error message sent to you by the server. Contact your Internet Service Provider or your Web Hosting Provider with this error message. CuteFTP Pro Version 1 Users Guide
57
How do I remove files from CuteFTP Pro that have finished transferring? To remove items from the queue that have already transferred or will not transfer, click Commands > Queue Commands>Remove all items. Choose Yes for the corresponding window that appears and the files will be removed from the queue. What is the Transfer Engine (TE)? Built on a modular design platform, CuteFTP Pros Transfer Engine (TE) is completely independent of the main application interface. Currently, transfers can continue even after the main interface is exited (if enabled in settings). In the near future, it will allow CuteFTP Pro to double as a download manager and offer API and COM support for application developers seeking a canned FTP solution. Understanding Error Dialogs At some point you are bound to forget a password, try to connect to a site that doesnt exist, or not have security privileges to transfer a file. On these and other occasions, you may encounter CuteFTP Pros improved error dialogs. An error dialog box contains the standard Windows red x error icon and a short error message. The dialog box also contains two buttons, Cancel and Details. Cancel dismisses the error dialog box. Clicking Details expands the error dialog to include a log file fragment with more information on the error. The Details box provides important information that can be used by expert users or GlobalSCAPE Technical Support to diagnose the problem. To make error reporting easier, the error dialog details can be copied for inclusion into an e-mail to tech support. Right-click in the log text area and choose Copy All Text. The entire contents of the error log window will be copied to the clipboard. Pasting this information into inquiries for help will greatly assist your Information Sciences department or GlobalSCAPE Technical Support to resolve the problem. Common Error Messages Some of the most common error messages users may encounter when using CuteFTP Pro are: Cant login Disconnecting: This error appears when the username or password is incorrect. The error message does not specify which component is incorrect; they both use the same message. However, you can determine if the error lies in the username by clicking the details button: COMMAND:> COMMAND:> USER ericm 331 Password required for ericm. PASS ***** 530 Login incorrect. CuteFTP Pro Version 1 Users Guide
58
Check the username displayed after USER for any spelling errors. If the name appears correct, then the error probably lies in the password. Open the sites Properties window and correct any username or password errors. Cant Resolve Host Name: The Cant Resolve Host Name message is displayed when CuteFTP Pro cannot make a connection to the FTP host address that you specified when you set up the connection. It could be compared to browsing to a web site that either is not up at the moment, or does not exist. There are several ways to approach this situation: 1. Make sure you are connected to the Internet. If you are not connected to the Internet, you will need to connect before you can connect to any FTP sites. 2. Make sure you typed in the FTP Host Address correctly. This would be just the host address of the server. For example, if you were given an FTP Host Address in the format: ftp://ftp.yourhost.com, you would only type in ftp.yourhost.com. Also be sure there is nothing after the host address, especially slashes (/) indicating subdirectories. If the server does not automatically put you in your default directory when you log in to it, then you can add the directory into the Default Remote Directory box when configuring this site. 3. Make sure you are not trying to connect to a HTTP server such as http:// www.cuteftp.com. You cannot connect to a HTTP (web) server with CuteFTP. If you do not know the FTP Host Address for your site, you will need to contact your server administrator for more information. We do not know or keep track of FTP Host Addresses. 4. If you have a Firewall, make sure it is properly configured. You can edit the firewall settings by clicking Edit > Global Settings > Proxy/Firewall. If you are not sure what the settings for the firewall are, you will need to contact your system administrator for that information. 5. If all of these options fail and you still have the same results, you will need to contact the server administrator of the site you are connecting to in order to resolve the problem. Requested action not taken: The file or directory you have attempted to access does not exist, or you do not have security privileges to access it. If the file appears in the directory listing, then you probably do not have security privileges. Check to make sure you are logged in as the correct user. COMMAND:> ERROR:> CWD /u1/ericm 550 /u1/ericm: No such file or directory. Requested action not taken (e.g., file or directory not found, no access).
Begin by bringing up the sites Site Manager Properties. Make sure you have entered a user name and password into the appropriate fields. If you only set up the site but not the user name and password, CuteFTP Pro would have CuteFTP Pro Version 1 Users Guide
59
connected anonymously. Since the server doesnt know who you are unless you log in, it wont give you access to your files without doing so. For a list of socket error codes please refer to this URL: http://msdn.microsoft.com/library/ psdk/winsock/errors_3wc2.htm. Error Code Numbers The number of your error code message can often give you a greater understanding of the problem by relating it to RFC 959s Reply Code. Code 500 Series The command was not accepted and the requested action did not take place. 500 501 502 503 504 530 532 550 551 552 553 Syntax error, command unrecognized. (This may include errors such as Command line too long.) Syntax error in parameters or arguments. Command not implemented. Bad sequence of commands. Command not implemented for that parameter. Not logged in. Need account for storing files. Requested action not taken. File unavailable. (e.g., file not found, no access). Requested action aborted. Page type unknown. Requested file action aborted. Exceeded storage allocation (for current directory or dataset). Requested action not taken. File name not allowed. Explanation
400 Series The command was not accepted and the requested action did not take place, but the error condition is temporary and the action may be requested again. 421 425 426 450 451 452 Service not available, closing control connection.(This may be a reply to any command if the service knows it must shut down.) Cant open data connection. Connection closed; transfer aborted. Requested file action not taken. Requested action aborted. Local error in processing. Requested action not taken. Insufficient storage space in system. File unavailable (e.g., file busy).
60
300 Series The command has been accepted, but the requested action is dormant, pending receipt of further information. 331 332 350 200 User name okay, need password. Need account for login. Requested file action pending further information. The requested action has been successfully completed.
200 Series Command okay 202 211 212 213 214 215 220 221 225 226 227 230 250 257 Command not implemented, superfluous at this site. System status, or system help reply. Directory status. File status. Help message.On how to use the server or the meaning of a particular non-standard command. This reply is useful only to the human user. NAME system type. Where NAME is an official system name from the list in the Assigned Numbers document. Service ready for new user. Service closing control connection. Data connection open; no transfer in progress. Closing data connection. Requested file action successful (for example, file transfer or file abort). Entering Passive Mode (h1,h2,h3,h4,p1,p2). User logged in, proceed. Logged out if appropriate. Requested file action okay, completed. PATHNAME created.
100 Series The requested action is being initiated, expect another reply before proceeding with a new command. 110 Restart marker reply. In this case, the text is exact and not left to the particular implementation; it must read: MARK yyyy = mmmm where yyyy is User-process data stream marker, and mmmm servers equivalent marker (note the spaces between markers and =). Service ready in nnn minutes. Data connection already open; transfer starting. File status okay; about to open data connection.
61
Technical Support
From the Globalscape, Inc. website (http://www.globalscape.com), we offer the following support and information services for our users: Search the Support Knowledge Base The fastest way to find thousands of answers from GlobalSCAPEs technical support experts is to search our Knowledge Base. Just enter a short description of what you are looking for and let our search engine do the work for you. Find Answers to Frequently Asked Questions (FAQs) Our FAQ section is definitely the place to start looking for answers. Our sophisticated Knowledge Base automatically ranks documents for the FAQ section so you really do see the most frequently asked questions. Take Tutorials If you are having problems with the basics of CuteFTP Pro, please refer to our tutorial section. It covers everything you need to get up and running. Receive a Lost Serial Number Through E-Mail If you need your serial number sent to you again, use the link above. Your serial number will be sent to your e-mail address in minutes! Consult Technical Support and Services Unregistered Users GlobalSCAPE provides free technical support to unregistered users via this Users Guide and our Web site. If you cannot find an answer to your question, you can e-mail us. Please provide a complete description of your problem so we can provide you with fast and accurate help. Unregistered users are not entitled to telephone support. Registered Users Before you call, be sure to check through this Users Guide and our Web site to make sure that you cannot find the answer to your question. When you do call, please be ready to provide us with registration information, such as your serial number, order ID (if applicable) or the e-mail address with which you registered. Limitations to Support GlobalSCAPE is happy to help you with any technical problems you may have with our software. However, we cannot help you with certain issues such as creating web pages or pictures, or any other issues not related directly to the workings of our software. For the most up-to-date and accurate assistance with problems you might have using CuteFTP Pro, refer to CuteFTPs Help file or our Web page at: www.globalscape.com.
62
Technical Support Contact Information If you cannot find the answers to your questions, contact us at support@globalscape.com, or call us at (210) 308-8267, Monday through Friday between 8 a.m. and 6 p.m., CST. GlobalSCAPE Web site: Technical support e-mail: Technical support phone: Sales and upgrade e-mail: Sales and upgrade phone: www.globalscape.com support@globalscape.com (210) 308-8267 8 a.m.- 6 p.m., Mon.-Fri. CST sales@globalscape.com (800) 290-5054 8 a.m.- 6 p.m., Mon.-Fri. CST
63
Function
Folder Up Delete File Cancel Transfer Help Rename Find Next Site Manager/Local Pane toggle - if closed, these panes will open Refresh Screen Cancel Transfer Log/Queue Window toggle - if closed, these panes will open Folder Synchronization Tool MDI Log Window toggle Folder/File Properties or Site Properties Select All Copy Change folder Execute File Find Filter Make New folder Quit CuteFTP Pro Reconnect Connect to URL Paste View File Cut Moves focus between left, right and bottom panes Download Upload
64
Index
A
Add 15 Anonymous Login 9 ASCII 16 Auto-reconnect 13 AutoDetect 16 Edit 15 Explicit SSL 12 Exporting Sites 19
F
File Transfer 20 Firewall Commands 51 PASV/Port 14 Settings Proxy/Firewall 49 Proxy/Socks 18 Socks/Firewall 48 Folder Synchronization 27, 28 FTP Explorer 1.0 18 FTP Voyager 6.0 and up 18
B
Binary 16 BlueZone 1.01 19 Bookmark 30 Broken Transfer 24, 25
C
Cache 17 Certificate 36 CHMOD 32 CoffeeCup 4.0 18 Connect to URL 11 Connection Wizard 6, 9 Continuous Synchronization 29 Crystal FTP 2000 18 CuteFTP 1.3 18 CuteFTP 1.4-2.0 18 CuteFTP 3.0-3.5 18
H
Host 15 Address 9 Name 9, 49 HTML 53, 54 Editor 52, 54 Tag 55 HTTP 11 HTTPS 12
I
Images 53 Importing Sites 18, 19 IP address 9 ISP 9
D
Delete Bookmarks 29, 31 File Extensions 43 Files 21, 22, 26, 28, 38 HTML Template 54 Keyboard Shortcut 64 Logs 44 Sites 15 Disconnecting 13 Downloading Folder tree problems 46 From URL 11 Manually resuming 25 Multi-Part downloads 23 Site-to-Site 22 Smart Overwrite Rules 37 Stopping/Resuming 24
J
Java Scripts 55
K
Keyboard 64 Keyboard Shortcuts 64
L
LANs 49 LapLink 2.0 18 LeapFTP 2.7 18 Lexicographic 47 Log 43, 44 Login Method 15
E
E-mail Address 14
M
Manually Registering 6 65
Mask 32, 34, 35, 45 Masks 45 Mirror 27, 28 Multiple Concurrent Transfers 22 MVS host 17
N
Navigation 43
P
Password 15 PASV 14, 16, 46, 47 PORT 48 PORT number 49 PROXY 40 Proxy 18, 40, 41, 48, 49, 50, 51 Commands 51 PASV/Port 18 Settings Proxy/Firewall 49 Proxy/SOCKS 18 SOCKS/Firewall 40 Proxy server 49
SKA 12 Sm.dat file 19 Smart Keep Alive 12 Smart Overwrite 36 Smart Sorting 30 Snippets 55 SOCKS 48 Socks 18 SOCKS4 49 SOCKS5 49 SSL 12, 23, 36 Implicit/Explicit SSL 12 Symbolic Links 29, 46 Synchronization 29
T
Threaded Transfer 22 TOC 45 Toolbar 64 Transfer Engine 5, 8, 20, 21, 25, 27, 29, 37, 38, 39, 40, 44 TransSoft 4.4 18
U
Uninstalling 6 Uploading 22, 24, 25 URL 11 User ID 9, 15 User Name 15
Q
Queue 21, 43 Quick Connect 11
R
Raw listing 17 Reconnecting 13 Registering 6 Resolve links 46
W
WANs 49 WarFTP 46, 47 Wide Area Networks 49 Wildcard 34, 45 WS_FTP 5.0 and up 18
S
Script 39, 40, 52, 55 Create 39, 40 HTML 52, 55 List 49 Schedule 39 Transfer Engine 25 Secure Socket Layer 12, 36 Serial Number 6 Server Connection Error 6 SFTP 12, 40 Shortcuts (Keyboard) 64 Simple listings 17 Site Label 9 Site Manager 9, 10, 15, 18, 22 Security 18 Site Properties 15 Site Properties Dialog Box 10, 15 Site-To-Site 22 66
67