Intel® Device Manager for VMware* vCenter Server User Guide

Overview

Intel® Device Manager for VMware* vCenter* Server is a user-friendly way to manage Intel devices on VMware’s vCenter platform. It is deployed as a plug-in to vCenter.

The plug-in lets you manage and configure devices right from the interface of VMware vCenter. You can:

• View information on supported devices
• Monitor device counters and sensors
• Customize device configuration
• Save configurations as recipes for future reuse and apply these recipes to all your devices with a single click.

The plug-in requires the Intel® Accelerator Management Daemon for VMware ESXi on each host to discover and allow device management.

This document covers:

• Installation
• Setup and configuration
• Recipe creation
• Device monitoring and management
• Troubleshooting

Deployment Architecture

This diagram illustrates the relationship between the plug-in and other system components.

Setup

Prerequisites

• VMware vCenter (See appendixa for a list of compatible versions.)
• VMware (See appendixb for a list of compatible versions.)
• Supported Intel device on a host with driver installed (See Appendix B for a compatibility guide.)

Install the Plug-in

Follow these instructions to install the plug-in and create a user account.

Install the Daemon on the Host

The Intel Accelerator Management Daemon for VMware ESXi provides an interface for the plug-in to communicate directly with device drivers to enable configuration and monitoring capabilities.

1. Log in to the ESXi host via SSH or access the web console.
2. Install the daemon bundle using the software install command.

Setting Up a User Account

The plug-in needs a user account to communicate with the Intel Accelerator Management daemon to enable the management of devices from the plug-in interface.

1. Navigate to the Administration page in vCenter.
2. Create a role for the daemon account to use:
   1. Under Access Control, select Roles and click New.
   2. In the New Role window, enter a suitable name in the Role Name field.

2. 3. In the left menu, select Interact with Partner Rest Daemons.
   4. Click All from the drop-down menu at the right and check Select All.
   5. Click Create.
3. Set up a daemon user account:
   1. Under Single Sign On, select Users and Groups, and select your domain. This example uses the vsphere.local domain.
   2. Click Add.
   3. In the Add User window, enter the username intelplugin and a password of your choice, then click Add.
4. Add the role to the account:
   1. Under Access Control, select Global Permissions, then click Add.
   2. Select the domain and account created in the previous step, assign the previously created role to this account, and then click OK.

Install the Plug-in

1. Navigate to the Administration page in vCenter.
2. Select Add. Select to upload a local OVF template file you have downloaded or enter the URL for the template file.

3. Select the location for the plug-in: Select a data center, the compute resource, and storage and network options.
4. Customize the template: Enter the details needed for setting up the plug-in VM. The following properties are available:

• Certificate properties: Properties to set for the self-generated certificate.
• vCenterGUID (required): The GUID from vCenter is necessary to authenticate a user session with the plug-in.
• Password (required): The password for the VM, which will be set on the first boot, must be at least 12 characters long. Do not use common dictionary words. Setup Intel® Device Manager for VMware vCenter Server User Guide 6
• Proxy: This is the proxy for installing Java into the VM. It only sets the proxy for tdnf.
• Static IP: Skip this section if you have DHCP. Set a static IP for the VM in this section. The IP is in CIDR notation, which includes a mask. For example, an IP of aa.bb.cc.dd with a mask of 255.255.255.0 is represented by aa.bb.cc.dd/24.
• MAC: Specify a MAC for the VM’s network adapter to spoof. This is not recommended unless you have a MAC restriction.
• Solution Information: Values that are not editable. The default values required for registering the plug-in with vCenter.

5. Associate vCenter: Select a vCenter for the plug-in to associate with. Currently, the plug-in supports only a single vCenter per VM.

Signing Into the Daemon Account

1. In the overflow menu, select Intel Device Manager for VMware vCenter Server.

2. When prompted, enter the username and password for the daemon user account you created in the previous section.

Uninstall the Plug-in

Follow these instructions to uninstall the plug-in.

Uninstall the Daemon on the Host

1. Log in to the ESXi host via SSH or access the web console.
2. Uninstall the daemon bundle using the software remove command.

Uninstalling the Plug-in and Removing the VM

1. Navigate to the Administration page in vCenter.
2. Select Client Plug-in and select Intel Device Manager for VMware vCenter Server.
3. Click Remove.
4. Navigate to the VM in your inventory. You can now safely delete it.

Procedures

Discovering Devices

1. A card on the Summary page for the host, cluster, or datacenter shows the available devices:

   

Viewing Device Information

1. On the Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name. Alternatively, click Configure on the summary card.

2. Select the double chevron (>>) to show the following information for this device:

• General Info: Information regarding the location of a device, PCI information, type, and number of fans.
• Firmwares & Engine: List of available firmware and engines.
• Memory & Frequency: Memory modules and their information, along with frequency domains and their types. To change the frequency minimum and maximum, click the edit icon.

• Power: Power Supply Units are present along with Power domains. Click the edit icon to change the power minimum and maximum.
• Additional Info: Additional info defined by the driver specific to the device.
• Alerts: Recent alerts were raised for this device.
• Monitor this device: Selecting the chart icon will take you to monitor this device.
• Configure this device: Selecting the gear icon will allow you to configure this device.

Changing Device Configuration

1. On the Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name. Alternatively, click Configure on the summary card.
2. Select a device using the checkbox and click Configure.

3. Click Next to start the configuration wizard.
4. On the Select a Configuration page, select a configuration method.
   • Recipes: Refer to the next section, “Recipes.”
   • Profiles and parameters: Follow the steps below.

Note: Configuring a device using parameters is only available when selecting a single device.

5. Configure with a profile: In the Change Configuration window, choose the Select A Profile tab, select an existing profile, and click Apply.

6. Configure parameter values: In the Change Configuration window, choose the Change Parameter Value tab, modify the parameters, and click Apply.

• Maintenance mode: Configuration changes that require executing maintenance mode are denoted by a yellow caution symbol. If this icon appears on any of the configuration parameters or profiles selected, the plug-in will ask to proceed with setting the host on maintenance mode. This will fail if the host has running VMs that need to be shut down manually.
• Apply configuration: This page shows the status of configuration changes and the results of the operations. For a single device, it only shows the configuration results. For multi-device operation, it shows the result per device.
• Summary: Summary of this operation. It also provides shortcuts to access the Recipes or Monitoring page.

Using Recipes

1. On the Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name. Alternatively, click Configure on the summary card.
2. Select a device using the check box and click Manage Recipes. This opens the wizard.

3. You have three options:
   • Save current configuration into a recipe: Save the currently applied device configuration to a recipe and set its name.
   • Update recipe: Update an existing recipe with the current configuration on a device.
   • Delete a recipe: Delete an existing recipe.

Using Recipes

1. On the Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name. Alternatively, click Configure on the summary card.
2. Select a device using the checkbox and click Configure. This will open the configuration wizard.
3. On the Select a Configuration page, choose Select A Recipe.
4. When only a single device is selected, the wizard shows the change between the device’s current configuration and the selected recipe. When multiple devices are selected, only the recipe values are shown.

   

5. In some cases, the recipe may not be compatible with the selected device. In these cases, you will get an error when selecting the recipe (with a single device selected) or when applying the recipe (if applying to multiple devices at once).

6. Follow the rest of configuration steps to apply the recipe.

Monitoring a Device

1. On the Monitor tab for a host, cluster, or data center, select Managed Devices under the plug-in name. Alternatively, click Monitor on the summary card.
2. To see the device status, select the double chevron (>>) to the left of the device address.

The following options are available:

• Status: General status of the device and PCI bus. It also allows users to select a refresh interval and export data as JSON.
• LEDs: LEDs on the device.
• RAS: RAS counters for the device.
• Sensors: Sensors such as temperature, voltage, fan speeds, etc. for the device, and additional monitoring data like engine utilization and memory speeds.
• Telemetry: Device-defined telemetry data with visualization.
• Performance: Device-defined performance data with visualization. Click the information icon at the top of the page to switch to the Configure page and view device information.
• Alerts: View alerts for the device (see the following section).

Viewing Alerts

1. On the Monitor or Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name.
2. Select the Alerts drop-down option. This window has three options: Dismiss, Dismiss All, and Older Alerts. To view a table of all archived alerts, where you can delete selected alerts, select Older Alerts.

Refreshing Devices

1. On the Monitor or Configure tab for a host, cluster, or data center, select Managed Devices under the plug-in name.
2. Click Refresh.

Adding a New Device or Host

1. Follow the steps to install the daemon on the host if it is not available.
2. On the Monitor or Configure tab for the host, select Managed Devices under the plug-in name.
3. Click Refresh.

Troubleshooting

Invalid Credentials

• Verify that the correct credentials are set for the daemon account. If this account still needs to be set up, follow the SETUP process to create and log in to the account.
• Verify that time is synchronized between the host, plug-in VM, and vCenter.

Status of Daemon

• Verify that the host has the daemon installed.
• Verify that the host has the daemon running. You can use the following command to check the status of daemon on the host:

esxcli daemon info get -s acceleratormanagementd

Configuration Wizard is Empty, or Configuration Fails

• Verify that the device is in SR-IOV mode. For version 1.0.0, the plug-in and drivers support only SR-IOV mode configuration. To enable SR-IOV mode, refer to the driver documentation.

  

• Verify that virtual functions (VFs) are enabled for the device. To enable VFs for any device:Verify that virtual functions (VFs) are enabled for the device. To enable VFs for any device:
  1. Sign in to the ESXi Host Client by typing the IP address in the browser. 
  2. Go to Manage > PCI Devices.
  3. Search for the device, select the device, configure for SR-IOV, and save the settings.

No Healthy Upstream

• Verify that the plug-in VM is up and running.
• Verify that the plug-in server is running on the VM.

  

   

General Errors

• Check the log file at /var/log/solutioninstall 
• Contact Intel Support.
   

Resources

Intel Device Manager for VMware vCenter Plug-in 

• Download
• Article: Manage Intel Accelerators with Intel Device Manager for VMware vCenter Server 

Intel QuickAssist Technology (Intel QAT) 

• Learn More
• Download Supported Drivers 

Intel Dynamic Load Balancer (Intel DLB) 

• Learn More
• Download Supported Drivers 

Intel Data Center GPU (Intel Data Center GPU Flex Series)

• Learn more about Intel Data Center GPU Flex Series
• Download supported Intel Data Center GPU Flex Series drivers

Learn more about the Intel and VMware partnership.

Appendix A: Version Compatibility

Appendix B: Driver Compatibility