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.
- 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 you 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, you 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, you 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 Installing and configuring 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
Setting the application license information.