VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1 -... Instruction Manual

Application Discovery Manager
Administration Guide
vCenter Application Discovery Manager 6.1
This document supports the version of each product listed and
supports all subsequent versions until the document is replaced
by a new edition. To check for more recent editions of this
document, see http://www.vmware.com/support/pubs.
EN-000451-00

VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
2VMware, Inc.
Application Discovery Manager Administration Guide
You can find the most up-to-date technical documentation on the VMware Web site at:
http://www.vmware.com/support/
The VMware Web site also provides the latest product updates.
If you have comments about this documentation, submit your feedback to:
[e-mail]
Copyright © 2010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and
intellectual property laws. VMware products are covered by one or more patents listed at
http://www.vmware.com/go/patents.
VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks
and names mentioned herein may be trademarks of their respective companies.

VMware, Inc. 3
Contents
AboutThisBook 7
1Overview 9
SystemArchitecture 9
Single‐boxAppliance 11
DistributedApplianceSolutions 11
VirtualandPhysicalApplianceSolutions 12
VirtualApplianceDeployment 12
PhysicalApplianceDeployment 13
MirroredNetworkTraffic 13
vCollector 13
MixedEnvironment 13
WhereToGoNext 14
InstallationofNeworAdditionalADMComponents 14
Licenses 14
UpgradingADM 14
MigratingtoaNewAppliance 14
Security 14
2InstallingADM 15
ADMInstallationRequirements 15
InstallationPersonnel 15
ESXResources 15
InstallingthevSphereClient 16
DisablingvMotion 16
PreparingtheEnvironment 16
PreparinganESXConfiguration 16
CreatingaNewvSwitchforPassiveDiscovery 17
ConfiguringthevSwitchGeneralSettingsforPassiveDiscovery 17
ConfiguringthevSwitchforPassiveCollector 17
ConfiguringdvSwitchforPassiveCollector 18
DeployingtheVirtualAppliances 18
DeployingtheADMVirtualAppliances 18
BeforeYouBegin 19
DeploymentProcedure 19
InstallingWindowsCollector 20
BeforeYouBegin 20
Deployment 20
Uninstall 21
3SettingUpADM 23
Process 23
OrderofSetup 23
ADMSetupProcedures 23
LaunchingtheFirstBootConfigurationTool 24

Administration Guide
4VMware, Inc.
ConfiguringtheRootPassword 24
UsernameandPasswords 24
ConfiguringStaticNetworkSettings 25
ConfiguringtheTimezoneandTime 25
ConfiguringtheApplianceRole 26
Post‐InstallationSteps 27
LoggingIntotheADMConsole 27
InitiatingPassiveDiscovery 27
4SecuringADM 29
ChangingtheRootPassword 29
ResettingtheADMRootPassword 29
OpenSSLSelf‐SignedTestCertificates 30
CASignedTestCertificates 30
Self‐SignedCertificates 30
Copyingthe.keyand.crtFiles 31
5Maintenance 33
ADMServices 33
ManagingServiceswithadm_control 34
ProductSupportPackages 34
UsingtheADMConsole 35
UsingtheCLI 35
RestoringanADMEnvironmentbyUsingaProductSupportPackage 36
RestoretheADMDatabase 36
RestoringtheCustomDiscoveryandConfigurationFiles 37
ReconfiguringanADMDeployment 38
AddingaRemoteDatabasetoanExistingADMDeployment 38
ConvertingaSingle‐boxorAggregatortoaRemoteDatabase 38
MovingaDatabasetoaRemoteAppliance 39
Licenses 39
UploadingaLicense 40
6UpgradingADM 41
Overview 41
ApplianceType 41
MixedEnvironments 41
Licenses 41
ApplianceMigration 41
BackingUpData 41
UpgradingAppliances 42
ImportantNotes 42
PreliminaryProcedures 42
UpgradingAppliancesUsingCLI 42
Post‐UpgradeSteps 43
7MigratingtoaNewAppliance 45
Overview 45
SupportedMigration 45
Licenses 45
SystemArchitecture 45
Process 46

VMware, Inc. 5
Contents
PreliminaryProcedures 46
BackingUpWinApeMigrationFiles 46
RestoringWinApeMigrationFiles 47
DataRestoration 47
Single‐box‐Solution 47
DistributedSolutions 47
Collectors 47
WinApe 47
Aggregator 47
DistributedSolutionwithRemoteDatabase 48
Collectors 48
WinApe 48
Database 48
Aggregator 48
Post‐MigrationSteps 48
8TroubleshootingADM 49
TroubleshootingtheADMbyUsingtheProductSupportPackage 49
DetailDiscoveryTroubleshooting 49
WMI 49
single.sh 49
Location 50
Usage 50
Examples: 51
snmpdump 52
Location 52
Usage 52
Examples 53
nlcapture 53
Location 53
Usage 53
9UninstallingADM 55
UninstallingtheADMAppliance 55
ATimeZones 57
BADMAPITutorial 59
APIFeatures 59
Insight_control 59
AsynchAPI 60
DumpAPI 60
BulkAPI 61
WebServicesAPI 61
Index 63

Administration Guide
6VMware, Inc.

VMware, Inc. 7
TheVMwarevCenter™ApplicationDiscoveryManager(ADM)AdministrationGuideprovidesinformation
thattheadministratorsarerequiredtoinstallandconfiguretheADM.
Intended Audience
ThisdocumentispartoftheVMwarevCenterApplicationDiscoveryManagerdocumentationset,andis
intendedforusebysystemadministratorsandintegratorsresponsibleforinstallingADM.
TheinstallationproceduresinthisdocumentmustbeperformedbyITprofessionalsfamiliarwith
virtualizationandVMwaretechnologiessuchasVMwareESX™serversandrelatedvirtualandphysical
equipment.
VMware Technical Publications Glossary
VMwareTechnicalPublicationsprovidesaglossaryoftermsthatmightbeunfamiliartoyou.Fordefinitions
oftermsastheyareusedinVMwaretechnicaldocumentationgotohttp://www.vmware.com/support/pubs.
Document Feedback
VMwarewelcomesyoursuggestionsforimprovingourdocumentation.Ifyouhavecomments,sendyour
feedbackto[e-mail].
Technical Support and Education Resources
Thefollowingsectionsdescribethetechnicalsupportresourcesavailabletoyou.Toaccessthecurrentversion
ofthisbookandotherbooks,gotohttp://www.vmware.com/support/pubs.
Online and Telephone Support
Touseonlinesupporttosubmittechnicalsupportrequests,viewyourproductandcontractinformation,and
registeryourproducts,gotohttp://www.vmware.com/support.
Customerswithappropriatesupportcontractsshouldusetelephonesupportforthefastestresponseon
priority1issues.Gotohttp://www.vmware.com/support/phone_support.
Support Offerings
TofindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds,goto
http://www.vmware.com/support/services.
About This Book

Administration Guide
8VMware, Inc.
VMware Professional Services
VMwareEducationServicescoursesofferextensivehands‐onlabs,casestudyexamples,andcoursematerials
designedtobeusedason‐the‐jobreferencetools.Coursesareavailableonsite,intheclassroom,andlive
online.Foronsitepilotprograms andimplementationbestpractices,VMwareConsultingServicesprovides
offeringsto helpyouassess,plan,build,andmanageyourvirtualenvironment.Toaccessinformationabout
educationclasses,certificationprograms,andconsultingservices,gotohttp://www.vmware.com/services.

VMware, Inc. 9
1
ThischapterdescribesthedifferentVMwarevCenterApplicationDiscoveryManager(ADM)architecture
solutionsandconfiguration.Topicsinclude:
“SystemArchitecture”onpage 9
“VirtualandPhysicalApplianceSolutions”onpage 12
“vCollector”onpage 13
“MixedEnvironment”onpage 13
“WhereToGoNext”onpage 14
System Architecture
TheADMprovidessystemarchitecturesolutionstomeettherequirementsofdifferentenvironmentsas
showninFigure 1‐1.
Figure 1-1. ADM Components
VMwareprovidesADMononeormoreappliances.Themodeoftheappliancedetermineswhichcomponent
isrunning.ADMcomponentsaredescribedinTable 1‐1.
Overview 1
AggregatorDatabase Active
Discovery-Unix
Active
Discovery-Windows
Passive
Discovery
Table 1-1. ADM Components
Component Description
ActiveDiscovery‐
UNIX
Collectsdatafromtheconfigurationobjectsinyourdatacenter.Thefollowingdiscoverytypesapply:
IPdiscovery—AmethodfordetectinghostsorotherconfigurationitemswithaspecificIPaddress
whenPassiveDiscoveryfailstodiscoverthem.
Detaildiscovery—ExtendstheinformationobtainedusingPassiveandIPDiscovery.Itusescommon
networkprotocolstoremotelyqueryserversinthemanagednetworkandobtainssupplementary
informationaboutnetworkhostswhichisaddedtothedatabase.
ActiveDiscovery‐
Windows
AdiscoveryenginethatusesWMIbaseddiscoverypoliciesforperformingactivediscoveryonWindows
machines.

Administration Guide
10 VMware, Inc.
PassiveDiscovery Passivelyobservesthenetworktrafficbyperformingadeep‐packetanalysistodiscoverapplicationsand
componentrelationshipsinphysicalandvirtualenvironments.
Italsoallowsyouto:
Mapdependencies.
Counttheactivityofthesedependencies.
Identifyservices.
Aggregator Receivesdatafromthediscoverycomponentsandreconcilesthedatabeforetransferringittothedatabase
component.TheaggregatoralsoprovidestheuserinterfaceforusingADMandistheintegrationpointfor
variousintegrations,forexample,ERDB.
Database AnOracleRDBMSusedforstoringdiscovereddataandADMconfiguration.
Table 1-1. ADM Components
Component Description