Licensing in BlackBerry Enterprise Service 10 version 10.1

Article ID: KB34359

Type: Support Content

Last Modified: 09-06-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Service 10
CollapseEnvironment
  • BlackBerry Enterprise Service 10 version 10.1
  • BlackBerry Management Studio
CollapseOverview

Architecture

In BlackBerry Enterprise Service 10 version 10.1, a new way of managing Licenses (formerly known as CALs) has been introduced. A service named BlackBerry Licensing Service is installed local to the BlackBerry Administration Service. The Licensing Service is designed to communicate with the BlackBerry Licensing Infrastructure located in the BlackBerry Infrastructure. Communication passes through Port 443 to license.blackberry.com (68.171.242.252) which requires firewall access settings to be set to outbound initiated and bi-directional. The BlackBerry Administration Console handles the connection to license.blackberry.com on behalf of the BlackBerry Licensing Service.

Licenses are managed from one centralized location called the BlackBerry Account Center. The BlackBerry Account Center communicates directly to the BlackBerry Licensing Infrastructure which allows licenses to be propagated down to the associated BlackBerry Enterprise Service 10 server(s).

Only one Licensing Service can be active within the BlackBerry domain. When multiple Licensing Services are present in one BlackBerry domain, conflicts could arise when resolving to the Licensing Infrastructure. The Licensing Service is registered with the BlackBerry Licensing Infrastructure with the Device ID (The Network Interface Card MAC Address). In a case where there are multiple BlackBerry Domains, licenses can be implicitly delegated across multiple servers using the Host ID activation method.


Requirements

In order to activate new devices on BlackBerry Enterprise Service 10 version 10.1, the following requirements must be met:

  • The BlackBerry Licensing Service must be started.
  • The BlackBerry Licensing Service must have established communication with the BlackBerry Licensing Infrastructure (If 443 is not an available option, a file-based activation can be performed).
  • Port requirements - BlackBerry Enterprise Service 10 version 10.1 requires communication to the Licensing Infrastructure via Port 443 to license.blackberry.com. For more information regarding firewall requirements, see KB34193.
  • Active BlackBerry Enterprise Service 10 version 10.1 Licenses - If CALs have no been upgraded from BlackBerry Enterprise Server 5.0 or BlackBerry Enterprise Service 10 version 10.0, the BlackBerry Enterprise Service License Trade Up tool must be used. 
  • BlackBerry Account Center credentials - To log in or register a new account, navigate to the BlackBerry Account Center.
  • BlackBerry 10 Data Plan for BlackBerry 10 smartphones, Advanced BlackBerry Data Plan or Add-On for Corporate-liable Activations, and Standard Smartphone Data Plan for iOS/Android smartphones.
  • In order to activate new devices on BlackBerry Enterprise Service 10 version 10.1, the server must be in compliance. For more information regarding compliance, refer to the BlackBerry Licensing Guide.

Activating Licenses in BlackBerry Enterprise Service 10 version 10.1

Three methods are available when activating Licenses in BlackBerry Enterprise Service 10 version 10.1:

Method 1: Activation ID

Similar to BlackBerry Enterprise Server 5.0, this method involves adding an Activation ID in BlackBerry Management Studio. To perform this activation method, complete the following:

  1. Obtain the Activation ID from the BlackBerry Account Center.
  2. Log in to BlackBerry Management Studio.
  3. Click on the Licenses tab.
  4. Click Activate Licenses.
  5. Select the License Activation ID method and enter the Activation ID.
  6. Click Activate, and upon successful activation the Licenses will be listed under License Information.

Note: For trial licenses, the Client Access License keys provided with the trial order serve as the Activation IDs.

Method 2: Host ID

The Licensing Service is registered with the BlackBerry Licensing Infrastructure with the Device/Host ID (The Network Interface Card MAC Address). In a case where there are multiple BlackBerry Domains, licenses can be implicitly delegated across multiple servers using the Host ID activation method. Using the Host ID, the Licensing Server can be registered for a domain with the BlackBerry Account Center and assign Licenses. To perform this activation method, complete the following:

  1. Log into BlackBerry Management Studio.
  2. Click on the Licenses tab.
  3. Click Activate Licenses.
  4. Select the Host ID activation method.
  5. Copy the Host ID (MAC Address).
  6. Log in to the BlackBerry Account Center.
  7. Click on the Licenses tab, and select Manage Devices.
  8. Under the Servers tab, select Register Server.
  9. Enter the Host ID in the Device ID field and select Submit.
  10. The Server will now be listed in the Servers tab and the Server can be selected by clicking on the Device ID.
  11. In the Edit Server window, scroll down and click Add Entitlement Line Item.
  12. Select the available Entitlement Line and specify the amount of Copies (Licenses).
  13. Click Save.

Method 3: File-Based Activation

In instances where the licensing server does not have access to the Internet to communicate with the Licensing infrastructure, a license challenge file and license response file can be used to activate licenses manually and to assign them to a BlackBerry Enterprise Service 10 domain. To perform this activation method, complete the following:

  1. Log into BlackBerry Management Studio.
  2. Click on the Licenses tab.
  3. Click Activate Licenses.
  4. Select the File Based Activation method.
  5. Click Generate to create a CapabilityRequest.bin file.
  6. Save the file locally to the computer in the desired location.
  7. Log into the BlackBerry Account Center.
  8. Click on the Licenses tab, and select Manage Devices.
  9. Under the Servers tab, select Generate License.
    Note: No Servers will be listed currently under Device ID if doing this for the first time, as no connection has been previously established.
  10. Click Choose File and select the CapabilityRequest.bin file generated in step 5.
  11. The Device ID will now be listed but it will show that no capabilities are added.
  12. Click Back to Device in the bottom right-hand corner.
  13. In the Edit Server window, scroll down and click Add Entitlement Line Item.
  14. Select the available Entitlement Line and specify the amount of Copies (Licenses).
  15. Click Save.
  16. Select Generate License again.
  17. When prompted with Do you have a request file?, select Yes.
  18. Click Choose File and select the CapabilityRequest.bin file generated in step 5.
  19. Click Submit.
  20. Scroll down and select Download.
  21. Save the Response.bin file locally to the computer in the desired location.
  22. Navigate to BlackBerry Management Studio and in the File-Based Activation window, click Choose File under Step 3.
  23. Choose the Response.bin file and click Submit.
  24. Entitlement/Licenses should now be added under the Licensing Summary tab.

Troubleshooting Licensing Issues in BlackBerry Enterprise Service 10 version 10.1

There are numerous tests that can be performed to test that functionality is working as intended in regards to Licensing in BlackBerry Enterprise Service 10.1:

To test the connection between BlackBerry Licensing Service and BlackBerry Licensing Infrastructure perform the following steps:

  1. Open BlackBerry Management Studio.
  2. Click the Licenses tab.
  3. Select Licensing Settings.
  4. Click Test connection (this tests connection between Administration Console and Licensing Service).
  5. Click Poll Now (this tests connection to license.blackberry.com via Port 443 and will propagate any licensing changes made in the BlackBerry Account Center).
  6. (Optional): If Telnet is installed on the BlackBerry Enterprise Service 10 server, a connection test can be run by using the following command: telnet license.blackberry.com 443

In the BlackBerry Account Center, check to see if the Activation ID being utilized is already active on another Host ID as per KB34334.

If the Licensing tab is grayed out, check to see that the credentials used to log into the BlackBerry Management Studio map to an account that is present in all BlackBerry Administration Consoles as per KB34332.

If connection to license.blackberry.com via Port 443 is successful, however the connection to the License Infrastructure fails in BlackBerry Management Studio, check to see if all required Certificates are installed as outlined in KB34316.

CollapseAdditional Information

If multiple Licensing Services are installed within one BlackBerry Domain, only one can remain active and proxy requests to the Licensing Infrastructure on behalf of the other servers. Another Licensing server can be switched to by following KB34147.

For information on how to transfer licenses from one Licensing Server to another, see KB34147.

For more information regarding the BlackBerry Licensing Service, refer to the BlackBerry Licensing Guide.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.