PXE Key Match Utility

Products

• Deployment Solution
• Ghost Solution Suite

Issue/Introduction

Is there any way to verify that the MMAccessKey is correctly authenticating to the DS Security key when the PXE Configuration Utility is authenticating and trying to connect?

Also, is there a way to re-create the MMAccessKey.ini file if it is lost or corrupted?

Environment

DS 8.x

GSS 3.x

Resolution

Attached to this article is a tool, PxeKeyMatch.exe (found in pxekeymatch.zip), that can be used in cases where the PXE Configuration Utility fails to open, and a message appears in the logs that shows that the authentication failed. This tool allows you to check the MMAccessKey against the DS Security key. It also has the ability to regenerate the MMAccessKey in the case the it is lost, or if it is failing and needs to be re-created.

To use this utility:

• Run it from a Windows Command prompt on the Deployment Server (it actually needs to be run from the PXE Manager, but this is always the same computer as the Deployment Solution server).
• Change to the folder that contains the PxeKeyMatch.exe and run it from that location.
• If you run the utility with no command line parameters it will check the MMAccessKey.ini file against the DS Security key and it will either return back a message that says that they do match, or that they do not match.
• You can also run the utility with the -sync switch and it will re-create the MMAccessKey.ini file.
• Running the utility with the -sync switch will not modify the DS Security key, nor can it re-create that key. If for some reason the key is lost (this could only happen if the registry key was manually deleted) the entire Deployment Solution will need to be reinstalled.

NOTE: When re-creating the MMAccessKey you will need to update the PXEManager.ini file. Before updating that file first stop the PXE Manager Server from the Windows Services list. After that service is stopped you can open up the PXEManager.ini file and make changes. You will need to copy the key from the MMAccessKey.ini file and replace the key found in the PXEManager.ini file (found on the sixth line of that file). Once that file is updated and saved, start the PXE Manager Service back up.

Additional Information

The PXE manager service has not connected with the DS or GSS server yet