2023機柜管理單元 RMC CLI 規(guī)范

機柜管理單元RMCCLI規(guī)范整機柜服務器解決方案-整機柜服務器解決方案-機柜管理單元RMCCLI規(guī)范version1.0PAGEPAGE3/19目錄TOC\o"1-1"\h\z\u一、 概述 4二、 CLI例明 6三、 用戶限理 7四、 語法明 8五、 屬性明 10六、 附錄 19一、 概述概述RMCCLISMASHSM_CLPSM_CLP的“ModularSystemProfile”（參考SM_CLPCLICLISM_CLPRMC信息監(jiān)控實現方式由于通過I2C的傳輸時延較大，不利于實現所有信息都實時獲取。對于信息我們將信息分為動態(tài)信息和靜態(tài)信息；靜態(tài)信息：不會隨時間變化發(fā)生變化的屬性動態(tài)信息：隨著時間變化動態(tài)變化的屬性，如：溫度，功耗等。所有對象的溫度，功耗，狀態(tài)，sensors值定義為動態(tài)信息，其他為靜態(tài)信息。對象屬性定義RMC對象屬性類型包括兩類：一類為只讀屬性ReadOnly以下簡稱為RO（這類屬性只要求能夠通過命令行讀出其數值）；另一類為讀寫屬性ReadandWrite以下簡稱為RW(這類屬性作為可控屬性，支持設定，修改，刪除功能)對于沒有定義的屬性，屬性值使用na標識。對于定義了但是未能獲取到的屬性，或者是模塊不在位時屬性值noRMCCLI結構定義整機柜服務器解決方案-整機柜服務器解決方案-機柜管理單元RMCCLI規(guī)范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重新收集所有靜態(tài)信息reset/system/chassis1/node1重啟節(jié)點reset/system/logs清除所有l(wèi)og整機柜服務器解決方案整機柜服務器解決方案-機柜管理單元RMCCLI規(guī)范version1.0PAGEPAGE9/19startstart[-options][target]詳細語法參見（DSP0214）power,nodeadminstart /system/powerstart start /system/chassis1start /system/chassis1/node1開啟電源模塊,節(jié)點:start /system/power同時開所有源模塊start 開啟單電源塊start /system/chassis1chassisstart /system/chassis1/node1開啟單個節(jié)點stopstop[-options][target]詳細語法參見（DSP0214）注：執(zhí)行該命令時需要有提醒功能。power,nodeadminstop /system/powerstop stop /system/chassis1stop /system/chassis1/node1關閉電源模塊,節(jié)點:stop /system/power同時關所有源模塊stop 關閉單電源塊stop /system/chassis1同時關閉某個chassis中的所有節(jié)點stop /system/chassis1/node1關閉單個節(jié)點其他verb參見SM_CLP（DSP0214）說明：SM_CLP支持Tab整機柜服務器解決方案-整機柜服務器解決方案-機柜管理單元RMCCLI規(guī)范version1.0PAGEPAGE18/19五、 屬性說明對象/對象路徑對象屬性屬性值定義描述屬性值例舉類型操作類型system/systemLocation機房編碼-樓房號-行號 （）.location預留20ByteLocationIDBMCFru用“ChassisPartipmitoolChassisPart"信息.節(jié)點從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分別表示兩位和三位狀態(tài)。對于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) 態(tài)可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，根據實際需要進行區(qū)分。)ChassisID=1ROshowBackplaneStatus字符串，≤3Byte0(absent),1(ok),2(fail)，此項值可為NABackplaneStatus=1ROshownode/system/chassis/node1ID字符串，≤3Byte節(jié)點編號為xxYxx01-40Y左到右為A,B...對于多NUxxU01，N+1，2N+1…LcationID需要回寫至BMC"ChassisPart"表示ID=1AROshowSN字符串，≤30Byte節(jié)點SN號，節(jié)點ProductSerialNumberSN=123435DAFSR567ROshowStatus十進制編碼，1Byte0(off),1(on),2(standby) 點DCStatus=1ROshowHealth十進制編碼1Byte0(absent),1(ok),2(fail) 節(jié)點HealthHealth=1ROshowPowerConsumption(w)十進制編碼，≤3Byte節(jié)點功耗PowerConsumption（w）=200ROshowMAC1xx:xx:xx:xx:xx:xx 為16該節(jié)點BMC的dedicateport MAC地址MAC=00:2E:12:FF:11:45ROshowMAC2xx:xx:xx:xx:xx:xx 為16節(jié)點BMC的shareNIC使用的MAC地址MAC=00:2E:12:FF:11:46ROshowEthernet字符串，≤6Byte節(jié)點BMC的網絡模式dedicateshare。dedicate表示以下IPdedicate的IP，share表示以下IP為sharenic的IPEthernet=shareROset,showIPMode字符串，≤6Byte該節(jié)點BMCIP設置式 DHCPStaticIPMode=DHCPRWset,showIPxxx.xxx.xxx.xxx 該節(jié)點BMCIPIP=192.168.0.4RWset,showNetmaskxxx.xxx.xxx.xxx 該節(jié)點BMCIP子網掩碼Netmask=255.255.255.0RWset,showGatewayxxx.xxx.xxx.xxx x為十進制編碼該節(jié)點BMC網關設置Gateway=192.168.0.1RWset,showEnTemp十進制編碼，≤3Byte節(jié)點入風口溫度，即環(huán)境溫度EntranceTemperature(℃)=25ROsho