Sun Microsystems 820682310 manuel d'utilisation

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.S[...]

Cont ents Preface .....................................................................................................................................................7 1 Overview of Enterprise Ser v er T roubleshooting ........................................................................... 13 Identifying the P roblem ..........................[...]

Was A pplication Deployment Successful? ................................................................................ 26 A dministrator User Name or P assword Not Known ............................................................... 26 Server Will Not Start on Windows (P ort Conict) ............................................................[...]

3 Frequently Ask ed Q uestions ............................................................................................................. 39 A dministration F A Qs .......................................................................................................................... 39 Which asadmin Commands are Supported? ...................[...]

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. The following topics are addressed here: ■ “Enterprise Server Documentat[...]

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. Developer’ s G[...]

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. Related Documenta tion A J avadoc TM tool reference for packages that are provided with the Enter[...]

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. -d {y|n} The -d option requires that you[...]

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 conguration is stored. In conguration les, domain-dir is represented as follows: ${com.sun.aas.instanceRoot} domain-root-dir / domain-name Documentation, Support, and T r aining The Sun w[...]

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 not be responsible or liable for any actual or alleged damage or[...]

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. This chapter contains the following sections: ■ “Identifying the P roblem” on page [...]

V erify Syst em Requirements and Congura tion Problems are often caused by conguration 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 N otes for the latest information regarding system requirements depende[...]

Note – Some resources refer to GlassFish v3 Prelude. GlassF ish v3 Prelude is the community version of the commercially supported oering, Sun GlassFish Enterprise Server v3 Prelude. The software is the same; the dierence is in support. Search the SunSolve Knowledgebase SunSolve SM is Sun's informational and patch database service with [...]

■ 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 many application servers, web servers, and directory servers are installed? What are the products and versions? ■ How is the web server connected to [...]

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 congure logging using the A dministration Console. To view log information, open the server.log le in a text[...]

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. When the application server freezes, hangs, or becomes sluggish [...]

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.dev.java.net/public/comparing_v2_and_v3.html ■ Support and services: http://www.sun.com/software/[...]

20[...]

Specic 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 ■ “Cannot Access Remote Server” on page 23 ■ “Cannot Access the A dministration C onsole?[...]

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. This indicates that the default domain was started successfully. If the console window is already closed, check for messages in the log le: as-install /domains/domain1/logs/serve[...]

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 vailable L ocally?” on page 23 ■ “Is the P roxy Setting C ausing a Problem?” on page 23 Is the Ser v er A vailable Locally? Description If the ser[...]

■ 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-qualied host name or IP address of your system; for example: http://myhost.mydomain.com:8080/ ■ Create an entry in the system's hosts le (for example, pointing 127.0.0[...]

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 dierent port number than expected, either because it was intentionally installed there, or because that port was in use when the server was started. Solution Refer to “[...]

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. Solution Check the server's log ?[...]

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. Create a plain t ext le that denes the AS_ADMIN_USERPASSWORD variable as follo w[...]

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. Has an Ungrac eful Shutdown Oc curred on a Pre viously Running Ser v er? Use the asadmin stop-domain command to stop the server, or explicitly kill the Java process and then[...]

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. Solution ▼ T o Obtain a Ser ver Thread Dump T ype the following command: asadmin generate-jvm-report --type=thread generate-jvm-[...]

■ 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.sun.com/quinn/entry/deployme[...]

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.getInputStream() to obtain the stream. Although turning o caching for access to the jar le can slow performance, this approach does allow the appl[...]

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. This error occurs when Sun J ava System A pplication Server 8 is installed on the sa[...]

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 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 v[...]

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.jspa?messageID=316905 ■ Issue report: http://glassfishplugins.dev.java.net/issues/show[...]

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 Relat ed to Ja vaMail Cannot C ongure Jav aMail Resources Description You cannot congure J avaM[...]

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. Solution See “A ttempt to Use Administration Console to Create a Connection Pool F ails Even if the Driver Is P resent (Issue 6671)” in Sun GlassFish E [...]

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. Solution Set the following proper[...]

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.jsp?page=GlassFishFAQIndex . This chapter contains the following: ■ “A dministration F [...]

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 . What Ar e the Restric [...]

■ 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.dev.java.net/download/index.html ). I f you have diculty downloading the plugin from within Eclipse, you could be experiencing an Eclipse [...]

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.0 support in Enterprise Server v3 Prelude is available as follows:[...]

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.dev.java.net . Rails and JRuby F A Qs Should I Star t an Enterprise Ser v er Domain and Deploy My Applica tion Into It, or Should I U se the glas[...]

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 les with the Rails application, instead of copying the jars in the glassfish/lib or glassfish/modules directory, you might want to use Warb[...]

Security F A Qs What Happens When No Ser v er Side Realm Is C ongured? When the application is congured (within XML les), but no server side realm is congured, the application is authenticated in the default realm. N o error is thrown that indicates “No such realm. ” Can I See the TLS/SSL Handshake Informa tion for an SSL Client? Ye[...]

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). Unless you declined to check for updates during installation, you will be notied of available updates in the mes[...]

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 administration F A Qs, 39 application, cannot access, 25-27 application F A Qs, 40 application issues, 29-31 asadmin issues, 31-33 C cannot access A dministr[...]

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 fails, 21-23 log les, 16-17 M mailing lists, 14 monitoring, 17 N netstat -ab, 34 O OpenESB F A Qs, 43 P pkginfo, 17 port conict, Windows, 27-28 po[...]