readme_osx.txt 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. OS X Server instructions:
  2. 1. Calendarserver in OS X not sends headers required by web browsers to allow cross domain queries. To add these headers follow the steps below:
  3. - copy the misc/calendarserver.diff into any directory on your server (for example: ~/Desktop)
  4. Mac OS X Lion Server (for OS X Mountain Lion Server see below):
  5. - if your server is already patched (previous version of patch) you must restore the original files from backup:
  6. NOTE: if you have updated your server installation, you probably do not want to restore the old files (possible newer version of Calendarserver files)
  7. sudo mv /usr/share/caldavd/lib/python/twext/web2/http_headers.py.orig /usr/share/caldavd/lib/python/twext/web2/http_headers.py
  8. sudo mv /usr/share/caldavd/lib/python/twext/web2/server.py.orig /usr/share/caldavd/lib/python/twext/web2/server.py
  9. - execute the following command in the Terminal:
  10. sudo patch -b -d /usr/share/caldavd/lib/python/twext/web2 -i ~/Desktop/calendarserver.diff
  11. OS X Mountain Lion Server:
  12. - if your server is already patched (previous version of patch) you must restore the original files from backup:
  13. NOTE: if you have updated your server installation, you probably do not want to restore the old files (possible newer version of Calendarserver files)
  14. sudo mv /Applications/Server.app/Contents/ServerRoot/usr/share/caldavd/lib/python/twext/web2/http_headers.py.orig /Applications/Server.app/Contents/ServerRoot/usr/share/caldavd/lib/python/twext/web2/http_headers.py
  15. sudo mv /Applications/Server.app/Contents/ServerRoot/usr/share/caldavd/lib/python/twext/web2/server.py.orig /Applications/Server.app/Contents/ServerRoot/usr/share/caldavd/lib/python/twext/web2/server.py
  16. - execute the following command in the Terminal:
  17. sudo patch -b -d /Applications/Server.app/Contents/ServerRoot/usr/share/caldavd/lib/python/twext/web2 -i ~/Desktop/calendarserver.diff
  18. 2. The Digest authentication used in OS X Server is not supported directly by JavaScript in many browsers. It is recommended to disable it and enable the Basic authentication instead (or you may try the Digest auth with globalUseJqueryAuth=true in config.js). To disable the Digest authentication execute the following commands in Terminal:
  19. sudo serveradmin settings calendar:Authentication:Basic:Enabled = yes
  20. sudo serveradmin settings calendar:Authentication:Digest:Enabled = no
  21. 3. Restart Calendarserver services:
  22. sudo serveradmin stop addressbook
  23. sudo serveradmin start addressbook
  24. sudo serveradmin stop calendar
  25. sudo serveradmin start calendar
  26. WARNING: with Basic authentication your username and password are sent over the network in plain text.
  27. !!! ALWAYS USE SSL with Basic authentication !!!
  28. Example config.js href values for OS X Server:
  29. globalAccountSettings:
  30. href: http://osxserver.com:8008/principals/users/USERNAME/ (INSECURE!)
  31. href: https://osxserver.com:8443/principals/users/USERNAME/
  32. globalNetworkCheckSettings:
  33. href: http://osxserver.com:8008/principals/users/ (INSECURE!)
  34. href: https://osxserver.com:8443/principals/users/