CalendarServer

Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2008-01-11 13:03:07
Size: 3255
Editor: 26-191
Comment:
Revision 20 as of 2008-01-11 20:12:20
Size: 4560
Editor: 26-191
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from CalDAVServer
Line 6: Line 7:
What is CalDAV? == What is CalDAV? ==
Line 9: Line 10:
Install procedure for Ubuntu Server 7.10 == Install procedure for Ubuntu Server 7.10 ==
Line 11: Line 12:
Installing Apple's iCal Server is fairly trivial once you know what to do. We do need to download some additional packages using apt-get, and we need to download some software using subversion. Most users will be familiar with apt-get, many with subversion. If you're not familiar with subversion, don't panic though. This guide will be a detailed, step by step howto, showing exactly which commands to enter and when. Installing Apple's iCal Server is fairly trivial once you know what to do. We do need to download some additional packages using apt-get, and we need to download some software using subversion. Most users will be familiar with apt-get, many with subversion. If you're not familiar with subversion, don't panic. This guide will be a detailed, step by step howto, showing exactly which commands to enter and when.
Line 14: Line 15:
* Log into the server console or via ssh, so you can enter commands, and run sudo -s to get a root shell.
* Install subversion: apt-get install subversion
* Execute the following commands. It's ok to simply copy and paste them. It's quite alot of packages, and it may take a while for all of them to download and install.
Line 18: Line 16:
apt-get install libkrb5-dev
apt-get attr
apt-get install attr
apt-get install subversion
apt-get install curl
apt-get install build-essential
apt-get install libssl-dev
apt-get install python-pysqlite2
apt-get install bzip2
apt-get install curl
apt-get install zope3
apt-get install python-xml
apt-get install python-pyopenssl
apt-get install python-dateutil
apt-get install python-xattr
apt-get install python-pysqlite2
apt-get install python-twisted
apt-get install python-vobject
apt-get install python-kerberos
 * Log into the server console or via ssh, so you can enter commands, and run {{{ sudo -s }}} to get a root shell.
 * Install some software: {{{ apt-get install subversion libkrb5-dev attr curl build-essential libssl-dev python-pysqlite2 bzip2 }}}
 * Install some more software: {{{ apt-get install curl zope3 python-xml python-pyopenssl python-dateutil python-xattr python-pysqlite2 python-twisted python-vobject python-kerberos }}}
Line 38: Line 20:
* We now need to edit our /etc/fstab file and add user_xattr to the partition containing the CalDAV server, / in this case. vim /etc/fstab.
My / before edit: UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro 0 1
After edit: UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro,user_xattr 0 1
 * We now need to edit our /etc/fstab file and add {{{ user_xattr }}} to the options for the partition containing the CalDAV server, / in this case: {{{ vim /etc/fstab }}}
Line 42: Line 22:
* We must now remount the filesystem: mount -o remount /
* Make a directory for the server in /opt: mkdir /opt/iCalServer
* Let's download the server software itself using subversion:
svn checkout http://svn.macosforge.org/repository/calendarserver/CalendarServer/trunk CalendarServer
* Subversion created a directory for us, called CalendarServer. Let's change into it: cd CalendarServer
* And run a script to download some necessary packages, etc: ./run -s
* Ok. (Unless something is wrong and you got alot of errors, in which case, it's not ok) Our CalDAV server is almost ready for action. Let's copy the test configuration so we can get up as quickly as possible. Real configuration can wait:
cp conf/caldavd-test.plist conf/caldavd-dev.plist
* We do need to do some configuration though: vim conf/caldavd-test.plist
This is how my change looked like:
{{{
Before: UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro 0 1
After : UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro,user_xattr 0 1
}}}
Line 52: Line 28:
ADD PRECISE DESCRIPTION OF NECESSARY EDIT FOR EXTERNAL CONNECTIONS AND FOR EVOLUTION USERS!  * We must now remount the filesystem: {{{ mount -o remount / }}}
 * We'll install the server in /opt, so lets change into it: {{{ cd /opt }}}
 * Let's download the server software itself using subversion: {{{ svn checkout http://svn.macosforge.org/repository/calendarserver/CalendarServer/trunk CalendarServer }}}
 * Subversion has downloaded alot of software, and created a directory for us, called CalendarServer. Let's change into it: {{{ cd CalendarServer }}}[[BR]]
 * And run a script to download some necessary packages, configure, etc: {{{ ./run -s }}}
 * Ok, our CalDAV server is almost ready for action. Let's copy the test configuration so we can get it up as quickly as possible. Real configuration can wait: {{{ cp conf/caldavd-test.plist conf/caldavd-dev.plist }}}
 * We do need to do some configuration though: {{{ vim conf/caldavd-dev.plist }}}

 * Let's change the hostname for the server. Locate the line {{{ <!-- Network host name --> }}} and change {{{ <string>localhost</string> }}} to {{{ <string>your-real-hostname</string> }}} [[BR]]
 * We have to make it available to connections from other computers. Locate this line: {{{ <!-- List of IP addresses to bind to [empty = all] --> }}} and replace {{{ 127.0.0.1 }}} in {{{ <string>127.0.0.1</string> }}} with either nothing or a spesific, public ip address for your server.

 * There is a bug in Evolution that prevents us from using this setup. The bug is located here, and please visit it now to see if it's been fixed. It also explains how to enable Evolution to connect. I won't include it here, because it's important that you check out the bug yourself: https://bugs.launchpad.net/ubuntu/+source/evolution/+bug/16019
Line 55: Line 42:
 * Run the server: ./run
 * That's it! The server is up and running, and you can connect to it with your CalDAV client using {{{ caldav://ADDRESS:8008/calendars/users/admin/calendar }}} to test the server using username {{{ admin }}} and password {{{ admin }}}
 * But we're not really done yet. So, what's next? We're currently running the server as root. That's not necessary, so we shouldn't. What we should do, is create a user for our CalDAV server, set permissions for /opt/CalendarServer to that user and run as that user. We should also create scripts for /etc/init.d/ so we can manage it like we do with other services, and we should add a script to run it when we boot and properly shut it down when we shut down the system.
Line 59: Line 49:
Cam's blog: http://cam.moobox.org/blog/?p=5
Lenfis blog:http://blog.jl42.de/index.php?/archives/231-Installation-of-the-Apple-Calendar-Server-on-Ubuntu-Edgy.html
http://trac.macosforge.org/projects/calendarserver/wiki/

Cam's blog: [[BR]]
http://cam.moobox.org/blog/?p=5
[[BR]] [[BR]]
Lenfis blog: [[BR]] http://blog.jl42.de/index.php?/archives/231-Installation-of-the-Apple-Calendar-Server-on-Ubuntu-Edgy.html
[[BR]] [[BR]]
Calendar Server wiki: [[BR]]
http://trac.macosforge.org/projects/calendarserver/wiki/ [[BR]] [[BR]]

THIS PAGE IS NOT FINISHED. DON'T FOLLOW ANY ADVISE IN IT UNTIL THIS LINE IS REMOVED.

This page will explain how to install Apple's iCal Server on Ubuntu Server, though desktop variants should also work without any problems.

What is CalDAV?

Explain that here, together with an explanation between CalDAV and WebDAV/webcal, with a link to a page describing how to make that happen.

Install procedure for Ubuntu Server 7.10

Installing Apple's iCal Server is fairly trivial once you know what to do. We do need to download some additional packages using apt-get, and we need to download some software using subversion. Most users will be familiar with apt-get, many with subversion. If you're not familiar with subversion, don't panic. This guide will be a detailed, step by step howto, showing exactly which commands to enter and when.

Ready?

  • Log into the server console or via ssh, so you can enter commands, and run  sudo -s  to get a root shell.

  • Install some software:  apt-get install subversion libkrb5-dev attr curl build-essential libssl-dev python-pysqlite2 bzip2 

  • Install some more software:  apt-get install curl zope3 python-xml python-pyopenssl python-dateutil python-xattr python-pysqlite2 python-twisted python-vobject python-kerberos 

  • We now need to edit our /etc/fstab file and add  user_xattr  to the options for the partition containing the CalDAV server, / in this case:  vim /etc/fstab 

This is how my change looked like:

Before: UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro 0 1
After : UUID=94a96528-c889-45a1-bc98-d9d02ecdd59c / ext3 defaults,errors=remount-ro,user_xattr 0 1
  • We must now remount the filesystem:  mount -o remount / 

  • We'll install the server in /opt, so lets change into it:  cd /opt 

  • Let's download the server software itself using subversion:  svn checkout http://svn.macosforge.org/repository/calendarserver/CalendarServer/trunk CalendarServer 

  • Subversion has downloaded alot of software, and created a directory for us, called CalendarServer. Let's change into it:  cd CalendarServer BR

  • And run a script to download some necessary packages, configure, etc:  ./run -s 

  • Ok, our CalDAV server is almost ready for action. Let's copy the test configuration so we can get it up as quickly as possible. Real configuration can wait:  cp conf/caldavd-test.plist conf/caldavd-dev.plist 

  • We do need to do some configuration though:  vim conf/caldavd-dev.plist 

  • Let's change the hostname for the server. Locate the line  <!-- Network host name -->  and change  <string>localhost</string>  to  <string>your-real-hostname</string>  BR

  • We have to make it available to connections from other computers. Locate this line:  <!-- List of IP addresses to bind to [empty = all] -->  and replace  127.0.0.1  in  <string>127.0.0.1</string>  with either nothing or a spesific, public ip address for your server.

  • There is a bug in Evolution that prevents us from using this setup. The bug is located here, and please visit it now to see if it's been fixed. It also explains how to enable Evolution to connect. I won't include it here, because it's important that you check out the bug yourself: https://bugs.launchpad.net/ubuntu/+source/evolution/+bug/16019

  • Run the server: ./run
  • That's it! The server is up and running, and you can connect to it with your CalDAV client using  caldav://ADDRESS:8008/calendars/users/admin/calendar  to test the server using username  admin  and password  admin 

  • But we're not really done yet. So, what's next? We're currently running the server as root. That's not necessary, so we shouldn't. What we should do, is create a user for our CalDAV server, set permissions for /opt/CalendarServer to that user and run as that user. We should also create scripts for /etc/init.d/ so we can manage it like we do with other services, and we should add a script to run it when we boot and properly shut it down when we shut down the system.

References:

Cam's blog: BR http://cam.moobox.org/blog/?p=5 BR BR Lenfis blog: BR http://blog.jl42.de/index.php?/archives/231-Installation-of-the-Apple-Calendar-Server-on-Ubuntu-Edgy.html BR BR Calendar Server wiki: BR http://trac.macosforge.org/projects/calendarserver/wiki/ BR BR

CalendarServer (last edited 2014-07-13 21:21:52 by 5ac9a5f8)