Chapter 6 Troubleshooting

This chapter covers known installation issues and provides solutions and workarounds.

For late-breaking troubleshooting information, see the Solaris 8 Admin Pack Release Notes.

Contacting Customer Support

If you have any support issues, call your authorized service provider. See http://access1.sun.com for further information about support. To learn more about Sun Microsystems(TM), Inc. see http://www.sun.com.

Troubleshooting AdminSuite 3.0.1 Client Installations

The following may help resolve issues you may encounter when running AdminSuite 3.0.1 on Microsoft Windows platforms.

• Problem: After trying to start the admapp.bat file, a DOS window appears temporarily but disappears without starting anything.

  Solution #1: It is likely that one of the environment variables in the addmapp.bat file is incorrect. Make sure the following environment variables are set as indicated here:

  • WS should be set to the directory where AdminSuite is installed. For example: WS=C:\AdminSuite

  • JAVA_HOME should be set to the Java JRE or Java JDK install path. For example: set JAVA_HOME=C:\java

  • CLASSPATH should be set to point to at least the following: .;%WS%\opt\classes;%JAVA_HOME%;<swingpath>\swingall.jar. For example: set CLASSPATH=.;C:\AdminSuite\opt\classes;C:\java;C:\AdminSuite\opt\swingall.jar.

  Solution #2: The correct version of Java must be running. The entire JDK is not needed, just the JRE, but it must be version 1.1.7 or compatible. Using a JFC Swingset other than what is shipped with AdminSuite may cause problems. JFC Swingset version 1.0.3 should be used for now. There are problems with running version 1.1. If you encounter problems and error messages with "JFrame" appear, you may have to use the JFC Swingset supplied with the AdminSuite installation.

• Problem: After starting the AdminSuite Client for Microsoft Windows, and attempting to log in, an error comes back stating that the RMI registry could not be connected.

  Solution #1: The AdminSuite Server is not running on the machine you specified. Enter the name of a valid AdminSuite Server and restart the AdminSuite Client.

  Solution #2: Make sure the user name and password exist within the context of the machine name you specified for your default AdminSuite Server.