============================================================================== IBM Tivoli Storage Manager README Macintosh Backup-Archive Client Version 5, Release 2, Level 2.0 PTF IP22732 Licensed Materials - Property of IBM (C) Copyright IBM Corporation 1990, 2003. All rights reserved. ============================================================================== This Readme is divided into the following sections: 1. Before You Install Your Client - Warnings - Client Components - Software Requirements - Hardware Requirements - Migration Information 2. Installing the Client - Installing the Client - Setup - Uninstalling the Client 3. Late-Breaking News - What's New - Documentation Updates - Known Problems and Limitations 4. Getting Help - Online Help - Platform Specific Documentation - Product Documentation - Technical Support 5. Trademarks 6. APARS resolved --------------------------------- 1. Before You Install Your Client --------------------------------- Warnings -------- - Case Sensitive HFS+ support MacOS X 10.3 supports an optional Case Sensitive HFS+ filesystem. Before backing up any files in that filesystem ensure the new Case Sensitive HFS+ volume does not have the same name as any existing TSM volumes for the node. Either the TSM volumes can be renamed on the TSM server, or the CS HFS+ volume can be renamed locally. - Data that has been backed up or archived from a Tivoli Storage Manager V5.1.5 or V5.2.0 client to any Tivoli Storage Manager server cannot be restored or retrieved using a Tivoli Storage Manager V5.1 or lower level client. - Once a Unicode TSM client has been used to connect to a TSM V4.2.0 or V4.2.1 server with a given node name, that node name can no longer be used by a non-unicode TSM client. For example, when a node name used with TSM V5.1.5, is subsequently used with the V5.2.0 Mac OS X Unicode client, the V5.1.5 client will no longer be able to access that node's data from the TSM server. It will receive the message "ANS1357S Session rejected: Downlevel client code version". If the TSM server is at V4.2.2 or higher, the non-unicode client can still subsequently connect to the server using the same node name, as long as no unicode filespaces exist for that node. This change was made in server APAR IC32075. This means that if you are at server level V4.2.0 or V4.2.1, you will NOT be able to use any client version prior to 5.2.0 after the 5.2.0 client has connected to the server. If your server is at V4.2.2 or higher, you will be able to return to previous version of the client, provided NO Unicode-enabled filespaces exist for your node. Client Components ----------------- - The following components are included with the TSM Version 5.2.2 Clients for Macintosh: - Backup-Archive Client (GUI and Command Line Interface) - Administrative Client (Command Line Interface) - Backup-Archive client GUI Scheduler Software Requirements --------------------- Backup/Archive Client Component ------------------------------- The backup/archive client requires the following software in order to run: - Mac OS X, version 10.1.5+ - Microsoft Internet Explorer v5.0+ The backup/archive command line tools require the following software in order to run: - Mac OS X, version 10.2.6+ Backup/Archive Web component ---------------------------- - A web client for Macintosh systems is not available. However, Macintosh systems can be used to connect to Web Clients running on other systems. - The Web Client runs on Microsoft Internet Explorer 5.1 on Mac OS X, Version 10.1 with JRE 1.3.1 installed. Hardware Requirements --------------------- - A PowerPC based Macintosh with: 20 MB available disk space 128 MB memory for Mac OS X Migration Information --------------------- - Migration information in the documentation Please see the TSM book "Tivoli Storage Manager for (PLATFORM) Backup-Archive Client Installation and User's Guide" Chapter 1 for migration information on: - Terminology changes - Upgrading from earlier version clients - Processing virtual mount points - Client-Server communications methods - Upgrades paths for Clients and Servers - Unicode-enabled Client (Windows and Mac) - Web Client The client books are located on the Publications CD and in the client packages. They are also available on the World Wide Web at: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.htm l This link will take you to the Tivoli Storage Manager Technical Support Page from which you can follow "Product Information" link or the "Related Link" of "Library". - Migration compatibility As part of a migration plan from Tivoli Storage Manager V5.1 to Tivoli Storage Manager V5.2, Tivoli Storage Manager clients and servers may be upgraded at different times. V5.1 clients can perform backup, archive, migrate, restore, retrieve, and recall functions to a V5.2 server. V5.2 clients can perform backup, archive, migrate, restore, retrieve, and recall functions to a V5.1 server. See Chapter 1 of the client books for more detailed compatibility information. - Data that has been backed up, archived, or migrated from a Tivoli Storage Manager V5.1.5 client to any Tivoli Storage Manager server cannot be restored, retrieved, or recalled using a Tivoli Storage Manager V5.1 or lower level client. - The format of the client data header was changed in V5.1.5 to include new service information. Once files have been backed up or archived by a V5.1.5 client to any Tivoli Storage Manager server, those files cannot be restored or retrieved by any lower-level client. ------------------------ 2. Installing the Client ------------------------ Installing the Client --------------------- === Installing From the TSM CD === a. The Macintosh client installer is in the 'tsmcli/mac' directory. b. Use a BinHex translator to convert the file to a Mac application. c. Follow the instructions in "Installing TSM for the First Time." === Installing From an FTP Site === a. Download the Mac installer file. If you're using Fetch or Netscape, it will automatically convert the file from BinHex format to the install program (TSM Installer). If you're using a standard FTP program, you will need to transfer the file in ASCII format, then use a BinHex translator to convert the file to a Mac application. b. Follow the instructions in "Installing TSM for the First Time." === Installing TSM for the First Time === a. Double-click the "TSM Installer" icon b. Read the displayed Read Me text for any additional information. c. The installer will allow you to navigate to where you wish to install TSM, and prompt you to enter the name of the folder to install TSM into. d. Start the "TSM Mac X Backup" program by double-clicking the icon. The Setup Assistant will guide you through setting up TSM. === Updating a Previously Installed Version of ADSM or TSM === Mac OS X Installation details: The first time TSM is run, the preference folder: /Library/Preferences/Tivoli Storage Manager is created. The permissions for this folder are set to 775. This folder can be created from a terminal window, but it is easier to let Tivoli Storage Manager create it for you. Setup ----- - The Mac client now uses two files for preferences. The following sample preference files are included in the installation folder: TSM User Preferences - Sample TSM System Preferences - Sample You will need to copy the sample files provided to: TSM User Preferences TSM System Preferences You will need to modify these files for your setup. - The first time Tivoli Storage Manager runs, a preference folder is created in /Library/Preferences. You can create this folder from a terminal window, but it is easier to have Tivoli Storage Manger do this for you. After this folder has been created, copy the samples to the folder. - If you are updating from a version of Tivoli Storage Manager prior to 5.1.0, please note the following: - you will need to copy any existing password files from the Mac OS 9 'System Folder:Preferences:Tivoli Storage Manager' folder to the Mac OS X preference folder. Previous versions of Tivoli Storage Manager password files are named like ########.PWD. - There is no automated process to assist with importing your options from a previous version of Tivoli Storage Manager. It may be easiest to open the old option file in a text editor then use the Configuration Assistant and the Preference Editor to set the options to the values in the old preference file. Uninstalling the Client ----------------------- --------------------- 3. Late-Breaking News --------------------- What's New ---------- - What's new in the IBM Tivoli Storage Manager Version 5.2.2 Clients: - AIX GPFS 2.2 HSM partial-file recall - AIX GPFS 2.2 LAN-free data movement for HSM migrate and recall - Backup-Archive command-line client operand limit extension - Data protection retention for archive objects through API applications - Deletion hold/release through API applications - Event-based retention policy through API applications - HP-UX HSM support for HP-UX 11i and VERITAS File System 3.5 - HSM JAVA GUI (unsupported preview) - IBM TotalStorage SAN File System support - Language support expanded to include Russian, Hungarian, Czech, and Polish - Linux on Intel x86 HSM support for GPFS 2.2 file system - Linux on Intel Itanium Backup-Archive client - Macintosh OS X boot-time scheduler support - Macintosh OS X command-line Administrative client interface - Macintosh OS X command-line Backup-Archive client interface - Macintosh OS X support for non-administrator users on Mac OS 10.2 and Mac OS 10.3 only. - Mozilla 1.4 browser support on AIX platforms - Multi-session backup enhancements - NetWare 6.5 Backup-Archive client support - Symbolic link exclusion support - VERITAS Cluster Server support for Windows - VERITAS File System support for AIX 5.2 - What's new in the IBM Tivoli Storage Manager Version 5.2.0 Clients: - AIX support for VxFS file systems and Veritas Volume Manager - AUTOMOUNT support for Linux - federated file backup - firewall support for scheduled client operations - GPFS HSM support for pSeries in AIX HACMP/ES cluster - Java GUI for UNIX Backup-Archive clients - HSM LAN-free toleration - HSM non-root user support for HSM clients - Language pack support for Windows Backup-Archive clients - Language support improved for HP-UX, Solaris, and Linux/390 clients - Macintosh OS X Unicode support - NDMP file-level restore - NDS backup automation for NetWare - QUERY FILESPACE enhancement - QUERY IMAGE enhancement - QUERY INCLEXCL enhancement - QUERY OPTIONS - QUERY SYSTEMINFO - Snapshot support for external snapshot mechanisms - Solaris 9 Backup-Archive client and 64-bit HSM client - Sparse file handling improvements for UNIX Backup-Archive clients - Streaming mode for HSM on file recall - SuSE Linux Version8 Backup-Archive client for pSeries hardware - TRACESEGSIZE option to split trace files - Web client functional enhancments - Web client sticky apps support - Websphere 5.0 support - Windows First failure data capture for program exceptions - Windows Server 2003 Backup-Archive and API client - Windows Automated System Recovery (ASR) for XP and Windows Server 2003 - Windows Server 2003 support for System State using VSS - Windows on-line image backup for XP - Windows Open File Support for Windows 2000 / XP - Windows RESETARCHIVEATTRIBUTE option Documentation Updates --------------------- - Page 23 Excluding system files and Page 45 Volume Naming precautions Volumes with ... in their name are not supported. TSM uses the ... sequence as part of include/exclude processing. TSM will report an invalid include/exclude statment if a volume has ... in the name. The volume must be renamed. Known Problems and Limitations ------------------------------ Macintosh client limitations ---------------------------- - When an input path to the command line contains a symbolic link, the symbolic link is resolved and the target of the link is processed instead of the symbolic link. This only occurs when the path is input to the command line. When a symbolic link in encountered during normal pro- cessing, the symbolic link is processed instead of the target of the link. This is due to limitations in Mac OS X. - On Mac OS X 10.3 (Panther), the last access time of objects that are backed up is not updated to the time of the backup. This is due to changes in Mac OS X 10.3. - On Mac OS X 10.3 (Panther), volume names can now be upto 255 characters long. If a UFS volume name is at or near this limit, TSM may crash. This is due to limitations in Mac OS X. - Mac OS X 10.3 (Panther) 'FileVault' feature. The FileVault feature compresses a users home directory into a single file. TSM is not able to access any user files inside a FileVault home directory. TSM is able to backup the user's home directory as a single file. Due to how FileVault home directories are managed by Mac OS X, it is recommended that any FileVault home directories be backed up when the user is not logged in. When a user is logged in, the home directory is mounted in a temporary folder in /Users/., as a result of this, the sparse file will be backed up again under this temporary folder. TSM is able to restore a user's home directory if the user is not logged in. This means that a user can not restore their own home directory. User home directories can be restored by the system administator. A second system administrator account must be created so the primary system administrator account can be restored. - On Mac OS 10.1.5, only a system administrator can use TSM. - TSM can be used to back up network volumes. However, errors will occur if a full volume backup of a remote boot volume is attempted. Instead of doing a full volume backup, select specific folders or files to backup. - Drag-n-drop of a TSM User Preference file does not work for TSM Backup for Administrators, TSM Scheduler for Administrators or TSM Scheduler Daemon for Administrators. The root user may drag-n-drop a preference file on "TSM Backup", "TSM Scheduler", or TSM Scheduler Daemon" The root user may also double-click on a TSM User Preference to start TSM. - Data that has been backed up from a Mac OS versions prior to Mac OS X, will not have the correct file owner or permissions when restored on Mac OS X. After the restore is complete use the 'sudo chown' and 'sudo chmod' commands to set them. - Tivoli Storage Manager will not recognize nfs mounted filesytesm. Nfs mount points must be excluded from processing with the EXCLUDE.DIR option. Failure to exclude nfs mount point may cause the mount point attributes to be restored improperly. If this occurs, remove and recreate the mount point. - When files backed up from an HFS volume are restored to a UFS volume, the resource forks will not have the correct owner. This can be corrected by using the chown command on the resouce fork file. - Due to limitations in Mac OS 10.1.5, Tivoli Storage Manager will hang when certain characters are found in folder or file names. In general, Greek and Latin characters with two combining symbols are suspect. For example, the following Unicode charactes: 1EAF - Latin Small Letter 'a' with Breve and Acute 1FD2 - Greek Small Letter 'iota' with Dialytika and Veria have two combining symbols and will cause Tivoli Storage Manager to hang. Names with these types of characters will need to be renamed. - Due to limitations in Mac OS X, Tivoli Storage Manager will crash if it encounters any of the following Unicode symbols as part of a name: D800 - D87F - DB80 - DBFF - DC00 - NOTE: These are special Unicode flag symbols. They are not normally used as characters. - Mac OS X user and group name support Use of user and group names longer than 64 bytes with TSM operations can result in unknown TSM behavior. For instance, backing up objects for a user with a 'shortname' greater than 63 bytes can have undesired behavior. Common client limitations ---------------------------- - Web Client JRE 1.4 issue When using the Web Client with JRE 1.4 and above, these error message will be logged in the dsmerror.log on the machine where the TSM Client Acceptor resides when push buttons on the applet are pressed: Error -50 sending ht request Error writing to http socket ANS1005E TCP/IP read error on socket = X, errno = Y, reason : 'Connection reset by peer' or 'Connection aborted by host machine' ANS1006E TCP/IP write error on socket = X, errno = Y, reason : 'Connection reset by peer' or 'Connection aborted by host machine' This could potentially fill up your dsmerror.log with these messages. In order to prevent these messages from appearing in the error log, please disable caching in the JRE. This can be done through the "Java Plug-in Control Panel" under the "Cache" tab. Once this has been disabled, these error message should no longer appear. If you are using JRE 1.3.1_XX, this will not be a problem. If you are experiencing hangs with the web client using JRE 1.4 and above, disabling caching on the Java Plug-in will usually resolve this issue as well. - Node access list window (Web/Java GUI) When the change button is clicked in the Node Access List dialog on the Web Client and Java GUI, the currently selected rule's path will not be highlighted in the tree displayed in the Change Access Rule dialog. This will be fixed in a future release. - Access another node (Web/Java GUI) When accessing another node in the Web/Java GUI, the restore tree does not display images to which the other node has given you access. Use the access another node utility in the native GUI or the set access function in the command line client to restore images of another node to which you you have access. - Disable browser's proxy server if Web Client produces Security Exception If you get a Security Exception error when running the Web Client in your browser due to the Web Client trying to open a TCP/IP socket to a socks server, disable the proxy server via your browser settings or Java Plugin control panel. See the "Starting a Web Client Session" section in Chapter 3 "Getting Started" of the TSM B/A Installation and User's Guide for more information. - Web Client concurrent restore and tree expansion issues Running more than one restore or retrieve operation at the same time when using the Web Client may cause the browser to hang when destination or message windows from the different restore/retrieve processes appear on the screen at the same time. If you observe such behavior, wait until one restore/retrieve operation is finished before starting another. When using the Web Client, if you click on "Expand Entire Branch" and then click on "Collapse Entire Branch" through the View menu item in the backup or restore tree window, this may cause the browser to crash due to resource limitations. - Canceling restore when using the Backup/Archive GUI, Web GUI, and Java GUI If the user cancels a restore by choosing cancel from the GUI or aborts the restore, there will not be a restartable session available at the server. - Changing the language of the Web Client on an AIX browser To display the Web Client in a language other than the default language on an AIX browser, change the language at login time (Options->Language). For double-byte languages (Japanese, Chinese, Korean) in particular, the browser will not work properly if the locale is changed after login. - Web Client online help language issues When viewing the Web Client double-byte character set online help using Netscape Communicator, re-sizing the left navigation frame in the Help browser window may cause the text in the navigation frame to become garbled. Click the 'Reload' button in your Web browser to refresh the text. To view the non-English online help from the Web Client applet, you must install the language versions of the help files on the agent, the machine where the Tivoli Storage Manager Backup-Archive client was installed. If the language versions are not installed or are not available, the online help will be displayed in English. - Fonts required to display non-English characters in directory or file names with the Web Client are as follows: - For browsers running on AIX, the browser machine must have the WorldType fonts (available as package X11.fnt.ucs.ttf - AIXwindows Unicode True Type Fonts on the AIX distribution media) installed. - For browsers running on Windows, the browser machine must have the Arial Unicode MS font installed. This font is available with MS Word 2002 and MS Office XP. See Microsoft's KB article 287247 for installation instructions. If you require this font, contact your Microsoft representative. - Garbled characters in Administrative Client GUI due to locale If the Administrative Client is running in a different locale from that of the server, messages may contain some number of unintelligible characters. For best results, make sure the administrative client and the server are running in compatible locales. - Installing the Tivoli Storage Manager Backup-Archive client to a path greater than 1024 may cause a system abend. Problem ticket 48831 has been opened with Mindvision VISE Installer. --------------- 4. Getting Help --------------- Online Help ----------- [NONE] Platform Specific Documentation ------------------------------- [NONE] Product Documentation --------------------- - IBM Tivoli Storage Manager publications are available in softcopy Adobe Acrobat Reader format (.pdf) and HTML (.htm) format on the IBM Tivoli Storage Manager Publications CD and at the following Web page: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.htm l This link will take you to the Tivoli Storage Manager Technical Support Page from which you can follow "Product Information" link or the "Related Link" of "Library". Technical Support ----------------- - To receive technical support for Tivoli Storage Manager: - Contact your Tivoli Storage Manager administrator. This should be your first step when having problems. - Your administrator will know how to contact IBM for Technical Support on your behalf. - For additional information about Tivoli Storage Manager technical support visit the technical support web site. The URL is: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.htm l - To participate in user discussions of Tivoli Storage Manager you can subscribe to the ADSM-L list server. This is a user forum maintained by Marist College. While not officially supported by IBM, Tivoli Storage Manager developers and other IBM support staff also participate on an informal, best-effort basis. Because this is not an official IBM support channel, you should contact IBM Technical Support if you require a response specifically from IBM. You can subscribe by sending a note to the following e-mail address: listserv@vm.marist.edu The body of the message must contain the following: SUBSCRIBE ADSM-L yourfirstname yourlastname The list server will send you a response asking you to confirm the subscription request. Once you confirm your subscription request, the list server will send you further instructions. You will then be able to post messages to the list server by sending e-mail to: ADSM-L@vm.marist.edu If at a later time you wish to unsubscribe from ADSM-L, you can send a note to the following e-mail address: listserv@vm.marist.edu The body of the message must contain the following: SIGNOFF ADSM-L You can also read and search the ADSM-L archives at the following URL: http://www.adsm.org - Anonymous FTP server IBM supports an anonymous FTP server where you can find PTF (fix pack) maintenance and other Tivoli Storage Manager-related materials. Three other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are: - ftp.software.ibm.com/storage (primary - IBM) - ftp.rz.uni-karlsruhe.de (mirror - Germany) - ftp.wu-wien.ac.at (mirror - Austria) - ftp.cac.psu.edu (mirror - Pennsylvania) - For the latest information about Tivoli Storage Manager, visit the home page on the World Wide Web. The URL is: http://www.ibm.com/software/tivoli/products/storage-mgr/index.html ------------- 5. Trademarks ------------- - The following terms are trademarks of the IBM Corporation in the United States or other countries or both: - AIX - Application System/400 - AS/400 - Client Access/400 - DYNIX/ptx - IBM - IBMLink - NUMA-Q - Operating System/400 - z/OS - OS/390 - OS/400 - PTX - RACF - RISC System/6000 - RS/6000 - Scalable POWERparallel - SP2 - S/390 - System/390 - VisualAge - UNIX is a registered trademark of The Open Group in the United States and other countries. - Microsoft, Windows, Windows NT, Windows 2000, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. - Jaz and Zip are trademarks or registered trademarks of Iomega Corporation in the United States, other countries, or both. - Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. - Tivoli is a trademark of Tivoli Systems Inc. in the United States, or other countries, or both. - Other company, product, and service names may be trademarks or service marks of others. ----------------- 6. APARS resolved ----------------- APARs fixed in Version 5, Release 2, Level 2.0 ----------------------------------------------- IC36091 - WHEN FILESPACE NULL IS RETURNED FROM parseBackOperand IN IC36454 - TSM CLIENT CRASHES DURING BACKUP. IC36543 - TSM CLIENT NQR (NO QUERY RESTORE) CAN TERMINATE IMPROPERLY IF THE RESTORE IS INTERRUPTED BY A DISK FULL/QUOTA CONDITION. IC36559 - DSM.SYS POSTSCHEDULE NOT CORRECTLY EXECUTED AFTER SCHEDULE WITH SERVER - POSTS OPTION. IC36649 - MANUAL ERRONEOUSLY REPORTS EXCLUDE.FS TO BE SUPPORTED ON MAC 5.1 CLIENT. IC36960 - SOME OPTIONS SET IN THE SERVER SCHEDULE ARE NOT HONORED BY THE CLIENT. IC37395 - TSM CLIENT IMAGE BACKUP RETURNS INCORRECT MESSAGE, ANS1004W INSTEAD OF ANS1312E WHEN A MEDIA MOUNT IS NOT POSSIBLE. IC37421 - BACKUP FAILS WITH ERROR MESSAGE ANS1074I *** USER ABORT *** . IC37523 - SCHEDULER ERRONEOUSLY REPORTS "COMPLETED SUCCESSFULLY" WHEN EVENT IS MISSED WITH ANS1351E MESSAGE. IC37627 - WHEN IMAGE BACKUP FAILS, MESSAGE "ANS1804E SELECTIVE BACKUP PROCESSING FOR 'FOO' FINISHED WITH FAILURES" IS ISSUED. IC37680 - TOTIME DEFAULT NOT HONORED WITH TODATE OPTION. IC37907 - TSM V5.2.0 MAC CLIENT DOES NOT BACKUP AND RESTORE FILES IN THE NEW OPTIONAL MACOS X 10.3 CASE SENSITIVE HFS+ FS CORRECTLY. IC37921 - TSM V5.2 MAC CLIENT CAN CRASH IF NEW LONGER MACOS X 10.3 VOLUME NAMES ARE USED.