Administration Guide

Local Navigation

Adding a user account to the BlackBerry Enterprise Server

If you add a user account to the BlackBerry® Enterprise Server, you are not required to locate the Microsoft® Exchange mailbox for the BlackBerry device that the user account is associated with or the routing group that the BlackBerry Enterprise Server is located in.

Add a user account

You can add a user account to the BlackBerry® Enterprise Server, 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.
  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 instances, select the BlackBerry Enterprise Server 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.

Back To Top

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 a 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 instances, select the BlackBerry Enterprise Server 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.
Back To Top

Export a list of user accounts

You can export a list of user accounts from a BlackBerry® Enterprise Server 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.
  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. Select the checkboxes beside the display names of the appropriate user accounts.
  5. In the Export users list, click Export selected users.
  6. Click Download file.
  7. Save the .csv file.
Back To Top

Importing a list of user accounts to a BlackBerry Enterprise Server

You can add multiple user accounts to a BlackBerry® Enterprise Server 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.

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.

Back To Top

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. 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 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 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 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 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"
Back To Top

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 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.
Back To Top

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. 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.
Back To Top

Was this information helpful? Send us your comments.