Summary of the content on the page No. 1
SunGlassFishEnterpriseServer
v3PreludeTroubleshooting
Guide
SunMicrosystems,Inc.
4150NetworkCircle
SantaClara,CA95054
U.S.A.
PartNo:820–6823–10
November2008
Summary of the content on the page No. 2
Copyright2008SunMicrosystems,Inc. 4150NetworkCircle,SantaClara,CA95054U.S.A. Allrightsreserved. SunMicrosystems,Inc.hasintellectualpropertyrightsrelatingtotechnologyembodiedintheproductthatisdescribedinthisdocument.Inparticular,andwithout limitation,theseintellectualpropertyrightsmayincludeoneormoreU.S.patentsorpendingpatentapplicationsintheU.S.andinothercountries. U.S.GovernmentRights–Commercialsoftware.GovernmentusersaresubjecttotheSunMicrosystems,Inc.standardlicenseagreementandapplicableprovi
Summary of the content on the page No. 3
Contents Preface.....................................................................................................................................................7 1 OverviewofEnterpriseServerTroubleshooting ...........................................................................13 IdentifyingtheProblem ......................................................................................................................13 FirstSteps .........................................................
Summary of the content on the page No. 4
Contents WasApplicationDeploymentSuccessful?................................................................................26 AdministratorUserNameorPasswordNotKnown...............................................................26 ServerWillNotStartonWindows(PortConflict)..........................................................................27 IsAnotherApplicationRunningontheServer'sPort?............................................................28 HasanUngracefulShutdownOccurredonaPrevious
Summary of the content on the page No. 5
Contents 3 FrequentlyAskedQuestions .............................................................................................................39 AdministrationFAQs..........................................................................................................................39 WhichasadminCommandsareSupported? ............................................................................39 ApplicationFAQs ................................................................................
Summary of the content on the page No. 6
Contents UpdateToolFAQs ...............................................................................................................................45 HowDoIUseUpdateTooltoExtendMyEnterpriseServerInstallation? ...........................45 Index ......................................................................................................................................................47 6 SunGlassFishEnterpriseServerv3PreludeTroubleshootingGuide • November2008
Summary of the content on the page No. 7
Preface TM ThisguidedescribescommonproblemsthatyoumightencounterwhenusingSunGlassFish EnterpriseServerv3Preludeandhowtosolvethem. ThisprefacecontainsinformationaboutandconventionsfortheentireSunGlassFish EnterpriseServerdocumentationset. Thefollowingtopicsareaddressedhere: ■ “EnterpriseServerDocumentationSet”onpage7 ■ “RelatedDocumentation”onpage9 ■ “TypographicConventions”onpage9 ■ “SymbolConventions”onpage10 ■ “DefaultPathsandFileNames”onpage10 ■ “Documentation,Support,andTraining”onpage11 ■ “
Summary of the content on the page No. 8
Preface TABLEP–1 BooksintheEnterpriseServerDocumentationSet (Continued) BookTitle Description InstallationGuide Explainshowtoinstallthesoftwareanditscomponents. ApplicationDeploymentGuide ExplainshowtoassembleanddeployapplicationstotheEnterpriseServer andprovidesinformationaboutdeploymentdescriptors. Developer’sGuide ExplainshowtocreateandimplementJavaPlatform,EnterpriseEdition (JavaEEplatform)applicationsthatareintendedtorunontheEnterprise Server.TheseapplicationsfollowtheopenJavastandardsmodel
Summary of the content on the page No. 9
Preface TABLEP–1 BooksintheEnterpriseServerDocumentationSet (Continued) BookTitle Description ReferenceManual ProvidesreferenceinformationinmanpageformatforEnterpriseServer administrationcommands,utilitycommands,andrelatedconcepts. RelatedDocumentation TM AJavadoc toolreferenceforpackagesthatareprovidedwiththeEnterpriseServerislocatedat https://glassfish.dev.java.net/nonav/api/v3-prelude/index.html.Additionally,the followingresourcesmightbeuseful: ■ TheJavaEE5Specifications(http://java.sun.com/j
Summary of the content on the page No. 10
Preface SymbolConventions Thefollowingtableexplainssymbolsthatmightbeusedinthisbook. TABLEP–3 SymbolConventions Symbol Description Example Meaning [] Containsoptionalarguments ls [-l] The-loptionisnotrequired. andcommandoptions. {|} Containsasetofchoicesfora -d {y|n} The-doptionrequiresthatyouuse requiredcommandoption. eithertheyargumentorthen argument. ${ } Indicatesavariable ${com.sun.javaRoot} Referencesthevalueofthe reference. com.sun.javaRootvariable. - Joinssimultaneousmultiple Control-A P
Summary of the content on the page No. 11
Preface TABLEP–4 DefaultPathsandFileNames (Continued) Placeholder Description DefaultValue domain-dir Representsthedirectoryinwhichadomain's domain-root-dir/domain-name configurationisstored. Inconfigurationfiles,domain-diris representedasfollows: ${com.sun.aas.instanceRoot} Documentation,Support,andTraining TheSunwebsiteprovidesinformationaboutthefollowingadditionalresources: ■ Documentation(http://www.sun.com/documentation/) ■ Support(http://www.sun.com/support/) ■ Training(http://www.sun.com/
Summary of the content on the page No. 12
Preface Note–Sunisnotresponsiblefortheavailabilityofthird-partywebsitesmentionedinthis document.Sundoesnotendorseandisnotresponsibleorliableforanycontent,advertising, products,orothermaterialsthatareavailableonorthroughsuchsitesorresources.Sunwillnot beresponsibleorliableforanyactualorallegeddamageorlosscausedorallegedtobecausedby orinconnectionwithuseoforrelianceonanysuchcontent,goods,orservicesthatareavailable onorthroughsuchsitesorresources. SunWelcomesYourComments Sunisinterestedinimprovingi
Summary of the content on the page No. 13
CHAPTER 1 1 OverviewofEnterpriseServerTroubleshooting Thischapterdescribesthetools,methods,andinformationsourcesavailablefor troubleshootingSunGlassFishEnterpriseServerv3Prelude.Guidelinesforevaluatingand investigatingaproblemareincluded. Thischaptercontainsthefollowingsections: ■ “IdentifyingtheProblem”onpage13 ■ “TroubleshootingTools”onpage17 ■ “WheretoGoforMoreInformation”onpage19 IdentifyingtheProblem Applicationserversaretypicallydeployedincomplexandsophisticatedoperating environmentsandinv
Summary of the content on the page No. 14
IdentifyingtheProblem VerifySystemRequirementsandConfiguration TM Problemsareoftencausedbyconfigurationissues(system,JVM ,server,orapplication-level) andbyresourceissues(suchaswhenasystemrunsoutofmemory).RefertotheSunGlassFish EnterpriseServerv3PreludeReleaseNotesforthelatestinformationregardingsystem requirementsdependencies. ReviewKnownIssues Yourproblemmightberelatedtoaknownissuefortherelease.RefertotheSunGlassFish EnterpriseServerv3PreludeReleaseNotesforthelatestinformationregardingknownissu
Summary of the content on the page No. 15
IdentifyingtheProblem Note–SomeresourcesrefertoGlassFishv3Prelude.GlassFishv3Preludeisthecommunity versionofthecommerciallysupportedoffering,SunGlassFishEnterpriseServerv3Prelude. Thesoftwareisthesame;thedifferenceisinsupport. SearchtheSunSolveKnowledgebase SM SunSolve isSun'sinformationalandpatchdatabaseservicewithabrowseabledirectoryofall publiclyavailableSunMicrosystemssupportdocuments.SunSolveisavailableat http://sunsolve.sun.com.Additionalresourcesarealsoavailableforcustomerswithsupport con
Summary of the content on the page No. 16
IdentifyingtheProblem ■ Haveanypatchesbeenapplied?Ifso,whataretheproductandoperatingsystempatch numbers? ■ Whatotherproductsandtechnologiesareinstalledandbeingusedintheinstallation? ■ Howmanyapplicationservers,webservers,anddirectoryserversareinstalled?Whatare theproductsandversions? ■ HowisthewebserverconnectedtoEnterpriseServer?Onthesamesystem? ■ HowisEnterpriseServerconnectedtothedirectoryserver? ■ WhatJDBCdriverisbeingusedtoaccessthedatabase? WhatIsYourSystemConfiguration? ■ Whatareyoursetti
Summary of the content on the page No. 17
TroubleshootingTools Bydefault,allEnterpriseServerloginformationiscapturedintheserver.logfile,typically locatedindomain-dir/logs.LogViewerisnotavailableinEnterpriseServerv3Prelude.You cannotviewtheserver'slogfileorconfigureloggingusingtheAdministrationConsole.Toview loginformation,opentheserver.logfileinatexteditor.Youcanalsousecommand-linefile viewingcommandssuchastail,grep,ormore.Loggingisconfiguredbyeditingthe logging.propertiesfile,locatedbydefaultinthesamedirectoryasthedomain.xmlfile, typic
Summary of the content on the page No. 18
TroubleshootingTools StackTracesandThreadDumps Astacktraceisauser-friendlysnapshotofthethreadsandmonitorsinaVirtualMachinefor theJavaplatform(JavaVirtualMachineorJVMmachine).Athreaddumpshowswhatevery threadinaJVMisdoingatagiventimeandisusefulindebugging.Whentheapplicationserver freezes,hangs,orbecomessluggishfornoapparentreason,youshouldgenerateandanalyzea threaddump. ThissectionexplainshowtoobtainathreaddumpforEnterpriseServer.Moreinformation aboutanalyzingtheinformationcontainedinathreaddumpca
Summary of the content on the page No. 19
WheretoGoforMoreInformation WheretoGoforMoreInformation ■ Productpage: http://www.sun.com/software/products/glassfishv3_prelude/index.xml ■ ComparisonbetweenSunJavaSystemApplicationServer9.1(GlassFishv2)andEnterprise Serverv3Prelude: https://glassfish.dev.java.net/public/comparing_v2_and_v3.html ■ Supportandservices: http://www.sun.com/software/products/glassfishv3_prelude/support.xml ■ SunSolveknowledgebase:http://sunsolve.sun.com ■ Resourcespage(pointstoarticles,blogs,videos,screencasts,FAQs,a
Summary of the content on the page No. 20
20
