How to import IT Policy rules for BlackBerry App World

Article ID: KB17809

Type: Support Content

Last Modified: 12-14-2011

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Novell GroupWise
  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
CollapseEnvironment
  • BlackBerry® Enterprise Server 4.0 to 5.0
  • BlackBerry App World™
CollapseOverview

The BlackBerry Enterprise Server does not require software version updates to support new IT policy rules definitions.

To import the IT policy rules definitions, complete the steps below for the method that is appropriate for the software version of the BlackBerry Enterprise Server.

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

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


Method 1 - Update the IT policy rules definition using the BlackBerry Manager

This procedure is appropriate for the following software versions of the BlackBerry Enterprise Server:

  • BlackBerry Enterprise Server 4.1 SP2 to 4.1 SP7

Complete the following steps:

  1. Download and unzip the ITPolicyPackAppWorld.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 and open the ITPolicyPackAppWorld.zip folder.
  8. Select the ITPolicyTemplateAppWorld.xml file.
  9. Click Open to import the IT policy rules definitions.

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 rules definition using the BlackBerry Administration Service

This procedure is appropriate for the following software versions of the BlackBerry Enterprise Server:

  • BlackBerry Enterprise Server 5.0

Complete the following steps:

  1. Download and unzip the ITPolicyPackAppWorld.zip file to a temporary folder on the local computer.
  2. Log in to the BlackBerry Administration Service.
  3. Under BlackBerry solution management, expand Policy.
  4. Select Manage IT policy rules.
  5. Select Import IT policy definitions.
  6. Enter the path to the ITPolicyTemplateAppWorld.xml file or browse to the location of the file.
  7. Click Save.

Method 3 - Update the IT policy rules definitions using the loadbesmetadata.exe tool

This procedure is appropriate for the following software versions of the BlackBerry Enterprise Server:

  • BlackBerry Enterprise Server 4.0 to 5.0

Complete the following steps:

  1. Download and unzip the ITPolicyPackAppWorld.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 ITPolicyPackAppWorld.zip file.
  3. In the root of the temporary folder, enter loadbesmetadata.exe -i itpolicytemplateappworld.xml.
  4. After executing the loadbesmetadata.exe tool, review the screen output and directory log for errors.

Note: The loadbesmetadata.exe tool can be executed from a computer other than 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

The new policy will be located under Security policy group > Disable BlackBerry App World within the IT Policy settings.

The default value is No.

Note: BlackBerry Enterprise Server 4.1 SP7 and 5.0 are currently only available for Microsoft® Exchange and IBM® Lotus® Domino®.

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.