docs(environment-setup): local-disk requirement + datasets on a network mount#58
Open
saadqbal wants to merge 1 commit into
Open
docs(environment-setup): local-disk requirement + datasets on a network mount#58saadqbal wants to merge 1 commit into
saadqbal wants to merge 1 commit into
Conversation
…rk mount Documents the storage rules introduced for backend#743: - setup-guide: Warning that HOST_DATA_DIR must be a local disk (the installer preflight fails fast on NFS/CIFS/SMB); large datasets can live on a network mount via HOST_DATASET_DIR. - configuration: HOST_DATA_DIR row note + new HOST_DATASET_DIR row; a Storage section Note on the MySQL-local / datasets-on-NFS split and running ingestion as the mount owner uid (root_squash-safe). - troubleshooting: MySQL CrashLoopBackOff -> data dir on NFS entry. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Contributor
|
👋 Heads-up — Code review queue is at 18 / 8 Above the WIP limit. The team convention is to review existing PRs before opening new work. Open PRs currently in Code review (oldest first):
Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.) |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Document the storage rules introduced for tracebloc/backend#743: the workspace database must be on a local disk, and large datasets can live on a network (NFS) mount.
Changes
<Warning>thatHOST_DATA_DIRmust be a local disk (the installer preflight fails fast on NFS/CIFS/SMB); datasets can use a network mount viaHOST_DATASET_DIR.HOST_DATA_DIRrow note + a newHOST_DATASET_DIRrow; a Storage-section<Note>on the MySQL-local / datasets-on-NFS split and running ingestion as the mount owner uid (root_squash-safe).CrashLoopBackOff→ data dir on NFS" entry.No
docs.jsonnav change (existing pages only).Documents
The
tracebloc/client(installer + chart) andtracebloc/client-runtime(ingestor uid) changes for backend#743.🤖 Generated with Claude Code
Note
Low Risk
Documentation-only updates to environment-setup pages; no runtime or installer behavior changes in this repo.
Overview
Documents backend#743 storage rules: workspace MySQL must live on local disk, while large datasets can use a separate network mount.
setup-guide adds a
<Warning>thatHOST_DATA_DIRmust be local (installer preflight rejects NFS/CIFS/SMB) and points readers toHOST_DATASET_DIRfor network-mounted datasets.configuration expands the installer table (
HOST_DATA_DIRlocal-disk note, newHOST_DATASET_DIRrow) and adds a Storage<Note>on keeping DB/logs local vs relocating only the dataset volume (hostPath.datasetPath//tracebloc-data) and running ingestion as the mount owner uid for NFSroot_squash.troubleshooting adds a local k3d entry for MySQL
CrashLoopBackOffwhen the data dir is on a network filesystem, with the same local vsHOST_DATASET_DIRsplit.Reviewed by Cursor Bugbot for commit 9b6bb39. Bugbot is set up for automated code reviews on this repo. Configure here.