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

NAME

6       ipmiutil_ekanalyzer - run FRU-Ekeying analyzer with FRU files
7

SYNOPSIS

9       ipmiutil  ekanalyzer  [-mx  -NPRUEFJTVY] commands (deprecated, see ifru
10       instead)
11
12

DESCRIPTION

14       ipmiutil ekanalyzer is a program that analyzes FRU Ekeying  information
15       from files saved from PICMG IPMI systems.
16
17       This function is disabled by default in ipmiutil-2.9.9 and later.
18
19       ekanalyzer command xx=filename1 xx=filename2 [rc=filename3]
20       NOTE: This command can support a maximum of 8 files per command line
21
22
23       filename1
24              binary file that stores FRU data of a Carrier or an AMC module
25
26
27       filename2
28              binary file that stores FRU data of an AMC module.  These binary
29              files can be generated from this command:
30                   ipmiutil fru -i id -d filename
31
32
33       filename3
34              configuration file used for configuring On-Carrier Device ID  or
35              OEM GUID. This file is optional.
36
37
38       xx     indicates the type of the file. It can take the following value:
39                   oc : On-Carrier device
40                   a1 : AMC slot A1
41                   a2 : AMC slot A2
42                   a3 : AMC slot A3
43                   a4 : AMC slot A4
44                   b1 : AMC slot B1
45                   b2 : AMC slot B2
46                   b3 : AMC slot B3
47                   b4 : AMC slot B4
48                   sm : Shelf Manager
49
50
51

OPTIONS

53       -m 002000
54              Show  FRU  for a specific MC (e.g. bus 00, sa 20, lun 00).  This
55              could be used for PICMG or ATCA  blade  systems.   The  trailing
56              character,  if present, indicates SMI addressing if 's', or IPMB
57              addressing if 'i' or not present.
58
59       -x     Causes extra debug messages to be displayed.
60
61       -N nodename
62              Nodename or IP address of the remote target system.  If a  node‐
63              name  is  specified,  IPMI LAN interface is used.  Otherwise the
64              local system management interface is used.
65
66       -P/-R rmt_pswd
67              Remote password for the nodename given.  The default is  a  null
68              password.
69
70       -U rmt_user
71              Remote  username  for the nodename given.  The default is a null
72              username.
73
74       -E     Use the remote password from Environment variable IPMI_PASSWORD.
75
76       -F drv_t
77              Force the driver type to one of the  followng:  imb,  va,  open,
78              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
79              lan2 with intelplus.  The default is  to  detect  any  available
80              driver type and use it.
81
82       -J     Use   the   specified   LanPlus   cipher   suite  (0  thru  17):
83              0=none/none/none,      1=sha1/none/none,       2=sha1/sha1/none,
84              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
85              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
86
87       -T     Use a specified IPMI LAN  Authentication  Type:  0=None,  1=MD2,
88              2=MD5, 4=Straight Password, 5=OEM.
89
90       -V     Use  a  specified  IPMI  LAN  privilege level. 1=Callback level,
91              2=User level, 3=Operator level, 4=Administrator level (default),
92              5=OEM level.
93
94       -Y     Yes,  do  prompt  the  user  for  the  IPMI LAN remote password.
95              Alternatives for the password are -E or -P.
96
97

COMMANDS

99The available commands for ekanalyzer are:
100
101
103
104       carrier (default) oc=filename1 oc=filename2 ...
105
106              Display point to point physical  connectivity  between  carriers
107              and AMC modules.
108               Example:
109                 # ipmiutil ekanalyzer print carrier oc=fru oc=carrierfru
110                 From Carrier file: fru
111                    Number of AMC bays supported by Carrier: 2
112                    AMC slot B1 topology:
113                       Port 0 =====> On Carrier Device ID 0, Port 16
114                       Port 1 =====> On Carrier Device ID 0, Port 12
115                       Port 2 =====> AMC slot B2, Port 2
116                    AMC slot B2 topology:
117                       Port 0 =====> On Carrier Device ID 0, Port 3
118                       Port 2 =====> AMC slot B1, Port 2
119                 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
120                 From Carrier file: carrierfru
121                    On Carrier Device ID 0 topology:
122                       Port 0 =====> AMC slot B1, Port 4
123                       Port 1 =====> AMC slot B1, Port 5
124                       Port 2 =====> AMC slot B2, Port 6
125                       Port 3 =====> AMC slot B2, Port 7
126                    AMC slot B1 topology:
127                       Port 0 =====> AMC slot B2, Port 0
128                    AMC slot B1 topology:
129                       Port 1 =====> AMC slot B2, Port 1
130                    Number of AMC bays supported by Carrier: 2
131
132
133       power xx=filename1 xx=filename2 ...
134
135              Display  power  supply  information between carrier and AMC mod‐
136              ules.
137
138       all xx=filename xx=filename ...
139
140              Display both physical connectivity and power supply of each car‐
141              rier and AMC modules.
142
143

frushow xx=filename

145       Convert  a  binary  FRU  file  into  human readable text format. Use -v
146       option to get more display information.
147
148

summary [match | unmatch | all]

150
151       match (default) xx=filename xx=filename ...
152              Display only matched results of Ekeying match between an On-Car‐
153              rier device and an AMC module or between 2 AMC modules. Example:
154               # ipmiutil ekanalyzer summary match oc=fru b1=amcB1 a2=amcA2
155               On-Carrier Device vs AMC slot B1
156                AMC slot B1 port 0 ==> On-Carrier Device 0 port 16
157                 Matching Result
158                 From On-Carrier Device ID 0
159                   Channel ID 11 || Lane 0: enable
160                   Link Type: AMC.2 Ethernet
161                   Link  Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet
162              link
163                   Link Group ID: 0 || Link Asym. Match: exact match
164                 To AMC slot B1
165                   Channel ID 0 || Lane 0: enable
166                   Link Type: AMC.2 Ethernet
167                   Link Type extension: 1000BASE-BX (SerDES Gigabit)  Ethernet
168              link
169                   Link Group ID: 0 || Link Asym. Match: exact match
170                 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
171                AMC slot B1 port 1 ==> On-Carrier Device 0 port 12
172                 Matching Result
173                 From On-Carrier Device ID 0
174                   Channel ID 6 || Lane 0: enable
175                   Link Type: AMC.2 Ethernet
176                   Link  Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet
177              link
178                   Link Group ID: 0 || Link Asym. Match: exact match
179                 To AMC slot B1
180                   Channel ID 1 || Lane 0: enable
181                   Link Type: AMC.2 Ethernet
182                   Link Type extension: 1000BASE-BX (SerDES Gigabit)  Ethernet
183              link
184                   Link Group ID: 0 || Link Asym. Match: exact match
185                 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
186               On-Carrier Device vs AMC slot A2
187                AMC slot A2 port 0 ==> On-Carrier Device 0 port 3
188                 Matching Result
189                 From On-Carrier Device ID 0
190                   Channel ID 9 || Lane 0: enable
191                   Link Type: AMC.2 Ethernet
192                   Link  Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet
193              link
194                   Link Group ID: 0 || Link Asym. Match: exact match
195                 To AMC slot A2
196                   Channel ID 0 || Lane 0: enable
197                   Link Type: AMC.2 Ethernet
198                   Link Type extension: 1000BASE-BX (SerDES Gigabit)  Ethernet
199              link
200                   Link Group ID: 0 || Link Asym. Match: exact match
201                 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
202               AMC slot B1 vs AMC slot A2
203                AMC slot A2 port 2 ==> AMC slot B1 port 2
204                 Matching Result
205                 From AMC slot B1
206                   Channel ID 2 || Lane 0: enable
207                   Link Type: AMC.3 Storage
208                   Link Type extension: Serial Attached SCSI (SAS/SATA)
209                   Link  Group  ID: 0 || Link Asym. Match: FC or SAS interface
210              {exact match}
211                 To AMC slot A2
212                   Channel ID 2 || Lane 0: enable
213                   Link Type: AMC.3 Storage
214                   Link Type extension: Serial Attached SCSI (SAS/SATA)
215                   Link Group ID: 0 || Link Asym. Match: FC or  SAS  interface
216              {exact match}
217               *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
218
219       unmatch xx=filename xx=filename ...
220
221              Display  the  unmatched  results of Ekeying match between an On-
222              Carrier device and an AMC module or between 2 AMC modules
223
224       all xx=filename xx=filename ...
225
226              Display both matched result and  unmatched  results  of  Ekeying
227              match between two cards or two modules.
228
229

SEE ALSO

231       ialarms(8)  iconfig(8)  icmd(8)  idiscover(8)  ievents(8)  ifirewall(8)
232       ifru(8) ifruset(8) ifwum(8)  igetevent(8)  ihealth(8)  ihpm(8)  ilan(8)
233       ipicmg(8)  ireset(8)  isel(8)  isensor(8) iserial(8) isol(8) isunoem(8)
234       iwdt(8) ipmiutil(8) ipmi_port(8)
235
236

WARNINGS

238       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
239       and any bug fix list.
240
241
243       Copyright (C) 2009  Kontron America, Inc.
244
245       See  the  file  COPYING  in the distribution for more details regarding
246       redistribution.
247
248       This utility is distributed in the hope that it  will  be  useful,  but
249       WITHOUT ANY WARRANTY.
250
251

AUTHOR

253       Andy Cress <arcress at users.sourceforge.net>
254
255
256
257
258                           Version 1.0: 09 Sep 2010             IEKANALYZER(8)
Impressum