Sheepdog/利用方法の編集

[[Sheepdog/概要]]

*sheepdogの利用方法 [#hb1c06d9]

** corosyncの設定 [#e8e5b726]
sheepdogの設定に入る前にcorosyncの設定を行います．~
corosyncはクラスタ環境を構築するために利用するIPアドレスを指定する設定が必要です．
/etc/corosync内にcorosync.conf.sampleがあるので，同じディレクトリにcorosync.confをいう名前でコピーします．
 $ cd /etc/corosync
 $ sudo cp corosync.conf.example corosync.conf
次にcorosync.confを編集します．
ここではIPアドレス192.50.109.182をクラスタ環境の構築に利用します．

# Please read the corosync.conf.5 manual page
 compatibility: whitetank
 
 totem {
     version: 2
     secauth: off
     threads: 0
     interface {
         ringnumber: 0
         bindnetaddr: 192.50.109.182 # クラスタ環境の構築に利用するIPアドレス
         mcastaddr: 226.94.1.1
         mcastport: 5405
     }
 }
 
 logging {
     fileline: off
     to_stderr: yes
     to_logfile: yes
     to_syslog: yes
     logfile: /tmp/corosync.log
     debug: off
     timestamp: on
     logger_subsys {
         subsys: AMF
         debug: off
     }
 }
 
 amf {
     mode: disabled
 }

** sheepdogの設定 [#a691dda8]
sheepdogの利用にはcorosyncとqemu-kvmを使用します．
各ソフトウェアのインストール方法は[[こちら>Sheepdog/インストール方法]]を参考にしてください．

まずクラスタ環境に使用するディスクスペースの設定を行います．~
ここでは，クラスタ環境に提供するディスクをstore_device，store_deviceをマウントしているディレクトリをstore_dirとしています．~
store_dirとして提供するディレクトリはxattrをサポートしている必要があります．~
そのため，マウントオプションでxattrを有効にしておきます．~
例として，ext3でのオプションの指定方法を書いておきます．
 $ sudo mount -o remount,user_xattr /store_device

次に，マウントしているディレクトリをクラスタ環境に提供します．
--（注）sheepdogはcollieという名前のプログラムで起動しますが，collieで指定するstore_dirには何も入っていないことを先に確認してください．

$ sudo sheep /store_dir
デフォルトではTCPの7000番ポートが使用されます．ポート番号を変更したい場合は，
 $ sudo sheep --port 7000 /store_dir
でポート番号の変更が可能です．
また-dオプションをつけるとデバックメッセージの表示が可能です．
 $ sudo sheep --port 7000 /store_dir -d
最新のsheepdogでは、sheep /store_dirで-dのオプションまでつきます．~
sheepdogのディレクトリに起動スクリプトも用意されています．
 $ cd sheepdog
 $ sudo sudo script/start-sheepdog
なお，sheepdog起動時に現在動作しているsheepdogを停止させるスクリプトも同時に動作するため，start-sheepdogの起動はscriptディレクトリの指定から行う必要があります．
また，start-sheepdogで起動した場合，/tmp以下にXX.XXXXXX（Xには数字が入ります．）という名前のディレクトリが作成され，そのディレクトリがstore_dirとなります．

start-sheepdogが起動すると各ノードは自律的にクラスタ環境を構築します．
どのノードがクラスタ環境を構築しているかは以下のコマンドで確認できます．
 $ collie node list

ここでは8台でクラスタ環境を構築したとします．
この際に，collie node listでは，以下のような表示がでるはずです．(IPアドレス，Node idは各環境によって異なります．)

$ collie node list
    Idx	Node id (FNV-1a) - Host:Port
 ------------------------------------------------
 * 0	3751ad4d1b9d6dcb - 192.50.109.182:7000
   1	492815213580505c - 192.50.109.185:7000
   2	d0c7ee6eee054e72 - 192.50.109.187:7000
   3	d208d1cfb8fb0451 - 192.50.109.184:7000
   4	dfefba81b1c87f1f - 192.50.109.186:7000
   5	e48b7ede454ea360 - 192.50.109.189:7000
   6	eb7f884fecfa4f35 - 192.50.109.188:7000
   7	ed01cd77b045713e - 192.50.109.183:7000

ファイルシステムの構築を行います．~
copiesは冗長構成を行う数を指定します．~
ここでは，3台のマシンにデータを複製するように指定しています．
 $ collie cluster format --copies=3

** VMイメージの作成 [#xc3e4f17]
sheepdogで利用するVMイメージはqemu-imgを用いて作成します．
インストールのページでgitを用いてダウンロードしたqemu-kvmをインストールしていれば，VMイメージのフォーマットにsheepdogが追加されているはずです．
 $ qemu-img create -f sheepdog Alice 40G

VMイメージが正しく作成されたかは，以下のコマンドで確認できます．
 $ collie vdi list
   name        id    size    used  shared    creation time  object id
 --------------------------------------------------------------------
   Alice        1   40 GB  0.0 MB  0.0 MB 2010-05-02 13:16  8015d16700000000

- エラーが出る場合には，以下の点を見直してみてください．
--collie で指定するディレクトリはユーザ拡張属性が利用可能か.（ext3 であれば, マウントオプションに user_xattr がついているか
-- sheepで指定するディレクトリが空の状態で起動しているか
-- collie cluster format を実行したか

また，既に作成した他のフォーマットのVMイメージからsheepdog用のVMイメージに変換することもできます．
 $ qemu-img convert -f raw -O sheepdog ~/amd64.raw Bob

** VMの起動 [#jdabb5c8]
仮想マシンの起動は以下のコマンドで行います．
 $ qemu-system-x86_64 --drive format=sheepdog,file=Alice

CDドライブから起動する場合には、-cdromのオプションでisoイメージを指定し，-bootオプションでdを指定します．
 $ qemu-system-x86_64 --drive format=sheepdog,file=Alice -cdrom <iso_file> -bood d

qemu-system-x86_64でVMを起動すると，VNCがlocalhostの5900番ポートで待ち受けます．~
画面を表示するにはサーバ上でVNC Viewerを使用するか，SSHのX11 forwardingなどを使用して，VNCの画面をリモート上で表示します．~
今回の例だと，192.50.109.182のサーバ上でVMを起動したので，192.50.109.182のサーバにSSHのX11forwardingを有効にしてログインした後，vncviewerを起動します．
 $ ssh 192.50.109.182 -X
 サーバにloginします．
 $ vncviewer localhost:5900
vncviewerが起動すると，PC上に画面が表示されるはずです．

#ref(qemu-vnc.png)

以下に自動自動のためのスクリプトを書いておきます．
debianですと，/etc/rc.localに記述すると良いと思います．
2010年5月3日にこのスクリプトでsheepdogがOS起動時に自動的に起動することを確認しています．（store_dirは適宜書き換えてください）
 /usr/sbin/corosync
 /bin/rm -rf /store_dir/*
 /usr/sbin/sheep /store_dir

タイムスタンプを変更しない

[[Sheepdog/概要]]

*sheepdogの利用方法 [#hb1c06d9]

また，既に作成した他のフォーマットのVMイメージからsheepdog用のVMイメージに変換することもできます．
 $ qemu-img convert -f raw -O sheepdog ~/amd64.raw Bob

** VMの起動 [#jdabb5c8]
仮想マシンの起動は以下のコマンドで行います．
 $ qemu-system-x86_64 --drive format=sheepdog,file=Alice

#ref(qemu-vnc.png)

テキスト整形のルールを表示する

Sheepdog/利用方法 の編集