BKR-SYSTEM-MODIFY(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 bkr-system-modify — bestie edition 💅

So this is a page from the Beaker manual, section 1, and it's all about bkr-system-modify — the glow-up tool for your systems. Let's get into it, no cap.

🌸 NAME 🌸

bkr-system-modify — like, it modifies your system attributes. That's the whole gig. Slay.

✨ SYNOPSIS ✨

bkr system-modify [options] <fqdn> ..

Yeah, options first, then one or more fully-qualified domain names. Give it the fqdns, bestie. It wants them.

💖 DESCRIPTION 💖

Modify attributes of Beaker systems. Iconic of it, honestly.

New in version 0.19. She's been around a minute. 👑

🎀 OPTIONS 🎀

Ok so here's the whole menu of flags. Every single one, because I would never do you dirty by skipping any.

  • --owner <username> — Change the system owner to <username>. New owner, who dis.
  • --condition <condition> — Change the system condition to <condition>. Valid values are Automated, Manual, Broken, and Removed. Vibe check on your system's whole state, basically.
  • --host-hypervisor <type> — Change the system's host hypervisor type to <type>. For systems which are virtualized, this field indicates which virtualization technology is used by the host. An empty value indicates that the system is bare metal (not a virtual guest). So like, empty = raw dogging the hardware, essentially. 🦋
  • --pool-policy <poolname> — Change the active access policy to that of the system pool <pool>. The system must be in the pool to use its policy. This must be specified only once, and is mutually exclusive with --use-custom-policy. Pick a lane, bestie 💅
  • --use-custom-policy — Change the active access policy to that of the system's custom access policy. This must be specified only once, and is mutually exclusive with --pool-policy. Also one-time-only, also this-or-that. No doubling up.
  • --location <location> — Physical location of the system. Where your box actually physically is. Yes, real places. Wild, I know.
  • --power-type <power-type> — Remote power control type. This value must be a valid power type configured by the Beaker administrator (or one of the Beaker defaults). So don't just freestyle it, mmkay?
  • --power-address <power-address> — Address passed to the power control script.
  • --power-user <power-user> — Username passed to the power control script.
  • --power-password <power-password> — Password passed to the power control script. (Yes it's on the command line. Yes I know. That's what the page says. 🙈)
  • --power-id <power-id> — Unique identifier passed to the power control script. The meaning of the power ID depends on which power type is selected. Typically this field identifies a particular plug, socket, port, or virtual guest name. So it's like the specific thing to grab, iykyk.
  • --power-quiescent-period <seconds> — Quiescent period for power control. Beaker will delay at least this long between consecutive power commands. Give the power script a little nap. Nap era. 😴
  • --release-action <release-action> — Action to take whenever a reservation for this system is returned: PowerOff, LeaveOn, ReProvision. Three options, choose wisely.

Common bkr options are described in the Options section of bkr(1). Go read that one too, that's your homework. 🫶

⭐ EXIT STATUS ⭐

Non-zero on error, otherwise zero. Classic. If it's not zero, something went sideways — that's your cue.

🌈 EXAMPLES 🌈

Modify the owner of a particular system to jdoe:

bkr system-modify --owner jdoe test.system.fqdn

Change the active access policy of the system to use mypool's policy:

bkr system-modify --pool-policy mypool test.system.fqdn

Both iconic, both valid, both literally just copy-paste material. 💜

🦋 SEE ALSO 🦋

  • bkr(1) — the mothership. Everything else lives there.

👑 AUTHOR 👑

The Beaker team <beaker-devel@lists.fedorahosted.org> — absolute legends, fr fr.

2013-2025 Red Hat, Inc.

And that's the tea, bestie 🍓 This was Beaker manual page 29.2, dated May 26, 2025 — bkr-system-modify(1), page one of the section one girlies. Now go modify some systems and be the main character of your own cluster. 💅✨🎀

📦 where this page comes from