IBM Tivoli Storage Manager for UNIX and LinuxBackup-Archive ClientsVersion 7.1.3

Installation and User's Guide

IBM

IBM Tivoli Storage Manager for UNIX and LinuxBackup-Archive ClientsVersion 7.1.3

Installation and User's Guide

IBM

Note:Before you use this information and the product it supports, read the information in Notices on page 705.

Fifth edition (September 2015)

This edition applies to version 7, release 1, modification 3 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, 2015.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Tables . . . . . . . . . . . . . .. xi

About this publication . . . . . . .. xiiiWho should read this publication. . . . . .. xiiiPublications . . . . . . . . . . . . .. xivConventions used in this publication . . . .. xivReading syntax diagrams . . . . . . . .. xiv

New for Tivoli Storage ManagerVersion 7.1.3. . . . . . . . . . .. xvii

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

Upgrade path for clients and servers . . . .. 1Additional upgrade information . . . . . .. 1Automatic backup-archive client deployment .. 2

Client environment requirements . . . . . .. 4AIX client environment . . . . . . . . .. 4

AIX client installable components . . . .. 5System requirements for the AIX client . .. 5AIX client communication methods . . . .. 5Backup-archive client features that are availableon AIX . . . . . . . . . . . . .. 5

HP-UX Itanium 2 client environment . . . .. 6HP-UX Itanium 2 client installable components 6System requirements for HP-UX Itanium 2clients . . . . . . . . . . . . .. 6HP-UX Itanium 2 client communicationmethods . . . . . . . . . . . . .. 6

Linux on POWER client environment . . . .. 6Linux on POWER client installable components 6System requirements for Linux on Powerclients . . . . . . . . . . . . .. 7Linux on Power Systems client communicationmethods . . . . . . . . . . . . .. 7

Linux x86_64 client environment. . . . . .. 7Linux x86_64 client installable components .. 7System requirements for Linux x86_64 clients . 7Linux x86_64 client communication methods . 8

Linux on System z client environment . . . .. 8Linux on System z client installablecomponents. . . . . . . . . . . .. 8System requirements for Linux on System zclients . . . . . . . . . . . . .. 8Linux on System z client communicationmethods . . . . . . . . . . . . .. 8

Mac OS X client environment . . . . . . .. 9Mac OS X client installable components . .. 9System requirements for Mac OS X clients .. 9Mac OS X client communication methods. .. 9

Oracle Solaris client environment . . . . .. 10Oracle Solaris client installable components.. 10System requirements for Oracle Solaris clients 10

Oracle Solaris client communication methods 10NDMP support requirements (Extended Editiononly) . . . . . . . . . . . . . . .. 10Installation requirements for backing up andarchiving Tivoli Storage Manager FastBack clientdata . . . . . . . . . . . . . . . .. 11Installing the backup-archive client from the TivoliStorage Manager DVDs . . . . . . . . .. 12Install the UNIX and Linux backup-archive clients 12

Installing the Tivoli Storage Manager AIX client 13Uninstalling the Tivoli Storage Manager AIXclient . . . . . . . . . . . . . .. 15Installing the Tivoli Storage Manager HP-UXItanium 2 client . . . . . . . . . . .. 16

Increasing the default limit of the datasegment size . . . . . . . . . . .. 18

Uninstalling the Tivoli Storage Manager HP-UXItanium 2 client . . . . . . . . . . .. 18Installing the Tivoli Storage Managerbackup-archive client on Linux on PowerSystems . . . . . . . . . . . . .. 19Uninstalling the Tivoli Storage Manager Linux onPower client . . . . . . . . . . . .. 22Installing the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . .. 23Uninstalling the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . .. 26Installing the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . .. 27Uninstalling the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . .. 30Installing the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . .. 31Uninstalling the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . .. 34Installing the Tivoli Storage Manager Mac OS Xclient . . . . . . . . . . . . . .. 35Uninstalling the Tivoli Storage Manager Mac OSX client . . . . . . . . . . . . . .. 36Installing the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . .. 37Uninstalling the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . .. 39Software updates . . . . . . . . . .. 40

Installing the client management service to collectdiagnostic information. . . . . . . . . .. 40

Chapter 2. Configure the Tivoli StorageManager client . . . . . . . . . .. 41UNIX and Linux client root and authorized usertasks. . . . . . . . . . . . . . . .. 41Enable non-administrators to manage their owndata . . . . . . . . . . . . . . . .. 43

Restricting Tivoli Storage Manager access to auser group. . . . . . . . . . . . .. 44

Copyright IBM Corp. 1993, 2015 iii

|||

Enabling encryption for Tivoli Storage Managerclient users . . . . . . . . . . . .. 44

Client options file overview . . . . . . . .. 45Creating and modifying the client system-optionsfile . . . . . . . . . . . . . . .. 47Creating a default client-user options file . .. 48Creating a customized client user-options file .. 50

Environment variables. . . . . . . . . .. 51Set language environment variables . . . .. 51Set processing environment variables . . . .. 52Set Bourne and Korn shell variables . . . .. 54Set C shell variables . . . . . . . . .. 54Set API environment variables . . . . . .. 54

Web client configuration overview. . . . . .. 55Configuring the web client on AIX, HP-UX,Linux, Mac, and Solaris systems . . . . .. 55

Configuring the scheduler . . . . . . . .. 56Comparison between client acceptor-managedservices and traditional scheduler services . .. 56Configuring the client to use the client acceptorservice to manage the scheduler . . . . .. 57

Start the client scheduler . . . . . . . . .. 58Scheduling events using the command-line client 58

Configuring Tivoli Storage Manager client/servercommunication across a firewall . . . . . .. 61Configuring Tivoli Storage Manager client/servercommunication with Secure Sockets Layer . . .. 63

Certificate Authorities root certificates . . .. 65Configure your system for journal-based backup .. 66

Journal daemon configuration . . . . . .. 66JournalSettings stanza . . . . . . . .. 68JournalExcludeList stanza . . . . . .. 68JournaledFileSystemSettings stanza . . .. 69Overriding stanzas . . . . . . . . .. 72

Client-side data deduplication . . . . . . .. 72Configuring the client for data deduplication .. 76Excluding files from data deduplication . . .. 78

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

Requirements for automated client failover .. 80Restrictions for automated client failover .. 81Failover capabilities of Tivoli Storage Managercomponents . . . . . . . . . . .. 82

Configuring the client for automated failover .. 82Determining the status of replicated client data 84Preventing automated client failover . . . .. 85Forcing the client to fail over . . . . . .. 86

Configuring the client to back up and archive TivoliStorage Manager FastBack data . . . . . . .. 86Cluster environment configuration and use . . .. 87

Overview of cluster environments . . . . .. 88Active/Active: Pool cluster resources . . .. 88Active/Passive: Fault tolerant . . . . .. 88Concurrent access . . . . . . . . .. 88

Configuring the backup-archive client in a clusterenvironment . . . . . . . . . . . .. 88Enabling Tivoli Storage Manager web clientaccess in a Cluster Environment . . . . .. 94Migrating legacy AIX IBM PowerHASystemMirror setups . . . . . . . . .. 96

AIX configuration considerations prior toperforming snapshot-based file backups andarchives . . . . . . . . . . . . . .. 97Configuring NetApp and Tivoli Storage Managerfor snapshot difference incremental backups . .. 98

Protection for clustered-data ONTAP NetApp fileserver volumes . . . . . . . . . . .. 99SnapMirror support for NetAppsnapshot-assisted progressive incrementalbackup (snapdiff) . . . . . . . . . .. 101

Register your workstation with a server . . .. 104Closed registration . . . . . . . . .. 104Open registration . . . . . . . . . .. 105

Creating an include-exclude list . . . . . .. 105Include-exclude options . . . . . . . .. 106

Exclude file spaces and directories . . .. 106Exclude files and directories from ajournal-based backup. . . . . . . .. 107Control processing with exclude statements 107System files to exclude . . . . . . .. 109Include and exclude files that containwildcard characters . . . . . . . .. 110Include and exclude groups of files withwildcard characters . . . . . . . .. 111Examples using wildcards with include andexclude patterns . . . . . . . . .. 112

Symbolic link and alias processing . . . .. 113Determine compression and encryptionprocessing . . . . . . . . . . . .. 113Preview include-exclude list files . . . . .. 114Include and exclude option processing . . .. 115

Chapter 3. Getting started . . . . .. 119Tivoli Storage Manager client authentication . .. 119Starting a Java GUI session . . . . . . . .. 120

Tivoli Storage Manager password . . . .. 121Setup wizard .