Introduction
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.
Using 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:
- OS information
- Hardware information
- Application information
- Services information
- Patch information
- Antivirus information
Prerequisite
Before you begin, configure any one of the agents installed on your devices as the Master Agent.
Discovering WMI-enabled resources
To discover a a WMI-enabled resource with an agent:
- Install the agent.
- Create a discovery profile.
- Scan the devices. All the discovered devices are displayed using Infrastructure > Resources > Discovered.
All the discovered devices are listed in the folder at the path - Infrastructure > Resources > Discovered.
Using agentless discovery
Agentless discovery uses the OpsRamp Windows gateway (instead of an agent) to discover discover WMI-enabled resources.
Note
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:
- Enable WinRM services on the gateway.
- Allow WinRM service through firewall.
- 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.)
- Enable PS-Remoting on the gateway resource.
- Set PowerShell environment variable on the gateway resource.
On the target devices:
- Enable WinRM service.
- Allow WinRM service through the firewall.
- Enable PS-Remoting.
Discovering WMI-enabled resources
To discover a a WMI-enabled resource through the gateway:
- Install the Windows gateway.
- Create a discovery profile.
- Scan the devices. All the discovered devices are displayed using Infrastructure > Resources > Discovered.
Important
While creating a discovery profile, 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.
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:
- Open a PowerShell window and navigate to the default location of the discovery script:
C:\Program Files\OpsRamp\Gateway\scripts\wmi\discovery\
- 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. - 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.