humancontent.ie5

ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
SolutionDeploymentDescriptor(SDD)V2.
0PrimerVersion1.
0CommitteeNoteDraft0116May2011WorkProductURIs:Thisversion:http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/cnd01/sdd-primer-v1.
0-cnd01.
doc(Authoritative)http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/cnd01/sdd-primer-v1.
0-cnd01.
htmlhttp://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/cnd01/sdd-primer-v1.
0-cnd01.
pdfPreviousversion:http://docs.
oasis-open.
org/sdd/v1.
0/cd01/sdd-primer-v1.
0-cd01.
doc(Authoritative)http://docs.
oasis-open.
org/sdd/v1.
0/cd01/sdd-primer-v1.
0-cd01.
htmlhttp://docs.
oasis-open.
org/sdd/v1.
0/cd01/sdd-primer-v1.
0-cd01.
pdfLatestversion:http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/sdd-primer-v1.
0.
doc(Authoritative)http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/sdd-primer-v1.
0.
htmlhttp://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/sdd-primer-v1.
0.
pdfTechnicalCommittee:OASISSolutionDeploymentDescriptor(SDD)TCChair:BrentA.
Miller,IBMCorp.
Editor:BrentA.
Miller,IBMCorp.
Relatedwork:Thisnon-standardstrackworkproductreplacesorsupersedes:SolutionDeploymentDescriptor(SDD)PrimerVersion1.
0Thisnon-standardstrackworkproductisrelatedto:[SDD]OASIS,SolutionDeploymentDescriptorSpecificationVersion2.
0,http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-v2.
0.
htmlThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage2of35[Typethedocumenttitle][SDD-Schema]OASIS,SolutionDeploymentDescriptorSpecificationv2.
0,FullSchema,http://docs.
oasis-open.
org/sdd/sdd/v2.
0/csd02/FullSchema/[SDDSP]SolutionDeploymentDescriptor(SDD)Version2.
0StarterProfileVersion1.
0,http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-starter-profile/v1.
0/sdd-starter-profile-v1.
0.
html[SDDEX]SolutionDeploymentDescriptor(SDD)Version2.
0ExamplesVersion1.
0,http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-examples/v1.
0/sdd-examples-v1.
0.
htmlAbstract:Thisnon-standardstrackworkproductprovidesnon-normativeinformationtosupplementtheSolutionDeploymentDescriptor(SDD)specificationandservesasa"gettingstarted"guide.
Status:ThisdocumentwaslastrevisedorapprovedbytheOASISSolutionDeploymentDescriptor(SDD)TContheabovedate.
Thelevelofapprovalisalsolistedabove.
Checkthe"Latestversion"locationnotedaboveforpossiblelaterrevisionsofthisdocument.
TechnicalCommitteemembersshouldsendcommentsonthisspecificationtotheTechnicalCommittee'semaillist.
OthersshouldsendcommentstotheTechnicalCommitteebyusingthe"SendAComment"buttonontheTechnicalCommittee'swebpageathttp://www.
oasis-open.
org/committees/sdd/.
Forinformationonwhetheranypatentshavebeendisclosedthatmaybeessentialtoimplementingthisspecification,andanyoffersofpatentlicensingterms,pleaserefertotheIntellectualPropertyRightssectionoftheTechnicalCommitteewebpage(http://www.
oasis-open.
org/committees/sdd/ipr.
php.
)Citationformat:Whenreferencingthisspecificationthefollowingcitationformatshouldbeused:[SDD-Primer]SolutionDeploymentDescriptor(SDD)V2.
0PrimerVersion1.
0.
16May2011.
OASISCommitteeNoteDraft01.
http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-primer/v1.
0/cnd01/sdd-primer-v1.
0-cnd01.
html.
CopyrightOASIS2011.
AllRightsReserved.
AllcapitalizedtermsinthefollowingtexthavethemeaningsassignedtothemintheOASISIntellectualPropertyRightsPolicy(the"OASISIPRPolicy").
ThefullPolicymaybefoundattheOASISwebsite.
Thisdocumentandtranslationsofitmaybecopiedandfurnishedtoothers,andderivativeworksthatcommentonorotherwiseexplainitorassistinitsimplementationmaybeprepared,copied,published,anddistributed,inwholeorinpart,withoutrestrictionofanykind,providedthattheabovecopyrightnoticeandthissectionareincludedonallsuchcopiesandderivativeworks.
However,thisdocumentitselfmaynotbemodifiedinanyway,includingbyremovingthecopyrightnoticeorreferencestoOASIS,exceptasneededforthepurposeofdevelopinganydocumentordeliverableproducedbyanOASISTechnicalCommittee(inwhichcasetherulesapplicabletocopyrights,assetforthintheOASISIPRPolicy,mustbefollowed)orasrequiredtotranslateitintolanguagesotherthanEnglish.
ThelimitedpermissionsgrantedaboveareperpetualandwillnotberevokedbyOASISoritssuccessorsorassigns.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage3of35[Typethedocumenttitle]TableofContents1Introduction.
41.
1Terminology41.
2GeneralDocumentConventions42WhyUseSDD53GettingStarted74Examples.
94.
1GeneralDeploymentModel.
94.
2SimpleJREExample104.
2.
1PackageDescriptor.
104.
2.
2DeploymentDescriptor114.
3CompositeApplicationExample.
144.
3.
1ReferencedPackageDescriptorsandDeploymentDescriptors154.
3.
2CompositePackageDescriptor244.
3.
3CompositeDeploymentDescriptor255AdditionalConsiderations.
306Conclusion.
32A.
CompleteExamples33B.
Acknowledgements34C.
RevisionHistory.
35ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage4of35[Typethedocumenttitle]1IntroductionThisisanon-normative,expository,non-standardstrackworkproductthatsupplementstheSolutionDeploymentDescriptor(SDD)specification.
ThisdocumentprovidesaquickwaytogetstartedwiththepragmaticsoftheSDD,butitdoesnotreplacethespecificationorschema,whichneedtobeunderstood.
ThisPrimerdescribeswhyandhowtouseSDD,makinguseofexamplesproducedbytheOASISSDDtechnicalcommittee.
ThisversionconcentratesontheuseofSDDforinstallation;inthefuture,newversionsoradditionalmodulesmaybecreatedtodescribeotherusesofSDD,suchasconfigurationandlocalization.
1.
1TerminologyTerminologyinthisdocumentisconsistentwiththeSDDSpecification[SDDSP].
1.
2GeneralDocumentConventionsThisdocumentcontainscross-references.
Suchreferencesappearasthereferencedsectionnumberinsidesquarebrackets,forexample,[4.
5].
Inelectronicversionsofthisspecification,thecross-referencescanactaslinkstothetargetsection.
WithintheXMLsnippets(excerptsfromSDDexamples),schemaelementsandattributesthatserveasidsandreferencesarehighlightedinblueunderscoredtext.
SchemaelementandattributevaluesthatareexpectedtobefoundinSDDprofilesareidentifiedwithreditalictextintheXMLsnippets.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage5of35[Typethedocumenttitle]2WhyUseSDDSolutionDeploymentDescriptor[SDD]providesastandardizedwaytodeclareandexternalizeinformationaboutyoursoftwarepackageanditsdeployment,asillustratedinFigure1,withtheexplanationthatfollows.
Figure1:OverviewofinformationprovidedinanSDDConsidersomesortofsoftwarepackageasillustratedbytheboxinFigure1.
Tosuccessfullydeploythissoftware,informationaboutitisrequired.
ThisinformationisanalogoustowhatmightbeprovidedontheboxforsoftwarepurchasedonaCDorDVD–ittellsyouwhatyouneedtoknowaboutthissoftware.
TheSDDprovidesawaytodescribesuchsoftwareinastandardizedformthatcanbeelectronicallyrecordedandprogrammaticallyprocessed,inadditiontoprovidinginformationusefultohumans.
Packageidentity:thisportionoftheSDDdescribesthenameandsourceofthesoftwareanditslogicalpackagestructure,includingthecontent(executablefiles,licenseagreements,documentationandsoon)thatmakesupthesoftware.
Requirements:thisportionoftheSDDdescribeswhatisnecessaryforthesoftwaretobesuccessfullydeployed,includingrequirementsfordiskspace,CPUcapacity,andotherdeclarationsabouttherequiredstateofthedeploymentenvironment(forexample,otherpre-requisitesoftware,configurationsettingsandsoon).
Packagevariability:thisportionoftheSDDdescribesoptionsfordeployment.
Somepartsofthesoftwaremightnotbeusedineverydeployment.
Forexample,thesoftwarepackagemightcontainsoftwarevariationsfortwodifferentoperatingsystems;theconditionofthedeploymentenvironment(thatis,theactualoperatingsystemtype)determineswhichofthevariationsisusedinaparticulardeployment.
ThesoftwarepackagealsomightcontainoptionalThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage6of35[Typethedocumenttitle]featuresthattheinstallerchoosesatinstallationtime.
Also,differentlanguagesmightbedeployedfordifferentinstallations.
Results:thisportionoftheSDDdescribeswhatwillhappenoncethesoftwareisdeployed(forexample,installationofnewsoftware,updateofexistingsoftware,configurationorlocalizationofexistingsoftware,andsoon)andwhateffectsitwillhaveontheenvironmentonceitisdeployed(forexample,newapplicationsarecreatedorexistingapplicationsareupdated).
Allofthisinformationenablesdeployerstoanalyzeandmakepre-deploymentdecisions.
SDDproducerscanbedevelopers,aggregators,serviceandmaintenancesupportstaffandothers.
SDDconsumerscanincludehumansandtoolsthatperformcomposition,performpre-deploymentplanning,makepre-deploymentdecisionsand/orperformdeploymentoperations.
TheSDDcanbeusedacrossaspectrumfromsimplepackagestocomplexsolutions.
Itenableslifecyclemanagementofsoftware(installation,configuration,localization,fixapplication,update/upgradeanduninstallation)tobemore(ifnotfully)automated.
ThestandardrepresentationprovidedbySDDenablessolutionstobeeasilycomposedfromexistingcomponents.
SDDdoesnotrequirethatyoudiscard,replaceorrewriteallofyourinstallers;SDDprovidesdeclarativemetadataforsoftwarethatcancontinuetobeinstalledbyexistingdeploymentsoftware.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage7of35[Typethedocumenttitle]3GettingStartedSDDisrepresentedasanXMLschema[SDD-Schema].
TheSDDspecification[SDD]providessemanticsandothernormativeandnon-normativeinformation.
AnSDDconsistsoftwomajorparts:thePackageDescriptorandtheDeploymentDescriptor.
Asnotedinthespecification:Thepackagedescriptordefinespackagecontentwhichincludesartifactswhoseprocessingresultsindeploymentofthesoftwarepackage.
Thedeploymentdescriptordefinesmetadataassociatedwiththoseartifacts.
TheSDDpackagedescriptordefinesthepackageidentity,thepackagecontent,andvariousotherattributesofthepackage.
EachSDDconsistsofexactlyonedeploymentdescriptorandonepackagedescriptor.
Thedeploymentdescriptoriswherethetopology,selectability,inputs,requirements,andconditionsofthedeploymentaredescribed.
YoudescribeyoursoftwarebydeclaringthingsaboutitusingXML.
ReferringbacktoFigure1,theinformationyoucandeclareforeachpartillustratedthereincludes:PackageIdentityispartofthePackageDescriptor,andincludesprimarilythePackageIdentityandContentselements.
PackageIdentitycontainsotherelementsandattributesthatnameanddescribethesoftwarepackage(includingitemssuchasversion,human-readabledescriptionsandotheridentifyinginformation).
Contentsincludesthe"files"thatmakeupthepackage,includingtheirpurpose,wheretheycanbefoundandotherinformation,suchasoptionaldigitalsignatures.
RequirementsarecontainedintheDeploymentDescriptor,withinthevarioustypesofcontentelements(InstallableUnit,ConfigurationUnit,LocalizationUnit,CompositeUnitandCompositeInstallable).
TheRequirementselementdescribesresourceconstraintsanddependenciesforinternalcontentelementsthatmustbemet,includingversions,relationships,propertyvalues,capacityconstraintsandconsumptionconstraints.
Dependingonthetypeofcontentelement,thepresenceofrequiredbasesoftwaremightalsobespecified.
TheRequisiteselementallowstheSDDtoincorporateothersoftwarethatcanhelptosatisfysomeoftheserequirementsifthedeploymentenvironmentdoesn'talreadysatisfythem.
PackagevariabilitycanbeaccomplishedwithintheDeploymentDescriptorwiththeSelectableContentelementthatenablesFeaturesandGroupstobeselected,aswellaswiththeConditionconstructthatcanbeappliedtomultipleelementsintheSDDsothatcertainitemscanbe"conditioned"inoroutofscopeforaparticulardeployment.
ResultsarecontainedintheDeploymentDescriptor,withinthevarioustypesofcontentelements.
Dependingonthetypeofcontentelement,theResultingResourceorResultingChangeelementsdescribetheresultsofthedeployment(whathappenstothedeploymentenvironmentasaresultofperformingthedeploymentdescribedbytheSDD).
InadditiontotheconceptsillustratedinFigure1,otheritemscanbedescribedintheSDD:Topology:ThelogicaltopologyofthesolutioncanbeexpressedinanSDD.
TheTopologyelementdescribesalloftheresourcesrelevantfordeployment,includingresourcesthatarerequired,createdormodifiedduringdeployment,aswellastherelationshipsamongtheseresources.
Artifacts:Thesecontentfilesaccomplishthedeploymentoperations.
Artifactfiles(forexample,ZIPfiles,RPMfilesorexecutableinstallationfiles)areprocessedduringdeploymenttoinstall,ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage8of35[Typethedocumenttitle]configure,localizeorperformotherdeploymentoperations.
TheArtifactelementdescribesartifacts,alongwiththeinputsandoutputs,includingsubstitutionvalues,usedwhenprocessingthoseartifacts.
Atomic&compositecontentunits:Atomiccontentunitsdefineartifacts(justdescribed);thethreeatomiccontentunitelementsareInstallableUnit,ConfigurationUnitandLocalizationUnit(thisversionofthePrimerfocusesprimarilyonInstallableUnits).
Atomicunitssufficeformanysimpledeployments;whenmorecomplexsolutionsaredeployed(forexample,whenmultipleSDDsareaggregatedorwhenpackagevariabilityexistsintheformofselectablecontent),compositecontentunitsareused.
ThethreetypesofcompositecontentunitsareCompositeInstallable,CompositeUnitandCompositeLocalizationUnit.
ThisversionofthePrimerfocusesprimarilyonCompositeInstallables.
Variablesandparameters:Variablesprovideawaytoobtainandderivevaluesfromresourcepropertiesandthedeploymentenvironmentandhumandeployers.
ThevariablescanthenbeusedinvariousportionsoftheSDDtoinfluencethedeploymentprocess,includingtheuseofvariablesasinputargumentstoartifacts,andvaluesforresourceconstraints.
Operations:Operationsserveasthe"verbs"fordeploymentdescribedbyanSDD.
Operationsdescribethedeploymentstepsthatareperformed;someoftheoperationsarecreate,updateanduninstall.
ThisversionofthePrimerfocusesprimarilyonthecreateoperationthatisassociatedwithinstallingsoftware.
Displayinformation:AlthoughtheSDDenablesprogrammaticprocessingandautomateddeployment,itisalsoimportanttoincludedescriptiveinformationthathumanscanuse.
Manydeploymentoperationsareinteractive,requiringhumanstomakeselections,confirmoperations,provideinput,andsoon.
ManyelementsthroughouttheSDDsupportdisplayinformationtoprovidehuman-understandabledescriptions;thesedisplayelementsaretranslatabletosupportmultiplelanguages.
TheremainderofthisdocumentusesexamplestoillustrateeachoftheseaspectsoftheSDDandaddressesadditionalconsiderationsforproducingandconsumingusefulSDDs.
ThisversionofthePrimerfocusesonconceptsandpracticesforSDDsthatperforminstallation;futurepublicationsmayexpandthisfocuswithexamplesandconsiderationsforotherSDDoperationssuchasconfigurationandlocalization(theselatteraspectsareintroducedbutaddressedinlessdetailthaninstallation).
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage9of35[Typethedocumenttitle]4ExamplesTofurtherillustratehowtheSDDcanbeused,werefertotheexamplespublishedbytheSDDTC[SDDEX]anddescribethoseexamples,alongwithinformationpertinentforSDDauthorsandconsumers,inthefollowingsections.
4.
1GeneralDeploymentModelBeforeexaminingthedetailsoftheexamples,itisusefultounderstandthegeneraldeploymentmodelthatunderliesSDD;wecallthistheinstallableunit/hostingenvironmentdesignpattern.
ThismodelisillustratedinFigure2anddescribednext.
FIGURE2:INSTALLABLEUNIT/HOSTINGENVIRONMENTDESIGNPATTERNIngeneral,thingsthataredeployedcanfitintotheinstallableunit/hostingenvironmentdesignpattern.
Thatis,asshownintheleftsideofFigure2,aninstallableunitcontainingoneormoreartifactscanbeinstalledintoahostingenvironment.
ThefigurealsoshowstheothermajorportionsofanSDD,namelyadescriptorfortheinstallableunitandapackagewiththeassociatedcontent.
AsshownontherightsideofFigure2,thisdesignpatterncanbeusedatalllevelsoftheresourcestack.
Forexample,anoperatingsysteminstallableunitcanbeinstalledintoahardwarehostingenvironment;asoftwareproduct(suchasanativeapplication)canbeinstalledintoanoperatingsystemhostingenvironment,andsoon.
Thisdesignpatternmakesitpossibletostandardizemanyaspectsofsoftwarethatcoordinatesdeploymentofdiverseresourcetypes,anditunderliesthestandardizationofthedeclarativeThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage10of35[Typethedocumenttitle]metadatafortheinstallableunit,includingartifacts,packagedescriptorsanddeploymentdescriptors,embodiedintheSDDstandard.
Understandingthisdesignpatternfacilitatesunderstandingtheexamples,whichareexplainednext.
4.
2SimpleJREExampleThisexampleisasimpleonethatillustratesabasicPackageDescriptorandcorrespondingDeploymentDescriptorforaJava1runtimeenvironment.
Forthecompleteexample,refertothefilesexamples/CompositeApp/pkgs/JRE/jre.
xmlandexamples/CompositeApp/pkgs/JRE/jre_pkg.
xmlin[SDDEX](seeAppendix[A]).
4.
2.
1PackageDescriptorThissimplePackageDescriptorcontainsIdentityinformation,includingDescription,ShortDescription,Version,BuildInformationandManufacturerinformation.
Allofthisinformationisprovidedbythepackageauthor.
TheIdentityinformationexcerptfromthisexamplefollows.
LetsyoudevelopanddeployJava(TM)applicationsondesktopsandservers,aswellastoday'sEmbeddedandRealtimeenvironments.
JavaSEincludesclassesthatsupportthedevelopmentofJavaWebServicesandprovidesthefoundationforJavaPlatform,EnterpriseEdition(JavaEE).
Java(TM)PlatformforsoftwaredevelopmentJava(TM)Platform,StandardEditionRuntimeEnvironment1.
5.
0OracleCorp.
500OracleParkway,RedwoodShores,CA94065U.
S.
A.
https://support.
oracle.
com/CSP/ui/flash.
htmlThedescriptorLanguageBundleattributespecifiesthatlanguagebundlefilesthatcontaintranslationsfordisplaytextelementsinthisPackageDescriptor(thesedisplaytextelementsincludeDescription,ShortDescriptionandName)arecontainedwithinthisPackageDescriptorandareidentifiedbytherootfilename"com.
oracle.
jave.
jre".
ThepackageContents,describednext,illustrateonelanguageBundlefilethatcorrespondstothisdescriptorLanguageBundlevalue.
1JavaisatrademarkorregisteredtrademarkofOracleCorporationintheUnitedStatesandothercountries.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage11of35[Typethedocumenttitle]TheContentsinthispackageconsistoftheartifact,withtheassignedid"JRE_RPM";alanguagebundledwiththeassignedid"EN_Bundle"andthecorrespondingDeploymentDescriptor(describednext),withtheassignedid"DD".
Theseidsarechosenbythepackageauthorandareusedtoreferencethesecontentfilesfromthedeploymentdescriptor.
Theseandotheridsarehighlightedinblueunderscoredtextinthefollowingexcerpt;theiruseasreferencesisdescribedinthenextsection.
4.
2.
2DeploymentDescriptorThissimpleDeploymentDescriptorisusedwiththeprecedingPackageDescriptor.
ItcontainsinformationrelevanttodeployingtheJREthatisdescribedinthatpackagedescriptor.
ThissimpleDeploymentDescriptorillustratesthedeclarationofTopologyandIdentityforthisdeployment,aswellastheuseofVariablesduringdeploymentoperations(inthiscase,install)andthedeclarationofRequirements(inthiscase,ResourceConstraints)necessaryfordeployment.
ItalsoidentifiestheArtifactusedduringdeployment.
SeveralvaluesinthisDeploymentDescriptoraretakenfromaprofile.
Thesevaluesareidentifiedwithreditalictextintheexampleexcerptsincludedhere.
See[SDDSP]fortheStarterProfilethatillustratesthedefinitionofvaluessuchasthese.
IntheTopologysection,theSDDauthordeclaresaresourceofthetypeCIM_OperatingSystem;thisresourceservesasahostingenvironment(intheinstallableunit/hostingenvironmentdesignpattern),anditstypecomesfromaprofile.
ThisoperatingsystemresourcehostsaresourceofthetypeCIM_FileSystem;thisfilesystemservesastheactualhostingenvironmentfortheJREthatisdeployedwiththisSDD,anditstypealsocomesfromaprofile.
So,thisSDDisdeclaringthattheJRE,whendeployed,willbehostedbythefilesystem(thatinturnishostedbyanoperatingsystem).
Moreover,itisknownthatthisJREisdestinedforanAIX2operatingsystem,soarelevantpropertycalledRoot,withthevalue/usr,isdeclared;thispropertydeclaresthefilesystemwheretheJREwillbeinstalled.
ThesevaluesalsocomefromaprofilethatdefinesrelevantpropertiesfortheAIXoperatingsystem.
Finally,theresourcetobedeployed(theJRE)isitselfdeclared,withthetypeCIM_InstalledProduct,andthatvaluealsocomesfromaprofile.
Notethateachoftheseresourceshasanid(os,UsrFilesysandJRE,respectively)thatisusedtorefertotheseresourceselsewhereintheDeploymentDescriptor.
TheosandUsrFilesysresourcesneedtobedefinedbecauseeachhasanassociatedRequirementdefinedlaterintheDeploymentDescriptor3;theJREresourceneedstobedefinedbecauseitislaterreferredtoasaresultingresource.
TheseTopologyelementsareshowninthefollowingexampleexcerpt.
2AIXisaregisteredtrademarkofIBMintheUnitedStates,othercountries,orboth3Infact,theosandUserFilesysresourceswouldneedtobeincludedinTopologyevenifRequirementswerenotdefinedforthem,becauseoftheirrelationshipstoanotherresource(inthiscase,theJRE)thatisreferredtoelsewhere.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage12of35[Typethedocumenttitle]Thisisthe/USRlogicalfilesystemonAIXRoot/usrBecausethisDeploymentDescriptordescribestheinstallationoftheJRE,itdeclaresanInstallableUnitwhosetargetResourceRefistheoperatingsystemthatwaspreviouslydeclaredwiththeid"os".
ThisinformationtellstheSDDconsumerthattheAIXoperatingsystemiscapableofprocessingtheJREartifactfile.
Inthisexample,thetargetresourceistheoperatingsystem,whereasthehostingenvironmentresourceisthefilesystem.
Inmanycases,thehostingenvironmentalsoservesasthetargetresource.
Theseelementsappearinthefollowingexcerpt.
ThissimpleDeploymentDescriptorhasasingleInstallableUnit.
ThatInstallableUnit'sIdentitysectionhappenstomatchtheIdentityinformationinthecorrespondingPackageDescriptor.
However,theidentityoftheoverallpackage(inthePackageDescriptor)andtheidentityofthecontentunits(suchastheInstallableUnitinthisexample)aredistinctentities.
Inthiscase,theSDDauthorhasdeterminedthatitisconvenientfortheInstallableUnitIdentityandtheoverallpackageIdentitytomatch;thisenablesidentityinformationtobeobtainedfromtheDeploymentDescriptorwithoutopeningthePackageDescriptor.
Notethatthesedistinctidentitiesneednot(andoftendonot)match;see,forexample,thecompositeapplicationexampleinsection[4.
3],whichhasmultipleInstallableUnits).
ThecompleteexamplecontainsthisIdentityinformation,whichissimilartotheIdentityinformationinthePackageDescriptor.
ThisDeploymentDescriptordefinesaVariableoftypeStringParameterthatrepresentstheloggingleveltobeusedwhentheJREisdeployed.
Validanddefaultvaluesforthisparameter(definedinaprofile)aredefined.
Thisparameter'svaluewillbesetusingasubstitution(illustratedanddescribedlater),andtheresultingvaluewillbepassedtotheartifactwhentheartifactisinvokedforprocessing.
ThisVariableisshowninthefollowingexampleexcerpt.
DefaultlogginglevelforloggingmessagescomingfromJREFINESTFINERFINECONFIGSEVEREINFOWARNINGThisDeploymentDescriptordefinesRequirementsthatmustbemetforasuccessfuldeployment.
NotethattheidvaluesfortheRequirementsmustbeuniquewithinthisdeploymentdescriptorThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage13of35[Typethedocumenttitle]andalsomustbeuniqueacrossmultipledeploymentdescriptorsthatareaggregatedtogether.
ThisisillustratedfurtherintheCompositeApplicationexamplelaterinthisdocument.
ThefirstRequirementdeclaresthattheoperatingsystemtypemustbeAIXandthattheminimumversionoftheoperatingsystemis5.
1.
ThisRequirementfurtherdeclaresthatthe"certified",orfullytested,versionsforthisJREspanAIXversion5.
1to5.
3.
ThisexpressestheSDDauthor'sintentthattheoperatingsystemtypemustbeAIXandmustbeatleastversion5.
1;preferredversionsare5.
1to5.
3,soversionsabove5.
3mightbeacceptablebutprobablyshouldbetestedorotherwiseverifiedforthisdeployment.
NotethatsomevaluesforthisRequirementcomefromaprofile.
ThesecondRequirementdeclarestheamountoffreediskspacethatmustbeavailableforasuccessfuldeployment.
Inthiscase,2688512-byteblocks(theunitofmeasureusedfordiskspaceonthisAIXoperatingsystem)mustbeavailable.
NotethatsomevaluesforthisRequirementcomefromaprofile.
TheseRequirementsappearinthefollowingexampleexcerpt.
ThisJRErequiresanAIXOperatingSystemataversionofatleast5.
1.
IthasbeencertifiedforallversionsofAIXbetween5.
1and5.
3ThisJRErequiresaversionofAIXor5.
1orlater.
IthasbeencertifiedonversionsofAIXbetween5.
1and5.
3.
sp:CIM_OperatingSystem.
OSTypeAIX5.
15.
15.
3ThisJRErequires2688512-byteblocksofavailablespaceonthe/usrfilesystemsp:CIM_FileSystem.
AvailableSpace2688ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage14of35[Typethedocumenttitle]TheDeploymentDescriptordeclaresaResultingResourcethatwillresultfromsuccessfuldeployment.
Inthiscase,anewresource,aninstanceoftheJREversion1.
5.
0,willbecreatedinthedeploymentenvironment.
Thisinformationisshowninthefollowingexcerpt.
AninstanceofJava(TM)RuntimeEnvironment,StandardEditionVersion5.
0isinstalledasaresultofthisdeploymentJava(TM)RuntimeEnvironment,StandardEdition1.
5.
0Finally,theDeploymentDescriptordeclarestheArtifactthatisprocessedtoaccomplishtheinstallation.
ThisInstallArtifactelementdefinesmetadataabouttheartifactfile("JRE_RPM",asidentifiedinthecontentRefattribute)thatisusedtocreatetheJRE.
ThisartifactisanRPMfile(atypicaltypeusedbyinstallersintheAIXoperatingsystem),asidentifiedbythetypeattribute.
Theargumentvalueforthelogginglevelinthisexamplecomesfromafile,andthevalueinthefilerequiresasubstitutionbeforeitcanbeusedforartifactprocessing.
ThecontentRefattributespecifiesthefileinwhichthesubstitutionwilltakeplace("LoggingProperties").
Forthesubstitution,therequiredattributeindicatesthattheresultingvaluemustbevalid,andthelimitattributespecifiesthatonlyonesubstitutionshouldoccur(evenifthePatternoccursmorethanonceinthefile).
Patternspecifiesthestringinthefilethatwillbereplaced;Valuespecifiesthevariableexpressionthatisevaluatedtodeterminethetextthatwillreplace(beliterallysubstitutedfor)Patterninthefile.
Inthisexample,"$(LoggingLevel)"indicatesthatthevalueoftheLoggingLevelvariable(previouslydefinedintheSDDanddescribedearlier)isevaluated,andtheresultissubstitutedforthestring"INFO"inthefile.
Thefile(withthesubstitutedvalue)ispassedwiththeartifacttothetargetresourceforusewhenprocessingtheartifact.
Theearlierdeclarationoftheparameterenablescheckingthevaluethatissetagainstvalidvalues(andalsodefinesadefaultvalueincasenovalueissetduringtheinstallationprocess).
Thisinformationappearsinthefollowingexampleexcerpt.
INFO$(LoggingLevel)4.
3CompositeApplicationExampleInthissection,amorecomplexexampleisprovided.
ItisanaggregationofasetofotherSDDsforthedeploymentofthefollowingpackages:a3-tierJ2EEapplicationwithuserinterface,backendbusinesslogicandadatabaseconnection;anoptionalJ2EEsimpleclient(thisclientrequiresaJREruntimewithaminimumThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage15of35[Typethedocumenttitle]version);aJREruntimeofaversionthatsatisfiestheJ2EEsimpleclientrequirement;andsomeoptionalGermanandFrenchlanguagepacksfortheJ2EEsimpleclient.
TheseconstituentSDDsarereferredtoasreferencedpackagesintheaggregatingSDD.
Notethattheindividualconstituentpackagesthemselvesareself-sufficient;thatis,theyarecompleteSDDpackagesandmaybeusedtodeploytheirrespectivecontentindependently,inadditiontobeingusedtodeploytheaggregatedsolutionthatisdescribedinthissection.
Acompositepackagedescriptor-deploymentdescriptorpaircombinestheseconstituentSDDsintoacompositeapplicationSDD.
Forthecompletesetofexamplefilesdescribedthroughoutthissection,refertotheexamples/CompositeAppfolderin[SDDEX](seeAppendix[A]).
4.
3.
1ReferencedPackageDescriptorsandDeploymentDescriptorsThecompletesolutionconsistsofseveralSDDs.
TheCompositePackageDescriptorandDeploymentDescriptorsectionsdescribethecomponentsthatconstitutetheaggregatedSDD.
Inthissection,moredetailsareprovidedfortheindividualreferencedpackages(theonesthatareaggregatedbythecompositeSDD),including:the3-tierJ2EEapplicationpackage;theSimpleJ2EEclient;theJREruntimepackage;andtheGermanandFrenchlanguagepacks.
4.
3.
1.
1J2EEApplicationPackageTheJ2EEapplicationpackage(SC_pkg)hasaPackageDescriptorlocatedinpkgs\Composite\SimpleCompositeApp_pkg.
xmlandaDeploymentDescriptorlocatedinpkgs\Composite\SimpleCompositeApp.
xmlin[SDDEX](seeAppendix[A]).
ThePackageDescriptorforthe3-tierJ2EEapplicationsimplyliststheidentityofthepackageandthecontentscontainedinthepackage.
NotethatthecontentslistedintheContentsectionareofdifferenttypes;hence,theirdeploymentprocessingwilldifferasdescribedinthecorrespondingDeploymentDescriptor(forexample,theJ2EEclientcontenthasadifferentfiletypeandformatthanthedatabasecontent,sotheirrespectiveinstallableunitprocessingvaries).
TheDeploymentDescriptorfirstdescribesaTopologywithnestedresourcesforthecomponentstobeinstalled.
Therearethreetop-levelresourcesdescribedwithResourceelements.
ThefirstisJ2eeServletServer,oftypeCIM_J2eeServer,hostinghostedresourceSimpleJ2eeServlet,oftypeCIM_J2eeServlet.
Thesecondtop-levelresourceisappServer_os,oftypeCIM_OperatingSystem,andithostsresourceJ2eeAppServer,oftypeCIM_J2eeSever,whichinturnhostsresourceSimpleJ2eeApp,oftypeCIM_J2eeApplication.
Thethirdtop-levelresourceisos,oftypeCIM_OperatingSystem,andithostsresourceDatabaseServer,oftypeCIM_DatabaseServer,whichinturnhostsresourceSimpleDatabase,oftypeCIM_CommonDatabase.
NotethatdeclaringappServer_osandosasseparateresourcesdoesnotimplythattheyareseparateoperatingsystems(orseparatehardwarehosts),butratherallowsfordistributeddeployment–forexample,J2eeAppServerandDatabaseServercouldresideonseparateoperatingsysteminstances.
If,instead,J2eeAppServerandDatabaseServerwerebothhostedbythesamehostingresourceoftypeCIM_OperatingSystem,thenitwouldbeimpliedthattheybothresideontheThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage16of35[Typethedocumenttitle]sameoperatingsysteminstance(andhardwarehost).
Asshownlaterinthedeploymentdescriptor,theJ2eeServletServer,J2eeAppServerandDatabaseServerareusedintheRequirementssectionstodeclarerequirementsforthedeployment.
TheSimpleJ2eeServlet,SimpleJ2eeAppandSimpleDatabaseareusedtodeclaretheresultingresourcesforthisSDD,andtheJ2eeAppServer,SimpleJ2eeApp,DatabaseServerandSimpleDatabaseareusedtodeclaretheresourcerelationships.
TheDeploymentDescriptordefinestheInstallableUnitsassociatedwiththiscomponentofthecompositeapplicationandspecifiestheirdifferentdeploymentcharacteristicsbasedonRequirements.
TheInstallableUnitsarecombinedinCompositeInstallable.
NotetheParameterselementwithintheVariableselement:itdeclarestwoinputparametersthatapplytotheentireCompositeInstallable:JDBC_UserandJDBC_Password.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage17of35[Typethedocumenttitle]EachindividualconstituentInstallableUnitfollowsthepatternalreadydescribedintheSimpleJREexample.
Forexample,thereisanInstallableUnitcalledSimpleJ2EEServletUnit.
ThiscomponentispackagedintoaWebarchive(war)format.
TheRequirementselementintheInstallableUnitdefinesthepre-requisiteforthiscomponentbyusingtheResourceConstraintandRelationshipConstraint.
TheResourceConstraintintheexamplespecifiesthattheservletpackagemustbedeployedwithanApacheTomcatserverpre-installedandtheversionofApacheTomcatmustbe5.
5.
20.
TherequirementsectionalsospecifiesaRelationshipConstraintthatspecifiesthattheremustbeaJ2EEapplicationserverrunningtheRMI-IIOPprotocol.
OncetherequirementfortheInstallableUnitismet,thefilesspecifiedintheInstallArtifactelementcanbedeployed.
Inthiscase,thewarfileasspecifiedintheSC_WARreferenceisdeployedastheServletunit.
ThisInstallableUnitanditsRequirementsareshowninthefollowingexampleexcerpt.
AnadditionalconceptnotillustratedintheSimpleJREexampleisshownhere:theInstallArtifacthasaweightattribute.
OneoftheobjectivesoftheSDDistoenableinformationtobeincludedthatcanbeusedbyruntimestomonitoranddisplaytheprogressofdeploymentoperations.
Mechanismsforprogresstrackingcouldvarywidelyandresultsinvariousenvironmentsalsoarelikelytodiffer.
Inaddition,includingpreciseinformationaboutdeploymenttimesinanSDDisimpractical,especiallybecausemultiplepackagesfrommultiplesourcescanbeaggregatedandtheprocessingofanSDDcanvaryfromdeploymenttodeployment(basedonconditions,features,characteristicsofthedeploymentenvironmentandsoon).
Nevertheless,theSDDspecificationdoesincludeweightattributesforArtifactsandReferencedPackages;theseweightsarerelativetimesthatSDDauthorscanspecifyandSDDconsumerscanuseforestimationandcoarsedeploymentprogressexpectationsandtracking.
ThekeytotheuseofweightintheSDDistounderstandthattheweightforaparticularArtifactorReferencedPackageisanestimateofthetimerequiredtoprocessthatartifactorpackagerelativetootherartifactsandpackageswithinthatSDD.
Weightsarenotabsolute,theyarenotpercentagesandtheydonotapplyacrossSDDs,onlywithinasingleSDD.
Inthisexample,theSimpleJ2eeServletUnit'sArtifacthasaweightvalueof2,asshowninthefollowingexampleexcerpt.
InthecompleteSimpleCompositeAppexample,theotherInstallableUnitsalsohaveweightvalues:theSimpleJ2eeAppUnit'sArtifacthasaweightvalueof3;theOracleSimpleDatabaseUnit'sArtifacthasaweightvalueof4;andtheDB2SimpleDatabaseUnit'sArtifacthasaweightvalueof4.
So,inthisexample,theexpectationisthattheSimpleJ2eeAppUnitArtifact(weight=3)willtakeapproximately1.
5timesaslongtoprocessastheSimpleJ2eeServletUnitArtifact(weight=2);andeitherdatabaseInstallableUnitArtifact(bothweight=4)willtakeapproximatelytwiceaslongtoprocessastheSimpleJ2eeServletUnitArtifact(weight=2).
(Similarly,eitherdatabaseInstallableUnitArtifact(bothweight=4)isexpectedtotakeapproximately1.
3timesaslongtoprocessastheSimpleJ2eeAppUnitArtifact(weight=3)).
Theweightvalueshavenomeaninginisolationanddonotdescribeactualtimeelapsed.
Theysimplyprovideanestimate,orhint,ofrelativetime.
TheuserinterfacefortheSimpleCompositeApplication.
SimpleApplicationServlets1.
0ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage18of35[Typethedocumenttitle]ApacheTomcat5.
5.
20ProtocolRMI-IIOPSimpleApplicationServletProtocolRMI-IIOPOtherInstallableUnitsintheJ2EEApplicationpackagefollowpatternssimilartotheprecedingexample.
Notethattherearetwoinstallableunitsfordatabaseinstallationthathavethesameresultingresourcereference:SimpleDatabase.
Thesetwoinstallableunits,however,havedifferentconditions–thefirstrequiresdatabaseserverOracle4andthesecondrequiresdatabaseserverDB25.
Therefore,onlyoneofthesetwounitswillbeprocessedduringaparticulardeployment,resultinginonlyoneSimpleDatabaseresultingresource.
TheJ2EEapplicationalsoillustratestheConditionconstruct,whichisusefultoenableflexibleprocessingwithinanSDDbydeclaringwhichaspectsofanSDDareapplicable(orcanbeignored)incertaincircumstances.
ConditionscanbeappliedtoContent(todetermineifacontentelementisapplicable),Variables(tochoosevalues),Features(todeterminewhenafeatureisapplicable),ResultingResources(todeterminewhenaparticularresultisapplicable)andCompletionActions(todetermineifaparticularcompletionactionisnecessary).
TheJ2EEexampleillustratesoneuseoftheConditionelementtoprovidecontentfordifferentdeploymentenvironments.
Inthisexample,theSDDdescribessomecontent(aCompositeInstallableUnitfortheoverallJ2EEapplication)thatconsistsofsoftwarethatiscommontoalldeployments,plussome4OracleisaregisteredtrademarkofOracleCorporationand/oritsaffiliates.
5DB2isaregisteredtrademarkofIBMCorporationintheUnitedStates.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage19of35[Typethedocumenttitle]contentthatvaries.
Thevariablecontentisthedatabaseforthe3-tierapplication,anditisbasedonaCondition.
Thedatabaseforthe3-tierapplicationcanbeeitheranOracle9iASdatabaseoranIBM6DB29database.
ThisDeploymentDescriptordescribesanInstallableUnitthatconsistsofanOracledatabase.
TheConditionchecksDatabaseServerforthevalue"Oracle9iAS",andiftheconditionismet,theSDDspecifiesadditionalinformationthatappliesfortheOracledatabase(inthiscase,Oracledatabase-specificRequirementsinadditiontothosespecifiedforthecommoncontent,aswellastheparticularOracledatabaseResultingResourceandArtifact).
TheSDDthendescribesanotherInstallableUnitthatconsistsofaDB2database.
TheConditionchecksDatabaseServerforthevalue"DB29",andiftheconditionismet,theSDDspecifiesadditionalinformationthatappliesfortheDB2database(inthiscase,DB2database-specificRequirementsinadditiontothosespecifiedforthecommoncontent,aswellastheparticularDB2databaseResultingResourceandArtifact).
TheseConditionsareshowninthefollowingexampleexcerpt.
TheRDBMSDatabasestructurefortheSimpleCompositeApplication.
SimpleApplicationDatabase1.
0Oracle9iAS[.
.
.
][Oracledatabase-specificRequirements,ResultingResource,ArtifactandInstallableUnit]TheRDBMSDatabasestructurefortheSimpleCompositeApplication.
SimpleApplicationDatabase1.
0DB29[.
.
.
][DB2database-specificRequirements,ResultingResource,ArtifactandInstallableUnit]ThisexampleillustratesconditionalContent;ConditionsalsocanbeappliedtootherelementswithintheSDD(Variables,Features,ResultingResourcesandCompletionActions).
6IBMisaregisteredtrademarkofIBMCorporationintheUnitedStates.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage20of35[Typethedocumenttitle]4.
3.
1.
2J2EEClientThesecondreferencedpackageisasimpleclientapplicationwithPackageDescriptorlocatedinpkgs\Client\SimpleAppClient_pkg.
xmlandDeploymentDescriptorlocatedinpkgs\Client\SimpleAppClient.
xmlin[SDDEX](seeAppendix[A]).
ThePackageDescriptorfortheapplicationclientisrelativelysimpleandsimilartopreviouslydescribedPackageDescriptors.
ThisPackageDescriptorcontainsajarfilefortheinstallerandaseparateonefortheuninstaller.
TheDeploymentDescriptorcontainsseveralkeyelementsthatarecriticalfordeployingthissimpleclient.
ThefirstistheTopologysection.
Threetop-levelresourcesaredescribedwithResourceelements.
ThefirstisJRE,oftypesp:CIM_InstalledProduct.
ThesecondisFilesys,oftypesp:CIM_FileSystemandithostsresourceInstallDir,oftypesp:CIM_Directory;thenameofthisdirectoryisthevalueoftheInstallLocationvariable.
Thethirdtop-levelresourceisSimpleAppClient,oftypesp:CIM_Application.
Asshownlaterinthedeploymentdescriptor,theJREandFilesysareusedintheRequirementssectiontodeclaretherequirementsforthedeployment.
TheSimpleAppClientandInstallDirareusedtodeclaretheresultingresourcesforthisSDD.
$(InstallLocation)IntheRequirementssection,therearethreerequirementsthatmustbemettodeploythispackage.
Theserequirementsincludeanoperatingsystemrequirement,aJavaRuntimerequirementandadiskspacerequirement.
TheoperatingsystemrequirementusesanAlternativeelementtospecifythatthepackagecanbedeployedeithertoanAIXoperatingsystemwithversion5.
3ortoaWindows7operatingsystemwithaversionhigherthan5.
1.
2600.
TheOperatingSystemtypeusedhereisanOSTypeoftheCIM_OperatingSystemclassdefinedintheStarterProfile[SDDSP].
TheJRErequirementspecifiesthattheminimumsupportedversionofJREis1.
4.
1.
Thediskspacerequirementspecifiesthattheminimumavailablediskspaceis2000blocksatthesizeof512bytesperblock.
TheelementthatspecifiesdiskspaceisConsumptionConstraintwithapropertydefinedasAvailableSpaceforaCIM_FileSystemclass.
TheseRequirementsforthesimpleclientareshowninthefollowingexampleexcerpt.
Thisisalocalclientinterfaceforthesimpleapplication.
SimpleApplicationClient1.
07WindowsisaregisteredtrademarkofMicrosoftCorporationintheUnitedStatesandothercountries.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage21of35[Typethedocumenttitle]IBMCorporation1133WestchesterAvenueWhitePlains,NewYork10604U.
S.
A.
file:///C:/DocumentsandSettings/Administrator/LocalSettings/TemporaryInternetFiles/Content.
IE5/SPWFOVCB/C__FY2007_standard_Examples_examples_COMPOS~1_pkgs_Client_SIMPLE~1%5b1%5d.
XML-#RootofthedirectoryintowhichSimpleApplicationshouldbeinstalledInstalllocationforSimpleApplicationClientSimpleApplicationClientissupportedonAIXV5.
3andWindowsXPProfessionalRequirementsonAIXsp:CIM_OperatingSystem.
OSTypeAIX5.
35.
4RequirementsonWindowsXPsp:CIM_OperatingSystem.
OSTypeWindowsXP5.
1.
2600ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage22of35[Typethedocumenttitle]TheinstallationofSimpleApplicationClientrequirestheaJ2SEversion1.
4.
1orlaterJava(TM)RuntimeEnvironment,StandardEdition1.
4.
1TheinstallationofSimpleApplicationClientrequires2000512-Bytesofavailablespaceinthefilesystemwheretheapplicationisinstalled.
sp:CIM_FileSystem.
AvailableSpace2000NotetheVariablessection.
Itdeclaresaninputparameter,InstalledLocation,fortheJ2EEClientdeploymentdescriptor.
TheinputparameterisdeclaredasURIParameter,whichimplicitlydeclaresthevaluetobeavalidUniformResourceIdentifier.
RootofthedirectoryintowhichSimpleApplicationshouldbeinstalledInstalllocationforSimpleApplicationClientNotetheRelationshipConstraintelement.
ItdefinesarelationshipbetweentworesourceswithinthescopeofaResourceConstraint.
ThefirstresourceisdeclaredwiththeresourceRefattributeoftheResourceConstraint;thesecondisdeclaredwithrelatedResourceRefintheRelationshipConstraint.
TherelationshipisdeclaredwiththetypeattributeoftheRelationshipConstraint(inthiscase,thetypeis"connects").
ThedeploymentruntimedeterminesthesemanticsassociatedwiththeparticularRelationshipConstraint.
TheRelationshipConstraintisshowninthefollowingexampleexcerpt.
[.
.
.
]ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage23of35[Typethedocumenttitle]ProtocolJDBCThefirstResultingResourceelementdeclaresthatdeploymentoftheJ2EEClientwillresultinaresourcecalledSimpleAppClient,withapropertynamedDirectorywhosevaluewillbeequaltothevalueoftheInstallLocationvariable.
ThesecondResultingResourceelementdeclaresthatdeploymentoftheJ2EEClientwillresultinadirectorytyperesource.
AsspecifiedbytheresourceRefattribute,thisistheinstallationdirectorythatwasalsodeclaredearlierinTopologyasaHostedResource(seethe"Topology"descriptionearlierinthissection).
Together,theTopologyandResultingResourceinformationindicatesthattheInstallDirresourceisaresultingresourcethatishostedbythefilesystemandtakesitsnamefromthevalueoftheInstallLocationvariable.
ThisdirectoryResultingResourceisdeclaredbecauseitisnecessarytobringtheinstallationdirectoryresourceintoscopeandtospecifythatthisinstallationdirectoryis,infact,theonethatwasdeclaredinTopologyanditmustbehostedbythefilesystemthatwasdeclaredinTopology.
TheResultingResourcesareshowninthefollowingexampleexcerpt.
SimpleApplicationClient1.
0Directory$(InstallLocation)Oncetherequirementsaremet,theArtifactselementdefinesthefilesthatneedtobeprocessedforthedeploymentoperation.
BesidesthenormalInstallArtifact,thisexamplealsohasanUninstallArtifactthatdescribeshowtouninstallanexistingsimpleapplicationclient.
Inthisexample,onlytheInstallArtifactisusedinthecontextofthecompositeapplication,becausetheinstalloperationdeclaredbytheCompositeInstallableforthecompositeapplicationeffectively"selects"theInstallArtifactintheSimpleAppClient(theUninstallArtifactmightbeusedinotherdeploymentcontexts).
NotealsothattheSimpleAppClientSDDitselfisaConformanceLevel1(CL1)SDD(ithasnoCompositeInstallable),eventhoughinthecontextofthisexampleitisbeingaggregatedintoaConformanceLevel2(CL2)solution(seethe"Conformance"chapterofthespecification[seeSection0ofthisdocument]foradditionalinformation).
TheseArtifactsareshowninthefollowingexampleexcerpt.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage24of35[Typethedocumenttitle]4.
3.
1.
3JRERuntimeThethirdreferencedpackageisaJavaruntimethatisaRequisiteofthecompositepackage.
TheJRE'sPackageDescriptorislocatedinpkgs\JRE\jre_pkg.
xmlandtheDeploymentDescriptorislocatedinpkgs\JRE\jre.
xmlin[SDDEX](seeAppendix[A]).
TheJREexampleisasimplepackagethatwasdescribedinSection[4.
2].
ThisReferencedPackageisassociatedwithresourceconstraintsviathepropertiesoftheresultingresourcesthataredeclaredinitsResultingResourceMap.
Inthisexample,theNameandVersionoftheJREarecomparedwithconstraintsontheNameandVersionoftheJREthataredeclaredinRequirementsinSDDselsewhereinthecompositeapplicationhierarchy(forexample,theJRE01.
reqtRequirementthatisdefinedinSimpleAppClient–seesection[4.
3.
1.
2).
Theresultingresourcefromtheinstallationofthispackagehasanidvalueof"JRE"andatypeof"sp:CIM_InstalledProduct".
4.
3.
1.
4LanguagePacksThefinalreferencedpackagesforthiscompositeexamplearethelanguagepackageslocatedinthepkgs\Languagesdirectoryin[SDDEX](seeAppendix[A]).
Theselanguagepackagesaresimilartoothersimplepackagesalreadydescribed.
Notethatinthesepackages,thelanguagepackagecanbeinstalledorupdated.
Fortheinstallcase,theInstallArtifactisused;whereasintheupdatecase,theUpdateArtifactisused.
Notethatbothlanguagepackagedeploymentdescriptorsdeclare,intheirrespectiveVariablessection,arequiredresourcepropertywiththename"Directory"fromtheresourceSimpleApp1.
Thisisshowninthefollowingexampleexcerptfromthepkgs\Languages\FrenchLanguagePack.
xml.
InstalllocationforSimpleDemonstrationApplicationInstalllocationforSimpleDemonstrationApplication4.
3.
2CompositePackageDescriptorThecompletecompositePackageDescriptorexampleforaJ2EEapplicationanditsassociatedcomponentsisinthefileexamples/CompositeApp/CompositeApp_pkg.
xmlin[SDDEX](seeAppendix[A]).
ComparedwiththesimplePackageDescriptorasshowninthepreviousexample,thecompositePackageDescriptorhassimilaridentityinformation,includingDescription,ShortDescription,Version,BuildInformationandManufacturerinformation.
Allofthisinformationisprovidedbythepackageauthor.
ThecompositePackageDescriptordiffersfromthesimpledescriptorinthecontentsection.
ThecontentsectioncontainsconstituentandreferencedPackageDescriptorsthatidentifythecomponentstobeinstalled.
Thesecomponentsinclude:Three-tierJ2EEapplicationpackage(SC_pkg)ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage25of35[Typethedocumenttitle]SimpleJ2EEclient(SAC_pkg)JREruntimepackage(JRE_pkg)GermanandFrenchlanguagepacks(DE_Lang_pkgandFR_Lang_Pkg)Theseindividualpackages,showninthefollowingexampleexcerpt,areassociatedwiththecorrespondingcompositeDeploymentDescriptor(describednext)thatdescribesthecharacteristicsofthesepackagesandtheirrelationshipsanddependencies.
4.
3.
3CompositeDeploymentDescriptorThecompletecompositeDeploymentDescriptorexampleforaJ2EEapplicationanditsassociatedcomponentsisinthefileexamples/CompositeApp/CompositeApp.
xmlin[SDDEX](seeAppendix[A]).
ThecompositeDeploymentDescriptorfirstdescribesaTopologywithnestedresourcesforthecomponentstobeinstalled.
TheResourceelementisusedtodescribethetoplevelresources(inthiscase,theoperatingsystemsinwhicheachofthecomponentsofthecompositeapplicationwillbeinstalled).
ThetypeofeachoperatingsystemresourceisdescribedbyusingtheCIM_OperatingSystemclassdefinedintheStarterProfile[SDDSP].
EachoperatingsystemthencontainsHostedResourcesthatarethecomponentsofthecompositeapplication:theservlet,applicationserver,databaseandclientportions,respectively.
ThesenestedResourcetypes,inturn,aredefinedbythetypesdefinedintheStarterProfile,namely,CIM_J2eeServer,CIM_J2eeServlet,CIM_J2eeApplication,CIM_DatabaseSystem,CIM_CommonDatabase,CIM_InstalledProductandCIM_Application.
Notethattherearethreetop-levelresourcesoftypecim:CIM_OperatingSystem.
ThefirstdeclaresthehostingresourcewheretheJ2EEapplicationwillbeinstalled;theseconddeclaresthehostingresourcewheredatabasewillbeinstalled;andthethirddeclaresthehostingresourcewhereboththeJREandJ2EEclientwillbeinstalled.
BecausetheJREisrequiredbytheJ2EEclient,theyarebothhostedbythesameresource.
Thethreeoperatingsystemresourcesdonotexplicitlydeclarethattheyrepresentthreeseparatephysicalresources.
Instead,theyimplicitlydeclarethattheseresourcesmayrepresentdifferentphysicalresources.
Laterinthedeploymentdescriptor,theseresourcesaremappedtotheresourcesinthetopologiesinthereferencedSDDs.
ThisTopologyisshowninthefollowingexampleexcerpt.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage26of35[Typethedocumenttitle]TheCompositeInstallableelementthendescribesthedeploymentoftheaggregatedpackagesandtheassociationsamongthesepackages.
ThecontentoftheaggregatingcompositeapplicationDeploymentDescriptorintheexamplecontainsBaseContent,SelectableContent,andLocalizationContent.
TheVariableselementdefinestheinputparameterforthecompositedeploymentdescriptor.
RootofthedirectoryintowhichSimpleApplicationClientshouldbeinstalledTheBaseContenthierarchicallydefinesthenon-optionalcontentforthedeploymentoperationbyusingtheContainedPackageelement.
TheContainedPackageinthisexampleisthe3-tierJ2EEapplicationpackage(SC_Pkg)asdescribedinthePackageDescriptor.
TheContainedPackageelementinthiscasecanpassargumentstothereferencedpackageofSC_PkgthroughtheArgumentelement,suchasJDBC_UserandJDBC_Password(notethattheDeploymentDescriptoralsocontainsParameterVariablescorrespondingtotheseArguments).
ContainedPackagealsomapstheresourcesinthecompositeDeploymentDescriptortothereferencedDeploymentDescriptor(theTopologyinthereferencedJ2EEapplicationSDD,SC_pkg)throughResultingResourceMapandRequiredResourceMap.
TheBaseContentisshowninthefollowingexampleexcerpt.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage27of35[Typethedocumenttitle]SimpleApplicationSimpleApplicationServletSimpleApplicationDatabaseTheSelectableContentdefinescontentsthatareselectablebyfeature.
TheFeatureelementwithinSelectableContentdefinesfeaturesthatareassociatedwithcontentelementsthataredefinedwithinSelectableContent.
Inthisexample,onlyonefeatureisdefined:theclientapplicationisconsideredtobeanadd-onfeatureandtheclientapplicationpackageisdefinedasaContainedPackageinSelectableContent.
NotethemappingbetweenresourcesinthecompositedeploymentdescriptorandresourcesinthetopologyofthereferencedJ2EEclientSDD,SAC_pkg.
TheSelectableContentisshowninthefollowingexampleexcerpt.
ThefollowingexampleexcerptalsoincludesRequirements(discussedpreviously).
Requirementidvaluesrequirespecialconsiderationincomposite(aggregated)SDDs.
NotethattheidvaluesfortheRequirementsmustbeuniquewithinanysingledeploymentdescriptor.
Moreover,theseidvaluesmustbeuniqueacrossmultipledeploymentdescriptorsthatareaggregatedtogether.
TheSDDauthormustensurethatRequirementidvaluesareuniquethroughoutthecompositeSDD.
SDDconsumersmayqualifytheRequirementidvalueswiththeidvalueofeachdeploymentDescriptor;thiseffectivelyusesthedeploymentDescriptoridvalueasanamespacetodistinguishRequirementidvaluestofurtherensureuniquenessoftheindividualdeploymentDescriptorsthatareaggregated.
ThickClientforSimpleApplicationThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage28of35[Typethedocumenttitle]1.
4.
11.
5.
0ProtocolTCP/IPProtocolHTTPSTheLocalizationContentintheCompositeInstallabledefinesthelocalizationinformationandresources.
Inthisexample,theContainedLocalizationPackagesdefinethepackageswhosecontentsenableresourcestobelocalizedforGermanandFrench.
TheseContainedLocalizationPackagespointtoindividualPackageDescriptors(DE_Lang_PKGandFR_Lang_PKG)asdefinedinthecompositePackageDescriptor.
TheLocalizationContentisshowninthefollowingexampleexcerpt.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage29of35[Typethedocumenttitle]NotetheLanguageselementinthecompositedeploymentdescriptor.
Itdeclaresasmandatorythelanguage"en-US",whichisthedefault(implicit)languageoftheJ2EEClient.
Twooptionallanguages,FrenchandGerman,aredeclared;thefirstwithaLanguageSetelementthatdeclarestwolanguages,"fr-FR"and"fr-CA"(FrenchandFrenchCanadian)forthesetFrench;thesecondwithaLanguageelementthatdeclaresasinglelanguage"de-DE"forlanguageGerman.
TheselanguagesmaptotherelatedContainedLocalizationPackageelement.
FrenchGermanBesidesContainedPackageandContainedLocalizationPackage,aRequisiteselementcanalsobeusedintheaggregationofSDDs.
TheRequisiteselementisusedtoidentifyanSDDpackagethatcanbedeployed,ifnecessary,tosatisfyaresourceconstraint.
Inthisexample,theRequisiteusesaReferencedPackageelementtorefertoaJREpackagethatcanbedeployedtosatisfytherequirementfortheclientapplicationifnoJREthatsatisfiestherequirementispresentinthedeploymentenvironment.
ResultingResourceMapisusedtomaptheresourceJREfromthecompositedeploymentdescriptortotheresourceJREinthereferencedJRESDD,JRE_pkg.
TheRequisiteselementisshowninthefollowingexampleexcerpt.
Java(TM)RuntimeEnvironment,StandardEdition1.
5.
0ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage30of35[Typethedocumenttitle]5AdditionalConsiderationsTheprecedingexamplesillustratebasicconceptsoftheSDDforsoftwareinstallationandareintendedtoserveas"gettingstarted"content.
FuturepublicationsmaydetailotherusesofSDDbeyondinstallation,suchasupdates,configurationandlocalization.
AfewotherconsiderationsforSDDsthatdealprimarilywithinstallationbutdonotappearintheprecedingexamplesaredescribednext.
Monolithicartifacts:ThecompositeapplicationexampledescribedinSection[4.
3]showedhowmultipleartifactscanbepresentinasingleDeploymentDescriptor,enablingindividualcomponentstobeappropriatelyinstalledtodeploythecompletesolution.
AnotherformofanartifactthatmightbepresentinaDeploymentDescriptorisamonolithicartifact.
AmonolithicartifactisasingleArtifactforasingletargetthathascontentvariability(selectablecontent)andthataparticularruntimeunderstandshowtoprocess.
Amonolithicartifactexposesselectablecontentthatcanbedeployedfromthesingleartifact(ratherthanselectingparticularartifactsfordeployment,aswasillustratedintheprecedingConditionsexample).
SDDswithmonolithicartifactsdonotdiffersubstantiallyfromotherSDDs;theDeploymentDescriptorcanstilldescribeTopology,Identity,Requirements,Variables,andsoon.
Theexampleinexamples/Monolithic/Monolithic.
xmlin[SDDEX](seeAppendix[A])containsaDeploymentDescriptorthatillustratesthisconcept.
Inthatexample,theDeploymentDescriptorcontainsasingleartifactwithselectablecontentdescribedastwoFeatures–arepresentativeapplicationfeatureandhelpfiles–thatoptionallycanbedeployed.
TheSDDstandardwasdesignedtosupporteithermodel;thisaccommodatesmultiplekindsofartifacts,includingexistingorlegacyartifacts(thisdesignchoicecontributedtothedecisiontohavetwodifferentconformancelevelsfortheSDDstandard;seethe"Conformance"chapterofthespecification[seeSection0ofthisdocument]foradditionalinformation).
Existingartifacts(monolithicartifactsandothers)canstillbenefitfromuseoftheSDDby"wrapping"theartifactsinthedeclarativeSDDmetadatathataddsvaluabledeploymentinformation.
ThisthenenablesexistingruntimestobenefitfromtheSDDfordeploymentplanningandenhanceddeployment.
Oneoperation/oneartifactrule:AsdescribedintheSDDspecification[seeSection0ofthisdocument],restrictionsofasingleoperationperCompositeInstallableandasingleartifactperInstallableUnitapplyforaggregatedSDDs.
Hereweexplainthisruleinmoredetail,includingitsrationale.
ACompositeInstallableaggregatesmultipleartifactsthattogethersupporttheapplicationofoneoperationtotheoverallsoftware.
TheSDDspecificationstipulatesthateachCompositeInstallabledefinesonlyasingleoperationandthatallInstallableUnitsinaCompositeInstallabledefineonlyasingleartifact.
TheserulespreventambiguitythatwouldotherwisearisebecausesomeoftheelementsofCompositeInstallableandInstallableUnitaredefinedperoperation;whereasotherelementshaveimplicitmeaningsthatvarybasedontheoperationortypicallyapplyonlytoaparticularoperation.
AllowingonlyoneoperationperCompositeInstallablepreventsambiguityaboutthemeaningofFeature,ResultingResourceandResultingChangeelementsdefinedintheCompositeInstallable.
Featuresaremechanismstoselectportionsofcontentforaparticulardeploymentandcanbeusedwithanyoperation.
Featuresdonothavelong-livedidentity;rather,theyexisttoenablechoosingthecontentofthedeploymentpackage.
AFeaturedefinedforaninstalloperationislikelytobeunambiguous(typicallyrepresentingacomponentorcapabilitythatoptionallycanbeincludedduringtheinstallation).
AFeatureThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage31of35[Typethedocumenttitle]definedforanupdateoperation,however,couldbeequivocal(forexample,istheFeatureaparticular,optional,portionoftheupdate,similartotheinstallcase,orisitratheranupdatetoanexistingFeaturethatwaspreviouslyselectedduringinstall).
ForSDD,asingledefinitionmustbechosen,andtheSDDspecificationoptsfortheformer(thatis,Featuresselectaparticular,optionalportionofthecontentfortheoperationthatisspecified).
Hence,aCompositeInstallabledefinesonlyoneoperationbecauseitcandefineonlyonesetofFeatures.
WhenapplyingtheoneoperationdefinedintheCompositeInstallabletotheoverallsoftware,itmaybenecessarytoperformavarietyofoperationsonindividualresources.
Forexample,toupdateadatabaseproduct,itmightbenecessarytocreate(install)anewcomponent.
TheoveralloperationforthisCompositeInstallableisupdate,butitcontains–somewhereintheaggregation–anInstallArtifactforthenewcomponent.
LimitingtheCompositeInstallabletoasingleoperation(updateinthisexample)preventsuncertaintyaboutcontainedartifactsthatspecifydifferentoperations–iftheartifactisdefined(eventhough,inthisexample,itisanInstallArtifact),itisintendedtosupporttheoneoveralloperation(updateinthisexample)oftheCompositeInstallable.
AllowingonlyoneartifactinanInstallableUnitthatisdefinedwithinaCompositeInstallablealsopreventsambiguityintheinterpretationofRequiredBase,ResultingResourceandResultingChangeelements.
IfmultipleartifactswerepermittedinasingleInstallableUnit,thenitcouldbeunclearwhichartifact'sresultsweredescribedbyResultingResourceorResultingChange;italsocouldbeunclearastowhichartifact(s)require(s)theRequiredBase.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage32of35[Typethedocumenttitle]6ConclusionThisPrimerhasoffered"gettingstarted"informationthatillustratesthevalue,rationaleanduseofSDDforsoftwaredeployment,focusingmainlyonsoftwareinstallation.
SeveralofthepublishedSDDexamplesweredescribed.
Aspreviouslystated,thisPrimerdoesnottaketheplaceoftheSDDspecification,schemaandprofiles(seesections[0]and[Error!
Referencesourcenotfound.
]).
TheStarterProfilepublishedbytheOASISSDDTechnicalCommitteeincludestypesandvaluesusedintheexamples,butdoesnotincludealltypesandvaluesthatmightbeusedinparticularSDDs.
However,existingprofilescanbeextendedandnewprofilesgeneratedtodefinesuchvalues,usingthepatternestablishedbytheStarterProfile,asdescribedin[SDDSP].
Finally,asimplementationexperiencewiththeSDDstandardisgained,BestPracticeswillbedevelopedandsharedintheSDDcommunity.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage33of35[Typethedocumenttitle]A.
CompleteExamplesThelatestversionofexampleSDDs[SDDEX]thatillustratetheuseoftheschemacanbefoundat:http://docs.
oasis-open.
org/sdd/sdd/v2.
0/sdd-examples/Theseexamplesincludethosethatareexcerptedanddescribedelsewhereinthisdocument.
ThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage34of35[Typethedocumenttitle]B.
AcknowledgementsThefollowingindividualshaveparticipatedinthecreationofthisspecificationandaregratefullyacknowledged:Dr.
HowardAbrams,CAMr.
LazarBorissov,SAPAGMs.
DebraDanielson,CAMr.
RobertDeMason,SASInstitute,Inc.
Mr.
RobertDickau,MacrovisionCorporationMr.
QueniodosSantos,MacrovisionCorporationMr.
AdrianDunston,SASInstitute,Inc.
Mr.
RandyGeorge,IBMMr.
NicoGroh,SAPAGMr.
JeffHamm,SASInstitute,Inc.
Ms.
MerriJensen,SASInstitute,Inc.
Mr.
JasonLosh,SASInstitute,Inc.
Ms.
JuliaMcCarthy,IBMMr.
MarkMcCraw,SASInstitute,Inc.
Mr.
BrentMiller,IBMMr.
EdOverton,SASInstitute,Inc.
Mr.
ChrisRobsahm,SAPAGMr.
ThomasStudwell,DellDr.
Weijia(John)Zhang,DellThisisaNon-StandardsTrackWorkProduct.
ThepatentprovisionsoftheOASISIPRPolicydonotapply.
sdd-primer-v1.
0-cnd0116May2011CopyrightOASISOpen2011.
AllRightsReserved.
Non-StandardsTrackPage35of35[Typethedocumenttitle]C.
RevisionHistoryThefollowingarethechangesbetweenthe"SolutionDeploymentDescriptor(SDD)Primerv1.
0"documentandthe"SolutionDeploymentDescriptor(SDD)Primerv2.
0"document(thisdocument).
Changedversionnumberfrom1.
0to2.
0;updatedpublicationdatesAdapteddocumenttonewOASIStemplatefornon-standards-trackdeliverablesMovedallreferencesfrombodytocoverpagetofacilitateupdatesAddeddescriptorLanguageBundleillustrationandexplanationinsection[4.
2.
1]Addedclarificationaboutidvalueuniquenessinsections[4.
2.
2]and[4.
2.
2]Variousnon-substantiveeditorialupdatesandmodernizationsUpdatedreferencetoSDDExamplesinAppendix[Error!
Referencesourcenotfound.
]tocitev2.
0Examples.
UpdatedlistofcontributorsinAppendix[B]AddedthisAppendix[C]tolistsummaryofchangestothedocumentfromversiontoversion