IBM Spectrum Protect for UNIX and LinuxBackup-Archive ClientsVersion 8.1.2

Installation and User's Guide

IBM

IBM Spectrum Protect for UNIX and LinuxBackup-Archive ClientsVersion 8.1.2

Installation and User's Guide

IBM

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

This edition applies to version 8, release 1, modification 2 of IBM Spectrum Protect (product numbers 5725-W98,5725-W99, and 5725-X15) and to all subsequent releases and modifications until otherwise indicated in new editions.

Copyright IBM Corporation 1993, 2017.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

What's new for Version 8.1.2 . . . . . xvii

Chapter 1. Installing the IBM SpectrumProtect 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 . . . . . . . 3AIX client environment . . . . . . . . . . 4

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

HP-UX Itanium 2 API environment . . . . . . 5HP-UX Itanium 2 API installable component . 5System requirements for the HP-UX Itanium 2API . . . . . . . . . . . . . . . 5HP-UX Itanium 2 API communication methods 5

Linux on Power Systems client environment . . . 5Linux on Power Systems client installablecomponents. . . . . . . . . . . . . 5System requirements for clients on Linux onPower Systems . . . . . . . . . . . 5Linux on Power Systems client communicationmethods . . . . . . . . . . . . . . 6

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

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

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

Oracle Solaris client environment . . . . . . 8Oracle Solaris client installable components . . 8System requirements for Oracle Solaris clients 9Oracle Solaris client communication methods . 9

NDMP support requirements (Extended Edition only) 9

Installation requirements for backing up andarchiving Tivoli Storage Manager FastBack client data 9Install the UNIX and Linux backup-archive clients 10

Installing the AIX client . . . . . . . . . 11Uninstalling the AIX client . . . . . . . . 13Installing the HP-UX Itanium 2 API . . . . . 14

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

Uninstalling the HP-UX Itanium 2 API . . . . 16Installing the backup-archive client on Linux onPower Systems (Little Endian) . . . . . . . 16Uninstalling the backup-archive client on Linuxon Power Systems (Little Endian) . . . . . . 19Installing the backup-archive client on UbuntuLinux on Power Systems (Little Endian) . . . . 20Uninstalling the client on Ubuntu Linux onPower Systems (Little Endian) . . . . . . . 22Installing the API on Linux on Power Systems(Big Endian) . . . . . . . . . . . . . 23Uninstalling the API on Linux on Power Systems(Big Endian) . . . . . . . . . . . . . 25Installing the Linux x86_64 client . . . . . . 26Uninstalling the Linux x86_64 client . . . . . 29Installing the Ubuntu Linux x86_64 client . . . 30Uninstalling the Ubuntu Linux x86_64 client . . 33Installing the Linux on System z client . . . . 34Uninstalling the Linux on System z client . . . 36Installing the Mac OS X client . . . . . . . 38Uninstalling the Mac OS X client . . . . . . 39Installing the Oracle Solaris x86_64 client . . . 40Uninstalling the Oracle Solaris x86_64 client . . 42Installing the Oracle SPARC API . . . . . . 43Uninstalling the Oracle Solaris SPARC API . . . 44Software updates . . . . . . . . . . . 45

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

Chapter 2. Configure the IBM SpectrumProtect client . . . . . . . . . . . . 47UNIX and Linux client root and authorized usertasks. . . . . . . . . . . . . . . . . 47Enable non-root users to manage their own data . . 49

Enabling encryption for backup-archive clientusers . . . . . . . . . . . . . . . 50

Client options file overview . . . . . . . . . 50Creating and modifying the client system-optionsfile . . . . . . . . . . . . . . . . 51Creating a default client-user options file . . . 53Creating a customized client user-options file . . 55

Environment variables. . . . . . . . . . . 56Set language environment variables . . . . . 56Set processing environment variables . . . . . 57Set Bourne and Korn shell variables . . . . . 59Set C shell variables . . . . . . . . . . 59Set API environment variables . . . . . . . 59

Copyright IBM Corp. 1993, 2017 iii

||

||||

||||||||

||

Web client configuration overview. . . . . . . 59Configuring the web client on AIX, Linux, Mac,and Solaris systems. . . . . . . . . . . 60

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

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

Configuring IBM Spectrum Protect client/servercommunication across a firewall . . . . . . . 66Configuring IBM Spectrum Protect client/servercommunication with Secure Sockets Layer . . . . 68

Creating a symbolic link to access the latestGSKit library . . . . . . . . . . . . . 71Certificate Authorities root certificates . . . . 72

Configure your system for journal-based backup . . 73Journal daemon configuration . . . . . . . 73

JournalSettings stanza . . . . . . . . . 75JournalExcludeList stanza . . . . . . . 75JournaledFileSystemSettings stanza . . . . 76Overriding stanzas . . . . . . . . . . 79

Client-side data deduplication . . . . . . . . 79Configuring the client for data deduplication . . 83Excluding files from data deduplication . . . . 85

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

Requirements for automated client failover . . 87Restrictions for automated client failover . . 88Failover capabilities of IBM Spectrum Protectcomponents . . . . . . . . . . . . 90

Configuring the client for automated failover . . 90Determining the status of replicated client data 92Preventing automated client failover . . . . . 93Forcing the client to fail over . . . . . . . 93

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

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

Configuring the backup-archive client in a clusterenvironment . . . . . . . . . . . . . 96Enabling web client access in a ClusterEnvironment . . . . . . . . . . . . 102Migrating legacy AIXIBM PowerHASystemMirror setups . . . . . . . . . . 104

AIX configuration considerations prior toperforming snapshot-based file backups andarchives . . . . . . . . . . . . . . . 105Configuring NetApp and IBM Spectrum Protect forsnapshot difference incremental backups . . . . 106

Protecting clustered-data ONTAP NetApp fileserver volumes . . . . . . . . . . . . 107SnapMirror support for NetAppsnapshot-assisted progressive incrementalbackup (snapdiff) . . . . . . . . . . . 110

Register your workstation with a server . . . . 113Closed registration . . . . . . . . . . 114

Open registration . . . . . . . . . . . 114Creating an include-exclude list . . . . . . . 115

Include-exclude options . . . . . . . . . 116Exclude file spaces and directories . . . . 116Exclude files and directories from ajournal-based backup . . . . . . . . . 117Control processing with exclude statements 117System files to exclude . . . . . . . . 119Include and exclude files that containwildcard characters . . . . . . . . . 120Include and exclude groups of files withwildcard characters . . . . . . . . . 120Examples using wildcards with include andexclude patterns . . . . . . . . . . 121

Symbolic link and alias processing . . . . . 123Determine compression and encryptionprocessing . . . . . . . . . . . . . 123Preview include-exclude list files . . . . . . 124Include and exclude option processing . . . . 124

Chapter 3. Getting started . . . . . . 129Configuring the client security settings to connectto the IBM Spectrum Protect server version 8.1.2and later . . . . . . . . . . . . . . . 129

Default security settings for the client (fast path) 129Configuring the client without automaticcertificate distribution . . . . . . . . . 131

Secure password storage . . . . . . . . . 1