vzsplit(8)

📦 version 4.9.4, in ubuntu jammy

💖 vzsplit — the vibe of splitting your Hardware Node into cute equal lil containers 💖

okay so bestie, listen up — this is vzsplit from the Containers manual, section 8. It's giving "I want N containers and I want them to share nicely" energy, and honestly? Iconic. 🫶

✨ NAME ✨

vzsplit — generate a sample container configuration file 💅

🌸 SYNOPSIS 🌸

vzsplit [-n numve] [-f conf_name] [-s swapsize] [-v yes|no]

🦋 DESCRIPTION 🦋

So the whole point of the vzsplit utility is that it splits the Hardware Node into equal parts. Like, divvying up the resources so everyone gets their lil slice. 🍰

It generates a full set of system resource control parameters for the given number of containers. And where do those numbers come from? The values are calculated from:

  • the total physical memory of the Hardware Node the utility runs on, and
  • the number of containers the Hardware Node shall be able to run even if the given number of containers consume all the resources available.

No cap, it does the math for you so you don't have to. ✨

If you run it with no options at all, vzsplit just prompts you for the desired number of containers and then outputs the resulting resource control parameters to stdout. Easy peasy. 🎀

⚠️ But listen — if there are not enough system resources to run the specified number of containers, an appropriate message is shown and the sample configuration file is not generated. So like, it will not manifest a config out of thin air. Sorry bestie. 😭

🎀 OPTIONS 🎀

  • -n numve — specify the number of containers. This is the "how many slices do you want" question. 🍕
  • -f conf_name — specify the configuration sample name to write configuration to, instead of standard output. The file created will be named /etc/vz/conf/ve-conf_name.conf-sample. So like, your conf_name gets slotted in right there. 💾
  • -s swapsize — specify the swap size in Kbytes. If this option is not given, the swap size is read from /proc/meminfo. Reading it yourself? So independent. 👑
  • -v yes|no — whether to generate VSwap enabled configuration. Default is auto-detect by checking if running kernel is VSwap capable; this option overrides auto-detection. So if you pass it, you're the main character and the auto-detect is just standing there. 💅

⭐ EXIT STATUS ⭐

  • vzsplit returns 0 upon a successful execution. Slay. ✨
  • If anything goes wrong, it returns 1. 💀

🌈 SEE ALSO 🌈

ctid.conf(5) — go read that one next, bestie. iykyk. 🫶

👑 LICENSE 👑

Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL. Respect the elders. 🙈

and that's the whole page, fr fr 💖 This lil beauty comes to you from OpenVZ, dated 18 Mar 2012, and it lives its life as vzsplit(8) in the Containers manual. Obsessed with her, honestly. Periodt. 🌸🦋🎀

📦 where this page comes from