2023机柜管理单元 RMC CLI 规范

机柜管理单元RMCCLI规范整机柜服务器解决方案-整机柜服务器解决方案-机柜管理单元RMCCLI规范version1.0PAGEPAGE3/19目录TOC\o"1-1"\h\z\u一、 概述 4二、 CLI例明 6三、 用户限理 7四、 语法明 8五、 属性明 10六、 附录 19一、 概述概述RMCCLISMASHSM_CLPSM_CLP的“ModularSystemProfile”（参考SM_CLPCLICLISM_CLPRMC信息监控实现方式由于通过I2C的传输时延较大，不利于实现所有信息都实时获取。对于信息我们将信息分为动态信息和静态信息；静态信息：不会随时间变化发生变化的属性动态信息：随着时间变化动态变化的属性，如：温度，功耗等。所有对象的温度，功耗，状态，sensors值定义为动态信息，其他为静态信息。对象属性定义RMC对象属性类型包括两类：一类为只读属性ReadOnly以下简称为RO（这类属性只要求能够通过命令行读出其数值）；另一类为读写属性ReadandWrite以下简称为RW(这类属性作为可控属性，支持设定，修改，删除功能)对于没有定义的属性，属性值使用na标识。对于定义了但是未能获取到的属性，或者是模块不在位时属性值noRMCCLI结构定义整机柜服务器解决方案-整机柜服务器解决方案-机柜管理单元RMCCLI规范version1.0PAGEPAGE6/19二、 CLI用例说明举例：显示系统信息命令行：Show/system输出：PropertiesLocation=SystemManufacturer=RMCSN=Firmware=Status=Hostname=AdminPassword=OperatorPassword=IPMode=IP=NetMask=GateWay=SyslogServerIP=UDPPort=SnmpTrapServerIP=SnmpTrapPort=SnmpTrapCommunity=NodeAutoPoweronEnable=NodePoweronGap=DateTime=SummaryTargetPowerCooling1Cooling2Cooling3Chassis1Chassis2Chassis3Logs三、 用户权限管理用户类型：包括root、administrator、user三种类型；缺省包括3个用户：root、admin、operator详细信息见下表：用户类型用户名密码数量权限rootrootroot1root用户拥有，Linuxshell所有权限。linuxroot用户，默认密码为root。rootuser，userOperator4rootuser,admin的password进行管理。administratoradminadmin1admin具备所有RMCCLI的读写权限useroperatoroperator≥1operator为默认的user用户,adminuserCLIroot可以根据用户需求对user用户组进行管理。四、 语法说明Verb语法适用对象权限控制用例描述helphelpoperator，admincdcd[-options][target]详细语法参见SM_CLP（DSP0214）operator,adminshowshow[-options][target]详细语法参见SM_CLP（DSP0214）Alloperator,admin属性类型为RWorRO的属性显示可读属性setset[-options][target][property]Alltarget可读属性admin属性类型为RW的属性设置属性值resetstart[-options][target]详细语法参见（DSP0214）system,node,logsadminreset/systemreset/system/chassis1/node1reset/system/logsreset/system重启RMC，RMC重新收集所有静态信息reset/system/chassis1/node1重启节点reset/system/logs清除所有log整机柜服务器解决方案整机柜服务器解决方案-机柜管理单元RMCCLI规范version1.0PAGEPAGE9/19startstart[-options][target]详细语法参见（DSP0214）power,nodeadminstart /system/powerstart start /system/chassis1start /system/chassis1/node1开启电源模块,节点:start /system/power同时开所有源模块start 开启单电源块start /system/chassis1chassisstart /system/chassis1/node1开启单个节点stopstop[-options][target]详细语法参见（DSP0214）注：执行该命令时需要有提醒功能。power,nodeadminstop /system/powerstop stop /system/chassis1stop /system/chassis1/node1关闭电源模块,节点:stop /system/power同时关所有源模块stop 关闭单电源块stop /system/chassis1同时关闭某个chassis中的所有节点stop /system/chassis1/node1关闭单个节点其他verb参见SM_CLP（DSP0214）说明：SM_CLP支持Tab整机柜服务器解决方案-整机柜服务器解决方案-机柜管理单元RMCCLI规范version1.0PAGEPAGE18/19五、 属性说明对象/对象路径对象属性属性值定义描述属性值例举类型操作类型system/systemLocation机房编码-楼房号-行号 （）.location预留20ByteLocationIDBMCFru用“ChassisPartipmitoolChassisPart"信息.节点从ABFruUpdateFru里的"ChassisPart"Location=BJZGC1-F201-0101RWset,showManufacturer字符串，≤10Byte系统厂商Manufacturer=IntelROshowPartNumber字符串， 20BytePN：TX8000-001,PartNumber=TX8000-001ROshowSN字符串, 30ByteRMCSN号，以此为整机柜的SNSN=124568879ADJI2356RWset,showFirmware字符串，≤8ByteRMCfirmware版本Firmware=1.10.11ROshowStatus十进制编码1Byte0(off),1(on),2(Standby)RMCpowerstatusStatus=1ROshowHealth十进制编码1Byte0(absent),1(ok),2(fail) RMCHealthHealth=1ROshowHostName字符串，≤20ByteRMC系统hostname；自动匹配为location值，Hostname=LocationHostName=BJZGC1-F201-0101RWset,showOperatorPassword字符串，≤20Byteoperator用户密码设置：operatorCLIOperatorOperatorPassword=xxxxxxRWset,showAdminPassword字符串，≤20Byteadmin用户密码设置：adminoperatorpassword。CLIOperatorAdminPassword=xxxxxxRWset,showIPMode字符串，≤8ByteDHCPorStaticIPMode=DHCPRWset,showIPxxx.xxx.xxx.xxxxrmcip设置IP=192.168.0.2RWset,showNetMaskxxx.xxx.xxx.xxxx为十进制编码rmcip NetMask=255.255.255.0RWset,showGateWayxxx.xxx.xxx.xxxx为十进制编码rmc网关设置GateWay=192.168.0.1RWset,showSyslogEnable十进制编码，1Byte设置是否开启syslog；SyslogEnable=1RWset,showSyslogServerIPxxx.xxx.xxx.xxxxsyslogserverIP;若Syslog服务被disable,该项属性值为NA；SyslogServerIP=192.168.0.3RWset,showSyslogUDPPortxxxxx x制编码syslog服务端口;若Syslog服务被disable,该项属性值为NA；SyslogUDPPort=554RWset,showSnmpTrapEnable十进制编码,1Byte设置是否使用snmptrap；SnmpTrapEnable=0RWset,showSnmpTrapServerIPxxx.xxx.xxx.xxxxsnmptrap目的IP；若Snmp服务被disable,该项属性值为NA；SnmpTrapServerIP=NARWset,showSnmpTrapPortxxxxx x制编码snmptrap服务端口;若Snmp服务被disable,该项属性值为NA；SnmpTrapPort=NARWset,showSnmpTrapCommunity字符串，≤10Byte设置子机trap团体名SnmpTrapCommunity=publicRWset,showNodePoweronGap（s）十进制编码，≤3Byte增加。NodePoweronGap（s）=10RWset,showTimeYYYY-MM-DDHH:MM:SSRMC日期时间Time=2012-12-2216:45:39RWset,showSummarypsuID StatusHealth xxxIIxxxxxS…fanID xxxIIxxxxxS…RMC HealthSN MAC...nodeID Health SNMAC1 MAC2xxIIIxxxxxSpsu,fanID，status，SN，MACxxxIIxxxxxS"x分别表示两位和三位状态。对于summary/systemsummaryshow/systemSummary时打印出所有Summary内容。psuID Status SN01 102 0….fanID Status 01 102 0….RMC Health MACnodeIDStatus SNMAC1 MAC201A 1 1123DAFSR 00:2E:12:FF:11:4500:2E:12:FF:11:4602A 0…ROshowOEMProperties厂商自定义ROshowpower/system/powerFirmware字符串,≤8BytePCBfirmware版本信息，如果没用单独电源控制单元设计，此项值为NAPCBFirmware=1.11.10ROshowStatus十进制编码,1Byte0(off),1(on),2(standby) 态可NAPCBStatus=1ROshowHealth十进制编码,1Byte0(absent),1(ok),2(fail) PCBHealth=1ROshowPSUAmount十进制编码,≤2Byte实际在位电源数量PSUAmount=8ROshowMaxPower（VA）十进制编码,6BytelogtrapMaxPower，MaxPower-23当MaxPower0functiondisable。4出厂设置该值默认为0。MaxPower（VA）=7040RWshow，setInput(VA)十进制编码,≤6Byte电源总输入，等于所有PSU输入之和SystemPowerInput(VA)=7000ROshowOutput(W)十进制编码,≤6Byte电源总输出，等于所有PSU输出之和SystemPowerOutput(W)=6307ROshowEfficiency（%）十进制编码,≤6Byte/Efficiency（%）=90.1ROshowPhaseAVoltage(V)十进制编码,≤6ByteA路输入电压：AC+AC，AC+DC，三相输入的其中一路PhaseAVoltage(V)=220ROshowPhaseACurrent(A)十进制编码,≤6ByteA路输入电流：AC+AC，AC+DC，三相输入的其中一路PhaseACurrent(A)=31.8ROshowPhaseBVoltage(V)十进制编码,≤6ByteB路输入电压：AC+AC，三相输入的其中一路。当AC+DC输入时，B路为DC输入PhaseBVoltage(V)=220ROshowPhaseBCurrent(A)十进制编码,≤6ByteB路输入电流：AC+AC，三相输入的其中一路。当AC+DC输入时，B路为DC输入PhaseBCurrent(A)=0ROshowPhaseCVoltage(V)十进制编码,≤6ByteC路输入电压：三相输入的其中一路PhaseCVoltage(V)=NAROshowPhaseCCurrent(A)十进制编码,≤6ByteC路输入电流：三相输入的其中一路PhaseCCurrent(A)=NAROshowpsu/system/power/psu1Manufacturer字符串，≤10Bytepsu1厂商信息Manufacturer=DeltaROshowSN字符串，≤30Bytepsu1的序列号SN=112SDFS242346567ROshowID十进制编码，≤3Bytepsu1的ID号与外标签相同ID=1ROshowFirmware字符串，≤8Bytepsu1的firmware版本Firmware=1.030ROshowStatus十进制编码，1Byte0(off),1(on),2(sdandby)Status=1ROshowHealth十进制编码1Byte0(absent),1(ok),2(fail) PSUHealthHealth=1ROshowInputVoltage(V)十进制编码，≤4Byte输入电压InputVoltage(V)=220ROshowInputCurrent(A)十进制编码，≤6Byte输入电流InputCurrent(A)=8.0ROshowOutputVoltage(V)十进制编码，≤4Byte输出电压OutputVoltage(V)=12ROshowOutputCurrent(A)十进制编码，≤6Byte输出电流OutputCurrent(A)=527.1ROshowcooling/system/cooling1Firmware字符串，≤10ByteFCB的Firmware版本，若无FCB设计，此项为NAFirmware=1.1.10ROshowID十进制编码，≤3ByteFCB的ID号，若无FCB设计，此项为NAID=1ROshowStatus十进制编码，1Byte0(absent),1(ok),2(fail)，此项值可为NAStatus=1ROshowPower十进制编码，≤4Byte所控制风扇的功耗值,此项值可为NAPowerConsumption=60ROshow十进制编码，≤3Byte出风口温度,此项值可为NAOutputTemp（℃）=56ROshowFanControllMode字符串，AutoorManual风扇控制模式FanControlMode=AutoRWshowDuty(%)十进制编码，≤3Byte风扇当前运行的duty值Duty(%)=40RWset,showfan/system/cooling/fan1Manufacturer字符串，≤10Byte风扇厂商信息，可在firmware中写死。Manufacturer=DeltaROshowID十进制编码，≤3Byte风扇ID号，不同coolingzone中的fan顺延编号，不重复。ID=1ROshowSize十进制编码，≤3Byte风扇大小信息，可在firmware中写死。Size=120ROshowHealth十进制编码1Byte0(absent),1(ok),2(fail) FanHealthHealth=1ROshowSpeed十进制编码，≤5Byte风扇当前运行转速Speed=2300ROshowchassis/system/chassis1ChassisID十进制编码，≤3Byte背板编号(注明：整个rack可以作为一个chassis1，根据实际需要进行区分。)ChassisID=1ROshowBackplaneStatus字符串，≤3Byte0(absent),1(ok),2(fail)，此项值可为NABackplaneStatus=1ROshownode/system/chassis/node1ID字符串，≤3Byte节点编号为xxYxx01-40Y左到右为A,B...对于多NUxxU01，N+1，2N+1…LcationID需要回写至BMC"ChassisPart"表示ID=1AROshowSN字符串，≤30Byte节点SN号，节点ProductSerialNumberSN=123435DAFSR567ROshowStatus十进制编码，1Byte0(off),1(on),2(standby) 点DCStatus=1ROshowHealth十进制编码1Byte0(absent),1(ok),2(fail) 节点HealthHealth=1ROshowPowerConsumption(w)十进制编码，≤3Byte节点功耗PowerConsumption（w）=200ROshowMAC1xx:xx:xx:xx:xx:xx 为16该节点BMC的dedicateport MAC地址MAC=00:2E:12:FF:11:45ROshowMAC2xx:xx:xx:xx:xx:xx 为16节点BMC的shareNIC使用的MAC地址MAC=00:2E:12:FF:11:46ROshowEthernet字符串，≤6Byte节点BMC的网络模式dedicateshare。dedicate表示以下IPdedicate的IP，share表示以下IP为sharenic的IPEthernet=shareROset,showIPMode字符串，≤6Byte该节点BMCIP设置式 DHCPStaticIPMode=DHCPRWset,showIPxxx.xxx.xxx.xxx 该节点BMCIPIP=192.168.0.4RWset,showNetmaskxxx.xxx.xxx.xxx 该节点BMCIP子网掩码Netmask=255.255.255.0RWset,showGatewayxxx.xxx.xxx.xxx x为十进制编码该节点BMC网关设置Gateway=192.168.0.1RWset,showEnTemp十进制编码，≤3Byte节点入风口温度，即环境温度EntranceTemperature(℃)=25ROsho