1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
|
.TH IEKANALYZER 8 "Version 1.0: 09 Sep 2010"
.SH NAME
ipmiutil_ekanalyzer \- run FRU-Ekeying analyzer with FRU files
.SH SYNOPSIS
.B "ipmiutil ekanalyzer [-mx -NPRUEFJTVY] commands"
.B (deprecated, see ifru instead)
.SH DESCRIPTION
.I ipmiutil ekanalyzer
is a program that analyzes FRU Ekeying information from files
saved from PICMG IPMI systems.
.br
\fIekanalyzer\fP \fBcommand\fR \fBxx=filename1\fR \fBxx=filename2\fR [\fBrc=filename3\fR]
.br
NOTE: This command can support a maximum of 8 files per command line
.IP "\fIfilename1\fP"
binary file that stores FRU data of a Carrier or an AMC module
.IP "\fIfilename2\fP"
binary file that stores FRU data of an AMC module.
These binary files can be generated from this command:
\fIipmiutil fru \-i id \-d filename\fP
.IP "\fIfilename3\fP"
configuration file used for configuring On-Carrier Device ID or OEM GUID. This file is optional.
.IP "\fIxx\fP"
indicates the type of the file. It can take the following value:
.br
\fIoc\fP : On-Carrier device
.br
\fIa1\fP : AMC slot A1
.br
\fIa2\fP : AMC slot A2
.br
\fIa3\fP : AMC slot A3
.br
\fIa4\fP : AMC slot A4
.br
\fIb1\fP : AMC slot B1
.br
\fIb2\fP : AMC slot B2
.br
\fIb3\fP : AMC slot B3
.br
\fIb4\fP : AMC slot B4
.br
\fIsm\fP : Shelf Manager
.SH OPTIONS
.IP "-m 002000"
Show FRU for a specific MC (e.g. bus 00, sa 20, lun 00).
This could be used for PICMG or ATCA blade systems.
The trailing character, if present, indicates SMI addressing if 's',
or IPMB addressing if 'i' or not present.
.IP "-x"
Causes extra debug messages to be displayed.
.IP "-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.
.IP "-P/-R rmt_pswd"
Remote password for the nodename given. The default is a null password.
.IP "-U rmt_user"
Remote username for the nodename given. The default is a null username.
.IP "-E"
Use the remote password from Environment variable IPMI_PASSWORD.
.IP "-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.
.IP "-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.
.IP "-T"
Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM.
.IP "-V"
Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level.
.IP "-Y"
Yes, do prompt the user for the IPMI LAN remote password.
Alternatives for the password are \-E or \-P.
.SH "COMMANDS"
.RE
.TP
.br
The available commands for ekanalyzer are:
.RE
.RS
.TP
\fIprint\fP [\fBcarrier\fR | \fBpower\fR | \fBall\fR]
.RS
.TP
\fIcarrier\fP (default) \fBoc=filename1\fR \fBoc=filename2\fR \fB...\fR
.br
Display point to point physical connectivity between carriers and AMC modules.
Example:
# ipmiutil ekanalyzer print carrier oc=fru oc=carrierfru
From Carrier file: fru
Number of AMC bays supported by Carrier: 2
AMC slot B1 topology:
Port 0 =====> On Carrier Device ID 0, Port 16
Port 1 =====> On Carrier Device ID 0, Port 12
Port 2 =====> AMC slot B2, Port 2
AMC slot B2 topology:
Port 0 =====> On Carrier Device ID 0, Port 3
Port 2 =====> AMC slot B1, Port 2
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
From Carrier file: carrierfru
On Carrier Device ID 0 topology:
Port 0 =====> AMC slot B1, Port 4
Port 1 =====> AMC slot B1, Port 5
Port 2 =====> AMC slot B2, Port 6
Port 3 =====> AMC slot B2, Port 7
AMC slot B1 topology:
Port 0 =====> AMC slot B2, Port 0
AMC slot B1 topology:
Port 1 =====> AMC slot B2, Port 1
Number of AMC bays supported by Carrier: 2
.TP
\fIpower\fP \fBxx=filename1\fR \fBxx=filename2\fR \fB...\fr
.br
Display power supply information between carrier and AMC modules.
.TP
\fIall\fP \fBxx=filename\fR \fBxx=filename\fR \fB...\fr
.br
Display both physical connectivity and power supply of each carrier and AMC
modules.
.RE
.TP
\fIfrushow\fP \fBxx=filename\fR
.br
Convert a binary FRU file into human readable text format. Use \-v option to get
more display information.
.RE
.RS
.TP
\fIsummary\fP [\fBmatch\fR | \fBunmatch\fR | \fBall\fR]
.RS
.TP
\fImatch\fP (default) \fBxx=filename\fR \fBxx=filename\fR \fB...\fR
.br
Display only matched results of Ekeying match between an On-Carrier device
and an AMC module or between 2 AMC modules. Example:
# ipmiutil ekanalyzer summary match oc=fru b1=amcB1 a2=amcA2
On-Carrier Device vs AMC slot B1
AMC slot B1 port 0 ==> On-Carrier Device 0 port 16
Matching Result
From On-Carrier Device ID 0
Channel ID 11 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
To AMC slot B1
Channel ID 0 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
AMC slot B1 port 1 ==> On-Carrier Device 0 port 12
Matching Result
From On-Carrier Device ID 0
Channel ID 6 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
To AMC slot B1
Channel ID 1 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
On-Carrier Device vs AMC slot A2
AMC slot A2 port 0 ==> On-Carrier Device 0 port 3
Matching Result
From On-Carrier Device ID 0
Channel ID 9 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
To AMC slot A2
Channel ID 0 || Lane 0: enable
Link Type: AMC.2 Ethernet
Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
AMC slot B1 vs AMC slot A2
AMC slot A2 port 2 ==> AMC slot B1 port 2
Matching Result
From AMC slot B1
Channel ID 2 || Lane 0: enable
Link Type: AMC.3 Storage
Link Type extension: Serial Attached SCSI (SAS/SATA)
Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
To AMC slot A2
Channel ID 2 || Lane 0: enable
Link Type: AMC.3 Storage
Link Type extension: Serial Attached SCSI (SAS/SATA)
Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
.TP
\fIunmatch\fP \fBxx=filename\fR \fBxx=filename\fR \fB...\fr
.br
Display the unmatched results of Ekeying match between an On-Carrier device
and an AMC module or between 2 AMC modules
.TP
\fIall\fP \fBxx=filename\fR \fBxx=filename\fR \fB...\fr
.br
Display both matched result and unmatched results of Ekeying match between two
cards or two modules.
.RE
.SH "SEE ALSO"
ialarms(8) iconfig(8) icmd(8) idiscover(8) ievents(8) ifirewall(8)
ifru(8) ifruset(8) ifwum(8) igetevent(8) ihealth(8) ihpm(8)
ilan(8) ipicmg(8) ireset(8) isel(8) isensor(8) iserial(8) isol(8) isunoem(8)
iwdt(8) ipmiutil(8) ipmi_port(8)
.SH WARNINGS
See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list.
.SH COPYRIGHT
Copyright (C) 2009 Kontron America, Inc.
.PP
See the file COPYING in the distribution for more details
regarding redistribution.
.PP
This utility is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY.
.SH AUTHOR
.PP
Andy Cress <arcress at users.sourceforge.net>
.br
|
