Blame view
sources/core/doc/user/pim/troubleshooting.html
11.3 KB
d1bafeea1
[fix] Upgrade to ...
|
1 2 3 4 5 6 7 8 9 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
6d9380f96
Update sources OC...
|
10 |
<title>Troubleshooting — ownCloud User Manual 7.0 documentation</title> |
|
d1bafeea1
[fix] Upgrade to ...
|
11 12 13 14 15 16 17 18 19 |
<link rel="stylesheet" href="../_static/style.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/style.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
|
|
6d9380f96
Update sources OC...
|
20 |
VERSION: '7.0', |
|
d1bafeea1
[fix] Upgrade to ...
|
21 22 23 24 25 26 27 28 29 |
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/bootstrap.js"></script>
|
|
6d9380f96
Update sources OC...
|
30 |
<link rel="top" title="ownCloud User Manual 7.0 documentation" href="../index.html" /> |
|
d1bafeea1
[fix] Upgrade to ...
|
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 |
<link rel="up" title="Contacts & Calendar" href="index.html" />
<link rel="next" title="Using the Bookmarks App" href="../bookmarks.html" />
<link rel="prev" title="Synchronizing with KDE SC" href="sync_kde.html" />
<script type="text/javascript">
(function () {
/**
* Patch TOC list.
*
* Will mutate the underlying span to have a correct ul for nav.
*
* @param $span: Span containing nested UL's to mutate.
* @param minLevel: Starting level for nested lists. (1: global, 2: local).
*/
var patchToc = function ($ul, minLevel) {
var findA;
// Find all a "internal" tags, traversing recursively.
findA = function ($elem, level) {
var level = level || 0,
$items = $elem.find("> li > a.internal, > ul, > li > ul");
// Iterate everything in order.
$items.each(function (index, item) {
var $item = $(item),
tag = item.tagName.toLowerCase(),
pad = 15 + ((level - minLevel) * 10);
if (tag === 'a' && level >= minLevel) {
// Add to existing padding.
$item.css('padding-left', pad + "px");
console.log(level, $item, 'padding-left', pad + "px");
} else if (tag === 'ul') {
// Recurse.
findA($item, level + 1);
}
});
};
console.log("HERE");
findA($ul);
};
$(document).ready(function () {
// Add styling, structure to TOC's.
$(".dropdown-menu").each(function () {
$(this).find("ul").each(function (index, item){
var $item = $(item);
$item.addClass('unstyled');
});
$(this).find("li").each(function () {
$(this).parent().append(this);
});
});
// Patch in level.
patchToc($("ul.globaltoc"), 2);
patchToc($("ul.localtoc"), 2);
// Enable dropdown.
$('.dropdown-toggle').dropdown();
});
}());
</script>
</head>
<body>
<div class="container">
<div class="content">
<div class="page-header">
<h1><a href="../contents.html">ownCloud User Manual</a></h1>
</div>
<div class="row">
<div class="span3">
<div class="sidebar">
<div class="well">
<div class="menu-support-container">
<ul id="menu-support" class="menu">
<ul>
<li><a href="../contents.html">Overview</a></li>
</ul>
<ul>
|
|
6d9380f96
Update sources OC...
|
116 |
<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 7.0 User Documentation</a></li> |
|
d1bafeea1
[fix] Upgrade to ...
|
117 118 |
</ul> <ul class="current"> |
|
6d9380f96
Update sources OC...
|
119 |
<li class="toctree-l1"><a class="reference internal" href="../whats_new.html">New in ownCloud 7</a></li> |
|
d1bafeea1
[fix] Upgrade to ...
|
120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 |
<li class="toctree-l1"><a class="reference internal" href="../webinterface.html">The ownCloud Web Interface</a></li> <li class="toctree-l1"><a class="reference internal" href="../files/index.html">Files & Synchronization</a></li> <li class="toctree-l1 current"><a class="reference internal" href="index.html">Contacts & Calendar</a><ul class="current"> <li class="toctree-l2"><a class="reference internal" href="contacts.html">Using the Contacts App</a></li> <li class="toctree-l2"><a class="reference internal" href="calendar.html">Using the Calendar App</a></li> <li class="toctree-l2"><a class="reference internal" href="sync_ios.html">iOS - Synchronize iPhone/iPad</a></li> <li class="toctree-l2"><a class="reference internal" href="sync_osx.html">Synchronizing with OS X</a></li> <li class="toctree-l2"><a class="reference internal" href="sync_thunderbird.html">Thunderbird - Synchronize Addressbook</a></li> <li class="toctree-l2"><a class="reference internal" href="sync_kde.html">Synchronizing with KDE SC</a></li> <li class="toctree-l2 current"><a class="current reference internal" href="">Troubleshooting</a><ul> <li class="toctree-l3"><a class="reference internal" href="#debugging-the-issue">Debugging the issue</a></li> <li class="toctree-l3"><a class="reference internal" href="#service-discovery">Service discovery</a></li> <li class="toctree-l3"><a class="reference internal" href="#unable-to-update-contacts-or-events">Unable to update Contacts or Events</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../bookmarks.html">Using the Bookmarks App</a></li> <li class="toctree-l1"><a class="reference internal" href="../documents.html">Documents</a></li> <li class="toctree-l1"><a class="reference internal" href="../migration.html">User Account Migration</a></li> <li class="toctree-l1"><a class="reference internal" href="../userpreferences.html">Changing Preferences</a></li> |
|
6d9380f96
Update sources OC...
|
141 |
<li class="toctree-l1"><a class="reference internal" href="../external_storage/google_drive.html">Configuring External Storage</a></li> |
|
d1bafeea1
[fix] Upgrade to ...
|
142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 |
</ul>
</ul>
</div>
</div>
</div>
</div>
<div class="span9">
<div class="page-content">
<div class="section" id="troubleshooting">
<h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h1>
<div class="section" id="debugging-the-issue">
<h2>Debugging the issue<a class="headerlink" href="#debugging-the-issue" title="Permalink to this headline">¶</a></h2>
<p>In a standard ownCloud installation the log level is set to “Normal”. to find any issues
you need to raise the log level to “All” from the Admin page.
Some logging - for example JavaScript console logging - needs manually editing the
configuration file.
Edit <tt class="file docutils literal"><span class="pre">config/config.php</span></tt> and add <tt class="docutils literal"><span class="pre">define('DEBUG',</span> <span class="pre">true);</span></tt>:</p>
<div class="highlight-python"><pre><?php
define('DEBUG',true);
$CONFIG = array (
... configuration goes here ...
);</pre>
</div>
<p>For JavaScript issues you will also need to view the javascript console. All major browsers
have decent developer tools for viewing the console, and you usually access them by
pressing F-12. For Firefox it is recommended to install the <a class="reference external" href="https://getfirebug.com/">Firebug extension</a>.</p>
</div>
<div class="section" id="service-discovery">
<h2>Service discovery<a class="headerlink" href="#service-discovery" title="Permalink to this headline">¶</a></h2>
<p>Some clients - especially iOS - have problems finding the proper sync URL, even when explicitly
configured to use it.</p>
<p>There are several techniques to remedy this, which are described extensively at the
<a class="reference external" href="http://sabre.io/dav/service-discovery/">Sabre DAV website</a>.</p>
<div class="section" id="apple-ios">
<h3>Apple iOS<a class="headerlink" href="#apple-ios" title="Permalink to this headline">¶</a></h3>
<p>Below is what have proven to work with iOS including iOS 7.</p>
<p>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 <tt class="file docutils literal"><span class="pre">.htaccess</span></tt> file in the document
root of your site.</p>
<p>Say your instance is located in the <tt class="docutils literal"><span class="pre">owncloud</span></tt> folder, so the URL to it is <tt class="docutils literal"><span class="pre">ADDRESS/owncloud</span></tt>,
create or edit the <tt class="file docutils literal"><span class="pre">.htaccess</span></tt> file and add the following lines:</p>
<div class="highlight-python"><pre>Redirect 301 /.well-known/carddav /owncloud/remote.php/carddav
Redirect 301 /.well-known/caldav /owncloud/remote.php/caldav</pre>
</div>
<p>If you use Nginx as web server, the setting looks something like:</p>
<div class="highlight-python"><pre>url.redirect = (
"^/.well-known/carddav" => "/owncloud/remote.php/carddav",
"^/.well-known/caldav" => "/owncloud/remote.php/caldav",
)</pre>
</div>
<p>Now change the URL in the client settings to just use <tt class="docutils literal"><span class="pre">ADDRESS</span></tt> instead of e.g. <tt class="docutils literal"><span class="pre">ADDRESS/remote.php/carddav/principals/username</span></tt>.</p>
<p>This problem is being discussed in the <a class="reference external" href="http://forum.owncloud.org/viewtopic.php?f=3&t=71&p=2211#p2197">forum</a>.</p>
</div>
<div class="section" id="blackberry-os-10-2">
<h3>BlackBerry OS 10.2<a class="headerlink" href="#blackberry-os-10-2" title="Permalink to this headline">¶</a></h3>
<p>BlackBerry OS up to 10.2.2102 doesn’t accept a URL with protocol <tt class="docutils literal"><span class="pre">https://</span></tt> in front of the server address.
It will always tell you, that it cannot login on your server. So instead of writing</p>
<blockquote>
<div><a class="reference external" href="https://address/remote.php/carddav/principals/username">https://address/remote.php/carddav/principals/username</a></div></blockquote>
<p>in the server address field, you have to write</p>
<blockquote>
<div>address/remote.php/carddav/principals/username</div></blockquote>
</div>
</div>
<div class="section" id="unable-to-update-contacts-or-events">
<h2>Unable to update Contacts or Events<a class="headerlink" href="#unable-to-update-contacts-or-events" title="Permalink to this headline">¶</a></h2>
<p>If you get an error like <tt class="docutils literal"><span class="pre">PATCH</span> <span class="pre">https://ADDRESS/some_url</span> <span class="pre">HTTP/1.0</span> <span class="pre">501</span> <span class="pre">Not</span> <span class="pre">Implemented</span></tt> it is
likely caused by one of the following reasons:</p>
<dl class="docutils">
<dt>Outdated lighttpd web server</dt>
<dd>lighttpd in debian wheezy (1.4.31) doesn’t support the PATCH HTTP verb.
Upgrade to lighttpd >= 1.4.33.</dd>
<dt>Using Pound reverse-proxy/load balancer</dt>
<dd>As of writing this Pound doesn’t support the HTTP/1.1 verb.
Pound is easily <a class="reference external" href="http://www.apsis.ch/pound/pound_list/archive/2013/2013-08/1377264673000">patched</a> to support HTTP/1.1.</dd>
</dl>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>
|