SAP HANAシステムレプリケーションのスケールアップ - パフォーマンス最適化シナリオ #

SAPHanaSRリソースエージェントソフトウェアパッケージでは、スケールアップ（シングルボックスからシングルボックスへ）システムレプリケーションを、以下の構成とパラメータに限定してサポートします。

少なくともSAPHanaSRバージョン0.153が必要で、SUSE Linux Enterprise Server for SAP Applications 15 SP1以降が最善です。SAP HANA 1.0は、SPS09 (095)以降に定義されているすべての設定でサポートされています。SAP HANA 2.0は、すべての既知のSPSバージョンでサポートされています。

重要

有効なSTONITH手段がない場合は、クラスターのすべてはサポートされないため、正しく動作しません。

別のシナリオを実装する必要がある場合は、SUSEと共にPoC（概念実証）を規定することを強くお勧めします。PoCは、そのシナリオにおける既存ソリューションのテストに焦点を当てます。上記の制限を付けた理由は、慎重にテストする必要があるためです。

SAP HANAの他に、SAPホストエージェントをシステムにインストールする必要があります。

本ドキュメントは、クラスターを設定して、システムレプリケーションシナリオにおいてSAP HANAを制御する方法を説明します。このドキュメントでは、すでにインストールされて稼働しているSAP HANAをシステムレプリケーションと統合する手順に焦点を当てています。

ここで説明している設定例では、Walldorf（WDF）とRot（ROT）にある2つのデータセンターで、2つのSLES for SAP 15 SP1システムにインストールされたSAP HANA HAクラスターを構築します。

図 7: SAP HANA SRを使用したクラスター - パフォーマンス最適化 #

 

クラスターの設定は、YaSTウィザードを使用することも、手動で行うことも、また、所有されている自動化機能を利用することもできます。

YaSTウィザードを使用する場合は、ショートカットyast sap_haからモジュールを起動することができます。YaSTを使用してSAPHanaSRを設定する手順については、SUSE Linux Enterprise Server for SAP Applicationsの製品ドキュメントのセクションSAP HANAクラスターを設定するに記載されており、https://documentation.suse.com/sles-sap/15-SP1/single-html/SLES4SAP-guide/#cha-s4s-clusterから入手できます。

図 8: YaST Module sap_haでのSAP HANAのシナリオ選択 #

 

本ガイドは、クラスターの手動による設定に焦点を当てて詳細を説明し、独自の自動化機能を構築できるよう支援します。

設定手順は以下のように主に7段階に分かれています。

SAP HANAクラスターを正しく設定するには、インストレーションの計画が不可欠です。

事前に用意するものは以下のとおりです。

4.1 ラボの最小要件と前提条件 #

 

注記

ここで説明しているラボの最小要件は、SAPのサイジング情報ではありません。これらのデータは、ここで述べたクラスターをテスト目的でラボに再構築するためにのみ提供されます。たとえテストであっても、そのシナリオによっては要件が増える場合があります。本稼働システムについては、ハードウェアベンダーに問い合わせるか、公式のSAPサイジングツールやサービスをご利用ください。

注記

許容されるストレージ構成とファイルシステムについては、SAP HANA TDIドキュメントを参照してください。

サイトごとに1つのSAPインスタンスが必要 (1 : 1) - マジョリティメーカーなし（2ノードクラスター）:

• 各々32GB RAMを備えた2つのVM、システムに対して50GBのディスク容量

• 10MBのディスク空き容量を備えたSBD用の共有ディスク1台

• SAP HANA用に各々96GB容量のデータディスク2台（各サイト1台）

• テイクオーバー用の1つの追加IPアドレス

• 読み取り可能な設定用の1つのオプションIPアドレス

• HAWK管理GUI用の1つのオプションIPアドレス

サイトごとに1つのSAPインスタンスが必要 (1 : 1) - マジョリティメーカー有（3ノードクラスター）:

• 各々32GB RAMを備えた2つのVM、システムに対して50GBのディスク空き容量

• 2GB RAMを備えた1つのVM、システムに対して50GBのディスク空き容量

• SAP HANA用に各々96GB容量のデータディスク2台（各サイト1台）

• テイクオーバー用の1つの追加IPアドレス

• Read-enabled設定用の1つのオプションIPアドレス

• HAWK管理GUI用の1つのオプションIPアドレス

このセクションには、OSのインストール中に考慮すべき情報が含まれています。

本ドキュメントのスコープでは、最初にSUSE Linux Enterprise Server for SAP Applicationsをインストールして構成します。次に、システムレプリケーションを含むSAP HANAデータベースを設定します。最後に、クラスターを伴う自動化を設定して構成します。

本ドキュメントでは、インストール済みのSAP HANAと、すでにPacemakerクラスターに設定されているシステムレプリケーションとの統合に焦点を当てていますが、この章では、テスト環境の概要を説明します。SAP HANAをインストールしたり、システムレプリケーションを設定する際は、必ずSAPの公式ドキュメントを参照してください。

suse02:ha1adm> HDB info
USER          PID     PPID  ... COMMAND
ha1adm      13017    ... -sh
ha1adm      13072    ...  \_ /bin/sh /usr/sap/HA1/HDB10/HDB info
ha1adm      13103    ...      \_ ps fx -U ha1adm -o user:8,pid:8,ppid:8,pcpu:5,vsz:10,rss:10,args
ha1adm       9268    ... hdbrsutil  --start --port 31003 --volume 2 --volumesuffix mnt00001/hdb00002.00003 --identifier 1580897137
ha1adm       8911    ... hdbrsutil  --start --port 31001 --volume 1 --volumesuffix mnt00001/hdb00001 --identifier 1580897100
ha1adm       8729    ... sapstart pf=/hana/shared/HA1/profile/HA1_HDB10_suse02
ha1adm       8738    ...  \_ /usr/sap/HA1/HDB10/suse02/trace/hdb.sapHA1_HDB10 -d -nw -f /usr/sap/HA1/HDB10/suse02/daemon.ini pf=/usr/sap/HA1/SYS/profile/HA1_HDB10_suse02
ha1adm       8756    ...      \_ hdbnameserver
ha1adm       9031    ...      \_ hdbcompileserver
ha1adm       9034    ...      \_ hdbpreprocessor
ha1adm       9081    ...      \_ hdbindexserver -port 31003
ha1adm       9084    ...      \_ hdbxsengine -port 31007
ha1adm       9531    ...      \_ hdbwebdispatcher
ha1adm       8574    ... /usr/sap/HA1/HDB10/exe/sapstartsrv pf=/hana/shared/HA1/profile/HA1_HDB10_suse02 -D -u ha1adm

詳細については、SAP HANA管理ガイドのシステムレプリケーションの設定セクションをご覧ください。

実行手順

7.1 プライマリデータベースをバックアップする #

 

SAP HANA管理ガイドのSAP HANAデータベースのバックアップとリカバリーセクションの説明に従って、プライマリデータベースをバックアップします。SQLコマンドを使用した例を示します。これらのバックアップコマンドは、バックアップインフラストラクチャに適合させて使用する必要があります。

例 2: 1回のバックアップコールでシステムデータベースとすべてのテナントを簡単にバックアップする #

 

<sidadm>ユーザーとして、次のコマンドを入力します。

hdbsql -u SYSTEM -d SYSTEMDB \
   "BACKUP DATA FOR FULL SYSTEM USING FILE ('backup')"

以下の（または同様の）コマンド出力が表示されます。

0 rows affected (overall time 15.352069 sec; server time 15.347745 sec)

例 3: 単一コンテナ（非MDC）データベースの単純なバックアップ #

 

<sidadm>ユーザーとして、以下のコマンドをとして入力します。

hdbsql -i <instanceNumber> -u <dbuser> \
   "BACKUP DATA USING FILE ('backup')"

重要

有効なバックアップがない場合は、SAP HANAをシステムレプリケーション構成にすることができません。

7.2 プライマリノードを有効にする #

 

Linux の<sid>adm ユーザーとして、プライマリノードでシステムレプリケーションを有効にします。サイト名（例: WDF）を定義する必要があります。このサイト名は、システムレプリケーションを介して接続されているすべてのSAP HANAデータベースで一意にしなければなりません。したがって、セカンダリは異なるサイト名にしてください。

注記

「primary」や「secondary」 などの文字列はサイト名に使用しないでください。

例 4: #

 

-sr_enableオプションを使用してプライマリを有効にします。

suse01:~> hdbnsutil -sr_enable --name=WDF
checking local nameserver:
checking for active nameserver ...
nameserver is running, proceeding ...
configuring ini files ...
successfully enabled system as primary site ...
done.

例 5: プライマリを有効にする #

 

hdbnsutil -sr_stateConfigurationコマンドを使用して、プライマリのSR構成を確認します。

suse01:~> hdbnsutil -sr_stateConfiguration --sapcontrol=1
SAPCONTROL-OK: <begin>
mode=primary
site id=1
site name=WDF
SAPCONTROL-OK: <end>
done.

モードが「none」から「primary」 に変更され、サイトにサイト名とサイトIDが追加されました。

suse02:~> HDB stop

cd /usr/sap/<SID>/SYS/global/security/rsecssfs
rsync -va {,<node1-siteB>:}$PWD/data/SSFS_<SID>.DAT
rsync -va {,<node1-siteB>:}$PWD/key/SSFS_<SID>.KEY

...
suse02:~> hdbnsutil -sr_register --name=ROT \
     --remoteHost=suse01 --remoteInstance=10 \
     --replicationMode=sync --operationMode=logreplay
adding site ...
checking for inactive nameserver ...
nameserver suse02:30001 not responding.
collecting information ...
updating local ini files ...
done.

suse02:~> HDB start
...
suse02:~> hdbnsutil -sr_stateConfiguration --sapcontrol=1
SAPCONTROL-OK: <begin>
mode=sync
site id=2
site name=ROT
active primary site=1
primary masters=suse01
SAPCONTROL-OK: <end>
done.

suse01:~> HDBSettings.sh systemReplicationStatus.py --sapcontrol=1
...
site/2/SITE_NAME=ROT1
site/2/SOURCE_SITE_ID=1
site/2/REPLICATION_MODE=SYNC
site/2/REPLICATION_STATUS=ACTIVE
site/1/REPLICATION_MODE=PRIMARY
site/1/SITE_NAME=WDF1
local_site_id=1
...

この手順は、セカンダリの同期が失われた場合に、直ちにクラスターに通知する際に必須になります。このフックは、セカンダリが非同期になった時点で、HA/DRプロバイダーインタフェースを使用してSAP HANAによって呼び出されます。一般的には、最初のコミット保留が解除されたケースに該当します。システムレプリケーションが復帰したときに、SAP HANAによってフックが再び呼び出されます。

実行手順

sapcontrol -nr <instanceNumber> -function StopSystem

[ha_dr_provider_SAPHanaSR]
provider = SAPHanaSR
path = /usr/share/SAPHanaSR
execution_order = 1

[trace]
ha_dr_saphanasr = info

[system_replication]
operation_mode = logreplay

# SAPHanaSR-ScaleUp entries for writing srHook cluster attribute
<sidadm> ALL=(ALL) NOPASSWD: /usr/sbin/crm_attribute -n hana_<sid>_site_srHook_*

# SAPHanaSR-ScaleUp entries for writing srHook cluster attribute
Cmnd_Alias SOK_SITEA   = /usr/sbin/crm_attribute -n hana_<sid>_site_srHook_<siteA> -v SOK   -t crm_config -s SAPHanaSR
Cmnd_Alias SFAIL_SITEA = /usr/sbin/crm_attribute -n hana_<sid>_site_srHook_<siteA> -v SFAIL -t crm_config -s SAPHanaSR
Cmnd_Alias SOK_SITEB   = /usr/sbin/crm_attribute -n hana_<sid>_site_srHook_<siteB> -v SOK   -t crm_config -s SAPHanaSR
Cmnd_Alias SFAIL_SITEB = /usr/sbin/crm_attribute -n hana_<sid>_site_srHook_<siteB> -v SFAIL -t crm_config -s SAPHanaSR
<sidadm> ALL=(ALL) NOPASSWD: SOK_SITEA, SFAIL_SITEA, SOK_SITEB, SFAIL_SITEB

この章では、SUSE Linux Enterprise Server for SAP ApplicationsとSAP HANA Database Integrationの一部である、SUSE Linux Enterprise High Availability Extensionクラスターソフトウェアの構成について解説します。

9.1 基本的なクラスター構成 #

 

最初のステップは、基本的なクラスターフレームワークを設定することです。便宜上、YaST2またはha-cluster-initスクリプトを使用してください。2番目のCorosysncリングを追加し、UCAST通信に変更して、環境に合わせてタイムアウト値を調整することを強くお勧めします。

9.1.1 「ストレージベースフェンシング」のウォッチドッグを設定する #

 

SBDフェンシングメカニズム（ディスクレスまたはディスクベース）を使用する場合は、ウォッチドッグも設定する必要があります。ウォッチドッグは、システムがSBD（ディスクレスまたはディスクベース）にアクセスできなくなった場合に、ノードをリセットするために必要になります。ウォッチドッグドライバーをロードするようにLinuxシステムを構成することが必須になります。hpwdt、iTCO_wdtなどの、ハードウェアの#アシスタンスト（ほとんどの最新システムで利用可能）を備えたウォッチドッグを使用することを強くお勧めします。次善の策として、softdogモジュールを使用できます。

例 15: ウォッチドッグに対する設定 #

 

重要

ウォッチドッグタイマーへのアクセス: 他のソフトウェアがウォッチドッグタイマーにアクセスすることはできません。常に1つのプロセスだけがアクセスできます。一部のハードウェアベンダーは、システムリセットにウォッチドッグを使用するシステム管理ソフトウェアを提供しています（例: HP ASRデーモン）。ウォッチドッグをSBDで使用する場合は、このようなソフトウェアを無効にする必要があります。

最適なウォッチドッグモジュールを選択します。または、カーネルバージョンと共にインストールされているドライバーのリストを調べる方法もあります。

ls -l /lib/modules/$(uname -r)/kernel/drivers/watchdog

ウォッチドッグモジュールがすでにロードされているかどうかを確認します。

lsmod | egrep "(wd|dog|i6|iT|ibm)"

結果が表示された場合は、システムにはウォッチドッグがすでにロードされています。そのウォッチドッグがウォッチドッグデバイスに対応していない場合は、そのモジュールをアンロードする必要があります。

モジュールを安全にアンロードするには、まずアプリケーションがウォッチドッグデバイスを使用しているかどうかを確認します。

lsof /dev/watchdog
rmmod <wrong_module>

ウォッチドッグモジュールを有効にして永続化します。以下の例ではsoftdogが使われていますが、いくつか制約がありますので他のオプションを優先してください。

echo softdog > /etc/modules-load.d/watchdog.conf
systemctl restart systemd-modules-load

ウォッチドッグモジュールが正しくロードされていることを確認します。

lsmod | grep dog
ls -l /dev/watchdog

ウォッチドッグのテストは、簡単な手順で実行できます。ウォッチドッグは、正規の手順を踏まずにシステムを強制的にリセット/シャットダウンするため、必ず最初にSAP HANAを切り替えてください。

ハードウェアウォッチドッグの場合は、ウォッチドッグがタイムアウトした後のアクションを事前に定義します。ウォッチドッグモジュールがロードされていて、他のアプリケーションによって制御されていない場合は、次の手順を実行します。

重要

ウォッチドッグを継続的に更新せずに、ウォッチドッグをトリガーして、システムをリセットするか電源をオフにします。これが意図されたメカニズムです。次のコマンドは、システムのリセットまたは電源オフを強制します。

touch /dev/watchdog

softdogモジュールが使用されている場合は、以下のアクションを実行できます。

echo 1> /dev/watchdog

テストが成功した場合は、すべてのクラスターメンバーにウォッチドッグを実装する必要があります。

9.1.2 ha-cluster-initを使用したクラスターの初期設定 #

 

詳細については、SUSE Linux Enterprise High Availability Extensionの自動クラスター設定を参照してください。

初期設定を作成するには、ha-cluster-initコマンドを使用してダイアログに従ってください。これは、最初のクラスターノードだけに実行してください。

suse01:~> ha-cluster-init -u -s <sbddevice>

このコマンドは、以下を含む基本的なクラスターフレームワークを構成します。

• SSH鍵

• 構成ファイルを転送するためのcsync2

• SBD（1台以上のデバイス）

• corosync（1つ以上のリング）

• HAWK Webインタフェース

重要

ha-cluster-init の要求に基づいて、haclusterユーザーのパスワードを変更します。

9.1.3 CorosyncとSBD構成を適用する #

 

2番目のcorosyncリングを追加することをお勧めします。-uオプションを使用してha-cluster-initを開始しなかった場合は、corosyncを変更してUCAST通信を使用する必要があります。UCASTに変更するには、 systemctl stop pacemakerを使用して、すでに稼働しているクラスターを停止します。corosync構成とSBDパラメータを設定した後に、クラスターを再起動します。

9.1.3.1 Corosync の構成 #

 

/etc/corosync/corosync.confファイルにある以下のブロックを確認します。また、本ドキュメントの最後に掲載されている例も参照してください。

totem {
    ...

    interface {
        ringnumber: 0
        mcastport:  5405
        ttl:        1
    }
    #Transport protocol
    transport:      udpu

}
nodelist {
        node {
        #ring0 address
        ring0_addr:     192.168.1.11
        nodeid: 1

        }
    }

9.1.3.2 SBD構成を適用する #

 

SBDデバイスを使用していない場合は、このセクションをスキップできますが、サポートされている別のフェンシングメカニズムを必ず実装してください。

詳細については、マニュアルのページsbd.8およびstonith_sbd.7をご覧ください。

表 3: /etc/sysconfig/SBDファイルのSBDオプション #

 

パラメータ	説明
SBD_WATCHDOG_DEV	ウォッチドッグデバイスを定義します。ウォッチドッグの使用は必須です。SBDは、ウォッチドッグがないと信頼性が低くなります。ウォッチドッグの設定については、SLESマニュアルとSUSE TIDs 7016880を参照してください。
SBD_WATCHDOG_TIMEOUT	タイムアウトは秒単位で定義します。定義しなければ、ウォッチドッグはノードがパニックに陥るまで待機したままになります。 このパラメータは、使用中のストレージ環境と整合している必要があります。仮にストレージが30秒間ハングすることが予想される場合は、このパラメータをより長い値に設定する必要があります。一般的な設定は5秒ですが、本稼働環境では意欲的な値になり得ます。 このパラメータは、Pacemaker クラスターのstonith-watchdog-timeoutプロパティにも整合させる必要があります。stonith-watchdog-timeoutプロパティは、SBD_WATCHDOG_TIMEOUTの値以上に設定する必要があります。 stonith-watchdog-timeout を負の値に設定すると、Pacemakerはこのタイムアウトを自動的に計算し、SUSE Linux Enterprise High Availability Extension 15以降の SBD_WATCHDOG_TIMEOUT の値の2倍に設定します。
SBD_STARTMODE	起動モード。cleanに設定されている場合、sbdはノードが以前クリーンにシャットダウンされたか、またはスロットが空の場合にのみ起動します。
SBD_PACEMAKER	Pacemakerクォーラムとノードに異常がないかをチェックをします。

以下では、/dev/disk/by-id/SBDA、および/dev/disk/by-id/SBDBを実際のsbdデバイス名に置き換えます。この例では、SBD_WATCHDOG_TIMEOUTは15秒に設定されており、一般的な5秒に比べると意欲的な値ではありません。

# /etc/sysconfig/sbd
SBD_DEVICE="/dev/disk/by-id/SBDA;/dev/disk/by-id/SBDB"
SBD_WATCHDOG_DEV="/dev/watchdog"
SBD_WATCHDOG_TIMEOUT=15
SBD_PACEMAKER="yes"
SBD_STARTMODE="clean"
SBD_OPTS=""

重要

タイムアウトの計算に関して、詳しくは次のSUSE製品ドキュメントもご覧ください。https://documentation.suse.com/sle-ha/15-SP1/single-html/SLE-HA-guide/#sec-ha-storage-protect-watchdog-timings

9.1.3.3 SBDデバイスを確認する #

 

SBDデバイスを使用していない場合は、このセクションをスキップできますが、サポートされているフェンシングメカニズムを必ず実装してください。

両方のノードからSBDデバイスにアクセスでき、有効なレコードが含まれているか確認することをお勧めします。これを/etc/sysconfig/sbdで構成されているすべてのデバイスに対して確認してください。

suse01:~ # sbd -d /dev/disk/by-id/SBDA dump
==Dumping header on disk /dev/disk/by-id/SBDA
Header version     : 2.1
UUID               : 0f4ea13e-fab8-4147-b9b2-3cdcfff07f86
Number of slots    : 255
Sector size        : 512
Timeout (watchdog) : 20
Timeout (allocate) : 2
Timeout (loop)     : 1
Timeout (msgwait)  : 40
==Header on disk /dev/disk/by-id/SBDA is dumped

サンプルのタイムアウト値は初期値に過ぎませんので、ご使用の環境に合わせて調整してください。

さまざまなクラスターノードの現在のSBDエントリーを確認するには、sbd listを使用します。すべてのエントリーがclearされている場合、SBDデバイスにはフェンシングタスクがマークされません。

suse01:~ # sbd -d /dev/disk/by-id/SBDA list
0     suse01      clear

SBD構成パラメータの詳細については、 SUSE Linux Enterprise High-Availability Extension、およびTIDsが 7016880と7008216のストレージベースフェンシングセクションをご覧ください。

ここで、最初のノードでクラスターを再起動します(systemctl start pacemaker)。

9.1.4 2番目のノードのクラスター構成 #

 

2ノードクラスターの2番目のノードは、ha-cluster-joinコマンドを実行して統合することができます。このコマンドは、IPアドレスか最初のクラスターノードの名前を要求します。必要なすべての構成ファイルがコピーされます。その結果、クラスターは両方のノードで起動されます。

# ha-cluster-join -c <host1>

9.1.5 初めてクラスターを確認する #

 

これで、初めて両方のノードでクラスターを確認し、オプションでクラスターを起動する時がきました。

suse01:~ # systemctl status pacemaker
suse01:~ # systemctl status sbd
suse02:~ # systemctl status pacemaker
suse01:~ # systemctl start pacemaker
suse02:~ # systemctl status sbd
suse02:~ # systemctl start pacemaker

crm_monを使用してクラスターのステータスを確認します。「-r」オプションを使用して、構成済みで停止しているリソースも表示します。

# crm_mon -r

このコマンドは、空のクラスターを表示し、以下のような画面出力を表示します。ここで最も興味深い情報は、「online」オンラインステータスの2つのノードがある点と、「partition with quorum」というメッセージです。

Stack: corosync
Current DC: suse01 (version 2.0.1+20190417.13d370ca9-3.6.1-2.0.1+20190417.13d370ca9) - partition with quorum
Last updated: Wed Feb  5 15:06:35 2020
Last change: Wed Feb  5 15:04:42 2020 by hacluster via crmd on suse02
2 nodes configured
1 resource configured
Online: [ suse01 suse02 ]
Full list of resources:
 stonith-sbd    (stonith:external/sbd): Started suse01

suse01:~ # vi crm-fileXX
suse01:~ # crm configure load update crm-fileXX

suse01:~ # vi crm-bs.txt
# enter the following to crm-bs.txt
property $id="cib-bootstrap-options" \
              stonith-enabled="true" \
              stonith-action="reboot" \
              stonith-timeout="150s"
rsc_defaults $id="rsc-options" \
              resource-stickiness="1000" \
              migration-threshold="5000"
op_defaults $id="op-options" \
                 timeout="600"

suse01:~ # crm configure load update crm-bs.txt

# vi crm-sbd.txt
# enter the following to crm-sbd.txt
primitive stonith-sbd stonith:external/sbd \
    params pcmk_delay_max="15"

suse01:~ # crm configure load update crm-sbd.txt

# vi crm-saphanatop.txt
# enter the following to crm-saphanatop.txt
primitive rsc_SAPHanaTopology_HA1_HDB10 ocf:suse:SAPHanaTopology \
        op monitor interval="10" timeout="600" \
        op start interval="0" timeout="600" \
        op stop interval="0" timeout="300" \
        params SID="HA1" InstanceNumber="10"
clone cln_SAPHanaTopology_HA1_HDB10 rsc_SAPHanaTopology_HA1_HDB10 \
        meta clone-node-max="1" interleave="true"

suse01:~ # crm configure load update crm-saphanatop.txt

# vi crm-saphana.txt
# enter the following to crm-saphana.txt
primitive rsc_SAPHana_HA1_HDB10 ocf:suse:SAPHana \
        op start interval="0" timeout="3600" \
        op stop interval="0" timeout="3600" \
        op promote interval="0" timeout="3600" \
        op monitor interval="60" role="Master" timeout="700" \
        op monitor interval="61" role="Slave" timeout="700" \
        params SID="HA1" InstanceNumber="10" PREFER_SITE_TAKEOVER="true" \
        DUPLICATE_PRIMARY_TIMEOUT="7200" AUTOMATED_REGISTER="false"
ms msl_SAPHana_HA1_HDB10 rsc_SAPHana_HA1_HDB10 \
        meta clone-max="2" clone-node-max="1" interleave="true"

suse01:~ # crm configure load update crm-saphana.txt

# vi crm-vip.txt
# enter the following to crm-vip.txt

primitive rsc_ip_HA1_HDB10 ocf:heartbeat:IPaddr2 \
        op monitor interval="10s" timeout="20s" \
        params ip="192.168.1.20"

suse01:~ # crm configure load update crm-vip.txt

# vi crm-cs.txt
# enter the following to crm-cs.txt

colocation col_saphana_ip_HA1_HDB10 2000: rsc_ip_HA1_HDB10:Started \
    msl_SAPHana_HA1_HDB10:Master
order ord_SAPHana_HA1_HDB10 Optional: cln_SAPHanaTopology_HA1_HDB10 \
    msl_SAPHana_HA1_HDB10

suse01:~ # crm configure load update crm-cs.txt

# vi crm-re.txt
# enter the following to crm-re.txt

primitive rsc_ip_HA1_HDB10_readenabled ocf:heartbeat:IPaddr2 \
        op monitor interval="10s" timeout="20s" \
        params ip="192.168.1.21"
colocation col_saphana_ip_HA1_HDB10_readenabled 2000: \
    rsc_ip_HA1_HDB10_readenabled:Started msl_SAPHana_HA1_HDB10:Slave

テストのリストは、本ドキュメントの次回の更新時に改訂される予定です。

どのようなクラスターにおいても、テストは極めて重要です。顧客の要望に基づくすべてのテストケースが実施され、完全に適合していることを確認してください。これを怠ると、本稼働環境でプロジェクトが失敗する可能性があります。

テストの前提条件は、特に断りがない限り、両方のノードが起動され、クラスターの通常のメンバーとHANA RDBMSが実行されていることです。また、システムレプリケーションは同期している状態（SOK）です。

10.1 半自動化テストケース #

 

このテストでは、次の想定をしています。PREFER_SITE_TAKEOVER="true" およびAUTOMATED_REGISTER="false".

注記

以下のテストは順番に実行されるように設計されており、テスト結果は終了ステータスによって異なります。

10.1.1 テスト: サイトA（ノード1）のプライマリデータベースを停止する #

 

例 16: STOP_PRIMARY_SITE_Aをテストする #

 

コンポーネント: #

 

• プライマリデータベース

説明: #

 

• プライマリHANAデータベースを通常のクラスター動作中に停止します。

テスト手順: #

 

1. <sid>admとして、プライマリHANAデータベースを 正しい手順で停止します。

   suse01# HDB stop

リカバリー手順: #

 

1. <sid>admとして、テイクオーバー後（ノード2で）に古いプライマリ（ノード1の）を新しいプライマリに手動で登録します。

   suse01# hdbnsutil -sr_register --remoteHost=suse02 --remoteInstance=10 \
             --replicationMode=sync --operationMode=logreplay \
             --name=WDF

2. ルートとして、ノード1でHANAデータベース（現在はセカンダリ）を再起動します。

   suse01# crm resource refresh rsc_SAPHana_HA1_HDB10 suse01

期待される動作: #

 

1. クラスターは、プライマリHANAデータベース（ノード1）が停止したことを検出し、リソースを失敗としてマークします。

2. クラスターは、（ノード2の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

3. クラスターは、IPアドレスを（ノード2の）新しいプライマリに移行します。

4. その後しばらくすると、クラスターは（ノード1で）失敗したプライマリのsync_stateをSFAILとして表示します。

5. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

6. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

7. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.2 テスト: サイトB（ノード2）のプライマリデータベースを停止する #

 

例 17: STOP_PRIMARY_DB_SITE_Bをテストする #

 

コンポーネント:

プライマリデータベース

説明:

プライマリHANAデータベースを通常のクラスター動作中に停止します。

テスト手順: #

 

1. <sid>admとして、データベースを正しい手順で停止します。

   suse02# HDB stop

リカバリー手順: #

 

1. <sid>admとして、テイクオーバー後（ノード1で）に古いプライマリ（ノード2の）を新しいプライマリに手動で登録します。

   suse02# hdbnsutil -sr_register --remoteHost=suse01 --remoteInstance=10 \
                  --replicationMode=sync --operationMode=logreplay \
                  --name=ROT

2. ルートとして、ノード1でHANAデータベース（現在はセカンダリ）を再起動します。

   suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは（ノード2で）停止したプライマリHANAデータベースを検出し、リソースを失敗としてマークします。

2. クラスターは、（ノード1の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

3. クラスターは、IPアドレスを（ノード1の）新しいプライマリに移行します。

4. その後しばらくすると、クラスターは（ノード2で）失敗したプライマリのsync_stateをSFAILとして表示します。

5. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

6. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

7. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.3 テスト: サイトA（ノード1）のプライマリデータベースをクラッシュさせる #

 

例 18: CRASH_PRIMARY_DB_SITE_Aをテストする #

 

コンポーネント:

プライマリデータベース

説明:

プライマリデータベースシステムの完全停止をシミュレートします。

テスト手順: #

 

1. <sid>admとして、シグナルを使用してプライマリデータベースシステムを強制終了します。

   suse01# HDB kill-9

リカバリー手順: #

 

1. <sid>admとして、テイクオーバー後（ノード2で）に古いプライマリ（ノード1の）を新しいプライマリに手動で登録します。

   suse01# hdbnsutil -sr_register --remoteHost=suse02 --remoteInstance=10 \
                  --replicationMode=sync  --operationMode=logreplay \
                  --name=WDF

2. ルートとして、ノード1でHANAデータベース（現在はセカンダリ）を再起動します。

   suse01# crm resource refresh rsc_SAPHana_HA1_HDB10 suse01

期待される動作: #

 

1. クラスターは（ノード1で）停止したプライマリHANAデータベースを検出し、リソースを失敗としてマークします。

2. クラスターは、（ノード2の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

3. クラスターは、IPアドレスを（ノード2の）新しいプライマリに移行します。

4. その後しばらくすると、クラスターは（ノード1で）失敗したプライマリのsync_stateをSFAILとして表示します。

5. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

6. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

7. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.4 テスト: サイトB（ノード2）のプライマリデータベースをクラッシュさせる #

 

例 19: CRASH_PRIMARY_DB_SITE_B をテストする #

 

コンポーネント:

プライマリデータベース

説明:

プライマリデータベースシステムの完全停止をシミュレートします。

テスト手順: #

 

1. <sid>admとして、シグナルを使用してプライマリデータベースシステムを強制終了します。

   suse02# HDB kill-9

リカバリー手順: #

 

1. <sid>admとして、テイクオーバー後（ノード1で）に古いプライマリ（ノード2の）を新しいプライマリに手動で登録します。

   suse02# hdbnsutil -sr_register --remoteHost=suse01 --remoteInstance=10 \
                  --replicationMode=sync  --operationMode=logreplay \
                  --name=ROT

2. ルートとして、ノード1でHANAデータベース（現在はセカンダリ）を再起動します。

   suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは（ノード2で）停止したプライマリHANAデータベースを検出し、リソースを失敗としてマークします。

2. クラスターは、（ノード1の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

3. クラスターは、IPアドレスを（ノード1の）新しいプライマリに移行します。

4. その後しばらくすると、クラスターは（ノード2で）失敗したプライマリのsync_stateをSFAILとして表示します。

5. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

6. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

7. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.5 テスト: サイトA（ノード1）のプライマリデータベースをクラッシュさせる #

 

例 20: CRASH_PRIMARY_NODE_SITE_Aをテストする #

 

コンポーネント:

プライマリサイトのクラスターノード

説明:

プライマリHANAデータベースを実行しているプライマリサイトノードのクラッシュをシミュレートします。

テスト手順: #

 

1. 「fast-reboot」システムリクエストを送信して、プライマリノードをクラッシュさせます。

   suse01# echo 'b' > /proc/sysrq-trigger

リカバリー手順: #

 

1. SBDフェンシングが使用されていると、pacemakerはフェンスされた後、自動的に再起動しません。この場合は、すべてのSBDデバイスのフェンシングフラグをクリアしてから、pacemakerを起動します。

   suse01# sbd -d /dev/disk/by-id/SBDA message suse01 clear
   suse01# sbd -d /dev/disk/by-id/SBDB message suse01 clear
   ...

2. クラスターフレームワークを開始します。

   suse01# systemctl start pacemaker

3. <sid>admとして、テイクオーバー後（ノード2で）に古いプライマリ（ノード1の）を新しいプライマリに手動で登録します。

   suse01# hdbnsutil -sr_register --remoteHost=suse02 --remoteInstance=10 \
                  --replicationMode=sync  --operationMode=logreplay \
                  --name=WDF

4. ルートとして、ノード1でHANAデータベース（現在はセカンダリ）を再起動します。

   suse01# crm resource refresh rsc_SAPHana_HA1_HDB10 suse01

期待される動作: #

 

1. クラスターは、失敗したノード（ノード1）を検出し、それをUNCLEANと宣言し、セカンダリノード（ノード2）を「partition WITHOUT quorum」ステータス に設定します。

2. クラスターは失敗したノード（ノード1）をフェンスします。

3. クラスターは、失敗したノード（ノード1）をOFFLINEとして宣言します。

4. クラスターは、（ノード2の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

5. クラスターは、IPアドレスを（ノード2の）新しいプライマリに移行します。

6. その後しばらくすると、クラスターは（ノード2で）失敗したプライマリのsync_stateをSFAILとして表示します。

7. SBDフェンシングが使用されている場合は、手動のリカバリー手順を使用し、そのノードのフェンシングフラグをクリアしてpacemakerを再起動します。

8. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

9. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

10. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.6 テスト: サイトB（ノード2）のプライマリノードをクラッシュさせる #

 

例 21: CRASH_PRIMARY_NODE_SITE_Bをテストする #

 

コンポーネント:

セカンダリサイトのクラスターノード

説明:

プライマリHANAデータベースを実行しているセカンダリサイトノードのクラッシュをシミュレートします。

テスト手順: #

 

1. 「fast-reboot」システムリクエストを送信して、セカンダリノードをクラッシュさせます。

   suse02# echo 'b' > /proc/sysrq-trigger

リカバリー手順: #

 

1. SBDフェンシングが使用されていると、pacemakerはフェンスされた後、自動的に再起動しません。この場合は、すべてのSBDデバイスのフェンシングフラグをクリアしてから、pacemakerを起動します。

   suse02# sbd -d /dev/disk/by-id/SBDA message suse02 clear
   suse02# sbd -d /dev/disk/by-id/SBDB message suse02 clear
   ...

2. クラスターフレームワークを起動します。

   suse02# systemctl start pacemaker

3. <sid>admとして、テイクオーバー後（ノード1で）に古いプライマリ（ノード2の）を新しいプライマリに手動で登録します。

   suse02# hdbnsutil -sr_register --remoteHost=suse01 --remoteInstance=10 \
                  --replicationMode=sync  --operationMode=logreplay \
                  --name=ROT

4. ルートとして、ノード2でHANAデータベース（現在はセカンダリ）を再起動します。

   suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは、セカンダリノード（ノード2）が失敗したことを検出し、UNCLEANと宣言して、プライマリノード（ノード1）を「partition WITHOUT quorum」ステータス に設定します。

2. クラスターは、失敗したノード（ノード2）をフェンスします。

3. クラスターは、障害が発生したノード（ノード2）をOFFLINEとして宣言します。

4. クラスターは、（ノード1の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

5. クラスターは、IPアドレスを（ノード1の）新しいプライマリに移行します。

6. その後しばらくすると、クラスターは（ノード2で）停止したセカンダリのsync_stateをSFAILとして表示します。

7. SBDフェンシングが使用されている場合は、手動のリカバリー手順を使用し、そのノードのフェンシングフラグをクリアしてpacemakerを再起動します。

8. AUTOMATED_REGISTER="false"であることから、クラスターは失敗したHANAデータベースを再起動したり、新しいプライマリに登録することはしせん。

9. 手動での登録とリソースの更新後、システムとレプリケーションのペアは同期ステータス（SOK）としてマークされます。

10. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.7 テスト: サイトB（ノード2）のセカンダリデータベースを停止する #

 

例 22: STOP_SECONDARY_DB_SITE_Bをテストする #

 

コンポーネント:

セカンダリHANAデータベース

説明:

セカンダリHANAデータベースを通常のクラスター動作中に停止します。

テスト手順: #

 

1. <sid>admとして、セカンダリHANAデータベースを正しい手順で停止します。

   suse02# HDB stop

リカバリー手順: #

 

1. ルートとして、セカンダリHANAデータベース（ノード2）の失敗したリソースのステータスを更新します。

   suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは、セカンダリデータベース（ノード2）が停止したことを検出し、リソースを失敗としてマークします。

2. クラスターはシステムレプリケーションの障害を検出し、失敗（SFAIL）としてマークします。

3. クラスターは、同じノード（ノード2）でセカンダリHANAデータベースを再起動します。

4. クラスターは、システムレプリケーションが再び同期していることを検出し、それをok（SOK）としてマークします。

5. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.8 テスト: サイトB（ノード2）のセカンダリデータベースをクラッシュさせる #

 

例 23: CRASH_SECONDARY_DB_SITE_B をテストする #

 

コンポーネント:

セカンダリHANAデータベース

説明:

セカンダリデータベースシステムの完全停止をシミュレートします。

テスト手順: #

 

1. <sid>adm.として、シグナルを使用してセカンダリデータベースシステムを強制終了します。

   suse02# HDB kill-9

リカバリー手順: #

 

1. ルートとして、セカンダリHANAデータベース（ノード２）の失敗したリソースステータスをクリーンアップします。

   suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは、セカンダリデータベース（ノード2）が停止したことを検出し、リソースを失敗としてマークします。

2. クラスターはシステムレプリケーションの障害を検出し、失敗（SFAIL）としてマークします。

3. クラスターは、同じノード（ノード2）でセカンダリHANAデータベースを再起動します。

4. クラスターは、システムレプリケーションが再び同期していることを検出し、それをok（SOK）としてマークします。

5. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.1.9 テスト: サイトB（Node2）のセカンダリノードをクラッシュさせる #

 

例 24: CRASH_SECONDARY_NODE_SITE_B をテストする #

 

コンポーネント:

セカンダリサイトのクラスターノード

説明:

セカンダリHANAデータベースを実行しているセカンダリサイトノードのクラッシュをシミュレートします。

テスト手順: #

 

1. 「fast-reboot」システムリクエストを送信して、セカンダリノードをクラッシュさせます。

   suse02# echo 'b' > /proc/sysrq-trigger

リカバリー手順: #

 

1. SBDフェンシングが使用されていると、pacemakerはフェンスされた後、自動的に再起動しません。この場合は、すべてのSBD デバイスのフェンシングフラグをクリアしてから、pacemakerを起動します。

   suse02# sbd -d /dev/disk/by-id/SBDA message suse02 clear
   suse02# sbd -d /dev/disk/by-id/SBDB message suse02 clear
   ...

2. クラスターフレームワークを起動します。

   suse02# systemctl start pacemaker

期待される動作: #

 

1. クラスターは、セカンダリノード（ノード2）が失敗したことを検出し、UNCLEANと宣言して、プライマリノード（ノード1）を「partition WITHOUT quorum」ステータス に設定します。

2. クラスターは、失敗したノード（ノード2）をフェンスします。

3. クラスターは、障害が発生したノード（ノード2）をOFFLINEとして宣言します。

4. その後しばらくすると、クラスターは（ノード2で）停止したセカンダリのsync_stateをSFAILとして表示します。

5. SBDフェンシングが使用されている場合は、手動のリカバリー手順を使用し、そのノードのフェンシングフラグをクリアしてpacemakerを再起動します。

6. フェンスされたノード（ノード2）がクラスターに復帰すると、以前のセカンダリHANAデータベースが自動的に起動します。

7. クラスターは、システムレプリケーションが再び同期していることを検出し、それをok（SOK）としてマークします。

10.1.10 テスト: レプリケーションLANの障害 #

 

例 25: FAIL_NETWORK_SRをテストする #

 

コンポーネント:

レプリケーションLAN

説明:

プライマリノードとセカンダリノード間のレプリケーションLAN接続の切断。

テスト手順: #

 

1. レプリケーションLAN上のクラスターノード間の接続を切断します。

リカバリー手順: #

 

1. レプリケーションLAN上のクラスターノード間の接続を再確立します。

期待される動作: #

 

1. その後しばらくすると、クラスターはセカンダリ（ノード2）のsync_stateをSFAILとして表示します。

2. プライマリHANAデータベース（ノード1）「HDBSettings.sh systemReplicationStatus.py」は 「CONNECTION TIMEOUT」を示し、セカンダリHANAデータベース（ノード2）はプライマリデータベース（ノード1）に接続できません。

3. プライマリHANAデータベースは引き続き「normal」として動作しますが、システムレプリケーションは実行されないため、有効なテイクオーバー先ではなくなります。

4. LAN接続が再確立されると、HDBはHANAデータベース間の接続を自動的に検出して、システムレプリケーションプロセスを再起動します。

5. クラスターは、システムレプリケーションが再び同期していることを検出し、それをok（SOK）としてマークします。

10.2 完全自動化のテストケース #

 

以降のテスト説明では、PREFER_SITE_TAKEOVER="true」 およびAUTOMATED_REGISTER="true".を前提にしています。

注記

以下のテストは順番に実行されるように設計されており、テスト結果は終了ステータスによって異なります。

10.2.1 テスト: サイトAのプライマリデータベースを停止する #

 

例 26: STOP_PRIMARY_DB_SITE_Aをテストする #

 

コンポーネント: #

 

• プライマリデータベース

説明: #

 

• プライマリHANAデータベースを通常のクラスター動作中に停止します。

テスト手順: #

 

• <sid>admとして、プライマリHANAデータベースを 正しい手順で停止します。

suse01# HDB stop

リカバリー手順: #

 

1. すべて自動化されていますので手動操作は不要です。

2. ルートとして、ノード1のクラスターリソースを更新します。

suse01# crm resource refresh rsc_SAPHana_HA1_HDB10 suse01

期待される動作: #

 

1. クラスターは（ノード1で）停止したプライマリHANAデータベースを検出し、リソースを失敗としてマークします。

2. クラスターは、（ノード2の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

3. クラスターは、IPアドレスを（ノード2の）新しいプライマリに移行します。

4. その後しばらくすると、クラスターは（ノード1で）失敗したプライマリのsync_stateをSFAILとして表示します。

5. AUTOMATED_REGISTER="true" により、クラスターは失敗したHANAデータベースを再起動し、新しいプライマリに登録します。

6. 自動的に登録され、リソースが更新された後、システムレプリケーションペアは同期ステータス（SOK）としてマークされます。

7. クラスターの「failed actions」は、リカバリー手順に従ってクリーンアップされます。

10.2.2 テスト: サイトB（ノード2）のプライマリノードをクラッシュさせる #

 

例 27: CRASH_PRIMARY_NODE_SITE_Bをテストする #

 

コンポーネント: #

 

• サイトBのクラスターノード

説明: #

 

• プライマリHANAデータベースを実行しているサイトBノードのクラッシュをシミュレートします。

テスト手順: #

 

• 「fast-reboot」システムリクエストを送信して、セカンダリノードをクラッシュさせます。

suse02# echo 'b' > /proc/sysrq-trigger

リカバリー手順: #

 

• SBDフェンシングが使用されていると、pacemakerはフェンスされた後、自動的に再起動しません。この場合は、すべてのSBD デバイスのフェンシングフラグをクリアしてから、pacemakerを起動します。

suse02# sbd -d /dev/disk/by-id/SBDA message suse02 clear
suse02# sbd -d /dev/disk/by-id/SBDB message suse02 clear
...

• クラスターフレームワークを起動します。

suse02# systemctl start pacemaker

• ルートとして、ノード2のクラスターリソースを更新します。

suse02# crm resource refresh rsc_SAPHana_HA1_HDB10 suse02

期待される動作: #

 

1. クラスターは、失敗したプライマノード（ノード2）を検出し、それをUNCLEANと宣言し、プライマリノード（ノード2）を「partition WITHOUT quorum」ステータス に設定します。

2. クラスターは、失敗したプライマリノード）ノード２）をフェンスします。

3. クラスターは、障害が発生したプライマリノード（ノード2）をOFFLINEとして宣言します。

4. クラスターは、（ノード1の）セカンダリHANAデータベースを昇格させ、プライマリとして引き継ぎます。

5. クラスターは、IPアドレスを（ノード1の）新しいプライマリに移行します。

6. その後しばらくすると、クラスターは（ノード2で）停止したセカンダリのsync_stateをSFAILとして表示します。

7. SBDフェンシングが使用されている場合は、手動のリカバリー手順を使用し、そのノードのフェンシングフラグをクリアしてpacemakerを再起動します。

8. フェンスされたノード（ノード2）がクラスターに復帰すると、以前のプライマリがセカンダリになります。

9. AUTOMATED_REGISTER="true" により、クラスターは失敗したHANAデータベースを再起動し、新しいプライマリに登録します。

10. クラスターは、システムレプリケーションが再び同期していることを検出し、それをok（SOK）としてマークします。

詳細については、以下のドキュメントをご覧ください。

Copyright © 2006–2020 SUSE LLC および寄稿者。全著作権所有

この文書は、GNUフリー文書ライセンスのバージョン1.2または（オプションとして）バージョン1.3の条項に従って、複製、頒布、および/または改変が許可されています。ただし、この著作権表示およびライセンスは変更せずに記載することが求められます。ライセンスバージョン1.2のコピーは、「GNUフリー文書ライセンス」セクションに含まれています。

SUSE、SUSEロゴ、およびYaSTは、米国およびその他の国におけるSUSE LLCの登録商標です。SUSEの商標については、https://www.suse.com/company/legal/を参照してください。

Linux は、Linus Torvalds氏の登録商標です。本文書に記載されたその他のすべての名称または商標は、各社の所有者の商標または登録商標である可能性があります。

本文書は、「SUSEベストプラクティス」と呼ばれる一連の文書の一部です。各文書は、SUSEの従業員と第三者によって自発的に寄稿されたものです。本文書の内容は、特定の行動を取る方法の一例を示しているにすぎません。

また、SUSEは、本文書に記載されている動作が主張どおり実行されること、あるいは意図しない結果に終わることを立証しません。

本文書に記載されているすべての情報は、細部に至るまで最大限の注意を払って制作されています。しかし、完全に正確であることを保証するものではありません。したがって、SUSE LLC、その関連会社、著者、翻訳者のいずれも、本文書内の誤りとそこから生じる結果について 一切の保証はいたしません。なお、本文書は以下のライセンスのもとで発行されていることを注記します。

Copyright (C) 2000, 2001, 2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or non-commercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.

This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.

We have designed this License to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.

This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.

A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.

A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.

The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.

The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.

A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque".

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.

The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.

A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition.

The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.

You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and you may publicly display copies.

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.

It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.

You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.

You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.

You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.

The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements".

You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.

A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.

Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.

If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.

Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.

Copyright (c) YEAR YOUR NAME.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
 Free Documentation License".

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts". line with this:

with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.

If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.

If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.