h1. FAQ

h1. 目次

<br>

{{toc}}

<br>

<br>

h1. 一般

h2. Q. 無料で利用できるの？

bq. Karesansuiは商用、非商用を問わずだれでも無料で利用することができます。

h2. Q. Karesansuiはどんなライセンスなの？

bq. GPLとLGPLで構成するライセンスになっています。詳細は[[Ja_license|こちら]]を参照してください。

h2. Q. 完全仮想化には対応してないの？

bq. 現時点では対応していませんが、コミュニティで検討されています。

Karesansuiとしては対応してませんが、直接コマンドを実行することで動作させることができます。

Karesansuiで完全仮想化をできないよう制限していることはありません。

h2. Q. 対応するハイパーバイザーはXenだけなの？

bq. 現在サポートしているのはXenだけですが、近い将来 KVM にも対応する予定です。

h2. Q. Linuxに詳しくないんだけどインストールって簡単？

bq. インストールパックを用意していますので、簡単にインストールが可能です。初めての方は[[Ja_tutorial#チュートリアル|チュートリアル]]をご覧ください。

h2. Q. 他にもいろんな仮想化ソフトがあるけどKaresansuiだとなにかメリットがあるの？

bq. Karesansuiを使えば複雑な操作から解放されるはずです。Karesansuiは誰でも簡単に仮想化ができるアプリケーションを目指して日々開発しています。

h2. Q. Karesansuiをいろんなところで紹介したいんだけど。

bq. 是非、是非じゃんじゃんご紹介ください。"バナーも提供中":http://karesansui-project.info/karesansui_pages/badges です！

h2. Q. 会社で利用したんだけど、ライセンスで問題とかある？

bq. まったく問題ありません。KaresansuiはGPL・LGPLで配布されていますので、利用することによる制限はありません。

<br>

<br>

h1. アプリケーションについて

h2. Q. Karesansuiが参照するデータベースが異常停止したらゲストは停止する？

bq. データベースが停止していてもゲストやホストに影響が出ることはありません。ただしブラウザからの操作はできなくなります。

h2. Q. ゲストのコンソールを表示するとJavaが必要ってでるんだけど。

bq. コンソールの表示には、オープンソースの"TightVNC":http://www.tightvnc.com/ のJava appletを利用していますので、Javaが必要となります。

h2. Q. コンソールが表示されないんだけど、どうしたらいい？

bq. 以下を試してみてください。通信ができるかどうかを確認します。クライアントのコンソールから以下のコマンドを発行します。

<pre>

＞ ping {Karesansuiサーバー名}

</pre>

bq. 次にKaresansuiサーバーでVNCポート番号が開いているか確認します。

<pre>

# netstat -nalt

</pre>

bq. 上記が正常な場合にはクライアントにVNCビューアを入れて接続してみてください。

h2. Q. コンソールからキーボード入力すると、別のキーボード配列になってるんだけど。

bq. 「ゲスト」のデバイスタブから「Display」を選択し、「VNCキーマップ」を選択してください。日本語106/109キーボードは「ja」を選択してください。

h2. Q. うまく動かないんだけど、どうしたらいい？

bq. "フォーラム":http://karesansui-project.info/projects/karesansui/boards にて聞いてみてください。有志の方や開発者が答えてくれるはずです。

<br>

<br>

h1. ログ関連

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

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

<pre>

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

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

↓↓↓↓↓

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

</pre>

<pre>

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

</pre>

<pre>

ログローテートを5から10にする場合

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

↓↓↓↓↓

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

</pre>

h2. Q. 画面でエラーが発生したがうまくログ出力されていないみたい。

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

<pre>

ログレベル一覧(※上は下を包括します。)

 - DEBUG : 全て出力

 - INFO : 一般情報のみ出力

 - WARNING : 警告のみ出力(運用時の推奨設定)

 - ERROR : エラーのみ出力

 - CRITICAL : 深刻なエラーのみ出力

 - EXCEPTION : システム的なエラーのみ出力

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

</pre>

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

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

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

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

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

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

<pre>

Karesansui全体のログ : /var/log/karesansui/application.log

Karesansuiで発生したエラーのプログラムトレースログ : /var/log/karesansui/error.log

Karesansuiが発行したSQL関連のログ : /var/log/karesansui/sql.log

</pre>