Administration Guide

Local Navigation

Adding a user account to the BlackBerry Enterprise Server Express

When you add a user account to the BlackBerry® Enterprise Server Express, your organization's messaging environment must meet the following requirements to support user accounts that exist in different geographical locations in your organization's messaging environment:

User account location Messaging environment requirements

The user account is located on the IBM® Lotus® Domino® server.

The IBM Lotus Domino server must contain a replica of the primary IBM Lotus Domino Directory.

The user account is located on an IBM Lotus Domino administration server in a that is outside of the IBM Lotus Domino domain.

The primary IBM Lotus Domino Directory must establish cross-certification to access the foreign directory server. You must configure the BlackBerry Enterprise Server Express to access the primary IBM Lotus Domino Directory using the ACL.

The IBM Lotus Domino administration server must be a directory server.

If you use a central directory server in an IBM Lotus Domino R6 environment, the server that you add the user account from require a replica of the primary IBM Lotus Domino Directory.

Add a user account

You can add a user account to the BlackBerry® Enterprise Server Express, assign a BlackBerry device to a user account and activate the BlackBerry device. The user account must exist on your organization's messaging server.
Before you begin: If required, create a group of user accounts so that you can manage user accounts that are similar.

Before you activate a device on the BlackBerry® Enterprise Server Express, you can visit the BlackBerry Expert Support Center to use online tools to determine whether the device is associated with the BlackBerry® Internet Service. If you want to activate devices that are associated with the BlackBerry Internet Service over the wireless network, visit www.blackberry.com/go/serverdocs to see the Activating Devices That are Associated With the BlackBerry Internet Service Over the Wireless Network Technical Note.

  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand User.
  2. Click Create a user.
  3. Search for a user account.
  4. Select the check box beside the display name for the user account.
  5. Click Continue.
  6. If your organization's environment includes multiple BlackBerry Enterprise Server Express instances, select the BlackBerry Enterprise Server Express that you want to add the user account to.
  7. If groups exist in the Available groups list, click at least one group that you want to add the user account to.
  8. Click Add.
  9. To select an activation option, perform one of the following actions:

    Option

    Step

    Specify an activation password for the user account.

    1. Click Create a user with activation password.
    2. In the Set activation password, section, type and confirm an activation password. The password must not contain special characters. Some BlackBerry devices do not support special characters and do not unlock when a user types a password that contains special characters.
    3. In the Password expiration (hours) field, type the amount of time, in hours, that you want to elapse before the activation password expires.
    4. Click Create user.

    Generate an activation password for the user account automatically.

    Click Create a user with generated activation password.

    Activate the user account without using an activation password.

    Click Create a user without activation password.

Create a user account that is not in the contact list in the BlackBerry Configuration Database

You can create a user account for a user even if the BlackBerry® Mail Store Service did not yet synchronize the contact information for the user account to the BlackBerry Configuration Database. If the BlackBerry Mail Store Service did not synchronize the contact information and you create a user account, the BlackBerry Administration Service does not display the user account in the search results.
  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand User.
  2. Click Create user.
  3. Search for a user account.
  4. Click Add user from company directory.
  5. In the Email address field, type the email address, in SMTP format, of the user account that you want to add.
  6. Click Find user in company directory.
  7. Click Save user to available user list and Create BlackBerry Enabled User.
  8. If you installed multiple BlackBerry® Enterprise Server Express instances, select the BlackBerry Enterprise Server Express that you want to add the user account to.
  9. Click Continue.
  10. Type and confirm an activation password. The password must not contain special characters. Specific BlackBerry devices do not support special characters and do not unlock when a user types a password that contains special characters.
  11. In the Password expiration field, type the amount of time, in hours, that can elapse before the activation password expires.
  12. Click Create user.

Export a list of user accounts

You can export a list of user accounts from a BlackBerry® Enterprise Server Express to a .csv file. The .csv file contains information about the user accounts, such as the user ID, display name, PIN and email address. You can import the list of user accounts to another BlackBerry Enterprise Server Express.
  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand User.
  2. Click Manage users.
  3. Search for one or more user accounts.
  4. Click Manage multiple users.
  5. Select the appropriate user accounts.
  6. In the Export users list, click Export user.
  7. Click Download file.
  8. Save the .csv file.

Importing a list of user accounts to a BlackBerry Enterprise Server Express

You can add multiple user accounts to a BlackBerry® Enterprise Server Express by importing a .csv file that contains a list of user accounts and the required information to activate the user accounts on a BlackBerry Enterprise Server Express.

The .csv file can include the following information:

  • user accounts that you want to create
  • names of the groups you want to add the user accounts to
  • activation passwords and expiry times that you want to assign to the user accounts

The BlackBerry Administration Service processes actions in the order that they appear in the .csv file. If the BlackBerry Administration Service encounters an error that is specific to an action during the import process (for example, an action is incorrectly formatted in the .csv file), the BlackBerry Administration Service continues to process the remaining actions that are listed in the file and displays an error message for the action that the BlackBerry Administration Service could not process.

The import process can take a long time (more than 30 minutes) to complete if you add more than 2000 user accounts.

Fields in a .csv file that contain user account information

The BlackBerry® Administration Service uses a .csv file to add user account information to the BlackBerry® Enterprise Server Express. The following table lists the fields in the .csv file that might be populated when you import user account information.

Field

Description

Email Address

The field specifies the email address for the user account.

SRP ID

This field specifies the SRP ID for the BlackBerry Enterprise Server Express that you want to add the user account to.

Group Names

This field specifies the names of groups that you want to add the user account to.

Activation Password Operation

This field specifies whether an activation password is required to activate the user account and whether that password will be specified by the administrator or the BlackBerry Administration Service. The activation password value specified in this field can either be "specify", "none", or "generate" in lower case only. The activation password operation must be the same on each line in the .csv file.

If the field is set to "specify", the activation password and the expiry time (in hours) are optional fields in the .csv file. If the activation password and the expiry time values are not included in the .csv file, you will be prompted to specify these values the after uploading the .csv file. If you specify the activation password and the expiry time for the user accounts, the values must be provided on every line of the csv file.

If the field is set to "generate", the password is automatically generated by the BlackBerry Administration Service and the final two fields of each .csv line must be empty. The activation password will expire if the user does not activate the BlackBerry device on the BlackBerry Enterprise Server Express before the password timeout elapses. The default value is 48 hours.

If the field is set to "none", the user account will be created without an activation password and the final two fields of each .csv line must be empty.

To activate a BlackBerry device on the BlackBerry Enterprise Server Express over the wireless network, an activation password is required.

Activation Password

This field specifies the activation password for the user account if an activation password is required.

Activation Password Expiry

This field specifies the amount of time, in hours, that can elapse before the activation password expires if an activation password is required.

The activation password will expire if the user does not activate the BlackBerry device on the BlackBerry Enterprise Server Express before a default value of 48 hours elapses.

Example: Importing user accounts to a BlackBerry Enterprise Server

"Email Address","SRP ID","Group Names","Activation Password Operation","Activation Password","Activation Password Expiry"

"wbarichak@example.com","WBARICHAK0033","Admins","specify", "asdf","24"
"jbuac@example.com","JBUAC0011,"Admins","specify", "asdf","24"

Import multiple user accounts from a .csv file

You can import a list of user accounts from a .csv file to a BlackBerry® Enterprise Server Express so that you can manage the user accounts.
Before you begin: Create a .csv file.
  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand User.
  2. Click Manage users.
  3. Click Manage multiple users from an import list.
  4. In the Manage multiple users from an import list section, click Browse.
  5. Navigate to the .csv file that contains the user accounts that you want to import.
  6. Click Next.
  7. Perform the appropriate actions for the user accounts.

Create multiple user accounts by importing the user accounts from a .csv file

You can import a list of user accounts from a .csv file and add them to a BlackBerry® Enterprise Server Express. The user accounts must exist on your organizations messaging server.
Before you begin: Create the .csv file.
  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand User.
  2. Click Create a user.
  3. Click Import new users.
  4. In the Import users from a list section, click Browse.
  5. Navigate to the .csv file that contains the user accounts that you want to import.
  6. Click Continue.
  7. Perform the appropriate actions for the user accounts.

Was this information helpful? Send us your comments.