abraunegg-onedrive/docs/known-issues.md
abraunegg a0f4f9ddab
Update known-issues.md (#889)
* Add 'SSL_ERROR_SYSCALL, errno 104' as known issue
2020-04-25 08:36:03 +10:00

3.6 KiB

Known Issues

The below are known issues with this client:

Unable to recursively delete directories in OneDrive Business when Retention Policy is enabled

Issue Tracker: #338

Description:

Some organisations enable a retention policy on OneDrive Business that prevents the recursive deletion of data. The client is unable to delete directories as requested.

Workaround:

Client will print the following when this issue is encountered:

ERROR: Unable to delete the requested remote path from OneDrive: <dir>
ERROR: This error is due to OneDrive Business Retention Policy being applied
WORKAROUND: Manually delete all files and folders from the above path as per Business Retention Policy

A future version of onedrive will attempt to resolve this automatically negating the need for the above message.

Moving files into different folders should not cause data to delete and be re-uploaded

Issue Tracker: #876

Description:

When running the client in standalone mode (--synchronize) moving folders that are sucessfully synced around between subseqant standalone syncs causes a deletion & re-upload of data to occur.

Explanation:

Technically, the client is 'working' correctly, as, when moving files, you are 'deleting' them from the current location, but copying them to the 'new location'. As the client is running in standalone sync mode, there is no way to track what OS operations have been done when the client is not running - thus, this is why the 'delete and upload' is occurring.

Workaround:

If the tracking of moving data to new local directories is requried, it is better to run the client in service mode (--monitor) rather than in standalone mode, as the 'move' of files can then be handled at the point when it occurs, so that the data is moved to the new location on OneDrive without the need to be deleted and re-uploaded.

Application 'stops' running without any visible reason

Issue Tracker: #494, #753, #792, #884

Description:

When running the client and performing an upload or download operation, the application just stops working without any reason or explanation.

Explanation:

The client is heavily dependant on Curl and OpenSSL to perform the activities with the Microsoft OneDrive service. Generally, when this issue occurs, the following is found in the HTTPS Debug Log:

OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 104

The only way to determine this is the cause of the application ceasing to work is to generate a HTTPS debug log using the following additional flags:

--verbose --verbose --debug-https

This is indicative of the following:

  • Some sort of flaky Internet connection somewhere between you and the OneDrive service
  • Some sort of 'broken' HTTPS transparent inspection service inspecting your traffic somewhere between you and the OneDrive service

How to resolve:

The best avenue of action here are:

  • Ensure your OS is as up-to-date as possible
  • Get support from your OS vendor
  • Speak to your ISP or Help Desk for assistance
  • Open a ticket with OpenSSL and/or Curl teams to better handle this sort of connection failure
  • Generate a HTTPS Debug Log for this application and open a new support request with Microsoft and provide the debug log file for their analysis.

If you wish to diagnose this issue further, refer to the following:

https://maulwuff.de/research/ssl-debugging.html