From 8739421b095f193f087860f3afbc6f67ec1ceaae Mon Sep 17 00:00:00 2001 From: Maya Berdygylyjova Date: Tue, 8 Oct 2024 09:47:00 +0200 Subject: [PATCH] =?UTF-8?q?[#58111]=2014.6=20Documentation:=20Add=20to=20c?= =?UTF-8?q?onnection=20validation=20that=20manage=E2=80=A6=20(#16840)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * [#58111] 14.6 Documentation: Add to connection validation that managed directory is empty for Nextcloud storages https://community.openproject.org/work_packages/58111 [#58111] 14.6 Documentation: Add to connection validation that managed directory is empty for Nextcloud storages https://community.openproject.org/work_packages/58111 * Update docs/system-admin-guide/files/external-file-storages/health-status/README.md Co-authored-by: dominic-braeunlein --------- Co-authored-by: dominic-braeunlein --- .../external-file-storages/health-status/README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/system-admin-guide/files/external-file-storages/health-status/README.md b/docs/system-admin-guide/files/external-file-storages/health-status/README.md index 90b91ec5ed1d..b0379e7eb39a 100644 --- a/docs/system-admin-guide/files/external-file-storages/health-status/README.md +++ b/docs/system-admin-guide/files/external-file-storages/health-status/README.md @@ -44,12 +44,13 @@ view. This check is available after the file storage is fully configured. There are several possible errors that can occur during the connection test. The following table lists the error codes with a description of the possible reasons and suggested solutions. -| Error code | Error description | Possible reasons | Next steps and solutions | -|--------------------------|--------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| ERR_HOST_NOT_FOUND | No Nextcloud server was found at the configured host URL. | There might be a typo or the URL has changed. | Please check the configuration. | -| ERR_MISSING_DEPENDENCIES | A required dependency is missing on the file storage. | Either the Integration OpenProject app or the Group Folders app is not enabled in Nextcloud. | Please add the following dependency: %{dependency}. | +| Error code | Error description | Possible reasons | Next steps and solutions | +| ------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | +| ERR_HOST_NOT_FOUND | No Nextcloud server was found at the configured host URL. | There might be a typo or the URL has changed. | Please check the configuration. | +| ERR_MISSING_DEPENDENCIES | A required dependency is missing on the file storage. | Either the Integration OpenProject app or the Group Folders app is not enabled in Nextcloud. | Please add the following dependency: %{dependency}. | | ERR_UNEXPECTED_VERSION | The Integration OpenProject app version or the Group Folders app version is not supported. | Either the Integration OpenProject app or the Group Folders app is outdated or was not updated to the officially minimal supported version. | Please update your apps to the latest version. It might be necessary to update your Nextcloud server to the latest version in order to be able to install the latest app versions. | -| ERR_UNKNOWN | An unknown error occurred. | There can be multiple reasons and the error source was not foreseen. | Errors of this kind are logged to the server logs. Look for a log entry starting with `Connection validation failed with unknown error:` | +| ERR_UNKNOWN | An unknown error occurred. | There can be multiple reasons and the error source was not foreseen. | Errors of this kind are logged to the server logs. Look for a log entry starting with `Connection validation failed with unknown error:` | +| WRN_UNEXPECTED_CONTENT | The connection request was successful, but unexpected content was found in the drive. | This warning is only shown, if the file storage is configured to automatically managed project folder permissions. There was data found in the drive, that is not a project folder created by OpenProject. | Go to your storage and migrate or delete the data in the OpenProject folder, that was not created by OpenProject. Further information about the unexpected data is found in the server logs. | The officially minimal supported app versions are listed in the [system admin guide](../../../../system-admin-guide/integrations/nextcloud/#required-system-versions).