Sun ONE Application Server 7 Installation Guide |
Chapter 8
TroubleshootingThis chapter describes how to solve common problems that might occur during installation of the Sun Open Net Environment (Sun ONE) Application Server 7 software.
The following topics are addressed here:
About LogsThe following Sun ONE Application Server logs can be useful for troubleshooting problems you may have with installation:
- Sun ONE Application Server log file—You will find the content of this file useful for troubleshooting server configuration and deployment problems.
- HTTP server access logs—You will find the content of this file useful for troubleshooting HTTP server problems and for tracing the activity of HTTP requests entering the application server instances.
Forgotten User Name or PasswordIf you do not remember the administrative user name that was supplied during installation, try these solutions in this order:
- Enter the user name admin. This is the default user name specified in the server configuration dialog during installation.
- If this doesn’t work, look in the following file:
domain_config_dir/domain1/admin-server/config/admpw
This file contains the administrator's user name followed by the encrypted form of the administrative user's password. Seeing the user name may jog your memory.
- If this doesn’t work, delete the administrative domain and recreate it with a new password.
- As a last resort, uninstall and reinstall the Sun ONE Application Server.
Forgotten Admin Server Port NumberIf you do not remember the HTTP server port number of the Admin Server, you can inspect the Admin Server's configuration file to determine the HTTP server port number:
Connection Refused for Administration InterfaceIf the connection was refused when attempting to invoke the graphical Administration interface, it is likely that the Admin Server is not running. The Admin Server log file may be helpful in determining the reason the Admin Server is not running.
To start the Admin Server, use the command-line instructions in "Starting and Stopping the Server".
Server Won’t Start: CGI Error OccursIf the Sun ONE Application Server won’t start, you may receive the following error:
The system may require additional resources. Possible solutions are described in the following sections:
Set Limits on File Descriptions
You can use the ulimit command to determine the number of available file descriptors or set limits on the system’s available file descriptors. The ulimit command displays the limits for the current shell and its descendants.
For sh shell, the ulimit -a command lists all the current resource limits. The ulimit -n command lists the maximum file descriptors plus 1.
Change Kernel Parameters
On Solaris, increase the system resources by modifying the /etc/system file to include the following entries:
The system will require a reboot for the new kernel parameters to take effect.
After you have set the shell resources, the Sun ONE Application Server should start.
Uninstallation Failure CleanupIf an uninstallation fails, you may need to clean up some leftover files or processes before attempting a new installation.
On UNIX
If an uninstallation fails, you may need to clean up some leftover files or processes before attempting a new installation.
- Log in as root.
- Navigate to your installation directory and check the content of the /var/sadm/install/productregistry file for installed packages, that is, files having the SUNW string. For example:
cat /var/sadm/install/productregistry | grep SUNW
- Run pkgrm for the SUNW packages that were found in the product registry file. For example:
pkgrm SUNWasaco
- Remove the following files, if they are present:
/tmp/setupSDKNative
/tmp/SolarisNativeToolkit_3.0_1
- After the packages have been removed, manually remove the Sun ONE Application Server-specific entries from the product registry file itself.
rm /var/sadm/install/productregistry
- At the command line, kill all appservd processes that may be running by typing the following:
ps -ef | grep appservd
- Remove all remaining files under the Sun ONE Application Server installation directories.
- If present, remove the following log file:
/var/sadm/install/logs/Sun_ONE_Application_Server_install.log
This is necessary because every iteration of installation appends the log information to this file if it exists.
On Microsoft Windows
- From the Microsoft Windows Task Manager, stop the WindowsNativeToolkit processes, and remove the corresponding files.
- Use the wincleanup utility to remove appserv70-admin, server1, and any other related services.
Note
If the wincleanup utility is not on your Microsoft Windows machine, you will need to download it. See the Sun ONE KnowledgeBase for more information:
http://sunsolve.sun.com/pub-cgi/show.pl?target=home
Run wincleanup using the following syntax:
wincleanup service_name
where service_name is the name of your instance server as it is displayed in brackets in the Microsoft Windows Control Panel, on the Services screen. For example, the Services screen might display the following under Name:
Sun ONE Application Server 7 (server1)
In this case, the service name is server1.
For the Admin Server, use admin-server as a service name.
If no service name is provided, all services associated with the Sun ONE Application Server product will be deleted.
- Open the Microsoft Windows registry editor by clicking the Microsoft Windows Start button, choosing Run, and typing regedit in the text box.
- Remove the following registry folder and its content:
HKEY_LOCAL_MACHINE\SOFTWARE\Sun Microsystems\Application Server
- Exit the registry editor.
- From Microsoft Windows Explorer, remove the product registry file (system_drive\WinNT\system32\productregistry), or only remove the appserver entries contained in it.
- From Microsoft Windows Explorer, delete the product files from the Sun ONE Application Server installation directory.
- Reboot the system.
For Microsoft Windows—SNMP Subagent Install FailsYou must install the Microsoft Windows SNMP service before you install the Sun ONE Application Server software. If you receive an error message indicating that installation of the SNMP subagent failed, the Microsoft Windows SNMP service does not exist on your machine and the registration of the associated .dll file failed.
Unless otherwise indicated in the installation log, the rest of the product installation is unaffected by failed installation of the SNMP subagent.
For Microsoft Windows—Command Window with Startup Message Does Not AppearBecause some Windows 2000 environments do not properly include the Microsoft Windows net command in the environment, ensure that your system’s environment has access to this command. Refer to "Setting the net Command" for guidelines on resolving this issue.