Browse code

Update README.md

updated readme, add solution for java.io.IOException: (null) entry in command string: null chmod 0644` error n windows

Sim1Pall8a authored on 24/10/2020 13:59:07 • GitHub committed on 24/10/2020 13:59:07
Showing1 changed files

... ...
@@ -1,23 +1,71 @@
1 1
 # RGMQL
2
+API for calling interactively the GMQL Engine from R-Bioconductor
2 3
 
3
-This package works with java 1.8
4
+[RGMQL on Bioconductor](https://www.bioconductor.org/packages/release/bioc/html/RGMQL.html)
4 5
 
5
-## Settings OSX
6
+## Requirements
6 7
 
7
-edit .bash_profile, add environment variable
8
+The library requires the following:
9
+* R version 3.4.2 or higher
10
+* Java version 1.8 or higher
11
+* The JAVA_HOME enviroment variable set
8 12
 
9
-export JAVA_HOME="<java_path>"
13
+It is recommended the use ot the latest version of RStudio.
10 14
 
11
-export PATH=$PATH
15
+## OSX Settings
12 16
 
13
-edit /etc/paths add these
17
+#### before Catalina
14 18
 
15
-$JAVA_HOME/bin
19
+Edit the `.bash_profile` and add the `JAVA_HOME` environment variable:
16 20
 
21
+`export JAVA_HOME = <java_path>`
17 22
 
18
-## Settings Windows
23
+`export PATH=$PATH`
19 24
 
20
-create environment variable JAVA_HOME 
25
+#### after Catalina
21 26
 
27
+Since on macOS Catalina the default shell is Zsh we need to edit or create the .zsh file:
28
+
29
+Edit the `.zsh` and add the `JAVA_HOME` environment variable:
30
+
31
+`export JAVA_HOME = <java_path>`
32
+
33
+`export PATH=$PATH`
34
+
35
+At the end, in both cases, edit the `/etc/paths` and add:
36
+
37
+`$JAVA_HOME/bin`
38
+
39
+
40
+## Windows Settings
41
+
42
+Create environment variable `JAVA_HOME`:
43
+
44
+* Right click on _This PC_.
45
+* click on _Advanced system settings_
46
+* go to _Advanced_ tab an click on _evnironment variables_
47
+* create a `JAVA_HOME` variable the jdk path
48
+
49
+### Errors
50
+
51
+be aware that during execution a message  
52
+
53
+`Error in .jcall("RJavaTools", "Ljava/lang/Object;", "invokeMethod", cl, : org.apache.spark.SparkException: Job aborted due to stage failure: Task 0 in stage 7.0 failed 1 times, most recent failure: Lost task 0.0 in stage 7.0 (TID 59, localhost, executor driver): java.io.IOException: (null) entry in command string: null chmod 0644`
54
+
55
+may arise in some circustances .
56
+
57
+This happens because some binary files are missing for Windows, in this case we need to:
58
+
59
+* Open [DownGit](https://minhaskamal.github.io/DownGit/#/home)
60
+* Paste the url `https://github.com/steveloughran/winutils/tree/master/hadoop-2.8.1` in above website, and download the **winutil-hadoop2.8.1**
61
+
62
+or
63
+
64
+* Go to https://github.com/steveloughran/winutils and download the repo and use **winutil-hadoop2.8.1**
65
+
66
+
67
+* Create a directory (example `C:\Program Files\hadoop`) with a folder inside named `bin`
68
+* Get those files and copy them inside the bin subfolder, (copy on `C:\Program Files\hadoop\bin`)
69
+* Create environment variable `HADOOP_HOME` with the path containing those files.
22 70
 
23 71