VMware vCenter Operations Manager Administration Guide Custom User Interface vCenter Operations Manager 5.7 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.
VMware vCenter Operations 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 © 2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents VMware vCenter Operations Manager Administration Guide 7 1 Configuring and Managing vCenter Operations Manager 9 Configuring vCenter Operations Manager 9 Managing vCenter Operations Manager 9 Log In as the admin User 10 Using the Custom User Interface 11 2 Configuring Adapters 13 How Adapters Collect and Process Data 13 Defining Adapter Instances 14 Modifying Adapter Instances 16 Customize an Adapter Kind Icon 17 Suppress No Data Receiving Alerts 17 3 Configuring Resources 19 Defining Resour
VMware vCenter Operations Manager Administration Guide Use a Tag to Find an Application 62 Modifying Applications 63 Modifying Application Tags 64 6 Configuring and Managing Users 65 Create a User Account 65 Importing LDAP Users 66 Configuring User Groups and Access Rights 70 Set Password Policies 72 Maintaining Users and User Groups 73 Run the User Audit Report 75 7 Configuring Alert Notifications 77 Configuring and Modifying Alert Handler Instances 77 Configuring Email Alert Notifications 81 Modifyin
Contents Replication MQ Sender Is Blocked 124 10 Backing Up and Recovering Data 125 Backing Up and Recovering Data Components 125 Backing Up and Recovering Processing Components 132 11 Configuring the Repository Adapter 137 Repository Adapter Requirements and Limitations 137 Repository Adapter Configuration Steps 139 Creating a Database User for the Repository Adapter 139 Configure the Source Database Connection for the Repository Adapter 139 Configure the Output Destination for the Repository Adapter
VMware vCenter Operations Manager Administration Guide 6 VMware, Inc.
VMware vCenter Operations Manager Administration Guide The VMware vCenter Operations Manager Administration Guide (Custom User Interface) describes how to configure ® and manage the VMware vCenter™ Operations Manager Custom user interface. Intended Audience The information in this document is intended for anyone who must configure or manage vCenter Operations Manager by using the Custom user interface. VMware, Inc.
VMware vCenter Operations Manager Administration Guide 8 VMware, Inc.
Configuring and Managing vCenter Operations Manager 1 Before vCenter Operations Manager can begin collecting and analyzing your data, you must configure it. After it is configured, you can manage vCenter Operations Manager by performing basic system administration tasks.
VMware vCenter Operations Manager Administration Guide n View system performance and status information and examine log messages. See Chapter 8, “Performing Basic System Administration Tasks,” on page 103. n View, respond to, and resolve administrative system alerts. See Chapter 9, “Resolving Administrative System Alerts,” on page 117. n Back up vCenter Operations Manager data and processing components. See Chapter 10, “Backing Up and Recovering Data,” on page 125.
Chapter 1 Configuring and Managing vCenter Operations Manager Using the Custom User Interface When you log in to the Custom user interface, your Home page appears in the browser window. The Home page contains the following components. Dashboards The tabs near the top of the Home page are your dashboards. The user groups to which your account belongs determine which dashboards are available to you. You can switch to a different dashboard by clicking its tab or selecting it from the Dashboards menu.
VMware vCenter Operations Manager Administration Guide 12 VMware, Inc.
Configuring Adapters 2 vCenter Operations Manager uses adapters to exchange information with the data collection landscape. Configuring adapters involves defining and maintaining adapter instances and credentials.
VMware vCenter Operations Manager Administration Guide Embedded adapters create resources through manual or auto-discovery. A particular embedded adapter might support one or both resource creation methods. Manual discovery You send a request to the data source to return all available resources and select the resources to add. This method is often referred to as discovering resources or the discovery process.
Chapter 2 Configuring Adapters Add a Credential You must define a credential for each adapter instance that provides data to vCenter Operations Manager. Adapter instances use credentials to sign on to data sources. The information that you provide depends on the adapter kind and credential kind combination. Prerequisites View the list of defined credentials for the adapter kind and credential kind combination. See “View the List of Defined Credentials,” on page 14.
VMware vCenter Operations Manager Administration Guide Modifying Adapter Instances To maintain adapter instances, you might need to edit or delete credentials or adapter instances. Edit a Credential When you edit a credential, you can change its user name or password. The information that you can modify depends on the adapter kind and credential kind combination. Prerequisites View the list of defined credentials for the adapter kind and credential kind combination.
Chapter 2 Configuring Adapters Delete an Adapter Instance If an adapter instance is no longer needed, you can delete it. Procedure 1 Select Environment > Configuration > Adapter Instances. 2 (Optional) Filter the list of adapter instances. a Select the collector to use from the Collector drop-down menu. Unless you added additional collectors, the only available collector is vCenter Operations Server. You can change the name of this collector when you install vCenter Operations Manager Standalone.
VMware vCenter Operations Manager Administration Guide 2 Add the property disabledNoDataReceivingAlertIds = resourceID. resourceID is the resource ID of the adapter instance. 18 3 Save your changes and close the advanced.properties file. 4 Restart the Analytics service. VMware, Inc.
Configuring Resources 3 A resource is any entity in your environment for which vCenter Operations Manager can collect data, such as a router, switch, firewall, database, application server, or TCP/IP-based application.
VMware vCenter Operations Manager Administration Guide Discover Resources You typically define resources to vCenter Operations Manager through the manual discovery process. Discovering resources is usually more efficient than adding resources individually. NOTE You use discovery to define resources for embedded adapters. Resources that use external adapters are already added to vCenter Operations Manager and do not need to be discovered.
Chapter 3 Configuring Resources 10 11 Select options for each resource kind. Option Description Import Import the resources but do not start collecting data. Resources appear in the resource list as Not Collecting and data is not stored and analysis is not performed. Collect Import the resources and start collecting data. When you select the Collect check box, the Import check box is also selected.
VMware vCenter Operations Manager Administration Guide 6 Select an adapter instance from the Adapter instance drop-down menu, or click Add to add a new adapter instance. 7 Select a resource kind from the Resource kind drop-down menu. Additional configuration options might appear, depending on your selection. 8 Type the name of the resource that the adapter monitors in the Target to collect from text box. The name must be the name of the resource as it appears in the adapter's operating environment.
Chapter 3 Configuring Resources Creating and Assigning Resource Tags A large enterprise can have thousands of resources defined in vCenter Operations Manager. Creating resource tags and tag values makes it easier to find resources and metrics in vCenter Operations Manager. With resource tags, you select the tag value assigned to a resource and view the list of resources that are associated with that tag value. A tag is a type of information, such as Application or GEO Location.
VMware vCenter Operations Manager Administration Guide Table 3-1. Predefined Tags Tag Description Collectors (Full Set) Each defined collector is a tag value. Each resource is assigned to the tag value for the collector that it uses when you add the resource to vCenter Operations Manager. The default collector is vCenter Operations Server. Application Each defined application is a tag value. When you add a tier to an application, the tier is assigned to that tag value.
Chapter 3 Configuring Resources What to do next Add a value to the resource tag. See “Add a Value to a Resource Tag,” on page 25. Add a Value to a Resource Tag A resource tag is a type of information, and a tag value is an individual instance of that type of information. You can add multiple values to a resource tag. If a resource tag is locked, you cannot add values to it. vCenter Operations Manager maintains locked resource tags. Prerequisites Add a resource tag. See “Add a Resource Tag,” on page 24.
VMware vCenter Operations Manager Administration Guide Associate a Resource with a Tag Value You can assign any number of resources to each tag value, and you can assign a single resource to tag values under any number of tags. Prerequisites n Create a resource tag. See “Add a Resource Tag,” on page 24. n Add a value to the resource tag. See “Add a Value to a Resource Tag,” on page 25. Procedure 1 Select Environment > Environment Overview.
Chapter 3 Configuring Resources 4 Select the resource from the list. Grouping Resources by Physical Location Depending on your environment, you might want to group some or all of your resources according to their physical location. When resources are grouped according to their physical location, you can see the health of all of the resources in a particular place.
VMware vCenter Operations Manager Administration Guide Create a GEO Location Tag Value Before you can assign resources to a location, you must create that location as a value of the GEO Location tag and define its position on the map. Create tag values for each of your office locations. Prerequisites Activate the geographical location feature in vCenter Operations Manager. See “Activate the Geographical Location Feature,” on page 27. Procedure 1 Select Environment > Environment Overview.
Chapter 3 Configuring Resources View the Resource Map You can use the world map on the Geographical tab on the Environment Overview page to see the health of the resources at some or all of your defined locations. The GEO widget shows a map similar to the map on the Geographical tab. You can add the GEO widget to any dashboard. Prerequisites n Activate the geographical location feature in vCenter Operations Manager. See “Activate the Geographical Location Feature,” on page 27.
VMware vCenter Operations Manager Administration Guide 3 4 (Optional) If the list of resources is long, filter the list to find the child resource or resources. Option Description Navigate the resource tag list for a resource Expand the resource tag and select a tag value that contains the resource. The resources for the tag value appear in the top pane of the List column. If you select more than one value for the same tag, the list contains resources that have either value.
Chapter 3 Configuring Resources Procedure 1 Select Environment > Environment Overview. 2 On the List tab, select the resource or resources to affect. You can press Ctrl+click to select multiple individual resources or Shift+click to select a range of resources. 3 Click the Perform Multi-Collecting icon. The Adapter Instance Resources window opens. The window lists all of the adapter instances that the selected resources use. 4 Click the adapter instance to start or stop metric collection.
VMware vCenter Operations Manager Administration Guide 6 Option Description Monthly Set the number of months between maintenance periods and either the day of the month or the week and day. Yearly Set to a specific date or a specific month, day, and week. Click OK to save the maintenance schedule. The new maintenance schedule appears in the list in the Manage Maintenance Schedules window and is available when you add or edit resources.
Chapter 3 Configuring Resources Delete a Maintenance Schedule When you do not need a maintenance schedule, you can delete it. Procedure 1 Select Environment > Maintenance Schedules. 2 Select the maintenance schedule to delete and cilck the Delete Schedule icon. 3 Click Yes on the confirmation window to delete the schedule. Edit a Maintenance Schedule When you edit a maintenance schedule, you can change the schedule name, start time and end times, and recurrence pattern.
VMware vCenter Operations Manager Administration Guide Edit Multiple Resources You can change the same property for multiple resources at the same time. For example, you can assign a new attribute package to several resources, or to all resources of a given resource kind, at the same time. You can change one or more properties and leave other properties unchanged. Procedure 1 Select Environment > Environment Overview. 2 On the List tab, select the resources to edit.
Chapter 3 Configuring Resources 2 Select the adapter kind that contains the resource kind for which you want to set defaults from the Adapter kind drop-down menu. 3 In the list on the left, select the resource kind. 4 Select the default attribute package from the Attribute package drop-down menu. 5 Select the default super metric package from the Super Metric package drop-down menu.
VMware vCenter Operations Manager Administration Guide Delete a Resource Tag or Tag Value If you do not need a resource tag or tag value, you can delete it. Procedure 1 Select Environment > Environment Overview. 2 Click the Manage Tags icon on the left side of the page. 3 Delete the tag or tag value. 4 Option Action Delete a tag Click the tag name and click the Remove Tag icon. Delete a tag value Expand the tag, select the value, and click the Remove Tag Value icon. Click OK.
Chapter 3 Configuring Resources 3 (Optional) To upload your own icon to use, click the Upload Icon icon, browse to and select the file to use, and click Open. The icon appears in the icon list. 4 Assign the resource kind icon. Option Action Assign an icon or change an assigned icon Select the resource kind in the list, click the icon to assign, and click the Assign Icon icon. Return to the default icon Select the resource kind and click the Assign Default Icons icon.
VMware vCenter Operations Manager Administration Guide 38 VMware, Inc.
Configuring Attribute Packages 4 vCenter Operations Manager can collect several types of data for a single resource. For example, for a database server, it might receive data on free disk space, CPU use, and the average response time for a database request. Each type of data is called an attribute in vCenter Operations Manager. A vCenter Operations Manager administrator creates attribute packages to tell vCenter Operations Manager which attributes to track for your resources.
VMware vCenter Operations Manager Administration Guide Dynamic and Hard Threshold Calculations A threshold is a value that marks the boundary between normal and abnormal behavior for a metric. When a metric crosses one of its thresholds, vCenter Operations Manager generates an anomaly. vCenter Operations Manager can use dynamic and hard thresholds. It defines dynamic thresholds for a metric based on historical and incoming data. A dynamic threshold changes, and a hard threshold is static.
Chapter 4 Configuring Attribute Packages Except for Self - Total, any metric that vCenter Operations Manager generates that begins with Self includes data only for the resource. Metrics that begin with Full Set include data for all of the resource's children, but do not include the resource itself. Table 4-1. vCenter Operations Generated Attribute Package Metrics Name Description Self - Health Score Health score of the resource. Self - Metric Count Number of metrics defined for the resource.
VMware vCenter Operations Manager Administration Guide n Set Hard Thresholds for an Attribute on page 43 By default, vCenter Operations Manager uses dynamic thresholding for attributes. You can override this behavior by setting hard thresholds for an attribute in an attribute package. n Metric Data Types on page 44 Most of the data that vCenter Operations Manager stores and analyzes is numeric, but it can also track other types of data and alert you if the values are unexpected.
Chapter 4 Configuring Attribute Packages To make the attribute package the default package for resources of its resource kind, see “Change the Default Settings for a Resource Kind,” on page 34. Set Hard Thresholds for an Attribute By default, vCenter Operations Manager uses dynamic thresholding for attributes. You can override this behavior by setting hard thresholds for an attribute in an attribute package. A hard threshold is static. A hard threshold changes only when you change it.
VMware vCenter Operations Manager Administration Guide Metric Data Types Most of the data that vCenter Operations Manager stores and analyzes is numeric, but it can also track other types of data and alert you if the values are unexpected. For example, if a resource sends the string Good when operation is normal and Bad when a problem occurs, vCenter Operations Manager analytics can learn this information and generate an anomaly when it receives Bad. Table 4-2.
Chapter 4 Configuring Attribute Packages 9 Click OK to return to the Manage Attribute Packages window. Creating Super Metric Packages You can combine different metrics by using mathematical formulas to define a super metric. Super metrics are useful when you need to track combinations of metrics, either from a single resource or, more commonly, from multiple resources. A super metric is a formula that contains a combination of one or more metrics for one or more resources.
VMware vCenter Operations Manager Administration Guide n Import a Super Metric on page 52 You can import a super metric that was exported from another instance of vCenter Operations Manager. Design a Super Metric Because super metric formulas can be complex, design a super metric before you use the vCenter Operations Manager user interface to create it. The key to creating a super metric that alerts you to the right situations is knowing your own enterprise and your data.
Chapter 4 Configuring Attribute Packages Table 4-3. Looping Functions Function Description avg Average of the collected values. combine Combines all of the values of the metrics of the included resources into a single metric timeline. count Number of values collected. max Maximum of the collected values. min Minimum of the collected values. sum Total of the collected values. Looping Function Formats All looping functions have four possible formats. Table 4-4.
VMware vCenter Operations Manager Administration Guide Single Functions Single functions work on only a single value or a single pair of values. Table 4-5. Single Functions Function Format Description abs abs(x) Absolute value of x. x can be any floating point number. acos acos(x) Arccosine of x. asin asin(x) Arcsine of x. atan atan(x) Arctangent of x. ceil ceil(x) The smallest integer that is greater than or equal to x. cos cos(x) Cosine of x. cosh cosh(x) Hyperbolic cosine of x.
Chapter 4 Configuring Attribute Packages n To select a resource and metric, click the resource in the Resource pane and double-click the metric in the Metrics pane. The database IDs of the resource and metric appear in the formula line at the top of the window. n Define a metric for the resource to which the super metric is assigned. a In the Resources pane, click any resource that contains the metric to use. b Click the This Resource icon or type $This on the formula line.
VMware vCenter Operations Manager Administration Guide Procedure 1 Select Environment > Super Metrics and click the Super Metric Editor tab. 2 Click the Add New Super Metric icon. 3 Type a name for the super metric in the Super Metric Name text box. 4 Define the formula for the super metric. Select, in order, each function or operator to use and the metrics or attribute kinds to use in each function or with each operator.
Chapter 4 Configuring Attribute Packages 5 (Optional) To set the upper dynamic threshold violation for a super metric as a KPI, select the Violation of the Upper Dynamic threshold is a Key Indicator check box. 6 (Optional) To set the lower dynamic threshold violation for a super metric as a KPI, select the Violation of the Lower Dynamic threshold is a Key Indicator check box.
VMware vCenter Operations Manager Administration Guide Export a Super Metric You can export a super metric from one vCenter Operations Manager instance and import it to another vCenter Operations Manager instance. Procedure 1 Select Environment > Super Metrics and click the Super Metric Editor tab. 2 Select the super metric to export and click the Export icon. vCenter Operations Manager creates a super metric file, for example, SuperMetric.bin.
Chapter 4 Configuring Attribute Packages Procedure 1 Select Environment > Configuration > Attribute Packages. 2 (Optional) Select the adapter kind of the attribute package to edit from the Adapter kind drop-down menu. 3 (Optional) Select the resource kind of the attribute package to edit from the Resource kind drop-down menu. 4 Select the attribute package to edit and click the Edit Selected Attribute Package icon. 5 Edit the attribute package.
VMware vCenter Operations Manager Administration Guide Modifying Super Metric Packages To maintain your super metric packages in vCenter Operations Manager, you might need to edit or remove a super metric package. Edit a Super Metric When you edit a super metric, you can change its name and edit the super metric formula.
Chapter 4 Configuring Attribute Packages 6 (Optional) To set the upper dynamic threshold violation for a super metric as a KPI, select the Violation of the Upper Dynamic threshold is a Key Indicator check box. 7 (Optional) To set the lower dynamic threshold violation for a super metric as a KPI, select the Violation of the Lower Dynamic threshold is a Key Indicator check box.
VMware vCenter Operations Manager Administration Guide Super Metric Use Case Consider an application, such as a Web-based business, where all of the servers in a tier perform a similar activity, such as processing transactions. In this use case, it might be useful to know the average of a metric, such as CPU usage, for all of the servers. You can define a super metric to track this number and assign it to the tier. Prerequisites n Become familiar with creating or editing super metric packages.
Chapter 4 Configuring Attribute Packages 2 To enable or disable weighted metric groups, set the useMetricGroupWeightingForHealth property to true or false. 3 Save your changes and close the analytics.properties file. 4 Restart the Analytics service to make your changes take effect. Prioritize Threshold Checking You can pause dynamic threshold calculation when the data queue size exceeds a certain value. This feature enables you to prioritize threshold checking over the dynamic threshold calculation.
VMware vCenter Operations Manager Administration Guide 58 VMware, Inc.
Configuring Applications 5 An application is a type of container resource that defines an interdependent set of hardware and software components that delivers a specific capability that supports your business. A vCenter Operations Manager administrator builds application topologies to determine how applications are affected when one or more of the resources that they contain experience problems.
VMware vCenter Operations Manager Administration Guide To maintain the highest possible server performance, vCenter Operations Manager tracks each captured fingerprint to determine if the set of conditions it represents recurs and if those conditions help to predict future problems. If a fingerprint is not useful in predicting problems, vCenter Operations Manager deactivates it and stops checking for its recurrence. Add an Application You build an application topology by adding an application.
Chapter 5 Configuring Applications Creating and Assigning Application Tags You can use application tags to categorize and manage applications in your environment. Creating application tags and tag values makes it easier to find applications in vCenter Operations Manager. Rather than searching through thousands of applications in a long list, you can easily use tags to find the applications you want.
VMware vCenter Operations Manager Administration Guide What to do next Associate an application with the tag value. See “Associate an Application with a Tag Value,” on page 62. Associate an Application with a Tag Value When an application is associated with a tag value, you can use the application tag hierarchy to select it in vCenter Operations Manager. Prerequisites n Create an application tag. See “Add an Application Tag,” on page 61. n Add a value to the application tag.
Chapter 5 Configuring Applications Modifying Applications To maintain your applications in vCenter Operations Manager, you might need to add or delete tiers, add or delete resources from tiers, change the names of tiers, or delete applications. Edit an Application When you edit an application, you can add and delete tiers, add and delete resources from tiers, and change the names of tiers. IMPORTANT Do not delete a tier that contains resources for which metrics are being collected.
VMware vCenter Operations Manager Administration Guide Modifying Application Tags To maintain application tags, you might need to remove an application from a tag value, edit or delete an application tag, or edit or delete a tag value. Edit an Application Tag When you edit an application tag, you can change the tag name and the names of its tag values. Procedure 1 Select Environment > Applications Overview. 2 Click the Manage Tags icon on the left side of the page. 3 Edit the application tag.
Configuring and Managing Users 6 To use vCenter Operations Manager, a user must have a user account. If your organization uses an LDAP user database, a vCenter Operations Manager administrator can import some or all of the LDAP users to vCenter Operations Manager. vCenter Operations Manager provides user group-based security. You can place each user in one or more user groups, and you can assign access rights to user groups.
VMware vCenter Operations Manager Administration Guide 5 Select the Is Enabled check box to activate the user profile. If you do not select this check box, the user account is inactive and the user cannot log in to vCenter Operations Manager. 6 Deselect the Is Locked check box. If you select this check box, the user account is locked and the user cannot use vCenter Operations Manager. 7 Select Change Pswd At Next Login to force the user to change his or her password at the next login.
Chapter 6 Configuring and Managing Users n Stop Importing LDAP Users on page 70 You can configure the autosynchronization feature to stop importing LDAP users to a vCenter Operations Manager group. Add or Modify an LDAP Host Definition To import LDAP users, you must define the LDAP host in vCenter Operations Manager. You can also modify existing LDAP host definitions. Procedure 1 Select Admin > Security. 2 In the User Accounts pane, click the Import From LDAP icon.
VMware vCenter Operations Manager Administration Guide 6 Option Description Member Match Field The attribute name of a User object to be matched with the Member entry from the Group object. If you do not specify an attribute name, vCenter Operations Manager treats the Member entry as a DN. LDAP Context Attributes Additional attributes to apply to the LDAP context environment. Type sets of key=value pairs separated by commas, for example, java.naming.referral=ignore,java.naming.ldap.deleteRDNfalse.
Chapter 6 Configuring and Managing Users 3 Select the LDAP host from the Ldap Host drop-down menu. vCenter Operations Manager populates the user name and password text boxes by using values from the LDAP host definition. 4 Click Lookup. vCenter Operations Manager searches the LDAP data and lists all of the users that it finds. If the search returns a user who is already imported to vCenter Operations Manager, that row is dimmed and locked. You cannot reimport users. 5 Select the users to import.
VMware vCenter Operations Manager Administration Guide 9 Repeat Step 6 through Step 8 for each LDAP group to import. 10 Click OK to save your configuration. The next time that autosynchronization runs, vCenter Operations Manager retrieves the members of the LDAP groups that you selected and adds them to the mapped vCenter Operations Manager groups. Stop Importing LDAP Users You can configure the autosynchronization feature to stop importing LDAP users to a vCenter Operations Manager group.
Chapter 6 Configuring and Managing Users n Configure Access Rights for a User Group on page 72 To enable users to perform certain actions in vCenter Operations Manager, you must assign access rights to each user group. You define which menus users within a user group can access and the actions that the users can perform. n Assign a User to a User Group on page 72 You can assign any number of users to a user group, and each user can belong to any number of groups.
VMware vCenter Operations Manager Administration Guide Configure Access Rights for a User Group To enable users to perform certain actions in vCenter Operations Manager, you must assign access rights to each user group. You define which menus users within a user group can access and the actions that the users can perform. Prerequisites Add user groups to vCenter Operations Manager. See “Add a User Group,” on page 71. Procedure 1 Select Admin > Security.
Chapter 6 Configuring and Managing Users Procedure 1 Select Admin > Security. 2 Select the Password Policy tab. 3 In the Account Lockout Policy group, configure the account lockout settings. 4 5 6 Option Description Active Locks users out of vCenter Operations Manager after the number of failed login attempts specified in Allowed Login Attempts. Allowed Login Attempts The number of login attempts that a user can attempt before being locked out of vCenter Operations Manager.
VMware vCenter Operations Manager Administration Guide 4 5 Change the user account options to modify the behavior of the user account. Option Action Enable or disable the user account Select or deselect the Is Enabled check box. When a user account is disabled, it becomes inactive and the user cannot log in to vCenter Operations Manager. Lock or unlock the user account Select or deselect the Is Locked check box. When a user account is locked, the user cannot use vCenter Operations Manager.
Chapter 6 Configuring and Managing Users Run the User Audit Report The User Audit report shows information about the users, groups, and access rights configuration of a vCenter Operations Manager system. For each user, it shows the groups that the user belongs to and the access rights that are granted to each group. The access rights are arranged by group. Procedure 1 Select Admin > User Audit Report. 2 Select the report format from the Report type drop-down menu. 3 Click Submit.
VMware vCenter Operations Manager Administration Guide 76 VMware, Inc.
Configuring Alert Notifications 7 vCenter Operations Manager generates an anomaly when a metric violates its threshold. If vCenter Operations Manager determines that the current combination of anomalies indicates a real problem, it generates an alert. An alert is a notification to inform you of an abnormal condition that might require attention. Alerts appear in the vCenter Operations Manager user interface on the Alerts Overview page, in the alert watch list, and in the Alerts widget.
VMware vCenter Operations Manager Administration Guide n Add or Edit a Log File Alert Handler Instance on page 79 A log file alert handler instance saves alert nominations to a log file on the vCenter Operations Manager server. n Add or Edit an EMC Smarts Alert Handler Instance on page 80 If you use vCenter Operations Manager with EMC Smarts, you can configure an alert handler instance to send alerts directly to the EMC Smarts SAM Global Console.
Chapter 7 Configuring Alert Notifications Add or Edit an SNMP Trap Alert Handler Instance An SNMP trap alert handler instance sends all alerts, of all types, as SNMP traps to a destination host that you specify. Any filtering, by alert type or any other critieria, must be done on the destination host. The MIB file vcenter-ops\user\plugins\outbound\snmp_alertplugin\mibs\VMWARE-VCOPS-EVENT-MIB.mib contains the information that you need to enable the receiving party to interpret the traps.
VMware vCenter Operations Manager Administration Guide 3 4 Configure or modify the alert handler settings. Option Action Instance Name Type a name for the alert handler instance. Alert Output Folder Type the log file path. The path must be on the vCenter Operations Manager Server. The complete path must be no longer than 50 characters. If the path is too long, vCenter Operations Manager cannot update the alert instance. Click OK to save your configuration.
Chapter 7 Configuring Alert Notifications 5 Click OK to save your configuration. vCenter Operations Manager starts the alert handler instance. Start or Stop an Alert Handler Instance You can start and stop alert handler instances from the vCenter Operations Manager user interface. NOTE When you create an alert handler instance, vCenter Operations Manager starts it for you. Procedure 1 Select Admin > Configure Outbound Alert. 2 Select the alert handler instance.
VMware vCenter Operations Manager Administration Guide emailFilter.xml File emailFilter.xml is an XML file that defines the filtering rules and template files to use for email alert notifications. The file also contains general settings that apply to all email alert notifications. IMPORTANT Do not edit emailFilter.xml directly unless you are familiar with XML structure and syntax. A formatting mistake might prevent email alert notifications from working. If you edit emailFilter.
Chapter 7 Configuring Alert Notifications 9495551212@vtext.com Element The first part of the emailFilter.xml file is a element, which contains a series of elements. Each element specifies the template file to use for alert email messages of a particular type, subtype, and status. You can use the following types of template files.
VMware vCenter Operations Manager Administration Guide Table 7-1. Element Attributes Attribute Description and Values alert_type Alert type. Valid values are as follows: n n n n n n n n n n n alert_subtype RESOURCE TIER APPLICATION FINGERPRINT_PREDICTION FINGERPRINT_GENERATION SMART CLASSIC ADMINISTRATIVE HEALTH RISK EFFICIENCY Alert subtype.
Chapter 7 Configuring Alert Notifications Table 7-2. Elements for General Options Element Description (Optional) Sets the address to use as the from address for all email alert notifications. If you do not include this element, vCenter Operations Manager sends messages from the default email sender address in the vcenter-ops\user\conf\email.properties configuration file. Element The rest of the emailFilter.xml file contains one or more elements.
VMware vCenter Operations Manager Administration Guide Table 7-3. Valid Type Settings (Continued) Type Description Status Status of the alert. Valid values are ACTIVE, NEW, or CANCEL. For example: Cancel Tag Tag name and value pair in the format TagName:TagValue. For example: Geo Location:Chicago Tier Tier within an application. You must include the application name and the tier name in the format Application:Tier.
Chapter 7 Configuring Alert Notifications n You must store custom email template files in the vcenterops\user\plugins\outbound\filter_alertplugin\conf\custom_templates directory. Placeholders All email template files can include placeholders, which are replaced with information from the alert. A placeholder can be a replaced by a single value, such as an alert type, or it can represent multiple values, such as the health of the parent or child resources.
VMware vCenter Operations Manager Administration Guide For the vCenter Operations Manager vApp, you must edit emailFilter.xml directly. You cannot use the Configuration File editor with the vCenter Operations Manager vApp. For descriptions of the XML elements in emailFilter.xml, see “emailFilter.xml File,” on page 82. Procedure 1 To start the Configuration File editor, use any standard Windows method to run the file FilterPluginConfEditor.jar. FilterPluginConfEditor.jar is in the vcenter-ops\user\plugins\
Chapter 7 Configuring Alert Notifications 11 To make your changes take effect, restart the email filter plug-in. a In vCenter Operations Manager, select Admin > Configure Outbound Alert. b Select the email filter plug-in instance and click the Stop icon. c Select the email filter plug-in instance and click the Start icon. Add an Email Template Definition An email template definition specifies which email template file to use for a given alert type, subtype, and status.
VMware vCenter Operations Manager Administration Guide 6 In the Template text box, type the name of the email template file to use for the email alert notifications that meet the conditions in the template definition. The email template file does not have to exist. You can define the template and create the actual email template file later. 7 Click OK to close the Email Template window. 8 Save your changes. Option Action Save your changes to the currently open file Select Actions > Save.
Chapter 7 Configuring Alert Notifications 4 Select Actions > Save to save your changes to the currently open file, or select Actions > Save As to save your changes to a different file. The plug-in only reads the emailFilter.xml file. 5 Select Actions > Close to close the Configuration File editor. 6 To make your changes take effect, restart the email filter plug-in. a In vCenter Operations Manager, select Admin > Configure Outbound Alert.
VMware vCenter Operations Manager Administration Guide 6 7 To edit an email address for a condition, select the address and click the Edit icon. Option Description Address type Select email to send both the message subject and text, or SMS to send only the message subject to the email address. Address value Type the destination email address.
Chapter 7 Configuring Alert Notifications 4 Click the Delete icon. 5 Select Actions > Save to save your changes to emailFilter.xml. 6 Select Actions > Close to close the Configuration File editor. 7 To make your changes take effect, restart the email filter plug-in. a In vCenter Operations Manager, select Admin > Configure Outbound Alert. b Select the email filter plug-in instance and click the Stop icon. c Select the email filter plug-in instance and click the Start icon.
VMware vCenter Operations Manager Administration Guide 6 To change the email address for the template definition, type a different email address in the Send to text box. The template definition is used for email alert notifications sent to this email address. 7 To change the email template file to use, type the name of a different template file in the Template text box. The email template file does not have to exist. You can define the template and create the actual email template file later.
Chapter 7 Configuring Alert Notifications 7 To make your changes take effect, restart the email filter plug-in. a In vCenter Operations Manager, select Admin > Configure Outbound Alert. b Select the email filter plug-in instance and click the Stop icon. c Select the email filter plug-in instance and click the Start icon. Configuring Mulitilevel Alert Rules You can configure complex alert rules that evaluate multiple conditions on related resources.
VMware vCenter Operations Manager Administration Guide Table 7-5. Element Attributes Attribute Description tag Specifies a text string. vCenter Operations Manager adds this text to the information string of alerts that the rule triggers. alert Specifies the resource kind on which the alert is defined. vCenter Operations Manager checks all resources of the specified resource kind if the resource or its parents satisfy the rule.
Chapter 7 Configuring Alert Notifications Configuring Hint Text for Alerts You can configure hint text for all types of alerts. Alert hint text can appear on the Alert Detail page in the Custom user interface or in email alert notifications. You configure hint text that appears in the user interface in the alert-hints.xml file. You use the {{AlertHints}} placeholder in an email template file to configure alert hint text for email alert notifications.
VMware vCenter Operations Manager Administration Guide Table 7-7. Element Attributes (Continued) Attribute Description alertSubtype Matches the subtype of the alert.
Chapter 7 Configuring Alert Notifications Table 7-7. Element Attributes (Continued) Attribute Description eventClass Class of an event that is part of the alert. Valid values are as follows: empty dt n ht n failure n system n cusum n noise n prediction n environment n change n notification n fault n multilevel ht For this attribute to be evaluated, you must also specify attributeKey. vCenter Operations Manager checks only events that have a matching attributeKey value.
VMware vCenter Operations Manager Administration Guide Alert Hint Text Definition Examples In the following example, the first alert hint text definition matches alerts that have the attribute key Super Metric|test and are assigned to resources that have the resource kind Tier. The second definition uses the eventClass and eventSubclass attributes to match all HT above alerts.
Chapter 7 Configuring Alert Notifications Configure Alerts for vCenter Server Events You can configure vCenter Server events to generate alerts. Procedure 1 Open the eventlist.txt file in the vcenter-ops\user\plugins\inbound\vmwarevi_adapter3\conf directory. The eventlist.txt file defines the list of events that the vCenter adapter collects from vCenter Server. 2 Type the event ID of the event to generate an alert and set it to alert. For example: vim.event.
VMware vCenter Operations Manager Administration Guide 102 VMware, Inc.
Performing Basic System Administration Tasks 8 vCenter Operations Manager administrators monitor system operations and perform basic system maintenance tasks, such as starting and stopping vCenter Operations Manager services. If a problem occurs that requires VMware assistance, an administrator can create a support bundle and send it to VMware technical support for analysis. System administrators are also responsible for monitoring and responding to administrative alerts.
VMware vCenter Operations Manager Administration Guide Interpreting Performance Information vCenter Operations Manager provides performance information related to its own operation. Performance information is divided into multiple panes on the Status tab. Health Status Shows the health graph and the current health score. To see the exact health score from a time on the graph, point to that time. You can point to the More icon to see its collector and other information.
Chapter 8 Performing Basic System Administration Tasks Collectors Info Shows the status of the synchronize process that vCenter Operations Manager runs for each collector. The synchronize process sends any updated configuration information from the controller to each adapter. The describe process sends information about the data that can be collected from each adapter to the vCenter Operations Manager server.
VMware vCenter Operations Manager Administration Guide Table 8-1. vCenter Operations Manager Standalone Services Windows Server Name Linux Server Name vcopsWebService vcopsserver vCenter Operations Manager Web service. Runs on the vCenter Operations Manager server. AnalyticsService analytics Analytics service. Runs on the vCenter Operations Manager server. ActiveMQ activemq ActiveMQ service. Runs on the vCenter Operations Manager server. CollectorService collector Collector service.
Chapter 8 Performing Basic System Administration Tasks n To start or stop individual vCenter Operations Manager services on a Windows server, use the Windows Services dialog box or open a command prompt and type the sc command. For example: sc start service_name sc stop service_name service_name is the name of the service on Windows.
VMware vCenter Operations Manager Administration Guide Enable Logging for Widgets You can enable logging for widgets by editing the log4.properties file. Procedure 1 Open the log4.properties file. For vCenter Operations Manager Standalone, log4.properties is in the vcenter_ops\user\conf directory. For the vCenter Operations Manager vApp, it is in the vcenter-ops\user\conf\web directory. 2 Add the following line after the line log4j.rootLogger=ERROR. log4j.logger.com.integrien.alive.
Chapter 8 Performing Basic System Administration Tasks Using an External Log Monitoring Tool If you use an external log file monitoring tool to search for significant messages in vCenter Operations Manager log files, you might want to check for specific message strings in specific log files. Analytics Log File Messages These messages in the analytics.log file might indicate that an Oracle database is down. ERROR [Thread-10] com.integrien.alive.common.hibernate.util.OracleConnectionProvider.
VMware vCenter Operations Manager Administration Guide Collector Log File Messages These messages in the collector.log file indicate that the ActiveMQ service is down. 2010-04-12 19:04:10,715 ERROR [ActiveMQ Task] org.apache.activemq.transport.failover.FailoverTransport.doReconnect - Failed to connect to transport after: 5 attempt(s) 2010-04-12 19:04:10,715 ERROR [Communicator] com.integrien.alive.collector.CommunicatorThread.connect - Can not connect to the MQ Broker.
Chapter 8 Performing Basic System Administration Tasks Delete Old Data in the File System Database You can configure how often vCenter Operations Manager removes old data from the file system database (FSDB) by modifying properties in the advanced.properties file. IMPORTANT Always make a backup copy of the advanced.properties file. Changes you make to the file might cause errors that can adversely affect vCenter Operations Manager operations.
VMware vCenter Operations Manager Administration Guide Modify Global Settings You can customize certain vCenter Operations Manager user interface behaviors by modifying global settings. Global settings control the ranges for health color indicators, the interaction metrics count, and the number of root cause groups. These settings affect all users. Modify Health Ranges One of the ways that vCenter Operations Manager indicates the health of a resource is to show a colored indicator.
Chapter 8 Performing Basic System Administration Tasks Set the Number of Root Cause Groups When vCenter Operations Manager shows root cause information, for example, in the Root Cause widget or on the Alert Summary page, it breaks the causes into groups. You can set the maximum number of first-level root cause groups that vCenter Operations Manager shows for any condition. The number of first-level groups that vCenter Operations Manager stores when it captures root cause information is set in the advanced.
VMware vCenter Operations Manager Administration Guide Customize the Performance Graph You can specify whether change events appear in the performance graph on the Resource Detail page. NOTE The performance graph is named Events and Performance or Events and Health, depending on whether Health is selected. Procedure 1 Select Admin > VM Global Settings. 2 To specify whether to show change events, select a Show Change Events option.
Chapter 8 Performing Basic System Administration Tasks 3 Click OK to save your changes. Create a Support Bundle You can package all log and configuration files into one compressed ZIP file and send it to VMware technical support. You can download the support bundle ZIP file to your local hard drive or upload it to an FTP server location that you configure. vCenter Operations Manager creates support bundles in the vcenter-ops\tomcat\webapps\ROOT\support directory on the vCenter Operations Manager server.
VMware vCenter Operations Manager Administration Guide 116 VMware, Inc.
Resolving Administrative System Alerts 9 An administrative system alert indicates a problem with one of the vCenter Operations Manager components. When you resolve an administrative system alert, follow certain recommended procedures.
VMware vCenter Operations Manager Administration Guide Solution 1 Increase the number of FSDB savings threads by modifying the FSDBSaveThreads property in the vcenterops\user\conf\analytics\advanced.properties file. The default value for the FSDBSaveThreads property is 3. You can increase the value up to the number of CPU cores on the host. 2 Use the FSDBHomeChanger tool to create additional mount points for the FSDB so that files are distributed on multiple file systems.
Chapter 9 Resolving Administrative System Alerts Solution 1 Verify that the collector service is running. 2 If the collector service is not running, check the collector (vcenter-ops\user\log\collector.log) and Java service wrapper (vcenter-ops\user\log\collector-wrapper.log) log files. 3 Verify that the network connection is available between the collector and the vCenter Operations Manager server.
VMware vCenter Operations Manager Administration Guide DataQueue Is Filling Up The data queue has reached the maximum limit. Problem The message DataQueue is Filling Up appears in the Reason pane of the Alert Summary page for the alert. Cause The size of the data queue has sequentially reached the predefined maximum limit. Solution n If the Analytics service is not running, restart it.
Chapter 9 Resolving Administrative System Alerts Failed to Connect to Replication MQ vCenter Operations Manager cannot connect to the replication queue. Problem The message Failed to Connect to Replication MQ appears in the Reason pane of the Alert Summary page for the alert. Cause The connection to the replication queue failed. Solution 1 Open the replication.properties file and verify that the replication queue is configured properly. 2 Verify that the ActiveMQ service configured in the replication.
VMware vCenter Operations Manager Administration Guide 2 Increase the network bandwidth between the vCenter Operations Manager server and the replication server or increase the processing capacity of the replication server. Increasing replication server performance enables the server to retrieve data from the queue more quickly, which prevents the queue from filling the disk. FSDB Files Corrupted for Resources One or more FSDB files are corrupted.
Chapter 9 Resolving Administrative System Alerts Solution 1 If the DT Processor service is not running on the remote server where it was installed, try to start it. 2 Select Admin > Support, click the Logs tab, open the vCenter Operations Analytics folder, and look for the cause of the problem in the log for the analytics process.
VMware vCenter Operations Manager Administration Guide Replication MQ Sender Is Blocked The replication queue has reached its maximum size and cannot accept any more data from the vCenter Operations Manager server. Problem The message Replication MQ sender is blocked, data replication has been disabled appears in the Reason pane of the Alert Summary page for the alert. Cause The replication server cannot keep up, either because of a lack of resources or a slow network connection.
Backing Up and Recovering Data 10 You can configure vCenter Operations Manager to handle backup and recovery options, including highavailability clustering and remote failover. The appropriate amount of component redundancy varies from organization to organization. At a minimum, include vCenter Operations Manager data components in the standard backup procedures of your organization. Perform a complete backup of vCenter Operations Manager data before you upgrade the vCenter Operations Manager software.
VMware vCenter Operations Manager Administration Guide Backing Up the FSDB All metric values that vCenter Operations Manager collects are stored in its file system database (FSDB). This implementation enables the vCenter Operations Manager analytics software high access rates to the large amounts of data that vCenter Operations Manager stores. The FSDB is located on the vCenter Operations Manager server in either internal hard drives or a high-speed storage area network (SAN) device.
Chapter 10 Backing Up and Recovering Data 4 Set enabled=true to enable replication of FSDB content. NOTE Because the synchronization process is independent from the replication process, you do not need to enable replication to run the synchronization process. 5 Save your changes and close the replication.properties file. 6 Restart the Analytics service on the primary vCenter Operations Manager server.
VMware vCenter Operations Manager Administration Guide Prerequisites n Create a replicaton server. Because the synchronization process is independent from the replication process, you do not need to enable replication to run the synchronization process. See “Set Up FSDB Replication,” on page 126. n Become familiar with how to start and stop the Analytics service. See “Start or Stop vCenter Operations Manager Services,” on page 106.
Chapter 10 Backing Up and Recovering Data Procedure 1 Select Admin > Support and click the Info tab. The status of the synchronization process appears in the Replication Info pane. 2 Use the icons at the top of the Replication Info pane to manage the synchronization process. Option Action Start the synchronization process a b c d Pause the synchronization process a b Click the Start Synchronization icon.
VMware vCenter Operations Manager Administration Guide Backing Up System Files vCenter Operations Manager uses system files for configuration, integration, and logging. These files are located in the vCenter Operations Manager software directory tree. Table 10-1. System File Backup Guidelines System File Directory Description Backup Guidelines vcenter-ops\user\conf\analytics Analytics configuration directory.
Chapter 10 Backing Up and Recovering Data Table 10-1. System File Backup Guidelines (Continued) System File Directory Description Backup Guidelines vcenterops\activemq\conf\log4j.propertie s ActiveMQ logging properties file. It contains log4j parameters for ActiveMQ logging. Rarely updated after vCenter Operations Manager is in production. Back up this file after installation. Ths file is overwritten during vCenter Operations Manager software upgrades. vcenter-ops\user\logs vCenter Operations Manage
VMware vCenter Operations Manager Administration Guide Backing Up and Recovering Processing Components You must follow certain guidelines when you back up and recover the vCenter Operations Manager processing components. The processing components include the vCenter Operations Manager server, the vCenter Operations Manager Remote Collector server, the DT processor server, and the database server.
Chapter 10 Backing Up and Recovering Data When a server that hosts vCenter Operations Manager becomes unavailable and is remapped by the clustering software, any users that are logged in to vCenter Operations Manager are logged out and the vCenter Operations Manager system becomes unavailable for about 15 seconds. Because it is installed on the shared disk, the FSDB is not affected.
VMware vCenter Operations Manager Administration Guide 3 Update the server IP address, or the virtual IP address that represents the cluster, to the correct IP address for the new primary server or cluster. End users and remote collectors that point to the vCenter Operations Manager server must use the new IP address. 4 Click Finish to save the configuration.
Chapter 10 Backing Up and Recovering Data Configure the Analytics Process to Perform DT Calculations If the remote DT processor becomes unavailable, you can configure the analytics process on the vCenter Operations Manager server to perform dynamic threshold calculations. IMPORTANT Always make a backup copy of the advanced.properties file. Changes that you make might cause errors in the file that can adversely affect vCenter Operations Manager operations.
VMware vCenter Operations Manager Administration Guide 136 VMware, Inc.
Configuring the Repository Adapter 11 You can use the Repository adapter to export metrics from vCenter Operations Manager on a schedule that you set. The destination can be a relational database or a comma-separated value (CSV) file.
VMware vCenter Operations Manager Administration Guide The following sample creation script is for SQL server. CREATE TABLE TestTable ( RID1 int, RNAME1 nvarchar(1000), MID1 int, MNAME1 nvarchar(900), RKNAME1 nvarchar(50), MKNAME1 nvarchar(1000), AKNAME1 nvarchar(50), timestamp1 datetime, min_threshold1 nvarchar(50), value1 nvarchar(50), max_threshold1 nvarchar(50) ) The following sample creation script is for Oracle.
Chapter 11 Configuring the Repository Adapter Repository Adapter Configuration Steps You must perform certain steps to configure the Repository adapter. 1 (Optional) If you have a vApp installation, create a Postgres database user for the Repository adapter to use. See “Creating a Database User for the Repository Adapter,” on page 139. 2 Configure the connection to the vCenter Operations Manager relational database . See “Configure the Source Database Connection for the Repository Adapter,” on page 139.
VMware vCenter Operations Manager Administration Guide Procedure 1 Open the conf.properties file in a text editor. The conf.properties file is in the vcenter-ops\tools\RepositoryAdapter\conf directory. In a vApp installation, edit the conf.properties file on the Analytics virtual machine. 2 Use the sourcedb properties to define the connection to the source database. The following example is an SQL Server source database definition. sourcedbDriver = com.microsoft.sqlserver.jdbc.
Chapter 11 Configuring the Repository Adapter 2 Define the output destination method. You can define only one output destination method. 3 Option Action Send output to a database Set exportToCsv to false. Send output to a CSV file Set exportToCsv to true. If you set exportToCsv to false, use the destdb properties to define the connection to the output database. The following example is an SQL Server output database definition. destdbDriver = com.microsoft.sqlserver.jdbc.
VMware vCenter Operations Manager Administration Guide The first set of values defines the columns in the output database. You change TestTable to the name of your output table. The second set of values, which appears after values in the statement, defines the source fields in the vCenter Operations Manager data model to export to the output database columns. Source Fields The sample conf.properties file includes all of the possible source fields.
Chapter 11 Configuring the Repository Adapter A condition defines either a white list of values (equals operator) or a black list of values (not equals operator). If you define both a white list and a black list, the Repository adapter applies AND logic to the lists. For example, the following conditions cause the Repository adapter to export data if resource ID equals 1, 21, or 54 and metric ID is not equal to 1, 2, or 3. RID1=1;21;154 MID=<>1;2;3 If you do not specify an output column in the conditions.
VMware vCenter Operations Manager Administration Guide Customizing Repository Adapter Operation You can modify properties in the vcenter-ops\tools\RepositoryAdapter\conf\conf.properties file to customize Repository adapter operation. In a vApp installation, edit the conf.properties file on the Analytics virtual machine. Table 11-3.
Chapter 11 Configuring the Repository Adapter After the Repository adapter starts, it runs according to the schedule that you configured in the conf.properties file. VMware, Inc.
VMware vCenter Operations Manager Administration Guide 146 VMware, Inc.
12 Using System Tools vCenter Operations Manager includes several system tools. You can use these tools to manage and troubleshoot the file system database (FSDB), monitor and troubleshoot vCenter Operations Manager performance, check communication between the vCenter Operations Manager server host and remote or local collectors, configure and run the Repository Adapter, and estimate how many resources a host can support.
VMware vCenter Operations Manager Administration Guide Table 12-1. Summary of System Tools (Continued) Tool Description run-jconsole Starts the Java JConsole tool to open the Java application console. You can use this tool to troubleshoot certain vCenter Operations Manager performance issues. NOTE You must install the Java SDK, which includes JConsole, to use run-jconsole. JConsole is not shipped with vCenter Operations Manager.
Chapter 12 Using System Tools 3 If FSDBCheck fixes any files, change the home directory or continue using the current directory. Option Action Switch vCenter Operations Manager to use the new copy of the FSDB Use FSDBHomeChanger to change the FSDB home directory to use the corrected files, for example, FSDBHomeChanger homedir -out FSDBCheck_output_dir. Do not include the -o option. Do not overwrite the files in the new directory.
VMware vCenter Operations Manager Administration Guide 3 (Optional) If you are using FSDBHomeChanger after using FSDBCheck, and FSDBCheck corrects any files, you might want to change the FSDB home directory to the FSDBCheck output directory so that it uses the corrected files. For example: FSDBHomeChanger homedir -out FSDBCheck_output-dir In the example, homedir is the currently defined FSDB home directory and FSDBCheck_output_dir is the output directory from the FSDBCheck command.
Chapter 12 Using System Tools Table 12-2. vcops_parameters.properties File Properties Property Description NUMBER_INBOUND_ADAPTERS_ON_ALIVE_SERVER Number of inbound adapters that vCenter Operations Manager uses. NUMBER_CONTAINERS Estimated number of container resources that will be configured. NUMBER_RESOURCES Number of resources for the tool to use as a starting point for the estimation.
VMware vCenter Operations Manager Administration Guide Set Properties for runvcopsServerConfiguration runvcopsServerConfiguration uses values in the vcops_parameters.properties file to estimate the maximum number of resources that the vCenter Operations Manager server host can support. The vcops_server_configuration.properties file contains connection information for the vCenter Operations Manager server on the host. runvcopsServerConfiguration uses the values in this file to connect to a host.
Chapter 12 Using System Tools When you run runvcopsServerConfiguration in test mode using the -test option, it returns the same information, but it also runs a file I/O test. The file I/O test writes data to the defined FSDB home directory and uses the measured speed of the writes in its estimation of the maximum number of resources. The value of the NUMBER_FSDB_WRITE_CYCLES property in the vcops_parameters.properties file determines the number of times to writes to the FSDB.
VMware vCenter Operations Manager Administration Guide The following example is a sample pca.properties file. pcaRKList = Tier pcaDaysToProcess = 1 pcaDaysAgoEnd = 0 pcaTimeWindowIncrement = 10.0 pcaTimeWindowSize = 20.0 pcaPFraction = 0.9 pcaDataSetSamplePercent = 10.0 pcaConstantPercentile = 90.0 pcaEpsilon = 0.00001 Run the PCA Tool You can use the PCA tool to eliminate linearly correlated metrics from the dynamic threshold calculation. Prerequisites Become familiar with the pca.properties file.
Using the Database Command Line Interface 13 The database command line interface, dbcli, is a command line Java application that you can use to perform operations in the vCenter Operations Manager database. With dbcli commands, you can manage dashboards, dashboard templates, attributes, super metrics, and resources. You can also perform certain control operations.
VMware vCenter Operations Manager Administration Guide Export a Dashboard You can use the dbcli dashboard export command to export a dashboard from a vCenter Operations Manager instance. When you export a dashboard, vCenter Operations Manager creates a dashboard file in XML format. The dashboard export command has the following syntax. dashboard export user-name "dashboard-name" [output-dir] user-name Name of the user account that owns the dashboard. dashboard-name Name of the dashboard to export.
Chapter 13 Using the Database Command Line Interface Table 13-1. dashboard import Command Options (Continued) Option Description --retry maxRetryMinutes Maximum amount of time, in minutes, that the command retries the import operation. The command retries the import operation at oneminute intervals until it reaches this time limit. NOTE This option is useful if data is missing from the dashboard when you initiate the command.
VMware vCenter Operations Manager Administration Guide Reorder a Dashboard You can use the dbcli dashboard reorder command to control the order in which a dashboard appears in the user interface. The dashboard reorder command has the following syntax. dashboard reorder user-name "dashboard-name" [--set rank] [--default] user-name Name of the user account that owns the dashboard. dashboard-name Name of the dashboard to reorder. The dashboard reorder command has certain options. Table 13-2.
Chapter 13 Using the Database Command Line Interface template export "template-name" [output-dir] template-name Name of the dashboard template to export. If the dashboard template does not exist, the command fails. output-dir Directory where the command exports the dashboard template file. If you do not provide an output directory name, the command exports the dashboard template file to the current directory.
VMware vCenter Operations Manager Administration Guide Share a Dashboard Template You can use the dbcli template share command to to share a dashboard template with one or more user groups. The template share command has the following syntax. template share "template-name" {all | group-name[,group-name]...} template-name is the name of the dashboard template to share. You can type the name of each user group that can share the dashboard template or type all to share the dashboard with all user groups.
Chapter 13 Using the Database Command Line Interface template delete "template-name" template-name is the name of the dashboard template to delete. The following template delete command deletes a dashboard template named MyTemplate. dbcli.sh template delete "MyTemplate" Managing Attributes and Super Metrics You can use dbcli commands to manage attributes and super metrics. You can also use the Custom user interface to perform attribute and super metric operations.
VMware vCenter Operations Manager Administration Guide Table 13-4. attribute configure Command Options (Continued) Option Description --dtbelow {true | false} Marks or unmarks violations below the dynamic threshold of the attribute as KPI violations. --thresholds {none | "threshold-def[;thresholddef]..."} List of threshold definitions for the attribute package. Type none instead of a threshold definition to remove all existing thresholds. For more information, see “Threshold Definitions,” on page 164.
Chapter 13 Using the Database Command Line Interface The following supermetric configure command checks the super metric named SM1 for collection in the super metric package named package1. It creates two thresholds and marks HT from level critical and DT above and DT below as KPIs violations. dbcli.
VMware vCenter Operations Manager Administration Guide Table 13-6. supermetric import Command Options (Continued) Option Description --retry maxRetryMinutes--retry Maximum amount of time, in minutes, that the command retries the import operation. The command retries the import operation at one-minute intervals until it reaches this time limit. NOTE This option is useful if data is missing from the super metric when you initiate the command.
Chapter 13 Using the Database Command Line Interface n < n <= n = n != compare-value Threshold value. Can be a floating number for regular metrics or a string value for string metrics. wait-cycle Number of consecutive violations that can occur before generating an alarm. cancel-cycle Number of consecutive violation-free cycles that can occur before canceling the alarm. The following definition contains two thresholds.
VMware vCenter Operations Manager Administration Guide The following reskind configure command sets default values for the SampleStorage adapter's Volume resource kind. It enables early warning smart alert generation, sets the default attribute package to Default Attributes, and resets the default super metric package setting. dbcli.
Index A access rights 70, 72 adapter instances adding 15 deleting 17 editing 16 managing 14, 16 starting and stopping metric collection 30 adapter kind icons 17 adapter types embedded 13 external 14 adapters, configuring 13 administrative system alerts 117 administrative tasks 103 alert handler instances configuring 77 deleting 81 starting and stopping 81 alert notifications configuring and managing 77 filtered email messages 78 modifying your configuration 91 saving to a log file 79 sending as email messa
VMware vCenter Operations Manager Administration Guide deleting super metrics 164 Describe Failed alert 120 describe process 166 disaster recovery implementing 133 manually switching to a backup server 133 discovery process 13, 20 documentation information 7 DT calculations 135 dtBlockIfDataQueueSizeOver property 57 E email alert notifications 90 email template definitions adding 89 deleting 94 editing 93 email template files 86 emailFilter.xml 82 embedded adapters 13 eventlist.
Index manual discovery 13, 20 metric collection 30 metric data types 44 metric specifications 46 metrics collecting 30 understanding 39 vCenter Operations Generated 40 multi-level-alert-rules.xml file 95 multilevel alert rules 95 N No Data Receiving alerts 17 No DT Processors Connected alert 122 O One or More Resources Were Not Started alert 123 Outbound Alert Send Failed alert 123 P password policies 72 PCA tool 153, 154 pca.
VMware vCenter Operations Manager Administration Guide preparing to create 46 use case 56 support bundles 115 synchronization process 128 system files backing up 130 recovering 131 system tools 147 T tag values associating with applications 62 associating with resources 26 removing applications 64 removing resources 36 tags 23 thresholds 40, 164 U unsharing dashboard templates 160 useMetricGroupWeightingForHealth property 56 user accounts creating 65 editing 73 maintaining 73 removing 74 User Audit repor