LCTL-SNAPSHOT_MODIFY(8)

📦 version 2.17.58, in ubuntu stonking

💅 LCTL-SNAPSHOT_MODIFY 💅

okay bestie, this is a section 8 (system admin) page from the Lustre Configuration Utilities lineup, and it's literally just one tool that edits your snapshots 🎀

✨ NAME ✨

lctl-snapshot_modify — modify Lustre snapshot 🌸

🦋 SYNOPSIS 🦋

lctl snapshot_modify [-c|--comment COMMENT] {-F|--fsname FSNAME}
                     [-h|--help] {-n|--name SSNAME} [-N|--new
                     NEW_SSNAME] [-r|--rsh REMOTE_SHELL]

💖 DESCRIPTION 💖

So basically, this bad boy modifies the snapshot you point it at. It pulls your system config out of the file /etc/ldev.conf, exactly the way it's described in the SNAPSHOT section of lctl(8). Then it goes and modifies the snapshot pieces on every single Lustre target — that's MGT, MDT, and OST. Every one of them. No skips. 🔥

🍓 OPTIONS 🍓

  • -c, --comment COMMENT — drop a comment in there (if you never set one back when you ran snapshot_create) or change the comment that's already on the snapshot you're messing with. 💬
  • -F, --fsname FSNAME — the filesystem name, bestie. You gotta tell it which one. ✨
  • -h, --help — for help information, obviously. Ask and you shall receive. 🙈
  • -n, --name SSNAME — the name of the snapshot you're modifying. This one is required, no cap, it must be specified. 👑
  • -N, --new NEW_SSNAME — renames the snapshot to the new name. It follows the general ZFS snapshot name rules — like the max length is 256 bytes, it can't conflict with the reserved names, all that jazz. 💅
  • -r, --rsh REMOTE_SHELL — pick a shell for talking to remote targets. The default value is ssh. And ngl, it is the system admin's duty to guarantee that the specified REMOTE_SHELL works well among targets without password authentication. That part is on you, not on us. 😭

🌈 AVAILABILITY 🌈

lctl-snapshot-modify is part of the lustre(7) filesystem package since release 2.10.0 🦋

⭐ SEE ALSO ⭐

lctl(8), lctl-barrier(8), lctl-lcfg(8), lctl-snapshot-create(8), lctl-snapshot-destroy(8), lctl-snapshot-list(8), lctl-snapshot-mount(8), lctl-snapshot-umount(8)

lowkey iconic of you to read the whole thing, fr fr 🫶

and that's a wrap!! this page is brought to you by Lustre, dated 2024-08-14, stay slay bestie 💜

📦 where this page comes from