Академический Документы
Профессиональный Документы
Культура Документы
VERSION 5
User Guide
II
Copyright2011byScriptLogicCorporationAllrightsreserved. ThispublicationisprotectedbycopyrightandallrightsarereservedbyScriptLogic Corporation.Itmaynot,inwholeorpart,becopied,photocopied,reproduced,translated, orreducedtoanyelectronicmediumormachinereadableformwithoutpriorconsent,in writing,fromScriptLogicCorporation.ThispublicationsupportsSecureCopy5.x.Itis possiblethatitmaycontaintechnicalortypographicalerrors.ScriptLogicCorporation providesthispublicationasis,withoutwarrantyofanykind,eitherexpressedorimplied. ScriptLogicCorporation 6000BrokenSoundParkwayNW BocaRaton,Florida334872742 1.561.886.2400 www.scriptlogic.com TrademarkAcknowledgements: SecureCopyisaregisteredtrademarkofScriptLogicCorporationintheUnitedStates and/orothercountries.Thenamesofothercompaniesandproductsmentionedhereinmay bethetrademarksoftheirrespectiveowners.
III
DOCUMENTATION CONVENTIONS
Typeface Conventions Bold
Indicates a button, menu selection, tab, dialog box title, text to type, selections from drop-down lists, or prompts on a dialog box.
CONTACTING SCRIPTLOGIC
ScriptLogicmaybecontactedaboutanyquestions,problems.orconcernsyoumayhave. ScriptLogicCorporation 6000BrokenSoundParkwayNW BocaRaton,Florida334872742 561.886.2400SalesandGeneralInquiries 561.886.2450TechnicalSupport
561.886.2499Fax www.scriptlogic.com
IV
Contents
WHAT IS SECURE COPY?.......................................................................................................................................1 USING SECURE COPY .............................................................................................................................................2 STARTING SECURE COPY ....................................................................................................................................2 EXAMINING THE MAIN WINDOW.........................................................................................................................2 File Menu .......................................................................................................................................................3 Tools Menu .....................................................................................................................................................3 Help Menu ......................................................................................................................................................3 Tool Bar..........................................................................................................................................................4 Navigation Pane .............................................................................................................................................4 SETTING GLOBAL OPTIONS .................................................................................................................................6 Setting Copy Preferences................................................................................................................................6 Setting SMTP Settings ....................................................................................................................................8 Setting Help Desk Authority Settings..............................................................................................................9 SETTING PREFERENCES .....................................................................................................................................10 Setting Start Page Preferences .....................................................................................................................10 Setting Proxy Settings...................................................................................................................................11 Setting Logging Repository Default..............................................................................................................12 CREATING A NEW JOB .......................................................................................................................................13 USING THE JOB SUMMARY VIEW.......................................................................................................................14 USING THE JOB DETAILS VIEW..........................................................................................................................16 Setting the Copy Location.............................................................................................................................16 Setting General Options I .............................................................................................................................18 Setting General Options II............................................................................................................................21 Setting Advanced Options I ..........................................................................................................................22 Setting Advanced Options II .........................................................................................................................24 Migrating File Shares...................................................................................................................................27 Migrating Local Groups & Users ................................................................................................................29 Filtering Files...............................................................................................................................................32 RUNNING A JOB .................................................................................................................................................35 VIEWING JOB STATISTICS ..................................................................................................................................36 VIEWING JOB LOGS ...........................................................................................................................................36 SCHEDULING JOBS.............................................................................................................................................38 Managing Scheduled Jobs ............................................................................................................................41 USING SECURECOPYCMD.EXE ..........................................................................................................................41 MANAGING LICENSES .......................................................................................................................................42 Viewing License Status .................................................................................................................................42 Applying a New License File ........................................................................................................................43 APPLYING SECURE COPY OPTIONS ....................................................................................................................51 MAXIMIZING COPY PERFORMANCE ...................................................................................................................51 SYNCHRONIZING TARGET CONTENTS WITH SOURCE .........................................................................................52 Single Source Path To Single Target Path ...................................................................................................53 Multiple Source Paths To Single Target Path ..............................................................................................57 USING MAP FILES .............................................................................................................................................62 Copying Groups and Users ..........................................................................................................................62 Copying Files and Folders ...........................................................................................................................64 COPYING FOLDER STRUCTURES WITHOUT FILES ..............................................................................................66 CREATING LOG FILES ........................................................................................................................................67 CREATING HELP DESK AUTHORITY TICKETS ....................................................................................................68 TROUBLESHOOTING ............................................................................................................................................69 REMOVING SECURE COPY 5 ..............................................................................................................................69 INDEX ...................................................................................................................................................................70
WhatisSecureCopy?
SecureCopyisacomprehensivesolutionfordataduplication,localgroupanduser migration,sharemigration,andNTFSpermissionsconfiguration.SecureCopypermits seamlessmigration,allowinganadministratortocopyfilesanddirectoriesonNTFS partitionswhilekeepingthesecurityintact,creatingshares,andmigratinglocalgroups. Allofthisfunctionalityisavailableinaneasytouseinterface,whichkeepsyouupdated oncopyprogress,aswellasanyerrorsthatmayoccur. SecureCopyalsoincludesfunctionalitysuchasdifferentialcopying,fullcommandline support,andschedulingjobstorunafterhours.SecureCopysupportsWindows 2000/XP/2003/Vista/7,WindowsServer2008,andWindowsServer2008R2environments andiscompatiblewiththeMicrosoftClusterService.
UsingSecureCopy
STARTING SECURE COPY
ClickStart,pointtoPrograms ScriptLogicCorporation SecureCopy5,andthen chooseSecureCopy5.Eachtimeyouruntheprogramyouaregreetedbythesplash screen,whichdisplaystheinitializationoftheprogramandthecurrentversionnumber.
File Menu
Note:ManyoftheFilemenuoptionsareavailableontheToolBarandshortcutmenus.
Menu Option New Rename Save Save As Run Test Delete Schedule Exit Description Restore settings on all tabs to the default to create and name a new job. Rename the selected job. Save all settings for the current job. Create a new job by editing a saved job. Initiate the selected copy job. Test the selected copy job. No files are copied. Remove a saved job from the list. Open the Windows Scheduler to schedule the selected job to run at a specified time. Close Secure Copy. You also can click .
Tools Menu
Menu Option Options Preferences Description Set the number of threads, batch size, batch count, and proxy settings. Set start page and proxy settings preferences.
Help Menu
Menu Option Help License Feedback Support About Description Open the online help for Secure Copy. View license status and apply a license file. Go to the ScriptLogic Product Feedback Page where you can request information and send product suggestions. Go to the ScriptLogic Support page. View information about the version of Secure Copy installed on your computer.
Tool Bar
Note:ManyoftheToolBarbuttonsareavailableontheFilemenuandshortcutmenus.
Button Tool Tip New Job Description Restore settings on all tabs to the default to create and name a new job. Save all settings for the current job.
Save Job
Save Job As
Delete Job
Run Job
Test Job
Test the selected copy job. No files are copied. Open the Windows Scheduler to schedule the selected job to run at a specified time. Open the online help for Secure Copy.
Schedule Job
Help
Navigation Pane
Youcanhidebuttonstoincreasetheareafornavigationandrearrangethedisplayorder ofthebuttons.
Button Description Display the Jobs list and the Job Summary View page. See Using the Job Summary View. Display the Job Statistics View page. See Viewing Job Statistics. Display the Job Logs View page. See Viewing Job Logs.
,andthenselect ,andthenselectShow
Showing No Buttons
Thread Settings
Dependingonthenumberandsizeofthedatafilestobecopied,youcanmodifythe settingsforthenumberofthreads,batchsize,andbatchcount.
Thread Count (2-10)
Selectthenumberofcopythreadsforanindividualcopyjob.Thenumberofthreads isequivalenttothenumberofcopyjobsthatcanbeperformedsimultaneously. Theminimumis2andthemaximumis20. Whenmovingalargenumberofsmallfiles,youcanincreasethenumberof threadstowardsthemaximumnumberof20threads.Withmorethreadsperjob, largenumbersoffilescanbemovedintheshortestperiodoftime. Whenmovinglargerfiles,usingfewerthreadsismoreeffectivebecausethe threadsareabletofocusonmovingafewlargefiles,switchingcontrolbetween fewthreadsinafluidprocessratherthanpassingcontroltomultiplethreads, whichwouldslowdownthecopyprocess.
Selectthemaximumnumberoffilesinanindividualcopyjob.BatchCountisa limiterbasedonthenumberoffilesathreadcanprocessatatime.Whenajobis beingprocessed,asinglethreadcopieseitherthemaximumnumberoffilesinthe batchcountorthemaximumbatchsize,whicheverisreachedfirst.Theminimum numberoffilesis25andthemaximumis100. Whenprocessingalargenumberofsmallfiles,itispreferabletosetthebatch counttothehighestlevelforefficiency. Whenprocessinglargefiles,thebatchcountcanbesetanywherebecausethe batchsizelimitationwillbemetbeforethebatchcountlimitismet. Important:Inmostcases,thedefaultvaluesareoptimal.Changingthesevalues incorrectlycanleadtoperformancedegradation.
Batch Size (1-10 MB)
Selectthemaximumnumberofbytesinanindividualcopyjob.BatchSizeisalimiter basedonthesizeofthefilesathreadcanprocessatatime.Whenajobisbeing processed,asinglethreadcopieseitherthemaximumsizeoffilesorthemaximum numberoffiles,whicheverisreachedfirst.Theminimumis1MBandthemaximum is10MB. Whenprocessingalargenumberofsmallfiles,itispreferabletosetthebatch sizetothehighestlevelforefficiency. Whenprocessinglargefiles,thebatchsizecanbesetanywherebecausethebatch sizelimitationwillbemetpriortomeetingthelimitofthebatchcount. Important:Inmostcases,thedefaultvaluesareoptimal.Changingthesevalues incorrectlycanleadtoperformancedegradation.
Retry Settings Retry Attempts
Choosethenumberoftimestoattemptaretryonlockedfiles.Theminimumnumber ofattemptsis0andthemaximumis100.Thedefaultsettingis5retryattempts.
Minutes Between Retries
Choosethenumberofminutestowaitbetweeneachretryonlockedfiles.Thedefault is30minutes.
10
SETTING PREFERENCES
Setting Start Page Preferences
Onthemainpages,youhavethechoicetomakethatpagetheonethatdisplayswhen youstartSecureCopy.
11
Selectifyouareusingaproxyserver.
Proxy Server Address
Entertheaddressoftheproxyserver.
Proxy Server Port
Entertheportnumber.Thedefaultis25.
User Name and Password Proxy Server Requires User And Password
Selectiftheproxyserverrequiresausernameandpassword,andthenentertheuser nameandpasswordinthecorrespondingboxes.
12
13
3. Click .ThecopyjobnamedisplaysintheJobslist.
Note:TheJobslistisnotadjustable,butyoucanusethescrollbartoseetheentire jobnameorpointtoaselectedname.
14
15
Clicktoruntheselectedcopyjob.SeeRunningaJob.
Test this job
Clicktotesttheselectedcopyjob.SeeRunningaJob.
Schedule this job
Clicktoscheduletheselectedcopyjob.SeeSchedulingJobs.
View job logs
ClicktoopentheSecureCopyLogspage.SeeViewingJobLogs.
16
Note:Aftermakingchanges,savethejobbyclicking
Button Description Browse for the source and target paths. Type the source and target paths. Remove the selected paths.
17
Bydefault,SecureCopycreatesafolderstructureonthetargetthatmimicsthefolder structureinthesource.Toignorethesourcefolderstructure,clearthecheckbox. Caution:IftheSynchronizeTargetwithSourcecheckboxisselectedontheGeneral OptionsItab,andyoucopyfrommultiplesourcepaths,onlythosefilesinthelast sourcefileinthelistaresynchronizedwiththetarget.Allotherfilesinthetargetare deleted.SeeSettingGeneralOptionsI. TherearetwowaystoaddpathstotheSourcePathsandTargetPathsboxes:browsefor apathortypeapathdirectly. Browsing for a Path 1. 2. OntheCopyLocationtab,click .TheBrowseforFolderlistboxopens.
Expandthelist,andthenselectthepathstocopy(source)andtocopyto(target).
3. ClickOK.
Typeapathforthefolder,andthenclickOK. Note:Ifyoutypeapaththatdoesnotexist,youareaskedifyouwanttocreateit.
18
Selecttoskipfileswherethelastmodifieddateandtimediffersbylessthan2 seconds.ActiveonlywhenCopyOnlyChangedSourceFilestoTargetisselected. Filetimegranularityis100nanosecondsonNTFSand2secondsonFAT,socopyingafile fromNTFStoFATcausesfiletimestoberoundedtoavaluethattheFATfilesystemcan manage.WhenboththesourceanddestinationvolumesareNTFS,thefiletimesare comparedexactly.WheneitherthesourceordestinationvolumeisnotanNTFSvolume, SecureCopyconsidersfiletimestobeidenticaliftheyarewithin2secondsofeachother. Withoutthis2secondmargin,SecureCopymightclassifyunmodifiedfilesasolderor newerfiles,whichwouldresultinunnecessarycopyingofunchangedfiles. Sometimesyoumaywanttooverridethishandlingoffiletimes.Forexample,you copyanNTFStreetoaFATvolume.SecureCopyroundsthefiletimes.Youthencopy theFATtree(withitsroundedfiletimes)toalocalNTFSdrive.Later,whenyouwant torecreatetheoriginaltreeexactly,youdonotwanttorefreshtheentiretree.
19
20
Afterthelogfileisgenerated,click
Verbose Logging
Selecttocapturedetailinalogtextfile.AvailableonlyiftheGenerateLogFilecheckbox isselected.SeeCreatingLogFiles.
21
Afterthetextfileisselected,click
Selecttocopyfilesthatareonanofflinestoragedevice,resultingintheoriginalfilebeing recalledfromofflinestorage.Ifthisoptionisnotselected,offline/stubfilesareskipped.
Synchronize Archive Bit on Source and Target
Selecttosetthearchivebitonthetargetfolderorfiletobethesameasthesource.
Clear Archive Bit on Source After Copying
Selecttoclearthearchivebitonthesourcefileafteritiscopied.Otherwisethearchivebit willremainuntouched.
22
23
Selectthenumberofcopythreadsforanindividualcopyjob.Thenumberofthreadsis equivalenttothenumberofcopyjobsthatcanbeperformedsimultaneously. Theminimumis2andthemaximumis20. Whenmovingalargenumberofsmallfiles,youcanincreasethenumberofthreads towardsthemaximumnumberof20threads.Withmorethreadsperjob,large numbersoffilescanbemovedintheshortestperiodoftime. Whenmovinglargerfiles,usingfewerthreadsismoreeffectivebecausethethreads areabletofocusonmovingafewlargefiles,switchingcontrolbetweenfewthreads inafluidprocessratherthanpassingcontroltomultiplethreads,whichwouldslow downthecopyprocess.
Batch Count (25-100)
Selectthemaximumnumberoffilesinanindividualcopyjob.BatchCountisalimiter basedonthenumberoffilesathreadcanprocessatatime.Whenajobisbeing processed,asinglethreadcopieseitherthemaximumnumberoffilesinthebatchcount orthemaximumbatchsize,whicheverisreachedfirst.Theminimumnumberoffilesis 25andthemaximumis100. Whenprocessingalargenumberofsmallfiles,itispreferabletosetthebatchcount tothehighestlevelforefficiency. Whenprocessinglargefiles,thebatchcountcanbesetanywherebecausethebatch sizelimitationwillbemetbeforethebatchcountlimitismet. Important:Inmostcases,thedefaultvaluesareoptimal.Changingthesevalues incorrectlycanleadtoperformancedegradation.
Batch Size (1-10MB)
Selectthemaximumnumberofbytesinanindividualcopyjob.BatchSizeisalimiterbased onthesizeofthefilesathreadcanprocessatatime.Whenajobisbeingprocessed,asingle threadcopieseitherthemaximumsizeoffilesorthemaximumnumberoffiles,whicheveris reachedfirst.Theminimumis1MBandthemaximumis10MB. Whenprocessingalargenumberofsmallfiles,itispreferabletosetthebatchsizeto thehighestlevelforefficiency. Whenprocessinglargefiles,thebatchsizecanbesetanywherebecausethebatch sizelimitationwillbemetpriortomeetingthelimitofthebatchcount. Important:Inmostcases,thedefaultvaluesareoptimal.Changingthesevalues incorrectlycanleadtoperformancedegradation.
Retry on Locked File
Requestsaretryofanyfilesthatwerenotcopiedduringtheinitialpassthroughthe directorystructure.
Retry Attempts
Choosethenumberoftimestoattemptaretryonlockedfiles.ActiveonlyifRetryon lockedfileisselected.
Minutes Between Retries
Choosethenumberofminutestowaitbetweeneachretryonlockedfiles.Activeonlyif Retryonlockedfileisselected.
24
25
Selecttosendanemailnotificationwheneitherajobhascompletedorhasnotcompleted byaspecifieddateandtime.
When Job Completes
Selecttosendanemailtothespecifiedrecipientswhenthecopyjobcompletessuccessfully.
If Job Has Not Completed By
Toaddrecipients,click ,typetherecipientsname,andthenclick . .
Toremoveaselectednamefromthelist,click
26
Tosetupemail,click
27
Ifasharealreadyexistsonthetarget,SecureCopydoesnotcreatetheshareonthetarget.
Overwrite (Remove old share, create new one)
Ifasharealreadyexistsonthetarget,SecureCopyunsharestheshareonthetarget,and thenwritesoveritwiththesourceshare.
28
ApplicableonlytoWindows2003.Ifyouarecopyingdatatoaclustergroup,typethename oftheclustergroup.SecureCopymigratesthesharestothespecifiedclustergroup.
29
30
Migrate the following: Copy Only Local Groups and Users Not Files
Selecttomigrateonlylocalgroupsandusers.Filesarenotmigrated.
Local Groups
Selecttomigratelocalgroupsfromthesourcetothetarget.
Local Users
Selecttomigratelocalusersfromthesourcetothetarget.
Set Password for migrated user accounts
Selecttoenterapasswordforthemigrateduseraccounts.Typethenewpasswordinthe NewPasswordbox.
Select local group Target Server
Selecttomigratelocalgroups/usersfromthesourceservertothetargetserver.
Active Directory
Ifalocalgroup/usernamealreadyexistsonthetarget,SecureCopyappliesthose permissionstothemigrateddata.
Add members of the source group to existing group
Migratestheusersofagrouponthesourceservertothegroupwiththesamenameon thetargetserver.
Synchronize target members with source members
Ifalocalgroup/useralreadyexistsonthetarget,thesourcelocalgroup/useroverwrites thetarget.
31
SelecttonotappenduserstotheBUILTINgroupinthetargetserver.
Map File Specify Map File
Toselectthelocationofthemapfile,click Toviewthecontentsofthemapfile,click
. .
32
Filtering Files
Applyingfiltersgivesadministratorscontroloverwhatcontentgetsmigrated,whichis especiallyusefulfortheeliminationoffilesthatmaynotbenecessaryorappropriateina corporateenvironment,suchasTMP,MP3,MOV,MPG,WMAoranyhundredsof others.Conversely,applyingfilterscanallowformigrationsbasedonfiletypes.For example,ifoneserverwillholddatasuchasmultimediaforacompany,asystem administratorcanspecifythatonlythefilesforthatusewillgotothenewserver.Inthis casetheymightcopyonlyJPG,MPG,SWF,MOV,WAV,oranyotherfilewithan extensionthatmaybeofimportance.
Selecttoapplythelistedfilterstofiles.Youcanfilterfilesbyfilenameorextension.
33
Onlyfilesstartingwiththetextstring Accounting,areincludedinthecopyjob.
Add a Filter
Allfileswiththeextensions.tmp,.mp3, and.wmvareexcludedfromthecopyjob.
1.
Click
.TheAddFilterNameboxopens.
2. Typeafilter.Youcanfilterfileextensionsorfilenames.Enterfiltersoneatatime. Tofilteranextension,youmustincludeanasteriskandadotseparator(for example,*.txt). Tofilterfilenamesbeginningwithaspecificstringoftext,usethefilterSTRING* (forexample,TEST*returnsfilessuchasTEST_FILE.doc). Tofilterfilenamesendingwithaspecificstringoftext,usethefilter*STRING(for example,*TESTreturnsfilessuchasBOB_FILE_TEST.doc. Tofilterfilenamescontainingaspecificstringoftext,usethefilter*STRING*(for example,*TEST*returnsfilessuchasBOB_TEST_FILE.doc. 3. Click .
Includesthosefilesthatmatchthefilter(s)listedintheFilterslist.Activewhenthe Applyfiltertothefilescheckboxisselected.
Exclude Files That Match These Filters
Excludesthosefileswiththefilters(s)listedintheFilterslist.ActivewhentheApply filtertothefilescheckboxisselected.
Remove a Filter
IntheFilterslist,selectafilter,andthenclick
Exclude the Following Folders
1.
Click
.TheAddFolderNameboxopens.
2. Typeafoldername,andthenclickOK.
34
Remove a Folder
IntheFolderNamelist,selectafoldername,andthenclick
Filter Files By Specified Date Include Files Created Between Dates
Includesfilesthatwerecreatedbetweentheselectedstartandenddates.Fromthe StartDateandEndDatelists,selectstartandenddates.
Include Files Modified Between Dates
Includesfilesthatweremodifiedbetweentheselectedstartandenddates.Fromthe StartDateandEndDatelists,selectstartandenddates.
Include Files Between These Sizes
Includesfileswhosesizeisbetweenthespecifiedminimumandmaximumsize.Inthe MinsizeandMaxsizeboxes,typevaluesinkilobytes(KB).
Limit Folder Recursion Depth
35
RUNNING A JOB
Note:Beforerunningajob,click totestthejobtoseeifanyerrorsaregenerated. Alternatively,clickTestthisjobontheJobSummaryViewpage,chooseTestfromthe Filemenu,orrightclickajobintheJobslist,andthenchooseTestfromtheshortcut menu.Nofilesarecopiedduringthetest. 1. SelectoneormorejobsfromtheJobsarea,andthenclick .Alternatively, clickRunthisjobnowontheJobSummaryViewpage,chooseRunfromtheFile menu,orrightclickajobintheJobslist,andthenchooseRunfromtheshortcut menu. Note:Ifyoumadeanychangestothecopyoptions,youarepromptedtosavethefile beforecontinuing. Thewindowopenstodisplaytheprogressofthejob. Tocancelajobwhileitisrunning,click .
36
2.
37
2. TochooseadifferentRepository,click contentsdisplayintheLogslist.
,andthechooseafolder.Thefolder
YoucansorttheresultsbythevaluesintheLevelandStatuscolumns,andyoucan grouptheresultsbythevaluesintheLevel,Logger,andStatuscolumns.
Button Description Sort the displayed results by the value in the Level column: All, Debug, Error, Fatal, Info, or Warn Sort the displayed results by the value in the Status column: All, Copied, Error, Purged, or Stopped Group the displayed results by the values in the Level, Logger, or Status columns Reload the values from the log file Clear all values from the display Remove all groupings and filters from the displayed results Export log results to a CSV or XML file.
38
SCHEDULING JOBS
SecureCopyincludestheabilitytoschedulecopyjobstooccurwhentheyareconvenient topersonnel,withoutinterferingwithbusinesspractices.Thebesttimefordata migrationisduringhoursofnonoperationornonpeakusage.Quiteoftenthisisnot feasiblefortheaverage9to5administrator.SecureCopyusesthefeaturesofthe MicrosoftTaskSchedulerservicetohandleallfunctionsofjobscheduling. 1. .Alternatively,chooseSchedule SelectajobintheJobslist,andthenclick fromtheFilemenu,orclickSchedulethisjobontheJobSummaryViewpage.The TasktabdisplaysthejobintheRunbox.
2. 3. IntheCommentsbox,typeanycommentsaboutthetask. YouruseraccountnamedisplaysintheRunasbox.Ifyouwantanotheruser accounttorunthetask,changetheentry. .TheSet Ifyouwanttochangetheuserwhocanrunthetask,click AccountInformationdialogboxdisplays.Youcanchangetheuseraccounthere also.Typeapassword,andthenclick . Note:TheEnabledcheckboxisselectedbydefault,whichenablesthetasktorunatthe specifiedtime.Todisablethetaskfromrunning,cleartheEnabledcheckbox. 4. OpentheScheduletabtocreateanewscheduleoreditanexistingschedule.
39
5.
7. 8.
9. Setthedesiredoptions,andthenclick .
40
10. OpentheSettingstab.Hereyoucansetmoreoptionsfortheselectedtask.
41
USING SECURECOPYCMD.EXE
SecureCopyCmd.exeistheenginethatSecureCopyusesforcopyprocessesandituses allofthefeaturesthatareavailableinSecureCopy.SecureCopyCmd.exerunsfromthe commandline,butoffersonlylimitedoptionstoscript,becauseitreferencesthefeatures ofasavedjobbyusingthenameofthatjob. Note:YoumustuseSecureCopyCmd.exefromacomputerthathasafullylicensed versionofSecureCopy5installed.YoucannotcopySecureCopyCmd.exefrommachine tomachine,asitworksonlyasanevaluationversionandislimitedtocopyingasmall amountofobjects.
Usage SecureCopyCmd.exe /Job="<job_id>" SecureCopyCmd.exe /Name="<job_name>" Optional Parameters /Test Test the /Quiet Runs job /Source Define a /Target Define a
job without user interface new source path new target path
Important:Ifyouadd/sourceor/targettothecommand,itoverridesthesource(s) andtarget(s)specifiedinthecopyjobidentifiedbythejobidorname.
Examples securecopycmd.exe /Job="{2f99c223-1625-45dc-ba6a-8573139f77fd}" securecopycmd.exe /Name="Default" /Test
42
MANAGING LICENSES
FromtheHelpmenu,chooseLicense.TheLicenseRegistrationInformationbox opens.Ifyouhaveregistered,thecurrentlicensekeydisplays.
ToviewtheEndUserLicenseAgreement(EULA),click
43
Note:AtanytimeduringtheProductRegistrationProcess,youcanclick viewtheEndUserLicenseAgreement.
to
Typeyourcompanyandcontactnamesintheappropriateboxes,andthenclick .
44
4. 5.
Click
SelectwhethertouseFULLorLIMITEDLicensingManagement.
45
7.
Selectwhethertoregisteronlineoroffline.
Selecttocontinuewiththeregistrationprocess.ThecomputermusthaveanInternet connection.
Offline
46
Note:TouseaProxyServer,click
.TheProxyServerSettingsboxopens.
3. Click .Amessageboxdescribeslicensinginformation.
47
4. Click .Thelocationoftheproductregistrationfiledisplays.
Note:Leavethiswindowopenwhileyouprocesstheproductregistrationfile.
48
9. Click tosavetheLicenseFile.phlfile.
49
12. Typethepathtotheproductlicensefile(.phl),orclick
tolocatethefile.
50
14. Click
.Amessageboxdescribeslicensinginformation.
51
ApplyingSecureCopyOptions
Thereareseveraloptionsthatyoucanselecttoperformvarioustasks.Thischapter includesinformationaboutwaystoapplySecureCopyOptionstomaximizeyouruseof SecureCopy.
Bydefault,themaximumnumberoffilesinabatchis25andthemaximumsizeofthe batchis1MB.Theminimumnumberofthreadsis2bydefault.Byincreasingthethread count,youareaddingmorethreadsthatcopybatchesoffiles.Eachofthefilethreads dealswithonebatchoffilesatatime. Innormaloperation,thesedefaultsettingsshouldbeadequate.However,ifyouhavea largenumberofsmallfilesandmanybatches,youmightstartbycreatingatleast10 threads,andthenmonitoringnetworkcardutilization. Thegoalofadjustingthesethreeparametersistomaximizeyournetworkbandwidth. OtherfactorsthatpreventSecureCopyfromusingallthenetworkbandwidthinclude slowdiskspeeds,diskfragmentation,andotheractivityonthenetworkandfileserver.
52
53
54
Example 2
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders in SUBFOLDERS of the target Source Path C:\SOURCE\ Target Path \\SRV1\C$\TARGET\ Target Result \\SRV1\C$\TARGET\SOURCE\
BecausetheCreateinitialsourcefolderundertargetfoldercheckboxisselected,the sourcefolderstructureisduplicatedunderthetargetfolder.Whenthecopyprocessis complete: Filesandfoldersthatdonotexistinthesourcefolder(C:\SOURCE\)arenotpurged fromthetargetfolder(\\SRV1\C$\TARGET\SOURCE\). Filesandfoldersthatdonotexistinthefirstsubfoldersofthesourcefolder (C:\SOURCE\subfolderA4\)anddownarepurgedfromthecorrespondingtarget folder(\\SRV1\C$\TARGET\SOURCE\subfolderA4\). Inthisexample,thefoldersinsubfolderA4donotexistinthesourcefolderand thereforearedeletedfromthetargetfolderwhenthecopyprocesscompletes.
55
Example 3
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders on the target Source Path C:\SOURCE\ Target Path \\SRV1\C$\ Target Result \\SRV1\C$\
56
Example 4
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders in SUBFOLDERS of the target Source Path C:\SOURCE\ Target Path \\SRV1\C$\TARGET Target Result \\SRV1\C$\TARGET
BecausetheCreateinitialsourcefolderundertargetfoldercheckboxisnotselected,the sourceparentfolderisnotduplicatedunderthetargetpath,butthesourcesubfoldersare duplicated.Whenthecopyprocessiscomplete: Allfilesandfoldersinsidethesourcefolder(C:\SOURCE\)arecopiedtothetarget folder(\\SRV1\C$\TARGET\). Filesandfoldersthatexistintherootofthesourcefolder(C:\SOURCE\)arenot purgedfromthetargetfolder(\\SRV1\C$\TARGET\). Filesandfoldersthatdonotexistinthefirstsubfoldersofthesourcefolder (C:\SOURCE\subfolderA4\)anddownarepurgedfromthecorrespondingtarget folder(\\SVR1\C$\TARGET\subfolderA4).
57
58
Example 1
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders on the target Source Paths C:\folderA\ C:\folderB\ Target Paths \\server1\C$\ Target Result \\server1\C$\folderA\ \\server1\C$\folderB\
59
Example 2
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders in SUBFOLDERS of the target Source Paths C:\folderA\ C:\folderB\ Target Paths \\server1\C$\ Target Result \\server1\C$\folderA\ \\server1\C$\folderB\
BecausetheCreateinitialsourcefolderundertargetfoldercheckboxisselected,the sourcefolderstructureisduplicatedunderthetargetpathduringthecopyprocess. Whenthecopyprocessiscomplete: Allfilesandfoldersinsidethesourcefolders(C:\folderA\andC:\folderB)arecopied totheirrespectivetargetfolders(\\server1\C$\folderA\)and(\\server1\C$\folderB\). Filesandfoldersthatdonotexistintherootofthesourcefolders(C:\folderA\)and (C:\folderB\)arenotpurgedfromtheirrespectivetargetfolders(\\server1\C$\folderA\) and(\\server1\C$\folderB\). Filesandfoldersthatdonotexistinthesubfoldersofthesourcefolders (C:\folderA\subfolderA1\)and(C:\folderB\subfolderB1\)anddownarepurged fromtheirrespectivetargetfolders(\\server1\C$\folderA\folderAsub1\)and (\\server1\C$\folderB\subfolderB1\).
60
Example 3
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders on the target Source Paths C:\folderA\ C:\folderB\ Target Paths \\server1\C$\ Target Result \\server1\C$\
61
Example 4
Create initial source folder under target folder Synchronize Target Contents with Source Purge orphaned files/folders in SUBFOLDERS of the target Source Paths C:\folderA\ C:\folderB\ Target Paths \\server1\C$\ Target Result \\server1\C$\
62
2. InSecureCopy,opentheLocalGroups&Userstab,andthenselecttheMigrate LocalGroups/UserstoDestinationServercheckbox.
63
3.
SelecttheSpecifyMapFilecheckbox,andthenclick Note:Tovieworeditthecontentsofthemapfile,click
tolocatethemapfile. .
64
Formatting Map Files Sourceandtargetdirectorymustbeondifferentcomputers,copyingfromone locationtoanotheronthesamecomputer(evenifthesourceandtargetareon differentvolumes)preventsthefoldersfrombeingmapped. Thefullpathforthesourceandtargetfoldersmustbeenteredintothemapfile. Example:C:\source\=\\ad3\e$\scytest\target\ Forfolders,thesourceandtargetpathinthemapfilemusthaveatrailing backslash(notnecessaryforfiles). Example:C:\source\=\\ad3\e$\scytest\target\ Thetargetdirectorydoesnotneedtobecreatedaheadoftime. Example:IfthemapfileisconfiguredasC:\source\=\\ad3\e$\scy test\target\,andthereisnofoldernamedtargeton\\ad3\e$\scy test\ priortorunningthecopyjob,SecureCopywillcreatethetargetfolderandcopy thecontentsofthesourcefolderintothisfolder Examples Torenameafile: C:\test\testfile.txt=\\targetserver\test\newtestfile.txt Todivertafile: C:\test\textfile.txt=\\targetserver\newDir\textfile.txt Torenameafolder: C:\test\=\\targetserver\C$\newfolder\
65
2. 3.
Note:Tovieworeditthecontentsofthemapfile,click
66
5. Saveandthenrunthejob.SeeRunningaJob.
67
68
69
Troubleshooting
ScriptLogicCorporationhasalibraryofarticlesinitsKnowledgeBase,whichmay provideananswertoaproblemyouareexperiencing.Beforecallingtechnicalsupport, checktoseeifyourproblemisdocumentedhere.YoumightalsobrowsetheDiscussion Forumstoseeifanyoneelseisexperiencingthesameissue. http://www.scriptlogic.com/support/products/securecopy/
70
Index
.
.phl,46 .scl,36 .ssd,15 .txt,36 onlychangedfiles,17 permissions,18 settingpreferences,6 settingretrysonlockedfiles,22 skippingfiles,17 skippingofflinefiles,20 createddate synchronizing,21 creating folderstructures,16 logfiles,66 mapfiles,61 newjob,12
A
ACLs updating,24 archivebit clearing,20 synchronizing,20
E
email sendingatest,8,25 sendingnotifications,24 settingup,25 encryptedfiles copying,20 EndUserLicenseAgreement,42 EULA,42 excluding filesandfolders,32 exitSecureCopy,3
B
batchcount,7,22 batchsize,7 BUILTINgroup,30 buttons hiding,5
C
clearing archivebit,20 SIDhistory,24 clustergroupname,27 compressoptions alwayscompress,23 conditional,23 Nevercompress,23 copyjob creating,12 running,34 sendingemailnotifications,24 testing,34 viewinglogfiles,36 viewingstatistics,35 copying allfiles,18 dataonly,19 encryptedfiles,20 folderstructures,65
F
Filemenu,3 fileshares migrating,26 files filtering,31 filtering files,31 folders copyingstructures,65
G
generating logfile,19
71
H
HelpDeskAuthority,9,25 Helpmenu,3 hiding buttons,5
I
ignoring recentlymodifiedfiles,17
N
Navigationpane,4 changebuttonorder,5 hidingbuttons,5 options,5 show/hidebuttons,5 newlicensefile applying,42
J
job creatingnew,12 rename,3 running,34 testing,34 viewinglogfiles,36 viewingstatistics,35 jobdetailsview,15 jobsummaryview,13 jobs managingscheduled,40 scheduling,37
O
offlinefiles skippingover,20 orphanedfilesandfolders purging,18 purgingsubfolders,18,53,54,55,57,58,59,60 overriding security,18
L
lastaccesseddate resetting,21 synchronizing,21 synchronizing,21 license applyingnew,42 viewing,41 lockedfiles retrycopy,22 logfile,19,66 verbose,66 verify,66 logfiles viewing,36
P
permissions copy,18 donotcopy,19 proxyserver,45 setting,11 purging orphanedfilesandfolders,18 orphanedsubfolders,18,53,54,55,57,58,59,60
R
recursiondepth,33 removing folderfromlist,33 SecureCopy,68 renamejob,3,12 resetting lastaccessdate,21 retryattempts,7 retrycopy lockedfiles,22
M
managing scheduledjobs,40 mapfiles,30,61 mapping foldersandfiles,20 localgroups,30
72
running copyjob,34
S
scheduling copyjob,37 SecureCopy removing,68 SecureCopy.ssd,15 SecureCopyCmd.exe,40 security override,18 sending testemail,8,25 setting startpagepreferences,10 shares.Seefileshares. showing buttons,5 SIDhistory clearing,24 SMTPserver,11 setting,8 source synchronizewithtarget,21,29 startpage settingpreferences,10 statistics viewing,35
T
target synchronizewithsource,21,29 testing copyjob,34 threadcount,6 toolbar,4 Toolsmenu,3
U
updating ACLs,24
V
verboselogfile,66 verboselogging,19 verifylogfile,66 versionnumber,3