Related Manuals for Sun Microsystems Sun GlassFish EnterpriseServer v3 Prelude
Summary of Contents for Sun Microsystems Sun GlassFish EnterpriseServer v3 Prelude
- Page 1 Sun GlassFish Enterprise Server v3 Prelude Troubleshooting Guide Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. Part No: 820–6823–10 November 2008...
- Page 2 Directory Interface, JavaBeans, Javadoc, JDBC, JDK, JavaScript, JavaServer, JavaServer Pages, JMX, JSP, JVM, MySQL, NetBeans, OpenSolaris, SunSolve, Sun GlassFish, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc., ou ses filiales, aux Etats-Unis et dans d'autres pays.
-
Page 3: Table Of Contents
Contents Preface ..............................7 Overview of Enterprise Server Troubleshooting ................13 Identifying the Problem ........................13 First Steps ............................13 Gathering Information ........................ 15 Examining Log Files ........................16 Monitoring the System ........................ 17 Troubleshooting Tools ........................17 Operating System Utilities ......................17 Stack Traces and Thread Dumps .................... - Page 4 Contents Was Application Deployment Successful? ................26 Administrator User Name or Password Not Known ............... 26 Server Will Not Start on Windows (Port Conflict) ................27 Is Another Application Running on the Server's Port? ............28 Has an Ungraceful Shutdown Occurred on a Previously Running Server? ......28 Two Server Instances Bind to Same Port on Windows ..............
- Page 5 Contents Frequently Asked Questions ......................39 Administration FAQs .......................... 39 Which asadmin Commands are Supported? ................39 Application FAQs ..........................40 How Do I Debug Applications? ....................40 How Do I Change Application Permissions? ................40 What Are the Restrictions and Optimizations for Session Beans? ........40 How Do I Move Tomcat Toplink Applications to Enterprise Server v3 Prelude? ....
- Page 6 Contents Update Tool FAQs ..........................45 How Do I Use Update Tool to Extend My Enterprise Server Installation? ......45 Index ..............................47 Sun GlassFish Enterprise Server v3 Prelude Troubleshooting Guide • November 2008...
-
Page 7: Preface
Preface This guide describes common problems that you might encounter when using Sun GlassFish Enterprise Server v3 Prelude and how to solve them. This preface contains information about and conventions for the entire Sun GlassFish Enterprise Server documentation set. The following topics are addressed here: “Enterprise Server Documentation Set”... - Page 8 Preface Books in the Enterprise Server Documentation Set (Continued) TABLE P–1 Book Title Description Installation Guide Explains how to install the software and its components. Application Deployment Guide Explains how to assemble and deploy applications to the Enterprise Server and provides information about deployment descriptors. Developer’s Guide Explains how to create and implement Java Platform, Enterprise Edition (Java EE platform) applications that are intended to run on the Enterprise...
-
Page 9: Related Documentation
Preface Books in the Enterprise Server Documentation Set (Continued) TABLE P–1 Book Title Description Reference Manual Provides reference information in man page format for Enterprise Server administration commands, utility commands, and related concepts. Related Documentation A Javadoc tool reference for packages that are provided with the Enterprise Server is located at https://glassfish.dev.java.net/nonav/api/v3-prelude/index.html. - Page 10 Preface Symbol Conventions The following table explains symbols that might be used in this book. Symbol Conventions TABLE P–3 Symbol Description Example Meaning Contains optional arguments The -l option is not required. ls [-l] and command options. Contains a set of choices for a The -d option requires that you use { | } -d {y|n}...
- Page 11 Preface Default Paths and File Names (Continued) TABLE P–4 Placeholder Description Default Value domain-dir Represents the directory in which a domain's domain-root-dir/domain-name configuration is stored. In configuration files, domain-dir is represented as follows: ${com.sun.aas.instanceRoot} Documentation, Support, and Training The Sun web site provides information about the following additional resources: Documentation (http://www.sun.com/documentation/) ■...
-
Page 12: Sun Welcomes Your Comments
Preface Sun is not responsible for the availability of third-party web sites mentioned in this Note – 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 not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources. -
Page 13: Overview Of Enterprise Server Troubleshooting
C H A P T E R Overview of Enterprise Server Troubleshooting This chapter describes the tools, methods, and information sources available for troubleshooting Sun GlassFish Enterprise Server v3 Prelude. Guidelines for evaluating and investigating a problem are included. This chapter contains the following sections: “Identifying the Problem”... - Page 14 Identifying the Problem Verify System Requirements and Configuration Problems are often caused by configuration issues (system, JVM , 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 information regarding system requirements dependencies.
-
Page 15: Gathering Information
Search the SunSolve Knowledgebase SunSolve is Sun's informational and patch database service with a browseable directory of all publicly available Sun Microsystems support documents. SunSolve is available at http://sunsolve.sun.com. Additional resources are also available for customers with support contracts. Gathering Information Troubleshooting and analysis require information. -
Page 16: Examining Log Files
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 ■... -
Page 17: Monitoring The System
Troubleshooting Tools 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 view log information, open the server.log file in a text editor. -
Page 18: Stack Traces And Thread Dumps
Troubleshooting Tools Stack Traces and Thread Dumps A stack trace is a user-friendly snapshot of the threads and monitors in a Virtual Machine for the Java platform (Java Virtual Machine or JVM machine). A thread dump shows what every thread in a JVM is doing at a given time and is useful in debugging. When the application server freezes, hangs, or becomes sluggish for no apparent reason, you should generate and analyze a thread dump. -
Page 19: Where To Go For More Information
Where to Go for More Information Where to Go for More Information Product page: ■ http://www.sun.com/software/products/glassfishv3_prelude/index.xml Comparison between Sun Java System Application Server 9.1 (GlassFish v2) and Enterprise ■ Server v3 Prelude: https://glassfish.dev.java.net/public/comparing_v2_and_v3.html Support and services: ■ http://www.sun.com/software/products/glassfishv3_prelude/support.xml SunSolve knowledgebase: ■... -
Page 21: Specific Issues
C H A P T E R Specific Issues This chapter lists problems that you might encounter when using Sun GlassFish Enterprise Server v3 Prelude. The following issues are addressed. General Issues “Cannot Access Local Server (http://localhost:8080)” on page 21 ■... -
Page 22: Did The Server Start
Cannot Access Local Server (http://localhost:8080) 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. -
Page 23: Cannot Access Remote Server
Cannot Access Remote Server 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?”... -
Page 24: Cannot Access The Administration Console
Cannot Access the Administration Console 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: ■... -
Page 25: Is The Administration Console Running On The Expected Port
Cannot Access a Server Application Is the Administration Console Running on the Expected 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, or because that port was in use when the server was started. -
Page 26: Was Application Deployment Successful
Cannot Access a Server Application 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 accessed. -
Page 27: Server Will Not Start On Windows (Port Conflict)
Server Will Not Start on Windows (Port Conflict) The commands will still expect a value for --username (or -u) and --password (or -w). Note – But these can be dummy values, since the server side does not impose any security. Start the server. -
Page 28: Is Another Application Running On The Server's Port
Two Server Instances Bind to Same Port on Windows Is Another Application Running on the Server's Port? If another application is using the server's port, stop the other application, then restart Enterprise Server. Has an Ungraceful Shutdown Occurred on a Previously Running Server? Use the asadmin stop-domain command to stop the server, or explicitly kill the Java process and then restart Enterprise Server. -
Page 29: Cannot Produce A Jvm Thread Dump After Server Crash
Issues Related to Applications 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 ▼... -
Page 30: Cannot Find Sundeploymentmanager
Issues Related to Applications Forum threads: ■ http://forums.java.net/jive/thread.jspa?messageID=301326 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://blogs.sun.com/quinn/entry/deployment_in_glassfish_v3_prelude) Documentation: Chapter 3, “Extending Enterprise Server, ” in Sun GlassFish Enterprise ■ Server v3 Prelude Administration Guide Cannot Find SunDeploymentManager Description... -
Page 31: Issues Related To Asadmin
Issues Related to asadmin 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 performance, this approach does allow the application to be undeployed or redeployed. -
Page 32: Cannot Stop Domain Using Asadmin Stop-Domain
Issues Related to asadmin Error: Could Not Start Domain Description This message comes from Sun Java System Application Server 8. The full message looks like either: Could not start the domain. There are no domains. Could not start the domain. No default domain. -
Page 33: Using Asadmin Set Command Might Produce Unexpected Results
Issues Related to Eclipse 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, substitute the value b, otherwise substitute the value of a. -
Page 34: Issues Related To Installation And Upgrade
Issues Related to Installation and Upgrade Solution This problem only occurs on Windows platforms and is related to an HTTP connection socket error. For more information, see the following: Forum threads: ■ http://forums.java.net/jive/thread.jspa?messageID=316148 http://forums.java.net/jive/thread.jspa?messageID=316905 Issue report: ■ http://glassfishplugins.dev.java.net/issues/show_bug.cgi?id=72 The netstat -ab command shows the PID and might prove useful. Note –... -
Page 35: Issues Related To Javamail
Issues Related to JNDI 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 Description You cannot configure JavaMail resources using the Administration Console. -
Page 36: Issues Related To Mysql
Issues Related to MySQL Issues Related to MySQL Exception When Creating MySQL Connection Pool Description On Windows, you get an exception when creating a MySQL connection pool using the Administration Console. Solution “Attempt to Use Administration Console to Create a Connection Pool Fails Even if the Driver Is Present (Issue 6671)”... -
Page 37: Mutual Authentication Not Working With The Application Client
Issues Related to Security grant codeBase "file:/.../build/sparc_SunOS/sec/-" { permission java.util.PropertyPermission "*", "read,write"; Mutual Authentication Not Working With the Application Client Description This failure can occur when the keystore and truststore properties are not set properly. Solution Set the following properties on the JVM: javax.net.ssl.keyStore= <keystore-file-path>;javax.net.ssl.trustStore=<truststore-file-path>... -
Page 39: Frequently Asked Questions
C H A P T E R Frequently Asked Questions This chapter lists Frequently Asked Questions (FAQs) related to Sun GlassFish Enterprise Server 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. -
Page 40: Sun Glassfish Enterprise Server V3 Prelude Troubleshooting Guide • November
Application FAQs Application FAQs How Do I Debug Applications? Chapter 3, “Debugging Applications, ” in Sun GlassFish Enterprise Server v3 Prelude Developer’s Guide. How Do I Change Application Permissions? “Changing Permissions for an Application” in Sun GlassFish Enterprise Server v3 Prelude Developer’s Guide. -
Page 41: Extensibility Faqs
Extensibility FAQs Download: Download the plugin from within Eclipse using the Download Additional ■ Server Adapters link on the New Server Wizard. See the Downloads page for additional information (https://glassfishplugins.dev.java.net/download/index.html). If you have difficulty downloading the plugin from within Eclipse, you could be experiencing an Eclipse update center network problem. -
Page 42: Java Persistence Faqs
Java Persistence FAQs Java Persistence FAQs What Are the Restrictions and Optimizations for the Java Persistence API? “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 Prelude is available as follows: EclipseLink 1.0 ■... -
Page 43: Openesb Faqs
Rails and JRuby FAQs OpenESB FAQs Does Enterprise Server v3 Prelude Support OpenESB? No, OpenESB v2 runs on Sun Java System Application Server 9.1 (GlassFish v2). For more information about OpenESB, see https://open-esb.dev.java.net. Rails and JRuby FAQs Should I Start an Enterprise Server Domain and Deploy My Application Into It, or Should I Use the glassfish_rails Gem? To continue the question: I'm not sure what the second option does, or why I might choose one... -
Page 44: Where Can I Find More Information About Rails Applications And Enterprise Server
Rails and JRuby FAQs Response: Place them in the domain/lib directory, or in glassfish/lib. If those bundles are OSGi bundles, you should place them in the glassfish/modules directory. If you want to package your own set of jar files with the Rails application, instead of copying the jars in the glassfish/lib or glassfish/modules directory, you might want to use Warbler. -
Page 45: Security Faqs
Update Tool FAQs Security FAQs What Happens When No Server Side Realm Is Configured? 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 such realm. - Page 46 Update Tool FAQs After you start your Enterprise Server instance, the default location for the Administration Console is http://localhost:4848/ (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.
-
Page 47: Index
Index add-on components, developing, 41 EAR, cannot deploy, 29-30 admin password, not known, 26-27 Eclipse FAQs, 40-41 admin username, not known, 26-27 Eclipse issues, 33-34 Administration Console, cannot access, 24-25 EJB support, 29-30 Administration Console, extending, 41 extensibility FAQs, 41 administration FAQs, 39 application, cannot access, 25-27 application FAQs, 40... - Page 48 Index Rails FAQs, 43-44 Java Persistence FAQs, 42 release contents, 14-15 JavaMail issues, 35 release resources, 19 JDBC FAQs, 42 remote server, access fails, 23-24 Jersey FAQs, 42 rpm, 17 JNDI issues, 35 JRuby FAQs, 43-44 JSR 88, 30 security FAQs, 45 security issues, 36-37 server kill processes, 17, 32...
Need help?
Do you have a question about the Sun GlassFish EnterpriseServer v3 Prelude and is the answer not in the manual?
Questions and answers