Navigation

Overview

Accessing the License Site

Changing your Username / Password

Types of Accounts

Licensing Restrictions

Deployment Licenses

End Users

Walkthrough: Applying for a Deployment License

Overview of the Licensing System

Licensing the Runtime

Cancelling Licenses

Applying for a Deployment License

Resellers

Walkthrough 1: Assigning Licenses to End Users

Overview of the Licensing System

Assigning Licenses to End Users

The Zebra Enterprise Solutions Software licensing site is used to manage your licenses for the following software products:
- RhoElements, http://www.rhomobile.com/ versions 1.0 to 4.1 inclusive.
- PocketBrowser.
- SimulScan
- Enterprise Browser

Note that it is not currently possible to license both RhoElements and PocketBrowser on the same device.

Accessing the Licensing Site

To license your software you will first need to log in to the Software licensing site, http://softwarelicensing.zebra.com. You will have received an email when your account was created detailing your log-in instructions, please check your spam folder as it may have incorrectly be categorised as such. If you have forgotten your password there is a link to reset it, provided you know your username which will be the email address given when your account was created.

Once logged into the licensing site the header will appear similar to the below:


Example header shown on all pages of the Software licensing site

Information about your account is shown on the right side of the header, the username and company in this case are darryncampbell@lamp.com and PB Testing. The type of account is an End User account.

End users are presented with up to three 'tabs': "Orders", "Licenses" and potentially "Deployment Licenses". These are shown at the bottom of the header and explained further in the following sections.

You can search in the currently displayed 'tab' by entering your term in the search box, the filtered results will then be shown in the accordions.

Changing your Username and Password

Because the initially generated password is not very memorable the first thing you will want to do when logging into the site is to change your password. Clicking on the (edit) next to your username in the header will bring up the password change tab which defaults to an expanded 'Edit Username' accordion, use this field to change the username which you use to access the licensing site. Note that when changing your username you must choose a valid email address as this will also serve as the address to which all licensing site emails will be sent.


Username / Password change screen with 'Edit Username' accordion expanded

To change your password click on the 'Change Password' heading to expand the accordion and from there specify your new password.

Types of Accounts

There are two main types of accounts on the licensing site, Resellers and End Users. Reseller accounts are designed for companies selling Software licenses and provide the ability to transfer licenses to other (End User) accounts but do not allow licenses to be assigned to devices. End User accounts are designed for individuals or companies to manage their licenses and provide the ability to assign runtime licenses to their devices as well as cancel licenses and set up deployment licenses.

If you believe your account is not of the correct type then please contact the Zebra Support Desk at ems.support@zebra.com.

Licensing Restrictions

Different versions of software require different licenses and users are not automatically entitled to free upgrades. The table below shows which versions of the different products are compatible with which license types:

Product Name
SimulScan Versions
SimulScan 1.0Any version in the form 1.x
Product Name
Enterprise Browser Versions
Enterprise Browser 1.x Device LicenseAny version in the form 1.x
SimulScan Licenses / Versions Enterprise Browser Licenses / Versions

Product Name
PocketBrowser Versions
SPB 1.x.xAny version in the form 1.x
SPB 2.0 for Windows CE
SPB 2.0 for Windows Mobile
Any version in the form 2.0.x
MPB 2.1/2.2 for Windows CE
MPB 2.1/2.2 for Windows Mobile
Any version in the form 2.1.x;
2.2.0 or 2.2.1
MPB 2.22 for Windows CE & Windows MobileVersion 2.2.2
MPB 2.2 SW Maintenance UpgradeVersion 2.2.2
MPB 3.0 for Windows CE & Windows MobileAny version in the form 3.0.x
PocketBrowser Licenses / Versions


Tables showing which versions of software apply to which license types

Customers who have purchased a Software Support Contract may be entitled to free software upgrades depdnding on the terms of the agreement of that product's agreement. Please contact the Zebra Support Desk at ems.support@zebra.com if you wish to apply for an upgrade.

Previous versions of all software are available from the support portal (https://www.zebra.com/us/en/support-downloads.html).

For all products except SimulScan, you can determine the version of software you are running as it is shown on the splash screen when the software starts up on the device. If the software is currently unlicensed it will also appear on the nag screen which is displayed every 5 minutes.

Deployment Licenses

Sometimes known as corporate licenses or enterprise licenses a deployment license provides the user with a way of licensing your software on multiple devices using a single key. Rather than licensing each device in your infrastructure individually by keying in the UUID you can apply to receive a single registration key which can be applied to multiple devices by simply scanning a barcode or adding a registry setting.

Deployment licenses are a legal agreement entered into between Zebra and the end user, as such they can only be applied for by the end user and not their reseller. For more details on applying for a deployment license see 'End Users: Applying for a Deployment License'.

End users will automatically be given the option to apply for a deployment license when they have purchased more than 50 licenses but users still must purchase individual licenses for each terminal being licensed. A deployment agreement does not permit users to license more terminals than they have purchased licenses for.

End User Walkthrough: Applying for a Deployment License

This is a simplified diagram showing the steps for an end user to apply for a deployment license. For a more detailed description including screen shots from the licensing site then please see the 'End Users: Applying for a Deployment License' section.


Diagram showing stages for an End user to apply for a Deployment License (click it to enlarge)

End Users: Overview of the Licensing System

When an End User logs into the licensing system they are given up to three 'tabs' and the Orders tab is shown by default.

End Users: Orders Tab


The Orders tab as seen by an End User (click it to enlarge)

The orders tab presented to the End User has up to two accordion panes, "Existing Orders" and "Deployment License Applications".

Existing Orders. For the majority of users the orders tab will only show the 'Existing Orders' accordion. Existing Orders displays the transactions sold to the end user by their reseller and the order number will therefore most often start with a 'T'. If you look at the above example you will see the top entry is T536428 which was transferred in the 'Resellers: Assigning Licenses to End Users' section above. To see the licenses contained in each order then click 'View Order' in the same row as the order; this will also allow you to see how many of the licenses in the order have been allocated to devices.

Deployment License Applications. If you have over 50 licenses in your account you will also see the 'Deployment License Applications' accordion, which will be colored Red if you are entitled to a deployment license but have not yet applied for it. For more details on applying for a deployment license see the End Users: Applying for a Deployment License section below.

Note that the 'Deployment License Applications' accordion, if visible, will be the default accordion expanded when an end user logs in to the site and is also duplicated under the 'Licenses' Tab.

End Users: Licenses Tab


The Licenses tab as seen by an End User (click it to enlarge)

The Licenses tab presented to the End User has up to four accordion panes, "Assign a License", "Assigned Licenses", "License Cancellation Requests" and "Deployment License Applications"

Assign a License.

For most End Users this will be the most important feature of the licensing site.

This screen shows your pool of licenses available to license to devices. Each license type will show the number of free licenses available and to assign these to devices follow the instructions in the End Users: Licensing the Runtime section. If you have a deployment license for a particular license type you will be unable to assign additional licenses individually and therefore the 'Total Unallocated' column shows the number of devices you are legally entitled to register via the deployment license.

Assigned Licenses.


The expanded 'Assigned Licenses' Accordion (click it to enlarge)

The assigned licenses accordion shows the licenses you have assigned to individual devices, it will not show devices licensed assigned via deployment license. Each license shows the license ID as well as details you entered when assigning the license such as serial number and group information; the 'License ID' associated with each license is the easiest way of identifying licenses when contacting Zebra customer support.

Clicking 'View Licenses' to the right of any license will show the license key which may take the form of a barcode, downloadable file or registry key depending on which product the license is for, use this if you did not register the device when you initially assigned the license or wish to re-register the device after a complete wipe of permanent storage. You can also print or download the registry settings using the two icons on the far right of the table row.

Clicking 'Request Cancellation' will begin the license cancellation process, covered in more detail in the End Users: Cancelling Licenses section. Once you have cancelled a license you will no longer be able to view it but it will still be shown in the 'Assigned Licenses' table, as illustrated above. Even though it still shows in the table the cancelled license will have been returned to the user's pool of unused licenses.

Note that if you have a deployment agreement for a particular license type then assigned licenses of that type will not show in the 'Assigned Licenses' accordion even if they were previously licensed individually.

License Cancellation.

The license cancellation accordion pane shows the licenses which the End User has requested be cancelled. The process for cancelling licenses is explained in the End Users: Cancelling Licenses section.


The expanded 'Assigned Licenses' Accordion (click it to enlarge)

The table shows the progress of each cancellation request. When you initially make the request the status will be set to 'Awaiting Response' which means it is waiting for a representative from the Software Request Administration team processes your request, you can view the status of your request by clicking on the 'View Request' link.

Deployment License Applications.

If you have over 50 licenses in your account you will also see the 'Deployment License Applications' accordion, which will be colored Red if you are entitled to a deployment license but have not yet applied for it. For more details on applying for a deployment license see the End Users: Applying for a Deployment License section.

Note that the 'Deployment License Applications' accordion, if visible, is also duplicated under the 'Orders' Tab.

End Users: Deployment Licenses Tab


The Deployment Licenses tab as seen by an End User (click it to enlarge)

Once you have followed the steps described at End Users: Applying for a Deployment License and successfully obtained your deployment license you will see the 'Deployment Licenses' tab in the header which can be used to manage your deployment licenses.

Clicking 'View License' will bring up the deployment license key. The format of the key will depend on which product that key is for but could be a barcode, file or registry key. Files or registry keys can be downloaded from this dialog to be included in your device build or mass deployment procedure.

The quantity column shows the number of licenses you have purchased for a particular license type, under the terms of the deployment license agreement you can not license more than this number of devices without purchasing additional licenses. Clicking 'View Agreement' will bring up a dialog similar to that shown below:


Example of a Deployment License Agreement screen (click it to enlarge)

The deployment license agreement is a legal agreement between the end user and Zebra stating how many devices can be licensed, which versions of software can be licensed and the order numbers thereof.

Note the deployment license agreement image above does not correspond to the 'Deployment Licenses Tab' image directly above it, the latter is the result of applying for the deployment license described at End Users: Applying for a Deployment License.

End Users: Licensing the Runtime

Most End Users will only use the licensing site to license their devices individually, to do this go to the 'Licenses' tab and click 'Assign License' against the type and version of software you wish to assign (See End Users: Licenses Tab).


Assigning a License to a Device (click it to enlarge)

You will see a dialog box similar to the above. The exact information being asked for will vary from product to product, in the above screenshot the device UUID and serial number are being requested.

The rest of the license process will vary depending on which product is being licensed. Please see the documentation for the individual product for how to proceed:

Pocket Browser: Follow the process for Enterprise Browser, the two products are very similar in terms of device licensing.
RhoElements (1.0 to 4.1): http://docs.rhomobile.com/en/4.1.0/guide/licensing#device-licensing. Again the process is very similar to Enterprise Browser so see the EB docs for a more thorough explanation
Enterprise Browser: http://techdocs.zebra.com/enterprise-browser/1-5/guide/licensing/
SimulScan: https://developer.zebra.com/community/android/simulscan/demo-licenses-and-licensing

End Users: Cancelling Licenses

The most common reasons for cancelling a license are:

You have sent your device for repair and in doing so components have been replaced meaning the device's UUID has changed. The software no longer reports it is licensed on the device.

You made an error when licensing the device, for example you licensed the same device twice or you attempted to license the wrong version of your software.

License cancellations must be approved by a human and therefore will not be automatically and immediately processed online. Attempting to cancel licenses just to re-use the same license on a different device will not be approved.

To request a license be cancelled select the 'Licenses' tab and expand the 'Assigned Licenses' accordion.


Cancelling a License (click it to enlarge)

Locate the license you wish to cancel and select the 'Request Cancellation' link. You will be presented with the 'Cancel License Request' dialog shown above. From the drop down select the reason for cancellation and try to provide as much detail as possible, this will enable the request to be processed as quickly as possible.

The request administrator will either accept the cancellation request, in which case the license has been cancelled successfully or request more information from the end user; such as device serial numbers, duplicate license IDs or even just 'phone support'. You will receive an email when the status of the request is updated, if the status is 'License Cancelled' then no further action need be taken. Once cancelled although the license is still shown under the 'Assigned Licenses' accordion (with status 'License Cancelled') it has returned to your pool of unassigned licenses. If the status is 'Response Received' then more information is required of the End User, click on 'View Request' to supply additional information, this back and forth request / response will continue until the license has been cancelled.


Life cycle of a Cancellation Request, shown by clicking 'View Request' (click it to enlarge)

Provided the End User has given sufficient information about the cancellation request it is uncommon for cancellation to take more than a single request / response. The above screenshot shows the life cycle of an example cancellation request.

End Users: Applying for a Deployment License

When a user has 50 or more software licenses in their account they are entitled to apply for a deployment license (More). To apply for a deployment license expand the 'Deployment License Applications' accordion under either the 'Orders' or 'Licenses' tabs. If are entitled to a deployment license but have not yet applied for it then this accordion box will be colored red, if you are not entitled to a deployment license then the accordion will not be present.


Applying for a Deployment License Step 1 (click it to enlarge)

To begin the Deployment License application wizard click 'Apply online now' next to the type and version of software for which you wish to apply for a license.


Applying for a Deployment License Step 2 (click it to enlarge)

The deployment license is a legal agreement between the End user and Zebra and as such Zebra requires a physical address for the end user, if no such address is entered in the database then the wizard will complain at this stage. Please contact your reseller in the first instance or the Zebra Support Desk at ems.support@zebra.com to provide your company address if it is not already in the system.

Enter the requested information and press 'Next'. The email address should be the the same as that shown in the licensing site header, in the top right hand corner of the screen.


Applying for a Deployment License Step 3 (click it to enlarge)

Read and accept the deployment license agreement, you can view this agreement later from the 'Deployment Licenses' tab.

Once you accept the agreement you will be shown the 'View License' dialog, again this can be displayed later from the 'Deployment Licenses' tab. A deployment license can be applied to a device in exactly the same way a traditional license can but the deployment license will work on multiple devices, not just one device with a specific device ID.

Reseller Walkthrough 1: Assigning Licenses to End Users

This is a simplified diagram showing the steps for a reseller to assign a license to an end user. For a more detailed description including screen shots from the licensing site then please see the 'Resellers: Assigning Licenses to End Users' section.


Diagram showing stages of Reseller assigning a license to an End User (click it to enlarge)

Resellers: Overview of the Licensing System

When a Reseller logs into the licensing system they are given three 'tabs' and the Orders tab is shown by default

Resellers: Orders Tab


The Orders tab as seen by a Reseller (click it to enlarge)

The orders tab presented to the Reseller has three accordion panes, "Create New Transaction", "Existing Orders" and "Transactions".

Existing Orders is expanded by default and contains the orders sold to the reseller by Zebra. Each order will contain a number of licenses and can be identified by their Order Number (assigned by Zebra) and their Purchase Order number, to search for a specific order type into the search bar in the page header. After typing a search term the shown orders will reduce to those filtered by the search term, the number of filtered orders is given in brackets in the accordion header. Note that entering a search term will filter all three accordions, not just the currently expanded one.

Transactions, when expanded, shows a history of past transactions, which are licenses sold by the reseller to an end user. Transaction Order Numbers will always start with a 'T'. To resend the transaction to your end user you can click the envelope icon associated with the transaction. Clicking 'View Transaction' will show which products were included in the order.

Create New Transaction, is used to send licenses to end users. Resellers can only send licenses they have in their pool which is populated by receiving 'Existing Orders'. The process of sending licenses to end users is explained in more detail in the section, 'Resellers: Assigning Licenses to End Users

Resellers: Licenses Tab


The Licenses tab as seen by a Reseller (click it to enlarge)

The licenses tab presented to the Reseller has two accordion panes, "Assigned Licenses" and "License Cancellation Requests". In most cases both of these panes will be empty, containing no licenses. The only reason licenses will be present under this tab is if the current Reseller account existed on the old licensing site, before 2008. In the past it was possible for resellers to assign licenses to devices however under the current licensing site they must transfer their licenses to an end user account (by creating a transaction), as explained in the highlighted yellow text in the screenshot. The sole purpose of this page is to provide a historical record of license assignments for this reseller.

Resellers: Customers Tab


The Customers tab as seen by a Reseller (click it to enlarge)

The customers tab shows all the users to whom you, the reseller, have transferred licenses. From this screen you can edit any of the attributes associated with the customer accounts such as contact name, contact address etc. A customer account can have multiple users, essentially multiple log-ins to the single customer account enabling multiple users within an organization to manage the end user's licenses. The customer account is initially created as described below in 'Resellers: Assigning Licenses to End Users' which creates a single user for the account whose email address is the same as the customer account's email. To create additional users for a customer's account click on 'Create User' in the same row as the customer and enter the user's email address; an email will then be sent to the specified email address informing them of their username and password. Emails relating to the customer account such as Order Confirmations will be sent to all users of the account rather than just the customer email address.

No facilities are given to delete users or modify user details. Please contact the Zebra Support Desk at ems.support@zebra.com if you need additional assistance.

Resellers: Assigning Licenses to End Users

The most important function of the reseller account is the ability to transfer licenses to end users, this is achieved by selecting the Orders tab and expanding the 'Create New Transaction' Accordion. From here you need to enter the details of the customer who is to receive the order.


The Reseller's Create Transaction Screen (1) (click it to enlarge)

The first step is to enter the email address of the customer to receive the order, if this is an existing customer the Customer Email field will suggest existing accounts matching the input after a short delay, as shown above. Enter the email address and tab or click to move to the next field.


The Reseller's Create Transaction Screen (2) (click it to enlarge)

If the email address is recognized as an existing customer then the rest of the fields will be pre-populated by the existing data. You can take the opportunity here if needed to edit any of the existing data by clicking on 'Edit Customer Details' which will enable the text fields and click 'Finished Editing' when done.

If this is a new customer you will be required to fill in the customer details manually. It is recommended you fill in as much detail as possible, especially the address as this will be required later if the customer applies for a deployment license. At minimum you must complete the Customer Email, Customer Name and Country fields and you can complete the rest later via the 'Customers' tab.

"Purchase Order Number" can be used to assign your own order number to the transaction whilst the CC Email field can contain a comma separated list of additional email recipients of the order confirmation, separated by semi colons eg. a.n.other@zebra.com;recipient@zebra.com. Note that email confirmations are sent to all users under the customer account.

Once you have completed the details of the customer to receive the order you need to populate the order with licenses by clicking on the 'Add Order Items' button, shown below.


Adding Licenses to a Transaction (click it to enlarge)

The drop down list of products will only contain the types of licenses the reseller account has in its license pool, selecting a license type from the drop down will show the maximum number of licenses which can be assigned to this end user, this will be the number of licenses of this type in the pool. Enter the actual number of licenses to include in the transaction in the quantity box and click 'Add Item'. Repeat these steps to add more than one license type to the order. Press Confirm and an order confirmation email will be sent to the end user informing them they have received new licenses.

The above example has resulted in a single 'MPB 2.2 SW Maintenance Upgrade' license assigned to Order Number: T536428. We can add additional licenses to this order at a later date by expanding the 'Transactions' accordion, locating the transaction T536428 and pressing 'View Transaction'.


Adding Additional Licenses to a Transaction (click it to enlarge)

Items are added to the order in batches, when we first created the transaction the batch 1 licenses were attached. Using the above screen we can attach batch 2 licenses in exactly the same way. When you confirm the additional batch another email is sent to the end user informing them of their additional licenses.