LCTL-SNAPSHOT_CREATE(8)

📦 version 2.17.58, in ubuntu stonking

💖 lctl-snapshot_create — the girlie who makes snapshots 💖

okay bestie, welcome to the lctl-snapshot_create(8) page, straight out of the Lustre Configuration Utilities crowd. section 8, manual-page royalty, no cap. 👑

✨ NAME ✨

lctl-snapshot_create — create Lustre snapshot. that's it. that's the whole job. and she does it flawlessly. 💅

🎀 SYNOPSIS 🎀

lctl snapshot_create [-b|--barrier [on|off]] [-c|--comment COMMENT]
                     {-F|--fsname FSNAME} [-h|--help] {-n|--name SSNAME}
                     [-r|--rsh REMOTE_SHELL] [-t|--timeout TIMEOUT]

look at her. look at the syntax. so structured. so iconic. ✨

🌸 DESCRIPTION 🌸

So here's the vibe: she creates a snapshot with whatever name you give her. periodt. 💅

First she loads the system configuration from the file /etc/ldev.conf, exactly like it's described in the SNAPSHOT section of lctl(8). yes bestie, read that one too, it's the lore. 📖

Then — and this is the main character moment — the snapshot pieces get created on every Lustre target: MGT/MDT/OST. all of them. nobody gets left out. 🫶

🦋 OPTIONS 🦋

  • -b, --barrier [on|off] — sets the write barrier on all MDTs before the snapshot gets created. default value is on. now listen: if you are confident about the system consistency, or you genuinely don't require full consistency and just wanna keep applications from getting blocked while the snapshot is being made, you can pass barrier off. that saves you time when creating the snapshot, lowkey a flex. 🕐 and if the barrier is on, then the timeout of the barrier can be specified via the -t option, as described in the next section. iykyk.
  • -c, --comment COMMENT — adds an optional comment to the snapshot_create request. you can put literally anything in there to describe what the snapshot is for, or just as a lil reminder to future you. 💭 and the comment can be shown via snapshot_list. cute, right?
  • -F, --fsname FSNAME — the filesystem name. that's the whole thing. that's the job. ✨
  • -h, --help — for help information. bestie behavior. 🙈
  • -n, --name SSNAME — the snapshot's name, and yes it must be specified, it's not optional, don't even try. it follows the general ZFS snapshot name rules, like the max length is 256 bytes, it cannot conflict with the reserved names, and so on. follow the rules, queen. 👑
  • -r, --rsh REMOTE_SHELL — specify a shell to communicate with remote targets. default value is ssh. and heads up, it is the system admin's duty to guarantee that the specified REMOTE_SHELL works well among targets without password authentication. that part's on you, not on her. 💀
  • -t, --timeout TIMEOUT — if the write barrier is on, then TIMEOUT specifies the write barrier's lifetime in second. default value is 30. not minutes. seconds. ⏱️

🌈 AVAILABILITY 🌈

lctl-snapshot-create is part of the lustre(7) filesystem package since release 2.10.0. she's been around, she's experienced, she's a legend. ⭐

💜 SEE ALSO 💜

the whole friend group fr fr 🫶 go read them all, they're all slaying in their own way.

ok that's the page bestie!! this one's from the Lustre girls, dated 2024-08-14, and it lives at LCTL-SNAPSHOT_CREATE(8). mwah, go make some snapshots 💋💖
📦 where this page comes from