Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This page describes the import of ICal calendar files into Kopano via thekopano-ical gateway.

Info
Ical will handle all timestamps in the .ics as GMT. Remember this if your appointments dont start at the correct time.

 

For the import of the ICal ics files we will use curl. The curl package will be installable on most linux distributions via the default repositories.On Centos/Redhat:
Code Block
$ yum install curl
On Ubuntu/Debian:

 

Code Block
$ apt-get install curl

 

 
With curl you are able to import ICal ics files into Kopano Core. Before you do this, you need to make sure that the kopano-ical service is started:

 

Code Block
$ /etc/init.d/kopano-ical status

 

The kopano-ical service runs on port 8080 by default. You can change these settings in /etc/kopano/ical.cfg. In this document we will use the default settings.

Now you can import ics files to the users default calendar using curl:

 

Code Block
# curl -u [username]:[password] -T [path to ics file] http://[kopano-ical-server]:8080/ical/[username]

 

You can also import to users default calendar using a kopano-admin user:

 

Code Block
# curl -u [kopano-admin user]:[password] -T [path to ics file] http://[kopano-ical-server]:8080/ical/[username]

 

If you want to import calendars to different calendars then the default calendar, use:

 

Code Block
# curl -u [username]:[password] -T [path to ics file] http://[kopano-ical-server]:8080/ical/[username]/[calendar name]/

 

Or if you want to import to a subfolder of a yet existing calendar (in the next example we import to a subfolder of a calendar named "Calendar"):

Code Block
# curl -u [username]:[password] -T [path to ics file] http://[kopano-ical-server]:8080/ical/[username]/Calendar/[calendar name]

 

If the calendar does not exist yet, the last example will not work when using a kopano-admin user. This needs to be done as the user itself. There is a workaround however, if you need to do some massive scripting on this and you don't know the users' passwords.You will need to run the kopano-ical service and kopano-server on the same host and the kopano-ical service needs to run as root. Change the server_socket in /etc/kopano/ical.cfg to:
Code Block
title/etc/kopano/ical.cfg
server_socket = file:///var/run/kopano/server.sock

 

After this change restart the kopano-ical service.You can now import calendars (both to default calendars and to calendars that need to be newly created) as the user. But now the kopano-ical service will accept any password as the users' password as long as it is not empty:
Code Block
# curl -u [username]:[any password] -T [path to ics file] http://[kopano-ical-server]:8080/ical/[username]/[calendar name]

 

 

Note

Important: Revert the server_socket back to it's original setting before going into production, as setting the server to a unix socket creates a security leak. So edit the file /etc/kopano/ical.cfg and change server_socket back to:

 

server
Code Block
title/etc/kopano/ical.cfg
 server_socket = http://localhost:236/