Oracle® Calendar Sync for Palm

Read Me

Release 2 (9.0.4.1) for Macintosh

November 20, 2003

What's New In This Release

Oracle Calendar Sync for Palm for Macintosh now supports Mac OS 10.3.

Installing Oracle Calendar Sync for Palm for Macintosh

System Requirements

Operating system: Macintosh OS 9 or Mac OS X 10.1.4 to 10.3

RAM: 8 MB (64 MB recommended)

Calendar server:

Oracle CorporateTime server 5.4
Oracle Calendar server 5.5
Oracle Calendar server 9.0.4

Palm: Palm Desktop version 4.x

Device: Any Palm-compatible device running Palm OS 3.3 to 3.5x, Palm OS 4.x or Palm OS 5.x. Oracle Calendar Sync for Palm for Macintosh is certified with the following devices: Handspring Visor, Tungsten T, and Palm m500 series.

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.

Remove the Oracle Calendar Sync application (also known as CS Setup) from your Palm organizer.
Purge all items from your Date Book and To Do List. 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 for Macintosh

This section describes how to install Oracle Calendar Sync for Palm for Macintosh.

Double-click the file cal_syncpalm_macOS9_904x.hqx (cal_syncpalm_macOSX_904x.hqx if you are using OS X). This creates the Oracle Calendar Sync installer.
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.
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 and ToDo conduits to a folder entitled Disabled Conduits.
Turn on the Palm organizer and place it in its cradle.
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.
If the HotSync Manager is running, the installer will ask if you wish to close it. Click Yes to exit the HotSync Manager.
Click the HotSync icon in your HotSync folder and select HotSync Manager.
From the HotSync menu, choose Conduit Settings. A list of synchronizable items appears. Choose how you want Oracle Calendar Events and Tasks 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 or Tasks on your Palm organizer.
- Do Nothing: The specified Entry type is not synchronized.
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.
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.

Known Limitations and Workarounds

Oracle Calendar Sync for Palm for Macintosh 9.0.4.1 must be synchronized using Oracle Calendar desktop client for Macintosh 9.0.4.1.

Oracle is a registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners.