How to import IT policy rule definitions for the BlackBerry PlayBook

Article ID: KB26294

Type: Support Content

Last Modified: 06-13-2012

 

Product(s) Affected:

  • BlackBerry PlayBook tablets
  • BlackBerry Enterprise Server 5
CollapseEnvironment
  • BlackBerry® Enterprise Server 4.0 and 5.0
CollapseOverview

The attached file contains several new IT Policies to support the BlackBerry® PlayBook™ tablet. Descriptions of these policies are below:

BlackBerry Bridge > Enable BlackBerry Bridge

This policy can be found under the BlackBerry® Bridge category when configuring an IT Policy after the file below has been applied to the BlackBerry® Enterprise Server.

Description: Specify whether a BlackBerry® smartphone can run BlackBerry Bridge. If this rule is set to Yes, a user can run BlackBerry Bridge and use it to connect a companion device (for example, the BlackBerry PlayBook) to the BlackBerry smartphone. If this rule is set to No, a BlackBerry smartphone user cannot run BlackBerry Bridge and cannot use it to connect a companion device to the BlackBerry smartphone.  The default value for this rule is Yes.


Companion Devices > BlackBerry PlayBook Log Submission

This policy can be found under the Companion Devices category when configuring an IT Policy after the file below has been applied to the BlackBerry Enterprise Server.

Description: Specify whether a BlackBerry PlayBook can generate and send log files to the BlackBerry Technical Solution Center. The default value for this rule is Enable Logging. If this rule is set to Enable Logging, the tablet can generate and send log files to the BlackBerry Technical Solution Center. If this rule is set to Disable Logging, the tablet cannot generate and send log files to the BlackBerry Technical Solution Center.


The BlackBerry Enterprise Server does not require updates to support new IT policy rule definitions.

To import the IT policy rule definitions, complete the steps below for the appropriate version of the BlackBerry Enterprise Server.

Note: The following updates to the IT policy rule definitions may refer to features not available in earlier versions of the BlackBerry Enterprise Server.

Warning: Do not modify the IT policy rule definition update file. Importing a modified file might cause issues with the functioning of the BlackBerry Enterprise Server.

 

Method 1 - Update the IT policy rule definition using BlackBerry Manager or BlackBerry® Administration Service

BlackBerry Enterprise Server 5.0

  1. Download the ITPolicyPackPlayBook.zip file attachment and unzip it to a temporary folder on the local computer hosting the BlackBerry Manager.
  2. Open BlackBerry Administration Service.
  3. From the BlackBerry Solution Management panel, expand Policy.
  4. Click Manage IT Policy Rules.
  5. Click Import IT Policy Definitions.
  6. Browse to the temporary folder where the ITPolicyPackPlayBook.zip file was unzipped.
  7. Select the ITPolicyPackPlayBook.xml file.
  8. Click Save.
  9. When the import process is complete, the following message appears:

    The IT policy definitions have been updated.

 

BlackBerry Enterprise Server 4.1 SP2 to 4.1 SP7

Complete the following steps:

  1. Download and unzip the ITPolicyPackPlayBook.zip file to a temporary folder on the local computer hosting the BlackBerry Manager.
  2. Open BlackBerry Manager.
  3. Select BlackBerry Domain.
  4. Select the Global tab.
  5. From the Tasks list, select Service Control and Customization.
  6. Select Import IT Policy Definitions.
  7. In the File Open dialog box, navigate to the temporary folder where the ITPolicyPackPlayBook.zip file was unzipped.
  8. Select the ITPolicyPackPlayBook.xml file.
  9. Click Open to import the IT policy rules definitions.
  10. When the import process is complete, the following message appears:

    The import of this IT policy rule definitions file was successful. There were <the_number_of_additions> additions and <the_number_of_updates> updates.


Method 2 - Update the IT policy rule definition using the loadbesmetadata.exe tool

This procedure is appropriate for the BlackBerry Enterprise Server 4.0 and 4.1

  1. Download and unzip the ITPolicyPackPlayBook.zip file to a temporary folder on the local computer hosting the BlackBerry Enterprise Server or the BlackBerry Manager.
  2. From the command prompt, navigate to the temporary folder that contains the ITPolicyPackPlayBook.zip file.
  3. In the root of the temporary folder, type loadbesmetadata.exe -i ITPolicyPackPlayBook.xml.
  4. After executing the loadbesmetadata.exe tool, review the screen output and directory log for errors.

Note: For BlackBerry Enterprise Server 4.1 SP4 running in a Windows® environment with Japanese fonts, make sure that the IT policy rule definitions updates are imported in the Japanese language, by typing loadbesmetadata.exe -i ITPolicyPackPlayBook.xml -l jp_ja in the command prompt.

Note: The loadbesmetadata.exe tool can be executed from a computer other than the one on which the BlackBerry Enterprise Server is running.

Note: To determine how to specify BlackBerry Configuration Database information, run the loadbesmetadata.exe tool from the command prompt using no parameters. Review the usage help screen to determine the parameters required for specific installations.

CollapseAttachments

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.