Content
Updated by Maya Berdygylyjova 16 days ago
The new storage health together with an explanation of each possible error code plus possible reasons and fixes should be added in the troubleshooting section of the Nextcloud admin guide.
WIP
<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Internal error code</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Error name</p></th><th class="op-uc-p">Error</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Error description</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Possible reason</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Next steps and fixes</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p"><br data-cke-filler="true"></p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">101</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">No group specified</p></td><td class="op-uc-table--cell"><p class="op-uc-p">The group is not specified for the storage. The name is saved in the DB. <br>Reason: Glitch during setup or manual changes to the DB<br>Saved in the Storages Table in the providers field (JSON)</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Re-Setup the entire storage</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">102</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Group does not exist</p></td><td class="op-uc-table--cell"><p class="op-uc-p">After the app got activated on NC and then the group got removed afterwards.<br>Changes on Nextlcoud: OpenProject group got removed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Manually add the group in the NC setup called OpenProject.<br>Add the user OpenProject to the group OpenProject.<br><br>Or reinstall the OpenProject integration app on Nextcloud. Will need to reconfigure the Nextcloud storage</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">103</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">User does not exist</p></td><td class="op-uc-table--cell"><p class="op-uc-p">After the app got activated on NC and then the user got removed afterwards.<br><br>Changes on Nextlcoud: OpenProject user got removed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Manually add the user in the NC setup called OpenProject.<br>Add the user OpenProject to the group OpenProject.<br><br>Or reinstall the OpenProject integration app on Nextcloud. Will need to reconfigure the Nextcloud storage</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">104</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Insufficient privileges</p></td><td class="op-uc-table--cell"><p class="op-uc-p">When OpenProject can't change the user permissions for folders or add folders to the OpenProject folder because the OpenProject user has not access to the folder anymore.<br></p></td><td class="op-uc-table--cell"><p class="op-uc-p">reinstall the OpenProject integration app on Nextcloud. Will need to reconfigure the Nextcloud storage<br><br>Make sure the OpenProject user is the admin of the OpenProject group and also the admin of the OpenProject folder.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">105</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Failed to remove or add user from group</p></td><td class="op-uc-table--cell"><p class="op-uc-p">The user doesn't exist on Nextcloud, the user can't be removed because from the group OpenProject as it is an admin.<br>When running when running the sync job.<br>Error only shows in server logs<br><br>User added the user as an admin to the OpenProject group. When the user is also an admin in the Nextcloud group it needs to be an Nextcloud admin that can remove that user then.<br><br>Can also happen on SharePoint.<br>This user can not be found in the SharePoint<br><br>NC and SP</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Removing admin rights for that user on the OpenProject group <br>Or ensuring that the user exists on Nextcloud<br><br>(Storage type independent) </p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">HTTPMethodNotAllowed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Not allowed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Outbound request method not allowed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">OpenProject send wrong requests to the storage.<br><br>NC and SP</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Report to OpenProject community or support</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">HTTPNotFound</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Not found</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Outbound request destination not found</p></td><td class="op-uc-table--cell"><p class="op-uc-p">OpenProject can't reach Nexcloud. <br>- This could be due to Storage provider being down<br>- DNS problems<br>- Network problems (flaky)<br>- In local networks (Nexctloud specific setting that needs to enabled)<br><br>NC and SP</p></td><td class="op-uc-table--cell"><p class="op-uc-p">See if you can access Nextcloud from your browser.<br><br>See if NC settings is active if in local network<br></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">HTTPUnauthorized</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Unauthorized</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Outbound request not authorized</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Authentification is failing<br>Application password got changed and not updated in OpenProject (NC OAuth settings are wrong and SP client secret or id is wrong)<br><br>User has not access, can't login, no token can be negotiated<br><br>Server to server: The client secrets might be wrong<br><br>OpenProject User credentials might be wrong</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Check the setup for the storages, check the client secret (SP) or the OAuth setup is correct (NC) or the application password is correct.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">HTTPConflict</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Conflict</p></td><td class="op-uc-table--cell"><p class="op-uc-p"><i>error_text_from_response</i></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Create a folder or a file that already exists. Creating Data that already exists on the storage. e.g. creating a folder with the same name.<br><br>happens e.g. a user manually created something on the storage.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Check in the storage if the folder already exists to understand where the error comes from.<br></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Else</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Outbound request failed</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error that is not expected. A 500 happened. <br><br>e.g. TOS app was activated and OpenProject can't access storage anymore.<br><br>Password configuration plugin caused problems too.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">See if file storage is working correctly.<br>If it is collect as much as information and contact support / community</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Pending</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Initially, every storage is labeled 'Pending'. After the first sync job completes, this status updates to either 'Healthy' or 'Unhealthy' based on the sync results.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">If your status is stuck on 'Pending', double-check to ensure the OpenProject’s background workers are running. it should run every 5 minutes.<br>The worker is running into unhandled errors.<br><br>Check logs in worker, if logs are not conclusive contact support / community</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr></tbody></table></figure>
WIP
<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Internal error code</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Error name</p></th><th