APM Platform Administration Guide

292 Pages·2016·2.45 MB·English

HPE Application Performance
Management
SoftwareVersion:9.30
APM Platform Administration Guide
DocumentReleaseDate:July2016
SoftwareReleaseDate:July2016
APMPlatformAdministrationGuide
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.
PDFVersionofOnlineHelp
ThisdocumentisaPDFversionoftheonlinehelp.ThisPDFfileisprovidedsoyoucaneasilyprintmultipletopics
fromthehelpinformationorreadtheonlinehelpinPDFformat.
Support
VisittheHPESoftwareSupportwebsiteat:https://softwaresupport.hpe.com
HPEApplicationPerformanceManagement(9.30) Page2of292
APMPlatformAdministrationGuide
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupportthatHPESoftware
offers.
HPESoftwareSupportprovidescustomerself-solvecapabilities.Itprovidesafastandefficientwaytoaccess
interactivetechnicalsupporttoolsneededtomanageyourbusiness.Asavaluedsupportcustomer,youcanbenefit
byusingthesupportwebsiteto:
Searchforknowledgedocumentsofinterest
l
Submitandtracksupportcasesandenhancementrequests
l
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) Page3of292
APMPlatformAdministrationGuide
Contents
PlatformAdministration Overview 8
Part1:Accessing and Navigating APM 9
Chapter1:Starting,Stopping,orRestartingAPM 10
Chapter2:ViewingStatusofProcessesandServices 12
Chapter3:LoggingintoAPM 13
Chapter4:LoggingintoAPMwithLW-SSO 19
Chapter5:TrackingLoginAttemptsandLoggedInUsers 22
Chapter6:CreatingaLinktoanAPMPage 23
Chapter7:NavigatingandUsingAPM 27
Chapter8:CustomizingAPM 34
Chapter9:WorkingwithAPMTables 36
Part2:Setup and Maintenance 37
Chapter10:Downloads 38
Chapter11:LicenseManagement 40
Chapter12:CustomizingAPMServerDeployment 43
Chapter13:ManagingDatabases 48
CreatingDatabases 49
MarkingDataasObsoleteforReports 55
PartitioningDatabasesandPurgingHistoricalDatafromDatabases 60
RunningRe-aggregationOnly 65
DatabaseLoaderPersistenceFolders 67
Chapter14:InfrastructureSettings 68
ModifyingthePingTimeInterval 69
ConfiguringtheDatabaseStatisticsAge 70
ConfiguringtheMaximumNumberofLateArrivalSamples 70
ConfiguringtheMaximumNumberofCIsMarkedasCandidateforDeletion 70
ConfiguringtheMaximumNumberofBusQueueMessages 71
ConfiguringtheMobileHealthReportLocationsThreshold 71
LocationsandExpirationsofTemporaryImageFiles 71
EnablingDockerSupportforRUMApplications 77
EnablingSMTPServerSSL/TLSSupport 77
Chapter15:JMXConsole 79
Chapter16:Baselines 81
Chapter17:AuditLog 85
Chapter18:HPESystemHealth 89
Chapter19:APMServerTimeSynchronization 90
HPEApplicationPerformanceManagement(9.30) Page4of292
APMPlatformAdministrationGuide
Chapter20:APMLogs 91
Chapter21:PortUsage 94
Chapter22:FileBackupRecommendations 104
Chapter23:WorkinginNon-EnglishLocales 105
Part3:Data Enrichment 112
Chapter24:LocationManager 113
Part4:Users,Permissions,and Recipients 127
Chapter25:UserManagement 128
GroupMappingsDialogBox 131
Permissions 132
UnderstandingPermissionsResources 133
Roles 135
Operations 136
SecurityOfficer 136
GroupandUserHierarchy 137
ConfiguringUsersandPermissions-Workflow 138
HowtoConfigureUsersandPermissions—Use-CaseScenario 142
HowtoCustomizeUserMenus—Use-CaseScenario 148
HowtoExportandImportUserInformationUsingtheJMXConsole 150
UserManagementRolesAppliedAcrossAPM 151
Superuser 152
Administrator 152
SystemModifier 157
SystemViewer 160
BPMViewer 163
BPMAdministrator 163
RUMAdministrator 164
RUMViewer 164
UserManagementRolesAppliedtoSpecificContexts 164
UserManagementOperations 166
UserManagementUserInterface 178
PermissionsTab(UserManagement) 178
ResourceTreePane 178
RolesTab 180
OperationsTab 181
HierarchyTab(UserManagement) 182
CustomizationTab(UserManagement) 183
Chapter26:RecipientManagement 185
ConfigureandManageRecipients 185
RecipientManagementCommunicationMethods 191
HPEApplicationPerformanceManagement(9.30) Page5of292
APMPlatformAdministrationGuide
Chapter27:PersonalSettings 197
Chapter28:AuthenticationStrategies 203
TLSandSmartCardAuthentication 205
TLSandSmartCardAuthenticationConfiguration-IntroductionPage 207
TLSandSmartCardAuthenticationConfiguration-FrontEndServerPage 208
TLSandSmartCardAuthenticationConfiguration-ConfigurationModePage 208
TLSandSmartCardAuthenticationConfiguration-ServerCertificatePage 209
TLSandSmartCardAuthenticationConfiguration-ClientCertificatePage 210
TLSandSmartCardAuthenticationConfiguration-AdminPage 210
TLSandSmartCardAuthenticationConfiguration-SummaryPage 211
LDAPConfigurationWizard 211
LDAPGeneralConfigurationPage 211
LDAPVendorAttributesDialogBox 214
LDAPGroupMappingConfigurationPage 215
LDAPSummaryPage 216
SSOConfigurationWizard 216
SingleSign-OnPage 217
SAML2ConfigurationDialogBox 219
SSOSummaryPage 220
Chapter29:LightweightSingleSign-OnStrategy 222
Chapter30:IdentityManagementSingleSign-OnAuthentication 225
Chapter31:LDAPAuthenticationandMapping 229
SynchronizingUsers 233
AchievingFinerControloverDefaultUserPermissionAssignments 237
Chapter32:LW-SSOAuthentication–GeneralReference 238
LW-SSOSystemRequirements 238
LW-SSOSecurityWarnings 239
LW-SSOTroubleshootingandLimitations 240
Part5:Reportsand AlertsAdministration 242
Chapter33:ReportScheduleManager 243
Chapter34:SettingUpanAlertDeliverySystem 245
AlertsandDowntime 246
PlanningforEffectiveAlertSchemes 246
HowtoSetUpanAlertDeliverySystem 247
HowtoCustomizeAlerts 250
HowtoTestYourEmailNotificationConfiguration 257
AlertLogs 258
AlertDetailsReport 260
TroubleshootingandLimitations 262
Chapter35:EUMAlertsNotificationTemplates 263
ClearAlertNotificationTemplates 263
HPEApplicationPerformanceManagement(9.30) Page6of292
APMPlatformAdministrationGuide
HowtoConfigureEUMAlertsNotificationTemplates 263
HowtoConfigureaTemplateforClearAlertNotifications 264
EUMAlertsNotificationTemplatesUserInterface 264
NotificationTemplatePropertiesDialogBox 264
NotificationTemplatesPage 268
Part6:Downtime Management 270
Chapter36:DowntimeManagementOverview 271
PropertiesPage 281
SelectCIsPage 281
SchedulingPage 282
ActionPage 283
NotificationPage 285
PreviewPage 285
Part7:Troubleshooting 286
Chapter37:TroubleshootingandLimitations 287
Send Documentation Feedback 292
HPEApplicationPerformanceManagement(9.30) Page7of292
Platform Administration Overview
Thisguideprovidesinstructionsonhowtoopen,configure,andadministerHPEApplicationPerformance
Management(APM).
Theguideisdividedintothefollowingparts:
AccessingandNavigatingAPM.DescribeshowtostartAPM,howtologintotheapplication,anda
l
generaloverviewoftheuserinterface.
SetupandMaintenance.Describesbasicsetupoptionssuchasinfrastructuresettings,timezones,
l
languages,logs,andbackups.
DataEnrichment.Describeshowtoworkwithmultiplegeographiclocations.
l
Users, Permissions, andRecipients.DescribeshowtocontroluseraccesstoAPM.
l
ReportsandAlertsAdministration.Describeshowtoschedulereportsandsetupalerts.
l
DowntimeManagement.Describeshowtocontrolsystemdowntime.
l
Troubleshooting.Discussescommonsystemissuesorlimitations.
l
HPEApplicationPerformanceManagement(9.30) Page8of292
Part 1: Accessing and Navigating APM
HPEApplicationPerformanceManagement(9.30) Page9of292
Chapter 1: Starting, Stopping, or Restarting
APM
Thissectionprovidesinstructionsforstarting,stopping,orrestartingAPM.
Note:Ifyouareworkinginadistributedenvironment,firstenabletheDataProcessingServer,andthen
enabletheGatewayServer.
Tasks
How to Start, Stop, or Restart APM
TostartorstopAPMinWindows:
SelectStart> Programs> HPE ApplicationPerformanceManagement> Administration> Enable|
DisableHPE ApplicationPerformanceManagement.
Tostart, stop, orrestartAPMinLinux:
/opt/HP/BSM/scripts/run_hpbsm <start | stop | restart>
Tostart, stop, orrestartAPMusingaDaemonScript:(inLinux)
/etc/init.d/hpbsmd <start | stop | restart>
Note:WhenyoustopAPMinWindows,theHPEApplicationPerformanceManagementserviceisnot
removedfromMicrosoft’sServiceswindow.TheAPMserviceisremovedfromtheServiceswindowonly
afteryouuninstallAPM.
UI Description
Windows Start Menu
InaWindowsenvironment,theinstallationprocessaddsanHPEApplicationPerformanceManagement
menutotheWindowsStartMenu.
Thismenuincludesthefollowingoptions:
Option Description
OpenHPEApplicationPerformance OpenstheAPMapplicationLoginpageinawebbrowser.
Management
HPEApplicationPerformanceManagement(9.30) Page10of292