NAME

       ipmiutil_config - list, save, and restore BMC configuration parameters

SYNOPSIS

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

DESCRIPTION

       ipmiutil  config is a program that uses an IPMI driver to send IPMI commands which list, save and restore
       BMC configuration parameters for LAN, Serial, PEF, SOL, User, Channel.  This combines  the  functionality
       of  ipmiutil  lan  (ilan)  and ipmiutil serial (iserial).  Note that some of the LAN parameters cannot be
       restored remotely over the IPMI LAN, changing the configuration that is in use.   This  utility  can  use
       either  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 -N.

OPTIONS

       Command line options are described below.

       -l     Lists BMC configuration parameters with a keyword, index, and its hex values.  This is the default
              behavior if no options are specified.

       -r config_file
              Restores BMC configuration from config_file, which was produced with -s below.

       -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.

       -x     Causes extra debug messages to be displayed.

       -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.

       -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,  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)

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>

                                            Version 1.4: 17 Feb 2010                                  ICONFIG(8)