APM - Operations Orchestration Integration Guide

21 Pages·2016·0.2 MB·English

HPE Application Performance
Management
SoftwareVersion:9.30
APM - Operations Orchestration Integration
Guide
DocumentReleaseDate:July2016
SoftwareReleaseDate:July2016
APM-OperationsOrchestrationIntegrationGuide
Legal Notices
Warranty
TheonlywarrantiesforHewlettPackardEnterpriseproductsandservicesaresetforthintheexpresswarranty
statementsaccompanyingsuchproductsandservices.Nothinghereinshouldbeconstruedasconstitutingan
additionalwarranty.HPEshallnotbeliablefortechnicaloreditorialerrorsoromissionscontainedherein.
Theinformationcontainedhereinissubjecttochangewithoutnotice.
Restricted RightsLegend
Confidentialcomputersoftware.ValidlicensefromHPErequiredforpossession,useorcopying.Consistentwith
FAR12.211and12.212,CommercialComputerSoftware,ComputerSoftwareDocumentation,andTechnicalData
forCommercialItemsarelicensedtotheU.S.Governmentundervendor'sstandardcommerciallicense.
CopyrightNotice
©Copyright2005-2016HewlettPackardEnterpriseDevelopmentLP
TrademarkNotices
Adobe®andAcrobat®aretrademarksofAdobeSystemsIncorporated.
AMDandtheAMDArrowsymbolaretrademarksofAdvancedMicroDevices,Inc.
Google™andGoogleMaps™aretrademarksofGoogleInc.
Intel®,Itanium®,Pentium®,andIntel®Xeon®aretrademarksofIntelCorporationintheU.S.andothercountries.
iPodisatrademarkofAppleComputer,Inc.
JavaisaregisteredtrademarkofOracleand/oritsaffiliates.
Microsoft®,Windows®,WindowsNT®,WindowsServer®andWindowsVista™areeitherregisteredtrademarksor
trademarksofMicrosoftCorporationintheUnitedStatesand/orothercountries.
OracleisaregisteredtrademarkofOracleCorporationand/oritsaffiliates.
UNIX®isaregisteredtrademarkofTheOpenGroup.
Documentation Updates
Thetitlepageofthisdocumentcontainsthefollowingidentifyinginformation:
SoftwareVersionnumber,whichindicatesthesoftwareversion.
l
DocumentReleaseDate,whichchangeseachtimethedocumentisupdated.
l
SoftwareReleaseDate,whichindicatesthereleasedateofthisversionofthesoftware.
l
Tocheckforrecentupdatesortoverifythatyouareusingthemostrecenteditionofadocument,goto:
https://softwaresupport.hpe.com/group/softwaresupport/search-result?keyword=.
ThissiterequiresanHPEPassportaccount.Ifyoudonothaveone,clicktheCreateanaccountbuttonontheHPE
PassportSigninpage.
Support
VisittheHPESoftwareSupportwebsiteat:https://softwaresupport.hpe.com
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupportthatHPESoftware
offers.
HPESoftwareSupportprovidescustomerself-solvecapabilities.Itprovidesafastandefficientwaytoaccess
interactivetechnicalsupporttoolsneededtomanageyourbusiness.Asavaluedsupportcustomer,youcanbenefit
byusingthesupportwebsiteto:
Searchforknowledgedocumentsofinterest
l
Submitandtracksupportcasesandenhancementrequests
l
HPEApplicationPerformanceManagement(9.30) Page2of21
APM-OperationsOrchestrationIntegrationGuide
Downloadsoftwarepatches
l
Managesupportcontracts
l
LookupHPEsupportcontacts
l
Reviewinformationaboutavailableservices
l
Enterintodiscussionswithothersoftwarecustomers
l
Researchandregisterforsoftwaretraining
l
MostofthesupportareasrequirethatyouregisterasanHPEPassportuserandsignin.Manyalsorequirea
supportcontract.ToregisterforanHPEPassportID,gotohttps://softwaresupport.hpe.comandclickRegister.
Tofindmoreinformationaboutaccesslevels,goto:
https://softwaresupport.hpe.com/web/softwaresupport/access-levels
HPE Software Integrations,Solutionsand BestPractices
AccesstheHewlettPackardEnterpriseSoftwareSupportsite(https://softwaresupport.hpe.com/manuals)to
searchforawidevarietyofbestpracticedocumentsandmaterials.
HPEApplicationPerformanceManagement(9.30) Page3of21
APM-OperationsOrchestrationIntegrationGuide
Contents
APM-OperationsOrchestration (OO)Integration Overview 5
How to Integrate APMand OO 6
Troubleshooting Integration Problems 13
ExamplesofAPMand OOIntegrations 14
OOIntegration Administration UserInterface 15
RunBooksConfigurationPage 15
RunBookMappingConfigurationWizard 16
SelectCITypePage 16
SelectRunBooksPage 17
ConfigureParametersPage 18
SummaryPage 19
SelectTopologyDialogBox 19
Send Documentation Feedback 21
HPEApplicationPerformanceManagement(9.30) Page4of21
APM - Operations Orchestration (OO)
Integration Overview
HPOperationsOrchestration(OO)providesasimplewayforcustomerstorunscriptsforautomaticactions.
TheintegrationwithApplicationPerformanceManagement(APM)usestheOOcapabilitiesforbuilding
investigationtoolsorserviceremediationscripts,providingtheoperatorswithasimplewaytovalidatea
problem,investigateit,orautomaticallycorrectit.Arunbookcanbeexecutedmanually.
OOrunbookscanbelaunchedfromtheServiceHealthandEventBrowserapplications.
TheintegrationofAPMandOOprovidesthecapabilityofmappingCItypestoOOrunbooks.
Afteryoucreatesuchmappings,youcanrunthemappedOOrunbooks:
OnCIs, usingtheInvokeRunBooksCI contextmenuoptioninServiceHealth.TheOOrunbook
l
parametersarepopulatedusingthemaptotheCIattributesdefinedinthe"RunBookMapping
ConfigurationWizard"onpage16.
Attheeventlevel inOperationsManagement.OMiopensaneventandchecksiftheCIforthisevent
l
hasarunbookassignedtoit,andiftherunbookissettorunautomatically.TheOOrunbookparameters
arepopulatedusingthemaptotheCIoreventattributesdefinedinthe"RunBookMappingConfiguration
Wizard"onpage16.
HPEApplicationPerformanceManagement(9.30) Page5of21
How to Integrate APM and OO
ThistaskdescribestheworkingorderrequiredtointegrateAPMandOO.
DetailsaboutthesupportedversionsofAPMandHPOperationsOrchestrationareprovidedinthe
IntegrationstaboftheHPESoftwareIntegrationssite.
1. Prerequisites
ForOO10.x,beforeyouconfiguretheintegration,theOOadministratorneedstoperformthefollowing:
a. EnableUserAuthenticationandcreateanintegrationuser;theusermusthavethe
ADMINISTRATORrole.Fordetails,see"Grantpermissions"onpage11.
b. DeploythefollowingOperationsOrchestrationCPsontheOOserver:Base,Middleware,and
OperatingSystems.
FirstdeploytheBaseCP,thentheotherCPs.
FordetailshowtogettheseCPsrefertotheOOdocumentation.FordetailshowtodeployCPsin
OO,refertothesection“DeployingaContentPack”intheHP OOCentralGuide.
2. Importthe OOflows forOMidelivered with APMinto OO
ForOO<10.0:UsingHPOOStudio,completethefollowingsteps:
a. ImporttheOOflows(HPOprOO*.jarfiles)deliveredwithOMi.TheOOflowsarelocatedontheData
ProcessingServerinthefollowingfolder:
TOPAZ_HOME/conf/opr/oo
Fordetails,seethechapterentitledImportingarepositoryintheHPOperationsOrchestrationStudio
AuthoringGuide.
b. DeploytheimportedflowstoOOCentral.
ForOO10.x:TheOOflowsincludedwithOMiaredeliveredintheHP OO9.xformat.TheformatofOO
flowhasbeenchangedforHPOO 10.x.ExistingOOflowsmustbeconvertedtotheHPOO10.xformat
usingtheconverterdeliveredwithHPOO 10.x.
a. ConverttheOOflows(HPOprOO*.jarfiles)deliveredwithOMiusingtheconverterdeliveredwith
OO10.x.TheoriginalOO flowsarelocatedontheDataProcessingServerattheinthefollowing
folder:
TOPAZ_HOME/conf/opr/oo
Fordetails,seethesectionentitledPhase2:ContentUpgradeintheHPOperationsOrchestration
UpgradeGuideforversion10.x.
b. ImporttheOOflowsconvertedfromthosedeliveredwithOMi.
HPEApplicationPerformanceManagement(9.30) Page6of21
APM-OperationsOrchestrationIntegrationGuide
HowtoIntegrateAPMandOO
Fordetails,seethechapterentitledImportingarepositoryintheHPOperationsOrchestrationStudio
AuthoringGuide.
Note:Toimporttheflows,youneedtounzipthejarfileandpointtothelocationwherethe
pathrefs.xmlfilecanbefoundintheextractlocation.Here'sanexampleflow:
i. Copy%TOPAZ_HOME%/conf/opr/oo/*90fromAPMtoC:\data\BSM_Content_OO9on
OO.
ii. Unzipeachjarfileintoitsowndirectory.
iii. mkdirC:\data\BSM_Content_OO10
iv. cdC:\ProgramFiles\Hewlett-Packard\HPOperationsOrchestration\studio\bin
v. upgrade-content.bat--nameHPOprOOADS90--publisherHP--repoC:\data\BSM_
Content_OO9\HPOprOOADS90\Repositories\0--outputC:\data\BSM_Content_
OO10\HPOprOOADS90
c. DeploytheimportedflowstoOOCentral.
3. Configure the link between APMand OO
ToconfiguretheintegrationbetweenAPMandOO,inAPMselectAdmin> Platform > Setupand
Maintenance> InfrastructureSettings:
SelectFoundations.
l
SelectIntegrationswithotherapplications.
l
IntheHP OperationOrchestrationtable,locateOperationOrchestrationapplicationURL,and
l
modifythesettingtotheURLusedtoaccesstheOOapplication.
WhenconnectinganapplicationthatemploysLWSSOtoHPOO10.x,youmustspecifythe
connectionURLofHPOOusingthefollowingformat:<protocol>://<FQDN>:<portNumber>(for
example,http://lab.lab:8080).TheportinOO10.xcanbe8080forHTTPor8443forHTTPS,
accordingtoyourneeds.
ForOO versionslowerthan10.00: https://<fullyqualifiedservername>:8443.
Ifyouwanttoenablerunbookstobeinvokedautomatically,youmustenteraUserNameand
l
Passwordinthesametable.Inthiscase,theusershouldbedefinedasinternalinOO.
4. Configure LightweightSingle Sign-On (LW-SSO)authentication
ConfigureLightweightSingleSign-On(LW-SSO)authenticationbetweenAPMandOO.Youmust
configureLW-SSOinbothAPMandOO.Proceedtotherelevantsectiondependingonyourversionof
OO.
ForOO versionslowerthan9.06:
HPEApplicationPerformanceManagement(9.30) Page7of21
APM-OperationsOrchestrationIntegrationGuide
HowtoIntegrateAPMandOO
a. InAPM,selectAdmin> Platform > UsersandPermissions> AuthenticationManagement,
andcopytheTokenCreationKey(theinitString)toOO,andreplace,inOO,alltheinitStringsinthe
lwssofmconf.xmlfilelocatedinthe<OOinstallationdirectory>\Program Files\Hewlett-
Packard\OperationsOrchestration\Central\conf\directory.
b. InOO,intheweb.xmlandapplicationContext.xmlfileslocatedinthe
<OOinstallationdirectory>\Program Files\Hewlett-Packard\
OperationsOrchestration\Central\WEB-INF\ directory,enableallfiltersandmappingsbetween
LWSSO_SECTION_BEGINandLWSSO_SECTION_END.
c. IfOOandAPMareindifferentdomainsintheWindowsoperatingsystem,youmustmakesurethat
theTrustedHosts/DomainsparameteristhesameinOOandAPM.TosettheparameterinAPM,
selectAdmin> Platform > UsersandPermissions> AuthenticationManagement,and
configuretheTrustedHosts/Domainsparameter.
d. RestartthefollowingOOservices:
ForOO versionsearlierthan9.03:RSCentral,RSJRAS,andRSScheduler.
ForOO versions9.03andhigher: RSCentral,RSJRAS.
Note:IfyouneedtoenableloggingfordebuggingLWSSO:InOO,inthe<OOinstallation
directory>\jetty\resources\log4j.propertiesfile,uncommentthelinethatappearsunderthe
LWSSOcomment.
ForOO versions9.06orhigher:
a. InAPM,selectAdmin> Platform > UsersandPermissions> AuthenticationManagement.
b. ClickConfiguretoopentheSSOConfigurationWizard,andpressNext.
c. TheSingle-Sign-OnConfigurationscreencontainsaTokenCreationKey.Copythiskey;youwill
needitsoon.
d. InOO,accessthefollowing:
o IfyouareusingOO 10.x,selectSystem Workspace> Security> SSO.
o IfyouareusingOO 9.06and9.07,selectAdministration> System Configuration>
Authentication.
e. IntheLightweightSSOSettingsarea,checktheEnablecheckbox.
f. ReplacethevalueoftheLWSSOpassphraseorinitStringparameterwiththeTokenCreationKey
youcopiedfromAPM.(Thismusthavethesamevalueonallapplicationsthatareintegratedusing
LWSSO.)
g. Definedomain-relatedparametersintheLightweightSSOSettingsarea:
o Domain.ThedomainoftheHPOOserver.
o ProtectedDomains.Listofcomma-separateddomainsusedbytheapplicationsthatemploy
LWSSO.
HPEApplicationPerformanceManagement(9.30) Page8of21
APM-OperationsOrchestrationIntegrationGuide
HowtoIntegrateAPMandOO
IfOOandAPMareindifferentdomainsintheWindowsoperatingsystem,makesurethatthe
TrustedHosts/DomainsparameteristhesameinOOandAPM.
InAPM,selectAdmin> Platform > UsersandPermissions> AuthenticationManagement,
andconfiguretheTrustedHosts/Domainsparameter.
Note:LimitationwithOO10.xandBSM9.2x.
TheintegrationofOO10.xwithBSM9.2xiscurrentlyonlysupportedifOOandAPMareinthesame
domain.Iftheyareindifferentdomains,theintegrationfails.
ForfurtherdetailsonconfiguringLW-SSOinOO,see"SettingUpSecurity–LWSSO"inthe
HP OO 10.01CentralGuide.
ForfurtherdetailsonconfiguringLW-SSOinAPM,seeAuthenticationStrategiesintheAPMPlatform
AdministrationGuide.
5. In Windows -exportservercertificates fromOO
ToexportservercertificatesfromOOandimportthemintoAPMinaWindowsenvironment,youusethe
keytoolutility,whichisincludedinSunJRE,toexportandimportcertificates.
ForOO versionsbeforev10:
a. OntheOOserverenter:<OO install folder>\jre1.6\bin\keytool" -export -alias pas -
file "<path to your certificate>.cer" -keystore "<OO install
folder>\central\conf\rc_keystore"
b. Whenpromptedforpasswordsenter:bran507025.
ForOO version10.x, iftheintegrationisoverSSL:
a. OntheOOserverenter: <OO install folder>\central\java\bin\keytool.exe -keystore
central\var\security\key.store -export -alias tomcat -file "<Operations
Orchestration fully qualified host name>.cer"
b. Whenpromptedforpasswordsenter:changeit.
6. In Windows,ifthe integration is overSSL -importOOservercertificates to
APM
ImporttheservercertificatefromtheOOservertotheAPMGatewayServersothatthetwosystems
cancommunicatewitheachothersecurely.
Tip:Ifyour%JAVA_HOME%environmentvariablepointstotheJREdirectoryinsteadoftheJDK
directory,removejrefromthekeystorepath(C:\> "%JAVA_HOME%\bin\keytool" -keystore) in
thecommands.
a. ImporttheServerCertificatetoAPM.ToimporttheservercertificateyouexportedfromOOtothe
APMcacertskeystores,ontheAPMGatewayServerenter:
o C:\> "%JAVA_HOME%\jre\bin\keytool"-keystore"%TOPAZ_
HOME%\JRE\lib\security\cacerts"-import-alias"<OperationsOrchestrationfully
qualifiedhostname>"-file"<OperationsOrchestrationfullyqualifiedhostname>.cer"
HPEApplicationPerformanceManagement(9.30) Page9of21
APM-OperationsOrchestrationIntegrationGuide
HowtoIntegrateAPMandOO
o C:\> "%JAVA_HOME%\jre\bin\keytool"-keystore"%TOPAZ_
HOME%\JRE64\lib\security\cacerts"-import-alias"<OperationsOrchestrationfully
qualifiedhostname>"-file"<OperationsOrchestrationfullyqualifiedhostname>.cer"
b. Whenpromptedforpasswordenter:changeit.
Note:IfJAVA_HOMEisnotset,useTOPAZ_HOME.
c. Inordertopreventacertificateerror,placethiscertificateintotheTrustedRootCertificate
AuthoritiesonanybrowserthatwillbeaccessingAPMasfollows:
o ClicktheInstall certificatebuttontostartthewizard.
o ClickNext.
o SelectthePlaceall certificatesinthefollowingstoreradiobutton.
o ClickBrowse.
o SelectTrustedrootcertificationauthorities.
o ClickNext.
o ClickFinish.
(Youcanalsoimportthecertificate;forexampleinWindowsIE:InternetOptions>Content>
Certificates>Import...)
d. RestartAPMontheGatewayserver.
e. RepeattheabovestepsontheDataProcessingServeraswell.
7. In Linux -exportservercertificates fromOO
ToexportservercertificatesfromHPOperationsOrchestration(OO)andimportthemintoAPM,youuse
thekeytoolutilitytoexportandimportcertificates.
ForOO versionsbeforev10:
a. OntheOOserverenter:
Keytool -keystore"$ICONCLUDE_HOME/Central/conf/rc_keystore"-export-aliaspas-file
"<OperationsOrchestrationfullyqualifiedhostname>.cer"
b. Whenpromptedforpasswordsenter:bran507025.
ForOO version10.x, iftheintegrationisoverSSL:
a. OntheOOserverenter:
Keytool -keystorecentral/var/security/key.store-export-aliastomcat-file"<Operations
Orchestrationfullyqualifiedhostname>.cer"
b. Whenpromptedforpasswordsenter:changeit.
8. In Linux,ifthe integration is overSSL -importOOservercertificates to APM
ImporttheservercertificatefromtheOOservertotheAPMGatewayServersothatthetwosystems
cancommunicatewitheachothersecurely.
HPEApplicationPerformanceManagement(9.30) Page10of21