FAQ¶

Table of Contents¶

• FAQ
• Table of Contents
• General
• Q. Is it free?
• Q. What kind of the license is Karesansui under?
• Q. Does Karesansui support full-virtualization?
• Q. Does Karesansui only support Xen?
• Q. I'm not used to Linux. Is the installation easy?
• Q. There are already many virtulization management consoles around there. What are the pros of Karesansui?
• Q. I'd like to introduce Karesansui to others.
• Q. I'd like to use Karesansui in our company's network. Is there any license problems?
• Application
• Q. What happens when the database, which Karesansui refers, stops? Does the guest stop?
• Q. I'll get "You need Java installed" errors when I try to access the guest console.
• Q. Guest console doesn't show up. What can I do?
• Q. Guest console keymap is garbled.
• Q. I can't shutdown/stop guests.
• Q. It doesn't work.
• Logging
• Q. I want to change the log file rotation cycle, size, path, etc..
• Q. I found an error on the Karesansui control panel, but can't find corresponding message in the error log.
• Q. Can I change the log output style?
• Q. Where are the log files stored?
• Q. I have several log files. What are these?
• Q. "Update" panel is not displayed. (Error is displayed)
• Development/OSS
• Q. Binary package and source package seems to be all bundled in the installer package. Do you offer single package downloads?

General¶

Q. Is it free?¶

Yes, it is. You may use Karesansui for business or personal use for free.

Q. What kind of the license is Karesansui under?¶

Karesansui is mainly under GPL and LGPL. See here for details.

Q. Does Karesansui support full-virtualization?¶

Karesansui is aimed to support virtual servers so it does not support full-virtualization now. We are planning to support it in future. While it is not supported by Karesansui, you may setup full-virtualized guests using command line.

Q. Does Karesansui only support Xen?¶

Yes, it only supports Xen now. But we are planning to support KVM in near future.

Q. I'm not used to Linux. Is the installation easy?¶

We prepared and install pack so you should be able to install Karesansui easily. Please follow our Tutorial.

Q. There are already many virtulization management consoles around there. What are the pros of Karesansui?¶

We are working hard. Please take a look at our Karesansui's full ajax web control panel.

Q. I'd like to introduce Karesansui to others.¶

Yes! Thank you! Take the Get Karesansui Badge if you like it.

Q. I'd like to use Karesansui in our company's network. Is there any license problems?¶

No. Nothing. It's GPL/LGPL so there's no problem.

Application¶

Q. What happens when the database, which Karesansui refers, stops? Does the guest stop?¶

No. Karesansui uses the database to keep information for its user interface. Guests don't stop if when the database stops, but you will have problems to access Karesansui control panel.

Q. I'll get "You need Java installed" errors when I try to access the guest console.¶

We use TightVNC Java applet for guest console. So you need Java installed for your browser.

Q. Guest console doesn't show up. What can I do?¶

bq. First, Check if you can access your host. From your client's console, type

> ping {Karesansui server IP address or name}

bq. Next, Check if the VNC port is open on your Karesansui host.

# netstat -nalt

If all above are OK, then try to connect the guest from the client, using standard VNC viewer applications.

Q. Guest console keymap is garbled.¶

Select 'Display' from guest device tab, and set 'VNC Keymap'. Choose appropriate keymap.

Q. I can't shutdown/stop guests.¶

Try the following instructions. First check if acpid is running. On the guest console, do as shown below.

# ps auxww | grep acpid
root        34  0.0  0.0      0     0 ?        S<   10:50   0:00 [kacpid]
68        2420  0.0  0.0  12320   876 ?        S    10:51   0:00 hald-addon-acpi: listening on acpi kernel interface /proc/acpi/event
root      4082  0.0  0.0  65372   868 pts/0    S+   12:15   0:00 grep acpid

If /usr/sbin/acpid is not installed, install it. If /usr/sbin/acpid is not running, start it.

# rpm -q acpid 2>/dev/null || yum -y install acpid
# /etc/init.d/acpid start
# chkconfig acpid on

if acpid fails with error like "acpid: can't open /proc/acpi/event: Device or resource busy", try as following.

# /etc/init.d/haldaemon stop
# /etc/init.d/acpid start
# /etc/init.d/haldaemon start
# chkconfig acpid on

Check if acpid is running on guest again.

# ps auxww | grep acpi
root        34  0.0  0.0      0     0 ?        S<   10:50   0:00 [kacpid]
root      4107  0.0  0.0   3800   576 ?        Ss   12:18   0:00 /usr/sbin/acpid
68        4122  0.0  0.0  12320   880 ?        S    12:18   0:00 hald-addon-acpi: listening on acpid socket /var/run/acpid.socket
root      4142  0.0  0.0  65372   876 pts/0    S+   12:20   0:00 grep acpi

After acpid is started, try to shutdown/stop the guest.

Q. It doesn't work.¶

Go and ask your question in the Karesansui Forum . Somebody may answer you.

Logging¶

Q. I want to change the log file rotation cycle, size, path, etc..¶

Change "args" in the "[handler_*" category of log.conf

ex) Change log file size from 5M -> 10M

args=('/var/log/karesansui/application.log', 'a', (5 *1024 *1024), 5)
↓↓↓↓↓
args=('/var/log/karesansui/application.log', 'a', (10 *1024 *1024), 5)

ex) Change log file name from application.log -> server.log
args=('/var/log/karesansui/application.log', 'a', (5 *1024 *1024), 5)
↓↓↓↓↓
args=('/var/log/karesansui/server.log', 'a', (5 *1024 *1024), 5)

Change log rotate files from 5 -> 10
args=('/var/log/karesansui/application.log', 'a', (5 *1024 *1024), 5)
↓↓↓↓↓
args=('/var/log/karesansui/application.log', 'a', (5 *1024 *1024), 10)

Q. I found an error on the Karesansui control panel, but can't find corresponding message in the error log.¶

May be the message is filtered by the log level. Check the level in "[logger_*" category of log.conf.

Log levels (From high to low. Higher level include lower level.)
 - DEBUG : Log all
 - INFO : General information
 - WARNING : Log warnings (recommended)
 - ERROR : Log errors
 - CRITICAL : Log severe errors
 - EXCEPTION : Log system errors

After changing log.conf, restart the web server.

Q. Can I change the log output style?¶

We use python logging. Check python logging instructions.

Q. Where are the log files stored?¶

Where defined in "args" of "[handler_*" category of log.conf.

Q. I have several log files. What are these?¶

Karesansui writes log in several files.

General log of Karesansui: /var/log/karesansui/application.log
Program trace for errors: /var/log/karesansui/error.log
SQL committed by Karesansui: /var/log/karesansui/sql.log

Q. "Update" panel is not displayed. (Error is displayed)¶

A. May be the proxy server is not properly set. Check the proxy settings in "Top" - "Settings".

ex) (Bad Request) [400] ('Cannot retrieve repository metadata (repomd.xml) for repository: karesansui-base. Please verify its path and try again',) 

Development/OSS¶

Q. Binary package and source package seems to be all bundled in the installer package. Do you offer single package downloads?¶

A. We offer Karesansui package downloads via HTTP.
Karesansui software update (using yum) also accesses the URL below.

URL : http://updates.karesansui-project.info/
id : karesansui
password : karesansui