Guide BaClient Win TSM 7.1

IBM Tivoli Storage Manager for Windows Backup-ArchiveClientsVersion 7.1.1

Installation and User's Guide

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

Second edition (September 2014)

This edition applies to version 7, release 1, modification 1 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, 2014.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 . . . . . . . . . . . . . . xiiiConventions used in this publication . . . . . xiiiReading syntax diagrams . . . . . . . . . xiv

New for IBM Tivoli Storage ManagerVersion 7.1.1. . . . . . . . . . . . xvii

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 scheduler . . . . . . . . . 33

Comparison between client acceptor-managedservices and traditional scheduler services . . . 33

Configuring the client to use the client acceptorservice to manage the scheduler . . . . . . 34

Starting the client scheduler . . . . . . . . . 35Scheduling events using the GUI . . . . . . 36

Configuring Tivoli Storage Manager client/servercommunication across a firewall . . . . . . . 36Configuring Tivoli Storage Manager client/servercommunication with Secure Sockets Layer . . . . 39

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

Configuring the journal engine service . . . . 42JournalSettings stanza (Windows) . . . . . 44JournalExcludeList stanza . . . . . . . 46JournaledFileSystemSettings stanza . . . . 46Overriding stanzas . . . . . . . . . . 50

Client-side data deduplication . . . . . . . . 50Configuring the client for data deduplication . . 54Excluding files from data deduplication . . . . 56

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

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

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

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

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

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

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

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

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

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

Register your workstation with a server . . . . . 83Closed registration . . . . . . . . . . . 83Open registration . . . . . . . . . . . 83

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

Exclude file spaces and directories. . . . . 85

Copyright IBM Corp. 1993, 2014 iii

|||

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

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

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

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 . . . . . 102Setup 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 . . . . . . . . . . . . 106Start the client scheduler automatically . . . . . 107Changing your password . . . . . . . . . 107Sorting file lists using the Tivoli Storage ManagerGUI . . . . . . . . . . . . . . . . 109Displaying online help . . . . . . . . . . 110Ending a session . . . . . . . . . . . . 110Online forums . . . . . . . . . . . . . 110

Chapter 4. Backing up your data . . . 113Planning your backups (Windows) . . . . . . 113

Which files are backed up . . . . . . . . . 114Open file support for backup operations . . . . 115Backing up data using the GUI . . . . . . . 117

Specifying drives in your domain. . . . . . 118Backing 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 . . . . . . . . . . . . 124Performing 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) . . . . . . . . . . . 128

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

Incremental-by-date backup . . . . . . . 132Comparing 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 . . . . . . . . 135

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

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

Associate a local snapshot with a server file space(Windows) . . . . . . . . . . . . . . 140Backing up Windows system state . . . . . . 140Backing up Automated System Recovery files . . 142Preparation 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 . . . . . . . 144

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 . . . . . . 146

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

Method 2: Using image backups withincremental-by-date image backups . . . . 147Comparing methods 1 and 2 . . . . . . 148

Performing an image backup using the GUI . . 148Performing an image backup using thecommand line . . . . . . . . . . . . 149

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

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

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

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

Back up virtual machines on a Hyper-V system 169Hyper-V backup support limitations. . . . . 171

Back up and archive Tivoli Storage ManagerFastBack data . . . . . . . . . . . . . 172Backing up Net Appliance CIFS share definitions 173Display backup processing status. . . . . . . 173Backup (Windows): Additional considerations . . 176

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

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

Microsoft Dfs file protection methods . . . . 181

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

Restoring Windows system state . . . . . . . 189Restoring Automated System Recovery files . . . 190Restoring the operating system when the computeris working . . . . . . . . . . . . . . 191

Recovering 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 . . . . . . . . . . . 192

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

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 . . . . . . 200Restoring 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 . . . 208Restoring full VM backups that were createdwith VMware Consolidated Backup . . . . . 211

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 . . . 216Modifying the client acceptor and agent servicesto use the Web client . . . . . . . . . . 216

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

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

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

Snapshot backup or archive with open filesupport . . . . . . . . . . . . . . 230

Contents v

||||||

Archiving 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

Evaluate schedule return codes in schedulescripts . . . . . . . . . . . . . . . 240Return codes from preschedulecmd andpostschedulecmd scripts . . . . . . . . . 241

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

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

Chapter 8. Client return codes . . . . 255

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

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

Select a management class for files . . . . . . 263Assign a management class to files . . . . . . 263Override the management class for archived files 264

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

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

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

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

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

dsmcutil command . . . . . . . . . . . 272Dsmcutil commands: Required options andexamples . . . . . . . . . . . . . . 273Dsmcutil valid options . . . . . . . . . 280

Chapter 11. Processing options . . . 285Processing options overview . . . . . . . . 285Communication options . . . . . . . . . . 286

TCP/IP options . . . . . . . . . . . 286Named Pipes option . . . . . . . . . . 287Shared memory options . . . . . . . . . 287

Server and node options. . . . . . . . . . 287Node options . . . . . . . . . . . . . 288Backup and archive processing options . . . . . 288Restore and retrieve processing options. . . . . 297Scheduling options . . . . . . . . . . . 299Format and language options . . . . . . . . 301Command processing options . . . . . . . . 301Authorization options . . . . . . . . . . 302Error processing options. . . . . . . . . . 302Transaction processing options . . . . . . . 303Web client options. . . . . . . . . . . . 304Diagnostics options . . . . . . . . . . . 304Using options with commands . . . . . . . 304

Entering options with a command . . . . . 305Initial command-line-only options . . . . . 310Client options that can be set by the TivoliStorage Manager server . . . . . . . . . 311

Client options reference . . . . . . . . . . 312Absolute . . . . . . . . . . . . . . 313Adlocation . . . . . . . . . . . . . 314Archmc . . . . . . . . . . . . . . . 314Asnodename . . . . . . . . . . . . . 315Asrmode . . . . . . . . . . . . . . 317Auditlogging . . . . . . . . . . . . 318Auditlogname . . . . . . . . . . . . 320Autodeploy . . . . . . . . . . . . . 322Autofsrename . . . . . . . . . . . . 324Backmc . . . . . . . . . . . . . . . 325Backupsetname . . . . . . . . . . . . 326Basesnapshotname . . . . . . . . . . . 327Casesensitiveaware . . . . . . . . . . 328Changingretries . . . . . . . . . . . 329

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

|||

Class . . . . . . . . . . . . . . . 330Clientview . . . . . . . . . . . . . 331Clusterdisksonly . . . . . . . . . . . 332Clusternode . . . . . . . . . . . . . 334Collocatebyfilespec . . . . . . . . . . 336Commmethod . . . . . . . . . . . . . 337Commrestartduration . . . . . . . . . . 338Commrestartinterval . . . . . . . . . . 338Compressalways . . . . . . . . . . . . 339Compression . . . . . . . . . . . . . 340Console . . . . . . . . . . . . . . 341Createnewbase . . . . . . . . . . . . 343Datacenter . . . . . . . . . . . . . 344Datastore . . . . . . . . . . . . . 345Dateformat . . . . . . . . . . . . . 345Dedupcachepath . . . . . . . . . . . . 347Dedupcachesize . . . . . . . . . . . . 348Deduplication . . . . . . . . . . . . 349Deletefiles . . . . . . . . . . . . . 350Description . . . . . . . . . . . . . 350Detail . . . . . . . . . . . . . . . 352Diffsnapshot . . . . . . . . . . . . 353Diffsnapshotname . . . . . . . . . . . 354Dirmc . . . . . . . . . . . . . . . 355Dirsonly . . . . . . . . . . . . . . 356Disablenqr . . . . . . . . . . . . . 357Diskbuffsize . . . . . . . . . . . . 358Diskcachelocation . . . . . . . . . . 359Domain . . . . . . . . . . . . . . . 360Domain.image . . . . . . . . . . . . 363Domain.nas . . . . . . . . . . . . . 363Domain.vcd . . . . . . . . . . . . . 365Domain.vmfile . . . . . . . . . . . . 366Domain.vmfull . . . . . . . . . . . . 369Enable8dot3namesupport . . . . . . . . . 375Enablearchiveretentionprotection . . . . . 376Enablededupcache . . . . . . . . . . . 377Enablelanfree . . . . . . . . . . . . 378Encryptiontype . . . . . . . . . . . . 379Encryptkey . . . . . . . . . . . . . 380Errorlogmax . . . . . . . . . . . . . 382Errorlogname . . . . . . . . . . . . 384Errorlogretention . . . . . . . . . . 384Exclude options . . . . . . . . . . . 386

Controlling compression processing . . . . 389Adaptive subfile backup processing . . . . 390Processing NAS file systems . . . . . . 390Virtual machine exclude options . . . . . 391

Fbbranch . . . . . . . . . . . . . . 392Fbclientname . . . . . . . . . . . . 393Fbpolicyname . . . . . . . . . . . . 395Fbreposlocation . . . . . . . . . . . 396Fbserver . . . . . . . . . . . . . . 398Fbvolumename . . . . . . . . . . . . 399Filelist . . . . . . . . . . . . . . 400Filename . . . . . . . . . . . . . . 403Filesonly . . . . . . . . . . . . . 404Forcefailover . . . . . . . . . . . . 405Fromdate . . . . . . . . . . . . . . 406Fromnode . . . . . . . . . . . . . . 407Fromtime . . . . . . . . . . . . . . 407

Groupname . . . . . . . . . . . . . 408Guitreeviewafterbackup . . . . . . . . . 409Host . . . . . . . . . . . . . . . 409Httpport . . . . . . . . . . . . . . 410Hsmreparsetag . . . . . . . . . . . . 410Ieobjtype . . . . . . . . . . . . . 411Ifnewer . . . . . . . . . . . . . . 412Imagegapsize . . . . . . . . . . . . 413Imagetofile . . . . . . . . . . . . . 414Inactive . . . . . . . . . . . . . . 415Inclexcl . . . . . . . . . . . . . . 415

Considerations for Unicode-enabled clients 416Include options. . . . . . . . . . . . 417

Compression, encryption, and adaptivesubfile backup processing . . . . . . . 422Processing NAS file systems . . . . . . 422Virtual machine include options . . . . . 423

Incrbydate . . . . . . . . . . . . . 430Incremental . . . . . . . . . . . . . 431Incrthreshold . . . . . . . . . . . . 431Journalpipe . . . . . . . . . . . . . 432Lanfreecommmethod . . . . . . . . . . 433Lanfreeshmport . . . . . . . . . . . . 434Lanfreetcpport . . . . . . . . . . . . 435Lanfreessl . . . . . . . . . . . . . 436Lanfreetcpserveraddress . . . . . . . . 436Language . . . . . . . . . . . . . . 437Latest . . . . . . . . . . . . . . . 438Localbackupset . . . . . . . . . . . . 439Managedservices . . . . . . . . . . . 440Maxcmdretries . . . . . . . . . . . . 441Mbobjrefreshthresh . . . . . . . . . . 442Mbpctrefreshthresh . . . . . . . . . . 443Memoryefficientbackup . . . . . . . . . 444Mode . . . . . . . . . . . . . . . 445Monitor . . . . . . . . . . . . . . 450Myprimaryserver . . . . . . . . . . . 451Myreplicationserver . . . . . . . . . . 452Namedpipename . . . . . . . . . . . . 453Nasnodename . . . . . . . . . . . . . 454Nodename . . . . . . . . . . . . . . 455Nojournal . . . . . . . . . . . . . 456Noprompt . . . . . . . . . . . . . . 457Nrtablepath . . . . . . . . . . . . . 457Numberformat . . . . . . . . . . . . 458Optfile . . . . . . . . . . . . . . 460Password . . . . . . . . . . . . . . 460Passwordaccess . . . . . . . . . . . . 462Pick . . . . . . . . . . . . . . . 464Pitdate . . . . . . . . . . . . . . 465Pittime . . . . . . . . . . . . . . 466Postschedulecmd/Postnschedulecmd . . . . . 466Postsnapshotcmd . . . . . . . . . . . 468Preschedulecmd/Prenschedulecmd . . . . . 470Preservelastaccessdate . . . . . . . . . 471Preservepath . . . . . . . . . . . . 472Presnapshotcmd . . . . . . . . . . . . 474Queryschedperiod . . . . . . . . . . . 476Querysummary . . . . . . . . . . . . 477Quiet . . . . . . . . . . . . . . . 479Quotesareliteral . . . . . . . . . . . 479

Contents vii

||

||

||

||

Replace . . . . . . . . . . . . . . 481Replserverguid . . . . . . . . . . . . 482Replservername . . . . . . . . . . . . 483Replsslport . . . . . . . . . . . . . 485Repltcpport . . . . . . . . . . . . . 486Repltcpserveraddress . . . . . . . . . 487Resetarchiveattribute . . . . . . . . . 489Resourceutilization . . . . . . . . . . 490

Regulating backup and archive sessions . . 491Regulating restore sessions . . . . . . . 492Multiple client session considerations . . . 492

Retryperiod . . . . . . . . . . . . . 493Revokeremoteaccess . . . . . . . . . . 494Runasservice . . . . . . . . . . . . 494Schedcmddisabled . . . . . . . . . . . 495Schedcmdexception . . . . . . . . . . 496Schedlogmax . . . . . . . . . . . . . 497Schedlogname . . . . . . . . . . . . 499Schedlogretention . . . . . . . . . . 500Schedmode . . . . . . . . . . . . . 502Schedrestretrdisabled . . . . . . . . . 503Scrolllines . . . . . . . . . . . . . 504Scrollprompt . . . . . . . . . . . . 505Sessioninitiation . . . . . . . . . . 506Shmport . . . . . . . . . . . . . . 508Showmembers . . . . . . . . . . . . . 508Skipmissingsyswfiles . . . . . . . . . 509Skipntpermissions . . . . . . . . . . 510Skipntsecuritycrc . . . . . . . . . . 511Snapdiff . . . . . . . . . . . . . . 511Snapdiffhttps . . . . . . . . . . . . 516Snapshotproviderfs . . . . . . . . . . 518Snapshotproviderimage . . . . . . . . . 519Snapshotroot . . . . . . . . . . . . 520Srvoptsetencryptiondisabled . . . . . . . 522Srvprepostscheddisabled . . . . . . . . 523Srvprepostsnapdisabled . . . . . . . . . 524Ssl . . . . . . . . . . . . . . . . 525Sslfipsmode . . . . . . . . . . . . . 526Sslrequired . . . . . . . . . . . . . 527Ssldisablelegacytls . . . . . . . . . . 528Stagingdirectory . . . . . . . . . . . 529Subdir . . . . . . . . . . . . . . . 530Subfilebackup . . . . . . . . . . . . 532Subfilecachepath . . . . . . . . . . . 533Subfilecachesize . . . . . . . . . . . 534Systemstatebackupmethod . . . . . . . . 534Tapeprompt . . . . . . . . . . . . . 536Tcpadminport . . . . . . . . . . . . 537Tcpbuffsize . . . . . . . . . . . . . 538Tcpcadaddress . . . . . . . . . . . . 539Tcpclientaddress . . . . . . . . . . . 539Tcpclientport . . . . . . . . . . . . 540Tcpnodelay . . . . . . . . . . . . . 541Tcpport . . . . . . . . . . . . . . 542Tcpserveraddress . . . . . . . . . . . 542Tcpwindowsize . . . . . . . . . . . . 543Timeformat . . . . . . . . . . . . . 544Toc . . . . . . . . . . . . . . . . 546Todate . . . . . . . . . . . . . . . 547Totime . . . . . . . . . . . . . . . 548

Txnbytelimit . . . . . . . . . . . . 549Type . . . . . . . . . . . . . . . 550Usedirectory . . . . . . . . . . . . 550Useexistingbase . . . . . . . . . . . 551Usereplicationfailover . . . . . . . . . 552V2archive . . . . . . . . . . . . . 553Vappmc . . . . . . . . . . . . . . . 554Vcdhost . . . . . . . . . . . . . . 555Vcdpw . . . . . . . . . . . . . . . 555Vcduser . . . . . . . . . . . . . . 556Verbose . . . . . . . . . . . . . . 557Verifyimage . . . . . . . . . . . . . 558Virtualfsname . . . . . . . . . . . . 558Virtualnodename . . . . . . . . . . . 559Vmautostartvm . . . . . . . . . . . . 560Vmbackdir . . . . . . . . . . . . . 561Vmbacknodelete . . . . . . . . . . . . 562Vmbackuptype . . . . . . . . . . . . 563Vmmc . . . . . . . . . . . . . . . 564Vmbackvcbtransport . . . . . . . . . . 565Vmchost . . . . . . . . . . . . . . 566Vmcpw . . . . . . . . . . . . . . . 567Vmctlmc . . . . . . . . . . . . . . 567Vmcuser . . . . . . . . . . . . . . 569Vmdiskprovision . . . . . . . . . . . 569Vmenabletemplatebackups . . . . . . . . 570Vmexpireprotect . . . . . . . . . . . 572Vmiscsiadapter . . . . . . . . . . . . 573Vmiscsiserveraddress . . . . . . . . . 574Vmlimitperdatastore . . . . . . . . . . 574Vmlimitperhost . . . . . . . . . . . . 575Vmlist . . . . . . . . . . . . . . . 576Vmmaxparallel . . . . . . . . . . . . 577Vmmountage . . . . . . . . . . . . . 578Vmnoprdmdisks . . . . . . . . . . . . 579Vmprocessvmwithindependent . . . . . . . 580Vmprocessvmwithprdm . . . . . . . . . . 581Vmrestoretype . . . . . . . . . . . . 582Vmskipctlcompression . . . . . . . . . 585Vmskipmaxvmdks. . . . . . . . . . . 585Vmstoragetype . . . . . . . . . . . . 586Vmtempdatastore . . . . . . . . . . . 587Vmvstortransport . . . . . . . . . . . 588Vssaltstagingdir . . . . . . . . . . . 589Vssusesystemprovider . . . . . . . . . 590Vmtimeout . . . . . . . . . . . . . 591Webports . . . . . . . . . . . . . . 591Wildcardsareliteral . . . . . . . . . . 592

Chapter 12. Using commands . . . . 595Start and end a client command session . . . . 598

Process commands in batch mode . . . . . 598Process commands in interactive mode . . . . 599

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

Command name . . . . . . . . . . . 599Options . . . . . . . . . . . . . . 600

Options in interactive mode . . . . . . 600Parameters . . . . . . . . . . . . . 600File specification syntax . . . . . . . . . 601

Wildcard characters . . . . . . . . . . . 602

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

||

||||||

||

||||

||||||

||||

||

Client commands reference . . . . . . . . . 603Archive . . . . . . . . . . . . . . . 603

Open file support . . . . . . . . . . . 605Archive FastBack . . . . . . . . . . . . 606Backup FastBack . . . . . . . . . . . . 609Backup Group . . . . . . . . . . . . . 611Backup Image . . . . . . . . . . . . . 614

Offline and online image backup . . . . . . 616Utilizing image backup to perform file systemincremental backup . . . . . . . . . . 617

Backup NAS . . . . . . . . . . . . . 618Backup Systemstate . . . . . . . . . . . 620Backup VAPP . . . . . . . . . . . . . 622Backup VM . . . . . . . . . . . . . . 627Cancel Process . . . . . . . . . . . . . 637Cancel Restore . . . . . . . . . . . . . 638Delete Access . . . . . . . . . . . . . 639Delete Archive . . . . . . . . . . . . . 639Delete Backup . . . . . . . . . . . . . 641Delete Filespace . . . . . . . . . . . . 645Delete Group . . . . . . . . . . . . . 646Expire . . . . . . . . . . . . . . . . 647Help . . . . . . . . . . . . . . . . 649Incremental . . . . . . . . . . . . . . 650

Open file support . . . . . . . . . . . 654Journal-based backup. . . . . . . . . . 655Backing up NTFS or ReFS volume mount points 656

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

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

Loop . . . . . . . . . . . . . . . . 658Macro . . . . . . . . . . . . . . . . 659Monitor Process . . . . . . . . . . . . 660Preview Archive . . . . . . . . . . . . 661Preview Backup . . . . . . . . . . . . 662Query Access . . . . . . . . . . . . . 663Query Adobjects . . . . . . . . . . . . 663Query Archive . . . . . . . . . . . . . 665Query Backup . . . . . . . . . . . . . 667

Query NAS file system images . . . . . . 670Query Backupset . . . . . . . . . . . . 671

Query Backupset without the backupsetnameparameter . . . . . . . . . . . . . 672

Query Filespace . . . . . . . . . . . . 674Query NAS file spaces . . . . . . . . . 676

Query Group . . . . . . . . . . . . . 676Query Image . . . . . . . . . . . . . 678Query Inclexcl . . . . . . . . . . . . . 679Query Mgmtclass . . . . . . . . . . . . 681Query Node. . . . . . . . . . . . . . 682Query Options . . . . . . . . . . . . . 683Query Restore . . . . . . . . . . . . . 684Query Schedule . . . . . . . . . . . . 685

Query Session . . . . . . . . . . . . . 685Query Systeminfo . . . . . . . . . . . 686Query Systemstate . . . . . . . . . . . 688Query VAPP . . . . . . . . . . . . . 689Query VM . . . . . . . . . . . . . . 693Restart Restore . . . . . . . . . . . . . 697Restore . . . . . . . . . . . . . . . 698

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

Restore Microsoft Dfs junctions . . . . . . 704Restore active files. . . . . . . . . . . 704Universal Naming Convention restores . . . . 704Restore from file spaces that are notUnicode-enabled . . . . . . . . . . . 705Restore named streams . . . . . . . . . 705Restore sparse files . . . . . . . . . . 705

Restore Adobjects. . . . . . . . . . . . 706Restore Backupset . . . . . . . . . . . 707

Restore backup sets: considerations andrestrictions . . . . . . . . . . . . . 710Restore backup sets in a SAN environment . . 711Restore Backupset without the backupsetnameparameter . . . . . . . . . . . . . 712

Restore Group . . . . . . . . . . . . . 714Restore Image . . . . . . . . . . . . . 716Restore NAS . . . . . . . . . . . . . 719Restore Systemstate . . . . . . . . . . . 721Restore VAPP . . . . . . . . . . . . . 723Restore VM . . . . . . . . . . . . . . 726Retrieve . . . . . . . . . . . . . . . 734

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

Schedule . . . . . . . . . . . . . . . 738Selective . . . . . . . . . . . . . . . 739

Open file support . . . . . . . . . . . 742Adaptive subfile backups . . . . . . . . 742Associate a local snapshot with a server filespace . . . . . . . . . . . . . . . 743

Set Access . . . . . . . . . . . . . . 743Set Event. . . . . . . . . . . . . . . 746Set password . . . . . . . . . . . . . 748

Appendix. Accessibility features forthe Tivoli Storage Manager productfamily. . . . . . . . . . . . . . . 755

Notices . . . . . . . . . . . . . . 757Trademarks . . . . . . . . . . . . . . 759Privacy policy considerations . . . . . . . . 759

Glossary . . . . . . . . . . . . . 761

Index . . . . . . . . . . . . . . . 763

Contents ix

||

||

||

||

||

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

Tables1. Windows client communication methods . . . 62. Supported features on Windows platforms 73. Stoppable services . . . . . . . . . . 154. Client acceptor-managed services versus

traditional scheduler services. . . . . . . 335. Data deduplication settings: Client and server 536. Options for excluding file spaces and

directories . . . . . . . . . . . . . 867. Options for controlling processing using

include and exclude statements . . . . . . 878. Wildcard and other special characters . . . . 909. Specifying a drive specification using

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

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

encryption processing . . . . . . . . . 9212. UNC name patterns and DOS patterns 9613. Required user security rights for Tivoli Storage

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

Storage Manager GUI . . . . . . . . . 10915. Planning your backups . . . . . . . . 11316. Command line backup examples . . . . . 11817. Maximum file size . . . . . . . . . . 12718. Comparing incremental image backup

methods . . . . . . . . . . . . . 14819. NAS options and commands . . . . . . 15220. Backup and restore capabilities for VMware

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

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

22. Client command line informational messages 17323. UNC examples . . . . . . . . . . . 18024. Command-line restore examples . . . . . 18525. Backup set GUI restore restrictions . . . . 19626. Backup set command-line restore restrictions 19727. Components for the restore command when

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

you restore files to a different computer. . . 21029. NAS options and commands . . . . . . 22630. Command-line archive examples . . . . . 23131. Command line examples of retrieving

archives . . . . . . . . . . . . . 23532. Sample classic query schedule output 24533. Sample enhanced query schedule output 24634. Client return codes and their meanings 25535. Default attribute values in the standard

management class . . . . . . . . . . 25936. TCP/IP options . . . . . . . . . . . 28637. Named Pipes communication option 28738. Shared memory communication options 28739. Server and node options . . . . . . . . 28740. Node options . . . . . . . . . . . 288

41. Backup and archive processing options 28842. Restore and retrieve processing options 29743. Scheduling options. . . . . . . . . . 29944. Format and language options . . . . . . 30145. Command processing options . . . . . . 30146. Authorization options. . . . . . . . . 30247. Error processing options . . . . . . . . 30248. Transaction processing options . . . . . . 30349. Web client options . . . . . . . . . . 30450. Diagnostics options . . . . . . . . . 30451. Client command options . . . . . . . . 30652. Options that are valid on the initial command

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

Manager server . . . . . . . . . . . 31254. Setting the value of the asnodename option to

distribute backups.. . . . . . . . . . 31555. Clusternode and clusterdisksonly

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

sources. . . . . . . . . . . . . . 36257. System services components and

corresponding keywords . . . . . . . . 38858. Other optional parameters . . . . . . . 42059. Incremental command: Related options 51360. Effects of server and client SSL settings on

success or failure of login attempts . . . . 52861. Commands . . . . . . . . . . . . 59562. Wildcard characters . . . . . . . . . 60263. Archive command: Related options . . . . 60464. Archive FastBack command: Related options 60765. Backup FastBack command: Related options 61066. Backup Group command: Related options 61367. Backup Image command: Related options 61568. Backup NAS command: Related options 62069. Backup VAPP command: Related options 62470. Delete Archive command: Related options 64071. Delete Backup command: Related options 64372. Delete Filespace command: Related options 64573. Delete Group command: Related options 64774. Expire command: Related options. . . . . 64875. Incremental command: Related options 65276. Query Adobjects command: Related options 66477. Query Archive command: Related options 66678. Query Backup command: Related options 66979. Query Backupset command: Related options 67280. Query Backupset command: Related options 67381. Query Filespace command: Related options 67582. Query Group command: Related options 67783. Query Image command: Related options 67984. Query Mgmtclass command: Related options 68285. Query Node command: Related options 68386. Query Options command: Related options 68387. Query Systeminfo command: Related options 68888. Query Systemstate command: Related options 68889. Restore VAPP command: Related options 691

Copyright IBM Corp. 1993, 2014 xi

||

||

90. Query VM command: Related options forVMware virtual machine queries. . . . . . 694

91. Query VM command: Related options forHyper-V virtual machine queries. . . . . . 696

92. Restore command: Related options . . . . 70193. Restore Adobjects command: Related options 70694. Restore Backupset command: Related options 70995. Restore Group command: Related options 71596. Restore Image command: Related options 71897. Restore NAS command: Related options 720

98. Restore Systemstate command: Relatedoptions . . . . . . . . . . . . . 722

99. Restore VAPP command: Related options 725100. Restore VM command: Related options when

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

restoring Hyper-V virtual machines . . . . 732102. Retrieve command: Related options . . . . 735103. Schedule command: Related options . . . . 739104. Selective command: Related options . . . . 741

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.

PublicationsThe 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 view IBM product documentation, see http://www.ibm.com/support/knowledgecenter/.

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.

Copyright IBM Corp. 1993, 2014 xiii

Example Description

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 , Commav = Equal Signv - Hyphenv () Parenthesesv . Periodv Spacev " quotation markv 'single quotation mark

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

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.

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.

About this publication xv

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

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

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

Changed and new information is indicated by a vertical bar (|) to the left of thechange. Ensure that you are using the correct edition for the level of the product.

Windows Backup-archive client and API support for Windows Server 2012 R2and Windows 8.1

New Windows Backup-Archive Client and API support that is introducedfor Windows Server 2012 R2 and Windows 8.1.

For more information, see http://www.ibm.com/support/docview.wss?uid=swg21197133.

Enhanced support for Microsoft Hyper-V virtual machinesEnhanced support for Microsoft Hyper-V configurations is provided. Youmust be licensed to use Tivoli Storage Manager for Virtual Environments:Data Protection for Microsoft Hyper-V to use the enhancements. Theseenhancements apply only to Windows clients in Hyper-V Windows Server2012 or 2012 R2 environments. The enhancements provide the followingcapabilities:

More efficient backups and restores.You can use incremental-forever backup modes to back upHyper-V virtual machines. Specifically, you can use either of thefollowing modes:v Incremental-forever-incremental mode, which shortens backuptimes by backing up only the blocks of a virtual machines disksthat changed since the last backup.

v Incremental-forever-full mode, which backs up all the used diskblocks on a virtual machine.

v You can also now use two client options (mbobjrefreshthresh ormbpctrefreshthresh) to optimize the storage of virtual machinebackups in the Tivoli Storage Manager database.

v Parallel backups are possible, by using the vmmaxparallel option.For more information about these options:v Backup VM on page 627v Mode on page 445v Mbobjrefreshthresh on page 442v Mbpctrefreshthresh on page 443v Vmmaxparallel on page 577

Other commands and options for Hyper-V virtual machines.More backup-archive client commands and options were modifiedfor use during backup and restore operations for Hyper-V virtualmachines. You must be licensed to use Tivoli Storage Manager forVirtual Environments: Data Protection for Microsoft Hyper-V touse these enhancements. For additional information:v Domain.vmfull on page 369v Include.vm on page 425

Copyright IBM Corp. 1993, 2014 xvii

|

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

v Vmbackuptype on page 563v Vmlist on page 576v Vmrestoretype on page 582v Vmmc on page 564v Vmctlmc on page 567v Backup VM on page 627v Query VM on page 693v Restore VM on page 726

File-level recovery for Hyper-V virtual machines.As in earlier versions, you can use the backup-archive client torestore entire virtual machines. You can now also recoverindividual files for a virtual machine, by using the Tivoli StorageManager recovery agent. File-level recovery requires a TivoliStorage Manager for Virtual Environments: Data Protection forMicrosoft Hyper-V license.

Restore a Hyper-V virtual machine to an alternative path or host.You can use the backup-archive client that is installed on aHyper-V host to restore backed-up virtual machines. You canrestore them to the same host and location that they occupiedbefore they were backed up, or you can restore them to a differentHyper-V host. The virtual machine configuration must becompatible with the alternative Hyper-V host operating system andconfiguration.

Protection for Hyper-V virtual machines on remote file shares.You can now back up and restore Hyper-V guests that exist on aremote file share. The file share must be on a Windows Server2012, or newer, Windows Server operating system.

AES 256-bit encryption added as an available encryption type in thebackup-archive client and the API.

AES 256-bit encryption added as an available encryption type in thebackup-archive client and the API. AES 256-bit encryption is used toencrypt data that is sent to the Tivoli Storage Manager server. AES-256encryption is used as a more secure algorithm for data encryption, whichcan be used to encrypt data that you back up, archive, restore, or retrieve.

New client option to lock virtual machine snapshots so they cannot be expired.The vmexpireprotect can be used to lock snapshots on the server. Whenlocked, a snapshot cannot be expired if another snapshot is added to thesnapshot sequence. This option can be used during instant restore andinstant access operations, for VMware virtual machines, or when youperform file-level restore operations for Microsoft Hyper-V virtualmachines by using the Tivoli Storage Manager recovery agent. For adescription of the option and its settings, see Vmexpireprotect on page572.

This option is available only if you have a license to use either TivoliStorage Manager for Virtual Environments: Data Protection for VMware orTivoli Storage Manager for Virtual Environments: Data Protection forMicrosoft Hyper-V.

Added option to disable security protocols that are lower than TLS 1.2.In order to comply with new US federal requirements for newcryptographic standards, the ability to restrict SSL protocols to TLS 1.2 orabove is available. If you want to disable security protocols that are lower

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

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

than TLS 1.2, add the SSLDISABLELEGACYtls yes option to the client optionsfile or select Require TLS 1.2 or above in the backup-archive client GUI.Selecting this check box can prevent spoofing attacks by maliciousprograms that accept lower-level protocol connections even if the TivoliStorage Manager server does not.

What's new xix

|||||

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.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, 2014 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 322

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 1. 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 2 shows the supported and unsupported features on the various Windowsplatforms.

Table 2. 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 serverdocumentation.

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://www.ibm.com/support/knowledgecenter/SS9NU9

For information about integrating Tivoli Storage Manager and Tivoli StorageManager FastBack, see the IBM Tivoli Storage Manager Integration Guide for TivoliStorage Manager 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 63

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 64

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.1.

Reinstalling the Windows client Describes how to reinstall the Version 7.1.1Windows client if you uninstalled it.

Silent installation Describes how to install the Version 7.1.1client silently, without user interactionduring the installation procedure.

Repairing, modifying, or uninstalling theWindows client

Describes how to add or remove featuresfrom an installed client (modify), replacedamaged files or missing registry keys(repair) or uninstall the Windows client.

Installing the Windows client for the first timeComplete this procedure to install the Tivoli Storage Manager Windowsbackup-archive client for the first time.

If you have an earlier version of the Tivoli Storage Manager Windowsbackup-archive client that is already installed on a node and you want to upgradeit to version 7.1.1, see Upgrading the Windows client on page 14.

Important: You must know the host name or IP address of the Tivoli StorageManager server, the port number that the server listens on for clientcommunications, and the communications method to use when the clientcommunicates with the server. Obtain this information from your Tivoli StorageManager server administrator before you start this procedure.


1. Install the product by using the installation DVD or by using the compressedinstallation file that you download from IBM.

Option Description

Install from a DVD 1. Insert the DVD into the DVD drive.2. If the installation program does not

automatically start, browse the DVD tolocate the setup.exe file. Double-click thesetup.exe file.

Install by using a compressed installationfile

1. The Tivoli Storage Manager version 7.1.1release notes contain a link to adocument that describes how todownload the Windows backup-archiveclient distribution package from the IBMPassport Advantage website. Follow thedirections in that document to obtain therequired files.

2. Copy the compressed installation file thatyou downloaded from PassportAdvantage a local disk or to anetwork-accessible share.

3. Double-click the compressed installationfile.

4. Specify a directory location for theuncompressed files and click Next. Bydefault, this directory is the current diskdrive, in drive:\tsm_images\TSM_BA_Client directory. If theinstallation program detects files fromanother client installation attempt in thisdirectory, you are prompted to determinewhether you want to overwrite the oldfiles. If you receive this prompt, selectYes to All to overwrite the existing files;this selection ensures that only the filesfrom the current installation are used.

2. Select a language to use for this installation and click OK.3. If the installation wizard indicates that one or more Microsoft C++

redistributable files must be installed, click Install. These files are needed torun the Windows client.

4. On the Tivoli Storage Manager client welcome screen, click Next to begininstalling the client software.

5. Accept the default installation directory by clicking Next, or specify a differentinstallation directory. The default installation directory is C:\ProgramFiles\Tivoli\TSM.

6. Select the installation type: Typical or Custom.


Option Description

Typical A typical installation installs the followingcomponents:

v The backup-archive client GUI files(needed to use the Java GUI)

v The backup-archive client web files(needed to use the web client)

v The client API files (as needed by yourclient and operating system)

Custom A custom installation installs the same filesas a typical installation. However, you canchoose to install the following optionalcomponents:

v The API SDK files (only needed if you aredeveloping applications that work withthe Tivoli Storage Managerbackup-archive client

v The Administrative Client command-linefiles (required to remotely runadministrator functions on the TivoliStorage Manager server

v VMware vStorage API runtime files(needed if you are using this client toback up VMware virtual machines)

7. Click Next, then click Install.8. When the installer completes the installation, click Finish.9. Verify the installation. Click Start > All Programs > Tivoli Storage Manager.

The client components that you installed are shown in the list of TivoliStorage Manager startable programs. The administrative command-line client,backup-archive command-line client, and the backup-archive GUI are the onlycomponents that are displayed in this list. The administrative command-lineclient is only shown if you perform a custom installation and you include theadministrative command-line client. If you installed other components, suchas the API, SDK, or VMware vStorage API runtime files, they are not shownin this list.

10. Click Backup-Archive GUI to start the client GUI. The TSM Client OptionsFile Configuration Wizard starts. Click Next to start the wizard.

11. On the Options File Task screen, select Create a new options file and clickNext.

12. On the TSM Node Name screen, specify a node name. A node name uniquelyidentifies your node to the Tivoli Storage Manager server. The default nodename is the short host name of the Windows computer that you are installingthe client on. Accept the default node name or specify a new node name.Click Next.

13. On the TSM Client/Server Communications screen, specify thecommunications method to use when the client communicates with the serverand click Next. This information must be provided to you by your TivoliStorage Manager administrator. If you are not sure what to select, accept thedefault setting (TCP/IP). If the default setting does not work when the clientattempts to connect to the server, contact the Tivoli Storage Manager serveradministrator to determine which communications method to specify.


14. On the TCP/IP Options screen, specify the server address and portinformation that your Tivoli Storage Manager administrator provided to you.In the Server Address field, specify the IP address or host name of the TivoliStorage Manager server. In the Port Number field, specify the port numberthat the server listens on for client communications. Click Next.

15. The Recommended Include/Exclude List screen contains a list of system filesand directories that are typically included, or excluded from client operations.The excluded files are typicall

Documents

Guide BaClient Win TSM 7.1