Sun ONE logo      Previous      Index      Next     

Sun ONE Application Server 7, Enterprise Edition Troubleshooting Guide

Contents


About This Guide
Who Should Use This Guide
How This Guide is Organized
Using the Documentation
Documentation Conventions
General Conventions
Conventions Referring to Directories
Product Support

Chapter 1   Troubleshooting Approach
Identifying the Problem
Seeking a Solution
Interpreting Messages
Types of Messages
Error Messages
Examining Log Files
Log Levels
Log Options
Client Side Logging
Obtaining a Thread Dump
Determining If This Problem Has Been Solved Before
Searching the Product Documentation
Searching the Knowledge Base
Searching or Participating in the Online Forum

Chapter 2   Installation and Uninstallation Problems
Install/Uninstall Logs
Can’t install remotely using the graphical interface.
Can’t reinstall the server.
Silent installation is not working correctly.
Is the silent installation configuration file correct?
Uninstallation failure needs cleanup.
Can’t install the load balancer plug-in.
Is your web server installed?
Is there a previously installed load balancer or reverse proxy plug-in on your system?
Has the load balancer plug-in already been installed?
Are the configuration files correct?
Load balancer won’t start.
Shared memory creation failed.
Have you configured shared memory?
Is there an error in your /etc/system file?
Did you reboot the machine after configuring shared memory?
clsetup is not working.
Have you configured shared memory?
Has remote communication been set up correctly?
Under SSH, are the HADB and the Application Server co-located on the same machine?
Are the application server and HADB installed in the same directories on each machine?
Are all the Admin Servers on the application server instances in the cluster running?
Are the input files on all instances in the cluster identical?
Unable to create HADB database using clsetup.
Problems when running clsetup as non-root.
Insufficient space.
Is the number of semaphores too low?
Can’t test the ssh setting as root.
Can’t get ssh to skip the login prompt.

Chapter 3   Startup and Login Problems
Server does not appear to be running.
Is the Application Server running?
During installation, did the initial server startup run successfully?
Is the server available locally?
Was the server started at the expected port?
Is your proxy setting causing a problem?
Has an ungraceful shutdown occurred on a previously-running server?
Can't access the Admin Server.
Has the Admin Server been started?
Are you the user who installed the Application Server?
Is the Admin Server running at the expected port?
Can’t access a server application.
Is the Application Server running?
Is the application enabled?
Was application deployment successful?
Forgot the user name or password.
Forgot the admin Server port number.
Server won’t start (CGI error).
Are limits on file descriptors adequate?
Are kernel parameters adequate?
Restart operation fails
SSL/TLS are enabled
JMS failed to start.
Are you attempting to start the instance as a non-root user?
Do Solaris bundled and unbundled domains and instances have the same names?
Do the imq logs have out of memory errors?

Chapter 4   Runtime Problems
Runtime Logs
Load Balancer / Web Server won’t start
Instance goes unused after restarting
Can’t access a web page.
Can’t access an application.
Is the application deployed?
Is your loadbalancer.xml file correct?
Is the web server running?
Has the correct port been specified for the web server?
Server responds slowly after being idle
Does the log contain “Lost connection” messages?
My application suddenly went away.
Is the application you are using being quiesced by the load balancer?
Requests are not succeeding.
Is the load balancer timeout correct?
Are the system clocks synchronized?
Have you enabled the instances of the cluster?
Is the AppServer communicating with HADB?
Server log: app persistence-type = memory
Dynamic reconfiguration failed.
Session Persistence Problems
The create-session-store command failed.
Are the HADB and the application server instance on different sides of a firewall?
Configuring instance-level session persistence didn’t work.
Session data seems to be corrupted.
HTTP session failover is not working.
Are the system clocks synchronized?
Do all objects bound to a distributed session implement the java.io.Serializable interface?
Is session information stored in HttpSession?
Is your web application distributable?
Is the persistence type set to ha?
An object is cloned instead of shared
Has a session store been created?
Are all the machines in the cluster homogenous?
Has high availability been enabled?
Out of Memory and Stack Overflow errors.
HADB Transaction Failures
Is there a shortage of HADB data devices space?
Is there a shortage of other HADB resources?
Have history files grown too large?
Other Transaction Problems
Can’t set TRANSACTION_SERIALIZABLE level for a bean.
Sporadic failures during high loads.
No space left in Tuple Log
Node-internal log gets full
Not enough locks
Frequent “High Load” Warnings
Client cannot connect to HADB.
Connection Queue Problems
Full connection queue closes socket
Connection Pool Problems
Single sign-on requires larger connection pool.
Server: Unable to obtain connection from pool
JDBC connection is not available.
Is the max-pool-size setting adequate?
Exception occurs while calling DataSource.getConnection().
Exception occurs while executing against MSSQL.
IOException: Connection in invalid state

Chapter 5   Administration Problems
Server Logs
Application Server logs
HADB History Files
HADB logs
Command-Line Interface Problems
Can’t access the command-line utility.
Can’t access the Application Server man pages.
Graphical Interface Problems
Can’t access the Administration interface.
Can’t undo accidental “changes.”
Monitoring Problems
Load Balancer Plug-in isn’t being monitored
Authentication/Authorization Problems
Can’t import the certificate for my server.
Has the trust database been created?
Was the certificate generated with the right tool?
The server does not recognize my certificate.
LDAP authentication/equalization is not working.
HADB Administration Problems
hadbm command fails: host unreachable.
Is the host up and running?
Is RSH or SSH set up and running?
Are the SSH binaries in the proper location?
hadbm command fails: command not found
hadbm command fails: JAVA_HOME not defined
create fails: “path does not exist on a host”
database doesn’t start.
Was there a shared memory get segment failure?
Do the history files contain errors?
Do you need a simple solution?
clear command failed
create-session-store failed
Invalid user name or password
SQLException: No suitable driver
“No space left on device” appears in server.log
node status is “starting” after issuing stopnode.
Node failure occurred.
Double node failure occurred.
Can’t restart the HADB after an ungraceful shutdown.
hadbm command doesn’t return control to user.
Cluster Administration Problems
Refragmentation of the HADB fails.
Is there enough space on the data devices?
The cladmin command is not working.
Are the Admin Servers of all the instances in the cluster started?
Do all the instances in the cluster have same administrator user name and password?
Are the input files correct?
Are the input files on all instances in the cluster identical?
Application is not available on the cluster.
Did the application deploy successfully to the cluster?
Common Administration and Recovery Actions
Examine the history files
Maintain service while taking HADB offline
Clear the database and recreate session store

Chapter 6   Deployment Problems
EJB Problems
CMP Problems
Are you using a supported JDBC driver?
Ant Problems
Can’t run Ant remotely.

Chapter 7   Integration Problems
Web Server Problems
Sun ONE Web Server Problems
Apache Web Server Problems
Reverse Proxy Plug-In Problems
Messaging Problems
JMS broker won’t start.
Can’t reestablish Sun ONE Message Queue broker in a cluster environment.
IDE Problems
Application Server is not in the Sun ONE Studio Server Registry.
Is the Application Server plug-in for Sun ONE Studio installed?
Is the plug-in configured with the Application Server installation directory?
Is the Application Server registered?

Chapter 8   Migration Problems
Migration Toolbox doesn’t run correctly.
Is the script customized for your environment?
Are JAR files in your extension directory?
Are you using the correct JDK?
Non-fatal error occurs during extraction.
Are you doing a NetDynamics migration?
Is manual migration warranted?
Fatal error occurs during extraction.
Translation error occurs.
Trouble migrating from WebLogic.

Chapter 9   Upgrade Problems
Upgrade Log
Package-based installation consistently fails.
User ID errors occur.
Errors occur during the backup.
Errors occur during reconfiguration.
Upgrade interrupted; server is in inconsistent state.
Doing a partial online upgrade of a cluster causes problems.

Appendix A   Summary of High Availability Commands
Appendix B   Frequently Asked Questions (FAQs)
Installation and Initial Access
How do I obtain version information?
How do I access the sample applications?
Licensing
How do I renew an expired evaluation license?
Can I upgrade from an evaluation license to a full Sun ONE Application Server 7 license?
In a media package, how do I get the license key?
How can I get an evaluation license for Enterprise Edition?
Platform Support
What’s the difference between Platform Edition, Standard Edition, and Enterprise Edition?
What Sun ONE Message Queue versions are supported?
What J2SE versions are supported?
What database drivers are supported?
Is JADO supported for Sun ONE Application Server 7?
Does Sun ONE Application Server 7 have a JCA connector to talk to SAP R3?
Are custom authorization providers supported?
How is load balancing supported?
Functional Support
Can remote EJB clients use something other than RMI over IIOP, or is that the only support protocol?
Is sticky load balancing supported?
Are multiple JVMs for hosting components supported?
High-Availability
Where are the load balancer files?
How do I enable the health checker?
Server Administration and Operation
How do I start a single application server instance rather than all the instances in a domain?
What is the ‘Apply Changes Required’ message about?
Why are multiple IIOP listeners useful and how many listeners are allowed?
Does an application server instance have to be running in order to deploy to it?
Does the Admin Server need to be running in order for me to run my application?
Can I configure Sun ONE Application Server 7 to run as non-root?
Application Debugging
Can I modify roles in the web or EJB deployment descriptors without restarting the application server?
Upgrade/Migration
Can I upgrade from other versions of Sun ONE Application Server 7 to Enterprise Edition?

Index


Previous      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.