Configuring Microsoft Hyper-V monitoring

Edit online

When you install the Monitoring Agent for Microsoft Hyper-V Server, the agent is automatically configured and started with the default configuration settings. Use the silent response file to modify the default configuration settings.

Before you begin

  • Review hardware and software prerequisites. For the up-to-date system requirement information, see the Software Product Compatibility Reports (SPCR) for the Microsoft Hyper-V Server agent.

  • If you want to modify the default configuration parameters, edit the response file.

  • To view the virtual machine data in the Virtual Machine page, ensure that you install the integration component and the OS agent on each virtual machine. For virtual machines that run on the Linux® system, ensure that you complete the following tasks:
    • Upgrade the Linux system.
    • Install the updated hypervkvpd or hyperv-daemons rpm package on the virtual machine.

About this task

You can configure the agent when the agent is running or stopped. The agent remains in the same state after configuration. For example, if the agent is running, it remains in the running state after configuration.
Important: For the 8.1.3 release of Performance Management, the agent configuration window is removed because it is not required. The agent configuration window is available for 8.1.2, or earlier versions of Performance Management.

The product version and the agent version often differ. The directions here are for the most current release of this agent. For information about how to check the version of an agent in your environment, see Agent version command. For detailed information about the agent version list and what's new for each version, see the Change history.

Procedure

To configure the agent, complete the following steps:

  1. Open the microsoft_hyper-v_server_silent_config.txt file that is at install_dir\samples, and specify values for all mandatory parameters.
    You can also modify the default values of other parameters.
  2. Open the command prompt, and enter the following command:
    install_dir\BIN\microsoft_hyper-v_server-agent.bat config install_dir\samples\microsoft_hyper-v_server_silent_config.txt
    The response file contains the following parameters:
    • KHV_DIRECTOR_PORT
    • KHV_DIRECTOR_SERVER
    Remember: The agent configuration is organized into the following groups:
    IBM® Systems Director configuration (IBM_DIRECTOR_CONFIGURATION)
    The configuration elements that are defined in this group are always present in the agent's configuration. This group defines information that applies to the entire agent.
    IBM Systems Director Server Port Number (KHV_DIRECTOR_PORT)
    The port number for the IBM Systems Director Server. The default value is none.
    IBM Systems Director Server Host Name (KHV_DIRECTOR_SERVER)
    The host name or IP address of the IBM Systems Director Server that is managing the environment. The default value is none.
  3. Start the agent if it is in the stopped state.

What to do next

Log in to the Cloud APM console to view the data that is collected by the agent in the dashboards. For information about using the Cloud APM console, see Starting the Cloud APM console.