• No results found

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.

Message Type Description

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.

Message Type Description

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 directory group and the Force Synchronization option was selected. Verify that the directory group exists. 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.

Message Type Description

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 the 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 the 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 directory user. Verify that the Windows account that you are using to run the tool has access to the directory domain and

Troubleshooting