Migrating Your FMs

Migrating your existing FMs should require only makefile changes and recompilation. It is recommended that you take advantage of the enhancements to the FM SDK introduced in Release 5 (or higher) when migrating your source.

NOTE   FM's compiled using the SafeNet ProtectToolkit FM SDK with firmware 5.01.00 or newer do not load correctly into HSMs using firmware 5.00.xx.

To migrate your FMs

1.Install the SafeNet ProtectToolkit-C SDK and FM SDK on a workstation or VM running a supported Linux OS.

NOTE   By default, the FM SDK is set to operate in emulation mode. You cannot install FMs while in emulation mode. To install an FM you must change the operating mode to hardware mode. The operating mode is specified when you run the installation script, and can be changed by re-running the script.

2.Update your makefiles, as outlined in Makefiles

3.Review the list of changes and enhancements introduced in the Release 5 (or higher) FM SDK, as detailed in “Summary of Changes and Enhancements on page 12, to determine whether any additional changes are required. You may also want to update your code at this time to implement some of the enhancements.

4.Build your source.

5.If necessary, fix any compile errors. See Summary of Changes and Enhancements for a list of the changes introduced in Release 5 (or higher) that may be the source of the errors.