Blackbe;rry ENTERPRISE SERVER FOR NOVELL GROUPWISE Instruction Manual

Administration Guide
BlackBerry Enterprise Server for Novell GroupWise
Version: 4.1 | Service Pack: 6

SWD-494901-0820063906-001

Contents
1Creating administrator accounts..................................................................................................................................... 13
Administrative roles.................................................................................................................................................................... 13
Creating a BlackBerry Enterprise Server administrator in a Microsoft SQL Server environment................................... 14
Assign an administrative role to a new or existing Microsoft SQL Server database account..................................... 15
Configure the BlackBerry Manager to use database authentication in a Microsoft SQL Server environment............ 15
Specify the administration email address............................................................................................................................... 16
2 Setting up security options............................................................................................................................................... 17
How the BlackBerry Enterprise Solution encrypts data on the transport layer................................................................. 17
Standard encryption algorithms that the BlackBerry Enterprise Solution uses............................................................ 17
Change the encryption type.................................................................................................................................................. 17
Generating organization-specific encryption keys for PIN-to-PIN message encryption................................................ 18
Generate a new peer-to-peer encryption key.................................................................................................................... 18
Authenticating the BlackBerry MDS Integration Service to the BlackBerry Manager and web services...................... 18
Allow the BlackBerry MDS Integration Service to communicate with the BlackBerry Manager................................ 19
Allow client authentication between the BlackBerry MDS Integration Service and web services............................. 19
3 Setting up proxy servers for BlackBerry Enterprise Server components................................................................. 21
Configuring certain BlackBerry Enterprise Server components to use proxy servers...................................................... 21
Configure a BlackBerry Enterprise Server component to use a .pac file........................................................................ 21
Configure a BlackBerry Enterprise Server component to use a proxy server................................................................ 22
Configure a BlackBerry Enterprise Server component to authenticate to a proxy server on behalf of BlackBerry
devices....................................................................................................................................................................................... 22
4 Sharing BlackBerry Enterprise Server components..................................................................................................... 25
Configuring multiple BlackBerry Enterprise Server instances to use the same BlackBerry Enterprise Server
component.................................................................................................................................................................................... 25
Configure multiple BlackBerry Enterprise Server instances to use the same BlackBerry MDS Connection Service
.................................................................................................................................................................................................... 25
Configure multiple BlackBerry Enterprise Server instances to use the same BlackBerry MDS Integration Service
.................................................................................................................................................................................................... 26
Configure multiple BlackBerry Enterprise Server instances to use the same BlackBerry Collaboration Service
.................................................................................................................................................................................................... 26
5 Setting up user accounts................................................................................................................................................... 27

Adding user accounts to the BlackBerry Enterprise Server.................................................................................................. 27
Add user accounts to the BlackBerry Enterprise Server.................................................................................................... 27
Creating user groups................................................................................................................................................................... 27
Create a user group................................................................................................................................................................. 28
Add a user account to a user group...................................................................................................................................... 28
Synchronizing organizer data items with BlackBerry devices.............................................................................................. 28
Associate a user account with an address book................................................................................................................. 28
6 Sending software and Java applications to BlackBerry devices............................................................................... 31
Making BlackBerry Device Software and Java applications available to users................................................................. 31
Making software and applications available on a network drive......................................................................................... 31
Install the BlackBerry Device Software on a network drive.............................................................................................. 31
Add a Java application to a network drive........................................................................................................................... 32
Add a collaboration client to a network drive..................................................................................................................... 32
Add the BlackBerry MDS Runtime to a network drive....................................................................................................... 32
Indexing applications on a network drive................................................................................................................................ 33
Create or update a software index for applications on a network drive......................................................................... 33
Share a network drive for applications................................................................................................................................ 33
Defining software configurations............................................................................................................................................. 33
Create a software configuration........................................................................................................................................... 34
Define an application control policy.................................................................................................................................... 34
Assign an application control policy to an application..................................................................................................... 35
Assign a software configuration to a user group............................................................................................................... 35
Assign a software configuration to a user account............................................................................................................ 35
Send an application to a BlackBerry device over the wireless network.............................................................................. 36
Monitor wireless application push failures.............................................................................................................................. 36
Error messages: Wireless application push......................................................................................................................... 36
Install the BlackBerry Device Software or BlackBerry Applications on a BlackBerry device using the BlackBerry
Manager........................................................................................................................................................................................ 39
Installing the collaboration client on BlackBerry devices..................................................................................................... 39
7 Setting up the messaging environment......................................................................................................................... 41
Creating email message filters.................................................................................................................................................. 41
Create an email message filter that applies to all users................................................................................................... 41
Turn on an email message filter that applies to all user accounts.................................................................................. 42
Create an email message filter that applies to a user group............................................................................................ 42

Turn on an email message filter that applies to a user group.......................................................................................... 43
Create an email message filter that applies to a specific user account......................................................................... 43
Turn on an email message filter that applies to a specific user account........................................................................ 44
Enforcing secure messaging using classifications................................................................................................................. 45
Configure message classifications............................................................................................................................................ 45
Create a message classification............................................................................................................................................ 45
Create a message classification based on an existing classification.............................................................................. 46
Order message classifications.............................................................................................................................................. 46
Delete message classifications............................................................................................................................................. 47
Mapping address book fields for synchronization and address lookups............................................................................ 47
Map an address book field in the email application to an address book field on all BlackBerry devices................. 48
Map an address book field in the email application to an address book field on a specific BlackBerry device....... 48
Map address book fields that users defined to address book fields on all BlackBerry devices.................................. 48
Map address book fields that users defined to address book fields on a specific BlackBerry device........................ 49
8 Making BlackBerry MDS Runtime Applications available to users.......................................................................... 51
Creating BlackBerry MDS Runtime Applications and sending them to BlackBerry devices........................................... 51
Preparing BlackBerry devices to install BlackBerry MDS Runtime Applications.............................................................. 53
Configuring access to web services and managing signed and unsigned applications.................................................. 54
Allow BlackBerry MDS Runtime Applications to access web services using HTTPS.................................................... 54
Define a BlackBerry MDS Runtime Application as a trusted application...................................................................... 54
Configure whether users can install unsigned BlackBerry MDS Runtime Applications on BlackBerry devices...... 55
Configuring how users access and use BlackBerry MDS Runtime Applications............................................................... 55
Create a BlackBerry MDS Integration Service device policy............................................................................................ 55
Assign a BlackBerry MDS Integration Service device policy to a user group................................................................ 56
Assign a BlackBerry MDS Integration Service device policy to a specific user............................................................. 56
Sending BlackBerry MDS Runtime Applications to BlackBerry devices............................................................................. 56
Install a BlackBerry MDS Runtime Application on BlackBerry devices.......................................................................... 57
Install a BlackBerry MDS Runtime Application on a specific BlackBerry device.......................................................... 57
Applying an application control policy to a BlackBerry MDS Runtime Application......................................................... 58
Add the application launcher file for a BlackBerry MDS Runtime Application to the network drive........................ 58
Assign an application control policy to a BlackBerry MDS Runtime Application......................................................... 59
9 Configuring how users access enterprise applications and web content............................................................... 61
Specifying a BlackBerry MDS Connection Service as the central push server.................................................................. 61
Specify the central push server............................................................................................................................................. 61

Configuring how BlackBerry devices authenticate to content servers............................................................................... 61
Configure how BlackBerry devices authenticate to content servers.............................................................................. 62
Configure the BlackBerry MDS Connection Service to authenticate BlackBerry devices to content servers that
use NTLM.................................................................................................................................................................................. 62
Configure the BlackBerry MDS Connection Service to authenticate BlackBerry devices to content servers that
use Kerberos............................................................................................................................................................................. 63
Configure the BlackBerry MDS Connection Service to authenticate BlackBerry devices to content servers that
use LTPA.................................................................................................................................................................................... 63
Configure the BlackBerry MDS Connection Service to authenticate BlackBerry devices to the RSA Authentication
Manager.................................................................................................................................................................................... 63
Configuring how the BlackBerry MDS Connection Service manages requests for web content.................................... 64
Configure the BlackBerry MDS Connection Service to manage HTTP cookie storage................................................ 64
Configure the timeout limit for HTTP connections with BlackBerry devices................................................................. 64
Configure the timeout limit for HTTP connections to web servers.................................................................................. 65
Configure the maximum number of times that the BlackBerry Browser accepts HTTP redirections........................ 65
Allowing push applications to make trusted connections to the BlackBerry MDS Connection Service........................ 65
Create a key store to store certificates for use with HTTPS connections....................................................................... 66
Add a certificate for the BlackBerry MDS Connection Service........................................................................................ 66
Export the BlackBerry MDS Connection Service certificate to make it available to push applications.................... 67
Import the BlackBerry MDS Connection Service certificate to the key store of a push application.......................... 67
Configuring how applications open trusted connections to web servers........................................................................... 68
Allow BlackBerry devices to connect to untrusted web servers....................................................................................... 68
Configure the BlackBerry MDS Connection Service to retrieve certificates for web servers...................................... 68
Configure the BlackBerry MDS Connection Service to retrieve the status of certificates for web servers............... 69
Add retrieved certificates for web servers........................................................................................................................... 70
Configuring how the BlackBerry MDS Connection Service connects to BlackBerry devices.......................................... 70
SpecifythemaximumamountofdatathattheBlackBerryMDSConnectionServicecansendtoBlackBerrydevices
.................................................................................................................................................................................................... 70
Specify the pending content timeout limit for the BlackBerry MDS Connection Service........................................... 70
Allow Java applications to use persistent socket connections with the BlackBerry MDS Connection Service........ 71
Specify the thread pool size of the BlackBerry MDS Connection Service...................................................................... 71
Specify the maximum number of persistent socket connections.................................................................................... 71
Specify the port number that the web server listens on for push application requests............................................... 72
Specify how often the BlackBerry MDS Connection Service polls for configuration information............................. 72

10 Assigning BlackBerry devices to users........................................................................................................................... 73
Preparing to distribute BlackBerry devices............................................................................................................................. 73
Change how the BlackBerry Enterprise Server loads users’ existing messages onto BlackBerry devices................ 73
Prevent the BlackBerry Enterprise Server from loading legacy messages onto new BlackBerry devices................. 73
Assigning BlackBerry devices to user accounts...................................................................................................................... 74
Option 1: Activate a BlackBerry device using the BlackBerry Manager......................................................................... 74
Option 2: Activating BlackBerry devices over the wireless network............................................................................... 74
11 Managing administrator accounts.................................................................................................................................. 79
Assign a BlackBerry Enterprise Server administrator to a different administrative role................................................. 79
Delete an administrator account from a BlackBerry Enterprise Server.............................................................................. 79
12 Controlling the BlackBerry environment....................................................................................................................... 81
Controlling BlackBerry device access to the BlackBerry Enterprise Server....................................................................... 81
Turn on the Enterprise Service Policy.................................................................................................................................. 81
Permit a user to override the Enterprise Service Policy.................................................................................................... 82
Controlling BlackBerry device behavior using IT policies..................................................................................................... 82
Create an IT policy.................................................................................................................................................................. 82
Assign an IT policy to a group of users................................................................................................................................ 83
Assign an IT policy to a user account................................................................................................................................... 84
Enforcing IT policy changes over the wireless network.................................................................................................... 84
Deactivating BlackBerry devices without applied IT policies........................................................................................... 85
Changing the default behavior of BlackBerry devices and the BlackBerry Desktop Software................................... 85
Returning to the original default behavior of BlackBerry devices and the BlackBerry Desktop Software............... 86
Creating new IT policy rules to control third-party applications..................................................................................... 87
13 Managing user accounts................................................................................................................................................... 89
Managing user groups................................................................................................................................................................ 89
Change the properties of a user group................................................................................................................................ 89
Rename a user group.............................................................................................................................................................. 89
Delete a user group................................................................................................................................................................. 90
Managing user accounts............................................................................................................................................................ 90
Move a user account to a different user group................................................................................................................... 90
Move a user account out of a user group............................................................................................................................. 90
Move a user account from one BlackBerry Enterprise Server to another....................................................................... 91
Delete a user account from the BlackBerry Enterprise Server......................................................................................... 91

14 Protecting and reassigning BlackBerry devices........................................................................................................... 93
Protecting lost, stolen, or replaced BlackBerry devices......................................................................................................... 93
Protect a lost BlackBerry device........................................................................................................................................... 93
Protect a lost BlackBerry device that a user might recover.............................................................................................. 94
Protect a stolen BlackBerry device....................................................................................................................................... 94
Reissuing BlackBerry devices to new users............................................................................................................................. 94
Preparing a BlackBerry device for redistribution............................................................................................................... 95
15 Managing wireless applications...................................................................................................................................... 97
Managing applications on BlackBerry devices....................................................................................................................... 97
Upgrade an application on a BlackBerry device over the wireless network.................................................................. 97
Remove applications from BlackBerry devices over the wireless network..................................................................... 97
Change an application control policy.................................................................................................................................. 97
Managing software configurations........................................................................................................................................... 98
Delete a software configuration from a user account....................................................................................................... 98
Create a software configuration based on an existing software configuration............................................................ 98
16 Managing organizer data synchronization.................................................................................................................... 99
Turning off organizer data synchronization............................................................................................................................ 99
Turn off synchronization of organizer data for all user accounts.................................................................................... 99
Turn off synchronization of organizer data for a user group............................................................................................ 99
Turn off synchronization of organizer data for a specific user account.......................................................................... 99
Changing how organizer data synchronizes........................................................................................................................... 100
Change the direction of organizer data synchronization for all user accounts............................................................. 100
Change the direction of organizer data synchronization for a user group.................................................................... 100
Change the direction of organizer data synchronization for a specific user account.................................................. 101
Change how conflicts during organizer data synchronization are resolved for all user accounts............................. 101
Change how conflicts during organizer data synchronization are resolved for a user group..................................... 101
Change how conflicts during organizer data synchronization are resolved for a specific user account.................. 102
17 Managing your messaging environment and attachment support........................................................................... 103
Managing message forwarding................................................................................................................................................. 103
Forward messages to a BlackBerry device when no filter rules apply............................................................................ 103
Do not deliver messages to a BlackBerry device when no filter rules apply.................................................................. 103
Forward messages from inbox subfolders to a BlackBerry device................................................................................... 104

Turn off synchronization for messages sent from BlackBerry devices that belong to a user group.......................... 104
Turn off synchronization for messages sent from a BlackBerry device.......................................................................... 104
Turn off message forwarding to user accounts in a user group....................................................................................... 105
Turn off message forwarding to a user account................................................................................................................. 105
Managing wireless message reconciliation............................................................................................................................. 105
Turn off wireless message reconciliation............................................................................................................................ 106
Managing content in RTF and HTML-formatted messages.................................................................................................. 106
View settings for HTML-formatted messages..................................................................................................................... 106
Turn off rich content and inline images for groups of users............................................................................................. 106
Turn off rich content and inline images in messages for individual users..................................................................... 107
Managing access to remote message data............................................................................................................................. 107
Turn off the ability to check meeting invitee availability on the BlackBerry device..................................................... 107
Turn off the ability to search for remote email messages from the BlackBerry device................................................ 108
Managing message signatures and disclaimers..................................................................................................................... 108
Add a signature to all messages sent by members of a user group................................................................................ 108
Add a signature to all messages sent from a user’s BlackBerry device.......................................................................... 108
Add a disclaimer to all messages sent from BlackBerry devices..................................................................................... 109
Add a disclaimer to all messages sent by members of a user group............................................................................... 109
Add a disclaimer to all messages sent from a user’s BlackBerry device......................................................................... 109
Specify conflict rules for disclaimers.................................................................................................................................... 110
Turn off disclaimers................................................................................................................................................................. 110
Monitor messages that users send from their BlackBerry devices...................................................................................... 111
Managing the incoming message queue................................................................................................................................. 111
Delete messages for a specific user from the incoming message queue....................................................................... 111
Managing the wireless backup and recovery of organizer data.......................................................................................... 112
Turn off the wireless backup of organizer data for a user group..................................................................................... 112
Turn off the wireless backup of organizer data for a user account................................................................................. 112
Delete a user’s organizer data from the BlackBerry Enterprise Server........................................................................... 112
Sending notification messages to users.................................................................................................................................. 113
Send a notification message to all users in the BlackBerry Domain............................................................................... 113
Send a notification message to all users on a BlackBerry Enterprise Server................................................................. 113
Send a notification message to the members of a user group......................................................................................... 113
Send a notification message to a specific user................................................................................................................... 113
Managing instant messaging.................................................................................................................................................... 114
Change the instant messaging server that the BlackBerry Collaboration Service connects to................................. 114

Changing the transport protocol that the BlackBerry Collaboration Service uses to connect to the instant
messaging server..................................................................................................................................................................... 114
Specify the Microsoft Windows domain name for users who log in to the collaboration client................................. 116
Managing instant messaging sessions.................................................................................................................................... 116
Specify the maximum number of instant messaging sessions that can be open at the same time........................... 116
Specify the idle timeout limit for instant messaging sessions......................................................................................... 116
Specify the inactivity timeout limit for instant messaging sessions............................................................................... 117
Managing instant messaging features..................................................................................................................................... 117
Prevent users from sending specific file types to instant messaging contacts using the BlackBerry Client for IBM
Lotus Sametime....................................................................................................................................................................... 117
Specifying the maximum size of file types that users can send using the BlackBerry Client for IBM Lotus Sametime
.................................................................................................................................................................................................... 117
Prevent users from sending instant messaging conversations in email messages...................................................... 118
Prevent users from saving instant messaging conversations........................................................................................... 118
Manage the icon that appears on the BlackBerry device for mobile contacts.............................................................. 118
Make additional contact information and phone numbers available for the BlackBerry Client for IBM Lotus
Sametime users........................................................................................................................................................................ 119
Troubleshooting: Instant messaging........................................................................................................................................ 120
Users cannot view phone numbers for contacts in the BlackBerry Client for IBM Lotus Sametime.......................... 120
Optimizing how the BlackBerry Attachment Service converts attachments..................................................................... 121
Optimize how the BlackBerry Attachment Service converts attachments.................................................................... 122
BlackBerry Attachment Service optimization settings...................................................................................................... 122
Change the maximum file size for attachments that users can receive......................................................................... 123
Suggested file sizes for attachments................................................................................................................................... 123
Change the maximum dimensions for image attachments that users can view........................................................... 124
Optimizing how the BlackBerry Messaging Agent reconciles attachments to the messaging server........................... 124
Change the maximum file size of attachments that users can download...................................................................... 124
Turn off support for an attachment file format....................................................................................................................... 125
Add support for additional attachment file formats.............................................................................................................. 125
18 Managing BlackBerry MDS Runtime Applications....................................................................................................... 127
Upgrade a BlackBerry MDS Runtime Application on BlackBerry devices.......................................................................... 127
Remove a trusted certificate from the BlackBerry MDS Integration Service..................................................................... 128
Making installed BlackBerry MDS Runtime Applications unavailable on BlackBerry devices........................................ 128
Make an installed BlackBerry MDS Runtime Application unavailable on BlackBerry devices................................... 128

Make an installed BlackBerry MDS Runtime Application available on BlackBerry devices again............................. 128
Removing BlackBerry MDS Runtime Applications................................................................................................................. 129
Make a BlackBerry MDS Runtime Application unavailable for installation................................................................... 129
Remove an installed BlackBerry MDS Runtime Application from BlackBerry devices................................................. 129
Remove an installed BlackBerry MDS Runtime Application from a specific BlackBerry device................................. 130
Configuring a new connection between a BlackBerry MDS Integration Service and a BlackBerry MDS Connection
Service........................................................................................................................................................................................... 130
Make a BlackBerry MDS Connection Service available to a BlackBerry MDS Integration Service............................ 131
Make a BlackBerry MDS Connection Service unavailable to a BlackBerry MDS Integration Service....................... 131
19 Managing how users access enterprise applications and web content................................................................... 133
Restricting user access to content on web servers................................................................................................................ 133
Restrict requests for content on web servers from BlackBerry devices.......................................................................... 133
Specify web address patterns................................................................................................................................................ 133
Create a pull rule..................................................................................................................................................................... 134
Restrict or allow web address patterns using a pull rule.................................................................................................. 134
Assign a pull rule to a user group......................................................................................................................................... 135
Assign a pull rule to a specific user...................................................................................................................................... 135
Restricting user access to media content in the BlackBerry Browser................................................................................. 135
Prevent users from accessing specific media types........................................................................................................... 136
Configure a maximum file size for media types.................................................................................................................. 136
Restricting the push application content that users can receive........................................................................................ 136
Restrict push applications from sending data to BlackBerry devices............................................................................. 137
Create push initiators for push applications....................................................................................................................... 137
Turn on push authorization.................................................................................................................................................... 138
Create a push rule................................................................................................................................................................... 138
Assign push initiators to a push rule.................................................................................................................................... 139
Assign a push rule to a user group....................................................................................................................................... 139
Assign a push rule to a specific user.................................................................................................................................... 139
Encrypt push requests that push applications send to BlackBerry devices................................................................... 140
Associate a push initiator with the BlackBerry MDS Integration Service...................................................................... 140
Managing push application requests....................................................................................................................................... 141
Specify device ports for application-reliable push requests............................................................................................ 141
Store push application requests in the BlackBerry Configuration Database................................................................ 142
Configure the settings for storing push requests in the BlackBerry Configuration Database................................... 142

Configure the maximum number of active connections that the BlackBerry MDS Connection Service can process
.................................................................................................................................................................................................... 142
Configurethe maximum numberof queued connectionsthat the BlackBerryMDS Connection Servicecan process
.................................................................................................................................................................................................... 143
Delete requests from the push request queue manually.................................................................................................. 143
20 Monitoring a BlackBerry Domain.................................................................................................................................... 145
How the BlackBerry Controller monitors the BlackBerry Enterprise Server components............................................... 145
Changing how the BlackBerry Controller monitors the BlackBerry Enterprise Server components and restarts
services.......................................................................................................................................................................................... 145
Change how the BlackBerry Controller restarts the BlackBerry Messaging Agent...................................................... 145
Change how the BlackBerry Controller restarts the BlackBerry Enterprise Server services....................................... 148
Monitoring the BlackBerry MDS Integration Service notification messages..................................................................... 150
Set up monitoring of the BlackBerry MDS Integration Service notification messages for a BlackBerry device...... 150
Monitor the BlackBerry MDS Integration Service notification messages for a BlackBerry device............................ 151
Filter the BlackBerry MDS Integration Service notification messages by date and time............................................ 151
Block notification messages from a web services host...................................................................................................... 152
Remove all notification messages for the BlackBerry MDS Integration Service........................................................... 152
Monitoring PIN messages, SMS text messages, and calls.................................................................................................... 152
Change the default location for the PIN message, SMS text message, and phone log files....................................... 152
Monitor PIN messages........................................................................................................................................................... 153
Monitor SMS text messages.................................................................................................................................................. 153
Turn off call logging................................................................................................................................................................ 154
Log files for BlackBerry Enterprise Server components........................................................................................................ 154
Changing where BlackBerry Enterprise Server components write log files....................................................................... 155
Change the location where BlackBerry Enterprise Server components write log files................................................ 155
Store all of the BlackBerry Enterprise Server component log files in one folder.......................................................... 155
Changing how BlackBerry Enterprise Server components create log files........................................................................ 156
Add a prefix to the file names of all the BlackBerry Enterprise Server component log files....................................... 156
Configure the maximum size for a BlackBerry Enterprise Server component log file.................................................. 156
Change the logging level for a BlackBerry Enterprise Server component..................................................................... 157
Create a new BlackBerry Enterprise Server component log file when the current log file reaches the maximum
size............................................................................................................................................................................................. 157
Change the identifier for a BlackBerry Enterprise Server component log file.............................................................. 158
Prevent a BlackBerry Enterprise Server component from creating a daily log file....................................................... 158

Configure when to delete BlackBerry Enterprise Server component log files............................................................... 158
Changing how the BlackBerry MDS Connection Service creates a log file....................................................................... 159
Change the logging level for the BlackBerry MDS Connection Service......................................................................... 159
Change the location where the BlackBerry MDS Connection Service writes log files................................................. 159
Change the interval at which the BlackBerry MDS Connection Service writes information to the log file.............. 160
Change the logging level for the UDP log file.................................................................................................................... 160
Change the port number that the BlackBerry MDS Connection Service connects to when sending UDP log file
messages.................................................................................................................................................................................. 160
Change the logging level for the TCP log file..................................................................................................................... 161
Change the port number that the BlackBerry MDS Connection Service connects to when sending TCP log file
messages.................................................................................................................................................................................. 161
Change the logging level for the Event log file.................................................................................................................. 161
Change which BlackBerry MDS Connection Service activities are written to the log file............................................... 162
Change which BlackBerry Collaboration Service activities are written to the log file..................................................... 163
21 Managing a BlackBerry Domain...................................................................................................................................... 165
Managing multiple BlackBerry Domain instances................................................................................................................. 165
Connect the BlackBerry Manager to a different BlackBerry Domain............................................................................. 165
Managing CAL keys..................................................................................................................................................................... 165
Add or delete a CAL key......................................................................................................................................................... 165
Copy a license key to a text file............................................................................................................................................. 166
22 Glossary................................................................................................................................................................................ 167
23 Legal notice.......................................................................................................................................................................... 171

Creating administrator accounts 1
Administrative roles
The BlackBerry® Enterprise Server uses predefined roles, which correspond to common administrative roles in organizations,
to control who can perform specific tasks and limit who can access sensitive data in your organization.
YouassigneachBlackBerryEnterpriseServeradministrator toanadministrativerole.If youalreadymanageyourorganization
using Windows® groups, assign those groups to the administrative roles so that you can manage role membership through
the group.
When an administrator starts the BlackBerry Manager, the BlackBerry Manager checks the authentication credentials,
determines the administrative role, and displays a list of the tasks that the administrator can perform.
Role Description
security administrator (rim_db_admin_security) These administrators can perform all tasks. They are the
only administrators who can manage role membership and
change sensitive security properties, such as licenses and
encryption keys.
The administrator account that you created during the
installation process is assigned the security administrator
role automatically.
enterprise administrator (rim_db_admin_enterprise) These administrators can perform all tasks that relate to
user accounts, services, instances of the BlackBerry
Enterprise Server, and global application data.
These administrators cannot view role membership,
licenses, or encryption keys.
device administrator (rim_db_admin_handheld) These administrators can perform all tasks that relate to
user accounts and BlackBerry device management,
including:
• supporting new user accounts
• implementing BlackBerry devices
• managing software configurations
Administration Guide Creating administrator accounts
13

Role Description
•managing the installation and behavior of third-party
applications on BlackBerry devices
senior help desk administrator
(rim_db_admin_sr_helpdesk)
These administrators can perform all tasks that relate to
user account management, including:
• adding, moving, and deleting user accounts
•updating and sending IT policies to BlackBerry devices
• sending IT administration commands to BlackBerry
devices
junior help desk administrator
(rim_db_admin_jr_helpdesk)
These administrators can perform tasks that relate to user
account management, including:
• creating and sending passwords for activating
BlackBerry devices over the wireless network
• resending service books or IT policies
These administrators cannot add, move, or delete user
accounts or send certain IT administration commands.
auditor (rim_db_admin_audit_<role>)These administrators can view all tasks and properties that
relate to the role, but they cannot perform the tasks or
change the properties. Use this view-only role when
training new administrators.
Creating a BlackBerry Enterprise Server administrator in a Microsoft SQL Server
environment
BlackBerry® Enterprise Server administrators are database users who can access the BlackBerry Configuration Database
using the BlackBerry Manager. This access is restricted to the administrative roles that the BlackBerry Enterprise Server
administrators are assigned to.
Only administrators who are assigned to the security administrator role can create other BlackBerry Enterprise Server
administrators accounts. When creating administrator accounts, perform one of the following tasks:
• assign an administrative role to an existing database account
• create a new database account and assign it an administrative role
Administration Guide Creating a BlackBerry Enterprise Server administrator in a Microsoft SQL Server environment
14

Assign an administrative role to a new or existing Microsoft SQL Server database account
Note: Donotassign an administrative role using theMicrosoft®SQLServer®consolesorassignmore than one administrative
role to an administrator. The BlackBerry® Configuration Database uses the most restrictive settings to determine which
tasks the BlackBerry Manager displays, so an administrator who is assigned both enterprise and junior help desk roles sees
only the tasks for the junior help desk role.
Before you begin:
• Verify that you have the system administrator role on the database server.
• If you are creating a new database account and want to use Windows® authentication, verify that the Windows user
account or group already exists.
1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.
2. On the Role Administration tab, click a role.
3. Complete one of the following actions:
• To add an administrative role to an existing Microsoft SQL Server database account, click List Administrators.
• To create a new Microsoft SQL Server database account and assign it to an administrative role, click Add
Administrators.
4. Complete one of the following actions:
•To add an administrative role to an existing administrator account, click the administrator account that you want to
add the role to.
• To create a database account only and add an administrative role to the account, type a user name.
• To create a database account for an existing Windows user account or group and add an administrative role to the
account, type a user name preceded by a domain name (for example, DOMAIN\username).
5. If prompted, type and confirm a password.
6. Click OK.
Configure the BlackBerry Manager to use database authentication in a Microsoft
SQL Server environment
During the installation process, if you choose to connect to the BlackBerry® Configuration Database using Windows®
authentication, the BlackBerry Manager uses Windows authentication automatically. If you create database accounts for
your administrators, you must change the type of authentication that the BlackBerry Manager uses.
1. In the BlackBerry Manager, on the Tools menu, click Options.
2. Click Database.
3. In the Authentication drop-down list, click Database Authentication.
4. Click OK.
5. Restart the BlackBerry Manager.
Administration Guide Configure the BlackBerry Manager to use database authentication in a Microsoft SQL Server environment
15

Specify the administration email address
Specify the address that the BlackBerry® Manager sends system messages or enterprise activation passwords from.
1. Create an email account on your messaging server.
2. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.
3. On the Global tab, click Edit Properties.
4. In the Administration section, double-click Email Sender Address.
5. Type the email address that you want the BlackBerry Manager to send messages from.
6. Click OK.
Administration Guide Specify the administration email address
16

Setting up security options 2
How the BlackBerry Enterprise Solution encrypts data on the transport layer
The BlackBerry® Enterprise Solution uses a symmetric key encryption algorithm (Triple DES or AES) to protect all data that
the BlackBerry® Enterprise Server and a BlackBerry device send between them.
The BlackBerry Enterprise Solution uses the symmetric key encryption algorithm to create message keys and master
encryption keys, and uses those encryption keys to encrypt all data that the BlackBerry device sends or receives, while the
data travels between the BlackBerry device and the BlackBerry Enterprise Server.
Thisdataencryptionprocessoccursautomaticallyandisdesigned to verify that a message that a user sends froma BlackBerry
device, which is outside the organization's firewall, remains protected on the transport layer until the BlackBerry Enterprise
Server receives the message.
Standard encryption algorithms that the BlackBerry Enterprise Solution uses
Encryption type Description
AES •uses the AES algorithm to encrypt and decrypt all data that the BlackBerry
Enterprise Server and all BlackBerry devices on the BlackBerry Enterprise
Server send between them
•designed to use a longer encryption key to provide a better combination of
security and performance than Triple DES
•designed to protect user data and encryption keys from traditional attacks
and side-channel attacks
•requiresBlackBerry®DesktopSoftware version4.0orlaterandBlackBerry®
Device Software version 4.0 or later
Change the encryption type
1. In the BlackBerry® Manager, in the left pane, click a BlackBerry® Enterprise Server.
2. On the Server Configuration tab, click Edit Properties.
3. Click General.
4. In the Security section, click Encryption Algorithm.
5. In the drop-down list, select an encryption type.
Administration Guide Setting up security options
17

6. Click OK.
Related topics
Assigning BlackBerry devices to user accounts, 74
Generating organization-specific encryption keys for PIN-to-PIN message
encryption
By default, all BlackBerry® devices store a common peer-to-peer encryption key for protecting PIN-to-PIN messages. To
limit the number of BlackBerry devices that can decrypt PIN messages that users in your organization send from their
BlackBerry devices, you can generate a new peer-to-peer encryption key that is stored on and known only to BlackBerry
devices in your organization. BlackBerry devices with an organization-specific peer-to-peer encryption key can send and
receive PIN messages only with other BlackBerry devices that store the same peer-to-peer encryption key.
You should generate a new peer-to-peer encryption key if you know that your current organization-specific peer-to-peer
encryption key is compromised.
Generate a new peer-to-peer encryption key
1. In the BlackBerry® Manager, in the left pane, click BlackBerry Domain.
2. On the Global tab, expand Service Control & Customization.
3. Click Update Peer-to-Peer Encryption Key.
4. Click Set or update the Peer-to-Peer encryption key for all devices within this organization.
5. Click Yes.
Authenticating the BlackBerry MDS Integration Service to the BlackBerry Manager
and web services
After you install the BlackBerry® MDS Integration Service, you must install a digital certificate for the BlackBerry MDS
Integration Service in the key store on the same computer. This certificate allows server-authenticated communication
between the BlackBerry MDS Integration Service and the BlackBerry Manager.
You can install a self-signed certificate for the BlackBerry MDS Integration Service, or you can get a signed root certificate
from a certificate authority and install it in the key store using the Java® keytool. You can replace the self-signed certificate
with a signed root certificate at any time, but you should install the certificate that you want to use immediately after you
install the BlackBerry MDS Integration Service and before you allow authentication with the BlackBerry Manager or web
services using that certificate.
You can also export the certificate for the BlackBerry MDS Integration Service to allow client authentication with external
web services.
Administration Guide Generating organization-specific encryption keys for PIN-to-PIN message encryption
18