XEN-RESIZE-GUEST(8)

📦
version 4.9.2 · 4 versions
, in debian bookworm, ubuntu noble

💖 XEN-RESIZE-GUEST 💖

okay bestie, so xen-resize-guest is this lil script from the Perl Programmers Reference Guide and it is literally here to resize a loopback or LVM based xen guest 🦋 no cap.

✨ SYNOPSIS ✨

xen-resize-guest [options]

Help Options:
 --help     Show help information.
 --manual   Read the manual for this script.
 --version  Show the version information and exit.
 --verbose  Show diagnostic output.

General Options:
 --add      Specify the amount of space to add, e.g. --add=1gb
 --dir      Specify the path to the loopback image root.
 --force    Force the resize to happen without a last-chance delay.
 --hostname Specify the hostname of the guest to resize.

like… it's giving "run me with flags, I'll handle the rest" 💅

🎀 OPTIONS 🎀

  • --add — tell it how much storage you wanna add to the primary disk, periodt.
  • --dir — the directory where all the loopback files live. point me there bestie 📁
  • --force — skip the lil pause, don't sit there for 10 seconds before it starts. it just goes. 🔥
  • --help — show help information. the classic. the icon.
  • --hostname — specify the hostname to delete. (yes, that's what it says 💀)
  • --lvm — specify the volume group to use.
  • --manual — read the manual for this script. very meta, very self-aware 👑
  • --version — show the version number and exit.

🌸 DESCRIPTION 🌸

okay so real talk: this tool exists to ease the resizing of Xen guests, whether they're based upon loopback files or LVM partitions 🫶

and like, yes, resizing a guest is pretty simple on paper, but doing the steps correctly in the right order is lowkey fiddly. the way that one wrong move ruins your whole afternoon 😭

here's the order, bestie, do not freestyle it:

  1. Shutdown the guest.
  2. Unmount the volume, if it is mounted.
  3. Add to the space.
  4. Check the filesystem.
  5. Resize the filesystem.
  6. Restart the guest.
and ngl, more than once the author has heard of users making mistakes and breaking their filesystems 💀 hence this tool. so yeah, this whole script is basically the responsible friend holding your hand. use it.

👑 AUTHORS 👑

📜 LICENSE 📜

Copyright (c) 2005-2009 by Steve Kemp, (c) 2010 by The Xen-Tools Development Team. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.

and that's the whole thing, bestie 💖 this was version 4.9.2, dated 2023-02-06, straight outta the Perl Programmers Reference Guide ✨ go resize something responsibly, mwah 💅🌈

📦 where this page comes from