1IFRU(8)                     System Manager's Manual                    IFRU(8)
2
3
4

NAME

6       ipmiutil_fru - show Field Replacable Unit configuration data
7

SYNOPSIS

9       ipmiutil fru [-abcdeikmsvx -N node -U user -P/-R pswd -EFJTVYZ]
10
11

DESCRIPTION

13       ipmiutil  fru is a program that uses IPMI commands to show FRU configu‐
14       ration data and optionally write an asset tag string into the FRU data.
15       Setting  the asset tag is a function that can be used to uniquely iden‐
16       tify the unit, even if the storage  devices  are  removed  or  changed.
17       This  utility  can  use either the /dev/ipmi0 driver from OpenIPMI, the
18       /dev/imb driver from  Intel,  the  /dev/ipmikcs  driver  from  valinux,
19       direct user-space IOs, or the IPMI LAN interface if -N.
20
21

OPTIONS

23       Command line options are described below.
24
25       -a asset_string
26              This  option  specifies an asset tag string to be written to the
27              baseboard FRU Product area.  The asset tag length is limited  by
28              the  existing  FRU Product data, but is usually allowed up to 16
29              characters.  The default is to not modify this FRU field.
30
31       -b     Only show the Baseboard FRU data.  The default  behavior  is  to
32              also  scan  for  any SDR FRU data or DIMM SPD data referenced by
33              the SDRs.
34
35       -c     Show FRU output in a canonical format, with a default  delimiter
36              of '|'.
37
38       -d file
39              Dump binary FRU data to the specified file.
40
41       -e     Show Every FRU output in a bladed chassis, including those under
42              child MCs.  The default is to show FRUs referred to by just  the
43              target MC.
44
45       -i 00  This  option  specifies  a  specific  FRU ID to show.  The input
46              value should be in hex (0b, 1a, etc.), as shown from the  sensor
47              SDR  output.   By default, all FRU IDs that are specified in the
48              FRU locator SDRs are shown.
49
50       -k <setsn | setmfgdate | nextboot>
51              These Kontron OEM functions set FRU data based on existing  data
52              stored elsewhere.  The setsn option sets the FRU Board and Prod‐
53              uct serial number, and the setmfgdate option sets the FRU  Board
54              Mfg DateTime.  The nextboot option specifies the boot device for
55              the next boot: BIOS, FDD, HDD, CDROM, or network.  These options
56              are  only supported on Kontron ATCA boards which have this func‐
57              tionality.
58
59       -m 002000
60              Show FRU for a specific MC (e.g. bus 00, sa 20, lun  00).   This
61              could  be  used  for  PICMG or ATCA blade systems.  The trailing
62              character, if present, indicates SMI addressing if 's', or  IPMB
63              addressing if 'i' or not present.
64
65       -s serial_num
66              This  option  specifies  a serial number string to be written to
67              the baseboard FRU Product area.  The serial number  can  be  any
68              string  up  to 16 characters.  The default is to not modify this
69              FRU field.
70
71       -v prod_ver
72              This option specifies a product  version  number  string  to  be
73              written  to  the baseboard FRU Product area.  The version number
74              can be any string up to 16 characters.  The default  is  to  not
75              modify this FRU field.
76
77       -x     Causes eXtra debug messages to be displayed.
78
79       -N nodename
80              Nodename  or IP address of the remote target system.  If a node‐
81              name is specified, IPMI LAN interface is  used.   Otherwise  the
82              local system management interface is used.
83
84       -U rmt_user
85              Remote  username  for the nodename given.  The default is a null
86              username.
87
88       -P/-R rmt_pswd
89              Remote password for the nodename given.  The default is  a  null
90              password.
91
92       -E     Use the remote password from Environment variable IPMI_PASSWORD.
93
94       -F drv_t
95              Force  the  driver  type  to one of the followng: imb, va, open,
96              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
97              lan2  with  intelplus.   The  default is to detect any available
98              driver type and use it.
99
100       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
101              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
102              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
103              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
104
105       -T     Use  a  specified  IPMI  LAN Authentication Type: 0=None, 1=MD2,
106              2=MD5, 4=Straight Password, 5=OEM.
107
108       -V     Use a specified IPMI  LAN  privilege  level.  1=Callback  level,
109              2=User level, 3=Operator level, 4=Administrator level (default),
110              5=OEM level.
111
112       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
113              Alternatives for the password are -E or -P.
114
115       -Z     Set the slave address for a local MC
116
117
118

SEE ALSO

120       ipmiutil(8)   ialarms(8)  iconfig(8)  icmd(8)  idiscover(8)  ievents(8)
121       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
122       isol(8) iwdt(8)
123
124

WARNINGS

126       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
127       and any bug fix list.
128
129
131       Copyright (C) 2009  Kontron America, Inc.
132
133       See the file COPYING in the distribution  for  more  details  regarding
134       redistribution.
135
136       This  utility  is  distributed  in the hope that it will be useful, but
137       WITHOUT ANY WARRANTY.
138
139

AUTHOR

141       Andy Cress <arcress at users.sourceforge.net>
142
143
144
145
146                           Version 1.4: 09 Sep 2010                    IFRU(8)
Impressum