Sun Microsystems 820682310 manual Examining Log Files, What Is Your System Configuration?

Page 16

Identifying the Problem

■Have any patches been applied? If so, what are the product and operating system patch numbers?

■What other products and technologies are installed and being used in the installation?

■How many application servers, web servers, and directory servers are installed? What are the products and versions?

■How is the web server connected to Enterprise Server? On the same system?

■How is Enterprise Server connected to the directory server?

■What JDBC driver is being used to access the database?

What Is Your System Configuration?

■What are your settings?

■On which port is Enterprise Server v3 Prelude configured? The default or something else?

■What defaults were changed during installation and what are the values?

■What other settings were changed from the defaults and what are their values?

■What are the JVM heap, stack, and garbage collection-related parameters set to?

■What are the JVM options?

■What is the permgen size? OutOfMemoryError:PermGen space errors are common and indicate that you need to increase the permanent generation space available.

■Is SSL enabled?

■What are your network settings (proxy, firewall, and so on)? What happens if you disable your firewall and attempt the task?

What Is Different?

■What is different that could have provoked the problem or triggered the event? Was something new added or changed? Have any new applications been deployed? If changes have been made recently, consider backing them out and seeing what happens — does the problem still occur?

■Was the feature or functionality working correctly at one time? If so, what changed or happened between then and now?

■Is this working on another system? If so, what is different about that environment?

Examining Log Files

Logging is one of your most important troubleshooting tools. It is the process by which Enterprise Server captures data about events that occur during server operation. This data is recorded in a log file, and is usually the first source of information when Enterprise Server problems occur. The primary purpose of log files is to provide troubleshooting information.

16	Sun GlassFish Enterprise Server v3 Prelude Troubleshooting Guide • November 2008

Image 16

Contents Sun GlassFish Enterprise Server v3 Prelude Troubleshooting GuideSun Microsystems, Inc 4150 Network Circle Santa Clara, CA U.S.A This distribution may include materials developed by third parties Contents 1 Overview of Enterprise Server TroubleshootingWas Application Deployment Successful? Administration FAQs How Do I Use Update Tool to Extend My Enterprise Server Installation? Update Tool FAQsIndex “Symbol Conventions” on page “Default Paths and File Names” on page PrefaceEnterprise Server Documentation Set “Enterprise Server Documentation Set” on pageTABLE P-1 Books in the Enterprise Server Documentation Set ContinuedTypographic Conventions Related Documentationhttp//developers.sun.com/javadb Symbol Conventions Default Paths and File NamesThe following table explains symbols that might be used in this book Symbol ConventionsSearching Sun Product Documentation Documentation, Support, and TrainingThird-Party Web Site References Sun Welcomes Your Comments Identifying the Problem “Identifying the Problem” on page “Troubleshooting Tools” on page“Where to Go for More Information” on page First StepsVerify System Requirements and Configuration Review Known IssuesSearch the Product Documentation Search the GlassFish Mailing Lists and ForumsWhen Does the Problem Occur? What Is Your Environment?Gathering Information Search the SunSolve KnowledgebaseWhat Is Different? What Is Your System Configuration?Examining Log Files Troubleshooting Tools Monitoring the SystemOperating System Utilities “Operating System Utilities” on pageType the following command Stack Traces and Thread DumpsVisualVM To Obtain a Server Thread DumpWhere to Go for More Information Page Specific Issues Cannot Access Local Server http//localhost8080“Cannot Access Local Server http//localhost8080” on page “Cannot Access Remote Server” on pageTo Determine Which Port Number the Server Is Actually Using Did the Server Start?Was the Server Started at the Expected Port? DescriptionCannot Access Remote Server Is the Proxy Setting Causing a Problem?Solution “Is the Proxy Setting Causing a Problem?” on pageCannot Access the Administration Console “Is the Administration Console Running on the Expected Port?” on page“Is the Security Manager Disabled?” on page Is the Application Server Running?Cannot Access a Server Application Is the Administration Console Running on the Expected Port?Is the Security Manager Disabled? “Administrator User Name or Password Not Known” on pageAdministrator User Name or Password Not Known To Remove the User Name and Password CompletelyWas Application Deployment Successful? 1 Stop the server, if it is currently running8 Restart the server for the new user name-password to take effect Server Will Not Start on Windows Port Conflict4 Start the server 7 Uncomment the security-constraint element in the web.xml fileSolution Two Server Instances Bind to Same Port on WindowsHas an Ungraceful Shutdown Occurred on a Previously Running Server? DescriptionError When Deploying EAR Issues Related to ApplicationsCannot Produce a JVM Thread Dump After Server Crash Cannot Find SunDeploymentManager http//blogs.sun.com/quinn/entry/deploymentinglassfishv3preludeIssues Related to asadmin asadmin start-domain Command FailsError CLI143 There is more than one domain SolutionCannot Stop Domain Using asadmin stop-domain Error Could Not Start DomainIssues Related to Eclipse Using asadmin set Command Might Produce Unexpected ResultsGeneral Installation Issues Related to Installation and UpgradeCannot Upgrade Issues Related to JavaMail Issues Related to JNDICannot Configure JavaMail Resources Cannot Deploy a Mail Session as a JNDI ResourceIssues Related to MySQL Issues Related to SecurityException When Creating MySQL Connection Pool java.security.AccessControlException AccessMutual Authentication Not Working With the Application Client Page Frequently Asked Questions Administration FAQsWhich asadmin Commands are Supported? “Administration FAQs” on page “Application FAQs” on pageApplication FAQs Eclipse FAQsHow Do I Debug Applications? How Do I Change Application Permissions?Extensibility FAQs How Do I Extend the Administration Console?How Do I Develop Add-On Components? How Do I Add Containers?Java Persistence FAQs JDBC FAQsJersey FAQs What Java Persistence Support Is Available?OpenESB FAQs Rails and JRuby FAQsIf I Deploy an Application Using the glassfishrails That Application?Gem documentation http//glassfishgem.rubyforge.org What Options Are Available for Running JRuby With Enterprise Server?Warbler information http//caldersphere.rubyforge.org/warbler Security FAQs Update Tool FAQsWhat Happens When No Server Side Realm Is Configured? Can I Change the Keystore Password?After you start your Enterprise Server instance, the default location for the Administration Console is http//localhost4848/ at least one Enterprise Server domain must be started before you can launch the Administration Console. Unless you declined to check for updates during installation, you will be notified of available updates in the message area. Update Tool can also be accessed on the command line by running the updatetool command in the as-install/bin directory. Extensive online help is provided for both versions Index