How To
Summary
This technote provides a one-step instruction on how to restart the WinCollect agent service on a Windows host remotely for managed agents. This process is useful for troubleshooting and helping ensure that the agent is functioning correctly. This method is not applicable for stand-alone agents.
Steps
- Log in to your QRadar console as root.
- Run this command:
/opt/qradar/support/all_servers.sh -Ck "cd /store/configservices/wincollect/configserver/; find . -type d -exec touch {}/force.upgrade \;"This command runs a script that runs the same command on all hosts, including the console and passive HA nodes, in the deployment. The command adds an empty file named "force.upgrade" into every configuration directory of WinCollect agents that are registered (managed). This command simulates a configuration change. When the agent will check in at the next configuration polling interval, the agent will think that the configuration needs to be updated, which ends in a restart of the Wincollect service on the Windows host. - When the agent checks in during the configuration polling interval, the file is expected to be automatically deleted. If the file is still in the configuration directory for an agent that means that there might be a problem with the registration or configuration updates for that agent. (Or - the agent might be registered to another QRadar host.)
- To monitor restarts of agents, you can trace the Heartbeat events from WinCollect agents in QRadar Log Activity to see events that show the service stopping and starting.
Result: The Wincollect service is successfully restarted on all managed WinCollect agents.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSV4BL","label":"IBM QRadar"},"ARM Category":[{"code":"a8m0z000000cwtwAAA","label":"WinCollect"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.3.0;7.4.0;7.5.0"}]
Was this topic helpful?
Document Information
Modified date:
23 July 2025
UID
ibm17240392