EZ-Backup TSM v5.3.2.1 Macintosh OS X Upgrade 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 upgrading to TSM v5.3.2.1 on Mac OS X 10.3.9 or higher.

1. Please review the README at README_enu.htm. Note that this is now an HTML page rather than a simple text page)
2. If you are upgrading from version 5.1.5 and earlier, you will need to remove the scheduler from the "Login Items":
   1. Go to Apple Menu->System Preferences...->System/Accounts
   2. For each account:
   1. Highlight the account name
   2. Click on "Login Items"
   3. Highlight the "TSM Mac X Scheduler Daemon" and click on the "-" below the startup items window
   4. Close the System Preferences window
3. Copy the "TSM Installer" file to your local harddrive:
   1. If you are using the web browser Safari:
   1. mount the disk image (TSMInstaller.dmg) by clicking on ftp://ezbdist.cit.cornell.edu/pub/mac/5.3.2.1/TSMInstaller_FIX1.dmg
   2. drag and drop the icon to the desktop or other convenient place.
   2. If you are using the web browser Firefox:
   1. click on ftp://ezbdist.cit.cornell.edu/pub/mac/5.3.2.1/TSMInstaller_FIX1.dmg and a dialogue box will open asking you what to do with the file.
   2. highlight the radio button next to "Save to disk" and save it to the desktop or other convenient location.
4. Unmount the disk image (TSMInstaller.dmg) by either dragging it to the trash or clicking on the "eject" arrow next to its icon.
5. Double-click on the "TSM Installer"; you will be prompted for the administrative password.
6. Click "Continue"; a "README" comes up.
7. Click "Continue" again, then click "Install". TSM should begin installation.
8. When installation is complete, click "Quit".

PLEASE NOTE: There has been a change in the way the new TSM client reads directory paths. TSM now uses the Unix method of slashes (/) to delimit the directories instead of colons (:). If you have customized any options in a previous version of the client, such as the include/exclude options, you MUST rename the TSM User and System Preferences files (found in /Library/Preferences/Tivoli Storage Manager) before configuring the software. You can then open these files in a text editor as references when you customize the new client. If you miss this step, you will get an "Option Error" when you try to start the "TSM Client Configuration Assistant", with an opportunity to comment out the offending lines.

After the TSM software is installed, continue with these steps to configure the software.

1. Double-click on "TSM Backup for Administrators" to open the EZ-Backup software; enter the administrative password when prompted.
   1. The "TSM Client Configuration Assistant" should appear with the first box ("Help me configure the TSM Backup Archive Client") checked. (If not, go to "Utilities-->Setup Assistant...".) Click "OK".
   2. Make sure the radio button for "Update options for all users" is highlighted. Click the right arrow.
   3. "TSM server name" should be ADSMX.CIT.CORNELL.EDU where X is the number of the server your node was assigned when you first subscribed to EZ-Backup. If it's not, click "New Server" and enter the proper name in the box. Click "OK", then click the right arrow.
   4. TCP/IP "Server Address" should be filled in with the same server name as above (if not, type in the same server name as in step 4). Make sure the port number is the one you were assigned when you first subscribed to EZ-Backup. Click the right arrow.
   5. A dialogue box may pop up: "ANS1394E The node name contains periods. Would you like to remove them? Select "no" if this is an existing node." Click "No", regardless.
   6. "TSM node name to use" should already be filled in with your nodename. (This is the Name that was indicated on the EZ-Backup subscription form.) If not, type it in. Click the right arrow.
   7. In the next window, you will see a default list of EXCLUDE files recommended by TSM. You may wish to follow the recommendations unless you have specific files and/or directories you wish to exclude. You can enter these later in the "Preferences..." file. Click the right arrow.
   8. Next, you'll see a list of file types you may wish to exclude. Cmd-click on those types you don't want backed up. Click right arrow and follow the same procedure for the next window. Click right arrow.
   9. Click on "Finish".
   10. Back up under the "Utilities" pull-down menu, select "Setup Assistant...".
   11. Under "Which components would you like to configure", the second box ("help me configure the TSM Client Acceptor Daemon...") should be checked.
   12. Click "OK".
   13. Make sure the radio button next to "Update a previously installed scheduler" is highlighted. Click the right arrow.
   14. In the next window, next to "Schedule Log", click "Select...". Click box next to "Prune old entries" and set "Keep pruned entries..." to 7, or an appropriate number, days. Click "OK"; click "OK" again.
   15. Click "Finish". You may be prompted to login again; do so.
2. Implement IBM work-around  (see this FAQ for more information on the nature of the problem): update the Client Acceptor Daemon startup script
   
   1. Copy the "DSMCFIX" installer to your local harddrive:
      1. If you are using the web browser Safari:
      1. mount the disk image (TSMInstaller.dmg) by clicking on ftp://ezbdist.cit.cornell.edu/pub/mac/5.3.2.1/dsmcfix.dmg
      2. drag and drop the FixDSMCAD icon to the desktop or other convenient place.
      2. If you are using the web browser Firefox:
      1. click on ftp://ezbdist.cit.cornell.edu/pub/mac/5.3.2.1/dsmcfix.dmg and a dialogue box will open asking you what to do with the file.
      2. highlight the radio button next to "Save to disk" and save it to the desktop or other convenient location.
   2. Unmount the disk image (dsmcfix.dmg) by either dragging it to the trash or clicking on the "eject" arrow next to its icon.
   3. Double-click on the "FixDSMCAD" icon.
      
   4. When prompted, enter your administrative password
   5. The "FixDSMCAD" pane appears, with a description of the fix; click on "Install"
   6. The installer will install the corrected version of the dmscad startup script, and put up a message "Installation was succesful..."
      
   7. Click "Quit" to exit the installer
3. Quit TSM Backup and restart the machine.
4. Automatic backups depend on the following:
   1. The machine must be powered on,
   2. The machine must be connected to the network,
   3. The machine must be set to "wake up ": Apple Menu-System Preferences...-Energy Saver-Options, "Wake for Ethernet network administrator access".
5. The "TSM Installer" and the "DSMCFIX" may be deleted.

• There are some issues you should be aware of which may effect your backups. Please take a moment to read the EZ-Backup Frequently Asked Questions for this client.
• The "IBM Tivoli Storage Manager for Macintosh: Backup-Archive Client Installation and User's Guide", html version, was installed along with the TSM software on your computer. Look for the "TSM HTML Manual" file in the Tivoli Storage Manager folder. Double-click on this file and it will open an Internet Explorer browser containing the manual.