Improved TROUBLESHOOT.md (thanks to Raphaël Droz for the tip).

Core/Frameworks/BaikalAdmin/Resources/Templates/Dashboard.html

@@ -56,7 +56,7 @@
 			<h2>License and credits</h2>
 			<p>Baïkal is open source software, and released under the terms of the GNU GPL v3.</p>
 			<p>Baïkal is based upon other open source projects. Read the <a href="https://github.com/jeromeschneider/Baikal/blob/master/README.md" target="_blank">README.md</a> file to learn about that.</p>
-			<p>Baïkal is developped by <a href="http://base8.fr" target="_blank"><img src="res/core/BaikalAdmin/Images/logo-framboise.png" style="height: 32px; vertical-align:text-bottom;" /></a> <a href="http://base8.fr" target="_blank">Base8</a>. We'd love to hear from you at <a href="mailto:contact@base8.fr">contact@base8.fr</a></p>
+			<p>Baïkal is developed by <a href="http://base8.fr" target="_blank"><img src="res/core/BaikalAdmin/Images/logo-framboise.png" style="height: 32px; vertical-align:text-bottom;" /></a> <a href="http://base8.fr" target="_blank">Base8</a>. We'd love to hear from you at <a href="mailto:contact@base8.fr">contact@base8.fr</a></p>
 		</div>
 	</div>
 </section>

INSTALL.md

@@ -21,7 +21,7 @@ The following configuration is the minimum required:
 - an hosted webserver running apache 2 and PHP 5.3.0
 
 - PHP 5.3.0 or newer with the following extensions: 
-	- PDO and SQLite3
+	- PDO and SQLite3 or MySQL 
         - DOM (php-xml)  
 	Some extensions can be optionally compiled into PHP. A list of loaded
 	extensions can be checked using the phpinfo() function.
@@ -42,15 +42,13 @@ The following configuration is the minimum required:
 	interfaces will be produced in the future. 
 
 - PHP 5.3.0 or newer with the following extensions: 
-	- PDO and SQLite3 
+	- PDO and SQLite3 or MySQL 
         - DOM (php-xml) 
 	Some extensions can be optionally compiled into PHP. A list of loaded
 	extensions can be checked using the phpinfo() function. 
 
 - 30 MB of disk space 
 
-- Apache configuration that activates "FollowSymlinks" 
-
 # 2 - Obtaining Baïkal
 
 To get Baïkal, navigate to the following location: 

README.md

@@ -39,7 +39,9 @@ Please read INSTALL.md in this folder.
 Please read TROUBLESHOOTING.md in this folder.
 
 # 8. Credits
-Jérôme Schneider (@jeromeschneider) is admin and lead developper. 
+
+Baïkal is developed by Base8 (http://base8.fr). 
+Jérôme Schneider (@jeromeschneider) is admin and lead developer. 
 Many thanks to Daniel Aleksandersen (@zcode) for greatly improving the quality of the project page (http://baikal.codr.fr). Much appreciated, Daniel :) 
 
--- Jérôme Schneider <mail@jeromeschneider.fr>  Mon, 23 Jul 2012 08:26:00 +0100
+-- Jérôme Schneider <contact@base8.fr>  Mon, 21 Aug 2012 12:17:00 +0100

TROUBLESHOOTING.md

@@ -4,6 +4,7 @@ This package contains a release of Baïkal.
 Go to http://baikal.codr.fr to get more information about this package, and upgrades.
 
 # 2. Problem with authentication (CalDAV and CardDAV)
+
 On webservers where PHP is served as FastCGI (check your phpinfo()
 to find out if that's the case for you), Apache does not pass HTTP
 Auth informations to PHP, and thus preventing Cal/CardDAV to auth
@@ -13,4 +14,44 @@ using Apaches mod_rewrite. This is done by the Apache config directives
 found in the /.htaccess file that comes with Baïkal (or /html/.htaccess
 for the non-ftp package).  
 Note: if this file is empty / does not exist, you should try to add it manually  
-(sometimes FTP clients decide to not send files with names beginning with a dot ".")
+(sometimes FTP clients decide to not send files with names beginning with a dot ".")
+
+# 3. Troubleshooting calendar access (please check 2. first)
+
+To troubleshoot user auth / data access, you may use curl to debug server responses. On a command line, run:
+
+	curl -so - --digest --user username:password http://hostname/cal.php/calendars/username/default
+
+(Be sure that the username exists, has the right password set, and has a calendar named default first).
+
+If you see this, auth works for this username/password/calendar, so it has to be client-related:
+	<s:message>GET is only implemented on File objects</s:message>
+
+If you see this, password is wrong (case-sensitive) (despite the message indicating that it's the username):
+	<s:message>Incorrect username</s:message>
+
+If you see this, username is wrong:
+	  <s:message>The supplied username was not on file</s:message>
+
+If you see this, auth works but the "principals" part of the URL is wrong (the /username/ after "calendars" in the URL):
+	<s:message>Principal with name username not found</s:message>
+
+If you see this, auth works but the calendar does not exist for this user:
+	<s:message>Calendar with name 'defaults' could not be found</s:message>
+
+If you see this, auth works and the calendar exists, but the provided user has no permission to access this calendar:
+	<s:exception>Sabre_DAVACL_Exception_NeedPrivileges</s:exception>
+
+If you see one of these, the URL is not well formed / invalid:
+	<s:message>File not found: XXXXX in 'root'</s:message>
+	Or
+	The requested URL XXXXX was not found on this server.
+
+If you see nothing at all, curl cannot resolve your host.
+
+# 4. Database is readonly (sqlite)
+
+Using SQLite (the default setup), if you have troubles when putting data in the database,
+(an exception "unable to open database file" is thrown) check that:
+  * the system user running your Apache/PHP has write permissions on Specific/db/ (*the folder*)
+  * the system user running your Apache/PHP has write permissions on Specific/db/db.sqlite (*the file*)