Tivoli Storage Manager for Macintosh

Tivoli

Storage

Manager

for

Macintosh

Backup-Archive

Clients

Installation

and

User’s

Guide

Version5.5

Tivoli

Storage

Manager

for

Macintosh

Backup-Archive

Clients

Installation

and

User’s

Guide

Version5.5

Note

Beforeusingthisinformationandtheproductitsupports,readthegeneralinformationunder“Notices”onpage345.

Editionnotice

ThiseditionappliestoVersion5.5ofIBMTivoliStorageManager(5608-ISM),IBMTivoliStorageManagerExtended Edition(5608-ISX),IBMTivoliStorageManagerforStorageAreaNetworks(5608-SAN),andtoallsubsequent releasesandmodificationsuntilotherwiseindicatedinneweditionsortechnicalnewsletters.

OrderpublicationsthroughyourIBMrepresentativeortheIBMbranchofficeservingyourlocality.

Yourfeedbackisimportantinhelpingtoprovidethemostaccurateandhigh-qualityinformation.Ifyouhave commentsaboutthismanualoranyotherIBMTivoliStorageManagerdocumentation,see“Contactingcustomer support”onpagexiii.

Contents

Tables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. vii

About

this

book

.

.

.

.

.

.

.

.

.

.

. ix

Whoshouldreadthismanual . . . ix

IBMTivoliStorageManagerWebsite . . . ix

Conventionsusedinthisbook . . . x

Readingsyntaxdiagrams . . . x

Relatedpublications . . . xii

Downloadingororderingpublications . . . . xiii

Accessibility . . . xiii

Contactingcustomersupport . . . xiii

Reportingaproblem . . . xiv

Internet . . . xiv

Summary

of

changes

for

Tivoli

Storage

Manager

.

.

.

.

.

.

.

.

.

. xvii

TechnicalchangesforVersion5.5-November2007 xvii TechnicalchangesforVersion5.4-January2007 xvii TechnicalchangesforVersion5.3-March2006 xviii TechnicalchangesforVersion5.3-October2005 xix

Chapter

1.

Installing

Tivoli

Storage

Manager

.

.

.

.

.

.

.

.

.

.

.

.

.

. 1

Migratingfromearlierversions . . . 1

Upgradepathforclientsandservers . . . 1

MigratingtotheTivoliStorageManagerVersion 5.5Macintoshclientfromreleasespriorto5.3.2. . 2

MigratingtotheUnicode-enabledclient . . . . 4

Macintoshclientenvironment. . . 6

Clientcomponents . . . 7

Hardwarerequirements. . . 7

Softwarerequirements . . . 7

Communicationsmethod . . . 7

InstallingtheMacintoshclientprogram(required systemadministratortask). . . 7

Enablingnon-administratorstomanagetheir owndata(requiredsystemadministratortask). . 11

Chapter

2.

Configuring

Tivoli

Storage

Manager

.

.

.

.

.

.

.

.

.

.

.

.

.

. 13

Rootuser,authorizeduser,andnon-authorizeduser tasks. . . 13

UsingTSMToolsforAdministrators . . . 15

Creatingandmodifyingtheclientsystemoptions file(requiredrootuserorauthorizedusertask) . . 15

Creatingadefaultclientuseroptionsfile(optional rootuserorauthorizedusertask) . . . 16

Creatingacustomizedclientuseroptionsfile (optionalusertask). . . 17

Settingoptionsinanoptionsfile . . . 18

Settingprocessingenvironmentvariables(optional) 19 SettingTandCshellvariables . . . 20

SettingBashandBourneshellvariables . . . . 20

ConfiguringtheWebclient . . . 20

Configuringtheclientscheduler . . . 21

Startingtheclientscheduler . . . 22

Usingthecommand-lineclienttohandle scheduledevents . . . 22

Definingaschedule . . . 23

ConfiguringTivoliStorageManagerclient/server communicationacrossafirewall . . . 23

Registeringyourworkstationwithaserver (requiredrootuserorauthorizedusertask) . . . 25

Usingclosedregistration . . . 26

Usingopenregistration . . . 26

Creatinganinclude-excludelist(optionalrootuser orauthorizedusertask) . . . 26

Usinginclude-excludeoptions . . . 28

Controllingsymboliclinkandaliasprocessing. . 33

Controllingcompressionandencryption processing. . . 33

Testinganinclude-excludelistwiththePreview command . . . 34

Processingincludeandexcludeoptions . . . . 34

Chapter

3.

Getting

started

.

.

.

.

.

. 39

TivoliStorageManagerclientauthentication . . . 39

StartingaGUIsession. . . 40

UsingyourTivoliStorageManagerpassword . . 40

Setupwizard . . . 40

Startingacommand-linesession . . . 41

Usingbatchmode . . . 41

Usinginteractivemode . . . 41

Starting:Additionalconsiderations . . . 42

StartingaWebclientsession. . . 42

Settinguserprivileges. . . 43

Startingtheclientschedulerautomatically . . . . 43

Changingyourpassword. . . 43

SortingfilelistsusingtheTivoliStorageManager JavaGUI . . . 44

Displayingonlinehelp . . . 45

Endingasession. . . 45

Onlineforums . . . 45

Othersourcesofonlinehelp. . . 46

Chapter

4.

Backing

up

your

data

.

.

. 47

Planningyourbackups . . . 47

Whentobackupandwhentoarchivefiles. . . . 47

Pre-backupconsiderations . . . 48

HowTivoliStorageManagermaintainsvolume names . . . 48

Volumenamingprecautions . . . 49

Volumenamingprecautionsondualboot systems. . . 49

Unicodeconsiderations . . . 50

Configurememory-constrainedsystemstorun incrementalbackups . . . 50

Configuresystemswithlargenumbersoffilesto runincrementalbackups . . . 50

|| || || | || || ||

Usinganinclude-excludeoptionslisttocontrol

processing. . . 51

Encryptingdataduringbackuporarchive operations. . . 52

Supportedfilesystems . . . 53

Maximumfilesizeforbackupandrestore . . . 54

HowTivoliStorageManagerhandleslonguser andgroupnames . . . 54

HowTivoliStorageManagerhandlesFilevault homedirectories. . . 55

HowTivoliStorageManagerhandlestheTime Machinebackupdisk . . . 55

Performinganincremental,selective,or incremental-by-datebackup . . . 56

Fullandpartialincrementalbackup . . . 56

Incremental-by-datebackup . . . 57

Comparingfullincremental,partialincremental, andincremental-by-datebackups . . . 58

Selectivebackup. . . 58

BackingupdatausingtheJavaGUI . . . 59

Backingupdatausingthecommandline . . . 60

Deletingbackupdata . . . 61

Displayingbackupprocessingstatus . . . 62

Backupwithclientnodeproxysupport . . . 63

Schedulingwithclientnodeproxysupport. . . 65

Backup:Additionalconsiderations. . . 66

Understandinghowfilesarestored . . . 66

Understandinghowfilesaremanaged . . . . 67

Understandinghowhardlinksarehandled. . . 67

UnderstandinghowNFShardandsoftmounts arehandled . . . 67

Understandinghowdeletedfilesystemsare handled . . . 68

Backingupopenfiles . . . 68

Usingwildcardcharacters . . . 69

Chapter

5.

Restoring

your

data

.

.

.

. 71

Restoringanactiveorinactivebackup . . . 71

Performinglargerestoreoperations . . . 72

Standardqueryrestore,noqueryrestore,and restartablerestore . . . 72

Standardrestoreprocess . . . 73

Noqueryrestoreprocess . . . 73

Restartablerestoreprocess . . . 74

Restoringfilesanddirectories . . . 74

RestoringdatausingtheGUI . . . 74

Restoringdatausingthecommandline . . . . 75

Performingpoint-in-timerestores . . . 76

Restoringdatafromabackupset . . . 77

Restoringanentireorpartialbackupset . . . . 78

RestoringbackupsetsusingtheWebclientGUI 78 Restoringbackupsetsusingthecommand-line client . . . 79

Relatedtasksandconsiderations . . . 80

Authorizinganotherusertorestoreorretrieve yourfiles . . . 80

Restoringorretrievingfilesfromanotherclient node. . . 81

Restoringorretrievingyourfilestoanother workstation . . . 81

Restoringadiskincaseofdiskloss . . . 82

Deletingfilespaces. . . 82

Overlappingicons . . . 82

Chapter

6.

Archiving

and

retrieving

your

data

.

.

.

.

.

.

.

.

.

.

.

.

.

. 85

Archivingfiles . . . 85

Maximumfilesizeforarchiveandretrieve operations. . . 85

ArchivingdatausingtheGUI . . . 85

Archivingdatausingthecommandline . . . . 86

Archivingdatawithclientnodeproxy . . . . 87

Deletingarchivedata . . . 89

Archive:Advancedconsiderations. . . 89

Retrievingarchives . . . 90

RetrievingdatausingtheGUI . . . 90

Retrievingdatausingthecommandline. . . . 91

Understandinghowyourarchivesaremanaged 91

Chapter

7.

Automating

tasks

.

.

.

.

. 93

Specifyingschedulingoptions . . . 93

Displayinginformationaboutscheduledwork. . . 93

Displayinginformationaboutcompletedwork . . 95

Schedulingoptionsforcommands. . . 96

Enablingordisablingscheduledcommands . . . 96

Clientreturncodes . . . 96

Chapter

8.

Understanding

storage

management

policies

.

.

.

.

.

.

.

. 99

Usingpolicydomainsandpolicysets . . . 99

Usingmanagementclassesandcopygroups . . . 99

Displayinginformationaboutmanagementclasses andcopygroups . . . 101

Copygroupname. . . 102

Copytype . . . 102

Copyfrequency . . . 102

Versionsdataexists . . . 102

Versionsdatadeleted. . . 102

Retainextraversions . . . 102

Retainonlyversion . . . 103

Copyserialization . . . 103

Copymode . . . 103

Copydestination . . . 104

Retainversions. . . 104

Selectingamanagementclassforfiles . . . 104

Assigningamanagementclasstofiles . . . 105

Overridingthemanagementclassforarchivedfiles 106 Selectingamanagementclassforfolders . . . . 106

Bindingmanagementclassestofiles. . . 106

Rebindingbackupversionsoffiles . . . 107

Usingaretentiongraceperiod. . . 107

Usingevent-basedpolicyretentionprotection . . 108

Archivingfilesonadataretentionserver . . . 109

Chapter

9.

Using

processing

options

111

Communicationoptions . . . 111

TCP/IPoptions. . . 112

ServerandnodeNodeoptions . . . 112

Serveroptions . . . 112 Nodeoptions . . . 113 | || | ||

Backupandarchiveprocessingoptions. . . 114

Restoreandretrieveprocessingoptions. . . 117

Schedulingoptions . . . 118

Formatandlanguageoptions . . . 120

Commandprocessingoptions . . . 120

Authorizationoptions . . . 120

Errorprocessingoptions. . . 121

Transactionprocessingoptions . . . 121

Diagnosticsoptions . . . 122

Usingoptionswithcommands . . . 123

Enteringoptionswithacommand . . . 123

Initialcommand-line-onlyoptions . . . 126

Clientoptionsreference . . . 127

Archmc . . . 128 Asnodename . . . 129 Auditlogging . . . 131 Auditlogname . . . 133 Autofsrename . . . 135 Backupsetname. . . 137 Changingretries . . . 138 Collocatebyfilespec . . . 139 Commmethod . . . 140 Commrestartduration. . . 141 Commrestartinterval . . . 142 Compressalways . . . 143 Compression . . . 144 Console . . . 145 Dateformat . . . 146 Defaultserver . . . 148 Deletefiles . . . 149 Description . . . 150 Detail . . . 151 Dirmc . . . 152 Dirsonly . . . 153 Disablenqr . . . 154 Diskbuffsize. . . 155 Diskcachelocation . . . 156 Domain . . . 157 Editor . . . 159 Enablearchiveretentionprotection . . . 160 Encryptiontype. . . 161 Encryptkey . . . 162 Errorlogmax. . . 164 Errorlogname . . . 165 Errorlogretention . . . 166 Excludeoptions . . . 168 Filelist. . . 171 Filename . . . 173 Filesonly . . . 174 Fromdate. . . 175 Fromnode . . . 176 Fromowner . . . 177 Fromtime. . . 178 Groups . . . 179 Guitreeviewafterbackup . . . 180 Httpport . . . 181 Ifnewer . . . 182 Inactive . . . 183 Inclexcl . . . 184 Includeoptions. . . 186 Incrbydate . . . 190 Language. . . 191 Latest . . . 192 Localbackupset. . . 193 Location . . . 194 Mailprog . . . 195 Managedservices . . . 196 Maxcmdretries . . . 198 Memoryefficientbackup . . . 199 Nfstimeout . . . 201 Nodename . . . 202 Noprompt . . . 203 Numberformat . . . 204 Optfile . . . 205 Password. . . 206 Passwordaccess. . . 207 Passworddir. . . 209 Pick . . . 210 Pitdate. . . 211 Pittime . . . 212 Postschedulecmd/Postnschedulecmd . . . 213 Preschedulecmd/Prenschedulecmd . . . 215 Preservepath . . . 217 Queryschedperiod. . . 220 Quiet . . . 221 Removeoperandlimit . . . 222 Replace . . . 223 Resourceutilization . . . 225 Retryperiod . . . 228 Revokeremoteaccess . . . 229 Schedcmddisabled. . . 230 Schedlogmax . . . 231 Schedlogname . . . 232 Schedlogretention . . . 233 Schedmode . . . 235 Schedrestretrdisabled. . . 237 Scrolllines . . . 238 Scrollprompt . . . 239 Servername . . . 240 Sessioninitiation . . . 242 Skipacl . . . 244 Skipaclupdatecheck . . . 245 Srvprepostscheddisabled . . . 246 Subdir. . . 247 Tapeprompt . . . 249 Tcpadminport . . . 251 Tcpbuffsize . . . 252 Tcpcadaddress . . . 253 Tcpclientaddress . . . 254 Tcpclientport . . . 255 Tcpnodelay . . . 256 Tcpport . . . 257 Tcpserveraddress . . . 258 Tcpwindowsize. . . 259 Timeformat . . . 260 Todate. . . 261 Totime. . . 262 Txnbytelimit. . . 263 Type . . . 264 Users . . . 265 V2archive . . . 266 Verbose . . . 267 || || || || ||

Virtualnodename . . . 268

Webports. . . 269

Chapter

10.

Using

commands

.

.

.

. 271

Startingandendingaclientcommandsession . . 272

Processcommandsinbatchmode . . . 273

Processcommandsininteractivemode. . . . 273

Enteringclientcommands . . . 274

Commandname . . . 274

Options . . . 274

Parameters . . . 274

Filespecificationsyntax . . . 275

Rememberingpreviouscommands . . . 276

Usingwildcardcharacters . . . 277

Enteringcommands . . . 277

Clientcommandsreference. . . 278

Archive . . . 279 CancelRestore . . . 281 DeleteAccess . . . 282 DeleteArchive . . . 283 DeleteBackup . . . 285 DeleteFilespace . . . 288 Expire. . . 289 Help . . . 290 Incremental . . . 291 Loop . . . 295 Macro . . . 296 Preview . . . 297 QueryAccess . . . 298 QueryArchive . . . 299 QueryBackup . . . 301 QueryBackupset . . . 303 QueryFilespace . . . 305 QueryInclexcl . . . 306 QueryMgmtclass . . . 307 QueryNode. . . 308 QueryOptions . . . 309 QueryRestore . . . 310 QuerySchedule . . . 311 QuerySession . . . 312 QuerySysteminfo . . . 313 RestartRestore . . . 315 Restore . . . 316 RestoreBackupset. . . 320 Retrieve . . . 323 Schedule . . . 326 Selective . . . 328 SetAccess . . . 330 SetEvent. . . 332 SetPassword . . . 334

Appendix.

Using

the

Tivoli

Storage

Manager

central

scheduler

.

.

.

.

. 335

OverviewoftheTivoliStorageManagerscheduler 335 Handlingspacesinfilenamesinschedule definitions . . . 336

Preferentialstarttimesforcertainnodes . . . 336

Understandingschedulerprocessingoptions . . . 337

Handlingreturncodesfrompreschedulecmd andpostschedulecmdscripts . . . 338

Usingtheclientacceptortomanagescheduler servicesversusthetraditionalschedulerservices . 339

Settingtheclientschedulerprocesstorunasa backgroundtaskandstartautomaticallyatboot time . . . 339

Changingprocessingoptionsusedbythescheduler service. . . 340

Managingmultipleschedulerequirementsonone system . . . 340

Restartingtheschedulerprocessonaremote system . . . 341

TroubleshootingtheTivoliStorageManager scheduler. . . 342

Investigatingabnormalscheduledevents . . . 342

Checkingtheserveractivitylog . . . 343

InspectingtheClientScheduleLog . . . 343

Understandingtheschedulerlog . . . 343

Notices

.

.

.

.

.

.

.

.

.

.

.

.

.

. 345

Glossary

.

.

.

.

.

.

.

.

.

.

.

.

. 349

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 357

Tables

1. Typographicalconventions. . . x

2. IBMTivoliStorageManagerclientandserver publications . . . xii

3. Optimizedoptiondefaultvalues . . . xxi

4. Macintoshinstallationpackages . . . 8

5. MacOSXauthorizationtoolsandassociated TivoliStorageManagerapplications . . . . 13

6. Rootuser,authorizeduser,andnon-authorized usertasks . . . 14

7. Optionforexcludingdirectories. . . 28

8. Optionsforcontrollingbackupandarchive processing . . . 29

9. Wildcardandotherspecialcharacters. . . . 31

10. Usingwildcardcharacterswithincludeand excludepatterns . . . 32

11. Optionsforcontrollingsymboliclinkandalias processing . . . 33

12. Optionsforcontrollingcompressionand encryptionprocessing . . . 33

13. WorkingwithyourfilesusingtheTivoli StorageManagerGUI . . . 44

14. Backup:Primarytasks . . . 47

15. Planningyourbackups. . . 47

16. Supportedfilesystems. . . 53

17. Maximumfilesizeforbackupandrestore 54 18. Commandlinebackupexamples . . . 60

19. Clientcommandlineinformationalmessages 62 20. Restore:Primarytasks . . . 71

21. Commandlinerestoreexamples . . . 75

22. Archiveandretrieve:Primarytasks . . . . 85

23. Maximumfilesizeforarchiveandretrieve 85 24. Commandlinearchiveexamples . . . 86

25. command-lineexamplesofretrievingarchives 91 26. Clientreturncodesandtheirmeanings 97 27. Defaultvaluesinthestandardmanagement class . . . 101

28. TCP/IPoptions . . . 112

29. Serverandnodeoptions . . . 113

30. Backupandarchiveprocessingoptions 114 31. Restoreandretrieveprocessingoptions 117 32. Schedulingoptions. . . 118

33. Formatandlanguageoptions . . . 120

34. Commandprocessingoptions . . . 120

35. Authorizationoptions. . . 120

36. Errorprocessingoptions . . . 121

37. Transactionprocessingoptions. . . 121

38. Diagnosticsoptions . . . 122

39. Clientcommandoptions. . . 124

40. Optionsthatarevalidontheinitialcommand lineonly . . . 126

41. Enteringcommands . . . 271

42. Commands . . . 271

43. Commandrecallandeditfunctions . . . . 276

44. Wildcardcharacters . . . 277

45. Archivecommand:Relatedoptions . . . . 279

46. DeleteArchivecommand:Relatedoptions 283 47. DeleteBackupcommand:Relatedoptions 285 48. DeleteFilespacecommand:Relatedoptions 288 49. Expirecommand:Relatedoptions. . . 289

50. Incrementalcommand:Relatedoptions 293 51. QueryArchivecommand:Relatedoptions 299 52. QueryBackupcommand:Relatedoptions 301 53. QueryBackupsetcommand:Relatedoptions 303 54. QueryFilespacecommand:Relatedoptions 305 55. QueryMgmtclasscommand:Relatedoptions 307 56. QueryNodecommand:Relatedoptions 308 57. QueryOptionscommand:Relatedoptions 309 58. QuerySysteminfocommand:Relatedoptions 314 59. Restorecommand:Relatedoptions . . . . 317

60. RestoreBackupsetcommand:Relatedoptions 321 61. Retrievecommand:Relatedoptions . . . . 323

62. Schedulecommand:Relatedoptions . . . . 326

63. Selectivecommand:Relatedoptions . . . . 329

64. Scheduledclienteventstatuscodes . . . . 342

About

this

book

IBM®Tivoli®StorageManagerisaclient-server licensedproductthatprovides storage managementservicesina multiplatformcomputerenvironment.The backup-archive clientprogrampermitsuserstobackupandarchive filesfrom theirworkstationsor fileservers tostorage,andrestoreandretrievebackup versions andarchivedcopiesof filestotheirlocalworkstations.

Inadditiontothebackup-archiveclient,TivoliStorageManagerincludesthe followingcomponentsavailable onavarietyofplatforms:

v Aserverprogramthatpermitssystemstoperformasabackupandarchive server

fordistributedworkstationsand fileservers.See “Relatedpublications”onpage xiiforavailableserverpublications.

v AnadministrativeclientprogramthatyoucanaccessfromaWebbrowserorthe

commandline. Theprogrampermitsa TivoliStorageManager administratorto controland monitorserveractivities,definestoragemanagement policiesfor backup,archive andspacemanagement services,andset upschedulesto performthoseservices atregularintervals.For moreinformationaboutthe Administrativeclient,see“Relatedpublications”onpagexiiforavailableTivoli StorageManagerAdministrator’sReferencepublications.

Who

should

read

this

manual

Thismanualprovides instructionsforanend-usertoinstall, configure,and usethe TivoliStorageManagerclient.For installationinformationandsupportedoperating system levels,seeChapter1, “InstallingTivoliStorageManager,” onpage1.For configurationinformation,seeChapter2,“ConfiguringTivoliStorageManager,”on page13.

Thismanualassumesthatyouarefamiliarwithyour workstation,your operating system,and yourbasicsystem administration.

TivoliStorageManagertasks thatcanonlybe performedbyauthorizedusersand rootusersareidentified bythephrases,authorizeduserandrootuser.An authorized userisanyuser runningwith arealuserIDof0 (root)ora userwho ownstheTivoliStorageManagerexecutableandwhoseownerexecution

permissionbitisset tos.Inthefollowingexample,theusertivoliisanauthorized user whilerunningdsmcsince thedsmcowner executionpermissionbitisset tos:

See “Rootuser,authorized user,andnon-authorizedusertasks”onpage13for more informationaboutauthorizeduserand rootusertasks.

IBM

Tivoli

Storage

Manager

Web

site

Technicalsupport informationandpublicationsare availableatthefollowing address:

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

By accessingtheTivoliStorageManager homepage,youcanaccesssubjectsthat interest you.YoucanalsoaccesscurrentTivoliStorageManagerproduct

Conventions

used

in

this

book

Thisbookusesthefollowingtypographicalconventions:

Table1.Typographicalconventions

Example Description

dsmc.nlm _{AseriesoflowercaseletterswithanextensionindicatesTivoli} StorageManagerprogramfilenames.

archive Boldfacetypeindicatesacommandthatyoutypeata

workstation,suchasacommandyoutypeonacommandline. dateformat BoldfaceitalictypeindicatesaTivoliStorageManageroption.

Theboldtypeisusedtointroducetheoption,orusedinan example.

Occasionally,filenamesareenteredinboldfaceitalicfor emphasis.

filespec Italicizedtypeindicateseitherthenameofaparameter,anew term,oraplaceholderforinformationthatyouprovide. Italicsarealsousedforemphasisinthetext.

maxcmdretries Monospacedtyperepresentsfragmentsofaprogramor informationasitwoulddisplayonascreen.

plussign(+) Aplussignbetweentwokeysindicatesyoushouldpressboth keysatthesametime.

Reading

syntax

diagrams

Thissectiondescribes howtoreadthesyntax diagramsusedinthismanual.To read asyntax diagram,followthepathoftheline.Readfromlefttoright,andtop tobottom.

v

The

───symbolindicatesthebeginningofasyntax diagram.

v The───
symbolat theendof alineindicatesthesyntax diagramcontinueson

thenext line.

v The
───symbolat thebeginningofa lineindicates asyntaxdiagramcontinues

fromtheprevious line.

v The───
symbolindicatestheendofasyntax diagram.

Syntaxitems,suchasakeywordorvariable, canbe: v Ontheline(requiredelement)

v Abovetheline(defaultelement)

Syntaxdiagramdescription Example Abbreviations:

Uppercaselettersdenotetheshortest acceptabletruncation.Ifanitemappears entirelyinuppercaseletters,itcannotbe truncated.

Youcantypetheiteminanycombinationof uppercaseorlowercaseletters.

Inthisexample,youcanenterKEYWO, KEYWORD,orKEYWOrd.

KEYWOrd


Symbols:

Enterthesesymbolsexactlyastheyappearin thesyntaxdiagram.

* Asterisk {} Braces : Colon , Comma = EqualSign - Hyphen () Parentheses . Period Space Variables:

Italicizedlowercaseitems(var_name)denote variables.

Inthisexample,youcanspecifyavar_name

whenyouentertheKEYWORDcommand.

KEYWOrd var_name


Repetition:

Anarrowreturningtotheleftmeansyoucan repeattheitem.

Acharacterorspacewithinthearrowmeans youmustseparaterepeateditemswiththat characterorspace.

Afootnotebythearrowreferencesthe numberoftimesyoucanrepeattheitem.

 repeat


 , repeat


 (1) repeat
 Notes:

1 Specifyrepeatasmanyas5times. Requiredchoices:

Whentwoormoreitemsareinastackand oneofthemisontheline,youmustspecify oneitem.

Inthisexample,youmustchooseA,B,orC.

A

B C

Syntaxdiagramdescription Example Optionalchoice:

Whenanitemisbelowtheline,thatitemis optional.Inthefirstexample,youcanchoose Aornothingatall.

Whentwoormoreitemsareinastackbelow theline,allofthemareoptional.Inthe secondexample,youcanchooseA,B,C,or nothingatall.

A


A B C
 Defaults:

Defaultsareabovetheline.Thedefaultis selectedunlessyouoverrideit.Youcan overridethedefaultbyincludinganoption fromthestackbelowtheline.

Inthisexample,Aisthedefault.Youcan overrideAbychoosingBorC.Youcanalso specifythedefaultexplicitly.

A B C
 Repeatablechoices:

Astackofitemsfollowedbyanarrow returningtotheleftmeansyoucanselect morethanoneitemor,insomecases,repeat asingleitem.

Inthisexample,youcanchooseany combinationofA,B,orC.

 A B C
 Syntaxfragments:

Somediagrams,becauseoftheirlength,must fragmentthesyntax.Thefragmentname appearsbetweenverticalbarsinthediagram. Theexpandedfragmentappearsbetween verticalbarsinthediagramafteraheading withthesamefragmentname.

The fragment name


Thefragmentname:

A B C

Related

publications

Table2 liststheIBMTivoliStorageManagerclientand serverpublicationsthatare referredtointhis manual.

Table2.IBMTivoliStorageManagerclientandserverpublications

Publicationtitle Ordernumber

Clientpublications

IBMTivoliStorageManagerMessages SC32-0140

IBMTivoliStorageManagerforWindowsBackup-ArchiveClientsInstallationandUser’sGuide SC32-0146

IBMTivoliStorageManagerforNetWareBackup-ArchiveClientsInstallationandUser’sGuide SC32-0144

IBMTivoliStorageManagerforUNIXandLinuxBackup-ArchiveClientsInstallationandUser’s Guide

SC32-0145 Serverpublications

Table2.IBMTivoliStorageManagerclientandserverpublications (continued)

Publicationtitle Ordernumber

IBMTivoliStorageManagerforAIXInstallationGuide SC32-0134

IBMTivoliStorageManagerforHP-UXInstallationGuide SC32-0135

IBMTivoliStorageManagerforLinuxInstallationGuide SC32-0136

IBMTivoliStorageManagerforz/OSInstallationGuide SC32-0139

IBMTivoliStorageManagerforSunSolarisInstallationGuide SC32-0137

IBMTivoliStorageManagerforWindowsInstallationGuide SC32-0138

Downloading

or

ordering

publications

All Tivolipublicationsare availableforelectronicdownloadororderfromtheIBM PublicationsCenter:http://www.ibm.com/shop/publications/order/.

Ifyouhavequestionsorcomments regardingTivolipublicationsandproduct documentation, visithttp://www.ibm.com/software/tivoli/contact.htmltosend an e-mail.

TheInternationalTechnicalSupportCenter(ITSC)publishesRedbooks®_,whichare

books onspecializedtopicssuchasusingTivoliStorageManagertobackup databases.Youcanorderpublicationsthroughyour IBMrepresentativeortheIBM branchofficeservingyour locality.Youcanalsosearchforand orderbooksof interest toyouattheIBM RedbooksWebsiteatthisaddress:

http://www.ibm.com/redbooks/

TivoliField Guidesare designedtoaddressspecific technicalscenariosorconcepts thatare oftencomplextoimplementordifficulttounderstand.Allcompletedfield guides areavailablefreetoregisteredcustomersandinternalIBMemployeesatthe followingWebsite:

http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html

Accessibility

Accessibilityfeatureshelpuserswitha physicaldisability,suchasrestricted mobilityorlimited vision,tousesoftwareproductssuccessfully.Withthis product, youcanuseassistivetechnologiestohearand navigatetheinterface.Youcanalso usethekeyboardinsteadofthemousetooperateallfeaturesofthegraphicaluser interface.

Contacting

customer

support

For supportforthisor anyTivoliproduct,youcancontactTivoliCustomer Supportinoneofthefollowingways:

v VisittheTivoliStorageManagertechnicalsupport Websiteat:

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

v VisittheIBM SoftwareSupportToolbarWebsiteat: http://www.ibm.com/software/support/toolbar/

v Submita problemmanagement record(PMR)electronically at

IBMSERV/IBMLINK.YoucanaccessfromtheIBMWebsiteat:

http://www.ibm.com/ibmlink/

v Submita problemmanagement record(PMR)electronically fromtheIBM Web

http://www.ibm.com/software/support/probsub.html.

CustomersintheUnitedStatescanalso call1-800-IBM-SERV (1-800-426-7378).

InternationalcustomersshouldconsulttheWebsiteforcustomer support telephone numbers.

Youcanalsoreview theIBM SoftwareSupportGuide,whichisavailableonourWeb siteat http://techsupport.services.ibm.com/guides/handbook.html.

WhenyoucontactIBMSoftwareSupport,be preparedtoprovideidentification informationforyour companysothatsupportpersonnelcanreadily assistyou. Companyidentificationinformationisneededtoregisterforonline support available ontheWeb site.

The supportWebsiteoffersextensiveinformation,includinga guidetosupport services (IBMSoftwareSupportGuide);frequentlyasked questions(FAQs);and documentationforallIBM Softwareproducts,includingReleaseNotes,Redbooks, and whitepapers,defects(APARs),and solutions.Thedocumentationforsome productreleasesisavailable inbothPDFandHTMLformats.Translated documents arealsoavailable forsomeproductreleases.

Weareveryinterested inhearingaboutyour experiencewithTivoliproductsand documentation. Wealsowelcomeyoursuggestionsforimprovements. Ifyouhave comments orsuggestionsaboutourdocumentation,completeourcustomer feedback surveyatthefollowingwebsite,byselectingtheFeedbacklinkintheleft navigationbar:

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

Reporting

a

problem

Havethefollowinginformationreadywhenyoureportaproblem: v

TheTivoliStorageManagerserverversion,release,modification,andservice

levelnumber.Youcanget thisinformationbyenteringthequerystatus

commandat theTivoliStorageManageradministrativecommandline. v Itisrecommended thatyouusetheTivoliStorageManagerclientquery

systeminfocommandwiththefilenameoption togatherTivoliStorageManager systeminformationandoutputthisinformationtoa file.Thisinformationis intendedprimarilyasanaidforIBMsupportto assistindiagnosingproblems. v TheTivoliStorageManagerclientversion,release,modification,andservice

levelnumber.Youcanget thisinformationbyenteringdsmcatthecommand line.

v Thecommunicationprotocol(forexample,TCP/IP),version,andreleasenumber

youareusing.

v Theactivityyouweredoingwhentheproblemoccurred,listing thestepsyou

followedbefore theproblemoccurred. v

Theexacttextofanyerrormessages.

Internet

Tosearchmultiple Internetresourcesforyour product,go tothesupport website for theproduct:

v http://www.ibm.com/software/sysmgmt/products/support/

and lookforthesectiontosearchthesupportknowledgebase.Fromthissection, youcansearchavarietyofresourcesincluding:

v IBMtechnotes

v IBMdownloads

v IBMRedbooks

v Forumsand newsgroups

Youcanalsocheck thefollowingIBM SoftwareSupportToolbarWebsite, and choose Tivoli─>TivolideveloperWorks®─>Forums.http://www.ibm.com/ software/support/toolbar/

Anewsgroup,listserv@marist.edu,isimplementedbyathirdparty.IBMsupports this newsgroupona best-effortbasisonly.See“Onlineforums”onpage45for more information.

Summary

of

changes

for

Tivoli

Storage

Manager

ThissectionsummarizeschangesmadetotheTivoliStorageManagerproductand this publication.Technicalchangestothetextare indicatedbyverticallinestothe left ofthechange.

Technical

changes

for

Version

5.5

-

November

2007

Thefollowingchanges havebeenmadetotheproductforthisedition:

Transparent encryptionsupport

Supporthasbeenaddedfortransparentencryption,usingthe

encryptkeygenerateoption.Referto“Encryptkey” onpage162formore informationaboutthisoption.

TCP/IP Version6 support

TheIBM TivoliStorageManager clientnowsupportstheTCP/IPVersion6 (IPv6)protocoland canbe usedinadedicatedIPv6,IPv4,orintermixedIP environment.

Auditlogging andauditlognameoptions

Theauditloggingoptiongenerates anauditlogwith anentryforeachfile thatisprocessedduringanincremental,selective, archive,restore,or retrieveoperation.Referto“Auditlogging”onpage131 formore informationaboutthisoption.

Theauditlogname optionspecifiesthepathandfilenamewhereyouwant tostore auditloginformation.Thisoption applieswhen auditloggingis enabled.Refer to“Auditlogname”onpage133formore informationabout this option.

Technical

changes

for

Version

5.4

-

January

2007

Thefollowingchanges havebeenmadetotheproductforthisedition:

Passwordfileformatchanges

TheformatoftheTivoliStorageManagerpasswordfilechanged inVersion 5.3.4.Yourexistingpasswordfilewillbe migratedtothenewformat during thefirstsessionwith aTivoliStorageManagerserverafter you install theclient.See “Upgradepathforclientsand servers”onpage1 for moreinformationaboutthechanges.

UniversalBinarysupport

Youcannowinstall anduseTivoliStorageManager onan Intel-based Macintosh system.Youcanalsodo thefollowing:

v

Restore yourcurrentbackupdatafromaPPCsystemtoyour Intel

system withnolossofdataorattributes.

v Restore yourIntelbackupdatatoa PPCsystem withnolossofdataor

attributes.

Changeddefaultsforthemanagedservicesoption

Themanagedservices optiondefaulthasbeen changedtoincludeschedule.

By defaulttheClientAcceptorDaemonwillmanagetheWebclientand schedules.Anew option,none,hasbeenaddedtosupport runningdsmc schedule. | | | | | | | | | | | | | | | | | | |

Optionfile anderrorlognames

TheMacintosh clienthasbeen changedtousethesameoption fileand errorlognames astheother TivoliStorageManagerClients. TheTSMUser Preferences fileis nowthe dsm.optfile andthe TSM SystemPreferences fileisnowthedsm.sysfile.Duringinstallation,oldoption filesare renamed.

SupportfortheWebInterface

TheMacintosh clientnowsupportstheWebInterfaceforremotebackup and restorecapability.

Supportforsrvprepostscheddisabledandschedrestretrdisabledoptions

Thesrvprepostscheddisabled andschedrestretrdisabledoptionsarenow supported, inadditiontotheexistingschedcmddisabledoption.These optionshelptopreventTivoliStorageManageradministratorsfrom executinginadvertentormaliciousoperationsonTivoliStorageManager clientnodes.

See “Srvprepostscheddisabled”onpage246and “Schedrestretrdisabled”on page237 forinformationaboutthesenewoptions.

Reducingthememoryused duringtheincrementalbackupfunction

Thememoryefficientdiskcachemethodoptionuseslocaldiskspace,which reducestheamount ofmemoryrequiredtocompleteanincremental backup. See“Memoryefficientbackup”onpage199 formoreinformation aboutusingmemoryefficientdiskcachemethod.

Thediskcachelocationoptionspecifies thelocationwherethediskcache database willbe creatediftheoptionmemoryefficientbackup=diskcachem

issetduring anincrementalbackup. See“Diskcachelocation”onpage156 forinformationabouthow tousethisoption.

Supportforinclude.fs

Theinclude.fsoptioncontrolshowTivoli StorageManager processesyour filespaceforincrementalbackup. See“Includeoptions” onpage186 for more informationaboutusingtheinclude.fsoption.

Exclude.fsoptionsupport

Theexclude.fs optionisnowsupported.

DroppedsupportforMacOS10.3

Beginningwith thisreleaseofTivoliStorageManager,MacOS10.3isno longersupported.

Technical

changes

for

Version

5.3

-

March

2006

The followingchanges havebeenmadetotheproductforthisedition:

AccessControl Listssupport

Beginningwith MacOSX10.4.3,AccessControlListsare fullysupported bytheIBMTivoliStorageManagerVersion5.3.3MacintoshClient.

New options,SkipaclandSkipaclupdatecheck

Skipacland Skipaclupdatecheckarenewoptionsforcontrollingthe processingofaccesscontrollists (ACL)byTivoliStorageManager.

Skipacl=yesskipsACLprocessingcompletelyonbackup.

Skipaclupdatecheck=yespreventstheTivoliStorageManagerclientfrom performingchecksumandsize comparisonsbefore andafterbackup, and during incrementalprocessing. See“Skipacl”onpage244and

Technical

changes

for

Version

5.3

-

October

2005

Thefollowingchanges havebeenmadetotheproductforthisedition:

Changing HFSpathstoUNIXpaths

TheTivoliStorageManagerMacintosh ClientnowusesUNIXfilepathsfor options, schedules,and filesystem namesontheTivoliStorageManager server.Bydefault,theUNIXmountpointwillbeusedtocreatefilespaces ontheserver.See“Configuringtheclientscheduler”onpage21,

“Migratingfromearlier versions”onpage1, Chapter9,“Usingprocessing options,”onpage111,and“UsingtheTivoliStorageManagercentral scheduler,”onpage335formoreinformationaboutchangingfilepaths fromHFStoUNIX.

Note: Therearerequiredmigration stepsthatmust becompletedbefore

usingTivoliStorageManager Version5.3. Thisappliestoallusers migratingfromanypreviousversionofTivoliStorageManager.If thesestepsarenotcompleted,TivoliStorageManagerSchedules and Include/Excludeprocessingmightnotworkasexpected.See

“Migratingfromearlierversions”onpage1formore information.

ExtendedAttribute support

TheTivoliStorageManagerMacintosh clientcanbackupand restore ExtendedAttributedata.TheExtendedAttributedataisautomatically backedupwith eachobjectthathasExtendedAttributes.See “Supported filesystems”onpage53formoreinformation.

Event-basedpolicy retentionprotection

InadditiontotraditionalbackuparchiveprocessingtoaTivoliStorage Manager server,theTivoliStorageManagerBackup-ArchiveClients can now archivedatatoanIBM SystemStorageArchiveManagerserverby usingtheenablearchiveretentionprotectionoption.Whenconnected toany TivoliStorageManagerserverVersion5.2.2andabove, theTivoliStorage Manager Backup-ArchiveClientscantakeadvantageofevent-based archive managementpolicies.Withthenewsetevent commandtheclient canalsosignaleventsandrequestdeletionholdanddeletionrelease for specific files.Thisfeature isintended tohelpcustomersmeetregulatory requirements. See“Usingevent-basedpolicyretentionprotection”onpage 108,“Enablearchiveretentionprotection”onpage160 and“SetEvent”on page332 formoreinformation.

New linksfromthebackup-archiveclientGUIto theTivoliStorageManager andTivoliHomePages

From thebackup-archive clientGUI,youcannowdirectlyaccesstheIBM TivoliStorageManagerwebsite, theIBM Tivoliwebsite,theIBMTivoli StorageManagerSupportwebsite, andtheTivoliStorageManager Publicationswebsite.

From thebackup-archive command-lineinterfacehelpmenuscreen, the websiteaddressisdisplayed.Youcanenterthewebsiteaddressina browsertoaccesstheIBMTivoliStorageManagerSupportwebsitefor technicalsupport onTivoliStorageManager.

New options,ErrorlogmaxandSchedlogmax,andDSM_LOGenvironment variablechanges

ErrorlogmaxandSchedlogmax arenewoptionsforcontrollinglogsize.

Schedlogmax specifiesthemaximumsizeforthescheduler log,in megabytes.SeeChapter9,“Usingprocessingoptions,”onpage111for more information.

DSM_LOG environmentvariablechanges havebeenmadetopreventa securityordataintegrityproblem.Logswillnolongerbe createdinthe installationdirectory. Inaddition,if theclientisunabletoopena required logforwriting,theclientprocesswillterminate.TheTivoliStorage Manager clientmusthaveawriteabledsmerror.loginorder torun.See Chapter2,“ConfiguringTivoliStorageManager,”onpage13,Chapter9, “Usingprocessingoptions,”onpage111,andChapter10,“Using

commands,”onpage271 formoreinformation.

Enhanced encryption

TivoliStorageManagernow supportsAES(Advanced Encryption Standard) 128-bitdataencryptiontoencryptdataduring backupand archive operationsusingtheinclude.encryption option.

Include-excludeenhancements

Apreviewfunction allowsyoutoviewtheobjectsthatwouldbebacked uporarchivedaccordingtotheinclude-excludelist.Thisenhancementis usefulforvalidatingtheinclude-excludelist.

TheTivoliStorageManagerClientGUI directorytreeshowsdetailed informationofincludedandexcluded objects.

Thedirectory treein theTivoliStorageManagerClientGUIallows youto selectfilesanddirectoriestoinclude orexclude.

See Chapter2,“ConfiguringTivoliStorageManager,”onpage13,

Chapter4,“Backing upyourdata,”onpage47,Chapter6,“Archiving and retrievingyour data,”onpage85,and Chapter10,“Usingcommands,”on page271 formoreinformation.

Enhancementstoqueryschedulecommand

Tomoreaccuratelydeterminethestatusofscheduledevents,thequery schedulecommandona TivoliStorageManagerVersion5.3and above clientreports newparameters.SeeChapter7,“Automatingtasks,”onpage 93and Chapter10,“Usingcommands,”onpage271formoreinformation abouttheseenhancements.AlsoseetheAdministrator’sGuideand Administrator’sReferencefor youroperatingsystem.

Dynamic clienttracing

Anewcommand-line utility,dsmtrace,isavailabletoenabletracing, disabletracing,or changetraceflagswhiletheclientisrunning.Seethe ProblemDeterminationGuideforinformationaboutusingthis utility.

Note: Tracingisanadvanceddiagnostic featureintendedforuseonlyat

therecommendationofIBM supportanddevelopment, oras outlinedintheProblemDeterminationGuide.

Client-node proxysupport

Backuptimecanbe reducedandclusteredconfigurationscanstoredata with client-nodeproxysupport.TivoliStorageManagernodes,when authorized asagentnodes,canbe directedtobackupor restoredataon behalfofanothernode (thetarget node).Thisenablesconcurrent

operations frommultiplenodestostore datatothesame targetnodeand filespaceinparallel.Theconcurrentoperationscanreducebackupand restoretimesinenvironmentssuchasApple’sXsan.Clientnodescanalso be configuredwithproxynodeauthoritytosupportmanyofthesystems

thatcanbeconfigured tosupportclusteringfailover.Theasnodename

option alsoallowsdatatobe restoredfromadifferentsystemthantheone whichperformedthebackup.See“Asnodename”onpage129formore information.

Supportfordeletingindividualbackupsfroma serverfilespace

Ifyour administratorhasgivenyouauthority,youcandeleteindividual backupcopiesfromtheTivoliStorageManagerserverwithoutdeletingthe entirefilespace.Thiscanbeusefulinthefollowingsituations:

v

Youneedto deletesensitivefileswhichwere mistakenlybackedup.

v

Youneedto deletea subsetofbackupfileswhichwereinadvertently

backed up.

v Youneedto deletefiles thatarefoundtocontainviruses.

See“Deletingbackupdata” onpage61for moreinformation.

Optimizedoptiondefaultvalues

Table3.Optimizedoptiondefaultvalues

Option Change Page

diskbuffsize AllowsyoutospecifyI/O buffersize(inkilobytes)that theclientcanusetooptimize backup,archive,orHSM clientperformance. Recommendation:Usethe defaultvalueinsteadof specifyingthediskbuffsize option.

155

largecommbuffers Thisoptionhasbeen replacedbythediskbuffsize option.Atthistime, largecommbufferswill continuetobeacceptedby theTivoliStorageManager clientinordertoeasethe transitiontothenewoption. However,thevaluespecified bylargecommbufferswillbe ignoredinfavorofthe diskbuffsizesetting. Recommendation: Discontinuetheuseof largecommbuffersbecause futurereleasesofTivoli StorageManagermightnot acceptthisoption.

155

tcpadminport SpecifiesaseparateTCP/IP portnumberonwhichthe serveriswaitingforrequests foradministrativeclient sessions,allowingsecure administrativesessions withinaprivatenetwork.If thisoptionisnotspecified, thedefaultvalueisthevalue ofthetcpportoption.

Table3.Optimizedoptiondefaultvalues (continued)

Option Change Page

tcpbuffsize Thedefaultvaluewas changedfrom16kilobytesto 32kilobytes.

252

tcpnodelay Thedefaultvaluewas changedfromnotoyes.

tcpnodelayyesdisablesthe TCP/IPNaglealgorithm. Thisalgorithmisusedto reducethenumberofsmall segmentssentacrossthe network,butinsome environmentsthismight negativelyimpactTivoli StorageManager performance.

Recommendation:Usethe defaultofyes,unlessyou fullyunderstandtheeffects oftheTCPNaglealgorithm onnetworktransmissions andhowitsuseaffectsthe performanceofTivoli StorageManagerinyour environment.

256

tcpwindowsize Thedefaultvaluewas changedfrom32kilobytesto 63kilobytes.

259

txnbytelimit Thedefaultvaluewas changedfrom2048kilobytes to25600kilobytes.

Chapter

1.

Installing

Tivoli

Storage

Manager

TheTivoliStorageManager backup-archiveclienthelpsyouprotectinformationon your workstation.Using TivoliStorageManager,youcanmaintainbackupversions of yourworkstationfilesthatyoucanrestoreiftheoriginalfilesaredamagedor lost. Youcanalso archiveworkstationfilesthatyoudo notcurrentlyneed,or preservethemintheircurrentstate, andretrievethemwhennecessary.

Attention: YoumustbeasystemadministratortoinstallTivoliStorageManager.

YoucanaccessTivoliStorageManager backupand archivefeatures:

v Locallythrough thenativeGraphical UserInterface.Themainwindow displays

buttonslabeled:Backup,Restore,Archive,andRetrieve.Toinitiatea task,click theappropriatebutton.

v Locallyorremotelythrough theclientcommand-line interface.

Thischapterprovides migration,environment,and installationinformationfortheTivoli StorageManagerclient.Afterinstallation,seeChapter2,“Configuring TivoliStorage Manager,” onpage 13forrequiredconfigurationtaskstoperform beforeusingTivoli StorageManager.

Migrating

from

earlier

versions

Thefollowingsectionsexplainwhatyouneedtodoif youaremigratingtoTivoli StorageManagerVersion5.5fromaprevious version.

Upgrade

path

for

clients

and

servers

Aspart ofamigration planfromTivoliStorageManagerVersion5.4toTivoli StorageManagerVersion5.5, TivoliStorageManager clientsandservers canbe upgraded atdifferenttimes.Thisconfigurationissupportedaslongastheolder version issupported. Tohelppreventdisruptiontoyourbackupandarchive activitiesduring themigration,followtheseguidelines:

v ATivoliStorageManagerVersion5.4clientcanperformbackup, restore,archive,

andretrievefunctionsto aTivoliStorageManagerVersion5.5server.

v ATivoliStorageManagerVersion5.5clientcanperformbackup, restore,archive,

retrieve,andqueryfunctionstoa TivoliStorageManager Version5.4server. v Ifyoubackuporarchivedatafroma TivoliStorageManagerVersion5.3or

Version5.4clienttoanyTivoliStorageManagerserver,youcanrestoreor retrievethatdatausingaTivoli StorageManager Version5.5client. v Ifyoubackuporarchivedatafroma TivoliStorageManagerVersion5.5

Macintoshclient,youcannotrestoreorretrievethatdatausinga TivoliStorage ManagerVersion5.4Macintosh client.

v AlladministrativeclientscanadministerTivoliStorageManager Version5.4and

Version5.5servers.

v IfyouuseaTivoliStorageManagerclientprior toVersion5.5torestorethe

Version5.5data,thefileattributes willbe settozero.Thisonlyaffects theclient dependantattributes,suchasdate, time,and owners.

v IfyouaremigratingfromTivoliStorageManagerVersion5.3,theformatofthe

TivoliStorageManager passwordfilehaschanged.Yourexistingpasswordfile willbe migratedtothenewformatduringthefirstsession witha TivoliStorage | | | | | | | | | | | | | | | | | | | | | | | | | | |

ManagerserverafteryouinstalltheTivoliStorageManagerVersionclient.After thepasswordfilehasbeen migrated,previousversionsof theTivoliStorage Managerclientwillnotprocess theupdatedpasswordfilecorrectly.Ifyouuse TivoliStorageManager clientdataencryptionandyoueverneedtogo backto anolderclientversion,followthesestepstoavoidproblemsrestoringyour data withtheupdatedpasswordfileandtheolderclient:

1. Before installingthenew version,make acopyofthepasswordfile.See

“Passworddir”onpage209 forinformationaboutfindingthelocationofthe passwordfile.

2. Afterinstallingthenewversion,runa backupand entertheencryptionkey

passwordwhenprompted.

Ifdataencryptionisused,youwillbe promptedfortheencryptionkey passwordonthefirstbackupaftertheupgrade,toensurethatthecorrect encryptionkeyisnowused.

3. Ifyouneedtogo backtoanolderversion,followthesesteps:

a. Uninstalltheclient.

b. Restorethesavedpasswordsfile.

c. Installtheolderversion.

Migrating

to

the

Tivoli

Storage

Manager

Version

5.5

Macintosh

client

from

releases

prior

to

5.3.2

The 5.3.2release oftheTivoliStorageManager Macintoshclienthad several changes thatmustbe managedaspartofthemigration frompreviousTivoli StorageManagerversions:

v Optionfilechanges

v Schedulerchanges

v Extendedattributechanges

Option

file

changes

The TivoliStorageManager clientnowusestheUNIX®_{pathnamesinternally.This}

reduces theamount ofpathtranslationthatmust bedone.However,this affects how pathsarestored intheTivoliStorageManager optionfilesandTivoliStorage Manager Scheduledefinitions.

Onesetof optionsthattakesa patharetheincludeand excludeoptions.For example,consider theoption toexcludethefilesinthe’Documents’folderfor ’User1’ onthestartupvolume’Macintosh HD’.WiththeTivoliStorageManager Version5.2.4and earlierclients,thisentrywouldbe intheTSMSystemPreferences file:

exclude "Macintosh HD:Users:User1:Documents:*"

Beginningwith theVersion5.3.2client,toexcludethefiles,theentryintheTSM SystemPreferenceswouldbe:

exclude /Users/User1/Documents/*

See “Usinginclude-excludeoptions”onpage28formoreexamples ofhowthe include/excludeoptionsmustnow beset.

All oftheoptionslisted in2haveapathfora parameter.Ifanyofthese options are setinyour currentoptionfiles,theyneedtobeconverted toUNIXpaths before theTivoliStorageManager Version5.4clientcanbeused.

v DOMain | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v ERRORLOGName

v INCLExcl

v MAILprog

v PASSWORDDIR

v Allexcludeandinclude options

v POSTSchedulecmd v POSTNschedulecmd v PRESchedulecmd v PRENSchedulecmd v SCHEDLOGName

Followthese stepstomigrate youroptionpaths:

1. Renameyourexistingsystemoption files(dsm.sys)and clientuseroptionsfiles

(dsm.opt).

2. Opentherenamedfilesina texteditorsoyoucanviewyour currentoption

settings.Thedefaultlocationfortheoption filesis:

/Library/Preferences/Tivoli Storage Manager

3. StarttheTivoliStorageManagerapplication.Thesetup assistantwillstart

automatically.

4. Usingyour oldoptionfilesasareference,fillinthefields presentedbythe

SetupAssistant.Markeachoptionintheoldoptionfilestokeeptrackofthe optionsthathavebeen set.

5. AftertheSetupAssistanthasfinished,openthepreferenceeditorand setany

optionsthatwerenotavailableintheSetupAssistant.

6. Markeachoptionintheoldoptionfilestokeeptrackoftheoptionsthathave

beenset.

7. Quittheclientsotheoptionscantakeaffect.

8. Reviewthemarks intheoldoptionfiles toseeif anyoptionhasnotbeenset

with eithertheSetupwizardorPreferenceEditor. Theseoptionscanbeadded totheoptionfileswith atexteditor.

Scheduler

changes

Thescheduler nowtakestheUNIXpathforthe’object’option.Anyschedulethat specifies apathmust bechangedtousetheUNIXpath.Forexample,thisschedule hasanobjectthatmustbe updated:

Policy Domain Name: STANDARD Schedule Name: INCR_MAC_HD Description: INCR_MAC_HD Action: Incremental Options: Objects: "Macintosh HD" Priority: 5 Start Date/Time: 05/14/2005 15:21:32 Duration: 1 Hour(s) Period: 1 Day(s) Day of Week: Any Expiration:

Last Update by (administrator): ADMIN Last Update Date/Time: 05/14/2005 15:22:37 Managing profile:

Thisisthesame schedule,witha newname,and anupdatedobject:

Policy Domain Name: STANDARD Schedule Name: INCR_UNIX_MAC_HD Description: INCR_UNIX_MAC_HD Action: Incremental Options: | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Objects: / Priority: 5

Start Date/Time: 05/14/2005 15:21:32 Duration: 1 Hour(s)

Period: 1 Day(s) Day of Week: Any Expiration:

Last Update by (administrator): ADMIN Last Update Date/Time: 05/14/2005 15:24:04 Managing profile:

Contact yourTivoliStorageManagerSystemAdministratorandhavethemupdate anyschedulesthatspecifyapathtousetheUNIX versionsofthosepaths.

Extended

attributes

changes

Ifyoubackuporarchivedatawith aTivoliStorageManagerVersion5.5clientto anyTivoliStorageManagerserverandthatdatahasExtendedAttributes,thedata cannotberestored bytheTivoliStorageManagerVersion5.2,orearlier,client.

Migrating

to

the

Unicode-enabled

client

Unicodeisauniversalcharacterencodingstandardthatsupportstheinterchange, processing, anddisplayoftextthatiswritteninanyofthelanguages ofthe modern world.Unicode-enabledfilespacesprovidesupport formultilingual workstations withoutregardforthecurrentlocale.BeginningwithTivoliStorage Manager Version5.2, theMacintoshclientisUnicode-enabled.The

Unicode-enabled clientsupportsUnicodeforfile,directory,andfilespacenames.

Benefits

of

using

the

Unicode-enabled

client

The followinglistincludessomebenefitsofusingtheUnicode-enabled client. v Ifyoubackuporarchiveobjectswith aUnicode-enabledclient,youcanrestore

orretrievethese objectswitha Unicode-enabledclientinanyothersupported languageenvironment.For example,aJapaneseUnicode-enabled clientcan restorefilesbackedupbya GermanUnicode-enabledclient.

v

TheUnicode-enabledclientiscrosslanguage,meaningthatitworks withfiles

usingdifferentcodepages.TheUnicode-enabledclient canhandleamixtureof filesfromdifferentcodepagesorlocalesinthesame filespace.

v WithoutthesupportforstoringUnicode-enabledfilespaces,someearlier

Macintoshclients haveexperienced backupfailures.Thisoccurswhenfilespaces containnamesofdirectoriesorfiles inmultiplelanguagesorhavenamesthat cannotbe convertedtotheclient’scurrentcodepage.

How

to

migrate

to

the

Unicode-enabled

client

New clientsstoringdataontheserverforthefirsttimerequirenospecial setup. Inthiscase, theserverautomaticallystoresdatainUnicode-enabledfilespaces. However, ifyour clientalreadystoresdataontheserver,youneedtoplanforthe migration ofyourfilespacestoUnicode-enabledfilespaces.Themigration involvesrenamingyourfilespacesontheserverandcreatingnew

Unicode-enabled filespacesontheserverusingtheautofsrename option.

The TivoliStorageManager administratorcanspecifythreepossiblevaluesusing theserverautofsrename option:yes,no,orclient.Notethattheserversettingfor this optionoverridesthesettingontheclient.

v Iftheserverspecifies no,theexistingfilespacesforyournodeare notrenamed

orUnicode-enabled,evenifyouhaveaUnicode-enabledclientinstalled. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v Iftheserverspecifies yes,andtheclientperformsanincrementalbackupwith

domain=all-local, allfilespacesspecifiedinthecurrentoperationthatare not Unicode-enabledarerenamed.TheUnicode-enabledclient thencreatesnew Unicode-enabledfilespaces.

Iftheclientperformsa selectivebackup, onlythefilespacesyouspecifyinthe currentoperationare renamedand Unicode-enabled.

v

Iftheserverspecifies client,theclientcansettheautofsrenameoption inthe

clientuseroptionsfile(dsm.opt)toprompt,yes,orno.Iftheclientsetstheoption tono,thefilespacesthatarenotUnicode-enabledarenotrenamedandarenot Unicode-enabled.Iftheclientspecifies prompt,theclientpromptsyouwhetherto renamefilespaces.Theclientpromptsyouonlyoncetorenamea particularfile space.

Note: TheWebGUIwillnotpromptyouiftheautofsrenameoptionissetto

prompt.Theoptionwillbe ignoredand thefilespacewillremain non-Unicode.

Optionally, yourTivoliStorageManageradministratorcanrenamethefilespaces ontheserverthatarenotUnicode-enabled.

For optionsand resultswhenusingtheautofsrenameoption,seethetablebelow.

Serveroption Clientoption Result

Yes Prompt,Yes,No Renamed

No Prompt,Yes,No NotRenamed

Client No NotRenamed

Client Yes Renamed

Client Prompt CLI: Based on

User Response Web GUI: Not renamed

For detailedinformationabouttheautofsrenameoption,see“Autofsrename”on page135. ForadditionalinformationaboutworkingwiththeMacintosh clients, see:

v “Considerationsfor Unicode-enabledclients”onpage184

v “Inclexcl”onpage184

Considerations

for

migrating

to

the

Unicode-enabled

client

WhenmigratingtotheTivoliStorageManagerMacintosh Unicode-enabledclient, consider thefollowingguidelines:

v Ensurethatyouinstall thefontsforthelanguagesyouwanttodisplay. Ifyou

donothavethenecessaryfontsinstalled,thefilenamesand archivedescriptions mightnotdisplayproperly.However, theUnicode-enabledclientscanstillback up,restore,archive,and retrievethefilesand directories.

v

ThenameoftheUnicode-enabledfilespacemightbe unreadableiftheserver

cannotdisplaytheUnicodename.Inthiscase,usethefilespaceidentifier(fsID) ofthefilespacetoidentifythesefilespacesontheserver.On theGUImain window,selecttheFiledetailsoptionfromtheViewmenutodisplaythefsID ofafilespace.

v Afterinstallinga Unicode-enabledclient,perform afullincrementalbackupto

renameallexistingfilespacesthatarenotUnicode-enabledandbackupthefiles anddirectorieswithinthemunderthenewUnicode-enabledfilespaces.

| | | | | | | | | | | | | | | | | | |||| ||| ||| ||| ||| ||| | | | | | | | | | | | | | | | | | | | | | | |

v Renamedfilespacesremainontheserverand aremanagedasstabilizedfile

spaces.Thesefile spacescontain alltheoriginaldata, whichcanstillberestoreduntil thefilespacesaredeleted.

v WhenanexistingfilespaceisrenamedduringUnicodeconversion, anyaccess

rulesdefinedforthefilespaceremainapplicabletotheoriginalfilespace. New accessrulesmustbe definedto applytothenew Unicodefilespace, ifnecessary. v

Whenbackingupfilesto afilespacethatisnotUnicode-enabled,the

Unicode-enabledclientskipsthefilesanddirectorieswith namescontaining charactersfromacodepageotherthanthecurrentlocale.

v Iffilesanddirectorieswithnamescontaining charactersfromacodepageother

thanthecurrentlocalewere previouslybackedupwithaclientthatwasnot Unicode-enabled,TivoliStorageManagerwillexpire theminthefilespacethatis notUnicode-enabled.However, theUnicode-enabled clientcanbackupor archivethesefiles toaUnicode-enabledfilespace.

v WhenmigratingfromaclientthatisnotUnicode-enabledtoaUnicodeclient,

filenameswith double-bytecharactersmixedwith single-bytecharactersmight berestoredinmixedsingle-bytecharacterset(SBCS)format. Thisisonlya displayissue.

v

Whena clientperformsa selectivebackupofan objectandtheoriginalfile

spaceisrenamed,thenewUnicode-enabledfilespacecontainsonlythatobject. TivoliStorageManager willbackupallotherdirectoriesandfilespacesduring thenext fullincrementalbackup.

v TheUnicode-enabledclienthasa fileanddirectorynamesizelimitationof504

bytes.Depending ontheUTF-8encoding(whichcanbe2 bytes,3 bytes,or 4 bytes)oftheUnicodecharacter, thistranslatestoamaximumof126 to252 characters.

Attention: Ifyoudo notfollowthemigrationinstructionsproperly,youmight

havetwofilespaces,oneUnicodeand onenon-Unicode,withdifferentfilespace identifiers (fsID)forthesameclientvolume.Inthiscase,theTivoliStorage

Manager clientusesthenon-Unicode filespaceasthedefaultfilespaceforbackup and restoreoperations.

Macintosh

client

environment

Thissectioncontains clientenvironmentinformation,TivoliStorageManager client components,and hardwareand softwarerequirementsfortheMacintosh client.

For currentinformationconcerningtheclientenvironmentprerequisites forall TivoliStorageManager supportedclientplatforms,go totheWebsiteat:

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

Note: Duetodifferencesbetweenthisandprior versionsofTivoliStorage

Manager,theinstallationwillremovepriorversions ofTivoliStorage Manager.Thepriorinstallations thatwillberemovedinclude thefollowing: v

/Applications/TivoliStorageManagerv5.1

v /Applications/TivoliStorageManagerv5.2

v /Applications/TivoliStorageManagerv5.2.2

v /Applications/TivoliStorageManagerv5.2.3

v /Applications/TivoliStorageManagerv5.2.4

v /Applications/TivoliStorageManagerv5.2.5

Ifversionsprior toVersion5.3.2are installedinsomeotherlocation,the followingmustbe donebeforeinstallation:

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

1. RemoveorrenametheexistingTSMSystemPreferencesand TSMUser

Preference files in /Library/Preferences/Tiovli Storage Manager. 2. Deletethepriorversions.

Client

components

Thefollowingcomponentsare includedwith theTivoliStorageManagerClientfor Macintosh:

v Backup-Archiveclient(commandline)

v Administrativeclient(commandline)

v Backup-ArchiveJava

™_{GraphicalUserInterface(GUI)}

v WebBackup-Archiveclient

For moreinformationabouttheAdministrativeclient,see“Relatedpublications” onpagexii foravailableTivoliStorageManagerAdministrator’sReference publications.

Hardware

requirements

v APowerPC

®_orIntel® _{basedMacintosh}

v

Memory:512 MB

v

Diskspace: 100MB

v

Aminimum screenresolutionof800 by600 pixelsisrequiredtodisplaythe

TivoliStorageManager Backup-ArchiveClientJavaGUIand WebGUI.

Software

requirements

v MacOSX,version10.5.x,where x>=0

Communications

method

Tousethis communication method:

Installthissoftware: Toconnecttothese TivoliStorage Managerservers: TCP/IP SocketsforMacX,whichcomesstandard

withtheOS.

AIX® ,HP-UX,Linux® , Solaris,Windows®_, z/OS®

Installing

the

Macintosh

client

program

(required

system

administrator

task)

Attention: YoumustbeasystemadministratortoinstallTivoliStorageManager.

Installing

from

the

Tivoli

Storage

Manager

CD

Toinstall theMacintoshclientfromtheTivoliStorageManagerCD,followthese steps:

1. Gotothetsmcli/macdirectory, fortheMacintosh clientinstaller.

2. Double-clickthe5.5.0.0-TIV-TSMBAC-Mac.dmgfile,tomount thediskimage.

3. Double-clickthe″TivoliStorageManager″installationpackage icon.

4. Followtheon-screenpromptsto completetheinstallation.

Installing

from

the

command

line

Thisisanoptionalmethodofinstallationthatisusefulinsituationswherethe installationneedstobedone onmultiplesystemsor onsystemswithnodisplay |

attached. Itisdonefromthecommandline,canbescripted andrequiresnouser interaction.Toinstall TivoliStorageManagerfromthecommandline, followthese steps:

1. ChangedirectoriestowheretheTivoliStorageManagerinstallerislocated.

2. The’custom’installpackage canbeinstalledwiththefollowingcommand: /usr/sbin/installer -pkg "./Tivoli Storage Manager.mpkg"/Contents/

Packages/TsmBaDsmadmc.pkg -target /

3. Todoa ’typical’installationissue thiscommand:

/usr/sbin/installer -pkg "./Tivoli Storage Manager.mpkg" -target /

The packageslistedin Table4 arepartof theTivoliStorageManagerinstall

distribution usedbytheMacOSXInstallapplication.Theyare listedheretoassist those usersthatneed todoafullycustomized command-lineinstallation.

Table4.Macintoshinstallationpackages

Package PackageName PackageDescription

TivoliStorageManager Backup-ArchiveJavaBundle

TsmBaJavaBundle.pkg Containsthefollowing component:

v TivoliStorageManager JavaGUIClient NOTE:Requiresthatthe followingpackagesbe installedfirst:

v TivoliStorageManager Backup-ArchiveJavaGUI Files

v TivoliStorageManager Backup-ArchiveClient CommonJavaFiles v

TivoliStorageManager Backup-ArchiveClient CommonFiles

v TivoliStorageManager Backup-ArchiveICC Library

v TivoliStorageManager Backup-ArchiveHelpand Messages