Windows Management Instrumentation (WMI) is a Microsoft-specific protocol that is used to monitor and manage Windows devices. OpsRamp uses WMI protocol to discover and collect performance and health metrics from all WMI-enabled windows devices.

OpsRamp facilitates both agent-based and agentless discovery of WMI-enabled devices.

Agent-based discovery

Agents are installed on the target devices in your private network environment.

Agent can be downloaded and installed on any of the following platforms:

  • Windows 2008, Windows 7 and above.
  • Red Hat 6.X, Ubuntu 12.X, Fedora, SUSE, and Amazon Linux.

Components discovered through agents

OpsRamp collects the following data through an agent:

  1. OS information
  2. Hardware information
  3. Application information
  4. Services information
  5. Patch information
  6. Antivirus information

Prerequisite

Before you begin, configure any one of the agents installed on your devices as the Master Agent.

Discover WMI-enabled resources

To discover a a WMI-enabled resource with an agent:

  1. Install the agent.
  2. Create a discovery profile.
  3. Scan the devices.

All the discovered devices display at: Infrastructure > Resources > Discovered.

Agentless discovery

Agentless discovery uses the OpsRamp Windows gateway (instead of an agent) to discover WMI-enabled resources.

The gateway does not discover the resources if:

  • Port 5985 is not open.
  • The agent is installed on the resource.

Prerequisites

On the gateway resources:

  1. Enable WinRM services on the gateway.
  2. Allow WinRM service through the firewall.
  3. If the target device is not in the same domain, add the domain of the target device to the trusted hosts. (The device is discovered in an IP range.)
  4. Enable PS-Remoting on the gateway resource.
  5. Set PowerShell environment variable on the gateway resource.

On the target devices:

  1. Enable WinRM service.
  2. Allow WinRM service through the firewall.
  3. Enable PS-Remoting.

Discover WMI-enabled resources

To discover a a WMI-enabled resource through the gateway:

  1. Install the Windows gateway.
  2. Create a discovery profile.
  3. Scan the devices.

All the discovered devices display at Infrastructure > Resources > Discovered.

While creating a discovery profile, the Discover only WMI enabled devices option displays.

  • If this option is selected, only WMI-enabled devices are discovered.
  • If this option is not selected, the devices are onboarded as other devices.
  • If the device is managed, the device displays at Infrastructure > Resources > Desktop.
  • If the device is not managed, the device displays at Infrastructure > Resources > Discovered.

The devices are pingable through the gateway.

  • The devices contain only the IP address and reverse DNS name.
  • The reverse DNS name is only displayed if the IP address is resolved.

Troubleshooting

How do you view and save the discovered devices manually?

Solution:
If you are unable to view the discovered resources, do the following steps to view and save the discovered resources:

  1. Open a PowerShell window and navigate to the default location of the discovery script:
    C:\Program Files\OpsRamp\Gateway\scripts\wmi\discovery\
  2. Enter the following command:
    Syntax: .\scriptname <IPAddress> <domain\username> <password>
    Example: .\windowsdiscovery.ps1 172.28.110.71 opsramp\admin Pass@123
    The discovered device list is populated in the console.
  3. Enter the following command if you want to save the result in a file:
    Example: .\windowsdiscovery.ps1 172.28.110.71 opsramp\admin Pass@123 > D:\result.txt
    In this example, the discovered device list is saved in the text file, result.txt.

How do you troubleshoot remote connections?

Solution:
To troubleshoot remote connections or debug issues related to permissions and authentication in your environment, see Microsoft for information on remote troubleshooting.

External references