Question:
What are the steps to troubleshoot a failed Altiris Agent Push in NS 6.0?
Answer:
The following outlines the process used for an Altiris Agent push, and possible causes for points of failure. When the point of failure has been determined, usually the problem will be apparent either by a log entry or by the location of that failure.
1. Configuration of the Altiris Agent Push
a.View the Installation Settings in order to determine how the push is configured, located in the Altiris Agent push page by clicking the “Installation Settings” button.
b. If the client uses a proxy server, check the option “Use Proxy”.
c. Note the field “Use different Notification Server” and make sure the configuration is correct (or unchecked).
d. *The credential fields are key to the Altiris Agent push. If no credentials are chosen, it will use the account specified as the Application Identity/Application Credentials. If pushing the Agent in a multi-Domain or Workgroup environment, the account used for the push must have local Administrator privileges on the machine(s) being pushing to.
2. Initiating the Push
a. A push can be done to one or more machines at one time. Use the “Install Altiris Agent” to initiate the push.
b. The status section on the Agent push page can be useful. Keep this in mind when walking through the items of a Push installation.
3. Installer Service – AexSWDInstSvc.exe
a. The actual install package for the Altiris Agent does not get pushed to the client machine. The installer service, named AeXSWDInstSvc.exe, is pushed to the client machine.
b. The user account specified on the push page settings, or the Application Identity if no account is supplied, is the account that attempts to access the \\machinename\admin$ share on the destination machine.
c. As soon as the Installer Service reaches the client machine, it begins to log information into the log file AeXSWDInstSvc.log, located at C:\<Windir>\System32. The EXE resides in the Admin$ share (generally the %windir%).
d. It will register the EXE as a service. This service has limited ability for throttling and check-point recovery when downloading the Agent install Package. If a machine is rebooted before it has successfully downloaded the install package, the service will use check-point recovery to pick up where the download was terminated.
e. If a push fails, and this log does not exist, then the Installer Service did not reach the client machine. Troubleshoot access rights being used for the push, and look at the status in the Altiris Agent push page. If the log does exist, review the details.
f. The installer service will download the actual install package, named AeXNSC.exe.
g. Next it executes the install package.
h. Once the install package is executed, the AeXSWDInstSvc.exe removes itself as a Service.
i. Lastly, it removes itself (EXE) from %windir%.
4. Agent Install Package – AeXNSC.exe
a. If the Installer Service fails to download the AeXNSC.exe file, it will be reflected in the AeXSWDInstSvc.log file. Look for authentication or HTTP request errors.
b. If the Installer Service fails to execute the downloaded file, it will also be reflected in the AeXSWDInstSvc.log file. Look for execution errors.
c. If the Install Package is downloaded successfully and executed, it will begin to write to the file AeXNSC.log, located at C:\<Windir>\System32.
d. Any problems with the Package install will be logged in the AeXNSC.log file.
e. When the installation is complete, the agent service will be started, and the Agent will begin logging information into the agent.log and subsequent log files.
5. Communication back to the Server – Agent installed
a. It is possible that while a push it successful, the Agent Communication is unsuccessful. This may result in an erroneous status on the Altiris Agent push page.