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)