How to import IT policy rule definitions for value-added applications

Article ID: KB15535

Type: Support Content

Last Modified: 01-04-2012

 

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 SP1
CollapseOverview

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 Administration Service

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

  • BlackBerry Enterprise Server 5.0 and 5.0 SP1

Complete the following steps:

  1. Download the ATTValueAddedApplications-PolicyPack.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 ATTValueAddedApplications-PolicyPack.zip file was unzipped.
  7. Select the ITPolicyTemplate04242008.xml file.
  8. Click Save.
  9. When the import process is complete, the following message appears:

    The IT policy definitions have been updated.


Method 2 - Update the IT policy rule definition using the BlackBerry Manager

This procedure is appropriate for the following 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 ATTValueAddedApplications-PolicyPack.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 ATTValueAddedApplications-PolicyPack.zip file was unzipped.
  8. Select the ITPolicyTemplate04242008.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 3 - Update the IT policy rule definition using the loadbesmetadata.exe tool

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

  • BlackBerry Enterprise Server 4.0 and 4.1

Complete the following steps:

  1. Download and unzip the ATTValueAddedApplications-PolicyPack.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 ATTValueAddedApplications-PolicyPack.zip file.
  3. In the root of the temporary folder, type loadbesmetadata.exe -i itpolicytemplate04242008.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 itpolicytemplate04242008.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

Note: In some instances on BlackBerry Enterprise Server 4.1 SP6 to 4.1 SP7, custom IT policy rules may import into the User-defined items section of the IT Policy Template. If this occurs and a second custom IT policy is imported into the User-defined items, it may merge some of the rules with the previously imported policy. In order to work around this, the XML files for the two policies should be combined into one file and then imported using the steps in Method 2 of the Overview.

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.