Version 9 User Guide

Transcription

1 Versin 9 User Guide

2 Glbalscape, Inc. (GSB) Address: 4500 Lckhill-Selma Rd, Suite 150 San Antni, TX (USA) Sales: (210) Sales (Tll Free): (800) Technical Supprt: (210) Web Supprt: Cpyright Glbalscape, Inc. All Rights Reserved Updated September 27, 2017

3 Table f Cntents Chapter 1. Getting Started What's New in this Versin? System Requirements Installing the CutFTP Applicatin Activating CuteFTP Trubleshting Prduct Activatin Backing Up Registratin Infrmatin Upgrading CuteFTP Mving CuteFTP t a Different Cmputer Quick Reference Guide Chapter 2. The CuteFTP Interface Main Menu Displaying r Hiding Tlbars The Standard Tlbar HTML Editr Tlbar Status Bar Keybard Shrtcuts The Site Manager Lcal Files and Flders Flder Listing Transfer Queue Cnnectin Lg Individual Sessin Lg Glbal Optins Dialg Bx Site Prperties Site Prperties - General Tab Site Prperties - Actins Tab Site Prperties - Type Tab Site Prperties - Optins Tab File and Flder Prperties Abut CHMOD Permissins Filtering the List f Files and Flders Viewing Thumbnails Changing Hw Files and Flders are Displayed Lckstep Flder Navigatin Default Language Display Settings iii

4 CuteFTP v9 User Guide Prmpts Windws Explrer Right-Click Menu Sund Optins Lg File Settings Security Settings Chapter 3. Defining Sites Using the Cnnectin Wizard The Site Manager Internet Cnnectin (DUN/LAN) Settings Cnnectin Optins Changing the FTP Prt Cnnecting t an HTTP Site Cnnecting t Secure Sites Cnnecting t Secure Scket Layer (SSL and TLS) Sites Cnnecting t Secure Shell (SSH2) Sites Autmatically Displaying a Specific Flder when Cnnecting t a Site Multiple Cncurrent Cnnectins Perfrmance Limitatins Using the ACCT Cmmand Passwrd Prtect Site Manager Cntent Staying Cnnected with Smart Keep Alive SOCKS 4 and 5 Cnnectin Settings Prxy Cnnectin Settings Encrypt Passwrds Using OTP TappIn Site Creatin Web Distributed Authring and Versining (WebDAV) Chapter 4. Site Administratin Imprting and Exprting Site Cnfiguratin Remving a Site frm the Site Manager Changing a Site's Cnnectin Settings r Lgin Infrmatin Changing the Data Cnnectin Type (Prt r PASV) Prxy Settings fr Individual Sites Crrecting Times fr Sites in Different Time Znes Specifying Whether t Save a Site's Infrmatin - Caching Designating a Site's Server Type Finding a Site in the Site Manager Creating and Using Bkmarks Chapter 5. OpenPGP Security Settings OpenPGP keys iv

5 Table f Cntents Uplading and Dwnlading Files Using OpenPGP Keys Chapter 6. SSL/TLS Cnnectins (FTPS/HTTPS) Learning abut SSL SSL Security Settings Creating SSL Certificates Signed SSL Certificates Chsing a Certificate fr SSL Sessins Accepting Server SSL Certificates Imprting r Remving SSL Certificates frm the Trusted List Using a Clear Data Channel with SSL Using a Clear Cmmand Channel with SSL Secure Site-t-Site Transfers Using SSCN Trubleshting SSL Cnnectins Unable t Cnnect t Titan FTP Server when Using SSL Chapter 7. SSH2 Cnnectins (SFTP) SFTP in CuteFTP Transprt Layer Settings Authenticatin Layer Settings Authenticating in SSH SSH2 Security Settings Creating SSH2 Key Pairs Using SSH2 Key Pairs Trubleshting SFTP Cnnectins Cannt Cnnect t SSH2 (SFTP) Sites SFTP Errrs Public Key Authenticatin Fails Chapter 8. Transferring Files and Flders Transferring Files and Flders Transfer Settings Startup and Exit Optins Smart Overwrite Settings Default Dwnlad Flder Rename Rules Symblic Links Queuing Files and Flders fr Transfer Remving Items frm the Queue Uplading Files frm Anywhere in Windws Transferring Files in Order Navigatin Optins v

6 CuteFTP v9 User Guide Tlerance Settings Stpping Transfers TOC File Settings Cnfiguring Optins fr Cmpleted Transfers Preserving the Lcal Time Stamp Resuming Transfers Specifying Time CuteFTP Waits after a Transfer Cmpletes Executing Cmmands n Dwnladed Files Viewing Transfer Status Lgs Using Quick Cnnect Using the Clipbard t Transfer Pasting an URL Directly int the Transfer Engine Scheduling Transfers Site-t-Site Transfers (FXP) Multi-Part (Accelerated) Transfers Accelerating Transfers with Mde Z Imprving CuteFTP Perfrmance When Transferring Large Numbers f Files at Once ASCII Transfer Settings Specifying Binary r ASCII Mde Verifying Integrity f Transferred Files Cmpressing and Decmpressing Using Scripts t Transfer Files Recrding a Macr Playing a Recrded Macr Custm Cmmands Saving and Reusing a List f Transfer Tasks Imprving Slw Transfers Transferring Manually Uplad/Dwnlad Filtered Files FTP Cmmands Unicde Supprt in CuteFTP Chapter 9. Managing Files and Flders Opening, Editing, Renaming, and Deleting Files Updating r Refreshing Flder Listings Listing Files and Flders in Order Finding Files and Flders Selecting a Grup f Items Mving Items frm One Flder t Anther n a Remte Server Changing File and Flder Permissins n Remte Sites vi

7 Table f Cntents Wildcard Masks Displaying Hidden Files r Flders Cmparing Flders by Case, Size, and Date Synchrnizing Flders Backing Up Lcal Files t Remte Hst Restring Lcal Files Backed Up t Remte Hst Backing Up Remte Flders Mnitring a Lcal Flder fr Changes Listing Files n HTTP Sites Chapter 10. Integrated HTML Editr HTML Editr Overview HTML Editr Settings Default HTML Template HTML Tags fr a Specific Brwser HTML Cde Snippets and Java Scripts Creating a New HTML Dcument Finding and Replacing Text in HTML Dcuments Page Lading Speed and File Size Basic HTML Tags Cascading Style Sheets (CSS) Using Clrs Saving HTML Dcuments Opening an HTML Dcument fr Editing Previewing an HTML Dcument in a Brwser Editing an HTML Dcument n a Remte Site Printing an HTML Dcument Clsing an HTML Dcument Opening the HTML Editr in a Full Windw Adding Cunters and Other Utilities Learning HTML Chapter 11. Transfer Engine (Scripting) Abut the Transfer Engine Transfer Engine (TE) Initial Setup Distributing and Licensing the Transfer Engine Installing the TE (fr Distributin) Registering the TE (fr distributin) COM Registratin f the TE (fr Distributin) Finalizing TE Distributin Trubleshting TE Distributin vii

8 CuteFTP v9 User Guide Using the TE t Cnnect via FTPS (When Running a Script and nt Lgged In) Transferring Files r Sites with the Transfer Engine Running Scripts Creating Scripts Methds, Prperties, and Wildcards Overview Available Methds and Prperties Timeut Strategies fr the Wait Methd Using a Script t Cnnect t a Remte Site Using a Script t Dwnlad a File Scheduling Scripts with the Windws Task Scheduler Scheduling Scripts with the Windws NT 4 AT Scheduler Running the Transfer Engine withut a User Present Running the Transfer Engine frm a SQL Jb Help with Scripts Disabling Prmpts Trubleshting TE Prblems Chapter 12. Trubleshting Cnnectin and Transfer Errrs Antivirus Prblems Cannt Clse Data Transfer Gracefully Cannt Cnnect t Server Cannt Create Multiple Cnnectins t the Same Server Cannt Dwnlad Executable Files Cannt Dwnlad Files frm a VMS Server Cannt Initiate Data Transfer Cannt Reslve Hst Name Cannt See Remte Files r Flders Child Transfer Failed Cnnecting after a 425 Errr Cpy and Paste Functins Remve File frm the Remte Flder Errr 421 Messages Failed t Establish Data Scket FTP Status and Errr Cdes High Memry Usage HTTP Status and Errr Cdes Installshield Errr 1628: Failed t Cmplete Script-Based Installatin Nt Enugh Credits t Dwnlad Shell cannt get Data frm TE Site-t-Site Transfer Limitatins Scket Errrs viii

9 Table f Cntents Overwrite Repeatedly Prmpts Me Permissin Denied Prt Already in Use Errr with Dial-up VPN Transferring t Case-Sensitive Servers Trubleshting Cnnectins Truncated Listings Using CuteFTP behind a Ruter Using CuteFTP with Nrtn Internet Security Using Errr Messages and Lgs t Trublesht Windws Firewall is Blcking Cnnectins Chapter 13. Getting Help Glbalscape Supprt Center Finding Infrmatin in the Help Searching the User Guide r glbalscape.cm Printing a Help Tpic Sharing Tpic Links frm the Online Help Using the Knwledge Base Serial Number Chapter 14. License Agreements CuteFTP Versin 9 End-User License Agreement Registratin and Trademarks rd-Party License Agreements Index 269 ix

10 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. x

11 Chapter 1. Getting Started At hme r at the ffice, industry-leading CuteFTP sftware lets yu intelligently and securely mve yur imprtant files acrss multiple lcatins ver WAN r LAN. With CuteFTP yu can publish web pages; dwnlad the latest music, images, and sftware; r transfer files between servers at hme, yur Internet Service Prvider, the ffice any server that yu can access ver the netwrk. CuteFTP is simple enugh fr a nvice FTP user, yet pwerful enugh fr experienced users. The user-friendly interface allws yu t easily update and maintain sphisticated websites Yu can safeguard transfers f missin-critical files with CuteFTP's security features Yu can even schedule and script transfers with minimal verhead using the Transfer Engine. Yu can use the Transfer Engine frm within CuteFTP r with any COM-enabled scripting r prgramming language An integrated, clr-cded HTML editr allws yu t create, pen, and edit HTML dcuments n yur cmputer r a remte server within CuteFTP Unicde supprt CuteFTP supprts Unicde file names Integratin with TappIn by Glbalscape File Transfer Security Secure SSL Sessins CuteFTP secures sessins with 128-bit SSL, the same secure technlgy used by Internet brwsers and servers fr authenticatin, message integrity, and data cnfidentiality. SSL Sessin Chices When setting up yur SSL cnnectin, CuteFTP lets yu chse between three cmmn SSL implementatins, including TLS (AUTH TLS)*, SSL Implicit** (direct cnnect ver prt 990) and SSL Explicit** (AUTH SSL) mde. Mst FTP servers supprt at least ne, while sme (such as Glbalscape EFT Server) supprt all three. SSL Certificates CuteFTP includes a full certificate management system, giving yu the ability t accept r reject a server's certificate, stre accepted certificates in a lcal database, imprt and exprt certificates in the lcal stre, use Windw's trusted certificate stre fr certificate apprval, and the ability t create yur wn "strng" (4096-bit) self-signed certificate set, including a certificate request file (fr signing by a Certificate Authrity (CA) such as Verisign r Thawte). HTTPS Sessins Cnnect, brwse directries, and transfer t/frm HTTPS Sites using the same strng security (SSL) that web brwsers use fr secure e-cmmerce transactins. HTTPS Sites als rely n certificates t verify that the client is cmmunicating with the desired HTTPS server. Secure Shell (SSH2) Sessins CuteFTP als supprts the SSH2 prtcl, specifically, SFTP. SFTP Cnfiguratin Optins CuteFTP gives yu vast cntrl ver yu SFTP sessin, including chice f encryptin ciphers, MAC (Message Authenticatin Cde) types, cmpressin, and authenticatin* mechanisms t use. SFTP Identity Files Use an identity file supplied by yur hst r create yur wn key-pair fr authenticatin. When creating yur wn identity file, yu can chse between RSA and DSS public key frmats, key length (up t 4096 bits), and key strage lcatin. Stre trusted server identity files (certificates) in a lcal database. Yu can als imprt r exprt identity files frm yur lcal trusted stre. 11

12 CuteFTP v9 User Guide OpenPGP Encryptin and Decryptin CuteFTP uses an pen-surce encryptin (OpenPGP) technlgy t encrypt data befre it is sent t a server r t decrypt data retrieved frm a server. OpenPGP uses public keys and private keys. This allws yu t give thers yur public key, which they can use t encrypt a file. Only yu can decrypt the file with yur private key. The OpenPGP functinality in CuteFTP lets yu encrypt files befre uplading r decrypt files after dwnlading; create OpenPGP keys, key sizes, and select RSA r DSS cryptsystems; and imprt and exprt OpenPGP keys. Secure Lgin Using OTP Sme situatins call fr a secure lgin sequence, but nt the securing f subsequent data and cntrl channel transactins. Fr this case, CuteFTP ffers One Time Passwrd (OTP) authenticatin, a prtcl based n Bell Lab's S/Key technlgy. OTP authenticatin is accepted by many UNIX and sme Windw's FTP hsts, including Glbalscape EFT Server. Passwrd Manager Encrypt yur Site Manager cntents using the pwerful Blwfish cipher r cmpletely disallw passwrd saving, including URL and Quick Cnnect histry, between applicatin sessins. Yu can als change the default Site Manager and sessin-lg strage lcatins. These plicies and features help mitigate risks when running n a shared r physically unrestricted machine. Cnnectin Optins Cnnectin Wizard CuteFTP's Cnnectin Wizard can guide yu thrugh setting up a new FTP cnnectin. Once cmpleted, CuteFTP will autmatically cnnect t the new Site and stre it in yur Site Manager fr subsequent cnnectins. Site Manager Stre cmmnly accessed Sites in the built-in address bk, the Site Manager. The Site Manager allws yu t set specific ptins per-site, and yu can exprt r imprt Site data, including address bks frm 3rd-party FTP clients r previus versins f CuteFTP. Yu can ptinally passwrd prtect yur Site Manager with strng encryptin t prtect yur Site infrmatin (especially Site passwrds). Quick Cnnect CuteFTP ffers varius ther cnnectin chices. Use the Quick Cnnect bar t enter Site cnnectin infrmatin; use the Paste URL dialg t paste entire URLs frm the clipbard, create a new Site, r launch an existing ne directly frm the main menu, r have CuteFTP autmatically recnnect t the last visited Site n prgram startup. Prxy / Scks / Firewall CuteFTP allws yu t cnnect via prxy, scks, r firewall, including scks 4 & 5, HTTP, r FTP prxy cnnectin ptins. Manually cnfigure prxy r firewall cnnectin settings r have CuteFTP autmatically detect Internet Explrer's prxy settings, including "prxy.pac" prxy script files. NAT UPnP CuteFTP will attempt t use the UPnP (Universal Plug and Play) NAT interface t prvide prper prt-mapping when cnnecting securely frm behind a NAT/firewall using PORT mde (rather than PASV, due t the remte hst als being behind a NAT/firewall). Withut UPnP, yu wuld need t manually set the prt range in the client and als enable and frward them in the NAT/firewall device. Smart Keep Alive Stay cnnected t Sites that autmatically discnnect yu when n activity is detected ver a certain perid. Cnfigure varius cmmands t be sent at randm intervals t simulate user activity. CuteFTP's keep alive feature differs frm its cmpetitrs in that it ffers cmpletely custmizable keep alive ptins, including time t start sending cmmands, randm time intervals between cmmands, a custmizable cmmands list, and aut-recnnect and redial ptins. Multiple Cnnectins Cnnect, brwse and navigate multiple Sites at the same time. Mst FTP clients frce yu t discnnect frm a Site when cnnecting t an alternate ne. Each cnnectin takes place in its wn windw. Cnnectin windws can be tiled, cascaded r accessed by clicking n the crrespnding tab. 12

13 Getting Started Sessin Lgs Cnnectin and transfer lgs can be displayed, captured t the Windws clipbard, and recrded t file. Determine where lgs are saved, hw ften they're updated r deleted, and mre. Smart Keep Alive cmmands are nt recrded and time stamps are included by default, greatly imprving usability. Wrk Offline Site caching allws yu t minimize bandwidth while yu brwse. Brwse previusly visited Sites while ffline, speeding up navigatin while saving bandwidth and netwrk resurces. This benefits users in cases where they are charged fr time cnnected and in cases where the hst Site restricts access time. Cnnectin Optins Set timeut, retry and delay values, cnnectin limits, data cnnectin prt range, n cnnect events, and ther cnnectin related settings glbally r per-site. Transfer Optins Standard Transfers CuteFTP supprts multiple methds fr transferring files and flders, including keybard, muse, menu, and tlbar. This simplest way t transfer is t "drag-and-drp" files int the Transfer queue. Scheduled transfers Schedule a file, flder, r queue entry t be transferred later. Specify whether the scheduled event shuld recur at specific intervals and even chse frm certain events t take place nce the transfer is cmpleted. Site-t-Site transfers (FXP) Allws yu t transfer files frm ne remte server t anther, bypassing yur cmputer altgether, thus decreasing the time necessary t cmplete the transfer. Site-t-Site transfers are made easy with a simple "drag 'n drp" between remte Site panes. (While CuteFTP supprts this feature, many servers blck it due t "prt theft" cnsideratins.) Transfer resume Transfer with cnfidence, even with slw cnnectins r if yu're using a lwer perfrmance FTP server. CuteFTP can detect a brken transfer and autmatically resume it where it left ff, rather than transfer the whle file ver again. Queue Transfers Select files and flders spanning multiple remte Sites and queue them fr future transfer. CuteFTP's rbust queue management system allws yu t manage the rder (pririty) f queue items, track the transfer status f queue items, schedule queue items, and mdify a queue item's prperties. Yu can als save a snapsht f the queue and then lad and run it in the future. Multi-part transfers Yu can speed the transfer f large architectural, graphic, r engineering files with multi-part accelerated dwnlads. CuteFTP can split a single dwnlad file int multiple parts and later recmbine them upn receipt. Cmbined with Glbalscape EFT Server, CuteFTP is the nly client that can perfrm multi-part uplads. Simultaneus Transfers; Cncurrent transfers Cnnect, brwse, and navigate multiple Sites at the same time. Each cnnectin takes place in its wn windw. Cnnectin windws can be tiled, cascaded, r accessed by clicking n the crrespnding tab. Cmpressed Transfers Cmpress file and flders t.zip,.cab, and Gzip/Tarball archives prir t uplading them, as well as, decmpress dwnladed archives f the same type. Bandwidth thrttling Specify the number f kilbytes per secnd t thrttle the bandwidth f all sessins n CuteFTP. Transfer integrity Verify the file integrity after a transfer has been cmpleted. This feature relies n a prprietary cmmand supprted by Glbalscape EFT Server. Overwrite Rules Cnfigure CuteFTP t determine whether an existing file that matches ne being transferred needs t be verwritten, renamed, r skipped based n date, size, and ther criteria, r chse t be prmpted each time a matching file is fund. 13

14 CuteFTP v9 User Guide Aut-Rename Transfers Create rules t change a file's name, extensin, r case during transfer. Specify the surce and destinatin name, including wildcards, and whether t change the case f a transferred file. Right-click shell integratin Transfer files frm the Windws Desktp r Explrer. Advanced Transfers Other transfer ptins in CuteFTP include transfer mde (ASCII/Binary/Aut), data cnnectin mde (PASV/PORT/Aut), after transfer events, time stamp handling, byte ffset frm which t restart brken transfers, and mre. Autmatin Transfer Engine Create sphisticated scripts r recrd sessins fr autmating FTP tasks using CuteFTP's Transfer Engine. The mdular Transfer Engine uses an industry standard Cmpnent Object Mdel (COM) interface t expse mst f CuteFTP's functins and prperties. Chse between manually creating scripts using yur favrite prgramming r scripting language r autmatically creating scripts using the sessin recrd and playback tl. Macr recrding and playback CuteFTP can recrd and playback entire sessins using the pwerful macr recrd/playback tl. Sessins are recrded in Visual Basic Script and take advantage f CuteFTP's COM-expsed transfer engine (TE) interface. Integrated HTML editr This pwerful text editr includes clr-cded HTML and PERL tags, Site-wide find and replace, HTML cde-cmpletin, and integratin with CuteFTP that lets yu edit files n yur FTP server withut dwnlading them. Synchrnize flders Mirrr yur lcal drive, remte Site, r bth with just a cuple f muse clicks using CuteFTP's Flder Synchrnizatin tl. Schedule recurring synchrnizatin events fr cntinuus mirrring f lcal and remte flder trees. Yu can mnitr mre than ne flder r synchrnize multiple Sites with the Flder Synchrnizatin Wizard, which guides yu thrugh setup. Flder Cmparisn Cmpare flders befre synchrnizing them. Lcal and remte flder cntents can be cmpared based n case, name, date, r size. Files that are different frm each ther are highlighted and can be selected and transferred fr directry-wide changes. Site Backup Schedule a single r recurring backup f yur entire Site in three easy steps with ur Site Backup Wizard. CuteFTP will dwnlad the entire Site int a backup flder, cmpress it (.ZIP,.CAB, r GZIP cmpressin), and then label the resulting archive with a time and date stamp. Lcal Backup Schedule a single r recurring backup f yur lcal cmputer and safely stre yur data n a remte server. CuteFTP will uplad the selected files and flders t an archive n a remte FTP server and will restre yur data frm the archive if yur cmputer ever ges dwn. Remte Backup CuteFTP allws yu t create cpies f remte files and flders n yur lcal cmputer regularly r at a scheduled time. CuteFTP als cmpresses the backup autmatically. "On exit" events CuteFTP can be set t autmatically exit, shutdwn yur cmputer, run a virus scan, r any number f ther tasks after cmpleting a transfer. Flder mnitring (AKA "Ht Drp"); Detect changed items in a specific lcal flder tree autmatically. If changes are detected, the mdified files r flders are upladed t a predefined server. Wrks great fr publishing Web site changes frm a staging server t a live server. Custm Cmmands Create sets f cmmnly used cmmand sequences and assign them a shrtcut key fr quick access. If needed, send FTP cmmands directly t the FTP server using the RAW FTP cmmand feature fr mre granular cntrl f the FTP sessin. File Prperties View r change permissins (CHMOD) fr multiple files withut having t knw their numerical values by simply selecting whether Read, Write, r Execute is allwed fr each grup. View file and flder size, date, wner values, and mre. 14

15 Getting Started Time Stamp Cntrl Preserve a server's time stamp fr dwnladed files. Chse t keep the lcally defined time fr upladed files. Define the time ffset fr the server fr greater efficiency in transfer and synchrnizatin verwrite rules. View and Open View the cntents f remte text-based files quickly using Ntepad r the builtin editr. Yu can als pen files, which will dwnlad an item (if necessary) and run it using the assciated prgram. Event Triggers Specify autmatic events t ccur upn prgram startup, upn cnnecting t a Site, and upn transfer success. Chse t play sunds fr varius events as they ccur and execute cmmands (such as virus scans) n files after they are dwnladed. Navigatin Advanced search Find files and flders easily, by name, size, r creatin/mdificatin date, whether they are n yur lcal cmputer r a remte server. Lckstep Flder Navigatin Navigate simultaneusly thrugh lcal and remte flder directries that share the same structure. This makes it easier t cmpare the tw when synchrnizing cntent. Flder Navigatin Navigate remte and lcal flders using the muse, keybard, and tlbar buttns as yu wuld when navigating thrugh flders n yur Windws Desktp r Explrer. Flder Management Create new flders, rename existing nes, r delete unused flders. View a flder's prperties and perfrm standard peratins, such as cut, cpy, and paste. Default Dwnlad Flder Specify a default flder fr placing yur dwnlads. Yu can als specify a default lcal and remte flder fr each Site, s when yu cnnect, CuteFTP will autmatically switch t the chsen flders. Flder Bkmarks This feature is similar t the favrites r bkmark feature in yur brwser. Yu can bkmark ne r mre flder paths per Site, and later return t thse paths by selecting the bkmark. File and Flder Links Navigate flder links with ease with the help f CuteFTP's varius link cnfiguratin ptins. These ptins tell CuteFTP hw t interpret links, hw t navigate t and frm links, and what t d with the resulting target. Flder Listings View flder listings fr a variety f hsts, including UNIX, NT, VMS, MVS, AS/400, OS/2, Sterling CONNECT: Enterprise, Van Dyke SSH, and many mre. Simple flder listing supprt (NLST), and raw flder listing ptins help display uncmmn r prprietary flder listings nt supprted by CuteFTP. Filtered listings Cnfigure include and exclude masks fr displaying specific items within a flder. Use filtering t nly display r dwnlad specific items r as a way f sending specific parameters t a server's LIST cmmand prgram. File and Flder Select Use the varius Grup Select features alng with wildcard masks t mark specific grups f items within a flder fr transfer r deletin. File and Flder Search Search fr files r flders cntained within a flder. Search fr exact r partial names, including wildcards. Navigatin Settings CuteFTP has an enrmus set f navigatin features and ptins. Apart frm thse abve, CuteFTP can lck a lcal flder t the active remte pane, cnfigure flder index (table f cntents) ptins, cnfigure flder caching, aut-refresh flders after transfer and navigatin events, set tlerance settings fr prblem servers, recursively delete acrss flders, delete t recycle bin, and much mre. 15

16 CuteFTP v9 User Guide Display Optins View thumbnails Find lcal r remte pictures quickly using Thumbnail View. Tlbar Custmize the tlbar in variety f ways. Fnts and Clrs Set lg, editr, and main windw fnts and clrs. File and Flder size Select whether t display file and flder sizes in kilbytes r let CuteFTP determine the best way t display them. Srt Srt lcal and remte listings just like yu wuld in Windws. Als chse between a natural language srting alternative t the traditinal lexicgraphic srting f alphanumeric sequences. Panes Chse which panes t shw, whether t display Site and transfer lgs, and whether gridlines shuld be displayed in each pane. Prmpts Chse whether t display errr and event prmpts. CuteFTP will als display detailed errr messages fr a better understanding f cnnectin related errrs. Sunds Specify sunds fr certain events, such as when a successful cnnectin r transfer is made. Fcus CuteFTP ptinally highlights the active pane, helping yu visually identify which pane has the fcus. Use the tabs n each pane t tggle between active sessins, between the Site Manager and Lcal Drives tabs, and between the Queue Windw and Lg Windws. What's New in this Versin? CuteFTP versin 9 includes the fllwing imprvements: Unicde supprt thrughut CuteFTP (except fr the integrated HTML Editr) Ability t specify the filename encding fr each Site in the Site manager as UTF-8, ASCII, r Aut-detect (default). Yu can als specify filename encding separately fr SFTP and FTPS Sites in Glbal Optins > Transfer settings. Ability t save a text-based file as UTF-8 encding frmat when yu pen it fr editing Site Manager passwrd reminder prmpt Site Manger imprt/exprt wizard supprts nly text files. Updated r replaced 3rd-party libraries used in CuteFTP, including 7zip (as part f UNICODE changes), Zlib, lg4cpp, pugixml, Veridis (Refer t License Agreements fr mre infrmatin) Updated SSL.DLL Updated SFTP.DLL and SFTP key manager (See nte in Upgrading CuteFTP regarding SFTP keys.) TappIn integratin: TappIn Sites cnfigured in the Site Manager are indicated by the TappIn lg TappIn "test drive" Site installed by default Ability t create a TappIn accunt frm CuteFTP Supprt fr Web Distributed Authring and Versining (WebDAV), including TappIn and TappIn Lite users. Servers with WebDAV supprt are expected t return a "DAV" header in respnse t an HTTP(S) OPTIONS request frm the client. CuteFTP autmatically treats servers exhibiting this behavir as WebDAV servers. CuteFTP Pr, Hme, and Lite have all been merged int ne CuteFTP prduct. CutePODCast manager was remved Fr a cmplete versin histry, visit 16

17 Getting Started System Requirements Windws XP, Windws Server 2003, Windws Server 2008 R2, Windws Vista, Windws 7, and Windws 8 An Internet cnnectin, fr accessing remte servers Web brwser (fr nline registratin, accessing the Knwledgebase, and accessing Supprt infrmatin) The CuteFTP test effrt spanned multiple releases f each f the fur mst ppular brwsers thrughut ur testing. CuteFTP was tested n the versins f the fllwing brwsers that were current at the time f testing: Chrme v21 and later Firefx v14 and later Safari v5.1 and later Internet Explrer v8, 9, and 10 At the time f release f CuteFTP, n cmpatibility issues were nted with any f the current versins f the brwsers listed abve. If any issues are discvered with future releases f these brwsers, such issues will be nted in the Glbalscape Knwledgebase at It is a gd idea t keep yur brwser updated, as new versins are ften released t fix security issues. Installing the CutFTP Applicatin Installing CuteFTP is fast and easy. The installatin wizard steps yu thrugh the prcess with n cnfusing ptins t set in a typical installatin. T install CuteFTP 1. D ne f the fllwing: Dwnlad and save CuteFTP n yur desktp, then duble-click the executable t run the installer. Place the installatin CD in yur DVD/CD-ROM drive. Installatin shuld begin autmatically. If yur DVD/CD-ROM drive des nt supprt autmatic installatin: a. Duble-click My Cmputer lcated n the desktp. b. Duble-click the DVD/CD-ROM drive icn. c. Duble-click the installatin prgram. 2. The Welcme page f the installer appears. Click Next. 3. The License Agreement appears. Click Yes t accept the agreement. 4. The Chse Destinatin Lcatin page appears. The Destinatin Flder bx displays the default lcatin. T specify a different lcatin, click Brwse. 5. Click Next. The Setup Status appears and CuteFTP installatin prgress is displayed. 6. The InstallShield Wizard Cmplete page appears. If yu want t place a shrtcut n the desktp, select the Install a shrtcut t CuteFTP n my desktp check bx. Click Finish. 7. Duble-click the desktp shrtcut r the Start menu shrtcut (Start > All Prgrams > Glbalscape > CuteFTP 9) t pen CuteFTP. The Welcme t CuteFTP 9 dialg bx appears. 17

18 CuteFTP v9 User Guide 8. D ne f the fllwing: If yu have a serial number, click Enter Serial Number and fllw the prcedure in Activating CuteFTP t register yur cpy f CuteFTP 9. If yu d nt have a serial number, click Cntinue t begin the trial. 9. G t the prcedure fr Using the Cnnectin Wizard. (Befre yu begin transferring files, yu will need t create a "Site" with which yu will cnnect t a server t transfer files.) Activating CuteFTP CuteFTP must be activated within 30 days r it will n lnger functin. When prmpted, prvide the serial number yu received when yu purchased the prduct. Yu can use either yur first and last name r yur cmpany name. After yu have prvided the infrmatin, yu can view yur activatin infrmatin n the main menu by clicking Help > Abut CuteFTP. T ensure yur sftware is activated accurately, prvide all f the ptinal details that are requested s that we can cnfirm yur eligibility fr technical supprt r any upgrades that may becme available in the future. Yur serial number can be fund n the invice yu received by r n yur prduct packing if yu btained a bxed versin. If yu have lst yur serial number, yu can request a cpy using Glbalscape's Lst Serial Number frm. Custmer Supprt can lcate yur serial number if yu prvide yur name, address, rder ID, r any ther pertinent data that might help us lcate yur riginal purchase recrd. When yu enter yur registratin infrmatin, it will be transmitted t Glbalscape via the Internet. As part f the registratin, the sftware assigns a unique number t yur cmputer based n system infrmatin and reprts this number t us. We use this data t help us prevent the prgram frm being cpied nt mre cmputers than permitted by the license. T register successfully, yu must be cnnected t the Internet and have administratr privileges n yur cmputer. If a firewall r prxy server is in use, the netwrk administratr shuld ensure prt 80 is pen during the registratin prcess. If yu d nt have Internet access n the cmputer n which CuteFTP is installed, refer t the Trubleshting sectin belw. T activate CuteFTP 1. On the Welcme screen, click Enter Serial Number r, n the main menu, click Help > Enter a serial number. The Registratin wizard appears. 2. In the Serial Number bx, prvide the serial number, then click Next. 3. Prvide yur name, address, cmpany name, and ther details, then click Next. 4. If nline registratin fails, yu can try again, g t the Glbalscape website t register, r a request t Glbalscape supprt. Instructins are prvided in the message. If the prblem is yur Internet cnnectin, yu might need t cnfigure an HTTP Prxy. Refer t Unable t Cnnect due t Prxy Settings belw. 5. T save a backup f the serial key in text frmat n a lcal drive, click Backup and Print Registratin Data. This infrmatin is useful if yu change cmputers and need t install the sftware n the new cmputer. 6. In the Backup Registratin Lcatin dialg bx, brwse fr the flder in which yu want t save the backup, then click OK. 7. Click Finish. 18

19 Getting Started Trubleshting Prduct Activatin If activatin fails, try the fllwing reslutins: Invalid Serial Number - The serial number must be entered exactly as it appears n yur invice r label. It is nt case sensitive. If yu received a digital invice, avid typing errrs by cpying the serial number t the Windws clipbard and then paste it (CTRL+V) int the serial number bx in the registratin wizard. Serial Number Entered fr the Wrng Prduct type - Serial numbers are specific t a particular prduct. Duble-check yur invice t see which prduct and versin yu purchased. Cmpare that t the prduct name and versin shwn in the Abut dialg bx r n the splash screen. If they d nt match, then dwnlad the crrect prduct frm the Glbalscape website. If yu have accidentally purchased the wrng prduct, then cntact the Glbalscape supprt team. Registratin Unable t Cmplete due t a temprary Netwrk Prblem - Because activatin takes place ver the Internet, CuteFTP must be able t cnnect t ur registratin server t cmplete the activatin prcess. Try again after the netwrk prblem is reslved r refer t the paragraph belw regarding activating CuteFTP n a cmputer that des nt have Internet access. If yu d nt have Internet access n the cmputer n which CuteFTP is installed, fllw the activatin instructins abve, but when cnnectin t the registratin server fails, click , then click Next. This will cpy the necessary infrmatin t the Windws Clipbard. Yu can then paste the infrmatin int a text dcument and, n a cmputer that has Internet access, g t paste the cntents f the text file, then click Register Me. Yu will receive a.reg file. On the cmputer n which CuteFTP is installed, clse CuteFTP, duble-click the.reg file t merge the registratin infrmatin t the Windws registry, then restart CuteFTP. Unable t Cnnect due t Prxy Settings - In the Registratin Failed dialg bx, click HTTP Prxy t mdify yur prxy settings (IP address and prt) s that CuteFTP can perfrm HTTP (Web) transactins. If yu d nt have the prxy infrmatin, ask yur system administratr r Internet Service Prvider fr assistance. (Glbalscape des nt have this infrmatin.) Lst Serial Number - If yu cannt lcate yur serial number, yu can btain a cpy frm Glbalscape Supprt. If yu still have the riginal address used t purchase the sftware, n the main menu, click Help > Lcate a lst serial. If yu n lnger have access t that accunt r d nt recall which address yu used, cntact custmer service department and prvide yur name, address, rder ID r any ther pertinent data that might help us lcate yur riginal purchase recrd. Backing Up Registratin Infrmatin CuteFTP can back up yur CuteFTP data and save the backup file in any directry yu specify. It is a gd idea t back up this data in case yu need t restre yur setup. This is nt the same thing as exprting yur Site Manager data. Exprting yur Sites nly exprts the infrmatin necessary t recreate them in Site Manager. When yu back up yur CuteFTP data, the fllwing infrmatin is saved: Instructins fr restring yur registratin (using key.reg) Instructins fr restring yur Site Manager cnfiguratin (using sm.dat) Yur registratin number (This same infrmatin is saved in the backup file serial.txt.) T back up yur CuteFTP data 1. On the main menu, click Help > Backup Persnal & Registratin Data. 2. Specify the lcatin t save yur backup data. CuteFTP creates backup files in the lcatin yu specify. 3. Yu are prmpted t print ut yur registratin infrmatin. If yu click Yes, the text file appears and attempts t print n yur default printer. 19

20 CuteFTP v9 User Guide The lcatin in which CuteFTP's data files are stred depends n yur versin f Windws: Windws XP: C:\Dcuments and Settings\USERNAME\Applicatin Data\ Glbalscape\CuteFTP\<VERSION>\SM.DAT Windws Vista: C:\PrgramData\Glbalscape\CuteFTP\<VERSION>\SM.DAT Windws 7: C:\Users\USERNAME\Applicatin Data\Raming\Glbalscape\ CuteFTP\<VERSION>\SM.DAT Windws 2008: C:\Users\Administratr\AppData\Raming\Glbalscape\CuteFTP\<VERSION>\SM.DAT If yu can't see the SM.DAT file, yu may need t shw hidden files and flders: 1. Open Windws Explrer. 2. In Windws 7, click Organize > Flder and search ptins; in Windws XP, click Tls > Flder Optins. 3. Click the View tab, then select Shw hidden files and flders. Upgrading CuteFTP Yu can upgrade t versin 9 frm CuteFTP Pr, Hme, r Lite v The Sites defined in the Site Manager and the settings in Glbal Optins are migrated t the new versin when yu upgrade. T be safe, yu shuld Back Up Site Cnfiguratins befre ding any upgrade. Upgrade cnsideratins: If a passwrd fr an existing SFTP key cntains any Extended ASCII characters, after upgrading t CuteFTP 9, the passwrd will n lnger wrk. Yu will have t reenter the passwrd. (This is because f changes t CuteFTP versin 9 t supprt UTF-8.) Refer t glbalscape.cm supprt pages fr licensing cnsideratins and csts, and any lastminute upgrade cnsideratins. Mving CuteFTP t a Different Cmputer Yu have tw ptins fr mving CuteFTP t a new cmputer: OPTION 1 (If the ld cmputer is n lnger running r available t yu, r if yu d nt need the existing Site Manager data): 1. Dwnlad the sftware frm this page: 2. Install CuteFTP n the new cmputer and activate it using yur existing serial number. OPTION 2 (If the ld cmputer is still available t yu and yu need access t the existing Site Manager data): 1. On the ld cmputer: a. Launch CuteFTP. If yu d nt already have yur serial number available, n the main menu, click Help > Abut CuteFTP. Recrd yur serial number s that yu can use it n the new cmputer. b. On the main menu, click Help > Backup registratin & persnal data. The Backup Registratin Lcatin dialg bx appears. c. Click Brwse. Select a drive with prtable media (e.g., a USB drive) r netwrk lcatin in which t save the data, then click OK. A backup successful message appears when cmpleted. d. If yu are transferring the license t the new cmputer, remve the sftware frm the ld cmputer using Windws Add r Remve Prgrams. 20

21 Getting Started 2. On the new cmputer: a. Dwnlad the sftware frm this page: b. Install CuteFTP n the new cmputer and activate it with the serial number that yu recrded in step 1 in the previus prcedure. c. Insert the media n which yur backup was saved r make sure yu have access t the netwrk lcatin in step 2 in the previus prcedure. d. Launch CuteFTP. e. On the main menu, click Tls > Site Manager > Imprt FTP Sites, and fllw the instructins. Fr detailed instructins abut hw t imprt yur Site Manager data, refer t Imprting FTP Sites. The Sites in the Site Manager are stred in a file called sm.dat. The lcatin in which sm.dat is stred depends n yur versin f Windws. Windws XP: C:\Dcuments and Settings\USERNAME\Applicatin Data\Glbalscape\CuteFTP\VERSION\SM.DAT Windws Vista: C:\PrgramData\Glbalscape\CuteFTP\VERSION\ Windws 7: C:\Users\USERNAME\Applicatin Data\Raming\Glbalscape\CuteFTP\VERSION\\SM.DAT If yu can't see the SM.DAT file, yu may need t shw hidden files and flders: 1. Open Windws Explrer. 2. In Windws 7, click Organize > Flder and search ptins; in Windws XP, click Tls > Flder Optins. 3. Click the View tab, then select Shw hidden files and flders. Quick Reference Guide The tpics in this user guide are rganized in the Cntents pane by functin (installing, cnfiguring, cnnecting, transferring, managing, trubleshting). Once yu have becme familiar with CuteFTP's interface and features, use the table belw as a "cheat sheet" t find infrmatin by the task that yu need t perfrm. (Nte that the tpic titles are ften named fr the task that yu want t perfrm.) If yu want t... Refer t... Install CuteFTP Activate/Register my cpy f CuteFTP Backup CuteFTP data and registratin infrmatin Upgrade CuteFTP Mve CuteFTP t a different cmputer Specify TE startup and exit ptins Cnnect t a file server Find my server's hst address Determine my username and passwrd t lg in t my server Uplad files t my server Transfer files frm my ld server t my new server Change permissins n my files Installing CuteFTP Activating CuteFTP Backing Up CuteFTP Data Upgrading CuteFTP Mving CuteFTP t a Different Cmputer Starting the Transfer Engine n Windws Startup Adding a Site t the Site Manager Site Prperties - General Tab Site Prperties - General Tab Transferring Files and Flders Site-t-Site Transfers (FXP) Viewing File and Flder Prperties 21

22 CuteFTP v9 User Guide If yu want t... Refer t... Delete my files Specify Site Manager ptins n start up Delete cmpleted transfers frm the Queue Windw Display r hide the Site Manager Specify a dwnlad flder Uplad files t a different server Add CuteFTP t the Windws Explrer right-click menu Change lg fnts and clrs Change lg lcatin, time, and saving/remving ptins Turn ff individual transfer item lgging Allw multiple cnnectins t the same Site Allw multiple cnnectins frm CuteFTP Stay cnnected t Sites when inactive Access SOCKS 4 and 5 settings Access prxy server settings Specify Site Manager, Queue Windw, and Quick Cnnect security Specify SSH2 (SFTP) security ptins Specify SSL (FTPS, HTTPS) security ptins Manage, imprt, exprt, and uplad OpenPGP keys Specify the transfer methd (ASCII/Binary) fr all transfers Specify the data mde (PASV, Prt, EPRT, EPSV) Specify Filename encding Specify multi-part transfer (COMB) setting s Specify Bandwidth limit Specify retry wait time Specify retry at byte ffset fr interrupted transfers Specify whether t send REST cmmand Specify receive/send buffer size Imprve CuteFTP perfrmance Open new cnnectins fr multiple transfers Discnnect, shut dwn, and/r lg ff after transfers have cmpleted Specify the wait time befre clsing the transfer thread after transfer cmpletes Opening, Editing, Renaming, and Deleting Files Displaying the Site Manager Remving Items frm the Queue Displaying the Site Manager Specifying a Default Dwnlad Flder Adding a Site t the Site Manager Adding CuteFTP t the Windws Explrer Right-Click Menu Lg File Settings Lg File Settings Lg File Settings Multiple Cncurrent Cnnectins Multiple Cncurrent Cnnectins Staying Cnnected t Sites Scks 4 and 5 Cnnectin Settings Prxy Cnnectin Settings Security Settings SSH2 (SFTP2) Security Settings SSL Security Settings OpenPGP Security Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Transfer Settings Imprving CuteFTP Perfrmance When Transferring Large Numbers f Files at Once Multiple Cncurrent Cnnectins Cnfiguring Optins fr Cmpleted Transfers Specifying Time CuteFTP Waits after a Transfer Cmpletes 22

23 Getting Started If yu want t... Refer t... Execute cmmands n dwnladed files Specify time stamp settings Specify settings fr verwriting files Change file names during transfer Specify settings fr file types that shuld always be transferred in ASCII mde Specify cmpressin settings Actins when dragging items t Queue r lcal pane, duble-clicking items Display Site Manager r Lcal Pane when cnnecting/discnnecting Aut-refresh the remte pane after uplad Specify CDUP setting Specify Remte servers' Table f Cntents file settings Specify settings fr Symblic Links (shrtcuts) Specify settings fr PASV mde Specify which language t use in the interface Specify which messages t display/hide Specify event sunds Specify HTML editr Specify built-in Editr settings Specify Default template Specify HTML Editr flders Specify HTML Editr tag tips Executing Cmmands n Dwnladed Files Preserving the Lcal Time Stamp Smart Overwrite Settings Rename Rules ASCII Transfer Settings Mde Z Settings Cnfiguring Navigatin Optins Cnfiguring Navigatin Optins Cnfiguring Navigatin Optins Cnfiguring Navigatin Optins TOC File Settings Symblic Links Tlerance Settings Specifying the Default Language Cnfiguring Prmpts Sund Optins HTML Editr Settings HTML Editr Settings Editing the Default HTML Template Specifying the Flder fr String HTML Cde Snippets and Java Scripts Specifying HTML Tags t Use fr a Specific Brwser 23

24 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 24

25 Chapter 2. The CuteFTP Interface The tpics in this sectin describe the CuteFTP interface. CuteFTP's main windw is divided int fur panes: Lcal pane, Remte pane, Individual Sessin Lgs pane, and the bttm pane, which has the Queue Windw tab and the Lg Windw tab. The Lcal pane has tw tabs: Lcal Drives and Site Manager. The Lcal Drives tab displays the files available fr uplad n lcal cmputer and the Site Manager tab displays the list f yur FTP Sites. The Lcal pane displays files and flders n yur cmputer in the same manner as Windws Explrer. T shw and hide the Lcal Drives and Site Manager tabs, n the main menu, click View > Shw Panes > Lcal Drives and SM Pane. The Remte pane displays the list f files available fr dwnlad t yur lcal cmputer, the files and flders n FTP Sites t which yu are cnnected. The pane is blank if yu are nt cnnected t any remte Sites. Yu cannt hide the Remte pane. The Individual Sessin Lgs pane displays the time and date f uplads, dwnlads, and ther events that ccur. The Individual Sessin Lgs pane displays the FTP cnnectin infrmatin fr ne remte cnnectin. T shw and hide the Individual Sessin Lgs pane, n the main menu, click View > Shw Panes > Individual Sessin Lgs. (Yu must be cnnected t a Site t shw the Individual Sessin Lgs.) The bttm pane has a Queue Windw that displays the status f the uplads and dwnlads (file and flder transfers) and the Lg Windw that displays the FTP cnnectin infrmatin fr all remte Sites, number f Sites yu are cnnected t, and ther details f the sessin, such as the time, date, and s n. T shw and hide the Queue & Lg pane, n the main menu, click View > Shw Panes > Queue & Lg Pane. 25

26 CuteFTP v9 User Guide Classic View The Classic view is als a fur-pane view with a Lg Pane displayed abve the Lcal Drives and Remte panes and the Queue Pane at the bttm. This is the view fund in earlier versins f CuteFTP. T use the classic view On the main menu, click View > Switch t Classic Interface r press F6. 26

27 The CuteFTP Interface Main Menu The table belw describes the ptins available n CuteFTP's main menu and includes links t relevant prcedures. Fr a list f keybard shrtcuts, refer t Keybard Shrtcuts. Fr a descriptin f the tlbar icns, refer t The Standard Tlbar and HTML Editr Tlbar. Menu Sub Menu Descriptin New Open File Cnnect Discnnect Uplad Uplad Manually Dwnlad Dwnlad Advanced Transfer Type Edit View Open Rename Delete Prperties Site list Exit Und Cut Cpy Paste Cpy t Flder Mve t Flder Grup Select Grup Deselect Opens the Site Prperties dialg bx in which yu can define a new Site. Opens a file n yur cmputer. Cnnects t Site selected in the Site Manager Discnnect frm a cnnected Site Available nly when cnnected t a Site and a file r flder is selected in the Lcal Drives pane. Available nly when cnnected t a Site and the Lcal Drives pane is selected; pens the File t uplad dialg bx. Available nly when cnnected t a Site and a file r flder is selected in the remte pane. Available nly when cnnected t a Site and the remte pane is selected; pens the File t dwnlad dialg bx. Refer t Multi-Part (Accelerated) Transfers, Site-t-Site Transfers (FXP), Transferring Manually, Uplading and Dwnlading Files Using OpenPGP Keys, Tggle t specify default transfer type (Aut, ASCII, Binary) Edit selected file (als creates a line break when using the HTML editr's Find/Replace utility) Opens selected file fr editing Executes selected file Allws selected file r flder name t be edited Deletes selected file r flder (if yu have the prper permissin) Open selected flder prperties, file prperties, r Site Prperties Lists Sites defined in the Site Manager; click a Site t cnnect t it Clses CuteFTP interface Undes the last editing change when in the HTML editr Remves the selected bject/text and places it n the Clipbard Cpies the bject/text t the Clipbard Pastes an bject/text frm the Clipbard t the insertin pint/flder Opens the Cpy t flder dialg bx in which yu type r paste a flder path int which yu want t cpy the selected item. The riginal remains in its current lcatin. Opens the Mve t flder dialg bx in which yu type r paste a flder path int which yu want t mve the selected item. The riginal is mved frm its current lcatin. Opens the Select grup dialg bx in which yu define a "mask" t select files/flders t mve/cpy/transfer. Fr example, type *.lg t select all LOG files in a flder. When multiple files are selected, pens the Deselect grup dialg bx in which yu define a "mask" t unselect files/flders. 27

28 CuteFTP v9 User Guide Menu Sub Menu Descriptin Invert Selectin Select All Find Tlbars Shw panes Switch t Classic/Mdern Interface View Arrange Icns Chse Clumns Filter G t Stp Refresh Queue Site Manager Bkmarks Flder Tls HTML Editr When multiple files are selected, clears the selectin f files and selects all ther files in the flder. Fr example, if all LOG files are selected, when yu click Invert Selectin, everything EXCEPT the LOG files will be selected. Selects all files/flders in a flder Opens the Search Results dialg bx in which yu can search fr files r flders in the Lcal drives r the Remte pane based n name, file extensin, file size, and a date mdified range. Displays r hides the Standard tlbar, Quick Cnnect tlbar, Custm Cmmands tlbar, HTML Editr tlbar, and Status bar Displays r hides the Lcal Drives and Site Manager (SM) pane, Queue and Lg pane, and Individual Sessin Lgs Tggle between default (Mdern) interface and "Classic" interface used in earlier versin f CuteFTP. Specifies whether t display Large r Small icns and hw t display file lists (List, Details, Thumbnails). Refer t Changing Hw Files and Flders are Displayed. Specifies whether t srt the file list by Name, Size, Type, Mdified date, Attributes, Descriptin, Owner, Ascending, r Descending. Yu can als srt and chse which clumns t display by right-clicking in the clumn header. (Attributes, Descriptin, and Owner clumns are available nly in the remte pane.) Specifies whether t display the Name, Size, Type, Mdified date, Attributes, Descriptin, Owner, Ascending, and/r Descending clumns. Yu can als srt and chse which clumns t display by right-clicking the clumn header. (Attributes, Descriptin, and Owner clumns are available nly in the remte pane.) Opens the Filter dialg bx in which yu can filter the display f files. Allws yu t mve within the file list Up One Level, t Persnal Flder (Lcal Drives pane nly), Desktp (Lcal Drives pane nly), r Change t a different flder (Remte pane nly). The Persnal Flder is yur Dcuments flder, e.g., C:\Users\<username>\Dcuments. Stps an in-prgress transfer Relads the file list Prvides transfer queue ptins t add/remve files frm the queue, transfer all file r nly selected files, schedule selected files fr transfer, change the rder t transfer files in the queue, save a queue fr later transfer, lad a saved queue, specify multi-part values, and shw lg details. Display r hide the Site Manager, add/remve/change Site Manager, passwrd, imprt/exprt Site Manager details, find a Site in the Site Manager, add a current cnnectin t the Site Manager, and save a lcal r remte path as the default path. Bkmark the current flder r select a bkmark Available nly when cnnected t a Site; cmpare flder cntents, synchrnize flders, backup lcal t remte, backup remte flders, mnitr lcal flders fr changes Opens a blank HTML file in the default HTML editr in which yu can create a new HTML file 28

29 The CuteFTP Interface Menu Sub Menu Descriptin Cmpressin OpenPGP Mde Lckstep Navigatin Macrs & Scripting Custm Cmmands View in Brwser Dcument Data Clr t HEX Java scripts Cde snippets Insert tag Enter FTP Cmmand Glbal Optins Cascade, Tile Clse, Clse All Lg Cnnected Site list Help Cntents Tip f the Day Request Technical Assistance Visit the Online Knwledge Base Visit Online Supprt Cmpress and uplad a selected file as ZIP, CAB, r GZIP/TAR, r decmpress a selected file Enables r disables OpenPGP mde. If n key is defined, yu are asked t create ne. Enables r disables lckstep flder navigatin. Optins t create, run, and manage macrs and scripts fr transferring files. Optin t create, edit, r run custm cmmands. As yu create cmmands, they are displayed in the Tls > Custm Cmmands list. (Available when HTML file is selected) Opens the file in a the default brwser Opens the Dcument Data dialg bx, which displays the size f the file and hw lng a transfer wuld take at varius baud rates. Opens the clr dialg bx t cnvert a selected clr t the brwser safe clr HEX cde, and insert the cde int the HTML dcument. All Java Scripts pens the Java scripts dialg bx in which yu can edit, delete, rename, r insert a Java script. Save clipbard t Java script pens the Save java script dialg bx in which yu prvide a name fr and save Java script cde selected in an HTML dcument. All Cde Snippets pens the Cde snippets dialg bx in which yu can edit, delete, rename, r insert a cde snippet. Save clipbard as snippet pens the Save cde snippet dialg bx in which yu prvide a name fr and save cde selected in an HTML dcument. Insert HTML tag. Select text t apply the tag t that text. Bld, Italic, Underline, Anchr, Image, Fnt, Cmment. Opens the Input FTP Cmmand dialg bx in which yu can type r select and execute an FTP cmmand. Previusly entered cmmands appear in a selectable drp-dwn list Opens the Glbal Optins dialg bx. Frmats the display f windws in the remte pane when yu have multiple cnnectins Clses the selected windw r all windws Cpy r clear the sessin lg; while cnnected t Site and with the cursr in the sessin lg, chse whether t shw r hide raw listings. (Discnnect and then recnnect t the Site t see the changes.) Navigate between multiple cnnected Sites by clicking a Site in the list. Opens the help file Opens the Tip f the Day t a randm tip Opens Opens Opens 29

30 CuteFTP v9 User Guide Menu Sub Menu Descriptin Purchase Nw Lcate a Lst Serial Number Enter a Serial Number Backup Persnal & Registratin Data Abut CuteFTP Opens Opens Opens the CuteFTP Registratin Wizard After yu have purchased and registered CuteFTP, yu can back up the registratin infrmatin in case yu need t reinstall/reregister. Displays the CuteFTP versin number and cpyright infrmatin Displaying r Hiding Tlbars CuteFTP includes the fllwing tlbars: Standard Tlbar Quick Cnnect Tlbar Custm Cmmands Tlbar (Available nly when Custm Cmmands are defined.) HTML Editr Tlbar Status Tlbar Yu can als chse t display large r small tlbar icns. T tggle between large and small icns Right-click n the tlbar, then click Shw large icns. A check mark indicates that large icns are displayed. T hide/shw a tlbar On the menu, click View > Tlbars, then click the tlbar yu want t hide r display. A check mark indicates that the tlbar is visible. The Standard Tlbar The Standard tlbar is displayed by default. T hide r display the Standard tlbar, n the main menu click View > Tlbars > Standard Tlbar. The tlbar prvides icns fr the fllwing functins: Name Site Manager Cnnectin Wizard New Cnnect Quick Cnnect Discnnect Recnnect Icn Functin Opens the Site Manager. Opens the Cnnectin Wizard. Opens the Site Prperties fr dialg bx. Click the dwn arrw t create a new Site, new macr/script, r HTML file. Cnnects yu t the FTP Site. Displays r hides the Quick Cnnect tlbar. Discnnects frm the Site. Recnnects t the Site. 30

31 The CuteFTP Interface Name Cnnect t URL Refresh Stp Transfer Dwnlad Uplad Edit Rename New Flder Open Delete Prperties Glbal Optins OpenPGP Mde Icn Functin Opens the Cnnect t URL dialg bx in which yu can specify the address t which yu want t cnnect (e.g., Refreshes the lg pane r flder list. Stps a transfer in prgress. Dwnlads selected files frm the remte cmputer t yur lcal cmputer. Click the dwn arrw and click HIGH t split the file int tw parts r MAX t divide the file int mre parts. Uplads selected files frm yur lcal cmputer t the remte cmputer. Click the dwn arrw and click HIGH t split the file int tw parts r MAX t divide the file int mre parts. Opens a selected HTML file in the default HTML editr r the built-in HTML editr. Allws yu t rename a selected file. Creates a new flder n the lcal cmputer and the remte cmputer. Opens a selected file. Deletes a selected file. Displays the prperties f a selected file. Opens the Glbal Optins dialg bx. Opens the OpenPGP Mde Settings dialg bx t select a key r allws yu t create a key. HTML Editr Tlbar When a dcument is pen in CuteFTP's built-in HTML Editr (click Tls > HTML Editr r press CTRL+H), the fllwing HTML Editr tlbar icns are available. T clse the HTML Editr, right-click within the editr, click File, then click Clse. Name New HTML dcument Save Und Red Find/Replace View in Brwser Bld Italics Icn Functin Opens a new HTML dcument in the editr Save the dcument as web page (htm r html) Click this t und an actin Click this red an actin Finds and replaces the wrds in an HTML dcument Opens the dcument in yur default Web brwser Frmats text as bld Frmats text as italicized 31

32 CuteFTP v9 User Guide Name Underline Insert Anchr Insert Image Set Fnt Insert Cmment Insert Table Icn Functin Frmats text as underlined Opens the Anchr Tag dialg bx in which yu can assign hyperlinks t a specific lcatin in a tpic. (Similar t a bkmark.) Opens the Image tag dialg bx in which yu can brwse t a flder and specify an image t insert in an HTML dcument Opens the Fnt tag dialg bx in which yu can specify the fnt face, clr, and size fr text Inserts the pening and clsing cmment tags. Type the desired cmment between the tags. The cmment des nt appear when the page is viewed in a brwser. Inserts the HTML table tags fr the specified number f rws and clumns, int which yu can type yur text T shw/hide the tlbar, refer t Displaying and Hiding the Tlbar. Status Bar The Status Bar appears at the bttm f the CuteFTP interface. When yu place the cursr ver a tl r menu item, the left side f the Status Bar displays a brief descriptin/tl tip f the item. The right side f the Status Bar displays infrmatin abut the flder selected in the Remte pane. T shw/hide the Status Bar On the main menu, click View > Tlbars > Status Bar (r press ALT+3). Keybard Shrtcuts If yu are mre cmfrtable using the keybard than the muse, numerus keybard shrtcuts are available in CuteFTP. In the table belw (and elsewhere in this user guide), "ALT+" indicates that yu are t press and hld the ALT key n yur keybard while simultaneusly pressing ne r mre ther keys. "CTRL+" indicates that yu are t press and hld the CTRL (Cntrl) key n yur keybard while simultaneusly pressing anther key. Fr example, "CTRL+SHIFT+D" indicates that yu are t press and hld the Cntrl Key and the Shift key, while simultaneusly pressing the D key (t mve items dwn the list in the queue). These key cmbinatins are used instead f using the muse t click in the interface. Fr example, press ALT+F t activate the File menu; press CTRL+C t cpy selected text. Key Backspace Number Pad + Number Pad - Number Pad * Tab Delete Esc F1 F2 F3 Functin Mve t parent flder Grup select Grup deselect Invert selectin Mves fcus between tabs (dcuments) in the active pane grup Delete selected bject Cancel transfer Help Rename Find next 32

33 The CuteFTP Interface Key F4 F5 F8 F9 F10 F11 F12 Alt+Enter Alt+Up Arrw Alt+Dwn Arrw Alt+Right Arrw Alt+Left Arrw Alt+F7 Alt+0 Alt+1 Functin Switch between Site Manager and Lcal Drives tabs Refresh active pane Display flder infrmatin Cancel transfer Switch between Lg pane and Queue pane Flder cmparisn ptins Hide r display individual lg windw Flder, file, r Site prperties Mve t parent flder Select drp-dwn arrw fr active pane Shw bkmark drp-dwn fr remte pane Shw bkmark drp-dwn fr lcal pane Display Glbal Optins dialg bx Tggle shw Site Manager /Lcal Pane view Tggle shw Queue /Lg Pane Alt+2 Hide r display individual lg windw (same as F12) Alt+3 Alt+Q CTRL+A CTRL+B CTRL+C CTRL+D CTRL+E CTRL+F CTRL+H CTRL+I CTRL+J CTRL+L CTRL+M CTRL+N CTRL+O CTRL+P CTRL+Q Tggle shw status bar Exit Select All Bld Fnt (when in HTML editr), Brwse ffline (when a Site is selected in Site Manager pane) Cpy Change remte flder Execute selected file Find Launch internal HTML editr Italic Fnt (when in HTML editr mde) Launch Cnnectin wizard Filter Make new flder Opens the Site Prperties dialg bx in which yu can define a new Site. Opens file n yur cmputer. Print (when in HTML editr mde) Add current path as new bkmark 33

34 CuteFTP v9 User Guide Key CTRL+R CTRL+T CTRL+S CTRL+U CTRL+V CTRL+W CTRL+X CTRL+Y CTRL+Z CTRL+F4 CTRL+F8 CTRL+F9 CTRL+F10 CTRL+F11 CTRL+~ (tilde) CTRL+PAGE DOWN CTRL+PAGE UP CTRL+Tab CTRL+ENTER CTRL+ALT+T CTRL+SHIFT+A CTRL+SHIFT+B CTRL+SHIFT+C CTRL+SHIFT+D CTRL+SHIFT+I CTRL+SHIFT+L CTRL+SHIFT+T CTRL+SHIFT+U SHIFT+F4 Functin Recnnect t last cnnected Site Cnnects t Site selected in the Site Manager Save pen dcument (HTML editr mde) Cnnect t URL r underline when HTML editr is active. Paste Opens selected file fr editing Cut Red (When in HTML editr mde) Und (When in HTML editr mde) Clse active pane Open/clse the Quick Cnnect tlbar Flder Mnitr Tl Flder Backup Tl Flder Synchrnize Tl Mve fcus between left, right and bttm panes Dwnlad Uplad Mve fcus right t left amng pen cnnectins and dcuments Edit selected file (als creates a line-break when in the integrated editr's Find/Replace utility) Tggles Thumbnail view Add anchr (when in HTML editr mde) Change item queue rder (place at bttm) Add cmment (when in HTML editr mde) Change item queue rder (mve dwn ne) Fnt dialg (when in HTML editr mde), Input RAW FTP cmmand when in CuteFTP mde Clear entire lg Change item queue rder (mve t tp) Change item queue rder (mve up ne) Discnnect 34

35 The CuteFTP Interface The Site Manager The Site Manager stres cnnectin infrmatin fr servers that yu visit ften, such as the server that hsts yur website r the server f a partner with whm yu share files. Each server cnnectin is called a "Site." Once a Site is defined, yu nly need t duble-click the Site t cnnect t the server. Refer t Using the Cnnectin Wizard r Adding a Site t the Site Manager fr details f defining a Site.If yu are cnnected t a Site when yu chse t display the Site Manager, a cnfirmatin prmpt warns yu that yu will be discnnected frm the Site. T display r hide the Site Manager D ne f the fllwing: Press F4 t display r hide the Site Manager. On the main menu, click Tls > Site Manager > Display Site Manager. A check mark indicates the Site Manager is visible. N check mark indicates that the Site Manager is hidden. Hiding the Site Manager als hides the Lcal Drives Pane. T specify Site Manager ptins n start up 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde. The General ptins appear. 3. In the On startup bx, specify ne f the fllwing actins: Display Site Manager - Displays the Site Manager n prgram start D Nthing - Prevents the Site Manager frm displaying n prgram start Cnnect t the last cnnected t Site Manager Site - Cnnects t the Site yu were cnnected t the last time yu clsed the prgram, s lng as the Site is saved in the Site Manager. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. T change Site prperties r settings 1. Display the Site Manager. 2. Right-click a Site, then click Prperties. The Site Prperties dialg bx appears. 3. Click the General, Type, Actins, r Optins tab. 4. Mdify the Site prperties, then d ne f the fllwing: Click Cnnect t cnnect t the Site. Click OK t save the changes withut cnnecting. Click Cancel t abrt the changes. 35

36 CuteFTP v9 User Guide Lcal Files and Flders Lcal files and flders are displayed in the Lcal Drives pane n the left-hand side f the CuteFTP windw. T display files and flders n the lcal cmputer D ne f the fllwing: Press ALT+0 On the main menu, click View > Shw Panes > Lcal Drives & SM Pane (there shuld be a check mark next t it). T tggle between the Lcal Drives and the Site Manager Click the Lcal Drives tab in the left pane t tggle between Lcal Drives and the Site Manager. Hiding the Lcal Drives Pane als hides the Site Manager. Flder Listing T view a listing f lcal flder cntents 1. Click the Lcal Drives tab. 2. Duble-click a flder t view its cntents. T view listings in a parent flder 1. Click in the pane where yu want t view the parent flder. 2. Click the Mve up icn. T update (refresh) a flder listing 1. Display the flder. 2. Click in the pane where the flder is displayed. 3. D ne f the fllwing: On the main menu, click View > Refresh. Right-click, then click Refresh. Press F5. Transfer Queue In the selected pane, click the Refresh icn. The Queue Windw displays items ready fr transfer, in transit, r just transferred. T display r hide queued files and flders On the main menu, click View > Shw Panes > Queue Windw (r press ALT+2). T tggle between the Queue Windw and the Lg Windw Click the Queue Windw r Lg Windw tab. 36

37 The CuteFTP Interface Hiding the Queue Windw als hides the Lg Windw. The Queue icns are displayed next t each item in the Queue pane. Icn Descriptin The item is in the queue but a transfer has nt been attempted r scheduled. The item is in the queue and a transfer has been scheduled, but has nt yet ccurred. This item's transfer is starting. There is an existing file f the same name in the destinatin flder and yu will have t decide whether t Overwrite the existing file, Skip the transfer, Resume an interrupted transfer, Rename the file yu are transferring, r Numerate the file yu are transferring. The item transfer is in prgress; this usually appears fr large transfers. The item transferred successfully. The transfer has been interrupted, but CuteFTP is still trying t cmplete the transfer. The item has been skipped, usually because yu chse t skip it manually r in a Smart Overwrite rule that yu chse previusly. Yu have stpped the transfer while it was in prgress. Yu can still Resume this transfer. The server has refused t transfer the item. The transfer lg will shw an ERROR:> message with a mre infrmatin. See als Remving Items frm the Queue. Cnnectin Lg Messages between the lcal cmputer and the server are stred in the Lg. T display the cnnectin lg 1. On the main menu, click View > Shw Panes > Queue & Lg Pane (r press ALT+1). Hiding the Queue Windw als hides the Lg Windw. 2. Select the Lg Windw tab. 3. On the left side f the Lg Windw, click the plus sign next t the FTP address. 4. Click a sessin. The lg fr that sessin appears n the right side f the Lg Windw. The active sessin lg displays as a small lg underneath the Remte pane, with additinal transfer sessin lgs shwn in the Lg Windw. Individual Sessin Lg Messages between the lcal cmputer and the server appear in the Lg. Yu can als see a lg fr each individual sessin in the Individual Sessin Lg, just belw the Remte Pane. T display a sessin lg fr a cnnectin Click View > Shw Panes > Individual Sessin Lgs. 37

38 CuteFTP v9 User Guide Glbal Optins Dialg Bx The Glbal Optins dialg bx is used t cnfigure settings that apply t every Site and every transfer. (Yu can verride these settings in a Site's Prperties dialg bx.) Prcedures fr using Glbal Optins are numerus and rganized in this user guide by functin. Refer t the Cntents, Index, r Quick Reference Guide t jump t the prcedure yu are lking fr. T pen the Glbal Optins dialg bx On the main menu, click Tls > Glbal Optins r press ALT+F7. The Glbal Optins dialg bx pens t the page that was displayed when the dialg bx was clsed. The General nde is used t cnfigure varius startup and exit events, dwnlad defaults, shell integratin, and lg settings. Fr details f the ptins n the General nde, refer t the fllwing tpics: Starting the Transfer Engine n Windws Startup Displaying the Site Manager Specifying a Default Dwnlad Flder Uplading Files frm Anywhere in Windws Lg File Settings The Cnnectin nde is used t cnfigure cnnectin-related settings such and prxy/scks, retry attempts, and PORT mde cnfiguratin. 38

39 The CuteFTP Interface Fr details f the ptins n the Cnnectin nde, refer t the fllwing tpics: Imprving CuteFTP Perfrmance When Transferring Large Numbers f Files at Once Cnnectin Optins Staying Cnnected Internet Cnnectin Settings Scks 4 and 5 Cnnectin Settings Prxy Cnnectin Settings The Security nde is used t cnfigure security settings such whether t use a Site Manager passwrd, and SSH2, SSL, and OpenPGP ptins. 39

40 CuteFTP v9 User Guide Fr details f the ptins n the Security nde, refer t the fllwing tpics: Security Settings SSL/TLS Cnnectins (FTPS/HTTPS) SSH2 Cnnectins (SFTP) OpenPGP Security Settings Unable t Cnnect t Titan FTP Server when Using SSL The Transfer nde is used t cnfigure transfer ptins such as whether t use ASCII r Binary, data mde settings, filename encding, rename rules, and ther transfer events. 40

41 The CuteFTP Interface Fr details f the ptins n the Transfer nde, refer t the tpics in: Transferring Files and Flders Preserving the Lcal Time Stamp Specifying Time CuteFTP Waits after a Transfer Cmpletes Smart Overwrite Settings Rename Rules Specifying Binary r ASCII Mde Accelerating Transfers with Mde Z The Navigatin nde is used t cnfigure navigatin ptins such as event handling and hw certain cmmands are used. Fr details f the ptins n the Navigatin nde, refer t the fllwing tpics: Cnfiguring Navigatin Optins Cannt See Files r Flders Symblic Links TOC File Settings Tlerance Settings Updating r Refreshing Flder Listings The Display nde is used t cnfigure the way windws and tlbars are displayed, which prmpts t display, assign sunds t events, and specify a default language. 41

42 CuteFTP v9 User Guide Fr details f the ptins n the Display nde, refer t the fllwing tpics: Cnfiguring Display Settings Cnfiguring Prmpts Sund Optins Specifying the Default Language The Helper Applicatins nde is used t specify the applicatins yu will use t view and edit HTML files. 42

43 The CuteFTP Interface Fr details f the ptins n the Helper Applicatins nde, refer t the fllwing tpics: Integrated HTML Editr HTML Editr Settings Editing the Default HTML Template Using Clrs Specifying the Flder fr String HTML Cde Snippets and Java Scripts Previewing an HTML Dcument in a Brwser Specifying HTML Tags t Use fr a Specific Brwser Site Prperties Yu can change a number f cnnectin settings fr individual Sites in the Site Manager. The changes made t Sites in the Site Manager nly affect the individual Site. Site Prperties - General Tab On the General tab f the Site Prperties, yu can mdify the name (Label) by which the Site is displayed in the Site Manager, the hst address, username, passwrd, and lgin methd. Yu can als type cmments that are saved with the Site settings. Label - Prvide a descriptive name fr the Site, as it will appear in the Site Manager. Hst address - Prvide the address t which yu will cnnect fr this Site. The address can be a dmain name, such as ftp.example.cm, r an IP address, such as If yu d nt knw the address, yur hsting prvider r system administratr shuld be able t prvide it t yu. Many ISPs prvide FTP cnfiguratin infrmatin n their website. Fr an example f what t lk fr, g t A similar help page shuld be available frm the cmpany that is hsting yur website. Username - Prvide the username given t yu by yur hsting prvider. Glbalscape des nt prvide r maintain this infrmatin. Passwrd - Prvide the passwrd given t yu by yur hsting prvider. Glbalscape des nt prvide r maintain this infrmatin. Cmments - Prvide any ntes abut the Site that yu want t save with the Site. 43

44 CuteFTP v9 User Guide Lgin methd: Click Nrmal if the server requires yur user name and passwrd fr a cnnectin. Click Annymus if the server des nt require a user name and passwrd fr a cnnectin. Click Duble if yu need t supply yur user name and passwrd twice fr a cnnectin. Cnnect - Saves Site changes and cnnects t the Site. OK - Saves changes and clses Site Prperties. Cancel - Cancels changes and clses Site Prperties. Help - Opens the nline help. Site Prperties - Actins Tab On the Actins tab f the Site Prperties, yu can specify the actins t take when yu cnnect t and uplad t the Site. When client cnnects, switch t this remte flder - Type the full path t any flder n the remte Site, and CuteFTP will autmatically pen the flder in the Remte Pane when yu cnnect t the Site. When client cnnects, switch t this lcal flder - Type r brwse t the full path fr any flder n yur cmputer, and CuteFTP will autmatically pen the flder in the Lcal Pane when yu cnnect t the Site. Fr navigatin use the fllwing caching ptins - Caching means CuteFTP stres the Site list infrmatin n yur cmputer, s when yu navigate t different files and flders, yu d nt have t recnnect. Use cache during sessin - Stre the Site's infrmatin nly until yu clse the cnnectin. Always use cache - Stre the Site's infrmatin and keep it even after yu discnnect. D nt use cache - Never stre the Site's infrmatin. When uplading, apply this rule t files and flder names - Use this t change file names t upper case, lwer case, r t keep the case the same. Preserve case - Keep all upladed file names in their riginal case. Frce lwer case - Change all upladed file names t small letters. 44

45 The CuteFTP Interface Frce upper case - Change all upladed file names t all capitals. Filter - Click Filter t define which files will be hidden r displayed. Fr mre infrmatin, refer t Filtering the List f Files and Flders. Site Prperties - Type Tab On the Type tab f the Site Prperties, yu can synchrnize the time zne, and define the server type, data cnnectin type, and transfer type. (Nt available fr TappIn Sites; TappIn Sites cnnect via HTTPS n prt 443 nly.) Prtcl type - Specify the transfer prtcl fr the Site: FTP, FTP with TLS/SSL Implicit, FTP with TLS/SSL Explicit, FTP with SSL Explicit, SFTP using SSH2, HTTP, and HTTPS. If yu chse any f the SSL ptins, yu will als be able t specify whether t use Clear Data Channel r Clear Cmmand Channel. Prt - The default prt number appears when yu specify the prtcl type (e.g., FTP = 21). Yu can change the number if the server uses a different prt. Cntact yur ISP/Web service prvider fr the crrect prt number. Server type - If yu keep the default f Aut-detect, CuteFTP tries t determine the kind f server when it attempts t cnnect. If yu have cnnectin prblems r yu knw the kind f server, yu can click it in the list (UNIX, UNIX cmpatible, Windws NT, and many thers). Data cnnectin type - By default, CuteFTP uses the cnnectin type set in Glbal Optins > Transfer, r yu can specify PORT, PASV, EPRT, r EPSV cnnectin mde. Transfer type - Specify the transfer type set in Glbal Optins r ne f the fllwing: Aut-detect: Based n the file type, CuteFTP decides whether t transfer in ASCII r binary. ASCII: Used primarily fr transfer f text-based files such as HTML, text, and ther dcuments. Binary: Used primarily fr data type transfers such as pictures and ther graphics, r files thse d nt have line feeds (carriage returns). Server time zne - Specify N Offset if the server is in the same time zne as yurs. If the server is in a different time zne, specify it here. These time znes d nt accunt fr Daylight Saving Time. T accunt fr Daylight Saving Time, chse a time zne ne hur ahead f the server's time zne. Fr example, if yu are cnnecting t a server in Central Daylight time, set the time zne t Eastern Standard Time. 45

46 CuteFTP v9 User Guide Select the Autmatically detect check bx t enable time zne synchrnizatin. Time Zne synchrnizatin helps in cmparing the time f the file when it is upladed n the remte server t the lcal cmputer time, runding t the nearest 30 minutes. The difference in the time is the Time Zne ffset. CuteFTP autmatically detects the remte server time zne and synchrnizes it with the lcal cmputer time zne when a file is transferred. The Autmatically detect check bx is nt selected by default. Passwrd Prtectin - If simple FTP is selected as the prtcl type, passwrd encryptin ptins appear. Clear Data channel - If FTP with TLS/SSL is selected, yu can select the check bx fr unencrypted data transfers. Clear Cmmand channel - If FTP with TLS/SSL is selected, yu can select the check bx t send unencrypted cmmands. Site Prperties - Optins Tab On the Optins tab f the Site Prperties, yu can specify the number f retry attempts, delay between retries, and ther ptins. Site-specific cnfiguratin ptins Use glbal settings fr all ptins - the Site will use the parameters set in Glbal Optins Use Site-specific ptin - the Site will use the parameters set n this tab. Apply aut-rename scheme t transfer Select this check bx if yu want the files that yu transfer t be renamed accrding t the settings yu chse in the Glbal Optins Rename Rules panel. Clear this check bx if yu d nt want files t be renamed when yu make transfers with this Site. Use NLST instead f LIST (retrieves an abbreviated listing) Select this check bx t get nly a list f file names and n ther file infrmatin frm the Site. Clear this check bx if yu want the Site t display cmplete file listings, including file size, file mdified date, and flder names. (Applies t FTP prtcls nly.) Use the lgical parent (nt physical parent) n CDUP Select this check bx if yu want t return t the previus directry when yu clicked the Up flder icn, even if yu clicked a link r shrtcut in the previus directry. Clear this check bx t g back t the parent directry fr this flder, which might nt have been the directry yu were in when yu jumped t the current directry. 46

47 The CuteFTP Interface Site-Specific Firewall settings: Click Prxy if yu need t cnnect thrugh a prxy server t get t this Site. A Prxy dialg bx appears in which yu can enter the prxy type, server address, username, and passwrd. Click Scks if yu need t cnnect thrugh a Scks server t get t this Site. A Scks dialg bx appears in which yu can enter the SOCKS type, server address, username, and passwrd. Retry attempts Specify the number f times yu want CuteFTP t try cnnecting t this Site, if there is a prblem making a cnnectin. Delay between retries Specify the number f secnds yu want CuteFTP t wait befre retrying a cnnectin after a cnnectin attempt fails. Site max cncurrent transfers Specify the number f cnnectins CuteFTP can pen t the Site fr transferring many files simultaneusly. Filename encding Specify the filename encding as UTF-8 (default) r ASCII, r leave the default f Aut. File and Flder Prperties Just as in Windws Explrer, yu can view the prperties f any file r flder by right-clicking the file, then clicking Prperties. Lcal pane infrmatin: Type: Kind f item (e.g., HTML dcument, File Flder) Lcatin: Path where the file resides (e.g., C:\Dcuments and Settings\user1\My Dcuments; n the remte server, displays the directry) Opens with: Indicates in which applicatin the file pens. T pen ALL files f that type with a different applicatin, click Change. Fr example, if yur cmputer is cnfigured t pen GIF (image) files in Internet Explrer, but yu want them t pen in Paint Shp Pr s that yu can edit them, click Change, scrll t r brwse fr psp.exe, then click OK. This change will affect ALL files n yur cmputer that have that extensin. Size: Size f the file r flder (e.g., 43.1 MB (45,281,728 bytes)) Cntains: Fr flders, displays hw many files and subflders it cntains 47

48 CuteFTP v9 User Guide Remte pane infrmatin: Server: The address (URL) f the server n which the file resides Mdified: When the item was last mdified User: Specifies the user f the item (e.g., wner) Grup: Specifies the grup t which the item belngs (can be blank) Read/Write Permissins: Yu can set the CHMOD permissins by changing the number (such as 777), r just check ff the permissins in the Owner, Grup, and Public area f the dialg bx. Abut CHMOD Permissins The CHMOD permissin mask is a three-digit number. First digit: Defines the permissins fr the wner (yu). Secnd digit: Defines the permissins fr the grup. Third digit: Defines the permissins fr everyne else (referred t as public). Each digit wrks the same fr each grup f users: the wner, grup, and public. What yu set fr ne digit has n effect n the ther tw digits. Each digit is made up f the three Read, Write, and Execute permissins. The Read permissin value is 4, the Write permissin value is 2, and the Execute permissin value is 1. These three numbers are added tgether t get the permissins fr a file. If yu want a file nly t be readable and nt writable r executable, set its permissin t 4. This wrks the same fr Write and Execute. Executable nly files have a permissin f 1. 48

49 The CuteFTP Interface Fr example, if yu want a file t have Read and Write permissins, add the Read and Write values tgether (4+2) and yu get 6, which is the permissins setting fr Read and Write. If yu want the file t have Read, Write, and Execute permissins, use the value 7 (4+2+1). D this fr each f the three permissin grups and yu get a valid CHMOD mask. If yu want yur file t have Read, Write, and Execute permissins (4+2+1) fr yurself; Read and Execute (4+1) fr yur grup; and Execute (1) nly fr everyne else, yu wuld set the file permissins t 751. (Or just select the apprpriate check bxes under Owner (yu), Grup, and Public.) Filtering the List f Files and Flders CuteFTP allws yu t set filters that autmatically include r exclude files frm transfers. Yu define the filters in the Filter dialg bx, then apply them t individual transfers, r use them n all transfers. Yu can als use filters during flder synchrnizatins. When yu apply filters, yu d nt add r remve files, yu simply set which files will be visible r invisible in CuteFTP. T chse which files/flders t display 1. On the main menu, click View > Filter. 2. Select the Enable Filtering check bx. 3. Select the fllwing check bxes as needed: T apply the filter t flders, select the Apply filtering t flder name(s) check bx. T use filters with transfers, select the Apply t file transfers check bx. T make filters case sensitive, select the Case sensitive filtering check bx. T use server filters, select the Enable server-side filtering check bx, and type a filter frm the Unix ls prgram. 4. Click the Filter Mask tab. 5. Type the names f files/flders yu want t display, r use wildcard masks t include a grup f files, then click Add. 6. Select the Filter NOT Mask tab. 7. Type the names f files/flders yu want t hide, r use wildcard masks t exclude a grup f files, then Add. 8. Click OK. Belw are a few f the LIST wildcards (parameters) and cmbinatins that can be passed t the ls prgram running n a UNIX server: Parameter Definitin -l Display a list f files in the current directry, and infrmatin abut each file (lng frmat) -a Display hidden files -la Display a list f files in lng frmat and include hidden files -l *.ext Display a list f files with a specific extensin (*.html, *.txt, etc.) ls r* Displays a list f files with names beginning with r (r any ther letter) -t Srt display by time stamp -R Srt recursively -lt Display files in lng frmat, srted by time -t *.ext Displays a list f files with a specific extensin (*.html, *.txt, etc.), srted by time 49

50 CuteFTP v9 User Guide T transfer filtered items After defining a filter as described abve, in the Lcal Drives r Remte pane, click the files that remain visible, then click File > Uplad Advanced, then click Uplad filtered (r Dwnlad filtered if yu are dwnlading.). Yu can cnfigure tw filter sets: ne fr the Lcal pane, and ne fr the Remte pane. Nte that CuteFTP applies the filter parameters t all f the cntents, directries, and subdirectries displayed in that pane. Filtering wrks with flder synchrnizing. Yu can filter by file extensins, fr example,.htm,.php,.asp, etc. Viewing Thumbnails If yu are uplading r dwnlading graphic files, thumbnail view makes it cnvenient t preview the images right in CuteFTP s yu can select the nes yu want befre yu transfer them. T turn n thumbnail view 1. Click in the pane (lcal r remte) that yu want t change t thumbnail view. 2. D ne f the fllwing: On the main menu, click View > View > Thumbnails. At the tp f the Lcal r Remte pane, click the Thumbnail icn. Yu can adjust hw CuteFTP handles thumbnail images in the thumbnail cache settings in Glbal Optins. Fr mre infrmatin, refer t the prcedure in Lg File Settings fr cnfiguring thumbnail cache ptins. Changing Hw Files and Flders are Displayed Yu can display files and flders with large r small icns, in a list, r with file size and date-mdified details. Large Icns - Displays files and flders as large icns Small Icns - Displays files and flders as small icns List - Displays files in a list, but n flders, and n details Details - Displays files and flders in a list with the file r flder size, type, and date mdified T display files and flders as large icns D ne f the fllwing: Right-click in the Lcal r Remte pane, then click View > Large Icns. On the main menu, click View > View > Large Icns. T display files and flders as small icns D ne f the fllwing: Right-click in the Lcal r Remte pane, then click View > Small Icns. On the main menu, click View > View > Small Icns. 50

51 The CuteFTP Interface T display files in a list, but n flders, and n details D ne f the fllwing: Right click in the Lcal r Remte pane, then click View > List. On the main menu, click View > View > List. T display files and flders in a list with the file r flder size, type, and date mdified D ne f the fllwing: Right-click in the Lcal r Remte pane, then click View > Details. On the main menu, click View > View > Details. Lckstep Flder Navigatin Lckstep flder navigatin allws yu t navigate simultaneusly thrugh lcal and remte flders that have the same structure. T turn n Lckstep Navigatin On the main menu, click Tls > Lckstep Navigatin. The lckstep navigatin functin des nt apply if yu jump up r dwn several directry levels at nce. Default Language CuteFTP's user interface resurces are independent frm the main applicatin executable and are cntained in a file called Default.lng. Yu can mdify the text and dialgs displayed in the prgram r lcalize the entire resurces in rder t use CuteFTP in yur wn language. The Glbal Optins dialg bx Language page is used t select the language file. If yu have the applicable language pack installed fr the perating system, CuteFTP will supprt the language and special characters. T specify which language file t use 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Display nde, then click Language. The available Language Files appear. The Language File Infrmatin list displays infrmatin abut the selected language file, including the language and versin number. 3. In the Language File list, click a language file t use, click OK, then restart CuteFTP. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Display Settings The display settings determine the way in which tlbars, icns, and fnts appear in dialg bxes. T cnfigure CuteFTP display settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand and click the Display nde. The Display ptins appear. 3. T specify which tlbars t display, in the Select the tlbars t display list, select the applicable check bx. 4. T add r remve buttns n the tlbar, with a tlbar in the list selected, click Custmize selected tlbar. (The Custm Cmmands and the Quick Cnnect tlbars cannt be custmized.) The Custmize Tlbar dialg bx appears. 51

52 CuteFTP v9 User Guide T add a buttn, click it in the Available tlbar buttn list, then click Add. T remve a buttn, click it in the Current tlbar buttns list, then click Remve. T mve a buttn n the tlbar, click Mve Up t mve a buttn ne icn t the left, click Mve Dwn t mve the buttn ne icn t the right n the tlbar. T accept changes, click Clse; t cancel changes, click Reset. (Reset nly backs up changes made since the dialg bx was pened. Changes are applied after yu click Clse.) 5. T display the large (32x32 pixel) set f main tlbar icns, select the Shw large tlbar icns check bx. Clear this check bx t display the small (16x16 pixel) set f main tlbar icns. 6. T hide the Quick Cnnect tlbar upn cnnectin t a Site, select the Aut-hide Quick Cnnect bar check bx. Clear this t cause the Quick Cnnect tlbar t stay in view upn cnnectin t a Site. 7. T display small icns in the menus next t cmmnly used menu items, select the Display menu icns check bx. 8. T display a thin blue line at the tp f the pane that has the fcus, select the Highlight active pane check bx. 9. T display brders between rws and clumns in the Queue Windw, and in the Lcal and Remte panes when in Detail view, select the Shw grid lines n all view panes check bx. Clear this check bx t hide all brders between rws and clumns. 10. T specify whether t shw files in bytes, KB, MB, GB, in the Display File Sizes in bx, click ne f the fllwing ptins: Adaptive - CuteFTP decides when t shw files in bytes, KB, MB, r GB. Kilbytes - CuteFTP always displays values in KB. 11. T adjust the fnt type and size display f all text in the Lcal Drives tab, Queue Windw, and Remte pane, click Lcal, Remte, Queue Windw Fnt. 12. T srt file lists by the value f each digit r by whle number values, in the Srting area, select ne f the fllwing ptins: T srt file lists by the value f each individual digit, select Use standard lexicgraphic srting fr alphanumeric file names. T srt file lists by whle number value, select Use Smart Srting fr alphanumeric file names. Smart Srting always lists file names with smaller numbers first. Fr example, A2 cmes befre A12. David Wincelberg develped Smart Srting. CuteFTP uses it by default. Standard Lexicgraphic srting lists file names using ne character at a time reading frm left t right. Fr example, A12 cmes befre A2. MS Windws uses Standard Lexicgraphic srting by default. Smart Srting FileA1.ext FileA2.ext FileA6.ext FileA9.ext FileA12.ext FileA20.ext FileA21.ext Standard srting FileA1.ext FileA12.ext FileA2.ext FileA20.ext FileA21.ext FileA6.ext FileA9.ext 13. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 52

53 The CuteFTP Interface Prmpts Yu can cnfigure whether CuteFTP displays a cnfirmatin message when yu attempt t delete an item frm lcal drives, remte Sites, r the queue, and displays a prmpt fr errrs, cnnectin prgress, and ther infrmatin. The Prmpts page is used t cnfigure prmpts t appear fr varius events. All prmpts n this page f Glbal Optins are enabled by default. T cnfigure CuteFTP prmpt settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Display nde, then click Prmpts. The Prmpts ptins appear. 3. T display a prmpt when deleting frm lcal drive, select the Cnfirm when deleting frm lcal drive check bx. Clear this check bx if yu d nt want a cnfirmatin prmpt t appear. 4. T display a prmpt when deleting frm a remte flder, select the Cnfirm when deleting frm remte drive check bx. Clear this check bx if yu d nt want a cnfirmatin prmpt t appear. 5. T display a prmpt when deleting frm the queue, select the Cnfirm when deleting frm queue check bx. Clear this check bx if yu d nt want a cnfirmatin prmpt t appear. 6. T display a prmpt when yu try t clse a windw fr an active cnnectin, select the Cnfirm when clsing a remte pane check bx. Clear this check bx if yu d nt want a cnfirmatin prmpt t appear. 7. T display a prmpt upn certain server errrs (5xx range), select the Shw prmpt upn errr check bx. 8. T display a prmpt when the Site passwrd is rejected r missing, select the Shw lgin prmpt if cnnectin fails r is missing data check bx. 9. T display a prmpt when a task is scheduled and added t the queue, select the Shw prmpt when new tasks are scheduled check bx. 10. T display a prmpt when a scheduled task has started t run, select the Shw prmpt when new tasks are started check bx. 11. T display a prmpt when the archive was expanded successfully, select the Shw prmpt after successful decmpressin check bx. 12. T display a warning when yu may be transferring a certain file type in the wrng mde, select the Shw warning when transferring binary files in ASCII mde check bx. 13. T display a cnnectin status message when cnnecting, select the Shw cnnectin prgress prmpts check bx. If the lg view is unavailable when cnnecting, this dialg will shw yu if there may be a prblem with the cnnectin. 14. T display a reminder t create a Site Manager passwrd, select the Shw Site Manager passwrd reminder prmpt check bx. 15. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Windws Explrer Right-Click Menu Yu can create a submenu ptin in Windws Explrer that will allw yu t right-click a file t uplad it with CuteFTP. The submenu prvides ptins t cnnect t a Site using the Cnnectin Wizard r Sites that yu have defined in Site Manager. T add CuteFTP t the Windws Explrer right-click menu 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand and click the General nde. The General ptins appear. 53

54 CuteFTP v9 User Guide 3. Select the Integrate int Windws Explrer cntext menu check bx. Clear the check bx t remve the ptin frm the submenu. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Sund Optins The Sunds page is used t assign a sund t a specific event. Fr example, yu might want t hear a beep when there is a transfer errr. Yu must select the Add sunds check bx fr the Events list t becme active (i.e., s yu can add sunds t events). T cnfigure sund ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). Expand the Display nde, then click Sunds. The Sunds ptins appear. The Event clumn lists pssible CuteFTP events. The File clumn displays the path t the assciated sund. 2. T hear audi cues fr certain events in CuteFTP and t edit the sunds assciated with events, click Add sunds. Clear this check bx t silence all sunds frm CuteFTP and disable sund assciatin editing. 3. If there is nthing in the File clumn, the event des nt have a sund assciated with it. T add a sund t an event, click the event, then in the File bx, brwse r type the path t a sund that yu want. T remve a sund frm an event, select it, and then click Nne. Yu can preview the sund by clicking the sund, then clicking the speaker icn. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Lg File Settings In the Glbal Optins dialg bx, yu can specify where and when lg files are saved, and hw they are displayed. The cnnectin and transfer infrmatin that appear in the Lg pane is clr cded. By default, the fllwing clrs are assigned, but yu can specify a different clr fr each lg type in the Glbal Optins dialg bx. STATUS lgs are in blue text COMMAND lgs are in green text ERROR lgs are in marn text ther infrmatin is in black text. 54

55 The CuteFTP Interface Yu can als change the display fnt type (e.g., Arial), fnt style (e.g., Bld), size (e.g., 10pt), and script (e.g., Western). T edit the lg display ptins 1. On the main menu, click Tls > Glbal Optins. 2. Expand the General nde, then click Lgs. T specify a new clr fr all lg windw status messages a. Click the applicable clr icn. The clr picker appears. b. Click a clr, then click OK. T change the style f text in the lg windws a. Click Select Fnt. The Fnt dialg bx appears. b. Specify the fnt type, fnt style, size, and script then click OK. A sample f the selected fnt appears in the Preview bx. 3. Click OK t save changes and clse the Glbal Optins dialg bx. T cnfigure the lg file settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde, then click Lg Files. The Lg Files ptins appear. 3. T specify the lcatin at which lgs are saved, in the Lg path bx, click the flder icn t brwse fr the flder r type a different path. 4. T delete lg files autmatically at time intervals yu specify, select the Delete saved lgs every check bx. Specify whether t delete files after a specified number f days, hurs, r minutes. Clear the check bx t keep all lg files, r if yu plan t delete them in ther ways. 5. T delete errr lgs autmatically when the Transfer Engine shuts dwn, select the Delete errr lgs after quitting the Transfer Engine check bx. Clear the check bx t keep errr lgs after the Transfer Engine shuts dwn. 6. T delete the assciated lgs autmatically immediately after a successful task is finished, select the Delete lgs f successful transfers immediately after cmpletin check bx. Clear the check bx t keep the assciated lgs after a successful task is finished. 7. T include the date and time in all lg files, select the Recrd/Display time stamps in lgs check bx. Clear the check bx t exclude the date and time frm all lg files. This ptin cnsumes additinal system resurces due t insertin f time and date stamp at each lg event. The Recrd/Display time stamps in lgs check bx is selected by default. Select the check bx if yu are cpying lgs t send t custmer supprt fr trubleshting. 8. T remve all lg files frm yur lg flder that are currently nt in use, click Delete all lgs. Lgs fr active sessins are nt autmatically deleted. 9. T remve all remte file and flder listings CuteFTP has saved n yur cmputer fr ffline brwsing, click Delete listing cache. 10. T cnfigure thumbnail cache ptins, in the When the transfer engine exits bx, specify ne f the fllwing actins: Retain images in thumbnail cache - Thumbnails stred in the cache are nt deleted when yu exit CuteFTP r the Transfer Engine. 55

56 CuteFTP v9 User Guide Delete images in thumbnail cache - The thumbnail cache is emptied when the Transfer Engine is exited. Delete images lder than value specified - Thumbnails are stred fr the time specified by the thumbnail cache expiratin drp dwn menu. 11. T empty the thumbnail cache immediately, click Delete thumbnail cache. 12. T access the lg display and lg saving ptins, click Lgs. The Lg ptins appear. Cnfigure ptins as described belw. T chse a new clr fr all lg windw status messages, click STATUS T chse a new clr fr all lg windw errr messages, click ERROR. T chse a new clr fr all lg windw cmmand messages, click COMMAND. T chse a new display clr fr all ther messages in lg windws, click OTHER. T change the style f text in the lg windws, click Fnt. The Fnt dialg bx appears in which yu can specify a different fnt face (e.g., Arial, Times), style (e.g., Regular, Bld), size (e.g., 8 pints, 10 pints), and script (e.g., Western, Hebrew, Arabic). The Preview bx displays hw the fnt will appear in lgs. T save each sessin lg as a separate text file and t display the lg in the individual sessin lg windw, select the Enable sessin (cntrl cnnectin) lgs check bx. Clear this t stp recrding a lg fr each sessin, and t shw n lgs in the individual sessin lg windw. T save the lg fr each item transferred as a separate text file, select the Enable individual transfer item (data cnnectin) lgs check bx. Clear this t stp recrding a separate lg fr each item transferred. T display all lgs in the Lg Windw in the bttm f CuteFTP interface, select the Enable cnslidated transfer lgs (bth sessin and all transfers in Lg Windw) check bx. Clear this t leave the Lg Windw blank and t stp recrding all activity in a single lg file. T include file lists and permissins as part f sessin lgs and cnslidated lgs, select the Recrd/Display raw directry listing in lgs check bx. This returns a RAW list, which is used cmmnly fr debugging. Clear this t exclude file lists and permissins frm sessin lgs and cnslidated lgs. T shw a lg windw in the remte pane fr each Site t which yu cnnect, select the Shw individual lgs fr each cnnectin windw check bx. Clear this t hide any lg windws in the remte pane. Lgs can cnsume a large amunt f system resurces (memry and hard drive space), depending n the amunt and size f files being transferred. It is recmmended that yu disable mst lgging (especially data cnnectin lgs) when perfrming a transfer that cnsists f many thusands f files, especially small files. T further reduce resurce use, n the main menu, click Tls > Glbal Optins, expand the Transfer nde, click Events, then click Remve successful transfers frm the queue autmatically. 13. Click OK t save changes and clse the Glbal Optins dialg bx. 56

57 The CuteFTP Interface Security Settings The Security settings in the Glbal Optins dialg bx define security as it relates t the Site Manager and CuteFTP. These security settings d nt affect the way in which files are transferred. Fr thse security settings, refer t OpenPGP Security Settings, SSL/TLS Cnnectins (FTPS/HTTPS), and SSH2 Cnnectins (SFTP). T edit the security settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand and click the Security nde. The Security ptins appear. 3. T prevent string any Site passwrds in the Site Manager file, select the Remve Site Manager passwrds upn prgram exit check bx. CuteFTP asks fr the Site passwrd fr each cnnectin attempt. Clear this check bx t allw CuteFTP t stre Site passwrds in the Site Manager file (default behavir). When passwrds are saved, yu d nt have t enter them again when cnnecting t a Site. Nt saving passwrds at all is useful in shared system envirnments, where CuteFTP is likely being used by multiple users n the same physical cmputer. 4. The default lcatin t stre the Site Manager is displayed in the Site Manager path bx. T mve yur Site Manager t a different lcatin n yur cmputer r netwrk, type r brwse fr a new path. The default lcatin is: C:\Users\<username>\AppData\Raming\Glbalscape\CuteFTP\9.0\sm.dat 5. T secure the Site Manager, select the Encrypt cntents f Site Manager check bx, then click Change Passwrd. Yu must supply a passwrd every time yu start CuteFTP. Clear this check bx, and CuteFTP starts withut requiring a passwrd. Site Manager and all its Sites are available. When this ptin is nt used (default) CuteFTP uses mild encryptin with a systemgenerated passwrd t prtect yur Site Manager's cntents. It is highly recmmended that yu select Encrypt the cntents f the Site Manager, as it prtects the cntents f the Site Manager with strng encryptin, using a passwrd yu supply. 6. T remve passwrds frm queued items, select the Remve Queue file passwrds upn prgram exit check bx. Next time yu start CuteFTP, yu will be prmpted fr a passwrd t cmplete the transfer. Clear this check bx t allw passwrds t be sent autmatically fr queued items. 7. T erase any URLs and remve all Sites frm the Quick Cnnect drp-dwn when CuteFTP is shut dwn, select the Remve Quick Cnnect and Cnnect t URL histry upn prgram exit check bx. Clear this check bx t keep URLs and t keep a list f Sites in the Quick Cnnect drp-dwn list even when CuteFTP is clsed. 8. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 57

58 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 58

59 Chapter 3. Defining Sites The tpics belw describe the varius methds fr cnnecting t sites t transfer files. Yu can cnnect t any server defined in the CuteFTP Site Manager. If the server that yu want t cnnect t is nt yet defined, refer t Adding a Site t the Site Manager r Using the Cnnectin Wizard. Yu must be cnnected t the Internet befre yu can cnnect t any remte server. T cnnect t an existing server within the Site Manager 1. On the main menu, click Tls > Site Manager > Display Site Manager r click the Site Manager tab. 2. Click the Site t which yu want t cnnect. 3. D ne f the fllwing: On the main menu, click File > Cnnect > Cnnect. On the tlbar, click the Cnnect icn. Duble-click the selected Site. Press CTRL+T. 4. If this is a server that requires an SSH2 hst key, a message appears asking if yu want t add the key t yur trusted list. Click Yes. Yu will nt see this message n subsequent cnnectins unless the key has changed. 5. Transfer files as described in Transferring Files and Flders. T discnnect frm a server D ne f the fllwing: On the main menu, click File > Discnnect. On the tlbar, click the Discnnect icn. Click the X in the upper right crner. Press SHIFT+F4. T cnnect t a URL with the Transfer Engine The Cnnect t URL feature is als supprted by the Transfer Engine. Whether the URL specifies a path t a flder r file, the TE will try t dwnlad it. 1. In the Windws System Tray, right-click the Transfer Engine icn, then click Dwnlad URL. 2. Type r paste the URL in the Dwnlad URL bx. See belw fr supprted URL frmats and the behavir depending n the URL pasted. Supprted URL frmats ftp://user:pass@hst.hst.cm:prt ftp://user:pass@hst.hst.cm ftp://user@hst.hst.cm ftp://hst.hst.cm:prt ftp://hst.hst.cm ftp://ftp.sitename.cm/pub l: user p: pass 59

60 CuteFTP v9 User Guide Tip: ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://ftp.sitename.cm/pub l/p: user/pass ftp://ftp.sitename.cm/pub:44 l/p: user/pass ftp://ftp.sitename.cm/pub p:44 l/p: user/pass ftp://ftp.sitename.cm/pub prt:44 l/p: user/pass ftp://ftp.sitename.cm/pub l: user p: pass ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub p:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://[any f the abve frmats]/pathnametfile/[ptinal filename] als http, https, sftp, and ftps URLs Using Paste URL, CuteFTP either cnnects t the flder r dwnlads the file specified in the path. Here are sme sample path endings and hw the main prgram interprets them. "ftp://hst/dir.ext/" This URL is cnsidered a flder. CuteFTP can cnnect t it. "hst/.ext/" This is cnsidered a flder. CuteFTP can cnnect t it. "hst/dir/" This is cnsidered a flder. CuteFTP can cnnect t it. "hst/dir" This is cnsidered a flder. CuteFTP can cnnect t it. "hst/dir.ext" This is cnsidered a file. CuteFTP can dwnlad it. "hst/.ext" This is cnsidered a file. CuteFTP can dwnlad it. Using the Cnnectin Wizard T transfer files, yu must lg n t that server thrugh yur client cmputer. The Cnnectin Wizard helps yu t define a "Site" thrugh which yu can cnnect t an FTP server and saves the infrmatin in the Site Manager fr future cnnectins. (Refer t Adding a Site t the Site Manager fr ther prtcl cnnectins.) T cnnect t an FTP site The Internet Service Prvider (ISP) r Web Hsting Prvider t which yu want t uplad files prvides yu with the username, passwrd, and FTP accunt infrmatin required t cnnect t their server. Glbalscape supprt des NOT have this infrmatin. Many prviders ffer their cnnectin infrmatin n their Web supprt pages. Refer t the Glbalscape Knwledge Base articles at fr infrmatin abut FTP cnnectins t yur AOL r Radrunner accunts r search yur prvider's supprt pages fr keywrd ftp. 1. Gather the infrmatin that yu need t make a cnnectin t an FTP site. Hst Address - the IP address r FTP dmain address that yur ISP gave yu t lg in t the FTP site (e.g., r ftp.example.cm). User Name - the user name yur ISP gave yu t lg in t the FTP site. Yur username is ften the part f yur address in frnt f sign. 60

61 Defining Sites Passwrd - the passwrd yur ISP gave yu t lg in t the FTP site. This is ften the same passwrd yu use t dwnlad yur . Site Name - By default, the Site Name is the same as the Hst Address, but yu can name it anything yu want; it is nt prvided by yur ISP r Glbalscape. 2. The Cnnectin Wizard appears the first time yu pen CuteFTP. Otherwise, d ne f the fllwing: On the main menu, click File > Cnnect > Cnnectin Wizard. On the tlbar, click the Cnnectin Wizard icn. Press CTRL+J. The Cnnectin Wizard appears. 3. D ne f the fllwing: T passwrd prtect yur Site Manager infrmatin, click Passwrd Prtect My Site Manager Nw. Prvide yur passwrd fr the Site Manager, then click OK. Select the D nt shw this warning again check bx, then click Next if yu chse nt t passwrd prtect yur Site Manager and d nt want t see this warning again. 4. In the Hst Address field, type the IP address r FTP dmain address that yur ISP gave yu t lg in t the FTP site. 5. The address that yu typed in the Hst Address field appears in the Site Name field. Yu can leave it as is, r type a descriptive name fr this site. The site name will appear n the Site Manager tab. Yu can name it anything yu want. 6. Click Next. The lgin page appears. 7. In the User Name bx, type the user name yur ISP gave yu t lg in t the FTP site. 8. In the Passwrd bx, type the passwrd yur ISP gave yu t lg in t the FTP site. 9. Specify a lgin methd frm the fllwing ptins. Nrmal - The user name and passwrd are mandatry t cnnect t a site. Annymus - The site des nt require any user name and passwrd. Duble - The user name and passwrd are required twice t cnnect t a site. 10. Click Next. The Cnnecting t Site message appears. If yu need t change the hst address r d nt want t lg in, click Cancel. If the cnnectin fails, an errr message appears. Click Yes t clse the message, then click Back t verify/crrect the hst address, username, and passwrd. (If the cnnectin fails again, refer t Trubleshting.) If an Accept Certificate dialg bx appears, click Accept. If a message asking if yu want t add the certificate t yur trusted list, click Yes. (Adding the certificate t yur trusted list prevents the message frm appearing each time yu try t cnnect.) 11. After yu are cnnected t the FTP site, the default flders page appears. 12. In the Default Lcal Flder field, click the flder icn t brwse fr the default flder n yur cmputer frm which yu want t transfer files t/frm the remte server. 61

62 CuteFTP v9 User Guide 13. (Optinal) In the Default Remte Flder field, type the path f the remte flder frm/t which yu want t transfer files. 14. Click Next, then click Finish. Cute FTP cnnects t the site and saves the site in the Site Manager. Fr subsequent cnnectins t this FTP site, refer t Cnnecting t a Site. Refer t Cnfiguring Cnnectin Optins fr details f hw t cnfigure the number f simultaneus cnnectins yu will allw frm CuteFTP, number f times CuteFTP tries t cnnect t a site befre giving up, hw lng CuteFTP shuld wait befre attempting a new cnnectin after a failed cnnectin, and s n. The Site Manager The Site Manager stres each Site's cnnectin infrmatin s that yu dn't have t enter it every time yu want t cnnect t a server. Yu can als exprt and imprt yur Site data, in case yu need t install CuteFTP n a new cmputer r t share with ther CuteFTP users. When yu create a Site using the Cnnectin Wizard, the Site is autmatically added t the Site Manager. Yu can als save cnnectin settings fr Sites that yu use ften by manually adding them t the Site Manager. T add a Site t the Site Manager 1. D ne f the fllwing: On the main menu, click File > New, then click the type f Site: TappIn Site, FTP, FTPS (SSL), SFTP, HTTP, HTTP (SSL) r a Flder with which yu will rganize yur Sites. Press CTRL+N (fr an FTP Site). On the tlbar, click dwn arrw n the New Site icn, then click the type f Site. The Site Prperties fr dialg bx appears. 2. On the General tab, specify the cnnectin infrmatin. Refer t Site Prperties - General Tab fr details. 3. On the Actins tab, specify the actins t ccur when CuteFTP cnnects t the server. Refer t Site Prperties - Actins Tab fr details. 4. On the Type tab, specify the prtcl and ther cnnectin ptins. Refer t Site Prperties - Type Tab fr details. 5. On the Optins tab, specify transfer ptins r use glbal settings defined in Tls > Glbal Optins > Transfer. Refer t Site Prperties - Optins Tab fr details. 6. Click Cnnect t cnnect nw r OK t save the Site settings and cnnect later. The Site infrmatin is saved in the Site Manager fr future use. Internet Cnnectin (DUN/LAN) Settings CuteFTP autmatically detects which methd yu use t cnnect t the Internet. Yu must have a netwrk cnnectin cnfigured n the cmputer n which yu are using CuteFTP befre it can detect the settings. If yu cnnect t the Internet with a phne mdem, yu are using Dial-Up Netwrking (DUN). If yu have a mdem cnnectin cnfigured, it will detect it and allw yu t use it. If yu d nt have a mdem installed, the mdem ptins are nt available. If yu cnnect t the Internet with a cable mdem, DSL mdem, r thrugh a cmputer netwrk, yu are using a Lcal Area Netwrk (LAN). If yu have a LAN cnnectin, it will detect it and allw yu t use it. If yu d nt have a LAN cnnectin, the LAN ptins are nt available. 62

63 Defining Sites If CuteFTP des nt detect yur mdem, search the Micrsft Windw's help file (Start > Help and Supprt) fr "Make an Internet Cnnectin." T access Dial-up and Netwrk settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Cnnectin nde, then click DUN/LAN. The DUN/LAN ptins appear. 3. Cnfigure ptins as described belw. If yu cnnect t the Internet with a cable mdem, DSL mdem, r thrugh a cmputer netwrk, click Cnnect t the Internet using a LAN. If yu cnnect t the Internet using a mdem ver regular telephne lines, click Cnnect t the Internet using a mdem. If yu are using a dial-up cnnectin, cnfigure the fllwing ptins: In the Use the fllwing Dial-Up Netwrking cnnectin bx, click the dial-up cnnectin yu want CuteFTP t use. The list includes every dial-up cnnectin n the lcal cmputer that is available in Windws. Many cmputers list nly ne. T display the dial-up cnnectin user name and passwrd whenever CuteFTP attempts a cnnectin, select the Shw authenticatin windw (requires user input) check bx. Clear this check bx t stp the display f the dial-up cnnectin user name and passwrd when CuteFTP attempts a cnnectin. T display messages when an errr ccurs with the dial-up cnnectin, select the Shw errr prmpts (requires user interactin) check bx. Clear this check bx t stp the display f errr messages frm the dial-up cnnectin. T discnnect frm the Internet autmatically when CuteFTP r the Transfer Engine shuts dwn, select the Discnnect frm the Internet upn prgram exit check bx. Clear this check bx t keep the Internet cnnectin active after CuteFTP r the Transfer Engine shuts dwn. T specify hw many times CuteFTP tries t establish a dial-up cnnectin t the Internet after a cnnectin fails, in the Number f times t attempt cnnectin bx, specify frm 0 t 1000 attempts. T specify hw lng in secnds CuteFTP waits between attempts t establish a dial-up cnnectin t the Internet, in the Number f secnds t wait between attempts bx, specify frm 0 t 1000 secnds (1000 secnds equals almst 17 minutes). 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Cnnectin Optins In the Glbal Optins dialg bx, yu can cnfigure the number f simultaneus cnnectins yu will allw frm CuteFTP, number f times CuteFTP tries t cnnect t a Site befre giving up, hw lng CuteFTP shuld wait befre attempting a new cnnectin after a failed cnnectin, and s n. In mst situatins, the default settings will allw yu t cnnect t yur remte Sites. T cnfigure cnnectin ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Click the Cnnectin nde. The Cnnectin ptins appear. 3. Cnfigure ptins as described belw. 63

64 CuteFTP v9 User Guide T specify the number f simultaneus cnnectins yu will allw frm CuteFTP, in the Glbal max cncurrent transfers bx, specify the number f cnnectins. Yu can chse up t 200 cnnectins, but CuteFTP will warn yu that mre than 20 cnnectins may cmprmise system perfrmance. Cnnectins include transfers and brwse sessins, and every thread in a Multi- Part transfer. T specify the number f simultaneus cnnectins yu will allw frm CuteFTP per Site, in the Per Site max cncurrent transfers bx, type r select the number f cnnectins. (Same as Glbal max but n a per Site basis.) If yu chse t allw nly ne cnnectin per Site, yu must transfer files ver the brwse sessin nly (yu can navigate r transfer, but nt bth at the same time). This may be needed in situatins where the server des nt allw mre than ne cnnectin frm the same user. If the server allws mre than ne cnnectin, then it is recmmended that yu use a value greater than ne (e.g., the default f 5). That way yu can transfer files and at the same time cntinue t navigate the Site. T specify the number f times CuteFTP tries t cnnect t a Site befre giving up, in the Cnnectin retry attempts bx, type r select the number f attempts. Yu can set CuteFTP t try cnnecting up t 1,000 times. T specify hw lng CuteFTP waits befre attempting a new cnnectin after a failed cnnectin, in the Delay between retries in secnds bx, chse up t 1,000 secnds (abut 17 minutes). CuteFTP des nt autmatically retry after fatal errrs, such as a hst unreachable (invalid IP address r hst name), r upn receiving a scket 1006n errr, which usually has t d with the client nt being able t cnnect t the hst fr varius reasns (firewall blcking, netwrk errr, hst is dwn, etc.). T specify hw lng CuteFTP waits fr an unrespnsive server befre it stps attempting a new cnnectin, in the Cnnectin timeut in secnds bx, type r select up t 1,000 secnds (abut 17 minutes). T specify the address that yu want t send t servers that require an address fr annymus lg ins, in the address fr annymus lgins bx, type the address. By default, CuteFTP sends a simulated address. T display a pp-up windw with infrmatin frm the server when initial cnnectins are successful, select the Display the server's welcme message check bx. Clear this check bx t skip the server's successful cnnectin message. T ask the server fr a list f extended features it supprts, select the Send the FEAT cmmand after lgin t determine feature supprt check bx. Clear this check bx t stp sending the FEAT cmmand. FEAT is used t determine whether extended features are supprted, such as MDTM, MLST, and thers. Nt all servers supprt the FEAT cmmand. T send the QUIT cmmand frm CuteFTP n matter hw yu chse t discnnect, select the Send QUIT cmmand befre discnnecting check bx. Clear this check bx t discnnect withut sending the QUIT cmmand. 64

65 Defining Sites T use the UPnP NAT interface (available in Windws XP) t prvide prper prt mapping when cnnecting securely frm behind a NAT/firewall using PORT mde (rather than PASV, due t the remte hst als being behind a NAT/firewall), select the Enable prt mapping using UPnP check bx. Withut UPnP, yu wuld need t manually set the prt range in CuteFTP (see the next bullet belw) and als enable and frward them in the NAT/firewall device. Yu can chse Max cnnectins, Delay between retries, and Retry attempts fr individual Sites. In the Site Manager, click the Optins tab. T specify an IP address and define a prt range when establishing cnnectins using PORT mde, select the Assign PORT mde IP address and prt range check bx, then specify the IP address and prt range. Typically, this setting shuld be turned ff, but if yu are using SSL and are having difficulty negtiating a firewall, it may help t specify yur public FTP address here t enable CuteFTP t negtiate with the firewall r NAT. Optinally, yu can specify a range f prts fr issuing prt cmmands. CuteFTP selects prts randmly within the range defined in Glbal Optins -> Cnnectin -> Prt range. Instead f incrementing the FTP data prt, a randm number within the range is chsen; if the number is already at the max number f cncurrent transfers, the functin recurses until it finds a valid prt r runs ut f ptins. Use lcal prt range when yu have a defined limited number f pen prts n yur firewall. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Changing the FTP Prt On the General tab f the Site Prperties, yu can change the cnnectin r lgin infrmatin fr the selected Site. T change a Site's cnnectin settings r lgin infrmatin 1. Display the Site Manager, right-click the Site, then click Prperties. 65

66 CuteFTP v9 User Guide 2. Click the Type tab. 3. In the Prt bx, type a new prt number, then click Cnnect t accept the changes and cnnect t the Site r OK t accept the changes withut lgging in. Cnnecting t an HTTP Site If yu have the apprpriate permissins, yu can cnnect t an HTTP Site, brwse its cntents, dwnlad, uplad, and delete files. (Fr TappIn share cnnectins, refer t TappIn Site Creatin. Fr WebDAV cnnectins, refer t Web Distributed Authring and Versining (WebDAV),) T cnnect t an HTTP Site 1. D ne f the fllwing: On the main menu, click File > New > HTTP Site. On the tlbar, click the arrw next t the New Site icn, then click HTTP Site. 66

67 Defining Sites The Site Prperties fr dialg bx appears. 2. In the Label bx, type a descriptive name fr the Site. 3. In the Hst address bx, type the address fr the Site. The address can be a dmain address, such as ftp.glbalscape.cm, r an IP address, such as Ask yur hsting prvider fr the address. Prefixing the HTTP Site address with is nt necessary. If yu d nt prvide the crrect address, then every time yu try t cnnect t that Site an errr message like the ne belw is displayed. Click Details t view infrmatin and lg entries t determine the specific errr. 4. If the Site uses basic HTTP username/passwrd authenticatin, fill in yur user name and passwrd in the apprpriate fields. 67

68 CuteFTP v9 User Guide 5. On the Type tab, the Site has been autmatically set up as an HTTP Site. 6. Mst HTTP Sites cnnect t prt 80. If the website perates n a prt ther than 80, type the prt number in the Prt field. If the last prtin f the Site's URL ends in a number, that number is the prt t use. Fr example, indicates that the Web server perates n prt 99. The remainder f the tabs and fields are identical t thse seen when adding an FTP Site. 7. Select Cnnect t establish the cnnectin r click OK t save the Site in the Site Manager. CuteFTP takes advantage f the keep-alive header (as defined in RFC 2068 & 2616) which keeps the sessin pen during multiple transactins, saving the user cnsiderable time and bandwidth. The Web server must supprt basic authenticatin as described in RFC 1945 < Because f the way authenticatin wrks, the server may challenge the client with a www-authenticate request. The client respnds with Authrizatin: Basic <base64 encding f user id-passwrd>. Mst Web Servers supprt basic authenticatin but require interventin n the Site peratr's behalf t set it up because it is server specific. Varius Sites emply ther authenticatin schemes, such as NTLM r thse fund in ASP r Java Scripts, and are nt supprted by CuteFTP. Cnnecting t Secure Sites Yu can make secure cnnectins and transfers with FTPS (SSL/TLS), SFTP (SSH2), HTTPS (SSL), and standard FTP with One Time Passwrd authenticatin. T cnnect t a secure Site 1. D ne f the fllwing: On the main menu, click File > New > ( FTPS (SSL) Site, SFTP (SSH2) Site, HTTPS (SSL) Site). On the tlbar, click the dwn arrw next t the New Site icn, then click the type f Site (FTPS (SSL) Site, SFTP (SSH2) Site, HTTPS (SSL) Site). The Site Prperties dialg bx appears. 2. Prvide the hst address and lgin infrmatin. 68

69 Defining Sites 3. If yu are defining an FTPS (SSL/TLS) Site, click the Type tab. 4. In the Prtcl Type list, click the dwn arrw and click ne f the fllwing: FTP with TLS/SSL (Implicit encryptin) FTP with TLS/SSL (Explicit encryptin) FTP with TLS/SSL (AUTH TLS - Explicit) The apprpriate prt appears, depending n yur selectin. Certain servers supprt nly ne f the abve SSL cnnectin mechanisms. 5. Click Cnnect t cnnect t the Site nw r OK t cnnect t the Site later. Cnnecting t Secure Scket Layer (SSL and TLS) Sites Yu can use CuteFTP t cnnect t FTPS and HTTPS Sites. (Refer t SSL/TLS Cnnectins (FTPS/HTTPS) fr mre infrmatin abut SSL.) T cnnect t an FTP Site ver SSL (FTPS) 1. D ne f the fllwing: On the main menu, click File > New > FTPS (SSL) Site. On the tlbar, click the dwn arrw next t the New Site icn, then click FTPS (SSL) Site. In the Site Manager, right-click, then click New > FTPS (SSL) Site. The Site Prperties dialg bx appears. 2. Type a name fr the Site in the Label field. 3. Type in the Hst address, Username, and Passwrd. 4. Click the Type tab. 5. In the Prtcl list, chse the type f SSL cnnectin mechanism supprted by yur server r use the default type selected. 6. Click Cnnect t cnnect t the Site nw, r click OK t cnnect later. T cnnect t an existing Site ver SSL Click the Site in the Site Manager, then click Cnnect. T cnnect t an HTTPS Site 1. HTTPS Sites use SSL t secure HTTP cnnectins. D ne f the fllwing: On the main menu, click File, New, then click HTTPS (SSL) Site. On the tlbar, click the arrw next t the New Site icn, then click HTTPS (SSL) Site. The Site Prperties fr dialg bx appears. 2. Type a name fr the Site in the Label field. 3. Type the Site s address in the Hst address field. Yu d nt need t prefix the Site address with 4. Type yur user name in the Username field prvided by yur administratr. 5. Type yur passwrd in the Passwrd field. 6. Click Cnnect. 69

70 CuteFTP v9 User Guide 7. When yu cnnect fr the first time, the Accept Certificate dialg bx appears. 8. Click Accept if yu trust the certificate. Rejecting a certificate will abrt the cnnectin. Cnfiguratin Ntes HTTPS Sites rely n the use f certificates t verify that yu are in fact cmmunicating with the desired HTTPS server and t establish the secure cnnectin. Accepting a certificate stres the certificate n yur cmputer s yu d nt have t verify it again the next time yu cnnect t the Site. If a Site s certificate appears unusual, has nt been signed by a third party (such as VeriSign, r Thawte), r des nt match the peratr s name, yu shuld reject the request. Once the cnnectin is established, a small lck icn displays n the Status Bar. Duble-clicking the icn in the Status Bar displays the server's certificate. The lck icn represents the type f cnnectin established, but des nt guarantee a secured cnnectin. Even thugh yu are cnnected t an https Site, yu culd be linked t an unsecured directry, at which time the sessin is n lnger https, but http instead. Check the lg if yu are unsure f the security f yur cnnectin. T speed up transfers with an SSL Site Using a clear data channel speeds up transfers with SSL Sites. A clear data channel encrypts the cnnectin prcess, but files are transferred withut encryptin. 1. Click the Site in the Site Manager. 2. On the main menu, click File, then click Prperties. The Site Prperties dialg bx appears. 3. Click the Type tab. 4. Select the Clear Data Channel check bx. 5. Click OK r Cnnect. Nt all servers supprt r allw the PROT C (Clear Data Channel) cmmand argument sequence. T encrypt the data transfer and nt the cmmand cnnectin Using a Clear Cmmand Channel, yu can keep yur data transfers encrypted and still avid firewall issues. 1. Click the Site in the Site Manager. 2. On the main menu, click File, then click Prperties. The Site Prperties dialg bx appears. 3. Click the Type tab. 4. Select the Clear Cmmand Channel check bx. 5. Click OK r Cnnect. Nt all servers supprt r allw the CCC (Clear Cmmand Channel) cmmand argument. T cnfigure ther SSL settings 1. On the main menu, click Tls, then click Glbal Optins. 2. Expand the Security nde. 3. Select SSL Security. 70

71 Defining Sites CuteFTP supprts keybard interactive authenticatin. This authenticatin methd invlves cnnecting t servers with a challenge/respnse type f passwrd-based authenticatin, and requires a ne-time-use passwrd typically generated by hardware-based r, less cmmnly, sftware-based passwrd generatrs. Cnnecting t Secure Shell (SSH2) Sites T cnnect t an SSH2 Site 1. D ne f the fllwing: On the main menu, click File > New > SFTP (SSH2) Site. On the tlbar, click the dwn arrw next t the New Site icn, then click SFTP (SSH2) Site. On the Site Manager tab, right-click, click New > SFTP (SSH2) Site. The Site Prperties appear. 2. Type the Site's address in the Hst address field. Yu d nt need t prefix the Site address with "ftp://" r "sftp://". 3. Type yur user name in the Username field prvided by yur administratr. 4. Type yur passwrd in the Passwrd field. 5. Click Cnnect. T chse SSH2 ciphers and authenticatin methds 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Cnfigure the SSH2 cipher, MAC, and ther ptins, then click OK. CuteFTP supprts keybard interactive authenticatin (KIA). This authenticatin methd invlves cnnecting t servers with a challenge/respnse type f passwrd-based authenticatin, and requires a ne-time-use passwrd typically generated by hardware r, less cmmnly, sftware based passwrd generatrs. Refer t SSH2 Cnnectins (SFTP) fr details f SSH2/SFTP. Autmatically Displaying a Specific Flder when Cnnecting t a Site When yu cnnect t a Site, yur Dcuments flder is the default lcal flder, and the default remte flder is the flder that yu specified when yu cnfigured the Site. Yu can specify that a different lcal flder and/r remte flder appear in the Lcal and Remte panes when yu lg in t a Site. Yu can als cnfigure Sites t switch t a lcal and/r remte filter that yu specify in the Site Prperties dialg bx fr each Site. T switch t a remte r lcal flder when a Site cnnects D ne f the fllwing: When yu're nt lgged in t the Site: a. Display the Site Manager and view the Site Prperties. b. Click the Actins tab. 71

72 CuteFTP v9 User Guide c. T switch t a specified remte flder when CuteFTP cnnects, in the When client cnnects, switch t this remte flder bx, type the remte flder name, prepended with a frward slash. Fr example, type /mywebsite. d. T switch t a specified lcal flder when CuteFTP cnnects, in the When client cnnects, switch t this lcal flder bx, click the flder icn t brwse t a select the lcal flder. e. Click OK. After yu are cnnected t the Site: a. In the Lcal pane, brwse t the flder that yu want t make the default. b. On the main menu, click Tls > Site Manager > Save Lcal Path as Default. c. In the Remte pane, brwse t the flder that yu want t make the default. d. On the main menu, click Tls > Site Manager > Save Remte Path as Default. The next time yu cnnect t the Site, the lcal flder that yu specified as the default will appear in the Lcal pane, and the remte flder that yu specified as the default will appear in the Remte pane. Multiple Cncurrent Cnnectins Yu can transfer files n ne Site while brwsing anther Site, r brwse a flder n a Site while transferring files frm the same Site. Multiple Cncurrent Sessins are depicted as multiple pen windws in the Remte Pane (n the right side by default). Yu can tile, cascade, r minimize these windws. When the panes are maximized, yu can select alternate sessins by clicking the tabs at their lwer left brder. T pen multiple cncurrent cnnectins 1. Click the Site Manager tab, click a Site, then d ne f the fllwing: Right-click the Site, then click Cnnect. On the main menu, click File > Cnnect > Cnnect. Press CTRL+T. 2. Repeat t cnnect t mre Sites. Yu can cnnect t the same r different Sites. T frce CuteFTP t pen new cnnectins fr multiple transfers 1. On the main menu, click Tls > Glbal Optins. 2. Click the Transfer nde. 3. Clear the Allw transfers t ccur ver the existing brwse sessin check bx. T allw multiple cnnectins frm CuteFTP 1. On the main menu, click Tls > Glbal Optins. 2. Click the Cnnectin nde. 3. In the Glbal max cncurrent transfers bx, type r select a value between 1 and 200. T allw multiple cnnectins t the same Site 1. On the main menu, click Tls > Glbal Optins. 2. Click the Cnnectin nde. 3. In the per Site max cncurrent transfers bx, type r select a value between 1 and

73 Defining Sites T enhance perfrmance with limited resurces Limit the number f cncurrent per Site transfers allwed Turn ff individual transfer item lgging in settings r turn ff all lgging ptins. D nt transfer files in Multi-Part mde D nt perfrm n-the-fly File Integrity Checking Clse the main prgram interface and use the Transfer Engine. Perfrmance Limitatins Yu can chse up t 200 cncurrent cnnectins, but mre than 40 cnnectins may cmprmise system perfrmance. Cnnectins include transfers, brwser sessins, and every single thread in a multi-part transfer. FTP Sites that d nt supprt multiple cnnectins r Sites that frequently drp the FTP cnnectin will limit cncurrent sessins. Cmputer resurces and slw hardware may limit r prhibit multiple cnnectins. Using the ACCT Cmmand Yu can establish a cnnectin and then supply the ACCT cmmand fr servers that require it. T use ACCT with r withut an FTP prxy 1. In the Site Manager, click the site yu want t change. 2. D ne f the fllwing: Right-click the site, then click Prperties. On the main menu, click File > Prperties. 3. Click the Optins tab. 4. In the Site-specific cnfiguratin ptins bx, click Use site-specific ptins. 5. Click Prxy. The Prxy dialg bx appears. 6. In the Prxy type list, click the prxy type (FTP r HTTP). 7. In the Hst name and prt bxes, prvide the same hst and prt as specified n the General and Type tabs. 8. Select the Use authenticatin check bx. The Username and Passwrd bxes becme editable. 9. In the Passwrd bx, type the passwrd (fr ACCT). 73

74 CuteFTP v9 User Guide 10. Click Advanced. The Advanced Prxy Settings dialg bx appears. 11. D ne f the fllwing: Click Custm, then add the fllwing variables. Press ENTER after each variable: USER %user% PASS %pass% ACCT %fire_pass% Click USER/PASS/ACCT. 12. Click OK t save the settings and clse the Advanced Prxy Settings dialg bx. 13. Click OK again t clse the Prxy dialg bx. 14. Click Cnnect t cnnect nw r OK t cnnect later. Passwrd Prtect Site Manager Cntent T require a passwrd t pen the Site Manager 1. On the main menu, click Tls > Site Manager > Security > Encrypt Site Manager Data. The Site Manager Encryptin dialg bx appears. 2. In the Passwrd and Cnfirm passwrd bxes, type a passwrd fr pening the Site Manager. Fr maximum security, create a passwrd f at least 8 characters, with a mix f numbers, letters, upper and lwer case, and punctuatin. 74

75 Defining Sites 3. Click OK. CuteFTP will nw display the fllwing prmpt every time it starts. T change the Site Manager passwrd 1. On the main menu, click Tls > Manager > Security > Change Passwrd. The Site Manager Encryptin dialg bx appears. 2. In the Passwrd and Cnfirm passwrd bxes, type a new passwrd fr pening the Site Manager. 3. Click OK. The passwrd is changed. T remve the Site Manager passwrd On the main menu, click Tls > Site Manager > Security > Remve Passwrd. CuteFTP will nt prmpt fr a passwrd when it starts. Cnfiguratin Ntes When the Site Manager access passwrd is defined, the Site Manager infrmatin is prtected with 64-bit Blwfish encryptin. If yu frget the passwrd, yu will nt be able t use the prtected Site Manager. Yu will have the ptin t back up the lcked Site Manager and re-enter yur Site infrmatin in a new Site Manager. Yu can imprt a passwrd-prtected Site Manager file, but will need the passwrd t d s. Staying Cnnected with Smart Keep Alive Smart Keep Alive (SKA) allws yu t maintain cnnectins even when yu are nt transferring files. SKA sends cmmands at randm intervals t the FTP server, maintaining an active cnnectin. If the server terminates the cnnectin, CuteFTP autmatically recnnects t the FTP site. T turn n/ff Smart Keep Alive 1. On the main menu, click Tls > Glbal Optins. The Glbal Optins dialg bx appears. 2. Expand the Cnnectin nde, then click Smart Keep Alive. 3. In the right pane, select the Enable Smart Keep Alive (SKA) check bx t turn n SKA; clear the check bx t turn ff SKA. 4. Cnfigure SKA as needed: T set the time SKA waits befre starting In the Start SKA n secnds after the last cmmand bx, type r select a value between 0 and CuteFTP will begin using SKA after the specified idle time. (The default is 30 secnds.) T set hw lng SKA will run In the Maintain SKA fr n minutes bx, type r select a value between 1 and (The default is 30 minutes.) T set when SKA cmmands are sent 75

76 CuteFTP v9 User Guide In the Send cmmand at randm intervals between n and n secnds bx, type r select values between 0 and (The default is between 15 and 60 secnds.) SKA sends cmmands frm the Cmmands list in randm rder. T add a cmmand Click Add. The Input FTP Cmmand dialg bx appears. Type a cmmand t add t the list, then click OK. T remve a cmmand Click a cmmand in the list, then click Remve. T set hw lng CuteFTP waits befre recnnecting In the If discnnected, aut-recnnect within n secnds bx, type r select a value between 1 and 1000 secnds. (The default is 10 secnds.) 5. Click OK t save the settings and clse the dialg bx, r click Apply t save the settings withut clsing the dialg bx. SOCKS 4 and 5 Cnnectin Settings SOCKS is a netwrk prxy prtcl that allws transparent Internet cnnectins acrss a firewall. T access SOCKS 4 and 5 settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Cnnectin nde, then click SOCKS4 & 5. The SOCKS4 & 5 ptins appear. 3. T cnnect t an FTP site thrugh a SOCKS server, select the Use the highlighted SOCKS server when cnnecting check bx. Clear this check bx t cnnect t an FTP site withut cnnecting thrugh a SOCKS server. 4. Cnfigure ptins as described belw. T include a server in the SOCKS list, click Add, then type the server name in the Hst name bx. T make FTP cnnectins thrugh a specified server, click the hst name in the list T delete a server frm the SOCKS list, click it, then click Remve. The Hst name bx displays the name f a server selected in the SOCKS list. T edit a hst name, click a server in the SOCKS list, then edit the name in the Hst name bx. The Prt bx displays the prt number fr the server selected in the SOCKS list. The default prt fr SOCKS servers is T edit the server's prt number, click it in the SOCKS list, then edit the number in the Prt bx. T send the prper user name and passwrd fr the SOCKS server autmatically when first cnnecting, select the Use Authenticatin check bx. Clear this check bx if yu d nt have a SOCKS user name and passwrd, r if yu chse t enter them manually upn cnnectin. In the Username bx, prvide the user name fr the highlighted SOCKS server. (The Use Authenticatin check bx must be selected.) In the Passwrd bx, prvide the passwrd fr the highlighted SOCKS server. (The Use Authenticatin check bx must be selected.) Click SOCKS4 r SOCKS5 t match the highlighted SOCKS server. 76

77 Defining Sites SOCKS4 servers d nt require usernames and passwrds. If yu need a username and passwrd t cnnect t the server, it is a SOCKS5 server. Cntact yur system r netwrk administratr r ISP r the prper Hst name, Prt, User name, Passwrd and SOCKS type. 5. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Prxy Cnnectin Settings T access prxy server settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Cnnectin nde, then click Prxy Server. The Prxy Server ptins appear. 3. Cnfigure ptins as described belw. T use the prxy settings already set in Internet Explrer t cnnect t FTP Sites, select the Use netwrk cnnectin prxy settings frm Internet Explrer check bx. Clear this check bx t cnnect t an FTP Site withut cnnecting thrugh a prxy server, r t cnnect using prxy settings listed in CuteFTP. With this ptin, CuteFTP attempts t detect Internet Explrer's prxy settings, including prxy.pac prxy script files. This is nly available fr Windws XP SP1, W2K Pr SP3, W2K Server SP3, and W2K Server 2003 using WinHTTP dll. If that fails, WinInet dll, which is supprted by XP, 2K PRO, NT4, ME, 98, and 95 is queried. T cnnect t an FTP Site thrugh a prxy server, select the Use the highlighted prxy when cnnecting check bx. Clear this check bx t cnnect t an FTP Site withut cnnecting thrugh a prxy server, r t cnnect using settings frm Internet Explrer. T make FTP cnnectins thrugh a specified server, click it in the Prxies list. T add a server t the Prxies list, click Add, then type the server name in the Hst name bx. T delete a server frm the Prxies list, click it, then click Remve. The Hst name bx displays the name f a server selected in the Prxies list. T edit the hst name, click a server in the Prxies list, then edit the name in the Hst name bx. The Prt bx displays the name f a server selected in the Prxies list. T edit the prt, click a server in the Prxies list, then edit the name in the Prt bx. In the Username bx, type r edit the user name fr the selected prxy server. In the Passwrd bx, type r edit the passwrd fr the selected prxy server. T match the prtcl the selected prxy server supprts, click FTP r HTTP. T specify advanced authenticatin methds, click Advanced then click ne f the fllwing methds: USER if yur prxy server requires the USER cmmand fllwed by yur user name and the Site name t allw cnnectin with a remte Site. Yu can change symbl if a different separatr is required by yur prxy server. 77

78 CuteFTP v9 User Guide SITE Site if yur prxy server requires the SITE cmmand fllwed by the address f the remte FTP Site t allw a cnnectin. USER with lgn if yur prxy server requires the USER cmmand fllwed by a user name and passwrd t allw cnnectin with a remte Site. USER/PASS/ACCT if yur prxy server requires all three cmmands befre allwing a cnnectin t a remte Site. OPEN Site if yur prxy server requires the OPEN cmmand fllwed by the Site name befre allwing cnnectin t the Site. Custm if yur prxy server requires a lgin sequence different frm thse abve. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. T create a custm authenticatin methd fr a prxy server 1. Click Advanced. The Advanced Prxy Settings dialg bx appears. 2. Click Custm, then type a cmmand in the text bx. 3. Fllw the cmmand with a space and the apprpriate variable. Chse frm: %hst% - sends the hst name yu typed in the Prxy server ptins windw. %user% - sends the user name yu typed in the Prxy server ptins windw. %pass% - sends the passwrd yu typed in the Prxy server ptins windw. %prt% - sends the prt number yu typed in the Prxy server ptins windw. %fire_pass% - sends the passwrd yu typed in the Prxy server ptins windw as authenticatin fr the firewall. %fire_user% - sends the user name yu typed in the Prxy server ptins windw as authenticatin fr the firewall. 4. Enter each variable with percent signs befre and after. 5. Press ENTER t separate cmmands. 6. Enter any ther cmmands and variables, separating cmmands with a line break. 7. Click OK. Cntact yur system administratr fr the prper Hst name, Prt, User name, Passwrd, and prxy type, as well as any required advanced authenticatin methds. Encrypt Passwrds Using OTP When yu cnnect t a Site, yu can encrypt yur passwrd t prtect it frm interceptin using the One- Time Passwrd (OTP) scheme. OTP is supprted by Glbalscape EFT Server, varius *nix servers, and a few Windws-based servers. T enable OTP fr a standard FTP Site 1. In the Site Manager, click a Site. 2. On the main menu, click File > Prperties. 3. Click the Type tab. 4. In the Prtcl type bx, make sure FTP (standard File Transfer Prtcl) is selected. 78

79 Defining Sites 5. In the Passwrd Prtectin grup, specify an encryptin methd. Nt Encrypted - the passwrd is sent unprtected t the server. MD4 - A system that encrypts yur passwrd a different way every time it is sent. MD5 - A system like MD4, with mre cmplex encryptin scheme. Aut detect OTP - CuteFTP tries t detect the encryptin methd the server uses. 6. Click Cnnect r OK. T enable OTP fr an FTP ver SSL Site 1. On the Site Manager tab, click a Site. 2. On the main menu, click File > Prperties. 3. Click the Type tab. 4. In the Prtcl type bx, make sure FTP (standard File Transfer Prtcl) is selected. 5. In the Passwrd Prtectin grup, specify an encryptin methd. 7. In Prtcl type, select the desired SSL cnnectin mechanism. 8. Click Cnnect r OK. Using OTP with SSL adds a redundant layer f prtectin as SSL authenticatin already prtects the passwrd using a rbust encryptin mechanism. OTP is defined in RFC 1938 (replaced by 2289) and was evlved frm S/KEY, a One-Time Passwrd System riginally develped by Bellcre. CuteFTP supprts keybard-interactive authenticatin. This authenticatin methd invlves cnnecting t servers with a challenge/respnse type f passwrd-based authenticatin, and requires a ne-time use passwrd typically generated by hardware r, less cmmnly, sftware-based passwrd generatrs. TappIn Site Creatin TappIn is a Glbalscape prduct that allws yu t cnnect t yur music, mvies, and dcuments at hme r in the ffice frm anywhere, including mbile devices. Fr infrmatin abut TappIn, refer t the TappIn articles in the Glbalscape Knwledgebase. CuteFTP is installed with a TappIn Test Drive Site with which yu can experience TappIn. The TappIn Test Drive Site prvides read-nly access t a sample TappIn share. The TappIn Test Drive Site cnnects t webdav.tappin.cm via HTTPs, prt 443. If this prt r HTTPS is blcked by a firewall, yu will nt be able t cnnect t the TappIn Test Drive Site. 79

80 CuteFTP v9 User Guide Yu can create yur wn TappIn Sites t access yur TappIn shares and yur friends' TappIn shares. One Site can access nly ne share, s yu must create a Site fr each share that yu want t access. T create yur wn TappIn cnnectin (n which yu can have create, read, update, and delete permissins, depending n the settings fr the TappIn share), refer t the prcedure belw. If yu dn't have a TappIn accunt, r if yu want t learn mre abut TappIn, click Sign up t g t and create ne. If yu have frgtten yur TappIn passwrd, g t t reset it. T create a TappIn cnnectin in CuteFTP 1. On the cmputer n which the shared flder exists, create a TappIn share. (Refer t fr details f creating a TappIn share.) 2. In CuteFTP, d ne f the fllwing: On the main menu, click File > New >TappIn Site. Right-click in the Site Manager, then click New > TappIn Site. Click TappIn Test Drive. The Site Prperties dialg bx fr a TappIn Site appears. 80

81 Defining Sites 3. Prvide the fllwing infrmatin: In the Label bx, give the Site a name. In the Username bx, prvide yur TappIn username. If yu d nt have an accunt, click Sign up and fllw the prmpts t create an accunt. In the Passwrd bx, prvide yur TappIn passwrd. If yu have an accunt but have frgtten yur passwrd, click Frgt yur passwrd r g t g t t reset it. (The Frgt yur passwrd link is nt functinal fr the TappIn Test Drive Site; yu cannt change its passwrd.) In the Cnnect t bx, click the drp-dwn list t specify which shares yu want t access: All f my TappIn shares, One f my TappIn shares, r A friend's TappIn share. In the Share name bx, if yu specified ne f my TappIn shares r A friend's TappIn share, type the name f the TappIn share exactly as it is in TappIn. (Refer t fr details f creating a TappIn share.) In the Friend's TappIn username bx, if yu specify A friend's Tappin share, type the username f the wner f the shared lcatin. (Friend shares cannt be accessed frm yur wn directry.) 4. Click the Actins tab and prvide the fllwing infrmatin: When client cnnects, switch t this remte flder Specify the remte flder that yu want t access. Typically, yu wuld specify the tp flder that yu have permissin t access. 81

82 CuteFTP v9 User Guide When client cnnects, switch t this lcal flder Specify the flder n yur cmputer that yu want t use with this cnnectin. Fr example, yu might want t dwnlad files frm the TappIn lcatin t yur hard drive. Fr navigatin, use the fllwing caching ptins "Caching" means that CuteFTP temprarily stres the Site's list infrmatin n yur cmputer, s when yu navigate t different files and flders, yu dn't have t recnnect. Specify t Always use cache, D nt use cache, r Use cache during sessin (the default). When uplading, apply this rule t files and flder names Sme perating systems, such as the Unix, are "case sensitive.'' If yu type yur username in mixed case (e.g., ImaUser rather than imauser) Unix will nt recgnize it. Depending n the server t which yur are cnnecting, specify whether t Frce upper case, Frce lwer case, r Preserve case (the default). Filter Click Filter, then specify whether t filter the remte server's list f flders and files. Fr details f using filters, refer t Filtering the List f Files and Flders. Add this Site t right-click uplad menu Select the check bx add the TappIn Site t the right-click menu in Windws Explrer. 5. Click the Optins tab and specify whether t Use glbal settings fr all ptins (the Site will use the parameters set in Glbal Optins) r Use Site-specific ptin (the Site will use the parameters set n this tab). If yu specify t Use Site-specific ptins, specify the fllwing ptins: Apply aut-rename scheme t transfers Select this check bx if yu want the files that yu transfer t be renamed accrding t the settings yu chse in the Rename Rules. Clear this check bx if yu d nt want files t be renamed when yu make transfers with this Site. Use the lgical parent (nt physical parent) n CDUP Select this check bx if yu want t return t the previus directry when yu clicked the Up flder icn, even if yu clicked a link r shrtcut in the previus directry. Clear this check bx t g back t the parent directry fr this flder, which might nt have been the directry yu were in when yu jumped t the current directry. Site-specific firewall settings Click Prxy if yu need t cnnect thrugh a prxy server t get t this Site. A Prxy dialg bx appears in which yu can enter the prxy type, server address, username and passwrd. Click Scks if yu need t cnnect thrugh a Scks server t get t this Site. A Scks dialg bx appears in which yu can enter the SOCKS type, server address, username and passwrd. Refer t Prxy Cnnectin Settings and Scks 4 and 5 Cnnectin Settings fr details. Retry attempts Specify the number f times yu want CuteFTP t try cnnecting t this Site, if there is a prblem making a cnnectin. Delay between retries Specify the number f secnds yu want CuteFTP t wait befre retrying a cnnectin after a cnnectin attempt fails. Site max cncurrent transfers Specify the number f cnnectins CuteFTP can pen t the Site fr transferring many files simultaneusly. 6. Click OK t save the Site r click Cnnect t cnnect. 82

83 Defining Sites Web Distributed Authring and Versining (WebDAV) WebDAV is an extensin t the HTTP/1.1 prtcl that allws clients t perfrm remte Web cntent authring peratins. HTTP defines many headers that can be used in WebDAV requests and respnses. WebDAV prvides functinality t create, change, and mve dcuments n a remte server (typically a web server r "web share"). This is useful, amng ther things, fr authring the dcuments that a web server serves, but can als be used fr general web-based file strage that can be accessed frm anywhere. Imprtant features in WebDAV prtcl include lcking (verwrite preventin), prperties (creatin, remval, and querying f infrmatin abut authr, mdified date, etc.), name space management (ability t cpy and mve Web pages within a server's namespace), and cllectins (creatin, remval, and listing f resurces). CuteFTP desn t supprt all WebDAV verbs. In particular, CuteFTP can t take advantage f the additinal services ffered by "Class 2" WebDAV-cmpliant servers ( Verbs that CuteFTP desn't supprt are PROPPATCH, LOCK, and UNLOCK. In CuteFTP, WebDav is mst ften used with TappIn shares. Fr nn-tappin Sites, refer t Cnnecting t an HTTP Site. 83

84 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 84

85 Chapter 4. Site Administratin The tpics belw prvide prcedures fr administering yur Sites. (Fr creating a site, see Cnnecting t Sites using the Cnnectin Wizard.) Imprting and Exprting Site Cnfiguratin Yu can add Sites t yur Site Manager frm text listings; yu can exprt yur Site Manager listings if anther user requires the same Site cnfiguratin, r if yu just want t back up the Site Manager. T imprt Sites 1. On the main menu, click Tls > Site Manager > Imprt/Exprt FTP Sites. The Chse imprt r exprt Site Manager wizard appears. 2. In the Select the peratin area, click Imprt, then click Next. 3. Specify the surce frm which yu want t imprt, then click Next. 4. In the Cnversin type area, d ne f the fllwing: Merge the entries int the existing Site Manager Create a new Site Manager with these entries 5. Click Next. The file lcatin page appears. 6. Click magnifying glass icn t pen the Find Site Database Tl and view the list f Sites. 7. Click the Site yu want t imprt, then click OK. (Yu may need t click Stp t stp the search and enable the OK buttn.) 8. After the Sites are imprted, click Finish. 9. Open the Site Manager t verify the Sites were imprted. T exprt yur Site Manager listings D ne f the fllwing: Right-click in the Site Manager, then click ne f the fllwing frmats, then specify the lcatin and file name fr the file. Exprt Sites as Text (cntains all Site prperties) Exprt Sites as URL (cntains nly the URLs f the Sites). On the main menu, click Tls > Site Manager > Imprt/Exprt FTP Sites. The Chse imprt r exprt Site manager wizard appears. a. Click Exprt, then click Next. b. In the Select the file frmat area, click ne f the fllwing: c. Click Next. As text - t generate a list f Sites in plain text. As URL - t generate a list f Sites as Web addresses. d. In the File lcatin and Name bx, click the flder icn t define the path fr the new file. The Save As dialg bx pens. e. In the File name bx, type a name fr the file, then click Save. f. Click Finish 85

86 CuteFTP v9 User Guide Remving a Site frm the Site Manager If yu have Sites defined in the Site Manager t which yu n lnger cnnect, yu can delete them. There is n way t recver them after yu delete them. It is a gd idea t exprt a backup file f the Sites befre yu delete any Sites. T remve a Site frm the Site Manager 1. Display the Site Manager. 2. Click the Site yu want t delete, then d ne f the fllwing: Click the Site that yu want t delete, then n the main menu, click File > Delete. Right-click the Site, then click Delete. On the keybard, press DELETE. On the tlbar, click the Delete icn. 3. A cnfirmatin message appears. Click Yes. Changing a Site's Cnnectin Settings r Lgin Infrmatin On the General tab f the Site Prperties dialg bx, yu can change the cnnectin r lgin infrmatin fr the selected Site. T change a Site's cnnectin settings r lgin infrmatin 1. Display the Site Manager and view the Site Prperties. 2. Click the General tab. 3. Change the infrmatin as needed, then click Cnnect t accept the changes and cnnect t the Site, r OK t accept the changes withut lgging in. 86

87 Site Administratin Changing the Data Cnnectin Type (Prt r PASV) The Sites use the data cnnectin type (r mde) set in the Glbal Optins dialg bx. Yu can verride that setting fr each Site. Fr example, if yu want t cnnect in PASV mde t a server that prefers PORT fr data cnnectins, yu might need t change the data cnnectin type. T change the data cnnectin type 1. Display the Site Manager and view the Site Prperties. 2. Click the Type tab. 3. In the Data Cnnectin Type bx, click Use PORT r Use PASV. 4. Click Cnnect r OK. Prxy Settings fr Individual Sites The Sites use the prxy settings in the Glbal Optins dialg bx. Yu can verride that setting in the Site's prperties. T setup a prxy cnnectin fr an individual Site 1. In the Site Manager, click the Site yu want t change. 2. D ne f the fllwing: Right-click the Site, then click Prperties. On the main menu, click File > Prperties. 3. Click the Optins tab. 4. In the Site-specific cnfiguratin ptins list, click Use Site-specific ptin. 5. Click Prxy. The Prxy dialg bx appears. 6. In the Prxy type list, click the prtcl yur prxy server supprts. 7. In the Hst name and prt bxes, type the name and prt number f the prxy server. The default prt fr prxy servers is

88 CuteFTP v9 User Guide 8. If the prxy server requires a user name and passwrd r sme ther authenticatin, select the Use authenticatin check bx. If the prxy server des nt require authenticatin, skip t step Type yur prxy User name. 10. Type yur prxy Passwrd. 11. If yur prxy server nly requires the user name and passwrd, skip t step 15; therwise, click Advanced. 12. Click ne f the fllwing advanced authenticatin methds. USER if yur prxy server requires the USER cmmand fllwed by yur user name and the Site name t allw cnnectin with a remte Site. Yu can replace sign with a different separatr t match what yur prxy server requires. SITE Site if yur prxy server requires the SITE cmmand fllwed by the address f the remte FTP Site t allw a cnnectin. USER with lgn if yur prxy server requires the USER cmmand fllwed by a user name and passwrd t allw cnnectin with a remte Site. USER/PASS/ACCT if yur prxy server requires all three cmmands befre allwing a cnnectin t a remte Site. OPEN Site if yur prxy server requires the OPEN cmmand fllwed by the Site name befre allwing cnnectin t the Site. Custm if yur prxy server requires a lgin sequence different frm thse abve. See the prcedure belw fr creating a custm authenticatin methd. 14. Click OK t clse the Advance Prxy Settings dialg bx. 15. Click OK t accept the Prxy settings specific t this Site. 16. Click Cnnect r OK t clse the Site Manager. Cntact yur system administratr fr the prper Hst name, Prt, User name, Passwrd, and prxy type, as well as any required advanced authenticatin methds. T create a custm authenticatin methd fr a prxy server 1. Type a cmmand. 2. Fllw the cmmand with a space and an apprpriate variable: %hst% sends the hst name yu typed in the Prxy dialg bx. %user% sends the user name yu typed in the Prxy dialg bx. %pass% sends the passwrd yu typed in the Prxy dialg bx. %prt% sends the prt number yu typed in the Prxy dialg bx. %fire_pass% sends the passwrd yu typed in the Prxy dialg bx as authenticatin fr the firewall. %fire_user% sends the user name yu typed in the Prxy dialg bx as authenticatin fr the firewall. Type each variable with percent signs befre and after. 3. Press Enter t separate cmmands. 4. Click OK. 88

89 Site Administratin Crrecting Times fr Sites in Different Time Znes CuteFTP uses time zne ffset infrmatin fr display, transfer, and verwrite lgic. T cmpensate fr servers in different time znes 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Type tab. 3. In the Server time zne list, select the server's time zne. Alternatively, select the Autmatically detect check bx, and CuteFTP will determine the time zne frm the system clck. 4. Click Cnnect r OK. Specifying Whether t Save a Site's Infrmatin - Caching "Caching" means CuteFTP stres the Site list infrmatin n yur cmputer, s when yu navigate t different files and flders, yu dn't have t recnnect. T specify cache ptins 1. Display the Site Manager, right-click the Site, then click Prperties. 89

90 CuteFTP v9 User Guide 2. Click the Actins tab. 3. In the Fr navigatin use the fllwing caching ptins bx, click ne f the fllwing: Use cache during sessin - Stre the site's infrmatin nly until yu clse the cnnectin (the default setting). Always use cache - Stre the site's infrmatin and keep it even after yu discnnect. D nt use cache - Never stre the site's infrmatin. 4. Click Cnnect r OK. Designating a Site's Server Type Yu can imprve cmpatibility with individual Sites by designating the type f server used fr that Site. T designate server type 1. Display the Site Manager, right-click the Site, then click Prperties. 90

91 Site Administratin 2. Click the Type tab. 3. In the Server Type list, select a server type. 4. Click Cnnect r OK. Finding a Site in the Site Manager If yu have numerus Sites defined in the Site Manager, yu use the Find functin t search fr it. T find a Site in the Site Manager 1. Display the Site Manager. 2. Right-click in the Site Manager, then click Find Text in Site Manager (r press ALT+F3). The Find dialg bx appears. 3. Type all r part f the Site name, then click OK. 4. If a Site ther than the ne yu wanted is fund, right-click and select Find Next, r press F3, until the desired Site is highlighted. The Find tl is nt case sensitive, searches frm the tp t the bttm f yur Site listings, and des nt recgnize wildcards. Creating and Using Bkmarks Yu can have special entries called bkmarks assciated with Sites that pen a specific lcal r remte flder, r bth lcal and remte flders. T create a bkmark 1. Display the Site Manager, then duble-click the Site t cnnect t it. 91

92 CuteFTP v9 User Guide 2. In the Lcal tab, click r brwse t the flder yu want t bkmark. 3. In the Remte tab, click r brwse t the remte flder yu want t bkmark. 4. D ne f the fllwing: On the main menu, click Tls > Bkmark current flder. Click the Bkmark icn, then click Bkmark current flder. Press CTRL+Q. The Set bkmark dialg bx appears. 5. The Lcal flder and the Remte flder are displayed in the Set Bkmark dialg bx and cannt be changed. T change the lcal flder and remte flder yu have t repeat the previus steps. 6. Bkmarks created in this manner are assigned the remte flder as their default name, but yu can name it anything yu want. In the Bkmark Name bx, prvide a descriptive name fr the bkmark, then click OK. The new bkmark appears in the Site Manager as a sub-listing f the remte Site's entry. T cnnect t a bkmarked directry D ne f the fllwing: Duble-click a bkmark displayed as a sub-item under the Site name in the Site Manager. Click Bkmark and select the desired bkmark frm the shrtcut menu. On the tlbar, click the Bkmark icn, then click the bkmark n the shrtcut menu. A new remte windw appears displaying the bkmark's remte flder, if specified; therwise, the rt flder appears. The Site Manager switches t Lcal Drives, displaying the lcal flder specified in the bkmark. 92

93 Site Administratin T edit a bkmark 1. In the Site Manager, click the bkmark. 2. D ne f the fllwing: On the main menu, click File > Prperties. Right-click the bkmark, then click Prperties. The Bkmark Prperties dialg bx appears. 3. T change the remte flder, in the Remte path bx, type a new remte path. 4. T change the lcal flder, in the Lcal Path bx, type r brwse fr a new lcal path. 5. Click OK. T rename a bkmark 1. Click the bkmark. 2. On the main menu, click File > Rename (r press F2). 3. Type a new name, then press ENTER. T remve a bkmark 1. Click the bkmark, then d ne f the fllwing: On the main menu, click File > Delete. Right-click the bkmark, then click Delete. On the tlbar, click the Delete icn. 2. A cnfirmatin message appears. Click Yes. 93

94 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 94

95 Chapter 5. OpenPGP Security Settings The tpics belw prvide the prcedures fr managing, imprting, exprting, and uplading OpenPGP keys. CuteFTP uses OpenPGP, based n the pen surce implementatin f Pretty Gd Privacy (PGP), t safeguard transferred data. PGP prvides cryptgraphic privacy and authenticatin by encrypting the cntent f any data, such as any cmputer file r message text. OpenPGP uses asymmetric key encryptin algrithms, with which the recipient must have previusly generated a linked key pair, a Public key, and a Private key. This key pair is assciated with a particular site. The public key encrypts the data and the private key helps in decrypting data. CuteFTP allws yu t create keys and ensures security f the transferred data. A file is encrypted befre it is upladed t a server. Fr example, if yu want t uplad result.txt as OpenPGP encrypted file, the system encrypts result.txt int result.txt.pgp and then uplads result.text.pgp t a server. OpenPGP keys CuteFTP allws yu t create, imprt, exprt, and delete OpenPGP keys. T create an OpenPGP Key n fly t transfer files, refer t Uplading and Dwnlading Files Using OpenPGP Keys. T specify an OpenPGP key t use (if yu have created a key) 1. On the tlbar, click the OpenPGP Mde icn. The OpenPGP Mde Settings dialg bx appears. 2. In the Select key list, click a key. T view, create, imprt, exprt, r delete keys 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Security nde, then click OpenPGP Security. The OpenPGP Security ptins appear. T create OpenPGP keys a. Click Create. The OpenPGP Key Generatin dialg bx appears. b. In the Key ID bx, type yur address. The key identifies the key pair. c. In the Key Passphrase and the Cnfirm Passphrase bxes, type yur private key passphrase. 95

96 CuteFTP v9 User Guide d. In the Key size t use list, click a key size. A key is a value that wrks with a cryptgraphic algrithm t prduce a specific ciphertext (encrypted message) frm a specific plaintext (riginal dcument). Key size is measured in bits. In cryptgraphy, a bigger the key ensures mre secure ciphertext. e. In the Key type t use list, click a key type. Key types are the cryptsystems named after their inventrs. f. T generate the keys, click Generate. g. The generated key is added t the OpenPGP Key list. The OpenPGP Key list displays the user id, key id, and key type. T delete an OpenPGP key Click a key in the list, then click Delete. T imprt an OpenPGP key a. In the OpenPGP list, click a key, then click Imprt. The Open dialg bx appears. b. Navigate t the OpenPGP key file, then click Open. c. Click OK. T exprt an OpenPGP key a. In the OpenPGP list, click a key, then click Exprt. A cnfirmatin message appears. b. Click Yes t exprt the private key alng with the public key, therwise click N. The Save As dialg bx appears. c. In the File name bx, type a name fr the key, then click Save. d. Click OK. Uplading and Dwnlading Files Using OpenPGP Keys Yu can uplad and dwnlad files using OpenPGP keys. The Public key encrypts the data befre the uplad starts and Private key decrypts the data prir t the dwnlad. T uplad r dwnlad a file using OpenPGP keys 1. Cnnect t yur site. 2. In the Lcal pane (uplad) r Remte pane (dwnlad), click the file yu want t transfer. 3. D ne f the fllwing: On the main menu, click Tls > OpenPGP mde. On the tlbar, click OpenPGP Mde. Right-click the file yu want t uplad, click Uplad Advanced, then click Uplad OpenPGPed. Right-click the file yu want t dwnlad, click Dwnlad Advanced, then click Dwnlad OpenPGPed. If n key is defined, a message appears asking if yu want t create ne. 96

97 OpenPGP Security Settings a. Click Yes. The OpenPGP Key Generatin dialg bx appears. b. In the Key ID bx, type yur address. The key identifies the key pair. c. In the Key Passphrase and the Cnfirm Passphrase bxes, type yur private key passphrase. d. In the Key size t use list, click a key size. A key is a value that wrks with a cryptgraphic algrithm t prduce a specific ciphertext (encrypted message) frm a specific plaintext (riginal dcument). Key size is measured in bits. In cryptgraphy, a bigger the key ensures mre secure ciphertext. e. In the Key type t use list, click a key type. Key types are the cryptsystems named after their inventrs. f. T generate the keys, click Generate. g. The generated key is added t the OpenPGP Key list. The OpenPGP Key list displays the user id, key id, and key type. 4. In the OpenPGP Mde Settings dialg bx, click a key, then click OK. 97

98 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 98

99 Chapter 6. SSL/TLS Cnnectins (FTPS/HTTPS) The tpics belw prvide the prcedures fr defining SSH2 (SFTP) cnnectins with CuteFTP. See als Cnnecting t Secure Scket Layer (SSL) Sites. Learning abut SSL When yu use CuteFTP t cnnect securely t a server that supprts SSL r TLS (SSL v3), the tw cmputers pass a sequence f cmmands t create a secure cnnectin. The FTP prtcl definitin prvides at least tw distinct mechanisms by which this sequence is initiated: Explicit (active) and Implicit (passive) security. Explicit Security - Explicit security requires that the FTP client issue a specific cmmand t the FTP server after establishing a cnnectin t establish the SSL link. The default FTP server prt is used. This frmal methd is dcumented in RFC Implicit Security - Implicit security is a mechanism by which security is autmatically turned n as sn as the FTP client makes a cnnectin t an FTP server. In this case, the FTP server defines a specific prt fr the client (990) t be used fr secure cnnectins. Implicit SSL is discussed in varius SSL drafts, but nt frmally adpted in an RFC. Fr strict cmpliance t standards, use the explicit methd. Implicit SSL adds benefits in the frm f a dedicated prt strictly used fr secure cnnectins, requiring fewer verheads in establishing the sessin. There are varius FTP servers that supprt this mde, including Glbalscape's EFT Server. Fr mre n SSL Cnnectin Mechanisms, see Trubleshting SSL Cnnectins. SSL Sessins The diagram shws an SSL sessin using explicit security. In this picture, the tw cmputers cmmunicate ver an Internet cnnectin. Time is represented vertically; the first cmmunicatin at the tp f the time line is frm the Client t the Server, and subsequent cmmunicatins prceed chrnlgically dwn the time line. The breaks in the time line represent the passage f time. CuteFTP adheres t Internet standards fr secure transfer f files ver the FTP prtcl. Specifically, CuteFTP implements the FTP extensins dcumented in RFC Any FTP Server that als implements these extensins will wrk with CuteFTP in rder t ensure the encryptin f yur sensitive data. SSL Security Settings T access the SSL security settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 99

100 CuteFTP v9 User Guide 2. Expand the Security nde, then click SSL Security. The SSL Security ptins appear. 3. Cnfigure ptins as described belw: Select the Use SSL certificate when authenticating t send a certificate t SSL servers fr authenticatin. Clear this check bx t send n certificate t SSL servers fr authenticatin. Yur server may nt require client certificates. If they d require client certificates, yu may need t send yur self-signed r 3rd-party signed certificate t the server administratr t be added t the server's Trusted List. In the Certificate bx, brwse t r type the lcatin f an SSL certificate file n yur lcal cmputer. The file shuld have a.crt extensin. In the Private key bx, brwse t r type the lcatin f an SSL private key file n yur lcal cmputer. The key file shuld have a.key extensin. In the Use passphrase bx, prvide the passphrase used fr the certificate listed in the Certificate field. In the Cnfirm Passphrase, prvide the passphrase again fr the certificate listed. The private key passwrd is stred in the registry using strng encryptin. Fr added security, leave the passphrase bxes blank s that CuteFTP will prmpt yu fr the private key passwrd when necessary. Click Create Certificate t create a new SSL certificate with a signing request and a key fr the certificate. Fr mre infrmatin n creating SSL certificates, see Creating yur wn SSL certificates. Click Trusted Certificates t display a list f certificates that yu have accepted as valid. Fr mre infrmatin n trusted certificates, see Accepting server SSL certificates and Imprting SSL certificates. Select the Reuse cached sessin fr data cnnectin (required by sme servers) check bx t allw new transfers withut encrypting a new data channel. Clear this check bx t require encryptin f every sessin fr every new transfer. Select the Accept certificates in Windws Trusted Rt Certificate Authrity stre check bx t autmatically trust certificates already accepted by yur system, even if they have nt been added t yur Trusted list. Clear this check bx t require all certificates t be added t the CuteFTP Trusted list befre allwing cnnectins. Select the Warn when switching frm secure t nn-secure pages check bx t see a pp-up message when, after cnnecting t a secure HTTP site, yu click a flder r link that is nt secure. Clear this check bx t be able t link frm secure HTTP sites t HTTP sites that are nt secure withut seeing any pp-up messages. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Creating SSL Certificates SSL servers use certificates t determine whether they will allw yu t cnnect. With CuteFTP, yu can create and sign digital certificates. T create an SSL certificate 1. On the main menu, click Tls > Glbal Optins. 2. Expand the Security nde. 3. Click SSL Security. 100

101 SSL/TLS Cnnectins (FTPS/HTTPS) 4. Click Create Certificate. The Create Client SSL Certificate Set wizard appears. 5. In the Certificate set name bx, type the name f the certificate that will be generated by the Certificate Wizard. 6. In the Output Lcatin bx, click the flder icn t select a flder in which t save the certificate. 7. In the Key length in bits bx, click a bit length fr the certificate private key. CuteFTP supprts keys up t 4,096 bits. 8. In the Expiratin bx, specify hw lng the certificate is t remain valid. 9. Create and cnfirm the Passphrase. The passphrase, which is used t encrypt the private key, can be any cmbinatin f characters r spaces. D nt lse the passphrase, as the certificate is useless withut it. 10. Click Next. The Certificate Infrmatin page appears. 11. Prvide the fllwing required infrmatin: City/Twn - the city/twn where yur rganizatin is lcated. State/Prvince - the state/prvince where yur rganizatin is lcated. 101

102 CuteFTP v9 User Guide Organizatin - the name f yur rganizatin. Cmmn Name - the cmmn name r fully qualified dmain name f yur Site (e.g., address in the frmat x@x.cm. Unit - name f yur department, such as Infrmatin Systems. Cuntry - the tw-letter cuntry cde fr the cuntry where yur rganizatin is lcated. 12. Click Next. The final page appears. 13. Click the Set up CuteFTP t use the generated certificate check bx - the wizard autmatically assciates the certificate t CuteFTP. The certificate can be unassciated by clearing the Use SSL Certificate check bx in Glbal Optins (Tls > Glbal Optins > Security > SSL Security). If the check bx is cleared, the wizard nly saves the certificate files in the flder riginally specified. 14. Click Finish. CuteFTP displays the paths t all the files generated fr yur certificate. If yu want a third party t sign yur certificate, yu must send the Certificate Signing Request (.csr) file t the third party. The CSR is saved in the lcatin yu specified n the first page f the wizard, e.g., C:\Users\Administratr\AppData\Raming\Glbalscape\CuteFTP\9.0\Security. Cnfiguratin Ntes Nt all SSL Sites require certificates. When yu create a certificate, CuteFTP generates the fllwing files: Private key file (.key) - The private key shuld never be distributed t anyne. It is used t decrypt sessins encrypted by a public key. Certificate request file (.csr) - This file can be signed by Glbalscape EFT Server's Certificate Signing Utility r sent t an intermediate Certificate Authrity such as Verisign r Thawte fr signing. Certificate file (.crt) - This is a signed certificate, whether self-signed r signed by an intermediate certificate authrity. If the server accepts self-signed certificates, yu can cnnect with the.crt file and.key file yu created and assciated t CuteFTP, prvided the server has added yur certificate t its trusted list. 102

103 SSL/TLS Cnnectins (FTPS/HTTPS) Yu can exprt certificates (.crt files) frm CuteFTP's Trusted certificate stre, lcated in Glbal Optins > Security > SSL Security. Signed SSL Certificates T have a certificate signed 1. Create a certificate. CuteFTP generates the necessary files, including a Certificate Signing Request (.csr) file. 2. Send the CSR file t EFT Server r a Certificate Authrity (CA) such as Verisign ( r Thawte ( 3. EFT Server r the CA creates a signed certificate (CRT) file. 4. Replace yur existing CRT file with the signed ne. Chsing a Certificate fr SSL Sessins Chse the certificate CuteFTP will send t SSL servers. T chse a certificate 1. On the main menu, click Tls > Glbal Optins. 2. Expand the Security nde. 3. Click SSL Security. 4. Select the Use SSL Certificate when authenticating check bx. 5. Brwse t the files t use by clicking the flder icns next t Certificate and Private Key. 6. Type the passphrase in the Passphrase and Cnfirm passphrase bxes. 7. Click Apply, then click OK. CuteFTP can use digital certificates in the fllwing frmats: PEM, Base64 Encded X509, PKCS#7, and PKCS#12. The private key assciated with the digital certificate must be in ne f the fllwing frmats: PEM, PKCS#8, PKCS#12. DER Encded keys r certificates are nt supprted by CuteFTP. Accepting Server SSL Certificates Accepting a certificate frm a server allws yu t cnnect with the server. Once yu accept a certificate, it is added t yur Trusted Certificates list, and yu will nt be asked t accept r reject the certificate again. If yu reject a certificate, and try t cnnect again, yu will be asked again t accept the certificate. T accept a server's SSL certificate 1. Cnnect t a server with SSL. If the server has a certificate, it appears. 2. Click Accept. The certificate is added t yur Trusted Certificates list. If yu click Reject, yu will nt be able t cnnect t the server. T see yur Trusted Certificates 1. On the main menu, click Tls > Glbal Optins. 2. Expand the Security nde. 3. Click SSL Security. 4. Click Trusted Certificate. The Certificate Manager appears. 5. Click a certificate in the list, then click Prperties t see detailed infrmatin abut the certificate. 103

104 CuteFTP v9 User Guide Imprting r Remving SSL Certificates frm the Trusted List When a certificate is in yur trusted list, yu are able t cnnect t any server presenting that certificate. T imprt a certificate t the CuteFTP trusted list 1. On the main menu, click Tls > Glbal Optins. 2. Expand the Security nde. 3. Click SSL Security. 4. Click Trusted Certificate. The Certificate Manager appears. 5. Click Imprt. The Open dialg bx appears. 6. In the Files f Type field, select Certificates (*.pem, *pfx, *.crt) r All files (*.*). 7. Navigate t the flder cntaining the certificate file. 8. Click the certificate file, then click Open. The certificate is nw listed in yur Trusted Certificates list. 9. Clse the Certificate Manager. 10. Click OK t clse the Glbal Optins dialg bx. T remve an SSL certificate frm the trusted list 1. On the main menu, click Tls > Glbal Optins. 2. Expand the Security nde. 3. Click SSL Security. 4. Click Trusted Certificate. The Certificate Manager appears. 5. Click the certificate yu want t remve, then click Remve. 6. Clse the Certificate Manager. 7. Click OK t clse the Glbal Optins dialg bx. Using a Clear Data Channel with SSL Using CDC (Clear Data Channel) speeds up transfers with SSL sites. A clear data channel encrypts the cnnectin prcess, but files are transferred withut encryptin. Yu can add mre speed t yur transfers by using a clear cmmand channel as well. The Clear Data channel ptin is nly available with SSL cnnectins. T use a clear data channel 1. Open the Site Prperties and click the Type tab. 2. In the Prtcl list, click FTP with TLS/SSL (Prt Implicit), FTP with TLS/SSL (AUTH SSL - Explicit), r FTP with TLS/SSL (AUTH TLS - Explicit). 3. Click the Clear Data channel check bx. 4. Click Cnnect t cnnect nw r OK t cnnect later. 104

105 SSL/TLS Cnnectins (FTPS/HTTPS) Using a Clear Cmmand Channel with SSL Using CCC (Clear Cmmand Channel), yur cnnectin and lgin are encrypted, but when yu begin transferring data, all FTP cmmands are sent in clear text. The data transfers remain encrypted, unless yu chse t use a clear data channel. SSL cnnectins require CCC when cnnecting in PORT mde frm behind a NAT firewall. The Clear Cmmand channel ptin is nly available with SSL cnnectins. T use a clear cmmand channel with SSL 1. Click the site in the Site Manager, then d ne f the fllwing: On the main menu, click File > Prperties. Right-click the site, then click Prperties. Press ALT+ENTER. 2. Click the Type tab. 3. In the Prtcl list, click FTP with TLS/SSL (Prt Implicit), FTP with TLS/SSL (AUTH SSL - Explicit), r FTP with TLS/SSL (AUTH TLS - Explicit). 4. Select the Clear Cmmand channel check bx. 5. Click Cnnect t cnnect nw r OK t cnnect later. Secure Site-t-Site Transfers Using SSCN CuteFTP supprts secure (SSL) Site-t-Site transfers using a prprietary cmmand develped by Raiden FTP Server and supprted by Glbalscape EFT Server and a few thers. T transfer files frm ne server t anther securely 1. Cnnect t each Site (surce and destinatin). 2. On the main menu, click Windw > Tile. 3. Drag the file frm ne Remte Pane t anther. The Queue pane displays a duble arrw (<->) t indicate a Site-t-Site transfer. Bth Sites must supprt and enable SSCN (Set Secured Client Negtiatin). As f March 2004, the fllwing servers are the nly nes t supprt this cmmand: Glbalscape EFT Server, SurgeFTP Server, Raiden FTPD, Blackmn FTP Server, Titan FTP Server, and Orensv HTTP/FTP Server. Trubleshting SSL Cnnectins If yu are having difficulty cnnecting t yur FTP server r HTTPS ver SSL, refer t the fllwing checklist fr help. SSL Cnnectin Checklist 1. Verify that the server yu are cnnecting t supprts SSL cnnectins. 2. Verify the prt being used. Sme servers require that SSL cnnectins use a dedicated prt, such as Verify the SSL cnnectin type n the Site Prperties Type tab is the crrect SSL mechanism supprted by yur server. 4. Verify that yur Certificate was added t the server s Trusted List if the server requires client certificates upn cnnect. Yu may have t ntify the server administratr as nt all servers will aut-accept client certificates upn their first cnnectin attempt. 105

106 CuteFTP v9 User Guide 5. Yu must accept the server s certificate when prmpted during a cnnectin attempt, therwise the client will nt cnnect as desired. 6. Verify that yur certificate has nt expired. Check yur Trusted List. 7. Cpy the cnnectin lg t a text file r t assist in trubleshting when cntacting yur FTP r Web service prvider r the Glbalscape supprt team. SSL Cnnectin Mechanisms Nt all FTP servers that supprt SSL cnnectins d s crrectly r in strict cmpliance t prpsed r apprved standards. Varius FTP-ver-SSL implementatins have been prpsed ver the past few years. Mst d nt cnfrm t RFC 2228 r are at dds with the latest IETF (Internet Engineering Task Frce) drafts. Typical Implementatins include: Implicit TLS/SSL - This is an SSL cnnectin ver a dedicated prt (990) registered with the IANA. This apprach, while quite cmmn, is nt favred by the IETF. CuteFTP supprts this implementatin fr brader cmpatibility. Explicit "AUTH SSL" - This is an SSL cnnectin ver a standard prt (21) using "AUTH SSL" r "AUTH TLS-P" t negtiate the prtectin mechanism. AUTH TLS-P implicitly sets the prtectin mechanism and is therefre in direct disagreement with RFC CuteFTP des supprt AUTH SSL, and subsequently sets the prtectin mechanism explicitly using the PROT cmmand and its apprved arguments. Explicit "AUTH TLS" - This is an SSL v3.1 cnnectin ver a standard prt (21) and explicitly setting the prtectin mechanism. This is the versin that best adheres t RFC 2228, "FTP Security Extensins." This versin is supprted by CuteFTP and is selected by default when yu establish a new SSL cnnectin. Apart frm thse mentined abve, CuteFTP des nt cnnect t servers requiring "AUTH TLS-P" r ther deprecated SSL cnnectin mechanisms. Unable t Cnnect t Titan FTP Server when Using SSL Yu must use encryptin fr every sessin fr every new transfer by disabling the reuse f cached sessins fr data cnnectin. T require encryptin f every sessin fr every new transfer 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Security nde, then click SSL Security. The SSL Security ptins appear. 3. Clear the Reuse cached sessin fr data cnnectin (required by sme servers) check bx t require encryptin f every sessin fr every new transfer, then click OK. 106

107 Chapter 7. SSH2 Cnnectins (SFTP) The tpics belw prvide the prcedures fr defining SSH2 (SFTP) cnnectins with CuteFTP. See als: Cnnecting t Secure Shell (SSH2) Sites SFTP in CuteFTP When yu cnnect with SSH2 there are tw cmpnents r layers invlved: the Transprt and Authenticatin layers. Transprt Layer When yu first attempt t cnnect t an SSH2 Site, CuteFTP and the server determine whether the transmissin shuld be: Encrypted r clear Cmpressed r uncmpressed Which Methd Authenticatin Cde (MAC) t use Which kind f encryptin (cipher) t use Once the encryptin methd is chsen, the fllwing ccurs: 1. The server sends a public key t CuteFTP. 2. CuteFTP generates a sessin key, and encrypts it with the server's public key. 3. CuteFTP then sends the encrypted sessin key back t server. 4. The server then decrypts the sessin key with its private key and, frm that time n, all transmitted data is encrypted with the sessin key. Authenticatin Layer After the Transprt Layer is established, the server attempts t authenticate the client. Cmmn methds fr establishing user authenticatin include: Public Key Authenticatin Methd: public key T use this methd, yu will need yur private key and yur public key, which is passed t the server. The server encrypts a randm number with yur public key and sends it t yu. 1. If yu have nt already entered yur passphrase in SSH2 security settings, CuteFTP asks yu fr yur passphrase t activate the private key. 2. The private key decrypts the number and sends it back t the server. 3. The server recgnizes the number as crrect and allws the cnnectin. Passwrd Authenticatin Methd: passwrd Using this methd, the client sends its passwrd t server. The client des nt need t encrypt the passwrd explicitly, because the SSH2 Transprt layer autmatically encrypts it. This is the default in CuteFTP. With this type f authenticatin, the cnnectin fails if the Transprt Layer cannt encrypt the data. After the encryptin methd is established and authenticatin is cmplete, the tw systems are ready t exchange secure data. CuteFTP sends a secured FTP cnnectin alng the encrypted data tunnel, the remte system and respnds and yu can begin transferring files securely. 107

108 CuteFTP v9 User Guide Transprt Layer Settings T select Message Authenticatin Cdes (MAC) Message Authenticatin Cdes are algrithms used t cnfirm data has nt been altered between the client and server. 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. In the MAC list, specify at least ne Message Authenticatin Cde. 4. Click OK. CuteFTP tries each selected MAC with the server starting with the tp methd in the MAC list. T select encryptin methds (ciphers) 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. In the Cipher list, specify at least ne encryptin methd. 4. Click OK. CuteFTP tries each selected encryptin methd with the server starting with the tp methd in the Cipher list. Authenticatin Layer Settings T use public key authenticatin If yu want t use public key authenticatin, yu will need t send yur public key t the server administratr befre yu will be able t make an SSH2 cnnectin. 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Select the Use public key authenticatin check bx. Yu are using public key authenticatin whenever the check bx is selected, even if the bx and check are dimmed. 4. Click OK. T use passwrd authenticatin 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Select the Use passwrd authenticatin check bx. Yu are using passwrd authenticatin whenever the check bx is selected, even if the bx and check are dimmed. If yu have upgraded t CuteFTP v9 and are using key pairs created with CuteFTP v8, if the passwrd fr an existing key cntains any Extended ASCII characters, the passwrd will nt wrk. Yu will have t reenter the passwrd after upgrading t v9. 4. Click OK. Yu have t use at least ne authenticatin methd fr an SSH2 cnnectin. Yu can use bth methds fr the same SSH2 cnnectin. 108

109 SSH2 Cnnectins (SFTP) Authenticating in SSH2 Yu can use Passwrd, Public Key, r bth authenticatin methds fr SSH2 cnnectins. Passwrd authenticatin is the default. T use passwrd authenticatin 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Make sure the Use passwrd authenticatin check bx is selected. Yu are using passwrd authenticatin whenever the check bx is selected, even if the bx and check are dimmed. If yu have upgraded t CuteFTP v9 and are using key pairs created with CuteFTP v8, if the passwrd fr an existing key cntains any Extended ASCII characters, the passwrd will nt wrk. Yu will have t reenter the passwrd after upgrading t v9. 4. Click OK. Passwrd authenticatin uses the FTP Site lgin passwrd fr authenticatin, nt the passphrase used t decrypt the identity file's private key shwn in the field beneath the Use passwrd authenticatin check bx. T use public key authenticatin 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Select the Use public key authenticatin check bx. Yu are using public key authenticatin whenever the check bx is selected, even if the bx and check are dimmed. 4. Click OK. T use public key authenticatin, yu will need t send yur public key t the server administratr befre making an SSH2 cnnectin. If the server is running OpenSSH, yu will need t cnvert the public key as described belw. 5. Create an identity file in the client. 6. Send the public key (Identity.pub) t the server administratr (via FTP, , etc.) 7. The server administratr must cnvert the public key t OpenSSH, check it with wrdcunt, and add it t authrized_keys. Cmmand sequence: ssh-keygen -i -f Identity.pub > sshpub wc sshpub cat sshpub > ~\.ssh\authrized_keys Wrd cunt shuld return a "1" as the first number. OpenSSH asks fr the identity files passwrd the first time yu lg in. If CuteFTP fails t cnnect, cntact ur supprt team and prvide the kernel versin, OpenSSH build, and the CuteFTP build number. (T view the build number, n the main menu, click Help > Abut.) 109

110 CuteFTP v9 User Guide SSH2 Security Settings T edit the SSH2 security settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Security nde, then click SSH2 Security. The SSH2 Security ptins appear. 3. In the Cipher list, s elect the check bx fr every cipher (encryptin algrithm) yu want available fr SSH2 cnnectins. See Learning abut SSH2 fr an explanatin f the algrithms. Clear the check bx fr any cipher yu d nt want available fr SSH2 cnnectins. 4. In the MAC list, select the check bx fr every MAC (Message Authenticatin Cde) yu want available fr SSH2 cnnectins. See Learning abut SSH2 fr an explanatin f MACs. Clear the check bx fr any MAC yu d nt want available fr SSH2 cnnectins. 5. Pririty - Use the Pririty arrws t determine the level f precedence fr the selected schemes. Mve yur preferred cipher r MAC t the tp f the list by highlighting it and clicking the up arrw utside the list. Mve yur least preferred Cipher r MAC t the bttm f the list by highlighting it and clicking the dwn arrw utside the list. 6. Select the Use data cmpressin check bx t cmpress transfers if the server will allw it. Clear the check bx t refuse transfer cmpressin. 7. Select the Use passwrd authenticatin check bx t sign n t SSH2 servers with a passwrd (entered in yur Site Manager). Clear this check bx t use public/private key authenticatin nly. Yu can clear this bx nly if yu have already selected the Use public key authenticatin check bx. If yu have upgraded t CuteFTP v9 and are using key pairs created with CuteFTP v8, if the passwrd fr an existing key cntains any Extended ASCII characters, the passwrd will nt wrk. Yu will have t reenter the passwrd after upgrading t v9. 8. Select the Use public key authenticatin check bx t sign n t SSH2 servers with a certificate (identity file). Clear this check bx t nly sign n t SSH2 servers with a passwrd. In the Public Key Path bx, brwse r type the lcatin f the Public Key file n yur lcal cmputer. In the Private Key Path bx, brwse r type the lcatin f the Private Key file n yur lcal cmputer. In the Use Passphrase bx, type the apprpriate passphrase fr decrypting the key listed in Private Key Path. In the Cnfirm Passphrase bx, type the same passphrase again fr the key listed in Private Key Path. The private key passwrd is stred in the registry using strng encryptin. Fr added security, leave the passphrase fields blank. CuteFTP prmpts yu fr the private key passwrd when necessary. Click Create identity file t create a new Public/Private key pair. Fr instructins n key pair creatin see Creating SSH2 key pairs. Click Trusted identity list t pen the Certificate Manager t see a list f public keys that yu have accepted as valid. In the Certificate manager: Select Imprt t add a public key t the trusted list. Select Exprt t send a highlighted public key t a lcatin r prgram. Select Remve t delete a highlighted public key frm the trusted list. 110

111 SSH2 Cnnectins (SFTP) SSH2 cnnectins require at least ne authenticatin methd, but may require mre than ne. Check with yur server administratr when in dubt. T use public key authenticatin, yu must send yur public key t the server administratr befre making an SSH2 cnnectin. 9. Select the Enable SSH peratin lgging with verbsity level check bx, then specify ne f the fllwing levels: 0, 1, 2) Sftware malfunctins (0-2 shuld als be lgged using lg event) 3) External nn-fatal high level errrs (incrrect frmat received frm an utside surce; failed negtiatin) 4) Psitive high level inf (succeeded negtiatin) 5) Start f a high r middle level peratin (start f a negtiatin; pening f a device) 6) Uncmmn situatins which might be caused by a bug 7) Nice-t-knw inf (entering r exiting a functin; result f a lw level peratin, 8) Data blck dumps (hash, keys, certificates, ther nn-massive data blcks) 9) Prtcl packet dumps (TCP, UDP, ESP, AH) 10. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Creating SSH2 Key Pairs T create yur wn Private and Public key fr SSH2 cnnectins 1. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 2. Expand the Security nde, then click SSH2 security. 3. Click Create identity file. The Create public/private key pair wizard appears. 4. In the Key type bx, click RSA r DSA. CuteFTP nly supprts tw algrithms fr SSH2 keys: ssh-dss (DSA) and ssh-rsa (RSA). A DSA key is required fr SSH2, an RSA key is recmmended. 111

112 CuteFTP v9 User Guide 5. Click Next. The passwrd page appears. 6. In the Passphrase and Cnfirm Passphrase bxes, type any cmbinatin f characters and spaces, then click Next. The utput lcatins page appears. 7. In the Private key filename bx, type r click the flder icn t specify the lcatin at which t stre the private key, then type a name fr the key at the end f the path. 8. In the Public key filename bx, type r click the flder icn t specify the lcatin at which t stre the public key. Make sure the filename extensin is.pub and the file name matches. 9. In the Key length bx, specify a key length between 1024 and 4096 bits. Shrter keys are faster but less secure; lnger keys are mre secure but slw cnnectins. 10. Click Finish. CuteFTP generates the keys. Lnger keys take mre time t generate. 11. A cnfirmatin message appears with the path and name f the keys. If yu want CuteFTP t use the keys just generated, select Yes. 112

113 SSH2 Cnnectins (SFTP) 12. Click OK t clse the Glbal Optins dialg bx. Fr added security, befre clsing the Glbal Optins dialg bx, clear the Passphrase and Cnfirm passphrase fields in the SSH2 Security page. CuteFTP then prmpts fr the identity file's secret key passphrase when required fr cnnectin t a SFTP Site. Using SSH2 Key Pairs Yu can authenticate SSH2 cnnectins with a certificate (public key). T use "public key authenticatin," yu must send yur public key t the server administratr befre making an SSH2 cnnectin. If the server is running OpenSSH, yu must cnvert the public key as described belw. If yu have upgraded t CuteFTP v9 and are using key pairs created with CuteFTP v8, if the passwrd fr an existing key cntains any Extended ASCII characters, the passwrd will nt wrk. Yu will have t reenter the passwrd in Tls > Glbal Optins > Security > SSH2 Security. T use public key authenticatin in SSH2 1. Create an SSH2 key pair. 2. Send the Public key t the SSH2 server administratr. 3. On the main menu, click Tls > Glbal Optins, r press ALT+F7. 4. Expand the Security nde, then click SSH2 security. 5. Select the Use public key authenticatin check bx. 6. In the Public key path and Private key path bxes, specify the path t yur public and private keys 7. In the Use Passphrase and Cnfirm passphrase bxes, type the passphrase fr the key. 8. Click OK. The private key and passphrase are never transmitted ver a cnnectin. When the server attempts t authenticate: 1. The server encrypts a randm number with yur public key and sends it t yu. 2. If yu have nt entered yur passphrase in SSH2 security settings, CuteFTP asks yu fr yur passphrase t activate the private key. 3. The private key decrypts the number and sends it back t the server. 4. The server recgnizes the number as crrect and allws the cnnectin. T cnvert the public key 1. Create an identity file in the client. 2. Send the public key (Identity.pub) t the server administratr (via FTP, , etc.) 3. The server administratr must cnvert the public key t OpenSSH, check it with wrdcunt, and add it t authrized_keys. Cmmand sequence: ssh-keygen -i -f Identity.pub > sshpub wc sshpub cat sshpub > ~\.ssh\authrized_keys Wrd cunt shuld return a "1" as the first number. OpenSSH asks fr the identity files passwrd the first time yu lg in. If CuteFTP fails t cnnect, cntact ur supprt team and prvide the kernel versin, OpenSSH build, and the CuteFTP build number (lcated under Help > Abut). 113

114 CuteFTP v9 User Guide Trubleshting SFTP Cnnectins Yu cannt cnnect with SFTP simply by cnfiguring the prxy settings in Glbal Optins. CuteFTP des nt supprt using SFTP thrugh a prxy server that is nt a SOCKS prxy server. Nn-SOCKS servers are "prtcl dependent," meaning that if it is an FTP server, yu must use FTP and if it's an HTTP server, yu must use HTTP. SOCKS prxy servers are nt prtcl dependent. A SOCKS prxy server wrks fr any TCP/IP scket cnnectin, s the prtcl shuld nt matter. If yu are having difficulty cnnecting t yur SFTP server, d the fllwing: 1. Verify that the server yu are cnnecting t supprts SFTP cnnectins. CuteFTP supprts SFTP, a secure service prvided by the SSH2 hst in which the server bth encrypts the data and handles the file transfer. This shuld nt be cnfused with FTP ver SSH2, in which SSH2 uses prt frwarding capabilities t frward standard FTP transactins thrugh an encrypted tunnel but the actual file is transferred by a separate, nn-secure FTP server. If yu are unsure if the hst is supprting SFTP, check the cnnectin prt. SFTP usually ccurs ver prt Try tggling the cmpressin ptins in the SSH2 Security page. 3. Verify the authenticatin mechanism supprted and required by the server. It may require passwrd, public key (identity file), r bth (see nte belw). 4. If public key authenticatin is required, be sure t prvide a cpy f the public key yu created t the server's administratr, as it must be in the server's trusted list in rder fr yu t cnnect. 5. If the server administratr created a public key fr yu, be sure t replace yur existing ne with it and select the prvided key frm within the SSH2 Security page. 6. Cpy the cnnectin lg t a text file r t assist in trubleshting when cntacting yur FTP r Web service prvider r the Glbalscape supprt team. T use public key authenticatin, yu must send yur public key t the server administratr befre making an SSH2 cnnectin. If the server is running OpenSSH, cnvert the public key. Cannt Cnnect t SSH2 (SFTP) Sites CuteFTP supprts SFTP, which is a secure service prvided by the SSH2 hst, in which the server bth encrypts the data and handles the file transfer. This shuld nt be cnfused with FTP ver SSH2, in which the SSH2 uses prt frwarding t frward standard FTP transactins ver an encrypted tunnel, with the actual file transfer being handled by a separate (and nn-secure) FTP server. SSH2 cnnectins will fail if the client r server is nt prperly cnfigured. If yu are having difficulty cnnecting t yur SFTP server, try the fllwing: SSH2 Cnnectin Checklist 1. Verify that the server yu are cnnecting t supprts SFTP cnnectins. 2. Verify the cnnectin prt. SFTP usually ccurs ver prt Try tggling the cmpressin ptins in the SSH2 Security page. 4. Verify the authenticatin mechanism supprted and required by the server. It may require passwrd, public key (identity file), r bth (see nte belw). 5. If public key authenticatin is required, be sure t prvide a cpy f the public key yu created t the server's administratr, as it must be in the server's trusted list in rder fr yu t cnnect. 6. If the server administratr created a public key fr yu, be sure t replace yur existing ne with it and select the prvided key frm within the SSH2 Security page. 114

115 SSH2 Cnnectins (SFTP) 7. Cpy the cnnectin lg t a text file r message t assist in trubleshting when cntacting yur FTP r Web service prvider r the Glbalscape supprt team. Public key authenticatin T use public key authenticatin, yu must send yur public key t the server administratr befre making an SSH2 cnnectin. If the server is running OpenSSH, cnvert the public key as described belw. T cnvert the public key 1. Create an identity file in the client. 2. Send the public key (Identity.pub) t the server administratr (via FTP, , etc.) 3. The server administratr must cnvert the public key t OpenSSH, check it with wrdcunt, and add it t authrized_keys. Cmmand sequence: ssh-keygen -i -f Identity.pub > sshpub wc sshpub cat sshpub > ~\.ssh\authrized_keys Wrdcunt shuld return a "1" as the first number. OpenSSH is ging t ask fr the identity files passwrd the first time yu lg in. If CuteFTP fails t cnnect, cntact ur supprt team and prvide the kernel versin, OpenSSH build, and the CuteFTP build number. The CuteFTP build number appears in the Abut dialg bx. (On the main menu, click Help, then click Abut.) SFTP Errrs Refer t the Glbalscape Knwledgebase fr details f the fllwing SFTP errrs: "SFTP21 errr = #0 The file being transferred in ASCII mde appears t be a Binary file. Prceed anyway?": "SFTP21 errr = #0. 0 Can't cnnect t sftp.xxxxx.cm:22": "SFTP21 errr = #4 Algrithm negtiatin failed": "SFTP21 errr = #4 N further authenticatin methds available": "SFTP21 errr = #7 Cnnectin t the server was lst": Public Key Authenticatin Fails After yu set up an accunt fr public key authenticatin, yu still have t enter a passwrd the first time yu lg in. When yu set up public key authenticatin fr an accunt and set the authenticatin type t Pwd OR Key, WinSSHD still must cache the passwrd s that yu can lg in with just the public key. Therefre, n yur first lgin attempt after yu set up public key authenticatin, WinSSHD asks yu fr a passwrd t stre in the cache, even if yur client already authenticated successfully using a public key. When this happens, just supply a valid passwrd. When yu lg in after that, the passwrd will be cached and yu will nt have t prvide it again. 115

116 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 116

117 Chapter 8. Transferring Files and Flders The tpics belw prvide prcedures fr transferring files and flders between yur lcal hard drive and a remte server. (Fr the prcedures fr file and flder management, see Managing Files and Flders.) Transferring Files and Flders Besides just clicking and dragging the item that yu want t transfer frm ne pane t the ther, yu can als: Multi-select and drag items as grup. (SHIFT + click fr cntiguus items; CTRL + click fr nncntiguus items.) Drag items t the Queue t uplad them later. Select an item r grup f items in Windws Explrer, then right-click and click Uplad. T uplad files (transfer frm a lcal t remte cmputer) 1. Cnnect t a remte site. 2. In the Lcal pane, lcate the files r flders that yu want t uplad. 3. Click and hld the muse buttn while dragging the item(s) frm the Lcal pane t the Remte pane r Queue pane. 4. Release the muse buttn. The items are cpied (nt mved) t the remte server r t the Queue pane fr later uplading. T dwnlad files (transfer frm a remte t a lcal cmputer) 1. Cnnect t a remte site. 2. In the Remte pane, lcate the files r flders that yu want t dwnlad. 3. Click and hld the muse buttn while dragging the item(s) frm the Remte pane t the Lcal pane r Queue pane. 4. Release the muse buttn. The items are cpied (nt mved) t yur lcal lcatin r t the Queue pane fr later dwnlading. Transfer Settings Many f these cntrls are intended fr advanced users nly. Fr example: The REST/APPE sequence is nly intended fr prblem servers that d nt supprt the prper resume sequence. Transfer type shuld nly be changed when yu need t frce files t transfer a certain way. The data prt mde shuld nly be changed if yu are having prblems establishing a data cnnectin (n LIST r RETR fr example). Limiting the lcal prt range can have adverse affects when transferring many small files ver a narrw range f prts. T access transfer settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde. The Transfer ptins appear. 3. In the Transfer methd bx, specify ne f the fllwing methds: Chse Aut-detect t have CuteFTP decide the transfer methd based n the file and server type. 117

118 CuteFTP v9 User Guide Chse ASCII t transfer text files, web pages, r ther text type files. Chse Binary t transfer pictures, prgrams, r executable files. Binary files cannt be transferred in ASCII mde, but ASCII files can be transferred in Binary mde. 4. In the Data mde bx, specify ne f the fllwing mdes: Aut - CuteFTP makes cnnectins in PASV mde. If the PASV cnnectin fails, CuteFTP attempts t cnnect in PORT mde autmatically. PASV - Helps avid cnflicts with security systems. PASV supprt is necessary fr sme firewalls and ruters, because with PASV, the client pens the cnnectin t an IP Address and prt that the server supplies. PORT - Cnnectins r transfer attempts fail in PASV mde r when yu receive data scket errrs. When an FTP client cnnects using PORT, the server pens a cnnectin t an IP Address and prt that the client supplies. If yu cnnect in PORT mde, yur sessin becmes vulnerable t "Prt theft," which means that a third party can interfere with transfers. EPRT - An extensin f PORT cmmand designed fr cmmunicating the client s data cnnectin IPv6 address and prt, but used presently used in CuteFTP fr cmmunicating its IPv4 address and prt. It is useful fr negtiatin thrugh NAT firewalls. EPSV - An extensin f PASV cmmand designed fr requesting the server s data cnnectin prt; present CuteFTP assumes IPv4 netwrk prtcl and is useful fr negtiatin thrugh NAT firewalls. EPRT and EPSV were designed fr cmmunicating IP and data prt infrmatin fr IPv6 addresses. This feature is primarily used fr imprving firewall traversal f NAT firewalls fr secure (FTPS) cnnectins. Read RFC 2428 fr mre details. Nte that each site in the Site Manager is currently able t either inherit glbal settings fr Data Mde r define its wn. Therefre the EPRT and EPSV chices are als available at the Site level (Site Prperties > Type tab). 5. Select the Allw transfers t ccur ver the existing (brwse) sessin check bx t transfer files ver new and existing sessins. CuteFTP uses the brwse sessin and if available, additinal cnnectins. Fr example, If yu define a per site max limit f five cnnectins and then transfer five files, CuteFTP checks the brwse cnnectin first t see if it is busy, and if nt busy, transfers the 1st file ver the brwse cnnectin. The subsequent fur files are transferred ver fur additinal sessins. CuteFTP autmatically adjusts fr allwed cnnectins (bth frm the client and server perspective) and whether r nt it can use the brwse sessin. Clear the check bx t transfer files ver new sessins nly. Use this ptin if yur server allws multiple cnnectins, is quick t respnd, and yu want t navigate the site while dwnlading. All transfers are frced ver new cnnectins, freeing up the brwse sessin s yu can cntinue t navigate. The nly time this culd cause a prblem is when the server either refuses t allw multiple cnnectins r is slw t lg int. 118

119 Transferring Files and Flders If yu select the check bx, then press CTRL when transferring files, files transfer ver the existing sessin nly. T use this, select the files yu want t transfer, then press and hld the Ctrl key while yu drag and drp the files int the destinatin flder. This frces CuteFTP t transfer all the files n the existing sessin. Transferring files using nly the currently lgged in sessin can reduce verhead in certain situatins. Fr example, a transfer f a large number f small HTML files can ften be dne much faster if limited t the current cnnectin rather than perfrming a full TCP/IP cnnectin and FTP lgin (and pssibly FEAT/CWD/LIST) sequence first 6. In the Filename encding areas, click UTF-8, ASCII, r Aut-detect. 7. In the When selecting MAX in a multi-part transfer use bx, specify the number f parts t split a file int when a max multi-part transfer is requested. 8. In the Glbal bandwidth limit bx, specify the number f kilbytes per secnd t thrttle the bandwidth f all sessins n CuteFTP. If this is set t 0 (the default), there is n thrttling. 9. In the Recnnect and resume in bx, specify the time that CuteFTP waits t try again after an interrupted r failed dwnlad. Select a time between 0 and 1,000 secnds (abut 17 minutes). 10. In the Rll back (retry at byte ffset) bx, specify the number f bytes prir t the transfer failure CuteFTP resends when attempting t finish an interrupted transfer. Select between 0 and bytes. 11. Select the Send REST cmmand prir t APPE when resuming a transfer check bx t send the REST (Restart) cmmand t resume a transfer, befre sending the APPE (Append) cmmand. Clear this check bx t send the APPE (Append) cmmand t resume a transfer withut first sending the REST (Restart) cmmand. 12. In the Receive buffer and Send buffer bxes, specify the number f bytes fr the send and receive buffers. The default setting fr bth send and receive is bytes. It is unlikely yu will ever need t adjust these settings, but if yu have prblems with drpped transfers, yu can use them t fine tune transfers ver high latency r lssy cnnectins like thse ver satellite links r with legacy CDMA wireless cnnectins. Fr mre, refer t Imprving Slw Transfers. 13. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Startup and Exit Optins By default, the Transfer Engine (TE) starts when Windws starts up. Yu can change this setting in the Glbal Optins dialg bx. Yu can als cnfigure whether the Transfer Engine remains running r clses when Windws clses. T specify TE startup and exit ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde. The General ptins appear. 3. T start the Transfer Engine autmatically when yur cmputer bts up, select the Start the Transfer Engine n Windws startup check bx. When nt selected, the Transfer Engine des nt start until yu start CuteFTP r call it frm a script. 4. In the On exit bx, specify ne f the fllwing actins: Dn't clse the Transfer Engine if tasks are pending - Cmpletes unfinished r scheduled transfers after CuteFTP is clsed. The Transfer Engine autmatically shuts dwn after the last scheduled transfer. 119

120 CuteFTP v9 User Guide Dn't clse the Transfer Engine - Leaves the Transfer Engine running even when CuteFTP is clsed and there are n transfers t cmplete. The Transfer Engine stays pen until the cmputer is shut dwn r yu clse the Transfer Engine frm the System Tray. Clse the Transfer Engine - Shuts dwn the Transfer Engine whenever yu clse CuteFTP. 5. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Smart Overwrite Settings When yu try t transfer a file t a destinatin with a file f the same name, use Smart Overwrite t determine the prper actin t take. Smart verwrite settings apply t bth uplads and dwnlads. Sme servers are case sensitive. Such servers will nt recgnize files names as identical if the letter case f the tw file names des nt match. T cnfigure the Smart Overwrite settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Smart Overwrite. The Smart Overwrite ptins appear. 3. In the Fr matching files bx, click ne f the fllwing actins: Prmpt - CuteFTP displays a windw asking yu t verwrite r skip the file in the destinatin flder that has the same name as the file yu are transferring. Overwrite - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP replaces the destinatin file with the transferred file. Skip - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP des nt transfer the file and leave the destinatin file as it is. Rename - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP asks yu fr a new file name fr the transferred file. Resume - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP treats the destinatin file as an incmplete transfer. If the destinatin file is already a cmplete file, the transferred file replaces the destinatin file. Numerate - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP renames the transferred file t 'Cpy f file.txt'. If the same transfer ccurs again, CuteFTP renames the transferred file t 'Cpy (2) f file.txt' Use Rules - If a file in the destinatin flder has the same name as the file yu are transferring, CuteFTP uses the rules yu define in the Overwrite Rules dialg bx (see belw). 4. The Ignre Zer Byte File check bx applies nly when attempting t transfer a file > 0 bytes t a destinatin where the same filename exists AND the destinatin filesize equals 0. If the destinatin file = 0 bytes and the surce file als = 0 bytes, then the file transfer will be skipped and Smart Overwrite rules and the Ignre zer byte file check bx will be ignred. N Smart Overwrite rules are applied because it desn't make sense t transfer a 0 byte file that will replace anther 0 byte file. D ne f the fllwing: Select the Ignre Zer byte files check bx - CuteFTP will verwrite the destinatin file. Clear the Ignre Zer byte files check bx - CuteFTP will invke the cnfigured Smart Overwrite file/flder settings. 120

121 Transferring Files and Flders 5. In the Fr matching flders bx, click ne f the fllwing actins: Prmpt - CuteFTP displays a windw asking what yu want t d t a flder in the destinatin flder that has the same name as the flder yu are transferring. Replace All - If a flder in the destinatin flder has the same name as the flder yu are transferring, CuteFTP replaces every destinatin file with matching names with files in the transferred flder. Use Rules - If a flder in the destinatin flder has the same name as the flder yu are transferring, CuteFTP uses the rules yu define in the Overwrite Rules dialg bx t determine hw t handle all files with matching names. 6. Click Cnfigure Rules t pen the Overwrite Rules dialg bx t define the rules yu want CuteFTP t use when tw files have the same name. Yu must select Use rules in the Fr matching flders bx t enable these ptins. 7. In the If destinatin file date is bx, click ne f the fllwing ptins: newer replaces a file if it has a time stamp mre recent than the file yu are transferring. n matter replaces any file regardless f when it was created in relatin t the file yu are transferring. Select this ptin if yu d nt want t replace files based n when they were created. lder replaces a file nly if it has a time stamp further in the past than the file yu are transferring. the same replaces a file if it has the same time stamp as the file yu are transferring. different replace a file if it has a time stamp that is lder r newer than the file yu are transferring. 8. In the and size is bx, click ne f the fllwing ptins: larger replaces a file if it is larger than the file yu are transferring. n matter replaces a file regardless f its size. Select this ptin if yu d nt want t replace files based n their size in relatin t the file yu are transferring. smaller replaces a file if it is smaller than the file yu are transferring. the same replaces a file if it is same size as the file yu are transferring. different replaces a file if it is larger r smaller than the file yu are transferring. 121

122 CuteFTP v9 User Guide 9. In the during bx, click ne f the fllwing ptins: any transfer replaces files whether yu are uplading r dwnlading. dwnlad replace nly the files n the lcal cmputer with files transferred frm a remte Site. Site t Site transfer replaces files when with the same name when transferring frm ne remte Site t anther. uplad replace nly the files n the remte Site with files transferred frm the lcal cmputer. 10. In the then bx, click ne f the fllwing ptins: verwrite cmpletes the transfer by replacing the file that is in the destinatin flder. numerate cmpletes the transfer by renaming the transferred file with "Cpy (n ) f..." added befre the name. resume treats the transfer as an attempt t cntinue an interrupted transfer. shw prmpt pauses the transfer and display the message that asks the user which actin t take. skip cancels the transfer and leave the riginal file in the destinatin flder. 11. Click Add t places the rule int the list. If yu are using rules, CuteFTP checks every rule in the list during all transfers. 12. Click Remve t delete a rule yu have highlighted in the list and CuteFTP will n lnger use the rule when it encunters tw files f the same name. 13. Click Defaults t delete every rule frm the list. Fr mre infrmatin, see Smart Overwrite Example. 14. The Prmpt timeut actin bx, defines the actin CuteFTP takes if n rules apply, r if yu enable a timeut value. When yu select the Timeut in n secnds check bx, a prmpt appears, but after waiting the defined amunt f time, CuteFTP takes ne f the fllwing actins if a file in the destinatin flder has the same name as the file yu are transferring: Overwrite - Replaces the destinatin file with the transferred file Skip - Des nt transfer the file and leaves the destinatin file as it is Rename - Asks yu fr a new file name fr the transferred file Resume - Treats the destinatin file as an incmplete transfer. If the destinatin file is already a cmplete file, the transferred file replaces the destinatin file Numerate - Renames the transferred file t Cpy f file.txt. If the same transfer ccurs again, CuteFTP renames the transferred file t Cpy (2) f file.txt. 15. Select the Resend LIST cmmand as necessary check bx t use the LIST cmmand t retrieve file details and determine similarities and differences between a transferring file and destinatin file with the same name. Clear this check bx and CuteFTP des NOT use the LIST cmmand. 16. Select the Use SIZE and MDTM cmmands t gather precise details check bx t use the SIZE cmmand t retrieve file size and the MDTM cmmand t retrieve file mdificatin time t determine similarities and differences between a transferring file and destinatin file with the same name. If yu clear this check bx, CuteFTP will NOT use the SIZE and MDTM cmmand. 122

123 Transferring Files and Flders 17. Select the Cmpare using XCRC and verwrite, skip, r resume accrdingly check bx t use file integrity checking (cyclical redundancy checksums) t determine verwrite, skip r resume status based n similarities and differences between a surce and destinatin file with the same name. This feature nly wrks with Glbalscape Secure Server and EFT Server. Cmpare using XCRC takes precedence ver standard verwrite actin settings. 18. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Default Dwnlad Flder In the Glbal Optins dialg bx, yu can specify which flder n yur hard drive is the default flder fr dwnlads frm yur remte site. Yu can specify that whichever flder is displayed in the lcal pane is the dwnlad lcatin, r specify anther flder. T specify a default dwnlad flder 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde. The General ptins appear. 3. In he Dwnlad flder defaults area, d ne f the fllwing: T dwnlad remte items that were dragged t the queue t the flder displayed in the Lcal Drives pane, select the Use the current flder in the lcal pane as the default check bx. T prvide a path t a specific flder, clear the Use the current flder in the lcal pane as the default check bx, then in the Use bx, brwse fr r type the path t a dwnlad lcatin fr remte items that yu place in the queue. All remte items dragged t the queue are dwnladed t the specified flder. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Rename Rules Yu can cnfigure CuteFTP t change the name f files autmatically as they transfer. T cnfigure the Rename Rules 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Rename Rules. The Rename Rules ptins appear. 3. Cnfigure ptins as described belw. Select the Apply aut-rename rules t transfers check bx t change the names f transferred files with names that appear in the Rename Rules list. Clear this check bx and CuteFTP will nt rename any files. T create an aut-rename rule, type the riginal file name in the text bx n the upper left, type the desired new file name in the text bx n the upper right, then click Add. T remve an aut-rename rule, in the Rename Rules list, click the rule yu want t delete, then click Remve. The rules are case sensitive. These rules will apply t all uplads, dwnlads, and Site-t-Site transfers. 123

124 CuteFTP v9 User Guide Yu can create rules with wildcard masks t change just the extensin f several files f the same type. Fr example, if yur.jpg files need the extensin in upper case (.JPG) n the server, create the rule: Rename frm *.jpg Rename t *.JPG Yu can create a rule t strip extensins frm file names. Fr instance if yu want t transfer a file called "index.htm" as simply "index" add this rule t yur list: Rename frm index.htm Rename t index.* 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Symblic Links In CuteFTP's Glbal Optins dialg bx, "link" refers t Unix symbl links, nt Windws shrtcuts. Symblic links are similar t shrtcuts, in that they pint t items in ther lcatins n a server. Yu can determine hw CuteFTP handles symblic links. T cnfigure the Link ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Navigatin nde, then click Links. The Links ptins appear. 3. Cnfigure ptins as described belw. Select the Attempt link reslutin using LIST-L cmmand check bx t send the LIST-L cmmand instead f LIST t display flder cntents. LIST-L attempts t list the actual file r flder rather than the link that pints t the file r flder. Clear this check bx t send just the LIST cmmand t display flder cntents and leave links in the list. Servers are nt always able t reslve links using LIST-L. Select ne f the fllwing ptins: Try t determine the link's target type by its extensin - CuteFTP tries t tell if the link pints t a file r a flder. CuteFTP treats the link as if it were the item it references. Always assume the link is a file (dn't attempt t reslve) - treats symblic links as files. CuteFTP remves the empty dwnladed file frm the lcal flder if the RETR cmmand returns errr. This ptin is useful when yu dwnlad large directries r flders with many files and subflders. Always assume the link is a flder (dn't attempt t reslve) - treats symblic links as flders that yu can duble-click t see flder cntents. CuteFTP attempts t shw the actual path f a file r flder link in the Remte pane, in the Name clumn. Fr example, a link t a file called archive.zip might display as.3/netwrks/bbs_inf/archive.zip. 124

125 Transferring Files and Flders 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Queuing Files and Flders fr Transfer CuteFTP allws yu t drag items t the queue t dwnlad them later. Frm within the Queue Windw, yu can als stp, resume, r restart a transfer. Fr a descriptin f the icns that appear in the Queue Windw, see Transfer Queue Icns. T display r hide the queue 1. On the main menu, click View > Shw Panes. 2. Click Queue & Lg Pane r click ALT+1 t display r hide it. T add items t the queue 1. Cnnect t a Site. (Yu cannt drag items t the queue unless yu are cnnected t a Site.) 2. Lcate the files r flders yu want t uplad r dwnlad in yur lcal r remte pane. 3. Drag the selected items t the transfer queue windw. 4. Repeat as necessary. Yu can als cnnect t ther Sites and add files and flders t the queue. 5. Once yu have finished adding items t the transfer queue, yu can change queue item attributes if desired, such as destinatin path, transfer type, scheduling, and s n by clicking the item, then pressing ALT+ENTER. 6. T change the transfer pririty f an item, click it, then drag it up r dwn in the queue. A blue line appears t indicate where the item will be placed. 7. When yu are ready t begin prcessing the queue, d ne f the fllwing: On the main menu, click Tls > Queue > Transfer All. Click t select ne r mre items in the queue, then click Tls > Queue > Transfer Selected. Right-click in the queue, then click Transfer All. Click t select ne r mre items in the queue, then right-click the selectin and click Transfer Selected. Remving Items frm the Queue Yu can remve items frm the Queue Windw that are ready fr transfer, that have cmpleted transfer, r that have failed transfer. As ld items build up in the queue, it can cnsume large amunts f memry. Yu can either remve them manually r cnfigure CuteFTP t remve successfully transferred items autmatically. T remve selected items frm the queue 1. Click t select ne r mre items in the queue, then d ne f the fllwing: On the main menu, click Tls > Queue > Remve Selected. Right-click the selectin and click Remve Selected. Press DELETE. A cnfirmatin message appears. 2. Click Yes. 125

126 CuteFTP v9 User Guide T remve cmpleted transactins frm the queue 1. D ne f the fllwing: On the main menu, click Tls > Queue > Remve Finished. Right-click in the Queue Windw, then click Remve Finished. A cnfirmatin message appears. 2. Click Yes. T clear everything frm the queue If yu remve everything frm the Queue Windw, yu will als remve yur Flder Mnitr Rules! 1. D ne f the fllwing: On the main menu, click Tls > Queue > Remve All. Right-click in the Queue Windw, then click Remve All. A cnfirmatin message appears. 2. Click Yes. T remve successful transfers frm the queue autmatically 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. Select the Remve successful transfer items frm the queue autmatically check bx t erase items frm the queue after they have transferred. Clear the check bx t keep items in the queue even after they have transferred. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Uplading Files frm Anywhere in Windws Yu can uplad files frm anywhere in Windws by selecting CuteFTP's Uplad ptins frm Windw's cntext menu (usually a right-click). Yu must first add CuteFTP t the Windws Explrer right-click menu by selecting the Shell integratin check bx in Glbal Optins. T uplad files in Windws 1. In Windws, right-click the file yu want t uplad t a server, click Uplad using CuteFTP, then click Cnnectin wizard. The CuteFTP Cnnectin Wizard appears. 2. File the instructins in Cnnecting t Sites Using the Cnnectin Wizard t define the Site cnnectin ptins, then click Finish. Cute FTP cnnects t the Site, uplads the file, then saves the site in the Site Manager fr future cnnectins. 126

127 Transferring Files and Flders Transferring Files in Order Yu can see the rder in which queued items transfer at the left end f the Queue Windw. The numbers in the clumn indicate the rder f transfer. By default, files transfer in the same rder that they are added t the queue. T transfer items in the rder added 1. Srt the Lcal r Remte pane by clicking n the crrespnding clumn header (Name, Time, Size, etc.) 2. In the Lcal r Remte pane, click the item(s) t transfer, then drag the selected items int the queue. Nte that the items are rdered in the same way they were srted prir t adding them t the queue. 3. Right-click in the Queue Windw, then click Transfer All. CuteFTP transfers the files in the rder reflected by the numbers in the left clumn f the queue. T set a specific transfer rder 1. Mve transfer items t the Queue Windw as described abve. 2. Click the pund sign (#) clumn header t srt the items by their transfer rder. 3. Click an item in the Queue. 4. On the main menu, click Tls > Queue > Change Order. T transfer the selected item first, click Mve t Tp (r press CTRL+SHIFT+T). T transfer the selected item last, click Mve t Bttm (r press CTRL+SHIFT+B). T transfer the selected item befre the previus item in the queue, click Mve Up One (r press CTRL+SHIFT+U). T transfer the selected item after the fllwing item in the queue, click Mve Dwn One (r press CTRL+SHIFT+D). Yu can als change an item's place in the transfer rder by clicking and dragging the item up r dwn in the queue. A blue line indicates where the item's new psitin in the queue will be after yu release the muse. Navigatin Optins T cnfigure the navigatin ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Navigatin nde. The Navigatin ptins appear. 3. Cnfigure ptins as described belw. In the When adding items t the queue bx, click ne f the fllwing actins: Transfer immediately t start transfer f the queued item as sn as it is drpped in the queue. 127

128 CuteFTP v9 User Guide Suspend t place the item in the queue, but t hld the transfer. Schedule t display the scheduling windw when an item is placed in the queue. In the When dragging an item t the lcal pane bx, click ne f the fllwing actins: Transfer t current flder t send the dragged item t the flder currently listed in the Lcal Drives pane Transfer t default flder t send the dragged item t the default transfer flder listed in General Settings Add t queue & suspend t place the dragged item in the queue, but hld the transfer. In the When duble-clicking an item bx, click ne f the fllwing actins: Transfer immediately t send the item t the displayed remte Site r the default dwnlad flder Add t queue & suspend t place the duble-clicked item in the queue, but hld the transfer Launch in viewer t pen the item in the File Viewer prgram chsen in Helper Applicatins Execute Open t run the item if it is a prgram Edit t pen the item in the File Editr prgram chsen in Helper Applicatins Select the Aut-refresh the remte pane after an uplad check bx t update the remte flder's listing after every uplad t that flder. Clear this check bx t stp sending LIST requests t a remte Site after every uplad. Select the Use the lgical parent (nt physical parent) n CDUP cmmand check bx t return t the flder yu just linked frm when clicking the Mve up directry icn. Clear this check bx t change t the actual flder the item resides in, and nt a flder with a link t the item, when clicking the Mve up directry icn. Select the Link the remte and its assciated lcal pane when wrking with multiple Sites t ties the lcal and remte panes t each ther. If yu have mre than ne remte pane pen and yu switch between the remte panes, the last path in the lcal pane used fr that remte pane is recalled. Clear this check bx t retain the same path in the lcal pane regardless f the remte pane selected. Select the Switch frm the Site Manager t the Lcal Drives Pane upn cnnectin check bx t display the Lcal Drives pane autmatically when a cnnectin is made. Clear this check bx t leave the Site Manager displayed when a cnnectin is made. Select the Switch frm the Lcal Pane t the Site Manager upn clsing all cnnectins check bx t display the Site Manager autmatically when all cnnectins are clsed. Clear this check bx t leave the Site Manager hidden when all cnnectins are clsed. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Tlerance Settings Sme servers treat PASV mde and links differently than thers. Cnfigure frm the tlerance ptins t help CuteFTP cnnect t these servers. 128

129 Transferring Files and Flders T cnfigure the Tlerance settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Navigatin nde, then click Tlerance. The Tlerance ptins appear. 3. Cnfigure ptins as described belw. When using PASV mde, select the Use crrect timing f PASV mde cmmand check bx. This ptin wrks with mst FTP servers. If yu are having difficulty cnnecting in PASV mde, clear this check bx. T use the Print Wrking Directry (PWD) cmmand t determine which remte flder is currently pen n the server, select the Use PWD t determine current flder check bx. Clear this check bx and CuteFTP attempts t determine the current remte flder based upn the relative lcatin frm the rt lgin flder. If yur server des nt supprt PWD, clear this check bx. T send the abslute path t the file t cmplete delete, dwnlad, r uplad file peratins, select the Use abslute paths fr DELE, RETR, and STOR cmmands check bx (e.g., "RETR /pub/cuteftp/cuteftp.exe"). If yur server des nt supprt abslute path names fr these cmmands, clear this check bx, and CuteFTP will send the relative path t the file instead (e.g., "RETR cuteftp.exe"). T use the cmplete abslute path t retrieve the listings fr a flder, select the Use abslute paths fr the LIST cmmand check bx. Fr example: "LIST /pub/cuteftp". If yur server des nt supprt abslute path names fr the LIST cmmand, clear this check bx, and CuteFTP will use the relative file path t retrieve the listings fr a flder (e.g., "LIST"). T retrieve a list f just file names fr each flder, select the Use NLST instead f LIST (retrieves an abbreviated listing) check bx. The list des nt include time stamps, file size, r ther details. Clear this check bx t use the LIST cmmand and retrieve a list with details fr each file and flder. (Applies t FTP prtcls nly.) T cntinue lgin attempts if the server returns permanent errrs (5xx) inapprpriately, such as when the server is full r busy, select the Treat 5xx errrs as 4xx errrs during lgin check bx. T accept permanent errrs, stp further cnnectin attempts, and avid being banned fr hammering, clear this check bx. Selecting this ptin may result in being banned frm a server. CuteFTP will repeatedly try t cnnect t the server (accrding t retry and retry delay settings). If the retry delay perid is set t lw, these repeated attempts may end up being cnsidered "hammering," and the server administratr r service may ban yur accunts. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Stpping Transfers Yu can stp in-prgress transfers, remve items frm the Queue Windw, and reset failed transfers. T resume r restart a transfer, refer t Resuming Transfers. T stp a transfer 1. Click the item(s) in the Queue Windw t be stpped. 2. On the main menu, click View > Stp (r press ESC). T remve items queued fr transfer 1. Click an item in the Queue Windw. 129

130 CuteFTP v9 User Guide 2. D ne f the fllwing: On the main menu, click Tls > Queue > Remve Selected. Select ne r mre items in the queue, then right-click the selectin and click Remve Selected. Press DELETE. 3. A cnfirmatin message appears. Click Yes. Remve All deletes every file frm the queue. Remve Finished deletes all f the items frm the Queue Windw that have cmpleted their transfer. The shrtcut keys ESC r F9 stp active transfers. Press ESC nce t stp the last cmmand (be it a transfer r cnnectin request). Press ESC repeatedly t cycle thrugh active transfers and/r cnnectins and stp them ne by ne. Yu can als select multiple items in the queue and press ESC t stp them. Press DELETE t stp and remve selected queue items. TOC File Settings Yu may cnnect with remte flders that have Table f Cntents (TOC) files. TOC files cntain detailed infrmatin abut the flder. In lng and cmplicated directries, the TOC files can be quite large. If yu dwnlad very large TOC files, they may interfere with CuteFTP's perfrmance r peratin. T cnfigure the TOC File settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Navigatin nde, then click TOC Files. The TOC Files ptins appear. 3. Cnfigure ptins as described belw. Select the Lad TOC Files check bx t dwnlad TOC files autmatically whenever cnnecting t a remte flder. If yu clear this check bx, TOC files are nt dwnladed. In the If the TOC file size exceeds n Kbytes, then prmpt befre lading bx, specify the maximum size (between 1 and 1,000 kilbytes) TOC file CuteFTP dwnlads withut prmpting fr permissin. In the TOC include masks bx, type file names r extensins that CuteFTP shuld cnsider as TOC files, then click Add. Yu can use wildcard masks. T remve a mask, click it in the list, then click Remve. In the TOC exclude masks bx, type file names r extensins that CuteFTP shuld NOT cnsider as TOC files, then click Add. Yu can use wildcard masks. T remve a mask, click it in the list, then click Remve. The TOC include masks and the TOC exclude masks act as a duble filter t help CuteFTP determine whether a file is a TOC file. Fr example, if yu type Index* in the TOC include masks and *.html in the TOC exclude masks, a file named Index.txt wuld be cnsidered a TOC file, but a file named Index.html wuld nt. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 130

131 Transferring Files and Flders Cnfiguring Optins fr Cmpleted Transfers Yu can cnfigure CuteFTP t discnnect, shut dwn, and/r lg ff after transfers have cmpleted. T access transfer event settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. In the After all transfers have finished bx, specify ne f the fllwing actins: D Nthing - Keep the cnnectin and CuteFTP pen after all transfers are cmplete. Discnnect frm Site - Clse the cnnectin, but keep CuteFTP pen after all transfers are cmplete. Discnnect and clse prgram - Clse all cnnectins and clse CuteFTP after all transfers are cmplete. Discnnect frm Internet - Clse the dial-up cnnectin autmatically after all transfers are cmplete. Shut Dwn Cmputer - Clse all cnnectins, clse CuteFTP, clse the dial-up cnnectin, and shut dwn the cmputer after all transfers are cmplete. Lg Off - Lg the current user ff the cmputer autmatically after all transfers are cmplete. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Preserving the Lcal Time Stamp Yu can cnfigure CuteFTP t keep a dwnladed file's time stamp the same n the lcal cmputer as it is n the server and keep an upladed file's time stamp the same n the server as it is n the lcal cmputer. T specify time stamp settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. Select the Preserve remte time stamp fr dwnladed files check bx t keep a dwnladed file's time stamp the same n the lcal cmputer as it is n the server. Clear the check bx t allw the lcal cmputer t give dwnladed files a new time stamp. 4. Select the Preserve the lcal time stamp fr upladed files if the server allws MFMT check bx t keep an upladed file's time stamp the same n the server as it is n the lcal cmputer. Clear the check bx t allw the server t give upladed files a new time stamp. The FTP cmmand MODIFICATION TIME (MDTM) can be used t determine when a file n the server was last mdified. The Internet Engineering Task Frce (IETF) des nt endrse using MDTM t mdify a remte file's time stamp; hwever, quite a few servers supprt it. CuteFTP attempts the cmmand when requested and reprts errrs in the lg (if any). 5. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 131

132 CuteFTP v9 User Guide Resuming Transfers CuteFTP autmatically attempts t resume interrupted transfers caused by lssy cnnectin, serverkicked users, a slw server, and s n. CuteFTP des nt aut-resume interrupted transfers when the remte server is unreachable (i.e., there is n cnnectin available, the server is dwn, r fr any ther reasn). In thse situatins, yu must manually resume the transfer. In yu have nt shut dwn and restarted CuteFTP since the interruptin tk place, CuteFTP assumes that the transfer is within its riginal cntext and attempts t resume it frm the pint it left ff. If the transfer is n lnger in the riginal cntext, CuteFTP prmpts yu t verwrite the destinatin file; that is, t start ver. Yu can set up verwrite rules t tailr such situatins t yur specific needs. T resume a stpped transfer In the Queue Windw, click the stpped item, then d ne f the fllwing: T reset a failed transfer On the main menu, click Tls > Queue > Transfer Selected. Right-click the item, then click Transfer Selected. In the Queue Windw, click the stpped item, then d ne f the fllwing: On the main menu, click Tls > Queue > Reset Selected. Right-click the item, then click Reset Selected. T restart the transfer, click Tls > Queue > Transfer Selected. Right-click the item, then click Transfer Selected. Specifying Time CuteFTP Waits after a Transfer Cmpletes Yu can cnfigure CuteFTP t keep a thread pen fr a specific number f secnds after a transfer is cmplete. Leaving data cnnectins pen allws mre transfers t use the same cnnectin, aviding the need t pen new cnnectins. A "file transfer thread" is a cnnectin (sessin) t the server. After a file is successfully transferred, CuteFTP des nt clse the crrespnding cnnectin (sessin) t the server during the next 30 secnds in case there are mre pending file transfers in the queue. If transfers are waiting, CuteFTP will reuse this cnnectin fr them. If there are n transfers waiting, then the cnnectin (sessin) will be clsed in 30 secnds. The Lg Windw (View > Shw Panes > Queue & Lg Pane) displays a list f pen sessins t the Site. These sessins are the "file transfer threads" mentined in Glbal Optins > Transfer > Events. Fr 30 secnds after files are transferred, the Lg Windw will still shw the sessin in this windw. After 30 secnds, the sessin is clsed except fr ne brwse windw. Yu can change this timeut t secnds. 132

133 Transferring Files and Flders T specify the wait time after transfer cmpletes 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. In the Clse the file transfer thread n secnds after the transfer is finished bx, specify the time that CuteFTP will wait t clse the data cnnectin after a transfer is cmplete. Specify a time between 0 and 1,000 secnds. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Executing Cmmands n Dwnladed Files As ld items build up in the queue, it can cnsume large amunts f memry. Use the settings n the Tls > Glbal Optins > Transfer > Events nde t remve ld items frm the queue and t preserve the lcal and/r remte time stamp. 133

134 CuteFTP v9 User Guide T execute cmmands n dwnladed files 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. Select the Execute the fllwing cmmand n the dwnladed file check bx t execute the cmmand value n the specified executable file displayed in the edit bx belw the check bx. Brwse fr the file t define the path f an executable, batch file, and s n. Yu can enter yur wn cmmand line parameters by typing them in the edit bx; the system appends the full path f the dwnladed file t that string. Fr example, if the Execute the fllwing cmmand value is "c:\windws\system32\csript.exe" "c:\dcuments and settings\ghffer\mydcuments\check.vbs", then with this value turned n, if yu dwnlad a file "f.dat" t "d:\temp\", the cmmand is executed in the fllwing way: "c:\windws\system32\cscript.exe" "c:\dcuments and settings\ghffer\mydcuments\check.vbs" "d:\temp\f.dat" 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Viewing Transfer Status Lgs While items are transferring and after the transfer is cmplete, yu can view the details f the transfer in the Individual Sessin Lgs pane. The Individual Sessin Lgs pane appears under the Remte pane when yu are cnnected t a site. The Lg Windw tab (behind the Queue Windw tab) shws detailed sessin status. Ensure the lg settings in the Glbal Optins dialg bx are cnfigured t display the lgs. T view the lg pane On the main menu, click View > Shw Panes > Individual Sessin Lgs (r press ALT+2). T view the Lg Windw 1. On the main menu, click View > Shw Panes > Queue & Lg Pane (r press ALT+1). 2. In the bttm pane, click the Lg Windw tab. Using Quick Cnnect Use the Quick Cnnect tlbar t make cnnectins t servers that aren't defined in the Site Manager r that yu cnnect t frequently. Sites that yu cnnect t are added t the Hst list. Yu can keep the servers in the list r cnfigure CuteFTP's Glbal Optins t remve Quick Cnnect histry when yu clse CuteFTP. The Quick Cnnect tlbar has the fllwing fields and icns: Hst - The name r TCP/IP address f the FTP server. The Hst bx is a drp-dwn list; by clicking n the arrw t the right f the field, yu can access a list f the last several sites accessed during the current sessin via Quick Cnnect. User Name - Type yur user name r leave it blank fr annymus FTP. Passwrd - Type the assciated passwrd if nt cnnecting annymusly. Prt - If yu are nt cnnecting t the default FTP prt (21), type the apprpriate prt here. Cnnect - Activates the cnnectin t the site specified in the fields. Yu can als cnnect by pressing the Enter key while the cursr is in ne f the bxes. 134

135 Transferring Files and Flders Site Prperties - Allws yu t set cnnectin ptins fr the site. Add t Site Manager - Autmatically creates a Site Manager entry fr the site specified in the Quick Cnnect bar, s that yu can easily access it in the future. The Quick Cnnect bar can be mved r undcked by clicking and dragging n the vertical bar at the left-hand edge f the tlbar. T cnnect using the Quick Cnnect tlbar 1. If the Quick Cnnect Bar is nt displayed, click View > Tlbars > Quick Cnnect Bar, r press CTRL+F8. 2. In Hst bx, type r select frm the Hst drp-dwn list the Hst t which yu want t cnnect. The Hst drp-dwn list displays the list f sites t which yu have previusly cnnected. 3. In the Username bx, type the user name yu use t cnnect t this site. The user name yu used previusly will appear in the bx. 4. In the Passwrd bx, type the passwrd yu use t cnnect t this site. The passwrd yu used previusly will appear in the bx as dts. 5. In the Prt bx, type the prt number if different frm the default FTP prt (21). The prt yu cnnected thrugh previusly will appear in the bx. 6. Click the Cnnect icn. The files and flders in the remte server appear in the Remte (right) pane. If yu cnnect t mre than ne site, each site has its wn tab. Using the Clipbard t Transfer Yu can use the Windws clipbard t cpy and paste a URL directly int CuteFTP with the Cnnect t URL feature. This allws yu t cnnect t a Site, r if specified, dwnlad a file. 1. In a brwser r Windws applicatin, cpy the URL t the clipbard (i.e., press CTRL+C). The URL may be general (ftp:// r specific (ftp:// 2. In CuteFTP, n the main menu, click File > Cnnect > Cnnect t URL (r press CTRL+U). The Cnnect t URL dialg bx appears. 3. Paste the URL int the Cnnect t URL dialg bx (i.e., press CTRL+V). 4. Click OK. CuteFTP parses the URL and cnnects t the Site r, if specified, starts dwnlading the file. The URLs that yu paste int the Cnnect t URL dialg bx are saved fr future sessins. Then yu can just press CTRL+U, then click the dwn arrw t select the URL. The fllwing frmats are supprted: ftp://user:pass@hst.hst.cm:prt ftp://user:pass@hst.hst.cm ftp://user@hst.hst.cm ftp://hst.hst.cm:prt ftp://hst.hst.cm ftp://ftp.sitename.cm/pub l: user p: pass ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://ftp.sitename.cm/pub l/p: user/pass ftp://ftp.sitename.cm/pub:44 l/p: user/pass 135

136 CuteFTP v9 User Guide ftp://ftp.sitename.cm/pub p:44 l/p: user/pass ftp://ftp.sitename.cm/pub prt:44 l/p: user/pass ftp://ftp.sitename.cm/pub l: user p: pass ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub p:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://[any f the abve frmats]/pathnametfile/[ptinal filename] CuteFTP als accepts http, https, sftp, and ftps URLs. Pasting an URL Directly int the Transfer Engine The Paste URL feature is als accessible frm the Transfer Engine icn in the Windws system tray. 1. Right-click the TE icn, then click Dwnlad URL. The Dwnlad URL dialg bx appears. 2. Paste the URL int the Dwnlad URL dialg bx, then click OK. The TE attempts t dwnlad the URL regardless f whether the URL specifies a path t a flder r a file. Depending n the URL yu paste, CuteFTP tries t cnnect and navigate t the specified flder r attempts t dwnlad the item. In the table is a sample f path endings and hw CuteFTP handles them. Path endings Interpretatin Actin Attempted ftp://hst/dir.ext/ A flder Cnnectin hst/.ext/ A flder Cnnectin hst/dir/ A flder Cnnectin hst/dir A flder Cnnectin hst/dir.ext A file Dwnlad hst/.ext A file Dwnlad Scheduling Transfers CuteFTP allws yu t schedule transfers frm the Queue Windw. Additinally, yu can schedule uplading files frm yur lcal cmputer t a server and dwnlading files frm a server t yur lcal cmputer. T schedule transfers frm the Queue Windw 1. In the Queue Windw, click the file t be transferred, then d ne f the fllwing: On the main menu, click Tls > Queue > Schedule Selected. Right-click the item, then click Schedule Selected. The Scheduling Prperties dialg bx appears. 2. Select the Schedule the current item check bx. 3. In the Start n bxes, specify a date and time t transfer the item. 4. If yu want the transfer t repeat autmatically, select the Enable Recurrence check bx, then, in the Repeat every bxes, specify hw ften yu want the transfer t repeat. 5. Click OK. Yu can schedule multiple transfers. CuteFTP cntinues t run and cmplete any scheduled r pending transfers even if yu exit 136

137 Transferring Files and Flders the prgram befre a transfer is scheduled t start, unless the "Dn't clse the transfer engine if tasks are pending" is disabled in Tls > Glbal Optins > General. If yu clse the Transfer Engine r shut dwn the cmputer befre a scheduled transfer can start, CuteFTP prmpts if yu still want t cmplete the scheduled transfer the next time yu pen CuteFTP. If yu leave CuteFTP r the Transfer Engine pen t accmplish a number f tasks, it is a gd idea t cnfigure CuteFTP t delete successfully finished items frm the queue. Site-t-Site Transfers (FXP) Separate CONTROL and DATA cnnectins allws transmitting data nt nly between client and server, but als between tw FTP servers at nce and transfer data between them by issuing a PASV cmmand n ne server and then a matching PORT cmmand n the ther. Thus, ne server cnnects t the ther instead f t a client. This behavir is nt a hack; it is part f the fficial FTP specs. Tday, it is widely knwn as FXP. Because Site-t-Site transfers are cnsidered a security risk, many servers d nt supprt them. If yu are transferring between Sites with SSH2 r SSL cnnectins, transfers between them are nt secure unless bth servers supprt SSCN. T perfrm a Site-t-Site transfer 1. Cnnect t each Site (surce and destinatin). 2. On the main menu, click Windw > Tile. 3. Drag the file frm ne Remte Pane t anther. The Queue Windw displays a duble arrw (<- >), t indicate a Site-t-Site transfer. T display mre than ne remte Site at a time 1. Cnnect t tw r mre Sites. 2. On the main menu, click Windw > Cascade r Tile. 3. T return t the default, tabbed view, click Maximize in the upper right f any remte pane. Multi-Part (Accelerated) Transfers Yu can greatly speed up the transfer f large files using multi-part transfers. A multi-part transfer divides large files and sends the parts ver multiple FTP sessins. Yu can nly use multi-part uplads with servers that supprt the COMB cmmand, such as Glbalscape EFT Server. T perfrm a multi-part dwnlad 1. Cnnect t a remte Site. 2. In the Remte pane, click the file yu want t transfer. 3. In the Lcal Drives pane, pen the destinatin flder. 4. On the main menu, click File > Dwnlad Advanced > Multi-part Dwnlad, then click ne f the fllwing: HIGH, t split the file int tw parts MAX, t divide the file int mre parts 137

138 CuteFTP v9 User Guide T perfrm a multi-part uplad 1. Cnnect t a remte Site. 2. In the Lcal Drives pane, click the file yu want t transfer. 3. On the main menu, click File > Uplad Advanced > Multi-part Uplad, then click ne f the fllwing: HIGH, t split the file int tw parts MAX, t divide the file int mre parts Very large files can take time t cmbine, s yu might have t refresh (F5) the screen after a large multi-part transfer t see the resulting single, cmbined file n the remte server. Yu can quickly gauge the effectiveness f the transfer by highlighting that item in the Queue Windw, and clicking n the small plus sign + next t the item name. The item will expand t shw yu all parts f the transfer with the average speed f each part. Multi-part transfers are nt very effective fr smaller files. Multi-part dwnlads d nt ccur fr Sites that d nt supprt resume dwnlading. Multi-part transfers are nt very effective within yur wn netwrk. Multi-part transfers are nt very effective fr mdems slwer than 56kb, because mst FTP servers can at least transfer at that speed. Multi-part transfers d nt wrk if the FTP Site des nt allw multiple simultaneus cnnectins frm the same user r IP address. Due t added verhead n the prcessr f a server when generating encrypted transfers, multi-part dwnlads ver SSH and SSL can be ineffective and are nt recmmended. Accelerating Transfers with Mde Z Mde Z cmpressin cmpresses files n-the-fly fr file transfers frm the lcal cmputer t the remte cmputer and remte t lcal cmputer, saving bandwidth and imprving transfer time. Yu must cnfigure MODE Z t take advantage f this feature. This feature is turned n by default, and is used whenever yu cnnect t a server that supprts Mde Z. If MODE Z is enabled, then all the file types in the Mde Z list (ASP, BMP, CSS, DAT, DOC, EXE, HTM, JS, LOG, PDF, PHP, PL, PPT, PY, SWF, TXT VBS, XLS, XML, XSL) are cmpressed when transfer f files between the cmputers take place. T cnfigure Mde Z settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click MODE Z.The MODE Z ptins appear. 3. Cnfigure ptins as described belw. Select the Apply MODE Z cmpressin check bx t enable the cmpressin f files. Mde Z cmpressin is applied t all file types in the list. T add file type t Mde Z list, in the bx, type the file extensin, then click Add. T remve file type frm Mde Z list, click the extensin f the file in the list, then click Remve. Only thse files in the Mde Z list are cmpressed. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 138

139 Transferring Files and Flders Imprving CuteFTP Perfrmance When Transferring Large Numbers f Files at Once A few changes t CuteFTP's default settings can imprve CuteFTP perfrmance if yu regularly transfer a large number f files at the same time. Fr example, making a few adjustments t the settings in CuteFTP's Glbal Optins can prevent the initial cnnectin frm being used fr transfers and/r imprve the respnsive f CuteFTP. T imprve CuteFTP perfrmance 1. Open the Glbal Optins dialg bx. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Adjust the fllwing settings as needed: Allw transfers t ccur ver the existing (brwse) sessin: When yu transfer mre than the (user-cnfigurable) maximum number f files at the same time, CuteFTP will use the initial cnnectin t the Server fr ne f the file transfer cnnectins, knwn as the "brwse" sessin. When this ccurs, an hurglass can intermittently appear and CuteFTP becmes unrespnsive as the files are transferring and using the cnnectin. Als, scheduled transactins cannt ccur if all f the available cnnectins are in use. a. Click the Transfer nde. b. In the General area, clear the Allw transfers t ccur ver the existing (brwse) sessin check bx. The check bx is selected by default, because mst users want their transfer t ccur quickly and are nt likely t be brwsing while a large number f transfers are in prgress. Adjust the allwed number f cncurrent transfers: Allwing a very large number f cncurrent transfers can cause CuteFTP t mnplize the cmputer s CPU. Avid adjusting these settings, unless yu are willing t spend sme time ptimizing CuteFTP t yur particular CPU and netwrk capabilities. Fr example, n a bradband cnnectin with a 1 Ghz+ CPU, it might be mre apprpriate t set Glbal max cncurrent transfers t 120 and Per Site cncurrent transfers t 40. Keep in mind that if the FTP server des nt supprt the requested number f multiple cnnectins, cnnectin errrs will ccur when these settings are increased. One f the reasns this setting exists is t prevent CuteFTP frm trying t pen mre cnnectins than the server allws.. Click the Cnnectin nde. a. Increase the defaults fr Glbal max cncurrent transfers (the default is 12) and Per Site max cncurrent transfers (the default is 4) t allw CuteFTP t pen mre transfer cnnectins simultaneusly. Regardless f these settings, CuteFTP can becme unrespnsive if yu are sending mre files than the maximum. Adjust the lg strage settings: By default, saved lgs are deleted every 3 days. Yu can delete them mre frequently if yu transfer large numbers f files frequently. If yu want t keep lgs indefinitely, be aware that this may adversely affect perfrmance f CuteFTP and/r quickly fill up disk space. 1. Expand the General nde, then click Lg Files. 139

140 CuteFTP v9 User Guide 2. By default, saved lgs are deleted every 3 days. In the bxes next t the Delete saved lgs every check bx, yu can set the frequency t between 1 t 1000 minutes, hurs, r days. Clear the check bx if yu d nt want t delete the lgs autmatically, but be sure t delete them manually peridically t avid filling up the hard drive. 3. Select the Delete item lgs f successful transfers immediately after cmpletin check bx. By default, this check bx is nt selected, but selecting it culd imprve the perfrmance f CuteFTP when dwnlading a large number f files. Alternatively, yu can delete all lgs that are nt currently assciated with an pen cnnectin r an item listed in the transfer queue, by clicking Delete all lgs. (Be sure t clse cnnectins and clear ut the queue befre yu click Delete all lgs t ensure that all lgs are deleted.) Adjust the Queue cleanup settings: A large number f items in the Queue use up memry and resurces that can be freed by simply keeping the Queue clean. Remving cmpleted transfers frm the Queue culd help imprve the perfrmance f CuteFTP when dwnlading a large number f files. 1. Expand the Transfer nde, then click Events. 2. By default, the Remve successful transfer items frm the queue autmatically check bx is nt selected. Selecting this check bx culd help imprve the perfrmance f CuteFTP when dwnlading a large number f files, by keeping the Queue clean. Alternatively, yu can manually empty the queue peridically by clicking Tls > Queue > Remve All r by right-clicking in the queue, then clicking Remve All, but if the brwse sessin is being used fr transfers, manually remving items frm Queue might prve difficult. If yu have a particularly fast (bradband) cnnectin, yu can delete the thumbnail cache: Enabling Thumbnail cache expiratin ensures that the thumbnail cache will peridically be cleared; hwever, it als will cause the FTP sessin t re-dwnlad thumbnails, which can take a significant amunt f time n a dial-up cnnectin. 1. Expand the General nde, then click Lg Files. 2. In the Thumbnail settings area, set When the transfer engine exits t Delete images lder than the value specified. 3. In Thumbnail cache expiratin, set the expiratin t an apprpriate time. (This setting becmes editable after yu set When the transfer engine exits t Delete images lder than the value specified.) Alternatively, yu can click Delete thumbnail cache t delete all thumbnails in the cache except thse that are currently displayed in the applicatin. (Turn ff thumbnail view r clse all cnnectins befre clicking Delete thumbnail cache t ensure all thumbnail files are deleted.) 2. Click OK t clse the Glbal Optins and save the changes. 140

141 Transferring Files and Flders ASCII Transfer Settings Select, by file extensin, file types that shuld always be transferred in ASCII mde. T cnfigure the ASCII transfer ptins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click ASCII Types. The ASCII Types ptins appear. 3. Cnfigure ptins as described belw. In the ASCII extensins bx, type the file extensin fr files yu want t transfer in ASCII mde, then click Add t add the extensin t the list. T remve an extensin frm the list (t send files f this type in binary mde), click the extensin in the list, then click Remve. Yu can specify a Transfer type frm the main menu (see Transferring files in binary r ASCII mde). Yu can als specify a Transfer type fr an individual Site by highlighting the Site in the Site Manager, clicking the Type tab, and chsing frm the Transfer list. Aut is the default transfer type, and sends files in the mde specified fr each file's extensin. All extensins are sent in binary mde unless they are listed in the ASCII Extensins list. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Specifying Binary r ASCII Mde Yu can specify binary r ASCII mde fr a sessin, glbally (per file type), and per site. All extensins are sent in binary mde unless they are listed in the ASCII extensins list, as described belw. T chse the transfer mde fr a sessin Yu can change the transfer type fr a single CuteFTP sessin. Once CuteFTP is restarted, it reverts t the transfer type set in Glbal Optins. On the main menu, click File > Transfer Type, then click ne f the fllwing: Aut (r press CTRL+F1) - Aut is the default transfer type, and sends files in the mde specified fr each file's extensin. All extensins are sent in binary mde unless they are listed in Glbal Optins, as described belw. ASCII (r press CTRL+F2) - files will be transferred in ASCII mde. Binary (r press CTRL+F3) - files will be transferred in Binary mde. T transfer specific file types in ASCII mde 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). The Glbal Optins dialg bx appears. 2. Expand the Transfer nde, then click ASCII Types. A list f the file types that are transferred in ASCII mde are displayed. 3. D the fllwing: T specify file types that are t be transferred in ASCII mde, in the ASCII extensins list, type the file extensin fr the file type yu want t transfer in ASCII mde, then click Add. The extensin appears in the list. 141

142 CuteFTP v9 User Guide 4. Click OK. T specify file types that are t be transferred in binary mde, in the ASCII extensins list, click the extensin f the file type that yu want t transfer in binary mde, then click Remve. Remving the file type frm the ASCII extensins list will cause that type f file t be transferred in binary mde. T change a Site's transfer type 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Type tab. 3. In the Transfer type bx, Aut-detect is selected by default. Based n the file type, CuteFTP decides whether t transfer in ASCII r binary. T change this setting fr this site, click ne f the fllwing: ASCII - Used primarily fr transfer f textbased files such as HTML, text, and ther dcuments. Binary - Used primarily fr data type transfers such as pictures and ther graphics r files that d nt have line feeds. 4. Click Cnnect r OK. SSH2 servers d nt supprt ASCII transfers (see ). CuteFTP adjusts fr this by autmatically stripping line feeds prir t uplads and restres them during dwnlads (prir t the file being written t disk). Verifying Integrity f Transferred Files Althugh TCP/IP ensures that all packets are received prperly, mishandling by the applicatin can ccur, leading the client t believe that a transfer was successful when it was nt. The Server's file integrity cmmand is defined as XCRC. Once an XCRC-enabled client (such as CuteFTP) perfrms a transfer, it can request the Server t d a checksum calculatin n the file. If it matches the checksum n the client, then the transfer is deemed successful. Perfrming XCRC checksum calculatins is prcessr intensive; enable r disable the feature accrdingly. XCRC applies t FTP nly, nt SFTP. Refer t File Integrity Checking in FTP and SFTP belw fr details f file integrity checking in SFTP. XCRC is a prprietary cmmand and is nt defined nr endrsed by any FTP-related RFC. Cmpeting servers wh want t implement this cmmand may d s using the syntax described belw. XCRC <File Name> XCRC <File Name>, <EP> XCRC <File Name>, <SP>, <EP> SP = Starting Pint in bytes (frm where t start CRC calculating) EP = Ending Pint in bytes (where t stp CRC calculating) 142

143 Transferring Files and Flders FTP Client Lg Example COMMAND:> XCRC "/Prgram Files/MSN Gaming Zne/Windws/chkrzm.exe" SP and EP are ptinal parameters. If nt specified then it calculates the CRC fr the whle file. If nly EP is specified, then the CRC calculatin starts frm the beginning f the file t the EP. This cmmand can be used fr a single file at a time. It des nt allw file lists as parameters. The standard CRC32 algrithm is used (fr speed and efficiency). A client can invke this cmmand fr uplads, dwnlads, and single and Multi-Part Transfers. Server Reply Indicates 250 <XCRC> calculated CRC value 450 Requested file actin nt taken file is busy 550 Requested actin nt taken file is nt fund r has n read permissin; r the SP r EP are nt crrect File Integrity Checking in FTP and SFTP FTP prvides a very raw mechanism t transfer files the data fr a file is upladed/dwnladed as a stream f bits ver a TCP/IP cnnectin. There is n additinal verhead n that peratin, s it is fast; hwever, this als means that there are n intrinsic mechanisms fr ensuring that the file gt t the ther end intact. That is why many servers, including EFT Server, supprt the XCRC cmmand, an extensin t the FTP prtcl. The XCRC cmmand perfrms a CRC32 checksum ver the file (either the whle file, r a prtin f the file if a byte range is specified n the cmmand line). This gives a 32-bit value that the Server cmputes n the file, which can be cmpared t the 32-bit value cmputed n the client side. If bth files are the same size and the CRC32 matches, then there is a very high prbability that the files are identical and files were transferred crrectly. In cntrast, SFTP des add verhead t the transfer f files. As a file is transferred between client and server, it is brken up int smaller chunks called "packets." Fr example, suppse each packet is 32KB. The SFTP prtcl des a checksum n each 32KB packet as it is sent, and includes that checksum alng with that packet. The receiver gets that packet and decrypts the data, and then verifies the checksum. The checksum itself is "strnger" than the CRC32 checksum (because SFTP uses a 128-bit r higher checksum, such as MD5 r SHA, and because this is dne n each and every packet, there is a very granular integrity checking that is accmplished as part f the transfer. Thus, the prtcl itself is slwer (because f the additinal verhead), but the successful cmpletin f a transfer means, de fact, that it has be transferred integrally and there is n need fr an additinal check. If yu want t verify integrity, then use SFTP prtcl and it is built-in; r, use FTP and after a transfer issue the raw cmmand "XCRC /path/t/file" and read the results, cmparing t a lcally calculated CRC32 n the client side. EFT Server als supprts querying the CRC32 value ver the HTTP/S prtcl by issuing a "HEAD" request t the file. The result f a HEAD methd invcatin n the HTTP/S engine will result in a respnse that includes the "X-CRC" header, which cntains the CRC32 value f the file in questin. This can be cmpared t the CRC32 cmputed ver the lcal file, just like in the FTP case. T verify files have successfully transferred 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). The Glbal Optins dialg bx appears. 2. Expand the Transfer nde, then click Events. 3. In the Operatins after transfer area, select the Verify file integrity when transferring t/frm Glbalscape's FTP Server check bx. 4. Click OK. 143

144 CuteFTP v9 User Guide The File Integrity CRC Checksum is used ONLY if all f the fllwing are true: The file integrity feature is turned n in CuteFTP. The FEAT cmmand is enabled in CuteFTP (Tls > Glbal Optins > Navigatin Settings). The remte server supprts bth FEAT and XCRC, and has enabled it fr the specific user accunt. The files are binary files transferring in binary mde. The destinatin file size is smaller than the surce and the server supprts resume OR the destinatin is equal t the surce size (regardless f resume capability). Cmpressing and Decmpressing T cmpress files fr uplads 1. Cnnect t a Site and click the destinatin flder in the Remte pane. 2. In the Lcal Drives pane, click the item(s) yu want t uplad. 3. On the main menu, click File > Uplad Advanced > Uplad Cmpressed. A sub menu displays the selected file name with three different extensins. Each extensin identifies a cmpressin scheme. 4. Click the file name with the extensin fr the cmpressin scheme yu want. T decmpress a lcal archive 1. In the Lcal Drives pane, click the archive t be expanded. 2. On the main menu, click Tls > Cmpressin > Decmpress. The cntents f the archive expand int a directry with the same name as the archive. Yu cannt decmpress a file n a remte FTP server frm within CuteFTP's interface. T decmpress an archive remtely, use a cmpressin tl and Glbalscape EFT Server t create an Event Rule r Custm Cmmand (n the Server) that will decmpress archives upladed t the server (either autmatically r as a result f a custm cmmand sent by the client). See this custm cmmand example fr mre infrmatin. T create encrypted archives fr uplad, yu need a cmpressin tl and a call script t encrypt, cmpress, and then uplad an archive..zip is the industry standard archival methd (wide supprt, medium cmpressin)..cab is a Micrsft frmat (nt very wide supprt, strnger cmpressin than ZIP)..gzip/tar is a UNIX frmat (files are stred in a r;tarball then cmpressed). Windws XP has a built-in cmpressin/decmpressin tl. Refer t the Micrsft Supprt article #306351, at 144

145 Transferring Files and Flders Using Scripts t Transfer Files Yu can write scripts t transfer files using CuteFTP's Transfer Engine (TE). With scripts, yu can interact directly with the TE using cmmn prgramming languages such as Visual Basic (VB) r ther scripting languages supprted by the Windws Scripting Hst (WSH). Sample scripts and examples are available in the Transfer Engine sectin. Yu can als use CuteFTP's macr recrder t capture entire sessins t a script fr future playback. T cnserve resurces, if yu leave CuteFTP r the Transfer Engine pen t accmplish a number f tasks, yu shuld set CuteFTP t delete successfully finished items frm the queue. Recrding a Macr CuteFTP can recrd and playback entire sessins using the pwerful macr recrd/playback tl. Sessins are recrded in Visual Basic Script and take advantage f CuteFTP's COM-expsed transfer engine (TE) interface. T play a recrded macr, refer t Playing a Recrded Macr. T start recrding a macr 1. Befre recrding yur macr, perfrm the steps yu will be recrding t test the prcess. 2. When yu are ready t recrd, n the main menu, click Tls > Macrs and Scripting > Start Recrding. 2. Cnnect t yur Site and perfrm the tasks yu want t recrd. 3. When yu finish recrding the macr, click Tls > Macrs and Scripting > Stp Recrding. The Save As dialg bx pens. 4. In the File name bx, type a name fr the macr, then click Save (r click Cancel t cancel the recrding). If yu click Cancel, a cnfirmatin message appears. 5. Click Yes t cancel the recrding sessin r click N t specify a lcatin t save. If yu click Yes, the recrded script is lst. Cnfiguratin Ntes The macr recrder can recrd mst events supprted by the CuteFTP's TE COM interface: Cnnect (FTP, FTPS, SFTP, HTTPS) including all parameters (OTP, CCC, AUTH_TLS, etc.) Discnnect Uplad Dwnlad Site t Site Transfer Synchrnize URL Transfer Create Lcal Flder Create Remte Flder Rename Lcal Flder Rename Remte Flder Remve Lcal Flder Remve Lcal Flder Raw FTP Cmmand 145

146 CuteFTP v9 User Guide The macr recrder uses all defined parameters set in the CuteFTP interface fr Scks and Prxy infrmatin; therefre, there is n need t add "UsePrxy" t the resulting script (macr) that is created. Playing a Recrded Macr T play a macr frm within CuteFTP 1. On the main menu, click Tls > Macrs and Scripting > Run > Brwse. The Open dialg appears. 2. Click the macr yu want t run, then click Open. The Open dialg clses and the macr runs. T playback a macr script frm utside f CuteFTP In Windws Explrer, lcate the macr file, then duble-click it. CuteFTP's Transfer Engine perfrms the recrded events withut launching the interface. Yu must have the Windws Scripting Hst (WSH) installed t play recrded macrs r scripts. T create a macr, refer t Recrding a Macr (Autmating Sessins). Custm Cmmands Custm cmmands allw yu t specify a raw FTP cmmand sequence and assign shrtcuts r tlbar links t these sequences. T add a custm cmmand 1. On the main menu, click Tls > Custm Cmmands > Edit Custm Cmmands. The Custm Cmmands dialg bx appears. 2. Click the New Flder icn. A new flder is created. 3. Type a name fr the flder. 4. Click the New Cmmand icn. A new cmmand appears beneath the flder. 5. Type a name fr the cmmand. 6. With the cmmand selected, click the Prperties icn. The Custm Cmmand Prperties dialg bx appears. 7. In the Cmmand bx, type an FTP cmmand r cmmand sequence. T add a cmmand sequence, add a line break between cmmand sequences when entering them int the Cmmand bx. Fr example: USER %u \n PASS %p 8. (Optinal) Click in the Shrtcut Key bx, then press the keys n yur keybard fr the shrtcut. 9. (Optinal) Click Change Icn t select a tlbar icn fr the cmmand. The Chse an Icn dialg bx appears. 10. Click the icn yu want, then click OK. 11. T include the new cmmand n the Custm Cmmands tlbar, select the Place n the custm cmmands tlbar check bx. 12. Click OK twice t accept the changes and clse the Custm Cmmands dialg bx. 146

147 Transferring Files and Flders T use a custm cmmand 1. Cnnect t a Site. 2. On the main menu, click Tls > Custm Cmmands, then click yur custm cmmand. T display the Custm Cmmands Bar On the main menu, click View > Tlbars > Custm Cmmands Bar. The remte Site must be in the active pane fr a cmmand t be sent. Once sent, yu can view the server's respnse in the Lg windw. Saving and Reusing a List f Transfer Tasks When yu create a Flder Mnitr task, the task is saved in the Queue Windw. CAUTION: If yu use Remve All t remve everything frm the Queue Windw, yu will als remve yur Flder Mnitr rules!! Unfrtunately, it is nt pssible t retrieve any tasks that were deleted. Hwever, yu can backup (exprt) all tasks and relad (imprt) them. T save a list f transfer task/flder Mnitr Rules 1. D ne f the fllwing: On the main menu, click Tls > Queue > Lad & Save Queue > Save Queue. Right-click in the Queue Windw, then click Lad & Save Queue > Save Queue. 2. In the Save As dialg bx, specify a name and lcatin, then click Save. The file is saved as quesave.cpx by default. T reuse a list f tasks (lad a previusly saved queue) 1. D ne f the fllwing: On the main menu, click Tls > Queue > Lad & Save Queue > Lad Queue. Right-click in the Queue Windw, then click Lad & Save Queue > Lad Queue. 2. In the Open dialg bx, click a saved Queue file (Queue files are saved with a.cpx extensin), then click Open. The saved tasks appear in the Queue. (NOTE: If a task in the.cpx file is already in the Queue, it is nt verwritten; instead, yu will have duplicate tasks in the Queue. Srt the Queue by the Lcal r Remte clumn t find the duplicates.) Imprving Slw Transfers If yu are experiencing slw transfer speeds, try fine tuning CuteFTP as described belw. 147

148 CuteFTP v9 User Guide Make sure that Mde Z is turned n Mde Z cmpressin cmpresses files as they are transferred. Reducing the file size reduces the necessary bandwidth and imprves transfer times. If this ptin is turned n, CuteFTP will take advantage f any server that supprts Mde Z. Tweak the receive and send buffers Setting these buffers allw yu t fine tune transfers ver high latency r lssy cnnectins like thse ver satellite links r with legacy CDMA wireless cnnectins. It is unlikely yu will ever need t adjust this setting, but if yu have prblems with successful transfers and suspect the latency r quality f the cnnectin is at fault, try tweaking these buffers. The receive buffer hlds data until CuteFTP is ready t read it; the send buffer hlds data until it can be sent t the server. Typically, bth send and receive buffers shuld be set t the same size. The default is set at bytes, the nrmal maximum windw size f TCP. Yu can measure the latency and estimate the available bandwidth with netwrk mnitring tls. There is sme guesswrk invlved, as mst tls are nt entirely accurate, but they can guide yu t finding a sweet spt where transmissins are successful. If yu have a lssy cnnectin, try lwering the buffer size. If yu have high latency, a higher buffer size might help. Nrmally, the ptimal buffer size is yur bandwidth times the latency f the link. S, bandwidth (in bits) * latency (rund trip time in secnds) = scket buffer size (in bits) Cnvert bits t bytes (bits divided by 8 equals bytes) fr the buffer size. S, if yur bandwidth is 1,536,000 bps and yu have a latency f 200ms (.2 secnds), yur scket buffers shuld be set t 38400: *.2= bits /8=38,400 bytes Yu can als try halving r dubling the buffer size. Fr example, if the buffer is set t (64kb), try (32kb). 1. On the main menu, click Tls > Glbal Optins. 2. Click the Transfer nde. 3. In Receive buffer and Send buffer bxes, change the values as needed. (See guidelines abve.) 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Turn ff the time stamp in lgs When this feature is n, CuteFTP adds a time stamp next t each lg event. This ptin cnsumes system resurces, s yu can turn this ff if perfrmance is critical. Fr mre infrmatin, see Recrd/Display time stamps in Lg file settings Try using multi-part transfers If yu are transferring large files, try using a multi-part transfer. Yu can nly use this ptin if the server yu are cnnecting t supprts it. Check the glbal bandwidth limit Determine whether the glbal bandwidth limit is limiting yur thrughput. This setting in Glbal Optins thrttles the bandwidth f all sessins n CuteFTP. See Glbal bandwidth limits. 148

149 Transferring Files and Flders Transferring Manually Use this functin t transfer a specific file if yu knw its exact lcatin and yu are unable t navigate t that lcatin r d nt have LIST permissins fr that flder. T dwnlad a file manually 1. In the Lcal Drives pane, pen the destinatin flder. 2. Cnnect t the Site where the file exists. 3. In the Remte pane, click any file r flder. 4. On the main menu, click File > Dwnlad Advanced > Dwnlad Manually. The File t Dwnlad dialg bx appears. 5. In Dwnlad path, type the path t the file yu want t dwnlad. 6. Click OK. T uplad a file manually 1. Cnnect t the Site t which yu want t uplad the file. 2. Open the destinatin flder in the Remte pane. 3. In the Lcal Drives pane, select the file yu want t uplad. 4. On the main menu, click File > Uplad Advanced > Uplad Manually. The File t Uplad dialg bx appears. 5. In Uplad path, type the cmplete path t the file yu want t uplad. 6. Click OK. Uplad/Dwnlad Filtered Files CuteFTP allws yu t set filters that autmatically include r exclude files frm transfers. Yu define the filters in the Filter dialg bx, then apply them t transfers. When yu apply filters, yu d nt add r remve files, yu simply set which files will be visible r invisible in CuteFTP. Refer t Filtering the List f Files and Flders fr mre infrmatin. T transfer filtered items After defining a filter as described abve, in the Lcal Drives r Remte pane, click the files that remain visible, then click File > Uplad Advanced, then click Uplad filtered (r Dwnlad Advanced > Dwnlad filtered if yu are dwnlading). Fr the Uplad Advanced ptin t be available, yu must cnnect t a Site and select a flder in the Lcal Drives pane. Fr the Dwnlad Advanced ptin t be available, yu must cnnect t a Site and select a flder in the remte pane. 149

150 CuteFTP v9 User Guide FTP Cmmands Yu can cmmunicate with an FTP Site n the lwest pssible level. T manually enter an FTP cmmand 1. Cnnect t a Site. 2. On the main menu, click Tls > Enter FTP Cmmand. 3. In the Input FTP cmmand bx, type a cmmand such as LIST r CWD r PWD. 4. Click OK. Yu can als send multiple cmmands t the FTP server by using Custm Cmmands. A list f FTP cmmands can be fund here: RFC959 describes FTP cmmands and reply cdes. Unicde Supprt in CuteFTP CuteFTP supprts Unicde file names. T cnserve Unicde file names, the remte server must supprt UTF-8 and advertise UTF-8 in its FEAT cmmand. T cnserve Unicde file cntent yu must transfer the file using binary transfer mde. (Refer t Specifying Binary r ASCII Mde.) Nte that text (ASCII) files transferred in binary mde will retain their carriage return (CR) and line feed (LN) hidden characters, which are nt supprted by Unix systems by default. The fllwing areas and features f CuteFTP d nt currently supprt Unicde: Cmpressin: GZIP/TAR files PGP: Key paths and key passwrds can include Unicde symbls, but ld passwrds with Extended ASCII symbls will nt wrk SSL: In the Create Certificate wizard, the fllwing fields cannt include Unicde symbls: Passphrase, Cmmn name, Cuntry, Private key passwrd. SFTP: If yu have upgraded t CuteFTP v9 and are using key pairs created with CuteFTP v8, if the passwrd fr an existing key cntains any Extended ASCII characters, the passwrd will nt wrk. Yu will have t reenter the passwrd (Tls > Glbal Optins > Security > SSH2 Security) after upgrading t v9. 150

151 Chapter 9. Managing Files and Flders The tpics belw prvide prcedures fr managing files and flders. (See als Transferring Files and Flders.) Opening, Editing, Renaming, and Deleting Files Yu can manage yur files n bth lcal and remte drives frm within CuteFTP. Because f the way in which varius type f servers handle files and t make file maintenance easier, keep the fllwing in mind when naming yur files and flders: Keep names shrt. Sme servers nly allw a certain number f characters. Create meaningful names using whle wrds t avid ambiguity and s that yu d nt have t pen a file t knw what it is. Fr example, a year after yu create a Web page fr yur friend's cat, Greta, yu are mre likely t knw what pictures-f-greta.htm cntains versus pg.htm. Use lwercase fr names. Sme servers are case sensitive. Names shuld never cntain spaces r special characters (? * / \ : ; < >, and s n ). If yu want t make filenames easier read, use hyphens r underscres; hwever, underscres are hidden if the filename is turned int a hyperlink. Fr mst websites, the main page must be called index.htm r index.html. If yu rename it main.htm, it might nt wrk. T pen a file 1. Click a file in Lcal Drives r the Remte pane. 2. On the main menu, click File > Open, r click the Open icn. The applicable prgram pens r runs the file. T edit a file 1. Click a file in Lcal Drives r the Remte pane. 2. On the main menu, click File > Edit r View. The file pens in CuteFTP's built-in editr r the HTML editr that yu have specified in Glbal Optins. 3. Make any desired changes. 4. On the main menu, click File > Save. If yu want t save a text file as UTF-8 frmat, click File > Save As, and then click UTF-8 in the Encding list. Yu can cnfigure the built-in editr t pen in full-screen mde r in tab view. When yu exit the editr, CuteFTP restres the screen t its riginal state. Cycle thrugh the pen panes, including any editr tabs, by pressing CTRL+TAB. T rename a file 1. Click a file in Lcal Drives r the Remte pane. 2. On the main menu, click File > Rename r right-click the file and click Rename. 3. Type a new name fr the file, then press ENTER. 4. The renamed file is highlighted and the sequence f the file is changed alphabetically. Fr example, if the file name was S.txt, and the name f the file is changed t A.txt, then the sequence f the file changes. The file A.txt appears where all files starting with alphabet A appear. 151

152 CuteFTP v9 User Guide If yu change the extensin when yu rename the file, yu may nt be able t pen the file in the prper prgram. T delete a file 1. Click a file in Lcal Drives > Remte pane. 2. On the main menu, click File > Delete. A cnfirmatin message appears. 3. Click Yes. Updating r Refreshing Flder Listings T update r refresh a flder listing 1. Click in the pane where the flder is displayed. 2. On the main menu, click View > Refresh. T update remte flder listings autmatically 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). The Glbal Optins dialg bx appears. 2. Expand the Navigatin nde, then select the Aut-refresh the remte pane after uplading a file r flder check bx. 3. Click OK. Listing Files and Flders in Order Yu can srt the display f the files and flders in the Remte pane, Lcal Drives pane, and Queue Windw. Srting is fr ease f finding a file r flder; it des nt affect the transfer rder f the files/flders in the Queue. T srt files and flders in rder by name 1. Click in the Remte r Lcal Drives pane. 2. On the main menu, click View > View > Details. 3. Click the Name clumn header in the Remte r Lcal Drives pane. 4. Each time yu select the clumn header the items are srted in the ppsite rder. Yu can srt by any clumn when in Details view. T srt files and flders in rder in the Queue Windw 1. Click in the Queue Windw. 2. Click a clumn header in the Queue Windw. The transfer items are listed in alphabetic rder f the selected clumn's cntents. 3. Each time yu select the clumn header the items are srted in the ppsite rder. 152

153 Managing Files and Flders The rder items are listed in the Queue Windw is nt necessarily the rder in which they transfer. The numbers in the left-mst clumn f the Queue Windw indicate the rder f transfer. Fr example, when the Queue Windw is srted alphabetically by Item Name, the transfer rder stays the same. Finding Files and Flders CuteFTP Site Search functin allws yu t search lcal and remte drives and flders fr files based n all r part f the filename with wildcard supprt, mdificatin date r date range, and file size r size range. T find a file r flder 1. On the main menu, click Edit > Find. The Search Results dialg bx pens. 2. Next t Search in, specify whether t search n the lcal r remve pane. Lcal Drives - If yu want t search fr a file in yur lcal drive. Remte pane - If yu want t search fr a file in the remte pane. 3. In the Search fr the files r flder named bx, type the name f a file r flder, r the extensin f a file fr which yu want t search. The name r the extensin f the file is added t the drp-dwn list. Yu can als use wildcards. 4. In the Lk in bx, specify the flder t search r type the path. 5. T include the subflders in the target flder, select the Search subflders check bx. 6. T define the file size, select the File size between check bx, then type the number f kilbytes in the text bxes. 7. T specify a date range, select the Date mdified between check bx, then type r select the date range in which t search. 8. T start the search, click Search Nw. 9. T stp the search, click Stp search. 10. All f the files with the same extensin r with same name with ther details, such as size, type, mdified n, and attributes are listed in the Results pane f the Search Results dialg bx. Find and Find Next are nt case sensitive and nly search frm the tp t the bttm f yur listings. 153

154 CuteFTP v9 User Guide Selecting a Grup f Items Yu can select (highlight) items in the Remte pane, Lcal Drives pane, r Queue Windw by name r type using Grup Select and wildcard masks. T select all files f a certain type 1. Click in the pane displaying the files yu want t select. 2. D ne f the fllwing: On the main menu, click Edit > Grup Select. Press the PLUS SIGN (+) n the number pag. (Be sure NUM LOCK is n). The Select grup dialg bx appears. 3. In the Select mask bx, d ne f the fllwing: Type *. and the extensin f the file type yu want t grup select. Fr example, t grup select all gif files, type *.gif. Type a string t match. Fr example, if yu type dc, all items cntaining the string dc, regardless f file type, are selected. 4. T grup select nly files (nt flders), clear the Mask directries check bx. 5. T include previusly selected files in the new grup yu are defining, select the Remve Selectin check bx. Clear the check bx t exclude previusly selected items that are nt in the new grup. 6. Click OK. Files f the specified type are selected (highlighted) in the pane. Yu can nw manage them (transfer, cpy, delete, mve, etc.) as a grup. T switch the selectin between the highlighted grup and all nn-highlighted items With a grup selected, n the main menu, click Edit > Invert Selectin r press * (asterisk). T remve items frm a grup selectin If yu have selected a large grup f items then decide yu want t remve certain items r file types frm the grup, use the prcedure belw. 1. With a grup selected, n the main menu, click Edit > Grup Deselect. 2. In Deselect grup, type the name f the file r file type yu want t remve r use wildcard masks t remve a grup f items. 3. Select the Mask directries check bx t include flders in the actin. 4. Click OK. 154

155 Managing Files and Flders Mving Items frm One Flder t Anther n a Remte Server Yu can mve selected items frm ne remte flder t anther remte flder n the same server. T mve items frm ne remte flder t anther 1. Cnnect t the Site, then pen a flder n the remte Site. 2. Select items in the flder. 3. D ne f the fllwing: On the main menu, click Edit > Mve t Flder. Right-click the file, then click Mve t. 4. In the Mve items t bx, specify the path at which t save the selected items. 5. Click OK. CuteFTP des nt create the flder. If the flder des nt exist, an errr message appears. Changing File and Flder Permissins n Remte Sites Yu can set wh can pen, change, r delete files and flders n remte Sites. See als Abut CHMOD Permissins. T change permissins fr a remte file(s) r flder(s) 1. Cnnect t a Site. 2. Select the file(s) r flder(s) fr which yu want t change permissins. 3. On the main menu, click File > Prperties. 4. Select the check bxes next t the permissins yu want fr yurself (Owner), a Grup f users, and the Public. When multiple items are selected, a gray check mark signifies the permissin is granted fr sme files in the grup, but nt in thers. Yu can still change the permissin fr the whle grup. If yu cannt change permissins fr a file r flder, the FTP server administratr must mdify yur accunt r the file permissins. 5. Click OK. Wildcard Masks Wildcard masks are patterns f special characters used t filter files/flder names r transfers. When a wildcard mask is matched against a filename, the tw patterns are cmpared, letter-by-letter, frm left t right until a mismatch ccurs. If all the characters in bth patterns cmpare psitively, the filename matches the Wildcard Mask. Wildcard mask characters? Will match any singe character * Will match any sequence f characters (including n characters at all), terminated by the next character in the mask. [ ] Will match any character in the character set enclsed in the brackets. This can als be a range f characters If the pening bracket is fllwed by!", will match any character NOT in the set. 155

156 CuteFTP v9 User Guide Wildcard Mask Examples Mask Will Match Will NOT Match * all files -- *.bmp sample.bmp, xyz.bmp sample.gif x?z xyz, xaz xyy, zyz a[xyz]c axc, ayc, azc abc, awc a[!xyz]c abc, adc, awc axc, ayc, azc a[a-c]d aad, abd, acd add, axd Displaying Hidden Files r Flders By default, sme servers will hide files with names starting with a perid such as ".htaccess" r ".prfile." T display hidden files n a remte Site 1. In the Site Manager, click the Site with the hidden files. 2. On the main menu, click File > Prperties. 3. On the Actins tab, click Filter. 4. Select the Enable filtering check bx. 5. Select the Enable server side filtering check bx. 6. In the Remte filter field, type -a, then click OK. 7. Cnnect t the Site. Yu shuld nw be able t see hidden files and flders. Cmparing Flders by Case, Size, and Date CuteFTP allws yu t cmpare flders in a lcal flder with a remte flder. Yu can cmpare file size and/r dates. The files that are different are highlighted in red. If the file des nt exist, it is highlighted in blue. T cmpare flders 1. Click the Lcal Drives tab and navigate t the flder yu want t cmpare. 2. Navigate t the same flder n the remte cmputer pane. 3. On main menu, click Tls > Flder Tls > Cmpare Flders (r press F11). The Directry Cmparisn Optins dialg bx appears. 156

157 Managing Files and Flders T ignre case while cmparing the flders, select the Ignre case check bx. This cmpares all files with the same name, regardless f case. That is, AddFile.gif is cmpared t addfile.gif. T cmpare files by size, select the Cmpare sizes check bx. T cmpare files by date, select the Cmpare dates check bx. 4. Click OK t start cmparing. CuteFTP cmpares the files with the same name, and highlights any files r flders that are different (either in size and/r by date). If the file is highlighted in blue, the file des nt exist in the remte flder. If a file in yur lcal flder is called add feed.gif, and a file in the remte flder is called add_feed.gif (the lcal file has a space and the remte file has an underscre), the cmparisn tl thinks the file des nt exist n the remte system. It is recmmended that yu use underscres instead f spaces when naming files s that the frmat is cmpatible acrss perating systems. Fr example, Windws allws spaces in file names, but UNIX des nt. If the file is highlighted in red, the file size r date is different. If yu have NOT selected the Preserve the lcal time stamp fr upladed files if the server allws MDTM check bx in Tls > Glbal Optins > Transfer > Events, then the date/time will likely be different between lcal and remte files. If the file is nt highlighted, the file n yur lcal system has the same prperties as the file n the remte system. 5. If yu want t update the files in the remte lcatin, hld dwn CTRL t multi-select the files that are different, then d ne f the fllwing: Right-click the selectin and click Uplad. Drag the selectin t the remte lcatin. On the main menu, click File, then click Uplad. Press CTRL+PAGE UP If yu are nt sure why a file is different and want t cmpare the HTML cntents manually befre uplading, yu can right-click the file, then click View. Synchrnizing Flders CuteFTP prvides a wizard t allw yu t synchrnize the cntents f a lcal flder with a remte flder and vice versa. The cntents are matched accurately s that there is n difference in the cntents between the flders. Yu can mnitr mre than ne flder r synchrnize multiple sites. Yu have t schedule and queue the required synchrnizatins. Flder Synchrnizatin Wizard guides yu thrugh the steps required fr synchrnizing flders. T synchrnize flders 1. On the main menu, click Tls > Flder Tls > Synchrnize Flders (r press CTRL+F11). The Flder Synchrnizatin Wizard appears. 2. In the Enter the lcal path t synchrnize bx, click the flder icn t brwse fr the flder. 3. In the Enter the remte path t synchrnize bx, type the remte path f the flder. 4. T include the subflders within the flder yu want t synchrnize, select the Include subflders check bx. 5. Click Next. 157

158 CuteFTP v9 User Guide 6. In the Select the directin f synchrnizatin bx, click ne f the fllwing ptins: 7. Click Next. Mirrr Lcal keeps the lcal flder the same and changes the remte flder t match the lcal flder. This is the default selectin. Mirrr Remte keeps the remte flder the same and changes the lcal flder t match the remte flder. Mirrr Bth adds files t bth the flders and puts the latest versin f all files in bth flders. 8. In the Fr matching filenames always bx, click ne f the fllwing: Use glbal verwrite settings. This is the default selectin. This ptin uses verwrite settings cnfigured fr all sites in Tls > Glbal Optins > Transfer > Smart Overwrite. Overwrite. The transferring file replaces the destinatin file. When mirrring bth flders, the mst recent versin f the file is kept. Numerate. Bth files are kept, and ne is renamed with a number t distinguish between the tw. Skip. Ignres matching files and transfers nly thse files that are nt present n the ther system. 9. In the Remte file names that differ nly in case bx, if the file names are identically spelled but differently cased, yu can select ne f the fllwing: Transfer first file nly and skip thers. >The first file transfers and the rest are skipped. Numerate files. Bth files are kept. One is renamed with a number t distinguish between the tw. Shw rename prmpt. CuteFTP prmpts yu t rename ne f the identical files. 10. T make the mirrred flder a strict duplicate f the surce flder, select the When ne way mirrring, delete the destinatin file if it des nt exist in the surce flder check bx. This updates ld files and deletes unused files. If yu clear this check bx, the extra files present in the mirrred flder are left in place. 11. T prmpt yu befre deleting the file, select the Always prmpt befre deleting check bx. 12. Click Next. 13. T prevent CuteFTP frm fllwing symblic links when mirrring subflders, select the Ignre symblic link check bx. Select this ptin unless symblic links are abslutely needed. If yu clear this check bx and a symblic link pints t a spt further up in the flder tree frm where the mirrring began, yu are stuck in an infinite lp. 14. T cmpensate fr a prblem that ccurs when trying t synchrnize ASCII files residing n Unix file systems, select the Transfer all files in binary t cmpensate fr ASCII file differences check bx. Windws and UNIX differ slightly n hw they stre ASCII files, especially with regard t the End f Line (EOL) r line breaks in ASCII dcuments. This difference causes an therwise identical file t be seen as "different" when perfrming a synchrnizatin tasks because f size difference. All files are transferred in binary mde, which means that an ASCII file residing n a lcal system is transferred t the remte server with its EOLs intact. 15. Click Next. 158

159 Managing Files and Flders 16. Click ne f the fllwing: 17. Click Next. T start synchrnizatin f the flders immediately, click Run. T start synchrnizatin f flders at a specified time, click Schedule. 18. D ne f the fllwing: If yu clicked Run, click Finish t start the synchrnizatin. If yu clicked Schedule: a. In the Start n area, specify the date and time fr the synchrnizatin. b. T repeat the synchrnizatin after a specified perid, select the Enable recurrence check bx, then in the Repeat every bx, specify the frequency. c. Click Next. The synchrnizatin settings appear. d. Verify the synchrnizatin settings, then click Finish t save the settings r click back t edit the settings. The synchrnizatin task appears in the Queue Windw. T stp a synchrnizatin task 1. Select the task in the Queue Windw. 2. On the main menu, click Tls > Queue > Remve Selected. T use filters with synchrnizatins When yu set up the Flder synchrnizatin wizard, right-click in the pane yu want t filter (lcal r remte), click Filter, and make sure that Enable filtering and Apply t file transfers are selected. Additinally, ensure that the filter definitins are in place when yu set up the synchrnizatin wizard. Fr mre infrmatin, refer t Filtering transfers. Backing Up Lcal Files t Remte Hst Yu can back up files and flders frm yur lcal cmputer t a remte hst. (Fr details f restring files backed up t a remte hst, refer t Restring Lcal Files Backed Up t Remte Hst.) If yu've already created a backup jb, skip t Run the Backup Jb Again. T backup lcal files t remte hst 1. Lg in t the remte hst. 2. On the main menu, click Tls > Flder Tls > Backup Lcal t Remte. The Chse Backup r Restre dialg bx appears. 159

160 CuteFTP v9 User Guide 3. Click Create Backup, then click Next. The Lcal Backup Wizard appears. The Lcal Backup Wizard cntains the list f all lcal files and directries n yur lcal cmputer. 4. Select ne r mre check bxes adjacent t the files and flders t backup. When yu select the check bx fr a flder, each f the subflders and files in that flder are selected autmatically. T clear the check bxes fr the subflders and files the flder, clear the check bx next t the parent directry. 5. Click Next. The Select Site and Remte Flder page appears. 160

161 Managing Files and Flders 6. Click the Site n which yu want t save the backup. The parent directry fr the Site appears in the Select remte flder bx. If necessary, specify the flder n the remte Site t which yu want t save the backup, then click Next. 7. Select the cmpressin settings frm the fllwing ptins. N cmpressin Cmpress all files t a single ZIP file - ZIP is an industry standard archival methd. ZIP supprts mst f the files, but prvides medium cmpressin. Cmpress all files t a single CAB file - CAB is a Micrsft frmat. It prvides strnger cmpressin than ZIP. Cmpress all files t single GZIP file - GZIP/tar is a UNIX frmat. Files are stred in a Tarball, and then cmpressed. 8. Click Next. The Schedule page appears. 161

162 CuteFTP v9 User Guide 9. Select ne f the fllwing ptins: Immediately run backup jb ptin t make a backup immediately. - r - Schedule lcal backup check bx t set a future date and time, then specify the fllwing ptins: Set the date and time fr the lcal backup frm the Start n calendar. Select the Enable backup recurrence check bx t enable recurring backups. In the Repeat every list, specify a frequency. 10. In the Name bx, specify a name fr the backup flder. 11. Click Finish. The backup flder appears in the remte flder f the server. Run the Backup Jb Again Once the backup has been created, yu can reactivate it (run it again) at any time frm the same wizard. That is, if yu had created a backup jb and chse t run it immediately, after it is remved frm the queue (either after cmpletin r manually remved), "Activate backup" appears in the wizard. T run a backup jb again 1. Lg in t the remte hst. 2. On the main menu, click Tls > Flder Tls > Backup Lcal t Remte. The Chse Backup r Restre dialg bx appears. 162

163 Managing Files and Flders 3. Click Activate backup. 4. In the Inactive backup list, click the backup that yu want t run, then click Next. 5. Specify a schedule t run the backup (immediately r in the future), then click Finish. Restring Lcal Files Backed Up t Remte Hst If yu have backed up yur lcal files t a remte hst, yu can restre them using the same wizard. (Fr details f backing up lcal files t a remte hst, refer t Backing Up Lcal Files t Remte Hst.) T restre yur backed up lcal files frm a remte hst 1. On the main menu, click Tls > Flder Tls > Backup Lcal t Remte. The Chse Backup r Restre dialg bx appears. 2. Click Restre. The names f yur scheduled backup jbs appear. 163

164 CuteFTP v9 User Guide 3. Click the name f the Jb that yu want t restre, then click Next. 4. Specify the lcatin in which t restre the backup, then click Next. 164

165 Managing Files and Flders 5. Specify ne f the fllwing verwrite rules. Use glbal verwrite settings Use the setting defined in Glbal Optins. Overwrite Overwrite files with the same name. Numerate Make a cpy f same-named files and add a number t the cpy. Skip D nt verwrite existing file and skip the restre f that file. 6. Click Next. Yu are asked t lg in t the Site, and then the files are restred. 7. Click OK t clse the prmpt, and then click Finish t clse the wizard. Backing Up Remte Flders CuteFTP allws yu t create cpies f remte files and flders n yur lcal cmputer regularly r at a scheduled time. CuteFTP als cmpresses the backup autmatically. T back up a remte flder 1. On the main menu, click Tls > Flder Tls > Backup Remte Flders. The Site Backup Wizard appears. 165

166 CuteFTP v9 User Guide 2. In the Lcal path fr string backup file bx, click the flder icn t specify the lcal flder fr the backup. 3. In the Remte path t backup bx, type the path f the remte flder t be backed up. 4. T include subflders f the target flder, select the Include subflders check bx. 5. Click Next. 6. In the Chse cmpressin type list, click a cmpressin type: N cmpressin ZIP Cab GZip 7. Click Next. 8. Select frm the fllwing ptins. 9. Click Next. Run nw - T start the backup immediately. Schedule - T schedule the backup at a specified time. 10. D ne f the fllwing: If yu clicked Run, click Finish t start the backup. If yu clicked Schedule: a. In the Start n area, specify the date and time fr the synchrnizatin. b. T repeat the backup after a specified perid, select the Enable recurrence check bx, then in the Repeat every bx, specify a time and unit (minute, hurs, days, weeks, mnths, years). c. Click Next. d. Click Finish. The backup task appears in the Queue Windw. T discntinue a scheduled backup task Right-click the task in the Queue Windw, then click Remve Selected. Mnitring a Lcal Flder fr Changes CuteFTP allws yu t uplad any new r mdified files r flders added t a specific lcal flder autmatically. The Flder Mnitr wizard guides yu thrugh the steps required fr activating the flder mnitring functin. T uplad changes t a lcal flder autmatically 1. Cnnect t the Site that cntains the flder t which yu want t uplad the changed r new files. 2. On the main menu, click Tls > Flder Tls > Mnitr Lcal Flders. The Flder Mnitr Wizard appears. 3. Specify the lcal path t the flder yu want t mnitr. 4. In the Uplad t the fllwing remte path bx, prvide the remte path t where yu want t uplad the files in the mnitred flder. 166

167 Managing Files and Flders 5. T mnitr all subdirectries within the target flder, select the Include subflders check bx. 6. Click Next. 7. Specify the date and the time after which all the files created r mdified in the flder are upladed t the server. 8. T verwrite any file with the same name n the server, select the Always verwrite check bx. If yu select this check bx, Smart Overwrite rules are ignred and there is n warning befre files are verwritten. 10. T mnitr certain files r file types in a flder, select the Apply mnitr filters check bx. 12. T apply filtering t the particular flders, select the Apply filtering t flder names check bx. (The filters shuld be predefined. Refer t Filtering Transfers fr details.) 14. If yu want tw files with the same name but different case t be treated as tw separate files, select the Use case sensitive filtering check bx. 15. Click Next. 16. If yu selected filtering, specify which files t include r exclude in the transfer (therwise, skip this step): 17. Click Next. Type the file name r file type in the Include files that match the mask listed belw bx, then click Add. The file r file type is added t the list f files that are mnitred. Fr example, type.txt in the Include files that match the mask listed belw bx, then click Add. All the.txt files in the flder are mnitred. Fr the files yu d nt want t mnitr, add them t the D nt include files that match the mask list. T remve a file frm the list, click the file, then click Remve. 18. T use system functins t determine the changes when a file is mdified, select the Attempt t aut-detect changes in mnitred flder check bx. If the check bx is cleared, CuteFTP cycles thrugh the flder at the rate defined by Mnitr flder every n secnds and lks fr changes t the mdified time-stamp. 19. Click Next. 20. Click Finish. T later stp mnitring the flder, start the wizard again. The list f mnitred flders appears n the first page f the wizard. (Yu may have t discnnect and then recnnect fr the mnitred flders t appear.) Yu can als right-click the jb in the Queue, then click Prperties. If yu right-click in the Queue, then click Remve All, yu will remve yur Flder Mnitr Rules! Items deleted frm the lcal flder are nt deleted frm the remte flder. T discntinue a scheduled backup task, select the task in the Queue windw, then n the main menu, click Tls > Queue > Remve Selected. 167

168 CuteFTP v9 User Guide Listing Files n HTTP Sites T list files n HTTP Sites 1. Cnnect t an HTTP Site within CuteFTP. 2. Files n the Site will be listed in the remte pane. When yu cnnect t HTTP Sites in CuteFTP, the Sites d nt list file sizes, attributes, r dates like FTP Sites d. This is because HTTP listings are nt actual lists f files n the server. CuteFTP dwnlads the server's index.html file and parses it, lking fr links. Each link is then listed as an available file in the HTTP Site's windw. Because this is nt an actual file listing, there may be files n the HTTP Site nt accessible t CuteFTP. Als, sme f the files may just be links that lead t anther HTTP Site. If yu cnnect t an HTTP Site that des nt supprt the listing f flder cntents, CuteFTP attempts t guess the cntents f the HTTP server by scanning its Web pages. 168

169 Chapter 10. Integrated HTML Editr The tpics belw prvide instructins fr using CuteFTP's built-in HTML editr. HTML Editr Overview CuteFTP has a built-in HTML editr with which yu can edit HTML and ther ASCII (text)-based dcuments. The built-in editr was added primarily fr remte file editing t enable yu t select a dcument n the remte Site, pen it in the editr, make edits, and then save the dcument in the remte lcatin. Yu can als use it t edit dcuments lcally. Yu d nt have t use the HTML Editr. Yu can cnfigure a different editr, such as Ntepad r EditPlus, t pen HTML dcuments. T pen the HTML Editr D ne f the fllwing: On the main menu, click File > New > HTML Dcument. In either the Lcal r Remte pane, right-click an HTML dcument, then click Edit. The HTML Editr pens in a new tab. Tags are in different clrs frm text t make it easier t read. Refer t HTML Editr Settings fr details f cnfiguring the Editr. HTML Editr Settings CuteFTP cmes with a built-in HTML editr with which yu can view and edit HTML files bth n yur lcal drive and n remte servers. Alternatively, yu can specify a third-party applicatin t view and edit files (such as Ntepad, EditPlus, Micrsft Frnt Page, and s n). Nte the difference between Opening and Viewing a file: On the main menu, click File > Open (r press CTRL+E). The file pens in yur brwser (e.g., Internet Explrer). On the main menu, click File > View (r press CTRL+W). The file pens in the HTML editr that yu specify in the Helper Applicatins nde. If yu are using the built-in HTML editr, the file pens in the right pane, shwing the HTML cde. (Yu can change frm tabbed view t full screen n the HTML Editr settings page.) 169

170 CuteFTP v9 User Guide On the main menu, click File > Edit (r press CTRL+ENTER). The file pens in the HTML editr that yu specify belw. If yu are using the built-in HTML editr, the file pens in the right pane, shwing the HTML cde. (Yu can change frm tabbed view t full screen n the HTML Editr settings page.) If yu pen an HTML file in the built-in HTML editr by clicking File, then clicking View, yu can still edit and save the file. T access Helper Applicatins 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Helper Applicatins nde. The Helper Applicatins ptins appear. 3. Cnfigure ptins as described belw. T view files in CuteFTP's built-in HTML editr, select the Use the integrated HTML editr t view files check bx. T specify the applicatin in which t view files, in the File Viewer bx, clear the check bx, then brwse fr r type the path t the prgram yu want t use. T pen files fr editing in CuteFTP's built-in HTML editr, select the Use the integrated HTML editr t edit files (recmmended) check bx. The HTML cde fr the file appears in the right pane. (Yu can change frm tabbed view t full screen n the HTML Editr settings page.) On the main menu, click File, then click Save (CTRL+S) r Save As t save yur changes. T pen files fr editing in anther editr, clear this check bx, then in the File editr bx, brwse fr r type the path t the prgram yu want t use. When yu edit remte files in a third-party editr, CuteFTP launches the editr and then mnitrs the flder cntaining the temprary file being mdified. After yu save yur changes, CuteFTP uplads the changes t the server. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. T view r edit HTML Editr settings 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Helper Applicatins nde, then click HTML Editr. The HTML Editr ptins appear. 3. Cnfigure ptins as described belw. T display the editr in full screen, select the Display editr using Full Screen view check bx. T display the editr as a tab in the CuteFTP windw, clear the check bx. By default, CuteFTP displays the HTML editr in tab view mde. T add line breaks at the right end f lng lines, s that yu can see entire lines f cde withut scrlling t the left r right, select the Enable wrd wrap check bx. Clear this check bx and the HTML editr will use line breaks where yu add them. Yu might have t scrll t the right t see the ends f lnger lines f cde. T display numbers at the beginning f each line f cde, select the Prefix each line with line numbers check bx. If wrd wrap is enabled, the numbers will nly display after line breaks yu have entered. The line numbers are nt saved as part f the dcument. Clear this check bx and n line numbers will be displayed. 170

171 Integrated HTML Editr T allw the cursr t keep mving t the right after the last character in a line, select the Allw editing beynd the end f line check bx. Clear this check bx t frce the cursr t return t the left end f the fllwing line after the last character in a line. (The Allw editing beynd the end f line check bx is nly available if Enable wrd wrap is cleared.) If yu disable Allw editing beynd the end f line, yu can still add mre characters after the right-mst character. T specify the number f spaces yu want the cursr t mve t the right when yu hit the TAB key, in the Tab size bx, type a number frm 1 t 32. T change the HTML cde and text that is generated autmatically when yu start a new dcument in the HTML editr, click Edit new dcument template. The template appears fr yu t edit. When yu have finished making changes, click Clse. T specify the type, style, and size f the fnt displayed in the HTML Editr, click Chse fnt fr editr. After yu make changes, click OK; t abrt the changes, click Cancel. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. T specify display clrs fr HTML tags and Perl scripts 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Helper Applicatins nde, expand the HTML Editr nde, then click Clrs. The HTML Editr Clrs ptins appear. 3. Cnfigure ptins as described belw. Fr each HTML tag set and fr Perl script cmpnents, select a clr frm the drp-dwn lists. T use the system default clrs fr the backgrund (white) and text fnt (black), select the Use system settings check bx. T chse different clrs fr the backgrund and text fnt, clear the Use system settings check bx, then in the Backgrund and Text fnt drp-dwn lists, specify the clrs. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. Default HTML Template All HTML dcuments shuld cntain the fllwing tags: Dcument Type <HTML></HTML> (beginning and end f file) Header <HEAD></HEAD> (after the HTML tag, but befre the BODY tags, includes descriptive inf, such as title) Title <TITLE></TITLE> (must be in header) Bdy <BODY></BODY> (after the HEAD tags, bulk f the page) When yu create a new HTML dcument with CuteFTP's HTML Editr, it uses the default HTML template shwn in the New dcument template dialg bx. T pen the default HTML template 1. On the main menu, click Tls > Glbal Optins. The Glbal Optins dialg bx appears. 171

172 CuteFTP v9 User Guide 2. Expand the Helper Applicatins nde, then click HTML Editr. 3. Click Edit new dcument template. The New dcument template dialg bx appears. Each f the tags shwn in the template are required, except fr the META tags. The attributes in the Bdy tag, BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080", define the backgrund clr (BGCOLOR is white), text clr (black), and the clrs f hyperlinks (blue) and visited hyperlinks (dark magenta) in the dcument. 4. Add/remve tags r edit attributes that yu want t appear in each f yur new HTML dcuments, then click Clse. The changes are saved when yu clse the dialg bx. A link t yur style sheet is ne tag yu might want t add t yur default template. HTML Tags fr a Specific Brwser The HTML Editr can autmatically prvide suggestins fr HTML tags that wrk fr specific brwsers. The HTML Editr ffers HTML tag chices in drp dwn bxes. These are called tag tips. T shw tag tips 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 1. Expand the Helper Applicatins nde, expand the HTML Editr nde, then click Tag tips. The HTML Editr Tag tips ptins appear. 172

173 Integrated HTML Editr 2. T shw tag tips, select the Shw tag tips check bx. Clear the Shw tag tips check bx t keep tag tips hidden. T specify hw lng the tag tips take t appear, in the Tag tips delay in millisecnds bx, type a time fr the HTML editr t wait befre shwing tag tips. T capitalize all tag tips, select the Capitalize tag tips check bx. Clear the Capitalize tag tips check bx t leave tag tips in lwer case. 3. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. HTML Cde Snippets and Java Scripts T specify the flder fr cde snippets and previewing HTML dcuments frm CuteFTP 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Helper Applicatins nde, expand the HTML Editr nde, then click Flders. The HTML Editr Flders ptins appear. 3. Cnfigure ptins as described belw. T specify a brwser ther than the default, clear the Preview using the default brwser check bx, then in the Brwser path bx, brwse fr r type the path t the brwser executable file. T specify the flder in which yu want t stre cde snippets, in the Cde snippets bx, brwse fr r type the path. T specify the flder in which yu want t stre Java scripts, in the Java scripts bx, brwse fr r type the path. 4. Click Apply if yu are ging t make changes t ther pages; click OK t save changes and clse the Glbal Optins dialg bx. 173

174 CuteFTP v9 User Guide Creating a New HTML Dcument Yu can create new HTML dcuments within the CuteFTP interface. T create a new HTML dcument 1. D ne f the fllwing: On the main menu, click File > New > HTML Dcument. On the HTML Editr tlbar, click the New HTML dcument icn. Press CTRL+H. A new HTML dcument appears in which yu can use HTML tags t create the dcument. 2. Type the cntent f yur HTML dcument, that is, the part yu want yur viewers t see, between the tw BODY tags. Every HTML dcument must cntain, at minimum, the tags in the default HTML template. The template as is will display a blank page. 3. T change HTML editr settings, including editing the default template, and pening in full view instead f tab view, refer t HTML Editr Settings and Editing the Default HTML Template. Finding and Replacing Text in HTML Dcuments Using the integrated editr's pwerful search and replace tl, yu can search and replace characters, wrds, sentences, r entire paragraphs T pen search and replace 1. Click within the HTML Editr pane, then n the main menu, click Edit, then click Find/Replace (r press CTRL+F). The Find/Replace dialg bx appears. 2. In the Search fr bx, type the wrds t search fr r change. 3. In the Replace with bx, type the replacement wrds r phrase. When entering text int the Search fr r Replace with fields, use Ctrl+Enter t insert a line break. 4. In the Where t search area, specify whether t search nly the selected dcument r all pen dcuments. 5. If yu want t match upper r lwer case (depending n which yu have typed in the bxes abve, select the Match case check bx. 6. Click Find. 7. If a match is fund, it is replaced. T cntinue t search and replace thrughut the dcument, select Find Next fr each instance (r press F3). Because it replaces all ccurrences, be very careful when chsing the replace ptin. Fr example, if yu want t change all ccurrences f 'ne' t '1', it will als change wrds like 'everyne' t 'every1'. 174

175 Integrated HTML Editr Page Lading Speed and File Size The Dcument Data dialg bx prvides infrmatin abut the dcument currently being edited, including file size and hw fast the page will lad at varius speeds. T pen the Dcument Data dialg bx 1. Click within the HTML Editr pane t ensure that it is the active pane. 2. On the main menu, click Tls, then click Dcument Data. The Dcument Data dialg bx appears. 3. Click the Weight drp-dwn menu t view the dcument infrmatin at different bit rates: 14.4, 28.8, 56.6 bps. The Text Size area displays the ttal size f text cntained in the dcument, in kilbytes. The Image Size area displays the ttal size f images cntained in the dcument, in kilbytes. The Ttal Size area displays the ttal size f text and images cmbined, in kilbytes. The Weight area displays the apprximate number f secnds yur page will take t lad based n the size f the file and the mdem speed f yur viewers. Click the dwn arrw n the mdem speed bx t see hw sn the page displays at varius speeds. The Images bx displays a list f all images in the dcument. The Anchrs bx displays a list f all anchrs in the dcument. 2. If the number f secnds in the Weight area seems excessive, yu can shrten the time it takes t display yur page by ding sme r all f the fllwing: Remve excess cde r text, r use smaller graphics files. If yu are using graphics t display bullets in lists, remve the images used fr the bullets, and instead use list tags t create lists. Yu will als have fewer files t transfer and maintain if yu eliminate the graphic bullets. Use a style sheet (CSS file) and link each f yur pages t the style sheet. Yu will need fewer tags within each dcument, creating smaller files with a faster uplad speed. Style sheets als create a "cnsistent lk and feel" fr yur website. Fr mre infrmatin abut using style sheets, refer t 175

176 CuteFTP v9 User Guide Review yur cde fr extra tags that yu d nthing t enhance yur page. Fr example, this <P> </p> r this <P> </p> makes a paragraph space between paragraphs. If yu d nt need the extra space, yu can remve it; hwever, adding "white space" such as this ften enhances readability. Use tables r <blckqute> </blckqute> t indent paragraphs, rather than using multiple (nn-breaking space) tags t indent text. Basic HTML Tags All HTML dcuments shuld cntain the fllwing tags: Dcument Type <HTML></HTML> (beginning and end f file) Header <HEAD></HEAD> (after the HTML tag, but befre the BODY tags, includes descriptive inf, such as title) Title <TITLE></TITLE> (must be in header) Bdy <BODY></BODY> (after the HEAD tags, bulk f the page) When yu create a new HTML dcument with CuteFTP's HTML Editr, it uses the default HTML template. Yu can change the attributes as yu see fit. Tag text is clr cded t make the HTML easier t read. Yu can change the default clrs in the HTML editr in Glbal Optins. Fr example, the HTML cde fr that last sentence lks like this: Yu can <a href="helper_applicatins.htm">change the default clrs</a> in the HTML editr in <span style="fnt-weight: bld;">glbal Optins</span>. T insert a paragraph 1. Click in the dcument where yu want t insert a paragraph, then type <p></p> 2. Type text between the paragraph tags. Fr example, type: <p>welcme t my wnderful website!</p> It desn't matter if yu type the tag with lwercase r capital letters. The HTML Editr tlbar allws yu t insert basic HTML tags int yur page, withut any prir knwledge f HTML cde. T frmat text Select the text yu want t frmat, then d ne f the fllwing: T bld the text, click the Bld icn. T italicize the text, click the Italic icn. T underline the text, click the Underline icn. T frmat the fnt face, size, and clr, click the Fnt icn. In the Fnt tag dialg bx, click the dwn arrw t specify the Fnt (e.g., Arial), Clr (e.g., Red), and Size (e.g., 1). As a base fnt size fr a dcument, 1em (r 100%) is equivalent t setting the fnt size t the user's preference. Avid sizes in em smaller than 1em fr text bdy, except fr cpyright statements r ther kinds f "fine print." D nt specify the fnt size in pt, r ther abslute length units. They d nt appear the same n all cmputers and cannt be resized by the brwser. 176

177 Integrated HTML Editr T insert a table Click the Table icn then n the graphic that appears, use yur cursr t highlight the number f rws and clumns yu want. When yu click the selectin, the table tags appear in yur dcument. Type the cntent fr each cell between the tags. (Tip: Click the Brwser icn t preview hw the table will lk.) Yu can even insert images int the table. T insert an image 1. Click the Image icn. The Image tag dialg bx appears. 2. Specify the lcatin f the image, then click OK. The steps abve are sufficient t insert an image; hwever, yu can experiment with the advanced settings when yu are cmfrtable in HTML. Regarding the Width and Height bxes, it is better fr page lading if yu size the graphic itself prperly in yur graphics editr, rather than adjusting the size with Width and Height attributes. Inserting a huge graphic and then dwnsizing it with the Width and Height attributes will cause yur page t lad very slwly (and yur viewers t leave yur website!). T insert a hyperlink 1. Select the text that yu want t make a link. 2. Click the Hyperlink icn. The Hyperlink tag dialg bx appears. 3. In the HREF bx, type the URL t which yu want t link the highlighted text. 4. In the Target bx, click an attribute: _blank - the target URL pens in a new windw _self - the target URL pens in the same windw _parent - the target URL pens in the parent frame _tp - the target URL pens in the full bdy f the windw 5. In the Name bx, type a name fr the tag (ptinal). 6. Click OK t insert the tag. T insert a cmment Cmments are used t ntate yur cde t remind yurself why yu inserted a particular element, r fr team members editing the same dcuments. Click the Cmment icn. The Cmment tags are inserted int the dcument. Type yur cmment between <!-- and -->. 177

178 CuteFTP v9 User Guide Cascading Style Sheets (CSS) Cascading Style Sheets (CSS) are used t define the attributes f the tags in yur HTML dcuments. Althugh nt required, they make designing and, mre imprtantly, updating HTML dcuments much mre efficient. Fr example, if yu have defined the BODY tag in a linked style sheet t display the page with a white backgrund and black text, yu can change the backgrund t yellw in ne file--the style sheet--and that change appears in every ne f yur HTML dcuments that are linked t that style sheet. Yu can als have mre than ne style sheet if yu want different sectins f yur site t have a different lk. When yu use a style sheet, yu d nt need t add the attributes fr the BODY tag t every single HTML dcument. The BODY tag is defined in the style sheet and each f yur Web pages cntain a link t the style sheet. The link t yur style sheet is ne tag yu might want t add t yur default template. Fr example, if yur style sheet is named default.css, yu wuld add the fllwing tag between the <HEAD></HEAD> tags f yur default template, after the META tags: <link rel="stylesheet" href="default.css"> In the example abve, the style sheet is placed in the same directry as the HTML dcuments t which it is linked; therwise, yu need t add a path t the style sheet in the link. Fr example, if yur HTML dcuments are in a flder called htms and yur style sheet is in a flder called css, and bth f thse flders are in a flder called myweb, yu wuld type the link as fllws: <link rel="stylesheet" href="../css/default.css"> The../css/ part f the tag (red text shwn fr emphasis nly) tells CuteFTP t search up ne directry and lk in the css directry fr the file. Yur style sheet can cntain tags fr just ne r several tags, such as default paragraph fnt face, size, clr, and margins, table frmat, heading styles, headers, fters, and s n. 178

179 Integrated HTML Editr Using Clrs In HTML dcuments, when yu want t change the fnt clr, yu have t type a hexadecimal value fr the clr. The cde is in hexadecimal with a pund sign and 6 characters frm 0 (zer) t F (fifteen in hexadecimal). Sme f the mst cmmn clrs are shwn belw; hwever, the Clr utility in CuteFTP eliminates the need t memrize the HTML cdes fr clrs. Clr Name Hex Cde RGB (Red, Green, Blue) Values black # ,0,0 white #FFFFFF 255,255,255 red #FF ,0,0 blue #0000FF 0,0,255 green #00FF00 0,255,0 yellw #FFFF00 255,255,0 T pen the clr ptins 1. Click within the HTML Editr pane at the lcatin where yu want t paste the hexadecimal clr cde. 2. On the main menu, click Tls > Clr t HEX. (This ptin is nt available if yu d nt click within the HTML Editr pane first.) The Clr dialg bx appears. 3. Click the clr t use. 4. If yu want t use brwser-safe clrs nly, select the Paste brwser safe clr check bx. 5. Chse OK t insert the HEX cde fr the selected clr int yur dcument. Fr example: <p><fnt clr="ff0000">text</fnt> Fr mre infrmatin abut using clrs in HTML dcuments, as well as a chart f many different clr cdes, refer t 179

180 CuteFTP v9 User Guide Saving HTML Dcuments Befre attempting t save a dcument, make sure the file yu want t save is visible in the right pane. T save the in its current lcatin with its current name D ne f the fllwing: On the main menu, click File > Save. On the HTML editr tlbar, click the Save icn. Press CTRL+S. Right-click within the HTML dcument, click File > Save. If the file has never been saved befre, CuteFTP pens the Save As dialg bx. T save the file with a new name and/r lcatin D ne f the fllwing: On the main menu, click File > Save As. Right-click within the HTML dcument, click File > Save As. In the Save As dialg bx, specify the file name and lcatin, then click Save. T save all pen HTML dcuments at the same time a. On the main menu, click File > Save All. All pen dcuments are saved. If yu have nt saved all f them previusly, the Save As dialg bx appears fr each new file. b. Specify a name and lcatin fr each new file, then click Save. Each pen HTML dcument has a tab with its name n it. Opening an HTML Dcument fr Editing Yu can pen HTML dcuments fr editing within CuteFTP. T pen an HTML dcument fr editing 1. D ne f the fllwing: On the main menu, click File > Open file (r press CTRL+O). In the Open dialg bx, brwse t and select the dcument, then click Open. In the Lcal Drives r Remte pane, right-click the dcument, then click Edit. 2. The dcument pens in the editr that yu have specified in HTML Editr Settings. When yu edit the dcument in the HTML editr, the file name text in the tab turns red and is underlined t indicate that the file has been mdified. 180

181 Integrated HTML Editr Previewing an HTML Dcument in a Brwser Frm within CuteFTP, yu can pen an HTML dcument in yur default brwser. T change yur default brwser, pen the brwser that yu want t be yur default, then specify in the brwser that it is the default. (When yu pen Internet Explrer r Firefx and it is nt the default brwser, it will ask yu t make it the default, usually by clicking Yes r selecting a check bx.) T preview an HTML dcument in a brwser 1. Open an HTML dcument in CuteFTP. 2. Click anywhere in the dcument, then d ne f the fllwing: T clse the preview On the main menu, click Tls > View in Brwser. On the HTML editr tlbar, click View in Brwser. D ne f the fllwing: In the upper-right crner f the brwser windw, click Clse. On the main menu f the brwser, click File > Clse. T use a brwser ther than the default brwser 1. In the Glbal Optins dialg bx, expand the Helper Applicatins nde, then expand the HTML Editr nde. 2. Click the Flders nde. 3. In the Preview in brwser area, clear the Preview using the default brwser check bx. 4. In the Brwser path bx, specify the path t the brwser yu want t use. 5. Click OK t save the changes. Editing an HTML Dcument n a Remte Site T edit HTML dcuments n a remte Site 1. Cnnect t a remte server. 2. In the Remte pane, click an HTML dcument. 3. D ne f the fllwing: On the main menu, click File > Edit. Right-click the file, then click Edit. Press CTRL+ENTER. 4. The dcument will be dwnladed and pened in the built-in HTML editr r the editr yu have defined in Glbal Optins. 5. Make yur changes t the dcument, then save the changes. The saved dcument will be upladed t the remte server. When yu edit the dcument in the HTML Editr, the file name text in the tab turns red and is underlined t indicate that the file has been mdified. 181

182 CuteFTP v9 User Guide Printing an HTML Dcument T print a dcument 1. Open a dcument in the HTML editr. 2. D ne f the fllwing: On the main menu, click File > Print. Press CTRL+P. T see a print preview The dcument prints as it appears in the HTML editr, NOT as it appears in a brwser. 1. Open a dcument in the HTML editr. 2. On the main menu, click File > Print Preview. The Preview dialg bx appears. 3. D ne r mre f the fllwing: T increase/decrease magnificatin, click Zm In/Zm Out. T display tw pages at a time, click Tw Page. T scrll thrugh multiple pages, click Next page and Prev Page. T send the dcument t the printer, in the preview dialg bx, click Print. Click Clse t clse the dialg bx. T change the printer setup (such as the printer, paper size r rientatin) 1. Open a dcument in the HTML editr. 2. On the main menu, click File > Print Setup. The Print Setup dialg bx appears. 3. Specify the printer, printer prperties, paper size, paper surce, and rientatin, then click OK t accept, r Cancel t abrt changes. While a dcument is printing, a printer icn appears next t the clck n the task bar. When this icn disappears, yur entire dcument has been sent t the printer. Clsing an HTML Dcument T clse an HTML dcument 1. Make sure the dcument yu want t clse is visible in the right pane. 2. D ne f the fllwing: On the main menu, click File > Clse. In the upper-right crner f CuteFTP, click Clse. Right-click within the HTML dcument click File > Clse. At the tp f the HTML dcument, right-click the tab, then click Clse. 182

183 Integrated HTML Editr 3. If yur dcument has unsaved changes, yu are prmpted t save the changes. Click ne f the fllwing: Yes t save the dcument. N t exit withut saving the dcument. Cancel t return t the dcument withut saving the dcument. Opening the HTML Editr in a Full Windw The HTML editr pens in the Remte pane r a full windw, depending n the selectin in Glbal Optins. T pen an HTML dcument in the Remte pane r a full windw 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Helper Applicatins > HTML Editr. The HTML Editr ptins appear. 3. Select r clear the Display editr using Full-Screen view check bx. In Full-Screen view, the editr in pens in the full CuteFTP windw. T clse Full-Screen view, click the in the upper-right crner r n the main menu, click File, then click Clse. The CuteFTP interface will reappear. Adding Cunters and Other Utilities Glbalscape des nt ffer supprt fr creating r cding advanced HTML. If yu want t add cunters, animatins, r ther special effects t a Web page, yu will need t seek ther surces. Many Web hsting services prvide extras, such as cunters, that yu can add t Web pages hsted n their servers. Usually, the cde that they prvide yu t paste int yur Web page links t cde stred n their server, s the same cde might nt wrk if yu mve yur Web page t a different server. Search yur Web hsting prvider's Web pages t see if they ffer cde fr cunters r ther add-ns. Learning HTML HTML cde uses tags t define hw text, pictures, and ther bjects are t appear in a Web brwser, such as Internet Explrer. Numerus websites explain HTML tags and hw t use t use them. Like sftware applicatins, HTML cde cmes in versins, sme f which are nt supprted by cmmn brwsers. Fr the mst current versin f HTML cde that is supprted by mst cmmn brwsers, search the Web fr free guides and tutrials. The Wrld Wide Web Cnsrtium, a cperative f Web develpers and designers, prvides standards fr HTML and CSS cde, as well as tutrials fr beginners and advanced users. While yu search fr tutrials abut hw t cde yur Web pages, keep in mind that, althugh mst brwsers supprt HTML v4, many Web develpers have mved n t XHTML, which is a mre strict versin f HTML. Als, mst websites nw use cascading style sheets (CSS) t help maintain a cnsistent design acrss all Web pages n the Site, and allw yu t update an entire website design simply by changing ne file, the style sheet. Here are a few references t get yu started: Getting started with HTML W3 Schls (Web building tutrials fr beginners t develpers) Intrductin t HTML, including listings f cmmn tags 183

184 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 184

185 Chapter 11. Transfer Engine (Scripting) The tpics belw prvide the prcedures fr using the Transfer Engine. Abut the Transfer Engine CuteFTP's FTP Transfer Engine (TE) is cmpletely independent f the main applicatin's interface. The Transfer Engine (TE) runs invisibly in the backgrund and des mst f the real wrk that CuteFTP des. The TE prgram allws features such as scheduled transfers t perate in the backgrund while the CuteFTP interface is clsed. In CuteFTP, yu can interact with the Transfer Engine thrugh an industrystandard COM (Cmpnent Object Mdel) interface using yur favrite prgramming r scripting language, such as Visual Basic, Perl, ASP r JavaScript. The Transfer Engine: Is COM enabled Takes up minimal resurces Handles backgrund transfers Handles transfers utside the main interface Handles cntinuus flder synchrnizatin events Can be used with a custm applicatin r script t perfrm FTP related tasks. CuteFTP relies n tw executables fr file transfers: Cuteftppr.exe is the CuteFTP interface ftpte.exe is the Transfer Engine (TE) The Transfer Engine requires an NT lgin and will nt run as an NT service; hwever, it is cnfigured by default t start n Windws startup. Yu can change this setting in the CuteFTP interface Glbal Optins dialg bx. Sme f the actins yu can accmplish using the TE include: Lg in t an FTP server ver a defined prt Lg in using an encrypted authenticatin mechanism, such as OTP Lg in and transfer files using industry standard SSL/TLS (explicit & implicit mdes supprted) Lg in and transfer files using SSH2 Lg in t Sites thrugh Firewalls r Scks r Prxy servers Transfer files ne at a time r simultaneusly Transfer files using multi-part transfers t increase thrughput Transfer files frm ne remte Site t anther Transfer files using a wildcard mask Transfer files btained frm server-side links Perfrm flder synchrnizatin tasks Check n an item's transfer status 185

186 CuteFTP v9 User Guide T access Transfer Engine features The Transfer Engine starts when the CuteFTP interface pens r n Windws startup when selected in the CuteFTP interface. When the Transfer Engine is started, its icn appears in the Windws system tray. Right-click the TE icn in the Windws system tray. The Transfer Engine menu appears. (Certain features are nly available when the CuteFTP interface is clsed.) T view infrmatin abut the Transfer Engine, including yur serial number, click Abut. T pen the CuteFTP interface, click Launch CuteFTP interface. T access the current dwnlad queue (nly visible if the CuteFTP interface is clsed), click Shw current Transfers. The Transfer Queue appears. (Yu can als pen the Transfer Queue by duble-clicking the TE icn.) T dwnlad frm a Site by typing the URL, click Dwnlad URL. The Transfer Queue displays each item queued fr transfer. Fr example, if yu are mnitring a flder fr changes and scheduled them fr uplading t a remte lcatin, the queue displays each item and its prperties. Yu can specify which prperties t hide r display by right-clicking n the header f the queue. All prperties are selected by default. Clear the check bx t hide a prperty. Arrange the clumns by clicking and dragging the clumn header. T dwnlad frm a specific URL, click Dwnlad URL. T activate a new serial number, click Enter Serial Number. (Nt available when the CuteFTP interface is pen. T activate a serial number when the interface is pen, click Help, then click Enter a Serial Number.) T request yur serial number frm Glbalscape Supprt, click Find Lst Serial Number. The Glbalscape Supprt Lst Serial Number request web page appears. (Nt available when the CuteFTP interface is pen. T request yur serial number when the interface is pen, click Help, then click Lcate a Lst Serial Number.) If yu are using a trial serial number and want t purchase a license, click Hw t Purchase. The Purchase CuteFTP web page appears. (Nt available when the CuteFTP interface is pen. T purchase CuteFTP when the interface is pen, click Help, then click Purchase Nw.) T clse the TE, click Exit Transfer Engine. Transfer Engine Licensing Requirements The TE is licensed with CuteFTP. The TE is a cmpnent f CuteFTP, therefre any cmputer with a licensed cpy f CuteFTP can access the TE thrugh the CuteFTP interface r thrugh its COM interface. 186

187 Transfer Engine (Scripting) Transfer Engine (TE) Initial Setup The Transfer Engine bject must be registered as a COM cmpnent n the target system. The TE autmatically perfrms COM registratin if it has been manually executed (run nce) prir t a script r applicatin instantiating (calling) the TE bject. In rder t run script files, yu must have the Windws Scripting Hst (WSH) installed. WSH relies n the Visual Basic Script and JavaScript engines prvided with Internet Explrer 3.0 r later. WSH is als installed as a part f Windws 98, Windws 2000, and Internet Infrmatin Server (IIS) 4.0. T register the TE COM cmpnent D ne f the fllwing: Launch CuteFTP, then clse CuteFTP. In the CuteFTP installatin flder, duble-click ftpte.exe, right-click the TE icn in the system tray, then click Exit Transfer Engine. It shuld nw be registered. Once the TE is registered, yu can create script files t interface with it. Yu can create yur wn scripts r use the scripts included in this user guide, mdifying the script t suit yur needs. Distributing and Licensing the Transfer Engine If yu have created a script r applicatin that calls the TE, yu may wish t distribute yur script r applicatin t a grup f end-users. CuteFTP's Transfer Engine (TE) is subject t End User License Agreement and can nly be distributed in its current frm (evaluatin sftware). Hwever yu can purchase a license fr and register the trial versin f the TE n each cmputer yu install it n. Then, yu must cnfigure the TE s that it can run prperly withut the CuteFTP GUI (interface) installed, especially if yu plan t run autmated r scheduled tasks while nt lgged in, r if yu plan t cnnect t SSL enabled FTP servers. Cntact Glbalscape and request special licensing arrangements when distributing t large amunts f users. Licensing - Steps t License the TE 1. Determine hw many cpies (seats) yu will need. 2. G t 3. Click the Purchase link. 4. Purchase ne license fr each seat yu need. If yu need t purchase a license t cver a large number f seats, please cntact Glbalscape supprt. 5. Once registered, check yur fr the serial number. Licensing Cnsideratins The TE inherits its registratin prcess frm CuteFTP. If running n a system that has a registered cpy f CuteFTP installed, yu d nt need t register the TE. If CuteFTP is nt installed (r registered), yu must register the TE. 187

188 CuteFTP v9 User Guide The TE runs thrugh a 30-day trial just like CuteFTP. Therefre, the TE may be distributed ryalty-free with unlimited runtimes fr 30 days frm the time it is installed n an end-user's cmputer. After residing 30 days n the target cmputer, it disables itself if nt prperly registered. The TE must be registered either prir t first launch, during the trial, r after the trial has expired. When yu purchase a license fr CuteFTP yu may NOT distribute CuteFTP r any f its subcmpnents (such as the Transfer Engine) in an unlimited ryalty free fashin. Each cpy f the distributed Transfer Engine must be licensed fr each cmputer where it is installed. This means yu must purchase a full license f CuteFTP fr each distributed cpy f the TE. Yu can purchase the necessary amunt f licenses up frnt r after the TE has expired n the end-user cmputer. The benefit f licensing up frnt is that yu can distribute the TE and register it n the end-user's cmputer. They will nt see any prmpts r registratin related dialgs. Once yu have licensed the TE, yu must install it (if nt already installed) and then register it n each target cmputer. Yu are nt permitted t distribute the TE as a cmpnent f an FTP client r ther prduct that cmpetes with CuteFTP r Glbalscape's EFT Server. Installing the TE (fr Distributin) Yu d NOT need t install the full cpy f CuteFTP n the end-user's cmputer. If yu were distributing a custm-made applicatin, this wuld nt be the case. Installatin - Steps t Install the TE 1. Lcate the TE cmpnent (ftpte.exe), the End User License Agreement (license.txt), and the TE's subrdinate dynamic link libraries (sftp21.dll, ssl.dll, etc.) and the resurce file (default.lng) n yur develper (surce) cmputer. 2. Package the TE alng with the ther items mentined in step 1, alng with yur installatin prgram, script, r executable. Fr setting specific ptins nly available thrugh the GUI (that is, n prperty r methd available), yu can cpy specific registry settings frm the surce cmputer t the destinatin. Mst all settings are stred in the registry under the fllwing hive: HKEY_CURRENT_USER\Sftware\Glbalscape\CuteFTP Registering the TE (fr distributin) Yu can register the TE autmatically r manually using the prcedures belw. Registratin - Autmated Registratin The first methd f registering the TE is the mst efficient when dealing with a large amunt f target systems, r when yu d nt have direct access t the target system. Yur applicatin installer r script can perfrm the steps belw t transparently register the TE. 1. Purchase a license fr the amunt f TE seats that yu want t distribute. 2. Install a cpy f the Transfer Engine and related cmpnents nt the target cmputer. 3. Create a new registry key n the target cmputer at the fllwing lcatin: HKEY_USERS\.DEFAULT\Sftware\Glbalscape\CuteFTP\Index 4. Create a new string value in the key abve and insert the serial number as the data value. 188

189 Transfer Engine (Scripting) String Value = "1" Data = "[Yur Serial Number]" 5. When the transfer engine is called fr the first time, it retrieves this value (the serial number) and uses it t cmplete the registratin with Glbalscape. The target cmputer must have access t the Internet. If n Internet access is available, the registratin prcess may fail and disable the TE. The TE is autmatically registered if it is installed nt a cmputer with a registered cpy f CuteFTP. Keep in mind that the TE must be the same versin as CuteFTP. Registratin - Manual Registratin If yu have physical access t the target cmputer r want t register the cpy installed n yur develper cmputer, d the fllwing: 1. Right-click the TE icn in the system tray t display the cntext menu (while running, the TE is represented by a yellw flder icn with up and dwn arrws), then click Enter Serial Number. 2. Paste r type the serial number, then click Register. A message shuld appear declaring that the registratin was successful. The TE can nw be used n that cmputer withut interruptins. If yu receive an errr message, verify that the serial number was typed crrectly and that the number f licensed cmputers des nt exceed the licenses purchased. If all this is crrect and yu are still unable t register, cntact the Glbalscape supprt department and prvide them with the exact details f the errr received. COM Registratin f the TE (fr Distributin) As a typical COM cmpnent, the TE must be registered as such n the target system. The TE autmatically perfrms COM registratin if it has been manually executed prir t a script r applicatin instantiating the TE bject. The preferred methd (fr distributed versins f the TE n end-user's systems) is t set the apprpriate registry entries befre trying t call the TE. COM Registratin via the Registry Frm yur installatin prgram, script, r custm applicatin, write the registry entries belw t the target cmputer. The entries are shwn in the standard.reg file ntatin. Include the crrect the path t the Transfer Engine (/[installpath]/ftpte.exe) where %MODULE% is shwn belw. Windws Registry Editr Versin 5.00 Class" Class" 189

190 CuteFTP v9 User Guide Class" "AppID"="{DA15006A-FADA-495b-9A0C-EC2107E2FB9F}" [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{112EA537-7AB9-4e22-8BFB- Files\\Glbalscape\\CuteFTP 8 Prfessinal\\ftpte.exe\"" [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{112EA537-7AB9-4e22-8BFB- [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{112EA537-7AB9-4e22-8BFB- 7FD5FCB19849}\Prgrammable] [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{112EA537-7AB9-4e22-8BFB- [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{112EA537-7AB9-4e22-8BFB- Finalizing TE Distributin Once the TE has been licensed, installed, registered, and COM registered n the target system, yur script r custm applicatin shuld be able t instantiate the TE bject, and invke any ne f the supprted methds r prperties. Fr a cmplete descriptin f the TE, including its supprted methds and prperties, sample scripts and extended truble shting guide, please refer t the related tpics in this user guide and ur nline knwledgebase. Trubleshting TE Distributin Described belw are sme cmmn issues encuntered when distributing the TE. Prblems with running scripts while nt lgged in (suppressing message prmpts r dialgs) Yur script shuld nt cntain Message Bx functins r any ther functin that requires user input r shws a dialg bx. These prmpts d nt display when the system is nt lgged in. Yu can physically suppress prmpts frm ever appearing. Use the nprmpts flag and execute the TE frm the shell n the target cmputer befre calling it frm the script. Fr example, run c:\prgram files\mycustmapp\ftpte.exe nprmpts. Suppressing prmpts may cause lckups if n default actin is available fr the event in questin, r if the prmpt was prduced by an errr. The best way t avid prmpts is t prperly cnfigure the TE ahead f time t cver all pssible prmpt scenaris, such as verwrite cnditins, r SSL server certificate acceptance dialgs. Fr example, set yur verwrite actins under CuteFTP's glbal settings t Always Overwrite t avid any verwrite prmpts, r pre-define varius rules t cver varius verwrite scenaris. Yu can then exprt thse rules as registry entries and imprt them nt the target cmputer. Yu can als tell the TE t aut-accept SSL r SSH certificates using the AutClseMethd parameter f the Optin prperty. Als refer t the fllwing truble shting tpic regarding running the TE while nt lgged in. 190

191 Transfer Engine (Scripting) Lcked TE If yur script r applicatin runs the TE and des nt return cntrl t the script, it is pssible that the TE has lcked. Befre trying t trublesht the prblem, make sure yu exit the lcked TE prcess using the Windws Task Manager (kill the ftpte.exe prcess). If yur script is cnnecting t an SSL enabled server, duble check the steps listed under Handling SSL Certificates. The primary cause fr a lcked TE during an SSL cnnectin is the fact that the TE culd nt lcate the client r server certificate, r the client certificate des nt reside in the server's trusted list. An incrrect FTP hst address r ther cmmn cnnectin prblem (hst nt available, cnnectin refused, etc.) can lck up the TE. Verify that the hst, prxy, scks, user, and passwrd prperty value are crrect. The TE may als lck up if an imprperly registered TE is launched and unsuccessfully tries t display the registratin reminder (Web nag dialg). Lastly, nt prperly cnfiguring DCOM cnfiguratin fr the TE t access the target user's settings may cause the TE t lck up. If the system is currently lgged in when the TE is run, it runs as the user specified under DCOMCNFG. The TE icn des nt display in the system tray when the CuteFTP's main interface runs. Als, the hard cded user's settings are emplyed when the TE is run, nt thse f the currently lgged in user. This is nt an issue if yu are running the TE when the system is nt lgged in. Using the TE t Cnnect via FTPS (When Running a Script and nt Lgged In) Setting up the TE t cnnect t an FTP server ver SSL (via scripting) invlves several steps. Fllw the instructins belw carefully. Yu must knw whether the TE will require the use f server certificates nly r bth server and client certificates. Server Certificates Mst FTP SSL servers will prvide a certificate t the client during authenticatin. The certificate prves the server's legitimacy t the client. The server's certificate must be added the client's Trusted Certificate stre prir t any cnnectin, therwise the TE will lck up when trying t authenticate. T add the SSL certificate t the client's Trusted Certificate stre 1. Exprt r btain a cpy f the server's certificate frm the FTP server administratr. Otherwise cnnect t the server with the CuteFTP GUI (interface) frm the develper cmputer and manually accept the server's certificate. Yu can then exprt it frm the Trusted List under Glbal Optins > Security > SSL Security t a staging directry f yur chice. 2. Place/Install the certificate int the target cmputer's Default User directry. Fr example: C:\Dcuments and Settings\Default User\Applicatin Data\Glbalscape\CuteFTP\Security 3. If yu will als be running the TE while lgged in, place a cpy f the server certificate under the USER flder n the target cmputer, as fllws: C:\Dcuments and Settings\[USERNAME]\Applicatin Data\Glbalscape\CuteFTP\Security - where [USERNAME] is the lgin name fr the user. 4. Cnfigure the TE t aut-accept SSL r SSH certificates using the AutClseMethd parameter f the Optin parameter. Als refer t the fllwing truble shting tpic regarding running the TE while nt lgged in. 191

192 CuteFTP v9 User Guide Nw when yu cnnect, the TE sees the server's certificate and prceed with the cnnectin. Client Certificates Sme FTP SSL servers require that the client prvide a certificate. The certificate prves the veracity f the client and is an imprtant factr in weeding ut spurius FTP clients masquerading as legitimate nes. T setup the target system t use client certificates 1. On the develper cmputer, create the client certificate and private key pair using the CuteFTP GUI (interface). The certificate creatin utility is lcated under the Tls > Glbal Settings > Security > SSL dialg. 2. Add the client certificate t the server's trusted list. D this by cnnecting t the server with the CuteFTP GUI (interface) frm the develper cmputer. On the server, mve the certificate frm the Pending t the Trusted list. If yur server nly has a Trusted list, manually imprt the client certificate int the Trusted list. 3. Place the client certificate and private key int the target cmputer's USER flder: C:\Dcuments and Settings\[USERNAME]\Applicatin Data\Glbalscape\CuteFTP\Security - where [USERNAME] is the lgin name fr the user. 4. If yu created the certificate set n the develper cmputer, exprt the fllwing registry key: HKEY_CURRENT_USER\Sftware\Glbalscape\CuteFTP\Settings\SecuritySSL 5. Imprt the registry key frm step 4 nt the target cmputer, r manually create the necessary entries. The entries are shwn in standard.reg file ntatin. REGEDIT4 [HKEY_CURRENT_USER\Sftware\Glbalscape\CuteFTP\Settings\SecuritySSL] "SSLCertificate"="C:\\Dcuments and Settings\\[USERNAME]\\Applicatin Data\\Glbalscape\\CuteFTP\\Security\\client.crt" "SSLPrivateKey"="C:\\Dcuments and Settings\\[USERNAME]\\Applicatin Data\\Glbalscape\\CuteFTP\\Security\\client.key" "UseSSLCertificate"=dwrd: "UseSSLCertPassphrase"=dwrd: "ReuseSSLData"=dwrd: "WarnWhenTNnSecure"=dwrd: "DataTransprtMethd"=dwrd: "SSLCertPassphrase"="[PASSWORD]" - where [USERNAME] is the lgin name fr the target system and where [PASSWORD] is the encrypted passwrd exprted frm the surce cmputer. D nt mdify the passwrd exprted frm the surce cmputer! At the next cnnectin, the TE finds the client certificate and uses it t authenticate with the server. Example Belw is a sample script that cnnects t a fictitius Site running SSL Implicit ver prt 990. It als writes t the event lg fr debugging purpses. if yu use this script t test yur setup, make sure yu mdify the MySite.Hst line t include yur actual FTP SSL server hst and lgin infrmatin. #file test.vbs Cnst EVENT_SUCCESS = 0 Set bjshell = Wscript.CreateObject("Wscript.Shell") bjshell.lgevent EVENT_SUCCESS,"AT Laded me" Set MySite= CreateObject("CuteFTPPr.TECnnectin") MySite.Optin ("ThrwErrr") = True MySite.Hst = "ftp://myuser:mypass@ftp.mysslserver.cm:

193 Transfer Engine (Scripting) bjshell.lgevent EVENT_SUCCESS,"vars set" MySite.Cnnect bjshell.lgevent EVENT_SUCCESS, "cnnected" MySite.Discnnect MySite.Clse Transferring Files r Sites with the Transfer Engine When the Transfer Engine (TE) is running, the TE icn appears in the Windws system tray. Yu can dwnlad files r even an entire site by right-clicking the TE icn, then clicking Dwnlad URL. T dwnlad files frm a URL with the Transfer Engine 1. Right-click the TE icn, then click Dwnlad URL. The Dwnlad URL dialg bx appears. 2. Type the full URL, e.g., ftp://mysite.cm, then click OK. If CuteFTP is clsed, the dwnlad happens in the backgrund. If CuteFTP is pen, the prgress f the dwnlad appears in the Queue Windw. T view current transfers Right-click the TE icn, then click Shw current transfers. (Only available if the CuteFTP interface is clsed.) The Transfer Queue appears. (Yu can als pen the Transfer Queue by duble-clicking the TE icn.) T stp a transfer Right-click the in-prgress transfer in the Transfer Queue, then click Stp transfer. T start a transfer in the Transfer Queue Right-click the item(s) t be transferred, then click Start transfer. T remve items frm the Transfer Queue T remve ne r mre items, right-click the item(s) t be remved, then click Remve. T remve all items frm the queue, right-click anywhere in the queue, then click Remve All. Running Scripts Yu can execute a script yu create in Windws, frm the cmmand line, frm within CuteFTP's interface, r as a scheduled task t be run with n user lgged in. T execute a script directly in windws 1. Launch CuteFTP. 2. On the main menu, click Tls > Macrs & Scripting > Run. 3. Brwse fr the script file yu created. Fr example, sample.vbs. 193

194 CuteFTP v9 User Guide 4. Click Open t launch the script. The lg and queue view in CuteFTP ppulates with sessin and transfer infrmatin. When creating yur VB scripts, remember that in VB, yu aren't checking t see if the returned value is the string "True" r "False"; yu're checking fr the *value* True (i.e., -1) r False (i.e., 0). S, the values shuld *nt* be quted. The rule is, with qutes, it's a string. T execute a script frm the cmmand line 1. On the Windws task bar, click Start > Run. 2. In the Run dialg bx, type CMD, then press ENTER. 3. Navigate t the lcatin f the script file. 4. Type the name f the file, then press ENTER. TE launches (the TE icn display in the system tray) and executes yur script. T execute a script directly in Windws 1. In Windws Explrer, navigate t the lcatin f the script file. 2. Duble click the script file TE launches (the TE icn displays in the system tray) and executes yur script. Creating Scripts Yu can interact with the TE directly frm yur wn custm applicatins using cmmn prgramming languages such as Visual Basic (VB) r in a scripting language supprted by the Windws Scripting Hst (WSH). Yu can create a script frm the develpment IDE f yur chice, r yu can create scripts frm within CuteFTP by clicking Tls > Macrs & Scripting > New. CuteFTP will pen a template script file in a dcument windw. T create a new script file, yu need t have sme familiarity with prgramming cncepts and, ideally, sme experience with VB r Java. If yu d nt have any prgramming experience, yu can still create scripts using the sessin Recrd and Playback functinality in CuteFTP. Due t the wide range f scripts that CuteFTP is able t accmmdate, we are unable t ffer technical supprt n individual scripts ther than what is available in the help files and nline Knwledge Base. If yu are having truble with yur script, try t perfrm the desired actin manually, using the CuteFTP interface. If yu cannt, then trublesht that prblem first, and then retry yur script. If yu are able t perfrm the desired actins, and in the desired sequence when using the interface, then the prblem is nt with CuteFTP r the FTP Server. The next thing t d is t trublesht yur script line by line. Yu have t register the TE COM cmpnent n the cmputer befre yu can create script files t interact with it. 194

195 Transfer Engine (Scripting) Methds, Prperties, and Wildcards Overview Use methds and prperties t perate the Transfer Engine. Methds and prperties are defined belw. Methds A methd can be described as a cmmand r functin that may accept arguments (parameters) and may return a certain type f value. Fr example: Blean Object.LcalExists(BSTR bstrname); Fr this methd, the type f the return value is Blean. The cmmand accepts an argument as a string value, here shwn as BSTR (the type) and bstrname (a place hlder fr the argument). In a prgram, yu can execute a methd and assign the return value t a variable all in ne cmmand. Fr example: Exists = MySite.LcalExists "c:\temp\file.txt" The argument "c:\temp\file.txt exists" is passed t the methd LcalExists as a string (reasn fr the qutes). The variable Exists is then ppulated with a 1 r a 0 which is, in essence, true r false. Yu can then perfrm actins in yur script based n thse results. Prperties A prperty is simply an attribute f a functin (anther wrd fr methd) r bject internal t the TE framewrk. All prperties have default values. Methds that rely n these prperties will use default values unless yu specify therwise. Mst f the time, yu can assign a value t a prperty r retrieve its value int a variable. Yu can set a prperty much like a lcal variable t yur script. Fr example String Object.Prtcl The abve prperty can accept a predefined set f string values r can be assigned t a variable t retrieve the currently selected value. The default in this case is "FTP." Yu can assign a value t a prperty as fllws: MySite.Prtcl = "FTPS" Upn subsequent cnnectins, the TE will attempt t lgin using FTP ver SSL, rather then via FTP, the default attribute fr this prperty. Wildcard Masks Wildcard masks are patterns f special characters used t filter file names. When a wildcard mask is matched against a file name, the tw patterns are cmpared, letter-by-letter, frm left t right until a mismatch ccurs. If all the characters in bth patterns cmpare psitively, the file name matches the Wildcard Mask. Wildcard mask characters? Will match any singe character * Will match any sequence f characters (including n characters at all), terminated by the next character in the mask. [ ] Will match any character in the character set enclsed in the brackets. This can als be a range f characters If the pening bracket is fllwed by!", will match any character NOT in the set. 195

196 CuteFTP v9 User Guide Available Methds and Prperties The table belw describes the methds and prperties available t use with the Transfer Engine. AbrtAsync Use the AbrtAsync methd t stp an asynchrnus task created previusly by UpladAsync, DwnladAsync, r TransferURLAsync. Refer t thse methds fr mre infrmatin. HRESULT AbrtAsync([in, defaultvalue(-1)] lng taskidx); Syntax Object.AbrtAsync(lng taskidx) Parameters TaskIdx This is a task index in the array f tasks created by the varius asynchrnus methds. The default value f taskidx is - 1 which specifies all the asynchrnus tasks in array. TaskIdx shuld be between 0 and AsyncTaskNumber minus ne. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Optin("CleanupAsync") = False 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect MySite.DwnladAsync "*.*", "c:\temp" MsgBx "Number f tasks created: " & MySite.AsyncTaskNumber If MySite.AsyncTaskNumber > 10 then MsgBx "Abrting 11th task" MySite.AbrtAsync ( 10 ) 'abrt task # 11 (ne less then ttal, since starts frm 0) End if Yu must set MySite.Optin("CleanupAsync") = False s that all asynchrnus tasks are cunted. Otherwise, nly the last asynchrnus task launched will be referenced when calling the AbrtAsync methd. AsyncTaskNumber Use the AsyncTaskNumber prperty t return the number f tasks created by the UpladAsync, DwnladAsync and TransferURLAsync methds. HRESULT AsyncTaskNumber([ut, retval] lng *pval); Syntax Lng Object.AsyncTaskNumber Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Optin("CleanupAsync") = False MySite.DwnladAsync "/path/*.*" MsgBx "task number created" & MySite.AsyncTaskNumber Yu must set MySite.Optin("CleanupAsync") = False s that all asynchrnus tasks are cunted. Otherwise, nly the last asynchrnus task launched will be referenced when calling the AsyncTaskNumber prperty. 196

197 Transfer Engine (Scripting) AutRename Use the AutRename prperty t set r retrieve the renaming values prir t the transfer f a file r flder. T cnfigure the aut-rename rules, refer t the prcedure in Rename Rules Settings. HRESULT AutRename([ut, retval] BSTR *pval); HRESULT AutRename([in] BSTR newval); Syntax String MySite.AutRename Parameters "ON" AutRename feature turned n "OFF" AutRename feature turned ff Example CaseHandling MySite.AutRename = "ON" HRESULT CaseHandling([ut, retval] lng *pval); HRESULT CaseHandling([in] lng newval); ClearCmmandChannel Use the ClearCmmandChannel prperty t specify that the cmmand channel shuld nt be encrypted ver SSL. HRESULT ClearCmmandChannel([ut, retval] BOOL *pval); HRESULT ClearCmmandChannel([in] BOOL newval); Syntax lng Object.ClearCmmandChannel Parameters True Yur lgin is encrypted but as data transfers start, cmmands are nt encrypted. False Yur lgin and subsequent cmmands are encrypted. This is the default Example MySite.Hst = "hst" MySite.Prtcl = "FTPS" MySite.ClearCmmandChannel = true '<-- CCC will be sent prir t the first data cnnectin peratin. MySite.Cnnect Cnfiguratin Ntes The default is false (encrypted), s nly set this prperty if yu wish t lg in securely but send subsequent cmmands in the clear. This prperty will nly wrk if the remte server supprts SSL and clear cmmand channel cnnectins (accrding t RFC 2228) and yu have specified FTPS as the prtcl type. 197

198 CuteFTP v9 User Guide ClearDataCnnectin Clse Use the ClearDataCnnectin prperty t specify whether the data channel shuld be encrypted r nt when using FTP ver SSL. HRESULT ClearDataCnnectin([ut, retval] BOOL *pval); HRESULT ClearDataCnnectin([in] BOOL newval); Syntax lng Object.ClearDataCnnectin Parameters True Yur lgin is encrypted but data transfers are nt. This is the default. False Yur lgin and data transfers are encrypted. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTPS" MySite.ClearDataCnnectin = false 'encrypt FTP data channel Cnfiguratin Ntes The default is true (encrypted), s nly set this prperty if yu wish t lg in securely but transfer data in the clear. This prperty will nly wrk if the remte server supprts SSL and clear data channel cnnectins (PROT C cmmand accrding t RFC 2228) and yu have specified FTPS as the prtcl type. Use the Clse methd t exit the Transfer Engine. Yu can include parameters t exit nly n certain cnditins. Syntax HRESULT Clse([in, defaultvalue("bstr bstrcnditin); Object.Clse (BSTR bstrparameter) Parameters ""(default empty), "CLOSE", "EXIT" Clses TE (all tasks will be stpped) "EXITNOPENDING" Clses TE if n pending tasks available Yu can use any number f spaces r underscres inside these parameters. Fr example, "exit n pending" and "_EXIT_NO_PENDING_" are the same. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.LcalFlder = "c:\temp" MySite.TransferURLAsync "ftp://ftp.cuteftp.cm/pub/cuteftp" MySite.Clse "EXITNOPENDING" 198

199 Transfer Engine (Scripting) CmbSupprt Use the CmbSupprt prperty t check if the server supprts the COMB (multi-part uplad) cmmand. Syntax HRESULT CmbSupprt([ut, retval] BOOL *pval); Blean Object.CmbSupprt Return values -1 Server supprts COMB 0 Server des nt supprt COMB Example Cnnect Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. If (nt MySite.CmbSupprt) Then MsgBx "This server desn't supprt the COMB cmmand!" End if Use the Cnnect methd t lg in t a remte server. Befre calling it, set the prtcl, hst address (with the Hst prperty), user name (with the Lgin prperty) and passwrd (with the Passwrd prperty) t establish a successful cnnectin. Syntax HRESULT Cnnect([ut, retval] BOOL *pval); Object.Cnnect Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.cuteftp.net" MySite.Lgin = "username" MySite.Passwrd = "passwrd" MySite.Cnnect Any time yu call a transfer functin, the Cnnect methd is called indirectly. It is recmmended yu explicitly invke the Cnnect methd, thugh it is nt necessary. Yu can always use the IsCnnected prperty t determine whether yu are cnnected at any given time. CreateLcalFlder Use the CreateLcalFlder methd t create a new flder (directry) n yur lcal hard drive. HRESULT CreateLcalFlder([in, defaultvalue("bstr strname, [ut, retval] BOOL *pval); Syntax Object.CreateLcalFlder(BSTR strname) 199

200 CuteFTP v9 User Guide Parameters BstrName This cntains the flder's relative r abslute path. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.CreateLcalFlder "c:\temp\new Flder" Nw check t see if it was created MySite.LcalFlder = "c:\temp\new Flder" currentdir = MySite.LcalFlder MsgBx currentdir CreateRemteFlder Use the CreateRemteFlder methd t create a new flder (directry) n a remte server. HRESULT CreateRemteFlder([in, defaultvalue("bstr strname, [ut, retval] BOOL *pval); Syntax Object.CreateRemteFlder(BSTR strname) Parameters BstrName This cntains the flder's relative r abslute path. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect MySite.CreateRemteFlder("/dir") 'creates /dir (because abslute path was used) MySite.RemteFlder = "/dir" 'nw change t the newly create 'dir' flder MySite.CreateRemteFlder("dir2") 'creates /dir/dir2 (because relative path was used) CreateSSHKeyPair Used t create an SSH Key pair. DataChannel HRESULT CreateSSHKeyPair([in] lng KeyAlgrithm, [in] lng KeyBits, [in] BSTR bstrpassphrase, [in] BSTR bstrprivatekeyfile, [ut, retval] BOOL *pval); Use the DataChannel prperty t set r retrieve values fr the methd in which the data prt is established fr the data channel (PASV r PORT). The default is PORT. HRESULT DataChannel([ut, retval] BSTR *pval); HRESULT DataChannel([in] BSTR newval); Syntax String Object.DataChannel 200

201 Transfer Engine (Scripting) Delay Parameters "PORT" The client specifies what prt t use fr the data cnnectin "PASV" Lets the server specify the prt used fr the data cnnectin prt "DEFAULT" Uses the methd defined in Glbal Optins Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp://ftp.cuteftp.cm" MySite.usePrxy = "ff" MySite.DataChannel = "PASV" MySite.RemteCmmand("LIST") MySite.DataChannel = "PORT" MySite.RemteCmmand("LIST") MsgBx MySite.Lg Use the Delay prperty t set the delay between cnnectin retry attempts (in secnds). HRESULT Delay([ut, retval] lng *pval); HRESULT Delay([in] lng newval); Syntax int Object.Delay Example MySite.Delay = 90 Yu cannt use the Delay prperty with transfers; yu can nly use Delay with cnnectins. DeleteDestinatin HRESULT DeleteDestinatin([ut, retval] BOOL *pval); HRESULT DeleteDestinatin([in] BOOL newval); Parameters 0 = Dn't remve destinatin 1 = Remve destinatin if surce des nt exist (default) Discnnect Use the Discnnect methd t end an event in prgress. It is nrmally used t stp a file transfer. Syntax HRESULT Discnnect(); Object.Discnnect() Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 201

202 CuteFTP v9 User Guide MySite.TransferURLAsync MySite.Discnnect Cnfiguratin Ntes Discnnect is nt the same as the standard FTP cmmand QUIT. Instead it is simply a cmmand t stp the current transfer task. Yu can issue a QUIT cmmand prir t invking Discnnect by using the RemteCmmand methd. A scket discnnect (mre brutal than QUIT) t an FTP server ccurs autmatically after all transfers and ther cmmands have finished. This is similar t the Cnnect cmmand, which is implicitly called when a transfer methd is invked. The example abve uses the TransferURLAsync cmmand t pass the TE an FTP file lcatin t dwnlad. Since the TransferURLAsync cmmand is asynchrnus, yu culd called TransferURLAsync multiple times cnsecutively. If yu issue a Discnnect cmmand after issuing multiple TransferURLAsync cmmands, the last called TransferURLAsync request is the ne that is cancelled. Dwnlad Use the Dwnlad methd t transfer a file r flder frm a remte lcatin t yur lcal hard drive. HRESULT Dwnlad([in, defaultvalue("bstr bstrremtename, [in, defaultvalue("bstr bstrlcalname, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); Syntax Object.Dwnlad (BSTR strremtename,bstr strlcalname, lng nmultipartnumber) Parameters strlcalname This is ptinal. Use this nly if yu want t change the destinatin name r path fr the dwnladed files r flder. Yu can use abslute r relative paths. strremtename This is the path t the remte item yu are dwnlading. Yu can use abslute r relative paths with r withut wildcards. nmultipartnumber Use this t split the dwnlad int multiple parts. The default value = 1. The value specifies the number f parts used fr the dwnlad. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Specify user, pass, hst, and cnnect as nrmal MySite.Cnnect 'Recmmended: call cnnect first 'next line changes t a predetermined flder s yu can use a relative path in the dwnlad methd MySite.RemteFlder = "/c:/inetpub/ftprt/temp/temp/" MsgBx (MySite.RemteFlder) 'display current remte flder MySite.Dwnlad "agent.ini", "c:\temp\agent1.ini" 'nw verify dwnladed k If CBl(MySite.LcalExists ("c:\temp\agent1.ini")) Then MsgBx "File dwnladed OK." End If 202

203 Transfer Engine (Scripting) Cnfiguratin Ntes: Setting the Multi-part dwnlad attribute can greatly increase the transfer speed fr larger files under certain cnditins. Fr example, the Site must supprt multiple cncurrent cnnectins frm the same user and yu must have significant bandwidth. The Dwnlad methd is a synchrnus cmmand, meaning it must finish executing befre subsequent cmmands in yur script can be called. Use the methd DwnladAsync (which als supprts Multi-part transfers) t asynchrnusly dwnlad files, which allws yu t execute the rest f the script while the dwnlad(s) take place. Yu cannt dwnlad and rename multiple files by specifying a wildcard in the strlcalname parameter. Fr example, MySite.Dwnlad "*.exe", "*.txt" will dwnlad all f the files in the current remte flder that end with *.exe t a lcal flder named "_.txt". That is, if yu specify a wildcard, the wildcard character is replaced by an underscre ( _ ) character. DwnladAsync Use the DwnladAsync methd t dwnlad a file r flder t the lcal hard drive asynchrnusly. An asynchrnus dwnlad starts and then returns cntrl t the script befre the transfer finishes. This allws yu t perfrm many simultaneus transfers because the methd des nt wait fr the dwnlad t end. Immediately after yu call this methd subsequent methds in yur script will be called, s be careful when timing certain events. If DwnladAsync encunters a prblem when trying t cmplete its task, it will nt thrw a COM, ATL, r VB errr. DwnladAsync will als adhere t yur max glbal and per Site settings. HRESULT DwnladAsync([in, defaultvalue("bstr strremtename, [in, defaultvalue("bstr strlcalname, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); Syntax Object.DwnladAsync(BSTR strremtename,bstr strlcalname, lng nmultipartnumber) Parameters strlcalname This is ptinal, use it nly if yu want t change the destinatin name r path fr the dwnladed files r flder. Yu can use abslute r relative paths with r withut wildcards. strremtename This is the path t the remte item yu are dwnlading. Yu can use abslute r relative paths with r withut wildcards. nmultipartnumber Use this t split the dwnlad int multiple parts. The default value = 1. The value specifies the number f parts used fr the dwnlad. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp.cuteftp.cm" MySite.Cnnect MySite.DwnladAsync "/pub/cuteftp/english/*", "c:\temp" 'dwnlads all files in the pub/cuteftp flder Yu can call the DwnladAsync methd many times sequentially in a script. Each call, in turn, pens a new data cnnectin t the specified server, enabling yu t transfer multiple files simultaneusly. This, cmbined with the ability t transfer the file in multiple parts, greatly increases the verall transfer speed and executin f yur task. 203

204 CuteFTP v9 User Guide ErrrDescriptin Use the ErrrDescriptin prperty t get the string describing the last errr cnditin. It may cnsist f sme messages taken frm the transfer lg. HRESULT ErrrDescriptin([in, defaultvalue(-1)] lng taskidx, [ut, retval] BSTR *pval); Syntax String Object.ErrrDescriptin (lng taskidx) Parameter TaskIdx This is a task index in the array f tasks created by the varius asynchrnus methds. The default value f taskidx is - 1 which specifies all the asynchrnus tasks in array. TaskIdx shuld be between 0 and AsyncTaskNumber minus ne. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Optin("ThrwErrr") = false 'disable ATL exceptins if cbl(mysite.cnnect) then MsgBx "Cnnected OK" else MsgBx "Errr! " & MySite.ErrrDescriptin FileOverWriteMethd Use the FileOverWriteMethd t specify the actin t take when transferring a file when a file with the same name exists. Refer t Smart Overwrite Settings fr mre infrmatin. HRESULT FileOverWriteMethd([ut, retval] BSTR* pval); HRESULT FileOverWriteMethd([in] BSTR newval); Parameters "OVERWRITE" Overwrite the file "SKIP" D nt transfer the file and leave the destinatin file as it is. "RESUME" Treat the file as an incmplete transfer. If the destinatin file is already a cmplete file, the transferred file replaces the destinatin file. "RENAME" Rename the file "PROMPT" Prmpt befre verwrtiting "NUMERATE" Create a cpy f the file and add a number t the name "USE_RULES" Use the rules yu define in the Overwrite Rules dialg bx in Glbal Optins t determine hw t handle all files with matching names. Examples 'Display the current flder verwrite setting MsgBx( MySite.FlderOverwriteMethd ) 'Set flder verwrite t replace all MySite.FlderOverwriteMethd = "FOLDER_REPLACE_ALL" 204

205 Transfer Engine (Scripting) FileSize FileTimeMdified FileType Use the FileType, FileSize, and FileTimeMdified prperties t retrieve infrmatin abut a particular item. HRESULT FileSize([ut, retval] BSTR *pval); HRESULT FileTimeMdified([ut, retval] BSTR *pval); HRESULT FileType([ut, retval] lng *pval); Syntax lng Object.FileType lng Object.FileSize string Object.FileTimeMdified Return Values Fr FileType: 1 Directry 2 File 3 Link Fr FileSize: the size in bytes f the file Fr FileTimeMdfied: mm/dd/yyyy hh:mm:ss Example Set fserv = CreateObject("CuteFTPPr.TECnnectin") strremte = "smefilename.ext" if cbl(fserv.remteexists(strremte)) then MsgBx "Remte file/flder inf: Type=" & fserv.filetype & ", Size=" & fserv.filesize & ", Date=" & fserv.filetimemdified & strnl & "(type:1-dir,2- file,3-link)" else MsgBx "Errr! " & fserv.errrdescriptin End If FlderOverwriteMethd Use the FlderOverwriteMethd t specify the actin t take when transferring a file when a file with the same name exists. Refer t Smart Overwrite Settings fr mre infrmatin. HRESULT FlderOverwriteMethd([ut, retval] BSTR* pval); HRESULT FlderOverwriteMethd([in] BSTR newval); Parameters "FOLDER_PROMPT" Prmpt befre verwriting "FOLDER_REPLACE_ALL" Replace (verwrite) all "FOLDER_USE_RULES" Use the rules yu define in the Overwrite Rules dialg bx in Glbal Optins t determine hw t handle all flders with matching names. 205

206 CuteFTP v9 User Guide GetList Examples 'Display the current verwrite setting MsgBx( MySite.FileOverWriteMethd ) 'Set file verwrite methd t numerate MySite.FileOverWriteMethd = "NUMERATE" Use the GetList methd t dwnlad flder listings. HRESULT GetList([in] BSTR bstrpath, [in] BSTR bstrlcalfile, [in, defaultvalue("bstr bstrfrmat, [ut, retval] BOOL *pval); Syntax Object.GetList(BSTR bstrpath, BSTR bstrlcalfile, BSTR bstrfrmat, BOOL *pval) Parameters bstrpath The remte path t be listed. Leave it empty if its the current path. bstrlcalfile Specifies a lcal file name where the listing can be saved. bstrfrmat Can be used t frmat the listing. If left empty, a raw listing will be returned. Yu can specify %NAME, %DATE, and %SIZE as return values in a string. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp.cuteftp.cm/pub" MySite.Cnnect MySite.GetList "", "c:\temp_list.txt" 'saves a raw listing fr the default path t the file temp_list.txt MsgBx MySite.GetResult 'retrieves and displays the listing Example 2 Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp.cuteftp.cm" MySite.Cnnect MySite.GetList "/pub", "", "FILE NAME: %NAME" 'ges t pub flder, desn't save the listing t file, and frmats it as shwn MsgBx MySite.GetResult 'retrieves and displays the listing Example 3 Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp.cuteftp.cm" MySite.Cnnect MySite.GetList "/pub", "", "NAME= %NAME SIZE= %SIZE DATE= %DATE" 'ges t pub flder, desn't save the listing t file, and frmats it as shwn MsgBx MySite.GetResult 'retrieves and displays the listing GetResult is an ptinal methd used nly with GetList. It simply retrieves the data. Withut GetResult the data is written t the buffer, r if defined in the parameters, the data is written t the lg. 206

207 Transfer Engine (Scripting) GetResult HRESULT GetResult([in, defaultvalue("bstr bstrreserved, [ut, retval] BSTR * bstrresult); HmeDir Hst Use the HmeDir prperty t return a string value cntaining the name f the server's hme directry. Syntax HRESULT HmeDir([ut, retval] BSTR *pval); String Object.HmeDir Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MsgBx "Hme dir fr server " + MySite.Hst + " is: " + MySite.HmeDir Use the Hst prperty t set r retrieve the value fr the hst name f a Site when yu are cnnecting. HRESULT Hst([ut, retval] BSTR *pval); HRESULT Hst([in] BSTR newval); Syntax int Object.Hst Example IgnreLinks Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.ftp.net" MySite.Prt = 21 MySite.Lgin = "username" MySite.Passwrd = "passwrd" Use the IgnreLinks prperty when wrking with Unix servers. Use IgnreLinks t set r retrieve the value that determines whether r nt yu want t bypass links. HRESULT IgnreLinks([ut, retval] BOOL *pval); HRESULT IgnreLinks([in] BOOL newval); Syntax Bl Object.IgnreLinks Parameters True Skip symlinks during synchrnizatin False Handle symlinks during synchrnizatin as files r flders 207

208 CuteFTP v9 User Guide Example IsCnnected Mysite.IgnreLinks = False Use the IsCnnected prperty t indicate whether r nt yu are presently cnnected t the remte Site. Syntax HRESULT IsCnnected([ut, retval] BOOL *pval); Blean Object.IsCnnected Parameters True The Transfer Engine is currently cnnected t the server. False The Transfer Engine is nt currently cnnected t the server. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") If Cbl(MySite.IsCnnected) Then MsgBx "Cnnected t server:" + MySite.Hst End if Yu can specify hw lng the Transfer Engine will leave the data cnnectin pen after a cmpleted transfer. IsPending Use the IsPending prperty t determine whether a transfer is active r if it is already finished with success r errr. This can be useful in cmbinatin with async cmmands r during an interactive script. The IsPending prperty will return a value f either true r false. HRESULT IsPending([in, defaultvalue(-1)] lng taskidx, [ut, retval] BOOL *pval); Syntax Blean Object.IsPending(lng taskidx) Parameter TaskIdx This is a task index in the array f tasks created by the varius asynchrnus methds. [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)] This has a default value (if nthing is specified) f ALL tasks. Therefre, IsPending will return true if any task is still pending. It will return false if nne are pending. Example 1 Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Regular cnnectin cde here: MySite.Dwnlad inbund/*.*", "c:\temp" If CBl(MySite.IsPending) Then MsgBx "task is in wrking state" + MySite.Hst End if 208

209 Transfer Engine (Scripting) Links Example 2 Here is anther example that checks an asynchrnus transfer and will return varius transfer prgress prperties f each transfer while IsPending is true. If yu cpy and paste this cde, be aware that line breaks may be inserted int the cde. Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Prt = "21" MySite.Hst = "ftp.url" MySite.lgin = "lginname" MySite.Passwrd = "yur pass" MySite.Cnnect MySite.Optin("CleanupAsync") = False ' line break strnl = (Chr(13) & Chr(10)) MySite.MaxCnnectins = 3 MySite.Optin("ThrwErrr") = false MySite.DwnladAsync "inbund/*.*", "c:\temp" bcntinue = true while CBl(MySite.IsPending) and bcntinue str = "LOOP, Ttal: " & MySite.AsyncTaskNumber & strnl fr i = 0 t MySite.AsyncTaskNumber - 1 step 1 str = str & i & ": size: " & MySite.TransferredSize(i) & ", speed: " & MySite.Speed(i) & ", time left: " & MySite.TimeLeft(i) & ", status: " & MySite.Status(i) & strnl next str = str & "YES - cntinue lp, NO - stp tasks, CANCEL - exit lp" nuserchise = MsgBx(str, vbyesncancel) 'press YES many time t see transfer prgresses if nuserchise = vbcancel then bcntinue = false elseif nuserchise = vbno then MySite.AbrtAsync 'abrt all tasks bcntinue = false end if wend str = "DONE, Ttal: " & MySite.AsyncTaskNumber & strnl fr i = 0 t MySite.AsyncTaskNumber - 1 step 1 str = str & i & ": size: " & MySite.TransferredSize(i) & ", speed: " & MySite.Speed(i) & ", time left: " & MySite.TimeLeft(i) & ", status: " & MySite.Status(i) & strnl next MsgBx str Use the Links prperty t bth set and retrieve values fr wrking with links n a remte server. HRESULT Links([ut, retval] BSTR *pval); HRESULT Links([in] BSTR newval); Syntax String Object.Links Parameters "Reslve" The TE will attempt t reslve the link prir t transfer. 209

210 CuteFTP v9 User Guide "GetAsFile" The TE will assume it's a file and transfer as is (This is used t avid endless lps in a large multi-directry transfer). Example MySite.Links = "Reslve" LcalExists Use the LcalExists methd t verify that a lcal file r flder exists. HRESULT LcalExists([in, defaultvalue("bstr bstrname, [ut, retval] BOOL * bexists); Syntax Blean Object.LcalExists(BSTR bstrname); BstrName shuld be the full path. Return Values True File r flder des exist False File r flder des nt exist Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. L = MySite.LcalExists("c:\temp\file.txt") If (L) Then MsgBx "File exists n lcal side" Else MsgBx "File desn't exist n lcal side" End if LcalFilterExclude Use the LcalFilterExclude prperty t set and retrieve the values fr excluding lcal files r flders frm transfers and listings. The string values may cntain wildcards and yu can add multiple filters by separating them with a semicln. HRESULT LcalFilterExclude([ut, retval] BSTR *pval); HRESULT LcalFilterExclude([in] BSTR newval); Syntax String Object.LcalFilterExclude Example MySite.LcalFilterExclude = "*.mp3;*.jpg" If filter causes n file t be transferred, then n flders will be created. LcalFilterInclude Use the LcalFilterInclude prperty t set r retrieve the values fr including lcal files r flders in transfers and listings. The string values may cntain wildcards and yu can add multiple filters by separating them with a semicln ( : ). HRESULT LcalFilterInclude([ut, retval] BSTR *pval); 210

211 Transfer Engine (Scripting) HRESULT LcalFilterInclude([in] BSTR newval); Syntax String Object.LcalFilterInclude Example MySite.LcalFilterInclude = "*.jpg;*.gif" If a filter causes n file t be transferred then n flders will be created. LcalFlder Use the LcalFlder prperty t retrieve r set the current flder n yur lcal hard disk. Yu can use relative r abslute paths. HRESULT LcalFlder([ut, retval] BSTR *pval); HRESULT LcalFlder([in] BSTR newval); Syntax String Object.LcalFlder Example LcalRemve Object.LcalFlder = "c:\temp" Use the LcalRemve methd t delete a lcal file r flder. Use the abslute path name fr the item yu want t delete. HRESULT LcalRemve([in, defaultvalue("bstr bstrname, [ut, retval] BOOL *pval); Syntax Object.LcalRemve(BSTR bstrname) Parameters BstrName This cntains the items full abslute path. Example 1 Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.LcalRemve "c:\temp\file.txt" Yu can als use wild cards t replace the string value f bstrname. These wild card masks include "*", "?", and '\n" (new line symbl, als knwn as Chr(10) in VB). Example 2 Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. 211

212 CuteFTP v9 User Guide LcalRename MySite.LcalFlder = "c:\temp" MySite.LcalRemve("file.ext") 'remves if exact match MySite.LcalRemve("*.bj") 'wild card match with a specific extensin MySite.LcalRemve("*.aaa" & Chr(10) & "*.bbb" & Chr(10) & "t*") 'varius wildcard filters Use the LcalRename methd t rename a file r flder n yur lcal hard disk. HRESULT LcalRename([in] BSTR bstrfrm, [in] BSTR bstrt, [ut, retval] BOOL *pval); Syntax Object.LcalRename(BSTR bstrfrm, BSTR bstrt) Parameters BstrT This cntains the flder's new name in its full abslute path. BstrFrm This cntains the flder's ld name in its full abslute path. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.LcalRename "c:\file.txt", "e:\temp\users\file.exe" Make sure yu specify the full surce and destinatin path. If yu had written the cmmand as MySite.LcalRename "c:\file.txt", "file.exe", thinking it wuld rename it using relative paths, yu might be surprised t find that yur file has been mved t yur prfiles flder (system dependent). The LcalRename prperty is similar t a MOVE cmmand issued thrugh drag and drp with the added name change sequence. Lg Use the Lg prperty t return the entire lg as a string which can be handled separately in yur VB applicatin r VB script. Syntax HRESULT Lg([in, defaultvalue(-1)] lng taskidx, [ut, retval] BSTR *pval); String Object.Lg (lng taskidx) Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)]. It has a default value f -1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp://ftp.cuteftp.cm" MySite.Cnnect MsgBx MySite.Lg 212

213 Transfer Engine (Scripting) Lgin Use the Lgin prperty t set r retrieve the value fr the user name (lgin) yu use t cnnect. HRESULT Lgin([ut, retval] BSTR *pval); HRESULT Lgin([in] BSTR newval); Syntax String Object.Lgin Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.cuteftp.cm" MySite.Lgin = "username" MySite.Passwrd = "passwrd" MySite.Cnnect MaxCnnectins Use the MaxCnnectins prperty t set r retrieve the mst cnnectins the script is allwed t pen. Optin HRESULT MaxCnnectins([ut, retval] lng *pval); HRESULT MaxCnnectins([in] lng newval); Syntax lng Object.MaxCnnectins Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.MaxCnnectins = 1 'restrict cnnectins t 1 Use the Optin prperty t set r retrieve varius settings, such as Aut-rename, include flder names when filtering, cache invalidatin, errr handling, cleaning up f asynchrnus tasks, and t aut-clse prmpts. HRESULT Optin([in] BSTR bstroptname, [ut, retval] BOOL *pval); HRESULT Optin([in] BSTR bstroptname, [in] BOOL newval); Syntax String Object.Optin("[ptin name]") = true false Parameters "ThrwErrr" (defaults t True) - TE COM will call AtlReprtErrr (shwing a VB runtime errr message bx) n cnnectin/transfer/io/ther errr which will terminate script executin. If set t False, then if sme transfer methd fails the script will cntinue t the next cmmand. "AutRename" (defaults t False) - The same as the AutRename prperty. "CleanupAsync" (defaults t True) - All task IDs accumulated by previus Async methds will be lst. If set t False, all task IDs will be added t the nes created by previus Async methds. 213

214 CuteFTP v9 User Guide "InvalidateCache" (defaults t True) - Remve cached file (cntaining listings) befre uplading, dwnlading, renaming r deleting files. If false, then dn't remve cached listing. Yu can btain the specific file infrmatin when needed by using ne f the file prperty methds. InvalidateCache ptimizes LIST traffic. "FilterDirs" (defaults t True) - Apply filters t flder names. If set t False, then dn't apply. "AutClseMethd" (default t 0) 1 - aut accept, 2 - aut reject, 0 - Dn't accept (default). This handles hidden prmpts (such as SSL Accept Cert Prmpt when running a script while nt lgged in). "AutClseDelay" (default value is 60 secnds). Time delay befre CuteFTP shuld perfrm the actin specified by the AutClseMethd ptin. "CnnectinTimeut" 'Display cnnectin timeut value Examples 'Set MsgBx( MySite.Optin("CnnectinTimeut") ) cnnectin timeut t 45 secnds MySite.Optin("CnnectinTimeut") = 45 ValidateFileIntegrity 'Display current value f ValidateFileIntegrity MsgBx( MySite.Optin("ValidateFileIntegrity") ) 'Turn n ValidateFileIntegrity MySite.Optin("ValidateFileIntegrity") = 1 0=FALSE and 1=TRUE Example 1 Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp://ftp.cuteftp.cm" MySite.Optin("FilterDirs")=False 'dn't filter flder names MySite.LcalFilterExclude= "TDImn; *.txt; *.vbs" 'nw set the item names t exclude MySite.Uplad "c:\test" 'uplads all f test including sub dirs. 'Even sub dirs that match the filter, such as TDIMn. 'If I had left FilterDirs=True, then the flter 'TDImnd wuld nt have been upladed. Example 2 Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftp://ftp.smestrangedmain.cm" MySite.Optin("ThrwErrr") = false if nt CBl(MySite.Cnnect) then MsgBx "Errr : " & MySite.ErrrDescriptin end if Example 3 Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Hst = "ftps://ftp.asecuredmain.cm" MySite.Optin("AutClseMethd") = 1 'will aut accept cert and cntinue 214

215 Transfer Engine (Scripting) MySite.Optin("AutClseDelay") = 5 'wait 5 secnds befre accepting MySite.Cnnect 'nw cnnect t the secure Site. The TE will accept the server's SSL cert after 5 secnds and cntinue executing the rest f the script. Passwrd Prt Use the Passwrd prperty t set r retrieve the value fr the passwrd yu use t cnnect. HRESULT Passwrd([ut, retval] BSTR *pval); HRESULT Passwrd([in] BSTR newval); Syntax String Object.Passwrd Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.ftp.net" Object.Lgin = "username" MySite.Passwrd = "passwrd" MySite.Cnnect Use the Prt prperty t set r retrieve the value fr the Prt n the server when yu cnnect. HRESULT Prt([ut, retval] lng *pval); HRESULT Prt([in] lng newval); Syntax int Object.Prt Example PrmptDelete Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.cuteftp.cm" MySite.Prt = 21 MySite.Lgin = "username" MySite.Passwrd = "passwrd" MySite.Cnnect HRESULT PrmptDelete([ut, retval] BOOL *pval); HRESULT PrmptDelete([in] BOOL newval); Parameters 0 = Dn't prmpt befre remving 1 = Prmpt befre remving (default) Prtcl Use the Prtcl prperty t set r retrieve the value fr the prtcl type. 215

216 CuteFTP v9 User Guide HRESULT Prtcl([ut, retval] BSTR *pval); HRESULT Prtcl([in] BSTR newval); Syntax String Object.Prtcl Parameters "FTP" File Transfer Prtcl "FTPS" FTP using SSL in explicit mde (standard prt 21) "FTPS_IMPLICIT" Extensin f FTP using SSL -- FTP using SSL in implicit mde (specific prt) "FTPS_AUTH_TLS" AUTH TLS - Explicit "SFTP" Secure prtcl based n SSH2 "FTP_SKEY_MD4" Secure ne time passwrd lgin using MD4 "FTP_SKEY_MD5" Secure ne time passwrd lgin using MD5 "HTTP" Hypertext Transfer Prtcl "HTTPS" HTTP with SSL Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTPS_IMPLICIT" MySite.Hst = "ftp.ftp.net" > MySite.Prt = 990 MySite.Lgin = "username" MySite.Passwrd = "passwrd" MySite.Cnnect Yu can find mre ptins fr using SSL in ClearDataCnnectin. PrxyInf Use the PrxyInf prperty t set r retrieve FTP and HTTP prxy server cnfiguratins. D nt use this functin if yu d nt cnnect thrugh a prxy server. HRESULT PrxyInf([ut, retval] BSTR *pval); HRESULT PrxyInf([in] BSTR newval); Syntax String Object.PrxyInf Authenticatin Parameters "ftp://prxyusername:prxypasswrd@prxyhstname:prxyprt" Fr FTP prxies that require authenticatin. " Fr HTTP prxies that require authenticatin. "ftp://prxyhstname:prxyprt" Fr FTP prxies that dn't require Authenticatin. " Fr HTTP prxies that dn't require Authenticatin. 216

217 Transfer Engine (Scripting) Additinal parameters "prxyusername" The user name fr lgin t the prxy server "prxypasswrd" The passwrd fr lgin t the prxy server "prxyhstname" The prxy server address "prxyprt" The prxy server cnnectin prt Example 1 MySite.PrxyInf = 'use http prxy withut authrizatin Example 2 MySite.PrxyInf = ftp://jeuser:maypass@glbalscape.cm:21 'use ftp prxy with authrizatin fr user "jesuser" & passwrd "mypass" Example 3 'retrieve the current value f ScksInf (empty if nne) str = MySite.ScksInf 'nw display it Recursive MsgBx str Use the Recursive prperty t set r retrieve the value that determines whether r nt subflders will be included in a transfer task. This prperty is used ften in synchrnizatin scripts. HRESULT Recursive([ut, retval] BOOL *pval); HRESULT Recursive([in] BOOL newval); Syntax Bl Object.Recursive Parameters True Include subflders False D nt include subflders Example Mysite.Recursive = True RemteCmmand Use the RemteCmmand methd t send the server any supprted cmmand. This functin acts like the raw input cmmand fund in CuteFTP. There is n resume methd; hwever, yu can use the RemteCmmand methd t send the APPE (Append) cmmand t a server. APPE is the FTP cmmand t resume a transfer. The RemteCmmand methd exists t allw yu t pass any cmmand t the server manually, even if that cmmand is nt natively supprted thrugh the TE API. HRESULT RemteCmmand([in] BSTR bstrcmd, [ut, retval] BOOL *pval); 217

218 CuteFTP v9 User Guide Syntax Object.RemteCmmand(BSTR bstrcmd) Examples MySite.RemteCmmand "APPE html/test.txt" Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.RemteCmmand "PWD" 'sends a print wrking directry cmmand RemteExists If yu include the wrd "LIST", r "RETR", r "STOR" in bstrcmd then the Transfer Engine will pen the data cnnectin, perfrm the peratin (t the buffer) and then discard it. Yu shuld use the GetList, Dwnlad r Uplad methds t accmplish these tasks. Yu can cmbine strings t perfrm custm cmmands. Fr example, if yu wanted t d use CHMOD n a file, yu culd d as shwn in the example belw: 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'full permissins strmode = "777" 'an input dialg with sme default cntent strfile = InputBx("Type in the file name belw ", "CHMOD Dialg", "cftppr10.lg") 'cncatenate the values strvar = "SITE CHMOD " & strmode & " " & strfile 'send the cmmand MySite.RemteCmmand strvar Use the RemteExists methd t verify that a remte file r flder exists. HRESULT RemteExists([in, defaultvalue("bstr bstrname, [ut, retval] BOOL * bexists); Syntax Blean Object.RemteExists(BSTR bstrname) BstrName shuld be the full path. Return Values true File r flder des exist false File r flder des nt exist Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 218

219 Transfer Engine (Scripting) 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. R = MySite.RemteExists( "/pub/user/file.txt") If (R) Then MsgBx "File exists n remte side" Else MsgBx "File desn't exist n remte side" End if If using an "if nt" cnditinal, use CBl instead f blean as the return type. Crrect: if nt CBl(MySite.RemteExists(strRemte)) then MsgBx "Errr! " & MySite.ErrrDescriptin Incrrect: if nt MySite.RemteExists(strRemte) then MsgBx "Errr! " & MySiteErrrDescriptin RemteFilterExclude Use the RemteFilterExclude prperty t set and retrieve the values fr excluding remte files r flders frm transfers and listings. The string values may cntain wildcards and yu can add multiple filters by separating them with a semicln. HRESULT RemteFilterExclude([ut, retval] BSTR *pval); HRESULT RemteFilterExclude([in] BSTR newval); Syntax String Object.RemteFilterExclude Example MySite.RemteFilterExclude = "*.txt;*.swp" MySite.Dwnlad "*.*" ' will dwnlad all files except thse with extensins f *.txt and *.swp If filter causes n file t be transferred then n flders will be created. RemteFilterInclude Use the RemteFilterInclude prperty t set r retrieve the values used t include remte files r flders in transfers and listings. The string values may cntain wildcards and yu can add multiple filters by separating them with a semicln ";". HRESULT RemteFilterInclude([ut, retval] BSTR *pval); HRESULT RemteFilterInclude([in] BSTR newval); Syntax String Object.RemteFilterInclude Example MySite.RemteFilterInlcude = "*.jpg;*.gif" 219

220 CuteFTP v9 User Guide If filter causes n file t be transferred then n flders will be created. RemteFlder Use the RemteFlder prperty t retrieve r set the current remte flder. Yu can use abslute r relative paths. HRESULT RemteFlder([ut, retval] BSTR *pval); HRESULT RemteFlder([in] BSTR newval); Syntax String Object.RemteFlder Example 'Cnnect t site fllwing previus samples MySite.RemteFlder = "/pub/cuteftp" 'Changes the remte flder t /pub/cuteftp (abslute paths used) 'subsequently MySite.RemteFlder = "test" 'Changes t the flder called "test" lcated in "/pub/cuteftp", using relative paths. RemteRemve Use the RemteRemve methd t delete a remte file r flder. Yu can specify the file r flder with abslute r relative paths. If the cmmand fails, make sure yu have specified the crrect path and that yu have the apprpriate permissins required t delete the item. HRESULT RemteRemve([in, defaultvalue("bstr bstrname, [ut, retval] BOOL *pval); Syntax Object.RemteRemve(BSTR bstrname) Parameters BstrName This cntains the flder's relative r abslute path. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.RemteRemve "/pub/user1/file.txt" MySite.RemteRemve("file.ext") 'remves if exact match MySite.RemteRemve("*.bj") 'wild card match with a specific extensin MySite.RemteRemve("*.aaa" & Chr(10) & "*.bbb" & Chr(10) & "t*") 'varius wildcard filters Yu can als use wild cards t replace the string value f bstrname. These wild card masks include "*", "?", and '\n" (new line symbl, als knwn as Chr(10) in VB). RemteRename Use the RemteRename methd t rename a file r flder n the remte server. 220

221 Transfer Engine (Scripting) HRESULT RemteRename([in] BSTR bstrfrm, [in] BSTR bstrt, [ut, retval] BOOL *pval); Syntax Object.RemteRename(BSTR bstrfrm, BSTR bstrt) Parameters BstrFrm This cntains the flder's ld name in a relative r abslute path. The path must be the same in bth parameters. BstrT This cntains the flder's new name in a relative r abslute path. The path must be the same in bth parameters. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.RemteRename "/pub/user1/file.txt", "/pub/user1/file3.txt" RemteSiteFilter Use the RemteSiteFilter prperty t specify a string which will be used as a filter parameter by the LIST cmmand. HRESULT RemteSiteFilter([ut, retval] BSTR *pval); HRESULT RemteSiteFilter([in] BSTR newval); Syntax string Object. RemteSiteFilter Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite. RemteSiteFilter = "-l" 'This will send a "List -l" cmmand t the server. Cnfiguratin Ntes Refer t Filtering Transfers fr a table f LIST wildcards (parameters) and cmbinatins that can be passed t the ls prgram running n a UNIX server. RestSupprt Use the RestSupprt prperty t check if the server supprts the REST (resume dwnlad) cmmand. Syntax HRESULT RestSupprt([ut, retval] BOOL *pval); Blean Object.RestSupprt Return values -1 Server supprts REST. 221

222 CuteFTP v9 User Guide Retries 0 Server des nt supprt REST. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. If (nt cbl(mysite.restsupprt)) Then MsgBx "This server desn't supprt the REST cmmand" End if Use the Retries prperty t retrieve r set the value fr the maximum number f attempts the Transfer Engine shuld make t cnnect t a remte hst. Syntax HRESULT Retries([ut, retval] lng *pval); int Object.Retries Example MySite.Retries = 10 Yu cannt use the Retries prperty with transfers; yu can nly use Retries with cnnectins. S2Sxfer Use the S2Sxfer methd t transfer a file frm ne remte Site t anther. Yu must use abslute path names fr the surce and target flders. HRESULT S2Sxfer([in] BSTR bstrsurcename, [in] BSTR bstrdestname, [in] BSTR bstrpeerhst, [in] BSTR bstrpeerlgin, [in] BSTR bstrpeerpasswrd, [in, defaultvalue(21)] lng Prt, [in, defaultvalue("ftpbstr bstrpeerprtcl, [ut, retval] BOOL *pval); Syntax Blean Object.S2Sxfer(BSTR bstrsurcename, BSTR bstrdestname, BSTR bstrpeerhst, BSTR bstrpeerlgin, BSTR bstrpeerpasswrd, lng Prt, BSTR bstrpeerprtcl); Parameters bstrsurcename surce file and flder name bstrdestname target file and flder name bstrpeerhst target hst name bstrpeerlgin target lgin bstrpeerpasswrd target passwrd Prt target prt BstrPeerPrtcl target prtcl (FXP can be applied fr hsts with different prtcls FTP, FTP-S) Return values true Transfer was successful 222

223 Transfer Engine (Scripting) false Transfer failed Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. ScksInf MySite.Cnnect MySite.S2Sxfer "/cftppr14.lg", "/hme/myflder/cftppr14.lg", "ftp.destinatinhst.cm", "username", "passwrd" 'everything else left as default Use the ScksInf prperty t set r retrieve values fr SOCKS4 r SOCKS5 servers. (SOCKS is a prtcl fr a TCP prxy acrss firewalls.) HRESULT ScksInf([ut, retval] BSTR *pval); HRESULT ScksInf([in] BSTR newval); Syntax String Object.ScksInf Authenticatin Parameters "scks4://scksusername:sckspasswrd@sckshstname:scksprt" Fr SOCKS4 servers that require authenticatin. "scks5://scksusername:sckspasswrd@sckshstname:scksprt" Fr SOCKS5 servers that require authenticatin. "scks4:// sckshstname:scksprt" Fr SOCKS4 servers that d nt require authenticatin. "scks5:// sckshstname:scksprt" Fr SOCKS5 servers that d nt require authenticatin. Additinal parameters "scksusername" The user name r lg in name t the SOCKS server. "sckspasswrd" The passwrd fr the SOCKS server. "sckshstname" The address and prt fr the SOCKS server. Example 1 MySite.ScksInf = "scks4//glbalscape.cm:1080" 'use scks4 withut authrizatin Example 2 MySite.ScksInf = "scks5://jeuser:mypass@glbalscape.cm:1080" 'use scks5 with authrizatin fr user "jeuser" with passwrd "mypass" Example 3 'retrieve the current value f ScksInf (empty if nne) str = MySite.ScksInf 'nw display it MsgBx str 223

224 CuteFTP v9 User Guide Speed Use the Speed prperty t determine a transfer's prgress and varius ther aspects f the transfer. See als the TimeLeft, TimeElapsed, TtalSize, and TransferredSize prperties belw. HRESULT Speed([in, defaultvalue(-1)] lng taskidx, [ut, retval] lng *pval); Status Syntax lng Object.Speed (lng taskidx) = bytes/secnd Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)] It has a default value f - 1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'st all relavant hst, lgin, pass, etc. prperties MySite.Hst = hst MySite.Dwnlad "aaa", "c:\temp" MsgBx "Size: " & MySite.TtalSize & ", speed: " & MySite.Speed & ", time: " & MySite.TimeElapsed Use the Status prperty t determine whether a transfer is active r it is already finished with success r errr. This can be useful in cmbinatin with asynchrnus cmmands r during an interactive script. The Status prperty will return a string. Syntax HRESULT Status([in, defaultvalue(-1)] lng taskidx, [ut, retval] BSTR *pval); String Object.Status (lng taskidx) Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber r - 1 (last started)] Return Values "WAIT" Transfer actin invked but nt initiated yet (fllwed by cnnecting) "CANCELED" Active transfer canceled by user "FINISHED" Transfer cmpleted "ERROR" Errr in transfer (any pssible client r server errr) "SUSPENDED" Added t queue but n transfer initiated yet "SCHEDULED" Item is scheduled fr future transfer "BLOCKED" An internal status used fr navigatin and des nt pertain t active r pending transfers. Yu can cancel any transfer requests in BLOCKED status withut any ill effects. 224

225 Transfer Engine (Scripting) "CHILDWAIT" Cnditin when transfer item is waiting fr a dependant item t finish transferring (*) "SKIPPED" Transfer skipped by user r autmatically per verwrite rules "CONNECTING" Cnnecting t server (status right after WAIT) "CANCELLING" Cancel initiated but nt cmpletely stpped yet "WORKING" After cnnecting but befre transferring. Culd be pening data cnnectin, r setting REST params, etc. "TRANSFERRING" File transfer in prgress "UNKNOWN" Anther string was returned ther than ne f the abve. The string was unrecgnized. Example Synchrnize Set MySite = CreateObject("CuteFTPPr.TECnnectin") If nt CBl(MySite.IsPending) Then MsgBx "Task dne, final status is " + MySite.Status End if Use the Synchrnize methd t perfrm ne r tw way mirrrs f a remte and lcal flder's cntents. HRESULT Synchrnize([in, defaultvalue("bstr bstrremtename, [in, defaultvalue("bstr bstrlcalname, [in, defaultvalue(0)] lng ndirectin, [in, defaultvalue(0)] lng nactin, [in, defaultvalue(0)] lng ncasehandling, [in, defaultvalue(true)] BOOL brecursive, [in, defaultvalue(true)] BOOL bignrelinks, [in, defaultvalue(false)] BOOL bdeldestinatin, [in, defaultvalue(true)] BOOL bprmptdel, [ut, retval] BOOL *pval); Syntax Object.Synchrnize(BSTR bstrremtename, BSTR bstrlcalname, lng ndirectin, lng nactin, lng ncasehandling, BOOL brecursive, BOOL bignrelinks, BOOL bdeldestinatin, BOOL bprmptdel); 225

226 CuteFTP v9 User Guide Parameters Be sure t use abslute path names fr bth lcal and remte flder paths. # Name Value 1 BstrRemteName String value that specifies the abslute path name f the remte flder 2 BstrLcalName String value that specifies the abslute path name f the lcal flder 3 ndirectin 0 = Mirrr Lcal (make the remte lk just like the lcal) 1 = Mirrr Remte (make the lcal lk just like the remte) 2 = Mirrr Bth 4 nactin When ndirectin = 2 (Mirrr Bth) 0 = Mirrr the mre recent file 1 = Mirrr the larger file 2 = Prmpt fr matching file names 3 = Skip mirrring files with the same names When ndirectin = 0 r 1 (Mirrr Lcal r Remte) 0 = Use Glbal Overwrite settings in the CuteFTP shell fr matching filenames 1 = Always verwrite the file with a matching name 2 = Numerate the file (filename[1]) 3 = Skip 5 ncasehandling 0 = Transfer first and skip the rest (default) 1 = Shw rename prmpt 2 = Numerate Nte: This actin applies when matching filenames are fund and the nly difference is the filename case. 6 brecursive 0 = Dn't sync subflders 1 = Apply sync t subflders (default) 7 bignrelinks 0 = Dn't ignre symblic links 1 = Ignre symblic links (default) 8 bdeldestinatin 0 = Dn't remve destinatin 1 = Remve destinatin if surce des nt exist (default) Nte: This actin nly applies t ne-way mirrring. If a file exists in the destinatin that isn't in the surce being mirrred, then delete the destinatin file. 9 bprmptdel 0 = Dn't prmpt befre remving destinatin 1 = Prmpt befre remving destinatin (default) Nte: Only applies t ne-way mirrring when DelDestinatin is True. Examples 'Simple synchrnize using minimal parameters Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Dn't frget t initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect MySite.Synchrnize "/pub/myflder", "C:\mysitesfiles", 0, 1 'This will perfrm a lcal mirrr, verwriting any matching filename. 226

227 Transfer Engine (Scripting) 'Simple synchrnize using minimal parameters Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Dn't frget t initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect MySite.Synchrnize "/pub/myflder", "C:\mysitesfiles", 2, 0 'This will perfrm full mirrr (bth), verwriting lder files when a matching filename is fund. 'Slightly mre cmplex synchrnize rutine used t synchrnize bkmarks. Uses variables fr the path names strremtepath = "\Favrites" strlcalpath = "C:\Dcuments and Settings\username\Favrites" 'Dn't frget t initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect If (Nt (MySite.IsCnnected)) Then MsgBx "Unable t cnnect t server:" + MySite.Hst End if MySite.Synchrnize strremtepath, strlcalpath, 2, 3, 0, 1, 1, 0, 1 'Perfrms a full mirrr, skips matching filenames, transfers nly the first file if multiple files are fund with the same name but different case, applies t subflders, ignres symblic links, des nt remve destinatin files if the surce desn't exist (N/A when dealing with dual mirrr), and prmpt prir t deleting anything (N/A when dealing with dual mirrr). 'Alert me t the cmpleted task MsgBx "DONE!" 'Discnnects frm the site when dne MySite.Discnnect 'Clse the Transfer Engine prcess MySite.Clse 'A full synchrnizaitn VB subrutine: Sub Sync() >Dim MySite Set MySite = CreateObject("CuteFTPPr.TECnnectin") strhst = "ftp.yurhst.cm" strpath = "/pub" strlcalpath = "c:\temp\sync_test" strhst = InputBx("Enter hst", "CuteFTP", strhst) strpath = InputBx("Enter remte path", "CuteFTP", strpath) strlcalpath = InputBx("Enter lcal path", "CuteFTP", strlcalpath) MySite.Hst = strhst MySite.CaseHandling = 1 MySite.Recursive = False MySite.IgnreLinks = True MySite.DeleteDestinatin = False MySite.PrmptDelete = True nuserchise = MsgBx ("Mirrr remte: " & strhst & strpath & " t lcal " & strlcalpath & "?", vbyesncancel) If nuserchise = vbyes Then MySite.Synchrnize strpath, strlcalpath, 1, 0 227

228 CuteFTP v9 User Guide TECmmand else nuserchise = MsgBx ("Mirrr lcal: " & strhst & strlcalpath & " t remte " & strpath & "?", vbyesncancel) If nuserchise = vbyes Then MySite.Synchrnize strpath, strlcalpath, 0, 0 else nuserchise = MsgBx ("Mirrr bth: " & strhst & strpath & " <- > " & strlcalpath & "?", vbyesncancel) If nuserchise = vbyes Then MySite.Synchrnize strpath, strlcalpath, 2, 1 else End if End if End if End Sub Use the TECmmand methd t pass varius cmmands t the Transfer Engine cmpnent. If yu leave the Transfer Engine running fr a lng time, it is recmmended yu include the DELETEFINISHED r DELETEALL in yur scripts t ccasinally empty the queue. The Transfer Engine des nt empty the queue autmatically. Syntax HRESULT TECmmand([in] BSTR bstrcmmand); Object.TECmmand(BSTR bstrparameter) Parameters "CLOSE" r "EXIT" Clses the TE (all tasks will be stpped) "EXITNOPENDING" Clses the TE if n pending tasks are available "UPDATESETTINGS" Relads settings frm the registry (Nte yu can mdify the registry frm VBS) "DELETEFINISHED" Remves finished items frm queue "DELETEALL" Remves all items frm queue Yu can use any number f spaces r underscres inside these parameters. Fr example, "update setting" and "_UPDATE_SETTINGS_" are the same. If the Transfer Engine has several tasks, r must run fr a lng time, yu shuld include the DELETEFINISHED cmmand in yur scripts t ccasinally clear items frm the queue. Example TimeElapsed Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.TECmmand("DELETEFINISHED") Use the TimeElapsed prperty t determine a transfer's prgress. HRESULT TimeElapsed([in, defaultvalue(-1)] lng taskidx, [ut, retval] lng *pval); 228

229 Transfer Engine (Scripting) Syntax lng Object.TimeElapsed (lng taskidx) =secnds Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)] It has a default value f - 1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'set all relavant hst, lgin, pass, etc. prperties TimeLeft MySite.Hst = hst MySite.Dwnlad "aaa", "c:\temp" MsgBx "Size: " & MySite.TtalSize & ", speed: " & MySite.Speed & ", time: " & MySite.TimeElapsed Use the TimeLeft prperty t determine hw many secnds are left befre a transfer is cmplete. HRESULT TimeLeft([in, defaultvalue(-1)] lng taskidx, [ut, retval] lng *pval); Syntax lng Object.TimeLeft (lng taskidx) = secnds Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)]. It has a default value f - 1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'set all relavant hst, lgin, pass, etc. prperties TtalSize MySite.Hst = hst MySite.Dwnlad "aaa", "c:\temp" MsgBx "Size: " & MySite.TtalSize & ", speed: " & MySite.Speed & ", time: " & MySite.TimeElapsed Use the TtalSize prperty t determine the ttal file size f a transfer. See als TransferredSize belw. HRESULT TtalSize([in, defaultvalue(-1)] lng taskidx, [ut, retval] BSTR *pval); Syntax lng Object.TtalSize (lng taskidx) = size in bytes 229

230 CuteFTP v9 User Guide Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)]. It has a default value f - 1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'set all relavant hst, lgin, pass, etc. prperties TransferredSize MySite.Hst = hst MySite.Dwnlad "aaa", "c:\temp" MsgBx "Size: " & MySite.TtalSize & ", speed: " & MySite.Speed & ", time: " & MySite.TimeElapsed Use the TransferredSize prperty t determine the size after a file has been transferred and pssibly cmpressed. HRESULT TransferredSize([in, defaultvalue(-1)] lng taskidx, [ut, retval] BSTR *pval); Syntax lng Object.TransferredSize (lng taskidx) = size in bytes Parameters TaskIdx This is the task index in the array f tasks created by asynchrnus methds [0.. AsyncTaskNumber minus ne, r - 1 (last asynchrnus task started)]. It has a default value f - 1 = current task. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'set all relavant hst, lgin, pass, etc. prperties TransferType MySite.Hst = hst 'set all relavant hst, lgin, pass, etc. prperties MySite.Dwnlad "aaa", "c:\temp" MsgBx "Size: " & MySite.TtalSize & ", speed: " & MySite.Speed & ", time: " & MySite.TimeElapsed Use the TransferType prperty t retrieve r set the value fr the way the Transfer Engine shuld transfer files (ASCII, binary r aut). Syntax HRESULT TransferType([ut, retval] BSTR *pval); String Object.TransferType Parameters "ASCII" All files shuld be transferred in ASCII mde "BINARY" All files shuld be transferred in BINARY mde 230

231 Transfer Engine (Scripting) "AUTO" (default) The TE will reference an internal list editable frm CuteFTP's Glbal Optins t determine the prper transfer type fr that particular file. Fr example, if the ASCII list cntains a filter mask f "txt" then all files with extensin ".txt" will be transferred in ASCII. If a file desn't crrespnd t any mask in this list then it will be transferred in binary mde. Example Object.TransferType = "AUTO" 'the Transfer Engine will use the shell's default settings t establish whether the transfer shuld ccur in binary r ASCII. 'write file transfer cde next TransferURL Use the TransferURL methd t dwnlad files directly frm a Web address. HRESULT TransferURL([in] BSTR bstrremtename, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); Syntax Object.TransferURL(BSTR bstrremtename, lng nmultipartnumber) Parameters bstrremtename This is a string value fr the URL fr the file transfer such as: (ftp://ftp.glbalscape.cm/pub/cuteftp/cuteftp.exe). nmultipartnumber This is ptinal and will split a file int parts fr transfer. The default = 1. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.TransferURL "ftp://ftp.glbalscape.cm/pub/cuteftp/cuteftp.exe" The TE recgnizes these URL frmats: ftp://user:pass@ ftp.sitename.cm:prt ftp://user:pass@ ftp.sitename.cm ftp://user@ ftp.sitename.cm ftp:// ftp.sitename.cm:prt ftp:// ftp.sitename.cm ftp://ftp.sitename.cm/pub l: user p: pass ß l: user is a lwercase "L", nt "ne" ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://ftp.sitename.cm/pub l/p: user/pass ftp://ftp.sitename.cm/pub:44 l/p: user/pass ftp://ftp.sitename.cm/pub p:44 l/p: user/pass ftp://ftp.sitename.cm/pub prt:44 l/p: user/pass ftp://ftp.sitename.cm/pub l: user p: pass ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub p:44 l: user p: pass 231

232 CuteFTP v9 User Guide ftp://ftp.sitename.cm/pub prt:44 l: user p: pass TransferURLAsync Use the TransferURLAsync methd t start a dwnlad frm a web address, and return cntrl t the script immediately. This methd des nt wait fr the transfer t end. Yu can use it t perfrm many simultaneus transfers. The difference between this methd and DwnladAsync is simply the ability t specify all f the necessary parameters in ne cmmand, rather than having t set the user name, prt, hst, etc. and then transfer a file. Immediately after yu call this methd subsequent methds in yur script will be called, s be careful when timing certain events. If TransferURLAsync encunters a prblem when trying t cmplete its task, it will nt thrw a COM, ATL, r VB errr. TransferURLAsync will als adhere t yur max glbal and per site settings. Yu can't use wildcards in this methd. HRESULT TransferURLAsync([in] BSTR bstrremtename, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); Syntax Object.TransferURLAsync(BSTR bstrurl [, lng nmultipartnumber]) Parameters bstrurl A string value fr the URL fr the file transfer (ftp://ftp.cuteftp.cm/pub/cuteftp) nmultipartnumber An ptinal multipart parameter with default = 1 Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.TransferURLAsync "ftp://ftp.cuteftp.cm/pub/cuteftp/english" 'this will transfer the entire English CuteFTP directry frm the CuteFTP.cm ftp site. Nrmal Frmats Supprted ftp://user:pass@ ftp.sitename.cm:prt ftp://user:pass@ ftp.sitename.cm ftp://user@ ftp.sitename.cm ftp:// ftp.sitename.cm:prt ftp:// ftp.sitename.cm ftp://ftp.sitename.cm/pub l: user p: pass ß l: user is a lwercase "L", nt "ne" ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass ftp://ftp.sitename.cm/pub l/p: user/pass ftp://ftp.sitename.cm/pub:44 l/p: user/pass ftp://ftp.sitename.cm/pub p:44 l/p: user/pass ftp://ftp.sitename.cm/pub prt:44 l/p: user/pass 232

233 Transfer Engine (Scripting) Uplad ftp://ftp.sitename.cm/pub l: user p: pass ftp://ftp.sitename.cm/pub:44 l: user p: pass ftp://ftp.sitename.cm/pub p:44 l: user p: pass ftp://ftp.sitename.cm/pub prt:44 l: user p: pass Extended URL Frmats Aside frm the standard URL frmats shwn abve, additinal specifiers may be used t dente the directin f transfer and dwnlad path. Use the extended frmat t perfrm site t site transfers, uplads, targeted dwnlads, and mre. The standard url ftp://user:pass@ftp.hst.cm will be used in the fllwing examples: Frmat: Nrmal URL transfer MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm" 'dwnlad site t the default dwnlad flder Frmat: URL [space] "-->" [space] LPATH MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm --> c:\temp" 'dwnlad site t the c:\temp flder Frmat: URL [space] "<--" [space] LPATH MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm <-- c:\web" 'uplad files frm c:\web t the site Frmat: URL1 [space] "<->" [space] URL2 MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm <-> ftp://user2:pass2@ftp.hst2.cm" 'perfrm a site t site transfer Frmat: URL [space] "<==" [space] LPATH MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm <== c:\web" 'synchrnize (mirrr lcal) the c:\web flder t the site Frmat: URL [space] "==>" [space] LPATH MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm ==> c:\web" 'synchrnize (mirrr remte) the site t c:\web Frmat: URL [space] "<=>" [space] LPATH MySite.TransferURLAsync "ftp://user:pass@ftp.hst.cm <=> c:\web" 'synchrnize bth lcal and remte (mirrr bth) Use the Uplad methd t transfer a file r flder frm a lcal hard drive t a remte server. HRESULT Uplad([in, defaultvalue("bstr bstrlcalname, [in, defaultvalue("bstr bstrremtename, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); Syntax Object.Uplad(BSTR strlcalname,bstr strremtename, lng nmultipartnumber) 233

234 CuteFTP v9 User Guide Parameters strremtename This is ptinal; use it nly if yu want t change the destinatin name r path fr the upladed files r flders. Yu can use abslute r relative paths. strlcalname This is the path t the lcal item yu are uplading. Yu can use abslute r relative paths with r withut wildcards. nmultipartnumber Use this t split the uplad int multiple parts. The default value = 1. The value specifies the number f parts used fr the dwnlad. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Specify user, pass, hst, and cnnect as nrmal... MySite.Cnnect 'r;recmmended: call cnnect first MySite.RemteFlder = "Temp" MySite.LcalFlder = "C:\123" 'using relative path, all files in flder 123 are upladed t the flder Temp ff the current flder n the server. MySite.Uplad "*.*" Cnfiguratin Ntes Yu can nly use multi-part uplads with servers that supprt the COMB cmmand. Currently, nly Glbalscape EFT Server supprts the COMB cmmand. Setting the Multi-part uplad attribute can greatly increase the transfer speed fr larger files under certain cnditins. Fr example, the site must supprt multiple cncurrent cnnectins frm the same user and yu must have significant bandwidth. The Uplad methd is a synchrnus cmmand, meaning it must finish executing befre subsequent cmmands in yur script can be called. Use the methd UpladAsync (which als supprts Multi-part transfers) t synchrnusly uplad files, which allws yu t execute the rest f the script while the uplad(s) take place. Yu cannt uplad and rename multiple files by specifying a wildcard in the strremtename parameter. Fr example, MySite.Uplad "*.exe", "*.txt" will uplad all f the files in the current lcal flder that end with *.exe t a remte flder named "_.txt". That is, if yu specify a wildcard, the wildcard character is replaced by an underscre ( _ ) character. UpladAsync Use the UpladAsync methd t uplad a file r flder t a remte server asynchrnusly. An asynchrnus uplad starts and then returns cntrl t the script befre the transfer finishes. This allws yu t perfrm many simultaneus transfers because the methd des nt wait fr the uplad t end. Immediately after yu call this methd subsequent methds in yur script will be called, s be careful when timing certain events. If UpladAsync encunters a prblem when trying t cmplete its task, it will nt thrw a COM, ATL, r VB errr. UpladAsync will als adhere t yur max glbal and per site settings. HRESULT UpladAsync([in, defaultvalue("bstr strlcalname, [in, defaultvalue("bstr strremtename, [in, defaultvalue(1)] lng nparts, [ut, retval] BOOL *pval); 234

235 Transfer Engine (Scripting) Syntax Object.UpladAsync(BSTR strlcalname [,BSTR strremtename [, lng nmultipartnumber]]) Parameters strremtename This is ptinal, use it nly if yu want t change the destinatin name r path fr the upladed files r flders. Yu can use abslute r relative paths with r withut wildcards. strlcalname This is the path t the lcal item yu are uplading. Yu can use abslute r relative paths with r withut wildcards. nmultipartnumber Use this t split the uplad int multiple parts. The default value = 1. The value specifies the number f parts used fr the dwnlad. Example Set MySite = CreateObject("CuteFTPPr.TECnnectin") 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. MySite.Cnnect MySite.UpladAsync "c:\temp\*.vb", "/DVDFiles" 'uplads as many.vb files as cncurrent cnnectin settings allw The multi-part parameter fr the UpladAsync is currently limited t servers that supprt this peratin, due t the need t recmbine the files after the uplad f each part has cmpleted. Glbalscape EFT Server supprts this functin. UsePrxy Use the UsePrxy prperty t retrieve r set the value fr the type f SOCKS r prxy server that is being (r shuld be) used. Since OFF is the default, yu dn't need UsePrxy fr regular cnnectins which d nt pass thrugh prxy r SOCKS servers. HRESULT UsePrxy([ut, retval] BSTR *pval); HRESULT UsePrxy([in] BSTR newval); Syntax String Object.UsePrxy Parameters "OFF" Direct cnnectin withut any scks and prxy "SOCKS" SOCKS server nly - the user must specify the SOCKS parameters by setting the ScksInf prperty "PROXY" Prxy server nly - the user must specify the prxy server parameters by setting the PrxyInf prperty "BOTH" Use bth SOCKS and prxy - the user shuld specify the apprpriate infrmatin fr bth the prxy and the scks server with PrxyInf and ScksInf. Example 'specify that scks will be used, then cnfigure ScksInf Object.UsePrxy = "SOCKS" Object.ScksInf = "scks5://glbalscape.cm:1080" 'Rest f cnnectin cde fllws 235

236 CuteFTP v9 User Guide Wait Use the Wait methd t tell the Transfer Engine t hld all ther tasks until a specific asynchrnus task is cmpleted. Then cntinue with the rest f the script. HRESULT Wait([in, defaultvalue(-1)] lng taskidx, [in, defaultvalue(0)] lng timeut, [ut, retval] BSTR * pstatus); Syntax String Object.Wait (lng taskindex, lng timeut) Parameters taskindex This is the task index in the asynchrnus tasks array. The default = -1 (which is current task). It can range frm 0 t the ttal number f tasks minus ne. timeut Determines hw lng (in millisecnds) t wait fr a finished, cancelled, r errr status befre cntinuing with the script. Return Value "CANCELLED" Transfer was stpped by the user "FINISHED" Transfer was successfully finished "ERROR" There were errrs during the transfer "SKIPPED" The transfer was skipped (file verwrite rules) Example 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.TransferURLAsync "ftp://ftp.cuteftp.cm/pub/cuteftp" strresult = MySite.Wait If (strresult = "ERROR") then MsgBx "warning! An errr has ccurred!" End if Cnfiguratin Ntes The default timeut value fr the Wait methd is 21,805,184 millisecnds, r apprximately 6 hurs. The maximum pssible value fr timeut is 2,147,483,647 millisecnds, r just under 25 days. Yu can set the Wait methd t never timeut by using a timeut value f 0 (zer). Fr hints n Wait methd timeuts, see Timeut strategies, belw. WriteTLOG Use the WriteTLOG methd t write a message directly t the cnnectin lg saved in the path set in CuteFTP's glbal ptins. It is useful fr dcumenting events t aid in script debugging. Syntax HRESULT WriteTLOG([in] BSTR bstr, [in, defaultvalue("statusbstr bstrtype); Object.WriteTLOG(BSTR bstr, BSTR bstrtype) Parameters bstr The lg message. 236

237 Transfer Engine (Scripting) bstrtype A lg message, type: "STATUS", "ERROR", "NOTE", "COMMAND", "RAW". The default is "STATUS". Example 'Initialize all necessary fields fr MySite : hst name, user, passwrd, etc. Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.TransferURLAsync "ftp://ftp.cuteftp.cm/pub/cuteftp" strresult = MySite.Wait If (strresult = "FINISHED") then MySite.WriteTLOG "Transfer successful!!" MySite.WriteTLOG "Transfer successful!!", "errr" MySite.WriteTLOG "Transfer successful!!", "nte" End if As result, the lg will cntain the fllwing strings: STATUS: > Transfer successful!! ERROR: > Transfer successful!! Nte > Transfer successful!! Timeut Strategies fr the Wait Methd The default timeut value fr the Wait methd is 21,805,184 millisecnds, which is apprximately 6 hurs. The timeut value is a SIGNED LONG data type, meaning its maximum pssible value is 2,147,483,647 millisecnds, which is rughly hurs r just under 25 days. This is likely enugh time fr even the slwest transfer. The Wait methd supprts a "0" timeut value which means "keep waiting frever r until the transfer reaches a state f CANCELED, FINISHED, ERROR, SUSPENDED, SKIPPED, r BLOCKED." Yu can als write scripts s that they check the cnditin f a transfer and if it is still in the "TRANSFERRING" state, t wait n it again. Three timeut strategies fr lng transfer tasks 1. Specify a large timeut value in the script call - Because the first parameter t the Wait methd is a task index, this example uses a "-1" which means "current task." Fr this example, the timeut is set fr 10 hurs r, 10 * 60 * 60 * 1000 = millisecnds. Example strresult = strataftp.wait( -1, ) 2. After a Wait() functin has timed ut, check the STATUS f the transfer - In this scenari, use the prgram (r script) lgic t keep trying after a Wait times ut when the transfer is still in the TRANSFERRING state. In ther wrds, yur plling fr the terminatin status has timed ut, but nt necessarily the transfer itself, s yu keep ging. In the fllwing example, yu wait up t 10 hurs fr the transfer, and if that times ut, yu check the status f the transfer. If it is still TRANSFERRING, yu d it again (please nte the last tw cnditinal statements): Example D strresult = strataftp.wait( -1, ) Lp While ( strresult <> "CANCELED") and ( strresult <> "FINISHED" ) and 237

238 CuteFTP v9 User Guide ( strresult <> "ERROR" ) and ( strresult <> "SKIPPED" ) and ( strresult <> "SUSPENDED" ) and ( strresult <> "BLOCKED" ) Alternatively, yu can take the mre psitive utlk f cntinuing n while the transfer task is either WORKING, CONNECTING, r TRANSFERRING: Example D strresult = strataftp.wait( -1, ) Lp While ( strresult = "TRANSFERRING") r ( strresult = "WORKING" ) r ( strresult = "CONNECTING" ) 3. Wait frever, r until the transfer reaches sme terminatin pint.mst transfers eventually either FINISH r receive an errr frm the server; but there is a minr chance that the transfer in the queue is perpetually stuck in a "TRANSFERRING" state. This strategy might be cnsidered a little riskier than the first tw: Example strresult = strataftp.wait( -1, 0 ) Using a Script t Cnnect t a Remte Site The script belw cnnects the TE t the public Glbalscape FTP server and displays the wrds Cnnected OK in a message bx after a successful cnnectin. Set MySite= CreateObject("CuteFTPPr.TECnnectin") MySite.Optin ("ThrwErrr") = False MySite.Prtcl = "FTP" MySite.Hst = "ftp.cuteftp.cm" if cbl(mysite.cnnect) then MsgBx "Cnnected OK" else MsgBx MySite.ErrrDescriptin end if MySite.Discnnect MySite.Clse Save this script in a text editr with a.vbs extensin, then duble-click the.vbs file t execute the script. Using a Script t Dwnlad a File The script belw cnnects t the Glbalscape FTP Site and dwnlads a file called index.txt t a lcal flder, c:/temp. 'This sample script perfrms an annymus lgin t ftp://ftp.glbalscape.net 'Get a reference t the TE COM bject. Dim MySite Set MySite = CreateObject("CuteFTPPr.TECnnectin") MySite.Prtcl = "FTP" MySite.Hst = "ftp.glbalscape.cm" MySite.Lgin = "annymus" MySite.Passwrd = "user@user.cm" MySite.UsePrxy = "BOTH" 238

239 Transfer Engine (Scripting) MySite.FileOverWriteMethd = "NUMERATE" MySite.Cnnect 'Verify the cnnectin was made successfully If (Nt Cbl(MySite.IsCnnected)) Then MsgBx "Culd nt cnnect t: " & MySite.Hst & "!" Quit(1) End If 'The script will nw check t see if the lcal flder c:\temp exists and will create it if necessary If (Nt (MySite.LcalExists("c:\temp"))) Then MySite.CreateLcalFlder "c:\temp" End If 'Change TE's lcal wrking flder t t c:\temp MySite.LcalFlder = "c:\temp" 'Check fr existence f remte flder "/pub/cuteftp" b = MySite.RemteExists("/pub/cuteftp/") If (Nt CBl(b)) Then 'Verify existence f remte flder MsgBx "Remte flder nt fund!. Please make sure that the Pub flder exists n the remte Site" Quit(1) End If 'Nw dwnlad the index file t the lcal destinatin flder MySite.Dwnlad "/pub/cuteftp/index.txt" 'Cmplete. Shw the status f this transfer. MsgBx "File dwnladed attempted. Status: '" + MySite.Status + "'" MySite.Discnnect MySite.Clse Scheduling Scripts with the Windws Task Scheduler The Windws Task Scheduler is the recmmended tl fr setting yur TE scripts t run at specific times, but yu can als use the NT 4 AT Scheduler. T schedule a task 1. Click Start > Cntrl Panel > Administrative Tls > Task Scheduler. 2. Duble-click Add Scheduled Task. The Scheduled Task Wizard appears. 3. Click Next, then click Brwse. The Select Prgram t Schedule dialg appears. 4. Navigate t the script that yu created, click it, then Open. Yu are returned t the Scheduled Task Wizard. 5. Prvide a name fr the task, r keep the default, which is the filename, specify hw ften t run the script, then click Next. 6. Specify the starting time and date (if yu specified Daily, Weekly, r Mnthly, r One time nly) and recurrence (if yu specified Daily, Weekly, r Mnthly), then click Next. 7. Type the user name and passwrd fr the accunt that will run the script (e.g., the EFT Server accunt in Windws), then click Next. 8. If yu want t cnfigure advanced prperties, select the check bx, then click Finish. If yu want t disable the task withut deleting it, pen the task in the Scheduled Tasks dialg 239

240 CuteFTP v9 User Guide bx (see step 1 abve), then n the Task tab, clear the Enable check bx. T delete the task, in the Scheduled Tasks dialg bx (see step 1 abve), click the task, then click Delete. If yu d nt have the Scheduled Tasks flder, yu can use the NT 4 AT scheduler. In Windws 2000 r Windws XP, yu can cnfigure the Transfer Engine s that it can run when n ne is lgged in. In Windws NT 4, yu must have Internet Explrer 4 r higher and the Offline Brwsing Pack installed t see the Scheduled Tasks flder. Scheduling Scripts with the Windws NT 4 AT Scheduler The Windws Task Scheduler is the recmmended tl fr running TE scripts at specific times, but yu can als use the NT 4 AT scheduler. If yu want t use the Windws NT 4 AT Scheduler t run TE scripts at specific times, fllw these guidelines: A user must be lgged in at the time the task is scheduled t run, thugh the cmputer can be lcked. Include the /interactive switch in each task. Include the full path t the script with the file name and extensin. The fllwing example runs a script at 2:12 pm, every day f the week. The script is n the cmputer's C drive, in the example flder, and is named te-test.vbs. Fr example: at 14:12 /interactive /every:m,t,w,th,f,s,su c:\example\te-test.vbs Fr mre details and switches fr the AT Scheduler type AT/? at the cmmand prmpt. Yu can install a GUI task scheduler as part f Internet Explrer if yu have versin 4 r higher, see The task scheduler is part f the Offline Brwsing Pack. Running the Transfer Engine withut a User Present The Transfer Engine is a prcess, nt a service. Hwever, yu can execute scripts while the system is nt lgged in if yu prperly cnfigure Windws DCOM cnfiguratin fr the Transfer Engine. Carefully read and fllw the steps belw. A sample script is prvided. T cnfigure the TE under the DCOM cnfiguratin applet 1. Click Start > Run. 2. In the Run dialg bx, type: DCOMCNFG 3. Click OK. The Windws Cmpnent Services dialg bx appears. 4. In the left pane, expand Cmpnent Services, expand Cmputers, expand My Cmputer, expand DCOM Cnfig, then click TECnnectin Class. 5. Right-click TECnnectin Class, then click Prperties. The TECnnectin Class Prperties dialg bx appears. 6. Click the Identity tab. 240

241 Transfer Engine (Scripting) 7. Under Which user accunt d yu want t use t run this applicatin, click This user, then prvide a valid user name and passwrd. It must be the same user as established under yur task scheduler's run as prperty (if applicable), s that the scheduler service can call the COM bject as a user. This will enable the Transfer Engine t run with the user settings, and if necessary, access pre-established SSL certificates (fr secure cnnectins). 8. Click OK t save the changes, and clse the Prperties dialg bx. 9. Clse the Cmpnent Services dialg bx. Cnfiguratin Ntes If the system is currently lgged in when the TE runs, it runs as the user that yu specified in the TECnnectin Class Prperties dialg bx. Yu will nt see the TE icn in the system tray when running CuteFTP's main interface. Als, the hard cded user's settings are emplyed when the TE is run, nt thse f the currently lgged in user. This is nt an issue if yu are running the TE while the system is nt lgged in. Yu shuld test yur script frm the cmmand line while lgged in. Yu can als write t the Event Viewer r a lcal text file t debug a script when run n system startup if necessary. Belw is a sample script that includes event viewer lgging f transactins. Yur script shuld nt cntain Message Bx functins r any ther functin that requires user input r shws a dialg bx. Dialg bxes cannt display these prmpts while the system is nt lgged in. Set yur verwrite actins under CuteFTP's Glbal Optins\Transfer\Smart Overwrite t Always Overwrite t avid any verwrite prmpts, r pre-define varius rules t cver varius verwrite scenaris. (See als Disabling Prmpts.) Cnst EVENT_SUCCESS = 0 Set bjshell = Wscript.CreateObject("Wscript.Shell") bjshell.lgevent EVENT_SUCCESS,"AT Laded me" Set MySite= CreateObject("CuteFTPPr.TECnnectin") MySite.Optin ("ThrwErrr") = False MySite.Hst = "ftp://annymus:user@user.cm@ftp.glbalscape.cm/pub/cuteftp" bjshell.lgevent EVENT_SUCCESS,"vars set" MySite.Cnnect bjshell.lgevent EVENT_SUCCESS, "cnnected" MySite.Dwnlad "index.txt", "c:\temp" bjshell.lgevent EVENT_SUCCESS, "dwnladed" MySite.Discnnect MySite.Clse Running the Transfer Engine frm a SQL Jb Yu can use SGL functin sp_oacreate t create a TECnnectin bject. SQL runs ftpte and hides all windws. SQL uses a special instance f ftpte exe, which cannt prmpt fr user name and passwrd. Specify a lcal dwnlad path r filename. While ptinal, it's a gd idea t make sure that it is ging where yu intend. Als, make sure that the lcal path has the apprpriate NTFS permissins t allw the TE t have full cntrl. Fr scripted r scheduled tasks use an therwise unused accunt fr scheduled TE tasks. Once the CuteFTP TE (transfer engine) is started, anther instance cannt be created. Windws treats the lggedin user differently than the lgged-ut-user and DCOM errrs may ccur. Fr instance, if a recurring backgrund prcess has already run befre the user lgs in, nce the user lgs in and the backgrund prcess starts again, a DCOM errr will ccur. Example Transfer Script varchar(255) int 241

242 CuteFTP v9 User Guide int varchar(255) PRINT '---start' = sp_oacreate OUT = 'Hst', 'ftp.mysite.cm' = OUT = OUT = OUT = 'Cnnect' = 'dwnlad', NULL, '/pub', "e:/eee" = OUT = PRINT '---finish' Cnfiguratin Ntes SQL cannt use an already running instance f ftpte exe. The CuteFTP interface cannt cmmunicate with an ftpte instance created by SQL. When a scheduled task runs as user X while user X is lgged in, the prfile path will be set t that user's directry (C:\Dcuments and Settings\X\). Hwever, when a scheduled task runs as user X while user X is *nt* lgged in, the prfile path will be set t the default user directry (C:\Dcuments and Settings\Default User\). Therefre, the desired SSL certificates frm C:\Dcuments and Settings\X\Applicatin Data\Glbalscape\CuteFTP\certs.crt shuld be cpied t C:\Dcuments and Settings\Default User\Applicatin Data\Glbalscape\CuteFTP\certs.crt If yu use UsePrxy, be sure t specify any prxy infrmatin. Please refer t Prperties fr mre infrmatin. Add a cuple f lg lines s that it can write t the lg whenever smething happens successfully. Add it after the cnnect line, s that yu can see hw far it gets. T make sure yu are cnnecting lng enugh t get data, use the GetList methd t write a list t a lcal file. Help with Scripts CuteFTP is able t accmmdate a wide range f scripts. Therefre, we are unable t ffer technical supprt n individual scripts, ther than what is available in the help files and nline Knwledge Base. If yu are having truble with yur script, try t perfrm the desired actin manually, using the CuteFTP interface. If yu cannt, then trublesht that prblem first and then retry yur script. If yu are able t perfrm the desired actins in the desired sequence when using the interface, then the prblem is nt with CuteFTP r the server. The next thing t d is t trublesht yur script line by line. Disabling Prmpts T run the Transfer Engine with prmpts disabled Launch the TE manually and supply the nprmpts parameter. Example 1. On the Windws Start menu, click Run. 2. In the Run dialg bx, type: "C:\Prgram Files\Glbalscape\CuteFTP\TE\ftpte.exe" nprmpts. 242

243 Transfer Engine (Scripting) 3. Click OK. Suppressing prmpts may cause lckups if n default actin is available fr the event in questin, r if the prmpt was prduced by an errr. When running the TE in this mde using Windws scheduler frm a different user accunt, the TE will nt be accessible frm its COM r GUI interface and can nly be unladed via the Task Manager. The best way t avid prmpts is t prperly cnfigure the TE ahead f time t cver all pssible prmpt scenaris, such as verwrite cnditins, r SSL server certificate acceptance dialgs. Fr example, set yur verwrite actins under CuteFTP's glbal settings t Always Overwrite t avid any verwrite prmpts, r pre-define varius rules t cver varius verwrite scenaris. Yu can then exprt thse rules as registry entries and imprt them nt the target cmputer. Yu can als tell the TE t aut-accept SSL r SSH certificates using the AutClseMethd parameter f the Optin prperty. Als refer t the fllwing truble shting tpic regarding running the TE while nt lgged in. Trubleshting TE Prblems High Memry Usage with the Transfer Engine If yu leave the Transfer Engine running fr extended lengths f time, it may begin t cnsume large amunts f memry. Set the CuteFTP Transfer Engine t remve successful items frm the queue t avid this prblem. T remve successful items frm the queue in a script Use the TECmmand methd with the DELETEFINISHED r DELETEALL parameter. N Timeut when Cnnecting t an Unavailable Hst If the Transfer Engine's Cnnectin methd refuses t timeut when cnnecting t a nn-existing r temprarily unavailable hst, try setting the thrw errr t true. The Cnnectin methd des nt have a built-in timeut value. It will keep trying t cnnect indefinitely. Because the event is synchrnus, subsequent lines in the script, including cnditinal statements fr determining the cnnectin status f the TE, never get called. Examples: A few pssible wrkarunds, and help fr accepting and rejecting certificates: MySite.Optin("AutClseMethd") = 2 '1 - aut accept, 2 - aut reject, 0 - default n aut MySite.Optin("AutClseDelay") = 12 ' default value is 60 sec Set Optin("AutClseMethd") prperty t 1 r 2 in rder fr script can cntinue its prcessing: MySite.Optin("AutClseMethd") = 1 will aut accept cert and cntinue MySite.Optin("AutClseMethd") = 2 will aut reject cert and finish with errr MySite.Optin("AutClseMethd") = 0 default: will nt clse prmpt n timeut My Scheduled Scripts N Lnger Run while nt Lgged In If yu have installed the Security Update fr Micrsft Data Access Cmpnents (MDAC) Security Patch MS yu may have prblems using scripts t cnnect t secure sites. 243

244 CuteFTP v9 User Guide Yu can get yur scripts t wrk again by mving yur certificate file. The CuteFTP certificate files generally reside in a specific user's flder, like: C:\Dcuments and Settings\jsmith\Applicatin Data\Glbalscape\CuteFTP\Security\certs.crt. Mve the certs.crt file t the Default User Flder. Fr example; C:\Dcuments and Settings\Default User\Applicatin Data\Glbalscape\CuteFTP\Security\certs.crt, and yur scripts shuld nw wrk. The file name fr Security Patch MS is Q823718_MDAC_SecurityPatch.exe. Scripting Technical Supprt Due t the wide range f scripts that CuteFTP is able t accmmdate, we are unable t ffer technical supprt n individual scripts ther than what is available in the help files and nline Knwledge Base. If yu are having truble with yur script, try t perfrm the desired actin manually, using the CuteFTP interface. If yu cannt, then trublesht that prblem first, then retry yur script. If yu are able t perfrm the desired actins in the desired sequence frm within CuteFTP, then the prblem is nt with CuteFTP r the FTP Server. The next thing t d is t trublesht yur script line by line. 244

245 Chapter 12. Trubleshting Cnnectin and Transfer Errrs The tpics belw prvide infrmatin fr trubleshting cnnectin and file transfer errrs. Als refer t the CuteFTP-related Knwledgebase articles at Antivirus Prblems Outging cnnectins can be affected by the presence f firewall r anti-virus sftware n the lcal cmputer r netwrk cnnectin. Either ne can blck the prts needed t make a successful FTP cnnectin t a remte server. Cnfigure yur antivirus sftware s that prts 20 and 21 are pen (nt blcked). It may als be necessary t grant specific permissin fr CuteFTP t access thse prts. If yu need help cnfiguring yur sftware, cnsult the dcumentatin r the supprt sectin f their website. Symantec (Nrtn) supprt site: McAfee supprt site: Micrsft Windws Firewall Refer t Windws Firewall Blcking Cnnectins. Cannt Clse Data Transfer Gracefully If the errr message "Cannt clse data transfer gracefully" is generated after a dwnlad is cmplete, it indicates that CuteFTP has received all the data it needs, but the server is still sending infrmatin. Since that data is still transmitting, CuteFTP frces the cnnectin t clse. Cannt Cnnect t Server Making ne r mre minr cnfiguratin changes usually slves cnnectin prblems quite easily. In the Lg pane, a cmplete list f all cmmunicatins and cmmands between CuteFTP and the FTP server t which yu are trying t cnnect appear. If yu cannt cnnect, at least ne ERROR message appears in the Lg pane in red text, which yu prbably need t scrll up t see. That errr message shuld tell yu the specific reasn why yu cannt cnnect. The mst cmmn cnnectin prblem is that the Hst Address, the User Name r the Passwrd has been entered incrrectly. Make sure all three pieces f infrmatin exactly match what the administratr f the Server yu are cnnecting with prvided. Glbalscape des nt prvide yu with an FTP server, username, r passwrd fr uplading files. The Internet Service Prvider/Web Hsting Prvider t which yu want t uplad files prvides yu with the username, passwrd, and FTP accunt infrmatin required t cnnect t their server. Mst Internet Service Prviders/Web Hsting Prviders have this infrmatin available n their Web pages. If yu cannt cnnect t yur server: 1. Verify that the destinatin server name and IP address is crrect 2. Verify that the cnnectin prt number is crrect (n the Type tab f Site Prperties). Fr example, fr FTP cnnectins, it is usually prt The remte server may be temprarily r permanently inaccessible (try again later). 245

246 CuteFTP v9 User Guide 4. Verify that yu have chsen the right prtcl (SSH2, SSL, FTP, etc.) and have setup all required ptins fr that prtcl. 5. The remte server may be refusing multiple cnnectins frm the same client. Try using nly ne cnnectin thread when cnnecting t this particular server (n the Optins tab f Site Prperties). 6. Try pinging the address (see Trubleshting Tips fr details). 7. If yu are using a ruter, verify the ruter is up and running (check by pinging it and then ping an address utside f the ruter). 8. D a tracerute t the destinatin t verify all ruters alng the cnnectin path are peratinal (see Trubleshting Tips fr details). 9. Verify that yur Windws netwrk cnnectin is setup prperly. (Can yu cnnect t the Internet?) 10. Verify that yur lcal sftware r hardware firewall is nt blcking utbund cnnectins riginating frm CuteFTP. 11. Verify that yur anti-virus sftware is nt at fault (disable it temprarily while yu attempt t recnnect). Cannt Create Multiple Cnnectins t the Same Server If CuteFTP des nt pen new cnnectins when yu try t start new sessins, r if it des nt let yu brwse while transferring files, yu can frce CuteFTP t pen new cnnectins. T pen multiple cncurrent cnnectins 1. Select the Site in the Site Manager then d ne f the fllwing: On the main menu, click File > Cnnect > Cnnect. Click Cnnect. Press CTRL+T. 2. Repeat t create mre cnnectins t the same Site. T cnfigure CuteFTP t pen new cnnectins fr multiple transfers 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde. The Transfer ptins appear. 3. Clear the Allw transfers t ccur ver the existing (brwse) sessin check bx. 4. Click the Cnnectin nde. 5. In the Per Site max cnnectins/transfers bx, ensure the value is greater than 1 (2-200). 6. Click OK, then attempt t make multiple cnnectins t the same server. If the prcedures abve d nt wrk, it is pssible that yur server is refusing multiple cnnectins. 246

247 Trubleshting Cnnectin and Transfer Errrs Cannt Dwnlad Executable Files If yu use remte filters while cnnecting with sme Unix r Linux servers, CuteFTP cannt dwnlad sme f the files. Yu must turn ff the filters t dwnlad the files. T turn ff remte filters 1. In the Site Manager, click the Site yu want t change. 2. D ne f the fllwing: Right-click the Site, then click Prperties. On the main menu, click File, then click Prperties. 3. Click the Actins tab. 4. Click Filter. The Filter dialg bx appears. 5. Delete any filters listed in Remte filter, except fr the -L filter. 6. Click OK t clse the Filter dialg bx. 7. Click Cnnect and dwnlad yur files. Cannt Dwnlad Files frm a VMS Server If yur dwnlads frm a VMS server repeatedly restart and try t cmplete but never d, try turning ff the SIZE and MDTM cmmands. T turn ff the SIZE and MDTM cmmands 1. On the main menu, click Tls, then click Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Smart Overwrite. The Smart Overwrite ptins appear. 3. In the Advanced Optins area, clear the Use SIZE and MDTM cmmands t gather precise details check bx. 4. Click OK. Cannt Initiate Data Transfer If yu receive this errr frm a server, it culd indicate ne f the fllwing prblems: The server yu are trying t lg int requires a special user name and r passwrd in rder t transfer files. Cntact the server administratr, and find ut if yu need t use a special user name r passwrd, and whether yu have permissin t access that server. The permissins n the server are incrrect, s even thugh yur user name and passwrd are crrect, yu are unable t uplad r dwnlad. Cntact the server administratr, and make sure that yur user name and passwrd have read and write permissins set crrectly. Yu cannt uplad because the server yu are sending t is full and will nt allw mre files t be upladed. Delete files that are n lnger used r ask the administratr fr mre space n the system. The file name yu are using has a space r a character that the server will nt allw. 247

248 CuteFTP v9 User Guide Duble-check with the server administratr regarding which characters are accepted n the server, and rename the files t an acceptable name. Fr example, sme Web hsting prviders nly allw lwer-case characters, n spaces, and the files must be named HTM instead f HTML. Many hsting prviders list this infrmatin n their websites. A cmmunicatin errr is ccurring between the FTP hst and yur cmputer, making data transfer impssible. If CuteFTP has wrked in the past, change nthing and wait a little while t see if the prblem is caused by Internet traffic. If this is the first time yu are trying t cnnect, try using hst types ther than Aut-detect. Cannt Reslve Hst Name The Cannt Reslve Hst Name message is displayed when CuteFTP cannt make a cnnectin t the FTP hst address that yu specified when yu set up the cnnectin. It culd be a website that is nt up at the mment r des nt exist. There are several ways t apprach this situatin: Make sure yu are cnnected t the Internet. If yu are nt cnnected t the Internet, yu will need t cnnect befre yu can cnnect t any FTP sites. Make sure yu typed in the FTP Hst Address crrectly. This wuld be just the hst address f the server. Fr example, if yu were given an FTP hst address in the frmat: ftp://ftp.yurhst.cm, yu wuld nly type ftp.yurhst.cm. Als, be sure there is nthing after the hst address, especially slashes ("/") indicating subdirectries. If the server des nt autmatically put yu in yur default directry when yu lg in t it, then yu can add the directry int the "Default Remte Directry" bx when cnfiguring this Site. If yu d nt knw the FTP Hst Address fr yur site, yu will need t cntact yur server administratr fr mre infrmatin. Glbalscape supprt staff des nt knw r keep track f FTP hst addresses f every ISP/Web server. If yu have a firewall r prxy server, make sure CuteFTP is prperly cnfigured t wrk with the prxy server. Yu can edit the firewall r prxy settings by clicking Tls > Glbal Optins and expanding Cnnectin and selecting Prxy Server. If yu are nt sure what the settings fr the prxy shuld be, yu will need t cntact yur netwrk r system administratr fr that infrmatin. If all f these ptins fail with the same results, cntact the administratr f the server t which yu are attempting t cnnect t in rder t reslve the prblem. Cannt See Remte Files r Flders If yu cannt see yur directry listing r files, yu can try these slutins then attempt t cnnect again. Yur cnnectin lg shws a LIST-L cmmand instead f the nrmal LIST 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Navigatin nde, then click Links. The Links ptins appear. 3. Clear the Attempt link reslutin using LIST -L cmmand check bx, then click OK. Use the -L filter n the server 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Actins tab, then click Filter. The Filter Prperties dialg bx appears. 3. Select the Enable filtering check bx. 4. Select the Enable server side filtering check bx, then type -L in the Remte filter bx. 5. Click OK t clse the Filter Prperties dialg bx and accept the changes. 248

249 Trubleshting Cnnectin and Transfer Errrs 6. Click Cnnect r OK. Change cnnectin type 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Type tab. 3. In the Data cnnectin type bx, click Use PASV. 4. Click Cnnect r OK. If yu still cannt cnnect, fllw the same steps, but click Use PORT. Turn ff all filters 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Actins tab, then click Filter. The Filter Prperties dialg bx appears. 3. Clear the Enable filtering check bx, then click OK. 4. Click Cnnect r OK. Change server Hst type 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Type tab. 3. In the Server type bx, click the first server type in the list (Unix). 4. Click Cnnect r OK. If that des nt wrk, try the next server type n the list. Turn ff MdeZ cmpressin 1. Click Tls > Glbal Optins. 2. Expand the Transfer nde, click MODE Z, and then clear the Apply Mde Z cmpressin t the fllwing extensins when pssible check bx. 3. Click OK. Send an extended lg t Technical Supprt If nne f the slutins abve reslve the prblem, btain a raw directry listing and submit it, alng with details f the prblem, t Glbalscape Technical Supprt. 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde, then click Lgs. The Lg ptins appear. 3. Select the Recrd/display raw directry listing in lgs check bx. 4. Recnnect t the prblem Site. 5. Once cnnected, right-click in the Lg pane, then click Cpy Entire Lg t Clipbard. 6. Paste the selectin (CTRL+V) int an message. 7. Describe the prblem, what yu have already tried and include infrmatin abut the cmputer yu are using (perating system, Internet cnnectin, etc.). 8. Submit yur supprt request using ur supprt submissin frm. 249

250 CuteFTP v9 User Guide Child Transfer Failed If yu attempt t transfer a flder r directry and see this errr, it simply means that an item r items within the flder failed t transfer. Yu can check yur cnnectin lg t find a mre detailed errr describing why the item failed t transfer. Cnnecting after a 425 Errr If yu receive an 425 errr, r an errr that says "Cannt pen data cnnectin" r "Cannt build data cnnectin," try cnnecting in PASV mde. If yu still cannt cnnect, yu can try cnnecting via HTTP and prt 80. Enter all yur infrmatin as yu wuld fr an FTP Site. T cnnect via HTTP and prt On the main menu, click File > New > HTTP Site. The Site Prperties dialg appears shwing the General tab. 2. In the Label bx, prvide a name fr the Site. 3. In the Hst Address bx, prvide the regular FTP address fr the Site. 4. In the Username bx, prvide yur user name fr the Site. 5. In the Passwrd bx, prvide yur passwrd fr the Site. 6. Click Cnnect. Cpy and Paste Functins Remve File frm the Remte Flder FTP Servers d nt supprt the Cpy cmmand. If yu cpy a file frm a flder in the Remte pane and then try t paste it in any flder in the Remte pane itself, yu are mving the file frm the riginal flder t that flder r t a new lcatin n the server. FTP prtcl des nt allw yu t retain the riginal file and create a cpy in ther flder in the remte lcatin. Yu can use the Cut and Paste cmmands t restre the riginal file. This is a limitatin f the FTP prtcl, nt CuteFTP. The cpy cmmand is available, because yu can cpy files frm the Remte t the Lcal pane, t the queue, etc. T cpy a file r flder frm ne remte flder t anther remte flder 1. Dwnlad the file. 2. Uplad the file t the new lcatin. Anther ptin is t perfrm a Site-t-Site transfer; hwever, many servers d nt supprt Site-t Site transfers. Errr 421 Messages Cmmn 421 errrs include: Errr 421 Service nt available, clsing cntrl cnnectin. Errr 421 User limit reached Errr 421 Yu are nt authrized t make the cnnectin Errr 421 Max cnnectins reached Errr 421 Max cnnectins exceeded 250

251 Trubleshting Cnnectin and Transfer Errrs Yu can receive a 421 errr if the FTP server yu are cnnected t limits the ttal number f cnnectins available r limits the cnnectins available t ne user. T clear the errr, change the number f per Site max cncurrent transfers, remve items frm the Queue Windw, and make sure nly ne instance f CuteFTP is running. T change per Site max cncurrent transfers 1. On the main menu, click Tls > Glbal Optins. 2. Click the Cnnectin nde. 3. Set Per Site max cncurrent transfers t 1. (By default it is set t 2. This setting limits the number f cnnectins t any ne FTP Site. T remve items frm the Queue Windw Smetimes the Queue Windw can becme cluttered with unfinished transfers. T clear the queue, right-click inside the Queue Windw, then click Remve All. T verify nly ne instance f CuteFTP is running n yur system. 1. Right-click n the Windws Task bar, then click Task Manager. 2. On the Applicatins tab, view the list f running tasks t determine if CuteFTP is listed mre than nce. 3. If mre than ne instance is listed, click ne f them, then click End Task. Failed t Establish Data Scket This errr usually ccurs when trying t cnnect in PASV mde t a Site that nly accepts PORT mde cnnectins. Change the cnnectin type frm PASV mde t PORT mde t cnnect t the Site. T switch frm PASV t PORT mde 1. In the Site Manager, click the prblem Site. 2. On the main menu, click File > Prperties. 3. Click the Type tab. 4. In the Data cnnectin type list, select the Use PORT check bx. 5. Click OK. FTP Status and Errr Cdes CuteFTP displays FTP status cdes in the lg windw. The cdes are numbered accrding t their categry. Sme cdes represent errrs, while mst cdes simply cmmunicate the status f the cnnectin. Refer t the Glbalscape Knwledgebase article #10142 fr a list f cdes and descriptins. High Memry Usage If the Transfer Engine (SDK) f the CuteFTP wrks fr extended perids f time, it begins t cnsume large amunt f system resurces, such as memry and hard drive space, due t lg and queue requirements. 251

252 CuteFTP v9 User Guide Yu can set CuteFTP t remve successful items frm the queue t help alleviate this prblem. Successful items are remved even if tasks were run withut the user interface pen. Each finished queue item takes up abut 500 bytes f memry until the Transfer Engine is clsed. Disable the lgging functin t imprve resurce management. T remve successful items frm the queue 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Events. The Events ptins appear. 3. Select the Remve successful transfers frm the queue autmatically check bx, then click OK. T disable lgging 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the General nde, then click Lgs. The Lg ptins appear. 3. Clear the check bxes fr lgs yu d nt need. HTTP Status and Errr Cdes During yur HTTP sessins, yu will receive varius numbered cdes frm Web servers. When cnnected via HTTP, CuteFTP displays these cdes in the Lg windw. Sme cdes represent errrs; mst thers simply cmmunicate the status f the cnnectin. Refer t the Glbalscape Knwledgebase article #10141 fr a list f cdes and descriptins. Installshield Errr 1628: Failed t Cmplete Script-Based Installatin The fllwing errr message can ccur at run time when yu are trying t uninstall, repair, r update an installatin. Errr 1628: Failed t cmplete script based install. This errr message is caused by the Windws Installer Service and is ften caused by the installatin itself. Pssible Cause 1 This errr message is ften caused when the uninstallatin lg file becmes crrupt. This can happen if the installatin is smehw crrupt. Fix: In the Windws Task Manager, end the prcess that is running IDriver.exe: 1. Right-click the Windws Task bar, then click Task Manager. 2. On the Prcesses tab, click the Image Name clumn t srt it alphabetically. 3. Review the running prcesses t see if idriver.exe is running. 4. If idriver.exe is running, click it r right-click it, then click End Prcess. Run the installatin again t see if the errr still ccurs. Pssible Cause 2 This errr can als ccur if the Windws Installer Service is nt prperly cnfigured n yur cmputer r if the installatin is created with a newer versin f the Windws Installer Service than the ne n yur cmputer. 252

253 Trubleshting Cnnectin and Transfer Errrs Fix: T fix this issue, install the latest Windws Installer Service n yur cmputer. Instructins and dwnlad links fr the Windws Installer are listed belw, srted by perating system. Windws 95/ 98/ Me: Windws NT 4.0 r 2000: Windws XP: Windws XP cntains Windws Installer versin 2.0. Yu shuld nt have t install the Windws Installer Service (MSI engine) n Windws XP. Restart yur cmputer and run the installatin again t see if the errr cntinues t ccur. Pssible Cause 3 This errr message may als ccur if a file in the Temp directry is cnflicting with the files used by the installatin while it is running. Fix: Delete the entire cntents f the Temp directry: 1. Duble-click the My Cmputer icn n yur desktp, r right-click Start, then click Explre. 2. Navigate t the Temp directry, fr example, C:\Windws\Temp. 3. Click in the directry, then right-click and click Select All (r CTRL+A). 4. On the tlbar, click Delete r right-click the selectin, then click Delete (r CTRL+X). A cnfirmatin message appears. 5. Click Yes. Run the installatin again t see if the issue is reslved. Nt Enugh Credits t Dwnlad Yu may nt be able t dwnlad frm sme FTP Sites until yu have upladed smething t them. In ther wrds, yu have t give them a file befre they give yu ne; a type f file trading. Mst f these "rati Sites" have a text file that explains hw t uplad files t them t get credits. If yu have any prblems, cntact the server administratr. (Glbalscape des nt have this infrmatin.) Shell cannt get Data frm TE If yu see this errr, there is nt enugh space in yur Temp flder t run CuteFTP. T crrect the errr Make sure the path t the Temprary Files flder (Temp) is valid. Make sure there is enugh space t run the prgram n the drive where the Temprary Files (Temp) flder exists. Cnfiguratin Ntes A valid path fr a temp flder n a Windws 2000 r XP cmputer wuld be similar t C:\Dcuments and Settings\USER\Lcal Settings\Temp A valid path fr a temp flder n a Windws NT cmputer wuld be similar t C:\Temp This issue is mre likely n cmputers with several different users with different accunts; each user's accunt needs a valid Temp flder n a hard drive with enugh rm t run CuteFTP. 253

254 CuteFTP v9 User Guide Site-t-Site Transfer Limitatins Yu can cnnect t tw servers and transfer files between them using FXP (File Exchange Prtcl). FXP lets yu cpy files frm ne FTP server t anther. CuteFTP supprts this mechanism fr transferring files between Sites. When yu transfer files between tw remte hsts using an FXP client, the maximum transfer speed des nt depend n yur cnnectin, but n the cnnectin between the tw hsts, which is much faster than yur wn cnnectin. Yu cannt see the prgress r the transfer speed f the files, because it is a direct cnnectin. Althugh transferring files using FXP is very easy, there are a few restrictins in transferring the files. Keep the fllwing pints in mind befre using FXP: Bth hsts must t supprt PASV mde and must allw PORT cmmands t freign hsts. The FXP client cmmunicates with the destinatin FTP server by sending a PASV cmmand. The surce FTP server cnnects t the data prt reprted by the destinatin server after a successful PASV cmmand. All the data then ges directly frm the surce t the destinatin server, and bth servers nly reprt fail r success messages t the FTP client. Scket Errrs Refer t the Glbalscape Knwledgebase fr infrmatin abut the fllwing scket errrs: Scket errr 0: Scket errr 10054: Scket errr 10055: Scket errr 10060: Scket errr 2000: Fr infrmatin abut Winsck errr cdes, refer t Knwledge Base article Overwrite Repeatedly Prmpts Me If yu are getting numerus verwrite prmpts and want t avid receiving them in the future, cnfigure a default rule fr the verwrite cnfiguratin panel. T add a rule 1. On the main menu, click Tls > Glbal Optins (r press ALT+F7). 2. Expand the Transfer nde, then click Smart Overwrite. The Smart Overwrite ptins appear. 3. In the Fr matching files list, click Use Rules. 4. Select the Ignre zer byte files check bx. 5. In the Fr matching flders list, click Use Rules. 6. Click Cnfigure Rules. The Overwrite Rules dialg bx appears. 7. In the If the destinatin file date is list, click lder. 8. In the and size is list, click smaller. 9. In the during list, click any transfer. 10. In the then list, click verwrite. 11. Click Add. The new rule appears in the list. Add mre rules as needed. Belw are sme recmmendatins: 254

255 Trubleshting Cnnectin and Transfer Errrs If destinatin file date is the same and size is the same during any transfer then skip. If destinatin file date is lder and size is different during any transfer then verwrite. If destinatin file date is n matter and size is smaller during any transfer then resume. If destinatin file date is newer and size is larger during any transfer then skip. 12. Click OK t save the rule and clse t he Overwrite Rules dialg bx. 13. In the Prmpt timeut actin list, click Skip. 14. Select the Timeut in check bx, and leave the time at 30 secnds. 15. Select the Resend LIST cmmand as necessary check bx. 16. Select the Use SIZE and MDTM cmmands t gather precise details check bx. 17. Click OK. Permissin Denied Every time an FTP accunt (fr uplading yur Web pages) is pened, yur server determines all the things that yu are allwed t d, like uplad, dwnlad, write t a file, delete a file, make new directries, etc. If permissins have nt been set up crrectly, yu will nt be able t uplad yur files t the server. If yu receive this message, yur server administratr has nt established yur permissins crrectly. Cntact the server administratr t reset the permissins. If nne f the transactins yu try with CuteFTP seem t be cmpleted, refer t the lg pane fr any entries that are clred red r any messages indicating a ptential prblem. Yu can cpy the cntents f the lg int an r text file t send t yur administratr r Web hsting prvider. Refer t Glbalscape Knwledgebase article #10142 and Glbalscape Knwledgebase article #10141 fr infrmatin abut errr cdes. Prt Already in Use Errr with Dial-up VPN If yu are cnnecting t a Virtual Private Netwrk thrugh a mdem and receive the Prt already in use errr when trying t cnnect, yu might need t crrect yur cnnectin settings. T review/crrect cnnectins settings 1. On the main menu, click Tls > Glbal Optins. 2. In the left pane, expand Cnnectin, then click DUN/LAN. 3. In the right pane, click Cnnect t the Internet using a LAN. CuteFTP uses an existing cnnectin defined n yur cmputer. 4. Click OK. If Cnnect t the Internet using a LAN is already selected, verify yur cmputer's VPN settings. T verify yur cmputer's cnnectin settings 1. D ne f the fllwing: In the Windws Cntrl Panel, click Internet Optins. In Internet Explrer, click Tls > Internet Optins. 2. Click the Cnnectins tab. The cnnectin settings fr ne r mre internet cnnectins appear n this tab. 3. The Dial-up and Virtual Private Netwrk settings bx displays dial-up and VPN cnnectins that are defined n yur cmputer. 255

256 CuteFTP v9 User Guide 4. Click LAN Settings t view the lcal area netwrk and prxy server settings. Changing any f these settings can cause yur cmputer t lse its cnnectin t yur netwrk and/r the Internet. D nt change them unless yu knw what they shuld be. Yur netwrk administratr, Web hsting prvider, r Internet Service Prvider (ISP) can prvide yu with this infrmatin. Glbalscape des nt have this infrmatin; hwever, many ISPs prvide this infrmatin n their websites. Transferring t Case-Sensitive Servers Sme case-sensitive servers treat tw files with same name but different case as tw different files. CuteFTP is nt case-sensitive and, when uplading r dwnlading files, it treats tw files with same name and different case as the same file. Fr example, if yu want t uplad TEXT.txt file and a text.txt file already exists n the server, then it will see the files as the same and prmpt yu t verwrite the text.txt file. T set a site as case sensitive 1. Display the Site Manager, right-click the Site, then click Prperties. 2. Click the Type tab. 3. In the Server type list, click Unix-cmpatible. 4. Click Cnnect r OK. Trubleshting Cnnectins A cmmn file transfer errr is the inability t cnnect t the server. T test yur cnnectin, yu can use the ping and tracert utilities. Ping and tracert are DOS cmmand-line utilities that yu can use t trublesht cnnectin prblems. Third-party applicatins are als available that d basically the same thing, but prvide a graphical interface fr thse wh are nt cmfrtable entering cmmands at a cmmand prmpt. Ping - When yu ping a remte hst, yur cmputer sends "ech request" packets t the target hst and listens fr "ech respnse" replies. Ping als estimates the rund-trip time, generally in millisecnds, recrds any packet lss, and prints the ping statistics when finished. Tracert - Tracert is used t determine the rute taken by packets acrss an IP netwrk. This is useful t determine where the cnnectin prblem exists, whether with yur CuteFTP cnfiguratin, at the server, r smewhere in between, such as blcking by a firewall. TCPView is a Windws utility, available fr free n Micrsft TechNet at T use ping r tracerute 1. On the Windws task bar, click Start > Run. The Run dialg bx appears. 2. In the Run bx, type cmd, then click OK. The Windws Cmmand Prmpt appears. 3. At the prmpt, type the cmmand and then the IP address r dmain name f the server t which yu are trying t cnnect. Fr example, t test that yu are using ping crrectly, try pinging the Glbalscape web site and d a tracert t the Gmail server, as shwn in the illustratins belw: ping -r- 256

257 Trubleshting Cnnectin and Transfer Errrs tracert Windws XP SP1 will nt respnd t an ech request n the public Internet, but yu shuld have updated t SP2 t get the latest security fixes. The ping cmmand functin has several switches available, as described in the Windws XP dcumentatin available at At that same address, click in the table f cntents fr mre Windws XP trubleshting tips. Truncated Listings If yu cnnect t a server and the lg displays the message 266-Optins: -1 r 226 Output truncated t 2000 matches, the server cannt display mre than 2000 items in file listings. This is a limitatin f the server t which yu are cnnecting, nt CuteFTP. Using CuteFTP behind a Ruter In mst cases, CuteFTP des nt have any prblems wrking behind a ruter. If yu are having prblems, try transferring in PASV mde. T transfer in PORT mde r fr secure transfers, refer t yur ruter's dcumentatin fr infrmatin n hw t cnfigure the ruter fr such transfers. If yu are behind a NAT firewall and the FTP server is n a different netwrk, yu can nly make data transfers in PORT mde using a Clear Cmmand Channel SSL cnnectin. 257

258 CuteFTP v9 User Guide If cnnectins r transfers fail, try ne r mre f the fllwing pssible slutins: 1. Ask the FTP server's administratr if the server and its netwrk are cnfigured t allw FTP in PASV mde. 2. Review the ruter dcumentatin fr infrmatin n hw t set it up fr FTP r hw t pen the apprpriate prts. FTP generally uses prt Define a prt range fr CuteFTP. 4. Use UPnP (if yur NAT r ruter supprts it) t establish a cnnectin prperly. 5. Turn n prt mapping. Using CuteFTP with Nrtn Internet Security If yu have Nrtn Internet Security installed n the same cmputer as CuteFTP, yu will need t adjust a setting in the Nrtn prgram t allw CuteFTP t make cnnectins and transfers. Refer t Knwledge Base article #10132 fr details. Using Errr Messages and Lgs t Trublesht Yu can help reslve errrs by recrding infrmatin frm errr messages and lg files. The Lg pane appears at the tp f the interface under the Remte pane. A standard errr dialg bx includes a shrt errr message and tw buttns, Cancel and Details. Click Cancel t dismiss the errr dialg bx. Click Details t expand the errr dialg t shw mre infrmatin. Review the infrmatin in the lgs and errr messages. The prblem culd be as simple as a typ in the cnnectin infrmatin, r the remte server might be refusing cnnectin fr sme reasn. T use an errr messages and lgs t trublesht 1. D ne r bth f the fllwing: In the errr message, click the Details buttn, right-click in the lg text area, then click Cpy All Text. The entire cntents f the windw is cpied t the clipbard, then paste it int an r text file. In the Lg pane, right-click, then click Cpy Entire Lg t Clipbard (r press CTRL+SHIFT+C), then paste it int an r text file. 2. If yu suspect CuteFTP cnfiguratin is at fault, paste it directly int the Descriptin field at the Glbalscape Technical Supprt Cntact page t ask fr help frm Glbalscape Technical Supprt. 3. Send the infrmatin t yur technical supprt department, ISP, r Web hsting prvider fr trubleshting assistance. 258

259 Trubleshting Cnnectin and Transfer Errrs Windws Firewall is Blcking Cnnectins Outging cnnectins can be affected by the presence f firewall r antivirus sftware n the lcal cmputer r netwrk cnnectin. Windws cmes with a built-in Internet Firewall that is active by default and blcks all FTP traffic. Yu can turn ff this firewall (nt recmmended by Micrsft) r cnfigure it t allw cnnectins via CuteFTP. Cnfigure yur firewall s that prts 20 and 21 are pen (nt blcked). It may als be necessary t grant specific permissin fr CuteFTP t access thse prts. Fllw the steps belw t add CuteFTP t the Windws Firewall exceptins list. T add CuteFTP t the Windws Firewall exceptins list 1. In the Windws Cntrl Panel, duble-click Security Center, then click Windws Firewall. 2. On the General tab, ensure Windws Firewall is On and then clear the Dn't allw exceptins check bx. 3. On the Exceptins tab, review the Prgrams and Services list t determine if CuteFTP is listed. Lk fr: CuteFTP (the interface) ftpte.exe (the Transfer Engine) Bth prgrams must be shwn in the list f exceptins. If they are nt, then fllw the steps belw t add either ne r bth prgrams t the list. 4. Click Add Prgram. The Add a Prgram dialg bx appears. 5. In the Prgrams list, click CuteFTP, then click OK. The Add a Prgram dialg bx clses. 6. Click Add Prgram. The Add a Prgram dialg bx appears. 7. Click Brwse t navigate t the CuteFTP installatin flder (by default in C:\Prgram Files\Glbalscape), click ftpte.exe, then click Open. 8. Click OK t clse the Add a Prgram dialg bx and save yur changes. 9. Verify bth prgrams appear in the Prgrams and Services list, then click OK t exit Windws Firewall. The firewall will nw ignre the transfer engine and the interface. Fr mre infrmatin abut the Windws Firewall, see the article n Micrsft's website at r search the Internet fr "Windws Firewall." 259

260 CuteFTP v9 User Guide This page left blank fr 2-sided "bk" printing. 260

261 Chapter 13. Getting Help Fr the mst up-t-date infrmatin regarding this versin f CuteFTP; t view versin histry and updates; t dwnlad a PDF f this user guide; and fr ther self-help resurces, visit the Glbalscape Supprt Center. After release f the prduct, the nline help is updated as errrs and missins are identified; therefre, yu shuld visit the Supprt center when the help in the applicatin r this PDF cannt nt answer yur questins. Glbalscape Supprt Center If yu are having a transfer r cnnectin prblem, cntact yur Internet Service Prvider. Befre cntacting them, enable cnslidated transfer lgs, reprduce the prblem, then cpy and paste the entire lg in t ur nline supprt request frm r . (Glbalscape cannt tell yu which server t lg in t, what yur lgin credentials are (username/passwrd), and which flders n the server yu have permissins t. Only yur ISP has that infrmatin.) If yu are having a prblem with CuteFTP, visit the CuteFTP supprt pages fr dwnlads, dcumentatin, activatin instructins, and the latest news regarding CuteFTP. Our Custmer Service team can answer yur questins abut sftware activatin and registratin r help with rder prblems. If yu need technical assistance with yur sftware, submit yur questin t the Technical Supprt team. Hwever, befre yu cntact Technical Supprt, please access ur nline help resurces: The Glbalscape User Frum is a great place t find infrmatin r seek help frm the glbal cmmunity f Glbalscape custmers and prduct experts. The Glbalscape Knwledgebase (KB) is a database f infrmatin n ur prducts. Subscribe t the RSS feed t keep abreast f the latest KB articles. Cpy and paste this URL int yur RSS feed reader. (See belw fr examples.) Subscribe t Glbalscape Annuncements Sign up fr the Glbalscape Newsletter, press releases, prduct annuncements, and ther Glbalscape news. Recver a Lst Serial Number - If yu knw the address yu used when yu activated the sftware, we can send it t yu at yur new address. T add the Glbalscape Knwledge Base RSS feed t yur Ggle hme page The prcedures belw are prvided as an example; see yur feed reader's nline help fr specific instructins. 1. Sign in t yur Ggle hme page, then, in the upper right area f the page, click Add Stuff. 2. At the tp center f the page, t the right f Search Hmepage Cntent, click Add by URL. The Add by URL frm appears. 3. In the text bx, prvide the URL f the RSS feed, then click Add. 4. In the upper left crner, click Back t Hmepage. The Glbalscape RSS feed appears n yur hme page. 261

262 CuteFTP v9 User Guide T add the RSS feed t Micrsft Outlk On the main menu, click Tls > Accunt Settings. 2. On the RSS Feeds tab, click New. 3. In the New RSS Feed dialg bx, type r paste the URL f the RSS Feed. Fr example, 4. Click Add. 5. Click OK. Micrsft Office Online prvides a tutrial n RSS feeds. Finding Infrmatin in the Help Yu can find infrmatin in the nline r applicatin help in several ways: Hyperlinks - Clickable text that pens anther tpic r a Web page. Related Tpics - Listed at the bttm f many tpics, lists ther tpics relevant t the current tpic. Using the Cntents, Index, Search, r Favrites, tabs, d the fllwing: Tab Descriptin Cntents Cntains the table f cntents. Click a main heading (represented by a bk icn) t display pages that link t tpics, and click each subheading (represented by a page icn) t display the crrespnding tpic in the right pane. Index Search Lists each f the tpics in the help file in alphabetic rder. Use the search pane t lcate wrds r phrases within the cntent f the tpics. Type the wrd r phrase in the text bx, press ENTER, then click in the list f tpics, click the tpic yu want t view. Favrites (This ptin is nt available in the Web help.) Yu can add a frequently viewed tpic t the Favrites tab in the applicatin's help. Click Add t add the tpic yu are viewing t the Favrites tab. T remve a tpic, click the tpic then click Remve. T display a tpic, duble-click it r click the tpic, then click Display. Searching the User Guide r glbalscape.cm When searching, try several different searches using different wrds fr the same cncept. Fr example, if yu want help with creating a script, search fr script, vb, batch, and s n. Als, we have attempted t prvide intuitive names fr the tpic titles, and the Index and Table f Cntents cntains the tpic titles f every tpic in the help file. S, in this example, if yu are lking fr a prcedure n hw t create a script, click the Index tab r Cntents tab and scrll t the tpic Creating Scripts. When yu search glbalscape.cm, yu are searching acrss all f Glbalscape prducts, nt just CuteFTP. Fr targeted searches, try the applicatin's help file first, then the nline help file, then the Knwledge Base, then the user frum. (Yu can als search this PDF.) If yu still cannt find the answer t yur questin, cntact Glbalscape Technical Supprt. Be sure t let us knw that yu had prblems finding yur answer in any f ur self-help resurces s that we can prvide better infrmatin in the future. 262

263 Getting Help Printing a Help Tpic T print a Help tpic: 1. D ne f the fllwing: Click the Print icn in the tlbar. Right-click in the tpic (in the right pane), then click Print. The Print dialg bx fr yur perating system appears. 2. Click Print. The tpic is printed t the specified printer. Sharing Tpic Links frm the Online Help In the nline (HTML) help, the address bar displays the IP address (URL) f the help file, nt the URL f the specific tpic. If yu right-click in the tpic, then click Prperties, yu can cpy the URL f the tpic; hwever, the URL displays nly the tpic, withut the Table f Cntents.. The prcedure belw describes hw t send a tpic URL that als displays the Table f Cntents. T cpy a tpic URL that includes the table f cntents 1. Open the tpic in yur Web brwser. 2. Right-click within the tpic (the right frame), then click Prperties. 3. Highlight the URL fr the tpic, right-click the selectin, click Cpy, and then clse the Prperties dialg bx. 4. Right-click in the address bar f yur brwser, click Paste, and then press ENTER. The tpic displays, but nt the table f cntents (TOC). 5. If yu want t see the tpic AND the TOC, click Shw. The URL will update in the address bar and the TOC will appear t the left f the tpic. 6. Cpy the URL in the address bar (e.g., and paste it int an e- mail. 263

264 CuteFTP v9 User Guide Using the Knwledge Base Glbalscape's Knwledge Base, prvides infrmatin in HOW TOs, FAQs, and ther types f articles. Many f the articles are created as a result f assisting custmers with cnfiguratin and trubleshting. Search Tips: Fr the mst cmprehensive search fr articles specific t CuteFTP type cuteftp, then click G. T narrw yur search, in the Within drp-dwn menu, click CuteFTP. T nly find certain types f articles (FAQ, HOWTO, INFO, etc.), in the Type drp-dwn menu, click an article type. In the Search area, the ptins apply t where it searches, nt the display f results. That is, if yu search fr cuteftp and then click Article ID, n results are returned, since Article IDs are numbers. Fr example, if yu wanted t search fr an article ID 10070, in the Fr slutins cntaining bx type 10070, click Article ID, then click G. T search fr yur keywrd nly in article titles, click Article Title Only. T search nly fr articles ging back a certain length f time (e.g., 3 days ag, last year), click the Maximum Age drp-dwn menu, then click the interval. After yur search results display, at the bttm left f the page, yu can click a drp-dwn menu t chse t display frm 10 t 100 results per page, then click Update. Serial Number When yu cntact Glbalscape Custmer Supprt fr assistance, yu might be asked t prvide yur serial number, which is available in the Abut dialg bx: On the main menu, click Help > Abut. The Abut dialg bx appears. 264