ERROR: Failed to install agent on \\computername, rc=6 The handle is invalid. (NETIQKB4518)

fact
Domain Migration Administrator 7.x

fact
Server Consolidator 7.x

symptom
ERROR: Failed to install agent on \\computername, rc=6 The handle is invalid.

symptom
ERROR: Failed to launch agent on \\computername, hr=80070006 The handle is invalid.

symptom
ERROR: Failed to open configuration for service \\computername\OnePointDomainAdminService, rc=1726 The remote procedure call failed.

symptom
ERROR: Failed to create the service: CreateService('OnePointDomainAdminService','Domain Migration Administrator Agent','C:\Program Files\OnePointDomainAgent\DCTAgentService.exe','') rc=6 The handle is invalid.

cause
This error occurs in the Dispatch.log (\Program Files\NetIQ\DMA\Logs\Dispatch.log) when executing a DMA or SC task that dispatches an agent, as a result of inconsistent network connectivity or limited bandwidth.

fix

There is an option in Domain Migration Administrator (DMA) that lets you configure DMA for a WAN connection when performing agent tasks on computers. This tells DMA to send out fewer agents at a time, which will consume less bandwidth and thus help prevent these errors. To set this from the MMC console:

1. Right-click on Domain Migration Administrator.
2. Select View |  DMA Advanced Settings.
3. Select the checkbox for "Dispatching agents to computers over a WAN link".
4. Click OK.

note

For more information regarding how Domain Migration Administrator (DMA) handles dispatching agents over a WAN, please refer to the following knowledge base article:

NETIQKB7493 - How does Domain Migration Administrator handle dispatching agents to computers over a WAN link?

note
For more information regarding tasks that require agents, please refer to Appendix C of the Domain Migration Administrator (DMA)  & Server Consolidator User Guide (\Program Files\NetIQ\DMA\Documentation\DMA & SC User Guide.doc) under the heading 'Agents'

Formerly known as NETIQKB4518