Summary of the content on the page No. 1
BlackBerry Enterprise Server Resource Kit
BlackBerry Enterprise Server User Administration Tool
Version: 5.0
Administration Guide
Summary of the content on the page No. 2
SWD-504685-0330050601-001
Summary of the content on the page No. 3
Contents 1 Overview....................................................................................................................................................................................... 5 BlackBerry Enterprise Server User Administration Tool............................................................................................................. 5 Preconfigured administrative roles for the BlackBerry Enterprise Server...........................................................
Summary of the content on the page No. 4
List the folders that are available for email message forwarding............................................................................................. 23 Turn on or turn off email message forwarding for folders......................................................................................................... 24 4 Managing IT policies and IT policy rules.................................................................................................................................. 2
Summary of the content on the page No. 5
Check the status of the BlackBerry Enterprise Server User Administration Tool................................................................... 41 Configuring log files....................................................................................................................................................................... 41 11 Parameters for the BlackBerry Enterprise Server User Administration Tool..................................................................... 43 Using the co
Summary of the content on the page No. 6
30 -set_password.............................................................................................................................................................................. 81 31 -set_user_itpolicy_rule.............................................................................................................................................................. 82 32 -stats.............................................................................................................
Summary of the content on the page No. 7
Administration Guide Overview 1 Overview The BlackBerry® Enterprise Server Resource Kit is a collection of tools that can help you extend your ability to manage and monitor the BlackBerry® Enterprise Solution. You can download the BlackBerry Enterprise Server Resource Kit from www.blackberry.com/support/downloads. The BlackBerry Enterprise Server Resource Kit contains the following tool packages: • BlackBerry Enterprise Server User Administration Tool • BlackBerry Analysis, Monitoring, and Troub
Summary of the content on the page No. 8
Administration Guide Preconfigured administrative roles for the BlackBerry Enterprise Server Senior Junior Enterprise Server only User only Permission name Security role Helpdesk Helpdesk role role role role role Create a user * * * * Delete a user * * * * View a user (across Group) * * * * * Edit a user (across Group) * * * * View a device (across Group) * * * * * Edit a device (across Group) * * * * * View device activation * * * settings Edit device activation * * * settings Create an IT poli
Summary of the content on the page No. 9
Administration Guide Preconfigured administrative roles for the BlackBerry Enterprise Server Senior Junior Enterprise Server only User only Permission name Security role Helpdesk Helpdesk role role role role role View an application * * * * * Edit an application * * * Delete an application * * * Create an administrator user * * * Specify activation password * * * * * Turn off and on external * * * * services Clear activation password * * * * * Clear synchronization * * * * backup data Clear user
Summary of the content on the page No. 10
Administration Guide Preconfigured administrative roles for the BlackBerry Enterprise Server Senior Junior Enterprise Server only User only Permission name Security role Helpdesk Helpdesk role role role role role Edit a job * * * View default distribution * * * settings for a job Edit default distribution * * * settings for a job Update peer-to-peer * * * encryption key View job distribution settings * * * Edit job distribution settings * * * Delete an instance * * * Edit license keys * * * Lice
Summary of the content on the page No. 11
Administration Guide New in this release Senior Junior Enterprise Server only User only Permission name Security role Helpdesk Helpdesk role role role role role View a group across organizations Edit a group across organizations Add and remove a role across organizations View a device across organizations Edit a device across organizations Register an event notification Create an event notification Edit a BlackBerry Administration Service timer View BlackBerry Monitoring Service information Edit
Summary of the content on the page No. 12
Administration Guide New in this release Tool Description BlackBerry IT Policy Template To display the preconfigured IT policies that are available on a BlackBerry® Enterprise Reporting Tool Server, in the BlackBerry Enterprise Server User Administration Tool, you can run the following command: (ITPolicyTemplateReport.exe) besuseradminclient -list -it_policy_templates Parameter changes in the BlackBerry Enterprise Server User Administration Tool Parameter Description -change -u -cw
Summary of the content on the page No. 13
Administration Guide Parameter Description -stats -service -b and These subparameters display statistics for a BlackBerry Enterprise Server component or for a BlackBerry Messaging Agent instance. -stats -service -email They replace the following subparameters: • -stats -b • -stats -servers -v The variable allows you to specify the level of detail that is provided in log files by using one of the following options: • TRACE • DEBUG • WARNING • ERROR
Summary of the content on the page No. 14
Administration Guide Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool If your organization uses applications that work with previous versions of the BlackBerry® Enterprise Server User Administration Tool, in many cases, these applications also work with version 5.0 of the tool. Supported authenticati
Summary of the content on the page No. 15
Administration Guide Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool Syntax for authentication credentials In the BlackBerry® Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool, the variable represents the user name and password that you use for authentication with the BlackBerry Administration Service. The BlackBerry Enterprise Server User Administration Tool u
Summary of the content on the page No. 16
Administration Guide Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool Extracting credentials that are stored in the Windows registry The BlackBerry® Enterprise Server User Administration Tool uses the -p command to extract and decrypt credentials that are stored in the Windows® registry and then inserts the credentials into the command line options. Example BESUserAdminClient -p password1 -status This runs the
Summary of the content on the page No. 17
Administration Guide Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool version 4.1.x version 5.0 Run the following command: BESUserAdminClient -p Initial configuration (perform once): password1 -sqluser SQLU1 -sqlpass SQLP1... 1. Create a BlackBerry Administration Service administrator with the following credentials:
Summary of the content on the page No. 18
Administration Guide Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool Example: Changing the authentication credentials in the Windows registry to a Microsoft Active Directory user BlackBerry Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool version 4.1.x version 5.0 Not applicable Run the following command: BESUserAdminClient -set_client_auth "-username ADU1 -password ADP1 -a
Summary of the content on the page No. 19
Administration Guide Managing user accounts 2 Managing user accounts The BlackBerry® Enterprise Server uses predefined roles that correspond to common administrative roles in organizations to control who can perform specific tasks and to limit who can access sensitive data. The BlackBerry Enterprise Server User Administration Tool uses the BlackBerry Administration Service credentials that you type on the command line. Your current role is defined by the BlackBerry Administration Service. The -v
Summary of the content on the page No. 20
Administration Guide Adding user accounts Add a new user account to a group 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool > BlackBerry Enterprise Server User Administration Tool. 2. Type besuseradminclient -add and the following parameters: • -u • -b
