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 [MDM DOMAIN]

User [USER] successfully created in [MDM DOMAIN]

INFO

The tool added an administrator account that is not device-enabled to the MDM domain.

Creating device enabled user [USER] found in directory group in [MDM DOMAIN]

User [USER] successfully created as device enabled in [MDM DOMAIN]

INFO

The tool added a device-enabled user account to the MDM domain.

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

User [USER] successfully deleted from [MDM DOMAIN]

INFO

The tool deleted a user account from the MDM domain.

Maximum number of users [MAX NUM] has been reached for BlackBerry group [MDM DOMAIN NAME\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 [MDM DOMAIN NAME]

WARNING

The tool did not find the user account in the MDM domain. Verify that the user account exists in the MDM domain.

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 [MDM DOMAIN NAME]

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 in the MDM domain as a device-enabled user account.

Delete the user account using the BlackBerry Administration Service 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 in the MDM domain as an administrator account that is not device-enabled.

Delete the user account using the BlackBerry Administration Service and try to add the user again as a device-enabled user account.

Skipping all provisioning mappings for [MDM DOMAIN NAME]. 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.

Skipping unidentifiable user [USER]

WARNING

The tool could not identify the user account in the MDM domain as a Microsoft Active Directory user. The tool does not manage user accounts that are not integrated with Microsoft Active Directory.

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 [MDM DOMAIN NAME\GROUP NAME]

ERROR

The tool did not find a group in the MDM domain, or an error occured when the tool tried to find the group.

Failed to retrieve all users from BlackBerry domain [MDM DOMAIN NAME]

ERROR

An error occurred when the tool tried to retrieve the list of all users from the MDM domain.

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 [MDM DOMAIN NAME\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 [MDM DOMAIN NAME\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 [MDM DOMAIN NAME]

ERROR

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

Failed to delete user [USER] from BlackBerry domain [MDM DOMAIN NAME]

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 MDM domains. Verify that the administrator account exists in and has the required role or permissions in each MDM domain.

Failed to initialize BlackBerry domain [MDM DOMAIN NAME]

ERROR

An error occurred when the tool tried to set up an MDM domain.

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 [MDM DOMAIN NAME 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 an MDM domain using the login information that you specified. Verify that the login information is correct and verify that the administrator account exists in the MDM domain.

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.