era_restore(8)

🎀 era_restore(8) 🎀

💖 System Manager's Manual 💖

✨ NAME ✨

okay so era_restore is the tool that restores era metadata to a device or file 🧚 it's giving restore-your-data-bestie energy 💅

🦋 SYNOPSIS 🦋

era_restore [options] -i {xml file} -o {device|file}

💜 DESCRIPTION 💜

bestie, era_restore takes era metadata that a device-mapper target dumped into an XML formatted file (check out era_dump(8) for that part 🍓) and restores it. You can optionally preprocess the file before the restore goes to another device or file. 🫶 If you restore it onto a metadata device, the device-mapper target can then process that metadata, and it's literally so iconic 👑

⚠️ This tool cannot be run on live metadata. Do NOT try it on live metadata, it will not slay 💀

🌸 OPTIONS 🌸

• -h, --help — the help menu 🙈 prints it and then it exits
• -V, --version — shows you which version you're on, then it exits ✨
• -q, --quiet — shhh 🤫 it won't print anything at all. If you want to know whether it worked, check the exit code instead
• -i, --input {xml file} — tells it which XML file has your metadata inside 📄
• -o, --output {device|file} — the device or file where the restored binary metadata is going to land 🎯
  • heads up, if you pick a file, it has to be preallocated and big enough to hold the metadata 😭 no shortcuts, bestie

🎀 EXAMPLE 🎀

okay so this one restores the XML formatted era metadata in the file metadata onto the logical volume /dev/vg/metadata, so the device-mapper target can process it later 🧚

$ era_restore -i metadata -o /dev/vg/metadata

🔥 DIAGNOSTICS 🔥

era_restore returns an exit code of 0 when it succeeds and 1 when something goes wrong 💅 so 0 means slay and 1 means regroup 💀

🦋 SEE ALSO 🦋

era_dump(8), era_check(8) 🫶

👑 AUTHOR 👑

Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>

Bye bestie, go restore your metadata and be iconic 🌈💖✨ (Device Mapper Tools, System Manager's Manual 🎀)