h1. チュートリアル

h3. はじめに

このチュートリアルでは、パッケージング済みのKaresansuiを利用したインストールから、実際にゲスト上にOSインストールし動作させるまでを紹介します。

h3. 概念図

!karesansui-net.jpg!

h3. 事前に

h4. ホストOSのインストール

CentOS5.3以降のISOイメージを利用しホストOSを作成します。

通常のインストール手順で問題ありませんが、以下の点に気をつけてインストールしてください。

(必須) ソフトウェアのセットアップで「仮想化」にチェックを入れてください。

(必須ではありません) LVMを利用することを推奨しています。ストレージ拡張を容易に行えるため。

注）デフォルトパーティションを利用するとデフォルトでLVMになります。

!install-software-select.png!

h3. インストール前準備

Karesansuiは、先ほどのインストールされなかった　[[Ja_reference#依存関係での問題|インストールパッケージ]]　が必要です。別途インストールする必要があります。

h3. ダウンロード

"ダウンロードページ":http://sourceforge.jp/projects/karesansui/releases/ から最新のKaresansui-1.x.tar.gzをダウンロードします。

h5. sourceforge.jpのダウンロードページ

!karesansui-sourceforge-jp.png!

h3. インストール

ダウンロードしたファイルをホストOS上の任意のディレクトリへ保存し、スーパーユーザー権限でパッケージの展開、および、インストールスクリプトの実行を下記コマンドにより行います。

<pre>

# tar xzvf Karesansui-1.0.tar.gz

# cd Karesansui

# ./karesansui-install

</pre>

インストールスクリプト実行後の画面の流れは下記の通りです。

<br/>

h4. 「ようこそ」画面

「OK」ボタンを押して、そのまま次の画面へ進みます。

!Karesansui-install-1_welcome_.png!

<br/>

h4. 「管理者の設定」画面

Karesansuiの管理画面にログインする管理者の設定を行います。各項目の説明は下記の通りです。

| ホスト名(FQDN) |このホストOSのFQDNを入力します。|

| パスワード | 管理者の認証パスワードを入力します。 管理画面へアクセスに必要です。|

| パスワード(再入力) | 上記パスワードを再入力します。 |

| メールアドレス | 管理者のメールアドレスを入力します。管理画面へアクセスに必要です。 |

| 言語 | 管理者の利用する言語を選択します。管理画面で表示される言語です。 |

!Karesansui-install-2_admin_.png!

<br/>

h4. 「データベース設定」画面

Karesansuiが利用するデータベースに関する設定を行います。

MySQLやPostgreSQLを利用する場合は、あらかじめデータベースを作成し、ホストOSから接続可能なことを確認してください。

| データベースパス | Karesansuiが利用するデータベースを指定します。 |

| データベースを初期化する | データベースに初期データを投入する場合は選択します。 |

h5. データベースパスの指定方法は、下記の通りです。

| MySQL | mysql://username:password@hostname/database?charset=utf8 |

| PostgreSQL | pgsql://username:password@hostname/database |

| SQLite | sqlite:////var/opt/karesansui/karesansui.db |

!Karesansui-install-3_database_.png!

<br/>

h4. 「確認」画面

インストールを続行したい場合は、「OK」を押し、ソフトウェアのインストールを始めます。

これまでの入力に誤りがある場合やインストールを中断したい場合は、「戻る」、「取り消し」を押してください。

!Karesansui-install-4_confirm_.png!

<br/>

h4. 「進捗」画面

ソフトウェアのインストールの進捗状況が表示されます。

ソフトウェアのインストール、設定ファイルの書き込み、データベースの初期化、サービスの有効化 の順に進捗します。

!Karesansui-install-5_pkgadd_.png!

<br/>

h4. 「完了」画面

インストールが正常に完了すると、下記画面のようにメッセージが表示されます。

インストールの途中でエラーになると、エラー原因のメッセージが表示されます。エラーメッセージはインストールログにも出力されますので、ログを確認した後、エラー原因を解消し再度インストールを行ってください。

!Karesansui-install-6_finish_.png!

インストールスクリプト実行後のコマンド出力

<pre>

終了しました。

下記サイトにアクセスしログインしてください。ログインIDは'taizo@karesansui-project.info'です。

 https://host.example.com/karesansui/v1/

 http://host.example.com/karesansui/v1/

詳細は、/root/karesansui-install.log を参照してください。

</pre>

h3. 管理画面の確認

インストール完了後に表示された 'https://{ホスト名}/karesansui/v1/' に接続すると、認証ダイアログが表示されますので、インストール時に指定した管理者のメールアドレスとパスワードを入力します。

!{width:500px}karesansui-auth-ja.png!

認証をパスして、以下のような画面が表示されればインストールは成功です。

!{width:500px}karesansui-top-ja.png!

h3. ゲストのOSインストール準備

以降は、ゲストに CentOS 5.3(i386) をインストールする場合を例に、２通りの方法を説明します。

<br/>

h5. 1. 既にインターネットに繋がる環境の場合（ネットワークインストール）

ホストOSが既にインターネットに繋がっている場合は、外部サーバー上にある、カーネルイメージ、および、OSイメージを取得してインストールを行います。プロキシサーバー経由でのインストールはできませんので、その場合はFTPサーバーを利用してください。

ホストOSから CentOS 5.3 のOSイメージのURLに接続可能であるかどうかを確認してください。

URLの例

<pre>

http://<OSイメージ配布サイトのFQDN>/centos/5/os/i386/

ftp://<OSイメージ配布サイトのFQDN>/Linux/centos/5/os/i386/

</pre>

h5. 2. インターネットに繋がらない環境の場合（ローカルインストール）

ホストOSがインターネットに繋がっていない場合は、CentOS 5.3(i386)のDVDを利用してインストールを行います。その際、一時的にホストOS上にFTPサーバーを稼働させる必要がありますので、vsftpd等のFTPサーバーソフトウェアをあらかじめインストールしておきます。

CentOS 5.3(i386)のDVDをドライブに挿入し、下記の方法でOSイメージをホストOSのAnonymousFTPの領域へマウントします。

<pre>

# rpm -q vsftpd 2>/dev/null || yum -y install vsftpd

# /etc/init.d/vsftpd restart

# mount /dev/cdrom /var/ftp

</pre>

localhostにAnonymousFTPでログインが可能か確認します。

<pre>

# ftp localhost

Connected to localhost (127.0.0.1).

220 (vsFTPd 2.0.5)

Name (localhost:root): ftp

331 Please specify the password.

Password:

230 Login successful.

Remote system type is UNIX.

Using binary mode to transfer files.

ftp> quit

</pre>

ログインができない場合は、SELinuxが有効になっている可能性がありますので、下記の方法で一時的に無効にしてください。

<pre>

# echo 0 >/selinux/enforce

</pre>

h3. ゲストへのOSインストール

まず、Karesansuiのトップ画面のホストアイコンをクリックします。

その後、表示される「ゲスト一覧」タブ内の「作成」ボタンをクリックすると以下のような「ゲスト作成」画面が表示されます。

!{width:500px}karesansui-guest-create-ja.png!

入力方法を、前述のインストールのタイプごとに示します。

h5. 1. 既にインターネットに繋がる環境の場合（ネットワークインストール）

| カーネルイメージ | 接続可能な外部のWebサーバーまたはFTPサーバー上のカーネルイメージのURL<br/>(例：'ftp://ftp.example.com/Linux/centos/5/images/xen/vmlinuz') |

| initrdイメージ | 接続可能な外部のWebサーバーまたはFTPサーバー上のinitrdイメージのURL<br/>(例：'ftp://ftp.example.com/Linux/centos/5/images/xen/initrd.img') |

その他、各項目の入力方法に関しては、項目名の右に表示される「？」をクリックして確認してください。

h5. 2. インターネットに繋がらない環境の場合（ローカルインストール）

| カーネルイメージ | /var/ftp/images/xen/vmlinuz |

| initrdイメージ | /var/ftp/images/xen/initrd.img |

その他、各項目の入力方法に関しては、項目名の右に表示される「？」をクリックして確認してください。

<br/>

全ての入力が完了したら、「ゲスト作成」画面の最下部にある「作成」ボタンをクリックしてください。

クリック後、ゲスト作成のジョブを受理した旨のメッセージが表示されますので、「閉じる」ボタンで「ゲスト作成」画面を閉じます。

その後表示されるゲスト一覧画面に、今作成したゲストのアイコンが追加されます。

!{width:500px}karesansui-host-top-2-ja.png!

作成されたゲストのアイコンをクリックし、その後表示されるゲスト画面の「コンソール」タブをクリックします。

ゲストのコンソール画面が表示され、コンソール画面において通常のCentOS 5.3 のOSインストールと同じようにゲスト上にOSをインストールすることができます。

!{width:500px}karesansui-guest-console-ja.png!

h5. 1. 既にインターネットに繋がる環境の場合（ネットワークインストール）

OSインストール時の「Installation Method」の選択では前述のカーネルイメージで指定したプロトコル（「HTTP」または「FTP」）を選択し、「HTTP」の場合は「HTTP Setup」、「FTP」の場合は「FTP Setup」で接続先を設定してください。

| Web site name または FTP site name | OSイメージ配布サイトのFQDN |

| CentOS directory | 上記サイト上のパス(例：/Linux/centos/5/os/i386) |

h5. 2. インターネットに繋がらない環境の場合（ローカルインストール）

OSインストール時の「Installation Method」の選択では「FTP」を選択し、「FTP Setup」で下記のようにFTPの接続先を設定してください。

| FTP site name | ホストOSのIPアドレス(ループバックアドレスでない) |

| CentOS directory | / |

h3. 最後に

以上で、ゲストにOSをインストールするまで作業は終了です。

ゲストへのOSインストールが終了したら、ゲスト画面の「サマリ」タブに表示される「開始」「停止」「再起動」ボタンでゲストの起動、シャットダウン、再起動を行うことができます。