Skip Headers

Oracle® Calendar Resource Kit
Release 2 (9.0.4)

Part Number B10894-01
Go To Table Of Contents
Contents

Go to previous page

5
Oracle Calendar Synchronization Tools

Oracle Calendar Sync

Oracle Calendar Sync synchronizes Oracle Calendar data with PDA devices using either Palm OS for Windows and Macintosh, or Windows CE. This enables you to download meetings, contacts, daily notes, day events, holidays and tasks to your handheld, and updates can be uploaded back to Oracle Calendar through the device's synchronization process. This takes Personal Digital Assistant functionality one step further, allowing direct synchronization with the data on the server rather than the data on the desktop.

Oracle Calendar Sync replaces the desktop application with a conduit directly linked to the calendar store. Oracle Calendar Sync's Preferences menu enables you to customize the amount of information that is synchronized, as well as download attendee lists and meeting details.

Installation instructions for Oracle Calendar Sync for Palm (Windows)

System requirements

Table 5-1 System requirements for Oracle Calendar Sync for Palm (Windows)
Requirement Value

Operating System

  • Windows 98

  • Windows 2000

  • Windows ME

  • Windows XP

  • Windows NT 4.0

Disk Space

75 MB

RAM

64 MB

Calendar server

Oracle Calendar server 5.4 or later

Palm Desktop

Palm Desktop 3.1 to 4.1

Devices

  • Palm m100, m500, m505, III, IIIx, V, Vx, Tungsten T, W

  • Handspring Visor

NOTE: Must be running Palm OS 3.5 to 5.0

Installing Oracle Calendar Sync for Palm (Windows)

If you have a previous version of Calendar Sync (CorporateSync) installed, Oracle Corporation recommends that you perform a synchronization before you install Calendar Sync for Palm for Windows.

  1. Make sure HotSync is installed on your machine.

  2. Run the .exe setup program provided with the distribution package and follow the on-screen InstallShield instructions.

  3. Choose an installation type. If you choose Custom, there is no difference between "This feature will be installed on local hard drive" and "This feature, and all subfeatures, will be installed on local hard drive". Select the conduits you want to install.

  4. Enter your user information, including user name, password, calendar server and node ID.

  5. Follow the rest of the on-screen instructions to complete the installation.

  6. Make sure your device is in its cradle, then perform a synchronization. The first time you do this after installation, a full synchronization will take place.

Installation instructions for Oracle Calendar Sync for Palm (Macintosh)

System requirements

Table 5-2 System requirements for Oracle Calendar Sync for Palm (Macintosh)
Requirement Value

Operating Systems

Macintosh OS 9 or Mac OS X to 10.2.6

RAM

8 MB (64 MB recommended)

Calendar server

Oracle Calendar server 5.4 or later

Palm

Palm Desktop version 4

Device

Any Palm-compatible device running Palm OS 3.3 to 3.5x, Palm OS 4 or Palm OS 5

Preparing to install over previous versions

If you already have Sync software installed on your computer and you have data stored in Palm Desktop, perform a HotSync.

If you have a Beta version of Oracle Calendar Sync installed, or if you have version 2.1.4 or earlier of Oracle Corporate Sync installed, you must do the following before installing Calendar Sync for Palm for Macintosh, in order to protect your data.

  1. Remove the Oracle Calendar Sync application (also known as CS Setup) from your Palm organizer.

  2. Purge all items from your Date Book, To Do List and Address Book. If you do not do this, duplicates of the items will be created when you perform your first HotSync after installing Oracle Calendar Sync. Keep in mind the following when purging data:

    • Make sure that "Save archive copy on PC" is selected.

    • "To Do" items that have not been marked as completed will have to be manually deleted.

    • To delete the majority of, or all, Date Book events, advance the date on your organizer by several years, then do your purge. For example, change your organizer's date to 2015, then purge all events "older than 1 week" to delete all events from the past up until the year 2015.

Installing Oracle Calendar Sync for Palm (Macintosh)

  1. Double-click the file cal_syncpalm_macOS9_904.hqx (cal_syncpalm_macOSX_904.hqx if you are using OS X). This creates the Oracle Calendar Sync installer.

  2. Double-click Oracle Calendar Sync Install. The installer checks for existing Sync files and installs the program. Depending on your setup, this may take several minutes. Some error messages may be generated and saved to the install log; you can ignore these messages.

  3. Copy Oracle Calendar Sync.prc from

    /Applications/Palm/Add-on/

    to:

    /Users/{user}/Documents/Palm/Users/{user}/Files to Install/

    where "{user}" is the name of the relevant Mac user.

    If you have only just recently installed Palm Desktop and the "Files to Install" folder doesn't exist, just create this folder manually.


    Note:

    The installer will move the Datebook , ToDo and Address conduits to a folder entitled Disabled Conduits.


  4. Turn on the Palm organizer and place it in its cradle.

  5. Press the HotSync button on the front of the Palm organizer cradle. The Oracle Calendar Sync application will be installed on your Palm organizer.


    Note:

    You may get error messages in the HotSync log saying that Oracle Calendar Sync cannot be located. Ignore these messages.


  6. If the HotSync Manager is running, the installer will ask if you wish to close it. Click Yes to exit the HotSync Manager.

  7. Click the HotSync icon in your HotSync folder and select HotSync Manager.

  8. From the HotSync menu, choose Conduit Settings. A list of synchronizable items appears. Choose how you want Oracle Calendar Events, Tasks and Addresses to be synchronized by double-clicking each item. A dialog box appears with the following choices:

    • Synchronize the files: Synchronizes all information that exists on both your Palm organizer and in Oracle Calendar.

    • Macintosh overwrites hand-held: Information in your Oracle Calendar Agenda overwrites Events, Tasks or Addresses on your Palm organizer.

    • Do Nothing: The specified Entry type is not synchronized.

  9. Select a user name from the top of the Conduit Settings dialog box. If there is only one user name, it will be selected automatically.

  10. Open Oracle Calendar Sync on your Palm organizer and enter your Calendar User Name, Password, Server and Node. If you do not know this information, ask your Network Administrator.

Oracle Calendar Sync is now installed but no Entry information has been synchronized.

Installation instructions for Oracle Calendar Sync for Pocket PC (Windows)

System requirements

Table 5-3 System requirements for Oracle Calendar Sync for Pocket PC (Windows)
Requirement Value

Operating Systems

  • Windows 98

  • Windows 2000

  • Windows ME

  • Windows XP

  • Windows NT 4.0

Disk Space

75 MB

RAM

64 MB

Calendar server

Oracle Calendar server 5.4 or later

Pocket PC

Pocket PC (Windows CE 3.0) with MIPS, SH3 or ARM processor

ActiveSync

3.0 to 3.6, as appropriate for your device

Device

  • HPC 2000

  • Compaq iPAQ

  • HP Jornada 500 series

  • HP Jornada 700 series

  • Handheld PC

  • Pocket PC 2002

If you are running an older version of Microsoft ActiveSync, check your manufacturer's site for updates.

Installing Oracle Calendar Sync for Pocket PC (Windows)

If you have a previous version of Calendar Sync (CorporateSync) installed, it is recommended that you perform a synchronization before you install Calendar Sync 9.0.4 for Pocket PC.

  1. Make sure ActiveSync is installed on your machine.

  2. Run the .exe setup program provided with the distribution package and follow the on-screen InstallShield instructions.

  3. Choose an installation type. If you choose Custom, there is no difference between "This feature will be installed on local hard drive" and "This feature, and all subfeatures, will be installed on local hard drive". Select the conduits you want to install.

  4. Make sure you install Oracle Calendar Sync Helper files when prompted by the application. Your device must be connected to install these files. If not, you can connect a later time and click Start > Programs > Oracle Calendar Sync for Pocket PC > Install Device Files.

  5. Enter your user information, including user name, password, calendar server and node ID.

  6. Follow the rest of the on-screen instructions to complete the installation.

  7. Remove your device from its cradle.

  8. If you are upgrading from a previous version, Select File | Delete Partnership.

  9. Return your device to the cradle. The ActiveSync Partnership Wizard starts.

  10. Follow the on-screen instructions to create a new ActiveSync Partnership. Select Oracle Calendar as your plug-in for Calendar, Tasks and Contacts.

  11. Open Microsoft ActiveSync if it does not open automatically.

  12. Click Sync if synchronization is not automatically initiated. The first time you synchronize, a full synchronization will occur.

Frequently asked questions

Does Oracle Calendar Sync use Oracle Sync Server?

No. Although they both use the same synchronization engine, Oracle Calendar Sync and Oracle Sync Server are two separate components serving two different purposes.

Oracle Calendar Sync replaces your PDA device's sync conduits. Using your PDA desktop software, you can now synchronize your PDA with the data on the Calendar Server.

Oracle Sync Server uses the SyncML standard to synchronize calendar information between Oracle Calendar server and other SyncML-compliant clients/servers/devices over any HTTP connection (physical connection or wireless). This removes any dependency on additional components, allowing full synchronization wherever an HTTP connection is available.

What data can I synchronize with Oracle Calendar Sync?

You can use Oracle Calendar Sync to synchronize:

Is conflict resolution performed when events are modified on both my PDA and the calendar server? (Windows only)

Yes, you can set rules to resolve conflicts when synchronizing items you own that have been modified on both the calendar server and your PDA. You can either replace the calendar server item with the PDA item, or replace the PDA item with the calendar server item.

The exception to this is if an attendee is added or removed from the list on the calendar server. Oracle Calendar Sync will always retain those changes during synchronization. If you have enabled the Add Attendee Names to Notes feature, Oracle Calendar Sync will update the list of attendees in the Notes section of your event accordingly.

In addition, unlike many synchronization solutions, Oracle's synchronization solution uses intelligent conflict resolution, determining who owns the event, and who is permitted to modify it. This means that you cannot delete or modify events that you do not own. If you modify one of these events in your PDA, it will be returned to its original state once you synchronize with the Calendar Server.

After installing Oracle Calendar Sync, there are symbols (+, -, ?, *) next to my calendar entries on my PDA. What do these symbols represent?

The symbols indicate ownership as well as attendance status. The list below provides an explanation of the symbols

How do I select the conduits with which to synchronize using Oracle Calendar Sync for Palm (Windows)?

If you want to choose which conduits you want to synchronize with Oracle Calendar Sync, you must perform a Custom installation of Oracle Calendar Sync.

If you need to re-install Oracle Calendar Sync so that you can select the Custom installation option, do the following:

  1. Uninstall Oracle Calendar Sync for Palm (Windows).

    • Double-click Add/Remove Programs from the Windows Control Panel.

    • Choose Oracle Calendar Sync 9.0.4 for Palm and click Add/Remove.

  2. Follow the installation instructions in Installing Oracle Calendar Sync for Palm (Windows) and select Custom as the installation type. You can then choose which conduits you want to install.

Why are events rescheduled in my PDA after I synchronize?

The time zones on your PDA and Oracle Calendar client must correspond.

Can I synchronize my offline agenda with Oracle Calendar Sync? (Windows only)

No, Oracle Calendar Sync is strictly available for online synchronization - you must have a network connection to the Oracle Calendar server in order to synchronize.

When should a full synchronization be performed? (Windows only)

A full synchronization should be performed under the following circumstances:

Can I keep my mobile device synchronized with two desktop computers?

If you want to synchronize with two desktop computer, make sure you perform a Full Synchronization of all your data types when you switch from one machine to another. For example, you have a mobile device which you want to keep synchronized with Computer A, your workstation, and Computer B, your home computer. You perform a Full Synchronization of your mobile device with Computer A once, and then work normally. At home that night, you perform a Full Synchronization of your mobile device with Computer B once, and then work normally. When you return to Computer A the next day, you perform a Full Synchronization once, and then work normally.

Can I view a full report on my synchronization? (Windows only)

Oracle Calendar Sync for Palm (Windows):

Choose Start > Programs > Oracle Calendar Sync for Palm > View Log. Oracle Calendar Sync for Palm archives the last five (5) logs for each Entry type.

Oracle Calendar Sync for Pocket PC:

Choose Start > Programs > Oracle Calendar Sync for Pocket PC > View Log. Oracle Calendar Sync for Palm archives the last five (5) logs for each Entry type.


NOTE:

Synchronization logs provide a full status report on every entry processed during synchronization, while message logs report any warnings or errors that may have occurred. A successful synchronization will produce a blank message log and a checkmark next to every entry in the Synchronization log.


Troubleshooting

Oracle Calendar Sync for Palm (Windows)

When trying to install Oracle Calendar Sync the installer returns the following message: "You must install Palm Desktop prior to installing this application".

The Oracle Calendar installer cannot find Palm Desktop on your desktop computer, possibly because Palm Desktop was not installed, or an unsupported version of Palm Desktop was installed. You must install Palm Desktop prior to installing Oracle Calendar Sync.

Reinstall Palm Desktop or revert to a supported version of Palm Desktop. Note that Oracle Calendar Sync supports Palm Desktop 3.1 to 4.1.

I just installed Oracle Calendar Sync for Palm. Why can't I synchronize Palm Desktop with my Palm device?

Oracle Calendar Sync software replaces Palm conduits with Oracle Calendar conduits. Palm Address, Date Book and To Do conduits are replaced with Oracle Calendar Address Book, Oracle Calendar Events, and Oracle Calendar Tasks. As a result, only Oracle Calendar entries can be synchronized with your Palm device.

Why can't I establish a connection between my mobile device and the calendar server?
Why is it taking so long to perform a synchronization?
Why are some Palm items not displayed in my Oracle Calendar client after synchronization?
Why are some entries not displayed on my Palm after synchronization?
After synchronizing, why are untitled meetings created with my Palm not visible in Oracle Calendar?

It is a known limitation that either a Note, or Location must be specified to create an untitled meeting. Otherwise, the untitled meeting will not be created.

Why is my Palm device not able to establish a connection with my computer?

It is possible that Oracle Calendar Sync cannot establish a connection with your computer due to a disconnected serial cable, or an unavailable serial port. Verify that the serial cable leading from your cradle is properly connected to a serial port on your computer.

Oracle Calendar Sync for Pocket PC (Windows)

When trying to install Oracle Calendar Sync the installer returns the following message: "You must install ActiveSync prior to installing this application".

The Oracle Calendar installer cannot find ActiveSync on your desktop computer, possibly because ActiveSync was not installed, or an unsupported version of ActiveSync was installed. You must install ActiveSync prior to installing Oracle Calendar Sync.

Reinstall ActiveSync or revert to a supported version of ActiveSync. Note that Oracle Calendar Sync supports ActiveSync 3.0 to 3.6.

Why can't I establish a connection between my mobile device and the calendar server?
Why is it taking so long to perform a synchronization?
Why are some Pocket PC items not displayed in my Oracle Calendar client after synchronization?
Why are some entries not displayed on my Pocket PC after synchronization?
After synchronizing, why are untitled meetings created with my Pocket PC not visible in Oracle Calendar?

It is a known limitation that either a Note, or Location must be specified to create an untitled meeting. Otherwise, the untitled meeting will not be created.

Why is my Pocket PC not able to establish a connection with my computer?

It is possible that Oracle Calendar Sync cannot establish a connection with your computer due to a disconnected serial cable, or an unavailable serial port. Verify that the serial cable leading from your cradle is properly connected to a serial port on your computer.

Oracle Calendar Sync for Palm (Macintosh)

Why do I have problems connecting to the server?
What do I do if the synchronization is taking too long?

Narrow the date range and the size of details included during synchronization.

Why are some Palm items not displayed in my Oracle Calendar client after synchronization?
Why are some entries not displayed on my Palm after synchronization?
Why can't I synchronize my Address Book with Oracle Calendar Sync?

Each of the following may be the cause of this problem:

I changed a timed event into an untimed event (or vice versa) in my Palm but the change was lost when I performed a HotSync. What should I do?

The calendar application does not support this kind of change. You must delete the event and then create a new one for the calendar application to recognize it after the next HotSync.

Why does only the first instance of a repeating entry get synchronized?

This is a limitation in this release of Oracle Calendar Sync for Palm (Macintosh).

What happens to an entry that has been modified in both the calendar application and the Palm when I perform a HotSync?

When a HotSync is done and the Custom menu setting for the calendar application is "Synchronize the files", the entry is duplicated (for more information about the duplication, open the HotSync Log). Simply delete the unwanted entry (either on your Palm or in the calendar application) and HotSync again.

Oracle Sync Server

Oracle Sync Server takes advantage of the SyncML protocol to deliver true remote synchronization of data with a wide range of SyncML-enabled devices. This alternative to the Desktop-to-PDA synchronization allows you the freedom to be anywhere while having the most up-to-the-second information.

Oracle Sync Server offers direct two-way synchronization with Oracle Calendar server over any standard Hypertext Transfer Protocol (HTTP) connection. This means that you have access to the calendar infrastructure from a variety of SyncML-compliant devices with Internet access. With Oracle Sync Server you are no longer tied to your desktop for synchronization.

Supported devices

The following SyncML-compliant devices are supported for use with Oracle Sync Server:

General considerations for all devices

This section describes common configuration issues for devices used with Oracle Sync Server. Please check the Device-specific considerations section for other behaviors you should be aware of.

Setup

Before you try to synchronize your device with Oracle Sync Server, make sure that you have:

For details on making the preceding configuration changes, see the documentation included with your device.

Data range

Events and tasks that are outside of the server-defined data range (generally 7 days in the past to 30 days ahead), will not be sent to the device. Accordingly, any events or tasks outside of this range that are synchronized to the server by the device will be archived on the server and deleted from the device.

Alarms

Alarm settings on mobile devices are preserved. If you change an existing event's reminder settings on the server, the modification does not get propagated to your device the next time you synchronize, and vice versa.

Class mapping

Devices that do not support the vCalendar or iCalendar CLASS property value of "CONFIDENTIAL" are supported as best as possible. For example, CONFIDENTIAL will be mapped to PRIVATE when an event is sent to a device that lacks this support, such as with Nokia, Ericsson and Sony Ericsson products. Also, CONFIDENTIAL events will remain confidential on the calendar server even when a device attempts to change them to PRIVATE.

Long summary and description support

Ericsson, Sony Ericsson, Nokia 9210 and 9290 devices now support 160 character event and task titles. Ericsson and Sony Ericsson devices also support LOCATION and DESCRIPTION properties for events and, in the case of the T68i, tasks. There is a 32-character limit on the LOCATION field of all tested Ericsson and Sony Ericsson phones.

Working with tasks and events

Some devices allow you to separately specify whether or not you want to synchronize events and tasks. For example, to synchronize tasks and events on the Sony Ericsson T68i, Choose 8 - Connect > 4 - Synchronization > 3 - Options > 1 - Remote Settings > 2 - Applications > 2 - Calendar, then enter the following URIs:

./Calendar/Events
./Calendar/Tasks

Devices that do not allow you to synchronize events and tasks separately only have one Calendar URL field, in which you simply enter:

./Calendar

The next time you synchronize with the server, both tasks and events will be synchronized. If you leave the field blank, neither tasks nor events will be synchronized.

The Ericsson, R520m, T39 and T68 do not support task synchronization; for these devices, you must enter

./Calendar/Events

Events will be synchronized, but tasks will not.

Travelling with your device across time zones

You must be very careful when travelling across time zones with your device.

You should not synchronize unless you change your device's time zone to match that of your account on the Calendar server, which only certain devices allow you to do.

If your device does not support time zone change, you should avoid synchronizing until you return. Alternatively, if you must synchronize, only do so if your account on the Calendar server remains set to the same time zone as your device. Some Calendar clients allow you to use a different time zone on a per-session basis, which can make it easier to understand your schedule in this circumstance, without altering your time zone setting on the server.

To check if your device supports time zone change, see Device-specific considerations.

Working with contact categories

Normally, to synchronize all contacts with the server, you enter ./contacts into the appropriate URI field in your device. However, you can choose to only synchronize one category of contacts from the server. To do this, simply append the category name to the URI; for example:

./contacts/mycategory

Category names you enter on the device can only contain alphanumeric characters, and the characters -_.!~*(). Category names cannot contain spaces.

If you specify a category to be synchronized, keep in mind the following the next time you synchronize with the server:

Device-specific considerations

This section lists device-specific behaviors you should keep in mind when synchronizing with Oracle Sync Server. Please check the General considerations for all devices section for other behaviors you should be aware of.

Nokia 3650

Nokia 6800

Nokia 7250

Nokia 7650

Nokia 92xx

Ericsson R520m, T39, T68, Sony Ericsson T68i

Sony Ericsson P800

Siemens S55

See also:

Welcome to the Oracle Calendar Resource Kit

Oracle Connector for Outlook

Oracle Calendar Web client

Oracle Calendar Desktop Client


Go to previous page
Oracle
Copyright © 1993, 2003 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
Contents