[CalendarServer-changes] [2004] CalendarServer/trunk/doc/ical-schema.txt

[source_changes at macosforge.org]

Revision: 2004
          http://trac.macosforge.org/projects/calendarserver/changeset/2004
Author:   dreid at apple.com
Date:     2007-11-08 11:04:28 -0800 (Thu, 08 Nov 2007)

Log Message:
-----------
First draft of iCal schema explanation

Added Paths:
-----------
    CalendarServer/trunk/doc/ical-schema.txt

Added: CalendarServer/trunk/doc/ical-schema.txt
===================================================================
--- CalendarServer/trunk/doc/ical-schema.txt	                        (rev 0)
+++ CalendarServer/trunk/doc/ical-schema.txt	2007-11-08 19:04:28 UTC (rev 2004)
@@ -0,0 +1,92 @@
+Computer Record - An LDAP Computer record that stores information
+    about a given server running a set of services.
+
+    Needed Attributes:
+        dsAttrTypeStandard:GeneratedUID - a GUID to be used when
+            constructing ServicesLocator entries that point to services
+            described by this computer record.
+
+        dsAttrTypeStandard:ENetAddress - contains the MAC addresses of
+            the servers ethernet interfaces.
+
+        dsAttrTypeStandard:ServicesLocator - containing '::anyService'
+            to indicate that it provides virtual host configurations.
+
+        dsAttrTypeNative:apple-serviceinfo - containing a "Virtual
+            Host Plist" that describes configuration information about
+            all the services provided by this server.
+
+
+Virtual Host Plist - Stored in the dsAttrTypeNative:apple-serviceinfo
+    attribute this plist contains some basic configuration and a
+    timestamp and a number of virtual hosts.  One of which should
+    be for the calendar server.
+
+    Example:
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.macosxserver.host</key>
+    <array>
+        <string>example.calendarserver.org</string>
+    </array>
+    <key>com.apple.macosxserver.virtualhosts</key>
+    <dict>
+        <key>CFD9E112-9CC3-4AB7-97A6-3951C61ECECB</key>
+        <dict>
+            <key>hostDetails</key>
+            <dict>
+                <key>http</key>
+                <dict>
+                    <key>enabled</key>
+                    <true/>
+                    <key>port</key>
+                    <integer>8008</integer>
+                </dict>
+                <key>https</key>
+                <dict>
+                    <key>enabled</key>
+                    <false/>
+                    <key>port</key>
+                    <integer>0</integer>
+                </dict>
+            </dict>
+            <key>hostname</key>
+            <string>example.calendarserver.org</string>
+            <key>serviceInfo</key>
+            <dict>
+                <key>calendar</key>
+                <dict>
+                    <key>enabled</key>
+                    <true/>
+                    <key>templates</key>
+                    <dict>
+                        <key>calendarUserAddresses</key>
+                        <array>
+                            <string>%(principaluri)s</string>
+                            <string>mailto:%(email)s</string>
+                            <string>urn:uuid:%(guid)s</string>
+                        </array>
+                        <key>principalPath</key>
+                        <string>/principals/__uids__/%(guid)s/</string>
+                    </dict>
+                </dict>
+            </dict>
+            <key>serviceType</key>
+            <array>
+                <string>calendar</string>
+            </array>
+        </dict>
+    </dict>
+</dict>
+
+
+Services Locator - An attribute on the User, Group, Resource, and
+    Location types that specifies the location of the server that his
+    hosting a given service.
+
+    Of the form:
+312395FC-363A-44D5-BA5D-98B178D5CD43:CFD9E112-9CC3-4AB7-97A6-3951C61ECECB:calendar
+\----------------------------------/ \----------------------------------/ \------/
+        Computer Record GUID                Virtual Host GUID               Service name

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20071108/75e1b5e5/attachment.html