EZ-Backup TSM v5.2.5.0 Macintosh OS X (10.1.5 to 10.3.8) Clean Install Instructions

This document assumes that the computer is already subscribed to the EZ-Backup service. Its Node Name and Password will be required to complete the installation. If this computer is not yet registered, please go to the EZ-Backup Home Page to subscribe.

This procedure is for a clean installation of TSM v5.2.5.0 on Mac OS X 10.1.5 to Mac OS X 10.3.8*. Make sure you remove all elements of any other TSM clients before installation and configuration of this version. Version 5.2.5.0 is also recommended by the EZ-Backup team for the new Intel-based Macintoshes. Please see FAQ-MAC-33.html for details.

*Mac OS X 10.3.9 and later  is  officially supported by TSM client  5.3.2.1.

To install the EZ-Backup TSM software on a Macintosh OS X system (you will need the administrative password for the system):
  1. First please view the README at TSM525C_MAC.README.TXT.
  2. Download the "TSM Installer" to your Desktop.  This experience will vary from user to user, depending on browser used, the settings for that browser, and whether the user has an application such as Stuff-IT Expander installed, and how that application is configured.
    1. Start the download by clicking on ftp://ezbdist.cit.cornell.edu/pub/mac/5.2.5.0/TSM525C_MAC.hqz
      • If a dialogue box open asking you what to do with the file, highlight the radio button next to "Save to disk" and save it to the Desktop.
    2. (If necessary) Double-click on "TSM525C_MAC.hqx" on the Desktop to unpack it.
    3. (If necessary), double-click on  "TSMInstaller.dmg" to mount it
    4. (If necessary), copy the "TSM Installer" application from the "TSMInstaller.dmg" disk image to the Desktop
  3. Double-click on the "TSM Installer" icon on the Desktop.  Enter your Mac administrator password when prompted.
  4. Click "Continue"; a "README" comes up.
  5. Click "Continue" again. The TSMInstaller pane should come up
  6. Click "Install". TSM should begin installation.  (Note: The following instructions assume the default install of 3 components is performed).
  7. Upon successful installation, click "Quit".
  8. The "TSM Installer" can be deleted from the Desktop.
  9. (If necessary) Unmount the disk image (TSMInstaller.dmg) by either dragging it to the trash or clicking on the "eject" arrow next to its icon.
  10. (If necessary) Delete the "TSM525C_MAC.hqz" frile from the Desktop

After the TSM software is installed, continue with these steps to configure the TSM Backup for Administrators application.

  1. The install process should have ended with a Finder window open to the "Tivoli Storage Manager v5.2.5" folder.   If not, open a Finder window and  navigate to this folder: "Applications -> Tivoli Storage Manager v5.2.5".
  2. Double-click on "TSM Backup for Administrators" to open the EZ-Backup software (you will need the administrator password).
  3. The "TSM Client Configuration Assistant" should appear.  If not, start the Assistant: "Utilities-->Setup Assistant...".
  4. A dialogue box may appear: "ANS1392W The TCA file permissions are not correct. Would you like to update the permissions?" Click "Yes".
  5. Make sure that only the "Help me configure the TSM Backup Archive Client" is selected. Click "OK"
  6. Make sure the radio button for "Set options for all users" is highlighted. Click the right arrow.
  7. Set the TSM server name:
    1.  Click "New Server" button
    2. Enter "ADSMX.CIT.CORNELL.EDU" where X is the number of the server specified in the EZ-Backup subscription confirmation e-mail.
    3. Click "OK"
    4. Click the right arrow.
  8. Set the TCP/IP Paramters
    1. Set the address to the same server name (ADSMX.CIT.CORNELL.EDU) as above.
    2. Set the port number is the one supplied in the EZ-Backup subscription confirmation e-mail.
    3. Click the right arrow.
  9. A window may appear with the message "ANS1394E The node name contains periods." and accompanying descriptive text. If it does, click "No"
  10. Set the TSM node name to the name indicated on the EZ-Backup subscription form. Click the right arrow.
  11. Make no changes to the "Domain list" and the "Include/exclude list" at this time. Click the right arrow.
  12. Click on "Finish".
  13. When prompted, login into the TSM server, using the password supplied in the EZ-Backup subscription confirmation e-mail..
  14. Next, edit Preferences, either by 'Edit -> Preferences' or by 'TSM Backup -> Preferences'.
  15. The Preferences pane should appear, at the "General" preferences.  Click on the 'Select' button next to 'Error Log'.
  16. Click on "Prune old entries", and then use the up arrow to set "Keep pruned entries for" to 7 days.  Click "OK".
  17. In the left hand window (titled "Preferences") select "Backup".
  18. Unclick "Use memory-saving algorithm".
  19. In the left hand window (titled "Preferences") select "Authorization".
  20. In the "Password Access" box, select "Password Generate".
  21. Click "OK".
  22. You should be asked to "Please restart client for new preferences to take effect".  Click "OK".
  23. Quit TSM Backup: 'TSM Backup -> Quit TSM Backup'.
The TSM 5.2.5.0 client does not come with a set of INCLUDE/EXCLUDE statements.  The  EZ-Backup Team  has compiled a recommended list of excludes: Mac5250_inclexcl.txt
This list contains folders that contain temporary files (such as browser caches) that can be large, and would make the nightly backup longer (as well as larger)
  1. Using TextEdit (or similar), manual paste the contents of the list into the TSM System Preferences file ("Macintosh HD -> Library -> Preferences -> Tivoli Storage Manager -> TSM System Preferences")
  2. As a guide when setting Include-Excludes using the TSM client's Preferences (from within the "TSM Backup for Administrators" application TSM Backup -> Preferences)
********* If you are installing on an Intel Mac, please skip the following for now. ******************

The following steps configure the TSM Client Acceptor Daemon on PowerPC Macs, the process which controls scheduled backups. 
  1. There should be a Finder window open to the "Tivoli Storage Manager v5.2.5" folder still open.  If not, open a Finder window and  navigate tothis folder: "Applications -> Tivoli Storage Manager v5.2.5".
  2. Double-click on "TSM Backup for Administrators" to open the EZ-Backup software (you will need the administrator password).
  3. If prompted, login into the TSM server, using the existing nodename (which should be displayed) and password.
  4. Start the "TSM Client Configuration Assistant": "Utilities -> Setup Assistant...".
  5. Under "Which components would you like to configure", check the second box ("help me configure the TSM Client Acceptor Daemon...").
  6. Click "OK".
  7. Make sure the radio button next to "Install a new scheduler" is highlighted. Click the right arrow.
  8. The Preferences pane should appear, at the  "Scheduler" preferences.  Click on the 'Select' button next to 'Schedule Log'.
  9. Click on "Prune old entries", and then use the up arrow to set "Keep pruned entries for" to 7 days.  Click "OK".
  10. Keep all the other defaults; click "OK".
  11. Click "Finish".
  12. Quit TSM Backup.
  13. Automatic backups depend on the following:

If there is concern about security, the screen saver or screen lock can be used to protect the system from access while logged in (Apple Menu-System Preferences...-Desktop & Screen Saver).

If you wish to uninstall the Tivoli 5.1.5.13 client, delete the following folders (by dragging them from the Finder window to the Trash icon):

More information on using EZ-Backup: In case of problems not covered in the IBM documentation and EZ-Backup Frequently Asked Questions, please send e-mail to ezbackup@cornell.edu
Last Updated: 04/25/06 by rpt4