From 1e301d12fbb1ecf45c2d93dde6e75e5733c3b032 Mon Sep 17 00:00:00 2001 From: Thomas Tanghus Date: Wed, 25 Sep 2013 11:52:45 +0200 Subject: [PATCH] Add PIM sync troubleshooting guide --- user_manual/pim/index.rst | 1 + user_manual/pim/sync_ios.rst | 4 ++-- user_manual/pim/sync_osx.rst | 4 +++- user_manual/pim/troubleshooting.rst | 36 +++++++++++++++++++++++++++++ 4 files changed, 42 insertions(+), 3 deletions(-) create mode 100644 user_manual/pim/troubleshooting.rst diff --git a/user_manual/pim/index.rst b/user_manual/pim/index.rst index 4d0e54e9e..65e720bf0 100755 --- a/user_manual/pim/index.rst +++ b/user_manual/pim/index.rst @@ -11,4 +11,5 @@ Contacts & Calendar sync_osx sync_thunderbird sync_kde + troubleshooting diff --git a/user_manual/pim/sync_ios.rst b/user_manual/pim/sync_ios.rst index 170cddb49..73e7ef70d 100644 --- a/user_manual/pim/sync_ios.rst +++ b/user_manual/pim/sync_ios.rst @@ -49,5 +49,5 @@ Address book - Go back to account information and hit Save. Now should now find your contacts in the address book of your -iPhone.Problems have been reported for iOS 4.X. A possible solution is -at the `forum `_. \ No newline at end of file +iPhone. +If it's still not working, have a look at the :doc:`troubleshooting` guide. \ No newline at end of file diff --git a/user_manual/pim/sync_osx.rst b/user_manual/pim/sync_osx.rst index 1e8965e23..6369c5b0b 100644 --- a/user_manual/pim/sync_osx.rst +++ b/user_manual/pim/sync_osx.rst @@ -12,7 +12,7 @@ The setup is basically the same as with iOS using the path **ADDRESS/remote.php/ #. Go back to the folder window from step 2. You will now see a newly created folder with another long string as its name. #. Navigate to the newly created folder and edit the **Configuration.plist** with your favorite text editor. #. Search for a section looking like this:: - + servername http://:0(null) username Whatever_you_entered_before 8. Make it look like this. Please note that the :80 after **YOUR_DOMAIN** is important:: @@ -25,6 +25,8 @@ The setup is basically the same as with iOS using the path **ADDRESS/remote.php/ 11. You may have to restart Address Book once more. After this, it should work. +If it's still not working, have a look at the :doc:`troubleshooting` guide. + There is also an easy `HOWTO`_ in the forum. diff --git a/user_manual/pim/troubleshooting.rst b/user_manual/pim/troubleshooting.rst new file mode 100644 index 000000000..57ac53447 --- /dev/null +++ b/user_manual/pim/troubleshooting.rst @@ -0,0 +1,36 @@ +Troubleshooting +=============== + +Service discovery +----------------- + +Some clients - especially iOS - have problems finding the proper sync URL, even when explicitly +configured to use it. + +There are several techniques to remedy this, which are described extensively at the +`Sabre DAV website `_. + +Below is what have proven to work with iOS including iOS 7. + +If your ownCloud instance is installed in a sub-folder under the web servers document root, and +the client has difficulties finding the Cal- or CardDAV end-points, configure your web server to +redirect from a "well-know" URL to the one used by ownCloud. +When using the Apache web server this is easily achieved using a :file:`.htaccess` file in the document +root of your site. + +Say your instance is located in the ``owncloud`` folder, so the URL to it is ``ADDRESS/owncloud``, +create or edit the :file:`.htaccess` file and add the following lines:: + + Redirect 301 /.well-known/carddav /owncloud/remote.php/carddav + Redirect 301 /.well-known/caldav /owncloud/remote.php/caldav + +If you use Nginx as web server, the setting looks something like:: + + url.redirect = ( + "^/.well-known/carddav" => "/owncloud/remote.php/carddav", + "^/.well-known/caldav" => "/owncloud/remote.php/caldav", + ) + +Now change the URL in the client settings to just use ``ADDRESS`` instead of e.g. ``ADDRESS/remote.php/carddav/principals/username``. + +This problem is being discussed in the `forum `_.