Xen/KVM Virtualization Management Application
  • 日本語
  • English

Karesansui Wiki


(Translation based on http://karesansui-project.info/wiki/karesansui/Ja_tutorial?version=77)

Tutorial

Abstract

On this tutorial, we will go through brief instruction from Karesansui installation (using packages), to boot guest.

Goal

karesansui architecture

Preparing

Install Host OS

Use CentOS 5.4 or later to create host environment.

Just do usual installation, but be careful of the points below.

(Required) On software setup, check "Virtualization", "KVM".
(Not required but encouraged) Use LVM. It's easy to add storage in future. (It will be LVM-ready if you use the default partition offered by the installer)

CentOS 5.4 install select packages 1
CentOS 5.4 install select packages 2

Additional Requirements

Karesansui requires the following packages. Please make sure that these packages are installed.

  • iscsi-initiator-utils
  • cyrus-sasl-md5
  • gnutls-utils
  • PyXML
  • SDL
  • curl

Download

Download the newest release from the Download Page.

sourceforge.jp

Installation

Installing Karesansui is very easy.
The installation steps will be as follow:

# tar xzvf karesansui-1.1.0-1-install-pack.tar.gz
# cd Karesansui
# ./karesansui-install

Here is the detailed instructions.



'Welcome' screen

Push 'OK' button to display the next page.

Install 1



'Administrator setting' screen

Setting up Karesansui administrator account.

Hostname FQDN of this Host OS
Password administrator's password. Requires this password at login.
Password (again) the same password as 'Password' for confirmation
Mail address administrator's e-mail address. Requires this password at login.
Language language that administrator uses.

Install 2



'TLS certificates setting' screen

Setting up TLS certificates for libvirt remote SSL connection.

Country country ISO 2 letter code
State or Province Name your state or province name
Locality Name your location (e.g. town)
Origanization Name your organization (e.g. company name)
Common Name FQDN of this Host OS
Initialize SSL certificates settings? initialize SSL keys and certificates

Install 3



'Database setting' screen

Setting up Karesansui database.

In case of using MySQL or PostgreSQL as database, you need to create a database for Karesansui in advance and make sure to connect the database.

Database path a database for Karesansui
Database pysilhouette path a database for pysilhouette job management daemon
Initialize database initialize database
Please specify a database in using the following pattern:
MySQL mysql://username:password@hostname/database?charset=utf8
PostgreSQL pgsql://username:password@hostname/database
SQLite sqlite:////var/opt/karesansui/karesansui.db

Install 4



'Confirm' screen

Press 'OK' button to proceed installation, then the software installation will start.
Press 'Back' or 'Cancel' to abort installation.

Install 5



'Progress' screen

The current progress state of software installation is displayed.
Installation process goes on like this:
1. Installing the RPM packages.
2. Generating SSL certificates.
3. Writing the configuration files.
4. Initializing Karesansui database.
5. Enabling Karesansui services.

Install 6



'Finish' screen

When the installation process has finished successfully, the following screen will be displayed.

An error occurred and installation failed, then the error message will be displayed.
See log file for error details and resolve the error, then please install again.

Install 8

Console output goes like this:
Done.
You can now login through following url. Your login credential is 'taizo@karesansui-project.info'.
 https://karesansui.example.com/karesansui/v1/
 http://karesansui.example.com/karesansui/v1/
See '/root/karesansui-install.log' for detail.
In the case that the KVM hypervisor is running on your machine, network device configuration files will be modified by installer. So you should reload network.
# /etc/init.d/network restart

Logging in to the Management Console

Try the URL displayed on the "Finish" screen (like "https://{hostname}/karesansui/v1/").
Please input e-mail address and password in user authentication dialog, then login to the Management Console.
Authentication dialog

If you see the screen like this, then the installation had all succeeded.
Top page

Preparing for Guest OS Installation

Here is an example of installing CentOS 5.4(i386) to guest.
We describe two ways to do that.



1. if the host is able to connect to the internet. (Network Install)
Using kernel image and OS image on an external server, you can install guest OS.
You cannot retrieve the images via proxy server at installation, so you should use an external FTP server.
Be sure that the host is able to connect to the URL of CentOS 5.4's OS image.
Examples of URL:
http://<Web site name>/centos/5/os/i386/
ftp://<FTP site name>/Linux/centos/5/os/i386/
2. if the host is NOT able to connect to the internet. (Local Install/CD-ROM)
Using CentOS 5.4(i386) DVD, you can intall guest OS.
You'll need to setup your own FTP server temporarily, so you have to install FTP server software like vsftpd in advance.
Please insert CentOS 5.4(i386) DVD to drive, and mount OS image on AnonymousFTP area.
# rpm -q vsftpd 2>/dev/null || yum -y install vsftpd
# /etc/init.d/vsftpd restart
# mount /dev/cdrom /var/ftp/pub
Check to be sure that you can login to localhost as AnonymousFTP user.
# 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
If you fail to login, SELinux may work.
Please set SELinux disabled temporarily by executing the following command.
# echo 0 >/selinux/enforce
3. if the host is NOT able to connect to the internet. (Local Install/ISO image)

In the case that the KVM hypervisor is running on your machine, you can install from CD-ROM ISO image.

If you doesn't have CD-ROM ISO image but DVD-ROM, 'dd' command can create CD-ROM ISO image.
# dd if=/dev/cdrom of=/iso/centos54-i386.iso
dd: reading `/dev/cdrom': Input/output error
269860+0 records in
269860+0 records out

Installing Guest OS

First, please click the host icon image on top window.
And click the 'Create' in 'Guests' tab, then 'Create guest' window as follow will be displayed.
Create guest page

Here we describe the ways to specify values for each item.

1. if the host is able to connect to the internet. (Network Install)
Kernel image the URL of CentOS 5.4's kernel image path
(ex: case of Xen=>'ftp://ftp.example.com/Linux/centos/5/os/i386/images/xen/vmlinuz', case of KVM=>'ftp://ftp.example.com/Linux/centos/5/os/i386/isolinux/vmlinuz')
initrd image the URL of CentOS 5.4's initrd image path
(ex: case of Xen=>'ftp://ftp.example.com/Linux/centos/5/os/i386/images/xen/initrd.img', case of KVM=>'ftp://ftp.example.com/Linux/centos/5/os/i386/isolinux/initrd.img')

As for other items, you can see the details clicking "?" displayed at the right of each item.

2. if the host is NOT able to connect to the internet. (Local Install)
Kernel image case of Xen=>'/var/ftp/pub/images/xen/vmlinuz', case of KVM=>'/var/ftp/pub/isolinux/vmlinuz'
initrd image case of Xen=>'/var/ftp/pub/images/xen/initrd.img', case of KVM=>'/var/ftp/pub/isolinux/initrd.img'

As for other items, you can see the details clicking "?" displayed at the right of each item.



Fill up all items, please click the "Create" button at the bottom of "Create guest" window.
Then, the message that the creation job is accepted will be displayed.

So the icon image that stands for new guest will appear in "Guests" window.
Guest list page 2

Please click the new guest icon, and then click the "Console" tab.
The console window of guest will be displayed. In this window, you can install CentOS 5.4 into guest as into real machine.

Guest console page

1. if the host is able to connect to the internet. (Network Install)

In the guest installation,

  • 1. Selecting an Installation Method*
    You need to select the "HTTP" or "FTP".
  • 2 - 1. Installing via HTTP
    Web site name Web site name that provides OS image
    CentOS directory image path on this site(ex: /Linux/centos/5/os/i386)
  • 2 - 2. Installing via FTP
    FTP site name FTP site name that provides OS image
    CentOS directory image path on this site(ex: /Linux/centos/5/os/i386)
2. if the host is NOT able to connect to the internet. (Local Install)

In the guest installation,

  • 1. Selecting an Installation Method*
    You need to select the "FTP".
  • 2. Installing via FTP
    FTP site name IP address of host (NOT loopback address)
    CentOS directory /pub/

End

This is the end of the tutorial. You can now do basic operation about virtualization.

karesansui-guest-console-en.png - Guest console page (77.5 KB) Taizo Ito, 05/21/2009 11:12 AM

karesansui-net.jpg (74.8 KB) Taizo Ito, 05/21/2009 11:12 AM

karesansui-auth-en.png - Authentication dialog (24.1 KB) Taizo Ito, 05/21/2009 11:12 AM

karesansui-top-en.png - Top page (71.1 KB) Taizo Ito, 05/21/2009 11:12 AM

karesansui-guest-create-en.png - Create guest page (63.4 KB) Taizo Ito, 05/21/2009 11:12 AM

karesansui-host-top-2-en.png - Guest list page 2 (75.8 KB) Taizo Ito, 05/21/2009 11:12 AM

sourceforge.png - sourceforge.jp (64.4 KB) Taizo Ito, 05/22/2009 09:24 PM

Karesansui-install-1_welcome_.png - Install 1(Welcome) (27.6 KB) Junichi Shinohara, 06/22/2009 02:23 PM

Karesansui-install-2_admin_.png - Install 2(Admin) (38.7 KB) Junichi Shinohara, 06/22/2009 02:24 PM

Karesansui-install-3_database_.png - Install 3(Database) (50.3 KB) Junichi Shinohara, 06/22/2009 02:24 PM

Karesansui-install-5_pkgadd_.png - Install 5(PkgAdd) (26.4 KB) Junichi Shinohara, 06/22/2009 02:25 PM

Karesansui-install-6_finish_.png - Install 6(Finish) (38.2 KB) Junichi Shinohara, 06/22/2009 02:26 PM

Karesansui-install-4_confirm_.png - Install 4(Confirm) (27.8 KB) Junichi Shinohara, 06/22/2009 02:26 PM

install-software-select.png (104.9 KB) Junichi Shinohara, 06/22/2009 03:24 PM

Karesansui-v1.1-install-1_welcome_.png - Install 1(Welcome) v1.1 (9.7 KB) Taizo Ito, 01/06/2010 10:45 AM

Karesansui-v1.1-install-2_admin_.png - Install 2(Admin) v1.1 (11.7 KB) Taizo Ito, 01/06/2010 10:45 AM

Karesansui-v1.1-install-3_certificate_.png - Install 3(Certificate) v1.1 (12.7 KB) Taizo Ito, 01/06/2010 10:45 AM

Karesansui-v1.1-install-4_database_.png - Install 4(Database) v1.1 (13.3 KB) Taizo Ito, 01/06/2010 10:45 AM

Karesansui-v1.1-install-5_confirm_.png - Install 5(Confirm) v1.1 (9.8 KB) Taizo Ito, 01/06/2010 10:45 AM

Karesansui-v1.1-install-6_pkgadd_.png - Install 6(PkgAdd) v1.1 (9.8 KB) Taizo Ito, 01/06/2010 10:46 AM

Karesansui-v1.1-install-7_writeconf_.png - Install 7(WriteConf) v1.1 (9.4 KB) Taizo Ito, 01/06/2010 10:46 AM

Karesansui-v1.1-install-8_finish_.png - Install 8(Finish) v1.1 (11.5 KB) Taizo Ito, 01/06/2010 10:46 AM

centos54-install-select-pkg1-en.png - CentOS 5.4 install select packages 1 (100.7 KB) Taizo Ito, 01/06/2010 12:43 PM

centos54-install-select-pkg2-en.png - CentOS 5.4 install select packages 2 (99.7 KB) Taizo Ito, 01/06/2010 12:43 PM

karesansui-net.png - karesansui architecture (14.6 KB) Taizo Ito, 01/07/2010 06:30 PM

Also available in: HTML TXT