INSTALL.ja.utf-8

   1 UltraMonkey-L7  インストールマニュアル  v1.10【v2.1.3-x対応版】
   2
   3 --------------------------------------------------------------------------------
   4
   5 [変更履歴]
   6 2005.10.18 [v1.0]   初版
   7 2005.11.15 [v1.1]   マニュアルの不備を修正
   8 2006.07.07 [v1.2]   tcps 非カーネルパッチ版公開に伴う修正
   9 2007.01.19 [v1.3]   追加機能に伴う修正
  10 2007.10.12 [v1.3.1] l7vs-0.6.1 公開に伴う一部関連修正
  11 2007.10.12 [v1.4]   l7vs-1.0.0 公開に伴う一部関連修正
  12 2008.05.30 [v1.5]   v2.0.0-x 公開に伴う一部関連修正
  13 2008.07.09 [v1.5.1] l7vs インストール時注意事項追記
  14 2008.12.16 [v1.5.2] tar.gz ファイル名誤記修正
  15 2008.12.16 [v1.6]   v2.1.0-0 公開に伴う一部関連修正
  16 2009.01.27 [v1.7]   v2.1.1-0 公開に伴う一部関連修正
  17 2009.03.25 [v1.8]   v2.1.2-0 公開に伴う一部関連修正
  18 2009.06.17 [v1.9]   v2.1.2-2 公開に伴う一部関連修正
  19 2009.08.18 [v1.10]  v2.1.3-0 公開に伴う一部関連修正
  20
  21 --------------------------------------------------------------------------------
  22
  23  1 前提条件
  24      1.1 主な仕様
  25      1.2 事前準備
  26  2 L7 フレームワーク (l7vsd) のインストールと設定
  27      2.1 L7 負荷分散フレームワークのインストール
  28      2.2 L7 負荷分散フレームワークの起動方法
  29      2.3 L7 負荷分散フレームワークの動作確認
  30  3 L7 サーバ監視設定ツール (l7directord) の設定
  31      3.1 l7directord の設定方法
  32      3.2 l7directord の起動方法
  33      3.3 l7directord の動作確認
  34
  35 --------------------------------------------------------------------------------
  36
  37  1 前提条件
  38      本マニュアルが想定する環境を以下に示します。
  39
  40  1.1 主な仕様
  41      1.1.1 ハードウェア(推奨)
  42            CPU: Xeon 2.8GHz x2 相当、メモリ: 2GB 相当、HDD: 10GB 相当
  43            Ethernet: 1000BASE-T、1000BASE-SX
  44
  45      1.1.2 主なソフトウェア
  46            OS：Red Hat Enterprise Linux 5.3 (kernel2.6.18-xx) x86 版, x86_64 版
  47            L7 負荷分散フレームワーク (l7vsd)
  48            L7 サーバ監視設定ツール (l7directord)
  49
  50      1.1.3 本マニュアルで使用するソース
  51            ultramonkey-l7-2.1.3-0.tar.gz
  52            log4cxx-0.10.0
  53            apr-1.2.12.tar.gz
  54            apr-util-1.2.12.tar.gz
  55
  56       (※) 本マニュアルでは、上記のソースを使用することとして記述しております。
  57            異なるバージョン等使用する際には注意願います。
  58
  59  1.2 事前準備
  60      1.2.1 log4cxx のダウンロード
  61            log4cxx-0.10.0 を以下のサイトよりダウンロードします。
  62            http://logging.apache.org/log4cxx/download.html
  63
  64            また、log4cxx で必要となる apr ライブラリを以下のサイトよりダウンロー
  65            ドします。
  66            http://apr.apache.org/download
  67
  68       (※) OS 付属のメディアや yum を使って RPM パッケージでインストールする場合
  69            はダウンロードする必要はありません
  70
  71
  72      1.2.1.1 apr ライブラリのインストール
  73            apr ライブラリを解凍してインストールを行います。
  74
  75            # tar xvfz- apr-1.2.12.tar.gz
  76            # cd apr-1.2.12
  77            # ./configure --prefix=/usr --libdir=/usr/lib64
  78
  79       (※) ただし、32bit 環境の場合は /usr/lib64 を /usr/lib に変更してください
  80
  81            # make
  82            # make install
  83            これで apr ライブラリのインストールは終了です。
  84
  85            RPM パッケージでインストールする場合は、apr-devel.i386 をインストール
  86            してください。(x86_64 環境では apr-devel.x86_64)
  87            # rpm -ivh apr-devel-1.2.7-11.i386.rpm
  88            # rpm -ivh apr-devel-1.2.7-11.x86_64.rpm
  89            または
  90            # yum install apr-devel.i386
  91            # yum install apr-devel.x86_64
  92
  93      1.2.1.2 apr-util ライブラリのインストール
  94            apr-util ライブラリを解凍してインストールを行います。
  95
  96            # tar xvfz- apr-util-1.2.12.tar.gz
  97            # cd apr-util-1.2.12
  98            # ./configure --prefix=/usr --libdir=/usr/lib64 --with-apr=/usr
  99
 100       (※) ただし、32bit 環境の場合は /usr/lib64 を /usr/lib に変更してください
 101
 102            64bit 構成の場合にはそのまま作成された Makefile ではエラーになります
 103            ので、Makefile を編集します。32bit 環境の場合には追加は必要ありません
 104            # vi Makefile
 105            (変更前)
 106            APRUTIL_LIBS = ...
 107            (変更後: -L/usr/lib64を追加)
 108            APRUTIL_LIBS = -L/usr/lib64 ...
 109
 110            # make
 111            # make install
 112            これで apr-util のライブラリのインストールは終了です。
 113
 114            RPM パッケージでインストールする場合は、apr-util-devel.i386 をインス
 115            トールしてください。(x86_64 環境では apr-util-devel.x86_64)
 116            # rpm -ivh apr-util-devel-1.2.7-6.i386.rpm
 117            # rpm -ivh apr-util-devel-1.2.7-6.x86_64.rpm
 118            または
 119            # yum install apr-util-devel.i386
 120            # yum install apr-util-devel.x86_64
 121
 122      1.2.1.3 log4cxx のインストール
 123            log4cxx ライブラリを解凍してインストールを行います。
 124
 125            # tar xvfz- apache-log4cxx-0.10.0.tar.gz
 126            # cd apache-log4cxx-0.10.0
 127            # ./autogen.sh
 128            # ./configure --prefix=/usr --libdir=/usr/lib64
 129
 130       (※) ただし、32bit 環境の場合は /usr/lib64 を /usr/lib に変更してください
 131
 132            # make
 133            # make install
 134            これで log4cxx のライブラリインストールは終了です。
 135
 136      1.2.2 Perl モジュールのインストール
 137            ヘルスチェックに必要な Perl モジュールをインストールします。使用する
 138            監視方法によって必要となるモジュールが異なりますので、以下に従って必
 139            要なモジュールをインストールします。(括弧なしは CPAN 経由のみ、括弧あ
 140            りは RHEL5.3 のメディアから RPM パッケージでインストールもできます)
 141
 142            1. HTTP 監視に必要なモジュール
 143               libwww-perl (perl-libwww-perl)
 144
 145            2. HTTPS 監視に必要なモジュール
 146               libwww-perl    (perl-libwww-perl)
 147               Crypt::SSLeay  (perl-Crypt-SSLeay)
 148               Net::SSLeay    (perl-Net-SSLeay)
 149               IO-Socket::SSL (perl-IO-Socket-SSL)
 150            3. IMAP
 151               Mail::IMAPClient
 152
 153            4. LDAP
 154               Net::LDAP
 155
 156            5. DNS
 157               Net::DNS (perl-Net-DNS)
 158
 159            6. MySQL
 160               DBI        (perl-DBI)
 161               DBD::mysql (perl-DBD-MySQL)
 162
 163            7. PostgreSQL
 164               DBI     (perl-DBI)
 165               DBD::Pg (perl-DBD-Pg)
 166
 167       (※) CPAN 経由でインストールする場合の例
 168            # cpan -i Crypt::SSLeay
 169
 170       (※) RPM パッケージでインストールする場合の例
 171            # rpm -ivh perl-Crypt-SSLeay-0.51-11.el5.x86_64.rpm
 172            yum でインストールする場合の例
 173            # yum install perl-Crypt-SSLeay
 174
 175 --------------------------------------------------------------------------------
 176
 177  2 フレームワークのインストールと設定
 178
 179  2.1 L7 負荷分散フレームワークのインストール
 180
 181      2.1.1 L7 負荷分散フレームワークのインストール
 182      2.1.1.1 l7vsd のインストール
 183            ultramonkey-l7-2.1.3-0.tar.gz を展開します。
 184            # tar zxvf ultramonkey-l7-2.1.3-0.tar.gz
 185            # cd ultramonkey-l7-2.1.3-0
 186            # ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var \
 187                 --libdir='${prefix}/lib64'
 188
 189       (※) ただし、32bit 環境の場合 --libdir='${prefix}/lib64' は不要です。
 190
 191            # make
 192            # make install
 193
 194            注意:
 195            make 実行時に次のようなエラーが発生する場合、
 196
 197            src/Makefile.am: required file './compile' not found
 198            make: *** [Makefile.in] Error 1
 199
 200            または、git でソースコードをチェックアウトするなどして configure
 201            スクリプトが存在しない場合は、一度
 202            # autoreconf -if
 203            を実行した後、再度
 204            # ./configure
 205            から実行して下さい。
 206
 207            補足:
 208            configure マクロには以下のオプションがあります。
 209
 210            --with-l7vs_moddir=[MODULE DIRECTORY]
 211                プロトコルモジュール及びスケジュールモジュールをインストールする
 212                ディレクトリを指定します。デフォルトは /usr/(libdir)/l7vs です。
 213                libdir は ILP64 や ILP32 だとlib、LP64 や LLP64 だと /usr/lib64
 214                です。
 215
 216            --with-l7vsadm-sockdir=[SOCKET DIRECTORY]
 217                l7vsadm と l7vsd の通信に使用するソケットファイルを格納するディレ
 218                クトリを指定します。デフォルトは /var/run/l7vs です。
 219
 220            --with-l7vs-maxvs=[NUM]
 221                l7vsd の VirtualService の上限を指定します。デフォルトは 64 個で
 222                す。これは 32bit 環境と 64bit 環境で登録できる最大数が変動するた
 223                め、その差異を埋めるためにどちらの環境でも登録できる 64 個で制限
 224                しています。もし、64bit 環境でかつ 64 個以上の VirtualService を
 225                登録する必要がある場合には、この数字を増やすことで対応可能です。
 226                32bit 環境でも増やすことは出来ますが、その数について保証出来ませ
 227                ん。 (予期しない挙動をすることがあります)
 228
 229     2.2.1 L7 負荷分散フレームワークの起動
 230            # /etc/init.d/l7vsd start
 231
 232  2.3 L7 負荷分散フレームワークの動作確認
 233
 234      2.3.1 l7vsd の正常起動を確認
 235            # /etc/init.d/l7vsd status
 236            l7vsd running with pid: (PID)
 237            が表示されていることを確認します。
 238
 239 --------------------------------------------------------------------------------
 240
 241  3 L7 サーバ監視設定ツールのインストールと設定
 242
 243  3.1 l7directord の設定方法
 244      l7directord は設定ファイルを /etc/ha.d/conf/l7directord.cf に持ちます。
 245      UltraMonkey-L7 管理マニュアル (uml7-administration_manual_2.1.3-0_ja) 参照
 246      し、適宜設定を行ってください。
 247
 248  3.2 l7directord の起動方法
 249      # /etc/init.d/l7directord start
 250
 251  3.3 l7directord の動作確認
 252      # /etc/init.d/l7directord status
 253      を実行し、無事に起動できているかを確認してください。
 254