Skip to content

add info about locked files in the common issues part - #800

Open
Svanvith wants to merge 5 commits into
mainfrom
add-info-about-locked-files
Open

Svanvith wants to merge 5 commits into
mainfrom
add-info-about-locked-files

Conversation

@Svanvith

@Svanvith Svanvith commented May 6, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@Svanvith
Svanvith requested review from Heiko-Pohl and tbsbdr May 6, 2026 12:29
@tbsbdr

tbsbdr commented May 22, 2026

Copy link
Copy Markdown
Member

please add when a file is unlocked

@tbsbdr tbsbdr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please add the info, when a file is unlocked (eg. after xx. time, close the browser etc?

@tbsbdr

tbsbdr commented Nov 17, 2026

Copy link
Copy Markdown
Member

@Svanvith and team: could you please continue here?

Svanvith and others added 2 commits November 18, 2026 07:29
…-files

# Conflicts:
#	docs/user/common-issues/_category_.json
#	docs/user/common-issues/index.md
#	i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/_category_.json
#	i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/index.md
#	i18n/de/docusaurus-plugin-content-docs/current/user/index.md
@Heiko-Pohl
Heiko-Pohl requested a review from aduffeck November 19, 2026 09:09
Comment thread docs/user/common-issues/locked-files.md Outdated

- The file is unlocked as soon as all processing steps have finished. This usually takes only a few seconds.
- There is no fixed time limit. If a processing step fails, OpenCloud repeats it automatically after an increasing waiting time.
- If the step still fails after the maximum number of attempts, processing is aborted. In this case, the file stays unavailable until an administrator resumes the processing.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's not what happens. Once the retries run out, postprocessing finishes with PPOutcomeAbort. Reva then rolls back the node and keeps only the uploaded bytes (revertNodeMetadata = true, keepUpload = true in decomposedfs.go on main). So a new file disappears from the folder, and an overwritten file goes back to its previous version. Users won't see a file that is "unavailable". They'll see their upload vanish or their edits missing.

- The file is unlocked as soon as all processing steps have finished. This usually takes only a few seconds.
- There is no fixed time limit. If a processing step fails, OpenCloud repeats it automatically after an increasing waiting time.
- If the step still fails after the maximum number of attempts, processing is aborted. In this case, the file stays unavailable until an administrator resumes the processing.
- If the virus scan detects malware, the file is deleted or stays blocked, depending on the server configuration.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's also a third option 'continue', in which case the file is just marked as infected but still made available as usual. I suppose we want to list that here too?

- it is open or being edited in an integrated Office app
- several users are working on the same Office file at the same time
- an Office editing session has not ended cleanly yet
- an upload is still being processed, for example by a virus scan

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's actually another case where files get locked. Clients that send WebDAV LOCK (for example desktop Office opening files over WebDAV, or macOS Finder) can lock files too, that's probably worth mentioning here, too.


```bash
opencloud storage-users uploads sessions
opencloud storage-users uploads sessions --resume

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--resume won't help here. After the max retries the upload is marked as finished, and resume skips finished uploads, so this needs --restart. Without a filter it also hits every session, including ones still running.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants