You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apex.apache.org by sa...@apache.org on 2016/04/08 02:41:23 UTC

[1/4] incubator-apex-core git commit: Add doc section on running unit tests

Repository: incubator-apex-core
Updated Branches:
  refs/heads/master 381de3a29 -> c1b247540


Add doc section on running unit tests


Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/commit/2c061f82
Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/tree/2c061f82
Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/diff/2c061f82

Branch: refs/heads/master
Commit: 2c061f8246377b424ee3e1018b62682cb671006d
Parents: 47d66b0
Author: Munagala V. Ramanath <ra...@datatorrent.com>
Authored: Wed Apr 6 09:18:37 2016 -0700
Committer: Munagala V. Ramanath <ra...@datatorrent.com>
Committed: Wed Apr 6 09:18:37 2016 -0700

----------------------------------------------------------------------
 docs/apex_development_setup.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-apex-core/blob/2c061f82/docs/apex_development_setup.md
----------------------------------------------------------------------
diff --git a/docs/apex_development_setup.md b/docs/apex_development_setup.md
index 0bbabc5..a154faa 100644
--- a/docs/apex_development_setup.md
+++ b/docs/apex_development_setup.md
@@ -19,7 +19,7 @@ There are a few tools that will be helpful when developing Apache Apex applicati
 
 After installing these tools, make sure that the directories containing the executable files are in your PATH environment variable.
 
-* **Windows** - Open a console window and enter the command `echo %PATH%` to see the value of the `PATH` variable and verify that the above directories for Java, git, and maven executables are present.  JDK executables like _java_ and _javac_, the directory might be something like `C:\\Program Files\\Java\\jdk1.7.0\_80\\bin`; for _git_ it might be `C:\\Program Files\\Git\\bin`; and for maven it might be `C:\\Users\\user\\Software\\apache-maven-3.3.3\\bin`.  If not, you can change its value clicking on the button at _Control Panel_ &#x21e8; _Advanced System Settings_ &#x21e8; _Advanced tab_ &#x21e8; _Environment Variables_.
+* **Windows** - Open a console window and enter the command `echo %PATH%` to see the value of the `PATH` variable and verify that the above directories for Java, git, and maven executables are present.  JDK executables like _java_ and _javac_, the directory might be something like `C:\Program Files\Java\jdk1.7.0\_80\bin`; for _git_ it might be `C:\Program Files\Git\bin`; and for maven it might be `C:\Users\user\Software\apache-maven-3.3.3\bin`.  If not, you can change its value clicking on the button at _Control Panel_ &#x21e8; _Advanced System Settings_ &#x21e8; _Advanced tab_ &#x21e8; _Environment Variables_.
 * **Linux and Mac** - Open a console/terminal window and enter the command `echo $PATH` to see the value of the `PATH` variable and verify that the above directories for Java, git, and maven executables are present.  If not, make sure software is downloaded and installed, and optionally PATH reference is added and exported  in a `~/.profile` or `~/.bash_profile`.  For example to add maven located in `/sfw/maven/apache-maven-3.3.3` to PATH add the line: `export PATH=$PATH:/sfw/maven/apache-maven-3.3.3/bin`
 
 
@@ -94,6 +94,38 @@ When the run completes successfully, you should see a new directory named `myape
 
 The build should create the application package file `myapexapp/target/myapexapp-1.0-SNAPSHOT.apa`. This application package can then be used to launch example application via **dtCli**, or other visual management tools.  When running, this application will generate a stream of random numbers and print them out, each prefixed by the string `hello world:`.
 
+Running Unit Tests
+----
+To run unit tests on Linux or OSX, simply run the usual maven command, for example: `mvn test`.
+
+On Windows, an additional file, `winutils.exe`, is required; download it from
+<https://github.com/srccodes/hadoop-common-2.2.0-bin/archive/master.zip>
+and unpack the archive to, say, `C:\hadoop`; this file should be present under
+`hadoop-common-2.2.0-bin-master\bin` within it.
+
+You can now run unit tests from the command line by specifying the maven
+property `hadoop.home.dir`, for example:
+
+    mvn -Dhadoop.home.dir=c:\hadoop\Software\hadoop-common-2.2.0-bin-master test
+
+or set the environment variable separately:
+
+    set HADOOP_HOME=c:\hadoop\Software\hadoop-common-2.2.0-bin-master
+    mvn test
+
+To run unit tests from within your IDE, set the `HADOOP_HOME` environment
+variable to the path to the root of the unpacked archive and then run the desired
+unit test in the usual way. For example, with NetBeans you can add:
+
+    Env.HADOOP_HOME=c:/hadoop/hadoop-common-2.2.0-bin-master
+
+at _Properties &#8658; Actions &#8658; Run project &#8658; Set Properties_.
+
+Similarly, in Eclipse (Mars) add the HADOOP_HOME environment variable to the
+project properties at _Properties &#8658; Run/Debug Settings &#8658; ApplicationTest
+&#8658; Environment_ tab.
+
+
 Building Apex Demos
 -------------------------------------------------------------------------------
 


[2/4] incubator-apex-core git commit: Describe setting HADOOP_HOME globally

Posted by sa...@apache.org.
Describe setting HADOOP_HOME globally


Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/commit/ef61f102
Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/tree/ef61f102
Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/diff/ef61f102

Branch: refs/heads/master
Commit: ef61f102713f4b1d563b1054e5830e5b4346d39b
Parents: 2c061f8
Author: Munagala V. Ramanath <ra...@datatorrent.com>
Authored: Wed Apr 6 09:35:46 2016 -0700
Committer: Munagala V. Ramanath <ra...@datatorrent.com>
Committed: Wed Apr 6 09:35:46 2016 -0700

----------------------------------------------------------------------
 docs/apex_development_setup.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-apex-core/blob/ef61f102/docs/apex_development_setup.md
----------------------------------------------------------------------
diff --git a/docs/apex_development_setup.md b/docs/apex_development_setup.md
index a154faa..42fe520 100644
--- a/docs/apex_development_setup.md
+++ b/docs/apex_development_setup.md
@@ -103,8 +103,13 @@ On Windows, an additional file, `winutils.exe`, is required; download it from
 and unpack the archive to, say, `C:\hadoop`; this file should be present under
 `hadoop-common-2.2.0-bin-master\bin` within it.
 
-You can now run unit tests from the command line by specifying the maven
-property `hadoop.home.dir`, for example:
+Set the `HADOOP_HOME` environment variable system-wide to
+`c:\hadoop\Software\hadoop-common-2.2.0-bin-master` as described at:
+<https://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx?mfr=true>. You should now be able to run unit tests normally.
+
+If you prefer not to set the variable globally, you can set it on the command line or within
+your IDE. For example, on the command line, specify the maven
+property `hadoop.home.dir`:
 
     mvn -Dhadoop.home.dir=c:\hadoop\Software\hadoop-common-2.2.0-bin-master test
 
@@ -113,15 +118,14 @@ or set the environment variable separately:
     set HADOOP_HOME=c:\hadoop\Software\hadoop-common-2.2.0-bin-master
     mvn test
 
-To run unit tests from within your IDE, set the `HADOOP_HOME` environment
-variable to the path to the root of the unpacked archive and then run the desired
+Within your IDE, set the environment variable and then run the desired
 unit test in the usual way. For example, with NetBeans you can add:
 
     Env.HADOOP_HOME=c:/hadoop/hadoop-common-2.2.0-bin-master
 
 at _Properties &#8658; Actions &#8658; Run project &#8658; Set Properties_.
 
-Similarly, in Eclipse (Mars) add the HADOOP_HOME environment variable to the
+Similarly, in Eclipse (Mars) add it to the
 project properties at _Properties &#8658; Run/Debug Settings &#8658; ApplicationTest
 &#8658; Environment_ tab.
 


[3/4] incubator-apex-core git commit: Fix typos

Posted by sa...@apache.org.
Fix typos


Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/commit/25dc359a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/tree/25dc359a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/diff/25dc359a

Branch: refs/heads/master
Commit: 25dc359a48d197dc7a523ba1842a8e450ffd7978
Parents: ef61f10
Author: Munagala V. Ramanath <ra...@datatorrent.com>
Authored: Wed Apr 6 12:10:56 2016 -0700
Committer: Munagala V. Ramanath <ra...@datatorrent.com>
Committed: Wed Apr 6 12:10:56 2016 -0700

----------------------------------------------------------------------
 docs/apex_development_setup.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-apex-core/blob/25dc359a/docs/apex_development_setup.md
----------------------------------------------------------------------
diff --git a/docs/apex_development_setup.md b/docs/apex_development_setup.md
index 42fe520..d7c4d98 100644
--- a/docs/apex_development_setup.md
+++ b/docs/apex_development_setup.md
@@ -104,18 +104,18 @@ and unpack the archive to, say, `C:\hadoop`; this file should be present under
 `hadoop-common-2.2.0-bin-master\bin` within it.
 
 Set the `HADOOP_HOME` environment variable system-wide to
-`c:\hadoop\Software\hadoop-common-2.2.0-bin-master` as described at:
+`c:\hadoop\hadoop-common-2.2.0-bin-master` as described at:
 <https://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx?mfr=true>. You should now be able to run unit tests normally.
 
 If you prefer not to set the variable globally, you can set it on the command line or within
 your IDE. For example, on the command line, specify the maven
 property `hadoop.home.dir`:
 
-    mvn -Dhadoop.home.dir=c:\hadoop\Software\hadoop-common-2.2.0-bin-master test
+    mvn -Dhadoop.home.dir=c:\hadoop\hadoop-common-2.2.0-bin-master test
 
 or set the environment variable separately:
 
-    set HADOOP_HOME=c:\hadoop\Software\hadoop-common-2.2.0-bin-master
+    set HADOOP_HOME=c:\hadoop\hadoop-common-2.2.0-bin-master
     mvn test
 
 Within your IDE, set the environment variable and then run the desired


[4/4] incubator-apex-core git commit: Merge branch 'doc-unittesting' of github.com:amberarrow/incubator-apex-core

Posted by sa...@apache.org.
Merge branch 'doc-unittesting' of github.com:amberarrow/incubator-apex-core


Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/commit/c1b24754
Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/tree/c1b24754
Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-core/diff/c1b24754

Branch: refs/heads/master
Commit: c1b2475403159c18fd50332b9c4cec902c9cc650
Parents: 381de3a 25dc359
Author: Sasha Parfenov <sa...@apache.org>
Authored: Thu Apr 7 17:40:17 2016 -0700
Committer: Sasha Parfenov <sa...@apache.org>
Committed: Thu Apr 7 17:40:17 2016 -0700

----------------------------------------------------------------------
 docs/apex_development_setup.md | 38 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)
----------------------------------------------------------------------