III. Manually Assign License

This section describes the process for activating a license on a single device running Android. To manually activate a license on a device running Windows Moblie/CE, see the Windows Mobile/CE section. To remotely activate multiple licenses for an entire organization, see the Mass Deployment section of this guide.

License Source Types

  • Cloud-based server (internet connection required)
  • Local server (on customer premises)

Connectivity Options

  • Production Cloud Direct - License Manager maps automatically to web-based Zebra Licensing Server to activate licenses; no server configuration required.
  • Production Cloud Through Proxy - License Manager maps automatically to web-based Zebra Licensing Server through customer's on-premise proxy server. Requires configuration of proxy server settings.
  • Custom Cloud - Reserved for future use.
  • Test Cloud Direct - For Zebra internal use only.
  • Test Cloud Through Proxy - For Zebra internal use only.

BEFORE BEGINNING

  • Confirm that the clock is set correctly on the device to ensure proper license-application behavior.
  • License-key barcodes are not provided by Zebra; they can be created by the licensee to ease the activation process. Keys also can be typed in manually.

To activate a device license:

  1. Locate and launch the License Manager app:
  2. On launch, License Manager displays active licenses (if any).
    Tap the floating action button:
  3. When the Activation screen appears:
    1. Enter the license key (Activation ID):
    2. Tap "Select License Source"and select desired options.
    3. Tap SUBMIT button.
      If prompted to set device clock, Tap "Continue." The "Activation" screen reappears:
  4. Tap Activate.

Successful license activation is indicated by a screen similar to the image below:

The Android device is now licensed to use Enterprise Browser 2.x.

Windows Mobile/CE Devices

Zebra provides License Manager apps for its devices running Android and Windows Mobile/CE. License Manager 1.0 (or higher) is required for licensing Windows Mobile/CE devices, and is included with the Microsoft Installer (MSI) file (when installing from Windows) and as a .CAB file when installing from macOS.

IMPORTANT: Zebra recommends using StageNow to generate XML files required for this process. Download StageNow; it's free.

To activate a license on a device running Windows Mobile/CE:

  1. Push the XML file required for license activation to the device.

  2. Locate and launch License Manager on the device.
    Current licenses on the device (if any) are shown along with a series of buttons: Details - displays information about selected license.
    Refresh - contacts the licensing server to renew a device license following the purchase of a license renewal.
    Button functions:
    Return - relinquishes the selected license.
    Add License - begins the license activation process.
    Settings - displays the License Manager Settings panel.

  3. Tap "Add License" button. "About License Manager" screen appears.
    Tap "License Source" button.

  4. Select "Production Cloud Direct" from the server list. Details - displays information about the selected licensing server.
    Delete - removes a user-defined licensing server (none shown).

  5. Using an EMM system, launch License Manager with command line arguments similar to those shown. This example was tested using SOTI Mobi control. 

    
// for XML file in root directory of device: 
start "\Program Files\LicenseManager\LicenseManager.exe" activate license.xml

// for XML file in a specific License Manager folder on device:  
start "\Program Files\LicenseManager\LicenseManager.exe" activate \Program Files\LicenseManager\license.xml


  6. Following the operation, a Result.xml file is placed in the same location as the source XML file.

Example

The following XML file selects the cloud-based Zebra Licensing Server as the license source. 


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="8.1" >
        <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>

Off-line Licensing

License Manager provides a Local License Server option, enabling organizations to employ an on-premise server to distribute licenses to devices without access to the internet. This option requires software installed on a company's own IP-based Linux or Windows server in advance of license distribution to devices.

For more information, including hardware requirements and setup instructions, download the appropriate Local License Server Administration Guide from the Zebra License Management support portal page.

BEFORE BEGINNING

  • Install and configure Local License Server according to the relevant admin guide
  • Acquire a .BIN file containing licenses (Activation IDs) from Zebra License Server for all devices to be licensed
  • Ensure target devices are connected to the Local Licensing Server

IMPORTANT PERSISTENCE NOTES:

  • To use StageNow to persist license keys on the device following an Enterprise Reset:
    • All License Manager and Persist Manager steps MUST be stored in a SINGLE PROFILE.
    • WLAN settings MUST be configured BEFORE license activation steps in the Profile.
    • Keys MUST be stored in the /enterprise/usr folder on the device.
To License from a Local Server:
  1. Tap Local Server from the License Source drop-down.
    A screen appears as below.
  2. Enter the server URL, provide a name and tap SUBMIT.
  3. Enter or scan the license key for the device.
    Then Tap Activate.

Successful license activation is indicated by a screen similar to the image below:

The device is now licensed to use Enterprise Browser 2.x.

Mass Deployment

Mass-deployment of Enterprise Browser device licenses requires use of an Enterprise Mobility Management (EMM) system and/or Zebra StageNow tools and its License Manager Setting Type.

IMPORTANT NOTES:
  • The procedures described below include only those for deploying and activating licenses for EB 2.0 (or later). They DO NOT include the purchase process for license activation IDs nor configuration of the network and device clock settings, which are required to download the app and properly apply the license(s).
  • To set license keys to remain on the device following an Enterprise Reset, keys MUST be stored in the /enterprise/usr folder on the device and in a single Profile activated using License Manager and preserved using Persist Manager.

Prerequisites

  • Profiles for correctly configuring device clock and network settings
  • Software License key(s) (aka Activation IDs)
  • All necessary EB 2.x application (binary) files

Zebra recommends testing any new Profile on a working device before general deployment.

To create the licensing portion of a StageNow Profile:

  1. Launch StageNow and select “Create new Profile" from the left-hand pane.
    The "Select a Wizard" dialog box appears.

  2. Select MX version to match device, click "Xpert Mode" and click the "Create" button.

  3. Enter a Profile name and click "Start" button.

  4. Single-click LicenseMgr (scroll down if necessary); then click "Update" button.

  5. Under "License action type:" select “Perform Zebra license action.” Additional options appear: Click image to enlarge.

  6. Set the parameters as required to activate the license:
    a. For cloud-based licensing:
    Zebra recommends this option for the best device visibility from the licensing portal:

    • Zebra license action: Activate AID -> select "Use one of the Zebra Licensing cloud options"
    • Cloud Source: "Use the Zebra licensing Production Cloud"
    • Enter the AID and quantity. Select "Continue"

    b. For local (on-premise) licensing:
    Best for fire-walled networks or those lacking internet access:

    • Zebra license action: Activate AID -> select "Use a local license server option"
    • Enter the URL, friendly name, AID and quantity
    • Select Continue

  7. To persist license key(s) on the device following an Enterprise Reset:
    a. Download(†) and save key(s) as .BIN file(s) to /enterprise/usr folder on the device
    b. From a single Profile:

    • Activate key(s) using License Manager (licensing method="reference a preactivated license file already on the mobile device")
    • Preserve settings using Persist Manager

  8. Complete Profile creation and scan the staging barcode

  9. Confirm that the Profile successfully licensed the device:
    a. Launch the License Manager app on the device; activated license should be visible
    b. Alternatively, launch EB 2.0 on the device and view licensing status on splash screen
    c. Quantity of available licenses visible on the licensing portal should decrease by the number of licenses deployed. A list of device IDs also is visible there

(†) To download a License key as a .BIN file from the Zebra Licensing Portal, select "Download Capability Response" from the Device Action menu. Each .BIN file contains a license for a specific device.

Also see related guides.

License Transfer

Enterprise Browser supports the transfer of licenses from one device to another if the device licenses were originally activated using a cloud-based or local licensing server. This is done by returning the activated license(s) to the pool (using License Action "Return") and activating them on new device(s).

See the License Manager section of Zebra's StageNow tool for details.

Logging

On Android devices, License Manager activities are captured in adb and RXLogger log files.

On Windows Mobile/CE devices, License Manager activities are written to LM_Log.txt in the app's install directory.

Notes

The following notes are derived from frequently asked questions about device licensing and apply to most licensing scenarios.

  • Licenses erased by a Factory Reset can be reissued to the same device(s) using the same StageNow Profile and the same License Source (i.e. cloud-based or local server).
  • When ordering additional unit entitlements for an existing site license, include the Activation ID with the order to ensure that the same EMM policy can be used for the additional devices.
  • The fastest way to deploy a trial license on a device is by using the License Manager app and the manual license assignment procedures above.
  • Device licenses can be activated using:
    • StageNow and the License Mgr CSP
    • OEMConfig tool, part of Zebra's EMM Toolkit (available to authorized partners only)

-->

Redirecting to TechDocs archive site...