DRMGR(8)

🌸 DRMGR(8) 🌸

Hey bestie!! 💖 You're looking at DRMGR(8) from the Linux on Power Service Tools manual — aka the page for drmgr, the DLPAR resource-management girlie for a virtualized ppc64 system. Grab a strawberry drink 🍓, we’re going in.

🎀 NAME 🎀

drmgr — manage DLPAR resources of a virtualized ppc64 system. 💅

✨ SYNOPSIS ✨

Okay so the synopsis is literally giving choose-your-own-adventure:

drmgr [-d detail_level] [-w minutes] [-C|--capabilities] [-h|--help]

drmgr -c {pci | cpu | mem | port | slot | phb}

drmgr -c pci -s slot_location_code {-i | -a | -r | -R } [-I]

drmgr -c cpu {-a | -r} {-q quantity | -s {drc_index | drc_name}}

drmgr -c mem {-a | -r} {-q quantity | -s {drc_index | drc_name}}

drmgr -c {port | slot | phb} {-a | -r} -s {drc_index | drc_name}

🌈 DESCRIPTION 🌈

drmgr is a utility for managing logical and physical hot plug capable resources of a PowerVM LPAR or QEMU/KVM pSeries virtual machine via Dynamic Logical Partitioning (DLPAR) operations. Outside of hot plugging a physical PCI I/O slot, the drmgr utility is intended to be invoked remotely by a Hardware Management Console (HMC), or by a local monitoring daemon in response to a hotplug interrupt from the controlling hypervisor. Iykyk 👀✨

⚠️ Unless you were directed by IBM support, or you’re performing a PCI hotplug operation, use caution invoking drmgr from the command line — it can result in inconsistent state between the LPAR and management system. That’s a real warning, bestie, not a vibe check. 💀

✨ OPTIONS ✨

Main-character flags, periodt:

• -d detail_level — set the logging verbosity level. That’s the “how much detail do you want” dial.
• -w timeout — specify a timeout in minutes to wait on acquiring the dynamic resource lock. The synopsis spells the argument as minutes, just so you know what’s up.
• -C, --capabilities — display the DLPAR capabilities of the logical partition. Cute little capability reveal ✨
• -c drc_type — dynamic reconfiguration connector type to act upon, from this exact list: pci, cpu, mem, port, slot, phb.

Heads-up, bestie: -h / --help shows up in the synopsis up top, but the OPTIONS section doesn’t give it its own separate bullet here — so I’m not inventing extra deets. 🫶

drmgr -c pci -s slot_location_code {-i | -a | -r | -R} [-I]

This mode is for adding, removing, identifying, or replacing a physical PCI adapter. Iconic PCI hotplug behavior, no cap 💅

• -s slot_location_code — the physical slot location code to act upon.
• -i — identify the specified slot_location_code by turning on its visual indicator LED.
• -R — interactively replace the physical PCI adapter, with slot_location_code, by turning on the visual indicator LED to locate the physical slot, then powering down the slot so the current card can be removed, and finally powering the slot back up after the new adapter has been inserted into the slot.
• -r — interactively remove a physical PCI adapter, from slot_location_code, by turning on the visual indicator LED to locate the physical slot, and then powering down the slot so the current card can be removed.
• -a — interactively add a physical PCI adapter, to slot_location_code, by turning on the visual indicator LED to locate the physical slot, and then powering up the slot once the new adapter has been inserted into the slot.
• -I — do not perform the identify step during interactive add, remove, or replacement operations.

drmgr -c cpu {-s {drc_index | drc_name} | -q count} {-a | -r}

Add or remove logical cpus from the system. CPU hotplug era 💖

• -s drc_index | drc_name — the dynamic reconfiguration connector (DRC) index or name is used to identify one specific CPU on which to perform the requested DLPAR operation.
• -q quantity — specify a quantity of CPUs on which to perform the requested DLPAR operation.
• -a — perform a DLPAR CPU(s) add operation.
• -r — perform a DLPAR CPU(s) remove operation.

drmgr -c mem {-s {drc_index | drc_name} | -q count} {-a | -r}

Add or remove logical memory blocks (LMBs) from the system. Memory hotplug bestie 🧠✨

• -s drc_index | drc_name — the dynamic reconfiguration connector (DRC) index or name is used to identify one specific logical memory block (LMB) on which to perform the requested DLPAR operation.
• -q quantity — specify a quantity of LMBs on which to perform the requested DLPAR operation.
• -a — perform a DLPAR LMB(s) add operation.
• -r — perform a DLPAR LMB(s) remove operation.

drmgr -c {port | slot | phb} {-a | -r} -s {drc_index | drc_name}

Add or remove a logical IOA resource such as virtualized storage and network adapters, or a logical PCI Host Bus that physical PCI devices reside under, including hotpluggable slots. It’s giving infrastructure main character energy 👑

• -s drc_index | drc_name — the dynamic reconfiguration connector (DRC) index or name is used to identify the logical resource on which to perform the associated DLPAR operation.
• -a — perform a DLPAR add operation of the specified logical resource type.
• -r — perform a DLPAR remove operation of the specified logical resource type.

👑 AUTHOR 👑

drmgr was written by IBM Corporation. Shoutout, fr fr 🫶

🦋 SEE ALSO 🦋

• go read lsslot(8)
• and also drmgr-hooks(8)

---

💖 That’s the manual, bestie — this DRMGR(8) page’s source/version is Linux, and it’s dated June 2020. Go forth and DLPAR responsibly, mwah! 🎀✨