Skip to content

Commit

Permalink
[#58111] 14.6 Documentation: Add to connection validation that manage…
Browse files Browse the repository at this point in the history 
…d 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
  • Loading branch information
@MayaBerd
MayaBerd committed Sep 27, 2024
1 parent 750ef9d commit add9c42
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions docs/system-admin-guide/files/external-file-storages/health-status/README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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 drive and migrate or delete the data from the drive root, that was not created by OpenProject. Further information about the unexpected data is found in the server logs. A drive configured for usage with the *Automatically managed project folders* option has a disrupted inheritance chain. Any data in here can only be seen by site owner. It is discouraged to use this drive for other purposes than the OpenProject integration. |

The officially minimal supported app versions are listed in
the [system admin guide](../../../../system-admin-guide/integrations/nextcloud/#required-system-versions).
Expand Down

0 comments on commit add9c42

Please sign in to comment.