Skip to content

DOC: update storage paths, quota, and backup information - #110

Merged
redeboer merged 9 commits into
mainfrom
DOC/storage-update
Aug 7, 2026
Merged

DOC: update storage paths, quota, and backup information#110
redeboer merged 9 commits into
mainfrom
DOC/storage-update

Conversation

@MTerwissen

@MTerwissen MTerwissen commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Combines three related updates to the storage documentation, since they all touch the same table on the Data quota page.

/besfs5/besfs10 (#100)

Picks up the existing MAINT/besfs10 work and adds a row for /home/bes/$USER, noting that it is a symlink to /besfs10/homebes and is the path IHEP recommends, because it should survive the next file system migration. /home/bes and /workfs2 are now also mentioned as alternatives for the BOSS install folder.

Storage quota (#107)

The table claimed /besfs10 has no quota. In reality the quota is applied per directory (50 GB), which lfs quota -u $USER does not reveal — so jobs die halfway through with Disk quota exceeded and no prior warning. lfs_dir is now documented as the command that shows the limit you actually run into.

Backup information (#101)

Adds a Backup column to the table, plus a note that anything not under version control belongs on a backed-up file system, and that caches and large data files do not. Step 1 of the setup tutorial now warns that /besfs10 is not backed up and recommends keeping the workarea in a Git repository.

Note

The 50 GB figure and the backup column are taken from the discussion in #100 and #107http://afsapply.ihep.ac.cn was not reachable to verify them against the official pages, so please correct if these are off. The maximum file count for /besfs10 is listed as not documented rather than carrying over the old 1,000,000 from /besfs5.

redeboer and others added 4 commits July 16, 2026 00:20
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@MTerwissen MTerwissen added 📝 Docs Improvements or additions to documentation 🐛 Bug Something isn't working labels Aug 7, 2026
@MTerwissen
MTerwissen requested a review from redeboer August 7, 2026 09:21
@redeboer redeboer assigned redeboer and MTerwissen and unassigned redeboer Aug 7, 2026

@redeboer redeboer left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Looks good, thanks 🍯

@redeboer
redeboer enabled auto-merge (squash) August 7, 2026 14:32
@redeboer
redeboer disabled auto-merge August 7, 2026 14:42
@redeboer
redeboer merged commit 25abf53 into main Aug 7, 2026
12 checks passed
@redeboer
redeboer deleted the DOC/storage-update branch August 7, 2026 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🐛 Bug Something isn't working 📝 Docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Incorrect storage quota Add backup status / information of file systems Update /besfs5/besfs10 (maybe /home/bes?)

2 participants