ipmitool中文
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
Sensor Types:
Temperature Voltage
Current Fan
Physical Security Platform Security
Processor Power Supply
Power Unit Cooling Device
Other Memory
Drive Slot / Bay POST Memory Resize
System Firmwares Event Logging Disabled
Watchdog System Event
Critical Interrupt Button
Module / Board Microcontroller
Add-in Card Chassis
Chip Set Other FRU
Cable / Interconnect Terminator
System Boot Initiated Boot Error
OS Boot OS Critical Stop
Slot / Connector System ACPI Power State
Watchdog Platform Alert
Entity Presence Monitor ASIC
LAN Management Subsystem Health
Name名字 Synopsis概要Description描述Options选项 SECURITY安全 COMMANDS指令集 OPEN INTERFACE开放接口 BMC INTERFACE LIPMI INTERFACE LAN INTERFACE Name(名字)
Ipmitool —— 对于控制支持IPMI的设备有效.
Synopsis（概要）
ipmitool [-c|-h|-v|-V] -I open
ipmitool [-c|-h|-v|-V] -I lan -H
[-p
[-U
[-A
[-L
[-a|-E|-P|-f
[-o
ipmitool [-c|-h|-v|-V] -I lanplus -H
[-p
[-U
[-L
[-a|-E|-P|-f
[-o
[-C
Description(描述)
这个程序能够使你通过一个kernel设备驱动或者一个远程系统，利用IPMI v1.5或IPMIv2.0 来 管理本地系统的任何一个智能平台管理接口（IPMI)功能。这些功能包括打印FRU（现场可替换装置）信息、LAN配置、传感器读数、以及远程机架电源控制。
一个本地系统接口的IPMI管理功能需要一个兼容IPMI的kernel驱动程序被安装以及配置。在linux中，这个驱动叫做OpenIPMI，他被包括在了标准化分配中。在Solaris系统中，这个驱动叫做BMC，他被包括在了Solaris 10中。远程控制的管理需要授权以及配置IPMI-over-LAN接口。根据每个系统独特的需要，它可以通过系统接口来使LAN接口使用 ipmitool。
Options(选项)
-a 提示输入远程服务器的密码
-A
-c 使输出格式为 CSV(逗号分隔的变量)格式。但是不是针对所有命令都有效。
-C
-19 默认的三个格式为：指定
RAKP-HMAC-SHA1为验证，HMAC-SHA1-96为完整性，AES-CBC-128为加密算法。
-E 远程服务密码通过环境变量IPMI_PASSWORD来指定。
-f
-h 获取基本帮助
-H 远程服务地址，可以为ip地址或者是主机名。Lan和lanplus接口都需要这个操作。
-I
-L
-m
-o
-p
-P
-t
-U
-v 提高详细输出的级别。这个操作可以指定多次用来提高调试输出的级别。如果指定三次，那么你将会得到所有传入和传出的数据包。
-V 列出版本信息。
如果没有密码方法被指定，那么ipmitool将会提示用户输入密码。如果用户没有输入密码，那么远程服务密码将会设置为NULL。
SECURITY（安全）
在使用IPMI LAN 接口之前，有一些需要注意的安全问题。一个远程控制站有这个能力去控制一个系统的power状态，同样也可以去收集某些平台上的信息。为了减少脆弱性强烈建议IPMI LAN接口只能用在“trusted”环境中，在这个环境中系统的安全性不是一个问题或存在安全是一个专门的“管理网络”。
此外，我们强烈建议您不要启用没有设置密码的远程访问的IPMI，同时，这个密码不应该与那个系统的其他密码一样。
当利用ipmiv1.5 lan接口改变了远程机器的IPMI密码后，新密码将作为明文用过网络被发送。这个可以被观察到并且可以被利用来攻击远程系统。因此建议的IPMI密码管理只有通过IPMIv2.0 lanplus接口或在本地站系统接口完成。
在IPMIv1.5，最大密码长度为16个字符。超过16字符的密码部分将被去掉。
在IPMI 2.0，最大密码长度为20个字符;较长的密码将被截断。
COMMANDS（指令集）
help 这个可以在ipmitool命令行中获取命令行帮助。也可以写在其他参数后面来选择使用帮助。
ipmitool help
Commands:
1 raw 发送一个RAW（未加工的） IPMI请求然后输出响应。 原始命令
2 lan 配置LAN通道。 局域网
3 chassis 获取机架状态并且设置power状态。 机箱
4 event 发送预定义的状态给MC(管理控制器) 预设事件
5 mc 管理控制器状态和全局是否可使用。 设备设置信息
6 sdr 打印传感数据仓库输入与文本 传感器数据
7 sensor 输出详细的传感器信息。 传感器信息
8 fru 输出内嵌的FRU（现场可替换装置）和扫描FRU 定位器的SDR（系统定义记录） 可替换装置
9 sel 打印系统事件日志（SEL）。 系统事件日志
10 pef 配置平台事件过滤（PEF） 事件过滤
11 sol 配置IPMIv2.0 Serial-over-LAN IPMIv2.0 Serial-over-LAN
12 isol 配置IPMIv1.5 Serial-over-LAN IPMIv1.5 Serial-over-LAN
13 user 配置管理控制器用户 用户
14 channel 配置管理控制器通道 通道
15 session 打印session信息 会话
16 exec 从文件中运行一系列的命令 运行
17 set 为shell和exec设置运行变量。 设置
ipmitool chassis help 机架命令：status, power, identify, policy, restart_cause, poh, bootdev
Ipmitool chassis power help 机架power状态：status, on, off, cycle, reset, diag, soft
bmc/mc
reset
指示BMC执行一个warm或cold得复位。
Info
显示BMC硬件的信息，包括了 设备版本、固件版本、IPMI版本支持、制造商id、额外设备支持的信息。
getenables
显示一个列表，显示目前BMC的可用的操作选项。
setenables
区
system_event_log 系统事件日志记录
oem0 oem定义选项#0
oem1 oem定义选项#1
oem2 oem定义选项#2
channel
authcap
显示有关选定的信息通道的身份验证功能，在指定的权限级别.
可能的特权级别包括：
1 Callback level
2 User level
3 Operator level
4 Administrator level
5 OEM Proprietary level
info [channel number]
显示选定的通道的信息。如果没有给定通道，那么它将显示当前使用的通道的信息。
ipmitool channel info
Channel 0xf info:
Channel Medium Type : System Interface
Channel Protocol Type : KCS
Session Support : session-less
Active Session Count : 0
Protocol Vendor ID : 7154
getaccess
将给定的userid作为给定的通道的默认值。当给定的通道被使用，那么默认的用户就是给定的这个用户id。
setaccess
[callin=on|off] [ipmi=on|off] [link=on|off] [privilege=level]
在给定的通道下为给定的userid配置用户访问信息
getciphers
为给定的应用（ipmi或sol）在给定的通道下显示支持的密码套件列表
Chassis
Status
显示关于系统机架和主电源子系统的高级别状态的信息。
poh
这个命令将会返回power on的时间（单位为小时）。
identify
控制面板标识灯。默认是15，用0表示关掉。
restart_cause 查询系统最后一次重启的原因。
Policy 设置如果停电时的机架电源策略。
list 显示所有支持的策略
always-on 当电源恢复时on
previous 当电源恢复时返回到原先的状态。
always-off 当电源恢复时保持off。
power 执行机架控制命令来查看和更改电源状态。
Status 显示当前状态。
on 电源开
off 电源关闭机架到软关闭（S4/S5状态）。
cycle 规定关闭的区间至少为1秒。当机架电源状态在s4/s5状态时将不会有动作发生，我们建议首先检查电源状态，
如果系统电源on或低于S4/S5休眠状态，此时在使用cycle命令。
reset 这个命令将执行硬重置。
diag 向处理器直接发送一个诊断中断。
soft 通过ACPI（高级配置与电源接口）来执行
软件关机。这个可以在多种方式下实现，一般是通过模拟过高温度或模拟关键键。
这是必要的，要有操作系统的ACPI支持。
Bootdev
目前支持的
Pxe： pxe启动
Disk: 从BIOS默认的启动设备处启动。
Safe: 从BIOS默认的启动设备处启动,但是要求有安全模式。
Diag: 从诊断分区启动。
Cdrom: 从CD/DVD启动
Bios: 进入bios设置。
event
< predefined event number>
发送预先定义的事件到系统事件日志。下面的事件包括作为一种手段，以测试系统事件日志的BMC的组件功能（每一次都会增加一个输入，
event n命令被执行）
目前支持的n值为：
1 温度：上临界值：走向高
2 电压临界值：下临界值：走向低
3 内存：可纠正的ECC错误检测
注意：这些预先定义的事件可能不会产生一个特定的系统“准确”的SEL（系统事件日志）记录，因为他们不能正确绑定到一个有效
的传感器数量，但是这些足以证明了的SEL正确操作。
file
filename文件中详细描述的事件日志记录将被添加到系统事件日志。
该文件中的每一行的格式如下：
<{EvM Revision} {Sensor Type} {Sensor Num} {Event Dir/Type} {Event Data 0} {Event Data 1}
{Event Data 2}>[# COMMENT]
注意：Event Dir/Type中，事件路径的编码作为高7位，事件类型的编码作为低7位。
如：0x4 0x2 0x60 0x1 0x52 0x0 0x0# Voltage threshold: Lower Critical: Going Low。
exec
从filename中读取ipmitool命令。每一行都是一个完整的命令。这些命令的语法定义在本页的COMMANDS中。每一行都可以在
行尾加个可选择的注释，以‘#’为限定符。
如，一个两行命令的文件：
sdr list # get a list of sdr records
sel list # get a list of sel records
fru
print
这个命令将会读取所有的现场可替换装置（FRU）的库存数据，提取这些信息作为序号，零件编号，资产标签，以及描述了机架、
电路板或产品的短字符串。
i2c
这将允许你执行i2c命令。
isol
setup
为IPMI v1.5 Serial-over-LAN设置传输频率。
lan
print
输出给定通道的当前配置信息。
Set
为给定的通道设置给定的参数。有效的parameter有：
ipaddr
为这个通道设置ip
netmask
为这个通道设置网络掩码
macaddr
为这个通道设置mac地址。
defgw ipaddr
设置默认网关的ip地址。
defgw macaddr
设置默认网关的mac
地址。
bakgw ipaddr
设置备份网关的ip地址。
bakgw macaddr
设置备份网关的ip地址
password
设置无用户的密码。
snmp
设置SNMP的团体字符串
user
启用用户访问模式为用户标识1。
access
设置LAN通道access模式。
ipsrc
设置ip地址源：
none 没有指定；
static 手动配置静态IP地址
dhcp 通过BMC运行DHCP来得到地址
bios 通过BIOS或系统软件来装载地址
arp respond
设置BMC生成ARP回复。
arp generate
设置BMC生成免费的ARP
arp interval
设置BMC生成免费的ARP间隔。
auth
给一个指定的授权级别一个有效的授权类型。
Levels: callback, user, operator, admin
Types: none, md2, md5, password, oem
cipher_privs
相关研究密码套件数目连同最高权限级别是去使用它。这样，密码套件可以用一个给定的权限级别来限制用户。
例如，管理员需要使用比一般用户更强的密码套件。
Privlist的格式为如下，每个字符代表一个权限级别，字符位置标识密码套件的数目。
例如，第一个字符表示密码套件1（密码套件0是保留），第二个字符表示套件2，
以此类推。Privlist必须有15个字符。
在privlist中使用的字符和其相关权限级别为：
X Cipher Suite Unused
c CALLBACK
u USER
o OPERATOR
a ADMIN
O OEM
所以，设置最高权限时，将套装1分配给USER，套装2分配给ADMIN，命令如：
ipmitool -I interface lan set channel cipher_privs uaXXXXXXXXXXXXX
pef
info
这个命令将会查询BMC，并且打印出PEF所支持功能的信息。
status
这个命令打印出当前的pef的状态（BMC最后一次向SEL德输入，等等）
policy
此命令列出了PEF的策略表条目。每个策略项描述警报目的地。一个政策设置是一个表项的集合。PEF警报动作参考策略集。
list
这个命令列举出PEF表项。每一个PEF输入关联一个传感器事件给一个行动。当PEF是活跃的，每个平台事件导致BMC去扫描匹配的事件
条目表，并采取一定可能的行动。
采取行动，执行优先顺序（高临界第一）。
raw
这将允许你执行原始的IPMI命令。作为一个例子，用一个原始命令来查询POH（通道开销）计数器：
ipmitool -v raw 0x0 0xf
RAW REQ (netfn=0x0 cmd=0xf data_len=0)
RAW RSP (5 bytes)
3c 72 0c 00 00
sdr
info
这个命令将会查询BMC中相关的SDR(传感器数据记录)信息。
list [all|full|compact|event|mcloc|fru|generic]
这个命令将会读取
传感器数据记录（SDR）以及提取传感器给定type的信息，之后将会查询每一个传感器并打印出相应的名字、状态等信息。
可用的类型如下：
all 所有的SDR记录（传感器和定位器）
full 完全的传感器记录
compact 简洁的传感器记录
event 传感器记录的事件信息
mcloc 管理控制器定位器记录
fru FRU(现场可替换装置)的定位器记录
generic 一般的SDR记录
entity
显示所有的实体关联的传感器。通过运行命令`sdr list'和一个操作符‘-v’获得一个有效的实体在目标系统上的ID列表。
所有实体的id列表可以在IPMI规范中找到。
dump
将原始的SDR数据写入文件file。
sel
注意：如果SEL时钟需要设置的话，SEL写入次数作为`Pre-Init Time-stamp'被显示。
保证SEL时钟被命令`sel time get' 和 `sel time set
mplete set-in-progress commit-write
enabled
true false
force-encryption
true false
force-authentication
true false
privilege-level
user operator admin oem
character-accumulate-level
十进制数给予5毫秒增量
character-send-threshold
十进制数
retry-count
十进制数，0表示没有数据包发送后重试。
retry-interval
十毫秒增量的十进制数。0表示重试应送回回来。
non-volatile-bit-rate
serial, 19.2, 38.4, 57.6, 115.2 设置此值，以串行显示，BMC应该使用被IPMI over serial通道使用的设置。
volatile-bit-rate
serial, 19.2, 38.4, 57.6, 115.2. 设置此值，以串行显示，BMC应该使用被IPMI over serial通道使用的设置。
activate
使ipmitool进入Serial Over LAN模式，仅仅当使用lanplus接口时有用。一个RMCP+连接连向BMC，终端被设置为原始模式，
用户输入发送到串行控制台的远程服务器。在退出时，SOL的有效负载模式失效，终端也将被回复到原来的模式。
特别的转义字符被提供用来控制SOL会话：
~. 终止连接
~^Z 挂起的ipmitool
~B 发送中断
~~ 通过输入两次来发送转义字符
~? 输出所支持的转移字符
deactivate
停用串行局域网在BMC模式。退出Serial Over LAN模式将会自动的将这个命令发送到BMC，但是对于无意识的退出SOL模式的情况，
这个命令将会很有用来重置BMC状态。
user
summary
显示用户id信息的简单概要，包括最大数量的用户id、可用的用户id 的数目、和 已定义好的名字的数目。
list
显示出所有用户的信息。
set
name
password
管理员级别的账户中删除密码时要注意。
disable
Enable
test
注意：要确定LAN接口位于哪个通道，使用命令`channel info channel'。
OPEN INTERFACE（开放接口）
Ipmitool的open接口利用openipmi的内核设备驱动程序。该驱动存在于所有的现代2.4和所有2.6核心中，以及它应该出现在最新的 Linux发行版的内核中。在OpenIPMI的主页中同样有各种针对于使不同版本的核心可用的IPMI驱动核心补丁。
2.4和2.6核心所需要的核心模块是不一样的。
下列的核心模块就需要装载一个2.4基础核心，从而保证ipmitool顺利运行：
ipmi_msghandler
为IPMI接口处理传入和传出的信息
ipmi_kcs_drv
一个针对消息处理的IPMI键盘控制器的风格接口。
ipmi_devintf
Linux字符的消息处理设备接口
下列的核心模块就需要装载一个2.6基础核心，从而保证ipmitool顺利运行：
ipmi_msghandler
为IPMI接口处理传入和传出的信息
ipmi_si
一个IPMI的系统消息处理程序接口的驱动程序。该模块支持各种IPMI的系统接口，例如KCS, BT, SMIC，甚至2.6核心下的SMBus。
ipmi_devintf
Linux字符的消息处理设备接口
一旦需要的模块被加载，将会有一个动态的字符输入装置存在于/dev/ipmi0。对于系统，使用devfs或udev将会在/dev/ipmi/0中。
要创建设备节点，首先要通过查看/proc/devices来确定内核指派的动态主设备号，以及检查ipmidev输入。通常，如果这是第一个动态设备，那么主设备号为254，第一个系统接口的次设备号为0，所以，你可以通过输入以下命令来创建设备：
mknod /dev/ipmi0 c 254 0
ipmitool包括了一些简单的初始化代码，这样就可以在启动时自动执行一些任务。
为了使ipmitool使用openipmi设备接口，你可以用以下的命令：
ipmitool -I open
BMC INTERFACE
Ipmitool bmc接口利用了bmc设备驱动，它被Solaris 10以上的版本所提供。为了使ipmitool使用这个接口，使用命令：
下列的文件都与bmc设备有关系：
/platform/i86pc/kernel/drv/bmc
32-bit ELF kernel module for the bmc driver.
/platform/i86pc/kernel/drv/amd64/bmc
64-bit ELF kernel module for the bmc driver.
/dev/bmc
Character device node used to communicate with the bmc driver.
LIPMI INTERFACE
Ipmitool的lipmide接口利用了Solaris 9 Ipmi核心设备驱动程序。你可以使用下列命令行来使ipmitool使用这个接口：
ipmitool -I lipmi
LAN INTERFACE
Ipmitool的lan接口在IPv4下利用UDP通过一个以太局域网连接与BMC相关联。UDP数据报被格式化，通过一个IPMI会话头与RMCP（远程管理控制协议）头 来包含IPMI请求/回复。
IPMI-over-LAN利用了1版本的远程管理控制协议（RMCP）来支持预操作系统和操作系统缺失的管理。RMCP是一个在623端口上利用UDP数据报的一个请求-回复传输协议。
LAN接口是一个自动的多会话连接；移交给BMC的信息可以用一个 攻击/回应 协议来认证，使用一个直密码/key 或 消息摘要算法。Ipmitool将会尝试着使用administrator
权限级别来连接 从而来执行机架电源功能。
你可以让ipmitool使用lan接口通过“-I lan”操作：
ipmitool -I lan -H
当使用ipmitool的lan接口时，在命令行中必须要主机名。密码部分是可选的；如果在命令行中没有提供密码，ipmitool将会在无验证的情况下去连接。如果你指定了密码，他将使用MD5认证。