Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Application Server 7 2004Q2 Update 1 Standard and Enterprise Edition Troubleshooting Guide 

Contents


About This Guide
Who Should Use This Guide
Using the Documentation
How This Guide Is Organized
Documentation Conventions
General Conventions
Conventions Referring to Directories
Contacting Sun
Give Us Feedback
Obtain Training
Contact Product Support

Chapter 1   Troubleshooting Approach
Identifying the Problem
Seeking a Solution
Evaluate Messages
Types of Messages
Error Messages
Examine Log Files
Log Levels
Log Options
Client Side Logging
Obtaining a Thread Dump
See if the Problem has been Solved Before
Search the Product Documentation
Search the Knowledge Base
Search or Participate in the Online Forum
Contact Support

Chapter 2   Installation and Uninstallation Problems
Install/Uninstall Logs
Can’t install remotely using the graphical interface
Setup failure during Linux install
Pre-existing JDK prevents installation, even after it has been removed
Install or upgrade of J2SE fails
Incompatible J2SE version---cannot upgrade
Failure to install J2SE
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?
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?
Are there any other processes consuming shared memory?
Are old AS or HADB installations occupying shared memory and semaphores?
clsetup is not working
Was a previous clsetup terminated prematurely?
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?
HADB database creation fails
No available memory
Specified hosts are not reachable
Too few semaphores
hadbm create Fails
HADB Database Nodes Cannot be Reached
HADB Creation Failures on Windows platform
Problems when running clsetup as non-root
Can’t test the ssh setting as root
Can’t get ssh to skip the login prompt
Error configuring JMS Physical Destinations

Chapter 3   Startup and Login Problems
Can’t access server’s initial screen
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, and is the application deployed?
Is the application enabled?
Was application deployment successful?
Forgot the user name or password.
Forgot the admin Server port number.
Server won’t start
File parsing failure: loadbalancer.xml not found
Invalid password(s)
Abnormal subprocess termination / core dump
CGI error
Load balancer won’t start
Parser can’t open loadbalancer.xml
Identical instance names
Load balancer / web server won’t start—listener ports
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
Can’t stop a remote server instance
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?
Application suddenly goes 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 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
Performance Problems
Too much swapping in a colocated HADB system
Indefinite looping in server.log after MDB failure
Performance suffers when using server-side SOAP message handlers
Low Memory in MQ Broker
HADB Performance Problems
Is there a shortage of CPU or memory resources/too much swapping?
Is There a Disk Contention?
Is there a shortage of HADB data devices space?
Is there a shortage of other HADB resources?
Direct Disk I/O Mapping Failed Errors
High Load Problems
Is the Tuple Log out of space?
Is the node-internal log full?
Are there enough locks?
Can you fix the problem by doing some performance tuning?
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
Common Runtime Procedures
Improving CPU Utilization

Chapter 5   HADB Issues on Windows
HADB Database Creation Fails
No Available Memory
Description
Solution 1
Solution 2
Too Few Semaphores
Description
Solution
Database Nodes Cannot Be Reached and the Database Does Not Function
Solution
The Management Agents Could Not Establish a Domain
Description
Solution 1
Solution 2
Unexpected Node Restarts, Network Partitions, or Reconnects
Description
Solution
hadbm create or hadbm addnodes Command Hangs
Description
Solution
ma (Management Agent Process) Crashes
Description
Solution
Server Responds Slowly After Being Idle
Description
Solution
Requests Are Not Succeeding
Is the Load Balancer Timeout Correct?
Description
Solution
Are the System Clocks Synchronized?
Description
Solution
Is the Application Server Communicating With HADB?
Description
Solution
Session Persistence Problems
The create-session-store Command Failed
Description
Solution
Configuring Instance-Level Session Persistence Did Not Work
Session Data Seems To Be Corrupted
Description
Solution 1
Solution 2
Solution 3
HADB Performance Problems
Is There a Shortage of CPU or Memory Resources, or Too Much Swapping?
Description
Solution
Is There Disk Contention?
Description
Solution
Is There a Shortage of HADB Data Device Space?
Description
Solution 1
Solution 2
Is There a Shortage of Other HADB Resources?
High Load Problems
Is the Tuple Log Out Of Space?
Solution 1
Solution 2
Solution 3
Solution 4
Is the node-internal Log Full?
Solution 1
Solution 2
Are There Enough Locks?
Solution 1: Increase the number of locks
Solution 2: Improve CPU Utilization
Can You Fix the Problem by Doing Some Performance Tuning?
Client cannot connect to HADB
Description
Solution
Improving CPU Utilization
Description
Solutions
HADB Administration Problems
hadbm Command Fails: The agents could not be reached
Description
Solution
hadbm Command Fails: command not found
Description
Solution 1
Solution 2
Solution 3
hadbm Command Fails: JAVA_HOME not defined
Description
Solution
create Fails: “path does not exist on a host”
Description
Solution
Database Does Not 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
Attaching Shared Memory Segment Fails Due To Insufficient Space
Description
Cannot Restart the HADB
Description
Explanation
Solution

Chapter 6   Administration Problems
Server Logs
Application Server logs
HADB History Files
General Problems
All administrative operations fail
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
Don’t know the admin username/password
Don’t know the Admin Server port number
Connection Refused when accessing the Admin Server
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?
Is your communication protocol configured properly?
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
Attaching shared memory segment fails due to insufficient space
Can’t restart the HADB
Error: Specified database does not exist
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
Examining the HADB history files
Maintaining service while taking the HADB offline
Starting the hadb nodes after rebooting the host machine
Clearing the database and recreating the session store
Stopping a node when inetd is active
Rebooting a machine that has HADB nodes

Chapter 7   Application and Deployment Problems
Application Problems
persistence.support.JDODataStoreException
EJB Problems
Can’t set TRANSACTION_SERIALIZABLE level for a bean
Runtime exception from ejbCreate()
CMP Problems
Are you using a supported JDBC driver?
Parser exceptions generated by verifier
Element type "sun-ejb-jar" is not declared.
Root element type is "sun-ejb-jar", but was declared to be "ejb-jar"
java.net.UnknownHostException: www.sun.com
Expected "</name>" to terminate element starting on line 8.
Element "ejb" does not allow "jndi-name" here.
Ant Problems
Can’t run Ant remotely.

Chapter 8   Integration Problems
Web Server Problems
Sun ONE Web Server Problems
Apache Web Server Problems
Reverse Proxy Plug-In Problems
Database Problems
Pooled connection to Sybase
Oracle XA Exception: Resource Manager doing work outside a global transaction
Messaging Problems
JMS broker won’t start.
SOAP FAULT with Apache SOAP 2.3.1 client

Chapter 9   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 10   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 Access
How to tell which version of the application server is running?
How to determine the build date and version?
Where else is version information available?
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 Java System 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 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 Java System Application Server 7?
Does Sun Java System Application Server 7 have a JCA connector to talk to SAP R3?
Are custom authorization providers supported?
How is load balancing supported?
Functional Support
How do you run a CMP application with a different database?
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?
General Administration
How do I logout from the Admin Console?
How do I give limited admin privileges to a user?
High-Availability
Where are the load balancer files?
How do I enable the health checker?
Server Configuration and Control
Is instance restart the same as stop/start?
How to supply password for automated startup or unattended restart?
How do you specify an XA DataSource in a jdbc-connection-pool?
How do you setup a hosts virtual server?
How do you disable batch insert and update?
How do you add a new user and password?
How do you set the JVM heap size?
How do you 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 to run my application?
Can I configure the application server to run as non-root?
Where is the secondary storage area for stateful session beans?
Application Programming
How does an application implement transaction timeouts?
How do I use Xerces versions of JAXP in my application?
How do I get an instanceTransactionManager?
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 Java System Application Server 7 to Enterprise Edition?
Can I migrate from other application servers?

Index


Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.