ipmitool命令总结

 远程服务地址，可以为ip地址或者是主机名。Lan和lanplus接口都需要这个操作。

-I

 选择使用的IPMI接口。编译支持的接口都在使用帮助输出中可见。

-L

 力量会话特权级别。

可以为CALLBACK,

 USER,

 OPERATOR,

 ADMIN。默认为ADMIN。

-m

 设置本地IPMB（智能平台管理总线）地址。默认的为0x20。如果是一般的操作，那么就没有必要更改它。

-o

 选择支持的OEM（原始设备制造商）类型。这通常涉及到代码中的小窍门，以解决各种BMC在不同制造商的怪癖到位。

    使用命令“-o list”来查看当前支持的OEM类型的列表。

-p

 设置要连接的远程服务UPD端口，默认为623。

-P

 在命令行中指定远程服务密码。如果支持，他将会进程列表中被掩盖。注意！：不推荐在命令行中指定密码。

-t

 桥接IPMI的请求到远程目标地址。

-U

 远程服务用户名，默认为NULL。

-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命令行中获取命令行帮助。也可以写在其他参数后面来选择使用帮助。

                        raw      发送一个RAW（未加工的） IPMI请求然后输出响应。

                        lan       配置LAN通道。

                        chassis      获取机架状态并且设置power状态。

                        event      发送预定义的状态给MC(管理控制器)

                        mc      管理控制器状态和全局是否可使用。

                        sdr      打印传感数据仓库输入与文本

                        sensor      输出详细的传感器信息。

                        fru      输出内嵌的FRU（现场可替换装置）和扫描FRU 定位器的SDR（系统定义记录）

                        sel      打印系统事件日志（SEL）。

                        pef      配置平台事件过滤（PEF）

                        sol      配置IPMIv2.0Serial-over-LAN

                        isol      配置IPMIv1.5Serial-over-LAN

                        user     配置管理控制器用户

                        channel      配置管理控制器通道

                        session      打印session信息

                        exec      从文件中运行一系列的命令

                        set      为shell和exec设置运行变量。

           ipmitool chassishelp  机架命令：status,power, identify, policy, restart_cause, poh, bootdev

           Ipmitool chassispower help    机架power状态：status, on, off, cycle, reset, diag, soft

            reset

                              指示BMC执行一个warm或cold得复位。

                              显示BMC硬件的信息，包括了 设备版本、固件版本、IPMI版本支持、制造商id、额外设备支持的信息。

                             显示一个列表，显示目前BMC的可用的操作选项。

            setenables=[on|off]

                            启用或禁用特定的选项。此命令根据IPMI规    范仅支持系统接口。当前option支持的选项有：

            recv_msg_intr    接收消息队列中断。

            event_msg_intr    事件消息缓冲区满中断

            event_msg        事件消息缓冲区

            system_event_log        系统事件日志记录

            oem0    oem定义选项#0

            oem1    oem定义选项#1

            oem2    oem定义选项#2

            authcap

                            显示有关选定的信息通道的身份验证功能，在指定的权限级别.

                        可能的特权级别包括：

                          显示选定的通道的信息。如果没有给定通道，那么它将显示当前使用的通道的信息。

           getaccess

[userid]

                        将给定的userid作为给定的通道的默认值。当给定的通道被使用，那么默认的用户就是给定的这个用户id。

           setaccess

                        在给定的通道下为给定的userid配置用户访问信息

           getciphers


[channel]

                       为给定的应用（ipmi或sol）在给定的通道下显示支持的密码套件列表

                显示关于系统机架和主电源子系统的高级别状态的信息。

                这个命令将会返回poweron的时间（单位为小时）。

       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设置。

           发送预先定义的事件到系统事件日志。下面的事件包括作为一种手段，以测试系统事件日志的BMC的组件功能（每一次都会增加一个输入，

                event n命令被执行）

           目前支持的n值为：

                 1   温度：上临界值：走向高

                 2   电压临界值：下临界值：走向低

                 3   内存：可纠正的ECC错误检测

           注意：这些预先定义的事件可能不会产生一个特定的系统“准确”的SEL（系统事件日志）记录，因为他们不能正确绑定到一个有效

                的传感器数量，但是这些足以证明了的SEL正确操作。

      file

          filename文件中详细描述的事件日志记录将被添加到系统事件日志。

          该文件中的每一行的格式如下：

           注意：Event Dir/Type中，事件路径的编码作为高7位，事件类型的编码作为低7位。

           如：0x4 0x2 0x60 0x1 0x52 0x0 0x0# Voltage threshold: LowerCritical: Going Low。

      exec

           从filename中读取ipmitool命令。每一行都是一个完整的命令。这些命令的语法定义在本页的COMMANDS中。每一行都可以在

                行尾加个可选择的注释，以‘#’为限定符。

           如，一个两行命令的文件：

           这个命令将会读取所有的现场可替换装置（FRU）的库存数据，提取这些信息作为序号，零件编号，资产标签，以及描述了机架、

           电路板或产品的短字符串。

    i2c


[

]

          这将允许你执行i2c命令。

      setup

          为IPMIv1.5 Serial-over-LAN设置传输频率。

      print

          输出给定通道的当前配置信息。

      Set

          为给定的通道设置给定的参数。有效的parameter有：

      ipaddr

          为这个通道设置ip

      netmask

          为这个通道设置网络掩码

      macaddr

 

          为这个通道设置mac地址。

      defgw ipaddr

          设置默认网关的ip地址。

      defgw macaddr

 

          设置默认网关的mac地址。

      bakgw ipaddr

          设置备份网关的ip地址。

      bakgw macaddr

          设置备份网关的ip地址

      password

          设置无用户的密码。

      snmp

          设置SNMP的团体字符串

          启用用户访问模式为用户标识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

          给一个指定的授权级别一个有效的授权类型。

      cipher_privs

           相关研究密码套件数目连同最高权限级别是去使用它。这样，密码套件可以用一个给定的权限级别来限制用户。

            例如，管理员需要使用比一般用户更强的密码套件。

           Privlist的格式为如下，每个字符代表一个权限级别，字符位置标识密码套件的数目。

            例如，第一个字符表示密码套件1（密码套件0是保留），第二个字符表示套件2，

           以此类推。Privlist必须有15个字符。

          在privlist中使用的字符和其相关权限级别为：

          所以，设置最高权限时，将套装1分配给USER，套装2分配给ADMIN，命令如：

          这个命令将会查询BMC，并且打印出PEF所支持功能的信息。

          这个命令打印出当前的pef的状态（BMC最后一次向SEL德输入，等等）

          此命令列出了PEF的策略表条目。每个策略项描述警报目的地。一个政策设置是一个表项的集合。PEF警报动作参考策略集。

          这个命令列举出PEF表项。每一个PEF输入关联一个传感器事件给一个行动。当PEF是活跃的，每个平台事件导致BMC去扫描匹配的事件

          条目表，并采取一定可能的行动。

          采取行动，执行优先顺序（高临界第一）。

   raw


[data]

          这将允许你执行原始的IPMI命令。作为一个例子，用一个原始命令来查询POH（通道开销）计数器：

          这个命令将会查询BMC中相关的SDR(传感器数据记录)信息。

          这个命令将会读取传感器数据记录（SDR）以及提取传感器给定type的信息，之后将会查询每一个传感器并打印出相应的名字、状态等信息。

          可用的类型如下：

            all       所有的SDR记录（传感器和定位器）

            full      完全的传感器记录

            compact   简洁的传感器记录

            event           传感器记录的事件信息

            mcloc           管理控制器定位器记录

            fru       FRU(现场可替换装置)的定位器记录

            generic   一般的SDR记录

      entity

[.

]

            显示所有的实体关联的传感器。通过运行命令`sdr list’和一个操作符‘-v’获得一个有效的实体在目标系统上的ID列表。

          所有实体的id列表可以在IPMI规范中找到。

      dump

          将原始的SDR数据写入文件file。

          注意：如果SEL时钟需要设置的话，SEL写入次数作为`Pre-Init Time-stamp’被显示。

          保证SEL时钟被命令`sel time get’ 和 `sel time set‘所精确的更改。

          这个命令将会查询BMC中关于SEL和其内容的相关信息。

          这个命令将会清空SEL中的信息。它不能被撤消所以要小心。

          当运行没有参数的此命令时，SEL中全部的信息将会被显示出来。

   

|first

          显示SEL中最先的count条信息。如果count是0，那么所有的信息将会显示。

    last

          显示SEL中最后的count条信息。如果count是0，那么所有的信息将会显示。

    delete

          删除一个单一事件。

                显示SEL时钟的当前时间。

          set  

                设置SEL      时钟。未来的SEL条目将使用此命令设置时间。的格式为“MM/DD/YYYYHH:MM:SS”。

                注意，小时是24小时格式。建议在设置时间之前将其清除。

          用广泛的表格式来列举出传感器和阈值。

    get

… [

]

          打印出指定name的传感器的信息。

    thresh

          这允许您设置一个特定的阈值传感器。该传感器通过name指定。可用的thresholes有：

                unr    较高不可恢复

                ucr    上临界

                unc    上非关键

                lnc         下非关键

                lcr         下临界l

                lnr         较低不可恢复

          显示指定的session的信息。你可以识别session通过id、处理数量、工作状态、或通过关键字‘all’来指定所有的session。

    info [

]

          检索指定的通道的Serial-Over-LAN配置信息。如果没有指定通道，那么它将显示出当前使用的通道的SOL配置数据。

    set
[channel]

          为SerialOver Lan配置参数。如果没有通道被指定，它会显示出当前使用的通道的SOL配置信息。

          配置参数的升级呗自动监视通过将parameter设为set-in-progress。

          可用的parameters和value为：

                十进制数给予5毫秒增量

                十进制数

                十进制数，0表示没有数据包发送后重试。

                十毫秒增量的十进制数。0表示重试应送回回来。

                serial, 19.2, 38.4, 57.6, 115.2        设置此值，以串行显示，BMC应该使用被IPMI over serial通道使用的设置。

                serial, 19.2, 38.4, 57.6, 115.2. 设置此值，以串行显示，BMC应该使用被IPMI over serial通道使用的设置。

          使ipmitool进入Serial Over LAN模式，仅仅当使用lanplus接口时有用。一个RMCP+连接连向BMC，终端被设置为原始模式，

          用户输入发送到串行控制台的远程服务器。在退出时，SOL的有效负载模式失效，终端也将被回复到原来的模式。

          特别的转义字符被提供用来控制SOL会话：

                ~.     终止连接

                ~^Z   挂起的ipmitool

                ~B     发送中断

                ~~     通过输入两次来发送转义字符

                ~?     输出所支持的转移字符

          停用串行局域网在BMC模式。退出Serial Over LAN模式将会自动的将这个命令发送到BMC，但是对于无意识的退出SOL模式的情况，

          这个命令将会很有用来重置BMC状态。

          显示用户id信息的简单概要，包括最大数量的用户id、可用的用户id 的数目、和 已定义好的名字的数目。

          显示出所有用户的信息。

          name


      
设定给定用户id
以给定的用户名

          password

[ ]
设定给定的用户以给定的密码。如果没有给定密码，那么此用户的密码将为NULL
。当从

          管理员级别的账户中删除密码时要注意。

          disable

 
使指定的用户禁用访问BMC
。

          Enable

        
使指定的用户启用访问BMC
。

          test

<16|20>[ ]  
确定密码是否已被16
或20
个字节存储。

          注意：要确定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中。