Skip to content

Commit f0e1714

Browse files
refactor: Move contacts troubleshooting entry to existing section
Moved the lone Contacts entry in the general troubleshooting chapter over to the existing Troubleshooting section that already exists within the Groupware chapter. Minor correcting of phrasing, formatting, and grammar. Signed-off-by: Josh <josh.t.richards@gmail.com>
1 parent e8b0ce5 commit f0e1714

File tree

1 file changed

+25
-10
lines changed

1 file changed

+25
-10
lines changed

admin_manual/groupware/troubleshooting.rst

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,37 +5,52 @@ Troubleshooting
55
===============
66

77
Calendar
8-
########
8+
--------
99

1010
Missing Shared Calendars
11-
************************
11+
^^^^^^^^^^^^^^^^^^^^^^^^
1212

1313
**Problem:**
14-
User should have access to a shared calendar, but the calendar is not displayed in Nextcloud Calendar or other CalDAV clients (e.g., DAVx⁵ or Thunderbird).
14+
A user should have access to a shared calendar, but the calendar is not displayed in Nextcloud Calendar or other CalDAV clients (e.g., DAVx⁵ or Thunderbird).
1515

1616
**Affected Versions:**
1717
- Nextcloud Server 31.0.5 and below
1818
- Nextcloud Server 30.0.11 and below
1919

2020
**Possible Reason:**
21-
A bug in previous versions of Nextcloud Server could mistakenly add a calendar unshare instead of removing the share permission. For example, a user has read access through a group membership, and the owner grants permission to a single user to modify a calendar. When removing the modify permission again, the unshare record was created.
21+
A bug in previous versions of Nextcloud Server could mistakenly add a calendar unshare instead of removing the share permission. For example, a user has read access through a group membership, and the owner grants permission to a single user to modify a calendar. When the modify permission is removed, an unshare record is incorrectly created.
2222

2323
**Troubleshooting Steps:**
2424

2525
1. **Check for Hidden Calendars:**
26-
It's possible for a user to hide a calendar. Please check in Nextcloud Calendar if the missing calendar is listed in the "hidden" section. If the missing calendar is listed there, check the box in front of the calendar to enable it again.
26+
Its possible for a user to hide a calendar. Please check in Nextcloud Calendar if the missing calendar is listed in the "hidden" section. If it is, check the box in front of the calendar to enable it again.
2727

2828
2. **List Calendar Shares:**
29-
Run the command ``occ dav:list-calendar-shares <uid>`` to list all shares for a user. Look for lines with the Calendar URI/Calendar Name of the missing calendar and Permissions = Unshare. If there's such a line, but the user should have access, you have three options:
29+
Run the command ``occ dav:list-calendar-shares <uid>`` to list all shares for a user. Look for lines with the Calendar URI/Calendar Name of the missing calendar and Permissions = Unshare. If such a line exists, but the user should have access, you have three options:
3030

3131
A. **Create a User Share and Remove It Again:**
3232
In most cases, sharing the calendar with the user again (as an individual/user share) will correct the state in the database.
3333

3434
B. **Remove All Calendar Unshares for a User:**
35-
``occ dav:clear-calendar-unshares <uid>``.
35+
Run ``occ dav:clear-calendar-unshares <uid>``.
3636

3737
C. **Delete Specific Unshares:**
38-
Some users may have many calendar unshares, so it might be easier to delete only the unwanted unshare. The ``Share Id`` references the id of a row in the ``oc_dav_shares`` database table. Delete the row with the matching id to remove the unshare.
38+
Some users may have many calendar unshares, so it might be easier to delete only the unwanted unshare. The ``Share Id`` refers to the ID of a row in the ``oc_dav_shares`` database table. Delete the row with the matching ID to remove the unshare.
3939

40-
**Why Isn't there an Automated Migration to Correct the Problem?**
41-
Unsharing a calendar is a feature, and with the given information, we cannot determine if a calendar was unshared on purpose or as a result of the bug.
40+
**Why isn't there an automated migration to correct the problem?**
41+
Unsharing a calendar is a feature, and with the given information, we cannot determine if a calendar was unshared intentionally or as a result of the bug.
42+
43+
Contacts
44+
--------
45+
46+
Unable to update contacts or events
47+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
48+
49+
If you get an error like:
50+
51+
``PATCH https://example.com/remote.php/dav HTTP/1.0 501 Not Implemented``
52+
53+
it is likely because of a misconfigured web server:
54+
55+
Your web server is misconfigured and blocks the required DAV methods.
56+
Please refer to :ref:`trouble-webdav-label` for troubleshooting steps.

0 commit comments

Comments
 (0)