At MATLAB 7.11 (R2010b) a license file verification utility called "keycheck" was included along with the Network License Manager. As of R2011b the keycheck is fully integrated into the License Manager and is automatically run every time the manager is started.
Keycheck can examine a license file for possible misconfigurations. Example errors include duplicated license keys and invalid license numbers. Keycheck provides a convenient tool to assist license administrators in maintaining license compliance.
Keycheck will only verify license files recently generated at the MathWorks License Center. Network license files generated by the License Center are backwards compatible and include all keys for all releases.
Keycheck verification is performed against a license file, not a running license manager. Keycheck does not provide real-time license manager verification.
While designed to identify common license file errors, Keycheck does not detect all possible license misconfigruations. Do not rely upon Keycheck to guarantee license compliance.
The keycheck application is located in:
$MATLAB\etc\$ARCH
where $MATLAB is the MATLAB installation location and $ARCH is the machine architecture.
NOTE: Keycheck is now an automatic function when starting the License Manager in releases R2011a on.
Follow the instructions below to use the keycheck utility:
Windows
========
1. Open a Windows Command Prompt by clicking on the Start Menu and selecting All Programs->Accessories->Command Prompt.
2. Change directory into the $MATLAB\etc\$ARCH folder, ex:
C:\> cd "Program Files\MATLAB\R2010b\etc\win32"
3. Run the program "keycheck.exe" with the "-file" flag and the path to the license file to be scanned, ex:
C:\Program Files\MATLAB\R2010b\etc\win32> keycheck.exe -file ..\license.dat
Unix/Linux/Mac OS X
==============
1. Open a terminal window (Application->Utilities->Terminal on Mac OS X)
2. Change into the $MATLAB\etc\$ARCH directory, ex:
[licserver:~] % cd /usr/local/MATLAB/R2010b/glnxa64/
3. Run the "keycheck" binary with the "-file" flag and the path of the license file to be scanned, ex:
[licserver:/usr/local/MATLAB/R2010b/etc/glnxa64] % ./keycheck -file ../license.dat
A successful validation will print the following message:
Warning: This verification is being done against a license file and not a license server.
This may not provide a complete verfication of the license.
License verification test BadDateTest passed
License verification test BadLicenseNumTest passed
A failed verification will provide details of the failing license keys, ex:
Warning: This verification is being done against a license file and not a license server.
This may not provide a complete verfication of the license.
License verification test BadDateTest failed
Found multiple entries for MATLAB
License number: 123456
Feature name: MATLAB
License verification test BadLicenseNumTest passed
1 failures found.
For assistance troubleshooting Keycheck license verification failures please contact Installation & Licensing support at the link below:
