FAQ
(based on Ja_faq#21)¶

Table of Contents¶

• FAQ
  (based on Ja_faq#21)
• 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. It doesn't work.
• Logging
• Q. How can I change the maximum size of log files, its file path or the number of rotated files?
• Q. An error message is displayed on the screen but it seems that these trace messages are not properly written to the log file.
• Q. I'd like to change the format of log files.
• Q. Where is the log file found?
• Q. I found three log files. What does the each log file contain?

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?¶

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

> ping {Karesansui server IP address or name}

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. It doesn't work.¶

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

Logging¶

Q. How can I change the maximum size of log files, its file path or the number of rotated files?¶

You need to change "args" parameter in "[handler_*" catetories of log.conf. The following example shows how you can change those settings.

In case that you want to change the maximum size of log file from 5 Mbytes to 10 Mbytes:

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

In case that you want to change the name of log file from application.log to server.log:

(before) args=('/var/log/karesansui/application.log', 'a', (5 *1024 *1024), 5)
(after) args=('/var/log/karesansui/server.log', 'a', (5 *1024 *1024), 5)

In case that you want to change the maximum number of rotated log files from 5 to 10:

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

Q. An error message is displayed on the screen but it seems that these trace messages are not properly written to the log file.¶

It is possible that logging is limited by specific log level. Please check the level in category of "[logger_*".

Avaliable Log Levels (* The former level includes the latter.)
 - DEBUG : All messages.  debug-level message.
 - INFO : Informational message.
 - WARNING : Warning conditions. This is recommended during operation.
 - ERROR : Error conditions.
 - CRITICAL : Critical and fatal conditions.
 - EXCEPTION : Application error message.

Notice: You must restart the Web service, or lighttpd, for the changes to take effect.

Q. I'd like to change the format of log files.¶

Karesansui supports all the format that is avaliable in Python logging. So please check Python official site for details.

Q. Where is the log file found?¶

The path of the log file is set as a value of "args" parameter in "[handler_*" categories of log.conf.

Q. I found three log files. What does the each log file contain?¶

Karesansui outputs the following multiple log files:

General Log	/var/log/karesansui/application.log
Error Trace Log	/var/log/karesansui/error.log
Executed SQL Log	/var/log/karesansui/sql.log