How to import and export an IT policy

Article ID: KB11988

Type: Support Content

Last Modified: 03-17-2014

 

Product(s) Affected:

  • BlackBerry Enterprise Server 5
CollapseEnvironment
  • BlackBerry Enterprise Server 4.0 SP5 to 4.0 SP6
  • BlackBerry Enterprise Server 4.1 SP5 to 4.1 SP7
  • BlackBerry Enterprise Server 5.0 to 5.0 SP4
  • BlackBerry Enterprise Server Resource Kit
CollapseOverview

Using the BlackBerry Administration Service

Exporting an IT policy

To export an IT policy from the BlackBerry Configuration Database using the BlackBerry Administration Service, complete the following steps:

  1. Log in to the BlackBerry Administration Service.
  2. In the BlackBerry solution management menu, expand Policy.
  3. Click Manage IT policies.
  4. Click Export IT policy list.
  5. Enter and confirm an encryption password.
  6. Click Export.
  7. Click Download file.
  8. Click Save.
  9. Type a file name and click Save.

    Note: This file includes all IT policies, Wi-Fi profiles, virtual private network (VPN) profiles and Voice over Internet Protocol (VoIP) profiles.

Importing an IT policy

To import an IT policy from the BlackBerry Configuration Database using the BlackBerry Administration Service, complete the following steps:

  1. Log in to the BlackBerry Administration Service.
  2. In the BlackBerry solution management menu, expand Policy.
  3. Click Manage IT policies.
  4. Click Import IT policy list.
  5. Click Browse and navigate to the location of the .itp file to import.
  6. Type the encryption password used to create the .itp file.
  7. Click Next.
  8. Click Add all IT policies.
  9. Click Save.
  10. Type a file name and click Save.

    Note: All IT policies, Wi-Fi profiles, VPN profiles, and VoIP profiles currently in use on the BlackBerry Enterprise Server will be overwritten.


Using the BlackBerry Enterprise Server Resource Kit

Exporting an IT policy

To export an IT policy from the BlackBerry Configuration Database using the BlackBerry Enterprise Server Resource Kit, complete the following steps:

  1. Download the BlackBerry Analysis, Monitoring, and Troubleshooting Tools from the BlackBerry Enterprise Server Resource Kit download page .
  2. Run the self-extracting .exe file and save the files to an accessible directory.
  3. Open a command prompt and access the directory that the files were extracted to.
  4. Access the ITPolicyImportExport directory.
  5. Type the following:

    • For BlackBerry Enterprise Server 4.0 SP5 to 4.1 SP5:
      ITPolicyImportExport -n <SQLSERVERNAME> -db <DBNAME> -type itp -export
    • For BlackBerry Enterprise Server 4.1 SP6 to 4.1 SP7:
      ITPolicyImportExport -n <SQLSERVERNAME> -db <DBNAME> -export

      where SQLSERVERNAME is the computer name or Internet Protocol (IP) address of the Microsoft SQL Server that is hosting the BlackBerry Configuration Database, and DBNAME is the name of the BlackBerry Configuration Database.

      Note : If the BlackBerry Configuration Database is on a named instance, the SQLSERVERNAME should be specified as computer name/instance name. For example, SQLSERVER\BLACKBERRY. If the SQL server uses a non-standard port, use SQLServer\Blackberry,1434.
    • For BlackBerry Enterprise Server 5.0 to 5.0 SP4:
      ITPolicyImportExport -export -file itpolicy.txt

      Note: The tool uses the BlackBerry Administration Service. For more information, see BlackBerry Enterprise Server Resource Kit - BlackBerry Analysis, Monitoring, and Troubleshooting Tools - Version: 5.0 .
  6. Specify a name for the export file.
  7. Type an encryption password for the export file.
  8. Type the IT policy identification number of the IT policy to export.

    Note: The generated export file extension is not required. However, the file extension .itp is most commonly used to reference IT policies.
     
  9. The output file generated can be found in the following location if no path is specified with the -file parameter:

    • Windows Server 2003: <drive>:\Documents and Settings\<logged in username>\Application Data\Research In Motion\AMT
    • Windows Server 2008: First, show hidden files and folders in Tools > Folder Options > View. Then browse to: <drive>:\Users\<logged in username>\AppData\Roaming\Research In Motion\AMT

Importing an IT policy

To import an IT policy to the BlackBerry Configuration Database, complete the following steps:

  1. Download the BlackBerry Analysis, Monitoring, and Troubleshooting Tools from the BlackBerry Enterprise Server Resource Kit download page .
  2. Run the self-extracting .exe file and save the files to an accessible directory.
  3. Open a command prompt and access the directory that the files were extracted to.
  4. Access the ITPolicyImportExport directory.
     

    Note: To access the IT Policy Import and Export Tool with BlackBerry Enterprise Server 5.0 SP1 to 5.0 SP4, on the computer that hosts the tool, click Start > All Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Analysis, Monitoring & Troubleshooting Tools > BlackBerry IT Policy Import and Export Tool. 
     
  5. Type the following:

    • For BlackBerry Enterprise Server 4.0 SP5 to 4.1 SP5:
      ITPolicyImportExport -n <SQLSERVERNAME> -db <DBNAME> -type itp -import
       
    • For BlackBerry Enterprise Server 4.1 SP6 to 4.1 SP7:
      ITPolicyImportExport -n <SQLSERVERNAME> -db <DBNAME> -import

      where SQLSERVERNAME is the computer name or IP address of the Microsoft SQL Server that is hosting the BlackBerry Configuration Database, and DBNAME is the name of the BlackBerry Configuration Database.

      Note : If the BlackBerry Configuration Database is on a named instance, the SQLSERVERNAME should be specified as computer name\instance name. For example, SQLSERVER\BLACKBERRY. If the SQL server uses a non-standard port use SQLServer\Blackberry,1434.
       

         
  6. Type the name of the file to import the IT policy from.
  7. Type the password.
  8. Type the IT policy identification number of the IT policy to import.

Note: After importing a new IT policy the policy may not be displayed in the BlackBerry Administration Service. If this happens, create a new IT policy which will update the list of IT policies allowing the new one to be displayed. The newly created IT policy can then be deleted.

CollapseAdditional Information

For more information on this tool, see BlackBerry Enterprise Server Resource Kit - BlackBerry Analysis, Monitoring, and Troubleshooting Tools documentation.

The tool can also be used to export the IT policy private and public key pair and the encryption key for a personal identification number (PIN).

When the BlackBerry IT Policy Import and Export Tool is used to export information from a BlackBerry Configuration Database, the tool connects to the specified BlackBerry Configuration Database, retrieves the required information, encrypts the information using the Triple Data Encryption Standard (Triple DES) encryption algorithm, and writes the information to an .itp file.

Note: When an IT policy is exported from BlackBerry Enterprise Server 4.1 and intended to be imported into BlackBerry Enterprise Server 5.0 SP2, ITPolicyImportExport tool that is included with the 5.0 SP2 BlackBerry Resource Kit must be used.

Use the BlackBerry IT Policy Import and Export Tool to list the contents of the exported IT Policy using the following format:

itpolicyimportexport -import -file itpolicyfile.itp -list

Note: If you want to use the BlackBerry IT Policy Import and Export Tool to list the contents of an IT policy file, you must specify the -db <database> and -n <database_address> parameters, even though this information should not be required.

Please see KB21512 for more information.

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.