XEN-DELETE-IMAGE(8)

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

💖 xen-delete-image — the manual, but make it make sense 💖

okay bestie, gather round, because this one is the manual page for xen-delete-image, part of the Perl Programmers Reference Guide set of pages (the (8) bit means it's a sysadmin-y command, iykyk). It's a little Perl script, and honestly? It's giving "cleanup era." ✨

✨ NAME ✨

xen-delete-image — delete previously created Xen instances. 💅

Like. It deletes them. That's the whole job. She's simple, she's efficient, she's an icon.

🦋 SYNOPSIS 🦋

xen-delete-image [options] [--hostname=]imageName1 [--hostname=]imageName2

And here's the full menu of flags, grouped exactly how the script groups them:

Filename Options:

  • --extension — specify the file extension to use. An empty extension is equal to any extension.

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:

  • --dir — specify the output directory where images were previously saved.
  • --evms — specify the EVMS container to use.
  • --lvm — specify the LVM volume to use.
  • --zpool — specify the ZFS pool to use.

Specifying hosts:

  • --hostname — specify the image name to delete.

Testing options:

  • --test — don't complain if we're not invoked by root.

🎀 OPTIONS 🎀

  • --dir — specify the output directory where images were previously saved. 🗂️
  • --evms — specify the EVMS container where images were previously saved.
  • --help — show help information.
  • --hostname — specify the hostname to delete.
  • --lvm — specify the LVM volume group where images were previously saved.
  • --zpool — specify the ZFS pool where images were previously saved.
  • --manual — read the manual for this script.
  • --test — do not complain, or exit, if the script is not executed by the root user. (Only works in conjunction with --dir.) 👀
  • --version — show the version number and exit.

🌸 DESCRIPTION 🌸

xen-delete-image is a simple script which allows you to delete Xen instances which have previously been created by xen-create-image. It's the reverse uno card of the xen-tools family. 🔥

You must be root to run this script as it removes the Xen configuration file from /etc/xen and potentially removes LVM and EVMS volumes. No root, no deletion, no exceptions, bestie.

(When invoked with the --test flag the script will continue running, but will fail to remove anything which the user does not have permission to delete.)

🌈 LOOPBACK EXAMPLE 🌈

Let's say you have three images — 'foo', 'bar', and 'baz' — stored beneath /home/xen. The first two may be deleted via:

xen-delete-image --dir=/home/xen foo bar

You may also delete them by running:

xen-delete-image --dir=/home/xen --hostname=foo --hostname=bar

Both routes, same destination. Choose your fighter. 🫶

(The matching Xen configuration files beneath /etc/xen will also be removed.)

💜 LVM EXAMPLE 💜

Now let's say you have the volume group 'skx-vol' containing three Xen instances — 'foo', 'bar', and 'baz'. The first two may be deleted via:

xen-delete-image --lvm=skx-vol foo bar

This will remove the volumes 'foo-disk', 'foo-swap', 'bar-disk', and 'bar-swap'. Four volumes, one command, absolutely ate. 💅

Note that if the images were created with --noswap then the swap volumes will not be present, so will not need to be deleted.

The Xen configuration files will also be removed from beneath /etc/xen.

🧚 EVMS EXAMPLE 🧚

And finally, say you have the container 'mycontainer' containing three Xen instances — 'foo', 'bar', and 'baz'. The first two may be deleted via:

xen-delete-image --evms=lvm2/mycontainer --hostname=foo --hostname=bar

This will remove the volumes 'foo-disk', 'foo-swap', 'bar-disk', and 'bar-swap'.

Note that if the images were created with --noswap then the swap volumes will not be present, so will not need to be deleted.

The Xen configuration files will also be removed.

👑 AUTHORS 👑

These are the legends who built her:

⭐ LICENSE ⭐

Copyright (c) 2005-2009 by Steve Kemp, (c) 2010-2013 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.

okay that's the whole page, you're officially certified in xen-delete-image 💖 this is from version 4.9.2, dated 2023-02-06, and it's part of the Perl Programmers Reference Guide — go forth and delete responsibly, bestie, and remember: root only, no cap. 🎀✨

📦 where this page comes from