How to import IT policy rule definitions for BlackBerry 7.1

Article ID: KB29510

Type: Support Content

Last Modified: 10-15-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
CollapseEnvironment
  • BlackBerry Enterprise Server 4.0 to 5.0
  • BlackBerry Smartphones
  • BlackBerry 7.1
CollapseOverview

The IT policy rule definitions for BlackBerry 7.1 contains the following IT Policies:

  • Disable FM Radio
  • Application Installation Methods
  • Application Installation from Specific URLs Only
  • SecureKey Browser Plug-in.
  • IETF WebSocket Connections in Browser
  • Override Hotspot APN Information
  • Battery Saving Mode
  • Application Resource Monitor
  • Media Server

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 ITPolicyPackHH710.zip file attachment and unzip it to a temporary folder on the local computer hosting the BlackBerry Administration Service.
  2. Open BlackBerry Administration Service web console.
  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 ITPolicyPackHH710.zip file was unzipped.
  7. Select the ITPolicyPackHH710.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 ITPolicyPackHH710.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 ITPolicyPackHH710.zip file was unzipped.
  8. Select the ITPolicyPackHH710.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 ITPolicyPackHH710.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 ITPolicyPackHH710.zip file.
  3. In the root of the temporary folder, type loadbesmetadata.exe -i ITPolicyPackHH710.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 ITPolicyPackHH710.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.

CollapseAdditional Information

Here are the details on the new Policies:

Common > Disable FM Radio:
Specify whether the FM radio on a BlackBerry device is turned off. If the FM radio is turned off, a BlackBerry device user cannot listen to FM radio stations on the device.
If you do not set this rule, a default value of No will be used.
This rule applies only to Java-based BlackBerry devices version 7.1 and higher.

Security > Application Installation Methods:
Specify which application installation options are available to the device user. Each application installation option provides a unique method for the device user to install applications onto the device.
This IT policy rule takes priority over the Disallow Third Party Application Downloads IT policy rule. In other words, if both IT policy rules exist, this IT policy rule prevails.
This policy rule does not affect applications already on the device.
If you do not set this rule, a default value of "" will be used.
This rule applies only to Java-based BlackBerry devices version 7.1 and higher.

Security > Application Installation from Specific URLs Only:
Specify a list of web addresses that a BlackBerry device user can download applications from. Separate multiple web addresses with a comma (,). Each address must be a fully qualified domain name or a wild-card domain name that starts with a period (.).
A BlackBerry device uses this IT policy rule only if you allow the browser in the Application Installation Methods IT policy rule.
If you specify a web address in this IT policy rule, the browser uses the BlackBerry MDS Connection Service to connect to the web address even if the web address is not listed in the MDS Browser Domains IT policy rule.
This rule applies only to Java-based BlackBerry devices version 7.1.0 and higher.

Browser > SecureKey Browser Plug-in:
Specify whether a BlackBerry device supports the SecureKey Browser Plug-in and allows access to HTTPS traffic through this API.
If you do not set this rule, a default value of "Allow (default)" will be used.
This rule applies only to Java-based BlackBerry devices version 7.1 and higher.

Browser > IETF WebSocket Connections in Browser:
Specify whether the Browser on a BlackBerry device allows IETF websocket connections.
If you do not set this rule, a default value of "Allow (default)" will be used.
This rule applies only to Java-based BlackBerry devices version 7.1 and higher.

Wi-Fi > Override Hotspot APN Information:
Specify the hotspot APN information that overrides the hotspot APN information set by the wireless service provider in the service record. Specify the APN information for this rule in a comma-separated list including APN, user name, and password.
This rule applies only to Java-based BlackBerry devices version 7.1 and higher.

On-device Diagnostics > Battery Saving Mode:
Specify whether a BlackBerry device user can use battery-save mode. To allow a user to use battery-save mode, set this rule to Allow. To prevent a user from using battery-save mode, set this rule to Disallow. When you set this rule to Disallow, battery-save mode is disabled on the BlackBerry device.
This rule applies only to Java-based BlackBerry devices version 7.1.05 and higher.

On-device Diagnostics > Application Resource Monitor
This rule specifies whether a BlackBerry device user can use the Application Resource Monitor.
If you set this rule to Allow, users can turn on the Application Resource Monitor. If you set this
rule to Disallow, the Application Resource Monitor is disabled on the BlackBerry device.

Media Server > Media Server:
Specify whether a BlackBerry device allows the wireless media server.
This rule applies only to Java-based BlackBerry devices version 7.1.05 and higher.

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.