Page 3 - Contents
Contents Preface .....................................................................................................................................................7 1 Overview of Enterprise Server Troubleshooting ........................................................................... 13 Ident...
Page 7 - Enterprise Server Documentation Set
Preface This guide describes common problems that you might encounter when using Sun GlassFish TM Enterprise Server v3 Prelude and how to solve them. This preface contains information about and conventions for the entire Sun GlassFishEnterprise Server documentation set. The following topics are addr...
Page 9 - Related Documentation
TABLE P–1 Books in the Enterprise Server Documentation Set (Continued) Book Title Description Reference Manual Provides reference information in man page format for Enterprise Serveradministration commands, utility commands, and related concepts. Related Documentation A Javadoc TM tool reference for...
Page 10 - Default Paths and File Names
Symbol Conventions The following table explains symbols that might be used in this book. TABLE P–3 Symbol Conventions Symbol Description Example Meaning [ ] Contains optional argumentsand command options. ls [-l] The -l option is not required. { | } Contains a set of choices for arequired command op...
Page 11 - Searching Sun Product Documentation; Third-Party Web Site References
TABLE P–4 Default Paths and File Names (Continued) Placeholder Description Default Value domain-dir Represents the directory in which a domain'sconfiguration is stored. In configuration files, domain-dir is represented as follows: ${com.sun.aas.instanceRoot} domain-root-dir / domain-name Documentati...
Page 12 - Sun Welcomes Your Comments
Note – Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising,products, or other materials that are available on or through such sites or resources. Sun will notbe responsible...
Page 13 - Overview of Enterprise Server Troubleshooting; Identifying the Problem; First Steps
Overview of Enterprise Server Troubleshooting This chapter describes the tools, methods, and information sources available fortroubleshooting Sun GlassFish Enterprise Server v3 Prelude. Guidelines for evaluating andinvestigating a problem are included. This chapter contains the following sections: ■...
Page 14 - Verify System Requirements and Configuration; Review Known Issues; Search the Product Documentation; Search the GlassFish Mailing Lists and Forums
Verify System Requirements and Configuration Problems are often caused by configuration issues (system, JVM TM , server, or application-level) and by resource issues (such as when a system runs out of memory). Refer to the Sun GlassFish Enterprise Server v3 Prelude Release Notes for the latest infor...
Page 15 - Search the SunSolve Knowledgebase; Gathering Information; When Does the Problem Occur?; What Is Your Environment?
Note – Some resources refer to GlassFish v3 Prelude. GlassFish v3 Prelude is the community version of the commercially supported offering, Sun GlassFish Enterprise Server v3 Prelude.The software is the same; the difference is in support. Search the SunSolve Knowledgebase SunSolve SM is Sun's informa...
Page 16 - What Is Your System Configuration?; Examining Log Files
■ Have any patches been applied? If so, what are the product and operating system patchnumbers? ■ 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 arethe products and versions...
Page 17 - Monitoring the System; Operating System Utilities
By default, all Enterprise Server log information is captured in the server.log file, typically located in domain-dir / logs . Log Viewer is not available in Enterprise Server v3 Prelude. You cannot view the server's log file or configure logging using the Administration Console. To viewlog informat...
Page 18 - Stack Traces and Thread Dumps; To Obtain a Server Thread Dump; VisualVM
Stack Traces and Thread Dumps A stack trace is a user-friendly snapshot of the threads and monitors in a Virtual Machine forthe Java platform (Java Virtual Machine or JVM machine). A thread dump shows what everythread in a JVM is doing at a given time and is useful in debugging. When the application...
Page 21 - Specific Issues
Specific Issues This chapter lists problems that you might encounter when using Sun GlassFish EnterpriseServer v3 Prelude. The following issues are addressed. General Issues ■ “Cannot Access Local Server ( http://localhost:8080 )” on page 21 ■ “Cannot Access Remote Server” on page 23 ■ “Cannot Acces...
Page 22 - Did the Server Start?; Was the Server Started at the Expected Port?; Description
Did the Server Start? Description If the console window is still open, the expected message is: Domain domain Started where domain is the name of the default domain. This indicates that the default domain was started successfully. If the console window is already closed, check for messages in the lo...
Page 23 - Is the Server Available Locally?; To Verify That the Server Is Running Locally; Is the Proxy Setting Causing a Problem?; Solution
Cannot Access Remote Server When attempting to open the start page of Enterprise Server, the initial screen does not appear. When this error occurs, check the following: ■ “Is the Server Available Locally?” on page 23 ■ “Is the Proxy Setting Causing a Problem?” on page 23 Is the Server Available Loc...
Page 24 - Is the Application Server Running?
■ Set the browser to bypass the proxy server when accessing localhost . Refer to the browser's help system for information about how to do this. ■ Use the fully-qualified host name or IP address of your system; for example: http://myhost.mydomain.com:8080/ ■ Create an entry in the system's hosts fil...
Page 25 - Is the Security Manager Disabled?; Cannot Access a Server Application
Is the Administration Console Running on theExpected Port? Description The default port number for the Administration Console is 4848 . However, it could be running on a different port number than expected, either because it was intentionally installed there, orbecause that port was in use when the ...
Page 26 - Was Application Deployment Successful?; Administrator User Name or Password Not Known; To Remove the User Name and Password Completely
Solution Review the information in “Did the Server Start?” on page 22 to determine if the server is running. The server must be running before a server application can be accessed. Was Application Deployment Successful? Description An application must be successfully deployed before it can be access...
Page 27 - Server Will Not Start on Windows (Port Conflict)
Note – The commands will still expect a value for --username (or -u ) and --password (or -w ). But these can be dummy values, since the server side does not impose any security. Start the server. At this point, the server does not have command-line security. Create a plain text file that defines the...
Page 28 - Is Another Application Running on the Server's Port?
Is Another Application Running on the Server's Port? If another application is using the server's port, stop the other application, then restartEnterprise Server. Has an Ungraceful Shutdown Occurred on a PreviouslyRunning Server? Use the asadmin stop-domain command to stop the server, or explicitly ...
Page 29 - Cannot Produce a JVM Thread Dump After Server Crash; Error When Deploying EAR
Cannot Produce a JVM Thread Dump After Server Crash Description If Enterprise Server crashes, the server dumps a core file and, by default, restarts with the -Xrs flag, which prevents the dump of a JVM thread dump. Solution ▼ To Obtain a Server Thread Dump Type the following command: asadmin generat...
Page 30 - Cannot Find; SunDeploymentManager; jar
■ Forum threads: http://forums.java.net/jive/thread.jspa?messageID=301326 and http://forums.java.net/jive/thread.jspa?messageID=318879 ■ Blog post: “EJB 3.1 in GlassFish v3 Prelude”( http://blogs.sun.com/kensaks/entry/ejb_3_1_in_glassfish ) ■ Blog post: “Deployment in GlassFish v3 Prelude”( http://b...
Page 31 - Command Fails
getResource or getResourceAsStream , consider using getClass().getResource , which returns a URL object, then invoke the url.setUseCaches method to turn off caching for that jar file, and use url.getInputStream() to obtain the stream. Although turning off caching for access to the jar file can slow ...
Page 32 - Could Not Start Domain; Cannot Stop Domain Using
Error: Could Not Start Domain Description This message comes from Sun Java System Application Server 8. The full message looks likeeither: Could not start the domain. There are no domains. or Could not start the domain. No default domain. Need to enter a domain. This error occurs when Sun Java Syste...
Page 33 - Using; asadmin set; Command Might Produce
Using asadmin set Command Might Produce Unexpected Results Description Unexpected results are returned when setting variables in a command, such as: asadmin set name={$a-b} In this case, name is set to b , not {$a-b} because the shell syntax ${a=b} is interpreted as “if the variable a is unset, subs...
Page 34 - General Installation; Cannot Upgrade
Solution This problem only occurs on Windows platforms and is related to an HTTP connection socketerror. For more information, see the following: ■ Forum threads: http://forums.java.net/jive/thread.jspa?messageID=316148 and http://forums.java.net/jive/thread.jspa?messageID=316905 ■ Issue report: htt...
Page 35 - Issues Related to JavaMail; Cannot Configure JavaMail Resources; Cannot Deploy a Mail Session as a JNDI Resource
For information about updating an existing Enterprise Server v3 Prelude installation, see Chapter 2, “Updating an Existing Enterprise Server v3 Prelude Installation,” in Sun GlassFish Enterprise Server v3 Prelude Installation Guide . Issues Related to JavaMail Cannot Configure JavaMail Resources Des...
Page 36 - Exception When Creating MySQL Connection Pool; Issues Related to Security; Denied Error
Issues Related to MySQL Exception When Creating MySQL Connection Pool Description On Windows, you get an exception when creating a MySQL connection pool using theAdministration Console. Solution See “Attempt to Use Administration Console to Create a Connection Pool Fails Even if the Driver Is Presen...
Page 39 - Administration FAQs; Commands are Supported?
Frequently Asked Questions This chapter lists Frequently Asked Questions (FAQs) related to Sun GlassFish EnterpriseServer v3 Prelude. This list is certain to grow. For the latest FAQs, also see the GlassFish wiki at http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishFAQIndex . This chapter contai...
Page 40 - How Do I Debug Applications?; Eclipse FAQs
Application FAQs How Do I Debug Applications? See Chapter 3, “Debugging Applications,” in Sun GlassFish Enterprise Server v3 Prelude Developer’s Guide . How Do I Change Application Permissions? See “Changing Permissions for an Application” in Sun GlassFish Enterprise Server v3 Prelude Developer’s Gu...
Page 41 - How Do I Add Containers?; How Do I Extend the Administration Console?
■ Download: Download the plugin from within Eclipse using the Download AdditionalServer Adapters link on the New Server Wizard. See the Downloads page for additionalinformation ( https://glassfishplugins.dev.java.net/download/index.html ). If you have difficulty downloading the plugin from within Ec...
Page 42 - What Java Persistence Support Is Available?; JDBC FAQs; Is JDBC Support Provided?; Jersey FAQs
Java Persistence FAQs What Are the Restrictions and Optimizations for theJava Persistence API? See “Restrictions and Optimizations” in Sun GlassFish Enterprise Server v3 Prelude Developer’s Guide . What Java Persistence Support Is Available? Java Persistence 1.0 support in Enterprise Server v3 Prelu...
Page 43 - OpenESB FAQs; Does Enterprise Server v3 Prelude Support OpenESB?; If I Deploy an Application Using the; Files to Add to the Classpath for
OpenESB FAQs Does Enterprise Server v3 Prelude Support OpenESB? No, OpenESB v2 runs on Sun Java System Application Server 9.1 (GlassFish v2). For moreinformation about OpenESB, see https://open-esb.dev.java.net . Rails and JRuby FAQs Should I Start an Enterprise Server Domain andDeploy My Applicatio...
Page 45 - Security FAQs; Can I Change the Keystore Password?
Security FAQs What Happens When No Server Side Realm IsConfigured? When the application is configured (within XML files), but no server side realm is configured,the application is authenticated in the default realm. No error is thrown that indicates “No suchrealm.” Can I See the TLS/SSL Handshake In...
