EMC Smarts Integration Guide vCenter Operations Manager 1.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.
EMC Smarts Integration 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 EMC Smarts Integration Guide 5 Updated Information 7 1 Introduction to EMC Smarts Integration 9 Data that vCenter Operations Manager Receives from EMC Smarts 9 Data that vCenter Operations Manager Sends to EMC Smarts 9 Installation and Configuration Requirements 10 Overview of Data Flow 10 2 Installing the EMC Smarts Adapter 11 Install the Adapter in a Standalone Installation Install the Adapter in a vApp Installation 12 11 3 Configuring EMC Smarts Integration 15 Overview of Configuration S
EMC Smarts Integration Guide 4 VMware, Inc.
EMC Smarts Integration Guide The EMC Smarts Integration Guide describes how to integrate vCenter Operations Manager and EMC Smarts. Intended Audience The information in this guide is intended for IT management and system administrators. VMware, Inc.
EMC Smarts Integration Guide 6 VMware, Inc.
Updated Information The EMC Smarts Integration Guide is updated with each release of the product or when necessary. This table provides the update history of the EMC Smarts Integration Guide. Revision Description EN-000540-10 n n EN-000540-09 n n n Changed the product name to reflect the new licensing model for the 5.6 release. Modified the adapter instance test step in “Add an Adapter Instance,” on page 16 for the 5.6 release.
EMC Smarts Integration Guide 8 VMware, Inc.
Introduction to EMC Smarts Integration 1 Integrating vCenter Operations Manager and EMC Smarts improves the performance of both products and makes it easier to predict, diagnose, and prevent problems in your IT infrastructure.
EMC Smarts Integration Guide For more information about these features and how to use them, see “Viewing Alerts in EMC Smarts,” on page 31. NOTE The Global Console is called the EMC Smarts Global Console in EMC Smarts 7.x and the EMC Ionix Global Console in EMC Smarts 8.1 and 9.0. Installation and Configuration Requirements Before you configure EMC Smarts integration, verify that your system meets EMC Smarts compatibility and credential requirements.
Installing the EMC Smarts Adapter 2 The EMC Smarts adapter is an embedded adapter for vCenter Operations Manager. The adapter collects metrics, change events, and resource topology information from EMC Smarts. The procedure you follow to install the EMC Smarts adapter depends on whether you have a vCenter Operations Manager Standalone or vApp installation.
EMC Smarts Integration Guide 6 Click Yes to start the describe process and click OK. The Custom user interface finds the adapter files, gathers information about the abilities of the adapter, and updates the user interface with information about the adapter. If you have remote collectors, it installs the adapter on the remote collectors. The describe process might take several minutes. When the describe process is finished, the adapter appears in the Adapters Info pane.
Chapter 2 Installing the EMC Smarts Adapter 12 VMware, Inc. Verify that the build number in the Adapter Version column for the adapter matches the build number in the PAK file that you uploaded.
EMC Smarts Integration Guide 14 VMware, Inc.
Configuring EMC Smarts Integration 3 To configure EMC Smarts integration, you must perform procedures in vCenter Operations Manager and EMC Smarts.
EMC Smarts Integration Guide Add an Adapter Instance You must add an adapter instance for each EMC Smarts domain from which vCenter Operations Manager collects data. When you add an adapter instance for the EMC Smarts adapter, you define the adapter type, identify the EMC broker and EMC Smarts domain, and select or add a credential. Prerequisites n Install the EMC Smarts adapter. See Chapter 2, “Installing the EMC Smarts Adapter,” on page 11.
Chapter 3 Configuring EMC Smarts Integration 13 (Optional) Click Test to test the adapter instance. IMPORTANT In pre-5.6 installations, this test does not provide accurate results if you configured an EMC Smarts SecureBroker Credentials credential kind for the adapter instance. The test always fails, even when the credentials are correct. 14 Click OK to save your configuration. What to do next By default, the adapter instance collects metrics every five minutes.
EMC Smarts Integration Guide Discover Resources If you disable auto discovery when you add an EMC Smarts adapter instance, you must discover resources manually. If you have multiple EMC Smarts adapter instances, discover resources for the AM, PM, or AM-PM instances first followed by the ACM, ESM, and SAM instances. Although the manual discovery process returns a list of all of the available resources for the adapter instance, you need to add only one resource.
Chapter 3 Configuring EMC Smarts Integration What to do next You might want to edit certain resources. For example, you might want to modify hard thresholds for a specific resource or define super metrics for a container resource. For information about editing resources and defining super metrics, see the administration guide for your vCenter Operations Manager version.
EMC Smarts Integration Guide Procedure 1 Open the plugin.properties file in a text editor. The plugin.properties file is in the vcenter-ops/user/plugins/outbound/Smarts_alertplugin/conf folder. 2 List the alerts to send in the sendByType property. Type each alert type in the format Typen and each alert subtype in the format Subtypen. Separate alert subtypes with a comma.
Chapter 3 Configuring EMC Smarts Integration 3 Set the SM_CLASSPATH statement to the path for the vcops_emc.jar file. For example: SM_CLASSPATH= C:\InCharge7\SAM\smarts\local\classes\vcops_emc.jar What to do next Add the custom view to the Global Console. See “Add the Custom View in the Global Console,” on page 21. Add the Custom View in the Global Console After you install the vCenter Operations Manager custom view on the EMC Smarts server, you must add the custom view in the Global Console.
EMC Smarts Integration Guide Procedure 1 Copy the Launch-vcops-UI-Object.cmd file to the SmartsRoot/SAM/smarts/local/actions/client folder on each Global Console client computer. SmartsRoot is the root folder of the EMC Smarts installation. The default root folder is InCharge7 for EMC Smarts 7.x and InCharge8 for EMC Smarts 8.1. 2 Copy the launch-vcops-action-windows.xml file to the SmartsRoot/SAM/smarts/local/conf/ics folder on the SAM server computer. 3 Open the Launch-vcops-UI-Object.
Chapter 3 Configuring EMC Smarts Integration Test the Integration Tools Installation After you install and configure the vCenter Operations Manager integration tools, test the tools to verify that the installation was successful. Prerequisites Install and configure the vCenter Operations Manager integration tools. See “Install and Configure Integration Tools Files,” on page 21. Procedure 1 Stop and start the Global Console.
EMC Smarts Integration Guide n Add Threads on page 27 You can increase the number of threads and connections that vCenter Operations Manager generates to collect metrics from each EMC Smarts adapter instance. Additional threads can improve performance, but they can also use more domain resources. n Configure White and Black Lists on page 28 You can configure the EMC Smarts adapter to use white and black lists to filter resources.
Chapter 3 Configuring EMC Smarts Integration rel::InstrumentedBy::Processor_Performance ICPM.subscription.1=CurrentUtilization ICPM.classes.2=top::UnitaryComputerSystem op::getMemory::Memory rel::InstrumentedBy::Memory_Performance ICPM.subscription.2=BufferMissPct,BufferUtilizationPct,FreeMemory,FreeMemoryPct, LargestFreeBuffer,LargestFreeBufferPct,TotalBufferAllocationFailures,TotalMemory #ICPM.classes.
EMC Smarts Integration Guide ESM.classes.3=bottom::FileSystem_Performance_WMI rel1::Instruments::FileSystem op::getSystem::UnitaryComputerSystem ESM.subscription.3=AvailableSpace,Mounted,StorageSize,FreeSpaceKB,TotalSizeKB,UtilizationPct ESM.classes.4=bottom::SpCounter_Instrumentation rel1::Instruments::SpCounter op::getSystem::UnitaryComputerSystem ESM.subscription.4=spProcessCount,spProcessCountRate SAM.topo.1=RedundancyGroup::ComposedOf SAM.topo.2=HierarchicalGroup::ConsistsOf SAM.topo.
Chapter 3 Configuring EMC Smarts Integration Object Definition Groups An object definition group describes the object hierarchy from the starting point to an object. Each group contains a relationship type, relationship property name, and the base class to expect from the relationship. Each value is separated by double colons (::). The relationship type can be op, rel, or rel1. A class operation that takes no parameters and returns a set of objects.
EMC Smarts Integration Guide 2 Set the ThreadCount property to a number between 1 and 4. Values higher than 4 result in little or no benefit in vCenter Operations Manager and can seriously degrade performance in the EMC Smarts domain. The default is 2. 3 Restart the vCenter Operations Manager collector to make your changes take effect. Configure White and Black Lists You can configure the EMC Smarts adapter to use white and black lists to filter resources.
Chapter 3 Configuring EMC Smarts Integration Unlike performance metrics, which typically come from the INCHARGE-AM-PM suite, events typically come from the INCHARGE-SA suite. You should create a separate EMC Smarts adapter instance to connect to the SA suite to monitor for events. Events from EMC Smarts appear for a resource in vCenter Operations Manager only if vCenter Operations Manager is actively monitoring for that resource.
EMC Smarts Integration Guide 2 Set the DoSmartDiscovery property to true to enable smart discovery. The default is false. 3 Restart the vCenter Operations Manager collector to make your changes take effect. Configure How the Adapter Handles Smarts Processor Metrics You can configure how the EMC Smarts adapter handles Smarts processor metrics. Procedure 1 Open the smarts_adapter.properties file in a text editor. In a vApp installation, modify the smarts_adapter.
Viewing Alerts and EMC Smarts Information 4 You can view vCenter Operations Manager alerts in EMC Smarts and you can view EMC Smarts information in vCenter Operations Manager.
EMC Smarts Integration Guide Figure 4-2. Global Console Custom View Panel n The blue bar at the top of the page shows the type of alert, when it started, how long it lasted, and the name of the resource that generated it. The internally assigned alert ID appears in the top right of the custom view. n The middle pane shows information about the event that triggered the alert, including the type of trigger, the associated resource or metric, and details about the trigger.
Chapter 4 Viewing Alerts and EMC Smarts Information View Alert Details from the Global Console Custom View You can view alert details in vCenter Operations Manager from the Global Console custom view panel. Prerequisites Install and configure the Global Console custom view. See “Installing and Configuring the Global Console Custom View,” on page 20. Procedure n Click the arrow at the top right of the Global Console custom view panel to open the Alert Detail page in vCenter Operations Manager.
EMC Smarts Integration Guide 2 Right-click the object in the list. 3 From the pop-up menu, select Client Tools > View Object in vCenter Operations. If you are not logged in to vCenter Operations Manager, a prompt appears and you must log in before the Resource Detail page opens. Use a user name and password that has access rights to view resource details. NOTE vCenter Operations Manager opens in a new browser window or tab, depending on your browser settings.
Chapter 4 Viewing Alerts and EMC Smarts Information Real-Time Performance Dashboard Example This dashboard shows the real-time performance of the CPU use and overall health metrics for all of the resources imported from EMC Smarts. Figure 4-4. Real-Time Performance Information Each Heat Map widget shows a color-coded square for each defined resource. Red indicates a poorly performing resource and green indicates good performance.
EMC Smarts Integration Guide Finding Nonexistent EMC Smarts Resources The EMC Smarts adapter creates the SMARTS Entity Status resource tag in the vCenter Operations Manager user interface. You can select the NotExisting value for this resource tag to find resources that the EMC Smarts adapter discovered that were later removed in EMC Smarts. When resources are removed in EMC Smarts, they remain in the vCenter Operations Manager user interface until you delete them.
Troubleshooting the EMC Smarts Adapter 5 Known troubleshooting information can help you diagnose and correct problems with the EMC Smarts adapter. This chapter includes the following topics: n “Troubleshooting an EMC Smarts Adapter Instance,” on page 37 n “Viewing System Log Files,” on page 37 n “Resolving Common Problems,” on page 38 Troubleshooting an EMC Smarts Adapter Instance Perform these general troubleshooting steps to diagnose and correct problems with an EMC Smarts adapter instance.
EMC Smarts Integration Guide log4.logger.com.integrien.adapter3.symmetrix.objects.LunDataPointObject=DEBUG NOTE If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level to DEBUG only for short periods of time. For information about viewing log files and modifying logging levels, see the online help. Resolving Common Problems Follow recommended procedures when you resolve problems with the EMC Smarts adapter.
Chapter 5 Troubleshooting the EMC Smarts Adapter NetworkAdapter_Performance::I-Port_Performance_MIB2-PORT-10.118.52.34/1 not found; in file "t:/DMT-9.0.0.X/1304/smarts/repos/mr/dyn_acc.c" at line 1587 at com.smarts.remote.SmRemoteInterfaceHandler.getResponse(SmRemoteInterfaceHandler.java:116) at com.smarts.remote.SmRemoteInterfaceHandler.getProperties(SmRemoteInterfaceHandler.java:4817) at com.smarts.remote.SmRemoteInterfaceHandler.getProperties(SmRemoteInterfaceHandler.java:4791) at com.integrien.
EMC Smarts Integration Guide 40 VMware, Inc.
Index A O adapter intance 16 alert details 33 alert types 19 alerts 9 audience information 5 outbound alert type 19 outbound alerts 19 B black list 28 C class not found errors 38 classes statements 26 common problems 38 configuration steps 15 credentials 17 custom view 20, 21 custom view panel 31 D dashboards 34 data sharing flow 10 discover resources 18 R reading events 28 real-time performance dashboard example 35 requirements 10 resource details 33 resource health dashboard example 34 resource to
EMC Smarts Integration Guide 42 VMware, Inc.
