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.
• ログ関連
• Q. ログファイルのサイズ・ファイルパス・ローテート数を変更したいんだけどどうすればいい？
• Q. 画面でエラーが発生したがうまくログ出力されていないみたい。
• Q. ログの出力形式を変更したいんだけど。
• Q. ログファイルってどこに出力されるの？
• Q. ログファイルが3つあるんだけど

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

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

ログ関連¶

Q. ログファイルのサイズ・ファイルパス・ローテート数を変更したいんだけどどうすればいい？¶

log.conf内の "[handler_*"カテゴリにある "args" を変更します。以下に変更例を記載します。

ログファイルサイズ 5M を 10Mにする場合

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

ログファイル名を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)

ログローテートを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. 画面でエラーが発生したがうまくログ出力されていないみたい。¶

ログレベルによってログの出力を制限している可能性があります。 "[logger_*"カテゴリのlevelを確認してください。

ログレベル一覧(※上は下を包括します。)
 - DEBUG : 全て出力
 - INFO : 一般情報のみ出力
 - WARNING : 警告のみ出力(運用時の推奨設定)
 - ERROR : エラーのみ出力
 - CRITICAL : 深刻なエラーのみ出力
 - EXCEPTION : システム的なエラーのみ出力

補足 : ログ設定の変更時はウェブサーバーの再起動が必要です。

Q. ログの出力形式を変更したいんだけど。¶

Python loggingで利用できるすべての形式に対応していますので詳しくはそちらを参照ください。

Q. ログファイルってどこに出力されるの？¶

log.conf内の "[handler_*"カテゴリにある "args" に定義されています。

Q. ログファイルが3つあるんだけど¶

Karesansuiのログは複数のファイルで構成されています。

Karesansui全体のログ : /var/log/karesansui/application.log
Karesansuiで発生したエラーのプログラムトレースログ : /var/log/karesansui/error.log
Karesansuiが発行したSQL関連のログ : /var/log/karesansui/sql.log