Handshake is the process when the agent is trying to download the necessary files used to start the patching process. The Handshake error is when the necessary files are not able to be downloaded to the client machine from the KACE SMA server.
Note: KACE Agent directories referenced in this article are based on KACE Agent 8.0 and above. For information about directories on reference to KACE Agent 7.2 and below see the following article - KACE Agent Directories
Here is a list of items to check when troubleshooting HANDSHAKE Error:
Note: Failure to download any of these files or any component of the patching engine failure to download such as PatchLinkWrapper.dll
From the Program Directory delete each of the .OSPX and .CHECKSUM files - C:\Program Files (x86)\Quest\KACE\ or C:\Program Files\Quest\KACE\
Additional OSPX and checksum troubleshooting
Run CMD as admin CD C:\Program Files (x86)\Quest\KACE\ or C:\Program Files\Quest\KACE\ - run LM.detection_x64 /l 4 /f KACEtest.txt
This file (KACEtest.txt) can be shared with Kace Tech Support for additional troubleshooting and research of the issue.
About OSPX and checksum files: The core ospx and checksum files which are the core handshake files are in the program directory along with LM.Detection_x64.exe (on X86 systems LM.Detection)which is the executable that kicks off detection. Originally these files are downloaded in the form of filename.checksum as the following example.
This is then turned into the patches.ospx file and the checksum ending inserted into a new file called pacthes.ospx.checksum
So for the winapplications.ospx 1a9a165b96a102ae6c474afa2214dbc2 file the result would be, in your
C:\Program Files (x86)\Quest\KACE\ directory the following two files
The content of the checksum file would be 1a9a165b96a102ae6c474afa2214dbc2 and this value would need to match the checksum loaded in the HANDSHAKE file located at C:\programdata\Quest\KACE\Patches\HANDSHAKE.LST
This HANDSHAKE list file contains the name of the core files that the client must download in order for handshake to be successful. They will vary depending on subscription choices but will contain the following files: windependencies.ospx, winapplications.ospx and winsecuritydefinitions.ospx.
Special Note for Kace 6.3 or lower versions: Check Nightly Backup Schedule to make sure it doesn't start the same time as the schedule patching job to the client machine because the server will be inaccessible. Note: this is no longer applicable in 6.4+ versions as the nightly backups do not take the appliance offline starting with 6.4.