Administration Guide

Local Navigation

Correcting calendar synchronization errors on devices

If you run corrective calendar synchronization on a BlackBerry® Enterprise Server instance, you can find and correct differences between the calendar entries on BlackBerry devices and the calendar entries on users' computers. You can specify a recurring day and time when the process can run and specific days when the process should check for calendar synchronization errors.

You configure corrective calendar synchronization using the BlackBerry Enterprise Trait Tool, which is located in the Tools folder of the BlackBerry Enterprise Server installation files.

If corrective calendar synchronization finds differences between the calendar entries on a device and the calendar entries on a computer, the process writes information about the differences to the BlackBerry Messaging Agent log file and, optionally, automatically corrects the calendar synchronization errors that it finds.

It is a best practice to schedule corrective calendar synchronization to occur during low-use periods. For example, you can schedule the process to begin in the early evening, before devices are scheduled to turn off automatically.

Configuration levels using the BlackBerry Enterprise Trait Tool

You can use the BlackBerry® Enterprise Trait Tool to specify whether corrective calendar synchronization checks calendar entries for a specific user, users on a specific BlackBerry® Enterprise Server, or all users. The tool uses a hierarchy to determine what calendar entries to check. Settings at the user level override settings at the server level, settings at the server level override settings at the global level, and settings at the global level override the default settings.

Level

Description

-global

The setting that you specify applies to all users.

-server <server_name>

The setting that you specify applies to all users on a specific BlackBerry Enterprise Server.

-user <smtp_address>

The setting that you specify applies to a specific user.

Back To Top

Turn off corrective calendar synchronization

By default, corrective calendar synchronization is turned on. If you do not want the BlackBerry® Enterprise Server to check for differences between calendar entries on BlackBerry® devices and calendar entries on users' computers, you can turn off corrective calendar synchronization.

  1. Copy the BlackBerry Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the folder that contains the TraitTool.exe file.
  4. Perform one of the following actions:
    • To turn off corrective calendar synchronization for a specific user account, type traittool -user <smtp_address> -trait ExchangeSmartSyncEnable -set false.
    • To turn off corrective calendar synchronization for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait ExchangeSmartSyncEnable -set false.
    • To turn off corrective calendar synchronization for all user accounts, type traittool -global -trait ExchangeSmartSyncEnable -set false.
  5. Press ENTER.

Example: Turning off the process for all users

 traittool -global -trait ExchangeSmartSyncEnable -set false
 traittool -user ian.dundas@blackberry.com -trait ExchangeSmartSyncEnable -set false
After you finish: To turn on corrective calendar synchronization process, type traittool -<level> -trait ExchangeSmartSyncEnable -set true, where <level> is the SMTP address of a specific user account, the server name of a specific BlackBerry Enterprise Server for all user accounts that are associated with the specific BlackBerry Enterprise Server, or global for all user accounts.
Back To Top

View the current settings for corrective calendar synchronization

  1. Copy the BlackBerry® Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
  4. Perform one of the following actions:
    • To view the calendar synchronization settings for a specific user account, type traittool -user <smtp_address> -list.
    • To view the calendar synchronization settings for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -list.
    • To view the calendar synchronization settings for all user accounts, type traittool -global -list.
  5. Press ENTER.

Example: Viewing the global calendar synchronization settings

 traittool -global -list
Back To Top

Turn off automatic error correction in corrective calendar synchronization

By default, corrective calendar synchronization process finds calendar synchronization errors, add the errors to the BlackBerry® Messaging Agent log file, and automatically corrects the errors. If you do not want corrective calendar synchronization to automatically correct calendar synchronization errors, you can turn off this function.
  1. Copy the BlackBerry® Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To turn off automatic correction of calendar synchronization errors for a specific user account, type traittool -user <smtp_address> -trait ExchangeSmartSyncSendUpdate -set false.
    • To turn off automatic correction of calendar synchronization errors for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait ExchangeSmartSyncSendUpdate -set false.
    • To turn off automatic correction of calendar synchronization errors for all user accounts, type traittool -global -trait ExchangeSmartSyncSendUpdate -set false.
  5. Press ENTER.

Example: Turn off automatic error correction for a specific user

 traittool -user ian.dundas@blackberry.com -trait ExchangeSmartSyncSendUpdate -set false
After you finish: To turn on calendar synchronization error correction, type traittool -<level> -trait ExchangeSmartSyncSendUpdate -set true, where <level> is the SMTP address of a specific user account, the server name of a specific BlackBerry Enterprise Server for all user accounts that are associated with the specific BlackBerry Enterprise Server, or global for all user accounts.
Back To Top

Configure the range of days to check for calendar synchronization errors

You can configure corrective calendar synchronization to check for calendar synchronization errors during a specific range of days in the calendar after the current date.
  1. Copy the BlackBerry® Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
  4. Perform one of the following actions:
    • To check for calendar synchronization errors during a specific range of days in the calendar for a user account, type traittool -user <smtp_address> -trait ExchangeSmartSyncDays -set <value>, where <value> is a number from 1 to 365.
    • To check for calendar synchronization errors during a specific range of days in the calendar for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait ExchangeSmartSyncDays -set <value>, where <value> is a number from 1 to 365.
    • To check for calendar synchronization errors during a specific range of days in the calendar for all user accounts, type traittool -global -trait ExchangeSmartSyncDays -set <value>, where <value> is a number from 1 to 365.
  5. Press ENTER.

Example: To configure corrective calendar synchronization to check calendar entries for the period of three days from the current date for all users, type:

 traittool -global -trait ExchangeSmartSyncDays -set 3
Back To Top

Configure when corrective calendar synchronization runs

You can configure corrective calendar synchronization to start running at a specific hour, on recurring days, or on only one recurring day. To specify more than one value for when corrective calendar synchronization runs, after you extract the BlackBerry® Enterprise Server installation files to the computer, you can create a list of values that are separated by commas (,) at the command prompt.

  1. Copy the BlackBerry Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
  4. Perform one of the following actions:
    • To configure calendar synchronization to occur at a specific hour for a specific user account, type traittool -user <smtp_address> -trait ExchangeSmartSyncTriggerHour -set <value>, where <value> is a number from 0 to 23, 0 is 12:00 AM, and 23 is 11:00 PM. The default value is 0, which is 12:00 AM.
    • To configure calendar synchronization to occur at a specific hour for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait ExchangeSmartSyncTriggerHour -set <value>, where <value> is a number from 0 to 23, 0 is 12:00 AM, and 23 is 11:00 PM. The default value is 0, which is 12:00 AM.
    • To configure calendar synchronization to occur at a specific hour for all user accounts, type traittool -global -trait ExchangeSmartSyncTriggerHour -set <value>, where <value> is a number from 0 to 23, 0 is 12:00 AM, and 23 is 11:00 PM. The default value is 0, which is 12:00 AM.
  5. Press ENTER.
  6. Perform one of the following actions:
    • To configure calendar synchronization to recur on specific days for all user accounts, type traittool -global -trait ExchangeSmartSyncSchedule -set <value>, where <value> is one or more of the following options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekdays, Weekends, or Daily. The default value is Daily.
    • To configure calendar synchronization to recur on specific days for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait ExchangeSmartSyncSchedule -set <value>, where <value> is one or more of the following options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekdays, Weekends, or Daily. The default value is Daily.
    • To configure calendar synchronization to recur on specific days for a user account, type traittool -user <smtp_address> -trait ExchangeSmartSyncSchedule -set <value>, where <value> is one or more of the following options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekdays, Weekends, or Daily. The default value is Daily.
  7. Press ENTER.

Example: Configuring corrective calendar synchronization to run at 10:00 PM for all users on the BlackBerry Enterprise Server that is named SERVER01

 traittool -server SERVER01 -trait ExchangeSmartSyncTriggerHour -set 22
 traittool -server SERVER02 -trait ExchangeSmartSyncTriggerHour -set 23
 traittool -global -trait ExchangeSmartSyncSchedule -set Weekdays
 traittool -user greg.stark@blackberry.com -trait ExchangeSmartSyncSchedule -set Monday,Wednesday,Friday
Back To Top

Logging information for corrective calendar synchronization

Corrective calendar synchronization writes the following information to the BlackBerry® Messaging Agent log file:

Item

Description

DIF

specifies that a calendar item is different on the BlackBerry device than it is in the email application

MOD

specifies that a calendar item is missing on the device

MOO

specifies that a calendar item is missing in the email application

SAM

specifies that a calendar item is the same on the device and in the email application

SmartSyncFireOff

specifies that the calendar synchronization process was initiated using the BlackBerry® Enterprise Trait Tool instead of the standard calendar synchronization process

Back To Top

Delete a setting for corrective calendar synchronization

If you delete a setting for corrective calendar synchronization, the calendar synchronization process uses the setting that you specified at the next highest level of the hierarchy. For example, if you delete a setting at the user level, the process uses the setting that is specified at the server level because the server level is the next highest level. If you do not specify any values, the default value is used.
  1. Copy the BlackBerry® Enterprise Server installation files to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
  4. Perform one of the following actions:
    • To delete a setting for a specific user account, type traittool -user <smtp_address> -trait <name> -erase, where <name> is the setting you want to delete.
    • To delete a setting for all user accounts that are associated with a BlackBerry Enterprise Server, type traittool -server <server_name> -trait <name> -erase, where <name> is the setting you want to delete.
    • To delete a setting for all user accounts, type traittool –global -trait <name> -erase, where <name> is the setting you want to delete.
  5. Press ENTER.

Example: To delete the setting for the hour that corrective calendar synchronization begins on the BlackBerry Enterprise Server that is named SERVER01, type:

 traittool -server SERVER01 -trait ExchangeSmartSyncTriggerHour -erase
Back To Top

Was this information helpful? Send us your comments.