MLB-R190R-01

日立産業用コンピュータ

HF-W100E/LX
RAS 機能マニュアル

ユーザーズ
マニュアル

MLB-R190R-01

日立産業用コンピュータ

HF-W100E/LX
RAS 機能マニュアル

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

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

ユーザーズ
マニュアル

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

●●

２０１９年 ９月

（第１版）

ＭＬＢ－Ｒ１９０Ｒ－００（廃版）

２０２０年 ４月

（第２版）

ＭＬＢ－Ｒ１９０Ｒ－０１

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

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

このページは白紙です。

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

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

●

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

●

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

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

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

S-1

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

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

●

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

●

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

●

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

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

警告

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

●

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

●

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

●

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

S-2

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

１．２
●

注意

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

●

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

S-3

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

１．３
●

通知

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

●

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

●

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

●

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

●

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

●

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

S-4

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

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

RAS機能でできること

第２章

RAS機能の監視対象

第３章

ユーザプログラムでできること

第４章

保守・障害解析関連

付録A

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-W100E/LX RASユーティリティパッケージ................................................................................

1-1

１．２

概要

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

1-2

第２章 RAS機能の監視対象
２．１

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

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

2-1

第３章 ユーザプログラムでできること.............................................................................

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

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

3-2

３．１

ウォッチドッグタイマ監視

３．２

外部汎用入出力の制御

３．２．１

外部汎用出力の出力制御..........................................................................................................

3-3

３．２．２

外部汎用出力の状態取得..........................................................................................................

3-5

３．２．３

外部汎用入力の状態取得..........................................................................................................

3-6

第４章 保守・障害解析関連.........................................................................................................

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

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

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

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

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

4-3.............................................................................................................................................

4-3

４．１

メモリダンプ機能

４．１．１

概要

４．１．２

メモリダンプの採取要因

４．１．３

メモリダンプファイルおよび障害情報レポートファイル保存仕様

４．２

ログファイル収集機能

４．２．１

概要

４．２．２

sosreportコマンド概要

４．２．３

sosreportコマンド使用方法

４．２．４

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

付録A...............................................................................................................

4-3.......................................................................................................

4-4...............................................................................

4-5

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

A-1

図目次
..................................................................................

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

3-5

汎用出力１の動作例 ..........................................................................................................................

3-5

図２－１

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

図３－１

汎用出力制御の動作例

図３－２

表目次
表１－１

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

1-1

表２－１

検出するOSロック状態一覧.............................................................................................................

2-1

表３－１

ウォッチドッグタイマ設定値..........................................................................................................

3-1

表３－２

使用インタフェース一覧..................................................................................................................

3-2

表３－３

外部汎用出力のucOutputとucMaskのbit割り当て..........................................................................

3-3

表３－４

外部汎用出力状態取得のucValueのbit割り当て............................................................................

3-5

表３－５

外部汎用入力状態取得のucvalueのbit割り当て.............................................................................

3-6

表４－１

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

4-2

表４－２

メモリダンプファイルおよび障害情報レポートファイル保存仕様..........................................

4-2

表Ａ－１

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

A-1

iv

第１章

RAS機能でできること

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

１．１

HF-W100E/LX RASユーティリティパッケージ

RAS機能は、以下のソフトウェアにてサポートします。

表１－１
No
1

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

パッケージ名称
RASユーティリティパッケージ

型式
CS-LXW11P

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

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

1-1

第１章

RAS機能でできること

１．２

概要

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

（１）OSロック監視機能
この装置に実装されていウォッチドッグタイマを使用して、OSの動作状態を監視します。
OSの割込み処理が一定時間動作できない状態のとき、およびリアルタイム優先度のプロセスが一定時間動作できない状態の時にメモリダンプを採取し、装置を再起動します。
（２.１

OSロック監視機能 参照 ）（２）ウォッチドッグタイマ監視機能
この装置に実装されているウォッチドッグタイマを使用し、ユーザープログラムが動作していることを監視します。また、ウォッチドッグタイマを使用するインターフェースを提供します。
（３.１

ウォッチドッグタイマ監視参照）（３）外部汎用入出力の制御
この装置の外部汎用入出力を制御することができます。
ユーザが使用できる外部汎用入出力には、入力用に７点と出力用に８点用意されています。これらの汎用入出力を使用して外部機器からの信号をこの装置に入力したり、この装置から外部に信号を出力したりすることができます。

（４）メモリダンプ採取機能
この装置が予期せずに停止してしまった場合など障害が発生したときに、キーボード操作（［Alt］キーと［PrintScreen］キーを押しながら［c］キーを押す）によって、システムメモリの内容をファイル（メモリダンプファイル）に記録します。このメモリダンプの内容を解析すること
によって、障害の原因を調査することができます。
（「HF-W100E/LX 取扱説明書」「８.２メモリダンプ採取機能」参照）（５）ログファイル収集機能
この装置のログ情報データやメモリダンプファイルの一括収集を行います。

1-2

第２章

RAS機能の監視対象

第２章 RAS機能の監視対象
この章では、RAS機能の監視対象について説明します。

OSロック監視機能

２．１

この装置に備わっているウォッチドッグタイマを使用して、OSの動作監視を行います。
ウォッチドッグタイマは、OS標準のNMIウォッチドッグおよびsoftdogを使用します。
各ウォッチドッグタイマでは、次のOSロック状態を検出します。

表２－１
監視対象
IRQ割込み不可

検出するOSロック状態一覧

ウォッチドッグタイマ
NMIウォッチドッグ

状態

内容
OSの割込み処理が一定時間動作できない状態となった場合に検出されます。
OSロック状態の検出までには 10～30秒 の時間を要します。

OS動作不能状態

softdog

リアルタイム優先度で動作するウォッチドッグタイマ監視プロセスが一定時間動作できない状態となった（ウォッチドッグタイマのタイムアウトが発生した）場
合に検出されます。
ウォッチドッグタイマ監視プロセスは、OS標準のwatchdogサービスを使用します。
Watchdogサービスが定周期でウォッチドッグタイマのリ
トリガを行います。
ウォッチドッグタイマの設定値は以下のとおりです。
・タイムアウト時間：60秒
・リトリガ周期：1秒

上記のOSロック状態が検出された場合、メモリダンプを取得し、装置を再起動します。メモリダンプ取得については「５．２

タイムアウト検出によるメモリダンプ取得」を参照してください。

2-1

第２章

RAS機能の監視対象

留意事項
・この機能では、OS割込み処理が動作できない状態、およびリアルタイム優先度のプロセス
が一定時間動作できない状態をOSロックとして扱います。
・ウォッチドッグタイマ監視機能でユーザプログラムの動作監視を行う場合、OS動作不能状
態の監視は使用できません。
ウォッチドッグタイマ監視機能を使用した場合、OS標準サービスwatchdogサービスが無効化されていますので、その場合にはOS標準サービスwatchdogを次の手順で有効化してください。
# systemctl enable watchdog.service
・OS動作不能状態監視は、OS起動時のサービス初期化処理で開始され、OS停止時のサービス停止処理で停止されます。IRQ割込み不可状態監視は、OS起動時に開始され、OS停止時に停止されます。

2-2

第３章

ライブラリ関数

第３章 ユーザプログラムでできること
RAS機能ドライバおよびOS標準ドライバを使用して、ユーザプログラムの動作監視やユーザプログラム
からこの装置のハードウェア状態の取得および制御を行うことができます。
３．１

ウォッチドッグタイマ監視

この装置に備わっているウォッチドッグタイマを使用して、ユーザプログラムの動作監視を行うことができます。ウォッチドッグタイマはOS標準のsoftdogを使用します。
このウォッチドッグタイマがタイムアウトした場合、メモリダンプを取得し、装置を再起動します。メモ
リダンプ取得については「５．２

タイムアウト検出によるメモリダンプ取得」を参照してください。

ウォッチドッグタイマの使用については、kernel-docパッケージに含まれるwatchdog-api.txtなどのwatchdog
関連ドキュメントを参照してください。

留意事項
・softdogのデバイスファイルは、/dev/softdogを使用します。
・ユーザプログラムからウォッチドッグタイマを使用する場合には、OSロック監視（OS動作不能状態）は使用できません。
OS標準サービスwatchdogを次の手順で無効化してください。
# systemctl disable watchdog.service
・ユーザープログラムの終了やシャットダウンなどによりウォッチドッグタイマを使用した監視を終了する場合は、タイムアウトが発生しないようにウォッチドッグタイマを必ず停止してください。

次のファイルを編集することによりウォッチドッグタイマの設定を変更することができます。
/etc/sysconfig/softdog
設定項目および設定値を以下に示します。

表３－１

ウォッチドッグタイマ設定値

設定項目

形式

デフォルト値

設定値

タイムアウト時間

TIMEOUT=時間(秒)60

1～3600

タイムアウト発生時

ACTION=動作

panic

panic：メモリダンプを取得し再起動
reset：再起動の動作

none：シスログへのログ出力のみ（再起動しない）3-1

第３章 ライブラリ関数

３．２

外部汎用入出力の制御

C言語のユーザプログラムからRAS機能ドライバを使用して外部汎用入出力の取得および制御することができます。
対象の操作と使用するインタフェースの一覧を示します。
表３－２
制御対象

使用インタフェース一覧
RAS機能

デバイスファイル

OS標準関数

インクルードファイル
外部汎用出力の出力制御/dev/hfwdio/gendo/usr/include/hfwlx/hfwdiodrv.h

open/close/ioctl

外部汎用出力の状態取得/dev/hfwdio/gendo/usr/include/hfwlx/hfwdiodrv.h

open/close/ioctl

外部汎用入力の状態取得/dev/hfwdio/gendi/usr/include/hfwlx/hfwdiodrv.h

open/close/ioctl

なお、この章で記載している外部汎用入出力のハードウェア仕様については、「HF-W100E/LX 取扱説明書」の「５．５．１

コネクタ仕様」および「５．５．２

3-2

外部接点仕様」を参照してください。

第３章

３．２．１

ライブラリ関数

外部汎用出力の出力制御

外部汎用出力（汎用出力１～８）の出力を制御します。
RAS機能ドライバの対象デバイスファイル（/dev/hfwdio/gendo）に、汎用出力への出力値と出力対象を設定します。

＜書式＞
int open(“/dev/hfwdio/gendo”, int flags);
int Ioctl(int Fd, HFWDIO_IOC_SETGENDO , T_HFWDIO_GENDO_WDATA wdata);
int close(int Fd);
＜説明＞
外部汎用出力（汎用出力１～８）を制御します。
以下にこの関数のパラメータについて説明します。

fd：/dev/hfwdio/gendoのファイルディスクリプタ
wdata.ucOutput：
汎用出力への出力状態を設定します。各汎用出力のbitの割り当ては、表３－２のとおりです。汎用
出力の出力状態をローレベルにする場合は「０」、ハイレベルにする場合は「１」を設定します。
wdata.ucMask：
制御対象とする汎用出力を指定します。各bitの割り当ては、ucOutputと同じ表３－２のとおりです。
制御対象とする場合は「１」、制御対象としない場合は「０」を指定します。

表３－３

外部汎用出力のucOutputとucMaskのbit割り当て
bit0

汎用出力１

bit1

汎用出力２

bit2

汎用出力３

bit3

汎用出力４

bit4

汎用出力５

bit5

汎用出力６

bit6

汎用出力７

bit7

汎用出力８

＜戻り値＞
この関数の呼び出しが正常終了した場合は０を返し、異常終了の場合は－１を返します。
errnoの設定値については、ioctlのmanページを参照してください。

3-3

第３章 ライブラリ関数＜解説＞
ucOutputで汎用出力の出力状態を設定し、ucMaskで制御対象を指定します。
図３－１にucOutputとucMaskの関係の動作例を示します。

図３－１ 汎用出力制御の動作例＜補足説明＞
ucOutputで汎用出力の出力状態を設定し、ucMaskで制御対象を指定します。図３－２に汎用出力1の動作を示します。破線は汎用出力のレベル状態を、太線は汎用出力1の状態遷移を示します。
電源ON

シャットダウン

装置起動

電源OFF

High

Low

時刻→
ioctl(･･･SETGENDO…)実行
ucOutput： 0x00
ucMask ： 0x01

図３－２

ioctl(･･･SETGENDO…)実行
ucOutput： 0x01
ucMask ： 0x01

汎用出力１の動作例

3-4

第３章

３．２．２

ライブラリ関数

外部汎用出力の状態取得

外部汎用出力（汎用出力１～８）の出力状態を取得します。
RAS機能ドライバの対象デバイスファイル（/dev/hfwdio/gendo）に、汎用出力の出力状態の格納先を設
定します。

＜書式＞

int open(“/dev/hfwdio/gendo”, int flags);
int Ioctl(int Fd, HFWDIO_IOC_GETGENDO, unsigned char *ucValue);
int close(int Fd);
＜説明＞
外部汎用出力（汎用出力１～８）の出力状態を取得します。
以下にこの関数のパラメータについて説明します。
fd：/dev/hfwdio/gendoのファイルディスクリプタ
ucValue：
汎用出力の出力状態が格納されます。各汎用出力に対するbitの割り当ては、表３－３のとおりです。
汎用出力の出力状態がローレベルのときは「０」、ハイレベルのときは「１」が格納されます。

表３－４

外部汎用出力状態取得のucValueのbit割り当て

bit0

汎用出力１

bit1

汎用出力２

bit2

汎用出力３

bit3

汎用出力４

bit4

汎用出力５

bit5

汎用出力６

bit6

汎用出力７

bit7

汎用出力８

＜戻り値＞
この関数の呼び出しが正常終了した場合は０を返し、異常終了の場合は－１を返します。
errnoの設定値については、ioctlのmanページを参照してください。

3-5

第３章 ライブラリ関数

３．２．３

外部汎用入力の状態取得

外部汎用入力（汎用出力１～７）の入力状態を取得します。
RAS機能ドライバの対象デバイスファイル（/dev/hfwdio/gengi）に、汎用入力の入力状態の格納先を設
定します。

＜書式＞

int open(“/dev/hfwdio/gendi”, int flags);
int Ioctl(int Fd, HFWDIO_IOC_GETGENDI, unsigned char *ucValue);
int close(int Fd);
＜説明＞
外部汎用入力（汎用入力1～7）の入力状態を取得します。
以下にこの関数のパラメータについて説明します。
fd：/dev/hfwdio/gendiのファイルディスクリプタ
ucValue：
汎用入力の入力状態が格納されます。各汎用入力に対するbitの割り当ては、表３－４のとおりです。
汎用入力の入力状態がローレベルのときは「０」、ハイレベルのときは「１」が格納されます。

表３－５

外部汎用入力状態取得のucvalueのbit割り当て

bit0

汎用入力１

bit1

汎用入力２

bit2

汎用入力３

bit3

汎用入力４

bit4

汎用入力５

bit5

汎用入力６

bit6

汎用入力７

bit7

使用しない

＜戻り値＞
この関数の呼び出しが正常終了した場合は０を返し、異常終了の場合は－１を返します。
errnoの設定値については、ioctlのmanページを参照してください。

3-6

第４章

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

メモリダンプ機能

４．１．１

概要

この装置では、OSロック状態検出、ウォッチドッグタイマのタイムアウト検出、メモリダンプ収集操作が発生した場合に、システムメモリの内容をメモリダンプファイルに記録（*1）します。また、障害初期調査・解析に利用する障害情報レポートを出力します。採取中は、筐体前面のアラームランプが赤点灯されます。（*2）
採取完了後は、装置は自動的に再起動して、筐体前面のアラームランプは消灯します。
（*1）メモリダンプの採取には Red Hat Enterprise Linux 7 OS機能の kdump を使用しています。
kdump機能はメモリダンプ採取要因発生時、専用のカーネルを起動し、メモリダンプファイルを保存します。
（*2）メモリダンプ採取処理に掛かる時間は、メモリ容量が4GBの場合は約3分程度掛かりますが、システムの利用状況により前後する場合があります。

採取したメモリダンプファイル内容を解析することによって障害の原因を調査できます。
メモリダンプの解析が必要な場合は、「HF-W100E/LX取扱説明書

8.2メモリダンプ採取機

能」を参照し、DVD-R等に保存した後、弊社担当営業までご連絡ください。
なお、メモリダンプの解析は有償となります。

4-1

第４章 保守・障害解析関連

４．１．２

メモリダンプの採取要因

この機能は、表４－１の要因でメモリダンプが採取されます。
表４－１

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

要因
Linux カーネル障害

説明Linuxカーネル内で重要エラーが発生したとき、メモリダンプが採取されます。

IRQ割込み不可状態検出

OSロック監視機能でNMIウォッチドッグによるタイムアウトを検出したと
き、メモリダンプが採取されます。（CPUが一定時間IRQ割込みを無効にしている状態）

OS動作不能状態検出

OSロック監視機能でsoftdogによるタイムアウトを検出したとき、メモリダ
ンプが採取されます。（高優先度のプロセスが一定時間動作できない状
態）

ユーザプログラム動作

ウォッチドッグタイマ監視機能でsoftdogによるタイムアウトを検出したと不能状態検出き、メモリダンプが採取されます。（ユーザプログラムが一定時間動作できない状態）

キーボード操作による

下記のキーボード操作を行ったとき、メモリダンプが採取されます。

メモリダンプ収集[Alt]キーと[PrintScreen]キーを押しながら[c]キーを押す

コマンドライン入力に下記のコマンドライン入力を行ったとき、メモリダンプが採取されます。

よるメモリダンプ収集

echo c > /proc/sys/kernel/sysrq

なお、メモリダンプが発生した場合の対応については、「HF-W100E/LX 取扱説明書」の「８．２モリダンプ採取機能」を参照ください。

4-2

メ

第４章

４．１．３

保守・障害解析関連

メモリダンプファイルおよび障害情報レポートファイル保存仕様

この機能が記録するメモリダンプファイルと障害情報レポートファイルの保存仕様を表５－２に示しま
す。

表４－２

メモリダンプファイルおよび障害情報レポートファイル保存仕様
項目

No.

保存用ディレクトリ/var/crash/dump2

ファイル名称

vmcore(*2)

3

最大保存件数

1件

保存用ディレクトリ/var/crash/dump5

ファイル名称

report(*2)

6

最大保存件数

10件

世代管理ディレクトリ

/var/crash/report

世代管理ファイル名称

report.N（Nは0～9）(*3)

1

4

メモリダンプ

内容

障害情報レポートファイル（*2）保存に失敗した場合は、ファイル名の末尾に「-incomplete」が付加されます。
（*3）report.0が最新で1世代前はreport.1となります。
/var/crash/report.0と/var/crash/dump/reportは同一内容です。

4-3

第４章 保守・障害解析関連

４．２

ログファイル収集機能

４．２．１

概要

ログファイル収集機能は、保守用のログファイルを収集する機能です。
OSの提供する sosreportコマンドにて収集することができます。

４．２．２

sosreportコマンド概要

sosreportコマンドは、システムに関する様々な情報をアーカイブファイルとして容易に一括収集できるツールです。以下のような情報を収集します。
詳細については、生成された圧縮ファイルを展開してご確認ください。
①sosreport オプションなし●

システムのハードウェア情報●

設定ファイル●

ログファイル●

コマンド実行時点のプロセス情報等

留意事項a) 情報取得時にはシステムに負荷が掛かります。
システム稼動が行われていない時間帯などを考慮のうえ、適切なタイミングで実行してください。
b) 情報取得には約5分程度の時間が掛かります。
ご使用環境により情報取得に時間が掛かる場合がありますのでシステム稼動の停止がある
程度余裕をもって行える時間帯に実行してください。
c) 実行後、中断は行わないでください。（Ctrl + c等により）中断した場合は、正常に処理が終了しない場合があります。
d) 情報収集したファイルは、/var/tmp下に作成されます。約20MB程度のサイズになります。
e) できる限り多くのシステム情報を収集するため、取得情報の中にユーザ名、ホスト名、IP アドレス等が含まれます。
※ /etc/passwd、/etc/shadow ファイル等は含まれません。
※ 収集したファイル一覧は、下記コマンドで確認できます。
tar Jtf /var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz( <hostname> = 装置のホスト名, <date>= 取得日 , <xxx>=7桁の英数字 )f) sosreportコマンドは、/tmp ディレクトリに移動してから実行してください。

4-4

第４章

４．２．３

保守・障害解析関連

sosreportコマンド使用方法

sosreportコマンドのオプション指定なしによる、システム情報の収集手順を記載します。
rootユーザでログインしてから実行してください。
本コマンドは各種システム情報を収集するため、rootユーザで実行する必要があります。
① rootユーザでログインしてください。
② /tmpディレクトリに移動してください。
/tmp以外のディレクトリで、本コマンドを実行すると失敗する場合があります。
# cd /tmp③ sosreportコマンドを実行します。
# sosreport④ 下記メッセージが表示されますので、Enterキーを押します。
Please enter the case id that you are generating this report for []:⑤ 下記メッセージが表示されますので、採取対象日を対話形式で入力します。
例えば、障害発生時のシステム情報を収集する場合には、採取対象日に障害発生日を入力します。
採取対象日が誤っていた場合、下記メッセージを繰り返し表示します。
Please enter the date of failure (yyyy-mm-dd):（例：2020年1月9日の場合は「2020-01-09」と入力します。）⑥ ⑤にて採取対象日が未入力の場合、下記メッセージを表示してコマンド実行日を採取対象日に設定します。よろしければ「y」を入力します。
「y」以外を入力した場合は、④に戻り再度、採取対象日を入力します。
Did a failure occur today or a failure day is not clear? then enter y:⑦ 下記表示があり情報収集が終了します。
/var/tmpディレクトリ下に/var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz が作成されます。

(***** = 装置のホスト名)(YYYYMMDDhhmmss = 年月日時分秒 )Your sosreport has been generated and saved in:/var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz
The checksum is: ･･･････････････････････････････
Please send this file to your support representative.

留意事項/var/tmpディレクトリ下に /var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz が作成されます。
( <hostname> = 装置のホスト名 , <date>= 取得日(例:2020-01-09) , <xxx>=7桁の英数字 )障害発生時には必要に応じて上記ファイルをサポート窓口へ送付ください。

4-5

第４章 保守・障害解析関連＜使用例＞#sosreportsosreport (version 3.6)
This command will collect diagnostic and configuration information fromthis Red Hat Enterprise Linux system and installed applications.
・・・
ENTER を押して継続するか、又は CTRL-C で終了します。

Enterキーを押す

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: yRunning plugins. Please wait ...
:Running xx/xx …
:
Finishing plugins[Running: …]
Finished running plugins
アーカイブを圧縮しています...

Enterキーを押す

Your sosreport has been generated and saved in:/var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz
The checksum is: ･･･････････････････････････････

採取対象日を入力してEnterキーを押す。
採取対象日が未入力の場合、コマンド実
行日を採取対象日に設定します。
この場合、確認のメッセージを表示するので、よければ[y]を入力します。
[y]以外を入力した場合は再度採取対象日の入力になります。

Please send this file to your support representative.

留意事項/var/tmpディレクトリ下に/var/tmp/sosreport-<hostname>-<date>-<xxx>.tar.xz が作成されます。
( <hostname> = 装置のホスト名 , <date>= 取得日(例:2020-01-09) , <xxx>=7桁の英数字 )障害発生時には必要に応じて上記ファイルをサポート窓口へ送付ください。

4-6

付録A

付録A

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

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

RASソフトウェア機能の動作に影響する各種設定ファイルは下記となります。
動作に影響しますので、修正はしないでください。
表A－１
No.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

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

ファイル名称/etc/rasutl/*.conf/etc/sysconfig/softdog/etc/sysconfig/modules/softdog.modules/etc/kdump.conf/etc/sos.conf/usr/lib/75-hfwsysctl.conf/usr/lib/udev/rules.d/75-hfwstorage.rules/usr/lib/dracut/modules.d/99raskdump/*.sh/usr/lib/tmpfiles.d/hfwlx.conf/usr/lib/udev/rules.d/50-softdog.rules/etc/watchdog.conf/etc/systemd/system/kdump.service/usr/lib/systemd/system/rasinitctl.service/usr/lib/systemd/system/raskdmpctl.service/usr/lib/systemd/system/raskdmplog.service/usr/rasutl/systemd/rasinitctl/usr/rasutl/systemd/raskdmpctl/usr/rasutl/systemd/raskdmplog/usr/lib/python2.7/site-packages/sos/plugins/hfwsysinfo.py/usr/lib/python2.7/site-packages/sos/plugins/hfwrasinfo.py/usr/lib/python2.7/site-packages/sos/plugins/hfwmemdump.py

A-1

付録A

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

このページは白紙です。

A -2