Sun Microsystems Sun GlassFish EnterpriseServer v3 Prelude Troubleshooting Manual Download Page 1

Page: 1 / 48

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

Summary of Contents for Sun GlassFish EnterpriseServer v3 Prelude

Page 1: ...Sun GlassFish Enterprise Server v3 PreludeTroubleshooting Guide Sun Microsystems Inc 4150 Network Circle Santa Clara CA 95054 U S A Part No 820 6823 10 November 2008 ...

Page 2: ...a technologie incorporée dans le produit qui est décrit dans ce document En particulier et ce sans limitation ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats Unis et dans d autres pays Cette distribution peut comprendre des composants développés par des tierces personnes Certaines composants de ce produit ...

Page 3: ...tion 19 2 Specific Issues 21 Cannot Access Local Server http localhost 8080 21 Did the Server Start 22 Was the Server Started at the Expected Port 22 Cannot Access Remote Server 23 Is the Server Available Locally 23 Is the Proxy Setting Causing a Problem 23 Cannot Access the Administration Console 24 Is the Application Server Running 24 Is the Administration Console Running on the Expected Port 25...

Page 4: ...ated to asadmin 31 asadmin start domain Command Fails 31 Cannot Stop Domain Using asadmin stop domain 32 Using asadmin set Command Might Produce Unexpected Results 33 Issues Related to Eclipse 33 Eclipse GlassFish Server Adapter Port Conflict When Starting GlassFish 33 Issues Related to Installation and Upgrade 34 General Installation 34 Cannot Upgrade 34 Issues Related to JavaMail 35 Cannot Confi...

Page 5: ...upport Is Available 42 JDBC FAQs 42 Is JDBC Support Provided 42 Jersey FAQs 42 How Do I Use Jersey 42 OpenESB FAQs 43 Does Enterprise Server v3 Prelude Support OpenESB 43 Rails and JRuby FAQs 43 Should I Start an Enterprise Server Domain and Deploy My Application Into It or Should I Use the glassfish_rails Gem 43 If I Deploy an Application Using the glassfish_rails Gem Can I Still Access the Admin...

Page 6: ...Update Tool FAQs 45 How Do I Use Update Tool to Extend My Enterprise Server Installation 45 Index 47 Contents Sun GlassFish Enterprise Server v3 PreludeTroubleshooting Guide November 2008 6 ...

Page 7: ... References on page 11 Sun Welcomes Your Comments on page 12 Enterprise Server Documentation Set The Enterprise Server documentation set describes deployment planning and system installation The Uniform Resource Locator URL for Enterprise Server documentation is http docs sun com coll 1343 7 For an introduction to Enterprise Server refer to the books in the order in which they are listed in the fo...

Page 8: ...nt to Enterprise Server Getting Started With Project jMaki for Sun GlassFish Enterprise Server Explains how to use the jMaki framework to develop Ajax enabled web applications that are centered on JavaScriptTM technology for deployment to Enterprise Server Roadmap to the Java EE 5 Tutorial Explains which information in the Java EE 5 Tutorial is relevant to users of the v3 Prelude release of the En...

Page 9: ...elopment Environment IDE see http www netbeans org kb 60 index html For information about the Java DB for use with the Enterprise Server see http developers sun com javadb Typographic Conventions The following table describes the typographic changes that are used in this book TABLE P 2 TypographicConventions Typeface Meaning Example AaBbCc123 The names of commands files and directories and onscree...

Page 10: ...menu item selection in a graphical user interface File New Templates From the File menu choose New From the New submenu choose Templates Default Paths and File Names The following table describes the default paths and file names that are used in this book TABLE P 4 Default Paths and File Names Placeholder Description DefaultValue as install Represents the base installation directory for Enterprise...

Page 11: ... www sun com support Training http www sun com training Searching Sun Product Documentation Besides searching Sun product documentation from the docs sun comSM web site you can use a search engine by typing the following syntax in the search field search term site docs sun com For example to search for broker type the following broker site docs sun com To include other Sun web sites in your search...

Page 12: ...reliance on any such content goods or services that are available on or through such sites or resources SunWelcomesYour Comments Sun is interested in improving its documentation and welcomes your comments and suggestions To share your comments go to http docs sun com and click Send Comments In the online form provide the full document title and part number The part number is a 7 digit or 9 digit n...

Page 13: ...the Problem Application servers are typically deployed in complex and sophisticated operating environments and involve many technologies products and tools Understanding and diagnosing problems in a large piece of software with so many components performing so many tasks can be challenging This section gets you started and includes the following topics First Steps on page 13 Gathering Information ...

Page 14: ...orums are extremely helpful resources and are accessed as follows GlassFish mailing lists start with users glassfish dev java net http glassfish dev java net servlets ProjectMailingListList GlassFish user forum http forums java net jive forum jspa forumID 56 Other GlassFish forums http forums java net jive category jspa categoryID 58 Learn More About Enterprise Server v3 Prelude As the name sugges...

Page 15: ...ns to previous versions but much of the information is generic enough that it might be helpful for Enterprise Server v3 Prelude As you continue your investigation consider the following questions When Does the Problem Occur What do the logs show What kind of error message are you getting For more information about logs see Examining Log Files on page 16 What are you trying to do when the problem o...

Page 16: ...ou 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...

Page 17: ...rver v3 Prelude Release Notes for any known issues related to logging Monitoring the System Monitoring is another helpful tool It is the process of reviewing the statistics of a system to improve performance or solve problems By monitoring the state of various components and services deployed in Enterprise Server you can identify performance bottlenecks predict failures perform root cause analysis...

Page 18: ...s a Java troubleshooting tool that uses various technologies such as jvmstat JMXTM and Attach API to access monitored applications VisualVM is a tool for visualizing data sources and by default visualizes the following types applications hosts snapshots core dumps heap dumps and thread dumps These data sources are visualized in VisualVM so that they can be monitored for the purposes of analysis ma...

Page 19: ...ticles blogs videos screencasts FAQs and many other resources related to Enterprise Server v3 Prelude http wiki glassfish java net Wiki jsp page GlassFishV3PreludeResources Documentation http docs sun com coll 1343 7 Mailing lists and forums See Search the GlassFish Mailing Lists and Forums on page 14 for details about accessing lists and forums Technical Note Sun Gathering Debug Data for Sun Java...

Page 20: ...20 ...

Page 21: ...nstances Bind to Same Port on Windows on page 28 Cannot Produce a JVM Thread Dump After Server Crash on page 29 Specific Issues Issues Related to Applications on page 29 Issues Related to asadmin on page 31 Issues Related to Eclipse on page 33 Issues Related to Installation and Upgrade on page 34 Issues Related to JavaMail on page 35 Issues Related to JNDI on page 35 Issues Related to MySQL on pag...

Page 22: ... expected either because it was intentionally installed there or because another server was already running on the default port when the server was installed To DetermineWhich Port Number the Server Is Actually Using Examine the server s configuration file as install domains domain1 config domain xml Find the http listener element Inspect the value of the port attribute Be sure to enter the correc...

Page 23: ...ver is running Go to the local web page For example if 8080 is the default port go to http localhost 8080 If the start page does appear the web connection is encountering a problem that prevents accessing the server remotely If the start page does not appear see Did the Server Start on page 22 Is the Proxy Setting Causing a Problem Description The server should be accessible directly from the host...

Page 24: ...ification to see the computer name On Solaris or Linux Type hostname at the command prompt Cannot Access the Administration Console The Administration Console provides an interface for administrative functions If the Administration Console is not accessible check the following Is the Application Server Running on page 24 Is the Administration Console Running on the Expected Port on page 25 Is the ...

Page 25: ...Enterprise Server Because there is no configuration interface in Enterprise Server for disabling the Security Manager it can only be disabled when you directly modify the domain xml configuration file in such a way that the following line is removed or commented out jvm option Djava security policy yourPolicy jvm option Solution Verify that the Djava security policy yourPolicy option is present in...

Page 26: ...ains domain1 config keyfile For a different domain substitute its name in the path If you have forgotten the administrator password you must create a new user name password pair by removing the user name and password creating new ones and restarting the server You will not be able to read the password because it is encrypted in the keyfile To Remove the User Name and Password Completely Stop the s...

Page 27: ...the as install domains domain name config keyfile file Uncomment the security constraint element in the web xml file Restart the server for the new user name password to take effect Note After the server is restarted remote commands must specify adminuser as the administration user and adminpassword as the administration password ServerWill Not Start onWindows Port Conflict If a message similar to...

Page 28: ...for the instanceport option for example asadmin create domain adminport 5001 options instanceport 6001 domain asadmin create domain adminport 5002 options instanceport 6001 domain When the two domains are started on a UNIX or Linux system a port conflict error is thrown and the second instance fails to start However when the two domains are started on Windows 2000 XP no error is thrown both server...

Page 29: ...r message instead Solution Enterprise Server v3 Prelude does not include a full EJB 3 0 implementation and does not support traditional EJB modules Applications can be packaged for deployment in web archive WAR format only You can download a partial implementation of a few EJB 3 1 features using Update Tool but the bulk of EJB 3 0 ejb jar and ear support is not available If you need a full Java EE...

Page 30: ...independent deployment tools Cannot Undeploy or Redeploy ApplicationWith Open Streams to jar Files Windows Only Description On Windows systems after running an application subsequent attempts to undeploy it or redeploy it throw exceptions about the server being unable to delete a file or rename a directory On Windows systems an application may use getClass getResource or getResourceAsStream method...

Page 31: ...dmin start domain Command Fails The command asadmin start domain fails with one of the following errors Error CLI143 There is more than one domain Error Could Not Start Domain Error CLI143 There is more than one domain Description When issued with no arguments the command asadmin start domain fails with the error CLI143 There is more than one domain in C Sun AppServer domains Please use operand to...

Page 32: ...sadmin command in usr sbin is found first even when the current directory is as install bin Solution Make sure as install bin is in the PATH ahead of usr sbin or that is in the PATH ahead of usr sbin if you access asadmin by changing directories to as install bin Alternatively if you do change to as install bin to run asadmin be sure to include in the command name for example cd as install bin asa...

Page 33: ...ner 1 port is set to listener 1 port which is invalid Issues Related to Eclipse Eclipse GlassFish Server Adapter Port ConflictWhen Starting GlassFish Description On Windows the following error message is displayed when you start Enterprise Server v3 Prelude using the server adapter within Eclipse Please stop the server process using the same port as the one used by the Application Server A server ...

Page 34: ...elease bin directory is in your PATH so that the java binary used with Enterprise Server comes from the JDK release rather than a JRE implementation For more information about system requirements and dependencies see the Sun GlassFish Enterprise Server v3 Prelude Release Notes For complete installation information and guidelines see the Sun GlassFish Enterprise Server v3 Prelude Installation Guide...

Page 35: ...Enterprise Server v3 Prelude The mail jar and activation jar files are bundled so that you can create and use mail sessions However you cannot obtain mail sessions from a predefined XML resource Issues Related to JNDI Cannot Deploy a Mail Session as a JNDI Resource Description You cannot deploy a mail session as a Java Naming and Directory InterfaceTM JNDI resource Solution This functionality is n...

Page 36: ...ecurity AccessControlException access denied java util PropertyPermission name write There is a permissions issue in the policy files Either the client policy file for the application client or the server policy file for server side components does not have permission to set the property Solution Add the permission in client policy for the application client or in server policy for web modules for...

Page 37: ...et properly Solution Set the following properties on the JVM javax net ssl keyStore keystore file path javax net ssl trustStore truststore file path To use the application client set the environment variable VMARGS to the following value Djavax net ssl keyStore admin domain dir admin domain config keystore jks Djavax net ssl trustStore admin domain dir admin domain config cacerts jks Issues Relate...

Page 38: ...38 ...

Page 39: ...Qs on page 40 Eclipse FAQs on page 40 Extensibility FAQs on page 41 Java Persistence FAQs on page 42 JDBC FAQs on page 42 Jersey FAQs on page 42 OpenESB FAQs on page 43 Rails and JRuby FAQs on page 43 Security FAQs on page 45 Update Tool FAQs on page 45 Administration FAQs Which asadmin Commands are Supported Use asadmin list commands to determine which commands are supported and available for use...

Page 40: ... Prelude and NetBeans 6 5 enable you to move applications that run on Tomcat using TopLink EclipseLink to Enterprise Server As a start see Moving Tomcat Toplink Apps to GlassFish v3 Prelude http blogs sun com Lance entry moving_tomcat_toplink_apps_to Eclipse FAQs Where Can I Find More Information About Eclipse and Enterprise Server Integration Eclipse is a development environment that provides a f...

Page 41: ...dd Containers Enterprise Server has a highly modular architecture that enables you to add new types of containers that handle many application types not just Java EE Enterprise Server defines a service provider interface SPI which container developers implement The Enterprise Server framework then invokes the container s implementation of the SPI to detect deploy and manage applications of the new...

Page 42: ...ver v3 Prelude includes JDBC support The JDBC connection pooling infrastructure is the same as that of Sun Java System Application Server 9 1 GlassFish v2 See JDBC support in v3 Prelude http blogs sun com technical for more information Jersey FAQs How Do I Use Jersey Jersey 1 0 is the production quality Reference Implementation of JAX RS It is part of Enterprise Server v3 Prelude and is available ...

Page 43: ...ss to different containers such as web and EJB and also to the Update Tool Enterprise Server enables you to host not only multiple Rails applications but also any other Java EE application If I Deploy an Application Using the glassfish_rails Gem Can I Still Access the Administration Console No the gem only runs Rails applications with no extensions or extra features You must have Enterprise Server...

Page 44: ...rove_1 html Getting Started Guide http wiki glassfish java net Wiki jsp page GettingStartedGuide Gem documentation http glassfishgem rubyforge org Warbler information http caldersphere rubyforge org warbler Related screencasts http wiki glassfish java net Wiki jsp page Screencasts What Options Are Available for Running JRubyWith Enterprise Server JRuby applications can be deployed natively without...

Page 45: ...rd Edition J2SETM properties to change the keystore password Djavax net ssl keyStorePassword password Djavax net ssl trustStorePassword password Note that the keystore password must match the individual key passwords to perform operations on the keys so you must change the keystore password with the property mentioned above and then change the password to each key to match that password UpdateTool...

Page 46: ...ed 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 For more information about Update Tool see Chapter 3 Extending Enterprise Server in Sun GlassFish Enterprise Server v3 Prelude Administration Guide Also see the Administration Console o...

Page 47: ... local server 21 23 cannot access remote server 23 24 cannot access server application 25 27 cannot recall admin user name or password 26 27 connection pool cannot create 36 containers adding 41 D debug data gathering 19 documentation 14 domain finding 24 domain cannot stop 32 E EAR cannot deploy 29 30 Eclipse FAQs 40 41 Eclipse issues 33 34 EJB support 29 30 extensibility FAQs 41 F forums 14 Freq...

Page 48: ...ult value can change 22 ps ef 17 R Rails FAQs 43 44 release contents 14 15 release resources 19 remote server access fails 23 24 rpm 17 S security FAQs 45 security issues 36 37 server how default port number can change 22 will not start on windows 27 28 showrev 17 stack traces 18 SunSolve 15 system requirements 14 T thread dump obtaining 18 U Update Tool FAQs 45 46 upgrade issues 34 35 V VisualVM ...

Search results

Summary of Contents for Sun GlassFish EnterpriseServer v3 Prelude

Reviews:

Related manuals for Sun GlassFish EnterpriseServer v3 Prelude

Brands by name

Popular brands

Sun Microsystems Sun GlassFish EnterpriseServer v3 Prelude, Troubleshooting Manual

Search results

Summary of Contents for Sun GlassFish EnterpriseServer v3 Prelude

Reviews:

Related manuals for Sun GlassFish EnterpriseServer v3 Prelude

Brands by name

Popular brands