Backup-archive clients documentation

IBM Tivoli Storage Manager for Windows Backup-ArchiveClientsVersion 7.1

Installation and User's Guide

Note:Before using this information and the product it supports, read the information in Notices on page 747.

First edition (December 2013)

This edition applies to version 7, release 1, modification 0 of IBM Tivoli Storage Manager (product numbers5608-E01, 5608-E02, and 5608-E03) and to all subsequent releases and modifications until otherwise indicated in neweditions.

Copyright IBM Corporation 1993, 2013.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsTables . . . . . . . . . . . . . . . xi

About this publication . . . . . . . . xiiiWho should read this publication. . . . . . . xiiiPublications . . . . . . . . . . . . . . xiii

Tivoli Storage Manager publications . . . . . xivConventions used in this publication . . . . . xviReading syntax diagrams . . . . . . . . . xvi

New for IBM Tivoli Storage ManagerVersion 7.1. . . . . . . . . . . . . xix

Chapter 1. Installing the Tivoli StorageManager backup-archive clients . . . . 1Upgrading the backup-archive client . . . . . . 1

Upgrade path for clients and servers . . . . . 1Considerations for migrating between processorarchitectures x32 and x64 . . . . . . . . . 1Additional upgrade information . . . . . . . 2Automatic backup-archive client deployment . . 3

Client environment requirements . . . . . . . 5Windows client environment requirements . . . 6

Windows client installable components . . . 6System requirements for Windows clients. . . 6Windows client communication methods . . . 6Backup-archive client features that are availableon Windows platforms . . . . . . . . . 7Windows supported file systems. . . . . . 7

NDMP support requirements (Extended Edition only) 8Installation requirements for backing up andarchiving Tivoli Storage Manager FastBack client data 8Client configuration wizard for Tivoli StorageManager FastBack . . . . . . . . . . . . 9Installing the Tivoli Storage Manager Windows client 9

Windows client installation might require a reboot 9Installation types . . . . . . . . . . . 10

Installing the Windows client for the first time 10Upgrading the Windows client . . . . . . 14Reinstalling the Windows client . . . . . 18Silent installation . . . . . . . . . . 18Modifying, repairing, or uninstalling theWindows client . . . . . . . . . . . 22

Troubleshooting problems during installation . . 24Software updates . . . . . . . . . . . 25

Chapter 2. Configure the Tivoli StorageManager client . . . . . . . . . . . 27Creating and modifying the client options file . . . 27Create a shared directory options file . . . . . . 29Creating multiple options files . . . . . . . . 29Environment variables. . . . . . . . . . . 30Configuring the web client . . . . . . . . . 31Configuring the client scheduler . . . . . . . 33Starting the client scheduler . . . . . . . . . 34

Scheduling events using the GUI . . . . . . 35Configuring Tivoli Storage Manager client/servercommunication across a firewall . . . . . . . 35Configuring Tivoli Storage Manager client/servercommunication with Secure Sockets Layer . . . . 38

Certificate Authorities root certificates . . . . 40Configure your system for journal-based backup . . 41

Configuring the journal engine service . . . . 41JournalSettings stanza (Windows) . . . . . 43JournalExcludeList stanza . . . . . . . 45JournaledFileSystemSettings stanza . . . . 45Overriding stanzas . . . . . . . . . . 49

Client-side data deduplication . . . . . . . . 49Configuring the client for data deduplication . . 53Excluding files from data deduplication . . . . 55

Automated client failover configuration and use . . 56Automated client failover overview . . . . . 56

Requirements for automated client failover . . 57Restrictions for automated client failover . . 57Failover capabilities of Tivoli Storage Managercomponents . . . . . . . . . . . . 58

Configuring the client for automated failover . . 59Determining the status of replicated client data 60Preventing automated client failover . . . . . 61Forcing the client to fail over . . . . . . . 61

Configuring the client to back up and archive TivoliStorage Manager FastBack data . . . . . . . . 62Configuring Tivoli Storage Manager to protectFastBack client data . . . . . . . . . . . 63Configuring the backup-archive client in a clusterserver environment . . . . . . . . . . . . 65

Protecting data in MSCS clusters (WindowsServer clients) . . . . . . . . . . . . 65

Configuring cluster protection (WindowsServer clients) . . . . . . . . . . . 66

Configure the Web client in a clusterenvironment . . . . . . . . . . . . . 67

Configure the Web client to process clusterdisk resources . . . . . . . . . . . 67

Frequently asked questions . . . . . . . . 73Configuring online-image backup support . . . . 76Configuring Open File Support . . . . . . . . 76Configuring NetApp and Tivoli Storage Managerfor snapshot difference incremental backups . . . 77

SnapMirror support for NetAppsnapshot-assisted progressive incremental backup(snapdiff) . . . . . . . . . . . . . . 78

Register your workstation with a server . . . . . 81Closed registration . . . . . . . . . . . 82Open registration . . . . . . . . . . . 82

Creating an include-exclude list . . . . . . . 82Include-exclude options . . . . . . . . . 84

Exclude file spaces and directories. . . . . 84Include-exclude statements for networked filesystems. . . . . . . . . . . . . . 85

Copyright IBM Corp. 1993, 2013 iii

Exclude files and directories from ajournal-based backup . . . . . . . . . 86Control processing with exclude statements . 86System files to exclude . . . . . . . . 87Exclude files with UNC names . . . . . . 88Include and exclude files that containwildcard characters . . . . . . . . . . 88Include and exclude groups of files withwildcard characters . . . . . . . . . . 89Examples using wildcards with include andexclude patterns . . . . . . . . . . . 90

Determine compression and encryptionprocessing . . . . . . . . . . . . . . 91Preview include-exclude list files . . . . . . 92Include and exclude option processing . . . . 93Processing rules when using UNC names . . . 95

Explicit use of UNC names for remote drives 95Conversion of DOS pathnames for fixed andremote drives. . . . . . . . . . . . 95Character-class matching examples . . . . 95

Chapter 3. Getting started . . . . . . 97Backup-archive client operations and security rights 97

Backup Operators group operations . . . . . 98Considerations before you start using a BackupOperators group account . . . . . . . . . 99

Permissions required to restore files that useadaptive subfile backup . . . . . . . . . . 100Permissions required to back up, archive, restore orretrieve files on cluster resources . . . . . . . 100Tivoli Storage Manager client authentication . . . 100User account control . . . . . . . . . . . 101

Enabling client access to network shares whenUAC is enabled . . . . . . . . . . . 101

Starting a Java GUI session . . . . . . . . . 102Tivoli Storage Manager password . . . . . 103Setup wizard . . . . . . . . . . . . 103

Starting a command-line session . . . . . . . 103Using batch mode . . . . . . . . . . . 103Issuing a series of commands by usinginteractive mode . . . . . . . . . . . 104Displaying Euro characters in a command-lineprompt . . . . . . . . . . . . . . 104Use options on the DSMC command . . . . 105

Specifying input strings that contain blank spacesor quotation marks . . . . . . . . . . . 105Starting a web client session . . . . . . . . 106

User privileges . . . . . . . . . . . . 107Start the client scheduler automatically . . . . . 107Changing your password . . . . . . . . . 107Sorting file lists using the Tivoli Storage ManagerGUI . . . . . . . . . . . . . . . . 109Displaying online help . . . . . . . . . . 110Ending a session . . . . . . . . . . . . 110Online forums . . . . . . . . . . . . . 111

Chapter 4. Backing up your data . . . 113Planning your backups (Windows) . . . . . . 113Which files are backed up . . . . . . . . . 114Open file support for backup operations . . . . 115

Backing up data using the GUI . . . . . . . 117Specifying drives in your domain. . . . . . 118

Backing up data using the command line . . . . 118Deleting backup data . . . . . . . . . . . 120When to back up and when to archive files . . . 121Pre-backup considerations (Windows) . . . . . 122

LAN-free data movement . . . . . . . . 122LAN-free prerequisites . . . . . . . . 122LAN-free data movement options . . . . 122

Unicode file spaces (Windows) . . . . . . 123Incremental backups on memory-constrainedsystems . . . . . . . . . . . . . . 123Incremental backups on systems with a largenumber of files . . . . . . . . . . . . 123Performing a backup with limited bandwidth 125Control processing with an include-exclude list 125Data encryption during backup or archiveoperations . . . . . . . . . . . . . 126Maximum file size for operations. . . . . . 127How Tivoli Storage Manager handles long userand group names . . . . . . . . . . . 127

Incremental, selective, or incremental-by-datebackups (Windows) . . . . . . . . . . . 127

Full and partial incremental backup . . . . . 128Journal-based backup. . . . . . . . . 129

Incremental-by-date backup . . . . . . . 131Comparing incremental-by-date, journal-based,and NetApp snapshot difference to fullincremental and partial incremental backups . . 132Snapshot differential backup with an HTTPSconnection . . . . . . . . . . . . . 134

Running a snapshot differential backup withan HTTPS connection . . . . . . . . 134

Selective backup . . . . . . . . . . . 135Backing up files from one or more file spaces for agroup backup (Windows) . . . . . . . . . 135Backing up data with client-node proxy support(Windows) . . . . . . . . . . . . . . 136

Enabling multiple node operations from theGUI . . . . . . . . . . . . . . . 137Setting up encryption . . . . . . . . . 137Scheduling backups with client-node proxysupport . . . . . . . . . . . . . . 138

Associate a local snapshot with a server file space(Windows) . . . . . . . . . . . . . . 139Backing up Windows system state . . . . . . 139Backing up Automated System Recovery files . . 141Preparation for Automated System Recovery . . . 142

Creating a Tivoli Storage Manager options filefor Automated System Recovery . . . . . . 142Backing up the boot drive and system drive forAutomated System Recovery . . . . . . . 143

Image backup . . . . . . . . . . . . . 144Performing prerequisite tasks before creating animage backup . . . . . . . . . . . . 145Utilizing image backups to perform file systemincremental backups . . . . . . . . . . 146

Method 1: Using image backups with filesystem incremental backups . . . . . . 146Method 2: Using image backups withincremental-by-date image backups . . . . 146

iv IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Comparing methods 1 and 2 . . . . . . 147Performing an image backup using the GUI . . 148Performing an image backup using thecommand line . . . . . . . . . . . . 149

Back up NAS file systems using Network DataManagement Protocol . . . . . . . . . . 149

Backing up NAS file systems with the webclient GUI using NDMP protocol . . . . . . 150Back up NAS file systems using the commandline. . . . . . . . . . . . . . . . 152Methods for backing up and recovering data onNAS file servers accessed by CIFS protocol . . 153

Support for CDP Persistent Storage Manager . . . 155Backing up VMware virtual machines . . . . . 155

Preparing the environment for full backups ofVMware virtual machines . . . . . . . . 158Creating full backups for VMware virtualmachines . . . . . . . . . . . . . . 160Preparing the environment for file-level backupsof VMware virtual machines . . . . . . . 162Creating file-level backups for VMware virtualmachines . . . . . . . . . . . . . . 164Parallel backups of VMware virtual machines 165

Back up virtual machines on a Windows Hyper-Vsystem . . . . . . . . . . . . . . . 169

Hyper-V backup support limitations. . . . . 171Back up and archive Tivoli Storage ManagerFastBack data . . . . . . . . . . . . . 172Backing up Net Appliance CIFS share definitions 172Display backup processing status. . . . . . . 173Backup (Windows): Additional considerations . . 175

Open files . . . . . . . . . . . . . 175Ambiguous file space names in filespecifications . . . . . . . . . . . . 176Management classes . . . . . . . . . . 177Deleted file systems . . . . . . . . . . 177Removable media backup . . . . . . . . 177Fixed drives . . . . . . . . . . . . . 178NTFS and ReFS file spaces . . . . . . . . 178Universal Naming Convention names . . . . 178

Examples: UNC names in domain lists . . . 179Examples: Universal Naming Conventionbackup . . . . . . . . . . . . . 179

Microsoft Dfs file protection methods . . . . 180

Chapter 5. Restoring your data . . . . 183Duplicate file names . . . . . . . . . . . 183Universal Naming Convention names restore. . . 184Active or inactive backup restore . . . . . . . 184Restoring files and directories . . . . . . . . 185

Restoring data using the GUI . . . . . . . 185Examples for restoring data using the commandline. . . . . . . . . . . . . . . . 185

Examples: Restoring large amounts of data 187Standard query restore, no-query restore, andrestartable restore . . . . . . . . . . 187

Plan for temporary space to restore migratedfiles . . . . . . . . . . . . . . . 189

Restoring Windows system state . . . . . . . 189Restoring Automated System Recovery files . . . 191

Restoring the operating system when the computeris working . . . . . . . . . . . . . . 191Recovering a computer when the Windows OS isnot working . . . . . . . . . . . . . . 191

Creating a bootable WinPE CD . . . . . . 191Restoring the Windows operating system withAutomated System Recovery . . . . . . . 192

Microsoft Dfs tree and file restore . . . . . . 192Restoring an image . . . . . . . . . . . 193

Restoring an image using the GUI . . . . . 194Restoring an image using the command line . . 195

Restore data from a backup set . . . . . . . 195Restore backup sets: considerations andrestrictions . . . . . . . . . . . . . 197Backup set restore . . . . . . . . . . . 198Restoring backup sets using the GUI . . . . 199Backup set restores using the clientcommand-line interface . . . . . . . . . 200

Restore Net Appliance CIFS shares . . . . . . 201Restoring data from a VMware backup . . . . . 201

Restoring full VM backups . . . . . . . . 202Scenarios for running full VM instant access andfull VM instant restore from the backup-archiveclient command line . . . . . . . . . . 203

Full VM instant restore cleanup and repairscenarios . . . . . . . . . . . . . 206Recovering from non-standard errorconditions . . . . . . . . . . . . 208

Scenario: Restoring file-level VM backups . . . 209Restoring full VM backups that were createdwith VMware Consolidated Backup . . . . . 212

Restore Windows individual Active Directoryobjects. . . . . . . . . . . . . . . . 213

Reanimate tombstone objects or restoring from asystem state backup . . . . . . . . . . 213Restoring Active Directory objects using theGUI and command line . . . . . . . . . 214Restrictions and limitations when restoringActive Directory objects . . . . . . . . . 215Preserve attributes in tombstone objects . . . 217Modifying the client acceptor and agent servicesto use the Web client . . . . . . . . . . 217

Restoring or retrieving data during a failover. . . 217Authorizing another user to restore or retrieveyour files . . . . . . . . . . . . . . . 219Restoring or retrieving files from another clientnode . . . . . . . . . . . . . . . . 220Restoring or retrieving your files to anotherworkstation . . . . . . . . . . . . . . 221Deleting file spaces . . . . . . . . . . . 222Restoring data to a point in time . . . . . . . 222Restore NAS file systems . . . . . . . . . 224

Restoring NAS file systems using the Web client 224Restoring NAS files and directories using theWeb client . . . . . . . . . . . . . 225Options and commands to restore NAS filesystems from the command line . . . . . . 226

Chapter 6. Archive and retrieve yourdata (Windows) . . . . . . . . . . 229Archive files. . . . . . . . . . . . . . 229

Contents v

Snapshot backup or archive with open filesupport . . . . . . . . . . . . . . 230Archiving data with the GUI . . . . . . . 230Archive data examples by using the commandline. . . . . . . . . . . . . . . . 231

Associate a local snapshot with a server filespace (Windows) . . . . . . . . . . 232

Archiving data with client node proxy . . . . 232Deleting archive data . . . . . . . . . . 234

Retrieve archives . . . . . . . . . . . . 234Retrieving archives with the GUI . . . . . . 235Retrieve archive copies by using the commandline. . . . . . . . . . . . . . . . 235

Chapter 7. Tivoli Storage Managerscheduler overview . . . . . . . . . 237Examples: Blank spaces in file names in scheduledefinitions . . . . . . . . . . . . . . 238Preferential start times for certain nodes . . . . 238Scheduler processing options . . . . . . . . 239

Return codes from preschedulecmd andpostschedulecmd scripts . . . . . . . . . 240

Client-acceptor scheduler services versus thetraditional scheduler services . . . . . . . . 241Set the client scheduler process to run as abackground task and start automatically at startup . 242Examples: Display information about scheduledwork . . . . . . . . . . . . . . . . 243Display information about completed work . . . 245

Examples: event logs . . . . . . . . . . 246Specify scheduling options . . . . . . . . . 249Enable or disable scheduled commands . . . . 249Change processing options used by the schedulerservice. . . . . . . . . . . . . . . . 250Manage multiple schedule requirements on onesystem . . . . . . . . . . . . . . . 250

Chapter 8. Client return codes . . . . 253

Chapter 9. Storage managementpolicies . . . . . . . . . . . . . . 255Policy domains and policy sets . . . . . . . 255Management classes and copy groups . . . . . 256Display information about management classesand copy groups . . . . . . . . . . . . 257

Copy group name attribute. . . . . . . . 257Copy type attribute . . . . . . . . . . 257Copy frequency attribute . . . . . . . . 258Versions data exists attribute . . . . . . . 258Versions data deleted attribute . . . . . . 258Retain extra versions attribute . . . . . . . 258Retain only version attribute . . . . . . . 259Copy serialization attribute . . . . . . . . 259Copy mode parameter . . . . . . . . . 260Copy destination attribute . . . . . . . . 260Retain versions attribute. . . . . . . . . 260Deduplicate data attribute . . . . . . . . 261

Select a management class for files . . . . . . 261Assign a management class to files . . . . . . 261Override the management class for archived files 262

Select a management class for directories . . . . 263Bind management classes to files . . . . . . . 263Rebind backup versions of files . . . . . . . 264Retention grace period . . . . . . . . . . 264Event-based policy retention protection. . . . . 265

Archive files on a data retention server . . . . 266

Chapter 10. Tivoli Storage ManagerClient Service Configuration Utility . . 267Install the backup-archive scheduler service . . . 267

Using the Client Service Configuration Utility(Windows) . . . . . . . . . . . . . 267

Examples: Automating backups . . . . . 267Examples: Configuring the CAD to managean existing scheduler service . . . . . . 269Creating a new scheduler and associating aCAD to manage the scheduler. . . . . . 270

dsmcutil command . . . . . . . . . . . 270Dsmcutil commands: Required options andexamples . . . . . . . . . . . . . . 271Dsmcutil valid options . . . . . . . . . 278

Chapter 11. Processing options . . . 283Processing options overview . . . . . . . . 283Communication options . . . . . . . . . . 284

TCP/IP options . . . . . . . . . . . 284Named Pipes option . . . . . . . . . . 285Shared memory options . . . . . . . . . 285

Server and node options. . . . . . . . . . 285Node options . . . . . . . . . . . . . 286Backup and archive processing options . . . . . 286Restore and retrieve processing options. . . . . 295Scheduling options . . . . . . . . . . . 297Format and language options . . . . . . . . 299Command processing options . . . . . . . . 299Authorization options . . . . . . . . . . 300Error processing options. . . . . . . . . . 300Transaction processing options . . . . . . . 301Web client options. . . . . . . . . . . . 302Diagnostics options . . . . . . . . . . . 302Using options with commands . . . . . . . 302

Entering options with a command . . . . . 303Initial command-line-only options . . . . . 308Client options that can be set by the TivoliStorage Manager server . . . . . . . . . 309

Client options reference . . . . . . . . . . 310Absolute . . . . . . . . . . . . . . 311Adlocation . . . . . . . . . . . . . 312Archmc . . . . . . . . . . . . . . . 313Asnodename . . . . . . . . . . . . . 313Asrmode . . . . . . . . . . . . . . 315Auditlogging . . . . . . . . . . . . 315Auditlogname . . . . . . . . . . . . 318Autodeploy . . . . . . . . . . . . . 320Autofsrename . . . . . . . . . . . . 321Backmc . . . . . . . . . . . . . . . 323Backupsetname . . . . . . . . . . . . 324Basesnapshotname . . . . . . . . . . . 325Casesensitiveaware . . . . . . . . . . 326Changingretries . . . . . . . . . . . 327

vi IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Class . . . . . . . . . . . . . . . 328Clientview . . . . . . . . . . . . . 328Clusterdisksonly . . . . . . . . . . . 329Clusternode . . . . . . . . . . . . . 332Collocatebyfilespec . . . . . . . . . . 333Commmethod . . . . . . . . . . . . . 334Commrestartduration . . . . . . . . . . 335Commrestartinterval . . . . . . . . . . 336Compressalways . . . . . . . . . . . . 337Compression . . . . . . . . . . . . . 337Console . . . . . . . . . . . . . . 339Createnewbase . . . . . . . . . . . . 340Datacenter . . . . . . . . . . . . . 342Datastore . . . . . . . . . . . . . 343Dateformat . . . . . . . . . . . . . 343Dedupcachepath . . . . . . . . . . . . 345Dedupcachesize . . . . . . . . . . . . 346Deduplication . . . . . . . . . . . . 346Deletefiles . . . . . . . . . . . . . 348Description . . . . . . . . . . . . . 348Detail . . . . . . . . . . . . . . . 349Diffsnapshot . . . . . . . . . . . . 351Diffsnapshotname . . . . . . . . . . . 352Dirmc . . . . . . . . . . . . . . . 353Dirsonly . . . . . . . . . . . . . . 354Disablenqr . . . . . . . . . . . . . 355Diskbuffsize . . . . . . . . . . . . 355Diskcachelocation . . . . . . . . . . 356Domain . . . . . . . . . . . . . . . 357Domain.image . . . . . . . . . . . . 360Domain.nas . . . . . . . . . . . . . 361Domain.vcd . . . . . . . . . . . . . 362Domain.vmfile . . . . . . . . . . . . 364Domain.vmfull . . . . . . . . . . . . 367Enable8dot3namesupport . . . . . . . . . 372Enablearchiveretentionprotection . . . . . 373Enablededupcache . . . . . . . . . . . 374Enablelanfree . . . . . . . . . . . . 375Encryptiontype . . . . . . . . . . . . 376Encryptkey . . . . . . . . . . . . . 377Errorlogmax . . . . . . . . . . . . . 379Errorlogname . . . . . . . . . . . . 380Errorlogretention . . . . . . . . . . 381Exclude options . . . . . . . . . . . 383

Controlling compression processing . . . . 386Adaptive subfile backup processing . . . . 387Processing NAS file systems . . . . . . 387VMware virtual machine exclude options . . 388

Fbbranch . . . . . . . . . . . . . . 389Fbclientname . . . . . . . . . . . . 390Fbpolicyname . . . . . . . . . . . . 392Fbreposlocation . . . . . . . . . . . 393Fbserver . . . . . . . . . . . . . . 395Fbvolumename . . . . . . . . . . . . 396Filelist . . . . . . . . . . . . . . 397Filename . . . . . . . . . . . . . . 400Filesonly . . . . . . . . . . . . . 401Forcefailover . . . . . . . . . . . . 402Fromdate . . . . . . . . . . . . . . 403Fromnode . . . . . . . . . . . . . . 404Fromtime . . . . . . . . . . . . . . 404

Groupname . . . . . . . . . . . . . 405Guitreeviewafterbackup . . . . . . . . . 406Host . . . . . . . . . . . . . . . 406Httpport . . . . . . . . . . . . . . 407Hsmreparsetag . . . . . . . . . . . . 407Ieobjtype . . . . . . . . . . . . . 408Ifnewer . . . . . . . . . . . . . . 409Imagegapsize . . . . . . . . . . . . 410Imagetofile . . . . . . . . . . . . . 411Inactive . . . . . . . . . . . . . . 412Inclexcl . . . . . . . . . . . . . . 412

Considerations for Unicode-enabled clients 413Include options. . . . . . . . . . . . 414

Compression, encryption, and adaptivesubfile backup processing . . . . . . . 419Processing NAS file systems . . . . . . 419VMware virtual machine include options . . 420

Incrbydate . . . . . . . . . . . . . 426Incremental . . . . . . . . . . . . . 427Incrthreshold . . . . . . . . . . . . 428Journalpipe . . . . . . . . . . . . . 429Lanfreecommmethod . . . . . . . . . . 430Lanfreeshmport . . . . . . . . . . . . 431Lanfreetcpport . . . . . . . . . . . . 432Lanfreessl . . . . . . . . . . . . . 433Lanfreetcpserveraddress . . . . . . . . 433Language . . . . . . . . . . . . . . 434Latest . . . . . . . . . . . . . . . 435Localbackupset . . . . . . . . . . . . 436Managedservices . . . . . . . . . . . 437Maxcmdretries . . . . . . . . . . . . 438Mbobjrefreshthresh . . . . . . . . . . 439Mbpctrefreshthresh . . . . . . . . . . 440Memoryefficientbackup . . . . . . . . . 441Mode . . . . . . . . . . . . . . . 442Monitor . . . . . . . . . . . . . . 446Myprimaryserver . . . . . . . . . . . 447Myreplicationserver . . . . . . . . . . 448Namedpipename . . . . . . . . . . . . 449Nasnodename . . . . . . . . . . . . . 450Nodename . . . . . . . . . . . . . . 451Nojournal . . . . . . . . . . . . . 452Noprompt . . . . . . . . . . . . . . 453Nrtablepath . . . . . . . . . . . . . 453Numberformat . . . . . . . . . . . . 454Optfile . . . . . . . . . . . . . . 456Password . . . . . . . . . . . . . . 456Passwordaccess . . . . . . . . . . . . 458Pick . . . . . . . . . . . . . . . 460Pitdate . . . . . . . . . . . . . . 460Pittime . . . . . . . . . . . . . . 461Postschedulecmd/Postnschedulecmd . . . . . 462Postsnapshotcmd . . . . . . . . . . . 464Preschedulecmd/Prenschedulecmd . . . . . 466Preservelastaccessdate . . . . . . . . . 467Preservepath . . . . . . . . . . . . 468Presnapshotcmd . . . . . . . . . . . . 470Queryschedperiod . . . . . . . . . . . 472Querysummary . . . . . . . . . . . . 473Quiet . . . . . . . . . . . . . . . 475Quotesareliteral . . . . . . . . . . . 475

Contents vii

Replace . . . . . . . . . . . . . . 477Replserverguid . . . . . . . . . . . . 478Replservername . . . . . . . . . . . . 479Replsslport . . . . . . . . . . . . . 481Repltcpport . . . . . . . . . . . . . 482Repltcpserveraddress . . . . . . . . . 483Resetarchiveattribute . . . . . . . . . 485Resourceutilization . . . . . . . . . . 486

Regulating backup and archive sessions . . 487Regulating restore sessions . . . . . . . 488Multiple client session considerations . . . 488

Retryperiod . . . . . . . . . . . . . 489Revokeremoteaccess . . . . . . . . . . 490Runasservice . . . . . . . . . . . . 490Schedcmddisabled . . . . . . . . . . . 491Schedcmdexception . . . . . . . . . . 492Schedlogmax . . . . . . . . . . . . . 493Schedlogname . . . . . . . . . . . . 495Schedlogretention . . . . . . . . . . 496Schedmode . . . . . . . . . . . . . 498Schedrestretrdisabled . . . . . . . . . 499Scrolllines . . . . . . . . . . . . . 500Scrollprompt . . . . . . . . . . . . 501Sessioninitiation . . . . . . . . . . 502Shmport . . . . . . . . . . . . . . 504Showmembers . . . . . . . . . . . . . 504Skipmissingsyswfiles . . . . . . . . . 505Skipntpermissions . . . . . . . . . . 506Skipntsecuritycrc . . . . . . . . . . 507Snapdiff . . . . . . . . . . . . . . 507Snapdiffhttps . . . . . . . . . . . . 512Snapshotproviderfs . . . . . . . . . . 514Snapshotproviderimage . . . . . . . . . 514Snapshotroot . . . . . . . . . . . . 515Srvoptsetencryptiondisabled . . . . . . . 518Srvprepostscheddisabled . . . . . . . . 518Srvprepostsnapdisabled . . . . . . . . . 519Ssl . . . . . . . . . . . . . . . . 520Sslfipsmode . . . . . . . . . . . . . 521Sslrequired . . . . . . . . . . . . . 522Stagingdirectory . . . . . . . . . . . 524Subdir . . . . . . . . . . . . . . . 525Subfilebackup . . . . . . . . . . . . 527Subfilecachepath . . . . . . . . . . . 528Subfilecachesize . . . . . . . . . . . 528Systemstatebackupmethod . . . . . . . . 529Tapeprompt . . . . . . . . . . . . . 530Tcpadminport . . . . . . . . . . . . 532Tcpbuffsize . . . . . . . . . . . . . 533Tcpcadaddress . . . . . . . . . . . . 533Tcpclientaddress . . . . . . . . . . . 534Tcpclientport . . . . . . . . . . . . 535Tcpnodelay . . . . . . . . . . . . . 536Tcpport . . . . . . . . . . . . . . 536Tcpserveraddress . . . . . . . . . . . 537Tcpwindowsize . . . . . . . . . . . . 538Timeformat . . . . . . . . . . . . . 539Toc . . . . . . . . . . . . . . . . 541Todate . . . . . . . . . . . . . . . 542Totime . . . . . . . . . . . . . . . 543Txnbytelimit . . . . . . . . . . . . 543

Type . . . . . . . . . . . . . . . 545Usedirectory . . . . . . . . . . . . 545Useexistingbase . . . . . . . . . . . 546Usereplicationfailover . . . . . . . . . 547V2archive . . . . . . . . . . . . . 548Vappmc . . . . . . . . . . . . . . . 549Vcdhost . . . . . . . . . . . . . . 550Vcdpw . . . . . . . . . . . . . . . 550Vcduser . . . . . . . . . . . . . . 551Verbose . . . . . . . . . . . . . . 552Verifyimage . . . . . . . . . . . . . 552Virtualfsname . . . . . . . . . . . . 553Virtualnodename . . . . . . . . . . . 553Vmautostartvm . . . . . . . . . . . . 555Vmbackdir . . . . . . . . . . . . . 555Vmbacknodelete . . . . . . . . . . . . 556Vmbackuptype . . . . . . . . . . . . 557Vmmc . . . . . . . . . . . . . . . 559Vmbackvcbtransport . . . . . . . . . . 559Vmchost . . . . . . . . . . . . . . 561Vmcpw . . . . . . . . . . . . . . . 561Vmctlmc . . . . . . . . . . . . . . 562Vmcuser . . . . . . . . . . . . . . 563Vmdiskprovision . . . . . . . . . . . 564Vmenabletemplatebackups . . . . . . . . 565Vmiscsiserveraddress . . . . . . . . . 566Vmlimitperdatastore . . . . . . . . . . 567Vmlimitperhost . . . . . . . . . . . . 568Vmlist . . . . . . . . . . . . . . . 569Vmmaxparallel . . . . . . . . . . . . 570Vmprocessvmwithindependent . . . . . . . 572Vmprocessvmwithprdm . . . . . . . . . . 573Vmrestoretype . . . . . . . . . . . . 574Vmskipctlcompression . . . . . . . . . 576Vmtempdatastore . . . . . . . . . . . 577Vmvstortransport . . . . . . . . . . . 577Vssaltstagingdir . . . . . . . . . . . 578Vssusesystemprovider . . . . . . . . . 579Vmtimeout . . . . . . . . . . . . . 580Webports . . . . . . . . . . . . . . 581Wildcardsareliteral . . . . . . . . . . 582

Chapter 12. Using commands . . . . 585Start and end a client command session . . . . 588

Process commands in batch mode . . . . . 588Process commands in interactive mode . . . . 589

Enter client command names, options, andparameters . . . . . . . . . . . . . . 589

Command name . . . . . . . . . . . 589Options . . . . . . . . . . . . . . 590

Options in interactive mode . . . . . . 590Parameters . . . . . . . . . . . . . 590File specification syntax . . . . . . . . . 591

Wildcard characters . . . . . . . . . . . 592Client commands reference . . . . . . . . . 593Archive . . . . . . . . . . . . . . . 593

Open file support . . . . . . . . . . . 595Archive FastBack . . . . . . . . . . . . 596Backup FastBack . . . . . . . . . . . . 599Backup Group . . . . . . . . . . . . . 601Backup Image . . . . . . . . . . . . . 604

viii IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Offline and online image backup . . . . . . 606Utilizing image backup to perform file systemincremental backup . . . . . . . . . . 607

Backup NAS . . . . . . . . . . . . . 608Backup Systemstate . . . . . . . . . . . 610Backup VAPP . . . . . . . . . . . . . 612Backup VM . . . . . . . . . . . . . . 618Cancel Process . . . . . . . . . . . . . 624Cancel Restore . . . . . . . . . . . . . 625Delete Access . . . . . . . . . . . . . 625Delete Archive . . . . . . . . . . . . . 626Delete Backup . . . . . . . . . . . . . 628Delete Filespace . . . . . . . . . . . . 631Delete Group . . . . . . . . . . . . . 632Expire . . . . . . . . . . . . . . . . 634Help . . . . . . . . . . . . . . . . 635Incremental . . . . . . . . . . . . . . 637

Open file support . . . . . . . . . . . 640Journal-based backup. . . . . . . . . . 641Backing up NTFS or ReFS volume mount points 642

Backing up data on NTFS or ReFS mountedvolumes . . . . . . . . . . . . . 642

Back up Microsoft Dfs root . . . . . . . . 643Incremental-by-Date . . . . . . . . . . 643Adaptive subfile backups . . . . . . . . 644Associate a local snapshot with a server filespace . . . . . . . . . . . . . . . 644

Loop . . . . . . . . . . . . . . . . 644Macro . . . . . . . . . . . . . . . . 646Monitor Process . . . . . . . . . . . . 646Preview Archive . . . . . . . . . . . . 647Preview Backup . . . . . . . . . . . . 648Query Access . . . . . . . . . . . . . 649Query Adobjects . . . . . . . . . . . . 650Query Archive . . . . . . . . . . . . . 651Query Backup . . . . . . . . . . . . . 654

Query NAS file system images . . . . . . 657Query Backupset . . . . . . . . . . . . 657

Query Backupset without the backupsetnameparameter . . . . . . . . . . . . . 659

Query Filespace . . . . . . . . . . . . 660Query NAS file spaces . . . . . . . . . 662

Query Group . . . . . . . . . . . . . 662Query Image . . . . . . . . . . . . . 664Query Inclexcl . . . . . . . . . . . . . 666Query Mgmtclass . . . . . . . . . . . . 667Query Node. . . . . . . . . . . . . . 668Query Options . . . . . . . . . . . . . 669Query Restore . . . . . . . . . . . . . 670Query Schedule . . . . . . . . . . . . 671Query Session . . . . . . . . . . . . . 671Query Systeminfo . . . . . . . . . . . 672Query Systemstate . . . . . . . . . . . 674Query VAPP . . . . . . . . . . . . . 675Query VM . . . . . . . . . . . . . . 679Restart Restore . . . . . . . . . . . . . 683Restore . . . . . . . . . . . . . . . 683

Restoring NTFS or ReFS volume mount points 688Restoring data on NTFS mounted volumes 688

Restore Microsoft Dfs junctions . . . . . . 689Restore active files. . . . . . . . . . . 689

Universal Naming Convention restores . . . . 689Restore from file spaces that are notUnicode-enabled . . . . . . . . . . . 690Restore named streams . . . . . . . . . 690Restore sparse files . . . . . . . . . . 690

Restore Adobjects. . . . . . . . . . . . 691Restore Backupset . . . . . . . . . . . 692

Restore backup sets: considerations andrestrictions . . . . . . . . . . . . . 695Restore backup sets in a SAN environment . . 696Restore Backupset without the backupsetnameparameter . . . . . . . . . . . . . 697

Restore Group . . . . . . . . . . . . . 699Restore Image . . . . . . . . . . . . . 701Restore NAS . . . . . . . . . . . . . 704Restore Systemstate . . . . . . . . . . . 706Restore VAPP . . . . . . . . . . . . . 708Restore VM . . . . . . . . . . . . . . 711Retrieve . . . . . . . . . . . . . . . 717

Retrieve archives from file spaces that are notUnicode-enabled . . . . . . . . . . . 721Retrieve named streams . . . . . . . . . 721Retrieve sparse files . . . . . . . . . . 721

Schedule . . . . . . . . . . . . . . . 722Selective . . . . . . . . . . . . . . . 723

Open file support . . . . . . . . . . . 726Adaptive subfile backups . . . . . . . . 726Associate a local snapshot with a server filespace . . . . . . . . . . . . . . . 727

Set Access . . . . . . . . . . . . . . 727Set Event. . . . . . . . . . . . . . . 730Set password . . . . . . . . . . . . . 732

Appendix A. Tivoli supportinformation . . . . . . . . . . . . 739Communities and other learning resources . . . 739Searching knowledge bases . . . . . . . . . 740

Searching the Internet . . . . . . . . . 741Using IBM Support Assistant . . . . . . . 741Finding product fixes. . . . . . . . . . 741Receiving notification of product fixes . . . . 742

Contacting IBM Software Support . . . . . . 742Setting up and managing support contracts . . 742Determining the business impact . . . . . . 742Describing the problem and gatheringbackground information . . . . . . . . . 743Submitting the problem to IBM SoftwareSupport . . . . . . . . . . . . . . 743

Appendix B. Accessibility features forthe Tivoli Storage Manager productfamily. . . . . . . . . . . . . . . 745

Notices . . . . . . . . . . . . . . 747Trademarks . . . . . . . . . . . . . . 749Privacy policy considerations . . . . . . . . 749

Glossary . . . . . . . . . . . . . 751A . . . . . . . . . . . . . . . . . 751

Contents ix

B . . . . . . . . . . . . . . . . . 753C . . . . . . . . . . . . . . . . . 753D . . . . . . . . . . . . . . . . . 755E . . . . . . . . . . . . . . . . . 756F . . . . . . . . . . . . . . . . . 757G . . . . . . . . . . . . . . . . . 758H . . . . . . . . . . . . . . . . . 758I. . . . . . . . . . . . . . . . . . 758J. . . . . . . . . . . . . . . . . . 759K . . . . . . . . . . . . . . . . . 759L . . . . . . . . . . . . . . . . . 759M . . . . . . . . . . . . . . . . . 760N . . . . . . . . . . . . . . . . . 762

O . . . . . . . . . . . . . . . . . 763P . . . . . . . . . . . . . . . . . 763Q . . . . . . . . . . . . . . . . . 764R . . . . . . . . . . . . . . . . . 764S . . . . . . . . . . . . . . . . . 765T . . . . . . . . . . . . . . . . . 768U . . . . . . . . . . . . . . . . . 769V . . . . . . . . . . . . . . . . . 769W . . . . . . . . . . . . . . . . . 770

Index . . . . . . . . . . . . . . . 771

x IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Tables1. Server publications . . . . . . . . . . xiv2. Storage agent publications . . . . . . . xiv3. Backup-archive client publications. . . . . xiv4. Data protection publications . . . . . . . xv5. Troubleshooting and performance tuning

publications . . . . . . . . . . . . xv6. Windows client communication methods . . . 67. Supported features on Windows platforms 78. Stoppable services . . . . . . . . . . 159. Data deduplication settings: Client and server 5210. Options for excluding file spaces and

directories . . . . . . . . . . . . . 8511. Options for controlling processing using

include and exclude statements . . . . . . 8612. Wildcard and other special characters . . . . 8913. Specifying a drive specification using

wildcards . . . . . . . . . . . . . 9014. Using wildcard characters with include and

exclude patterns . . . . . . . . . . . 9115. Options for controlling compression and

encryption processing . . . . . . . . . 9116. UNC name patterns and DOS patterns 9517. Required user security rights for Tivoli Storage

Manager backup and restore services . . . . 9718. Working with your files using the Tivoli

Storage Manager GUI . . . . . . . . . 10919. Planning your backups . . . . . . . . 11320. Command line backup examples . . . . . 11821. Maximum file size . . . . . . . . . . 12722. Comparing incremental image backup

methods . . . . . . . . . . . . . 14823. NAS options and commands . . . . . . 15224. Backup and restore capabilities for VMware

virtual machines on Windows platforms . . 15525. Comparison of full backups and file-level

backups for VMware virtual machines onWindows systems . . . . . . . . . . 157

26. Client command line informational messages 17327. UNC examples . . . . . . . . . . . 17928. Command-line restore examples . . . . . 18529. Backup set GUI restore restrictions . . . . 19630. Backup set command-line restore restrictions 19731. Components for the restore command when

you restore files to the same computer . . . 21032. Components for the restore command when

you restore files to a different computer. . . 21133. NAS options and commands . . . . . . 22634. Command-line archive examples . . . . . 23135. Command line examples of retrieving

archives . . . . . . . . . . . . . 23536. Sample classic query schedule output 24437. Sample enhanced query schedule output 24538. Client return codes and their meanings 25339. Default attribute values in the standard

management class . . . . . . . . . . 25740. TCP/IP options . . . . . . . . . . . 284

41. Named Pipes communication option 28542. Shared memory communication options 28543. Server and node options . . . . . . . . 28544. Node options . . . . . . . . . . . 28645. Backup and archive processing options 28646. Restore and retrieve processing options 29547. Scheduling options. . . . . . . . . . 29748. Format and language options . . . . . . 29949. Command processing options . . . . . . 29950. Authorization options. . . . . . . . . 30051. Error processing options . . . . . . . . 30052. Transaction processing options . . . . . . 30153. Web client options . . . . . . . . . . 30254. Diagnostics options . . . . . . . . . 30255. Client command options . . . . . . . . 30456. Options that are valid on the initial command

line only . . . . . . . . . . . . . 30957. Options that can be set by the Tivoli Storage

Manager server . . . . . . . . . . . 31058. Clusternode and clusterdisksonly

combinations. . . . . . . . . . . . 33159. Interaction of domain definitions from several

sources. . . . . . . . . . . . . . 36060. System services components and

corresponding keywords . . . . . . . . 38561. Other optional parameters . . . . . . . 41862. Incremental command: Related options 50963. Effects of server and client SSL settings on

success or failure of login attempts . . . . 52364. Commands . . . . . . . . . . . . 58565. Wildcard characters . . . . . . . . . 59266. Archive command: Related options . . . . 59467. Archive FastBack command: Related options 59768. Backup FastBack command: Related options 60069. Backup Group command: Related options 60370. Backup Image command: Related options 60571. Backup NAS command: Related options 61072. Backup VAPP command: Related options 61473. Backup vm return codes . . . . . . . . 62274. Delete Archive command: Related options 62775. Delete Backup command: Related options 63076. Delete Filespace command: Related options 63277. Delete Group command: Related options 63378. Expire command: Related options. . . . . 63579. Incremental command: Related options 63880. Query Adobjects command: Related options 65081. Query Archive command: Related options 65282. Query Backup command: Related options 65583. Query Backupset command: Related options 65884. Query Backupset command: Related options 66085. Query Filespace command: Related options 66186. Query Group command: Related options 66387. Query Image command: Related options 66588. Query Mgmtclass command: Related options 66889. Query Node command: Related options 66990. Query Options command: Related options 669

Copyright IBM Corp. 1993, 2013 xi

91. Query Systeminfo command: Related options 67492. Query Systemstate command: Related options 67493. Restore VAPP command: Related options 67794. Query VM command: Related options for

VMware virtual machine queries. . . . . . 67995. Query VM command: Related options for

Hyper-V virtual machine queries. . . . . . 68296. Restore command: Related options . . . . 68697. Restore Adobjects command: Related options 69298. Restore Backupset command: Related options 69499. Restore Group command: Related options 700100. Restore Image command: Related options 703

101. Restore NAS command: Related options 705102. Restore Systemstate command: Related

options . . . . . . . . . . . . . 707103. Restore VAPP command: Related options 710104. Restore VM command: Related options when

restoring VMware virtual machines . . . . 714105. Restore VM command: Related options when

restoring Hyper-V virtual machines . . . . 717106. Retrieve command: Related options . . . . 719107. Schedule command: Related options . . . . 722108. Selective command: Related options . . . . 725

xii IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

About this publicationIBM Tivoli Storage Manager is a client/server licensed product that providesstorage management services in a multiplatform computer environment.

The backup-archive client program enables users to back up and archive files fromtheir workstations or file servers to storage, and restore and retrieve backupversions and archived copies of files to their local workstations.

In addition to the backup-archive client, Tivoli Storage Manager includes thefollowing components:v A server program that acts as a backup and archive server for distributedworkstations and file servers.

v An administrative client program that you can access from a web browser orfrom the command line. The program enables a Tivoli Storage Manageradministrator to control and monitor server activities, define storagemanagement policies for backup, archive, and space management services, andset up schedules to perform those services at regular intervals.

v An application programming interface (API) that you can use to enhance anexisting application with storage management services. When an application isregistered with a server as a client node, the application can back up, restore,archive, and retrieve objects from storage.

v A web backup-archive client that enables an authorized administrator, help deskperson, or other users to perform backup, restore, archive, and retrieve servicesby using a web browser on a remote system.

Who should read this publicationThis publication provides instructions for a user to install, configure, and use theTivoli Storage Manager client.

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

PublicationsPublications for the Tivoli Storage Manager family of products are available online.The Tivoli Storage Manager product family includes IBM Tivoli StorageFlashCopy Manager, IBM Tivoli Storage Manager for Space Management, IBMTivoli Storage Manager for Databases, and several other storage managementproducts from IBM Tivoli.

To search across all publications or to download PDF versions of individualpublications, go to the Tivoli Storage Manager information center athttp://pic.dhe.ibm.com/infocenter/tsminfo/v7r1.

You also can find the Tivoli Storage Manager product family information centersand other information centers that contain official product documentation forcurrent and previous versions of Tivoli products at Tivoli Documentation Central.Tivoli Documentation Central is available at http://www.ibm.com/developerworks/community/wikis/home/wiki/Tivoli Documentation Central.

Copyright IBM Corp. 1993, 2013 xiii

Tivoli Storage Manager publicationsThe following tables list the publications that are included in the Tivoli StorageManager library.

Table 1. Server publicationsPublication title Order number

IBM Tivoli Storage Manager for AIX Installation Guide GC23-9781

IBM Tivoli Storage Manager for AIX Administrator's Guide SC23-9769

IBM Tivoli Storage Manager for AIX Administrator's Reference SC23-9775

IBM Tivoli Storage Manager for HP-UX Installation Guide GC23-9782

IBM Tivoli Storage Manager for HP-UX Administrator's Guide SC23-9770

IBM Tivoli Storage Manager for HP-UX Administrator's Reference SC23-9776

IBM Tivoli Storage Manager for Linux Installation Guide GC23-9783

IBM Tivoli Storage Manager for Linux Administrator's Guide SC23-9771

IBM Tivoli Storage Manager for Linux Administrator's Reference SC23-9777

IBM Tivoli Storage Manager for Oracle Solaris Installation Guide GC23-9784

IBM Tivoli Storage Manager for Oracle Solaris Administrator's Guide SC23-9772

IBM Tivoli Storage Manager for Oracle Solaris Administrator's Reference SC23-9778

IBM Tivoli Storage Manager for Windows Installation Guide GC23-9785

IBM Tivoli Storage Manager for Windows Administrator's Guide SC23-9773

IBM Tivoli Storage Manager for Windows Administrator's Reference SC23-9779

IBM Tivoli Storage Manager for z/OS Media Installation and User'sGuide

SC27-4018

IBM Tivoli Storage Manager Upgrade and Migration Guide for V5Servers

GC27-4017

IBM Tivoli Storage Manager Integration Guide for Tivoli StorageManager FastBack

SC27-2828

Table 2. Storage agent publicationsPublication title Order number

IBM Tivoli Storage Manager for SAN for AIX Storage Agent User'sGuide

SC23-9797

IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User'sGuide

SC23-9798

IBM Tivoli Storage Manager for SAN for Linux Storage Agent User'sGuide

SC23-9799

IBM Tivoli Storage Manager for SAN for Oracle Solaris Storage AgentUser's Guide

SC23-9800

IBM Tivoli Storage Manager for SAN for Windows Storage Agent User'sGuide

SC23-9553

Table 3. Backup-archive client publicationsPublication title Order number

IBM Tivoli Storage Manager for UNIX and Linux: Backup-ArchiveClients Installation and User's Guide

SC23-9791

xiv IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Table 3. Backup-archive client publications (continued)Publication title Order number

IBM Tivoli Storage Manager for Windows: Backup-Archive ClientsInstallation and User's Guide

SC23-9792

IBM Tivoli Storage Manager Using the Application ProgrammingInterface

SC23-9793

IBM Tivoli Storage Manager for Space Management for UNIX and Linux:Users Guide

SC23-9794

IBM Tivoli Storage Manager HSM for Windows Administration Guide SC23-9795

Table 4. Data protection publicationsPublication title Order number

IBM Tivoli Storage Manager for Databases: Data Protection for MicrosoftSQL Server Installation and Users Guide

GC27-4010

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle forUNIX and Linux Installation and Users Guide

SC27-4019

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle forWindows Installation and Users Guide

SC27-4020

IBM Tivoli Storage Manager for Mail: Data Protection for MicrosoftExchange Server Installation and Users Guide

GC27-4009

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus

Domino UNIX and Linux Installation and Users GuideSC27-4021

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Dominofor Windows Installation and Users Guide

SC27-4022

IBM Tivoli Storage Manager for Enterprise Resource Planning: DataProtection for SAP Installation and Users Guide for DB2

SC33-6341

IBM Tivoli Storage Manager for Enterprise Resource Planning: DataProtection for SAP Installation and Users Guide for Oracle

SC33-6340

IBM Tivoli Storage Manager for Virtual Environments Installation andUsers Guide

SC27-2898

Table 5. Troubleshooting and performance tuning publicationsPublication title Order number

IBM Tivoli Storage Manager Problem Determination Guide GC23-9789

IBM Tivoli Storage Manager Performance Tuning Guide GC23-9788

IBM Tivoli Storage Manager Client Messages and ApplicationProgramming Interface Return Codes

SC27-2878

IBM Tivoli Storage Manager Server Messages and Error Codes SC27-2877

IBM Tivoli Storage Manager for Mail: Data Protection for MicrosoftExchange Server Messages

GC27-4011

IBM Tivoli Storage Manager for Databases: Data Protection for MicrosoftSQL Server Messages

GC27-4012

IBM Tivoli Storage Manager for Databases: Data Protection for OracleMessages

SC27-4014

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus DominoMessages

SC27-4015

IBM Tivoli Storage Manager for Enterprise Resource Planning: DataProtection for SAP Messages

SC27-4016

About this publication xv

Note: IBM System Storage Archive Manager is not releasing a new product. Youcan find information about IBM System Storage Archive Manager at the TivoliStorage Manager V6.3 information center (http://pic.dhe.ibm.com/infocenter/tsminfo/v6r3/topic/com.ibm.itsm.nav.doc/c_complydataretention_ovr.html).

Conventions used in this publicationThis publication uses the following typographical conventions:

Example Description

autoexec.ncfhsmgui.exe

A series of lowercase letters with an extension indicates program filenames.

DSMI_DIR A series of uppercase letters indicates return codes and other values.

dsmQuerySessInfo Boldface type indicates a command that you type on a command line,the name of a function call, the name of a structure, a field within astructure, or a parameter.

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

dateformat Italic type indicates an option, the value of an option, a new term, aplaceholder for information you provide, or for special emphasis in thetext.

maxcmdretries Monospace type indicates fragments of a program or information as itmight appear on a display screen, such a command example.

plus sign (+) A plus sign between two keys indicates that you press both keys at thesame time.

Reading syntax diagramsTo read a syntax diagram for entering a command, follow the path of the line.Read from left to right and from top to bottom.v The symbol indicates the beginning of a syntax diagram.v The symbol at the end of a line indicates that the syntax diagram continueson the next line.

v The symbol at the beginning of a line indicates that a syntax diagramcontinues from the previous line.

v The symbol indicates the end of a syntax diagram.

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

Symbols

Enter these symbols exactly as they appear in the syntax diagram.v * Asteriskv { } Bracesv : Colonv , Comma

xvi IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

v = Equal Signv - Hyphenv () Parenthesesv . Periodv Spacev " quotation markv 'single quotation mark

Variables

Italicized lowercase items such as indicate variables. In this example,you can specify a when you enter the cmd_name command.

cmd_name

Repetition

An arrow returning to the left means that the item can be repeated. A characterwithin the arrow means that you must separate repeated items with that character.

,

repeat

A footnote (1) by the arrow refers to a limit that tells how many times the item canbe repeated.

,(1)

repeat

Notes:

1 Specify repeat up to 5 times.

Required choices

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

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

cmd_name ABC

Optional choices

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

About this publication xvii

cmd_nameA

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

cmd_nameABC

Repeatable choices

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

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

,

cmd_name ABC

Defaults

Defaults are above the line. The default is selected unless you override it, or youcan select the default explicitly. To override the default, include an option from thestack below the line.

In this example, A is the default. Select either B or C to override A.

A

cmd_nameBC

xviii IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

New for IBM Tivoli Storage Manager Version 7.1Tivoli Storage Manager backup-archive client version 7.1 contains many newfeatures and changes.

VM functionality added to the delete backup and expire commandsThe delete backup and the expire command have been enhanced tosupport the -objtype=VM option. When this option is entered, thecommands deal only with VM backups. This new feature applies toplatforms that support VM.v The delete backup command can be used to delete backups of VMfilespaces, either active or inactive versions. When the -objtype=VMoption is used, this specifies that you want to delete one or moreversions of VM backups. When -objtype=VM is entered, thedeltype andfilelist options can not be used.

v The expire command can be used to expire an active VM backup.Support added for Automated System Recovery (ASR) of Windows clients thatuse UEFI

ASR data backup and ASR recovery are now supported on Windows clientsystems that use boot by using either BIOS or Universal ExtensibleFirmware Interface (UEFI).

New parameter added to INCLUDE.VMTSMVSS optionA new parameter has been added to the INCLUDE.VMTSMVSS clientoption to enhance Tivoli Storage Manager application protection functions.If OPTions KEEPSqllog is specified on an INCLUDE.VMTSMVSS statement, thisparameter prevents SQL server logs from being truncated when abackup-archive client that is installed on a data mover node backs up avirtual machine that is running a SQL server. Specifying this parameterallows the SQL server administrator to manually manage (backup, andpossibly truncate) the SQL server logs, so they can be preserved as neededand be used to restore SQL transactions to a specific checkpoint, after thevirtual machine is restored.

Automated client failover for data recoveryThe backup-archive client can be set up to automatically fail over to thesecondary server when the primary Tivoli Storage Manager server isunavailable. When the client fails over to the secondary server, you canrestore or retrieve any data that has been replicated.

For more information, see Automated client failover configuration anduse on page 56.

Protection for vCloud vApps addedCustomers who are licensed to use IBM Tivoli Storage Manager for VirtualEnvironments can now back up, query, and restore vCloud vApps. Newcommands and new options are added to support vCloud vApps.

New or changed commands:

v Set Access on page 727v Set password on page 732v Backup VAPP on page 612v Restore VAPP on page 708v Query VAPP on page 675

Copyright IBM Corp. 1993, 2013 xix

New options:

v Domain.vcd on page 362v Vcdhost on page 550v Vcduser on page 551v Vcdpw on page 550

Snapshot differential backup with a secure HTTPS connectionYou can use the snapdiffhttps option to run snapshot differential backupsof NetApp filers with a secure HTTPS connection. To successfully runsnapshot differential backups, previous releases of the backup-archiveclient required HTTP administrative access to be enabled on the NetAppfiler. With the snapdiffhttps option, you can establish a secureadministrative session with the NetApp filer regardless of whether HTTPadministrative access is enabled on the filer.

Instant access and instant restore is supported for Windows clients running onWindows vStorage backup servers

Customers who are licensed to use IBM Tivoli Storage Manager for VirtualEnvironments can use client options and commands to restore a VMwarevirtual machine backup that will be available for immediate use, either forvalidating the backed up data or for restoring it to permanent storage.Instant access and instant restore operations and options are supportedonly for VMware virtual machines that are hosted on VMware ESXi 5.1servers, or later versions.

For information about using or configuring instant access or instant restoreoperations, see the following topics:v Scenarios for running full VM instant access and full VM instant restorefrom the backup-archive client command line on page 203

v Query VM on page 679v Restore VM on page 711v Vmautostartvm on page 555v Vmdiskprovision on page 564v Vmiscsiserveraddress on page 566v Vmtempdatastore on page 577v Vmrestoretype on page 574

Hyper-V support enhanced to support the new Microsoft APIThe backup-archive client has been updated to use the new Microsoft APIfor Hyper-V servers. This continues the support for backing up Hyper-Vguests that run on a local disk or on cluster shared volumes.

Snapshot differential backups enhanced with persistent change log databaseSnapshot differential backup operations are enhanced to minimize the needto run full progressive incremental backups. The backup-archive clientmust complete an initial full progressive incremental backup withoutfailures before snapshot differential backups can occur. The persistentsnapshot differences change log database is used to track the differencesbetween two snapshots when a snapshot differential backup is completed.The change log persists between backup operations. These enhancementsare included the backup-archive client program and do not require userinteraction. There are no documentation updates for this feature.

TLS/SSL is now supported on Mac OS X clientsMac OS X client and server communications can now be secured byTLS/SSL encryption.

xx IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

Chapter 1. Installing the Tivoli Storage Managerbackup-archive clients

The IBM Tivoli Storage Manager backup-archive client helps you protectinformation on your workstations.

You can maintain backup versions of your files that you can restore if the originalfiles are damaged or lost. You can also archive files that you do not currently need,preserve them in their current state, and retrieve them when necessary.

The Tivoli Storage Manager clients work in conjunction with the Tivoli StorageManager server. Contact your Tivoli Storage Manager server administrator toobtain backup or archive access to the server, or refer to the server publications toinstall and configure a Tivoli Storage Manager server.

Upgrading the backup-archive clientThe following sections explain what you need to do if you are upgrading to IBMTivoli Storage Manager backup-archive client Version 7.1 from a previous version.

Upgrade path for clients and serversTivoli Storage Manager clients and servers can be upgraded at different times. Thecombination of servers and clients that you deploy must be compatible with eachother.

To prevent disruption of your backup and archive activities while you upgradefrom one release to another, follow the compatibility guidelines for Tivoli StorageManager clients and servers. These guidelines are available on the web; to view theguidelines browse to http://www.ibm.com/support/docview.wss?uid=swg21053218.

Considerations for migrating between processor architecturesx32 and x64

When migrating between the Tivoli Storage Manager processor architectures (x32and x64), there are some items that you need to consider for a successful migrationfrom one architecture to another.

Consider the following items when migrating from one processor architecture toanother:v The restore of DFS links backed up from 32-bit Windows environments to 64-bitWindows environments, is not supported.

v The restore of DFS links backed up from 64-bit Windows environments to 32-bitWindows environments, is not supported.

v System state data is incompatible between different processor architectures.Therefore, when migrating client data between different processor architectures,avoid backing up the system state data from one architecture into the same filespaces containing the system state data from another architecture. To avoidcommingling the data, you can do either of the following before the migration: Ask your Tivoli Storage Manager administrator to rename the existing system

state file spaces. Once the migration is complete and you have new backups

Copyright IBM Corp. 1993, 2013 1

of the system state data, your Tivoli Storage Manager administrator can deletethe renamed file spaces. The file spaces to rename include one or more of thefollowing:- SYSTEM STATE- SYSTEM SERVICES- ASRAsk your Tivoli Storage Manager administrator to delete the existing filespaces for your node.

v Renamed file spaces remain on the server and managed as stabilized file spaces.These file spaces contain all the original data, which can still be restored untilthe file spaces are deleted. You can find additional information in the IBM TivoliStorage Manager for Windows Administrator's Guide.

v When an existing file space is renamed during Unicode conversion, any accessrules defined for the file space remain applicable to the original file space. Newaccess rules must be defined to apply to the new Unicode file space, if necessary.

v When backing up files to a file space that is not Unicode-enabled, theUnicode-enabled client skips the files and directories with names containingcharacters from a code page other than the current locale.

v If files and directories with names containing characters from a code page otherthan the current locale were previously backed up with a client that was notUnicode-enabled, Tivoli Storage Manager expires them in the file space that isnot Unicode-enabled. However, the Unicode-enabled client can back up orarchive these files to a Unicode-enabled file space.

v When migrating from a client that is not Unicode-enabled to a Unicode client,file names with double-byte characters mixed with single-byte characters mightbe restored in mixed single-byte character set (SBCS) format. This is only adisplay issue.

v When a client performs a selective backup of an object and the original filespace is renamed, the new Unicode-enabled file space contains only that object.Tivoli Storage Manager backs up all other directories and file spaces during thenext full incremental backup.

v The Unicode-enabled client has a file and directory name size limitation of 504bytes. Depending on the Unicode characters (2-byte, 3-byte, or 4-byte) used, thistranslates to a maximum of 126 to 252 characters.

Important:If you do not follow the migration instructions properly, you might have two filespaces, one Unicode and one non-Unicode, with different file space identifiers(fsID) for the same client volume. In this case, the Tivoli Storage Manager clientuses the non-Unicode file space as the default file space for backup and restoreoperations.

Additional upgrade informationWhen you upgrade a Tivoli Storage Manager client, there are additional things toconsider before you use the new client software.

When you install the web client, you must install the web-client language files thatcorrespond to those languages you want to use. To view the online help from theweb client applet in languages other than English, you must install the languageversions of the help files on the agent, the system where the Tivoli StorageManager backup-archive client was installed. If the language versions are notinstalled or are not available, the online help is displayed in English.

2 IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide

The size of the buffer to record change notifications for a particular journal filesystem (DirNotifyBufferSize) has changed. The default value is 16 KB.

For a list of new and changed messages since the previous Tivoli Storage Managerrelease, see the client_message.chg file in the client package.

Automatic backup-archive client deploymentThe Tivoli Storage Manager server administrator can automatically deploy abackup-archive client to workstations that already have the backup-archive clientinstalled.

When you schedule automatic Backup-Archive client deployments, the updatedclient packages (which include the client components and the API library) areinstalled on the workstations that receive them. A dependency check is performedby the client installation program to ensure that the API library does not conflictwith the client package that is already installed.

Tivoli Data Protection for Enterprise Resource Planning applications do not use thesame installation technology that is used by the client installation program.Because of that, the client installation dependency check is not able to detectwhether the API library that is being used by the Tivoli Data Protection forEnterprise Resource Planning applications is compatible with the API library thatwill be installed by automatic client deployments. If a client package isautomatically deployed to and installed on a workstation, the API library that isinstalled might not be compatible with the API library that was installed by theTivoli Data Protection for Enterprise Resource Planning application. The newlydeployed API library can cause the Tivoli Data Protection for Enterprise ResourcePlanning applications to fail.

Do not schedule automatic client deployments to workstations that have a TivoliData Protection for Enterprise Resource Planning application installed on them.

The Tivoli Storage Manager server can be configured to automatically upgradebackup-archive clients on Windows computers. The existing clients must be atversion 5.4, or later.

You can use the autodeploy option to conditionally enable automatic clientdeployment, if the deployment does not require a restart of the client workstation.

By default, the autodeploy option is enabled, and the client workstation is restartedif required.

The autodeploy option can be set in the following places:v In the Administration Center. However, starting with Tivoli Storage ManagerVersion 7.1, the Administration Center component is no longer included in TivoliStorage Manager distributions. If you have an Administration Center from aprevious server release, you can continue to use it to set the autodeploy optionon schedules that deploy client updates. If you do not already have anAdministration Center installed, you can download the previously-releasedversion from ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/LATEST. For information about theAdministration Center, see the Tivoli Storage Manager Version 6.3 serverdocumentation.

v On a schedule definition. Schedules are defined on the server. Scheduledefinitions that deploy client software updates have an action=deploy statement.

Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 3

On those schedules, you can include the autodeploy option as part of thecommand that you include on the postnschedulecmd statement.

v On the client node, in an options file that is associated with the client scheduleror client acceptor daemon. The deployment manager detects options files thatare associated with the scheduler or client acceptor daemon. If there are multiplescheduler or client acceptor daemon processes running on the same computer atthe same time, and the processes use different options files, the deploymentmanager uses the autodeploy value that is set in one of the options files.

v On the client in the client options file (dsm.opt). The autodeploy option that isset in the client options file overrides any other autodeploy setting.

To use automatic deployment but not restart the system, specify the autodeploynoreboot option.

Important: For automatic client deployment to be operational, the followingconditions apply:v The client computer must have a minimum of 2 GB free disk space.v The passwordaccess option must be set to generate.To store the password in the local Windows registry, a user must log on from thelocal workstation once, to provide the password. If the client automaticdeployment process cannot find the node password in the registry, the followingevents occur: The deployment process does not start. A warning message is logged in the setup.log file.

The following messages are examples of the messages that can be loggedduring a deployment.Sun 10/11/2009 10:16:04.35 The deployclient.bat script is started.Sun 10/11/2009 10:16:04.37 deployclient.bat is removing the deployment

manager and temporary files possibly left from the previous installation.Sun 10/11/2009 10:17:10.53 WARNING: Still waiting for the result of query

system information.Ensure that "PASSWORDACCESS GENERATE" is set in the client options fileand that a connection to the server can be made without being promptedfor a password.

If you see these errors and PASSWORDACCESS is set to GENERATE, the errors areprobably caused by a network problem (the client cannot be reached) or theremight be a problem with the digital rights management subkey. The digitalrights management key is in the registry in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\BackupRestore\FilesNotToBackup\DRM.

The dsmc query systeminfo command is left running. The deployment process cannot start, so no messages are sent to the server.

v The client is deployed from the server as a scheduled task; the client schedulermust be running.The scheduler must be started as a Windows service and not from the commandline. To minimize the chance of a restart, the deployment manager shuts downthe scheduler service before the new client is installed, and restarts the schedulerservice after the installation. If the scheduler is not run as a Windows service, arestart is required when the client is deployed.

v The automatic client deployment feature stops and restarts scheduler and CADprocesses on the client, but it does not stop or restart any client operations, suchas a backup or a restore. It is possible that in-process client operations could beaffected during an automatic deployment. To prevent an automatic deployment


from interfering with client operations, schedule automatic client deployments tooccur when it is not likely that the client is performing a backup or restore, orarchive or retrieve operation.

v The client is deployed as a postschedule operating system command; scheduledoperating system commands must be enabled on the client.You must configure your server to perform backup-archive client automaticdeployments. See the Tivoli Storage Manager Administrators Guide for instructions.

v The command-line Windows registry utility (reg.exe) is required. This tool isgenerally installed as part of the operating system installation on supportedWindows platforms.

v The Windows cluster services environment is not supported.v To turn off automatic client deployment, add autodeploy no to the client optionsfile.The autodeploy option is only available for Tivoli Storage Manager clientsversion 6.2 and later.

When you perform automatic client deployments from the Tivoli Storage ManagerServer, the scheduler installs the updated client by running a command that isspecified on a postschedulecmd option that is associated with the schedule. Bydefault, the log and trace files for a deployment operation are written to the client'sdisk in C:\Program Files\Tivoli\TSM\IBM_ANR_WIN\Vxxxx\log; where xxxxrepresents the version for the newly deployed client.

If you did not use the default installation directory when you installed the client,when an automatic client deployment is performed, the log and trace data for thedeployment operation are still copied to the IBM_ANR_WIN\Vxxxx\log folder, andthis folder is created one directory level up (../) from where the client executablefiles (dsm.exe, dsmc,exe, dsmcad.exe, and so on) were installed. For example, if youoriginally installed the client into E:\IBM\Tivoli\baclient, the log and trace filesresulting from the automatic deployment are created in E:\IBM\Tivoli\IBM_ANR_WIN\Vxxxx\log folder.

A lock file is also created on each client to prevent a client from being updated bydifferent deployment managers at the same time. Before a deployment begins, thedeployment manager looks on the client for the lock file. If the file exists and isless than 24 hours old, the deployment is canceled. If the lock file is more than 24hours old or does not exist, the deployment is started. The lock file is deletedwhen the deployment completes. If the deployment manager fails to delete thelock file, you can manually delete it from the clients disk. The lock file location isinstall_dir\..\IBM_ANR_WIN\mutext.txt.Related reference:Autodeploy on page 320

Client environment requirementsEach of the Tivoli Storage Manager clients has hardware and softwarerequirements.

The following list shows the location of the environment prerequisites for eachsupported platform.v NDMP support requirements (Extended Edition only) on page 8


For current information about the client environment prerequisites for all of thesupported Tivoli Storage Manager client platforms, go to the website athttp://www.ibm.com/support/docview.wss?&uid=swg21243309

Windows client environment requirementsThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the supported Windowsplatforms.

Windows client installable componentsThe Tivoli Storage Manager backup-archive client is comprised of severalinstallable components.

The installable components for the Windows client are as follows:v Tivoli Storage Manager backup-archive command line clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager backup-archive client Graphical User Interface, whichuses Oracle Java technology

v Tivoli Storage Manager backup-archive web clientv Tivoli Storage Manager API (32-bit and 64-bit)v VMware vStorage API runtime files. These files are required if you are using abackup-archive client node to act as a data mover node that protects VMwarevirtual machines. Windows data mover nodes must have the 64-bit Windowsclient installed on them.

System requirements for Windows clientsThe Tivoli Storage Manager Windows client requires a minimum amount of diskspace for installation and a supported operating system.

For software and hardware requirements for all supported versions of TivoliStorage Manager Microsoft Windows clients, including the most recent fix packs,see Microsoft Windows Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21197133.

Windows client communication methodsThe TCP/IP and shared memory communication methods are available for theWindows backup-archive client.

You can use the following communication methods with the Tivoli StorageManager Windows client:

Table 6. Windows client communication methodsTo use this communicationmethod:

Install this software: To connect to these TivoliStorage Manager servers:

TCP/IP TCP/IP (Standard with allsupported Windows

AIX, HP-UX IA, Linux,Solaris, Windows

Named Pipes Named Pipes (Standard withall supported Windowsplatforms)

Windows

Shared Memory TCP/IP (Standard with allsupported Windowsplatforms)

Windows


Backup-archive client features that are available on WindowsplatformsThis topic lists which features are supported or not supported on the variousWindows platforms.

Table 7 shows the supported and unsupported features on the various Windowsplatforms.

Table 7. Supported features on Windows platforms

Features32-bit:

Windows 7

64-bit:

Windows 7

32-bit:

Windows 8

WindowsServer 2008

WindowsServer Core2008

64-bit:

Windows 8

WindowsServer 2008

WindowsServer 2008 R2

WindowsServer 2012



Journal-based backup yes yes yes yes

Online image backup yes yes yes yes

Offline image backup yes yes yes yes

System state support with VolumeShadowcopy Services (VSS)

yes yes yes yes

LAN-free operations no no yes yes

Automated System Recovery (ASR) yes BIOS: yes

UEFI: yes

yes BIOS: yes

UEFI: yes

Open File Support (OFS) yes yes yes yes

Windows supported file systemsThe Tivoli Storage Manager Windows backup-archive client is supported onspecific file systems.

The Tivoli Storage Manager Windows Backup-Archive Client supports thefollowing types of file systems:v GPFSv File Allocation Table (FAT and FAT32)v Microsoft New Technology File System (NTFS)v Microsoft Resilient File System (ReFS). ReFS was introduced on Windows Server2012 systems.


NDMP support requirements (Extended Edition only)You can use the Network Data Management Protocol (NDMP) to back up andrestore network attached storage (NAS) file systems to tape drives or libraries thatare locally attached to Network Appliance and EMC Celerra NAS file servers.

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

NDMP support requires the following hardware and software:v Tivoli Storage Manager Extended Editionv Tape drive and tape library. For supported combinations, go to:http://www.ibm.com/software/tivoli/products/storage-mgr/product-links.html

Installation requirements for backing up and archiving Tivoli StorageManager FastBack client data

Before you can back up or archive your FastBack client data, you must install therequired software.

You must install the following software:v Tivoli Storage Manager FastBack V6.1v Tivoli Storage Manager client V6.1.3.x (where x is 1 or higher) or V6.2 or laterv Tivoli Storage Manager server V6.1.3 or higherv Tivoli Storage Manager Administration Center V6.1.3 Required only if you want to use integrated Tivoli Storage Manager FastBack

- administration.Starting with Tivoli Storage Manager V7.1, the Administration Centercomponent is no longer included in Tivoli Storage Manager distributions.FastBack users who have an Administration Center from a previous serverrelease, can continue to use it to create and modify FastBack schedules. If youdo not already have an Administration Center installed, you can downloadthe previously-released version from ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/LATEST. If you do notalready have an Administration Center installed, you must create and modifyFastBack schedules on the Tivoli Storage Manager server. For informationabout creating schedules on the server, see the Tivoli Storage Manager V7.1server documentation.

The Tivoli Storage Manager FastBack environment must be running. Forinformation about installing and setting up Tivoli Storage Manager FastBack, seeTivoli Storage Manager FastBack Installation and User's Guide, at:http://pic.dhe.ibm.com/infocenter/tsmfbinf/v6

For information about integrating Tivoli Storage Manager and Tivoli StorageManager FastBack, see IBM Tivoli Storage Manager Integration Guide for Tivoli StorageManager FastBack.

You can install Tivoli Storage Manager client in one of the following ways:v Install Tivoli Storage Manager client on a workstation where the FastBack serveris installed. In this case, the prerequisites are: the FastBack server, the FastBackshell, and the FastBack mount.


v Install Tivoli Storage Manager client on a workstation where the FastBack DRHub is installed. In this case, the prerequisites are: the FastBack DisasterRecovery Hub setup, the FastBack shell, and the FastBack mount.

v Install Tivoli Storage Manager client on a workstation where neither theFastBack server or the FastBack Disaster Recovery Hub is installed. In this case,ensure that the FastBack shell and the FastBack mount are installed.

Related concepts:Configuring the client to back up and archive Tivoli Storage Manager FastBackdata on page 62

Client configuration wizard for Tivoli Storage Manager FastBackThe IBM Tivoli Storage Manager Backup-Archive client provides a wizard toconfigure the backup-archive client for Tivoli Storage Manager FastBack.

The wizard is available in a remote application (the Web client) and in a localapplication (the Java GUI). The wizard helps you set the options to send FastBackclient data to the Tivoli Storage Manager server on a scheduled basis.

You can use the Tivoli Storage Manager Client Configuration wizard for TivoliStorage Manager FastBack on 32-bit Windows systems that are supported by bothTivoli Storage Manager and FastBack. The configuration wizard must be installedon the same workstation where the FastBack server resides, or where a FastBackDisaster Recovery Hub is deployed. You can use the client configuration wizard forTivoli Storage Manager FastBack with Tivoli Storage Manager FastBack V5.5.1 orlater versions.Related concepts:Configuring Tivoli Storage Manager to protect FastBack client data on page 63

Installing the Tivoli Storage Manager Windows clientYou can install the Tivoli Storage Manager Windows client from the product DVD,or other installation media.

Before you begin a Tivoli Storage Manager Windows client installation, ensure thatthe system that you want to install the client on meets the client requirements.Then, determine the type of installation that you need to perform, and follow thesteps in the appropriate procedure.

Hardware and software requirements for the Tivoli Storage Manager for WindowsBackup-Archive Client are maintained on the web at http://www.ibm.com/support/docview.wss?uid=swg21197133

Windows client installation might require a rebootAs part of the Windows client installation process, one or more Microsoft C++redistributable packages are installed, if they are not already installed on theWindows workstation. These packages can also be automatically updated by theWindows Update service. If the packages are updated, the update can cause thesystem to reboot when you start the Windows client installation program.

The reboot that is triggered if the C++ redistributable packages are updated canoccur, even under any of the following conditions:v An automatic client deployment pushes a client upgrade to a node, and theclient or the scheduler sets the AUTODEPLOY=NOREBOOT option.


v A manual installation or upgrade of the client is started.v A client silent installation is started, even if the options to suppress rebootprompts, and the client reboot itself, are set.

Additionally, because the Microsoft Visual Studio C++ redistributable package is ashared Windows component, other applications that have dependencies on thepackage might be stopped or restarted by Windows as part of the installation orupgrade of the C++ redistributable package. Schedule client installations andupgrades during a maintenance window when other applications will not beadversely affected if they are stopped or restarted when the C++ redistributablepackage is installed. Monitor other applications after the client is installed to seewhether there are any applications that were stopped and not restarted.

Installation typesThe procedure that you follow to install the Tivoli Storage Manager Version 6.4Windows Backup-Archive Client depends on the type of installation that you wantto perform.

Procedures are provided for each of the following installation types:

Installation type Installation description

Installing the Windows client for the firsttime

Describes how to install the Tivoli StorageManager Windows Backup-Archive Clientfor the first time. This procedure presumesthat the Windows computer that you areinstalling the client on has never had aprevious version of the client installed on itbefore.

Upgrading the Windows client Describes how to upgrade an earlier versionof the Tivoli Storage Manager WindowsBackup-Archive Client to Version 7.1.

Rein

Backup-archive clients documentation

Documents

Transcript of Backup-archive clients documentation