ShMC User Manual
Contents
1. no Name Type Value Unit State 64 Inputl Input 1 Asserted 65 Input2 Input 0 De Asserted 66 Input Input 0 De Asserted 67 Input4 Input 0 De Asserted 68 Input Input 0 De Asserted 69 Input Input Asserted 70 Input7 Input Asserted 71 Input Input Asserted 72 Input Input Asserted 73 Inputl0 Input 1 Asserted 74 Inputll Input 0 De Asserted 75 1 12 Input 0 De Asserted 76 Input13 Input 0 De Asserted 77 Inputl4 Input Asserted 78 Input15 Input Asserted 79 Inputl6 Input Asserted 6 5 output command Syntax output Functions Displays information about all the output sensors For each sensor the command displays sensor number sensor name sensor type current value Example 1 Output sensors values read out S gt output Sensor List cufoscNameecceeeme Ee E Type Value Unit State 80 Outputl Output Asserted 81 Output2 Output 1 Asserted 82 Output3 Output 0 De Asserted 83 Output4 Output 0 De Asserted 84 Output5 Output 0 De Asserted 85 Output6 Output 1 Asserted 86 Output Output 0 De Asserted 87 Output8 Output 1 Asserted 88 Output9 Output 0 De Asserted 89 Output10 Output 0 De Asserted 90 Outputll Output 0 De Asserted 91 Output12 Output 1 Asserted2. 42 Tachometer signal for 43 Tachometer signal for Fan7 44 Tachometer signal for Fan8 45 Tachometer signal for Fan9 46 Tachometer signal for 10 47 Tachometer signal for Fan11 48 Tachometer signal for Fan12 64 Digital Input 1 65 Digital Input 2 66 Digital Input 3 67 Digital Input 4 68 Digital Input 5 69 Digital Input 6 70 Digital Input 7 71 Digital Input 8 72 Digital Input 9 73 Digital Input 10 74 Digital Input 11 75 Digital Input 12 76 Digital Input 13 77 Digital Input 14 78 Digital Input 15 79 Digital Input 16 80 Digital Output 1 81 Digital Output 2 82 Digital Output 3 83 Digital Output 4 84 Digital Output 5 85 Digital Output 6 86 Digital Output 7 87 Digital Output 8 88 Digital Output 9 89 Digital Output 10 90 Digital Output 11 91 Digital Output 12 92 Digital Output 13 93 Digital Output 14 94 Digital Output 15 95 Digital Output 16 97 ShMC Power On Table 2 Local Sensor Numbers SAMWAY your way 9 43 SAMWAY ShMC User Manual Rev 1 6 your way 2 3 Sensor Event Log SEL The ShMC uses a non volatile Flash memory to log the events generated by the sensor monitoring function The Log can hold information for up to 65534 events I After the log reaches full capacity a warning message will be displayed and all new events F will be disregarded New Events will be logged only after the sel is cleared Logging is enabled for each event individually
3. Functions Displays or changes the Shelf Address If the cpci options is used the address is a two bytes value as defined in PICMG 2 9 If the cpci options is not used the address is a maximum 20 characters text as defined in PICMG 3 0 The shelf address field is used to uniquely identify a chassis when the DHCP clientID option is used The PICMG 3 0 defined address is stored into the Address table record if this record is present in the Shelf FRU Information Whenever the Address table record is present into the Shelf FRU Information the Shelf Address field of this record is used If this field is empty or the record is not present the PICMG 2 9 address is used for CPCI systems only 6 28 hostname command Syntax hostname lt name gt Functions Displays or changes the Hostname of the Shelf Manager 7 Restore to factory defaults procedure Only an admin can perform a system restore In order to restore all parameters to their default value the following steps need to be followed Login using the admin account for more details refer to 5 Command Line Interface CLI Use the restore command When using restore the ShMC disregards all the changes applied to the SDRs Sensor options and User Settings and uses a predetermined set for all these parameters This predetermined set g Of parameters may be different then the one loaded on the ShMC when it was shipped out To go back to a particular setup you h
4. P FR NO present YES GET picture FRU Address Remove Picture ERU Address ave new count Print new SEL records gt Stat up a V N GET picture O GET fiuinfo O GETisensor 0 0 Init Save Boot Count Save SEL Count No Active Boards Load Picture 0 Parse FRU info 0 Parse Sensors 00 On Mouse Click pue GET fruinfo FRU Address 0 IGET sensor FRU Address 0 SET sdr FRU Address Sensor no j FRU 0 selected P SAMWAY SSS your way Normal Operation 7 Object selected 4 YES gt Parse SDR info Figure 4 Default Web Page Functional Diagram Figure 3 describes the functional diagram of the default Web Page The web page has 2 operational states Initialization and Normal Operation At start up and each time it 1s re initialized the web page is empty The Web page requests and saves the ShMC settings GET settings MAC Address Serial Number Firmware Version Uptime The page also saves some parameters from the response of the frustatus request Boot count SEL count Next the web page request information for the system platform FRU 0 picture FRU info 23 43 SAMWAY ShMC User Manual Rev 1 6 your way sensors GET picture 0 GET fruinfo 0 0 GET sensor 0 0 Once the information 15 received the web page displays it After the system platform is initialized the init phase ends By
5. ip mask gateway address dhcp hostname clientid on off Functions Readout or setting of network parameters no parameters return of IP mask and gateway addresses of the LAN interface settings interface settings dhcp or local control for addresses ip returns IP address mask returns network mask gateway returns standard gateway address if any address is inputed it s value is assigned to the parameter entered before it dhcp displays the current dhcp state enabled disabled and dhcp configuration options hostname if turned on will enable the DHCP option 12 hostname clientid if turned on will enable the DHCP option 61 client id The format of the 40 43 SAMWAY ShMC User Manual Rev 1 6 your way client ID option follows the requirements form PICMG HPM 3 R1 0 specification on if entered after dhcp enables it off if entered after dhcp disables it I After a new address is set for the change to become effective it must be saved with saveenv and the ShMC restarted either using the reboot command or using a power cycle Example 1 Readout the IP address lanconfig ip 193 155 166 51 Example 2 Changing the IP address lanconfig ip 196 100 100 1 IP 196 100 100 1 Example 3 Enable dhcp lanconfig dhcp DHCP on 6 19 sol command Syntax sol on off Functions Displays or changes the current status of the Serial Over
6. 67 Input4 68 Input5 Type Value Unit State Ok Ok Lower Critical Ok Ok Ok Ok Ok Ok Ok Asserted De Asserted De Asserted List Thr Jue V Thr 5 04 V Thr 0 00 V Thr 11 88 V Thr 27 00 deg Thr 27 00 deg Thr 2100 RPM Thr 2100 RPM Thr 2100 RPM Thr 2100 RPM Input 1 Input 0 Input 0 Input 0 Input 0 De Asserted De Asserted 31 43 ShMC User Manual Rev 1 6 SAMWAY your way 80 Outputl Output 1 Asserted 81 Output2 Output 1 Asserted 82 Output3 Output 0 De Asserted 83 Output4 Output 0 De Asserted If only the sensor number parameter is entered the command will print a detailed description of the sensor identified by that particular sensor number The command parses the SDR of the desired sensor and displays various information about the sensor name type value sensor units sensor state sensor maximum and minimum values threshold values outputs assigned to threshold events fan control groups the sensor is assigned to only for temperature sensors active level for discrete sensors input type for input sensors output type for output sensors active drivers for output sensors Example 2 Get detailed information about the 5V sensor S gt sensor 2 Name VO Type Threshold Value 3 21 Sensor Units V State Lower Non Recoverable Sensor Maximum Reading 5 00 Sensor Minimum Reading 0 00
7. If the active FRU image object has been changed the WEB page request the FRU info and sensors for the new active object GET fruinfo FRU Address 0 GET sensor FRU Address 0 Using the responses of the requests the web page updates the information visible in the FRU Info and Sensor Info panels By default at start up the active image object 1s the system platform FRU 0 If the active sensor object has been changed the WEB page request the detailed information or the new active sensor GET sdr FRU Address Sensor No Using the response for the sdr request the WEB page updates the information in the nfo Area panel By default at start up no sensor object 15 selected and the Info are panel displays ShMC parameters MAC address Serial No Firmware version After the first sensor object becomes active the nfo Area panel will display sensor information To return to displaying ShMC parameters a click on the system platform image is necessary 4 2 Telnet The Telnet interface supports two operating modes Command Line Interface and Serial Over Lan SOL The CLI is accessible if the operator is logged on as user or admin profile If the operator is logging into the ShMC as serial profile the SOL mode is activated Whenever the ShMC enters in SOL mode the behavior of 5232 port will change the data received on the serial port will be transmitted in telnet packets over Ethernet to all telnet connections opened on serial
8. Upper non recoverable threshold 4 12 Assigned Outputs None Upper critical threshold 3 80 Assigned Outputs None Upper non critical threshold 3 49 Assigned Outputs None Lower non critical threshold 2 86 Assigned Outputs None Lower critical threshold 2 55 Assigned Outputs None Lower non recoverable threshold 2 23 Assigned Outputs None Assertion Events logged for unr uc De Assertion Events logged for unr Positive going threshold hysteresis Negative going threshold hysteresis Debounce 0 une ine lc uc une lao le value 0 02 value 0 02 xoxo The local sensor command can also be used to change different sensor parameters Using the sensor command the following parameters can be changed temperature sensors thresholds hysteresis fan control active mask outputs assigned to threshold events fan speed sensors thresholds hysteresis outputs assigned to threshold events input sensors active level outputs assigned to active level input type output sensors active level output drivers logic function input type voltage thresholds hysteresis outputs assigned to threshold events current thresholds hysteresis output assigned to threshold events 9 32 43 SAMWAY ShMC User Manual Rev 1 6 your way 6 6 1 Changing a threshold s value Disabling a Threshold Syntax local sensor sensor no threshold threshold code valu
9. 92 Outputi13 Output 0 De Asserted 93 Outputl4 Output 0 De Asserted 94 Output15 Output 0 De Asserted 95 Outputi16 Output 0 De Asserted 29 43 ShMC User Manual Rev 1 6 6 6 local sensor command SAMWAY lt lt lt your way Syntax local sensor sensor threshold threshold code value disable hysteresis hysteresis code value output threshold code hex outputs 9 activelevel 0111 fancontrol fancontrol mask output type OR AND input type mswitch on off assert deassert userpermission allow timeout time value debounce debounce value sensor no the local sensor number that identifies a particular sensor located on the Shelf Manager see 2 2 Sensor Numbers threshold code is defined in Table 3 Threshold Code hysteresis code is defined in Table 4 Hysteresis Code hex outputs defined in Table 5 Hex Outputs fancontrol mask defined in Table 6 Fancontrol Mask time value 0 15 debounce value 0 255 Threshold threshold code Lower Non Recoverable Inr Lower Critical lc Lower Non Critical Inc Upper Non Critical unc Upper Critical uc Upper Non Recoverable unr Table 3 Threshold Code Hysteresis hysteresis code Negative going Hysteresis Value neg Positive going Hysteresis Value pos Table 4 Hysteresis Code
10. Lan SOL configuration Whenever the SOL mode is activated the behavior of RS232 port will change All the data received on the serial port will be transmitted in telnet packets over Ethernet to all telnet connections opened on serial profile The data received from the telnet connections opened in serial mode is transferred to the serial port 6 20 date command Syntax date dd mm yyyy Functions displays or sets the current date Example 1 Check out of date S gt date Date dd mm yyyy 04 09 2012 Example 2 Setup of date date 13 10 2013 Done 6 21 time command Syntax time hh mm ss Functions displays or sets the current time Example 1 Check out of time gt time Time hh mm ss 16 52 27 41 43 SAMWAY ShMC User Manual Rev 1 6 your way Example 2 Setup of time S gt time 16 53 00 Done 6 22 sel command Syntax sel count clr print start_record_no end_record_no Functions The command can display the number of sel entries display a particular set of these entries or clear the sel To print the whole log use sel print To print all the records starting with a particular one use sel print record_no To print all records a give interval sel print start record record no Example 1 Readout of SEL 5 gt 5 1 print Sensor Event Log Rec ID dd mm yyyy hh mm ss Sensor No Name Event Ev Dir Value Threshold 0 0001 01 01 2012 00 00 00 97 SHMC Power ON
11. Repository Storage 22h Get SDR Storage 23h SEL Device Commands NetFn CMD Get SEL Info Storage 40h Reserve SEL Storage 42h Get SEL Entry Storage 43h Add SEL Entry Storage 44h Delete SEL Entry Storage 46h Clear SEL Storage 47h Get SEL Time Storage 48h Set SEL Time Storage 49h PICMG Commands NetFn CMD Get PICMG Properties PICMG 00h Get Address Info PICMG 01h Get Shelf Address Info PICMG 02h Set Shelf Address Info PICMG 03h FRU Control PICMG 04h Get FRU LED Properties PICMG 05h Get LED Color Capabilities PICMG 06h Set FRU LED State PICMG 07h Get FRU LED State PICMG 08h Set IPMB State PICMG 09h Set FRU Activation Policy PICMG FRU Activation Policy PICMG OBh Set FRU Activation PICMG Get Device Locator Record ID PICMG Get Fan Speed Properties PICMG 14h Set Fan Level PICMG 15h Get Fan Level PICMG 16h 12 43 SAMWAY ShMC User Manual Rev 1 6 your way 3 2 Shutting down a CPCI system The ShMC can be used to safely turn off a CPCI system The Shutdown and Power On processes are controlled either by a front panel push button or by the one available on the web page When a shutdown is commanded the ShMC informs the boards of the current request After all boards deactivate their OS and are ready to be turned off the ShMC disables the power supply for the chassis using the configured shutdown output pin The chassis can also be turned back on using the designated shutdown push button or the web
12. SnmpUserPrivacy for SNMP user privacy SnmpAdminAuth for SNMP admin authentication SnmpAdminPrivacy for SNMP admin privacy The authentication and encryption is disabled by default on both user and admin profiles so that the ShMC accepts SNMP vi SNMP v2c and unauthenticated SNMP v3 messages Te enable authentication use snmp command The SNMP data is structured in some categories system contains information about the ShMC name part number serial number MAC address and software version temp contains the number of temperature sensors and for each sensor the name value state thresholds and hysteresis Voltage contains the number of voltage sensors and for each sensor the name value state thresholds and hysteresis current contains the number of current sensors and for each sensor the name value state thresholds and hysteresis fan contains the number of fan sensors the speed level of each group of fans and for each sensor the name value state thresholds and hysteresis 25 43 SAMWAY ShMC User Manual Rev 1 6 m your way input contains the number of inputs and for each input the name and state Output contains the number of outputs for each output the name and state control this category allows different configurations to be done to the ShMC The RS232 speed and the user and
13. a PWM signal The fan control algorithm uses 15 distinct fan levels to represent the 0 100 duty cycle of the PWM signal Fan level 0 is equivalent to 0 and fanlevel 15 is equivalent to 100 duty cycle for the PWM signal 36 43 SAMWAY ShMC User Manual Rev 1 6 your way 6 7 1 Viewing the fancontrol status Syntax fancontrol If the command is used without any parameter it displays the current state of all the fan control groups and their respective parameters Example 1 Viewing the fancontrol status gt fancontrol Fan Control Current Manual Minimum Templ Temp2 Maximum Group Method Fan level Fan Level Fan level Temp 1 Manual 7 7 3 0 30 60 24 2 Auto 3 3 3 0 30 60 24 3 Auto 3 3 3 0 30 60 24 The fans can be controlled automatically using a control algorithm or manually by specifying a fan level By default all fan groups are controlled automatically 6 7 2 Setting a fangroup for auto control Syntax fancontrol group_no auto For controlling the fans speed automatically a set of the installed temperature sensors is used Every fan group has his own distinct set The fan speed is controlled in accordance with the algorithm described in chapter 1 4 1 Fan control and the maximum temperature of the sensors in it s set Example 2 Setting fancontrol group 2 to auto gt fancontrol 2 auto Done Fan Group 2 is controlled automatically 6 7 3 Viewing the temperature sensors associated with each fan group When i
14. change a particular output Example 11 Allow the user to change output 4 sensor 83 21ocal sensor 83 userpermission allow Done 6 6 10 Changing the timeout for an input Syntax local sensor sensor no timeout value The timeout option is available only for sensors assigned to digital inputs The digital outputs can have more than one driver If one of the drivers is a digital input it s timeout value can be used to define a time period in which only the input drives the output In the timeout interval only the value of the input determines the outputs value and all the other drivers are ignored After the timeout passes all the other drivers become active again and the output is controlled according 35 43 SAMWAY ShMC User Manual Rev 1 6 your way to it s logic function Ex Input 1 used as a Power on switch and Fan 1 lc threshold fan fail are controlling Output 1 a shutdown signal The shutdown signal should be active if either Power on is inactive or if fans fail But at start up when the Power on switch is pressed the Fans are stopped and the Fan fails signal will also be asserted In this case even if the Power on is pressed the shutdown signal is still asserted due to the fans being stopped If the timeout option is used for the active level of Input 1 Power on switch the input becomes the only driver for the output until the timeout passes thus allowing the fans sufficient time to start and reach a stable spee
15. default all boards are considered absent during this phase The normal operation phase of the web page is split in two processes A periodical process that check to see if new boards have been inserted or if boards have been removed Amouse click listener that changes the active object The periodic process issues a GET frustatus request at every 3 seconds By comparing the FRU list in the response and the FRUs loaded the page determines if boards have been inserted or removed For all the new boards the web page sends a GET picture FRU Address request and loads the received picture For all the boards that have been removed the web page also removes the picture Using the response for the frustatus request the web page also checks if new SEL events have occurred If the SEL count from the response is different from the one saved by the page a GET sel old count 1 new count request is sent Using the response the web page displays all the new SEL events The frustatus request is also used to detect restarts of the ShMC If the Boot count in the response is different than the saved one the WEB page is restarted all pictures are removed and all the internal variables are reinitialized The WEB page uses a mouse click listener to determine if the current selected object has been changed The WEB page uses two types of objects FRU images FRU sensors At each mouse click the WEB page determines if the active object has been changed
16. drivers is asserted Example 9 Setting the logic function of output 1 to AND 34 43 SAMWAY ShMC User Manual Rev 1 6 your way gt local_sensor 80 output_type AND Operation Successful 6 6 7 Changing the input type Syntax local sensor sensor input type mswitch on off The input type parameter is available only for input sensors and determines the way the value of the sensor assigned to the digital input changes There are two input types o ON OFF regular digital input o Momentary Switch this type of input is used for push buttons the sensor assigned to a input of this type has it s value toggled at every active level of the input Example 10 Setting input 1 as a momentary switch gt 1 1 sensor 64 input type mswitch Operation Successful 6 6 8 Asserting Deasserting an output Syntax local sensor sensor assert deassert This command is used to assert or deassert one of the 16 digital outputs Only the admin can assert or deassert outputs The user has it s permission denied when he tries to use this command Example 11 Asserting Output 4 sensor 83 local sensor 83 deassert Done 6 6 9 Changing the user s permission to assert deassert an output Syntax local sensor sensor no userpermission allow deny By default only the admin can assert deassert the digital outputs The user is denied when he tries to change the state of the outputs This command is used to allow or deny the user to
17. gt lt name gt V0 lt name gt lt type gt 2 lt type gt lt ev_type gt LNC lt ev_type gt 19 43 SAMWAY ShMC User Manual Rev 1 6 your way ev dir2Asserted ev dir lt val gt 0 00 lt val gt lt thr gt 2 86 lt thr gt lt rec gt lt sel gt fruinfo FRU_Address FRU_Id This command retrieves a text file containing the FRU information for the desired FRU Id on the specified card The command uses two parameters FRU Address the IPMB address of the card hexadecimal value FRU Id used to distinguish between multiple FRUs located on the same card The FRU Id for the Module Management Controller MMC the card itself is 00 Request GET fruinfo FRU Address FRU 14 IP Address fruinfo FRU Address FRU 192 168 16 1 fruinfo 0x82 0 Response text file 20 43 SAMWAY ShMC User Manual Rev 1 6 your way sensor FRU Address FRU Id This command retrieves all the sensor associated to a FRU Id of a card The command uses two parameters FRU Address the IPMB address of the card hexadecimal value FRU Id used to distinguish between multiple FRUs located on the same card The FRU Id for the Module Management Controller card itself 15 00 If this parameter is missing the ShMC will return the sensors associated to FRU Id 0 The ShMC responds to this request using an XML file that contains the following tags lt name gt sensor name lt value gt sensor value l
18. maximum value of all the temperature sensors active for the respective fan control group If no temperature sensors are active for a particular fan group the fan control algorithm sets 1 The ShMC can output 3 PWM signals with frequencies between 1 KHz and 125KHz The frequency of PWMI is equal to that of PWM2 but the duty factors of the 2 PWM signals are independent 5 43 SAMWAY ShMC User Manual Rev 1 6 your way the fans to run at the maximum level The 3 fan control groups are independent each have their own minlevel tempO temp1 temp2 parameters and each control a different PWM signal The automatic fan control algorithm can also be disabled In this case the fan speed is set at a fixed manual level Each fan control group has it s on own manual fan level which can be changed using the CLI via RS232 or Telnet Commands useful for fan control fancontrol pwm temp 1 4 Digital Inputs 16 digital inputs Logic level 5V TTL Each individual input can be declared as active low or active high Any active input generates an internal event and can control any of the 16 digital outputs Commands for inputs input local sensor 1 5 Digital Outputs 16 digital outputs Each individual output can be declared as active low or active high Manual setting and clearing of outputs Each output can be driven by more than one source Potential output drivers are o Internal Events threshold violations for threshold sen
19. profile The data received from the telnet connections opened in serial mode is transferred to the serial port This feature allows remote control of a CPU card inside the system For this the CPU terminal screen should be redirected to the serial port and the serial 24 43 SAMWAY ShMC User Manual Rev 1 6 your way port of the CPU needs to be connected with the serial port of the ShMC Default access settings login serial password SERIAL In SOL mode the SysRq key could be send by sending a Telnet break Note If SOL mode is used it is recommended to make the SOL mode as default using sol command 4 3 SNMP The ShMC supports SMNP v1 v2c and SNMP v3 with authentication and encryption The software supports MD5 for authentication while for privacy supports DES and AES For application where data security is an issue SNMP v3 with authentication and encryption could be used For such applications the telnet and the web interfaces could be disabled to prevent not secured connections to the ShMC To disable the Telnet or Web interface use the eth command or write the SNMP variables telnet and web to 0 in the control node When the SNMP is configured to use authentication in version 3 see snmp command and the authentication password is not empty the SNMP vi and V2C are disabled Only SNMP v3 authenticated messages are accepted The default SNMP v3 passwords are SnmpUserAuth for SNMP user authentication
20. 1 Asserted 0x0002 01 01 2012 00 00 00 2 VO LNC As 0 00 2 86 0x0003 01 01 2012 00 00 00 4 V2 LC As 0 00 11 38 0 0008 01 01 2012 00 00 00 7 V5 LC As 0 00 0 66 0x0009 01 01 2012 00 00 00 9 VI LC As 0 00 12 39 0x000A 01 01 2012 00 00 00 2 vo LC As 0 00 299 Ox000C 01 01 2012 00 00 00 64 Inputl 1 Asserted Ox000D 01 01 2012 00 00 00 65 Input2 1 Asserted 00 01 01 2012 00 00 00 66 Input3 1 Asserted Ox000F 01 01 2012 00 00 00 67 Input4 1 Asserted 0 0019 01 01 2012 00 00 00 14 1 Asserted 1 01 01 2012 00 00 00 78 Input15 1 Asserted 0x001B 01 01 2012 00 00 00 79 Inputl6 1 Asserted Example 2 SEL clearing S gt sel clr Done Sel is empty 6 23 help command Syntax help v Functions Displays a list of all available commands or a more detailed description if the verbose attribute is used v 6 24 snmp command Syntax snmp user admin auth md5 none privacy des aes none Functions Configure the SNMP v3 authentication and privacy settings for user and admin profiles 6 25 eth command Syntax eth telnet web on off 42 43 SAMWAY ShMC User Manual Rev 1 6 your way Functions Enables disables the telnet and web interfaces 6 26 tftp command Syntax tftp firmware web config tftp_server_ip_address filename Functions Uploads new firmware web page or configuration file by TFTP 6 27 shelfaddr command Syntax shelfaddr set cpci lt value gt
21. 6 Fancontrol TT 30 3 43 SAMWAY ShMC User Manual Rev 1 6 your way 1 Product description and functions Samway s Shelf Manager ShMC watches over the basic health of the System Platform reports anomalies and takes corrective action when needed The Shelf Manager can retrieve inventory information and sensor readings The Shelf Manager can also perform basic recovery operations such as power cycle or reset of managed entities The Shelf Manager provides remote access to the monitored information The monitored parameters of the System Platform are measured or read in and analyzed at regular intervals If a parameter value exceeds or falls below a user defined limit the ShMC detects this as an Event In principle fixed predefined actions are carried out when the corresponding events occur These actions are described later It is also possible to use such Events to trigger one or more of the digital Outputs The ShMC uses Sensor Data Records compliant to IPMI 2 0 to describe the monitored System parameters For any measured parameter up to 6 thresholds can be defined lower non critical lower critical lower non recoverable upper non critical upper critical and upper non recoverable The measured values are retrievable at any time via the RS232 serial interface and via Telnet In addition limits and system parameters can be changed at any time with the unit in service As a result the ShMC and hence the connected
22. SAMWAY ShMC User Manual Rev 1 6 your way Shelf Manager User Manual Revision history 26 11 2014 REV 1 6 Changed lanconfig command added support for two separate IPMBs in CPCI added hostname and shelfaddr commands 13 05 2014 REV 1 5 Added IPMB Interface chapter 13 05 2014 REV 1 4 Added lanconfig command 11 11 2013 REV 1 3 AES added to SNMP WEB section content updated 04 02 2013 REV 1 0 First Draft Table of Contents Ar G nv canc ac calo dat us 09010000 17 LM NES REST 13 mCP HRR 17 CIR NUBE CNRC 23 NUM RR RTT s 24 SAMWAY ShMC User Manual Rev 1 6 SSS your way 6 6 3 Changing the outputs linked t Sensor iuis adt debe tagen arat 33 6 6 4 Changing the 34 6 6 6 Chansing the output coco irae sposi Duce dean an sicca os deste enda br 34 Changing The sineret ana e ba ad cab ole cts ia roe ted 35 6 6 8 Asserting Deasserting iu iii ese saca teda asa ela 35 6 7 7 Changing the temp0 temp1 temp2 parameters of the fancontrol alg
23. admin passwords could be read or changed the Telnet and Web interfaces could be enabled disabled The configuration settings could be saved and the ShMC could be restarted 4 4 RMCP The ShMC supports Remote Management Control Protocol RMCP The RMCP connections requires authentication The supported authentication protocol is MD5 Two user names are accepted for RMCP connections user with User privilege level and admin with Administrator privilege level The user names and privilege levels are fixed they cannot be changed through IPMI commands The password used are the same passwords configured for Telnet CLI SNMP v1 and v2c access The default passwords are USER for user profile and ADMIN for admin profile 5 RS232 serial interface The ShMC provides an RS232 serial interface through which the commands of the Command Line Interface CLI can be sent On Windows systems we recommend the use of TeraTerm or Hyperterminal as the terminal programs Default Terminal settings 19200 bits per second data bits 8 parity none stop bit 1 The baud rate of the RS232 Serial Interface can be changed The available baud rates are 9600 19200 38400 115200 To change the speed of the Serial Interface use the scispeed command In addition the xmodem command can be used via the serial interface for file transfer Use a 1 1 serial cable for direct connection to the serial port of a PC When using xmode
24. al threshold value if the lc threshold is enabled Inr lower non recoverable threshold value if the Inr threshold is enabled hyst pos positive going hysteresis value lt neg negative going hysteresis value nominal reading normal maximum normal minimum maximum reading minimum reading Request GET sdr FRU Address sensor No IP Address sdr FRU Address sensor 192 168 16 1 sensor 0x10 5 Response 9 9 9 lt xml versionz 1 0 sensor 5 gt name V3 name entity id20x01 entity id entity instance20x61 entity instance lt gt 11 34 lt gt lt gt 12 64 lt gt hyst pos 0 07 hyst pos hyst neg20 07 hyst nominal reading 14 00 nominal reading normal maximum 14 00 normal maximum normal minimum 14 00 normal minimum maximum reading22 58 maximum reading minimum reading 14 00 minimum reading sensor picture FRU Address This command retrieves the pictures for the boards and system platform Address the IPMB address of the card hexadecimal value For the picture of the System platform the request uses FRU Address 0 Request GET picture FRU Address IP Address picture FRU Address 192 168 16 1 picture 0x80 192 168 16 1 picture 0 Response picture file 22 43 ShMC User Manual Rev 1 6 4 1 4 How it all works status P
25. ave to use xmodem configfile and upload a Configuration file that contains the required setup 43 43
26. both human readable and machine readable The design goals of XML emphasize simplicity generality and usability over the Internet The ShMC WEB page is composed of objects board and system images sensors information display areas When an object is selected by a mouse click the web browser requests predefined XML files using predefined commands The information contained by the XML files returned by the ShMC 15 parsed in the information display windows The XML files could also be requested by an application software in case a custom managing solution is required The format of the XML files is described in the following chapter 4 1 3 REST Commands settings For this request the ShMC returns an XML file containing the following tags lt mac_addr gt lt serial_no gt lt host_name gt lt firmware gt firmware version lt uptime gt the amount of time the ShMC has been operational lt H gt hours o minutes lt S gt seconds Request GET settings IP Address settings ex 192 168 16 1 settings Response lt xml versionz 1 0 settings lt mac_addr gt 0 80 194 242 80 0 lt mac_addr gt 8 0000000000 8 17 43 ShMC User Manual Rev 1 6 host name ShMC 2013 host name firmware 1 6 firmware uptime H 0 H lt M gt 31 lt M gt lt S gt 21 lt S gt lt uptime gt lt settings gt frustat
27. d before they are taken into consideration for shut down By default all inputs have a timeout value of 0 disabled Timeout values 0 15 seconds Example 11 Set a 2 seconds timeout for input 2 sensor 65 21ocal sensor 65 timeout 2 Done 6 6 11 Changing the debounce option Syntax local sensor sensor no debounce debounce value sensor identifies the sensor that will be set up to drive the led debounce value 0 254 Enables or Disables the debounce option for a particular sensor Debounce is available only for threshold discrete and input sensors The debounce parameter establishes the number of times a sensor is allowed to be out of spec before it is reported as failing If debounce is the sensor is reported as failing the first time it is out of spec Example 17 Set debounce value for sensor 2 5 gt 1 sensor 2 debounce 2 Done In this case sensor 2 has to fail 3 times before it is reported as failing 6 7 fancontrol command Syntax fancontrol sensor group no auto manual level va ue minimum level va ue 1 2 t value 1 group no 1 3 manual level and minimum level value 0 15 t value 20 100 Celsius degrees Functions The fancontrol command is used to modify parameters for the fan control algorithm For more details about the algorithm that is used to control the fan speeds refer to 1 4 1 Fan control Each fancontrol group represents
28. d parameter For accessing local sensor information there are two options displaying information for multiple sensors accessing each sensor individually using its number For accessing all the sensors the command ocal sensor is used Also the user can access information regarding sensors of a particular type using one of the commands voltage current temp fan input output the commands that display sensor information use the same header The header displays no sensor number a unique number that identifies a particular sensor Name gt sensor s name gt sensor type threshold or discrete Value gt current value Unit gt measuring unit State current state for threshold sensors Depending on the sensor s current value it s state could be 99 9 Lower Non Recoverable Lower Critical Lower Non Critical Upper Non Critical Upper Critical Upped Non Recoverable o o o 7 43 SAMWAY ShMC User Manual Rev 1 6 your way The ocal sensor command can also be used to display a a more detailed description for a single sensor name type value threshold values sensor state outputs assigned to threshold events fan control groups the sensor is assigned to only for temperature sensors active level for discrete sensors output function for output sensors active drivers for output sensors For the complete syntax of the commands refer to the chapt
29. e disable threshold code is defined in Table 3 Threshold Code The sensors used to monitor the system s parameters are described by full sensor records and support up to 6 thresholds The threshold can be enabled or disabled by this command To activate a disabled threshold all you have to do is set an appropriate value for it To disable an active threshold you have to use this command with the disable parameter The threshold code parameter represents an abbreviation of the threshold that needs to be changed The value change operation will be successful only if the new value for the threshold is compliant to the monotony rule for thresholds Inr lt Ic lt Inc lt unc lt uc lt unr The new value is compared only with the values of active thresholds Example 3 Changing the upper critical threshold of temp 3 sensor 28 local sensor 28 threshold uc 45 Operation Successful Example 4 Disabling the upper critical threshold of temp 3 sensor 28 gt 1 1 sensor 28 threshold uc disable Threshold disabled 6 6 2 Changing the hysteresis Syntax local sensor sensor no hysteresis hysteresis code value hysteresis code is defined in Table 4 Hysteresis Code Hysteresis can be modified only for threshold sensors Sensors described by full sensor records support 2 hysteresis values The Aysteresis code parameter represents a abbreviation of the hysteresis that needs to be changed Hysteresis values can be chang
30. e baud rate at which the CLI for the ShMC and the bootloader framework operate For the change to become valid the environment has to be saved using the saveenv command and the ShMC has to be restarted either using the reboot command or by using the reset key The baud rate is changed at the next power up Example 1 gt 9600 Baud rate changed to 9600 Save Environment and reboot 6 12 passw command Syntax passw snmp auth priv Function Changes the log in or snmp passwords for the current user For log in password if instead of the new password an empty string is entered password checking for the respective user is disabled 6 13 reboot command Syntax reboot 39 43 SAMWAY ShMC User Manual Rev 1 6 your way Function Restarts the ShMC 6 14 uptime command Syntax uptime Function Displays the amount of time which has past since the last ShMC power up 6 15 saveenv command Syntax saveenv Function Saves the parameters that were changed If the modified parameters are not saved they will be lost at the next reboot 6 16 version command Syntax version Function Displays information about the ShMC Part Number Software Version MAC Address and Serial Number 6 17 restore command Syntax restore Function Restores all parameters to the default values For the restore to be complete a reboot is necessary 6 18 lanconfig command Syntax Syntax lanconfig settings
31. each fans speed Speed control via 3 fan control groups Any limit infringement is an internal event and can control any of the 16 digital Outputs Commands for the fan monitoring fan local sensor 4 43 SAMWAY ShMC User Manual Rev 1 6 your way 1 3 1 Fan control The Speed of the fans can be controlled using one of the 3 fan control groups Each group controls an independent PWM signal using a user defined temperature speed characteristic Speed Max level 15 minlevel 20 C tempO tempi temp2 120 C Temperature Figure 1 Fan Control Algorithm The user can define the temperature speed characteristic using 4 parameters min level the minimum level at which the fans operate and temperature thresholds tempO tempi temp2 The speed of the fans is split in 15 equal levels At level the fans are stopped and at level 15 the fans are running full speed The 3 temperature thresholds split the operating range of the fan in 4 control regions Temperature T Fans Behavior T temp0 Stopped temp0 T lt templ Running at min level templ T temp2 Running at a speed level proportional to T temp2 lt T Running at full speed Table 1 Fan Control Algorithm The Fan control algorithm can use any of the installed temperature sensors The user can choose the active temperature sensor for each fan control group The temperature that drives the algorithm is the
32. ed only for sensors that support hysteresis k In other cases the following warning message will be displayed Sensor does not support Hysteresis Example 4 Changing the positive going hysteresis of 3 3V sensor 2 a gt 1 1 2 hysteresis pos 0 04 Operation Successful 6 6 3 Changing the outputs linked to a sensor event Syntax local sensor sensor no output threshold code hex outputs threshold code is defined in Table 3 Threshold Code hex outputs is defined in Table 5 Hex Outputs 33 43 SAMWAY ShMC User Manual Rev 1 6 your way The outputs assigned to sensor events parameter can only be set individually for each sensor and each event Outputs can be linked to thresholds infringements for threshold sensors or to the active level for discrete sensors For threshold sensor the command uses the threshold code parameter for identifying the event to which the outputs defined by hex outputs are linked In the case of discrete sensor the outputs are automatically linked with the active level so the threshold code parameter is not used If a bit of hex outputs is 1 the corresponding output will be linked to the corresponding event For example if outputs 1 5 and 8 need to be linked with an event hex output 0x0091 Example 5 Assigning outputs 1 and 2 to the lower critical threshold of fan 2 sensor 38 gt 1 1 sensor 38 output lc 0x0003 Operation Successful Example 6 Assigning outp
33. el for fan group 3 gt 3 manual level 13 Manual Fanlevel 13 Using the fancontrol command the user can change the value for all the fan control algorithm s parameters minimum level tempO temp1 temp2 Each fan group has it s own parameters 6 7 6 Changing the minimum level parameter of the fancontrol algorithm Syntax fancontrol group no minimum level eve value The minimum level parameter determines the speed of the fans when the maximum temperature of the sensors is bellow the tempO parameter Example 6 Changing the minimum fan level for fan group 1 5fancontrol 1 minimum level 1 Minimum Fanlevel 1 6 7 7 Changing tempO tempi temp2 parameters of the fancontrol algorithm Syntax fancontrol group no tempO temp1 temp2 temp value The tempx parameters are used by the fancontrol algorithm For more details refer to 1 4 1 Fan control Example 7 Changing the temp1 parameter for fan group 1 gt 1 templ 34 Temp1 34 6 8 pwm command Syntax pwm pwm no freq freq value pwm no 1 3 freq value 1 125 Khz Functions If used without parameters displays the status of all the PWM signals The command can also be used to change the frequency of one of the 3 PWM signals Example 1 Status reading for pwm signals 5 gt Pwml Freq 25 Khz Duty Cycle 28 Pwm2 Freq 25 Khz Duty 1 1005 Pwm3 Freq 25 Khz Duty 1 1005 Pwml and Pwm2 share the same f
34. er 5 Command Line interface CLI 2 2 Local Sensor Numbers This section refers to the local sensors implemented on the Shelf Manager The correspondence between the sensor numbers and monitored parameters is defined in a table presented bellow on the monitored system the ShMC can be set up differently Not always all the sensors described bellow are available To check out all the installed sensors you can use the oca sensor command The ShMC monitors only the parameters for which a SDR has been uploaded The monitored E set can be changed by uploading a new SDR set The SDRs are encapsulated in a m configuration file Besides the SDRs the config file also hosts several other ShMC parameters Sensor Number Monitored System Parameter 1 VO Voltage V1 Voltage V2 Voltage V3 Voltage V4 Voltage V5 Voltage V6 Voltage V7 Voltage N Temperature sensor 1 27 Temperature sensor 2 28 Temperature sensor 3 29 Temperature sensor 4 30 Temperature sensor 5 31 Temperature sensor 6 37 Tachometer signal for Fanl 38 Tachometer signal for Fan2 39 Tachometer signal for Fan3 40 Tachometer signal for Fan4 AB Tachometer signal for 5 8 43 ShMC User Manual Rev 1 6
35. hex outputs bit Value Output 16 Output 15 Output 14 Output 13 Output 12 30 43 ShMC User Manual Rev 1 6 Functions 10 Output 11 9 Output 10 8 Output 9 7 8 6 7 5 Output 6 4 Output 5 3 Output 4 2 Output 3 1 Output 2 0 Output 1 Table 5 Hex Outputs Bit Mask SAMWAY your way fancontrol mask bit Bit value Details 7 3 0 Reserved 1 sensor active 2 Sensor active state for PWM 3 Oicencar nace 1 Sensor active state for PWM 2 1 0 sensor inactive 0 Sensor active state for PWM 1 Sensor active 0 sensor inactive Table 6 Fancontrol_Mask The local_sensor command can be used either to access information about the Shelf Manager local sensors or to change different sensor parameters If the command is used without any parameter it will return basic information about all the active sensors For each installed sensor the command displays local sensor number sensor name sensor type current value measuring unit only for threshold sensors current state only for threshold sensors Example 1 Read all the active sensors local sensor X 3h0 ccName 2 3 3V 3 5V 4 127 5 12V 26 Templ 27 Temp2 45 9 46 10 47 Fanll 48 12 64 Inputl 65 Input2 66 Input3
36. indexes start end to define the desired number of records The ShMC returns an XML file that contains all the event records that have an index between the start index and the end index The XML file uses the following tags 9 9 rec id the index of the current record tmp the time when the event was triggered lt addr gt address of the card that launched the event lt lun gt the LUN on which the sensor resides no sensor number lt name gt sensor name type code representing the sensor type sta sensor state available only for discrete sensors ev type threshold that triggered the event for threshold sensors UNR upper non recoverable UC upper critical UNC upper non critical LNC lower non critical LC lower critical LNR lower non recoverable ev dir Asserted DeAsserted val sensor value lt thr gt threshold value Request GET sel start index end index IP Address sel start index end index ex 192 168 16 1 sel 1 2 Response xml versionz 1 0 sel rec id 1 gt tmp 1325376000 tmp lt gt 0 72 lt gt lt lun gt 0 lt lun gt lt gt 97 lt gt lt name gt SHMC Power lt gt lt type gt 192 lt type gt lt sta gt 0 lt sta gt lt rec gt rec id 2 gt lt tmp gt 1325376000 lt tmp gt lt addr gt 0x72 lt addr gt lt lun gt 0 lt lun gt lt no gt 2 lt no
37. is changed depending on the selected object 2 FRU info displays the FRU information for the selected object board or system platform Sensor info displays the values names and status for all the sensors of the selected object the sensors are considered objects and can be selected using a mouse click 4 System Event Log SEL displays all the sensor events received by the Shelf manager starting from the moment the Web page has been loaded 5 Info Area displays more details for the selected sensor threshold and hysteresis values or if no sensor is selected displays ShMC attributes MAC address Serial number Firmware version 6 Uptime displays the amount of time the ShMC has been operational It is reset at each ShMC restart 16 43 SAMWAY ShMC User Manual Rev 1 6 your way 4 1 2 Architecture The Web Server uses a Representational State Transfer REST based architecture and Extensible Markup Language XML files REST is an architectural style that abstracts the architectural elements within a distributed hypermedia system REST ignores the details of component implementation and protocol syntax in order to focus on the roles of components the constraints upon their interaction with other components and their interpretation of significant data elements REST has emerged as a predominant web API design model XML is a markup language that defines a set of rules for encoding documents in a format that is
38. l of the ShMC The use of standard protocols avoids the need for special software or drivers and so achieves platform independence The TCP IP protocol supports up to 10 simultaneous connections factory default setting for the ShMC is DHCP enabled so it negotiates automatically all the necessary addresses If a fixed IP address is desired DHCP must be disabled and the address has to be set manually For all these operations the lanconfig command needs to be used Terminal settings Local echo off Local line editing off Backspace key Control H 4 1 WEB The Shelf Manager includes a built in WEB server that provides a simple way to access the management information 4 1 1 Overview The WEB page can be designed as a graphical representation of the monitored System Platform thus providing a very intuitive way of obtaining system board information Figure 2 exemplifies the web page for a 5 slot ATCA system The available information includes Board Carrier Shelf Field Replaceable Unit FRU information file Manufacturer s Name Part number Serial Number Board Connectivity Records Sensors information value name measuring unit status threshold and hysteresis values System Event Log SEL sensor events ShMC attributes MAC address Serial number Firmware version 15 43 SAMWAY ShMC User Manual Rev 1 6 your way a ECCE K c A v SAMWAY your wa
39. m in Hyperterminal the transfer of the desired file can take up to 10 BH seconds to start 6 Command Line Interface CLI The Command Line Interface short form CLI is available via both Telnet 3 Ethernet interface and the RS232 serial interface 4 RS232 serial interface The user can read or newly configure and save system parameters via the CLI Access is divided into 2 profiles and is password protected 26 43 SAMWAY ShMC User Manual Rev 1 6 your way user profile System parameters can only be read in this profile the exception to this write protect is the lanconfig command for setting the IP subnet and gateway addresses admin profile Full access to all system parameters is granted All available CLI commands can be executed To avoid possible damage or malfunctions the access data for this profile must only be available to trained personnel with appropriate knowledge and competence relating to the system in which the ShMC is used The profiles can be changed using the ogout command The measured values are available at any time via the RS232 serial interface and via Telnet In addition limits and system parameters can be changed at any time with the unit in service As soon as you have established a connection you will be prompted to log in Default access settings login user password USER login admin password ADMIN The passwords be changed using the passw command The pas
40. n auto mode the fan level is controlled by the fan control algorithm and the maximum temperature in the temperature sensors set that is used for that particular fan group Syntax fancontrol sensor Example 3 Viewing the temperature sensors associated with each fan group fancontrol sensor Sensors assigned to Fan Group Sensor 26 Templ 23 00 deg Sensor 30 Temp5 24 00 deg Sensor 31 24 00 deg Sensors assigned to Fan Group Sensor 26 1 23 00 deg Sensor 30 5 24 00 deg Sensor 31 Temp6 24 00 deg Sensors assigned to Fan Group Sensor 27 Temp2 23 00 deg Sensor 28 Temp3 23 00 deg Sensor 29 Temp4 23 00 deg Sensor 31 24 00 deg AAAAWBWAAANADAAAF 6 7 4 Setting a fangroup for manual control Syntax fancontrol group_no manual When a fan control group is controlled manually it s fan level is specified by the manual level parameter Example 4 Setting fancontrol group 1 to manual control 2fancontrol 1 manual Done Fan Group 1 is controlled manually using the manual Fan level value 6 7 5 Changing the manual fancontrol level Syntax fancontrol group no manual level eve value 37 43 SAMWAY ShMC User Manual Rev 1 6 your way The value for the manual fan level can be choosen between the 15 allowed levels For level 0 the fans are stopped PWM duty cycle 096 and for level 15 the fan are running at full speed PWM duty cycle 10096 Example 5 Changing the manual fan lev
41. nd displays sensor number sensor name sensor type current value measuring unit current state Example 1 fan sensor values read out gt fan Meuse le ae Sensor no Name Type Value Unit State 37 1 Thr 8800 RP Ok 38 Fan2 Thr 2700 RP Ok 39 Fan3 Thr 2700 RP Ok 40 Fan4 Thr 2600 RP Ok 41 Fan5 Thr 4800 RP Ok 42 Fan6 Thr 8800 RP Ok 6 3 temp command Syntax temp Functions Displays information about all the installed temperature sensors For each installed sensor the command displays sensor number sensor name sensor type current value measuring unit current state Example 1 temperature sensor values read out temp aa eee Sensor ee Type Value Unit State 26 Templ Thr 26 00 deg C Ok 27 Temp2 Thr 26 00 deg C Ok 28 Temp3 Thr 26 00 deg C Ok 29 Temp4 Thr Not Present 30 5 Thr Not Present 31 Tempo Thr Not Present 28 43 SAMWAY ShMC User Manual Rev 1 6 your way 6 4 input command Syntax input Functions Displays information about all the input sensors For each sensor the command displays sensor number sensor name sensor type current value Example 1 Input sensors values read out input noc eas Sensor List
42. orithm 38 6 8 PWM 38 0 16 WErSiOn COMMA ode edat cu vedo ctu Todo to su ba Cos Todo Lo o Eod v Tod lo solatur c nou Mod 40 6 17 restore ie Ge bo so vOv Dos eR Pose eso une 40 6 28 WO 5560 eite eaae bo Qa ERE ERA ERE 43 T Restore to factory defaults DEOCeQUES cere te ode P a d 43 List of Figures Figure l Fan Control oe ala EON 5 Figure 2 Board Shutdown IPMI epe DEREN EE EU PAREN ERU 14 Figure 3 Web Interface OVELVIGNV eset bantnr a MEER Ee 16 Figure 4 Default Web Page Functional Dig grain 22 List of Tables Table Control A ORE asser utet pi asp 5 Table 2 Local Sensor INUBIDEES sse d qu ur PUE 9 Table 3 Threshold M cux GR a RA 29 SAMWAY ShMC User Manual Rev 1 6 SSS your way 4 15 nri 29 Table 5 Hes Outp ts Bit M SE eris mts 30 Table
43. page control As CPCI boards do not require activation the power on process resumes at using the configured shutdown output to enable the chassis power supply The soft shutdown of the boards consists of ACPI Advanced Configuration and Power Interface Specification related IPMI commands Get ACPI State e Chassis Control For the Chassis Control command only the Soft Shutdown and Power Down options are used The board shutdown IPMI communication protocol is depicted in the following figure 13 43 SAMWAY ShMC User Manual Rev 1 6 your way Board Shutdown Requested ste Get ACPI Power State Chassis Control w Soft Shutdown Completion Cotes Command Not Supported in Current State ACPI Power State Legacy Off unknown Get ACPI Power State NE E ACPI State 5 G2 Legacy Off unknown Board Shutdown Complete Timeout Power Down Figure 2 Board Shutdown IPMI Protocol 14 43 SAMWAY ShMC User Manual Rev 1 6 your way 4 Ethernet interface The integrated 10 100Mbps Ethernet interface allows the ShMC to be linked to any existing network The interface supports DHCP SNMP TFTP HTTP and TELNET protocols via TCP IP and UDP monitored system parameters can be displayed via a standard browser HTTP protocol The Command Line Interface CLI is accessible via TELNET allowing remote contro
44. ported command list SAMWAY your way IPM Device Global NetFn CMD Commands Get Device ID App 01h Cold Reset App 02h Get Self Test Results App 04h Get ACPI Power State App 06h Send Message App 34h Get Channel Authentication Capabilities App 38h Get Session Challenge App 39h Activate Session App 3Ah Set Session Privilege Level App 3Bh Close Session App 3Ch Get Session Info App 3Dh Chassis Commands NetFn CMD Get Chassis Capabilities Chassis 00h Get Chassis Status Chassis 01h Chassis Control Chassis 02h Event Commands NetFn CMD Set Event Receiver S E 00h Get Event Receiver S E 01h Platform Event S E 02h Sensor Device Commands NetFn CMD Get Device SDR Info S E 20h Get Device SDR S E 21h Reserve Device SDR Repository S E 22h Set Sensor Hysteresis S E 24h Get Sensor Hysteresis S E 25h Set Sensor Threshold S E 26h Get Sensor Threshold S E 27h Set Sensor Event Enable S E 28h Get Sensor Event Enable S E 29h Get Sensor Reading S E 2Dh FRU Device Commands NetFn CMD Get FRU Inventory Area Info Storage 10h Read FRU Data Storage 11h Write FRU Data Storage 12h 11 43 ShMC User Manual Rev 1 6 SAMWAY zz your way SDR Device Commands NetFn CMD Get SDR Repository Info Storage 20h Reserve SDR
45. requency but can have different duty cycles The pwm command can also be used to change the frequency of the PWM signals If the frequency is changed for one signal it will change for both Even tough the frequency is the same for the two PWM signals the duty cycles are independent I PWM1 and PWM2 share the same frequency Example 2 Changing PWM1 frequencies to 25 KHz 5 gt 1 freq 25 Pwml and Pwm2 share the same frequency but can have different duty cycles 38 43 SAMWAY ShMC User Manual Rev 1 6 your way 6 9 command Syntax xmodem configfile localfru shelffru shmcfru web Functions Sends via RS232 a configuration file a fru file for a local FRU the fru file for the Shelf the fru file for the ShMC or the web page After the command is entered the ShMC goes into data receive mode and waits for the data to be sent You can then start the file transfer with your terminal program and select XMODEM as the protocol When using xmodem Hyperterminal the transfer of the desired file can take up to 10 seconds to start Only the admin can use the xmodem command Example 1 Sending of the config file gt configfile Please upload the file gt 6 10 logout command Syntax logout Function Logs out the current user and permits a new log in 6 11 scispeed command Syntax scispeed 9600 19200 38400 115200 Functions Changes th
46. sors active levels for discrete sensors o External Events active inputs Each output can perform an AND an OR function on the driving signals AND outputs are active if all the drivers are active OR outputs are active when at least one of the drivers is active Commands for outputs output local sensor 6 43 SAMWAY ShMC User Manual Rev 1 6 your way 2 Sensor Data Records SDRs The ShMC uses Sensor Data Records SDRs compliant to IPMI 2 0 to describe the monitored System parameters SDRs are records that contain information about the type of sensors in the platform sensor threshold support and event generation capabilities Using SDRs the user can specify up to 6 thresholds decide the way the software treats a limit infringement events and outputs can be enabled or disabled for each individual threshold seta name for every sensor change the way the ShMC operates by changing the sensor definitions enable disable the monitoring of a sensor by loading removing its SDR change monitoring parameters by CLI commands or by changing the SDRs For more information on SDRs you could refer to IPMI Intelligent Platform Management Interface Specification Second Generation v2 0 2 1 Accessing Local Sensor Information The ShMC monitors many parameters of the system platform Every monitored parameter has one and only one software sensor attached So each sensor corresponds to only one monitore
47. swords can also be B disabled by changing them to an empty string General syntax conventions Command parameter1 parameter2 parameter3 va ue optional A command on its own with no entry of other parameters returns all available current values associated with the command The parameters separated by rule out each other If the command line contains a value this is assigned to the corresponding parameter and saved temporarily in the RAM The change is active immediately If the new value is desired to be valid after the reboot the environment variables must be saved with the saveenv command Changes not confirmed with saveenv are lost after a reboot 6 1 voltage command Syntax voltage Functions Displays information about all the installed voltage sensors For each installed sensor the command displays sensor number sensor name sensor type current value measuring unit current state 27143 SAMWAY ShMC User Manual Rev 1 6 your way Example 1 voltage sensor values read out S gt voltage 7 lt lt lt lt lt 4 Sensor List s ss Sass SS seqssese ssa no Name Type Value Unit State 2 VO Thr 1 00 V Lower Non Recoverable 3 Vl Thr 2 30 V Ok 4 V2 Thr 4 55 V Lower Critical 6 2 fan command Syntax fan Functions Displays information about all the installed fan speed sensors For each installed sensor the comma
48. system can be controlled and monitored online via any computer with an Internet connection To complete the information spectrum the integrated web page which the user can design himself is also continuously updated with the measured values 1 1 Voltage monitoring Monitoring of up to 8 voltages 3 3V 5V 12 12V and 4 user defined voltages Up to 6 thresholds can be configured individually for each voltage Any limit infringement is an internal event and can control any of the 16 digital Outputs Voltage monitoring parameters can be changed via the CLI or by upgrading the Sensor Data Records SDRs CLI Commands for the voltage monitoring voltage local sensor 1 2 Temperature monitoring Monitoring of up to 6 analog temperature sensors 10 Kohm NTC thermistors with 8 3950 Up to 6 thresholds can be individually configured for each temperature sensor Temperature range from 209 to 100 C Temperature measurement accuracy 3 max Any limit infringement is an internal event and can control any of the 16 digital Outputs Any temperature sensor can be used in the fan control algorithm The user can choose for each temperature sensor the fan control groups the sensor is active for Commands for the temperature monitoring temp local sensor 1 3 Fan monitoring and control Monitoring of up to 12 fans Control of PWM fans Up to 6 thresholds can be individually configured for
49. t unit gt sensors unit of measurement lt state gt sensor state Inr lc Inc unc uc unr Request GET sensor FRU Address FRU IP Address sensor FRU Address FRU 192 168 16 1 sensor 0x82 Response lt xml version 1 0 gt lt sensor_list gt lt sensor no 1 gt lt name gt Hot Swap lt name gt lt value gt Handle Open lt value gt lt sensor gt lt sensor no 2 gt lt name gt V0 lt name gt lt value gt 0 00 lt value gt lt unit gt V lt unit gt lt state gt Inr lt state gt lt sensor gt lt sensor_list gt sdr FRU_Address sensor_No This command retrieves additional information for a specific sensor on the desired card The command uses two parameters FRU Address the IPMB address of the card hexadecimal value sensor No sensor number for the desired sensor The ShMC responds to this request using an XML file that contains the following tags lt name gt entity id entity id for the sensor s owner entity instance entity instance for the sensor s owner lt unr gt upper non recoverable threshold value if the unr threshold is enabled lt uc gt upper critical threshold value if the uc threshold is enabled lt unc gt upper non critical threshold value if the unc threshold is enabled 21 43 SAMWAY ShMC User Manual Rev 1 6 your way lt lnc gt lower non critical threshold value 1f the Inc threshold is enabled lt lc gt lower critic
50. us For this request the ShMC returns an XML file that contains the following tags boot cnt boot index The index is incremented at each ShMC start up sel cnt System Event Log SEL index The index is incremented when an event is added to the SEL This field is used to detect if new events have occurred fru 150 gt list with all the modules FRUs present in system including ShMC fru addr the IPMB address of the module fru id active FRU ID The Module Management Controller MMC is always represented by FRU ID 0 and is always present for active modules Additional FRU IDs can also be active Request GET frustatus IP Address frustatus ex 192 168 16 1 frustatus Response xml versionz 1 0 fru status boot cnt 315 boot cnt sel cnt 9791 sel cnt fru list fru addr addr 0x00 gt fru id20 fru id fru addr addr 0x82 gt fru 19 gt 0 lt id lt fru_addr gt lt fru_addr addr 0x84 gt lt fru_id gt 0 lt fru_id gt lt fru_addr gt lt fru_addr addr 0x86 gt lt fru_id gt 0 lt fru_id gt lt fru_addr gt lt fru_addr addr 0x10 gt lt fru_id gt 0 lt fru_id gt lt fru_addr gt SAMWAY your way 18 43 SAMWAY ShMC User Manual Rev 1 6 your way lt fru_list gt lt fru_status gt sel start_index end_index This command retrieves multiple SEL event records The command use two
51. using the SDRs The ShMC uses the Assertion Events Mask and Deassertion Events Mask fields in each SDR to decide which events are logged Only events that are supported by the sensor and are accordingly marked by the SDR will be logged a For each event the log provides the following information time stamp number and name of the sensor that generated the event event type for threshold sensors UNR UC UNC LNC LC LNR for discrete sensors 1 Asserted 0 De Asserted sensor value that triggered the event and threshold value only for threshold sensors Example 1 Sensor event log 5 gt 5 1 print Rec ID dd mm yyyy hh mm ss Sensor No Name Event Ev Dir Value Threshold 0x0001 01 01 2012 00 00 00 97 SHMC Power ON 1 Asserted 0x0002 01 01 2012 00 00 00 2 VO LNC As 0 00 2 86 0x0003 01 01 2012 00 00 00 4 V2 LC As 0 00 11 38 0x0004 01 01 2012 00 00 00 6 v4 LC As 0 00 2 16 0x0005 01 01 2012 00 00 00 8 V6 LC As 0 00 0 24 0x0006 01 01 2012 00 00 00 3 Vi LC As 0 00 4 76 0x0007 01 01 2012 00 00 00 5 UC As 2 58 11 34 0x0008 01 01 2012 00 00 00 7 V5 LC As 0 00 0 66 0x0009 01 01 2012 00 00 00 9 V7 LC As 0 00 12 39 Each ShMC restart is marked by an event 1 Asserted for the ShMC Power On Sensor For more details and syntax refer to the se command section of this user manual 10 43 ShMC User Manual Rev 1 6 3 IPMB interface The Shelf Manager was developed based on the IPMI v1 5 specification 3 1 Sup
52. uts 7 and 14 to the active level of input 6 sensor 69 l1ocal sensor 69 output 0 2040 Operation Successful 6 6 4 Changing the activelevel Syntax local sensor sensor no activelevel 0 activelevel be changed only for discrete sensors The active value can be either low or 1 high Example 7 Setting the activelevel to high for input 2 sensor 65 21ocal sensor 65 activelevel 1 Operation Successful 6 6 5 Changing the fancontrol mask Syntax local sensor sensor no fancontrol fancontrol mask fancontrol mask defined in Table 6 Fancontrol Mask The fancontrol parameter is used only for temperature sensors and determines if the sensor is active for any of the fan control groups For more details on fan control refer to 1 4 1 Fan control The fancontrol mask has 8 bits but only the least significant 3 are used The fancontrol mask is inputed as a hex value A sensor that is active for all the fancontrol groups has a mask of 0x07 Example 8 Setting temp 3 sensor 28 active for PWM 1 and 3 2l1ocal sensor 28 fancontrol 0x05 Operation Successful 6 6 6 Changing the output type Syntax local sensorsensor no output type AND OR The output type parameter is available only for output sensors and determines the logic function the sensor performs on it s driving signals An AND output is asserted when all it s driving signals are asserted An OR output is asserted when at least one of it s
53. y 11 2012 0 13 3 Azd 0272 0 No 08 inputs 3961 1 1 2012 0 111 Arkel 0 72 0 6 Neme 9962 11 2212 011313 Add 0x72 JUN 0 Wo 70 Taqa JUNIO Nor 72 Name Irp FFA 11 2012 0 13 2 Azd 0272 JUN 0 No 72 NIB NA LSz AREA Arca mizang 3865 11 212 0 13 9 0272 UN 0 Nu 73 Irp tt FRE 11 2012 021009 Adde 0172 LIN 0 Nt 74 Nene 0 poti Vie 0113720 Addr 0274 LUN U ti 5 IN O AREA Arca meang BOARD INFC AREA Arca mixing PRODUCT INTC ARCA Area missing MLETRICORT ET 9558 111 221 011311 LUI C Nor Addr 0x72 LUN 0 Noi 77 3 18 0672 ERR YY eer ee san Mac Adzrcss C180 10 242 90 C No 0200 0200 usb nene 2 CLK1CO 0 2 00 Jul 3 SNZ 0 35742 Slol 4TImi g STRIS 0 4 5 6 Aim Worc 1 Figure 3 Web Interface overview The default Layout for the Web Page is composed of several areas 1 Dynamic System Platform Representation The images are populated or removed depending on the hot swap state of the boards Both system platform and boards are treated as objects and can be selected using a mouse click The information in panes 2 FRU info and 3 Sensor info
Download Pdf Manuals
Related Search