Error: "Object TaskServerHandler is not installed" during Client Task Agent registration

Products

• IT Management Suite

Issue/Introduction

Tasks will not run on a client machine with a console error message "Object TaskServerHandler is not installed".  On the Task Status tab in the Agent UI, the Status is listed as 'Agent not Initialized'.

<event date="XXX XX XX:XX:XX" severity="2" hostName="<HOSTNAME>" source="Agent" module="AeXNSAgent.exe" process="AeXNSAgent.exe" pid="4236" thread="4560" tickCount="1266053203"><![CDATA[Object TaskServerHandler is not installed: Invalid class string (-2147221005). This situation should be resolved once the agent rollout has been completed.]]></event>

Environment

ITMS 8.x

Cause

This is caused by the Client Task Agent.dll not being registered with the Operating System.

Most commonly this has been observed to be caused by an upgrade to the product/agent and results immediately thereafter.

Resolution

1. Open a command prompt or script.
2. Execute the following command: regsvr32 <path>. The default file path is: C:\Program Files\Altiris\Altiris Agent\Agents\Client Task Agent\Client Task Agent.dll.
3. RegSvr32 UI should appear and show "DllRegisterServer in C:\Program Files\Altiris\Altiris Agent\Agents\Client Task Agent\Client Task Agent.dll succeeded."