Interpreting the reports that the BlackBerry Directory Sync Tool creates

To view the reports that the tool creates, in the BlackBerry Directory Sync Tool, click View > Report. To view the log files that the tool creates, click File > Open Application Data Folder.

Message

Type

Description

Assigning user [USER] found in directory group to [GROUP NAME]

User [USER] successfully assigned to group [GROUP NAME]

INFO

The tool assigned a user account to a group.

Unassigning user [USER] not found in directory group from [GROUP NAME]

User [USER] successfully unassigned from group [GROUP NAME]

INFO

The tool removed a user account from a group.

Creating user [USER] found in directory group in [SERVICE]

User [USER] successfully created in [SERVICE]

INFO

The tool added an administrator account that is not device-enabled to the server instance.

Creating device enabled user [USER] found in directory group in [SERVICE]

User [USER] successfully created as device enabled in [SERVICE]

INFO

The tool added a device-enabled user account to the server instance.

Deleting user [USER] not found in directory group(s) from [SERVICE]

User [USER] successfully deleted from [SERVICE]

INFO

The tool deleted a user account from the server instance.

Maximum number of users [MAX NUM] has been reached for BlackBerry group [SERVICE\GROUP NAME]

INFO

The number of users in a group exceeded the maxiumum size configured in the DirectorySync.exe.config file (maxNumberOfUsersInBasGroup). The tool does not synchronize changes to groups that exceed this value. The default value is 2000.

Verify that the size of the group does not exceed the maximum size. If necessary, change the value of maxNumberOfUsersInBasGroup.

User [USER] not found in [SERVICE]

WARNING

The tool did not find the user account on the server instance. Verify that the user account exists on the server instance.

If you want to hide "User not found" warning messages in the report, in Edit > Preferences, select the "Suppress 'User not found' warnings when assigning users to groups" check box.

Multiple records found for user [USER] in [SERVICE]

WARNING

The tool found multiple user records when searching for a user account to assign to a group. The tool did not assign the user account to the group.

User [USER] already exists as device enabled

WARNING

The tool tried to provision a user as an administrator account that is not device-enabled, but the user already exists on the server instance as a device-enabled user account.

Delete the user account using the administration console and try to add the user again as an administrator account.

User [USER] already exists but is not device enabled

WARNING

The tool tried to provision a user as a device-enabled user account, but the user already exists on the server instance as an administrator account that is not device-enabled.

Delete the user account using the administration console and try to add the user again as a device-enabled user account.

Skipping all provisioning mappings for [SERVICE]. Provisioning option is disabled.

WARNING

Provisioning mappings were configured but the provisioning feature was disabled.

If you want to provision user accounts, enable the provisioning feature.

Directory group [LDAP PATH] cannot be found. Treating the missing group as empty.

WARNING

The tool could not find a group in Microsoft Active Directory and the Force Synchronization option was selected.

Verify that the group exists in Microsoft Active Directory.

Another copy of Directory Sync is already running. Multiple instances cannot be run!

ERROR

The tool did not run because another instance of the tool is already running. You cannot run multiple instances of the tool at the same time.

Failed to retrieve group members from [SERVICE\GROUP NAME]

ERROR

The tool did not find a group on the server instance, or an error occured when the tool tried to find the group.

Failed to retrieve all users from BlackBerry domain [SERVICE]

ERROR

An error occurred when the tool tried to retrieve the list of all users from the server instance.

Failed to get user details for DisplayName=[DISPLAY NAME], UID=[USER UID]

ERROR

An error occurred when the tool tried to retrieve more details for a user.

Failed to find user [USER]

ERROR

An error occurred when the tool searched for the user account to assign to a group.

Failed to assign user [USER] to group [SERVICE\GROUP NAME]

ERROR

An error occurred when the tool tried to assign the user account to a group.

Failed to unassign user [USER] from group [SERVICE\GROUP NAME]

ERROR

An error occurred when the tool tried to remove the user account from a group.

Failed to create user [USER] in BlackBerry domain [SERVICE]

ERROR

An error occurred when the tool tried to provision the user account.

Failed to delete user [USER] from BlackBerry domain [SERVICE]

ERROR

An error occurred when the tool tried to delete the user account.

Failed to authenticate to any BlackBerry domains

ERROR

The administrator account that you configured the tool to use is not authorized in any of the configured server instances. Verify that the administrator account exists in and has the required role or permissions on each server instance.

Failed to initialize BlackBerry domain [SERVICE]

ERROR

An error occurred when the tool tried to set up a server instance.

Failed to get directory group members

ERROR

An error occurred when the tool tried to retrieve group members from Microsoft Active Directory.

Too many changes detected for [SERVICE or GROUP NAME]. Total=[NUM OF CHANGES], Max=[MAX NUM OF CHANGES]

ERROR

The number of changes to synchronize to a group exceeded the maxiumum number configured in the DirectorySync.exe.config file (MaxNumberOfChanges). The tool counts the number of changes; if the number exceeds the value that you specified, the tool does not make any changes to the group. The default value is 0 (no limit).

If necessary, change the value of MaxNumberOfChanges.

The server is not operational

ERROR

The tool cannot access the domain that hosts Microsoft Active Directory.

Logon failure: unknown user name or bad password

ERROR

The tool cannot connect to a server instance using the login information that you specified. Verify that the login information is correct and verify that the administrator account exists on the server instance.

Exception retrieving group member [AD PATH]

ERROR

The tool cannot find a user account in Microsoft Active Directory. Verify that the Windows account that you are using to run the tool has access to the Microsoft Active Directory domain and has read permissions for Microsoft Active Directory.



Was this information helpful? Send us your comments.