MLB-R180P-01

日立産業用コンピュータ

HF-W7500/LX モデル 50
RAS 機能マニュアル

ユーザーズ
マニュアル

MLB-R180P-01

日立産業用コンピュータ

HF-W7500/LX モデル 50
RAS 機能マニュアル

マニュアルはよく読み、保管してください。

 操作を行う前に、安全上の指示をよく読み、十分理解してください。
 このマニュアルは、いつでも参照できるよう、手近なところに保管してください。

ユーザーズ
マニュアル

この製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認のうえ、
必要な手続きをお取りください。
なお、不明な場合は、弊社担当営業にお問い合わせください。

●
●

２０１８年

６月

（第１版）

２０１９年

６月 （第２版）

ＭＬＢ－Ｒ１８０Ｐ－００（廃版）
ＭＬＢ－Ｒ１８０Ｐ－０１

このマニュアルの一部または全部を無断で転写したり複写したりすることは、
固くお断りいたします。
このマニュアルの内容を、改良のため予告なしに変更することがあります。

Copyright © Hitachi Industry & Control Solutions, Ltd. 2018,2019. All rights reserved.

このページは白紙です。

安全にお取り扱いいただくために装置を操作する前に、以下に述べられている安全上の説明をよく読み、十分理解してください。
●

操作は、このマニュアル内の指示、手順に従って操作してください。

●

装置やマニュアルに表示されている安全に関する注意事項は特に注意を払い、必ず守ってください。これを怠ると、人身上の傷害や装置を含む財産の破損を引き起こす恐れがあります。

●

安全に関する注意事項は、下に示す見出しによって表示されます。これは安全警告
記号と「危険」、「警告」、「注意」、および「通知」という見出し語を組み合わせたものです。
これは安全警告記号です。人への危害を引き起こす潜在的な危険に注意を喚起するために用いられます。起こりうる傷害または死を回避するためにこのシンボルの後に続く安全に関するメッセージに従ってください。
危警
注通

険：死亡または重大な傷害を引き起こす可能性が高い差し迫った危険の存在を示すのに用いられます。
告：死亡または重大な傷害を引き起こすかもしれない潜在的な危険の存在を示すのに用いられます。
意：軽度の傷害または中程度の傷害を引き起こす恐れのある潜在的な危険の存在を示すのに用いられます。
知：これは、人身傷害とは関係のない損害をひき起すおそれのある危険の存在を示すのに用いられます。

※上に述べる重大な傷害とは、失明、けが、やけど（高温・低温）、感電傷害、骨折、中毒などで後遺症が残るもの、および治療のために入院、長期の通院を要するものをいう。また、中程度の傷害や軽度の傷害とは、治療のために入院や長期の通院を要さないけが、やけど、感電傷害などをいう。
人身傷害と関係のない損害とは、財物の損傷、製品の故障・破損、データ損失など、人身傷害以外の損害をいう。
なお、「留意事項」という見出し語は、装置の取り扱いおよび操作上の注意書きを示すのに用いられます。

S-1

安全にお取り扱いいただくために（続き）●

マニュアルに記載されている以外の操作は行わないでください。装置について何か問題がある場合は、保守員をお呼びください。

●

装置を操作する前に、このマニュアルをよく読み、書かれている指示や注意を十分に理解してください。

●

このマニュアルは、必要なときにすぐ参照できるよう、使いやすい場所に保管して
ください。

●

装置やマニュアルに表示されている注意事項は、十分に検討されたものであります
が、それでも、予測を超えた事態が起こることが考えられます。操作に当たっては、指示に従うだけでなく、常に自分自身でも注意するようにしてください。

１．共通的な注意事項
以下に述べられている安全上の説明をよく読み、十分理解してください。
１．１
●

警告
この装置は、人命に直接関わる安全性を要求されるシステムに適用する目的で製造されたものではありません。このような用途に使用する可能性がある場合には、弊社営業窓口へ相談してください。
●

万一、発煙・異臭などがあった場合は、装置への給電を遮断し、電源ケーブルをコンセントから抜いて、お買い求め先または保守員に連絡してください。故障状態のままお使いになると火災や感電の原因になります。

●

この装置はドライブ装置を内蔵しています。故障の原因になりますので、打撃、衝撃、振動を与えないよう取り扱ってください。万一、この装置を落としたりケースを破損した場合は、電源ケーブルをコンセントから抜いてから、保守員に連絡してください。そのまま使用すると、火災や感電の原因になります。また、開梱時および持ち運ぶ時は衝撃を与えないでください。

●

火災や感電の原因になりますので、この装置を改造しないでください。また、改造により発生した結果については、一切責任を負いかねますので、あらかじめご
了承ください。

S-2

安全にお取り扱いいただくために（続き）

１．２
●

注意
装置が落下または転倒するとけがをする恐れがあります。装置の運搬時には十分

注意してください。
●

この装置を開梱する時や持ち運ぶ時に指をはさんだり、ぶつけたりしてけがをしないように注意してください。

S-3

安全にお取り扱いいただくために（続き）

１．３
●

通知
この装置単独ではシステムの安全は確保できません。この装置が万一故障したり誤動作やプログラムに欠陥があった場合でも、ご使用されるシステムの安全が十分に確保されるよう、人身事故・重大な災害に対する安全対策のための保護・安
全回路を外部に設けるなど、システム的な保護処置を施した設計としてください。
●

弊社（日立産業制御ソリューションズ）指定の基本ソフトウェアを使用してください。それ以外の基本ソフトウェアを使用した場合の動作は、保証できません。

●

故障の原因になりますので、この装置をじんあいの多い所や、腐食性ガスのある環境で使用することは避けてください。

●

この装置の前面および背面には、吸排気孔のためのスペースを必ず確保してください。温度上昇による故障または短寿命の原因になります。また、保守作業のための保守スペースが必要です。

●

非常遮断（OSのシャットダウン処理を行わずに電源ケーブルをコンセントから抜いたり、ブレーカを切ったりすること）をすると、OSやアプリケーションが正常に動作しなくなったり、保存データの安全性に問題が生じたりすることがあります。何らかの異常が発生し緊急に遮断しなければならないとき以外は、絶対に実施しないでください。

●

電源の供給元で電源を遮断した場合、システムを自動で復旧できないことがありますので、注意してください。

S-4

はじめに
このマニュアルは、日立産業用コンピュータHF-W7500/LXモデル50（以下、この装置と称す）のRAS（Reliability, Availability, Serviceability）機能の使用方法について記述したものです。

＜マニュアルの構成＞
このマニュアルは、次のような構成となっています。
第１章

RAS機能でできること

第２章

RAS機能の監視対象

第３章

RAS機能の設定

第４章

ハードウェア状態の確認

第５章

ハードウェアの制御

第６章

ライブラリ関数

第７章

保守・障害解析関連

第８章

ハードウェア状態のシミュレート

付録A

RAS機能のインストール手順＜RAS機能をご使用になる際の注意事項＞●

RAS外部接点インタフェースについて
このマニュアルの説明の中で、RAS外部接点インタフェースに関する説明がありますが、このインタフェースはオプションとなります。

i＜記憶容量の計算値についての注意＞●

2n計算値の場合（メモリ容量・所要量、ファイル容量・所要量など）
1KB（キロバイト）＝1,024バイトの計算値です。
1MB（メガバイト）＝1,048,576バイトの計算値です。
1GB（ギガバイト）＝1,073,741,824バイトの計算値です。
1TB（テラバイト）＝1,099,511,627,776バイトの計算値です。

●

10n計算値の場合（ドライブ容量など）
1KB（キロバイト）＝1,000バイトの計算値です。
1MB（メガバイト）＝1,0002バイトの計算値です。
1GB（ギガバイト）＝1,0003バイトの計算値です。
1TB（テラバイト）＝1,0004バイトの計算値です。

＜商標について＞
・Linuxは、Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
・RED HATと Shadowman logoは米国およびその他の国において登録されたRed Hat, Inc.の 商標です。
・上記以外にこのマニュアルに記載されている他社製品名（ソフトウェア、ハードウェア）は、各社の登録商標、商標、または商品です。

ii

目次
安全にお取り扱いいただくために
第１章 RAS機能でできること...................................................................................

S-1....................................................................................................

1-1

１．１

HF-W7500/LXモデル50 RASユーティリティパッケージ

１．２

概要

.................................................................

1-1.........................................................................................................................................................

1-2

第２章 RAS機能の監視対象.........................................................................................................

2-1.....................................................................................................................................

2-1

２．１

ファン監視機能

２．２

筐体内温度監視機能

２．３

ドライブ障害予測機能（SMART監視）

２．４

ドライブ使用時間監視機能

２．５..............................................................................................................................

2-2............................................................................................

2-3..................................................................................................................

2-4

メモリ状態監視機能..............................................................................................................................

2-5

２．６

OSロック監視機能................................................................................................................................

2-6

２．７

ウォッチドッグタイマ監視機能..........................................................................................................

２．７．１

ウォッチドッグタイマの自動リトリガ機能

２．７．２

ユーザプログラムの動作状態監視に使用する方法

２．８

RAID監視機能..........................................................................

2-8
2-8

..............................................................

2-9......................................................................................................................................

2-11

２．８．１

RAIDの状態遷移について......................................................................................................

2-12

２．８．２

メディアエラーについて........................................................................................................

2-13....................................................................................................................

3-1

第３章 RAS機能の設定
３．１

RAS機能設定コマンド（rasconfig）

３．１．１

概要

...................................................................................................

3-1.............................................................................................................................................

3-1

第４章 ハードウェア状態の確認
４．１

ハードウェア状態表示機能

４．１．１
４．２

..............................................................................................

4-1..................................................................................................................

4-2

RAS状態表示コマンド（rasstat）............................................................................................

4-2..................................................................................................................

4-6.............................................................................................................................................

4-6

RASイベント情報管理機能

４．２．１

概要

４．２．２

RASイベントハンドリング概要

４．２．３

RASイベントログ情報保存..............................................................................................

4-6......................................................................................................

4-6..................................................................................................................

4-7.............................................................................................................................................

4-7

４．３ 状態表示デジタルLED機能
４．３．１ 概要

４．３．２ 表示するステータスコード
４．３．３ ステータスコードの表示......................................................................................................

4-8........................................................................................................

4-11

４．３．４ 状態表示デジタルLED制御関数............................................................................................

iii

4-12

４．４ RASリモート通知機能（SNMP）
４．４．１ 概要.....................................................................................................

4-13...........................................................................................................................................

4-13

４．４．２ SNMP拡張MIB一覧.................................................................................................................

4-14.....................................................................................................................

4-15

４．４．３

hfwLxサブツリー

４．４．４

hfwExMibInfoサブツリー........................................................................................................

4-15

４．４．５

hfwLxExMibサブツリー..........................................................................................................

4-15

４．４．６

hfwRasStatusサブツリー..........................................................................................................

4-15

４．４．７

hfwRasSettingサブツリー........................................................................................................

4-20

４．４．８

hfwRasInfoサブツリー.............................................................................................................

4-20

４．４．９

hfwLxMibTrapサブツリー

４．４．10 hfwRasErrorTrapサブツリー.......................................................................................................

4-21....................................................................................................

4-21

４．４．11 hfwRasRecoverTrapサブツリー...............................................................................................

4-22.....................................................................................................

4-22

４．４．13 RAS状態照会機能....................................................................................................................

4-23

４．４．14 イベント通知機能....................................................................................................................

4-24

４．４．12 hfwRasInfoTrapサブツリー

４．４．15 RASリモート通知機能の開始手順........................................................................................

４．５ RASライブラリ（GetRasStat関数、WaitForRasEvent関数）による状態取得..............................

4-27.........................................................................................................

5-1..................................................................................................................

5-2

第５章 ハードウェアの制御
５．１

装置の自動シャットダウン

4-25

５．１．１

ファン異常検出による自動シャットダウン..........................................................................

5-2

５．１．２

高温異常検出による自動シャットダウン..............................................................................

5-3

５．１．３

リモートシャットダウン入力検出による自動シャットダウン..........................................

5-3

５．２

RASライブラリによる制御..................................................................................................................

5-4

５．３

RAIDドライブ切離しコマンド（rasraidctl OFFLINE） ......................................................................

5-5

５．４

メディアエラー時ALARM点灯設定コマンド（rasraidctl MEDIAERRORALARM）.................

5-7....................................................................................................................

6-1

第６章 ライブラリ関数
６．１

RASライブラリインタフェース..........................................................................................................

6-1.............................................................................................................................................

6-1

６．１．１

概要

６．１．２

RAS汎用接点の出力制御関数（GendoControl）

６．１．３

RAS汎用接点の信号入力状態取得関数（GetGendi）

６．１．４

状態表示デジタルLED制御関数（SetStCode7seg、TurnOff7seg、SetMode7seg）

６．１．５

ウォッチドッグタイマ制御関数（WdtControl）

６．１．６

RAS状態取得関数（GetRasStat）

６．１．７

RASイベント情報取得関数（WaitForRasEvent）

６．１．８

サンプルプログラム...................................................................
...........................................................

6-2
6-4

............

6-5...................................................................

6-8..........................................................................................

6-11................................................................

6-16................................................................................................................

6-20

iv

第７章 保守・障害解析関連７．１.........................................................................................................

7-1.................................................................................................................................

7-1.............................................................................................................................................

7-1

メモリダンプ機能

７．１．１

概要

７．１．２

メモリダンプの採取要因

７．１．３

メモリダンプファイル保存仕様

７．２..........................................................................................................
..............................................................................................

7-2..........................................................................................................................

7-3.............................................................................................................................................

7-3

ログファイル収集機能

７．２．１

概要

７．２．２

sosreportコマンド概要

７．２．３

sosreportコマンド使用方法

７．２．４

ログファイル収集コマンド（sosreport）

７．３

保守操作支援コマンド

７．３．１

7-2

...............................................................................................................
.......................................................................................................

7-3
7-4

...............................................................................

7-5..........................................................................................................................

7-7

RASイベントログ表示コマンド（raslogpt）.........................................................................

7-8

第８章 ハードウェア状態のシミュレート........................................................................

8-1..........................................................................................

8-1.............................................................................................................................................

8-1

８．１

ハードウェア状態シミュレーション機能

８．１．１

概要

８．１．２

シミュレーション機能の使用方法..........................................................................................

８．１．３ RAS障害シミュレーションコマンド（rassimtool）

付録A

8-2

..............................................................

8-5..................................................................................

A-1........................................................................................................................................................

A-1

RAS機能のインストール手順

A．１

概要

A．２

RASユーティリティパッケージのインストール.............................................................................

A-1

A．３

RASソフトウェア機能で使用する設定ファイル.............................................................................

A-2

v

図目次
図２－１

ステータスランプとCPUSTOP接点の動作....................................................................................

2-7

図２－２

ユーザプログラムの動作状態監視処理の例..................................................................................

2-9

図２－３

RAID状態遷移..................................................................................................................................

2-12

図４－１

状態表示デジタルLED

図４－２

ハードウェアステータスコード

図４－３

アプリケーションステータスコード

図４－４

STOPエラーコード

図４－５

サブツリー

図４－６

状態照会時のネットワーク構成例

図４－７

イベント通知機能ネットワーク構成例

図６－１......................................................................................................................
......................................................................................................

4-7
4-8

............................................................................................

4-10..........................................................................................................................

4-10.......................................................................................................................................

4-14................................................................................................

4-23........................................................................................

4-24

GENDO接点の動作...........................................................................................................................

6-3

図６－２

WDTTO接点の動作.........................................................................................................................

6-10

図６－３

WDTTO接点の動作（シャットダウン時）.................................................................................

6-10

図８－１

シミュレーション機能使用手順（概略図）..................................................................................

8-2

図８－２

シミュレーション機能使用時のRAS外部接点[CPUSTOP]出力状態(B接点)vi.............................

8-3

表目次
表１－１

RASユーティリティパッケージ型式一覧

表２－１

ファン監視における装置の状態とMCALL接点の動作

表２－２

筐体内温度監視における装置の状態とMCALL接点の動作

表２－３

OSロック監視における装置の状態とステータスランプの動作

表２－４

OSロック監視における装置の状態とCPUSTOP接点の動作

表２－５

RAID状態とMCALL接点の動作

表２－６

RAID状態とその意味

表３－１

rasconfigコマンドのエラーメッセージ一覧

表４－１

rasstatコマンドで表示される状態表示項目（詳細表示）............................................................

4-4

表４－２

rasstatコマンドで表示される状態表示項目（簡易表示）............................................................

4-5

表４－３

RASイベントログファイル仕様......................................................................................................

4-6

表４－４

ハードウェアステータスコード一覧

表４－５......................................................................................
................................................................
........................................................

1-1
2-1
2-2

.................................................

2-6.......................................................

2-6....................................................................................................

2-11......................................................................................................................

2-12...................................................................................

3-1..............................................................................................

4-9

ステータスコード表示条件一覧....................................................................................................

4-11

表４－６

ステータスコードの表示種別一覧................................................................................................

4-11

表４－７

状態表示デジタルLED制御関数一覧............................................................................................

4-12

表４－８

RASリモート通知機能（SNMP）概略仕様

表４－９.................................................................................

4-13

hfwExMibInfo下サブツリー............................................................................................................

4-15

表４－10

hfwRasStatus下サブツリー..............................................................................................................

4-15

表４－11

hfwRasSetting下サブツリー............................................................................................................

4-20

表４－12

hfwRasInfo下サブツリー.................................................................................................................

4-20

表４－13

hfwRasErrorTrap下サブツリー.......................................................................................................

4-21

表４－14

hfwRasRecoverTrap下サブツリー...................................................................................................

4-22

表４－15

hfwRasInfoTrap下サブツリー.........................................................................................................

4-22

表４－16

照会情報一覧

...................................................................................................................................

4-23

表４－17

RAS状態照会機能の動作仕様

表４－18

トラップ通知一覧

表４－19

ポートとプロトコル設定内容

表５－１

rasraidctl OFFLINEコマンドのエラーメッセージ一覧

表５－２

rasraidctl MEDIAERRORALARMコマンドのエラーメッセージ一覧

表６－１

RASライブラリ提供ファイル一覧

表６－２........................................................................................................

4-23...........................................................................................................................

4-24........................................................................................................
.................................................................

4-25
5-6

.........................................

5-8..................................................................................................

6-1

RASライブラリ提供関数一覧..........................................................................................................

6-1

表６－３

GetRasStat構造体メンバ一覧..........................................................................................................

6-13

表６－４

WaitForRasEvent構造体メンバ一覧

表６－５

パラメータ格納値

表６－６

サンプルプログラム一覧...............................................................................................

6-17...........................................................................................................................

6-17................................................................................................................

vii

6-20

表７－１

メモリダンプを採取する要因一覧..................................................................................................

7-2

表７－２

メモリダンプファイル保存仕様......................................................................................................

7-2

表７－３

保守操作支援コマンド一覧..............................................................................................................

7-7

表８－１

RASソフトウェア動作モード一覧

表８－２

RAS障害シミュレーションモード動作中の通知内容..................................................................

8-3

表８－３

ハードウェア状態模擬対象部位および模擬内容一覧..................................................................

8-4

表８－４

rassimtoolコマンドのエラーメッセージ一覧.................................................................................

8-6

表８－５

rassimtoolコマンドの[模擬部位]、[模擬内容]オプション一覧

表８－６

RAIDアレイの状態 組合せ表

表Ａ－１

RASソフトウェア機能の設定ファイル一覧..................................................................................................

8-2....................................................

8-8..........................................................................................................

8-9

viii

.................................................................................

A-2

第１章

RAS機能でできること

第１章 RAS機能でできること
HF-W/LXシリーズは、高信頼な産業用コンピュータとしてのRAS（Reliability, Availability, Serviceability）
機能を備えています。
この章では、RASユーティリティパッケージをインストールすることで組み込まれるRAS機能について説明します。

１．１

HF-W7500/LXモデル50 RASユーティリティパッケージ
RAS機能は、以下のソフトウェアにてサポートします。

表１－１
No

RASユーティリティパッケージ型式一覧

パッケージ名称

型式
CS-LXW11L

1

サポートOSRed Hat Enterprise Linux 7.4 Workstation（x86 64bit 日本語）

RASユーティリティパッケージ
CS-LXS11L

Red Hat Enterprise Linux 7.4 Server（x86 64bit 日本語）

留意事項
・本装置は工場出荷時にRASユーティリティパッケージをインストールしております。ご使用の際に改めてインストールする必要はありません。
・RASユーティリティパッケージは、上記型式とサポートOSおよびHF-W7500/LXモデル50との組み合わせでのみ使用できます。
異なるOSおよびHF-W/LX以外との組み合わせはサポート対象外となります。

1-1

第１章

RAS機能でできること

１．２

概要
以下にRAS機能の概要について説明します。

（１）メモリダンプ採取機能
この装置が予期せずに停止してしまった場合など障害が発生したときに、リセットスイッチを押すと、システムメモリの内容をファイル（メモリダンプファイル）に記録します。このメモリダンプの内容を解析することによって、障害の原因を調査することができます。
（「HF-W7500/LXモデル50 取扱説明書」「８.２メモリダンプ採取機能」参照）（２）自動シャットダウン機能
ファン異常や筐体内温度異常、リモートシャットダウン信号入力を検出した場合に自動的にシャットダウンを実施します。（５.１

装置の自動シャットダウン 参照）自動的にシャットダウンを実施するかどうかは、「rasconfig コマンド」を使用して設定できます。（３.１

RAS機能設定コマ

ンド（rasconfig）参照）
出荷時の自動シャットダウン設定は以下のとおりです。
・ファン異常発生時：自動的にシャットダウンします。
・筐体内温度異常発生時：自動的にはシャットダウンしません。
・リモートシャットダウン信号入力時：自動的にシャットダウンします。

（３）ウォッチドッグタイマ監視機能
この装置に実装されているウォッチドッグタイマを使用するためのライブラリを提供します。
また、最低レベルのプロセス優先度において自動的にウォッチドッグタイマのリトリガを行い、プロセスが正常にスケジューリングされていることを監視する機能も提供します。この機能を使用するかどうかは、「rasconfig コマンド」を使用して設定できます。（３.１

RAS機能設定コマンド（rasconfig）参照）（４）システム動作状態監視機能
この装置の動作状態を監視します。OSが正常に動作している間は、ステータスランプが緑色に点灯しています。OSに異常が発生したときはステータスランプが赤色に点灯します。
（２.６

OSロック監視機能 参照 ）（５）RAS状態表示
この装置のファンや筐体内温度の状態を「rasstat コマンド」を使用して確認できます。
（４.１.１

RAS状態表示コマンド（rasstat）参照）

1-2

第１章

RAS機能でできること（６）RAS外部接点制御機能
オプションのRAS外部インタフェースには、ユーザが使用できる外部接点が入力用に4点と出力用に3点ずつ用意されています。これらの接点を使用して外部機器からの信号をこの装置に入力した
り、この装置から外部に信号を出力したりすることができます。ユーザがこれらの接点を使用する
ためのライブラリ関数を提供します。（第６章

ライブラリ関数 参照）（７）ドライブ障害予測機能（SMART）
SMARTは、Self-Monitoring, Analysis and Reporting Technologyの略でドライブ自身がドライブ内の各種情報を監視して信頼性を評価する機能です。（２.３

ドライブ障害予測機能（SMART監視）参照）この機能を使用することで、ドライブの障害を予測することができます。ただし、以下の点に注意してください。
・SMARTは、すべての障害を予測することはできません。そのため、SMARTによる障害予測がされる前にドライブが故障する場合もあります。
・SMARTの障害予測が発生した際は、速やかにデータのバックアップおよびドライブの交換を行ってください。
・SMARTの障害予測が発生した際、その原因を解析することはできません。
（８）RAS障害シミュレーション機能
この装置のハードウェア状態をシミュレートします。これによって、実際にハードウェア異常が発生していなくてもユーザアプリケーションのテストを実施することができます。
（８．１ ハードウェア状態シミュレーション機能 参照）（９）RASイベントハンドリング機能
ファン異常、筐体内温度異常やドライブ障害等のRASイベントメッセージをアプリケーションで検出し、後処理を組み込むための機能です。（４.２.２

RASイベントハンドリング概要 参照）（１０）RASイベントログ収集・表示機能
ファン異常、筐体内温度異常やドライブ障害等の時に、RASイベント情報のログ記録を行います。
（７.２

ログファイル収集機能 参照）（７.３.１

RASイベントログ表示コマンド（raslogpt） 参照）（１１）RAID接続サポート機能
RAIDアダプタに接続されたドライブの状態監視／状態表示／切離し機能をサポートします。（２.
８RAID監視機能 参照）（４.１.１（５.３

RAS状態表示コマンド（rasstat）参照）

RAIDドライブ切離しコマンド（rasraidctl OFFLINE）参照）

1-3

第１章

RAS機能でできること（１２）状態表示デジタルLED機能
本装置のファンや筐体内温度の状態およびドライブの障害予測情報を状態表示デジタルLEDに表示します。このLEDはユーザアプリケーションからも使用できるので、保守員への障害通知などにも使用することができます。
（４.３

状態表示デジタルLED機能 参照）（１３）RASリモート通知機能
ファン異常、筐体内温度異常の検出やドライブの障害予測検出など装置の状態をSNMP（Simple
Network Management Protocol）を利用してリモート通知します。
（４.４

RASリモート通知機能（SNMP） 参照）

1-4

第２章

RAS機能の監視対象

第２章 RAS機能の監視対象
この章では、RAS機能の監視対象について説明します。
なお、この章で記載しているRAS外部接点インタフェース（オプション）のハードウェア仕様や各接点の意味については、「HF-W7500/LXモデル50 取扱説明書」の「５．９．１「５．９．２２．１

コネクタ仕様」および外部接点仕様」を参照してください。

ファン監視機能
ファン監視機能は、この装置に実装されている複数のファンの状態を監視し、いずれかのファンに異常が発生した場合、以下の方法で通知します。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）状態表示デジタルLED表示機能（４）RASリモート通知機能（５）自動シャットダウン機能（６）アラームランプ点灯（７）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（４）については「第４章（５）については「５．１

ハードウェア状態の確認」を参照してください。

装置の自動シャットダウン」を、（６）については「HF-W7500/LX

モデル50 取扱説明書」の「１．５

各部の名称と役割」を、（７）については「第６章ライブラリ関数」を参照してください。

また、RAS外部接点インタフェースのMCALL接点を使用すれば、RAS外部インタフェースに接続
した外部のハードウェアより、この装置の異常を検出することができます。MCALL接点の動作は以下のとおりです。

表２－１

ファン監視における装置の状態とMCALL接点の動作

この装置の状態

MCALL接点

装置起動時 または 電源断時

オープン

ファン正常 または ファン異常から回復

オープン

ファン異常

クローズ

アラームランプ（およびRAS外部接点インタフェースのMCALL接点）はファン監視以外にも使用されているため、ファン異常が回復しても他の監視対象で異常を検出している場合は、消灯（オープン）しません。

2-1

第２章

RAS機能の監視対象

２．２

筐体内温度監視機能
筐体内温度監視機能は、この装置内部の温度センサーにより筐体内温度の状態を監視し、筐体内温
度が高温異常になった場合、以下の方法で通知します。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）状態表示デジタルLED表示機能（４）RASリモート通知機能（５）自動シャットダウン機能（６）アラームランプ点灯（７）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（４）については「第４章（５）については「５．１

ハードウェア状態の確認」を参照してください。

装置の自動シャットダウン」を、（６）については「HF-W7500/LX

モデル50 取扱説明書」の「１．５

各部の名称と役割」を、（７）については「第６章ライブラリ関数」を参照してください。

また、RAS外部接点インタフェースのMCALL接点を使用すれば、RAS外部インタフェースに接続
した外部のハードウェアより、この装置の異常を検出することができます。当該接点の動作は以下のとおりです。

表２－２

筐体内温度監視における装置の状態とMCALL接点の動作

この装置の状態

MCALL接点

装置起動時 または 電源断時

オープン

正常 または 温度異常から回復

オープン

温度異常

クローズ

アラームランプ（およびRAS外部接点インタフェースのMCALL接点）は筐体内温度監視以外にも使用されているため、温度異常が回復しても他の監視対象で異常を検出している場合は、消灯（オープン）しません。

2-2

第２章

２．３

RAS機能の監視対象

ドライブ障害予測機能（SMART監視）
この装置のドライブには障害予測機能（SMART：Self-Monitoring, Analysis and Reporting
Technology）が備わっており、常にドライブの動作状態を監視して障害が発生する前にそれを予測することができます。ドライブ障害予測機能は、近い将来ドライブに障害が発生する可能性がある場
合、以下の方法で通知します。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）状態表示デジタルLED表示機能（４）RASリモート通知機能（５）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（４）については「第４章「第６章

ハードウェア状態の確認」を（５）についてはライブラリ関数」を参照してください。

留意事項
・SMARTは、ドライブのすべての障害を予測することはできません。そのため、SMARTが障害を予測する前に、ドライブが故障する場合もあります。
・ドライブの障害が予測された場合は、速やかにデータのバックアップを取り、ドライブの交換を行ってください。なお、ドライブの交換手順については、「HF-W7500/LXモデル50 取扱説明書」の「６．４．６

HDDの取り付け／取り外し」を参照してください。

・この機能が監視するのは、OS起動時に認識されているドライブベイ１、２の内蔵ドライブ
です。ドライブを新規に接続した場合や保守などで交換を行った場合、接続後の初回起動においてドライブの認識に時間がかかり、監視対象として認識されないことがあります。この場合は、この装置を再起動してください。

2-3

第２章

RAS機能の監視対象

２．４

ドライブ使用時間監視機能
ドライブ使用時間監視機能は、この装置のドライブ使用時間を積算し、使用時間が既定値を超過した場合、以下の方法で通知します。これにより、ドライブの交換時期を把握し、寿命によるドライブ
故障を予防することができます。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）RASリモート通知機能（４）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（３）については「第４章「第６章

ハードウェア状態の確認」を、（４）についてはライブラリ関数」を参照してください。

留意事項
・この機能が監視するのは、OSが起動してからシャットダウンするまでのOSが動作している時間です。そのため、OSが動作していない場合は使用時間の監視を行いません。
・新規ドライブを実装した場合、当該ドライブの使用時間の積算値は自動でリセットされます。
・この機能は、ドライブ障害を予測するものではありませんが、有寿命品の予防保守の観点か
ら、使用時間が既定値を超過した場合はドライブを交換することを推奨します。なお、ドラ
イブの交換手順については、「HF-W7500/LXモデル50 取扱説明書」の「６．４．６

HDDの取り付け／取り外し」を参照してください。
・この機能が監視するのは、OS起動時に認識されているドライブベイ１と２の内蔵ドライブ
です。ドライブを新規に接続した場合や保守などで交換を行った場合、接続後の初回起動においてドライブの認識に時間がかかり、監視対象として認識されないことがあります。この場合は、この装置を再起動してください。
・システムバックアップデータからシステムの復元を行った場合、システムバックアップを行った時点のドライブの使用時間が継続されます。
・OSおよびRASソフトウェアを再インストールした場合、各ドライブの使用時間は「0」にな
ります。

2-4

第２章

２．５

RAS機能の監視対象

メモリ状態監視機能
この装置にはECC（Error Checking and Correcting）付きメモリが実装されているため、メモリにシングルビットエラーが発生しても自動的に訂正され、装置の動作に支障はありません。しかし、メモ
リエラー訂正の発生頻度が高い場合は、メモリ故障が原因として考えられるため、予防保守の観点か
らメモリの交換を推奨します。
メモリ状態監視機能は、メモリエラー訂正の発生頻度が高い場合、以下の方法で通知します。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）RASリモート通知機能（４）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（３）については「第４章「第６章

ハードウェア状態の確認」を、（４）についてはライブラリ関数」を参照してください。

留意事項
メモリの交換については、「HF-W7500/LXモデル50 取扱説明書」の「６．４．５
モリの取り付け／取り外し」を参照してください。

2-5

メインメ

第２章

RAS機能の監視対象

２．６

OSロック監視機能
OSロック監視機能は、この装置に実装されているOS動作監視用タイマを用いて、カーネルの暴走やドライバによるCPU占有などの理由で、高レベル（リアルタイム優先度）のプロセスが動作できな
い状況（以下、OSロックと称す）が発生したことをこの装置前面のステータスランプで通知しま
す。

表２－３

OSロック監視における装置の状態とステータスランプの動作
この装置の状態

ステータスランプ

装置起動時 または 電源断時

赤色

OSロック未発生 または OSロックから回復

緑色

OSロック発生

赤色

また、RAS外部接点インタフェースのCPUSTOP接点を使用すれば、RAS外部インタフェースに接続した外部のハードウェアより、OSロックの有無を検出することができます。当該接点の動作は以下のとおりです。

表２－４

OSロック監視における装置の状態とCPUSTOP接点の動作
この装置の状態

CPUSTOP接点

装置起動時 または 電源断時

クローズ

OSロック未発生 または OSロックから回復

オープン

OSロック発生クローズ

留意事項
・RAS障害シミュレーション中は、OSロック監視機能は動作しません。
・この機能では、リアルタイム優先度のプロセスが動作できない状態をOSロックとして扱います。
・OSロックが発生した場合、OS上のプロセスがスケジュールどおりに動作することができず、処理の遅延が発生することにより、この装置を使用した設備に影響をあたえる恐れがありますので、問題点を速やかに改善してください。
・OSが起動し、この機能が開始した時点でステータスランプが緑色になります。
・OSのシャットダウン時は、この機能が停止することにより、ステータスランプが赤色になります。ただし、ステータスランプが赤色になった時点ではシャットダウン処理は完了していませんので、電源断しないように注意してください。

2-6

第２章

RAS機能の監視対象

図２－１にステータスランプとCPUSTOP接点の動作を示します。

OS動作監視タイマ
をリトリガ開始

OS動作監視タイマ
タイムアウト

電源ON
接点オープン（ステータス
ランプ緑色）

3秒

接点クローズ（ステータス
ランプ赤色）

タイマ
リトリガ
OS起動

図２－１

タイマ
リトリガ

OSシャットダウン

OSシャット
ダウン開始

電源OFF

3秒

ドライバ
によるCPU
独占状態

時刻→
タイマ
リトリガ

タイマリトリガ
プロセス終了ステータスランプとCPUSTOP接点の動作

なお、図２－１の点線は当該接点の各状態を、太線は当該接点の状態の遷移を示します。

2-7

第２章

RAS機能の監視対象

２．７

ウォッチドッグタイマ監視機能
この装置にはウォッチドッグタイマが実装されており、この機能がウォッチドッグタイマを自動的にリトリガすることで、プロセスが正常にスケジューリングされていることを監視します。また、専用のライブラリ関数を使用することで、ユーザプログラムの動作状態監視などに使用することができ
ます。

２．７．１

ウォッチドッグタイマの自動リトリガ機能
この機能はウォッチドッグタイマを定期的にリトリガするプロセスから構成されています。
このプロセスは最低レベル（アイドル優先度）で動作しているため、アイドル優先度以外の優
先度のプロセスがCPUを占有している期間が設定値を超えた場合、ウォッチドッグタイマタイ
ムアウトが発生します。これにより、アプリケーションプロセスの暴走などを検出することができます。
この機能のウォッチドッグタイマタイムアウト時間やリトリガを行う間隔は、rasconfig
コマンドで設定します。rasconfigコマンドについては、「３．１

RAS機能設定コマンド（rasconfig）」を参照してください。装置出荷時の初期設定は、次のとおりです。

タイムアウト時間

60（秒）

リトリガの間隔

20（秒）

2-8

第２章

２．７．２

RAS機能の監視対象

ユーザプログラムの動作状態監視に使用する方法
ユーザプログラムの動作状態の監視にウォッチドッグタイマを使用する場合は、例えば、
ユーザプログラムによりウォッチドッグタイマを定期的にリトリガ（ウォッチドッグタイマのタイムアウトまでの残り時間を初期値に戻す）して、ウォッチドッグタイマのタイムアウト
チェック処理を別のプログラムから行う構成となります。この場合の処理フローを以下に示します。

監視対象プログラム

監視プログラム

ユーザプログラムの処理

ウォッチドッグ
タイマのタイムアウト
チェック処理ウォッチドッグ
タイマのリトリガ
リトリガ

タイムアウトまでの
残り時間取得HF-W /LX
ウォッチドッグ
タイマ

図２－２

ユーザプログラムの動作状態監視処理の例

2-9

第２章

RAS機能の監視対象

監視対象プログラムでは、図２－２に示すように定期的にウォッチドッグタイマをリトリガします。
また、監視プログラムはウォッチドッグタイマのタイムアウトまでの残り時間を定期的に取得して、タイムアウトまでの残り時間が0になっていた場合は、タイムアウトが発生したと判定します。
タイムアウトが発生したということは、監視対象プログラムは設定したタイムアウト時間以
上の時間、ウォッチドッグタイマをリトリガできない状態にあったことを示します。この例では、別プログラムでウォッチドッグタイマのタイムアウト発生を検出していますが、RAS外部接点インタフェースを使用すれば、ウォッチドッグタイマにタイムアウトが発生すると
WDTTO接点がクローズ状態になります。この場合は、RAS外部接点インタフェースに接続した外部のハードウェアにより、ユーザプログラムの動作状態を監視することができます。
プログラムからウォッチドッグタイマを使用するときは、ライブラリ関数であるWdtControl
関数をコールします。WdtControl関数の使用方法およびRAS外部接点インタフェースの
WDTTO接点の動作については、「６．１．５

ウォッチドッグタイマ制御関数（WdtControl）」を参照してください。

留意事項
WdtControl関数を使用する場合は、ウォッチドッグタイマ自動リトリガ機能は使用できません。rasconfigコマンドにて「ウォッチドッグタイマ機能」の設定を「app（ユーザアプリの動作
状態監視）」に設定してください。rasconfigコマンドについては、「３．１マンド（rasconfig）」を参照してください。

2-10

RAS機能設定コ

第２章

２．８

RAS機能の監視対象

RAID監視機能
RAIDモデルは、一般にミラーリングとして知られているRAID1（以降RAIDと呼びます）の機能を備えています。

RAID監視機能は、この装置におけるRAIDの状態を監視し、RAIDの状態が変化したときに、以下の方法でユーザやアプリケーションに通知します。
（１）RAS状態表示コマンド（rasstat）（２）RASイベント情報管理機能（３）状態表示デジタルLED表示機能（４）RASリモート通知機能（５）アラームランプ点灯（６）RASライブラリのGetRasStat関数、WaitForRasEvent関数（１）～（４）については「第４章ハードウェア状態の確認」を、（５）については「HF-W7500/LXモデル50 取扱説明書」の「１．５「第６章

各部の名称と役割」を、（６）についてはライブラリ関数」を参照してください。

また、RAS外部接点インタフェースのMCALL接点を使用すれば、RAS外部インタフェースに接続
した外部のハードウェアより、この装置の異常を検出することができます。当該接点の動作は以下のとおりです。

表２－５

RAID状態とMCALL接点の動作

RAID状態

MCALL接点

正常

オープン

縮退、不明、故障

クローズ

アラームランプ（およびRAS外部接点インタフェースのMCALL接点）はRAIDの状態監視以外にも使用されているため、RAIDの状態が回復しても他の監視対象で異常を検出している場合は、消灯（オープン）しません。

2-11

第２章

RAS機能の監視対象

２．８．１

RAIDの状態遷移について
表２－６にRAIDの状態とその意味、図２－３に状態遷移を示します。

表２－６

RAID状態とその意味

RAID状態

説明

詳細情報
正常

－

冗長性が保たれ、正常に動作している状態－

ドライブが1台故障し、冗長性がくずれた状態

再構築中

ドライブ交換などにより、RAIDを再構築している状態

故障－

ドライブが2台故障しているまたはドライブが接続されていない状態

不明－

RAIDの状態取得に失敗した状態

縮退

メディアエラー発生

正常
ドライブ故障

縮退

縮退

RAIDの
再構築完了
電源を落としドライブ交換新規ドライブでエラー発生縮退(再構築中)

ドライブが2台故障

故障

図２－３

RAID状態遷移

2-12

RAIDの再構築完了（コピー元ドライブで読み取りエラー発生）

第２章

２．８．２

RAS機能の監視対象

メディアエラーについて
メディアエラーとは、RAID状態としては異常が発生していないが、データの健全性に問題がある状態のことです。再構築中にコピー元ドライブからの読み取りエラーが発生した場合、再構築が完了しますが、読み取れなかったセクタのデータは失われており、データの健全性に問題が発生している状態となります。

＜メディアエラー発生時のアラームランプ点灯設定＞
データの健全性に問題があるかどうかは、読み取りエラーの発生したセクタを使用しているかにより変わります。使用しているセクタで読み取りエラーが発生した場合は、データの健全性に問題が発生しますが、使用していないセクタの場合は、問題は発生しません。
このため、この装置では、メディアエラー発生時に装置前面のアラームランプを点灯する
かをシステム運用に合わせて切り替えられるようにしてあります。切り替えは、RAID構成制御コマンドの rasraidctlコマンドで行います（詳細は「５．４

メディアエラー時

ALARM点灯設定コマンド（rasraidctl MEDIAERRORALARM）」を参照してください）。既定の設定は、メディアエラー発生時のアラームランプの点灯、および状態表示デ
ジタルLEDの表示は、OFF（無効）設定となっています。

この他に、RASイベントログ、RAS状態表示コマンドのrasstat 、RASライブラリの
GetRasStat関数、WaitForRasEvent関数では、メディアエラー発生時のアラームランプ点灯設定に関わらず、常にメディアエラー発生の有無を確認できます。

2-13

第２章

RAS機能の監視対象

このページは白紙です。

2-14

第３章

RAS機能の設定

第３章 RAS機能の設定
３．１

RAS機能設定コマンド（rasconfig）

３．１．１

概要

＜名前＞
rasconfig － RAS機能の設定情報表示／設定＜書式＞
rasconfig[オプション]＜実行権限＞
本コマンドは、root権限でのみ実行可能です。
以下に説明の-r オプションは、RAS障害シミュレーション機能が停止時のみ実行可能です。

＜機能＞
rasconfigは、RAS機能の設定情報の表示およびRAS機能の設定更新を行うためのコマンドです。
以下の設定ができます。
（１） ファン異常検出による自動シャットダウン機能の ON/OFF（２） 温度異常検出による自動シャットダウン機能の ON/OFF（３） リモートシャットダウン入力（RMTSHTDN 外部接点クローズ）検出による自動シャットダウン機能の ON/OFF。
（４） 自動シャットダウン遅延時間の設定（５） ウォッチドッグタイマ関連の設定（６） 状態表示デジタル LED の設定（７） ドライブ監視の設定
オプション指定なしでコマンドを実行した場合は、現在のRAS機能設定情報が表示されます。
RAS機能の設定を行う場合は、-eオプションを指定してコマンドを実行します。
このとき、RAS機能の設定を対話形式で行えます。 リモートシャットダウン機能を有効設定にした場合、システムの再起動を促す下記メッセージが出力されます。
NOTICE: remote-shutdown function becomes effective after the system reboot.
また、ドライブの使用時間積算値のクリアを行う場合は、-rオプションを指定してコマンドを実行します。この時、下記のメッセージが表示され、使用時間積算値のクリア処理を続行するかどうかを問い合わせます。ここで [y] が入力された場合はクリア処理を続行し、 [n] が入力された
場合はクリア処理を中断します。
Used time of DRIVEx will be reset.
Are you sure you want to continue with this process ? ( y / n ):y＜オプション＞-e： RAS 機能の設定を対話形式で開始します。

-r <DRIVEx>： 指定されたドライブの使用時間積算値をクリアします。

＜診断＞
処理が正常に終了した場合、exitステータス0を返します。異常終了した場合はexitステータス0
以外を返します。

＜エラーメッセージ＞ 表３－１ rasconfigコマンドのエラーメッセージ一覧
エラーメッセージ

No
1 Usage: rasconfig
2内容[-e][-r <DRIVE1|DRIVE2|DRIVE3>]

コマンド使用文法に誤りがあります。

RAS障害シミュレーション機能が実行中です。
xx＝RAS 機能動作モード番号

ERROR: an error occurred while processing<GetRasRunMode>. mode=(xx)

3-1

第３章

RAS機能の設定＜使用方法＞RAS機能設定コマンドは、rasconfig -eを実行すると、対話式の問い合わせを行います。
各項目の一番左で表示されている値が現在の値です。設定値を入力せずにEnterキーを押下すると現在の設定値が設定されます。問い合わせに指定できる値以外を入力すると、設定終了の問い合わせを行います。’q’を入力すると、以降の設定をスキップし、設定保存の実行有無確認
メッセージが表示されます。
”##### Save configuration? (y/n) : ” では、’y’：設定値を保存。
’n’：設定値を保存せず終了。
現在の設定値の参照は、rasconfigを実行すると表示します。

＜rasconfigコマンドの表示例＞# rasconfig**** Auto shutdown ****
FAN abnormal: on
Temperature abnormal: off
Remote shutdown: on
Shutdown delay time[sec]: 30**** Watchdog Timer ****
WDT retrigger: auto
WDT timeout[sec]: 60
WDT retrigger interval[sec] : 20*** DigitalLED ***Display Hardware Status Code: on*** Used Time ***Monitor: on
Limit time of drive1[hour]: 20000
Limit time of drive2[hour]: 20000
Limit time of drive3[hour]: 20000# rasconfig -e**** Auto shutdown ****
FAN abnormal (on/off/q): on
Temperature abnormal (off/on/q): on
Remote shutdown (off/on/q): on
Shutdown delay time l[sec] (30/0-120/q): 100**** Watchdog Timer ****
WDT retrigger (auto/app/off/q):
WDT timeout[sec] (60/5-60/q): 30
WDT retrigger interval[sec] (20/1-56/q) : 10*** DigitalLED ***Display Hardware Status Code: on*** Used Time ***Monitor (on/off/q):off
Limit time of drive1[hour](20000/100-20000/q):
Limit time of drive2[hour](20000/100-20000/q):
Limit time of drive3[hour](20000/100-20000/q):======== Confirm setting ========**** Auto shutdown ****
FAN abnormal: on
Temperature abnormal: on
Remote shutdown: on
Shutdown delay time[sec]: 100**** Watchdog Timer ****
WDT retrigger: auto
WDT timeout[sec]: 30
WDT retrigger interval[sec]: 10*** DigitalLED ***Display Hardware Status Code (on/off/q):off*** Used Time ***Monitor:off
Limit time of drive1[hour]:
Limit time of drive2[hour]:
Limit time of drive3[hour]:####Save configuration? (y/n) : y
NOTICE: remote-shutdown function becomes effective after the system reboot.
##r rasconfig -r DRVIE1
Used time of DRIVE1 will be reset.
Are you sure you want to continue with this process ? ( y / n ) :y

3-2

RAS機能の設定情報表示

RAS機能の設定情報を対話形式で設定指定されたドライブの
使用時間積算値をクリア

第３章

RAS機能の設定＜rasconfigコマンドの使用例＞**** Auto shutdown ****
FAN abnormal
Temperature abnormal
Remote shutdown
Shutdown delay time[sec]**** Watchdog Timer ****
WDT retrigger
WDT timeout[sec]
WDT retrigger interval[sec]*** DigitalLED ***Display Hardware Status Code*** Used Time ***Monitor
Limit time of drive1[hour]
Limit time of drive2[hour]
Limit time of drive3[hour]

: ①
: ②
: ③
: ④
: ⑤
: ⑥
: ⑦
: ⑧
: ⑨
: ⑩
: ⑩
: ⑩

（１） 自動シャットダウン機能設定（*** Auto shutdown ***）RAS機能設定では、●ファン異常時（①）（デフォルト：on）●温度異常時（②）（デフォルト：off）●リモートシャットダウン入力時（③）（デフォルト：on）の①から③について自動シャットダウンを行うか否かの設定ができます。
それぞれの項目がonとなっている場合は、自動シャットダウン機能が行われます。現在の設定を変更する場合は、on/offを入力してください。
自動シャットダウン機能の設定を変更する場合は、下記について注意してください。
（注1）シャットダウン要求信号（RMTSHTDN）を汎用接点（GENDI）として使用する
場合には、リモートシャットダウン機能をOFFする必要があります。
（注2）リモートシャットダウン機能をOFFするとイベントメッセージの” Remote-shutdown
request was detected. ”の出力、およびログ保存は行いません。
（注3）自動シャットダウン機能をOFFからONに設定した場合は、変更内容はリブート後に有効 になります。
（注4）自動シャットダウン遅延時間は、リモートシャットダウン入力（RMTSHTDN）信号を検出した場合には、適用されません。
④で自動シャットダウン遅延時間の設定が可能です。デフォルトは３０秒となり０～１２０秒の設定（単位：秒）が可能です。
（２） ウォッチドッグタイマ設定（*** Watchdog Timer ***）
ウォッチドッグタイマ機能（⑤）は、●使用しない●自動でリトリガする●アプリケーションがリトリガするの内ひとつを選択することができます。「使用しない」を選択する場合は、⑤でoffを選択してください。「アプリケーションがリトリガする」を選択する場合は、⑤で app を選択しシステ
ムコールwdtsetを使用してウォッチドッグタイマを制御してください。
⑤でappまたはoffを選択した場合は、⑥⑦は表示されません。
「自動でリトリガする」を選択する場合は、⑤でautoを選択してください。「自動でリトリガする」を選択すると、RASUTLが自動でウォッチドッグタイマのリトリガを行います。
⑤でautoを選択した場合は、⑥でタイムアウト時間の設定が可能です。デフォルトは６０秒となり５～６０秒の設定（単位：秒）が可能です。また、⑦でリトリガ間隔時間の設定が可能です。デフォルトは２０秒となり１～５６秒の秒の設定（単位：秒）が可能です。

3-3

第３章

RAS機能の設定（３） 状態表示デジタル LED 設定（*** DigitalLED ***）
状態表示デジタルLED設定では、●ハードウェアステータスコード表示 （⑧）（デフォルト：on）
を設定することができます。状態表示デジタルLEDにハードウェアステータスコードを表示する
場合 on を、表示しない場合 off を選択してください。
（４） ドライブ監視設定（*** Used Time ***）
ドライブ監視設定では、●使用時間監視実施 （⑨）（デフォルト：on）
を設定することができます。使用時間監視を実施する場合 on を、実施しない場合 off を選択
してください。
⑩でドライブ監視時間の設定が可能です。デフォルトは２００００時間となり１００～
２００００時間の設定（単位：時間）が可能です。
（注5）Limit time of drive3[hour]は、デフォルトで２００００時間と表示されますが、本装置ではDRIVE3を実装していません。そのため監視時間を設定しても無効になります。

3-4

第４章

ハードウェア状態の確認

第４章 ハードウェア状態の確認
この装置では、以下の方法によりハードウェア状態を確認することができます。

（１）rasstatコマンドで確認する
この装置のハードウェア状態を確認することができます。詳細は、「４．１ハードウェア状態表

示機能」をご覧ください。

（２）ユーザアプリケーションで確認する
ユーザアプリケーションからRASライブラリを使用し、RASイベント情報を取得することにより、この装置のハードウェア状態を確認することができます。詳細は、「４．２

RASイベント

情報管理機能」をご覧ください。
また、ユーザアプリケーションからRASライブラリを使用することにより、この装置のハードウェ
ア状態を取得することができます。
詳細は、「４．５

RASライブラリ（GetRasStat関数、WaitForRasEvent関数）による状態取得」をご覧ください。

（３）装置前面の状態表示デジタルLEDで確認する
装置前面の状態表示デジタルLEDにより、この装置のハードウェアに異常が発生したことをお知らせします。このLEDはユーザアプリケーションからも表示できるので、保守員への障害通知などにも使用することができます。
詳細は、「４．３

状態表示デジタルLED機能」をご覧ください。

（４）リモート環境から確認する
リモート環境からこの装置のハードウェア状態を確認することができます。また、ハードウェア状態に変化があった場合、リモート環境に通知します。
詳細は、「４．４

RASリモート通知機能（SNMP）」をご覧ください。

4-1

第４章

ハードウェア状態の確認

４．１

ハードウェア状態表示機能

４．１．１

RAS状態表示コマンド（rasstat）＜名前＞
rasstat–

RAS機能が管理している装置状態の表示＜書式＞
rasstat[オプション]＜実行権限＞
本コマンドは、全ユーザが実行可能です。

＜機能＞
rasstatは、RAS機能が管理している装置状態を表示するコマンドです。
オプション指定無しで簡易表示、オプション指定有りで詳細表示を実行します。
詳細表示モードでは、コマンド表示に対応する項目を全て表示します。
簡易表示モードでは、コマンド表示に対応する項目を、装置毎に要約して表示します。

[表示方法]は下記のとおり
簡易表示モード：

各装置毎に要約した装置状態を表示します。

詳細表示モード：

表示可能な装置状態を全て表示します。

＜オプション＞-v：詳細表示モードで本機能を実行します。

＜診断＞
処理が正常に終了した場合、exitステータス0を返します。異常終了した場合はexitステータス0
以外を返します。

＜エラーメッセージ＞
なし

4-2

第４章

＜使用例＞
#
#rasstat
FAN: Error

TEMP: ErrorRAID: Degrade[MediaError]

DRIVE1: Rebuild (12%)

DRIVE2: Overrun

DRIVE3: Not Connected

MEM: Normal###rasstat -v
PWR FAN status: Normal

FR1 FAN status: Error

FR2 FAN status: NormalTemperature status: Danger(51[degC])

RAID status: Degrade

RAID task: Rebuild (12%)

Media error: Yes

DRIVE1 status: Rebuild

DRIVE1 SMART: No

DRIVE1 overrun: No(1000[h])DRIVE2 status: Online

DRIVE2 SMART: Yes

DRIVE2 overrun: Yes(99990[h])DRIVE3 status: Not Connected

DRIVE3 SMART: No

DRIVE3 overrun: No(---[h])DIMMA1 status: Not Mounted

DIMMA2 status: Normal

DIMMB1 status: Not Mounted

DIMMB2 status: NormalRas mode: Online#

4-3

ハードウェア状態の確認

第４章

ハードウェア状態の確認

表４－１

No

部位

1
3
4

項目
内容
電源ファン回転状態

2
ファン

5
6

rasstatコマンドで表示される状態表示項目（詳細表示）
状態
値

内容

PWR FAN status

フロントファン1回転状態

FR1 FAN status

フロントファン2回転状態

FR2 FAN status

8

正常

Normal

異常

Error

正常

Normal

異常

Error

正常

Normal異常

Error
Normal(xx[degC])(*1)
Error(xx[degC])(*1)
Danger(xx[degC])
(*1)

正常

7
温度

筐体内温度状態

温度異常

Temperature status

高温異常

9

値

正常

Normal

異常

Error

12

未実装

Not Mounted

13

正常Normal

異常

Error

未実装

Not Mounted

正常

Normal

異常

Error

18

未実装

Not Mounted

19

正常

Normal

異常

Error

21

未実装

Not Mounted

22

正常

Online23

未実装

Not Connected

オフライン

Offline25

リビルド中

Rebuild26

不明

Unknown

正常(未検出)No

障害予測検出Yes

正常

No(xxxxx[h]) (*4)

10

DIMMA1
メモリ状態(*2)

11

DIMMA2
メモリ状態

14
15
16

DIMMA2 status

メモリ
DIMMB1
メモリ状態(*2)

17

DIMMB2
メモリ状態

20

ドライブ状態

2427
28

DIMMA1 status

ドライブ

ドライブ障害予測
検知状態

DIMMB1 status

DIMMB2 status

DRIVEn(*3) status

DRIVEn(*3) SMART

29

DRIVEn(*3) overrun
ドライブ使用時間超過有無

使用時間超過Yes(xxxxx[h]) (*4)

31

正常

Optimal32

縮退Degrade異常

Fail(*5)34

不明

Unknown35

正常(検知なし)

No

異常(検知)

Yes

実行中タスクなし

None

リビルド中

Rebuild(**%)(*6)

39

上記以外の状態

Unknown

40

通常モード

OnlineRAS障害ｼﾐｭﾚｰｼｮﾝﾓｰﾄﾞ

Simulation

30

RAID状態

33

RAID

36

メディアエラー発生
状態

RAID status

Media error

37
38

41

実行中タスク状態

RAS

RAS動作中モード

RAID task

Ras mode

備考(*1)xxは温度値(*2)本装置では常に「未実装」となります。

(*2)本装置では常に「未実装」となります。

(*3) nは1～3。
DRIVE3は本装置では使用しないので「未実装」状態表示。
(*4)使用時間
xxxxxは未実装などの場合"---"。
ドライブ使用時間監視機能が無効の場合、正常状態表示。使用
時間は積算され表示。

(*6)値に続いて
RAIDタスク
進捗率(**%)を表示。

(*5)RAIDアレイ故障状態ではシステムが正常に動作できないため、本値を表示できない場合があります。

4-4

第４章

表４－２

No

装置

rasstatコマンドで表示される状態表示項目（簡易表示）

項目
内容

状態
値

内容

ファン

Normal

ファン
状態

FAN
異常

3

正常

Normal

異常

Error

正常

Normal

温度

温度状態

5

メモリ

状態

Error

MEM

6

異常

7

①

正常

8

②

未実装

③

ドライブ
状態

DRIVEn(*1)④

異常を表示する。
温度異常、高温異常を要約。

Error

異常を表示する。

Online

ドライブ状態、ドライブ障害予兆検知

Not

状態を要約。

Connected

・①：ドライブ正常状態、障害予兆未Offline・⑥：ドライブ障害予兆検知状態

切離され

・⑦：ドライブ使用時間超過状態

未使用

ドライブ状態、ドライブ障害予兆検知
状態、ドライブ使用時間超過状態のい

RAID

認識不可

⑥

障害予兆
検出

⑦

いずれか１つでも異常がある場合は・②～⑤：ドライブ状態⑤

13

DIMMA2、DIMMB2の状態を要約。

(アレイ)

リビルド中

12

表示する。温度値は表示しない。

検知正常状態、使用時間超過正常状態

(アレイ)

10

11

フロントファン2の状態を要約。

RAID

構成から

9

ドライブ

電源ファン、フロントファン1、いずれかの異常がある場合は異常を

TEMP

メモリ

Rebuild(**%)

ずれにおいても異常がある場合、以下(*2)

にて優先表示する。

Unknown（１）ドライブ状態＞（２）障害予兆
検知状態＞（３）使用時間超過状態

SMART

使用時間
超過

①

正常

Optimal

RAID状態、メディアエラー発生

15

②

縮退

Degrade状態、タスク進捗状況を要約。

16

③

異常

Fail(*4)

以下の書式にて表示する。

④

RAID
状態認識

RAID
RAID

状態

RAID
⑤

Unknown(*3)ドライ
ブ使用時
間監視機
能有効時
のみ
表示。

RAID状態[メディアエラー検知]

・①～④：RAID状態(常に表示)

検知時のみ表示)Media Error

・⑥：タスク進捗率(実行中タスクがある場合のみドライブ状態に表示)

タスク
進捗率(%)(*2)値に続
いてRAIDタスク 進
捗率(**%)を表示。

・⑤：メディアエラー発生状態(エラー

メディア
エラー検知

⑥
19

書式

不可

18

(*1) nは1～3。
DRIVE3は
本装置で
は使用し
ないので
「未実
装」状態
表示。

Overrun(*3)

14

17

備考

いずれか１つでも異常がある場合は

2

4

要約内容

値

正常

1

ハードウェア状態の確認

0～100(整数)(*4)RAID アレイ故障状態ではシステムが正常に動作できないため、本値を表示できない場合があります。

4-5

第４章

ハードウェア状態の確認

４．２

RASイベント情報管理機能

４．２．１

概要
この機能は、ハードウェア状態異常などのユーザに報告すべきイベントが発生した場合、ユーザアプリケーションに通知します。イベントはログファイルに保存します。
ユーザアプリケーションは、RASライブラリを使用することで、ハードウェア状態異常などのイベントを取得することができます。
また、raslogptコマンドを使用して、RASイベントログ情報を表示することができます。

４．２．２

RASイベントハンドリング概要（１）RASイベント情報取得方法
以下の方法によりイベントの発生を検出することができます。
①

WaitForRasEvent関数を使用して、イベント情報を取得します。
（６．１．７

RASイベント情報取得関数（WaitForRasEvent）参照）（２）取得できるRASイベント情報

４．２．３

●

ファン異常発生／回復●

筐体内温度異常発生／回復●

RAID状態の異常発生／回復●

ドライブの異常発生／回復●

ドライブの障害発生を予測／回復●

ドライブの使用時間超過●

メモリのエラー訂正高頻度発生／発生頻度低下●

リモートシャットダウン信号検知●

自動シャットダウン開始●

緊急シャットダウン開始

RASイベントログ情報保存
RASイベント発生時にイベント情報を収集して、RASイベントログファイルに保存します。
取扱説明書」の

RASイベントログ内容については、「HF-W7500/LXモデル50「９．３

イベントメッセージ」を参照ください。

保存したRASイベント情報は、raslogptコマンドを使用して、情報を表示できます。
（７．３．１

RASイベントログ表示コマンド（raslogpt）参照）
表４－３

RASイベントログファイル仕様

No

項目

仕様

1

ログファイル名/var/log/rasutl/rasevent.log

2

RASイベント情報保存

件数（512件）

3

保存件数超過時の動作仕様

サイクリック（最古のイベント情報削除）

4

ログファイル形式

バイナリ形式

4-6

第４章

４．３

ハードウェア状態の確認

状態表示デジタルLED機能

４．３．１ 概要
この機能は、ハードウェア状態異常などのユーザに報告すべきイベントが発生した場合、この装置前面に実装している状態表示デジタルLEDにステータスコードを表示することでユーザに通知します。これにより、ハードウェア状態異常などのイベントの発生を知ることができます。
また、ライブラリ関数を使用することにより、ユーザアプリケーションから任意のステータ
スコードを表示することができます。LED表示は、2桁の16進数として表示されます。

システムの状態を2桁16進数のコードで表示

状態識別LED
①

②

③

図４－１

①RASステータス（赤色）②アプリケーションステータス（緑色）③BIOSステータス（橙色）

状態表示デジタルLED

4-7

第４章

ハードウェア状態の確認

４．３．２ 表示するステータスコード（１）ハードウェアステータスコード
この装置のハードウェア状態に異常が発生した場合に表示するステータスコードです。
ハードウェア状態が正常な場合は何も表示されません。
具体的には、以下の場合にハードウェアステータスコードを表示します。
●

ファン異常発生（電源ファン／フロントファン1／フロントファン2）●

筐体内温度異常発生●

ドライブの障害発生を予測●

RAID状態異常発生（メディアエラー発生時も含む）

ハードウェアステータスコード表示時は、状態識別LEDの左端が点灯します。
ハードウェアステータスコードの内容については、「表４－４
コードの一覧」を参照してください。

【RAS状態正常時】【RAS状態異常時】

消灯

図４－２

点灯

ハードウェアステータスコード

4-8

ハードウェアステータス

第４章

表４－４

ステータス

No

コード値

ハードウェア状態の確認

ハードウェアステータスコード一覧

監視部位

異常発生詳細

優先順位
部位

内蔵ファン

電源ファンの異常を検出

1

11

2

12

フロントファン 1 の異常を検出

313

フロントファン 2 の異常を検出

4

21

筐体内温度

温度異常を検出531

内蔵ドライブドライブベイ 1 のドライブで SMART を検出

詳細
22

2

21
23

3

31
41

4

6

32

SMART

ドライブベイ 2 のドライブで SMART を検出

741

内蔵 RAID

ドライブベイ 1 のドライブが非オンライン(*3)

14

8

42

ドライブベイ 2 のドライブが非オンライン(*3)

15

9

4B

RAID アレイの故障(Fail)を検出(*1)

10

4C

RAID アレイの不明(Unknown)を検出

11

11

4D

RAID メディアエラーを検出(*2)

13

42

1

12

(*1)RAIDアレイ故障状態ではシステムが正常に動作できないため、本ステータスコード値を表示できな
い場合があります。
(*2)RAIDメディアエラー通知設定(rasraidctl)を有効設定にしている場合のみ表示(製品出荷初期設定は無効
設定)(*3)ドライブ状態の「非オンライン」とは『オフライン／未実装／リビルド中』のいずれかの状態です。
複数の障害が同時に発生した場合は、優先順位が最も高い（表４－４「優先順位(詳細)欄」の値が最も小さい値）ステータスコードが表示されます。

4-9

第４章

ハードウェア状態の確認（２）アプリケーションステータスコード
この機能が提供するライブラリ関数を使用することにより、ユーザアプリケーションから表示するステータスコードです。

アプリケーションのステータスコード表示時は、状態識別LEDの中央が点灯します。

点灯

図４－３

アプリケーションステータスコード（３）STOPエラーコード
OS障害発生などによりメモリダンプ機能（７．１

メモリダンプ機能参照）が動作した

場合に表示するエラーコードです。STOPエラーコードとして「80」を優先的に表示します。
STOPエラーコード表示時は、状態識別LEDのすべてが点灯します。

点灯

図４－４

STOPエラーコード

4-10

第４章

ハードウェア状態の確認

４．３．３ ステータスコードの表示（１）ステータスコードの表示タイミング
下記に示すステータスコード表示条件が発生したときに、ステータスコードの表示が行われます。
ステータスコードの表示は、当該コードの表示要因が排除されるか、装置電源OFFされるまで継続されます。主電源OFFまたは電源スイッチONにより表示をリセットします。
表 ４－５ ステータスコード表示条件一覧
ステータスコード種別

No

ステータスコード表示条件
SMART 監視機能異常検出時

1

RAID 監視機能異常検出時

ハードウェアステータスコード

温度監視機能異常検出時
ファン監視機能異常検出時

2

アプリケーションステータスコード

RAS ライブラリ関数(SetStCode7seg)使用時

3

STOP エラーコード

カーネルパニック等のメモリダンプ採取要因発生時（２）ステータスコードの表示種別一覧
状態識別LED点灯パターンによるステータスコードの表示種別は下記となります。

表 ４－６ ステータスコードの表示種別一覧
状態識別LED
No

RAS

アプリ

3

POST コード

BIOS

●

(未使用)

－

●

BIOS エラーコード

BIOS

●

アプリケーションステータスコード

ユーザアプリ

●

(未使用)

－

ハードウェアステータスコード

RAS 機能STOP エラーコード

RAS 機能

●
●

4
5

●

6

●

7

●

表示元

●

1
2

ステータスコード種別

BIOS

●

●

4-11

第４章

ハードウェア状態の確認

４．３．４ 状態表示デジタルLED制御関数
状態表示デジタルLEDを制御するライブラリ関数として、表４－７に示す関数を提供してい
ます。

表４－７

状態表示デジタルLED制御関数一覧

No

関数名称

機能

共有ライブラリ

1

SetStCode7seg

アプリケーションステータスコードを表示する。

2

TurnOff7seg

アプリケーションステータスコードを非表示にする。

3

SetMode7seg

ステータス表示モードを設定する。

libRASUTL.so

上記関数は、RASライブラリ（libRASUTL.so）にて提供します。
ライブラリ関数のインタフェースについては、「６．１．４

状態表示デジタルLED制御関数（SetStCode7seg 、TurnOff7seg、SetMode7seg）」を参照してください。

4-12

第４章

４．４

ハードウェア状態の確認

RASリモート通知機能（SNMP）

４．４．１ 概要RASリモート通知機能（SNMP）は、HF-Wのハードウェア状態を、ネットワークを介したリモート環境から確認できるようにするための機能です。
本機能では、ネットワーク管理用プロトコルとして標準的なI/FであるSNMP（Simple
Network Management Protocol）を使用するため、SNMPを採用している多様なネットワーク
管理ソフトウェアによるリモート監視を可能としています。また、本機能で対応するSNMP
バージョンとして、SNMPv1およびSNMPv2をサポートします。
RASリモート通知機能ではHF-W特有の情報であるRAS情報を公開するため、専用の拡張
MIBを定義しています。本機能を使用する場合、この拡張MIBをリモート環境にローディング
する必要があります。
拡張MIBの情報に関しては「 ４．４．２

表４－８
No

SNMP拡張MIB一覧 」を参照ください。

RASリモート通知機能（SNMP）概略仕様

項目

1

RAS 状態照会機能

2

イベント通知機能説明
リモート環境からの要求により、HF-W のハードウェアの各状態を通知します。
RAS ソフトウェアが HF-W 本体の障害発生、障害復旧等を検出した場合に、
HF-W 本体からリモート環境に対してトラップ通知を行います。

留意事項
・RASリモート機能が使用するSNMPは、TCP/IPのアプリケーション層プロトコルであり、
トランスポート層ではUDP（User Datagram Protocol）を使用しています。
このため、ネットワークの負荷によってはハードウェア状態を正常に受信できない場合があります。
・以下の情報を取得するとsnmpdの使用メモリが増加する可能性があります。ご使用の前に、事前に十分検証して頂きますようお願い致します。
OID: UCD-SNMP::extTable(1.3.6.1.4.1.2021.8)/usr/share/snmp/mibs/UCD-SNMP-MIB.txtに定義されています。

4-13

第４章

ハードウェア状態の確認

４．４．２

SNMP拡張MIB一覧

RASリモート通知機能（SNMP）では、HF-W固有情報であるRAS情報をベンダー拡張用サブツ
リー下のHitachi〔iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).hitachi(116)〕サブツリー下に定義しています。
Hitachiサブツリー下には、日立のオブジェクトID登録ルールに従い、system(3)サブツリー、
systemExMib(5)サブツリーおよびsystemAP(7)サブツリーの直下にHF-W/LXシリーズ用サブツリーを定義しています。

iso(1).org(3).dod(6).internet(1).private(4)enterprises(1)IBM(2)

hfwExMibInfo(1)hfwFan(1)HP(11)

hitachi(116)

Sun(42)

Microsoft(311)system(3)systemExMib(5)systemAP(7)hfwLx(50)hfwLxExMib(50)hfwLxMibTrap(50)hfwRasStatus(1)hfwTemp(2)hfwRasSetting(2)hfwHdd(3)hfwRaid(4)hfwRasInfo(3)hfwRasErrorTrap(1)hfwMem(5)

図４－５

サブツリー

4-14

hfwRasRecoverTrap(2)hfwRasInfoTrap(3)

第４章

４．４．３

ハードウェア状態の確認

hfwLxサブツリー

hfwLx(.1.3.6.1.4.1.116.3.50)下に、hfwExMibInfo(1)サブツリーを定義します。

４．４．４

hfwExMibInfoサブツリー

hfwExMibInfo(.1.3.6.1.4.1.116.3. 50.1)下のサブツリーについて以下に示します。
表 ４－９ hfwExMibInfo下サブツリー
No

識別子

オブジェクト
名称

データ型

1

1.0

Version整数

1固定

read-only

－

2

2.0

Revision

整数

3固定

read-only

－

４．４．５

データ
値域

アクセス制限データ
単位

説明
HF-W/LX用拡張MIBのバージョン情報
HF-W/LX用拡張MIBのリビジョン情報

hfwLxExMibサブツリー

hfwLxExMib(.1.3.6.1.4.1.116.5. 50)下に、hfwRasStatus(1)、hfwRasSetting(2)およびhfwRasInfo(3)サブツリーを定義します。
４．４．６

hfwRasStatusサブツリー

hfwRasStatus(.1.3.6.1.4.1.116.5. 50.1)下のサブツリーについて以下に示す。
表 ４－１０ hfwRasStatus下サブツリー(1/5)
格納データ(index)
データ値

No

識別子

オブジェクト
名称

アクセス
制限

データ
型

1

1

hfwFan

－

－

－

2

1.1.0

fanNumberread-only

整数

3

監視対象のファンユニットの個数

31.2

fanTablenot-accessible

－

－

－

4

1.2.1

fanEntry

not-accessible

－

－

－

1

1

fanEntryアクセス用のインデックス値

2

2

(*1)

3

3

1

FR2 fan

2

PWR fan

3

FR1 fan“FR2 fan” ：フロントファン2

1 (Normal)

ファン回転状態についての情報(*1)

5

6

7

1.2.1.1.

fanIndex

read-only

整数(index)1.2.1.2.

fanNameread-only

文字列(index)整数
fanStatus

read-only(列挙型)

このサブツリー下ではファン状態に関する情報を定義する。

ファン識別名称についての情報(*1)“PWR fan” ：電源ファン“FR1 fan” ：フロントファン1(index)1.2.1.3.

説明

1：正常

1～3
2 (Error)

4-15

2：異常(ファン回転数低下／停止)

第４章

ハードウェア状態の確認

表 ４－１０ hfwRasStatus下サブツリー(2/5)
識別子No

オブジェクト

アクセス

データ

名称

制限

型

格納データ

説明

データ値

(index)

このサブツリー下では温度状態に

82

hfwTemp

－

－

－

9

2.1.0

tempNumber

read-only

整数1

監視対象の温度ユニットの個数

10

2.2

tempTable

not-accessible

－

－

－

11

2.2.1

tempEntry

not-accessible

－

－

－

tempIndex

read-only

整数

1

1

tempEntryアクセス用のインデックス値

read-only

文字列

1“Internal

温度ユニット識別名称についての情報

tempName

122.2.1.1.

関する情報を定義する。

(index)13

2.2.1.2.
(index)“Internal temperature”：筐体内温度

temperature”

温度状態についての情報
14

2.2.1.3.
(index)1(Normal)

整数
tempStatus

read-only

(列挙型)

1

1：正常

2(Error)2：温度異常(温度異常閾値超過)3(Danger)15

3

hfwHdd－－－3：高温異常(高温異常閾値超過)このサブツリー下ではドライブ状態に関する情報を定義する。
ドライブ実装可能台数
3：実装可能台数

16

3.1.0

hddNumberread-only

整数

3

データ値は「3」ですが、本装置ではDRIVE3を使用しないため、実際の実装
可能台数は「2」。

17

3.2

hddTablenot-accessible

－

－

－

18

3.2.1

hddEntry

not-accessible

－

－

－

1

1

hddEntryアクセス用のインデックス値

2

2

(*2)

3

3

19

3.2.1.1.
(index)

hddIndex

read-only

整数

ドライブ属性(用途)についての情報(*2)

20

3.2.1.2.
(index)

hddAttribution

read-only

整数
(列挙型)

1～3

1 (Signle)

1：シングルドライブ用ドライブ

11(RAIDArray)

11：RAIDモデル － アレイ構成用

12(Hotspare)(*5)
99(Unknown)

ドライブ
12：RAIDモデル － ホットスペア用
ドライブ
99：用途情報認識不可

4-16

第４章

ハードウェア状態の確認

表 ４－１０ hfwRasStatus下サブツリー(3/5)
No

識別子

オブジェクト

アクセス

データ

名称

制限

型

格納データ
データ値

(index)

データ

説明

単位

ドライブ状態についての情報(*2)

21

3.2.1.3.
(index)

hddStatus

read-only

整数
(列挙型)

1～3

1(Online)1：正常

2(NotConnected)

2：未実装

11(Offline)

11：RAID(アレイ)構成から切離12(Rebuild)

され未使用

13(CopyBack)－

12：RAID(アレイ)再構築実施中(*5)

13：ホットスペアからデータ

14 (Copy) (*5)

復旧中

15(Ready) (*5)

14：ホットスペアにデータ

99(Unknown)

コピー中
15：RAID(アレイ)組込み待機中
99：ドライブ状態認識不可
ドライブ障害予兆検知状態に

22

3.2.1.4.
(index)

hddPredict

read-only

整数
(列挙型)

1～3

1(No)

－

ついての情報(*2)
1：正常(未検出)

2(Yes)

2：障害予兆検出
ドライブ使用時間超過有無に
23

3.2.1.5.
(index)整数
hddOverRun

read-only

(列挙型)

1～3

1(No)

－

ついての情報(*2)
1：正常(使用時間超過なし)

2(Yes)

2：使用時間超過
24

25

3.2.1.6.
(index)4

hddUseTime

read-only

整数

hfwRaid－－1～3

0～(0xFFFFFFFF)

時間(h)

－

－

ドライブ使用時間(*2)(*3)

このサブツリー下ではRAID状態に関する情報を定義する。

26

4.1.0

raidNumber

read-only

整数

0～1

－

RAIDアレイ数
1：Dモデル27

4.2

raidTable

not-accessible

－

－

－

－

28

4.2.1

raidEntry

not-accessible

－

－

－

－
raidEntryアクセス用の

29

4.2.1.1.
(index)raidIndex

read-only

整数

1

1

－

インデックス
1：Dモデル

4-17

第４章

ハードウェア状態の確認

表 ４－１０ hfwRasStatus下サブツリー(4/5)
識別子No

オブジェクト

アクセス

名称

制限

格納データ

データ型

データ値

(index)

データ

説明

単位

RAID状態についての情報
1：正常
1(Optimal)

2：条件付正常2(CondOptimal)

30

4.2.1.2.
(index)raidStatus

read-only

整数
(列挙型)

(*5)

1

3：縮退

－

3(Degrade)

4：故障(アレイが壊れ復旧

4(Fail) (*6)

不可能な状態)99(Unknown)

99：RAID状態認識不可(未サポートRAIDレベル含む)
実行中タスクについての情報
1(None)1：実行中タスクなし

2(Rebuid)31

4.2.1.3.
(index)整数

raidRunningTask

read-only

2：アレイ再構築中(リビルド)

3(CopyBack) (*5)

1

4(ConsistencyCheck)

(列挙型)

－

3：コピーバック中(ホットスペアからのデータ書き戻し)(*5)
5(Copy)( *5)

4：一致化チェック中

99(Unknown)

5：コピー中99：タスク状態認識不可

32

4.2.1.4.

raidRunning(index)

TaskProgress

read-only

整数

進捗率
1

0～100

タスク進捗状況についての情報(%)
メディアエラー発生状態に

33

4.2.1.5.

raidMediaError(index)Indicator

整数
read-only

ついての情報1(No)1－

2(Yes)(列挙型)

1：正常(メディアエラー検知なし)
2：異常(メディアエラー検知)

34

5

hfwMem

－

－

－

－

－

このサブツリー下ではメモリ状態に関する情報を定義する。

35

5.1.0

memNumber

36

5.2

memTable

37

5.2.1

memEntry

read-only
not-

整数

1

2

－

メモリ実装可能数

－

－

－

－

－

－

－

－

－

－

accessible
notaccessible

4-18

第４章

ハードウェア状態の確認

表 ４－１０ hfwRasStatus下サブツリー(5/5)
No

識別子

オブジェクト

アクセス

名称

制限

格納データ

データ型

データ値

(index)

データ

説明

単位

memEntryアクセス用のインデックス(*4)
38

5.2.1.1.
(index)memIndex

read-only

整数

1～4

1～4

－

1 : DIMMA1
2 : DIMMA2
3 : DIMMB1
4 : DIMMB2

39

5.2.1.2.
(index)memNameread-only

文字列

1“DIMMA1”

2“DIMMA2”

3“DIMMB1”

4“DIMMB2”

メモリ識別名称についての－情報(*4)

メモリ状態についての情報(*4)

40

5.2.1.3.
(index)memStatus

read-only

整数

1：正常

1(Normal)

1～4

(列挙型)

2 (Error)－3(NotMounted)

2：異常(エラー訂正高頻度
発生状態)
3：未実装

(*1) index値は、それぞれファンに対応 → 1:FR2 fan , 2: PWR fan , 3: FR1 fan(*2) index値は、それぞれDRIVEに対応 → 1: DRIVE1, 2: DRIVE2, 3: DRIVE3
DRIVE3は本装置では使用しないため定義のみとなります。
(*3) 使用時間監視無効の場合も積算されて表示します。
(*4) index値は、それぞれメモリに対応 → 1:DIMMA1, 2:DIMMA2, 3:DIMMB1, 4:DIMMB2
ただし本装置では 1:DIMMA1および 3:DIMMB1は、常に「未実装(3)」となります。
(*5) 本装置では使用しないため定義のみとなります。
(*6) RAIDアレイ故障状態ではシステムが正常に動作できないため、本データ値を取得できない場合が
あります。

4-19

第４章

ハードウェア状態の確認

４．４．７

hfwRasSettingサブツリー

hfwRasSetting(.1.3.6.1.4.1.116.5.50.2)下のサブツリーについて以下に示します。
表 ４－１１ hfwRasSetting下サブツリー
No

識別子

オブジェクト名称

データ
値域

データ型

アクセス
制限

データ
単位

説明
ファン異常検出時の自動シャットダウン

1

1.0

hfwFanAutoShutdown

実行有無設定整数

1(Enable)(列挙型)

2(Disable)－

read-only

1：自動シャット
ダウンを行う2：自動シャット
ダウンを行わない
温度異常検出時の自動
シャットダウン実行

22.0

hfwTempAutoShutdown

有無設定

整数

1(Enable)(列挙型)

2(Disable)－

read-only

1：自動シャット
ダウンを行う2：自動シャット
ダウンを行わない
外部接点[RMTSHTDN]
入力検出時の自動シャットダウン実行

整数
3

3.0

hfwRemoteAutoShutdown

1(Enable)(列挙型)

2(Disable)

有無設定

－

read-only

1：自動シャット
ダウンを行う2：自動シャット
ダウンを行わない４．４．８

hfwRasInfoサブツリー

hfwRasInfo(.1.3.6.1.4.1.116.5.50.3)下のサブツリーについて以下に示します。
表 ４－１２ hfwRasInfo下サブツリー
No

識別子

オブジェクト名
称

データ型

データ
値域

アクセス
制限

データ
単位

説明
RAS動作中モードについての
情報

1

1.0

整数
hfwRasMode(列挙型)

1(Online)2(Simulation)3(Offline)

read-only－

1：通常モードで動作中
2：RAS障害シミュレーション
モードで動作中
3：動作停止

4-20

第４章

４．４．９

ハードウェア状態の確認

hfwLxMibTrapサブツリー

hfwLxMibTrap(.1.3.6.1.4.1.116.7.50)下に、hfwRasErrorTrap(1)、hfwRasRecoverTrap(2)および
hfwRasInfoTrap(3)サブツリーを定義します。

４．４．１０hfwRasErrorTrapサブツリー

hfwRasErrorTrap(.1.3.6.1.4.1.116.7.50.1)下のサブツリーについて以下に示します。
表 ４－１３ hfwRasErrorTrap下サブツリー
識
No

別

通知データ
オブジェクト名称

子

1

2

3

1

2

3

hfwFanError

hfwTempError

hfwSmartDetect

通知オブジェクト

説明

データ値"PWR fan" "FR1 fan" "FR2

fanNamefan" のいずれか

fanStatus

2 (Error)

tempName“Internal temperature”

ファン異常検知の通知

温度異常検知の通知

2 (Error )tempStatus

3 (Danger)

hddIndex

1～3

ドライブ障害予兆

hddPredict

2 (Detected)

検知の通知(*1)

hddIndex

1～3

ドライブ使用時間超過検知の通知(*1)

4

4

hfwHddOverRun

hddOverRun

2 (Yes)hddOverRunオブジェクトは、Yes(2)となる。

raidIndex
55hfwRaidError

1

raidStatus

2 (CondOptimal)(*2)

RAID状態異常検知の通知

3(Degrade)

データ値1は、RAIDのアレイ1

4(Fail) (*3)

となる。

99(Unknown)“DIMMA1”,“DIMMA2”

6

7

6

9

hfwMemError

hfwMediaError

memName“DIMMB1”,“DIMMB2”のエラー訂正高頻度発生検知のいずれか(*4)

通知

memStatus

2（Error）

raidIndex

1

raidMediaErrorIndicator2（Error）

メディアエラー発生検知の通知
データ値1は、RAIDのアレイ1となる。

(*1) データ値1はDRIVE 1、2はDRIVE 2、3はDRIVE 3を表します。DRIVE3は本装置では使用しない
ため定義のみとなります。
(*2) 本装置では使用しないため定義のみとなります。
(*3) RAIDアレイ故障状態ではシステムが正常に動作できないため、本データ値を取得できない場合があります(*4) 本装置では DIMMA1および DIMMB1は使用しません。

4-21

第４章

ハードウェア状態の確認

４．４．１１

hfwRasRecoverTrapサブツリー

hfwRasRecoverTrap(.1.3.6.1.4.1.116.7.50.2)下のサブツリーについて以下に示します。
表 ４－１４ hfwRasRecoverTrap下サブツリー
識
No

通知データ

別

オブジェクト名称

子

1

2

3

4

1

2

3

5

hfwFanRecover

hfwTempRecover

hfwSmartRecoverhfwRaidRecover

オブジェクトfanName

説明

データ値"PWR fan” ,"FR1 fan"
"FR2 fan" のいずれか,

ファン異常からの回復検知の通知

fanStatus

1 (Normal)

tempName“Internal temperature”

tempStatus

1 (Normal)

hddIndex

1～3

ドライブ障害予兆検知状態から

hddPredict

1 (Normal)の回復検知の通知(*1)

raidIndex

1

RAID状態異常からの回復検知の

raidStatus

1(Optimal)

通知

温度異常からの回復検知の通知“DIMMA1”,“DIMMA2”

5

6

hfwMemRecovermemNamememStatus“DIMMB1”,“DIMMB2”のエラー訂正高頻度発生からのいずれか(*2)

回復検知の通知1(Normal)(*1) データ値1はDRIVE 1、2はDRIVE 2、3はDRIVE 3を表します。DRIVE3は本装置では使用しない
ため定義のみとなります。
(*2) 本装置では DIMMA1および DIMMB1は使用しません。
４．４．１２

hfwRasInfoTrapサブツリー

hfwRasInfoTrap(.1.3.6.1.4.1.116.7.50.3)下のサブツリーについて以下に示します。
表 ４－１５ hfwRasInfoTrap下サブツリー
識No

別

通知オブジェクト(OBJECTS)
オブジェクト名称子

オブジェクト1

1

hfwRasServiceStarted

hfwRasMode22

hfwRasModeChanged

hfwRasMode3

3

hfwRasServiceStopped

hfwRasMode

データ値

1 (Online)
1 (Online)
2 (Simulation)
3 (Offline)

4-22

説明

RASサービス起動の通知
RAS動作モード変更の通知
RASサービス停止の通知

第４章

４．４．１３

ハードウェア状態の確認

RAS状態照会機能

RAS状態照会機能は、リモート環境からの要求により、HF-Wハードウェア各状態の監視や制御を行うための機能です。
SNMPによるリモート監視では、監視する側をマネージャ、監視される側をエージェントと呼び、マネージャとエージェント間でコマンドをやり取りすることによって監視と制御を行っています。
マネージャであるリモート環境からエージェントであるHF-W本体に対してMIB情報の取得／設定の要求を発行し、エージェントはその要求を処理して結果をマネージャに応答します。

リモート環境マネージャ
要求(取得/設定)

応答
HF-W

応答
HF-W

エージェントエージェント

MIB

MIB

図４－６

状態照会時のネットワーク構成例

本機能で照会できる情報を下記一覧に示します。
表４－１６

照会情報一覧

No

項目

内容

1

HF-W 機器識別情報

HF-W の機器識別をするための情報。バージョン情報等を保有しています。

2

HF-W 情報

HF-W のハードウェア各状態の監視や、制御を行うための情報。

本機能で照会できる拡張MIBとして、HF-W機器識別用MIB情報とHF-W用MIB情報の2つがあります。
HF-W機器識別用MIB情報に関しては 「４．４．３
HF-W用MIB情報に関しては 「４．４．５

hfwLxサブツリー 」を参照ください。

hfwLxExMibサブツリー 」を参照ください。

RAS 状態表示機能で照会できる情報を下記一覧に示します。
表４－１７
No
1

RAS状態照会機能の動作仕様

項目
MIB 情報更新周期

内容
５秒周期にて動作

4-23

第４章

ハードウェア状態の確認

４．４．１４

イベント通知機能

イベント通知機能は、RASソフトウェアがHF-W本体の障害発生、障害復旧等を検出した場合に、HF-W本体からリモート環境に対してトラップ通知を行う機能です。
エージェントであるHF-W本体の内部でMIB情報を監視し、MIB情報が特定の状態に変化した場合にその旨をマネージャであるリモート環境に対してトラップ通知を行います。

リモート環境
マネージャ

通知
HF-W

エージェント

MIB

図４－７

異常
発生

イベント通知機能ネットワーク構成例

トラップ通知は下記項目のタイミングで実施します。
表４－１８
No

トラップ通知一覧

項目

1

障害発生時

2

障害復旧時

3

RAS ソフトウェア起動

内容
RAS ソフトウェアが HF-W の障害を検出した場合、障害が発生したことをト
ラップ通知します。
RAS ソフトウェアが HF-W の障害の回復を検出した場合、障害が回復したことをトラップ通知します。
RAS ソフトウェア起動時、停止時および RAS 動作モード切替時にその旨をトラップ通知します。

本機能でトラップ通知を使用するための拡張MIBとして、HF-W用トラップMIB情報があります。
HF-W用トラップMIB情報に関しては「 ４．４．９

4-24

hfwLxMibTrapサブツリー 」を参照ください。

第４章

４．４．１５

ハードウェア状態の確認

RASリモート通知機能の開始手順

RASリモート通知機能は標準では無効になっているため、本機能を使用する時は以下の手順に従い、RASリモート通知機能を有効にする必要があります。

留意事項
・snmpd.confファイル変更後に必ずOSの再起動を行い、snmpd.confファイルの変更内容を反映してください。

（１）ファイアーウォールで’snmp’を通すよう追加設定を行います。
① デスクトップの「アプリケーション」をクリック後、「諸ツール」より「ファイアーウォール」をクリックします。
② 「ファイアーウォールの設定」画面から「設定：」の「実行時」をクリックして、「永続」を選択して変更します。
③ 「ファイアーウォールの設定」画面から「ゾーン」のなかの「public」をクリック、「ポート」タグをクリックして、「追加」ボタンクリックします。
④ 「ポートとプロトコル」画面にて、下記内容の「ポート/ポート範囲」を入力と「プロトコル」の選択をして「OK」ボタンをクリックします。
（１ポートずつ追加する処理を４回繰り返します）

表４－１９

ポートとプロトコル設定内容

ポート/ポート範囲

No

プロトコル

1

161

TCP/snmp2

161

UDP/snmp

3

162

TCP/snmp

4

162

UDP/snmp⑤ すべて設定したら画面を閉じてください。

4-25

第４章

ハードウェア状態の確認（２）snmpd.conf ファイル定義/etc/snmp/snmpd.conf ファイルの定義編集を行います。

①コミュニティ情報の登録/etc/snmp/snmpd.confファイルを編集し、コミュニティ情報の登録を行います。
################################################################################ Access Control################################################################################ As shipped, the snmpd demon will only respond to queries on the# system mib group until this file is replaced or modified for# security purposes. Examples are shown below about how to increase the# level of access.
# By far, the most common question I get about the agent is "why won't# it work?", when really it should be "how do I configure the agent to# allow me to access it?"#
# By default, the agent responds to the "public" community for read# only access, if run out of the box without any configuration file in# place. The following examples show you other ways of configuring# the agent so that you can change the community names, and give
# yourself write access to the mib tree as well.
## For more information, read the FAQ as well as the snmpd.conf(5)# manual page.
####
１．SNMPトラップ通知で使用するための# First, map the community name "public" into a "security name"
コミュニティ登録指定を行う。
①コミュニティ名称を入力#
sec.name source
community→（例)hfwlx
com2sec notConfigUser default
publiccom2sec hfwlxnet default hfwlx#trapcommuity hfwlx
２．SNMPトラップ設定を入力する。
#trap2sink 192.168.1.1 hfwlx①トラップ通知先IPアドレスを指定→（例) 192.168.1.1②通知コミュニティ名称を入力→（例)hfwlx（３）snmpd.confの変更内容反映
snmpd.confファイル変更後にOSの再起動を行い、snmpd.confファイルの変更内容を反映します。

①マネージャ側（リモート接続先）の設定
RASリモート通知機能を使用するためにはSNMPマネージャソフトにHF-W用の拡張MIBファイルの読込みを行う必要があります。使用するマネージャソフトウェアの手順に従い、HF-W用拡張MIB
ファイルの読込みを行ってください。
HF-W/LX用SNMP拡張MIBファイル名

hfwLxExMib.mib

HF-W/LX用SNMP拡張MIBファイルはRASUTLインストールDVDメディアから取得してください。
（格納先はDVDドライブ /mibs/hfwLxExMib.mib）

4-26

第４章

４．５

ハードウェア状態の確認

RAS ライブラリ（GetRasStat 関数、WaitForRasEvent 関数）による状態取得
RASライブラリ（GetRasStat関数、WaitForRasEvent関数）を使用することにより、以下に示すRAS

機能にて監視しているハードウェア状態を取得することができます。
RASライブラリ関数の詳細については、「６．１．６「６．１．７

RAS状態取得関数（GetRasStat）」、

RASイベント情報取得関数（WaitForRasEvent関数）」を参照してください。

●

ファン状態の取得●

筐体内温度状態の取得●

メモリ状態の取得●

RAID状態の取得●

ドライブ状態の取得●

ドライブ障害予測情報の取得●

ドライブ使用時間超過情報の取得

4-27

このページは白紙です。

第５章

ハードウェアの制御

第５章 ハードウェアの制御
この装置では、ハードウェア異常時やリモートシャットダウン接点入力検出時に、自動的にシャットダウ
ンを行います。
また、RASライブラリ関数によりハードウェア状態を制御することができます。

（１）装置の自動シャットダウン
ハードウェア異常時やリモートシャットダウン接点入力検出時に、自動的にシャットダウンを行います。「５．１

装置の自動シャットダウン」をご覧ください。

（２）RASライブラリによるハードウェアを制御する
ユーザアプリケーションからRASライブラリを使用することにより、この装置のハードウェアを制御することができます。「５．２

RASライブラリによる制御」をご覧ください。

5-1

第５章

ハードウェアの制御

５．１

装置の自動シャットダウン
この機能は、ファン異常や高温異常など装置を稼働するには危険な状態にある場合に、自動でシャットダウンを行います。これによりプロセッサなどの内蔵部品を熱による劣化より保護し、この装置の誤動作によるシステムの暴走を防止します。また、外部からのリモートシャットダウン信号の入力により自動でシャットダウンを行うこともできます。

５．１．１

ファン異常検出による自動シャットダウン
この装置に実装されているいずれかのファンに異常が発生したことを検出した場合に、自動でシャットダウンします。
・この機能は、rasconfigコマンドで有効／無効を設定することができます。装置出荷時の初期設定は有効です。詳細は、「３．１

RAS機能設定コマンド（rasconfig）」を参照してください。
・この機能によりシャットダウンを行った場合は、OSシャットダウン後に自動的に電源断を行います。
・ファン異常検出を通知するRASイベントを使用して、ユーザアプリケーションからシャットダウンすることもできます。RASイベントについては、「４．２

RASイベント情報管理機能」を参照してください。

留意事項
・ファンの異常が発生した状態でこの装置の動作を継続すると、プロセッサなど内蔵部品の冷却が不充分になり、装置の誤動作によるシステムの暴走や部品の破壊の可能性があります。
このため、できるだけこの機能は有効にしてください。
・この機能を使用しない場合でも、ファン異常検出を通知するRASイベントを使用して、ユー
ザアプリケーションからシャットダウンするようにしてください。
・ファンの交換については、日立保守員または日立保守教育受講者に作業を依頼してくださ
い。

5-2

第５章

５．１．２

ハードウェアの制御

高温異常検出による自動シャットダウン
この装置内部の温度センサにより筐体内温度が高温異常であることを検出した場合に自動でシャットダウンします。
・この機能は、rasconfigコマンドで有効／無効を設定することができます。装置出荷時の初期設定は無効です。詳細は、「３．１

RAS機能設定コマンド（rasconfig）」を参照してください。
・この機能によりシャットダウンを行った場合は、OSシャットダウン後に自動的に電源断を行います。
・高温異常検出を通知するRASイベントを使用して、ユーザアプリケーションからシャット
ダウンすることもできます。RASイベントについては、「４．２

RASイベント情報管理機能」を参照してください。

留意事項
・筐体内温度が高いと、熱による部品の極端な劣化が考えられるため、そのままこの装置を稼働状態にすることは機器の寿命の観点からも好ましくありません。しかし、ファン異常が発生していない状態での高温異常は、装置設置場所のエアコンの故障など外部要因によるものと考えられるため、稼働状態のまま高温異常の原因を取り除くことが可能です。このため、装置出荷時における初期設定は無効になっています。
・高温異常発生後もこの装置を稼働状態のままとして筐体内温度が危険なほど高温になってしまった場合は、システムの暴走や部品の破壊を防ぐため、この機能の設定に関わらず強制的にOSシャットダウンを実施して電源断します。

５．１．３

リモートシャットダウン入力検出による自動シャットダウン
この装置のRAS外部接点インタフェースにおけるリモートシャットダウン接点（RMTSHTDN接点）がクローズしたときに、自動でシャットダウンします。この機能により、離れた場所からリモートでこの装置をシャットダウンすることができます。
・この機能は、rasconfigコマンドで有効／無効を設定することができます。装置出荷時の初期設定は有効です。詳細は、「３．１

RAS機能設定コマンド（rasconfig）」を参照してください。
・この機能によりシャットダウンを行った場合は、OSシャットダウン後に自動的に電源断を行います。
・リモートシャットダウン入力検出を通知するRASイベントを使用して、ユーザアプリケー
ションからシャットダウンすることもできます。RASイベントについては、「４．２
RASイベント情報管理機能」を参照してください。

5-3

第５章

ハードウェアの制御

５．２

RASライブラリによる制御
RASライブラリ関数を使用することにより、ウォッチドッグタイマ、汎用外部接点や状態表示デジ
タルLEDを制御することができます。ライブラリ関数の詳細については、「６．１

RASライブラリ

インタフェース」を参照してください。

●

ウォッチドッグタイマの制御…WdtControl関数●

汎用外部接点出力の制御…GendoControl関数●

汎用外部接点入力の制御…GetGendi関数●

状態表示デジタルLEDの制御…SetStCode7seg関数、TurnOff7seg関数、SetMode7seg関数●

RAS機能が管理している装置状態の取得…GetRasStat関数●

RASイベント情報の取得…WaitForRasEvent関数

5-4

第５章

５．３

ハードウェアの制御

RAIDドライブ切離しコマンド（rasraidctl OFFLINE）＜名称＞
rasraidctl OFFLINE － RAIDを構成するドライブの切離し＜形式＞
rasraidctl OFFLINE [-q]<DRIVEx>＜実行権限＞
本コマンドは、root 権限でのみ実行可能です。

＜機能＞DRIVExパラメータで指定された片方のドライブをRAIDから強制的に切離します。（Offline状態にします）
コマンドを実行すると、下記のメッセージを表示し、ドライブの切り離し処理を続行するかどうかを問合せます。ここで [y] を入力した場合はドライブの切り離し処理を続行し、 [n] を入力した
場合はドライブの切り離し処理を中断します。

DRIVEx will be made offline.
Are you sure you want to continue with this process ? ( y / n ):ドライブが正常状態であっても、内部状態に(リトライ処理中等)により切り離されない事があります。その場合は、コマンドを再実行してください。

＜オプション＞[-q]オプションを指定した場合、問合せを行わずにDRIVEの切離しを実施します。
<DRIVEx>オプションは下記のとおり
DRIVE1： DRIVE1 の切離しを行う

DRIVE2： DRIVE2 の切離しを行う＜診断＞
処理が正常に終了した場合、exitステータス０を返します。異常終了した場合は、exitステータス０
以外を返します。

5-5

第５章

ハードウェアの制御＜エラーメッセージ＞

表５－１

エラーメッセージ

No
1

rasraidctl OFFLINE コマンドのエラーメッセージ一覧
内容
オプションの指定に誤りがあります。

Usage: rasraidctl [-q] OFFLINE <DRIVE1|DRIVE2 >rasraidctl MEDIAERRORALARM [ON|OFF]

root権限のないユーザにて実行されています。

2

Access denied. errno=(xx)3

ERROR: an error occurred while processing <xx>. errno=(yy),4

RAID condition is not OPTIMAL. stat=(xx)5RAID condition is TASK running. task=(xx)6Specified DRIVE is already OFFLINE

7

Specified DRIVE is not valid. stat=(xx)※xx＝エラー番号
予期せぬエラー(yy)が関数<xx>で発生しました。

※xx=関数名、yy=エラー番号

RAID状態が正常(Optimal)ではありません。
※xx＝RAID状態番号
実行中のタスクがあります。
※xx=実行中タスク番号
指定DRIVEが既にオフライン状態です。
指定DRIVEがオンラインまたはオフライン
状態以外です。

※xx=DRIVE状態＜使用例＞#
以外を返します。
## rasraidctl OFFLINE DRIVE2
DRIVE2will be made offline.
＜エラーメッセージ＞
Are you
sure you want to continue with this process ? ( y / n ):yなし#### rasraidctl -q OFFLINE DRIVE2##

DRIVE2の切離しDRIVE2の切離し

5-6

第５章

５．４

ハードウェアの制御

メディアエラー時ALARM点灯設定コマンド（rasraidctl MEDIAERRORALARM）＜名称＞
rasraidctl MEDIAERRORALARM － メディアエラー時のALARM点灯設定＜形式＞
rasraidctl MEDIAERRORALARM [ON | OFF]

＜実行権限＞
本コマンドは、root 権限でのみ実行可能です。

＜機能＞
MEDIAERRORALARMオプションは、メディアエラーが発生した場合に、
ALARM点灯する／しないの設定を行うコマンドオプションです。
装置出荷時の初期設定は、[OFF]ALARM点灯しないです。
ALARM点灯する設定の場合、メディアエラー発生時にALARMランプ点灯（MCALL接点
クローズ）、状態表示LED表示となり、ALARM点灯しない場合、ALARMランプ消灯（MCALL接点オープン）、状態表示LED消去となります。
引数無しで実行した場合、現在の設定情報を表示します。

＜オプション＞[ON | OFF] オプションは下記となります。
ON：

メディアエラー時、ALARM 点灯する。

OFF：

メディアエラー時、ALARM 点灯しない。

なし：

設定情報を表示する。

＜診断＞
処理が正常に終了した場合、exitステータス０を返します。異常終了した場合は、exitステータス０
以外を返します。

5-7

第５章

ハードウェアの制御＜エラーメッセージ＞
表５－２

エラーメッセージ

No
1

rasraidctl MEDIAERRORALARM コマンドのエラーメッセージ一覧
内容
オプションの指定に誤りがあります。

Usage: rasraidctl [-q] OFFLINE <DRIVE1|DRIVE2 >rasraidctl MEDIAERRORALARM [ON|OFF]

2
3
4

root権限のないユーザにて実行されています。

Access denied. errno=(xx)※xx＝エラー番号

ERROR: an error occurred while processing <xx>.

予期せぬエラー(yy)が関数<xx>で発生しました。

errno=(yy),※xx=関数名、yy=エラー番号

ERROR: an error occurred while processing

RAS機能が動作していません。

<GetRasRunMode>. mode=(xx)※xx＝RAS機能動作モード番号

＜使用例＞
#
#
# rasraidctl

メディアエラー時、ALARM点灯する

MEDIAERRORALARM ON

設定に変更します。

Setting was changed to ON#### rasraidctl MEDIAERRORALARM OFF

メディアエラー時、ALARM点灯しない設定に変更します。

Setting was changed to OFF.
### rasraidctl MEDIAERRORALARM
MEDIA ERROR Alarm Display Setting : ON#

メディアエラー時、ALARM点灯する／
しないの設定情報を表示します。

5-8

第６章

ライブラリ関数

第６章 ライブラリ関数
ユーザアプリケーションからRASライブラリを使用することで、この装置のハードウェアの状態を取得および制御することができます。
なお、この章で記載しているRAS外部接点インタフェース（オプション）のハードウェア仕様や各接点の意味については、「HF-W7500/LXモデル50 取扱説明書」の「５．９．１「５．９．２６．１

コネクタ仕様」および外部接点仕様」を参照してください。

RASライブラリインタフェース

６．１．１

概要
この章では、RASライブラリが提供する関数のインタフェースについて説明します。
表６－２にRASライブラリ関数の一覧を示します。
以下に示す関数は、RASライブラリ(libRASUTL.so)にて提供され、C言語/C++言語プログラ
ムで使用できます。また、本ライブラリ用のヘッダファイル(rasctl.h)を提供します。
表６－１

RASライブラリ提供ファイル一覧

項目

ファイルパス

ヘッダファイル/usr/include/rasutl/rasctl.h

共用ライブラリ/usr/lib64/libRASUTL.so

表６－２
No

備考

64bitアプリケーション用ライブラリRASライブラリ提供関数一覧

関数名称

機能

1

GendoControl

汎用外部接点出力（GENDO0, GENDO1, GENDO2）のオープンやクローズを行います。

2

GetGendi

汎用外部接点入力（GENDI, GENDI0, GENDI1, GENDI2）の状態を取得します。

3

SetStCode7seg

状態表示デジタルLEDにアプリケーションステータスコードを表示します。

4

TurnOff7seg

状態表示デジタルLEDのアプリケーションステータスコードを非表示にします。

5

SetMode7seg

状態表示デジタルLEDのステータス表示モードを設定します。

6

WdtControl

ウォッチドッグタイマのリトリガ・状態取得を行います。

7

GetRasStat

RAS機能が管理している装置状態の取得を行ないます。

8

WaitForRasEvent

RASイベント情報の取得を行います。

6-1

第６章

ライブラリ関数

６．１．２

RAS汎用接点の出力制御関数（GendoControl）
RAS外部接点インタフェースの汎用外部接点への出力をGendoControl関数で制御します。

（１）関数インタフェース（GendoControl）＜名前＞
GendoControl－

汎用接点出力信号(GENDO0/GENDO1/GENDO2)の信号状態制御＜書式＞#include <rasutl/rasctl.h>
int GendoControl( int nPort, int nCmd );＜説明＞
GendoControlはRAS外部接点インタフェースの汎用接点出力信号の信号状態を制御する関数で、nPort
で指定した汎用接点出力信号を、nCmdで指定した信号状態にします。
この関数を呼び出したときに、対象出力信号が既にnCmdで指定した信号状態となっている場合(「オープン」状態の汎用接点出力信号に「RAS_GENDO_OPEN」を指定した場合等)、この関数からは処理正常が返ります。

＜オプション＞[nPort]オプションは下記となります。
RAS_GENDO0_PORT： 汎用接点出力信号(GENDO0)を操作します。

RAS_GENDO1_PORT： 汎用接点出力信号(GENDO1)を操作します。

RAS_GENDO2_PORT： 汎用接点出力信号(GENDO2)を操作します。

[nCmd]オプションは下記となります。
RAS_GENDO_OPEN： nPortで指定した汎用接点出力信号の信号状態をオープン状態にします。

RAS_GENDO_CLOSE： nPortで指定した汎用接点出力信号の信号状態をクローズ状態
にします。

＜戻り値＞
処理が正常に終了した場合は、0が返ります。エラーが発生した場合は-1が返り、errnoに下記＜エラー＞の値が設定されます。

＜エラー＞
EINVAL：

引数(nPort、nCmd)の指定に誤りがあります。

EACCES：RAS ソフトウェアの起動が完了していません。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールでエラーが発生しました。

6-2

第６章

ライブラリ関数（２）RAS外部接点インタフェースの汎用外部接点（GENDO0 /GENDO1 /GENDO2）の動作
これらの汎用外部接点は、電源ONと電源OFF時はオープン状態です。
図６－１にGendoControl関数を使用したときのGENDO0接点の動作を示します。

電源OFF

接点オープン

接点クローズ
電源ON
GendoControl関数実行(GENDO_CLOSE)

時刻→
GendoControl関数実行(GENDO_OPEN)

図６－１

GendoControl関数実行(GENDO_CLOSE)GENDO接点の動作

なお、図６－１の点線は当該接点の各状態を、太線は当該接点の状態の遷移を示します。
この項の説明は、RAS外部接点インタフェースのHJ-F7550-17とHJ-F7550-18で共通です。

※RAS外部接点インタフェースの汎用外部接点（GENDI,GENDI0,GENDI1,GENDI2）のオープン／ク
ローズ状態は、「図６－１

GENDO接点の動作」と同様です。

6-3

第６章

ライブラリ関数

６．１．３

RAS汎用接点の信号入力状態取得関数（GetGendi）
RAS外部接点インタフェースの汎用外部接点への入力状態をGetGendi関数で取得します。

（１）関数インタフェース（GetGendi）＜名前＞
GetGendi－

汎用接点入力信号(GENDI/GENDI0/GENDI1/GENDI2)の信号状態取得＜書式＞#include <rasutl/rasctl.h>
int GetGendi( int nPort );＜説明＞
GetGendi()はRAS外部接点インターフェースの汎用接点入力信号の信号状態を取得する関数で、nPort
で指定した汎用接点入力信号の信号状態を取得します。
GENDIの信号状態を取得する場合には、RAS機能設定コマンドの設定項目「リモートシャットダウン
入力時の自動シャットダウン実施」を「off(自動シャットダウンを実施しない)」に設定してください。これ以外の設定を行っている状態でこの関数を呼び出した場合には、エラーが返ります。

＜オプション＞[nPort]オプションは下記となります。
RAS_GENDI_PORT： 汎用接点入力信号(GENDI)の信号状態を取得します。

RAS_GENDI0_PORT： 汎用接点入力信号(GENDI0)の信号状態を取得します。

RAS_GENDI1_PORT： 汎用接点入力信号(GENDI1)の信号状態を取得します。

RAS_GENDI2_PORT： 汎用接点入力信号(GENDI2)の信号状態を取得します。

＜戻り値＞
処理が正常に終了した場合は、下記の値が返ります。エラーが発生した場合は-1が返り、errnoに下記＜エラー＞の値が設定されます。
RAS_GENDI_OPEN： nPortで指定した汎用接点入力信号はオープン状態です。

RAS_GENDI_CLOSE： nPortで指定した汎用接点入力信号はクローズ状態です。

＜エラー＞
EINVAL：

引数(nPort)の指定に誤りがあります。

EACCES：RAS ソフトウェアの起動が完了していません。

EBUSY

：

リモートシャットダウン入力時の自動シャットダウン機能を「On」設定にしているため GENDI の信号状態を取得できません。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールでエラーが発生しました。

※RAS外部接点インタフェースの汎用外部接点（GENDI,GENDI0,GENDI1,GENDI2）のオープン／
クローズ状態は、「図６－１

GENDO接点の動作」と同様です。

6-4

第６章

ライブラリ関数

６．１．４ 状態表示デジタルLED制御関数（SetStCode7seg 、TurnOff7seg、SetMode7seg）（１）アプリケーションステータスコード表示関数（SetStCode7seg）＜名前＞
SetStCode7seg－

状態表示デジタルLEDにアプリケーションステータスコードを表示＜書式＞#include <rasutl/rasctl.h>
int SetStCode7seg( int nStCode )＜説明＞
SetStCode7segは、状態表示デジタルLEDにアプリケーションステータスコードを表示します。
状態表示デジタルLEDには、nStCodeで指定した値が16進数で表示されます。

＜オプション＞[nStCode]オプションは下記となります。
0x00 ～ 0xFF

： 表示するアプリケーションステータスコードの値。

＜戻り値＞
成功した場合は0を返します。エラーならば-1を返し、errnoにエラーを設定します。

＜エラー＞
EINVAL：指定された nStCode の値が範囲外です。

EACCES：RAS 機能が完全に起動されない（OFFLINE）状態です。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

6-5

第６章

ライブラリ関数（２）アプリケーションステータスコード非表示関数（TurnOff7seg）＜名前＞
TurnOff7seg－

状態表示デジタルLEDに表示されたアプリケーションステータスコードを非表示＜書式＞#include <rasutl/rasctl.h>
int TurnOff7seg( void )＜説明＞
TurnOff7segは、状態表示デジタルLEDに表示されているアプリケーションステータスコードを非表示にします。本関数ではアプリケーションステータスコードの非表示を行うことができますが、RASス
テータスコードを非表示にすることはできません。

＜オプション＞
なし。

＜戻り値＞
成功した場合は0を返します。エラーならば-1を返し、errnoにエラーを設定します。

＜エラー＞
EACCES：RAS 機能が完全に起動されない（OFFLINE）状態です。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

6-6

第６章

ライブラリ関数（３）ステータス表示モード設定関数（SetMode7seg）＜名前＞
SetMode7seg－

ステータス表示モード設定＜書式＞#include <rasutl/rasctl.h>
int SetMode7seg( int nMode )＜説明＞
SetMode7seg()は、状態表示デジタルLEDのステータス表示モードを設定する関数です。
ステータス表示モードを設定するためには、呼び出し元プロセスに適切な権限(CAP_SYS_ADMIN)が必要となります。この関数を呼び出したときに、ステータス表示モードが既にnModeで指定した設定となっている場合(「ハードウェアステータス表示モード」設定状態で「RAS_RASST_MODE」を指定した場合等)、この関数からは処理正常が返ります。

＜オプション＞[nMode]オプションは下記となります。
RAS_APPST_MODE： アプリケーションステータス表示モードに設定します。
(ハードウェア異常が発生した場合にステータスコードを表示しません。)

RAS_RASST_MODE： ハードウェアステータス表示モードに設定します。

＜戻り値＞
成功した場合は0を返します。エラーならば-1を返し、errnoにエラーを設定します。

＜エラー＞
EINVAL：

引数(nMode)の指定に誤りがあります。

EACCES：RAS 機能が完全に起動されない（OFFLINE）状態です。

EPERM

：

呼び出し元プロセスに必要な権限がありません。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

留意事項
本関数では、ステータスコードを非表示にすることはできません。

6-7

第６章

ライブラリ関数

６．１．５ ウォッチドッグタイマ制御関数（WdtControl）（１）関数インタフェース＜名称＞
WdtControl － ウォッチドッグタイマの制御／状態取得＜書式＞#include <rasutl/rasctl.h>
int WdtControl( int nCmd, int* pnCount )＜説明＞
この関数は、nCmdで指定した処理をHF-W7500/LXモデル50のウォッチドッグタイマに対して行います。
この関数を使用する場合は、RAS機能設定コマンド (rasconfig) の「ウォッチドッグタイマ機能」の設定を「app（ユーザアプリの動作状態監視）」に設定する必要があります。
これ以外のウォッチドッグタイマ設定の場合、この関数はエラーを返します。

＜オプション＞[nCmd]オプションは下記となります。
： ウォッチドッグタイマのタイムアウト時間(秒)を設定し、タイム

RAS_WDT_CMD_SET

アウト監視を開始します。（タイムアウト監視はワンショットの為、リトリガも本オプションを使用して行います。）
RAS_WDT_CMD_STAT： ウォッチドッグタイマの状態を取得します。

RAS_WDT_CMD_STOP： ウォッチドッグタイマのタイムアウト監視を停止します。

[pnCount]オプションは下記となります。なお、オプション内容は nCmd の指定内容で異なります。
・ nCmd が RAS_WDT_CMD_SET の場合： ウォッチドッグタイマのタイムアウト時間。秒単位。

1～63・ nCmd が RAS_WDT_CMD_STAT の場合(関数内で情報セット) ： この関数を発行した時点でのウォッチドッグタイマのタイムアウト
発生までの残り時間(秒)が格納されます。0 が格納されていた場
合、ウォッチドッグタイマのタイムアウトが発生していることを示します。
・ nCmd が RAS_WDT_CMD_STOP の場合： 本引数は使用されません。

(未使用)

＜戻り値＞
成功した場合は0を返します。エラーならば-1を返し、errnoにエラーを設定します。

＜エラー＞
EINVAL：指定された nCmd の値が範囲外、pnCount の値が不適切。

EACCES：RAS機能が完全に起動されない（OFFLINE）状態です。

EPERM

：

ウォッチドッグタイマ機能の動作モードが「app」以外。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

6-8

第６章

ライブラリ関数（２）RAS外部接点インタフェースのWDTTO接点の動作
この項では、以下の各状態について、RAS外部接点インタフェースのWDTTO接点の動作を説明します。

●

装置起動時の状態
WDTTO接点はクローズ状態です。

●

OS起動時の状態
OS起動時、WDTTO接点はクローズ状態です。ウォッチドッグタイマ自動リトリガ機能またはWdtControl関数によってウォッチドッグタイマがリトリガされるとWDTTO接点はオープン状
態になります。

●

WdtContol関数発行時の状態
nCmd がRAS_WDT_CMD_SET の場合：
WDTTO接点はオープン状態になります。その後、設定したタイムアウト時間内にウォッチ
ドッグタイマをリトリガしなかった場合は接点がクローズ状態になります。WDTTO接点がクローズ状態のときにウォッチドッグタイマをリトリガすると、WDTTO接点はオープン状
態になります。
nCmd がRAS_WDT_CMD_STOP の場合：
WDTTO接点はオープン状態になります。この場合、ウォッチドッグタイマはカウントダウ
ンを停止していますので、タイムアウト状態は発生しません。

●

ウォッチドッグタイマ自動リトリガ機能使用時の状態
WDTTO接点はオープン状態になります。この機能を実行するプロセスは最低レベル（アイドル優先度）で動作しているため、アイドル優先度以外の優先度のプロセスがCPUを占有している期間が設定値を超えた場合、ウォッチドッグタイマタイムアウトが発生します。このとき、接点はクローズ状態になります。その後、CPUの占有状態が解除されてこの機能を実行するプ
ロセスが動作可能になると、ウォッチドッグタイマは再びリトリガされるので、WDTTO接点
はオープン状態になります。

図６－２にアプリケーションがWdtControl関数を使用してウォッチドッグタイマを制御するときの
WDTTO接点の動作例を示します。このときWdtControl関数で指定するウォッチドッグタイマのタ
イムアウト時間は10秒とします。

6-9

第６章

ライブラリ関数

電源ON

WDTリトリガ
WdtControl関数実行（タイムアウト10秒）

電源OFF

WDTタイムアウト

接点オープン
（正常）
WDT停止状態
10秒
接点クローズ（WDTﾀｲﾑｱｳﾄ）

時刻→

WDTリトリガ
OS起動

WDT停止
WdtControl関数実行

WDTリトリガ

図６－２

WDTTO接点の動作

なお、図６－２の点線は当該接点の各状態を、太線は当該接点の状態の遷移を示します。

図６－３にOSシャットダウン時のWDTTO接点の動作例を示します。このとき、ウォッチドッグタ
イマのタイムアウト時間は60秒とします。ウォッチドッグタイマをリトリガするプロセスはシャッ
トダウン処理中に終了しますので、ウォッチドッグタイマタイムアウトが発生します。

WDTリトリガOSｼｬｯﾄﾀﾞｳﾝ開始

WDTタイムアウト

電源OFF

接点オープン（正常）60秒
接点クローズ（WDTﾀｲﾑｱｳﾄ）

時刻→

WDTリトリガ
WDTリトリガ

図６－３

WDTTO接点の動作（シャットダウン時）

なお、図６－３の点線は当該接点の各状態を、太線は当該接点の状態の遷移を示します。

留意事項
ここでは、RAS外部接点インタフェースがHJ-F7550-17の場合について説明しました。RAS外部接点インタフェースがHJ-F7550-18の場合は接点の動作が逆であり、上記説明での接点オープ
ンが接点クローズに、接点クローズが接点オープンになります。

6-10

第６章

６．１．６

ライブラリ関数RAS状態取得関数（GetRasStat）＜名前＞
GetRasStat －RAS機能が管理している装置状態を取得＜書式＞#include <rasutl/rasctl.h>
int GetRasStat( struct T_RAS_STAT * ptRasStat )＜説明＞
GetRasStat は、この関数を発行した時点での装置状態が格納された情報を返します。
取得できる状態は、ハードウェア監視機能で監視を行っている監視対象部位の状態（ファン状態、
筐体内温度状態、RAID状態、ドライブ状態、メモリ状態など）となります。

＜オプション＞[ptRasStat]オプションは下記となります。
（関数内で情報セット）： 装置状態情報を格納する領域。関数リターン後、この領域に装置状態情報がセットされています。
格納情報の詳細は＜格納情報詳細＞を参照ください。

＜戻り値＞
成功した場合は0を返します。エラーならば-1を返し、errnoに適切に設定します。

＜エラー＞
EINVAL：指定されたptRasStatのアドレスが無効なアドレスです。

EACCES：RAS機能が完全に起動されない（OFFLINE）状態です。

E＊＊＊

：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

6-11

第６章

ライブラリ関数＜格納情報詳細＞①RAS状態を格納する構造体を下記に示します。
typedef struct _T_RAS_STAT{// -------------------------------intnRasMode;
intnReserved1[2];// -------------------------------intnCountOfFan;
struct {int
nFanStat;} tFAN[4];// -------------------------------intnCountOfTemp;
struct {int
nTempStat;
int
nTempValue;} tTEMP[2];// -------------------------------intnCountOfMem;
struct {int
nMemStat;} tMEM[4];// -------------------------------intnCountOfRaid;
struct {intnRaidStat;intnRaidTask;
intnTaskProgress;} tRAID[2];// -------------------------------intnCountOfDrive;
struct {int
nDriveStat;
int
nUsedTime;} tDRIVE[6];} T_RAS_STAT;: RASソフトウェア動作モード[RAS_STS_MODE_***]: 予備: 監視対象ファン数: ファン状態[RAS_STS_FAN_***]: (16byte): 監視対象温度部位数: 温度状態[RAS_STS_TEMP_***]: 温度値(℃): (16byte): 監視対象メモリ数: メモリ状態[RAS_STS_MEM_***]: (16byte): 監視対象RAIDアレイ数: RAIDアレイ状態[RAS_STS_RAID_***]+メディアエラー有無: 実行中RAIDタスク種別[RAS_STS_RAID_TASK_***]: RAIDタスク進捗率(%): (24byte): 監視対象ドライブ数: ドライブ状態[RAS_STS_DRIVE_***]+SMART/使用時間超過有無: ドライブ使用時間(時間): (48byte)

6-12

第６章

ライブラリ関数②構造体メンバの格納値を表６－３に示します。
表６－３

GetRasStat 構造体メンバ一覧(1/3)
メンバ変数格納情報

構造体メンバ変数
No

メンバ変数名

変数型

説明

格納値(define値)(RAS_STS_MOD

RASソフト1

nRasMode－

int

0x5002

通常モード

E_ONLINE)

ウェア動作
モード

説明

(RAS_STS_MODE

0x5003

障害シミュレーションモード

_SIMULATION)

2nCountOfFan－tFAN[0]：フロントファン2

監視対象
int

3

ファン数

－

tFAN[1]：電源ファン
tFAN[2]：フロントファン1(RAS_STS_FAN_
0x5101
3tFAN[i]nFanStatint

ファン状態[正常]NORMAL)

ファン状態(RAS_STS_FAN_
0x5102

ファン状態[異常]ERROR)
監視対象温4

nCountOfTemp

－

int

1

度部位数

－
(RAS_STS_TEM

0x5111
P_NORMAL)
nTempStat
5

int

温度状態

(RAS_STS_TEM
0x5112tTEMP[0]：筐体内温度

温度状態[正常]温度状態[異常]

P_ERROR)tTEMP[i](RAS_STS_TEM
0x5113温度状態[高温異常]

P_DANGER)
nTempValueint

温度値(℃)

0～100－

温度値(単位：℃)
tMEM[0]：DIMMA1(*1)

6nCountOfMem

－

監視対象
int

4

メモリ数

－

tMEM[1]：DIMMA2tMEM[2]：DIMMB1(*1)
tMEM[3]：DIMMB2(RAS_STS_MEM
0x5401_NORMAL)(RAS_STS_MEM
7tMEM[i]nMemStat

int

メモリ状態

0x5402_ERROR)

メモリ状態[ビットエラー訂正頻度正常]

メモリ状態[ビットエラー訂正頻度異常](RAS_STS_MEM
0x5403_NOTMOUNTED

メモリ状態[メモリ未実装])
8nCountOfRaid－

監視対象RAID
int

1

アレイ数

6-13

－

tRAID[0]：RAIDアレイ1

第６章

ライブラリ関数

表６－３

GetRasStat 構造体メンバ一覧(2/3)
メンバ変数格納情報

構造体メンバ変数
No

メンバ変数名

変数型

説明

格納値(define値)

説明(RAS_STS_RAID
0x5201

RAIDアレイ状態[正常]_OPTIMAL)(RAS_STS_RAID

0x5203_DEGRADE)

RAIDアレイ状態[縮退状態](RAS_STS_RAID
RAIDアレイnRaidStat

int

0x5204

RAIDアレイ状態[異常(復旧不可)] (*2)
_FAIL)

状態(RAS_STS_RAID
0x5209RAIDアレイ状態[不明]_UNKNOWN)(RAS_STS_RAID

0x10000
9tRAID[i]_MEDIAERR_DE

RAIDアレイ状態[メディアエラー検出](*3)

TECTED)(RAS_STS_RAID
0x5211RAIDタスク状態[実行中タスクなし]_TASK_NONE)(RAS_STS_RAID

実行中RAID
nRaidTask

int

0x5212

タスク種別_TASK_REBUILRAIDタスク状態[リビルド中]D)(RAS_STS_RAID
0x5219_TASK_UNKNORAIDタスク状態[不明]

WN)
RAIDタスク
nTaskProgress

10

nCountOfDrive－int

進捗率(%)

0～100

RAIDタスク進捗率(単位：％)tDRIVE[0]：ドライブ1

監視対象
int

－

3

ドライブ数

－

tDRIVE[1]：ドライブ2
tDRIVE[2]：ドライブ3(*4)(RAS_STS_DRIV
0x5301

ドライブ状態[正常]E_ONLINE)(RAS_STS_DRIV
0x5302ドライブ状態[オフライン]

E_OFFLINE)(RAS_STS_DRIV

ドライブ
11

tDRIVE[i]nDriveStat

int

状態

0x5303

E_NOTCONNEC

ドライブ状態[未実装]

TED)(RAS_STS_DRIV
0x5304

ドライブ状態[リビルド中]

E_REBUILD)(RAS_STS_DRIV
0x5309
E_UNKNOWN)

6-14

ドライブ状態[不明]

第６章

表６－３

GetRasStat 構造体メンバ一覧(3/3)

構造体メンバ変数
No

メンバ変数名

変数型

ライブラリ関数

メンバ変数格納情報
説明

格納値(define値)(RAS_STS_DRIVE
0x10000

備考
説明

ドライブ状態_SMART_DETECT(*5)[SMART検出]

nDriveStat

int

ED)

ドライブ状態(RAS_STS_DRIVE
12tDRIVE[i]0x20000

ドライブ状態_OVERRUN_DETE(*6)[使用時間閾値超過検出]

CTED)
ドライブ使用nUsedTimeint

時間(hr)

0～99999－

ドライブ使用時間(単位：時間)ドライブ状態[正常]時有効情報(*1) DIMMA1およびDIMMB1は、常に「未実装(0x5403)」となります。
(*2) RAIDアレイ故障状態ではシステムが正常に動作できないため、本格納値に設定できない場合があります。
(*3) 本状態検出有無の検査はIS_RAS_RAID_MEDIAERR_DETECTED(nRaidStat)マクロで行えます。また、RAIDアレイ状態[0x52**]の抽出はGET_RAS_RAID_STATE(nRaidStat)マクロで行えます。
(*4) 本装置ではDRIVE3は実装していないため tDRIVE[2]：ドライブ3は定義のみになります。
(*5) 本状態検出有無の検査はIS_RAS_DRIVE_SMART_DETECTED(nDriveStat)マクロで行えます。また、ドライブ状態[0x53**]の抽出はGET_RAS_DRIVE_STATE(nDriveStat)マクロで行えます。
(*6) 本状態検出有無の検査は IS_RAS_DRIVE_OVERRUN_DETECTED(nDriveStat)マクロで行えます。ドライブ状態[0x53**]の抽出は上記マクロで行えます。

6-15

第６章

ライブラリ関数

６．１．７

RASイベント情報取得関数（WaitForRasEvent）＜名前＞
WaitForRasEvent－

RASイベント情報の取得＜書式＞#include <rasutl/rasctl.h>
int WaitForRasEvent ( struct T_RAS_EVENT * ptRasEvent );＜説明＞
WaitForRasEventは、RASイベント情報を取得する関数です。
本関数発行時点で未読のRASイベント情報がある場合、未読のイベント情報を取得することができます。（未読情報は、最大10件分が記録されています）
本関数発行時点で未読のRASイベント情報が無い場合、この関数はRASイベントが発生するまで
ユーザアプリケーションに処理を戻しません。
取得できる RAS 状態変化情報は、ハードウェア監視機能で監視を行っている監視対象部位の状態（ファン状態、温度状態、RAID 状態、ドライブ状態、メモリ状態など）となります。

＜オプション＞[ptRasEvent]オプションは下記となります。
(関数内で情報セット)： RAS イベント情報を格納する領域。
関数リターン後、この領域に RAS イベント情報がセットされています。
格納情報の詳細は＜格納情報詳細＞を参照ください。

＜戻り値＞
処理が正常に終了した場合は、0を返します。エラーが発生した場合は-1を返し、errnoにエラーを設定します。

＜エラー＞
EINVAL：指定された ptRasEvent のアドレスが無効なアドレス。

EINTR

：

シグナルを受信。

E＊＊＊：

ライブラリ関数内で使用しているシステムコールで発生したエラー内容です。

6-16

第６章

ライブラリ関数＜格納情報詳細＞① RASイベント情報を格納する構造体を下記に示します。
typedef struct _T_RAS_EVENT{
struct timevaltEvTime;int
nEvCode;int
nReserved1;
longnEvParam1;
longnEvParam2;
longnReserved2;} T_RAS_EVENT;： RASイベント発生時刻： RASイベントコード[RAS_EVT_***]： 予備エリア： 拡張情報1(RASイベントパラメータ1)： 拡張情報2(RASイベントパラメータ2)： 予備エリア② 構造体メンバの格納値を下記に示します。
表６－４
メンバ

No

WaitForRasEvent構造体メンバ一覧
格納値

説明

1

tEvTime(整数値)

RASイベント発生時刻(相対秒)2

nEvCodeRAS_EVT_***

RASイベントコード

3

nEvParam1

各イベント毎のパラメータ

4

nEvParam2

各イベント毎のパラメータ③ RASイベントコード毎のパラメータの格納値を下記に示す。
表６－５
RASイベント情報
No

発生

イベント内容部位

ファン状態[正常]検出1

パラメータ格納値(1/2)
RASイベント情報格納構造体メンバ格納値<nEvCode>格納値(define値)

0x6101<nEvParam2>

発生部位(ファン部位)－(RAS_EVT_FAN_NORMAL)
(*1)

ファン
ファン状態[異常]検出2<nEvParam1>

発生部位(ファン部位)
0x6102－(RAS_EVT_FAN_ERROR)
(*1)

3

4

温度

発生部位(温度部位)

温度状態[正常]検出

0x6111(RAS_EVT_TEMP_NORMAL)

温度状態[異常]検出

0x6112(RAS_EVT_TEMP_ERROR)

0x6113(RAS_EVT_TEMP_DANGER)

0x6201(RAS_EVT_RAID_OPTIMAL)

0x6203(RAS_EVT_RAID_DEGRADE)

0x6204(RAS_EVT_RAID_FAIL)

検出

検出
RAIDアレイ状態[縮退]

7

RAID

検出
RAIDアレイ状態[故障]8検出(*10)－(*2)
発生部位(温度部位)

RAIDアレイ状態[正常]6(*2)
発生部位(温度部位)

温度状態[高温異常]
5

－

6-17

－

(*2)
発生部位(RAIDアレイ

状態遷移前RAIDアレイ部位) (*3)状態(*8)

発生部位(RAIDアレイ

状態遷移前RAIDアレイ部位) (*3)状態(*8)

発生部位(RAIDアレイ

状態遷移前RAIDアレイ部位) (*3)状態(*8)

第６章

ライブラリ関数表６－５
RASイベント情報
No

発生
部位

パラメータ格納値(2/2)
RASイベント情報格納構造体メンバ格納値

イベント内容<nEvCode>格納値(define値)

RAIDアレイ状態[不明]9検出0x6209(RAS_EVT_RAID_UNKNOWN)

0x6222(RAS_EVT_RAID_MEDIAERR_ERROR)

0x6301(RAS_EVT_DRIVE_ONLINE)

0x6302(RAS_EVT_DRIVE_OFFLINE)

0x6303(RAS_EVT_DRIVE_NOTCONNECTED)

0x6304(RAS_EVT_DRIVE_REBUILD)

0x6309(RAS_EVT_DRIVE_UNKNOWN)

0x6312(RAS_EVT_DRIVE_SMART_ERROR)

0x6311(RAS_EVT_DRIVE_SMART_NORMAL)

0x6322(RAS_EVT_DRIVE_OVERRUN_ERROR)

RAID
発生検出
RAID構成ドライブ
11

状態[正常]検出
RAID構成ドライブ

12

状態[オフライン]検出
RAID構成ドライブ

13

状態[未実装]検出
RAID構成ドライブ

14

ドラ状態[リビルド中]検出

イブ

RAID構成ドライブ

15

状態[不明]検出
ドライブSMART検知

16

状態検出

状態回復

超過検出
ビットエラー訂正頻度

19

メモリ

(RAS_EVT_MEM_NORMAL)

0x6402(RAS_EVT_MEM_ERROR)

0x6801(RAS_EVT_RMTSHTDN)

0x6851(RAS_EVT_SHUT_RUNAUTOSHTDN)

0x6852(RAS_EVT_SHUT_RUNEMERGSHTDN)

ビットエラー訂正頻度21

接点

ダウン信号入信検出

23

RAS

開始

ソフト

緊急シャットダウン
開始－

アレイ部位)(*3)
発生部位(ドライブ

状態遷移前ドライブ部位)(*4)状態(*9)

発生部位(ドライブ

状態遷移前ドライブ部位)(*4)状態(*9)

発生部位(ドライブ

状態遷移前ドライブ部位)(*4)状態(*9)

発生部位(ドライブ

状態遷移前ドライブ部位)(*4)状態(*9)

発生部位(ドライブ

状態遷移前ドライブ部位)(*4)状態(*9)－

部位)(*4)－部位)(*4)発生部位(ドライブ

ドライブ使用時間部位)(*4)(hr)[100～20000]－

部位)(*5)－部位)(*5)

リモートシャット

自動シャットダウン
22

アレイ状態(*8)

発生部位(メモリ[異常]検出外部

アレイ部位)(*3)

発生部位(メモリ
0x6401[正常]検出20

状態遷移前RAID

発生部位(ドライブ

ドライブ使用時間閾値18

発生部位(RAID

発生部位(ドライブ

ドライブSMART検知
17<nEvParam2>

発生部位(RAID

RAIDメディアエラー
10<nEvParam1>－－

自動ｼｬｯﾄﾀﾞｳﾝ要因

ｼｬｯﾄﾀﾞｳﾝ開始までのｲﾍﾞﾝﾄ(*6)

遅延時間(秒)[0～120]

緊急ｼｬｯﾄﾀﾞｳﾝ要因－

ｲﾍﾞﾝﾄ(*7)(*1)発生部位(ファン部位)(*3)発生部位(RAIDアレイ部位)

0：フロントファン2

0：RAIDアレイ1(System)

1：電源ファン
2：フロントファン1(*4)発生部位(ドライブ部位)
0：ドライブ1(*2)発生部位(温度部位)

1：ドライブ2

0：筐体内温度2：ドライブ3(*12)(*12) 本装置では実装していないため定義のみになります。

6-18

第６章

(*5)発生部位(メモリ部位)
0：DIMMA1 (*10)
1：DIMMA2
2：DIMMB1 (*10)
3：DIMMB2(*10) 本装置では DIMMA1 および DIMMB1 は使用しません。

(*6)発生部位(自動ｼｬｯﾄﾀﾞｳﾝ要因ｲﾍﾞﾝﾄ)
0x6102(RAS_EVT_FAN_ERROR)
0x6112(RAS_EVT_TEMP_ERROR)
0x6113(RAS_EVT_TEMP_DANGER)(*7)発生部位(緊急ｼｬｯﾄﾀﾞｳﾝ要因ｲﾍﾞﾝﾄ)
0x6801(RAS_EVT_RMTSHTDN)(*8)状態遷移前RAIDアレイ状態
0x5201(RAS_STS_RAID_OPTIMAL)[正常]0x5203(RAS_STS_RAID_DEGRADE)[縮退]0x5204(RAS_STS_RAID_FAIL)[故障] (*11)
0x5209(RAS_STS_RAID_UNKNOWN)[不明](*11) RAID アレイ故障状態ではシステムが正常に動作できないため、本格納値に設定できない場合があります。

(*9)状態遷移前ドライブ状態
0x5301(RAS_STS_DRIVE_ONLINE)：[正常]

0x5302(RAS_STS_DRIVE_OFFLINE)：[オフライン]0x5303(RAS_STS_DRIVE_NOTCONNECTED)：[未実装]

0x5304(RAS_STS_DRIVE_REBUILD)：[リビルド中]

0x5309(RAS_STS_DRIVE_UNKNOWN)

：[不明]

6-19

ライブラリ関数

第６章

ライブラリ関数

６．１．８ サンプルプログラム

RASライブラリとして提供するライブラリ関数の使用方法を示したサンプルコードを提供しています。
下表に、提供するサンプルコードファイル一覧を記します。

表６－６
No

サンプルプログラム一覧

ファイル名称内容

1

gendo.c

GendoControl()関数の使用方法を示したサンプルコード

2

gendi.c

GetGendi()関数の使用方法を示したサンプルコード

3

7seg.c4

wdt.c

WdtControl()関数の使用方法を示したサンプルコード

5

rasstat.c

GetRasStat()関数の使用方法を示したサンプルコード

6

rasevent.c

WaitForRasEvent()関数の使用方法を示したサンプルコード

SetStCode7seg()/TurnOff7seg()/SetMode7seg()関数の使用方法を示したサンプ
ルコード

次ページ以降に記載するサンプルコードファイルは、下記RASソフトウェアディレクトリに同梱しています。
/usr/rasutl/examples
各サンプルコードファイルのファイル属性については、一般的なテキストファイル属性「所有者(root)、アクセス権限(0644)」とします。
各サンプルコードのコンパイル方法は、サンプルコードの先頭行に記述しています。

※サンプルプログラムに記載の「¥」コードは、Linux環境では「/」(バックスラッシュ)コードで表示
されます。

6-20

第６章

ライブラリ関数（１）gendo.c// cc -o gendo gendo.c -lRASUTL#include <stdio.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
int nPort= RAS_GENDO0_PORT;
int nCmd= RAS_GENDO_OPEN;/* set open GENDO0 */nPort = RAS_GENDO0_PORT;

nCmd = RAS_GENDO_OPEN;
nResult = GendoControl( nPort, nCmd );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed GendoControl(GENDO0,OPEN). errno=(%d)¥n", errno );return 1;}/* set close GENDO1 */nPort = RAS_GENDO1_PORT;
nCmd = RAS_GENDO_CLOSE;
nResult = GendoControl( nPort, nCmd );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed GendoControl(GENDO1,CLOSE). errno=(%d)¥n", errno );return 1;}
return 0;
}

6-21

第６章

ライブラリ関数（２）gendi.c// cc -o gendi gendi.c -lRASUTL#include <stdio.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
int nPort= RAS_GENDI0_PORT;/* get GENDI0 */nPort = RAS_GENDI0_PORT;
nResult = GetGendi( nPort );switch ( nResult ){case RAS_GENDI_OPEN:
fprintf( stdout, "GetGendi(): GENDI0 --> OPEN¥n" );break;
case RAS_GENDI_CLOSE:
fprintf( stdout, "GetGendi(): GENDI0 --> CLOSE¥n" );break;
default:
fprintf( stderr, "ERROR: failed GetGendi(GENDI0). rtn=(%d), errno=(%d)¥n", nResult, errno );return 1;}
return 0;
}

6-22

第６章

（３）7seg.c// cc -o 7seg 7seg.c -lRASUTL#include <stdio.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
int nMode= RAS_APPST_MODE;
int nStCode = 0x00;/* set mode */nMode = RAS_APPST_MODE;
nResult = SetMode7seg( nMode );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed SetMode7seg(APPSTMODE). errno=(%d)¥n", errno );return 1;}/* set 0xff */nStCode = 0xff;
nResult = SetStCode7seg( nStCode );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed SetStCode7seg(). errno=(%d)¥n", errno );return 1;}
sleep( 1 );/* turn off led */nResult = TurnOff7seg();if ( nResult == -1 ){fprintf( stderr, "ERROR: failed TurnOff7seg(). errno=(%d)¥n", errno );return 1;}
return 0;}

6-23

ライブラリ関数

第６章

ライブラリ関数（４）wdt.c// cc -o wdt wdt.c -lRASUTL#include <stdio.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
int nLoop= 0;
int nCmd= RAS_WDT_CMD_STOP;
int nCount = 0;/* set watchdog timer */for ( nLoop = 0; nLoop < 10; nLoop++ ){nCmd = RAS_WDT_CMD_SET;
nCount = 20;
nResult = WdtControl( nCmd, &nCount );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed WdtControl(SET). errno=(%d)¥n", errno );return 1;}
sleep( 5 );}/* get watchdog timer status */for ( nLoop = 0; nLoop < 5; nLoop++ ){nCmd = RAS_WDT_CMD_STAT;
nResult = WdtControl( nCmd, &nCount );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed WdtControl(STAT). errno=(%d)¥n", errno );return 1;}
fprintf( stdout, "WdtControl(STAT). Count = %d¥n", nCount );sleep( 5 );}/* stop watchdog timer */nCmd = RAS_WDT_CMD_STOP;
nResult = WdtControl( nCmd, NULL );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed WdtControl(STOP). errno=(%d)¥n", errno );return 1;}
return 0;
}

6-24

第６章

ライブラリ関数（５）rasstat.c// cc -o rasstat rasstat.c -lRASUTL#include <stdio.h>#include <string.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
int nIndex = 0;
T_RAS_STAT tRasStat;/* get RAS status */memset( &tRasStat, 0, sizeof( tRasStat ) );nResult = GetRasStat( &tRasStat );if ( nResult == -1 ){fprintf( stderr, "ERROR: failed GetRasStat(). errno=(%d)¥n", errno );return 1;}
fprintf( stdout, "RasMode= 0x%x(%s)¥n", tRasStat.nRasMode,( tRasStat.nRasMode == RAS_STS_MODE_ONLINE ) ? "Online" : "Simulation" );for ( nIndex = 0; nIndex < tRasStat.nCountOfFan; nIndex++ ){switch ( tRasStat.tFAN[nIndex].nFanStat ){case RAS_STS_FAN_NORMAL:
fprintf( stdout, "Fan[%d]= (Normal)¥n", nIndex );break;
case RAS_STS_FAN_ERROR:
fprintf( stdout, "Fan[%d]= (Error)¥n", nIndex );break;
default:
break;}}for ( nIndex = 0; nIndex < tRasStat.nCountOfTemp; nIndex++ ){switch ( tRasStat.tTEMP[nIndex].nTempStat ){case RAS_STS_TEMP_NORMAL:
fprintf( stdout, "Temp[%d]= (Normal)¥n", nIndex );break;
case RAS_STS_TEMP_ERROR:
fprintf( stdout, "Temp[%d]= (Error)¥n", nIndex );break;
case RAS_STS_TEMP_DANGER:
fprintf( stdout, "Temp[%d]= (Danger)¥n", nIndex );break;
default:
break;}
fprintf( stdout, "TempValue[%d] = %d¥n", nIndex, tRasStat.tTEMP[nIndex].nTempValue );}(次頁続く)

6-25

第６章

ライブラリ関数(前頁続き)for ( nIndex = 0; nIndex < tRasStat.nCountOfMem; nIndex++ ){switch ( tRasStat.tMEM[nIndex].nMemStat ){case RAS_STS_MEM_NORMAL:
fprintf( stdout, "Mem[%d]= (Normal)¥n", nIndex );break;
case RAS_STS_MEM_ERROR:
fprintf( stdout, "Mem[%d]= (Error)¥n", nIndex );break;
case RAS_STS_MEM_NOTMOUNTED:
fprintf( stdout, "Mem[%d]= (Not-Mounted)¥n", nIndex );break;
default:
break;}}for ( nIndex = 0; nIndex < tRasStat.nCountOfRaid; nIndex++ ){fprintf( stdout, "Raid[%d]= (Media error is %d)¥n", nIndex,
IS_RAS_RAID_MEDIAERR_DETECTED( tRasStat.tRAID[nIndex].nRaidStat ) );switch ( GET_RAS_RAID_STATE( tRasStat.tRAID[nIndex].nRaidStat ) ){case RAS_STS_RAID_OPTIMAL:
fprintf( stdout, "= (Optimal)¥n" );break;
case RAS_STS_RAID_DEGRADE:
fprintf( stdout, "= (Degrade)¥n" );break;
case RAS_STS_RAID_FAIL:
fprintf( stdout, "= (Fail)¥n" );break;
case RAS_STS_RAID_UNKNOWN:
fprintf( stdout, "= (Unknown)¥n" );break;
default:
break;}
switch ( tRasStat.tRAID[nIndex].nRaidTask ){case RAS_STS_RAID_TASK_NONE:
fprintf( stdout, "RaidTask[%d] = (None)¥n", nIndex );break;
case RAS_STS_RAID_TASK_REBUILD:
fprintf( stdout, "RaidTask[%d] = (Rebuild(%d%))¥n", nIndex,
tRasStat.tRAID[nIndex].nTaskProgress );break;
case RAS_STS_RAID_TASK_UNKNOWN:
fprintf( stdout, "RaidTask[%d] = (Unknown)¥n", nIndex );break;
default:
break;
}
}
(続く)

6-26

第６章

ライブラリ関数(前頁続き)for ( nIndex = 0; nIndex < tRasStat.nCountOfDrive; nIndex++ ){fprintf( stdout, "Drive[%d] = (Smart is %d)¥n", nIndex,
IS_RAS_DRIVE_SMART_DETECTED( tRasStat.tDRIVE[nIndex].nDriveStat ) );fprintf( stdout, "= (Overrun is %d)¥n",
IS_RAS_DRIVE_OVERRUN_DETECTED( tRasStat.tDRIVE[nIndex].nDriveStat ) );switch ( GET_RAS_DRIVE_STATE( tRasStat.tDRIVE[nIndex].nDriveStat ) ){case RAS_STS_DRIVE_ONLINE:
fprintf( stdout, "= (Online)¥n" );break;
case RAS_STS_DRIVE_OFFLINE:
fprintf( stdout, "= (Offline)¥n" );break;
case RAS_STS_DRIVE_NOTCONNECTED:
fprintf( stdout, "= (Not-Connected)¥n" );break;
case RAS_STS_DRIVE_REBUILD:
fprintf( stdout, "= (Rebuild)¥n" );break;
case RAS_STS_DRIVE_UNKNOWN:
fprintf( stdout, "= (Unknown)¥n" );break;
default:
break;}
fprintf( stdout, "UsedTime[%d] = %d¥n", nIndex, tRasStat.tDRIVE[nIndex].nUsedTime );}return 0;
}

6-27

第６章

ライブラリ関数（６）rasevent.c// cc -o rasevent rasevent.c -lRASUTL#include <stdio.h>#include <string.h>#include <time.h>#include <errno.h>#include <rasutl/rasctl.h>
int main( int argc, char** argv ){int nResult = 0;
struct tm* ptTime = NULL;
T_RAS_EVENT tRasEvent;/* get RAS event */while ( 1 ){memset( &tRasEvent, 0, sizeof( tRasEvent ) );nResult = WaitForRasEvent( &tRasEvent );if ( nResult == -1 ){if ( errno == EINTR ){continue;}fprintf( stderr, "ERROR: failed WaitForRasEvent(). errno=(%d)¥n", errno );return 1;}
ptTime = localtime( &tRasEvent.tEvTime.tv_sec );fprintf( stdout, "WaitForRasEvent(). ""[%04d/%02d/%02d %02d:%02d:%02d.%03d]:""event=[0x%x],param1=[0x%x],param2=[0x%x]¥n",(ptTime->tm_year+1900),(ptTime->tm_mon+1), ptTime->tm_mday, ptTime->tm_hour, ptTime->tm_min,
ptTime->tm_sec, (int)(tRasEvent.tEvTime.tv_usec/1000),tRasEvent.nEvCode, tRasEvent.nEvParam1, tRasEvent.nEvParam2 );fflush( stdout );}return 0;
}

6-28

第７章

保守・障害解析関連第７章 保守・障害解析関連
７．１

メモリダンプ機能

７．１．１ 概要
この装置では、OSフリーズからの強制回復やハードウェア要因NMI、訂正不可能なメモリ
エラーが発生した場合に、システムメモリの内容をメモリダンプファイルに記録（*1）、および障害初期調査・解析に利用する障害情報レポートを出力します。採取中は、筐体前面ランプが下記状態表示されます。（*2）
採取完了後は、装置は自動的に再起動して、筐体前面ランプの下記状態表示は消灯します。
（*3）● 筐体前面『ALARM』ランプ：「赤点灯」● 筐体前面『状態表示デジタルLED』 ：「80」● 筐体前面『状態識別LED』：「赤色／緑色／橙色

点灯」（*1）メモリダンプの採取には Red Hat Enterprise Linux 7 OS機能の kdump を使用しています。
kdump機能はメモリダンプ採取要因発生時、専用のカーネルを起動し、メモリダンプファ
イルを保存します。
（*2）筐体前面ランプが、上記状態または筐体前面『状態表示デジタルLED』が「8F」になっていない場合は、リセットスイッチを押下することにより、メモリダンプを採取できます。
詳細は「HF-W7500/LXモデル50 取扱説明書」の「８．２メモリダンプ採取機能」を参照してください。
メモリダンプ採取処理に掛かる時間は、メモリ容量が8GBの場合は約4分程度掛かります
が、システムの利用状況により前後する場合があります。
（*3）デフォルト設定の場合、採取完了後に装置は自動的に再起動します。
詳細は「HF-W7500/LXモデル50 取扱説明書」の「８．２メモリダンプ採取機能」を参照してください。

採取したメモリダンプファイル内容を解析することによって障害の原因を調査できます。
メモリダンプの解析が必要な場合は、「HF-W7500/LXモデル50取扱説明書 8.2メモリダン
プ採取機能」を参照し、DVD-R等に保存した後、弊社担当営業までご連絡ください。
なお、メモリダンプの解析は有償となります。

7-1

第７章

保守・障害解析関連

７．１．２ メモリダンプの採取要因
この機能は、表７－１の要因でメモリダンプが採取されます。
表７－１

メモリダンプを採取する要因一覧

要因

説明

Linux カーネル障害

Linuxカーネル内で重要エラーが発生したとき、メモリダンプが採取されます。

ハードウェア要因

ハードウェアに重障害（メモリマルチビットエラー、PCIバスパリティ

NMI

エラーなど）が発生したとき、NMI（Non Maskable Interrupt）が発生してメモリダンプが採取されます。

リセットスイッチ

筺体前面にあるリセットスイッチを押下した場合に、メモリダンプが採取されます。

RAS外部接点

RAS外部接点「RMTRESET」信号がクローズ（500ms以上）となった場合「RMTRESET」に、メモリダンプが採取されます。
(「HF-W7500/LXモデル50 取扱説明書

5.9.2 外部接点仕様」参照)

なお、メモリダンプが発生した場合の対応については、「HF-W7500/LXモデル50 取扱説明書」の「８．２

７．１．３

メモリダンプ採取機能」を参照ください。

メモリダンプファイル保存仕様
この機能が記録するメモリダンプファイル保存仕様を表７－２に示します。
このメモリダンプファイル保存結果はシステムログに記録されます。
表７－２

No

メモリダンプファイル保存仕様

項目

内容

1

メモリダンプ保存用ディレクトリ

/var/crash/dump(.N)（*1）

2

メモリダンプファイル名

vmcore（*2）

3

障害情報レポートファイル名

report（*2）

4メモリダンプファイル最大保存件数

2件（*1）最新はdump、１世代前はdump.1となります。
（*2）保存に失敗した場合は、ファイル名の末尾に「-incomplete」が付加されます。

7-2

第７章

７．２

保守・障害解析関連

ログファイル収集機能

７．２．１ 概要
ログファイル収集機能は、保守用のログファイルを収集する機能です。
OSの提供する sosreportコマンドにて収集することができます。
（７．２．４

７．２．２

ログファイル収集コマンド（sosreport）参照）

sosreportコマンド概要
sosreportコマンドは、システムに関する様々な情報をアーカイブファイルとして容易に一括収集できるツールです。以下のような情報を収集します。
詳細については、生成された圧縮ファイルを展開してご確認ください。
①sosreport オプションなし●

システムのハードウェア情報●

設定ファイル●

ログファイル●

コマンド実行時点のプロセス情報等②sosreport –o hfwraidlog●

RAIDログ③sosreport –o hfwsmartlog●

SMART属性値ログ

留意事項a) 情報取得時にはシステムに負荷が掛かります。
システム稼動が行われていない時間帯などを考慮のうえ、適切なタイミングで実行してください。
b) 情報取得には約5分程度の時間が掛かります。
ご使用環境により情報取得に時間が掛かる場合がありますのでシステム稼動の停止がある程度余裕をもって行える時間帯に実行してください。
c) 実行後、中断は行わないでください。（Ctrl + c等により）中断した場合は、正常に処理が終了しない場合があります。
d) 情報収集したファイルは、/var/tmp下に作成されます。約20MB程度のサイズになります。
e) できる限り多くのシステム情報を収集するため、取得情報の中にユーザ名、ホスト名、IP アドレス等が含まれます。
※ /etc/passwd、/etc/shadow ファイル等は含まれません。
※ 収集したファイル一覧は、下記コマンドで確認できます。
tar Jtf /var/tmp/ sosreport-*****-YYYYMMDDhhmmss.tar.xz(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )

7-3

第７章

保守・障害解析関連

７．２．３

sosreportコマンド使用方法
sosreportコマンドのオプション指定なしによる、システム情報の収集手順を記載します。
またオプション指定ありによる手順との差異を記載します。
sosreportコマンドを使用するには、root権限が必要です。root権限ユーザでログインしてから実行してください。

①

root権限ユーザでログインしてください。

②

sosreportコマンドを実行します。
# sosreport③

下記メッセージが順次表示されますので、それぞれでEnterキーを押します。
Press ENTER to continue, or CTRL-C to quit.
Please enter your first initial and last name [*****]:(***** = 装置のホスト名)

Please enter the case id that you are generating this report for []:④

下記メッセージが表示されますので、採取開始日を対話形式で入力します。
（例：2018年1月9日の場合は「2018-01-09」と入力します。）
採取開始日が誤っていた場合、下記メッセージを繰り返し表示します。
Please enter the date of failure (yyyy-mm-dd):（yyyy：西暦年、mm：月、dd：日）（*）「–o hfwraidlog」オプション指定では表示されません。
⑤④にて採取開始日が未入力の場合、下記メッセージを表示してコマンド実行日を採取開始日に設定します。よろしければ「y」を入力します。
「y」以外を入力した場合は、④に戻り再度、採取開始日を入力します。
Did a failure occur today or a failure day is not clear? then enter y:⑥y

下記表示があり情報収集が終了します。
/var/tmpディレクトリ下に sosreport-*****-YYYYMMDDhhmmss.tar.xz が作成されます。
(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )Your sosreport has been generated and saved in:/var/tmp/ sosreport-*****-YYYYMMDDhhmmss.tar.xz
The checksum is: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Please send this file to your support representative.

留意事項/var/tmpディレクトリ下に sosreport-*****-YYYYMMDDhhmmss.tar.xz が作成されます。
(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )障害発生時には必要に応じて上記ファイルをサポート窓口へ送付ください。

7-4

第７章

保守・障害解析関連

７．２．４ ログファイル収集コマンド（sosreport）＜名前＞
sosreport－

ログファイルを収集・圧縮して、格納＜書式＞[オプション]sosreport＜実行権限＞
本コマンドは、root権限ユーザでのみ実行可能です。

＜機能＞
sosreportは、ログファイルを収集および圧縮するコマンドです。
詳細ログ収集を行い、tar形式でアーカイブ化します。
すでに起動中の場合、新たに起動はできません。
オプションなしで実行し収集するログは、下記となります。
●

システムのハードウェア情報●

設定ファイル●

ログファイル●

コマンド実行時点のプロセス情報等

オプション指定ありで実行した場合、RAIDログ、SMART属性値ログを収集します。

＜オプション＞–o hfwraidlog：RAIDログを収集します。

※RAIDボードへのアクセスが高負荷となることから、システム運用中のRAIDログ収集は絶対に実施しないでください。
–o hfwsmartlog：SMART属性値ログを収集します。

※ドライブへのアクセスが高負荷となることから、システム運用中のSMART属性値ログ
収集は絶対に実施しないでください。

＜出力先＞
ログの収集時の一時ディレクトリは、/var/tmpディレクトリを使用します。
また、収集したログは、/var/tmpディレクトリに下記名称にて保存します。
sosreport-*****-YYYYMMDDhhmmss.tar.xz(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )

7-5

第７章

保守・障害解析関連＜診断＞
処理が正常に終了した場合、戻り値に0を返します。異常終了した場合は戻り値に１を返します。

＜エラーメッセージ＞
なし

＜使用例＞
#sosreportsosreport (version 3.4)
This command will collect diagnostic and configuration information fromthis Red Hat Enterprise Linux system and installed applications.
・・・
Press ENTER to continue, or CTRL-C to quit.

Enterキーを押す

Please enter your first initial and last name [*****]:
Please enter the case id that you are generating this report for []:Setting up archive ...
Setting up plugins ...
Please enter the date of failure (yyyy-mm-dd):
Did a failure occur today or a failure day is not clear? then enter y:Enterキーを押す

Running plugins. Please wait ...
Running 107/121: systemtap...
Running 121/121: yum...
Creating compressed archive...

...
...

Your sosreport has been generated and saved in:/var/tmp/ sosreport-*****-YYYYMMDDhhmmss.tar.xz

Enterキーを押す

y

採取日開始日を入力
してEnterキーを押す。
採取開始日が未入力の場合、コマンド実
行日を採取開始日に設定します。
この場合、確認のメッセージを表示するので、よければ[y]を入力する。
[y]以外を入力した場倍、再度採取日開始
日の入力になります。

The checksum is: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Please send this file to your support representative.
#

留意事項/var/tmpディレクトリ下に sosreport-*****-YYYYMMDDhhmmss.tar.xz が作成されます。
(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )障害発生時には必要に応じて上記ファイルをサポート窓口へ送付ください。

7-6

第７章

７．３

保守・障害解析関連

保守操作支援コマンド

保守操作支援コマンドの使用方法について説明します。これらのコマンドは装置でトラブルが発生したときや予防保全作業をするときに使用します。
表７－３に保守操作支援コマンドの一覧を示します。

表７－３

保守操作支援コマンド一覧

コマンド名

機能

raslogpt

RASイベントログの表示

rasconfig

RAS機能の設定情報表示／設定（*1）

rasstat

RAS機能が管理している装置状態の表示（*2）

sosreport

ログファイルを収集・圧縮して格納（*3）

rasraidctl OFFLINERAIDを構成するドライブの切離し（*4）

rasraidctl MEDIAERRORALARM

メディアエラー時のALARM点灯設定（*5）
RAS障害シミュレーションモードの開始／停止、

rassimtool

装置異常の模擬（*6）（*1）「３．１ RAS機能設定コマンド（rasconfig）」を参照ください。
（*2）「４．１．１ RAS状態表示コマンド（rasstat）」を参照ください。
（*3）「７．２．４

ログファイル収集コマンド（sosreport）」を参照ください。

（*4）「５．３

RAIDドライブ切離しコマンド（rasraidctl OFFLINE）」を参照ください。

（*5）「５．４

メディアエラー時ALARM点灯設定コマンド（rasraidctl MEDIAERRORALARM）」を参照ください。
（*6）「８．１．３ RAS障害シミュレーションコマンド（rassimtool）」を参照ください。

7-7

第７章

保守・障害解析関連

７．３．１

RASイベントログ表示コマンド（raslogpt）＜名前＞
raslogpt － RASイベントログの表示＜書式＞
raglogpt＜実行権限＞
本コマンドは、全ユーザで実行可能です。

＜機能＞
raslogptは、RASイベントログを表示するためのコマンドです。
RASイベントログファイルに含まれる全てのログ情報を表示します。

＜オプション＞
なし＜診断＞
処理が正常に終了した場合、exitステータス0を返します。異常終了した場合はexitステータス0
以外を返します。

＜エラーメッセージ＞
なし

＜使用例＞
#
#
#raslogpt[ 1] 2018/01/15 14:02:19[ 2] 2018/01/15 14:03:00[ 3] 2018/01/15 14:03:10[ 4] 2018/01/15 14:06:36[ 5] 2018/01/15 14:07:21
#
#
#
#
#

[MODE] Run mode was switched to SIMULATION.
[FAN]PWRFAN became slow.
[MODE] Run mode was switched to ONLINE.
[FAN]PWRFAN was recovered normally.
[TEMP] Temperature become too high.

7-8

RASイベントログ

第８章

ハードウェア状態のシミュレート

第８章 ハードウェア状態のシミュレート
８．１

ハードウェア状態シミュレーション機能

８．１．１ 概要
本機能は、RAS機能が監視しているハードウェアの状態をシミュレート（模擬）する機能です。
本機能を使用することで、実際にハードウェアの異常を発生させることなく、ハードウェア異常発生
時／異常回復時におけるRAS機能通知インタフェースの動作確認を行うことができます。なお、本機能使用中は、実際のハードウェアの状態監視が行われませんので、業務システム運用に本機能を使用しな
いでください。

本機能でシミュレート（模擬）することが出来るハードウェア部位は次のとおりです。
● ファン状態● 筐体内温度状態● メモリ状態● RAID状態● ドライブ状態

留意事項
・本機能使用中は、実際のハードウェアの状態監視が行われません。
（ハードウェアで実障害が発生した場合でも、異常検出されない状態となっています）
本機能は、ユーザアプリケーションのテストなど、RAS機能通知インタフェースを確認する用途で使用してください。
・本機能使用中は、下記の機能が停止もしくは使用できません。
- OSロック監視機能
・ハードウェア異常が検出されている状態では、本機能を有効にできません。
ハードウェア異常となっている要因を取り除いたうえで使用してください。
・未実装ハードウェアに対する状態模擬は行えません。
- メモリ- ドライブ・ドライブ使用時間監視機能が無効に設定されている状態では、内蔵ドライブ使用時間閾値
超過に対する状態模擬は行えません。

8-1

第８章

ハードウェア状態のシミュレート

８．１．２

シミュレーション機能の使用方法

RAS機能には、実際のハードウェア状態を監視するモード「通常モード（オンラインモード）」と、ハー
ドウェア模擬状態を監視するモード「RAS障害シミュレーションモード」の動作モードがあります。（装置
電源投入後の状態は、「通常モード」として動作しています）

ハードウェアの状態模擬は、RASソフトウェア動作モードを「RAS障害シミュレーションモード」に切り替た状態でのみ実施することが出来ます。
表８－１
No

RASソフトウェア動作モード一覧

動作モード

説明

1

通常モード（オンラインモード）

2

RAS 障害シミュレーションモード

実ハードウェアの状態を監視している状態です。
装置起動後はこの状態で動作します。
ハードウェア模擬状態を監視している状態です。

（１）シミュレーション機能使用手順（概略図）
本機能を使用する際の概略手順を下図に示します。シミュレーション機能開始コマンドを実行してから、シミュレーション機能終了コマンドを実行するまで、RAS機能は「RAS障害シミュレーション
モード」状態で動作します。

START

OS起動

通常モード状態
RAS障害シミュレーション機能開始(rassimtool START)

ハードウェア異常発生／異常回復模擬(rassimtool <部位> <模擬>)

障害シミュレーションモード状態

RAS障害シミュレーション機能終了(rassimtool STOP)

通常モード状態
OSシャットダウン

END

図８－１

シミュレーション機能使用手順（概略図）

8-2

第８章

ハードウェア状態のシミュレート（２）シミュレーション機能使用状態の確認
シミュレーション機能使用中の状態は、下記RAS機能通知インタフェースから確認することが
できます。
表８－２
No
1
2
3
4
5

RAS障害シミュレーションモード動作中の通知内容

通知インタフェース

通常モード

RAS障害シミュレーションモード

筐体前面ランプ[STATUS]緑⇔赤色交互点灯(1 秒間隔)緑色点灯

RAS 外部接点出力

オープン⇔クローズ交互出力(1 秒間隔)(*1)

オープン出力"Simulation" 表示"Online"表示

2(Simulation) 格納

1(Online) 格納

RAS ライブラリ関数(GetRasStat())

RAS_STS_MODE_SIMULATIONRAS_STS_MODE_ONLINE[nRasMode](0x5003) 格納(0x5002)[CPUSTOP]RAS 状態表示コマンド(詳細モード)[Ras mode]
RAS リモート通知(SNMP)[hfwRasInfo.hfwRasMode](*1) RAS外部接点[CPUSTOP]信号出力(B接点使用時)は下図となります。
(A接点使用時はオープン／クローズが反転します)(rassimtool START)(rassimtool STOP)

▼

▼

開始
RAS障害ｼﾐｭﾚｰｼｮﾝ機能
停止
ｵｰﾌﾟﾝ
RAS外部接点[CPUSTOP]

1秒
ｸﾛｰｽﾞ

RASｿﾌﾄｳｪｱ動作ﾓｰﾄﾞ

図８－２

障害ｼﾐｭﾚｰｼｮﾝﾓｰﾄﾞ

通常ﾓｰﾄﾞ

シミュレーション機能使用時のRAS外部接点[CPUSTOP]出力状態(B接点)

8-3

第８章

ハードウェア状態のシミュレート（３）ハードウェア状態模擬対象部位および模擬内容
本機能でハードウェア状態模擬を行う対象部位および模擬内容については以下となります。
表８－３
模擬対象部位No

1

2

ハードウェア状態模擬対象部位および模擬内容一覧

内蔵ファン

筐体内温度

模擬内容

電源ファン

ファン回転状態

フロントファン 1

ファン回転状態

フロントファン 2

ファン回転状態

筐体内温度

温度状態

RAID アレイ状態
3

内蔵 RAID

RAID アレイ 1
RAID メディアエラー有無
RAID 構成ドライブ状態
ドライブベイ 1

SMART 検知有無
使用時間閾値超過有無
RAID 構成ドライブ状態

4

内蔵ドライブドライブベイ 2

SMART 検知有無
使用時間閾値超過有無

ドライブベイ 3
(*1)
内蔵メモリ

SMART 検知有無(*2)
使用時間閾値超過有無(*2)

DIMMA1(*1)

ビットエラー訂正頻度状態(*2)

DIMMA2

ビットエラー訂正頻度状態

DIMMB1(*1)

ビットエラー訂正頻度状態(*2)

DIMMB2

ビットエラー訂正頻度状態

5(*1)本装置では使用しません。
(*2)「未実装」の状態は、模擬の選択ができません。

8-4

備考
正常
異常
正常
異常
正常
異常
正常
温度異常
高温異常
正常
縮退
故障
なし
あり
正常
オフライン
なし
あり
なし
あり
正常
オフライン
なし
あり
なし
あり
なし
あり
なし
あり
正常
異常
正常
異常
正常
異常
正常
異常

RAID 構成ドライブ状態
から自動判別されます。

第８章

８．１．３

ハードウェア状態のシミュレート

RAS障害シミュレーションコマンド（rassimtool）＜名前＞–

rassimtool

RAS障害シミュレーションモードの開始／停止、装置異常の模擬状態の設定＜書式＞
rassimtool--helprassimtool

START

rassimtool

STOP

rassimtool

STATUSrassimtool[模擬部位][模擬内容]＜実行権限＞
本コマンドは、root権限でのみ実行可能です。

＜説明＞
rassimtoolコマンドは、RAS障害シミュレーション機能の開始／停止の制御、障害シミュレーショ
ンモード中のハードウェア状態の模擬設定を行うためのコマンドです。
本コマンドが提供する機能は以下となります。
・RAS障害シミュレーション機能の開始(STARTオプション)
・RAS障害シミュレーション機能の停止(STOPオプション)
・障害シミュレーションモードでのハードウェア状態模擬設定内容の表示(STATUSオプション)
・障害シミュレーションモードでのハードウェア状態の模擬設定([模擬部位]オプション)＜制限事項＞・ハードウェア異常が検出されている状態ではRAS障害シミュレーション機能は開始できません。
・未実装ハードウェア部位(ドライブおよびメモリ)を対象にした状態模擬設定は行えません。
・ドライブ使用時間監視機能が無効に設定されている状態では、内蔵ドライブ使用時間閾値超過に対する状態模擬は行えません。
＜診断＞
処理が正常に終了した場合、exitステータス0を返します。異常終了した場合はexitステータス1以上を返します。

8-5

第８章

ハードウェア状態のシミュレート＜エラーメッセージ＞
表８－４
No

rassimtool コマンドのエラーメッセージ一覧

エラーメッセージ

説明1

Usage: (*1)
rassimtool <START|STOP|STATUS>
rassimtool <part> <status>

オプションの指定に誤りがあります。
正しいオプションを指定してください。
(*1)詳細内容は、--help オプション項を参照ください。

2

Access denied. errno=(xxx)

管理者権限がありません。
root ユーザまたは root グループに所属するユーザから実行してください。
※xxx=エラー番号3

Cannot switch to the simulation mode, because
hardware error occured.

ハードウェア異常が発生しているため、RAS 障害シミュレーション機能を開始できません。

4

Currently, the ras mode is the online mode.
switch to the simulation mode with "rassimtool
START" command.

指定オプションは障害シミュレーションモード中のみ有効です。rassimtool
START を実行し RAS 傷害シミュレーション機能を開始してから再度実行
してください。

5

Cannot simulate the state of [XXX], because[XXX] is not connected.

指定部位はハードウェアが実装されていないため、ハードウェア状態の模擬を行えません。(XXX=模擬部位)

6

Cannot simulate the state of [XXX], ドライブ使用時間監視機能が無効に設定されているため、シミュレーション
because bOverrunEnable is off.
できません。(XXX=模擬部位)

7

ERROR: an error occurred while processing<xxx>.

予期せぬエラーが発生しました。再度コマンドを実行してください。それでもエラーメッセージが表示される場合は、本装置を再起動してください。
※xxx=関数名＜使用例＞
RAS障害シミュレーションモード「開始」#rassimtool STARTRAS mode has been changed to [SIMULATION] mode.
##rassimtool PWRFAN ERROR

模擬設定例

The state of [PWRFAN] has been changed to [ERROR]##rassimtool STATUSPWRFAN
FR1FAN
FR2FANTEMPRAIDMEDIAERRORDRIVE1.STATUS
DRIVE1.SMART
DRIVE1.OVERRUNDRIVE2.STATUS
DRIVE2.SMART
DRIVE2.OVERRUNDRIVE3.SMART
DRIVE3.OVERRUNDIMMA1
DIMMA2
DIMMB1
DIMMB2#

rassimtool STATUSの表示例: ERROR: NORMAL: NORMAL: NORMAL: NORMAL: ONLINE: NORMAL: ERROR: ONLINE: ERROR: NORMAL: NORMAL: NORMAL: NORMAL: NORMAL: NORMAL: NORMAL#rassimtool STOPRAS mode has been changed to [ONLINE] mode.

RAS障害シミュレーションモード「終了」

8-6

第８章

ハードウェア状態のシミュレート＜オプション＞① --help
コマンドの引数一覧情報を表示します。
(a) RASソフトウェア動作モードが【障害シミュレーションモード】以外のとき#rassimtool --help
Usage: rassimtool START(b) RASソフトウェア動作モードが【障害シミュレーションモード】のとき#rassimtool --help
Usage:
rassimtool STATUS
rassimtool STOP
rassimtool <part> <status>
Options:<part> is as follows.
FAN= {PWRFAN/FR1FAN/FR2FAN}
TEMP= {TEMP}RAID= {RAIDMEDIAERROR}{DRIVE1.STATUS/DRIVE2.STATUS }DRIVE= {DRIVE1.SMART/DRIVE2.SMART/DRIVE3.SMART }{DRIVE1.OVERRUN/DRIVE2.OVERRUN/DRIVE3.OVERRUN }MEMORY= {DIMMA1/DIMMA2/DIMMB1/DIMMB2}<status> is as follows.
xxxFANTEMPRAIDMEDIAERRORDRIVEx.STATUS
DRIVEx.SMART
DRIVEx.OVERRUN
DIMMxx= {NORMAL/ERROR}= {NORMAL/ERROR/DANGER}= {NORMAL/ERROR}= {ONLINE/OFFLINE}= {NORMAL/ERROR}= {NORMAL/ERROR}= {NORMAL/ERROR}

Examples:rassimtool PWRFAN
rassimtool DIMMA2
rassimtool DRIVE1.SMART
rassimtool DRIVE2.STATUS

ERROR
ERROR
ERROR
OFFLINE② START
RASソフトウェア動作モードを「障害シミュレーションモード」に切り替え、RAS障害シミュレー
ション機能を開始します。既にRAS障害シミュレーション機能が開始している状態で本オプションを指定して実行した場合は、コマンド処理は正常終了します。
#rassimtool STARTRAS mode has been changed to [SIMULATION] mode.
③ STOP
RASソフトウェア動作モードを「通常モード」に切り替え、RAS障害シミュレーション機能を停止します。
既にRAS障害シミュレーション機能が停止している状態で本オプションを指定して実行した場合は、コマンド処理は正常終了します。
#rassimtool STOPRAS mode has been changed to [ONLINE] mode.

8-7

第８章

ハードウェア状態のシミュレート④ STATUS
ハードウェア状態の模擬設定内容を表示します。RAS障害シミュレーション機能が開始していない状
態で、本オプションを指定して実行した場合は、エラーメッセージを表示しコマンド処理は異常終了します。ハードウェア状態の模擬設定内容表示形式は下記のとおりです。
[模擬部位]、[模擬内容][模擬部位]、[模擬内容]オプションは下記となります。
表８－５
模擬部位

No

rassimtool コマンドの[模擬部位]、[模擬内容]オプション一覧
模擬内容

説明

備考

NORMAL

電源ファン回転状態正常

ERROR
NORMALERRORNORMALERRORNORMALERROR
DANGERNORMALERROR
ONLINEOFFLINENORMALERRORNORMALERROR
ONLINEOFFLINENORMALERRORNORMALERRORNORMAL

電源ファン回転状態異常
フロントファン 1 回転状態正常
フロントファン 1 回転状態異常
フロントファン 2 回転状態正常
フロントファン 2 回転状態異常
筐体内温度状態正常
筐体内温度状態温度異常
筐体内温度状態高温異常
RAID メディアエラーなし
RAID メディアエラーあり
内蔵 RAID 構成ﾄﾞﾗｲﾌﾞ 1 状態正常
内蔵 RAID 構成ﾄﾞﾗｲﾌﾞ 1 状態ｵﾌﾗｲﾝ
内蔵ドライブ 1 SMART 検知なし
内蔵ドライブ 1 SMART 検知あり
内蔵ドライブ 1 使用時間閾値超過なし
内蔵ドライブ 1 使用時間閾値超過あり
内蔵 RAID 構成ﾄﾞﾗｲﾌﾞ 2 状態正常
内蔵 RAID 構成ﾄﾞﾗｲﾌﾞ 2 状態ｵﾌﾗｲﾝ
内蔵ドライブ 2 SMART 検知なし
内蔵ドライブ 2 SMART 検知あり
内蔵ドライブ 2 使用時間閾値超過なし
内蔵ドライブ 2 使用時間閾値超過あり
内蔵ドライブ 3 SMART 検知なし

ERROR

内蔵ドライブ 3 SMART 検知あり

DRIVE3.OVERRUNNORMAL

内蔵ドライブ 3 使用時間閾値超過なし

(*1)

ERROR

内蔵ドライブ 3 使用時間閾値超過あり

14

DIMMA1(*1)

NORMALERROR

DIMMA1 ビットエラー訂正頻度正常
DIMMA1 ビットエラー訂正頻度異常

初期値

NORMALDIMMA2 ビットエラー訂正頻度正常

初期値

15

DIMMA2ERROR

DIMMA2 ビットエラー訂正頻度異常

DIMMB1(*1)

NORMAL

16

DIMMB1 ビットエラー訂正頻度正常

ERROR

DIMMB1 ビットエラー訂正頻度異常

DIMMB2NORMAL

17

DIMMB2 ビットエラー訂正頻度正常

ERROR

DIMMB2 ビットエラー訂正頻度異常

1

PWRFAN

2

FR1FAN

3

FR2FAN

4TEMP

5RAIDMEDIAERROR

6DRIVE1.STATUS

7DRIVE1.SMART

8DRIVE1.OVERRUN

9DRIVE2.STATUS

10DRIVE2.SMART

11

DRIVE2.OVERRUN

12DRIVE3.SMART(*1)13(*1)本装置では使用しません。

8-8

初期値
初期値
初期値
初期値

初期値
初期値
初期値
初期値
初期値
初期値
初期値
初期値
初期値

初期値
初期値

第８章

ハードウェア状態のシミュレート⑤ <part> <status>
ハードウェア状態の模擬設定を実施します(<part>は模擬部位、<status>は模擬内容を指定します)。
<part>および<status>で指定可能な値および組み合わせ可能な値は、④STATUSオプション項「表８－５」表中に示している値となります。
RAS障害シミュレーション機能が開始していない状態で本オプションを指定して実行した場合は、エラーメッセージを表示しコマンド処理は異常終了します。
<part>模擬部位に対し、現在設定されている模擬状態と同じ状態を指定した場合(例：[PWRFAN]に[ERROR]設定済み状態で[ERROR]を指定)は、コマンド処理は異常終了します。
なお、ハードウェア構成上未実装状態の部位(ドライブおよびメモリ)を模擬対象部位として指定した
場合は、エラーメッセージを表示しコマンド処理は異常終了します。
(a) 模擬設定例([電源ファン]に[異常]状態を設定)#rassimtool PWRFAN ERROR
The state of [PWRFAN] has been changed to [ERROR]※RAIDアレイ状態の模擬について
RAIDアレイ状態は、ドライブ状態(DRIVEx.STATUS)の組み合わせにより、自動的に判別されます。組み合わせについては下表の内容となります。
表８－６

RAID アレイの状態 組合せ表
DRIVE2 状態模擬内容

状 Ｄ
態 Ｒ
模 Ｉ
擬 Ｖ
内 Ｅ
容 １

正常
(ONLINE)

オフライン(OFFLINE)

正常(ONLINE)

RAIDアレイ正常

RAID アレイ縮退(Optimal)(Degrade)

オフライン

RAID アレイ縮退

RAID アレイ故障(OFFLINE)(Degrade)(Fail)

Optimal: RAID状態が正常

Degrade : RAID状態が縮退
Fail: RAID状態が異常

留意事項
RASソフトウェアによる通知インタフェースは、rassimtoolコマンドにて模擬設定を実施してから、以下の経過時間後にハードウェアの状態を反映します。そのため、シミュレート結果の確認は以下の時間経過後に行ってください。
・ファン状態：約10秒後
・筐体内温度状態：約10秒後・ドライブ状態：約5秒後・メモリ状態：約60秒後

8-9

第８章

ハードウェア状態のシミュレート

このページは白紙です。

8-10

付録A

付録A
A．１

RAS機能のインストール手順

RAS機能のインストール手順

概要
本章では、RAS ユーティリティパッケージを本装置にインストールする方法について説明します。

留意事項
・本装置は工場出荷時に RAS ユーティリティパッケージをインストールしております。ご使用の際に改めてインストールする必要はありません。
・OS の再インストールを実施された場合は、下記手順にて RAS ユーティリティパッケージのインストールを行ってください。なお、OS の再インストール方法については、「HFW7500/LX モデル 50 取扱説明書」の「第７章 インストール DVD による出荷状態への復元」を参照してください。
・RAS ユーティリティパッケージのインストールは OS のインストール後、すぐに行ってください。また、インストール作業は途中で中断しないでください。

A．２

RASユーティリティパッケージのインストール
RASユーティリティパッケージのインストールは、rootユーザでログインしてから実行してください。

（１）rootユーザにてログインしてください。
（２）デスクトップ上で右クリックし、「端末を開く（E）」を選択しコンソール画面を開きます。
（３）「RASUTL」のDVDを本装置のDVDドライブに挿入してください。
/run/media/root/RASUTLに自動マウントされます。（数秒程度時間がかかります。）（４）下記コマンドでカーネルのアップデートを実施します。
# cd /run/media/root/RASUTL# bash update-kernel
アップデートが完了し、下記のメッセージが表示されることを確認してください。
※インストールには約２分かかります。

+-----------------------------------------------------------+|

Please reboot a system.

|+-----------------------------------------------------------+（５）下記コマンドを実行し本装置を再起動してください。
※「RASUTL」のDVDは挿入したまま再起動ください。
# shutdown –r now（６）OS再起動後、rootユーザにてログインしてください。
「RASUTL」のDVDが/run/media/root/RASUTLに自動マウントされます。
（数秒程度時間がかかります。）（７）デスクトップ上で右クリックし、「端末を開く（E）」を選択しコンソール画面を開きます。

A-1

付録A

RAS機能のインストール手順（８）下記コマンドでRASユーティリティパッケージのインストールを実施します。
# cd /run/media/root/RASUTL# bash setup-rasutl
インストールが完了し、下記のメッセージが表示されることを確認してください。
※インストールには約２分かかります。

+-----------------------------------------------------------+|

Please reboot a system.

|+-----------------------------------------------------------+（１０）下記の操作でDVDを取り出します。
# cd /# umount /run/media/root/RASUTL# eject（１１）下記コマンドを実行し本装置を再起動してください。
# shutdown –r now
以上で RAS ユーティリティパッケージのインストールは終了です。

A．３

RASソフトウェア機能で使用する設定ファイル
RASソフトウェア機能の動作に影響する各種設定ファイルは下記となります。
動作に影響しますので、修正はしないでください。
① /etc/kdump.conf② /etc/rasutl/*.conf③ /etc/rsyslog.d/50-rasutl.conf④ /etc/sos.conf⑤ /usr/lib/dracut/modules.d/99raskdump/*.conf⑥ /usr/lib/sysctl.d/75-hfwsysctl.conf⑦ /usr/lib/udev/rules.d/75-hfwstorage.rules⑧ /usr/lib/tmpfiles.d/rasutl.conf⑨ /etc/logrotate.d/rasutl

また、下記設定ファイルについては、適切に修正いただくことが前提になります。
表A－１
ファイル名
snmpd.conf

RASソフトウェア機能の設定ファイル一覧

ファイル概略名称
snmpd デーモン設定

格納ディレクトリ/etc/snmp

ファイル

ファイル概要RAS リモート機能で SNMP エージェントのアクセス制限を行う定義ファイル

A -2