Skip to main content

Configuring VMware vSphere Integration

Note

If you want to enable the collection of capacity metrics, follow the steps outlined in https://kb.vmware.com/s/article/2107096 and disable the two maxQuery limits listed.

  1. From the Settings page, click Integrations in the Probes and Integrations section.

    The Integrations page is displayed.

  2. Click View.

    The VMware vCenter page is displayed.

    Table 32. VMware vSphere Inventory

    Field

    Definition

    Name

    User-defined name for the integration, often the IP address or the type of integration. For example, VC_Production or VC_Lab. The name "vcenter" in any combination of case may not be used.

    Subscription

    Subscription status: Unsubscribed or Subscribed.

    Last Discovery

    Date and time that the integration was last discovered, discovering for currently discovering, no discovery, Discovery failed, or Warned. For Discovery fail or discovery Warned, you can mouse over the cell shows the error or warning as a tool tip.

    Last Metrics Collection

    Date and time of last metrics collection, Collecting metrics for metrics collection in progress, Metrics collection failed for failed metrics collection, no collection for no metrics collection, or Warned followed by a timestamp for a warning. For both failures and warnings, a mouse-over the cell generates a tool tip.

    You are notified if a software integration fails to collect metrics for two hours. The notification takes the form of a IPM Health Notification alert as well as an email notification.



    At the end of each row is a down arrow, which, if you click it, provides a short cut to Configure, Test Connection, Start Discovery, or Delete the integration in the associated row.

  3. Click New.

    The Discover New Integration for VMware vSphere Integration page is displayed.

  4. The required Web Service Port field in this page is pre-populated. Its value is driven by the use of the SSL check box. If the SSL check box is selected, the port is 443. If the SSL check box is not selected, it is port 80. You can override the pre-populated value if necessary.

    The required Web Service API field is also pre-populated.

    Complete the rest of the information as follows:

    Field

    Definition

    Hostname/IP

    VCenter host name or IP address. Required.

    Username

    Username for the VCenter. Required.

    Password

    Password for the VCenter. Required.

    If the Use SSL check box is selected, you must either upload your certificate from your local system using the Browse button or fetch the certificate from your VMware vSphere system using the Fetch button. If the Use SSL check box is not selected, the Certificate File field is not present. Please see the SSL Certificate Handling section for more details.

    Note

    IPM requires 1024- or 2048-bit certificates. The SSL certificate can be found on the vCenter server in the following location:

    C:\Documents and Settings\All Users\Application Data\VMware\VMware VirtualCenter\SSL\rui.crt

  5. Click Next.

  6. IPM tests the connection (hostname and credentials) and tries to find all the ESX servers. This process can take up to five minutes. When the process completes, the next page displays.

    When this process is complete, the Create New Integration page displays.

    The Hostname, Web Service API, Web Service Port, Username, Password, and Use SSL (as well as the certificate information if use-SSL was selected) fields are carried forward. The Metrics Polling Interval is auto-detected. The Name field is user-configurable.

  7. Enter the integration Name.

    By default, regularly scheduled discovery is enabled for IBM PowerVM, VMware vSphere, and Microsoft Hyper-V Integration configurations. If you would like to disable regularly scheduled discovery, uncheck the Enable scheduled discovery check box.

    If you would like to have discovery scheduled regularly, keep the box checked and choose a discovery frequency and time of day. By default, the frequency and time of day for IBM PowerVM, VMware vSphere, and Microsoft Hyper-V Integrations is every day and 1am appliance time.

  8. Optionally, click Test Connection to test the connection.

  9. Use the information in the ESX Hosts table to subscribe/unsubscribe specific ESX servers.

    The ESX servers in the ESX Servers table on the Create New VM window are those ESX servers that were auto-detected.

    The columns headings in the ESX Hosts table are defined as follows:

    Field

    Definition

    Server Name

    Name of the ESX server

    Inventory Path

    Path of the ESX Server within the VMware vSphere Integration inventory hierarchy. The last node is the ESX server itself, while first node is the DataCenter, and the intermediate node is the cluster to which ESX server belongs.

    Subscription

    Subscribed or Unsubscribed

  10. Subscribe to an ESX server by selecting the ESX server or ESX servers to which you would like to subscribe and click Subscribe.

    All ESX servers are unsubscribed by default.

  11. Click Save to save all of your changes.

    The Discovery dialog box displays, asking if you want the discovery process to start upon saving. Virtana recommends immediate discovery as no metrics are collected into discovery is complete.

  12. Click Yes to start immediate discovery.

You return to the main grid of integration configurations, and the integration that you just created has “Discovering…” in its last discovery time column.

If you drill down into the integration configuration again, a banner displays on your page saying that discovery is taking place, and might take as much as several hours to complete. While the discovery is taking place you are in read-only mode. You cannot make any changes to the integration or switch configuration.

In this section: