[systemds] branch master updated: [MINOR] Install guide for MacOS

[ba...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

baunsgaard pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/systemds.git


The following commit(s) were added to refs/heads/master by this push:
     new 3560a1e  [MINOR] Install guide for MacOS
3560a1e is described below

commit 3560a1e0a632e3c1f712d68392342648a787003c
Author: baunsgaard <ba...@tugraz.at>
AuthorDate: Mon Oct 19 13:33:25 2020 +0200

    [MINOR] Install guide for MacOS
    
    closes #1076
---
 docs/site/install.md    | 58 ++++++++++++++++++++++++++++++++++++++++++++++---
 docs/site/run_issues.md |  6 -----
 2 files changed, 55 insertions(+), 9 deletions(-)

diff --git a/docs/site/install.md b/docs/site/install.md
index 2ad27d1..24494c9 100644
--- a/docs/site/install.md
+++ b/docs/site/install.md
@@ -23,11 +23,17 @@ limitations under the License.
 
 This guide helps in the install and setup of SystemDS from source code.
 
+- [Windows Guide](#Windows)
+- [Ubuntu/Linux Guide](#Ubuntu%2020.04)
+- [Mac](#Mac)
+
 ## Windows
 
 TODO
 
-## Build from source on Ubuntu 20.04
+---
+
+## Ubuntu 20.04
 
 ### Java and Maven
 
@@ -72,6 +78,54 @@ sudo add-apt-repository 'deb https://cloud.r-project.org/bin/linux/ubuntu focal-
 sudo apt install r-base
 ```
 
+See [Build the project](#Build%20the%20project) to compile the code from here.
+
+---
+
+## MAC
+
+Prerequisite install homebrew on the device.
+
+```bash
+# To allow relative paths:
+brew install coreutils
+# To install open jdk 8.
+brew tap adoptopenjdk/openjdk
+brew cask install adoptopenjdk8
+# Install maven to enable compilation of SystemDS.
+brew install maven
+```
+
+Then afterwards verify the install:
+
+```bash
+java --version
+mvn --version
+```
+
+This should print something like:
+
+```bash
+Java version: 1.8.0_242, vendor: AdoptOpenJDK, runtime: /Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home/jre
+Default locale: ru_UA, platform encoding: UTF-8
+OS name: "mac os x", version: "10.15.5", arch: "x86_64", family: "mac"
+
+Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
+Maven home: /usr/local/Cellar/maven/3.6.3_1/libexec
+```
+
+Note that if you have multiple __java__ versions installed then you have to change the used version to 8, on __both java and javadoc__. This is done by setting the environment variable JAVA_HOME to the install path of open JDK 8 :
+
+``` bash
+export JAVA_HOME=`/usr/libexec/java_home -v 1.8`
+```
+
+For running all tests [r-base](https://cran.r-project.org/bin/macosx/) has to be installed as well since this is used as a secondary system to verify the correctness of our code, but it is not a requirement to enable building the project.
+
+See [Build the project](#Build%20the%20project) to compile the code from here.
+
+---
+
 ## Build the project
 
 To compile the project use:
@@ -80,8 +134,6 @@ To compile the project use:
 mvn package -P distribution
 ```
 
-After some time it should return with:
-
 ```bash
 [INFO] ------------------------------------------------------------------------
 [INFO] BUILD SUCCESS
diff --git a/docs/site/run_issues.md b/docs/site/run_issues.md
deleted file mode 100644
index 6cc931b..0000000
--- a/docs/site/run_issues.md
+++ /dev/null
@@ -1,6 +0,0 @@
-Error: Could not find or load main class org.apache.sysds.api.DMLScript 
-
-Solution for macOS: Install `realpath` with Homebrew
-```bash
-brew install coreutils 
-```