errorrebootsystemnow什么意思

SunJavaSystemApplicationServer9.
1QuickStartGuideSunMicrosystems,Inc.
4150NetworkCircleSantaClara,CA95054U.
S.
A.
PartNo:819–3193–11November2008Copyright2008SunMicrosystems,Inc.
4150NetworkCircle,SantaClara,CA95054U.
S.
A.
Allrightsreserved.
Thisproductordocumentisprotectedbycopyrightanddistributedunderlicensesrestrictingitsuse,copying,distribution,anddecompilation.
NopartofthisproductordocumentmaybereproducedinanyformbyanymeanswithoutpriorwrittenauthorizationofSunanditslicensors,ifany.
Third-partysoftware,includingfonttechnology,iscopyrightedandlicensedfromSunsuppliers.
PartsoftheproductmaybederivedfromBerkeleyBSDsystems,licensedfromtheUniversityofCalifornia.
UNIXisaregisteredtrademarkintheU.
S.
andothercountries,exclusivelylicensedthroughX/OpenCompany,Ltd.
Sun,SunMicrosystems,theSunlogo,docs.
sun.
com,AnswerBook,AnswerBook2,andSolarisaretrademarksorregisteredtrademarksofSunMicrosystems,Inc.
intheU.
S.
andothercountries.
AllSPARCtrademarksareusedunderlicenseandaretrademarksorregisteredtrademarksofSPARCInternational,Inc.
intheU.
S.
andothercountries.
ProductsbearingSPARCtrademarksarebaseduponanarchitecturedevelopedbySunMicrosystems,Inc.
TheOPENLOOKandSunTMGraphicalUserInterfacewasdevelopedbySunMicrosystems,Inc.
foritsusersandlicensees.
SunacknowledgesthepioneeringeffortsofXeroxinresearchinganddevelopingtheconceptofvisualorgraphicaluserinterfacesforthecomputerindustry.
Sunholdsanon-exclusivelicensefromXeroxtotheXeroxGraphicalUserInterface,whichlicensealsocoversSun'slicenseeswhoimplementOPENLOOKGUIsandotherwisecomplywithSun'swrittenlicenseagreements.
U.
S.
GovernmentRights–Commercialsoftware.
GovernmentusersaresubjecttotheSunMicrosystems,Inc.
standardlicenseagreementandapplicableprovisionsoftheFARanditssupplements.
DOCUMENTATIONISPROVIDED"ASIS"ANDALLEXPRESSORIMPLIEDCONDITIONS,REPRESENTATIONSANDWARRANTIES,INCLUDINGANYIMPLIEDWARRANTYOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEORNON-INFRINGEMENT,AREDISCLAIMED,EXCEPTTOTHEEXTENTTHATSUCHDISCLAIMERSAREHELDTOBELEGALLYINVALID.
Copyright2008SunMicrosystems,Inc.
4150NetworkCircle,SantaClara,CA95054U.
S.
A.
Tousdroitsréservés.
Ceproduitoudocumentestprotégéparuncopyrightetdistribuéavecdeslicencesquienrestreignentl'utilisation,lacopie,ladistribution,etladécompilation.
Aucunepartiedeceproduitoudocumentnepeutêtrereproduitesousaucuneforme,parquelquemoyenquecesoit,sansl'autorisationpréalableetécritedeSunetdesesbailleursdelicence,s'ilyena.
Lelogicieldétenupardestiers,etquicomprendlatechnologierelativeauxpolicesdecaractères,estprotégéparuncopyrightetlicenciépardesfournisseursdeSun.
DespartiesdeceproduitpourrontêtredérivéesdusystèmeBerkeleyBSDlicenciésparl'UniversitédeCalifornie.
UNIXestunemarquedéposéeauxEtats-Unisetdansd'autrespaysetlicenciéeexclusivementparX/OpenCompany,Ltd.
Sun,SunMicrosystems,lelogoSun,docs.
sun.
com,AnswerBook,AnswerBook2,etSolarissontdesmarquesdefabriqueoudesmarquesdéposées,deSunMicrosystems,Inc.
auxEtats-Unisetdansd'autrespays.
TouteslesmarquesSPARCsontutiliséessouslicenceetsontdesmarquesdefabriqueoudesmarquesdéposéesdeSPARCInternational,Inc.
auxEtats-Unisetdansd'autrespays.
LesproduitsportantlesmarquesSPARCsontbaséssurunearchitecturedéveloppéeparSunMicrosystems,Inc.
L'interfaced'utilisationgraphiqueOPENLOOKetSunaétédéveloppéeparSunMicrosystems,Inc.
poursesutilisateursetlicenciés.
SunreconnatleseffortsdepionniersdeXeroxpourlarechercheetledéveloppementduconceptdesinterfacesd'utilisationvisuelleougraphiquepourl'industriedel'informatique.
SundétientunelicencenonexclusivedeXeroxsurl'interfaced'utilisationgraphiqueXerox,cettelicencecouvrantégalementleslicenciésdeSunquimettentenplacel'interfaced'utilisationgraphiqueOPENLOOKetquienoutreseconformentauxlicencesécritesdeSun.
CETTEPUBLICATIONESTFOURNIE"ENL'ETAT"ETAUCUNEGARANTIE,EXPRESSEOUIMPLICITE,N'ESTACCORDEE,YCOMPRISDESGARANTIESCONCERNANTLAVALEURMARCHANDE,L'APTITUDEDELAPUBLICATIONAREPONDREAUNEUTILISATIONPARTICULIERE,OULEFAITQU'ELLENESOITPASCONTREFAISANTEDEPRODUITDETIERS.
CEDENIDEGARANTIENES'APPLIQUERAITPAS,DANSLAMESUREOUILSERAITTENUJURIDIQUEMENTNULETNONAVENU.
081117@21288ContentsPreface51QuickStartforBasicFeatures11ApplicationServerAdministrationTools11StartingtheServer13ToStarttheDomainonSolarisandLinux13ToStarttheDomainonWindows14ToLogOntotheAdminConsole15ToViewtheDomainAdministrationServerLogFile17ToStarttheNodeAgent18ToAddClusterSupporttoaDomain19ToStarttheBundledJavaDBServer20WheretoGoNext202SettingUpaCluster21CreatingaCluster21ToCreateaClusterusingtheAdminConsole21ToCreateaClusterusingCLICommands22ViewingPortsforClusteredServerInstances23ToViewPortsforClusteredServerInstances233DeployinganApplication25DeployingaSampleWebApplication25ToDeploytheHelloApplicationUsingAutodeploy25ToDeploytheHelloApplicationUsingAdminConsole26DeployingtheSampleEnterpriseApplicationtoaCluster28ToDeploytheSampleEnterpriseApplicationUsingAdminConsole283ToStarttheInstancesinaCluster29ToVerifyApplicationDeployment294WorkingwithLoadBalancers31SettingupLoadBalancing32ToSetUpLoadBalancing32StartingLoadBalancing33VerifyingLoadBalancing33ToVerifyLoadBalancing33HighAvailabilityandFailoverUsingtheIn-memoryReplicationFeature345SettingUpHighAvailabilityFailover37High-availabilityClustersandHADB38HADBPreinstallationSteps38ToConfigureYourSystemforHADB39InstallingHADB40ToInstallHADB40StartingHADB41ToStartHADBinaJavaEnterpriseSystemInstallationonSolarisorLinux41ToStartHADBinaJavaEnterpriseSystemInstallationonWindows41ToStartHADBinaStand-AloneInstallationonSolarisorLinux42ToStartHADBinaStand-AloneInstallationonWindows42ConfiguringaClusterandApplicationforHighAvailability42RestartingtheCluster42ToRestarttheCluster42VerifyingHTTPSessionFailover43ToVerifyHTTPSessionFailover43ContentsSunJavaSystemApplicationServer9.
1QuickStartGuideNovember20084PrefaceThisQuickStartGuideprovidesbasicprocedurestostarttheserver,deployanapplication,andsetuploadbalancingandfailover.
ThisprefacecontainsinformationaboutandconventionsfortheentireSunJavaTMSystemApplicationServerdocumentationset.
ApplicationServerDocumentationSetTheApplicationServerdocumentationsetdescribesdeploymentplanningandsysteminstallation.
TheUniformResourceLocator(URL)forApplicationServerdocumentationishttp://docs.
sun.
com/coll/1343.
4.
ForanintroductiontoApplicationServer,refertothebooksintheorderinwhichtheyarelistedinthefollowingtable.
TABLEP–1BooksintheApplicationServerDocumentationSetBookTitleDescriptionDocumentationCenterApplicationServerdocumentationtopicsorganizedbytaskandsubject.
ReleaseNotesLate-breakinginformationaboutthesoftwareandthedocumentation.
Includesacomprehensive,table-basedsummaryofthesupportedhardware,operatingsystem,JavaDevelopmentKit(JDKTM),anddatabasedrivers.
QuickStartGuideHowtogetstartedwiththeApplicationServerproduct.
InstallationGuideInstallingthesoftwareanditscomponents.
DeploymentPlanningGuideEvaluatingyoursystemneedsandenterprisetoensurethatyoudeploytheApplicationServerinamannerthatbestsuitsyoursite.
Generalissuesandconcernsthatyoumustbeawareofwhendeployingtheserverarealsodiscussed.
ApplicationDeploymentGuideDeploymentofapplicationsandapplicationcomponentstotheApplicationServer.
Includesinformationaboutdeploymentdescriptors.
Developer'sGuideCreatingandimplementingJavaPlatform,EnterpriseEdition(JavaEEplatform)applicationsintendedtorunontheApplicationServerthatfollowtheopenJavastandardsmodelforJavaEEcomponentsandAPIs.
Includesinformationaboutdevelopertools,security,debugging,andcreatinglifecyclemodules.
5TABLEP–1BooksintheApplicationServerDocumentationSet(Continued)BookTitleDescriptionJavaEE5TutorialUsingJavaEE5platformtechnologiesandAPIstodevelopJavaEEapplications.
JavaWSITTutorialDevelopingwebapplicationsusingtheWebServiceInteroperabilityTechnologies(WSIT).
Describeshow,when,andwhytousetheWSITtechnologiesandthefeaturesandoptionsthateachtechnologysupports.
AdministrationGuideSystemadministrationfortheApplicationServer,includingconfiguration,monitoring,security,resourcemanagement,andwebservicesmanagement.
HighAvailabilityAdministrationGuidePost-installationconfigurationandadministrationinstructionsforthehigh-availabilitydatabase.
AdministrationReferenceEditingtheApplicationServerconfigurationfile,domain.
xml.
UpgradeandMigrationGuideUpgradingfromanolderversionofApplicationServerormigratingJavaEEapplicationsfromcompetitiveapplicationservers.
Thisguidealsodescribesdifferencesbetweenadjacentproductreleasesandconfigurationoptionsthatcanresultinincompatibilitywiththeproductspecifications.
PerformanceTuningGuideTuningtheApplicationServertoimproveperformance.
TroubleshootingGuideSolvingApplicationServerproblems.
ErrorMessageReferenceSolvingApplicationServererrormessages.
ReferenceManualUtilitycommandsavailablewiththeApplicationServer;writteninmanpagestyle.
Includestheasadmincommandlineinterface.
RelatedDocumentationApplicationServercanbepurchasedbyitselforasacomponentofSunJavaEnterpriseSystem(JavaES),asoftwareinfrastructurethatsupportsenterpriseapplicationsdistributedacrossanetworkorInternetenvironment.
IfyoupurchasedApplicationServerasacomponentofJavaES,youshouldbefamiliarwiththesystemdocumentationathttp://docs.
sun.
com/coll/1286.
3.
TheURLforalldocumentationaboutJavaESanditscomponentsishttp://docs.
sun.
com/prod/entsys.
5.
Fordocumentationaboutotherstand-aloneSunJavaSystemserverproducts,gotothefollowing:MessageQueuedocumentation(http://docs.
sun.
com/coll/1343.
4)DirectoryServerdocumentation(http://docs.
sun.
com/coll/1224.
1)WebServerdocumentation(http://docs.
sun.
com/coll/1308.
3)AJavadocTMtoolreferenceforpackagesprovidedwiththeApplicationServerislocatedathttp://glassfish.
dev.
java.
net/nonav/javaee5/api/index.
html.
Additionally,thefollowingresourcesmightbeuseful:PrefaceSunJavaSystemApplicationServer9.
1QuickStartGuideNovember20086TheJavaEE5Specifications(http://java.
sun.
com/javaee/5/javatech.
html)TheJavaEEBlueprints(http://java.
sun.
com/reference/blueprints/index.
html)ForinformationoncreatingenterpriseapplicationsintheNetBeansTMIntegratedDevelopmentEnvironment(IDE),seehttp://www.
netbeans.
org/kb/55/index.
html.
ForinformationabouttheJavaDBdatabaseincludedwiththeApplicationServer,seehttp://developers.
sun.
com/javadb/.
TheGlassFishSamplesprojectisacollectionofsampleapplicationsthatdemonstrateabroadrangeofJavaEEtechnologies.
TheGlassFishSamplesarebundledwiththeJavaEESoftwareDevelopmentKit(SDK),andarealsoavailablefromtheGlassFishSamplesprojectpageathttps://glassfish-samples.
dev.
java.
net/.
DefaultPathsandFileNamesThefollowingtabledescribesthedefaultpathsandfilenamesthatareusedinthisbook.
TABLEP–2DefaultPathsandFileNamesPlaceholderDescriptionDefaultValueas-installRepresentsthebaseinstallationdirectoryforApplicationServer.
JavaESinstallationsontheSolarisTMoperatingsystem:/opt/SUNWappserver/appserverJavaESinstallationsontheLinuxoperatingsystem:/opt/sun/appserver/OtherSolarisandLinuxinstallations,non-rootuser:user's-home-directory/SUNWappserverOtherSolarisandLinuxinstallations,rootuser:/opt/SUNWappserverWindows,allinstallations:SystemDrive:\Sun\AppServerPreface7TABLEP–2DefaultPathsandFileNames(Continued)PlaceholderDescriptionDefaultValuedomain-root-dirRepresentsthedirectorycontainingalldomains.
JavaESSolarisinstallations:/var/opt/SUNWappserver/domains/JavaESLinuxinstallations:/var/opt/sun/appserver/domains/Allotherinstallations:as-install/domains/domain-dirRepresentsthedirectoryforadomain.
Inconfigurationfiles,youmightseedomain-dirrepresentedasfollows:${com.
sun.
aas.
instanceRoot}domain-root-dir/domain-dirinstance-dirRepresentsthedirectoryforaserverinstance.
domain-dir/instance-dirTypographicConventionsThefollowingtabledescribesthetypographicchangesthatareusedinthisbook.
TABLEP–3TypographicConventionsTypefaceMeaningExampleAaBbCc123Thenamesofcommands,files,anddirectories,andonscreencomputeroutputEdityour.
loginfile.
Usels-atolistallfiles.
machine_name%youhavemail.
AaBbCc123Whatyoutype,contrastedwithonscreencomputeroutputmachine_name%suPassword:AaBbCc123AplaceholdertobereplacedwitharealnameorvalueThecommandtoremoveafileisrmfilename.
AaBbCc123Booktitles,newterms,andtermstobeemphasized(notethatsomeemphasizeditemsappearboldonline)ReadChapter6intheUser'sGuide.
Acacheisacopythatisstoredlocally.
Donotsavethefile.
PrefaceSunJavaSystemApplicationServer9.
1QuickStartGuideNovember20088SymbolConventionsThefollowingtableexplainssymbolsthatmightbeusedinthisbook.
TABLEP–4SymbolConventionsSymbolDescriptionExampleMeaning[]Containsoptionalargumentsandcommandoptions.
ls[-l]The-loptionisnotrequired.
{|}Containsasetofchoicesforarequiredcommandoption.
-d{y|n}The-doptionrequiresthatyouuseeithertheyargumentorthenargument.
${}Indicatesavariablereference.
${com.
sun.
javaRoot}Referencesthevalueofthecom.
sun.
javaRootvariable.
-Joinssimultaneousmultiplekeystrokes.
Control-APresstheControlkeywhileyoupresstheAkey.
+Joinsconsecutivemultiplekeystrokes.
Ctrl+A+NPresstheControlkey,releaseit,andthenpressthesubsequentkeys.
→Indicatesmenuitemselectioninagraphicaluserinterface.
File→New→TemplatesFromtheFilemenu,chooseNew.
FromtheNewsubmenu,chooseTemplates.
Documentation,Support,andTrainingTheSunwebsiteprovidesinformationaboutthefollowingadditionalresources:Documentation(http://www.
sun.
com/documentation/)Support(http://www.
sun.
com/support/)Training(http://www.
sun.
com/training/)SearchingSunProductDocumentationBesidessearchingSunproductdocumentationfromthedocs.
sun.
comSMwebsite,youcanuseasearchenginebytypingthefollowingsyntaxinthesearchfield:search-termsite:docs.
sun.
comForexample,tosearchfor"broker,"typethefollowing:brokersite:docs.
sun.
comPreface9ToincludeotherSunwebsitesinyoursearch(forexample,java.
sun.
com,www.
sun.
com,anddevelopers.
sun.
com),usesun.
cominplaceofdocs.
sun.
cominthesearchfield.
Third-PartyWebSiteReferencesThird-partyURLsarereferencedinthisdocumentandprovideadditional,relatedinformation.
Note–Sunisnotresponsiblefortheavailabilityofthird-partywebsitesmentionedinthisdocument.
Sundoesnotendorseandisnotresponsibleorliableforanycontent,advertising,products,orothermaterialsthatareavailableonorthroughsuchsitesorresources.
Sunwillnotberesponsibleorliableforanyactualorallegeddamageorlosscausedorallegedtobecausedbyorinconnectionwithuseoforrelianceonanysuchcontent,goods,orservicesthatareavailableonorthroughsuchsitesorresources.
SunWelcomesYourCommentsSunisinterestedinimprovingitsdocumentationandwelcomesyourcommentsandsuggestions.
Toshareyourcomments,gotohttp://docs.
sun.
comandclickSendComments.
Intheonlineform,providethefulldocumenttitleandpartnumber.
Thepartnumberisa7-digitor9-digitnumberthatcanbefoundonthebook'stitlepageorinthedocument'sURL.
Forexample,thepartnumberofthisbookis819-3193.
PrefaceSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200810QuickStartforBasicFeaturesWelcometotheQuickStartGuide.
ThisguideprovidesasetofsampleproceduresthatyoucanusetogetstartedwiththeApplicationServer.
BeforeusingtheproceduresinthisdocumentyoumusthavealreadyinstalledtheApplicationServersoftware.
Thissectioncontainsthefollowingtopics:"ApplicationServerAdministrationTools"onpage11"StartingtheServer"onpage13"WheretoGoNext"onpage20ApplicationServerAdministrationToolsToenableadministratorstomanageserverinstancesandclustersrunningonmultiplehosts,ApplicationServerprovidesthesetools:TheAdminConsole,abrowser-basedgraphicaluserinterface(GUI)Command-linetools,suchastheasadminutility.
SeeTable1–1forthecompletelistofcommand-linetoolsavailablewithApplicationServer.
ProgrammaticJavaManagementExtensions(JMXTM)APIsThesetoolsconnecttoaservercalledtheDomainAdministrationServer,aspeciallydesignatedApplicationServerinstancethatintermediatesinalladministrativetasks.
TheDomainAdministrationServer(DAS)providesasinglesecureinterfaceforvalidatingandexecutingadministrativecommandsregardlessofwhichinterfaceisused.
Adomainisacollectionofconfigurationdata,deployedapplications,andmachineswithadesignatedadministrator.
Thedomaindefinitiondescribesandcancontroltheoperationofseveralapplications,stand-aloneapplicationserverinstances,andclusters,potentiallyspreadovermultiplemachines.
WhentheDASisinstalled,adefaultdomaincalleddomain1isalwaysinstalled.
Youworkwiththedefaultdomaininthisguide.
1CHAPTER111TheApplicationServersoftwareoffersavarietyofcommand-linetoolsforperformingadministrativefunctions,inadditiontotheAdminConsole.
Tolaunchatool,typethenameofthetoolinacommandwindow.
Table1–1liststoolsbynameinthefirstcolumnanddescribestheminthesecondcolumn.
TABLE1–1Command-LineToolsNameofToolDescriptionappclientLaunchestheApplicationClientContainerandinvokestheclientapplicationpackagedintheapplicationJavaarchive(JAR)file.
asadminLaunchestheApplicationServeradministrationtoolthatprovidesasetofsubcommandsforconfiguringtheApplicationServersoftware.
asantLaunchestheJakartaAnttool,sothatyoucanautomaterepetitivedevelopmentanddeploymenttasks.
asaptCompilesJavasourceswithJavaEEannotations.
Thetoolautomaticallyinvokesthewsimportcommand.
asupgradeApplicationServeradministrationtoolforupgradingtheApplicationServersoftware.
capture-schemaExtractsschemainformationfromadatabaseandproducesaschemafilethattheservercanuseforContainerManagedPersistence(CMP).
jspcCompilesJSPpages.
package-appclientPackagestheapplicationclientcontainerlibrariesandJARfiles.
schemagenCreatesaschemafileforeachnamespacereferencedinyourJavaclasses.
verifierValidatestheJavaEEdeploymentdescriptorswiththeDTDs.
Thistoolalsoprovidesagraphicaluserinterface.
ToseetheGUI,specifythe-uoption.
SomeWindowssystemslaunchadriververifierutilitywiththesamename.
TolaunchtheApplicationSerververifier,youmustbeintheas-install/bindirectory.
wscompileTakestheservicedefinitioninterfaceandgeneratestheclientstubsorserver-sideskeletonsforJAX-RPC;orgeneratesaWebServicesDescriptionLanguage(WSDL)descriptionfortheprovidedinterface.
wsdeployGeneratesanimplementation-specific,ready-to-deployWARfileforwebservicesapplicationsthatuseJAX-RPC.
wsgenReadsawebserviceendpointclassandgeneratesalltherequiredartifactsforwebservicedeploymentandinvocation.
ApplicationServerAdministrationToolsSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200812TABLE1–1Command-LineTools(Continued)NameofToolDescriptionwsimportGeneratesJAX-WSportableartifacts,suchasserviceendpointinterfaces(SEIs),services,exceptionclassesmappedfromthewsdl:faultandsoap:headerfaulttags,asynchronousresponsebeansderivedfromthewsdl:messagetag,andJAXBgeneratedvaluetypes.
xjcTransforms,orbinds,asourceXMLschematoasetofJAXBcontentclassesintheJavaprogramminglanguage.
Note–Torunthesecommand-linetoolsonWindows,ensurethatyouhaveanenvironmentvariablecalledPATHthatpointstotheas-install/bin/directory.
Youcanruntheasadminsubcommandsbyprefixingasadminwitheverysubcommandorbyenteringtheasadminprompt(typeasadminandhitReturn)intheas-install/bin/directory.
StartingtheServerThistopicprovidesinstructionsforthefollowingbasictasks:startingtheDomainAdministrationServer(DAS),loggingintotheAdminConsole,examiningthelogfiles,andstartingthenodeagent.
Thestepsarepresentedintheorderthatyoushouldcompletethem.
"ToStarttheDomainonSolarisandLinux"onpage13"ToStarttheDomainonWindows"onpage14"ToLogOntotheAdminConsole"onpage15"ToViewtheDomainAdministrationServerLogFile"onpage17"ToStarttheNodeAgent"onpage18"ToAddClusterSupporttoaDomain"onpage19"ToStarttheBundledJavaDBServer"onpage20ToStarttheDomainonSolarisandLinuxTostarttheDomainAdministrationServer,startthedefaultdomain,domain1.
Addtheas-install/bin/directorytothePATHenvironmentvariable.
Starttheserverbyenteringthiscommand:asadminstart-domaindomain112StartingtheServerChapter1QuickStartforBasicFeatures13Whenyouarepromptedfortheuser,adminpassword,andthemasterpassword,enteryourusernameandthepasswordsthatyouprovidedduringinstallation.
Whenthestartupprocessiscomplete,thefollowingmessageappears:Domaindomain1startedOntheUbuntuLinuxoperatingsystem,ifyoudonothaverootaccess,youcanusetheasadminconveniencewrapperscriptlocatedin/usr/bintocreateadomaininyourhomedirectory.
Runningasadminstart-domainfromtheconveniencescriptcreatesandstartsthedomain.
Formoreinformationontheconveniencescript,typeasadminmanatthecommandprompt.
Ifyouhaverootaccess,youcanalsocreateandstartdomainsusingtheasadmincommandscreate-domainandstart-domainfromtheas-install/bindirectory.
Thesedomainsarecreatedbydefaultindomain-root-dir.
Eachdomainhasacorrespondingprofile:enterprise,cluster,ordeveloper.
domain1iscreatedwiththedefaultprofile,whichisdefinedintheAS_ADMIN_PROFILEvariabledefinedintheasadminenv.
conffile.
Formoreinformationonthethreeprofilesseethe"UsageProfiles"inSunJavaSystemApplicationServer9.
1AdministrationGuide.
Ifdomain1wascreatedwithdeveloperprofile,whenyoulogintotheAdminConsole,youcannotusefeaturessuchasclusteringandnodeagents.
Touseclustersandserverinstances,usethecreate-domaincommandtocreateadomainwithclusterprofile.
Forinformationoncreatingdomains,typeasadmincreate-domain--helporseecreate-domain(1)intheSunJavaSystemApplicationServer9.
1ReferenceManual.
ToStarttheDomainonWindowsTostarttheDomainAdministrationServer,startthedefaultdomain,domain1.
FromtheExplorerwindowordesktop,rightclickMyComputer.
ChoosePropertiestodisplaytheSystemPropertiesdialog.
ClicktheAdvancedtab.
ClickEnvironmentVariables.
IntheUservariablessection:IfaPATHvariableexists,verifythatas-install\binexistsinthepath:as-install\bin;other_entries.
Ifas-install\bindoesnotexistinthePATHvariable,addit.
IfaPATHvariableisnotpresent,clickNew.
InVariableName,typePATH.
InVariableValue,typethepathtotheserver'sbindirectory:as-install\bin.
ClickOKtocommitthechange.
12345StartingtheServerSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200814AddanewenvironmentvariableAS_ADMIN_USERandsetittotheAdministrativeUserNamethatyouassignedduringinstallation.
ClickOKtocommitthechangeandclosetheremainingopenwindows.
StarttheApplicationServerbyclickingtheStartAdminServeroptionwithintheProgramsmenu.
Whenacommandpromptwindowopenstopromptyoufortheadminpasswordandthemasterpassword,enterthepasswordsthatyouprovidedduringinstallation.
Awindowappearswithamessagetellingthatyoutheserverisstarting:StartingDomaindomain1,pleasewait.
Logredirectedtodomain_dir\domain1\logs\server.
log.
.
.
Whenthestartupprocesshascompleted,youseeanadditionalmessage:Domaindomain1started.
Pressanykeytocontinue.
.
.
Eachdomainhasacorrespondingprofile:enterprise,cluster,ordeveloper.
domain1iscreatedwiththedefaultprofile,whichisdefinedintheAS_ADMIN_PROFILEvariabledefinedintheasadminenv.
conffile.
Formoreinformationonprofilesseethe"UsageProfiles"inSunJavaSystemApplicationServer9.
1AdministrationGuide.
Ifdomain1wascreatedwithdeveloperprofile,whenyoulogintotheAdminConsole,youcannotusefeaturessuchasclusteringandnodeagents.
Touseclustersandserverinstances,usethecreate-domaincommandtocreateadomainwithclusterprofile.
Forinformationoncreatingdomains,typeasadmincreate-domain--helporseecreate-domain(1)intheSunJavaSystemApplicationServer9.
1ReferenceManual.
Pressakeytoclosethemessagewindow.
ToLogOntotheAdminConsoleTheAdminConsoleisabrowserinterfacethatsimplifiesavarietyofadministrationandconfigurationtasks.
Itiscommonlyusedto:DeployandundeployapplicationsEnable,disable,andmanageapplicationsConfigureresourcesandotherserversettingsSelectandviewlogfilesForfurtherinformationaboutusingtheAdminConsole,consulttheonlinehelportheSunJavaSystemApplicationServer9.
1AdministrationGuide.
678910StartingtheServerChapter1QuickStartforBasicFeatures15TypethisURLinyourbrowser:http://localhost:4848Ifthebrowserisonadifferentsystemthantheserver,replacethelocalhostvariablewiththenameofthesystemthattheDomainAdminServerisrunningon.
4848istheAdminConsole'sdefaultportnumber.
Ifyouchangedtheportnumberduringtheinstallationorifyouhavecreatedadomainwithanotherportnumber,usethatnumberinstead.
Note–IfapopupwindowappearswithamessagesuchasWebsiteCertifiedbyanUnknownAuthority,clickOK.
Thismessageappearsbecauseyourbrowserdoesnotrecognizetheself-signedcertificatethattheDomainAdministrationServerusestoservicetheAdminConsoleoverthesecuretransmissionprotocol.
WhentheLoginwindowappears,entertheadminusernameandpassword.
ClickLogin.
Intheleftpane,selectwhatyouwanttomanagefromthetreeprovided.
Intherightpane,variousadministrativetasksarelistedundertheCommonTasksheading.
123StartingtheServerSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200816ToViewtheDomainAdministrationServerLogFileApplicationServerinstancesandtheDomainAdministrationServerproduceannotatedlogsonthefilesystem.
Bydefault,allerrors,warningsorusefulinformativemessagesarelogged.
FromtheCommonTaskslistintherightpane,clickSearchLogFilestolaunchanewbrowserwindowforLogViewer.
IntheLogViewerwindow,select"server"fromtheInstanceNamedrop-downlistandclickSearch.
TheDomainAdministrationServer'srecentlogfileentriesaredisplayed.
12StartingtheServerChapter1QuickStartforBasicFeatures17ScanthemessagesandlookforanyWARNINGorSEVEREmessagesindicatingthatproblemswereencounteredduringserverstartup.
YoucancloseLogVieweratanytime.
Afteryoucreateclustersanddeployapplications,examinelogfilesifanyoftheoperationsfailed.
UseLogViewertoviewthelogfilesofanyrunningApplicationServerinstanceinthedomain.
ToStarttheNodeAgentAnodeagentisalightweightprocessrunningoneachmachinethatparticipatesinanApplicationServeradministrativedomain.
Thenodeagentisresponsibleforstartingandstoppingserverinstancesonthehost.
ItalsocommunicateswiththeDomainAdministrationServertocreatenewApplicationServerinstances.
Note–Youcanusenodeagentsonlyondomainswiththeclusterorenterpriseprofile.
Ifyouarerunningonlyadeveloperdomain,youneedtocreateadomainwithclusterprofilebeforeyoucancreateandusenodeagents.
Forinformationoncreatingdomains,typeasadmincreate-domain--helporseecreate-domain(1)intheSunJavaSystemApplicationServer9.
1ReferenceManualOnenodeagentisneededonamachineforeachApplicationServeradministrativedomainthatthemachinebelongsto.
IfyouareusingSunJavaSystemApplicationServer9.
1(Enterprisebundle),choosetheNodeAgentComponentduringinstallationandadefaultnodeagentcalledhostnameiscreated.
IfyouhaveinstalledGlassfish,thenodeagentisnotautomaticallycreated.
Tocreateanodeagent,followtheinstructionsin"ToCreateaNodeAgent"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuide.
Inaterminalwindow,typethiscommand:asadminstart-node-agentnodeagentnameReplacethevariablenodeagentnamewiththenameofthenodeagentyoucreated.
Ifyouwanttousethedefaultnodeagent,whichiscreatedbySunJavaSystemApplicationServer9.
1,replacethenodeagentnamewiththenameofthehostonwhichApplicationServerisrunning.
Ifyourdefaultdomainonport4848(domain1)isnotrunningonclusterorenterpriseprofile,usethe--portoptiontospecifytheportoftheclusterorenterprisedomain.
Whenyouareprompted,providethemasterpassword.
ThenodeagentstartsandconnectswiththeDomainAdministrationServer.
312StartingtheServerSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200818Note–EnsurethattheDomainAdministrationServerisrunningbeforeyoustartthenodeagent.
Checktheserver.
logfileofaclusterinstancetoidentifyproblemsrelatedtostartingnodeagentsorclusterinstances.
IfyouhaveproblemswhilestartinganodeagentoraclusteronWindows,seetheSunJavaSystemApplicationServer9.
1ReleaseNotesforpossiblesolutionstotheproblem.
Afterthenodeagenthasbeenstartedonce,youcanviewitintheAdminConsole.
InthissectionyoustartedtheDomainAdministrationServerandconfirmedthatitisrunning.
YoualsologgedintotheAdminConsoleandusedtheLogViewer.
Youstartedthenodeagent.
YoucanstoptheQuickStarttrailhereifyoudonotwishtocontinue,oryoucangoontothenextsection.
ToAddClusterSupporttoaDomainYoucanusetheAdminConsoleaddclustersupporttoadeveloperdomain.
LogontotheAdminConsole.
Forinstructions,see"ToLogOntotheAdminConsole"onpage15.
Fromtheleftpane,clickApplicationServer.
ClicktheAddClusterSupportbuttonintheGeneraltab.
TheAddClusterSupportpageappears.
ReviewtheinformationonthispageandclickOK.
IntheRestartRequiredPage,clicktheStopInstancebuttontostopthedomain.
Logintothemachinewherethedomainisinstalledandrunthefollowingcommand:as-install/bin/asadminlist-domains.
Verifythatthedomainwasstopped.
Runthefollowingcommand:as-install/bin/asadminstart-domainTherestarteddomainsupportsclustering.
TroubleshootingIftherestarteddomaindoesnotshowclusteringcapabilities,stopthedomain,rebootthemachineonwhichthedomainisinstalled,andrestartthedomainasshowninstep7.
NextSteps1234567MoreInformationStartingtheServerChapter1QuickStartforBasicFeatures19ToStarttheBundledJavaDBServerTheApplicationServerincludesabundledJavaDBserver.
Tostartit,usethefollowingprocedure:Makesurethatyouareloggedinastheuserthatinstalledthedatabase.
Runasadminstart-database.
Formoreinformationonthestart-databasecommand,seethecommand'shelporthestart-database(1)informationinSunJavaSystemApplicationServer9.
1ReferenceManual.
WheretoGoNextThenextstepsoftheQuickStartGuideareavailableinthefollowingchapters.
Chapter2,"SettingUpaCluster"Stepsforcreatingasamplecluster.
Skiptothenextchapterifyouarerunningadomainwithdeveloperprofile.
Chapter3,"DeployinganApplication"Stepsfordeployingasamplewebapplication.
Ifyouareusingadomainwithclustercapabilities,youcanperformthestepsfordeployinganenterpriseapplicationtoacluster.
Chapter4,"WorkingwithLoadBalancers"Stepsforcreatingandusingaloadbalancer.
Requiresinstallationoftheloadbalancerplug-inandtheWebServer.
OtherresourcesforlearningandusingApplicationServerareavailable.
Theyinclude:Productdetailsatas-install/docs-ee/about.
html.
Sampleapplicationsatas-install/samplesSunJavaSystemApplicationServer9.
1ReleaseNotesSunJavaSystemApplicationServer9.
1AdministrationGuideSunJavaSystemApplicationServer9.
1ReferenceManual(manpages)SunJavaSystemApplicationServer9.
1ReferenceManual(manpages)SunJavaSystemApplicationServer9.
1ApplicationDeploymentGuideSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuideTheJavaEE5TutorialJavaBluePrints(http://java.
sun.
com/blueprints)guidelinesfortheEnterprise12WheretoGoNextSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200820SettingUpaClusterThischapterdescribeshowtocreateandsetupclusters.
Aclusterisagroupofserverinstances(typicallyonmultiplehosts)thatsharethesameconfigurations,resources,andapplications.
Aclusterfacilitatesloadbalancingacrossserverinstancesandhighavailabilitythroughfailover.
Youcancreateclustersspanningmultiplemachinesandmanagethemwiththehelpofthenodeagentprocessoneachmachine.
Thischapterassumesthatyouarerunningadomainwithclusterorenterpriseprofile.
Thischapterhasthefollowingsections:"CreatingaCluster"onpage21"ViewingPortsforClusteredServerInstances"onpage23CreatingaClusterThissectionexplainshowtocreateaclusterthatcontainstwoApplicationServerinstances.
ToCreateaClusterusingtheAdminConsoleForsimplicity,theclusterrunscompletelywithinonemachine.
ThisprocedurecreatesthesampleclusteronethesamehostonwhichtheDASisrunning.
Youmusthavealreadystartedthenodeagent,asdescribedin"ToStarttheNodeAgent"onpage18.
Whenyouspecifyinstancesduringclustercreation,associatetheinstancewitharunningnodeagentforthemachineonwhichyouwanttheinstancetorun.
Ifthenodeagentisnotrunning,theinstancewillnotstart.
Nodeagentandinstancenamesmustbeuniqueacrossclustersthatarecreatedinadomain.
2CHAPTER2BeforeYouBegin21LogintotheAdministrationConsoleathttp://localhost:portnumberifyouhavenotalreadydoneso.
ReplacethelocalhostvariablewiththenameofthesystemthattheDomainAdministrationServerisrunningon.
Replaceportnumberwiththeportnumberoftheclusterorenterprisedomain.
Ontherightpane,underCommonTasks,clickCreateNewClustertodisplaytheNewClusterpage.
Typecluster1asthenameofthenewcluster.
Fromthedrop-downlistofavailableconfigurationtemplates,selectthedefault-configconfigurationandchooseMakeacopyoftheselectedConfiguration.
ClicktheNewbuttontwicetocreatetwoentriestospecifytwoinstancesforthecluster.
Typeinstance1andinstance2asinstancenames.
Alternatively,youcanspecifythenameofanodeagentthatyoucreatedandstarted.
Tocreateanodeagentandstartit,usetheasadmincreate-node-agent(1)command.
ClickOK.
TheClusterCreatedSuccessfullypageappears,andcluster1appearsinthetreeintheleftpane.
Acopyoftheconfigurationtemplatedefault-configwasmadeforthiscluster,andthenamecluster1-configwasassignedtoit.
Startcluster1Cluster.
ToCreateaClusterusingCLICommandsCreateaclustercalledcluster1byrunningthefollowingasadmincommand:asadmincreate-cluster--useradmin--passwordfileadminpassword.
txt--hostlocalhost-port4848cluster1Createsaclustercalledcluster1byrunningthefollowingasadmincommand:asadmincreate-cluster--useradmin--passwordfileadminpassword.
txt--hostlocalhost-port4848cluster1Createanode-agentcalledcluster1-nodeagentbyrunningthefollowingcommand:asadmincreate-node-agent--useradmin--passwordfileadminpassword.
txt--hostlocalhost--port4848cluster1-nodeagent12345678123CreatingaClusterSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200822Startthisnode-agentbyrunningthefollowingcommand:asadminstart-node-agent--useradmin--passwordfileadminpassword.
txt--hostlocalhost--port4848cluster1-nodeagentCreatetwoinstancesundertheclusterbyrunningthefollowingcommands:asadmincreate-instance--useradmin--passwordfileadminpassword.
txt--hostlocalhost-port4848--clustercluster1--nodeagentcluster1-nodeagent--systemproperties"JMX_SYSTEM_CONNECTOR_PORT=8687:IIOP_LISTENER_PORT=3330:IIOP_SSL_LISTENER_PORT=4440:IIOP_SSL_MUTUALAUTH_PORT=5550:HTTP_LISTENER_PORT=1110:HTTP_SSL_LISTENER_PORT=2220"instance1asadmincreate-instance--useradmin--passwordfileadminpassword.
txt--hostlocalhost-port4848--clustercluster1--nodeagentcluster1-nodeagent--systemproperties"JMX_SYSTEM_CONNECTOR_PORT=8688:IIOP_LISTENER_PORT=3331:IIOP_SSL_LISTENER_PORT=4441:IIOP_SSL_MUTUALAUTH_PORT=5551:HTTP_LISTENER_PORT=1111:HTTP_SSL_LISTENER_PORT=2221"instance2Starttheclusterbyrunningthefollowingcommand:asadminstart-cluster--useradmin--passwordfileadminpassword.
txt--hostlocalhost--port4848cluster1SeeChapter6,"UsingApplicationServerClusters,"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuidefordetailedinformationoncreatingandconfiguringclusters.
SeeChapter8,"ConfiguringNodeAgents,"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuidefordetailedinformationoncreatingandconfiguringnodeagents.
ViewingPortsforClusteredServerInstancesToViewPortsforClusteredServerInstancesYoucanviewtheportsnumbersandoverridethedefaultvaluesfortheclusteredserverinstanceyoucreatedintheprevioussection,"CreatingaCluster"onpage21.
Bydefault,theHTTPportsare38081forinstance1and38080forinstance2.
Iftheseportswerebusyonyourmachinewhenyoucreatedtheseclusters,orifyouhadalreadyassignedtheseportstootherinstancesandclusters,differentportnumberswereassigned.
Toviewtheportnumbersandoptionallyoverridethedefaultvalues,followthesesteps:Intheleftpane,expandClustersandclickcluster1todisplaytheGeneralInformationpageforclusters.
4561ViewingPortsforClusteredServerInstancesChapter2SettingUpaCluster23ClicktheInstancestabtodisplayinstance1andinstance2,theinstancesthatyoucreated.
a.
Clickinstance1toexaminethisinstance.
TheHTTPandHTTPSportsassignedtotheinstancearedisplayedintheHTTPPortsfield.
b.
Repeatthesestepsforinstance2.
Inthissectionyouhavecreatedasimpleclusteronasinglemachine.
Youcanalsocreateclustersspanningmultiplemachinesusingthesamebasicsteps(aslongasyouhavethesoftwareinstalledandanodeagentrunningoneachmachine).
2NextStepsViewingPortsforClusteredServerInstancesSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200824DeployinganApplicationThischapterexplainshowtodeployanapplication.
Ifyouarerunningadomainwithdeveloperprofile,see"DeployingaSampleWebApplication"onpage25.
Ifyouarerunningadomainwithclusterprofile,see"DeployingtheSampleEnterpriseApplicationtoaCluster"onpage28.
Thischapterpresentsthefollowingsections:"DeployingaSampleWebApplication"onpage25"DeployingtheSampleEnterpriseApplicationtoaCluster"onpage28"ToStarttheInstancesinaCluster"onpage29"ToVerifyApplicationDeployment"onpage29DeployingaSampleWebApplicationTheseproceduresassumethatyouarerunningadomainwithdeveloperprofile.
ToDeploytheHelloApplicationUsingAutodeployTheserverinstallationincludesapre-packagedapplicationthatsays"Hello,"takenfromTheJavaEE5Tutorial.
TheHelloapplicationiscontainedinaWebARchive(WAR)fileinthesamples/quickstartdirectory.
PackagedapplicationscanalsobeintheformofaJavaARchive(JAR)orEnterpriseARchive(EAR)file.
Alternatively,youcandownloadthisapplicationfromTheJavaEE5Tutorialorfromhttp://glasfish.
dev.
java.
net/downloads/quickstart/hello.
war.
Copyingtoadomain'sautodeploydirectoryletsyouputapre-packagedapplicationintouseimmediately,withminimaleffort.
Findas-install/samples/quickstart/hello.
warordownloadfromhttp://glasfish.
dev.
java.
net/downloads/quickstart/hello.
war.
3CHAPTER3125Copyhello.
wartotheas-install/domains/domain1/autodeploy/directory.
Tip–OnWindows,youcancreateashortcuttotheautodeploydirectoryonyourdesktop,andthendraganddropthehello.
warfileontotheshortcut.
Whentheserverhasfinisheddeployingtheapplication,itcreatesafilenamedhello.
war_deployedintheautodeploydirectory.
Dependingonthespeedofyoursystem,theprocesscantakeafewseconds.
Untilthatfileappears,a404-FileNotFounderroroccurswhenyoutrytovisittheapplicationpage.
AccessthisURLtovisittheapplicationpage:http://localhost:4848/hello.
Youseetheapplication'sfirstpage,whichpromptsyoutofillinyourname:TypeyournameandclickSubmit.
Theapplicationdisplaysacustomizedresponse,givingyouapersonalHello.
ToDeploytheHelloApplicationUsingAdminConsoleOpenhttp://localhost:4848/asadmininawebbrowser.
localhostisusediftheboththebrowserandtheApplicationServerarerunningonthesamesystem.
IftheApplicationServerisrunningonanothersystem,substitutethenameofthatsystemintheURL.
4848istheAdminConsole'sdefaultportnumber.
Ifyouchangedtheportnumberduringtheinstallation,usethatnumberinstead.
Entertheadminusernameandpassword.
23412DeployingaSampleWebApplicationSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200826Intheleftpane,clicktheApplicationsnodetoexpandit.
ClickWebApplications.
Youcanseethelistofdeployedwebapplications,ifany.
IfyoualreadyhaveaHelloapplicationdeployed,undeployitnowbyselectingthecheckboxnexttoitandclickingUndeploy.
ClickDeploy.
YoucanusetheHelloapplicationbundledwiththeApplicationServeroryouuploadthesampleyouhavedownloadedfromhttp://glasfish.
dev.
java.
net/downloads/quickstart/hello.
war.
Dooneofthefollowing:SelecttheoptioncalledLocalpackagedfileordirectorythatisaccessibletoApplicationServerandclickBrowseFiles.
Navigatetotheas-install/samples/quickstartdirectoryandselecthello.
war.
IfyouhavedownloadedtheHelloapplicationSelectthePackagefiletouploadtotheApplicationServeroptionandclickBrowse.
Navigatetothedirectorytowhichyouhavedownloadedtheapplication.
ClickOK.
TheapplicationappearsintheWebApplicationslist.
Toverifythatitwasdeployedproperly,intheWebApplicationspage,selecttheHelloapplicationandclickLaunch.
DeployingApplicationsUsingCLICommandsYoucandeployapplicationsusingtheasadmindeploycommand.
Seedeploy(1)intheSunJavaSystemApplicationServer9.
1ReferenceManual.
Youcanalsousetheasantcommandsfordeployment.
Fordetailedinformationondeployingapplicationssee"DeployingModulesandApplications"inSunJavaSystemApplicationServer9.
1ApplicationDeploymentGuide.
345678910MoreInformationDeployingaSampleWebApplicationChapter3DeployinganApplication27DeployingtheSampleEnterpriseApplicationtoaClusterTheseproceduresassumethatyouarerunningadomainwithclusterprofile.
Theproceduresinthischapterassumethatyouhavealreadycreatedaclustercalledcluster1,asdescribedinChapter2,"SettingUpaCluster.
"Thissampleapplicationisprovidedtodemonstratetheclusteringcapabilitiesusingsessioninformation.
Onehastoexercisecautionforuseinproduction.
ToDeploytheSampleEnterpriseApplicationUsingAdminConsoleClicktheHomebuttonorclickCommonTasksontheleftpanetogototheCommonTaskspage,ifyouarenottherealready.
Ontherightpane,underCommonTasks,clickDeployEnterpriseApplication(.
ear).
Ifapplicationserverisinstalledonyourlocalmachine,clickBrowseinthePackagedFiletoUploadtextbox,andnavigatetoas-install/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.
ear.
IfyouareaccessingAdminConsoleremotelywithapplicationserverinstalledonanothermachine,clickBrowseintheLocalpackagedfileordirectorythatisaccessiblefromtheApplicationServertextbox.
Navigatetoas-install/samples/quickstart/clusterjsp/clusterjsp.
ear.
IntheTargetssectionofthepage,selectcluster1fromtheAvailablelist,andclickAddtomoveittotheSelectedlist.
ClickOK.
Theclusterjspapplicationisnowdeployedtocluster1.
Beforeyoulaunchthisapplication,youneedtostarttheinstancesinthecluster.
See"ToStarttheInstancesinaCluster"onpage29DeployingApplicationsUsingCLICommandsYoucandeployapplicationsusingtheasadmindeploycommand.
Seedeploy(1)intheSunJavaSystemApplicationServer9.
1ReferenceManual.
Youcanalsousetheasantcommandsfordeployment.
Fordetailedinformationondeployingapplicationssee"DeployingModulesandApplications"inSunJavaSystemApplicationServer9.
1ApplicationDeploymentGuide.
12345MoreInformationDeployingtheSampleEnterpriseApplicationtoaClusterSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200828ToStarttheInstancesinaClusterBeforeyoulaunchthedeployedapplication,youneedtostarttheinstancesinthecluster.
Inthetreeontheleftpane,clickClusters,andclickthecluster1node.
Intherightpane,navigatetotheGeneraltabifitisnotalreadyactive.
Iftheinstancesarenotalreadyrunning,theStartInstancesbuttonisactive.
Clickittostartthecluster'sinstances.
VerifythattheyhavestartedbycheckingtheStatusfield,whichindicateshowmanyinstancesarerunning.
Youarenowreadytolaunchtheapplication.
See"ToStarttheInstancesinaCluster"onpage29StartingInstancesUsingCLICommandYoucanstartinstancesbyusingtheasadminstart-intancecommand.
SeeintheSunJavaSystemApplicationServer9.
1ReferenceManual.
ToVerifyApplicationDeploymentTypethefollowingURLinyourbrowser:http://localhost:port/clusterjspReplacethelocalhostvariablewiththenameofthesystemthattheDomainAdminServerisrunningon.
ReplacetheportvariablewiththevalueofHTTP-LISTENER-PORTforinstance1.
Thisexampleuseshttp://localhost:38081/clusterjsp.
Addsomesessionattributedata.
ExaminetheSessionandHostinformationdisplayed.
Forexample:ExecutedFromServer:localhostServerPortNumber:38081ExecutedServerIPAddress:198.
19.
255.
255SessionCreated:TueAug2315:26:07PDT2005AddsomesessiondataandclicktheAddtoSessionbutton.
1234MoreInformation1234DeployingtheSampleEnterpriseApplicationtoaClusterChapter3DeployinganApplication29Repeatthisprocedureforinstanceinstance2bytypingthisURLinyourbrowser:http://localhost:38080/clusterjspCongratulations!
YouhavecompletedthissectionoftheQuickStartGuide.
YoucanstoptheQuickStarttrailhereifyoudonotwishtoproceedtothestepsonloadbalancing.
5NextStepsDeployingtheSampleEnterpriseApplicationtoaClusterSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200830WorkingwithLoadBalancersThissectionprovidesinstructionsonhowtosetuptheWebServersoftwaretoactasaloadbalancertotheclusterofApplicationServers.
Inaddition,itprovidesstepsforconfiguringaloadbalancerandexportingittotheWebServer.
Theloadbalancerfeatureisavailabletoyouonlyifyouarerunningadomainwithenterpriseprofileorclusterprofile.
Aloadbalancerisdeployedwithacluster.
Aloadbalancerprovidesthefollowingfeatures:Allowsanapplicationorservicetobescaledhorizontallyacrossmultiplephysical(orlogical)hostsyetstillpresentstheuserwithasingleURLInsulatestheuserfromhostfailuresorservercrashes,whenitisusedwithsessionpersistence.
EnhancessecuritybyhidingtheinternalnetworkfromtheuserApplicationServerincludesloadbalancingplug-insforpopularwebserverssuchasSunJavaTMSystemWebServer,Apache,andMicrosoftWindowsIIS.
Tocompletethissection,youmusthavesufficientmemorytorunaWebServeronyoursysteminadditiontotheDomainAdministrationServerandthetwoApplicationServerinstancesyouhavecreatedsofarinthisguide.
Asystemwith512Mbytesto1024Mbytesofmemoryisrecommended.
Thistopicpresentsthefollowingsteps:"SettingupLoadBalancing"onpage32"StartingLoadBalancing"onpage33"VerifyingLoadBalancing"onpage33"HighAvailabilityandFailoverUsingtheIn-memoryReplicationFeature"onpage344CHAPTER431SettingupLoadBalancingBeforeyousetuploadbalancing,youneedtoinstalltheloadbalancerplug-in.
Forinstructionsoninstallingtheloadbalancingplugin,see"ToInstalltheLoadBalancingPlug-in(standalone)"inSunJavaSystemApplicationServer9.
1InstallationGuide.
Theseproceduresassumeyouarerunningadomainwithclusterorenterpriseprofile.
ToSetUpLoadBalancingCreatealoadbalancerusingtheAdminConsole.
Alternatively,youcanusetheasadmincreate-http-lb(1)command.
a.
ClicktheHTTPLoadBalancersnodeintheAdminConsole.
b.
ClickNew.
c.
Typelb1asthenameoftheloadbalancer,thehostonwhichWebServerisinstalled,andtheWebServerinstanceport.
InthissamplescenariosWebServerhostislocalhostandtheportis38000.
d.
SelecttheApplyChangesAutomaticallycheckbox.
Ifyouchoosethisoption,youdonothavetoexporttheloadbalancerconfiguration.
Allchangesyoumaketotheloadbalancerconfigurationarepropagatedautomatically.
e.
Selectcluster1astarget.
"CreatingaCluster"onpage21explainshowtocreateasamplecluster(cluster1)f.
ClickSave.
Enablecluster1forloadbalancing:asadminenable-http-lb-servercluster1Enabletheclusterjspapplicationforloadbalancing:asadminenable-http-lb-applicationclusterjsp.
Forinformationonadvancedtopics,suchaschangingtheloadbalancerconfigurationorcreatinghealthcheckers,seetheChapter5,"ConfiguringHTTPLoadBalancing,"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuide.
123SeeAlsoSettingupLoadBalancingSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200832StartingLoadBalancingStartloadbalancingbystartingorrestartingtheWebServer.
IftheWebServerinstanceservingasloadbalancerisnotalreadyrunning,starttheWebServer.
IfyouareusingWebServer7.
0,usethewadmstart-instancecommand.
ForWebServer6.
1,runthestartscriptinthedirectory.
IftheWebServerinstanceservingasloadbalancerisalreadyrunning,stoptheWebServerandrestart.
ForWebServer6.
1,usethestopprograminweb_server_install_dir/https-hostnameandrestarttheserverbyrunningthestartprogram.
ForWebServer7.
0,usethewadmstop-instancefollowedbythewadmstart-instancecommand.
VerifyingLoadBalancingOncetheapplicationisdeployedandtheloadbalancerisrunning,verifythattheloadbalancingisworking.
ToVerifyLoadBalancingTodisplaythefirstpageoftheclusterjspapplication,typethisURLinyourbrowser:http://localhost:web_server_port/clusterjspReplacethelocalhostvariablewiththenameofthesystemthattheWebServerisrunningon.
Replacetheweb_server_portvariablewiththevalueoftheportattributeoftheLSelementinweb_server_install_dir/https-hostname/config/server.
xml.
Forthisexample,port38000isused.
Apagesimilartowhatyousawin"ToVerifyApplicationDeployment"onpage29.
appears.
ExaminetheSessionandHostinformationdisplayed.
Forexample:ExecutedFromServer:localhostServerPortNumber:38000ExecutedServerIPAddress:192.
18.
145.
133SessionCreated:DayMon0514:55:34PDT2005TheServerPortNumberis38000,theWebServer'sport.
Theloadbalancerhasforwardedtherequestonthetwoinstancesinthecluster.
123VerifyingLoadBalancingChapter4WorkingwithLoadBalancers33Usingdifferentbrowsersoftware,orabrowseronadifferentmachine,createanewsession.
Requestsfromthesamebrowserare"sticky"andgotothesameinstance.
Thesesessionsshouldbedistributedtothetwoinstancesinthecluster.
Youcanverifythisbylookingattheserveraccesslogfileslocatedhere:SolarisJavaEnterpriseSysteminstallation:/var/opt/SUNWappserver/nodeagents/nodeagent_name/instance1/logs/access/server_access_log/var/opt/SUNWappserver/nodeagents/nodeagent_name/instance2/logs/access/server_access_logLinuxJavaEnterpriseSysteminstallation:/var/opt/sun/appserver/nodeagents/nodeagent_name/instance1/logs/access/server_access_log/var/opt/sun/appserver/nodeagents/nodeagent_name/instance2/logs/access/server_access_logWindowsJavaEnterpriseSysteminstallation:as-install\nodeagents\nodeagent_name\instance1\logs\access\server_access_logas-install\nodeagents\nodeagent_name\instance1\logs\access\server_access_logStand-aloneApplicationServerinstallations:as-install/nodeagents/nodeagent_name/instance1/logs/access/server_access_logas-install/nodeagents/nodeagent_name/instance2/logs/access/server_access_logAddanameandvaluepair(Name=NameValue=Duke)forstoringinHttpSession.
ClicktheAddtoSessionDatabutton.
VerifythatthesessiondatawasaddedHighAvailabilityandFailoverUsingtheIn-memoryReplicationFeatureGlassFishv2doesnotofferHADB.
Forhighavailabilityandfailover,GlassFishoffersthein-memoryreplicationfeature.
Thefollowingprocedureillustratesthisfeature:1.
Restartthewebserverthathastheloadbalancerplugininstalledbeforedeployinganapplication.
Thisensuresthatrequestsareservedbyinstancesintheordersetintheloadbalancer.
xmlfile.
Ifyouusetheloadbalancer.
xmlfileprovidedinthischapter,instance1servesthefirstrequest.
4567HighAvailabilityandFailoverUsingtheIn-memoryReplicationFeatureSunJavaSystemApplicationServer9.
1QuickStartGuideNovember2008342.
Youhavealreadydeployedtheclusterjspwebapplication,whichstoressessiondata.
Youshouldbeabletoseethatsuccessiverequestsareservedbythesameinstancethatservedthefirstrequestandthesessiondataismaintainedacrosstherequests.
3.
Sendfewrequestsandnotedowntheinstancethatservedthoserequestsandshutdownthatparticularinstance.
Usethiscommandtostoptheinstance:asadminstop-instance--useradminuser--passwordadminpasswordinstance14.
Sendinthenextrequestandverifythatthenewdataisstoredandthatthepreviouslyaddeddataisstillthereinthesession.
Ifoneoftheserverservingrequestsisnotavailable,anotherserverinthesameclustertakesovertherequestwithallearliersessiondataandcompletestherequest.
HighAvailabilityandFailoverUsingtheIn-memoryReplicationFeatureChapter4WorkingwithLoadBalancers3536SettingUpHighAvailabilityFailoverWiththeconfigurationusedinthepreviouschapter,ifaserverinstancegoesdown,userslosesessionstate.
Thissection,thesecondoftwoadvancedtopics,providesthestepsforinstallingthehigh-availabilitydatabase(HADB),creatingahighlyavailablecluster,andtestingHTTPsessionpersistence.
GlassFishv2doesnotofferHADB.
Forhighavailabilityandfailover,GlassFishoffersthein-memoryreplicationfeature.
Formoreinformation,seeApplicationServersupportsbothHTTPsessionpersistenceandpersistenceforStatefulSessionBeans.
Theproceduresinthischaptercoverhighavailabilityusingin-memoryreplicationorHADB.
ThesestepsassumeyouhavealreadyperformedthestepsintheprevioussectionsofthisQuickStart.
Thestepsarepresentedintheorderthatyoushouldcompletethem.
TousetheHADBfeature,youneedtoberunningadomainwithenterpriseprofile.
Note–Completingtheproceduresinthissectionmayrequireadditionalhardwareresources.
Thistopiccontainsthefollowingsections:"High-availabilityClustersandHADB"onpage38"HADBPreinstallationSteps"onpage38"InstallingHADB"onpage40"StartingHADB"onpage41"ConfiguringaClusterandApplicationforHighAvailability"onpage42"RestartingtheCluster"onpage42"VerifyingHTTPSessionFailover"onpage435CHAPTER537High-availabilityClustersandHADBAhighlyavailabilityclusterinSunJavaSystemApplicationServerintegratesastatereplicationservicewiththeclustersandloadbalancercreatedearlier,enablingfailoverofHTTPsessions.
HttpSessionobjectsandStatefulSessionBeanstateisstoredinHADB,ahigh-availabilitydatabaseforstoringsessionstate.
Thishorizontallyscalablestatemanagementservicecanbemanagedindependentlyoftheapplicationservertier.
Itwasdesignedtosupportupto99.
999%serviceanddataavailabilitywithloadbalancing,failoverandstaterecoverycapabilities.
KeepingstatemanagementresponsibilitiesseparatedfromApplicationServerhassignificantbenefits.
ApplicationServerinstancesspendtheircyclesperformingasascalableandhighperformanceJavaTMPlatform,EnterpriseEdition5(JavaEETM5platform)containersdelegatingstatereplicationtoanexternalhighavailabilitystateservice.
Duetothislooselycoupledarchitecture,applicationserverinstancescanbeeasilyaddedtoordeletedfromacluster.
TheHADBstatereplicationservicecanbeindependentlyscaledforoptimumavailabilityandperformance.
Whenanapplicationserverinstancealsoperformsreplication,theperformanceofJ2EEapplicationscansufferandcanbesubjecttolongergarbagecollectionpauses.
BecauseeachHADBnoderequires512Mbytesofmemory,youneed1GbyteofmemorytoruntwoHADBnodesonthesamemachine.
Ifyouhavelessmemory,setupeachnodeonadifferentmachine.
Runningatwo-nodedatabaseononlyonehostisnotrecommendedfordeploymentsinceitisnotfaulttolerant.
HADBPreinstallationStepsThisprocedurecoversthemostcommonpreinstallationtasks.
Forinformationonotherpreinstallationtopics,includingprerequisitesforinstallingHADB,configuringnetworkredundancy,andfilesystemsupport,seeChapter2,"InstallingandSettingUpHighAvailabilityDatabase,"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuide.
TherecommendedsystemconfigurationvaluesinthissectionaresufficientforrunninguptosixHADBnodesanddonottakeintoconsiderationotherapplicationsonthesystemthatalsousesharedmemory.
High-availabilityClustersandHADBSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200838ToConfigureYourSystemforHADBGetrootaccess.
DefinevariablesrelatedtosharedmemoryandsemaphoresOnSolaris:a.
Addtheselinestothe/etc/systemfile(oriftheselinesareinthefileascomments,uncommentthemandmakesurethatthevaluesmatchthese):setshmsys:shminfo_shmmax=0x80000000setshmsys:shminfo_shmseg=36setsemsys:seminfo_semmnu=600Setshminfo_shmmaxtothetotalmemoryinyoursystem(inhexadecimalnotationthevalue0x80000000shownisfor2Gigabytesofmemory).
Iftheseminfo_*variablesarealreadydefined,incrementthembytheamountsshown.
Thedefaultvaluesforseminfo_semmniandseminfo_semmnsdonotneedtobechanged.
Thevariableshminfo_shmegisobsoleteafterSolaris8.
b.
Reboot,usingthiscommand:sync;sync;rebootOnLinux:a.
Addtheselinestothe/etc/sysctl.
conffile(oriftheyareinthefileascomments,uncommentthem).
Setthevaluetotheamountphysicalmemoryonthemachine.
Specifythevalueasadecimalnumberofbytes.
Forexample,foramachinehaving2GBofphysicalmemory:echo2147483648>/proc/sys/shmmaxecho2147483648>/proc/sys/shmallb.
Reboot,usingthiscommand:sync;sync;rebootOnWindows:Nospecialsystemsettingsareneeded.
12HADBPreinstallationStepsChapter5SettingUpHighAvailabilityFailover39IfyouusedexistingJDKsoftwarewhenyouinstalledastandaloneApplicationServer,checktheJDKversion.
HADBrequiresSunJDK1.
4.
1_03orhigher(forthelatestinformationonJDKversions,seetheSunJavaSystemApplicationServer9.
1ReleaseNotes).
Checktheversioninstalled,andifitisnotdonealready,settheJAVA_HOMEenvironmentvariabletothedirectorywheretheJDKisinstalled.
Ifnecessaryafterthereboot,restartthedomain,WebServer,andnodeagent.
Torestartthedomain,usethecommandasadminstart-domaindomain1.
TorestarttheWebServer,executethestartprograminweb_server_install_dir/https-hostname.
Torestartthenodeagent,usethecommandasadminstart-node-agenthostname.
ReplacethevariablehostnamewiththenameofthehostwheretheApplicationServerisrunning.
InstallingHADBThissectionprovidesthestepsforinstallingthehigh-availabilitydatabase(HADB).
Note–Ifyouplantorunthehigh-availabilitydatabaseontheApplicationServermachine,andifyouinstalledHADBwhenyouinstalledApplicationServer,skipto"StartingHADB"onpage41.
YoucaninstalltheHADBcomponentonthesamemachineasyourApplicationServersystemifyouhave2Gbytesofmemoryand1-2CPUs.
Ifnot,useadditionalhardware.
Forexample:Two1CPUsystemswith512Mbytesto1GbytememoryeachOne1-2CPUsystemwith1Gbytesto2GbytesmemoryToInstallHADBRuntheApplicationServerorJavaEnterpriseSysteminstaller.
ChoosetheoptiontoinstallHADB.
Completetheinstallationonyourhosts.
34123InstallingHADBSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200840StartingHADBThissectiondescribesstartingtheHADBmanagementagentinmostcasesbyrunningthema-initdscript.
Foraproductiondeployment,startthemanagementagentasaservicetoensureitsavailability.
Formoreinformation,see"StartingtheHADBManagementAgent"inSunJavaSystemApplicationServer9.
1HighAvailabilityAdministrationGuide.
IfstartingadatabasewithHADBnodesonseveralhosts,startthemanagementagentoneachhost.
ToStartHADBinaJavaEnterpriseSystemInstallationonSolarisorLinuxChangetothe/etc/init.
ddirectory:cd/etc/init.
dRunthecommandtostarttheagent:.
/ma-initdstartToStartHADBinaJavaEnterpriseSystemInstallationonWindowsHADBisstartedbydefaultwhenSunJavaSystemisconfiguredandrunning.
However,ifyouneedtostartitmanually,followthesesteps:GotoStartSettingsControlPanel,anddoubleclickAdministrativeTools.
DoubleclickServicesshortcut.
SelectHADBMgmtAgentServicefromtheServiceslist.
FromtheActionmenu,selectStart.
121234StartingHADBChapter5SettingUpHighAvailabilityFailover41ToStartHADBinaStand-AloneInstallationonSolarisorLinuxChangetotheHADBbindirectoryintheApplicationServerinstallation:as-install/hadb/4/binRunthecommandtostarttheagent:.
/ma-initdstartToStartHADBinaStand-AloneInstallationonWindowsInaterminalwindow,changetotheHADBbindirectoryintheApplicationServerinstallation:as-install\hadb\4.
x\binThexrepresentsthereleasenumberofHADB.
Runthecommandtostarttheagent:ma-ima.
cfgConfiguringaClusterandApplicationforHighAvailabilityTheFirstClusterclustermustbeconfiguredtouseHADBandhigh-availabilitymustbeenabledfortheclusterjspapplicationbeforeyoucanverifyHTTPsessionpersistence.
Usetheasadminconfigure-ha-clustercommandtoconfigureanexistingclusterforhighavailability.
Formoreinformationonhowtousethiscommand,typeconfigure-ha-cluster--helpattheasadmincommandpromptorseetheconfigure-ha-cluster(1)manpage.
RestartingtheClusterBeforethechangesmadeintheprevioussectiontakeeffect,thecluster'sinstancesmustberestarted.
ToRestarttheClusterIntheAdminConsole,expandtheClustersnode.
ClickFirstCluster.
121212ConfiguringaClusterandApplicationforHighAvailabilitySunJavaSystemApplicationServer9.
1QuickStartGuideNovember200842Intherightpane,clickStopInstances.
Oncetheinstancesarestopped,clickStartInstances.
VerifyingHTTPSessionFailoverThestepsfortestingsessiondatafailoveraresimilarfortestingloadbalancingasdescribedinthetopic"VerifyingLoadBalancing"onpage33.
ThistimeSessionDataispreservedafterfailure.
Failoveristransparenttotheuserbecausethesampleapplicationisconfiguredforautomaticretryafterfailure.
ToVerifyHTTPSessionFailoverTodisplaythefirstpageoftheclusterjspapplication,typethisURLinyourbrowser:http://localhost:web_server_port/clusterjspReplacethelocalhostvariablewiththenameofthesystemthattheWebServerisrunningon.
Replacetheweb_server_portvariablewiththevalueoftheportattributeoftheLSelementinweb_server_install_dir/https-hostname/config/server.
xml.
Forthisexample,port38000isused.
Apagesimilartowhatyousawin"ToVerifyApplicationDeployment"onpage29appears.
ExaminetheSessionandHostinformationdisplayed.
Forexample:ExecutedFromServer:localhostServerPortNumber:38000ExecutedServerIPAddress:192.
18.
145.
133SessionID:41880f618e4593e14fb5d0ac434b1SessionCreated:WedFeb2315:23:18PST2005Viewtheserveraccesslogfilestodeterminewhichapplicationserverinstanceisservingtheapplication.
Thelogfilesarelocatedhere:SolarisJavaEnterpriseSysteminstallation:/var/opt/SUNWappserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log/var/opt/SUNWappserver/nodeagents/nodeagent_name/i2/logs/access/server_access_logLinuxJavaEnterpriseSysteminstallation:/var/opt/sun/appserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log34123VerifyingHTTPSessionFailoverChapter5SettingUpHighAvailabilityFailover43/var/opt/sun/appserver/nodeagents/nodeagent_name/i2/logs/access/server_access_logWindowsJavaEnterpriseSysteminstallation:as-install\nodeagents\nodeagent_name\i1\logs\access\server_access_logas-install\nodeagents\nodeagent_name\i2\logs\access/server_access_logStandaloneApplicationServerinstallations:as-install/nodeagents/nodeagent_name/i1/logs/access/server_access_logas-install/nodeagents/nodeagent_name/i2/logs/access/server_access_logStoptheApplicationServerinstancethatisservingthepage.
a.
IntheAdminConsole,intheleftpane,expandClusters.
b.
ClickFirstCluster.
c.
Intherightpane,clicktheInstancestab.
d.
ClickthecheckboxnexttotheserverinstancethatservedtherequestandclicktheStopbutton.
Reloadtheclusterjspsampleapplicationpage.
ThesessionIDandsessionattributedataisretained.
ChecktheaccesslogoftheotherApplicationServerinstance,andnoticethatitisnowservicingtherequest.
ThestatefailoverfeaturesworkbecausetheHTTPsessionisstoredpersistentlyintheHADB.
InadditiontotheHTTPsessionstate,theApplicationServeralsocanstorethestateofEJBintheHADB.
Congratulations!
YouhavenowcompletedtheQuickStartforApplicationServer.
Inthissection,youhaveinstalled,configured,andstartedHADBandconfiguredaclusterandanapplicationtousehighavailability.
See"WheretoGoNext"onpage20foradditionalinformationonApplicationServer.
456NextStepsVerifyingHTTPSessionFailoverSunJavaSystemApplicationServer9.
1QuickStartGuideNovember200844