OS agent (LPAR2RRD agent) is add-on feature for monitoring from operating system level.
XorMon is able to monitor stand-alone MS Windows servers and MS Hyper-V performance metrics (hosts and VMs).
The agent monitoring even Storage Spaces Direct(S2D).

Implementation is done through single Windows OS agent running on any Windows host in the Windows domain.
This OS agent gets all required configuration from the AD and performance data of monitored hosts through WMI.
It passes such data to XorMon server where data is saved and presented.

Is used LPAR2RRD Windows OS agent which works everywhere where is available PowerShell 3 and higher
It does not directly depends on the Windows version, if you are able to upgrade PowerShell to 3.0+ on older machines then it will work.

Installation summary

• Allow TCP connection initiated from Windows LPAR2RRD Hyper-V agent server to XorMon server on port 8162
• PowerShell version 3 and higher only is supported on Windows hosts

User creation

1. Create the user in the AD with membership in these groups:
   • Event Log Readers
   • Hyper-V Administrators
   • Performance Log Users
   • Performance Monitor Users
   This must be done for all Hyper-V nodes and MS Windows servers that are supposed to be monitored (this can be set globally in AD).
   
   
2. Set rights in GPO and AD using this manual
   
   
3. Give local admin rights to the the user on the Win server where LPAR2RRD Hyper-V agent will be running.
   Add him into Domain Users group.
   
   
4. Assign read-only rights for monitored Hyper-V clusters to the user
   

OS agent installation

1. Unzip LPAR2RRD-Win-agent-8.0.0.zip
2. Unblock these files by right clicking them and checking "Unblock"
   
   • Setup.vbs
   • Configuration.vbs
   • LPAR2RRD-agent.ps1
   • LPAR2RRD-agent-Configuration.ps1
   • LPAR2RRD-agent-Installer.ps1
   
   When 'Unblock" does not help and installation does not start (PowerShell install window immediatelly disapears)
   you might need to Set-ExecutionPolicy to enable running powershell for current user.
   That is a common case on Windows desktops.
   
   
3. Run: Setup.vbs
   
   
4. Select installation directory
   Note that 'C:\Program Files\<whatever...>\' does not work on all Windows (especially Desktops) due to some permission issue, files are not copied there, an use alternative path
   
   
   
5. Put hostname of the XorMon server
   
   
   
6. Test connection to the XorMon server
   
   
   
7. Put user which will run LPAR2RRD OS agent on this machine
   
   
   
8. Select monitored mode
   
   
   
In case of a cluster: add there cluster name and names of all nodes as well like: cluster1,node1,node2,cluster2,node...



Monitored modes

The agent can run in these modes:
1. leave it in default mode and monitor just the server where it is installed
2. monitor all visible servers from AD
3. monitor only specific servers (recommended), added into cfg file
   for monitoring of cluster - add its name to servers/nodes too like: cluster1,node1,node2,cluster2,node...


9. Wait about 30 minutes, then you should see it in your XorMon UI under 'Server ➡ Windows' folder in the main menu
   
   

You can also use manual OS agent installation


Troubleshooting

Last updated: 2026-05-14