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

Set the application license information

Learn how to set the application license information for the apps you register to MobileFirst Server.

License terms distinguish IBM MobileFirst™ Platform Foundation, IBM MobileFirst Platform Foundation Consumer, IBM MobileFirst Platform Foundation Enterprise, and IBM MobileFirst Platform Additional Brand Deployment. Set the license information of an application when you register it to a server so that license tracking reports generate the right license information. If your server is configured for token licensing, the license information is used to check out the right feature from the license server.

You set the Application Type and the Token License Type.

The possible values for Application Type are

B2C

Use this application type if your application is licensed as IBM MobileFirst Platform Foundation Consumer.

B2E

Use this application type if your application is licensed as IBM MobileFirst Platform Foundation Enterprise.

UNDEFINED

Use this application type if you don't need to track compliance against the Addressable Device metric.

The possible values for Token License Type are

APPLICATION

Use APPLICATION for most applications. This is the default.

ADDITIONAL_BRAND_DEPLOYMENT

Use this ADDITIONAL_BRAND_DEPLOYMENT if your application is licensed as IBM MobileFirst Platform Additional Brand Deployment.

NON_PRODUCTION

Use NON_PRODUCTION while you are developing and testing the application on the production server. No token is checked out for applications that have a NON_PRODUCTION token license type.

Important: Using NON_PRODUCTION for a production app is a breach of the license terms.

Note: If your server is configured for token licensing and if you plan to register an application with Token License Type ADDITIONAL_BRAND_DEPLOYMENT or NON_PRODUCTION, set the application license information before you register the first version of the application. With mfpadm program, we can set the license information for an application before any version is registered. After the license information is set, the right number of tokens is checked out when you register the first version of the app. For more information about token validation, see 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.">Token license validation.

Procedure

Set the license type of your app

• To set the license type with IBM MobileFirst Platform Operations Console
  1. Select your application
  2. Select Settings
  3. Set the Application Type and the Token License Type
  4. Click Save
• To set the license type with the mfpadm program,
  1. Use mfpadm app <appname> set license-config <application-type> <token license type>

     The following example sets the license information B2E / APPLICATION to the application named my.test.application

     prompt> echo password:admin > password.txt
     prompt> mfpadm --url https://localhost:9443/mfpadmin --secure false --user admin \
             --passwordfile password.txt \
             app mfp my.test.application ios 0.0.1 set license-config B2E APPLICATION
     prompt> rm password.txt

  For more information about mfpadm, see Administering MobileFirst applications through the command line.

Parent topic: License tracking