CURATORS: update Diskspace section to use generic stack-clean-old

which deprecates etc/remove-old-stack-work-libs.hs
This commit is contained in:
Jens Petersen 2025-12-30 21:48:51 +08:00
parent 4cf801c16b
commit 40e84422b1

View File

@ -343,22 +343,23 @@ resolve any issues before the next curator shift the coming monday.
### Diskspace errors (and website sync debugging)
* You can detect the problem by running `df`. If you see that `/` is out of space, we have a problem.
* If you see that `/var/stackage/` is out of space, you can:
* run `./etc/diskspace/remove-old-stack-work-libs.hs [nightly|lts-XX]`
* If that is insufficient then remove all the old builds under the previous ghc/Cabal version:
* `rm -r /var/stackage/stackage/automated/work/[nightly|lts-XX]/unpack-dir/unpacked/*/.stack-work/dist/x86_64-linux/Cabal-X.Y.0.0/`
optionally:
* `rm -r /var/stackage/stackage/automated/work/lts*/unpack-dir/unpacked/`
* `rm -r /var/stackage/stackage/automated/work/nightly/unpack-dir/unpacked/`
* You can check disk usage with `df -h`.
* If you see that stackage `$HOME` is out of space, you can use `stack-clean-old` to clean up (note it defaults to "dry-run" mode):
* Enter `nix-shell -p haskellPackages.stack-clean-old` and then:
* `cd ~/stackage/automated/work/[nightly|ltsXX]/unpack-dir`
* `stack-clean-old list` to show shared `.stack-work/install` usage
* `stack-clean-old remove 9.X.Y` to remove its `.stack-work/install` subdir
* `cd unpacked`
* `stack-clean-old delete-work --subdir --yes` to remove each package's `.stack-work` subdir
* If that is still really insufficient then optionally:
* `rm -r /var/stackage/stackage/automated/work/[nightly|ltsXX]/unpack-dir/unpacked/`
### Wiping the cache
Sometimes the cache can get corrupted which might manifest as `can't load .so/.DLL`.
You can wipe the nightly cache and rebuild everything by doing
As a last resort you can wipe the whole build cache to rebuild everything by doing
`rm -rf /var/stackage/stackage/automated/nightly`.
Replace nightly with `lts7` to wipe the LTS 7 cache.
Replace `nightly` with `lts7` to wipe the LTS 7 cache.
### Force a single package rebuild