BlackBerry Enterprise Server for Microsoft Exchange Administration Guide

Administration Guide Managing calendars

Managing calendars

18

Correcting calendar synchronization errors on BlackBerry devices

You can run the calendar synchronization process on a BlackBerry® Enterprise Server instance to find and correct differences between the calendar entries on BlackBerry devices and the calendar entries on a computer.

You can specify the recurring day and time when the process runs and how many days before a specific date occurs that the process checks the calendars for synchronization errors. You can also specify whether the process checks calendar entries for a specific user, users on a specific BlackBerry Enterprise Server, or all users. The process follows a hierarchy to determine what calendar entries to check. The hierarchy determines that 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.

You can configure the calendar synchronization process using the BlackBerry® Enterprise Trait Tool. The BlackBerry Enterprise

Trait Tool is located in the Tools directory of the BlackBerry Enterprise Server installation files.

By default, when the calendar synchronization process finds differences between the calendar entries on a BlackBerry device and the calendar entries on a computer, the process writes information about the differences to the BlackBerry Messaging Agent log file. You can use this information to troubleshoot calendar synchronization issues. You can configure the process to automatically correct the calendar synchronization errors that it finds.

Configuration levels using the BlackBerry Enterprise Trait Tool

You can specify whether the calendar synchronization process checks calendar entries for a specific user, users on a specific

BlackBerry® Enterprise Server, or all users by setting the configuration level using the BlackBerry® Enterprise Trait Tool. The tool uses a hierarchy to determine what calendar entries the calendar synchronization process should check. The hierarchy determines that settings at the user level override settings at the server levels settings at the server level override settings at the global levels and settings at the global level override the default settings.

Level

-global

-server <server_name>

-user <smtp_address>

Description

The setting that you specify applies to all users.

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

The setting that you specify applies to a specific user.

Turn on the calendar synchronization process

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.

123

Administration Guide Correcting calendar synchronization errors on BlackBerry devices

3.

At the command prompt, navigate to the folder that contains the TraitTool.exe file.

4.

Perform one of the following actions:

• To turn on calendar synchronization for a specific user account, type TraitTool -user <smtp_address> -trait

ExchangeSmartSyncEnable -set true.

• To turn on calendar synchronization for all user accounts that are associated with a BlackBerry Enterprise Server, type

TraitTool -server <server_name> -trait ExchangeSmartSyncEnable -set true.

• To turn on calendar synchronization for all user accounts, type TraitTool -global -trait ExchangeSmartSyncEnable set true.

5.

Press ENTER.

Example: Turning on the process for all users

TraitTool -global -trait ExchangeSmartSyncEnable -set true

Example: Turning off the process for a specific user

TraitTool -user [email protected] -trait ExchangeSmartSyncEnable -set false

After you finish: To turn off the calendar synchronization process, type TraitTool -<level> -trait ExchangeSmartSyncEnable

-set false, 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.

View the current settings for 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

124

Administration Guide Correcting calendar synchronization errors on BlackBerry devices

Permit the calendar synchronization process to correct errors automatically

You can specify whether the calendar synchronization process adds calendar synchronization errors to the BlackBerry® Messaging

Agent log file or adds and corrects calendar synchronization errors. By default, the process adds calendar synchronization errors to the BlackBerry Messaging Agent log file without correcting the errors.

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 turn on automatic correction of calendar synchronization errors for a specific user account, type TraitTool -user

<smtp_address> -trait ExchangeSmartSyncSendUpdate -set True.

• To turn on 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 true.

• To turn on automatic correction of calendar synchronization errors for all user accounts, type TraitTool -global -trait

ExchangeSmartSyncSendUpdate -set true.

5.

Press ENTER.

Example: Configuring the process to correct calendar synchronization errors for a specific user

TraitTool -user [email protected] -trait ExchangeSmartSyncSendUpdate -set true

After you finish: To turn off calendar synchronization error correction, type TraitTool -<level> -trait

ExchangeSmartSyncSendUpdate -set false, 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.

Configure the days that the calendar synchronization process verifies

You can configure the calendar synchronization process to check for calendar synchronization errors a specific number of days before a specific date occurs.

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 turn on the calendar synchronization process so that it checks for errors for a specific user account a specific number of days before a specific date occurs, type TraitTool -user <smtp_address> -trait ExchangeSmartSyncDays -set

<value>, where <value> is a number from 1 to 365.

125

Administration Guide Correcting calendar synchronization errors on BlackBerry devices

• To turn on the calendar synchronization process so that it checks for errors a specific number of days before a specific date occurs 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 turn on the calendar synchronization process so that it checks for errors a specific number of days before a specific date occurs for all user accounts, type TraitTool -global -trait ExchangeSmartSyncDays -set <value>, where

<value> is a number from 1 to 365.

5.

Press ENTER.

Example: Configuring the calendar synchronization process to check calendar entries 3 days in advance for all users

TraitTool -global -trait ExchangeSmartSyncDays -set 3

Configure when the calendar synchronization process runs

You can configure the calendar synchronization process to start running at a specific hour or to run on recurring days or on only one recurring day. To specify more than one value for when the calendar synchronization process 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 (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 (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 (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.

126

Administration Guide Correcting calendar synchronization errors on BlackBerry devices

• 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 the calendar synchronization process 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

Example: Configuring the calendar synchronization process to run at 11:00 PM for all users on the BlackBerry Enterprise

Server that is named SERVER02

TraitTool -server SERVER02 -trait ExchangeSmartSyncTriggerHour -set 23

Example: Configuring the calendar synchronization process to run on weekdays for all users

TraitTool -global -trait ExchangeSmartSyncSchedule -set Weekdays

Example: Configuring the calendar synchronization process to run on Monday, Wednesday, and Friday for a specific user

TraitTool -user [email protected] -trait ExchangeSmartSyncSchedule -set

Monday,Wednesday,Friday

Delete a calendar synchronization setting

If you delete a calendar synchronization setting, the calendar synchronization process uses the setting that you defined 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 defined at the server level because the server level is the next highest level. If you do not define 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.

127

Administration Guide Correcting calendar synchronization errors on BlackBerry devices

• 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: Deleting the setting for the hour that the process runs on the BlackBerry Enterprise Server that is named

SERVER01

TraitTool -server SERVER01 -trait ExchangeSmartSyncTriggerHour -erase

128