ICONFIG(8)

💖 ICONFIG(8) — ipmiutil_config 💖

okay bestie, gather round — this is the ipmiutil_config page from the System Manager's Manual, and yes it's an admin-section (8) page, so we're in our sysadmin era. 🫶

✨ NAME ✨

ipmiutil_config — list, save, and restore BMC configuration parameters 🎀

🌸 SYNOPSIS 🌸

ipmiutil config [-lpxLNUPREFJTVY] [-r file] [-s file]

🦋 DESCRIPTION 🦋

So ipmiutil config is this little icon that uses an IPMI driver to yeet IPMI commands at your box so it can list, save, and restore BMC configuration parameters for LAN, Serial, PEF, SOL, User, and Channel. It's literally the glow-up fusion of ipmiutil lan (aka ilan) and ipmiutil serial (aka iserial) — two icons in one, we love a collab. 💅

⚠️ heads up bestie: some of the LAN parameters cannot be restored remotely over the IPMI LAN, because that would be changing the configuration that is in use. It's giving "can't edit the floor while you're standing on it." 😭

This utility can use any of these drivers, whichever one you've got:

• the /dev/ipmi0 driver from OpenIPMI
• the /dev/imb driver from Intel
• the /dev/ipmikcs driver from valinux
• direct user-space IOs
• or the IPMI LAN interface, if you pass -N

👑 OPTIONS 👑

Command line options are described below. (Yes, every single one. We don't skip. ✨)

• -l — Lists BMC configuration parameters with a keyword, an index, and its hex values. This is the default behavior if you specify no options at all. It's the "just show me everything" vibe. 🔍
• -r config_file — Restores BMC configuration from config_file, which is a file that was produced with -s below. Glow-up reversal. 💫
• -s config_file — Saves BMC configuration to config_file. This file could be edited, in certain cases, such as to vary the BMC IP address (LanParam 3), or to use the UserPassword records. Note that lines beginning with # are comments and are ignored. For editing UserPassword records, convert your text value to hex format; for example "echo 'mypassword' |od -t x1", and leave off the trailing 0a. (yes the quoting is weird, it's what the page says, copy it exactly bestie) 📝
• -x — Causes extra debug messages to be displayed. Spill the tea, icon. 🐛
• -p password_to_set — This specifies the firmware password to set for BMC LAN access for all users during the restore. If not specified, the password configuration will not be changed, unless a valid UserPassword record is present in the file to be restored. Note that user passwords are write-only via standard IPMI commands — you can set 'em, you just can't read 'em back. 🙈
• -L lan_ch_num — This specifies the IPMI LAN channel number used for BMC LAN. This varies by platform, and can be found in the platform technical specifications. By default, bmcconfig scans all IPMI channels to find a LAN channel for BMC LAN. 🔎
• -N nodename — Nodename or IP address of the remote target system. If a nodename is specified, the IPMI LAN interface is used. Otherwise the local system management interface is used. 🛰️
• -P/-R rmt_pswd — Remote password for the nodename given. The default is a null password. 🔑
• -U rmt_user — Remote username for the nodename given. The default is a null username. 🪪
• -E — Use the remote password from Environment variable IPMI_PASSWORD. 🌱
• -F drv_t — Force the driver type to one of the followng: imb, va, open, gnu, landesk, lan, lan2, lan2i, kcs, smb. Note that lan2i means lan2 with intelplus. The default is to detect any available driver type and use it. 🚗
• -J — Use the specified LanPlus cipher suite (0 thru 17): 0=none/none/none, 1=sha1/none/none, 2=sha1/sha1/none, 3=sha1/sha1/cbc128, 4=sha1/sha1/xrc4_128, 5=sha1/sha1/xrc4_40, 6=md5/none/none, ... 14=md5/md5/xrc4_40. Default is 3. 🔐
• -T — Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM. 🎫
• -V — Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level. 👑
• -Y — Yes, do prompt the user for the IPMI LAN remote password. Alternatives for the password are -E or -P. 🙋‍♀️

🌈 SEE ALSO 🌈

ipmiutil(8) ialarms(8) icmd(8) idiscover(8) ievents(8) ifru(8) igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8) isol(8) iwdt(8)

(the whole friend group, fr fr) 🫂

💀 WARNINGS 💀

See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list. 👀

🎀 COPYRIGHT 🎀

Copyright (C) 2009 Kontron America, Inc.

See the file COPYING in the distribution for more details regarding redistribution.

This utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. 😤

💜 AUTHOR 💜

Andy Cress <arcress at users.sourceforge.net>

okay that's the whole page, you ate it, no crumbs. ✨ Version 1.4: 17 Feb 2010 — iconic behavior honestly 💅🌸🦋