ZCS iCalendar Migration Guide 6.0
Table of Contents Previous Next


Zimbra iCalendar Migration Guide : About Zimbra iCalendar Migration Tool

About Zimbra iCalendar Migration Tool
The Zimbra iCalendar Migration Tool converts Oracle Calendar Server (OCS) generated .ics files into standard .ics format.
The Zimbra iCalendar Migration Tool begins the conversion by identifying patterns within RDATE series. Any patterns of DAILY, WEEKLY and MONTHLY recurrences within RDATE series are converted to an RRULE. In the case of recurrences that happen on a specific day of the week, a BYDAY is also added to the RRULE. Any recurrences with limited changes in summary, attendee list, location, date, time, or description are converted to exceptions.
By default, all RDATE series that do not fit a pattern are converted into standalone events with new UIDs. Alternately, the icalmig tool can be run with an option to convert all RDATE series that do not fit a pattern to an RRULE with a YEARLY recurrence, with exceptions are created for each associated occurrence.
The Zimbra iCalendar Migration Tool is run using the icalmig command in the Command Line Interface (CLI). The icalmig command can be run in standard mode, or with additional options to further control the conversion process. Standard mode converts a file to standard RFC format, using only default and standard options during conversion. Syntax, description, and examples for icalmig are given below.
icalmig
This tool converts Oracle Calendar Server (OCS) generated calendar files to a standard .ics format, which can then be processed by Zimbra servers. The icalmig tool is stored in /opt/zimbra/libexec.
Syntax
icalmig -f <ics file> [options]
Description
 
<ics file> Specifies the .ics file to convert.
Note: To run icalmig in standard mode, use only this argument. Files converted in standard mode use all default and standard options, converting the file to standard RFC format.
{1|0} Deletes RDATEs from the master VEVENT which has RRULE also. A value of 0 turns this option off. A value of 1 turns this option on. This option is on by default.
{1|0} Creates exceptions for RDATEs that do not fit a pattern. A value of 0 turns this option off. A value of 1 turns this option on. This option is on by default.
{1|0} Creates an RRULE based on pattern found. (E.g. DAILY, WEEKLY, BIWEEKLY) A value of 0 turns this option off. A value of 1 turns this option on. This option is on by default.
-YearlyException
If this option is specified, all RDATE series that do not fit a pattern are converted to an RRULE with a YEARLY recurrence, with exceptions are created for each associated occurrence.
{1|0} Adds a VTIMEZONE component for EST5EDT. All other date-time information will be changed according to this component. A value of 0 turns this option off. A value of 1 turns this option on. This option is off by default.
Note: At this time, this option does not adjust the GMT timestamp. See Bug 31815 for more current information about the status of this issue.
-nonStandardDTSTART
{1|0} Shifts the master event date to the oldest RDATE if the master DTSTART is not the first RDATE in the series. A value of 0 turns this option off. A value of 1 turns this option on. This option is off by default.
Note: All occurrences in an RDATE series with a DSTART older than the master event will be skipped during the conversion if this option is off.
<arg> Specifies the log file path. The default path is /opt/zimbra/log.
Example
In this example, the Zimbra iCalendar Migration Tool converts the calendar.ics file located at home/myuser/data/. The log files for this conversion will be stored in /tmp/logs.
icalmig -f “/home/myuser/data/calendar.ics” -logpath “/tmp/logs”.

Zimbra iCalendar Migration Guide : About Zimbra iCalendar Migration Tool

Table of Contents Previous Next
ZCS iCalendar Migration Guide 6.0
Copyright © 2009 Zimbra Inc.