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 traits. You can configure most BlackBerry Enterprise Server 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 and is named TraitTool.exe. You must launch the TraitTool.exe file using a Windows® command prompt.
Use the BlackBerry Enterprise Trait Tool
- Copy the BlackBerry® Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
- Extract the contents to a folder on the computer.
- At the command prompt, navigate to <extracted_folder>\tools.
- Perform one of the following actions:
Task
|
Steps
|
|---|
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 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
- -host <host_name> to specify a pair of high availability BlackBerry Enterprise Server instances
- -user <smtp_address> to specify one user
- -server <server_name> to specify a BlackBerry Enterprise Server instance
- -basserver <name> to specify the computer that hosts the BlackBerry Administration Service
- Press ENTER.
- Restart the BlackBerry Enterprise Server component that is associated with the trait that you configured.
Was this information helpful? Send us your comments.
