diff --git a/admin_manual/groupware/index.rst b/admin_manual/groupware/index.rst index 17698956e47..84c7f9dc6a5 100644 --- a/admin_manual/groupware/index.rst +++ b/admin_manual/groupware/index.rst @@ -10,3 +10,4 @@ Groupware contacts mail out_of_office + troubleshooting diff --git a/admin_manual/groupware/troubleshooting.rst b/admin_manual/groupware/troubleshooting.rst new file mode 100644 index 00000000000..4659676d8e1 --- /dev/null +++ b/admin_manual/groupware/troubleshooting.rst @@ -0,0 +1,38 @@ +.. _troubleshooting_groupware: + +=============== +Troubleshooting +=============== + +Calendar +######## + +Missing Shared Calendars +************************ + +**Problem:** + 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). + +**Affected Versions:** + - Nextcloud Server 31.0.5 and below + - Nextcloud Server 30.0.11 and below + +**Possible Reason:** + 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. + +**Troubleshooting Steps:** + +1. **Check for Hidden Calendars:** + 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. + +2. **List Calendar Shares:** + Run the command ``occ dav:list-calendar-shares `` 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 two options: + +A. **Remove All Calendar Unshares for a User:** + ``occ dav:clear-calendar-unshares ``. + +B. **Delete Specific Unshares:** + 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. + +**Why Isn't there an Automated Migration to Correct the Problem?** + 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. diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index d016ec1c3ac..2c0845d58d7 100644 --- a/admin_manual/issues/general_troubleshooting.rst +++ b/admin_manual/issues/general_troubleshooting.rst @@ -372,6 +372,9 @@ and then :ref:`rescan the external storage`. Troubleshooting contacts & calendar ----------------------------------- +.. tip:: + Please also refer to the troubleshooting article in the groupware section: :ref:`troubleshooting_groupware`. + Unable to update contacts or events ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^