License management (Post-Install)¶

This page consolidates and supersedes the legacy “Licensing Management” content that previously lived under Configuration & Setup.

Installing the license¶

The license file is installed using M-Files Admin. Using the Applications window in M-Files Admin for the target vault, select the appropriate application for the license to be installed.

Click on License and browse to the license file. Validate the license details and accept.

Expiry notification¶

An email notification will be generated when the license expires within 30 days. The notification relies on the database mail setup for error management to the contact defined in the MFSettings table.

Warning

The license will expire on the license end date. Renew the license before the expiry date.

Check license validity¶

If the license is invalid, it will show the reasons on the license record. The license validation failure will be recorded in the error log.

To troubleshoot a license issue, start with manually checking the license validity with spMFCheckLicenseStatus

EXEC dbo.spMFCheckLicenseStatus
    @Debug = 1

The result should look similar to the image below. If not, then email your result to support@lamininsolutions.com

Update expired or due to expire license¶

Contact us if the license is due to expire before the due date to prevent an outage of service. On receipt, apply the new license using M-Files Admin and the Applications window.

The license must be applied to each vault with a MFSQL Connector connection.

Check the configurator to validate that the license has been pulled through. If not, restart the vault.

Finally, check in SQL if the license is validated with spMFConnectionTest

Licensing troubleshooting¶

If the license is not validated then follow the next steps to identify a potential cause:

Check your email for any errors reporting. If you do not have DatabaseMail setup, then check the error log for more information on the error.

SELECT TOP 5 ErrorMessage, CreateDate
FROM MFlog
ORDER BY logid DESC

Run the license check with parameter to reset the license and show debug.

EXEC dbo.spMFCheckLicenseStatus
    @IsLicenseUpdate = 1,
    @Debug = 1

Check both the results and messages tabs in SSMS for further information.

If the expiry date is not filled in, or is incorrect then report it to support.

Check the messages for any obvious reasons that can be fixed.

Send screenshots of the result to support if still not resolved.