Skip to content

Storage — Runbook

Check Disk Usage

# All data disks on chizuru
ssh [email protected] "df -h /mnt/filedump /mnt/seedbox /mnt/all-might /mnt/pve/urahara"

# ZFS pools
ssh [email protected] "zpool list"

NFS

Check NFS exports

# From chizuru
ssh [email protected] "exportfs -v"

# From macOS (verify exports are visible)
showmount -e 192.168.1.125

Restart NFS server

ssh [email protected] "systemctl restart nfs-server"

Re-export after /etc/exports change

ssh [email protected] "exportfs -ra"

Samba (legacy fallback)

Restart Samba on chizuru

ssh [email protected] "systemctl restart smbd && testparm -s 2>/dev/null"

Verify shares are visible

smbutil view //[email protected]

macOS NFS Mounts

Check active mounts

mount | grep nfs

Manual remount

sudo ~/bin/mount-nfs.sh

Force unmount and remount

sudo umount ~/mounts/*
sudo ~/bin/mount-nfs.sh

View mount log

cat /tmp/mount-nfs.log

Access from terminal

ls ~/mounts/unohana
ls ~/mounts/urahara
ls ~/mounts/filedump
ls ~/mounts/dlbox

Troubleshooting

NFS share not mounting on macOS

  1. Check NFS server is running: ssh [email protected] "systemctl status nfs-server"
  2. Verify exports: showmount -e 192.168.1.125
  3. Check mount log: cat /tmp/mount-nfs.log
  4. Manual mount test: sudo mount_nfs -o resvport,nfc,rw 192.168.1.125:/mnt/all-might /tmp/test-nfs

Mount shows as empty

  • Check host-side mount: ssh [email protected] "ls /mnt/all-might" (for unohana)
  • If empty, the physical disk may not be mounted — check lsblk on chizuru

Stale NFS mounts

If a mount hangs (chizuru unreachable), force unmount: 

sudo umount -f ~/mounts/<share>

Finder shows ghost volumes

Stale mount points can persist in Finder after failed mounts. Fix: killall Finder