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.
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 Copyright © 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents About This Book 7 1 Overview 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 2 Installing ADM 15 ADM Installation Requirements 15 Installation Personnel 15 ESX Resources 15 Installing the vSphere Client 16 D
Application Discovery Manager Administration Guide 4 Securing 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 5 Maintenance 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 Licenses 45 Uploading a License 45 42 6 Upgrading ADM 47 Overview 47 Mixed Environments 47 Licenses 47 Appl
Contents 9 Uninstalling ADM 63 Uninstalling the ADM Appliance 63 A Time Zones 65 B ADM API Tutorial 67 API Features 67 Insight_control 67 Asynch API 68 Dump API 68 Bulk API 69 Web Services API 69 Index 71 VMware, Inc.
Application Discovery Manager Administration Guide 6 VMware, Inc.
About This Book 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.
Application Discovery Manager Administration Guide 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.
1 1 Overview 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.
Application Discovery Manager Administration Guide 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.
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.
Application Discovery Manager Administration Guide 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.
Chapter 1 Overview . NOTE All ADM appliances that participate in mixed environemnt mode must run the same 7.0.0 version of the ADM. 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.
Application Discovery Manager Administration Guide 14 VMware, Inc.
2 2 Installing ADM This chapter describes installation and deployment of the ADM. This chapter includes the following topics: “ADM 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.
Application Discovery Manager Administration Guide 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. NOTE ADM supports Windows Internet Explorer 6.0 and later browsers.
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.
Application Discovery Manager Administration Guide 2 g Set the Network Label, for example, ADM span port and click Next. h Verify that the port group is listed, and click Finish. 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. b Click Edit and select Security tab. c Select Promiscuous Mode, and then select Accept from the list box. d Click OK and then Close.
Chapter 2 Installing ADM Deploying the ADM Virtual Appliances Virtual appliances are installed on the ESX server according the configurations in Table 2‐3. Table 2-3.
Application Discovery Manager Administration Guide 7 Click Next. The Datastore screen appears. NOTE If there is more than one datastore, select the datastore where you want to install the virtual machine. 8 Click Next. The Network Mapping screen appears. 9 Click 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.
Chapter 2 Installing ADM NOTE This is the same identifier that was defined on the Aggregator side for WMI discovery. The default value is 200. 8 Click Next. The Installation screen appears. 9 Click Install to begin the installation. NOTE The process of installing and configuring the Windows Collector can take several minutes. 10 Click Finish to close the InstallShield Wizard screen when the installation process is complete.
Application Discovery Manager Administration Guide 5 It 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. a Log in to the server as root. b Add a new group, nlayers, by running the following command.
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.
Application Discovery Manager Administration Guide 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. a Login to the Oracle server with user as oracle.
3 Setting Up ADM 3 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.
Application Discovery Manager Administration Guide 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.
Chapter 3 Setting Up ADM To change the root password 1 Type a new password for the root user and press Enter. 2 Retype 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.
Application Discovery Manager Administration Guide 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.
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. Table 3-3.
Application Discovery Manager Administration Guide To configure the appliance role for Collector 1 Type yes at the appliance role prompt and press Enter. 2 Type the role number and press Enter. 3 If you select 1, you have to enter the Collector ID of your choice and press Enter. The default value is 100. 4 Type the Aggregator IP and press Enter. The appliance role is then created. This process might take some time.
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. 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.
Application Discovery Manager Administration Guide 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: 1 Type the IP address of the management appliance in the address bar and click Go. The login screen appears. 2 Type admin in the Username field and default password 123456 in the Password field. 3 Click Login. IMPORTANT You might be required to upload a new license.
Chapter 3 Setting Up ADM 13 VMware, Inc. 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.
4 Securing ADM 4 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 1 Log in to the ADM appliance by using a Secure Shell (SSH) client.
Application Discovery Manager Administration Guide 6 Place your cursor at the end of the line and append the line by typing: single 7 Press Enter to commit the change. 8 Press b to start the system. Your system starts without requiring a password. 9 Type 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.
Chapter 4 Securing ADM To create a certificate 1 To 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.
Application Discovery Manager Administration Guide 38 VMware, Inc.
5 Maintenance 5 This chapter describes the necessary concepts and procedures to maintain an ADM deployment. This chapter includes the following topics: “ADM 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. Table 5-1. ADM Services Service name Description apache Web server service.
Application Discovery Manager Administration Guide Table 5-2. ADM Service Commands Use the Following Command To adm_control.pl --status Display the status of the ADM service. adm_control.pl --stop Stop the ADM service. adm_control.pl --start Start a stopped ADM service. adm_control.pl --restart Stop and restart the ADM service. adm_control.pl --help Display all of the command options. adm_control.
Chapter 5 Maintenance You can create support packages either through the ADM Console or through the Command Line Interface (CLI). 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.
Application Discovery Manager Administration Guide 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. 2 Contact VMware Customer Support to retrieve the password for extracting the product support package. 3 Follow the steps in “Restore the ADM Database” on page 42. 4 If necessary, “Restoring the Custom Discovery and Configuration Files” on page 43.
Chapter 5 Maintenance where db_schema_build is the database schema version and build number. NOTE The database restore process can take up to 30 minutes. 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.
Application Discovery Manager Administration Guide ./InSight_control.sh adkb --checkout /tmp 14 Copy all files and subdirectories from: supportpackagedir/supportpackage/active_discovery/custom/kb/custom 44 VMware, Inc.
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.
Application Discovery Manager Administration Guide 46 VMware, Inc.
6 Upgrading ADM 6 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.
Application Discovery Manager Administration Guide 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.
Chapter 6 Upgrading ADM 3 Upgrade 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. NOTE The upgrade process can take several minutes to complete. You cannot access the ADM Console while the upgrade is in progress. 5 Proceed with “Post‐Upgrade Steps” on page 49.
Application Discovery Manager Administration Guide 50 VMware, Inc.
7 Migrating to a New Appliance 7 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.
Application Discovery Manager Administration Guide Migrate or upgrade all appliances to the same ADM version in the following order: 1 Remote database (for Distributed with remote database solution) 2 Collectors (for all Distributed solutions) 3 Aggregator Process The migration process is as follows: 1 Record the current appliance network settings as described in “ADM Setup Procedures” on page 25. 2 Backup your data as described in “Product Support Packages” on page 40.
Chapter 7 Migrating to a New Appliance Restoring WinApe Migration Files NOTE Backup your ADM environment as described in “Backing Up WinApe Migration Files” on page 52. The following procedures describes the restoration of WinApe migration files. 1 Log in to the WinApe appliance. 2 Copy the adkbcustom.jar backup file. 3 Navigate to the \lib folder. 4 Replace the current file in \lib folder with the copied file. 5 Run the services.msc command.
Application Discovery Manager Administration Guide Aggregator 1 Log in to the Aggregator virtual appliance. 2 Restore the ADM database as described in “Troubleshooting ADM by Using the Product Support Package” on page 56. 3 Make 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.
8 Troubleshooting ADM 8 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.
Application Discovery Manager Administration Guide 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. 2 Contact your VMware Customer Support representative and provide them with the product support package that you generated in Step 1.
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 1 Log in to the ADM console. 2 Navigate to Discovery > Inventory. 3 Click a host that is already discovered using detail discovery method. 4 On the Detail Discovery Policies tab, select name of the policy for which you need to create a support package. 5 Click Support Package.
Application Discovery Manager Administration Guide 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.
Chapter 8 Troubleshooting ADM Table 8-1. single.sh Parameters (Continued) Parameter Description -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.
Application Discovery Manager Administration Guide 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.
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.
Application Discovery Manager Administration Guide 62 VMware, Inc.
9 Uninstalling ADM 9 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. VMware, Inc.
Application Discovery Manager Administration Guide 64 VMware, Inc.
A A Time Zones This appendix lists ADM time zones as shown in Table A‐1. Table A-1. Time Zones for ADM VMware, Inc.
Application Discovery Manager Administration Guide Table A-1.
B ADM API Tutorial B This appendix describes the ADM API and explains how to access and use it. Topics include: “API 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.
Application Discovery Manager Administration Guide Sample Status Output 6.1.0-6013 09:20:15 up 7 days, 18 min, 1 user, load average: 1.36, 2.17, 1.71 Running Not Running (Purposely Stopped) Not Running (Purposely Stopped) Running Running Running Asynch API Operations in ADMʹs API are asynchronous.
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.
Application Discovery Manager Administration Guide 70 VMware, Inc.
Index A active_probe service 39 ADM architecture solutions 9 required time zones 65 restore 42 services 39 ADM API 67 adm_control.
Application Discovery Manager Administration Guide 72 VMware, Inc.
