PNFSDSKILL(8)

💖 NAME 💖

okay so this is pnfsdskill(8) from the System Manager's Manual, and bestie — it disables a pNFS data storage server (DS). yes, that’s the whole vibe. iconic storage-maintenance behavior 💅.

🌸 SYNOPSIS 🌸

pnfsdskill [-f] mounted-on-DS-dir

🦋 DESCRIPTION 🦋

so picture this: mirroring is enabled, and pnfsdskill disables one DS. if one mirrored DS is malfunctioning (not slaying, lowkey broken 😭), a system administrator may use this command on the metadata server (MDS) to disable use of this mirror. periodt.

this command must be used on the MDS, and the mounted-on-DS-dir must be the exact pathname used when mounting the DS on the MDS. fr fr, exact path only. normally this command will fail if there is no valid mirror for the DS available. 🙈

the following option is available, bestie:

• -f — forces the DS to be disabled even if there is no valid mirror for the DS available. it should only be used to allow nfsd(8) threads to be terminated. no cap.

if this command fails with “Device not configured” (ENXIO), it probably means that the DS has already been disabled due to an error either detected by the MDS or reported to the MDS by a client. 😭💀

the pNFS service should continue to run normally so long as the number of operational DSs is at least as many as the level of mirroring. ✨🫶

💜 SEE ALSO 💜

go read these too, iykyk: nfsv4(4), pnfs(4), nfsd(8), pnfsdscopymr(8), pnfsdsfile(8) 🌈

🎀 HISTORY 🎀

the pnfsdskill command first appeared in FreeBSD 12.0. ⭐

okay that’s the whole page, bestie — this cutie is from Debian, dated July 9, 2018. mwah 💋🎀