For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Token license validation

If you install and configure IBM MobileFirst™ Platform Server for token licensing, the server validates licenses in various scenarios. If your configuration is not correct, the license is not validated at application registration or deletion.

Validation scenarios

Licenses are validated in various scenarios:

On application registration

Application registration fails if not enough tokens are available for the token license type of your application.

Tip: We can set the token license type before you register the first version of your app. For more information, see Set the application license information.

Licenses are checked only once per application. If you register a new platform for the same application, or if you register a new version for an existing application and platform, no new token is claimed.

On Token License Type change

When we change the Token License Type for an application, the tokens for the application are released and then taken back for the new license type.

On application deletion

Licenses are checked in when the last version of an application is deleted.

At server start

The license is checked out for every registered application. The server deactivates applications if not enough tokens are available for all applications.

Important: The server does not reactivate the applications automatically. After you increase the number of available tokens, we must reactivate the applications manually. For more information about disabling and enabling applications, see Remotely disabling application access to protected resources.

On license expiration

After a certain amount of time, the licenses expire and must be checked out again. The server deactivates applications if not enough tokens are available for all applications.

Important: The server does not reactivate the applications automatically. After you augment the number of available tokens, we must reactivate the applications manually. For more information about disabling and enabling applications, see Remotely disabling application access to protected resources.

At server shutdown

The license is checked in for every deployed application, during a server shutdown. The tokens are released only when the last server of a cluster of farm is shut down.

Causes of license validation failure

License validation might fail when the application is registered or deleted, in the following cases:

• The Rational® Common Licensing native library is not installed and configured.
• The administration service is not configured for token licensing. For more information, see Install and configure for token licensing.
• Rational License Key Server is not accessible.
• Sufficient tokens are not available.
• The license expired.

IBM® Rational License Key Server feature name used by IBM MobileFirst Platform Foundation

Depending on the token license type of an application, the following features are used.

Token License Type	Feature name
APPLICATION	ibmmfpfa
ADDITIONAL_BRAND_DEPLOYMENT	ibmmfpabd
NON_PRODUCTION	(no feature)

For more information about setting the token license type, see Set the application license information.

Parent topic: License tracking