Vmware Application Discovery Manager Administration Guide V Center 7.1 Vcenter 71 Ag En

vCenter Application Discovery Manager - 7.0 - Administration Guide vcenter-application-discovery-manager-70-ag-en Free User Guide for VMware vCenter Software, Manual

User Manual: vmware vCenter Application Discovery Manager - 7.1 - Administration Guide Free User Guide for VMware vCenter Software, Manual

Open the PDF directly: View PDF .
Page Count: 72

Application Discovery Manager Administration Guide

Application Discovery Manager

Administration Guide

vCenter Application Discovery Manager 7.0.0

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-000996-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:

docfeedback@vmware.com

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

DistributedAppliancewithRemoteDatabase 11

VirtualApplianceSolution 11

VirtualApplianceDeployment 11

MirroredNetworkTraffic 12

vCollector 12

MixedEnvironment 12

WhereToGoNext 13

InstallationofNeworAdditionalADMComponents 13

Licenses 13

UpgradingADM 13

MigratingtoaNewAppliance 13

Security 13

2InstallingADM 15

ADMInstallationRequirements 15

InstallationPersonnel 15

ESXResources 15

InstallingthevSphereClient 16

DisablingvMotion 16

PreparingtheEnvironment 17

PreparinganESXConfiguration 17

DeployingtheVirtualAppliances 18

DeployingtheADMVirtualAppliances 19

InstallingWindowsCollector 20

SettingUpOracleasanExternalDatabaseforADM 21

3SettingUpADM 25

Process 25

OrderofSetup 25

ADMSetupProcedures 25

LaunchingtheFirstBootConfigurationTool 26

ConfiguringtheRootPassword 26

ConfiguringStaticNetworkSettings 27

ConfiguringtheTimezoneandTime 27

InstallingtheOracleClient 28

ConfiguringtheApplianceRole 28

Post‐InstallationSteps 31

ActiveDirectoryConfiguration 31

LoggingintotheADMConsole 32

InitiatingPassiveDiscovery 32

Application Discovery Manager Administration Guide

4VMware, Inc.

4SecuringADM 35

ChangingtheRootPassword 35

ResettingtheADMRootPassword 35

OpenSSLSelf‐SignedTestCertificates 36

CASignedTestCertificates 36

Self‐SignedCertificates 36

5Maintenance 39

ADMServices 39

ProductSupportPackages 40

UsingtheADMConsole 41

UsingtheCLI 41

RestoringanADMEnvironmentbyUsingaProductSupportPackage 42

Licenses 45

UploadingaLicense 45

6UpgradingADM 47

Overview 47

MixedEnvironments 47

Licenses 47

ApplianceMigration 47

BackingUpData 47

UpgradingAppliances 48

ImportantNotes 48

PreliminaryProcedures 48

UpgradingAppliancesUsingCLI 48

Post‐UpgradeSteps 49

7MigratingtoaNewAppliance 51

Overview 51

SupportedMigration 51

Licenses 51

SystemArchitecture 51

Process 52

PreliminaryProcedures 52

DataRestoration 53

Single‐BoxSolution 53

DistributedSolutions 53

DistributedSolutionwithRemoteDatabase 54

Post‐MigrationSteps 54

8TroubleshootingADM 55

TroubleshootingADMInstallation 55

TroubleshootingADMbyUsingtheProductSupportPackage 56

TroubleshootingErrorMessagesDuringWMIDiscovery 56

DetailDiscoveryTroubleshooting 56

UsingADMConsole 57

WMI 57

single.sh 57

snmpdump 60

nlcapture 60

VMware, Inc. 5

Contents

9UninstallingADM 63

UninstallingtheADMAppliance 63

ATimeZones 65

BADMAPITutorial 67

APIFeatures 67

Insight_control 67

AsynchAPI 68

DumpAPI 68

BulkAPI 69

WebServicesAPI 69

Index 71

Application Discovery Manager 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docfeedback@vmware.com.

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

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

Application Discovery Manager 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

ThischapterdescribesthedifferentVMwarevCenterApplicationDiscoveryManager(ADM)architecture

solutionsandconfiguration.Thischapterincludesthefollowingtopics:

“SystemArchitecture”onpage 9

“VirtualApplianceSolution”onpage 11

“vCollector”onpage 12

“MixedEnvironment”onpage 12

“WhereToGoNext”onpage 13

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

Application Discovery Manager Administration Guide

10 VMware, Inc.

Single-Box Appliance with Remote Database

InaSingle‐BoxappliancewithRemoteDatabasesolution,theADMcomponentsareenabledonasingle

virtualappliance.Also,adesignatedappliancehoststhedatabase.

Figure 1-2. Single-Box Appliance with Remote Database Architecture

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.

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.

ADM7.0doesnothaveOracledatabaseintegrated.Youneedtoconfigureyourown

externalOracledatabaseasdescribedin“SettingUpOracleasanExternalDatabasefor

ADM”onpage 21.

ESX1

ADM VM2

Active Discovery-

Windows

Runs on (Virtualization)

Logical monitoring

port connectivity

ADM Connectivity

Physical

switch 2

Physical

switch 1

Active Discovery-

Unix

Database

Oracle as an

external database

Aggregator

Passive

Discovery

vSwitch

ADM VM1

Role = single-box

Role=Windows collector

(running Win2008

on any ESX)

VMware, Inc. 11

Chapter 1 Overview

Distributed Appliance with Remote Database

ADistributedAppliancewithRemoteDatabasesolution,oneapplianceenabledasanAggregatoralongwith

oneormoreappliancesenabledascollector.PassiveandDetailDiscoverycanrunonsingleormultiple

Collectors.Also,adesignatedappliancehoststhedatabase.

Figure 1-3. Distributed Appliance with Remote Database Architecture

Virtual Appliance Solution

YoucansetupADMonyourESXorESXiserversasdescribedin“VirtualApplianceDeployment”onpage 11.

YoucanalsosetupADMonanexistingIBMphysicalappliancesbutonlyupgradingissupportedasdescribed

in“UpgradingADM”onpage 13.

Virtual Appliance Deployment

ADMversion7.0.0isdeliveredasVA,whichisavirtualmachineimagethatincludesanoperatingsystemand

therelevantADMsoftwarecomponentsinstalledonit.AVAcanrunoneormultipleADMcomponents

dependingontheapplianceroleselected.

DeployingavirtualmachinetemplateinanOpenVirtualizationFormat(OVF)ontotheESXorESXiserver

createsanADMvirtualappliance.Afterdeployment,poweruptheVAandthenconfigurethestandard

appliancesettings,network,anduserinformation.

NOTEADM7.0doesnothaveOracledatabaseintegrated.YouneedtoconfigureanexternalOracledatabase

asdescribedin“SettingUpOracleasanExternalDatabaseforADM”onpage 21.

ESX1

ADM VM4

Active Discovery-

Windows

vSwitch

Role = Windows

Collector

(running Win2008

on any ESX)

Runs on (Virtualization)

Logical monitoring

port connectivity

ADM Connectivity

Physical

switch 2

Physical

switch 1

Aggregator

ADM VM1

Role = Aggregator

Database

ADM VM3

Passive

Discovery

vSwitch

Role = Passive

Collector

ESX4

Oracle as an

external database ADM VM2

vSwitch

Role = Collector

ESX2

Active Discovery-

Unix

Passive

Discovery

ESX3

Application Discovery Manager Administration Guide

12 VMware, Inc.

DownloadthefollowingartifactsfromtheVMwareWebsite:

http://downloads.vmware.com/Application Discovery Manager

CoreADMTemplate:AnOVFtemplatethatincludesallADMcomponentsexceptfortheWindows

CollectorandyoucanconfigureasAggregator,Aggregatorwithremotedatabase,Database,or

Single‐Box.

CollectorADMTemplate:AsmallerOVFtemplatethatincludesthePassiveCollectorandActiveand

PassiveCollectorandyoucanconfigureaspassiveandactivediscoveryCollectorandPassiveDiscovery

Collector.

WindowsCollectorInstaller:AnexecutablefilethatinstallstheWindowsCollectorcomponentontopof

theWindows2008R2operatingsystems.

Mirrored Network Traffic

Themethodinwhichtheapplianceperformspassivediscoveryisbyanalyzingmirroredtrafficfromaswitch

orrouter.Networkdevicesthathavetheabilitytoconfigureamirroredport(sometimescalledasaSwitched

PortAnalyzer,spanportormonitorport)canforwardacopyofallthenetworktrafficfromall(orselected)

portstooneormoremirroredports.Typically,eachnetworkdevicehasallitsportsmirroredtooneport.These

mirroredportsarethenconnecteddirectlytooneofthenetworkinterfacesontheESXserver.

Performoneofthefollowingstepsifyouhavetoconnectmultiplemonitorports:

Connectthemonitorportstoanaggregateswitch(A‐Switch),whichisalsoconfiguredwithamonitor

port.PlugthemirroredportoftheA‐SwitchintotheESXservernetworkinterface.

ContactyourVMwareSalesRepresentativeifyourequireanA‐Switch.

AddfewmorenetworkinterfacestoESXserver.

InstallanotherADMPassiveCollectoronadifferentESXserver.

vCollector

TheADMusesavirtualcollector(vCollector)tolistentocommunicationbetweenvirtualmachinesthatrun

onthesameVMwareESXServer.AvCollectorispresentinsideavirtualmachineanditslistenercollectsthe

informationaboutthevirtualmachinesdeployedontheESXServer.BydeployingavCollector,theADMis

abletopassivelydiscoverdependenciesinavirtualizedenvironment.Youcanthenviewinformationabout

thevirtualmachinesthataredeployedonthesameESXServerincluding:

Dependencymapsbetweenvirtualmachines.

Activitycountsofthedependencies.

Servicesrunningonthevirtualmachines.

Additionalinformationthatisofferedbythelistener.

Mixed Environment

TheADM7.0.0releaseintroducesADMasavirtualappliance,butitalsosupportsupgradingfrom6.0ona

physicalIBMappliances.Youcanupgradeyourphysicalenvironmentwithadditionalvirtual7.0.0appliances

likemixedenvironment.ThisadditionalvirtualappliancecanplayaroleofPassiveCollectors(vCollectors)

oranadditionalPassiveandActiveCollectors.

IMPORTANTConsultITprofessionalsofyourorganizationtoensurethattheappropriateswitchesorrouters

thatcontainsthenetworktrafficisusedforDiscoveryareconfiguredproperlyforportmirroringandare

accessibletotheADMappliance.

NOTETheADMPassiveCollectorcanworkwithmaximumofthreemonitorports.Ifyouhavetoconnect

morethanthreemonitorports,youmustaddanotherADMPassiveCollector.

VMware, Inc. 13

Chapter 1 Overview

Where To Go Next

Thissectionprovideslinksthatcontainsmoreinformationonthetopicslisted.

Installation of New or Additional ADM Components

ContinuebyconfiguringinitialappliancesettingsasdescribedinChapter 2.

Licenses

YouneedanewlicensetouseADMafterupgradingormigrating.ObtainthelicensefromyourVMwareSales

representative.Formoreinformation,see“Licenses”onpage 45.

Upgrading ADM

ContinuewithupgradeproceduresasdescribedinChapter 6.

Migrating to a New Appliance

ContinuewithmigrationproceduresasdescribedinChapter 7.

Security

FormoreinformationonADMsecurity,seeChapter 4.

NOTEAllADMappliancesthatparticipateinmixedenvironemntmodemustrunthesame7.0.0versionof

theADM.

Application Discovery Manager Administration Guide

14 VMware, Inc.

VMware, Inc. 15

ThischapterdescribesinstallationanddeploymentoftheADM.Thischapterincludesthefollowingtopics:

“A D M InstallationRequirements”onpage 15

“DisablingvMotion”onpage 16

“PreparingtheEnvironment”onpage 17

“DeployingtheVirtualAppliances”onpage 18

“InstallingWindowsCollector”onpage 20

“SettingUpOracleasanExternalDatabaseforADM”onpage 21

ADM Installation Requirements

ADMisanappliancethatcanruninaVMwareinfrastructure.Thissectioncontainsrequirementsthatmust

bemetbeforeyouinstallandusetheADMappliance.

Installation Personnel

TheinstallationproceduresinthisdocumentmustbeperformedbyITprofessionalsfamiliarwith

virtualizationandVMwaretechnologiessuchasESXserversandrelatedvirtualandphysicalequipment.

ESX Resources

TousetheADMappliance,youmustinstalltheADMapplianceonaVMwareESXserverversion3.5orlater.

ConfigurethevirtualmachineonyourESXserveraccordingtothedeploymentmodelwithresourcesas

describedinTable 2‐1.

Installing ADM 2

Table 2-1. Virtual Appliance Deployments

ADM Virtual Appliance (VA) Memory (GB) Number of vCPUs NICs Disk (GB) OVF Template

Single‐Box 4 4 4 80 Core

Aggregator 3 2 1 80 Core

PassiveCollector2 1 4 8 Collector

LinuxActive+PassiveCollector 4 2 4 8 Collector

WindowsActiveDiscovery

Collector

21 120NA

NOTEVMwareprovidesWinApeinstallerinsteadofOVFtemplateforWindows2008R2(Datacenter,

Enterprise,andStandard)operatingsystemsthathoststheWinApe.

Application Discovery Manager Administration Guide

16 VMware, Inc.

SinceADM7.0doesnothaveOracledatabaseintegrated,youneedtoconfigureyourownexternalOracle

databaseasdescribedin“SettingUpOracleasanExternalDatabaseforADM”onpage 21.

Installing the vSphere Client

InstallthevSphereclienttoworkwithVMwareenvironment.

To download and install the vSphere Client

1 LaunchInternetExplorerbrowser.

2Intheaddressbar,typetheIPnumberoftheESXServerwherethevirtualmachineisinstalled,for

example:

https://ESX Server IP

3ClicktheDownloadvSphereClientlink,andthensavetheclientexecutablefiletoyourlocalharddisk.

4Runtheexecutablefile.

5AcceptthelicenseandclickNext.

6Typetheusernameandorganizationdetailsiftheydonotappearbydefault.ClickNext.

7Atthenextscreen,clickNextwithoutselectingInstallvSphereHostUpdateUtility.

8Ifdifferentfromthedefault,specifytheinstallationfolder,andthenclickNext.

9ClickInstall.

10 ClickFinishtoclosethewizard.

Disabling vMotion

To disable automatic vMotion

1InthevSphereclient,selectthecluster,right‐clickonitandselectEditSettings.

2IntheVMwareDRSsection,selectVirtualMachineOptions.

3 SelecttheADMvirtualappliances.

4 SelectDisablefromtheAutomationLevellistbox.

5ClickOK.

NOTEADMsupportsWindowsInternetExplorer6.0andlaterbrowsers.

NOTEThevSphereclientinstallationcantakeseveralminutes.

IMPORTANTADMvirtualappliancesarenotsupportedbyvMotion.IftheADMvirtualapplianceisinstalled

onaVMwareDRScluster,performthefollowingstepstodisableautomaticvMotion.

VMware, Inc. 17

Chapter 2 Installing ADM

Preparing the Environment

PerformthefollowingproceduresbeforeyousetuptheADM.

Preparing an ESX Configuration

CreateandconfigureanewvSwitchforeachphysicalspanport.Repeatthefollowingproceduresforeachnew

vSwitch.

Creating a New vSwitch for Passive Discovery

To create a new vSwitch for Passive Discovery

1 ConnectthemonitorportstoavailablenetworkinterfacesontheESXserver.

2 ConnecttotheESXserverorvCenterbyusingvSphereclient.

3 NavigatetotheConfigurationtabontheESXserverwhereyouwanttodeployADMappliances.

4 Navigatetothenetworkingconfigurationoption.

5ClickAddNetworkingtoopentheAddnetworkwizard.

6 SelectconnectiontypeasVirtualMachine,andclickNext.

7 SelectthevmnicthatisconnectedtothemonitorportonthephysicalswitchandclickNext.

8Specifyanetworklabel,forexample,spanport,forthenewportgroupandclickNext.

9ClickFinish.

Configuring the vSwitch General Settings for Passive Discovery

To configure the vSwitch general settings for Passive Discovery

1OpenthenewvSwitchPropertieswindow.

2 SelectthevSwitchandclickEdit.

3 NavigatetotheSecuritytabandchangethePromiscuousModefromRejecttoAcceptandclickOK.

4Clickthenetworkadapterstab,selecttherelevantvmnicandclickEdit.

5 ChangetheConfiguredSpeed,Duplexto10MB,FullDuplex.

6ClickOKandthenClose.

Configuring the vSwitch for Passive Collector

Connect the Passive Collector to a port group. To define a port group

1 CreateaportgroupinthevSwitchasfollows:

aLogintotheESXServerorvCenterusingvCenterClient.TheVirtualInfrastructureClientscreen

appears.

bClicktheConfigurationtab.

c SelectNetworkingfromtheHardwarelist.

dFromtheprecedingscreen,selectProperties.

e SelectPortsandclickAdd.

f SelectVirtualMachineandclickNext.

IMPORTANTPerformthefollowingstepstoconnecttovSwitchesthatspantheinternaltraffic

betweenvirtualmachinesrunningontheESXServer.

Application Discovery Manager Administration Guide

18 VMware, Inc.

gSettheNetworkLabel,forexample,ADMspanportandclickNext.

hVerifythattheportgroupislisted,andclickFinish.

2 ChangethePromiscuousModetoAccept.ThisvalueissettoRejectbydefault.

a Selecttheportgroupthatyoucreated;forexample,ADMspanport.

bClickEditandselectSecuritytab.

c SelectPromiscuousMode,andthenselectAcceptfromthelistbox.

dClickOKandthenClose.

Configuring dvSwitch for Passive Collector

IfavirtualmachineisdirectlyconnectedtothenetworkandnotthroughthevSwitch,thephysicalCollector

observesthetraffic,whilethevSwitchdoesnot.ThisistermedasVMDirectPath.

Software‐basedCiscoNexusswitchesaresupported.

ThisprocedureisrelevantonlyforvSphere4andnotforESX3.5.

To create a port group in the dvSwitch

1LogintothevCenterserverwithvCenterclient.

2ClickConfigurationandthenselectNetworkingfromtheInventorytab.

3 SelectDistributedvSwitch.

4OntheConfigurationtab,selectNewPortGroup.

5ConfiguresupportforallVLANsbyenteringthedetailsontheCreateDistributedVirtualPortGroup

windowasshowninTable 2‐2.

6ClickNexttofinishandreturntothedvSwitchNetworkConfigurationscreen.

7 SelecttheADMspanportgroupandclickProperties.

8ClicktheSecuritytabontheADMspanportPropertieswindow.

9 SelectPromiscuousMode,andthenselectAcceptfromthelistbox.

10 ClickOKandthenClose.

Deploying the Virtual Appliances

TheADMvirtualappliancecontainsandrunsoneormoreofthefollowingcomponents:

Aggregator

ActiveDiscoveryUNIX

PassiveDiscovery

“SystemArchitecture”onpage 9describestheappliancearchitecture.

PerformthefollowingproceduresbyusingaWindowsmachinewithremoteaccesstotheESXserver.

Table 2-2. VLAN Support

Parameter Value Specified

Name Anameforportgroup(ADMspanport).ThenamemustbesameasinvSwitchprocedure.

Numberofports OneforeachESXindatacenter

VLANtype VLANTrunking

VLANID 0‐4094

VMware, Inc. 19

Chapter 2 Installing ADM

Deploying the ADM Virtual Appliances

VirtualappliancesareinstalledontheESXserveraccordingtheconfigurationsinTable 2‐3.

Before You Begin

Ensureallrequirementsaremetasdescribedin“ESXResources”onpage 15.

Deployment Procedure

RepeatthefollowingstepsoneachADMvirtualappliance,excepttheWindowsCollectorthatisinstalled

separatelyasdescribedin“InstallingWindowsCollector”onpage 20:

1 DownloadtheADMvirtualappliancefilesfromVMwareWebsiteandextractthefilestoalocalfolder.

TheextractedZipfilesincludeanOVFandaVMDKfile.

TheVAfilesareinZipformatwiththefollowingnamingconvention:

OVFTemplate‐buildnumber

where:

OVFTemplateisasdescribedinTable 2‐3.

buildnumberistheADMversionandbuildnumber.

2LogintotheESXserverbyusingthevSphereclient.

3IntheFilemenu,selectDeployOVFTemplate.BrowsetotheOVFfileandselectit.

4ClickNext.TheOVFTemplateDetailsscreenappears.

5ClickNext.TheNameandLocationscreenappears.

6TypeauniquevirtualappliancenameaccordingtotheITnamingconventionofyourorganizationand

withrelevancetotheappliancetypeasdescribedinTable 2‐3.

Table 2-3. Virtual Appliance Configuration

Appliance Type OVF Template Includes Component(s)

Aggregator ADMCore Aggregator

Single‐Box ADMCore Aggregator

PassiveDiscovery

UNIXActiveDiscovery

PassiveDiscoveryCollector ADMCollector PassiveDiscovery

PassiveandActive

DiscoveryCollector

ADMCollector UNIXActiveandPassiveDiscovery

NOTEInstallaseparateWindowsCollectorusinganinstallationwizardasdescribedin

“InstallingWindowsCollector”onpage 20.YoualsoneedtoinstallandconfigureyourownexternalOracle

databaseasdescribedin“SettingUpOracleasanExternalDatabaseforADM”onpage 21.

IMPORTANTPerformanceofADMCollectorsisaffectedbydistanceandnetworklatencybetweenthe

Collectorsandobjectsbeingdiscovered.Formoreinformation,seeVMwarevCenterApplicationDiscovery

ManagerPeformanceandScalabilityGuide.

NOTEYoucandeployADMcomponentsinanyorderorevensimultaneouslybyusingthevSphereclient.

IMPORTANTEnsurethatthebuildnumberisidenticalforallappliancesdeployed.

NOTEIfanSSLCertificateWarningmessageappears,clickIgnore.

Application Discovery Manager Administration Guide

20 VMware, Inc.

7ClickNext.TheDatastorescreenappears.

8ClickNext.TheNetworkMappingscreenappears.

9ClickNext.TheReadytoCompletescreenappears.ItdisplaysdetailsabouttheOVFfile,sizefor

downloadandsizewhenextracted,virtualappliancename,hostorcluster,datastoreandnetwork

mapping.

10 ClickFinishtoconfirmthesettingsandbeginthedeployment.

11 ClickCloseinthemessagedialogboxwhendeploymentsuccessfullycompletes.

12 Repeatthisprocedureuntilallcomponentsaredeployed,andthencontinuewith“InstallingWindows

Collector”onpage 20.

Installing Windows Collector

Before You Begin

EnsurethattheWindowsmachineonwhichtheCollectorisbeinginstalledmeetstheminimumrequirements

asdescribedin“ESXResources”onpage 15.

Deployment

To deploy Windows Collector on a Windows machine

1 DownloadtheVMwarevCenterADMWindowsCollectorexecutablefilefromVMwareWebsitetoyour

localWindowsmachine.

2Double‐clicktheexecutablefile.

TheInstallShieldWizardscreenappears.

3ClickNext.TheLicenseAgreementscreenappears.

4Readthelicense,selectIacceptthetermsofthelicenseagreement,andclickNext.TheChoose

InstallationFolderscreenappears.

5Ifyouwanttochangethedefaultinstallationlocation,clickChangeandselectthepreferredinstallation

directory.

6ClickNext.TheHostInformationscreenappears.

7TypethefollowinginformationtoconfiguretheWindowsCollector:

AggregatorIPAddress

WindowsCollectoruniqueID

NOTEIfthereismorethanonedatastore,selectthedatastorewhereyouwanttoinstallthevirtual

machine.

NOTETheprocessofcopyingandconfiguringtheADMcomponentcantakeseveralminutes.The

deploymentandconfigurationstatusappearsinamessagedialogboxandtheRecentTaskspane.

NOTEIfawarningappearsaboutanunknownpublisher,clickRuntoproceed.

NOTEUsethescrollbartoviewallofthelicensetext.Ifyoudonotwanttoacceptthelicense,youwill

bepromptedtoconfirmthisbeforetheinstallationprogramcloses.

NOTEThedefaultinstallationpathis:C:\Program Files\VMware\ADM.

VMware, Inc. 21

Chapter 2 Installing ADM

8ClickNext.TheInstallationscreenappears.

9ClickInstalltobegintheinstallation.

10 ClickFinishtoclosetheInstallShieldWizardscreenwhentheinstallationprocessiscomplete.

Uninstall

To uninstall the ADM Windows Collector

1OpentheWindowsControlPanel.

2IntheControlPanelwindow,selectProgram>UninstallaProgram.TheUninstallorchangeaporgram

screenappears.

3Double‐clickorright‐clickandselectUninstalltoinitiateremovaloftheADMWindowsCollector.

4ClickFinishtoclosetheInstallShieldWizardscreenwhentheuninstallationprocessiscomplete.

Setting Up Oracle as an External Database for ADM

NOTEADM7.0doesnothaveOracledatabaseintegrated.YouneedtoinstallandconfigureOracleasaremote

database.

NOTEPerformallthefollowingoperationsonOracleserver.

Before you Begin

1EnsurethatyouhaveOracle11g(11.2.0.1)onCentOS5.

2Ensurethatyoursystemmeetsfollowinghardwarerequirements.

RAM‐4GB.

Swapspaces‐EqualtotheRAMor75%ofRAMifRAM>8GB

Freespace‐400MBin/tmpdirectory

SpaceforOracleinstallation‐1.5to3.5GB

SpaceforADMdatabasefiles‐80GB

3InstallthedatabasebyusingtheinstallationguideprovidedbyOracle.Ensurethatyouselectthe

followingrequirementswhileyouareinstallingthedatabase.

aWhenpromptedforInstallationtype,selectStandardEdition.

bWhenaskedforDatabaseSchemePasswords,selectUsethesamepasswordforallaccountsand

typepasswordasnlayers.

4Aftertheinstallationiscompleted,changethefollowingin/etc/oratab.

nlayers:/opt/oracle/app/oracle/product/11.2.0/db_1:Y

NOTEAddthecommandifitisnotalreadypresent.

NOTEThisisthesameidentifierthatwasdefinedontheAggregatorsideforWMIdiscovery.The

defaultvalueis200.

NOTETheprocessofinstallingandconfiguringtheWindowsCollectorcantakeseveralminutes.

NOTEIfyoutrytodeployADMWindowsCollectoronWindows2003R2andWindows2008R2

environment,sometimesJavaenvironmentrelatederrorsappears.ClickOKtoallthemessagesthat

appear.Thereisnoissuewiththediscoveryprocess.

NOTETheremovaloftheWindowsCollectorcantakeseveralminutes.

Application Discovery Manager Administration Guide

22 VMware, Inc.

5ItisrecommendedthatyoucreateadatabaseinstanceontheOracleserver.EnsurethattheOracleserver

isupbyrunningthefollowingcommandsontheOracleserverasanoracleuser:

$sqlplus '/as sysdba'

SQL> select name from v$database;

6 Createrequiredgroupsandusers.

aLogintotheserverasroot.

bAddanewgroup,nlayers,byrunningthefollowingcommand.

# groupadd nlayers

cAddanewuser,nlayers,byrunningthefollowingcommand.

#useradd -m -g oinstall -g nlayers -G dba nlayers

dSwitchtonlayersuserandnavigateto /home/nlayers/

eEditthe.bashrcfilebyaddingthefollowinglines:

export SENECA_HOME=/home/nlayers/Seneca

export TMOUT=1800

fEditthe.bash_profile filebyaddingthefollowinglinesafterthe#userspecificaliasesand

functionsrow:

export ORACLE_BASE=/opt/oracle/app/oracle

export ORACLE_HOME=/opt/oracle/app/oracle/product/11.2.0/db_1

export ORACLE_SID=nlayers

export TWO_TASK=nlayers

export LD_LIBRARY_PATH=${ORACLE_BASE}/product/11.2.0/db_1/lib

umask 022

PATH=${ORACLE_HOME}/bin:$PATH

export PATH

unset USERNAME

gLogintotheOracleserverasoracleandrunthefollowingcommands.

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/backup

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/archive

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/adump

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/bdump

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/cdump

$ mkdir -p /opt/oracle/app/oracle/admin/nlayers/udump

$ mkdir -p /opt/oracle/app/oracle/oradata/nlayers

hLogintotheOracleserverasrootandrunthefollowingcommands.

$ mkdir -p /var/log/nlayers/db

$ chmod -R 775 /var/log/nlayers/db

$ chown nlayers:nlayers /var/log/nlayers

To Create an ADM Instance on Oracle

1LogintotheOracleserverasoracleandnavigateto

/opt/oracle/app/oracle/product/11.2.0/db_1/bin

2 Createafile,create_nlayers_db.sql,withthefollowingcontent:

CREATE DATABASE "NLAYERS"

USER SYS IDENTIFIED BY nlayers

USER SYSTEM IDENTIFIED BY nlayers

MAXLOGFILES 5

MAXLOGMEMBERS 5

MAXDATAFILES 100

MAXINSTANCES 1

MAXLOGHISTORY 292

LOGFILE

GROUP 1 '/opt/oracle/app/oracle/oradata/nlayers/redo1.log' SIZE 10M,

GROUP 2 '/opt/oracle/app/oracle/oradata/nlayers/redo2.log' SIZE 10M,

VMware, Inc. 23

Chapter 2 Installing ADM

GROUP 3 '/opt/oracle/app/oracle/oradata/nlayers/redo3.log' SIZE 10M

DATAFILE '/opt/oracle/app/oracle/oradata/nlayers/system01.dbf' size

850m autoextend off

sysaux datafile '/opt/oracle/app/oracle/oradata/nlayers/sysaux01.dbf'

size 700M

undo tablespace undotbs

datafile '/opt/oracle/app/oracle/oradata/nlayers/undo01.dbf' size 100M

reuse autoextend on

maxsize unlimited

default temporary tablespace temp tempfile

'/opt/oracle/app/oracle/oradata/nlayers/temp01.dbf' size 100M reuse

CHARACTER SET WE8ISO8859P1;

CREATE TABLESPACE users LOGGING

DATAFILE '/opt/oracle/app/oracle/oradata/nlayers/users01.dbf'

SIZE 50M REUSE AUTOEXTEND ON MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL;

3 Navigateto:

/opt/oracle/app/oracle/product/11.2.0/db_1/dbs/

4 Createafile,initnlayers.ora,withthefollowingcontent:

*.audit_file_dest='/opt/oracle/app/oracle/admin/nlayers/adump'

*.compatible='11.2.0.0.0'

*.control_files='/opt/oracle/app/oracle/oradata/nlayers/control01.ctl',

'/opt/oracle/app/oracle/oradata/nlayers/control02.ctl','/opt/oracle/app/oracle

/oradata/nlayers/control03.ctl'

*.core_dump_dest='/opt/oracle/app/oracle/admin/nlayers/cdump'

*.db_block_size=8192

*.db_domain=''

*.db_file_multiblock_read_count=16

*.db_name='nlayers'

*.dispatchers='(PROTOCOL=TCP) (SERVICE=nlayers)'

*.job_queue_processes=10

*.log_archive_dest_1='LOCATION=/opt/oracle/app/oracle/admin/nlayers/archive'

*.log_archive_format='%t_%s_%r.dbf'

*.open_cursors=300

*.pga_aggregate_target=1073741824

*.processes=150

*.remote_login_passwordfile='EXCLUSIVE'

*.sga_target=1073741824

*.undo_management='AUTO'

*.undo_tablespace='UNDOTBS'

*.db_recovery_file_dest='/opt/oracle/app/oracle/admin/nlayers/backup'

*.db_recovery_file_dest_size=2147483648

*.utl_file_dir='/var/log/nlayers/db'

NOTEEnsurethatthehighlightedsectionofthecommandisenteredonasingleline.

5LogintotheOracleserverwithuserasoracle.

6Logintothedatabasebyrunningthefollowingcommand.

$ sqlplus / as sysdba

7InSQLPlus,runthefollowingcommands:

SQL> startup pfile=/opt/oracle/app/oracle/product/11.2.0/db_1/dbs/initnlayers.ora nomount

SQL> @/opt/oracle/app/oracle/product/11.2.0/db_1/bin/create_nlayers_db.sql

SQL> @/opt/oracle/app/oracle/product/11.2.0/db_1/rdbms/admin/catalog.sql

SQL> @/opt/oracle/app/oracle/product/11.2.0/db_1/rdbms/admin/catproc.sql

8Aftercompletion,runthefollowingqueryandensurethereturnvalueisNLAYERS.

SQL> select name from v$database;

NAME

---------

NLAYERS

9ExitSQLPlus.

Application Discovery Manager Administration Guide

24 VMware, Inc.

10 Logintothedatabasebyrunningthefollowingcommand.

$ sqlplus system/nlayers

11 InSQLPlus,runthefollowingcommand:

SQL> @/opt/oracle/app/oracle/product/11.2.0/db_1/sqlplus/admin/pupbld.sql

12 Create the remotepasswordfile.

aLogintotheOracleserverwithuserasoracle.

bRunthefollowingcommand:

$ orapwd file=$ORACLE_HOME/dbs/orapw$ORACLE_SID password=nlayers force=Y

To Configure the Oracle Listener

1LogintotheOracleserverwithuserasoracle.

2 Navigateto$ORACLE_HOME/network/admin

3 Createanewfile,tnsnames.ora,withthefollowingcontentandensurethat#DATABAS_SERVER_IP#is

replacedwiththeIPaddressofthedatabaseserver.

# Filename: tnsnames.ora

NLAYERS =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = #DATABAS_SERVER_IP#)(PORT = 1521))

)

(CONNECT_DATA =

(SERVICE_NAME = nlayers)

)

4Runthefollowingcommand:

$chmod 777 tnsnames.ora

5 Createanewfile,listener.ora,withthefollowingcontentandensurethat#DATABAS_SERVER_IP#is

replacedwiththeIPaddressofthedatabaseserver.

# Filename: listener.ora

LISTENER =

(DESCRIPTION_LIST =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))

(ADDRESS = (PROTOCOL = TCP)(HOST = #DATABAS_SERVER_IP# )(PORT = 1521))

)

6Runthefollowingcommand:

$chmod 777 listener.ora

VMware, Inc. 25

ThischapterprovidesinformationforsettinguptheADMvirtualappliancedeployments.Thischapter

includesthefollowingtopics.

“Process”onpage 25

“Post‐InstallationSteps”onpage 31

Process

AftertheADMapplianceisdeployedontheESXServer,performthefollowingprocedures:

“OrderofSetup”onpage 25.

“A D M SetupProcedures”onpage 25

“ConfiguringtheRootPassword”onpage 26

“ConfiguringStaticNetworkSettings”onpage 27

“ConfiguringtheApplianceRole”onpage 29

“UploadingaLicense”onpage 45

Order of Setup

RepeatthesetupproceduresforallADMcomponentsinthefollowingorderforallvirtualappliances:

1Aggregator

2 Collectors(Passive,ActiveandPassiveCollector)

TheWindowsCollectorissetupasdescribedin“InstallingWindowsCollector”onpage 20andtheexternal

Oracledatabaseissetupasdescribedin“SettingUpOracleasanExternalDatabaseforADM”onpage 21.

ADM Setup Procedures

Beforeyoubeginensurethatyouhaveperformedthefollowing.

1Ensureallrelevantcomponentsaredeployedasdescribedin“DeployingtheVirtualAppliances”on

page 18.

2 ObtaintherequiredinformationforeachappliancedeployedinStep 1andrecordthesevaluesasshown

inTable 3‐1.

Setting Up ADM 3

NOTEADMonlysupportsusingastaticIPaddressfortheADMvirtualmachine.

Application Discovery Manager Administration Guide

26 VMware, Inc.

Launching the First Boot Configuration Tool

RepeatthefollowingstepsforeachADMvirtualappliance:

1Whileselectingthevirtualappliance,poweritupbyeither:

clickingthetoolbaricon

right‐clickingandselectingPower>PowerOn

2Right‐clicktherelevantapplianceandselectOpenConsoletabtomonitorthisprocedure.

Theapplianceandrelevantservicesstartup.AWelcomemessagefortheADMfirstbootconfiguration

tool(wizard)appears.

3Tolaunchthetoolandconfiguretheinitialappliancesettings,typeyes.Thewizardasksyoutochange

thedefaultpassword.Youcanchangethedefaultpasswordbyfollowingtheinstructionsdescribedin

“ConfiguringtheRootPassword”onpage 26.

Configuring the Root Password

Performthefollowingproceduretochangetherootpassword.

User Name and Passwords

Passwordsmustcontainaminimumofeightcharactersanditisrecommendedtoincludethefollowing

charactertypes:

numeric

uppercase

lowercase

non‐alphanumericsuchas#or!

Table 3-1. Network Values

Parameter Value

NetworkIPaddress

Networknetmask

Networkgateway

DomainNameServer(DNS)

NOTE:YoucanenteruptothreeDomainNameServers

separatedbycomma.

FullyQualified(FQ)hostname

NOTETheWindowsActiveCollectorissetupasdescribedin“InstallingWindowsCollector”onpage 20and

theexternalOracledatabaseissetupasdescribedin“SettingUpOracleasanExternalDatabaseforADM”on

page 21.

NOTEStatusofvarioustasksappearintheRecentTaskspaneonthebottomofthevSphereClientmain

screen.

NOTEIfyoutypenofortheinitialappliancesettingsmessage,youcanruntheinitialconfigurationlaterby

runningthesystem_setupcommand.

NOTEIfyoutypenoforthechangepasswordmessage,thewizardpromptsyoutoaddnetworkinformation.

Youcanaddthenetworkinformationasdescribedin“ConfiguringStaticNetworkSettings”onpage 27.

VMware, Inc. 27

Chapter 3 Setting Up ADM

To change the root password

1TypeanewpasswordfortherootuserandpressEnter.

2RetypethepasswordandpressEntertoconfirm.Thewizardnowaskstoaddnetworkinformation,type

yes.Thewizardpromptsyoutoaddnetworkinformationandyoucanaddthenetworkinformationas

describedin“ConfiguringStaticNetworkSettings”onpage 27.

Configuring Static Network Settings

TheADMonlysupportsusingastaticIPaddressfortheADMvirtualappliance.

BeginningwiththeIPaddress,typethevaluesthatarerecordedin“A D M SetupProcedures”onpage 25,as

describedinTable 3‐2.

Ifallthenetworkinformationiscorrect,thewizardpromptsyoutosetupthetimezone.Youcansetupthe

timezoneasdescribedin“ConfiguringtheTimezoneandTime”onpage 27.

Configuring the Timezone and Time

Thispromptasksyoutosetupthetimezone,typeyes.Thewizarddisplaysthecurrenttimezoneandprompts

youtosetupthetimezonebyclickingthenumberofyourchoice.Theoptionsavailableareasfollows:

1Fromzonelist:Ifyouselect1,allpossiblezonesarelistedandyoucanenterthenumberoftimezonethat

youwanttoset.Thewizarddisplaystheselectedtimezoneandasksforconfirmation.Ifyoutypeyes,the

timezoneisselectedandamessagetosetupthelocaltimeappears.

2Manually:Ifyouselect2,amessagethatasksyoutoentermajorworldcityincontinent/cityformat

appears.EnterthedetailsaspertheformatandpressEnter.Ifthetimezoneenteredispresentinthe

database,thetimezoneisselectedandamessagetosetupthelocaltimeappears.

3ExitTimeZonesettings:Ifyouselect3,thewizardexitsthetimezoneconfigurationandamessagetoset

upthelocaltimeisdisplayed.

Formoreinformationabouttimezones,seeAppendix A,“TimeZones,”onpage 65.

Thewizarddisplaysthecurrenttimeandaskstosetupthelocaltime.Enterthecurrentdateandlocaltimein

YYYY/MM/DD‐HH:MM:SSformat,andpressEnter.

NOTEIfyoutypeno,youcanaddthenetworkinformationbyrunningthesystem_setupcommandanda

messagetosetupthetimezoneappears.Youcansetupthetimezoneasdescribedin“Configuringthe

TimezoneandTime”onpage 27.

NOTEDefaultvaluesappearinparenthesis.Someofthesevaluesmustbechangedaccordingtothefollowing

steps.

Table 3-2. Network Settings

CLI prompt Notes and Values

IPaddressTypetheIPaddress.

Netmask Typethenetmask.

Gateway Typethegateway.

DNSTypetheDNS.

HostnameFullyqualifiedhostnametobeusedbyADM,forexample

localhost.localdomain.com

Application Discovery Manager Administration Guide

28 VMware, Inc.

Thewizarddisplaysallthesettingsthatyouhavecompletedandasksforyourconfirmationtosavethe

information.Ifyoutypeyes,thewizardsavesthesettingsandthesystemstartsrebooting.Aftercompletion,

thewizarddisplaysthemessagetosettheappliancerolesetting.Youcanconfiguretheapplianceroleas

describedin“ConfiguringtheApplianceRole”onpage 29.

Installing the Oracle Client

To install the Oracle Client

1Deployandpowerontheaggregator.

2TypeNoattheappliancerolepromptandpressEnter.

3Logintothesystemwithuserasroot.

4InstalltheOracleClientasfollows.

aVersion:11.2.0.1(linux_11gR2_client.zip).

bUploadthezipfiletoADMcoremachineat/home/oracle.

cUnzipthefile.

dCopytherspfiletothecurrentfolder.

cp client/response/client_install.rsp .

eModifytherspfileasfollows:

i UNIX_GROUP_NAME=oinstall

ii INVENTORY_LOCATION=/opt/oracle/app/oracle/oraInventory

iii SELECTED_LANGUAGES=en

iv ORACLE_HOMEshouldbe/opt/oracle/app/oracle/product/11.2/client

vORACLE_BASEshouldbe/opt/oracle/app/oracle

vi oracle.install.client.installType=Administrator

fSwitchtooracleuser.

gRuntheinstaller:

./runInstaller -silent -nowait -ignoreSysPrereqs -ignorePrereq -responseFile [rsp file

location]

hSwitchbacktorootuser

iExecutethefollowingfilesaccordingtotheinstructionsfromtheinstaller

/opt/oracle/app/oracle/oraInventory/orainstRoot.sh

/opt/oracle/app/oracle/product/11.2/client/root.sh

jRunthefollowingcommands:

cp /opt/oracle/app/oracle/product/11.2/client/lib/stubs/libaio.so.1

/opt/oracle/app/oracle/product/11.2/client/lib

cp /opt/oracle/app/oracle/product/11.2/client/lib/stubs/libaio.so

/opt/oracle/app/oracle/product/11.2/client/lib

kRunthefollowingcommandandfollowtheinstructions:

role_setup

lSwitchtonlayersuser.

mGoto/home/nlayers/Seneca/db_scripts/oraclelocationandrunthefollowingscript.

./db_create.sh

NOTEIfyoutypeno,thewizarddoesnotsaveanythingandyoumuststartthesettingsfromthebeginning.

VMware, Inc. 29

Chapter 3 Setting Up ADM

Configuring the Appliance Role

ADM7.0supportstwoapplianceroles.

Aggregatorwithremotedatabase

Single‐Boxwithremotedatabase

ForCoreappliancesdeployedin“DeployingtheVirtualAppliances”onpage 18,theappliancerolechoicesare

showninTable 3‐3.

To configure the appliance role for Core

1Attheapplianceroleprompt,typethecommand:

#role_setup

2 Selecteither1or2andpressEnter.

3Performthefollowingstepsonlyonaggregatororsingle‐boxmachine:

aLogintotheserverwithuserasnlayersbyrunningthefollowingcommand:

$ su - nlayers

bRunthefollowingscripttocreatethedatabase:

#cd /home/nlayers/Seneca/db_scripts/oracle

#./db_create.sh prod

cLogoutoftheserverandloginagainasarootuser.

dRunthefollowingcommand:

# adm_control --restart all

Whenprompted,entertheIPaddressoftheexternaldatabase.

Thewizardstartsconfiguringappliancerole.Thisprocessmighttakesometime.Theapplianceroleisthen

created.

NOTESinceADM7.0doesnothaveOracledatabaseintegrated,youneedtoconfigureyourownexternal

Oracledatabaseasdescribedin“SettingUpOracleasanExternalDatabaseforADM”onpage 21.

ForCollectorappliancesdeployedin“DeployingtheVirtualAppliances”onpage 18,theappliancerole

choicesareshowninTable 3‐4.

Table 3-3. Core Appliance Roles

Select Role Configures

1 Aggregatorwith

remotedatabase

Aggregatorwithremotedatabasecontainsonlyenginethatisconnectedto

theOracledatabasewhichisrunningonaremotehost.

2Single‐Boxwith

remotedatabase

Single‐BoxwithremotedatabasecontainsCollectorsandenginethatis

connectedtoOracledatabasewhichisrunningonaremotehost.

5 Remindmelater Skipsapplianceroleconfigurationfornow.Youmustruntherole_setup

commandtosetuptheappliancerole.

Table 3-4. Collector Appliance Roles

Select Role Configures

1PassiveandActive

DiscoveryCollector

SingleCollectorforactiveandpassivediscovery

2PassiveDiscovery

Collector

ThisoptionalsoconfiguresPassiveCollectorInternal.

3 Remindmelater Skipsapplianceroleconfigurationfornow.Youmustruntherole_setup

commandtosetuptheappliancerole.

Application Discovery Manager Administration Guide

30 VMware, Inc.

To configure the appliance role for Collector

1TypeyesattheappliancerolepromptandpressEnter.

2TypetherolenumberandpressEnter.

3Ifyouselect1,youhavetoentertheCollectorIDofyourchoiceandpressEnter.Thedefaultvalueis100.

4TypetheAggregatorIPandpressEnter.

Theapplianceroleisthencreated.Thisprocessmighttakesometime.

NOTETheWindowsActiveCollectorroleisinstalledbyrunninganexecutableasdescribedin“Installing

WindowsCollector”onpage 20.

VMware, Inc. 31

Chapter 3 Setting Up ADM

Post-Installation Steps

BeforeyoulogintotheADMconsole,clearthecacheofyourbrowsertopreventthepossibleappearanceof

incorrectinformationinthedisplays,applicationerrors,andothererrormessageswhenopeningtheADM.

Active Directory Configuration

LightweightDirectoryAccessProtocol(LDAP)isaprotocolthathelpsyoutomanageinformationabout

authorizedusersonanetworksuchasnames,phonenumbers,addresses,andaccessrights.LDAPisvendor

andplatformneutralandworksacrossdifferentoperatingsystems.ExamplesofLDAPserversoftwareare

MicrosoftActiveDirectory,OpenLDAP,ApacheDirectoryserver,IBMTivoliDirectoryserver.

ADM6.2.xsupportsuserauthenticationoverLDAP.Currently,ADMcanauthorizeandauthenticateusers

createdinMicrosoftWindows2003andWindows2008ActiveDirectoryServer.

Prerequisites:VMwarerecommendshavingavalidActiveDirectoryserverwithorwithoutSSLenabledin

thesamenetworkwhereADMAggregatororSingle‐boxisdeployedforbetterperformancereasons.

To configure Active Directory

1LogintotheADMasanadministrator.

2 NavigatetoManage>System.

3ClickActiveDirectoryConfiguration.

TheActiveDirectoryConfigurationscreenappears.

4ConfigureActiveDirectory.

Table 3-5. Active Directory Parameters

5 (Optional)IfyouwantActiveDirectorycommunicationtobeencryptedusingSSL,selectEnableSSLand

typethecertificatepassword.

ThedefaultSSLcertificatepasswordischangeit.

6ClickSave.

IfActiveDirectoryconfigurationisvalid,themanagementserviceisrestarted.

AftersuccessfulActiveDirectoryconfiguration,accesstotheUIislostforfewminutesasthemanagement

servicerestarts.TheVMwarevCenterApplicationDiscoveryManagerOnlineHelpprovidesdetailedinformation

aboutaddinganActiveDirectoryuser.

NOTEAdditionalADMUIadministratorsandthemorelimitedoperatorusersarelaterdefinedbythedefault

ADMadminuser.TheVMwarevCenterApplicationDiscoveryManagerUser’sGuideprovidesmoredetails.

ForeveryupgradeofADMversion,youmustconfiguretheActiveDirectoryserver.Youshouldreconfigure

theActiveDirectoryifadatabaserestoreisperformedontheADMsetup.

Option Description

DomainName Domainnameoftheorganization.Forexample,vmware.com.

ActiveDirectoryServer NameorIPaddressoftheActiveDirectoryserver.

ActiveDirectoryPort PorttoconnecttotheActiveDirectoryserver.

Application Discovery Manager Administration Guide

32 VMware, Inc.

Logging in to the ADM Console

Afteryoucompletetheapplianceinstallation,logintothesystembyusingthebrowserandperformthe

followingsteps:

1TypetheIPaddressofthemanagementapplianceintheaddressbarandclickGo.Theloginscreen

appears.

2TypeadminintheUsernamefieldanddefaultpassword123456inthePasswordfield.

3ClickLogin.

Initiating Passive Discovery

OnlyonePassiveDiscoveryPolicyDefinitionispresentintheADM.ThefirsttimeyouuseADM,youmust

setupthepolicydefinitionandstartit.

To initiate Passive Discovery

1ClickManage,andthenselectthePassiveDiscoverymenu.

2 SelectthecomponentsonwhichADMperformsPassiveDiscoveryfromtheScopeComponentfield.

3Based

onyourselection,typetheappropriateIPinformation:

IPrange:UseNotationtotypeagroupofhostswithsimilarIPaddresses.Forexample,192.0.2.*

includesallhostswithIPsstartingwith192.0.2.Youcanalsosearchallhostsbytypinganasteriskin

eachfield.UseIPrangetoincludeagroupofhostswithinadefinedIPrange.

IP:Addasinglespecifichosttothegrouptoincludeorexcludefromthescope.

SubnetNetMask:ConfiguretheIPaddressscopebyprovidingthebasenetworkaddresswiththefull

dotteddecimalnotationforthesubnetmask,

SubnetSlashNotation:ConfiguretheIPaddressscopebyprovidingthebasenetworkaddresswith

theClasslessInter‐DomainRouting(CIDR)notationforthesubnetmask.

4ClickIncludetoincludethecomponentsinthediscoveryorExcludetoexcludethemfromit.

5RepeatStep 2throughStep 4foreachcomponentthatyouareincludingorexcludingfromdiscovery.

6Optionally,usetherulesandruletemplatestofurtherdefinethescopecriteria:

Y:InstructsADMtoincludethecomponentsinthePassiveDiscovery.

N:Excludesthecomponentsfromdiscovery.

I:Allowsyoutoignoretherule.

7Ifyouselectaruletemplate,clickthebluelinktocustomizetherule.

8ClickUpdatetosavethesettings.

9Optionally,addaPassiveDiscoveryPlan.

10 RestartPassiveDiscovery.NavigatetotheManage>Systempage,andclickRestartDiscovery.

11 ClickOKinthemessageboxthatstates:

StartinganewPassiveDiscoverydeletesallexistingdiscoverydata.Thismighttakeafewminutes.The

systemisunavailabletoallusersduringthisprocess.Continue?

12 ClickOKtobeginthediscoveryprocess.ThedashboardreappearswiththeDiscoverystatus(initially

“Discovering”)inthetopstatusbaroftheADMConsole.

IMPORTANTYoumightberequiredtouploadanewlicense.Beforeproceeding,reviewthecriteriaand

ifnecessary,performthestepsdescribedin“Licenses”onpage 45.

VMware, Inc. 33

Chapter 3 Setting Up ADM

13 YoucannowbeginusingtheADM.TheVMwarevCenterApplicationDiscoveryManagerUser’sGuide

providesanoverviewofPassiveDiscovery,andtheonlinehelpprovidesmoredetailontheactionsthat

youcanperform.

Application Discovery Manager Administration Guide

34 VMware, Inc.

VMware, Inc. 35

ThischapterprovidesinformationonsecuringADMappliance.Thischapterincludesthefollowingtopics:

“ChangingtheRootPassword”onpage 35

“ResettingtheADMRootPassword”onpage 35

“OpenSSLSelf‐SignedTestCertificates”onpage 36

“CASignedTestCertificates”onpage 36

Changing the Root Password

To change the root password

1LogintotheADMappliancebyusingaSecureShell(SSH)client.

2Runthepasswdcommand:

aThewizardaskstoenteranewpassword.

bRetypethepassword.

Ifboththepasswordsmatch,thepasswordischangedandallauthenticationtokensgetsupdated.

Resetting the ADM Root Password

To reset the ADM root password

1UsingtheVMwarevSphereclient,startorrestartthevirtualmachine.

2Afterthevirtualmachinerestarts,clickanykeyintheconsolewindow.

Thebootscreenappears.

3PressetoentertheGRUBbootmenu.

TheGNUGRUBloaderscreenappears.

4 Highlight(2.6.24.7‐9.smp.pae.gcc3.4.x86.i686),andpresse.

5 Selectthekernellineandpressetoedittheentry.

Securing ADM 4

NOTEIfyoudonotclickanykeyintheconsolewindowimmediatelyafterthevirtualmachinerestarts,

youmustrestartthevirtualmachineandperformstep2again.

Togiveyouadditionaltimewhenclickingakeyintheconsolewindow,youcanmanuallyaddalineto

theVMXfile.AddingthelinetothefilecausestheBIOStodelay.Forexample,tocausea10seconddelay,

powerdownthevirtualmachine,opentheVMXfileinatexteditor,typethefollowinglineintheVMX

file:

bios.bootDelay="10000"

Application Discovery Manager Administration Guide

36 VMware, Inc.

6Placeyourcursorattheendofthelineandappendthelinebytyping:

single

7PressEntertocommitthechange.

8Pressbtostartthesystem.

Yoursystemstartswithoutrequiringapassword.

9Typethefollowingcommandtoresetthepassword:

passwd

10 Followthepromptsastheyappearonthescreentosetthepassword.

11 Typethefollowingcommandtorestartthesystem:

reboot

Yourpasswordischangedandrestartsthesystem.

OpenSSL Self-Signed Test Certificates

TheVMwarevCenterApplicationDiscoveryManagerdefaultinstalledcertificateiscreatedduringthe

installationandisvalidforoneyeartousetheapplianceuntilyouacquirealocalCertificateAuthority(CA).

Public‐facingsecureWebsitesmustuseathird‐partyCA.Ifyouwanttousetheapplianceintestenvironment

andthendeploythatappliancetoaproductionenvironment,youmustnotchangethehostnameastheADM

doesnotsupportchangingthehostname.Instead,youcansetupanaliasintheDNStoresolvetheappliance

hostname.

CA Signed Test Certificates

TocreateCAsignedcertificates,youmustgenerateacertificaterequestfile(csr).Thecertificaterequestfile

providesdetailsabouttherequesterofthecertificateandthecertificateissignedbytheprivatekeyaboveto

yourtrustedcertificateauthority.

Createthecertificaterequestbytyping:

openssl req -new -key server.key -out server.csr

FillintheX.509attributesasspecifiedpreviously.FormoredetailsconsultyourCA.

ToinstallthecertificateprovidedbyyourCA,performthestepsdescribedin“Copyingthe.keyand.crtFiles”

onpage 37.

FreeCAproviders,ashttp://www.cacert.orgexist.

Self-Signed Certificates

Useself‐signedcertificatesonlyinthetestenvironments,orwhereonlyalimitednumberofconnectionsis

established.Forexample,peer‐to‐peerrelationshipscanbeacustomVPNorAS2linkbetweentwocompanies,

orbetweentwodifferentsitesofthesamecompany.Self‐signedcertificatesbecomeimpracticalasthenumber

ofcertificatesnecessarytomanagegrowslinearlywiththenumberofpeeringrelationships.AlocalCA,while

morecomplextosetup,reducesthenumberofkeysrequiredtobedistributedforverification,andreplicates

areal‐worldcertificateenvironment.ACAcancostlesstomanagethanhundredsorthousandsofindividual

certificatesoneachpeersystem.

Certificatecreationrequirestheopensslutility.TheopensslutilityislocatedintheADMappliancefolder.

/usr/bin/openssl

NOTEYoucanalsoresettheADMrootpasswordbyrunningsystem_setupcommand.

NOTEDonotusetheself‐signedcertificatesinproductionenvironments.

VMware, Inc. 37

Chapter 4 Securing ADM

To create a certificate

1TogeneratetheRivest,Shamir,andAdleman(RSA)keytype:

cd /etc/httpd/conf/ssl.prm/

openssl genrsa 2048 > server.key

chmod 400 server.key

TheopenSSLutilitycangenerateaDigitalSignatureAlgorithm(DSA)keybyusingthegendsaoption.

Forcompatibility,VMwarerecommendsRSAkeysbyusing2048‐bitsasthekeysize.

2 Createthecertificatebytyping:

openssl req -new -x509 -nodes -sha1 -days 365 -key server.key > server.crt

The-new,-x509,and-nodesargumentsarerequiredtocreateanunencryptedcertificate.The-days

argumentspecifiesthelengthoftimethecertificateisvalid.

Forencryptedcertificates,everytimeyouarerequiredtotypethepassworduntilthekeyisloaded.

YoucanaskquestionstocompleteX.509attributescertificate.Adjusttheanswerstoyourlocalsettings.If

frequentlytyped,youcanupdatethesystemopenssl.cnffile(inthe/usr/share/ssl/directory)withthe

correctdefaults.

Table 4‐1listsX.509attributesamplepromptsandanswers.

Forwebservices,thecommonnamefieldmustexactlymatchthehostname(orVIPname,forhostsassociated

withaloadbalancer)ofthesystemcertificateisusedon;otherwise,acertificatetohostnamemismatchcan

occur.Inpeer‐to‐peersetupsforAS2,thisfieldcanusuallybesettoadescriptivestring.

Thecertificatedataintheserver.crtfilemustbetransferredtoallclientsystemsthatneedtoverifythekey

oftheservertowhichitisconnected.Ifthismethoddoesnotscale,setupaCA,anddistributethesigning

certificatetotheclientsinsteadofeachself‐signedcertificate.Optionally,youcanextractthemetadata.

Copying the .key and .crt Files

Typethefollowingcommandstocopythe.keyand.crtfiles:

cp server.crt /etc/httpd/conf/ssl.crt

cp server.key /etc/httpd/conf/ssl.key

Tomakethecertificateeffective,restarttheApacheservicebytyping

adm_control.pl --restart apache

NOTEInmostcases,encryptedcertificatesarenotworththeoperationalburden,aseachprocessrestart

orsystemrestartrequiresyoutomanuallytypeapassword.

Table 4-1. X.509 Sample Prompts and Answers

Prompt Answer

Countryname(2lettercode)[AU]: US

Stateorprovincename(fullname)[Some‐State]: Massachusetts

Localityname(eg,city)[]: Boston

Organizationname(forexample,company)[InternetWidgitsPtyLtd]: YourCompanyOrg

Organizationalunitname(forexample,section)[]: ‐

Commonname(forexample,YOURname)[]: hostname.domain

E‐mailaddress[]: postmaster@yourcompany.org

Application Discovery Manager Administration Guide

38 VMware, Inc.

VMware, Inc. 39

ThischapterdescribesthenecessaryconceptsandprocedurestomaintainanADMdeployment.Thischapter

includesthefollowingtopics:

“A D M Services”onpage 39

“ProductSupportPackages”onpage 40

“RestoringanADMEnvironmentbyUsingaProductSupportPackage”onpage 42

“Licenses”onpage 45

ADM Services

Table 5‐1describesthemainADMservices.

Managing Services with adm_control

ADMprovidestheadm_control.plscripttostart,stop,andmonitorADMservices.Youcanstartorstopany

service,butifyoustopanyservicealldependentservicesarestoppedasaresult.Alldependentservicesis

listedduringthestopprocess.Table 5‐2listsanddescribesthecommandsfortheADMservices.

Maintenance 5

Table 5-1. ADM Services

Service name Description

apache Webserverservice.

active_probe ServiceresponsibleforperformingDetailDiscoveryandrunsonLinuxCollectorsandtheWindows

virtualmachine.Thisserviceperforms:

WMI‐baseddiscoveryontheWindowsCollector

SSH‐,SNMP‐,VI‐SDK‐,andTelnet‐baseddiscoveryontheUNIXCollector

engine ThecoreofADMandincludesthefollowingcomponents:

Userinterface

Management

Reconciliations

Analytic

listener ServiceresponsibleforthePassiveDiscoverymechanisms.

vnc PhysicalIBMCollectorsonly.

ThevncserviceenablesVNCaccesstotheWindowsinstancesothattheIPaddresscanbeconfigured.

vmware PhysicalIBMCollectorsonly.

TheWindowsinstanceontheapplianceisinstalledonavirtualmachine.Thevmwareservicestarts

VMwaresothattheWindowsinstancecanstart.

watchdog Servicethatmonitorsthehealthoftheotherservices.Ifanotherservicehasaproblem,watchdog

servicetriestoidentifytheserviceandresolvetheproblem.

Application Discovery Manager Administration Guide

40 VMware, Inc.

ServicenameisanameofServicedefinedinTable 5‐1.

To run an adm_control.pl command

1Logintotheapplianceasuserroot.

2Typetheadm_control.plcommandasdemonstratedinTable 5‐2,forexample:

adm_control.pl --stop all

AllservicesthatarelistedinTable 5‐1stop.

Product Support Packages

Createtheproductsupportpackagestobackup,restore,ortroubleshoottheADM.

Productsupportpackagescontainareal‐timecaptureoftheADMdatabase,configurationfiles,customization

files,andlogs.Table 5‐3describesthefilestheproductsupportpackagecontainsanditsuse.

VMwarerecommendsthatyoucreateandsaveasupportpackagepriortoperforminganymaintenance

procedures,suchasanupgrade,restore,andfreshinstallationsorbeforecontactingVMwareCustomer

Support.

SupportpackagesarebackupsoftheADMandrelevantconfigurationfiles.Thesepackagescontain

troubleshootinglogfilesandareusedtorestoreyourADMenvironment.

Table 5-2. ADM Service Commands

Use the Following Command To

adm_control.pl --status <service name> DisplaythestatusoftheADMservice.

adm_control.pl --stop <service name> StoptheADMservice.

adm_control.pl --start <service name> StartastoppedADMservice.

adm_control.pl --restart <service name> StopandrestarttheADMservice.

adm_control.pl --help Displayallofthecommandoptions.

adm_control.pl --command all Applythecommandtoallservices.

NOTEEveryappliancehasonlyrelevantservicesstartedandalltheothersaredisableddependingontherole.

Table 5-3. Product Support Packages Files and Uses

File Use

Databasedata BackupandrestoreoftheADMdatabase.

ActiveProbeandPassiveListenerdefinitionfiles BackupandrestoreoftherequiredADMconfigurations.

DetaildiscoveryandPassiveDiscoveryfingerprints BackupandrestoreofthecustomADMconfigurations.

Logs Troubleshooting.

Licensefile Serialnumberusedformanagedserverhost.

VMware, Inc. 41

Chapter 5 Maintenance

YoucancreatesupportpackageseitherthroughtheADMConsoleorthroughtheCommandLine

Interface (CLI).

Using the ADM Console

UsetheADMConsoletocreateaproductsupportpackageinanSingle‐boxsetupdeploymentandtocreatea

productsupportpackagefortheAggregatorinanytypeofADMdeployment.Chapter 2describesthe

differentADMdeploymentoptions:

1LogintotheADMConsole.

2 NavigatetoManage>System>CreateProductSupportPackage.

3 WaitforafewminutesandthenrefreshthepagetoseeiftheStatushaschangedfromPendingtoSuccess.

4ClicktheappropriateproductsupportpackageZipfiledisplayedinthetableanddownloadit.

Bydefault,thefilenamesarelistedfromthemostcurrentbackdate.EachproductsupportpackageZip

filenameincludestheADMdatabaseschemaversion,date,andtimestampforeasyrecognition.

5ClickSave.

Using the CLI

UsetheCLItocreatesupportpackagesforeachcollectorordatabaseinadistributedADMdeployment,orfor

theAggregator,database,orSingle‐BoxdeploymentwhentheAggregatorisnotavailablethroughtheADM

Console.Chapter 1describesthedifferentADMdeploymentoptions:

1LogintotheCollectororAggregatorapplianceasuserroot.

2 Changethedirectorytothe/home/nlayers/Seneca/management/APIsdirectory.

3Typethefollowingcommand:

./InSight_control.sh supportpackage --get --output filename

filename.zip is created at the same location.

4CopyandsavethezipfilefromtheADMappliancetoadifferentlocation.

NOTEProductsupportpackagesrequireapasswordforextraction.ContactVMwareCustomerSupportto

retrievethepasswordifyouusetheproductsupportpackagetorestoreADMortheADMdatabaseas

describedin“RestoringanADMEnvironmentbyUsingaProductSupportPackage”onpage 42.

CAUTIONRe‐imagingremovesallfiles(includingthesupportpackage)fromtheappliance,sosavethe

supportpackageelsewhere.

NOTETheUIoptionisrelevantonlytotheapplianceswithAggregatorcomponent.

NOTEBydefault,theADMsavestheproductsupportpackagesonlyforsevendays.Ensuretosaveto

theproductsupportpackagetoanotherlocationifyouwanttosavetheinformationforlongerduration.

NOTELogintotheAggregatortocreateabackupoftheADMdatabase.Youarenotrequiredtologinto

theremotedatabaseappliancetocreateabackupofthedatabasefiles.

NOTEEnsuretosavetotheproductsupportpackagetoanotherlocationifyouwanttosavethe

informationforlongerduration.TheADMsavesthepackageonlyforsevendaysifyouselectthedefault

location.

Application Discovery Manager Administration Guide

42 VMware, Inc.

Restoring an ADM Environment by Using a Product Support Package

To restore an ADM configuration

1 BackupyourADMenvironmentasdescribedin“ProductSupportPackages”onpage 40.

2ContactVMwareCustomerSupporttoretrievethepasswordforextractingtheproductsupportpackage.

3Followthestepsin“RestoretheADMDatabase”onpage 42.

4Ifnecessary,“RestoringtheCustomDiscoveryandConfigurationFiles”onpage 43.

Restore the ADM Database

ThefollowingstepsdescribesrestorationoftheADMdatabaseinanSingle‐Boxanddistributeddeployment.

Chapter 1describesthedifferentADMdeploymentoptions:

1LogintotheAggregatororSingle‐Boxapplianceasuserroot.

2 Createatemporarydirectory:

mkdir supportpackagedir

3CopythesupportpackageintothetemporarydirectorythatyoucreatedinStep 2.

4Extractthesupportpackageintothetemporarydirectory:

unzip support_package__version_date_and_timestamp.zip

whereversion_date_and_timestampistheuniqueidentifierofthepackage.

5Whenpromptedforthepassword,typethepasswordyouretrievedfromVMwareCustomerSupport.

6Afterextractioncompletes,copythedatabasebackupfile:

supportpackagedir/supportpackage/backup.db_dump-main-db_schema_build-db_dump.gz

wheredb_schema_buildisthedatabaseschemaversionandbuildnumber.

7Placethecopiedfileinthefollowingdirectory:

/home/nlayers/Seneca/db_scripts/oracle

8Typethefollowingcommandtostoptheengineservice:

/adm_control.pl --stop engine

9Typethefollowingcommandtoswitchtothenlayersuser:

su - nlayers

10 Changedirectoryto:

cd /home/nlayers/Seneca/db_scripts/oracle

11 Logintotheserveruserasnlayersandcreatethedatabaseentitiesbyrunningthefollowingcommands:

cd ~nlayers/Seneca/db_scripts/oracle

./db_create.sh prod

12 Typethefollowingcommandtorestorethedbbackup:

./db_restore.sh backup.db_dump-main-db_schema_build-db_dump.gz prod

IMPORTANTIfyouaremigratingtoanewappliance,followtheinstructionsin“MigratingtoaNew

Appliance”onpage 51.

NOTEInthefollowingsections,thedirectoryinwhichtheproductsupportpackagefilesareextractedis

calledassupportpackagedir.

NOTEInadistributeddeploymentthedatabaseisrestoredthroughtheAggregator.Inasplitsetupwith

remotedatabase,databaseisrestoredontheDatabasemachine.

VMware, Inc. 43

Chapter 5 Maintenance

wheredb_schema_buildisthedatabaseschemaversionandbuildnumber.

13 Exitfromthenlayersuser.

14 Typethefollowingadm_control.plcommandtostarttheservices:

/home/nlayers/Seneca/Control/bin/adm_control.pl --start all

Restoring the Custom Discovery and Configuration Files

ADMcustomconfigurationfilescontainrestoreinformationforPassiveDiscoverycustomfingerprints,

PassiveDiscoverycustomconfiguration,DetailDiscoverycustomfingerprints,andDetailDiscoverycustom

configuration.

To restore the custom discovery and configuration files

1LogintotheCollectororSingle‐Boxsetupasuserroot.

2 Createatemporarydirectory:

mkdir supportpackagedir

3CopythesupportpackageintothetemporarydirectoryyoucreatedinStep 2.

4Extractthesupportpackageintothetemporarydirectory:

unzip support_package__version_date_and_timestamp.zip

whereversion_date_and_timestampistheuniqueidentifierofthepackage.

5Whenpromptedforthepassword,typethepasswordyouretrievedfromVMwareCustomerSupport.

6Copyallfilesfrom:

supportpackagedir/supportpackage/listener/custom/conf

7Placethecopiedfilesto:

/home/nlayers/Seneca/probe

8Copyallfilesfrom:

supportpackagedir/supportpackage/listener/custom/kb

9Placethecopiedfilesto:

/home/nlayers/Seneca/probe/resources

10 Copyallfilesfrom:

supportpackagedir/supportpackage/active_discovery/custom/conf

11 Placethecopiedfilesto:

/home/nlayers/Seneca/ActiveProbe/conf

12 Changedirectoryto:

/home/nlayers/Seneca/management/APIs

13 Typethefollowingcommand:

NOTEThedatabaserestoreprocesscantakeupto30minutes.

NOTEIftheADMconfigurationbeingrestoredhascustomconfigurationfilesorfingerprints,youmust

completethestepsoutlinedin“RestoringtheCustomDiscoveryandConfigurationFiles”onpage 43.

IMPORTANTFordistributedsolutionsonly:ThecustomfilesmustresideontheCollectorappliance.In

thiscasecompletethefollowingstepsoneachCollectorinthedeployment.

Ifthefeaturecanbecustomized,the./custom/*directorycontainsthefiles.Ifthedirectoryisempty,no

customizationfilesareassociatedwiththefeature.

Application Discovery Manager Administration Guide

44 VMware, Inc.

./InSight_control.sh adkb --checkout /tmp

14 Copyallfilesandsubdirectoriesfrom:

supportpackagedir/supportpackage/active_discovery/custom/kb/custom

VMware, Inc. 45

Chapter 5 Maintenance

15 Placethecopiedfilesto:

/tmp/adkb/custom

16 Overwriteanyfilesorfoldersinthedestinationdirectoryifpromptedtodoso.

17 Typethefollowingcommandtocheckinthecustomfingerprints:

/home/nlayers/Seneca/management/APIs/InSight_control.sh adkb --checkin /tmp

18 Typethefollowingadm_control.plcommandtorestarttherelevantservices:

/home/nlayers/Seneca/Control/bin/adm_control.pl --restart all

Licenses

Youmustrenewthelicenseswhen:

reachingtheexpirationdate

expandingthecustomer‐discoverednetworkscope.

Thisprocedureforuploadinganewlicensemustbeperformedfollowingeach:

initialinstallation

migrationofADMfor7.0.0release.

upgradefromADM6.0.x

ItisnotnecessarytoperformthisprocedurewhenupgradingfromADM7.0.0version.

AccesstheLicensesPropertiesscreenfromtheManage>System>LicensingmenuintheADMUIthat

displaysthelicenseinformation,whichincludesthelicensedfeature,quantityofavailablelicenses,andexpiry

date.

TheappropriatewarningmessageappearsontheDashboard,InventoryandLicensePropertiespage.An

ADMUIadministratorcanlogintoreviewlicenselimitationsanduploadnewlicensesasrequired.

Uploading a License

Performthefollowingproceduretouploadalicense.

1LogintotheADMUIasanadminuser.

2 NavigatetotheManage>SystemscreenandclickLicensing.TheLicensePropertiesscreenappears

3ClickUploadanewLicense.TheUploadanewlicensescreenappears.

4EntertheserialnumberandclickApply.Iftheserialnumberisvalid,theserialnumberisuploadedand

LicensePropertiespageisdisplayed.

NOTEDistributeddeployment:RepeatStep 1throughStep 18foreachcollectorintheADM

deployment.

IMPORTANTBeforeyoubegin,obtaintheserialnumberformanagedserverhost.

Application Discovery Manager Administration Guide

46 VMware, Inc.

VMware, Inc. 47

ThischapterdescribesthenecessaryconceptsandprocedurestoupgradeanADMdeployment.Thischapter

includesthefollowingtopics:

“Overview”onpage 47

“UpgradingAppliances”onpage 48

“Post‐UpgradeSteps”onpage 49

Overview

Thefollowingconsiderationsapplyforapplianceupgradesandmigration.

Mixed Environments

Somesitescanhaveacombinationofphysicalandvirtualappliances.Youmustupgradethemtothesame

ADMversionbyusingtheproceduresdescribedin“UpgradingAppliances”onpage 48.Formore

informationaboutmixedenvironment,see“MixedEnvironment”onpage 12.

Licenses

YouneedanewlicensetouseADMafterupgradingfrom6.0.X.ObtainthelicensefromyourVMwareSales

representative.“Licenses”onpage 13providesmoreinformation.

Appliance Migration

Chapter 7describesproceduresformigrationtovirtualappliances.

Backing Up Data

Backupthedatatopreventlossduringthemigrationandupgradeprocess.“ProductSupportPackages”on

page 40describesbackupandrestoreprocedures.

Upgrading ADM 6

Application Discovery Manager Administration Guide

48 VMware, Inc.

Upgrading Appliances

ThissectiondescribestheupgradingofApplicationDiscoveryManagerversion6.2.xorlaterforvirtual

appliances.

Important Notes

AllappliancesinyourcurrentenvironmentmustrunADMversion6.2.xorlater.Also,upgradeall

appliancestothesameADMversion.BeforeupgradingtheADM,familiarizeyourselfwith“Overview”

onpage 47.

Fordistributedsolutions,performtheupgradesinthefollowingorder:

a Collectors

bAggregator

Repeatthefollowingproceduresforallappliancesandarchitecturesolutions,unlessotherwiseindicated.

Preliminary Procedures

1 Backupyourdataasdescribedin“ProductSupportPackages”onpage 40(performedonAggregatoror

Single‐Boxapplianceandcollectorsifcustomfingerprintsexists).

2Logintotheappliance,openanSSHsession,andrunthefollowingcommandtomonitortheprogressof

theupgrade:

tail -f /var/log/nlayers/update.log

ThisSSHsessionisinadditiontoanyothersessionopenedforthepurposeofupgrading.Thescriptalso

printssuccessorfailuremessagesalongwithotherusefulinformationtostdout.

3PerformallupgradesbyusingtheCLIproceduresasdescribedin“UpgradingAppliancesUsingCLI”on

page 48.

Upgrading Appliances Using CLI

To upgrade Aggregator or Single-Box appliances by using CLI

1Followtheinstallationprocedureofdeployingandconfiguringnewaggregatororsingleboxappliance.

2Restoreyourdatabaseandothersettingsasdescribedin“RestoringanADMEnvironmentbyUsinga

ProductSupportPackage”onpage 42.

To upgrade Collector appliances by using CLI

1 Downloadtheupdate_runner.plandInSightUpdate-version.updfilesfrom

http://downloads.vmware.com/ApplicationDiscoveryManagerinto:

/home/nlayers/rpms

2 Changefileaccess:

chmod 744 update_runner.pl

NOTEADM7.0.0usesonlyaremotedatabase.Youcannotupgradeyoursystemwithoutbackingupyour

data.

NOTEUsetheearliernetworksettingstoconfigurethenewaggregatororsingleboxappliance.Refer

“NetworkSettings”onpage 27.

NOTEItisrecommendedtocreateadirectorycorrespondingtoversionyouareupgradingtointherpms

directoryanddownloadthefilestothecreateddirectory.Forexample,ifyouareupgradingto6.xversion

createadirectorynamedversion6.x.

VMware, Inc. 49

Chapter 6 Upgrading ADM

3UpgradeVMwareADMservices:

./update_runner.pl -u -f InSightUpdate-version-build.upd

4 Waitfortheupgradetocomplete.Fordistributedsolutions,repeattheupgradeproceduresforall

remainingappliancesasdescribedin“UpgradingAppliances”onpage 48.

5Proceedwith“Post‐UpgradeSteps”onpage 49.

Post-Upgrade Steps

BeforeyoulogintotheADMconsole:

Clearthecacheofyourbrowsertopreventthepossibleappearanceofincorrectinformationinthedisplays,

applicationerrors,andothererrormessageswhenopeningtheADM.

YoucannowbeginusingtheADM.

NOTETheupgradeprocesscantakeseveralminutestocomplete.YoucannotaccesstheADMConsole

whiletheupgradeisinprogress.

NOTEWinApeisupgradedaspartofaggregatorupgradeandyouarenotrequiredtoupgradeit

separately.

IMPORTANTYoumightberequiredtouploadanewlicenseifyouareupgradingfrom7.0.0.Before

proceeding,reviewthecriteriaandifnecessary,performthestepsdescribedin“Licenses”onpage 13.

Application Discovery Manager Administration Guide

50 VMware, Inc.

VMware, Inc. 51

ThischapterprovidesinstructionsonmigrationofanexistingphysicalorvirtualADMappliancetoavirtual

appliancesuppliedbyVMware.Thischapterincludesthefollowingtopics:

“Overview”onpage 51

“PreliminaryProcedures”onpage 52

“DataRestoration”onpage 53

“Post‐MigrationSteps”onpage 54

Overview

Additionaldocumentationasdescribedbelowisavailableathttp://downloads.vmware.com/

Supported Migration

AppliancemigrationissupportedfromADM6.0.x.Upgradeearlierversionstothelatest6.0.xversionbyusing

theproceduresdescribedinthe“UpgradingADM”onpage 47.

Licenses

YouneedanewlicensetouseADMaftermigratingtoanewappliance.ObtainthelicensefromyourVMware

Salesrepresentative.Moreinformationisprovidedin“Licenses”onpage 13.

System Architecture

Detaileddescriptionsareprovidedin“SystemArchitecture”onpage 9.Migrationstepsdifferfordifferent

appliancesetups:

Single‐Box

Distributed

Distributedwithremotedatabase

Migrating to a New Appliance 7

NOTEPartoftheupgradeproceduretoADM6.0.xcanincludeupgradingcustomfingerprintscreatedin

earlierversion.AdditionalinformationonfingerprintsisavailableintheVMwarevCenterApplicationDiscovery

ManagerFingerprintDevelopersGuide.

IMPORTANTThenewvirtualappliancesolutionsfeatureseparatevirtualappliancecomponentsfor

Collectors,Database,andtheAggregator.Initialsetupanddatarestorationisthereforeperformed

separatelyforeachcomponent.

Application Discovery Manager Administration Guide

52 VMware, Inc.

MigrateorupgradeallappliancestothesameADMversioninthefollowingorder:

1Remotedatabase(forDistributedwithremotedatabasesolution)

2 Collectors(forallDistributedsolutions)

3Aggregator

Process

Themigrationprocessisasfollows:

1Recordthecurrentappliancenetworksettingsasdescribedin“A D M SetupProcedures”onpage 25.

2 Backupyourdataasdescribedin“ProductSupportPackages”onpage 40.

3 BackupUNIXCollectorsifcustomfingerprintsexist.

4 BackupWindowsCollectorfingerprintsasdescribedin“BackingUpWinApeMigrationFiles”onpage 52

andshutdownalloldappliances.

5Installanddeploythenewvirtualapplianceasdescribedin“DeployingtheVirtualAppliances”on

page 18.

6RestarttheapplianceandperforminginitialsetuptasksasdescribedinChapter 3.

7RestoreUNIXCollectorfingerprints.

8RestoreWindowsCollectorfingerprintsasdescribedin“RestoringWinApeMigrationFiles”onpage 53.

Preliminary Procedures

Forallsolutions,backupfilesareneededforWinApemigrationtoanothercomputerasshownintable

Table 7‐1.

ThefollowingtabledescribestheWinApemigrationsfiles.Forvirtualappliance,thedefaultlocationis

C:\Program Files\VMware\ADM.Forphysicalappliance,thedefaultlocationisC:\Program

Files\nLayers\InSightActiveDiscovery.

Backing Up WinApe Migration Files

1LogintotheWinApeappliance.

2 NavigatetothefolderwhereWinApeisinstalled.

3 Createthebackupofadkbcustom.jarfilepresentin\lib\javafolder.

IMPORTANTThebackupproceduresinvolvecopyingcustomADMfiles.Ensurethatthefilesmaintain

theoriginalnLayersownershipaftercopying.Editingthefilesasrootmightchangetheownershipofthe

files.

CAUTIONBackupofexistingdataisessentialtopreventdatalossduringthemigrationprocess.

Table 7-1. WinApe Migration Files

File Remark

\lib\java\adkbcustom.jar Always

NOTEYoucanonlymanuallybackuptheWinApemigrationfiles.

VMware, Inc. 53

Chapter 7 Migrating to a New Appliance

Restoring WinApe Migration Files

ThefollowingproceduresdescribestherestorationofWinApemigrationfiles.

1LogintotheWinApeappliance.

2Copytheadkbcustom.jar backupfile.

3 Navigatetothe\libfolder.

4Replacethecurrentfilein\libfolderwiththecopiedfile.

5Runtheservices.msccommand.

6RestarttheserviceVMwarevCenterADMWindowsCollector.

Data Restoration

ThissectionprovidesinformationaboutdatarestorationforSingle‐Box,distributed,anddistributedwith

remotedatabasesolution.

Single-Box Solution

1RestoretheADMdatabaseasdescribedin“RestoringanADMEnvironmentbyUsingaProductSupport

Package”onpage 42.

2Restorethecustomdiscoveryandconfigurationfilesasdescribedin“RestoringtheCustomDiscovery

andConfigurationFiles”onpage 43.

3ForWinApe,firstcreatethebackupasdescribedin“BackingUpWinApeMigrationFiles”onpage 52and

thenrestoreitasdescribedin“RestoringWinApeMigrationFiles”onpage 53.

Distributed Solutions

Thesestepsapplytodistributedsolutionswithoutaremotedatabase.Performthefollowingstepsonall

appliancesinthefollowingorder:Collectors,WinApe,andAggregator.

Collectors

RepeatthefollowingstepsforeachCollectorappliance:

1LogintotheCollectorvirtualappliance.

2Restorethecustomdiscoveryandconfigurationfilesasdescribedin“RestoringtheCustomDiscovery

andConfigurationFiles”onpage 43.

WinApe

RepeatthefollowingstepsforeachWindowsappliance:

1LogintotheWinApeappliance.

2 BackuptheWinApemigrationfilesasdescribedin“BackingUpWinApeMigrationFiles”onpage 52.

3RestoretheWinApemigrationfilesasdescribedin“RestoringWinApeMigrationFiles”onpage 53.

NOTEBackupyourADMenvironmentasdescribedin“BackingUpWinApeMigrationFiles”onpage 52.

Application Discovery Manager Administration Guide

54 VMware, Inc.

Aggregator

1LogintotheAggregatorvirtualappliance.

2RestoretheADMdatabaseasdescribedin“TroubleshootingADMbyUsingtheProductSupport

Package”onpage 56.

3MakethenecessarychangesintheActiveprobeconfigurationscreenundertheManage>Systemmenu

oftheADMconsoletoreflectthenewcollectorappliance.TheVMwarevCenterApplicationDiscovery

ManagerUser’sGuide.

Distributed Solution with Remote Database

Thesestepsapplytodistributedsolutionswitharemotedatabase.Performthefollowingstepsonall

appliancesinthefollowingorder:Collectors,WinApe,database,Aggregator.

Collectors

RepeatthefollowingstepsforeachCollectorappliance:

1LogintotheCollectorvirtualappliance.

2Restorethecustomdiscoveryandconfigurationfilesasdescribedin“RestoringtheCustomDiscovery

andConfigurationFiles”onpage 43.

WinApe

RepeatthefollowingstepsforeachWindowsappliance:

1LogintotheWinApeappliance.

2 BackuptheWinApemigrationfilesasdescribedin“BackingUpWinApeMigrationFiles”onpage 52.

3RestoretheWinApemigrationfilesasdescribedin“RestoringWinApeMigrationFiles”onpage 53

Database

1Logintothedatabasevirtualappliance.

2RestoretheADMdatabaseasdescribedin“RestoringanADMEnvironmentbyUsingaProductSupport

Package”onpage 42.

Aggregator

1LogintotheAggregatorvirtualappliance.

2MakethenecessarychangesintheActiveprobeconfigurationscreenundertheManage>Systemmenu

oftheADMconsoletoreflectthenewcollectorappliance.TheVMwarevCenterApplicationDiscovery

ManagerUser’sGuide.

Post-Migration Steps

BeforeyoulogintotheADMconsole:

Clearthecacheofyourbrowsertopreventthepossibleappearanceofincorrectinformationinthedisplays,

applicationerrors,andothererrormessageswhenopeningtheADM.

YoucannowbeginusingtheADM.

NOTEADMdefaultgroupsdoesnotgetrefreshedduringtheupgrade.TheManagementchapterofthe

VMwarevCenterApplicationDiscoveryManagerUser’sGuideprovidesmoreinformationongroups

administration.

VMware, Inc. 55

ThischapterprovidesinstructionsontroubleshootingoftheADM.Thischapterincludesthefollowingtopics:

“TroubleshootingADMInstallation”onpage 55

“TroubleshootingADMbyUsingtheProductSupportPackage”onpage 56

“TroubleshootingErrorMessagesDuringWMIDiscovery”onpage 56

“DetailDiscoveryTroubleshooting”onpage 56

Troubleshooting ADM Installation

InADM7.0.0,youneedtoconfigureyourownexternalOracledatabaseasdescribedin“SettingUpOracleasan

ExternalDatabaseforADM”onpage 21.Theinstallationmightfailduetodatabaseconnectionproblems.You

mustensurethattheexternaldatabaseisworkingandthatADMcanconnectit.

To troubleshoot the database machine

1OntheOracledatabasemachine,logintotheserverasuseroracle.

2OpenSQLPlusandlogintothedatabaseasusersys.

3Runthefollowingquery:

Select 1 from dual;

Thequeryresultisdisplayed.Ifthequeryfailsandtheresultisnotdisplayed,performthefollowingsteps:

1Ensurethatthedatabaseisrunning.

2Ensurethatthelistener.orafileisconfiguredasdescribedin“SettingUpOracleasanExternalDatabase

forADM”onpage 21.

3Ensurethatthedatabaselistenerisrunning.

To troubleshoot ADM connectivity to the database machine

1OntheAggregatormachine,logintotheserverasusernlayers.

2OpenSQLPlusandloginthedatabaseasusersys.

3Runthefollowingquery:

Select 1 from dual;

Thequeryresultisdisplayed.Ifthequeryfailsandtheresultisnotdisplayed,performthefollowingsteps:

1EnsurethattheOracleclientisconfiguredasdescribedin“InstallingtheOracleClient”onpage 28.

2Ensurethatthetnsnames.orafilecontainsthecorrectIPaddressofthedatabase.

(Youcancheckthisonlyafteryouhaveconfiguredtheappliancerole).

Troubleshooting ADM 8

Application Discovery Manager Administration Guide

56 VMware, Inc.

Troubleshooting ADM by Using the Product Support Package

YoucanusetheADMproductsupportpackagefortroubleshooting:

1 CreateanADMproductsupportpackageasdescribedin“ProductSupportPackages”onpage 40.

2ContactyourVMwareCustomerSupportrepresentativeandprovidethemwiththeproductsupport

packagethatyougeneratedinStep 1.

Troubleshooting Error Messages During WMI Discovery

WMIDiscoverymightfailonatargetWindowsXPmachinewithanAccessDeniederrormessageevenifyou

providevalidcredentials.ThisissueoccursbecausetheUsesimplefilesharingoptionisselectedbydefault

forsomeoftheWindowsXPdeployments.

To troubleshoot WMI Discovery failure

1OntheToolstab,selectFolderOptions.

2 SelecttheViewtab.

3IntheAdvancesettingsbox,deselecttheUsesimplefilesharingoption.

4ClickOK.

Detail Discovery Troubleshooting

Thissectiondescribesutilitiesandprogramsthathelpwithtroubleshooting.

1 CreateanADMdetaildiscoveryproductsupportpackageasdescribedin“UsingADMConsole”on

page 57.

2ContactyourVMwareCustomerSupportrepresentativeandprovidethemwiththeproductsupport

packagethatyougeneratedinStep 1.

VMware, Inc. 57

Chapter 8 Troubleshooting ADM

Using ADM Console

Youmustfirstcreateadetaildiscoveryproductsupportpackagefordetaildiscoverytroubleshooting.

To create a detail discovery product support package

1LogintotheADMconsole.

2 NavigatetoDiscovery>Inventory.

3Clickahostthatisalreadydiscoveredusingdetaildiscoverymethod.

4OntheDetailDiscoveryPoliciestab,selectnameofthepolicyforwhichyouneedtocreateasupport

package.

5ClickSupportPackage.

Creationofsupportpackagetakesaboutfiveminutes.NavigatetoManage>System>SupportPackageList

todownloadthesupportpackage.

WMI

WMIDetailDiscoveryrequiresspecificpermissionsandconfigurationonthetargethost.Microsoftincludes

atestingtool,calledWBemTest,oneverycomputerthathasWMIinstalled.Thistooltestsforthesame

permissionandconfigurationsthatADMrequires.Forexample,ifanaccessdeniedfailureoccurswhile

connectingtothetargethost,theWbemTesttoolraisesasimilarerrorindicatingaproblemwiththetargethost

configuration.

To perform troubleshooting

1CheckpermissionsandconfigurationusingtheWBemTesttool.Moreinformationisavailableonthe

MicrosoftWebsite:

http://technet.microsoft.com/en‐us/library/cc785775.aspx

2CheckADMDiscoveryusingtheutilitiesdescribedinthefollowingsections.

single.sh

Thesingle.shutilityisastand‐alonecommandlineutilitythatrunsDetailDiscoveryonaspecifichost.The

single.shutilitycreatesasupportpackagethatcontainstheDetailDiscoveryresultsandmoreuseful

information.VMwareCustomerSupportcanusethissupportpackagetoanalyzetheproblemsoffsite.

Thisutilityisusefulfortestingthecommunicationparametersforconnectingtoahost(forexample,theuser

andpassword),andtofindouttheretrievablepropertiesfromahostwithouthavingtogothroughtheprocess

ofdefiningaDetailDiscoverypolicyintheADMConsole.

Location

/home/nlayers/Seneca/ActiveProbe/bin/single.sh

Usage

single.sh [-A Attribute Artifacts] [-a address] [--AddExU Additional Unix Exclude Directories]

[--AddExW Additional Windows Exclude Directories] [--AddIncU Additional Unix Search Scope]

[--AddIncW Additional Windows Search Scope] [-c host] [-d port] [-D Configuration Items] [-e

Management IP] [--ExU Unix Exclude Directories] [--ExW Windows Exclude Directories] [-G CI

Groups] [-h] [-i] [--IncU Unix Search Scope] [--IncW Windows Search Scope] [-j classpath] [-l]

[-M maxdepth] [-n path] [-p ports] [-P Access profile] [-r filename] [-t timeout] [-T Discovery

result translator class] [-v] [-w]

NOTEThissectionreferstosupportpackagesusedspecificallyforDetailDiscoverytroubleshooting.Other

supportpackagesareusedforbackingup,restoring,upgrading,andtroubleshootingoftheADMapplication

andaredescribedinChapter 5.

Application Discovery Manager Administration Guide

58 VMware, Inc.

Table 8‐1listsanddescribesparametersforthesingle.shutility.



Table 8-1. single.sh Parameters

Parameter Description

-A,--planArtifacts Attribute Artifacts Attributeartifactstodiscover.

-a, -address address Address(es)ofthediscoverytarget.Usecommasasseparators.

-AddExU Additional UNIX Exclude

Directories

AdditionalExcludedirectoriesfromsearchintheUNIXfile

system.

-AddExW Additional Windows Exclude

Directories

AdditionalExcludedirectoriesfromsearchintheWindowsfile

system.

-AddIncU Additional UNIX Search Scope AdditionalScopeforsearchintheUNIXfilesystem.

-AddIncW Additional Windows Search Scope AdditionalScopeforsearchintheWindowsfilesystem.

-c, -Collector host SpecifiestheCollectorthatrunstheactualdiscovery.

-d, -debug port StartJVMwithenabledremotedebuggingonthespecifiedport

andwaitforENTERkeybeforecontinuing.

-D, -planCis Configuration Items Configurationitemstodiscover.

-e, -management Management IP SpecifiesthemanagementIPtouseifanaccessprofileisreadfrom

themanagement(usingthe-Poption).

-ExU UNIX Exclude Directories ExcludedirectoriesfromsearchinUNIXfilesystem.

-ExW Windows Exclude Directories ExcludedirectoriesfromsearchinWindowsfilesystem.

-G, -planCiGroups CI Groups ConfigurationItemgroupstodiscover.

-h, -help Briefhelpmessage.

-i, -interactive Interactivemodethatallowsyoutotypeprotocol‐specific

commands.

-IncU UNIX Search Scope ScopeforsearchinUNIXfilesystem.

-IncW Windows Search Scope ScopeforsearchinWindowsfilesystem.

-j, -classpath classpath Addsadditionalpathtotheclasspath.Thisadditionalpathwill

havethehighestpriority.

-l, planhelp Printsinformationaboutavailableartifactsandartifactgroups.

-M, -maxdepth maxdepth Maximumdepthforsearchinfilesystem.

-n, -outputPrefix path Specifiesthepathprefixoftheoutputfile(forexample, /tmp/).

Note:Thedirectorypathmustendwithabackslash(/).Ifthis

optionisnotused,apredefinedfilenameisused,andthefileis

createdinthecurrentworkingdirectory.

-p, -ports port Oneormoreportstousewhenconnectingtothetargethost(for

scanningaswell).Usecommasasseparators.Theseportsapplies

eveniftheconnectiondetailsarefetchedfromthemanagement.

-P, -accessProfile Access profile Discoveryparametersorpolicy/accessprofilenametofetchfrom

themanagement.

-r, -read filename Readfromaplaybackorsnmpdumpfileinsteadofgoingouttothe

network.

-t, -timeout timeout Connecttimeouttousewhenconnectingtothetargethost.If

connectiondetailsarefetchedfromthemanagement,theywill

overridethisparameter.

VMware, Inc. 59

Chapter 8 Troubleshooting ADM

Examples:

To probe target IP 1.2.3.4 on UNIX using protocol SSH

./single.sh -P \"ssh:username=root,password=54321\" -a 1.2.3.4

./single.sh -P \"ssh:username=root\" -a 1.2.3.4

(Apasswordwillberequestedbytheapplicationinteractivelywithoutechoing.)

To probe target IP 1.2.3.4 on UNIX using protocol TELNET

./single.sh -P \"telnet:username=root,password=54321\" -a 1.2.3.4

To probe target IP 1.2.3.4 on UNIX using protocol SNMP

./single.sh -P \"snmp:communityString=public\" -a 1.2.3.4

To probe target IP 1.2.3.4 on Windows using protocol WMI

single.bat -P \"wmi:domain=il.nlayers.com,username=administrator,password=54321\" -a 1.2.3.4

(defaultlocatorcredentialswillbeusedfrompropertiesfile)

To probe target IP 1.2.3.4 using protocol VI-SDK

./single.sh -P \"visdk:username=administrator,password=54321\" -a 1.2.3.4

Createdebugpackage:

single.sh -a address -P Access profile

Readfromplaybackfile:

single.sh -r filename

Accessprofilecanhaveoneofthefollowingformats:

NameofaDetailDiscoverypolicy.InthiscasethenecessaryinformationisreadfromaDetailDiscovery

policydefinedintheuserconsole.

Fulldefinitionoftheneededdiscoverydetailsinaprotocol‐specificformat:

protocol-name:prop1=value1,prop2=value2,...

Thefollowingprotocolnamesaresupported:SSH,Telnet,SNMP,VI‐SDKandWMI.

Inaddition,allprotocolssupportsthe‐ timeoutparameterwithadefaultvalueof20000milliseconds.Theports

parameterissupportedforallprotocolsexceptWMIandVI‐SDK,withdefaultportsof22forSSH,23for

Telnet,and161forSNMP.

-T, -translator Discovery result

translator class

Specifythediscoveryresulttranslatorclass.Predefinedtranslators

areavailablethroughtheiraliases,forexample:

class

com.nlayers.seneca.ap.mediation.DoNothingDiscoveryResult

Translatoradm

class

com.nlayers.seneca.ap.mediation.cim.AdmToCimXmlDiscove

ryResultTranslatorcimxml

class

com.nlayers.seneca.ap.mediation.cim.AdmToCimDiscoveryR

esultTranslatorcimareavailable

Valuesinbracketsarealiases

-v, verbosehelp Printverbosehelp.

-w, -wait Slowsdownplaybacktobethesamedurationastheoriginal

execution.

Table 8-1. single.sh Parameters (Continued)

Parameter Description

Application Discovery Manager Administration Guide

60 VMware, Inc.

Notethefollowing:

Escapeddouble‐quotessurroundtheprotocolinformation—thesemustbeused.

Unknownargumentsareignored.

Omittedpasswordfieldsarerequestedbytheapplicationinteractivelywithoutechoing.

Defaultsearchscopefordifferentplatforms:

Windows:

Include:[/Program Files]

Exclude: [/Documents and Settings, /WINDOWS]

UNIX:

Include:

[/bin, /sbin, /usr/bin, /usr/sbin, /usr/local, /usr/local/bin, /usr/local/sbin, /usr,

/opt]

Exclude:

[/boot, /dev, /devices, /proc, /unix, /kernel, /platform, /cdrom, /CDROM, /sd_cdrom,

/SD_CDROM, /Mail, /mail, /nsmail, /vol, /lost+found, /media, /tmp, /mnt, /jumpstart,

/pcfs, /sys, /usr/kvm/sys, /stand, /var/news, /var/log, /var/run, /var/lock, /var/www,

/var/cache, /var/tmp, /etc/gconf]

snmpdump

ThesnmpwalkprogramisbundledwithLinux,whichrunsSNMPonagivenIPaddressandcreatesatextual

dumpofthewholetreeofresults.ThisprogramisoftenusedwhileextendinganddebuggingtheSNMP

portionoftheDetailDiscoveryknowledgebase.

AnewDetailDiscoveryfeatureallowsVMwareCustomerSupporttorecordacompletesnapshotoftheSNMP

responsesofanetworkhost,usingsnmpwalk.YoucanusetheresultingdumpfiletofixSNMPDetail

DiscoveryproblemsencounteredbyVMwareCustomerSupport.

Astandardizedscriptcalledsnmpdump.shisnowsuppliedwithADMtocreatethissnmpwalkdumpfile.

Location

/home/nlayers/Seneca/ActiveProbe/bin/snmpdump.sh

Usage

Runningsnmpdump.shonthecommandlineyieldsthefollowingusageinformation:

./snmpdump.sh host_ip output_file

ThefirstparameteristhehostIPtoquery.

Thesecondparameteristhenameofthefileinwhichtosavetheresults.

Examples

CreateansnmpwalkdumpforIP1.2.3.4andsavetheresultsintofilesnmpdump.1.2.3.4.txt:

./snmpdump.sh 1.2.3.4 snmpdump.1.2.3.4.txt

nlcapture

Youcanusethenlcaptureutilityinplaceoftcpdumptocapturenetworkactivity.Thisutilitysupportsthe

samedefaultparametersastcpdump,butsetsthesnaplentobelargeenoughsoastonottruncatepackets.

Inaddition,thisutilityprovidesaparameternotsupportedbytcpdump:‐R,whichfilterspacketsbasedon

theirprotocol(forexample,HTTP)orbasedonprotocol‐specificattributes.

VMware, Inc. 61

Chapter 8 Troubleshooting ADM

Similartotcpdump,youcanusenlcapturetofilteranexistingcapturefileandtransformittoanew,filtered

file.Seeusagebelow.

Location

/home/nlayers/Seneca/tools/nlcapture.pl

Usage

Runningnlcaptureonthecommandlineyields:

nlcapture.pl tcpdump options [-R ethereal display filter string]

Forexample:

Tolistenoneth1andcaptureallHTTPandICMPpacketsintothefilebla.dump:

nlcapture.pl -i eth1 -R "http||icmp" -w myoutput.dump

Asexplainedearlier,nlcapturesupportsallcommontcpdumpparameterssuchas‐i.Additionally,it

supportsthe-Rparametertofilteronthenetworkprotocoloraccordingtothevalueofspecificprotocolfields.

Protocolnamesarewritteninlowercase.ThefollowingURLprovidesdetailsonthefiltersthatyoucanuse:

http://www.ethereal.com/docs/man‐pages/ethereal‐filter.4.html

Thefiltersofnlcaptureutilityaredifferentfromthetcpdumpfilters.Theyareeasiertouseandunderstand.

Application Discovery Manager Administration Guide

62 VMware, Inc.

VMware, Inc. 63

ThischapterprovidesinformationforuninstallingtheADMapplianceandincludes“UninstallingtheADM

Appliance”onpage 63.

Uninstalling the ADM Appliance

TouninstalltheADMappliance,followtheprocedureofyourorganizationforremovingavirtualmachine.

Uninstalling ADM 9

Application Discovery Manager Administration Guide

64 VMware, Inc.

VMware, Inc. 65

ThisappendixlistsADMtimezonesasshowninTable A‐1.

Time Zones A

Table A-1. Time Zones for ADM

Asia/Baku‐Asia/Nicosia Asia/Tel_Aviv‐

Etc/Greenwich

Etc/GMT‐Indian/Reunion Mexico/BajaNorte‐

US/Aleutian

Asia/Baku Asia/Tel_Aviv Etc/GMT Mexico/BajaNorte

Asia/Bangkok Asia/Istanbul Europe/Amsterdam Mexico/General

Asia/Beirut Asia/Makassar Europe/Andorra Mexico/BajaSur

Asia/Bishkek Asia/Macau Europe/Athens Mideast/Riyadh89

Asia/Brunei Asia/Macao Europe/Belfast Mideast/Riyadh88

Asia/Kuala_Lumpur Asia/Jerusalem Europe/Berlin Mideast/Riyadh87

Asia/Choibalsan Asia/Hong_Kong Europe/Brussels Pacific/Enderbury

Asia/Colombo Asia/Dhaka Europe/Bucharest Pacific/Apia

Asia/Damascus Asia/Dacca Europe/Budapest Pacific/Efate

Asia/Dili Asia/Chungking Europe/Copenhagen Pacific/Funafuti

Asia/Dubai Asia/Chongqing Europe/Gibraltar Pacific/Fakaofo

Asia/Dushanbe Asia/Ashkhabad Europe/Helsinki Pacific/Fiji

Asia/Gaza Asia/Ashgabat Europe/Kaliningrad Pacific/Port_Moresby

Asia/Harbin Atlantic/Cape_Verde Europe/Kiev Pacific/Galapagos

Asia/Hovd Atlantic/Azores Europe/Luxembourg Pacific/Guadalcanal

Asia/Irkutsk Atlantic/Bermuda Europe/Madrid Pacific/Guam

Asia/Jakarta Atlantic/Canary Europe/Malta Pacific/Johnston

Asia/Jayapura Atlantic/South_Georgia Europe/Minsk Pacific/Kiritimati

Asia/Kabul Atlantic/Faeroe Europe/Monaco Pacific/Kosrae

Asia/Kamchatka Atlantic/Madeira Europe/Paris Pacific/Majuro

Asia/Karachi Atlantic/St_Helena Europe/Riga Pacific/Marquesas

Asia/Kashgar Atlantic/Stanley Europe/Samara Pacific/Midway

Asia/Katmandu Atlantic/Reykjavik Europe/Simferopol Pacific/Nauru

Asia/Krasnoyarsk Atlantic/Jan_Mayen Europe/Sofia Pacific/Niue

Asia/Novosibirsk Australia/Lindeman Europe/Stockholm Pacific/Norfolk

Asia/Kuching Australia/West Europe/Tallinn Pacific/Noumea

Asia/Kuwait Australia/LHI Europe/Tirane Pacific/Palau

Asia/Magadan Australia/Perth Europe/Uzhgorod Pacific/Ponape

Application Discovery Manager Administration Guide

66 VMware, Inc.

Asia/Manila Australia/Victoria Europe/Vaduz Pacific/Samoa

Asia/Muscat Australia/ACT Europe/Vienna Pacific/Rarotonga

Asia/Phnom_Penh Australia/Melbourne Europe/Vilnius Pacific/Saipan

Asia/Omsk Australia/Lord_Howe Europe/Zaporozhye Pacific/Tahiti

Asia/Oral Australia/Tasmania Europe/Zurich Pacific/Tarawa

Asia/Yekaterinburg Australia/Hobart Europe/Warsaw Pacific/Tongatapu

Asia/Pontianak Australia/North Europe/San_Marino Pacific/Truk

Asia/Pyongyang Australia/Darwin Europe/Vatican Pacific/Wake

Asia/Qatar Australia/Yancowinna Europe/Moscow Pacific/Wallis

Asia/Qyzylorda Australia/Broken_Hill Europe/Rome Pacific/Yap

Asia/Rangoon Australia/QueenslandEurope/London Pacific/Pitcairn

Asia/Riyadh Australia/Brisbane Europe/Lisbon Pacific/Auckland

Asia/Saigon Australia/South Europe/Tiraspol Pacific/Pago_Pago

Asia/Sakhalin Australia/NSW Europe/Oslo Pacific/Gambier

Asia/Samarkand Australia/Adelaide Europe/Chisinau Pacific/Chatham

Asia/Tashkent Australia/Canberra Europe/Prague Pacific/Kwajalein

Asia/Tbilisi Australia/Sydney Europe/Bratislava Pacific/Honolulu

Asia/Urumqi Brazil/DeNoronha Europe/Ljubljana Pacific/Easter

Asia/Vientiane Brazil/East Europe/Sarajevo US/Samoa

Asia/Vladivostok Brazil/Acre Europe/Skopje US/Hawaii

Asia/Yakutsk Brazil/West Europe/Zagreb US/Arizona

Asia/Ulaanbaatar Canada/Newfoundland Europe/Dublin US/Eastern

Asia/Yerevan Canada/Central Europe/Nicosia US/Pacific

Asia/Ujung_Pandang Canada/Yukon Europe/Belgrade US/Michigan

Asia/Ulan_Bator Canada/Pacific Europe/Istanbul US/Mountain

Asia/Tokyo Canada/Saskatchewan Europe/Mariehamn US/Central

Asia/Thimphu Canada/Atlantic Indian/Antananarivo US/Alaska

Asia/Thimbu Canada/Eastern Indian/Chagos US/Aleutian

Asia/Tehran Canada/Mountain Indian/Christmas

Asia/Taipei Chile/EasterIsland Indian/Cocos

Asia/Singapore Chile/Continental Indian/Comoro

Asia/Shanghai Etc/Universal Indian/Kerguelen

Asia/Seoul Etc/Zulu Indian/Mahe

Asia/Riyadh89 Etc/UCT Indian/Maldives

Asia/Riyadh88 Etc/UTC Indian/Mauritius

Asia/Riyadh87 Etc/GMT0 Indian/Mayotte

Asia/Nicosia Etc/Greenwich Indian/Reunion

Table A-1. Time Zones for ADM (Continued)

VMware, Inc. 67

ThisappendixdescribestheADMAPIandexplainshowtoaccessanduseit.Topicsinclude:

“A P I Features”onpage 67

“WebServicesAPI”onpage 69

API Features

TheAPIofADMallowsclientstoqueryitsdatabaseandexportpartsofitbymeansofawebservicesAPI.

Thefollowingcasesareexplainedinthefollowingsections:

WritingthesystemstatusintoanXMLoutputfile;“Insight_control”onpage 67.

SynchronizationofCMDBapplicationswithdataofADM;“A s y n c h API”onpage 68.

PopulationofthirdpartyapplicationswithdataofADM.

DumpingofentiredatabasetablesanduploadingtoanFTPserver;“DumpAPI”onpage 68.

Accesstofiltereddatabybulk(paginated);“BulkAPI”onpage 69.

YoucandividetheAPIintothreesections,wheretwoarededicatedtoqueryingtheADM(DumpandBulk),

andthethirdisinchargeoftrackingthosequeries(Asynch).

Insight_control

TheInsight_controlutilitywritesthesystemstatusintoanXMLoutputfile.

To run Insight_control utility

1Logintotheapplianceasuserroot.

2 Changethedirectorybytyping:

cd /home/nlayers/Seneca/management/APIs

3Typethefollowingcommandtogenerateasystemstatusoutputfile:

./InSight_control.sh systemstatus --get --output /tmp/systemstatus

Service Status

Servicestatuscanbe:

Running:Theserviceisrunning.

Disabled:TheADMintentionallystopstheservice.

NotRunning(PurposelyStopped):Theservicewasstoppedintentionally,forexample,aservicewas

manuallystoppedbytheadm_control.pl --stopcommand.

ADM API Tutorial B

NOTEYoucansubstituteadifferentfileandpathfor /tmp/systemstatus.

Application Discovery Manager Administration Guide

68 VMware, Inc.

Sample Status Output

<uptime> 09:20:15 up 7 days, 18 min, 1 user, load average: 1.36, 2.17, 1.71</uptime>

<engine>Running</engine>

<listener>Not Running (Purposely Stopped)</listener>

<active_probe>Not Running (Purposely Stopped)</active_probe>

<oracle>Running</oracle>

<apache>Running</apache>

<watchdog>Running</watchdog>

</SystemStatus>

Asynch API

OperationsinADMʹsAPIareasynchronous.Theclienthastotracktheprogress(orlackthereof)ofthistask

andretrieveitsresults.

TasksareuniquelyidentifiedbyaUniversalUniqueIdentifier,whosestringrepresentationisreturnedupon

ataskcreation.Futurereferencestoataskmustbedoneusingthissamestring.

Taskshavepredefinedparametersregardingtheirlife‐spanineverystate,forexample,afinishedtaskwaits

inthesystemfor24hoursbeforeitsresourcesarerecalledandthetaskisdeleted.Ataskcanhaveanyofthe

followingstates,whichyoucanretrievebyusinggetTaskState(Stringid):

PENDING:ThetaskiscreatedandinitializedandiswaitingtobeexecutedbyADM.

RUNNING:AgetTaskProgress()returnsanIntegerbetween0and100.

CANCELLED:Systemcancancelataskifittakestoolongtoexecute.

RUNNING:Thetaskisbeingexecuted.YoucantracktheprocessbycallinggetTaskProgress(Stringid).

Ataskcanbeinthisstateforalimitedamountoftime;systemcancelsalltheoffendingtasks.

FINISHED:Thetaskhasfinishedrunningsuccessfully,anditsproduceisreadyandwaitingtobe

collectedbytheclient.

ERROR/CANCEL:Thetaskhaseitherfailedorbeencanceled(usingcancelTask(Stringid)).

Dump API

TheDumpAPIprovidesyouwiththepossibilityofdumpingthecompletecontentsofatable(orsmallsetof

tables)thatcorrespondstoagivenentity(HOSTS,SERVICES,CONNECTIONS,andsoon.).InthisAPI,

flexibilityhasbeentradedforspeed,anditisintendedforthosecaseswhereanapplicationintendstomirror

ADMʹsdata,andperiodicallysynchronizewithit.

TheDumpAPIworksasfollows:

1 Selectthetypeofentitiesthatitneedsandadiscoverydate(optional)forthoseentities.

2 Calldump( )withthoseparameters,andobtainthetaskUUIDinastringform.

3TracktheprogressofthetaskusingtheAsynchAPI(getTaskState( )andgetTaskProgress( )).

4RepeatStep 3untilthetaskreachestheFINISHEDorERRORstate.

5IfthetaskisintheFINISHEDstate,thenthefilescontainingthedumpeddatabasetablesarereadyand

waitingtobecollected(eitherusingSSHorintheFTPserverifsupplied).Thefilesarestoredina

subdirectorywhosenameisidenticaltothetaskID.

NOTETheoperationswithinthecontextoftheweb‐serviceclientaresynchronic,thatis,thecallingofthe

functionthatdoestheactualdeliveryofthequeryissynchronic,andtheclientblocksuntilthatoperationis

completed.

VMware, Inc. 69

Appendix B ADM API Tutorial

Bulk API

TheBulkAPIprovidesyouwiththepossibilityofqueryingtheADMwithmoresophisticatedfilters,and

browsingtheresultsetbymeansofpagination.Theresultsaredeliveredinsubsets(pages)ofapredefined

sizeandformattedinXMLCIM.ThisAPIisintendedforthosecaseswhereanapplicationintendstobrowse

onfinely‐filteredsegmentoftheADMʹsdata.

The Bulk API works as follows

1 Createthefilterobjectandselectthelevelofgranularityoftheresults.

2 Callquery( )withthefilterobjectandobtainthetaskUUIDinstringform.

3AfterthetaskisFINISHED,youcanretrievethemaximumamountofpagesavailableinthisresultsetby

callinggetPageAmount( ).

4Atthismoment,thereisaniteratorinADMthatyoucancontrolbythefollowingcalls,andtheresults

retrievedfromthem:

a hasNextPage( )

bgetNextPage()

5Afterfinishingretrievalofallthedatawiththespecificquery,youmustcallcloseQuery() toreleaseall

resourcesassociatedwiththisquery.

Web Services API

ThepreferredmethodtoaccessADMʹsAPIisthroughthewebservicesAPI,whichprovidesfora

standardizedwayofcommunicationandhighinteroperability.ThisAPIisnotlockedinagivenprogramming

language.

ADMoffersadescriptionoftheAPIinamachine‐readabledocumentformattedinWebServicesDescription

Language(WSDL).Withthisdocument,automatedtoolsavailableforthepopularprogramminglanguages

cancreatethelow‐levelcodenecessarytoaccesstransparentlythefunctionalityprovidedbytheADM.

Application Discovery Manager Administration Guide

70 VMware, Inc.

VMware, Inc. 71

Index

active_probe service 39

ADM

architecture solutions 9

required time zones 65

restore 42

services 39

ADM API 67

adm_control.pl script 39

Apache service 39

Asynch API 68

Bulk API 69

Dump API 68

Engine service 39

installation backup 41

Listener service 39

managing services 39

performing an installation backup 41

restore 42

ADM database 42

services 39

time zones 65

upgrading ADM 40

virtual appliance 10

VNC service 39

Watchdog service 39

Web services API 69

Application Discovery Manager Administration Guide

72 VMware, Inc.

Vmware Application Discovery Manager Administration Guide V Center 7.1 Vcenter 71 Ag En

vCenter Application Discovery Manager - 7.0 - Administration Guide vcenter-application-discovery-manager-70-ag-en Free User Guide for VMware vCenter Software, Manual

Navigation menu

Versions of this User Manual:

Views

Navigation