高信頼化システム監視機能 HAモニタ kit for SAP HANA

3000-9-141-10

前書き

著作権

All Rights Reserved. Copyright (C) 2017, 2022, Hitachi, Ltd.

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，およびHAモニタは，株式会社 日立製作所の商標または登録商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc. の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

SAP，および本文書に記載されたその他の SAP 製品，サービス，ならびにそれぞれのロゴは，ドイツおよびその他の国々における SAP SE の商標または登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

発行

2022年4月　3000-9-141-10

変更内容

変更内容（3000-9-141-10）HAモニタ kit for SAP HANA 01-02

追加・変更内容

変更個所

LANの通信可否による系切り替えを使用した場合の，他社PC/AT互換機の構成例を追加した。

1.3.1(1)，1.3.2(1)，3.2.3，3.2.7，3.2.7(1)(a)，3.2.7(1)(b)，3.2.7(2)(a)，3.2.7(2)(b)，3.2.7(3)，3.2.7(3)(a)，3.2.7(3)(b)

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，HAモニタ kit for SAP HANAの機能，設定方法，および運用方法について説明したものです。このマニュアルを読むことで，HAモニタのユーザが，HAモニタ kit for SAP HANA（以降，HAモニタkitと表記します）を使用したシステム構成を設計・構築・運用し，SAP HANAを使用したシステムを監視できるようになることを目的としています。

対象製品

適用OS：Red Hat(R) Enterprise Linux(R) server 7(x86_64)，Red Hat(R) Enterprise Linux(R) server 8(x86_64)

P-F532C-E1112 HA モニタ kit for SAP HANA 01-02

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。

対象読者

システム管理者，オペレータ，およびプログラマの方を対象としています。システム管理者は，システムの導入，設計，構築をすることを想定しています。オペレータは，構築されたシステムで日々の運用をすることを想定しています。

また，次の知識をお持ちの方を前提としています。

ハードウェアの知識

OSの知識

HAモニタの知識

SAP HANAの知識

このマニュアルで使用する図中の記号

このマニュアルの図中で使用している記号を，次のように定義します。

1　HAモニタ kitの概要

この章では，HAモニタ kitの目的，HAモニタ kitを適用できる構成，HAモニタ kitの動作環境，およびHAモニタとの関係について説明します。

1.1　HAモニタ kitの目的

HAモニタを使用した，SAP HANAのクラスタ化をサポートします。パラメタの設定だけで，クラスタ化できます。

1.2　HAモニタ kitを適用できる構成

HAモニタでは，システムの障害に備えて二つのシステムを用意し，一つで業務処理を実行させ，もう一つを待機させておきます。用意したこれらのシステムを系といいます。また，システム（系）で業務を実行するプログラムのことをサーバといいます。SAP HANAのシステム構成では，HAモニタで監視・制御するインスタンスごとにサーバがあります。HAモニタは，このサーバ単位で系切り替えします。

ここでは，HAモニタ kitを適用するに当たって，SAP HANAのシステム構成，および系切り替え構成について説明します。

1.2.1　SAP HANAの構成

適用可能な構成を次の図に示します。

図1‒1　適用可能なSAP HANAのシステム構成

＜サーバ構成と役割＞

現用系のサーバ１はプライマリSAP HANAインスタンスに対応します。

予備系のサーバ１はセカンダリSAP HANAインスタンスに対応します。

現用系：

現用系のサーバ１は実行サーバです。プライマリSAP HANAインスタンスを起動・停止・監視します。

予備系：

予備系のサーバ１は待機サーバです。セカンダリSAP HANAインスタンスを起動・停止・監視します。現用系の障害時に予備系に系切り替えして，セカンダリSAP HANAインスタンスをプライマリ化します。

1.3　HAモニタ kitの動作環境

HAモニタ kitを使用したシステムを動作させるために必要なハードウェア，およびソフトウェアについて説明します。HAモニタを使用した一般的なシステムと共通の内容については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のHAモニタの動作環境の説明を参照してください。

1.3.1　必要なハードウェア

系切り替えに必要なハードウェアはHAモニタに依存します。

ここでは，SAP HANAをHAモニタのサーバとして構築する上で必要なハードウェアの要素を示します。

(1)　ハードウェア構成例

マシンの機種がHA8000/RS440（CN1）モデル以降の場合のハードウェア構成例について次の図に示します。

図1‒2　HA8000/RS440のハードウェア構成例

マシンの機種がBS2500モデル以降の場合のハードウェア構成例について次の図に示します。

図1‒3　BS2500のハードウェア構成例

マシンの機種が他社PC/AT互換機の場合のハードウェア構成例について次の図に示します。

図1‒4　他社PC/AT互換機のハードウェア構成例

(a)　共有ディスク

不要です。

(b)　ローカルディスク

系間で共有しない系固有のディスク装置として使用します。SAP HANAや，HAモニタ kitをインストールするディスクと，SAP HANAのデータを格納するためのディスクがそれぞれの系に必要です。

(c)　LAN

SAP HANAのクライアントからデータベースに接続するために使用します。

1.3.2　必要なソフトウェア

ここでは，HAモニタ kitを使用してSAP HANAの系切り替え構成を実現するためのソフトウェア構成について説明します。

(1)　ソフトウェア構成

ソフトウェア構成を次の図に示します。

図1‒5　ソフトウェア構成図

(a)　カーネル

Linux(x86)

システムの基盤となるオペレーティングシステムです。

(b)　系切り替え制御

HAモニタ

系切り替えを制御します。

HAモニタ kit

HAモニタのオプション製品です。SAP HANAのクラスタ環境をHAモニタで実現するための製品です。

(c)　サーバプログラム

SAP HANA

SAP社のインメモリデータベース管理システムです。HAモニタではモニタモードのサーバとして管理されます。

1.4　HAモニタとの関係

HAモニタ kitは，HAモニタのオプション製品です。このマニュアルでは，HAモニタ kitに特化した内容だけを記載しています。このため，HAモニタについてはマニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編を参照し，HAモニタ kit固有の部分についてだけこのマニュアルを参照してください。

また，メッセージについては，HAモニタ kit固有のメッセージはこのマニュアルを，HAモニタ固有のメッセージはマニュアル高信頼化システム監視機能 HAモニタ メッセージを参照してください。

このマニュアルとHAモニタシリーズのマニュアルの対応を，次の図に示します。

図1‒6　このマニュアルとHAモニタシリーズのマニュアルの対応

2　システムの管理

この章では，HAモニタ kitを使用したシステムで，HAモニタがサーバをどのように管理しているかについて説明します。HAモニタ kitを使用したシステムの動作の詳細についても説明します。なお，系や共有リソースの管理については，マニュアル「高信頼化システム監視機能 HAモニタ Linux(R)（x86）編」の「システムの管理」の説明を参照してください。

2.1　サーバの管理

HAモニタ kitを使用することで，HAモニタは稼働中のサーバ（SAP HANAインスタンス）を監視し，SAP HANAの障害を検出できます。ここでは，障害検出の仕組みや検出できる障害の種類について説明します。

2.1.1　障害検出の仕組み

HAモニタ kitを使用したシステムでは，サーバの監視コマンドで実行サーバ（SAP HANAインスタンス）を監視し，そのサーバの監視コマンドのプロセスをHAモニタが監視して障害を検出します。障害を検出すると，HAモニタの設定に従って，HAモニタが系切り替えして業務を続行します。

サーバの監視コマンドによる障害検出の流れを，次の図に示します。

図2‒1　サーバの監視コマンドによる障害検出の流れ

HAモニタ kitが提供するサーバの監視コマンドでは，SAP HANAインスタンスのスローダウンやプロセスの生存を監視します。

監視方法は，制御用定義ファイルに設定します。制御用定義ファイルの設定については，「(2)　制御用定義ファイルの設定」を参照してください。

2.1.2　検出できる障害の種類

ここでは，HAモニタ kitを使用したシステムで検出できる障害の種類について説明します。

(1)　HAモニタ kitが検出する障害

HAモニタ kitは，次の表に示すSAP HANAの障害を検出できます。

表2‒1　HAモニタ kitが検出する障害

検出する障害

説明

SAP HANAインスタンスの障害

次の状態をSAP HANAインスタンスの障害として検出します。

SAP HANAインスタンスのプロセス状態の異常

SAP HANAの構成がMDCの場合，SAP HANAインスタンスのプロセス全体を監視し，異常を検知します。

障害を検出するとメッセージを出力して系切り替えします。

SQLによるデータベースの問い合わせ異常

障害を検出するとメッセージを出力して系切り替えします。

SQLによるSAP HANAインスタンスの状態異常

定期的にSQLを実行することによって，SAP HANAインスタンスの状態を監視します。SQLによって状態監視をするかどうかは，インスタンス制御用定義ファイルのDB_NOACCESSパラメタ，およびUSERSTORE_KEY_LISTパラメタで指定します。SAP HANAの構成がMDCの場合，複数のDBに対してSQLによる状態監視ができます。その場合は，インスタンス制御用定義ファイルのUSERSTORE_KEY_LISTパラメタに，対象としたいDBのアクセスキーを列挙してください。USERSTORE_KEY_LISTパラメタに，対象としたいDBのアクセスキーを列挙すると，一つのDBに対してSQLの実行，および応答を確認したあと，次のDBに対して状態監視をします。複数のDBのうち，どれか一つの異常を検知した時点で，系切り替えを開始します。

SAP HANAインスタンスのスローダウン

SQLによる問い合わせ応答が一定時間ない状態を，SAP HANAインスタンスのスローダウンとして検出します。

障害を検出するとメッセージを出力して系切り替えします。

System Replicationの障害

System Replicationのステータスが正常でない場合，System Replicationの障害として検出します。

障害を検出するとメッセージを出力します。系切り替えはしません。

SystemReplicationの異常を検知した場合，制御用定義ファイルFULLSYNC_AUTO_DISABLEパラメタの定義に従って，完全同期オプションを無効にしたり，有効のままにしたりできます。完全同期オプションを無効にする場合は，KAMK00355メッセージが出力されます。System Replicatonの状態が正常になったあとで，予備系のSAP HANAインスタンスを停止すると，停止した理由に関係なく，定期的にメッセージが出力されます。メッセージが出力される間隔は，サーバ対応の環境設定のptrlcmd_ex_interオペランドの指定値によって異なります。例えば，サーバ対応の環境設定のptrlcmd_ex_interオペランドに10を指定した場合は，約1時間間隔でメッセージが出力されます。サーバ対応の環境設定のptrlcmd_ex_interオペランドに5を指定した場合は，約30分間隔でメッセージが出力されます。System Replicationの状態が正常になると，メッセージは出力されなくなります。

(2)　HAモニタが検出する障害

次の表に示すSAP HANAの障害は，HAモニタ kitではなくHAモニタが検出します。

表2‒2　HAモニタが検出する障害

検出する障害

説明

ネットワーク（業務用のLAN）障害

HAモニタのLANの監視機能を用いて検出します。LANの監視機能については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のLANの監視および障害時の自動系切り替えの説明を参照してください。

系障害

HAモニタがaliveメッセージの途絶によって検出します。系障害の検出についてはマニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編の系障害の検出を参照してください。

2.2　処理の流れ

ここでは，HAモニタおよびHAモニタ kitがする処理の流れについて，すべての共有リソースを含めて説明します。

ここで説明する処理の流れでは，HAモニタおよびHAモニタ kitが出力するメッセージID，ならびに発行するイベントIDを記載しています。どのタイミングでメッセージIDやイベントIDが発行されるかを調べるときにお読みください。また，ユーザコマンドを実行するタイミング，およびユーザコマンドに渡される引数も記載しています。ユーザコマンド作成時の参考にしてください。

系切り替え構成での運用の流れと，ここで説明する内容との対応を次の図に示します。

図2‒2　系切り替え構成での運用の流れと，処理の流れで説明する内容の対応

注※1　サーバの起動に失敗した場合の処理の流れについては，「2.2.2　サーバの起動失敗時の処理の流れ」を参照してください。

注※2　系障害時の系切り替え処理については「高信頼化システム監視機能 HA モニタ Linux(R)（x86）編」を参照してください。

2.2.1　サーバの起動処理の流れ

サーバ（SAP HANAインスタンス）の起動時に，HAモニタおよびHAモニタ kitがする処理の流れについて説明します。

(1)　プライマリSAP HANAインスタンスの起動処理の流れ

プライマリSAP HANAインスタンス起動時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒3　プライマリSAP HANAインスタンスの起動処理の流れ

注※　HAモニタが，サーバの起動コマンドを実行します。

(2)　セカンダリSAP HANAインスタンスの起動処理の流れ

セカンダリSAP HANAインスタンス起動時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒4　セカンダリSAP HANAインスタンスの起動処理の流れ

注※　ＨＡモニタが，待機サーバの起動コマンドを実行します。

2.2.2　サーバの起動失敗時の処理の流れ

サーバ（SAP HANAインスタンス）の起動失敗時に，HAモニタおよびHAモニタ kitがする処理の流れについて説明します。

(1)　プライマリSAP HANAインスタンスの起動失敗時の処理の流れ

プライマリSAP HANAインスタンスの起動失敗時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒5　プライマリSAP HANAインスタンスの起動失敗時の処理の流れ

注※　HAモニタが，サーバの起動コマンドを実行します。

(2)　セカンダリSAP HANAインスタンスの起動失敗時の処理の流れ

セカンダリSAP HANAインスタンスの起動失敗時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒6　セカンダリSAP HANAインスタンスの起動失敗時の処理の流れ

注※1　HAモニタが，待機サーバの起動コマンドを実行します。

注※2　HAモニタが，待機サーバの停止コマンドを実行します。

(3)　プライマリSAP HANAインスタンスの起動タイムアウト時の処理の流れ

プライマリSAP HANAインスタンスが起動時にタイムアウト※した場合にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

注※

HAモニタ kitが提供する起動コマンドから実行するSAP HANAのコマンド（HDB start）の機能によるタイムアウトです。HDB startについては，SAP HANAのドキュメントを参照してください。

図2‒7　プライマリSAP HANAインスタンスの起動タイムアウト時の処理の流れ

注※　HAモニタが，サーバの起動コマンドを実行します。

(4)　セカンダリSAP HANAインスタンスの起動タイムアウト時の処理の流れ

セカンダリSAP HANAインスタンスが起動時にタイムアウト※した場合にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

注※

HAモニタ kitが提供する起動コマンドから実行するSAP HANAのコマンド（HDB start）の機能によるタイムアウトです。HDB startについては，SAP HANAのドキュメントを参照してください。

図2‒8　セカンダリSAP HANAインスタンスの起動タイムアウト時の処理の流れ

注※1　HAモニタが，待機サーバの起動コマンドを実行します。

注※2　HAモニタが，待機サーバの停止コマンドを実行します。

2.2.3　サーバの停止処理の流れ

サーバ（SAP HANAインスタンス）の停止時に，HAモニタおよびHAモニタ kitがする処理の流れについて説明します。

(1)　プライマリSAP HANAインスタンスの停止処理の流れ

プライマリSAP HANAインスタンスの停止時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒9　プライマリSAP HANAインスタンスの停止処理の流れ

注※　HAモニタが，サーバの停止コマンドを実行します。

(2)　セカンダリSAP HANAインスタンスの停止処理の流れ

セカンダリSAP HANAインスタンスの停止時にHAモニタおよびHAモニタ kitがする処理の流れ（monendコマンドを実行する場合）を次の図に示します。

図2‒10　セカンダリSAP HANAインスタンスの停止処理の流れ（monendコマンドを実行する場合）

注※1　HAモニタが，サーバの停止コマンドを実行します。

注※2　HAモニタが，待機サーバの停止コマンドを実行します。

セカンダリSAP HANAインスタンスの停止時にHAモニタおよびHAモニタ kitがする処理の流れ（monsbystpコマンドを実行する場合）を次の図に示します。待機サーバの停止コマンド（monsbystpコマンド）で予備系の待機サーバだけを停止すると，現用系でSystem Replicationの障害を検知します。予備系のメンテナンスなどで待機サーバを停止する必要がある場合以外は，待機サーバだけの停止はしないでください。

図2‒11　セカンダリSAP HANAインスタンスの停止処理の流れ（monsbystpコマンドを実行する場合）

注※　HAモニタが，待機サーバの停止コマンドを実行します。

2.2.4　サーバの監視処理の流れ

サーバ（SAP HANAインスタンス）の監視時に，HAモニタおよびHAモニタ kitがする処理の流れについて説明します。

(1)　プライマリSAP HANAインスタンスの監視処理の流れ

プライマリSAP HANAインスタンスの監視時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒12　プライマリSAP HANAインスタンスの監視処理の流れ

注※1　HAモニタが，サーバの監視コマンドを実行します。

注※2　HAモニタが，サーバ対応の環境設定のptrlcmd_ex_interオペランドの間隔でSAP HANAインスタンスの監視を実行します。

(2)　セカンダリSAP HANAインスタンスの監視処理の流れ

セカンダリSAP HANAインスタンスの監視時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒13　セカンダリSAP HANAインスタンスの監視処理の流れ

注※1　HAモニタが，待機サーバの監視コマンドを実行します。

注※2　HAモニタが，サーバ対応の環境設定のsby_ptrlcmd_ex_interの間隔でSAP HANAインスタンスの監視を実行します。

2.2.5　サーバ障害時の処理の流れ

サーバ（SAP HANAインスタンス）の障害が発生した場合に，HAモニタおよびHAモニタ kitがする処理の流れについて説明します。

(1)　プライマリSAP HANAインスタンス障害時の系切り替え処理の流れ

プライマリSAP HANAインスタンス障害時にHAモニタおよびHAモニタ kitがする系切り替え処理の流れを次の図に示します。

図2‒14　プライマリSAP HANAインスタンス障害時の系切り替え処理の流れ

注※1　HAモニタが，サーバの監視コマンドを実行します（サーバ対応の環境設定のptrlcmd_exオペランドで指定する場合）。

注※2　HAモニタが，サーバの停止コマンドを実行します。

注※3　HAモニタが，サーバの起動コマンドを実行します。

予備系のSAP HANAインスタンスが実行サーバとして起動完了となったあと（系切り替え後）の監視

予備系のSAP HANAインスタンスが実行サーバとして起動完了となったあと（系切り替え後）は，予備系だけで稼働を継続します。予備系だけで稼働しているときは現用系の監視と同じ監視をします（プロセス監視，SQLによる問い合わせ応答監視，およびSystem Replicationの障害監視）。

予備系だけで稼働している状態でSAP HANAインスタンスの障害を検知した場合

予備系だけで稼働している状態でSAP HANAインスタンスの障害を検知すると，メッセージ（KAMK00348-E）を出力して，SAP HANAインスタンスを停止しないで監視を停止します。

再び予備系だけで稼働させる場合は，予備系のサーバをいったん停止して障害の対処をしたあと，再度，予備系のサーバを起動してください。予備系のサーバを起動すると，実行サーバの起動待ち状態となります。そのとき，待ち状態のサーバ起動コマンド（monactコマンド）を実行し，予備系のサーバを実行サーバとして起動してください。

予備系に系切り替えしたあとに，再度系切り替えが可能な状態にする場合

予備系に系切り替えしたあとに，再度系切り替えが可能な状態にするには，現用系でモニタモードのサーバの起動コマンド（monbeginコマンド）を実行し，サーバを起動してください。

現用系でサーバを起動すると待機サーバとして起動します。待機サーバとして起動すると，System Replicationでデータが同期されます。

ただし，System Replicationでのデータの同期中に実行サーバの障害を検知すると，同期が不完全な状態で系切り替えをします。これを防ぐには，データを完全に同期させたあとで，現用系，および予備系のサーバを起動してください。

(2)　セカンダリSAP HANAインスタンス障害時の処理の流れ

セカンダリSAP HANAインスタンスの障害時は，セカンダリSAP HANAインスタンスを停止します。

セカンダリSAP HANAインスタンス障害時にHAモニタおよびHAモニタ kitがする処理の流れを次の図に示します。

図2‒15　セカンダリSAP HANAインスタンス障害時の処理の流れ

注※1　HAモニタが，待機サーバの監視コマンドを実行します。

注※2　HAモニタが，待機サーバの停止コマンドを実行します。

3　システムの設計と構築

この章では，システムの設計と構築，および環境設定例について説明します。システムの設計では，HAモニタ kitを業務システムに導入するに当たり，検討することについて説明します。システムの構築では，HAモニタ kitを組み込んだシステムの構築手順，HAモニタ kit のディレクトリ構成，および構築に必要な設定項目の対応と設定の概要（環境設定例を含む）について説明します。

3.1　システムの設計

HAモニタ kitを使用した系切り替え構成を構築する前に，HAモニタのシステムの設計が必要です。HAモニタのシステムの設計については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のHAモニタの導入とシステムの設計の説明を参照してください。

ここでは，SAP HANAをモニタモードのサーバとして管理することと共有リソースについて説明します。

3.1.1　SAP HANAの構成と切り替え単位

HAモニタは，サーバ単位で系切り替えをします。HAモニタ kitの制御対象となるSAP HANAインスタンスとサーバを対応させます。

このマニュアルで対象としている構成（「1.2.1　SAP HANAの構成」参照）では，プライマリSAP HANAインスタンス用のサーバと，セカンダリSAP HANAインスタンス用のサーバとします。

プライマリSAP HANAインスタンス用のサーバは実行サーバ，セカンダリSAP HANAインスタンス用のサーバは待機サーバに対応します。

3.1.2　リソースの構成

ここでは，SAP HANAが使用するリソースで，HAモニタが制御するものについて説明します。

(1)　リソースとサーバとの対応

SAP HANAの系切り替え構成で，HAモニタが切り替える必要があるリソースと，サーバとの対応について次に示します。

クライアント接続用のIPアドレス（エイリアスIP アドレス）

クライアントがデータベースに接続するためのエイリアスIPアドレスは，プライマリSAP HANAインスタンスに対応するサーバの，LANの状態設定ファイルに定義します。

系切り替え時は，プライマリSAP HANAインスタンスに対応するサーバが，予備系にエイリアスIPアドレスを引き継ぎます。引き継がれたエイリアスIPアドレスは，セカンダリSAP HANAインスタンスがプライマリ化されたあと，使用できます。

3.2　システムの構築

ここでは，システムの構築について説明します。システムの構築は，スーパユーザの権限で行ってください。系を追加する場合の手順など，HAモニタ kitを使用しないHAモニタのシステムと共通の部分については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のシステムの構築の説明を参照してください。

なお，ここでは，システム構築の前提となるハードウェアはすでに構成されているものとして説明します。

3.2.1　構築の流れ

ここでは，HAモニタ kitを使用して，SAP HANAインスタンスをHAモニタのサーバとして設定する場合の構築の流れについて説明します。マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編の構築の流れの説明中の，サーバを追加する場合の設定を，ここに記載されている構築の流れに置き換えて読んでください。

ここで説明する作業は，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編の構築の流れの説明の，系を追加する場合の設定が完了したあとに，システム管理者がスーパユーザの権限で実施します。

システムの構築の流れを，次の図に示します。

図3‒1　システム構築の流れ

このマニュアルとマニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編を併読して設定してください。

3.2.2　ディレクトリ構成

HAモニタ kitをインストールすると，/opt/hitachiの下にHAモニタ kitのディレクトリHAmonHANAが作成されます。

HAモニタ kitをインストールしたあとのディレクトリ構成を，次の図に示します。

図3‒2　ディレクトリ構成

重要

HAモニタ kitのディレクトリのうち，/opt/hitachi/HAmonHANA/bin（コマンドファイル用ディレクトリ）にあるファイルは編集しないでください。

3.2.3　構築に必要な設定項目の対応と設定の概要

ここでは，HAモニタ kitを使用したシステムを設定するに当たり，理解しておきたい設定項目の対応と設定の概要について説明します。

システム内の設定の関連を，次の図に示します。

図3‒3　構築に必要な設定項目の対応と設定の概要

図に示した設定の対応について説明します。番号は，図中の番号と対応しています。

SAP HANAの設定です。

HA モニタの環境設定です。

サーバ対応の環境設定です。

LANの状態設定ファイルです。

SAP HANAのクライアント接続用IPアドレスを切り替え制御するために作成します。設定方法は「(1)　LANの状態設定ファイルの設定」を参照してください。

SAP HANAインスタンス制御用定義ファイルです。

HAモニタ kitで提供するサンプルファイルをHAモニタの環境設定ディレクトリにコピーして，内容を編集します。設定方法は「(2)　制御用定義ファイルの設定」を参照してください。

SAP HANAインスタンス用の制御コマンドです。

HAモニタ kitで提供するサンプルファイルをHAモニタの環境設定ディレクトリにコピーします。

LAN監視定義ファイルです。

LANの通信可否による系切り替え制御機能を使用する場合に作成します。詳細については，マニュアル「高信頼化システム監視機能 HAモニタ Linux(R)（x86）編」の「LANの通信可否による系切り替え制御機能」および「LANの監視に必要なファイルの設定」を参照してください。

LAN監視スクリプトです。

LANの通信可否による系切り替え制御機能を使用する場合に作成します。詳細については，マニュアル「高信頼化システム監視機能 HAモニタ Linux(R)（x86）編」の「LANの通信可否による系切り替え制御機能」および「LANの監視に必要なファイルの設定」を参照してください。

3.2.4　SAP HANAのインストールと構築

SAP HANAのインストール方法，SAP HANAの設定と構築についてはSAP HANAのドキュメントを参照してください。また，必要に応じて，SAP HANAシステムの購入元にも相談してください。

ここでは，HAモニタ kitでクラスタ構成とする場合の注意事項を示します。

(1)　インスタンスの自動起動設定

SAP HANAインスタンスの自動起動を有効化しないでください。HAモニタの管理下では，HAモニタのコマンドで起動します。

3.2.5　SAP HANAのインスタンスが使用する共有リソースの設定

SAP HANAのインストールと構築が完了したら， SAP HANAインスタンスが使用する共有リソースを設定します。

(1)　LANの状態設定ファイルの設定

SAP HANAクライアント接続用のIPアドレスをHAモニタで切り替えができるように，プライマリSAP HANAインスタンスのサーバにLANの状態設定ファイルを作成します。詳細については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のLANの状態設定ファイルの設定を参照してください。

3.2.6　HAモニタ kitの設定

SAP HANAのインスタンスが使用する共有リソースの設定が完了したら，HAモニタ kitの設定をします。HAモニタ kitの設定には，サーバの起動・停止・監視コマンドの設定，および制御用定義ファイルの設定があります。

(1)　コマンドの設定

"/opt/hitachi/HAmon/etc/HAmonHANA_etc"ディレクトリ配下に"repli"ディレクトリを作成します。作成したrepliディレクトリにHAモニタ kitが提供する，HAモニタのサーバの起動コマンド，停止コマンド，監視コマンドをコピーします。

現用系の手順と予備系の手順は同じです。

"/opt/hitachi/HAmon/etc/HAmonHANA_etc"ディレクトリに移動します。

# cd /opt/hitachi/HAmon/etc/HAmonHANA_etc

repliディレクトリを作成します。

# mkdir repli

repliディレクトリにHAモニタ kitが提供するサンプルをコピーします。

# cp -pr /opt/hitachi/HAmonHANA/lib/repli/shell/* /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli

(2)　制御用定義ファイルの設定

HAモニタ kitが制御するSAP HANAインスタンスごとに，制御用定義ファイルを設定する必要があります。HAモニタ kitが提供する制御用定義ファイルのサンプルファイルを，次の手順でコピーしてください。現用系の手順と予備系の手順は同じです。

コピーする際は，コピー先の設定済みのファイルを誤って上書きして消去しないように注意してください。

# cp -p /opt/hitachi/HAmonHANA/lib/repli/hanains.env /opt/hitachi/HAmon/etc/HAmonHANA_etc/env

現用系と予備系の制御定義ファイルの例を次に示します。

現用系と予備系の違いは，SECONDARY_ALIASパラメタとPRIMARY_HOSTパラメタだけです。

サンプルファイルは，SAP HANA の構成がMDCであることを想定しています。

現用系の制御用定義ファイルの内容

INSTANCE_NUMBER=10
HANA_SID=HIT
HANA_USER=hitadm
DB_NOACCESS=no
USERSTORE_KEY_LIST="HITSTOREKEY TENANT1"
PATROL=120
SQL_PATROL_ACTION=switch
SECONDARY_ALIAS=SiteA
PRIMARY_HOST=SiteB
REPLICATION_MODE=sync
OPERATION_MODE=delta_datashipping
FULLSYNC_AUTO_DISABLE=no

予備系の制御用定義ファイルの内容

INSTANCE_NUMBER=10
HANA_SID=HIT
HANA_USER=hitadm
DB_NOACCESS=no
USERSTORE_KEY_LIST="HITSTOREKEY TENANT1"
PATROL=120
SQL_PATROL_ACTION=switch
SECONDARY_ALIAS=SiteB
PRIMARY_HOST=SiteA
REPLICATION_MODE=sync
OPERATION_MODE=delta_datashipping
FULLSYNC_AUTO_DISABLE=no

次のパラメタについては，SAP HANAを設定した環境に応じた値に必ず変更してください。パラメタの詳細は，「表3-1　制御用定義ファイルのパラメタ一覧」を参照してください。

INSTANCE_NUMBER

HANA_SID

HANA_USER

SECONDARY_ALIAS

PRIMARY_HOST

次に，ファイルの詳細について説明します。

(a)　記述形式

パラメタを「パラメタ名=値」の形式で1行に一つずつ記述します。パラメタ，イコール（=），および値の前後に空白を記述しないでください。なお，パラメタの記述は順不同です。

任意の環境変数を設定したい場合は，「環境変数名=値」の形式で1行に一つずつ記述します。

(b)　パラメタの詳細

指定できるパラメタの詳細について，次に示します。

表3‒1　制御用定義ファイルのパラメタ一覧

パラメタ名

説明

INSTANCE_NUMBER

制御対象のSAP HANAインスタンスのインスタンス番号を指定します。インスタンス番号の詳細についてはSAP HANAのドキュメントを参照してください。このパラメタは必ず指定してください。

HANA_SID

SAP HANA システムID（システムの識別子）を指定します。システムIDの詳細についてはSAP HANAのドキュメントを参照してください。このパラメタは必ず指定してください。

HANA_USER

システム管理ユーザ（システムのインストール時に登録されたオペレーティングシステムユーザ）のアカウント（<sid>adm）を指定します。ユーザの詳細についてはSAP HANAのドキュメントを参照してください。このパラメタは必ず指定してください。

DB_NOACCESS

SQLを使用してSAP HANAインスタンスへアクセスするかを指定します。パラメタを省略した場合はnoを仮定します。次の運用をする場合はyesを指定してください。

HAモニタ kit for SAP HANAがDBへアクセスするのを禁止したい場合

yes：

SQLによるSAP HANAインスタンスにアクセスをしません。監視処理はSAP HANAインスタンスのSQL応答監視は行わないで，プロセスの生存監視だけになります。

no：

SQLによるSAP HANAインスタンスのアクセスをして，SAP HANAインスタンスのSQL応答監視とプロセスの生存監視をします。

USERSTORE_KEY_LIST

SQLの応答監視をする場合に，SAP HANAインスタンスへのアクセスキーを指定してください。SAP HANAの構成がMDCの場合，SYSTEMDBへのアクセスキー，および監視をしたいテナントDBへのアクセスキーを指定してください。複数のアクセスキーを指定する場合は，値全体をダブルクォーテーションで囲って，アクセスキーごとに半角スペースで区切ってください。このパラメタを省略した場合は，HITSTOREKEYを仮定します。アクセスキーについての詳細は，SAP HANAのドキュメントを参照してください。

PATROL

SAP HANAインスタンスにアクセスしてから，無応答と見なすまでの時間を指定します。SAP HANAの構成がMDCの場合は，このパラメタに指定した時間に従って，USERSTORE_KEY_LISTパラメタに指定したSYSTEMDBおよびテナントDBの無応答を監視します。

無応答と見なすまでの時間を秒単位で60秒～3600秒の範囲で指定します。

なお，DB_NOACCESSパラメタにyesを指定した場合，このパラメタに指定した値は無視されます。

DB_NOACCESSパラメタにnoを指定した場合，またはDB_NOACCESSパラメタを省略した場合，このパラメタは必ず指定してください。

SQL_PATROL_ACTION

SQL応答監視で応答がなかった場合に，系切り替えするかどうかを指定します。パラメタを省略した場合はswitchを仮定します。DB_NOACCESSパラメタにyesを指定した場合，このパラメタに指定した値は無視されます。

no_switch：

SQLの無応答を検知した場合，メッセージ出力だけ行って，系切り替えせずに監視を続行します。

switch ：

SQLの無応答を検知した場合，系切り替えします。

SECONDARY_ALIAS

待機サーバ起動時にSystem Replicationのセカンダリシステムの設定で使用するセカンダリのエイリアスを指定します。このパラメタはSAP HANAのセカンダリとして登録するコマンド（hdbnsutil -sr_register）の--nameに指定する値です。このパラメタは必ず指定してください。

PRIMARY_HOST

待機サーバ起動時にSystem Replicationのセカンダリシステムの設定で使用するプライマリのホストを指定します。このパラメタはSAP HANAのセカンダリとして登録するコマンド（hdbnsutil -sr_register）の--remoteHostに指定する値です。このパラメタは必ず指定してください。

REPLICATION_MODE

待機サーバ起動時にSystem Replicationのセカンダリシステムの設定で使用するログレプリケーションモードを指定します。このパラメタはSAP HANAのセカンダリとして登録するコマンド（hdbnsutil -sr_register）の--replicationModeに指定する値です。詳細はSAP HANAのドキュメントを参照してください。このパラメタを省略した場合は，syncmemが選択されます。

OPERATION_MODE

待機サーバ起動時にSystem Replicationのセカンダリシステムの設定で使用する操作モードを指定します。このパラメタはSAP HANAのセカンダリとして登録するコマンド（hdbnsutil -sr_register）の--operationModeに指定する値です。詳細はSAP HANAのドキュメントを参照してください。このパラメタを省略した場合は，delta_datashippingが選択されます。

FULLSYNC_AUTO_DISABLE

System Replicationの障害検知時に完全同期オプションを無効にするかどうかを指定します。完全同期オプションを有効にして使用する場合は，業務の続行を優先とするか，現用系と予備系のデータの同期を優先とするかを考慮して設定してください。

System Replicationの障害時に完全同期オプションが有効のままだと，レプリケーションできないため業務が続行できなくなります。業務を続行したい場合はyesを指定してください。

yes：

System Replicationの障害検知時に完全同期オプションを無効にします。

no：

System Replicationの障害検知時に完全同期オプションを無効にしません。

このパラメタを省略した場合は，noが選択されます。

(3)　コマンドと制御用定義ファイルの確認

必要なファイルが，「(1)　コマンドの設定」，および「(2)　制御用定義ファイルの設定」の手順でコピーできたことを確認します。

次のファイルがあることを確認してください。

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_pri

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_pri

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_pri

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_sec

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_sec

/opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_sec

3.2.7　定義ファイルの作成

HAモニタkitの設定が完了したら，HAモニタの環境設定（sysdef），HAモニタのサーバ対応の環境設定（servers）およびLAN監視定義ファイルを作成します。作成方法については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のHAモニタの環境設定（sysdef），サーバ対応の環境設定（servers）およびLAN監視定義ファイルの設定の説明を参照してください。

(1)　HAモニタの環境設定（sysdef）

HAモニタの環境設定のオペランドで注意が必要なものについて，次の表に示します。

表3‒2　注意が必要なHAモニタの環境設定のオペランド

オペランド名

注意事項

monbegin_restart

nouseを指定してください。

clearwait

マシンの機種がHA8000 RS440/Nモデル以降では，ハードウェアに付属のドキュメントに指定された値を指定してください。

clearcheck

マシンの機種がHA8000 RS440/Nモデル以降では，ハードウェアに付属のドキュメントに指定された値を指定してください。

(a)　現用系の例

現用系のHAモニタの環境設定（sysdef）の例を，次に示します。

environment    name               host1,
               address            1,
               patrol             60,
               lan                #path1:path2,
               lanport            HAmon1:HAmon2;

function       cpudown            online,
               pathpatrol         240,
               connect_retry      5:200,
               monbegin_restart   nouse;
               fence_reset※      nouse,
               fence_scsi※       nouse,
               fence_lan※        use,
               lanfailswitch※    use,
               lancheck_patrol※  15,

注※

LANの通信可否による系切り替え制御機能を使用する場合に必要です。

(b)　予備系の例

予備系のHAモニタの環境設定（sysdef）の例を，次に示します。

environment    name               host2,
               address            2,
               patrol             60,
               lan                #path1:path2,
               lanport            HAmon1:HAmon2;

function       cpudown            online,
               pathpatrol         240,
               connect_retry      5:200,
               monbegin_restart   nouse;
               fence_reset※      nouse,
               fence_scsi※       nouse,
               fence_lan※        use,
               lanfailswitch※    use,
               lancheck_patrol※  15,

注※

LANの通信可否による系切り替え制御機能を使用する場合に必要です。

(2)　サーバ対応の環境設定（servers）

サーバ対応の環境設定のオペランドで注意が必要なものについて，次の表に示します。

表3‒3　注意が必要なサーバ対応の環境設定のオペランド

オペランド名

注意事項

name

「3.2.6　HAモニタ kitの設定」でコピーした実行サーバの起動コマンドを，絶対パスで指定します。

acttype

monitorを指定します。

termcommand

「3.2.6　HAモニタ kitの設定」でコピーした実行サーバの停止コマンドを，絶対パスで指定します。

servexec_retry

0を指定してください。

ptrlcmd_ex

「3.2.6　HAモニタ kitの設定」でコピーした実行サーバの監視コマンド実行シェルを，絶対パスで指定します。

waitserv_exec

yesを指定してください。

start_timeout

指定しないでください。

stop_timeout

指定しないでください。

sby_actcommand

「3.2.6　HAモニタ kitの設定」でコピーした待機サーバの起動コマンドを，絶対パスで指定します。

sby_termcommand

「3.2.6　HAモニタ kitの設定」でコピーした待機サーバの停止コマンドを，絶対パスで指定します。

sby_ptrlcmd_ex

「3.2.6　HAモニタ kitの設定」でコピーした待機サーバの監視コマンド実行シェルを，絶対パスで指定します。

sby_servexec_retry

指定しないでください。

sby_start_timeout

指定しないでください。

sby_stop_timeout

指定しないでください。

(a)　現用系の例

現用系のサーバ対応の環境設定（servers）の例を，次に示します。

予備系との違いは，initialだけです。

server name            /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_pri,
       alias           hanasv,
       acttype         monitor,
       initial         online,
       termcommand     /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_pri,
       ptrlcmd_ex      /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_pri,
       ptrlcmd_ex_inter  10,
       lan_updown      use,
       waitserv_exec   yes,
       servexec_retry  0,
       sby_actcommand  /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_sec,
       sby_termcommand /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_sec,
       sby_ptrlcmd_ex  /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_sec,
       sby_ptrlcmd_ex_inter  10;
       switch_judge※  bond0,
       switchbyfail※  bond0,

注※

LANの通信可否による系切り替え制御機能を使用する場合に必要です。

(b)　予備系の例

予備系のサーバ対応の環境設定（servers）の例を，次に示します。

現用系との違いは，initialだけです。

server name            /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_pri,
       alias           hanasv,
       acttype         monitor,
       initial         standby,
       termcommand     /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_pri,
       ptrlcmd_ex      /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_pri,
       ptrlcmd_ex_inter  10,
       lan_updown      use,
       waitserv_exec   yes,
       servexec_retry  0,
       sby_actcommand  /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/actcommand_sec,
       sby_termcommand /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/termcommand_sec,
       sby_ptrlcmd_ex  /opt/hitachi/HAmon/etc/HAmonHANA_etc/repli/patrolcommand_sec,
       sby_ptrlcmd_ex_inter  10;
       switch_judge※  bond0,
       switchbyfail※  bond0,

注※

LANの通信可否による系切り替え制御機能を使用する場合に必要です。

(3)　LAN監視定義ファイル

HAモニタのLAN監視定義ファイルの設定例を示します。

(a)　現用系の例

現用系のHAモニタのLAN監視定義ファイルの例を，次に示します。

192.168.0.110
192.168.0.101

(b)　予備系の例

予備系のHAモニタのLAN監視定義ファイルの例を，次に示します。

192.168.0.100
192.168.0.101

3.2.8　構築したシステムの動作確認

システムの構築が完了して設定と定義のチェックに問題がなかったら，構築システムの動作確認をしてください。ここでは，HAモニタ kitを使用したシステムで，特に確認しておきたい点についてだけ説明します。システムの動作確認の流れや詳細については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編の構築したシステムの動作確認の説明を参照してください。

(1)　サーバの動作確認

HAモニタ kitを使用する上で必要な，サーバの起動・停止・監視確認について説明します。

サーバの起動・停止・監視コマンドが出力するメッセージ※は，サーバログに出力されます。サーバログについては，「4.3　サーバログの確認」を参照してください。

注※

サーバの起動・停止・監視コマンドの延長で実行されるSAP HANAのコマンドの，標準出力・標準エラー出力も含みます。

(a)　サーバの起動確認

HAモニタ kitのサーバログを基に，次のことを確認します。

該当するSAP HANAインスタンスに対してメッセージKAMK00342-Iが出力されている。

メッセージが出力されていない場合，コマンドの設定や制御用定義ファイルの設定手順に誤りがあるおそれがあります。コマンドの設定や制御用定義ファイルの設定については「3.2.6　HAモニタ kitの設定」を参照してください。

(b)　サーバの停止確認

HAモニタ kitのサーバログを基に，次のことを確認します。

該当するSAP HANAインスタンスに対してメッセージKAMK00345-Iが出力されている。

メッセージが出力されていない場合，コマンドの設定や制御用定義ファイルの設定手順に誤りがあるおそれがあります。コマンドの設定や制御用定義ファイルの設定については「3.2.6　HAモニタ kitの設定」を参照してください。

(c)　サーバの監視確認

HAモニタ kitのサーバログを基に，次のことを確認します。

SAP HANAインスタンスに対応するサーバについてメッセージKAMK00421-Iが出力されている。

メッセージが出力されていない場合，コマンドの設定や制御用定義ファイルの設定手順に誤りがあるおそれがあります。コマンドの設定や制御用定義ファイルの設定については「3.2.6　HAモニタ kitの設定」を参照してください。

(2)　系切り替えのテスト

HAモニタ kitを使用する上で必要な，系切り替えのテストについて説明します。

(a)　計画系切り替えの確認／サーバ障害時の自動系切り替えの確認

系切り替えが成功したあとに切り替え先の系で，HAモニタ kitのサーバログを基に，次のことを確認します。

該当するSAP HANAインスタンスに対してメッセージKAMK00342-Iが出力されている。

メッセージが出力されていない場合，コマンドの設定や制御用定義ファイルの設定手順に誤りがあるおそれがあります。コマンドの設定や制御用定義ファイルの設定については「3.2.6　HAモニタ kitの設定」を参照してください。

4　システムの運用

この章では，構築したシステムの運用に関する内容のうち，SAP HANAインスタンスの起動・停止方法，計画系切り替えの方法，障害が発生した場合の対処方法について説明します。このマニュアルに記載がないシステムの運用に関する内容については，マニュアル「高信頼化システム監視機能 HAモニタ Linux(R)（x86）編」の「システムの運用」を参照してください。

4.1　運用の流れ

HAモニタ kitを使用した系切り替え構成のSAP HANAインスタンスは，HA モニタのモニタモードのサーバとして運用します。HAモニタのモニタモードのサーバの運用については，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編の運用の流れの説明も参照してください。

このマニュアルで対象としている構成（「1.2.1　SAP HANAの構成」参照）では，プライマリSAP HANAインスタンス用のサーバと，セカンダリSAP HANAインスタンス用のサーバがあります。

プライマリSAP HANAインスタンス用のサーバは実行サーバ，セカンダリSAP HANAインスタンス用のサーバは待機サーバに対応します。

4.2　SAP HANAインスタンスの起動・停止・計画系切り替え

ここでは，HAモニタ kitを使用したシステムのSAP HANAインスタンスの起動・停止・計画系切り替えについて説明します。SAP HANAインスタンスは，モニタモードのサーバとして管理されます。このため，SAP HANAインスタンスの起動・停止・計画系切り替えは，HAモニタのコマンドで実施します。

なお，HAモニタのサーバとして稼働中のSAP HANAインスタンスは，必ずHAモニタのコマンドで起動・停止してください。HAモニタ kitを使用した系切り替え構成のSAP HANAインスタンスをHAモニタのコマンド以外で起動・停止すると，HAモニタが障害を検出して系切り替えする場合があります。

4.2.1　SAP HANAインスタンスの起動

SAP HANAインスタンスを起動するには，モニタモードのサーバ起動コマンド（monbeginコマンド）を実行します。モニタモードのサーバ起動コマンド（monbeginコマンド）は，HAモニタの運用コマンドです。

このコマンドについては，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のmonbegin（モニタモードのサーバの起動）の説明を参照してください。

SAP HANAでは，データをSystem Replicationで同期します。System Replicationで動作する場合は，先にプライマリSAP HANAインスタンスを起動し，次にセカンダリSAP HANAインスタンスを起動するようにします。

なお，サーバ起動コマンドを実行する前に，必ず，現用系でプライマリSAP HANAインスタンス，予備系でセカンダリSAP HANAインスタンスが起動できる状態にしてください。

サーバの起動順序を次の図に示します。

図4‒1　サーバの起動順序

システムの起動の前に完全同期オプションが有効になっていると，実行サーバの起動に失敗する場合があります。実行サーバの起動を失敗させないようにするには，システムの起動前に完全同期オプションを無効にしてください。

4.2.2　SAP HANAインスタンスの停止

SAP HANAインスタンスを停止するには，モニタモードのサーバ停止コマンド（monendコマンド）を実行します。モニタモードのサーバ停止コマンド（monendコマンド）は，HAモニタの運用コマンドです。

このコマンドについては，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のmonend（モニタモードのサーバの停止）の説明を参照してください。

System Replicationによるデータの同期を完了してから停止するため，先にプライマリSAP HANAインスタンスを停止し，次にセカンダリSAP HANAインスタンスを停止するようにします。

サーバの停止順序を次の図に示します。

図4‒2　サーバの停止順序

待機サーバを先に停止すると，次の事象が発生する場合があります。

System Replicationのデータ同期が行われないで，現用系のデータと予備系のデータが不一致になります。データが不一致の状態で停止した場合，次回の起動時に現用系と予備系のどちらが最新のデータとなっているかを確認して，最新のデータの系で実行サーバを起動してください。

現用系でSystem Replicationの監視エラーを検出します。

完全同期オプションを使用している場合，実行サーバが正常に停止できなくなります。実行サーバを正常に停止させるには，あらかじめ完全同期オプションを無効にしてください。

4.2.3　計画系切り替え

手動で系切り替えを行い，予備系のSAP HANAインスタンスで業務を継続することができます。これを計画系切り替えといいます。

計画系切り替えによって，現用系のSAP HANAインスタンスを停止して，予備系のSAP HANAインスタンスをプライマリSAP HANAインスタンスとして稼働させます。

計画系切り替えをするには，サーバの系切り替えコマンド（monswapコマンド）を実行します。サーバの系切り替えコマンド（monswapコマンド）は，HAモニタの運用コマンドです。

このコマンドについては，マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編のmonswap（サーバの系切り替え）の説明を参照してください。

計画系切り替えの操作は現用系で行います。

図4‒3　計画系切り替えの手順

4.2.4　システムの再待機

予備系に系切り替え（旧セカンダリをプライマリ化）したあとは，HAモニタの管理下で現用系をセカンダリとして待機させる（旧プライマリをセカンダリ化）ことができます。

予備系に系切り替えしたあとに再度系切り替え可能状態にするには，現用系でモニタモードのサーバの起動コマンド（monbegin）を実行し，サーバを起動してください。

現用系でサーバを起動すると待機サーバとして起動します。待機サーバとして起動すると，旧プライマリをセカンダリ化して起動するため，System Replicationによってデータが同期されます。ただし，同期中にプライマリの障害を検知すると，同期が途中の状態で系切り替えをするため，データが古い状態で業務を開始します。これを防ぐには，予備系でモニタモードのサーバの停止コマンド（monend）を実行し，HAモニタの管理外としてください。そのあと，SAP HANAのコマンドで同期を行ったあとで，モニタモードのサーバの起動コマンド（monbegin）を実行し，HAモニタの管理下に置いてください。

図4‒4　システムの再待機の手順

4.2.5　システムの切り戻し

システムの切り戻しをする場合は現用系でシステムの再待機をしたあと，予備系でサーバの系切り替えコマンド（monswapコマンド）を実行します。計画系切り替えをしたあとは，現用系の障害に備えて予備系でシステムの再待機をします。

図4‒5　システムの切り戻しの手順

4.2.6　システムの起動（完全同期オプションを使用する場合）

完全同期オプションを使用する場合，実行サーバと待機サーバが起動完了したあとに，完全同期オプションを有効化するSAP HANAのコマンドを実行する必要があります。

図4‒6　システムの起動（完全同期オプションを使用する場合）の手順

4.2.7　システムの計画系切り替え（完全同期オプションを使用する場合）

完全同期オプションを使用する場合，現用系から予備系に切り替え後に現用系で再待機してから，予備系で完全同期オプションを有効化するSAP HANAのコマンドを実行する必要があります。

図4‒7　システムの計画系切り替え（完全同期オプションを使用する場合）の手順

4.3　サーバログの確認

HAモニタ kitは，サーバの起動・停止・監視コマンドが出力するメッセージをサーバログに出力します。サーバの起動・停止・監視コマンドの中で実行するSAP HANAのコマンドなどの標準出力・標準エラー出力も，サーバログに出力されます。サーバログを確認することで，サーバの起動・停止・監視コマンドの処理の結果を調査できます。システムの運用中は，監視処理の結果によって，サーバログの内容は常に更新されます。

重要

サーバの稼働中にサーバログを確認する場合は参照だけとし，保存しないでください。参照中に出力されたログ情報が，失われるおそれがあります。

4.3.1　ファイルの種類

サーバログの一覧を，次の表に示します。このマニュアルの手順に従って設定した場合，ファイル名の「サーバ識別名」の部分は，hanasvです。

ファイル名

説明

/opt/hitachi/HAmon/spool/サーバ識別名.hanalog

サーバログのファイルです。サーバの起動・停止・監視コマンドが出力するメッセージの内容が出力されます。

/opt/hitachi/HAmon/spool/サーバ識別名.hanalog_old

1世代前のサーバログのファイルです。次に示すタイミングでサーバログのファイルが指定サイズを超えた場合に，サーバログのファイル名の末尾に"_old"を付けてリネームされ，作成されます。

サーバの起動・停止・監視コマンドの実行時

サーバの監視コマンド内で監視処理を実行する直前

/opt/hitachi/HAmon/spool/サーバ識別名.hanalog_err

直近のエラー発生時のサーバログのファイルです。サーバの起動・停止・監視コマンドが0以外の戻り値で終了する場合に，サーバログのファイル名の末尾に"_err"を付けてリネームされ，作成されます。障害調査をする場合は，このファイルを参照してください。

4.3.2　ファイルサイズ

サーバログのファイルサイズは，デフォルトでは，1,048,576バイト（1メガバイト）です。通常はデフォルトのファイルサイズのまま運用します。変更の必要はありません。

4.3.3　出力例

サーバログの出力例を次の図に示します。ここで示す例は，SAP HANAインスタンスの起動に失敗した場合の出力内容です。

図4‒8　出力例

次に，図中の番号について説明します。

HAモニタ kitのコマンドが出力するメッセージです。メッセージの出力日時やIDなどが出力されます。出力例では，メッセージKAMK00401-Iなどが出力されています。HAモニタ kitが出力するメッセージの詳細については，「5.2　メッセージの詳細」を参照してください。

HAモニタ kitがSAP HANAの操作をした結果，SAP HANAが出力したメッセージや，サーバの起動・停止・監視コマンドによって出力されたメッセージです。この行に出力されるメッセージについては，SAP HANAのドキュメントなどを参照してください。

4.3.4　メッセージの言語環境

サーバログに出力されるSAP HANAのメッセージの言語は，制御定義ファイルのHANA_USERパラメタに設定したユーザの言語環境（LANG）に依存します。

デフォルトでは，LANGにen_US.UTF-8が設定されていますので，英語で出力されます。

4.4　System Replicationの障害を検知した場合の対処

System Replicationの障害を検知した場合，HAモニタ kitではKAMK00354-Wを出力します。メッセージが出力された場合は，System Replicationの状態を確認してください。必要に応じて，System Replicationに障害が発生した原因を取り除いて，データの同期をしてください。FULLSYNC_AUTO_DISABLEパラメタにyesを指定した場合，KAMK00354-Wのあとに続けてKAMK00355-Iを出力して，完全同期オプションを無効にします。データの同期をしたあと，必要に応じて完全同期オプションを有効にしてください。FULLSYNC_AUTO_DISABLEパラメタを省略またはnoを指定し，完全同期オプションを有効にしている場合，データの同期ができないため，業務が継続できなくなります。業務を継続する場合は完全同期オプションを無効にしてください。

データの同期ができない場合，プライマリの障害などでデータの同期がされない状態で系切り替えすることを防ぐため，待機サーバを停止することをお勧めします。ただし，データの同期よりも業務の継続を優先する場合は，待機サーバを停止する必要はありません。

4.5　障害への対処

障害の対処方法は，HAモニタのマニュアルを参照してください。

また，サーバの起動・停止・監視コマンドが出力するメッセージ※は，サーバログに出力されます。サーバログを基に，障害の要因の調査を行い，障害を取り除いてください。

サーバログについては，「4.3　サーバログの確認」を参照してください。

注※

サーバの起動・停止・監視コマンドの延長で実行されるSAP HANAのコマンドの，標準出力・標準エラー出力も含みます。

5　メッセージ

この章では，HAモニタ kitが出力するメッセージについて説明します。

5.1　メッセージの形式

メッセージの形式について説明します。

5.1.1　メッセージの出力形式

出力されるメッセージの形式を次に示します。

KAMKnnnnn-i xx....xx

KAMKnnnnn-i：メッセージID

xx....xx：メッセージテキスト

サーバログに出力されるメッセージには，メッセージIDの前に，出力日時が"yyyy/mm/dd HH:MM:SS"の形式で付与されます。

5.1.2　メッセージの記述形式

(1)　記述形式

このマニュアルでのメッセージの記述形式を次に示します。

KAMKnnnnn-i（X）

Message text

メッセージの意味について説明します。

aa....aa：可変値について説明します。

S：

システムがメッセージを出力したあとにする，主な処理を示します。

O：

メッセージ確認後，オペレータがする処理を示します。

対策：

メッセージ確認時のシステム管理者の処置を示します。

なお，「O：」や「対策：」に記載されている「保守員に連絡してください。」とは，購入時の契約に基づいて，システム管理者が弊社問い合わせ窓口へ連絡することを示します。

(2)　メッセージIDの記号の説明

メッセージIDの記号の意味を次に示します。

KAMK：

HAモニタ kitのメッセージであることを示します。

nnnnn：

メッセージの通し番号を示します。

i：

メッセージの種類を示します。

E：

・各ライブラリ，コマンド，サーバの機能が働かない障害が発生したことを示しています。

・定義誤り，コマンドのオペランド指定誤りによって，動作できないことを示しています。

W：

コマンドの動作状況などについての警告を示しています。

I：

E，およびWに該当しないメッセージで，単純に動作を示しています。

（X）：

メッセージの出力先種別を示します。

（P）：サーバログファイル

（L）：メッセージログファイル（syslog）

一つのメッセージが，複数の出力先を持つ場合は，出力先種別を"＋"でつないで記載します。

5.2　メッセージの詳細

HAモニタ kitのメッセージの詳細について説明します。

KAMK00120-E（P＋L）

The file aa....aa contains errors. Parameter : bb....bb

aa....aaに示す制御用定義ファイル内の，bb....bbに示すパラメタの指定方法が誤っています。

aa....aa：ファイル名

bb....bb：パラメタ名

S：

処理を終了します。

対策：

「(2)　制御用定義ファイルの設定」を参照して，パラメタ名に示すパラメタの誤りを修正してください。

KAMK00130-E（P＋L）

The file aa....aa does not exist.

aa....aaに示す制御用定義ファイルが存在しません。

aa....aa：ファイル名

S：

処理を終了します。

対策：

コマンドの引数に指定したインスタンスのインスタンス制御用の定義ファイル名が正しいか確認してください。正しい場合はファイル名を確認し，ファイルが存在しない場合は「(2)　制御用定義ファイルの設定」を参照して作成してください。

KAMK00341-I（P）

SAP HANA instance aa....aa will now start.

インスタンス番号で示すSAP HANA インスタンスを起動します。

aa....aa：インスタンス番号

S：

処理を続行します。

KAMK00342-I（P）

SAP HANA instance aa....aa has started.

インスタンス番号で示すSAP HANA インスタンスの起動が完了しました。

aa....aa：インスタンス番号

S：

処理を続行します。

KAMK00343-E（P＋L）

An attempt to start SAP HANA instance aa....aa has failed.

インスタンス番号で示すSAP HANAインスタンスの起動に失敗しました。

aa....aa：インスタンス番号

S：

処理を終了します。

O：

サーバログに出力されている内容を基に原因を調査してください。

KAMK00344-I（P）

SAP HANA instance aa....aa will now stop.

インスタンス番号で示すSAP HANAインスタンスを停止します。

aa....aa：インスタンス番号

S：

処理を続行します。

KAMK00345-I（P）

SAP HANA instance aa....aa has stopped.

インスタンス番号で示すSAP HANAインスタンスの停止が完了しました。

aa....aa：インスタンス番号

S：

処理を続行します。

KAMK00346-E（P＋L）

An attempt to stop SAP HANA instance aa....aa has failed.

インスタンス番号で示すSAP HANAインスタンスの停止に失敗しました。

aa....aa：インスタンス番号

S：

処理を終了します。

O：

サーバログに出力されている内容を基に原因を調査してください。

KAMK00348-E（P＋L）

An error was detected in SAP HANA instance aa....aa(bb....bb).

SAP HANAインスタンスの状態確認によって，インスタンス番号で示すSAP HANAインスタンスの異常を検知しました。

aa....aa：インスタンス番号

bb....bb：DBへのアクセスキーまたは-（ハイフン）。SQLの応答がエラーの場合は，DBへのアクセスキーが表示されます。プロセスの監視で異常を検知した場合はハイフンが表示されます。

S：

処理を続行します。

対策：

SAP HANAのログを確認し，異常を検知した原因を取り除いてください。

KAMK00349-E（P＋L）

An attempt to issue a SQL request to SAP HANA instance aa....aa(bb....bb) timed out.

SAP HANAインスタンスの状態確認によって，インスタンス番号で示すSAP HANAインスタンスのSQLの無応答を検知しました。

aa....aa：インスタンス番号

bb....bb：DBへのアクセスキー

S：

処理を続行します。

対策：

SAP HANAのログを確認し，異常を検知した原因を取り除いてください。

KAMK00350-W（P）

SAP HANA instance aa....aa could not be terminated.

インスタンス番号で示すSAP HANAインスタンスを正常停止できませんでした。

aa....aa：インスタンス番号

S：

処理を続行します。

KAMK00354-W（P＋L）

A system replication error was detected for the SAP HANA instance aa....aa. details:bb....bb

インスタンス番号で示すSAP HANAインスタンスのSystem Replicationの異常を検知しました。

aa....aa：インスタンス番号

bb....bb：詳細コード

S：

処理を続行します。

O：

System Replicationの状態を確認してください。必要に応じて障害の原因を取り除いてデータの同期をしてください。データの同期ができない場合，プライマリの障害などでデータの同期がされない状態で系切り替えするのを防ぐため，待機サーバを停止することをお勧めします。ただし，業務の継続を優先する場合は待機サーバを停止する必要はありません。

KAMK00355-I（P＋L）

The full sync option SAP HANA system replication will now be disabled for SAP HANA instance aa....aa.

FULLSYNC_AUTO_DISABLEパラメタの設定によって，業務を継続します。インスタンス番号で示すSAP HANAインスタンスのSystem Replicationの完全同期オプションを無効にします。

aa....aa：インスタンス番号

S：

処理を続行します。

O：

System Replicationの状態を確認してください。必要に応じて障害の原因を取り除いて，データを同期してください。また，完全同期オプションを有効にしてください。

KAMK00356-E（P）

User name:aa....aa does not exist in system.

ユーザ名に示すユーザがシステムに存在しません。

aa....aa：ユーザ名

S：

処理を中断します。

O：

インスタンス制御用の定義ファイルの，システム管理ユーザの設定が正しいかを確認してください。正しい場合は，システムにシステム管理ユーザが存在することを確認してください。

KAMK00401-I（P）

********** The actcommand start. **********

サーバの起動コマンドが実行されたことを示します。

S：

処理を続行します。

KAMK00402-I（P）

********** The actcommand end. (aa....aa) **********

サーバの起動コマンドの実行が終了したことを示します。

aa....aa：サーバの起動コマンドの戻り値

S：

処理を続行します。

対策：

戻り値が0以外の場合は，サーバの起動コマンド内の設定内容とサーバログを調査してください。

KAMK00411-I（P）

********** The termcommand start. **********

サーバの停止コマンドが実行されたことを示します。

S：

処理を続行します。

KAMK00412-I（P）

********** The termcommand end. (aa....aa) **********

サーバの停止コマンドの実行が終了したことを示します。

aa....aa：サーバの停止コマンドの戻り値

S：

処理を続行します。

対策：

戻り値が0以外の場合は，サーバの停止コマンド内の設定内容とサーバログを調査してください。

KAMK00421-I（P）

********** The patrolcommand start. **********

サーバの監視コマンドが実行されたことを示します。

S：

処理を続行します。

KAMK00422-I（P）

********** The patrolcommand end. (aa....aa) **********

サーバの監視コマンドの実行が終了したことを示します。

aa....aa：サーバの監視コマンドの戻り値

S：

処理を続行します。

対策：

戻り値が0以外の場合は，サーバの監視コマンド内の設定内容とサーバログを調査してください。

KAMK00423-E（P＋L）

An error was detected during monitoring process. The patrolcommand will now stop.

サーバの監視コマンド内の監視処理で異常を検知したため監視コマンドを終了します。

S：

処理を終了します。

対策：

サーバログに出力された内容を基に原因を調査してください。

KAMK00601-E（P＋L）

An error occurred in the aa....aa system call. Error details : bb....bb Functional name : cc....cc

HA モニタ kitの関数内で発行したシステムコールでエラーが発生しました。詳細コードについては，対応するOS のマニュアルを参照してください。

aa....aa：発行したシステムコール

bb....bb：詳細コード（1～3桁）

cc....cc：エラーが発生した関数名

S：

処理を続行します。

O：

システム管理者に連絡してください。

対策：

詳細コードを基に原因を調査してください。

付録

付録A　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録A.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

マニュアル高信頼化システム監視機能 HAモニタ Linux(R)（x86）編（3000-9-140）

マニュアル高信頼化システム監視機能 HAモニタ メッセージ（3000-9-134）

付録A.2　このマニュアルで使用する製品名・機能名

このマニュアルでは，製品名を次のように表記しています。

表記

製品名

HA モニタ kit

HA モニタ kit for SAP HANA

Linux

Linux(R)

Linux

Linux（x86）

Red Hat(R) Enterprise Linux(R) Server7(x86_64)

Red Hat(R) Enterprise Linux(R) Server8(x86_64)

付録A.3　このマニュアルで使用する英略語

このマニュアルで使用する英略語を，次に示します。

英略語

英字での表記

DB

Database

HA

High Availability

LAN

Local Area Network

MDC

SAP HANA Multitenant Database Containers

OS

Operating System

UTF-8

8-bit UCS Transformation Format

付録A.4　このマニュアルで使用するKB（キロバイト）などの単位表記

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

索引

A

acttype[1]

C

clearcheck[1]

clearwait[1]

D

DB_NOACCESS[1]

F

FULLSYNC_AUTO_DISABLE[1]

H

HANA_SID[1]

HANA_USER[1]

HAモニタ[1]

HAモニタ kit[1]

HAモニタとの関係[1]

構成[1]

設定[1]

必要なソフトウェア[1]

必要なハードウェア[1]

目的[1]

HAモニタ kitの概要[1]

HAモニタ kitの設定

コマンドの設定[1]

制御用定義ファイルの設定[1]

I

INSTANCE_NUMBER[1]

L

LAN[1]

LAN監視定義ファイル[1]

M

monbegin_restart[1]

N

name[1]

O

OPERATION_MODE[1]

P

PATROL[1]

PRIMARY_HOST[1]

R

REPLICATION_MODE[1]

S

SAP HANA[1]

インストールと構築[1]

構成と切り替え単位[1]

SAP HANAインスタンス

起動[1]

計画系切り替え[1]

システムの起動（完全同期オプションを使用する場合）[1]

システムの切り戻し[1]

システムの計画系切り替え（完全同期オプションを使用する場合）[1]

システムの再待機[1]

停止[1]

sby_actcommand[1]

sby_ptrlcmd_ex[1]

sby_servexec_retry[1]

sby_start_timeout[1]

sby_stop_timeout[1]

sby_termcommand[1]

SECONDARY_ALIAS[1]

servexec_retry[1]

SQL_PATROL_ACTION[1]

start_timeout[1]

stop_timeout[1]

System Replicationの障害を検知した場合の対処[1]

T

termcommand[1]

U

USERSTORE_KEY_LIST[1]

W

waitserv_exec[1]

う

運用の流れ[1]

き

共有ディスク[1]

け

系[1]

系切り替え構成での運用の流れ[1]

系切り替えのテスト[1]

さ

サーバ[1]

サーバ構成と役割[1]

サーバの管理[1]

サーバの動作確認[1]

サーバの監視確認[1]

サーバの起動確認[1]

サーバの停止確認[1]

サーバログの一覧[1]

サーバログの確認[1]

サーバログの出力例[1]

サーバログのファイルサイズ[1]

し

システム構成[1]

システムの管理[1]

システムの構築[1]

SAP HANAの構築[1]

構築に必要な設定項目の対応と設定の概要[1]

構築の流れ[1]

動作確認[1]

システムの設計[1]

システムの動作確認[1]

障害検出[1]

HAモニタ kitが検出する障害[1]

HAモニタが検出する障害[1]

SAP HANAインスタンスの障害[1]

SAP HANAインスタンスのスローダウン[1]

System Replicationの障害[1]

系障害[1]

ネットワーク（業務用のLAN）障害[1]

障害の対処方法[1]

処理の流れ[1]

サーバ障害時の系切り替え処理の流れ[1]

サーバの監視処理の流れ[1]

サーバの起動失敗時の処理の流れ[1]

サーバの起動処理の流れ[1]

サーバの停止処理の流れ[1]

セカンダリSAP HANAインスタンス障害時の系切り替え処理の流れ[1]

セカンダリSAP HANAインスタンスの監視処理の流れ[1]

セカンダリSAP HANAインスタンスの起動失敗時の処理の流れ[1]

セカンダリSAP HANAインスタンスの起動処理の流れ[1]

セカンダリSAP HANAインスタンスの起動タイムアウト時の処理の流れ[1]

セカンダリSAP HANAインスタンスの停止処理の流れ[1]

プライマリSAP HANAインスタンス障害時の系切り替え処理の流れ[1]

プライマリSAP HANAインスタンスの監視処理の流れ[1]

プライマリSAP HANAインスタンスの起動失敗時の処理の流れ[1]

プライマリSAP HANAインスタンスの起動処理の流れ[1]

プライマリSAP HANAインスタンスの起動タイムアウト時の処理の流れ[1]

プライマリSAP HANAインスタンスの停止処理の流れ[1]

せ

制御用定義ファイルの設定[1]

制御用定義ファイルのパラメタ[1]

DB_NOACCESS[1]

FULLSYNC_AUTO_DISABLE[1]

HANA_SID[1]

HANA_USER[1]

INSTANCE_NUMBER[1]

OPERATION_MODE[1]

PATROL[1]

PRIMARY_HOST[1]

REPLICATION_MODE[1]

SECONDARY_ALIAS[1]

SQL_PATROL_ACTION[1]

USERSTORE_KEY_LIST[1]

そ

ソフトウェア構成[1]

て

定義ファイルの作成[1]

ディレクトリ構成[1]

と

動作環境[1]

は

ハードウェア構成例

BS2500のハードウェア構成例[1]

HA8000/RS440のハードウェア構成例[1]

め

メッセージIDの記号の説明[1]

メッセージの記述形式[1]

メッセージの言語環境[1]

メッセージの出力形式[1]

り

リソースの構成[1]

ろ

ローカルディスク[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号