Tivoli Storage Manager for Windows

Backup-Archive Clients Installation and Users Guide

Version 5.3

GC32-0788-05

Tivoli Storage Manager for Windows

Backup-Archive Clients Installation and Users Guide

Version 5.3

GC32-0788-05

Note Before using this information and the product it supports, read the general information under Notices on page 597.

Sixth Edition (December 2004)

This edition applies to Version 5.3 of IBM Tivoli Storage Manager (5608-ISM), IBM Tivoli Storage Manager Extended Edition (5608-ISX), IBM Tivoli Storage Manager for Storage Area Networks (5608-SAN), and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters.

Order publications through your IBM representative or the IBM branch office serving your locality.

Your feedback is important in helping to provide the most accurate and high-quality information. If you have comments about this manual or any other IBM Tivoli Storage Manager documentation, see Contacting customer support on page xvi.

Copyright International Business Machines Corporation 1993, 2004. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Tables . . . . . . . . . . . . . . . ix

About this book . . . . . . . . . . . xi Who should read this manual . . . . . . . . xi IBM Tivoli Storage Manager Web site . . . . . xii Conventions used in this book . . . . . . . . xii Reading syntax diagrams . . . . . . . . . . xii Related publications . . . . . . . . . . . xiv

Downloading or ordering publications . . . . xv Accessibility . . . . . . . . . . . . . xvi Contacting customer support . . . . . . . xvi Reporting a problem . . . . . . . . . . xvi Internet . . . . . . . . . . . . . . xvii

Summary of changes for Tivoli Storage Manager . . . . . . . . . . xix Technical changes for Version 5.3 - December 2004 xix Technical changes for Version 5.2.2 - December 2003 . . . . . . . . . . . . . . . . xxii Technical changes for Version 5.2 - April 2003 xxiii Technical changes for Version 5.1.5 - September 2002 . . . . . . . . . . . . . . . . xxvi Technical changes for Version 5.1 - April 2002 xxviii

Chapter 1. Installing Tivoli Storage Manager . . . . . . . . . . . . . . 1 Migrating from earlier versions . . . . . . . . 1

Upgrade path for clients and servers . . . . . 1 Migrating to the Unicode-enabled client . . . . 1 NDMP support requirements (Extended Edition only) . . . . . . . . . . . . . . . . 4 Additional migration information . . . . . . 5

Client environment requirements . . . . . . . 5 Client components . . . . . . . . . . . 5 Hardware requirements . . . . . . . . . . 6 Software requirements . . . . . . . . . . 6 Communications methods . . . . . . . . . 6

Client installation media on product CD-ROM . . . 6 Installing the software on your workstation . . . . 7

Silent installation . . . . . . . . . . . . 8 Upgrading, modifying, or reinstalling the client 10

Chapter 2. Configuring Tivoli Storage Manager . . . . . . . . . . . . . . 13 Creating and modifying the client options file (required) . . . . . . . . . . . . . . . 13

Creating a shared directory options file (optional) 15 Creating multiple options files . . . . . . . 15 Setting options in the client options file . . . . 16

Setting environment variables . . . . . . . . 16 Configuring the Web client . . . . . . . . . 17 Configuring the client scheduler . . . . . . . 19 Configuring Tivoli Storage Manager client/server communication across a firewall . . . . . . . 20

Configuring the journal engine service . . . . . 23 Configuring the Logical Volume Snapshot Agent for online image backup support . . . . . . . . 24 Configuring the LVSA to enable Open File Support (OFS) . . . . . . . . . . . . . . . . 24 Registering your workstation with a server (required task) . . . . . . . . . . . . . 25

Using closed registration . . . . . . . . . 25 Using open registration . . . . . . . . . 25

Associating your client node with a host system (optional) . . . . . . . . . . . . . . . 26 Creating an include-exclude list (optional) . . . . 27

Using include-exclude options . . . . . . . 28 Testing an include-exclude list with the Preview command . . . . . . . . . . . . . . 34 Processing include and exclude options . . . . 35 Processing rules when using UNC names . . . 37

Chapter 3. Getting started . . . . . . 39 Considerations for client services . . . . . . . 39 Permissions required to restore files that use adaptive subfile backup . . . . . . . . . . 40 Permissions required to back up, archive, restore or retrieve files on cluster resources . . . . . . . 40 Tivoli Storage Manager client authentication . . . 40 Starting a GUI session . . . . . . . . . . . 41

Using your Tivoli Storage Manager password . . 42 Setup Wizard . . . . . . . . . . . . . 42

Starting a command line session . . . . . . . 42 Using batch mode . . . . . . . . . . . 42 Using interactive mode . . . . . . . . . 42 Displaying Euro characters in command line prompt . . . . . . . . . . . . . . . 43 Using options on the DSMC command . . . . 44

Starting a Web client session . . . . . . . . . 44 Setting user privileges . . . . . . . . . . 46

Starting the client scheduler automatically . . . . 46 Changing your password . . . . . . . . . . 46 Sorting file lists using the Tivoli Storage Manager GUI . . . . . . . . . . . . . . . . . 47 Displaying online help . . . . . . . . . . 48 Ending a session . . . . . . . . . . . . . 48 Online forum . . . . . . . . . . . . . . 48 Other sources of online help . . . . . . . . . 49

Chapter 4. Backing up your data . . . 51 Planning your backups . . . . . . . . . . 51 When to back up and when to archive files . . . . 52 Pre-backup considerations . . . . . . . . . 53

LAN-free data movement . . . . . . . . . 53 SAN-based server-free data movement . . . . 54 Configure memory-constrained workstations to run incremental backups . . . . . . . . . 55 Performing a backup with limited bandwidth . . 55

Copyright IBM Corp. 1993, 2004 iii

||

||

| | |

| | |

Using an include-exclude list to control processing . . . . . . . . . . . . . . 56 Maximum file size for operations . . . . . . 57

Performing an incremental, selective, or incremental-by-date backup . . . . . . . . . 57

Supported file systems . . . . . . . . . 57 Full and partial incremental backup . . . . . 58 Incremental-by-date backup . . . . . . . . 61 Comparing full incremental, partial incremental, Incremental-by-date, and journal-based backups . 61 Selective backup . . . . . . . . . . . . 62 Open file support for backup operations . . . . 62 Backing up data using the GUI . . . . . . . 64 Backing up data using the command line . . . 66 Deleting backup data . . . . . . . . . . 68

Group backup: Backing up files from one or more file spaces . . . . . . . . . . . . . . . 69 Associating a local snapshot with a server file space 69 Backing up system objects (Windows 2000, XP) . . 69 Backing up Windows Server 2003 system state and system services . . . . . . . . . . . . . 70 Backing up Automated System Recovery (ASR) files (Windows XP, Windows Server 2003) . . . . . . 72 Performing an image backup . . . . . . . . 73

Before you perform an image backup . . . . . 73 Utilizing image backup to perform file system incremental backup . . . . . . . . . . . 74 Performing an image backup using the GUI . . 76 Performing an image backup using the command line . . . . . . . . . . . . . . . . 77

Backing up NAS file systems . . . . . . . . 77 Support for CDP Persistent Storage Manager (PSM) . . . . . . . . . . . . . . . 78 Backing up NAS file systems using the Web client GUI . . . . . . . . . . . . . . 78 Backing up NAS file systems using the command line . . . . . . . . . . . . . . . . 80 Backup and restore of NAS file servers using CIFS . . . . . . . . . . . . . . . . 81

Backing up the WebSphere Application Server (WAS) . . . . . . . . . . . . . . . . 82 Displaying backup processing status . . . . . . 82 Backup: Additional considerations . . . . . . . 84

Backing up open files . . . . . . . . . . 84 Understanding how files are managed . . . . 85 Backing up removable media . . . . . . . 85 Backing up fixed drives . . . . . . . . . 85 Backing up NTFS file spaces . . . . . . . . 85 Using Universal Naming Convention names . . 86 Backing up Microsoft Dfs files . . . . . . . 87

Chapter 5. Restoring your data . . . . 91 Duplicate file names . . . . . . . . . . . 92 Restoring files using Universal Naming Convention names . . . . . . . . . . . . . . . . 92 Restoring an active or inactive backup . . . . . 92 Restoring files and directories . . . . . . . . 93

Restoring data using the GUI . . . . . . . 93 Restoring data using the command line . . . . 93

Restoring system objects . . . . . . . . . . 97

Restoring Windows Server 2003 system state and system services . . . . . . . . . . . . . 98 Restoring Automated System Recovery (ASR) files (Windows XP, Windows Server 2003) . . . . . . 99 Performing a Windows XP or Windows Server 2003 system recovery . . . . . . . . . . . 100

Operating system functions but requires complete system restore . . . . . . . . . 100 Complete recovery required, including operating system re-installation . . . . . . 100

Restoring Microsoft Dfs trees and files . . . . . 106 Restoring an image (Windows 2000, XP) . . . . 106

Peforming an image restore using the GUI . . 107 Performing an image restore using the command line . . . . . . . . . . . . 108

Restoring data from a backup set . . . . . . . 108 Restoring an entire or partial backup set . . . 109 Restoring backup sets using the GUI . . . . 109 Restoring backup sets using the command line client . . . . . . . . . . . . . . . 110

Performing point-in-time restores . . . . . . . 111 Restoring NAS file systems . . . . . . . . . 112

Restoring NAS file systems using the Web client 112 Restoring NAS files and directories using the Web client . . . . . . . . . . . . . 113 Restoring NAS file systems using the command line . . . . . . . . . . . . . . . . 115

Restoring the WebSphere Application Server (WAS) 116 Restore: Additional considerations . . . . . . 117

Authorizing another user to restore or retrieve your files . . . . . . . . . . . . . . 117 Restoring or retrieving files from another client node . . . . . . . . . . . . . . . 118 Restoring or retrieving your files to another workstation . . . . . . . . . . . . . 119 Restoring or retrieving files to another type of workstation . . . . . . . . . . . . . 119 Restoring a disk in the event of disk loss . . . 119 Deleting file spaces . . . . . . . . . . 120

Chapter 6. Archiving and retrieving your data . . . . . . . . . . . . . 121 Archiving files . . . . . . . . . . . . . 121

Open file support for archive operations (Windows 2000, XP) . . . . . . . . . . 122 Archiving data using the GUI . . . . . . . 122 Archiving data using the command line . . . 123 Deleting archive data . . . . . . . . . . 124

Retrieving archives . . . . . . . . . . . 125 Retrieving archives using the GUI . . . . . 125 Retrieving archives using the command line . . 126

Chapter 7. Automating tasks . . . . . 129 Specifying scheduling options . . . . . . . . 129 Configuring the client scheduler . . . . . . . 129 Starting the client scheduler . . . . . . . . 130 Enabling firewall support . . . . . . . . . 130 Mobile dial-up support . . . . . . . . . . 130 Return codes from the command line interface . . 130 Displaying information about scheduled work . . 132

iv IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

||

Displaying information about completed work . . 133 Event logging . . . . . . . . . . . . 134

Enabling or disabling scheduled commands . . . 136 Accessing Windows network drives during a scheduled backup . . . . . . . . . . . . 136

Chapter 8. Understanding storage management policies . . . . . . . . 139 Using policy domains and policy sets . . . . . 139 Using management classes and copy groups . . . 139 Displaying information about management classes and copy groups . . . . . . . . . . . . 141

Copy group name . . . . . . . . . . . 142 Copy type . . . . . . . . . . . . . 142 Copy frequency . . . . . . . . . . . 142 Versions data exists . . . . . . . . . . 142 Versions data deleted . . . . . . . . . . 142 Retain extra versions . . . . . . . . . . 143 Retain only version . . . . . . . . . . 143 Copy serialization . . . . . . . . . . . 143 Copy mode . . . . . . . . . . . . . 144 Copy destination . . . . . . . . . . . 144 Retain versions . . . . . . . . . . . . 144

Selecting a management class for files . . . . . 145 Assigning a management class to files . . . . . 145 Overriding the management class for archived files 146 Selecting a management class for directories . . . 146 Binding and rebinding management classes to files 147 Rebinding backup versions of files . . . . . . 148 Using a retention grace period . . . . . . . . 148

Chapter 9. Using processing options 149 Overview of processing options . . . . . . . 149 Communication options . . . . . . . . . . 149

TCP/IP options . . . . . . . . . . . 150 Named Pipes option . . . . . . . . . . 150

Node options . . . . . . . . . . . . . 151 Backup and archive processing options . . . . . 151 Restore and retrieve processing options . . . . . 159 Scheduling options . . . . . . . . . . . 162 Format and language options . . . . . . . . 163 Command processing options . . . . . . . . 164 Authorization options . . . . . . . . . . 164 Error processing options . . . . . . . . . . 165 Transaction processing options . . . . . . . 165 Web client options . . . . . . . . . . . . 166 Diagnostics options . . . . . . . . . . . 166 Using options with commands . . . . . . . 167

Entering options with a command . . . . . 167 Initial command line only options . . . . . 173

Client options reference . . . . . . . . . . 174 Activatekey . . . . . . . . . . . . . . 175 Archmc . . . . . . . . . . . . . . . 176 Asnodename . . . . . . . . . . . . . 177 Asrmode . . . . . . . . . . . . . . . 179 Autofsrename . . . . . . . . . . . . . 180 Changingretries . . . . . . . . . . . . 182 Class . . . . . . . . . . . . . . . . 183 Clusterdisksonly . . . . . . . . . . . . 184 Clusternode . . . . . . . . . . . . . . 186

Collocatebyfilespec . . . . . . . . . . . 187 Commmethod . . . . . . . . . . . . . 188 Commrestartduration . . . . . . . . . . . 189 Commrestartinterval . . . . . . . . . . . 190 Compressalways . . . . . . . . . . . . 191 Compression . . . . . . . . . . . . . 192 Computername . . . . . . . . . . . . . 194 Console . . . . . . . . . . . . . . . 195 Dateformat . . . . . . . . . . . . . . 197 Deletefiles . . . . . . . . . . . . . . 199 Description . . . . . . . . . . . . . . 200 Detail . . . . . . . . . . . . . . . . 202 Dfsbackupmntpnt . . . . . . . . . . . . 203 Dirmc . . . . . . . . . . . . . . . . 204 Dirsonly . . . . . . . . . . . . . . . 205 Diskbuffsize . . . . . . . . . . . . . . 206 Domain . . . . . . . . . . . . . . . 207 Domain.image . . . . . . . . . . . . . 209 Domain.nas . . . . . . . . . . . . . . 210 Editor . . . . . . . . . . . . . . . . 212 Enablelanfree . . . . . . . . . . . . . 213 Enableserverfree . . . . . . . . . . . . 214 Encryptiontype . . . . . . . . . . . . . 216 Encryptkey . . . . . . . . . . . . . . 217 Errorlogmax . . . . . . . . . . . . . . 219 Errorlogname . . . . . . . . . . . . . 220 Errorlogretention . . . . . . . . . . . . 221 Exclude options . . . . . . . . . . . . 223 Fileleveltype . . . . . . . . . . . . . . 228 Filelist . . . . . . . . . . . . . . . . 229 Filename . . . . . . . . . . . . . . . 231 Filesonly . . . . . . . . . . . . . . . 233 Fromdate . . . . . . . . . . . . . . . 234 Fromnode . . . . . . . . . . . . . . 235 Fromtime . . . . . . . . . . . . . . . 236 Frsprimaryrestore . . . . . . . . . . . . 237 Groupname . . . . . . . . . . . . . . 238 Guitreeviewafterbackup . . . . . . . . . . 239 Httpport . . . . . . . . . . . . . . . 240 Ifnewer . . . . . . . . . . . . . . . 241 Imagegapsize . . . . . . . . . . . . . 242 Imagetofile . . . . . . . . . . . . . . 243 Imagetype . . . . . . . . . . . . . . 244 Inactive . . . . . . . . . . . . . . . 245 Inclexcl . . . . . . . . . . . . . . . 246 Include options . . . . . . . . . . . . . 248 Incrbydate . . . . . . . . . . . . . . 253 Incremental . . . . . . . . . . . . . . 254 Incrthreshold . . . . . . . . . . . . . 255 Lanfreecommmethod . . . . . . . . . . . 257 Lanfreeshmport . . . . . . . . . . . . 258 Lanfreetcpport . . . . . . . . . . . . . 259 Language . . . . . . . . . . . . . . . 260 Largecommbuffers . . . . . . . . . . . . 262 Latest . . . . . . . . . . . . . . . . 263 Localbackupset . . . . . . . . . . . . . 264 Location . . . . . . . . . . . . . . . 265 Managedservices . . . . . . . . . . . . 266 Maxcmdretries . . . . . . . . . . . . . 268 Memoryefficientbackup . . . . . . . . . . 269 Mode . . . . . . . . . . . . . . . . 270

Contents v

||

||

| |

| |

| |

Monitor . . . . . . . . . . . . . . . 272 Namedpipename . . . . . . . . . . . . 273 Nasnodename . . . . . . . . . . . . . 274 Nodename . . . . . . . . . . . . . . 275 Nojournal . . . . . . . . . . . . . . 276 Noprompt . . . . . . . . . . . . . . 277 Numberformat . . . . . . . . . . . . . 278 Optfile . . . . . . . . . . . . . . . 280 Password . . . . . . . . . . . . . . . 281 Passwordaccess . . . . . . . . . . . . . 282 Pick . . . . . . . . . . . . . . . . 284 Pitdate . . . . . . . . . . . . . . . 285 Pittime . . . . . . . . . . . . . . . 286 Postschedulecmd/Postnschedulecmd . . . . . 287 Postsnapshotcmd . . . . . . . . . . . . 289 Preschedulecmd/Prenschedulecmd . . . . . . 291 Preservelastaccessdate . . . . . . . . . . 293 Preservepath . . . . . . . . . . . . . 295 Presnapshotcmd . . . . . . . . . . . . 298 Queryschedperiod . . . . . . . . . . . . 300 Quiet . . . . . . . . . . . . . . . . 301 Replace . . . . . . . . . . . . . . . 302 Resetarchiveattribute . . . . . . . . . . . 304 Resourceutilization . . . . . . . . . . . 306 Retryperiod . . . . . . . . . . . . . . 308 Revokeremoteaccess . . . . . . . . . . . 309 Runasservice . . . . . . . . . . . . . 310 Schedcmddisabled . . . . . . . . . . . . 311 Schedlogmax . . . . . . . . . . . . . 312 Schedlogname . . . . . . . . . . . . . 313 Schedlogretention . . . . . . . . . . . . 314 Schedmode . . . . . . . . . . . . . . 316 Scrolllines . . . . . . . . . . . . . . 318 Scrollprompt . . . . . . . . . . . . . 319 Sessioninitiation . . . . . . . . . . . . 321 Shmport . . . . . . . . . . . . . . . 323 Showmembers . . . . . . . . . . . . . 324 Skipntpermissions . . . . . . . . . . . . 325 Skipntsecuritycrc . . . . . . . . . . . . 326 Snapshotcachelocation . . . . . . . . . . 327 Snapshotcachesize . . . . . . . . . . . . 328 Snapshotfsidleretries . . . . . . . . . . . 329 Snapshotfsidlewait . . . . . . . . . . . 330 Snapshotroot . . . . . . . . . . . . . 332 Subdir . . . . . . . . . . . . . . . . 335 Subfilebackup . . . . . . . . . . . . . 337 Subfilecachepath . . . . . . . . . . . . 338 Subfilecachesize . . . . . . . . . . . . 339 Tapeprompt . . . . . . . . . . . . . . 340 Tcpadminport . . . . . . . . . . . . . 342 Tcpbuffsize . . . . . . . . . . . . . . 343 Tcpclientaddress . . . . . . . . . . . . 344 Tcpclientport . . . . . . . . . . . . . 345 Tcpnodelay . . . . . . . . . . . . . . 346 Tcpport . . . . . . . . . . . . . . . 347 Tcpserveraddress . . . . . . . . . . . . 348 Tcpwindowsize . . . . . . . . . . . . . 349 Timeformat . . . . . . . . . . . . . . 350 Toc . . . . . . . . . . . . . . . . . 352 Todate . . . . . . . . . . . . . . . . 354 Totime . . . . . . . . . . . . . . . . 355

Txnbytelimit . . . . . . . . . . . . . . 356 Type . . . . . . . . . . . . . . . . 357 Usedirectory . . . . . . . . . . . . . . 358 V2archive . . . . . . . . . . . . . . 359 Verbose . . . . . . . . . . . . . . . 360 Verifyimage . . . . . . . . . . . . . . 361 Virtualfsname . . . . . . . . . . . . . 362 Virtualnodename . . . . . . . . . . . . 363 Wasexphome . . . . . . . . . . . . . 365 Washome . . . . . . . . . . . . . . . 366 Wasndhome . . . . . . . . . . . . . . 367 Wasnode . . . . . . . . . . . . . . . 368 Wastype . . . . . . . . . . . . . . . 369 Wasuser . . . . . . . . . . . . . . . 370 Webports . . . . . . . . . . . . . . . 371

Chapter 10. Using commands . . . . 373 Starting and ending a client command session . . 378

Process commands in batch mode . . . . . 378 Process commands in interactive mode . . . . 379

Entering client commands . . . . . . . . . 379 Command name . . . . . . . . . . . 379 Options . . . . . . . . . . . . . . 379 Parameters . . . . . . . . . . . . . 380 File specification syntax . . . . . . . . . 380

Using wildcard characters . . . . . . . . . 381 Entering commands . . . . . . . . . . . 382 Client commands reference . . . . . . . . . 382 Archive . . . . . . . . . . . . . . . 383 Backup Activedirectory . . . . . . . . . . 386 Backup ASR . . . . . . . . . . . . . . 387 Backup Certserverdb . . . . . . . . . . . 388 Backup Clusterdb . . . . . . . . . . . . 389 Backup Complusdb . . . . . . . . . . . 390 Backup Eventlog . . . . . . . . . . . . 391 Backup FRS . . . . . . . . . . . . . . 392 Backup Group . . . . . . . . . . . . . 393 Backup Image . . . . . . . . . . . . . 395 Backup NAS . . . . . . . . . . . . . 401 Backup Registry . . . . . . . . . . . . 404 Backup RSM . . . . . . . . . . . . . 405 Backup Sysfiles . . . . . . . . . . . . . 406 Backup Systemobject . . . . . . . . . . . 407 Backup Systemservices . . . . . . . . . . 408 Backup Systemstate . . . . . . . . . . . 410 Backup Sysvol . . . . . . . . . . . . . 411 Backup WAS . . . . . . . . . . . . . 412 Backup WMI . . . . . . . . . . . . . 414 Cancel Process . . . . . . . . . . . . . 415 Cancel Restore . . . . . . . . . . . . . 416 Delete Access . . . . . . . . . . . . . 417 Delete Archive . . . . . . . . . . . . . 418 Delete Backup . . . . . . . . . . . . . 420 Delete Filespace . . . . . . . . . . . . 423 Delete Group . . . . . . . . . . . . . 425 Expire . . . . . . . . . . . . . . . . 427 Help . . . . . . . . . . . . . . . . 429 Incremental . . . . . . . . . . . . . . 430 Loop . . . . . . . . . . . . . . . . 437 Macro . . . . . . . . . . . . . . . . 438 Monitor Process . . . . . . . . . . . . 439

vi IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

|| | |

Preview . . . . . . . . . . . . . . . 440 Query Access . . . . . . . . . . . . . 442 Query Activedirectory . . . . . . . . . . 443 Query Archive . . . . . . . . . . . . . 444 Query ASR . . . . . . . . . . . . . . 446 Query Backup . . . . . . . . . . . . . 447 Query Backupset . . . . . . . . . . . . 450 Query Certserverdb . . . . . . . . . . . 451 Query Clusterdb . . . . . . . . . . . . 452 Query Complusdb . . . . . . . . . . . . 453 Query Diskinfo . . . . . . . . . . . . . 454 Query Eventlog . . . . . . . . . . . . 455 Query Filespace . . . . . . . . . . . . 456 Query FRS . . . . . . . . . . . . . . 458 Query Group . . . . . . . . . . . . . 459 Query Image . . . . . . . . . . . . . 461 Query Inclexcl . . . . . . . . . . . . . 463 Query Mgmtclass . . . . . . . . . . . . 464 Query Node . . . . . . . . . . . . . . 465 Query Options . . . . . . . . . . . . . 466 Query Registry . . . . . . . . . . . . . 467 Query Restore . . . . . . . . . . . . . 468 Query RSM . . . . . . . . . . . . . . 469 Query Schedule . . . . . . . . . . . . 470 Query Session . . . . . . . . . . . . . 471 Query Sysfiles . . . . . . . . . . . . . 472 Query Systeminfo . . . . . . . . . . . . 473 Query Systemobject . . . . . . . . . . . 475 Query Systemservices . . . . . . . . . . 476 Query Systemstate . . . . . . . . . . . . 477 Query Sysvol . . . . . . . . . . . . . 478 Query WAS . . . . . . . . . . . . . . 479 Query WMI . . . . . . . . . . . . . . 480 Restart Restore . . . . . . . . . . . . . 481 Restore . . . . . . . . . . . . . . . 482 Restore Activedirectory . . . . . . . . . . 488 Restore ASR . . . . . . . . . . . . . . 489 Restore Backupset . . . . . . . . . . . . 490 Restore Certserverdb . . . . . . . . . . . 494 Restore Clusterdb . . . . . . . . . . . . 495 Restore Complusdb . . . . . . . . . . . 496 Restore Eventlog . . . . . . . . . . . . 497 Restore FRS . . . . . . . . . . . . . . 498 Restore Group . . . . . . . . . . . . . 499 Restore Image . . . . . . . . . . . . . 501 Restore NAS . . . . . . . . . . . . . 504 Restore Registry . . . . . . . . . . . . 506 Restore RSM . . . . . . . . . . . . . 508 Restore Sysfiles . . . . . . . . . . . . . 510 Restore Systemobject . . . . . . . . . . . 511 Restore Systemservices . . . . . . . . . . 512 Restore Systemstate . . . . . . . . . . . 514 Restore Sysvol . . . . . . . . . . . . . 515 Restore WAS . . . . . . . . . . . . . 516 Restore WMI . . . . . . . . . . . . . 519 Retrieve . . . . . . . . . . . . . . . 520 Schedule . . . . . . . . . . . . . . . 524 Selective . . . . . . . . . . . . . . . 526 Set Access . . . . . . . . . . . . . . 530 Set Password . . . . . . . . . . . . . 533 Set Waspassword . . . . . . . . . . . . 534

Appendix A. Using the Tivoli Storage Manager central scheduler . . . . . 537 Overview of the Tivoli Storage Manager scheduler 537

Handling spaces in file names in schedule definitions . . . . . . . . . . . . . 538 Preferential start times for certain nodes . . . 538

Understanding scheduler processing options . . . 539 Handling return codes from preschedulecmd and postschedulecmd scripts . . . . . . . 540

Using the client acceptor to manage scheduler services versus the traditional scheduler services . 541 Setting the client scheduler process to run as a background task and start automatically at boot time . . . . . . . . . . . . . . . . 541 Managing multiple schedule requirements on one machine . . . . . . . . . . . . . . . 543 Scheduled backups of Windows network drives 544 Managing different scheduling requirements for Windows system objects . . . . . . . . . . 544 Restarting the scheduler process on a remote machine . . . . . . . . . . . . . . . 544 Using the scheduler on clustered systems . . . . 545 Using the scheduler through a firewall . . . . . 546 Troubleshooting the Tivoli Storage Manager scheduler . . . . . . . . . . . . . . . 546

Investigating abnormal scheduled events . . . 547 Checking the server activity log . . . . . . 547 Inspecting the Client Schedule Log . . . . . 547

Appendix B. Using the Client Service Configuration Utility . . . . . . . . 549 Installing the backup-archive scheduler service . . 549

Using the Client Service Configuration Utility 549 Setting up a schedule to back up system objects (Windows 2000, Windows XP) . . . . . . . 552

Using the Dsmcutil command . . . . . . . . 553 Dsmcutil commands . . . . . . . . . . 553 Dsmcutil options . . . . . . . . . . . 560

Appendix C. Journal service configuration . . . . . . . . . . . 565 JournalSettings stanza . . . . . . . . . . 566 JournalExcludeList stanza . . . . . . . . . 567 JournaledFileSystemSettings stanza . . . . . . 568 PreserveDbOnExit setting . . . . . . . . . 569 deferFSMonStart setting . . . . . . . . . . 570 deferRetryInterval setting . . . . . . . . . 570 logFSErrors setting . . . . . . . . . . . 570 Overriding stanzas . . . . . . . . . . . 571

Appendix D. Configuring the backup-archive client in a cluster server environment . . . . . . . . . 573 Installing the backup-archive client on the cluster nodes . . . . . . . . . . . . . . . . 573 Configuring the backup-archive client to process local nodes . . . . . . . . . . . . . . 573 Configuring the backup-archive client to process cluster disk resources . . . . . . . . . . . 574

Contents vii

||

||

Step 1: Identify the cluster groups to manage 574 Step 2: Configure the client options file . . . . 574 Step 3: Configure the scheduler service . . . . 576 Step 4: Creating a generic service resource for failover . . . . . . . . . . . . . . 576

Configuring the Web client in a cluster environment . . . . . . . . . . . . . . 578

Configuring the Web client to process cluster disk resources . . . . . . . . . . . . 578

Frequently asked questions . . . . . . . . . 583

Appendix E. ASR supplemental information . . . . . . . . . . . . 587

ASR questions and answers . . . . . . . . 587 ASR diagnostic tips . . . . . . . . . . . 590 ASR in depth . . . . . . . . . . . . . 591

ASR information in the Windows Registry . . 594 Reference information . . . . . . . . . . 594

Notices . . . . . . . . . . . . . . 597 Trademarks . . . . . . . . . . . . . . 599

Glossary . . . . . . . . . . . . . 601

Index . . . . . . . . . . . . . . . 613

viii IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

Tables

1. Typographical conventions . . . . . . . xii 2. IBM Tivoli Storage Manager client and server

publications . . . . . . . . . . . . xiv 3. Optimized option default values . . . . . xxi 4. Tivoli Storage Manager server Quick Start

publications . . . . . . . . . . . . 11 5. Tivoli Storage Manager Quick Start

publications . . . . . . . . . . . . 23 6. GUID commands . . . . . . . . . . 26 7. Option for excluding directories . . . . . . 29 8. Options for controlling backup, archive, image,

system object, system services, and system state processing . . . . . . . . . . . 29

9. Options for controlling compression, encryption, and adaptive subfile backup processing . . . . . . . . . . . . . 31

10. Wildcard and other special characters . . . . 33 11. Specifying a drive specification using

wildcards . . . . . . . . . . . . . 34 12. Using wildcard characters with include and

exclude patterns . . . . . . . . . . . 34 13. Using UNC names with include and exclude

patterns . . . . . . . . . . . . . . 37 14. Working with your files using the Tivoli

Storage Manager GUI . . . . . . . . . 47 15. Backup: Primary tasks . . . . . . . . . 51 16. Planning your backups . . . . . . . . . 51 17. Maximum file size . . . . . . . . . . 57 18. Command line backup examples . . . . . 66 19. Comparing incremental image backup

methods . . . . . . . . . . . . . 76 20. NAS options and commands . . . . . . . 80 21. Client command line informational messages 82 22. UNC examples . . . . . . . . . . . 87 23. Restore: Primary tasks . . . . . . . . . 91 24. Command line restore examples . . . . . 94 25. NAS options and commands . . . . . . 115 26. Archive and retrieve: Primary tasks . . . . 121 27. Command line archive examples . . . . . 123 28. Command line examples of retrieving

archives . . . . . . . . . . . . . 126 29. Return codes and their meanings . . . . . 131 30. Default values in the standard management

class . . . . . . . . . . . . . . 141 31. TCP/IP options . . . . . . . . . . . 150 32. Named Pipes communication option 150 33. Node Options . . . . . . . . . . . 151 34. Backup and archive processing options 151 35. Restore and retrieve processing options 159 36. Scheduling options . . . . . . . . . . 162 37. Format and language options . . . . . . 163 38. Command processing options . . . . . . 164 39. Authorization options . . . . . . . . . 164 40. Error processing options . . . . . . . . 165 41. Transaction processing options . . . . . . 165 42. Web client options . . . . . . . . . . 166

43. Diagnostics options . . . . . . . . . 166 44. Client command options . . . . . . . . 168 45. Options that are valid on the initial command

line only . . . . . . . . . . . . . 174 46. System services components and

corresponding keywords . . . . . . . . 226 47. Entering commands . . . . . . . . . 373 48. Commands . . . . . . . . . . . . 373 49. Wildcard characters . . . . . . . . . 382 50. Archive command: Related options . . . . 384 51. Backup Group command: Related options 394 52. Backup Image command: Related options 399 53. Backup NAS command: Related options 402 54. System services components and

corresponding keywords . . . . . . . . 408 55. Backup WAS command: Related options 412 56. Delete Archive command: Related options 418 57. Delete Backup command: Related options 420 58. Delete Filespace command: Related options 424 59. Delete Group command: Related options 425 60. Expire command: Related options . . . . . 427 61. Incremental command: Related options 435 62. Query Activedirectory command: Related

options . . . . . . . . . . . . . 443 63. Query Archive command: Related options 444 64. Query ASR command: Related options 446 65. Query Backup command: Related options 447 66. Query Backupset command: Related options 450 67. Query Certserverdb command: Related

options . . . . . . . . . . . . . 451 68. Query Clusterdb command: Related options 452 69. Query Complusdb command: Related options 453 70. Query Eventlog command: Related options 455 71. Query Filespace command: Related options 456 72. Query FRS command: Related options 458 73. Query Group command: Related options 459 74. Query Image command: Related options 461 75. Query Mgmtclass command: Related options 464 76. Query Node command: Related options 465 77. Query Options command: Related options 466 78. Query Registry command: Related options 467 79. Query RSM command: Related options 469 80. Query Sysfiles command: Related options 472 81. Query Systeminfo command: Related options 474 82. Query Systemobject command: Related

options . . . . . . . . . . . . . 475 83. Query Systemservices command: Related

options . . . . . . . . . . . . . 476 84. Query Systemstate command: Related options 477 85. Query Sysvol command: Related options 478 86. Query WAS command: Related options 479 87. Query WMI command: Related options 480 88. Restore command: Related options . . . . 485 89. Restore Activedirectory command: Related

options . . . . . . . . . . . . . 488 90. Restore ASR command: Related options 489

Copyright IBM Corp. 1993, 2004 ix

||

| |

| |

91. Restore Backupset command: Related options 491 92. Restore Certserverdb command: Related

options . . . . . . . . . . . . . 494 93. Restore Clusterdb command: Related options 495 94. Restore Complusdb command: Related

options . . . . . . . . . . . . . 496 95. Restore Eventlog command: Related options 497 96. Restore FRS command: Related options 498 97. Restore Group command: Related options 499 98. Restore Image command: Related options 502 99. Restore NAS command: Related options 505 100. Restore Registry command: Related options 507 101. Restore RSM command: Related options 508 102. Restore Sysfiles command: Related options 510 103. Restore Systemobject command: Related

options . . . . . . . . . . . . . . 511

104. System services components and corresponding keywords . . . . . . . . 512

105. Restore Systemservices command: Related options . . . . . . . . . . . . . 512

106. Restore Systemstate command: Related options . . . . . . . . . . . . . 514

107. Restore Sysvol command: Related options 515 108. Restore WAS command: Related options 517 109. Restore WMI command: Related options 519 110. Retrieve command: Related options . . . . 521 111. Schedule command: Related options . . . . 524 112. Selective command: Related options . . . . 528 113. Scheduled client event status codes . . . . 546

x IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

About this book

IBM Tivoli Storage Manager is a client-server licensed product that provides storage management services in a multi-platform computer environment. The backup-archive client program permits users to back up and archive files from their workstations or file servers to storage, and restore and retrieve backup versions and archived copies of files to their local workstations.

In addition to the backup-archive client, Tivoli Storage Manager includes the following components available on a variety of platforms: v A server program that permits systems to perform as a backup and archive server

for distributed workstations and file servers. See Related publications on page xiv for available server publications.

v An administrative client program that you can access from a Web browser or the command line. The program permits a Tivoli Storage Manager administrator to control and monitor server activities, define storage management policies for backup, archive and space management services, and set up schedules to perform those services at regular intervals. For more information about the Administrative client, see Related publications on page xiv for available Tivoli Storage Manager Administrators Reference publications.

v An application program interface (API) that permits you to enhance an existing application with storage management services. When an application is registered with a server as a client node, the application can back up, restore, archive, and retrieve objects from storage. For more information about the Tivoli Storage Manager API, see IBM Tivoli Storage Manager Using the Application Programming Interface, GC32-0793.

v On Windows platforms, an ODBC driver is available that allows you to use a relational database product such as Lotus Approach to query the database and display the results. Please refer to the README.ODBC.TXT file for installation instructions. This file is available in the Tivoli Storage Manager ODBC Driver install package. Also see IBM Tivoli Storage Manager for Windows Administrators Guide, GC32-0782.

v A Web backup-archive client that permits an authorized administrator, help desk person, or end user to perform backup, restore, archive, and retrieve services using a Web browser on a remote machine. See Starting a Web client session on page 44 for more information.

Who should read this manual This manual provides instructions for an end-user to install, configure, and use the Tivoli Storage Manager client. For installation information and supported operating system levels, see Chapter 1, Installing Tivoli Storage Manager, on page 1. For configuration information, see Chapter 2, Configuring Tivoli Storage Manager, on page 13.

This manual assumes that you are familiar with your workstation, your operating system, and your basic system administration.

Unless otherwise specified, references to Windows refer to all supported Windows operating systems.

Copyright IBM Corp. 1993, 2004 xi

IBM Tivoli Storage Manager Web site Technical support information and publications are available at the following address: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

By accessing the Tivoli Storage Manager home page, you can access subjects that interest you. You can also access current Tivoli Storage Manager product information.

The Tivoli Storage Manager home page Self help section provides customers with a knowledge base of articles and information on issues with Tivoli Storage Manager that they might be experiencing.

Conventions used in this book This book uses the following typographical conventions:

Table 1. Typographical conventions

Example Description

dsmc.nlm A series of lowercase letters with an extension indicates Tivoli Storage Manager program file names.

archive Boldface type indicates a command that you type at a workstation, such as a command you type on a command line.

dateformat Boldface italic type indicates a Tivoli Storage Manager option. The bold type is used to introduce the option, or used in an example.

Occasionally, file names are entered in boldface italic for emphasis.

filespec Italicized type indicates either the name of a parameter, a new term, or a placeholder for information that you provide.

Italics are also used for emphasis in the text.

maxcmdretries Monospaced type represents fragments of a program or information as it would display on a screen.

plus sign (+) A plus sign between two keys indicates you should press both keys at the same time.

Reading syntax diagrams This section describes how to read the syntax diagrams used in this manual. To read a syntax diagram, follow the path of the line. Read from left to right, and top to bottom. v The symbol indicates the beginning of a syntax diagram. v The symbol at the end of a line indicates the syntax diagram continues on

the next line. v The symbol at the beginning of a line indicates a syntax diagram continues

from the previous line. v The symbol indicates the end of a syntax diagram.

Syntax items, such as a keyword or variable, can be: v On the line (required element)

xii IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

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

v Above the line (default element) v Below the line (optional element).

Syntax diagram description Example

Abbreviations:

Uppercase letters denote the shortest acceptable truncation. If an item appears entirely in uppercase letters, it cannot be truncated.

You can type the item in any combination of uppercase or lowercase letters.

In this example, you can enter KEYWO, KEYWORD, or KEYWOrd.

KEYWOrd

Symbols:

Enter these symbols exactly as they appear in the syntax diagram.

* Asterisk { } Braces : Colon , Comma = Equal Sign - Hyphen () Parentheses . Period

Space

Variables:

Italicized lowercase items (var_name) denote variables.

In this example, you can specify a var_name when you enter the KEYWORD command.

KEYWOrd var_name

Repetition:

An arrow returning to the left means you can repeat the item.

A character or space within the arrow means you must separate repeated items with that character or space.

A footnote by the arrow references the number of times you can repeat the item.

repeat

,

repeat

(1)

repeat

Notes:

1 Specify repeat as many as 5 times.

Required choices:

When two or more items are in a stack and one of them is on the line, you must specify one item.

In this example, you must choose A, B, or C.

A B

C

About this book xiii

Syntax diagram description Example

Optional choice:

When an item is below the line, that item is optional. In the first example, you can choose A or nothing at all.

When two or more items are in a stack below the line, all of them are optional. In the second example, you can choose A, B, C, or nothing at all.

A

A

B

C

Defaults:

Defaults are above the line. The default is selected unless you override it. You can override the default by including an option from the stack below the line.

In this example, A is the default. You can override A by choosing B or C. You can also specify the default explicitly.

A

B

C

Repeatable choices:

A stack of items followed by an arrow returning to the left means you can select more than one item or, in some cases, repeat a single item.

In this example, you can choose any combination of A, B, or C.

A

B

C

Syntax fragments:

Some diagrams, because of their length, must fragment the syntax. The fragment name appears between vertical bars in the diagram. The expanded fragment appears between vertical bars in the diagram after a heading with the same fragment name.

The fragment name

The fragment name:

A

B

C

Related publications Table 2 lists the IBM Tivoli Storage Manager client and server publications that are referred to in this manual.

Table 2. IBM Tivoli Storage Manager client and server publications

Publication title Order number

Client publications

IBM Tivoli Storage Manager Messages GC32-0767

IBM Tivoli Storage Manager for NetWare Backup-Archive Clients Installation and Users Guide GC32-0786

IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Installation and Users Guide Users Guide

GC32-0789

IBM Tivoli Storage Manager for Macintosh Backup-Archive Clients Installation and Users Guide GC32-0787

IBM Tivoli Storage Manager Using the Application Programming Interface GC32-0793

xiv IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

Table 2. IBM Tivoli Storage Manager client and server publications (continued)

Publication title Order number

Deploying the Tivoli Storage Manager Client in a Windows 2000 Environment SG24-6141

IBM Tivoli Storage Manager for Application Servers 5.2: Data Protection for WebSphere Application Server Installation and Users Guide

SC32-9075

Server publications

IBM Tivoli Storage Manager for AIX Quick Start GC32-0770

IBM Tivoli Storage Manager for AIX Administrators Guide GC32-0768

IBM Tivoli Storage Manager for HP-UX Quick Start GC32-0774

IBM Tivoli Storage Manager for Linux Quick Start GC23-4692

IBM Tivoli Storage Manager for z/OS Quick Start GC32-0777

IBM Tivoli Storage Manager for OS/400 PASE Quick Start GC23-4696

IBM Tivoli Storage Manager for Sun Solaris Quick Start GC32-0780

IBM Tivoli Storage Manager for Sun Solaris Administrators Guide GC32-0778

IBM Tivoli Storage Manager for Windows Quick Start GC32-0784

IBM Tivoli Storage Manager for Windows Administrators Reference GC32-0783

IBM Tivoli Storage Manager for Windows Administrators Guide GC32-0782

IBM Tivoli Storage Manager for Windows Storage Agent Users Guide GC32-0785

Downloading or ordering publications All Tivoli publications are available for electronic download or order from the IBM Publications Center: http://www.ibm.com/shop/publications/order/.

The Tivoli Storage Manager publications are available on the following CD-ROM:

Tivoli Storage Manager Publications Version 5.3, SK3T-8176

The format of the publications is PDF and HTML.

If you have questions or comments regarding Tivoli publications and product documentation, please visit http://www.ibm.com/software/tivoli/contact.html to send an e-mail.

The International Technical Support Center (ITSC) publishes Redbooks, which are books on specialized topics such as using Tivoli Storage Manager to back up databases. You can order publications through your IBM representative or the IBM branch office serving your locality. You can also search for and order books of interest to you at the IBM Redbooks Web site at this address: http://www.ibm.com/redbooks/

Tivoli Field Guides are designed to address specific technical scenarios or concepts that are often complex to implement or difficult to understand. All completed field guides are available free to registered customers and internal IBM employees at the following Web site: http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html

About this book xv

http://www.ibm.com/shop/publications/order/http://www.ibm.com/software/tivoli/contact.htmlhttp://www.ibm.com/redbooks/http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html

Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface.

Contacting customer support For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: v Visit the Tivoli Storage Manager technical support Web site at:

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

v Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. You can access the IBMLINK from the IBM Web site at: http://www.ibm.com/ibmlink/

v Submit a problem management record (PMR) electronically from the IBM Web site at: http://www.ibm.com/software/support/probsub.html.

Customers in the United States can also call 1-800-IBM-SERV (1-800-426-7378).

International customers should consult the Web site for customer support telephone numbers.

You can also review the IBM Software Support Guide, which is available on our Web site at http://techsupport.services.ibm.com/guides/handbook.html.

When you contact IBM Software Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information is needed to register for online support available on the Web site.

The support Web site offers extensive information, including a guide to support services (IBM Software Support Guide); frequently asked questions (FAQs); and documentation for all IBM Software products, including Release Notes, Redbooks, and white papers, defects (APARs), and solutions. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases.

Go to the following Web site for the Tivoli Storage Manager home page: http://www.ibm.com/software/tivoli/products/storage-mgr/

We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please complete our customer feedback survey at: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

by selecting the Feedback link in the left navigation bar.

Reporting a problem Please have the following information ready when you report a problem:

xvi IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

|

|||||

||

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.htmlhttp://www.ibm.com/ibmlink/http://www.ibm.com/software/support/probsub.htmlhttp://techsupport.services.ibm.com/guides/handbook.htmlhttp://www.ibm.com/software/tivoli/products/storage-mgr/http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html

v The Tivoli Storage Manager server version, release, modification, and service level number. You can get this information by entering the query status command at the Tivoli Storage Manager command line.

v It is recommended that you use the Tivoli Storage Manager client query systeminfo command with the filename option to gather Tivoli Storage Manager system information and output this information to a file. This information is intended primarily as an aid for IBM support to assist in diagnosing problems.

v The Tivoli Storage Manager client version, release, modification, and service level number. You can get this information by entering dsmc at the command line.

v The communication protocol (for example, TCP/IP), version, and release number you are using.

v The activity you were doing when the problem occurred, listing the steps you followed before the problem occurred.

v The exact text of any error messages.

Internet You can find client and server interim fixes, device support, and maintenance updates for current and previous versions of Tivoli Storage Manager through the anonymous FTP server, ftp://ftp.software.ibm.com. IBM Tivoli Storage Manager information is in the /storage/tivoli-storage-management directory.

A newsgroup, listserv@marist.edu, is implemented by a third party. IBM supports this newsgroup on a best-effort basis only. See Online forum on page 48 for more information.

About this book xvii

ftp://ftp.software.ibm.com

xviii IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

Summary of changes for Tivoli Storage Manager

This section summarizes changes made to the Tivoli Storage Manager product and this publication. Technical changes to the text are indicated by vertical lines to the left of the change.

Technical changes for Version 5.3 - December 2004 The following changes have been made to the product for this edition:

New links from the backup-archive client GUI to the Tivoli Storage Manager and Tivoli Home Pages

From the backup-archive client GUI and web client, you can now directly access the IBM Tivoli Storage Manager web site, the IBM Tivoli web site, the IBM Tivoli Storage Manager Support web site, and the Tivoli Storage Manager Publications web site (publib).

From the backup-archive command line interface help menu screen, the web site address is displayed. You can enter the web site address in a browser to access the IBM Tivoli Storage Manager Support web site for technical support on Tivoli Storage Manager.

New options, Errorlogmax and Schedlogmax, and DSM_LOG environment variable changes

Errorlogmax and Schedlogmax are new options for controlling log size. Errorlogmax specifies the maximum size for the error log, in megabytes. Schedlogmax specifies the maximum size for the scheduler log, in megabytes. See Chapter 9, Using processing options, on page 149 for more information.

DSM_LOG environment variable changes have been made to prevent a security or data integrity problem. Logs will no longer be created in the installation directory. In addition, if the client is unable to open a required log for writing, the client process will terminate. The Tivoli Storage Manager command line client, the web client acceptor and agent will not run without a writeable dsmerror.log. See Chapter 2, Configuring Tivoli Storage Manager, on page 13, Chapter 9, Using processing options, on page 149, and Chapter 10, Using commands, on page 373 for more information.

Enhanced encryption Tivoli Storage Manager now supports AES (Advanced Encryption Standard) 128-bit data encryption to encrypt data during backup and archive operations using the include.encryption option.

Journal based backup enhancements Multiple journal based backup sessions are now possible. See Chapter 4, Backing up your data, on page 51 and Chapter 10, Using commands, on page 373 for more information.

Include-exclude enhancements A preview function shows the objects to be backed up or archived according to the include-exclude list, prior to sending any data to the server.

The Tivoli Storage Manager Client GUI directory tree shows detailed information of included and excluded objects.

Copyright IBM Corp. 1993, 2004 xix

|

|

||||||

||||

|||||||

|||||||||

||||

||||

||||

||

The Client Configuration Wizard and the directory tree in the Tivoli Storage Manager Client GUI allow you to select files and directories to include or exclude.

See Chapter 2, Configuring Tivoli Storage Manager, on page 13, Chapter 4, Backing up your data, on page 51, Chapter 6, Archiving and retrieving your data, on page 121, and Chapter 10, Using commands, on page 373 for more information.

Enhancements to query schedule command

To more accurately determine the status of scheduled events, the query schedule command on a Tivoli Storage Manager Version 5.3 and above client reports new parameters. See Chapter 7, Automating tasks, on page 129 and Chapter 10, Using commands, on page 373 for more information about these enhancements. Also see the Administrators Guide and Administrators Reference for your operating system.

Dynamic client tracing A new command line utility, dsmtrace, is available to enable tracing, disable tracing, or change trace flags while the client is running. See the Problem Determination Guide for information about using this utility.

Note: Tracing is an advanced diagnostic feature intended for use only at the recommendation of IBM support and development, or as outlined in the Problem Determination Guide.

Tivoli Storage Manager Administration Center The hyperlink from the new Java based Tivoli Storage Manager Administration Center to a Tivoli Storage Manager client machine provides the administrator ID and encrypted password to the web client through a Java portlet. This enables the launching of the web client GUI without the administrator signing on again. The Tivoli Storage Manager Version 5.3 or higher web client is required for this support. See Configuring the Web client on page 17 and the IBM Tivoli Storage Manager Administrators Guide for your operating system, for more information.

Web client enhancements You can now perform the following functions from the Web client: v Find files in the backup, restore, archive or retrieve window. v Back up, restore, archive, or retrieve your files by filtering file names or

filtering the directory tree. v Restore your data from backup sets without a server connection.

Support for deleting individual backups from a server file space If your administrator has given you authority, you can delete individual backup copies from the Tivoli Storage Manager server without deleting the entire file space. This may be useful in the following situations: v You need to delete sensitive files which were mistakenly backed up. v You need to delete a subset of backup files which were inadvertently

backed up. v You need to delete files that are found to contain viruses.See Deleting backup data on page 68 for more information.

Single drive support for Open File Support (OFS) or online image backups You can now perform OFS or online image backups on machines with a single NTFS-based C: drive. You can also easily verify if the LVSA is functioning properly or find the root cause of any failure by checking the Windows event log, without turning on any trace facilities. See Chapter 9,

xx IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

|||

||||

|

||||||

||||

|||

|||||||||

||

|

||

|

||||||||

|

|||||

Using processing options, on page 149 and Chapter 10, Using commands, on page 373 for more information.

Optimized option default values

Table 3. Optimized option default values

Option Change Page

diskbuffsize Allows you to specify I/O buffer size (in kilobytes) that the client may use to optimize backup, archive, or HSM client performance.

Recommendation: Use the default value instead of specifying the diskbuffsize option.

206

largecommbuffers This option has been replaced by the diskbuffsize option. At this time, largecommbuffers will continue to be accepted by the Tivoli Storage Manager client in order to ease the transition to the new option. However, the value specified by largecommbuffers will be ignored in favor of the diskbuffsize setting.

Recommendation: Discontinue the use of largecommbuffers because future releases of Tivoli Storage Manager might not accept this option.

206

tcpadminport Specifies a separate TCP/IP port number on which the server is waiting for requests for administrative client sessions, allowing secure administrative sessions within a private network. If this option is not specified, the default value is the value of the tcpport option.

342

tcpbuffsize The default value was changed from 31 kilobytes to 32 kilobytes.

343

Summary of changes for Tivoli Storage Manager xxi

||

|

||

|||

||||||

||||

|

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

||||||

|

|||||||||||

|

||||

|

Table 3. Optimized option default values (continued)

Option Change Page

tcpnodelay The default value was changed from no to yes. tcpnodelay yes disables the TCP/IP Nagle algortihm. This algorithm is used to reduce the number of small segments sent across the network, but in some environments this might negatively impact Tivoli Storage Manager performance.

Recommendation: Use the default of yes, unless you fully understand the effects of the TCP Nagle algorithm on network transmissions and how its use affects the performance of Tivoli Storage Manager in your environment.

346

tcpwindowsize The default value was changed from 32 kilobytes to 63 kilobytes.

349

txnbytelimit The default value was changed from 2048 kilobytes to 25600 kilobytes.

356

Technical changes for Version 5.2.2 - December 2003 The following changes have been made to the product for this edition:

Support for Veritas Cluster Server cluster environment You can install the Tivoli Storage Manager backup-archive client and scheduler service on Veritas Cluster Server cluster nodes to back up and restore shared volumes in a Veritas Cluster Server cluster environment. See Appendix D, Configuring the backup-archive client in a cluster server environment, on page 573 for more information.

Backup and restore support for IBM TotalStorage SAN File Systems Backup and restore for IBM TotalStorage SAN File Systems is supported on the Windows 2000 client. See Supported file systems on page 57 for more information.

Support for WebSphere Application Server (WAS) security If WAS security is enabled, user name and password validation for Data Protection for WebSphere Application Server is required. If you do not set the WAS password for the security, the backup will failover to an offline backup. It is recommended to set the WAS security password to perform consistent backups. Use the set waspassword command to set the user name and password for each installation of WAS on your machine. You only need to perform this task once, unless you change your WAS user

xxii IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

|

|||

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

|||||||||

|

||||

|

||||

|

|

|

name or password. You can only perform this task on the Tivoli Storage Manager command line. See Set Waspassword on page 534 for more information.

Multi-session backup session enhancements Use the collocatebyfilespec option to specify whether the Tivoli Storage Manager client uses only one server session to send objects generated from one file specification. Setting the collocatebyfilespec option to yes eliminates interspersing of files from different file specifications, by limiting the client to one server session per file specification. Therefore, if you store the data to tape, files for each file specification are stored together on one tape (unless another tape is required for more capacity). See Collocatebyfilespec on page 187 for more information.

Language support expanded to include Russian, Hungarian, Polish, and Czech Tivoli Storage Manager client language packs are available in Russian, Hungarian, Polish, and Czech language locales. See Language on page 260 for more information.

Technical changes for Version 5.2 - April 2003 The following changes have been made to the product for this edition:

Support for backing up files from one or more file space origins You can use the Tivoli Storage Manager command line client to create and back up a group containing a list of files from one or more file space origins to a virtual file space on the Tivoli Storage Manager server. A group backup allows you to create a point-in-time backup of a group of files that is managed as a single logical entity. See Group backup: Backing up files from one or more file spaces on page 69 for more information.

Open file support for backup and archive operations on Windows 2000 and Windows XP

If the Logical Volume Snapshot Agent (LVSA) is installed and configured for open file support via the setup wizard, by default, Tivoli Storage Manager performs a snapshot backup or archive of files that are open (or locked) by other applications. The snapshot allows the backup or archive to be taken from a point-in-time copy that matches the file system at the time the snapshot is taken. Subsequent changes to the file system are not included in the backup or archive operation. You can use the include.fs option to specify whether a drive uses open file support. See Open file support for backup operations on page 62 and Open file support for archive operations (Windows 2000, XP) on page 122 for more information.

Network Data Management Protocol (NDMP) file-level restore NDMP support is enhanced to allow you to restore individual files from your Network Attached Storage (NAS) file system image backups. Use the toc option with the include.fs.nas option in your client options file (dsm.opt) to specify whether Tivoli Storage Manager saves Table of Contents (TOC) information during a NAS file system image backup. If you save TOC information, you can use the Web client or the Tivoli Storage Manager server restore node command to restore individual files or directory trees from the NAS file system image that you specify. See Toc on page 352 for more information.

NDMP support is available only on IBM Tivoli Storage Manager Extended Edition.

Summary of changes for Tivoli Storage Manager xxiii

Support for processing EMC Celerra NAS file system images Through support of NDMP, Tivoli Storage Manager Windows, AIX, and Solaris servers can efficiently back up and restore NAS file system images to tape drives or libraries that are locally attached to Network Appliance and EMC Celerra NAS file servers. NDMP support is available only on IBM Tivoli Storage Manager Extended Edition. See NDMP support requirements (Extended Edition only) on page 4 for NDMP support requirements. See Backing up NAS file systems on page 77 for information on how to back up and restore NAS file system images using the Web client and command line client.

Support for backup and restore of the WebSphere Application Server If you installed the Data Protection for WebSphere Application Server, you can use Tivoli Storage Manager to back up the Version 5.0 WebSphere Application Server Network Deployment Manager (contains setup, application files, and configuration information) or the Application Server to the Tivoli Storage Manager server. You can restore this information from the Tivoli Storage Manager server and use it to recover a corrupted node application or an entire node (or nodes) in the event of an accident or disaster.

Data Protection for WebSphere Application Server is a separately priced and licensed product. Data Protection for WebSphere Application Server is only supported on a Tivoli Storage Manager Version 5.2 server and client. Data Protection for WebSphere Application Server is supported on Windows 2000 Server and Advanced Server.

See Backing up the WebSphere Application Server (WAS) on page 82 for more information.

Enhancements for command line image restore operations You can use the verifyimage option with the restore image command to specify that you want to enable detection of bad sectors on the destination target volume. If bad sectors are detected on the target volume, Tivoli Storage Manager issues a warning message on the console and in the error log. See Verifyimage on page 361 for more information.

If bad sectors are present on the target volume, you can use the imagetofile option with the restore image command to specify that you want to restore the source image to a file. Later, you can use a dd utility (available on Unix) or its equivalent to copy data from this file to a logical volume. See Imagetofile on page 243 for more information.

Support for an external snapshot provider in the backup-archive clients Use the snapshotroot option with the incremental, selective, or archive commands in conjunction with a third-party application that provides a snapshot of a logical volume, to associate the data on the local snapshot with the real file space data that is stored on the Tivoli Storage Manager server. The snapshotroot option does not provide any facilities to take a volume snapshot, only to manage data created by a volume snapshot. See Snapshotroot on page 332 for more information.

Enhancements to the Web client interface The following functions are now supported in the Tivoli Storage Manager Web client interface: Access Another Node

Displays the backup versions and archive copies of another node. You can then restore the backup versions or retrieve the archives

xxiv IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

from the other user to your workstation. You must have authorization to access the stored data of another node.

Node Access List Allows you to authorize other users to access your backup versions and archive copies.

View Policy Information Displays storage management policy information for your node.

Enhanced firewall security Security for back up and restore operations and Tivoli Storage Manager administrative functions is enhanced to allow the Tivoli Storage Manager server to control whether the server or client initiates sessions through a firewall. See Sessioninitiation on page 321 for more information.

Both the server and client can also specify a separate TCP/IP port number on which the server is waiting for requests for administrative client sessions, allowing secure administrative sessions within a private network. See Tcpadminport on page 342 for more information.

Support for Microsoft Volume Shadowcopy Service (VSS) on Windows Server 2003 Tivoli Storage Manager supports the Microsoft Volume Shadowcopy

Service (VSS) on Windows Server 2003. Tivoli Storage Manager uses VSS to back up all Windows Server 2003 system state components as a single object, to provide a consistent point-in-time snapshot of the system state. System services components can be backed up individually. See Backing up Windows Server 2003 system state and system services on page 70 for more information.

Support for Microsoft Automated System Recovery (ASR) on Windows Server 2003 and Windows XP

Microsoft Automated System Recovery (ASR) is a restore feature of Windows XP Professional and Windows Server 2003 that provides a framework for saving and recovering the Windows XP or Windows Server 2003 operating state, in the event of a catastrophic system or hardware failure. Tivoli Storage Manager supports the bare metal restore by participating in the ASR restore framework. Tivoli Storage Manager creates the files required for ASR recovery and stores them on the Tivoli Storage Manager server. You can restore these files to a diskette for use during ASR recovery. See Backing up Automated System Recovery (ASR) files (Windows XP, Windows Server 2003) on page 72 for more information.

Support for displaying options and their settings via the command line Use the query options command to display all or part of your options and their current settings. This command accepts an argument to specify a subset of options. The default is to display all options. See Query Options on page 466 for more information.

Support for gathering Tivoli Storage Manager system information Use the query systeminfo command to gather information on one or more of the following items and output this information to a file name that you specify: v DSMOPTFILE - The contents of dsm.opt file. v ENV - Environment variables. v ERRORLOG - The Tivoli Storage Manager error log file. v FILE - Attributes for the file name that you specify. v INCLEXCL - Compiles a list of include-exclude in the order in which

they are processed during backup and archive operations.

Summary of changes for Tivoli Storage Manager xxv

v OPTIONS - Compiled options. v OSINFO - Name and version of the client operating system v POLICY - Policy set dump. v MSINFO - Windows system information (output from MSINFO32.EXE). v REGISTRY - Windows Tivoli Storage Manager-related registry entries. v SYSTEMOBJECT - Windows system object information. v CLUSTER - Windows cluster information.See Query Systeminfo on page 473 for more information.

Tivoli Storage Manager command line and GUI display actual image size stored on Tivoli Storage Manager server

Because image backup allows you to back up only used blocks in a file system, the stored image size on the Tivoli Storage Manager server could be smaller than the volume size. For online image backups, the stored image can be larger than the file system based on the size of the cache files. The Tivoli Storage Manager command line and GUI now display the actual image size stored on Tivoli Storage Manager server. See Query Image on page 461, Restore Image on page 501 and Restoring an image (Windows 2000, XP) on page 106 for more information.

Enhancements for the query filespace command The query filespace command is enhanced to allow you to query a single file space on the Tivoli Storage Manager server. See Query Filespace on page 456 for more information.

Separately installable language packs available Language packs are separately installable packages that contain only language-specific files (such as message catalog, resource file, help files, etc.). You can now install these additional language packs on top of your Tivoli Storage Manager client base install. To change your language preferences, specify the language option in your client options file (dsm.opt) or use the Preferences editor. See Language on page 260 for more information.

Technical changes for Version 5.1.5 - September 2002 The following changes have been made to the product for this edition:

New backup-archive option to preserve last access date of files For backup and archive operations, you can use the preservelastaccessdate option to specify whether the client should reset the last access dates of backed up or archived files to their original value. The default behavior is to not reset the last access date. See Preservelastaccessdate on page 293 for more information.

Enhanced domain processing Domain processing is enhanced to allow you to include and exclude items from the domain. Previous versions of Storage Manager only allowed you to include items in the domain. See Domain on page 207 for more information.

Support for excluding specific system objects from backup processing You can use the exclude.systemobject option in the client options file (dsm.opt) to exclude specific system objects from backup processing. See Exclude options on page 223 for more information.

xxvi IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and Users Guide

Ignore NTFS compression attribute During an incremental backup, if the only change to a file is the compression attribute, the client will send the attribute update to the Tivoli Storage Manager server without backing up the entire contents of the file. This enhancement does not apply to files residing on journaled file systems. See Full and partial incremental backup on page 58 for more information.

Enhanced image backup and restore processing (Windows 2000 only) If bad disk sectors are detected on the source drive during a LAN-free or LAN-based image backup, data corruption may occur. In this case, bad sectors are skipped when sending image data to the Tivoli Storage Manager server. If bad disk sectors are detected during the image backup, a warning message is issued after the image backup completes. See Performing an image backup on page 73 for more information.

Support for monitoring or canceling server-free operations (Windows 2000) You can use the following commands to monitor or cancel a server-free image backup or restore process:

monitor process Displays a list of current server-free image backup and restore processes for which the administrative user has authority. The administrative user can then select one process to monitor. See Monitor Process on page 439 for more information

cancel process Displays a list of current server-free image backup and restore processes for which the administrative user has authority. From the list, the administrative user can select one process to cancel. See Cancel Process on page 415 for more information.

Support for a globally unique identifier (GUID) The globally unique identifier (GUID) associates a client node with a host system. When you install the Tivoli software, the tivguid.exe program is run to generate a GUID which is stored in the Windows Registry on a Windows NT system. The GUID for a client node on the server can change if the host system machine is corrupted, if the Windows Registry entry is lost, or if a user uses the same node name from different host systems. You can perform the following functions from the command line: v Create a new GUID v View the current GUID v Write a specific value v Create another GUID even if one exists.See Associating your client node with a host system (optional) on page 26 for more information.

Support for DBCS installation path on Unicode-enabled clients You may install the following Tivoli Storage Manager services under a double-byte character set (DBCS) path on Windows NT, 2000, and XP Unicode-enabled clients: v Backup-Archive Scheduler Service v Client Acceptor Service (CAD) v Remote Client Agent Service v Journal Engine Service

Enhanced query backup and query archive commands If you use the detail option with the query archive or query backup commands, the client displays the following additional information:

Summary of changes for Tivoli Storage Manager xxvii

v Last modification date v Creation dateSee Query Archive on page 444 and Query Backup on page 447 for more information.

Technical changes for Version 5.1 - April 2002 The following changes have been made to the product for this edition:

Support for Cyclical Redundancy Checking (CRC) Tivoli Storage Manager supports cyclical redundancy checking (CRC) to verify that data is not being corrupted in transfer during a backup or restore session.

Support for processing Network Attached Storage (NAS) file system images Through support of Network Data Management Protocol (NDMP), Tivoli Storage Manager Windows NT, 2000, XP, AIX, and Solaris servers can efficiently back up and restore network attached storage (NAS) file system images to tape drives or libraries that are locally attached to the NAS file servers from Network Appliance. NDMP support is available only on IBM Tivoli Storage Manager Extended Edition. See NDMP support requirements (Extended Edition only) on page 4 for NDMP support requirements. See Backing up NAS file systems on page 77 for information on how to back up and restore NAS file system images using the Web client and command line client.

Support for logical volume backup as a single object (image backup) on Windows 2000 Client

The Windows 2000 client is enhanced to support a logical volume image backup of file systems and raw volumes. You can use the native GUI, the command line interface, and the Web client GUI to create an image of file systems and raw logical volumes on the Tivoli Storage Manager server. NTFS, FAT, and FAT32 file systems are supported. The Tivoli Storage Manager server does not track individual files in the file system image. File system images are tracked as individual objects and management class policy will be applied to the file system