License Manager

Overview

The License Manager (LicenseMgr) CSP administers the software licenses on a device, allowing an administrator or app running on the device to control the usability of software features that require licensing. Software components can be made usable, unusable or feature-limited based on the license. If a component requires licensing, the absence of a valid license will limit or prevent its functionality. Software components that to not require licensing are not effected by this CSP.

Main Functionality

Zebra Licensing

• Perform licensing actions using Zebra or (legacy) Symbol methods
• Activate / Return / Return All / Refresh Software License(s)
• Specify an Activation ID
• Specify license source:
  • Cloud
  • Cloud proxy
  • Local license server
  • Preactivated license
• Remove license source
• Specify URL and friendly name for on-premise license server
• Specify URL and friendly name for cloud server via proxy

Symbol Licensing

• Apply software license(s) on a device
• Revoke software license(s) from a device
• Perform licensing actions on standard and custom features
• Select whether to embed or reference a license
• Verify licenses on a device

License Manager App

Some Zebra devices include a built-in app called License Manager, which allows device users and/or administrators to perform license-related tasks manually on the device.

The License Manager icon (left), and the app's home screen showing multiple activated licenses.

License Manager User Guide (PDF)

License Acquisition

Software licenses are acquired from a Zebra Software License Server. They are issued as Software License Files and are associated with specific software components through the use of Licensed Feature Names. A Software License File can be used only to enable use of its associated Licensed Feature Name. A component can have multiple capabilities, each controlled through separate Licensed Feature Names. Alternatively, a component can have all of its capabilities controlled through a single Licensed Feature Name.

Software Licenses acquired from a Zebra Software License Server may be Individual Device Licenses, with each Software License File tied to a specific device serial number. In such cases, it is necessary to apply the right Software License File to each matching device. The Zebra Software License Server also provides Enterprise Licenses, which are issued to all devices owned by an enterprise. In such cases, the same Software License File can be applied to each device owned by that enterprise.

License Verification

Software License Files are acquired from the Zebra Software License Server, stored locally or online, and referenced through the LicenseMgr. However, the server does not verify whether such files are matched to a particular Licensed Feature. If a valid Software License File is wrongly applied to Licensed Feature other than the intended feature, that feature is enabled and no error results.

To prevent this, Zebra recommends using the Verification Method parameter (below) to verify that Licensed Feature Name(s) match those contained in the Software License File(s). This causes an error to be returned in the Result XML in the event of a mismatch.

Preactivated License Restrictions

• Preactivated Licenses are valid only on the day they are generated.
• If multiple Preactivated Licenses are generated, they must be applied in the same order as generated.
• Preactivated Licenses must be applied BEFORE all other License Actions.
• If combining the application of Activation IDs and Preactivated Licenses in the same configuration Profile, Preactivated Licenses MUST be applied first.

License Choice

Used to specify the method of performing license actions on the device. "Legacy" Symbol actions are performed on license files stored on the device. Zebra actions pertain to a server-based license store.

Parm Name: LicenseChoice

Zebra License Action

Used to select the Action to perform on an Activation ID (AID) on the device. For Zebra-branded devices only. For Symbol-branded devices, use the License Action parameter. To use Option 6, specify the 39-character Activation ID using the Activation ID Refresh parameter. Note: Options 4 and 5 are used programmatically on the device and are not intended for human interaction.

IMPORTANT PREACTIVATED LICENSE RESTRICTIONS:

• Preactivated Licenses are valid only on the day they are generated.
• If multiple Preactivated Licenses are generated, they must be applied in the same order as generated.
• Preactivated Licenses must be applied BEFORE all other License Actions.
• If combining the application of Activation IDs and Preactivated Licenses in the same configuration Profile, Preactivated Licenses MUST be applied first.

Shown if: The License Source is "Zebra Cloud" and License Action Zebra is "Activate AID" and License Choice is "Perform Zebra license action" and License Choice is "Use a local license server option"

Parm Name: LicenseActionZebra

License Source

Controls whether to use a cloud-based or local Zebra Licensing Server, or preactivated file on the device. When Zebra Cloud is selected (option 1), specify the server location using the License Cloud URL parameter.

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra"

Parm Name: LicenseSource

License Cloud URL

Used to specify the source for Zebra cloud-based licensing on the device.

Shown if: The License Source is "Zebra Cloud" and License Action Zebra is "Activate " and License Choice is "Zebra"

Parm Name: LicenseCloudURL

License Server URL

Used to specify the URL (and optional port number) of an on-premise server containing Zebra License Activation ID(s) or a relay server pointing to an external licensing server. This parameter is required only for devices that do not have access to networks outside the walls of an organization in which they are to be administered.

Parm value input rules:

• String containing a valid URL (and optional port number)
• Must contain at least 1 character

Example: http://InternalLicenseServer.lan:8080

Shown if: The License Source is "Specify a custom URL for Cloud Licensing Service" and License Choice is "Zebra"

Parm Name: URL

Requires:

• MX: 7.1+

Server Friendly Name

Used to specify a "friendly" name for the local licensing server as an aid to easy identification.

Parm value input rules:

• String of at least one character

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "LLS" OR License Source is "Zebra Cloud" and License Choice URL is "Zebra Production Cloud Via Proxy, Zebra Test Cloud Via Proxy or Zebra Custom Cloud"

Parm Name: ServerFriendlyName

Requires:

• MX: 7.2+

Activation ID

Used to manually specify the 39-character code provided by the Zebra licensing system for activating a license on the device.

Parm value input rules:

• String containing the 39-character license code
• Must contain at least one character

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Zebra Cloud or LLS"

Parm Name: ActivationID

Requires:

• MX: 7.1+

Activation Quantity

Used to specify the number of license copies to be activated on the device.

Parm value input rules:

• String containing at least one character

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Zebra Cloud or LLS"

Parm Name: ActivationQuantity

Requires:

• MX: 7.1+

Preactivated License Source

Used to specify the source of the preactivated license file on the device.

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Preactivated"

Parm Name: PreactivatedLicenseSource

Preactivated License Method

Used to specify the delivery method of the preactivated license file on the device. When "reference" is selected (option 2), use the "Preactivated License Path And File Name" parameter to specify the path and file name of the licence file on the device.

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Preactivated"

Parm Name: PreactivatedLicenseMethod

Preactivated 'Blob'

Used to specify the licensing file to be embedded in the XML.

Parm value input rules:

• String containing at least one character

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Preactivated" and Preactivated License Method is "Reference"

Parm Name: PreactivatedBlob

Requires:

• MX: 8.1+

Preactivated File and Path

Used to specify the path and file name of the preactivated license file on the device.

Parm value input rules:

• String containing at least one character

Shown if: The License Action Zebra is "Activate" and License Choice is "Zebra" and License Source is "Preactivated" and Preactivated License Method is "Embed"

Parm Name: PreactivatedLicensePathAndFileName

Requires:

• MX: 8.1+

Return License Source

Used to select the method by which to return a Zebra license.

Shown if: The License Action Zebra is "Return" and License Choice is "Zebra"

Parm Name: ReturnLicenseSource

Return All License Source

Used to select the server to which to return license(s) reclaimed from the device(s). When returning license(s) to a local server, enter the server name using the Return AID License Source Name parameter.

Shown if: The License Action Zebra is "Reset" and License Choice is "Zebra"

Parm Name: ReturnAllLicenseSource

Activation ID Return

Used to manually specify the 39-character code provided by the Zebra licensing system for reclaiming a license from the device. Reclaimed licenses are returned to the organization for assignment elsewhere.

Parm value input rules:

• String containing the 39-character license code
• Must contain at least one character

Shown if: The License Action Zebra is "Return" and License Choice is "Zebra"

Parm Name: ActivationIDReturn

Requires:

• MX: 7.1+

Return AID Server Friendly Name

Used to enter the "friendly" name of the local licensing server to which to return reclaimed license activation IDs.

Parm value input rules:

• String of at least one character

Shown if: The License Action Zebra is "Return" and License Choice is "Zebra" and Return License Source is "Server Friendly Name"

Parm Name: ReturnAIDLicenseSourceName

Requires:

• MX: 9.2+

Activation Quantity Return

Used to specify the number of license copies to be reclaimed from the device.

Shown if: The License Action Zebra is "Return" and License Choice is "Zebra"

Parm Name: ActivationQuantityReturn

Requires:

• MX: 7.1+

Refresh Activation ID

Used to specify a license code to refresh on a device. This parameter works in conjunction with the RefreshID Zebra License Action, which causes the device to contact the licensing server to renew a device license following a license renewal purchase.

Parm value input rules:

• Must be a 39-character string containing a valid Activation ID code

Shown if: License Action Zebra is "Refresh AID" and License Choice is "Zebra"

Parm Name: ActivationIDRefresh

Requires:

• MX: 7.2+

Delete License Source Name

Used to enter the "friendly" name of a local licensing server to delete as a license source.

Parm value input rules:

• String of at least one character

Shown if: The License Action Zebra is "Delete License Source" and License Choice is "Reset"

Parm Name: DeleteLicenseSourceName

Requires:

• MX: 9.2+

Feature To Acquire

This parameter is not intended for user interaction.

Used to programmatically specify the name of the feature to be enabled.

Parm value input rules:

• String from 1-40 characters exactly matching the feature to be acquired

Shown if: License Action Zebra is "Acquire Feature" and License Choice is "Perform Zebra license action"

Parm Name: FeatureToAcquire

Requires:

• MX: 7.1+

Acquire Feature Version

This parameter is not intended for user interaction.

Used to programmatically specify the version number of the feature to be acquired using the Feature To Acquire parameter.

Parm value input rules:

• Integer or decimal value from 1-10 digits

Shown if: License Action Zebra is "Acquire Feature" and License Choice is "Perform Zebra license action"

Parm Name: AcquireFeatureVersion

Requires:

• MX: 7.1+

Acquire Feature Count

Used by licensed apps on the device to obtain the number of times a feature can be used. This feature is used programmatically, and is not intended for human interaction.

Parm value input rules:

• Must be a positive integer (default = 1)

Shown if: License Action Zebra is "Acquire Feature" and License Choice is "Zebra"

Parm Name: AcquireFeatureCount

Requires:

• MX: 7.2+

License Action

Used to apply or remove a Software License on a legacy Symbol device. For Zebra-branded devices, use the License Action Zebra parameter.

Applying a Software License on a device makes the specific capabilities of that Software Component usable on that device. Removing a license makes the controlled capability unusable or limits its features. Note: The license removal action deletes the licence only from the private license store; the license file still exists on the device and must be deleted separately.

Shown if: License Choice is set to "Symbol"

Parm Name: LicenseAction

Verification Method

Controls whether to verify that the Licensed Feature Name specified in the Standard or Custom Feature Name parameters matches the contents of the Software License File. Zebra recommends using this parameter to help prevent license-feature mismatch.

Software License Files are acquired from the Zebra Software License Server, stored locally or online and referenced through the LicenseMgr. The sever does not verify whether such files are matched to a particular Licensed Feature. If a valid Software License File is wrongly applied to Licensed Feature other than the intended one, the feature will not be enabled and no error will result. The Verification Method parameter prevents this scenario by verifying that Licensed Feature Name(s) match those contained in the Software License File(s) and otherwise generates an error in the Result XML.

Shown if: The License Action is "Symbol" and License Choice is "Symbol"

Parm Name: VerifyMethod

Standard Feature Name

Used to specify the Standard Licensed Feature Name against which to verify the Software License File.

Note: Currently, there exists a single defined Standard Licensed Feature Name, that of the SimulScan OCR/OMR feature. Selecting it avoids the need to enter the exact (custom) value of the Licensed Feature Name. To verify other features, use the "Verify Custom Name" and specify the Licensed Feature Name to match the Software License File being used.

Shown if: The License Action is "Symbol" and License Choice is "Symbol"

Parm Name: VerifyStandardFeatureName

Custom Feature Name

Used to specify a Custom Licensed Feature Name, which must match exactly the Licensed Feature Name contained within the Software License File acquired from Zebra Software License Server.

Note: This option must be used to verify any Licensed Feature Name other than those contained in the list of Standard Licensed Feature Names. The Licensed Feature Name must be entered exactly as acquired from the Zebra Software License Server with identical case and without any additional whitespace or other characters.

Parm value input rules:

• String with a valid Custom Licensed Feature Name that was contained within a Software License File acquired from the Zebra Software License Server

Shown if: The Verify Method is "Verify against a custom feature name" and License Choice is "Symbol"

Parm Name: VerifyCustomFeatureName

Requires:

• MX: 4.3+

License Method

Used to specify the method of supplying the Software License.

The Embed value (option 1) indicates that the contents of the Software License File is embedded into the Request XML. To use this option, the Base64-encoded contents of the Software License File acquired from the Zebra Software License Server must be Base64-encoded a second time by the MDM Agent before being embedded this Request XML document. Note: Although it increases the data size, this option offers the advantage of a self-contained Request XML.

The Reference value indicates that a Software License File, which must be present in the device file system, is referenced by its path and file name. Note: This option requires that the Software License File be transferred to the device file system before the Request XML is submitted, and requires specification of the exact path and file name of the Software License File in the device. If the license should be applied after an Enterprise Reset, the license file must be stored in a persistent location such as the /enterprise directory.

Note: Regardless of the method used to supply the Software License File (Embed or Reference), the supplied Software License File must contain valid contents acquired from the Zebra Software License Server. An attempt to apply a Software License File that contains invalid contents will result in an error in the Result XML. In addition, if the Software License File was an Individual Device License, the device serial number embedded in the Software License File must match the serial number of the device onto which it is being applied. Any attempt to apply a mismatched license will generate an error in the Result XML.

Shown if: The License Action is "Symbol" and License Choice is "Symbol"

Parm Name: LicenseMethod

License File 'Blob'

Used to specify the Software License File, the contents of which are embeded in the XML. The contents are Base64-encoded, which increases content size by about 33 percent. The Software License encoded within the Request XML is extracted and applied to the device.

Parm value input rules:

• String with a minimum size of 2 characters (minimum required to hold 1 byte of content)
• The data must be Base64 encoded (4 characters hold 3 bytes of content)

Shown if: The License Action is "Apply" and License Method is "Embed" and License Choice is "Symbol"

Parm Name: LicenseBlob

Requires:

• MX: 4.3+

License File and Path

Used to specify the path and file name of a Software License File, which must exist in the device file system and contain the exact contents acquired from the Zebra Software License Server. This parameter applies the Software License specified in the Software License File to the device.

Parm value input rules:

• String with a minimum size of 1 character
• Must be a valid path and file name of a valid Software License File in the device file system

Shown if: The License Action is "Apply" and License Method is "Reference" and License Choice is "Symbol"

Parm Name: LicensePathAndFileName

Requires:

• MX: 4.3+

Select Remove Method

Controls the method of selecting the Licensed Feature Name, which identifies the Software License to be removed from the device.

Shown if: The License Action is "Remove" and License Choice is "Symbol"

Parm Name: SelectMethod

Remove Standard Feature

Used to specify the desired Standard Licensed Feature Name that identifies the Software License to be removed from the device.

Shown if: The Select Method is "Standard" and the License Choice "Symbol"

Parm Name: SelectStandardFeatureName

Remove Custom Feature

Used to specify a custom Licensed Feature Name to identify the Software License to be removed from the device. To ensure proper removal, specify the exact Licensed Feature Name contained in the original Software License File applied to the device, including letter case, whitespace, etc.

Parm value input rules:

• String with a valid Custom Licensed Feature Name contained within a Software License File acquired from the Zebra Software License Server

Shown if: The Select Method is "Custom" and the License Choice "Symbol"

Parm Name: SelectCustomFeatureName

Requires:

• MX: 4.3+

Examples

Show All Applied Software Licenses

Request XML

In the query below requests information on all Software Licenses applied on the device:

    
    <wap-provisioningdoc>
        <characteristic-query type="LicenseMgr"/>
    </wap-provisioningdoc>

Success (single SimulScan License)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

If additional Software Licenses were applied, additional information would be returned in the Success Result XML. The same Request XML submitted on a device with no Software Licenses applied would return a Failure Result XML similar to the one shown below:

Failure Result XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

Show Specific Software License Info

The query below applies only to Software Licenses for the SimulScan Software Component.

Request XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" >
            <characteristic-query type="ExistingLicense">
                 <parm name="SelectStandardFeatureName" value="SIMULDC1_0_0"/>
            </characteristic-query>
        </characteristic>
    </wap-provisioningdoc>

Success (single SimulScan License)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

Failure

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

Activate a license from a local server

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="LLS"/>
        <parm name="URL" value="http://10.61.206.102:7070/request"/>
        <parm name="ServerFriendlyName" value="Local Server Name"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Return a license to a local server

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="3"/>
        <parm name="ReturnAIDLicenseSourceName" value="Local Server Name"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Return all licenses to a local server

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="reset"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnAllLicenseSource" value="3"/>
        <parm name="ReturnAllAIDLicenseSourceName" value="Local Server Name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Activate a license from a cloud-based server

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="Zebra Cloud"/>
        <parm name="LicenseCloudURL" value="2"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Return a license to a cloud-based server

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="1"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Return all licenses to a cloud-based server

<wap-provisioningdoc>
<characteristic type="LicenseMgr" version="7.3" >
    <parm name="LicenseChoice" value="zebra"/>
<characteristic type="LicenseZebra">
    <parm name="LicenseActionZebra" value="reset"/>
<characteristic type="ExistingLicenseZebra">
    <parm name="ReturnAllLicenseSource" value="1"/>
</characteristic>
</characteristic>
</characteristic>
</wap-provisioningdoc>

Delete a local server from cloud source list

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="deleteLicenseSource"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="DeleteLicenseSourceName" value="local server name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

Refresh a license

<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="8.1" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="refreshAID"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ActivationIDRefresh" value="c3fe-2bd5-e8c0-4058-a93a-dc82-bab6-0939"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>