Tivoli Storage Manager for Macintosh

Transcription

1 Tivoli Storage Manager for Macintosh Version 5.5 Backup-Archive Clients Installation and User s Guide SC

2

3 Tivoli Storage Manager for Macintosh Version 5.5 Backup-Archive Clients Installation and User s Guide SC

4 Note Before using this information and the product it supports, read the general information under Notices on page 345. Edition notice This edition applies to Version 5.5 of IBM Tivoli Storage Manager (5608-ISM), IBM Tivoli Storage Manager Extended Edition (5608-ISX), IBM Tivoli Storage Manager for Storage Area Networks (5608-SAN), and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. Order publications through your IBM representative or the IBM branch office serving your locality. Your feedback is important in helping to provide the most accurate and high-quality information. If you have comments about this manual or any other IBM Tivoli Storage Manager documentation, see Contacting customer support on page xiii. Copyright International Business Machines Corporation 1993, All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Tables vii About this book ix Who should read this manual ix IBM Tivoli Storage Manager Web site......ix Conventions used in this book x Reading syntax diagrams x Related publications xii Downloading or ordering publications.... xiii Accessibility xiii Contacting customer support xiii Reporting a problem xiv Internet xiv Summary of changes for Tivoli Storage Manager xvii Technical changes for Version November 2007 xvii Technical changes for Version January 2007 xvii Technical changes for Version March 2006 xviii Technical changes for Version October 2005 xix Chapter 1. Installing Tivoli Storage Manager Migrating from earlier versions Upgrade path for clients and servers Migrating to the Tivoli Storage Manager Version 5.5 Macintosh client from releases prior to Migrating to the Unicode-enabled client....4 Macintosh client environment Client components Hardware requirements Software requirements Communications method Installing the Macintosh client program (required system administrator task) Enabling non-administrators to manage their own data (required system administrator task)..11 Chapter 2. Configuring Tivoli Storage Manager Root user, authorized user, and non-authorized user tasks Using TSM Tools for Administrators Creating and modifying the client system options file (required root user or authorized user task)..15 Creating a default client user options file (optional root user or authorized user task) Creating a customized client user options file (optional user task) Setting options in an options file Setting processing environment variables (optional) 19 Setting T and C shell variables Setting Bash and Bourne shell variables Configuring the Web client Configuring the client scheduler Starting the client scheduler Using the command-line client to handle scheduled events Defining a schedule Configuring Tivoli Storage Manager client/server communication across a firewall Registering your workstation with a server (required root user or authorized user task)...25 Using closed registration Using open registration Creating an include-exclude list (optional root user or authorized user task) Using include-exclude options Controlling symbolic link and alias processing..33 Controlling compression and encryption processing Testing an include-exclude list with the Preview command Processing include and exclude options Chapter 3. Getting started Tivoli Storage Manager client authentication...39 Starting a GUI session Using your Tivoli Storage Manager password..40 Setup wizard Starting a command-line session Using batch mode Using interactive mode Starting: Additional considerations Starting a Web client session Setting user privileges Starting the client scheduler automatically Changing your password Sorting file lists using the Tivoli Storage Manager Java GUI Displaying online help Ending a session Online forums Other sources of online help Chapter 4. Backing up your data Planning your backups When to back up and when to archive files Pre-backup considerations How Tivoli Storage Manager maintains volume names Volume naming precautions Volume naming precautions on dual boot systems Unicode considerations Configure memory-constrained systems to run incremental backups Configure systems with large numbers of files to run incremental backups Copyright IBM Corp. 1993, 2007 iii

6 Using an include-exclude options list to control processing Encrypting data during backup or archive operations Supported file systems Maximum file size for backup and restore...54 How Tivoli Storage Manager handles long user and group names How Tivoli Storage Manager handles Filevault home directories How Tivoli Storage Manager handles the Time Machine backup disk Performing an incremental, selective, or incremental-by-date backup Full and partial incremental backup Incremental-by-date backup Comparing full incremental, partial incremental, and incremental-by-date backups Selective backup Backing up data using the Java GUI Backing up data using the command line...60 Deleting backup data Displaying backup processing status Backup with client node proxy support Scheduling with client node proxy support...65 Backup: Additional considerations Understanding how files are stored Understanding how files are managed Understanding how hard links are handled...67 Understanding how NFS hard and soft mounts are handled Understanding how deleted file systems are handled Backing up open files Using wildcard characters Chapter 5. Restoring your data Restoring an active or inactive backup Performing large restore operations Standard query restore, no query restore, and restartable restore Standard restore process No query restore process Restartable restore process Restoring files and directories Restoring data using the GUI Restoring data using the command line Performing point-in-time restores Restoring data from a backupset Restoring an entire or partial backupset Restoring backupsets using the Web client GUI 78 Restoring backupsets using the command-line client Related tasks and considerations Authorizing another user to restore or retrieve your files Restoring or retrieving files from another client node Restoring or retrieving your files to another workstation Restoring a disk in case of disk loss Deleting file spaces Overlapping icons Chapter 6. Archiving and retrieving your data Archiving files Maximum file size for archive and retrieve operations Archiving data using the GUI Archiving data using the command line Archiving data with client node proxy Deleting archive data Archive: Advanced considerations Retrieving archives Retrieving data using the GUI Retrieving data using the command line Understanding how your archives are managed 91 Chapter 7. Automating tasks Specifying scheduling options Displaying information about scheduled work...93 Displaying information about completed work..95 Scheduling options for commands Enabling or disabling scheduled commands...96 Client return codes Chapter 8. Understanding storage management policies Using policy domains and policy sets Using management classes and copy groups...99 Displaying information about management classes and copy groups Copy group name Copy type Copy frequency Versions data exists Versions data deleted Retain extra versions Retain only version Copy serialization Copy mode Copy destination Retain versions Selecting a management class for files Assigning a management class to files Overriding the management class for archived files 106 Selecting a management class for folders Binding management classes to files Rebinding backup versions of files Using a retention grace period Using event-based policy retention protection Archiving files on a data retention server Chapter 9. Using processing options 111 Overview of processing options Communication options TCP/IP options Server and node Node options Server options Node options iv IBM Tivoli Storage Manager for Macintosh: Backup-Archive Clients Installation and User s Guide

7 Backup and archive processing options Restore and retrieve processing options Scheduling options Format and language options Command processing options Authorization options Error processing options Transaction processing options Diagnostics options Using options with commands Entering options with a command Initial command-line-only options Client options reference Archmc Asnodename Auditlogging Auditlogname Autofsrename Backupsetname Changingretries Collocatebyfilespec Commmethod Commrestartduration Commrestartinterval Compressalways Compression Console Dateformat Defaultserver Deletefiles Description Detail Dirmc Dirsonly Disablenqr Diskbuffsize Diskcachelocation Domain Editor Enablearchiveretentionprotection Encryptiontype Encryptkey Errorlogmax Errorlogname Errorlogretention Exclude options Filelist Filename Filesonly Fromdate Fromnode Fromowner Fromtime Groups Guitreeviewafterbackup Httpport Ifnewer Inactive Inclexcl Include options Incrbydate Language Latest Localbackupset Location Mailprog Managedservices Maxcmdretries Memoryefficientbackup Nfstimeout Nodename Noprompt Numberformat Optfile Password Passwordaccess Passworddir Pick Pitdate Pittime Postschedulecmd/Postnschedulecmd Preschedulecmd/Prenschedulecmd Preservepath Queryschedperiod Quiet Removeoperandlimit Replace Resourceutilization Retryperiod Revokeremoteaccess Schedcmddisabled Schedlogmax Schedlogname Schedlogretention Schedmode Schedrestretrdisabled Scrolllines Scrollprompt Servername Sessioninitiation Skipacl Skipaclupdatecheck Srvprepostscheddisabled Subdir Tapeprompt Tcpadminport Tcpbuffsize Tcpcadaddress Tcpclientaddress Tcpclientport Tcpnodelay Tcpport Tcpserveraddress Tcpwindowsize Timeformat Todate Totime Txnbytelimit Type Users V2archive Verbose Contents v

8 Virtualnodename Webports Chapter 10. Using commands Starting and ending a client command session Process commands in batch mode Process commands in interactive mode Entering client commands Command name Options Parameters File specification syntax Remembering previous commands Using wildcard characters Entering commands Client commands reference Archive Cancel Restore Delete Access Delete Archive Delete Backup Delete Filespace Expire Help Incremental Loop Macro Preview Query Access Query Archive Query Backup Query Backupset Query Filespace Query Inclexcl Query Mgmtclass Query Node Query Options Query Restore Query Schedule Query Session Query Systeminfo Restart Restore Restore Restore Backupset Retrieve Schedule Selective Set Access Set Event Set Password Appendix. Using the Tivoli Storage Manager central scheduler Overview of the Tivoli Storage Manager scheduler 335 Handling spaces in file names in schedule definitions Preferential start times for certain nodes Understanding scheduler processing options Handling return codes from preschedulecmd and postschedulecmd scripts Using the client acceptor to manage scheduler services versus the traditional scheduler services. 339 Setting the client scheduler process to run as a background task and start automatically at boot time Changing processing options used by the scheduler service Managing multiple schedule requirements on one system Restarting the scheduler process on a remote system Troubleshooting the Tivoli Storage Manager scheduler Investigating abnormal scheduled events Checking the server activity log Inspecting the Client Schedule Log Understanding the scheduler log Notices Trademarks Glossary Index vi IBM Tivoli Storage Manager for Macintosh: Backup-Archive Clients Installation and User s Guide

9 Tables 1. Typographical conventions x 2. IBM Tivoli Storage Manager client and server publications xii 3. Optimized option default values..... xxi 4. Macintosh installation packages Mac OS X authorization tools and associated Tivoli Storage Manager applications Root user, authorized user, and non-authorized user tasks Option for excluding directories Options for controlling backup and archive processing Wildcard and other special characters Using wildcard characters with include and exclude patterns Options for controlling symbolic link and alias processing Options for controlling compression and encryption processing Working with your files using the Tivoli Storage Manager GUI Backup: Primary tasks Planning your backups Supported file systems Maximum file size for backup and restore Command line backup examples Client command line informational messages Restore: Primary tasks Command line restore examples Archive and retrieve: Primary tasks Maximum file size for archive and retrieve Command line archive examples command-line examples of retrieving archives Client return codes and their meanings Default values in the standard management class TCP/IP options Server and node options Backup and archive processing options Restore and retrieve processing options Scheduling options Format and language options Command processing options Authorization options Error processing options Transaction processing options Diagnostics options Client command options Options that are valid on the initial command line only Entering commands Commands Command recall and edit functions Wildcard characters Archive command: Related options Delete Archive command: Related options Delete Backup command: Related options Delete Filespace command: Related options Expire command: Related options Incremental command: Related options Query Archive command: Related options Query Backup command: Related options Query Backupset command: Related options Query Filespace command: Related options Query Mgmtclass command: Related options Query Node command: Related options Query Options command: Related options Query Systeminfo command: Related options Restore command: Related options Restore Backupset command: Related options Retrieve command: Related options Schedule command: Related options Selective command: Related options Scheduled client event status codes Schedule log information Copyright IBM Corp. 1993, 2007 vii

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

11 About this book IBM Tivoli Storage Manager is a client-server licensed product that provides storage management services in a multiplatform computer environment. The backup-archive client program permits users to back up and archive files from their workstations or file servers to storage, and restore and retrieve backup versions and archived copies of files to their local workstations. Who should read this manual In addition to the backup-archive client, Tivoli Storage Manager includes the following components available on a variety of platforms: v A server program that permits systems to perform as a backup and archive server for distributed workstations and file servers. See Related publications on page xii for available server publications. v An administrative client program that you can access from a Web browser or the command line. The program permits a Tivoli Storage Manager administrator to control and monitor server activities, define storage management policies for backup, archive and space management services, and set up schedules to perform those services at regular intervals. For more information about the Administrative client, see Related publications on page xii for available Tivoli Storage Manager Administrator s Reference publications. This manual provides instructions for an end-user to install, configure, and use the Tivoli Storage Manager client. For installation information and supported operating system levels, see Chapter 1, Installing Tivoli Storage Manager, on page 1. For configuration information, see Chapter 2, Configuring Tivoli Storage Manager, on page 13. This manual assumes that you are familiar with your workstation, your operating system, and your basic system administration. Tivoli Storage Manager tasks that can only be performed by authorized users and root users are identified by the phrases, authorized user and root user. An authorized user is any user running with a real user ID of 0 (root) or a user who owns the Tivoli Storage Manager executable and whose owner execution permission bit is set to s. In the following example, the user tivoli is an authorized user while running dsmc since the dsmc owner execution permission bit is set to s: See Root user, authorized user, and non-authorized user tasks on page 13 for more information about authorized user and root user tasks. IBM Tivoli Storage Manager Web site Technical support information and publications are available at the following address: By accessing the Tivoli Storage Manager home page, you can access subjects that interest you. You can also access current Tivoli Storage Manager product information. Copyright IBM Corp. 1993, 2007 ix

12 Conventions used in this book This book uses the following typographical conventions: Table 1. Typographical conventions Example Description dsmc.nlm A series of lowercase letters with an extension indicates Tivoli Storage Manager program file names. archive Boldface type indicates a command that you type at a workstation, such as a command you type on a command line. dateformat Boldface italic type indicates a Tivoli Storage Manager option. The bold type is used to introduce the option, or used in an example. Occasionally, file names are entered in boldface italic for emphasis. filespec Italicized type indicates either the name of a parameter, a new term, or a placeholder for information that you provide. Italics are also used for emphasis in the text. maxcmdretries Monospaced type represents fragments of a program or information as it would display on a screen. plus sign (+) A plus sign between two keys indicates you should press both keys at the same time. Reading syntax diagrams This section describes how to read the syntax diagrams used in this manual. To read a syntax diagram, follow the path of the line. Read from left to right, and top to bottom. v The symbol indicates the beginning of a syntax diagram. v The symbol at the end of a line indicates the syntax diagram continues on the next line. v The symbol at the beginning of a line indicates a syntax diagram continues from the previous line. v The symbol indicates the end of a syntax diagram. Syntax items, such as a keyword or variable, can be: v On the line (required element) v Above the line (default element) v Below the line (optional element). x IBM Tivoli Storage Manager for Macintosh: Backup-Archive Clients Installation and User s Guide

13 Syntax diagram description Example Abbreviations: Uppercase letters denote the shortest acceptable truncation. If an item appears entirely in uppercase letters, it cannot be truncated. You can type the item in any combination of uppercase or lowercase letters. KEYWOrd In this example, you can enter KEYWO, KEYWORD, or KEYWOrd. Symbols: Enter these symbols exactly as they appear in the syntax diagram. Variables: Italicized lowercase items (var_name) denote variables. * Asterisk { } Braces : Colon, Comma = Equal Sign - Hyphen () Parentheses. Period Space KEYWOrd var_name In this example, you can specify a var_name when you enter the KEYWORD command. Repetition: An arrow returning to the left means you can repeat the item. A character or space within the arrow means you must separate repeated items with that character or space. A footnote by the arrow references the number of times you can repeat the item. repeat, repeat (1) repeat Notes: 1 Specify repeat as many as 5 times. Required choices: When two or more items are in a stack and one of them is on the line, you must specify one item. A B C In this example, you must choose A, B, or C. About this book xi

14 Syntax diagram description Example Optional choice: When an item is below the line, that item is optional. In the first example, you can choose A or nothing at all. When two or more items are in a stack below the line, all of them are optional. In the second example, you can choose A, B, C, or nothing at all. Defaults: Defaults are above the line. The default is selected unless you override it. You can override the default by including an option from the stack below the line. A A B C A B C In this example, A is the default. You can override A by choosing B or C. You can also specify the default explicitly. Repeatable choices: A stack of items followed by an arrow returning to the left means you can select more than one item or, in some cases, repeat a single item. In this example, you can choose any combination of A, B, or C. Syntax fragments: Some diagrams, because of their length, must fragment the syntax. The fragment name appears between vertical bars in the diagram. The expanded fragment appears between vertical bars in the diagram after a heading with the same fragment name. A B C The fragment name The fragment name: A B C Related publications Table 2 lists the IBM Tivoli Storage Manager client and server publications that are referred to in this manual. Table 2. IBM Tivoli Storage Manager client and server publications Publication title Order number Client publications IBM Tivoli Storage Manager Messages SC IBM Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User s Guide SC IBM Tivoli Storage Manager for NetWare Backup-Archive Clients Installation and User s Guide SC IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Installation and User s Guide Server publications SC xii IBM Tivoli Storage Manager for Macintosh: Backup-Archive Clients Installation and User s Guide

15 Table 2. IBM Tivoli Storage Manager client and server publications (continued) Publication title Order number IBM Tivoli Storage Manager for AIX Installation Guide SC IBM Tivoli Storage Manager for HP-UX Installation Guide SC IBM Tivoli Storage Manager for Linux Installation Guide SC IBM Tivoli Storage Manager for z/os Installation Guide SC IBM Tivoli Storage Manager for Sun Solaris Installation Guide SC IBM Tivoli Storage Manager for Windows Installation Guide SC Downloading or ordering publications All Tivoli publications are available for electronic download or order from the IBM Publications Center: If you have questions or comments regarding Tivoli publications and product documentation, visit to send an . The International Technical Support Center (ITSC) publishes Redbooks, which are books on specialized topics such as using Tivoli Storage Manager to back up databases. You can order publications through your IBM representative or the IBM branch office serving your locality. You can also search for and order books of interest to you at the IBM Redbooks Web site at this address: Tivoli Field Guides are designed to address specific technical scenarios or concepts that are often complex to implement or difficult to understand. All completed field guides are available free to registered customers and internal IBM employees at the following Web site: Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. Contacting customer support For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: v Visit the Tivoli Storage Manager technical support Web site at: v Visit the IBM Software Support Toolbar Web site at: v Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. You can access from the IBM Web site at: v Submit a problem management record (PMR) electronically from the IBM Web site at: About this book xiii