manualshive.com logo in svg

Hitachi HF-BT1000, User Manual, Page: 102 / 129

Share
Download
Hitachi HF-BT1000 User Manual Download Page 102

6. LIBRARY FUNCTIONS 

6-15 

6.2  Sample Programs 

Sample program file in C that use RAS library functions are stored in the %ProgramFiles% 
\HFWRAS\sample directory. Use those files for reference when you develop a program or 
check the operation of those functions. 
The following Table 6-9 shows a list of sample programs. 

 

Table 6-9    List of Provided Sample Programs 

 

No. 

File name 

Description

1 

shutd.c 

A sample program for the BSSysshut function

2 

wdt.c  

A sample program for the WdtControl function

3 

MCon.c 

A sample program for the MconWriteMessage function 

4 

hfbDiskStat.c 

A sample program for the hfbDiskStat function

5 

hfbRaidStat.c 

A sample program that uses the hfbRaidStat function 

6 

7seg.c 

A sample program for the status display digital LEDs control functions 
(SetStCode7seg, TurnOff7seg, and SetMode7seg) 

7 

FanErr.c 

A sample program for detecting a RAS event (For information about the 
RAS event notification, see “4.2    RAS Event Notification”.) 

 

Summary of Contents for HF-BT1000

Page 1: ...BT 63 0004 01 ...

Page 2: ...BT 63 0004 01 ...

Page 3: ...ights Reserved Copyright 2013 2015 Hitachi Industry Control Solutions Ltd The contents of this publication may be revised without prior notice No part of this publication may be reproduced in any form or by any means without permission in writing from the publisher Printed in Japan TP IC FL MW2007 ...

Page 4: ...esult in serious personal injury or death WARNING This symbol is used to indicate potential hazards that may result in serious personal injury or death CAUTION This symbol is used to indicate potential hazards that may result in minor or moderate personal injury NOTICE This symbol is used to indicate hazards that may result in equipment or property damage but not personal injury The heading NOTE i...

Page 5: ...Using the faulty equipment without repair may result in a fire or an electric shock z This equipment has built in magnetic disk drives Do not hit the equipment or give a shock or vibration to the equipment because that may cause the equipment to fail Should you drop the equipment or damage its chassis disconnect the power cable from the outlet and contact your maintenance personnel Using the fault...

Page 6: ...UTION z If the equipment drops or is tipped over personal injury may result Pay full attention when transporting the equipment z Make sure you do not catch or hit your fingers to cause personal injury when unpacking or carrying the equipment ...

Page 7: ...cause that may cause the equipment to fail z Make sure sufficient space is provided for an air intake and exhaust around the equipment Otherwise the temperature inside the equipment may rise and that may cause a failure or short life span of the equipment In addition you need to ensure sufficient clearance for maintenance work z Performing emergency shutdown that is unplugging the power cable from...

Page 8: ...ternal parts such as a processor are not cooled down sufficiently and that may cause thermal runaway of the system due to malfunction of the equipment or result in damage to the parts See page 3 3 z If you select Retriggered by application program under Watchdog timer setting and Not reset for Action at timeout in the RAS Setup window set the status display digital LEDs to the application status d...

Page 9: ...rror even when writing to a log file fails for some reason We recommend important information be recorded in the OS event log See page 6 6 z CPU load increases while memory dump files are being collected While CPU load is high operation of user applications can be disturbed Make sure that you do not collect memory dump files using the log information collection window while the applications for bu...

Page 10: ...use remote notification an error log entry with event ID 1500 may be recorded at the startup of the SNMP service This event log entry is recorded when SNMP trap notification has not been set up Set up the trap notification according to 4 5 3 Enabling the remote notification Note for storage capacity calculations z Memory capacities and requirements file sizes and storage requirements etc must be c...

Page 11: ... window 3 3 3 1 4 Editing popup notification messages 3 13 CHAPTER 4 CHECKING THE HARDWARE STATUS 4 1 4 1 Hardware Status Window 4 2 4 1 1 Overview 4 2 4 1 2 Hardware status icon 4 4 4 1 3 Hardware status window 4 7 4 2 RAS Event Notification 4 11 4 2 1 Overview 4 11 4 2 2 Detecting an event 4 11 4 2 3 Example of using event objects 4 11 4 3 Popup Notification 4 12 4 3 1 Overview 4 12 4 3 2 Messag...

Page 12: ...Stat 6 7 6 1 6 Get function for the RAID status hfbRaidStat D Model only 6 9 6 1 7 Status display digital LEDs control functions SetStCode7seg TurnOff7seg SetMode7seg 6 12 6 2 Sample Programs 6 15 CHAPTER 7 FEATURES RELATED TO MAINTENANCE AND FAILURE ANALYSIS 7 1 7 1 Log Information Collection Window 7 1 7 1 1 Overview 7 1 7 1 2 Starting the log information collection window 7 1 7 1 3 Using the lo...

Page 13: ... File 3 13 Figure 4 1 Hardware Status Window 4 2 Figure 4 2 Example of Displaying the Description of an Icon When the Hardware Status is Normal 4 6 Figure 4 3 Example of Displaying the Description of an Icon When the Hardware Status Has an Error 4 6 Figure 4 4 Menu of the Hardware Status Icon 4 6 Figure 4 5 Starting the Hardware Status Window 4 7 Figure 4 6 Hardware Status Window Error Case 4 10 F...

Page 14: ... 14 Objects Related to the Trap Notification When an Error Occurs 4 32 Table 4 15 Objects Related to the Trap Notification When the Equipment has Recovered from an Error 4 33 Table 4 16 Objects Related to the Trap Notification Operational Modes 4 33 Table 5 1 RAID Status Displayed in the Output of the raidctrl Command 5 6 Table 5 2 Drive Status Displayed in the Output of the raidctrl Command 5 6 T...

Page 15: ...This Page Intentionally Left Blank ...

Page 16: ...AS Setup window Status check GUI output Hardware status window Notification Event notification Popup notification Status display digital LEDs Remote notification Status acquisition using library functions Control Shutdown System reset Automatic shutdown System reset Shutdown using library functions Controlling the status display digital LEDs Library functions RAS library Maintenance Failure analys...

Page 17: ...led in this equipment This function also offers a library to use the watchdog timer GUI feature setting 3 RAS Setup window You can use a graphical user interface to configure RAS feature settings including the condition of automatic shutdown and the watchdog timer settings Figure 1 1 RAS Setup Window Status check 4 Hardware status window Displays the hardware status of this equipment using a graph...

Page 18: ...ary Control 10 Automatic shutdown Automatically shuts down the equipment when fan failure or abnormal temperature inside the chassis Use 3 RAS Setup window to enable or disable the automatic shutdown feature 11 System reset The system resets when a watchdog timer timeout in the equipment is detected Use 3 RAS Setup window to enable or disable the system reset feature 12 Shutdown using library func...

Page 19: ...8 Logging the trend of the temperature inside the chassis This function periodically measures the temperature inside the chassis of this equipment and records the data into a file Simulation 19 Hardware status simulation Simulates the hardware status of this equipment By using this function you can test a user application and check the notification interface of the RAS software without actual hard...

Page 20: ... 5 see CHAPTER 4 CHECKING THE HARDWARE STATUS For information about item 6 see 5 1 Automatic Shutdown and System Reset of the Equipment 2 2 Monitoring Temperature inside the Chassis This function monitors the temperature inside the chassis using the temperature sensor in this equipment and notifies in the following methods when the temperature inside the chassis gets abnormally high 1 Hardware sta...

Page 21: ... in the RAS Setup window If this function is disabled notification using the methods above is disabled For details see 3 1 3 Using the RAS Setup window NOTICE When a failure of a drive is anticipated back up the data immediately and replace the drive For information about how to replace a drive see HF BT1000 INSTRUCTION MANUAL manual number BT 62 0002 NOTE It is not possible for the Drive Failure ...

Page 22: ... the OS is not running the amount of the drive power on hours is not monitored This function records the serial number unique ID of a drive in the equipment in a drive management information file If you mount a drive that does not match the serial number recorded in the drive management information file the cumulative power on hours for the drive is automatically reset This function is not designe...

Page 23: ...ee 5 1 4 Memory dump due to timeout detection Note that you can configure the watchdog timer settings and the action on timeout in the RAS Setup window For information about how to use the RAS Setup window see 3 1 3 Using the RAS Setup window 2 5 1 Automatic retriggering feature for a watchdog timer The automatic retriggering feature can detects the situation that the watchdog timer monitoring pro...

Page 24: ...ow to use the WdtControl function see 6 1 3 Watchdog timer control function WdtControl In addition in the RAS Setup window select Retriggered by application program under Watchdog timer setting NOTE If you want to stop monitoring using the watchdog timer when a user program exits or due to shutdown you must stop the watchdog timer so that a timeout does not occur If you select Reset or Memory dump...

Page 25: ...thods 1 Hardware status window 2 Event notification 3 Popup notification 4 Outputs on the status display digital LEDs 5 Remote notification 6 The hfbDiskStat and hfbRaidStat functions in the RAS library 7 RAID configuration control command raidctrl For information about items 1 through 5 see CHAPTER 4 CHECKING THE HARDWARE STATUS For information about item 6 see 6 1 5 Get function for the drive co...

Page 26: ... drive failed and a part of redundant data is corrupted Rebuild The RAID is being rebuilt due to drive replacement or other reason Fail Both drives failed or drives are not connected Unknown Getting the RAID status failed or the array configuration is not normal Figure 2 2 RAID Status Transitions Degraded Normal Degraded Rebuild Fail Media error occurs Degraded One drive fails Drive replacement Er...

Page 27: ... In the default factory settings a media error is not reported Use the RAID configuration control command raidctrl to select whether a media error is reported For details see 5 3 RAID Configuration Control Command raidctrl D Model only A media error can be reported in the following ways 1 Event notification 2 Outputs on the status display digital LEDs 3 Remote notification 4 Message box Figure 2 3...

Page 28: ...m Shutdown setting Automatic shutdown when detecting fan failure Automatic shutdown when detecting abnormally high temperature Watchdog timer setting Drive Failure Prediction SMART monitoring setting Drive usage monitoring setting Status display digital LEDs setting Popup notification setting Figure 3 1 shows the RAS Setup window The default factory shipped settings are shown in the figure Figure ...

Page 29: ...rt 2 Point to All Programs RAS Software 3 Click RAS Setup 4 If you see the User Account Control window click Yes NOTE The RAS Setup window cannot be used by multiple users at the same time If you use for example user switching to try to start instances of this window from multiple consoles the following message appears If you receive this message close the RAS Setup window on another console and t...

Page 30: ...ng Cleared This equipment will not be automatically shutdown z Automatically shutdown if abnormally high temp has been detected check box Selected This equipment will be automatically shutdown Cleared This equipment will not be automatically shutdown default factory shipped setting If you want to change the current setting click the check box you want to change NOTICE If this equipment continues t...

Page 31: ...y message is displayed Enable this function select the check box whenever you can If you click Cancel when you receive the message above the check box reverts back to being selected If you click OK the check box is cleared After an automatic shutdown initiated by this function is complete the power to this equipment is automatically turned off ...

Page 32: ...t this item the watchdog timer is stopped The watchdog timer will not time out In addition you cannot use the watchdog timer by calling the WdtControl function of the RAS library Retriggered by application program If you select this item you can monitor the operational state of a user program by controlling the watchdog timer using the WdtControl function in the RAS library Automatic retrigger If ...

Page 33: ... be overwritten by the status code and may not be able to be checked NOTE To make a new watchdog timer setting effective you must restart the equipment When the watchdog timer setting is changed the following message is displayed Click OK to close the box and then make sure you restart the equipment If you select Reset or Memory dump for Action at timeout the time it takes to generate timeout is l...

Page 34: ... failure prediction is disabled If you want to change the current setting click the check box If the drive failure prediction is disabled you cannot use the notification functions described in 2 3 Drive Failure Prediction Function SMART Monitoring such as indicating a predicted drive failure z Watching interval To set the watching interval type a value in single byte numeric characters in the box ...

Page 35: ...age monitoring is enabled default factory shipped setting Cleared The drive usage monitoring is disabled If you want to change the current setting click the check box you want to change If the drive usage monitoring is disabled you cannot use the functions described in 2 4 Drive Usage Monitoring such as indicating if the value of the drive power on hours exceeds the threshold z Advanced button Cli...

Page 36: ...ranging from 100 to 20000 in the step of 100 100 minimum 200 20000 maximum The default factory shipped setting is 20000 hours If you want to clear the current cumulative power on hours when click Reset to clear the value Then the following message is displayed If you click OK when you receive the message the value of the current cumulative power on hours is cleared Click Cancel to leave the value ...

Page 37: ...tems in the Status Display Digital LEDs Setting z Show Hardware status check box Selected Hardware status display mode default factory shipped setting Cleared Application status display mode If you want to change the current setting click the check box For details about the function of the status display digital LEDs including its display modes see 4 4 Status Display Digital LEDs Function ...

Page 38: ... Figure 3 8 Items in the Popup Notification Setting z Function is available check box Selected The popup notification is enabled Cleared The popup notification is disabled default factory shipped setting If you want to change the current setting click the check box If the popup notification is disabled you cannot use the popup notification feature described in 4 3 Popup Notification ...

Page 39: ... is disabled If you want to change the current setting click the check box Message editing You can edit popup notification messages And you can check the messages after you edit them For information about how to edit and check the messages see 3 1 4 Editing popup notification messages If you changed the advanced setting and want to make the change effective click OK If you do not want the change c...

Page 40: ... one of the above the following cautionary message is displayed If you click OK when you receive the message you go back to the RAS Setup window Format of a definition file The format of a definition file is as follows Figure 3 10 Format of a Definition File A definition file consists of sections keys and the values of the keys Each section contains keys and their values A key and its value are se...

Page 41: ...used hours exceeds the determined value for the drive bay2 D Model only 2 Keys For a key specify the line number of a line displayed as a part of the popup message In this function you can use the keys Line1 through Line5 for each section If you specify Line6 and so on for keys those keys are ignored 3 Values Specify one line of message displayed as a part of the popup message for a value For each...

Page 42: ...oxes are displayed If no items under Events are selected using the check boxes you cannot select an item from the Event list Example of Selecting Fan failure 2 In the Object list select the object you want to check Items in this list depend on the item you selected in step 1 Example of selecting case fan The table below shows items displayed in the Object list for each option you select in the Eve...

Page 43: ...definition file the following message is displayed Click OK to go back to the RAS Setup window Correct the change you made in the message 3 Restoring default messages If you want to set the popup notification messages back to the default click Set default The following message will appear Click Yes Then the changes you made in the message definition file are discarded If you click No the changes a...

Page 44: ... the RAS Library 3 Check on the desktop of this equipment A popup message is displayed to notify that an error occurred in the hardware of this equipment For details see 4 3 Popup Notification 4 Check by using the status display digital LEDs on the front of this equipment The status display digital LEDs are on the front of this equipment and notify a user that an error has occurred in the hardware...

Page 45: ... or if you right click the icon to display a popup menu and click Display Hardware status detailed information about the hardware status of this equipment is displayed This window displays the following information Fan condition Temperature condition inside the chassis Drive status including failure prediction by SMART Monitoring Drive power on used hours RAID status D Model only Other than D Mode...

Page 46: ...status of other drives If you connect a new drive or replace a drive with a new drive for example for maintenance it may take a long time to recognize the new drive at the first startup after the new drive is connected and the information about the drive may not be displayed If this situation happens restart this equipment For information about how to replace a perishable component refer to HF BT1...

Page 47: ...cation area the icon will appear If you want to always show the icon in the notification area of the taskbar click Customize and configure the icon to be always shown in the notification area NOTE In rare cases the registration of the hardware status icon to the taskbar may fail and the following message may be displayed If this happens follow the procedure below to retry the registration of the h...

Page 48: ...d 10 Fan failed Abnormal TEMP detected Time of drive exceeded 11 RAID error detected 12 Fan failed RAID error detected 13 Abnormal temperature detected RAID error detected 14 Fan failed Abnormal temperature detected RAID error detected 15 Caution Drive failure possible 16 Time of drive exceeded Nos 5 through 7 and 15 When both Time of drive exceed and Drive failure possible happen at the same time...

Page 49: ... the Hardware Status is Normal Figure 4 3 Example of Displaying the Description of an Icon When the Hardware Status Has an Error 2 Menu of the hardware status icon If you right click the icon a popup menu is displayed Figure 4 4 Menu of the Hardware Status Icon z Display Hardware status Click it to display the Hardware status window z Undisplay the icon Click it to delete the icon from the notific...

Page 50: ... of this equipment Figure 4 5 shows how to start the Hardware status window Figure 4 5 Starting the Hardware Status Window 1 Double click the hardware status icon Alternately right click the icon to display a popup menu and click Display hardware status on the menu 2 The Hardware status window opens Notification area of the taskbar ...

Page 51: ... is working normally Excessively low rotation speed Fan failure is detected For details refer to the event log 2 Temperature condition Shows the current status of the temperature inside the chassis Table 4 3 Temperature Condition and Displayed Information Temperature status Icon Information Normal Present temperature is normal Abnormally high temperature Temperature in the unit has exceeded the up...

Page 52: ...scribed value 6 Error The drive is offline OFFLINE 7 The drive is being rebuilt REBUILD 8 Unknown Unknown 9 Not mounted Not Connected Nos 6 through 8 These descriptions apply to D Model only No 9 This description does not apply to D Model NOTICE When failure of a drive is anticipated by SMART the drive may experience hardware failure in near future We recommend you to back up the data and replace ...

Page 53: ...ress of the rebuild process 6 Degrade Rebuild xx Media Error xx Progress of the rebuild process Media error occurs 7 Fail Fail The system has stopped This message may not be displayed 8 Unknown Unknown 6 Refresh button If you click this button the latest hardware status is acquired and the information in the window is refreshed 7 OK button Click this button to close the Hardware status window Figu...

Page 54: ... reported to a user and their respective event objects Table 4 6 Reported Events No Event Event object name 1 A case fan failure occurred HFB_CSFAN_ERR_EVENT 2 A CPU fan failure occurred HFB_CPUFAN_ERR_EVENT 3 The temperature inside the chassis became abnormal HFB_TEMP_ERR_EVENT 4 SMART anticipated failure in one of the drives HFB_HDD_PREDICT_EVENT 5 The power on used hours exceeded the threshold ...

Page 55: ...ware failure occurred More specifically a popup message is displayed in the following cases z A fan failure occurred z The temperature inside the chassis becomes abnormal z SMART anticipates drive failure z The drive power on used hours exceeded the threshold z RAID error is detected D Model only Figure 4 7 shows an example of popup message notification when a power fan failure has occurred Figure...

Page 56: ...Temperature exceeded prescribed value 4 SMART anticipates drive failure A failure may be imminent on the drive of the drive bay 1 5 The value of the drive power on used hours exceeds the threshold Used hours on the drive of the drive bay 1 exceeded prescribed value 6 A RAID error occurs RAID status is DEGRADE Drive bay 1 Nos 4 5 and 6 1 denotes the drive bay number No 4 This includes the case that...

Page 57: ...cated on the front of this equipment Using this function a user can know an event such as hardware failure occurred In addition a user application can output any status code on the status display digital LEDs by using library functions The LED output consists of 2 digit hexadecimal code and status indication LEDs Figure 4 8 Status Display Digital LEDs Status indication LEDs The system status is di...

Page 58: ...the drive on drive bay1 4 5 32 A failure is anticipated for the drive on drive bay2 6 41 Drive bay1 is offline 1 7 42 Drive bay2 is offline 8 4b RAID is in a fail status 9 4c RAID is in an unknown status 10 4d Media error on RAID Nos 6 through 10 Those status codes are displayed for D Model only No 8 When the RAID is in a fail status the system cannot operate normally and 4b may not be displayed N...

Page 59: ...s code An application status code is displayed by a user application by using library functions provided by this function When an application status code is displayed the center LED in the status indication LEDs is lit Figure 4 10 Application Status Code On ...

Page 60: ...gure 4 11 Timeout Code NOTE The ON OFF statuses of the status indication LEDs do not change before and after the timeout code is displayed For example if an application status code is displayed before the timeout code is displayed the center status indication LED remains on NOTICE If you select Retriggered by application program under Watchdog timer setting and Not reset for Action at timeout in t...

Page 61: ...ess of the status display mode 80 is displayed with higher priority than the timeout code For information about the status display modes see 4 4 3 Status display modes When the STOP error code is displayed all LEDs in the status indication LEDs are lit Figure 4 12 STOP Error Code For information about the priority of displaying each code see 4 4 4 Priorities of displayed codes On ...

Page 62: ...tting is the hardware status display mode For information about how to use the RAS Setup window see 3 1 3 Using the RAS Setup window Note that if the hardware status is normal and there is no application status code to display the status display digital LEDs are all off Figure 4 13 shows an example of what is displayed in the hardware status display mode Dotted lines in Figure 4 13 denote the resp...

Page 63: ...o be displayed 2 In the application status display mode Code class Priority order STOP error code 1 Timeout code or Status code 2 2 2 Application status code STOP error code has the highest priority Between the timeout code and a status code the one that occurs later has precedence 4 4 5 Status display digital LEDs control functions The functions shown in Table 4 11 are offered as library function...

Page 64: ...his function uses Simple Network Management Protocol SNMP to notify hardware conditions This allows you to use commercially available network management software that supports SNMP and to monitor distributed instances of this equipment and other devices all from one location NOTE The remote notification uses SNMP a protocol in the application layer of the TCP IP and User Datagram Protocol UDP in t...

Page 65: ...formation of the extended Management Information Base MIB for HF BT The following transitions of the hardware conditions are notified by using a trap 1 Fan condition Normal Error Error Normal 2 Temperature condition inside the chassis Normal Error Error Normal 3 Drive condition Normal Failure anticipated Normal Used hours exceeded the threshold 4 RAID status D Model only Optimal Error Degrade Unkn...

Page 66: ...tification follow the procedure below to enable the SNMP service 1 Starting the SNMP Service Properties window 1 If you are not logged on to the computer as an administrator log on to the computer as an administrator 2 Follow the procedure below to start the Services window Click Start and then Control Panel Double click System and Security Administrative Tools Services If you see the User Account...

Page 67: ...ights list select READ ONLY In the Community Name box type the community name you want and click Add 4 Specify whether to accept SNMP packets from hosts If you want to accept SNMP packets from any manager on the network Select Accept SNMP packets from any host If you want to restrict SNMP packets Select Accept SNMP packets from these hosts Click Add The SNMP Service Configuration window is display...

Page 68: ...Community name type the name of the community that trap messages are sent to and click Add to list 3 Under Trap destinations click Add The SNMP Service Configuration window is displayed Enter the host name IP or IPX address of a destination you want to send traps to and click Add 4 In the SNMP Service Properties window click Apply ...

Page 69: ... trap the trap is sent at the timing when the SNMP starts If Windows Firewall is configured to block the SNMP service you cannot acquire the hardware status from a remote device SNMP service can pass through Windows Firewall by default and you do not have to go through the following procedure But if you set up the firewall to block SNMP service follow the procedure below to undo it 1 If you are no...

Page 70: ...4 CHECKING THE HARDWARE STATUS 4 27 5 The Allowed Programs window appears Click Change settings and under Allowed programs and features select the SNMP Service check box 6 Click OK ...

Page 71: ...e table below Table 4 10 Objects Related to the Hardware Status 1 2 No Object Object number Description Description of the values 1 hfwFan 1 Fan condition group 2 hfwFan fanNumber 1 1 The number of monitored fans 3 hfwFan fanTable fanEntry fanIndex 1 2 1 1 Index number of fanEntry 4 hfwFan fanTable fanEntry fanName 1 2 1 2 Fan name CS fan Case fan CPU fan CPU fan 5 hfwFan fanTable fanEntry fanStat...

Page 72: ...l 20 hfwRaid raidTable raidEntry raidLevel 4 2 1 3 RAID level 1 RAID1 21 hfwRaid raidTable raidEntry raidProgress 4 2 1 4 Progress of the rebuild process in 22 hfwRaid raidTable raidEntry raidMediaError 4 2 1 5 Whether media error occurred 1 No media error occurred 2 Media error occurred No 2 For this equipment the value is set to 2 No 7 For this equipment the value is set to 1 No 12 The number of...

Page 73: ... when a fan failure occurred 1 Enabled 2 Disabled 2 hfwTempAutoShutdown 2 Automatic shutdown when the temperature is abnormal 1 Enabled 2 Disabled 3 hfwSmartEnableSetting 4 Drive Failure Prediction SMART monitoring 1 Enabled 2 Disabled Table 4 12 shows a list of the objects related to operational modes and a description of those objects The object ID of each object is obtained by either replacing ...

Page 74: ...le or replacing the following y with the object number in the table Object ID iso org dod internet private enterprises Hitachi system hfw hfwExMibInfo x x is an object in the table below or 1 3 6 1 4 1 116 3 45 1 y y is an object number in the table below Table 4 13 Objects Related to the Extended MIB for HF BT No Object Object number Description Description of the values 1 Version 1 Version numbe...

Page 75: ...he chassis becomes abnormal tempName Internal temperature tempStatus 2 Error hfwTempStMsg Internal temperature exceeded prescribed value 3 hfwSmartDetect 3 A failure is anticipated for the drive hddIndex The drive bay number of the drive for which a failure is anticipated by SMART hddStatus 3 Failure anticipated hfwSmartStMsg A failure may be imminent on the drive of the drive bay 2 4 hfwHddOverRu...

Page 76: ...pStMsg Internal temperature returned to prescribed value 3 hfwArrayRecover 7 Recovery from RAID error raidIndex 1 hfwArrayStMsg Array 3 is restored No 1 1 denotes the name of the recovered fan No 3 3 denotes the number of the array that recovered from an error For this equipment the array number is always 1 Table 4 16 shows a list of the objects related to the trap notification when the equipment ...

Page 77: ...4 CHECKING THE HARDWARE STATUS 4 34 4 5 5 Extended MIB file for HF BT The extended MIB file for HF BT is as follows Extended MIB file for HF BT ProgramFiles HFWRAS mib hfwExMib mib ...

Page 78: ...brary By using the RAS library functions the following hardware conditions can be acquired For details about the library functions see 6 1 RAS Library Interface z To acquire the drive condition Use the hfbDiskStat function z To acquire the RAID status Use the hfbRaidStat function ...

Page 79: ...This Page Intentionally Left Blank ...

Page 80: ... Reset of the Equipment 3 Memory dump of the equipment When a watchdog timer timeout occurs a memory dump can be generated For details see 5 1 Automatic Shutdown and System Reset of the Equipment 4 Controlling the hardware by using the RAS library A user application can control the hardware of this equipment by using the RAS library For details see 5 2 Controlling the Hardware by Using the RAS Lib...

Page 81: ...he RAS Setup window In the default factory shipped setting this function is enabled For details see 3 1 3 Using the RAS Setup window After an automatic shutdown initiated by this function is complete the power is turned off Alternatively a user application can detect a fan failure using a RAS event and shut down the equipment For information about a RAS event see 4 2 RAS Event Notification NOTICE ...

Page 82: ...ture while the equipment is running Because of this this function is disabled in the default factory shipped setting If you continue to operate this equipment after abnormally high temperature is detected and the temperature further rises to a dangerous level the equipment is forcibly shut down and the power is turned off regardless of whether this function is disabled 5 1 3 System reset due to ti...

Page 83: ...wn the system and the status display digital LEDs For details about the library functions see 6 1 RAS Library Interface z To shut down the system Use the BSSysShut function z To control the watchdog timer Use the WdtControl function z To control the status display digital LEDs Use the SetStCode7seg TurnOff7seg and SetMode7seg functions ...

Page 84: ...wing functions depending on the specified options With no options The status of the RAID and the drives in the RAID will be displayed When NOTIFY option is specified The command configures the setting for whether to notify when a media error is generated NOTE You need to have administrator privileges to execute the following actions Log on to the computer using an administrator account to do so If...

Page 85: ...E REBUILD xx The RAID is under a rebuild process 4 FAIL The RAID failed 5 UNKNOWN Unknown status Nos 1 through 3 If a media error occurs MEDIA ERROR is attached to the end of the displayed status Example If a media error occurs when the RAID is operating normally OPTIMAL MEDIA ERROR Table 5 2 Drive Status Displayed in the Output of the raidctrl Command No Displayed Status Description 1 ONLINE The ...

Page 86: ...ecute the command If you do not have administrator privileges when you run the command an error message is displayed and the command exits If the NOTIFY option is specified alone the current notification setting is displayed In the default factory settings a media error is not notified The following are examples of executing the command with the NOTIFY option To check the media error notification ...

Page 87: ...have the privilege to execute this command option Please execute this command option again on Administrator Command Prompt You do not have administrator privileges Log on to the computer using an administrator account and run the command again If User Account Control UAC is enabled start the command prompt with administrator privileges and run the command 5 Access denied Log on console session And...

Page 88: ...Off7seg Clears an application status code on the status display digital LEDs 8 SetMode7seg Configures the status display mode of the status display digital LEDs Those functions mentioned above are offered in the DLLs hfbras dll and ctrl7seg dll The functions offered by hfbras dll and ctrl7seg dll can be called from Visual Basic When you call functions number 1 through 3 and 6 through 8 from Visual...

Page 89: ...he system after the shutdown reboot 0 The power to this equipment is turned off after the shutdown reboot 0 The system reboots after the shutdown Diagnosis 0 Successful completion System shutdown process has started 1 Shutdown privilege acquisition error 2 Internal error OS shutdown failed Sample program We provide a sample program that uses this function in C For information about the name of the...

Page 90: ...cifies which action is performed on the watchdog timer The following options are available for this parameter Table 6 2 List of Actions of WdtControl Specified by dwCmd dwCmd Explanation of the action WDT_SET 0x00 Specifies the timeout in seconds WDT_STOP 0x01 Stops the watchdog timer If a value other than the above is specified this function terminates with an error If you call the GetLastError W...

Page 91: ...s function terminates with an error call the GetLastError Windows API function to get the error code Error codes returned by this function on its own are as follows Error code value Description HFB_INVALID_PARAMETER 0x2001 There is an error in the specified parameters HFB_WDT_NONMANUAL 0x2002 This function cannot be used because Retriggered by application program is not selected under Watchdog tim...

Page 92: ...to a string that contains the message characters to be written In order to easily identify the application that records each log entry specify a message that starts with the name of the application for example Checking log information This function records log information in the text format in the following files ProgramFiles HFWRAS log hfwrasa log ProgramFiles HFWRAS log hfwrasb log You can check...

Page 93: ...ant information be recorded in the OS event log NOTE In order to reduce the amount of resources used this function for example opens and closes a pipe every time the function is called That means this function has relatively large overhead Even when you record multiple lines of message use one function call to output the message This function does not support a Unicode string Always use an ANSI st...

Page 94: ...ue that represents each status Upper 16 bits are reserved The values of those reserved bits are undefined Do not use those bits Table 6 3 List of Values Stored in Disk_Status Defined value Description DISKSTAT_HEALTHY 0x00000001 The drive is working properly DISKSTAT_SMART 0x00000008 Drive failure prediction SMART is detected 1 DISKSTAT_NOT_CONNECTED 0x00000010 A drive is not connected 3 DISKSTAT_...

Page 95: ...tion terminates with an error call the GetLastError Windows API function to get the error code Error codes returned by this function on its own are as follows Error code value Description HFB_STORAGE_INVALID_PARAMETER 0x20000001 There is an error in the specified parameters HFB_STORAGE_NOT_INITIALIZE 0x20000002 Startup of the RAS software has not completed yet HFB_STORAGE_INTERNAL_ERROR 0x20000003...

Page 96: ...TUS DWORD Array_Count Number of monitored arrays HFB_ARRAY_STATUS Array 16 Array information HFB_RAID_STATUS PHFB_RAID_STATUS Array_Count shows the number of monitored RAID arrays on this equipment 1 Each element of Array shows the status of the corresponding RAID The number of valid elements is returned in Array_Count This value is 1 which means only Array 0 is valid The elements after that are r...

Page 97: ...us The stored value is a logical sum of some of the following Numbers 1 through 4 denote RAID statuses and numbers 5 and 6 denote detailed information Table 6 6 Values Stored in Status in the HFB_ARRAY_STATUS Structure No Defined value Description 1 HFB_RAID_OPTIMAL 0x00000001 The RAID is working properly 2 HFB_RAID_DEGRADE 0x00000004 The RAID is degenerated 3 HFB_RAID_UNKNOWN 0x00000008 The RAID ...

Page 98: ... function terminates with an error the value stored in phfbRaidStatus is invalid You can call the GetLastError Windows API function to get the error code Error codes returned by this function on its own are as follows Error code value Description HFB_STORAGE_INVALID_PARAMETER 0x20000001 There is an error in the specified parameters HFB_STORAGE_NOT_INITIALIZE 0x20000002 Startup of the RAS software ...

Page 99: ...ified this function terminates with an error If you call the GetLastError Windows API function an error code CTRL7SEG_INVALID_PARAMETER is returned Diagnosis If this function completes successfully the function returns TRUE as a return value If this function terminates with an error the function returns FALSE When this function terminates with an error call the GetLastError Windows API function to...

Page 100: ...osis If this function completes successfully the function returns TRUE as a return value If this function terminates with an error the function returns FALSE When this function terminates with an error call the GetLastError Windows API function to get the error code The error code comes from the Windows API functions used by this function For details about those error codes refer to the Windows AP...

Page 101: ...he above is specified this function terminates with an error If you call the GetLastError Windows API function an error code CTRL7SEG_INVALID_PARAMETER is returned Diagnosis If this function completes successfully the function returns TRUE as a return value If this function terminates with an error the function returns FALSE When this function terminates with an error call the GetLastError Windows...

Page 102: ...e Description 1 shutd c A sample program for the BSSysshut function 2 wdt c A sample program for the WdtControl function 3 MCon c A sample program for the MconWriteMessage function 4 hfbDiskStat c A sample program for the hfbDiskStat function 5 hfbRaidStat c A sample program that uses the hfbRaidStat function 6 7seg c A sample program for the status display digital LEDs control functions SetStCode...

Page 103: ...This Page Intentionally Left Blank ...

Page 104: ...ber BT 62 0002 NOTICE CPU load increases while memory dump files are being collected While CPU load is high operation of user applications can be disturbed Make sure that you do not collect memory dump files using the log information collection window while the applications for business use are running on this equipment 7 1 2 Starting the log information collection window To start the log informat...

Page 105: ...ot need and then click Continue 2 If the Gather memory dump files check box is selected you will receive the following message Click OK If you click Cancel you go back to the log information collection window without executing the maintenance operation 3 The following dialog box is displayed Specify the destination directory to save and click OK If you want to cancel the maintenance operation clic...

Page 106: ...YYMMDD_ hhmm directory 1 logsave dat Log data file 2 memory mcf Memory dump file windows directory Minidump Minimum memory dump files directory are stored 1 The name of the directory is YYMMDD_hhmm YY Lower two digits of the year MM Month DD Day hh Hour mm Minute Example If you perform the maintenance operation at 13 59 on Jan 1 2006 Directory name 060101_1359 2 The following data is saved If Gath...

Page 107: ...s For either file if the log gets full log entries are overwritten from the first entry Table 7 1 shows the name of each log file Table 7 1 Log Files Parent folder File name Description ProgramFiles HFWRAS log temp csv The temperature inside the chassis is recorded in this file at the logging intervals Maximum of 51200 entries temp_mm csv The highest and lowest temperatures in 8 hours are recorded...

Page 108: ...csv Figure 7 3 Format of Log Information 2 YYYY MM DD hh mm ss yxxx yzzz YYYY Year MM Month DD Day hh hour 24 hour clock mm minute ss second y Sign or xxx Highest temperature C y Sign or zzz Lowest temperature C YYYY MM DD hh mm ss yxxx YYYY Year MM Month DD Day hh hour 24 hour clock mm minute ss second y Sign or xxx Temperature C If acquiring the temperature fails xxx is replaced with ...

Page 109: ...f User Account Control UAC is enabled start the command prompt as an administrator according to APPENDIX A RUNNING COMMAND PROMPT AS AN ADMINISTRATOR 2 At the command prompt run the tmplogset command The following initial screen is displayed along with the current setting 3 If you type 2 in the initial screen the tmplogset command exits without changing the setting If you type 1 and then press Ent...

Page 110: ...nd press Enter The following message is displayed and the command exits without changing the setting If you do not have administrator privileges when you run the command the following message is displayed and the command exits If an internal error occurs when you run the command the following message is displayed and the command exits In the message above API Name actually shows the name of the Wi...

Page 111: ...This Page Intentionally Left Blank ...

Page 112: ...function simulates the following hardware conditions Fan condition Temperature condition inside the chassis Drive condition including drive failure prediction SMART monitoring condition and whether the used hours exceeded the threshold RAID status D Model only Figure 8 1 Simulation Tool Window The monitoring function of the RAS software detects change in the simulated hardware status and notifies ...

Page 113: ... of the RAS software NOTE In simulation mode when the drive failure prediction function records an event Event ID 265 of SMART detection in the event log a string XXXXXXXX is used for the model name of the drive Also note that you cannot simulate a situation that the drive condition is Unknown or multiple conditions for example SMART detection and used hours exceeded occur at the same time RAID st...

Page 114: ...re of using the simulation mode 1 Overview of the procedure of using the simulation function The figure below shows a rough flow chart of using this function From when the simulation mode start command is executed until when OS shutdown completes the RAS software runs in simulation mode Figure 8 2 Procedure to Use the Simulation Mode Running in simulation mode Start the equipment Log on to the OS ...

Page 115: ...ed to have administrator privileges to run the simulation mode start command Log on to the computer using an administrator account and start Command Prompt If User Account Control UAC is enabled start the command prompt as an administrator according to APPENDIX A RUNNING COMMAND PROMPT AS AN ADMINISTRATOR 2 At the command prompt type the following and then press Enter SystemDrive Program Files HFW...

Page 116: ...ow appears After this point on this equipment runs in simulation mode Monitoring hardware failure is now disabled NOTE While the equipment is running in simulation mode the Windows Exclamation sound is played twice every 10 seconds Only when speakers are connected ...

Page 117: ...ts all hardware devices are set to the normal status Figure 8 3 Description of Each Part in the Simulation Tool Window z Target Shows the name of each simulated hardware device Category Target Fan condition Case fan CPU fan Temperature condition inside the chassis Internal Temperature Drive condition Drive bay1 Drive bay2 Click Apply to apply the Setting Click End to exit the simulation mode Shows...

Page 118: ...If no status to be simulated is set is displayed Immediately after the Simulation Tool window starts is displayed for all hardware devices z Apply button If you click this button all Setting are applied to the Status of hardware devices The monitoring function of the RAS software detects change in the Status of the hardware devices and notifies the change through various interfaces NOTE A new hard...

Page 119: ... automatically to exit the simulation mode Before shutdown is executed the following message is displayed Save the data for example and then click OK z Minimize button _ button Click the Minimize button at the upper right corner of the Simulation Tool window to minimize the Simulation Tool window Note that when the window is minimized the simulation mode does not exit z Close button button Click t...

Page 120: ...ant to simulate A popup menu is displayed The menu lists the statuses you can select based on the current hardware status 2 If you select a status you want to simulate on the popup menu the selected status is displayed in Setting 3 To apply the status displayed in Setting to the hardware status click Apply As a result the Status in the Simulation Tool window is updated ...

Page 121: ... No Current status Statuses in the popup menu Note 1 Normal Normal Error 2 Error z Drive Other than D Model No Current status Statuses in the popup menu Note 1 Healthy Healthy SMART Detected Overrun Not Connected 1 2 SMART Detected Healthy SMART Detected Not Connected 1 2 3 Overrun Healthy Overrun Not Connected 1 2 4 Not Connected Healthy Not Connected 1 3 1 In the case of models other than D Mode...

Page 122: ...line Offline Rebuild 5 Rebuild Healthy Offline Rebuild 3 4 1 If the RAID status is Degrade Offline is not displayed 2 If the RAID status is Degrade None is the only item on the menu and is grayed out 3 Transition of the status from Rebuild to Healthy means the rebuild process is complete 4 We suppose transition from Rebuild means a new drive is connected Consequently transition to SMART Detected o...

Page 123: ...the power button at the lower right corner of the screen the equipment is shut down A blue screen appears because for example the reset button is pressed System reset occurs or a blue screen appears The power is forcibly turned off using the power switch The End button or the Close button in the Simulation Tool window is clicked The Simulation Tool window is terminated with an error NOTE As explai...

Page 124: ... when you click Apply 2 Simulating the status of the drives in the RAID In the case of D Model the RAID status is determined by the simulation of the condition of the drives used in the RAID In some cases if you select a new status to be simulated for both drives the condition of the first drive you selected may change depending on the condition of the second drive you selected The following examp...

Page 125: ...s were set at the Simulation Mode Case fan 1 CPU fan 2 Internal Temperature 3 Drive bay1 4 Drive bay2 5 The x above denotes the corresponding Setting in the Simulation Tool window 8 1 5 Remote notification This function notifies of the transition of the RAS software to simulation mode using trap notification so that an SNMP manager that monitors this equipment in a remote location can know that th...

Page 126: ...Prompt as an administrator 1 Log on to the computer using an administrator account 2 Click Start 3 Click All Programs 4 Click Accessories 5 Right click Command Prompt and click Run as administrator If the administrator account you used for log on is a built in administrator account simply click Command Prompt If you see the User Account Control window click Yes ...

Page 127: ...This Page Intentionally Left Blank ...

Page 128: ...following shows the procedure for checking the RAS software version 1 Log on to the computer using an administrator account 2 Click Start Control Panel 3 Click Programs Programs and Features 4 The Uninstall or change a program window appears Click RAS Software in the list 5 Check the Product version ...

Page 129: ...This Page Intentionally Left Blank ...

Reviews:

No comments