Workaround for IBM Tivoli Storage Manager
after Macintosh Leopard 10.5.7 Java Update 4


The Problem


Java Update 4 to version 10.5.7 of the Macintosh OS X Leopard operating system is said to make the following changes to the Java versions installed in operating system according the the Apple release notes:
  • Updates version 1.4 from 1.4.2_18  to version 1.4.2_21
  • Updates verison 1.5 from 1.5.0_16  to version 1.5.0_19
  • Updates version 1.6 from 1.6.0_07  to version 1.6.0_13
After the update, versions 5.5 and 6.1 of the IBM Tivoli Storage Manager application fail to launch.

Version 5.5.1.6 of Tivoli Storage Manager fails with the error  "ANS5179E TSM is unable to continue.  Exiting program" as shown in Figure 1 below.





Figure 1.  Error returned by version 5.5.1.6 of Tivoli Storage Manager
when a Macintosh OS X 10.5.7 computer has been updated with Java
Update 4 for the Macintosh operating system.





Versions 5.5.2.0 and 6.1.0.0 of the Tivoli Storage Manager application fail with a similar but different error "ANS1971E The remote client agent (dsmagent) could not be started" shown in Figure 2 below.





Figure 2.  Error returned by versions 5.5.2.0 and 6.1.0.0 of Tivoli Storage
Manager when a Macintosh OS X 10.5.7 computer has been updated with
Java Update 4 for the Macintosh operating system.





A workaround to fix the Tivoli Storage Manager Java graphical user interface




Change the operating system Java version from 1.5 to 1.4 using the directions below in order to cause Tivoli Storage Manager to be able to launch.  From a Spotlight search in the top right corner of the Macintosh window, search for "java p" as shown in Figure 3 below.





Figure 3.  Spotlight search for "java p" returns the location
of "Java Preferences"
.





Click on the "Java Preferences - Utilities" search result.  Java Preferences can also be opened from /Applications/Utilities/Java Preferences.

The Java Preferences window opens as shown below in Figure 4.





\

Figure 4.  Java Preferences utility showing Java version 1.5.0_19 selected.  This version causes the
errors shown in Figures 1 and 2 with Tivoli Storage Manager versions 5.5.1.6, 5.5.2.0, and 6.1.0.0.





In the bottom portion of the screen under the heading "Java Applications", drag and drop the entry "J2SE 1.4.2" so that it remains at the top of the list as shown in Figure 5 below.




Figure 5.  Java Preferences utility showing Java version 1.4.2_21 at the top of the list of version. 
This version of Java allows Tivoli Storage Manager versions 5.5.1.6, 5.5.2.0 and 6.1.0.0 to launch.





Close the Java preferences window.  Restart the Tivoli Storage Manager application.  No restart of the operating system is needed for the Java change to take effect.  This will have changed the Java version for the user who is logged in.  It will not have changed the Java version for the root user, and so errors continue to appear when "TSM Tools for Administrators" is used to launch Tivoli Storage Manager.

After you have finished running Tivoli Storage Manager, it might be wise to return to the Java Preferences and put back Java version 1.5 as the default.  To do this, open Java Preferences again as shown in Figure 3 above.  With Java Preferences open, in the box under Java Applications, drag the "J2SE 5.0" entry up to the top of the list and let go.  You should then be left in the state shown in Figure 4.  Close the Java Preferences window.  This change will again cause Tivoli Storage Manager to give the errors shown in Figures 1 and 2, but the computer will again be using the default version of Java 1.5.



Fix for TSM Tools for Administrators

To change the Java preferences for the administrator, the instructions below seems to work. 

Open a terminal window and enter the following commands,

cd /
cd /Applications/Utilities
cd Java\ Preferences.app
cd Contents/MacOS
sudo ./"Java Preferences"

Enter the administrator password if prompted.  After a brief delay, the Java Preferences window will open as in Figure 4 above.  Move the "J2SE 1.4.2" choice to the top of the Java Applications list by dragging and dropping.  Close the Java Preferences window.  TSM Tools for Administrators is now using Java version 1.4 and does not fail to open Tivoli Storage Manager.