Description
This document is intended to explain provisioning action handlers so that failures seen in individual actions within a provisioning template can quickly be found and corrected.
Core Logs
Logs on the core will help with why a task is not starting, but do not provide a lot of detail about why a certain action failed.
The following are the core logs:
- %LDMS_HOME%\log\prov_schedule.exe.log
- %LDMS_HOME%\log\provisioning\provisioning.log
Client Logs
Device logs can be found in the following locations on the client:
- x:\ldprovision
- systemdrive:\windows\temp
Note: When troubleshooting Ivanti EPM Provisioning, it is helpful to turn off removal of the client provisioning folder.
Steps to disable removal of the client provisioning folder
1. Right-click desired provisioning template and go to "Properties".
2. In the left-hand pane, select "Options" and uncheck the box next to "Remove Client Provisioning folder".
Understanding Action Handler Flow (Client)
Each action that is run in a provisioning template is done by an action handler. An action handler may launch multiple other action handlers as part of its task. These other tasks could be considered to be child actions. The deploy image action in 9.5 and higher is an example of this. The Deploy Image action hander may automatically download the appropriate tool for imaging using a Download Action handler. The Deploy Image action then maps a drive to the network location where the image file is using the Map to Preferred Server action handler. Finally it will complete its own job of deploying the image using itself. The launch of each of the additional action handler used by deploy image will be logged in the DeployImageHandler.log along with the result code from the additional handler.
This sample DeployImageHandler.log shows the launch of two additional action handlers (DownloadHandler.exe and maptopreferredhandler.exe) as well as the exit codes for those handlers.
ExecuteCmd DownloadHandler.exe /source="http://mycore/ldlogon/provisioning/windows/imagew.exe" /dest="x:\ldprovision\imagew.exe"
created process, file handle 60 with non-readonly parameter
Process Exit Code: 0
Verifying file was successfully downloaded.
The file (x:\ldprovision\imagew.exe) was successfully downloaded
Getting free drive letter
Free drive letter: f
ExecuteCmd maptopreferredhandler.exe /path="\\mycore\images\win7.tbi" /driveletter=f /pathisfile
created process, file handle 68 with non-readonly parameter
Process Exit Code: 0
If a failure occurred in either of the additional actions (DownloadHandler and maptopreferredhandler) launched by deployimage the errors would be shown in the DeployImageHandler.log with a corresponding exit code. Zero indicates the task succeeded. If a failure occurred the DeployImageHandler.log may not contain enough detail to determine the root cause of the failure. Instead the log from the additional action handler (DownloadHandler.log or maptopreferredhandler.log) should be reviewed. The additional action handler may even launch its own child handlers before returning so those logs may also need to be reviewed.
If the failure seen in the DeployImageHandler.log was an error mapping the drive to the image, the MaptoPreferredHandler.log would provide additional details about the failure. Sometimes the error will be spelled out. Other times only an error code will be shown. The error codes shown will often correspond to the windows error codes listed at http://msdn.microsoft.com/en-us/library/windows/desktop/ms681381(v=vs.85).aspx. This allows a simple lookup to get additional information about the failure. Viewing the primary action handler log and following the failure through to the action handler log where the failure actually occurred will save time and frustration while troubleshooting provisioning templates.
Action Handler Logs
| Provisioning Action | Action Handler Log (Client) |
|---|
| Capture Image | CaptureImageHandler.log |
| Capture Profile | CaptureProfileHandler.log |
| Configure Agent | ConfigHandler.log |
| Configure Target OS | ConfigTargetOSHandler.log |
| Control Service | ServiceControlHandler.log |
| Copy File | CopyFileHandler.log |
| Create Directory | ManageDirectoryHandler.log |
| Delete File | DeleteFileHandler.log |
| Deploy Image | DeployImageHandler.log |
| Deploy Profile | DeployProfileHandler.log |
| Distribute Software | SDClientHandler.log |
| Download File | GetFileHandler.log |
| Download from Preferred Server | DownloadHandler.log |
| Execute File | ExecuteHandler.log |
| Hardware-Independent Imaging | HIIHandler.log |
| Inject Script | InjectScriptHandler.log |
| Install Mapped Software | MappedSoftwareHandler.log |
| Install Service | ServiceInstallHandler.log |
| Join Domain | JoinDomainHandler.log |
| Map/Unmap Drive | SmbShareHandler.log |
| Map/Unmap Drive to Preferred Server | MaptoPreferredHandler.log |
| Map Software to SLM Table | MappedSoftwareHandler.log |
| Partition | PartitionHandler.log |
| Patch System | PatchHandler.log |
| Reboot/Shutdown | LDProvision.exe.log |
| Replace Text | ReplaceTextHandler.log |
| Scripted Install | ClientActionHandler.log |
| Uninstall Service | ServiceRemoveHandler.log |
| Unzip File | UnzipHandler.log |
| Update Registry | RegUpdateHandler.log |
| Wait | WaitHandler.log |
| Windows Refresh | WindowsRefreshHandler.log |
