Instruction/ maintenance manual of the product 820682310 Sun Microsystems
Go to page of 48
Sun GlassF ish Enterprise Ser v er v3 Pr elude T roubleshooting Guide Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. Part N o: 820–6823–10 November 2008.
Copyright 2008 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. I n particular, and without limitation, these intellectual property rights may include one or more U.
Cont ents Preface .....................................................................................................................................................7 1 Overview of Enterprise Ser v er T roubleshooting ...............................
Was A pplication Deployment Successful? ................................................................................ 26 A dministrator User Name or P assword Not Known ............................................................... 26 Server Will Not Start on Windows (P ort Conict) .
3 Frequently Ask ed Q uestions ............................................................................................................. 39 A dministration F A Qs ....................................................................................
Update Tool F A Qs ............................................................................................................................... 45 H ow Do I Use Update Tool to Extend My Enterprise Server I nstallation? ........................... 45 Index .
P refac e 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 GlassFish Enterprise Server documentation set.
T ABLE P–1 Books in the Enterprise Server D ocumentation Set (Continued) Book Title Description I nstallation Guide Explains how to install the software and its components. A pplication Deployment Guide Explains how to assemble and deploy applications to the Enterprise Server and provides information about deployment descriptors.
T ABLE P–1 Books in the Enterprise Server D ocumentation Set (Continued) Book Title Description Reference M anual Provides reference information in man page format for Enterprise Server administration commands, utility commands, and related concepts.
Symbol C onv entions The following table explains symbols that might be used in this book. T ABLE P–3 Symbol Conventions Symbol Description Example Meaning [] Contains optional arguments and command options. ls [-l] The -l option is not required. {|} Contains a set of choices for a required command option.
T ABLE P–4 Default Paths and F ile Names (Continued) Placeholder Description Default Value domain-dir Represents the directory in which a domain's conguration is stored. In conguration les, domain-dir is represented as follows: ${com.sun.
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.
O v er view of Enterprise Ser ver T roubleshooting This chapter describes the tools, methods, and information sources available for troubleshooting Sun GlassFish Enterprise Server v3 Prelude. G uidelines for evaluating and investigating a problem are included.
V erify Syst em Requirements and Congura tion Problems are often caused by conguration issues (system, JVM TM , server, or application-level) and by resource issues (such as when a system runs out of memory).
Note – Some resources refer to GlassFish v3 Prelude. GlassF ish v3 Prelude is the community version of the commercially supported oering, Sun GlassFish Enterprise Server v3 Prelude.
■ Have any patches been applied? I f so, what are the product and operating system patch numbers? ■ What other products and technologies are installed and being used in the installation? ■ How m.
By default, all Enterprise Server log information is captured in the server.log le, typically located in domain-dir / logs . Log Viewer is not available in Enterprise Server v3 Prelude. You cannot view the server's log le or congure logging using the A dministration Console.
Stack T rac es and Thread Dumps A stack trace is a user-friendly snapshot of the threads and monitors in a Virtual Machine for the J ava platform (Java Virtual M achine or JVM machine). A thread dump shows what every thread in a JVM is doing at a given time and is useful in debugging.
Where t o G o f or More Information ■ Product page: http://www.sun.com/software/products/glassfishv3_prelude/index.xml ■ Comparison between Sun Java System A pplication Server 9.1 (GlassFish v2) and Enterprise Server v3 Prelude: https://glassfish.
20.
Specic Issues This chapter lists problems that you might encounter when using Sun GlassFish Enterprise Server v3 Prelude. The following issues are addressed.
Did the Ser v er Star t? Description If the console window is still open, the expected message is: Domain domain Started where domain is the name of the default domain.
Cannot A ccess Remote Ser v er 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 A vail.
■ 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-qualied host name or IP address of your system; for example: http://myhost.mydomain.
Is the Administr ation Console Running on the Expec t ed P or t? Description The default port number for the A dministration Console is 4848 . However, it could be running on a dierent port number than expected, either because it was intentionally installed there, or because that port was in use when the server was started.
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. W as Applic a tion Deployment Successful? Description An application must be successfully deployed before it can be accessed.
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 ser ver . A t this point, the server does not have command-line security.
Is Another Application Running on the Ser ver's P or t? If another application is using the server's port, stop the other application, then restart Enterprise Server.
Cannot Pr oduce a JVM Thread Dump After Ser v er Crash Description If Enterprise Server crashes, the server dumps a core le and, by default, restarts with the -Xrs ag, which prevents the dump of a JVM thread dump.
■ 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 P relude” ( http://blogs.sun.com/kensaks/entry/ejb_3_1_in_glassfish ) ■ Blog post: “Deployment in GlassFish v3 Prelude” ( http://blogs.
getResource or getResourceAsStream , consider using getClass().getResource , which returns a URL object, then invoke the url.setUseCaches method to turn o caching for that jar le, and use url.
Error: Could Not Start Domain Description This message comes from Sun J ava System A pplication Server 8. The full message looks like either: Could not start the domain. There are no domains. or Could not start the domain. No default domain. Need to enter a domain.
Using asadmin set C ommand 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 .
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 and http://forums.java.net/jive/thread.
For information about updating an existing Enterprise Server v3 P relude installation, see Chapter 2, “Updating an Existing Enterprise Server v3 Prelude I nstallation, ” in Sun GlassFish Enterprise Server v3 Prelude I nstallation Guide .
Issues Related t o MySQL Ex ception When Crea ting MySQL Connec tion P ool Description On Windows, you get an exception when creating a M ySQL connection pool using the A dministration Console.
grant codeBase " file:/.../build/sparc_SunOS/sec/- " { permission java.util.PropertyPermission " * " , " read,write " ; }; Mutual Authentication Not W orking With the Application Client Description This failure can occur when the keystore and truststore properties are not set properly.
38.
F requently Asked Questions This chapter lists Frequently A sked Questions (F AQs) related to Sun GlassFish Enterprise Server v3 Prelude. This list is certain to grow. F or the latest F AQ s, also see the GlassFish wiki at http://wiki.glassfish.java.net/Wiki.
Application F A Qs How Do I Debug Applications? See Chapter 3, “Debugging A pplications, ” in Sun GlassF ish Enterprise Server v3 Prelude Developer’ s Guide . How Do I Change Application P ermissions? See “Changing P ermissions for an Application” in Sun GlassF ish Enterprise Server v3 Prelude Developer’ s Guide .
■ Download: Download the plugin from within Eclipse using the Download Additional Server A dapters link on the New Server Wizard. See the Downloads page for additional information ( https://glassfishplugins.
Jav a Persist ence F A Qs What Ar e the Restric tions and Optimizations for the Jav a Persistenc e API? See “Restrictions and Optimizations” in Sun GlassFish E nterprise Server v3 Prelude Developer’ s Guide . What Ja va P ersistence Suppor t Is A vailable? J ava P ersistence 1.
OpenESB F A Qs Does Enterprise Ser v er v3 Prelude Suppor t OpenESB? No, OpenESB v2 runs on Sun Java System A pplication Server 9.1 (GlassFish v2). For more information about OpenESB, see https://open-esb.
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.
Security F A Qs What Happens When No Ser v er Side Realm Is C ongured? When the application is congured (within XML les), but no server side realm is congured, the application is authenticated in the default realm. N o error is thrown that indicates “No such realm.
After you start your Enterprise Server instance, the default location for the A dministration Console is http://localhost:4848/ (at least one Enterprise Server domain must be started before you can launch the A dministration Console).
Index A add-on components, developing, 41 admin password, not known, 26-27 admin username, not known, 26-27 A dministration Console, cannot access, 24-25 A dministration Console, extending, 41 adminis.
J J ava P ersistence F A Qs, 42 J avaMail issues, 35 JDBC F AQs, 42 Jersey F AQ s, 42 JNDI issues, 35 JRuby F A Qs, 43-44 JSR 88, 30 K kill processes, 17, 32 known issues, 14 L local server, access fa.
An important point after buying a device Sun Microsystems 820682310 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Sun Microsystems 820682310 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Sun Microsystems 820682310 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Sun Microsystems 820682310 you will learn all the available features of the product, as well as information on its operation. The information that you get Sun Microsystems 820682310 will certainly help you make a decision on the purchase.
If you already are a holder of Sun Microsystems 820682310, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Sun Microsystems 820682310.
However, one of the most important roles played by the user manual is to help in solving problems with Sun Microsystems 820682310. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Sun Microsystems 820682310 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
