How can I troubleshoot failed agent deployments? (NETIQKB2213)

  • 7702213
  • 02-Feb-2007
  • 06-Apr-2012


Security Manager 6.x


How do I troubleshoot a failed managed agent install?

How can I find out why a managed agent did not install?

Where does Security Manager store information about the status of a managed agent install?


Following are the steps used by NetIQ Technical Support to troubleshoot agent installation failures:

  1. Check the following Security Views to find out the cause of an agent installation failure in the Control Center Console. 
    1. All Folders | Security Views | Central Computers
    2. Agent Manager alerts (Last 24 Hours)
  2. Check the following folder on the Central Computer for Log Files:
    1. <Install Drive>\Program Files\Netiq\Security Manager\OnePoint\InstallService\ComputerLogs       
  3. Ensure name resolution via WINS or an LMHOST File or DNS is in place.
  4. Ensure the Remote Registry Service is started on the agent and central computer before attempting to scan agents.
    1. You can review services using the Component Services Administrative tool, located in the Control Panel. 
  5. Check Permissions for the SM service account to make sure it has administrative rights over the prospective agent.


When a managed agent fails to install, SM will generate events related to the install. The information in the events / alerts, can provide insight into why the install failed.

Additional Information

Formerly known as NETIQKB2213

Refer to following knowledge base article to troubleshoot agent authentication failures errors:

How can I troubleshoot and resolve errors with Agent Authentication failures?