Skip to content

docs: xrootd: clarify how the door selects pools for capacity reporting - #8279

Merged
kofemann merged 1 commit into
dCache:masterfrom
geonmo:docs-xrootd-capacity
Oct 29, 2026
Merged

kofemann merged 1 commit into
dCache:masterfrom
geonmo:docs-xrootd-capacity

Conversation

@geonmo

@geonmo geonmo commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Motivation:
The section on xrootd.capacity.source added in #8277 (for #8276) names dcache.enable.space-reservation, while the door follows xrootd.enable.space-reservation. It leaves out how pools are matched, the fallback to links outside link groups, and that xrootdfs caches space queries per mount, which decides what df shows.

Modification:
Describe the write link match (storage information of the directory, client address, Xrootd protocol, highest preference), name xrootd.enable.space-reservation and the assumed spacemanager.enable.unreserved-uploads-to-linkgroups, and mention the fallback to links outside link groups. Explain that the value is the space for new files, and how xrootdfs caching affects df.

Result:
The book matches the behaviour of the xrootd door.

Target: master
Require-book: no
Require-notes: no

Motivation:
The section on xrootd.capacity.source added in dCache#8277 names
dcache.enable.space-reservation, while the door follows
xrootd.enable.space-reservation. It leaves out how pools are matched,
the fallback to links outside link groups, and that xrootdfs caches
space queries per mount, which decides what df shows.

Modification:
Describe the write link match (storage information of the directory,
client address, Xrootd protocol, highest preference), name
xrootd.enable.space-reservation and the assumed
spacemanager.enable.unreserved-uploads-to-linkgroups, and mention the
fallback to links outside link groups. Explain that the value is the
space for new files, and how xrootdfs caching affects df.

Result:
The book matches the behaviour of the xrootd door.

Target: master
Require-book: no
Require-notes: no
Signed-off-by: Geonmo Ryu <geonmo@kisti.re.kr>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kofemann
kofemann merged commit 7ea176e into dCache:master Oct 29, 2026
1 check failed
@kofemann

Copy link
Copy Markdown
Member

@geonmo Thanks for your contribution

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants