vRealize Operations Service Discovery Management Pack 2.1
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
vRealize OperationsService DiscoveryManagement Pack 2.1
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 2
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
If you have comments about this documentation, submit your feedback to
Copyright © 2018 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com
Contents
vRealize Operations Service Discovery Management Pack 4
1 Introduction to vRealize Operations Service Discovery Management Pack 5
2 Installing vRealize Operations Service Discovery Management Pack 7
Install the vRealize Operations Service Discovery Management Pack 7
3 Configure the vRealize Operations Service Discovery Management Pack 9
4 Configuring Guest user Mapping 11
Automate Guest User Mapping 11
5 Viewing vRealize Operations Service Discovery Management Pack 14
6 Dashboards in vRealize Operations Service Discovery Management Pack 15
Access Dashboards 15
7 List of Known Services 20
8 Integration With Site Recovery Manager 23
Dynamic Application Group 23
9 Configure Included Service List 25
VMware, Inc. 3
vRealize Operations Service DiscoveryManagement Pack
The vRealize Operations Service Discovery Management Pack describes how to install and configure themanagement pack for VMware vRealize Operations Manager.
Intended AudienceThis information is intended for anyone who wants to install, or use vRealize Operations ServiceDiscovery Management Pack.
VMware Technical Publications GlossaryVMware Technical Publications provides a glossary of terms that might be unfamiliar to you. Fordefinitions of terms as they are used in VMware technical documentation, go to http://www.vmware.com/support/pubs.
VMware, Inc. 4
Introduction tovRealize Operations ServiceDiscovery Management Pack 1vRealize Operations Service Discovery Management Pack is a service awareness adapter to thevRealize Operations Manager that provides continuous dependency mapping of applications.
vRealize Operations Service Discovery Management Pack offers an application context to virtualinfrastructure administrators for monitoring and managing virtual infrastructure inventory objects andactions. Administrators can use the management pack to understand the impact of the change on thevirtual environment in their application infrastructure. Administrators can discover services running oneach virtual machine. The management pack also shows dependencies between different virtualmachines.
VMware, Inc. 5
Figure 1‑1. High-Level Architecture
Guest Operation (APE Task)
Active Discovery
Guest Operation (APE Task)
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
VMwareTools
VM
vCenter Server
Service DiscoveryAdapter
vRops
vSphere SDK
Note To discover a service through the vRealize Operations Service Discovery Management Pack, thefollowing conditions must met:
n Service Discovery MP only discovers known services listed in the documentation. New services mustbe added in the known service list manually. See Chapter 7 List of Known Services.
n Service Discovery MP only discovers the services when it is communicating on a port. The port mustbe a standard port or be defined when added manually.
n Service Discovery MP cannot discover services on a VM having multiple IP configurations.
n Service Discovery MP cannot discover the service if there are any connection or user authenticationfailure problem with the VM.
n Service Discovery MP cannot discover relationship or connection counts between VMs deployedacross different vCenter Server.
n Service Discovery MP filters out any service which does not qualify as per the above conditions. Italso filters out the connection counts between discovered services and filtered services.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 6
InstallingvRealize Operations ServiceDiscovery Management Pack 2You can download the vRealize Operations Service Discovery Management Pack from the VMwareSolution Exchange website.
Install thevRealize Operations Service Discovery Management PackThe vRealize Operations Service Discovery Management Pack consists of a PAK file that contains defaultdashboards to discover services running in each virtual machine.
Configure vRealize Operations Service Discovery Management Pack on remote collector invRealize Operations Manager for better performance
Prerequisites
n Verify that you are using vCenter version 5.5 or later.
n Verify that you have downloaded the PAK file from VMware Solution Exchange.
n Verify that VMware tools 10.1 or above is installed and running in the Guest operating system of allvirtual machines.
Note If VMware tools are not installed or are of earlier version, the management pack cannotdiscover the services from VMs.
n Verify that the time of the virtual machine, host and time zone between vRealize Operations Managerand vCenter Server is synchronized.
n Verify that you are using VMware ESXi 5.5, 6.0 or above is installed.
n Verify that port 443 is opened on both vCenter Server and VMware ESXI 6.x for guest auth tocommunicate.
Procedure
1 Log in to the vRealize Operations Manager user interface with administrator privileges.
2 In the menu, click Administration and in the left pane click Solutions.
3 On the Solution section, click the plus sign to add a solution.
4 Browse to the folder where you downloaded the PAK File and select the PAK file.
VMware, Inc. 7
5 Click Upload.
The upload might take several minutes.
6 Read and accept the EULA, and click Next.
Installation details appear in the window during the process.
7 When the installation is completed, click Finish.
What to do next
After you install the vRealize Operations Service Discovery Management Pack, configure the adapter todiscover and show the dependencies between different virtual machines.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 8
Configure thevRealize Operations ServiceDiscovery Management Pack 3When you configure the management pack, you can discover and retrieve service-related informationrunning on each virtual machine. The adapter also displays relationships between services running underdifferent virtual machines.
Figure 3‑1. Configuring a Solution
Prerequisites
n (Optional) Verify that a guest user mapping is created for each virtual machine. For more informationon automating guest user mapping, see Automate Guest User Mapping.
n Verify that the vCenter Server is already configured with VMware vSphere.
Procedure
1 In the menu, click Administration and in the left pane click Solutions.
2 On the Solutions tab, select vRealize Operations Service Discovery Management Pack and clickConfigure on the toolbar.
VMware, Inc. 9
3 Enter a name and description for the adapter configuration.
4 Under the Basic Settings section, provide the vCenter Server address.
5 Select Enable or Disable from the Dynamic Application Group drop-down menu.
6 Select Enable or Disable from the Use Sudo (Linux Non-Root user) drop-down menu.
Note If you enable the Use Sudo (Linux Non-Root user) option, you can configure thevRealize Operations Service Discovery Management Pack with a non-root user for a Linux VM. To doso, ensure that the Linux VM has the following configuration in its /etc/sudoers file:
<non-root username> ALL=(ALL) NOPASSWD: /usr/bin/netstat
To confirm that the Sudo configuration is as per thevRealize Operations Service Discovery Management Pack requirements, run the command sudonetstat -anp --tcp -udp and verify the following:
n Sudo should not prompt for any password when you run the above command using a non-rootuser.
n The output column PID/Program name is populated with some value ( and not - ).
7 To add credentials, click the plus sign.
a In the Credential name text box, enter the name by which you are identifying the configuredcredentials.
b Type the User name and Password for the vCenter Server instance.
c Only if using the default user name and password, enter a default name for Windows and Linux.
Note If the authentication fails with common user name and passwords then the VM is testedwith Guest user mapping and is marked for guest user mapping for the rest of the collection cycleunless the user saves the settings.
d To collect SRM data when SRM is configured in the same vCenter, enter a SRM User name andSRM Password.
e Only if configuring a guest user mapping, enter a Guest User Mapping CSV Password.
f Click OK.
8 Click Test Connection to validate the connection with your vCenter Server instance.
9 Expand the Advanced Settings and select the collector group from the Collectors/Groups drop-down menu.
10 Click Save Settings.
The adapter instance is added to the list.
Note If you click Save Settings, then all the existing data is discarded and the next collection cycletakes longer time.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 10
Configuring Guest user Mapping 4The vRealize Operations Service Discovery Management Pack provides the functionality of automaticconfiguration of guest user mappings for virtual machines.
For information on configuring the guest user mapping, see the VMware vSphere 6.5 Information Center.
Automate Guest User MappingThe vRealize Operations Service Discovery Management Pack cannot discover services on a VM if theguest user mapping is not defined in the vCenter Server. However, you can discover services whendefault user name and passwords is provided during the configuration of the adapter. The automationhelps you to automate the process of defining the guest user mapping.
When a Guest User Mapping is applied by the Service Discovery Adapter, the mapping is configured onlyfor the vCenter Server user configured in the credentials page of service discovery adapter.
Note If a user changes the SSO user details of a configured service discovery then the user has to re-apply the guest user mapping to regain control on VMs.
Prerequisites
n Verify that you have configured the vRealize Operations Service Discovery Management Pack.
n Verify that you have the user credentials of the VM that has administrator rights.
n Verify that you have completed at least one cycle of object collection.
n Verify that your environment has VMware 10.1 tools.
Procedure
1 In the left pane of the VMware vRealize Operations Manager, click Administration and clickInventory Explorer.
2 Select the vCenter adapter instance on which the service discovery is configured and click theActions icon.
VMware, Inc. 11
3 To export the guest user mappings in a CSV template, select Export Guest User Mappings andenter the file path where the CSV file is created.
Note Ensure that vRealize Operations Manager process has write access to the file path andspecify the CSV file path. If the path is not specified, then the guest user mapping is saved in thedefault folder for a specific node on which the adapter instance is collecting data.
4 Click Begin Action to export operation.
The Export Guest User Mappings appears with a task ID for the action.
5 Select the task ID to display all the recent tasks.
You can track the progress of each action under the recent tasks section. The export operation statuschanges to completed under the Associated objects section. Export operation creates a CSV file inthe provided location and populates them with the name of the exported VM in the first column of theCSV. The second and third columns display a dummy user name and password. You can edit theCSV file and provide the correct user name and password for each VM.
6 To encrypt the CSV file, run the following command: gpg --symmetric <exported csv file>.
The CSV file consists of three columns, VM name, Guest OS user name and Password. If you do notwant to perform a Guest user mapping from the exported CSV file then you can remove any of theentries of a VM from the exported file.
7 To apply the guest user mappings, select the Inventory Explorer and select the vCenter adapterinstance where a service discovery is configured.
8 Click the Actions icon and select Apply Guest User Mappings.
9 Enter the Encrypted CSV path and Status CSV path, and click Begin Action.
You can provide the CSV file with the VM names and the guest OS credentials. You can either createor edit a CSV file. The CSV file must have three columns, VM Name, guest OS user name andPassword.
Encrypted CSV path Encrypted CSV path is the path where a user provides CSV file thatcontains guest user name and password in an encrypted format.
Status CSV path Status CSV path is the output file where the adapter can write the statusof an operation.
10 As the export action begins, click on the task ID to view the task progress and status from the ApplyGuest User Mappings.
When the operation is completed, a message is displayed with the number of VMs for which guestuser mapping has been successfully applied.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 12
11 To clear all the guest user mappings, select Clear Guest User Mappings from the Actions drop-down menu.
Note When you select Clear Guest User Mappings, all the mappings related to the selected guestuser mentioned in the CSV file is deleted. This action is not only applicable to the mappings appliedusing the Apply Guest User Mapping feature but all the mappings to a guest user is deleted.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 13
ViewingvRealize Operations ServiceDiscovery Management Pack 5You can view the application related data to verify that thevRealize Operations Service Discovery Management Pack is configured and collecting data.
You can verify that the vRealize Operations Service Discovery Management Pack is correctly installedand collecting data.
Table 5‑1. Successful Installation Indicators
Where to view the information Information to view
From Administration Solution tab, under the ManagementPack forvRealize Operations Service Discovery Management PackSolution Details.
You can view the collection state and the collection statuscolumns.
Environment Overview Inventory The objects related to applications are added to the inventory.
Dashboards vRealize Operations Service Discovery Management Packdashboards provides a graphical and topologicalrepresentation of discovered known services of a virtualmachine.
VMware, Inc. 14
Dashboards invRealize Operations ServiceDiscovery Management Pack 6You can determine the inter-dependencies of virtual machines and the dependencies of each service inthe respective virtual machines.
The dashboards are added to the default vRealize Operations Service Discovery Management Pack andare specific to this adapter.
Access DashboardsYou can use the dashboards to view, monitor and troubleshoot objects in your cloud infrastructure.
Procedure
u To access the dashboards, select the Dashboard List > Service Discovery option from thevRealize Operations Manager menu bar.
Services RelationshipsYou can use the services relationship dashboard to view the dependency of a service on a virtualmachine. The service discovered by vRealize Operations Service Discovery Management Pack arelabeled and can be viewed in the service topology widget.
Figure 6‑1. Service Relationship Dashboard
VMware, Inc. 15
Widgets in Service RelationshipsYou can use the widgets in the service relationship dashboard to view the list of discovered services andtheir corresponding topology of the selected services. You can also retrieve information on how theservices communicate with different services running on other VMs.
Table 6‑1. Widgets in Service Relationships
Widget Description
List of Services Discovered This widget displays all services that are discovered by thevRealize Operations Service Discovery Management Pack.
Connections from the SelectedService
This widget displays the relationship between the services and other services running on otherVMs.
Properties of the SelectedService
This widget displays all the properties of the selected service from the Services and ServiceTopology widget. For more information on properties, see Chapter 7 List of Known Services.
Note When there is a new resource found, then the virtual machine column under the Services widget isempty for a collection cycle. Only after a subsequent collection cycle, the information in the virtualmachine column is then populated.
Virtual Machine RelationshipsYou can use the virtual machine relationship dashboard to monitor all the known virtual machines, theirproperties and their relationship between each other.
Figure 6‑2. Virtual Machine Relationships Dashboard
Widgets in Virtual Machines TopologyYou can use the virtual machine widgets to view the list of virtual machines, topology map, and the objectrelationship.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 16
Table 6‑2. Widgets in Virtual Machines Topology
Widgets Description
List of Virtual Machines This widget displays all virtual machines that are discovered by vCenter adapter. Thewidget contains the following columns to provide a complete information pertaining to avirtual machine discovered by the service discovery MP:n Namen Service Discovery Statusn Service Discovery Methodn Incoming and outgoing Connectionn Recovery Plansn Protection Groupn Guest OSn Power State
Node Relationship of the Selected VM This widget displays the relationship between each objects.
List of Services Running in theSelected VM
This widget displays all the properties for the selected VM under the Virtual Machinesand Relationships widgets.
Connections of Virtual Machines This widget displays the relationship between one or more VMs with each other whenyou select a virtual machine under the virtual machines widget. This data is based onthe relationship between the services running on them.
Service DistributionThe service distribution dashboard shows the distribution of different service type in the selected datacenter, cluster, or a host system.
Figure 6‑3. Service Distribution Dashboard
Widgets in Service DistributionYou can use this widget to view the distribution of different service types in a data center resource.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 17
Table 6‑3. Widgets in Service Distribution
Widgets Description
Inventory Item This widget provides a hierarchical representation of resourcesin the form of badges. The widget lists the following badges:n vSphere Worldn vCenter Servern Data centern Cluster Compute resourcen Host system
Known Services Distribution This widget consists of a pie chart, which displays differentapplications discovered from a selected resource.
The pie chart populates the distribution of a known servicewhen you select a resource from the resources widget. If theselected item does not have any services discovered, then thepie chart displays the following message:
The view cannot be rendered for the specified
object.
Service Categories This widget displays the service categories that are discoveredby selecting a resource from the resource widget.
User Defined Services Distribution This widget shows the list of user defined services.
Service VisibilityThe service visibility dashboard provides an overall view of the virtual machines that contains userdefined services.
This dashboard also provides information about VMs where the discovery has failed or has not occurred.For example, if a VM is powered off then discovery of such VMs does not occur.
Figure 6‑4. Service Visibility
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 18
Widgets in Service VisibilityYou can use this dashboard to view an overall visibility of unknown service of a selected data centerresources.
Table 6‑4. Widgets in Service Visibility
Widget Name Description
Inventory Tree This widget provides a hierarchical representation of resourcesin the form of badges. The widget lists the following badges:n vSphere Worldn vCenter Servern Data centern Cluster Compute Resourcen Host System
Virtual Machines without Service Visibility This widget displays information about failed discovery of VMs.
Virtual Machines with User Defined Services This widget displays the list of VM's where the user hasdefined such services.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 19
List of Known Services 7The service discovery adapter lists a number of known services that can be discovered.
Table 7‑1. Known services list
Known Services
Windows Active Directory
IIS
Sharepoint
SQL Server
vCenter Site Recovery Manager Server
SRM - vSphere Replication Server
vShield
weblogic
Oracle DB
Apache HTTP
TC Server
Gemfire
Tomcat
JBoss
Hyperic Server
Hyperic Agent
Ms Sql server
VMwareVCenterServer
VMwareVCenterServerAppliance
MySQL
NGINX
RabbitMQ-Server
MS-Exchange-Client-Access
MS-Exchange-Hub-Transport
VMware, Inc. 20
Table 7‑1. Known services list (Continued)
Known Services
MS-Exchange-Mailbox
MS-Exchange-Unified-Messaging
MS-Exchange-Edge-Transport
VCloudDirector
vROps Analytics
vROps Collector
vROps Gemfire
vCenter Operations Server
vCenter Operations UI
Service TypesAll the known services are grouped and shown as one service type. To view all the VMs where thecorresponding services are running, navigate to Environment > Inventory.
Table 7‑2. Services properties
Property Names
Category
VirtualMachine
Pid
InstallPath
Version
Port
ConnectionCount
ConnectionType
Name
Note Some version values can be missing in the property list under the Service Topology dashboard.
VM PropertiesTable 7‑3. List of VM properties
Property Names
InboundPorts
DiscoveryMethod
IncomingConnectionCount
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 21
Table 7‑3. List of VM properties (Continued)
Property Names
KnownServiceCount
OutGoingConnectionCount
ServiceDiscoveryStatus
UserDefinedServiceCount
Note When a circular dependency is detected among the discovered services, no relationship is addedto a such resources. Due to this functionality, the incoming and outgoing connection count value mightdiffer than the actual number of connections in the dashboard. For example, in a vRealize Operationscluster, all the member relationships cannot be added. However, to validate them, search for their cyclicrelationship member in the log file.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 22
Integration With Site RecoveryManager 8vRealize Operations Service Discovery Management Pack integrates withVMware Site Recovery Manager where the information related to the protection groups and recoveryplans for each VM is collected and added as a property of that VM.
If a VM is part of any recovery plan or a protection group, then the VM can have a property set for thatparticular VM. You can connect to VMware Site Recovery Manager with a user name and a passwordduring the Service Discovery adapter configuration. After you connect to SRM, the VM properties areupdated with two new properties:n Protection Group - The name of the protection group for a configured VM.
n Recovery Plans - The names of one or more recovery plans for a configured VM.
Figure 8‑1. SRM Integration
Dynamic Application GroupAll the connected services are grouped based on their types such as Database or an Application server.
VMware, Inc. 23
When you enable the Dynamic Application Group when configuring thevRealize Operations Service Discovery Management Pack, all connected services are grouped in tierbased on the category. All such types are then again grouped to form an application and a name isassigned to such applications. You can navigate to Environment > Application and rename theapplication. When you click any application, different types of services with their associated child servicesare then displayed.
vRealize Operations Service Discovery Management Pack 2.1
VMware, Inc. 24
Configure Included Service List 9By default, vRealize Operations Service Discovery Management Pack discovers the known services.However, there can be scenarios where in the user can specify other services that might not bediscovered on a usual discovery process, like Java or any other custom services. During such instances,you can specify which service that you want to discover using the Configure Included service list. You caninclude user defined services for the services that you want to discover. If you have configured user-defined services with marking unknown services to known services in the earlier version of vRealizeOperations Service Discovery MP, then you are required to re-configure the services using configureinclude service option.
Procedure
1 In the menu, click Administration, then click Configuration > Inventory Explorer.
2 From Inventory Explorer, select the Service Discovery adapter instance on which the services list isconfigured.
3 Select the instance, and click the gear icon on the top.
4 Click Configure Included Services and enter the services that needs to be discovered.
5 Click Begin Action.
Note When you enter the user-defined service then the value can appear only after the nextcollection cycle. When a user-defined service is added or modified then these services are written inan adapter conf folder. During the next collection cycle, the services are read and are added as aproperty of the adapter instance. If you try to check before the collection cycle, then you cannot viewthe newly added services in the included service list.
VMware, Inc. 25
Related Documents
