px2_configure(1p)

📦
version 4.3.14 · 6 versions
, in ubuntu stonking

💖 px2_configure — the group chat for your PDU fleet 💖

okay so. bestie. you have a pile of Raritan PX2/PX3 power distribution units and you're out here configuring them one by one like it's 2009? no. put the browser down. this is px2_configure, from the User Contributed Perl Documentation, manual section 1p, and it is literally going to deploy and configure your whole rack for you. ✨

✨ SYNOPSIS ✨

px2_configure COMMAND [ARGUMENTS]

🦋 DESCRIPTION 🦋

PX2 deployment and configuration utility. that's the whole vibe: you point it at a device list, it goes and does the thing. 🫶

👑 COMMANDS 👑

configure LIST IPS

Configure some or all devices (network settings, unit name and SNMP settings).

the tea here is that this command behaves differently depending on whether you hand it concrete IP addresses or the all keyword, and this is the part everyone gets wrong, so listen up:

  • If IP addresses are specified, the program will contact each device, read its serial number and search for a matching entry in the device list. Then it changes the device's network settings to the values from the device list. plot twist: the initial IP addresses do not have to match the values from the device list — they might just as well be dynamically assigned by a DHCP server. it's giving "come as you are, leave as your assigned self." 💅
  • If the all keyword is specified, the IP addresses are taken from the device list. The devices' network settings are expected to be properly configured at this point, so the network configuration part will be skipped. up front and honest of it, honestly.

verify LIST IPS

Verify device settings and SNMP access. the vibe check. 🔥

identify LIST IPS

Identify some or all devices (show a distinctive string for two seconds in each unit's display). yes it flashes a lil something on the screen so you can find the physical box. iconic.

reboot LIST IPS

Reboot some or all devices. sometimes you just gotta turn it off and on again, no cap. 😭

fetch_fitness LIST OUTFILE IPS

Fetch fitness data from some or all devices and write them to a file in CSV format. your devices are going to the gym and this collects the receipts. 💪

update LIST IMAGE IPS

Device firmware update. The firmware image will be sequentially uploaded to each device, then all devices will be instructed to perform the firmware update in parallel. so: uploads one at a time, then everyone jumps at once. coordinated. main character energy. 👑

ngl, this is a firmware update on real hardware. be sure. be very sure.

Print list of supported timezones with its IDs. the ID list you're gonna need for set_timezone. iykyk. 🌍

set_timezone LIST TZID IPS

Set the timezone of all devices.

🌸 ARGUMENTS 🌸

  • LIST — Device list in CSV format.
  • IPS — Device IP addresses; use all to run on all IPs in the CSV file.
  • IP — Device IP address. (yes, singular. one. just one. 🙈)
  • OUTFILE — Output file name.
  • IMAGE — Firmware image file.
  • TZID — Timezone ID as printed by the print_timezones command.

🎀 EXAMPLES 🎀

px2_configure configure devices.csv 192.168.2.3

Connect to the device at 192.168.2.3, read its serial number and look it up in the device list file named devices.csv. Then configure the device's network, PDU name and SNMP settings.

px2_configure verify devices.csv all

Verify the network settings, PDU name and SNMP access for all devices in the list file.

px2_configure update devices.csv pdu-px2-020106-26030.bin all

Update all devices to firmware version 2.1.6.

🍓 DEVICE LIST FORMAT 🍓

The device list file contains a list of PX2 devices in CSV format. It could e.g. be exported from an inventory spreadsheet. Each device line contains four or five fields, separated by commas:

  1. Unit serial number (exactly 10 characters)
  2. PDU name
  3. IP address with prefix length (e.g. 192.168.99.1/24)
  4. Gateway IP address
  5. Optional comment; the line is ignored if ignore is included here

Lines with less than four fields are silently ignored. Likewise, lines that do not contain a valid serial number are disregarded. no drama, no error message, they just don't exist anymore. 💀

🌈 REQUIREMENTS 🌈

The following Perl modules are required to run this script:

Additionally, the verify command uses the snmpget utility to verify SNMP access. so go install net-snmp, bestie, don't make verify sad. 🥺

⭐ one last thing ⭐

this whole thing is running on perl v5.40.1, dated 2026-08-08, and it says px2_configure(1p) right at the top and bottom of the page like a lil signature. go forth and configure. slay. 💅💖🦋

📦 where this page comes from