Merge pull request #11 from akirakw/wip/development-environment-varia…

…bles Add environment variable requirements for development environment
asakusafw · Nov 1, 2016 · d8e8007 · d8e8007
2 parents 7cc9307 + bb967a9
commit d8e8007
Show file tree

Hide file tree

Showing 2 changed files with 31 additions and 2 deletions.
diff --git a/docs/ja/source/development-environment.rst b/docs/ja/source/development-environment.rst
@@ -51,12 +51,22 @@ Asakusa Frameworkを利用する開発環境には、以下の環境変数を設
     :header-rows: 1
 
     * - 変数名
-      - 説明
+      - 値
     * - ``ASAKUSA_HOME``
-      - Asakusa Frameworkのインストールディレクトリ
+      - Asakusa Frameworkのインストールディレクトリを指定
+    * - ``JAVA_HOME``
+      - JDKのインストールディレクトリを指定
+    * - ``PATH``
+      - JDKのコマンドパスを追加
 
 環境変数 ``ASAKUSA_HOME`` はAsakusa Framework実行環境のインストール先ディレクトリを絶対パスで指定します。
 
+環境変数 ``JAVA_HOME`` にはJDKのインストール先ディレクトリを絶対パスで指定します。
+Asakusa Frameworkのいくつかの機能はJDKの機能を利用するため、JREではなくJDKのパスを設定してください。
+
+環境変数 ``PATH`` にはJDKのコマンドパスを指定します。
+通常、Unix系OSの場合は ``${JAVA_HOME}/bin`` ､ Windows系OSの場合は ``%JAVA_HOME%¥bin`` のように指定します。
+
 以降の手順では、コマンドライン環境やIDE環境上で上記の環境変数が有効になっている必要があるため、
 環境変数を設定したら、必要に応じてデスクトップ環境に対してログインセッションの再起動などを実施してください。
 

diff --git a/docs/ja/source/testing-flowpart.rst b/docs/ja/source/testing-flowpart.rst
@@ -641,6 +641,25 @@ Windows環境で `テストを実行する`_ の手順を実行すると、以
 現時点でのAsakusa Frameworkの制限事項で、Windows上でテストドライバーを実行するとこのメッセージが出力されることがあります。
 テスト自体の動作には影響ありません。
 
+ExitCodeException exitCode=-1073741515
+--------------------------------------
+
+Windows環境で `テストを実行する`_ の手順を実行すると、以下のエラーメッセージが表示されテストが失敗する。
+
+..  code-block:: none
+
+    java.lang.IllegalStateException: ExitCodeException exitCode=-1073741515:
+        ...
+        Caused by:
+        ExitCodeException exitCode=-1073741515:
+            at org.apache.hadoop.util.Shell.runCommand(Shell.java:582)
+        ...
+
+想定される原因
+~~~~~~~~~~~~~~
+
+環境変数 ``PATH`` にJDKのコマンドパスが正しく設定されていない可能性があります。
+
 関連ドキュメント
 ================