Print ja/Install/2.1.2/rhel4

Heartbeat 2.1.2 インストール手順例（RHEL4 Update4 x86_64）

Contents

ソースプログラムからインストール
rpmパッケージからインストール
設定と動作確認
バージョン２モードの設定と動作確認
1. heartbeat の設定
2. heartbeat の起動
GUIクライアントの動作確認
「最小インストール」を指定してインストールをした場合に必要なパッケージのインストール
libnet.tar.gz のダウンロード
関連情報

ソースプログラムからインストール

RHEL4 Update4 x86_64版（旧称 EM64T）を開発ツールを含むようにカスタムインストールした環境へのインストール手順例を示します。
RHEL4 が Update5 の場合や i386 の場合でも同様の手順でインストールが可能です。rpmのバージョンは 2.1.2-1 の例になっていますが、2.1.2-2 でも同様の手順になります。

ソースプログラム

heartbeat をビルドするには、あらかじめ libnet パッケージのインストールが必要です。（スタティクリンクされるので、実行環境では不要です）
libnet の安定バージョンは、1.1.2.1 で以下の Webページからダウンロードできます。（付録を参照）
- http://www.packetfactory.net/libnet/[1]
haertbeat のソースプログラムは、以下ページからダウンロードできます。
- 本家公式Linux-HAダウンロードエリア(英語)[2]

libnet のインストール

libnet の rpmパッケージは、RHEL4 Update4 x86_64版のインストールセットに含まれていませんが、適当なWebサイトから入手できるのでそれを利用してください。
ここでは、ソースプログラムがらインストールする方法を説明します。

・解凍

$ tar zxvf libnet.tar.gz

・コンパイル

$ cd libnet
$ ./configure --prefix=/usr/local 2>&1 \
     | tee configure.log
$ make 2>&1 | tee make.log

・インストール

$ su
# make install 2>&1 | tee make_install.log

mgmtd がビルドされるために必要なパッケージのインストール（オプション）

# rpm -ivh libgpg-error-devel-1.0-1.x86_64.rpm
# rpm -ivh libgcrypt-devel-1.2.0-3.x86_64.rpm
# rpm -ivh gnutls-devel-1.0.20-3.2.2.x86_64.rpm

SNMP を有効にするために必要なパッケージのインストール（オプション）

# rpm -ivh beecrypt-devel-3.1.0-6.x86_64.rpm
# rpm -ivh elfutils-libelf-devel-0.97.1-3.x86_64.rpm
# rpm -ivh elfutils-devel-0.97.1-3.x86_64.rpm
# rpm -ivh net-snmp-devel-5.1.2-11.EL4.7.x86_64.rpm
# rpm -ivh lm_sensors-devel-2.8.7-2.40.3.x86_64.rpm

heartbeat のインストール

次の２つの方法があります。

・rpmパッケージを作成しない一般的なインストール方法

・rpmパッケージを作成し、インストールする方法

rpmパッケージを作成しない一般的なインストール方法

・heartbeat用ユーザの作成

インストール時に、ユーザ hacluster が必要となるので、作成しておきます。

$ su -
# groupadd -g 90 haclient
# useradd -u 90 -g haclient -d /home/hacluster \
     -s /bin/bash -c HACLUSTER -m hacluster

パスワードの設定をおこないます。

# passwd hacluster
New UNIX password:
( BAD PASSWORD: it does not contain enough DIFFERENT characters )
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
# exit
$

・解凍

$ tar zxvf heartbeat-2.1.2.tar.gz

・コンパイル

SNMPの有効化とグループID/ユーザIDを指定しています。

$ cd heartbeat-2.1.2 
$ ./ConfigureMe configure --enable-snmp_subagent \
     --with-group-id=90 --with-ccmuser-id=90 2>&1 | tee configure.log
$ make 2>&1 | tee make.log

・インストール

$ su
# make install 2>&1 | tee make_install.log

rpmパッケージを作成してインストールする方法

・解凍

$ tar zxvf heartbeat-2.1.2.tar.gz

・rpmパッケージ作成

SNMPの有効化とグループID/ユーザIDを指定してrpmを作成しています。

$ cd heartbeat-2.1.2 
$ su
# ./ConfigureMe rpm --enable-snmp_subagent \
     --with-group-id=90 --with-ccmuser-id=90 2>&1 | tee configure.log

以下の7ファイルが作成されます。(ソフトウェアのダウンロード[3]からダウンロードできるTarballには、debuginfoは含めていません)

/usr/src/redhat/SRPMS/heartbeat-2.1.2-1.src.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-2.1.2-1.x86_64.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-debuginfo-2.1.2-1.x86_64.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-gui-2.1.2-1.x86_64.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-ldirectord-2.1.2-1.x86_64.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-pils-2.1.2-1.x86_64.rpm

/usr/src/redhat/RPMS/x86_64/heartbeat-stonith-2.1.2-1.x86_64.rpm

作成された *.rpm は、共通的に使用できるので、configure.log と共に適当な外部メディアにコピーしておくとよいです。

heartbeat の rpm パッケージをインストールすると専用グループ haclient と専用ユーザ hacluster は、自動的に作成されるので、あらかじめ作成しておかなくてもよいですが、自動的に作成されるユーザ hacluster のホームディレクトリは

/var/lib/heartbeat/cores/hacluster

となってしまいます。

これを避けるためには、以前のように専用グループ haclient と専用ユーザ hacluster を以下のようにあらかじめ作成しておく方がよいです。

$ su -
# groupadd -g 90 haclient
# useradd -u 90 -g haclient -d /home/hacluster \
     -s /bin/bash -c HACLUSTER -m hacluster

パスワードの設定をおこないます。

# passwd hacluster
New UNIX password:
( BAD PASSWORD: it does not contain enough DIFFERENT characters )
Retype new UNIX password:
passwd: all authentication tokens updated successfully.

・インストール

# rpm -ivh heartbeat-pils-2.1.2-1.x86_64.rpm
# rpm -ivh heartbeat-stonith-2.1.2-1.x86_64.rpm
# rpm -ivh heartbeat-2.1.2-1.x86_64.rpm

また、GUIクライアントを使用する場合は、別サーバにインストールします。（同じサーバにインストールすることもできます）

# rpm -ivh heartbeat-gui-2.1.2-1.x86_64.rpm

・アンインストール

# rpm -e heartbeat
# rpm -e heartbeat-stonith
# rpm -e heartbeat-pils

また、GUIクライアントをアンインストールする場合は、

# rpm -e heartbeat-gui

なお、ユーザhacluster とグループ haclient は自動的に削除されないので、別途削除する必要があります。

# userdel hacluster
# groupdel haclient
( # rm -r -f /home/hacluster )

rpmパッケージからインストール

RHEL4 Update4 x86_64版がクリーンインストールされた環境へのインストール手順を示します。

RHEL4 Update4 のインストールは、

◎ デフォルトのソフトウェアをインストール
○ インストールするソフトウェアパッケージをカスタマイズ

のどちらでもかまわないです。しかし、カスタムインストールでの「最小インストール」は、避けた方がよいです。

haertbeat の RHEL4用 rpmは、ソフトウェアのダウンロード[3]ページからダウンロードできます。
現時点(2008-11-19 17:52:56)での最新版のバージョンは、2.1.2-2 です。
libnet のインストールは不要です。

あらかじめインストールが必要なパッケージ

「デフォルトのソフトウェアをインストール」を指定してインストールした場合

# rpm -ivh libtool-libs-1.5.6-4.EL4.1.x86_64.rpm

（ES4 Update4 x86_64版のインストール用CD #3 の /RedHat/RPMS/ にあります）

「最小インストール」を指定してインストールした場合（付録を参照）

heartbeat用ユーザの作成

heartbeat の rpm パッケージをインストールすると専用グループ haclient と専用ユーザ hacluster は、自動的に作成されるので、あらかじめ作成しておかなくてもよいですが、自動的に作成されるユーザ hacluster のホームディレクトリは、

/var/lib/heartbeat/cores/hacluster

となってしまいます。

これを避けるためには、以前のように専用グループ haclient と専用ユーザ hacluster を以下のようにあらかじめ作成しておく方がよいです。

$ su -
# groupadd -g 90 haclient
# useradd -u 90 -g haclient -d /home/hacluster \
     -s /bin/bash -c HACLUSTER -m hacluster

パスワードの設定をおこないます。

# passwd hacluster New UNIX password:
( BAD PASSWORD: it does not contain enough DIFFERENT characters )
Retype new UNIX password:
passwd: all authentication tokens updated successfully.

インストール

# rpm -ivh heartbeat-pils-2.1.2-1.x86_64.rpm
# rpm -ivh heartbeat-stonith-2.1.2-1.x86_64.rpm
# rpm -ivh heartbeat-2.1.2-1.x86_64.rpm

また、GUIクライアントを使用する場合は、別サーバにインストールします。（同じサーバにインストールすることもできます）

# rpm -ivh heartbeat-gui-2.1.2-1.x86_64.rpm

・アンインストール

# rpm -e heartbeat
# rpm -e heartbeat-stonith
# rpm -e heartbeat-pils

また、GUIクライアントをアンインストールする場合は、

# rpm -e heartbeat-gui

なお、ユーザhacluster とグループ haclient は自動的に削除されないので、別途削除する必要があります。

# userdel hacluster
# groupdel haclient
( # rm -r -f /home/hacluster )

設定と動作確認

Heartbeat[4] には、バージョン１系[5]互換動作モードとバージョン２[6]動作モードの２つがあります。
バージョン１系[5]互換動作モードは、設定と動作確認が容易にできるので、Heartbeat[4]を始めてさわる人はバージョン１モードの設定と動作確認[7] に進み実行してみるとよいです。

それ以外の人は、バージョン２モードの設定と動作確認に進んでください。

バージョン２モードの設定と動作確認

heartbeat の設定

クラスタの設定

/etc/ha.d/ha.cf を作成編集します。

例

crm on

logfile /var/log/ha-log

logfacility local0

keepalive 2

deadtime 30

warntime 10

initdead 60

udpport 694

auto_failback off

bcast eth1

node sv01

node sv02

共有リソースの設定

CIB設定ファイル cib.xml を作成編集します。

/var/lib/heartbeat/crm/cib.xml

例)

ACT,SBY構成で、IPaddrリソースを使用
仮想IPを 172.20.24.30/24 に設定
IPaddrで障害を検知した場合、SBY側にフェイルオーバをおこなう

 <cib admin_epoch="0" epoch="1" have_quorum="true" cib_feature_revision="1.3">
   <configuration>
     <crm_config>
       <cluster_property_set id="idCluseterPropertySet">
         <attributes>
           <nvpair id="symmetric_cluster" 
             name="symmetric_cluster" value="true"/>
           <nvpair id="no_quorum_policy" 
             name="no_quorum_policy" value="ignore"/>
           <nvpair id="stonith_enabled" 
             name="stonith_enabled" value="false"/>
           <nvpair id="short_resource_names" 
             name="short_resource_names" value="true"/>
           <nvpair id="is_managed_default" 
             name="is_managed_default" value="true"/>
           <nvpair id="transition_idle_timeout" 
             name="transition_idle_timeout" value="120000"/>
           <nvpair id="default_resource_stickiness" 
             name="default_resource_stickiness" value="INFINITY"/>
           <nvpair id="stop_orphan_resources" 
             name="stop_orphan_resources" value="false"/>
           <nvpair id="stop_orphan_actions" 
             name="stop_orphan_actions" value="true"/>
           <nvpair id="remove_after_stop" 
             name="remove_after_stop" value="false"/>
           <nvpair id="default_resource_failure_stickiness" 
             name="default_resource_failure_stickiness" value="0"/>
           <nvpair id="stonith_action" name="stonith_action" value="false"/>
         </attributes>
       </cluster_property_set>
     </crm_config>
     <nodes/>
     <resources>
       <group id="grpTest" restart_type="restart">
         <primitive id="prmIpTest" class="ocf" type="IPaddr" provider="heartbeat">
           <operations>
             <op id="ipTest_start" 
               name="start" timeout="60s" on_fail="fence"/>
             <op id="ipTest_monitor" 
               name="monitor" interval="10s" timeout="5s" on_fail="fence"/>
             <op id="ipTest_stop" 
               name="stop" timeout="60s" on_fail="fence"/>
           </operations>
           <instance_attributes id="atrIpTest">
             <attributes>
               <nvpair id="ipTest" name="ip" value="172.20.24.30"/>
               <nvpair id="maskTest" name="netmask" value="24"/>
               <nvpair id="nicTest" name="nic" value="eth0"/>
             </attributes>
           </instance_attributes>
         </primitive>
       </group>
     </resources>
     <constraints>
     </constraints>
   </configuration>
   <status/>
 </cib>

アクセス権と所有者の設定

# chmod 0600 cib.xml
# chown hacluster:haclient cib.xml

認証方法と認証鍵の設定

/etc/ha.d/authkeys を作成編集します。

例

auth 1

1 md5 someword

アクセス権の設定

# chmod 0600 authkeys

heartbeat の起動

起動

手動で heartbeat を起動します。

すべてのサーバでおこなう必要があります。（例えば稼動系 sv01、待機系 sv02 等）

$ su sv01
# /etc/init.d/heartbeat start
Starting High-Availability services: [ OK ] 
$ su sv02
# /etc/init.d/heartbeat start
Starting High-Availability services: [ OK ]

起動確認

稼動系サーバの仮想IPアドレスの確認

sv01# ifconfig -a eth0:0
        :
eth0:0
   inet addr: <-仮想IPアドレス

停止

手動で heartbeat を停止します。

すべてのサーバでおこなう必要があります。（例えば稼動系 sv01、待機系 sv02 等）

$ su 
sv01# /etc/init.d/heartbeat stop
Stopping High-Availability services: [ OK ] 
$ su 
sv02# /etc/init.d/heartbeat stop
Stopping High-Availability services: [ OK ]

GUIクライアントの動作確認

GUIクライアントは、Heartbeat が起動しているサーバでも他のサーバでも動作可能です。

$ /usr/share/heartbeat-gui/haclient.py
( $ /usr/bin/hb_gui でも可 )

GUI画面

attachment:hb_gui.png

注意．RHEL4 Update4 x86_64版を最小インストールした環境では、GUIクライアントは動作しません。他サーバのGUIクライアントからのアクセスは可能です。

参考．RHEL4 Update4 の Python のバージョンは 2.3.4

「最小インストール」を指定してインストールをした場合に必要なパッケージのインストール

# rpm -ivh libtool-libs-1.5.6-4.EL4.1.x86_64.rpm 
# rpm -ivh curl-7.12.1-8.rhel4.x86_64.rpm 
# rpm -ivh gnutls-1.0.20-3.2.2.x86_64.rpm 
# rpm -ivh lm_sensors-2.8.7-2.40.3.x86_64.rpm 
# rpm -ivh perl-Crypt-SSLeay-0.51-5.x86_64.rpm 
# rpm -ivh perl-Digest-SHA1-2.07-5.x86_64.rpm 
# rpm -ivh perl-Digest-HMAC-1.01-13.noarch.rpm 
# rpm -ivh perl-Net-DNS-0.48-1.x86_64.rpm

libnet.tar.gz のダウンロード

http://www.packetfactory.net/libnet/[1]　にもし接続できない場合は、次の Debian の公式パッケージ配布サイトからもダウンロードができます。

http://packages.debian.org/source/etch/libnet[8]

下の方にある Download libnet の libnet_1.1.2.1.orig.tar.gz これが libnet.tar.gz とまったく同一のソースパッケージになります。

References

[1]	http://www.packetfactory.net/libnet/
[2]	http://linux-ha.org/download/index.html
[3]	http://www.linux-ha.org/ja/DownloadSoftware_ja
[4]	http://www.linux-ha.org/ja/Heartbeat_ja
[5]	http://www.linux-ha.org/ja/FactSheet_ja
[6]	http://www.linux-ha.org/ja/FactSheetv2_ja
[7]	http://www.linux-ha.org/ja/Installv1_ja
[8]	http://packages.debian.org/source/etch/libnet
[9]	http://www.linux-ha.org/ja/ha.cf_ja
[10]	http://www.linux-ha.org/ja/ClusterInformationBase_ja
[11]	http://www.linux-ha.org/ja/GuiGuide_ja
[12]	http://www.linux-ha.org/ja/Install/2.1.3/rhel5_ja

ソースプログラムからインストール

ソースプログラム

libnet のインストール

mgmtd がビルドされるために必要なパッケージのインストール（オプション）

SNMP を有効にするために必要なパッケージのインストール（オプション）

heartbeat のインストール

rpmパッケージを作成しない一般的なインストール方法

rpmパッケージを作成してインストールする方法

rpmパッケージからインストール

あらかじめインストールが必要なパッケージ

heartbeat用ユーザの作成

インストール

設定と動作確認

バージョン２モードの設定と動作確認

heartbeat の設定

クラスタの設定

共有リソースの設定

認証方法と認証鍵の設定

heartbeat の起動

起動

起動確認

停止

GUIクライアントの動作確認

「最小インストール」を指定してインストールをした場合に必要なパッケージのインストール

libnet.tar.gz のダウンロード

関連情報

References