1. Unit 4: Implementing Client Functions

2. 2 Objectives Upon the completion of this unit, you will be able to: Invoke the Storage Manager client. Set up client options. Backup and restore client files. Archive and retrieve client files. Query client schedules, logs, and events. Use the client utilities to change client passwords, access a client, and remove archived data. Enhanced client functions such as Web Client Interface, LAN-free data transfer, backup sets, and mobile client.

3. 3 Client Functions Backup and restore Archive and retrieval Migrate and recall View files Query functions Storage Manager Server WAN migrate/ recall backup/ restore archive/ retrieve

4. 4 Backup Overview Incremental Incremental by date Selective Versions Policy managed May be automated Storage Manager Server WAN File A backup/ restore Centrally Scheduled File A v1 File A v2 File A v3

5. 5 Restore Overview Active file ‘n’ version (inactive) Point-in-time Restore to new location May be automated Collision options Storage Manager Server WAN backup/ restore Centrally Scheduled File A File A v1 File A v2 File A v3

6. 6 Archive Overview No versioning Policy managed Packages May be automated Delete archived files Storage Manager Server WAN File A archive/ retrieve Centrally Scheduled File A

7. 7 Retrieve Overview Any archived file Retrieve to new location May be automated Collision options Packages Storage Manager Server WAN File A archive/ retrieve Centrally Scheduled File A

8. 8 Invoking the Backup-archive Client Command Line Interface Graphical User Interface (GUI) Web Client Interface

9. 9 Command Line Interface dsmc invokes the TSM backup-archive command line client Client-Server session starts with each command Client-Server session drops when command completes Example: TSM NT/OS2 Client C:\Program Files\Tivoli\TSM\baclient\dsmc Example: TSM UNIX Client /usr/tivoli/tsm/client/ba/bin/dsmc invoking interactive loop session prompts for password if not in command, unless TSM Server AUTHentication is set to OFF

10. 10 Command Line Interface Loop Type dsmc or dsmc LOOP to begin interactive session. Type quit to end interactive session.

11. 11 Command Line Syntax Syntax dsmc keyword -option=value filespec Online Help dsmc HELP or dsmc ?

12. 12 Instructor Demonstration

13. 13 Backup-archive Client GUI Backup-Archive GUI feature Resizable windows Collapsible directory trees Directory selection technique Progress indicators Find and File Detail function Estimate function Graphical options editor

14. 14 Invoking the Web Client Interface TSM Server 3.0 or higher supports web client. Browser Requirements Client functions All client functions Access http://your_machine_name:1581

15. 15 Client Options – An Overview Configuration options files DSM.OPT DSM.SYS * –INCLEXCL * Server options override client options DSMC command line client Override configuration options Except domain (additive) Graphical User Interface Override configuration options

16. 16 The COMMMethod Option Syntax of COMMMethod –TCPIP –NAMEdpipe –SNMP –HTTP –NONE –IPX/SPX* –NETBIOS* *No longer supported for Windows Client Option File Only ONE COMMmethod per client

17. 17 The COMMMethod TCP/IP Option COMMMethod TCPIP TCPPort port_address TCPServeraddress dot.addr Client Option File

18. 18 The Server and Node Name Options NODename nodename Servername servername Virtualnodename nodename Client Option File

19. 19 The Compression Option COMPRESSIon Yes|No COMPRESSALways Yes|No Related Administrative Command REGISTER NODE BACKUP

20. 20 Client Options File – Domain DOMaindefault-client-domain TSM Server STG Pool F: D: C: E: CLIENT A /remote /home /usr /mfg CLIENT B Domain C: D: F:Domain ALL- LOCAL remote /home /usr /mfg C: D: F:

21. 21 The Directory Support Options Incremental backup of individual directory structures Backup-archive GUI and command line client Backup and restore of empty directories Selective backup support ACL and Trustee rights supported Command line options DIRSONLY and FILESONLY Default is both dir dir1dir2 subdir1 file-a subdir2 file-afile-b Incremental backup

22. 22 Other Options BACKUPRegistry ERRORLOGName ERRORLOGRetention QUIET or VERBOSE (default is verbose) VIRTUALMOUNTPOINT (Unix only) Client Option File

23. 23 The Graphical Options Editor Integrated in backup archive GUI. Updates option files DSM.OPT DSM.SYS * Supports TSM environment variables. Queries server for options stored centrally. Does not update centrally stored client options. Supports most client options. * UNIX Clients

24. 24 The Include/Exclude List INclude/EXclude EXclude files during Incremental and Selective Backup. INclude specifies exceptions to Exclude. INclude Management Class can override the default. Management Class for all backups and archives. Directories are not excluded, (unless EXCLUDE.DIR). Syntax can use wildcard and metacharacters. Specified in the configuration file.

25. 25 The Include/Exclude Processing Include/Exclude Rules Bottom up processing flow Quit checking when file matches If it is not excluded, it is included C:\word\old\my.doc (Rule 3) Exclude E:\word\data\base.doc (Rule 1) Exclude C D E C:\word\new\user.doc (Rule 2) D:\word\old\form.txt (default) Include Incremental Backup Processing EXclude *.doc INclude c:\word\...\*.doc EXclude c:\word\old\*.doc Does Rules 2 match file? Does Rule 1 match file? Does Rule 3 match file? Yes Include Exclude Yes No Yes Client Domain TSM Server Include

26. 26 Include/Exclude Examples EX *.bak IN /usr/dev/*.bak 1. EX /.../tmp/.../* IN /home/tmp/save.fil EX /usr [1-3]/.../*.obj 2. EX [ce-h]:\...\*.obj EX d:\*.obj EX ?:\tmp\...\* 3. EX server\*:/.../tmp/.../* IN server\vol:/tmp/save.fil 4.

27. 27 Exclude Directories from Backup EXCLUDE.DIR statements Directory structure not backed up. Directory structure removed from backup traverse list. Included subdirectories under excluded directory ignored. Explicit backup of excluded directory supported.... include /home/dir1/subdir2 exclude.dir /home/dir1 include /home/dir1/subdir1... dsmc> sel -subdir=yes /home/* dsmc> sel /home/dir1/subdir1/*

28. 28 Include/Exclude Exercise 1.EX /home/admin/*.* 2.EX /home/nobody/.../* 3.EX /usr/lwp/* 4.IN /usr/lwp/resume.* Domain /usr/ /home/ If it's not excluded, it's included EXIN /home/admin/bob.log /home/admin/fileone /home/nobody/data/file1.dat /usr/lwp/resume.ibm /usr/lwp/data/file1.dat

29. 29 Client Option Sets DEFINE CLOPTSET Defined at server and allocated to one or more clients Central client option configuration Subset of client options Options can be locked at server DEFINE CLIENTOPT Optionset name Option value Sequence number Force REGISTER and UPDATE NODE associates node with option set QUERY, DELETE, and UPDATE CLOPTSET CLIENTOPT INCLUDE/EXCLUDE options Inclexcl option

30. 30 Sample Option Set Define client option set on server Define options in option set Associate nodes with client option set tsm> update node yangtze cloptset=NT_options tsm> reg node alhambra cloptset=NT_options tsm> define clientopt NT_options tapeprompt no tsm> define clientopt NT_options compression yes force=yes tsm> define clientopt NT_options inclexcl 'exclude *:\...\*' seq=10 tsm> define clientopt NT_options inclexcl 'include d:\...\*.doc MC' seq=20 tsm> define cloptset NT_options description="options for NT clients only"

31. 31 Client Encryption Support Encryption of file data before they are sent to server. Encryption is last step before data sent to server. DES 56-bit encryption algorithm. Simple key management. Increases data security for backup of mobile systems. Fully transparent to server. Works on backup and archive. Additional include/exclude option to select encryption candidates. Supported on Win32 Intel-type V4.1 (and higher) clients (CLI, GUI, Web). TSM server TSM Client

32. 32 Student Exercise

33. 33 Backup and Restore Topics Incremental Backup Selective Backup Incremental by Date Restoring Backup Files

34. 34 Incremental Backup Backup new or changed files Since last incremental backup Based on server information Stores copy on TSM Server Domain and Exclude/Include options Uses Policy Management File system, Drive, Directory or File level Changed based on TSM Server information File size Date and Time File Owner File Group File Permission Attribute Change Time January 15

35. 35 Command Line Interface Syntax (from the OS command line) dsmc Incremental -options=value filespec|filename Backs up all new and changed files in domain since last incremental backup based on policy management. Display file information during processing. Domain processing Check all files in DOMain specified in configuration options files. Adds all file in -DOMain=… specified in command line. Overridden by filespec command parameter.

36. 36 Incremental Backup Examples dsmc I dsmc I C: dsmc I /home/ Override options dsmc I -quiet dsmc I -compressi=no dsmc I -compressi=yes -compressalways=yes

37. 37 Incremental by Date Alternative method to determine which files to back up. Does not require query of every active file in TSM Server. Compares file/directory date and time stamp with date and time of last incremental backup. Periodically requires regular incremental backup. Externals dsmc incremental option -INCRBYDate. Quick: changed files or incremental (date only), on backup/archive GUI. MonTueWedThuFriSatSun Inc.by date reg inc.Inc.by date reg inc.Inc.by date reg inc.Inc.by date reg inc.Inc.by date

38. 38 Adaptive Sub-file Backup Backup of changed file data on byte or block level. Differential backup of changed file data Dynamic selection of backup level based on initial file size Minimizes network traffic, best suited for backup of mobile systems Fully integrated in Tivoli Storage Manager client and server. Transparent to end user Policy management fully applies Fault tolerant backup/restore Multithreading for Windows Client TSMV5.1 server TSMV5.1 Win client

39. 39 Command Line Summary Backs up all new and changed files in the drives of the file systems since last incremental backup. Traverses all subdirectories (ignores Subdir option). Only includes drives with a volume label. Filespec parameter overrides DOMain statement. Excludes files specified in Exclude statements. Associates Management Class (MC) in include statement or default MC. dsmc Incremental c: m: dsmc Incremental /u /usr

40. 40 Selective Backup Backup Selected Files To obtain backup of frequently used files Backup regardless of change status Stores copy on TSM server Selection Criteria Subdir Option Exclude/Include options Command line syntax dsmc Selective -options=value filespec Examples –dsmc Selective c:\personnel\*.dat -subdir=yes -compression=yes –dsmc Selective /home/*.dat -subdir=yes

41. 41 Subdir Option SUBDIR Include or Exclude subdirectories. Used for Restore and Selective Backup, Archive, and Retrieve. Values: ON/TRUE/1/YES or OFF/FALSE/0/NO. –SUbdir=No Do not process subdirectories. Only include files in specified directory, excluding all subdirectories. –SUbdir=Yes Process subdirectories. Includes files in specified directory, along with files in all subdirectories.

42. 42 Selective Backup Examples dsmc selective -subdir=yes /home/*.doc dsmc selective -subdir=yes c:\lotus\wordpro\work\*.doc –Selective backup of *.doc files in all directories and subdirectories regardless of configuration options. dsmc selective /home/mary/h1.doc /home/jones/test.doc –Using more than one file specification on the selective backup command. Performs a selective backup of the h1.doc and test.doc files in the /home/jones directory. dsmc selective -compression=yes c:\home\jones\h1.doc –Selective backup of c:\home\jones\h1.doc using compression. dsmc selective /u/devel/proj* –Performs a selective backup of all files in the /u/devel directory whose filenames begin with proj.

43. 43 Backupsets What is a backupset? Snapshot of active backed up files from one client Stored and managed as a single object via volume history Created as a single file or a file sequence or on a specific media Granularity is filespace Used for Instant Archive Rapid Recovery (LAN-free using portable media, LAN based) Storage Pool I I End user client QIC-5010 Data Cartridge IBM AA AA AA Backupset tsm> generate backupset AA AA AA

44. 44 Media for Generating Backupset Comp 3M QIC-5010 Data Cartridge IBM Exabyte Supported Server Platforms: l AIX 4.3.2 - 4.3.3 l NT 4.0 l Windows 2000 l Sun Solaris l HP-UX All client Platforms supported except: l OS/390 USS l Novell Netware Device Type New values for "-loc=" option in RESTORE BACKUPSET command: 8mmtape or 8mm 4mm DLTdlt 3570 3590 The client must use the same tape device as the server to generate backupsets.

45. 45 Generating a Backupset on Tape Administrator generates backupset. System, policy or owner authority required. Admin command GENERATE BACKUPSET. Carefully consider the FORMAT parameter defined in the tape device class. Tape must be readable on the local tape of the client machine. Device class maps a tape device common with client. Unique description for easy management. Retention option to define the backupset expiration. Backup set volumes tracked in volume history file.

46. 46 Managing Backupsets QUERY BACKUPSET UPDATE BACKUPSET DELETE BACKUPSET QUERY BACKUPSETCONTENT QUERY VOLHISTORY TYPE=BACKUPSET

47. 47 Restoring a Backup Set Using Tape QIC-5010 Data CartridgeIBM QIC-5010 Data CartridgeIBM Backup set Tape unit CLIENT SERVER The same tape unit is required on both Server and Client machines. local

48. 48 Instructor Demonstration

49. 49 Find and File Details Functions Find function Filter or search for files on disk client or server. –Start path –Name –Size –Modification date –Access date –Backup date –UNIX owner –UNIX group –File type File Details function Shows attributes for files and directories on client.

50. 50 Restore Backed Up Files Active file ‘n’ version (inactive) Point-in-Time Restore to new location May be automated No query restore Restore Image (Unix) Restore Raw LV (Unix) Backup Sets TSM Server WAN backup/ restore Centrally Scheduled File A File Av1 File Av2 File Av3

51. 51 Client Options – Restore FOLLOWSYMBOLIC * REPLACE SUBDIR TAPEPROMPT Option File * UNIX Clients

52. 52 CLIENT RESTORE Restoring Backed Up Files REStore To restore one or more backed up files. Only files in specified directory are restored unless SUbir option set to YES. Restore to path specified or default to backup path. Use PICK option to pick from list of backed up files. Active version (current version, default) Latest Inactive (Prior version) Todate Totime PITdate PITtime IFNewer

53. 53 Restore: Command Line Interface Syntax: dsmc REStore -option=value source_filespec backup_path | destination_filespec source_filespec –Filename and path of file to restore. backup_path | destination_filespec –Filename and path to place to restored files. –Defaults to backed up path.

54. 54 Restore Command Examples dsmc REStore C:\*.bak -replace=yes –Restore *.bak files in only the root directory of the C: drive to original locations, overwriting existing files. dsmc REStore /home/ -subdir=yes –Add the SUBDIR=YES option to the command if you need to restore the files in a directory and all of its subdirectories. This command recovers an entire file system (the /home file system). dsmc REStore /home/jones/h1.doc /home/jones/h2.doc –Restore a file under an new name (/home/jones/h2.doc). dsmc REStore /usr/project/* -PIck -INActive –Restore all files in the /usr/project directory. Use the Pick option and provide a list of active and inactive files to choose (pick) from.

55. 55 Restore to New Location Restore preserving directory structure Restore complete path Restore partial path Do not preserve directory structure PRESERVEPATH command line option Complete, Partial (subtree), Nobase or None The default is Partial dir1 subdir1 file-a dir dest. subdir2 file-a file-b Complete file-a dest. file-b dir dir1dir2 subdir1 file-a subdir2 file-afile-b Directories to restore None subdir1 file-a dir1 subdir2 file-a file-b Partial dest. subdir1 file-a subdir2 file-a file-b dest. Nobase

56. 56 Point-in-time Restore Restore filespace to the state captured by backups. From GUI or command line client. Restore on filespace, directory or file level. Only Incremental backup notifies of deleted files. I need to restore my "C" drive the way it was last Friday.

57. 57 Point-in-time Restore Options GUI and command line restore options GUI window PITTIME hh:mm:ss PITDATE mm/dd/yyyy NLS enabled Restore /home filesystem to the state it had when last backed up on August 16th: dsmc> restore -subdir=yes pitdate=08/16/1999pittime=17:40 /home/*

58. 58 Point-in-time Considerations Incremental backups notify of deleted files. Frequency determines point in time resolution for deleted files. No Query Restore Process used. Fault tolerant restore. Restartable restore. Policy definition considerations. Backup retention period. Number of backup versions kept.

59. 59 No Query Restore Process Eliminate client memory constraints during restore. Provide restores that are restartable in case of failures. Potentially increase performance. Transparent to clients. Automatically used on restores Exceptions –Inactive, pick, latest, fromdate, and todate –Restore of NetWare NDS

60. 60 No Query Restore Process Standard restore process Client queries server for files backed up. Server sends filespace contents to client. Client sorts list of files. Client signals server with list of flies to restore. Data sent from server. No Query Restore Process Client tells server what to restore. Server sorts data. Server sends data to client. 1) Restore my "C" drive 5) Here it is 2) Here's a list of the files I have from your "C" drive 4) OK, send the data TSM SERVER 3) Sort the files file-1 file-2 file-3 file-N

61. 61 Multi-Session Restore Sessions limited by number of sequential volumes with data to be restored number of mount points resourceutilization option Client Server Session 1 Session 2 Session 3

62. 62 Restartable Restores Resumes at point of interruption New restore states –Active –Restartable –Restarts on transaction boundary Transparent to client No Query Restore process used Restore progress Point of restart Restore failure Transactions

63. 63 Restartable Restore Commands Backup archive client commands QUERY RESTORE – Lists restartable restores Displays filespec, destination, nodename and owner RESTART RESTORE – Select from list of restartable restores – Restore continues from point of interruption Restart not performed when canceled by admin CANCEL RESTORE Administrative commands QUERY RESTORE CANCEL RESTORE Client filespace considerations Locked if restartable restore running or pending Unlocked by successful restore or CANCEL RESTORE Restore Interval expired

64. 64 Restartable Restore Database Information Server option RESTOREINTERVAL Defines how long a restore session can be restarted Default 24 hours, max 1 week Restartable restores expire After a successful restore CANCEL RESTORE from Backup-archive or Admin client By ADSM process when RESTOREINTERVAL passed By a move operation – Migration – Reclaim – MOVE DATA During expiration processing

65. 65 Instructor Demonstration

66. 66 Student Exercise

67. 67 Archive and Retrieve Topics Archive/Retrieve Archive Description Archive Packages Query Commands TSM Server WAN file A archive/ retrieve Centrally Scheduled file A

68. 68 Archive and Retrieve – Archiving Files Archiving Files Archive files, subdirectories, and directories. Archive regardless of change status. Store copy on TSM Server. Override management class (MC) using ARCHMC option Associate a description. Selection Options Selection is user-specified. Must have an Archive Copy Group. Uses Exclude/Include list for –Include override default MC. –Excludes not applicable.

69. 69 Archive Descriptions Archive description mandatory Identifies archived files and directories 255-character text string Unique archive descriptions Displayed during archive operations Key to retrieving archived files Files archived 04/01/2001

70. 70 Archive Packages Archived files with common description. Archive or retrieve Archive or retrieve complete package. Retrieve individual files in package. Add files to existing package. Delete files from package. New package Created using unique archive description. Default description Archive Date: mm/dd/yyyy Retrieve using the GUI client Display archived files hierarchically. Grouped by archive descriptions. file

71. 71 Directory Archiving TSM supports archive and retrieve of directories. ACL Trustee rights Command line options DIRSONLY FILESONLY Default is both Directories and files use same description. Directories bound to DIRMC management class.

72. 72 Archive Command Line Syntax DSMC Archive -options=value filespec Command Options ARCHMc DELETEFILEs DEScription DIRsonly FILESonly SUBdir Client Disk TSM Server Archive STG Pool Client

73. 73 Archive Command Line Examples DSMC Archive -archmc=RET2YRS home/plan/budget.mar –Archive budget.mar specifying the management class (MC) overrides the default MC and INCLUDE/EXCLUDE list. DSMC Archive -des=‘Tax 1998’ D:\LOTUS\WORDPRO\filea –Archive filea and provide a description, “Tax 1998.” DSMC Archive /home/tetris/scores.bob -deletefiles –Delete archived files from workstation after they are stored on the server. DSMC Archive d:\proj\*.pgm -subdir=yes –Archive files that have a suffix of pgm, not only in the proj directory, but also in all subdirectories.

74. 74 Instructor Demonstration

75. 75 Retrieve Command Line Syntax DSMC RETrieve -option=value source Command Options DEScription Dirsonly FILESonly FROMDate FROMTime TODate TOTime FROMNode FROMOwner Pick SUBdir Client Client Disk Archive STG Pool TSM Server

76. 76 Retrieve Command Line Examples dsmc RETrieve /home/jones/h1.doc –Retrieve the /home/jones/h1.doc file to its original directory. dsmc RETrieve /home/jones/h1.doc /home/jones/h2.doc –Retrieve the file under a new name (/home/jones/h2.doc). dsmc RETrieve /user/project/* -Pick –Retrieve files in the /user/project directory using the pick option. dsmc RETrieve /u/devel/projecta/*.c –Retrieve all files in the /u/devel/projecta directory that end with an extension of.c.

77. 77 Retrieve GUI Looks similar to the Restore GUI. To retrieve a file: Click the + sign in front of a description to find out more about files archived under that description. Select archive package(s) to retrieve. Click Retrieve button. Retrieve Find function works similarly to the restore Find function.

78. 78 Student Exercise

79. 79 Utilities Menu Commands

80. 80 Instructor Demonstration

81. 81 File Viewing – Query Commands dsmc Query ACcess dsmc Query ARchive dsmc Query Backup dsmc Query Filespace dsmc Query Mgmtclass dsmc Query Schedule

82. 82 Student Exercise

83. 83 Enhanced Client Support TSM Web Client Interface Updated Easier installation and configuration for Windows clients. Client Platform Support Changes HP-UX Improvements Improved application availability during backups with online image backups, server-free backup and restore, and support for HACMP for AIX clients. Unicode Support for Windows NT and Windows 2000 Clients Improved Recovery and Disaster Recovery Client enhancements for 5.1

84. 84 TSM Client Configuration Wizard IBM Tivoli Storage Manager for Windows is even easier to install and configure with additional wizard support. Setup options Install/update/remove Web client agent Option file selection Define the TCP/IP port number Specify node name and password Specify system user account the service should run under Edit Domain and Include/Exclude lists

85. 85 Platforms Supported for Web Client The Web client is available on the following client platforms: AIX Backup-Archive Client Hewlett-Packard HP-UX Backup-Archive Client Linux for x86 Backup-Archive Client Linux for IBM zSeries and S/390 Backup-Archive Client NetWare Novell NetWare Backup-Archive Client SGI IRIX UNIX Backup-Archive Client OS/390 and z/OS UNIX System Services Backup-Archive Client Sun Solaris Backup-Archive Client Windows Backup-Archive Client Windows XP, Windows ME Windows 2000 Pro, Server, Advanced Server, and DataCenter Windows NT 4.0 SP5 and SP6a Tru64 UNIX Backup-Archive Client UnixWare Check the Tivoli Web site for the latest list of supported Client Platforms.

86. 86 Client Platforms No Longer Supported The following client platforms or operating systems supported in V4.2 were not migrated to V5.1 and are not supported in V5.1: Apple Macintosh 8 and 9.0 IBM NUMA Q Linux x86 2.2 kernel NetWare 4.20 Windows 98 OS/390 UNIX System Services V2R8 Check the Tivoli Web site for the latest list of supported Client Platforms.

87. 87 LINUX Client Support Interfaces and supported distributions GUI, Web and command line SuSE 7.1, RedHat 7.1 and TurboLinux 7.0 Installation and setup Installing the Clients and README file coming with the client code. Executable in /opt/tivoli/tsm/. Features and limitations Client configuration wizard. Backup set restore from FILE and Tape. Backup set restore only from FILE using Web Client. Backup sets are used to archive data.

88. 88 HP/UX Support Expanded LAN-free capability HP-UX Improvements

89. 89 Unicode Support Unicode Support for Windows NT and Windows 2000 Clients:

90. 90 Improved Recovery and Disaster Recovery Recovery Performance Disaster Recovery

91. 91 Student Exercise

92. 92 Summary You should now be able to: Invoke the TSM client. Set up client options. Backup and restore client files. Archive and retrieve client files. Query client schedules, logs, and events. Use the client utilities to change client passwords, access a client, and remove archived data. Enhanced client functions such as Web Client Interface, LAN-free data transfer, Backup sets, and mobile client.