MuleOverviewGuideVersion1.6May2008Re-releasedAugust2008withVersion1.6.2Foraquickstart,seepage5ConfidentialTheideascontainedinthispublicationaresubjecttouseanddisclosurerestrictionsassetforthinthelicenseagreement.CopyrightCopyright©2003-2008,MuleSource,Inc.Allrightsreserved.Nopartofthispublicationmaybecopiedordistributed,transmitted,transcribed,storedinaretrievalsystem,ortranslatedintoanyhumanorcomputerlanguage,inanyformorbyanymeans,electronic,mechanical,magnetic,manual,optical,chemicalorotherwise;ordisclosedtothirdpartieswithouttheexpresswrittenpermissionofMuleSource,Inc.DisclaimerInformationinthisdocumentissubjecttochangewithoutnoticeanddoesnotrepresentacommitmentonthepartofMuleSource,Inc.Thesoftwaredescribedinthisdocumentisfurnishedunderalicenseagreementornondisclosureagreement.Thesoftwaremaybeusedorcopiedonlyinaccordancewiththetermsoftheagreement.Itisagainstthelawtocopythesoftwareonanymediumexceptasspecificallyallowedintheagreement.Inaddition,MuleSourceIncmakesnorepresentationorwarrantieseitherexpressorimplied,withrespecttothismanualandaccompanyingsoftwareandspecificallydisclaimanyimpliedwarrantiesofmerchantabilityorfitnessforanyparticularpurpose.Thismanualandaccompanyingsoftwarearesold“asis”andMuleSource,Incwillinnoeventbeliablefordirect,indirect,incidentalorconsequentialdamagesresultingfromanydefect,errororfailuretoperformexceptasexpresslysetforthinthelicenseagreement.TrademarksAllproductnames,otherthanMule,aretrademarksoftheirrespectivecompanies.Partnumber:16en_us2008.5.1MuleOverviewGuide3TableofContentsPreface..............................................5WhoShouldReadThisGuide?...............................5What’stheFastestWayThroughThisGuide?....................5TypographicConventions...................................6MuleTechnicalSupport.....................................6Chapter1IntroductiontoMule....................................7WhatisMule?............................................8UnderstandingtheMessagingFramework.......................9UnderstandingtheMuleArchitecture.........................11AboutSOA..........................................11ProcessingtheData....................................12RoutingMessagesBetweenServiceComponents..............13SeparatingBusinessLogicfromMessaging..................13WiringEverythingTogether.............................15UnderstandingtheLogicalDataFlow.........................16IntegratingMuleintoYourEnvironment.......................19AdministeringMule.......................................21ManagingYourDeploymentswithMuleHQ................21ControllingtheInfrastructurewithMuleGalaxy.............22MonitoringMuleInstancesUsingJMX....................23Summary...............................................23Chapter2GettingStarted.......................................24InstallingMule...........................................24DistributionTypes....................................24InstallationPrerequisites................................25InstallingtheEnterpriseEdition..........................26InstallingtheCommunityEditionorSnapshotRelease.........27SettingUpYourEnvironment...............................274MuleOverviewGuideTableofContentsDistributionContents.....................................29RunningMule...........................................30StartingwiththeExamples..............................30WorkingwithConfigurationFiles.........................30UsingtheCommandPrompt............................30AdditionalSetupforCommunityEditionUsers..............31TestingtheInstallation.................................32SwitchingBetweenCXFandXFire........................32BasicUsage.............................................33CreateaServiceComponent.............................34ConfiguretheService..................................34ConfiguretheMuleModels.............................35ConfiguretheMuleManager............................35ExtendMule.........................................35WhereDoIGoNext?.....................................36AppendixAWhat’sNewinThisRelease.............................37NewFeatures............................................37PremiumJDBCTransport..............................37CXFTransport.......................................38WebSphereMQTransport..............................38WebServiceWrapperComponent........................38ChangedFunctionality.....................................39ExtendedQACertification..............................39FixedIssues..........................................39KnownIssues............................................40AppendixBThird-partySoftware...................................41Glossary............................................46Index...............................................52MuleOverviewGuide5PrefaceTheMuleOverviewGuideintroducesMuleandrelatedproductsfromMuleSource.ItprovidestheconceptualinformationandcontextthateveryonefromdecisionmakerstoprogrammersneedtogetstartedwithplanningandimplementingMule.WhoShouldReadThisGuide?Thisguideisintendedforthefollowingaudiences