Administration Guide

Local Navigation

Using the BlackBerry Enterprise Trait Tool

The BlackBerry® Enterprise Trait Tool is a stand-alone command line tool that you can use to configure specific BlackBerry® Enterprise Server Express traits. You can configure most BlackBerry Enterprise Server Express settings using the BlackBerry Administration Service, but you must use the BlackBerry Enterprise Trait Tool to configure specific settings that are not available in the BlackBerry Administration Service.

The BlackBerry Enterprise Trait Tool file is located in the installation files for the BlackBerry Enterprise Server Express and is named TraitTool.exe. You must launch the TraitTool.exe file using a Windows® command prompt.

Use the BlackBerry Enterprise Trait Tool

  1. Copy the BlackBerry® Enterprise Server Express installation files to a computer that hosts a BlackBerry Enterprise Server Express instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:



    Display the current version of the trait tool and a summary of valid commands.

    Type traittool.

    Display all possible traits, the expected data types, and any value restrictions.

    Type traittool -show.

    Display a list of traits that were configured in the BlackBerry® Domain.

    Type traittool {*} -list.

    Configure the value of a trait in the BlackBerry Domain specified.

    Type traittool {*} -trait <trait name> -set <value>.

    Erase the value of a trait.

    Type traittool {*} -trait <trait name> -erase.

    Replace the braces and asterisk {*} with one or more of the following command line options:

    • -global to specify all BlackBerry Enterprise Server Express instances in the BlackBerry Domain
    • -agent <agent id> to specify the ID for the BlackBerry Messaging Agent
    • -group <groups_name> to specify a group of BlackBerry device users
    • -user <smtp_address> to specify one user
    • -server <server_name> to specify a BlackBerry Enterprise Server Express instance
    • -basserver <name> to specify the computer that hosts the BlackBerry Administration Service
  5. Press ENTER.
  6. Restart the BlackBerry Enterprise Server Express component that is associated with the trait that you configured.

Was this information helpful? Send us your comments.